@seekbuddy/dsh-ui 0.2.0-beta.0 → 0.2.0-beta.1

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

@@ -3,38 +3,32 @@ interface WeightedArtworkProps extends IconProps {
     strokeWidth: number;
 }
 /**
- * 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.
+ * Render conversation geometry — the chat bubble around two text lines —
+ * for session reference icons; it matches the `queue-outline` product glyph.
  * @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.
+ * Render globe geometry for link icons; it matches the `globe-outline` product glyph.
  * @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.
+ * Render code-bracket geometry for link icons; it matches the `inspect-outline` product glyph.
  * @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.
+ * Render document-browse geometry for reference icons; it matches the `browse-outline` product glyph.
  * @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.
+ * Render closed-folder geometry for reference and link icons; it matches the `folder-close` product glyph.
  * @param props - Size, optional CSS class, and inherited stroke width.
  * @returns The decorative SVG artwork.
  */

package/dist/types/icons.d.ts

@@ -1,5 +1,5 @@
 export * from './icons/index.js';
-export { PermissionIconFullAccessMedium, PermissionIconFullAccessRegular, PermissionIconReadOnlyMedium, PermissionIconReadOnlyRegular, PermissionIconWorkspaceWriteMedium, PermissionIconWorkspaceWriteRegular, } from './PermissionIcon.js';
+export { PermissionIconAutoReviewMedium, PermissionIconAutoReviewRegular, PermissionIconFullAccessMedium, PermissionIconFullAccessRegular, PermissionIconReadOnlyMedium, PermissionIconReadOnlyRegular, PermissionIconWorkspaceWriteMedium, PermissionIconWorkspaceWriteRegular, } from './PermissionIcon.js';
 export { ReferenceIconMedium, ReferenceIconRegular } from './ReferenceIcon.js';
 export type { ReferenceIconKind, ReferenceIconProps } from './ReferenceIcon.js';
 export { PluginArtworkTerminal, PluginArtworkLoop, PluginArtworkSubagent, PluginArtworkSearch, PluginArtworkDefault, } from './plugin-artwork.js';

package/dist/types/image-drag.d.ts

@@ -0,0 +1,16 @@
+/** Image gestures delegate file preparation and transport to the owning feature. */
+import { type ImgHTMLAttributes } from 'react';
+import type { FileDragActions } from './file-drag-actions.js';
+type ImageGestures = Required<Pick<ImgHTMLAttributes<HTMLImageElement>, 'onPointerEnter' | 'onPointerDown' | 'onPointerLeave' | 'onDragStart' | 'onDragEnd' | 'onClickCapture'>>;
+/**
+ * Prepare resource-backed images on primary press, other images also on hover; release on leave.
+ * Releasing inside the image retains preparation for the next gesture; cancelled drags never start late.
+ * @param actions - stable file preparation and error callbacks.
+ * @param src - displayed image URL.
+ * @param name - proposed export name.
+ * @param original - already loaded original bytes.
+ * @param resourceAddress - verifiable reference to an unmodified local original.
+ * @returns image gesture handlers; overflowing images remain owned by their pan handler.
+ */
+export declare function useImageDrag(actions: FileDragActions, src: string, name: string, original?: File, resourceAddress?: string): ImageGestures;
+export {};

package/dist/types/index.d.ts

@@ -20,7 +20,7 @@ export type { SegmentedControlOption } from './SegmentedControl.js';
 export { Checkbox } from './Checkbox.js';
 export { Input } from './Input.js';
 export { Menu, MenuItemButton } from './Menu.js';
-export { MenuSurface } from './MenuSurface.js';
+export { MenuSurface, MENU_TRANSITION_MS } from './MenuSurface.js';
 export type { MenuSurfaceProps } from './MenuSurface.js';
 export { MenuGroup, observeStickyMenuGroups } from './MenuGroup.js';
 export type { MenuItemButtonProps, MenuEntry, MenuItem, MenuSeparator, MenuLabel } from './Menu.js';
@@ -29,16 +29,32 @@ export { useAnchoredPosition } from './useAnchoredPosition.js';
 export type { AnchoredPositionOptions } from './useAnchoredPosition.js';
 export { useDismissOnOutsidePointer } from './useDismissOnOutsidePointer.js';
 export { HoverCard } from './HoverCard.js';
