@visulima/ansi 2.0.0 → 3.0.0

package/dist/strip.mjs

@@ -1,18 +0,0 @@
-var __defProp$1 = Object.defineProperty;
-var __name$1 = (target, value) => __defProp$1(target, "name", { value, configurable: true });
-function ansiRegex({ onlyFirst = false } = {}) {
-  const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
-  const pattern = [
-    `[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?${ST})`,
-    "(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]))"
-  ].join("|");
-  return new RegExp(pattern, onlyFirst ? void 0 : "g");
-}
-__name$1(ansiRegex, "ansiRegex");
-
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const regex = ansiRegex();
-const strip = /* @__PURE__ */ __name((input) => input.replace(/\u001B\]0;.*\u0007/, "").replace(regex, ""), "strip");
-
-export { strip as default };

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 };