@deepseek-harness-tui/dsh-tui 0.5.0

package/lib/types/ink/colorize.js

@@ -0,0 +1,213 @@
+import chalk from 'chalk';
+/**
+ * xterm.js (VS Code, Cursor, code-server, Coder) has supported truecolor
+ * since 2017, but code-server/Coder containers often don't set
+ * COLORTERM=truecolor. chalk's supports-color doesn't recognize
+ * TERM_PROGRAM=vscode (it only knows iTerm.app/Apple_Terminal), so it falls
+ * through to the -256color regex → level 2. At level 2, chalk.rgb()
+ * downgrades to the nearest 6×6×6 cube color: rgb(215,119,87) (Claude
+ * orange) → idx 174 rgb(215,135,135) — washed-out salmon.
+ *
+ * Gated on level === 2 (not < 3) to respect NO_COLOR / FORCE_COLOR=0 —
+ * those yield level 0 and are an explicit "no colors" request. Desktop VS
+ * Code sets COLORTERM=truecolor itself, so this is a no-op there (already 3).
+ *
+ * Must run BEFORE the tmux clamp — if tmux is running inside a VS Code
+ * terminal, tmux's passthrough limitation wins and we want level 2.
+ */
+function boostChalkLevelForXtermJs() {
+    if (process.env.TERM_PROGRAM === 'vscode' && chalk.level === 2) {
+        chalk.level = 3;
+        return true;
+    }
+    return false;
+}
+/**
+ * tmux parses truecolor SGR (\e[48;2;r;g;bm) into its cell buffer correctly,
+ * but its client-side emitter only re-emits truecolor to the outer terminal if
+ * the outer terminal advertises Tc/RGB capability (via terminal-overrides).
+ * Default tmux config doesn't set this, so tmux emits the cell to iTerm2/etc
+ * WITHOUT the bg sequence — outer terminal's buffer has bg=default → black on
+ * dark profiles. Clamping to level 2 makes chalk emit 256-color (\e[48;5;Nm),
+ * which tmux passes through cleanly. grey93 (255) is visually identical to
+ * rgb(240,240,240).
+ *
+ * Users who HAVE set `terminal-overrides ,*:Tc` get a technically-unnecessary
+ * downgrade, but the visual difference is imperceptible. Querying
+ * `tmux show -gv terminal-overrides` to detect this would add a subprocess on
+ * startup — not worth it.
+ *
+ * $TMUX is a pty-lifecycle env var set by tmux itself; it never comes from
+ * globalSettings.env, so reading it here is correct. chalk is a singleton, so
+ * this clamps ALL truecolor output (fg+bg+hex) across the entire app.
+ */
+function clampChalkLevelForTmux() {
+    // bg.ts sets terminal-overrides :Tc before attach, so truecolor passes
+    // through — skip the clamp. General escape hatch for anyone who's
+    // configured their tmux correctly.
+    if (process.env.CLAUDE_CODE_TMUX_TRUECOLOR)
+        return false;
+    if (process.env.TMUX && chalk.level > 2) {
+        chalk.level = 2;
+        return true;
+    }
+    return false;
+}
+// Computed once at module load — terminal/tmux environment doesn't change mid-session.
+// Order matters: boost first so the tmux clamp can re-clamp if tmux is running
+// inside a VS Code terminal. Exported for debugging — tree-shaken if unused.
+/** Whether chalk's color level was boosted to 3 for xterm.js terminals. */
+export const CHALK_BOOSTED_FOR_XTERMJS = boostChalkLevelForXtermJs();
+/** Whether chalk's color level was clamped to 2 for tmux passthrough. */
+export const CHALK_CLAMPED_FOR_TMUX = clampChalkLevelForTmux();
+const RGB_REGEX = /^rgb\(\s?(\d+),\s?(\d+),\s?(\d+)\s?\)$/;
+const ANSI_REGEX = /^ansi256\(\s?(\d+)\s?\)$/;
+/**
+ * Apply a raw color value to a string using chalk.
+ * @param str - the text to color.
+ * @param color - the raw color value (ansi:*, hex, ansi256, or rgb); empty or unparsable values leave `str` unchanged.
+ * @param type - whether the color applies to foreground or background.
+ * @returns `str` wrapped in the chalk color sequence, or `str` unchanged when no color applies.
+ */
+export const colorize = (str, color, type) => {
+    if (!color) {
+        return str;
+    }
+    if (color.startsWith('ansi:')) {
+        const value = color.substring('ansi:'.length);
+        switch (value) {
+            case 'black':
+                return type === 'foreground' ? chalk.black(str) : chalk.bgBlack(str);
+            case 'red':
+                return type === 'foreground' ? chalk.red(str) : chalk.bgRed(str);
+            case 'green':
+                return type === 'foreground' ? chalk.green(str) : chalk.bgGreen(str);
+            case 'yellow':
+                return type === 'foreground' ? chalk.yellow(str) : chalk.bgYellow(str);
+            case 'blue':
+                return type === 'foreground' ? chalk.blue(str) : chalk.bgBlue(str);
+            case 'magenta':
+                return type === 'foreground' ? chalk.magenta(str) : chalk.bgMagenta(str);
+            case 'cyan':
+                return type === 'foreground' ? chalk.cyan(str) : chalk.bgCyan(str);
+            case 'white':
+                return type === 'foreground' ? chalk.white(str) : chalk.bgWhite(str);
+            case 'blackBright':
+                return type === 'foreground'
+                    ? chalk.blackBright(str)
+                    : chalk.bgBlackBright(str);
+            case 'redBright':
+                return type === 'foreground'
+                    ? chalk.redBright(str)
+                    : chalk.bgRedBright(str);
+            case 'greenBright':
+                return type === 'foreground'
+                    ? chalk.greenBright(str)
+                    : chalk.bgGreenBright(str);
+            case 'yellowBright':
+                return type === 'foreground'
+                    ? chalk.yellowBright(str)
+                    : chalk.bgYellowBright(str);
+            case 'blueBright':
+                return type === 'foreground'
+                    ? chalk.blueBright(str)
+                    : chalk.bgBlueBright(str);
+            case 'magentaBright':
+                return type === 'foreground'
+                    ? chalk.magentaBright(str)
+                    : chalk.bgMagentaBright(str);
+            case 'cyanBright':
+                return type === 'foreground'
+                    ? chalk.cyanBright(str)
+                    : chalk.bgCyanBright(str);
+            case 'whiteBright':
+                return type === 'foreground'
+                    ? chalk.whiteBright(str)
+                    : chalk.bgWhiteBright(str);
+        }
+    }
+    if (color.startsWith('#')) {
+        return type === 'foreground'
+            ? chalk.hex(color)(str)
+            : chalk.bgHex(color)(str);
+    }
+    if (color.startsWith('ansi256')) {
+        const matches = ANSI_REGEX.exec(color);
+        if (!matches) {
+            return str;
+        }
+        const value = Number(matches[1]);
+        return type === 'foreground'
+            ? chalk.ansi256(value)(str)
+            : chalk.bgAnsi256(value)(str);
+    }
+    if (color.startsWith('rgb')) {
+        const matches = RGB_REGEX.exec(color);
+        if (!matches) {
+            return str;
+        }
+        const firstValue = Number(matches[1]);
+        const secondValue = Number(matches[2]);
+        const thirdValue = Number(matches[3]);
+        return type === 'foreground'
+            ? chalk.rgb(firstValue, secondValue, thirdValue)(str)
+            : chalk.bgRgb(firstValue, secondValue, thirdValue)(str);
+    }
+    return str;
+};
+/**
+ * Apply TextStyles to a string using chalk.
+ * This is the inverse of parsing ANSI codes - we generate them from structured styles.
+ * Theme resolution happens at component layer, not here.
+ * @param text - the text to style.
+ * @param styles - the structured styles to apply.
+ * @returns `text` wrapped in the chalk sequences for the enabled styles.
+ */
+export function applyTextStyles(text, styles) {
+    let result = text;
+    // Apply styles in reverse order of desired nesting.
+    // chalk wraps text so later calls become outer wrappers.
+    // Desired order (outermost to innermost):
+    //   background > foreground > text modifiers
+    // So we apply: text modifiers first, then foreground, then background last.
+    if (styles.inverse) {
+        result = chalk.inverse(result);
+    }
+    if (styles.strikethrough) {
+        result = chalk.strikethrough(result);
+    }
+    if (styles.underline) {
+        result = chalk.underline(result);
+    }
+    if (styles.italic) {
+        result = chalk.italic(result);
+    }
+    if (styles.bold) {
+        result = chalk.bold(result);
+    }
+    if (styles.dim) {
+        result = chalk.dim(result);
+    }
+    if (styles.color) {
+        // Color is now always a raw color value (theme resolution happens at component layer)
+        result = colorize(result, styles.color, 'foreground');
+    }
+    if (styles.backgroundColor) {
+        // backgroundColor is now always a raw color value
+        result = colorize(result, styles.backgroundColor, 'background');
+    }
+    return result;
+}
+/**
+ * Apply a raw color value to text.
+ * Theme resolution should happen at component layer, not here.
+ * @param text - the text to color.
+ * @param color - the raw foreground color value; undefined or empty leaves `text` unchanged.
+ * @returns `text` wrapped in the foreground color sequence.
+ */
+export function applyColor(text, color) {
+    if (!color) {
+        return text;
+    }
+    return colorize(text, color, 'foreground');
+}

