@aparte/core 0.10.0 → 0.11.0

package/dist/elicitation/approval-panel.d.ts

@@ -0,0 +1,42 @@
+/**
+ * buildApprovalPanel — the panel for a decision, as opposed to a value.
+ *
+ * A sibling of `buildElicitationPanel` rather than three more parameters on it, and
+ * the split follows the contracts: that function's is "a schema in, a value out", and
+ * an approval has no schema and returns no value. What they share is the composer
+ * slot, which is the presenter's business, not the builder's.
+ *
+ * Two shapes it does NOT reuse, each for a reason:
+ *
+ *  - Not radios plus the composer's send button. A question is one act with one
+ *    primary button, which is why the elicitation panel has no action row of its own.
+ *    A decision has two primary actions of OPPOSITE polarity, and one button cannot
+ *    carry both — so the options are buttons that settle on the first click.
+ *    Approving is the most frequent interaction in the whole feature; spending two
+ *    gestures on it to reuse a button would be the tail wagging the dog.
+ *  - Not a fixed Approve/Reject pair. The options arrive WITH the request, because
+ *    only the requester can write "and always for git commands" or know that this
+ *    workspace has somewhere to remember it.
+ *
+ * The composer's button is not idle: opening the instruction field hands it the
+ * `'submit'` mode for that text, through the `setPanelSubmitEnabled` API that already
+ * exists for the last question of a form.
+ */
+import type { AparteApprovalOption, AparteApprovalAnswer } from './types.js';
+/** What the presenter drives. A superset of the question panel's useful half. */
+export interface BuiltApprovalPanel {
+    readonly el: HTMLElement;
+    /** The corner escape — see `BuiltElicitationPanel.dismiss` for why a corner. */
+    readonly dismiss: HTMLElement;
+    /** Settled from inside the panel: an option was clicked. */
+    onSettle(cb: (answer: AparteApprovalAnswer) => void): void;
+    /** The instruction typed so far, for the composer's submit path. */
+    getContent(): AparteApprovalAnswer;
+    /** True once there is an instruction worth sending. */
+    isComplete(): boolean;
+    focus(): void;
+    /** Re-apply every string taken from the locale, in place. */
+    relabel(): void;
+}
+export declare function buildApprovalPanel(message: string | (() => string), options: readonly AparteApprovalOption[], onChange: () => void): BuiltApprovalPanel;
+//# sourceMappingURL=approval-panel.d.ts.map

package/dist/elicitation/approval-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-panel.d.ts","sourceRoot":"","sources":["../../src/elicitation/approval-panel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG7E,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,oEAAoE;IACpE,UAAU,IAAI,oBAAoB,CAAC;IACnC,uDAAuD;IACvD,UAAU,IAAI,OAAO,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,OAAO,IAAI,IAAI,CAAC;CACnB;AASD,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,EAChC,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,QAAQ,EAAE,MAAM,IAAI,GACrB,kBAAkB,CAqFpB"}

package/dist/elicitation/index.d.ts

@@ -8,9 +8,12 @@
  * events, so there is no stringly-typed contract to drift.
  */
 import type { AparteElicitationRequest, AparteElicitationResult } from './types.js';
-export type { AparteElicitationSchema, AparteElicitationField, AparteElicitationEnumField, AparteElicitationBooleanField, AparteElicitationStringField, AparteElicitationObjectSchema, AparteElicitationRequest, AparteElicitationResult, AparteElicitationPresenter, } from './types.js';
+export type { AparteElicitationSchema, AparteElicitationField, AparteElicitationEnumField, AparteElicitationBooleanField, AparteElicitationStringField, AparteElicitationObjectSchema, AparteElicitationRequest, AparteElicitationResult, AparteElicitationPresenter, AparteApprovalOption, AparteApprovalAnswer, } from './types.js';
+export { AparteElicitationAbortError } from './types.js';
 export { buildElicitationPanel } from './panel.js';
 export type { BuiltElicitationPanel } from './panel.js';
+export { buildApprovalPanel } from './approval-panel.js';
+export type { BuiltApprovalPanel } from './approval-panel.js';
 /**
  * Ask the user for typed input and await their response, on the config
  * governing `request.target` (its instance config, or the global default).

package/dist/elicitation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/elicitation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEpF,YAAY,EACR,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAEpG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/elicitation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEpF,YAAY,EACR,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAEpG"}

package/dist/elicitation/panel.d.ts

@@ -59,5 +59,5 @@ export interface BuiltElicitationPanel {
      */
     relabel(): void;
 }
