termpainter 1.2.0 → 2.0.0

package/README.md

@@ -11,7 +11,8 @@ npm install termpainter
 
 ## usage
 ```ts
-import { style, badge, box, paint, spin, strip, setIcons } from 'termpainter'
+import { style, badge, box, paint, spin, strip, columns, truncate,
+         setIcons, setSilent, setTheme, resetTheme, setTestMode, isInteractive } from 'termpainter'
 ```
 
 ### styles
@@ -51,6 +52,20 @@ 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.
@@ -64,11 +79,18 @@ 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 — pass styled strings directly. 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
+
+// with title
+box('Deploy complete\n3 services restarted', { color: 'green', title: 'Deploy' })
+// ╭ Deploy ──────────────────╮
+// │ Deploy complete          │
+// │ 3 services restarted     │
+// ╰──────────────────────────╯
 ```
 
 ### divider
@@ -110,19 +132,54 @@ 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.
+```ts
+style.group('Deploy', [
+  style.info('Building'),
+  style.success('Done'),
+])
+// ▶ Deploy
+//   ℹ Building
+//   ✔ Done
+```
+
+### 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)
+// => truncated styled string with ANSI codes preserved
+```
+
 ### spinner
 
-animated terminal spinner. returns a handle with `succeed` and `fail` to stop it. no external dependencies.
+animated terminal spinner. returns a handle with `succeed`, `fail`, and `update`. no external dependencies. automatically degrades to static line-by-line output when not in a TTY.
 ```ts
 const s = spin('Deploying...')
 
-// later, when done:
+s.update('Still working...')   // update message while spinning
+s.update('Almost done...')
+
 s.succeed('Deploy complete')   // stops spinner, shows style.success
 s.fail('Deploy failed')        // stops spinner, shows style.error
 
-// optional: reuse the original message
-s.succeed()
-s.fail()
+s.succeed()                    // reuse current message
 ```
 
 ### strip
@@ -135,28 +192,85 @@ const raw = strip(style.success('Build complete'))
 fs.appendFileSync('app.log', strip(style.info('Server started')) + '\n')
 ```
 
+### themes
+
+globally override colors and icons for all `style.*` methods. all keys are optional — unspecified entries fall back to defaults. call `resetTheme()` to restore factory defaults.
+```ts
+import { setTheme, resetTheme } from 'termpainter'
+
+setTheme({
+  success: { color: 'cyan',    icon: '✓' },
+  error:   { color: 'magenta', icon: '✕' },
+  warn:    { color: 'yellow' },
+  info:    { color: 'blue',    icon: '→' },
+  debug:   { color: 'gray',    dim: true },
+  muted:   { color: 'gray',    dim: true },
+  highlight: { color: 'green' },
+})
+
+style.success('done')    // ✓ done  (cyan, custom icon)
+style.error('oops')      // ✕ oops  (magenta)
+
+resetTheme()             // back to defaults
+```
+
+### test mode
+
+makes output deterministic for snapshot testing. `style.timestamp()` omits the time prefix, `spin()` renders statically without animation, `isInteractive()` returns `false`.
+```ts
+import { setTestMode } from 'termpainter'
+
+setTestMode(true)
+
+style.timestamp('Server started')   // => 'Server started'  (no [HH:MM:SS])
+const s = spin('Loading...')        // prints once, no animation
+s.succeed('Done')                   // prints style.success line
+
+setTestMode(false)                  // restore normal behavior
+```
+
+### 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('v1.0.0', 'cyan') // ''
+box('hello')            // ''
+
+setSilent(false)        // restore normal output
+```
+
 ### 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`
 
+### isInteractive
+
+returns `true` if stdout is an interactive 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
 ```
 
@@ -176,12 +290,21 @@ isColorEnabled() // true in an interactive terminal, false everywhere else
 | `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], default gray; omitted in test mode |