package/lib/types/ink/components/AlternateScreen.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Run children in the terminal's alternate screen buffer, constrained to
+ * the viewport height. While mounted:
+ *
+ * - Enters the alt screen (DEC 1049), clears it, homes the cursor
+ * - Constrains its own height to the terminal row count, so overflow must
+ *   be handled via `overflow: scroll` / flexbox (no native scrollback)
+ * - Optionally enables SGR mouse tracking (wheel + click/drag) — events
+ *   surface as `ParsedKey` (wheel) and update the Ink instance's
+ *   selection state (click/drag)
+ *
+ * On unmount, disables mouse tracking and exits the alt screen, restoring
+ * the main screen's content. Safe for use in ctrl-o transcript overlays
+ * and similar temporary fullscreen views — the main screen is preserved.
+ *
+ * Notifies the Ink instance via `setAltScreenActive()` so the renderer
+ * keeps the cursor inside the viewport (preventing the cursor-restore LF
+ * from scrolling content) and so signal-exit cleanup can exit the alt
+ * screen if the component's own unmount doesn't run.
+ */
+export declare function AlternateScreen(t0: any): any;
+//# sourceMappingURL=AlternateScreen.d.ts.map

package/lib/types/ink/components/AlternateScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlternateScreen.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/AlternateScreen.tsx"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAA,OA8CjC"}

