@visulima/ansi 1.0.18 → 1.1.0

package/dist/packem_shared/ITerm2File-BGPqNSjB.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const node_buffer = require('node:buffer');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const formatITerm2FileProperties = /* @__PURE__ */ __name((properties) => {
+  const options = [];
+  if (properties.name) {
+    options.push(`name=${properties.name}`);
+  }
+  if (properties.size !== void 0) {
+    options.push(`size=${properties.size}`);
+  }
+  if (properties.width !== void 0) {
+    options.push(`width=${properties.width.toString()}`);
+  }
+  if (properties.height !== void 0) {
+    options.push(`height=${properties.height.toString()}`);
+  }
+  if (properties.ignoreAspectRatio) {
+    options.push("preserveAspectRatio=0");
+  }
+  if (properties.inline) {
+    options.push("inline=1");
+  }
+  if (properties.doNotMoveCursor) {
+    options.push("doNotMoveCursor=1");
+  }
+  return options.join(";");
+}, "formatITerm2FileProperties");
+class ITerm2File {
+  static {
+    __name(this, "ITerm2File");
+  }
+  fileProps;
+  /**
+   * Constructs an `ITerm2File` payload object.
+   * @param properties An object containing properties for the file/image, as defined by {@link ITerm2FileProps}.
+   * The `name` property within `props` should be pre-Base64 encoded by the caller if it might
+   * contain special characters (like `;`, `=`, or non-ASCII characters).
+   * If `fileData` is provided, `props.content` will be overridden, and `props.size` will be
+   * set from `fileData.byteLength` if not already present in `props`.
+   * @param fileData (Optional) A `Uint8Array` containing the raw file data. If provided, this data will be
+   * Base64 encoded and used as the `content` of the file transfer. The `size` property
+   * will also be automatically set from `fileData.byteLength` if not specified in `props`.
+   */
+  constructor(properties, fileData) {
+    this.fileProps = { ...properties };
+    if (fileData) {
+      if (fileData.byteLength > 10 * 1024 * 1024) {
+        throw new Error("File size exceeds maximum limit of 10MB");
+      }
+      this.fileProps.content = node_buffer.Buffer.from(fileData).toString("base64");
+      if (this.fileProps.size === void 0) {
+        this.fileProps.size = fileData.byteLength;
+      }
+      if (this.fileProps.size !== fileData.byteLength) {
+        throw new Error("File size property doesn't match actual data length");
+      }
+    }
+  }
+  /**
+   * Converts the file properties and its content (if any) into the string payload
+   * suitable for the iTerm2 `File=` command.
+   * @returns The string payload (e.g., `"File=name=...;size=...:BASE64_CONTENT"` or `"File=name=...;size=..."`).
+   */
+  toString() {
+    let s = "File=";
+    s += formatITerm2FileProperties(this.fileProps);
+    if (this.fileProps.content !== void 0) {
+      s += `:${this.fileProps.content}`;
+    }
+    return s;
+  }
+}
+class ITerm2FileEnd {
+  static {
+    __name(this, "ITerm2FileEnd");
+  }
+  /**
+   * Generates the string payload for the iTerm2 `FileEnd` command.
+   * @returns The string `"FileEnd"`.
+   */
+  // eslint-disable-next-line class-methods-use-this
+  toString() {
+    return "FileEnd";
+  }
+}
+class ITerm2FilePart {
+  /**
+   * Constructs an `ITerm2FilePart` payload object.
+   * @param base64Chunk A string containing a Base64 encoded chunk of the file data.
+   * The caller is responsible for chunking the file and Base64 encoding each chunk.
+   */
+  constructor(base64Chunk) {
+    this.base64Chunk = base64Chunk;
+  }
+  static {
+    __name(this, "ITerm2FilePart");
+  }
+  /**
+   * Converts the Base64 encoded chunk into the string payload suitable for the iTerm2 `FilePart=` command.
+   * @returns The string payload (e.g., `"FilePart=U09NRURBVEE="`).
+   */
+  toString() {
+    return `FilePart=${this.base64Chunk}`;
+  }
+}
+class ITerm2MultipartFileStart {
+  /**
+   * Constructs an `ITerm2MultipartFileStart` payload object.
+   * @param properties Properties for the multipart file (e.g., `name`, `size`). Content is not part of this command.
+   * The `name` property within `props` should be pre-Base64 encoded by the caller if it might
+   * contain special characters.
+   */
+  constructor(properties) {
+    this.properties = properties;
+  }
+  static {
+    __name(this, "ITerm2MultipartFileStart");
+  }
+  /**
+   * Converts the file properties into the string payload suitable for the iTerm2 `MultipartFile=` command.
+   * @returns The string payload (e.g., `"MultipartFile=name=...;size=..."`).
+   */
+  toString() {
+    return `MultipartFile=${formatITerm2FileProperties(this.properties)}`;
+  }
+}
+
+exports.ITerm2File = ITerm2File;
+exports.ITerm2FileEnd = ITerm2FileEnd;
+exports.ITerm2FilePart = ITerm2FilePart;
+exports.ITerm2MultipartFileStart = ITerm2MultipartFileStart;

