@lostgradient/cinder 0.2.0 → 0.3.0

package/dist/components/chat/chat.schema.js

@@ -1,34 +1,4 @@
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toESMCache_node;
-var __toESMCache_esm;
-var __toESM = (mod, isNodeMode, target) => {
-  var canCache = mod != null && typeof mod === "object";
-  if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
-    var cached = cache.get(mod);
-    if (cached)
-      return cached;
-  }
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: __accessProp.bind(mod, key),
-        enumerable: true
-      });
-  if (canCache)
-    cache.set(mod, to);
-  return to;
-};
-var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
   this[name] = __returnValue.bind(null, newValue);
@@ -57,64 +27,123 @@ var schema = {
   type: "object",
   properties: {
     id: {
-      type: "string"
+      type: "string",
+      description: "Unique identifier used to scope accessibility attributes across the chat surface."
     },
     isAtBottom: {
-      type: "boolean"
+      type: "boolean",
+      description: "Whether the message viewport is scrolled to the bottom. Bindable; updated automatically as the user scrolls. Default `true`."
     },
     unreadCount: {
-      type: "number"
+      type: "number",
+      description: "Number of messages received while the viewport was scrolled away from the bottom. Bindable; resets to `0` when the user scrolls to the bottom. Default `0`."
     },
     hasNewMessageIndicator: {
-      type: "boolean"
+      type: "boolean",
+      description: 'Whether the "new messages" indicator is currently visible above the composer. Bindable; cleared automatically when the viewport reaches the bottom. Default `false`.'
     },
     class: {
-      type: "string"
+      type: "string",
+      description: "Additional class name merged onto the `.chat-container` root element."
     },
     surfaceMode: {
-      enum: ["default", "transparent"]
+      enum: ["default", "transparent"],
+      description: "Controls the background of the chat surface. Use `'transparent'` to inherit the host element's background when embedding chat inside a card or panel. Default `'default'`."
+    },
+    density: {
+      enum: ["comfortable", "compact"],
+      description: "Controls spacing density of the message timeline.\n- `'comfortable'` (default): standard padding and gap.\n- `'compact'`: tighter spacing for data-dense contexts (e.g., embedded panels).\n  Action buttons keep `min-height: var(--cinder-touch-target-min)` regardless."
+    },
+    variant: {
+      enum: ["bubble", "flat"],
+      description: "Visual treatment for message bubbles.\n- `'bubble'` (default): colored backgrounds differentiate user from assistant.\n- `'flat'`: no bubble backgrounds; role is communicated via alignment and role label.\n  Text-on-surface contrast meets WCAG AA via `--cinder-text` on `--cinder-surface-inset`."
     },
     bottomThreshold: {
-      type: "number"
+      type: "number",
+      description: 'Distance in pixels from the bottom of the scroll viewport within which the chat is considered "at bottom" and will auto-scroll on new messages. Default `150`.'
     },
     jumpThreshold: {
-      type: "number"
+      type: "number",
+      description: "Distance in pixels scrolled up from the bottom required before the jump-to-latest button appears. Must be greater than `bottomThreshold` to prevent button flickering. Default `200`."
     },
     isStreaming: {
-      type: "boolean"
+      type: "boolean",
+      description: "Whether a streaming response is currently in progress. When `true`, the composer is disabled and a stop-generating button is shown. Default `false`."
     },
     streamingStatus: {
-      type: "string"
+      type: "string",
+      description: 'Optional status label displayed in the typing indicator while `isStreaming` is `true` and no streaming content has arrived yet (e.g. `"Thinking…"` or `"Analyzing file…"`). When omitted, three animated dots are shown.'
     },
     allowAttachments: {
-      type: "boolean"
+      type: "boolean",
+      description: "Whether file attachments are enabled in the composer. When `false`, the attachment button is hidden and drag-and-drop onto the chat surface is suppressed. Default `true`."
     },
     allowSearch: {
-      type: "boolean"
+      type: "boolean",
+      description: "Whether in-conversation search is enabled. When `true`, pressing Ctrl+F / Cmd+F opens a search bar that highlights matching messages. Default `true`."
+    },
+    virtualized: {
+      type: "boolean",
+      description: "Use the virtualized message render path for long transcripts. The complete `ConversationHistory` remains unchanged; only the DOM window is reduced. Default `false`."
+    },
+    virtualizationEstimatedRowHeight: {
+      type: "number",
+      description: "Estimated row height in pixels for virtualized message rows. Default `88`."
+    },
+    virtualizationOverscan: {
+      type: "number",
+      description: "Number of extra virtual rows rendered before and after the viewport. Default `3`."
+    },
+    virtualizationInitialHeight: {
+      type: "number",
+      description: "Initial virtualized viewport height used before measurement. Default `640`."
+    },
+    hasMoreHistory: {
+      type: "boolean",
+      description: 'Whether the explicit "Load earlier messages" trigger is shown when a load handler exists. Default `true`.'
+    },
+    loadEarlierLabel: {
+      type: "string",
+      description: 'Label for the history pagination trigger. Default `"Load earlier messages"`.'
+    },
+    loadingEarlierLabel: {
+      type: "string",
+      description: 'Status text while older messages are loading. Default `"Loading earlier messages"`.'
     },
     allowCopy: {
-      type: "boolean"
+      type: "boolean",
+      description: "Whether per-message copy buttons are shown in the message action bar. Default `true`."
     },
     allowEditing: {
-      type: "boolean"
+      type: "boolean",
+      description: "Whether user messages can be edited inline. Default `true`."
     },
     allowRetry: {
-      type: "boolean"
+      type: "boolean",
+      description: "Whether failed assistant messages show a retry button. Default `true`."
     },
     emptyPrompts: {
       type: "array",
       items: {
         type: "string"
-      }
+      },
+      description: "List of suggested starter prompt strings shown as clickable buttons in the default empty state. Clicking a prompt submits it immediately as a user message. Has no effect when a custom `empty` snippet is provided."
     }
   },
   additionalProperties: false,
   required: ["id"],
   metadata: {
     unsupportedProps: [
+      {
+        name: "adapter",
+        reason: "unknown-shape",
+        description: "Optional command/transport boundary around `conversation`. Its methods take\nprecedence over the matching callback props (e.g. `sendMessage` over\n`onsubmit`); omit it and Chat behaves exactly as with plain callbacks."
+      },
       {
         name: "conversation",
-        reason: "unknown-shape"
+        reason: "unknown-shape",
+        required: true,
+        description: "The conversation transcript to render. Pass a {@link ConversationHistory}\nsnapshot; consumers holding a stateful conversation object pass its current\nsnapshot (e.g. `conversation.current`)."
       },
       {
         name: "empty",
@@ -128,10 +157,47 @@ var schema = {
         name: "messageActions",
         reason: "function-or-snippet"
       },
+      {
+        name: "messagePart",
+        reason: "function-or-snippet",
+        description: `Per-message-part override. Replaces the rendering of an individual body part
+(markdown, tool call, tool result) while delegating the rest to the built-ins
+via the \`renderDefault\` snippet it receives. Image parts are excluded — they
+render through the grouped attachment grid, not this override.`
+      },
+      {
+        name: "messageReasoning",
+        reason: "function-or-snippet",
+        description: "Override or supplement the reasoning text for a message. Called per-message;\nreturn a non-empty string to show a reasoning block, `undefined` to fall back\nto `message.metadata['cinder:reasoning']`, empty string to suppress reasoning."
+      },
       {
         name: "messageStatus",
         reason: "function-or-snippet"
       },
+      {
+        name: "messageSteps",
+        reason: "function-or-snippet",
+        description: "Override or supplement the step list for a message. Called per-message;\nreturn an array to show step indicators, `undefined` to fall back to\n`message.metadata['cinder:steps']`. An empty array suppresses steps."
+      },
+      {
+        name: "messageSuggestions",
+        reason: "function-or-snippet",
+        description: "Override or supplement the suggestion list for a message. Called\nper-message; return an array of label strings to show suggestion chips,\n`undefined` to fall back to `message.metadata['cinder:suggestions']`. An\nempty array suppresses suggestions."
+      },
+      {
+        name: "onadaptererror",
+        reason: "function-or-snippet",
+        description: "Called when an adapter command fails — either a rejected promise or a synchronous throw from the method."
+      },
+      {
+        name: "onapprove",
+        reason: "function-or-snippet",
+        description: `Called when the user approves an action-required tool call. The
+consumer is responsible for updating its transcript (e.g. calling
+conversationalist to unblock the pending tool) and triggering a new
+generation. When an adapter is also wired, Chat calls
+\`adapter.approveToolCall(toolCallId)\` first and then this callback.`
+      },
       {
         name: "onattachmentadd",
         reason: "function-or-snippet"
@@ -144,6 +210,11 @@ var schema = {
         name: "onattachmentremove",
         reason: "function-or-snippet"
       },
+      {
+        name: "ondeny",
+        reason: "function-or-snippet",
+        description: "Called when the user denies an action-required tool call. When an\nadapter is also wired, Chat calls `adapter.denyToolCall(toolCallId)` first\nand then this callback."
+      },
       {
         name: "onedit",
         reason: "function-or-snippet"
@@ -156,6 +227,21 @@ var schema = {
         name: "onjumptolatest",
         reason: "function-or-snippet"
       },
+      {
+        name: "onloadhistory",
+        reason: "function-or-snippet",
+        description: "Called when the explicit history trigger is activated. The consumer prepends compatible messages into `conversation`."
+      },
+      {
+        name: "onpushmessage",
+        reason: "function-or-snippet",
+        description: "Forwarded from the adapter's real-time `onMessage` push (consumer owns the transcript)."
+      },
+      {
+        name: "onreadreceipt",
+        reason: "function-or-snippet",
+        description: "Forwarded from the adapter's real-time `onReadReceipt` push."
+      },
       {
         name: "onretry",
         reason: "function-or-snippet"
@@ -172,10 +258,37 @@ var schema = {
         name: "onsubmit",
         reason: "function-or-snippet"
       },
+      {
+        name: "onsuggestionselect",
+        reason: "function-or-snippet",
+        description: `Called when the user selects a suggestion chip. The label string is
+passed back. The consumer is responsible for submitting it as a new user
+message.`
+      },
+      {
+        name: "ontypingchange",
+        reason: "function-or-snippet",
+        description: "Forwarded from the adapter's real-time `onTypingChange` push."
+      },
       {
         name: "onunreadindicatorchange",
         reason: "function-or-snippet"
       },
+      {
+        name: "readReceipts",
+        reason: "unknown-shape",
+        description: "Per-message read receipt state. Out-of-band UI state — NOT stored on `Message`.\nPass a `Map` keyed by message id with a {@link ReadReceipt} value; the\ncomponent renders a receipt badge on USER messages only. The adapter's\n`onReadReceipt` push handler populates the same state when an adapter is wired.\nDefault `undefined` (no receipts shown)."
+      },
+      {
+        name: "row",
+        reason: "function-or-snippet",
+        description: "Full-row override. Renders an entire message row; receives the message and\na `renderDefault` snippet for the built-in row (inversion of control), so a\nconsumer can wrap or fully replace specific rows."
+      },
+      {
+        name: "typingParticipants",
+        reason: "unknown-shape",
+        description: "Participants who are currently typing. Out-of-band UI state — NOT stored on\n`Message`. Pass an array of {@link TypingParticipant} objects; the component\nrenders a per-participant typing indicator above the input. The adapter's\n`onTypingChange` push handler feeds the same indicator when an adapter is\nwired. Default `undefined` (indicator hidden)."
+      },
       {
         name: "viewportAttachment",
         reason: "function-or-snippet"
@@ -188,4 +301,4 @@ export {
   chat_schema_default as default
 };
 
-//# debugId=CED9E2556F312F7064756E2164756E21
+//# debugId=C009EE21091010A864756E2164756E21

package/dist/components/chat/chat.types.d.ts

@@ -1,11 +1,50 @@
 import type { Snippet } from 'svelte';
 import type { Attachment } from 'svelte/attachments';
 import type { HTMLAttributes } from 'svelte/elements';
+import type { ChatAdapter, ChatAdapterErrorEvent, ChatReadReceiptEvent } from './adapter/chat-adapter.ts';
 import type { ChatScrollStateChangeEvent, ChatStopGeneratingEvent, ChatSubmitEvent, ChatUnreadIndicatorChangeEvent } from './container/chat-events.ts';
 import type { ConversationHistory, Message } from './conversation-model.ts';
 import type { ChatAttachment } from './input/chat-attachment.ts';
+import type { MessagePartOverride } from './message/chat-message-parts.ts';
+import type { StepInfo } from './utilities/types.ts';
+/**
+ * A participant who is currently typing. Out-of-band UI state — NOT stored on
+ * `Message` or `ConversationHistory`. Flows in as a plain (non-bindable) prop or
+ * via the adapter's `onTypingChange` push handler.
+ */
+export type TypingParticipant = {
+    /** Unique identifier for the participant (e.g. user id). */
+    id: string;
+    /** Display name shown in the typing indicator label. */
+    name: string;
+};
+/**
+ * Read-receipt state for a single message. Out-of-band UI state — NOT stored on
+ * `Message`. Flows in as a plain (non-bindable) `readReceipts` prop keyed by
+ * message id, or accumulated from the adapter's `onReadReceipt` push handler.
+ *
+ * Render rules: shown only on `user` messages; color alone never conveys state
+ * (icon + text label always present).
+ */
+export type ReadReceipt = {
+    /** Delivery/read status for this message. */
+    status: 'sent' | 'delivered' | 'read';
+    /**
+     * Names of participants who have read the message. Used to compose the
+     * accessible text (e.g. "Read by Alice, Bob"). May be empty when status is
+     * `sent` or `delivered`.
+     */
+    readBy?: string[];
+};
+/**
+ * Full-row override snippet. Inversion of control: receives the message AND a
+ * `renderDefault` snippet that renders the built-in row, so a consumer can wrap
+ * or replace a row while still delegating to the default when it chooses.
+ */
+export type ChatRowOverride = Snippet<[message: Message, renderDefault: Snippet]>;
 /** Props for the Chat component. */
 export type ChatProps = Omit<HTMLAttributes<HTMLElement>, 'class' | 'onsubmit'> & {
+    /** Unique identifier used to scope accessibility attributes across the chat surface. */
     id: string;
     /**
      * The conversation transcript to render. Pass a {@link ConversationHistory}
@@ -13,32 +52,159 @@ export type ChatProps = Omit<HTMLAttributes<HTMLElement>, 'class' | 'onsubmit'>
      * snapshot (e.g. `conversation.current`).
      */
     conversation: ConversationHistory;
+    /** Whether the message viewport is scrolled to the bottom. Bindable; updated automatically as the user scrolls. Default `true`. */
     isAtBottom?: boolean;
+    /** Number of messages received while the viewport was scrolled away from the bottom. Bindable; resets to `0` when the user scrolls to the bottom. Default `0`. */
     unreadCount?: number;
+    /** Whether the "new messages" indicator is currently visible above the composer. Bindable; cleared automatically when the viewport reaches the bottom. Default `false`. */
     hasNewMessageIndicator?: boolean;
+    /** Additional class name merged onto the `.chat-container` root element. */
     class?: string;
+    /** Controls the background of the chat surface. Use `'transparent'` to inherit the host element's background when embedding chat inside a card or panel. Default `'default'`. */
     surfaceMode?: 'default' | 'transparent';
+    /**
+     * Controls spacing density of the message timeline.
+     * - `'comfortable'` (default): standard padding and gap.
+     * - `'compact'`: tighter spacing for data-dense contexts (e.g., embedded panels).
+     *   Action buttons keep `min-height: var(--cinder-touch-target-min)` regardless.
+     */
+    density?: 'comfortable' | 'compact';
+    /**
+     * Visual treatment for message bubbles.
+     * - `'bubble'` (default): colored backgrounds differentiate user from assistant.
+     * - `'flat'`: no bubble backgrounds; role is communicated via alignment and role label.
+     *   Text-on-surface contrast meets WCAG AA via `--cinder-text` on `--cinder-surface-inset`.
+     */
+    variant?: 'bubble' | 'flat';
+    /** Distance in pixels from the bottom of the scroll viewport within which the chat is considered "at bottom" and will auto-scroll on new messages. Default `150`. */
     bottomThreshold?: number;
+    /** Distance in pixels scrolled up from the bottom required before the jump-to-latest button appears. Must be greater than `bottomThreshold` to prevent button flickering. Default `200`. */
     jumpThreshold?: number;
+    /** Whether a streaming response is currently in progress. When `true`, the composer is disabled and a stop-generating button is shown. Default `false`. */
     isStreaming?: boolean;
+    /** Optional status label displayed in the typing indicator while `isStreaming` is `true` and no streaming content has arrived yet (e.g. `"Thinking…"` or `"Analyzing file…"`). When omitted, three animated dots are shown. */
     streamingStatus?: string;
+    /** Whether file attachments are enabled in the composer. When `false`, the attachment button is hidden and drag-and-drop onto the chat surface is suppressed. Default `true`. */
     allowAttachments?: boolean;
+    /** Whether in-conversation search is enabled. When `true`, pressing Ctrl+F / Cmd+F opens a search bar that highlights matching messages. Default `true`. */
     allowSearch?: boolean;
+    /** Use the virtualized message render path for long transcripts. The complete `ConversationHistory` remains unchanged; only the DOM window is reduced. Default `false`. */
+    virtualized?: boolean;
+    /** Estimated row height in pixels for virtualized message rows. Default `88`. */
+    virtualizationEstimatedRowHeight?: number;
+    /** Number of extra virtual rows rendered before and after the viewport. Default `3`. */
+    virtualizationOverscan?: number;
+    /** Initial virtualized viewport height used before measurement. Default `640`. */
+    virtualizationInitialHeight?: number;
+    /** Whether the explicit "Load earlier messages" trigger is shown when a load handler exists. Default `true`. */
+    hasMoreHistory?: boolean;
+    /** Label for the history pagination trigger. Default `"Load earlier messages"`. */
+    loadEarlierLabel?: string;
+    /** Status text while older messages are loading. Default `"Loading earlier messages"`. */
+    loadingEarlierLabel?: string;
+    /** Whether per-message copy buttons are shown in the message action bar. Default `true`. */
     allowCopy?: boolean;
+    /** Whether user messages can be edited inline. Default `true`. */
     allowEditing?: boolean;
+    /** Whether failed assistant messages show a retry button. Default `true`. */
     allowRetry?: boolean;
     header?: Snippet;
     empty?: Snippet;
+    /** List of suggested starter prompt strings shown as clickable buttons in the default empty state. Clicking a prompt submits it immediately as a user message. Has no effect when a custom `empty` snippet is provided. */
     emptyPrompts?: string[];
     messageActions?: Snippet<[Message]>;
     messageStatus?: Snippet<[Message]>;
+    /**
+     * Full-row override. Renders an entire message row; receives the message and
+     * a `renderDefault` snippet for the built-in row (inversion of control), so a
+     * consumer can wrap or fully replace specific rows.
+     */
+    row?: ChatRowOverride;
+    /**
+     * Per-message-part override. Replaces the rendering of an individual body part
+     * (markdown, tool call, tool result) while delegating the rest to the built-ins
+     * via the `renderDefault` snippet it receives. Image parts are excluded — they
+     * render through the grouped attachment grid, not this override.
+     */
+    messagePart?: MessagePartOverride;
     viewportAttachment?: Attachment<HTMLElement>;
+    /**
+     * Participants who are currently typing. Out-of-band UI state — NOT stored on
+     * `Message`. Pass an array of {@link TypingParticipant} objects; the component
+     * renders a per-participant typing indicator above the input. The adapter's
+     * `onTypingChange` push handler feeds the same indicator when an adapter is
+     * wired. Default `undefined` (indicator hidden).
+     */
+    typingParticipants?: TypingParticipant[];
+    /**
+     * Per-message read receipt state. Out-of-band UI state — NOT stored on `Message`.
+     * Pass a `Map` keyed by message id with a {@link ReadReceipt} value; the
+     * component renders a receipt badge on USER messages only. The adapter's
+     * `onReadReceipt` push handler populates the same state when an adapter is wired.
+     * Default `undefined` (no receipts shown).
+     */
+    readReceipts?: Map<string, ReadReceipt>;
+    /**
+     * Optional command/transport boundary around `conversation`. Its methods take
+     * precedence over the matching callback props (e.g. `sendMessage` over
+     * `onsubmit`); omit it and Chat behaves exactly as with plain callbacks.
+     */
+    adapter?: ChatAdapter;
+    /** Called when an adapter command fails — either a rejected promise or a synchronous throw from the method. */
+    onadaptererror?: (event: ChatAdapterErrorEvent) => void;
+    /** Forwarded from the adapter's real-time `onMessage` push (consumer owns the transcript). */
+    onpushmessage?: (message: Message) => void;
+    /** Forwarded from the adapter's real-time `onTypingChange` push. */
+    ontypingchange?: (isTyping: boolean) => void;
+    /** Forwarded from the adapter's real-time `onReadReceipt` push. */
+    onreadreceipt?: (event: ChatReadReceiptEvent) => void;
     onsubmit?: (event: ChatSubmitEvent) => void;
     onretry?: (messageId: string) => void;
     onedit?: (event: {
         messageId: string;
         content: string;
     }) => void;
+    /**
+     * Called when the user approves an action-required tool call. The
+     * consumer is responsible for updating its transcript (e.g. calling
+     * conversationalist to unblock the pending tool) and triggering a new
+     * generation. When an adapter is also wired, Chat calls
+     * `adapter.approveToolCall(toolCallId)` first and then this callback.
+     */
+    onapprove?: (toolCallId: string) => void;
+    /**
+     * Called when the user denies an action-required tool call. When an
+     * adapter is also wired, Chat calls `adapter.denyToolCall(toolCallId)` first
+     * and then this callback.
+     */
+    ondeny?: (toolCallId: string) => void;
+    /**
+     * Override or supplement the reasoning text for a message. Called per-message;
+     * return a non-empty string to show a reasoning block, `undefined` to fall back
+     * to `message.metadata['cinder:reasoning']`, empty string to suppress reasoning.
+     */
+    messageReasoning?: (message: Message) => string | undefined;
+    /**
+     * Override or supplement the step list for a message. Called per-message;
+     * return an array to show step indicators, `undefined` to fall back to
+     * `message.metadata['cinder:steps']`. An empty array suppresses steps.
+     */
+    messageSteps?: (message: Message) => StepInfo[] | undefined;
+    /**
+     * Override or supplement the suggestion list for a message. Called
+     * per-message; return an array of label strings to show suggestion chips,
+     * `undefined` to fall back to `message.metadata['cinder:suggestions']`. An
+     * empty array suppresses suggestions.
+     */
+    messageSuggestions?: (message: Message) => string[] | undefined;
+    /**
+     * Called when the user selects a suggestion chip. The label string is
+     * passed back. The consumer is responsible for submitting it as a new user
+     * message.
+     */
+    onsuggestionselect?: (label: string) => void;
+    /** Called when the explicit history trigger is activated. The consumer prepends compatible messages into `conversation`. */
+    onloadhistory?: () => void | Promise<void>;
     onstopgenerating?: (event: ChatStopGeneratingEvent) => void;
     onjumptolatest?: () => void;
     onscrollstatechange?: (event: ChatScrollStateChangeEvent) => void;

package/dist/components/chat/chat.variables.js

@@ -1,34 +1,4 @@
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toESMCache_node;
-var __toESMCache_esm;
-var __toESM = (mod, isNodeMode, target) => {
-  var canCache = mod != null && typeof mod === "object";
-  if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
-    var cached = cache.get(mod);
-    if (cached)
-      return cached;
-  }
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: __accessProp.bind(mod, key),
-        enumerable: true
-      });
-  if (canCache)
-    cache.set(mod, to);
-  return to;
-};
-var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
   this[name] = __returnValue.bind(null, newValue);
@@ -58,4 +28,4 @@ export {
   chat_variables_default as default
 };
 
-//# debugId=3F716B6A999EA50E64756E2164756E21
+//# debugId=F0BDFF3E2333E5CC64756E2164756E21

package/dist/components/chat/container/chat-history-trigger.svelte.d.ts

@@ -0,0 +1,15 @@
+export type ChatHistoryTriggerProps = {
+    /** Whether the history request is in flight. */
+    loading?: boolean;
+    /** Button label while idle. */
+    label?: string;
+    /** Button label while loading. */
+    loadingLabel?: string;
+    /** Called when the user requests older messages. */
+    onload?: () => void;
+};
+declare const ChatHistoryTrigger: import("svelte").Component<ChatHistoryTriggerProps, {
+    focus: (options?: FocusOptions) => void;
+}, "">;
+type ChatHistoryTrigger = ReturnType<typeof ChatHistoryTrigger>;
+export default ChatHistoryTrigger;

package/dist/components/chat/container/chat-participant-typing.svelte.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-participant typing indicator for the Chat component.
+ *
+ * A single always-in-DOM outer `<div>` wrapper sits above the bottom sentinel in
+ * the message timeline. Its text is empty when nobody is typing (the outer wrapper
+ * is never removed from the DOM). The inner `.chat-participant-typing-indicator`
+ * div mounts/unmounts via `{#if isActive}` — this is intentional so the
+ * entrance animation replays on each new typing event.
+ *
+ * The aria-live announcement region is NOT emitted by this component. It lives in
+ * chat.svelte as a sibling of `ChatStatusAnnouncer`, outside the `role="log"` div,
+ * to prevent double-announcement from nested live regions. This component handles
+ * the visual rendering only.
+ *
+ * Accessibility:
+ *   - The outer wrapper is `aria-hidden="true"` — AT users receive the typing
+ *     announcement from the dedicated live region in the container.
+ *   - data-cinder-participant-typing set when participantCount > 0.
+ *   - data-cinder-participant-count reflects the exact count.
+ *
+ * Reduced motion: switches the entrance animation to an opacity fade.
+ */
+export type ChatParticipantTypingProps = {
+    /** The visible typing label (e.g. "Alice is typing…"). Empty string when nobody is typing. */
+    typingLabel: string;
+    /** Total number of currently-typing participants. */
+    participantCount: number;
+};
+declare const ChatParticipantTyping: import("svelte").Component<ChatParticipantTypingProps, {}, "">;
+type ChatParticipantTyping = ReturnType<typeof ChatParticipantTyping>;
+export default ChatParticipantTyping;

package/dist/components/chat/container/chat-status-announcer.svelte.d.ts

@@ -3,7 +3,8 @@
  *
  * Provides:
  * - A status region showing message count
- * - A live region for announcing new messages
+ * - A polite live region for announcing new messages
+ * - An assertive live region for urgent action-required announcements
  */
 export type ChatStatusAnnouncerProps = {
     /** ID for the status element (used by aria-describedby) */
@@ -12,6 +13,8 @@ export type ChatStatusAnnouncerProps = {
     messageCount: number;
     /** Current screen reader announcement message */
     announcerMessage: string;
+    /** Urgent announcement for assertive live region (tool approval, etc.) */
+    assertiveMessage?: string;
 };
 declare const ChatStatusAnnouncer: import("svelte").Component<ChatStatusAnnouncerProps, {}, "">;
 type ChatStatusAnnouncer = ReturnType<typeof ChatStatusAnnouncer>;