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

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## @visulima/ansi [4.0.0-alpha.14](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.13...@visulima/ansi@4.0.0-alpha.14) (2026-05-20)
+
+### Bug Fixes
+
+* **ansi:** sanitize title in every OSC-write helper ([75c579e](https://github.com/visulima/visulima/commit/75c579e9b009d25c4d90f959d06f0bd524c1d07a))
+
+### Miscellaneous Chores
+
+* **ansi:** apply prettier and eslint quote-style auto-fix ([b564048](https://github.com/visulima/visulima/commit/b564048f5fe7c116633358874ca3b5a5a20806a3))
+* **ansi:** housekeeping cleanup ([da5f5d1](https://github.com/visulima/visulima/commit/da5f5d124563ba8809a374f0f6eb9dcb022f330c))
+* **ansi:** upgrade packem to 2.0.0-alpha.76 ([f970913](https://github.com/visulima/visulima/commit/f970913dadd41f5d89ecbc52b481cb5099502c3d))
+* re-sort workspace package.json files via vis sort-package-json ([f625696](https://github.com/visulima/visulima/commit/f625696cfac974325774b3243e1a83c3d23acbd7))
+* simplify pnpm-workspace packages list ([7cab221](https://github.com/visulima/visulima/commit/7cab221163632d9b7aa044a6f88c49083103a869))
+* **terminal:** apply prettier and eslint formatting sweep ([15fd89c](https://github.com/visulima/visulima/commit/15fd89c677eea60866e08e4fd5f5a6bc8f3bd2e5))
+
 ## @visulima/ansi [4.0.0-alpha.13](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.12...@visulima/ansi@4.0.0-alpha.13) (2026-04-22)
 
 ### Bug Fixes

package/LICENSE.md

@@ -122,14 +122,11 @@ Repository: https://github.com/tapjs/signal-exit.git
 <!-- TYPE_DEPENDENCIES -->
 
 # Licenses of bundled types
-
 The published @visulima/ansi artifact additionally contains code with the following licenses:
 MIT
 
 # Bundled types:
-
 ## restore-cursor
-
 License: MIT
 By: Sindre Sorhus
 Repository: sindresorhus/restore-cursor

package/README.md

@@ -30,6 +30,9 @@
             Daniel Bannert's open source work is supported by the community on <a href="https://github.com/sponsors/prisis">GitHub Sponsors</a>
         </sup>
     </p>
+    <a href="https://anolilab.com">
+        <img src="../../../.github/assets/anolilab.svg" alt="Sponsored by Anolilab" width="200" />
+    </a>
 </div>
 
 ---

package/dist/alternative-screen.d.ts

@@ -1,74 +1,75 @@
 /**
- * ANSI escape sequence to enable the alternative screen buffer.
- *
- * This sequence (`CSI ?1049h`) instructs the terminal to switch to the alternative screen buffer.
- * This is a common practice for full-screen terminal applications (e.g., vim, less, htop)
- * to provide a separate screen area for their interface, leaving the original shell content
- * undisturbed and restoring it upon exit.
- * When this mode is activated, the original screen content is typically saved by the terminal,
- * and a blank screen is presented. Operations then occur on this alternative buffer.
- *
- * The specific behavior (like whether the screen is cleared on switch) can sometimes vary
- * slightly between terminal emulators. `?1049h` generally includes saving the cursor position
- * along with the screen content and clearing the alternative screen.
- * It is closely related to mode `?47h`, which also switches to an alternative buffer but might
- * have different semantics regarding screen clearing and cursor saving.
- * Mode `?1049h` is generally preferred for a more robust alternative screen experience.
- * @see {@link ALT_SCREEN_OFF} for the sequence to disable the alternative screen buffer.
- * @see {@link alternativeScreenOn} for a function that returns this sequence.
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-The-Alternate-Screen-Buffer} Xterm Control Sequences documentation.
- * @see {@link https://vt100.net/docs/vt510-rm/DECSLPP.html} (related DEC modes, though 1049 is more common for this behavior).
- */
-export declare const ALT_SCREEN_ON: string;
+* ANSI escape sequence to enable the alternative screen buffer.
+*
+* This sequence (`CSI ?1049h`) instructs the terminal to switch to the alternative screen buffer.
+* This is a common practice for full-screen terminal applications (e.g., vim, less, htop)
+* to provide a separate screen area for their interface, leaving the original shell content
+* undisturbed and restoring it upon exit.
+* When this mode is activated, the original screen content is typically saved by the terminal,
+* and a blank screen is presented. Operations then occur on this alternative buffer.
+*
+* The specific behavior (like whether the screen is cleared on switch) can sometimes vary
+* slightly between terminal emulators. `?1049h` generally includes saving the cursor position
+* along with the screen content and clearing the alternative screen.
+* It is closely related to mode `?47h`, which also switches to an alternative buffer but might
+* have different semantics regarding screen clearing and cursor saving.
+* Mode `?1049h` is generally preferred for a more robust alternative screen experience.
+* @see {@link ALT_SCREEN_OFF} for the sequence to disable the alternative screen buffer.
+* @see {@link alternativeScreenOn} for a function that returns this sequence.
+* @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-The-Alternate-Screen-Buffer} Xterm Control Sequences documentation.
+* @see {@link https://vt100.net/docs/vt510-rm/DECSLPP.html} (related DEC modes, though 1049 is more common for this behavior).
+*/
+declare const ALT_SCREEN_ON: string;
 /**
- * ANSI escape sequence to disable the alternative screen buffer.
- *
- * This sequence (`CSI ?1049l`) instructs the terminal to switch back from the alternative
- * screen buffer to the main screen buffer. When this occurs, the terminal typically
- * restores the screen content and cursor position that were saved when the alternative
- * buffer was activated by {@link ALT_SCREEN_ON}.
- *
- * This is used when a full-screen application exits, allowing the user to return to their
- * previous shell session seamlessly.
- * @see {@link ALT_SCREEN_ON} for the sequence to enable the alternative screen buffer.
- * @see {@link alternativeScreenOff} for a function that returns this sequence.
- */
-export declare const ALT_SCREEN_OFF: string;
+* ANSI escape sequence to disable the alternative screen buffer.
+*
+* This sequence (`CSI ?1049l`) instructs the terminal to switch back from the alternative
+* screen buffer to the main screen buffer. When this occurs, the terminal typically
+* restores the screen content and cursor position that were saved when the alternative
+* buffer was activated by {@link ALT_SCREEN_ON}.
+*
+* This is used when a full-screen application exits, allowing the user to return to their
+* previous shell session seamlessly.
+* @see {@link ALT_SCREEN_ON} for the sequence to enable the alternative screen buffer.
+* @see {@link alternativeScreenOff} for a function that returns this sequence.
+*/
+declare const ALT_SCREEN_OFF: string;
 /**
- * Returns the ANSI escape sequence to enable the alternative screen buffer.
- *
- * This function is a convenience wrapper around the {@link ALT_SCREEN_ON} constant.
- * It provides a more descriptive way to obtain the sequence for enabling the
- * alternative screen, often used at the initialization phase of a full-screen
- * terminal application.
- * @returns The ANSI escape sequence (`CSI ?1049h`) for enabling the alternative screen buffer.
- * @example
- * ```typescript
- * import { alternativeScreenOn } from '@visulima/ansi/alternative-screen';
- *
- * process.stdout.write(alternativeScreenOn());
- * // Terminal switches to the alternative screen buffer.
- * ```
- * @see {@link ALT_SCREEN_ON}
- * @see {@link alternativeScreenOff}
- */
-export declare const alternativeScreenOn: () => string;
+* Returns the ANSI escape sequence to enable the alternative screen buffer.
+*
+* This function is a convenience wrapper around the {@link ALT_SCREEN_ON} constant.
+* It provides a more descriptive way to obtain the sequence for enabling the
+* alternative screen, often used at the initialization phase of a full-screen
+* terminal application.
+* @returns The ANSI escape sequence (`CSI ?1049h`) for enabling the alternative screen buffer.
+* @example
+* ```typescript
+* import { alternativeScreenOn } from '@visulima/ansi/alternative-screen';
+*
+* process.stdout.write(alternativeScreenOn());
+* // Terminal switches to the alternative screen buffer.
+* ```
+* @see {@link ALT_SCREEN_ON}
+* @see {@link alternativeScreenOff}
+*/
+declare const alternativeScreenOn: () => string;
 /**
- * Returns the ANSI escape sequence to disable the alternative screen buffer.
- *
- * This function is a convenience wrapper around the {@link ALT_SCREEN_OFF} constant.
- * It provides a more descriptive way to obtain the sequence for disabling the
- * alternative screen, typically used when a full-screen terminal application is exiting
- * to restore the user's original terminal state.
- * @returns The ANSI escape sequence (`CSI ?1049l`) for disabling the alternative screen buffer.
- * @example
- * ```typescript
- * import { alternativeScreenOff } from '@visulima/ansi/alternative-screen';
- *
- * process.stdout.write(alternativeScreenOff());
- * // Terminal switches back to the main screen buffer, restoring previous content.
- * ```
- * @see {@link ALT_SCREEN_OFF}
- * @see {@link alternativeScreenOn}
- */
-export declare const alternativeScreenOff: () => string;
+* Returns the ANSI escape sequence to disable the alternative screen buffer.
+*
+* This function is a convenience wrapper around the {@link ALT_SCREEN_OFF} constant.
+* It provides a more descriptive way to obtain the sequence for disabling the
+* alternative screen, typically used when a full-screen terminal application is exiting
+* to restore the user's original terminal state.
+* @returns The ANSI escape sequence (`CSI ?1049l`) for disabling the alternative screen buffer.
+* @example
+* ```typescript
+* import { alternativeScreenOff } from '@visulima/ansi/alternative-screen';
+*
+* process.stdout.write(alternativeScreenOff());
+* // Terminal switches back to the main screen buffer, restoring previous content.
+* ```
+* @see {@link ALT_SCREEN_OFF}
+* @see {@link alternativeScreenOn}
+*/
+declare const alternativeScreenOff: () => string;
+export { ALT_SCREEN_OFF, ALT_SCREEN_ON, alternativeScreenOff, alternativeScreenOn };

package/dist/alternative-screen.js

@@ -1,8 +1 @@
-import { C as CSI } from './packem_shared/constants-CE7WkXh_.js';
-
-const ALT_SCREEN_ON = `${CSI}?1049h`;
-const ALT_SCREEN_OFF = `${CSI}?1049l`;
-const alternativeScreenOn = () => ALT_SCREEN_ON;
-const alternativeScreenOff = () => ALT_SCREEN_OFF;
-
-export { ALT_SCREEN_OFF, ALT_SCREEN_ON, alternativeScreenOff, alternativeScreenOn };
+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};

package/dist/clear.d.ts

@@ -1,77 +1,78 @@
 /**
- * Moves the cursor to the top-left (0,0 in 0-indexed terms) and erases from the cursor to the end of the screen.
- *
- * This sequence is a combination of:
- * 1. {@link cursorTo}(0, 0): Moves the cursor to the first row, first column.
- * (Equivalent to `CSI 1;1H` as `cursorTo` uses 0-indexed arguments which are converted to 1-indexed for the sequence).
- * 2. {@link eraseDisplay}({@link EraseDisplayMode.ToEnd}): Erases from the cursor position to the end of the screen (`CSI 0J` or `CSI J`).
- *
- * Effective combined sequence: `CSI 1;1H CSI J` (or `CSI 1;1H CSI 0J`).
- * @see {@link cursorTo}
- * @see {@link eraseDisplay}
- * @see {@link EraseDisplayMode.ToEnd}
- */
-export declare const clearScreenFromTopLeft: string;
+* Moves the cursor to the top-left (0,0 in 0-indexed terms) and erases from the cursor to the end of the screen.
+*
+* This sequence is a combination of:
+* 1. {@link cursorTo}(0, 0): Moves the cursor to the first row, first column.
+* (Equivalent to `CSI 1;1H` as `cursorTo` uses 0-indexed arguments which are converted to 1-indexed for the sequence).
+* 2. {@link eraseDisplay}({@link EraseDisplayMode.ToEnd}): Erases from the cursor position to the end of the screen (`CSI 0J` or `CSI J`).
+*
+* Effective combined sequence: `CSI 1;1H CSI J` (or `CSI 1;1H CSI 0J`).
+* @see {@link cursorTo}
+* @see {@link eraseDisplay}
+* @see {@link EraseDisplayMode.ToEnd}
+*/
+declare const clearScreenFromTopLeft: string;
 /**
- * Erases the entire current line and moves the cursor to the beginning of that line (column 1).
- *
- * This sequence is a combination of:
- * 1. {@link eraseInLine}({@link EraseLineMode.EntireLine}): Erases the entire current line (`CSI 2K`).
- * 2. `CSI G`: Moves the cursor to column 1 of the current line (Cursor Horizontal Absolute).
- * Alternatively, a carriage return (`\r`) could achieve a similar cursor move to the start of the line on many systems.
- *
- * Effective combined sequence: `CSI 2K CSI G`.
- * @see {@link eraseInLine}
- * @see {@link EraseLineMode.EntireLine}
- */
-export declare const clearLineAndHomeCursor: string;
+* Erases the entire current line and moves the cursor to the beginning of that line (column 1).
+*
+* This sequence is a combination of:
+* 1. {@link eraseInLine}({@link EraseLineMode.EntireLine}): Erases the entire current line (`CSI 2K`).
+* 2. `CSI G`: Moves the cursor to column 1 of the current line (Cursor Horizontal Absolute).
+* Alternatively, a carriage return (`\r`) could achieve a similar cursor move to the start of the line on many systems.
+*
+* Effective combined sequence: `CSI 2K CSI G`.
+* @see {@link eraseInLine}
+* @see {@link EraseLineMode.EntireLine}
+*/
+declare const clearLineAndHomeCursor: string;
 /**
- * Homes the cursor to the top-left position (row 1, column 1) and erases the entire screen.
- *
- * This sequence is a combination of:
- * 1. `CSI H`: Moves the cursor to the home position (top-left, equivalent to `CSI 1;1H`).
- * 2. {@link eraseDisplay}({@link EraseDisplayMode.EntireScreen}): Erases the entire screen (`CSI 2J`).
- *
- * Effective combined sequence: `CSI H CSI 2J`.
- * @remarks This is a very common sequence for clearing the visible terminal window.
- * @see `cursorPosition` from `./cursor` (which `CSI H` relates to)
- * @see {@link eraseDisplay}
- * @see {@link EraseDisplayMode.EntireScreen}
- */
-export declare const clearScreenAndHomeCursor: string;
+* Homes the cursor to the top-left position (row 1, column 1) and erases the entire screen.
+*
+* This sequence is a combination of:
+* 1. `CSI H`: Moves the cursor to the home position (top-left, equivalent to `CSI 1;1H`).
+* 2. {@link eraseDisplay}({@link EraseDisplayMode.EntireScreen}): Erases the entire screen (`CSI 2J`).
+*
+* Effective combined sequence: `CSI H CSI 2J`.
+* @remarks This is a very common sequence for clearing the visible terminal window.
+* @see `cursorPosition` from `./cursor` (which `CSI H` relates to)
+* @see {@link eraseDisplay}
+* @see {@link EraseDisplayMode.EntireScreen}
+*/
+declare const clearScreenAndHomeCursor: string;
 /**
- * Clears the entire terminal display, including the scrollback buffer on supported terminals,
- * and attempts to reset the terminal to its initial (or a more pristine) state.
- *
- * This is generally a more comprehensive and forceful clear operation than just erasing the
- * visible screen content (like {@link clearScreenAndHomeCursor}).
- *
- * The exact behavior and sequences used can vary by terminal and operating system:
- *
- * - **On Windows:**
- * It typically uses `CSI 2J` (erase entire screen) followed by `CSI 0f`.
- * `CSI 0f` (or `CSI ;f`, `CSI 0;0f`) is an SGR sequence that also often acts as a cursor home command,
- * though its standardization can be less consistent than `CSI H`.
- * The primary goal is to clear the screen and move the cursor to the top-left.
- *
- * - **On other platforms (e.g., Linux, macOS with XTerm-like terminals):**
- * A more robust combination is used:
- * 1. {@link eraseDisplay}({@link EraseDisplayMode.EntireScreen}) (`CSI 2J`): Erases the entire visible screen.
- * 2. {@link eraseDisplay}({@link EraseDisplayMode.EntireScreenAndScrollback}) (`CSI 3J`): Erases the scrollback buffer (XTerm-specific, but widely supported).
- * 3. `CSI H`: Moves the cursor to the home position (top-left).
- * 4. `ESC c` (RIS - Reset to Initial State): This is the most powerful reset sequence. It typically resets the terminal
- * to its power-on state, clearing character sets, SGR attributes, modes, and more.
- * @returns A string containing the ANSI escape sequence(s) for resetting the terminal.
- * @example
- * ```typescript
- * import { resetTerminal } from '@visulima/ansi/clear';
- *
- * process.stdout.write(resetTerminal);
- * // The terminal attempts a full reset.
- * ```
- * @see {@link eraseDisplay}
- * @see {@link EraseDisplayMode.EntireScreen}
- * @see {@link EraseDisplayMode.EntireScreenAndScrollback}
- * @see {@link https://vt100.net/docs/vt510-rm/RIS.html} RIS documentation.
- */
-export declare const resetTerminal: string;
+* Clears the entire terminal display, including the scrollback buffer on supported terminals,
+* and attempts to reset the terminal to its initial (or a more pristine) state.
+*
+* This is generally a more comprehensive and forceful clear operation than just erasing the
+* visible screen content (like {@link clearScreenAndHomeCursor}).
+*
+* The exact behavior and sequences used can vary by terminal and operating system:
+*
+* - **On Windows:**
+* It typically uses `CSI 2J` (erase entire screen) followed by `CSI 0f`.
+* `CSI 0f` (or `CSI ;f`, `CSI 0;0f`) is an SGR sequence that also often acts as a cursor home command,
+* though its standardization can be less consistent than `CSI H`.
+* The primary goal is to clear the screen and move the cursor to the top-left.
+*
+* - **On other platforms (e.g., Linux, macOS with XTerm-like terminals):**
+* A more robust combination is used:
+* 1. {@link eraseDisplay}({@link EraseDisplayMode.EntireScreen}) (`CSI 2J`): Erases the entire visible screen.
+* 2. {@link eraseDisplay}({@link EraseDisplayMode.EntireScreenAndScrollback}) (`CSI 3J`): Erases the scrollback buffer (XTerm-specific, but widely supported).
+* 3. `CSI H`: Moves the cursor to the home position (top-left).
+* 4. `ESC c` (RIS - Reset to Initial State): This is the most powerful reset sequence. It typically resets the terminal
+* to its power-on state, clearing character sets, SGR attributes, modes, and more.
+* @returns A string containing the ANSI escape sequence(s) for resetting the terminal.
+* @example
+* ```typescript
+* import { resetTerminal } from '@visulima/ansi/clear';
+*
+* process.stdout.write(resetTerminal);
+* // The terminal attempts a full reset.
+* ```
+* @see {@link eraseDisplay}
+* @see {@link EraseDisplayMode.EntireScreen}
+* @see {@link EraseDisplayMode.EntireScreenAndScrollback}
+* @see {@link https://vt100.net/docs/vt510-rm/RIS.html} RIS documentation.
+*/
+declare const resetTerminal: string;
+export { clearLineAndHomeCursor, clearScreenAndHomeCursor, clearScreenFromTopLeft, resetTerminal };

package/dist/clear.js

@@ -1,10 +1 @@
-import { C as CSI, E as ESC } from './packem_shared/constants-CE7WkXh_.js';
-import { u as cursorTo, A as isWindows } from './packem_shared/cursor-ChpV7cgs.js';
-import { eraseInLine, eraseDisplay, EraseDisplayMode, EraseLineMode } from './erase.js';
-
-const clearScreenFromTopLeft = cursorTo(0, 0) + eraseDisplay(EraseDisplayMode.ToEnd);
-const clearLineAndHomeCursor = `${eraseInLine(EraseLineMode.EntireLine)}${CSI}G`;
-const clearScreenAndHomeCursor = `${CSI}H${eraseDisplay(EraseDisplayMode.EntireScreen)}`;
-const resetTerminal = isWindows ? `${eraseDisplay(EraseDisplayMode.EntireScreen)}${CSI}0f` : `${eraseDisplay(EraseDisplayMode.EntireScreen)}${eraseDisplay(EraseDisplayMode.EntireScreenAndScrollback)}${CSI}H${ESC}c`;
-
-export { clearLineAndHomeCursor, clearScreenAndHomeCursor, clearScreenFromTopLeft, resetTerminal };
+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};