@x1a0f3n9/dsh-client-ui-primitives 0.1.5-rc.3

package/lib/types/FishLogo.d.ts

@@ -0,0 +1,16 @@
+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).
+ * @param props.className - extra class for layout placement.
+ * @returns the logo svg (aria-hidden; pair with the wordmark for accessibility).
+ */
+export declare function FishLogo({ size, className }: IconProps): import("react").JSX.Element;
+//# sourceMappingURL=FishLogo.d.ts.map

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

@@ -0,0 +1,24 @@
+import type { ReactNode } from 'react';
+/**
+ * Render an anchor with a hover-triggered preview card.
+ * @param props.anchor - the hover target (rendered in place inside a wrapper span).
+ * @param props.content - card content; the pointer may rest on it, so it is
+ * readable and selectable, but it carries no dismissal affordance of its own.
+ * @param props.openDelayMs - hover dwell before the card shows (default 500).
+ * @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 - 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, }: {
+    anchor: ReactNode;
+    content: ReactNode;
+    openDelayMs?: number;
+    disabled?: boolean;
+    copyText?: string | undefined;
+    copyLabel: string;
+    copiedLabel: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=HoverCard.d.ts.map

package/lib/types/Input.d.ts

@@ -0,0 +1,11 @@
+import type { InputHTMLAttributes, ReactNode } from 'react';
+/**
+ * Render a text input with an optional leading icon.
+ * @param props.icon - optional 16px leading icon node.
+ * @returns wrapper span containing the native input; input attributes pass through.
+ */
+export declare function Input({ icon, className, ...rest }: {
+    icon?: ReactNode;
+    className?: string;
+} & InputHTMLAttributes<HTMLInputElement>): import("react").JSX.Element;
+//# sourceMappingURL=Input.d.ts.map

package/lib/types/JsonTree.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Display copy for the tree's copy affordance; the owner passes localized
+ * labels (this package is cordis-free, so copy arrives via props).
+ */
+export interface JsonTreeLabels {
+    /** Menu item: copy the raw primitive value. */
+    copyValue: string;
+    /** Menu item: copy the value as compact JSON (primitive rows). */
+    copyJson: string;
+    /** Menu item: copy the property path. */
+    copyPath: string;
+    /** Menu item: copy the value as pretty-printed JSON. */
+    copyPrettyJson: string;
+    /** Menu item: copy the value as compact JSON (object rows). */
+    copyCompactJson: string;
+    /** Copy-button state label after a successful copy. */
+    copied: string;
+    /** Copy-button state label after a failed copy. */
+    copyFailed: string;
+    /** Expander aria label while expanded. */
+    collapseNode: string;
+    /** Expander aria label while collapsed. */
+    expandNode: string;
+    /** Copy-button tooltip, given the current action label. */
+    copyButtonTitle: (action: string) => string;
+}
+/** Props for the read-only, token-themed JSON tree. */
+export interface JsonTreeProps {
+    /** Parsed JSON object or array. */
+    data: object | unknown[];
+    /** Accessible label for the tree. */
+    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 supplied by the owning render site. */
+    labels: JsonTreeLabels;
+}
+/**
+ * Render parsed JSON as a compact, keyboard-accessible inspector tree.
+ * @param props - Parsed data, accessible label, and display options.
+ * @returns A read-only JSON tree with an optionally fixed-open top level.
+ */
+export declare function JsonTree({ data, label, className, copyable, expandTopLevel, labels, }: JsonTreeProps): import("react").JSX.Element;
+//# sourceMappingURL=JsonTree.d.ts.map

