@deepseek-ai/dsh-client-ui-primitives 0.0.1-rc.1

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

@@ -0,0 +1,112 @@
+/**
+ * Direct mdast→React markdown renderer. Replaces the react-markdown /
+ * remark-rehype pipeline with one switch over parsed nodes so streaming can
+ * cache frozen blocks as React elements; the rendered DOM is pinned
+ * byte-for-byte by `tests/fixtures/markdown-dom` and must not drift.
+ *
+ * Untrusted-output policy (unchanged from the replaced pipeline): link and
+ * image destinations pass a protocol allowlist, 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
+ * 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 { ReactNode } from 'react';
+import type * as Md from 'mdast';
+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 {
+    /** Copy-button idle label. */
+    copyLabel?: string | undefined;
+    /** Copy-button label during the post-copy confirmation window. */
+    copiedLabel?: string | undefined;
+}
+/** Link/image reference targets collected from a document (first definition per identifier wins, as in CommonMark). */
+export interface ReferenceTargets {
+    /** Link/image definitions keyed by upper-cased identifier. */
+    definitions: Map<string, Md.Definition>;
+    /** Footnote definitions keyed by upper-cased identifier. */
+    footnotes: Map<string, Md.FootnoteDefinition>;
+}
+/**
+ * Create an empty {@link ReferenceTargets}.
+ * @returns Fresh empty maps.
+ */
+export declare function createReferenceTargets(): ReferenceTargets;
+/**
+ * Record every definition and footnote definition under `nodes` into
+ * `targets`, depth-first, keeping the first definition per identifier.
+ * @param nodes - Subtrees to walk (top-level blocks or any nested children).
+ * @param targets - Accumulator, typically shared across incremental segments.
+ */
+export declare function collectReferenceTargets(nodes: readonly Md.RootContent[], targets: ReferenceTargets): void;
+/**
+ * File-mention affordance for inline code: the owner resolves an authored
+ * token to the file it names, using its own vocabulary of real files — the
+ * renderer never guesses at what looks like a path.
+ */
+export interface MarkdownFileMentions {
+    /**
+     * Resolve one inline-code token.
+     * @param value - The authored token, exactly as written.
+     * @returns The opener with its accessible label and full-path title, or
+     * undefined when the token names no known file — it then stays inert code.
+     */
+    resolve(value: string): {
+        open: () => void;
+        label: string;
+        title: string;
+    } | undefined;
+}
+/**
+ * One render pass's state: immutable options and targets plus the footnote
+ * numbering accumulated in document order while references render.
+ */
+export interface MarkdownRenderContext {
+    /** Streaming arm: fences render plain and TeX stays literal. */
+    readonly streaming: boolean;
+    /** Localized fence copy-button labels. */
+    readonly codeLabels: MarkdownCodeLabels | undefined;
+    /** Inline-code file mentions; absent wherever no opener vocabulary exists. */
+    readonly fileMentions: MarkdownFileMentions | undefined;
+    /** Inside an anchor's children: interactive mentions must not nest there. */
+    readonly inLink?: boolean;
+    /** Reference targets visible to this pass. */
+    readonly targets: ReferenceTargets;
+    /** Footnote identifiers in first-reference order; a footnote's number is its 1-based index here. */
+    readonly footnoteOrder: string[];
+    /** References rendered per identifier; drives the section's back-reference count. */
+    readonly footnoteCounts: Map<string, number>;
+}
+/**
+ * Render top-level blocks. Nodes that render nothing (definitions, unmapped
+ * types) are dropped rather than kept as null placeholders, matching the
+ * replaced pipeline's child lists so separator newlines land identically.
+ * @param blocks - Blocks with their stream-stable render keys.
+ * @param context - The pass state; footnote numbering mutates in document order.
+ * @returns One React node per rendered block.
+ */
+export declare function renderBlocks(blocks: readonly PositionedBlock[], context: MarkdownRenderContext): ReactNode[];
+/**
+ * Interleave the newline text nodes the replaced pipeline emitted between
+ * block-level children. They are invisible between elements but coalesce
+ * into adjacent literal raw-HTML text, where the DOM parity fixtures pin
+ * them.
+ * @param elements - Rendered block children with empty renders already dropped.
+ * @param edges - Also emit the leading and trailing newline (hast's loose wrap).
+ * @returns The interleaved children.
+ */
+export declare function wrapBlockChildren(elements: readonly ReactNode[], edges: boolean): ReactNode[];
+/**
+ * Render the trailing footnote section for every footnote referenced during
+ * the pass, in first-reference order, with one plain-text back-reference
+ * marker per rendered reference.
+ * @param context - The pass state after all blocks rendered.
+ * @returns The section, or null when no referenced footnote has a definition.
+ */
+export declare function renderFootnoteSection(context: MarkdownRenderContext): ReactNode | null;
+//# sourceMappingURL=render.d.ts.map

