coldbrew

type CacheBustError struct{}

type CacheResolveErrorHandler func(error)

type Camera interface {
	// Ready checks if the camera is ready for rendering based on client state
	Ready(Client) bool
	// Active returns whether the camera is currently active
	Active() bool
	// Activate enables the camera
	Activate()
	// Deactivate clears the surface and disables the camera
	Deactivate()
	// Surface returns the camera's rendering surface
	Surface() *ebiten.Image
	// Localize transforms global scene coordinates to camera-local coordinates
	Localize(pos vector.Two) vector.Two
	// DrawImage renders an image at the specified scene position, localized to the camera
	DrawImage(img *ebiten.Image, opts *ebiten.DrawImageOptions, pos vector.Two)
	// DrawImageStatic renders an image at an absolute position without transformation (on the camera)
	DrawImageStatic(img *ebiten.Image, opts *ebiten.DrawImageOptions, pos vector.Two)
	// DrawTextBasic renders basic text at the specified scene position, localized to the camera
	DrawTextBasic(text string, opts *text.DrawOptions, fontFace *text.GoXFace, pos vector.Two)
	// DrawText renders text at the specified scene position, localized to the camera
	DrawText(text string, opts *text.DrawOptions, fontFace *text.GoTextFace, pos vector.Two)
	// DrawTextBasicStatic renders basic text at an absolute position (on the camera)
	DrawTextBasicStatic(text string, opts *text.DrawOptions, fontFace *text.GoXFace, pos vector.Two)
	// DrawTextStatic renders text at an absolute position (on the camera)
	DrawTextStatic(text string, opts *text.DrawOptions, fontFace *text.GoTextFace, pos vector.Two)
	// PresentToScreen renders the camera's contents to the provided screen
	PresentToScreen(screen Screen, borderSize int)
	// SetDimensions updates the camera's width and height
	SetDimensions(width, height int)
	// Dimensions returns the camera's current width and height
	Dimensions() (width, height int)
	// Positions returns the camera's global (screen) and local (scene/world) positions
	Positions() (screen, scene *vector.Two)
	// Index returns the camera's rendering priority
	Index() int
	// contains filtered or unexported methods
}

type CameraManager interface {
	// CameraSceneTracker returns the tracker for camera scene transitions
	CameraSceneTracker() CameraSceneTracker

	// Cameras returns the array of available cameras
	Cameras() [MaxSplit]Camera

	// ActivateCamera attempts to activate a camera and returns it if successful
	ActivateCamera() (Camera, error)
}

type CameraSceneRecord struct {
	Scene Scene
	Tick  int
}

type CameraSceneTracker map[Camera]CameraSceneRecord

type Client interface {
	LocalClient
	SceneManager
	CameraManager
	PreExecAllPlans() error
	PreExecSceneByName(string) error
}

type ClientSystem interface {
	Run(LocalClient, Scene) error
}

type ConfigManager interface {
	SetTitle(string)
	SetWindowSize(x, y int)
	SetResolution(x, y int)
	SetResizable(bool)
	SetFullScreen(bool)
	SetMinimumLoadTime(ticks int)
	SetEnforceMinOnActive(bool)
	SetTPS(int)
	BindDebugKey(ebiten.Key)
	SetDebugMode(bool)
	SetCameraBorderSize(int)
	SetLocalAssetPath(path string)
}

type GlobalClientSystem interface {
	Run(Client) error
}

type GlobalRenderSystem interface {
	Render(Client, Screen)
}

type InputCapturer interface {
	Capture()
}

type InputManager interface {
	ActivateReceiver() (Receiver, error)
	Receiver(index int) Receiver
}

type KeyLayout interface {
	RegisterKey(ebiten.Key, input.Action)
	RegisterReleasedKey(ebiten.Key, input.Action)
	RegisterJustPressedKey(ebiten.Key, input.Action)
}

type LocalClient interface {
	Start() error
	StartWithEbitenOptions(opts *ebiten.RunGameOptions) error

	RenderUtility
	TickManager
	InputManager
	CameraManager
	SystemManager
	ConfigManager
	LocalClientSceneManager
	ebiten.Game
}

type LocalClientSceneManager interface {
	ActivateSceneByName(string, ...warehouse.Entity) (uint32, error)
	ActivateSceneByIndex(int, ...warehouse.Entity) error

	ChangeSceneByName(string, ...warehouse.Entity) (uint32, error)
	ChangeSceneByIndex(int, ...warehouse.Entity) error
}

type MockSoundLoader struct {
}

type MockSpriteLoader struct{}

type MouseLayout interface {
	RegisterMouseButton(ebiten.MouseButton, input.Action)
}

