@visulima/ansi 4.0.0-alpha.9 → 4.0.0

package/dist/window-ops.js

@@ -1,61 +1 @@
-import { C as CSI } from './packem_shared/constants-CE7WkXh_.js';
-
-var XTermWindowOp = /* @__PURE__ */ ((XTermWindowOp2) => {
-  XTermWindowOp2[XTermWindowOp2["DEICONIFY_WINDOW"] = 1] = "DEICONIFY_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["ICONIFY_WINDOW"] = 2] = "ICONIFY_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["MOVE_WINDOW"] = 3] = "MOVE_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["RESIZE_TEXT_AREA_CHARS"] = 4] = "RESIZE_TEXT_AREA_CHARS";
-  XTermWindowOp2[XTermWindowOp2["RAISE_WINDOW"] = 5] = "RAISE_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["LOWER_WINDOW"] = 6] = "LOWER_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["REFRESH_WINDOW"] = 7] = "REFRESH_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["RESIZE_TEXT_AREA_PIXELS"] = 8] = "RESIZE_TEXT_AREA_PIXELS";
-  XTermWindowOp2[XTermWindowOp2["RESTORE_MAXIMIZED_WINDOW"] = 9] = "RESTORE_MAXIMIZED_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["MAXIMIZE_WINDOW"] = 10] = "MAXIMIZE_WINDOW";
-  XTermWindowOp2[XTermWindowOp2["MAXIMIZE_WINDOW_VERTICALLY"] = 10.1] = "MAXIMIZE_WINDOW_VERTICALLY";
-  XTermWindowOp2[XTermWindowOp2["MAXIMIZE_WINDOW_HORIZONTALLY"] = 10.2] = "MAXIMIZE_WINDOW_HORIZONTALLY";
-  XTermWindowOp2[XTermWindowOp2["UNDO_FULL_SCREEN_MODE"] = 10.3] = "UNDO_FULL_SCREEN_MODE";
-  XTermWindowOp2[XTermWindowOp2["REPORT_WINDOW_STATE"] = 11] = "REPORT_WINDOW_STATE";
-  XTermWindowOp2[XTermWindowOp2["REPORT_WINDOW_POSITION"] = 13] = "REPORT_WINDOW_POSITION";
-  XTermWindowOp2[XTermWindowOp2["REPORT_TEXT_AREA_SIZE_CHARS"] = 14] = "REPORT_TEXT_AREA_SIZE_CHARS";
-  XTermWindowOp2[XTermWindowOp2["REQUEST_WINDOW_SIZE_WIN_OP_COMPAT"] = 14] = "REQUEST_WINDOW_SIZE_WIN_OP_COMPAT";
-  XTermWindowOp2[XTermWindowOp2["REPORT_CELL_SIZE_PIXELS"] = 16] = "REPORT_CELL_SIZE_PIXELS";
-  XTermWindowOp2[XTermWindowOp2["REPORT_TEXT_AREA_SIZE_PIXELS"] = 18] = "REPORT_TEXT_AREA_SIZE_PIXELS";
-  XTermWindowOp2[XTermWindowOp2["REPORT_ICON_LABEL"] = 19] = "REPORT_ICON_LABEL";
-  XTermWindowOp2[XTermWindowOp2["REPORT_WINDOW_TITLE"] = 21] = "REPORT_WINDOW_TITLE";
-  XTermWindowOp2[XTermWindowOp2["PUSH_WINDOW_TITLE"] = 22] = "PUSH_WINDOW_TITLE";
-  XTermWindowOp2[XTermWindowOp2["POP_WINDOW_TITLE"] = 23] = "POP_WINDOW_TITLE";
-  XTermWindowOp2[XTermWindowOp2["RESIZE_SCREEN_AND_TEXT_AREA"] = 24] = "RESIZE_SCREEN_AND_TEXT_AREA";
-  return XTermWindowOp2;
-})(XTermWindowOp || {});
-const xtermWindowOp = (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];
-  ps.forEach((value) => {
-    if (value >= 0) {
-      parameters.push(value);
-    }
-  });
-  return `${CSI}${parameters.join(";")}t`;
-};
-const XTWINOPS = xtermWindowOp;
-const resizeTextAreaChars = (height, width) => xtermWindowOp(4 /* RESIZE_TEXT_AREA_CHARS */, height, width);
-const requestTextAreaSizeChars = () => xtermWindowOp(14 /* REQUEST_WINDOW_SIZE_WIN_OP_COMPAT */);
-const requestCellSizePixels = () => xtermWindowOp(16 /* REPORT_CELL_SIZE_PIXELS */);
-const requestTextAreaSizePixels = () => xtermWindowOp(18 /* REPORT_TEXT_AREA_SIZE_PIXELS */);
-const deiconifyWindow = () => xtermWindowOp(1 /* DEICONIFY_WINDOW */);
-const iconifyWindow = () => xtermWindowOp(2 /* ICONIFY_WINDOW */);
-const moveWindow = (x, y) => xtermWindowOp(3 /* MOVE_WINDOW */, x, y);
-const raiseWindow = () => xtermWindowOp(5 /* RAISE_WINDOW */);
-const lowerWindow = () => xtermWindowOp(6 /* LOWER_WINDOW */);
-const refreshWindow = () => xtermWindowOp(7 /* REFRESH_WINDOW */);
-const resizeTextAreaPixels = (height, width) => xtermWindowOp(8 /* RESIZE_TEXT_AREA_PIXELS */, height, width);
-const restoreMaximizedWindow = () => xtermWindowOp(9 /* RESTORE_MAXIMIZED_WINDOW */);
-const maximizeWindow = () => xtermWindowOp(10 /* MAXIMIZE_WINDOW */);
-const reportWindowPosition = () => xtermWindowOp(13 /* REPORT_WINDOW_POSITION */);
-const reportWindowState = () => xtermWindowOp(11 /* REPORT_WINDOW_STATE */);
-const setPageSizeLines = (lines) => xtermWindowOp(24 /* RESIZE_SCREEN_AND_TEXT_AREA */, lines);
-
-export { XTWINOPS, XTermWindowOp, deiconifyWindow, iconifyWindow, lowerWindow, maximizeWindow, moveWindow, raiseWindow, refreshWindow, reportWindowPosition, reportWindowState, requestCellSizePixels, requestTextAreaSizeChars, requestTextAreaSizePixels, resizeTextAreaChars, resizeTextAreaPixels, restoreMaximizedWindow, setPageSizeLines, xtermWindowOp };
+import{CSI as T}from"./constants.js";var E=(_=>(_[_.DEICONIFY_WINDOW=1]="DEICONIFY_WINDOW",_[_.ICONIFY_WINDOW=2]="ICONIFY_WINDOW",_[_.MOVE_WINDOW=3]="MOVE_WINDOW",_[_.RESIZE_TEXT_AREA_CHARS=4]="RESIZE_TEXT_AREA_CHARS",_[_.RAISE_WINDOW=5]="RAISE_WINDOW",_[_.LOWER_WINDOW=6]="LOWER_WINDOW",_[_.REFRESH_WINDOW=7]="REFRESH_WINDOW",_[_.RESIZE_TEXT_AREA_PIXELS=8]="RESIZE_TEXT_AREA_PIXELS",_[_.RESTORE_MAXIMIZED_WINDOW=9]="RESTORE_MAXIMIZED_WINDOW",_[_.MAXIMIZE_WINDOW=10]="MAXIMIZE_WINDOW",_[_.MAXIMIZE_WINDOW_VERTICALLY=10.1]="MAXIMIZE_WINDOW_VERTICALLY",_[_.MAXIMIZE_WINDOW_HORIZONTALLY=10.2]="MAXIMIZE_WINDOW_HORIZONTALLY",_[_.UNDO_FULL_SCREEN_MODE=10.3]="UNDO_FULL_SCREEN_MODE",_[_.REPORT_WINDOW_STATE=11]="REPORT_WINDOW_STATE",_[_.REPORT_WINDOW_POSITION=13]="REPORT_WINDOW_POSITION",_[_.REPORT_TEXT_AREA_SIZE_CHARS=14]="REPORT_TEXT_AREA_SIZE_CHARS",_[_.REQUEST_WINDOW_SIZE_WIN_OP_COMPAT=14]="REQUEST_WINDOW_SIZE_WIN_OP_COMPAT",_[_.REPORT_CELL_SIZE_PIXELS=16]="REPORT_CELL_SIZE_PIXELS",_[_.REPORT_TEXT_AREA_SIZE_PIXELS=18]="REPORT_TEXT_AREA_SIZE_PIXELS",_[_.REPORT_ICON_LABEL=19]="REPORT_ICON_LABEL",_[_.REPORT_WINDOW_TITLE=21]="REPORT_WINDOW_TITLE",_[_.PUSH_WINDOW_TITLE=22]="PUSH_WINDOW_TITLE",_[_.POP_WINDOW_TITLE=23]="POP_WINDOW_TITLE",_[_.RESIZE_SCREEN_AND_TEXT_AREA=24]="RESIZE_SCREEN_AND_TEXT_AREA",_))(E||{});const I=(_,...W)=>{if(![10.1,10.2,10.3].includes(_)&&_<=0)return"";const O=[_];return W.forEach(R=>{R>=0&&O.push(R)}),`${T}${O.join(";")}t`},A=I,S=(_,W)=>I(4,_,W),e=()=>I(14),D=()=>I(16),i=()=>I(18),P=()=>I(1),L=()=>I(2),r=(_,W)=>I(3,_,W),o=()=>I(5),X=()=>I(6),C=()=>I(7),Z=(_,W)=>I(8,_,W),t=()=>I(9),M=()=>I(10),n=()=>I(13),s=()=>I(11),d=_=>I(24,_);export{A as XTWINOPS,E as XTermWindowOp,P as deiconifyWindow,L as iconifyWindow,X as lowerWindow,M as maximizeWindow,r as moveWindow,o as raiseWindow,C as refreshWindow,n as reportWindowPosition,s as reportWindowState,D as requestCellSizePixels,e as requestTextAreaSizeChars,i as requestTextAreaSizePixels,S as resizeTextAreaChars,Z as resizeTextAreaPixels,t as restoreMaximizedWindow,d as setPageSizeLines,I as xtermWindowOp};

