@neuronection/assistant-ui 0.52.0 → 0.53.0

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # @neuronection/assistant-ui
 
+## 0.53.0
+
+### Minor Changes
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Message states (plan 100 S3):** `ChatMessage` state changes now animate instead of snapping.
+
+  - **Entrance:** every message bubble rises 4px + fades in on mount (`--as-duration-base`, mount-only — stream re-renders never restart it).
+  - **Copy feedback:** new `actions.copied` prop (controlled) plus an uncontrolled default — the copy action morphs into a success check for 1.5 s after each copy click, with the `aria-label` following ("Copy" → "Copied", new `labels.copied`, default "Copied").
+  - **Interrupted:** the "Stopped" chip slides in with a single amber pulse (`--as-warning`); **error** cards slide up into place.
+  - **Action row:** the hover/focus reveal is now owned by `tokens.css` (`data-as="chat-message-actions"`, opacity + 2px rise, `--as-duration-fast`, reduced-motion safe) instead of Tailwind `group-hover` classes — TW3 app CSS can never collide with it. Keyboard reachability is unchanged.
+  - **Edit mode:** `ChatMessageEditor` reveals with a slide-up and autofocuses its textarea (previously no focus on mount).
+  - **Variant switch:** content crossfades (`--as-duration-fast`) when `variants.index` changes on a branched message — automatic, no new props.
+
+  Consumers: nothing to wire for entrance/error/interrupted/variant animations; copy feedback works uncontrolled out of the box.
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Surfaces (plan 100 S6):** the three surface hosts get their final motion pass, plus the chat welcome kit.
+
+  - **New `ChatWelcome`** (`@neuronection/assistant-ui/chat-welcome`) — the chat empty-state kit: a breathing `--as-ai` identity orb (default `Sparkles` icon, overridable node), greeting + subtitle, and a staggered suggestion container (children enter 40 ms apart). Densities `page | sidebar | bubble` via `data-variant`. Non-interactive by itself — suggestion controls are app markup. Intended as `ChatTranscript emptyState`.
+  - **`ChatLauncher`:** the panel now springs in from the launcher corner (`--as-ease-spring`, bottom transform-origin), the launcher icon ↔ close icon morph on toggle (never on first mount), and the unread badge pulses once on every value change.
+  - **`ChatDrawer`:** the slide-in re-curved onto the spring token (`--as-duration-spring` / `--as-ease-spring`).
+  - **`ChatPanel`:** the `banner` strip slides up in when it appears.
+  - **`as-anim-pulse-once` rework:** the one-shot attention pulse is now a box-shadow ripple (position-independent) instead of a `::after` overlay — safe on absolutely-positioned hosts like badges; visual behavior on existing consumers (interrupted chip) unchanged.
+
+  Everything is disabled under `prefers-reduced-motion: reduce` (motion contract test enforced).
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **In-chat search (plan 101 P2):** find anything in the conversation without leaving the transcript.
+
+  - **`ChatTranscript search`** prop (`{ query, onQueryChange }`): renders the new **`ChatSearchField`** above the log — a labelled query input with an `n/N` match readout and prev/next controls. Enter jumps to the next match, Shift+Enter to the previous, Escape clears. The active match scrolls into view with a one-shot flash (`data-search-flash`, reduced-motion safe).
+  - **`MarkdownSurface query`** prop: case-insensitive matches wrap in `<mark data-as="chat-search-match">` (warning-tinted) via a hand-rolled hast walker — no new dependency, zero cost when no query is set.
+  - Custom `renderItem` receives the active query as its fourth argument; transcript rows now carry `data-message-id` for anchor queries.
+  - `ChatSearchField` is exported from the `chat-transcript` module (and the root) for standalone composition; new transcript labels: `search`, `searchPlaceholder`, `previousMatch`, `nextMatch`, `clearSearch`, `matches`.
+
+  Jump-scrolling requires a non-virtualized transcript (documented); virtualized transcripts highlight visible rows only.
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Motion foundation (plan 100 S1 / ADR-012):** a CSS-first motion system in `tokens.css` — `--as-duration-fast/base/slow/spring` (120/180/280/420ms) and `--as-ease-out/standard/spring` tokens, plus guarded utilities `.as-anim-message-in`, `.as-anim-slide-up`, `.as-anim-fade-swap`, `.as-anim-check-draw`, `.as-anim-pulse-once`, `.as-anim-shimmer`, `.as-anim-breathe` and the `.as-collapse` grid height-reveal (collapsed content leaves the a11y tree + tab order after the transition). Every animation/transition rule in `tokens.css` — including the pre-existing `as-anim-fade/modal/pop/drawer`, which were previously unguarded — is now disabled under `prefers-reduced-motion: reduce`, enforced by a static CSS contract test. Existing entrance timings re-tuned onto the tokens (±30ms, no behavior change). Apps can re-pace the whole family by remapping the tokens in `theme.css` — documented in `docs/theming.md` § Motion tokens. No runtime animation dependency was added (deliberate — see ADR-012).
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Streaming choreography (plan 100 S2):** the live turn now reads as one continuous animation instead of abrupt swaps.
+
+  - **New `ChatPending`** (`@neuronection/assistant-ui/chat-pending`) — the first-token latency placeholder: a narrated phase row (`ChatTurnStatus`: dots + elapsed timer) over an assistant-aligned shimmer bubble tinted with the `--as-ai` accent. Render it as the transcript's `live` tail between send and the first delta (`label`, `startedAt`, `lines`, `children` props).
+  - **`MarkdownSurface`:** `streaming` now renders a pulsing `--as-ai` caret at the tail of the last block (static but visible under reduced motion) — the "still generating" signal after the pending handoff.
+  - **`ChatReasoning`:** `--as-ai` edge while streaming; expand/collapse animates through the `.as-collapse` height reveal; new `autoCollapse` prop (default `true`, uncontrolled mode only) folds the block when `streaming` turns true → false — a controlled `open` is never auto-collapsed, and a block that never streamed never folds.
+  - **`ChatToolCard`:** `--as-ai` edge while running; the running → done transition crossfades into a stroke-drawn check; args/result panes reveal through the animated collapse (collapsed panes are `visibility: hidden` — out of the a11y tree and tab order, so screen-reader behavior matches the old conditional render).
+  - **`ChatTurnStatus`:** phase-label changes crossfade (`--as-duration-fast`).
+
+  All effects are compositor-only, mount-keyed (stream re-renders never restart them), and disabled under `prefers-reduced-motion: reduce` with state staying legible. Consumers: compose `ChatPending` into the `live` tail per `docs/guides/chat-surfaces.md`; everything else is automatic on the next dependency bump.
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Transcript modernization (plan 100 S5):** `ChatTranscript` + `ChatMessage` gain the modern layout option and navigation polish.
+
+  - **Flat design:** `design="flat"` on `ChatTranscript` (feeds the default renderer) or `ChatMessage` — assistant content renders as prose on the panel surface while the user keeps its bubble; `data-design` styling hook for apps. Default stays `bubbles` — opt-in, zero migration.
+  - **Consecutive-message grouping:** `groupConsecutive` tightens spacing between same-role runs and tags rows `data-group-pos` (`single | start | mid | end`, system rows always `single`); `renderItem` now receives the position as a third argument (render group-start avatars only).
+  - **Avatar slot:** optional `ChatMessage avatar` node — leading for assistants, trailing for users (`data-as="chat-message-avatar"`).
+  - **Unread jump pill:** assistant replies that land while the user is scrolled away are counted; the pill label reads "Scroll to latest — N new messages" (new `labels.newMessages`), shows a `9+` badge chip beyond nine, and resets on return-to-bottom or pill click. The pill slides up in instead of teleporting.
+  - **Depth + chrome:** top fade mask while scrolled into the thread (`data-fade-top`) and thin themed scrollbars (`--as-scrollbar-thumb`/`--as-scrollbar-track` tokens, progressive enhancement).
+  - **Fix:** the jump pill no longer positions with a translate utility (TW3 double-apply hazard) — margin-centering, identical geometry.
+
+  Consumers: everything is opt-in (`design`, `groupConsecutive`, `avatar`); the unread pill and scroll polish are automatic on the next dependency bump.
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Composer intelligence (plan 101 P1):** `ChatComposer` gains the three interaction features modern chat inputs have.
+
+  - **Slash commands / @-mentions:** new `commands` prop — `{ trigger? ('/' default), items, maxItems?, onSelect }`. The palette opens while the caret touches a trigger-started word (caret-aware, works mid-sentence), fuzzy-filters via `searchScore`, and is fully keyboard-driven: ArrowUp/Down move, Enter/Tab select — never submitting while open — Escape dismisses. `onSelect(id, token)` receives the draft span (`start/end/query`) so the app performs the insertion. A11y: `role="listbox"`/`option` + `aria-controls`, `aria-autocomplete="list"`, `aria-activedescendant` on the textarea.
+  - **Escape to stop:** pressing Escape while a turn is in flight now fires `onStop` (after the palette-dismiss Escape, when both apply).
+  - **Prompt recall:** new `history` prop — ArrowUp on an empty draft recalls the last sent prompt, ArrowUp/Down walk the stack, editing a recalled draft exits it.
+
+  New `labels.commands` (listbox name, default "Commands"). Existing behavior (IME guard, canSubmit, drag-drop, multiline hysteresis) unchanged — all 24 composer tests green incl. the new palette/history/keyboard cases.
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Media & list polish (plan 101 P4):**
+
+  - **Image lightbox:** `MarkdownSurface lightbox` — markdown images become labelled zoom buttons opening the library `Modal` (Escape closes, Radix focus handling). Aimed at health's medical images and study screenshots; inert images remain the default.
+  - **Inline session rename:** `ChatSessionList onRenameCommit(id, title)` — the rename action edits the title in place (autofocused input, Enter/blur commits, Escape cancels, keystrokes never select the row). Dialog-based `onRename` flows are unchanged.
+  - **Session rows stagger in** (30 ms steps, `as-slide-up`, reduced-motion safe) via the new `data-as="chat-session-rows"` hook.
+  - **New `ChatSuggestionCard`** (`@neuronection/assistant-ui/chat-suggestion-card`) — the standard suggestion chip for `ChatWelcome suggestions` and composer strips: icon + title + hint, real labelled button, hover lift via border/shadow (no transform utilities — TW3-safe).
+
+  New labels: `MarkdownSurface` `zoomImage`/`closeImage`, `ChatSessionList` `renameInput`.
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Transcript context (plan 101 P3):** orientation anchors inside long conversations.
+
+  - **Date separators:** `showDateSeparators` on `ChatTranscript` renders Today/Yesterday/date chips between day groups, read from `ChatMessageView.createdAt` (rows without one join the previous group). `formatDate` overrides the older-day format (default `MMM d, yyyy`); new labels `today` / `yesterday`.
+  - **Message anchoring:** `focusMessageId` scrolls the row into view and flashes it whenever it changes — wire branch-tree node clicks, citation links or deep links to it. Rows carry `data-message-id`.
+  - **Floating stop:** `onStop` on `ChatTranscript` renders a stop pill beside the jump pill while a live turn streams and the user has scrolled away (labelled, keyboard-reachable, `labels.stop`).
+
+  All opt-in; no behavior change for existing consumers.
+
+- [#78](https://github.com/neuronection/assistant-ui/pull/78) [`7fb0f6e`](https://github.com/neuronection/assistant-ui/commit/7fb0f6ea2cb2fdec737a68e4379b917bf20ea79a) Thanks [@constLiakos](https://github.com/constLiakos)! - **Composer micro-interactions (plan 100 S4):** `ChatComposer` state changes now animate.
+
+  - **Send ↔ Stop morph:** the swap rotates through (−90° + fade in, `--as-duration-fast`) — only on state change, never on first mount, so pages don't animate on load. Buttons, labels and focus behavior unchanged.
+  - **Focus glow:** the input row's `:focus-within` affordance is now CSS-owned and token-timed (accent border + 3px primary glow ring) instead of Tailwind `focus-within:` classes — TW3 app CSS can never collide.
+  - **Drag-over pulse:** while files drag over the composer (`data-dragging`), a 1.4s primary drop-zone pulse runs under the existing dashed border styling.
+  - **Rails slide in:** the `attachments` and `suggestions` slot wrappers rise + fade on mount (`as-anim-slide-up`).
+
+  All of it is disabled under `prefers-reduced-motion: reduce` (enforced by the motion contract test). No API changes.
+
 ## 0.52.0
 
 ### Minor Changes

package/README.md

@@ -94,7 +94,10 @@ Visual reference: [gallery](https://neuronection.github.io/assistant-ui/).
 | [`ai-button`](./docs/components/ai-button.md) / [`ai-actions-dropdown`](./docs/components/ai-actions-dropdown.md) / [`ai-magic-fill`](./docs/components/ai-magic-fill.md) | AI affordances: ask-with-suggestions (controlled open, icon-only mode) · action menu + custom prompt · describe-in-words fill modal — API calls stay app-side | [stories](https://neuronection.github.io/assistant-ui/?story=ai-patterns--ai-buttons) |
 | [`chat-core`](./docs/components/chat-core.md) | `useChatStream` (transport-injected live-turn state machine), `liveTurnReducer`, `ChatMessageView`, family `ChatStreamEvent` vocabulary, branch-tree utils (`buildBranchTree`, `walkActivePath`, `variantInfo`) | [stories](https://neuronection.github.io/assistant-ui/?story=chat-core--chat-core-story) |
 | [`chat-markdown`](./docs/components/chat-markdown.md) | `MarkdownSurface` (read-only streaming markdown: GFM + KaTeX + lazy mermaid + copyable code blocks; no raw HTML) · `MarkdownCodeBlock` · `MermaidDiagram` | [stories](https://neuronection.github.io/assistant-ui/?story=chat-markdown--default) |
-| [`chat-message`](./docs/components/chat-message.md) / [`chat-reasoning`](./docs/components/chat-reasoning.md) / [`chat-tool-card`](./docs/components/chat-tool-card.md) / [`chat-turn-status`](./docs/components/chat-turn-status.md) | `ChatMessage` (bubble: actions row, variant switcher, edit-and-resend, error/interrupted states) · `ChatReasoning` (collapsible thinking block) · `ChatToolCard` (tool observation: status, duration, args/result, app-provided result views via `renderResult`) · `ChatTurnStatus` (live pre-text turn status: dots, phase label, elapsed timer) | [stories](https://neuronection.github.io/assistant-ui/?story=chat-message--assistant) |
+| [`chat-message`](./docs/components/chat-message.md) / [`chat-reasoning`](./docs/components/chat-reasoning.md) / [`chat-tool-card`](./docs/components/chat-tool-card.md) / [`chat-turn-status`](./docs/components/chat-turn-status.md) | `ChatMessage` (bubble: actions row, variant switcher, edit-and-resend, error/interrupted states) · `ChatReasoning` (collapsible thinking block: animated reveal, streaming accent, auto-collapse) · `ChatToolCard` (tool observation: status, duration, args/result, app-provided result views via `renderResult`) · `ChatTurnStatus` (live pre-text turn status: dots, phase label, elapsed timer) | [stories](https://neuronection.github.io/assistant-ui/?story=chat-message--assistant) |
+| [`chat-pending`](./docs/components/chat-pending.md) | `ChatPending` — first-token latency placeholder: narrated phase row (`ChatTurnStatus`) over an AI-accented shimmer bubble for the transcript's `live` tail | [stories](https://neuronection.github.io/assistant-ui/?story=chat-pending--default) |
+| [`chat-welcome`](./docs/components/chat-welcome.md) | `ChatWelcome` — chat empty-state kit: breathing `--as-ai` orb, greeting + subtitle, staggered suggestion slots (`page` / `sidebar` / `bubble` densities) | [stories](https://neuronection.github.io/assistant-ui/?story=chat-welcome--default) |
+| [`chat-suggestion-card`](./docs/components/chat-suggestion-card.md) | `ChatSuggestionCard` — the standard suggestion chip for welcome screens and composer strips: icon + title + hint, hover lift | [stories](https://neuronection.github.io/assistant-ui/?story=chat-welcome--default) |
 | [`chat-hitl`](./docs/components/chat-hitl.md) | `HitlProposalCard` / `FieldDiff` — human-in-the-loop proposal cards: field-level before/after diffs (long text via TextDiffView, structured collection chips), approve/reject with armed destructive confirm, preview slot, pending/approved/rejected/conflict/expired/reverted states | [stories](https://neuronection.github.io/assistant-ui/) |
 | [`chat-composer`](./docs/components/chat-composer.md) | `ChatComposer` — auto-growing IME-safe input with send/stop states, toolbar/attachment/suggestion slots, drag-drop + paste wiring, `data-multiline` row styling hook | [stories](https://neuronection.github.io/assistant-ui/?story=chat-composer--default) |
 | [`chat-transcript`](./docs/components/chat-transcript.md) / [`chat-branch-tree`](./docs/components/chat-branch-tree.md) / [`chat-session-list`](./docs/components/chat-session-list.md) | `ChatTranscript` (log semantics, polite announcements, stick-to-bottom + jump pill, optional virtualization) · `ChatBranchTree` (OpenWebUI-style branch rail, keyboard tree nav) · `ChatSessionList` (fuzzy search, date groups, row actions) | [stories](https://neuronection.github.io/assistant-ui/?story=chat-surfaces--transcript) |

package/dist/chat-branch-tree.d.ts

@@ -1,7 +1,20 @@
 import * as React from 'react';
 import { LucideIcon } from 'lucide-react';
-import { B as BranchTree } from './tree-4Hv9stjF.js';
-import './types-LhE1KFBf.js';
+import { C as ChatRole } from './types-pivJdPC8.js';
+
+interface BranchNode {
+    id: string;
+    role: ChatRole;
+    excerpt?: string;
+    parentId: string | null;
+    activeChildId: string | null;
+    /** In insertion (sibling-order) order; the last entry is the newest sibling. */
+    childIds: string[];
+}
+interface BranchTree {
+    activeRootId: string | null;
+    nodes: Record<string, BranchNode>;
+}
 
 interface ChatBranchTreeIcons {
     user: LucideIcon;

package/dist/chat-composer.d.ts

@@ -7,28 +7,66 @@ interface ChatComposerLabels {
     placeholder: string;
     ariaLabel: string;
     dropFiles: string;
+    commands: string;
 }
 interface ChatComposerIcons {
     send: LucideIcon;
     stop: LucideIcon;
 }
+interface ChatComposerCommand {
+    id: string;
+    label: string;
+    hint?: string;
+    icon?: LucideIcon;
+}
+interface ChatComposerCommandToken {
+    /** Draft offsets of the `trigger + query` token to replace on select. */
+    start: number;
+    end: number;
+    /** Text typed after the trigger character. */
+    query: string;
+}
+interface ChatComposerCommands {
+    /** Palette trigger character — `/` for slash commands, `@` for mentions. Default `/`. */
+    trigger?: string;
+    items: ChatComposerCommand[];
+    /** Max visible entries. Default 8. */
+    maxItems?: number;
+    /**
+     * Fired when a command is selected (Enter/Tab/click). The app owns the
+     * draft edit: replace `value.slice(token.start, token.end)` with the
+     * insertion of its choice.
+     */
+    onSelect: (id: string, token: ChatComposerCommandToken) => void;
+}
 interface ChatComposerProps {
     value: string;
     onValueChange: (value: string) => void;
     /** Enter / Send — IME-safe (composition and keyCode 229 are ignored). */
     onSubmit: () => void;
-    /** A turn is in flight — renders the stop control when `onStop` is provided. */
+    /** A turn is in flight — renders the stop control when `onStop` is provided. Escape stops too. */
     sending?: boolean;
     onStop?: () => void;
     disabled?: boolean;
     /**
      * Overrides the send button's blank-text guard. Apps that allow
-     * attachment-only submits (health's image-only "what's this?" turn) pass
+     * attachment-only submits (health's image-only "what's what?" turn) pass
      * `true` while ready attachments exist; pass `false` to force-disable.
      * Default: the button enables only when `value.trim() !== ''`. The
      * Enter/form path is unaffected — the app's `onSubmit` stays the guard.
      */
     canSubmit?: boolean;
+    /**
+     * Slash-command / mention palette: opens while the caret touches a
+     * `trigger`-started word; ArrowUp/Down move, Enter/Tab select (never
+     * submit while open), Escape dismisses. Fuzzy-filtered via `searchScore`.
+     */
+    commands?: ChatComposerCommands;
+    /**
+     * Previously sent prompts (oldest → newest). ArrowUp on an empty draft
+     * recalls the last one; ArrowDown walks back toward the empty draft.
+     */
+    history?: string[];
     placeholder?: string;
     ariaLabel?: string;
     /** Auto-grow cap before the textarea scrolls. Default 8. */
@@ -51,7 +89,9 @@ interface ChatComposerProps {
 /**
  * The family chat input: auto-growing IME-safe textarea, send/stop
  * states, attachment/dictation/toolbar slots, drag-drop + paste file
- * wiring. Presentational + controlled; transports stay app-side.
+ * wiring, a slash-command/mention palette (`commands`), Escape-to-stop
+ * and ArrowUp prompt recall (`history`). Presentational + controlled;
+ * transports stay app-side.
  */
 declare const ChatComposer: React.ForwardRefExoticComponent<ChatComposerProps & React.RefAttributes<HTMLFormElement>>;
 

package/dist/chat-composer.js

@@ -1,3 +1,3 @@
-export { ChatComposer } from './chunk-YQQZMWHL.js';
+export { ChatComposer } from './chunk-P3QUNCBR.js';
 //# sourceMappingURL=chat-composer.js.map
 //# sourceMappingURL=chat-composer.js.map

package/dist/chat-core.d.ts

@@ -1,6 +1,5 @@
-import { C as ChatError } from './types-LhE1KFBf.js';
-export { a as ChatAttachmentView, b as ChatMessageStatus, c as ChatMessageVariants, d as ChatMessageView, e as ChatRole } from './types-LhE1KFBf.js';
-export { a as BranchNode, b as BranchNodeInput, B as BranchTree, c as activePathSet, d as buildBranchTree, l as linearTree, v as variantInfo, w as walkActivePath } from './tree-4Hv9stjF.js';
+import { C as ChatError, a as ChatRole } from './types-CxieoN2u.js';
+export { b as ChatAttachmentView, c as ChatMessageStatus, d as ChatMessageVariants, e as ChatMessageView } from './types-CxieoN2u.js';
 
 interface FlowStepInfo {
     id: string;
@@ -127,6 +126,57 @@ declare const initialLiveTurnState: LiveTurnState;
  */
 declare function liveTurnReducer(state: LiveTurnState, action: LiveTurnAction): LiveTurnState;
 
+interface BranchNode {
+    id: string;
+    role: ChatRole;
+    excerpt?: string;
+    parentId: string | null;
+    activeChildId: string | null;
+    /** In insertion (sibling-order) order; the last entry is the newest sibling. */
+    childIds: string[];
+}
+interface BranchTree {
+    activeRootId: string | null;
+    nodes: Record<string, BranchNode>;
+}
+type BranchNodeInput = Omit<BranchNode, 'childIds'>;
+/**
+ * Index the server's branch-tree projection (family contract: the read-only
+ * `GET …/tree` shape) and compute child lists. Insertion order defines
+ * sibling order — the last child is the newest variant (fallback when a
+ * parent has no `activeChildId`).
+ */
+declare function buildBranchTree(input: {
+    activeRootId?: string | null;
+    nodes: BranchNodeInput[];
+}): BranchTree;
+/**
+ * Degenerate single-path tree from a visible (already active-path) message
+ * list — for apps/backends without branching yet. Every message parents to
+ * the previous one; the tree renders identically to a branched one.
+ */
+declare function linearTree(items: {
+    id: string;
+    role: ChatRole;
+    excerpt?: string;
+}[]): BranchTree;
+/**
+ * The visible conversation: pointer walk from the active root, following
+ * each node's `activeChildId` (fallback: newest sibling). Cycle-safe.
+ */
+declare function walkActivePath(tree: BranchTree): string[];
+declare function activePathSet(tree: BranchTree): Set<string>;
+/**
+ * Sibling variant info for the inline `‹ n/N ›` switcher: the 1-based index
+ * of `nodeId` among its siblings (roots are siblings of each other) and the
+ * ordered sibling ids.
+ */
+declare function variantInfo(tree: BranchTree, nodeId: string): {
+    index: number;
+    count: number;
+    siblingIds: string[];
+};
+
 interface ChatStreamTransport {
     /** Enqueue/send a user turn. Resolves when accepted; errors surface as a failed turn. */
     send(input: {
@@ -163,4 +213,4 @@ interface UseChatStreamResult extends LiveTurnState {
  */
 declare function useChatStream(options: UseChatStreamOptions): UseChatStreamResult;
 
-export { ChatError, type ChatStreamEvent, type ChatStreamTransport, type FlowStepInfo, type LiveNodeState, type LiveToolCall, type LiveTurnAction, type LiveTurnState, type LiveTurnStatus, type UseChatStreamOptions, type UseChatStreamResult, initialLiveTurnState, liveTurnReducer, useChatStream };
+export { type BranchNode, type BranchNodeInput, type BranchTree, ChatError, ChatRole, type ChatStreamEvent, type ChatStreamTransport, type FlowStepInfo, type LiveNodeState, type LiveToolCall, type LiveTurnAction, type LiveTurnState, type LiveTurnStatus, type UseChatStreamOptions, type UseChatStreamResult, activePathSet, buildBranchTree, initialLiveTurnState, linearTree, liveTurnReducer, useChatStream, variantInfo, walkActivePath };

package/dist/chat-launcher.js

@@ -1,3 +1,3 @@
-export { ChatLauncher } from './chunk-E3NZM4U7.js';
+export { ChatLauncher } from './chunk-GO4ILLS6.js';
 //# sourceMappingURL=chat-launcher.js.map
 //# sourceMappingURL=chat-launcher.js.map

package/dist/chat-markdown.d.ts

@@ -26,6 +26,10 @@ interface MarkdownSurfaceProps {
     value: string;
     /** Live turn: defers mermaid to the final render (streaming floods break diagrams). */
     streaming?: boolean;
+    /** Search highlight: case-insensitive matches wrap in `<mark data-as="chat-search-match">`. */
+    query?: string;
+    /** Click-to-zoom images in a modal (health's medical images, study screenshots). Default false. */
+    lightbox?: boolean;
     gfm?: boolean;
     math?: boolean;
     /** Render ```mermaid fences as diagrams (forced off while `streaming`). */
@@ -35,7 +39,10 @@ interface MarkdownSurfaceProps {
     components?: MarkdownComponents;
     urlTransform?: UrlTransform;
     showCodeLanguage?: boolean;
-    labels?: Partial<MarkdownCodeBlockLabels>;
+    labels?: Partial<MarkdownCodeBlockLabels & {
+        zoomImage: string;
+        closeImage: string;
+    }>;
     className?: string;
 }
 /**

package/dist/chat-markdown.js

@@ -1,3 +1,3 @@
-export { MarkdownCodeBlock, MarkdownSurface, MermaidDiagram } from './chunk-HQ3X5SVR.js';
+export { MarkdownCodeBlock, MarkdownSurface, MermaidDiagram } from './chunk-KQLKITZL.js';
 //# sourceMappingURL=chat-markdown.js.map
 //# sourceMappingURL=chat-markdown.js.map

package/dist/chat-message.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { LucideIcon } from 'lucide-react';
-import { c as ChatMessageVariants, e as ChatRole, C as ChatError } from './types-LhE1KFBf.js';
+import { a as ChatMessageVariants, C as ChatRole, b as ChatError } from './types-pivJdPC8.js';
 
 interface ChatMessageEditorLabels {
     save: string;
@@ -52,6 +52,12 @@ interface ChatMessageAction {
 }
 interface ChatMessageActions {
     onCopy?: () => void;
+    /**
+     * Controlled copied feedback for the copy action (check morph).
+     * Uncontrolled by default: the library shows the check for 1.5 s
+     * after each copy click.
+     */
+    copied?: boolean;
     onEdit?: () => void;
     onRegenerate?: () => void;
     onRetry?: () => void;
@@ -66,6 +72,7 @@ interface ChatMessageActions {
 }
 interface ChatMessageLabels {
     copy: string;
+    copied: string;
     edit: string;
     regenerate: string;
     retry: string;
@@ -99,6 +106,14 @@ interface ChatMessageProps {
     chips?: React.ReactNode;
     /** Attachment rail above the content. */
     attachments?: React.ReactNode;
+    /** Leading identity node beside the bubble (user: trailing). Render group-start avatars only when grouping transcripts. */
+    avatar?: React.ReactNode;
+    /**
+     * Visual design: `bubbles` (default) — paired role bubbles; `flat` —
+     * assistant content renders as prose on the panel surface (user keeps
+     * its bubble). Reasoning/tool cards are unaffected.
+     */
+    design?: 'bubbles' | 'flat';
     labels?: Partial<ChatMessageLabels & ChatMessageEditorLabels & MessageVariantSwitcherLabels>;
     compact?: boolean;
     className?: string;

package/dist/chat-message.js

@@ -1,3 +1,3 @@
-export { ChatMessage, ChatMessageEditor, MessageVariantSwitcher } from './chunk-C5JZCCU7.js';
+export { ChatMessage, ChatMessageEditor, MessageVariantSwitcher } from './chunk-NOAKHVBJ.js';
 //# sourceMappingURL=chat-message.js.map
 //# sourceMappingURL=chat-message.js.map

package/dist/chat-panel.js

@@ -1,3 +1,3 @@
-export { ChatPanel } from './chunk-SEZZVAGP.js';
+export { ChatPanel } from './chunk-SR4IN564.js';
 //# sourceMappingURL=chat-panel.js.map
 //# sourceMappingURL=chat-panel.js.map

package/dist/chat-pending.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+
+interface ChatPendingProps {
+    /**
+     * Phase label narrated while the first token is awaited, e.g.
+     * "thinking" — usually the live turn's current node label.
+     */
+    label?: string;
+    /** Turn start timestamp (ms) — enables the elapsed timer. */
+    startedAt?: number;
+    /** Placeholder line count. Default 2 (capped at 6). */
+    lines?: number;
+    /** Extra node under the placeholder (model badge, app hints). */
+    children?: React.ReactNode;
+    className?: string;
+}
+/**
+ * The first-token latency placeholder (plan 100 S2): narrated phase row
+ * (dots + elapsed timer via `ChatTurnStatus`) over an assistant-aligned
+ * shimmer placeholder tinted with the `--as-ai` accent. Render it as the
+ * transcript's `live` tail between send and the first delta.
+ */
+declare const ChatPending: React.ForwardRefExoticComponent<ChatPendingProps & React.RefAttributes<HTMLDivElement>>;
+
+export { ChatPending, type ChatPendingProps };

package/dist/chat-pending.js

@@ -0,0 +1,3 @@
+export { ChatPending } from './chunk-F4BTJQLK.js';
+//# sourceMappingURL=chat-pending.js.map
+//# sourceMappingURL=chat-pending.js.map

package/dist/chat-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chat-pending.js"}

package/dist/chat-reasoning.d.ts

@@ -8,11 +8,17 @@ interface ChatReasoningLabels {
 interface ChatReasoningProps {
     /** Accumulated reasoning text (family `delta kind="reasoning"`). */
     text: string;
-    /** Live reasoning stream — spinner + streaming label while on. */
+    /** Live reasoning stream — spinner + streaming label + `--as-ai` edge while on. */
     streaming?: boolean;
     open?: boolean;
     defaultOpen?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * Collapse the block when a live stream finishes (`streaming`
+     * true → false). Uncontrolled mode only — a controlled `open` stays
+     * app-driven. Default true.
+     */
+    autoCollapse?: boolean;
     labels?: Partial<ChatReasoningLabels>;
     icon?: LucideIcon;
     className?: string;
@@ -20,7 +26,9 @@ interface ChatReasoningProps {
 /**
  * Collapsible thinking block for reasoning models (study's
  * `ReasoningBubble`, family-standard): streams live while the model
- * reasons, collapses to a summary row when done. Controlled-first.
+ * reasons (AI-accent edge + spinner), collapses to a summary row when
+ * done — with a height reveal, and auto-collapse on the streaming →
+ * done transition in uncontrolled mode. Controlled-first.
  */
 declare const ChatReasoning: React.ForwardRefExoticComponent<ChatReasoningProps & React.RefAttributes<HTMLDivElement>>;
 

package/dist/chat-reasoning.js

@@ -1,3 +1,3 @@
-export { ChatReasoning } from './chunk-S63SYV6O.js';
+export { ChatReasoning } from './chunk-INXQJM2K.js';
 //# sourceMappingURL=chat-reasoning.js.map
 //# sourceMappingURL=chat-reasoning.js.map

package/dist/chat-session-list.d.ts

@@ -12,6 +12,7 @@ interface ChatSessionListLabels {
     searchPlaceholder: string;
     newChat: string;
     rename: string;
+    renameInput: string;
     delete: string;
     export: string;
     today: string;
@@ -32,6 +33,12 @@ interface ChatSessionListProps {
     onSelect: (id: string) => void;
     onNew?: () => void;
     onRename?: (id: string) => void;
+    /**
+     * Inline rename: when provided, the rename action edits the title in
+     * place (Enter/blur commits, Escape cancels) instead of invoking
+     * `onRename` — keep `onRename` for dialog-based flows only.
+     */
+    onRenameCommit?: (id: string, title: string) => void;
     onDelete?: (id: string) => void;
     onExport?: (id: string) => void;
     searchable?: boolean;

package/dist/chat-session-list.js

@@ -1,3 +1,3 @@
-export { ChatSessionList } from './chunk-PC3CE4W2.js';
+export { ChatSessionList } from './chunk-22MIIWC7.js';
 //# sourceMappingURL=chat-session-list.js.map
 //# sourceMappingURL=chat-session-list.js.map

package/dist/chat-suggestion-card.d.ts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import { LucideIcon } from 'lucide-react';
+
+interface ChatSuggestionCardProps extends React.ComponentProps<'button'> {
+    /** Leading icon (defaults to none — pass `Sparkles`, `BookOpen`, …). */
+    icon?: LucideIcon;
+    /** Trailing hint text, e.g. "5 min". */
+    hint?: string;
+    children: React.ReactNode;
+}
+/**
+ * The family suggestion card (plan 101 P4): the standard action chip for
+ * `ChatWelcome suggestions` and composer suggestion strips — left-aligned
+ * icon + title + hint with a lift-on-hover affordance (border + shadow,
+ * no transform utilities: TW3-safe).
+ */
+declare const ChatSuggestionCard: React.ForwardRefExoticComponent<Omit<ChatSuggestionCardProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+
+export { ChatSuggestionCard, type ChatSuggestionCardProps };

package/dist/chat-suggestion-card.js

@@ -0,0 +1,3 @@
+export { ChatSuggestionCard } from './chunk-PABMR4RA.js';
+//# sourceMappingURL=chat-suggestion-card.js.map
+//# sourceMappingURL=chat-suggestion-card.js.map

package/dist/chat-suggestion-card.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chat-suggestion-card.js"}

package/dist/chat-tool-card.js

@@ -1,3 +1,3 @@
-export { ChatToolCard } from './chunk-5BJ4VULP.js';
+export { ChatToolCard } from './chunk-EQPXM2R4.js';
 //# sourceMappingURL=chat-tool-card.js.map
 //# sourceMappingURL=chat-tool-card.js.map