type NetworkClient interface {
	Client

	// Connect establishes a connection to a drip server.
	Connect(address string) error

	// Disconnect closes the connection to the server.
	Disconnect() error

	// Send transmits data to the server.
	Send(data []byte) error

	// IsConnected returns true if the client is currently connected.
	IsConnected() bool

	SetDeserCallback(func(NetworkClient, []byte) error)

	AssociatedEntityID() (int, bool)
}

type PadLayout interface {
	RegisterPad(padID int)
	RegisterGamepadButton(ebiten.GamepadButton, input.Action)

	RegisterGamepadJustPressedButton(ebiten.GamepadButton, input.Action)
	RegisterGamepadReleasedButton(ebiten.GamepadButton, input.Action)

	RegisterGamepadAxes(left bool, input input.Action)

	PadActive() bool

	ResetPadButtonMapping()
}

type Receiver interface {
	RegisterPad(padID int)
	Active() bool
	PopActions() []input.StampedAction
	PadLayout
	KeyLayout
	MouseLayout
	TouchLayout
}

type RenderSystem interface {
	Render(Scene, Screen, LocalClient)
}

type RenderUtility interface {
	// ActiveCamerasFor returns all active cameras assigned to the given scene
	ActiveCamerasFor(Scene) []Camera

	// Ready determines if a camera is ready to be used based on timing constraints
	Ready(Camera) bool
}

type Scene interface {
	// Core information
	Name() string
	Height() int
	Width() int
	CurrentTick() int
	LastSelectedTick() int
	SetSelectedTick()
	LastActivatedTick() int
	SetActivatedTick()
	TicksSinceActivated() int
	TicksSinceSelected() int
	// Storage and queries
	Storage() warehouse.Storage
	NewCursor(warehouse.QueryNode) *warehouse.Cursor
	// Loading state
	IsLoaded() bool
	SetLoaded(bool)
	IsLoading() bool
	SetLoading(bool)
	TryStartLoading() bool
	Ready() bool
	// Systems and execution
	CoreSystems() []blueprint.CoreSystem
	Renderers() []RenderSystem
	ClientSystems() []ClientSystem
	ExecutePlan() (alreadyExecuted bool, err error)
	Reset() error
	PreloadAssetBundle() client.PreLoadAssetBundle
}

type SceneManager interface {

	// IsActive checks if the given scene is currently active
	IsActive(Scene) bool
	// LoadingScenes returns all scenes currently being loaded
	LoadingScenes() []Scene
	// Cache returns the scene cache
	Cache() warehouse.Cache[Scene]

	ActiveScenes() iter.Seq[Scene]
	ActiveScene(int) Scene
	SceneCount() int
	// RegisterScene creates and registers a new scene with the provided configuration
	RegisterScene(string, int, int, blueprint.Plan, []RenderSystem, []ClientSystem, []blueprint.CoreSystem, ...client.PreLoadAssetBlueprint) error
	// ChangeScene transitions to a target scene, transferring specified entities
	ChangeScene(target Scene, entities ...warehouse.Entity) error
	// ActivateScene activates a target scene while keeping the origin scene active
	ActivateScene(target Scene, entities ...warehouse.Entity) error
	// DeactivateScene removes a scene from the active scenes list
	DeactivateScene(target Scene)
}

type Screen struct {
	// contains filtered or unexported fields
}

type Sound struct {
	// contains filtered or unexported fields
}

type SoundLoader interface {
	Load(bundle *client.SoundBundle, cache warehouse.Cache[Sound]) error

	PreLoad(bundle client.PreLoadAssetBundle, cache warehouse.Cache[Sound]) error
}

type Sprite interface {
	// Name returns the sprite's identifier
	Name() string
	// Image returns the underlying ebiten.Image
	Image() *ebiten.Image
	// Draw renders the sprite to the target image with the provided options
	Draw(*ebiten.Image, *ebiten.DrawImageOptions)
	// GetFrame retrieves a specific frame from a sprite sheet
	GetFrame(rowIndex, frameIndex, frameWidth, frameHeight int) *ebiten.Image
	// GetTile retrieves a specific tile from a tileset
	GetTile(tileX, tileY, tileWidth, tileHeight int) *ebiten.Image
}

type SpriteLoader interface {
	Load(spriteBundle *client.SpriteBundle, cache warehouse.Cache[Sprite]) error
	PreLoad(bundle client.PreLoadAssetBundle, cache warehouse.Cache[Sprite]) error
}

type SystemManager interface {
	RegisterGlobalRenderSystem(...GlobalRenderSystem)
	RegisterGlobalClientSystem(...GlobalClientSystem)
}

type TickManager interface {
	CurrentTick() int
	ebiten.Game
}

type TouchLayout interface {
	RegisterTouch(input.Action)
}