api

type BrightnessRequest struct {
	// openapi:description Brightness level (0-100)
	// openapi:example 75
	Brightness int `json:"brightness"`
}

type DetailFrameProvider interface {
	GetDetailFrame() *image.RGBA
}

type DeviceController interface {
	SetBrightness(brightness int) error
	GetFirmwareVersion() (string, error)
	GetDeviceInfo() device.DeviceInfo
	IsConnected() bool
}

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

type ErrorResponse struct {
	// openapi:description The error type/category
	// openapi:example Bad Request
	Error string `json:"error"`
	// openapi:description Detailed error message
	// openapi:example Invalid brightness value provided
	Message string `json:"message,omitempty"`
}

type FrameProvider interface {
	GetLastFrame() *image.RGBA
}

type LayoutReloader interface {
	ReloadFromConfig(config *zone.Config) error
	GetConfig() *zone.Config
	NumPages() int
}

type LayoutStore interface {
	GetPages() ([]store.StoredPage, error)
	GetZonesForPage(pageID int64) ([]store.StoredZone, error)
	GetFullLayout() ([]store.StoredPage, map[int64][]store.StoredZone, error)
	CreatePage(name string, ord int) (int64, error)
	UpdatePage(id int64, name string, ord int) error
	DeletePage(id int64) error
	ReorderPages(order []int64) error
	GetZonePageID(zoneID string) (int64, error)
	CreateZone(z store.StoredZone) error
	UpdateZone(z store.StoredZone) error
	DeleteZone(id string) error
	ReorderZones(pageID int64, order []string) error
	HasLayout() (bool, error)
	ImportLayout(pages []store.StoredPage, zonesByPage map[int64][]store.StoredZone) error
}

type Navigator interface {
	GetCurrentPage() int
	NumPages() int
	GetPageInfos() []zone.PageInfo
	SwitchPage(pageIndex int) error
}

type PluginCatalogProvider interface {
	GetCatalog() []zone.CatalogEntry
}

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

type SuccessResponse struct {
	// openapi:description Status of the operation
	// openapi:example success
	Status string `json:"status"`
	// openapi:description Human-readable success message
	// openapi:example Configuration updated successfully
	Message string `json:"message,omitempty"`
	// openapi:description Additional response data
	Data interface{} `json:"data,omitempty"`
}

type SwipeSimRequest struct {
	// Direction: "left" (forward) or "right" (backward). Default: "left".
	Direction string `json:"direction"`
	// DurationMs: total time for the drag phase in milliseconds. Default: 200.
	DurationMs int `json:"duration_ms"`
	// FinalizeMs: time for the snap-to-end animation after release. Default: 120.
	FinalizeMs int `json:"finalize_ms"`
	// Steps: number of incremental UpdateLiveSwipe calls during the drag. Default: 20.
	// More steps = smoother simulation of finger drag; fewer = choppier.
	Steps int `json:"steps"`
	// Velocity: finger velocity at release in pixels/second. Typical real swipes
	// range from ~120 px/s (slow drag) to ~500 px/s (fast flick). Default: 150.
	Velocity float32 `json:"velocity"`
	// ReleaseAt: progress (0–1) at which the finger is "lifted", triggering finalize.
	// Real swipes typically release at 0.5–0.8. Default: 0.7.
	ReleaseAt float32 `json:"release_at"`
}

type SwipeSimulator interface {
	UpdateLiveSwipe(progress float32, isLeft bool) error
	FinalizeLiveSwipe(progress float32, velocity float32, isLeft bool) error
	CancelLiveSwipe() error
}

type WSMessage struct {
	Type string `json:"type"` // "frame" | "window_state" | "config"
	Data any    `json:"data"`
}

type ZoneCfgManager interface {
	GetZoneOverride(zoneID string) map[string]any
	SetZoneOverride(zoneID string, cfg map[string]any) error
	DeleteZoneOverride(zoneID string) error
	BroadcastZoneConfigChange(zoneID string, cfg map[string]any) error
}

type ZoneConfigNotifier interface {
	BroadcastZoneConfigChange(zoneID string, config map[string]any) error
}

type ZoneStatusProvider interface {
	GetZoneStatus(zoneID string) zone.ZoneStatus
	AllZoneStatuses() map[string]zone.ZoneStatus
}

type ZoneTapper interface {
	HandleZoneTapAtX(x int) error
	HandleZoneTap(zoneID string) error
	IsShowingDetail() bool
	ClearDetail()
}