@visulima/ansi 2.0.1 → 3.0.1

package/dist/termcap.cjs

@@ -1,33 +0,0 @@
-'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 stringToHex = /* @__PURE__ */ __name((input) => {
-  let hex = "";
-  for (let index = 0; index < input.length; index += 1) {
-    const charCode = input.codePointAt(index);
-    if (charCode === void 0) {
-      continue;
-    }
-    const byteHex = charCode.toString(16).toUpperCase();
-    hex += byteHex.length === 1 ? `0${byteHex}` : byteHex;
-  }
-  return hex;
-}, "stringToHex");
-const XTGETTCAP = /* @__PURE__ */ __name((...caps) => {
-  if (caps.length === 0) {
-    return "";
-  }
-  const hexCaps = caps.map((cap) => stringToHex(cap));
-  return `${constants.DCS}+q${hexCaps.join(constants.SEP)}${constants.ST}`;
-}, "XTGETTCAP");
-const requestTermcap = XTGETTCAP;
-const requestTerminfo = XTGETTCAP;
-
-exports.XTGETTCAP = XTGETTCAP;
-exports.requestTermcap = requestTermcap;
-exports.requestTerminfo = requestTerminfo;

package/dist/termcap.d.cts

@@ -1,38 +0,0 @@
-/**
- * Requests Termcap/Terminfo (XTGETTCAP) strings from the terminal.
- * Sequence: DCS + q <Pt> ST
- * @param caps A list of termcap/terminfo capability names (e.g., "Co", "li", "cols").
- * @returns The XTGETTCAP sequence string.
- * @see https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Device-Control-Strings-plus-q
- */
-export declare const XTGETTCAP: (...caps: string[]) => string;
-/**
- * Alias for {@link XTGETTCAP}.
- * Requests Termcap/Terminfo capability strings from the terminal.
- * @param caps A list of Termcap/Terminfo capability names.
- * @returns The XTGETTCAP escape sequence string.
- * @see XTGETTCAP
- * @example
- * ```typescript
- * import { requestTermcap } from "@visulima/ansi";
- *
- * const seq = requestTermcap("Co", "li"); // Requests colors and lines
- * process.stdout.write(seq);
- * ```
- */
-export declare const requestTermcap: (...caps: string[]) => string;
-/**
- * Alias for {@link XTGETTCAP}.
- * Requests Termcap/Terminfo capability strings from the terminal.
- * @param caps A list of Termcap/Terminfo capability names.
- * @returns The XTGETTCAP escape sequence string.
- * @see XTGETTCAP
- * @example
- * ```typescript
- * import { requestTerminfo } from "@visulima/ansi";
- *
- * const seq = requestTerminfo("Co", "li"); // Requests colors and lines
- * process.stdout.write(seq);
- * ```
- */
-export declare const requestTerminfo: (...caps: string[]) => string;

package/dist/termcap.d.mts

@@ -1,38 +0,0 @@
-/**
- * Requests Termcap/Terminfo (XTGETTCAP) strings from the terminal.
- * Sequence: DCS + q <Pt> ST
- * @param caps A list of termcap/terminfo capability names (e.g., "Co", "li", "cols").
- * @returns The XTGETTCAP sequence string.
- * @see https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Device-Control-Strings-plus-q
- */
-export declare const XTGETTCAP: (...caps: string[]) => string;
-/**
- * Alias for {@link XTGETTCAP}.
- * Requests Termcap/Terminfo capability strings from the terminal.
- * @param caps A list of Termcap/Terminfo capability names.
- * @returns The XTGETTCAP escape sequence string.
- * @see XTGETTCAP
- * @example
- * ```typescript
- * import { requestTermcap } from "@visulima/ansi";
- *
- * const seq = requestTermcap("Co", "li"); // Requests colors and lines
- * process.stdout.write(seq);
- * ```
- */
-export declare const requestTermcap: (...caps: string[]) => string;
-/**
- * Alias for {@link XTGETTCAP}.
- * Requests Termcap/Terminfo capability strings from the terminal.
- * @param caps A list of Termcap/Terminfo capability names.
- * @returns The XTGETTCAP escape sequence string.
- * @see XTGETTCAP
- * @example
- * ```typescript
- * import { requestTerminfo } from "@visulima/ansi";
- *
- * const seq = requestTerminfo("Co", "li"); // Requests colors and lines
- * process.stdout.write(seq);
- * ```
- */
-export declare const requestTerminfo: (...caps: string[]) => string;

