@deepseek-ai/dsh-client-ui-primitives 0.1.1-rc.2 → 0.1.2-alpha.2

package/lib/markdown/CodeBlock.module.css

@@ -4,7 +4,9 @@
 .block {
   --dsl-code-block-banner-background-color: var(--dsw-alias-markdown-code-block-banner);
   --dsl-code-block-border-radius: 12px;
-  --dsl-code-block-banner-font: var(--dsw-font-xs-13);
+  /* Local 11/18 instead of the shared --dsw-font-xs-13: the banner scales
+     with the markdown 0.875 ladder without shrinking every other xs-13 use. */
+  --dsl-code-block-banner-font: 11px/18px var(--dsw-font-family);
   --dsl-code-block-content-font: var(--dsw-font-markdown-code-block);
 
   position: relative;
@@ -42,7 +44,7 @@
 .infostring {
   color: var(--dsw-alias-label-primary);
   font-family: var(--ds-font-family-code);
-  font-size: 12px;
+  font-size: 11px;
   line-height: 18px;
   min-width: 0;
   overflow: hidden;

package/lib/markdown/MarkdownText.module.css

@@ -96,7 +96,7 @@
 }
 
 .markdown li::marker {
-  line-height: 28px;
+  line-height: 24px;
   color: var(--dsw-alias-label-secondary);
 }
 
@@ -252,7 +252,7 @@
 }
 
 .tableScroll table code {
-  font-size: 13px;
+  font-size: 11px;
 }
 
 .markdown > *:first-child,

package/lib/types/ConnectionIndicator.d.ts

