@termless/vt100-rust 0.8.4 → 0.10.2

package/README.md

@@ -2,6 +2,8 @@
 
 Rust vt100 backend for termless -- wraps the [vt100](https://crates.io/crates/vt100) Rust crate via napi-rs.
 
+> Install from npm; a git install resolves the TypeScript source and runs only under Bun.
+
 ## Build
 
 Requires Rust toolchain:

package/dist/index.d.mts

@@ -1,9 +1,4 @@
-//#region ../../src/terminal/types.d.ts
-interface TerminalOptions {
-  cols: number;
-  rows: number;
-  scrollbackLimit?: number;
-}
+//#region ../../src/io/picture.d.ts
 interface Cell {
   char: string;
   fg: Color | null;
@@ -50,13 +45,32 @@ interface Cursor {
   visible: boolean | null;
   /** Cursor shape. `null` if the backend doesn't know. */
   style: CursorStyle | null;
-  /** @deprecated Renamed to {@link Cursor.col}. Kept required during the migration window. */
+  /** @deprecated REMOVING in unterm phase A4 — renamed to {@link Cursor.col}. Kept required during the migration window. */
   x: number;
-  /** @deprecated Renamed to {@link Cursor.row}. Kept required during the migration window. */
+  /** @deprecated REMOVING in unterm phase A4 — renamed to {@link Cursor.row}. Kept required during the migration window. */
   y: number;
 }
 type CursorStyle = "block" | "underline" | "beam";
-type TerminalMode = "altScreen" | "cursorVisible" | "bracketedPaste" | "applicationCursor" | "applicationKeypad" | "autoWrap" | "mouseTracking" | "focusTracking" | "originMode" | "insertMode" | "reverseVideo";
+/**
+ * A terminal mode an emulator can report.
+ *
+ * The full-word mode vocabulary. `terminal/types.ts` re-exports this as the
+ * deprecated `TerminalMode`.
+ */
+type Mode = "altScreen" | "cursorVisible" | "bracketedPaste" | "applicationCursor" | "applicationKeypad" | "autoWrap" | "mouseTracking" | "focusTracking" | "originMode" | "insertMode" | "reverseVideo";
+//#endregion
+//#region ../../src/terminal/types.d.ts
+interface TerminalOptions {
+  cols: number;
+  rows: number;
+  scrollbackLimit?: number;
+}
+/**
+ * @deprecated REMOVING in unterm phase A4 — renamed to `Mode`
+ * (`@termless/core/io`). A true alias: same union, full-word member names
+ * unchanged.
+ */
+type TerminalMode = Mode;
 interface ScrollbackState {
   /**
    * Absolute row index of the row where the viewport region starts in the buffer.
@@ -78,11 +92,11 @@ interface ScrollbackState {
    * (rows `totalRows - screenRows` through `totalRows - 1`).
    */
   screenRows: number;
-  /** @deprecated Renamed to {@link ScrollbackState.viewportTop}. Kept required during the migration window. */
+  /** @deprecated REMOVING in unterm phase A4 — renamed to {@link ScrollbackState.viewportTop}. Kept required during the migration window. */
   viewportOffset: number;
-  /** @deprecated Renamed to {@link ScrollbackState.totalRows}. Kept required during the migration window. */
+  /** @deprecated REMOVING in unterm phase A4 — renamed to {@link ScrollbackState.totalRows}. Kept required during the migration window. */
   totalLines: number;
-  /** @deprecated Renamed to {@link ScrollbackState.screenRows}. Kept required during the migration window. */
+  /** @deprecated REMOVING in unterm phase A4 — renamed to {@link ScrollbackState.screenRows}. Kept required during the migration window. */
   screenLines: number;
 }
 interface KeyDescriptor {
@@ -94,6 +108,7 @@ interface KeyDescriptor {
 }
 interface TerminalCapabilities {
   name: string;
+  /** `capabilities.version` is the upstream engine release pinned by `upstreamVersion` in `backends.json` for the default install (`"not-applicable"` without an upstream), not the wrapper release or proof of execution; non-default installs are outside this claim and a run's `runtimeIdentity` supplies execution evidence. */
   version: string;
   truecolor: boolean;
   kittyKeyboard: boolean;
@@ -115,6 +130,13 @@ interface TerminalCapabilities {
  * **Coordinate system**: All row parameters use **absolute buffer rows**.
  * Row 0 is the first row in scrollback history. The screen occupies the
  * last `screenRows` rows (from `totalRows - screenRows` to `totalRows - 1`).
+ *
+ * @deprecated REMOVING in unterm phase A4 — the read half of `Emulator`
+ * (`@termless/core/io`), where the readable picture lives on the emulator
+ * itself. Not a true alias: `Emulator` spells the cursor, modes and size as
+ * properties (`cursor`, `modes`, `size`) rather than accessors
+ * (`getCursor()`, `getMode(m)`, `getScrollback()`). Adapt with
+ * `emulatorFromBackend()` in `terminal/io-compat.ts`.
  */
 interface Terminal {
   /** Get all buffer text (scrollback + screen) as a newline-joined string. */
@@ -131,9 +153,9 @@ interface Terminal {
   getRow(row: number): Cell[];
   /** Get every row as a cell array (entire buffer: scrollback + screen). */
   getRows(): Cell[][];
-  /** @deprecated Renamed to {@link Terminal.getRow} (row = cells). Kept required during the migration window. */
+  /** @deprecated REMOVING in unterm phase A4 — renamed to {@link Terminal.getRow} (row = cells). Kept required during the migration window. */
   getLine(row: number): Cell[];
-  /** @deprecated Renamed to {@link Terminal.getRows} (row = cells). Kept required during the migration window. */
+  /** @deprecated REMOVING in unterm phase A4 — renamed to {@link Terminal.getRows} (row = cells). Kept required during the migration window. */
   getLines(): Cell[][];
   getCursor(): Cursor;
   getMode(mode: TerminalMode): boolean;
@@ -177,6 +199,17 @@ interface ScreenshotOptions {
    */
   renderer?: "canvas" | "resvg" | "swash" | "browser" | "auto";
 }
+/**
+ * Every backend implements this: the {@link Terminal} read contract plus
+ * lifecycle, the byte feed, resize, key encoding and capabilities.
+ *
+ * @deprecated REMOVING in unterm phase A4 — replaced by `Emulator`
+ * (`@termless/core/io`), which collapses `feed`/`resize`/`reset` into a single
+ * `apply(event)` door. Not a true alias: `Emulator` has no `init`/`destroy`
+ * lifecycle, no `encodeKey`, and no `capabilities` — those either move to the
+ * factory that builds the emulator or to the parts around it. Adapt an
+ * existing backend with `emulatorFromBackend()` in `terminal/io-compat.ts`.
+ */
 interface TerminalBackend extends Terminal {
   readonly name: string;
   init(opts: TerminalOptions): void;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/terminal/types.ts","../src/backend.ts","../src/index.ts"],"mappings":";UAIiB;EACf;EACA;EACA;;UAKe;EACf;EACA,IAAI;EACJ,IAAI;EACJ;EACA;EACA;EACA,WAAW;EACX,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;;KAUU;;;;;;;KAQA;EAAU;EAAW;EAAW;EAAW;;UAOtC;;EAEf;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;;EAEA;;KAMU;KAIA;UAeK;;;;;;;;;EASf;;;;;EAKA;;;;;;EAMA;;EAEA;;EAEA;;EAEA;;UAKe;EACf;EACA;EACA;EACA;EACA;;UAKe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;;;;;;;;;;;;;UAwEG;;EAEf;;;;;;EAMA,aAAa,kBAAkB,kBAAkB,gBAAgB;;EAEjE,QAAQ,aAAa,cAAc;;EAEnC,OAAO,cAAc;;EAErB,WAAW;;EAEX,QAAQ,cAAc;;EAEtB,YAAY;EACZ,aAAa;EACb,QAAQ,MAAM;EACd;EACA,iBAAiB;;;;;;;;;;;;;UAqBF;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;;;;;;;;;EAUR;;UAGe,wBAAwB;WAC9B;EAGT,KAAK,MAAM;EACX;EAGA,KAAK,MAAM;EACX,OAAO,cAAc;EACrB;EAGA,UAAU,KAAK,gBAAgB;;;;;;;EAQ/B,cAAc,MAAM;EAGpB,eAAe;WAGN,cAAc;;;;;;;;;;;EAYvB,YAAY,OAAO,oBAAoB,QAAQ;;;;UCpSvC;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGQ;EACR;EACA;EACA;EACA;;UAGQ;EACR;EACA;EACA;;UAGQ;EACR,KAAK,MAAM;EACX,OAAO,cAAc;EACrB;EACA;EACA,aAAa,kBAAkB,kBAAkB,gBAAgB;EACjE,QAAQ,aAAa,cAAc;EACnC,QAAQ,cAAc;EACtB,aAAa;EACb,QAAQ;EACR;EACA,iBAAiB;EACjB,eAAe;;EAEf,iBAAiB;;UAGT;EACR,wBAAwB,cAAc,cAAc,6BAA6B;;;;;;iBAUnE,uBAAuB;;;;;;;;;;iBAkFvB,uBAAuB,OAAO,QAAQ,kBAAkB,SAAS,eAAe;;;;iBCtK1E,QAAQ,OAAO,QAAQ,mBAAmB,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/io/picture.ts","../../../src/terminal/types.ts","../src/backend.ts","../src/index.ts"],"mappings":";UAwBiB;EACf;EACA,IAAI;EACJ,IAAI;EACJ;EACA;EACA;EACA,WAAW;EACX,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;;KAUU;;;;;;;KAQA;EAAU;EAAW;EAAW;EAAW;;UAItC;;EAEf;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;;EAEA;;KAGU;;;;;;;KAUA;;;UC/EK;EACf;EACA;EACA;;;;;;;KAmBU,eAAe;UAIV;;;;;;;;;EASf;;;;;EAKA;;;;;;EAMA;;EAEA;;EAEA;;EAEA;;UAKe;EACf;EACA;EACA;EACA;EACA;;UAKe;EACf;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;;;;;;;;;;;;;;;;;;;;UA6EG;;EAEf;;;;;;EAMA,aAAa,kBAAkB,kBAAkB,gBAAgB;;EAEjE,QAAQ,aAAa,cAAc;;EAEnC,OAAO,cAAc;;EAErB,WAAW;;EAEX,QAAQ,cAAc;;EAEtB,YAAY;EACZ,aAAa;EACb,QAAQ,MAAM;EACd;EACA,iBAAiB;;;;;;;;;;;;;UAkBF;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;;;;;;;;;EAUR;;;;;;;;;;;;;UAce,wBAAwB;WAC9B;EAGT,KAAK,MAAM;EACX;EAGA,KAAK,MAAM;EACX,OAAO,cAAc;EACrB;EAGA,UAAU,KAAK,gBAAgB;;;;;;;EAQ/B,cAAc,MAAM;EAGpB,eAAe;WAGN,cAAc;;;;;;;;;;;EAYvB,YAAY,OAAO,oBAAoB,QAAQ;;;;UC7PvC;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGQ;EACR;EACA;EACA;EACA;;UAGQ;EACR;EACA;EACA;;UAGQ;EACR,KAAK,MAAM;EACX,OAAO,cAAc;EACrB;EACA;EACA,aAAa,kBAAkB,kBAAkB,gBAAgB;EACjE,QAAQ,aAAa,cAAc;EACnC,QAAQ,cAAc;EACtB,aAAa;EACb,QAAQ;EACR;EACA,iBAAiB;EACjB,eAAe;;EAEf,iBAAiB;;UAGT;EACR,wBAAwB,cAAc,cAAc,6BAA6B;;;;;;iBAUnE,uBAAuB;;;;;;;;;;iBA+EvB,uBAAuB,OAAO,QAAQ,kBAAkB,SAAS,eAAe;;;;iBChK1E,QAAQ,OAAO,QAAQ,mBAAmB,QAAQ"}

package/dist/index.mjs

@@ -1,7 +1,4 @@
 import { createRequire } from "node:module";
-//#region \0rolldown/runtime.js
-var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
-//#endregion
 //#region ../../src/terminal/key-mapping.ts
 const KEY_MAP = {
 	ArrowUp: "\x1B[A",
@@ -69,9 +66,7 @@ function parseKey(key) {
 		case "alt":
 			result.alt = true;
 			break;
-		case "super":
-			result.super = true;
-			break;
+		case "super": result.super = true;
 	}
 	return result;
 }
@@ -140,6 +135,18 @@ function encodeKeyToAnsi(key) {
 	const ansi = keyToAnsi(key);
 	return encoder.encode(ansi);
 }
+createRequire(import.meta.url);
+/** Load a native addon from caller-relative candidates without static `.node` imports. */
+function loadNativeAddon(options) {
+	const requireFromCaller = createRequire(options.callerUrl);
+	const errors = [];
+	for (const candidate of options.candidates) try {
+		return requireFromCaller(candidate);
+	} catch (error) {
+		errors.push(`  - ${candidate}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	throw new Error(`Failed to load ${options.packageName} native module on ${process.platform}/${process.arch}.\nPrebuilt scope: ${options.prebuiltScope}\nTried:\n${options.candidates.map((candidate) => `  - ${candidate}`).join("\n")}\nLoad attempts:\n${errors.join("\n")}`);
+}
 //#endregion
 //#region src/backend.ts
 let nativeModule = null;
@@ -152,14 +159,15 @@ function loadVt100RustNative() {
 	if (nativeModule) return nativeModule;
 	if (loadError) throw loadError;
 	try {
-		const mod = __require("../termless-vt100-rust.node");
-		nativeModule = mod;
-		return mod;
-	} catch (e) {
-		loadError = /* @__PURE__ */ new Error(`Failed to load vt100-rust native module. Build it first:
-  cd packages/vt100-rust/native && cargo build --release
-  cp target/release/libtermless_vt100_rust_native.dylib ../termless-vt100-rust.node
-\nOriginal error: ${e instanceof Error ? e.message : String(e)}`);
+		nativeModule = loadNativeAddon({
+			callerUrl: import.meta.url,
+			packageName: "@termless/vt100-rust",
+			candidates: ["../termless-vt100-rust.node"],
+			prebuiltScope: "linux-x64-glibc only"
+		});
+		return nativeModule;
+	} catch (error) {
+		loadError = error;
 		throw loadError;
 	}
 }
@@ -342,7 +350,7 @@ function createVt100RustBackend(opts, native) {
 		encodeKey: encodeKeyToAnsi,
 		capabilities: {
 			name: "vt100-rust",
-			version: "0.1.0",
+			version: "0.16.2",
 			truecolor: true,
 			kittyKeyboard: false,
 			kittyGraphics: false,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/terminal/key-mapping.ts","../../../src/terminal/key-encoding.ts","../src/backend.ts","../src/index.ts"],"sourcesContent":["/**\n * Key parsing and ANSI encoding for termless.\n *\n * Converts human-readable key descriptions (e.g., \"Ctrl+a\", \"ArrowUp\", \"F5\")\n * into KeyDescriptor objects and ANSI escape sequences suitable for PTY input.\n */\n\nimport type { KeyDescriptor } from \"./types.ts\"\n\n// ── Named key → ANSI sequence map ──\n\nconst KEY_MAP: Record<string, string | null> = {\n  ArrowUp: \"\\x1b[A\",\n  ArrowDown: \"\\x1b[B\",\n  ArrowLeft: \"\\x1b[D\",\n  ArrowRight: \"\\x1b[C\",\n  Home: \"\\x1b[H\",\n  End: \"\\x1b[F\",\n  PageUp: \"\\x1b[5~\",\n  PageDown: \"\\x1b[6~\",\n  Enter: \"\\r\",\n  Tab: \"\\t\",\n  Backspace: \"\\x7f\",\n  Delete: \"\\x1b[3~\",\n  Escape: \"\\x1b\",\n  Space: \" \",\n  // Pure modifier keys produce no output on their own\n  Control: null,\n  Shift: null,\n  Alt: null,\n  Meta: null,\n}\n\n// ── Function keys F1-F12 ──\n\nconst FKEY_MAP: Record<string, string> = {\n  F1: \"\\x1bOP\",\n  F2: \"\\x1bOQ\",\n  F3: \"\\x1bOR\",\n  F4: \"\\x1bOS\",\n  F5: \"\\x1b[15~\",\n  F6: \"\\x1b[17~\",\n  F7: \"\\x1b[18~\",\n  F8: \"\\x1b[19~\",\n  F9: \"\\x1b[20~\",\n  F10: \"\\x1b[21~\",\n  F11: \"\\x1b[23~\",\n  F12: \"\\x1b[24~\",\n}\n\n// ── Modifier aliases ──\n\nconst MODIFIER_ALIASES: Record<string, string> = {\n  ctrl: \"ctrl\",\n  control: \"ctrl\",\n  shift: \"shift\",\n  alt: \"alt\",\n  meta: \"super\",\n  cmd: \"super\",\n  option: \"alt\",\n  super: \"super\",\n}\n\nfunction normalizeModifier(mod: string): string {\n  return MODIFIER_ALIASES[mod.toLowerCase()] ?? mod.toLowerCase()\n}\n\n/**\n * Parse a key string like \"Ctrl+a\", \"ArrowUp\", \"Shift+Tab\" into a KeyDescriptor.\n *\n * Supports modifier prefixes: Ctrl, Control, Alt, Shift, Meta, Cmd, Option, Super.\n * Modifiers are case-insensitive and separated by \"+\".\n */\nexport function parseKey(key: string): KeyDescriptor {\n  const parts = key.split(\"+\")\n  const mainKey = parts.pop()!\n  const result: KeyDescriptor = { key: mainKey }\n\n  for (const part of parts) {\n    const normalized = normalizeModifier(part)\n    switch (normalized) {\n      case \"ctrl\":\n        result.ctrl = true\n        break\n      case \"shift\":\n        result.shift = true\n        break\n      case \"alt\":\n        result.alt = true\n        break\n      case \"super\":\n        result.super = true\n        break\n    }\n  }\n\n  return result\n}\n\n/**\n * Convert a key descriptor or key string to its ANSI escape sequence.\n *\n * Handles:\n * - Single characters: returned as-is\n * - Named keys (ArrowUp, Enter, Tab, etc.): mapped to standard ANSI sequences\n * - Function keys (F1-F12): mapped to VT220/xterm sequences\n * - Ctrl+letter: ASCII control codes 1-26\n * - Ctrl+Enter: newline (\\n)\n * - Alt+key: ESC prefix + key\n */\nexport function keyToAnsi(key: KeyDescriptor | string): string {\n  const desc = typeof key === \"string\" ? parseKey(key) : key\n  const { key: mainKey, ctrl, alt, shift } = desc\n  const hasSuperOrMeta = desc.super\n\n  // Ctrl+letter -> control code (ASCII 1-26)\n  if (ctrl && mainKey.length === 1) {\n    const code = mainKey.toLowerCase().charCodeAt(0) - 96\n    if (code >= 1 && code <= 26) return String.fromCharCode(code)\n  }\n\n  // Ctrl+Enter -> \\n (legacy terminal convention: \\r = Enter, \\n = Ctrl+Enter/Ctrl+J)\n  if (ctrl && mainKey === \"Enter\") {\n    return \"\\n\"\n  }\n\n  // Alt (or Super/Meta) + single character -> ESC prefix\n  if ((alt || hasSuperOrMeta) && mainKey.length === 1) {\n    return `\\x1b${mainKey}`\n  }\n\n  // Function keys\n  const fkey = FKEY_MAP[mainKey]\n  if (fkey !== undefined) {\n    // With modifiers, use CSI sequences with modifier parameter\n    if (ctrl || alt || shift || hasSuperOrMeta) {\n      const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0)\n      // F1-F4 use SS3 format, convert to CSI for modified keys\n      const fkeyNum = parseInt(mainKey.slice(1))\n      if (fkeyNum <= 4) {\n        // F1=11, F2=12, F3=13, F4=14 in CSI ~ format\n        const csiNum = fkeyNum + 10\n        return `\\x1b[${csiNum};${mod}~`\n      }\n      // F5-F12 already use CSI ~ format: extract the number\n      const match = fkey.match(/\\x1b\\[(\\d+)~/)\n      if (match) {\n        return `\\x1b[${match[1]};${mod}~`\n      }\n    }\n    return fkey\n  }\n\n  // Named keys from KEY_MAP\n  const mapped = KEY_MAP[mainKey]\n  if (mapped !== undefined) {\n    if (mapped === null) return \"\" // Pure modifier keys produce nothing\n\n    // Arrow/navigation keys with modifiers use CSI 1;mod format\n    if ((ctrl || alt || shift || hasSuperOrMeta) && mapped.startsWith(\"\\x1b[\")) {\n      const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0)\n      // CSI letter format (e.g., \\x1b[A) -> CSI 1;mod letter\n      const letterMatch = mapped.match(/\\x1b\\[([A-H])$/)\n      if (letterMatch) {\n        return `\\x1b[1;${mod}${letterMatch[1]}`\n      }\n      // CSI num ~ format (e.g., \\x1b[5~) -> CSI num;mod ~\n      const tildeMatch = mapped.match(/\\x1b\\[(\\d+)~$/)\n      if (tildeMatch) {\n        return `\\x1b[${tildeMatch[1]};${mod}~`\n      }\n    }\n\n    // Shift+Tab -> reverse tab (CSI Z)\n    if (shift && mainKey === \"Tab\") {\n      return \"\\x1b[Z\"\n    }\n\n    return mapped\n  }\n\n  // Single character without modifiers\n  if (mainKey.length === 1) {\n    // Shift+letter -> uppercase (passthrough for terminals)\n    if (shift && mainKey.match(/[a-z]/)) {\n      return mainKey.toUpperCase()\n    }\n    return mainKey\n  }\n\n  // Unknown key: return as-is\n  return mainKey\n}\n","/**\n * Shared ANSI key encoding for terminal backends.\n *\n * All backends need to convert KeyDescriptor → Uint8Array for PTY input.\n * This module delegates to keyToAnsi() as the single source of truth for\n * ANSI key encoding, converting the string result to bytes.\n */\n\nimport type { KeyDescriptor } from \"./types.ts\"\nimport { keyToAnsi } from \"./key-mapping.ts\"\n\n// Module-level TextEncoder for efficiency (avoids per-call allocation)\nconst encoder = new TextEncoder()\n\n/**\n * Encode a KeyDescriptor to an ANSI byte sequence for PTY input.\n *\n * Delegates to keyToAnsi() for the actual encoding, then converts to bytes.\n * This is the canonical encoder — backends that don't have their own\n * protocol (e.g., kitty keyboard) should use this.\n */\nexport function encodeKeyToAnsi(key: KeyDescriptor): Uint8Array {\n  const ansi = keyToAnsi(key)\n  return encoder.encode(ansi)\n}\n","/**\n * Rust vt100 backend for termless.\n *\n * Wraps the doy/vt100-rust crate via napi-rs native bindings to implement\n * the TerminalBackend interface -- same VT parser used by many Rust terminal\n * projects, but headless via native Node addon.\n *\n * Requires the native module to be built first:\n *   cd packages/vt100-rust/native && cargo build --release\n *   cp target/release/libtermless_vt100_rust_native.dylib ../termless-vt100-rust.node\n *\n * TODO: Set up @napi-rs/cli build pipeline for cross-platform prebuilds.\n */\n\nimport type {\n  TerminalBackend,\n  TerminalOptions,\n  Cell,\n  CursorState,\n  TerminalMode,\n  ScrollbackState,\n  TerminalCapabilities,\n  RGB,\n} from \"../../../src/terminal/types.ts\"\nimport { encodeKeyToAnsi } from \"../../../src/terminal/key-encoding.ts\"\n\n// ===============================================================\n// Native module loading\n// ===============================================================\n\ninterface NapiCell {\n  text: string\n  fgR: number\n  fgG: number\n  fgB: number\n  fgIsDefault: boolean\n  bgR: number\n  bgG: number\n  bgB: number\n  bgIsDefault: boolean\n  bold: boolean\n  faint: boolean\n  italic: boolean\n  underline: string\n  strikethrough: boolean\n  inverse: boolean\n  wide: boolean\n}\n\ninterface NapiCursor {\n  x: number\n  y: number\n  visible: boolean\n  style: string\n}\n\ninterface NapiScrollback {\n  viewportOffset: number\n  totalLines: number\n  screenLines: number\n}\n\ninterface Vt100RustTerminal {\n  feed(data: Buffer): void\n  resize(cols: number, rows: number): void\n  reset(): void\n  getText(): string\n  getTextRange(startRow: number, startCol: number, endRow: number, endCol: number): string\n  getCell(row: number, col: number): NapiCell\n  getLine(row: number): NapiCell[]\n  getCursor(): NapiCursor\n  getMode(mode: string): boolean\n  getTitle(): string\n  getScrollback(): NapiScrollback\n  scrollViewport(delta: number): void\n  /** Read pending response data (DA1/DA2/DSR). Returns null if no responses pending or method not available. */\n  readResponse?(): Buffer | null\n}\n\ninterface NativeModule {\n  Vt100RustTerminal: new (cols: number, rows: number, scrollbackLimit?: number) => Vt100RustTerminal\n}\n\nlet nativeModule: NativeModule | null = null\nlet loadError: Error | null = null\n\n/**\n * Load the native vt100-rust module. Call once before creating backends.\n * Returns the native module, or throws if the .node file is missing.\n */\nexport function loadVt100RustNative(): NativeModule {\n  if (nativeModule) return nativeModule\n  if (loadError) throw loadError\n\n  try {\n    // Try loading the prebuilt native addon\n    // The .node file should be at packages/vt100-rust/termless-vt100-rust.node\n    const mod = require(\"../termless-vt100-rust.node\") as NativeModule\n    nativeModule = mod\n    return mod\n  } catch (e) {\n    loadError = new Error(\n      \"Failed to load vt100-rust native module. Build it first:\\n\" +\n        \"  cd packages/vt100-rust/native && cargo build --release\\n\" +\n        \"  cp target/release/libtermless_vt100_rust_native.dylib ../termless-vt100-rust.node\\n\" +\n        `\\nOriginal error: ${e instanceof Error ? e.message : String(e)}`,\n    )\n    throw loadError\n  }\n}\n\n// ===============================================================\n// Cell conversion\n// ===============================================================\n\nfunction convertNapiCell(cell: NapiCell): Cell {\n  const fg: RGB | null = cell.fgIsDefault ? null : { r: cell.fgR, g: cell.fgG, b: cell.fgB }\n  const bg: RGB | null = cell.bgIsDefault ? null : { r: cell.bgR, g: cell.bgG, b: cell.bgB }\n\n  return {\n    char: cell.text,\n    fg,\n    bg,\n    bold: cell.bold,\n    dim: cell.faint,\n    italic: cell.italic,\n    underline: cell.underline === \"none\" ? false : (cell.underline as Cell[\"underline\"]),\n    underlineColor: null,\n    strikethrough: cell.strikethrough,\n    inverse: cell.inverse,\n    blink: false,\n    hidden: false,\n    wide: cell.wide,\n    continuation: false,\n    hyperlink: null,\n  }\n}\n\nconst EMPTY_CELL: Cell = {\n  char: \"\",\n  fg: null,\n  bg: null,\n  bold: false,\n  dim: false,\n  italic: false,\n  underline: false,\n  underlineColor: null,\n  strikethrough: false,\n  inverse: false,\n  blink: false,\n  hidden: false,\n  wide: false,\n  continuation: false,\n  hyperlink: null,\n}\n\n// ===============================================================\n// Backend factory\n// ===============================================================\n\nconst DEFAULT_COLS = 80\nconst DEFAULT_ROWS = 24\n\n/**\n * Create a vt100-rust backend for termless.\n *\n * Uses the doy/vt100-rust crate via napi-rs for headless terminal emulation.\n * The native module must be built and available before calling this function.\n *\n * @param opts - Optional terminal dimensions for eager initialization\n * @param native - Optional pre-loaded native module (for test isolation)\n */\nexport function createVt100RustBackend(opts?: Partial<TerminalOptions>, native?: NativeModule): TerminalBackend {\n  let term: Vt100RustTerminal | null = null\n  let nativeMod: NativeModule | null = native ?? null\n  let cols = DEFAULT_COLS\n  let rows = DEFAULT_ROWS\n\n  function ensureNative(): NativeModule {\n    if (!nativeMod) {\n      nativeMod = loadVt100RustNative()\n    }\n    return nativeMod\n  }\n\n  function ensureTerm(): Vt100RustTerminal {\n    if (!term) throw new Error(\"vt100-rust backend not initialized -- call init() first\")\n    return term\n  }\n\n  function init(options: TerminalOptions): void {\n    const mod = ensureNative()\n\n    cols = options.cols\n    rows = options.rows\n\n    term = new mod.Vt100RustTerminal(cols, rows, options.scrollbackLimit ?? 1000)\n  }\n\n  // Eagerly init if opts provided\n  if (opts) {\n    init({\n      cols: opts.cols ?? DEFAULT_COLS,\n      rows: opts.rows ?? DEFAULT_ROWS,\n      scrollbackLimit: opts.scrollbackLimit,\n    })\n  }\n\n  function destroy(): void {\n    term = null\n  }\n\n  /**\n   * Standard cell metrics used for synthetic CSI 14t / 18t window-op\n   * responses. The vt100-rust backend (doy/vt100 crate via napi-rs)\n   * exposes only a cell grid — there's no native window-pixel concept,\n   * so we synthesize 14t/18t from `rows × cols × typical cell metrics`.\n   * silvery's `resolveMouseOption()` divides pixel coords by cell metrics\n   * to recover cell coords for SGR-Pixels (1016) mouse hit-testing.\n   * 8 × 17 is the typical Iosevka/JetBrains Mono cell at 12pt 96 DPI —\n   * what matters is the ratio matches the backend's cell grid\n   * (one cell = one cell, invariant).\n   */\n  const CELL_W_PX = 8\n  const CELL_H_PX = 17\n\n  // CSI 14t = text-area pixel-size query; reply CSI 4;h;w t\n  // CSI 18t = text-area cell-size query; reply CSI 8;h;w t\n  const CSI_14t_RE = /\\x1b\\[14t/g\n  const CSI_18t_RE = /\\x1b\\[18t/g\n\n  function feed(data: Uint8Array): void {\n    const t = ensureTerm()\n    t.feed(Buffer.from(data))\n\n    // Drain DA1/DA2/DSR responses and forward to the terminal layer\n    if (backend.onResponse && t.readResponse) {\n      const response = t.readResponse()\n      if (response && response.length > 0) {\n        backend.onResponse(new Uint8Array(response))\n      }\n    }\n\n    // Synthesize CSI 14t / 18t window-op probe responses from our\n    // tracked cell grid (doy/vt100 has no window-pixel concept).\n    if (backend.onResponse) {\n      const text = new TextDecoder().decode(data)\n      CSI_14t_RE.lastIndex = 0\n      let m: RegExpExecArray | null\n      while ((m = CSI_14t_RE.exec(text)) !== null) {\n        const heightPx = rows * CELL_H_PX\n        const widthPx = cols * CELL_W_PX\n        backend.onResponse(new TextEncoder().encode(`\\x1b[4;${heightPx};${widthPx}t`))\n      }\n      CSI_18t_RE.lastIndex = 0\n      while ((m = CSI_18t_RE.exec(text)) !== null) {\n        backend.onResponse(new TextEncoder().encode(`\\x1b[8;${rows};${cols}t`))\n      }\n    }\n  }\n\n  function resize(newCols: number, newRows: number): void {\n    const t = ensureTerm()\n    t.resize(newCols, newRows)\n    cols = newCols\n    rows = newRows\n  }\n\n  function reset(): void {\n    ensureTerm().reset()\n  }\n\n  function getText(): string {\n    return ensureTerm().getText()\n  }\n\n  function getTextRange(startRow: number, startCol: number, endRow: number, endCol: number): string {\n    return ensureTerm().getTextRange(startRow, startCol, endRow, endCol)\n  }\n\n  function getCell(row: number, col: number): Cell {\n    const t = ensureTerm()\n    const napiCell = t.getCell(row, col)\n    return convertNapiCell(napiCell)\n  }\n\n  function getLine(row: number): Cell[] {\n    const t = ensureTerm()\n    const napiCells = t.getLine(row)\n    return napiCells.map(convertNapiCell)\n  }\n\n  function getLines(): Cell[][] {\n    const result: Cell[][] = []\n    for (let row = 0; row < rows; row++) {\n      result.push(getLine(row))\n    }\n    return result\n  }\n\n  function getCursor(): CursorState {\n    const t = ensureTerm()\n    const cursor = t.getCursor()\n    return {\n      col: cursor.x,\n      row: cursor.y,\n      x: cursor.x,\n      y: cursor.y,\n      visible: cursor.visible,\n      style: (cursor.style as CursorState[\"style\"]) ?? \"block\",\n    }\n  }\n\n  function getMode(mode: TerminalMode): boolean {\n    return ensureTerm().getMode(mode)\n  }\n\n  function getTitle(): string {\n    return ensureTerm().getTitle()\n  }\n\n  function getScrollback(): ScrollbackState {\n    const t = ensureTerm()\n    const sb = t.getScrollback()\n    return {\n      viewportTop: sb.viewportOffset,\n      totalRows: sb.totalLines,\n      screenRows: sb.screenLines,\n      viewportOffset: sb.viewportOffset,\n      totalLines: sb.totalLines,\n      screenLines: sb.screenLines,\n    }\n  }\n\n  function scrollViewport(delta: number): void {\n    ensureTerm().scrollViewport(delta)\n  }\n\n  const capabilities: TerminalCapabilities = {\n    name: \"vt100-rust\",\n    version: \"0.1.0\",\n    truecolor: true,\n    kittyKeyboard: false,\n    kittyGraphics: false,\n    sixel: false,\n    osc8Hyperlinks: false,\n    semanticPrompts: false,\n    unicode: \"13.0\",\n    reflow: false,\n    extensions: new Set(),\n  }\n\n  // TODO(native): Wire DA1/DA2/DSR response capture in lib.rs.\n  // The doy/vt100 crate doesn't generate terminal responses (DA1/DA2/DSR).\n  // It's a pure VT parser without a response generation mechanism.\n  // If the crate adds response support in the future, steps would be:\n  //   1. Capture output from the parser into a buffer\n  //   2. Add #[napi] pub fn read_response(&self) -> Option<Buffer> that drains it\n  // The TS side is already wired — it calls readResponse() after each feed().\n\n  const backend: TerminalBackend = {\n    name: \"vt100-rust\",\n    init,\n    destroy,\n    feed,\n    resize,\n    reset,\n    getText,\n    getTextRange,\n    getCell,\n    getLine,\n    getLines,\n    getRow: getLine,\n    getRows: getLines,\n    getCursor,\n    getMode,\n    getTitle,\n    getScrollback,\n    scrollViewport,\n    encodeKey: encodeKeyToAnsi,\n    capabilities,\n  }\n\n  return backend\n}\n","export { createVt100RustBackend, loadVt100RustNative } from \"./backend.ts\"\n\nimport { createVt100RustBackend } from \"./backend.ts\"\nimport type { TerminalBackend, TerminalOptions } from \"../../../src/terminal/types.ts\"\n\n/** Resolve this backend for the registry. Loads native Rust bindings. */\nexport async function resolve(opts?: Partial<TerminalOptions>): Promise<TerminalBackend> {\n  return createVt100RustBackend(opts)\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/terminal/key-mapping.ts","../../../src/terminal/key-encoding.ts","../../../src/load-native.ts","../src/backend.ts","../src/index.ts"],"sourcesContent":["/**\n * Key parsing and ANSI encoding for termless.\n *\n * Converts human-readable key descriptions (e.g., \"Ctrl+a\", \"ArrowUp\", \"F5\")\n * into KeyDescriptor objects and ANSI escape sequences suitable for PTY input.\n */\n\nimport type { KeyDescriptor } from \"./types.ts\"\n\n// ── Named key → ANSI sequence map ──\n\nconst KEY_MAP: Record<string, string | null> = {\n  ArrowUp: \"\\x1b[A\",\n  ArrowDown: \"\\x1b[B\",\n  ArrowLeft: \"\\x1b[D\",\n  ArrowRight: \"\\x1b[C\",\n  Home: \"\\x1b[H\",\n  End: \"\\x1b[F\",\n  PageUp: \"\\x1b[5~\",\n  PageDown: \"\\x1b[6~\",\n  Enter: \"\\r\",\n  Tab: \"\\t\",\n  Backspace: \"\\x7f\",\n  Delete: \"\\x1b[3~\",\n  Escape: \"\\x1b\",\n  Space: \" \",\n  // Pure modifier keys produce no output on their own\n  Control: null,\n  Shift: null,\n  Alt: null,\n  Meta: null,\n}\n\n// ── Function keys F1-F12 ──\n\nconst FKEY_MAP: Record<string, string> = {\n  F1: \"\\x1bOP\",\n  F2: \"\\x1bOQ\",\n  F3: \"\\x1bOR\",\n  F4: \"\\x1bOS\",\n  F5: \"\\x1b[15~\",\n  F6: \"\\x1b[17~\",\n  F7: \"\\x1b[18~\",\n  F8: \"\\x1b[19~\",\n  F9: \"\\x1b[20~\",\n  F10: \"\\x1b[21~\",\n  F11: \"\\x1b[23~\",\n  F12: \"\\x1b[24~\",\n}\n\n// ── Modifier aliases ──\n\nconst MODIFIER_ALIASES: Record<string, string> = {\n  ctrl: \"ctrl\",\n  control: \"ctrl\",\n  shift: \"shift\",\n  alt: \"alt\",\n  meta: \"super\",\n  cmd: \"super\",\n  option: \"alt\",\n  super: \"super\",\n}\n\nfunction normalizeModifier(mod: string): string {\n  return MODIFIER_ALIASES[mod.toLowerCase()] ?? mod.toLowerCase()\n}\n\n/**\n * Parse a key string like \"Ctrl+a\", \"ArrowUp\", \"Shift+Tab\" into a KeyDescriptor.\n *\n * Supports modifier prefixes: Ctrl, Control, Alt, Shift, Meta, Cmd, Option, Super.\n * Modifiers are case-insensitive and separated by \"+\".\n */\nexport function parseKey(key: string): KeyDescriptor {\n  const parts = key.split(\"+\")\n  const mainKey = parts.pop()!\n  const result: KeyDescriptor = { key: mainKey }\n\n  for (const part of parts) {\n    const normalized = normalizeModifier(part)\n    switch (normalized) {\n      case \"ctrl\":\n        result.ctrl = true\n        break\n      case \"shift\":\n        result.shift = true\n        break\n      case \"alt\":\n        result.alt = true\n        break\n      case \"super\":\n        result.super = true\n        break\n    }\n  }\n\n  return result\n}\n\n/**\n * Convert a key descriptor or key string to its ANSI escape sequence.\n *\n * Handles:\n * - Single characters: returned as-is\n * - Named keys (ArrowUp, Enter, Tab, etc.): mapped to standard ANSI sequences\n * - Function keys (F1-F12): mapped to VT220/xterm sequences\n * - Ctrl+letter: ASCII control codes 1-26\n * - Ctrl+Enter: newline (\\n)\n * - Alt+key: ESC prefix + key\n */\nexport function keyToAnsi(key: KeyDescriptor | string): string {\n  const desc = typeof key === \"string\" ? parseKey(key) : key\n  const { key: mainKey, ctrl, alt, shift } = desc\n  const hasSuperOrMeta = desc.super\n\n  // Ctrl+letter -> control code (ASCII 1-26)\n  if (ctrl && mainKey.length === 1) {\n    const code = mainKey.toLowerCase().charCodeAt(0) - 96\n    if (code >= 1 && code <= 26) return String.fromCharCode(code)\n  }\n\n  // Ctrl+Enter -> \\n (legacy terminal convention: \\r = Enter, \\n = Ctrl+Enter/Ctrl+J)\n  if (ctrl && mainKey === \"Enter\") {\n    return \"\\n\"\n  }\n\n  // Alt (or Super/Meta) + single character -> ESC prefix\n  if ((alt || hasSuperOrMeta) && mainKey.length === 1) {\n    return `\\x1b${mainKey}`\n  }\n\n  // Function keys\n  const fkey = FKEY_MAP[mainKey]\n  if (fkey !== undefined) {\n    // With modifiers, use CSI sequences with modifier parameter\n    if (ctrl || alt || shift || hasSuperOrMeta) {\n      const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0)\n      // F1-F4 use SS3 format, convert to CSI for modified keys\n      const fkeyNum = parseInt(mainKey.slice(1))\n      if (fkeyNum <= 4) {\n        // F1=11, F2=12, F3=13, F4=14 in CSI ~ format\n        const csiNum = fkeyNum + 10\n        return `\\x1b[${csiNum};${mod}~`\n      }\n      // F5-F12 already use CSI ~ format: extract the number\n      const match = fkey.match(/\\x1b\\[(\\d+)~/)\n      if (match) {\n        return `\\x1b[${match[1]};${mod}~`\n      }\n    }\n    return fkey\n  }\n\n  // Named keys from KEY_MAP\n  const mapped = KEY_MAP[mainKey]\n  if (mapped !== undefined) {\n    if (mapped === null) return \"\" // Pure modifier keys produce nothing\n\n    // Arrow/navigation keys with modifiers use CSI 1;mod format\n    if ((ctrl || alt || shift || hasSuperOrMeta) && mapped.startsWith(\"\\x1b[\")) {\n      const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0)\n      // CSI letter format (e.g., \\x1b[A) -> CSI 1;mod letter\n      const letterMatch = mapped.match(/\\x1b\\[([A-H])$/)\n      if (letterMatch) {\n        return `\\x1b[1;${mod}${letterMatch[1]}`\n      }\n      // CSI num ~ format (e.g., \\x1b[5~) -> CSI num;mod ~\n      const tildeMatch = mapped.match(/\\x1b\\[(\\d+)~$/)\n      if (tildeMatch) {\n        return `\\x1b[${tildeMatch[1]};${mod}~`\n      }\n    }\n\n    // Shift+Tab -> reverse tab (CSI Z)\n    if (shift && mainKey === \"Tab\") {\n      return \"\\x1b[Z\"\n    }\n\n    return mapped\n  }\n\n  // Single character without modifiers\n  if (mainKey.length === 1) {\n    // Shift+letter -> uppercase (passthrough for terminals)\n    if (shift && mainKey.match(/[a-z]/)) {\n      return mainKey.toUpperCase()\n    }\n    return mainKey\n  }\n\n  // Unknown key: return as-is\n  return mainKey\n}\n","/**\n * Shared ANSI key encoding for terminal backends.\n *\n * All backends need to convert KeyDescriptor → Uint8Array for PTY input.\n * This module delegates to keyToAnsi() as the single source of truth for\n * ANSI key encoding, converting the string result to bytes.\n */\n\nimport type { KeyDescriptor } from \"./types.ts\"\nimport { keyToAnsi } from \"./key-mapping.ts\"\n\n// Module-level TextEncoder for efficiency (avoids per-call allocation)\nconst encoder = new TextEncoder()\n\n/**\n * Encode a KeyDescriptor to an ANSI byte sequence for PTY input.\n *\n * Delegates to keyToAnsi() for the actual encoding, then converts to bytes.\n * This is the canonical encoder — backends that don't have their own\n * protocol (e.g., kitty keyboard) should use this.\n */\nexport function encodeKeyToAnsi(key: KeyDescriptor): Uint8Array {\n  const ansi = keyToAnsi(key)\n  return encoder.encode(ansi)\n}\n","/**\n * The single native / CommonJS-addon load seam for @termless/core.\n *\n * `createRequire` is kept here DELIBERATELY — these are the cases the\n * ESM-only migration cannot convert, centralized so the package has exactly ONE\n * createRequire site (this file, the sole @termless/core entry on\n * check-no-createrequire.sh):\n *\n *  1. `loadNodePty()` — node-pty is a SYNCHRONOUS CommonJS native addon.\n *     `spawnPortablePty()` is a sync API, so the load must be sync; `await\n *     import()` is not an option and node-pty is not a node builtin (so\n *     `process.getBuiltinModule` doesn't apply either).\n *\n *  2. `loadNativeAddon()` — tries caller-relative native candidates in order,\n *     retaining each loader error for an actionable failure.\n *\n *  3. `resolveOptionalAsset()` — resolves an optional asset/module PATH (e.g.\n *     `@twemoji/svg/<key>.svg`) via Node resolution. The ESM equivalent\n *     `import.meta.resolve()` throws \"not supported\" under vitest's module\n *     runner — the environment these render paths are exercised in — so\n *     `require.resolve` is the only portable synchronous path resolver.\n *\n * Bead: createrequire-ban (wave 3 — native-loader centralization).\n */\nimport { createRequire } from \"node:module\"\n\nconst nativeRequire = createRequire(import.meta.url)\n\n/** Load a native addon from caller-relative candidates without static `.node` imports. */\nexport function loadNativeAddon<T>(options: {\n  callerUrl: string\n  packageName: string\n  candidates: readonly string[]\n  prebuiltScope: string\n}): T {\n  const requireFromCaller = createRequire(options.callerUrl)\n  const errors: string[] = []\n  for (const candidate of options.candidates) {\n    try {\n      return requireFromCaller(candidate) as T\n    } catch (error) {\n      errors.push(`  - ${candidate}: ${error instanceof Error ? error.message : String(error)}`)\n    }\n  }\n  throw new Error(\n    `Failed to load ${options.packageName} native module on ${process.platform}/${process.arch}.\\n` +\n      `Prebuilt scope: ${options.prebuiltScope}\\n` +\n      `Tried:\\n${options.candidates.map((candidate) => `  - ${candidate}`).join(\"\\n\")}\\n` +\n      `Load attempts:\\n${errors.join(\"\\n\")}`,\n  )\n}\n\n/** Minimal interface matching what we use from node-pty's IPty. */\nexport interface NodePtyInstance {\n  write(data: string): void\n  resize(cols: number, rows: number): void\n  kill(signal?: string): void\n  destroy(): void\n  onData: (callback: (data: string) => void) => { dispose(): void }\n  onExit: (callback: (e: { exitCode: number; signal?: number }) => void) => { dispose(): void }\n  pid: number\n}\n\n/** Minimal interface for the node-pty module. */\nexport interface NodePtyModule {\n  spawn(\n    file: string,\n    args: string[],\n    options: {\n      name?: string\n      cols: number\n      rows: number\n      cwd?: string\n      env?: Record<string, string>\n    },\n  ): NodePtyInstance\n}\n\n/**\n * Load node-pty synchronously. node-pty is a CommonJS native addon, so\n * createRequire is the correct way to load it from ESM and keep\n * `spawnPortablePty()` synchronous. Throws a clear, actionable error when the\n * optional peer is not installed.\n */\nexport function loadNodePty(): NodePtyModule {\n  try {\n    return nativeRequire(\"node-pty\") as NodePtyModule\n  } catch {\n    throw new Error(\n      \"node-pty is required for PTY support on Node.js but was not found.\\n\" +\n        \"Install it with: npm install node-pty\\n\" +\n        \"Note: node-pty requires native compilation tools (Python, C++ compiler).\",\n    )\n  }\n}\n\n/**\n * Resolve an optional asset/module path via Node resolution\n * (`require.resolve`). Throws when the specifier is not installed — callers\n * catch to soft-fall-back (e.g. Twemoji asset → font rendering).\n */\nexport function resolveOptionalAsset(specifier: string): string {\n  return nativeRequire.resolve(specifier)\n}\n","/**\n * Rust vt100 backend for termless.\n *\n * Wraps the doy/vt100-rust crate via napi-rs native bindings to implement\n * the TerminalBackend interface -- same VT parser used by many Rust terminal\n * projects, but headless via native Node addon.\n *\n * The prebuilt target is Linux x64 glibc.\n */\n\nimport type {\n  TerminalBackend,\n  TerminalOptions,\n  Cell,\n  Cursor,\n  TerminalMode,\n  ScrollbackState,\n  TerminalCapabilities,\n  Color,\n} from \"../../../src/terminal/types.ts\"\nimport { encodeKeyToAnsi } from \"../../../src/terminal/key-encoding.ts\"\nimport { loadNativeAddon } from \"../../../src/load-native.ts\"\n\n// ===============================================================\n// Native module loading\n// ===============================================================\n\ninterface NapiCell {\n  text: string\n  fgR: number\n  fgG: number\n  fgB: number\n  fgIsDefault: boolean\n  bgR: number\n  bgG: number\n  bgB: number\n  bgIsDefault: boolean\n  bold: boolean\n  faint: boolean\n  italic: boolean\n  underline: string\n  strikethrough: boolean\n  inverse: boolean\n  wide: boolean\n}\n\ninterface NapiCursor {\n  x: number\n  y: number\n  visible: boolean\n  style: string\n}\n\ninterface NapiScrollback {\n  viewportOffset: number\n  totalLines: number\n  screenLines: number\n}\n\ninterface Vt100RustTerminal {\n  feed(data: Buffer): void\n  resize(cols: number, rows: number): void\n  reset(): void\n  getText(): string\n  getTextRange(startRow: number, startCol: number, endRow: number, endCol: number): string\n  getCell(row: number, col: number): NapiCell\n  getLine(row: number): NapiCell[]\n  getCursor(): NapiCursor\n  getMode(mode: string): boolean\n  getTitle(): string\n  getScrollback(): NapiScrollback\n  scrollViewport(delta: number): void\n  /** Read pending response data (DA1/DA2/DSR). Returns null if no responses pending or method not available. */\n  readResponse?(): Buffer | null\n}\n\ninterface NativeModule {\n  Vt100RustTerminal: new (cols: number, rows: number, scrollbackLimit?: number) => Vt100RustTerminal\n}\n\nlet nativeModule: NativeModule | null = null\nlet loadError: Error | null = null\n\n/**\n * Load the native vt100-rust module. Call once before creating backends.\n * Returns the native module, or throws if the .node file is missing.\n */\nexport function loadVt100RustNative(): NativeModule {\n  if (nativeModule) return nativeModule\n  if (loadError) throw loadError\n\n  try {\n    nativeModule = loadNativeAddon<NativeModule>({\n      callerUrl: import.meta.url,\n      packageName: \"@termless/vt100-rust\",\n      candidates: [\"../termless-vt100-rust.node\"],\n      prebuiltScope: \"linux-x64-glibc only\",\n    })\n    return nativeModule\n  } catch (error) {\n    loadError = error as Error\n    throw loadError\n  }\n}\n\n// ===============================================================\n// Cell conversion\n// ===============================================================\n\nfunction convertNapiCell(cell: NapiCell): Cell {\n  const fg: Color | null = cell.fgIsDefault ? null : { r: cell.fgR, g: cell.fgG, b: cell.fgB }\n  const bg: Color | null = cell.bgIsDefault ? null : { r: cell.bgR, g: cell.bgG, b: cell.bgB }\n\n  return {\n    char: cell.text,\n    fg,\n    bg,\n    bold: cell.bold,\n    dim: cell.faint,\n    italic: cell.italic,\n    underline: cell.underline === \"none\" ? false : (cell.underline as Cell[\"underline\"]),\n    underlineColor: null,\n    strikethrough: cell.strikethrough,\n    inverse: cell.inverse,\n    blink: false,\n    hidden: false,\n    wide: cell.wide,\n    continuation: false,\n    hyperlink: null,\n  }\n}\n\nconst EMPTY_CELL: Cell = {\n  char: \"\",\n  fg: null,\n  bg: null,\n  bold: false,\n  dim: false,\n  italic: false,\n  underline: false,\n  underlineColor: null,\n  strikethrough: false,\n  inverse: false,\n  blink: false,\n  hidden: false,\n  wide: false,\n  continuation: false,\n  hyperlink: null,\n}\n\n// ===============================================================\n// Backend factory\n// ===============================================================\n\nconst DEFAULT_COLS = 80\nconst DEFAULT_ROWS = 24\n\n/**\n * Create a vt100-rust backend for termless.\n *\n * Uses the doy/vt100-rust crate via napi-rs for headless terminal emulation.\n * The native module must be built and available before calling this function.\n *\n * @param opts - Optional terminal dimensions for eager initialization\n * @param native - Optional pre-loaded native module (for test isolation)\n */\nexport function createVt100RustBackend(opts?: Partial<TerminalOptions>, native?: NativeModule): TerminalBackend {\n  let term: Vt100RustTerminal | null = null\n  let nativeMod: NativeModule | null = native ?? null\n  let cols = DEFAULT_COLS\n  let rows = DEFAULT_ROWS\n\n  function ensureNative(): NativeModule {\n    if (!nativeMod) {\n      nativeMod = loadVt100RustNative()\n    }\n    return nativeMod\n  }\n\n  function ensureTerm(): Vt100RustTerminal {\n    if (!term) throw new Error(\"vt100-rust backend not initialized -- call init() first\")\n    return term\n  }\n\n  function init(options: TerminalOptions): void {\n    const mod = ensureNative()\n\n    cols = options.cols\n    rows = options.rows\n\n    term = new mod.Vt100RustTerminal(cols, rows, options.scrollbackLimit ?? 1000)\n  }\n\n  // Eagerly init if opts provided\n  if (opts) {\n    init({\n      cols: opts.cols ?? DEFAULT_COLS,\n      rows: opts.rows ?? DEFAULT_ROWS,\n      scrollbackLimit: opts.scrollbackLimit,\n    })\n  }\n\n  function destroy(): void {\n    term = null\n  }\n\n  /**\n   * Standard cell metrics used for synthetic CSI 14t / 18t window-op\n   * responses. The vt100-rust backend (doy/vt100 crate via napi-rs)\n   * exposes only a cell grid — there's no native window-pixel concept,\n   * so we synthesize 14t/18t from `rows × cols × typical cell metrics`.\n   * silvery's `resolveMouseOption()` divides pixel coords by cell metrics\n   * to recover cell coords for SGR-Pixels (1016) mouse hit-testing.\n   * 8 × 17 is the typical Iosevka/JetBrains Mono cell at 12pt 96 DPI —\n   * what matters is the ratio matches the backend's cell grid\n   * (one cell = one cell, invariant).\n   */\n  const CELL_W_PX = 8\n  const CELL_H_PX = 17\n\n  // CSI 14t = text-area pixel-size query; reply CSI 4;h;w t\n  // CSI 18t = text-area cell-size query; reply CSI 8;h;w t\n  const CSI_14t_RE = /\\x1b\\[14t/g\n  const CSI_18t_RE = /\\x1b\\[18t/g\n\n  function feed(data: Uint8Array): void {\n    const t = ensureTerm()\n    t.feed(Buffer.from(data))\n\n    // Drain DA1/DA2/DSR responses and forward to the terminal layer\n    if (backend.onResponse && t.readResponse) {\n      const response = t.readResponse()\n      if (response && response.length > 0) {\n        backend.onResponse(new Uint8Array(response))\n      }\n    }\n\n    // Synthesize CSI 14t / 18t window-op probe responses from our\n    // tracked cell grid (doy/vt100 has no window-pixel concept).\n    if (backend.onResponse) {\n      const text = new TextDecoder().decode(data)\n      CSI_14t_RE.lastIndex = 0\n      let m: RegExpExecArray | null\n      while ((m = CSI_14t_RE.exec(text)) !== null) {\n        const heightPx = rows * CELL_H_PX\n        const widthPx = cols * CELL_W_PX\n        backend.onResponse(new TextEncoder().encode(`\\x1b[4;${heightPx};${widthPx}t`))\n      }\n      CSI_18t_RE.lastIndex = 0\n      while ((m = CSI_18t_RE.exec(text)) !== null) {\n        backend.onResponse(new TextEncoder().encode(`\\x1b[8;${rows};${cols}t`))\n      }\n    }\n  }\n\n  function resize(newCols: number, newRows: number): void {\n    const t = ensureTerm()\n    t.resize(newCols, newRows)\n    cols = newCols\n    rows = newRows\n  }\n\n  function reset(): void {\n    ensureTerm().reset()\n  }\n\n  function getText(): string {\n    return ensureTerm().getText()\n  }\n\n  function getTextRange(startRow: number, startCol: number, endRow: number, endCol: number): string {\n    return ensureTerm().getTextRange(startRow, startCol, endRow, endCol)\n  }\n\n  function getCell(row: number, col: number): Cell {\n    const t = ensureTerm()\n    const napiCell = t.getCell(row, col)\n    return convertNapiCell(napiCell)\n  }\n\n  function getLine(row: number): Cell[] {\n    const t = ensureTerm()\n    const napiCells = t.getLine(row)\n    return napiCells.map(convertNapiCell)\n  }\n\n  function getLines(): Cell[][] {\n    const result: Cell[][] = []\n    for (let row = 0; row < rows; row++) {\n      result.push(getLine(row))\n    }\n    return result\n  }\n\n  function getCursor(): Cursor {\n    const t = ensureTerm()\n    const cursor = t.getCursor()\n    return {\n      col: cursor.x,\n      row: cursor.y,\n      x: cursor.x,\n      y: cursor.y,\n      visible: cursor.visible,\n      style: (cursor.style as Cursor[\"style\"]) ?? \"block\",\n    }\n  }\n\n  function getMode(mode: TerminalMode): boolean {\n    return ensureTerm().getMode(mode)\n  }\n\n  function getTitle(): string {\n    return ensureTerm().getTitle()\n  }\n\n  function getScrollback(): ScrollbackState {\n    const t = ensureTerm()\n    const sb = t.getScrollback()\n    return {\n      viewportTop: sb.viewportOffset,\n      totalRows: sb.totalLines,\n      screenRows: sb.screenLines,\n      viewportOffset: sb.viewportOffset,\n      totalLines: sb.totalLines,\n      screenLines: sb.screenLines,\n    }\n  }\n\n  function scrollViewport(delta: number): void {\n    ensureTerm().scrollViewport(delta)\n  }\n\n  const capabilities: TerminalCapabilities = {\n    name: \"vt100-rust\",\n    version: \"0.16.2\",\n    truecolor: true,\n    kittyKeyboard: false,\n    kittyGraphics: false,\n    sixel: false,\n    osc8Hyperlinks: false,\n    semanticPrompts: false,\n    unicode: \"13.0\",\n    reflow: false,\n    extensions: new Set(),\n  }\n\n  // TODO(native): Wire DA1/DA2/DSR response capture in lib.rs.\n  // The doy/vt100 crate doesn't generate terminal responses (DA1/DA2/DSR).\n  // It's a pure VT parser without a response generation mechanism.\n  // If the crate adds response support in the future, steps would be:\n  //   1. Capture output from the parser into a buffer\n  //   2. Add #[napi] pub fn read_response(&self) -> Option<Buffer> that drains it\n  // The TS side is already wired — it calls readResponse() after each feed().\n\n  const backend: TerminalBackend = {\n    name: \"vt100-rust\",\n    init,\n    destroy,\n    feed,\n    resize,\n    reset,\n    getText,\n    getTextRange,\n    getCell,\n    getLine,\n    getLines,\n    getRow: getLine,\n    getRows: getLines,\n    getCursor,\n    getMode,\n    getTitle,\n    getScrollback,\n    scrollViewport,\n    encodeKey: encodeKeyToAnsi,\n    capabilities,\n  }\n\n  return backend\n}\n","export { createVt100RustBackend, loadVt100RustNative } from \"./backend.ts\"\n\nimport { createVt100RustBackend } from \"./backend.ts\"\nimport type { TerminalBackend, TerminalOptions } from \"../../../src/terminal/types.ts\"\n\n/** Resolve this backend for the registry. Loads native Rust bindings. */\nexport async function resolve(opts?: Partial<TerminalOptions>): Promise<TerminalBackend> {\n  return createVt100RustBackend(opts)\n}\n"],"mappings":";;AAWA,MAAM,UAAyC;CAC7C,SAAS;CACT,WAAW;CACX,WAAW;CACX,YAAY;CACZ,MAAM;CACN,KAAK;CACL,QAAQ;CACR,UAAU;CACV,OAAO;CACP,KAAK;CACL,WAAW;CACX,QAAQ;CACR,QAAQ;CACR,OAAO;CAEP,SAAS;CACT,OAAO;CACP,KAAK;CACL,MAAM;AACR;AAIA,MAAM,WAAmC;CACvC,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,KAAK;CACL,KAAK;CACL,KAAK;AACP;AAIA,MAAM,mBAA2C;CAC/C,MAAM;CACN,SAAS;CACT,OAAO;CACP,KAAK;CACL,MAAM;CACN,KAAK;CACL,QAAQ;CACR,OAAO;AACT;AAEA,SAAS,kBAAkB,KAAqB;CAC9C,OAAO,iBAAiB,IAAI,YAAY,MAAM,IAAI,YAAY;AAChE;;;;;;;AAQA,SAAgB,SAAS,KAA4B;CACnD,MAAM,QAAQ,IAAI,MAAM,GAAG;CAE3B,MAAM,SAAwB,EAAE,KADhB,MAAM,IACqB,EAAE;CAE7C,KAAK,MAAM,QAAQ,OAEjB,QADmB,kBAAkB,IACpB,GAAjB;EACE,KAAK;GACH,OAAO,OAAO;GACd;EACF,KAAK;GACH,OAAO,QAAQ;GACf;EACF,KAAK;GACH,OAAO,MAAM;GACb;EACF,KAAK,SACH,OAAO,QAAQ;CAEnB;CAGF,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,UAAU,KAAqC;CAC7D,MAAM,OAAO,OAAO,QAAQ,WAAW,SAAS,GAAG,IAAI;CACvD,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,UAAU;CAC3C,MAAM,iBAAiB,KAAK;CAG5B,IAAI,QAAQ,QAAQ,WAAW,GAAG;EAChC,MAAM,OAAO,QAAQ,YAAY,CAAC,CAAC,WAAW,CAAC,IAAI;EACnD,IAAI,QAAQ,KAAK,QAAQ,IAAI,OAAO,OAAO,aAAa,IAAI;CAC9D;CAGA,IAAI,QAAQ,YAAY,SACtB,OAAO;CAIT,KAAK,OAAO,mBAAmB,QAAQ,WAAW,GAChD,OAAO,OAAO;CAIhB,MAAM,OAAO,SAAS;CACtB,IAAI,SAAS,KAAA,GAAW;EAEtB,IAAI,QAAQ,OAAO,SAAS,gBAAgB;GAC1C,MAAM,MAAM,KAAK,QAAQ,IAAI,MAAM,MAAM,IAAI,MAAM,OAAO,IAAI,MAAM,iBAAiB,IAAI;GAEzF,MAAM,UAAU,SAAS,QAAQ,MAAM,CAAC,CAAC;GACzC,IAAI,WAAW,GAGb,OAAO,QADQ,UAAU,GACH,GAAG,IAAI;GAG/B,MAAM,QAAQ,KAAK,MAAM,cAAc;GACvC,IAAI,OACF,OAAO,QAAQ,MAAM,GAAG,GAAG,IAAI;EAEnC;EACA,OAAO;CACT;CAGA,MAAM,SAAS,QAAQ;CACvB,IAAI,WAAW,KAAA,GAAW;EACxB,IAAI,WAAW,MAAM,OAAO;EAG5B,KAAK,QAAQ,OAAO,SAAS,mBAAmB,OAAO,WAAW,OAAO,GAAG;GAC1E,MAAM,MAAM,KAAK,QAAQ,IAAI,MAAM,MAAM,IAAI,MAAM,OAAO,IAAI,MAAM,iBAAiB,IAAI;GAEzF,MAAM,cAAc,OAAO,MAAM,gBAAgB;GACjD,IAAI,aACF,OAAO,UAAU,MAAM,YAAY;GAGrC,MAAM,aAAa,OAAO,MAAM,eAAe;GAC/C,IAAI,YACF,OAAO,QAAQ,WAAW,GAAG,GAAG,IAAI;EAExC;EAGA,IAAI,SAAS,YAAY,OACvB,OAAO;EAGT,OAAO;CACT;CAGA,IAAI,QAAQ,WAAW,GAAG;EAExB,IAAI,SAAS,QAAQ,MAAM,OAAO,GAChC,OAAO,QAAQ,YAAY;EAE7B,OAAO;CACT;CAGA,OAAO;AACT;;;ACpLA,MAAM,UAAU,IAAI,YAAY;;;;;;;;AAShC,SAAgB,gBAAgB,KAAgC;CAC9D,MAAM,OAAO,UAAU,GAAG;CAC1B,OAAO,QAAQ,OAAO,IAAI;AAC5B;ACEsB,cAAc,YAAY,GAAG;;AAGnD,SAAgB,gBAAmB,SAK7B;CACJ,MAAM,oBAAoB,cAAc,QAAQ,SAAS;CACzD,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,aAAa,QAAQ,YAC9B,IAAI;EACF,OAAO,kBAAkB,SAAS;CACpC,SAAS,OAAO;EACd,OAAO,KAAK,OAAO,UAAU,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;CAC3F;CAEF,MAAM,IAAI,MACR,kBAAkB,QAAQ,YAAY,oBAAoB,QAAQ,SAAS,GAAG,QAAQ,KAAK,qBACtE,QAAQ,cAAc,YAC9B,QAAQ,WAAW,KAAK,cAAc,OAAO,WAAW,CAAC,CAAC,KAAK,IAAI,EAAE,oBAC7D,OAAO,KAAK,IAAI,GACvC;AACF;;;AC8BA,IAAI,eAAoC;AACxC,IAAI,YAA0B;;;;;AAM9B,SAAgB,sBAAoC;CAClD,IAAI,cAAc,OAAO;CACzB,IAAI,WAAW,MAAM;CAErB,IAAI;EACF,eAAe,gBAA8B;GAC3C,WAAW,YAAY;GACvB,aAAa;GACb,YAAY,CAAC,6BAA6B;GAC1C,eAAe;EACjB,CAAC;EACD,OAAO;CACT,SAAS,OAAO;EACd,YAAY;EACZ,MAAM;CACR;AACF;AAMA,SAAS,gBAAgB,MAAsB;CAC7C,MAAM,KAAmB,KAAK,cAAc,OAAO;EAAE,GAAG,KAAK;EAAK,GAAG,KAAK;EAAK,GAAG,KAAK;CAAI;CAC3F,MAAM,KAAmB,KAAK,cAAc,OAAO;EAAE,GAAG,KAAK;EAAK,GAAG,KAAK;EAAK,GAAG,KAAK;CAAI;CAE3F,OAAO;EACL,MAAM,KAAK;EACX;EACA;EACA,MAAM,KAAK;EACX,KAAK,KAAK;EACV,QAAQ,KAAK;EACb,WAAW,KAAK,cAAc,SAAS,QAAS,KAAK;EACrD,gBAAgB;EAChB,eAAe,KAAK;EACpB,SAAS,KAAK;EACd,OAAO;EACP,QAAQ;EACR,MAAM,KAAK;EACX,cAAc;EACd,WAAW;CACb;AACF;AAwBA,MAAM,eAAe;AACrB,MAAM,eAAe;;;;;;;;;;AAWrB,SAAgB,uBAAuB,MAAiC,QAAwC;CAC9G,IAAI,OAAiC;CACrC,IAAI,YAAiC,UAAU;CAC/C,IAAI,OAAO;CACX,IAAI,OAAO;CAEX,SAAS,eAA6B;EACpC,IAAI,CAAC,WACH,YAAY,oBAAoB;EAElC,OAAO;CACT;CAEA,SAAS,aAAgC;EACvC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,yDAAyD;EACpF,OAAO;CACT;CAEA,SAAS,KAAK,SAAgC;EAC5C,MAAM,MAAM,aAAa;EAEzB,OAAO,QAAQ;EACf,OAAO,QAAQ;EAEf,OAAO,IAAI,IAAI,kBAAkB,MAAM,MAAM,QAAQ,mBAAmB,GAAI;CAC9E;CAGA,IAAI,MACF,KAAK;EACH,MAAM,KAAK,QAAQ;EACnB,MAAM,KAAK,QAAQ;EACnB,iBAAiB,KAAK;CACxB,CAAC;CAGH,SAAS,UAAgB;EACvB,OAAO;CACT;;;;;;;;;;;;CAaA,MAAM,YAAY;CAClB,MAAM,YAAY;CAIlB,MAAM,aAAa;CACnB,MAAM,aAAa;CAEnB,SAAS,KAAK,MAAwB;EACpC,MAAM,IAAI,WAAW;EACrB,EAAE,KAAK,OAAO,KAAK,IAAI,CAAC;EAGxB,IAAI,QAAQ,cAAc,EAAE,cAAc;GACxC,MAAM,WAAW,EAAE,aAAa;GAChC,IAAI,YAAY,SAAS,SAAS,GAChC,QAAQ,WAAW,IAAI,WAAW,QAAQ,CAAC;EAE/C;EAIA,IAAI,QAAQ,YAAY;GACtB,MAAM,OAAO,IAAI,YAAY,CAAC,CAAC,OAAO,IAAI;GAC1C,WAAW,YAAY;GAEvB,OAAY,WAAW,KAAK,IAAI,MAAO,MAAM;IAC3C,MAAM,WAAW,OAAO;IACxB,MAAM,UAAU,OAAO;IACvB,QAAQ,WAAW,IAAI,YAAY,CAAC,CAAC,OAAO,UAAU,SAAS,GAAG,QAAQ,EAAE,CAAC;GAC/E;GACA,WAAW,YAAY;GACvB,OAAY,WAAW,KAAK,IAAI,MAAO,MACrC,QAAQ,WAAW,IAAI,YAAY,CAAC,CAAC,OAAO,UAAU,KAAK,GAAG,KAAK,EAAE,CAAC;EAE1E;CACF;CAEA,SAAS,OAAO,SAAiB,SAAuB;EAEtD,WAAA,CAAC,CAAC,OAAO,SAAS,OAAO;EACzB,OAAO;EACP,OAAO;CACT;CAEA,SAAS,QAAc;EACrB,WAAW,CAAC,CAAC,MAAM;CACrB;CAEA,SAAS,UAAkB;EACzB,OAAO,WAAW,CAAC,CAAC,QAAQ;CAC9B;CAEA,SAAS,aAAa,UAAkB,UAAkB,QAAgB,QAAwB;EAChG,OAAO,WAAW,CAAC,CAAC,aAAa,UAAU,UAAU,QAAQ,MAAM;CACrE;CAEA,SAAS,QAAQ,KAAa,KAAmB;EAG/C,OAAO,gBAFG,WACO,CAAC,CAAC,QAAQ,KAAK,GACF,CAAC;CACjC;CAEA,SAAS,QAAQ,KAAqB;EAGpC,OAFU,WACQ,CAAC,CAAC,QAAQ,GACb,CAAC,CAAC,IAAI,eAAe;CACtC;CAEA,SAAS,WAAqB;EAC5B,MAAM,SAAmB,CAAC;EAC1B,KAAK,IAAI,MAAM,GAAG,MAAM,MAAM,OAC5B,OAAO,KAAK,QAAQ,GAAG,CAAC;EAE1B,OAAO;CACT;CAEA,SAAS,YAAoB;EAE3B,MAAM,SADI,WACK,CAAC,CAAC,UAAU;EAC3B,OAAO;GACL,KAAK,OAAO;GACZ,KAAK,OAAO;GACZ,GAAG,OAAO;GACV,GAAG,OAAO;GACV,SAAS,OAAO;GAChB,OAAQ,OAAO,SAA6B;EAC9C;CACF;CAEA,SAAS,QAAQ,MAA6B;EAC5C,OAAO,WAAW,CAAC,CAAC,QAAQ,IAAI;CAClC;CAEA,SAAS,WAAmB;EAC1B,OAAO,WAAW,CAAC,CAAC,SAAS;CAC/B;CAEA,SAAS,gBAAiC;EAExC,MAAM,KADI,WACC,CAAC,CAAC,cAAc;EAC3B,OAAO;GACL,aAAa,GAAG;GAChB,WAAW,GAAG;GACd,YAAY,GAAG;GACf,gBAAgB,GAAG;GACnB,YAAY,GAAG;GACf,aAAa,GAAG;EAClB;CACF;CAEA,SAAS,eAAe,OAAqB;EAC3C,WAAW,CAAC,CAAC,eAAe,KAAK;CACnC;CAwBA,MAAM,UAA2B;EAC/B,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR,SAAS;EACT;EACA;EACA;EACA;EACA;EACA,WAAW;EACX,cAAA;GAzCA,MAAM;GACN,SAAS;GACT,WAAW;GACX,eAAe;GACf,eAAe;GACf,OAAO;GACP,gBAAgB;GAChB,iBAAiB;GACjB,SAAS;GACT,QAAQ;GACR,4BAAY,IAAI,IAAI;EA+BT;CACb;CAEA,OAAO;AACT;;;;ACpXA,eAAsB,QAAQ,MAA2D;CACvF,OAAO,uBAAuB,IAAI;AACpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termless/vt100-rust",
-  "version": "0.8.4",
+  "version": "0.10.2",
   "description": "Rust vt100 backend for termless — doy/vt100-rust crate via napi-rs for cross-terminal TUI testing",
   "keywords": [
     "headless",
@@ -25,8 +25,7 @@
   },
   "files": [
     "dist",
-    "native",
-    "*.node"
+    "termless-vt100-rust.node"
   ],
   "type": "module",
   "exports": {
@@ -39,7 +38,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@termless/core": "^0.8.1"
+    "@termless/core": "^0.10.2"
   },
   "tsdown": {
     "clean": true,
@@ -53,6 +52,6 @@
   },
   "scripts": {
     "build:native": "cd native && cargo build --release",
-    "postbuild:native": "cp native/target/release/libtermless_vt100_rust_native.dylib termless-vt100-rust.node"
+    "postbuild:native": "bash ../../scripts/copy-native-addon.sh libtermless_vt100_rust_native termless-vt100-rust.node"
   }
 }

package/native/Cargo.toml

@@ -1,16 +0,0 @@
-[package]
-name = "termless-vt100-rust-native"
-version = "0.1.0"
-edition = "2021"
-description = "napi-rs bindings for vt100 Rust crate"
-
-[lib]
-crate-type = ["cdylib"]
-
-[dependencies]
-napi = { version = "3", features = ["napi8"] }
-napi-derive = "3"
-vt100 = "0.15"
-
-[build-dependencies]
-napi-build = "2"

package/native/build.rs

@@ -1,5 +0,0 @@
-extern crate napi_build;
-
-fn main() {
-    napi_build::setup();
-}

package/native/src/lib.rs

@@ -1,427 +0,0 @@
-use napi::bindgen_prelude::*;
-use napi_derive::napi;
-use std::sync::Mutex;
-
-// ===============================================================
-// Standard 256-color palette (indices 0..=255) → RGB
-// ===============================================================
-
-/// Convert a 256-color palette index to (r, g, b).
-fn palette_index_to_rgb(idx: u8) -> (u8, u8, u8) {
-    match idx {
-        // Standard 16 colors (ANSI)
-        0 => (0, 0, 0),
-        1 => (128, 0, 0),
-        2 => (0, 128, 0),
-        3 => (128, 128, 0),
-        4 => (0, 0, 128),
-        5 => (128, 0, 128),
-        6 => (0, 128, 128),
-        7 => (192, 192, 192),
-        8 => (128, 128, 128),
-        9 => (255, 0, 0),
-        10 => (0, 255, 0),
-        11 => (255, 255, 0),
-        12 => (0, 0, 255),
-        13 => (255, 0, 255),
-        14 => (0, 255, 255),
-        15 => (255, 255, 255),
-        // 6x6x6 color cube (indices 16..=231)
-        16..=231 => {
-            let n = idx - 16;
-            let b = n % 6;
-            let g = (n / 6) % 6;
-            let r = n / 36;
-            let to_val = |c: u8| if c == 0 { 0u8 } else { 55 + 40 * c };
-            (to_val(r), to_val(g), to_val(b))
-        }
-        // Grayscale ramp (indices 232..=255)
-        232..=255 => {
-            let v = 8 + 10 * (idx - 232);
-            (v, v, v)
-        }
-    }
-}
-
-// ===============================================================
-// Exported cell type
-// ===============================================================
-
-#[napi(object)]
-pub struct NapiCell {
-    pub text: String,
-    pub fg_r: u8,
-    pub fg_g: u8,
-    pub fg_b: u8,
-    pub fg_is_default: bool,
-    pub bg_r: u8,
-    pub bg_g: u8,
-    pub bg_b: u8,
-    pub bg_is_default: bool,
-    pub bold: bool,
-    pub faint: bool,
-    pub italic: bool,
-    pub underline: String,
-    pub strikethrough: bool,
-    pub inverse: bool,
-    pub wide: bool,
-}
-
-#[napi(object)]
-pub struct NapiCursor {
-    pub x: u32,
-    pub y: u32,
-    pub visible: bool,
-    pub style: String,
-}
-
-#[napi(object)]
-pub struct NapiScrollback {
-    pub viewport_offset: i32,
-    pub total_lines: u32,
-    pub screen_lines: u32,
-}
-
-// ===============================================================
-// Terminal wrapper
-// ===============================================================
-
-#[napi]
-pub struct Vt100RustTerminal {
-    parser: Mutex<vt100::Parser>,
-    cols: u16,
-    rows: u16,
-    title: Mutex<String>,
-}
-
-#[napi]
-impl Vt100RustTerminal {
-    #[napi(constructor)]
-    pub fn new(cols: u32, rows: u32, scrollback_limit: Option<u32>) -> Self {
-        let scrollback = scrollback_limit.unwrap_or(1000) as usize;
-        let r = rows as u16;
-        let c = cols as u16;
-
-        let parser = vt100::Parser::new(r, c, scrollback);
-
-        Vt100RustTerminal {
-            parser: Mutex::new(parser),
-            cols: c,
-            rows: r,
-            title: Mutex::new(String::new()),
-        }
-    }
-
-    #[napi]
-    pub fn feed(&self, data: Buffer) -> Result<()> {
-        let mut parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        parser.process(data.as_ref());
-        // Capture title from terminal state
-        let title = parser.screen().title().to_string();
-        let mut t = self.title.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock title: {}", e))
-        })?;
-        *t = title;
-        Ok(())
-    }
-
-    #[napi]
-    pub fn resize(&self, cols: u32, rows: u32) -> Result<()> {
-        let mut parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        parser.set_size(rows as u16, cols as u16);
-        Ok(())
-    }
-
-    #[napi]
-    pub fn reset(&self) -> Result<()> {
-        let mut parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        // Feed RIS escape sequence to reset
-        parser.process(b"\x1bc");
-        let mut t = self.title.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock title: {}", e))
-        })?;
-        t.clear();
-        Ok(())
-    }
-
-    #[napi]
-    pub fn get_text(&self) -> Result<String> {
-        let parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        let screen = parser.screen();
-        let mut lines = Vec::new();
-
-        // Scrollback lines
-        let scrollback_len = screen.scrollback();
-        for row_offset in 0..scrollback_len {
-            // Scrollback rows are indexed negatively from the top of the screen
-            let neg_row = -(scrollback_len as i32) + row_offset as i32;
-            let row_idx = neg_row as i32;
-            let mut line = String::new();
-            for col in 0..self.cols {
-                if let Some(cell) = screen.cell(row_idx as u16, col) {
-                    let contents = cell.contents();
-                    if contents.is_empty() {
-                        line.push(' ');
-                    } else {
-                        line.push_str(&contents);
-                    }
-                } else {
-                    line.push(' ');
-                }
-            }
-            lines.push(line.trim_end().to_string());
-        }
-
-        // Visible screen lines
-        for row in 0..self.rows {
-            let mut line = String::new();
-            for col in 0..self.cols {
-                if let Some(cell) = screen.cell(row, col) {
-                    let contents = cell.contents();
-                    if contents.is_empty() {
-                        line.push(' ');
-                    } else {
-                        line.push_str(&contents);
-                    }
-                } else {
-                    line.push(' ');
-                }
-            }
-            lines.push(line.trim_end().to_string());
-        }
-
-        Ok(lines.join("\n"))
-    }
-
-    #[napi]
-    pub fn get_text_range(
-        &self,
-        start_row: i32,
-        start_col: i32,
-        end_row: i32,
-        end_col: i32,
-    ) -> Result<String> {
-        let parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        let screen = parser.screen();
-        let mut parts = Vec::new();
-
-        for row in start_row..=end_row {
-            if row < 0 || row >= self.rows as i32 {
-                continue;
-            }
-            let col_start = if row == start_row {
-                start_col as u16
-            } else {
-                0
-            };
-            let col_end = if row == end_row {
-                end_col as u16
-            } else {
-                self.cols
-            };
-
-            let mut text = String::new();
-            for col in col_start..col_end.min(self.cols) {
-                if let Some(cell) = screen.cell(row as u16, col) {
-                    let contents = cell.contents();
-                    if contents.is_empty() {
-                        text.push(' ');
-                    } else {
-                        text.push_str(&contents);
-                    }
-                } else {
-                    text.push(' ');
-                }
-            }
-            parts.push(text.trim_end().to_string());
-        }
-
-        Ok(parts.join("\n"))
-    }
-
-    #[napi]
-    pub fn get_cell(&self, row: i32, col: i32) -> Result<NapiCell> {
-        let parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        let screen = parser.screen();
-
-        if row < 0 || row >= self.rows as i32 || col < 0 || col >= self.cols as i32 {
-            return Ok(empty_cell());
-        }
-
-        match screen.cell(row as u16, col as u16) {
-            Some(cell) => Ok(convert_cell(cell)),
-            None => Ok(empty_cell()),
-        }
-    }
-
-    #[napi]
-    pub fn get_line(&self, row: i32) -> Result<Vec<NapiCell>> {
-        let parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        let screen = parser.screen();
-
-        if row < 0 || row >= self.rows as i32 {
-            return Ok((0..self.cols).map(|_| empty_cell()).collect());
-        }
-
-        Ok((0..self.cols)
-            .map(|col| match screen.cell(row as u16, col) {
-                Some(cell) => convert_cell(cell),
-                None => empty_cell(),
-            })
-            .collect())
-    }
-
-    #[napi]
-    pub fn get_cursor(&self) -> Result<NapiCursor> {
-        let parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        let screen = parser.screen();
-        let (row, col) = screen.cursor_position();
-
-        Ok(NapiCursor {
-            x: col as u32,
-            y: row as u32,
-            visible: !screen.hide_cursor(),
-            style: "block".to_string(),
-        })
-    }
-
-    #[napi]
-    pub fn get_mode(&self, mode: String) -> Result<bool> {
-        let parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        let screen = parser.screen();
-
-        Ok(match mode.as_str() {
-            "altScreen" => screen.alternate_screen(),
-            "cursorVisible" => !screen.hide_cursor(),
-            "bracketedPaste" => screen.bracketed_paste(),
-            "applicationCursor" => screen.application_cursor(),
-            "applicationKeypad" => screen.application_keypad(),
-            "mouseTracking" => screen.mouse_protocol_mode() != vt100::MouseProtocolMode::None,
-            // Modes not directly exposed by the vt100 crate
-            "autoWrap" => true,  // Default on, not queryable
-            "focusTracking" => false,
-            "originMode" => false,
-            "insertMode" => false,
-            "reverseVideo" => false,
-            _ => false,
-        })
-    }
-
-    #[napi]
-    pub fn get_title(&self) -> Result<String> {
-        let t = self.title.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock title: {}", e))
-        })?;
-        Ok(t.clone())
-    }
-
-    #[napi]
-    pub fn get_scrollback(&self) -> Result<NapiScrollback> {
-        let parser = self.parser.lock().map_err(|e| {
-            Error::from_reason(format!("Failed to lock parser: {}", e))
-        })?;
-        let screen = parser.screen();
-        let scrollback_len = screen.scrollback() as u32;
-
-        Ok(NapiScrollback {
-            viewport_offset: 0, // Headless mode, no viewport scroll state
-            total_lines: scrollback_len + self.rows as u32,
-            screen_lines: self.rows as u32,
-        })
-    }
-
-    #[napi]
-    pub fn scroll_viewport(&self, _delta: i32) -> Result<()> {
-        // No-op in headless mode — no viewport scroll position to track
-        Ok(())
-    }
-}
-
-// ===============================================================
-// Helpers
-// ===============================================================
-
-fn empty_cell() -> NapiCell {
-    NapiCell {
-        text: String::new(),
-        fg_r: 0,
-        fg_g: 0,
-        fg_b: 0,
-        fg_is_default: true,
-        bg_r: 0,
-        bg_g: 0,
-        bg_b: 0,
-        bg_is_default: true,
-        bold: false,
-        faint: false,
-        italic: false,
-        underline: "none".to_string(),
-        strikethrough: false,
-        inverse: false,
-        wide: false,
-    }
-}
-
-fn convert_cell(cell: &vt100::Cell) -> NapiCell {
-    let text = cell.contents();
-
-    // Extract foreground color
-    let (fg_r, fg_g, fg_b, fg_is_default) = match cell.fgcolor() {
-        vt100::Color::Default => (0, 0, 0, true),
-        vt100::Color::Rgb(r, g, b) => (r, g, b, false),
-        vt100::Color::Idx(idx) => {
-            let (r, g, b) = palette_index_to_rgb(idx);
-            (r, g, b, false)
-        }
-    };
-
-    // Extract background color
-    let (bg_r, bg_g, bg_b, bg_is_default) = match cell.bgcolor() {
-        vt100::Color::Default => (0, 0, 0, true),
-        vt100::Color::Rgb(r, g, b) => (r, g, b, false),
-        vt100::Color::Idx(idx) => {
-            let (r, g, b) = palette_index_to_rgb(idx);
-            (r, g, b, false)
-        }
-    };
-
-    // Underline style — the vt100 crate only has on/off
-    let underline = if cell.underline() { "single" } else { "none" };
-
-    NapiCell {
-        text: text.to_string(),
-        fg_r,
-        fg_g,
-        fg_b,
-        fg_is_default,
-        bg_r,
-        bg_g,
-        bg_b,
-        bg_is_default,
-        bold: cell.bold(),
-        faint: false, // vt100 crate doesn't expose faint/dim
-        italic: cell.italic(),
-        underline: underline.to_string(),
-        strikethrough: false, // vt100 crate doesn't expose strikethrough
-        inverse: cell.inverse(),
-        wide: cell.is_wide(),
-    }
-}