@songtonyli/dsh-cli 0.1.12 → 0.1.14

package/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/ConnectionIndicator.d.ts

@@ -0,0 +1,26 @@
+/** Visual state rendered by {@link ConnectionIndicator}. */
+export type ConnectionIndicatorState = 'disconnected' | 'connecting' | 'recovered';
+/**
+ * Render an inline connection-recovery control. The outage and retry-attempt
+ * states are one button whose static label already names the retry action;
+ * clicking it requests an immediate reconnect. The indicator animates in on
+ * appearance and fades out for {@link EXIT_MS} before unmounting.
+ * @param props.state - visible outage, retry-attempt, or recovered state.
+ * @param props.disconnectedLabel - localized outage text naming the retry action.
+ * @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, connectingLabel, recoveredLabel, reconnectActionLabel, restartActionLabel, onReconnect, }: {
+    state: ConnectionIndicatorState | undefined;
+    disconnectedLabel: string;
+    connectingLabel: string;
+    recoveredLabel: string;
+    reconnectActionLabel: string;
+    restartActionLabel: string;
+    onReconnect: () => void;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=ConnectionIndicator.d.ts.map

package/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/DiffBlock.d.ts

@@ -0,0 +1,52 @@
+/** Output lines shown before the height cap collapses the middle. */
+export declare const DEFAULT_DIFF_MAX_LINES = 16;
+/**
+ * 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). */
+    path: string;
+    /** Prior content including context, or `null` when no prior content is available. */
+    oldText: string | null;
+    /** Content after the change, including any shared context. */
+    newText: string;
+}
+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;
+}
+/**
+ * Count displayed additions and deletions. Exact patches exclude shared context;
+ * comparisons exceeding the edit limit count both complete fragments as replaced.
+ * Text follows {@link contentLines}'s terminator rule.
+ * @param diffs - the hunks to count.
+ * @returns the +/- totals for summaries and the card footer.
+ */
+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, labels, maxLines, className }: DiffBlockProps): import("react").JSX.Element | null;
+//# sourceMappingURL=DiffBlock.d.ts.map

package/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/DisclosureRow.d.ts

@@ -0,0 +1,29 @@
+import { type ReactNode } from 'react';
+/** Shared 24px disclosure chrome for compact flow rows. */
+export interface DisclosureRowProps {
+    icon: ReactNode;
+    title: string;
+    open: boolean;
+    expandable: boolean;
+    onToggle: () => void;
+    /** Makes the complete title row the disclosure target. */
+    expandOnRowClick?: boolean | undefined;
+    /** Replaces the collapsed icon with a chevron while the row is hovered. */
+    previewChevron?: boolean | undefined;
+    /** Keeps `collapsedContent` inline while open. */
+    keepContentWhenOpen?: boolean | undefined;
+    collapsedContent?: ReactNode;
+    children?: ReactNode;
+    className?: string | undefined;
+    rowClassName?: string | undefined;
+    leadingClassName?: string | undefined;
+    chevronClassName?: string | undefined;
+    titleClassName?: string | undefined;
+}
+/**
+ * Render one disclosure header and its controlled expanded content.
+ * @param props - Visual content, controlled state, and interaction policy.
+ * @returns the disclosure row.
+ */
+export declare function DisclosureRow({ icon, title, open, expandable, onToggle, expandOnRowClick, previewChevron, keepContentWhenOpen, collapsedContent, children, className, rowClassName, leadingClassName, chevronClassName, titleClassName, }: DisclosureRowProps): import("react").JSX.Element;
+//# sourceMappingURL=DisclosureRow.d.ts.map

package/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/FileTypeIcon.d.ts

