termpainter 1.3.0 → 2.0.1

package/README.md

@@ -1,6 +1,8 @@
 # termpainter
 
-tired of staring at walls of plain `console.log`? termpainter gives your terminal output actual structure. colors, boxes, badges, tables, timestamps. zero dependencies, works in Node 18+ and Bun.
+Build clean, structured CLI output with zero dependencies.
+
+termpainter gives you semantic styles, boxes, tables, spinners, layouts and more. works in Node 18+ and Bun. full TypeScript support.
 ```sh
 npm install termpainter
 ```
@@ -9,9 +11,77 @@ npm install termpainter
 
 ---
 
+## real world examples
+
+### deploy pipeline
+```ts
+import { style, box, columns } from 'termpainter'
+
+console.log(box(
+  style.group('Deploy', [
+    style.success('Dependencies installed'),
+    style.success('TypeScript compiled'),
+    style.success('22/22 tests passed'),
+    style.success('Bundle created (10.5 kB)'),
+  ]),
+  { color: 'green', title: 'CI/CD' }
+))
+
+console.log(columns(
+  style.group('Services', [
+    style.success('API'),
+    style.success('Auth'),
+    style.error('Database'),
+    style.warn('Cache'),
+  ]),
+  style.group('Stats', [
+    style.info('Uptime: 3d 2h'),
+    style.info('Memory: 512 MB'),
+    style.warn('CPU: 87%'),
+    style.info('Port: 3000'),
+  ])
+))
+```
+
+<img src="https://raw.githubusercontent.com/abd105/termpainter/main/assets/example-deploy.png" width="500" alt="deploy pipeline example" />
+
+### structured logging
+```ts
+import { style } from 'termpainter'
+
+style.success('User created', { id: 847, role: 'admin', plan: 'pro' })
+style.error('Request failed', { status: 503, path: '/api/checkout', retries: 3 })
+style.warn('Rate limit approaching', { limit: 1000, current: 847, reset: '60s' })
+style.info('Deploy started', { env: 'production', version: 'v2.0.0', region: 'us-east-1' })
+```
+
+<img src="https://raw.githubusercontent.com/abd105/termpainter/main/assets/example-logs.png" width="400" alt="structured logging example" />
+
+### CLI status dashboard
+```ts
+import { style, badge, columns } from 'termpainter'
+
+console.log(columns(
+  style.table({ Status: 'Running', Uptime: '3d 2h', Memory: '512 MB', CPU: '12%' }),
+  style.table({ Region: 'us-east-1', Version: 'v2.0.0', Node: '22.x', Port: '3000' })
+))
+
+console.log(
+  badge('production', 'green') + '  ' +
+  badge('v2.0.0', 'cyan') + '  ' +
+  badge('0 deps', 'magenta') + '  ' +
+  badge('TypeScript', 'blue')
+)
+```
+
+<img src="https://raw.githubusercontent.com/abd105/termpainter/main/assets/example-dashboard.png" width="500" alt="status dashboard example" />
+
+---
+
 ## usage
 ```ts
-import { style, badge, box, paint, spin, strip, setIcons, setSilent, isInteractive } from 'termpainter'
+import { style, badge, box, paint, spin, strip, columns, truncate,
+         setIcons, setSilent, setTheme, resetTheme, setTestMode, isInteractive } from 'termpainter'
 ```
 
 ### styles
@@ -29,14 +99,12 @@ style.highlight('termpainter')         // cyan
 
 ### structured log output
 
-any `style.*` method accepts an optional second argument — a plain object whose keys and values are printed below the message, indented and with keys in cyan.
+any `style.*` method accepts an optional second argument. a plain object whose keys and values are printed below the message, indented with keys in cyan.
 ```ts
 style.info('User created', { id: 123, role: 'admin' })
 // ℹ User created
 //   id    123
 //   role  admin
-
-style.error('Request failed', { status: 503, path: '/api/data' })
 ```
 
 ### debug
