@askdkc/dsh-cli 0.11.3

package/lib/types/ink/termio/tokenize.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Input Tokenizer - Escape sequence boundary detection
+ *
+ * Splits terminal input into tokens: text chunks and raw escape sequences.
+ * Unlike the Parser which interprets sequences semantically, this just
+ * identifies boundaries for use by keyboard input parsing.
+ */
+/** A chunk of terminal input: plain text or a raw escape sequence. */
+export type Token = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'sequence';
+    value: string;
+};
+/** Streaming tokenizer for terminal input, buffering incomplete sequences. */
+export type Tokenizer = {
+    /** Feed input and get resulting tokens */
+    feed(input: string): Token[];
+    /** Flush any buffered incomplete sequences */
+    flush(): Token[];
+    /** Reset tokenizer state */
+    reset(): void;
+    /** Get any buffered incomplete sequence */
+    buffer(): string;
+};
+type TokenizerOptions = {
+    /**
+     * Treat `CSI M` as an X10 mouse event prefix and consume 3 payload bytes.
+     * Only enable for stdin input — `\x1b[M` is also CSI DL (Delete Lines) in
+     * output streams, and enabling this there swallows display text. Default false.
+     */
+    x10Mouse?: boolean;
+    /**
+     * Emit standalone C0/DEL input controls as sequence tokens instead of
+     * merging them with adjacent text. Intended for stdin key parsing; output
+     * parsers leave this disabled so controls such as BEL and Tab remain text.
+     */
+    splitInputControls?: boolean;
+};
+/**
+ * Create a streaming tokenizer for terminal input.
+ *
+ * Usage:
+ * ```typescript
+ * const tokenizer = createTokenizer()
+ * const tokens1 = tokenizer.feed('hello\x1b[')
+ * const tokens2 = tokenizer.feed('A')  // completes the escape sequence
+ * const remaining = tokenizer.flush()  // force output incomplete sequences
+ * ```
+ * @param options - tokenizer options; when omitted all defaults apply.
+ * @returns the tokenizer instance.
+ */
+export declare function createTokenizer(options?: TokenizerOptions): Tokenizer;
+export {};
+//# sourceMappingURL=tokenize.d.ts.map

package/lib/types/ink/termio/tokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../../../src/ink/termio/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,sEAAsE;AACtE,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAYvC,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG;IACtB,0CAA0C;IAC1C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAAA;IAC5B,8CAA8C;IAC9C,KAAK,IAAI,KAAK,EAAE,CAAA;IAChB,4BAA4B;IAC5B,KAAK,IAAI,IAAI,CAAA;IACb,2CAA2C;IAC3C,MAAM,IAAI,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CA4CrE"}

package/lib/types/ink/termio/tokenize.js

