@deepseek-harness-tui/dsh-tui 0.5.0

package/lib/types/ink/parse-keypress.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Keyboard input parser - converts terminal input to key events
+ *
+ * Uses the termio tokenizer for escape sequence boundary detection,
+ * then interprets sequences as keypresses.
+ */
+import { Buffer } from 'buffer';
+import { type Tokenizer } from './termio/tokenize.js';
+/** DECRPM status values (response to DECRQM) */
+export declare const DECRPM_STATUS: {
+    readonly NOT_RECOGNIZED: 0;
+    readonly SET: 1;
+    readonly RESET: 2;
+    readonly PERMANENTLY_SET: 3;
+    readonly PERMANENTLY_RESET: 4;
+};
+/**
+ * A response sequence received from the terminal (not a keypress).
+ * Emitted in answer to queries like DECRQM, DA1, OSC 11, etc.
+ */
+export type TerminalResponse = 
+/** DECRPM: answer to DECRQM (request DEC private mode status) */
+{
+    type: 'decrpm';
+    mode: number;
+    status: number;
+}
+/** DA1: primary device attributes (used as a universal sentinel) */
+ | {
+    type: 'da1';
+    params: number[];
+}
+/** DA2: secondary device attributes (terminal version info) */
+ | {
+    type: 'da2';
+    params: number[];
+}
+/** Kitty keyboard protocol: current flags (answer to CSI ? u) */
+ | {
+    type: 'kittyKeyboard';
+    flags: number;
+}
+/** DSR: cursor position report (answer to CSI 6 n) */
+ | {
+    type: 'cursorPosition';
+    row: number;
+    col: number;
+}
+/** OSC response: generic operating-system-command reply (e.g. OSC 11 bg color) */
+ | {
+    type: 'osc';
+    code: number;
+    data: string;
+}
+/** XTVERSION: terminal name/version string (answer to CSI > 0 q).
+ *  Example values: "xterm.js(5.5.0)", "ghostty 1.2.0", "iTerm2 3.6". */
+ | {
+    type: 'xtversion';
+    name: string;
+};
+/**
+ * Parser state carried between parseMultipleKeypresses calls: paste mode,
+ * buffered incomplete input, and the internal tokenizer instance.
+ */
+export type KeyParseState = {
+    mode: 'NORMAL' | 'IN_PASTE';
+    incomplete: string;
+    pasteBuffer: string;
+    _tokenizer?: Tokenizer;
+};
+/** Initial `KeyParseState` for a fresh parser. */
+export declare const INITIAL_STATE: KeyParseState;
+/**
+ * Tokenize and parse a chunk of terminal input into parsed keys, mouse
+ * events, and terminal responses, maintaining paste-mode state.
+ * @param prevState - the state returned by the previous call, or INITIAL_STATE.
+ * @param input - the input chunk; null flushes the tokenizer's pending input.
+ * @returns the parsed inputs plus the state to pass to the next call.
+ */
+export declare function parseMultipleKeypresses(prevState: KeyParseState, input?: Buffer | string | null): [ParsedInput[], KeyParseState];
+/**
+ * Key names that never produce printable input (function keys, navigation,
+ * modifiers, mouse), used to filter parsed keypresses.
+ */
+export declare const nonAlphanumericKeys: string[];
+/**
+ * A parsed user keypress or paste: the key name, modifier flags, the raw
+ * escape sequence, and whether the input arrived via bracketed paste.
+ */
+export type ParsedKey = {
+    kind: 'key';
+    fn: boolean;
+    name: string | undefined;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    option: boolean;
+    super: boolean;
+    sequence: string | undefined;
+    raw: string | undefined;
+    code?: string;
+    isPasted: boolean;
+};
+/** A terminal response sequence (DECRPM, DA1, OSC reply, etc.) parsed
+ *  out of the input stream. Not user input — consumers should dispatch
+ *  to a response handler. */
+export type ParsedResponse = {
+    kind: 'response';
+    /** Raw escape sequence bytes, for debugging/logging */
+    sequence: string;
+    response: TerminalResponse;
+};
+/** SGR mouse event with coordinates. Emitted for clicks, drags, and
+ *  releases (wheel events remain ParsedKey). col/row are 1-indexed
+ *  from the terminal sequence (CSI < btn;col;row M/m). */
+export type ParsedMouse = {
+    kind: 'mouse';
+    /** Raw SGR button code. Low 2 bits = button (0=left,1=mid,2=right),
+     *  bit 5 (0x20) = drag/motion, bit 6 (0x40) = wheel. */
+    button: number;
+    /** 'press' for M terminator, 'release' for m terminator */
+    action: 'press' | 'release';
+    /** 1-indexed column (from terminal) */
+    col: number;
+    /** 1-indexed row (from terminal) */
+    row: number;
+    sequence: string;
+};
+/** Everything that can come out of the input parser: a user keypress/paste,
+ *  a mouse click/drag event, or a terminal response to a query we sent. */
+export type ParsedInput = ParsedKey | ParsedMouse | ParsedResponse;
+//# sourceMappingURL=parse-keypress.d.ts.map

package/lib/types/ink/parse-keypress.d.ts.map

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