@@ -51,11 +119,25 @@ DEBUG=1 node app.js   # shows debug output
 node app.js           # debug lines are invisible
 ```
 
+### list
+
+bulleted list. each item can be a plain string or a pre-styled string.
+```ts
+style.list(['Build started', 'Running tests', 'Deploying'])
+// • Build started
+// • Running tests
+// • Deploying
+
+style.list([style.success('Lint passed'), style.warn('Coverage at 74%')])
+
+style.list(items, { bullet: '-', color: 'gray', indent: 2 })
+```
+
 ### badges
 
 inline labels. good for status, versions, environments.
 ```ts
-badge('v1.0.0', 'cyan')
+badge('v2.0.0', 'cyan')
 badge('PASS', 'green')
 badge('FAIL', 'red')
 badge('production', 'green')
@@ -64,11 +146,17 @@ badge('offline', 'red')
 
 ### boxes
 
-draws a clean unicode border around anything. multiline works fine. fully composable — pass styled strings directly.
+draws a clean unicode border around anything. multiline works fine. fully composable. supports an optional title in the top border.
 ```ts
 box('Deploy complete\n3 services restarted\nAll checks passed', 'green')
 box('Critical error\nProcess exited with code 1', 'red')
 box(style.success('done'))   // styled content inside a box
+
+box('Deploy complete\n3 services restarted', { color: 'green', title: 'Deploy' })
+// ╭ Deploy ──────────────────╮
+// │ Deploy complete          │
+// │ 3 services restarted     │
+// ╰──────────────────────────╯
 ```
 
 ### divider
@@ -101,15 +189,6 @@ style.timestamp('Deploy complete', 'green')  // timestamp in green
 style.timestamp('Connection failed', 'red')  // timestamp in red
 ```
 
-### paint
-
-low level, for when you need something the presets don't cover.
-```ts
-paint('custom text', { color: 'magenta', bold: true })
-paint('highlighted', { color: 'white', bg: 'blue' })
-paint('soft note', { color: 'gray', italic: true, dim: true })
-```
-
 ### group
 
 groups a list of already-styled lines under a labeled header.
@@ -121,27 +200,39 @@ style.group('Deploy', [
 // ▶ Deploy
 //   ℹ Building
 //   ✔ Done
+```
 
-style.group('Checks', [
-  style.success('Lint passed'),
-  style.warn('Coverage at 74%'),
-  style.error('Tests failed'),
-])
+### columns
+
+renders two strings side by side, ANSI-aware. falls back to two lines in non-interactive environments.
+```ts
+columns('Left content', 'Right content')
+columns(style.success('Build passed'), style.info('Tests: 22/22'))
+columns(badge('production', 'green'), badge('v2.0.0', 'cyan'))
+columns(left, right, { width: 100, gap: 6 })
+```
+
+### truncate
+
+truncates a string to a maximum visible length and appends `...`. uses `strip()` internally so ANSI codes don't count toward the length.
+```ts
+truncate('very long string that overflows', 20)
+// => 'very long string tha...'
+
+truncate(style.success('Build complete'), 10)
 ```
 
 ### spinner
 
-animated terminal spinner. returns a handle with `succeed` and `fail` to stop it. no external dependencies. automatically degrades to a single printed line when not running in a TTY (CI, piped output).
+animated terminal spinner. returns a handle with `succeed`, `fail`, and `update`. no external dependencies. automatically degrades to static output when not in a TTY.
 ```ts
 const s = spin('Deploying...')
 
-// later, when done:
-s.succeed('Deploy complete')   // stops spinner, shows style.success
-s.fail('Deploy failed')        // stops spinner, shows style.error
+s.update('Still working...')
+s.update('Almost done...')
 
-// optional: reuse the original message
-s.succeed()
-s.fail()
+s.succeed('Deploy complete')
+s.fail('Deploy failed')
 ```
 
 ### strip