package/dist/packem_shared/ITerm2File-DKFkdqdA.mjs

@@ -0,0 +1,130 @@
+import { Buffer } from 'node:buffer';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const formatITerm2FileProperties = /* @__PURE__ */ __name((properties) => {
+  const options = [];
+  if (properties.name) {
+    options.push(`name=${properties.name}`);
+  }
+  if (properties.size !== void 0) {
+    options.push(`size=${properties.size}`);
+  }
+  if (properties.width !== void 0) {
+    options.push(`width=${properties.width.toString()}`);
+  }
+  if (properties.height !== void 0) {
+    options.push(`height=${properties.height.toString()}`);
+  }
+  if (properties.ignoreAspectRatio) {
+    options.push("preserveAspectRatio=0");
+  }
+  if (properties.inline) {
+    options.push("inline=1");
+  }
+  if (properties.doNotMoveCursor) {
+    options.push("doNotMoveCursor=1");
+  }
+  return options.join(";");
+}, "formatITerm2FileProperties");
+class ITerm2File {
+  static {
+    __name(this, "ITerm2File");
+  }
+  fileProps;
+  /**
+   * Constructs an `ITerm2File` payload object.
+   * @param properties An object containing properties for the file/image, as defined by {@link ITerm2FileProps}.
+   * The `name` property within `props` should be pre-Base64 encoded by the caller if it might
+   * contain special characters (like `;`, `=`, or non-ASCII characters).
+   * If `fileData` is provided, `props.content` will be overridden, and `props.size` will be
+   * set from `fileData.byteLength` if not already present in `props`.
+   * @param fileData (Optional) A `Uint8Array` containing the raw file data. If provided, this data will be
+   * Base64 encoded and used as the `content` of the file transfer. The `size` property
+   * will also be automatically set from `fileData.byteLength` if not specified in `props`.
+   */
+  constructor(properties, fileData) {
+    this.fileProps = { ...properties };
+    if (fileData) {
+      if (fileData.byteLength > 10 * 1024 * 1024) {
+        throw new Error("File size exceeds maximum limit of 10MB");
+      }
+      this.fileProps.content = Buffer.from(fileData).toString("base64");
+      if (this.fileProps.size === void 0) {
+        this.fileProps.size = fileData.byteLength;
+      }
+      if (this.fileProps.size !== fileData.byteLength) {
+        throw new Error("File size property doesn't match actual data length");
+      }
+    }
+  }
+  /**
+   * Converts the file properties and its content (if any) into the string payload
+   * suitable for the iTerm2 `File=` command.
+   * @returns The string payload (e.g., `"File=name=...;size=...:BASE64_CONTENT"` or `"File=name=...;size=..."`).
+   */
+  toString() {
+    let s = "File=";
+    s += formatITerm2FileProperties(this.fileProps);
+    if (this.fileProps.content !== void 0) {
+      s += `:${this.fileProps.content}`;
+    }
+    return s;
+  }
+}
+class ITerm2FileEnd {
+  static {
+    __name(this, "ITerm2FileEnd");
+  }
+  /**
+   * Generates the string payload for the iTerm2 `FileEnd` command.
+   * @returns The string `"FileEnd"`.
+   */
+  // eslint-disable-next-line class-methods-use-this
+  toString() {
+    return "FileEnd";
+  }
+}
+class ITerm2FilePart {
+  /**
+   * Constructs an `ITerm2FilePart` payload object.
+   * @param base64Chunk A string containing a Base64 encoded chunk of the file data.
+   * The caller is responsible for chunking the file and Base64 encoding each chunk.
+   */
+  constructor(base64Chunk) {
+    this.base64Chunk = base64Chunk;
+  }
+  static {
+    __name(this, "ITerm2FilePart");
+  }
+  /**
+   * Converts the Base64 encoded chunk into the string payload suitable for the iTerm2 `FilePart=` command.
+   * @returns The string payload (e.g., `"FilePart=U09NRURBVEE="`).
+   */
+  toString() {
+    return `FilePart=${this.base64Chunk}`;
+  }
+}
+class ITerm2MultipartFileStart {
+  /**
+   * Constructs an `ITerm2MultipartFileStart` payload object.
+   * @param properties Properties for the multipart file (e.g., `name`, `size`). Content is not part of this command.
+   * The `name` property within `props` should be pre-Base64 encoded by the caller if it might
+   * contain special characters.
+   */
+  constructor(properties) {
+    this.properties = properties;
+  }
+  static {
+    __name(this, "ITerm2MultipartFileStart");
+  }
+  /**
+   * Converts the file properties into the string payload suitable for the iTerm2 `MultipartFile=` command.
+   * @returns The string payload (e.g., `"MultipartFile=name=...;size=..."`).
+   */
+  toString() {
+    return `MultipartFile=${formatITerm2FileProperties(this.properties)}`;
+  }
+}
+
+export { ITerm2File, ITerm2FileEnd, ITerm2FilePart, ITerm2MultipartFileStart };

