registry

type Chip struct {
	// Verb is the action word. It is drawn FIRST, at the brighter of the
	// surface's two tiers, and it is never dropped: a chip that cut its verb to
	// spell its key would be teaching a keystroke with no name on it.
	Verb string
	// Key is the accelerator, drawn after the verb and one tier down. EMPTY IS
	// A REAL ANSWER, not a gap — a belt-only verb is reached through the user's
	// own words and has no key by construction — so a painter must test it
	// rather than assume the chip has two halves.
	Key string
}

type Entry struct {
	// ID is unique across the whole catalog, checked by TestEntriesHaveUniqueIDs.
	ID string
	// Verb is the short verb phrase a strip or chip renders: "cancel",
	// "restart", "open self".
	Verb string
	// Description is the one-line sentence the palette and the `?` surface
	// show beside Verb.
	Description string
	// Scope is where the entry applies — see Scope's doc.
	Scope Scope
	// Key is the canonical live key binding, in Bubble Tea's own chord
	// spelling ("c", "alt+g", "ctrl+j"). Empty when the entry has none.
	// Where today's surface accepts more than one spelling for the same
	// chord (ctrl+t and alt+g both toggle the task list), Key names the one
	// the help screen leads with; the synonym is not a second registration.
	Key string
	// ChordKey is this entry's accelerator on a [SurfaceComposerFirst]
	// surface, where Key's bare letter cannot be bound at all. It is recorded
	// only when a surface really binds the chord — the registry names doors
	// that exist, never doors it would like to exist — so most rows leave it
	// empty, and a row whose Key is already a chord never needs one.
	//
	// Read it through [Entry.KeyOn] or [Entry.On] rather than directly: those
	// answer the question a render surface actually has, which is "what, if
	// anything, do I tell the user to press here."
	ChordKey string
	// Slash is the alias typed after "/" in the composer or a task's steer
	// line, without the leading slash. Empty when the entry has none.
	Slash string
	// Journal is what the action journals, when it journals anything.
	Journal Journal
	// Confirm is the question a destructive verb asks before it fires, in the
	// product's own voice and in one line. EMPTY IS THE COMMON CASE and means
	// the verb fires at once: pausing a rule, restarting a service and running
	// a way of working are all reversible by doing the opposite, and asking
	// about them would be ceremony.
	//
	// It is a sentence rather than a boolean because the only useful part of a
	// confirmation is what it says is about to be lost, and that is per-verb:
	// "retire this rule?" and "stop this service?" are not the same warning
	// with a different noun in it. A surface draws it however it draws
	// questions; this package renders nothing.
	//
	// Confirm and [Entry.Steer] are never both set. A verb that needs the
	// user's own words is answered by them typing, and a confirmation on top of
	// that would be asking twice about one sentence.
	Confirm string
	// Steer is the composer seed for a verb that carries an argument the
	// resident has to interpret — a new cadence, a corrected belief, the reason
	// a version is going back. Per the one-mouth law those verbs do not fire on
	// a click: they put the user's cursor in the composer with the sentence
	// half written, and the head reads what they finish.
	//
	// It carries exactly one %s, which is the item's own name as the user knows
	// it. Read it through [Entry.SteerFor] rather than formatting it by hand.
	Steer string
	// contains filtered or unexported fields
}

type Journal struct {
	// Kind is the store command kind the action journals as. Empty when the
	// entry never journals (view toggles, local settings, reads).
	Kind store.CommandKind
	// Tool is the head belt tool name the entry resolves to, for the
	// entries reachable only through ScopeTalk. Empty for everything else.
	Tool string
}

type Match struct {
	Entry Entry
	Score int
}

type Scope uint8

type Surface uint8