package/dist/xterm.d.ts

@@ -1,94 +1,177 @@
 /**
- * XTerm Key Modifier Options (XTMODKEYS).
- * Sets or resets XTerm key modifier resources.
- *
- * Sequence: `CSI > Pp m` (to reset resource Pp).
- * Sequence: `CSI > Pp ; Pv m` (to set resource Pp to value Pv).
- * @param resource The resource parameter (Pp), a non-negative integer.
- * @param value Optional. The value parameter (Pv), a non-negative integer. If omitted, the resource is reset.
- * If provided and not positive, it's treated as if omitted (resource is reset).
- * @returns The ANSI escape sequence.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Functions-using-CSI-_-ordered-by-the-final-character_s_}
- */
-export declare const keyModifierOptions: (resource: number, value?: number) => string;
+* XTerm Key Modifier Options (XTMODKEYS).
+* Sets or resets XTerm key modifier resources.
+*
+* Sequence: `CSI > Pp m` (to reset resource Pp).
+* Sequence: `CSI > Pp ; Pv m` (to set resource Pp to value Pv).
+* @param resource The resource parameter (Pp), a non-negative integer.
+* @param value Optional. The value parameter (Pv), a non-negative integer. If omitted, the resource is reset.
+* If provided and not positive, it's treated as if omitted (resource is reset).
+* @returns The ANSI escape sequence.
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Functions-using-CSI-_-ordered-by-the-final-character_s_}
+*/
+declare const keyModifierOptions: (resource: number, value?: number) => string;
 /**
- * Alias for {@link keyModifierOptions}.
- * Provides a shorthand for setting or resetting XTerm key modifier resources.
- * @see keyModifierOptions
- */
-export declare const XTMODKEYS: (resource: number, value?: number) => string;
+* Alias for {@link keyModifierOptions}.
+* Provides a shorthand for setting or resetting XTerm key modifier resources.
+* @see keyModifierOptions
+*/
+declare const XTMODKEYS: (resource: number, value?: number) => string;
 /**
- * Query XTerm Key Modifier Options (XTQMODKEYS).
- * Requests the current setting of an XTerm key modifier resource.
- *
- * Sequence: `CSI ? Pp m`
- * @param resource The resource parameter (Pp), a non-negative integer.
- * @returns The ANSI escape sequence.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Functions-using-CSI-_-ordered-by-the-final-character_s_}
- */
-export declare const queryKeyModifierOptions: (resource: number) => string;
+* Query XTerm Key Modifier Options (XTQMODKEYS).
+* Requests the current setting of an XTerm key modifier resource.
+*
+* Sequence: `CSI ? Pp m`
+* @param resource The resource parameter (Pp), a non-negative integer.
+* @returns The ANSI escape sequence.
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Functions-using-CSI-_-ordered-by-the-final-character_s_}
+*/
+declare const queryKeyModifierOptions: (resource: number) => string;
 /**
- * Resets an XTerm key modifier resource to its initial value.
- * This is an alias for `keyModifierOptions(resource)`.
- * @param resource The resource parameter (Pp).
- */
-export declare const resetKeyModifierOptions: (resource: number) => string;
+* Resets an XTerm key modifier resource to its initial value.
+* This is an alias for `keyModifierOptions(resource)`.
+* @param resource The resource parameter (Pp).
+*/
+declare const resetKeyModifierOptions: (resource: number) => string;
 /**
- * Sets an XTerm key modifier resource to a specific value.
- * This is a more explicit alias for `keyModifierOptions(resource, value)`.
- * @param resource The resource parameter (Pp).
- * @param value The value parameter (Pv).
- */
-export declare const setKeyModifierOptions: (resource: number, value: number) => string;
+* Sets an XTerm key modifier resource to a specific value.
+* This is a more explicit alias for `keyModifierOptions(resource, value)`.
+* @param resource The resource parameter (Pp).
+* @param value The value parameter (Pv).
+*/
+declare const setKeyModifierOptions: (resource: number, value: number) => string;
 /** Alias for {@link queryKeyModifierOptions}. */