@@ -0,0 +1,43 @@
+import type { ReactNode } from 'react';
+import { type CodeFileType, type FileTypeProjectContext } from './code-file-types.ts';
+import type { IconProps } from './icons/props.ts';
+/** File categories with distinct 28px glyphs. */
+export type FileType = CodeFileType | 'code' | 'excel' | 'folder' | 'html' | 'image' | 'markdown' | 'other' | 'pdf' | 'ppt' | 'video' | 'word';
+/** Compatibility name for consumers that pass an already resolved category. */
+export type FileTypeKind = FileType;
+type ClassifiedFileType = Exclude<FileType, 'folder'>;
+export type { CodeFileType, FileTypeProjectContext } from './code-file-types.ts';
+/** Props for {@link FileTypeIcon}: either a path to classify or an already resolved kind. */
+export type FileTypeIconProps = IconProps & ({
+    /** File path or name to classify. */
+    readonly path: string;
+    /** Optional project-file snapshot for context-sensitive code icons such as Flutter. */
+    readonly context?: FileTypeProjectContext | undefined;
+} | {
+    /** Explicit category for callers that already resolved the file type. */
+    readonly kind: FileTypeKind;
+});
+/**
+ * Extract the final suffix from a file path without changing its case.
+ * A leading dot starts a suffix, while a missing or trailing dot returns an empty string.
+ * @param path - File path or basename using either path separator.
+ * @returns The characters after the basename's final dot.
+ */
+export declare function fileExtension(path: string): string;
+/**
+ * Classify a file path or name for file-card presentation.
+ * Matching is case-insensitive and applies code filename rules before extension rules;
+ * unknown names fall back to `other`.
+ * @param path - File path or basename using either path separator.
+ * @param context - Optional project files used by context-sensitive code mappings.
+ * @returns The file's closed presentation category.
+ */
+export declare function classifyFileType(path: string, context?: FileTypeProjectContext): ClassifiedFileType;
+/**
+ * Render a decorative file-type glyph for a path or an explicitly resolved kind.
+ * @param props - Path or kind selection, optional project context, size, and CSS class.
+ * @returns The category-colored SVG; the caller owns the accessible name and may override
+ * the color through `--dsh-file-type-icon-color`.
+ */
+export declare function FileTypeIcon(props: FileTypeIconProps): ReactNode;
+//# sourceMappingURL=FileTypeIcon.d.ts.map

package/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/JsonTree.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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;
+    /** Maximum visible lines per collapsed string; defaults to 3. */
+    collapsedStringLines?: number;
+    /** Optional wrap toggle; each expansion reads the shared default without changing other open strings. */
+    stringWrapping?: {
+        /** Localized label for the wrapping toggle. */
+        label: string;
+        /** Read the wrapping preference when a string is expanded. @returns Whether to wrap long lines. */
+        getDefault: () => boolean;
+        /** Remember a user toggle for future expansions. @param wrapped - Whether to wrap long lines. */
+        setDefault: (wrapped: boolean) => void;
+    } | 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, collapsedStringLines, stringWrapping, copyable, expandTopLevel, labels, }: JsonTreeProps): import("react").JSX.Element;
+//# sourceMappingURL=JsonTree.d.ts.map

package/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/LinkIcon.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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.
+ *
+ * A `url` glyph whose destination names a well-known site is that site's own
+ * mark instead of the globe (`SiteGlyph.tsx`); every mark keeps the same
+ * currentColor-only rule.
+ */
+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;
+    /**
+     * Destination of a `url` link. A well-known site draws its own mark, so
+     * callers that know the destination should pass it; anything else keeps the
+     * globe. Other kinds ignore it — their destination is a path, not a site.
+     */
+    href?: string | undefined;
+}
+/**
+ * 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, the optional destination that can select a
+ * site mark, 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, href, size, className }: LinkIconProps): ReactNode;
+//# sourceMappingURL=LinkIcon.d.ts.map

package/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/Menu.d.ts

@@ -0,0 +1,90 @@
+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. While the list is open its keys mirror the
+ * composer's: Tab settles the focused row — from the trigger, Tab enters the
+ * list instead — and Escape or Shift+Tab close it and return focus to the
+ * anchor's first button, and selecting a row does the same — the rows unmount
+ * with the list. Only a keyboard on the trigger or inside the list is
+ * intercepted; Tab presses elsewhere on the page stay the browser's.
+ * @param props.autoFocus - focus the first item on open; the arrow keys walk the list either way.
+ * @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/node_modules/@deepseek-ai/dsh-client-ui-primitives/lib/types/Modal.d.ts

@@ -0,0 +1,36 @@
+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; while a menu is open inside the
+ * dialog, Escape belongs to that menu first.
+ * @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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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/node_modules/@deepseek-ai/dsh-client-ui-primitives/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