@retrovm/terminal 0.1.1 → 0.1.2

package/dist/node.js

@@ -341,9 +341,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);
   }

package/dist/terminal.d.ts

@@ -56,7 +56,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

@@ -341,9 +341,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);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrovm/terminal",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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

@@ -116,11 +116,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)