-export declare const XTQMODKEYS: (resource: number) => string;
+declare const XTQMODKEYS: (resource: number) => string;
 /**
- * Set XTerm "modifyOtherKeys" mode to mode 1 (sends modified escape sequences for certain keys).
- * Sequence: `CSI > 4 ; 1 m`
- * @example
- * ```typescript
- * import { setModifyOtherKeys1 } from "@visulima/ansi";
- *
- * process.stdout.write(setModifyOtherKeys1);
- * // Sends: "\x1b[>4;1m"
- * ```
- */
-export declare const setModifyOtherKeys1: string;
+* Set XTerm "modifyOtherKeys" mode to mode 1 (sends modified escape sequences for certain keys).
+* Sequence: `CSI > 4 ; 1 m`
+* @example
+* ```typescript
+* import { setModifyOtherKeys1 } from "@visulima/ansi";
+*
+* process.stdout.write(setModifyOtherKeys1);
+* // Sends: "\x1b[>4;1m"
+* ```
+*/
+declare const setModifyOtherKeys1: string;
 /**
- * Set XTerm "modifyOtherKeys" mode to mode 2 (alternative modified escape sequences).
- * Sequence: `CSI > 4 ; 2 m`
- * @example
- * ```typescript
- * import { setModifyOtherKeys2 } from "@visulima/ansi";
- *
- * process.stdout.write(setModifyOtherKeys2);
- * // Sends: "\x1b[>4;2m"
- * ```
- */
-export declare const setModifyOtherKeys2: string;
+* Set XTerm "modifyOtherKeys" mode to mode 2 (alternative modified escape sequences).
+* Sequence: `CSI > 4 ; 2 m`
+* @example
+* ```typescript
+* import { setModifyOtherKeys2 } from "@visulima/ansi";
+*
+* process.stdout.write(setModifyOtherKeys2);
+* // Sends: "\x1b[>4;2m"
+* ```
+*/
+declare const setModifyOtherKeys2: string;
 /**
- * Reset XTerm "modifyOtherKeys" to its default behavior (mode 0 or initial value).
- * Sequence: `CSI > 4 m` (This effectively sets resource 4, value 0, or resets resource 4).
- * @example
- * ```typescript
- * import { resetModifyOtherKeys } from "@visulima/ansi";
- *
- * process.stdout.write(resetModifyOtherKeys);
- * // Sends: "\x1b[>4m"
- * ```
- */
-export declare const resetModifyOtherKeys: string;
+* Reset XTerm "modifyOtherKeys" to its default behavior (mode 0 or initial value).
+* Sequence: `CSI > 4 m` (This effectively sets resource 4, value 0, or resets resource 4).
+* @example
+* ```typescript
+* import { resetModifyOtherKeys } from "@visulima/ansi";
+*
+* process.stdout.write(resetModifyOtherKeys);
+* // Sends: "\x1b[>4m"
+* ```
+*/
+declare const resetModifyOtherKeys: string;
 /**
- * Query the current XTerm "modifyOtherKeys" mode.
- * Sequence: `CSI ? 4 m`
- * Response: `CSI > 4 ; Ps m` where Ps is 0, 1, or 2.
- * @example
- * ```typescript
- * import { queryModifyOtherKeys } from "@visulima/ansi";
- *
- * process.stdout.write(queryModifyOtherKeys);
- * // Sends: "\x1b[?4m"
- * // Expect a response like: "\x1b[>4;1m" if mode 1 is set.
- * ```
- */
-export declare const queryModifyOtherKeys: string;
+* Query the current XTerm "modifyOtherKeys" mode.
+* Sequence: `CSI ? 4 m`
+* Response: `CSI > 4 ; Ps m` where Ps is 0, 1, or 2.
+* @example
+* ```typescript
+* import { queryModifyOtherKeys } from "@visulima/ansi";
+*
+* process.stdout.write(queryModifyOtherKeys);
+* // Sends: "\x1b[?4m"
+* // Expect a response like: "\x1b[>4;1m" if mode 1 is set.
+* ```
+*/
+declare const queryModifyOtherKeys: string;
+/**
+* Bit flags for the Kitty keyboard protocol progressive-enhancement level.
+*
+* Combine members with bitwise OR to request multiple enhancements at once.
+* @see {@link https://sw.kovidgoyal.net/kitty/keyboard-protocol/#progressive-enhancement}
+*/
+declare const KittyKeyboardFlag: {
+  /** Disambiguate escape codes so modifier+key combos are unambiguous. */
+  readonly DisambiguateEscapeCodes: 1;
+  /** Report all keys as escape codes (so e.g. Enter/Tab/Backspace are reported uniformly). */
+  readonly ReportAllKeysAsEscapeCodes: 16;
+  /** Report alternate keys (e.g. shifted layout keys and the base layout key). */
+  readonly ReportAlternateKeys: 8;
+  /** Embed the text the key would produce in the escape code. */
+  readonly ReportAssociatedText: 4;
+  /** Add event-type data, enabling key-release (and repeat) reporting. */
+  readonly ReportEventTypes: 2;
+};
+/**
+* A Kitty keyboard protocol flag value: a bitwise OR of {@link KittyKeyboardFlag}
+* members (range `0`-`31`).
+*/
+type KittyKeyboardFlags = number;
+/**
+* Pushes a new set of Kitty keyboard protocol flags onto the terminal's stack.
+*
+* Sequence: `CSI > flags u`
+* @param flags Bitwise OR of {@link KittyKeyboardFlag} values. Defaults to {@link KittyKeyboardFlag.DisambiguateEscapeCodes}.
+* @returns The escape sequence enabling the requested enhancement level.
+* @example
+* ```typescript
+* import { pushKittyKeyboard, KittyKeyboardFlag as Flag } from "@visulima/ansi/xterm";
+*
+* const flags = Flag.DisambiguateEscapeCodes | Flag.ReportEventTypes;
+*
+* process.stdout.write(pushKittyKeyboard(flags));
+* ```
+* @see {@link https://sw.kovidgoyal.net/kitty/keyboard-protocol/#progressive-enhancement}
+*/
+declare const pushKittyKeyboard: (flags?: KittyKeyboardFlags) => string;
+/**
+* Pops one or more entries from the terminal's Kitty keyboard protocol flag stack,
+* restoring the previous enhancement level. Call this on exit to undo {@link pushKittyKeyboard}.
+*
+* Sequence: `CSI < number u`
+* @param count How many stack entries to pop. Defaults to `1`.
+* @returns The escape sequence popping the stack.
+* @example
+* ```typescript
+* import { popKittyKeyboard } from "@visulima/ansi/xterm";
+*
+* process.stdout.write(popKittyKeyboard());
+* ```
+* @see {@link https://sw.kovidgoyal.net/kitty/keyboard-protocol/#progressive-enhancement}
+*/
+declare const popKittyKeyboard: (count?: number) => string;
+/**
+* Sets the Kitty keyboard protocol flags, replacing the current top-of-stack
+* entry (mode `1`) rather than pushing a new one.
+*
+* Sequence: `CSI = flags ; 1 u`
+* @param flags Bitwise OR of {@link KittyKeyboardFlag} values.
+* @returns The escape sequence setting the flags.
+* @see {@link https://sw.kovidgoyal.net/kitty/keyboard-protocol/#progressive-enhancement}
+*/
+declare const setKittyKeyboard: (flags?: KittyKeyboardFlags) => string;
+/**
+* Queries the terminal's current Kitty keyboard protocol flags.
+*
+* Sequence: `CSI ? u`
+* Response: `CSI ? flags u`.
+* @returns The query escape sequence.
+* @example
+* ```typescript
+* import { queryKittyKeyboard } from "@visulima/ansi/xterm";
+*
+* process.stdout.write(queryKittyKeyboard);
+* // Expect a response like: "\x1b[?1u"
+* ```
+* @see {@link https://sw.kovidgoyal.net/kitty/keyboard-protocol/#progressive-enhancement}
+*/
+declare const queryKittyKeyboard: string;
+export { KittyKeyboardFlag, KittyKeyboardFlags, XTMODKEYS, XTQMODKEYS, keyModifierOptions, popKittyKeyboard, pushKittyKeyboard, queryKeyModifierOptions, queryKittyKeyboard, queryModifyOtherKeys, resetKeyModifierOptions, resetModifyOtherKeys, setKeyModifierOptions, setKittyKeyboard, setModifyOtherKeys1, setModifyOtherKeys2 };

