@retrovm/terminal 0.1.1 → 0.1.3

package/dist/node.js

@@ -311,6 +311,7 @@ import { format } from "node:util";
 class TerminalCore {
   writer;
   plain;
+  _altScreen = false;
   constructor(writer, options = {}) {
     this.writer = writer;
     const envNoColor = typeof process !== "undefined" && !!process?.env?.NO_COLOR;
@@ -341,9 +342,12 @@ class TerminalCore {
     const color = typeof c === "string" ? new Color(c) : c;
     return this.style(color.toAnsiBackgroundRGB(), fmt, args);
   }
-  reset(fmt = "", ...args) {
+  resetText(fmt = "", ...args) {
     return this.style("\x1B[0m", fmt, args);
   }
+  reset(fmt = "", ...args) {
+    return this.cursor(true).alt(false).style("\x1B[0m", fmt, args);
+  }
   resetInk(fmt = "", ...args) {
     return this.style("\x1B[39m", fmt, args);
   }
@@ -399,7 +403,10 @@ class TerminalCore {
     return this;
   }
   alt(b = true) {
-    this.emit(`\x1B[?1049${b ? "h" : "l"}`);
+    if (b !== this._altScreen) {
+      this.emit(`\x1B[?1049${b ? "h" : "l"}`);
+      this._altScreen = b;
+    }
     return this;
   }
   autoWrap(b = true) {

package/dist/terminal.d.ts

@@ -40,6 +40,7 @@ declare class TerminalCore {
     private readonly writer;
     /** ANSI is suppressed when true; styling/cursor methods become no-ops. */
     plain: boolean;
+    private _altScreen;
     [key: string]: unknown;
     constructor(writer: ITerminalWriter, options?: {
         plain?: boolean;
@@ -56,7 +57,24 @@ declare class TerminalCore {
     ink(c: string | Color, fmt?: string, ...args: unknown[]): this;
     /** Sets the background color and optionally writes formatted text. */
     paper(c: string | Color, fmt?: string, ...args: unknown[]): this;
-    /** Resets all attributes (color, background, intensity, …). */
+    /**
+     * Resets all text attributes (color, background, bold, dim, italic,
+     * underline, blink, reverse, …) by emitting `\x1b[0m`.
+     *
+     * Unlike {@link reset}, this does **not** touch the cursor visibility
+     * or the alternate screen buffer.
+     */
+    resetText(fmt?: string, ...args: unknown[]): this;
+    /**
+     * Fully resets the terminal to a clean state.
+     *
+     * In order:
+     * 1. Shows the cursor (`cursor(true)`)
+     * 2. Exits the alternate screen buffer (`alt(false)`)
+     * 3. Resets all text attributes — color, background, intensity, etc. (`\x1b[0m`)
+     *
+     * Safe to call as a teardown step after any TUI or interactive session.
+     */
     reset(fmt?: string, ...args: unknown[]): this;
     /** Resets only the foreground color. */
     resetInk(fmt?: string, ...args: unknown[]): this;

package/dist/terminal.js

@@ -311,6 +311,7 @@ import { format } from "node:util";
 class TerminalCore {
   writer;
   plain;
+  _altScreen = false;
   constructor(writer, options = {}) {
     this.writer = writer;
     const envNoColor = typeof process !== "undefined" && !!process?.env?.NO_COLOR;
@@ -341,9 +342,12 @@ class TerminalCore {
     const color = typeof c === "string" ? new Color(c) : c;
     return this.style(color.toAnsiBackgroundRGB(), fmt, args);
   }
-  reset(fmt = "", ...args) {
+  resetText(fmt = "", ...args) {
     return this.style("\x1B[0m", fmt, args);
   }
+  reset(fmt = "", ...args) {
+    return this.cursor(true).alt(false).style("\x1B[0m", fmt, args);
+  }
   resetInk(fmt = "", ...args) {
     return this.style("\x1B[39m", fmt, args);
   }
@@ -399,7 +403,10 @@ class TerminalCore {
     return this;
   }
   alt(b = true) {
-    this.emit(`\x1B[?1049${b ? "h" : "l"}`);
+    if (b !== this._altScreen) {
+      this.emit(`\x1B[?1049${b ? "h" : "l"}`);
+      this._altScreen = b;
+    }
     return this;
   }
   autoWrap(b = true) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrovm/terminal",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Fluent ANSI terminal library — 24-bit color, cursor control and screen management for Bun and Node.js",
   "author": "Juan Carlos González Amestoy",
   "license": "MIT",

package/src/terminal.ts

@@ -62,6 +62,8 @@ class TerminalCore {
   /** ANSI is suppressed when true; styling/cursor methods become no-ops. */
   public plain: boolean
 
+  private _altScreen = false;
+
   // Allows the auto-attached color methods to typecheck on `this`.
   [key: string]: unknown
 
@@ -116,11 +118,31 @@ class TerminalCore {
     return this.style(color.toAnsiBackgroundRGB(), fmt, args)
   }
 
-  /** Resets all attributes (color, background, intensity, …). */
-  reset(fmt: string = '', ...args: unknown[]): this {
+  /**
+   * Resets all text attributes (color, background, bold, dim, italic,
+   * underline, blink, reverse, …) by emitting `\x1b[0m`.
+   *
+   * Unlike {@link reset}, this does **not** touch the cursor visibility
+   * or the alternate screen buffer.
+   */
+  resetText(fmt: string = '', ...args: unknown[]): this {
     return this.style('\x1b[0m', fmt, args)
   }
 
+  /**
+   * Fully resets the terminal to a clean state.
+   *
+   * In order:
+   * 1. Shows the cursor (`cursor(true)`)
+   * 2. Exits the alternate screen buffer (`alt(false)`)
+   * 3. Resets all text attributes — color, background, intensity, etc. (`\x1b[0m`)
+   *
+   * Safe to call as a teardown step after any TUI or interactive session.
+   */
+  reset(fmt: string = '', ...args: unknown[]): this {
+    return this.cursor(true).alt(false).style('\x1b[0m', fmt, args)
+  }
+
   /** Resets only the foreground color. */
   resetInk(fmt: string = '', ...args: unknown[]): this {
     return this.style('\x1b[39m', fmt, args)
@@ -192,7 +214,10 @@ class TerminalCore {
 
   /** Enables or disables the alternate screen buffer. */
   alt(b: boolean = true): this {
-    this.emit(`\x1b[?1049${b ? 'h' : 'l'}`)
+    if (b !== this._altScreen) {
+      this.emit(`\x1b[?1049${b ? 'h' : 'l'}`)
+      this._altScreen = b
+    }
     return this
   }