app

type CommandID = uikit.CommandID

type CompletionItem struct {
	Label      string         // display text
	InsertText string         // text inserted on accept (defaults to Label)
	Kind       CompletionKind // for display/label
	Detail     string         // extra info shown alongside the label
	Summary    string         // tertiary muted line shown after Detail
}

type CompletionKind int

type Config struct {
	// BrowsePageSize is the default row limit for table browsing.
	// Must be within [1, sharedsql.MaxRows] when set.
	BrowsePageSize int `json:"browse_page_size"`
	// QueryLogPageSize is the default page size of the query-log pane.
	// Must be within [1, queryLogLimit] when set.
	QueryLogPageSize int `json:"query_log_page_size"`
	// QueryLogRetentionDays keeps query-log entries for this many days.
	// Omitted or 0 keeps the built-in default (30); to keep no history at
	// all, set PERK_WORKBENCH_QUERY_LOG_RETENTION_DAYS=0 (config cannot
	// express it, since 0 means unset).
	QueryLogRetentionDays int `json:"query_log_retention_days"`
	// NotificationRetentionDays keeps notification entries for this many
	// days. Omitted or 0 keeps the built-in default (30).
	NotificationRetentionDays int `json:"notification_retention_days"`
	// NotificationTimeoutSeconds is how long a notification popup stays
	// visible. Omitted or 0 keeps the built-in default (10); values above
	// one day are rejected.
	NotificationTimeoutSeconds int `json:"notification_timeout_seconds"`
	// ReadOnly opens every connection read-only by default. The
	// per-connection form toggle still opts a connection back to read-write.
	ReadOnly bool `json:"read_only"`
	// Appearance is the effective light/dark theme: "light" or "dark".
	// Omitted or empty keeps the built-in default (dark). While auto_theme
	// is enabled it is the fallback used when system detection is
	// unavailable and the value resolved into when auto is turned off.
	Appearance string `json:"appearance"`
	// AutoTheme follows the system light/dark appearance at startup.
	// Omitted means enabled (the built-in default).
	AutoTheme *bool `json:"auto_theme"`
	// DarkTheme is the theme used while appearance is dark: one of the
	// dark-scheme themes (ocean, nord, monokai, dracula, catppuccin,
	// solarized).
	DarkTheme string `json:"dark_theme"`
	// LightTheme is the theme used while appearance is light: one of the
	// light-scheme themes (light-ocean, light-nord, ...).
	LightTheme string `json:"light_theme"`
	// VimMode enables modal vim-style editing: normal mode navigates with
	// j/k-style keys and insert mode (i/Enter) types. Disabled, the focused
	// input is always editable — click to type, no mode switch. Omitted
	// means enabled (the built-in default).
	VimMode *bool `json:"vim_mode"`
	// NerdFont renders the schema tree's node markers as Nerd Font icons
	// (database, folder, table). Omitted means enabled (the built-in
	// default); terminals without a Nerd Font can set false to fall back to
	// geometric symbols.
	NerdFont *bool `json:"nerd_font"`
	// LogLevel is the minimum severity written to the event log and
	// surfaced as notifications: debug, info, warn, or error. Omitted
	// keeps the built-in default (info).
	LogLevel string `json:"log_level"`
	// TableOpenTarget is the workspace tab focused after selecting a table
	// in the schema tree: structure (columns), browse, sql, indexes, or
	// foreign_keys. Omitted keeps the built-in default (structure).
	TableOpenTarget string `json:"table_open_target"`
	// Plugins lists external database driver plugin executables to load at
	// startup. Each entry is a bare executable name resolved through PATH
	// or a path relative to the config file's directory. Nil or empty
	// disables plugins.
	Plugins []string `json:"plugins"`
	// PluginTrust pins configured plugin executables to the lowercase
	// SHA-256 digest of the exact bytes approved with `plugin add
	// --approve`, keyed by the canonical absolute executable path. An
	// entry without a record loads unpinned for compatibility; a record
	// whose digest does not match the current bytes is refused at startup
	// before anything spawns. Nil or empty keeps every entry unpinned.
	PluginTrust map[string]string `json:"plugin_trust,omitempty"`
}

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

type Model struct {
	core.Workflow
	// contains filtered or unexported fields
}

type OpenDatabase func(context.Context, string) (sharedsql.Opened, error)

type PluginControl interface {
	// Statuses returns one status per configured entry, in config order.
	Statuses() []plugin.Status
	// Restart recovers the configured entry identified by its entry
	// text or canonical path.
	Restart(ctx context.Context, identifier string) error
	// EntryForService returns the configured entry text of the plugin
	// child backing service, or "" when service is not a live session of
	// the controller's current generation.
	EntryForService(service sharedsql.Service) (string, bool)
}