package/dist/xterm.js

@@ -1,33 +1 @@
-import { C as CSI } from './packem_shared/constants-CE7WkXh_.js';
-
-const keyModifierOptions = (resource, value) => {
-  if (resource < 0 || !Number.isInteger(resource)) {
-    return "";
-  }
-  const pp = resource.toString();
-  if (value !== void 0) {
-    if (!Number.isInteger(value)) {
-      return "";
-    }
-    const pv = value.toString();
-    return `${CSI}>${pp};${pv}m`;
-  }
-  return `${CSI}>${pp}m`;
-};
-const XTMODKEYS = keyModifierOptions;
-const queryKeyModifierOptions = (resource) => {
-  if (resource < 0 || !Number.isInteger(resource)) {
-    return "";
-  }
-  const pp = resource.toString();
-  return `${CSI}?${pp}m`;
-};
-const resetKeyModifierOptions = (resource) => keyModifierOptions(resource);
-const setKeyModifierOptions = (resource, value) => keyModifierOptions(resource, value);
-const XTQMODKEYS = queryKeyModifierOptions;
-const setModifyOtherKeys1 = `${CSI}>4;1m`;
-const setModifyOtherKeys2 = `${CSI}>4;2m`;
-const resetModifyOtherKeys = `${CSI}>4m`;
-const queryModifyOtherKeys = `${CSI}?4m`;
-
-export { XTMODKEYS, XTQMODKEYS, keyModifierOptions, queryKeyModifierOptions, queryModifyOtherKeys, resetKeyModifierOptions, resetModifyOtherKeys, setKeyModifierOptions, setModifyOtherKeys1, setModifyOtherKeys2 };
+import{CSI as t}from"./constants.js";const i=(e,r)=>{if(e<0||!Number.isInteger(e))return"";const s=e.toString();if(r!==void 0){if(!Number.isInteger(r))return"";const n=r.toString();return`${t}>${s};${n}m`}return`${t}>${s}m`},K=i,y=e=>{if(e<0||!Number.isInteger(e))return"";const r=e.toString();return`${t}?${r}m`},d=e=>i(e),a=(e,r)=>i(e,r),m=y,p=`${t}>4;1m`,$=`${t}>4;2m`,g=`${t}>4m`,b=`${t}?4m`,o={DisambiguateEscapeCodes:1,ReportAllKeysAsEscapeCodes:16,ReportAlternateKeys:8,ReportAssociatedText:4,ReportEventTypes:2},f=(e=o.DisambiguateEscapeCodes)=>`${t}>${(Number.isInteger(e)&&e>=0?e:0).toString()}u`,M=(e=1)=>`${t}<${(Number.isInteger(e)&&e>0?e:1).toString()}u`,O=(e=o.DisambiguateEscapeCodes)=>`${t}=${(Number.isInteger(e)&&e>=0?e:0).toString()};1u`,c=`${t}?u`;export{o as KittyKeyboardFlag,K as XTMODKEYS,m as XTQMODKEYS,i as keyModifierOptions,M as popKittyKeyboard,f as pushKittyKeyboard,y as queryKeyModifierOptions,c as queryKittyKeyboard,b as queryModifyOtherKeys,d as resetKeyModifierOptions,g as resetModifyOtherKeys,a as setKeyModifierOptions,O as setKittyKeyboard,p as setModifyOtherKeys1,$ as setModifyOtherKeys2};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/ansi",
-  "version": "4.0.0-alpha.9",
+  "version": "4.0.0",
   "description": "ANSI escape codes for some terminal swag.",
   "keywords": [
     "alternative-screen",
@@ -17,11 +17,11 @@
     "escape",
     "escapes",
     "formatting",
+    "hyperlink",
     "image",
     "iterm",
     "iterm2",
     "link",
-    "hyperlink",
     "log",
     "logging",
     "screen",
@@ -40,9 +40,7 @@
     "xterm"
   ],
   "homepage": "https://visulima.com/packages/ansi",
