app

type Area struct {
	// ID is unique and stable ("chat", "settings").
	ID string
	// Path is where the sidebar entry navigates ("/chat").
	Path string
	// Patterns are the router patterns the area builds; Path when empty.
	// Use "/settings/{section...}" style patterns for sub-pages.
	Patterns []string
	// TitleKey is the i18n key of the label and header title ("nav.chat").
	TitleKey string
	// Icon is a kit icon name.
	Icon    string
	Section Section
	// Order sorts entries within a section (ascending).
	Order int
	// New builds the area's view once, the first time it is shown; the view
	// then keeps its state across navigation.
	New func(a *Context) View
	// Placeholder marks areas not built yet.
	Placeholder bool
	// Visible, when set, decides on each frame whether the sidebar shows
	// the entry (the extensions area hides itself on builds without panels).
	// The area stays routable either way.
	Visible func(a *Context) bool
}

type Banner = Overlay

type Batch[T any] struct {
	// contains filtered or unexported fields
}

type Closer interface {
	Close()
}

type Command struct {
	ID    string
	Title string
	// TitleKey, when set, is the i18n key of the title (Title is then the
	// fallback when the key is missing).
	TitleKey    string
	Description string
	// Group is "command" (default) or "account".
	Group    string
	Icon     string
	Keywords []string
	Run      func(a *Context)
}

type Context struct {
	// Ctx is canceled when the app shuts down: derive goroutine contexts
	// from it.
	Ctx context.Context
	// Client talks to the Pando server.
	Client *client.Client
	// Server describes the server (version, startup mode).
	Server client.ServerInfo
	// CWD is the working directory of the server, when known.
	CWD string
	// Router navigates between areas (paths of the registered areas).
	Router *ui.Router
	// Toasts queues toasts from any goroutine.
	Toasts *kit.Toaster
	// Theme selects family, mode and accent; read every frame.
	Theme kit.Settings
	// Log is the UI logger.
	Log *slog.Logger
	// contains filtered or unexported fields
}

type Dispatcher interface {
	Update(fn func())
	Invalidate()
}

type ExternalAccess struct {
	Enabled        bool     `json:"enabled"`
	BindHost       string   `json:"bindHost"`
	Port           int      `json:"port"`
	CanToggle      bool     `json:"canToggle"`
	BasicAuthReady bool     `json:"basicAuthReady"`
	URLs           []string `json:"urls"`
}

type HeaderActions interface {
	HeaderActions(c *ui.Context)
}

type HeaderSlot struct {
	ID string
	// Order sorts slots ascending; built-ins use 100+ (simple chat 100,
	// docs 110, theme 120, settings 130).
	Order int
	Build func(c *ui.Context, a *Context)
}

type Host interface {
	// Focused reports whether the window has the keyboard focus.
	Focused() bool
	// Show brings the window back (tray, minimised, behind others).
	Show()
	// Quit quits the app, whatever the tray setting.
	Quit()
	// SetTitle sets the window title.
	SetTitle(title string)
	// SetTrayOnClose mirrors Desktop.TrayOnMinimizeClose.
	SetTrayOnClose(on bool)
	// SetTrayProjects lists the open project workspaces in the tray menu.
	SetTrayProjects(p []shell.TrayProject)
	// Notify shows an OS notification.
	Notify(id, title, body string)
}

type LeaveGuard interface {
	ConfirmLeave(proceed func()) bool
}

type Overlay interface {
	Build(c *ui.Context)
}

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

type Root struct {
	App *Context
	// contains filtered or unexported fields
}

type Section string

type Shell struct {
	// Host is the window shell (nil headless).
	Host Host

	// QuickMenuOpen and ModelSwitcherOpen are the overlays (Ctrl/Cmd+K or
	// Ctrl/Cmd+P, and Ctrl/Cmd+O).
	QuickMenuOpen     bool
	ModelSwitcherOpen bool

	// SidebarCollapsed is the icon-rail sidebar (persisted in the UI
	// preferences).
	SidebarCollapsed bool

	// StartExplicit is set when the first route was chosen (--simple, a
	// path option); otherwise the persisted chat mode may pick it.
	StartExplicit bool

	// NextModel is a model picked in the switcher while no chat session was
	// open: the chat sends it with the first prompt (the web's
	// sessionModelStore). Empty when none.
	NextModel string
	// ModelChanged, when set (the chat sets it), is told after the model
	// switcher changed the model of a session ("" = none open).
	ModelChanged func(model, sessionID string)

	// FocusProject focuses a project workspace tab by project ID (tray
	// menu). The projects area sets it; the default only opens /projects.
	FocusProject func(id string)
	// contains filtered or unexported fields
}

type ShellExt interface {
	// Tabs lists the open tabs, in order.
	Tabs() []ShellTab
	// Active returns the focused tab ID, "" for the main tab.
	Active() string
	// Select focuses a tab ("" is the main tab).
	Select(id string)
	// Close asks to close a tab (the extension may prompt first).
	Close(id string)
	// Build draws the content of the active tab.
	Build(c *ui.Context, id string)
	// Dialogs draws the extension's modal dialogs; it runs every frame, on
	// whichever tab is focused.
	Dialogs(c *ui.Context)
}

type ShellTab struct {
	ID    string
	Title string
	// Detail is the tooltip (path, state).
	Detail string
	// State is starting, running, stopped or error; it picks the tab icon.
	State string
	// Busy marks a tab whose workspace has an agent run in flight.
	Busy bool
}

type StatusItem struct {
	Order int
	// Visible reports whether the item has something to show this frame.
	Visible func(a *Context) bool
	Build   func(c *ui.Context, a *Context)
}

type Titled interface {
	Title() string
}

type View interface {
	Build(c *ui.Context, r *ui.Route)
}

type WindowHost interface {
	// Minimize hides into the tray or minimises, following the tray setting.
	Minimize()
	// ToggleMaximize maximises or restores.
	ToggleMaximize()
	// IsMaximized reports the maximised state.
	IsMaximized() bool
	// CloseWindow hides into the tray or closes (quitting), following the
	// tray setting.
	CloseWindow()
	// ToggleFullScreen toggles full screen.
	ToggleFullScreen()
}