resource

type Action struct {
	Key  string // e.g. "l"
	Name string // shown in header hints, e.g. "Logs"
	// Dangerous actions require a confirmation dialog and are hidden
	// entirely when the app runs with --readonly.
	Dangerous bool
	// NeedsRow actions are no-ops when the table is empty.
	NeedsRow bool
	// Run performs the action. It executes inside a tea.Cmd, so it may do
	// I/O; it returns a message for the app to route (declared as any here
	// to keep this package free of UI imports).
	Run func(ctx context.Context, c *dbx.Clients, scope Scope, row Row) any
}

type AltWebLinker interface {
	AltWebURL(host string, scope Scope, row Row) (url string, ok bool)
	AltWebHint() string
}

type CellClass int

type ColSpec[T any] struct {
	Column
	Extract func(T) string
}

type Column struct {
	Title string
	// Width semantics: 0 = flex (share remaining space), >0 = fixed width.
	Width int
	// Wide columns are hidden unless the terminal is wide enough.
	Wide bool
}

type Command struct {
	Def   Def
	Scope Scope
	// Filter pre-seeds a substring filter on the list, from a trailing /text.
	Filter string
	// Item is a positional item selector beyond the scope args — the exact
	// name (or ID) of a single row to open directly, e.g. the "orders" in
	// `tables main silver orders` or the "my-app" in `apps my-app`.
	Item string
}

type Def interface {
	// Name is the canonical command name, e.g. "tables".
	Name() string
	// Aliases are alternative command names, e.g. ["table", "tbl"].
	Aliases() []string
	// Args names the positional scope keys required by this resource, in
	// order, e.g. tables → ["catalog", "schema"]. Empty for unscoped.
	Args() []string
	Columns() []Column
	List(ctx context.Context, c *dbx.Clients, scope Scope) ([]Row, error)
	// PollInterval is the steady-state refresh cadence; the engine adds
	// jitter and backoff. Use long intervals for rate-limited APIs (SCIM).
	PollInterval() time.Duration
	// Child names the resource pushed when the user presses Enter on a
	// row; "" marks a leaf.
	Child() string
	// ChildScope builds the drilled-down scope from the selected row.
	ChildScope(parent Scope, row Row) Scope
	Actions() []Action
	// Describe returns the detail object rendered by the describe view.
	Describe(ctx context.Context, c *dbx.Clients, scope Scope, row Row) (any, error)
}

type Opener interface {
	EnterMsg(c *dbx.Clients, scope Scope, row Row) any
}

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

type Row struct {
	ID    string   // stable identity: cursor preservation, drill-down key
	Cells []string // aligned to Columns()
	Data  any
}

type RowNamer interface {
	RowName(row Row) string
}

type Scope map[string]string

type Styler interface {
	CellClass(col int, value string) CellClass
}

type Tabber interface {
	Tabs() []string
}

type Tagger interface {
	RowTags(row Row) []string
}

type WebLinker interface {
	WebURL(host string, scope Scope, row Row) (url string, ok bool)
}