vterm.js 0.5.1 → 0.6.0

package/README.md

@@ -243,18 +243,11 @@ screen.signals.damage$.subscribe((d: DirtyRegion) => {
 })
 ```
 
-## Naming — schema migration
+## Naming
 
-The public vocabulary is converging on the terminal domain model (name the thing, not the mechanism; **row = cells, line = text**; flat progressive shapes over discriminated unions). The canonical names below are live now; the old names remain exported as `@deprecated` aliases through the migration window, so existing code keeps compiling.
+The public vocabulary follows the terminal domain model (name the thing, not the mechanism; **row = cells, line = text**; flat progressive shapes over discriminated unions): `Color`, `Snapshot`, `getRow(row)`, `getCursor(): Cursor` (`Cursor` is `{ col, row }`). The pre-§9 names — `CellColor`, `ScreenSnapshot`/`VtermScreenSnapshot`, `getLine(row)`, `getCursorPosition(): {x,y}` — rode a deprecation window as `@deprecated` aliases and have since been deleted; they no longer compile.
 
-| Deprecated                               | Canonical             | Notes                                                                                                        |
-| ---------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------ |
-| `CellColor`                              | `Color`               | Same shape `{ r, g, b, index? }`; a type named `RGB`/`CellColor` carrying `.index` was the smell.            |
-| `ScreenSnapshot` / `VtermScreenSnapshot` | `Snapshot`            | The namespace supplies the context; `VtermScreenSnapshot` stays exported as an alias for existing consumers. |
-| `getLine(row): ScreenCell[]`             | `getRow(row)`         | Row = cells; the text readers (`getText`, `getScrollbackText`) keep "line/text".                             |
-| `getCursorPosition(): {x,y}`             | `getCursor(): Cursor` | `Cursor` is `{ col, row }` — the grid's own vocabulary.                                                      |
-
-**Deferred (not renamed this slice):** the `Snapshot.cursor` / `Snapshot.savedState` fields keep `x`/`y` rather than `col`/`row`, because those field names are the wire shape read by `encodeScreenSnapshotBinary` — renaming them would silently change the persisted binary format. The `col`/`row` vocabulary is available at the read boundary via `getCursor()` / the `Cursor` type. The snapshot field rename is a codec-format concern for a coordinated schema bump.
+**Deferred (not renamed):** the `Snapshot.cursor` / `Snapshot.savedState` fields keep `x`/`y` rather than `col`/`row`, because those field names are the wire shape read by `encodeScreenSnapshotBinary` — renaming them would silently change the persisted binary format. The `col`/`row` vocabulary is available at the read boundary via `getCursor()` / the `Cursor` type. The snapshot field rename is a codec-format concern for a coordinated schema bump.
 
 ## API
 
@@ -279,10 +272,8 @@ The public vocabulary is converging on the terminal domain model (name the thing
 | `getText()`                    | Get all text (scrollback + screen)                                                       |
 | `getTextRange(sr, sc, er, ec)` | Get text in a range                                                                      |
 | `getRow(row)`                  | Get cells for a screen row (row = cells, line = text)                                    |
-| `getLine(row)`                 | **Deprecated** — alias of `getRow`                                                       |
 | `getCell(row, col)`            | Get a single cell                                                                        |
 | `getCursor()`                  | Get cursor `{ col, row }`                                                                |
-| `getCursorPosition()`          | **Deprecated** — cursor `{ x, y }`; use `getCursor()`                                    |
 | `getCursorVisible()`           | Check cursor visibility                                                                  |
 | `getCursorShape()`             | Get cursor shape: `"block"`, `"underline"`, or `"bar"`                                   |
 | `getCursorBlinking()`          | Check if cursor is blinking                                                              |
@@ -314,7 +305,7 @@ interface ScreenCell {
   faint: boolean
   italic: boolean
   underline: "none" | "single" | "double" | "curly" | "dotted" | "dashed"
-  underlineColor: CellColor | null
+  underlineColor: Color | null
   overline: boolean
   strikethrough: boolean
   inverse: boolean
@@ -363,7 +354,7 @@ history and repaint only what changed.
 The buffer is the retained scrollback followed by the screen. **Absolute row 0 is the
 oldest retained scrollback line**; the screen occupies the last `screenRows()` rows
 (absolute `totalRows() - screenRows()` through `totalRows() - 1`). The existing
-screen-relative reads (`getLine`, `getCell`) are unchanged — absolute addressing is
+screen-relative reads (`getRow`, `getCell`) are unchanged — absolute addressing is
 additive.
 
 ```typescript
