@deepseek-ai/dsh-client-ui-primitives 0.2.1-alpha.2 → 0.2.1-alpha.3

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, hidden while a tooltip within the anchor is visible.
+ * Render an anchor with a hover-triggered preview card independently of nested tooltips.
  * @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.
@@ -10,19 +10,22 @@ import type { ReactNode, RefObject } from 'react';
  * @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.grouped - share first-display dwell across the surrounding list and active portal.
+ * Group replacement removes the previous card immediately, including a fading preview.
  * @param props.copyText - optional primary value copied by activation and
  * included in the card's accessible name.
  * @param props.copyLabel - localized accessible activation-label prefix.
  * @param props.copiedLabel - localized visible success label.
  * @returns anchor wrapper with the conditional portaled card.
  */
-export declare function HoverCard({ anchor, content, openDelayMs, disabled, copyText, copyLabel, copiedLabel, variant, widthAnchorRef, inline, }: {
+export declare function HoverCard({ anchor, content, openDelayMs, disabled, grouped, 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;
+    grouped?: boolean;
     variant?: 'compact' | 'preview';
     widthAnchorRef?: RefObject<HTMLElement | null>;
 } & ({

package/lib/types/HoverCardGroup.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from 'react';
+interface GroupState {
+    isWarm: () => boolean;
+    enter: (overCard: boolean) => void;
+    leave: () => void;
+    containsCard: (target: EventTarget | null) => boolean;
+    shown: (owner: symbol, dismiss: () => void, element: HTMLElement) => void;
+    release: (owner: symbol) => void;
+}
+/** Private coordination shared only by opted-in HoverCards inside one mounted group. */
+export declare const HoverCardGroupContext: import("react").Context<GroupState | null>;
+/**
+ * Share first-display dwell across a list and its active portal, including the card's existing pointer grace.
+ * @param props.children - list contents, including opted-in HoverCards.
+ * @param props.className - classes for the physical list container.
+ * @returns the list container and its private hover coordinator.
+ */
+export declare function HoverCardGroup({ children, className }: {
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=HoverCardGroup.d.ts.map

package/lib/types/PermissionIcon.d.ts

@@ -36,4 +36,16 @@ export declare function PermissionIconFullAccessRegular(props: IconProps): React
  * @returns The medium decorative permission glyph.
  */
 export declare function PermissionIconFullAccessMedium(props: IconProps): ReactNode;
+/**
+ * Render the auto-review permission icon with a one-pixel stroke.
+ * @param props - Size and optional class.
+ * @returns The regular decorative permission glyph.
+ */
+export declare function PermissionIconAutoReviewRegular(props: IconProps): ReactNode;
+/**
+ * Render the auto-review permission icon with a 1.3px stroke.
+ * @param props - Size and optional class.
+ * @returns The medium decorative permission glyph.
+ */
+export declare function PermissionIconAutoReviewMedium(props: IconProps): ReactNode;
 //# sourceMappingURL=PermissionIcon.d.ts.map

package/lib/types/TerminalBlock.d.ts

@@ -52,6 +52,12 @@ export interface TerminalBlockProps {
      * line alone; with output it renders the live text under the running state.
      */
     running?: boolean | undefined;
+    /**
+     * The call launches background work (default false). `running` describes the
+     * launch call only; after it returns, retain the command without job status
+     * or output. An explicit `copyText` override remains available.
+     */
+    background?: boolean | undefined;
     /** Height cap in output lines before the middle collapses (default {@link DEFAULT_TERMINAL_MAX_LINES}); Infinity disables the cap. */
     maxLines?: number | undefined;
     /**
@@ -76,5 +82,5 @@ export interface TerminalBlockProps {
  * @param props - see {@link TerminalBlockProps}.
  * @returns the terminal block element.
  */
-export declare function TerminalBlock({ command, cwd, home, output, exitCode, signal, running, maxLines, copyText, runStateDot, className, labels, }: TerminalBlockProps): import("react").JSX.Element;
+export declare function TerminalBlock({ command, cwd, home, output, exitCode, signal, running, background, maxLines, copyText, runStateDot, className, labels, }: TerminalBlockProps): import("react").JSX.Element;
 //# sourceMappingURL=TerminalBlock.d.ts.map

package/lib/types/Tooltip.d.ts

@@ -3,8 +3,8 @@ import type { FocusEventHandler, MouseEventHandler, ReactElement, Ref } from 're
 /** 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.
+ * Suppression channel for nested tooltips: a visible descendant tooltip
+ * withdraws the enclosing tooltip 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. */

package/lib/types/index.d.ts

@@ -32,6 +32,7 @@ export { useAnchoredPosition } from './useAnchoredPosition.ts';
 export type { AnchoredPositionOptions } from './useAnchoredPosition.ts';
 export { useDismissOnOutsidePointer } from './useDismissOnOutsidePointer.ts';
 export { HoverCard } from './HoverCard.tsx';
+export { HoverCardGroup } from './HoverCardGroup.tsx';
 export { ShortcutKeys } from './ShortcutKeys.tsx';
 export { observeComposition } from './keyboard-composition.ts';
 export { focusWithoutRing } from './focus.ts';
@@ -44,14 +45,14 @@ 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 { PermissionIconFullAccessMedium, PermissionIconFullAccessRegular, PermissionIconReadOnlyMedium, PermissionIconReadOnlyRegular, PermissionIconWorkspaceWriteMedium, PermissionIconWorkspaceWriteRegular, } from './PermissionIcon.tsx';
+export { PermissionIconAutoReviewMedium, PermissionIconAutoReviewRegular, PermissionIconFullAccessMedium, PermissionIconFullAccessRegular, PermissionIconReadOnlyMedium, PermissionIconReadOnlyRegular, PermissionIconWorkspaceWriteMedium, PermissionIconWorkspaceWriteRegular, } from './PermissionIcon.tsx';
 export { ReferenceIconMedium, ReferenceIconRegular } from './ReferenceIcon.tsx';
 export type { ReferenceIconKind, ReferenceIconProps } from './ReferenceIcon.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';
-export { projectUserText, type UserTextReferences } from './user-text.tsx';
+export { UserTextRun, ReferenceChip, type UserTextRunProps, type ReferenceChipProps } from './user-text.tsx';
 export { Tooltip } from './Tooltip.tsx';
 export type { TooltipSide } from './Tooltip.tsx';
 export { pointerModality } from './input-modality.ts';

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

@@ -1,37 +1,29 @@
+/** Inline text and reference presentation; business rules supply resolved JSON data and actions. */
+import type { ReactNode } from 'react';
+import { type ReferenceIconKind } from './ReferenceIcon.tsx';
+/** 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';
+    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 }: ReferenceChipProps): ReactNode;
 //# sourceMappingURL=user-text.d.ts.map

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.2.1-alpha.2",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -23,11 +23,9 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.2",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "~18.3.0",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-util-code-language": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.3",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-util-code-language": "0.2.1-alpha.3",
     "react": "^18.2.0",
     "clsx": "^2.0.0",
     "diff": "^9.0.0",
@@ -40,7 +38,7 @@
     "micromark-util-symbol": "^2.0.1",
     "micromark-util-types": "^2.0.2",
     "shiki": "^4.4.3",
-    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.3",
     "@shikijs/langs": "^4.4.3",
     "@types/mdast": "^4.0.4",
     "micromark-factory-space": "^2.0.1",
@@ -58,6 +56,6 @@
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   }
 }