+export { HoverCardGroup } from './HoverCardGroup.js';
 export { ShortcutKeys } from './ShortcutKeys.js';
 export { observeComposition } from './keyboard-composition.js';
-export { focusWithoutRing } from './focus.js';
+export { focusWithoutRing, isMobileDevice } from './focus.js';
 export { closeTopModal, isBehindModal, modalSelector, useModalLayer } from './useModalLayer.js';
 export { Modal } from './Modal.js';
 export { RiskConfirmation } from './RiskConfirmation.js';
 export type { RiskConfirmationProps } from './RiskConfirmation.js';
 export { ConnectionIndicator } from './ConnectionIndicator.js';
 export type { ConnectionIndicatorState } from './ConnectionIndicator.js';
-export { projectUserText, type UserTextReferences } from './user-text.js';
+export { UserTextRun, ReferenceChip, type UserTextRunProps, type ReferenceChipProps } from './user-text.js';
+export { UserMessageBubble } from './UserMessageBubble.js';
+export type { UserMessageBubbleProps } from './UserMessageBubble.js';
+export { AnimatedRows } from './AnimatedRows.js';
+export type { AnimatedRowsProps } from './AnimatedRows.js';
+export { useRowDragPreview } from './useRowDragPreview.js';
+export { ZoomControls } from './ZoomControls.js';
+export type { ZoomControlsHandle } from './ZoomControls.js';
+export { DOCUMENT_ZOOM } from './document-zoom.js';
+export type { DocumentZoomLabels } from './document-zoom.js';
+export { InlineEditor } from './InlineEditor.js';
+export type { FileDragActions, FileDragSource, PreparedFileDrag } from './file-drag-actions.js';
+export { DraggableImage } from './DraggableImage.js';
+export type { DraggableImageProps } from './DraggableImage.js';
+export { QuotePreview } from './QuotePreview.js';
+export type { QuotePreviewProps, QuotePreviewRemoval } from './QuotePreview.js';
 export { Tooltip } from './Tooltip.js';
 export type { TooltipSide } from './Tooltip.js';
 export { pointerModality } from './input-modality.js';
@@ -47,6 +63,8 @@ export { ImageLightbox } from './ImageLightbox.js';
 export type { ImageLightboxLabels } from './ImageLightbox.js';
 export { fileSizeText } from './file-size.js';
 export { writeClipboard } from './clipboard.js';
+export { useClipboardCopy } from './use-clipboard-copy.js';
+export type { ClipboardCopyState } from './use-clipboard-copy.js';
 export { relativeTime } from './relative-time.js';
 export { rankByName } from './rank-by-name.js';
 export { isDarwinDesktop } from './darwin-desktop.js';

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

@@ -1,15 +1,38 @@
-import type { ReactNode } from 'react';
+import type { HTMLAttributes, ReactNode } from 'react';
+import type { FileDragActions } from '../file-drag-actions.js';
 import type { ImageLightboxLabels } from '../ImageLightbox.js';
 /**
  * Handle one sanitized absolute HTTP(S) URL selected from Markdown.
  * @param href - destination URL.
  */
 export type MarkdownExternalLinkHandler = (href: string) => void;