package/dist/packem_shared/{constants-D8u2npjW.cjs → constants-BK26O-46.cjs}

@@ -5,9 +5,13 @@ const CSI = `${ESC}[`;
 const OSC = "\x1B]";
 const BEL = "\x07";
 const SEP = ";";
+const DCS = `${ESC}P`;
+const ST = `${ESC}\\`;
 
 exports.BEL = BEL;
 exports.CSI = CSI;
+exports.DCS = DCS;
 exports.ESC = ESC;
 exports.OSC = OSC;
 exports.SEP = SEP;
+exports.ST = ST;

package/dist/packem_shared/constants-CE7WkXh_.mjs

@@ -0,0 +1,9 @@
+const ESC = "\x1B";
+const CSI = `${ESC}[`;
+const OSC = "\x1B]";
+const BEL = "\x07";
+const SEP = ";";
+const DCS = `${ESC}P`;
+const ST = `${ESC}\\`;
+
+export { BEL as B, CSI as C, DCS as D, ESC as E, OSC as O, SEP as S, ST as a };

package/dist/packem_shared/cursor-CQKLCu7U.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+const constants = require('./constants-BK26O-46.cjs');
+require('./restoreCursor-DC_ZKZwT.cjs');
+
+const isBrowser = globalThis?.window?.document !== void 0;
+const isTerminalApp = !isBrowser && process.env.TERM_PROGRAM === "Apple_Terminal";
+const isWindows = !isBrowser && (process.platform === "win32" || /^(?:msys|cygwin)$/.test(process.env.OSTYPE));
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const SAVE_CURSOR_DEC = `${constants.ESC}7`;
+const RESTORE_CURSOR_DEC = `${constants.ESC}8`;
+const CURSOR_UP_1 = `${constants.CSI}A`;
+const CURSOR_DOWN_1 = `${constants.CSI}B`;
+const CURSOR_FORWARD_1 = `${constants.CSI}C`;
+const CURSOR_BACKWARD_1 = `${constants.CSI}D`;
+const REQUEST_CURSOR_POSITION = `${constants.CSI}6n`;
+const REQUEST_EXTENDED_CURSOR_POSITION = `${constants.CSI}?6n`;
+const cursorBackward = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}D`, "cursorBackward");
+const cursorDown = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}B`, "cursorDown");
+const cursorForward = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}C`, "cursorForward");
+const cursorHide = `${constants.CSI}?25l`;
+const cursorToColumn1 = `${constants.CSI}G`;
+const cursorLeft = /* @__PURE__ */ __name((count = 1) => cursorBackward(count), "cursorLeft");
+const cursorHorizontalAbsolute = /* @__PURE__ */ __name((column = 1) => `${constants.CSI + column}G`, "cursorHorizontalAbsolute");
+const cursorMove = /* @__PURE__ */ __name((x, y) => {
+  let returnValue = "";
+  if (x < 0) {
+    returnValue += `${constants.CSI + -x}D`;
+  } else if (x > 0) {
+    returnValue += `${constants.CSI + x}C`;
+  }
+  if (y < 0) {
+    returnValue += `${constants.CSI + -y}A`;
+  } else if (y > 0) {
+    returnValue += `${constants.CSI + y}B`;
+  }
+  return returnValue;
+}, "cursorMove");
+const cursorNextLine = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}E`, "cursorNextLine");
+const cursorPreviousLine = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}F`, "cursorPreviousLine");
+const cursorRestore = isTerminalApp ? RESTORE_CURSOR_DEC : `${constants.ESC}u`;
+const cursorSave = isTerminalApp ? SAVE_CURSOR_DEC : `${constants.ESC}s`;
+const cursorShow = `${constants.CSI}?25h`;
+const cursorTo = /* @__PURE__ */ __name((x, y) => {
+  if (y === void 0) {
+    return cursorHorizontalAbsolute(x + 1);
+  }
+  return `${constants.CSI + (y + 1) + constants.SEP + (x + 1)}H`;
+}, "cursorTo");
+const cursorPosition = /* @__PURE__ */ __name((row, column) => {
+  if (column === void 0) {
+    return `${constants.CSI + row}H`;
+  }
+  return `${constants.CSI + row + constants.SEP + column}H`;
+}, "cursorPosition");
+const cursorHorizontalForwardTab = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}I`, "cursorHorizontalForwardTab");
+const cursorBackwardTab = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}Z`, "cursorBackwardTab");
+const eraseCharacter = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}X`, "eraseCharacter");
+const cursorVerticalAbsolute = /* @__PURE__ */ __name((row = 1) => `${constants.CSI + row}d`, "cursorVerticalAbsolute");
+const cursorUp = /* @__PURE__ */ __name((count = 1) => `${constants.CSI + count}A`, "cursorUp");
+var CursorStyle = /* @__PURE__ */ ((CursorStyle2) => {
+  CursorStyle2[CursorStyle2["BlinkingBar"] = 5] = "BlinkingBar";
+  CursorStyle2[CursorStyle2["BlinkingBlock"] = 1] = "BlinkingBlock";
+  CursorStyle2[CursorStyle2["BlinkingUnderline"] = 3] = "BlinkingUnderline";
+  CursorStyle2[CursorStyle2["Default"] = 0] = "Default";
+  CursorStyle2[CursorStyle2["SteadyBar"] = 6] = "SteadyBar";
+  CursorStyle2[CursorStyle2["SteadyBlock"] = 2] = "SteadyBlock";
+  CursorStyle2[CursorStyle2["SteadyUnderline"] = 4] = "SteadyUnderline";
+  return CursorStyle2;
+})(CursorStyle || {});
+const setCursorStyle = /* @__PURE__ */ __name((style) => `${constants.CSI + style} q`, "setCursorStyle");
+
+exports.CURSOR_BACKWARD_1 = CURSOR_BACKWARD_1;
+exports.CURSOR_DOWN_1 = CURSOR_DOWN_1;
+exports.CURSOR_FORWARD_1 = CURSOR_FORWARD_1;
+exports.CURSOR_UP_1 = CURSOR_UP_1;
+exports.CursorStyle = CursorStyle;
+exports.REQUEST_CURSOR_POSITION = REQUEST_CURSOR_POSITION;
+exports.REQUEST_EXTENDED_CURSOR_POSITION = REQUEST_EXTENDED_CURSOR_POSITION;
+exports.RESTORE_CURSOR_DEC = RESTORE_CURSOR_DEC;
+exports.SAVE_CURSOR_DEC = SAVE_CURSOR_DEC;
+exports.cursorBackward = cursorBackward;
+exports.cursorBackwardTab = cursorBackwardTab;
+exports.cursorDown = cursorDown;
+exports.cursorForward = cursorForward;
+exports.cursorHide = cursorHide;
+exports.cursorHorizontalAbsolute = cursorHorizontalAbsolute;
+exports.cursorHorizontalForwardTab = cursorHorizontalForwardTab;
+exports.cursorLeft = cursorLeft;
+exports.cursorMove = cursorMove;
+exports.cursorNextLine = cursorNextLine;
+exports.cursorPosition = cursorPosition;
+exports.cursorPreviousLine = cursorPreviousLine;
+exports.cursorRestore = cursorRestore;
+exports.cursorSave = cursorSave;
+exports.cursorShow = cursorShow;
+exports.cursorTo = cursorTo;
+exports.cursorToColumn1 = cursorToColumn1;
+exports.cursorUp = cursorUp;
+exports.cursorVerticalAbsolute = cursorVerticalAbsolute;
+exports.eraseCharacter = eraseCharacter;
+exports.isWindows = isWindows;
+exports.setCursorStyle = setCursorStyle;