-export declare function buildElicitationPanel(message: string, schema: AparteElicitationSchema, onChange: () => void): BuiltElicitationPanel;
+export declare function buildElicitationPanel(message: string | (() => string), schema: AparteElicitationSchema, onChange: () => void): BuiltElicitationPanel;
 //# sourceMappingURL=panel.d.ts.map

package/dist/elicitation/panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/elicitation/panel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,uBAAuB,EAK1B,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,gEAAgE;IAChE,UAAU,IAAI,OAAO,CAAC;IACtB,yDAAyD;IACzD,UAAU,IAAI,OAAO,CAAC;IACtB,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;IACd;;;;;;;;;OASG;IACH,IAAI,IAAI,SAAS,GAAG,QAAQ,CAAC;IAC7B,8EAA8E;IAC9E,UAAU,IAAI,OAAO,CAAC;IACtB,mFAAmF;IACnF,OAAO,IAAI,IAAI,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB;AAwRD,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,MAAM,IAAI,GACrB,qBAAqB,CAevB"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/elicitation/panel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,uBAAuB,EAK1B,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,gEAAgE;IAChE,UAAU,IAAI,OAAO,CAAC;IACtB,yDAAyD;IACzD,UAAU,IAAI,OAAO,CAAC;IACtB,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;IACd;;;;;;;;;OASG;IACH,IAAI,IAAI,SAAS,GAAG,QAAQ,CAAC;IAC7B,8EAA8E;IAC9E,UAAU,IAAI,OAAO,CAAC;IACtB,mFAAmF;IACnF,OAAO,IAAI,IAAI,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB;AAwRD,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,EAChC,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,MAAM,IAAI,GACrB,qBAAqB,CAevB"}

package/dist/elicitation/types.d.ts

@@ -2,7 +2,7 @@
  * Elicitation — the generic "pause the run and ask the user for typed input"
  * primitive. Generalises the bespoke `ask_user` tool: the KIND of question
  * is carried by a flat schema, not by a dedicated tool. Shape is aligned with
- * MCP elicitation (message + requested schema, accept/decline/cancel), but the
+ * MCP elicitation (message + requested schema, accept/decline), but the
  * mechanism is transport-agnostic and framework-agnostic — a typed presenter
  * registered per config instance, never window events.
  */
