@deepseek-harness-tui/dsh-tui 0.5.0

package/lib/types/update.js

@@ -0,0 +1,203 @@
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { gt, valid } from 'semver';
+const PACKAGE_NAME = '@deepseek-harness-tui/dsh-tui';
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+const UPDATE_CHECK_TIMEOUT_MS = 4000;
+/** env marker set on the /update restart; the new process verifies it at boot. */
+const UPDATED_FROM_ENV = 'DSH_CC_UPDATED_FROM';
+/** Read the version from either the compiled package or the source checkout. */
+export function installedTuiVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    for (const relativePath of ['../../package.json', '../package.json']) {
+        try {
+            const parsed = JSON.parse(readFileSync(join(here, relativePath), 'utf8'));
+            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                const packageJson = parsed;
+                const version = packageJson.version;
+                if (packageJson.name === PACKAGE_NAME && typeof version === 'string' && valid(version) !== null) {
+                    return version;
+                }
+            }
+        }
+        catch {
+            // Try the source-layout fallback after the compiled-layout path.
+        }
+    }
+    return undefined;
+}
+/**
+ * The profile this TUI was booted with (`dsh --profile <name>`), read from
+ * the launcher argv the process inherited. dsh sets no profile env var, and
+ * its launcher parses its own flags first, so the first `--profile` token in
+ * argv is the launcher's. Undefined for non-profile launches (source
+ * checkouts, `--config` overlays) — there is no profile installation for
+ * `/update` to act on, so the command must stay disabled there.
+ */
+export function resolveDshProfileName(argv = process.argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--profile') {
+            const value = argv[i + 1];
+            return value !== undefined && value !== '' && !value.startsWith('-') ? value : undefined;
+        }
+        if (arg.startsWith('--profile=')) {
+            const value = arg.slice('--profile='.length);
+            return value !== '' ? value : undefined;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve the registry base URL the way npm/pnpm would: `NPM_CONFIG_REGISTRY`
+ * (both spellings) over the `registry=` line in ~/.npmrc over npmjs.org, so
+ * mirror users see the same `latest` their package manager would install.
+ */
+export function resolveRegistryBase() {
+    const fromEnv = process.env.NPM_CONFIG_REGISTRY ?? process.env.npm_config_registry;
+    if (fromEnv !== undefined && fromEnv !== '')
+        return fromEnv.replace(/\/+$/, '');
+    try {
+        const npmrc = readFileSync(join(homedir(), '.npmrc'), 'utf8');
+        const match = /^\s*registry\s*=\s*(\S+)\s*$/m.exec(npmrc);
+        if (match !== null)
+            return match[1].replace(/\/+$/, '');
+    }
+    catch {
+        // No readable user .npmrc — the default registry applies.
+    }
+    return DEFAULT_REGISTRY;
+}
+/** True when `current` is a strictly newer valid version than `previous`. */
+export function isVersionNewer(current, previous) {
+    const a = valid(current);
+    const b = valid(previous);
+    return a !== null && b !== null && gt(a, b);
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Fetch `latest` from the configured registry; undefined on any failure. */
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), UPDATE_CHECK_TIMEOUT_MS);
+    try {
+        const response = await fetch(`${resolveRegistryBase()}/${PACKAGE_NAME}/latest`, {
+            headers: { accept: 'application/json' },
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return undefined;
+        const payload = await response.json();
+        const latest = isRecord(payload) && typeof payload.version === 'string'
+            ? valid(payload.version)
+            : null;
+        return latest ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Classify this install against a fresh registry lookup: an update is
+ * available, the install is already latest, or the answer is unknown
+ * (offline / registry error / unreadable own version).
+ */
+export async function resolveTuiUpdateTarget() {
+    const current = installedTuiVersion();
+    const currentVersion = current === undefined ? null : valid(current);
+    if (currentVersion === null)
+        return { kind: 'unknown' };
+    const latest = await fetchLatestVersion();
+    if (latest === undefined)
+        return { kind: 'unknown' };
+    if (!gt(latest, currentVersion))
+        return { kind: 'latest', current: currentVersion };
+    return { kind: 'update', current: currentVersion, latest };
+}
+/**
+ * Check npm for a newer published TUI version. Network and registry errors
+ * are intentionally treated as "no result" so an offline launch never delays
+ * or blocks the interactive TUI.
+ */
+export async function checkForTuiUpdate() {
+    const target = await resolveTuiUpdateTarget();
+    return target.kind === 'update' ? { current: target.current, latest: target.latest } : undefined;
+}
+/** cmd.exe joins spawn arguments with spaces; quote anything that could split. */
+export function shellQuote(args) {
+    return args.map(arg => (/[ \t"^&|<>()]/.test(arg) ? `"${arg.replace(/"/g, '""')}"` : arg));
+}
+/**
+ * Run a child process with its output attached to the user's terminal. The
+ * shell is opt-in per call: `dsh.cmd` needs it, but the node restart must
+ * never go through cmd.exe — the standard install path
+ * `C:\Program Files\nodejs\node.exe` splits on the space and the replacement
+ * process never starts, leaving an updated package and a dead TUI.
+ */
+function runProcess(command, args, options = {}) {
+    return new Promise(resolve => {
+        let settled = false;
+        const useShell = options.shell === true && process.platform === 'win32';
+        const child = spawn(command, useShell ? shellQuote(args) : args, {
+            env: options.env,
+            stdio: 'inherit',
+            shell: useShell,
+        });
+        const finish = (code) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(code);
+        };
+        child.once('error', error => {
+            process.stderr.write(`dsh-tui: failed to run ${command}: ${error.message}\n`);
+            finish(127);
+        });
+        child.once('close', code => finish(code ?? 1));
+    });
+}
+/**
+ * Update the installed dsh-tui package and restart the same launcher while
+ * preserving the active session. The TUI must already be unmounted before
+ * this is called so pnpm output cannot corrupt the rendered terminal frame.
+ *
+ * `--latest` is required: `pnpm add` writes a caret range into the profile
+ * manifest, and a plain `pnpm update` stays inside that range — with this
+ * project's minor-per-release cadence the TUI would restart unchanged while
+ * reporting success. The restart carries `DSH_CC_UPDATED_FROM` so the new
+ * process can warn when the version did not actually move (e.g. a mirror
+ * registry still serving the old `latest`).
+ *
+ * @param sessionId - Session to resume in the replacement process.
+ * @param profile - The dsh profile this TUI was launched with; updating any
+ *   other profile would leave the running install untouched.
+ * @returns Exit codes for the update run and the replacement process.
+ */
+export async function updateTuiAndRestart(sessionId, profile) {
+    const dsh = process.platform === 'win32' ? 'dsh.cmd' : 'dsh';
+    const updateCode = await runProcess(dsh, [
+        'plugin',
+        '--profile',
+        profile,
+        'update',
+        '--latest',
+        PACKAGE_NAME,
+    ], { shell: true });
+    if (updateCode !== 0)
+        return { updateCode, restartCode: updateCode };
+    const restartCode = await runProcess(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
+        env: {
+            ...process.env,
+            DSH_CC_RESUME_SESSION: sessionId,
+            [UPDATED_FROM_ENV]: installedTuiVersion() ?? '',
+        },
+    });
+    return { updateCode, restartCode };
+}

package/lib/types/utils/clipboard.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Windows clipboard access for Ctrl+V paste. The TUI runs in raw mode, so
+ * the console never performs its own paste for Ctrl+V — the key arrives at
+ * the app and the clipboard is read here. PowerShell `Get-Clipboard` is the
+ * zero-dependency route: file drops (Explorer copy) come back as a
+ * FileDropList (the user pastes a file → insert its path), anything else
+ * comes back as text. Text is base64-encoded on the PowerShell side so the
+ * line-oriented stdout parse survives multi-line clipboard content (a raw
+ * write would put every line on its own output line and drop all but the
+ * first); CJK survives because base64 is pure ASCII.
+ */
+/**
+ * Read the Windows clipboard: file paths when Explorer copied files,
+ * otherwise the plain text. Returns null when the clipboard holds neither.
+ * Clipboard access is retried — another process (e.g. Explorer) briefly
+ * holding the clipboard open makes OpenClipboard fail with a transient
+ * error.
+ *
+ * @returns `{ kind: 'files'; paths: string[] }` for file drops,
+ *   `{ kind: 'text'; text: string }` for text, or null when empty/blocked.
+ */
+export declare function readClipboard(): Promise<{
+    kind: 'files';
+    paths: string[];
+} | {
+    kind: 'text';
+    text: string;
+} | null>;
+/**
+ * Render pasted clipboard content for insertion into the prompt: file paths
+ * quoted when they contain whitespace, joined with single spaces.
+ * @param content - Clipboard content as read by {@link readClipboard}.
+ * @returns The prompt-ready text: quoted, space-joined paths, or the text
+ *   with line endings normalized.
+ */
+export declare function formatClipboardInsert(content: {
+    kind: 'files';
+    paths: string[];
+} | {
+    kind: 'text';
+    text: string;
+}): string;
+//# sourceMappingURL=clipboard.d.ts.map

package/lib/types/utils/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/utils/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,OAAO,CACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B,IAAI,CACP,CAqCA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3E,MAAM,CAOR"}

package/lib/types/utils/clipboard.js

@@ -0,0 +1,82 @@
+/**
+ * Windows clipboard access for Ctrl+V paste. The TUI runs in raw mode, so
+ * the console never performs its own paste for Ctrl+V — the key arrives at
+ * the app and the clipboard is read here. PowerShell `Get-Clipboard` is the
+ * zero-dependency route: file drops (Explorer copy) come back as a
+ * FileDropList (the user pastes a file → insert its path), anything else
+ * comes back as text. Text is base64-encoded on the PowerShell side so the
+ * line-oriented stdout parse survives multi-line clipboard content (a raw
+ * write would put every line on its own output line and drop all but the
+ * first); CJK survives because base64 is pure ASCII.
+ */
+import { execFile } from 'node:child_process';
+const PS_SCRIPT = [
+    "$ErrorActionPreference='SilentlyContinue'",
+    '[Console]::OutputEncoding=[System.Text.Encoding]::UTF8',
+    '$files=$null',
+    'try { $files = Get-Clipboard -Format FileDropList -ErrorAction Stop } catch {}',
+    'if($files){foreach($f in $files){Write-Output ("FILE:"+$f.FullName)}}',
+    'if(-not $files){$t=Get-Clipboard -Raw; if($null -ne $t){Write-Output ("TEXT64:"+[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($t)))}}',
+].join('; ');
+/**
+ * Read the Windows clipboard: file paths when Explorer copied files,
+ * otherwise the plain text. Returns null when the clipboard holds neither.
+ * Clipboard access is retried — another process (e.g. Explorer) briefly
+ * holding the clipboard open makes OpenClipboard fail with a transient
+ * error.
+ *
+ * @returns `{ kind: 'files'; paths: string[] }` for file drops,
+ *   `{ kind: 'text'; text: string }` for text, or null when empty/blocked.
+ */
+export function readClipboard() {
+    return new Promise(resolve => {
+        let attempts = 0;
+        const attempt = () => {
+            attempts += 1;
+            const child = execFile('powershell', ['-NoProfile', '-NonInteractive', '-Command', PS_SCRIPT], { encoding: 'utf8', windowsHide: true, timeout: 3000 }, (error, stdout) => {
+                if (error) {
+                    if (attempts < 3) {
+                        // Transient clipboard lock — retry shortly.
+                        setTimeout(attempt, 150);
+                        return;
+                    }
+                    resolve(null);
+                    return;
+                }
+                const files = [];
+                const texts = [];
+                for (const line of stdout.split(/\r?\n/)) {
+                    if (line.startsWith('FILE:'))
+                        files.push(line.slice(5));
+                    else if (line.startsWith('TEXT64:')) {
+                        texts.push(Buffer.from(line.slice(7), 'base64').toString('utf8'));
+                    }
+                }
+                if (files.length > 0)
+                    resolve({ kind: 'files', paths: files });
+                else if (texts.length > 0)
+                    resolve({ kind: 'text', text: texts.join('\n') });
+                else
+                    resolve(null);
+            });
+            // The app must never be held hostage by a stuck PowerShell.
+            child.unref();
+        };
+        attempt();
+    });
+}
+/**
+ * Render pasted clipboard content for insertion into the prompt: file paths
+ * quoted when they contain whitespace, joined with single spaces.
+ * @param content - Clipboard content as read by {@link readClipboard}.
+ * @returns The prompt-ready text: quoted, space-joined paths, or the text
+ *   with line endings normalized.
+ */
+export function formatClipboardInsert(content) {
+    if (content.kind === 'files') {
+        return content.paths
+            .map(path => (/\s/.test(path) ? `"${path}"` : path))
+            .join(' ');
+    }
+    return content.text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}

package/lib/types/utils/debug.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Debug logger for the ported Ink core. Writes to stderr only when
+ * `CC_TUI_DEBUG` is set, so normal runs stay quiet.
+ * @param message - The message to log.
+ * @param fields - Optional JSON-serialized fields appended to the line.
+ */
+export declare function logForDebugging(message: string, fields?: Record<string, unknown>): void;
+//# sourceMappingURL=debug.d.ts.map

package/lib/types/utils/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/utils/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIvF"}

package/lib/types/utils/debug.js

@@ -0,0 +1,12 @@
+/**
+ * Debug logger for the ported Ink core. Writes to stderr only when
+ * `CC_TUI_DEBUG` is set, so normal runs stay quiet.
+ * @param message - The message to log.
+ * @param fields - Optional JSON-serialized fields appended to the line.
+ */
+export function logForDebugging(message, fields) {
+    if (!process.env.CC_TUI_DEBUG)
+        return;
+    const suffix = fields === undefined ? '' : ` ${JSON.stringify(fields)}`;
+    process.stderr.write(`[dsh-tui] ${message}${suffix}\n`);
+}

package/lib/types/utils/earlyInput.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The ported Ink core calls this once stdin handoff completes
+ * (ink/components/App.tsx). Early-input capture is not used by dsh-tui, so this
+ * is a no-op.
+ */
+export declare function stopCapturingEarlyInput(): void;
+//# sourceMappingURL=earlyInput.d.ts.map

package/lib/types/utils/earlyInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earlyInput.d.ts","sourceRoot":"","sources":["../../../src/utils/earlyInput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAAG"}

package/lib/types/utils/earlyInput.js

@@ -0,0 +1,6 @@
+/**
+ * The ported Ink core calls this once stdin handoff completes
+ * (ink/components/App.tsx). Early-input capture is not used by dsh-tui, so this
+ * is a no-op.
+ */
+export function stopCapturingEarlyInput() { }

package/lib/types/utils/env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Minimal terminal-environment shim for the ported Ink core. The original
+ * module computed a richer `env` object from the Claude Code app context; the
+ * Ink core only reads `env.terminal` (termio/osc.ts chooses the OSC terminator
+ * for Kitty).
+ */
+export declare const env: {
+    readonly terminal: string;
+};
+//# sourceMappingURL=env.d.ts.map

package/lib/types/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/utils/env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,GAAG,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAE5C,CAAA"}

package/lib/types/utils/env.js

@@ -0,0 +1,9 @@
+/**
+ * Minimal terminal-environment shim for the ported Ink core. The original
+ * module computed a richer `env` object from the Claude Code app context; the
+ * Ink core only reads `env.terminal` (termio/osc.ts chooses the OSC terminator
+ * for Kitty).
+ */
+export const env = {
+    terminal: (process.env.TERM_PROGRAM ?? process.env.TERM ?? 'unknown').toLowerCase(),
+};

package/lib/types/utils/envUtils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Environment truthiness check for the ported Ink core. Accepts the common
+ * shell truthy spellings (`1`, `true`, `yes`, `on`).
+ * @param value - The environment value to interpret.
+ * @returns True for booleans `true` and the truthy spellings, false otherwise.
+ */
+export declare function isEnvTruthy(value: string | boolean | undefined | null): boolean;
+//# sourceMappingURL=envUtils.d.ts.map

package/lib/types/utils/envUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/envUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAI/E"}

package/lib/types/utils/envUtils.js

@@ -0,0 +1,13 @@
+/**
+ * Environment truthiness check for the ported Ink core. Accepts the common
+ * shell truthy spellings (`1`, `true`, `yes`, `on`).
+ * @param value - The environment value to interpret.
+ * @returns True for booleans `true` and the truthy spellings, false otherwise.
+ */
+export function isEnvTruthy(value) {
+    if (value === undefined || value === null)
+        return false;
+    if (typeof value === 'boolean')
+        return value;
+    return ['1', 'true', 'yes', 'on'].includes(value.toLowerCase());
+}

package/lib/types/utils/execFileNoThrow.d.ts

@@ -0,0 +1,34 @@
+/** The settled outcome of a no-throw command run. */
+export interface ExecFileNoThrowResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Options for {@link execFileNoThrow}: stdin payload, timeout, and child
+ * working directory.
+ */
+export interface ExecFileNoThrowOptions {
+    /** Stdin payload (OSC 52 clipboard helpers and tmux load-buffer). */
+    input?: string;
+    /** Kill the child after this many milliseconds. */
+    timeout?: number;
+    /**
+     * Accepted for call-site compatibility with the original execa-based
+     * implementation; `false` (the only value the Ink core passes) matches this
+     * shim's behavior of running in the current working directory.
+     */
+    useCwd?: boolean;
+    /** Working directory for the child; defaults to the parent's cwd. */
+    cwd?: string;
+}
+/**
+ * Run a command without throwing: resolves with `{ code, stdout, stderr }`
+ * even when the process exits non-zero or cannot spawn.
+ * @param file - The executable path to spawn.
+ * @param args - Command-line arguments; defaults to none.
+ * @param options - Spawn options (input, timeout, cwd).
+ * @returns The process outcome: exit code, captured stdout, and captured stderr.
+ */
+export declare function execFileNoThrow(file: string, args?: readonly string[], options?: ExecFileNoThrowOptions): Promise<ExecFileNoThrowResult>;
+//# sourceMappingURL=execFileNoThrow.d.ts.map

package/lib/types/utils/execFileNoThrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execFileNoThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAoBhC"}

package/lib/types/utils/execFileNoThrow.js

@@ -0,0 +1,31 @@
+import { spawn } from 'node:child_process';
+/**
+ * Run a command without throwing: resolves with `{ code, stdout, stderr }`
+ * even when the process exits non-zero or cannot spawn.
+ * @param file - The executable path to spawn.
+ * @param args - Command-line arguments; defaults to none.
+ * @param options - Spawn options (input, timeout, cwd).
+ * @returns The process outcome: exit code, captured stdout, and captured stderr.
+ */
+export function execFileNoThrow(file, args, options) {
+    return new Promise(resolve => {
+        const child = spawn(file, args ?? [], { timeout: options?.timeout, cwd: options?.cwd });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', () => {
+            resolve({ code: 1, stdout, stderr });
+        });
+        child.on('close', code => {
+            resolve({ code, stdout, stderr });
+        });
+        if (options?.input !== undefined)
+            child.stdin.write(options.input);
+        child.stdin.end();
+    });
+}

package/lib/types/utils/fullscreen.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Whether mouse click handling is disabled for the ported Ink core. dsh-tui
+ * reads its own env flag (`CC_TUI_DISABLE_MOUSE`); the original module
+ * consulted Claude Code's fullscreen state.
+ * @returns True when CC_TUI_DISABLE_MOUSE is set to a truthy value.
+ */
+export declare function isMouseClicksDisabled(): boolean;
+//# sourceMappingURL=fullscreen.d.ts.map

package/lib/types/utils/fullscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullscreen.d.ts","sourceRoot":"","sources":["../../../src/utils/fullscreen.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/lib/types/utils/fullscreen.js

@@ -0,0 +1,10 @@
+import { isEnvTruthy } from './envUtils.js';
+/**
+ * Whether mouse click handling is disabled for the ported Ink core. dsh-tui
+ * reads its own env flag (`CC_TUI_DISABLE_MOUSE`); the original module
+ * consulted Claude Code's fullscreen state.
+ * @returns True when CC_TUI_DISABLE_MOUSE is set to a truthy value.
+ */
+export function isMouseClicksDisabled() {
+    return isEnvTruthy(process.env.CC_TUI_DISABLE_MOUSE);
+}

package/lib/types/utils/intl.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Memoized `Intl.Segmenter` with grapheme granularity, used by the ported Ink
+ * core for width-aware string handling (stringWidth, output, termio parser).
+ * @returns The shared grapheme segmenter, created once on first use.
+ */
+export declare function getGraphemeSegmenter(): Intl.Segmenter;
+//# sourceMappingURL=intl.d.ts.map

package/lib/types/utils/intl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.d.ts","sourceRoot":"","sources":["../../../src/utils/intl.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAAC,SAAS,CAErD"}

package/lib/types/utils/intl.js

@@ -0,0 +1,9 @@
+let graphemeSegmenter;
+/**
+ * Memoized `Intl.Segmenter` with grapheme granularity, used by the ported Ink
+ * core for width-aware string handling (stringWidth, output, termio parser).
+ * @returns The shared grapheme segmenter, created once on first use.
+ */
+export function getGraphemeSegmenter() {
+    return (graphemeSegmenter ??= new Intl.Segmenter('en', { granularity: 'grapheme' }));
+}

package/lib/types/utils/loaded-context.d.ts

@@ -0,0 +1,20 @@
+import type { LoadedContext } from '../channel.js';
+/** Per-entry display cap: the panel shows the beginning of long texts. */
+export declare const CONTEXT_ENTRY_MAX_CHARS = 800;
+/**
+ * Truncate one entry's text for the panel body. The model-visible text is
+ * the source of truth and stays complete in the session log; the panel only
+ * bounds its own rendering.
+ * @param text - the interpolated model-visible text.
+ * @param max - character cap, defaults to {@link CONTEXT_ENTRY_MAX_CHARS}.
+ * @returns the text, or its head plus a truncation marker.
+ */
+export declare function truncateContextText(text: string, max?: number): string;
+/**
+ * One-line collapsed summary of a loaded-context snapshot, naming only the
+ * non-empty groups (`${t('context-sections', { n: context.sections.length })} · ${t('context-files', { n: context.files.length })} · ${t('context-skills', { n: context.skills.length })} · ${t('context-tools', { n: context.tools.length })}`).
+ * @param context - the loaded-context snapshot.
+ * @returns the summary, or `''` when every group is empty.
+ */
+export declare function summarizeLoadedContext(context: LoadedContext): string;
+//# sourceMappingURL=loaded-context.d.ts.map

package/lib/types/utils/loaded-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-context.d.ts","sourceRoot":"","sources":["../../../src/utils/loaded-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAGlD,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAA0B,GAAG,MAAM,CAGvF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAQrE"}

package/lib/types/utils/loaded-context.js

@@ -0,0 +1,36 @@
+import { t } from '../i18n.js';
+/** Per-entry display cap: the panel shows the beginning of long texts. */
+export const CONTEXT_ENTRY_MAX_CHARS = 800;
+/**
+ * Truncate one entry's text for the panel body. The model-visible text is
+ * the source of truth and stays complete in the session log; the panel only
+ * bounds its own rendering.
+ * @param text - the interpolated model-visible text.
+ * @param max - character cap, defaults to {@link CONTEXT_ENTRY_MAX_CHARS}.
+ * @returns the text, or its head plus a truncation marker.
+ */
+export function truncateContextText(text, max = CONTEXT_ENTRY_MAX_CHARS) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max)}${t('context-truncated')}`;
+}
+/**
+ * One-line collapsed summary of a loaded-context snapshot, naming only the
+ * non-empty groups (`${t('context-sections', { n: context.sections.length })} · ${t('context-files', { n: context.files.length })} · ${t('context-skills', { n: context.skills.length })} · ${t('context-tools', { n: context.tools.length })}`).
+ * @param context - the loaded-context snapshot.
+ * @returns the summary, or `''` when every group is empty.
+ */
+export function summarizeLoadedContext(context) {
+    const parts = [];
+    if (context.sections.length > 0)
+        parts.push(t('context-sections', { n: context.sections.length }));
+    if (context.files.length > 0)
+        parts.push(t('context-files', { n: context.files.length }));
+    if (context.contexts.length > 0)
+        parts.push(t('context-runtime', { n: context.contexts.length }));
+    if (context.skills.length > 0)
+        parts.push(t('context-skills', { n: context.skills.length }));
+    if (context.tools.length > 0)
+        parts.push(t('context-tools', { n: context.tools.length }));
+    return parts.join(' · ');
+}

package/lib/types/utils/log.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error logger for the ported Ink core. Always writes to stderr (an Ink
+ * renderer failure must never pass silently).
+ * @param error - The error to log; its stack trace when available.
+ */
+export declare function logError(error: unknown): void;
+//# sourceMappingURL=log.d.ts.map

package/lib/types/utils/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/utils/log.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAG7C"}

package/lib/types/utils/log.js

@@ -0,0 +1,9 @@
+/**
+ * Error logger for the ported Ink core. Always writes to stderr (an Ink
+ * renderer failure must never pass silently).
+ * @param error - The error to log; its stack trace when available.
+ */
+export function logError(error) {
+    const text = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`[dsh-tui] ${text}\n`);
+}