package/lib/types/ink/components/AlternateScreen.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { c as _c } from "react/compiler-runtime";
+import { useContext, useInsertionEffect } from 'react';
+import instances from '../instances.js';
+import { DISABLE_MOUSE_TRACKING, ENABLE_MOUSE_TRACKING, ENTER_ALT_SCREEN, EXIT_ALT_SCREEN } from '../termio/dec.js';
+import { TerminalWriteContext } from '../useTerminalNotification.js';
+import Box from './Box.js';
+import { TerminalSizeContext } from './TerminalSizeContext.js';
+/**
+ * Run children in the terminal's alternate screen buffer, constrained to
+ * the viewport height. While mounted:
+ *
+ * - Enters the alt screen (DEC 1049), clears it, homes the cursor
+ * - Constrains its own height to the terminal row count, so overflow must
+ *   be handled via `overflow: scroll` / flexbox (no native scrollback)
+ * - Optionally enables SGR mouse tracking (wheel + click/drag) — events
+ *   surface as `ParsedKey` (wheel) and update the Ink instance's
+ *   selection state (click/drag)
+ *
+ * On unmount, disables mouse tracking and exits the alt screen, restoring
+ * the main screen's content. Safe for use in ctrl-o transcript overlays
+ * and similar temporary fullscreen views — the main screen is preserved.
+ *
+ * Notifies the Ink instance via `setAltScreenActive()` so the renderer
+ * keeps the cursor inside the viewport (preventing the cursor-restore LF
+ * from scrolling content) and so signal-exit cleanup can exit the alt
+ * screen if the component's own unmount doesn't run.
+ */
+export function AlternateScreen(t0) {
+    const $ = _c(7);
+    const { children, mouseTracking: t1 } = t0;
+    const mouseTracking = t1 === undefined ? true : t1;
+    const size = useContext(TerminalSizeContext);
+    const writeRaw = useContext(TerminalWriteContext);
+    let t2;
+    let t3;
+    if ($[0] !== mouseTracking || $[1] !== writeRaw) {
+        t2 = () => {
+            const ink = instances.get(process.stdout);
+            if (!writeRaw) {
+                return;
+            }
+            writeRaw(ENTER_ALT_SCREEN + "\x1B[2J\x1B[H" + (mouseTracking ? ENABLE_MOUSE_TRACKING : ""));
+            ink?.setAltScreenActive(true, mouseTracking);
+            return () => {
+                ink?.setAltScreenActive(false);
+                ink?.clearTextSelection();
+                writeRaw((mouseTracking ? DISABLE_MOUSE_TRACKING : "") + EXIT_ALT_SCREEN);
+            };
+        };
+        t3 = [writeRaw, mouseTracking];
+        $[0] = mouseTracking;
+        $[1] = writeRaw;
+        $[2] = t2;
+        $[3] = t3;
+    }
+    else {
+        t2 = $[2];
+        t3 = $[3];
+    }
+    useInsertionEffect(t2, t3);
+    const t4 = size?.rows ?? 24;
+    let t5;
+    if ($[4] !== children || $[5] !== t4) {
+        t5 = _jsx(Box, { flexDirection: "column", height: t4, width: "100%", flexShrink: 0, children: children });
+        $[4] = children;
+        $[5] = t4;
+        $[6] = t5;
+    }
+    else {
+        t5 = $[6];
+    }
+    return t5;
+}

