@seekbuddy/dsh-ui 0.0.0-stage → 0.2.0-beta.1

package/dist/types/useAnchoredPosition.d.ts

@@ -0,0 +1,35 @@
+/** 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 panel is mounted and should track its anchor. */
+    open: boolean;
+    /** Element whose viewport rect anchors the panel. */
+    anchorRef: RefObject<HTMLElement | null>;
+    /** Body-portaled, fixed-position panel; its ancestors must not establish a containing block. */
+    panelRef: RefObject<HTMLElement | null>;
+    /** 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 from the preferred anchor edge, in CSS pixels. */
+    gap: number;
+    /** 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;
+}
+/**
+ * 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/useDismissOnOutsidePointer.d.ts

@@ -0,0 +1,10 @@
+import type { RefObject } from 'react';
+/**
+ * Close an open popover when a pointerdown lands outside its root element.
+ * @param root - element containing both the trigger and the open surface.
+ * @param open - whether the surface is showing; false detaches the listener.
+ * @param setOpen - state setter invoked with false on an outside pointerdown.
+ * @param portal - surface portaled outside the root (a `document.body` dialog)
+ * that also counts as inside; omit when the root contains the whole popover.
+ */
+export declare function useDismissOnOutsidePointer(root: RefObject<HTMLElement | null>, open: boolean, setOpen: (open: boolean) => void, portal?: RefObject<HTMLElement | null>): void;

package/dist/types/useModalLayer.d.ts

@@ -0,0 +1,26 @@
+import type { RefObject } from 'react';
+/** Dialog and menu elements whose document order determines foreground shortcut ownership. */
+export declare const modalSelector = "[role=\"dialog\"][aria-modal=\"true\"], [role=\"menu\"]";
+/**
+ * Request closure of the foreground registered modal using its current onClose callback.
+ * A newer menu or unregistered dialog blocks dismissal of the modal behind it.
+ * @param document - product document whose modal owns the close command.
+ */
+export declare function closeTopModal(document: Document): void;
+/**
+ * Whether an anchor belongs behind the current modal and must yield keyboard input.
+ * @param anchor - local control owning the input handler.
+ * @returns true when another modal owns the foreground.
+ */
+export declare function isBehindModal(anchor: HTMLElement | null): boolean;
+/**
+ * Give only the top modal Escape and Tab ownership, then restore its previous focus.
+ * Automatic entry and return focus omit outlines; keyboard traversal retains its indicators.
+ * Controls mounted with the dialog use data-modal-autofocus for initial focus;
+ * React autoFocus runs before this layer can capture the invoking control.
+ * Local menus handle their Escape during capture before this bubble listener.
+ * @param dialog - mounted dialog element.
+ * @param open - whether this layer is active.
+ * @param onClose - top-layer Escape or application close action.
+ */
+export declare function useModalLayer(dialog: RefObject<HTMLElement | null>, open: boolean, onClose: () => void): void;

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

@@ -0,0 +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;
+}
+/**
+ * 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.
+ */
+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;
+}
+/**
+ * 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 ReferenceChip({ appearance, label, title, onActivate, contextMenuProps, }: ReferenceChipProps): ReactNode;

package/package.json

@@ -1,6 +1,153 @@
 {
   "name": "@seekbuddy/dsh-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "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",
+    "deepseek-harness",
+    "react",
+    "ui",
+    "design-system",
+    "tokens"
+  ],
+  "homepage": "https://github.com/seekbuddy/dsh-ui#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seekbuddy/dsh-ui.git"
+  },
+  "bugs": {
+    "url": "https://github.com/seekbuddy/dsh-ui/issues"
+  },
+  "author": "SeekBuddy",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./blocks": {
+      "types": "./dist/types/blocks.d.ts",
+      "import": "./dist/blocks.js"
+    },
+    "./markdown": {
+      "types": "./dist/types/markdown.d.ts",
+      "import": "./dist/markdown.js"
+    },
+    "./icons": {
+      "types": "./dist/types/icons.d.ts",
+      "import": "./dist/icons.js"
+    },
+    "./theme": {
+      "types": "./dist/types/theme.d.ts",
+      "import": "./dist/theme.js"
+    },
+    "./theme/bootstrap": {
+      "types": "./dist/types/theme-bootstrap.d.ts",
+      "import": "./dist/theme-bootstrap.js"
+    },
+    "./seekbuddy": {
+      "types": "./dist/types/seekbuddy/index.d.ts",
+      "import": "./dist/seekbuddy.js"
+    },
+    "./seekbuddy/card": {
+      "types": "./dist/types/seekbuddy/Card.d.ts",
+      "import": "./dist/seekbuddy-card.js"
+    },
+    "./seekbuddy/empty": {
+      "types": "./dist/types/seekbuddy/Empty.d.ts",
+      "import": "./dist/seekbuddy-empty.js"
+    },
+    "./seekbuddy/spinner": {
+      "types": "./dist/types/seekbuddy/Spinner.d.ts",
+      "import": "./dist/seekbuddy-spinner.js"
+    },
+    "./seekbuddy/tabs": {
+      "types": "./dist/types/seekbuddy/Tabs.d.ts",
+      "import": "./dist/seekbuddy-tabs.js"
+    },
+    "./seekbuddy/timeline": {
+      "types": "./dist/types/seekbuddy/Timeline.d.ts",
+      "import": "./dist/seekbuddy-timeline.js"
+    },
+    "./tokens.css": {
+      "types": "./dist/tokens.css.d.ts",
+      "default": "./dist/tokens.css"
+    },
+    "./katex.css": {
+      "types": "./dist/katex.css.d.ts",
+      "default": "./dist/katex.css"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md",
+    "UPSTREAM.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "**/*.css",
+    "**/*.mjs"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "node build/build.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run test:unit",
+    "test:unit": "node scripts/run-unit-tests.mjs",
+    "test:package": "node scripts/test-package.mjs",
+    "test:react18": "node scripts/test-fixture.mjs react18",
+    "test:next16": "node scripts/test-fixture.mjs next16",
+    "verify": "npm run typecheck && npm run test:docs && npm run test:unit && npm run build && npm run test:package && npm run test:react18 && npm run test:next16",
+    "prepack": "npm run build",
+    "test:docs": "node scripts/check-doc-pairs.mjs && node scripts/check-doc-examples.mjs"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@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",
+    "clsx": "^2.0.0",
+    "diff": "^9.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",
+    "shiki": "^4.3.1",
+    "simple-icons": "16.31.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.1",
+    "esbuild": "^0.25.0",
+    "lightningcss": "^1.32.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^7.0.2"
+  },
+  "allowScripts": {
+    "esbuild@0.25.12": true
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}