package/lib/types/pointer-grace.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Grace before a pointer-dismissed popup closes. Covers the anchor->popup gap
+ * (8px for HoverCard, 4px for Menu) at a hand's travel speed without leaving a
+ * popup lingering once the pointer has genuinely moved on.
+ */
+export declare const POINTER_GRACE_MS = 200;
+/** Cancelable delayed close for a pointer-dismissed popup. */
+export interface PointerGrace {
+    /** Schedule the close {@link POINTER_GRACE_MS} from now, replacing any pending one. */
+    arm: () => void;
+    /** Abort a pending close (the pointer came back). */
+    cancel: () => void;
+}
+/**
+ * Delay a pointer-dismissed popup's close so the pointer can cross the gap
+ * between anchor and popup. A pending close is dropped on unmount.
+ * @param close - runs when the grace elapses with no re-entry; read at fire
+ * time, so callers may pass a fresh closure each render.
+ * @returns the {@link PointerGrace} handle.
+ */
+export declare function usePointerGrace(close: () => void): PointerGrace;
+//# sourceMappingURL=pointer-grace.d.ts.map

package/lib/types/use-copy-feedback.d.ts

@@ -0,0 +1,14 @@
+/** The copy-feedback hook's return: the transient flag and the copy handler. */
+export interface CopyFeedback {
+    /** True for {@link COPIED_FEEDBACK_MS} after a successful write; render the success label off it. */
+    copied: boolean;
+    /** Copy the hook's text; no-op while `copied` is still true, silent on a refused write. */
+    onCopy: () => void;
+}
+/**
+ * Copy `text` to the clipboard with one-second success feedback.
+ * @param text - the text to write on copy.
+ * @returns the `copied` flag and the `onCopy` handler.
+ */
+export declare function useCopyFeedback(text: string): CopyFeedback;
+//# sourceMappingURL=use-copy-feedback.d.ts.map

package/lib/types/useAnchoredMaxHeight.d.ts

@@ -0,0 +1,11 @@
+import type { RefObject } from 'react';
+/**
+ * Clamp a bottom-anchored overlay's max-height to the viewport.
+ * @param ref - the overlay element; a null current (overlay closed) skips measuring.
+ * @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.
+ * @returns the max-height to apply inline, in px.
+ */
+export declare function useAnchoredMaxHeight(ref: RefObject<HTMLElement>, cap: number, signal: unknown): number;
+//# sourceMappingURL=useAnchoredMaxHeight.d.ts.map

package/package.json

@@ -0,0 +1,66 @@
+{
+  "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.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-primitives"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "@shikijs/langs": "^4.3.1",
+    "@types/mdast": "^4.0.4",
+    "anser": "^2.3.5",
+    "clsx": "^2.0.0",
+    "katex": "^0.16.47",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-math": "^3.0.0",
+    "micromark-core-commonmark": "^2.0.3",
+    "micromark-extension-gfm": "^3.0.0",
+    "micromark-extension-math": "^3.1.0",
+    "micromark-factory-space": "^2.0.1",
+    "micromark-util-character": "^2.1.1",
+    "micromark-util-classify-character": "^2.0.1",
+    "micromark-util-sanitize-uri": "^2.0.1",
+    "micromark-util-symbol": "^2.0.1",
+    "micromark-util-types": "^2.0.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "shiki": "^4.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  }
+}