@visulima/ansi 4.0.0-alpha.9 → 4.0.0

package/dist/cursor.js

@@ -1,3 +1 @@
-import './packem_shared/constants-CE7WkXh_.js';
-export { C as CURSOR_BACKWARD_1, a as CURSOR_DOWN_1, b as CURSOR_FORWARD_1, c as CURSOR_UP_1, B as CursorStyle, R as REQUEST_CURSOR_POSITION, d as REQUEST_EXTENDED_CURSOR_POSITION, e as RESTORE_CURSOR_DEC, S as SAVE_CURSOR_DEC, f as cursorBackward, g as cursorBackwardTab, h as cursorDown, i as cursorForward, j as cursorHide, k as cursorHorizontalAbsolute, l as cursorHorizontalForwardTab, m as cursorLeft, n as cursorMove, o as cursorNextLine, p as cursorPosition, q as cursorPreviousLine, r as cursorRestore, s as cursorSave, t as cursorShow, u as cursorTo, v as cursorToColumn1, w as cursorUp, x as cursorVerticalAbsolute, y as eraseCharacter, z as setCursorStyle } from './packem_shared/cursor-ChpV7cgs.js';
-export { default as restoreCursor } from './packem_shared/restoreCursor-GfYEeJqN.js';
+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.d.ts

