@askdkc/dsh-cli 0.11.3

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

@@ -0,0 +1,263 @@
+/**
+ * CSI (Control Sequence Introducer) Types
+ *
+ * Enums and types for CSI command parameters.
+ */
+/** CSI introducer prefix: ESC followed by `[`. */
+export declare const CSI_PREFIX: string;
+/**
+ * CSI parameter byte ranges
+ */
+export declare const CSI_RANGE: {
+    readonly PARAM_START: 48;
+    readonly PARAM_END: 63;
+    readonly INTERMEDIATE_START: 32;
+    readonly INTERMEDIATE_END: 47;
+    readonly FINAL_START: 64;
+    readonly FINAL_END: 126;
+};
+/**
+ * Check if a byte is a CSI parameter byte.
+ * @param byte - the byte value to check.
+ * @returns true when the byte is in the parameter range (0x30-0x3F).
+ */
+export declare function isCSIParam(byte: number): boolean;
+/**
+ * Check if a byte is a CSI intermediate byte.
+ * @param byte - the byte value to check.
+ * @returns true when the byte is in the intermediate range (0x20-0x2F).
+ */
+export declare function isCSIIntermediate(byte: number): boolean;
+/**
+ * Check if a byte is a CSI final byte (@ through ~).
+ * @param byte - the byte value to check.
+ * @returns true when the byte is in the final range (0x40-0x7E).
+ */
+export declare function isCSIFinal(byte: number): boolean;
+/**
+ * Generate a CSI sequence: ESC [ p1;p2;...;pN final.
+ * With a single argument it is treated as the raw body; with multiple
+ * arguments the last is the final byte and the rest are parameters joined
+ * by semicolons.
+ * @param args - the sequence parts.
+ * @returns the complete CSI sequence string.
+ */
+export declare function csi(...args: (string | number)[]): string;
+/**
+ * CSI final bytes - the command identifier
+ */
+export declare const CSI: {
+    readonly CUU: 65;
+    readonly CUD: 66;
+    readonly CUF: 67;
+    readonly CUB: 68;
+    readonly CNL: 69;
+    readonly CPL: 70;
+    readonly CHA: 71;
+    readonly CUP: 72;
+    readonly CHT: 73;
+    readonly VPA: 100;
+    readonly HVP: 102;
+    readonly ED: 74;
+    readonly EL: 75;
+    readonly ECH: 88;
+    readonly IL: 76;
+    readonly DL: 77;
+    readonly ICH: 64;
+    readonly DCH: 80;
+    readonly SU: 83;
+    readonly SD: 84;
+    readonly SM: 104;
+    readonly RM: 108;
+    readonly SGR: 109;
+    readonly DSR: 110;
+    readonly DECSCUSR: 113;
+    readonly DECSTBM: 114;
+    readonly SCOSC: 115;
+    readonly SCORC: 117;
+    readonly CBT: 90;
+};
+/**
+ * Erase in Display regions (ED command parameter)
+ */
+export declare const ERASE_DISPLAY: readonly ["toEnd", "toStart", "all", "scrollback"];
+/**
+ * Erase in Line regions (EL command parameter)
+ */
+export declare const ERASE_LINE_REGION: readonly ["toEnd", "toStart", "all"];
+/**
+ * Cursor styles (DECSCUSR)
+ */
+export type CursorStyle = 'block' | 'underline' | 'bar';
+/**
+ * Cursor style lookup table for DECSCUSR parameter 0-6, pairing each cursor
+ * shape with its blinking flag.
+ */
+export declare const CURSOR_STYLES: Array<{
+    style: CursorStyle;
+    blinking: boolean;
+}>;
+/**
+ * Move cursor up n lines (CSI n A).
+ * @param n - number of lines to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export declare function cursorUp(n?: number): string;
+/**
+ * Move cursor down n lines (CSI n B).
+ * @param n - number of lines to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export declare function cursorDown(n?: number): string;
+/**
+ * Move cursor forward n columns (CSI n C).
+ * @param n - number of columns to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export declare function cursorForward(n?: number): string;
+/**
+ * Move cursor back n columns (CSI n D).
+ * @param n - number of columns to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export declare function cursorBack(n?: number): string;
+/**
+ * Move cursor to column n (1-indexed) (CSI n G).
+ * @param col - the 1-indexed target column.
+ * @returns the CSI sequence.
+ */
+export declare function cursorTo(col: number): string;
+/** Move cursor to column 1 (CSI G) */
+export declare const CURSOR_LEFT: string;
+/**
+ * Move cursor to row, col (1-indexed) (CSI row ; col H).
+ * @param row - the 1-indexed target row.
+ * @param col - the 1-indexed target column.
+ * @returns the CSI sequence.
+ */
+export declare function cursorPosition(row: number, col: number): string;
+/** Move cursor to home position (CSI H) */
+export declare const CURSOR_HOME: string;
+/**
+ * Move cursor relative to current position.
+ * Positive x = right, negative x = left.
+ * Positive y = down, negative y = up.
+ * @param x - horizontal delta in columns.
+ * @param y - vertical delta in rows.
+ * @returns the concatenated CSI sequences, or an empty string when both deltas are 0.
+ */
+export declare function cursorMove(x: number, y: number): string;
+/** Save cursor position (CSI s) */
+export declare const CURSOR_SAVE: string;
+/** Restore cursor position (CSI u) */
+export declare const CURSOR_RESTORE: string;
+/**
+ * Erase from cursor to end of line (CSI K).
+ * @returns the CSI sequence.
+ */
+export declare function eraseToEndOfLine(): string;
+/**
+ * Erase from cursor to start of line (CSI 1 K).
+ * @returns the CSI sequence.
+ */
+export declare function eraseToStartOfLine(): string;
+/**
+ * Erase entire line (CSI 2 K).
+ * @returns the CSI sequence.
+ */
+export declare function eraseLine(): string;
+/** Erase entire line - constant form */
+export declare const ERASE_LINE: string;
+/**
+ * Erase from cursor to end of screen (CSI J).
+ * @returns the CSI sequence.
+ */
+export declare function eraseToEndOfScreen(): string;
+/**
+ * Erase from cursor to start of screen (CSI 1 J).
+ * @returns the CSI sequence.
+ */
+export declare function eraseToStartOfScreen(): string;
+/**
+ * Erase entire screen (CSI 2 J).
+ * @returns the CSI sequence.
+ */
+export declare function eraseScreen(): string;
+/** Erase entire screen - constant form */
+export declare const ERASE_SCREEN: string;
+/** Erase scrollback buffer (CSI 3 J) */
+export declare const ERASE_SCROLLBACK: string;
+/**
+ * Erase n lines starting from the cursor line, moving the cursor up.
+ * This erases each line and moves up, ending at column 1.
+ * @param n - the number of lines to erase.
+ * @returns the combined erase and cursor sequences, or an empty string when
+ *   n is 0 or negative.
+ */
+export declare function eraseLines(n: number): string;
+/** Reset all SGR attributes (CSI 0 m). Erase/scroll sequences fill blank
+ *  cells with the CURRENT background color (BCE) — prefix this before any
+ *  such sequence that must not inherit a possibly-stuck background (e.g.
+ *  after a truncated frame left a colored SGR active). */
+export declare const SGR_RESET: string;
+/**
+ * Scroll up n lines (CSI n S).
+ * @param n - number of lines to scroll; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export declare function scrollUp(n?: number): string;
+/**
+ * Scroll down n lines (CSI n T).
+ * @param n - number of lines to scroll; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export declare function scrollDown(n?: number): string;
+/**
+ * Set scroll region (DECSTBM, CSI top;bottom r). 1-indexed, inclusive.
+ * @param top - the 1-indexed first row of the region.
+ * @param bottom - the 1-indexed last row of the region.
+ * @returns the CSI sequence.
+ */
+export declare function setScrollRegion(top: number, bottom: number): string;
+/** Reset scroll region to full screen (DECSTBM, CSI r). Homes the cursor. */
+export declare const RESET_SCROLL_REGION: string;
+/** Sent by terminal before pasted content (CSI 200 ~) */
+export declare const PASTE_START: string;
+/** Sent by terminal after pasted content (CSI 201 ~) */
+export declare const PASTE_END: string;
+/** Sent by terminal when it gains focus (CSI I) */
+export declare const FOCUS_IN: string;
+/** Sent by terminal when it loses focus (CSI O) */
+export declare const FOCUS_OUT: string;
+/**
+ * Enable Kitty keyboard protocol with basic modifier reporting
+ * CSI > 1 u - pushes mode with flags=1 (disambiguate escape codes)
+ * This makes Shift+Enter send CSI 13;2 u instead of just CR
+ */
+export declare const ENABLE_KITTY_KEYBOARD: string;
+/**
+ * Disable Kitty keyboard protocol
+ * CSI < u - pops the keyboard mode stack
+ */
+export declare const DISABLE_KITTY_KEYBOARD: string;
+/**
+ * Enable xterm modifyOtherKeys level 2.
+ * tmux accepts this (not the kitty stack) to enable extended keys — when
+ * extended-keys-format is csi-u, tmux then emits keys in kitty format.
+ */
+export declare const ENABLE_MODIFY_OTHER_KEYS: string;
+/**
+ * Disable xterm modifyOtherKeys (reset to default).
+ */
+export declare const DISABLE_MODIFY_OTHER_KEYS: string;
+/**
+ * Enable win32-input-mode.
+ * CSI ? 9001 h — every key arrives as CSI Vk;Sc;Uc;Kd;Cs;Rc _
+ */
+export declare const ENABLE_WIN32_INPUT_MODE: string;
+/**
+ * Disable win32-input-mode (restore classic VT input).
+ * CSI ? 9001 l
+ */
+export declare const DISABLE_WIN32_INPUT_MODE: string;
+//# sourceMappingURL=csi.d.ts.map

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

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

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