package/dist/termcap.mjs

@@ -1,27 +0,0 @@
-import { D as DCS, a as ST, S as SEP } from './packem_shared/constants-CE7WkXh_.mjs';
-
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const stringToHex = /* @__PURE__ */ __name((input) => {
-  let hex = "";
-  for (let index = 0; index < input.length; index += 1) {
-    const charCode = input.codePointAt(index);
-    if (charCode === void 0) {
-      continue;
-    }
-    const byteHex = charCode.toString(16).toUpperCase();
-    hex += byteHex.length === 1 ? `0${byteHex}` : byteHex;
-  }
-  return hex;
-}, "stringToHex");
-const XTGETTCAP = /* @__PURE__ */ __name((...caps) => {
-  if (caps.length === 0) {
-    return "";
-  }
-  const hexCaps = caps.map((cap) => stringToHex(cap));
-  return `${DCS}+q${hexCaps.join(SEP)}${ST}`;
-}, "XTGETTCAP");
-const requestTermcap = XTGETTCAP;
-const requestTerminfo = XTGETTCAP;
-
-export { XTGETTCAP, requestTermcap, requestTerminfo };

package/dist/title.cjs

@@ -1,31 +0,0 @@
-'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 validateTitle = /* @__PURE__ */ __name((title) => {
-  if (typeof title !== "string") {
-    throw new TypeError("Title must be a string");
-  }
-  return title.replaceAll(/[\u0007\u001B]/g, "");
-}, "validateTitle");
-const setIconNameAndWindowTitle = /* @__PURE__ */ __name((title) => `${constants.OSC}0;${validateTitle(title)}${constants.BEL}`, "setIconNameAndWindowTitle");
-const setIconName = /* @__PURE__ */ __name((iconName) => `${constants.OSC}1;${iconName}${constants.BEL}`, "setIconName");
-const setWindowTitle = /* @__PURE__ */ __name((title) => `${constants.OSC}2;${title}${constants.BEL}`, "setWindowTitle");
-const decswt = /* @__PURE__ */ __name((title) => setWindowTitle(`1;${title}`), "decswt");
-const decsin = /* @__PURE__ */ __name((name) => setWindowTitle(`L;${name}`), "decsin");
-const setIconNameAndWindowTitleWithST = /* @__PURE__ */ __name((title) => `${constants.OSC}0;${title}${constants.ST}`, "setIconNameAndWindowTitleWithST");
-const setIconNameWithST = /* @__PURE__ */ __name((iconName) => `${constants.OSC}1;${iconName}${constants.ST}`, "setIconNameWithST");
-const setWindowTitleWithST = /* @__PURE__ */ __name((title) => `${constants.OSC}2;${title}${constants.ST}`, "setWindowTitleWithST");
-
-exports.decsin = decsin;
-exports.decswt = decswt;
-exports.setIconName = setIconName;
-exports.setIconNameAndWindowTitle = setIconNameAndWindowTitle;
-exports.setIconNameAndWindowTitleWithST = setIconNameAndWindowTitleWithST;
-exports.setIconNameWithST = setIconNameWithST;
-exports.setWindowTitle = setWindowTitle;
-exports.setWindowTitleWithST = setWindowTitleWithST;

package/dist/title.d.cts