+/** Explicit object and viewport coordinates from the element owning a context gesture. */
+export type MarkdownMenuTarget = {
+    kind: 'file';
+    path: string;
+    line?: number;
+} | {
+    kind: 'url';
+    url: string;
+} | {
+    kind: 'image';
+    url: string;
+    path?: string;
+    name?: string;
+    mediaType?: string;
+};
 /** Navigation capabilities supplied by the nearest Markdown owner. */
 export interface MarkdownDelegate {
-    /** Image previews for decoded local paths in this owner's workspace. */
+    /** Open an object menu without executing its normal activation. */
+    readonly getTriggerProps?: ((target: MarkdownMenuTarget) => Pick<HTMLAttributes<HTMLElement>, 'onContextMenu' | 'onKeyDown' | 'tabIndex'>) | undefined;
+    /**
+     * Image previews for decoded local paths in this owner's workspace. The renderer
+     * appends a per-mount `load` query parameter to `api/file` route URLs.
+     */
     readonly fileImages?: {
+        fileDrag: FileDragActions;
         resolve: (path: string) => string | undefined;
+        resourceAddress?: ((path: string) => string) | undefined;
         labels: ImageLightboxLabels & {
             open: string;
             loading: string;
@@ -37,7 +60,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, fileImages, }: MarkdownDelegateProviderProps): ReactNode;
+export declare function MarkdownDelegateProvider({ children, openExternalLink, openFile, fileImages, getTriggerProps, }: MarkdownDelegateProviderProps): ReactNode;
 /**
  * Read the nearest Markdown navigation capabilities.
  * @returns Owner callbacks, or an empty delegate outside a provider.

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

@@ -30,18 +30,25 @@ export type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownLabels, Markdown
  * `MarkdownDelegateProvider` can delegate ordinary HTTP(S) activation while
  * modified clicks retain native behavior. `variant="compact"` uses secondary
  * text sizing, uniform bold headings, and tight block spacing; the default
- * `body` variant uses the full document typography.
+ * `body` variant uses the full document typography. `omitHtml` renders raw
+ * HTML as nothing instead of literal text, for documents written for HTML
+ * renderers, such as package READMEs. `textInteractionSource` marks the
+ * existing root as a source for text selection interactions.
  * The provider's `openFile` enables local Markdown links in settled messages,
- * including `#L24` and `#L24-L30` destinations (ranges open at their first line).
- * @returns A GFM document with TeX math rendered through KaTeX; raw HTML and
- * unsafe protocols are disabled. Local links without an opener remain text;
+ * including `#L24` / `#L24-L30` fragments and `:24` / `:24-30` / `:24:5` suffixes
+ * (ranges open at their first line, columns are ignored, and invalid locations
+ * open only the file; see the README for URL/path classification).
+ * @returns A GFM document with TeX math rendered through KaTeX; raw HTML never
+ * renders as markup, and unsafe protocols are disabled. Local links without an opener remain text;
  * absolute HTTP(S) images render directly.
  */
-export declare const MarkdownText: import("react").MemoExoticComponent<({ text, streaming, labels, fileMentions, pathImages, variant, }: {
+export declare const MarkdownText: import("react").MemoExoticComponent<({ text, streaming, labels, fileMentions, pathImages, variant, omitHtml, textInteractionSource, }: {
     text: string;
     streaming?: boolean;
     labels: MarkdownLabels;
     fileMentions?: MarkdownFileMentions | undefined;
     pathImages?: MarkdownPathImages | undefined;
     variant?: 'body' | 'compact';
+    omitHtml?: boolean;
+    textInteractionSource?: boolean;
 }) => import("react").JSX.Element>;

package/dist/types/markdown/file-link.d.ts

@@ -1,10 +1,20 @@
 /** Local Markdown destinations accepted by the file-preview callback. */
 /**
- * Decode a file destination and its optional GitHub-style line fragment.
- * Literal `?` and `#` in filenames must be percent-encoded.
+ * Recognize a relative, rooted, or absolute Windows path before URL parsing.
+ * @param value - A decoded or URI-normalized destination.
+ * @returns Whether a filesystem prefix makes the destination unambiguous.
+ */
+export declare function isExplicitFilePath(value: string): boolean;
+/**
+ * Decode a file destination with a fragment, line range, or line/column suffix.
+ * Explicit relative, slash/backslash-rooted, and Windows drive paths take
+ * precedence over URLs. Other parseable absolute URLs are not file links.
+ * Fragments take precedence over colon suffixes; invalid locations open the
+ * file without selecting a line. Columns are consumed but not selected.
+ * Percent-encode literal `?`, `#`, and numeric colon suffixes in filenames.
  * @param value - Parsed Markdown link destination.
  * @returns A local path and optional first line, or undefined for URLs,
- * fragment-only links, queries, malformed escapes, or invalid line ranges.
+ * fragment-only links, queries, malformed escapes, or control characters.
  */
 export declare function parseFileLink(value: string): {
     path: string;

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

@@ -17,7 +17,28 @@
  * An unknown or absent language falls back to plain text (no highlighting, still
  * monospace) — never an error.
  */
+import langTs from '@shikijs/langs/typescript';
 import type { CSSProperties } from 'react';
+/** A shiki grammar module's default export (a `LanguageRegistration[]`), taken
+ *  from a boot grammar so no direct `@shikijs/types` dependency is needed. */
+type LangModule = {
+    default: typeof langTs;
+};
+/**
+ * Replace the Go grammar's repeated one-line struct-field rule with the rule
+ * worlpaker/go-syntax merged in 4a9b120a52c (https://github.com/worlpaker/go-syntax/pull/25):
+ * the repeated rule backtracks exponentially on lines such as a brace-bearing
+ * comment after `struct {`. Delete this patch once `@shikijs/langs` ships that
+ * commit; 4.5.0 does not. The rule is located as the only rule in
+ * `struct_variables_types_fields` containing the field-token literal below,
+ * taken from `@shikijs/langs` 4.4.3.
+ * @param grammars - the `@shikijs/langs/go` default export, left unmodified.
+ * @returns copies of `grammars` with that rule's match replaced in the `go` grammar.
+ * @throws When the module has no `go` grammar, the grammar lacks
+ * `struct_variables_types_fields`, or that entry has no or several such rules.
+ * The lazy load then rejects unhandled and Go code renders as plain text.
+ */
+export declare function patchGoGrammar(grammars: LangModule['default']): LangModule['default'];
 /**
  * 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.
@@ -145,3 +166,4 @@ export interface StreamingHighlightFrame {
  * @returns one entry per source line (each an array of runs), or `undefined` for unknown or not-yet-loaded languages.
  */
 export declare function highlightLines(code: string, lang: string | undefined): HighlightSpan[][] | undefined;
+export {};

package/dist/types/markdown/quote-text.d.ts

@@ -0,0 +1,7 @@
+/** Shared Markdown blockquote formatting for browser text. */
+/**
+ * Project selected visible text as an ordinary Markdown blockquote.
+ * @param text - selected visible text without quote markers.
+ * @returns one `> `-prefixed line per normalized input line.
+ */
+export declare function formatQuoteText(text: string): string;

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

@@ -4,17 +4,18 @@
  * cache frozen blocks as React elements; the rendered DOM is pinned
  * byte-for-byte by `tests/fixtures/markdown-dom` and must not drift.
  *
- * External link and image destinations pass a protocol allowlist; settled
+ * External links reject executable and embedded-document protocols; settled
  * local file links use an explicit owner callback. Images additionally require
  * absolute HTTP(S), raw HTML renders as literal text (no HTML enters the
- * DOM), and KaTeX runs without trusted commands. Fragment-anchor URLs fail
- * the allowlist, so footnote references and back-references render as plain
+ * DOM), and KaTeX runs without trusted commands. Fragment-only URLs are not
+ * absolute, so footnote references and back-references render as plain
  * text rather than in-page links.
  *
  * Merge-extensible node unions fall through the documented default (render
  * nothing) rather than ending in assertNever: grammars registered elsewhere
  * may add node types this renderer has no mapping for.
  */
+import type { HTMLAttributes } from 'react';
 import type { ReactNode } from 'react';
 import type * as Md from 'mdast';
 import type { CodeToolbarLabels } from '../CodeToolbar.js';
@@ -65,7 +66,8 @@ export interface MarkdownPathImages {
      * Resolve one authored image destination.
      * @param value - The destination exactly as the markdown author wrote it.
      * @returns A displayable absolute URL, or undefined when the destination
-     * names no displayable image — it then stays inert alt text.
+     * names no displayable image — it then stays inert alt text. The renderer
+     * appends a per-mount `load` query parameter to `api/file` route results.
      */
     resolve(value: string): string | undefined;
 }
@@ -83,6 +85,7 @@ export interface MarkdownFileMentions {
      */
     resolve(value: string): {
         open: () => void;
+        contextMenuProps?: Pick<HTMLAttributes<HTMLElement>, 'onContextMenu' | 'onKeyDown' | 'tabIndex'>;
         label: string;
         title: string;
     } | undefined;
@@ -102,6 +105,8 @@ export interface MarkdownRenderContext {
     readonly fileMentions: MarkdownFileMentions | undefined;
     /** Local-path image vocabulary; absent wherever no rewriting owner exists. */
     readonly pathImages: MarkdownPathImages | undefined;
+    /** Raw HTML renders nothing instead of literal text. */
+    readonly omitHtml: boolean;
     /** Inside an anchor's children: interactive mentions must not nest there. */
     readonly inLink?: boolean;
     /** Reference targets visible to this pass. */

package/dist/types/markdown/windows-path-destinations.d.ts

@@ -0,0 +1,10 @@
+import type { Extension } from 'mdast-util-from-markdown';
+/**
+ * CommonMark reads `\.` or `\_` in a destination as an escaped character, so
+ * `D:\repo\.github` would parse as `D:\repo.github`. For a destination that
+ * is a Windows path, this `fromMarkdown` extension keeps every backslash
+ * literally, including one before punctuation such as `\(`, while character
+ * references such as `&` still decode; other destinations parse unchanged.
+ * @returns The mdast extension.
+ */
+export declare function windowsPathDestinations(): Extension;

package/dist/types/markdown.d.ts

@@ -1,9 +1,12 @@
 export { CodeBlock } from './markdown/CodeBlock.js';
 export type { CodeBlockProps } from './markdown/CodeBlock.js';
 export { JsonBlock } from './markdown/JsonBlock.js';
-export { MarkdownDelegateProvider } from './markdown/MarkdownDelegate.js';
-export type { MarkdownDelegate, MarkdownDelegateProviderProps, MarkdownExternalLinkHandler, } from './markdown/MarkdownDelegate.js';
+export { MarkdownDelegateProvider, useMarkdownDelegate } from './markdown/MarkdownDelegate.js';
+export type { MarkdownMenuTarget, MarkdownDelegate, MarkdownDelegateProviderProps, MarkdownExternalLinkHandler, } from './markdown/MarkdownDelegate.js';
+export { DetailDocument, detailDocumentState, useDetailDocumentLabels } from './DetailDocument.js';
+export type { DetailDocumentCopy, DetailDocumentLabels, DetailDocumentRead, DetailDocumentState, } from './DetailDocument.js';
 export { MarkdownText } from './markdown/MarkdownText.js';
 export type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownLabels, MarkdownPathImages, } from './markdown/MarkdownText.js';
+export { formatQuoteText } from './markdown/quote-text.js';
 export { extractMarkdownPlainText } from './markdown/plain-text.js';
 export type { MarkdownPlainTextMode, MarkdownPlainTextOptions } from './markdown/plain-text.js';

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

@@ -2,6 +2,13 @@
 /**
  * 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 clearance plus 20px; fullscreen keeps only the 20px gap.
+ * @param anchor - the overlay's anchor rect in viewport coordinates. While the anchor's top edge is inside the
+ * viewport, the margin never exceeds `anchor.bottom + gap`, so an overlay opened from a control inside the top strip
+ * stays next to it.
+ * @param gap - the distance the overlay keeps below `anchor`.
+ * @returns the frame clearance plus 20px (20px in fullscreen), capped by a visible `anchor`, but never below `min`.
  */
-export declare function overlayTopMargin(min: number): number;
+export declare function overlayTopMargin(min: number, anchor?: {
+    readonly top: number;
+    readonly bottom: number;
+}, gap?: number): number;

package/dist/types/tooltip-placement.d.ts

@@ -0,0 +1,34 @@
+/** Deterministic tooltip placement using measured border boxes and viewport coordinates. */
+/** Bubble placement relative to the anchor. */
+export type TooltipSide = 'right' | 'left' | 'bottom' | 'top';
+interface PlacementInput {
+    anchor: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+    width: number;
+    height: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    side: TooltipSide;
+    align: 'center' | 'end';
+    gap: number;
+}
+interface TooltipPlacement {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    side: TooltipSide;
+    /** No complete side fits, so placement is bounded by the viewport instead. */
+    overflow: boolean;
+}
+/**
+ * Prefer the requested side, its opposite, then perpendicular sides without covering the anchor.
+ * @param input - Observed dimensions, anchor edges, viewport and requested placement; horizontal gaps remain 10px.
+ * @returns Border-box coordinates and the selected side; if no side fits, a viewport-bounded fallback.
+ */
+export declare function placeTooltip(input: PlacementInput): TooltipPlacement;
+export {};

package/dist/types/use-clipboard-copy.d.ts

@@ -0,0 +1,13 @@
+/** Clipboard action and its temporary success state. */
+export interface ClipboardCopyState {
+    /** True for one second after an accepted clipboard write. */
+    readonly copied: boolean;
+    /** Write the current text unless a write or success indication is already active. */
+    readonly onCopy: () => void;
+}
+/**
+ * Keep clipboard feedback local to the mounted control and release its reset timer on unmount.
+ * @param text - Exact text to copy when the action is invoked.
+ * @returns Success feedback and a callback stable while text and feedback are unchanged.
+ */
+export declare function useClipboardCopy(text: string): ClipboardCopyState;

package/dist/types/useAnchoredPosition.d.ts

@@ -1,35 +1,35 @@
-/**
- * Keep a fixed-position floating element anchored to a trigger.
- *
- * A portaled panel is positioned from its anchor's viewport rect, which stops
- * being true the moment anything scrolls or the window resizes. This owns that
- * one concern: measure the anchor, offset the panel below or above it, clamp
- * the result inside the viewport, and re-run on scroll (capture phase, so
- * scrollers nested inside the page are caught too), on resize, and on the
- * panel's own size changes while the element is open.
- * @module @deepseek-ai/dsh-client-ui-primitives/useAnchoredPosition
- */
+/** Synchronous placement for body-portaled panels with a viewport fixed-position containing block. */
 import { type CSSProperties, type RefObject } from 'react';
 /** Inputs for {@link useAnchoredPosition}. */
 export interface AnchoredPositionOptions {
-    /** Whether the floating element is mounted and should track its anchor. */
+    /** Whether the panel is mounted and should track its anchor. */
     open: boolean;
-    /** The element the panel is placed from. */
+    /** Element whose viewport rect anchors the panel. */
     anchorRef: RefObject<HTMLElement | null>;
-    /** The floating element, measured so the clamp uses real dimensions. */
+    /** Body-portaled, fixed-position panel; its ancestors must not establish a containing block. */
     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`). */
+    /** Preferred anchor edge; right-side panels align their top edges. */
+    side?: 'top' | 'bottom' | 'right';
+    /** Horizontal alignment for panels above or below the anchor. */
     align?: 'start' | 'end';
-    /** Distance kept between the anchor edge named by `side` and the panel. */
+    /** Distance from the preferred anchor edge, in CSS pixels. */
     gap: number;
-    /** Distance kept between the panel and each viewport edge; the frame's overlay inset widens the top margin. */
+    /** Minimum viewport inset; desktop frame clearance can increase the top inset. */
     margin: number;
+    /** Reserve desktop frame clearance in addition to the margin; false keeps only the viewport margin. Defaults to true. */
+    frameClearance?: boolean;
+    /** Host-supplied client rect; null hides the panel until the anchor is available. */
+    getAnchorRect?: () => DOMRect | null;
+    /** Re-measure a committed content change before paint. */
+    layoutKey?: string | number;
+    /** Minimum panel width follows the anchor, bounded by the visible viewport. */
+    minWidthFromAnchor?: boolean;
 }
 /**
- * Track an anchor and return the panel's fixed coordinates.
- * @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.
+ * Keep a fixed panel aligned and constrained to the visible viewport.
+ * Panel CSS consumes `--dsh-anchored-max-width` and `--dsh-anchored-max-height` for size limits.
+ * The hook owns those inline variables and optional min-width while open, restoring them on cleanup.
+ * @param options - Open state, element refs, placement, and optional host rect or content change key.
+ * @returns Fixed left/top coordinates, or null while closed or awaiting an anchor; the first measurement completes before paint.
  */
 export declare function useAnchoredPosition(options: AnchoredPositionOptions): CSSProperties | null;

package/dist/types/useRowDragPreview.d.ts

@@ -0,0 +1,19 @@
+import type { DragEvent } from 'react';
+/**
+ * Own a row's inert drag preview until drag end, replacement, or unmount.
+ * The offscreen copy keeps WebKit snapshots separate from overlapping panels.
+ * The wrapper copies only explicitly requested computed custom properties.
+ * Its cloned slot DOM remains in document.body for that lifetime; query live rows
+ * within their list to exclude duplicate text and element IDs.
+ * @param className - preview background matching the row's surface; WebKit fills
+ * transparent snapshot pixels white, including rounded corners.
+ * @param inheritedProperties - custom-property names whose computed values the preview needs.
+ * Omit to copy none. Keep the list reference stable; replacing it clears the active preview.
+ * @returns preview callbacks; cleanup reports whether this row started a drag,
+ * even when its preview failed or the row became non-draggable before drag end.
+ * Start accepts the source row when a child handle owns the drag event.
+ */
+export declare function useRowDragPreview(className: string, inheritedProperties?: readonly `--${string}`[]): {
+    start: (event: DragEvent<HTMLElement>, row?: HTMLElement) => void;
+    clear: () => boolean;
+};

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

@@ -1,36 +1,31 @@
+/** Inline text and reference presentation; business rules supply resolved JSON data and actions. */
+import type { HTMLAttributes } from 'react';
+import type { ReactNode } from 'react';
+import { type ReferenceIconKind } from './ReferenceIcon.js';
+/** Plain text follows the wrapping and typography of its host. */
+export interface UserTextRunProps {
+    readonly text: string;
+}
 /**
- * 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. 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`
- * token decorates only when the caller names it — a skill the host actually
- * loaded for that message (ui-chat reads the step's `skill-invocation`
- * injections) or the command a command-input bubble echoes — so `/123` or a
- * stray `/word` stays plain text. A `/name` token is whitespace-bounded like
- * the host skill gesture (`dsh-tool-skill`): it ends at whitespace or the
- * text end, so slash paths (`/nfs-hg/xxx`, `/plan.md`) and punctuation-glued
- * tokens (`/plan。`) stay plain even for a loaded name.
+ * Render an uninterpreted inline text run.
+ * @param props - text retained verbatim from the caller's document.
+ * @returns one inline run without Markdown or reference recognition.
  */
-import type { ReactNode } from 'react';
-/** Optional navigation supplied by consumers that can preview references. */
-export interface UserTextReferences {
-    /** Open a file path decoded from an `@` mention. */
-    openFile: (path: string) => void;
-    /** Open the source of a skill loaded for this message. */
-    openSkill: (name: string) => void;
+export declare function UserTextRun({ text }: UserTextRunProps): ReactNode;
+/** Presentation selected by a reference renderer, independent of its matching grammar. */
+export interface ReferenceChipProps {
+    readonly appearance: ReferenceIconKind | 'skill' | 'command';
+    /** Explicit object-menu gesture bindings; absent for display-only references. */
+    readonly contextMenuProps?: Pick<HTMLAttributes<HTMLElement>, 'onContextMenu' | 'onKeyDown' | 'tabIndex'>;
+    readonly label: string;
+    readonly title: string;
+    /** Absent for display-only references and previews. */
+    readonly onActivate?: () => void;
 }
 /**
- * Split one sent text into inline plain runs and reference chips.
- * @param text - the logged model text of the message or queue row.
- * @param sessionLabels - exact session mention labels associated by an adjacent recall.
- * @param slashNames - names a `/name` token may decorate as: the skills the
- * host loaded for this message, or the command a command bubble echoes
- * (unsent queue rows pass none).
- * @param slashKind - the chip kind those tokens render as.
- * @param references - optional file and skill preview actions; session and command tokens stay labels.
- * @returns inline nodes covering the whole text.
+ * Render a reference label or its explicitly supplied activation action.
+ * Text selection and repeated pointer clicks do not activate the reference.
+ * @param props - resolved visual fields and optional action from the owning renderer.
+ * @returns an inline label, or a keyboard-accessible button when activation is supplied.
  */
-export declare function projectUserText(text: string, sessionLabels: readonly string[], slashNames?: readonly string[], slashKind?: 'skill' | 'command', references?: UserTextReferences): ReactNode;
+export declare function ReferenceChip({ appearance, label, title, onActivate, contextMenuProps, }: ReferenceChipProps): ReactNode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seekbuddy/dsh-ui",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.0-beta.1",
   "description": "Unofficial React components in the DeepSeek Harness (DSH) web UI design system: the DSH primitives plus the components DSH does not provide (cards, tabs, pagination, messages, upload, date/time pickers), on the same --dsw-* tokens. Not affiliated with or endorsed by DeepSeek.",
   "keywords": [
     "dsh",
@@ -112,7 +112,7 @@
     "react-dom": "^18.2.0 || ^19.0.0"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-util-code-language": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-util-code-language": "0.2.2-rc.1",
     "@shikijs/langs": "^4.3.1",
     "@types/mdast": "^4.0.4",
     "anser": "^2.3.5",