@@ -0,0 +1,367 @@
+/**
+ * CSI (Control Sequence Introducer) Types
+ *
+ * Enums and types for CSI command parameters.
+ */
+import { ESC, ESC_TYPE, SEP } from './ansi.js';
+/** CSI introducer prefix: ESC followed by `[`. */
+export const CSI_PREFIX = ESC + String.fromCharCode(ESC_TYPE.CSI);
+/**
+ * CSI parameter byte ranges
+ */
+export const CSI_RANGE = {
+    PARAM_START: 0x30,
+    PARAM_END: 0x3f,
+    INTERMEDIATE_START: 0x20,
+    INTERMEDIATE_END: 0x2f,
+    FINAL_START: 0x40,
+    FINAL_END: 0x7e,
+};
+/**
+ * Check if a byte is a CSI parameter byte.
+ * @param byte - the byte value to check.
+ * @returns true when the byte is in the parameter range (0x30-0x3F).
+ */
+export function isCSIParam(byte) {
+    return byte >= CSI_RANGE.PARAM_START && byte <= CSI_RANGE.PARAM_END;
+}
+/**
+ * Check if a byte is a CSI intermediate byte.
+ * @param byte - the byte value to check.
+ * @returns true when the byte is in the intermediate range (0x20-0x2F).
+ */
+export function isCSIIntermediate(byte) {
+    return (byte >= CSI_RANGE.INTERMEDIATE_START && byte <= CSI_RANGE.INTERMEDIATE_END);
+}
+/**
+ * Check if a byte is a CSI final byte (@ through ~).
+ * @param byte - the byte value to check.
+ * @returns true when the byte is in the final range (0x40-0x7E).
+ */
+export function isCSIFinal(byte) {
+    return byte >= CSI_RANGE.FINAL_START && byte <= CSI_RANGE.FINAL_END;
+}
+/**
+ * Generate a CSI sequence: ESC [ p1;p2;...;pN final.
+ * With a single argument it is treated as the raw body; with multiple
+ * arguments the last is the final byte and the rest are parameters joined
+ * by semicolons.
+ * @param args - the sequence parts.
+ * @returns the complete CSI sequence string.
+ */
+export function csi(...args) {
+    if (args.length === 0)
+        return CSI_PREFIX;
+    if (args.length === 1)
+        return `${CSI_PREFIX}${args[0]}`;
+    const params = args.slice(0, -1);
+    const final = args[args.length - 1];
+    return `${CSI_PREFIX}${params.join(SEP)}${final}`;
+}
+/**
+ * CSI final bytes - the command identifier
+ */
+export const CSI = {
+    // Cursor movement
+    CUU: 0x41, // A - Cursor Up
+    CUD: 0x42, // B - Cursor Down
+    CUF: 0x43, // C - Cursor Forward
+    CUB: 0x44, // D - Cursor Back
+    CNL: 0x45, // E - Cursor Next Line
+    CPL: 0x46, // F - Cursor Previous Line
+    CHA: 0x47, // G - Cursor Horizontal Absolute
+    CUP: 0x48, // H - Cursor Position
+    CHT: 0x49, // I - Cursor Horizontal Tab
+    VPA: 0x64, // d - Vertical Position Absolute
+    HVP: 0x66, // f - Horizontal Vertical Position
+    // Erase
+    ED: 0x4a, // J - Erase in Display
+    EL: 0x4b, // K - Erase in Line
+    ECH: 0x58, // X - Erase Character
+    // Insert/Delete
+    IL: 0x4c, // L - Insert Lines
+    DL: 0x4d, // M - Delete Lines
+    ICH: 0x40, // @ - Insert Characters
+    DCH: 0x50, // P - Delete Characters
+    // Scroll
+    SU: 0x53, // S - Scroll Up
+    SD: 0x54, // T - Scroll Down
+    // Modes
+    SM: 0x68, // h - Set Mode
+    RM: 0x6c, // l - Reset Mode
+    // SGR
+    SGR: 0x6d, // m - Select Graphic Rendition
+    // Other
+    DSR: 0x6e, // n - Device Status Report
+    DECSCUSR: 0x71, // q - Set Cursor Style (with space intermediate)
+    DECSTBM: 0x72, // r - Set Top and Bottom Margins
+    SCOSC: 0x73, // s - Save Cursor Position
+    SCORC: 0x75, // u - Restore Cursor Position
+    CBT: 0x5a, // Z - Cursor Backward Tabulation
+};
+/**
+ * Erase in Display regions (ED command parameter)
+ */
+export const ERASE_DISPLAY = ['toEnd', 'toStart', 'all', 'scrollback'];
+/**
+ * Erase in Line regions (EL command parameter)
+ */
+export const ERASE_LINE_REGION = ['toEnd', 'toStart', 'all'];
+/**
+ * Cursor style lookup table for DECSCUSR parameter 0-6, pairing each cursor
+ * shape with its blinking flag.
+ */
+export const CURSOR_STYLES = [
+    { style: 'block', blinking: true }, // 0 - default
+    { style: 'block', blinking: true }, // 1
+    { style: 'block', blinking: false }, // 2
+    { style: 'underline', blinking: true }, // 3
+    { style: 'underline', blinking: false }, // 4
+    { style: 'bar', blinking: true }, // 5
+    { style: 'bar', blinking: false }, // 6
+];
+// Cursor movement generators
+/**
+ * Move cursor up n lines (CSI n A).
+ * @param n - number of lines to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export function cursorUp(n = 1) {
+    return n === 0 ? '' : csi(n, 'A');
+}
+/**
+ * Move cursor down n lines (CSI n B).
+ * @param n - number of lines to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export function cursorDown(n = 1) {
+    return n === 0 ? '' : csi(n, 'B');
+}
+/**
+ * Move cursor forward n columns (CSI n C).
+ * @param n - number of columns to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export function cursorForward(n = 1) {
+    return n === 0 ? '' : csi(n, 'C');
+}
+/**
+ * Move cursor back n columns (CSI n D).
+ * @param n - number of columns to move; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export function cursorBack(n = 1) {
+    return n === 0 ? '' : csi(n, 'D');
+}
+/**
+ * Move cursor to column n (1-indexed) (CSI n G).
+ * @param col - the 1-indexed target column.
+ * @returns the CSI sequence.
+ */
+export function cursorTo(col) {
+    return csi(col, 'G');
+}
+/** Move cursor to column 1 (CSI G) */
+export const CURSOR_LEFT = csi('G');
+/**
+ * Move cursor to row, col (1-indexed) (CSI row ; col H).
+ * @param row - the 1-indexed target row.
+ * @param col - the 1-indexed target column.
+ * @returns the CSI sequence.
+ */
+export function cursorPosition(row, col) {
+    return csi(row, col, 'H');
+}
+/** Move cursor to home position (CSI H) */
+export const CURSOR_HOME = csi('H');
+/**
+ * Move cursor relative to current position.
+ * Positive x = right, negative x = left.
+ * Positive y = down, negative y = up.
+ * @param x - horizontal delta in columns.
+ * @param y - vertical delta in rows.
+ * @returns the concatenated CSI sequences, or an empty string when both deltas are 0.
+ */
+export function cursorMove(x, y) {
+    let result = '';
+    // Horizontal first (matches ansi-escapes behavior)
+    if (x < 0) {
+        result += cursorBack(-x);
+    }
+    else if (x > 0) {
+        result += cursorForward(x);
+    }
+    // Then vertical
+    if (y < 0) {
+        result += cursorUp(-y);
+    }
+    else if (y > 0) {
+        result += cursorDown(y);
+    }
+    return result;
+}
+// Save/restore cursor position
+/** Save cursor position (CSI s) */
+export const CURSOR_SAVE = csi('s');
+/** Restore cursor position (CSI u) */
+export const CURSOR_RESTORE = csi('u');
+// Erase generators
+/**
+ * Erase from cursor to end of line (CSI K).
+ * @returns the CSI sequence.
+ */
+export function eraseToEndOfLine() {
+    return csi('K');
+}
+/**
+ * Erase from cursor to start of line (CSI 1 K).
+ * @returns the CSI sequence.
+ */
+export function eraseToStartOfLine() {
+    return csi(1, 'K');
+}
+/**
+ * Erase entire line (CSI 2 K).
+ * @returns the CSI sequence.
+ */
+export function eraseLine() {
+    return csi(2, 'K');
+}
+/** Erase entire line - constant form */
+export const ERASE_LINE = csi(2, 'K');
+/**
+ * Erase from cursor to end of screen (CSI J).
+ * @returns the CSI sequence.
+ */
+export function eraseToEndOfScreen() {
+    return csi('J');
+}
+/**
+ * Erase from cursor to start of screen (CSI 1 J).
+ * @returns the CSI sequence.
+ */
+export function eraseToStartOfScreen() {
+    return csi(1, 'J');
+}
+/**
+ * Erase entire screen (CSI 2 J).
+ * @returns the CSI sequence.
+ */
+export function eraseScreen() {
+    return csi(2, 'J');
+}
+/** Erase entire screen - constant form */
+export const ERASE_SCREEN = csi(2, 'J');
+/** Erase scrollback buffer (CSI 3 J) */
+export const ERASE_SCROLLBACK = csi(3, 'J');
+/**
+ * Erase n lines starting from the cursor line, moving the cursor up.
+ * This erases each line and moves up, ending at column 1.
+ * @param n - the number of lines to erase.
+ * @returns the combined erase and cursor sequences, or an empty string when
+ *   n is 0 or negative.
+ */
+export function eraseLines(n) {
+    if (n <= 0)
+        return '';
+    let result = '';
+    for (let i = 0; i < n; i++) {
+        result += ERASE_LINE;
+        if (i < n - 1) {
+            result += cursorUp(1);
+        }
+    }
+    result += CURSOR_LEFT;
+    return result;
+}
+/** Reset all SGR attributes (CSI 0 m). Erase/scroll sequences fill blank
+ *  cells with the CURRENT background color (BCE) — prefix this before any
+ *  such sequence that must not inherit a possibly-stuck background (e.g.
+ *  after a truncated frame left a colored SGR active). */
+export const SGR_RESET = csi(0, 'm');
+// Scroll
+/**
+ * Scroll up n lines (CSI n S).
+ * @param n - number of lines to scroll; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export function scrollUp(n = 1) {
+    return n === 0 ? '' : csi(n, 'S');
+}
+/**
+ * Scroll down n lines (CSI n T).
+ * @param n - number of lines to scroll; defaults to 1.
+ * @returns the CSI sequence, or an empty string when n is 0.
+ */
+export function scrollDown(n = 1) {
+    return n === 0 ? '' : csi(n, 'T');
+}
+/**
+ * Set scroll region (DECSTBM, CSI top;bottom r). 1-indexed, inclusive.
+ * @param top - the 1-indexed first row of the region.
+ * @param bottom - the 1-indexed last row of the region.
+ * @returns the CSI sequence.
+ */
+export function setScrollRegion(top, bottom) {
+    return csi(top, bottom, 'r');
+}
+/** Reset scroll region to full screen (DECSTBM, CSI r). Homes the cursor. */
+export const RESET_SCROLL_REGION = csi('r');
+// Bracketed paste markers (input from terminal, not output)
+// These are sent by the terminal to delimit pasted content when
+// bracketed paste mode is enabled (via DEC mode 2004)
+/** Sent by terminal before pasted content (CSI 200 ~) */
+export const PASTE_START = csi('200~');
+/** Sent by terminal after pasted content (CSI 201 ~) */
+export const PASTE_END = csi('201~');
+// Focus event markers (input from terminal, not output)
+// These are sent by the terminal when focus changes while
+// focus events mode is enabled (via DEC mode 1004)
+/** Sent by terminal when it gains focus (CSI I) */
+export const FOCUS_IN = csi('I');
+/** Sent by terminal when it loses focus (CSI O) */
+export const FOCUS_OUT = csi('O');
+// Kitty keyboard protocol (CSI u)
+// Enables enhanced key reporting with modifier information
+// See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+/**
+ * Enable Kitty keyboard protocol with basic modifier reporting
+ * CSI > 1 u - pushes mode with flags=1 (disambiguate escape codes)
+ * This makes Shift+Enter send CSI 13;2 u instead of just CR
+ */
+export const ENABLE_KITTY_KEYBOARD = csi('>1u');
+/**
+ * Disable Kitty keyboard protocol
+ * CSI < u - pops the keyboard mode stack
+ */
+export const DISABLE_KITTY_KEYBOARD = csi('<u');
+/**
+ * Enable xterm modifyOtherKeys level 2.
+ * tmux accepts this (not the kitty stack) to enable extended keys — when
+ * extended-keys-format is csi-u, tmux then emits keys in kitty format.
+ */
+export const ENABLE_MODIFY_OTHER_KEYS = csi('>4;2m');
+/**
+ * Disable xterm modifyOtherKeys (reset to default).
+ */
+export const DISABLE_MODIFY_OTHER_KEYS = csi('>4m');
+// win32-input-mode (ConPTY, DECSET 9001)
+// Windows-only keyboard protocol: the terminal reports every key as a full
+// INPUT_RECORD (CSI Vk;Sc;Uc;Kd;Cs;Rc _), which is the ONLY way Enter's
+// modifier bits survive on Windows — Windows Terminal/conhost implement
+// kitty/modifyOtherKeys but never attach modifiers to Enter
+// (microsoft/terminal#530), so Shift+Enter is indistinguishable from Enter
+// over classic VT sequences. Supported by both Windows Terminal and classic
+// conhost (anything fronting ConPTY); terminals that don't know the private
+// mode (mintty/winpty) ignore it.
+// See: doc/specs/#4999 - Improved keyboard handling in Conpty (microsoft/terminal)
+/**
+ * Enable win32-input-mode.
+ * CSI ? 9001 h — every key arrives as CSI Vk;Sc;Uc;Kd;Cs;Rc _
+ */
+export const ENABLE_WIN32_INPUT_MODE = csi('?9001h');
+/**
+ * Disable win32-input-mode (restore classic VT input).
+ * CSI ? 9001 l
+ */
+export const DISABLE_WIN32_INPUT_MODE = csi('?9001l');

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