package/dist/packem_shared/cursor-DhFQcQ9g.mjs

@@ -0,0 +1,73 @@
+import { C as CSI, E as ESC, S as SEP } from './constants-CE7WkXh_.mjs';
+import './restoreCursor-C6pNB8UY.mjs';
+
+const isBrowser = globalThis?.window?.document !== void 0;
+const isTerminalApp = !isBrowser && process.env.TERM_PROGRAM === "Apple_Terminal";
+const isWindows = !isBrowser && (process.platform === "win32" || /^(?:msys|cygwin)$/.test(process.env.OSTYPE));
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const SAVE_CURSOR_DEC = `${ESC}7`;
+const RESTORE_CURSOR_DEC = `${ESC}8`;
+const CURSOR_UP_1 = `${CSI}A`;
+const CURSOR_DOWN_1 = `${CSI}B`;
+const CURSOR_FORWARD_1 = `${CSI}C`;
+const CURSOR_BACKWARD_1 = `${CSI}D`;
+const REQUEST_CURSOR_POSITION = `${CSI}6n`;
+const REQUEST_EXTENDED_CURSOR_POSITION = `${CSI}?6n`;
+const cursorBackward = /* @__PURE__ */ __name((count = 1) => `${CSI + count}D`, "cursorBackward");
+const cursorDown = /* @__PURE__ */ __name((count = 1) => `${CSI + count}B`, "cursorDown");
+const cursorForward = /* @__PURE__ */ __name((count = 1) => `${CSI + count}C`, "cursorForward");
+const cursorHide = `${CSI}?25l`;
+const cursorToColumn1 = `${CSI}G`;
+const cursorLeft = /* @__PURE__ */ __name((count = 1) => cursorBackward(count), "cursorLeft");
+const cursorHorizontalAbsolute = /* @__PURE__ */ __name((column = 1) => `${CSI + column}G`, "cursorHorizontalAbsolute");
+const cursorMove = /* @__PURE__ */ __name((x, y) => {
+  let returnValue = "";
+  if (x < 0) {
+    returnValue += `${CSI + -x}D`;
+  } else if (x > 0) {
+    returnValue += `${CSI + x}C`;
+  }
+  if (y < 0) {
+    returnValue += `${CSI + -y}A`;
+  } else if (y > 0) {
+    returnValue += `${CSI + y}B`;
+  }
+  return returnValue;
+}, "cursorMove");
+const cursorNextLine = /* @__PURE__ */ __name((count = 1) => `${CSI + count}E`, "cursorNextLine");
+const cursorPreviousLine = /* @__PURE__ */ __name((count = 1) => `${CSI + count}F`, "cursorPreviousLine");
+const cursorRestore = isTerminalApp ? RESTORE_CURSOR_DEC : `${ESC}u`;
+const cursorSave = isTerminalApp ? SAVE_CURSOR_DEC : `${ESC}s`;
+const cursorShow = `${CSI}?25h`;
+const cursorTo = /* @__PURE__ */ __name((x, y) => {
+  if (y === void 0) {
+    return cursorHorizontalAbsolute(x + 1);
+  }
+  return `${CSI + (y + 1) + SEP + (x + 1)}H`;
+}, "cursorTo");
+const cursorPosition = /* @__PURE__ */ __name((row, column) => {
+  if (column === void 0) {
+    return `${CSI + row}H`;
+  }
+  return `${CSI + row + SEP + column}H`;
+}, "cursorPosition");
+const cursorHorizontalForwardTab = /* @__PURE__ */ __name((count = 1) => `${CSI + count}I`, "cursorHorizontalForwardTab");
+const cursorBackwardTab = /* @__PURE__ */ __name((count = 1) => `${CSI + count}Z`, "cursorBackwardTab");
+const eraseCharacter = /* @__PURE__ */ __name((count = 1) => `${CSI + count}X`, "eraseCharacter");
+const cursorVerticalAbsolute = /* @__PURE__ */ __name((row = 1) => `${CSI + row}d`, "cursorVerticalAbsolute");
+const cursorUp = /* @__PURE__ */ __name((count = 1) => `${CSI + count}A`, "cursorUp");
+var CursorStyle = /* @__PURE__ */ ((CursorStyle2) => {
+  CursorStyle2[CursorStyle2["BlinkingBar"] = 5] = "BlinkingBar";
+  CursorStyle2[CursorStyle2["BlinkingBlock"] = 1] = "BlinkingBlock";
+  CursorStyle2[CursorStyle2["BlinkingUnderline"] = 3] = "BlinkingUnderline";
+  CursorStyle2[CursorStyle2["Default"] = 0] = "Default";
+  CursorStyle2[CursorStyle2["SteadyBar"] = 6] = "SteadyBar";
+  CursorStyle2[CursorStyle2["SteadyBlock"] = 2] = "SteadyBlock";
+  CursorStyle2[CursorStyle2["SteadyUnderline"] = 4] = "SteadyUnderline";
+  return CursorStyle2;
+})(CursorStyle || {});
+const setCursorStyle = /* @__PURE__ */ __name((style) => `${CSI + style} q`, "setCursorStyle");
+
+export { isWindows as A, CursorStyle as B, CURSOR_BACKWARD_1 as C, REQUEST_CURSOR_POSITION as R, SAVE_CURSOR_DEC as S, CURSOR_DOWN_1 as a, CURSOR_FORWARD_1 as b, CURSOR_UP_1 as c, cursorBackward as d, cursorBackwardTab as e, cursorDown as f, cursorForward as g, cursorHide as h, cursorHorizontalAbsolute as i, cursorHorizontalForwardTab as j, cursorLeft as k, cursorMove as l, cursorNextLine as m, cursorPosition as n, cursorPreviousLine as o, cursorRestore as p, cursorSave as q, cursorShow as r, cursorTo as s, cursorToColumn1 as t, cursorUp as u, cursorVerticalAbsolute as v, eraseCharacter as w, REQUEST_EXTENDED_CURSOR_POSITION as x, RESTORE_CURSOR_DEC as y, setCursorStyle as z };

