@aparte/core 0.19.2 → 0.20.0

package/dist/components/bubble/aparte-chat-bubble.d.ts

@@ -1,4 +1,5 @@
 import type { AparteSegment, AparteAttachment, AparteUsage, AparteMessage } from '../../types/index.js';
+import { type AparteConfigAware } from '../../config/config-context.js';
 /**
  * One message: plain content or a list of rich segments, in light DOM.
  *
@@ -36,14 +37,10 @@ import type { AparteSegment, AparteAttachment, AparteUsage, AparteMessage } from
  * on `.aparte-message`), never from a status attribute, so it behaves identically in
  * vanilla and in every wrapper.
  *
- * All seven events are declared by hand rather than left to the analyser, which
- * found six. `aparte-branch-navigate` is dispatched from the `_onBranchPickerClick`
- * arrow class field, and the auto-detection visits `ts.isMethodDeclaration` only —
- * so the one event belonging to the branch picker was the one missing from the
- * manifest, and from the generated reference, for as long as both existed.
+ * All eight events are declared by hand rather than left to the analyser.
  *
  * The bubble element is `content-visibility: auto` for its streaming/scroll performance
- * (measured, not assumed — see `bubble.css`), and that containment makes the bubble
+ * (see `bubble.css`), and that containment makes the bubble
  * the containing block for `position: fixed` descendants: a popover mounted inside it
  * (an `<aparte-select>` from a `registerToolRenderer` renderer, say) is clipped to the
  * bubble's own box, not the window. Mount it outside instead — [Custom tool
@@ -51,12 +48,12 @@ import type { AparteSegment, AparteAttachment, AparteUsage, AparteMessage } from
  *
  * @element aparte-chat-bubble
  *
- * @attr {string} data-role - The message role, `user` or `assistant` — the one channel for it, and what the CSS keys off. (`role` is ARIA's attribute; this element sets it to `article` itself and no longer reads a message role from it.)
+ * @attr {string} data-role - The message role, `user` or `assistant` — the one channel for it, and what the CSS keys off. (`role` is ARIA's attribute; this element sets it to `article` itself and does not read a message role from it.)
  * @attr {string} content - Plain text content, for a bubble with no segments.
- * @attr {number | string} timestamp - Epoch milliseconds OR a date string: `_updateTimestamp` accepts either and only coerces when the value is numeric.
+ * @attr {number | string} timestamp - Epoch milliseconds or a date string; a numeric string is read as milliseconds.
  * @attr {string} message-id - How streaming and the action bar address this bubble.
  * @attr {boolean} streaming - Hides the action bar and shows the caret while a reply is in flight.
- * @attr {string} name - The display name in the header.
+ * @attr {string} name - Who wrote the message: shown in the header, and the message's accessible name ("Message from {name}"). Leave it out for the reader and the assistant, whose names come from the locale.
  *
  * @fires {CustomEvent<AparteActionEventDetail>} aparte-action - A custom action-bar button was pressed.
  * @fires {CustomEvent<AparteRetryEventDetail>} aparte-retry - Retry was pressed; the host forks the turn.
@@ -68,25 +65,26 @@ import type { AparteSegment, AparteAttachment, AparteUsage, AparteMessage } from
  * @fires {CustomEvent<AparteLinkClickEventDetail>} aparte-link-click - A link in the message body is about to be followed. Cancelable: `preventDefault()` keeps the browser from navigating, so a host can route the link itself.
  *
  * @cssprop [--aparte-message-gap=var(--aparte-space-6)] - Gap between the avatar column and the body (the viewport reuses it between messages).
- * @cssprop [--aparte-message-padding-block=var(--aparte-space-8)] - Vertical padding of one message row. (The composite `--aparte-message-padding` is gone: joined on `:root`, it froze both parts, and the narrow-container override of them never reached the row.)
+ * @cssprop [--aparte-message-padding-block=var(--aparte-space-8)] - Vertical padding of one message row.
  * @cssprop [--aparte-message-padding-inline=var(--aparte-space-6)] - Horizontal padding of one message row.
  * @cssprop [--aparte-message-max-width=800px] - Width of the centred message row.
  *
  * @cssprop [--aparte-message-content-radius=var(--aparte-radius-bubble)] - Radius of the painted content box.
- * @cssprop [--aparte-message-content-padding=var(--aparte-space-5) var(--aparte-space-7)] - Padding of the USER box only; the assistant's content is plain full-width prose.
+ * @cssprop [--aparte-message-content-padding=var(--aparte-space-5) var(--aparte-space-7)] - Padding of the user's box.
+ * @cssprop [--aparte-message-content-padding-assistant=0] - Padding of the assistant's box, none by default: its reply is plain prose across the column.
  * @cssprop --aparte-message-content-bg-user - Background of the user box: a wash of `--aparte-primary` over `--aparte-surface-1`, derived in `theme.css` so a rebrand moves it (declare it to override).
  * @cssprop [--aparte-message-content-bg-assistant=transparent] - Background of the assistant box — transparent on purpose (AI-chat convention, not messaging).
- * @cssprop [--aparte-message-content-text-user=var(--aparte-text)] - Text colour inside the user box.
- * @cssprop [--aparte-message-content-text-assistant=var(--aparte-text)] - Text colour inside the assistant box.
+ * @cssprop --aparte-message-content-text-user - Colour of the user's words. Unset by default: they keep `--aparte-content-color`.
+ * @cssprop --aparte-message-content-text-assistant - Colour of the assistant's words. Unset by default: they keep `--aparte-content-color`.
  *
  * @cssprop [--aparte-avatar-size=32px] - Square size of the avatar slot.
- * @cssprop [--aparte-avatar-radius-ratio=0.28] - Avatar corner radius, as a fraction of its size (the corner follows the ramp; 0.28 × 32px is the 9px it used to be).
+ * @cssprop [--aparte-avatar-radius-ratio=0.28] - Avatar corner radius, as a fraction of its size (the corner follows the ramp).
  * @cssprop [--aparte-avatar-initials-ratio=0.34] - Size of the initial, as a fraction of the avatar's size.
  * @cssprop [--aparte-avatar-bg-user=var(--aparte-primary)] - Avatar background, user role.
  * @cssprop [--aparte-avatar-text-user=var(--aparte-text-inverse)] - Avatar text colour, user role.
  * @cssprop [--aparte-avatar-bg-assistant=var(--aparte-surface-3)] - Avatar background, assistant role.
  * @cssprop [--aparte-avatar-text-assistant=var(--aparte-text)] - Avatar text colour, assistant role.
- * @cssprop [--aparte-avatar-image-user=none] - `background-image` for the user avatar — a logo with no AvatarProvider and no JS.
+ * @cssprop [--aparte-avatar-image-user=none] - `background-image` for the user avatar — a logo with no AvatarProvider: the slot shows when it names an image.
  * @cssprop [--aparte-avatar-image-assistant=none] - `background-image` for the assistant avatar.
  * @cssprop [--aparte-avatar-image-size=90%] - `background-size` for both avatar images.
  *
@@ -131,7 +129,6 @@ import type { AparteSegment, AparteAttachment, AparteUsage, AparteMessage } from
  * <aparte-chat-bubble
  *   message-id="a1"
  *   data-role="assistant"
- *   name="Assistant"
  *   content="Hello."
  * ></aparte-chat-bubble>
  *
@@ -147,7 +144,6 @@ import type { AparteSegment, AparteAttachment, AparteUsage, AparteMessage } from
  * <aparte-chat-bubble
  *   message-id="a3"
  *   data-role="assistant"
- *   name="Assistant"
  *   content="A second take on the same question."
  * ></aparte-chat-bubble>
  *
@@ -155,7 +151,7 @@ import type { AparteSegment, AparteAttachment, AparteUsage, AparteMessage } from
  *   document.querySelector('aparte-chat-bubble[message-id="a3"]').setSiblings(2, 0);
  * </script>
  */
