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

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

@@ -1,4 +1,4 @@
-/** Shared props for every ic_ds_* icon component. */
+/** Shared props for every product icon component. */
 export interface IconProps {
     /** Square edge in px; defaults to the glyph's own drawn size. */
     size?: number | undefined;

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

@@ -0,0 +1,36 @@
+import type { IconProps } from './props.ts';
+interface WeightedArtworkProps extends IconProps {
+    strokeWidth: number;
+}
+/**
+ * Render shared new-conversation geometry for product and reference 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 globe geometry for product and link icons.
+ * @param props - Size, optional CSS class, and inherited stroke width.
+ * @returns The decorative SVG artwork.
+ */
+export declare const GlobeOutlineArtwork: ({ size, className, strokeWidth }: WeightedArtworkProps) => import("react").JSX.Element;
+/**
+ * Render shared code-bracket geometry for product and link icons.
+ * @param props - Size, optional CSS class, and inherited stroke width.
+ * @returns The decorative SVG artwork.
+ */
+export declare const CodeBracketsArtwork: ({ size, className, strokeWidth }: WeightedArtworkProps) => import("react").JSX.Element;
+/**
+ * Render shared document-browse geometry for product and reference icons.
+ * @param props - Size, optional CSS class, and inherited stroke width.
+ * @returns The decorative SVG artwork.
+ */
+export declare const BrowseOutlineArtwork: ({ size, className, strokeWidth }: WeightedArtworkProps) => import("react").JSX.Element;
+/**
+ * Render shared closed-folder geometry for product, reference, and link icons.
+ * @param props - Size, optional CSS class, and inherited stroke width.
+ * @returns The decorative SVG artwork.
+ */
+export declare const FolderCloseArtwork: ({ size, className, strokeWidth }: WeightedArtworkProps) => import("react").JSX.Element;
+export {};
+//# sourceMappingURL=shared-artwork.d.ts.map

package/lib/types/index.d.ts

@@ -1,20 +1,28 @@
 /**
  * Cordis-free React primitives styled only through `--dsw-*` tokens.
  */
+export type { CodeToolbarLabels } from './CodeToolbar.tsx';
 export { StateDot } from './StateDot.tsx';
 export type { StateDotState } from './StateDot.tsx';
 export { DisclosureRow } from './DisclosureRow.tsx';
 export type { DisclosureRowProps } from './DisclosureRow.tsx';
+export { TextShimmer } from './TextShimmer.tsx';
+export type { TextShimmerProps } from './TextShimmer.tsx';
 export { Button } from './Button.tsx';
 export type { ButtonVariant } from './Button.tsx';
 export { Pill } from './Pill.tsx';
+export { SegmentedTabs } from './SegmentedTabs.tsx';
+export type { SegmentedTab } from './SegmentedTabs.tsx';
 export { Tag } from './Tag.tsx';
 export type { TagTone } from './Tag.tsx';
+export { PathLabel } from './PathLabel.tsx';
 export { Switch } from './Switch.tsx';
+export { SegmentedControl } from './SegmentedControl.tsx';
+export type { SegmentedControlOption } from './SegmentedControl.tsx';
 export { Checkbox } from './Checkbox.tsx';
 export { Input } from './Input.tsx';
-export { Menu } from './Menu.tsx';
-export type { MenuEntry, MenuItem, MenuSeparator, MenuLabel } from './Menu.tsx';
+export { Menu, MenuItemButton } from './Menu.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';
@@ -29,9 +37,10 @@ export type { ConnectionIndicatorState } from './ConnectionIndicator.tsx';
 export { FishLogo, FISH_LOGO_PATH, FISH_LOGO_VIEWBOX } from './FishLogo.tsx';
 export { BrandWordmark } from './BrandWordmark.tsx';
 export type { BrandWordmarkProps } from './BrandWordmark.tsx';
-export { ReferenceIcon } from './ReferenceIcon.tsx';
+export { PermissionIconFullAccessMedium, PermissionIconFullAccessRegular, PermissionIconReadOnlyMedium, PermissionIconReadOnlyRegular, PermissionIconWorkspaceWriteMedium, PermissionIconWorkspaceWriteRegular, } from './PermissionIcon.tsx';
+export { ReferenceIconMedium, ReferenceIconRegular } from './ReferenceIcon.tsx';
 export type { ReferenceIconKind, ReferenceIconProps } from './ReferenceIcon.tsx';
-export { LinkIcon, classifyLinkPath } from './LinkIcon.tsx';
+export { LinkIconMedium, LinkIconRegular, classifyLinkPath } from './LinkIcon.tsx';
 export type { LinkIconKind, LinkIconProps } from './LinkIcon.tsx';
 export { FileTypeIcon, classifyFileType, fileExtension } from './FileTypeIcon.tsx';
 export type { CodeFileType, FileType, FileTypeIconProps, FileTypeKind, FileTypeProjectContext, } from './FileTypeIcon.tsx';
@@ -41,6 +50,14 @@ export type { TooltipSide } from './Tooltip.tsx';
 export { Toast } from './Toast.tsx';
 export { fileSizeText } from './file-size.ts';
 export { writeClipboard } from './clipboard.ts';
+export { SettingsForm } from './settings-form/SettingsForm.tsx';
+export type { SettingsFormLabels, SettingsFormProps } from './settings-form/SettingsForm.tsx';
+export { SettingsSecretField, SettingsValueField } from './settings-form/fields.tsx';
+export type { SettingsFieldProps } from './settings-form/fields.tsx';
+export { SettingsFormModel, settingsNumberField, settingsTextField } from './settings-form/form-model.ts';
+export type { SettingsFieldSpec, SettingsFieldState, SettingsFieldWrite, SettingsFormActions, SettingsFormPathOp, SettingsFormScope, SettingsFormScopeSnapshot, SettingsFormShell, SettingsSecretSpec, } from './settings-form/form-model.ts';
+export { CODE_HIGHLIGHT_EXTENSIONS, languageForPath, useCodeHighlighter } from './code-highlighting.ts';
+export type { CodeHighlighter, HighlightSpan } from './code-highlighting.ts';
 export { relativeTime } from './relative-time.ts';
 export { rankByName } from './rank-by-name.ts';
 export { isDarwinDesktop } from './darwin-desktop.ts';
@@ -67,4 +84,5 @@ export type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownLabels, Markdown
 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';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,5 @@
 import type { Ref } from 'react';
+import { type CodeToolbarLabels } from '../CodeToolbar.tsx';
 export interface CodeBlockProps {
     /** The source text, rendered verbatim (trailing newline trimmed for display). */
     code: string;
@@ -25,6 +26,10 @@ export interface CodeBlockProps {
     copyLabel: string;
     /** Copy-button label during the post-copy confirmation window. */
     copiedLabel: string;
+    /** Enable the shared card toolbar and spacing; omit for custom toolbar layouts. */
+    toolbarLabels?: CodeToolbarLabels | undefined;
+    /** With toolbarLabels, use the owner's wrapping preference and omit the toolbar's local wrap action. */
+    wrap?: boolean | undefined;
 }
-export declare function CodeBlock({ code, lang, streaming, className, contentRef, lineNumbers, showHeader, copyLabel, copiedLabel, }: CodeBlockProps): import("react").JSX.Element;
+export declare function CodeBlock({ code, lang, streaming, className, contentRef, lineNumbers, showHeader, copyLabel, copiedLabel, toolbarLabels, wrap, }: CodeBlockProps): import("react").JSX.Element;
 //# sourceMappingURL=CodeBlock.d.ts.map

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

@@ -17,6 +17,7 @@
  */
 import type { ReactNode } from 'react';
 import type * as Md from 'mdast';
+import type { CodeToolbarLabels } from '../CodeToolbar.tsx';
 import type { PositionedBlock } from './incremental.ts';
 /** Copy-button labels forwarded to fence CodeBlocks (this package is cordis-free, so copy arrives via props). */
 export interface MarkdownCodeLabels {
@@ -24,6 +25,8 @@ export interface MarkdownCodeLabels {
     copyLabel: string;
     /** Copy-button label during the post-copy confirmation window. */
     copiedLabel: string;
+    /** Shared card controls; omitted for custom toolbar layouts. */
+    toolbarLabels?: CodeToolbarLabels | undefined;
 }
 /** Localized chrome for a Markdown document. */
 export interface MarkdownLabels {

package/lib/types/overlay-top-margin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Overlay clearance from the window's top strip. On macOS desktop the frame
+ * publishes `--dsh-frame-top-clearance` on the root element — the constant
+ * step below the traffic-light strip, where clicks drag the window instead of
+ * the overlay. JS-clamped overlays keep at least that much air above them.
+ * Elsewhere the property is absent and the caller's own margin applies.
+ */
+/**
+ * Resolve the top margin an overlay keeps from the viewport edge.
+ * @param min - the overlay's own viewport margin in px, used as the floor.
+ * @returns the larger of `min` and the frame's published top clearance.
+ */
+export declare function overlayTopMargin(min: number): number;
+//# sourceMappingURL=overlay-top-margin.d.ts.map

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

@@ -0,0 +1,17 @@
+import type { IconProps } from './icons/props.ts';
+/** Terminal plugin artwork (prompt chevron and cursor bar). */
+export declare const PluginArtworkTerminal: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** Agent-loop plugin artwork (four leaves circling a center). */
+export declare const PluginArtworkLoop: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** Subagent plugin artwork (two stacked rounded squares); also marks every row inside a bundle. */
+export declare const PluginArtworkSubagent: ({ size, className }: IconProps) => import("react").JSX.Element;
+/**
+ * Web-search plugin artwork (conic-gradient ring and handle). SVG has no
+ * native conic gradient, so the ring clips an HTML div painted with CSS
+ * `conic-gradient` — the same emulation Figma exports; it renders inline in
+ * the browser UI but would stay empty in an `<img>` or mask context.
+ */
+export declare const PluginArtworkSearch: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** Default plugin artwork for plugins without one of their own (connector blocks and a node). */
+export declare const PluginArtworkDefault: ({ size, className }: IconProps) => import("react").JSX.Element;
+//# sourceMappingURL=plugin-artwork.d.ts.map

package/lib/types/settings-form/SettingsForm.d.ts

@@ -0,0 +1,46 @@
+/**
+ * One plugin's settings form as its page on the Plugins page shows it: the
+ * read-only notice when the deployment stores settings read-only, the
+ * plugin's controls, and the save that writes every staged edit. The page
+ * draws the plugin's title and one-liner itself.
+ *
+ * Only a save writes. Leaving the page drops every staged edit, so the form
+ * discards on unmount and offers no discard control. A form whose namespace
+ * the Host stopped serving says so in place of its controls rather than
+ * showing fields nothing would accept.
+ */
+import { type ReactNode } from 'react';
+import type { SettingsFormShell } from './form-model.ts';
+/** The copy the form frame renders, from the owning plugin's dictionary. */
+export interface SettingsFormLabels {
+    /** Shown in place of the controls while the namespace is not served. */
+    unavailable: string;
+    /** Shown over the controls while the document is read-only. */
+    readOnly: string;
+    /** Shown beside the save after a save the Host did not accept. */
+    saveFailed: string;
+    /** The save control. */
+    save: string;
+    /** The save control while a save is crossing the wire. */
+    saving: string;
+}
+/** Form chrome shared by every settings page. */
+export interface SettingsFormProps {
+    /** The frame's copy. */
+    labels: SettingsFormLabels;
+    /** The form state: availability, writability, and what a save would do. */
+    state: SettingsFormShell;
+    /** Write every staged edit. */
+    onSave: () => void;
+    /** Drop every staged edit; the form calls it when it leaves the page. */
+    onDiscard: () => void;
+    /** The plugin's controls. */
+    children: ReactNode;
+}
+/**
+ * Render one plugin's settings form.
+ * @param props - the form's copy and state, its controls, and the save and discard actions.
+ * @returns the form, or the unavailable line while the namespace is not served.
+ */
+export declare function SettingsForm(props: SettingsFormProps): import("react").JSX.Element;
+//# sourceMappingURL=SettingsForm.d.ts.map

package/lib/types/settings-form/fields.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The controls of a settings form. Each renders one field's label, its staged
+ * text, whether saving would leave an override, and — when one stands — the
+ * reset that stages a clear back to the composition layer. Nothing here
+ * writes: a control reports what the user typed, and the form's save is the
+ * single point where a draft becomes a document mutation.
+ */
+import { type ReactNode } from 'react';
+/** What every settings field control needs regardless of its value type. */
+export interface SettingsFieldProps {
+    /** Stable id associating the label with its control. */
+    id: string;
+    /** Visible label. */
+    label: string;
+    /** One-line explanation rendered under the control. */
+    hint: string;
+    /** Draft text this control renders. */
+    text: string;
+    /** True when saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+    /** True when the draft is not a value this field accepts. */
+    invalid: boolean;
+    /** Copy for the overridden badge. */
+    overriddenLabel: string;
+    /** Copy for the reset control. */
+    resetLabel: string;
+    /** Copy shown in place of the hint while the draft is invalid. */
+    invalidLabel: string;
+    /** Disables every control (read-only document, or an unavailable namespace). */
+    disabled: boolean;
+    /** Stage draft text. */
+    onEdit: (text: string) => void;
+    /** Stage a clear so the field re-inherits the composition layer. */
+    onReset: () => void;
+}
+/**
+ * A staged value field. `numeric` only hints the keypad: which drafts a field
+ * accepts is decided by its spec, so the control never silently rewrites what
+ * the user typed.
+ * @param props - the field's copy, its staged text, and the edit actions.
+ * @returns the labelled control.
+ */
+export declare function SettingsValueField(props: Omit<SettingsFieldProps, 'hint'> & {
+    /** Optional explanation shown below the input. */
+    hint?: string;
+    /** Rules disclosed by the information button beside the label. */
+    help?: {
+        label: string;
+        content: ReactNode;
+    };
+    /** Hints a numeric keypad without narrowing what the control accepts. */
+    numeric?: boolean;
+    /** Placeholder shown while the draft is empty. */
+    placeholder?: string;
+}): import("react").JSX.Element;
+/**
+ * A write-only credential control. The value never rides a response, so the
+ * control reports only whether one is configured and starts blank; a blank
+ * draft writes nothing, which keeps the stored key rather than clearing it.
+ * @param props - the field's copy, its staged text, and the configured state.
+ * @returns the labelled control.
+ */
+export declare function SettingsSecretField(props: Pick<SettingsFieldProps, 'id' | 'label' | 'hint' | 'text' | 'disabled' | 'onEdit'> & {
+    /** Whether the Host reports a configured credential for this reference. */
+    configured: boolean;
+    /** Copy describing the configured state. */
+    stateLabel: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=fields.d.ts.map

package/lib/types/settings-form/form-model.d.ts

@@ -0,0 +1,214 @@
+/**
+ * The staged form model behind a plugin's settings page.
+ *
+ * A card stages what the user types and writes it only when they save. Each
+ * settings write is a durable, revision-fenced document mutation, so a control
+ * that committed as it settled turned one edit into a write the user never
+ * asked for and could not preview; staged text makes what is on screen exactly
+ * what a save would store.
+ *
+ * A field shows its effective value — the user layer over the composition
+ * layer over the schema default — and whether the user layer carries it. That
+ * presence, not a value comparison, is what marks a field overridden: an
+ * override equal to the composition default is still an override.
+ */
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
+/** What the model reads of one Host entry's form. */
+export interface SettingsFormScopeSnapshot<T> {
+    /** `ready` while the Host serves the entry to this client; the form renders nothing otherwise. */
+    status: 'loading' | 'ready' | 'unavailable';
+    /** Last accepted schema-resolved section; undefined before the first acceptance. */
+    value: T | undefined;
+    /** Composition layer the value resolves over: what a field reverts to once cleared. */
+    base: unknown;
+    /** Raw user layer as stored; a field's PRESENCE here is what marks it overridden. */
+    user: unknown;
+    /** Whether the Host document accepts writes. */
+    writable: boolean;
+    /** Revision the snapshot was read at; a save fences its mutation with the revision its drafts started from. */
+    revision: number | undefined;
+}
+/** One path edit a save sends, as the shared configuration form's `mutate` accepts it. */
+export type SettingsFormPathOp = {
+    op: 'set';
+    path: readonly string[];
+    value: unknown;
+} | {
+    op: 'unset';
+    path: readonly string[];
+};
+/** The entry form the model stages over: the reads and the atomic write of the form `ui-settings` shares per Host entry. */
+export interface SettingsFormScope<T> {
+    /** @returns the current sync snapshot. */
+    getSnapshot(): SettingsFormScopeSnapshot<T>;
+    /**
+     * Observe snapshot replacements.
+     * @param listener - invoked after each snapshot change.
+     * @returns the disposer removing this listener.
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Apply ordered field edits in one revision-fenced write.
+     * @param ops - the edits, in staging order.
+     * @param expectedRevision - the revision the drafts were staged against, when known.
+     * @returns true for Host acceptance, false for refusal, after any recovery read.
+     */
+    mutate(ops: readonly SettingsFormPathOp[], expectedRevision?: number): Promise<boolean>;
+}
+/** The write one field's staged text performs when the card is saved. */
+export type SettingsFieldWrite = {
+    kind: 'set';
+    value: unknown;
+} | {
+    kind: 'clear';
+};
+/** How one section field converts between its stored value and its draft text. */
+export interface SettingsFieldSpec {
+    /** Field name inside the namespace section. */
+    field: string;
+    /** Render a stored value as draft text; the empty string when the section carries none. */
+    format: (value: unknown) => string;
+    /**
+     * The write this draft text stages, or undefined when the text is not a
+     * value this field accepts — which blocks the save rather than discarding it.
+     */
+    parse: (text: string) => SettingsFieldWrite | undefined;
+}
+/**
+ * A control whose value is written outside the settings section. A credential
+ * literal never rides a response, so its draft has nothing to seed from: it is
+ * blank until typed, and a blank draft writes nothing.
+ */
+export interface SettingsSecretSpec {
+    /** Field name addressing this control inside the card's form. */
+    field: string;
+    /** Write the staged text; resolves to whether the Host accepted it. */
+    write: (text: string) => Promise<boolean>;
+}
+/** One field as a card's control renders it. */
+export interface SettingsFieldState {
+    /** Draft text the control renders. */
+    text: string;
+    /**
+     * Whether saving would leave a user-layer entry for this field. A staged
+     * edit answers for itself, so the badge previews the save rather than
+     * reporting a state the pending edit already contradicts.
+     */
+    overridden: boolean;
+    /** Whether the draft is not a value this field accepts, which blocks saving. */
+    invalid: boolean;
+}
+/** Form state every plugin card shares. */
+export interface SettingsFormShell {
+    /** False while the namespace is not served to this client; the card renders nothing. */
+    available: boolean;
+    /** Whether the Host document accepts writes. */
+    writable: boolean;
+    /** Whether the form holds edits that a save would write. */
+    dirty: boolean;
+    /** Whether any staged draft is invalid, which blocks the save. */
+    invalid: boolean;
+    /** Whether a save is crossing the wire. */
+    saving: boolean;
+    /** Whether the last save did not land as staged; cleared by the next edit or save. */
+    failed: boolean;
+}
+/** The write actions every plugin card's slot entry injects. */
+export interface SettingsFormActions {
+    /** Stage draft text for one field. */
+    edit: (field: string, text: string) => void;
+    /** Stage a clear, so saving lets the field re-inherit the composition layer. */
+    resetField: (field: string) => void;
+    /** Write every staged edit, then re-seed from what the Host accepted. */
+    save: () => void;
+    /** Drop every staged edit. */
+    discard: () => void;
+}
+/**
+ * A whole-number field. An empty draft clears the field; any other draft that
+ * is not a finite number blocks the save.
+ * @param field - field name inside the namespace section.
+ * @returns the field's conversion spec.
+ */
+export declare function settingsNumberField(field: string): SettingsFieldSpec;
+/**
+ * A free-text field. An empty draft clears the field, so emptying the control
+ * and saving is the same gesture as resetting it.
+ * @param field - field name inside the namespace section.
+ * @returns the field's conversion spec.
+ */
+export declare function settingsTextField(field: string): SettingsFieldSpec;
+/**
+ * Stages one card's edits over one settings namespace and writes them on save.
+ *
+ * The form publishes through a snapshot store because slot components read
+ * through a snapshot selector, while both the scope and the local drafts
+ * change underneath; every projection is rebuilt from the two together.
+ */
+export declare class SettingsFormModel<T> {
+    private readonly scope;
+    private readonly specs;
+    private readonly secretSpecs;
+    private readonly staged;
+    private readonly listeners;
+    private baseline;
+    private readonly unsubscribe;
+    private saving;
+    private failed;
+    /**
+     * @param scope - the shared configuration form for this card's namespace.
+     * @param specs - the section fields this card edits.
+     * @param secrets - the card's write-only controls, written outside the section.
+     */
+    constructor(scope: SettingsFormScope<T>, specs: SettingsFieldSpec[], secrets?: SettingsSecretSpec[]);
+    /**
+     * Publish a projection of this form, rebuilt whenever the scope or a draft changes.
+     * @param project - build the card's state from the form's current reads.
+     * @returns the store the card's component reads through its bound selector.
+     */
+    bind<S>(project: () => S): SnapshotStore<S>;
+    /**
+     * Read the card-level state: what the Host serves, and what a save would do.
+     * @returns the form state every card shares.
+     */
+    shell(): SettingsFormShell;
+    /**
+     * Read one control's state.
+     * @param field - field name of a section field or of a write-only control.
+     * @returns the draft text, whether a save would leave an override, and whether it is invalid.
+     */
+    field(field: string): SettingsFieldState;
+    /**
+     * Build the edit, reset, save, and discard actions bound to this form.
+     * @returns the actions a card's slot entry injects.
+     */
+    actions(): SettingsFormActions;
+    /**
+     * Write every staged edit, then re-seed from what the Host accepted.
+     *
+     * The Host is the only authority on whether a value was accepted — its
+     * validators own the constraints no schema can express — so the outcome is
+     * read back from the section rather than predicted here. A save that did not
+     * land keeps its drafts, so the user can correct them instead of retyping.
+     * @returns settlement after every write and the read-back.
+     */
+    save(): Promise<void>;
+    /** Release the form's accepted-value subscription. */
+    dispose(): void;
+    /**
+     * Every staged edit a save would write. An entry whose draft is not a value
+     * its field accepts carries no write: the form is still dirty, and the save
+     * refuses rather than dropping the edit.
+     * @returns the planned writes, in the order the fields were staged.
+     */
+    private plan;
+    private stage;
+    private spec;
+    private snapshotOf;
+    private sectionValue;
+    private baseValue;
+    private userLayer;
+    private stored;
+    private publish;
+}
+//# sourceMappingURL=form-model.d.ts.map

package/lib/types/useAnchoredMaxHeight.d.ts

@@ -5,7 +5,10 @@ import type { RefObject } from 'react';
  * @param cap - design max-height in px (the clamp never exceeds it).
  * @param signal - re-measure trigger: pass the overlay's render state so anchor
  *   moves (composer growth) re-fit; resize/scroll re-fit while mounted.
+ * @param margin - viewport top margin floor in px; the frame's published top
+ *   clearance widens it. Callers under fixed chrome (the conversation header)
+ *   raise it past their chrome's height.
  * @returns the max-height to apply inline, in px.
  */
-export declare function useAnchoredMaxHeight(ref: RefObject<HTMLElement>, cap: number, signal: unknown): number;
+export declare function useAnchoredMaxHeight(ref: RefObject<HTMLElement>, cap: number, signal: unknown, margin?: number): number;
 //# sourceMappingURL=useAnchoredMaxHeight.d.ts.map

package/lib/types/useAnchoredPosition.d.ts

@@ -20,6 +20,8 @@ export interface AnchoredPositionOptions {
     panelRef: RefObject<HTMLElement | null>;
     /** Which anchor edge the panel hangs from: below it (`bottom`, the default) or above it (`top`). */
     side?: 'top' | 'bottom';
+    /** Which anchor edge the panel lines up with: its left edge (`start`, the default) or its right edge (`end`). */
+    align?: 'start' | 'end';
     /** Distance kept between the anchor edge named by `side` and the panel. */
     gap: number;
     /** Distance kept between the panel and each viewport edge. */
@@ -27,7 +29,7 @@ export interface AnchoredPositionOptions {
 }
 /**
  * Track an anchor and return the panel's fixed coordinates.
- * @param options - the open state, the two refs, the placement side, and the gap/margin distances.
+ * @param options - the open state, the two refs, the placement side and alignment, and the gap/margin distances.
  * @returns `left`/`top` for the panel, or `null` before the first measurement.
  */
 export declare function useAnchoredPosition(options: AnchoredPositionOptions): CSSProperties | null;

package/lib/types/user-text.d.ts

@@ -1,8 +1,8 @@
 /**
  * Display projection of reference forms in sent user text (bubble and queue
  * rows). The logged model text remains the single truth; this is presentation
- * only, and every part renders inline so a single-line message never breaks
- * across lines. Four decoration sources, by precedence: the wire session form
+ * only. Inline references follow the consumer's wrapping policy and keep long
+ * labels within its width. Four decoration sources, by precedence: the wire session form
  * `@[label](dsh-session:...)` folds to its label; exact session labels
  * supplied by an adjacent recall decorate their bare `@label` mention; plain
  * `@name` word-boundary tokens decorate by shape alone; and a plain `/name`

package/lib/user-text.module.css

@@ -14,10 +14,13 @@
      chip's label rode ~3px above the surrounding text in both surfaces. An
      inline chip shares the consumer's baseline by construction. */
   display: inline;
+  max-width: 100%;
   margin: 0 2px;
   color: var(--dsw-alias-state-business-primary);
   font-weight: 500;
-  white-space: nowrap;
+  white-space: inherit;
+  overflow-wrap: anywhere;
+  text-align: inherit;
 }
 
 /* Skill and command tokens read as code: the theme's code family at the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-primitives",
   "description": "Pure React atoms for the dsh web UI: controls, icons, markdown, and JSON inspectors (zero cordis)",
-  "version": "0.1.6-alpha.2",
+  "version": "0.1.7-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -47,7 +47,9 @@
     "micromark-extension-gfm": "^3.0.0",
     "micromark-util-sanitize-uri": "^2.0.1",
     "simple-icons": "16.31.0",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2"
   },
   "files": [
     "lib/index.js",
@@ -55,6 +57,6 @@
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4"
   }
 }