+| `style.group(label, lines[])` | ▶ label in cyan, lines indented 2 spaces |
+| `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 |
-| `spin(msg)` | animated spinner, returns `{ succeed(msg?), fail(msg?) }` |
-| `strip(str)` | removes all ANSI escape codes from a string |
+| `box(text, color\|options?)` | unicode border box; options: color, title |
+| `columns(left, right, options?)` | two columns side by side; options: width, gap |
+| `truncate(str, maxLength)` | truncate to maxLength visible chars, append … |
+| `spin(msg)` | animated spinner; returns `{ succeed, fail, update }` |
+| `strip(str)` | removes all ANSI escape codes |
+| `setTheme(theme)` | override colors and icons globally |
+| `resetTheme()` | restore default theme |
 | `setIcons(icons)` | override icons for error, success, warn, info, debug |
+| `setSilent(mode)` | suppress all output globally when `true` |
+| `setTestMode(mode)` | deterministic output for snapshot testing |
+| `isInteractive()` | returns `true` if stdout is a TTY (false in test mode) |
 | `paint(text, options?)` | raw ANSI composer |
 | `isColorEnabled()` | returns true if colors are active |
 

package/dist/cjs/badge.cjs

@@ -4,7 +4,10 @@ exports.badge = badge;
 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 badge(text, color = 'white') {
+    if ((0, silent_js_1.isSilent)())
+        return '';
     if (!(0, env_js_1.isColorEnabled)())
         return `[${text}]`;
     const code = paint_js_1.fgMap[color];

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

@@ -1 +1 @@
-{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AAI/C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,KAAe,GAAG,MAAM,CAIlE"}
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AAK/C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,KAAe,GAAG,MAAM,CAKlE"}

package/dist/cjs/badge.js.map

@@ -1 +1 @@
-{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../src/badge.ts"],"names":[],"mappings":";;AAIA,sBAIC;AARD,yCAA+C;AAC/C,yCAAmC;AACnC,qCAA0C;AAE1C,SAAgB,KAAK,CAAC,IAAY,EAAE,QAAe,OAAO;IACxD,IAAI,CAAC,IAAA,uBAAc,GAAE;QAAE,OAAO,IAAI,IAAI,GAAG,CAAC;IAC1C,MAAM,IAAI,GAAG,gBAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,gBAAK,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../src/badge.ts"],"names":[],"mappings":";;AAKA,sBAKC;AAVD,yCAA+C;AAC/C,yCAAmC;AACnC,qCAA0C;AAC1C,2CAAuC;AAEvC,SAAgB,KAAK,CAAC,IAAY,EAAE,QAAe,OAAO;IACxD,IAAI,IAAA,oBAAQ,GAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAA,uBAAc,GAAE;QAAE,OAAO,IAAI,IAAI,GAAG,CAAC;IAC1C,MAAM,IAAI,GAAG,gBAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,gBAAK,EAAE,CAAC;AACpC,CAAC"}

package/dist/cjs/box.cjs

@@ -4,11 +4,27 @@ exports.box = box;
 const paint_js_1 = require('./paint.cjs');
 const codes_js_1 = require('./codes.cjs');
 const env_js_1 = require('./env.cjs');
-function box(text, color = 'white') {
+const silent_js_1 = require('./silent.cjs');
+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);
@@ -17,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;AAItD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,KAAe,GAAG,MAAM,CAuBhE"}
+{"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":";;AAIA,kBAuBC;AA3BD,yCAAsD;AACtD,yCAAmC;AACnC,qCAA0C;AAE1C,SAAgB,GAAG,CAAC,IAAY,EAAE,QAAe,OAAO;IACtD,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

@@ -1,6 +1,8 @@
 "use strict";
 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:
@@ -8,6 +10,11 @@ exports.isColorEnabled = isColorEnabled;
  *   - CI env var is set (raw escape codes look broken in most CI logs)
  *   - 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() {
     if (process.env.NO_COLOR !== undefined)
         return false;

package/dist/cjs/env.d.cts

@@ -5,5 +5,6 @@
  *   - CI env var is set (raw escape codes look broken in most CI logs)
  *   - process.stdout.isTTY is false/undefined (output is being piped)
  */
+export declare function isInteractive(): boolean;
 export declare function isColorEnabled(): boolean;
 //# sourceMappingURL=env.d.ts.map

package/dist/cjs/env.d.ts

@@ -5,5 +5,6 @@
  *   - CI env var is set (raw escape codes look broken in most CI logs)
  *   - process.stdout.isTTY is false/undefined (output is being piped)
  */
+export declare function isInteractive(): boolean;
 export declare function isColorEnabled(): boolean;
 //# sourceMappingURL=env.d.ts.map

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,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,wCAKC;AAZD;;;;;;GAMG;AACH,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.isColorEnabled = 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,9 +26,21 @@ 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; } });
 __exportStar(require('./codes.cjs'), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.d.cts

@@ -1,12 +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 { isColorEnabled } from './env.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

package/dist/cjs/index.d.ts

@@ -1,12 +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 { isColorEnabled } from './env.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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,cAAc,YAAY,CAAC"}

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAA0C;AAAjC,iGAAA,KAAK,OAAA;AAAE,iGAAA,KAAK,OAAA;AAErB,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,mCAA+B;AAAtB,6FAAA,GAAG,OAAA;AACZ,2CAAoC;AAA3B,kGAAA,IAAI,OAAA;AAEb,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAA0C;AAAjC,iGAAA,KAAK,OAAA;AAAE,iGAAA,KAAK,OAAA;AAErB,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AAEd,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,mCAA+B;AAAtB,6FAAA,GAAG,OAAA;AAEZ,2CAAoC;AAA3B,kGAAA,IAAI,OAAA;AAEb,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAEhB,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AACjB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,uCAAkD;AAAzC,oGAAA,QAAQ,OAAA;AAAE,sGAAA,UAAU,OAAA;AAE7B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,mCAAyD;AAAhD,wGAAA,cAAc,OAAA;AAAE,uGAAA,aAAa,OAAA;AACtC,6CAA2B"}

package/dist/cjs/paint.cjs

@@ -5,6 +5,7 @@ exports.paint = paint;
 exports.strip = strip;
 const codes_js_1 = require('./codes.cjs');
 const env_js_1 = require('./env.cjs');
+const silent_js_1 = require('./silent.cjs');
 const fgMap = {
     black: codes_js_1.BLACK,
     red: codes_js_1.RED,
@@ -30,6 +31,8 @@ const bgMap = {
 };
 exports.bgMap = bgMap;
 function paint(text, options = {}) {
+    if ((0, silent_js_1.isSilent)())
+        return '';
     if (!(0, env_js_1.isColorEnabled)())
         return text;
     let prefix = '';

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

@@ -1 +1 @@
-{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/paint.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1G,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAUhC,CAAC;AAEF,QAAA,MAAM,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAUhC,CAAC;AAEF,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAWtE;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/paint.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1G,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAUhC,CAAC;AAEF,QAAA,MAAM,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAUhC,CAAC;AAEF,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAYtE;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC"}

package/dist/cjs/paint.js.map

@@ -1 +1 @@
-{"version":3,"file":"paint.js","sourceRoot":"","sources":["../../src/paint.ts"],"names":[],"mappings":";;;AA0CA,sBAWC;AAED,sBAGC;AA1DD,yCAIoB;AACpB,qCAA0C;AAa1C,MAAM,KAAK,GAA0B;IACnC,KAAK,EAAE,gBAAK;IACZ,GAAG,EAAE,cAAG;IACR,KAAK,EAAE,gBAAK;IACZ,MAAM,EAAE,iBAAM;IACd,IAAI,EAAE,eAAI;IACV,OAAO,EAAE,kBAAO;IAChB,IAAI,EAAE,eAAI;IACV,KAAK,EAAE,gBAAK;IACZ,IAAI,EAAE,eAAI;CACX,CAAC;AAgCO,sBAAK;AA9Bd,MAAM,KAAK,GAA0B;IACnC,KAAK,EAAE,mBAAQ;IACf,GAAG,EAAE,iBAAM;IACX,KAAK,EAAE,mBAAQ;IACf,MAAM,EAAE,oBAAS;IACjB,IAAI,EAAE,kBAAO;IACb,OAAO,EAAE,qBAAU;IACnB,IAAI,EAAE,kBAAO;IACb,KAAK,EAAE,mBAAQ;IACf,IAAI,EAAE,kBAAO;CACd,CAAC;AAoBc,sBAAK;AAlBrB,SAAgB,KAAK,CAAC,IAAY,EAAE,UAAwB,EAAE;IAC5D,IAAI,CAAC,IAAA,uBAAc,GAAE;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,OAAO,CAAC,IAAI;QAAE,MAAM,IAAI,eAAI,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG;QAAE,MAAM,IAAI,cAAG,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,iBAAM,CAAC;IACrC,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,IAAI,oBAAS,CAAC;IAC3C,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,gBAAK,EAAE,CAAC;AACpC,CAAC;AAED,SAAgB,KAAK,CAAC,GAAW;IAC/B,4CAA4C;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"paint.js","sourceRoot":"","sources":["../../src/paint.ts"],"names":[],"mappings":";;;AA2CA,sBAYC;AAED,sBAGC;AA5DD,yCAIoB;AACpB,qCAA0C;AAC1C,2CAAuC;AAavC,MAAM,KAAK,GAA0B;IACnC,KAAK,EAAE,gBAAK;IACZ,GAAG,EAAE,cAAG;IACR,KAAK,EAAE,gBAAK;IACZ,MAAM,EAAE,iBAAM;IACd,IAAI,EAAE,eAAI;IACV,OAAO,EAAE,kBAAO;IAChB,IAAI,EAAE,eAAI;IACV,KAAK,EAAE,gBAAK;IACZ,IAAI,EAAE,eAAI;CACX,CAAC;AAiCO,sBAAK;AA/Bd,MAAM,KAAK,GAA0B;IACnC,KAAK,EAAE,mBAAQ;IACf,GAAG,EAAE,iBAAM;IACX,KAAK,EAAE,mBAAQ;IACf,MAAM,EAAE,oBAAS;IACjB,IAAI,EAAE,kBAAO;IACb,OAAO,EAAE,qBAAU;IACnB,IAAI,EAAE,kBAAO;IACb,KAAK,EAAE,mBAAQ;IACf,IAAI,EAAE,kBAAO;CACd,CAAC;AAqBc,sBAAK;AAnBrB,SAAgB,KAAK,CAAC,IAAY,EAAE,UAAwB,EAAE;IAC5D,IAAI,IAAA,oBAAQ,GAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAA,uBAAc,GAAE;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,OAAO,CAAC,IAAI;QAAE,MAAM,IAAI,eAAI,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG;QAAE,MAAM,IAAI,cAAG,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,iBAAM,CAAC;IACrC,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,IAAI,oBAAS,CAAC;IAC3C,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,gBAAK,EAAE,CAAC;AACpC,CAAC;AAED,SAAgB,KAAK,CAAC,GAAW;IAC/B,4CAA4C;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cjs/silent.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSilent = setSilent;
+exports.isSilent = isSilent;
+let silentMode = false;
+function setSilent(mode) {
+    silentMode = mode;
+}
+function isSilent() {
+    return silentMode;
+}
+//# sourceMappingURL=silent.js.map

package/dist/cjs/silent.d.cts

@@ -0,0 +1,3 @@
+export declare function setSilent(mode: boolean): void;
+export declare function isSilent(): boolean;
+//# sourceMappingURL=silent.d.ts.map

package/dist/cjs/silent.d.ts

@@ -0,0 +1,3 @@
+export declare function setSilent(mode: boolean): void;
+export declare function isSilent(): boolean;
+//# sourceMappingURL=silent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"silent.d.ts","sourceRoot":"","sources":["../../src/silent.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAElC"}