@next_term/core 0.0.1-next.0

package/dist/gesture-handler.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Platform-agnostic touch gesture handling for terminal emulators.
+ *
+ * Pure-logic handler with zero platform dependencies — translates
+ * gesture coordinates and states into terminal actions. Used by
+ * both @next_term/web (DOM touch events) and @next_term/native
+ * (React Native gesture handler).
+ */
+import type { SelectionRange } from "./cell-grid.js";
+export declare enum GestureState {
+    BEGAN = "began",
+    ACTIVE = "active",
+    END = "end",
+    CANCELLED = "cancelled"
+}
+export interface GestureConfig {
+    onScroll: (deltaRows: number) => void;
+    onTap: (row: number, col: number) => void;
+    onDoubleTap: (row: number, col: number) => void;
+    onLongPress: (row: number, col: number) => void;
+    onPinch: (scale: number) => void;
+    onSelectionChange: (selection: SelectionRange | null) => void;
+}
+export declare class GestureHandler {
+    private cellWidth;
+    private cellHeight;
+    private config;
+    /** Accumulated sub-row scroll remainder for smooth scrolling. */
+    private scrollRemainder;
+    /** Whether a long-press selection is active. */
+    private selectionActive;
+    private selectionAnchor;
+    constructor(cellWidth: number, cellHeight: number, config: GestureConfig);
+    updateCellSize(width: number, height: number): void;
+    /**
+     * Convert pixel coordinates to cell coordinates.
+     * Clamps to non-negative values (caller is responsible for upper bounds).
+     */
+    pixelToCell(x: number, y: number): {
+        row: number;
+        col: number;
+    };
+    /**
+     * Handle a pan gesture. Translation values are cumulative pixel offsets
+     * from the gesture start. velocityY is in pixels/ms.
+     */
+    handlePan(_translationX: number, translationY: number, velocityY: number, state: GestureState): void;
+    /**
+     * Compute the number of rows a fling gesture should scroll based on
+     * initial velocity and deceleration.
+     */
+    private computeFlingRows;
+    handleTap(x: number, y: number): void;
+    handleDoubleTap(x: number, y: number): void;
+    handleLongPress(x: number, y: number): void;
+    handlePinch(scale: number, state: GestureState): void;
+    /**
+     * Extend a selection during a drag gesture. Call this from the pan handler
+     * when `isSelectionActive` is true.
+     */
+    extendSelection(x: number, y: number): void;
+    get isSelectionActive(): boolean;
+    clearSelection(): void;
+}
+//# sourceMappingURL=gesture-handler.d.ts.map

package/dist/gesture-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture-handler.d.ts","sourceRoot":"","sources":["../src/gesture-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD,oBAAY,YAAY;IACtB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,iBAAiB,EAAE,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D;AAgBD,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAE9B,iEAAiE;IACjE,OAAO,CAAC,eAAe,CAAK;IAE5B,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,eAAe,CAA6C;gBAExD,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;IAUxE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IASnD;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAc/D;;;OAGG;IACH,SAAS,CACP,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,GAClB,IAAI;IA+BP;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAWxB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBrC,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAS3C,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAoB3C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAUrD;;;OAGG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAY3C,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,cAAc,IAAI,IAAI;CAKvB"}

package/dist/gesture-handler.js

