@visulima/ansi 4.0.0-alpha.13 → 4.0.0-alpha.14

package/dist/status.js

@@ -1,95 +1 @@
-import { C as CSI, S as SEP, D as DCS, a as ST } from './packem_shared/constants-CE7WkXh_.js';
-
-class AnsiStatusReportImpl {
-  constructor(reportCode) {
-    this.reportCode = reportCode;
-  }
-  reportCode;
-  isDecReport = false;
-}
-class DecStatusReportImpl {
-  constructor(reportCode) {
-    this.reportCode = reportCode;
-  }
-  reportCode;
-  isDecReport = true;
-}
-const createAnsiStatusReport = (code) => new AnsiStatusReportImpl(code);
-const createDecStatusReport = (code) => new DecStatusReportImpl(code);
-const deviceStatusReport = (...reports) => {
-  if (reports.length === 0) {
-    return "";
-  }
-  const hasDecReport = reports.some((report) => report.isDecReport);
-  const reportCodes = reports.map((report) => report.reportCode.toString());
-  let seq = CSI;
-  if (hasDecReport) {
-    seq += "?";
-  }
-  return `${seq}${reportCodes.join(SEP)}n`;
-};
-const DSR = (report) => deviceStatusReport(report);
-const requestCursorPositionReport = `${CSI}6n`;
-const requestExtendedCursorPositionReport = `${CSI}?6n`;
-const cursorPositionReport = (line, column) => {
-  const r = Math.max(1, line);
-  const c = Math.max(1, column);
-  return `${CSI}${r.toString()}${SEP}${c.toString()}R`;
-};
-const CPR = cursorPositionReport;
-const extendedCursorPositionReport = (line, column, page) => {
-  const r = Math.max(1, line);
-  const c = Math.max(1, column);
-  let seq = `${CSI}?`;
-  seq += r.toString() + SEP + c.toString();
-  if (page > 0) {
-    seq += SEP + page.toString();
-  }
-  seq += "R";
-  return seq;
-};
-const DECXCPR = extendedCursorPositionReport;
-const RequestNameVersion = `${CSI}>0q`;
-const XTVERSION = RequestNameVersion;
-const requestPrimaryDeviceAttributes = `${CSI}c`;
-const DA1 = requestPrimaryDeviceAttributes;
-const reportPrimaryDeviceAttributes = (...attributes) => {
-  if (attributes.length === 0) {
-    return "";
-  }
-  return `${CSI}?${attributes.join(SEP)}c`;
-};
-const requestSecondaryDeviceAttributes = `${CSI}>c`;
-const DA2 = requestSecondaryDeviceAttributes;
-const reportSecondaryDeviceAttributes = (version, level, cartridge = 0) => {
-  const pv = Math.max(0, version);
-  const pl = Math.max(0, level);
-  const pc = Math.max(0, cartridge);
-  return `${CSI}>${String(pv)}${SEP}${String(pl)}${SEP}${String(pc)}c`;
-};
-const requestTertiaryDeviceAttributes = `${CSI}=c`;
-const DA3 = requestTertiaryDeviceAttributes;
-const reportTertiaryDeviceAttributes = (unitID) => `${DCS}!|${unitID}${ST}`;
-const requestPrimaryDeviceAttributesParam0 = `${CSI}0c`;
-const requestSecondaryDeviceAttributesParam0 = `${CSI}>0c`;
-const requestTertiaryDeviceAttributesParam0 = `${CSI}=0c`;
-const requestTerminalStatus = createAnsiStatusReport(5);
-const DSR_TerminalStatus = deviceStatusReport(requestTerminalStatus);
-const reportTerminalOK = `${CSI}0n`;
-const reportTerminalNotOK = `${CSI}3n`;
-const requestPrinterStatusDEC = createDecStatusReport(15);
-const DSR_PrinterStatusDEC = deviceStatusReport(requestPrinterStatusDEC);
-const reportPrinterReadyDEC = `${CSI}?10n`;
-const reportPrinterNotReadyDEC = `${CSI}?11n`;
-const reportPrinterNoPaperDEC = `${CSI}?13n`;
-const requestUDKStatusDEC = createDecStatusReport(25);
-const DSR_UDKStatusDEC = deviceStatusReport(requestUDKStatusDEC);
-const reportUDKLockedDEC = `${CSI}?20n`;
-const reportUDKUnlockedDEC = `${CSI}?21n`;
-const requestKeyboardLanguageDEC = createDecStatusReport(26);
-const DSR_KeyboardLanguageDEC = deviceStatusReport(requestKeyboardLanguageDEC);
-const reportKeyboardLanguageDEC = (langCode) => `${CSI}?27${SEP}${langCode.toString()}n`;
-const RequestLightDarkReport = `${CSI}?996n`;
-const LightDarkReport = (dark) => `${CSI}?997${SEP}${dark ? "1" : "2"}n`;
-
-export { CPR, DA1, DA2, DA3, DECXCPR, DSR, DSR_KeyboardLanguageDEC, DSR_PrinterStatusDEC, DSR_TerminalStatus, DSR_UDKStatusDEC, LightDarkReport, RequestLightDarkReport, RequestNameVersion, XTVERSION, createAnsiStatusReport, createDecStatusReport, cursorPositionReport, deviceStatusReport, extendedCursorPositionReport, reportKeyboardLanguageDEC, reportPrimaryDeviceAttributes, reportPrinterNoPaperDEC, reportPrinterNotReadyDEC, reportPrinterReadyDEC, reportSecondaryDeviceAttributes, reportTerminalNotOK, reportTerminalOK, reportTertiaryDeviceAttributes, reportUDKLockedDEC, reportUDKUnlockedDEC, requestCursorPositionReport, requestExtendedCursorPositionReport, requestKeyboardLanguageDEC, requestPrimaryDeviceAttributes, requestPrimaryDeviceAttributesParam0, requestPrinterStatusDEC, requestSecondaryDeviceAttributes, requestSecondaryDeviceAttributesParam0, requestTerminalStatus, requestTertiaryDeviceAttributes, requestTertiaryDeviceAttributesParam0, requestUDKStatusDEC };
+var $=Object.defineProperty;var D=(t,r)=>$(t,"name",{value:r,configurable:!0});import{C as e,S as i,D as S,a as R}from"./packem_shared/constants-D12jy2Zh.js";var C=Object.defineProperty,o=D((t,r)=>C(t,"name",{value:r,configurable:!0}),"e");class m{static{D(this,"x")}constructor(r){this.reportCode=r}reportCode;static{o(this,"AnsiStatusReportImpl")}isDecReport=!1}class d{static{D(this,"m")}constructor(r){this.reportCode=r}reportCode;static{o(this,"DecStatusReportImpl")}isDecReport=!0}const g=o(t=>new m(t),"createAnsiStatusReport"),p=o(t=>new d(t),"createDecStatusReport"),c=o((...t)=>{if(t.length===0)return"";const r=t.some(n=>n.isDecReport),a=t.map(n=>n.reportCode.toString());let s=e;return r&&(s+="?"),`${s}${a.join(i)}n`},"deviceStatusReport"),L=o(t=>c(t),"DSR"),M=`${e}6n`,f=`${e}?6n`,P=o((t,r)=>{const a=Math.max(1,t),s=Math.max(1,r);return`${e}${a.toString()}${i}${s.toString()}R`},"cursorPositionReport"),k=P,y=o((t,r,a)=>{const s=Math.max(1,t),n=Math.max(1,r);let u=`${e}?`;return u+=s.toString()+i+n.toString(),a>0&&(u+=i+a.toString()),u+="R",u},"extendedCursorPositionReport"),N=y,b=`${e}>0q`,U=b,A=`${e}c`,I=A,O=o((...t)=>t.length===0?"":`${e}?${t.join(i)}c`,"reportPrimaryDeviceAttributes"),v=`${e}>c`,_=v,j=o((t,r,a=0)=>{const s=Math.max(0,t),n=Math.max(0,r),u=Math.max(0,a);return`${e}>${String(s)}${i}${String(n)}${i}${String(u)}c`},"reportSecondaryDeviceAttributes"),E=`${e}=c`,w=E,V=o(t=>`${S}!|${t}${R}`,"reportTertiaryDeviceAttributes"),X=`${e}0c`,z=`${e}>0c`,B=`${e}=0c`,h=g(5),F=c(h),G=`${e}0n`,H=`${e}3n`,l=p(15),J=c(l),Q=`${e}?10n`,W=`${e}?11n`,Y=`${e}?13n`,q=p(25),Z=c(q),tt=`${e}?20n`,et=`${e}?21n`,x=p(26),rt=c(x),ot=o(t=>`${e}?27${i}${t.toString()}n`,"reportKeyboardLanguageDEC"),it=`${e}?996n`,at=o(t=>`${e}?997${i}${t?"1":"2"}n`,"LightDarkReport");export{k as CPR,I as DA1,_ as DA2,w as DA3,N as DECXCPR,L as DSR,rt as DSR_KeyboardLanguageDEC,J as DSR_PrinterStatusDEC,F as DSR_TerminalStatus,Z as DSR_UDKStatusDEC,at as LightDarkReport,it as RequestLightDarkReport,b as RequestNameVersion,U as XTVERSION,g as createAnsiStatusReport,p as createDecStatusReport,P as cursorPositionReport,c as deviceStatusReport,y as extendedCursorPositionReport,ot as reportKeyboardLanguageDEC,O as reportPrimaryDeviceAttributes,Y as reportPrinterNoPaperDEC,W as reportPrinterNotReadyDEC,Q as reportPrinterReadyDEC,j as reportSecondaryDeviceAttributes,H as reportTerminalNotOK,G as reportTerminalOK,V as reportTertiaryDeviceAttributes,tt as reportUDKLockedDEC,et as reportUDKUnlockedDEC,M as requestCursorPositionReport,f as requestExtendedCursorPositionReport,x as requestKeyboardLanguageDEC,A as requestPrimaryDeviceAttributes,X as requestPrimaryDeviceAttributesParam0,l as requestPrinterStatusDEC,v as requestSecondaryDeviceAttributes,z as requestSecondaryDeviceAttributesParam0,h as requestTerminalStatus,E as requestTertiaryDeviceAttributes,B as requestTertiaryDeviceAttributesParam0,q as requestUDKStatusDEC};