package/lib/types/LinkIcon.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Leading category glyph for clickable artifact links (anchors, file
+ * mentions, produced-file chips). One component keyed by link category;
+ * every glyph renders fill="currentColor" and so rides the link's own
+ * color. Glyphs stay private to this module: the public surface is the
+ * category vocabulary, not the individual glyph components, so consumers
+ * cannot compose a glyph outside a link. Design sources:
+ * ic_globe_language_outline_20, ic_code_outline_20, ic_folder_outline_20,
+ * ic_photo_outline_20, ic_paper_doc_outline_20, ic_paper_outline_20.
+ */
+import type { ReactNode } from 'react';
+import type { IconProps } from './icons/props.ts';
+/**
+ * Link categories with distinct leading glyphs. `url` and `folder` are
+ * destination categories the consumer states directly; the rest are file
+ * categories `classifyLinkPath` derives from a path. Code, web, and data
+ * files share the `code` glyph by design.
+ */
+export type LinkIconKind = 'url' | 'folder' | 'code' | 'image' | 'document' | 'other';
+/** Props for {@link LinkIcon}: the category plus the shared icon sizing seat. */
+export interface LinkIconProps extends IconProps {
+    kind: LinkIconKind;
+}
+/**
+ * Derive a file path's link-icon category from its extension. Unknown and
+ * missing extensions fall to `other` (the plain-paper glyph).
+ * @param path - File path as the producing tool spelled it (either separator).
+ * @returns The file's glyph category; never `url` or `folder`.
+ */
+export declare function classifyLinkPath(path: string): LinkIconKind;
+/**
+ * Render the leading glyph for one clickable artifact link.
+ * @param props - The link category, optional size (default 14px — the inline
+ * link text size these glyphs sit beside), and optional CSS class.
+ * @returns The category's SVG glyph, riding currentColor.
+ */
+export declare function LinkIcon({ kind, size, className }: LinkIconProps): ReactNode;
+//# sourceMappingURL=LinkIcon.d.ts.map

package/lib/types/Menu.d.ts

@@ -0,0 +1,85 @@
+import type { ReactNode } from 'react';
+/** Selectable row (optionally with a nested submenu). */
+export interface MenuItem {
+    id: string;
+    label: ReactNode;
+    disabled?: boolean;
+    /** Leading icon (figma .Menu_cell gap 8). */
+    icon?: ReactNode;
+    /** Destructive row: error-colored text/icon and danger hover fill. */
+    danger?: boolean;
+    /** Nested card opened to the right on hover/focus. */
+    submenu?: readonly MenuItem[];
+}
+/** Hairline between item groups (not selectable). */
+export interface MenuSeparator {
+    type: 'separator';
+    id: string;
+}
+/** Non-interactive heading row above a group of items. */
+export interface MenuLabel {
+    type: 'label';
+    id: string;
+    text: string;
+}
+/** One primary-menu entry: a row, a separator, or a heading label. */
+export type MenuEntry = MenuItem | MenuSeparator | MenuLabel;
+/**
+ * Render an anchored dropdown menu.
+ * @param props.autoFocus - focus the first item on open and enable arrow-key navigation; Escape focuses the anchor's first button.
+ * @param props.open - whether the list is showing (owner-controlled).
+ * @param props.anchor - the trigger element (rendered in place).
+ * @param props.items - selectable rows and optional separators.
+ * @param props.selectedId - row shown as selected.
+ * @param props.selectedIds - rows shown as selected when a menu contains independent option groups.
+ * @param props.onSelect - row click callback (not called for disabled rows or submenu parents that only open children).
+ * @param props.onClose - invoked on outside click, Escape, or a window blur
+ * that moved focus into an iframe (the only signal a pointerdown inside a
+ * cross-origin iframe leaves).
+ * @param props.align - list alignment against the anchor (default 'start').
+ * @param props.side - open below (`bottom`, default) or above (`top`) the anchor.
+ * @param props.portal - render the list into document.body, fixed-positioned
+ * from the anchor rect (repositions on scroll/resize while open). Use when an
+ * ancestor's overflow clipping would crop the in-place list; default false
+ * keeps the pure-CSS in-place behavior.
+ * @param props.closeOnPointerLeave - close the list once the pointer has left
+ * both trigger and list for the pointer grace (default false keeps it open
+ * until outside click/Escape/selection). The grace makes the 4px trigger->list
+ * gap and a brief overshoot survivable; coming back cancels the close.
+ * @param props.dense - reduce vertical row spacing without changing the standard typography or card width.
+ * @param props.compact - use reduced menu typography and spacing.
+ * @param props.getAnchorRect - portal mode only: supply the anchor rect
+ * directly (e.g. from a host-owned trigger button) instead of measuring the
+ * Menu's own wrapper span. Required when the wrapper isn't itself laid out at
+ * the trigger (render-prop anchors, effect-positioned proxies — measuring the
+ * wrapper there races the host's layout effects). Called on open and on every
+ * scroll/resize; return null to skip placement for that frame.
+ * @param props.footer - rows pinned below the scrolling items area, separated
+ * by a hairline; they stay visible while the items above scroll.
+ * @param props.selection - how a selected row is marked: a trailing check
+ * (`'check'`, default — figma .Menu_cell) or the hover fill held on the row
+ * with no check (`'fill'`, for icon-labelled rows where a trailing glyph
+ * crowds the cell).
+ * @returns anchor wrapper with the conditional list.
+ */
+export declare function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose, align, side, portal, closeOnPointerLeave, dense, compact, autoFocus, selection, getAnchorRect, footer, className }: {
+    open: boolean;
+    autoFocus?: boolean;
+    anchor: ReactNode;
+    items: readonly MenuEntry[];
+    footer?: readonly MenuEntry[];
+    selectedId?: string | undefined;
+    selectedIds?: readonly string[] | undefined;
+    onSelect: (id: string) => void;
+    onClose: () => void;
+    align?: 'start' | 'end';
+    side?: 'bottom' | 'top' | 'right';
+    portal?: boolean;
+    closeOnPointerLeave?: boolean;
+    dense?: boolean;
+    compact?: boolean;
+    selection?: 'check' | 'fill';
+    getAnchorRect?: () => DOMRect | null;
+    className?: string | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=Menu.d.ts.map

package/lib/types/Modal.d.ts

@@ -0,0 +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, 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 - 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); 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, }: ModalProps): import("react").ReactPortal | null;
+export {};
+//# sourceMappingURL=Modal.d.ts.map