package/dist/passthrough.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const constants = require('./packem_shared/constants-BK26O-46.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const SCREEN_MAX_LEN_DEFAULT = 0;
+const SCREEN_TYPICAL_LIMIT = 768;
+const screenPassthrough = /* @__PURE__ */ __name((sequence, limit = SCREEN_MAX_LEN_DEFAULT) => {
+  let result = constants.DCS;
+  if (limit > 0 && sequence.length > limit) {
+    for (let index = 0; index < sequence.length; index += limit) {
+      const end = Math.min(index + limit, sequence.length);
+      result += sequence.slice(index, end);
+      if (end < sequence.length) {
+        result += constants.ST + constants.DCS;
+      }
+    }
+  } else {
+    result += sequence;
+  }
+  result += constants.ST;
+  return result;
+}, "screenPassthrough");
+const tmuxPassthrough = /* @__PURE__ */ __name((sequence) => {
+  let escapedSequence = "";
+  for (const element of sequence) {
+    escapedSequence += element === constants.ESC ? constants.ESC + constants.ESC : element;
+  }
+  return `${constants.DCS}tmux;${escapedSequence}${constants.ST}`;
+}, "tmuxPassthrough");
+
+exports.SCREEN_MAX_LEN_DEFAULT = SCREEN_MAX_LEN_DEFAULT;
+exports.SCREEN_TYPICAL_LIMIT = SCREEN_TYPICAL_LIMIT;
+exports.screenPassthrough = screenPassthrough;
+exports.tmuxPassthrough = tmuxPassthrough;

package/dist/passthrough.d.cts

@@ -0,0 +1,77 @@
+/**
+ * Default value for the `limit` parameter in {@link screenPassthrough}, indicating no chunking.
+ * When this value is used (or any value <= 0), the passthrough sequence is not split into smaller chunks.
+ */
+export declare const SCREEN_MAX_LEN_DEFAULT: number;
+/**
+ * A typical limit for string sequences in GNU Screen (e.g., 768 bytes).
+ * This constant can be used as a practical value for the `limit` parameter in {@link screenPassthrough}
+ * to avoid issues with Screen's internal buffers, though the function itself defaults to no limit.
+ * It's provided for informational purposes and as a suggested practical chunking limit.
+ */
+export declare const SCREEN_TYPICAL_LIMIT: number;
+/**
+ * Wraps a given ANSI escape sequence in a DCS (Device Control String) passthrough sequence
+ * specifically for GNU Screen. This allows raw escape sequences to be sent to the
+ * terminal emulator that is hosting Screen, bypassing Screen's own interpretation.
+ *
+ * The basic format is: `DCS <data> ST` (where `DCS` is `ESC P` and `ST` is `ESC \`).
+ *
+ * GNU Screen has limitations on the length of string sequences it can handle (often around 768 bytes).
+ * This function can optionally chunk the input `sequence` into smaller parts, each wrapped
+ * in its own `DCS...ST` sequence, to work around this limitation.
+ * @param sequence The ANSI escape sequence string to be wrapped.
+ * @param limit The maximum length for each chunk of the `sequence` before it's wrapped.
+ * If `0` or a negative number, the sequence is not chunked. Defaults to {@link SCREEN_MAX_LEN_DEFAULT} (0).
+ * Consider using {@link SCREEN_TYPICAL_LIMIT} (768) for practical chunking with Screen.
+ * @returns The wrapped string, possibly chunked into multiple `DCS...ST` sequences if `limit` is positive and the `sequence` exceeds it.
+ * @see {@link https://www.gnu.org/software/screen/manual/screen.html#String-Escapes} GNU Screen Manual - String Escapes.
+ * @example
+ * ```typescript
+ * import { screenPassthrough, SCREEN_TYPICAL_LIMIT } from \'@visulima/ansi/passthrough\';
+ * import { cursorShow, cursorHide } from \'@visulima/ansi/cursor\';
+ *
+ * const longSequence = cursorHide + "Some very long output..." + cursorShow;
+ *
+ * // No chunking (default behavior if sequence is short enough or limit is 0)
+ * const passthrough1 = screenPassthrough(cursorHide);
+ * console.log(JSON.stringify(passthrough1)); // "\u001bP?25l\u001b\\"
+ *
+ * // With chunking, assuming SCREEN_TYPICAL_LIMIT is small for demonstration
+ * const limitedPassthrough = screenPassthrough(longSequence, 10); // Hypothetical small limit
+ * // Example output if longSequence was "0123456789abcde" and limit 10:
+ * // "\u001bP0123456789\u001b\\\u001bPabcde\u001b\\"
+ * console.log(JSON.stringify(limitedPassthrough));
+ * ```
+ */
+export declare const screenPassthrough: (sequence: string, limit?: number) => string;
+/**
+ * Wraps a given ANSI escape sequence in a special DCS (Device Control String) passthrough sequence
+ * designed for tmux (Terminal Multiplexer). This allows raw escape sequences to be sent to the
+ * terminal emulator hosting tmux, bypassing tmux's own interpretation.
+ *
+ * The format is: `DCS tmux ; <escaped-data> ST`
+ * (where `DCS` is `ESC P`, and `ST` is `ESC \`).
+ *
+ * The `<escaped-data>` is the original `sequence` with all occurrences of the ESC character (`\u001B`)
+ * doubled (i.e., `ESC` becomes `ESC ESC`).
+ *
+ * **Note:** For this to work, the tmux option `allow-passthrough` must be enabled (`on`) in the tmux configuration.
+ * By default, it might be off.
+ * @param sequence The ANSI escape sequence string to be wrapped and properly escaped for tmux.
+ * @returns The wrapped and escaped string suitable for tmux passthrough.
+ * @see {@link https://github.com/tmux/tmux/wiki/FAQ#what-is-the-passthrough-escape-sequence-and-how-do-i-use-it} Tmux FAQ on Passthrough.
+ * @example
+ * ```typescript
+ * import { tmuxPassthrough } from \'@visulima/ansi/passthrough\';
+ * import { cursorShow } from \'@visulima/ansi/cursor\';
+ *
+ * const originalSequence = cursorShow; // e.g., "\u001b[?25h"
+ * const passthrough = tmuxPassthrough(originalSequence);
+ *
+ * // Expected: "\u001bPtmux;\u001b\u001b[?25h\u001b\\"
+ * // (ESC P tmux ; ESC ESC [ ? 2 5 h ESC \)
+ * console.log(JSON.stringify(passthrough));
+ * ```
+ */
+export declare const tmuxPassthrough: (sequence: string) => string;

package/dist/passthrough.d.mts

@@ -0,0 +1,77 @@
+/**
+ * Default value for the `limit` parameter in {@link screenPassthrough}, indicating no chunking.
+ * When this value is used (or any value <= 0), the passthrough sequence is not split into smaller chunks.
+ */
+export declare const SCREEN_MAX_LEN_DEFAULT: number;
+/**
+ * A typical limit for string sequences in GNU Screen (e.g., 768 bytes).
+ * This constant can be used as a practical value for the `limit` parameter in {@link screenPassthrough}
+ * to avoid issues with Screen's internal buffers, though the function itself defaults to no limit.
+ * It's provided for informational purposes and as a suggested practical chunking limit.
+ */
+export declare const SCREEN_TYPICAL_LIMIT: number;
+/**
+ * Wraps a given ANSI escape sequence in a DCS (Device Control String) passthrough sequence
+ * specifically for GNU Screen. This allows raw escape sequences to be sent to the
+ * terminal emulator that is hosting Screen, bypassing Screen's own interpretation.
+ *
+ * The basic format is: `DCS <data> ST` (where `DCS` is `ESC P` and `ST` is `ESC \`).
+ *
+ * GNU Screen has limitations on the length of string sequences it can handle (often around 768 bytes).
+ * This function can optionally chunk the input `sequence` into smaller parts, each wrapped
+ * in its own `DCS...ST` sequence, to work around this limitation.
+ * @param sequence The ANSI escape sequence string to be wrapped.
+ * @param limit The maximum length for each chunk of the `sequence` before it's wrapped.
+ * If `0` or a negative number, the sequence is not chunked. Defaults to {@link SCREEN_MAX_LEN_DEFAULT} (0).
+ * Consider using {@link SCREEN_TYPICAL_LIMIT} (768) for practical chunking with Screen.
+ * @returns The wrapped string, possibly chunked into multiple `DCS...ST` sequences if `limit` is positive and the `sequence` exceeds it.
+ * @see {@link https://www.gnu.org/software/screen/manual/screen.html#String-Escapes} GNU Screen Manual - String Escapes.
+ * @example
+ * ```typescript
+ * import { screenPassthrough, SCREEN_TYPICAL_LIMIT } from \'@visulima/ansi/passthrough\';
+ * import { cursorShow, cursorHide } from \'@visulima/ansi/cursor\';
+ *
+ * const longSequence = cursorHide + "Some very long output..." + cursorShow;
+ *
+ * // No chunking (default behavior if sequence is short enough or limit is 0)
+ * const passthrough1 = screenPassthrough(cursorHide);
+ * console.log(JSON.stringify(passthrough1)); // "\u001bP?25l\u001b\\"
+ *
+ * // With chunking, assuming SCREEN_TYPICAL_LIMIT is small for demonstration
+ * const limitedPassthrough = screenPassthrough(longSequence, 10); // Hypothetical small limit
+ * // Example output if longSequence was "0123456789abcde" and limit 10:
+ * // "\u001bP0123456789\u001b\\\u001bPabcde\u001b\\"
+ * console.log(JSON.stringify(limitedPassthrough));
+ * ```
+ */
+export declare const screenPassthrough: (sequence: string, limit?: number) => string;
+/**
+ * Wraps a given ANSI escape sequence in a special DCS (Device Control String) passthrough sequence
+ * designed for tmux (Terminal Multiplexer). This allows raw escape sequences to be sent to the
+ * terminal emulator hosting tmux, bypassing tmux's own interpretation.
+ *
+ * The format is: `DCS tmux ; <escaped-data> ST`
+ * (where `DCS` is `ESC P`, and `ST` is `ESC \`).
+ *
+ * The `<escaped-data>` is the original `sequence` with all occurrences of the ESC character (`\u001B`)
+ * doubled (i.e., `ESC` becomes `ESC ESC`).
+ *
+ * **Note:** For this to work, the tmux option `allow-passthrough` must be enabled (`on`) in the tmux configuration.
+ * By default, it might be off.
+ * @param sequence The ANSI escape sequence string to be wrapped and properly escaped for tmux.
+ * @returns The wrapped and escaped string suitable for tmux passthrough.
+ * @see {@link https://github.com/tmux/tmux/wiki/FAQ#what-is-the-passthrough-escape-sequence-and-how-do-i-use-it} Tmux FAQ on Passthrough.
+ * @example
+ * ```typescript
+ * import { tmuxPassthrough } from \'@visulima/ansi/passthrough\';
+ * import { cursorShow } from \'@visulima/ansi/cursor\';
+ *
+ * const originalSequence = cursorShow; // e.g., "\u001b[?25h"
+ * const passthrough = tmuxPassthrough(originalSequence);
+ *
+ * // Expected: "\u001bPtmux;\u001b\u001b[?25h\u001b\\"
+ * // (ESC P tmux ; ESC ESC [ ? 2 5 h ESC \)
+ * console.log(JSON.stringify(passthrough));
+ * ```
+ */
+export declare const tmuxPassthrough: (sequence: string) => string;