@visulima/ansi 4.0.0-alpha.16 → 4.0.0-alpha.18

package/CHANGELOG.md

@@ -1,3 +1,68 @@
+## @visulima/ansi [4.0.0-alpha.18](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.17...@visulima/ansi@4.0.0-alpha.18) (2026-06-30)
+
+### Features
+
+* **ansi:** add bracketed paste markers ([5dc3d57](https://github.com/visulima/visulima/commit/5dc3d579cd1887c3b949ffee875d7259d8a5879e))
+* **ansi:** add character set selection (SCS) ([60852bd](https://github.com/visulima/visulima/commit/60852bd00920dc90c582adc298584a13e4f361a8))
+* **ansi:** add desktop notification sequences ([36f0a69](https://github.com/visulima/visulima/commit/36f0a69191e502750c7e104838688edd249e837e))
+* **ansi:** add FinalTerm shell integration marks (OSC 133) ([e087278](https://github.com/visulima/visulima/commit/e087278a25f5665172cbaa3f4dacd628ebd344ba))
+* **ansi:** add focus event reporting sequences ([83718f7](https://github.com/visulima/visulima/commit/83718f770c6e5297a69675f3adea2ba9004b95aa))
+* **ansi:** add foreground/background/cursor color sequences ([2c562bd](https://github.com/visulima/visulima/commit/2c562bdfb3a67168fd106b78159b4e98d6131f47))
+* **ansi:** add keypad application/numeric mode sequences ([cc62e9d](https://github.com/visulima/visulima/commit/cc62e9d21c7043df0b101c967133ae0b335e2d83))
+* **ansi:** add kitty graphics protocol sequence wrapper ([6e83b5c](https://github.com/visulima/visulima/commit/6e83b5cff7938ae38df8d9aa6e019453c89ae1ea))
+* **ansi:** add sixel graphics sequence wrapper ([fb2a225](https://github.com/visulima/visulima/commit/fb2a225d10ad6008e0cdc6959128d30502536c2f))
+* **ansi:** add urxvt OSC 777 extension ([8b96c1a](https://github.com/visulima/visulima/commit/8b96c1ac11c19c56fa3a55adff21309ad2287b43))
+* **ansi:** add working directory reporting (OSC 7) ([95059d5](https://github.com/visulima/visulima/commit/95059d5462a416393937d5bbab6ca425397a22b4))
+
+### Bug Fixes
+
+* **ansi:** strip OSC terminators from color/cwd/finalterm payloads ([6c4ab8c](https://github.com/visulima/visulima/commit/6c4ab8c4cae3f8bafd7483f161887883bb315a6b))
+
+### Documentation
+
+* **ansi:** document new escape sequence modules ([0bbc476](https://github.com/visulima/visulima/commit/0bbc4766259d9bde491186cadeb167d9e353f4dc))
+
+### Styles
+
+* cs fixes ([2a960bb](https://github.com/visulima/visulima/commit/2a960bb1772c9dc70080e2d75d3a0d827034e294))
+
+### Miscellaneous Chores
+
+* add fallow code-intelligence across all packages ([a3b4821](https://github.com/visulima/visulima/commit/a3b48215002e86fed20f2973038b5d4a0aa1ce04))
+* **fallow:** resolve dead-code findings ([c4125d5](https://github.com/visulima/visulima/commit/c4125d53e03ac9d90115399634535991927a96cc))
+
+### Code Refactoring
+
+* **ansi:** share OSC terminator sanitizer; address review findings ([ed2215d](https://github.com/visulima/visulima/commit/ed2215d8a61e2896dae278c7a07eae393ed415ea))
+
+### Continuous Integration
+
+* **fallow:** make fallow:health advisory (--report-only) ([d57148e](https://github.com/visulima/visulima/commit/d57148ea0e3556b4c24d8d336b9fa14987f5dc7d))
+
+## @visulima/ansi [4.0.0-alpha.17](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.16...@visulima/ansi@4.0.0-alpha.17) (2026-06-13)
+
+### Features
+
+* **ansi:** add osc52 clipboard + kitty keyboard, harden strip ([793cc9e](https://github.com/visulima/visulima/commit/793cc9e848aabe4b7b637a855941eb1f40649c94))
+
+### Bug Fixes
+
+* **ansi:** strip 8-bit C1 control sequences (0x9b CSI, 0x9d OSC, …) ([ecd702d](https://github.com/visulima/visulima/commit/ecd702ded915ae4affd2a0a65583d73819d9e8b3))
+
+### Code Refactoring
+
+* **ansi:** use replaceAll and reflow single-line arrow ([2f1525c](https://github.com/visulima/visulima/commit/2f1525c9176f0e7c65148fd2ac89b8cdb68a7b7e))
+
+### Build System
+
+* regenerate bundled-license manifests and types ordering ([af26588](https://github.com/visulima/visulima/commit/af26588d75aaa937fd4862800560bd4070a4878c))
+
+
+### Dependencies
+
+* **@visulima/colorize:** upgraded to 2.0.0-alpha.14
+* **@visulima/path:** upgraded to 3.0.0-alpha.13
+
 ## @visulima/ansi [4.0.0-alpha.16](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.15...@visulima/ansi@4.0.0-alpha.16) (2026-06-04)
 
 ### Bug Fixes

package/LICENSE.md

@@ -27,23 +27,6 @@ The published @visulima/ansi artifact additionally contains code with the follow
 ISC, MIT
 
 # Bundled dependencies:
-## ansi-regex
-License: MIT
-By: Sindre Sorhus
-Repository: chalk/ansi-regex
-
-> MIT License
->
-> Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
->
-> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
->
-> The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
->
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
----------------------------------------
-
 ## mimic-function
 License: MIT
 By: Sindre Sorhus

package/README.md

@@ -82,10 +82,10 @@ import { cursorUp, cursorLeft } from "@visulima/ansi/cursor";
 // etc, as above...
 ```
 
-And for commonjs:
+`@visulima/ansi` is ESM-only. In a CommonJS module, load it with a dynamic `import()`:
 
 ```js
-const { cursorUp, cursorLeft } = require("@visulima/ansi");
+const { cursorUp, cursorLeft } = await import("@visulima/ansi");
 
 // etc, as above...
 ```
@@ -110,10 +110,10 @@ process.stdout.write(eraseLine);
 **Screen Clearing**
 
 ```javascript
-import { clearScreen, eraseDown } from "@visulima/ansi";
+import { clearScreenAndHomeCursor, eraseDown } from "@visulima/ansi";
 
-// Clear the entire screen
-process.stdout.write(clearScreen);
+// Clear the entire screen and move the cursor to the top-left
+process.stdout.write(clearScreenAndHomeCursor);
 
 // Clear from cursor to end of screen
 process.stdout.write(eraseDown);
@@ -153,6 +153,17 @@ This package exports the following functions and constants. For a detailed list
 - `clearScreenFromTopLeft`
 - `resetTerminal`
 
+**Clipboard** (from `clipboard.ts`)
+
+- `setClipboard` — write text to the terminal clipboard via OSC 52 (works over SSH/tmux)
+- `requestClipboard` — request the clipboard contents
+- `clearClipboard` — clear a clipboard selection
+- `ClipboardSelection` (type)
+
+**Constants** (from `constants.ts`)
+
+- `ESC`, `CSI`, `OSC`, `BEL`, `SEP`, `DCS`, `ST`, `APC`, `SOS`, `PM` — low-level sequence primitives for composing custom escape sequences
+
 **Cursor** (from `cursor.ts`)
 
 - `CURSOR_BACKWARD_1`
@@ -291,6 +302,14 @@ This package exports the following functions and constants. For a detailed list
 - `screenPassthrough`
 - `tmuxPassthrough`
 
+**Progress** (from `progress.ts`)
+
+- `resetProgressBar`
+- `setProgressBar`
+- `setErrorProgressBar`
+- `setIndeterminateProgressBar`
+- `setWarningProgressBar`
+
 **Reset** (from `reset.ts`)
 
 - `RESET_INITIAL_STATE`
@@ -404,11 +423,20 @@ This package exports the following functions and constants. For a detailed list
 
 **XTerm** (from `xterm.ts`)
 
-- `xtermBell`
-- `xtermManipulateWindow`
-- `xtermReport`
-- `xtermRequest`
-- `xtermSet`
+- `keyModifierOptions` / `XTMODKEYS`
+- `queryKeyModifierOptions` / `XTQMODKEYS`
+- `setKeyModifierOptions`
+- `resetKeyModifierOptions`
+- `setModifyOtherKeys1`
+- `setModifyOtherKeys2`
+- `resetModifyOtherKeys`
+- `queryModifyOtherKeys`
+- `pushKittyKeyboard` — push Kitty keyboard protocol flags (`CSI > flags u`)
+- `popKittyKeyboard` — pop flags off the stack (`CSI < n u`)
+- `setKittyKeyboard` — set flags in place (`CSI = flags ; 1 u`)
+- `queryKittyKeyboard` — query current flags (`CSI ? u`)
+- `KittyKeyboardFlag` — bit-flag constants
+- `KittyKeyboardFlags` (type)
 
 ## Related
 

package/dist/alternative-screen.js

@@ -1 +1 @@
-var c=Object.defineProperty;var t=(e,r)=>c(e,"name",{value:r,configurable:!0});import{C as a}from"./packem_shared/constants-D12jy2Zh.js";var f=Object.defineProperty,n=t((e,r)=>f(e,"name",{value:r,configurable:!0}),"t");const i=`${a}?1049h`,l=`${a}?1049l`,O=n(()=>i,"alternativeScreenOn"),S=n(()=>l,"alternativeScreenOff");export{l as ALT_SCREEN_OFF,i as ALT_SCREEN_ON,S as alternativeScreenOff,O as alternativeScreenOn};
+import{CSI as e}from"./constants.js";const r=`${e}?1049h`,t=`${e}?1049l`,S=()=>r,a=()=>t;export{t as ALT_SCREEN_OFF,r as ALT_SCREEN_ON,a as alternativeScreenOff,S as alternativeScreenOn};

package/dist/background.d.ts

@@ -0,0 +1,72 @@
+/**
+* Returns a sequence that sets the terminal's default foreground (text) color.
+*
+* The color may be any string the terminal understands for `OSC 10`, such as an
+* X11 color name (`"red"`), a hex value (`"#ff0000"`), or an `XParseColor`
+* string (`"rgb:ff/00/00"`, `"rgba:ff/00/00/ff"`).
+*
+* Sequence: `OSC 10 ; color BEL`
+* @param color The color to set the foreground to.
+* @returns The `OSC 10` escape sequence.
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Operating-System-Commands}
+*/
+declare const setForegroundColor: (color: string) => string;
+/**
+* Sequence that queries the terminal's current default foreground color.
+*
+* Sequence: `OSC 10 ; ? BEL`
+*/
+declare const requestForegroundColor: string;
+/**
+* Sequence that resets the terminal's default foreground color to its default.
+*
+* Sequence: `OSC 110 BEL`
+*/
+declare const resetForegroundColor: string;
+/**
+* Returns a sequence that sets the terminal's default background color.
+*
+* The color may be any string the terminal understands for `OSC 11` (X11 color
+* name, hex value, or `XParseColor` string).
+*
+* Sequence: `OSC 11 ; color BEL`
+* @param color The color to set the background to.
+* @returns The `OSC 11` escape sequence.
+*/
+declare const setBackgroundColor: (color: string) => string;
+/**
+* Sequence that queries the terminal's current default background color.
+*
+* Sequence: `OSC 11 ; ? BEL`
+*/
+declare const requestBackgroundColor: string;
+/**
+* Sequence that resets the terminal's default background color to its default.
+*
+* Sequence: `OSC 111 BEL`
+*/
+declare const resetBackgroundColor: string;
+/**
+* Returns a sequence that sets the terminal's cursor color.
+*
+* The color may be any string the terminal understands for `OSC 12` (X11 color
+* name, hex value, or `XParseColor` string).
+*
+* Sequence: `OSC 12 ; color BEL`
+* @param color The color to set the cursor to.
+* @returns The `OSC 12` escape sequence.
+*/
+declare const setCursorColor: (color: string) => string;
+/**
+* Sequence that queries the terminal's current cursor color.
+*
+* Sequence: `OSC 12 ; ? BEL`
+*/
+declare const requestCursorColor: string;
+/**
+* Sequence that resets the terminal's cursor color to its default.
+*
+* Sequence: `OSC 112 BEL`
+*/
+declare const resetCursorColor: string;
+export { requestBackgroundColor, requestCursorColor, requestForegroundColor, resetBackgroundColor, resetCursorColor, resetForegroundColor, setBackgroundColor, setCursorColor, setForegroundColor };

package/dist/background.js

@@ -0,0 +1 @@
+import{OSC as r,BEL as o,stripOscTerminators as e}from"./constants.js";const t=$=>`${r}10;${e($)}${o}`,C=`${r}10;?${o}`,u=`${r}110${o}`,l=$=>`${r}11;${e($)}${o}`,n=`${r}11;?${o}`,d=`${r}111${o}`,g=$=>`${r}12;${e($)}${o}`,c=`${r}12;?${o}`,a=`${r}112${o}`;export{n as requestBackgroundColor,c as requestCursorColor,C as requestForegroundColor,d as resetBackgroundColor,a as resetCursorColor,u as resetForegroundColor,l as setBackgroundColor,g as setCursorColor,t as setForegroundColor};

package/dist/charset.d.ts

@@ -0,0 +1,52 @@
+/**
+* Returns a Select Character Set (SCS) sequence that designates `charset` into
+* one of the G0–G3 character-set slots.
+*
+* `gset` is one of the designator characters (see {@link G0}, {@link G1},
+* {@link G2}, {@link G3} for 94-character sets, or `"-"`, `"."`, `"/"` for the
+* 96-character G1–G3 slots). `charset` selects the final character of the set,
+* e.g. {@link USASCII} (`"B"`), {@link DEC_SPECIAL_GRAPHICS} (`"0"`) or
+* {@link UNITED_KINGDOM} (`"A"`).
+*
+* Sequence: `ESC gset charset`
+* @param gset The G-set designator character.
+* @param charset The final character identifying the character set.
+* @returns The SCS escape sequence.
+* @see {@link https://vt100.net/docs/vt510-rm/SCS.html}
+*/
+declare const selectCharacterSet: (gset: string, charset: string) => string;
+/** Alias for {@link selectCharacterSet} (Select Character Set). */
+declare const SCS: typeof selectCharacterSet;
+/** G0 designator for a 94-character set. */
+declare const G0: string;
+/** G1 designator for a 94-character set. */
+declare const G1: string;
+/** G2 designator for a 94-character set. */
+declare const G2: string;
+/** G3 designator for a 94-character set. */
+declare const G3: string;
+/** DEC Special Character and Line Drawing Set (final character `0`). */
+declare const DEC_SPECIAL_GRAPHICS: string;
+/** United Kingdom character set (final character `A`). */
+declare const UNITED_KINGDOM: string;
+/** United States (USASCII) character set (final character `B`). */
+declare const USASCII: string;
+/** Locking Shift 0 (LS0 / SI): invoke G0 into GL. Sequence: `SI` (`\u000F`). */
+declare const LS0: string;
+/** Alias for {@link LS0} (Shift In). */
+declare const SI: string;
+/** Locking Shift 1 (LS1 / SO): invoke G1 into GL. Sequence: `SO` (`\u000E`). */
+declare const LS1: string;
+/** Alias for {@link LS1} (Shift Out). */
+declare const SO: string;
+/** Locking Shift 1 Right (LS1R): invoke G1 into GR. Sequence: `ESC ~`. */
+declare const LS1R: string;
+/** Locking Shift 2 (LS2): invoke G2 into GL. Sequence: `ESC n`. */
+declare const LS2: string;
+/** Locking Shift 2 Right (LS2R): invoke G2 into GR. Sequence: `ESC }`. */
+declare const LS2R: string;
+/** Locking Shift 3 (LS3): invoke G3 into GL. Sequence: `ESC o`. */
+declare const LS3: string;
+/** Locking Shift 3 Right (LS3R): invoke G3 into GR. Sequence: `ESC |`. */
+declare const LS3R: string;
+export { DEC_SPECIAL_GRAPHICS, G0, G1, G2, G3, LS0, LS1, LS1R, LS2, LS2R, LS3, LS3R, SCS, SI, SO, UNITED_KINGDOM, USASCII, selectCharacterSet };

package/dist/charset.js

@@ -0,0 +1 @@
+import{ESC as S}from"./constants.js";const C=(L,$)=>`${S}${L}${$}`,e=C,o="(",r=")",A="*",E="+",R="0",c="A",D="B",I="",_=I,t="",a=t,m=`${S}~`,n=`${S}n`,p=`${S}}`,s=`${S}o`,N=`${S}|`;export{R as DEC_SPECIAL_GRAPHICS,o as G0,r as G1,A as G2,E as G3,I as LS0,t as LS1,m as LS1R,n as LS2,p as LS2R,s as LS3,N as LS3R,e as SCS,_ as SI,a as SO,c as UNITED_KINGDOM,D as USASCII,C as selectCharacterSet};

package/dist/clear.js

@@ -1 +1 @@
-import{C as n,E as o}from"./packem_shared/constants-D12jy2Zh.js";import{u as i,A as s}from"./packem_shared/cursor-BAcJR4p_.js";import{eraseDisplay as e,EraseDisplayMode as r,eraseInLine as a,EraseLineMode as c}from"./erase.js";const $=i(0,0)+e(r.ToEnd),S=`${a(c.EntireLine)}${n}G`,l=`${n}H${e(r.EntireScreen)}`,d=s?`${e(r.EntireScreen)}${n}0f`:`${e(r.EntireScreen)}${e(r.EntireScreenAndScrollback)}${n}H${o}c`;export{S as clearLineAndHomeCursor,l as clearScreenAndHomeCursor,$ as clearScreenFromTopLeft,d as resetTerminal};
+import{CSI as n,ESC as o}from"./constants.js";import{u as i,A as s}from"./packem_shared/cursor-BXG1O_IE.js";import{eraseInLine as c,eraseDisplay as e,EraseDisplayMode as r,EraseLineMode as a}from"./erase.js";const E=i(0,0)+e(r.ToEnd),S=`${c(a.EntireLine)}${n}G`,l=`${n}H${e(r.EntireScreen)}`,d=s?`${e(r.EntireScreen)}${n}0f`:`${e(r.EntireScreen)}${e(r.EntireScreenAndScrollback)}${n}H${o}c`;export{S as clearLineAndHomeCursor,l as clearScreenAndHomeCursor,E as clearScreenFromTopLeft,d as resetTerminal};

package/dist/clipboard.d.ts

@@ -0,0 +1,76 @@
+/**
+* Selection targets for OSC 52 clipboard operations.
+*
+* - `c` is the system clipboard (the common default).
+* - `p` is the primary selection (X11 middle-click paste buffer).
+* - `q` is the secondary selection.
+* - `s` is the "select" selection.
+* - `0` to `7` are numbered cut buffers.
+*
+* Multiple targets may be combined (e.g. `"cp"`) to write the same data to
+* several selections at once.
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html}
+*/
+type ClipboardSelection = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "c" | "p" | "q" | "s" | (string & {});
+/**
+* Writes data to the terminal's clipboard using the OSC 52 escape sequence.
+*
+* Sequence: `OSC 52 ; selection ; base64-data ST`
+*
+* OSC 52 is the only clipboard mechanism that works over SSH/tmux, because the
+* write travels in-band over the terminal stream rather than touching a local
+* clipboard API. The terminal emulator must have clipboard writes enabled
+* (e.g. `set-clipboard` in xterm, `allow-passthrough` plus `set-clipboard` in
+* tmux); many enable it by default.
+* @param data The text to place on the clipboard.
+* @param selection The selection target(s). Defaults to `"c"` (system clipboard).
+* @param terminator The OSC terminator to use. Defaults to {@link BEL}; pass
+* {@link ST} (`ESC backslash`) for terminals that require the canonical String Terminator.
+* @returns The OSC 52 escape sequence.
+* @example
+* ```typescript
+* import { setClipboard } from "@visulima/ansi/clipboard";
+*
+* // Copy a generated token to the user's local clipboard from a remote shell.
+* process.stdout.write(setClipboard("my-secret-token"));
+* ```
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html}
+*/
+declare const setClipboard: (data: string, selection?: ClipboardSelection, terminator?: string) => string;
+/**
+* Requests the current contents of the terminal's clipboard via OSC 52.
+*
+* Sequence: `OSC 52 ; selection ; ? ST`
+*
+* The terminal responds with `OSC 52 ; selection ; base64-data ST` if it
+* permits clipboard reads (frequently disabled for security). Decode the
+* Base64 payload from the response to obtain the clipboard text.
+* @param selection The selection target to query. Defaults to `"c"` (system clipboard).
+* @param terminator The OSC terminator to use. Defaults to {@link BEL}; pass {@link ST} for terminals that require it.
+* @returns The OSC 52 query escape sequence.
+* @example
+* ```typescript
+* import { requestClipboard } from "@visulima/ansi/clipboard";
+*
+* process.stdout.write(requestClipboard());
+* ```
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html}
+*/
+declare const requestClipboard: (selection?: ClipboardSelection, terminator?: string) => string;
+/**
+* Clears the terminal's clipboard for the given selection via OSC 52.
+*
+* Sequence: `OSC 52 ; selection ; ST` (an empty payload clears the selection).
+* @param selection The selection target to clear. Defaults to `"c"` (system clipboard).
+* @param terminator The OSC terminator to use. Defaults to {@link BEL}; pass {@link ST} for terminals that require it.
+* @returns The OSC 52 clear escape sequence.
+* @example
+* ```typescript
+* import { clearClipboard } from "@visulima/ansi/clipboard";
+*
+* process.stdout.write(clearClipboard());
+* ```
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html}
+*/
+declare const clearClipboard: (selection?: ClipboardSelection, terminator?: string) => string;
+export { ClipboardSelection, clearClipboard, requestClipboard, setClipboard };

package/dist/clipboard.js

@@ -0,0 +1 @@
+import{OSC as e,BEL as n}from"./constants.js";const f=r=>{const o=new TextEncoder().encode(r),t=o.toBase64;if(typeof t=="function")return t.call(o);if(typeof btoa=="function"){let i="";for(const c of o)i+=String.fromCodePoint(c);return btoa(i)}const a=globalThis.Buffer;if(a===void 0)throw new Error("No Base64 encoder available: Uint8Array.prototype.toBase64, btoa and Buffer are all missing.");return a.from(o).toString("base64")},l=(r,o="c",t=n)=>`${e}52;${o};${f(r)}${t}`,$=(r="c",o=n)=>`${e}52;${r};?${o}`,b=(r="c",o=n)=>`${e}52;${r};${o}`;export{b as clearClipboard,$ as requestClipboard,l as setClipboard};

package/dist/constants.d.ts

@@ -0,0 +1,28 @@
+/** Escape character (\u001B). */
+declare const ESC: string;
+/** Control Sequence Introducer (ESC [). */
+declare const CSI: string;
+/** Operating System Command (ESC ]). */
+declare const OSC: string;
+/** Bell character (\u0007). Often used to terminate OSC sequences. */
+declare const BEL: string;
+/** Separator used in some ANSI sequences, typically a semicolon. */
+declare const SEP: string;
+/** Device Control String (ESC P). */
+declare const DCS: string;
+/** String Terminator (ESC \\). Used to terminate DCS, SOS, PM, APC sequences. */
+declare const ST: string;
+/** Application Program Command (ESC _). */
+declare const APC: string;
+/** Start of String (ESC X). */
+declare const SOS: string;
+/** Privacy Message (ESC ^). */
+declare const PM: string;
+/**
+* Strips OSC terminators (BEL, ESC) from a caller-supplied value so it cannot
+* inject or prematurely terminate an escape sequence when interpolated into one.
+* @param value The untrusted string to sanitize.
+* @returns `value` with all BEL and ESC characters removed.
+*/
+declare const stripOscTerminators: (value: string) => string;
+export { APC, BEL, CSI, DCS, ESC, OSC, PM, SEP, SOS, ST, stripOscTerminators };

package/dist/constants.js

@@ -0,0 +1 @@
+const B="\x1B",S="\x1B[",r="\x1B]",C="\x07",e=";",s="\x1BP",t="\x1B\\",P="\x1B_",c="\x1BX",l="\x1B^",o=x=>x.replaceAll(/[\u0007\u001B]/g,"");export{P as APC,C as BEL,S as CSI,s as DCS,B as ESC,r as OSC,l as PM,e as SEP,c as SOS,t as ST,o as stripOscTerminators};

package/dist/cursor.js

@@ -1 +1 @@
-import"./packem_shared/constants-D12jy2Zh.js";import{C as o,a as u,b as e,c as R,B as c,R as t,d as S,e as C,S as _,f as O,g as E,h as U,i,j as l,k as T,l as n,m as D,n as d,o as w,p as A,q as b,r as f,s as m,t as p,u as N,v as P,w as v,x,y as B,z as I}from"./packem_shared/cursor-BAcJR4p_.js";import{default as k}from"./packem_shared/restoreCursor-CHy0jZuu.js";export{o as CURSOR_BACKWARD_1,u as CURSOR_DOWN_1,e as CURSOR_FORWARD_1,R as CURSOR_UP_1,c as CursorStyle,t as REQUEST_CURSOR_POSITION,S as REQUEST_EXTENDED_CURSOR_POSITION,C as RESTORE_CURSOR_DEC,_ as SAVE_CURSOR_DEC,O as cursorBackward,E as cursorBackwardTab,U as cursorDown,i as cursorForward,l as cursorHide,T as cursorHorizontalAbsolute,n as cursorHorizontalForwardTab,D as cursorLeft,d as cursorMove,w as cursorNextLine,A as cursorPosition,b as cursorPreviousLine,f as cursorRestore,m as cursorSave,p as cursorShow,N as cursorTo,P as cursorToColumn1,v as cursorUp,x as cursorVerticalAbsolute,B as eraseCharacter,k as restoreCursor,I as setCursorStyle};
+import"./constants.js";import{C as o,a as u,b as e,c as R,B as c,R as t,d as S,e as C,S as _,f as O,g as E,h as U,i,j as l,k as T,l as n,m as D,n as d,o as w,p as A,q as b,r as f,s as m,t as p,u as N,v as P,w as v,x,y as B,z as I}from"./packem_shared/cursor-BXG1O_IE.js";import{default as k}from"./packem_shared/restoreCursor-CyaXIMQf.js";export{o as CURSOR_BACKWARD_1,u as CURSOR_DOWN_1,e as CURSOR_FORWARD_1,R as CURSOR_UP_1,c as CursorStyle,t as REQUEST_CURSOR_POSITION,S as REQUEST_EXTENDED_CURSOR_POSITION,C as RESTORE_CURSOR_DEC,_ as SAVE_CURSOR_DEC,O as cursorBackward,E as cursorBackwardTab,U as cursorDown,i as cursorForward,l as cursorHide,T as cursorHorizontalAbsolute,n as cursorHorizontalForwardTab,D as cursorLeft,d as cursorMove,w as cursorNextLine,A as cursorPosition,b as cursorPreviousLine,f as cursorRestore,m as cursorSave,p as cursorShow,N as cursorTo,P as cursorToColumn1,v as cursorUp,x as cursorVerticalAbsolute,B as eraseCharacter,k as restoreCursor,I as setCursorStyle};

package/dist/cwd.d.ts

@@ -0,0 +1,26 @@
+/**
+* Returns a sequence that reports the current working directory to the terminal.
+*
+* Terminals such as iTerm2, WezTerm and others use this `OSC 7` sequence to keep
+* track of the shell's working directory — for example to open new tabs/splits in
+* the same directory. The payload is a `file://` URL built from the optional
+* `host` and the joined `paths`.
+*
+* Sequence: `OSC 7 ; file://[host]/[path] BEL`
+* @param host The host portion of the `file://` URL (use an empty string for the local machine).
+* @param paths One or more path segments that are joined into the URL path.
+* @returns The `OSC 7` escape sequence.
+* @example
+* ```typescript
+* import { notifyWorkingDirectory } from "@visulima/ansi/cwd";
+*
+* process.stdout.write(notifyWorkingDirectory("", process.cwd()));
+* ```
+* @see {@link https://gitlab.freedesktop.org/terminal-wg/specifications/-/issues/20}
+*/
+declare const notifyWorkingDirectory: (host: string, ...paths: string[]) => string;
+/**
+* Alias for {@link notifyWorkingDirectory}.
+*/
+declare const setWorkingDirectory: (host: string, ...paths: string[]) => string;
+export { notifyWorkingDirectory, setWorkingDirectory };

package/dist/cwd.js

@@ -0,0 +1 @@
+import{stripOscTerminators as s,OSC as c,BEL as l}from"./constants.js";const $=(t,...o)=>{const r=o.filter(n=>n.length>0).join("/").replaceAll(/\/{2,}/g,"/"),e=r.startsWith("/")?r:`/${r}`,i=s(t);return`${c}7;file://${i}${encodeURI(e)}${l}`},g=$;export{$ as notifyWorkingDirectory,g as setWorkingDirectory};

package/dist/erase.js

@@ -1 +1 @@
-var t=Object.defineProperty;var s=(e,n)=>t(e,"name",{value:n,configurable:!0});import{C as c}from"./packem_shared/constants-D12jy2Zh.js";import{w as l,v as E}from"./packem_shared/cursor-BAcJR4p_.js";var S=Object.defineProperty,a=s((e,n)=>S(e,"name",{value:n,configurable:!0}),"o"),d=(e=>(e[e.ToEnd=0]="ToEnd",e[e.ToBeginning=1]="ToBeginning",e[e.EntireScreen=2]="EntireScreen",e[e.EntireScreenAndScrollback=3]="EntireScreenAndScrollback",e))(d||{});const r=a(e=>{const n=e>=0&&e<=3?e:0;return`${c}${n===0?"":String(n)}J`},"eraseDisplay");var g=(e=>(e[e.ToEnd=0]="ToEnd",e[e.ToBeginning=1]="ToBeginning",e[e.EntireLine=2]="EntireLine",e))(g||{});const o=a(e=>{const n=e>=0&&e<=2?e:0;return`${c}${n===0?"":String(n)}K`},"eraseInLine"),f=r(0),u=o(2),m=o(0),v=o(1),b=a(e=>{if(e<=0)return"";let n="";for(let i=0;i<e;i+=1)n+=u,i<e-1&&(n+=l());return n+=E,n},"eraseLines"),y=r(2),B=r(1),D=r(3);export{d as EraseDisplayMode,g as EraseLineMode,r as eraseDisplay,f as eraseDown,o as eraseInLine,u as eraseLine,m as eraseLineEnd,v as eraseLineStart,b as eraseLines,y as eraseScreen,D as eraseScreenAndScrollback,B as eraseUp};
+import{CSI as s}from"./constants.js";import{v as a,w as c}from"./packem_shared/cursor-BXG1O_IE.js";var t=(e=>(e[e.ToEnd=0]="ToEnd",e[e.ToBeginning=1]="ToBeginning",e[e.EntireScreen=2]="EntireScreen",e[e.EntireScreenAndScrollback=3]="EntireScreenAndScrollback",e))(t||{});const r=e=>{const n=e>=0&&e<=3?e:0;return`${s}${n===0?"":String(n)}J`};var E=(e=>(e[e.ToEnd=0]="ToEnd",e[e.ToBeginning=1]="ToBeginning",e[e.EntireLine=2]="EntireLine",e))(E||{});const o=e=>{const n=e>=0&&e<=2?e:0;return`${s}${n===0?"":String(n)}K`},g=r(0),S=o(2),T=o(0),L=o(1),p=e=>{if(e<=0)return"";let n="";for(let i=0;i<e;i+=1)n+=S,i<e-1&&(n+=c());return n+=a,n},u=r(2),m=r(1),f=r(3);export{t as EraseDisplayMode,E as EraseLineMode,r as eraseDisplay,g as eraseDown,o as eraseInLine,S as eraseLine,T as eraseLineEnd,L as eraseLineStart,p as eraseLines,u as eraseScreen,f as eraseScreenAndScrollback,m as eraseUp};

package/dist/finalterm.d.ts

@@ -0,0 +1,47 @@
+/**
+* Returns a FinalTerm shell-integration sequence (`OSC 133`).
+*
+* The FinalTerm protocol lets shells mark the structure of their output — where
+* the prompt starts, where the user's command begins, where its output starts
+* and when it finished — so terminals can offer features like jump-to-prompt,
+* command status and selection of command output.
+*
+* Sequence: `OSC 133 ; Pt BEL`
+* @param pm The semicolon-delimited parameters of the sequence.
+* @returns The `OSC 133` escape sequence.
+* @see {@link https://iterm2.com/documentation-shell-integration.html}
+*/
+declare const finalTerm: (...pm: string[]) => string;
+/**
+* Marks the start of the shell prompt. Sent just before the prompt is printed.
+*
+* Sequence: `OSC 133 ; A ; Pt BEL`
+* @param pm Additional parameters appended after the `A` marker.
+* @returns The `OSC 133 ; A` escape sequence.
+*/
+declare const finalTermPrompt: (...pm: string[]) => string;
+/**
+* Marks the end of the prompt and the start of the user's command input.
+*
+* Sequence: `OSC 133 ; B ; Pt BEL`
+* @param pm Additional parameters appended after the `B` marker.
+* @returns The `OSC 133 ; B` escape sequence.
+*/
+declare const finalTermCmdStart: (...pm: string[]) => string;
+/**
+* Marks the start of the command output (the command is about to be executed).
+*
+* Sequence: `OSC 133 ; C ; Pt BEL`
+* @param pm Additional parameters appended after the `C` marker.
+* @returns The `OSC 133 ; C` escape sequence.
+*/
+declare const finalTermCmdExecuted: (...pm: string[]) => string;
+/**
+* Marks the end of the command output. May carry the command's exit code.
+*
+* Sequence: `OSC 133 ; D ; Pt BEL`
+* @param pm Additional parameters appended after the `D` marker (e.g. the exit code).
+* @returns The `OSC 133 ; D` escape sequence.
+*/
+declare const finalTermCmdFinished: (...pm: string[]) => string;
+export { finalTerm, finalTermCmdExecuted, finalTermCmdFinished, finalTermCmdStart, finalTermPrompt };

package/dist/finalterm.js

@@ -0,0 +1 @@
+import{OSC as e,BEL as n,stripOscTerminators as t}from"./constants.js";const r=(...m)=>`${e}133;${m.map(i=>t(i)).join(";")}${n}`,o=(...m)=>r("A",...m),f=(...m)=>r("B",...m),T=(...m)=>r("C",...m),d=(...m)=>r("D",...m);export{r as finalTerm,T as finalTermCmdExecuted,d as finalTermCmdFinished,f as finalTermCmdStart,o as finalTermPrompt};

package/dist/focus.d.ts

@@ -0,0 +1,20 @@
+/**
+* Event a terminal emits when the window gains focus, while focus event
+* reporting is enabled (DEC private mode 1004).
+*
+* Sequence: `CSI I`
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Focus-Tracking}
+*/
+declare const FOCUS: string;
+/**
+* Event a terminal emits when the window loses focus, while focus event
+* reporting is enabled (DEC private mode 1004).
+*
+* Sequence: `CSI O`
+*/
+declare const BLUR: string;
+/** Alias for {@link FOCUS}. */
+declare const focusInEvent: string;
+/** Alias for {@link BLUR}. */
+declare const focusOutEvent: string;
+export { BLUR, FOCUS, focusInEvent, focusOutEvent };

package/dist/focus.js

@@ -0,0 +1 @@
+import{CSI as o}from"./constants.js";const t=`${o}I`,n=`${o}O`,e=t,f=n;export{n as BLUR,t as FOCUS,e as focusInEvent,f as focusOutEvent};

package/dist/hyperlink.d.ts

@@ -1,2 +1,27 @@
+/**
+* Creates a clickable hyperlink in the terminal.
+*
+* This function constructs an ANSI escape sequence that, when printed to a compatible terminal,
+* renders as a clickable link. The link's visible text and its target URL are specified
+* by the `text` and `url` parameters, respectively.
+*
+* For information on terminal support for hyperlinks, see this
+* [Gist by Egmont Kob](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda).
+* To programmatically check for hyperlink support in the current environment,
+* consider using a library like [`supports-hyperlinks`](https://github.com/jamestalmage/supports-hyperlinks).
+* @param text The visible text of the link.
+* @param url The URL the link should point to.
+* @returns A string representing the ANSI escape sequence for the hyperlink.
+* @example
+* ```typescript
+* import { hyperlink } from "@visulima/ansi/hyperlink"; // Adjust import path as needed
+*
+* const aLink = hyperlink("Visulima", "https://www.visulima.com");
+* console.log(`Visit ${aLink} for more information.`);
+* // In a supported terminal, this will output:
+* // Visit Visulima for more information. (where "Visulima" is a clickable link)
+* ```
+* @see {@link https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda} for supported terminals.
+*/
 declare const hyperlink: (text: string, url: string) => string;
 export { hyperlink as default };

package/dist/hyperlink.js

@@ -1 +1 @@
-var i=Object.defineProperty;var n=(e,r)=>i(e,"name",{value:r,configurable:!0});import{O as t,S as a,B as o}from"./packem_shared/constants-D12jy2Zh.js";var s=Object.defineProperty,u=n((e,r)=>s(e,"name",{value:r,configurable:!0}),"n");const c=/[]/g,v=u((e,r)=>{const l=r.replace(c,""),p=e.replace(c,"");return[t,"8",a,a,l,o,p,t,"8",a,a,o].join("")},"hyperlink");export{v as default};
+import{stripOscTerminators as r,OSC as t,SEP as o,BEL as s}from"./constants.js";const m=(n,a)=>{const c=r(a),e=r(n);return[t,"8",o,o,c,s,e,t,"8",o,o,s].join("")};export{m as default};

package/dist/image.d.ts

@@ -37,7 +37,6 @@ interface ImageOptions {
 * @param options Optional parameters to control how the image is displayed (e.g., width, height, aspect ratio).
 * See {@link ImageOptions}.
 * @returns A string containing the ANSI escape sequence for displaying the image in iTerm2.
-* Returns an empty string if `data` is null or undefined, though TypeScript should prevent this.
 * @example
 * ```typescript
 * import { image } from '@visulima/ansi/image'; // Adjust import path
@@ -61,9 +60,9 @@ interface ImageOptions {
 * ```
 * @remarks
 * - This sequence is specific to iTerm2 and may not work in other terminal emulators.
-* - For Node.js environments, `Buffer.from(data).toString("base64")` is used for Base64 encoding.
-* In browser environments, a polyfill or an alternative method for Base64 encoding `Uint8Array` would be necessary
-* if `Buffer` is not available (e.g., `btoa(String.fromCharCode(...data))` after careful handling of binary data).
+* - Base64 encoding is runtime-agnostic: it prefers the standardized
+* `Uint8Array.prototype.toBase64` (Node ≥ 24, modern browsers), then `btoa`,
+* then Node's `Buffer`, so the helper works in browser/xterm.js bundles too.
 * - The `name` parameter (for filename) is not directly supported by this simplified helper but is part of the
 * full iTerm2 inline image protocol. For more advanced features, consider using the more detailed iTerm2 sequence
 * builders in `iterm2/` files.

package/dist/image.js

@@ -1 +1 @@
-var n=Object.defineProperty;var o=(r,e)=>n(r,"name",{value:e,configurable:!0});import{createRequire as a}from"node:module";import{O as l,B as p}from"./packem_shared/constants-D12jy2Zh.js";const c=a(import.meta.url),i=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,u=o(r=>{if(typeof i<"u"&&i.versions&&i.versions.node){const[e,t]=i.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return i.getBuiltinModule(r)}return c(r)},"__cjs_getBuiltinModule"),{Buffer:f}=u("node:buffer");var d=Object.defineProperty,g=o((r,e)=>d(r,"name",{value:e,configurable:!0}),"i");const v=g((r,e={})=>{let t=`${l}1337;File=inline=1`;e.width!==void 0&&(t+=`;width=${String(e.width)}`),e.height!==void 0&&(t+=`;height=${String(e.height)}`),e.preserveAspectRatio===!1&&(t+=";preserveAspectRatio=0");const s=f.from(r).toString("base64");return`${t}:${s}${p}`},"image");export{v as image};
+import{OSC as n,BEL as a}from"./constants.js";const s=e=>{const t=e.toBase64;if(typeof t=="function")return t.call(e);if(typeof btoa=="function"){let i="";for(const r of e)i+=String.fromCodePoint(r);return btoa(i)}const o=globalThis.Buffer;if(o===void 0)throw new Error("No Base64 encoder available: Uint8Array.prototype.toBase64, btoa and Buffer are all missing.");return o.from(e).toString("base64")},l=(e,t={})=>{let o=`${n}1337;File=inline=1`;t.width!==void 0&&(o+=`;width=${String(t.width)}`),t.height!==void 0&&(o+=`;height=${String(t.height)}`),t.preserveAspectRatio===!1&&(o+=";preserveAspectRatio=0");const i=s(e);return`${o}:${i}${a}`};export{l as image};