@@ -1,206 +1,207 @@
 /**
- * Defines the modes for erasing parts of the display using the ED (Erase in Display) sequence.
- * The ED sequence is `CSI Ps J`, where `Ps` is one of these mode values.
- * @see {@link eraseDisplay} for the function that generates ED sequences.
- * @see {@link https://vt100.net/docs/vt510-rm/ED.html} VT510 Erase in Display (ED) documentation.
- * @enum {number}
- */
-export declare enum EraseDisplayMode {
-    /**
-     * Clears from the current cursor position to the end of the screen (inclusive).
-     * If the cursor is at the top-left, this clears the entire screen.
-     * This corresponds to `Ps=0` (or `Ps` omitted) in `CSI Ps J`.
-     * Sequence: `CSI J` or `CSI 0J`.
-     */
-    ToEnd = 0,
-    /**
-     * Clears from the beginning of the screen to the current cursor position (inclusive).
-     * This corresponds to `Ps=1` in `CSI Ps J`.
-     * Sequence: `CSI 1J`.
-     */
-    ToBeginning = 1,
-    /**
-     * Clears the entire screen. The cursor position usually does not change, but this can be
-     * terminal-dependent. Some terminals might move the cursor to the home position (top-left).
-     * This corresponds to `Ps=2` in `CSI Ps J`.
-     * Sequence: `CSI 2J`.
-     */
-    EntireScreen = 2,
-    /**
-     * Clears the entire screen and, on supported terminals (like XTerm and derivatives),
-     * also deletes all lines saved in the scrollback buffer.
-     * This corresponds to `Ps=3` in `CSI Ps J` (an XTerm extension, widely adopted).
-     * Sequence: `CSI 3J`.
-     * @remarks This mode is particularly useful for a more complete "reset" of the terminal view.
-     */
-    EntireScreenAndScrollback = 3
+* Defines the modes for erasing parts of the display using the ED (Erase in Display) sequence.
+* The ED sequence is `CSI Ps J`, where `Ps` is one of these mode values.
+* @see {@link eraseDisplay} for the function that generates ED sequences.
+* @see {@link https://vt100.net/docs/vt510-rm/ED.html} VT510 Erase in Display (ED) documentation.
+* @enum {number}
+*/
+declare enum EraseDisplayMode {
+  /**
+  * Clears from the current cursor position to the end of the screen (inclusive).
+  * If the cursor is at the top-left, this clears the entire screen.
+  * This corresponds to `Ps=0` (or `Ps` omitted) in `CSI Ps J`.
+  * Sequence: `CSI J` or `CSI 0J`.
+  */
+  ToEnd = 0,
+  /**
+  * Clears from the beginning of the screen to the current cursor position (inclusive).
+  * This corresponds to `Ps=1` in `CSI Ps J`.
+  * Sequence: `CSI 1J`.
+  */
+  ToBeginning = 1,
+  /**
+  * Clears the entire screen. The cursor position usually does not change, but this can be
+  * terminal-dependent. Some terminals might move the cursor to the home position (top-left).
+  * This corresponds to `Ps=2` in `CSI Ps J`.
+  * Sequence: `CSI 2J`.
+  */
+  EntireScreen = 2,
+  /**
+  * Clears the entire screen and, on supported terminals (like XTerm and derivatives),
+  * also deletes all lines saved in the scrollback buffer.
+  * This corresponds to `Ps=3` in `CSI Ps J` (an XTerm extension, widely adopted).
+  * Sequence: `CSI 3J`.
+  * @remarks This mode is particularly useful for a more complete "reset" of the terminal view.
+  */
+  EntireScreenAndScrollback = 3,
 }
 /**
- * Generates an ANSI escape sequence to erase parts of the display (ED - Erase in Display).
- * The specific sequence is `CSI <mode>J`, where `<mode>` is a parameter from {@link EraseDisplayMode}.
- *
- * - If `mode` is `EraseDisplayMode.ToEnd` (or `0`), the sequence can be shortened to `CSI J`.
- * - The function validates the input `mode`. If an invalid number is provided, it defaults to `EraseDisplayMode.ToEnd`.
- * @param mode The erase mode, specified as a value from `EraseDisplayMode` or its corresponding number (0, 1, 2, 3).
- * @returns The ANSI escape sequence string for erasing in display.
- * @example
- * ```typescript
- * import { eraseDisplay, EraseDisplayMode } from '@visulima/ansi/erase';
- *
- * // Erase from cursor to end of screen
- * process.stdout.write(eraseDisplay(EraseDisplayMode.ToEnd)); // or eraseDisplay(0)
- *
- * // Erase entire screen
- * process.stdout.write(eraseDisplay(EraseDisplayMode.EntireScreen)); // or eraseDisplay(2)
- *
- * // Erase entire screen and scrollback buffer
- * process.stdout.write(eraseDisplay(EraseDisplayMode.EntireScreenAndScrollback)); // or eraseDisplay(3)
- * ```
- * @see {@link EraseDisplayMode}
- * @see {@link https://vt100.net/docs/vt510-rm/ED.html} VT510 Erase in Display (ED) documentation.
- */
-export declare const eraseDisplay: (mode: EraseDisplayMode | 0 | 1 | 2 | 3) => string;
+* Generates an ANSI escape sequence to erase parts of the display (ED - Erase in Display).
+* The specific sequence is `CSI <mode>J`, where `<mode>` is a parameter from {@link EraseDisplayMode}.
+*
+* - If `mode` is `EraseDisplayMode.ToEnd` (or `0`), the sequence can be shortened to `CSI J`.
+* - The function validates the input `mode`. If an invalid number is provided, it defaults to `EraseDisplayMode.ToEnd`.
+* @param mode The erase mode, specified as a value from `EraseDisplayMode` or its corresponding number (0, 1, 2, 3).
+* @returns The ANSI escape sequence string for erasing in display.
+* @example
+* ```typescript
+* import { eraseDisplay, EraseDisplayMode } from '@visulima/ansi/erase';
+*
+* // Erase from cursor to end of screen
+* process.stdout.write(eraseDisplay(EraseDisplayMode.ToEnd)); // or eraseDisplay(0)
+*
+* // Erase entire screen
+* process.stdout.write(eraseDisplay(EraseDisplayMode.EntireScreen)); // or eraseDisplay(2)
+*
+* // Erase entire screen and scrollback buffer
+* process.stdout.write(eraseDisplay(EraseDisplayMode.EntireScreenAndScrollback)); // or eraseDisplay(3)
+* ```
+* @see {@link EraseDisplayMode}
+* @see {@link https://vt100.net/docs/vt510-rm/ED.html} VT510 Erase in Display (ED) documentation.
+*/
+declare const eraseDisplay: (mode: EraseDisplayMode | 0 | 1 | 2 | 3) => string;
 /**
- * Defines the modes for erasing parts of the current line using the EL (Erase in Line) sequence.
- * The EL sequence is `CSI Ps K`, where `Ps` is one of these mode values.
- * The cursor position is NOT affected by EL sequences.
- * @see {@link eraseInLine} for the function that generates EL sequences.
- * @see {@link https://vt100.net/docs/vt510-rm/EL.html} VT510 Erase in Line (EL) documentation.
- * @enum {number}
- */
-export declare enum EraseLineMode {
-    /**
-     * Clears from the current cursor position to the end of the line (inclusive).
-     * This corresponds to `Ps=0` (or `Ps` omitted) in `CSI Ps K`.
-     * Sequence: `CSI K` or `CSI 0K`.
-     */
-    ToEnd = 0,
-    /**
-     * Clears from the beginning of the line to the current cursor position (inclusive).
-     * This corresponds to `Ps=1` in `CSI Ps K`.
-     * Sequence: `CSI 1K`.
-     */
-    ToBeginning = 1,
-    /**
-     * Clears the entire current line.
-     * This corresponds to `Ps=2` in `CSI Ps K`.
-     * Sequence: `CSI 2K`.
-     */
-    EntireLine = 2
+* Defines the modes for erasing parts of the current line using the EL (Erase in Line) sequence.
+* The EL sequence is `CSI Ps K`, where `Ps` is one of these mode values.
+* The cursor position is NOT affected by EL sequences.
+* @see {@link eraseInLine} for the function that generates EL sequences.
+* @see {@link https://vt100.net/docs/vt510-rm/EL.html} VT510 Erase in Line (EL) documentation.
+* @enum {number}
+*/
+declare enum EraseLineMode {
+  /**
+  * Clears from the current cursor position to the end of the line (inclusive).
+  * This corresponds to `Ps=0` (or `Ps` omitted) in `CSI Ps K`.
+  * Sequence: `CSI K` or `CSI 0K`.
+  */
+  ToEnd = 0,
+  /**
+  * Clears from the beginning of the line to the current cursor position (inclusive).
+  * This corresponds to `Ps=1` in `CSI Ps K`.
+  * Sequence: `CSI 1K`.
+  */
+  ToBeginning = 1,
+  /**
+  * Clears the entire current line.
+  * This corresponds to `Ps=2` in `CSI Ps K`.
+  * Sequence: `CSI 2K`.
+  */
+  EntireLine = 2,
 }
 /**
- * Generates an ANSI escape sequence to erase parts of the current line (EL - Erase in Line).
- * The specific sequence is `CSI <mode>K`, where `<mode>` is a parameter from {@link EraseLineMode}.
- * The cursor position is NOT changed by this sequence.
- *
- * - If `mode` is `EraseLineMode.ToEnd` (or `0`), the sequence can be shortened to `CSI K`.
- * - The function validates the input `mode`. If an invalid number is provided, it defaults to `EraseLineMode.ToEnd`.
- * @param mode The erase mode, specified as a value from `EraseLineMode` or its corresponding number (0, 1, 2).
- * @returns The ANSI escape sequence string for erasing in line.
- * @example
- * ```typescript
- * import { eraseInLine, EraseLineMode } from '@visulima/ansi/erase';
- *
- * // Erase from cursor to end of line
- * process.stdout.write(eraseInLine(EraseLineMode.ToEnd)); // or eraseInLine(0)
- *
- * // Erase entire current line
- * process.stdout.write(eraseInLine(EraseLineMode.EntireLine)); // or eraseInLine(2)
- * ```
- * @see {@link EraseLineMode}
- * @see {@link https://vt100.net/docs/vt510-rm/EL.html} VT510 Erase in Line (EL) documentation.
- */
-export declare const eraseInLine: (mode: EraseLineMode | 0 | 1 | 2) => string;
+* Generates an ANSI escape sequence to erase parts of the current line (EL - Erase in Line).
+* The specific sequence is `CSI <mode>K`, where `<mode>` is a parameter from {@link EraseLineMode}.
+* The cursor position is NOT changed by this sequence.
+*
+* - If `mode` is `EraseLineMode.ToEnd` (or `0`), the sequence can be shortened to `CSI K`.
+* - The function validates the input `mode`. If an invalid number is provided, it defaults to `EraseLineMode.ToEnd`.
+* @param mode The erase mode, specified as a value from `EraseLineMode` or its corresponding number (0, 1, 2).
+* @returns The ANSI escape sequence string for erasing in line.
+* @example
+* ```typescript
+* import { eraseInLine, EraseLineMode } from '@visulima/ansi/erase';
+*
+* // Erase from cursor to end of line
+* process.stdout.write(eraseInLine(EraseLineMode.ToEnd)); // or eraseInLine(0)
+*
+* // Erase entire current line
+* process.stdout.write(eraseInLine(EraseLineMode.EntireLine)); // or eraseInLine(2)
+* ```
+* @see {@link EraseLineMode}
+* @see {@link https://vt100.net/docs/vt510-rm/EL.html} VT510 Erase in Line (EL) documentation.
+*/
+declare const eraseInLine: (mode: EraseLineMode | 0 | 1 | 2) => string;
 /**
- * Erases the screen from the current cursor position down to the bottom of the screen (inclusive).
- * This is a convenience constant for `eraseDisplay(EraseDisplayMode.ToEnd)`.
- * Sequence: `CSI J` (or `CSI 0J`).
- * @returns The ANSI escape sequence `CSI J`.
- * @see {@link eraseDisplay}
- * @see {@link EraseDisplayMode.ToEnd}
- */
-export declare const eraseDown: string;
+* Erases the screen from the current cursor position down to the bottom of the screen (inclusive).
+* This is a convenience constant for `eraseDisplay(EraseDisplayMode.ToEnd)`.
+* Sequence: `CSI J` (or `CSI 0J`).
+* @returns The ANSI escape sequence `CSI J`.
+* @see {@link eraseDisplay}
+* @see {@link EraseDisplayMode.ToEnd}
+*/
+declare const eraseDown: string;
 /**
- * Erases the entire current line. The cursor position does not change.
- * This is a convenience constant for `eraseInLine(EraseLineMode.EntireLine)`.
- * Sequence: `CSI 2K`.
- * @returns The ANSI escape sequence `CSI 2K`.
- * @see {@link eraseInLine}
- * @see {@link EraseLineMode.EntireLine}
- */
-export declare const eraseLine: string;
+* Erases the entire current line. The cursor position does not change.
+* This is a convenience constant for `eraseInLine(EraseLineMode.EntireLine)`.
+* Sequence: `CSI 2K`.
+* @returns The ANSI escape sequence `CSI 2K`.
+* @see {@link eraseInLine}
+* @see {@link EraseLineMode.EntireLine}
+*/
+declare const eraseLine: string;
 /**
- * Erases from the current cursor position to the end of the current line (inclusive).
- * The cursor position does not change.
- * This is a convenience constant for `eraseInLine(EraseLineMode.ToEnd)`.
- * Sequence: `CSI K` (or `CSI 0K`).
- * @returns The ANSI escape sequence `CSI K`.
- * @see {@link eraseInLine}
- * @see {@link EraseLineMode.ToEnd}
- */
-export declare const eraseLineEnd: string;
+* Erases from the current cursor position to the end of the current line (inclusive).
+* The cursor position does not change.
+* This is a convenience constant for `eraseInLine(EraseLineMode.ToEnd)`.
+* Sequence: `CSI K` (or `CSI 0K`).
+* @returns The ANSI escape sequence `CSI K`.
+* @see {@link eraseInLine}
+* @see {@link EraseLineMode.ToEnd}
+*/
+declare const eraseLineEnd: string;
 /**
- * Erases from the current cursor position to the beginning of the current line (inclusive).
- * The cursor position does not change.
- * This is a convenience constant for `eraseInLine(EraseLineMode.ToBeginning)`.
- * Sequence: `CSI 1K`.
- * @returns The ANSI escape sequence `CSI 1K`.
- * @see {@link eraseInLine}
- * @see {@link EraseLineMode.ToBeginning}
- */
-export declare const eraseLineStart: string;
+* Erases from the current cursor position to the beginning of the current line (inclusive).
+* The cursor position does not change.
+* This is a convenience constant for `eraseInLine(EraseLineMode.ToBeginning)`.
+* Sequence: `CSI 1K`.
+* @returns The ANSI escape sequence `CSI 1K`.
+* @see {@link eraseInLine}
+* @see {@link EraseLineMode.ToBeginning}
+*/
+declare const eraseLineStart: string;
 /**
- * Erases a specified number of lines, starting from the current line and moving upwards,
- * then moves the cursor to the beginning of the topmost erased line (which becomes the new current line).
- *
- * This is a custom helper function, not a single standard ANSI/VT sequence. It combines
- * multiple sequences: {@link eraseLine} to clear each line, {@link cursorUp} to move to the line above,
- * and finally {@link cursorToColumn1} to position the cursor at the start of the resulting current line.
- * @param count The total number of lines to erase. This includes the current line and `count-1` lines above it.
- * If `count` is 0 or negative, an empty string is returned (no operation).
- * @returns A string of concatenated ANSI escape sequences to perform the operation.
- * @example
- * ```typescript
- * import { eraseLines } from '@visulima/ansi/erase';
- *
- * // To erase the current line and the 2 lines above it (total 3 lines):
- * process.stdout.write(eraseLines(3));
- * // Conceptual sequence of operations:
- * // 1. Erase current line
- * // 2. Cursor up
- * // 3. Erase current line (which was the line above the original)
- * // 4. Cursor up
- * // 5. Erase current line (which was two lines above the original)
- * // 6. Cursor to column 1 (on this topmost erased line)
- * ```
- */
-export declare const eraseLines: (count: number) => string;
+* Erases a specified number of lines, starting from the current line and moving upwards,
+* then moves the cursor to the beginning of the topmost erased line (which becomes the new current line).
+*
+* This is a custom helper function, not a single standard ANSI/VT sequence. It combines
+* multiple sequences: {@link eraseLine} to clear each line, {@link cursorUp} to move to the line above,
+* and finally {@link cursorToColumn1} to position the cursor at the start of the resulting current line.
+* @param count The total number of lines to erase. This includes the current line and `count-1` lines above it.
+* If `count` is 0 or negative, an empty string is returned (no operation).
+* @returns A string of concatenated ANSI escape sequences to perform the operation.
+* @example
+* ```typescript
+* import { eraseLines } from '@visulima/ansi/erase';
+*
+* // To erase the current line and the 2 lines above it (total 3 lines):
+* process.stdout.write(eraseLines(3));
+* // Conceptual sequence of operations:
+* // 1. Erase current line
+* // 2. Cursor up
+* // 3. Erase current line (which was the line above the original)
+* // 4. Cursor up
+* // 5. Erase current line (which was two lines above the original)
+* // 6. Cursor to column 1 (on this topmost erased line)
+* ```
+*/
+declare const eraseLines: (count: number) => string;
 /**
- * Erases the entire screen. The cursor position usually does not change, though this can be terminal-dependent.
- * This is a convenience constant for `eraseDisplay(EraseDisplayMode.EntireScreen)`.
- * Sequence: `CSI 2J`.
- * @returns The ANSI escape sequence `CSI 2J`.
- * @see {@link eraseDisplay}
- * @see {@link EraseDisplayMode.EntireScreen}
- */
-export declare const eraseScreen: string;
+* Erases the entire screen. The cursor position usually does not change, though this can be terminal-dependent.
+* This is a convenience constant for `eraseDisplay(EraseDisplayMode.EntireScreen)`.
+* Sequence: `CSI 2J`.
+* @returns The ANSI escape sequence `CSI 2J`.
+* @see {@link eraseDisplay}
+* @see {@link EraseDisplayMode.EntireScreen}
+*/
+declare const eraseScreen: string;
 /**
- * Erases the screen from the current cursor position up to the top of the screen (inclusive).
- * This is a convenience constant for `eraseDisplay(EraseDisplayMode.ToBeginning)`.
- * Sequence: `CSI 1J`.
- * @returns The ANSI escape sequence `CSI 1J`.
- * @see {@link eraseDisplay}
- * @see {@link EraseDisplayMode.ToBeginning}
- */
-export declare const eraseUp: string;
+* Erases the screen from the current cursor position up to the top of the screen (inclusive).
+* This is a convenience constant for `eraseDisplay(EraseDisplayMode.ToBeginning)`.
+* Sequence: `CSI 1J`.
+* @returns The ANSI escape sequence `CSI 1J`.
+* @see {@link eraseDisplay}
+* @see {@link EraseDisplayMode.ToBeginning}
+*/
+declare const eraseUp: string;
 /**
- * Erases the entire screen and, on supported terminals (like XTerm and derivatives),
- * also deletes all lines saved in the scrollback buffer.
- * This is a convenience constant for `eraseDisplay(EraseDisplayMode.EntireScreenAndScrollback)`.
- * Sequence: `CSI 3J` (an XTerm extension, widely adopted).
- * @returns The ANSI escape sequence `CSI 3J`.
- * @remarks This mode is particularly useful for a more complete "reset" of the terminal view.
- * @see {@link eraseDisplay}
- * @see {@link EraseDisplayMode.EntireScreenAndScrollback}
- */
-export declare const eraseScreenAndScrollback: string;
+* Erases the entire screen and, on supported terminals (like XTerm and derivatives),
+* also deletes all lines saved in the scrollback buffer.
+* This is a convenience constant for `eraseDisplay(EraseDisplayMode.EntireScreenAndScrollback)`.
+* Sequence: `CSI 3J` (an XTerm extension, widely adopted).
+* @returns The ANSI escape sequence `CSI 3J`.
+* @remarks This mode is particularly useful for a more complete "reset" of the terminal view.
+* @see {@link eraseDisplay}
+* @see {@link EraseDisplayMode.EntireScreenAndScrollback}
+*/
+declare const eraseScreenAndScrollback: string;
+export { EraseDisplayMode, EraseLineMode, eraseDisplay, eraseDown, eraseInLine, eraseLine, eraseLineEnd, eraseLineStart, eraseLines, eraseScreen, eraseScreenAndScrollback, eraseUp };

package/dist/erase.js

@@ -1,47 +1 @@
-import { C as CSI } from './packem_shared/constants-CE7WkXh_.js';
-import { w as cursorUp, v as cursorToColumn1 } from './packem_shared/cursor-ChpV7cgs.js';
-
-var EraseDisplayMode = /* @__PURE__ */ ((EraseDisplayMode2) => {
-  EraseDisplayMode2[EraseDisplayMode2["ToEnd"] = 0] = "ToEnd";
-  EraseDisplayMode2[EraseDisplayMode2["ToBeginning"] = 1] = "ToBeginning";
-  EraseDisplayMode2[EraseDisplayMode2["EntireScreen"] = 2] = "EntireScreen";
-  EraseDisplayMode2[EraseDisplayMode2["EntireScreenAndScrollback"] = 3] = "EntireScreenAndScrollback";
-  return EraseDisplayMode2;
-})(EraseDisplayMode || {});
-const eraseDisplay = (mode) => {
-  const validMode = mode >= 0 && mode <= 3 ? mode : 0 /* ToEnd */;
-  return `${CSI}${validMode === 0 /* ToEnd */ ? "" : String(validMode)}J`;
-};
-var EraseLineMode = /* @__PURE__ */ ((EraseLineMode2) => {
-  EraseLineMode2[EraseLineMode2["ToEnd"] = 0] = "ToEnd";
-  EraseLineMode2[EraseLineMode2["ToBeginning"] = 1] = "ToBeginning";
-  EraseLineMode2[EraseLineMode2["EntireLine"] = 2] = "EntireLine";
-  return EraseLineMode2;
-})(EraseLineMode || {});
-const eraseInLine = (mode) => {
-  const validMode = mode >= 0 && mode <= 2 ? mode : 0 /* ToEnd */;
-  return `${CSI}${validMode === 0 /* ToEnd */ ? "" : String(validMode)}K`;
-};
-const eraseDown = eraseDisplay(0 /* ToEnd */);
-const eraseLine = eraseInLine(2 /* EntireLine */);
-const eraseLineEnd = eraseInLine(0 /* ToEnd */);
-const eraseLineStart = eraseInLine(1 /* ToBeginning */);
-const eraseLines = (count) => {
-  if (count <= 0) {
-    return "";
-  }
-  let clear = "";
-  for (let index = 0; index < count; index += 1) {
-    clear += eraseLine;
-    if (index < count - 1) {
-      clear += cursorUp();
-    }
-  }
-  clear += cursorToColumn1;
-  return clear;
-};
-const eraseScreen = eraseDisplay(2 /* EntireScreen */);
-const eraseUp = eraseDisplay(1 /* ToBeginning */);
-const eraseScreenAndScrollback = eraseDisplay(3 /* EntireScreenAndScrollback */);
-
-export { EraseDisplayMode, EraseLineMode, eraseDisplay, eraseDown, eraseInLine, eraseLine, eraseLineEnd, eraseLineStart, eraseLines, eraseScreen, eraseScreenAndScrollback, 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,27 +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.
- */
+* 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 default hyperlink;
+export { hyperlink as default };

package/dist/hyperlink.js

@@ -1,5 +1 @@
-import { O as OSC, S as SEP, B as BEL } from './packem_shared/constants-CE7WkXh_.js';
-
-const hyperlink = (text, url) => [OSC, "8", SEP, SEP, url, BEL, text, OSC, "8", SEP, SEP, BEL].join("");
-
-export { hyperlink 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};