@visulima/colorize 2.0.0-alpha.1 → 2.0.0-alpha.10

package/dist/template.cjs

@@ -2,15 +2,15 @@
 
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-const colorize_server = require('./packem_shared/colorize.server-BA3gZZXz.cjs');
-const convertHexToRgb = require('./packem_shared/convertHexToRgb-DvkHBM3-.cjs');
+const colorize_server = require('./packem_shared/colorize.server-CwTmhs0e.cjs');
+const convertHexToRgb = require('./packem_shared/convertHexToRgb-51-edHxE.cjs');
 
 const makeColorizeTemplate = (template) => (firstString, ...arguments_) => {
   if (!Array.isArray(firstString) || !Array.isArray(firstString.raw)) {
     throw new TypeError("A tagged template literal must be provided");
   }
   const parts = [firstString.raw[0]];
-  for (let index = 1; index < firstString.raw.length; index++) {
+  for (let index = 1; index < firstString.raw.length; index += 1) {
     parts.push(String(arguments_[index - 1]).replaceAll(/[{}\\]/g, String.raw`\$&`), String(firstString.raw[index]));
   }
   return template(parts.join(""));
@@ -44,16 +44,24 @@ const TEMPLATE_REGEX = /\\(u(?:[a-f\d]{4}|\{[a-f\d]{1,6}\})|x[a-f\d]{2}|.)|\{(~)
 const STYLE_REGEX = /(?:^|\.)(?:(\w+)(?:\(([^)]*)\))?|#(?=[:a-f\d]{2,})([a-f\d]{6})?(?::([a-f\d]{6}))?)/gi;
 const STRING_REGEX = /^(['"])((?:\\.|(?!\1)[^\\])*)\1$/;
 const ESCAPE_REGEX = /\\(u(?:[a-f\d]{4}|\{[a-f\d]{1,6}\})|x[a-f\d]{2}|.)|([^\\])/gi;
+const CHUNK_SPLIT_REGEX = /\s*,\s*/;
 const parseArguments = (name, value) => {
   const results = [];
-  const chunks = value.trim().split(/\s*,\s*/);
+  const chunks = value.trim().split(CHUNK_SPLIT_REGEX);
   let matches;
   for (const chunk of chunks) {
     const number = Number(chunk);
     if (!Number.isNaN(number)) {
       results.push(number);
     } else if (matches = STRING_REGEX.exec(chunk)) {
-      results.push(matches[2].replace(ESCAPE_REGEX, (_, escape, character) => escape ? unescape(escape) : character));
+      results.push(
+        matches[2].replaceAll(ESCAPE_REGEX, (_, escape, character) => {
+          if (escape) {
+            return unescape(escape);
+          }
+          return character;
+        })
+      );
     } else {
       throw new Error(`Invalid template style argument: ${chunk} (in style '${name}')`);
     }
@@ -85,7 +93,7 @@ const buildStyle = (colorize, styles) => {
   const enabled = {};
   for (const layer of styles) {
     for (const style of layer.styles) {
-      enabled[style[0]] = layer.inverse ? null : style.slice(1);
+      enabled[style[0]] = layer.inverse ? void 0 : style.slice(1);
     }
   }
   let current = colorize;
@@ -129,7 +137,7 @@ const makeTemplate = (colorize) => (string) => {
   );
   chunks.push(chunk.join(""));
   if (styles.length > 0) {
-    throw new Error(`template literal is missing ${styles.length} closing bracket${styles.length === 1 ? "" : "s"} (\`}\`)`);
+    throw new Error(`template literal is missing ${String(styles.length)} closing bracket${styles.length === 1 ? "" : "s"} (\`}\`)`);
   }
   return chunks.join("");
 };

package/dist/template.mjs

@@ -1,12 +1,12 @@
-import { C as Colorize } from './packem_shared/colorize.server-ry9FZNfG.mjs';
-import { convertHexToRgb } from './packem_shared/convertHexToRgb-CWdAm2kE.mjs';
+import { C as Colorize } from './packem_shared/colorize.server-YxoHIDUp.mjs';
+import { convertHexToRgb } from './packem_shared/convertHexToRgb-BZwJEiMZ.mjs';
 
 const makeColorizeTemplate = (template) => (firstString, ...arguments_) => {
   if (!Array.isArray(firstString) || !Array.isArray(firstString.raw)) {
     throw new TypeError("A tagged template literal must be provided");
   }
   const parts = [firstString.raw[0]];
-  for (let index = 1; index < firstString.raw.length; index++) {
+  for (let index = 1; index < firstString.raw.length; index += 1) {
     parts.push(String(arguments_[index - 1]).replaceAll(/[{}\\]/g, String.raw`\$&`), String(firstString.raw[index]));
   }
   return template(parts.join(""));
@@ -40,16 +40,24 @@ const TEMPLATE_REGEX = /\\(u(?:[a-f\d]{4}|\{[a-f\d]{1,6}\})|x[a-f\d]{2}|.)|\{(~)
 const STYLE_REGEX = /(?:^|\.)(?:(\w+)(?:\(([^)]*)\))?|#(?=[:a-f\d]{2,})([a-f\d]{6})?(?::([a-f\d]{6}))?)/gi;
 const STRING_REGEX = /^(['"])((?:\\.|(?!\1)[^\\])*)\1$/;
 const ESCAPE_REGEX = /\\(u(?:[a-f\d]{4}|\{[a-f\d]{1,6}\})|x[a-f\d]{2}|.)|([^\\])/gi;
+const CHUNK_SPLIT_REGEX = /\s*,\s*/;
 const parseArguments = (name, value) => {
   const results = [];
-  const chunks = value.trim().split(/\s*,\s*/);
+  const chunks = value.trim().split(CHUNK_SPLIT_REGEX);
   let matches;
   for (const chunk of chunks) {
     const number = Number(chunk);
     if (!Number.isNaN(number)) {
       results.push(number);
     } else if (matches = STRING_REGEX.exec(chunk)) {
-      results.push(matches[2].replace(ESCAPE_REGEX, (_, escape, character) => escape ? unescape(escape) : character));
+      results.push(
+        matches[2].replaceAll(ESCAPE_REGEX, (_, escape, character) => {
+          if (escape) {
+            return unescape(escape);
+          }
+          return character;
+        })
+      );
     } else {
       throw new Error(`Invalid template style argument: ${chunk} (in style '${name}')`);
     }
@@ -81,7 +89,7 @@ const buildStyle = (colorize, styles) => {
   const enabled = {};
   for (const layer of styles) {
     for (const style of layer.styles) {
-      enabled[style[0]] = layer.inverse ? null : style.slice(1);
+      enabled[style[0]] = layer.inverse ? void 0 : style.slice(1);
     }
   }
   let current = colorize;
@@ -125,7 +133,7 @@ const makeTemplate = (colorize) => (string) => {
   );
   chunks.push(chunk.join(""));
   if (styles.length > 0) {
-    throw new Error(`template literal is missing ${styles.length} closing bracket${styles.length === 1 ? "" : "s"} (\`}\`)`);
+    throw new Error(`template literal is missing ${String(styles.length)} closing bracket${styles.length === 1 ? "" : "s"} (\`}\`)`);
   }
   return chunks.join("");
 };

package/dist/types.d.cts

@@ -49,7 +49,7 @@ export interface ColorizeType {
     readonly bgGrey: this;
     /**
      * Set HEX value for background color.
-     * @param {string} hex
+     * @param {string} color
      */
     bgHex: (color: ColorValueHex) => this;
     readonly bgMagenta: this;
@@ -90,7 +90,7 @@ export interface ColorizeType {
     readonly grey: this;
     /**
      * Set HEX value for foreground color.
-     * @param {string} hex
+     * @param {string} color
      */
     hex: (color: ColorValueHex) => this;
     /** Print the invisible text. */
@@ -122,7 +122,7 @@ export interface ColorizeType {
     readonly strikethrough: this;
     /**
      * Remove ANSI styling codes.
-     * @param {string} str
+     * @param {string} string
      * @returns {string}
      */
     strip: (string: string) => string;

package/dist/types.d.mts

@@ -49,7 +49,7 @@ export interface ColorizeType {
     readonly bgGrey: this;
     /**
      * Set HEX value for background color.
-     * @param {string} hex
+     * @param {string} color
      */
     bgHex: (color: ColorValueHex) => this;
     readonly bgMagenta: this;
@@ -90,7 +90,7 @@ export interface ColorizeType {
     readonly grey: this;
     /**
      * Set HEX value for foreground color.
-     * @param {string} hex
+     * @param {string} color
      */
     hex: (color: ColorValueHex) => this;
     /** Print the invisible text. */
@@ -122,7 +122,7 @@ export interface ColorizeType {
     readonly strikethrough: this;
     /**
      * Remove ANSI styling codes.
-     * @param {string} str
+     * @param {string} string
      * @returns {string}
      */
     strip: (string: string) => string;

package/dist/types.d.ts

@@ -49,7 +49,7 @@ export interface ColorizeType {
     readonly bgGrey: this;
     /**
      * Set HEX value for background color.
-     * @param {string} hex
+     * @param {string} color
      */
     bgHex: (color: ColorValueHex) => this;
     readonly bgMagenta: this;
@@ -90,7 +90,7 @@ export interface ColorizeType {
     readonly grey: this;
     /**
      * Set HEX value for foreground color.
-     * @param {string} hex
+     * @param {string} color
      */
     hex: (color: ColorValueHex) => this;
     /** Print the invisible text. */
@@ -122,7 +122,7 @@ export interface ColorizeType {
     readonly strikethrough: this;
     /**
      * Remove ANSI styling codes.
-     * @param {string} str
+     * @param {string} string
      * @returns {string}
      */
     strip: (string: string) => string;

package/dist/util/clamp.d.cts

@@ -7,6 +7,6 @@
  */
 /**
  * Clamp a number within the inclusive range specified by min and max.
- * @note: The ternary operator is a tick quicker than Math.min(Math.max(num, min), max).
+ * The ternary operator is a tick quicker than Math.min(Math.max(num, min), max).
  */
 export declare const clamp: (number_: number, min: number, max: number) => number;

package/dist/util/clamp.d.mts

@@ -7,6 +7,6 @@
  */
 /**
  * Clamp a number within the inclusive range specified by min and max.
- * @note: The ternary operator is a tick quicker than Math.min(Math.max(num, min), max).
+ * The ternary operator is a tick quicker than Math.min(Math.max(num, min), max).
  */
 export declare const clamp: (number_: number, min: number, max: number) => number;

package/dist/util/clamp.d.ts

@@ -7,6 +7,6 @@
  */
 /**
  * Clamp a number within the inclusive range specified by min and max.
- * @note: The ternary operator is a tick quicker than Math.min(Math.max(num, min), max).
+ * The ternary operator is a tick quicker than Math.min(Math.max(num, min), max).
  */
 export declare const clamp: (number_: number, min: number, max: number) => number;

package/dist/util/convert-hex-to-rgb.d.cts

@@ -5,18 +5,4 @@
  *
  * Copyright (c) 2023, webdiscus
  */
-import type { ColorValueHex } from "../types.d.cts";
-/**
- * Convert hex color string to RGB values.
- *
- * A hexadecimal color code can be 3 or 6 digits with an optional "#" prefix.
- *
- * The 3 digits specifies an RGB doublet data as a fully opaque color.
- * For example, "#123" specifies the color that is represented by "#112233".
- *
- * The 6 digits specifies a fully opaque color.
- * For example, "#112233".
- * @param {string} hex A string that contains the hexadecimal RGB color representation.
- * @returns {[number, number, number]} The red, green, blue values in range [0, 255] .
- */
-export declare const convertHexToRgb: (hex: ColorValueHex | string) => [number, number, number];
+export declare const convertHexToRgb: (hex: string) => [number, number, number];

package/dist/util/convert-hex-to-rgb.d.mts

@@ -5,18 +5,4 @@
  *
  * Copyright (c) 2023, webdiscus
  */
-import type { ColorValueHex } from "../types.d.mts";
-/**
- * Convert hex color string to RGB values.
- *
- * A hexadecimal color code can be 3 or 6 digits with an optional "#" prefix.
- *
- * The 3 digits specifies an RGB doublet data as a fully opaque color.
- * For example, "#123" specifies the color that is represented by "#112233".
- *
- * The 6 digits specifies a fully opaque color.
- * For example, "#112233".
- * @param {string} hex A string that contains the hexadecimal RGB color representation.
- * @returns {[number, number, number]} The red, green, blue values in range [0, 255] .
- */
-export declare const convertHexToRgb: (hex: ColorValueHex | string) => [number, number, number];
+export declare const convertHexToRgb: (hex: string) => [number, number, number];

package/dist/util/convert-hex-to-rgb.d.ts

@@ -5,18 +5,4 @@
  *
  * Copyright (c) 2023, webdiscus
  */
-import type { ColorValueHex } from "../types.d.ts";
-/**
- * Convert hex color string to RGB values.
- *
- * A hexadecimal color code can be 3 or 6 digits with an optional "#" prefix.
- *
- * The 3 digits specifies an RGB doublet data as a fully opaque color.
- * For example, "#123" specifies the color that is represented by "#112233".
- *
- * The 6 digits specifies a fully opaque color.
- * For example, "#112233".
- * @param {string} hex A string that contains the hexadecimal RGB color representation.
- * @returns {[number, number, number]} The red, green, blue values in range [0, 255] .
- */
-export declare const convertHexToRgb: (hex: ColorValueHex | string) => [number, number, number];
+export declare const convertHexToRgb: (hex: string) => [number, number, number];

package/dist/utils.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-const convertHexToRgb = require('./packem_shared/convertHexToRgb-DvkHBM3-.cjs');
+const convertHexToRgb = require('./packem_shared/convertHexToRgb-51-edHxE.cjs');
 const rgbToAnsi256 = require('./packem_shared/rgbToAnsi256-DL8eajTz.cjs');
 
 

package/dist/utils.mjs

@@ -1,2 +1,2 @@
-export { convertHexToRgb } from './packem_shared/convertHexToRgb-CWdAm2kE.mjs';
+export { convertHexToRgb } from './packem_shared/convertHexToRgb-BZwJEiMZ.mjs';
 export { ansi256To16, rgbToAnsi16, rgbToAnsi256 } from './packem_shared/rgbToAnsi256-BdS0fomP.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/colorize",
-  "version": "2.0.0-alpha.1",
+  "version": "2.0.0-alpha.10",
   "description": "Terminal and Console string styling done right.",
   "keywords": [
     "256",
@@ -55,7 +55,7 @@
     "xterm",
     "yellow"
   ],
-  "homepage": "https://www.visulima.com/docs/package/colorize",
+  "homepage": "https://visulima.com/packages/colorize/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -165,10 +165,10 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@visulima/is-ansi-color-supported": "3.0.0-alpha.1"
+    "@visulima/is-ansi-color-supported": "3.0.0-alpha.10"
   },
   "engines": {
-    "node": ">=22.13 <=25.x"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "os": [
     "darwin",

package/dist/packem_shared/convertHexToRgb-CWdAm2kE.mjs

@@ -1,13 +0,0 @@
-const convertHexToRgb = (hex) => {
-  let [, color] = /([a-f\d]{3,6})/i.exec(hex) ?? [];
-  const length_ = color ? color.length : 0;
-  if (length_ === 3) {
-    color = color[0] + color[0] + color[1] + color[1] + color[2] + color[2];
-  } else if (length_ !== 6) {
-    return [0, 0, 0];
-  }
-  const number_ = Number.parseInt(color, 16);
-  return [number_ >> 16 & 255, number_ >> 8 & 255, number_ & 255];
-};
-
-export { convertHexToRgb };

package/dist/packem_shared/convertHexToRgb-DvkHBM3-.cjs

@@ -1,17 +0,0 @@
-'use strict';
-
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-
-const convertHexToRgb = (hex) => {
-  let [, color] = /([a-f\d]{3,6})/i.exec(hex) ?? [];
-  const length_ = color ? color.length : 0;
-  if (length_ === 3) {
-    color = color[0] + color[0] + color[1] + color[1] + color[2] + color[2];
-  } else if (length_ !== 6) {
-    return [0, 0, 0];
-  }
-  const number_ = Number.parseInt(color, 16);
-  return [number_ >> 16 & 255, number_ >> 8 & 255, number_ & 255];
-};
-
-exports.convertHexToRgb = convertHexToRgb;