@@ -0,0 +1,290 @@
+/**
+ * Input Tokenizer - Escape sequence boundary detection
+ *
+ * Splits terminal input into tokens: text chunks and raw escape sequences.
+ * Unlike the Parser which interprets sequences semantically, this just
+ * identifies boundaries for use by keyboard input parsing.
+ */
+import { C0, ESC_TYPE, isC0, isEscFinal } from './ansi.js';
+import { isCSIFinal, isCSIIntermediate, isCSIParam } from './csi.js';
+/**
+ * Create a streaming tokenizer for terminal input.
+ *
+ * Usage:
+ * ```typescript
+ * const tokenizer = createTokenizer()
+ * const tokens1 = tokenizer.feed('hello\x1b[')
+ * const tokens2 = tokenizer.feed('A')  // completes the escape sequence
+ * const remaining = tokenizer.flush()  // force output incomplete sequences
+ * ```
+ * @param options - tokenizer options; when omitted all defaults apply.
+ * @returns the tokenizer instance.
+ */
+export function createTokenizer(options) {
+    let currentState = 'ground';
+    let currentBuffer = '';
+    const x10Mouse = options?.x10Mouse ?? false;
+    const splitInputControls = options?.splitInputControls ?? false;
+    return {
+        feed(input) {
+            const result = tokenize(input, currentState, currentBuffer, false, x10Mouse, splitInputControls);
+            currentState = result.state.state;
+            currentBuffer = result.state.buffer;
+            return result.tokens;
+        },
+        flush() {
+            const result = tokenize('', currentState, currentBuffer, true, x10Mouse, splitInputControls);
+            currentState = result.state.state;
+            currentBuffer = result.state.buffer;
+            return result.tokens;
+        },
+        reset() {
+            currentState = 'ground';
+            currentBuffer = '';
+        },
+        buffer() {
+            return currentBuffer;
+        },
+    };
+}
+function tokenize(input, initialState, initialBuffer, flush, x10Mouse, splitInputControls) {
+    const tokens = [];
+    const result = {
+        state: initialState,
+        buffer: '',
+    };
+    const data = initialBuffer + input;
+    let i = 0;
+    let textStart = 0;
+    let seqStart = 0;
+    const flushText = () => {
+        if (i > textStart) {
+            const text = data.slice(textStart, i);
+            if (text) {
+                tokens.push({ type: 'text', value: text });
+            }
+        }
+        textStart = i;
+    };
+    const emitSequence = (seq) => {
+        if (seq) {
+            tokens.push({ type: 'sequence', value: seq });
+        }
+        result.state = 'ground';
+        textStart = i;
+    };
+    while (i < data.length) {
+        const code = data.charCodeAt(i);
+        switch (result.state) {
+            case 'ground':
+                if (code === C0.ESC) {
+                    flushText();
+                    seqStart = i;
+                    result.state = 'escape';
+                    i++;
+                }
+                else if (splitInputControls &&
+                    isC0(code) &&
+                    code !== C0.CR &&
+                    code !== C0.LF) {
+                    // stdin.read() can coalesce printable text and interactive control
+                    // keys into one chunk. Keep Backspace, Tab, Ctrl+C, etc. as their
+                    // own tokens so parseKeypress can expose the corresponding key
+                    // flags instead of leaking the control byte into prompt text.
+                    // CR/LF stay in text chunks for the Windows piped-line fallback.
+                    flushText();
+                    i++;
+                    emitSequence(data.slice(i - 1, i));
+                }
+                else {
+                    i++;
+                }
+                break;
+            case 'escape':
+                if (code === ESC_TYPE.CSI) {
+                    result.state = 'csi';
+                    i++;
+                }
+                else if (code === ESC_TYPE.OSC) {
+                    result.state = 'osc';
+                    i++;
+                }
+                else if (code === ESC_TYPE.DCS) {
+                    result.state = 'dcs';
+                    i++;
+                }
+                else if (code === ESC_TYPE.APC) {
+                    result.state = 'apc';
+                    i++;
+                }
+                else if (code === 0x4f) {
+                    // 'O' - SS3
+                    result.state = 'ss3';
+                    i++;
+                }
+                else if (isCSIIntermediate(code)) {
+                    // Intermediate byte (e.g., ESC ( for charset) - continue buffering
+                    result.state = 'escapeIntermediate';
+                    i++;
+                }
+                else if (isEscFinal(code)) {
+                    // Two-character escape sequence
+                    i++;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else if (code === C0.CR || code === C0.LF) {
+                    // Meta+Enter: ESC CR / ESC LF is how Option+Enter arrives from
+                    // terminals without extended key reporting ("Use Option as Meta").
+                    // CR/LF aren't ESC final bytes, but emitting the pair as a
+                    // sequence lets the keypress parser recognize it — otherwise it
+                    // merges with following text ('\x1b\rabc') and the CR submits
+                    // the prompt instead of inserting a newline (#110).
+                    i++;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else if (code === C0.ESC) {
+                    // Double escape - emit first, start new
+                    emitSequence(data.slice(seqStart, i));
+                    seqStart = i;
+                    result.state = 'escape';
+                    i++;
+                }
+                else {
+                    // Invalid - treat ESC as text
+                    result.state = 'ground';
+                    textStart = seqStart;
+                }
+                break;
+            case 'escapeIntermediate':
+                // After intermediate byte(s), wait for final byte
+                if (isCSIIntermediate(code)) {
+                    // More intermediate bytes
+                    i++;
+                }
+                else if (isEscFinal(code)) {
+                    // Final byte - complete the sequence
+                    i++;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else {
+                    // Invalid - treat as text
+                    result.state = 'ground';
+                    textStart = seqStart;
+                }
+                break;
+            case 'csi':
+                // X10 mouse: CSI M + 3 raw payload bytes (Cb+32, Cx+32, Cy+32).
+                // M immediately after [ (offset 2) means no params — SGR mouse
+                // (CSI < … M) has a `<` param byte first and reaches M at offset > 2.
+                // Terminals that ignore DECSET 1006 but honor 1000/1002 emit this
+                // legacy encoding; without this branch the 3 payload bytes leak
+                // through as text (`` `rK `` / `arK` garbage in the prompt).
+                //
+                // Gated on x10Mouse — `\x1b[M` is also CSI DL (Delete Lines) and
+                // blindly consuming 3 chars corrupts output rendering (Parser/Ansi)
+                // and fragments bracketed-paste PASTE_END. Only stdin enables this.
+                // The ≥0x20 check on each payload slot is belt-and-suspenders: X10
+                // guarantees Cb≥32, Cx≥33, Cy≥33, so a control byte (ESC=0x1B) in
+                // any slot means this is CSI DL adjacent to another sequence, not a
+                // mouse event. Checking all three slots prevents PASTE_END's ESC
+                // from being consumed when paste content ends in `\x1b[M`+0-2 chars.
+                //
+                // Known limitation: this counts JS string chars, but X10 is byte-
+                // oriented and stdin uses utf8 encoding (App.tsx). At col 162-191 ×
+                // row 96-159 the two coord bytes (0xC2-0xDF, 0x80-0xBF) form a valid
+                // UTF-8 2-byte sequence and collapse to one char — the length check
+                // fails and the event buffers until the next keypress absorbs it.
+                // Fixing this requires latin1 stdin; X10's 223-coord cap is exactly
+                // why SGR was invented, and no-SGR terminals at 162+ cols are rare.
+                if (x10Mouse &&
+                    code === 0x4d /* M */ &&
+                    i - seqStart === 2 &&
+                    (i + 1 >= data.length || data.charCodeAt(i + 1) >= 0x20) &&
+                    (i + 2 >= data.length || data.charCodeAt(i + 2) >= 0x20) &&
+                    (i + 3 >= data.length || data.charCodeAt(i + 3) >= 0x20)) {
+                    if (i + 4 <= data.length) {
+                        i += 4;
+                        emitSequence(data.slice(seqStart, i));
+                    }
+                    else {
+                        // Incomplete — exit loop; end-of-input buffers from seqStart.
+                        // Re-entry re-tokenizes from ground via the invalid-CSI fallthrough.
+                        i = data.length;
+                    }
+                    break;
+                }
+                if (isCSIFinal(code)) {
+                    i++;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else if (isCSIParam(code) || isCSIIntermediate(code)) {
+                    i++;
+                }
+                else {
+                    // Invalid CSI - abort, treat as text
+                    result.state = 'ground';
+                    textStart = seqStart;
+                }
+                break;
+            case 'ss3':
+                // SS3 sequences: ESC O followed by a single final byte
+                if (code >= 0x40 && code <= 0x7e) {
+                    i++;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else {
+                    // Invalid - treat as text
+                    result.state = 'ground';
+                    textStart = seqStart;
+                }
+                break;
+            case 'osc':
+                if (code === C0.BEL) {
+                    i++;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else if (code === C0.ESC &&
+                    i + 1 < data.length &&
+                    data.charCodeAt(i + 1) === ESC_TYPE.ST) {
+                    i += 2;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else {
+                    i++;
+                }
+                break;
+            case 'dcs':
+            case 'apc':
+                if (code === C0.BEL) {
+                    i++;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else if (code === C0.ESC &&
+                    i + 1 < data.length &&
+                    data.charCodeAt(i + 1) === ESC_TYPE.ST) {
+                    i += 2;
+                    emitSequence(data.slice(seqStart, i));
+                }
+                else {
+                    i++;
+                }
+                break;
+        }
+    }
+    // Handle end of input
+    if (result.state === 'ground') {
+        flushText();
+    }
+    else if (flush) {
+        // Force output incomplete sequence
+        const remaining = data.slice(seqStart);
+        if (remaining)
+            tokens.push({ type: 'sequence', value: remaining });
+        result.state = 'ground';
+    }
+    else {
+        // Buffer incomplete sequence for next call
+        result.buffer = data.slice(seqStart);
+    }
+    return { tokens, state: result };
+}

package/lib/types/ink/termio/types.d.ts

@@ -0,0 +1,211 @@
+/**
+ * ANSI Parser - Semantic Types
+ *
+ * These types represent the semantic meaning of ANSI escape sequences,
+ * not their string representation. Inspired by ghostty's action-based design.
+ */
+/** Named colors from the 16-color palette */
+export type NamedColor = 'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'brightBlack' | 'brightRed' | 'brightGreen' | 'brightYellow' | 'brightBlue' | 'brightMagenta' | 'brightCyan' | 'brightWhite';
+/** Color specification - can be named, indexed (256), or RGB */
+export type Color = {
+    type: 'named';
+    name: NamedColor;
+} | {
+    type: 'indexed';
+    index: number;
+} | {
+    type: 'rgb';
+    r: number;
+    g: number;
+    b: number;
+} | {
+    type: 'default';
+};
+/** Underline style variants */
+export type UnderlineStyle = 'none' | 'single' | 'double' | 'curly' | 'dotted' | 'dashed';
+/** Text style attributes - represents current styling state */
+export type TextStyle = {
+    bold: boolean;
+    dim: boolean;
+    italic: boolean;
+    underline: UnderlineStyle;
+    blink: boolean;
+    inverse: boolean;
+    hidden: boolean;
+    strikethrough: boolean;
+    overline: boolean;
+    fg: Color;
+    bg: Color;
+    underlineColor: Color;
+};
+/**
+ * Create a default (reset) text style.
+ * @returns a TextStyle with every attribute at its reset value.
+ */
+export declare function defaultStyle(): TextStyle;
+/**
+ * Check if two styles are equal.
+ * @param a - the first style.
+ * @param b - the second style.
+ * @returns true when every attribute and color of the two styles matches.
+ */
+export declare function stylesEqual(a: TextStyle, b: TextStyle): boolean;
+/**
+ * Check if two colors are equal.
+ * @param a - the first color.
+ * @param b - the second color.
+ * @returns true when the two colors have the same type and value.
+ */
+export declare function colorsEqual(a: Color, b: Color): boolean;
+/** Direction of a relative cursor move. */
+export type CursorDirection = 'up' | 'down' | 'forward' | 'back';
+/** Cursor actions: relative moves, absolute position, visibility, style, save/restore, and line jumps. */
+export type CursorAction = {
+    type: 'move';
+    direction: CursorDirection;
+    count: number;
+} | {
+    type: 'position';
+    row: number;
+    col: number;
+} | {
+    type: 'column';
+    col: number;
+} | {
+    type: 'row';
+    row: number;
+} | {
+    type: 'save';
+} | {
+    type: 'restore';
+} | {
+    type: 'show';
+} | {
+    type: 'hide';
+} | {
+    type: 'style';
+    style: 'block' | 'underline' | 'bar';
+    blinking: boolean;
+} | {
+    type: 'nextLine';
+    count: number;
+} | {
+    type: 'prevLine';
+    count: number;
+};
+/** Erase actions targeting display regions, lines, or character counts. */
+export type EraseAction = {
+    type: 'display';
+    region: 'toEnd' | 'toStart' | 'all' | 'scrollback';
+} | {
+    type: 'line';
+    region: 'toEnd' | 'toStart' | 'all';
+} | {
+    type: 'chars';
+    count: number;
+};
+/** Scroll actions: scroll up, scroll down, or set the scroll region. */
+export type ScrollAction = {
+    type: 'up';
+    count: number;
+} | {
+    type: 'down';
+    count: number;
+} | {
+    type: 'setRegion';
+    top: number;
+    bottom: number;
+};
+/** Terminal mode toggles: alternate screen, bracketed paste, mouse tracking, focus events. */
+export type ModeAction = {
+    type: 'alternateScreen';
+    enabled: boolean;
+} | {
+    type: 'bracketedPaste';
+    enabled: boolean;
+} | {
+    type: 'mouseTracking';
+    mode: 'off' | 'normal' | 'button' | 'any';
+} | {
+    type: 'focusEvents';
+    enabled: boolean;
+};
+/** OSC 8 hyperlink actions: start a link with a URL and optional params, or end the current link. */
+export type LinkAction = {
+    type: 'start';
+    url: string;
+    params?: Record<string, string>;
+} | {
+    type: 'end';
+};
+/** Window title actions from OSC 0/1/2: set window title, icon name, or both. */
+export type TitleAction = {
+    type: 'windowTitle';
+    title: string;
+} | {
+    type: 'iconName';
+    name: string;
+} | {
+    type: 'both';
+    title: string;
+};
+/**
+ * Per-tab chrome metadata. Tristate for each field:
+ *  - property absent → not mentioned in sequence, no change
+ *  - null → explicitly cleared (bare key or key= with empty value)
+ *  - value → set to this
+ */
+export type TabStatusAction = {
+    indicator?: Color | null;
+    status?: string | null;
+    statusColor?: Color | null;
+};
+/** A segment of styled text */
+export type TextSegment = {
+    type: 'text';
+    text: string;
+    style: TextStyle;
+};
+/** A grapheme (visual character unit) with width info */
+export type Grapheme = {
+    value: string;
+    width: 1 | 2;
+};
+/** All possible parsed actions */
+export type Action = {
+    type: 'text';
+    graphemes: Grapheme[];
+    style: TextStyle;
+} | {
+    type: 'cursor';
+    action: CursorAction;
+} | {
+    type: 'erase';
+    action: EraseAction;
+} | {
+    type: 'scroll';
+    action: ScrollAction;
+} | {
+    type: 'mode';
+    action: ModeAction;
+} | {
+    type: 'link';
+    action: LinkAction;
+} | {
+    type: 'title';
+    action: TitleAction;
+} | {
+    type: 'tabStatus';
+    action: TabStatusAction;
+} | {
+    type: 'sgr';
+    params: string;
+} | {
+    type: 'bell';
+} | {
+    type: 'reset';
+} | {
+    type: 'unknown';
+    sequence: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types/ink/termio/types.d.ts.map

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

package/lib/types/ink/termio/types.js

@@ -0,0 +1,68 @@
+/**
+ * ANSI Parser - Semantic Types
+ *
+ * These types represent the semantic meaning of ANSI escape sequences,
+ * not their string representation. Inspired by ghostty's action-based design.
+ */
+/**
+ * Create a default (reset) text style.
+ * @returns a TextStyle with every attribute at its reset value.
+ */
+export function defaultStyle() {
+    return {
+        bold: false,
+        dim: false,
+        italic: false,
+        underline: 'none',
+        blink: false,
+        inverse: false,
+        hidden: false,
+        strikethrough: false,
+        overline: false,
+        fg: { type: 'default' },
+        bg: { type: 'default' },
+        underlineColor: { type: 'default' },
+    };
+}
+/**
+ * Check if two styles are equal.
+ * @param a - the first style.
+ * @param b - the second style.
+ * @returns true when every attribute and color of the two styles matches.
+ */
+export function stylesEqual(a, b) {
+    return (a.bold === b.bold &&
+        a.dim === b.dim &&
+        a.italic === b.italic &&
+        a.underline === b.underline &&
+        a.blink === b.blink &&
+        a.inverse === b.inverse &&
+        a.hidden === b.hidden &&
+        a.strikethrough === b.strikethrough &&
+        a.overline === b.overline &&
+        colorsEqual(a.fg, b.fg) &&
+        colorsEqual(a.bg, b.bg) &&
+        colorsEqual(a.underlineColor, b.underlineColor));
+}
+/**
+ * Check if two colors are equal.
+ * @param a - the first color.
+ * @param b - the second color.
+ * @returns true when the two colors have the same type and value.
+ */
+export function colorsEqual(a, b) {
+    if (a.type !== b.type)
+        return false;
+    switch (a.type) {
+        case 'named':
+            return a.name === b.name;
+        case 'indexed':
+            return a.index === b.index;
+        case 'rgb':
+            return (a.r === b.r &&
+                a.g === b.g &&
+                a.b === b.b);
+        case 'default':
+            return true;
+    }
+}

package/lib/types/ink/termio.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ANSI Parser Module
+ *
+ * A semantic ANSI escape sequence parser inspired by ghostty, tmux, and iTerm2.
+ *
+ * Key features:
+ * - Semantic output: produces structured actions, not string tokens
+ * - Streaming: can parse input incrementally via Parser class
+ * - Style tracking: maintains text style state across parse calls
+ * - Comprehensive: supports SGR, CSI, OSC, ESC sequences
+ *
+ * Usage:
+ *
+ * ```typescript
+ * import { Parser } from './termio.js'
+ *
+ * const parser = new Parser()
+ * const actions = parser.feed('\x1b[31mred\x1b[0m')
+ * // => [{ type: 'text', graphemes: [...], style: { fg: { type: 'named', name: 'red' }, ... } }]
+ * ```
+ */
+export { Parser } from './termio/parser.js';
+export type { Action, Color, CursorAction, CursorDirection, EraseAction, Grapheme, LinkAction, ModeAction, NamedColor, ScrollAction, TextSegment, TextStyle, TitleAction, UnderlineStyle, } from './termio/types.js';
+export { colorsEqual, defaultStyle, stylesEqual } from './termio/types.js';
+//# sourceMappingURL=termio.d.ts.map

package/lib/types/ink/termio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termio.d.ts","sourceRoot":"","sources":["../../../src/ink/termio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C,YAAY,EACV,MAAM,EACN,KAAK,EACL,YAAY,EACZ,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}