@@ -376,7 +367,7 @@ screen.viewportTop() // absolute row of the viewport's top line
 
 Naming follows the ecosystem rule **row = cells, line = text**: `getRowAbsolute`
 returns cells; colors are stripped of palette-origin index at the read boundary (same
-contract as `getLine`). Out-of-range indices return a blank row.
+contract as `getRow`). Out-of-range indices return a blank row.
 
 **Stability contract.** As lines scroll IN, an existing scrollback row keeps its
 absolute index (the screen shifts up in absolute terms, but its content keeps the same

package/dist/index.d.mts

@@ -37,7 +37,7 @@
  * An RGB color, identity-preserving. `r`/`g`/`b` are always present (painters read
  * them unconditionally); `index` is optional palette provenance. Named `Color` per the
  * §9 naming ruling (rule 5: flat progressive shape over a discriminated union — a type
- * named `RGB` that carries `.index` would lie). {@link CellColor} is the deprecated alias.
+ * named `RGB` that carries `.index` would lie).
  */
 interface Color {
   r: number;
@@ -61,18 +61,16 @@ interface Color {
    */
   index?: number;
 }
-/** @deprecated Renamed to {@link Color} (§9 naming ruling). This alias rides the migration window. */
-type CellColor = Color;
 type UnderlineStyle = "none" | "single" | "double" | "curly" | "dotted" | "dashed";
 interface ScreenCell {
   char: string;
-  fg: CellColor | null;
-  bg: CellColor | null;
+  fg: Color | null;
+  bg: Color | null;
   bold: boolean;
   faint: boolean;
   italic: boolean;
   underline: UnderlineStyle;
-  underlineColor: CellColor | null;
+  underlineColor: Color | null;
   overline: boolean;
   strikethrough: boolean;
   inverse: boolean;
@@ -87,7 +85,16 @@ interface ScreenOptions {
   scrollbackLimit?: number;
   /** Callback for DA1/DA2/DSR responses — write these back to the PTY */
   onResponse?: (data: string) => void;
+  /**
+   * Maximum UTF-16 code units retained for one APC or DCS string sequence.
+   * Image protocols use ASCII/base64 payloads, so this is also their byte
+   * bound. Longer sequences are consumed without buffering or dispatch and
+   * surface one typed `string-overflow` parser event at their terminator.
+   */
+  maxStringSequenceLength?: number;
 }
+/** Default retained payload bound for one APC/DCS sequence (16 MiB of ASCII/base64). */
+declare const DEFAULT_MAX_STRING_SEQUENCE_LENGTH: number;
 interface SemanticZone {
   type: "prompt" | "command" | "output";
   startRow: number;
@@ -99,13 +106,13 @@ interface SixelImage {
   col: number;
 }
 interface ScreenAttrsSnapshot {
-  fg: CellColor | null;
-  bg: CellColor | null;
+  fg: Color | null;
+  bg: Color | null;
   bold: boolean;
   faint: boolean;
   italic: boolean;
   underline: UnderlineStyle;
-  underlineColor: CellColor | null;
+  underlineColor: Color | null;
   overline: boolean;
   strikethrough: boolean;
   inverse: boolean;
@@ -114,15 +121,15 @@ interface ScreenAttrsSnapshot {
   url: string | null;
 }
 interface ScreenColorStateSnapshot {
-  palette256: CellColor[];
-  defaultFgColor: CellColor | null;
-  defaultBgColor: CellColor | null;
-  cursorColor: CellColor | null;
-  specialColors: [number, CellColor][];
-  pointerFgColor: CellColor | null;
-  pointerBgColor: CellColor | null;
-  highlightBgColor: CellColor | null;
-  highlightFgColor: CellColor | null;
+  palette256: Color[];
+  defaultFgColor: Color | null;
+  defaultBgColor: Color | null;
+  cursorColor: Color | null;
+  specialColors: [number, Color][];
+  pointerFgColor: Color | null;
+  pointerBgColor: Color | null;
+  highlightBgColor: Color | null;
+  highlightFgColor: Color | null;
 }
 type ScreenParserState = "ground" | "escape" | "escape_charset" | "escape_hash" | "csi" | "osc" | "dcs" | "dcs_passthrough" | "osc_st" | "dcs_st" | "apc" | "apc_st";
 interface ScreenBufferSnapshot {
@@ -132,8 +139,7 @@ interface ScreenBufferSnapshot {
 /**
  * The whole-world persist/restore value — grids, ranges, modes, cursor, colors,
  * parser transients, wrap bits. JSON-safe plain data; the persist boundary, not the
- * incremental read path. Named `Snapshot` per §9 (the namespace supplies the context);
- * {@link ScreenSnapshot} is the deprecated alias.
+ * incremental read path. Named `Snapshot` per §9 (the namespace supplies the context).
  *
  * Note: `cursor`/`savedState` still carry `x`/`y` (not `col`/`row`) — the §9
  * `Cursor{col,row}` field rename is DEFERRED here because these fields are the wire
@@ -223,7 +229,15 @@ interface Snapshot {
       row: number;
       col: number;
     };
+    dcsReceivedLength?: number;
+    dcsOverflow?: boolean;
     apc: string;
+    apcStart?: {
+      row: number;
+      col: number;
+    };
+    apcReceivedLength?: number;
+    apcOverflow?: boolean;
     utf8PendingBytes: number[];
   };
   unicode: {
@@ -233,13 +247,10 @@ interface Snapshot {
     afterZWJ: boolean;
   };
 }
-/** @deprecated Renamed to {@link Snapshot} (§9 naming ruling). This alias rides the migration window. */
-type ScreenSnapshot = Snapshot;
 /**
  * The cursor position at the read boundary, in the grid's own `col`/`row` vocabulary
  * (§9 naming ruling: `x`/`y` contradicted the row/col naming used everywhere else, and
- * the `State` suffix was redundant). Returned by {@link VtermScreen.getCursor}; the legacy
- * {@link VtermScreen.getCursorPosition} still returns the `{ x, y }` shape (deprecated).
+ * the `State` suffix was redundant). Returned by {@link VtermScreen.getCursor}.
  */
 interface Cursor {
   col: number;
@@ -279,8 +290,12 @@ type TerminalOp = {
  *               charset/`#` designators); `final` is the dispatching byte, `intermediates`
  *               carries the `(`/`)`/`#` designator byte when present.
  *
- * DCS and APC string sequences are not (yet) surfaced. A listener MUST NOT throw — taps are
- * fail-loud: an exception propagates out of the write call (the engine state stays consistent).
+ * - `dcs` / `apc` — a complete bounded string sequence with the guest-local cursor anchor at
+ *                   sequence start. Payloads beyond `maxStringSequenceLength` are not dispatched;
+ *                   their terminator emits one typed `string-overflow` event instead.
+ *
+ * A listener MUST NOT throw — taps are fail-loud: an exception propagates out of the write call
+ * (the engine state stays consistent).
  */
 type ParserEvent = {
   kind: "print";
@@ -302,6 +317,23 @@ type ParserEvent = {
   kind: "esc";
   final: string;
   intermediates?: string;
+} | {
+  kind: "apc";
+  data: string;
+  row: number;
+  col: number;
+} | {
+  kind: "dcs";
+  data: string;
+  row: number;
+  col: number;
+} | {
+  kind: "string-overflow";
+  sequence: "apc" | "dcs";
+  maxLength: number;
+  receivedLength: number;
+  row: number;
+  col: number;
 };
 /**
  * Accumulated per-row damage since the previous {@link Screen.takeDirty} call — the PULL-plane
@@ -452,8 +484,6 @@ interface Screen {
    * stripped of palette-origin index at the read boundary.
    */
   getRow(row: number): ScreenCell[];
-  /** @deprecated Renamed to {@link getRow} (§9: row = cells, line = text). */
-  getLine(row: number): ScreenCell[];
   getText(): string;
   /** Scrollback rows above the visible grid, oldest first, rendered like getText(). */
   getScrollbackText(): string;
@@ -469,8 +499,8 @@ interface Screen {
   viewportTop(): number;
   /**
    * The row at ABSOLUTE index `row` (row 0 = oldest retained scrollback line; the screen occupies
-   * the last `screenRows()` rows). Colors are stripped of palette-origin index like {@link getLine}.
-   * Out-of-range indices return a blank row (matching the {@link getLine} read-boundary contract).
+   * the last `screenRows()` rows). Colors are stripped of palette-origin index like {@link getRow}.
+   * Out-of-range indices return a blank row (matching the {@link getRow} read-boundary contract).
    */
   getRowAbsolute(row: number): ScreenCell[];
   /**
@@ -488,11 +518,6 @@ interface Screen {
   takeDirty(): DirtyRegion;
   /** Cursor position in the grid's `col`/`row` vocabulary (§9). See {@link Cursor}. */
   getCursor(): Cursor;
-  /** @deprecated Use {@link getCursor} — returns `{ col, row }` per the §9 naming ruling. */
-  getCursorPosition(): {
-    x: number;
-    y: number;
-  };
   getCursorVisible(): boolean;
   getCursorShape(): "block" | "underline" | "bar";
   getCursorBlinking(): boolean;
@@ -534,19 +559,19 @@ interface SerializeOptions {
  * color stack, and parser/pending-wrap/mid-parse state are unserializable to
  * a VT byte stream by design — the binary snapshot carries them.
  */
-declare function serializeSnapshot(snapshot: ScreenSnapshot, options?: SerializeOptions): string;
+declare function serializeSnapshot(snapshot: Snapshot, options?: SerializeOptions): string;
 //#endregion
 //#region src/snapshot-codec.d.ts
 /**
- * Encode a {@link ScreenSnapshot} to a compact binary buffer. Output is
+ * Encode a {@link Snapshot} to a compact binary buffer. Output is
  * deterministic for identical input and decodes back to a deep-equal snapshot.
  */
-declare function encodeScreenSnapshotBinary(snapshot: ScreenSnapshot): Uint8Array;
+declare function encodeScreenSnapshotBinary(snapshot: Snapshot): Uint8Array;
 /**
  * Decode a buffer produced by {@link encodeScreenSnapshotBinary} back into a
- * {@link ScreenSnapshot}. Throws loudly on an unknown version byte, truncated
+ * {@link Snapshot}. Throws loudly on an unknown version byte, truncated
  * input, or any internal inconsistency — never returns a partial/normalized result.
  */
-declare function decodeScreenSnapshotBinary(bytes: Uint8Array): ScreenSnapshot;
+declare function decodeScreenSnapshotBinary(bytes: Uint8Array): Snapshot;
 //#endregion
-export { type CellColor, type Color, type Cursor, type DirtyRegion, type ParserEvent, type ReadSignal, type ScreenCell, type ScreenSignals, type ScreenSnapshot, type ScreenSnapshot as VtermScreenSnapshot, type SemanticZone, type SerializeOptions, type SixelImage, type Size, type Snapshot, type TerminalModes, type TerminalOp, type UnderlineStyle, type Screen as VtermScreen, type ScreenAttrsSnapshot as VtermScreenAttrsSnapshot, type ScreenBufferSnapshot as VtermScreenBufferSnapshot, type ScreenColorStateSnapshot as VtermScreenColorStateSnapshot, type ScreenOptions as VtermScreenOptions, type ScreenParserState as VtermScreenParserState, createScreen as createVtermScreen, decodeScreenSnapshotBinary, encodeScreenSnapshotBinary, serializeSnapshot };
+export { type Color, type Cursor, DEFAULT_MAX_STRING_SEQUENCE_LENGTH, type DirtyRegion, type ParserEvent, type ReadSignal, type ScreenCell, type ScreenSignals, type SemanticZone, type SerializeOptions, type SixelImage, type Size, type Snapshot, type TerminalModes, type TerminalOp, type UnderlineStyle, type Screen as VtermScreen, type ScreenAttrsSnapshot as VtermScreenAttrsSnapshot, type ScreenBufferSnapshot as VtermScreenBufferSnapshot, type ScreenColorStateSnapshot as VtermScreenColorStateSnapshot, type ScreenOptions as VtermScreenOptions, type ScreenParserState as VtermScreenParserState, createScreen as createVtermScreen, decodeScreenSnapshotBinary, encodeScreenSnapshotBinary, serializeSnapshot };

package/dist/index.mjs

@@ -1,4 +1,6 @@
 //#region src/screen.ts
+/** Default retained payload bound for one APC/DCS sequence (16 MiB of ASCII/base64). */
+const DEFAULT_MAX_STRING_SEQUENCE_LENGTH = 16 * 1024 * 1024;
 /** Frozen sentinel for unwritten cells — never mutate, copy-on-write in writeChar(). */
 const EMPTY_CELL = Object.freeze({
 	char: "",
@@ -21,10 +23,10 @@ function emptyCell() {
 	return { ...EMPTY_CELL };
 }
 /**
-* Drop the palette-origin {@link CellColor.index} for the public per-cell read
-* boundary. `getCell`/`getLine` return the RESOLVED RGB — their long-standing
+* Drop the palette-origin {@link Color.index} for the public per-cell read
+* boundary. `getCell`/`getRow` return the RESOLVED RGB — their long-standing
 * contract — while the origin index is serialization-only provenance that rides
-* {@link ScreenSnapshot} (and thus `serialize()`), not the inspection API.
+* {@link Snapshot} (and thus `serialize()`), not the inspection API.
 * Returns the SAME reference when there is no index (the common truecolor/null
 * case), so the read path allocates nothing there.
 */
@@ -79,7 +81,7 @@ function bitsToUnderline(meta) {
 function packRgb(c) {
 	return ((c.r & 255) << 16 | (c.g & 255) << 8 | c.b & 255) >>> 0;
 }
-/** Materialize a {@link CellColor} from a packed RGB word + index (`-1` = no index). */
+/** Materialize a {@link Color} from a packed RGB word + index (`-1` = no index). */
 function unpackColor(rgb, idx) {
 	const r = rgb >> 16 & 255;
 	const g = rgb >> 8 & 255;
@@ -461,6 +463,8 @@ function createScreen(options = {}) {
 	let rows = options.rows ?? 24;
 	let scrollbackLimit = options.scrollbackLimit ?? 1e3;
 	const onResponse = options.onResponse;
+	const maxStringSequenceLength = options.maxStringSequenceLength ?? 16777216;
+	if (!Number.isSafeInteger(maxStringSequenceLength) || maxStringSequenceLength < 0) throw new RangeError("maxStringSequenceLength must be a non-negative safe integer");
 	let mainGrid = makeGrid(cols, rows);
 	let altGrid = makeGrid(cols, rows);
 	let grid = mainGrid;
@@ -718,7 +722,16 @@ function createScreen(options = {}) {
 		assertRecord("parser.dcsStart", parser.dcsStart);
 		assertInteger("parser.dcsStart.row", parser.dcsStart.row);
 		assertInteger("parser.dcsStart.col", parser.dcsStart.col);
+		if (parser.dcsReceivedLength !== void 0) assertInteger("parser.dcsReceivedLength", parser.dcsReceivedLength, 0);
+		if (parser.dcsOverflow !== void 0) assertBoolean("parser.dcsOverflow", parser.dcsOverflow);
 		assertString("parser.apc", parser.apc);
+		if (parser.apcStart !== void 0) {
+			assertRecord("parser.apcStart", parser.apcStart);
+			assertInteger("parser.apcStart.row", parser.apcStart.row);
+			assertInteger("parser.apcStart.col", parser.apcStart.col);
+		}
+		if (parser.apcReceivedLength !== void 0) assertInteger("parser.apcReceivedLength", parser.apcReceivedLength, 0);
+		if (parser.apcOverflow !== void 0) assertBoolean("parser.apcOverflow", parser.apcOverflow);
 		if (!Array.isArray(parser.utf8PendingBytes)) throw new TypeError("Invalid vterm snapshot parser.utf8PendingBytes");
 		for (const byte of parser.utf8PendingBytes) {
 			assertInteger("parser.utf8PendingBytes", byte, 0);
@@ -775,7 +788,13 @@ function createScreen(options = {}) {
 	let dcsBuf = "";
 	let dcsStartRow = 0;
 	let dcsStartCol = 0;
+	let dcsReceivedLength = 0;
+	let dcsOverflow = false;
 	let apcBuf = "";
+	let apcStartRow = 0;
+	let apcStartCol = 0;
+	let apcReceivedLength = 0;
+	let apcOverflow = false;
 	const opListeners = /* @__PURE__ */ new Set();
 	const parserListeners = /* @__PURE__ */ new Set();
 	let printRunParts = [];
@@ -2686,7 +2705,13 @@ function createScreen(options = {}) {
 		dcsBuf = "";
 		dcsStartRow = 0;
 		dcsStartCol = 0;
+		dcsReceivedLength = 0;
+		dcsOverflow = false;
 		apcBuf = "";
+		apcStartRow = 0;
+		apcStartCol = 0;
+		apcReceivedLength = 0;
+		apcOverflow = false;
 		utf8PendingBytes = [];
 		semanticZones = [];
 		mainSoftWrapped = new Array(rows).fill(false);
@@ -2759,6 +2784,68 @@ function createScreen(options = {}) {
 		if (intermediates !== "") ev.intermediates = intermediates;
 		emitParserEvent(ev);
 	}
+	function emitStringEvent(sequence, data, row, col) {
+		if (parserListeners.size === 0) return;
+		flushPrintRun();
+		emitParserEvent({
+			kind: sequence,
+			data,
+			row,
+			col
+		});
+	}
+	function emitStringOverflow(sequence, receivedLength, row, col) {
+		if (parserListeners.size === 0) return;
+		flushPrintRun();
+		emitParserEvent({
+			kind: "string-overflow",
+			sequence,
+			maxLength: maxStringSequenceLength,
+			receivedLength,
+			row,
+			col
+		});
+	}
+	function appendDCS(ch) {
+		dcsReceivedLength += ch.length;
+		if (dcsOverflow) return;
+		if (dcsReceivedLength > maxStringSequenceLength) {
+			dcsOverflow = true;
+			dcsBuf = "";
+			return;
+		}
+		dcsBuf += ch;
+	}
+	function appendAPC(ch) {
+		apcReceivedLength += ch.length;
+		if (apcOverflow) return;
+		if (apcReceivedLength > maxStringSequenceLength) {
+			apcOverflow = true;
+			apcBuf = "";
+			return;
+		}
+		apcBuf += ch;
+	}
+	function finishDCS() {
+		if (dcsOverflow) emitStringOverflow("dcs", dcsReceivedLength, dcsStartRow, dcsStartCol);
+		else {
+			handleDCS(dcsBuf);
+			emitStringEvent("dcs", dcsBuf, dcsStartRow, dcsStartCol);
+		}
+		dcsBuf = "";
+		dcsReceivedLength = 0;
+		dcsOverflow = false;
+	}
+	function finishAPC() {
+		if (apcOverflow) emitStringOverflow("apc", apcReceivedLength, apcStartRow, apcStartCol);
+		else {
+			handleAPC(apcBuf);
+			emitStringEvent("apc", apcBuf, apcStartRow, apcStartCol);
+		}
+		apcBuf = "";
+		apcReceivedLength = 0;
+		apcOverflow = false;
+	}
 	function emitOp(op) {
 		for (const listener of opListeners) listener(op);
 	}
@@ -2816,6 +2903,8 @@ function createScreen(options = {}) {
 						dcsBuf = "";
 						dcsStartRow = curY;
 						dcsStartCol = curX;
+						dcsReceivedLength = 0;
+						dcsOverflow = false;
 					} else if (ch === "c") {
 						fullReset();
 						parserState = "ground";
@@ -2900,6 +2989,10 @@ function createScreen(options = {}) {
 					} else if (ch === "_") {
 						parserState = "apc";
 						apcBuf = "";
+						apcStartRow = curY;
+						apcStartCol = curX;
+						apcReceivedLength = 0;
+						apcOverflow = false;
 					} else parserState = "ground";
 					break;
 				case "escape_charset":
@@ -2966,12 +3059,17 @@ function createScreen(options = {}) {
 				case "dcs":
 					if (code === 27) parserState = "dcs_st";
 					else if (code === 7) {
-						handleDCS(dcsBuf);
+						finishDCS();
 						parserState = "ground";
-					} else dcsBuf += ch;
+					} else appendDCS(ch);
 					break;
 				case "dcs_st":
-					if (ch === "\\") handleDCS(dcsBuf);
+					if (ch === "\\") finishDCS();
+					else {
+						dcsBuf = "";
+						dcsReceivedLength = 0;
+						dcsOverflow = false;
+					}
 					parserState = "ground";
 					break;
 				case "dcs_passthrough":
@@ -2980,12 +3078,17 @@ function createScreen(options = {}) {
 				case "apc":
 					if (code === 27) parserState = "apc_st";
 					else if (code === 7) {
-						handleAPC(apcBuf);
+						finishAPC();
 						parserState = "ground";
-					} else apcBuf += ch;
+					} else appendAPC(ch);
 					break;
 				case "apc_st":
-					if (ch === "\\") handleAPC(apcBuf);
+					if (ch === "\\") finishAPC();
+					else {
+						apcBuf = "";
+						apcReceivedLength = 0;
+						apcOverflow = false;
+					}
 					parserState = "ground";
 					break;
 			}
@@ -3239,7 +3342,15 @@ function createScreen(options = {}) {
 					row: dcsStartRow,
 					col: dcsStartCol
 				},
+				dcsReceivedLength,
+				dcsOverflow,
 				apc: apcBuf,
+				apcStart: {
+					row: apcStartRow,
+					col: apcStartCol
+				},
+				apcReceivedLength,
+				apcOverflow,
 				utf8PendingBytes: [...utf8PendingBytes]
 			},
 			unicode: {
@@ -3319,7 +3430,13 @@ function createScreen(options = {}) {
 		dcsBuf = snapshotValue.parser.dcs;
 		dcsStartRow = snapshotValue.parser.dcsStart.row;
 		dcsStartCol = snapshotValue.parser.dcsStart.col;
+		dcsReceivedLength = snapshotValue.parser.dcsReceivedLength ?? dcsBuf.length;
+		dcsOverflow = snapshotValue.parser.dcsOverflow ?? false;
 		apcBuf = snapshotValue.parser.apc;
+		apcStartRow = snapshotValue.parser.apcStart?.row ?? curY;
+		apcStartCol = snapshotValue.parser.apcStart?.col ?? curX;
+		apcReceivedLength = snapshotValue.parser.apcReceivedLength ?? apcBuf.length;
+		apcOverflow = snapshotValue.parser.apcOverflow ?? false;
 		utf8PendingBytes = [...snapshotValue.parser.utf8PendingBytes];
 		charsetG0 = snapshotValue.unicode.charsetG0;
 		lastChar = snapshotValue.unicode.lastChar;
@@ -3348,7 +3465,7 @@ function createScreen(options = {}) {
 		if (!r || col >= cols) return emptyCell();
 		return stripCellColorIndex(r.getCellRaw(col));
 	}
-	function getLine(row) {
+	function getRow(row) {
 		const r = grid[row];
 		if (!r) return makeRow(cols).toCells();
 		return r.toCells().map(stripCellColorIndex);
@@ -3642,8 +3759,7 @@ function createScreen(options = {}) {
 		snapshot,
 		restore,
 		getCell,
-		getRow: getLine,
-		getLine,
+		getRow,
 		getText,
 		getScrollbackText,
 		getTextRange,
@@ -3657,10 +3773,6 @@ function createScreen(options = {}) {
 			col: curX,
 			row: curY
 		}),
-		getCursorPosition: () => ({
-			x: curX,
-			y: curY
-		}),
 		getCursorVisible: () => curVisible,
 		getCursorShape: () => cursorShape,
 		getCursorBlinking: () => cursorBlinking,
@@ -4462,7 +4574,7 @@ function readGridSection(r, softWrapNullable, expected, strings, colors, styles)
 	};
 }
 /**
-* Encode a {@link ScreenSnapshot} to a compact binary buffer. Output is
+* Encode a {@link Snapshot} to a compact binary buffer. Output is
 * deterministic for identical input and decodes back to a deep-equal snapshot.
 */
 function encodeScreenSnapshotBinary(snapshot) {
@@ -4505,7 +4617,7 @@ function encodeScreenSnapshotBinary(snapshot) {
 }
 /**
 * Decode a buffer produced by {@link encodeScreenSnapshotBinary} back into a
-* {@link ScreenSnapshot}. Throws loudly on an unknown version byte, truncated
+* {@link Snapshot}. Throws loudly on an unknown version byte, truncated
 * input, or any internal inconsistency — never returns a partial/normalized result.
 */
 function decodeScreenSnapshotBinary(bytes) {
@@ -4557,4 +4669,4 @@ function decodeScreenSnapshotBinary(bytes) {
 	};
 }
 //#endregion
-export { createScreen as createVtermScreen, decodeScreenSnapshotBinary, encodeScreenSnapshotBinary, serializeSnapshot };
+export { DEFAULT_MAX_STRING_SEQUENCE_LENGTH, createScreen as createVtermScreen, decodeScreenSnapshotBinary, encodeScreenSnapshotBinary, serializeSnapshot };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vterm.js",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Modern terminal emulator — full VT/ECMA-48/xterm standards coverage. Pure TypeScript, zero dependencies.",
   "keywords": [
     "ansi",