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

package/dist/packem_shared/{ITerm2File-DzWaT6j3.js → ITerm2File-CUZDBk99.js}

@@ -27,7 +27,7 @@ const formatITerm2FileProperties = (properties) => {
     options.push(`name=${properties.name}`);
   }
   if (properties.size !== void 0) {
-    options.push(`size=${properties.size}`);
+    options.push(`size=${String(properties.size)}`);
   }
   if (properties.width !== void 0) {
     options.push(`width=${properties.width.toString()}`);
@@ -50,7 +50,7 @@ class ITerm2File {
   fileProps;
   /**
    * Constructs an `ITerm2File` payload object.
-   * @param properties An object containing properties for the file/image, as defined by {@link ITerm2FileProps}.
+   * @param properties An object containing properties for the file/image, as defined by {@link ITerm2FileProperties}.
    * 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
@@ -66,9 +66,7 @@ class ITerm2File {
         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;
-      }
+      this.fileProps.size ??= fileData.byteLength;
       if (this.fileProps.size !== fileData.byteLength) {
         throw new Error("File size property doesn't match actual data length");
       }
@@ -107,6 +105,7 @@ class ITerm2FilePart {
   constructor(base64Chunk) {
     this.base64Chunk = 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="`).
@@ -125,6 +124,7 @@ class ITerm2MultipartFileStart {
   constructor(properties) {
     this.properties = 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=..."`).

package/dist/packem_shared/cursor-ChpV7cgs.js

@@ -0,0 +1,72 @@
+import { C as CSI, E as ESC, S as SEP } from './constants-CE7WkXh_.js';
+import './restoreCursor-GfYEeJqN.js';
+
+const isBrowser = typeof globalThis !== "undefined" && typeof globalThis.window === "object" && globalThis.window.document !== void 0;
+const OSTYPE_REGEX = /^(?:msys|cygwin)$/;
+const isTerminalApp = !isBrowser && process.env.TERM_PROGRAM === "Apple_Terminal";
+const isWindows = !isBrowser && (process.platform === "win32" || OSTYPE_REGEX.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}${String(count)}D`;
+const cursorDown = (count = 1) => `${CSI}${String(count)}B`;
+const cursorForward = (count = 1) => `${CSI}${String(count)}C`;
+const cursorHide = `${CSI}?25l`;
+const cursorToColumn1 = `${CSI}G`;
+const cursorLeft = (count = 1) => cursorBackward(count);
+const cursorHorizontalAbsolute = (column = 1) => `${CSI}${String(column)}G`;
+const cursorMove = (x, y) => {
+  let returnValue = "";
+  if (x < 0) {
+    returnValue += `${CSI}${String(-x)}D`;
+  } else if (x > 0) {
+    returnValue += `${CSI}${String(x)}C`;
+  }
+  if (y < 0) {
+    returnValue += `${CSI}${String(-y)}A`;
+  } else if (y > 0) {
+    returnValue += `${CSI}${String(y)}B`;
+  }
+  return returnValue;
+};
+const cursorNextLine = (count = 1) => `${CSI}${String(count)}E`;
+const cursorPreviousLine = (count = 1) => `${CSI}${String(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}${String(y + 1)}${SEP}${String(x + 1)}H`;
+};
+const cursorPosition = (row, column) => {
+  if (column === void 0) {
+    return `${CSI}${String(row)}H`;
+  }
+  return `${CSI}${String(row)}${SEP}${String(column)}H`;
+};
+const cursorHorizontalForwardTab = (count = 1) => `${CSI}${String(count)}I`;
+const cursorBackwardTab = (count = 1) => `${CSI}${String(count)}Z`;
+const eraseCharacter = (count = 1) => `${CSI}${String(count)}X`;
+const cursorVerticalAbsolute = (row = 1) => `${CSI}${String(row)}d`;
+const cursorUp = (count = 1) => `${CSI}${String(count)}A`;
+var CursorStyle = /* @__PURE__ */ ((CursorStyle2) => {
+  CursorStyle2[CursorStyle2["Default"] = 0] = "Default";
+  CursorStyle2[CursorStyle2["BlinkingBlock"] = 1] = "BlinkingBlock";
+  CursorStyle2[CursorStyle2["SteadyBlock"] = 2] = "SteadyBlock";
+  CursorStyle2[CursorStyle2["BlinkingUnderline"] = 3] = "BlinkingUnderline";
+  CursorStyle2[CursorStyle2["SteadyUnderline"] = 4] = "SteadyUnderline";
+  CursorStyle2[CursorStyle2["BlinkingBar"] = 5] = "BlinkingBar";
+  CursorStyle2[CursorStyle2["SteadyBar"] = 6] = "SteadyBar";
+  return CursorStyle2;
+})(CursorStyle || {});
+const setCursorStyle = (style) => `${CSI}${String(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, REQUEST_EXTENDED_CURSOR_POSITION as d, RESTORE_CURSOR_DEC as e, cursorBackward as f, cursorBackwardTab as g, cursorDown as h, cursorForward as i, cursorHide as j, cursorHorizontalAbsolute as k, cursorHorizontalForwardTab as l, cursorLeft as m, cursorMove as n, cursorNextLine as o, cursorPosition as p, cursorPreviousLine as q, cursorRestore as r, cursorSave as s, cursorShow as t, cursorTo as u, cursorToColumn1 as v, cursorUp as w, cursorVerticalAbsolute as x, eraseCharacter as y, setCursorStyle as z };

package/dist/packem_shared/{resetProgressBar-kV21u2hs.js → resetProgressBar-D9r2s7eV.js}

@@ -3,16 +3,16 @@ 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}`;
+  return `${OSC}9;4;1;${String(clamped)}${BEL}`;
 };
 const setErrorProgressBar = (percentage) => {
   const clamped = Math.min(Math.max(0, percentage), 100);
-  return `${OSC}9;4;2;${clamped}${BEL}`;
+  return `${OSC}9;4;2;${String(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}`;
+  return `${OSC}9;4;4;${String(clamped)}${BEL}`;
 };
 
 export { resetProgressBar, setErrorProgressBar, setIndeterminateProgressBar, setProgressBar, setWarningProgressBar };

package/dist/screen.js

@@ -1,27 +1,27 @@
 import { C as CSI, S as SEP } from './packem_shared/constants-CE7WkXh_.js';
 
-const insertLine = (count = 1) => `${CSI + (count <= 1 ? "" : count)}L`;
-const deleteLine = (count = 1) => `${CSI + (count <= 1 ? "" : count)}M`;
+const insertLine = (count = 1) => `${CSI}${count <= 1 ? "" : String(count)}L`;
+const deleteLine = (count = 1) => `${CSI}${count <= 1 ? "" : String(count)}M`;
 const setTopBottomMargins = (top, bottom) => {
   const topString = top && top > 0 ? top.toString() : "";
   const bottomString = bottom && bottom > 0 ? bottom.toString() : "";
   if (topString === "" && bottomString === "") {
-    return `${CSI + SEP}r`;
+    return `${CSI}${SEP}r`;
   }
-  return `${CSI + topString + SEP + bottomString}r`;
+  return `${CSI}${topString}${SEP}${bottomString}r`;
 };
 const setLeftRightMargins = (left, right) => {
   const leftString = left && left > 0 ? left.toString() : "";
   const rightString = right && right > 0 ? right.toString() : "";
   if (leftString === "" && rightString === "") {
-    return `${CSI + SEP}s`;
+    return `${CSI}${SEP}s`;
   }
-  return `${CSI + leftString + SEP + rightString}s`;
+  return `${CSI}${leftString}${SEP}${rightString}s`;
 };
-const insertCharacter = (count = 1) => `${CSI + (count <= 1 ? "" : count)}@`;
-const deleteCharacter = (count = 1) => `${CSI + (count <= 1 ? "" : count)}P`;
-const clearTabStop = (mode = 0) => `${CSI + mode}g`;
-const requestPresentationStateReport = (mode) => `${CSI + mode}$u`;
-const repeatPreviousCharacter = (count = 1) => `${CSI + (count <= 1 ? "" : count)}b`;
+const insertCharacter = (count = 1) => `${CSI}${count <= 1 ? "" : String(count)}@`;
+const deleteCharacter = (count = 1) => `${CSI}${count <= 1 ? "" : String(count)}P`;
+const clearTabStop = (mode = 0) => `${CSI}${String(mode)}g`;
+const requestPresentationStateReport = (mode) => `${CSI}${String(mode)}$u`;
+const repeatPreviousCharacter = (count = 1) => `${CSI}${count <= 1 ? "" : String(count)}b`;
 
 export { clearTabStop, deleteCharacter, deleteLine, insertCharacter, insertLine, repeatPreviousCharacter, requestPresentationStateReport, setLeftRightMargins, setTopBottomMargins };

package/dist/scroll.js

@@ -4,13 +4,13 @@ const scrollUp = (count = 1) => {
   if (count === 0) {
     return "";
   }
-  return `${CSI + (count <= 1 ? "" : count)}S`;
+  return `${CSI}${count <= 1 ? "" : String(count)}S`;
 };
 const scrollDown = (count = 1) => {
   if (count === 0) {
     return "";
   }
-  return `${CSI + (count <= 1 ? "" : count)}T`;
+  return `${CSI}${count <= 1 ? "" : String(count)}T`;
 };
 const SCROLL_UP_1 = `${CSI}S`;
 const SCROLL_DOWN_1 = `${CSI}T`;

package/dist/status.d.ts

@@ -205,8 +205,8 @@ export declare const requestPrimaryDeviceAttributes: string;
 export declare const DA1: string;
 /**
  * Generates the response sequence for Primary Device Attributes (DA1).
- * Sequence: `CSI ? Ps ; ... c`
- *
+ * Sequence: `CSI ? Ps ; ... c`.
+ * @remarks
  * Common attributes include:
  * - 1  132 columns
  * - 2  Printer port
@@ -224,7 +224,7 @@ export declare const DA1: string;
  * - 42 ISO Latin-2 character set
  * - 44 PCTerm
  * - 45 Soft key map
- * - 46 ASCII emulation
+ * - 46 ASCII emulation.
  * @param attributes Numeric attribute codes.
  * @returns The DA1 response sequence.
  * @example
@@ -508,8 +508,9 @@ export declare const RequestLightDarkReport: string;
 /**
  * Generates a Light/Dark Color Scheme Report sequence.
  * This sequence reports the terminal's operating system light/dark color preference.
- * - `CSI ? 997 ; 1 n` for dark mode
- * - `CSI ? 997 ; 2 n` for light mode
+ * @remarks
+ * - `CSI ? 997 ; 1 n` for dark mode.
+ * - `CSI ? 997 ; 2 n` for light mode.
  * @param dark Whether the color scheme is dark mode (true) or light mode (false).
  * @returns The light/dark report sequence string.
  * @see {@link https://contour-terminal.org/vt-extensions/color-palette-update-notifications/}

package/dist/status.js

@@ -1,15 +1,17 @@
-import { S as SEP, C as CSI, D as DCS, a as ST } from './packem_shared/constants-CE7WkXh_.js';
+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);
@@ -18,18 +20,13 @@ const deviceStatusReport = (...reports) => {
   if (reports.length === 0) {
     return "";
   }
-  let hasDecReport = false;
-  const reportCodes = reports.map((report) => {
-    if (report.isDecReport) {
-      hasDecReport = true;
-    }
-    return report.reportCode.toString();
-  });
+  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`;
+  return `${seq}${reportCodes.join(SEP)}n`;
 };
 const DSR = (report) => deviceStatusReport(report);
 const requestCursorPositionReport = `${CSI}6n`;
@@ -37,7 +34,7 @@ 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`;
+  return `${CSI}${r.toString()}${SEP}${c.toString()}R`;
 };
 const CPR = cursorPositionReport;
 const extendedCursorPositionReport = (line, column, page) => {
@@ -68,7 +65,7 @@ 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}>${pv}${SEP}${pl}${SEP}${pc}c`;
+  return `${CSI}>${String(pv)}${SEP}${String(pl)}${SEP}${String(pc)}c`;
 };
 const requestTertiaryDeviceAttributes = `${CSI}=c`;
 const DA3 = requestTertiaryDeviceAttributes;

package/dist/strip.d.ts

@@ -1,23 +1,2 @@
-/**
- * Removes ANSI escape codes from a string.
- *
- * This function first removes OSC (Operating System Command) sequences like title strings
- * (e.g., `\u001B]0;title\u0007`) and then uses a comprehensive regex (from the `ansi-regex` package)
- * to strip all other ANSI escape codes.
- * @param input The string from which to remove ANSI escape codes.
- * @returns The input string with all ANSI escape codes stripped.
- * @example
- * ```typescript
- * import { strip } from "@visulima/ansi";
- *
- * const textWithAnsi = "\x1b[32mHello, \x1b[1mWorld!\x1b[0m";
- * const strippedText = strip(textWithAnsi);
- * console.log(strippedText); // Output: "Hello, World!"
- *
- * const titleSequence = "\u001B]0;My Window Title\u0007Some content";
- * const strippedTitle = strip(titleSequence);
- * console.log(strippedTitle); // Output: "Some content"
- * ```
- */
 declare const strip: (input: string) => string;
 export default strip;

package/dist/strip.js

@@ -7,6 +7,7 @@ function ansiRegex({ onlyFirst = false } = {}) {
 }
 
 const regex = ansiRegex();
-const strip = (input) => input.replace(/\u001B\]0;.*\u0007/, "").replace(regex, "");
+const OSC_TITLE_REGEX = /\u001B\]0;.*\u0007/;
+const strip = (input) => input.replace(OSC_TITLE_REGEX, "").replace(regex, "");
 
 export { strip as default };