@@ -1,185 +0,0 @@
-/**
- * Sets the icon name and window title using an OSC (Operating System Command) sequence.
- * This typically affects the title shown in the window's title bar and the name used for the icon
- * when the window is minimized or in a taskbar.
- *
- * Uses the sequence: `OSC 0 ; title BEL`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `0`: Parameter indicating to set both icon name and window title.
- * - `title`: The string to set.
- * - `BEL`: Bell character (`\x07`) as terminator.
- * @param title The string to be set as both the icon name and the window title.
- * @returns The ANSI escape sequence for setting the icon name and window title.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconNameAndWindowTitle } from "@visulima/ansi";
- *
- * process.stdout.write(setIconNameAndWindowTitle("My Application"));
- * // Sends: "\x1b]0;My Application\x07"
- * ```
- */
-export declare const setIconNameAndWindowTitle: (title: string) => string;
-/**
- * Sets the icon name using an OSC (Operating System Command) sequence.
- * This affects the name used for the icon when the window is minimized or in a taskbar.
- *
- * Uses the sequence: `OSC 1 ; iconName BEL`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `1`: Parameter indicating to set only the icon name.
- * - `iconName`: The string to set as the icon name.
- * - `BEL`: Bell character (`\x07`) as terminator.
- * @param iconName The string to be set as the icon name.
- * @returns The ANSI escape sequence for setting the icon name.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconName } from "@visulima/ansi";
- *
- * process.stdout.write(setIconName("AppIcon"));
- * // Sends: "\x1b]1;AppIcon\x07"
- * ```
- */
-export declare const setIconName: (iconName: string) => string;
-/**
- * Sets the window title using an OSC (Operating System Command) sequence.
- * This affects the title shown in the window's title bar.
- *
- * Uses the sequence: `OSC 2 ; title BEL`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `2`: Parameter indicating to set only the window title.
- * - `title`: The string to set as the window title.
- * - `BEL`: Bell character (`\x07`) as terminator.
- * @param title The string to be set as the window title.
- * @returns The ANSI escape sequence for setting the window title.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setWindowTitle } from "@visulima/ansi";
- *
- * process.stdout.write(setWindowTitle("Current Document - Editor"));
- * // Sends: "\x1b]2;Current Document - Editor\x07"
- * ```
- */
-export declare const setWindowTitle: (title: string) => string;
-/**
- * Sets a DEC Special Window Title (DECSWT) using an OSC sequence.
- * The original Go library implemented this by prepending "1;" to the title and using `setWindowTitle`,
- * resulting in an `OSC 2 ; 1;<title> BEL` sequence.
- * This differs from some interpretations where DECSWT might use `OSC 1`.
- * This implementation replicates the Go library's specific behavior.
- *
- * Note: DECSWT (`OSC 2;1;...BEL`) was introduced in the DEC VT520/VT525 family
- * and is ignored by earlier DEC terminals. Support varies across modern emulators;
- * for example, Zutty 0.6+ claims VT520 compatibility, but many others that handle
- * common OSC sequences may drop or ignore DECSWT.
- * If relying on this sequence, testing on actual VT520 hardware or emulators
- * with known VT520 support is recommended. Unsupported sequences are typically
- * silently ignored by most terminals.
- *
- * Uses the sequence: `OSC 2 ; 1;<title> BEL` (based on Go library's behavior)
- * @param title The title string.
- * @returns The ANSI escape sequence for DECSWT (as implemented).
- * @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
- * @see setWindowTitle
- * @example
- * ```typescript
- * import { decswt } from "@visulima/ansi";
- *
- * process.stdout.write(decswt("My Special Window"));
- * // Sends: "\\x1b]2;1;My Special Window\\x07"
- * ```
- */
-export declare const decswt: (title: string) => string;
-/**
- * Sets a DEC Special Icon Name (DECSIN) using an OSC sequence.
- * The original Go library implemented this by prepending "L;" to the name and using `setWindowTitle`,
- * resulting in an `OSC 2 ; L;<name> BEL` sequence.
- * This differs from some interpretations where DECSIN might use `OSC L` or `OSC 1`.
- * This implementation replicates the Go library's specific behavior.
- *
- * Note: DECSIN (`OSC 2;L;...BEL`) was introduced in the DEC VT520/VT525 family
- * and is ignored by earlier DEC terminals. Support varies across modern emulators;
- * for example, Zutty 0.6+ claims VT520 compatibility, but many others that handle
- * common OSC sequences may drop or ignore DECSIN.
- * If relying on this sequence, testing on actual VT520 hardware or emulators
- * with known VT520 support is recommended. Unsupported sequences are typically
- * silently ignored by most terminals.
- *
- * Uses the sequence: `OSC 2 ; L;<name> BEL` (based on Go library's behavior)
- * @param name The name or content for the DEC-style icon name.
- * @returns The ANSI escape sequence for DECSIN (as implemented).
- * @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
- * @see setWindowTitle
- * @example
- * ```typescript
- * import { decsin } from "@visulima/ansi";
- *
- * process.stdout.write(decsin("SpecialIcon"));
- * // Sends: "\\x1b]2;L;SpecialIcon\\x07"
- * ```
- */
-export declare const decsin: (name: string) => string;
-/**
- * Sets the icon name and window title using an OSC sequence, terminated with ST (String Terminator).
- * This is an alternative to the BEL-terminated version.
- *
- * Uses the sequence: `OSC 0 ; title ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `0`: Parameter indicating to set both icon name and window title.
- * - `title`: The string to set.
- * - `ST`: String Terminator (`\x1b\\`).
- * @param title The string to be set as both the icon name and the window title.
- * @returns The ANSI escape sequence for setting the icon name and window title, using ST.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconNameAndWindowTitleWithST } from "@visulima/ansi";
- *
- * process.stdout.write(setIconNameAndWindowTitleWithST("My App ST"));
- * // Sends: "\x1b]0;My App ST\x1b\\"
- * ```
- */
-export declare const setIconNameAndWindowTitleWithST: (title: string) => string;
-/**
- * Sets the icon name using an OSC sequence, terminated with ST (String Terminator).
- * This is an alternative to the BEL-terminated version.
- *
- * Uses the sequence: `OSC 1 ; iconName ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `1`: Parameter indicating to set only the icon name.
- * - `iconName`: The string to set as the icon name.
- * - `ST`: String Terminator (`\x1b\\`).
- * @param iconName The string to be set as the icon name.
- * @returns The ANSI escape sequence for setting the icon name, using ST.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconNameWithST } from "@visulima/ansi";
- *
- * process.stdout.write(setIconNameWithST("AppIcon ST"));
- * // Sends: "\x1b]1;AppIcon ST\x1b\\"
- * ```
- */
-export declare const setIconNameWithST: (iconName: string) => string;
-/**
- * Sets the window title using an OSC sequence, terminated with ST (String Terminator).
- * This is an alternative to the BEL-terminated version.
- *
- * Uses the sequence: `OSC 2 ; title ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `2`: Parameter indicating to set only the window title.
- * - `title`: The string to set as the window title.
- * - `ST`: String Terminator (`\x1b\\`).
- * @param title The string to be set as the window title.
- * @returns The ANSI escape sequence for setting the window title, using ST.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setWindowTitleWithST } from "@visulima/ansi";
- *
- * process.stdout.write(setWindowTitleWithST("Document ST - Editor"));
- * // Sends: "\x1b]2;Document ST - Editor\x1b\\"
- * ```
- */
-export declare const setWindowTitleWithST: (title: string) => string;