package/dist/strip.d.ts

@@ -1,2 +1,2 @@
 declare const strip: (input: string) => string;
-export default strip;
+export { strip as default };

package/dist/strip.js

@@ -1,13 +1 @@
-function ansiRegex({ onlyFirst = false } = {}) {
-  const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
-  const osc = `(?:\\u001B\\][\\s\\S]*?${ST})`;
-  const csi = "[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";
-  const pattern = `${osc}|${csi}`;
-  return new RegExp(pattern, onlyFirst ? void 0 : "g");
-}
-
-const regex = ansiRegex();
-const OSC_TITLE_REGEX = /\u001B\]0;.*\u0007/;
-const strip = (input) => input.replace(OSC_TITLE_REGEX, "").replace(regex, "");
-
-export { strip as default };
+var n=Object.defineProperty;var u=(e,r)=>n(e,"name",{value:r,configurable:!0});var t=Object.defineProperty,c=u((e,r)=>t(e,"name",{value:r,configurable:!0}),"e");function a({onlyFirst:e=!1}={}){const r="(?:\\u001B\\][\\s\\S]*?(?:\\u0007|\\u001B\\u005C|\\u009C))|[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";return new RegExp(r,e?void 0:"g")}u(a,"t");c(a,"ansiRegex");var o=Object.defineProperty,i=u((e,r)=>o(e,"name",{value:r,configurable:!0}),"r");const s=a(),l=/\u001B\]0;.*\u0007/,d=i(e=>e.replace(l,"").replace(s,""),"strip");export{d as default};