@@ -0,0 +1,61 @@
+/**
+ * DEC (Digital Equipment Corporation) Private Mode Sequences
+ *
+ * DEC private modes use CSI ? N h (set) and CSI ? N l (reset) format.
+ * These are terminal-specific extensions to the ANSI standard.
+ */
+/**
+ * DEC private mode numbers
+ */
+export declare const DEC: {
+    readonly CURSOR_VISIBLE: 25;
+    readonly ALT_SCREEN: 47;
+    readonly ALT_SCREEN_CLEAR: 1049;
+    readonly MOUSE_NORMAL: 1000;
+    readonly MOUSE_BUTTON: 1002;
+    readonly MOUSE_ANY: 1003;
+    readonly MOUSE_SGR: 1006;
+    readonly FOCUS_EVENTS: 1004;
+    readonly BRACKETED_PASTE: 2004;
+    readonly SYNCHRONIZED_UPDATE: 2026;
+};
+/**
+ * Generate a CSI ? N h sequence to set a DEC private mode.
+ * @param mode - the DEC private mode number.
+ * @returns the CSI sequence.
+ */
+export declare function decset(mode: number): string;
+/**
+ * Generate a CSI ? N l sequence to reset a DEC private mode.
+ * @param mode - the DEC private mode number.
+ * @returns the CSI sequence.
+ */
+export declare function decreset(mode: number): string;
+/** Enable synchronized output updates (DECSET 2026). */
+export declare const BSU: string;
+/** Disable synchronized output updates (DECRESET 2026). */
+export declare const ESU: string;
+/** Enable bracketed paste mode (DECSET 2004). */
+export declare const EBP: string;
+/** Disable bracketed paste mode (DECRESET 2004). */
+export declare const DBP: string;
+/** Enable focus event reporting (DECSET 1004). */
+export declare const EFE: string;
+/** Disable focus event reporting (DECRESET 1004). */
+export declare const DFE: string;
+/** Show the cursor (DECSET 25). */
+export declare const SHOW_CURSOR: string;
+/** Hide the cursor (DECRESET 25). */
+export declare const HIDE_CURSOR: string;
+/** Enter the alternate screen, clearing it (DECSET 1049). */
+export declare const ENTER_ALT_SCREEN: string;
+/** Exit the alternate screen (DECRESET 1049). */
+export declare const EXIT_ALT_SCREEN: string;
+/**
+ * Enable full mouse tracking: modes 1000 (click/release/wheel), 1002 (drag),
+ * 1003 (hover), and 1006 (SGR format).
+ */
+export declare const ENABLE_MOUSE_TRACKING: string;
+/** Disable all mouse tracking modes enabled by ENABLE_MOUSE_TRACKING. */
+export declare const DISABLE_MOUSE_TRACKING: string;
+//# sourceMappingURL=dec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dec.d.ts","sourceRoot":"","sources":["../../../../src/ink/termio/dec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;CAWN,CAAA;AAEV;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAID,wDAAwD;AACxD,eAAO,MAAM,GAAG,QAAkC,CAAA;AAElD,2DAA2D;AAC3D,eAAO,MAAM,GAAG,QAAoC,CAAA;AAEpD,iDAAiD;AACjD,eAAO,MAAM,GAAG,QAA8B,CAAA;AAE9C,oDAAoD;AACpD,eAAO,MAAM,GAAG,QAAgC,CAAA;AAEhD,kDAAkD;AAClD,eAAO,MAAM,GAAG,QAA2B,CAAA;AAE3C,qDAAqD;AACrD,eAAO,MAAM,GAAG,QAA6B,CAAA;AAE7C,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAA6B,CAAA;AAErD,qCAAqC;AACrC,eAAO,MAAM,WAAW,QAA+B,CAAA;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,QAA+B,CAAA;AAE5D,iDAAiD;AACjD,eAAO,MAAM,eAAe,QAAiC,CAAA;AAK7D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAIX,CAAA;AAEvB,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,QAIP,CAAA"}