package/dist/title.d.mts

@@ -1,185 +0,0 @@
-/**
- * Sets the icon name and window title using an OSC (Operating System Command) sequence.
- * This typically affects the title shown in the window's title bar and the name used for the icon
- * when the window is minimized or in a taskbar.
- *
- * Uses the sequence: `OSC 0 ; title BEL`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `0`: Parameter indicating to set both icon name and window title.
- * - `title`: The string to set.
- * - `BEL`: Bell character (`\x07`) as terminator.
- * @param title The string to be set as both the icon name and the window title.
- * @returns The ANSI escape sequence for setting the icon name and window title.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconNameAndWindowTitle } from "@visulima/ansi";
- *
- * process.stdout.write(setIconNameAndWindowTitle("My Application"));
- * // Sends: "\x1b]0;My Application\x07"
- * ```
- */
-export declare const setIconNameAndWindowTitle: (title: string) => string;
-/**
- * Sets the icon name using an OSC (Operating System Command) sequence.
- * This affects the name used for the icon when the window is minimized or in a taskbar.
- *
- * Uses the sequence: `OSC 1 ; iconName BEL`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `1`: Parameter indicating to set only the icon name.
- * - `iconName`: The string to set as the icon name.
- * - `BEL`: Bell character (`\x07`) as terminator.
- * @param iconName The string to be set as the icon name.
- * @returns The ANSI escape sequence for setting the icon name.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconName } from "@visulima/ansi";
- *
- * process.stdout.write(setIconName("AppIcon"));
- * // Sends: "\x1b]1;AppIcon\x07"
- * ```
- */
-export declare const setIconName: (iconName: string) => string;
-/**
- * Sets the window title using an OSC (Operating System Command) sequence.
- * This affects the title shown in the window's title bar.
- *
- * Uses the sequence: `OSC 2 ; title BEL`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `2`: Parameter indicating to set only the window title.
- * - `title`: The string to set as the window title.
- * - `BEL`: Bell character (`\x07`) as terminator.
- * @param title The string to be set as the window title.
- * @returns The ANSI escape sequence for setting the window title.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setWindowTitle } from "@visulima/ansi";
- *
- * process.stdout.write(setWindowTitle("Current Document - Editor"));
- * // Sends: "\x1b]2;Current Document - Editor\x07"
- * ```
- */
-export declare const setWindowTitle: (title: string) => string;
-/**
- * Sets a DEC Special Window Title (DECSWT) using an OSC sequence.
- * The original Go library implemented this by prepending "1;" to the title and using `setWindowTitle`,
- * resulting in an `OSC 2 ; 1;<title> BEL` sequence.
- * This differs from some interpretations where DECSWT might use `OSC 1`.
- * This implementation replicates the Go library's specific behavior.
- *
- * Note: DECSWT (`OSC 2;1;...BEL`) was introduced in the DEC VT520/VT525 family
- * and is ignored by earlier DEC terminals. Support varies across modern emulators;
- * for example, Zutty 0.6+ claims VT520 compatibility, but many others that handle
- * common OSC sequences may drop or ignore DECSWT.
- * If relying on this sequence, testing on actual VT520 hardware or emulators
- * with known VT520 support is recommended. Unsupported sequences are typically
- * silently ignored by most terminals.
- *
- * Uses the sequence: `OSC 2 ; 1;<title> BEL` (based on Go library's behavior)
- * @param title The title string.
- * @returns The ANSI escape sequence for DECSWT (as implemented).
- * @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
- * @see setWindowTitle
- * @example
- * ```typescript
- * import { decswt } from "@visulima/ansi";
- *
- * process.stdout.write(decswt("My Special Window"));
- * // Sends: "\\x1b]2;1;My Special Window\\x07"
- * ```
- */
-export declare const decswt: (title: string) => string;
-/**
- * Sets a DEC Special Icon Name (DECSIN) using an OSC sequence.
- * The original Go library implemented this by prepending "L;" to the name and using `setWindowTitle`,
- * resulting in an `OSC 2 ; L;<name> BEL` sequence.
- * This differs from some interpretations where DECSIN might use `OSC L` or `OSC 1`.
- * This implementation replicates the Go library's specific behavior.
- *
- * Note: DECSIN (`OSC 2;L;...BEL`) was introduced in the DEC VT520/VT525 family
- * and is ignored by earlier DEC terminals. Support varies across modern emulators;
- * for example, Zutty 0.6+ claims VT520 compatibility, but many others that handle
- * common OSC sequences may drop or ignore DECSIN.
- * If relying on this sequence, testing on actual VT520 hardware or emulators
- * with known VT520 support is recommended. Unsupported sequences are typically
- * silently ignored by most terminals.
- *
- * Uses the sequence: `OSC 2 ; L;<name> BEL` (based on Go library's behavior)
- * @param name The name or content for the DEC-style icon name.
- * @returns The ANSI escape sequence for DECSIN (as implemented).
- * @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
- * @see setWindowTitle
- * @example
- * ```typescript
- * import { decsin } from "@visulima/ansi";
- *
- * process.stdout.write(decsin("SpecialIcon"));
- * // Sends: "\\x1b]2;L;SpecialIcon\\x07"
- * ```
- */
-export declare const decsin: (name: string) => string;
-/**
- * Sets the icon name and window title using an OSC sequence, terminated with ST (String Terminator).
- * This is an alternative to the BEL-terminated version.
- *
- * Uses the sequence: `OSC 0 ; title ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `0`: Parameter indicating to set both icon name and window title.
- * - `title`: The string to set.
- * - `ST`: String Terminator (`\x1b\\`).
- * @param title The string to be set as both the icon name and the window title.
- * @returns The ANSI escape sequence for setting the icon name and window title, using ST.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconNameAndWindowTitleWithST } from "@visulima/ansi";
- *
- * process.stdout.write(setIconNameAndWindowTitleWithST("My App ST"));
- * // Sends: "\x1b]0;My App ST\x1b\\"
- * ```
- */
-export declare const setIconNameAndWindowTitleWithST: (title: string) => string;
-/**
- * Sets the icon name using an OSC sequence, terminated with ST (String Terminator).
- * This is an alternative to the BEL-terminated version.
- *
- * Uses the sequence: `OSC 1 ; iconName ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `1`: Parameter indicating to set only the icon name.
- * - `iconName`: The string to set as the icon name.
- * - `ST`: String Terminator (`\x1b\\`).
- * @param iconName The string to be set as the icon name.
- * @returns The ANSI escape sequence for setting the icon name, using ST.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setIconNameWithST } from "@visulima/ansi";
- *
- * process.stdout.write(setIconNameWithST("AppIcon ST"));
- * // Sends: "\x1b]1;AppIcon ST\x1b\\"
- * ```
- */
-export declare const setIconNameWithST: (iconName: string) => string;
-/**
- * Sets the window title using an OSC sequence, terminated with ST (String Terminator).
- * This is an alternative to the BEL-terminated version.
- *
- * Uses the sequence: `OSC 2 ; title ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `2`: Parameter indicating to set only the window title.
- * - `title`: The string to set as the window title.
- * - `ST`: String Terminator (`\x1b\\`).
- * @param title The string to be set as the window title.
- * @returns The ANSI escape sequence for setting the window title, using ST.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands Xterm OSC documentation}
- * @example
- * ```typescript
- * import { setWindowTitleWithST } from "@visulima/ansi";
- *
- * process.stdout.write(setWindowTitleWithST("Document ST - Editor"));
- * // Sends: "\x1b]2;Document ST - Editor\x1b\\"
- * ```
- */
-export declare const setWindowTitleWithST: (title: string) => string;