package/lib/types/ink/components/App.d.ts

@@ -0,0 +1,73 @@
+import React, { PureComponent, type ReactNode } from "react";
+import { EventEmitter } from "../events/emitter.js";
+import { type ParsedKey, type ParsedMouse } from "../parse-keypress.js";
+import { type SelectionState } from "../selection.js";
+import { TerminalQuerier } from "../terminal-querier.js";
+import { type CursorDeclarationSetter } from "./CursorDeclarationContext.js";
+type Props = {
+    readonly children: ReactNode;
+    readonly stdin: NodeJS.ReadStream;
+    readonly stdout: NodeJS.WriteStream;
+    readonly stderr: NodeJS.WriteStream;
+    readonly exitOnCtrlC: boolean;
+    readonly onExit: (error?: Error) => void;
+    readonly terminalColumns: number;
+    readonly terminalRows: number;
+    readonly selection: SelectionState;
+    readonly onSelectionChange: () => void;
+    readonly onClickAt: (col: number, row: number) => boolean;
+    readonly onHoverAt: (col: number, row: number) => void;
+    readonly getHyperlinkAt: (col: number, row: number) => string | undefined;
+    readonly onOpenHyperlink: (url: string) => void;
+    readonly onMultiClick: (col: number, row: number, count: 2 | 3) => void;
+    readonly onSelectionDrag: (col: number, row: number) => void;
+    readonly onStdinResume?: () => void;
+    readonly onCursorDeclaration?: CursorDeclarationSetter;
+    readonly dispatchKeyboardEvent: (parsedKey: ParsedKey) => void;
+};
+type State = {
+    readonly error?: Error;
+};
+export default class App extends PureComponent<Props, State> {
+    static displayName: string;
+    static getDerivedStateFromError(error: Error): {
+        error: Error;
+    };
+    state: {
+        error: undefined;
+    };
+    rawModeEnabledCount: number;
+    internal_eventEmitter: EventEmitter;
+    keyParseState: import("../parse-keypress.js").KeyParseState;
+    incompleteEscapeTimer: NodeJS.Timeout | null;
+    xtversionProbe: NodeJS.Immediate | null;
+    readonly NORMAL_TIMEOUT = 50;
+    readonly PASTE_TIMEOUT = 500;
+    querier: TerminalQuerier;
+    lastClickTime: number;
+    lastClickCol: number;
+    lastClickRow: number;
+    clickCount: number;
+    pendingHyperlinkTimer: ReturnType<typeof setTimeout> | null;
+    lastHoverCol: number;
+    lastHoverRow: number;
+    lastStdinTime: number;
+    writeRaw: (data: string) => void;
+    isRawModeSupported(): boolean;
+    render(): React.JSX.Element;
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    componentDidCatch(error: Error): void;
+    handleSetRawMode: (isEnabled: boolean) => void;
+    flushIncomplete: () => void;
+    processInput: (input: string | Buffer | null) => void;
+    handleReadable: () => void;
+    handleInput: (input: string | undefined) => void;
+    handleExit: (error?: Error) => void;
+    handleTerminalFocus: (isFocused: boolean) => void;
+    handleSuspend: () => void;
+}
+/** Exported for testing. Mutates app.props.selection and click/hover state. */
+export declare function handleMouseEvent(app: App, m: ParsedMouse): void;
+export {};
+//# sourceMappingURL=App.d.ts.map

package/lib/types/ink/components/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/App.tsx"],"names":[],"mappings":"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"}