@visulima/colorize 1.4.26 → 1.4.27

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## @visulima/colorize [1.4.27](https://github.com/visulima/visulima/compare/@visulima/colorize@1.4.26...@visulima/colorize@1.4.27) (2025-11-07)
+
+### Bug Fixes
+
+* update TypeScript configurations and improve linting across multiple packages ([6f25ec7](https://github.com/visulima/visulima/commit/6f25ec7841da7246f8f9166efc5292a7089d37ee))
+
+### Documentation
+
+* enhance README with browser compatibility, edge case handling, and performance comparisons for Colorize ([432193f](https://github.com/visulima/visulima/commit/432193f455918ce51e0e2ec6aab7ac357c337736))
+
+### Miscellaneous Chores
+
+* update npm and pnpm configurations for monorepo optimization ([#564](https://github.com/visulima/visulima/issues/564)) ([5512b42](https://github.com/visulima/visulima/commit/5512b42f672c216b6a3c9e39035199a4ebd9a4b8))
+* update package.json files and pnpm-lock.yaml ([95d9f5b](https://github.com/visulima/visulima/commit/95d9f5b607105d05a006deadb4379e89f06dfe99))
+
+### Tests
+
+* update expected output for Colorize function in integration test ([1e316e9](https://github.com/visulima/visulima/commit/1e316e96e591d69d5c8d45513b32bb572dc2c438))
+
+
+### Dependencies
+
+* **@visulima/is-ansi-color-supported:** upgraded to 2.3.3
+
 ## @visulima/colorize [1.4.26](https://github.com/visulima/visulima/compare/@visulima/colorize@1.4.25...@visulima/colorize@1.4.26) (2025-11-05)
 
 ### Bug Fixes

package/README.md

@@ -563,24 +563,218 @@ Since Chrome 69 (every chrome based browser), ANSI escape codes are natively sup
 
 For other browsers (like firefox) we use the console style syntax command `%c`.
 
+### Browser Compatibility for ANSI Codes
+
+| Browser     | Version   | Colors Supported |
+| ----------- | --------- | ---------------- |
+| **Chrome**  | **v69+**  | TrueColor (16M)  |
+| **Safari**  | **v10+**  | TrueColor (16M)  |
+| **Edge**    | **v79+**  | TrueColor (16M)  |
+| **Opera**   | **v56+**  | TrueColor (16M)  |
+| **Brave**   | **v1.0+** | TrueColor (16M)  |
+| **Vivaldi** | **v2.0+** | TrueColor (16M)  |
+
+> [!WARNING]
+> **Firefox** doesn't natively support ANSI codes in the developer console. Colorize automatically falls back to `%c` syntax for Firefox.
+
 ## Windows
 
 If you're on Windows, do yourself a favor and use [Windows Terminal](https://github.com/microsoft/terminal) instead of cmd.exe.
 
+## Edge Cases: Handling Input Arguments
+
+Colorize ensures consistent and predictable behavior for edge-case inputs, making it reliable for production use.
+
+### Handling falsy arguments
+
+```typescript
+import colorize, { red } from "@visulima/colorize";
+
+colorize.red(); // ✅ Returns empty string ''
+colorize.red(undefined); // ✅ Returns empty string ''
+colorize.red(null); // ✅ Returns empty string ''
+colorize.red(""); // ✅ Returns empty string ''
+colorize.reset(); // ✅ Returns reset ANSI code '\x1b[0m'
+```
+
+This reliable handling prevents unexpected output when working with variables that might be `undefined`, `null`, or empty strings.
+
+## Which One Should You Use?
+
+### Quick Decision Guide
+
+- **Need basic 16 colors only?** Both Colorize and `styleText()` work, but Colorize is **~100x faster** and supports more environments.
+- **Need truecolor (hex/rgb), 256 colors, or browser support?** Use **Colorize** - `styleText()` doesn't support these.
+- **Need nested template strings or chained syntax?** Use **Colorize** - `styleText()` requires verbose nested calls.
+- **Only targeting Node.js 22+ and want zero dependencies?** `styleText()` works, but consider the performance and feature trade-offs.
+
+### Checklist
+
+- Does support for **ESM** or **CJS** matter?
+    - ✅ Colorize: `ESM` and `CJS`
+    - ❌ styleText: Node.js only
+
+- Does **browser compatibility** matter?
+    - ✅ Colorize: Works in Chromium-based browsers and Safari
+    - ❌ styleText: Node.js only
+
+- Does **performance** matter? (e.g., high-frequency logging)
+    - ✅ Colorize: **~100x faster** than styleText
+    - ❌ styleText: Significantly slower
+
+- Does support for **[ANSI 256 colors](#256-colors)** or **[Truecolor](#truecolor)** with [fallback](#fallback) matter?
+    - ✅ Colorize: Full support with automatic fallback
+    - ❌ styleText: Limited to 16 colors only
+
+- Does handling **[edge cases](#edge-cases-handling-input-arguments)** (undefined, null, empty strings) matter?
+    - ✅ Colorize: Reliable handling of all edge cases
+    - ⚠️ styleText: Behavior varies by Node.js version
+
+- Does keeping your code **clean and readable** matter?
+    - ✅ Colorize: [Default and named import](#named-import), [chained syntax](#chained-syntax), [nested template strings](#nested-syntax)
+    - ❌ styleText: Verbose nested calls, no chaining
+
+- Does **TypeScript** support and IDE autocomplete matter?
+    - ✅ Colorize: Full TypeScript support with autocomplete
+    - ⚠️ styleText: Basic TypeScript support
+
+## Library Maintenance Status
+
+As of 2025, here's the maintenance status of popular ANSI color libraries:
+
+- ✅ **@visulima/colorize**: Actively maintained
+- ✅ **ansis**: Actively maintained
+- ✅ **chalk**: Actively maintained
+- ✅ **picocolors**: Actively maintained
+- ⚠️ **colorette**: Last updated 2+ years ago
+- ⚠️ **ansi-colors**: Last updated 3+ years ago
+- ⚠️ **kleur**: Last updated 3+ years ago
+- ⚠️ **colors.js**: Last updated 2+ years ago
+- ⚠️ **cli-color**: Last updated 1+ year ago
+- ⚠️ **colors-cli**: Last updated 1+ year ago
+
+Colorize is actively maintained and regularly updated with new features, bug fixes, and performance improvements.
+
+## Colorize vs `util.styleText()`
+
+Since **Node.js v22**, the built-in [`util.styleText()`](https://nodejs.org/api/util.html#utilstyletextformat-text-options) function has been officially introduced, supporting [standard modifiers](https://nodejs.org/api/util.html#modifiers) - the basic 16 colors and styles.
+
+### Where it works
+
+**Colorize**
+
+✅ Works on **Node.js v20.19+**\
+✅ Works in Chromium-based browsers and Safari (useful for shared utils)\
+✅ Works in **Deno** and **Next.JS** runtimes\
+⚠️ **Firefox DevTools** don't render ANSI escape sequences.
+
+**styleText**
+
+✅ Native since **Node.js v22+**\
+❌ Node only - it doesn't work in browsers or other runtimes
+
+### Performance
+
+In practical benchmarks, `styleText()` is dramatically slower, **~100x slower** than Colorize:
+
+```js
+styleText("red", "text"); //    579.832 ops/sec
+colorize.red("text"); // 59.646.465 ops/sec
+```
+
+See the [benchmark](./__bench__/README.md) for detailed performance comparisons.
+
+### Color support detection
+
+**Colorize**
+
+- Detects terminal, TTY, CI, or browser color capability and automatically falls back to the supported level (truecolor → 256 → 16 → no color).
+- Supports common flags and environment variables:\
+  `NO_COLOR`, `FORCE_COLOR`, `COLORTERM`, `--no-color`, `--color`.
+
+**styleText**
+
+- Detects terminal color support automatically.
+- Supports only environment variables:\
+  `NO_COLOR`, `FORCE_COLOR`, `NODE_DISABLE_COLORS`.
+
+### Simple styling
+
+**Colorize** has a compact and elegant syntax:
+
+```typescript
+import colorize, { green } from "@visulima/colorize";
+
+console.log(colorize.green("Success!"));
+// or even shorter using named import
+console.log(green`Success!`);
+console.log(green.bold`Success!`);
+```
+
+The same example with **styleText** is more verbose:
+
+```js
+const { styleText } = require("node:util");
+
+console.log(styleText("green", "Success!"));
+console.log(styleText(["green", "bold"], "Success!"));
+```
+
+### Nested styling
+
+**Colorize** keeps your code short and readable:
+
+```typescript
+import { red, cyan } from "@visulima/colorize";
+
+console.log(red`Error: ${cyan.bold`file.js`} not found!`);
+```
+
+Using **styleText** becomes awkward and verbose for nested or combined styles:
+
+```js
+const { styleText } = require("node:util");
+
+console.log(styleText("red", `Error: ${styleText(["cyan", "bold"], "file.js")} not found!`));
+```
+
+### Truecolor
+
+**Colorize**
+
+- Supports 16-color, 256-color, and truecolor output.
+- Truecolor methods `hex()` and `rgb()`:
+
+    ```typescript
+    console.log(colorize.hex("#ffa500")("orange text"));
+    console.log(colorize.rgb(255, 165, 0)("orange text"));
+    ```
+
+**styleText**
+
+- Limited to the 16 ANSI colors and standard styles.
+- No support for hex, rgb, or truecolor.
+
+### TypeScript & IDE support
+
+**Colorize** includes `d.ts` type definitions for seamless **TypeScript** integration.\
+Color names, methods, and style chains are fully typed, enabling **autocomplete** and **type checking** in IDEs like VS Code.
+
 ## Comparison of most popular libraries
 
-| Library<br>**\*\***\_\_**\*\***<br> - name<br> - named import     | Code size                                                                      |               Naming colors                | ANSI 256<br>colors | True-<br>color | Chained<br>syntax | Nested<br>template strings | New<br>Line |            Supports<br>CLI params<br>ENV vars            | Fallbacks                          |
-| :---------------------------------------------------------------- | :----------------------------------------------------------------------------- | :----------------------------------------: | :----------------: | :------------: | :---------------: | :------------------------: | :---------: | :------------------------------------------------------: | ---------------------------------- |
-| [`@visulima/colorize`][npm-url]<br><nobr>`✅ named import`</nobr> | ![npm bundle size](https://img.shields.io/bundlephobia/min/@visulima/colorize) |        **standard**<br>`16` colors         |         ✅         |       ✅       |        ✅         |             ✅             |     ✅      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | 256 color<br>16 colors<br>no color |
-| [`ansi-colors`][ansi-colors]<br><nobr>`❌ named import`</nobr>    | ![npm bundle size](https://img.shields.io/bundlephobia/min/ansi-colors)        |        **standard**<br>`16` colors         |         ❌         |       ❌       |        ✅         |             ❌             |     ✅      |                  only<br>`FORCE_COLOR`                   | ❌                                 |
-| [`ansis`][ansis]<br><nobr>`✅ named import`</nobr>                | ![npm bundle size](https://img.shields.io/bundlephobia/min/ansis)              |        **standard**<br>`16` colors         |         ✅         |       ✅       |        ✅         |             ✅             |     ✅      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | 256 color<br>16 colors<br>no color |
-| [`chalk`][chalk]<br><nobr>`❌ named import`</nobr>                | ![npm bundle size](https://img.shields.io/bundlephobia/min/chalk)              |        **standard**<br>`16` colors         |         ✅         |       ✅       |        ✅         |             ❌             |     ✅      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | 256 color<br>16 colors<br>no color |
-| [`cli-color`][cli-color]<br><nobr>`❌ named import`</nobr>        | ![npm bundle size](https://img.shields.io/bundlephobia/min/cli-color)          |        **standard**<br>`16` colors         |         ✅         |       ❌       |        ✅         |             ❌             |     ❌      |                    only<br>`NO_COLOR`                    | 16 colors<br>no color              |
-| [`colorette`][colorette]<br><nobr>`✅ named import`</nobr>        | ![npm bundle size](https://img.shields.io/bundlephobia/min/colorette)          |        **standard**<br>`16` colors         |         ❌         |       ❌       |        ❌         |             ❌             |     ❌      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | no color                           |
-| [`colors-cli`][colors-cli]<br><nobr>`❌ named import`</nobr>      | ![npm bundle size](https://img.shields.io/bundlephobia/min/colors-cli)         | <nobr>_non-standard_</nobr><br>`16` colors |         ✅         |       ❌       |        ✅         |             ❌             |     ✅      |            only<br>`--no-color`<br>`--color`             | no color                           |
-| [`colors.js`][colors.js]<br><nobr>`❌ named import`</nobr>        | ![npm bundle size](https://img.shields.io/bundlephobia/min/colors.js)          | <nobr>_non-standard_</nobr><br>`16` colors |         ❌         |       ❌       |        ✅         |             ❌             |     ✅      |    only<br>`FORCE_COLOR`<br>`--no-color`<br>`--color`    | no color                           |
-| [`kleur`][kleur]<br><nobr>`✅ named import`</nobr>                | ![npm bundle size](https://img.shields.io/bundlephobia/min/kleur)              |         **standard**<br>`8` colors         |         ❌         |       ❌       |        ✅         |             ❌             |     ❌      |           only<br>`NO_COLOR`<br>`FORCE_COLOR`            | no color                           |
-| [`picocolors`][picocolors]<br><nobr>`❌ named import`</nobr>      | ![npm bundle size](https://img.shields.io/bundlephobia/min/picocolors)         |         **standard**<br>`8` colors         |         ❌         |       ❌       |        ❌         |             ❌             |     ❌      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | no color                           |
+| Library<br>**\*\***\_\_**\*\***<br> - name<br> - named import                                 | Code size                                                                      |               Naming colors                | ANSI 256<br>colors | True-<br>color | Chained<br>syntax | Nested<br>template strings | New<br>Line |            Supports<br>CLI params<br>ENV vars            | Fallbacks                          |
+| :-------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------- | :----------------------------------------: | :----------------: | :------------: | :---------------: | :------------------------: | :---------: | :------------------------------------------------------: | ---------------------------------- |
+| [`@visulima/colorize`][npm-url]<br><nobr>`✅ named import`</nobr>                             | ![npm bundle size](https://img.shields.io/bundlephobia/min/@visulima/colorize) |        **standard**<br>`16` colors         |         ✅         |       ✅       |        ✅         |             ✅             |     ✅      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | 256 color<br>16 colors<br>no color |
+| [`ansi-colors`][ansi-colors]<br><nobr>`❌ named import`</nobr>                                | ![npm bundle size](https://img.shields.io/bundlephobia/min/ansi-colors)        |        **standard**<br>`16` colors         |         ❌         |       ❌       |        ✅         |             ❌             |     ✅      |                  only<br>`FORCE_COLOR`                   | ❌                                 |
+| [`ansis`][ansis]<br><nobr>`✅ named import`</nobr>                                            | ![npm bundle size](https://img.shields.io/bundlephobia/min/ansis)              |        **standard**<br>`16` colors         |         ✅         |       ✅       |        ✅         |             ✅             |     ✅      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | 256 color<br>16 colors<br>no color |
+| [`chalk`][chalk]<br><nobr>`❌ named import`</nobr>                                            | ![npm bundle size](https://img.shields.io/bundlephobia/min/chalk)              |        **standard**<br>`16` colors         |         ✅         |       ✅       |        ✅         |             ❌             |     ✅      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | 256 color<br>16 colors<br>no color |
+| [`cli-color`][cli-color]<br><nobr>`❌ named import`</nobr>                                    | ![npm bundle size](https://img.shields.io/bundlephobia/min/cli-color)          |        **standard**<br>`16` colors         |         ✅         |       ❌       |        ✅         |             ❌             |     ❌      |                    only<br>`NO_COLOR`                    | 16 colors<br>no color              |
+| [`colorette`][colorette]<br><nobr>`✅ named import`</nobr>                                    | ![npm bundle size](https://img.shields.io/bundlephobia/min/colorette)          |        **standard**<br>`16` colors         |         ❌         |       ❌       |        ❌         |             ❌             |     ❌      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | no color                           |
+| [`colors-cli`][colors-cli]<br><nobr>`❌ named import`</nobr>                                  | ![npm bundle size](https://img.shields.io/bundlephobia/min/colors-cli)         | <nobr>_non-standard_</nobr><br>`16` colors |         ✅         |       ❌       |        ✅         |             ❌             |     ✅      |            only<br>`--no-color`<br>`--color`             | no color                           |
+| [`colors.js`][colors.js]<br><nobr>`❌ named import`</nobr>                                    | ![npm bundle size](https://img.shields.io/bundlephobia/min/colors.js)          | <nobr>_non-standard_</nobr><br>`16` colors |         ❌         |       ❌       |        ✅         |             ❌             |     ✅      |    only<br>`FORCE_COLOR`<br>`--no-color`<br>`--color`    | no color                           |
+| [`kleur`][kleur]<br><nobr>`✅ named import`</nobr>                                            | ![npm bundle size](https://img.shields.io/bundlephobia/min/kleur)              |         **standard**<br>`8` colors         |         ❌         |       ❌       |        ✅         |             ❌             |     ❌      |           only<br>`NO_COLOR`<br>`FORCE_COLOR`            | no color                           |
+| [`picocolors`][picocolors]<br><nobr>`❌ named import`</nobr>                                  | ![npm bundle size](https://img.shields.io/bundlephobia/min/picocolors)         |         **standard**<br>`8` colors         |         ❌         |       ❌       |        ❌         |             ❌             |     ❌      | `NO_COLOR`<br>`FORCE_COLOR`<br>`--no-color`<br>`--color` | no color                           |
+| [`util.styleText()`][styleText]<br><nobr>`❌ named import`</nobr><br><nobr>`Node ≥ 22`</nobr> | Built-in                                                                       |        **standard**<br>`16` colors         |         ❌         |       ❌       |        ❌         |             ❌             |     ❓      |   `NO_COLOR`<br>`FORCE_COLOR`<br>`NODE_DISABLE_COLORS`   | no color                           |
 
 > **Note**
 >
@@ -614,6 +808,7 @@ If you're on Windows, do yourself a favor and use [Windows Terminal](https://git
 > - [`@visulima/colorize`][npm-url]: `hex()` `rgb()`
 > - [`ansis`][ansis]: `hex()` `rgb()`
 > - [`chalk`][chalk]: `hex()` `rgb()`
+> - [`util.styleText()`][styleText]: Not supported (limited to 16 colors)
 >
 > **Chained syntax**\
 > `lib.red.bold('text')`
@@ -745,3 +940,4 @@ The visulima colorize is open-sourced software licensed under the [MIT][license-
 [chalk]: https://github.com/chalk/chalk
 [chalk-template]: https://github.com/chalk/chalk-template
 [ansis]: https://github.com/webdiscus/ansis
+[styleText]: https://nodejs.org/api/util.html#utilstyletextformat-text-options

package/dist/gradient.cjs

@@ -1,3 +1,60 @@
-"use strict";var G=Object.defineProperty;var v=(t,r)=>G(t,"name",{value:r,configurable:!0});Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const B=require("./packem_shared/colorize.server-BX0i6nN6.cjs"),g=require("./packem_shared/GradientBuilder-D6w_X2D1.cjs");var M=Object.defineProperty,f=v((t,r)=>M(t,"name",{value:r,configurable:!0}),"c");const b=new B.m,p=/\s/g,S=f((t,r)=>{const{hsvSpin:u="short",interpolation:c="rgb"}=r??{};let e=new g.GradientBuilder(b,t);return r?.loop?e=e.loop():r?.reverse&&(e=e.reverse()),s=>{const o=Math.max(s.replaceAll(p,"").length,e.stops.length),a=c==="rgb"?e.rgb(o):e.hsv(o,u);let l="";for(const n of s)if(p.test(n))l+=n;else{const i=a.shift();l+=i(n)}return l}},"gradient"),j=f((t,r)=>{const{hsvSpin:u="short",interpolation:c="rgb"}=r??{};let e=new g.GradientBuilder(b,t);return r?.loop?e=e.loop():r?.reverse&&(e=e.reverse()),s=>{const o=s.split(`
-`),a=Reflect.apply(Math.max,null,[...o.map(i=>i.length),e.stops.length]),l=c==="rgb"?e.rgb(a):e.hsv(a,u),n=[];for(const i of o){const m=[...l];let h="";for(const d of i)h+=p.test(d)?d:m.shift()(d);n.push(h)}return n.join(`
-`)}},"multilineGradient");exports.GradientBuilder=g.GradientBuilder;exports.gradient=S;exports.multilineGradient=j;
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const colorize_server = require('./packem_shared/colorize.server-BA3gZZXz.cjs');
+const GradientBuilder = require('./packem_shared/GradientBuilder-DjJK22kP.cjs');
+
+const colorize = new colorize_server.Colorize();
+const forbiddenChars = /\s/g;
+const gradient = (stops, options) => {
+  const { hsvSpin = "short", interpolation = "rgb" } = options ?? {};
+  let builder = new GradientBuilder.GradientBuilder(colorize, stops);
+  if (options?.loop) {
+    builder = builder.loop();
+  } else if (options?.reverse) {
+    builder = builder.reverse();
+  }
+  return (string_) => {
+    const colorsCount = Math.max(string_.replaceAll(forbiddenChars, "").length, builder.stops.length);
+    const colors = interpolation === "rgb" ? builder.rgb(colorsCount) : builder.hsv(colorsCount, hsvSpin);
+    let result = "";
+    for (const s of string_) {
+      if (forbiddenChars.test(s)) {
+        result += s;
+      } else {
+        const color = colors.shift();
+        result += color(s);
+      }
+    }
+    return result;
+  };
+};
+const multilineGradient = (stops, options) => {
+  const { hsvSpin = "short", interpolation = "rgb" } = options ?? {};
+  let builder = new GradientBuilder.GradientBuilder(colorize, stops);
+  if (options?.loop) {
+    builder = builder.loop();
+  } else if (options?.reverse) {
+    builder = builder.reverse();
+  }
+  return (string_) => {
+    const lines = string_.split("\n");
+    const colorsCount = Reflect.apply(Math.max, null, [...lines.map((l) => l.length), builder.stops.length]);
+    const colors = interpolation === "rgb" ? builder.rgb(colorsCount) : builder.hsv(colorsCount, hsvSpin);
+    const results = [];
+    for (const line of lines) {
+      const lineColors = [...colors];
+      let lineResult = "";
+      for (const l of line) {
+        lineResult += forbiddenChars.test(l) ? l : lineColors.shift()(l);
+      }
+      results.push(lineResult);
+    }
+    return results.join("\n");
+  };
+};
+
+exports.GradientBuilder = GradientBuilder.GradientBuilder;
+exports.gradient = gradient;
+exports.multilineGradient = multilineGradient;

package/dist/gradient.mjs

@@ -1,3 +1,54 @@
-var w=Object.defineProperty;var u=(r,e)=>w(r,"name",{value:e,configurable:!0});import{m as x}from"./packem_shared/colorize.server-BkwhBIE0.mjs";import{GradientBuilder as v}from"./packem_shared/GradientBuilder-DnPdd2Cf.mjs";var G=Object.defineProperty,m=u((r,e)=>G(r,"name",{value:e,configurable:!0}),"c");const b=new x,f=/\s/g,S=m((r,e)=>{const{hsvSpin:a="short",interpolation:c="rgb"}=e??{};let t=new v(b,r);return e?.loop?t=t.loop():e?.reverse&&(t=t.reverse()),i=>{const n=Math.max(i.replaceAll(f,"").length,t.stops.length),p=c==="rgb"?t.rgb(n):t.hsv(n,a);let s="";for(const o of i)if(f.test(o))s+=o;else{const l=p.shift();s+=l(o)}return s}},"gradient"),A=m((r,e)=>{const{hsvSpin:a="short",interpolation:c="rgb"}=e??{};let t=new v(b,r);return e?.loop?t=t.loop():e?.reverse&&(t=t.reverse()),i=>{const n=i.split(`
-`),p=Reflect.apply(Math.max,null,[...n.map(l=>l.length),t.stops.length]),s=c==="rgb"?t.rgb(p):t.hsv(p,a),o=[];for(const l of n){const d=[...s];let g="";for(const h of l)g+=f.test(h)?h:d.shift()(h);o.push(g)}return o.join(`
-`)}},"multilineGradient");export{v as GradientBuilder,S as gradient,A as multilineGradient};
+import { C as Colorize } from './packem_shared/colorize.server-ry9FZNfG.mjs';
+import { GradientBuilder } from './packem_shared/GradientBuilder-Ba4Teq6P.mjs';
+
+const colorize = new Colorize();
+const forbiddenChars = /\s/g;
+const gradient = (stops, options) => {
+  const { hsvSpin = "short", interpolation = "rgb" } = options ?? {};
+  let builder = new GradientBuilder(colorize, stops);
+  if (options?.loop) {
+    builder = builder.loop();
+  } else if (options?.reverse) {
+    builder = builder.reverse();
+  }
+  return (string_) => {
+    const colorsCount = Math.max(string_.replaceAll(forbiddenChars, "").length, builder.stops.length);
+    const colors = interpolation === "rgb" ? builder.rgb(colorsCount) : builder.hsv(colorsCount, hsvSpin);
+    let result = "";
+    for (const s of string_) {
+      if (forbiddenChars.test(s)) {
+        result += s;
+      } else {
+        const color = colors.shift();
+        result += color(s);
+      }
+    }
+    return result;
+  };
+};
+const multilineGradient = (stops, options) => {
+  const { hsvSpin = "short", interpolation = "rgb" } = options ?? {};
+  let builder = new GradientBuilder(colorize, stops);
+  if (options?.loop) {
+    builder = builder.loop();
+  } else if (options?.reverse) {
+    builder = builder.reverse();
+  }
+  return (string_) => {
+    const lines = string_.split("\n");
+    const colorsCount = Reflect.apply(Math.max, null, [...lines.map((l) => l.length), builder.stops.length]);
+    const colors = interpolation === "rgb" ? builder.rgb(colorsCount) : builder.hsv(colorsCount, hsvSpin);
+    const results = [];
+    for (const line of lines) {
+      const lineColors = [...colors];
+      let lineResult = "";
+      for (const l of line) {
+        lineResult += forbiddenChars.test(l) ? l : lineColors.shift()(l);
+      }
+      results.push(lineResult);
+    }
+    return results.join("\n");
+  };
+};
+
+export { GradientBuilder, gradient, multilineGradient };

package/dist/index.browser.mjs

@@ -1 +1,63 @@
-import g from"./packem_shared/Colorize-BHcGWJJ0.mjs";const e=new g,{ansi256:i,bg:t,bgAnsi256:b,bgBlack:h,bgBlackBright:a,bgBlue:l,bgBlueBright:n,bgCyan:B,bgCyanBright:o,bgGray:s,bgGreen:d,bgGreenBright:y,bgGrey:c,bgHex:u,bgMagenta:w,bgMagentaBright:k,bgRed:m,bgRedBright:G,bgRgb:f,bgWhite:p,bgWhiteBright:v,bgYellow:x,bgYellowBright:C,black:R,blackBright:M,blue:W,blueBright:Y,bold:j,cyan:z,cyanBright:A,dim:H,fg:q,gray:D,green:E,greenBright:F,grey:I,hex:J,hidden:K,inverse:L,italic:N,magenta:O,magentaBright:P,overline:Q,red:S,redBright:T,reset:U,rgb:V,strike:X,strikethrough:Z,strip:_,underline:$,visible:gg,white:eg,whiteBright:rg,yellow:ig,yellowBright:tg}=e;export{g as Colorize,i as ansi256,t as bg,b as bgAnsi256,h as bgBlack,a as bgBlackBright,l as bgBlue,n as bgBlueBright,B as bgCyan,o as bgCyanBright,s as bgGray,d as bgGreen,y as bgGreenBright,c as bgGrey,u as bgHex,w as bgMagenta,k as bgMagentaBright,m as bgRed,G as bgRedBright,f as bgRgb,p as bgWhite,v as bgWhiteBright,x as bgYellow,C as bgYellowBright,R as black,M as blackBright,W as blue,Y as blueBright,j as bold,z as cyan,A as cyanBright,e as default,H as dim,q as fg,D as gray,E as green,F as greenBright,I as grey,J as hex,K as hidden,L as inverse,N as italic,O as magenta,P as magentaBright,Q as overline,S as red,T as redBright,U as reset,V as rgb,X as strike,Z as strikethrough,_ as strip,$ as underline,gg as visible,eg as white,rg as whiteBright,ig as yellow,tg as yellowBright};
+import WebColorize from './packem_shared/Colorize-Ca9CXTcj.mjs';
+
+const colorize = new WebColorize();
+const {
+  ansi256,
+  bg,
+  bgAnsi256,
+  bgBlack,
+  bgBlackBright,
+  bgBlue,
+  bgBlueBright,
+  bgCyan,
+  bgCyanBright,
+  bgGray,
+  bgGreen,
+  bgGreenBright,
+  bgGrey,
+  bgHex,
+  bgMagenta,
+  bgMagentaBright,
+  bgRed,
+  bgRedBright,
+  bgRgb,
+  bgWhite,
+  bgWhiteBright,
+  bgYellow,
+  bgYellowBright,
+  black,
+  blackBright,
+  blue,
+  blueBright,
+  bold,
+  cyan,
+  cyanBright,
+  dim,
+  fg,
+  gray,
+  green,
+  greenBright,
+  grey,
+  hex,
+  hidden,
+  inverse,
+  italic,
+  magenta,
+  magentaBright,
+  overline,
+  red,
+  redBright,
+  reset,
+  rgb,
+  strike,
+  strikethrough,
+  strip,
+  underline,
+  visible,
+  white,
+  whiteBright,
+  yellow,
+  yellowBright
+} = colorize;
+
+export { WebColorize as Colorize, ansi256, bg, bgAnsi256, bgBlack, bgBlackBright, bgBlue, bgBlueBright, bgCyan, bgCyanBright, bgGray, bgGreen, bgGreenBright, bgGrey, bgHex, bgMagenta, bgMagentaBright, bgRed, bgRedBright, bgRgb, bgWhite, bgWhiteBright, bgYellow, bgYellowBright, black, blackBright, blue, blueBright, bold, cyan, cyanBright, colorize as default, dim, fg, gray, green, greenBright, grey, hex, hidden, inverse, italic, magenta, magentaBright, overline, red, redBright, reset, rgb, strike, strikethrough, strip, underline, visible, white, whiteBright, yellow, yellowBright };