termkit 2.2.0 → 2.3.1

package/README.md

@@ -521,17 +521,40 @@ console.log('CPU  ' + Chart.Sparkline(samples, { style: (s) => Color.green(s) })
 
 Options: `min`, `max`, `style`.
 
-### Bar — ETA and rate tracking
+### Bar
 
-Attach progress tracking to an animated `Bar` with `.track()` and `.tick()`.
+Animated progress bar. Pass text as the first argument and options second:
 
 ```ts
 import { Bar } from 'termkit'
 
+const bar = new Bar('Processing…', { progress: 0 })
+bar.start()
+```
+
+Update the inline label while running:
+
+```ts
+bar.update('Uploading assets…')
+```
+
+Write a persistent log line while the bar keeps running. The default glyph is a faint `·`; pass any string — plain or pre-colored — as the second argument to override it:
+
+```ts
+bar.log('Processed batch 3')
+bar.log('Skipped 4 files', '→')
+bar.log('Error on item 12', Color.hex('#ef4444')('✖'))
+bar.log('No glyph line', '')
+```
+
+#### ETA and rate tracking
+
+Attach progress tracking with `.track()` and `.tick()`:
+
+```ts
 const total = 500
-const bar = new Bar({ progress: 0 })
+const bar = new Bar('Processing…', { progress: 0 })
 bar.track(total, { showRate: true, showEta: true, unit: 'files' })
-bar.message('Processing…')
 bar.start()
 
 for await (const item of items) {
@@ -539,7 +562,6 @@ for await (const item of items) {
   bar.tick()
 }
 
-bar.stop()
 bar.succeed(`Done — ${total} files processed`)
 ```
 
@@ -552,7 +574,23 @@ bar.rate  // units per second (number)
 bar.eta   // estimated seconds remaining (number)
 ```
 
-Options on `track(total, opts?)`: `unit` (label appended to rate), `showRate` (default `true`), `showEta` (default `true`). Both can also be set via constructor: `new Bar({ showRate: true, showEta: true, rateUnit: 'MB' })`.
+Options on `track(total, opts?)`: `unit` (label appended to rate), `showRate` (default `true`), `showEta` (default `true`). Both can also be set via constructor options: `new Bar('Uploading…', { showRate: true, showEta: true, rateUnit: 'MB' })`.
+
+#### Bar.current
+
+`Bar.current` follows the same pattern as `Spinner.current` — set on `.start()`, cleared on any terminal method. Use it to reach the active bar from deep in processing loops or error handlers:
+
+```ts
+const bar = new Bar('Processing…', { progress: 0 })
+bar.track(total)
+bar.start()
+
+// from a utility function
+Bar.current?.update('Flushing cache…')
+
+// in a catch block
+Bar.current?.fail(`Failed: ${err.message}`)
+```
 
 ### MultiBar
 
@@ -581,7 +619,7 @@ deploy.succeed('Deployed')
 multi.stop()
 ```
 
-Each `add()` call accepts the same options as `Bar` and returns a `Bar` instance — `.message()`, `.tick()`, `.track()`, `.progress`, and the completion methods all work the same way. Bars must be added before `.start()`.
+Each `add()` call accepts the same options as `Bar` and returns a `Bar` instance — `.update()`, `.tick()`, `.track()`, `.progress`, and the completion methods all work the same way. Bars must be added before `.start()`.
 
 Options: `interval`.
 
@@ -592,7 +630,7 @@ Animated spinner for indeterminate work. Shares the same completion API as `Bar`
 ```ts
 import { Spinner } from 'termkit'
 
-const spinner = new Spinner({ text: 'Loading…' })
+const spinner = new Spinner('Loading…')
 spinner.start()
 
 await doWork()
@@ -600,21 +638,75 @@ await doWork()
 spinner.succeed('Done')
 ```
 
-Update the label while running:
+Pass options as the second argument:
 
 ```ts
-spinner.message('Still working…')
+const spinner = new Spinner('Thinking…', { frames: Spinner.FRAMES.dots, interval: 60 })
+```
+
+Update the inline label while running:
+
+```ts
+spinner.update('Still working…')
+```
+
+Use `prefix` and `suffix` to bookend the text independently of the spinner frame, which always stays at the far left. Spaces between the parts are automatic:
+
+```ts
+// renders: ⠋ 0 files copied
+const spinner = new Spinner('files copied')
+spinner.start()
+spinner.prefix(String(count))   // ⠋ 42 files copied
+spinner.suffix('(estimating…)') // ⠋ 42 files copied (estimating…)
+```
+
+All three — `update()`, `prefix()`, and `suffix()` — are chainable and can be called while the spinner is running.
+
+Write a persistent log line while the spinner keeps running. The default glyph is a faint `·`; pass any string — plain or pre-colored — as the second argument to override it:
+
+```ts
+spinner.log('Fetched 42 items')
+spinner.log('Fetched 42 items', '→')
+spinner.log('Fetched 42 items', Color.hex('#00ff00')('✔'))
+spinner.log('Fetched 42 items', '')  // no glyph
+```
+
+The completion methods accept a custom glyph color via `successColor`, `failColor`, `warnColor`, and `infoColor` — the glyph is colored, the message text is left unstyled:
+
+```ts
+const spinner = new Spinner('Deploying…', { successColor: '#a855f7', failColor: '#ef4444' })
+spinner.succeed('Build complete')   // purple ✔
+spinner.fail('Connection refused')  // red ✖
+```
+
+#### Spinner.current
+
+`Spinner.current` is automatically set to whichever spinner called `.start()` most recently, and cleared when it terminates. Use it to reach the active spinner from helpers, error handlers, or signal listeners without passing the instance around:
+
+```ts
+// top-level handler
+const spinner = new Spinner('Deploying…')
+spinner.start()
+
+// anywhere else in your app
+Spinner.current?.update('Uploading assets…')
+
+// in a catch block
+Spinner.current?.fail(`Deploy failed: ${err.message}`)
+
+// in a SIGTERM handler — ?. is intentional: a spinner may not be running
+process.on('SIGTERM', () => Spinner.current?.stop('Interrupted'))
 ```
 
 Built-in frame sets are available on `Spinner.FRAMES`:
 
 ```ts
-new Spinner({ frames: Spinner.FRAMES.dots, text: 'Thinking…' }).start()
+new Spinner('Thinking…', { frames: Spinner.FRAMES.dots }).start()
 ```
 
 Frame sets: `braille`, `dots`, `line`, `arrow`, `bounce`.
 
-Options: `frames`, `text`, `prefix`, `suffix`, `reverse`, `interval`, `colors`, `bgColors`, `colorCycle`, `shimmer`, `successColor`, `failColor`, `warnColor`, `infoColor`, `glyphs`.
+Options: `frames`, `prefix`, `suffix`, `reverse`, `interval`, `colors`, `bgColors`, `colorCycle`, `shimmer`, `successColor`, `failColor`, `warnColor`, `infoColor`, `glyphs`.
 
 ### Scrollbox
 

package/dist/index.js

@@ -1041,8 +1041,8 @@ var Command = class {
 };
 
 // src/models/Bar.ts
-var Bar = class {
-  constructor(options = {}) {
+var _Bar = class _Bar {
+  constructor(text, options) {
     // used by MultiBar — not intended for direct external use
     this._isManaged = false;
     this._managedFinalLine = null;
@@ -1060,37 +1060,38 @@ var Bar = class {
     this._tickCount = 0;
     this._startTime = null;
     this._etaSuffix = "";
+    const opts = typeof text === "string" ? { ...options, text } : text ?? {};
     this.running = false;
     this.forwardMotion = true;
-    this._autoLength = options.length === void 0;
-    this.length = options.length ?? process.stdout.columns ?? 80;
-    this.prefixString = options.prefix ?? "[";
-    this.suffixString = options.suffix ?? "]";
-    this.character = options.character ?? "\u2500\u2500";
-    this.beforeEmpty = options.before ?? " ";
-    this.afterEmpty = options.after ?? " ";
+    this._autoLength = opts.length === void 0;
+    this.length = opts.length ?? process.stdout.columns ?? 80;
+    this.prefixString = opts.prefix ?? "[";
+    this.suffixString = opts.suffix ?? "]";
+    this.character = opts.character ?? "\u2500\u2500";
+    this.beforeEmpty = opts.before ?? " ";
+    this.afterEmpty = opts.after ?? " ";
     this.position = 1;
-    this.interval = options.interval ?? 35;
-    this.mode = options.mode ?? "bounce";
-    this.progress = options.progress;
-    this.colorFill = options.colorFill ?? false;
-    this.colorCycle = options.colorCycle ?? 0.5;
-    this.shimmer = options.shimmer ?? 0;
-    this.text = options.text ?? "";
-    this.reverse = options.reverse ?? false;
-    this.onBounce = options.onBounce;
-    this.onLoop = options.onLoop;
-    this.onComplete = options.onComplete;
-    this.colors = options.colors ?? ["#c026d3", "#e879f9"];
-    this.bgColors = options.bgColors ?? [];
-    this._successColor = options.successColor ?? GREEN;
-    this._failColor = options.failColor ?? RED;
-    this._warnColor = options.warnColor ?? YELLOW;
-    this._infoColor = options.infoColor ?? BLUE;
-    this._glyphs = options.glyphs ?? true;
-    this._showRate = options.showRate ?? false;
-    this._showEta = options.showEta ?? false;
-    this._rateUnit = options.rateUnit ?? "";
+    this.interval = opts.interval ?? 35;
+    this.mode = opts.mode ?? "bounce";
+    this.progress = opts.progress;
+    this.colorFill = opts.colorFill ?? false;
+    this.colorCycle = opts.colorCycle ?? 0.5;
+    this.shimmer = opts.shimmer ?? 0;
+    this.text = opts.text ?? "";
+    this.reverse = opts.reverse ?? false;
+    this.onBounce = opts.onBounce;
+    this.onLoop = opts.onLoop;
+    this.onComplete = opts.onComplete;
+    this.colors = opts.colors ?? ["#c026d3", "#e879f9"];
+    this.bgColors = opts.bgColors ?? [];
+    this._successColor = opts.successColor ?? GREEN;
+    this._failColor = opts.failColor ?? RED;
+    this._warnColor = opts.warnColor ?? YELLOW;
+    this._infoColor = opts.infoColor ?? BLUE;
+    this._glyphs = opts.glyphs ?? true;
+    this._showRate = opts.showRate ?? false;
+    this._showEta = opts.showEta ?? false;
+    this._rateUnit = opts.rateUnit ?? "";
   }
   get colors() {
     return this._colors;
@@ -1139,6 +1140,7 @@ var Bar = class {
     if (this._isManaged) return;
     if (!process.stdout.isTTY) return;
     this.running = true;
+    _Bar.current = this;
     process.stdout.write(HIDE_CURSOR);
     this._cleanupDeregister = registerCleanup(() => {
       this.running = false;
@@ -1164,6 +1166,7 @@ var Bar = class {
       this._managedFinalLine = message ?? "";
       return this;
     }
+    if (_Bar.current === this) _Bar.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -1178,10 +1181,18 @@ var Bar = class {
 `);
     return this;
   }
-  message(string) {
+  update(string) {
     this.text = string;
     return this;
   }
+  log(message, glyph = `${FAINT}\xB7${RESET}`) {
+    if (process.stdout.isTTY) {
+      this.clear();
+    }
+    process.stdout.write(`${glyph ? `${glyph} ` : ""}${message}
+`);
+    return this;
+  }
   track(total, options) {
     this._total = total;
     this._tickCount = 0;
@@ -1228,6 +1239,7 @@ var Bar = class {
   }
   succeed(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._successColor, "\u2714") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1251,6 +1263,7 @@ var Bar = class {
   }
   fail(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._failColor, "\u2716") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1274,6 +1287,7 @@ var Bar = class {
   }
   warn(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._warnColor, "\u26A0") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1297,6 +1311,7 @@ var Bar = class {
   }
   info(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._infoColor, "\u2139") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1464,7 +1479,8 @@ var Bar = class {
     }, this.interval);
   }
 };
-Bar.COLORS = {
+_Bar.current = null;
+_Bar.COLORS = {
   blueRed: ["#0000ff", "#ff0000"],
   redBlue: ["#ff0000", "#0000ff"],
   rainbow: ["#ff0000", "#ff7f00", "#ffff00", "#00ff00", "#0000ff", "#8b00ff"],
@@ -1472,6 +1488,7 @@ Bar.COLORS = {
   cool: ["#00ffff", "#0000ff", "#8b00ff"],
   sunset: ["#8b00ff", "#ff0000", "#ff7f00"]
 };
+var Bar = _Bar;
 
 // src/models/Chart.ts
 var Chart_exports = {};
@@ -1995,7 +2012,7 @@ var MultiBar = class {
     this._interval = options.interval ?? 35;
   }
   // Add a bar to the group. Must be called before start().
-  // Returns the Bar instance — use .message(), .progress, .tick(), .succeed(), etc.
+  // Returns the Bar instance — use .update(), .progress, .tick(), .succeed(), etc.
   add(options = {}) {
     const bar = new Bar(options);
     bar._isManaged = true;
@@ -2463,7 +2480,7 @@ async function scrollbox(lines, options) {
 
 // src/models/Spinner.ts
 var _Spinner = class _Spinner {
-  constructor(options = {}) {
+  constructor(text, options) {
     this._colors = [];
     this._parsedColors = [];
     this._bgColors = [];
@@ -2472,24 +2489,25 @@ var _Spinner = class _Spinner {
     this._shimmerPhase = 0;
     this._lastLineLength = 0;
     this._cleanupDeregister = null;
+    const opts = typeof text === "string" ? { ...options, text } : text ?? {};
     this.running = false;
     this.frameIndex = 0;
-    this.frames = options.frames ?? (config.glyphs ? _Spinner.FRAMES.braille : _Spinner.FRAMES.line);
-    this.prefixString = options.prefix ?? "";
-    this.suffixString = options.suffix ?? "";
-    this.text = options.text ?? "";
-    this.reverse = options.reverse ?? false;
-    this.interval = options.interval ?? 80;
-    this.colorCycle = options.colorCycle ?? 1;
-    this.shimmer = options.shimmer ?? 0;
-    this.onSpin = options.onSpin;
-    this.colors = options.colors ?? ["#c026d3", "#e879f9"];
-    this.bgColors = options.bgColors ?? [];
-    this._successColor = options.successColor ?? GREEN;
-    this._failColor = options.failColor ?? RED;
-    this._warnColor = options.warnColor ?? YELLOW;
-    this._infoColor = options.infoColor ?? BLUE;
-    this._glyphs = options.glyphs ?? config.glyphs;
+    this.frames = opts.frames ?? (config.glyphs ? _Spinner.FRAMES.braille : _Spinner.FRAMES.line);
+    this._prefix = opts.prefix ?? "";
+    this._suffix = opts.suffix ?? "";
+    this.text = opts.text ?? "";
+    this.reverse = opts.reverse ?? false;
+    this.interval = opts.interval ?? 80;
+    this.colorCycle = opts.colorCycle ?? 1;
+    this.shimmer = opts.shimmer ?? 0;
+    this.onSpin = opts.onSpin;
+    this.colors = opts.colors ?? ["#c026d3", "#e879f9"];
+    this.bgColors = opts.bgColors ?? [];
+    this._successColor = opts.successColor ?? GREEN;
+    this._failColor = opts.failColor ?? RED;
+    this._warnColor = opts.warnColor ?? YELLOW;
+    this._infoColor = opts.infoColor ?? BLUE;
+    this._glyphs = opts.glyphs ?? config.glyphs;
   }
   get colors() {
     return this._colors;
@@ -2508,6 +2526,7 @@ var _Spinner = class _Spinner {
   start() {
     if (!process.stdout.isTTY) return;
     this.running = true;
+    _Spinner.current = this;
     process.stdout.write(HIDE_CURSOR);
     this._cleanupDeregister = registerCleanup(() => {
       this.running = false;
@@ -2518,6 +2537,7 @@ var _Spinner = class _Spinner {
   }
   stop(message) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2528,12 +2548,21 @@ var _Spinner = class _Spinner {
 `);
     return this;
   }
-  message(string) {
+  update(string) {
     this.text = string;
     return this;
   }
+  prefix(string) {
+    this._prefix = string;
+    return this;
+  }
+  suffix(string) {
+    this._suffix = string;
+    return this;
+  }
   succeed(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2549,6 +2578,7 @@ var _Spinner = class _Spinner {
   }
   fail(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2564,6 +2594,7 @@ var _Spinner = class _Spinner {
   }
   warn(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2579,6 +2610,7 @@ var _Spinner = class _Spinner {
   }
   info(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2592,6 +2624,14 @@ var _Spinner = class _Spinner {
     }
     return this;
   }
+  log(message, glyph = `${FAINT}\xB7${RESET}`) {
+    if (process.stdout.isTTY) {
+      this.clear();
+    }
+    process.stdout.write(`${glyph ? `${glyph} ` : ""}${message}
+`);
+    return this;
+  }
   clear() {
     process.stdout.clearLine?.(0);
     this._lastLineLength = 0;
@@ -2606,9 +2646,9 @@ var _Spinner = class _Spinner {
   }
   run() {
     const frame = this.coloredFrame();
-    const t = this.text;
-    const content = this.reverse ? t ? `${t} ${frame}` : frame : t ? `${frame} ${t}` : frame;
-    const raw = `${this.prefixString}${content}${this.suffixString}`;
+    const label = [this._prefix, this.text, this._suffix].filter(Boolean).join(" ");
+    const content = this.reverse ? label ? `${label} ${frame}` : frame : label ? `${frame} ${label}` : frame;
+    const raw = content;
     const displayLen = stringLength(raw);
     const padding = " ".repeat(Math.max(0, this._lastLineLength - displayLen));
     this._lastLineLength = displayLen;
@@ -2626,6 +2666,7 @@ var _Spinner = class _Spinner {
     }, this.interval);
   }
 };
+_Spinner.current = null;
 _Spinner.FRAMES = {
   braille: ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"],
   dots: ["\u28FE", "\u28FD", "\u28FB", "\u28BF", "\u287F", "\u28DF", "\u28EF", "\u28F7"],

package/dist/index.mjs

@@ -981,8 +981,8 @@ var Command = class {
 };
 
 // src/models/Bar.ts
-var Bar = class {
-  constructor(options = {}) {
+var _Bar = class _Bar {
+  constructor(text, options) {
     // used by MultiBar — not intended for direct external use
     this._isManaged = false;
     this._managedFinalLine = null;
@@ -1000,37 +1000,38 @@ var Bar = class {
     this._tickCount = 0;
     this._startTime = null;
     this._etaSuffix = "";
+    const opts = typeof text === "string" ? { ...options, text } : text ?? {};
     this.running = false;
     this.forwardMotion = true;
-    this._autoLength = options.length === void 0;
-    this.length = options.length ?? process.stdout.columns ?? 80;
-    this.prefixString = options.prefix ?? "[";
-    this.suffixString = options.suffix ?? "]";
-    this.character = options.character ?? "\u2500\u2500";
-    this.beforeEmpty = options.before ?? " ";
-    this.afterEmpty = options.after ?? " ";
+    this._autoLength = opts.length === void 0;
+    this.length = opts.length ?? process.stdout.columns ?? 80;
+    this.prefixString = opts.prefix ?? "[";
+    this.suffixString = opts.suffix ?? "]";
+    this.character = opts.character ?? "\u2500\u2500";
+    this.beforeEmpty = opts.before ?? " ";
+    this.afterEmpty = opts.after ?? " ";
     this.position = 1;
-    this.interval = options.interval ?? 35;
-    this.mode = options.mode ?? "bounce";
-    this.progress = options.progress;
-    this.colorFill = options.colorFill ?? false;
-    this.colorCycle = options.colorCycle ?? 0.5;
-    this.shimmer = options.shimmer ?? 0;
-    this.text = options.text ?? "";
-    this.reverse = options.reverse ?? false;
-    this.onBounce = options.onBounce;
-    this.onLoop = options.onLoop;
-    this.onComplete = options.onComplete;
-    this.colors = options.colors ?? ["#c026d3", "#e879f9"];
-    this.bgColors = options.bgColors ?? [];
-    this._successColor = options.successColor ?? GREEN;
-    this._failColor = options.failColor ?? RED;
-    this._warnColor = options.warnColor ?? YELLOW;
-    this._infoColor = options.infoColor ?? BLUE;
-    this._glyphs = options.glyphs ?? true;
-    this._showRate = options.showRate ?? false;
-    this._showEta = options.showEta ?? false;
-    this._rateUnit = options.rateUnit ?? "";
+    this.interval = opts.interval ?? 35;
+    this.mode = opts.mode ?? "bounce";
+    this.progress = opts.progress;
+    this.colorFill = opts.colorFill ?? false;
+    this.colorCycle = opts.colorCycle ?? 0.5;
+    this.shimmer = opts.shimmer ?? 0;
+    this.text = opts.text ?? "";
+    this.reverse = opts.reverse ?? false;
+    this.onBounce = opts.onBounce;
+    this.onLoop = opts.onLoop;
+    this.onComplete = opts.onComplete;
+    this.colors = opts.colors ?? ["#c026d3", "#e879f9"];
+    this.bgColors = opts.bgColors ?? [];
+    this._successColor = opts.successColor ?? GREEN;
+    this._failColor = opts.failColor ?? RED;
+    this._warnColor = opts.warnColor ?? YELLOW;
+    this._infoColor = opts.infoColor ?? BLUE;
+    this._glyphs = opts.glyphs ?? true;
+    this._showRate = opts.showRate ?? false;
+    this._showEta = opts.showEta ?? false;
+    this._rateUnit = opts.rateUnit ?? "";
   }
   get colors() {
     return this._colors;
@@ -1079,6 +1080,7 @@ var Bar = class {
     if (this._isManaged) return;
     if (!process.stdout.isTTY) return;
     this.running = true;
+    _Bar.current = this;
     process.stdout.write(HIDE_CURSOR);
     this._cleanupDeregister = registerCleanup(() => {
       this.running = false;
@@ -1104,6 +1106,7 @@ var Bar = class {
       this._managedFinalLine = message ?? "";
       return this;
     }
+    if (_Bar.current === this) _Bar.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -1118,10 +1121,18 @@ var Bar = class {
 `);
     return this;
   }
-  message(string) {
+  update(string) {
     this.text = string;
     return this;
   }
+  log(message, glyph = `${FAINT}\xB7${RESET}`) {
+    if (process.stdout.isTTY) {
+      this.clear();
+    }
+    process.stdout.write(`${glyph ? `${glyph} ` : ""}${message}
+`);
+    return this;
+  }
   track(total, options) {
     this._total = total;
     this._tickCount = 0;
@@ -1168,6 +1179,7 @@ var Bar = class {
   }
   succeed(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._successColor, "\u2714") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1191,6 +1203,7 @@ var Bar = class {
   }
   fail(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._failColor, "\u2716") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1214,6 +1227,7 @@ var Bar = class {
   }
   warn(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._warnColor, "\u26A0") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1237,6 +1251,7 @@ var Bar = class {
   }
   info(string) {
     this.running = false;
+    if (_Bar.current === this) _Bar.current = null;
     if (this._isManaged) {
       const glyph = this._glyphs ? colorText(this._infoColor, "\u2139") + " " : "";
       this._managedFinalLine = `${glyph}${string ?? ""}`;
@@ -1404,7 +1419,8 @@ var Bar = class {
     }, this.interval);
   }
 };
-Bar.COLORS = {
+_Bar.current = null;
+_Bar.COLORS = {
   blueRed: ["#0000ff", "#ff0000"],
   redBlue: ["#ff0000", "#0000ff"],
   rainbow: ["#ff0000", "#ff7f00", "#ffff00", "#00ff00", "#0000ff", "#8b00ff"],
@@ -1412,6 +1428,7 @@ Bar.COLORS = {
   cool: ["#00ffff", "#0000ff", "#8b00ff"],
   sunset: ["#8b00ff", "#ff0000", "#ff7f00"]
 };
+var Bar = _Bar;
 
 // src/models/Chart.ts
 var Chart_exports = {};
@@ -1935,7 +1952,7 @@ var MultiBar = class {
     this._interval = options.interval ?? 35;
   }
   // Add a bar to the group. Must be called before start().
-  // Returns the Bar instance — use .message(), .progress, .tick(), .succeed(), etc.
+  // Returns the Bar instance — use .update(), .progress, .tick(), .succeed(), etc.
   add(options = {}) {
     const bar = new Bar(options);
     bar._isManaged = true;
@@ -2403,7 +2420,7 @@ async function scrollbox(lines, options) {
 
 // src/models/Spinner.ts
 var _Spinner = class _Spinner {
-  constructor(options = {}) {
+  constructor(text, options) {
     this._colors = [];
     this._parsedColors = [];
     this._bgColors = [];
@@ -2412,24 +2429,25 @@ var _Spinner = class _Spinner {
     this._shimmerPhase = 0;
     this._lastLineLength = 0;
     this._cleanupDeregister = null;
+    const opts = typeof text === "string" ? { ...options, text } : text ?? {};
     this.running = false;
     this.frameIndex = 0;
-    this.frames = options.frames ?? (config.glyphs ? _Spinner.FRAMES.braille : _Spinner.FRAMES.line);
-    this.prefixString = options.prefix ?? "";
-    this.suffixString = options.suffix ?? "";
-    this.text = options.text ?? "";
-    this.reverse = options.reverse ?? false;
-    this.interval = options.interval ?? 80;
-    this.colorCycle = options.colorCycle ?? 1;
-    this.shimmer = options.shimmer ?? 0;
-    this.onSpin = options.onSpin;
-    this.colors = options.colors ?? ["#c026d3", "#e879f9"];
-    this.bgColors = options.bgColors ?? [];
-    this._successColor = options.successColor ?? GREEN;
-    this._failColor = options.failColor ?? RED;
-    this._warnColor = options.warnColor ?? YELLOW;
-    this._infoColor = options.infoColor ?? BLUE;
-    this._glyphs = options.glyphs ?? config.glyphs;
+    this.frames = opts.frames ?? (config.glyphs ? _Spinner.FRAMES.braille : _Spinner.FRAMES.line);
+    this._prefix = opts.prefix ?? "";
+    this._suffix = opts.suffix ?? "";
+    this.text = opts.text ?? "";
+    this.reverse = opts.reverse ?? false;
+    this.interval = opts.interval ?? 80;
+    this.colorCycle = opts.colorCycle ?? 1;
+    this.shimmer = opts.shimmer ?? 0;
+    this.onSpin = opts.onSpin;
+    this.colors = opts.colors ?? ["#c026d3", "#e879f9"];
+    this.bgColors = opts.bgColors ?? [];
+    this._successColor = opts.successColor ?? GREEN;
+    this._failColor = opts.failColor ?? RED;
+    this._warnColor = opts.warnColor ?? YELLOW;
+    this._infoColor = opts.infoColor ?? BLUE;
+    this._glyphs = opts.glyphs ?? config.glyphs;
   }
   get colors() {
     return this._colors;
@@ -2448,6 +2466,7 @@ var _Spinner = class _Spinner {
   start() {
     if (!process.stdout.isTTY) return;
     this.running = true;
+    _Spinner.current = this;
     process.stdout.write(HIDE_CURSOR);
     this._cleanupDeregister = registerCleanup(() => {
       this.running = false;
@@ -2458,6 +2477,7 @@ var _Spinner = class _Spinner {
   }
   stop(message) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2468,12 +2488,21 @@ var _Spinner = class _Spinner {
 `);
     return this;
   }
-  message(string) {
+  update(string) {
     this.text = string;
     return this;
   }
+  prefix(string) {
+    this._prefix = string;
+    return this;
+  }
+  suffix(string) {
+    this._suffix = string;
+    return this;
+  }
   succeed(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2489,6 +2518,7 @@ var _Spinner = class _Spinner {
   }
   fail(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2504,6 +2534,7 @@ var _Spinner = class _Spinner {
   }
   warn(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2519,6 +2550,7 @@ var _Spinner = class _Spinner {
   }
   info(string) {
     this.running = false;
+    if (_Spinner.current === this) _Spinner.current = null;
     this._cleanupDeregister?.();
     this._cleanupDeregister = null;
     if (process.stdout.isTTY) {
@@ -2532,6 +2564,14 @@ var _Spinner = class _Spinner {
     }
     return this;
   }
+  log(message, glyph = `${FAINT}\xB7${RESET}`) {
+    if (process.stdout.isTTY) {
+      this.clear();
+    }
+    process.stdout.write(`${glyph ? `${glyph} ` : ""}${message}
+`);
+    return this;
+  }
   clear() {
     process.stdout.clearLine?.(0);
     this._lastLineLength = 0;
@@ -2546,9 +2586,9 @@ var _Spinner = class _Spinner {
   }
   run() {
     const frame = this.coloredFrame();
-    const t = this.text;
-    const content = this.reverse ? t ? `${t} ${frame}` : frame : t ? `${frame} ${t}` : frame;
-    const raw = `${this.prefixString}${content}${this.suffixString}`;
+    const label = [this._prefix, this.text, this._suffix].filter(Boolean).join(" ");
+    const content = this.reverse ? label ? `${label} ${frame}` : frame : label ? `${frame} ${label}` : frame;
+    const raw = content;
     const displayLen = stringLength(raw);
     const padding = " ".repeat(Math.max(0, this._lastLineLength - displayLen));
     this._lastLineLength = displayLen;
@@ -2566,6 +2606,7 @@ var _Spinner = class _Spinner {
     }, this.interval);
   }
 };
+_Spinner.current = null;
 _Spinner.FRAMES = {
   braille: ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"],
   dots: ["\u28FE", "\u28FD", "\u28FB", "\u28BF", "\u287F", "\u28DF", "\u28EF", "\u28F7"],

package/dist/models/Bar.d.ts

@@ -30,6 +30,7 @@ export interface BarOptions {
     rateUnit?: string;
 }
 export declare class Bar {
+    static current: Bar | null;
     static readonly COLORS: {
         blueRed: string[];
         redBlue: string[];
@@ -83,7 +84,7 @@ export declare class Bar {
     private _showEta;
     private _rateUnit;
     private _etaSuffix;
-    constructor(options?: BarOptions);
+    constructor(text?: string | BarOptions, options?: BarOptions);
     get colors(): string[];
     set colors(value: string[]);
     get bgColors(): string[];
@@ -95,7 +96,8 @@ export declare class Bar {
     set empty(string: string);
     start(): void;
     stop(message?: string): this;
-    message(string: string): this;
+    update(string: string): this;
+    log(message: string, glyph?: string): this;
     track(total: number, options?: {
         unit?: string;
         showRate?: boolean;

package/dist/models/Bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Bar.d.ts","sourceRoot":"","sources":["../../src/models/Bar.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Bar.d.ts","sourceRoot":"","sources":["../../src/models/Bar.ts"],"names":[],"mappings":"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"}

package/dist/models/Spinner.d.ts

@@ -17,6 +17,7 @@ export interface SpinnerOptions {
     glyphs?: boolean;
 }
 export declare class Spinner {
+    static current: Spinner | null;
     static readonly FRAMES: {
         braille: string[];
         dots: string[];
@@ -31,10 +32,10 @@ export declare class Spinner {
     text: string;
     reverse: boolean;
     onSpin: (() => void) | undefined;
+    private _prefix;
+    private _suffix;
     private running;
     private frameIndex;
-    private prefixString;
-    private suffixString;
     private _colors;
     private _parsedColors;
     private _bgColors;
@@ -48,18 +49,21 @@ export declare class Spinner {
     private _infoColor;
     private _glyphs;
     private _cleanupDeregister;
-    constructor(options?: SpinnerOptions);
+    constructor(text?: string | SpinnerOptions, options?: SpinnerOptions);
     get colors(): string[];
     set colors(value: string[]);
     get bgColors(): string[];
     set bgColors(value: string[]);
     start(): void;
     stop(message?: string): this;
-    message(string: string): this;
+    update(string: string): this;
+    prefix(string: string): this;
+    suffix(string: string): this;
     succeed(string?: string): this;
     fail(string?: string): this;
     warn(string?: string): this;
     info(string?: string): this;
+    log(message: string, glyph?: string): this;
     private clear;
     private coloredFrame;
     private run;

package/dist/models/Spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../src/models/Spinner.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,qBAAa,OAAO;IAClB,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;MAMrB;IAED,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IAEhC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,YAAY,CAAY;IAChC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,kBAAkB,CAA4B;gBAE1C,OAAO,GAAE,cAAmB;IAqBxC,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAGzB;IAED,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAG3B;IAED,KAAK,IAAI,IAAI;IAYb,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAY5B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAc9B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAc3B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAc3B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAc3B,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,GAAG;CAwBZ"}
+{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../src/models/Spinner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termkit",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "Node.js terminal toolkit with CLI commands, progress bars, charts, tables, styled markup, prompts, and text utilities",
   "keywords": [
     "animation",