package/dist/termcap.d.ts

@@ -1,38 +1,39 @@
 /**
- * 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;
+* 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
+*/
+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 { requestTermcap } from "@visulima/ansi";
+*
+* const seq = requestTermcap("Co", "li"); // Requests colors and lines
+* process.stdout.write(seq);
+* ```
+*/
+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;
+* 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);
+* ```
+*/
+declare const requestTerminfo: (...caps: string[]) => string;
+export { XTGETTCAP, requestTermcap, requestTerminfo };

package/dist/termcap.js

@@ -1,25 +1 @@
-import { D as DCS, a as ST, S as SEP } from './packem_shared/constants-CE7WkXh_.js';
-
-const stringToHex = (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;
-};
-const XTGETTCAP = (...caps) => {
-  if (caps.length === 0) {
-    return "";
-  }
-  const hexCaps = caps.map((cap) => stringToHex(cap));
-  return `${DCS}+q${hexCaps.join(SEP)}${ST}`;
-};
-const requestTermcap = XTGETTCAP;
-const requestTerminfo = XTGETTCAP;
-
-export { XTGETTCAP, requestTermcap, requestTerminfo };
+var c=Object.defineProperty;var i=(e,t)=>c(e,"name",{value:t,configurable:!0});import{D as T,a as u,S as f}from"./packem_shared/constants-D12jy2Zh.js";var l=Object.defineProperty,s=i((e,t)=>l(e,"name",{value:t,configurable:!0}),"o");const p=s(e=>{let t="";for(let r=0;r<e.length;r+=1){const o=e.codePointAt(r);if(o===void 0)continue;const n=o.toString(16).toUpperCase();t+=n.length===1?`0${n}`:n}return t},"stringToHex"),a=s((...e)=>{if(e.length===0)return"";const t=e.map(r=>p(r));return`${T}+q${t.join(f)}${u}`},"XTGETTCAP"),P=a,S=a;export{a as XTGETTCAP,P as requestTermcap,S as requestTerminfo};

