@deepseek-harness-tui/dsh-tui 0.12.0 → 0.13.0

package/lib/types/math/renderer.js

@@ -59,6 +59,10 @@ const rasters = new WeightedLru(128, 64 * 1024 * 1024, value => value.ok ? value
 const inflight = new Map();
 /** Cache counters, for tests and debug output. */
 export const mathRenderStats = { vectorHits: 0, vectorMisses: 0, rasterHits: 0, rasterMisses: 0 };
+/** Formula renders still running (tests wait for 0 before reading the screen). */
+export function mathRendersInFlight() {
+    return inflight.size;
+}
 let converter;
 function loadConverter() {
     converter ??= import('@dsh-tui-vendor/mathjax-tex-svg')

package/lib/types/onboardingPrefs.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The wizard revision this build writes. Bump it when a step is ADDED (not
+ * when copy changes): installs completed at an older revision become
+ * eligible again, which is the point — a new domain is worth one more pass.
+ */
+export declare const ONBOARDING_VERSION = 1;
+/** Persisted first-run state. */
+export interface OnboardingPrefs {
+    /** True once the wizard ran to completion on this installation. */
+    completed: boolean;
+    /** The wizard revision that was completed (0 when an older build did not stamp one). */
+    version: number;
+}
+/** Not-done-yet, the answer for every unreadable file. */
+export declare const ONBOARDING_UNSEEN: OnboardingPrefs;
+/**
+ * Parse a persisted onboarding record. Pure, so the shape rules are testable
+ * without a filesystem: anything that is not an object with a literal
+ * `completed: true` reads as unseen.
+ *
+ * @param text - Raw file contents.
+ * @returns The normalized record.
+ */
+export declare function parseOnboardingPrefs(text: string): OnboardingPrefs;
+/**
+ * Read the persisted onboarding state.
+ *
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns The normalized record; unseen when the file is absent or unreadable.
+ */
+export declare function readOnboardingPrefs(dir?: string): OnboardingPrefs;
+/**
+ * Record that the wizard completed (best effort).
+ *
+ * @param version - The wizard revision being stamped.
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns True when the record was durably written; false when the data
+ *   directory is not writable. The caller stays silent either way — the
+ *   preference is a convenience, not a promise.
+ */
+export declare function markOnboardingDone(version?: number, dir?: string): boolean;
+/**
+ * Whether this install should be offered the wizard on an ordinary launch.
+ *
+ * The single place the "should it fire" question is answered, so the host
+ * boot decision and any future `/setup` entry point cannot drift apart.
+ *
+ * @param prefs - The record read at boot (or a fixture in a test).
+ * @returns True when the wizard has never been completed at this revision.
+ */
+export declare function shouldOfferOnboarding(prefs?: OnboardingPrefs): boolean;
+//# sourceMappingURL=onboardingPrefs.d.ts.map

package/lib/types/onboardingPrefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboardingPrefs.d.ts","sourceRoot":"","sources":["../../src/onboardingPrefs.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAA;IAClB,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE,eAAkD,CAAA;AAElF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAYlE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAiB,GAAG,eAAe,CAM3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAA2B,EAAE,GAAG,GAAE,MAAiB,GAAG,OAAO,CAYxG;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,eAAuC,GAAG,OAAO,CAE7F"}

package/lib/types/onboardingPrefs.js

@@ -0,0 +1,107 @@
+/**
+ * First-run onboarding state, at `~/.dsh-tui/onboarding.json`.
+ *
+ * Deliberately NOT a cordis config value: "has this installation already
+ * walked the user through setup" is per-machine UI state, like the lang and
+ * home preferences next to it — not a deployment choice a cordis.yml row
+ * should own. A repo-wide pinned config would make the wizard either always
+ * fire or never fire, and neither is what "first run" means.
+ *
+ * Two fields, and the split matters:
+ *
+ *   - `completed` — the user reached the end and pressed 完成. Written on the
+ *     way OUT, never at boot: a process that dies before the first frame
+ *     (a config error, a crash during render) must not burn the
+ *     installation's only first run. Same rule as homePrefs' `seen`.
+ *   - `version` — the wizard revision that was completed. A future wizard
+ *     that adds a step can re-fire on installs sitting on an older revision
+ *     without needing a second file. Absent/0 means "completed by a build
+ *     that did not stamp one", which the caller reads as "completing, but
+ *     worth re-offering if it ever grows a new step".
+ *
+ * Best effort, like every other pref here: a missing, unreadable or corrupt
+ * file simply means "not done yet". The worst outcome of a broken pref file
+ * is one extra wizard — recoverable with a single Esc.
+ *
+ * @module @deepseek-harness-tui/dsh-tui/onboardingPrefs
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DATA_DIR } from './utils/paths.js';
+const FILE = 'onboarding.json';
+/**
+ * The wizard revision this build writes. Bump it when a step is ADDED (not
+ * when copy changes): installs completed at an older revision become
+ * eligible again, which is the point — a new domain is worth one more pass.
+ */
+export const ONBOARDING_VERSION = 1;
+/** Not-done-yet, the answer for every unreadable file. */
+export const ONBOARDING_UNSEEN = { completed: false, version: 0 };
+/**
+ * Parse a persisted onboarding record. Pure, so the shape rules are testable
+ * without a filesystem: anything that is not an object with a literal
+ * `completed: true` reads as unseen.
+ *
+ * @param text - Raw file contents.
+ * @returns The normalized record.
+ */
+export function parseOnboardingPrefs(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return ONBOARDING_UNSEEN;
+        const raw = parsed;
+        const version = typeof raw.version === 'number' && Number.isFinite(raw.version) && raw.version > 0
+            ? Math.floor(raw.version)
+            : 0;
+        return { completed: raw.completed === true, version };
+    }
+    catch {
+        return ONBOARDING_UNSEEN;
+    }
+}
+/**
+ * Read the persisted onboarding state.
+ *
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns The normalized record; unseen when the file is absent or unreadable.
+ */
+export function readOnboardingPrefs(dir = DATA_DIR) {
+    try {
+        return parseOnboardingPrefs(readFileSync(join(dir, FILE), 'utf8'));
+    }
+    catch {
+        return ONBOARDING_UNSEEN;
+    }
+}
+/**
+ * Record that the wizard completed (best effort).
+ *
+ * @param version - The wizard revision being stamped.
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns True when the record was durably written; false when the data
+ *   directory is not writable. The caller stays silent either way — the
+ *   preference is a convenience, not a promise.
+ */
+export function markOnboardingDone(version = ONBOARDING_VERSION, dir = DATA_DIR) {
+    try {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, FILE), `${JSON.stringify({ completed: true, version }, null, 2)}\n`, 'utf8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether this install should be offered the wizard on an ordinary launch.
+ *
+ * The single place the "should it fire" question is answered, so the host
+ * boot decision and any future `/setup` entry point cannot drift apart.
+ *
+ * @param prefs - The record read at boot (or a fixture in a test).
+ * @returns True when the wizard has never been completed at this revision.
+ */
+export function shouldOfferOnboarding(prefs = readOnboardingPrefs()) {
+    return !prefs.completed || prefs.version < ONBOARDING_VERSION;
+}

package/lib/types/panels.d.ts

@@ -0,0 +1,4 @@
+export { name, TuiPanelRuntime, TUI_PANEL_API_VERSION } from './dsh-adapter/panels.js';
+export type { TuiPanelDescriptor, TuiPanelProps, TuiPanelCompactProps, TuiPanelHostApi, TuiPanelSnapshot, TuiPanelKeyEvent, TuiPanelUi, TuiPanelEvent, TuiPanelSummary, } from './dsh-adapter/panels.js';
+export { default } from './dsh-adapter/panels.js';
+//# sourceMappingURL=panels.d.ts.map

package/lib/types/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../src/panels.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AACtF,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA"}

package/lib/types/panels.js

@@ -0,0 +1,4 @@
+// Re-export shim: the Cordis-backed implementation lives behind the adapter
+// boundary so UI consumers never import official @deepseek-ai/* packages.
+export { name, TuiPanelRuntime, TUI_PANEL_API_VERSION } from './dsh-adapter/panels.js';
+export { default } from './dsh-adapter/panels.js';

package/lib/types/screens/Chat.d.ts

@@ -11,7 +11,7 @@ import { type StarAttempt } from '../components/StarPrompt.js';
 import type { WhaleCouponStore } from '../dsh-adapter/oauth/bonus.js';
 import { type PromptController } from '../components/PromptInput.js';
 import type { InjectController } from '../dsh-adapter/inject-channel.js';
-export declare function Chat({ channel, questionStore, approvalStore, extensionDialogs, bonusNotices, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, fullscreen, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, starPrompt, }: {
+export declare function Chat({ channel, questionStore, approvalStore, extensionDialogs, bonusNotices, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, fullscreen, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, launchpadOnBoot, onboardingOnBoot, starPrompt, }: {
     channel: Channel;
     renderScene?: (id: string, channel: Channel) => React.ReactNode;
     questionStore: QuestionStore;
@@ -76,6 +76,27 @@ export declare function Chat({ channel, questionStore, approvalStore, extensionD
      * installation, and tests need it deterministic.
      */
     openHomeOnBoot?: boolean;
+    /**
+     * Show the Launchpad as this session's first frame.
+     *
+     * Same shape of decision as `openHomeOnBoot` and answered by the same
+     * ordinary-launch test (no `--resume`, no workspace target, no first
+     * prompt) — a resumed conversation belongs to a user who already said
+     * where they want to be, and a landing page in front of it would be the
+     * TUI second-guessing them. Unlike the workspace home this is NOT one-shot:
+     * every ordinary launch lands here, because the page is the place where the
+     * first sentence gets typed, not a tutorial that retires itself.
+     */
+    launchpadOnBoot?: boolean;
+    /**
+     * Offer the first-run guide as this session's first frame.
+     *
+     * The host owns the decision (it reads `~/.dsh-tui/onboarding.json`); this
+     * prop only carries the verdict, exactly like `openHomeOnBoot`. It renders
+     * ABOVE the launchpad: the wizard answers "is this thing even wired up",
+     * which is upstream of "what do I want to do first".
+     */
+    onboardingOnBoot?: boolean;
     /**
      * Test seam for the startup star modal (usage milestones 99h / 999
      * launches): `null` disables the modal outright; `dir` points the usage

package/lib/types/screens/Chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/screens/Chat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AA2BzB,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAe,MAAM,kCAAkC,CAAA;AAW7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAa3D,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAQrE,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AA8NxE,wBAAgB,IAAI,CAAC,EACnB,OAAO,EACP,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,UAAkB,EAClB,cAAc,EAAE,kBAAkB,EAClC,mBAAmB,EACnB,mBAAmB,EAAE,uBAAuB,EAC5C,WAAW,EACX,cAAc,EACd,UAAU,GACX,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAA;IAC/D,aAAa,EAAE,aAAa,CAAA;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,cAAc,CAAA;IACjC,uEAAuE;IACvE,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,yDAAyD;IACzD,eAAe,CAAC,EAAE,cAAc,CAAA;IAChC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,eAAe,CAAA;IACpC,uEAAuE;IACvE,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAC9D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5G;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CAC/D,4BAywJA"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/screens/Chat.tsx"],"names":[],"mappings":"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"}