package/dist/title.mjs

@@ -1,20 +0,0 @@
-import { O as OSC, B as BEL, a as ST } from './packem_shared/constants-CE7WkXh_.mjs';
-
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const validateTitle = /* @__PURE__ */ __name((title) => {
-  if (typeof title !== "string") {
-    throw new TypeError("Title must be a string");
-  }
-  return title.replaceAll(/[\u0007\u001B]/g, "");
-}, "validateTitle");
-const setIconNameAndWindowTitle = /* @__PURE__ */ __name((title) => `${OSC}0;${validateTitle(title)}${BEL}`, "setIconNameAndWindowTitle");
-const setIconName = /* @__PURE__ */ __name((iconName) => `${OSC}1;${iconName}${BEL}`, "setIconName");
-const setWindowTitle = /* @__PURE__ */ __name((title) => `${OSC}2;${title}${BEL}`, "setWindowTitle");
-const decswt = /* @__PURE__ */ __name((title) => setWindowTitle(`1;${title}`), "decswt");
-const decsin = /* @__PURE__ */ __name((name) => setWindowTitle(`L;${name}`), "decsin");
-const setIconNameAndWindowTitleWithST = /* @__PURE__ */ __name((title) => `${OSC}0;${title}${ST}`, "setIconNameAndWindowTitleWithST");
-const setIconNameWithST = /* @__PURE__ */ __name((iconName) => `${OSC}1;${iconName}${ST}`, "setIconNameWithST");
-const setWindowTitleWithST = /* @__PURE__ */ __name((title) => `${OSC}2;${title}${ST}`, "setWindowTitleWithST");
-
-export { decsin, decswt, setIconName, setIconNameAndWindowTitle, setIconNameAndWindowTitleWithST, setIconNameWithST, setWindowTitle, setWindowTitleWithST };