@@ -0,0 +1,186 @@
+/**
+ * Platform-agnostic touch gesture handling for terminal emulators.
+ *
+ * Pure-logic handler with zero platform dependencies — translates
+ * gesture coordinates and states into terminal actions. Used by
+ * both @next_term/web (DOM touch events) and @next_term/native
+ * (React Native gesture handler).
+ */
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+export var GestureState;
+(function (GestureState) {
+    GestureState["BEGAN"] = "began";
+    GestureState["ACTIVE"] = "active";
+    GestureState["END"] = "end";
+    GestureState["CANCELLED"] = "cancelled";
+})(GestureState || (GestureState = {}));
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Deceleration factor for fling physics (pixels/ms^2). */
+const FLING_DECELERATION = 0.003;
+/** Minimum velocity (pixels/ms) to trigger a fling. */
+const FLING_MIN_VELOCITY = 0.5;
+// ---------------------------------------------------------------------------
+// GestureHandler
+// ---------------------------------------------------------------------------
+export class GestureHandler {
+    cellWidth;
+    cellHeight;
+    config;
+    /** Accumulated sub-row scroll remainder for smooth scrolling. */
+    scrollRemainder = 0;
+    /** Whether a long-press selection is active. */
+    selectionActive = false;
+    selectionAnchor = null;
+    constructor(cellWidth, cellHeight, config) {
+        this.cellWidth = cellWidth;
+        this.cellHeight = cellHeight;
+        this.config = config;
+    }
+    // -----------------------------------------------------------------------
+    // Cell size
+    // -----------------------------------------------------------------------
+    updateCellSize(width, height) {
+        this.cellWidth = width;
+        this.cellHeight = height;
+    }
+    // -----------------------------------------------------------------------
+    // Coordinate conversion
+    // -----------------------------------------------------------------------
+    /**
+     * Convert pixel coordinates to cell coordinates.
+     * Clamps to non-negative values (caller is responsible for upper bounds).
+     */
+    pixelToCell(x, y) {
+        if (this.cellWidth <= 0 || this.cellHeight <= 0) {
+            return { row: 0, col: 0 };
+        }
+        return {
+            row: Math.max(0, Math.floor(y / this.cellHeight)),
+            col: Math.max(0, Math.floor(x / this.cellWidth)),
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Pan / Scroll
+    // -----------------------------------------------------------------------
+    /**
+     * Handle a pan gesture. Translation values are cumulative pixel offsets
+     * from the gesture start. velocityY is in pixels/ms.
+     */
+    handlePan(_translationX, translationY, velocityY, state) {
+        if (this.cellHeight <= 0)
+            return;
+        if (state === GestureState.ACTIVE) {
+            // Convert pixel translation to row delta, keeping a fractional remainder
+            const totalPixels = translationY + this.scrollRemainder;
+            const deltaRows = Math.trunc(totalPixels / this.cellHeight);
+            this.scrollRemainder = totalPixels - deltaRows * this.cellHeight;
+            if (deltaRows !== 0) {
+                // Negate: dragging down means scrolling up (seeing older content)
+                this.config.onScroll(-deltaRows);
+            }
+        }
+        else if (state === GestureState.END) {
+            this.scrollRemainder = 0;
+            // Fling: apply velocity-based scroll
+            const absVelocity = Math.abs(velocityY);
+            if (absVelocity > FLING_MIN_VELOCITY) {
+                const flingRows = this.computeFlingRows(velocityY);
+                if (flingRows !== 0) {
+                    this.config.onScroll(-flingRows);
+                }
+            }
+        }
+        else if (state === GestureState.CANCELLED) {
+            this.scrollRemainder = 0;
+        }
+        else if (state === GestureState.BEGAN) {
+            this.scrollRemainder = 0;
+        }
+    }
+    /**
+     * Compute the number of rows a fling gesture should scroll based on
+     * initial velocity and deceleration.
+     */
+    computeFlingRows(velocityPxPerMs) {
+        // d = v^2 / (2 * a)   — kinematic distance from constant deceleration
+        const distancePx = (velocityPxPerMs * velocityPxPerMs) / (2 * FLING_DECELERATION);
+        const sign = velocityPxPerMs > 0 ? 1 : -1;
+        return Math.round((sign * distancePx) / this.cellHeight);
+    }
+    // -----------------------------------------------------------------------
+    // Tap
+    // -----------------------------------------------------------------------
+    handleTap(x, y) {
+        if (this.selectionActive) {
+            // Tap clears an active selection
+            this.selectionActive = false;
+            this.selectionAnchor = null;
+            this.config.onSelectionChange(null);
+            return;
+        }
+        const { row, col } = this.pixelToCell(x, y);
+        this.config.onTap(row, col);
+    }
+    // -----------------------------------------------------------------------
+    // Double-tap (word selection)
+    // -----------------------------------------------------------------------
+    handleDoubleTap(x, y) {
+        const { row, col } = this.pixelToCell(x, y);
+        this.config.onDoubleTap(row, col);
+    }
+    // -----------------------------------------------------------------------
+    // Long press (enter selection mode)
+    // -----------------------------------------------------------------------
+    handleLongPress(x, y) {
+        const { row, col } = this.pixelToCell(x, y);
+        this.selectionActive = true;
+        this.selectionAnchor = { row, col };
+        this.config.onLongPress(row, col);
+        // Initialize selection at the long-press point
+        this.config.onSelectionChange({
+            startRow: row,
+            startCol: col,
+            endRow: row,
+            endCol: col,
+        });
+    }
+    // -----------------------------------------------------------------------
+    // Pinch-to-zoom
+    // -----------------------------------------------------------------------
+    handlePinch(scale, state) {
+        if (state === GestureState.ACTIVE || state === GestureState.END) {
+            this.config.onPinch(scale);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Selection drag (called during pan when selection is active)
+    // -----------------------------------------------------------------------
+    /**
+     * Extend a selection during a drag gesture. Call this from the pan handler
+     * when `isSelectionActive` is true.
+     */
+    extendSelection(x, y) {
+        if (!this.selectionActive || !this.selectionAnchor)
+            return;
+        const { row, col } = this.pixelToCell(x, y);
+        this.config.onSelectionChange({
+            startRow: this.selectionAnchor.row,
+            startCol: this.selectionAnchor.col,
+            endRow: row,
+            endCol: col,
+        });
+    }
+    get isSelectionActive() {
+        return this.selectionActive;
+    }
+    clearSelection() {
+        this.selectionActive = false;
+        this.selectionAnchor = null;
+        this.config.onSelectionChange(null);
+    }
+}
+//# sourceMappingURL=gesture-handler.js.map

package/dist/gesture-handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { Buffer, BufferSet } from "./buffer.js";
+export type { SelectionRange } from "./cell-grid.js";
+export { CELL_SIZE, CellGrid, DEFAULT_CELL_W0, DEFAULT_CELL_W1, extractText, modPositive, normalizeSelection, } from "./cell-grid.js";
+export type { GestureConfig } from "./gesture-handler.js";
+export { GestureHandler, GestureState } from "./gesture-handler.js";
+export type { MouseEncoding, MouseProtocol } from "./parser/index.js";
+export { VTParser } from "./parser/index.js";
+export { Action, State, TABLE, unpackAction, unpackState } from "./parser/states.js";
+export type { CursorState, SelectionState, TerminalOptions, Theme } from "./types.js";
+export { DEFAULT_THEME, DirtyState } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,SAAS,EACT,QAAQ,EACR,eAAe,EACf,eAAe,EACf,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { Buffer, BufferSet } from "./buffer.js";
+export { CELL_SIZE, CellGrid, DEFAULT_CELL_W0, DEFAULT_CELL_W1, extractText, modPositive, normalizeSelection, } from "./cell-grid.js";
+export { GestureHandler, GestureState } from "./gesture-handler.js";
+export { VTParser } from "./parser/index.js";
+export { Action, State, TABLE, unpackAction, unpackState } from "./parser/states.js";
+export { DEFAULT_THEME, DirtyState } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,SAAS,EACT,QAAQ,EACR,eAAe,EACf,eAAe,EACf,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/parser/index.d.ts

@@ -0,0 +1,196 @@
+import type { BufferSet } from "../buffer.js";
+import type { CursorState } from "../types.js";
+/** Mouse tracking protocol. */
+export type MouseProtocol = "none" | "x10" | "vt200" | "drag" | "any";
+/** Mouse encoding format. */
+export type MouseEncoding = "default" | "sgr";
+export declare class VTParser {
+    private state;
+    private readonly bufferSet;
+    private static readonly MAX_PARAMS;
+    private readonly params;
+    private paramCount;
+    private currentParam;
+    private hasParam;
+    private intermediatesByte;
+    private prefixByte;
+    private fgIndex;
+    private bgIndex;
+    private attrs;
+    private fgIsRGB;
+    private bgIsRGB;
+    private fgRGB;
+    private bgRGB;
+    private static readonly MAX_OSC_LENGTH;
+    private readonly oscParts;
+    private oscLength;
+    private static readonly MAX_DCS_LENGTH;
+    private readonly dcsParts;
+    private dcsLength;
+    private dcsFinal;
+    private static readonly MAX_TMUX_LENGTH;
+    private readonly tmuxParts;
+    private tmuxLength;
+    private tmuxSeeking;
+    private inTmuxDcs;
+    private tmuxPrevWasEsc;
+    private tmuxDepth;
+    private utf8Bytes;
+    private utf8Codepoint;
+    private lineFeedMode;
+    private autoWrapMode;
+    private originMode;
+    applicationCursorKeys: boolean;
+    applicationKeypad: boolean;
+    bracketedPasteMode: boolean;
+    syncedOutput: boolean;
+    mouseProtocol: MouseProtocol;
+    mouseEncoding: MouseEncoding;
+    sendFocusEvents: boolean;
+    kittyFlags: number;
+    private readonly kittyFlagsStack;
+    private lastPrintedCodepoint;
+    private responseBuffer;
+    private titleStack;
+    private onTitleChange;
+    private onOsc52;
+    private onOsc4;
+    private onOsc7;
+    private onOsc10;
+    private onOsc11;
+    private onOsc12;
+    private onOsc104;
+    private onOsc8;
+    private onOsc133;
+    private onSyncOutput;
+    private onDcs;
+    private onDcsTmux;
+    private onKittyFlags;
+    constructor(bufferSet: BufferSet);
+    /** Register a callback for title changes (OSC 0/1/2). */
+    setTitleChangeCallback(cb: (title: string) => void): void;
+    /** Register a callback for OSC 52 clipboard sequences.
+     *  `selection` is the clipboard selection string (e.g. "c" for clipboard).
+     *  `data` is the base64-encoded payload, or null for a query request ("?").
+     */
+    setOsc52Callback(cb: (selection: string, data: string | null) => void): void;
+    /** Register a callback for OSC 4 color palette sequences.
+     *  Called once per index;spec pair in the sequence.
+     *  `index` is the palette index (0-255).
+     *  `spec` is the color specification string (e.g. "rgb:ff/00/00"), or null for a query ("?").
+     */
+    setOsc4Callback(cb: (index: number, spec: string | null) => void): void;
+    /** Register a callback for OSC 7 current working directory sequences.
+     *  Called with the URI payload (e.g. "file:///hostname/path").
+     */
+    setOsc7Callback(cb: (uri: string) => void): void;
+    /** Register a callback for OSC 10 foreground color sequences.
+     *  `spec` is the color specification string (e.g. "rgb:ffff/ffff/ffff"), or null for a query ("?").
+     */
+    setOsc10Callback(cb: (spec: string | null) => void): void;
+    /** Register a callback for OSC 11 background color sequences.
+     *  `spec` is the color specification string (e.g. "rgb:0000/0000/0000"), or null for a query ("?").
+     */
+    setOsc11Callback(cb: (spec: string | null) => void): void;
+    /** Register a callback for OSC 12 cursor color sequences.
+     *  `spec` is the color specification string, or null for a query ("?").
+     */
+    setOsc12Callback(cb: (spec: string | null) => void): void;
+    /** Register a callback for OSC 104 reset color palette sequences.
+     *  Called once per index to reset; `index` is 0-255 for a specific palette
+     *  entry, or -1 when no index is given (reset the entire palette).
+     */
+    setOsc104Callback(cb: (index: number) => void): void;
+    /** Register a callback for OSC 8 hyperlink sequences.
+     *  `params` is the optional colon-separated key=value metadata string (may be "").
+     *  `uri` is the hyperlink target URI (empty string closes the active link).
+     */
+    setOsc8Callback(cb: (params: string, uri: string) => void): void;
+    /** Register a callback for OSC 133 shell integration (semantic prompt) sequences.
+     *  `type` is the event letter: "A" (prompt start), "B" (command start),
+     *  "C" (command output start), "D" (command end), "E" (command text), "P" (property), etc.
+     *  `payload` is the string after the type letter and its optional semicolon separator
+     *  (both `133;<type>;<payload>` and `133;<type><payload>` forms are accepted; empty string
+     *  for A/B/C; exit-code digits for D; command text for E; key=value for P).
+     */
+    setOsc133Callback(cb: (type: string, payload: string) => void): void;
+    /** Register a callback for synchronized output mode 2026 changes.
+     *  Called with `true` when DECSET ?2026h activates the mode and `false`
+     *  when DECRST ?2026l deactivates it.  The web layer uses this to pause
+     *  and resume the render loop (frame buffering).
+     */
+    setSyncOutputCallback(cb: (active: boolean) => void): void;
+    /** Register a callback for DCS (Device Control String) sequences.
+     *  Called when a DCS sequence is fully received (terminated by ST or C1 ST).
+     *  `finalByte` identifies the DCS command (0x40–0x7E, e.g. 0x70 for 'p').
+     *  `params` are the numeric params collected before the intermediate/final byte.
+     *  `intermediate` is the single intermediate byte (0x20–0x2F), or 0 if none.
+     *  `data` is the passthrough string collected between the final byte and ST.
+     */
+    setDcsCallback(cb: (finalByte: number, params: readonly number[], intermediate: number, data: string) => void): void;
+    /** Register a callback for DCS tmux passthrough sequences.
+     *  Called when the outer DCS tmux wrapper (ESC P tmux; ... ESC \) is received.
+     *  `innerSeq` is the decoded inner escape sequence string (with doubled ESCs unescaped).
+     *  The inner sequence is also automatically processed through the parser.
+     */
+    setDcsTmuxCallback(cb: (innerSeq: string) => void): void;
+    /** Register a callback fired when kitty keyboard flags change (CSI =/>/</? u). */
+    setKittyFlagsCallback(cb: (flags: number) => void): void;
+    get cursor(): CursorState;
+    get cols(): number;
+    get rows(): number;
+    private get buf();
+    private get grid();
+    /** Check if there are pending responses to read. */
+    hasResponse(): boolean;
+    /** Read the next response from the response buffer. */
+    readResponse(): Uint8Array | null;
+    /** Process raw bytes from the PTY. */
+    write(data: Uint8Array): void;
+    private printCodepoint;
+    private execute;
+    private linefeed;
+    /**
+     * Fast-path scroll up: combines scrollUpWithHistory + scrollUp for the
+     * common full-screen case (rotateUp instead of copyWithin). Falls back
+     * to scrollUpWithHistory for partial scroll regions.
+     */
+    private _scrollUpFull;
+    private clear;
+    private finalizeParams;
+    private csiDispatch;
+    private csiPrivate;
+    private decset;
+    /** SM - Set Mode (non-private) */
+    private setMode;
+    /** RM - Reset Mode (non-private) */
+    private resetMode;
+    private escDispatch;
+    private dcsDispatch;
+    private dispatchTmux;
+    private oscDispatch;
+    private cursorUp;
+    private cursorDown;
+    private cursorForward;
+    private cursorBackward;
+    private cursorPosition;
+    private setCursorStyle;
+    private reportCursorPosition;
+    private reportDeviceAttributes;
+    private windowManipulation;
+    private eraseInDisplay;
+    private eraseInLine;
+    private eraseCells;
+    private eraseChars;
+    private insertLines;
+    private deleteLines;
+    private insertChars;
+    private deleteChars;
+    private setScrollRegion;
+    private sgr;
+    /** Parse SGR 38/48 extended color. Returns updated index. */
+    private parseSgrColor;
+    private softReset;
+    private fullReset;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

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