package/lib/types/OnboardingSurface.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from 'react';
+/**
+ * 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.
+ */
+export declare function OnboardingSurface({ children }: {
+    children: ReactNode;
+}): import("react").ReactPortal;
+//# sourceMappingURL=OnboardingSurface.d.ts.map

package/lib/types/Pill.d.ts

@@ -0,0 +1,13 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+/**
+ * Render a pill chip. Interactive when onClick is supplied (renders a button);
+ * otherwise a static span.
+ * @param props.active - selected/active visual state.
+ * @returns pill element.
+ */
+export declare function Pill({ active, className, children, onClick, ...rest }: {
+    active?: boolean;
+    className?: string | undefined;
+    children?: ReactNode;
+} & ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
+//# sourceMappingURL=Pill.d.ts.map

package/lib/types/ReadBlock.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Content lines shown before the height cap collapses the middle. Matches
+ * TerminalBlock's default so a long read and a long command output cut at the
+ * same place in the same flow.
+ */
+export declare const DEFAULT_READ_MAX_LINES = 16;
+/** One line of the read window: its file line number and its text (no trailing newline). */
+export interface ReadBlockLine {
+    /** 1-based line number in the file (a window past an offset keeps the file's own numbering). */
+    number: number;
+    /** The line's text, already truncated to the read tool's per-line cap. */
+    text: string;
+}
+export interface ReadBlockProps {
+    /** Banner label (the file path, or a tool-supplied replacement title); omitted draws no label. */
+    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. */
+    lang?: string | undefined;
+    /** Height cap in content lines before the middle collapses (default {@link DEFAULT_READ_MAX_LINES}). */
+    maxLines?: number | undefined;
+    /** 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, 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

@@ -0,0 +1,20 @@
+export interface RiskConfirmationProps {
+    open: boolean;
+    title: string;
+    description: string;
+    acknowledgeLabel: string;
+    cancelLabel: string;
+    closeLabel: string;
+    confirmLabel: string;
+    acknowledged: boolean;
+    disabled?: boolean;
+    onAcknowledgedChange: (acknowledged: boolean) => void;
+    onCancel: () => void;
+    onConfirm: () => void;
+}
+/**
+ * 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, closeLabel, confirmLabel, acknowledged, disabled, onAcknowledgedChange, onCancel, onConfirm, }: RiskConfirmationProps): import("react").JSX.Element;
+//# sourceMappingURL=RiskConfirmation.d.ts.map

package/lib/types/SearchBlock.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Result rows shown before the height cap collapses the middle. Matches
+ * {@link DEFAULT_TERMINAL_MAX_LINES} so a search card and a terminal card cut a
+ * long result at the same place.
+ */
+export declare const DEFAULT_SEARCH_MAX_LINES = 16;
+/** One matched line inside a {@link SearchFileGroup}: its 1-based line number and text. */
+export interface SearchBlockLineMatch {
+    /** 1-based line number of the match within its file. */
+    lineNumber: number;
+    /** The matched line text, as the tool surfaced it. */
+    line: string;
+}
+/** One file's grouped matches, in first-seen file order. */
+export interface SearchFileGroup {
+    /** The file the matches belong to (the display path). */
+    path: string;
+    /** The file's matched lines, in output order. */
+    matches: SearchBlockLineMatch[];
+}
+/** 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
+     * folds the pre-cap `total` in (`显示 X / 共 N …`) so the card never presents a
+     * capped result as complete.
+     */
+    truncated: boolean;
+    /** Total results the search found before capping (equals the retained count when not `truncated`). */
+    total: number;
+    /** Height cap in rows before the middle collapses (default {@link DEFAULT_SEARCH_MAX_LINES}). */
+    maxLines?: number | undefined;
+    /** 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';
+    /** Matched lines grouped by file, in first-seen file order. */
+    files: SearchFileGroup[];
+}
+/** Props for the flat-path (`glob`) shape. */
+export interface SearchPathsBlockProps extends SearchBlockCommon {
+    kind: 'paths';
+    /** The discovered paths, in the tool's result order (the retained page when `truncated`). */
+    paths: string[];
+}
+/** {@link SearchBlock} props: one card, two `kind`-discriminated shapes. */
+export type SearchBlockProps = SearchMatchesBlockProps | SearchPathsBlockProps;
+/**
+ * Render a completed search as a grouped-matches or flat-path card.
+ * @param props - see {@link SearchBlockProps}.
+ * @returns the search block element.
+ */
+export declare function SearchBlock(props: SearchBlockProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=SearchBlock.d.ts.map

package/lib/types/StateDot.d.ts

@@ -0,0 +1,18 @@
+/**
+ * State semantic: green done / amber user-attention / blue running ring /
+ * red error / grey idle for a tracked subject with nothing in progress.
+ */
+export type StateDotState = 'done' | 'warning' | 'ongoing' | 'error' | 'idle';
+/**
+ * Render a state dot.
+ * @param props.state - which of `done`, `warning`, `ongoing`, `error`, or `idle` to show.
+ * @param props.size - outer diameter in px (default 10, the figma size).
+ * @param props.className - extra class for layout placement.
+ * @returns the dot element (aria-hidden; pair with text for accessibility).
+ */
+export declare function StateDot({ state, size, className }: {
+    state: StateDotState;
+    size?: number | undefined;
+    className?: string | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=StateDot.d.ts.map

package/lib/types/Switch.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Render a toggle switch.
+ * @param props.checked - the current state; the control is fully controlled.
+ * @param props.onChange - called with the state the click asks for.
+ * @param props.label - localized accessible name, owned by the render site.
+ * @param props.disabled - whether the control refuses input; owners also set it
+ * while a write is in flight, not only when a deployment locks the toggle.
+ * @param props.title - localized hover text, typically why the toggle is locked.
+ * @param props.className - extra class for layout placement.
+ * @returns the switch element.
+ */
+export declare function Switch({ checked, onChange, label, disabled, title, className }: {
+    checked: boolean;
+    onChange: (next: boolean) => void;
+    label: string;
+    disabled?: boolean;
+    title?: string | undefined;
+    className?: string | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=Switch.d.ts.map

package/lib/types/Tag.d.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+/** Palette selector; each tone names one shipped appearance. */
+export type TagTone = 
+/** Hairline outline on tertiary text: the read-only default. */
+'outline'
+/** Inverted fill: one tag per group that names the current selection. */
+ | 'solid'
+/** Platform-gray fill: a neutral fact with no status meaning. */
+ | 'neutral'
+/** Text only, no fill: a fact stated more quietly than `neutral`. */
+ | 'quiet'
+/** Tinted green: a healthy or enabled state. */
+ | 'success'
+/** Tinted blue: informational classification, not health. */
+ | 'info'
+/** Tinted amber: attention needed, not yet a failure. */
+ | 'warning'
+/** Tinted red: a failure. */
+ | 'danger';
+/**
+ * Render a read-only tag.
+ * @param props.tone - which palette to use (default `outline`).
+ * @param props.className - extra class for layout placement.
+ * @param props.children - the localized label, owned by the render site.
+ * @returns the tag element.
+ */
+export declare function Tag({ tone, className, children }: {
+    tone?: TagTone;
+    className?: string | undefined;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=Tag.d.ts.map

package/lib/types/TerminalBlock.d.ts

@@ -0,0 +1,61 @@
+/** 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).
+ */
+export interface TerminalBlockLabels {
+    /** Status pill text for a signal-terminated command. */
+    signal: (signal: string) => string;
+    /** Status pill text for a non-zero exit code. */
+    exitCode: (exitCode: number) => string;
+    /** Run-state text while the command is still running. */
+    running: string;
+    /** Run-state text for a signal or non-zero-exit settle. */
+    failed: string;
+    /** Run-state text for a clean settle. */
+    done: string;
+    /** Copy-button idle label. */
+    copy: string;
+    /** Copy-button label during the post-copy confirmation window. */
+    copied: string;
+    /** Placeholder when a settled command produced no visible output. */
+    noOutput: string;
+    /** Collapse-toggle aria label while expanded. */
+    collapseAria: string;
+    /** Collapse-toggle text while expanded. */
+    collapse: string;
+    /** Expand-toggle aria label while capped, given the hidden line count. */
+    expandAria: (hidden: number) => string;
+    /** Expand-toggle text while capped, given the hidden line count. */
+    expand: (hidden: number) => string;
+}
+export interface TerminalBlockProps {
+    /** The command line, rendered verbatim after the prompt label. */
+    command: string;
+    /** Working directory for the prompt label; absent renders a plain `$`. */
+    cwd?: string | undefined;
+    /** Absolute home directory, so a cwd equal to it collapses to `~`; absent disables that collapse. */
+    home?: string | undefined;
+    /** The command's output text; may contain ANSI escape sequences. */
+    output?: string | undefined;
+    /** Settled exit code; a non-zero value renders the status pill. */
+    exitCode?: number | undefined;
+    /** Settled terminating signal name; any value renders the status pill, taking precedence over the exit code. */
+    signal?: string | undefined;
+    /** The command is still running: the block shows the prompt line alone. */
+    running?: boolean | undefined;
+    /** Height cap in output lines before the middle collapses (default {@link DEFAULT_TERMINAL_MAX_LINES}); Infinity disables the cap. */
+    maxLines?: number | undefined;
+    /** Extra class merged onto the wrapper (callers position; this component draws). */
+    className?: string | undefined;
+    /** Localized display copy supplied by the owning render site. */
+    labels: TerminalBlockLabels;
+}
+/**
+ * Render a shell command as a terminal surface.
+ * @param props - see {@link TerminalBlockProps}.
+ * @returns the terminal block element.
+ */
+export declare function TerminalBlock({ command, cwd, home, output, exitCode, signal, running, maxLines, className, labels, }: TerminalBlockProps): import("react").JSX.Element;
+//# sourceMappingURL=TerminalBlock.d.ts.map

package/lib/types/Toast.d.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+/**
+ * Transient top-center banner: slides in, holds at full opacity, fades out,
+ * then reports done so the owner can unmount it. Re-showing the same text
+ * restarts the cycle when the owner remounts the component (key it by a
+ * per-show sequence). Rendered through a body portal so an owner inside a
+ * 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, holdMs, onDone }: {
+    text: string;
+    icon?: ReactNode;
+    anchor?: HTMLElement | null;
+    holdMs?: number;
+    onDone: () => void;
+}): import("react").ReactPortal;
+//# sourceMappingURL=Toast.d.ts.map