@@ -88,21 +88,102 @@ export interface AparteElicitationObjectSchema {
 export type AparteElicitationSchema = AparteElicitationField | AparteElicitationObjectSchema;
 export interface AparteElicitationRequest {
     /** Human-readable prompt shown above the input(s). */
-    message: string;
+    /**
+     * The sentence above everything else. A string, or a function re-read on relabel.
+     *
+     * Same reason as an option's `label`, and I shipped the two an hour apart because I
+     * fixed the choices and left the QUESTION behind — a panel asking "Run delete_file?"
+     * over buttons reading "Approuver" and "Rejeter". A resolved string has nothing to
+     * re-derive from.
+     *
+     * A function only makes sense when the text comes from the LOCALE, which is core's
+     * own approval question. A tool's question is model-authored: it is a string, and
+     * re-reading it would mean nothing.
+     */
+    message: string | (() => string);
     /** What to ask for. */
-    schema: AparteElicitationSchema;
+    /**
+     * What value to collect. Required on a `'question'`, absent on an `'approval'` —
+     * a decision is not a value, and a schema there would be a form with nothing in it.
+     */
+    schema?: AparteElicitationSchema;
     /**
      * An element inside the target chat, used to resolve WHICH instance presents
      * the request (its config + composer). Omit for the global/default chat.
      */
     target?: HTMLElement | null;
     /**
-     * Aborts the request — the presenter settles `cancel` and closes the panel.
-     * Pass a tool handler's signal so a client-side timeout or turn abort tears
-     * the panel down instead of leaving it open.
+     * What kind of request this is, which decides what the panel puts on screen.
+     *
+     * `'question'` (the default) collects a VALUE against `schema`. `'approval'` asks
+     * the user to pick one of `options` — a decision, not a value — and its answer is
+     * an {@link AparteApprovalAnswer}. One mechanism, two presentations: what a person
+     * is being asked for differs, where they answer does not.
+     */
+    kind?: 'question' | 'approval';
+    /**
+     * The options offered, on `kind: 'approval'`. Required there, ignored otherwise.
+     *
+     * Supplied per request, never fixed by core: a gate that has nowhere to remember a
+     * grant offers two, one that does offers three. Rendering an option the host cannot
+     * honour is the affordance rule read backwards.
+     */
+    options?: readonly AparteApprovalOption[];
+    /**
+     * Aborts the request — the panel closes and the promise REJECTS with
+     * {@link AparteElicitationAbortError}. Pass a tool handler's signal so a
+     * client-side timeout or a stopped turn tears the panel down instead of leaving
+     * it open.
      */
     signal?: AbortSignal;
 }
+/**
+ * One thing the user can pick on an approval.
+ *
+ * The requester writes the LABEL, always. Core cannot know that "and always for git
+ * commands" is meaningful, or that this workspace has somewhere to remember it — so an
+ * option offering a scope exists only because the host built it and can honour it
+ * (ratified decision #8). Two options may share a `value` and differ only in scope,
+ * which is what "Yes" and "Yes, and always for X" are: the same verdict, a different
+ * reach.
+ */
+export interface AparteApprovalOption {
+    /** What {@link AparteApprovalAnswer.option} reports when this one is chosen. */
+    value: string;
+    /**
+     * What the user reads. A string, or a function re-read on every relabel.
+     *
+     * The function arm exists because these are the highest-stakes strings in the
+     * library and they have to follow a language switch WHILE the request is open — a
+     * person deciding whether to let a tool run should not be reading the choice in a
+     * language they did not pick. A plain string cannot: the panel receives it already
+     * resolved and has nothing to re-derive it from.
+     *
+     * So core's own two options pass a function that reads the locale, and a host
+     * passes whatever it likes: its label is its string, and core has no business
+     * translating it.
+     */
+    label: string | (() => string);
+    /**
+     * How it is drawn. `'affirm'` and `'deny'` are the two poles a decision has; a
+     * third would be a preference, not a meaning, so there is no `'neutral'`.
+     */
+    tone?: 'affirm' | 'deny';
+}
+/**
+ * What an approval resolves with, as `content`.
+ *
+ * `instruction` is the free-text arm — "no, do this instead" — and it is a separate
+ * field rather than a magic `option` value because only the host can name its options,
+ * and this text is the user's. It reaches the model as the refusal's reason, which is
+ * possible at all only because a refusal now hands the model a turn to read it in.
+ */
+export interface AparteApprovalAnswer {
+    /** The `value` of the option chosen, or `undefined` when only text was given. */
+    option?: string;
+    /** What the user typed instead, if they typed anything. */
+    instruction?: string;
+}
 /**
  * The user's response. `content` matches the schema:
  * enum→string, enum+multiple→string[], boolean→boolean, string→string,
@@ -113,11 +194,37 @@ export type AparteElicitationResult = {
     content: unknown;
 } | {
     action: 'decline';
-} | {
-    action: 'cancel';
 };
 /**
- * Presents an elicitation request and resolves with the user's response.
+ * The request ended without an answer: the turn was stopped, the signal fired, the
+ * question was taken away by another request, or nothing was mounted to ask it.
+ *
+ * A THROW, and not a third member of {@link AparteElicitationResult}. `cancel` was a
+ * VALUE, so it was easy to handle as though it were an answer — and that is exactly
+ * what happened: the approval gate treated it as a refusal, stamped the segment
+ * `rejected`, and told the model "Tool execution was rejected by the user." The user
+ * had pressed Stop. A rejection cannot be mistaken for a decision by a caller that
+ * forgot a branch, which is the property `cancel` never had.
+ *
+ * `name` is `'AbortError'`, so every `err.name === 'AbortError'` check already written
+ * treats it correctly — including `askUserHandler`, which used to perform this exact
+ * conversion by hand. That hand-conversion existing is the evidence the shape is
+ * right, and it is gone.
+ */
+export declare class AparteElicitationAbortError extends DOMException {
+    /**
+     * Which of the two ways it ended.
+     *
+     * `'no-presenter'` is a developer's setup problem and `'aborted'` is a person
+     * stopping something; a host that reports them the same way reports a bug as a
+     * user action. The distinction is why this carries a field at all.
+     */
+    readonly reason: 'aborted' | 'no-presenter';
+    constructor(reason?: 'aborted' | 'no-presenter');
+}
+/**
+ * Presents an elicitation request and resolves with the user's response, or rejects
+ * with {@link AparteElicitationAbortError} when it ends without one.
  * Registered per config instance via `aparteGlobalConfig.setElicitationPresenter`
  * (the `<aparte-elicitation>` Web Component is the default presenter).
  */

package/dist/elicitation/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/elicitation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/F,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAED,+CAA+C;AAC/C,MAAM,WAAW,6BAA6B;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,yBAAyB;AACzB,MAAM,WAAW,4BAA4B;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4BAA4B;AAC5B,MAAM,MAAM,sBAAsB,GAC5B,0BAA0B,GAC1B,6BAA6B,GAC7B,4BAA4B,CAAC;AAEnC,2DAA2D;AAC3D,MAAM,WAAW,6BAA6B;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnD,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,+EAA+E;AAC/E,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,6BAA6B,CAAC;AAE7F,MAAM,WAAW,wBAAwB;IACrC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,uBAAuB,CAAC;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC7B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE3B;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/elicitation/types.ts"],"names":[],"mappings":"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"}

package/dist/generated/element-attributes.d.ts

@@ -0,0 +1,173 @@
+/** `<aparte-chat>` — AparteChat - The Shell */
+export interface AparteChatAttributes {
+    /** Placeholder for the composer input (default composition) */
+    placeholder?: string;
+    /** Disables the composer */
+    disabled?: boolean;
+    /** Center the composer as a welcome state until the first message, then slide to the normal layout */
+    'center-empty'?: boolean;
+    /** Add the file picker + chips strip to the default composition (opt-in: the host must consume the files — an `AparteClient` does, a hand-rolled loop must read `event.detail.files`) */
+    attachments?: boolean;
+    /** The wrapper's explicit hands-off signal: set it and this element composes none of its own children, because the framework owns them. All four wrappers set it; it was read by this element and declared by nothing until now. */
+    'framework-managed'?: boolean;
+}
+/** `<aparte-chat-bubble>` — One message: plain content or a list of rich segments, in light DOM. */
+export interface AparteChatBubbleAttributes {
+    /** The message role. `data-role` is the styled mirror of it. */
+    role?: string;
+    /** `user` / `assistant` / `system`; what the CSS keys off. */
+    'data-role'?: string;
+    /** Plain text content, for a bubble with no segments. */
+    content?: string;
+    /** Epoch milliseconds OR a date string: `_updateTimestamp` accepts either and only coerces when the value is numeric. */
+    timestamp?: number | string;
+    /** How streaming and the action bar address this bubble. */
+    'message-id'?: string;
+    /** Hides the action bar and shows the caret while a reply is in flight. */
+    streaming?: boolean;
+    /** The display name in the header. */
+    name?: string;
+}
+/** `<aparte-chat-status>` — A standalone status line — a light-DOM typing indicator the APP owns. Core never turns it on by itself, so it can never compete with the bubble's own waiting state. */
+export interface AparteChatStatusAttributes {
+    /** Shows or hides the indicator. */
+    visible?: boolean;
+    /** The line to show. Defaults to the locale's typing string. */
+    text?: string;
+}
+/** `<aparte-chat-viewport>` — The transcript surface: a light-DOM container with sticky scrolling, token streaming and segment-aware rendering. */
+export interface AparteChatViewportAttributes {
+    /** How close to the bottom still counts as "at the bottom". */
+    'scroll-threshold'?: number;
+    /** Caps how many bubbles stay in the DOM; older ones are released. */
+    'max-rendered-bubbles'?: number;
+    /** DEPRECATED. It used to evict messages from the model; it now only caps rendered bubbles, which is what `max-rendered-bubbles` says. For real history retention configure the conversation manager instead. */
+    'max-messages'?: number;
+    /** The wrapper's explicit hands-off signal: set it and this element composes none of its own children, because the framework owns them. All four wrappers set it; it was read by this element and declared by nothing until now. */
+    'framework-managed'?: boolean;
+}
+/** `<aparte-composer>` — The root context for every `aparte-composer-*` primitive. It imposes no visual layout — the consumer owns the structure — and holds the shared state the parts read: the value, the streaming flag, pending attachments, the panel slot. */
+export interface AparteComposerAttributes {
+    /** Forwarded to `<aparte-composer-input>` through the internal bus. */
+    placeholder?: string;
+    /** Disables the whole composer, every part included. */
+    disabled?: boolean;
+    /** The id of the `<aparte-chat>` this composer drives. */
+    target?: string;
+}
+/** `<aparte-composer-action>` — Generic action button primitive for <aparte-composer>. */
+export interface AparteComposerActionAttributes {
+    /** Icon key for aparteGlobalConfig.getIcon(), or raw SVG/HTML starting with `<` */
+    icon?: string;
+    /** Accessible label (also used as tooltip) */
+    label?: string;
+    /** Disables the button */
+    disabled?: boolean;
+}
+/** `<aparte-composer-add-attachment>` — File picker button for <aparte-composer>. */
+export interface AparteComposerAddAttachmentAttributes {
+    /** MIME types / extensions passed to the file input (e.g. "image/*,.pdf") */
+    accept?: string;
+    /** Allow multiple file selection (default: true) */
+    multiple?: boolean;
+    /** Greys out the picker and ignores drops. */
+    disabled?: boolean;
+}
+/** `<aparte-composer-input>` — Contenteditable text input primitive. */
+export interface AparteComposerInputAttributes {
+    /** Placeholder text (fallback: reads from aparte-composer) */
+    placeholder?: string;
+    /** Max height in px before scroll (default: 200) */
+    'max-height'?: number;
+    /** Min height in px. When omitted, the stylesheet's min-height governs (44px in aparte.css) — so themes can resize the editor in pure CSS without being fought by an inline height. */
+    'min-height'?: number;
+    /** Makes the field non-editable; the composer's own `disabled` also reaches it. */
+    disabled?: boolean;
+}
+/** `<aparte-composer-toolbar>` — The composer's bottom row — the strip a mode picker, a model selector or a token counter belongs in, rather than a bar of your own floating below the chat. Purely structural: it lays its children out in a row and gets out of the way. */
+export interface AparteComposerToolbarAttributes {
+    /** Reflected BY the element while it holds no element child; the stylesheet hides it then. Read-only, do not set it yourself. */
+    'data-empty'?: boolean;
+}
+/** `<aparte-conversation-list>` — Conversation-history sidebar — a framework-agnostic web component. The host sets the `conversations` JS property and the `active-id` attribute; this renders the list and fires the user's intent, never acting on it itself. */
+export interface AparteConversationListAttributes {
+    /** The id of the conversation to render as selected. */
+    'active-id'?: string;
+}
+/** `<aparte-optgroup>` — AparteOptgroup */
+export interface AparteOptgroupAttributes {
+    /** Group label */
+    label?: string;
+    /** Allow collapse/expand */
+    collapsible?: boolean;
+    /** Collapsed state */
+    collapsed?: boolean;
+    /** Shows a spinner in place of the group's options. */
+    loading?: boolean;
+}
+/** `<aparte-option>` — AparteOption */
+export interface AparteOptionAttributes {
+    /** Option value */
+    value?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Selected state */
+    selected?: boolean;
+    /** Free-form status the host sets; styled, never read by core. */
+    'data-status'?: string;
+}
+/** `<aparte-progress-spinner>` — AparteProgressSpinner */
+export interface AparteProgressSpinnerAttributes {
+    /** Progress percentage 0–100 (omit for indeterminate) */
+    value?: number;
+}
+/** `<aparte-select>` — Dropdown select for aparté — a vanilla web component with optional grouping, a search filter and a keyboard-driven listbox. */
+export interface AparteSelectAttributes {
+    /** The selected option's value. */
+    value?: string;
+    /** Shown while nothing is selected. */
+    placeholder?: string;
+    /** Blocks opening and selection. */
+    disabled?: boolean;
+    /** Renders `<aparte-optgroup>` children as collapsible groups. */
+    grouped?: boolean;
+    /** Adds a filter field above the options. */
+    searchable?: boolean;
+    /** Reflects (and controls) whether the dropdown is open. */
+    open?: boolean;
+}
+/**
+ * The elements that observe no attribute at all. An empty surface is the honest
+ * declaration — it says "checked, there are none", where an absent entry would only
+ * say "not looked at": `<aparte-composer-attachments>`, `<aparte-composer-cancel>`, `<aparte-composer-send>`, `<aparte-elicitation>`.
+ */
+export type AparteNoAttributes = Record<never, never>;
+/**
+ * Tag name to its attribute surface — the registry every wrapper maps over.
+ *
+ * Total by construction: it is generated from the manifest, so an element cannot be
+ * missing from it, which is the property a hand-written list could not have.
+ */
+export interface AparteElementAttributes {
+    'aparte-chat': AparteChatAttributes;
+    'aparte-chat-bubble': AparteChatBubbleAttributes;
+    'aparte-chat-status': AparteChatStatusAttributes;
+    'aparte-chat-viewport': AparteChatViewportAttributes;
+    'aparte-composer': AparteComposerAttributes;
+    'aparte-composer-action': AparteComposerActionAttributes;
+    'aparte-composer-add-attachment': AparteComposerAddAttachmentAttributes;
+    'aparte-composer-attachments': AparteNoAttributes;
+    'aparte-composer-cancel': AparteNoAttributes;
+    'aparte-composer-input': AparteComposerInputAttributes;
+    'aparte-composer-send': AparteNoAttributes;
+    'aparte-composer-toolbar': AparteComposerToolbarAttributes;
+    'aparte-conversation-list': AparteConversationListAttributes;
+    'aparte-elicitation': AparteNoAttributes;
+    'aparte-optgroup': AparteOptgroupAttributes;
+    'aparte-option': AparteOptionAttributes;
+    'aparte-progress-spinner': AparteProgressSpinnerAttributes;
+    'aparte-select': AparteSelectAttributes;
+}
+/** Every tag this package defines, derived from the registry so the two cannot diverge. */
+export type AparteElementTagName = keyof AparteElementAttributes;
+//# sourceMappingURL=element-attributes.d.ts.map

package/dist/generated/element-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-attributes.d.ts","sourceRoot":"","sources":["../../src/generated/element-attributes.ts"],"names":[],"mappings":"AAIA,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACjC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sGAAsG;IACtG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yLAAyL;IACzL,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oOAAoO;IACpO,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,oGAAoG;AACpG,MAAM,WAAW,0BAA0B;IACvC,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yHAAyH;IACzH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oMAAoM;AACpM,MAAM,WAAW,0BAA0B;IACvC,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mJAAmJ;AACnJ,MAAM,WAAW,4BAA4B;IACzC,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iNAAiN;IACjN,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oOAAoO;IACpO,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,qQAAqQ;AACrQ,MAAM,WAAW,wBAAwB;IACrC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,0FAA0F;AAC1F,MAAM,WAAW,8BAA8B;IAC3C,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qFAAqF;AACrF,MAAM,WAAW,qCAAqC;IAClD,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wEAAwE;AACxE,MAAM,WAAW,6BAA6B;IAC1C,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uLAAuL;IACvL,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,8QAA8Q;AAC9Q,MAAM,WAAW,+BAA+B;IAC5C,iIAAiI;IACjI,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,mQAAmQ;AACnQ,MAAM,WAAW,gCAAgC;IAC7C,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,WAAW,wBAAwB;IACrC,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACnC,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0DAA0D;AAC1D,MAAM,WAAW,+BAA+B;IAC5C,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sJAAsJ;AACtJ,MAAM,WAAW,sBAAsB;IACnC,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACpC,aAAa,EAAE,oBAAoB,CAAC;IACpC,oBAAoB,EAAE,0BAA0B,CAAC;IACjD,oBAAoB,EAAE,0BAA0B,CAAC;IACjD,sBAAsB,EAAE,4BAA4B,CAAC;IACrD,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,wBAAwB,EAAE,8BAA8B,CAAC;IACzD,gCAAgC,EAAE,qCAAqC,CAAC;IACxE,6BAA6B,EAAE,kBAAkB,CAAC;IAClD,wBAAwB,EAAE,kBAAkB,CAAC;IAC7C,uBAAuB,EAAE,6BAA6B,CAAC;IACvD,sBAAsB,EAAE,kBAAkB,CAAC;IAC3C,yBAAyB,EAAE,+BAA+B,CAAC;IAC3D,0BAA0B,EAAE,gCAAgC,CAAC;IAC7D,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,eAAe,EAAE,sBAAsB,CAAC;IACxC,yBAAyB,EAAE,+BAA+B,CAAC;IAC3D,eAAe,EAAE,sBAAsB,CAAC;CAC3C;AAED,2FAA2F;AAC3F,MAAM,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC"}