@visulima/ansi 4.0.0-alpha.1 → 4.0.0-alpha.2

package/dist/packem_shared/ITerm2File-DzWaT6j3.js

@@ -1,137 +0,0 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  Buffer
-} = __cjs_getBuiltinModule("node:buffer");
-
-const formatITerm2FileProperties = (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(";");
-};
-class 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 {
-  /**
-   * 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;
-  }
-  /**
-   * 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;
-  }
-  /**
-   * 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-CE7WkXh_.js

@@ -1,9 +0,0 @@
-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-CHPvxMal.js

@@ -1,71 +0,0 @@
-import { C as CSI, E as ESC, S as SEP } from './constants-CE7WkXh_.js';
-import './restoreCursor-GfYEeJqN.js';
-
-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));
-
-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 = (count = 1) => `${CSI + count}D`;
-const cursorDown = (count = 1) => `${CSI + count}B`;
-const cursorForward = (count = 1) => `${CSI + count}C`;
-const cursorHide = `${CSI}?25l`;
-const cursorToColumn1 = `${CSI}G`;
-const cursorLeft = (count = 1) => cursorBackward(count);
-const cursorHorizontalAbsolute = (column = 1) => `${CSI + column}G`;
-const cursorMove = (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;
-};
-const cursorNextLine = (count = 1) => `${CSI + count}E`;
-const cursorPreviousLine = (count = 1) => `${CSI + count}F`;
-const cursorRestore = isTerminalApp ? RESTORE_CURSOR_DEC : `${ESC}u`;
-const cursorSave = isTerminalApp ? SAVE_CURSOR_DEC : `${ESC}s`;
-const cursorShow = `${CSI}?25h`;
-const cursorTo = (x, y) => {
-  if (y === void 0) {
-    return cursorHorizontalAbsolute(x + 1);
-  }
-  return `${CSI + (y + 1) + SEP + (x + 1)}H`;
-};
-const cursorPosition = (row, column) => {
-  if (column === void 0) {
-    return `${CSI + row}H`;
-  }
-  return `${CSI + row + SEP + column}H`;
-};
-const cursorHorizontalForwardTab = (count = 1) => `${CSI + count}I`;
-const cursorBackwardTab = (count = 1) => `${CSI + count}Z`;
-const eraseCharacter = (count = 1) => `${CSI + count}X`;
-const cursorVerticalAbsolute = (row = 1) => `${CSI + row}d`;
-const cursorUp = (count = 1) => `${CSI + count}A`;
-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 = (style) => `${CSI + style} q`;
-
-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/packem_shared/resetProgressBar-kV21u2hs.js

@@ -1,18 +0,0 @@
-import { O as OSC, B as BEL } from './constants-CE7WkXh_.js';
-
-const resetProgressBar = `${OSC}9;4;0${BEL}`;
-const setProgressBar = (percentage) => {
-  const clamped = Math.min(Math.max(0, percentage), 100);
-  return `${OSC}9;4;1;${clamped}${BEL}`;
-};
-const setErrorProgressBar = (percentage) => {
-  const clamped = Math.min(Math.max(0, percentage), 100);
-  return `${OSC}9;4;2;${clamped}${BEL}`;
-};
-const setIndeterminateProgressBar = `${OSC}9;4;3${BEL}`;
-const setWarningProgressBar = (percentage) => {
-  const clamped = Math.min(Math.max(0, percentage), 100);
-  return `${OSC}9;4;4;${clamped}${BEL}`;
-};
-
-export { resetProgressBar, setErrorProgressBar, setIndeterminateProgressBar, setProgressBar, setWarningProgressBar };

package/dist/packem_shared/restoreCursor-GfYEeJqN.js

@@ -1,323 +0,0 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const process$2 = __cjs_getProcess;
-
-const copyProperty = (to, from, property, ignoreNonConfigurable) => {
-  if (property === "length" || property === "prototype") {
-    return;
-  }
-  if (property === "arguments" || property === "caller") {
-    return;
-  }
-  const toDescriptor = Object.getOwnPropertyDescriptor(to, property);
-  const fromDescriptor = Object.getOwnPropertyDescriptor(from, property);
-  if (!canCopyProperty(toDescriptor, fromDescriptor) && ignoreNonConfigurable) {
-    return;
-  }
-  Object.defineProperty(to, property, fromDescriptor);
-};
-const canCopyProperty = function(toDescriptor, fromDescriptor) {
-  return toDescriptor === void 0 || toDescriptor.configurable || toDescriptor.writable === fromDescriptor.writable && toDescriptor.enumerable === fromDescriptor.enumerable && toDescriptor.configurable === fromDescriptor.configurable && (toDescriptor.writable || toDescriptor.value === fromDescriptor.value);
-};
-const changePrototype = (to, from) => {
-  const fromPrototype = Object.getPrototypeOf(from);
-  if (fromPrototype === Object.getPrototypeOf(to)) {
-    return;
-  }
-  Object.setPrototypeOf(to, fromPrototype);
-};
-const wrappedToString = (withName, fromBody) => `/* Wrapped ${withName}*/
-${fromBody}`;
-const toStringDescriptor = Object.getOwnPropertyDescriptor(Function.prototype, "toString");
-const toStringName = Object.getOwnPropertyDescriptor(Function.prototype.toString, "name");
-const changeToString = (to, from, name) => {
-  const withName = name === "" ? "" : `with ${name.trim()}() `;
-  const newToString = wrappedToString.bind(null, withName, from.toString());
-  Object.defineProperty(newToString, "name", toStringName);
-  const { writable, enumerable, configurable } = toStringDescriptor;
-  Object.defineProperty(to, "toString", { value: newToString, writable, enumerable, configurable });
-};
-function mimicFunction(to, from, { ignoreNonConfigurable = false } = {}) {
-  const { name } = to;
-  for (const property of Reflect.ownKeys(from)) {
-    copyProperty(to, from, property, ignoreNonConfigurable);
-  }
-  changePrototype(to, from);
-  changeToString(to, from, name);
-  return to;
-}
-
-const calledFunctions = /* @__PURE__ */ new WeakMap();
-const onetime = (function_, options = {}) => {
-  if (typeof function_ !== "function") {
-    throw new TypeError("Expected a function");
-  }
-  let returnValue;
-  let callCount = 0;
-  const functionName = function_.displayName || function_.name || "<anonymous>";
-  const onetime2 = function(...arguments_) {
-    calledFunctions.set(onetime2, ++callCount);
-    if (callCount === 1) {
-      returnValue = function_.apply(this, arguments_);
-      function_ = void 0;
-    } else if (options.throw === true) {
-      throw new Error(`Function \`${functionName}\` can only be called once`);
-    }
-    return returnValue;
-  };
-  mimicFunction(onetime2, function_);
-  calledFunctions.set(onetime2, callCount);
-  return onetime2;
-};
-onetime.callCount = (function_) => {
-  if (!calledFunctions.has(function_)) {
-    throw new Error(`The given function \`${function_.name}\` is not wrapped by the \`onetime\` package`);
-  }
-  return calledFunctions.get(function_);
-};
-
-const signals = [];
-signals.push("SIGHUP", "SIGINT", "SIGTERM");
-if (process.platform !== "win32") {
-  signals.push(
-    "SIGALRM",
-    "SIGABRT",
-    "SIGVTALRM",
-    "SIGXCPU",
-    "SIGXFSZ",
-    "SIGUSR2",
-    "SIGTRAP",
-    "SIGSYS",
-    "SIGQUIT",
-    "SIGIOT"
-    // should detect profiler and enable/disable accordingly.
-    // see #21
-    // 'SIGPROF'
-  );
-}
-if (process.platform === "linux") {
-  signals.push("SIGIO", "SIGPOLL", "SIGPWR", "SIGSTKFLT");
-}
-
-const processOk = (process2) => !!process2 && true && typeof process2.removeListener === "function" && typeof process2.emit === "function" && typeof process2.reallyExit === "function" && typeof process2.listeners === "function" && typeof process2.kill === "function" && typeof process2.pid === "number" && typeof process2.on === "function";
-const kExitEmitter = /* @__PURE__ */ Symbol.for("signal-exit emitter");
-const global = globalThis;
-const ObjectDefineProperty = Object.defineProperty.bind(Object);
-class Emitter {
-  emitted = {
-    afterExit: false,
-    exit: false
-  };
-  listeners = {
-    afterExit: [],
-    exit: []
-  };
-  count = 0;
-  id = Math.random();
-  constructor() {
-    if (global[kExitEmitter]) {
-      return global[kExitEmitter];
-    }
-    ObjectDefineProperty(global, kExitEmitter, {
-      value: this,
-      writable: false,
-      enumerable: false,
-      configurable: false
-    });
-  }
-  on(ev, fn) {
-    this.listeners[ev].push(fn);
-  }
-  removeListener(ev, fn) {
-    const list = this.listeners[ev];
-    const i = list.indexOf(fn);
-    if (i === -1) {
-      return;
-    }
-    if (i === 0 && list.length === 1) {
-      list.length = 0;
-    } else {
-      list.splice(i, 1);
-    }
-  }
-  emit(ev, code, signal) {
-    if (this.emitted[ev]) {
-      return false;
-    }
-    this.emitted[ev] = true;
-    let ret = false;
-    for (const fn of this.listeners[ev]) {
-      ret = fn(code, signal) === true || ret;
-    }
-    if (ev === "exit") {
-      ret = this.emit("afterExit", code, signal) || ret;
-    }
-    return ret;
-  }
-}
-class SignalExitBase {
-}
-const signalExitWrap = (handler) => {
-  return {
-    onExit(cb, opts) {
-      return handler.onExit(cb, opts);
-    },
-    load() {
-      return handler.load();
-    },
-    unload() {
-      return handler.unload();
-    }
-  };
-};
-class SignalExitFallback extends SignalExitBase {
-  onExit() {
-    return () => {
-    };
-  }
-  load() {
-  }
-  unload() {
-  }
-}
-class SignalExit extends SignalExitBase {
-  // "SIGHUP" throws an `ENOSYS` error on Windows,
-  // so use a supported signal instead
-  /* c8 ignore start */
-  #hupSig = process$1.platform === "win32" ? "SIGINT" : "SIGHUP";
-  /* c8 ignore stop */
-  #emitter = new Emitter();
-  #process;
-  #originalProcessEmit;
-  #originalProcessReallyExit;
-  #sigListeners = {};
-  #loaded = false;
-  constructor(process2) {
-    super();
-    this.#process = process2;
-    this.#sigListeners = {};
-    for (const sig of signals) {
-      this.#sigListeners[sig] = () => {
-        const listeners = this.#process.listeners(sig);
-        let { count } = this.#emitter;
-        const p = process2;
-        if (typeof p.__signal_exit_emitter__ === "object" && typeof p.__signal_exit_emitter__.count === "number") {
-          count += p.__signal_exit_emitter__.count;
-        }
-        if (listeners.length === count) {
-          this.unload();
-          const ret = this.#emitter.emit("exit", null, sig);
-          const s = sig === "SIGHUP" ? this.#hupSig : sig;
-          if (!ret)
-            process2.kill(process2.pid, s);
-        }
-      };
-    }
-    this.#originalProcessReallyExit = process2.reallyExit;
-    this.#originalProcessEmit = process2.emit;
-  }
-  onExit(cb, opts) {
-    if (!processOk(this.#process)) {
-      return () => {
-      };
-    }
-    if (this.#loaded === false) {
-      this.load();
-    }
-    const ev = opts?.alwaysLast ? "afterExit" : "exit";
-    this.#emitter.on(ev, cb);
-    return () => {
-      this.#emitter.removeListener(ev, cb);
-      if (this.#emitter.listeners["exit"].length === 0 && this.#emitter.listeners["afterExit"].length === 0) {
-        this.unload();
-      }
-    };
-  }
-  load() {
-    if (this.#loaded) {
-      return;
-    }
-    this.#loaded = true;
-    this.#emitter.count += 1;
-    for (const sig of signals) {
-      try {
-        const fn = this.#sigListeners[sig];
-        if (fn)
-          this.#process.on(sig, fn);
-      } catch (_) {
-      }
-    }
-    this.#process.emit = (ev, ...a) => {
-      return this.#processEmit(ev, ...a);
-    };
-    this.#process.reallyExit = (code) => {
-      return this.#processReallyExit(code);
-    };
-  }
-  unload() {
-    if (!this.#loaded) {
-      return;
-    }
-    this.#loaded = false;
-    signals.forEach((sig) => {
-      const listener = this.#sigListeners[sig];
-      if (!listener) {
-        throw new Error("Listener not defined for signal: " + sig);
-      }
-      try {
-        this.#process.removeListener(sig, listener);
-      } catch (_) {
-      }
-    });
-    this.#process.emit = this.#originalProcessEmit;
-    this.#process.reallyExit = this.#originalProcessReallyExit;
-    this.#emitter.count -= 1;
-  }
-  #processReallyExit(code) {
-    if (!processOk(this.#process)) {
-      return 0;
-    }
-    this.#process.exitCode = code || 0;
-    this.#emitter.emit("exit", this.#process.exitCode, null);
-    return this.#originalProcessReallyExit.call(this.#process, this.#process.exitCode);
-  }
-  #processEmit(ev, ...args) {
-    const og = this.#originalProcessEmit;
-    if (ev === "exit" && processOk(this.#process)) {
-      if (typeof args[0] === "number") {
-        this.#process.exitCode = args[0];
-      }
-      const ret = og.call(this.#process, ev, ...args);
-      this.#emitter.emit("exit", this.#process.exitCode, null);
-      return ret;
-    } else {
-      return og.call(this.#process, ev, ...args);
-    }
-  }
-}
-const process$1 = globalThis.process;
-const {
-  /**
-   * Called when the process is exiting, whether via signal, explicit
-   * exit, or running out of stuff to do.
-   *
-   * If the global process object is not suitable for instrumentation,
-   * then this will be a no-op.
-   *
-   * Returns a function that may be used to unload signal-exit.
-   */
-  onExit} = signalExitWrap(processOk(process$1) ? new SignalExit(process$1) : new SignalExitFallback());
-
-const terminal = process$2.stderr.isTTY ? process$2.stderr : process$2.stdout.isTTY ? process$2.stdout : void 0;
-const restoreCursor = terminal ? onetime(() => {
-  onExit(() => {
-    terminal.write("\x1B[?25h");
-  }, { alwaysLast: true });
-}) : () => {
-};
-
-export { restoreCursor as default };

package/dist/passthrough.d.ts

@@ -1,77 +0,0 @@
-/**
- * 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.js

@@ -1,29 +0,0 @@
-import { a as ST, D as DCS, E as ESC } from './packem_shared/constants-CE7WkXh_.js';
-
-const SCREEN_MAX_LEN_DEFAULT = 0;
-const SCREEN_TYPICAL_LIMIT = 768;
-const screenPassthrough = (sequence, limit = SCREEN_MAX_LEN_DEFAULT) => {
-  let result = 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 += ST + DCS;
-      }
-    }
-  } else {
-    result += sequence;
-  }
-  result += ST;
-  return result;
-};
-const tmuxPassthrough = (sequence) => {
-  let escapedSequence = "";
-  for (const element of sequence) {
-    escapedSequence += element === ESC ? ESC + ESC : element;
-  }
-  return `${DCS}tmux;${escapedSequence}${ST}`;
-};
-
-export { SCREEN_MAX_LEN_DEFAULT, SCREEN_TYPICAL_LIMIT, screenPassthrough, tmuxPassthrough };