-export declare class AparteChatBubble extends HTMLElement {
+export declare class AparteChatBubble extends HTMLElement implements AparteConfigAware {
     private _contentEl;
     private _segmentsEl;
     private _attachmentsEl;
@@ -170,8 +166,20 @@ export declare class AparteChatBubble extends HTMLElement {
     private _usage;
     /** Cleanup returned by the avatar provider — called on disconnect/re-render. */
     private _avatarCleanup;
+    /** Whether the avatar slot holds what a provider drew, which goes when the provider does. */
+    private _avatarFromProvider;
     /** Sibling count for tree-based branch navigation (set by setSiblings()) */
     private _siblingCount;
+    /**
+     * Which accessible names the bubble wrote itself, and so may refresh on a language switch
+     * or a name change. A custom shell's own are its author's: refreshed, a root's or a bar's
+     * label of their own became "Assistant response" or "Message actions" at the first notify.
+     */
+    private _wroteRootLabel;
+    private _wroteBarLabel;
+    private _wroteArrowLabels;
+    /** The shell renderer the bubble was last drawn with (`null`: the default frame). */
+    private _drawnShell;
     /** Sibling index for tree-based branch navigation (set by setSiblings()) */
     private _siblingIndex;
     /** True while the user-message inline editor is open. */
@@ -187,6 +195,17 @@ export declare class AparteChatBubble extends HTMLElement {
     static get observedAttributes(): string[];
     constructor();
     private _onConfigChange;
+    /** A {@link _redrawIfStale} is queued for the end of the current task. */
+    private _redrawQueued;
+    /** The {@link renderingVersionOf} count the content was last drawn with. */
+    private _drawnWithVersion;
+    /**
+     * A Markdown or highlight provider set after this message was drawn: draw it again.
+     * Not mid-stream — the stream reads the providers as it goes, and its end redraws — and
+     * not mid-edit, where the drawn message is hidden behind the editor and drawing it would
+     * show it again beside the editor; leaving the edit calls this.
+     */
+    private _redrawIfStale;
     /**
      * Ask every rendered segment to re-read its config-derived text.
      *
@@ -218,6 +237,20 @@ export declare class AparteChatBubble extends HTMLElement {
      */
     private get _cfg();
     connectedCallback(): void;
+    /**
+     * The boundary above this bubble changed — under every wrapper the chat's own config is
+     * attached AFTER the first messages are drawn. When that brings another frame
+     * (`setBubbleShellRenderer`), the bubble is drawn again in it and its content put back,
+     * so every message wears the chat's frame.
+     *
+     * Deferred to a microtask: a wrapper detaches the boundary as it unmounts (Vue's
+     * `onBeforeUnmount`, Svelte's `onDestroy`), while the bubbles are still in the page, and
+     * redrawing every one of them just before their removal would cost a frame per message.
+     * After the microtask a removed bubble is no longer connected, and repeated notices fold
+     * into one.
+     */
+    aparteConfigChanged(): void;
+    private _redrawFrameIfChanged;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     /** Append a token chunk (for streaming) */
@@ -251,11 +284,11 @@ export declare class AparteChatBubble extends HTMLElement {
      * query returns the first match in document order — and sanitized model
      * markdown renders inside that same container, with `data-*` attributes
      * deliberately preserved (they are inert). So a decoy `data-segment-id` planted
-     * in an earlier segment's prose used to win over the real segment element.
+     * in an earlier segment's prose would win over the real segment element.
      *
      * Parser ids are unguessable UUIDs, but a tool segment is `tool-${toolCallId}`
-     * and the MODEL chooses that id — so this was reachable, and pointing an update
-     * at a decoy left a rejected tool rendering as still-running: a spoof against
+     * and the MODEL chooses that id — so a decoy could point an update at the wrong
+     * element and leave a rejected tool rendering as still-running: a spoof against
      * the human-in-the-loop control.
      */
     removeSegment(segmentId: string): void;
@@ -289,8 +322,7 @@ export declare class AparteChatBubble extends HTMLElement {
     private _render;
     /**
      * Show the built-in waiting indicator while this bubble is in flight and has
-     * nothing to show yet — the gap between "user sends" and the first token, which
-     * used to be a bubble with a name and an empty body.
+     * nothing to show yet — the gap between "user sends" and the first token.
      *
      * The dots are CSS (no per-token work, themable, honours reduced-motion); the
      * accessible name is `locale.typing`, next to the `aria-busy` the streaming state
@@ -301,13 +333,19 @@ export declare class AparteChatBubble extends HTMLElement {
     /**
      * Hand the avatar host element off to the registered AvatarProvider, if any.
      *
-     * With no provider the slot is left exactly as the shell rendered it — which for
-     * the default shell means EMPTY, and hidden by `.aparte-avatar:empty`. This used
-     * to claim it "falls back to the default initial rendered by `_render()`"; there
-     * is no such initial, and believing there was is what made `_updateRole` write
-     * one.
+     * With no provider the slot keeps what the shell rendered — for the default shell,
+     * nothing, hidden while empty — and loses what a provider drew there before. An empty
+     * slot still shows when the stylesheet names a picture for its role
+     * (`--aparte-avatar-image-user` / `-assistant`): see `_markAvatarImage`.
      */
     private _renderAvatar;
+    /**
+     * A picture from the stylesheet alone: an empty slot whose role's `--aparte-avatar-image-*`
+     * names an image gets `data-image`, which lifts the rule that hides an empty slot. Hidden
+     * while empty, the token painted nothing. Read when the message is drawn and on every
+     * config change, in a batch with the other bubbles' (see `pendingAvatarMarks`).
+     */
+    private _markAvatarImage;
     private _updateRole;
     private _updateName;
     private _updateContent;
@@ -329,6 +367,12 @@ export declare class AparteChatBubble extends HTMLElement {
      */
     private _reflectError;
     private _updateTimestamp;
+    /**
+     * Named after its author when it has one: a `name` on the bubble is who wrote it (a human
+     * agent answering on the assistant's side, a second assistant), and naming every one of
+     * them "Assistant response" told a screen-reader user the opposite of what the page shows.
+     * Without a name, the role names it.
+     */
     private _getAriaLabel;
     private _updateAttachments;
     /** Uppercased file extension (≤4 chars), or 'FILE' when there is none. */
@@ -337,9 +381,9 @@ export declare class AparteChatBubble extends HTMLElement {
      *
      * An attachment's `url` is documented as "URL or data URI" and a storage adapter
      * re-mints it when a conversation is restored, so it is the app's value, not the
-     * composer's — it was escaped and written, where every other URL core emits is
-     * asked whether its SCHEME is allowed at all. A picture whose URL is refused is
-     * not half-rendered: it falls back to the file chip, which still names the file.
+     * composer's — and, like every other URL core emits, it is asked whether its SCHEME
+     * is allowed at all. A picture whose URL is refused is not half-rendered: it falls
+     * back to the file chip, which still names the file.
      *
      * `blob:` is added because it is the shape core itself mints — `filesToAttachments`
      * calls `URL.createObjectURL`, and `AparteMessage.attachments` documents the same
@@ -351,27 +395,18 @@ export declare class AparteChatBubble extends HTMLElement {
     /**
      * The branch arrows are handled by DELEGATION, on this element, bound once.
      *
-     * They used to get a fresh listener each, attached by `_render()` to the buttons
-     * `_render()` had just created. So a click that landed while a re-render was
-     * swapping those nodes hit an element about to be discarded, and did nothing at
-     * all — not late, nothing. Invisible on a fast machine; reproducible on
-     * WebKit-Linux in CI, where `‹` left the picker on "2 / 2" and a 20-second
-     * assertion watched it stay there.
-     *
-     * Delegation makes `_render()` irrelevant to it: the listener lives on the host,
-     * which is never replaced, and `closest()` finds whichever button exists at the
-     * moment of the click. It is also less work — one listener per bubble instead of
-     * two per bubble per render.
+     * The listener lives on the host, which is never replaced, and `closest()` finds
+     * whichever button exists at the moment of the click — so a click that lands while
+     * a re-render is swapping the buttons is not lost.
      *
      * Bound in `connectedCallback` and removed in `disconnectedCallback` as a stable
-     * field, because an inline arrow re-added on every re-connect is how this repo has
-     * stacked listeners twice before (the viewport, and `aparte-select`).
+     * field, so a re-connect never stacks listeners.
      */
     private _onBranchPickerClick;
     /**
      * A link the MODEL wrote is about to be followed. Announced as a cancelable event
      * before the browser acts, so a host can route it — an external browser, a
-     * confirmation, an embedded view — without intercepting the DOM (issue #38). With
+     * confirmation, an embedded view — without intercepting the DOM. With
      * no listener the browser follows it, which the sanitizer has already made open in
      * a new tab for an external URL; `preventDefault()` on the event cancels the click.
      *
@@ -409,18 +444,14 @@ export declare class AparteChatBubble extends HTMLElement {
     /**
      * `role="toolbar"` promises a keyboard model. This is it.
      *
-     * The bar has announced itself as a toolbar since it existed, and a toolbar is ONE
-     * tab stop whose members are reached with the arrow keys — that is the whole of what
-     * the role means to a screen-reader user. What shipped was five independent tab
-     * stops per message, so the role described a behaviour that did not exist: a reader
-     * told to press Right heard nothing move, and tabbing through a long transcript
-     * walked every button of every message.
+     * A toolbar is ONE tab stop whose members are reached with the arrow keys — that is
+     * the whole of what the role means to a screen-reader user. Without it, tabbing
+     * through a long transcript would walk every button of every message.
      *
      * The roving index is re-applied from `_syncFooterVisibility`, which is the single
-     * funnel all three build paths already run through (the flag-driven bar, the edit
-     * bar, and the branch picker's own visibility pass). Re-deriving it there rather
-     * than in each builder is what keeps the invariant true after a `setBubbleActions`
-     * rebuild — the drift this pattern usually dies of.
+     * funnel all three build paths run through (the flag-driven bar, the edit bar, and
+     * the branch picker's own visibility pass). Re-deriving it there rather than in each
+     * builder keeps the invariant true after a `setBubbleActions` rebuild.
      *
      * DISABLED buttons are skipped, not merely un-tabbable: while the transcript is busy
      * retry and edit are disabled, and a toolbar whose arrows stop on a dead control
@@ -439,9 +470,9 @@ export declare class AparteChatBubble extends HTMLElement {
      */
     private _onActionBarKeydown;
     /**
-     * An empty action bar is not a bar: with every action off it was still a
-     * `role="toolbar"` with nothing in it (announced as such), and it still reserved
-     * its fixed height plus the footer's under every bubble. So both follow their
+     * An empty action bar is not a bar: with every action off it would be a
+     * `role="toolbar"` with nothing in it (announced as such) that still reserves its
+     * fixed height plus the footer's under every bubble. So both follow their
      * contents — the footer stays as long as the branch picker or the bar has
      * something to show.
      */

package/dist/components/bubble/aparte-chat-bubble.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aparte-chat-bubble.d.ts","sourceRoot":"","sources":["../../../src/components/bubble/aparte-chat-bubble.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aparte-chat-bubble.d.ts","sourceRoot":"","sources":["../../../src/components/bubble/aparte-chat-bubble.ts"],"names":[],"mappings":"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"}

package/dist/components/bubble/bubble-sync.d.ts

@@ -30,7 +30,7 @@ export interface SyncableBubble {
  *
  * Idempotent. Safe to call on every render. Segment count drives the strategy:
  * - same count → reconcile content per segment (cheap, preserves user-toggled
- *   <details> open/closed state on thinking blocks, etc.)
+ *   `<details>` open/closed state on thinking blocks, etc.)
  * - count changed (new segment streamed, branch switched, etc.) → full rebuild
  *   via setSegments
  *

package/dist/components/chat/aparte-chat.d.ts

@@ -78,6 +78,9 @@ import '../elicitation/aparte-elicitation.js';
  *   With or without `center-empty`: the stylesheet centers the composer through
  *   `aparte-chat[center-empty][data-empty]`, and an app styles or scripts its own empty state
  *   against `aparte-chat[data-empty]`. Read-only.
+ * @attr {boolean} data-glide - Reflected BY the element at the first key or pointer in the page, or
+ *   the first send: from then on `center-empty` slides the composer between the welcome and the
+ *   conversation. Before it, a conversation a script restores on load lands in one frame. Read-only.
  * @attr {boolean} overlay-composer - The ChatGPT anatomy, opt-in: the transcript's scroll
  *   surface spans the whole column and the composer (with the rest of the bottom stack)
  *   floats over it, so the scrollbar runs edge to edge instead of stopping at the
@@ -118,6 +121,7 @@ export declare class AparteChat extends HTMLElement {
     static get observedAttributes(): string[];
     private _observer;
     private _loadingObserver;
+    private _offGlide;
     /** Waits for a `<aparte-chat-viewport>` child to appear — see `_watchForViewport`. */
     private _childObserver;
     /** The viewport is loading and the gate is on — see `_applyLoadingGate`. */
@@ -149,11 +153,10 @@ export declare class AparteChat extends HTMLElement {
     /**
      * Watch the viewport so `data-empty` follows the conversation.
      *
-     * It used to run only under `center-empty`, which made the chat's one statement of
-     * "this conversation is empty" a by-product of a layout option: an app that wanted
-     * starters on an empty thread, or a welcome of its own, had to count messages itself.
-     * Every selector core writes against it still requires `[center-empty]`, so reflecting
-     * it everywhere moves no layout.
+     * Runs whether or not `center-empty` is set, so an app that wants starters on an
+     * empty thread, or a welcome of its own, can read `data-empty` instead of counting
+     * messages itself. Every selector core writes against it requires `[center-empty]`,
+     * so reflecting it everywhere moves no layout.
      */
     private _syncEmptyWatch;
     /**
@@ -164,12 +167,11 @@ export declare class AparteChat extends HTMLElement {
      */
     private _syncLoadingWatch;
     /**
-     * Both watches above need a viewport to observe, and they were installed once, at
-     * connect, when there might not be one yet: `<aparte-chat framework-managed>` IS
-     * Angular's host element — upgraded on insert, filled by the template afterwards — and
-     * hand-written markup upgrades before its children are parsed. Neither ever got its
-     * observer, so the documented "every chat gates" was inert on exactly the chats whose
-     * transcript is fetched. This waits for the child to arrive, installs them, and stops.
+     * Both watches above need a viewport to observe, and there might not be one at
+     * connect: `<aparte-chat framework-managed>` IS Angular's host element — upgraded on
+     * insert, filled by the template afterwards — and hand-written markup upgrades before
+     * its children are parsed. This waits for the child to arrive, installs them, and
+     * stops, so every chat gates, including those whose transcript is fetched.
      */
     private _watchForViewport;
     /**
@@ -179,8 +181,8 @@ export declare class AparteChat extends HTMLElement {
     private _applyLoadingGate;
     /**
      * Empty means no message AND none on its way. A viewport that says `loading` holds
-     * no bubble yet, and it used to count as empty: the welcome and the centred composer
-     * showed while a conversation was being fetched.
+     * no bubble yet but does not count as empty, so the welcome and the centred composer
+     * stay hidden while a conversation is being fetched.
      */
     private _updateEmpty;
 }

package/dist/components/chat/aparte-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aparte-chat.d.ts","sourceRoot":"","sources":["../../../src/components/chat/aparte-chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,sCAAsC,CAAC;AAI9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgHG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,sFAAsF;IACtF,OAAO,CAAC,cAAc,CAAiC;IACvD,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAS;IACvB,mFAAmF;IACnF,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAS;IAE3B,iBAAiB,IAAI,IAAI;IAUzB,oBAAoB,IAAI,IAAI;IAS5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAoB9F,6EAA6E;IAC7E,IAAI,QAAQ,IAAI,kBAAkB,GAAG,IAAI,CAExC;IAED,qEAAqE;IACrE,IAAI,QAAQ,IAAI,cAAc,GAAG,IAAI,CAEpC;IAED,OAAO,CAAC,OAAO;IAsDf;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAuBxB,6EAA6E;IAC7E,OAAO,CAAC,YAAY;IAKpB;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAKrB"}
+{"version":3,"file":"aparte-chat.d.ts","sourceRoot":"","sources":["../../../src/components/chat/aparte-chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,sCAAsC,CAAC;AAK9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmHG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,SAAS,CAA6B;IAC9C,sFAAsF;IACtF,OAAO,CAAC,cAAc,CAAiC;IACvD,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAS;IACvB,mFAAmF;IACnF,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAS;IAE3B,iBAAiB,IAAI,IAAI;IAYzB,oBAAoB,IAAI,IAAI;IAW5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAoB9F,6EAA6E;IAC7E,IAAI,QAAQ,IAAI,kBAAkB,GAAG,IAAI,CAExC;IAED,qEAAqE;IACrE,IAAI,QAAQ,IAAI,cAAc,GAAG,IAAI,CAEpC;IAED,OAAO,CAAC,OAAO;IAoDf;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAuBxB,6EAA6E;IAC7E,OAAO,CAAC,YAAY;IAKpB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAKrB"}

package/dist/components/chat/glide-gate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `data-glide` on a centring chat once a person is there: the first key or pointer in the page,
+ * or a send from inside the chat.
+ *
+ * The composer's slide between the welcome state and a conversation reads it (shell.css). A
+ * conversation a script restores on load therefore lands in one frame — sliding it there, before
+ * anyone had touched the page, was a layout shift the reader never caused (CLS 0.14 on a phone).
+ * Every change after that, a send, an opened conversation, a new chat, still glides.
+ *
+ * Returns the teardown. Used by `<aparte-chat>` on itself and by the framework hosts on their root.
+ */
+export declare function gateGlide(el: HTMLElement): () => void;
+//# sourceMappingURL=glide-gate.d.ts.map

package/dist/components/chat/glide-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glide-gate.d.ts","sourceRoot":"","sources":["../../../src/components/chat/glide-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,IAAI,CAgBrD"}

package/dist/components/composer/aparte-composer-action.d.ts

@@ -1,6 +1,6 @@
 import type { AparteComposer } from './aparte-composer.js';
 /**
- * Generic action button primitive for <aparte-composer>.
+ * Generic action button primitive for `<aparte-composer>`.
  *
  * The consumer declares it directly in markup — no global registration needed.
  *
@@ -28,8 +28,8 @@ import type { AparteComposer } from './aparte-composer.js';
  * @element aparte-composer-action
  *
  * @attr {string} icon - Icon key for aparteGlobalConfig.getIcon(), or raw SVG/HTML starting with `<`.
- *   A key core's glyph set does not hold renders AS TEXT (`icon="star"` draws the word
- *   *star*), so bring your own set through `setIconProvider` or pass the SVG.
+ *   A key the icon set does not hold renders AS TEXT (`icon="star"` draws the word
+ *   *star*), so add it with `registerIcons` or pass the SVG.
  * @attr {string} label - Accessible label (also used as tooltip)
  * @attr {boolean} disabled - Disables the button
  * @attr {string} action-id - Identifies WHICH button fired; carried as

package/dist/components/composer/aparte-composer-add-attachment.d.ts

@@ -1,5 +1,5 @@
 /**
- * File picker button for <aparte-composer>.
+ * File picker button for `<aparte-composer>`.
  *
  * Opens a native file picker on click, then pushes picked files to root.addAttachments().
  * Also sets up drag & drop on the nearest <aparte-composer> root.
@@ -8,7 +8,7 @@
  * `<aparte-composer-attachments>` draws the pending strip, and sending is the host's job
  * (`event.detail.files` on `aparte-send`) — which is why the default `<aparte-chat>` shell
  * only includes this button when the `attachments` attribute is set. With nothing reading
- * the files, an attach button is an affordance core cannot honour (ratified decision #8).
+ * the files, an attach button is an affordance core cannot honour.
  *
  * Drag & drop is installed on the composer ROOT, not on this button, so a drop anywhere
  * over the composer attaches and the root carries `aparte-is-dragover` while a drag is

package/dist/components/composer/aparte-composer-cancel.d.ts

@@ -1,5 +1,5 @@
 /**
- * Cancel/stop streaming button primitive for <aparte-composer>.
+ * Cancel/stop streaming button primitive for `<aparte-composer>`.
  *
  * Most composers should not use this element. `<aparte-composer-send>` already becomes
  * the stop button while a reply streams, so adding this one gives you a second, equally

package/dist/components/composer/aparte-composer-input.d.ts

@@ -43,12 +43,13 @@
  *          Inside the `.aparte-composer-row` layout helper the composer's buttons read
  *          the same token, so one value resizes that whole control set and the row stays
  *          aligned.
- * @cssprop [--aparte-input-padding-y=calc((var(--aparte-composer-control-size) - 1lh) / 2)] - Vertical padding inside the editor.
+ * @cssprop [--aparte-input-padding-y=calc((var(--aparte-composer-control-size) - var(--aparte-input-line-height) * 1em) / 2)] - Vertical padding inside the editor: half of what the control size leaves once one line is taken out (`1lh` where the browser has it).
  * @cssprop [--aparte-input-padding-x=var(--aparte-space-6)] - Horizontal padding inside the editor.
  * @cssprop [--aparte-input-font-size=var(--aparte-font-size-base)] - Editor font size.
  * @cssprop [--aparte-input-line-height=var(--aparte-line-height-normal)] - Editor line height — also what the
  *          auto-expand measures, so changing it changes the height the editor settles at
- *          (until `max-height` clamps it).
+ *          (until `max-height` clamps it). Keep it unitless (`1.5`, not `24px`): the editor's
+ *          padding reads it as a multiple of `1em` where the browser has no `lh` unit.
  * @cssprop --aparte-text - Text and caret colour of the editor.
  * @cssprop --aparte-input-placeholder - Colour of the placeholder drawn by
  *          `:empty::before` (falls back to `--aparte-text-muted`).
@@ -75,11 +76,7 @@ export declare class AparteComposerInput extends HTMLElement {
     private _maxHeight;
     private _minHeight;
     /**
-     * Re-measures the editor when its WIDTH changes (#55). The three fixed instants
-     * (connect, next frame, fonts.ready) all miss the same case: a box not yet laid
-     * out — the placeholder wraps in a 0 px column, `scrollHeight` reads ~300 px, and
-     * that became the inline height until the first keystroke. Width is the variable
-     * none of them watched.
+     * Re-measures the editor when its WIDTH changes.
      */
     private _resizeObserver;
     private _unsubscribes;

package/dist/components/composer/aparte-composer-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aparte-composer-input.d.ts","sourceRoot":"","sources":["../../../src/components/composer/aparte-composer-input.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAChD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,UAAU,CAAM;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,aAAa,CAAsB;IAG3C,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAgC;IAEhD,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,iBAAiB,IAAI,IAAI;IA2BzB,oBAAoB,IAAI,IAAI;IAY5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IASvF;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAkBlB,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B,4EAA4E;IAC5E,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACH,eAAe,IAAI,IAAI;IAIvB,oEAAoE;IAC3D,KAAK,IAAI,IAAI;IACtB,mEAAmE;IAC1D,IAAI,IAAI,IAAI;IAErB,2EAA2E;IAC3E,QAAQ,IAAI,IAAI;IAchB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,aAAa;IAmBrB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,eAAe;CAW1B"}
+{"version":3,"file":"aparte-composer-input.d.ts","sourceRoot":"","sources":["../../../src/components/composer/aparte-composer-input.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAChD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,UAAU,CAAM;IACxB;;OAEG;IACH,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,aAAa,CAAsB;IAG3C,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAgC;IAEhD,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,iBAAiB,IAAI,IAAI;IA+BzB,oBAAoB,IAAI,IAAI;IAY5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IASvF;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAkBlB,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B,4EAA4E;IAC5E,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACH,eAAe,IAAI,IAAI;IAIvB,oEAAoE;IAC3D,KAAK,IAAI,IAAI;IACtB,mEAAmE;IAC1D,IAAI,IAAI,IAAI;IAErB,2EAA2E;IAC3E,QAAQ,IAAI,IAAI;IAchB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,aAAa;IAmBrB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,eAAe;CAW1B"}

package/dist/components/composer/aparte-composer-send.d.ts

@@ -1,5 +1,5 @@
 /**
- * Submit button primitive for <aparte-composer>.
+ * Submit button primitive for `<aparte-composer>`.
  *
  * One control, three meanings: **send**, **stop** while the root is streaming, and — when
  * an elicitation panel is open — **submit** the answer; a panel whose mode is `'none'`
@@ -68,9 +68,8 @@ export declare class AparteComposerSend extends HTMLElement {
      *
      * This button has four meanings — send, stop, submit an answer, advance to the
      * next question — and three of them are decided by state it does not own: the
-     * root's `streaming`, and this payload. It was read straight out of the event's
-     * arguments and thrown away, so nothing could recompute the button's chrome
-     * afterwards; a config change had no way to know which of the four to write.
+     * root's `streaming`, and this payload. It is kept so the button's chrome can be
+     * recomputed after the event, for example on a config change.
      */
     private _panel;
     private _onClick;
@@ -91,14 +90,13 @@ export declare class AparteComposerSend extends HTMLElement {
      */
     private _refreshChrome;
     /**
-     * Panel open: this one button now means "submit the answer".
+     * Panel open: this one button means "submit the answer".
      *
-     * The icon has to move with the meaning: it drew a paper plane while the label
-     * already said "Submit", so it read as "send a message" while it meant "answer
-     * this question". It used to draw a chevron too, while a form had questions
-     * ahead, and turn into a "Next" — a second way to do what the panel's chips do,
-     * and a button whose meaning changed under the pointer. It is disabled instead
-     * until every question has an answer, which is what the chips' marks explain.
+     * The icon moves with the meaning: a paper plane would read as "send a message"
+     * while the label says "Submit". The button never turns into a "Next" while a form
+     * has questions ahead (the panel's chips do that, and a button whose meaning
+     * changed under the pointer would be a second way to do it). It is disabled
+     * instead until every question has an answer, which is what the chips' marks explain.
      */
     private _syncPanelState;
     private _handleClick;

package/dist/components/composer/aparte-composer-send.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aparte-composer-send.d.ts","sourceRoot":"","sources":["../../../src/components/composer/aparte-composer-send.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,aAAa,CAAsB;IAC3C;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAA2F;IAGzG,OAAO,CAAC,QAAQ,CAAgC;IAEhD,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IAQ5B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,cAAc;IAgCtB;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,mBAAmB;IAiB3B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;CAGvB"}
+{"version":3,"file":"aparte-composer-send.d.ts","sourceRoot":"","sources":["../../../src/components/composer/aparte-composer-send.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,aAAa,CAAsB;IAC3C;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAA2F;IAGzG,OAAO,CAAC,QAAQ,CAAgC;IAEhD,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IAQ5B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,cAAc;IAgCtB;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,mBAAmB;IAiB3B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;CAGvB"}