-  "bugs": {
-    "url": "https://github.com/visulima/visulima/issues"
-  },
+  "bugs": "https://github.com/visulima/visulima/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -74,18 +72,46 @@
       "types": "./dist/alternative-screen.d.ts",
       "default": "./dist/alternative-screen.js"
     },
+    "./background": {
+      "types": "./dist/background.d.ts",
+      "default": "./dist/background.js"
+    },
+    "./charset": {
+      "types": "./dist/charset.d.ts",
+      "default": "./dist/charset.js"
+    },
     "./clear": {
       "types": "./dist/clear.d.ts",
       "default": "./dist/clear.js"
     },
+    "./clipboard": {
+      "types": "./dist/clipboard.d.ts",
+      "default": "./dist/clipboard.js"
+    },
+    "./constants": {
+      "types": "./dist/constants.d.ts",
+      "default": "./dist/constants.js"
+    },
     "./cursor": {
       "types": "./dist/cursor.d.ts",
       "default": "./dist/cursor.js"
     },
+    "./cwd": {
+      "types": "./dist/cwd.d.ts",
+      "default": "./dist/cwd.js"
+    },
     "./erase": {
       "types": "./dist/erase.d.ts",
       "default": "./dist/erase.js"
     },
+    "./finalterm": {
+      "types": "./dist/finalterm.d.ts",
+      "default": "./dist/finalterm.js"
+    },
+    "./focus": {
+      "types": "./dist/focus.d.ts",
+      "default": "./dist/focus.js"
+    },
     "./image": {
       "types": "./dist/image.d.ts",
       "default": "./dist/image.js"
@@ -98,6 +124,10 @@
       "types": "./dist/scroll.d.ts",
       "default": "./dist/scroll.js"
     },