package/dist/title.d.ts

@@ -1,183 +1,184 @@
 /**
- * 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 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"
+* ```
+*/
+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 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"
+* ```
+*/
+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 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"
+* ```
+*/
+declare const setWindowTitle: (title: string) => string;
 /**
- * Sets a DEC Special Window Title (DECSWT) using an OSC sequence.
- *
- * DECSWT was introduced in the DEC VT520/VT525 family and uses the dedicated
- * OSC code `21` (not to be confused with OSC 2 for standard window titles).
- * It is terminated with ST (String Terminator) per the VT520 specification.
- *
- * Uses the sequence: `OSC 21 ; title ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `21`: Parameter for DEC Special Window Title.
- * - `title`: The string to set.
- * - `ST`: String Terminator (`\x1b\\`).
- *
- * Support varies across modern emulators; Zutty 0.6+ claims VT520 compatibility,
- * and Microsoft's Windows Terminal also supports this sequence.
- * Unsupported sequences are typically silently ignored by most terminals.
- * @param title The title string.
- * @returns The ANSI escape sequence for DECSWT.
- * @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
- * @example
- * ```typescript
- * import { decswt } from "@visulima/ansi";
- *
- * process.stdout.write(decswt("My Special Window"));
- * // Sends: "\x1b]21;My Special Window\x1b\\"
- * ```
- */
-export declare const decswt: (title: string) => string;
+* Sets a DEC Special Window Title (DECSWT) using an OSC sequence.
+*
+* DECSWT was introduced in the DEC VT520/VT525 family and uses the dedicated
+* OSC code `21` (not to be confused with OSC 2 for standard window titles).
+* It is terminated with ST (String Terminator) per the VT520 specification.
+*
+* Uses the sequence: `OSC 21 ; title ST`
+* - `OSC`: Operating System Command (`\x1b]`).
+* - `21`: Parameter for DEC Special Window Title.
+* - `title`: The string to set.
+* - `ST`: String Terminator (`\x1b\\`).
+*
+* Support varies across modern emulators; Zutty 0.6+ claims VT520 compatibility,
+* and Microsoft's Windows Terminal also supports this sequence.
+* Unsupported sequences are typically silently ignored by most terminals.
+* @param title The title string.
+* @returns The ANSI escape sequence for DECSWT.
+* @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
+* @example
+* ```typescript
+* import { decswt } from "@visulima/ansi";
+*
+* process.stdout.write(decswt("My Special Window"));
+* // Sends: "\x1b]21;My Special Window\x1b\\"
+* ```
+*/
+declare const decswt: (title: string) => string;
 /**
- * Sets a DEC Special Icon Name (DECSIN) using an OSC sequence.
- *
- * DECSIN was introduced in the DEC VT520/VT525 family and uses the dedicated
- * OSC code `2L` (not to be confused with OSC 1 for standard icon names).
- * It is terminated with ST (String Terminator) per the VT520 specification.
- *
- * Uses the sequence: `OSC 2L ; name ST`
- * - `OSC`: Operating System Command (`\x1b]`).
- * - `2L`: Parameter for DEC Special Icon Name.
- * - `name`: The string to set.
- * - `ST`: String Terminator (`\x1b\\`).
- *
- * Support varies across modern emulators; Zutty 0.6+ claims VT520 compatibility,
- * and Microsoft's Windows Terminal also supports this sequence.
- * Unsupported sequences are typically silently ignored by most terminals.
- * @param name The name or content for the DEC-style icon name.
- * @returns The ANSI escape sequence for DECSIN.
- * @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
- * @example
- * ```typescript
- * import { decsin } from "@visulima/ansi";
- *
- * process.stdout.write(decsin("SpecialIcon"));
- * // Sends: "\x1b]2L;SpecialIcon\x1b\\"
- * ```
- */
-export declare const decsin: (name: string) => string;
+* Sets a DEC Special Icon Name (DECSIN) using an OSC sequence.
+*
+* DECSIN was introduced in the DEC VT520/VT525 family and uses the dedicated
+* OSC code `2L` (not to be confused with OSC 1 for standard icon names).
+* It is terminated with ST (String Terminator) per the VT520 specification.
+*
+* Uses the sequence: `OSC 2L ; name ST`
+* - `OSC`: Operating System Command (`\x1b]`).
+* - `2L`: Parameter for DEC Special Icon Name.
+* - `name`: The string to set.
+* - `ST`: String Terminator (`\x1b\\`).
+*
+* Support varies across modern emulators; Zutty 0.6+ claims VT520 compatibility,
+* and Microsoft's Windows Terminal also supports this sequence.
+* Unsupported sequences are typically silently ignored by most terminals.
+* @param name The name or content for the DEC-style icon name.
+* @returns The ANSI escape sequence for DECSIN.
+* @see EK-VT520-RM 5–134 (VT520 Programmer Reference Manual)
+* @example
+* ```typescript
+* import { decsin } from "@visulima/ansi";
+*
+* process.stdout.write(decsin("SpecialIcon"));
+* // Sends: "\x1b]2L;SpecialIcon\x1b\\"
+* ```
+*/
+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 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\\"
+* ```
+*/
+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 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\\"
+* ```
+*/
+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;
+* 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\\"
+* ```
+*/
+declare const setWindowTitleWithST: (title: string) => string;
+export { decsin, decswt, setIconName, setIconNameAndWindowTitle, setIconNameAndWindowTitleWithST, setIconNameWithST, setWindowTitle, setWindowTitleWithST };

package/dist/title.js

@@ -1,19 +1 @@
-import { O as OSC, a as ST, B as BEL } from './packem_shared/constants-CE7WkXh_.js';
-
-const TITLE_SANITIZE_REGEX = /[\u0007\u001B]/g;
-const validateTitle = (title) => {
-  if (typeof title !== "string") {
-    throw new TypeError("Title must be a string");
-  }
-  return title.replaceAll(TITLE_SANITIZE_REGEX, "");
-};
-const setIconNameAndWindowTitle = (title) => `${OSC}0;${validateTitle(title)}${BEL}`;
-const setIconName = (iconName) => `${OSC}1;${iconName}${BEL}`;
-const setWindowTitle = (title) => `${OSC}2;${title}${BEL}`;
-const decswt = (title) => `${OSC}21;${title}${ST}`;
-const decsin = (name) => `${OSC}2L;${name}${ST}`;
-const setIconNameAndWindowTitleWithST = (title) => `${OSC}0;${title}${ST}`;
-const setIconNameWithST = (iconName) => `${OSC}1;${iconName}${ST}`;
-const setWindowTitleWithST = (title) => `${OSC}2;${title}${ST}`;
-
-export { decsin, decswt, setIconName, setIconNameAndWindowTitle, setIconNameAndWindowTitleWithST, setIconNameWithST, setWindowTitle, setWindowTitleWithST };
+var r=Object.defineProperty;var a=(e,$)=>r(e,"name",{value:$,configurable:!0});import{O as i,a as o,B as s}from"./packem_shared/constants-D12jy2Zh.js";var d=Object.defineProperty,t=a((e,$)=>d(e,"name",{value:$,configurable:!0}),"n");const T=/[\u0007\u001B]/g,n=t(e=>{if(typeof e!="string")throw new TypeError("Title must be a string");return e.replaceAll(T,"")},"validateTitle"),W=t(e=>`${i}0;${n(e)}${s}`,"setIconNameAndWindowTitle"),m=t(e=>`${i}1;${n(e)}${s}`,"setIconName"),w=t(e=>`${i}2;${n(e)}${s}`,"setWindowTitle"),I=t(e=>`${i}21;${n(e)}${o}`,"decswt"),N=t(e=>`${i}2L;${n(e)}${o}`,"decsin"),S=t(e=>`${i}0;${n(e)}${o}`,"setIconNameAndWindowTitleWithST"),h=t(e=>`${i}1;${n(e)}${o}`,"setIconNameWithST"),u=t(e=>`${i}2;${n(e)}${o}`,"setWindowTitleWithST");export{N as decsin,I as decswt,m as setIconName,W as setIconNameAndWindowTitle,S as setIconNameAndWindowTitleWithST,h as setIconNameWithST,w as setWindowTitle,u as setWindowTitleWithST};