@urbicon-ui/blocks 6.35.0 → 6.36.0

package/dist/components/Chat/ToolCallCard/ToolCallCard.svelte

@@ -0,0 +1,174 @@
+<script lang="ts">
+  import { untrack } from 'svelte';
+  import { Badge, Collapsible } from '../../../primitives';
+  import { getBlocksConfig, resolveSlotClasses } from '../../../provider';
+  import { resolveIcon } from '../../../icons';
+  import ChevronDownIconDefault from '../../../icons/ChevronDownIcon.svelte';
+  import CoreSpinner from '../../../internal/core/CoreSpinner.svelte';
+  import CodeBlock from '../CodeBlock/CodeBlock.svelte';
+  import { toolCallCardVariants } from './tool-call-card.variants';
+  import type { ToolCallCardProps } from './index';
+
+  const ChevronDownIcon = resolveIcon('chevronDown', ChevronDownIconDefault);
+
+  let {
+    toolCall,
+    open = $bindable(),
+    defaultOpen,
+    onOpenChange,
+    children,
+    pendingLabel = 'Pending',
+    runningLabel = 'Running',
+    completeLabel = 'Done',
+    errorLabel = 'Failed',
+    inputLabel = 'Input',
+    outputLabel = 'Output',
+    class: className,
+    unstyled: unstyledProp = false,
+    slotClasses: slotClassesProp = {},
+    preset,
+    ...restProps
+  }: ToolCallCardProps = $props();
+
+  const blocksConfig = getBlocksConfig();
+  const unstyled = $derived(unstyledProp || blocksConfig?.unstyled || false);
+
+  // Forward arbitrary root attributes onto the underlying Collapsible without
+  // re-deriving its (very wide) props union: spreading the typed `HTMLDivElement`
+  // rest here makes svelte-check try to reconcile HTMLAttributes' nullable
+  // `title` against Collapsible's narrowed one and blows the union-complexity
+  // budget. A plain record spread carries the attributes through cleanly.
+  const rootProps = $derived(restProps as Record<string, unknown>);
+
+  const styles = toolCallCardVariants();
+  const slotClasses = $derived(
+    resolveSlotClasses(blocksConfig, 'ToolCallCard', preset, {}, slotClassesProp)
+  );
+
+  function cls(name: keyof typeof slotClasses, extra?: string | (string | undefined)[]) {
+    const extras = Array.isArray(extra) ? extra : [extra];
+    if (unstyled) {
+      return [slotClasses?.[name], ...extras].filter(Boolean).join(' ');
+    }
+    const slotFns = styles as Record<string, (args: { class?: unknown }) => string>;
+    return slotFns[name]({ class: [slotClasses?.[name], ...extras] });
+  }
+
+  // Uncontrolled seed: expanded by default only for an already-failed call.
+  // svelte-ignore state_referenced_locally
+  let internalOpen = $state(defaultOpen ?? toolCall.state === 'error');
+  const isOpen = $derived(open !== undefined ? open : internalOpen);
+
+  // Tracks whether the user has toggled the card. Once they have, auto-open is
+  // disabled — a manual choice always wins.
+  let userToggled = $state(false);
+
+  function toggle() {
+    userToggled = true;
+    const next = !isOpen;
+    if (open !== undefined) {
+      open = next;
+    } else {
+      internalOpen = next;
+    }
+    onOpenChange?.(next);
+  }
+
+  // Auto-open on a GENUINE transition to `error` while mounted — unless the
+  // user has toggled. A call that is already failed at mount is covered by the
+  // seed above (so an explicit defaultOpen={false} wins there), and the open
+  // runs through the same notification path as a manual toggle so a
+  // controlled-without-bind consumer can mirror it (review findings, P3 wave).
+  // svelte-ignore state_referenced_locally
+  let prevState = toolCall.state;
+  $effect(() => {
+    const state = toolCall.state;
+    const wasError = prevState === 'error';
+    prevState = state;
+    if (state !== 'error' || wasError) return;
+    untrack(() => {
+      if (userToggled || isOpen) return;
+      if (open !== undefined) open = true;
+      else internalOpen = true;
+      onOpenChange?.(true);
+    });
+  });
+
+  const statusLabel = $derived(
+    {
+      pending: pendingLabel,
+      running: runningLabel,
+      complete: completeLabel,
+      error: errorLabel
+    }[toolCall.state]
+  );
+
+  const badgeIntent = $derived(
+    toolCall.state === 'complete' ? 'success' : toolCall.state === 'error' ? 'danger' : 'neutral'
+  );
+
+  const isBusy = $derived(toolCall.state === 'pending' || toolCall.state === 'running');
+
+  // JSON.stringify can throw on circular structures, or return `undefined` for
+  // a non-serializable value (function, symbol) — fall back to String() so the
+  // CodeBlock always receives a string.
+  function stringify(value: unknown): string {
+    try {
+      const json = JSON.stringify(value, null, 2);
+      return json ?? String(value);
+    } catch {
+      return String(value);
+    }
+  }
+</script>
+
+<Collapsible variant="card" size="sm" open={isOpen} class={className} {...rootProps}>
+  {#snippet trigger({ triggerId, contentId })}
+    <button
+      id={triggerId}
+      type="button"
+      class={cls('trigger')}
+      aria-expanded={isOpen}
+      aria-controls={contentId}
+      onclick={toggle}
+    >
+      <span class={cls('triggerLeft')}>
+        {#if isBusy}
+          <span aria-hidden="true" class="inline-flex">
+            <CoreSpinner size="xs" class={cls('spinner')} />
+          </span>
+        {/if}
+        <!-- CoreSpinner and Badge carry no ARIA (the badge is aria-hidden chrome),
+             so this sr-only line is the single textual status for assistive tech. -->
+        <span class="sr-only">{statusLabel}</span>
+        <span class={cls('toolName')}>{toolCall.name}</span>
+      </span>
+      <span class={cls('triggerRight')}>
+        <Badge intent={badgeIntent} variant="soft" aria-hidden="true">{statusLabel}</Badge>
+        <ChevronDownIcon class={cls('chevron', isOpen ? 'rotate-180' : undefined)} />
+      </span>
+    </button>
+  {/snippet}
+
+  {#if children}
+    {@render children(toolCall)}
+  {:else}
+    <div class={cls('body')}>
+      {#if toolCall.errorMessage}
+        <p class={cls('errorMessage')}>{toolCall.errorMessage}</p>
+      {/if}
+      {#if toolCall.input !== undefined}
+        <div class={cls('section')}>
+          <span class={cls('sectionLabel')}>{inputLabel}</span>
+          <CodeBlock lang="json" code={stringify(toolCall.input)} />
+        </div>
+      {/if}
+      {#if toolCall.output !== undefined}
+        <div class={cls('section')}>
+          <span class={cls('sectionLabel')}>{outputLabel}</span>
+          <CodeBlock lang="json" code={stringify(toolCall.output)} />
+        </div>
+      {/if}
+    </div>
+  {/if}
+</Collapsible>

package/dist/components/Chat/ToolCallCard/ToolCallCard.svelte.d.ts

@@ -0,0 +1,4 @@
+import type { ToolCallCardProps } from './index.js';
+declare const ToolCallCard: import("svelte").Component<ToolCallCardProps, {}, "open">;
+type ToolCallCard = ReturnType<typeof ToolCallCard>;
+export default ToolCallCard;

package/dist/components/Chat/ToolCallCard/index.d.ts

@@ -0,0 +1,84 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+import type { ChatToolCallPart } from '../chat.types.js';
+import type { ToolCallCardSlots } from './tool-call-card.variants.js';
+/**
+ * @description Collapsible card that renders one agent tool-call part (`type: 'tool-call'`)
+ * — a status indicator + monospaced tool name in the header, and the JSON input/output (or an
+ * error message) in the expandable body. It is the default renderer ChatMessage reaches for on
+ * `tool-call` parts (wire it in via `partRenderers`). Opens itself when a call fails so the error
+ * is visible without a click; a manual toggle always wins afterwards. Pass a `children` snippet to
+ * replace the default JSON body with a domain-specific view of the same part.
+ * @tag ai
+ * @related ChatMessage
+ * @related ReasoningDisclosure
+ * @related CodeBlock
+ * @stability experimental
+ *
+ * @example
+ * ```svelte
+ * <ToolCallCard toolCall={part} />
+ * ```
+ *
+ * @example Domain-specific body via the children snippet
+ * ```svelte
+ * <ToolCallCard {toolCall}>
+ *   {#snippet children(call)}
+ *     <WeatherResult data={call.output} />
+ *   {/snippet}
+ * </ToolCallCard>
+ * ```
+ */
+export interface ToolCallCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'class' | 'children'> {
+    /** The tool-call part to render. Required. */
+    toolCall: ChatToolCallPart;
+    /**
+     * Whether the card is expanded. Supports `bind:open`. Left uncontrolled, the
+     * card starts collapsed for `pending` / `running` / `complete` and expanded
+     * for `error`.
+     */
+    open?: boolean;
+    /**
+     * Initial expanded state for uncontrolled usage. Defaults to `true` when the
+     * call is already in the `error` state, `false` otherwise.
+     */
+    defaultOpen?: boolean;
+    /** Fired once per toggle, after the new open state is applied. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Replace the default JSON input/output body with a custom rendering of the
+     * tool-call part. Receives the same `toolCall`. When provided, the built-in
+     * error line + input/output sections are not rendered.
+     */
+    children?: Snippet<[ChatToolCallPart]>;
+    /** Header badge label for the `pending` state. @default 'Pending' */
+    pendingLabel?: string;
+    /** Header badge label for the `running` state. @default 'Running' */
+    runningLabel?: string;
+    /** Header badge label for the `complete` state. @default 'Done' */
+    completeLabel?: string;
+    /** Header badge label for the `error` state. @default 'Failed' */
+    errorLabel?: string;
+    /** Heading above the input code block. @default 'Input' */
+    inputLabel?: string;
+    /** Heading above the output code block. @default 'Output' */
+    outputLabel?: string;
+    /** Extra classes merged onto the root card element. */
+    class?: string;
+    /** Strip the component's default tv() classes (the underlying Collapsible card chrome is kept). */
+    unstyled?: boolean;
+    /**
+     * Per-slot class overrides. Slots: `trigger` (header button), `triggerLeft`,
+     * `triggerRight`, `spinner`, `toolName`, `chevron`, `body`, `section`,
+     * `sectionLabel`, `errorMessage`.
+     */
+    slotClasses?: Partial<Record<ToolCallCardSlots, string>>;
+    /**
+     * Apply a named preset registered via `<BlocksProvider presets={{ ToolCallCard: {...} }}>`.
+     * Prefer this over `class` overrides when the requested look falls outside the
+     * semantic intent palette.
+     */
+    preset?: string;
+}
+export { default as ToolCallCard } from './ToolCallCard.svelte';
+export { type ToolCallCardSlots, type ToolCallCardVariants, toolCallCardVariants } from './tool-call-card.variants.js';

package/dist/components/Chat/ToolCallCard/index.js

@@ -0,0 +1,2 @@
+export { default as ToolCallCard } from './ToolCallCard.svelte';
+export { toolCallCardVariants } from './tool-call-card.variants.js';

package/dist/components/Chat/ToolCallCard/tool-call-card.variants.d.ts

@@ -0,0 +1,38 @@
+import { type SlotNames, type VariantProps } from '../../../utils/variants.js';
+export declare const toolCallCardVariants: ((props?: {} | undefined) => {
+    trigger: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    triggerLeft: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    triggerRight: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    spinner: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    toolName: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    chevron: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    body: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    section: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    sectionLabel: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+    errorMessage: (props?: ({} & {
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
+    }) | undefined) => string;
+}) & {
+    readonly config: import("../../../utils/variants.js").TVConfig;
+};
+export type ToolCallCardVariants = VariantProps<typeof toolCallCardVariants>;
+/** Slot names derived from the tv() config — single source of truth for slotClasses. */
+export type ToolCallCardSlots = SlotNames<typeof toolCallCardVariants>;

package/dist/components/Chat/ToolCallCard/tool-call-card.variants.js

@@ -0,0 +1,38 @@
+import { tv } from '../../../utils/variants.js';
+export const toolCallCardVariants = tv({
+    slots: {
+        // The whole card header IS the collapsible trigger button. Collapsible's
+        // card variant only styles the DEFAULT trigger; a custom trigger snippet
+        // replaces it, so the horizontal padding / focus ring live here.
+        trigger: [
+            'flex w-full items-center justify-between gap-2 px-4 py-2 text-left cursor-pointer',
+            'text-text-primary',
+            'transition-colors duration-[var(--blocks-duration-fast)] ease-out',
+            'hover:bg-surface-hover',
+            'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/50 focus-visible:rounded-sm',
+            'disabled:opacity-50 disabled:cursor-not-allowed'
+        ],
+        // Status indicator + tool name; min-w-0 lets the mono name truncate.
+        triggerLeft: 'flex items-center gap-2 min-w-0',
+        // Status badge + chevron; never shrinks so the name gives way first.
+        triggerRight: 'flex items-center gap-2 shrink-0',
+        // Inline busy indicator (CoreSpinner wrapper) — tertiary tint via text-current.
+        spinner: 'text-text-tertiary shrink-0',
+        // The invoked tool's identifier, monospaced.
+        toolName: 'font-mono text-sm text-text-secondary truncate',
+        // Chevron mirrors Collapsible's own spin timing so both animate in sync.
+        chevron: [
+            'shrink-0 w-4 h-4 text-text-tertiary',
+            'transition-transform duration-[var(--blocks-collapse-duration)] ease-[var(--blocks-collapse-easing)]',
+            'motion-reduce:duration-[1ms]'
+        ],
+        // Default body wrapper (input/output sections + error line).
+        body: 'flex flex-col gap-3',
+        // One labelled block (heading + CodeBlock).
+        section: 'flex flex-col gap-1',
+        // Small tertiary heading above each code block.
+        sectionLabel: 'text-xs font-medium text-text-tertiary',
+        // Error message line shown above the sections.
+        errorMessage: 'text-sm text-danger'
+    }
+});

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

@@ -0,0 +1,82 @@
+import type { CitationSource } from './CitationChip/index.js';
+/** Author of a chat message. */
+export type ChatRole = 'user' | 'assistant' | 'system';
+/**
+ * Lifecycle of a message. `streaming` drives the live-rendering affordances
+ * (markdown tail repair, cursor, deferred screen-reader announcement);
+ * `error` / `aborted` switch the message to its failure presentation.
+ * A message without a status counts as `complete`.
+ */
+export type ChatMessageStatus = 'streaming' | 'complete' | 'error' | 'aborted';
+/**
+ * One renderable segment of a message. Mirrors the shape of modern
+ * model/tool transcripts: interleaved text, reasoning, tool calls, sources
+ * and attachments — rendered in order by the ChatMessage component.
+ */
+export type ChatMessagePart = 
+/** Markdown text, rendered through StreamingMarkdown. */
+{
+    type: 'text';
+    text: string;
+}
+/** Model reasoning. Collapsed, tertiary presentation; `durationMs` feeds the "Thought for Xs" label. */
+ | {
+    type: 'reasoning';
+    text: string;
+    durationMs?: number;
+}
+/** A tool invocation with its lifecycle state. Rendered as a ToolCallCard by default; override via `partRenderers`. */
+ | {
+    type: 'tool-call';
+    id: string;
+    name: string;
+    state: 'pending' | 'running' | 'complete' | 'error';
+    input?: unknown;
+    output?: unknown;
+    errorMessage?: string;
+}
+/** A cited source. Same shape as CitationSource — also feeds StreamingMarkdown's `sources` for `[id]` markers. */
+ | ({
+    type: 'source';
+} & CitationSource)
+/**
+ * A file attached to the message. `url` is only ever rendered as a
+ * policy-checked download link (never as an inline image/iframe) — LLM- or
+ * server-supplied URLs are untrusted input.
+ */
+ | {
+    type: 'attachment';
+    name: string;
+    mimeType: string;
+    size?: number;
+    url?: string;
+}
+/** Declarative A2UI payload (P4). Validated fail-loud by A2UIView; ignored by default renderers until then. */
+ | {
+    type: 'a2ui';
+    payload: unknown;
+};
+/** The `tool-call` member of {@link ChatMessagePart} — the prop shape of ToolCallCard. */
+export type ChatToolCallPart = Extract<ChatMessagePart, {
+    type: 'tool-call';
+}>;
+/** The `reasoning` member of {@link ChatMessagePart} — the prop shape of ReasoningDisclosure. */
+export type ChatReasoningPart = Extract<ChatMessagePart, {
+    type: 'reasoning';
+}>;
+/**
+ * One message in a conversation. Named `ChatMessageData` because the value
+ * export `ChatMessage` is the component that renders it.
+ */
+export interface ChatMessageData {
+    /** Stable unique id — keyed `{#each}` identity, never an array index. */
+    id: string;
+    role: ChatRole;
+    /** Ordered renderable segments. A plain text answer is `[{ type: 'text', text }]`. */
+    parts: ChatMessagePart[];
+    createdAt?: Date;
+    /** Omitted counts as `complete`. */
+    status?: ChatMessageStatus;
+    /** Consumer-defined extras (model name, token counts, …). Not rendered by defaults. */
+    metadata?: Record<string, unknown>;
+}

package/dist/components/Chat/chat.types.js

@@ -0,0 +1,7 @@
+// Chat conversation data model — the contract between a consumer's transport
+// layer (SSE/fetch/websocket) and the Chat family's rendering components.
+//
+// Deliberately NOT a store: the consumer owns `ChatMessageData[]` (typically
+// `$state` + appends from a stream) and passes it down. Components never
+// mutate messages.
+export {};

package/dist/components/Chat/index.d.ts

@@ -0,0 +1,22 @@
+export type { ChatProps } from './Chat/index.js';
+export * from './Chat/index.js';
+export type { ChatMessageProps, ChatPartRenderers } from './ChatMessage/index.js';
+export * from './ChatMessage/index.js';
+export type { ChatMessageListItemContext, ChatMessageListProps } from './ChatMessageList/index.js';
+export * from './ChatMessageList/index.js';
+export type { CitationChipProps, CitationSource } from './CitationChip/index.js';
+export * from './CitationChip/index.js';
+export type { CodeBlockProps } from './CodeBlock/index.js';
+export * from './CodeBlock/index.js';
+export type { ChatMessageData, ChatMessagePart, ChatMessageStatus, ChatReasoningPart, ChatRole, ChatToolCallPart } from './chat.types.js';
+export { createIncrementalParser, parseMarkdown } from './markdown/blocks.js';
+export { repairMarkdownTail } from './markdown/repair.js';
+export type { BlockNode, IncrementalMarkdownParser, InlineNode, MarkdownBlock, MarkdownDocument, MarkdownParseOptions, MarkdownUrlPolicy } from './markdown/types.js';
+export type { PromptInputProps } from './PromptInput/index.js';
+export * from './PromptInput/index.js';
+export type { ReasoningDisclosureProps } from './ReasoningDisclosure/index.js';
+export * from './ReasoningDisclosure/index.js';
+export type { MarkdownRenderers, StreamingMarkdownProps } from './StreamingMarkdown/index.js';
+export * from './StreamingMarkdown/index.js';
+export type { ToolCallCardProps } from './ToolCallCard/index.js';
+export * from './ToolCallCard/index.js';

package/dist/components/Chat/index.js

@@ -0,0 +1,14 @@
+// Chat family barrel — AI-kit surfaces (conversation, composer, streaming
+// markdown, code display, citations) plus the public pieces of the markdown
+// engine underneath them.
+export * from './Chat/index.js';
+export * from './ChatMessage/index.js';
+export * from './ChatMessageList/index.js';
+export * from './CitationChip/index.js';
+export * from './CodeBlock/index.js';
+export { createIncrementalParser, parseMarkdown } from './markdown/blocks.js';
+export { repairMarkdownTail } from './markdown/repair.js';
+export * from './PromptInput/index.js';
+export * from './ReasoningDisclosure/index.js';
+export * from './StreamingMarkdown/index.js';
+export * from './ToolCallCard/index.js';

package/dist/components/Chat/markdown/blocks.d.ts

@@ -0,0 +1,54 @@
+import type { IncrementalMarkdownParser, MarkdownDocument, MarkdownParseOptions } from './types.js';
+type RawBlock = {
+    type: 'paragraph';
+    start: number;
+    lines: string[];
+} | {
+    type: 'heading';
+    start: number;
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    text: string;
+} | {
+    type: 'fence';
+    start: number;
+    lang?: string;
+    code: string[];
+    open: boolean;
+} | {
+    type: 'list';
+    start: number;
+    ordered: boolean;
+    startNumber?: number;
+    lines: string[];
+} | {
+    type: 'quote';
+    start: number;
+    lines: string[];
+} | {
+    type: 'table';
+    start: number;
+    header: string;
+    delimiter: string;
+    rows: string[];
+} | {
+    type: 'hr';
+    start: number;
+};
+interface ScanResult {
+    blocks: RawBlock[];
+    refs: Map<string, {
+        href: string;
+        title?: string;
+    }>;
+    /**
+     * Label of a reference definition sitting on the final, not-yet-terminated
+     * line — its URL may still be streaming in. Such a definition is used for
+     * display (one-shot parity if the stream really ends here) but never for
+     * settling, and it does not count as "arrived" for invalidation purposes.
+     */
+    unstableRefLabel?: string;
+}
+export declare function scanBlocks(text: string): ScanResult;
+export declare function parseMarkdown(text: string, options?: MarkdownParseOptions): MarkdownDocument;
+export declare function createIncrementalParser(options?: MarkdownParseOptions): IncrementalMarkdownParser;
+export {};