sqlapplet

type AppletDef struct {
	Slug     string
	BookID   string
	Title    string
	Icon     string
	Tabs     []TabSel // nil = auto (all result panels; accept/reject decides at render)
	Endpoint EndpointE
	SQL      string
	BandsSQL string // optional `sql bands` aux fence (Timeline panel-local SQL)
	// Preamble is the optional `md preamble` aux fence: explanatory markdown
	// the instance renders above the result panes. It is deliberately its own
	// fence rather than the document's leading prose — an author decides what
	// belongs over the numbers and what belongs in the Definition drawer, and
	// existing applets gain nothing they did not ask for. Note that
	// [scanFences] does not nest, so a preamble cannot itself contain a
	// fenced block.
	Preamble string
	// Class is the ADR-0132 §SD5 security class of SQL, computed at parse
	// time. It gates AutoRun at mount: only QuerySecurityRead applets run on
	// open.
	Class analysis.QuerySecurityClassE
	// HasUnboundSlots notes whether the buffer carries `{name:Type}`
	// placeholders its SET prelude does not bind — signals, in ADR-0097
	// terms. Such an applet opens with the Live toggle preset
	// (panel-written signals re-run the buffer, ADR-0132 §SD3); a fully
	// prelude-bound buffer does not (its params re-run via the strip's
	// prelude rewrite and an explicit or auto Run).
	HasUnboundSlots bool
	// Datasets are the stable ad-hoc dataset aliases the buffer references
	// as keelson('<alias>') (ADR-0134 §SD4). An embedder binds each to an
	// ephemeral handle before mount. The corpus gate treats them as
	// valid-by-declaration.
	Datasets []string
	// DatasetsHint is the frontmatter `datasets_hint`: one line telling a
	// reader how to produce the declared datasets, shown in the applet's
	// notice strip while an alias is still unbound. Optional, and only
	// meaningful alongside Datasets.
	//
	// It exists because the alias is the only thing the runtime knows: play
	// can say `pprof_cpu` has nothing behind it, but only the author knows
	// that imzrt's Profiles tab is what puts something there. Without it the
	// empty state names a table the reader has never heard of.
	DatasetsHint string
	// Source is the document's raw markdown — the definition itself, kept so
	// an instance can show a reader what it was minted from (play's
	// "Definition" drawer). Bytes rather than a parsed markdown.Doc: parsing
	// at mint time would hold a segment tree per corpus document for the
	// whole session, where the drawer needs one per opened applet. A def
	// built by hand rather than parsed carries none, and the drawer is
	// simply absent.
	Source []byte
	// Topics classify the applet by subject for the launcher (ADR-0158
	// §SD2). Set from a frontmatter `topics:` list; nil when the document
	// omits it, in which case the *minter* fills the contributing book's
	// default (see RegisterBook) — the grouping the corpus already carries,
	// which pre-0158 minting discarded. The default lands at mint rather
	// than at parse because ParseDocSource is shared with the runtime store
	// and with embedders, neither of which has a book to default from.
	//
	// A frontmatter topic outside the registered vocabulary fails the parse
	// rather than being dropped: a silently ignored topic would mint an
	// applet the launcher cannot section.
	Topics []app.TopicT
	// Keywords are the document's optional frontmatter `keywords:` list,
	// passed through to the manifest as free retrieval text (ADR-0158 §SD4).
	Keywords []string
}

type EmbedConfig struct {
	// StampAppId is the identity the log_comment stamp attributes runs to.
	// A standalone applet passes its minted manifest id; an embedder passes
	// a composed stamp — its own app id carrying the applet slug — so
	// per-applet attribution survives embedding (ADR-0134 §SD7).
	StampAppId string
	// RunId is the runtime run identity for the stamp.
	RunId string
	// InstanceKey is the window the stamp attributes runs to (ADR-0191
	// §SD4). Zero for an embedder that mints no window keys, which stamps
	// run and app as before.
	InstanceKey uint64
	// Bus is the capability bus for SetCapabilities. An applet's declared
	// capabilities ride the embedder's manifest (§SD8), so this is the
	// embedder's bus.
	Bus app.BusI
	// Log is the instance logger.
	Log zerolog.Logger
	// EndpointURL overrides the resolved endpoint. Empty resolves from
	// def.Endpoint (introspection → LocalQueryEndpoint; default → env).
	EndpointURL string
	// Bindings maps each declared dataset alias to the ephemeral handle the
	// embedder published, applied pre-mount so the buffer's keelson('<alias>')
	// rewrites to the handle client-side (ADR-0134 §SD4).
	Bindings map[string]string
	// Rules is the gloss rule repository the instance is built over
	// (ADR-0186): the embedder's standing rules and catalog. Nil takes
	// play.DefaultRepository, so an applet host that registers no rule sets
	// of its own shares the deployment's.
	Rules *gloss.Repository
}

type EndpointE uint8

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

type TabSel struct {
	ID   string
	Node string
	// Zone is the pane's placement, empty for the panel's own default. See
	// [tabZones] for the three an author may name and why the other two are
	// not among them.
	Zone string
}