+    "./sixel": {
+      "types": "./dist/sixel.d.ts",
+      "default": "./dist/sixel.js"
+    },
     "./strip": {
       "types": "./dist/strip.d.ts",
       "default": "./dist/strip.js"
@@ -110,6 +140,10 @@
       "types": "./dist/title.d.ts",
       "default": "./dist/title.js"
     },
+    "./urxvt": {
+      "types": "./dist/urxvt.d.ts",
+      "default": "./dist/urxvt.js"
+    },
     "./window-ops": {
       "types": "./dist/window-ops.d.ts",
       "default": "./dist/window-ops.js"
@@ -122,6 +156,14 @@
       "types": "./dist/iterm2.d.ts",
       "default": "./dist/iterm2.js"
     },
+    "./keypad": {
+      "types": "./dist/keypad.d.ts",
+      "default": "./dist/keypad.js"
+    },
+    "./kitty-graphics": {
+      "types": "./dist/kitty-graphics.d.ts",
+      "default": "./dist/kitty-graphics.js"
+    },
     "./mode": {
       "types": "./dist/mode.d.ts",
       "default": "./dist/mode.js"
@@ -130,10 +172,22 @@
       "types": "./dist/mouse.d.ts",
       "default": "./dist/mouse.js"
     },
+    "./notification": {
+      "types": "./dist/notification.d.ts",
+      "default": "./dist/notification.js"
+    },
     "./passthrough": {
       "types": "./dist/passthrough.d.ts",
       "default": "./dist/passthrough.js"
     },
