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

package/lib/markdown/CodeBlock.module.css

@@ -3,7 +3,7 @@
 
 .block {
   --dsl-code-block-banner-background-color: var(--dsw-alias-markdown-code-block-banner);
-  --dsl-code-block-border-radius: 12px;
+  --dsl-code-block-border-radius: var(--dsw-radius-lg);
   /* 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);

package/lib/markdown/JsonBlock.module.css

@@ -10,7 +10,7 @@
   border: none;
   background: transparent;
   cursor: pointer;
-  border-radius: 6px;
+  border-radius: var(--dsw-radius-sm);
 }
 
 .toggle:hover {
@@ -24,7 +24,7 @@
   overflow: auto;
   background: var(--dsw-alias-markdown-code-block);
   border: 0.5px solid var(--dsw-alias-border-l1);
-  border-radius: 6px;
+  border-radius: var(--dsw-radius-lg);
   font-family: var(--ds-font-family-code);
   font-size: 11px;
   line-height: 16px;

package/lib/markdown/MarkdownText.module.css

@@ -83,7 +83,7 @@
 
 .markdown a:focus-visible,
 .fileMention:focus-visible {
-  box-shadow: 0 0 0 2px var(--dsw-alias-state-business-primary);
+  box-shadow: 0 0 0 2px var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
 }
 
 /* Leading link-category glyph inside anchors, file mentions, and
@@ -169,7 +169,7 @@
   font-size: 0.875em !important;
   background-color: var(--dsw-alias-markdown-inline-code);
   border: 0.5px solid var(--dsw-alias-border-l1);
-  border-radius: 6px;
+  border-radius: var(--dsw-radius-sm);
   padding: 0 5px;
 }
 
@@ -220,7 +220,7 @@
    the sheet's link focus color. */
 .tableScroll:focus-visible {
   outline: none;
-  box-shadow: 0 0 0 2px var(--dsw-alias-state-business-primary);
+  box-shadow: 0 0 0 2px var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
 }
 
 /* Many-column tables (the renderer's `md-table-wide` hook) keep their
@@ -295,7 +295,7 @@
   max-width: 100%;
   height: auto;
   margin: 0;
-  border-radius: 8px;
+  border-radius: var(--dsw-radius-md);
   background: var(--dsw-alias-bg-base);
   object-fit: contain;
 }
@@ -386,7 +386,7 @@
   font: inherit;
   font-family: var(--ds-font-family-code);
   font-size: 1em !important;
-  border-radius: 4px;
+  border-radius: var(--dsw-radius-xs);
   padding: 0 3px;
   box-decoration-break: clone;
 }
@@ -442,3 +442,26 @@
 .compact :global(.katex-display) {
   margin: 4px 0;
 }
+
+.imageButton {
+  display: inline-block;
+  max-width: 100%;
+  padding: 0;
+  border: 0;
+  border-radius: var(--dsw-radius-sm);
+  background: transparent;
+  vertical-align: middle;
+  cursor: zoom-in;
+}
+.imageButton .image { max-width: min(100%, 640px); max-height: 360px; }
+.imageButton:focus-visible { outline: var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary)); outline-offset: 3px; }
+.previewName {
+  display: block;
+  margin-top: 8px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 18px;
+}

package/lib/settings-form/SettingsForm.module.css

@@ -32,7 +32,7 @@
 .save {
   appearance: none;
   border: 1px solid transparent;
-  border-radius: 8px;
+  border-radius: var(--dsw-radius-md);
   padding: 5px 14px;
   font: inherit;
   font-size: 13px;
@@ -48,6 +48,6 @@
 }
 
 .save:focus-visible {
-  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline: var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
   outline-offset: 1px;
 }

package/lib/settings-form/fields.module.css

@@ -47,7 +47,7 @@
   height: 24px;
   padding: 0;
   border: 0;
-  border-radius: 6px;
+  border-radius: var(--dsw-radius-sm);
   background: none;
   color: var(--dsw-alias-label-tertiary);
   cursor: pointer;
@@ -60,7 +60,7 @@
 }
 
 .helpButton:focus-visible {
-  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline: var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
   outline-offset: 1px;
 }
 
@@ -108,7 +108,7 @@
   height: 34px;
   padding: 0 12px;
   border: 0.5px solid var(--dsw-alias-border-l4);
-  border-radius: 8px;
+  border-radius: var(--dsw-radius-md);
   background: var(--dsw-alias-bg-layer-3);
   font: inherit;
   font-size: 13px;
@@ -118,7 +118,7 @@
 
 .input:focus-visible {
   outline: none;
-  border-color: var(--dsw-alias-brand-primary);
+  border-color: var(--dsw-alias-state-business-primary);
 }
 
 .input:disabled {

package/lib/types/Button.d.ts

@@ -1,18 +1,19 @@
-import type { ButtonHTMLAttributes, ReactNode } from 'react';
+import { type ButtonHTMLAttributes, type ReactNode } from 'react';
 /** Visual variant, each backed by its --dsw-alias-button-* token family. */
 export type ButtonVariant = 'primary' | 'ghost' | 'outline' | 'toolbar';
 /**
  * Render a button.
  * @param props.variant - visual family (default 'ghost').
- * @param props.size - 'md' 36px capsule (figma Button) or 'sm' 28px compact.
+ * @param props.size - 'md' 36px control with 12px corners or 'sm' 28px control with 8px corners.
  * @param props.icon - optional leading 16px icon node.
+ * @param ref - native button for focus management and overlay anchors.
  * @returns the button element; native button attributes pass through.
  */
-export declare function Button({ variant, size, icon, className, children, ...rest }: {
+export declare const Button: import("react").ForwardRefExoticComponent<{
     variant?: ButtonVariant;
-    size?: 'md' | 'sm';
+    size?: "md" | "sm";
     icon?: ReactNode;
     className?: string | undefined;
     children?: ReactNode;
-} & ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
+} & ButtonHTMLAttributes<HTMLButtonElement> & import("react").RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=Button.d.ts.map

package/lib/types/HoverCard.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode, RefObject } from 'react';
 /**
- * Render an anchor with a hover-triggered preview card.
+ * Render an anchor with a hover-triggered preview card, hidden while a tooltip within the anchor is visible.
  * @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.
@@ -8,6 +8,7 @@ import type { ReactNode, RefObject } from 'react';
  * @param props.variant - compact card beside the anchor, or a preview above/below it
  * with 24px side insets, a 420px height cap, frame-top clearance, and 100ms opacity transitions.
  * @param props.widthAnchorRef - optional element whose width and horizontal position size the preview.
+ * @param props.inline - keep the anchor in prose; show a contained preview on hover or keyboard focus.
  * @param props.disabled - suppress opening; turning true dismisses an open card.
  * @param props.copyText - optional primary value copied by activation and
  * included in the card's accessible name.
@@ -15,8 +16,10 @@ import type { ReactNode, RefObject } from 'react';
  * @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, variant, widthAnchorRef, }: {
+export declare function HoverCard({ anchor, content, openDelayMs, disabled, copyText, copyLabel, copiedLabel, variant, widthAnchorRef, inline, }: {
     anchor: ReactNode;
+    /** Inline media preview using the shared menu material and keyboard focus. */
+    inline?: boolean;
     content: ReactNode;
     openDelayMs?: number;
     disabled?: boolean;

package/lib/types/ImageLightbox.d.ts

@@ -0,0 +1,27 @@
+/** Lightbox strings the owner resolves from its own locale namespace. */
+export interface ImageLightboxLabels {
+    /** Accessible name of the preview dialog. */
+    dialog: string;
+    /** Accessible label of the close control. */
+    close: string;
+}
+/**
+ * Document-level original-image preview opened by clicking a thumbnail.
+ * Closes on Escape, backdrop press, or the close control, and restores focus
+ * to the opener on unmount. Rendered through a body portal: an opener inside
+ * a transformed or filtered ancestor would otherwise trap the fixed backdrop
+ * in that ancestor's box instead of covering the viewport.
+ *
+ * @param props.src - the original image URL.
+ * @param props.alt - the image's alt text.
+ * @param props.labels - dialog and close-control strings.
+ * @param props.onClose - dismiss callback owned by the opener.
+ * @returns the modal preview dialog.
+ */
+export declare function ImageLightbox({ src, alt, labels, onClose }: {
+    src: string;
+    alt: string;
+    labels: ImageLightboxLabels;
+    onClose: () => void;
+}): import("react").ReactPortal;
+//# sourceMappingURL=ImageLightbox.d.ts.map

package/lib/types/ImagePreview.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Render an image without introducing a second activation target.
+ * @param props - Source, accessible description, localized status.
+ * @returns A contained preview with loading or failure status.
+ */
+export declare function ImagePreview({ src, alt, loadingLabel, failedLabel }: {
+    src: string;
+    alt: string;
+    loadingLabel: string;
+    failedLabel: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ImagePreview.d.ts.map

package/lib/types/Menu.d.ts

@@ -4,6 +4,11 @@ export interface MenuItem {
     id: string;
     label: ReactNode;
     disabled?: boolean;
+    /** Effective binding supplied by the command owner; omitted for unbound actions. */
+    shortcut?: {
+        keys: readonly string[];
+        aria?: string | undefined;
+    };
     /** Leading icon (figma .Menu_cell gap 8). */
     icon?: ReactNode;
     /** Destructive row: error-colored text/icon and danger hover fill. */
@@ -28,6 +33,8 @@ export type MenuEntry = MenuItem | MenuSeparator | MenuLabel;
 export interface MenuItemButtonProps {
     /** Visible row label. */
     children: ReactNode;
+    /** Effective binding supplied by the command owner; omitted for unbound actions. */
+    shortcut?: MenuItem['shortcut'];
     /** Leading icon (figma .Menu_cell gap 8). */
     icon?: ReactNode;
     /** Whether the row cannot be activated. */
@@ -51,6 +58,7 @@ export interface MenuItemButtonProps {
  * without any shared state. Closing the menu stays the owner's decision, as
  * it is for data rows.
  * @param props.children - visible row label.
+ * @param props.shortcut - effective key labels and accessible combination.
  * @param props.icon - optional leading icon.
  * @param props.disabled - whether the row cannot be activated.
  * @param props.danger - whether to use the destructive row colors.
@@ -58,7 +66,7 @@ export interface MenuItemButtonProps {
  * @param props.onSelect - row activation callback.
  * @returns one menu-item row.
  */
-export declare function MenuItemButton({ children, icon, disabled, danger, separatorBefore, onSelect, }: MenuItemButtonProps): import("react").JSX.Element;
+export declare function MenuItemButton({ children, shortcut, icon, disabled, danger, separatorBefore, onSelect, }: MenuItemButtonProps): import("react").JSX.Element;
 /**
  * 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

package/lib/types/MenuSurface.d.ts

@@ -0,0 +1,16 @@
+/** Shared menu material and the macOS backing that lets Chromium blur transparent windows. */
+import { type ComponentPropsWithoutRef } from 'react';
+/** Menu containers preserve native div props and refs. */
+export interface MenuSurfaceProps extends ComponentPropsWithoutRef<'div'> {
+    /** Match the shared compact menu's smaller outer radius. */
+    compact?: boolean;
+}
+/**
+ * Paint a menu and, on macOS, an opaque backing behind the page content within its bounds.
+ * CSS anchors keep each backing aligned during placement, resizing, and nested-menu movement.
+ * @param props - Div content and placement, and compact geometry.
+ * @param ref - The visible menu div, excluding the non-interactive backing.
+ * @returns Menu content plus a backing portal removed with the menu.
+ */
+export declare const MenuSurface: import("react").ForwardRefExoticComponent<MenuSurfaceProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=MenuSurface.d.ts.map

package/lib/types/Modal.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import type { KeyboardEventHandler, ReactNode } from 'react';
 interface ModalBaseProps {
     open: boolean;
     onClose: () => void;
@@ -8,6 +8,9 @@ interface ModalBaseProps {
     footer?: ReactNode;
     className?: string;
     contentClassName?: string;
+    shortcutModal?: string;
+    onKeyDownCapture?: KeyboardEventHandler<HTMLDivElement>;
+    backdropBlur?: boolean;
 }
 type ModalProps = ModalBaseProps & ({
     headless: true;
@@ -19,18 +22,23 @@ type ModalProps = ModalBaseProps & ({
 /**
  * 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
+ * @param props.onClose - application close command, 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.children - dialog body; mark its initial-focus control with
+ * data-modal-autofocus instead of React autoFocus to preserve return focus.
  * @param props.footer - action row (Cancel / Create).
  * @param props.contentClassName - optional class for a scrollable content region.
+ * @param props.backdropBlur - disable when the caller already blurs the page; defaults to true.
+ * @param props.shortcutModal - command scope allowed by shortcut owners; unnamed
+ * dialogs block application commands unless their owner allows the "other" scope.
  * @param props.headless - render children directly in the card (no default
  * header/close/body chrome); mask, card, Escape, and aria-label remain.
+ * @param props.onKeyDownCapture - handle a nested dialog's keys before the document Escape listeners.
  * @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 declare function Modal({ open, onClose, title, closeLabel, description, children, footer, className, contentClassName, onKeyDownCapture, headless, backdropBlur, shortcutModal, }: ModalProps): import("react").ReactPortal | null;
 export {};
 //# sourceMappingURL=Modal.d.ts.map

package/lib/types/ShortcutKeys.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Render one command's keycaps without owning binding defaults or localized copy.
+ * @param props - effective key labels, presentation variant and optional interaction styling.
+ * @returns unboxed keys by default, or tooltip keycaps with plus-separated combinations grouped together.
+ */
+export declare function ShortcutKeys({ keys, variant, className }: {
+    keys: readonly string[];
+    variant?: 'plain' | 'tooltip';
+    className?: string | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ShortcutKeys.d.ts.map

package/lib/types/Tooltip.d.ts

@@ -1,7 +1,12 @@
-/** Anchor-preserving tooltips with optional body portals for clipping containers. */
+/** Anchor-preserving tooltips; an optional body portal escapes clipping containers and stacking contexts that cap the bubble's z-index. */
 import type { FocusEventHandler, MouseEventHandler, ReactElement, Ref } from 'react';
 /** Bubble placement relative to the anchor. */
 export type TooltipSide = 'right' | 'bottom' | 'top';
+/**
+ * Suppression channel for enclosing tooltip and hover-card anchors: a visible
+ * tooltip within an anchor withdraws the enclosing preview while its bubble is shown.
+ */
+export declare const TooltipSuppression: import("react").Context<((suppressed: boolean) => void) | null>;
 /** Props Tooltip injects into its anchor child; the child's own handlers are chained ahead of the tooltip's. */
 interface AnchorProps {
     ref?: Ref<HTMLElement> | undefined;
@@ -14,13 +19,17 @@ interface AnchorProps {
 type TooltipLabel = string | (() => string);
 /**
  * Attach a hover/focus tooltip to an anchor element.
- * @param props.label - bubble text, or a resolver evaluated only while the bubble is visible.
+ * @param props.label - bubble text, or a resolver evaluated only while visible; an empty string shows only shortcut keys.
+ * @param props.shortcutKeys - effective key labels rendered as platform-formatted keycaps after optional text.
  * @param props.side - placement relative to the anchor (default 'right').
  * @param props.align - horizontal anchor-edge alignment for 'bottom'/'top' bubbles: 'end' pins
  * the bubble's right edge to the anchor's (for anchors beside other hover surfaces the centered
  * bubble would overlap); default 'center'. Ignored for side 'right'.
- * @param props.portal - render the bubble under document.body to escape containing blocks and clipping ancestors.
+ * @param props.portal - render the bubble under document.body, so an ancestor's clipping or its
+ * stacking context (which confines the bubble's z-index to that context) cannot hide it.
  * @param props.delayMs - hover delay in milliseconds; keyboard focus remains immediate.
+ * @param props.gap - anchor-to-bubble distance in pixels for 'bottom'/'top' bubbles (default 8);
+ * ignored for side 'right'.
  * @param props.disabled - suppress the bubble while true; the anchor renders identically so
  * toggling never remounts it (which would cut its CSS transitions).
  * @param props.maxWidth - bubble width cap in pixels, for labels long enough that the default
@@ -31,11 +40,13 @@ type TooltipLabel = string | (() => string);
  * anchor dismisses the bubble until the next trigger, and focus arriving after a pointer
  * interaction (a closing menu refocusing its trigger) never raises it.
  */
-export declare function Tooltip({ label, side, align, delayMs, disabled, portal, maxWidth, children }: {
+export declare function Tooltip({ label, shortcutKeys, side, align, delayMs, gap, disabled, portal, maxWidth, children }: {
     label: TooltipLabel;
+    shortcutKeys?: readonly string[] | undefined;
     side?: TooltipSide;
     align?: 'center' | 'end';
     delayMs?: number;
+    gap?: number;
     disabled?: boolean;
     portal?: boolean;
     maxWidth?: number;

package/lib/types/code-highlighting.d.ts

@@ -1,12 +1,5 @@
 import { type HighlightSpan } from './markdown/highlight.ts';
-/** Recognized filename suffixes whose source can use the shared syntax highlighter. */
-export declare const CODE_HIGHLIGHT_EXTENSIONS: readonly string[];
-/**
- * Select the shared syntax highlighter's grammar from a filename.
- * @param path - decoded source filename or path.
- * @returns a supported grammar hint, or `undefined` for other suffixes.
- */
-export declare function languageForPath(path: string): string | undefined;
+export { CODE_HIGHLIGHT_EXTENSIONS, languageForPath } from '@deepseek-ai/dsh-util-code-language';
 /** Highlight one source fragment into one token list per line. */
 export type CodeHighlighter = (code: string) => HighlightSpan[][] | undefined;
 /**

package/lib/types/focus.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Focus an automatic destination without a focus outline until keyboard navigation or blur.
+ * The theme suppresses outlines while data-dsh-automatic-focus is present; borders and shadows remain intact.
+ * Tab and directional navigation restore normal focus styling.
+ * @param element - control or container receiving automatic focus.
+ * @param options - browser focus options, including scroll preservation.
+ */
+export declare function focusWithoutRing(element: HTMLElement, options?: FocusOptions): void;
+//# sourceMappingURL=focus.d.ts.map

package/lib/types/guide-artwork.d.ts

@@ -0,0 +1,15 @@
+/** Fixed-palette artwork for sidebar guide entries. */
+import type { IconProps } from './icons/props.ts';
+/**
+ * Render fixed-palette artwork for a sidebar guide entry.
+ * @param props - canvas size and layout class supplied by the guide.
+ * @returns an ornamental SVG hidden from assistive technology.
+ */
+export declare function GuideArtworkBrowser({ size, className }: IconProps): import("react").JSX.Element;
+/**
+ * Render fixed-palette artwork for a sidebar guide entry.
+ * @param props - canvas size and layout class supplied by the guide.
+ * @returns an ornamental SVG hidden from assistive technology.
+ */
+export declare function GuideArtworkFiles({ size, className }: IconProps): import("react").JSX.Element;
+//# sourceMappingURL=guide-artwork.d.ts.map

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

@@ -1,7 +1,3 @@
-/**
- * Shared current-color product icons. Names identify the glyph and weight;
- * rendered size remains a prop instead of part of the component name.
- */
 import type { IconProps } from './props.ts';
 export type { IconProps } from './props.ts';
 /** Shared shield contour used by composite icons outside this module. */
@@ -162,6 +158,10 @@ export declare const IconWarningTriangleOutlineMedium: (props: IconProps) => imp
 export declare const IconUserOutlineRegular: (props: IconProps) => import("react").JSX.Element;
 /** Medium IconUserOutline artwork with a 1.3px stroke. */
 export declare const IconUserOutlineMedium: (props: IconProps) => import("react").JSX.Element;
+/** Regular one-pixel IconUsersOutline artwork: a front person with a second person behind. */
+export declare const IconUsersOutlineRegular: (props: IconProps) => import("react").JSX.Element;
+/** Medium IconUsersOutline artwork with a 1.3px stroke. */
+export declare const IconUsersOutlineMedium: (props: IconProps) => import("react").JSX.Element;
 /** Regular one-pixel IconPaperPlaneOutline artwork. */
 export declare const IconPaperPlaneOutlineRegular: (props: IconProps) => import("react").JSX.Element;
 /** Medium IconPaperPlaneOutline artwork with a 1.3px stroke. */
@@ -366,6 +366,10 @@ export declare const IconWorkspaceTreeOutlineMedium: (props: IconProps) => impor
 export declare const IconChevronsUpDownOutlineRegular: (props: IconProps) => import("react").JSX.Element;
 /** Medium IconChevronsUpDownOutline artwork with a 1.3px stroke. */
 export declare const IconChevronsUpDownOutlineMedium: (props: IconProps) => import("react").JSX.Element;
+/** Regular one-pixel IconArchiveOffOutline artwork. */
+export declare const IconArchiveOffOutlineRegular: (props: IconProps) => import("react").JSX.Element;
+/** Medium IconArchiveOffOutline artwork with a 1.3px stroke. */
+export declare const IconArchiveOffOutlineMedium: (props: IconProps) => import("react").JSX.Element;
 /** Regular one-pixel IconArchiveCheckOutline artwork. */
 export declare const IconArchiveCheckOutlineRegular: (props: IconProps) => import("react").JSX.Element;
 /** Medium IconArchiveCheckOutline artwork with a 1.3px stroke. */

package/lib/types/icons/shared-artwork.d.ts

@@ -3,11 +3,18 @@ interface WeightedArtworkProps extends IconProps {
     strokeWidth: number;
 }
 /**
- * Render shared new-conversation geometry for product and reference icons.
+ * Render new-conversation geometry — the bubble around a plus — for product icons.
  * @param props - Size, optional CSS class, and inherited stroke width.
  * @returns The decorative SVG artwork.
  */
 export declare const NewChatOutlineArtwork: ({ size, className, strokeWidth }: WeightedArtworkProps) => import("react").JSX.Element;
+/**
+ * Render shared conversation geometry — the chat bubble around two text
+ * lines — for the queue product icon and session reference icons.
+ * @param props - Size, optional CSS class, and inherited stroke width.
+ * @returns The decorative SVG artwork.
+ */
+export declare const ChatLinesOutlineArtwork: ({ size, className, strokeWidth }: WeightedArtworkProps) => import("react").JSX.Element;
 /**
  * Render shared globe geometry for product and link icons.
  * @param props - Size, optional CSS class, and inherited stroke width.

package/lib/types/index.d.ts

@@ -22,14 +22,19 @@ export type { SegmentedControlOption } from './SegmentedControl.tsx';
 export { Checkbox } from './Checkbox.tsx';
 export { Input } from './Input.tsx';
 export { Menu, MenuItemButton } from './Menu.tsx';
+export { MenuSurface } from './MenuSurface.tsx';
+export type { MenuSurfaceProps } from './MenuSurface.tsx';
 export type { MenuItemButtonProps, MenuEntry, MenuItem, MenuSeparator, MenuLabel } from './Menu.tsx';
 export { useAnchoredMaxHeight } from './useAnchoredMaxHeight.ts';
 export { useAnchoredPosition } from './useAnchoredPosition.ts';
 export type { AnchoredPositionOptions } from './useAnchoredPosition.ts';
 export { useDismissOnOutsidePointer } from './useDismissOnOutsidePointer.ts';
 export { HoverCard } from './HoverCard.tsx';
+export { ShortcutKeys } from './ShortcutKeys.tsx';
+export { observeComposition } from './keyboard-composition.ts';
+export { focusWithoutRing } from './focus.ts';
+export { closeTopModal, isBehindModal, modalSelector, useModalLayer } from './useModalLayer.ts';
 export { Modal } from './Modal.tsx';
-export { OnboardingSurface } from './OnboardingSurface.tsx';
 export { RiskConfirmation } from './RiskConfirmation.tsx';
 export type { RiskConfirmationProps } from './RiskConfirmation.tsx';
 export { ConnectionIndicator } from './ConnectionIndicator.tsx';
@@ -85,4 +90,7 @@ export { extractMarkdownPlainText } from './markdown/plain-text.ts';
 export type { MarkdownPlainTextMode, MarkdownPlainTextOptions } from './markdown/plain-text.ts';
 export * from './icons/index.tsx';
 export { PluginArtworkTerminal, PluginArtworkLoop, PluginArtworkSubagent, PluginArtworkSearch, PluginArtworkDefault, } from './plugin-artwork.tsx';
+export { GuideArtworkBrowser, GuideArtworkFiles } from './guide-artwork.tsx';
+export { ImageLightbox } from './ImageLightbox.tsx';
+export type { ImageLightboxLabels } from './ImageLightbox.tsx';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/input-modality.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Document-wide input tracking shared by tooltips and focus-ring styles.
+ * Tooltips follow the last input; rings follow navigation or a key followed by
+ * focus on a different control. Modifiers and refocusing alone keep rings silent.
+ * Module-level listeners live for the document lifetime; Node imports are inert.
+ */
+/** Modality values published on the document element. */
+export declare const INPUT_MODALITY: {
+    readonly pointer: "pointer";
+    readonly keyboard: "keyboard";
+};
+/** Attribute carrying whether focus navigation last owned focus. */
+export declare const INPUT_MODALITY_ATTRIBUTE = "data-input-modality";
+/**
+ * Whether the last input came from a pointer, independently of ring visibility.
+ * @returns True after pointer input; false after any key.
+ */
+export declare function pointerModality(): boolean;
+//# sourceMappingURL=input-modality.d.ts.map

package/lib/types/keyboard-composition.d.ts

@@ -0,0 +1,11 @@
+/** Composition lifetime for local keyboard handlers, including a late closing keydown. */
+/**
+ * Observe composition until its closing key is released or consumed.
+ * @param document - document whose input events belong to the caller.
+ * @returns an event guard and a disposer for all listeners.
+ */
+export declare function observeComposition(document: Document): {
+    guards(event: KeyboardEvent): boolean;
+    dispose(): void;
+};
+//# sourceMappingURL=keyboard-composition.d.ts.map

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

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { ImageLightboxLabels } from '../ImageLightbox.tsx';
 /**
  * Handle one sanitized absolute HTTP(S) URL selected from Markdown.
  * @param href - destination URL.
@@ -6,6 +7,15 @@ import type { ReactNode } from 'react';
 export type MarkdownExternalLinkHandler = (href: string) => void;
 /** Navigation capabilities supplied by the nearest Markdown owner. */
 export interface MarkdownDelegate {
+    /** Image previews for decoded local paths in this owner's workspace. */
+    readonly fileImages?: {
+        resolve: (path: string) => string | undefined;
+        labels: ImageLightboxLabels & {
+            open: string;
+            loading: string;
+            failed: string;
+        };
+    } | undefined;
     /** Ordinary HTTP(S) activation; absent handlers retain native anchor behavior. */
     readonly openExternalLink?: MarkdownExternalLinkHandler | undefined;
     /**
@@ -27,7 +37,7 @@ export interface MarkdownDelegateProviderProps extends MarkdownDelegate {
  * @param props - Child tree and its file and HTTP(S) link handlers.
  * @returns the scoped child tree.
  */
-export declare function MarkdownDelegateProvider({ children, openExternalLink, openFile, }: MarkdownDelegateProviderProps): ReactNode;
+export declare function MarkdownDelegateProvider({ children, openExternalLink, openFile, fileImages, }: MarkdownDelegateProviderProps): ReactNode;
 /**
  * Read the nearest Markdown navigation capabilities.
  * @returns Owner callbacks, or an empty delegate outside a provider.

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

@@ -6,18 +6,24 @@
  * dark blocks), never here — the repo's tokens-only styling rule.
  *
  * Only the three markdown-fence and `run_code` grammars (TypeScript, shell,
- * JSON) load into the singleton at boot — the set every session renders. The
- * read card's wider extension set (the file-extension language hints the read
- * tool's `langFromPath` emits — `packages/fs/tool-fs`: python, rust, yaml,
- * markup, …) is imported lazily and registered the first time such a language
- * is requested, so a session that never opens a read card in one of those
- * languages pays neither the ~1.6 MB of grammar modules nor their synchronous
- * init. The first render of a lazy language falls back to plain text while its
- * grammar loads, then {@link onGrammarLoaded} notifies subscribers to re-render
- * with highlighting. An unknown or absent language falls back to plain text (no
- * highlighting, still monospace) — never an error.
+ * JSON) load into the singleton at boot — the set every session renders. Every
+ * other language in the shared extension table
+ * (`@deepseek-ai/dsh-util-code-language`: python, rust, yaml, markup, …) is
+ * imported lazily and registered the first time such a language is requested,
+ * so a session that never opens a code surface in one of those languages pays
+ * neither the grammar modules nor their synchronous init. The first render of a
+ * lazy language falls back to plain text while its grammar loads, then
+ * {@link onGrammarLoaded} notifies subscribers to re-render with highlighting.
+ * An unknown or absent language falls back to plain text (no highlighting, still
+ * monospace) — never an error.
  */
 import type { CSSProperties } from 'react';
+/**
+ * Resolve a language hint to the grammar id {@link LANG_ALIASES} selects.
+ * @param lang - Language hint from a code surface: a canonical grammar id or the read card's persisted short id.
+ * @returns The resolved grammar id, or `undefined` when the table aliases no grammar.
+ */
+export declare function grammarForHint(lang: string | undefined): string | undefined;
 /**
  * Whether a language hint can use the shared syntax highlighter.
  * @param lang - Language hint from a code surface.

package/lib/types/markdown/local-image-syntax.d.ts

@@ -0,0 +1,10 @@
+/** Recover standalone local image references with bare spaces without changing code or source offsets. */
+import type { Root } from 'mdast';
+/**
+ * Recover only unambiguous, unescaped image-only paragraphs containing a local path with spaces.
+ * @param root - Parsed Markdown tree, modified in place.
+ * @param source - Original source used to distinguish authored syntax from escaped examples.
+ * @returns The same root with recovered image nodes.
+ */
+export declare function recoverLocalImages(root: Root, source: string): Root;
+//# sourceMappingURL=local-image-syntax.d.ts.map