@@ -154,57 +245,87 @@ const raw = strip(style.success('Build complete'))
 fs.appendFileSync('app.log', strip(style.info('Server started')) + '\n')
 ```
 
-### silent mode
+### paint
 
-suppress all output globally. every function returns an empty string and produces no side effects. useful for tests, CI, and benchmarks.
+low level, for when you need something the presets don't cover.
 ```ts
-import { setSilent } from 'termpainter'
-
-setSilent(true)
-
-style.success('done')   // ''
-badge('v1.0.0', 'cyan') // ''
-box('hello')            // ''
-
-setSilent(false)        // restore normal output
+paint('custom text', { color: 'magenta', bold: true })
+paint('highlighted', { color: 'white', bg: 'blue' })
+paint('soft note', { color: 'gray', italic: true, dim: true })
 ```
 
-### isInteractive
+### themes
 
-returns `true` if stdout is an interactive TTY. useful for conditionally using spinners or dynamic layouts.
+globally override colors and icons for all `style.*` methods. all keys are optional. call `resetTheme()` to restore defaults.
 ```ts
-import { isInteractive } from 'termpainter'
+setTheme({
+  success: { color: 'cyan',    icon: '✓' },
+  error:   { color: 'magenta', icon: '✕' },
+  warn:    { color: 'yellow' },
+  info:    { color: 'blue',    icon: '>' },
+})
 
-if (isInteractive()) {
-  const s = spin('Loading...')
-  // ...
-} else {
-  console.log(style.muted('Loading...'))
-}
+style.success('done')   // ✓ done (cyan, custom icon)
+style.error('oops')     // ✕ oops (magenta)
+
+resetTheme()            // back to defaults
 ```
 
 ### custom icons
 
 override the default icons for any or all style methods. unspecified keys fall back to defaults.
 ```ts
-import { setIcons } from 'termpainter'
-
 setIcons({ success: '✓', error: '✕' })
 
-style.success('done')   // ✓ done  (custom icon)
-style.warn('careful')   // ⚠ careful  (default icon unchanged)
+style.success('done')    // ✓ done
+style.warn('careful')    // ⚠ careful (default unchanged)
 ```
 
 available keys: `success`, `error`, `warn`, `info`, `debug`
 
+### silent mode
+
+suppress all output globally. every function returns an empty string and produces no side effects. useful for tests, CI, and benchmarks.
+```ts
+setSilent(true)
+
+style.success('done')    // ''
+badge('v2.0.0', 'cyan')  // ''
+box('hello')             // ''
+
+setSilent(false)         // restore normal output
+```
+
+### test mode
+
+makes output deterministic for snapshot testing. `style.timestamp()` omits the time prefix, `spin()` renders statically, `isInteractive()` returns `false`.
+```ts
+setTestMode(true)
+
+style.timestamp('Server started')   // 'Server started' (no [HH:MM:SS])
+const s = spin('Loading...')        // prints once, no animation
+s.succeed('Done')
+
+setTestMode(false)
+```
+
+### isInteractive
+
+returns `true` if stdout is a TTY. always `false` in test mode.
+```ts
+if (isInteractive()) {
+  const s = spin('Loading...')
+} else {
+  console.log(style.muted('Loading...'))
+}
+```
+
 ---
 
 ## color support
 
 termpainter automatically strips all ANSI codes when `NO_COLOR` is set, when running in CI, or when output is piped. your logs won't be full of broken escape sequences.
 ```ts