package/dist/window-ops.cjs

@@ -1,85 +0,0 @@
-'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 });
-var XTermWindowOp = /* @__PURE__ */ ((XTermWindowOp2) => {
-  XTermWindowOp2[XTermWindowOp2["DEICONIFY_WINDOW"] = 1] = "DEICONIFY_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["ICONIFY_WINDOW"] = 2] = "ICONIFY_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["LOWER_WINDOW"] = 6] = "LOWER_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["MAXIMIZE_WINDOW"] = 10] = "MAXIMIZE_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["MAXIMIZE_WINDOW_HORIZONTALLY"] = 10.2] = "MAXIMIZE_WINDOW_HORIZONTALLY";
-  XTermWindowOp2[XTermWindowOp2["MAXIMIZE_WINDOW_VERTICALLY"] = 10.1] = "MAXIMIZE_WINDOW_VERTICALLY";
-  XTermWindowOp2[XTermWindowOp2["MOVE_WINDOW"] = 3] = "MOVE_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["POP_WINDOW_TITLE"] = 23] = "POP_WINDOW_TITLE";
-  XTermWindowOp2[XTermWindowOp2["PUSH_WINDOW_TITLE"] = 22] = "PUSH_WINDOW_TITLE";
-  XTermWindowOp2[XTermWindowOp2["RAISE_WINDOW"] = 5] = "RAISE_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["REFRESH_WINDOW"] = 7] = "REFRESH_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["REPORT_CELL_SIZE_PIXELS"] = 16] = "REPORT_CELL_SIZE_PIXELS";
-  XTermWindowOp2[XTermWindowOp2["REPORT_ICON_LABEL"] = 19] = "REPORT_ICON_LABEL";
-  XTermWindowOp2[XTermWindowOp2["REPORT_TEXT_AREA_SIZE_CHARS"] = 14] = "REPORT_TEXT_AREA_SIZE_CHARS";
-  XTermWindowOp2[XTermWindowOp2["REPORT_TEXT_AREA_SIZE_PIXELS"] = 18] = "REPORT_TEXT_AREA_SIZE_PIXELS";
-  XTermWindowOp2[XTermWindowOp2["REPORT_WINDOW_POSITION"] = 13] = "REPORT_WINDOW_POSITION";
-  XTermWindowOp2[XTermWindowOp2["REPORT_WINDOW_STATE"] = 11] = "REPORT_WINDOW_STATE";
-  XTermWindowOp2[XTermWindowOp2["REPORT_WINDOW_TITLE"] = 21] = "REPORT_WINDOW_TITLE";
-  XTermWindowOp2[XTermWindowOp2["REQUEST_WINDOW_SIZE_WIN_OP_COMPAT"] = 14] = "REQUEST_WINDOW_SIZE_WIN_OP_COMPAT";
-  XTermWindowOp2[XTermWindowOp2["RESIZE_SCREEN_AND_TEXT_AREA"] = 24] = "RESIZE_SCREEN_AND_TEXT_AREA";
-  XTermWindowOp2[XTermWindowOp2["RESIZE_TEXT_AREA_CHARS"] = 4] = "RESIZE_TEXT_AREA_CHARS";
-  XTermWindowOp2[XTermWindowOp2["RESIZE_TEXT_AREA_PIXELS"] = 8] = "RESIZE_TEXT_AREA_PIXELS";
-  XTermWindowOp2[XTermWindowOp2["RESTORE_MAXIMIZED_WINDOW"] = 9] = "RESTORE_MAXIMIZED_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["UNDO_FULL_SCREEN_MODE"] = 10.3] = "UNDO_FULL_SCREEN_MODE";
-  return XTermWindowOp2;
-})(XTermWindowOp || {});
-const xtermWindowOp = /* @__PURE__ */ __name((p, ...ps) => {
-  const allowedFloats = [10.1 /* MAXIMIZE_WINDOW_VERTICALLY */, 10.2 /* MAXIMIZE_WINDOW_HORIZONTALLY */, 10.3 /* UNDO_FULL_SCREEN_MODE */];
-  if (allowedFloats.includes(p)) ; else if (p <= 0) {
-    return "";
-  }
-  const parameters = [p];
-  for (const value of ps) {
-    if (value >= 0) {
-      parameters.push(value);
-    }
-  }
-  return `${constants.CSI}${parameters.join(";")}t`;
-}, "xtermWindowOp");
-const XTWINOPS = xtermWindowOp;
-const resizeTextAreaChars = /* @__PURE__ */ __name((height, width) => xtermWindowOp(4 /* RESIZE_TEXT_AREA_CHARS */, height, width), "resizeTextAreaChars");
-const requestTextAreaSizeChars = /* @__PURE__ */ __name(() => xtermWindowOp(14 /* REQUEST_WINDOW_SIZE_WIN_OP_COMPAT */), "requestTextAreaSizeChars");
-const requestCellSizePixels = /* @__PURE__ */ __name(() => xtermWindowOp(16 /* REPORT_CELL_SIZE_PIXELS */), "requestCellSizePixels");
-const requestTextAreaSizePixels = /* @__PURE__ */ __name(() => xtermWindowOp(18 /* REPORT_TEXT_AREA_SIZE_PIXELS */), "requestTextAreaSizePixels");
-const deiconifyWindow = /* @__PURE__ */ __name(() => xtermWindowOp(1 /* DEICONIFY_WINDOW */), "deiconifyWindow");
-const iconifyWindow = /* @__PURE__ */ __name(() => xtermWindowOp(2 /* ICONIFY_WINDOW */), "iconifyWindow");
-const moveWindow = /* @__PURE__ */ __name((x, y) => xtermWindowOp(3 /* MOVE_WINDOW */, x, y), "moveWindow");
-const raiseWindow = /* @__PURE__ */ __name(() => xtermWindowOp(5 /* RAISE_WINDOW */), "raiseWindow");
-const lowerWindow = /* @__PURE__ */ __name(() => xtermWindowOp(6 /* LOWER_WINDOW */), "lowerWindow");
-const refreshWindow = /* @__PURE__ */ __name(() => xtermWindowOp(7 /* REFRESH_WINDOW */), "refreshWindow");
-const resizeTextAreaPixels = /* @__PURE__ */ __name((height, width) => xtermWindowOp(8 /* RESIZE_TEXT_AREA_PIXELS */, height, width), "resizeTextAreaPixels");
-const restoreMaximizedWindow = /* @__PURE__ */ __name(() => xtermWindowOp(9 /* RESTORE_MAXIMIZED_WINDOW */), "restoreMaximizedWindow");
-const maximizeWindow = /* @__PURE__ */ __name(() => xtermWindowOp(10 /* MAXIMIZE_WINDOW */), "maximizeWindow");
-const reportWindowPosition = /* @__PURE__ */ __name(() => xtermWindowOp(13 /* REPORT_WINDOW_POSITION */), "reportWindowPosition");
-const reportWindowState = /* @__PURE__ */ __name(() => xtermWindowOp(11 /* REPORT_WINDOW_STATE */), "reportWindowState");
-const setPageSizeLines = /* @__PURE__ */ __name((lines) => xtermWindowOp(24 /* RESIZE_SCREEN_AND_TEXT_AREA */, lines), "setPageSizeLines");
-
-exports.XTWINOPS = XTWINOPS;
-exports.XTermWindowOp = XTermWindowOp;
-exports.deiconifyWindow = deiconifyWindow;
-exports.iconifyWindow = iconifyWindow;
-exports.lowerWindow = lowerWindow;
-exports.maximizeWindow = maximizeWindow;
-exports.moveWindow = moveWindow;
-exports.raiseWindow = raiseWindow;
-exports.refreshWindow = refreshWindow;
-exports.reportWindowPosition = reportWindowPosition;
-exports.reportWindowState = reportWindowState;
-exports.requestCellSizePixels = requestCellSizePixels;
-exports.requestTextAreaSizeChars = requestTextAreaSizeChars;
-exports.requestTextAreaSizePixels = requestTextAreaSizePixels;
-exports.resizeTextAreaChars = resizeTextAreaChars;
-exports.resizeTextAreaPixels = resizeTextAreaPixels;
-exports.restoreMaximizedWindow = restoreMaximizedWindow;
-exports.setPageSizeLines = setPageSizeLines;
-exports.xtermWindowOp = xtermWindowOp;