@@ -0,0 +1,25 @@
+/** Visual state rendered by {@link ConnectionIndicator}. */
+export type ConnectionIndicatorState = 'disconnected' | 'connecting' | 'recovered';
+/**
+ * Render an inline connection-recovery control.
+ * @param props.state - visible outage, retry-attempt, or recovered state.
+ * @param props.disconnectedLabel - localized outage text.
+ * @param props.reconnectLabel - localized action text shown on hover or focus.
+ * @param props.connectingLabel - localized retry text followed by the attempt dots.
+ * @param props.recoveredLabel - localized recovery confirmation.
+ * @param props.reconnectActionLabel - accessible label for the outage action.
+ * @param props.restartActionLabel - accessible label for replacing an active attempt.
+ * @param props.onReconnect - request an immediate reconnect attempt.
+ * @returns the indicator, or null when no connection feedback is active.
+ */
+export declare function ConnectionIndicator({ state, disconnectedLabel, reconnectLabel, connectingLabel, recoveredLabel, reconnectActionLabel, restartActionLabel, onReconnect, }: {
+    state: ConnectionIndicatorState | undefined;
+    disconnectedLabel: string;
+    reconnectLabel: string;
+    connectingLabel: string;
+    recoveredLabel: string;
+    reconnectActionLabel: string;
+    restartActionLabel: string;
+    onReconnect: () => void;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=ConnectionIndicator.d.ts.map

package/lib/types/DiffBlock.d.ts

@@ -1,13 +1,8 @@
-/**
- * Output lines shown before the height cap collapses the middle. Matches
- * {@link DEFAULT_TERMINAL_MAX_LINES} so a diff card and a terminal card cut a
- * long body at the same place.
- */
+/** Output lines shown before the height cap collapses the middle. */
 export declare const DEFAULT_DIFF_MAX_LINES = 16;
 /**
- * One file's change, in the shape {@link DiffBlock} draws. Structurally the
- * render-intent contract's `FileDiff`, redeclared here so this primitive stays
- * free of the tool contract (the terminal card's decoupling, applied to diffs).
+ * One file change in the form {@link DiffBlock} renders. It is declared here
+ * so this primitive stays independent of the tool contract.
  */
 export interface DiffHunk {
     /** The changed file's path, drawn verbatim as the hunk's header (the tool's model-facing path). */
@@ -20,15 +15,39 @@ export interface DiffHunk {
 export interface DiffBlockProps {
     /** One entry per applied hunk, in file order; empty renders nothing. */
     diffs: DiffHunk[];
+    /** Localized chrome supplied by the owning render site. */
+    labels: DiffBlockLabels;
     /** Height cap in body lines before the middle collapses (default {@link DEFAULT_DIFF_MAX_LINES}). */
     maxLines?: number | undefined;
     /** Extra class merged onto the wrapper (callers position; this component draws). */
     className?: string | undefined;
 }
+/** Localized chrome for {@link DiffBlock}. */
+export interface DiffBlockLabels {
+    copy: string;
+    copied: string;
+    collapseAria: string;
+    expandAria: (hidden: number) => string;
+    collapse: string;
+    expand: (hidden: number) => string;
+    files: (count: number) => string;
+}
+/**
+ * Total added/removed line counts across hunks — the same numbers the footer
+ * prints, exported so a summary row can show them without rebuilding the body.
+ * Every old-side line counts toward `removed` and every new-side line toward
+ * `added`, under {@link contentLines}'s terminator rule.
+ * @param diffs - the hunks to count.
+ * @returns the +/- totals.
+ */
+export declare function diffTotals(diffs: DiffHunk[]): {
+    added: number;
+    removed: number;
+};
 /**
  * Render a file mutation as an inline diff surface.
  * @param props - see {@link DiffBlockProps}.
  * @returns the diff block element.
  */
-export declare function DiffBlock({ diffs, maxLines, className }: DiffBlockProps): import("react").JSX.Element | null;
+export declare function DiffBlock({ diffs, labels, maxLines, className }: DiffBlockProps): import("react").JSX.Element | null;
 //# sourceMappingURL=DiffBlock.d.ts.map

package/lib/types/FishLogo.d.ts

@@ -1,4 +1,11 @@
 import type { IconProps } from './icons/props.ts';
+/** Native viewBox of {@link FISH_LOGO_PATH} (width and height in user units). */
+export declare const FISH_LOGO_VIEWBOX: {
+    width: number;
+    height: number;
+};
+/** The fish silhouette path data, exported for consumers that compose their own svg (entrance effects, masks) around the same geometry. */
+export declare const FISH_LOGO_PATH = "M22.9168 1.43018C22.6713 1.31018 22.5658 1.53918 22.4223 1.65519C22.3733 1.69269 22.3318 1.74169 22.2903 1.78669C21.9317 2.1697 21.5127 2.42121 20.9657 2.39121C20.1657 2.34621 19.4827 2.59771 18.8787 3.20973C18.7502 2.45521 18.3236 2.0047 17.6746 1.71569C17.3351 1.56568 16.9916 1.41518 16.7536 1.08867C16.5876 0.856163 16.5421 0.597155 16.4591 0.341647C16.4061 0.187643 16.3536 0.0301382 16.1761 0.00363739C15.9836 -0.0263635 15.9081 0.135141 15.8326 0.270145C15.5306 0.822162 15.4136 1.43018 15.4251 2.0462C15.4516 3.43174 16.0366 4.53527 17.1991 5.3203C17.3311 5.4103 17.3651 5.5003 17.3236 5.63181C17.2441 5.90231 17.1501 6.16482 17.0671 6.43533C17.0141 6.60784 16.9351 6.64584 16.7501 6.57033C16.1121 6.30383 15.5611 5.90931 15.074 5.4328C14.2475 4.63328 13.5 3.75075 12.568 3.05973C12.349 2.89822 12.13 2.74822 11.9034 2.60522C10.9524 1.68169 12.028 0.923165 12.277 0.833162C12.5375 0.739159 12.3675 0.41615 11.5259 0.42015C10.6844 0.42365 9.91439 0.705658 8.93286 1.08117C8.78935 1.13767 8.63835 1.17867 8.48384 1.21267C7.59332 1.04367 6.66829 1.00617 5.70226 1.11517C3.88321 1.31768 2.43016 2.1777 1.36213 3.64575C0.0790928 5.4103 -0.222916 7.41536 0.146595 9.50642C0.535106 11.7105 1.66014 13.535 3.38869 14.9616C5.18125 16.4406 7.24581 17.1657 9.60138 17.0266C11.0319 16.9441 12.6245 16.7526 14.421 15.2321C14.874 15.4576 15.3496 15.5476 16.1381 15.6151C16.7456 15.6716 17.3306 15.5851 17.7836 15.4911C18.4931 15.3411 18.4441 14.6841 18.1876 14.5636C16.1081 13.595 16.5646 13.9891 16.1496 13.67C17.2061 12.42 18.8202 10.1979 19.3182 7.17235C19.3672 6.83834 19.4297 6.36783 19.4222 6.09732C19.4182 5.93231 19.4562 5.86831 19.6447 5.84931C20.1657 5.78931 20.6712 5.64681 21.1357 5.3913C22.4833 4.65528 23.0268 3.44624 23.1548 1.9972C23.1738 1.77569 23.1508 1.54668 22.9168 1.43018ZM11.1749 14.4736C9.15936 12.889 8.18184 12.3675 7.77832 12.39C7.40081 12.4125 7.46881 12.8445 7.55182 13.126C7.63882 13.404 7.75182 13.5955 7.91033 13.8396C8.01983 14.0011 8.09533 14.2411 7.80083 14.4216C7.15181 14.8231 6.02327 14.2866 5.97027 14.2601C4.65673 13.4865 3.5587 12.4655 2.78467 11.069C2.03715 9.72493 1.60314 8.28289 1.53164 6.74384C1.51264 6.37233 1.62214 6.24082 1.99215 6.17332C2.47916 6.08332 2.98118 6.06432 3.46769 6.13582C5.52476 6.43633 7.27581 7.35586 8.74385 8.8129C9.58188 9.64243 10.2159 10.634 10.8689 11.6025C11.5634 12.631 12.3105 13.611 13.262 14.4146C13.598 14.6961 13.866 14.9101 14.1225 15.0681C13.349 15.1546 12.058 15.1731 11.1749 14.4746L11.1749 14.4736ZM12.141 8.25988C12.141 8.09488 12.273 7.96338 12.439 7.96338C12.4765 7.96338 12.5105 7.97088 12.541 7.98188C12.5825 7.99688 12.6205 8.01938 12.6505 8.05338C12.7035 8.10588 12.7335 8.18088 12.7335 8.25988C12.7335 8.42489 12.6015 8.55639 12.4355 8.55639C12.2695 8.55639 12.141 8.42489 12.141 8.25988ZM15.1415 9.79893C14.949 9.87793 14.7565 9.94544 14.5715 9.95294C14.2845 9.96794 13.9715 9.85143 13.8015 9.70893C13.5375 9.48742 13.3485 9.36342 13.2695 8.97691C13.2355 8.8119 13.2545 8.55639 13.2845 8.40989C13.3525 8.09438 13.277 7.89187 13.0545 7.70787C12.8735 7.55786 12.643 7.51636 12.39 7.51636C12.2955 7.51636 12.209 7.47486 12.1445 7.44136C12.039 7.38886 11.9519 7.25735 12.035 7.09585C12.0615 7.04335 12.19 6.91584 12.22 6.89334C12.5635 6.69784 12.9595 6.76184 13.326 6.90834C13.6655 7.04735 13.9225 7.30236 14.292 7.66287C14.6695 8.09838 14.7375 8.21838 14.9525 8.54539C15.1225 8.8009 15.277 9.06341 15.3831 9.36392C15.4471 9.55142 15.3641 9.70493 15.1415 9.79893Z";
 /**
  * Render the fish logo.
  * @param props.size - width in px (default 24; height keeps the 23.16:17.04 ratio).

package/lib/types/FoldToggle.d.ts

@@ -0,0 +1,20 @@
+interface FoldToggleProps {
+    className: string | undefined;
+    expanded: boolean;
+    hidden: number;
+    labels: {
+        collapseAria: string;
+        expandAria: (hidden: number) => string;
+        collapse: string;
+        expand: (hidden: number) => string;
+    };
+    onToggle: () => void;
+}
+/**
+ * Render the shared head-tail fold control with caller-owned localized copy.
+ * @param props - Fold state, localized labels, and toggle callback.
+ * @returns The accessible expand or collapse button.
+ */
+export declare function FoldToggle({ className, expanded, hidden, labels, onToggle, }: FoldToggleProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=FoldToggle.d.ts.map

package/lib/types/HoverCard.d.ts

@@ -8,8 +8,8 @@ import type { ReactNode } from 'react';
  * @param props.disabled - suppress opening; turning true closes an open card.
  * @param props.copyText - optional primary value copied by activation and
  * included in the card's accessible name.
- * @param props.copyLabel - accessible activation-label prefix (default "复制").
- * @param props.copiedLabel - visible success label (default "复制成功").
+ * @param props.copyLabel - localized accessible activation-label prefix.
+ * @param props.copiedLabel - localized visible success label.
  * @returns anchor wrapper with the conditional portaled card.
  */
 export declare function HoverCard({ anchor, content, openDelayMs, disabled, copyText, copyLabel, copiedLabel, }: {
@@ -18,7 +18,7 @@ export declare function HoverCard({ anchor, content, openDelayMs, disabled, copy
     openDelayMs?: number;
     disabled?: boolean;
     copyText?: string | undefined;
-    copyLabel?: string | undefined;
-    copiedLabel?: string | undefined;
+    copyLabel: string;
+    copiedLabel: string;
 }): import("react").JSX.Element;
 //# sourceMappingURL=HoverCard.d.ts.map

package/lib/types/JsonTree.d.ts

@@ -1,8 +1,6 @@
 /**
  * Display copy for the tree's copy affordance; the owner passes localized
- * labels (this package is cordis-free, so copy arrives via props). Every
- * field defaults to the current built-in value, so existing consumers render
- * unchanged.
+ * labels (this package is cordis-free, so copy arrives via props).
  */
 export interface JsonTreeLabels {
     /** Menu item: copy the raw primitive value. */
@@ -31,15 +29,15 @@ export interface JsonTreeProps {
     /** Parsed JSON object or array. */
     data: object | unknown[];
     /** Accessible label for the tree. */
-    label?: string;
+    label: string;
     /** Optional positioning class owned by the caller. */
     className?: string | undefined;
     /** Whether JSON rows expose copy actions. */
     copyable?: boolean;
     /** Whether the top-level object or array is always expanded. */
     expandTopLevel?: boolean;
-    /** Localized display copy; omitted fields keep the built-in defaults. */
-    labels?: Partial<JsonTreeLabels> | undefined;
+    /** Localized display copy supplied by the owning render site. */
+    labels: JsonTreeLabels;
 }
 /**
  * Render parsed JSON as a compact, keyboard-accessible inspector tree.

package/lib/types/Modal.d.ts

@@ -1,31 +1,35 @@
 import type { ReactNode } from 'react';
+interface ModalBaseProps {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    description?: string;
+    children?: ReactNode;
+    footer?: ReactNode;
+    className?: string;
+    contentClassName?: string;
+}
+type ModalProps = ModalBaseProps & ({
+    headless: true;
+    closeLabel?: never;
+} | {
+    headless?: false;
+    closeLabel: string;
+});
 /**
- * Render a centered modal over a blurred page mask.
+ * Render a centered, body-portaled modal over a blurred page mask.
  * @param props.open - whether the dialog is showing.
  * @param props.onClose - Escape or mask click.
  * @param props.title - dialog heading (aria-label in every mode).
- * @param props.closeLabel - accessible close-button label.
+ * @param props.closeLabel - localized accessible close-button label.
  * @param props.description - optional supporting sentence under the title.
  * @param props.children - body (inputs, etc.).
  * @param props.footer - action row (Cancel / Create).
  * @param props.contentClassName - optional class for a scrollable content region.
  * @param props.headless - render children directly in the card (no default
- * header/close/body chrome) for dialogs whose figma frame owns its own
- * header structure; mask, card, Escape, and aria-label remain.
- * @param props.closeLabel - close-button aria label; the owner passes
- * localized copy (this package is cordis-free, so copy arrives via props).
+ * header/close/body chrome); mask, card, Escape, and aria-label remain.
  * @returns null when closed; otherwise the overlay tree.
  */
-export declare function Modal({ open, onClose, title, closeLabel, description, children, footer, className, contentClassName, headless, }: {
-    open: boolean;
-    onClose: () => void;
-    title: string;
-    closeLabel?: string;
-    description?: string;
-    children?: ReactNode;
-    footer?: ReactNode;
-    className?: string;
-    contentClassName?: string;
-    headless?: boolean;
-}): import("react").ReactPortal | null;
+export declare function Modal({ open, onClose, title, closeLabel, description, children, footer, className, contentClassName, headless, }: ModalProps): import("react").ReactPortal | null;
+export {};
 //# sourceMappingURL=Modal.d.ts.map

package/lib/types/OnboardingSurface.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 /**
- * Render the onboarding takeover chrome (mask + opaque stage) around one
- * step's content and keep the application root inert while mounted.
+ * Render a body-portaled onboarding stage and keep the application root inert
+ * while mounted.
  * @param props.children - the step's page content, centered on the stage.
  * @returns the body-portaled overlay tree.
  */

package/lib/types/ReadBlock.d.ts

@@ -16,6 +16,8 @@ export interface ReadBlockProps {
     label?: string | undefined;
     /** The returned window's lines, in file order, each keeping its file line number. */
     lines: readonly ReadBlockLine[];
+    /** Localized chrome supplied by the owning render site. */
+    labels: ReadBlockLabels;
     /** Exact total line count in the file, for the "showing N of M" note when the read is a window. */
     totalLines: number;
     /** Grammar hint (a file-extension-derived language id); unknown or absent = plain monospace. */
@@ -25,11 +27,21 @@ export interface ReadBlockProps {
     /** Extra class merged onto the wrapper (callers position; this component draws). */
     className?: string | undefined;
 }
+/** Localized chrome for {@link ReadBlock}. */
+export interface ReadBlockLabels {
+    window: (shown: number, total: number) => string;
+    copy: string;
+    copied: string;
+    collapseAria: string;
+    expandAria: (hidden: number) => string;
+    collapse: string;
+    expand: (hidden: number) => string;
+}
 /**
  * Render a read tool result as a line-numbered, optionally syntax-highlighted
  * file view.
  * @param props - see {@link ReadBlockProps}.
  * @returns the read block element.
  */
-export declare function ReadBlock({ label, lines, totalLines, lang, maxLines, className, }: ReadBlockProps): import("react").JSX.Element;
+export declare function ReadBlock({ label, labels, lines, totalLines, lang, maxLines, className, }: ReadBlockProps): import("react").JSX.Element;
 //# sourceMappingURL=ReadBlock.d.ts.map

package/lib/types/ReferenceIcon.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+/** Reference domains with distinct composer and transcript glyphs. */
+export type ReferenceIconKind = 'session' | 'file' | 'folder';
+/** Props shared by inline reference glyphs. */
+export interface ReferenceIconProps {
+    kind: ReferenceIconKind;
+    size?: number;
+    className?: string | undefined;
+}
+/**
+ * Render the icon that identifies one inline reference domain.
+ * @param props - Reference kind, optional size, and optional CSS class.
+ * @returns The corresponding current-color SVG glyph.
+ */
+export declare function ReferenceIcon({ kind, size, className }: ReferenceIconProps): ReactNode;
+//# sourceMappingURL=ReferenceIcon.d.ts.map

package/lib/types/RiskConfirmation.d.ts

@@ -4,6 +4,7 @@ export interface RiskConfirmationProps {
     description: string;
     acknowledgeLabel: string;
     cancelLabel: string;
+    closeLabel: string;
     confirmLabel: string;
     acknowledged: boolean;
     disabled?: boolean;
@@ -15,5 +16,5 @@ export interface RiskConfirmationProps {
  * Render one in-page confirmation whose primary action is unavailable until
  * the caller-controlled acknowledgement is checked.
  */
-export declare function RiskConfirmation({ open, title, description, acknowledgeLabel, cancelLabel, confirmLabel, acknowledged, disabled, onAcknowledgedChange, onCancel, onConfirm, }: RiskConfirmationProps): import("react").JSX.Element;
+export declare function RiskConfirmation({ open, title, description, acknowledgeLabel, cancelLabel, closeLabel, confirmLabel, acknowledged, disabled, onAcknowledgedChange, onCancel, onConfirm, }: RiskConfirmationProps): import("react").JSX.Element;
 //# sourceMappingURL=RiskConfirmation.d.ts.map

package/lib/types/SearchBlock.d.ts

@@ -20,6 +20,8 @@ export interface SearchFileGroup {
 }
 /** Fields both search shapes carry (the render site positions; this component draws). */
 interface SearchBlockCommon {
+    /** Localized chrome supplied by the owning render site. */
+    labels: SearchBlockLabels;
     /**
      * Whether the tool capped the inline result: the shape carries only the
      * retained results, not every result the search found. The banner summary
@@ -34,6 +36,18 @@ interface SearchBlockCommon {
     /** Extra class merged onto the wrapper. */
     className?: string | undefined;
 }
+/** Localized chrome for {@link SearchBlock}. */
+export interface SearchBlockLabels {
+    pathsSummary: (shown: number, total: number, truncated: boolean) => string;
+    matchesSummary: (shown: number, total: number, files: number, truncated: boolean) => string;
+    copy: string;
+    copied: string;
+    noResults: string;
+    collapseAria: string;
+    expandAria: (hidden: number) => string;
+    collapse: string;
+    expand: (hidden: number) => string;
+}
 /** Props for the grouped-matches (`grep`) shape. */
 export interface SearchMatchesBlockProps extends SearchBlockCommon {
     kind: 'matches';

package/lib/types/TerminalBlock.d.ts

@@ -1,14 +1,8 @@
-/**
- * Output lines shown before the height cap collapses the middle. Matches the
- * TUI transcript's default tool-output budget so both front ends cut a long
- * command's output at the same place.
- */
+/** Output lines shown before the height cap collapses the middle. */
 export declare const DEFAULT_TERMINAL_MAX_LINES = 16;
 /**
  * Display copy for the terminal surface; the owner passes localized labels
- * (this package is cordis-free, so copy arrives via props). Every field
- * defaults to the current built-in value, so existing consumers render
- * unchanged.
+ * (this package is cordis-free, so copy arrives via props).
  */
 export interface TerminalBlockLabels {
     /** Status pill text for a signal-terminated command. */
@@ -55,8 +49,8 @@ export interface TerminalBlockProps {
     maxLines?: number | undefined;
     /** Extra class merged onto the wrapper (callers position; this component draws). */
     className?: string | undefined;
-    /** Localized display copy; omitted fields keep the built-in defaults. */
-    labels?: Partial<TerminalBlockLabels> | undefined;
+    /** Localized display copy supplied by the owning render site. */
+    labels: TerminalBlockLabels;
 }
 /**
  * Render a shell command as a terminal surface.

package/lib/types/Toast.d.ts

@@ -7,18 +7,26 @@ import type { ReactNode } from 'react';
  * transformed or filtered ancestor cannot trap the fixed banner in that
  * ancestor's box.
  *
+ * The hold is the owner's to set, because how long a banner has to stay
+ * depends on how much there is to read: a one-line limit lands in the default
+ * window, while a failure that names what broke does not. One value drives
+ * both the unmount timer and the stylesheet's fade delay — the stylesheet
+ * reads it as a custom property — so the two can no longer disagree and leave
+ * the banner unmounting mid-fade.
  * @param props.text - resolved banner copy; the owner passes localized text.
  * @param props.icon - optional leading glyph (e.g. a warning icon).
+ * @param props.holdMs - full-opacity hold before the fade; defaults to 3000.
  * @param props.anchor - optional element whose horizontal center the banner
  * follows (e.g. the composer card, so the banner centers over the chat column
  * rather than the whole window); omitted, it centers on the viewport.
  * @param props.onDone - called once the fade completes; unmount the toast here.
  * @returns the floating banner.
  */
-export declare function Toast({ text, icon, anchor, onDone }: {
+export declare function Toast({ text, icon, anchor, holdMs, onDone }: {
     text: string;
     icon?: ReactNode;
     anchor?: HTMLElement | null;
+    holdMs?: number;
     onDone: () => void;
 }): import("react").ReactPortal;
 //# sourceMappingURL=Toast.d.ts.map

package/lib/types/WebBlock.d.ts

@@ -1,3 +1,4 @@
+import { type MarkdownLabels } from './markdown/MarkdownText.tsx';
 /**
  * One citeable source drawn in a search card: the projection of the contract's
  * `WebSource`, with the optional fields kept optional so a provider that
@@ -16,6 +17,8 @@ export interface WebSourceView {
 /** A `web_search` card: an optional answer over a capped citation list. */
 export interface WebSearchBlockProps {
     kind: 'search';
+    /** Localized chrome supplied by the owning render site. */
+    labels: WebBlockLabels;
     /** The provider-generated answer, rendered as markdown above the sources. */
     answer?: string | undefined;
     /** The cited sources, in provider order. */
@@ -28,6 +31,8 @@ export interface WebSearchBlockProps {
 /** A `web_fetch` card: the retrieval summary for one fetched URL. */
 export interface WebFetchBlockProps {
     kind: 'fetch';
+    /** Localized chrome supplied by the owning render site. */
+    labels: WebBlockLabels;
     /** The final URL after allowed redirects; becomes a safe external link when http(s). */
     url: string;
     /** HTTP status code of the fetched response. */
@@ -39,6 +44,14 @@ export interface WebFetchBlockProps {
 }
 /** A completed web retrieval card, discriminated by `kind`. */
 export type WebBlockProps = WebSearchBlockProps | WebFetchBlockProps;
+/** Localized chrome for {@link WebBlock}. */
+export interface WebBlockLabels {
+    noResults: string;
+    sourcesTruncated: string;
+    http: string;
+    contentTruncated: string;
+    markdown: MarkdownLabels;
+}
 /**
  * Render a completed web retrieval as a structured card.
  * @param props - see {@link WebBlockProps}; `kind` selects the search or fetch body.

package/lib/types/icons/index.d.ts

@@ -67,6 +67,8 @@ export declare const IconThinkOutline16: ({ size, className }: IconProps) => imp
 export declare const IconAgentPresetOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_ds_browse_outline_16 */
 export declare const IconBrowseOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** ic_ds_context_injection_outline_16 (figma extract): browse document frame with an open top and an arrow dropping in. */
+export declare const IconContextInjectionOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_ds_link_outline_14 */
 export declare const IconLinkOutline14: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_ds_link_outline_16 */
@@ -129,6 +131,10 @@ export declare const IconDarkOutline16: ({ size, className }: IconProps) => impo
 export declare const IconFollowsystemOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_ds_data_outline_16 */
 export declare const IconDataOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** IconDataOutline16 without its gear: a three-tier database cylinder. */
+export declare const IconDatabaseOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** Thin-stroke clock: outlined dial with square-cut hour and minute hands. */
+export declare const IconClockOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_send_outline_14 (figma extract): thin-stroke upward send arrow. */
 export declare const IconSendOutline14: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_queue_outline_14 (figma extract): open chat bubble with two queued lines. */
@@ -149,6 +155,8 @@ export declare const IconInspectOutline12: ({ size, className }: IconProps) => i
 export declare const IconSkillOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_ds_question_outline_14 (figma extract): ring + question glyph. */
 export declare const IconQuestionOutline14: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** Alarm clock outline for active scheduled-task indicators. */
+export declare const IconAlarmClockOutline16: ({ size, className }: IconProps) => import("react").JSX.Element;
 /** ic_ds_archive_outline_20 (figma extract): lidded box + label slot. The export's
  *  0.11px stroke ring around the box contour is dropped — it restates the same
  *  contour in the same ink, which currentColor already carries. */

package/lib/types/index.d.ts

@@ -20,31 +20,37 @@ export { Modal } from './Modal.tsx';
 export { OnboardingSurface } from './OnboardingSurface.tsx';
 export { RiskConfirmation } from './RiskConfirmation.tsx';
 export type { RiskConfirmationProps } from './RiskConfirmation.tsx';
-export { ConnectionBanner } from './ConnectionBanner.tsx';
-export { FishLogo } from './FishLogo.tsx';
+export { ConnectionIndicator } from './ConnectionIndicator.tsx';
+export type { ConnectionIndicatorState } from './ConnectionIndicator.tsx';
+export { FishLogo, FISH_LOGO_PATH, FISH_LOGO_VIEWBOX } from './FishLogo.tsx';
 export { BrandWordmark } from './BrandWordmark.tsx';
 export type { BrandWordmarkProps } from './BrandWordmark.tsx';
+export { ReferenceIcon } from './ReferenceIcon.tsx';
+export type { ReferenceIconKind, ReferenceIconProps } from './ReferenceIcon.tsx';
+export { projectUserText } from './user-text.tsx';
 export { Tooltip } from './Tooltip.tsx';
 export type { TooltipSide } from './Tooltip.tsx';
 export { Toast } from './Toast.tsx';
 export { writeClipboard } from './clipboard.ts';
+export { relativeTime } from './relative-time.ts';
+export type { RelativeTime, RelativeTimeUnit } from './relative-time.ts';
 export { JsonTree } from './JsonTree.tsx';
 export type { JsonTreeProps, JsonTreeLabels } from './JsonTree.tsx';
 export { TerminalBlock, DEFAULT_TERMINAL_MAX_LINES } from './TerminalBlock.tsx';
 export type { TerminalBlockProps, TerminalBlockLabels } from './TerminalBlock.tsx';
 export { ReadBlock, DEFAULT_READ_MAX_LINES } from './ReadBlock.tsx';
-export type { ReadBlockProps, ReadBlockLine } from './ReadBlock.tsx';
-export { DiffBlock, DEFAULT_DIFF_MAX_LINES } from './DiffBlock.tsx';
-export type { DiffBlockProps, DiffHunk } from './DiffBlock.tsx';
+export type { ReadBlockProps, ReadBlockLine, ReadBlockLabels } from './ReadBlock.tsx';
+export { DiffBlock, DEFAULT_DIFF_MAX_LINES, diffTotals } from './DiffBlock.tsx';
+export type { DiffBlockProps, DiffHunk, DiffBlockLabels } from './DiffBlock.tsx';
 export { SearchBlock, DEFAULT_SEARCH_MAX_LINES } from './SearchBlock.tsx';
-export type { SearchBlockProps, SearchMatchesBlockProps, SearchPathsBlockProps, SearchFileGroup, SearchBlockLineMatch, } from './SearchBlock.tsx';
+export type { SearchBlockProps, SearchMatchesBlockProps, SearchPathsBlockProps, SearchFileGroup, SearchBlockLineMatch, SearchBlockLabels, } from './SearchBlock.tsx';
 export { WebBlock } from './WebBlock.tsx';
-export type { WebBlockProps, WebSearchBlockProps, WebFetchBlockProps, WebSourceView } from './WebBlock.tsx';
+export type { WebBlockProps, WebSearchBlockProps, WebFetchBlockProps, WebSourceView, WebBlockLabels, } from './WebBlock.tsx';
 export { CodeBlock } from './markdown/CodeBlock.tsx';
 export type { CodeBlockProps } from './markdown/CodeBlock.tsx';
 export { JsonBlock } from './markdown/JsonBlock.tsx';
 export { MarkdownText } from './markdown/MarkdownText.tsx';
-export type { MarkdownCodeLabels, MarkdownFileMentions } from './markdown/MarkdownText.tsx';
+export type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownLabels } from './markdown/MarkdownText.tsx';
 export { MessageText } from './markdown/MessageText.tsx';
 export { extractMarkdownPlainText } from './markdown/plain-text.ts';
 export type { MarkdownPlainTextMode, MarkdownPlainTextOptions } from './markdown/plain-text.ts';

package/lib/types/markdown/CodeBlock.d.ts

@@ -3,12 +3,20 @@ export interface CodeBlockProps {
     code: string;
     /** Grammar hint (markdown fence info string or a fixed caller id); unknown = plain. */
     lang?: string | undefined;
+    /**
+     * The code is still growing (a streaming markdown fence): highlight through
+     * a per-instance {@link StreamingHighlightSession}, which re-tokenizes only
+     * appended text and keeps completed lines' elements (and DOM) untouched.
+     * The caller must keep the component instance stable across growth (a
+     * stream-stable React key); settled callers omit this and get shiki's HTML.
+     */
+    streaming?: boolean | undefined;
     /** Extra class merged onto the wrapper (callers position; this component draws). */
     className?: string | undefined;
     /** Copy-button idle label; the owner passes localized copy (this package is cordis-free, so copy arrives via props). */
-    copyLabel?: string | undefined;
+    copyLabel: string;
     /** Copy-button label during the post-copy confirmation window. */
-    copiedLabel?: string | undefined;
+    copiedLabel: string;
 }
-export declare function CodeBlock({ code, lang, className, copyLabel, copiedLabel }: CodeBlockProps): import("react").JSX.Element;
+export declare function CodeBlock({ code, lang, streaming, className, copyLabel, copiedLabel }: CodeBlockProps): import("react").JSX.Element;
 //# sourceMappingURL=CodeBlock.d.ts.map

package/lib/types/markdown/JsonBlock.d.ts

@@ -3,6 +3,6 @@ export declare function JsonBlock({ label, payload, defaultOpen, truncatedLabel
     payload: unknown;
     defaultOpen?: boolean;
     /** Footer appended when the body exceeds the char cap, given the full length (this package is cordis-free, so copy arrives via props). */
-    truncatedLabel?: ((total: number) => string) | undefined;
+    truncatedLabel: (total: number) => string;
 }): import("react").JSX.Element;
 //# sourceMappingURL=JsonBlock.d.ts.map

package/lib/types/markdown/MarkdownText.d.ts

@@ -10,15 +10,16 @@
  * other side of the freeze boundary renders literally until the settled
  * full parse self-heals it.
  */
-import type { MarkdownCodeLabels, MarkdownFileMentions } from './render.tsx';
+import type { MarkdownFileMentions, MarkdownLabels } from './render.tsx';
 import 'katex/dist/katex.min.css';
-export type { MarkdownCodeLabels, MarkdownFileMentions } from './render.tsx';
+export type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownLabels } from './render.tsx';
 /**
  * Render untrusted assistant-authored Markdown as semantic React elements.
  * @param props - Markdown source text preserved by the session projection;
- * `streaming` renders fences and TeX plain (highlighting and KaTeX land on
- * the finalize swap) and parses incrementally across chunks; `codeLabels`
- * forwards localized copy-button labels to fence CodeBlocks — pass a
+ * `streaming` parses incrementally across chunks and highlights fences as
+ * they grow (each fence re-tokenizes only appended text; TeX stays literal
+ * until the finalize swap so incomplete formulae never flash errors);
+ * `labels` forwards localized fence and footnote chrome — pass a
  * reference-stable object (memoized per locale revision), because a new
  * identity discards the streaming render cache mid-message. `fileMentions`
  * links inline-code tokens its resolver recognizes as real files; this is
@@ -29,10 +30,10 @@ export type { MarkdownCodeLabels, MarkdownFileMentions } from './render.tsx';
  * relative links, and unsafe protocols are disabled, while absolute HTTP(S)
  * images render directly.
  */
-export declare const MarkdownText: import("react").MemoExoticComponent<({ text, streaming, codeLabels, fileMentions }: {
+export declare const MarkdownText: import("react").MemoExoticComponent<({ text, streaming, labels, fileMentions }: {
     text: string;
     streaming?: boolean;
-    codeLabels?: MarkdownCodeLabels | undefined;
+    labels: MarkdownLabels;
     fileMentions?: MarkdownFileMentions | undefined;
 }) => import("react").JSX.Element>;
 //# sourceMappingURL=MarkdownText.d.ts.map