-import { isColorEnabled } from 'termpainter'
-
 isColorEnabled() // true in an interactive terminal, false everywhere else
 ```
 
@@ -218,26 +339,32 @@ isColorEnabled() // true in an interactive terminal, false everywhere else
 | `style.success(msg, meta?)` | green, prepends ✔ |
 | `style.warn(msg, meta?)` | yellow, prepends ⚠ |
 | `style.info(msg, meta?)` | blue, prepends ℹ |
-| `style.debug(msg, meta?)` | gray+dim, 🔍 prefix, only when `DEBUG` is set |
+| `style.debug(msg, meta?)` | gray+dim, 🔍 prefix, only when DEBUG is set |
 | `style.muted(msg)` | gray, dimmed |
 | `style.bold(msg)` | bold white |
 | `style.highlight(msg)` | cyan |
 | `style.divider(color?)` | 40 char horizontal rule, default gray |
 | `style.table(data, color?)` | aligned key-value table, keys in cyan |
-| `style.timestamp(msg, color?)` | prepends [HH:MM:SS], default gray |
+| `style.timestamp(msg, color?)` | prepends [HH:MM:SS], omitted in test mode |
+| `style.group(label, lines[])` | labeled indented section |
+| `style.list(items, options?)` | bulleted list, options: bullet, color, indent |
 | `badge(text, color?)` | [text] in chosen color, default white |
-| `box(text, color?)` | unicode border box, multiline and ANSI-aware |
-| `style.group(label, lines[])` | ▶ label in cyan, lines indented 2 spaces |
-| `spin(msg)` | animated spinner, returns `{ succeed(msg?), fail(msg?) }` |
-| `strip(str)` | removes all ANSI escape codes from a string |
-| `setIcons(icons)` | override icons for error, success, warn, info, debug |
-| `setSilent(mode)` | suppress all output globally when `true` |
-| `isInteractive()` | returns `true` if stdout is a TTY |
+| `box(text, color or options?)` | unicode border box with optional title |
+| `columns(left, right, options?)` | side by side output, options: width, gap |
+| `truncate(str, maxLength)` | truncate preserving ANSI codes |
+| `spin(msg)` | animated spinner, returns succeed, fail, update |
+| `strip(str)` | removes all ANSI escape codes |
 | `paint(text, options?)` | raw ANSI composer |
-| `isColorEnabled()` | returns true if colors are active |
+| `setTheme(theme)` | override colors and icons globally |
+| `resetTheme()` | restore default theme |
+| `setIcons(icons)` | override icons for success, error, warn, info, debug |
+| `setSilent(bool)` | suppress all output globally |
+| `setTestMode(bool)` | deterministic output for snapshot testing |
+| `isColorEnabled()` | true if colors are active |
+| `isInteractive()` | true if stdout is a TTY, false in test mode |
 
 ---
 
 ## license
 
-MIT © Abdullah Hashmi
+MIT © Abdullah Hashmi

package/dist/cjs/box.cjs

@@ -5,13 +5,26 @@ const paint_js_1 = require('./paint.cjs');
 const codes_js_1 = require('./codes.cjs');
 const env_js_1 = require('./env.cjs');
 const silent_js_1 = require('./silent.cjs');
-function box(text, color = 'white') {
+function box(text, options) {
     if ((0, silent_js_1.isSilent)())
         return '';
+    const color = (typeof options === 'string' ? options : options?.color) ?? 'white';
+    const title = typeof options === 'object' ? options.title : undefined;
     const lines = text.split('\n');
     const width = Math.max(...lines.map((l) => (0, paint_js_1.strip)(l).length));
+    function buildTop(colorCode) {
+        const inner = width + 2; // total dashes without title
+        if (title) {
+            const titleSection = ` ${title} `;
+            const dashes = Math.max(0, inner - titleSection.length);
+            const raw = `╭${titleSection}${'─'.repeat(dashes)}╮`;
+            return colorCode ? `${colorCode}${raw}${codes_js_1.RESET}` : raw;
+        }
+        const raw = `╭${'─'.repeat(inner)}╮`;
+        return colorCode ? `${colorCode}${raw}${codes_js_1.RESET}` : raw;
+    }
     if (!(0, env_js_1.isColorEnabled)()) {
-        const top = `╭${'─'.repeat(width + 2)}╮`;
+        const top = buildTop();
         const bottom = `╰${'─'.repeat(width + 2)}╯`;
         const middle = lines.map((line) => {
             const padding = ' '.repeat(width - (0, paint_js_1.strip)(line).length);
@@ -20,7 +33,7 @@ function box(text, color = 'white') {
         return [top, ...middle, bottom].join('\n');
     }
     const c = paint_js_1.fgMap[color];
-    const top = `${c}╭${'─'.repeat(width + 2)}╮${codes_js_1.RESET}`;
+    const top = buildTop(c);
     const bottom = `${c}╰${'─'.repeat(width + 2)}╯${codes_js_1.RESET}`;
     const middle = lines.map((line) => {
         const padding = ' '.repeat(width - (0, paint_js_1.strip)(line).length);

package/dist/cjs/box.d.cts

@@ -1,3 +1,7 @@
 import { type Color } from './paint.js';
-export declare function box(text: string, color?: Color): string;
+export interface BoxOptions {
+    color?: Color;
+    title?: string;
+}
+export declare function box(text: string, options?: Color | BoxOptions): string;
 //# sourceMappingURL=box.d.ts.map

package/dist/cjs/box.d.ts

@@ -1,3 +1,7 @@
 import { type Color } from './paint.js';
-export declare function box(text: string, color?: Color): string;
+export interface BoxOptions {
+    color?: Color;
+    title?: string;
+}
+export declare function box(text: string, options?: Color | BoxOptions): string;
 //# sourceMappingURL=box.d.ts.map

package/dist/cjs/box.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../src/box.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,YAAY,CAAC;AAKtD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,KAAe,GAAG,MAAM,CAwBhE"}
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../src/box.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,YAAY,CAAC;AAKtD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,CAwCtE"}

package/dist/cjs/box.js.map

@@ -1 +1 @@
-{"version":3,"file":"box.js","sourceRoot":"","sources":["../../src/box.ts"],"names":[],"mappings":";;AAKA,kBAwBC;AA7BD,yCAAsD;AACtD,yCAAmC;AACnC,qCAA0C;AAC1C,2CAAuC;AAEvC,SAAgB,GAAG,CAAC,IAAY,EAAE,QAAe,OAAO;IACtD,IAAI,IAAA,oBAAQ,GAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,gBAAK,EAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7D,IAAI,CAAC,IAAA,uBAAc,GAAE,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,IAAA,gBAAK,EAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;YACvD,OAAO,KAAK,IAAI,GAAG,OAAO,IAAI,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,GAAG,gBAAK,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,gBAAK,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,gBAAK,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,IAAA,gBAAK,EAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC,IAAI,gBAAK,IAAI,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,gBAAK,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"box.js","sourceRoot":"","sources":["../../src/box.ts"],"names":[],"mappings":"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"}

package/dist/cjs/columns.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.columns = columns;
+const paint_js_1 = require('./paint.cjs');
+const env_js_1 = require('./env.cjs');
+const silent_js_1 = require('./silent.cjs');
+function columns(left, right, options = {}) {
+    if ((0, silent_js_1.isSilent)())
+        return '';
+    if (!(0, env_js_1.isInteractive)()) {
+        return `${left}\n${right}`;
+    }
+    const totalWidth = options.width ?? 80;
+    const gap = options.gap ?? 4;
+    const colWidth = Math.floor((totalWidth - gap) / 2);
+    const gapStr = ' '.repeat(gap);
+    const leftLines = left.split('\n');
+    const rightLines = right.split('\n');
+    const lineCount = Math.max(leftLines.length, rightLines.length);
+    const result = [];
+    for (let i = 0; i < lineCount; i++) {
+        const l = leftLines[i] ?? '';
+        const r = rightLines[i] ?? '';
+        const visible = (0, paint_js_1.strip)(l).length;
+        const padding = visible < colWidth ? ' '.repeat(colWidth - visible) : '';
+        result.push(`${l}${padding}${gapStr}${r}`);
+    }
+    return result.join('\n');
+}
+//# sourceMappingURL=columns.js.map

package/dist/cjs/columns.d.cts

@@ -0,0 +1,6 @@
+export interface ColumnsOptions {
+    width?: number;
+    gap?: number;
+}
+export declare function columns(left: string, right: string, options?: ColumnsOptions): string;
+//# sourceMappingURL=columns.d.ts.map

package/dist/cjs/columns.d.ts

@@ -0,0 +1,6 @@
+export interface ColumnsOptions {
+    width?: number;
+    gap?: number;
+}
+export declare function columns(left: string, right: string, options?: ColumnsOptions): string;
+//# sourceMappingURL=columns.d.ts.map

package/dist/cjs/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/columns.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CA0BzF"}

package/dist/cjs/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../src/columns.ts"],"names":[],"mappings":";;AASA,0BA0BC;AAnCD,yCAAmC;AACnC,qCAAyC;AACzC,2CAAuC;AAOvC,SAAgB,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,UAA0B,EAAE;IAC/E,IAAI,IAAA,oBAAQ,GAAE;QAAE,OAAO,EAAE,CAAC;IAE1B,IAAI,CAAC,IAAA,sBAAa,GAAE,EAAE,CAAC;QACrB,OAAO,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAA,gBAAK,EAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/cjs/env.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isInteractive = isInteractive;
 exports.isColorEnabled = isColorEnabled;
+const testmode_js_1 = require('./testmode.cjs');
 /**
  * Returns true if ANSI color codes should be emitted.
  * Colors are disabled when any of the following are true:
@@ -10,6 +11,8 @@ exports.isColorEnabled = isColorEnabled;
  *   - process.stdout.isTTY is false/undefined (output is being piped)
  */
 function isInteractive() {
+    if ((0, testmode_js_1.isTestMode)())
+        return false;
     return process.stdout.isTTY === true;
 }
 function isColorEnabled() {

package/dist/cjs/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,cAAc,IAAI,OAAO,CAKxC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAGvC;AAED,wBAAgB,cAAc,IAAI,OAAO,CAKxC"}

package/dist/cjs/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":";;AAOA,sCAEC;AAED,wCAKC;AAhBD;;;;;;GAMG;AACH,SAAgB,aAAa;IAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,SAAgB,cAAc;IAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":";;AASA,sCAGC;AAED,wCAKC;AAnBD,+CAA2C;AAE3C;;;;;;GAMG;AACH,SAAgB,aAAa;IAC3B,IAAI,IAAA,wBAAU,GAAE;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,SAAgB,cAAc;IAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cjs/icons.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setIcons = setIcons;
 exports.getIcons = getIcons;
+exports.resetIcons = resetIcons;
 const defaults = {
     error: '✖',
     success: '✔',
@@ -16,4 +17,7 @@ function setIcons(icons) {
 function getIcons() {
     return current;
 }
+function resetIcons() {
+    current = { ...defaults };
+}
 //# sourceMappingURL=icons.js.map

package/dist/cjs/icons.d.cts

@@ -7,4 +7,5 @@ export interface Icons {
 }
 export declare function setIcons(icons: Partial<Icons>): void;
 export declare function getIcons(): Icons;
+export declare function resetIcons(): void;
 //# sourceMappingURL=icons.d.ts.map

package/dist/cjs/icons.d.ts

@@ -7,4 +7,5 @@ export interface Icons {
 }
 export declare function setIcons(icons: Partial<Icons>): void;
 export declare function getIcons(): Icons;
+export declare function resetIcons(): void;
 //# sourceMappingURL=icons.d.ts.map

package/dist/cjs/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/icons.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAEpD;AAED,wBAAgB,QAAQ,IAAI,KAAK,CAEhC"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/icons.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAEpD;AAED,wBAAgB,QAAQ,IAAI,KAAK,CAEhC;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/cjs/icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/icons.ts"],"names":[],"mappings":";;AAkBA,4BAEC;AAED,4BAEC;AAhBD,MAAM,QAAQ,GAAU;IACtB,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,IAAI,OAAO,GAAU,EAAE,GAAG,QAAQ,EAAE,CAAC;AAErC,SAAgB,QAAQ,CAAC,KAAqB;IAC5C,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,SAAgB,QAAQ;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/icons.ts"],"names":[],"mappings":";;AAkBA,4BAEC;AAED,4BAEC;AAED,gCAEC;AApBD,MAAM,QAAQ,GAAU;IACtB,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,IAAI,OAAO,GAAU,EAAE,GAAG,QAAQ,EAAE,CAAC;AAErC,SAAgB,QAAQ,CAAC,KAAqB;IAC5C,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,SAAgB,QAAQ;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,UAAU;IACxB,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/cjs/index.cjs

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isInteractive = exports.isColorEnabled = exports.setSilent = exports.setIcons = exports.spin = exports.box = exports.badge = exports.style = exports.strip = exports.paint = void 0;
+exports.isInteractive = exports.isColorEnabled = exports.setTestMode = exports.resetTheme = exports.setTheme = exports.setSilent = exports.setIcons = exports.truncate = exports.columns = exports.spin = exports.box = exports.badge = exports.style = exports.strip = exports.paint = void 0;
 var paint_js_1 = require('./paint.cjs');
 Object.defineProperty(exports, "paint", { enumerable: true, get: function () { return paint_js_1.paint; } });
 Object.defineProperty(exports, "strip", { enumerable: true, get: function () { return paint_js_1.strip; } });
@@ -26,10 +26,19 @@ var box_js_1 = require('./box.cjs');
 Object.defineProperty(exports, "box", { enumerable: true, get: function () { return box_js_1.box; } });
 var spinner_js_1 = require('./spinner.cjs');
 Object.defineProperty(exports, "spin", { enumerable: true, get: function () { return spinner_js_1.spin; } });
+var columns_js_1 = require('./columns.cjs');
+Object.defineProperty(exports, "columns", { enumerable: true, get: function () { return columns_js_1.columns; } });
+var truncate_js_1 = require('./truncate.cjs');
+Object.defineProperty(exports, "truncate", { enumerable: true, get: function () { return truncate_js_1.truncate; } });
 var icons_js_1 = require('./icons.cjs');
 Object.defineProperty(exports, "setIcons", { enumerable: true, get: function () { return icons_js_1.setIcons; } });
 var silent_js_1 = require('./silent.cjs');
 Object.defineProperty(exports, "setSilent", { enumerable: true, get: function () { return silent_js_1.setSilent; } });
+var theme_js_1 = require('./theme.cjs');
+Object.defineProperty(exports, "setTheme", { enumerable: true, get: function () { return theme_js_1.setTheme; } });
+Object.defineProperty(exports, "resetTheme", { enumerable: true, get: function () { return theme_js_1.resetTheme; } });
+var testmode_js_1 = require('./testmode.cjs');
+Object.defineProperty(exports, "setTestMode", { enumerable: true, get: function () { return testmode_js_1.setTestMode; } });
 var env_js_1 = require('./env.cjs');
 Object.defineProperty(exports, "isColorEnabled", { enumerable: true, get: function () { return env_js_1.isColorEnabled; } });
 Object.defineProperty(exports, "isInteractive", { enumerable: true, get: function () { return env_js_1.isInteractive; } });

package/dist/cjs/index.d.cts

@@ -1,13 +1,21 @@
 export { paint, strip } from './paint.js';
 export type { PaintOptions, Color } from './paint.js';
 export { style } from './style.js';
+export type { ListOptions } from './style.js';
 export { badge } from './badge.js';
 export { box } from './box.js';
+export type { BoxOptions } from './box.js';
 export { spin } from './spinner.js';
 export type { SpinnerHandle } from './spinner.js';
+export { columns } from './columns.js';
+export type { ColumnsOptions } from './columns.js';
+export { truncate } from './truncate.js';
 export { setIcons } from './icons.js';
 export type { Icons } from './icons.js';
 export { setSilent } from './silent.js';
+export { setTheme, resetTheme } from './theme.js';
+export type { Theme, ThemeEntry } from './theme.js';
+export { setTestMode } from './testmode.js';
 export { isColorEnabled, isInteractive } from './env.js';
 export * from './codes.js';
 //# sourceMappingURL=index.d.ts.map