package/dist/termcap.d.ts

@@ -1,6 +1,6 @@
 /**
  * Requests Termcap/Terminfo (XTGETTCAP) strings from the terminal.
- * Sequence: DCS + q <Pt> ST
+ * 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

package/dist/title.d.ts

@@ -64,59 +64,57 @@ export declare const setIconName: (iconName: string) => string;
 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)
+ *
+ * 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 (as implemented).
+ * @returns The ANSI escape sequence for DECSWT.
  * @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"
+ * // Sends: "\x1b]21;My Special Window\x1b\\"
  * ```
  */
 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)
+ *
+ * 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 (as implemented).
+ * @returns The ANSI escape sequence for DECSIN.
  * @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"
+ * // Sends: "\x1b]2L;SpecialIcon\x1b\\"
  * ```
  */
 export declare const decsin: (name: string) => string;

package/dist/title.js

@@ -1,16 +1,17 @@
-import { O as OSC, B as BEL, a as ST } from './packem_shared/constants-CE7WkXh_.js';
+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(/[\u0007\u001B]/g, "");
+  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) => setWindowTitle(`1;${title}`);
-const decsin = (name) => setWindowTitle(`L;${name}`);
+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}`;

package/dist/window-ops.d.ts

@@ -12,77 +12,65 @@ export declare enum XTermWindowOp {
      * Iconify window.
      */
     ICONIFY_WINDOW = 2,
-    /**
-     * Lower the window to the bottom of the stacking order.
-     */
-    LOWER_WINDOW = 6,
-    /**
-     * Maximize window (i.e., "zoom" or "toggle").
-     */
-    MAXIMIZE_WINDOW = 10,
-    /**
-     * Maximize window horizontally.
-     */
-    MAXIMIZE_WINDOW_HORIZONTALLY = 10.2,
-    /**
-     * Maximize window vertically.
-     */
-    MAXIMIZE_WINDOW_VERTICALLY = 10.1,
     /**
      * Move window to `[x, y]`.
      */
     MOVE_WINDOW = 3,
     /**
-     * Pop window title from stack.
-     */
-    POP_WINDOW_TITLE = 23,
-    /**
-     * Push window title on stack.
+     * Resize the text area to `[height, width]` in characters.
      */
-    PUSH_WINDOW_TITLE = 22,
+    RESIZE_TEXT_AREA_CHARS = 4,
     /**
      * Raise the window to the front of the stacking order.
      */
     RAISE_WINDOW = 5,
+    /**
+     * Lower the window to the bottom of the stacking order.
+     */
+    LOWER_WINDOW = 6,
     /**
      * Refresh the window.
      */
     REFRESH_WINDOW = 7,
     /**
-     * Report cell size in pixels.
-     * Response: `CSI 6 ; height ; width t`
+     * Resize the text area to `[height, width]` in pixels.
      */
-    REPORT_CELL_SIZE_PIXELS = 16,// From Go code
+    RESIZE_TEXT_AREA_PIXELS = 8,
     /**
-     * Report icon label.
-     * Response: `OSC L label ST`
+     * Restore maximized window.
      */
-    REPORT_ICON_LABEL = 19,
+    RESTORE_MAXIMIZED_WINDOW = 9,
     /**
-     * Report text area size in characters.
-     * Response: `CSI 4 ; height ; width t`
+     * Maximize window (i.e., "zoom" or "toggle").
      */
-    REPORT_TEXT_AREA_SIZE_CHARS = 14,
+    MAXIMIZE_WINDOW = 10,
     /**
-     * Report text area size in pixels.
-     * Response: `CSI 8 ; height ; width t`
+     * Maximize window vertically.
      */
-    REPORT_TEXT_AREA_SIZE_PIXELS = 18,
+    MAXIMIZE_WINDOW_VERTICALLY = 10.1,
     /**
-     * Report window position.
-     * Response: `CSI 3 ; x ; y t`
+     * Maximize window horizontally.
      */
-    REPORT_WINDOW_POSITION = 13,
+    MAXIMIZE_WINDOW_HORIZONTALLY = 10.2,
+    /**
+     * Undo full-screen mode.
+     */
+    UNDO_FULL_SCREEN_MODE = 10.3,// Note: XTerm docs list 10 ; 0, 10 ; 1, 10 ; 2, this is simplified.
     /**
      * Report window state.
      * Response: `CSI code t` where `code` is 1 if de-iconified, 2 if iconified.
      */
     REPORT_WINDOW_STATE = 11,
     /**
-     * Report window title.
-     * Response: `OSC l label ST`
+     * Report window position.
+     * Response: `CSI 3 ; x ; y t`
      */
-    REPORT_WINDOW_TITLE = 21,
+    REPORT_WINDOW_POSITION = 13,
+    /**
+     * Report text area size in characters.
+     * Response: `CSI 4 ; height ; width t`
+     */
+    REPORT_TEXT_AREA_SIZE_CHARS = 14,
     /**
      * Report window size in pixels.
      * Alias for `REPORT_TEXT_AREA_SIZE_PIXELS` for compatibility with some terminals (e.g., mintty).
@@ -91,26 +79,38 @@ export declare enum XTermWindowOp {
      */
     REQUEST_WINDOW_SIZE_WIN_OP_COMPAT = 14,// From Go code
     /**
-     * Resize the screen to `[width, height]` in pixels and resize the text area to `[cols, lines]` in characters.
-     * (DECSLPP - Set Lines Per Page)
+     * Report cell size in pixels.
+     * Response: `CSI 6 ; height ; width t`
      */
-    RESIZE_SCREEN_AND_TEXT_AREA = 24,// Typically with one param (lines), but XTerm extends it for width/height too
+    REPORT_CELL_SIZE_PIXELS = 16,// From Go code
     /**
-     * Resize the text area to `[height, width]` in characters.
+     * Report text area size in pixels.
+     * Response: `CSI 8 ; height ; width t`
      */
-    RESIZE_TEXT_AREA_CHARS = 4,
+    REPORT_TEXT_AREA_SIZE_PIXELS = 18,
     /**
-     * Resize the text area to `[height, width]` in pixels.
+     * Report icon label.
+     * Response: `OSC L label ST`
      */
-    RESIZE_TEXT_AREA_PIXELS = 8,
+    REPORT_ICON_LABEL = 19,
     /**
-     * Restore maximized window.
+     * Report window title.
+     * Response: `OSC l label ST`
      */
-    RESTORE_MAXIMIZED_WINDOW = 9,
+    REPORT_WINDOW_TITLE = 21,
     /**
-     * Undo full-screen mode.
+     * Push window title on stack.
+     */
+    PUSH_WINDOW_TITLE = 22,
+    /**
+     * Pop window title from stack.
+     */
+    POP_WINDOW_TITLE = 23,
+    /**
+     * Resize the screen to `[width, height]` in pixels and resize the text area to `[cols, lines]` in characters.
+     * (DECSLPP - Set Lines Per Page)
      */
-    UNDO_FULL_SCREEN_MODE = 10.3
+    RESIZE_SCREEN_AND_TEXT_AREA = 24
 }
 /**
  * Generates an XTerm Window Operation (XTWINOPS) sequence.
@@ -153,7 +153,7 @@ export declare const resizeTextAreaChars: (height: number, width: number) => str
  * This function uses `XTermWindowOp.REQUEST_WINDOW_SIZE_WIN_OP_COMPAT` (14), which corresponds to
  * `XTermWindowOp.REPORT_TEXT_AREA_SIZE_CHARS` in XTerm.
  *
- * Sequence: `CSI 14 t` (which triggers the report `CSI 4 ; height ; width t`)
+ * Sequence: `CSI 14 t` (which triggers the report `CSI 4 ; height ; width t`).
  * @returns The ANSI escape sequence to request the text area size in characters.
  * @see xtermWindowOp
  * @see XTermWindowOp.REPORT_TEXT_AREA_SIZE_CHARS
@@ -173,7 +173,7 @@ export declare const requestTextAreaSizeChars: () => string;
  * The terminal is expected to respond with a sequence like `CSI 6 ; height ; width t`,
  * where height and width are the dimensions of a single character cell in pixels.
  *
- * Sequence: `CSI 16 t` (which triggers the report `CSI 6 ; height ; width t`)
+ * Sequence: `CSI 16 t` (which triggers the report `CSI 6 ; height ; width t`).
  * @returns The ANSI escape sequence to request the cell size in pixels.
  * @see xtermWindowOp
  * @see XTermWindowOp.REPORT_CELL_SIZE_PIXELS
@@ -191,7 +191,7 @@ export declare const requestCellSizePixels: () => string;
  * Requests a report of the terminal window's text area size in pixels.
  * The terminal is expected to respond with a sequence like `CSI 8 ; height ; width t`.
  *
- * Sequence: `CSI 18 t` (which triggers the report `CSI 8 ; height ; width t`)
+ * Sequence: `CSI 18 t` (which triggers the report `CSI 8 ; height ; width t`).
  * @returns The ANSI escape sequence to request the text area size in pixels.
  * @see xtermWindowOp
  * @see XTermWindowOp.REPORT_TEXT_AREA_SIZE_PIXELS
@@ -344,7 +344,7 @@ export declare const restoreMaximizedWindow: () => string;
  * Some terminals might use `CSI 10 t` for a general maximize/toggle.
  * This function uses `XTermWindowOp.MAXIMIZE_WINDOW` which is 10.
  *
- * Sequence: `CSI 10 t` (using `XTermWindowOp.MAXIMIZE_WINDOW`)
+ * Sequence: `CSI 10 t` (using `XTermWindowOp.MAXIMIZE_WINDOW`).
  * @returns The ANSI escape sequence to maximize the window.
  * @see xtermWindowOp
  * @see XTermWindowOp.MAXIMIZE_WINDOW