@try-works/dsh-recursive-mode 0.1.11 → 0.1.13

package/lib/client/board.d.ts

@@ -1,39 +1,14 @@
-/**
- * Board overlay (SP2 R1 + run 08 R3 + run 12): the kanban view over the live
- * host-route projection. Pure read-only renderer — no filesystem, no run-file
- * scraping. Cards are grouped by worktree root (the projection's outer key) and
- * mapped to their current-phase lane via derive.columnForRun. Renders NOTHING
- * when the snapshot is null (no recursive root / not loaded) or the current
- * session is not on the recursive preset (the gate lives in slots.ts — here an
- * empty projection with a null root is a no-op, not an "empty board").
- *
- * Run 08 R3: a card click opens the drill-down inspector via onOpenInspector
- * (the overlay swaps board <-> inspector in slots.ts). Read-only still: the
- * callback only selects a run for display; no mutation.
- *
- * Run 12 (LIVE BUG): shell.overlay is a click-through, unstyled frame layer —
- * without inline styles the mounted board was INVISIBLE (no position/size/z)
- * and CLICK-THROUGH (no pointer-events opt-in). Everything is styled inline
- * (no CSS pipeline in the CJS client bundle): full-cover fixed overlay, opaque
- * backdrop, pointerEvents auto, and a visible close button.
- */
-import { type CSSProperties } from 'react';
 import type { RecursiveProjection, RecursiveRunCard } from '../types.ts';
 import type { LiveProjectionValue } from './contract.ts';
 import type { BoardSelection } from './open-state.ts';
-/** Full-cover overlay style — the shell.overlay seat is click-through + unstyled by default (run 12). */
-export declare const overlayStyle: CSSProperties;
 /** Flatten the worktree-grouped projection into a stable run list. */
 export declare function listRuns(projection: RecursiveProjection | undefined): RecursiveRunCard[];
 export interface BoardProps {
-    /** The live host-route snapshot (null = not loaded / no recursive root). */
     snapshot: LiveProjectionValue | null;
-    /** Opens the drill-down inspector for a run (R3). */
     onOpenInspector?: (selection: BoardSelection) => void;
-    /** Closes the overlay (run 12). */
     onClose?: () => void;
 }
 export declare function Board({ snapshot, onOpenInspector, onClose }: BoardProps): import("react").DetailedReactHTMLElement<{
     className: string;
-    style: CSSProperties;
+    'data-theme': import("./theme.ts").BoardTheme;
 }, HTMLElement> | null;

package/lib/client/derive.d.ts

@@ -71,6 +71,17 @@ export declare function cardFacts(card: RecursiveRunCard): RecursiveCardFacts;
  * worktree root is part of the id so two runs with the same runId in
  * different worktrees never collide — never "latest unfinished".
  */
+/** Solid status-pill kinds (run 16 / Paper StatusPill). */
+export type PillKind = 'locked' | 'in-progress' | 'paused' | 'blocked' | 'tampered' | 'advisory' | 'neutral';
+/** Human pill label per kind (neutral renders an empty dash). */
+export declare const PILL_LABELS: Record<PillKind, string>;
+/**
+ * Solid-pill kind for a whole run card. Priority: tamper > fully-locked >
+ * run-state blocked > run-state paused > still in-progress.
+ */
+export declare function cardPill(card: RecursiveRunCard): PillKind;
+/** Solid-pill kind for a phase row status string (LOCKED / DRAFT / '—'). */
+export declare function phaseStatusPill(status: string): PillKind;
 export declare function nodeKeyOf(runId: string, worktreeRoot: string): string;
 /** One expanded inspector phase row (§11.5). */
 export interface RecursivePhaseInspectorRow {

package/lib/client/inspector.d.ts

@@ -1,25 +1,13 @@
-/**
- * Drill-down inspector (SP2 R1 + run 12): the details-seat swap rendering one
- * run's phase chain (with the always-shown 3.5 row + full 6/7/8 rows), lock
- * badges, and tamper/gate facts — all from the live host-route snapshot, never
- * disk.
- *
- * Run 12 (LIVE BUG): same as the board — shell.overlay is click-through and
- * unstyled, so the inspector mounts INVISIBLE + CLICK-THROUGH without inline
- * styles. Full-cover fixed overlay + pointerEvents auto + a back button and a
- * close button.
- */
-import { type CSSProperties } from 'react';
 import type { LiveProjectionValue } from './contract.ts';
+import type { BoardTheme } from './theme.ts';
 export interface InspectorProps {
     runId: string;
     worktreeRoot: string;
     snapshot: LiveProjectionValue | null;
     onBackToToolDetails: () => void;
-    /** Closes the overlay (run 12). */
     onClose?: () => void;
 }
 export declare function Inspector({ runId, worktreeRoot, snapshot, onBackToToolDetails, onClose }: InspectorProps): import("react").DetailedReactHTMLElement<{
     className: string;
-    style: CSSProperties;
+    'data-theme': BoardTheme;
 }, HTMLElement>;

package/lib/client/styles.d.ts

@@ -0,0 +1,17 @@
+/**
+ * One-shot board/inspector stylesheet injection (run 15 + run 16 / Paper).
+ * The client bundle is a plain CJS closure with NO CSS pipeline (tsdown), so we
+ * inject a single <style data-dsh-recursive> element into document.head.
+ *
+ * Run 16 (Paper): the design is ported 1:1 — DEFAULT LIGHT theme, dark via a
+ * data-theme attribute on the .rec-board / .rec-inspector root. Raw --rm3-*
+ * tokens live on the scoped roots; semantic --board-* aliases remap under
+ * [data-theme='dark']. EVERY component rule consumes ONLY --board-* aliases
+ * (never --rm3-* directly). Idempotent injection; disposer removes the element.
+ */
+/**
+ * Inject the board/inspector stylesheet once. Idempotent: if a <style
+ * data-dsh-recursive> already exists, returns a disposer that does nothing
+ * (the first injector owns the element). Returns a disposer that removes it.
+ */
+export declare function injectBoardStyles(): () => void;

package/lib/client/theme.d.ts

@@ -0,0 +1,20 @@
+export declare const BOARD_THEME_STORAGE_KEY = "dsh-recursive-theme";
+export type BoardTheme = 'light' | 'dark';
+export interface BoardThemeState {
+    theme: BoardTheme;
+    toggle: () => void;
+}
+/**
+ * Hoisted at the TOP of Board and Inspector (never after an early return — run
+ * 0.1.10 invariant). Defaults light, reads a persisted dark on init, and writes
+ * the chosen theme back to localStorage.
+ */
+export declare function useBoardTheme(): BoardThemeState;
+/** The shared header toggle button (moon in light, sun in dark). */
+export declare function ThemeToggle({ theme, toggle }: BoardThemeState): import("react").DetailedReactHTMLElement<{
+    type: string;
+    className: string;
+    onClick: () => void;
+    title: string;
+    'aria-label': string;
+}, HTMLElement>;