+    "./paste": {
+      "types": "./dist/paste.d.ts",
+      "default": "./dist/paste.js"
+    },
+    "./progress": {
+      "types": "./dist/progress.d.ts",
+      "default": "./dist/progress.js"
+    },
     "./reset": {
       "types": "./dist/reset.d.ts",
       "default": "./dist/reset.js"
@@ -153,11 +207,8 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "dependencies": {
-    "type-fest": "5.5.0"
-  },
   "engines": {
-    "node": ">=22.13 <=25.x"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "publishConfig": {
     "access": "public",

package/dist/helpers.d.ts

@@ -1,14 +0,0 @@
-/**
- * Checks if the current environment is a browser-like environment.
- * It specifically checks for the presence of `globalThis.window.document`.
- */
-/**
- * Indicates whether the code is running inside Apple's Terminal.app.
- * This is true if not in a browser and the `TERM_PROGRAM` environment variable is "Apple_Terminal".
- */
-export declare const isTerminalApp: boolean;
-/**
- * Indicates whether the current platform is Windows.
- * This is true if not in a browser and `process.platform` is "win32".
- */
-export declare const isWindows: boolean;

package/dist/iterm2/iterm2-properties.d.ts

@@ -1,135 +0,0 @@
-import type { LiteralUnion } from "type-fest";
-/**
- * Represents the special string value `'auto'` used for iTerm2 image or file dimensions.
- * When `'auto'` is used for width or height, the terminal (iTerm2) determines the appropriate dimension
- * based on the image's inherent size or other context.
- * @example `width: IT2_AUTO`
- */
-export declare const IT2_AUTO: string;
-/**
- * Formats a number as a string representing a dimension in character cells for iTerm2.
- * iTerm2 interprets plain numbers for width/height as character cell counts.
- * @param n The number of character cells.
- * @returns A string representation of the number (e.g., `10` becomes `"10"`).
- * @example
- * ```typescript
- * const widthInCells = it2Cells(20); // "20"
- * const sequence = `File=width=${widthInCells}`;
- * ```
- */
-export declare const it2Cells: (n: number) => string;
-/**
- * Formats a number as a string representing a dimension in pixels for iTerm2.
- * Appends `px` to the number.
- * @param n The number of pixels.
- * @returns A string representing the dimension in pixels (e.g., `100` becomes `"100px"`).
- * @example
- * ```typescript
- * const heightInPixels = it2Pixels(150);
- * const sequence = `File=height=${heightInPixels}`;
- * ```
- */
-export declare const it2Pixels: (n: number) => string;
-/**
- * Formats a number as a string representing a dimension as a percentage for iTerm2.
- * Appends `%` to the number.
- * @param n The percentage value (e.g., `50` for 50%).
- * @returns A string representing the dimension as a percentage (e.g., `50` becomes `"50%"`).
- * @example
- * ```typescript
- * const widthAsPercentage = it2Percent(75);
- * const sequence = `File=width=${widthAsPercentage}`;
- * ```
- */
-export declare const it2Percent: (n: number) => string;
-/**
- * Defines the interface for any iTerm2 OSC 1337 payload object.
- *
- * An OSC 1337 sequence has the general form: `OSC 1337 ; <payload_string> BEL`.
- * Objects implementing this interface are responsible for generating that `<payload_string>`
- * via their `toString()` method. This allows for a structured way to build various iTerm2 commands.
- * @see `iTerm2` function in `iterm2.ts` which consumes objects of this type.
- */
-export interface IITerm2Payload {
-    /**
-     * Converts the payload object into its specific string representation required for an iTerm2 OSC 1337 command.
-     * For example, for a file transfer, this might return `"File=name=...;size=...:content..."`.
-     * @returns The string payload part of the OSC 1337 sequence.
-     */
-    toString: () => string;
-}
-/**
- * Defines the properties for an iTerm2 file transfer or inline image display command (`File=...`).
- * These correspond to the key-value pairs used within the `File=` argument of the OSC 1337 sequence.
- * @see {@link https://iterm2.com/documentation-escape-codes.html} iTerm2 Escape Codes (search for `File=`)
- * @see {@link https://iterm2.com/documentation-images.html} iTerm2 Inline Images Protocol
- */
-export interface ITerm2FileProperties {
-    /**
-     * The Base64 encoded content of the file or image.
-     * This is typically used when `inline=1` is set for images, or for transferring small files directly
-     * within the escape sequence. For larger files, multipart transfer is recommended.
-     * @remarks The `ITerm2File` class can handle the Base64 encoding of `Uint8Array` data automatically.
-     */
-    content?: string;
-    /**
-     * If `true`, instructs the terminal not to move the cursor after displaying an inline image.
-     * Corresponds to `doNotMoveCursor=1` in the sequence.
-     * This is a WezTerm extension, also supported by iTerm2 beta/nightly builds as of some versions.
-     * @default false (cursor behavior is default terminal behavior)
-     */
-    doNotMoveCursor?: boolean;
-    /**
-     * The display height of the image or file placeholder.
-     * Can be:
-     * - A number (interpreted as character cells, e.g., `10`).
-     * - A string with units: `"Npx"` (N pixels), `"N%"` (N percent of session height).
-     * - The string {@link IT2_AUTO} (`"auto"`) for automatic sizing.
-     * Use helper functions like {@link it2Cells}, {@link it2Pixels}, {@link it2Percent} for formatting if needed.
-     * @example `10`, `"100px"`, `"50%"`, `IT2_AUTO`
-     */
-    height?: LiteralUnion<typeof IT2_AUTO, number | string>;
-    /**
-     * Controls aspect ratio preservation for inline images.
-     * - If `true` (or omitted), the aspect ratio *is* preserved (`preserveAspectRatio=1`, which is the default iTerm2 behavior if the param is absent).
-     * - If `false`, the aspect ratio is *not* preserved, and the image may stretch (`preserveAspectRatio=0`).
-     * @remarks Note the slight inversion: this property `ignoreAspectRatio: true` means `preserveAspectRatio=0` in the sequence.
-     * The default iTerm2 behavior *is* to preserve aspect ratio if the `preserveAspectRatio` parameter is not given.
-     * So, to *not* preserve, you set this to true to *add* `preserveAspectRatio=0`.
-     * If you want to preserve (default), you can omit this or set it to `false`.
-     * @default false (meaning aspect ratio is preserved by iTerm2 default unless overridden)
-     */
-    ignoreAspectRatio?: boolean;
-    /**
-     * If `true`, the file (typically an image) should be displayed inline in the terminal.
-     * Corresponds to `inline=1` in the sequence.
-     * If `false` or omitted, iTerm2 might prompt for download or handle based on file type.
-     * @default false
-     */
-    inline?: boolean;
-    /**
-     * The name of the file. This is displayed in UI elements (like a download prompt or image info)
-     * and used as the default filename if downloaded.
-     * The name **must be Base64 encoded** if it contains special characters (like `;`, `=`, or non-ASCII characters)
-     * to ensure correct parsing of the escape sequence by iTerm2.
-     * The `ITerm2File` and `ITerm2MultipartFileStart` classes generally expect the name to be pre-encoded if necessary.
-     * @example `"bXlmaWxlLnR4dA=="` (Base64 for "myfile.txt")
-     */
-    name?: string;
-    /**
-     * The size of the file in bytes. This is used by iTerm2 for progress indication during downloads
-     * or to inform inline display mechanisms.
-     * JavaScript `number` type is generally sufficient for typical file sizes (up to `Number.MAX_SAFE_INTEGER`).
-     */
-    size?: number;
-    /**
-     * The display width of the image or file placeholder.
-     * Can be:
-     * - A number (interpreted as character cells, e.g., `20`).
-     * - A string with units: `"Npx"` (N pixels), `"N%"` (N percent of session width).
-     * - The string {@link IT2_AUTO} (`"auto"`) for automatic sizing.
-     * Use helper functions like {@link it2Cells}, {@link it2Pixels}, {@link it2Percent} for formatting if needed.
-     * @example `20`, `"200px"`, `"75%"`, `IT2_AUTO`
-     */
-    width?: LiteralUnion<typeof IT2_AUTO, number | string>;
-}