nhb-toolbox 4.20.16 → 4.20.20

package/CHANGELOG.md

@@ -6,6 +6,21 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.20.20] - 2025-09-04
+
+### 🎨 Updates for Stylog/LogStyler
+
+- **Reorganized** full `stylog` module.
+- **Renamed** `string()` method to `toANSI()` and `applyStyles()` to `toCSS()`.
+- **Added** new `ansi16()` method to apply `ANSI-16` color codes.
+- **Added** new `hsl()` and `bgHSL()` methods to colorize using custom `hsl` color values.
+- **Added** new `rgb()` and `bgRGB()` methods to colorize using custom `rgb` color values.
+- **Added** new `hex()` and `bgHex()` methods to colorize using custom `hex` color values.
+
+## [4.20.17] - 2025-09-02
+
+- **Added** _color support detector_ for shell/console for `Stylog`/`LogStyler`.
+
 ## [4.20.16] - 2025-09-01
 
 - **Added** new method `string()` in `LogStyler` (also in `Stylog`) and **made** `applyStyles()` method _public_.

package/dist/cjs/utils/constants.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSS_16_COLORS = exports.ANSI_16_COLORS = exports.CSS_TEXT_STYLES = exports.ANSI_TEXT_STYLES = void 0;
+/** ANSI styles for non-color text effects */
+exports.ANSI_TEXT_STYLES = Object.freeze({
+    bold: ['\x1b[1m', '\x1b[22m'],
+    bolder: ['\x1b[1m', '\x1b[22m'],
+    dim: ['\x1b[2m', '\x1b[22m'],
+    italic: ['\x1b[3m', '\x1b[23m'],
+    underline: ['\x1b[4m', '\x1b[24m'],
+    strikethrough: ['\x1b[9m', '\x1b[29m'],
+    inverse: ['\x1b[7m', '\x1b[27m'],
+});
+/** Browser CSS equivalents */
+exports.CSS_TEXT_STYLES = Object.freeze({
+    bold: 'font-weight: bold',
+    bolder: 'font-weight: bolder',
+    dim: 'opacity: 0.7',
+    italic: 'font-style: italic',
+    underline: 'text-decoration: underline',
+    strikethrough: 'text-decoration: line-through',
+    inverse: 'filter: invert(1)',
+});
+/** Records of ANSI-16 colors with values */
+exports.ANSI_16_COLORS = Object.freeze({
+    // Foreground Colors
+    black: [30, 39],
+    red: [31, 39],
+    green: [32, 39],
+    yellow: [33, 39],
+    blue: [34, 39],
+    purple: [35, 39],
+    cyan: [36, 39],
+    white: [37, 39],
+    // Bright Foreground Colors
+    blackBright: [90, 39],
+    redBright: [91, 39],
+    greenBright: [92, 39],
+    yellowBright: [93, 39],
+    blueBright: [94, 39],
+    purpleBright: [95, 39],
+    cyanBright: [96, 39],
+    whiteBright: [97, 39],
+    // Background Colors
+    bgBlack: [40, 49],
+    bgRed: [41, 49],
+    bgGreen: [42, 49],
+    bgYellow: [43, 49],
+    bgBlue: [44, 49],
+    bgPurple: [45, 49],
+    bgCyan: [46, 49],
+    bgWhite: [47, 49],
+    // Bright Background Colors
+    bgBlackBright: [100, 49],
+    bgRedBright: [101, 49],
+    bgGreenBright: [102, 49],
+    bgYellowBright: [103, 49],
+    bgBlueBright: [104, 49],
+    bgPurpleBright: [105, 49],
+    bgCyanBright: [106, 49],
+    bgWhiteBright: [107, 49],
+});
+/** Browser CSS equivalents for ANSI 16 colors */
+exports.CSS_16_COLORS = Object.freeze({
+    // Foreground Colors
+    black: '#000000',
+    red: '#800000',
+    green: '#008000',
+    yellow: '#808000',
+    blue: '#000080',
+    purple: '#800080',
+    cyan: '#008080',
+    white: '#c0c0c0',
+    // Bright Foreground Colors
+    blackBright: '#808080',
+    redBright: '#ff0000',
+    greenBright: '#00ff00',
+    yellowBright: '#ffff00',
+    blueBright: '#0000ff',
+    purpleBright: '#ff00ff',
+    cyanBright: '#00ffff',
+    whiteBright: '#ffffff',
+    // Background Colors
+    bgBlack: '#000000',
+    bgRed: '#800000',
+    bgGreen: '#008000',
+    bgYellow: '#808000',
+    bgBlue: '#000080',
+    bgPurple: '#800080',
+    bgCyan: '#008080',
+    bgWhite: '#c0c0c0',
+    // Bright Background Colors
+    bgBlackBright: '#808080',
+    bgRedBright: '#ff0000',
+    bgGreenBright: '#00ff00',
+    bgYellowBright: '#ffff00',
+    bgBlueBright: '#0000ff',
+    bgPurpleBright: '#ff00ff',
+    bgCyanBright: '#00ffff',
+    bgWhiteBright: '#ffffff',
+});

package/dist/cjs/utils/helpers.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._extractColorName = _extractColorName;
+exports._isAnsiSequence = _isAnsiSequence;
+exports._isAnsi16ColorValue = _isAnsi16ColorValue;
+exports._isCSS16Color = _isCSS16Color;
+exports._css16ToHex = _css16ToHex;
+const non_primitives_1 = require("../guards/non-primitives");
+const primitives_1 = require("../guards/primitives");
+const constants_1 = require("./constants");
+/**
+ * * Extract the CSS color name from a background-prefixed style key.
+ *
+ * @param bgColor Style key starting with `bg` (e.g. `"bgRed"`).
+ * @returns Extracted CSS color name.
+ */
+function _extractColorName(bgColor) {
+    return bgColor.slice(2).toLowerCase();
+}
+/** * Check if a string represents a valid `AnsiSequence`. */
+function _isAnsiSequence(seq) {
+    return ((0, non_primitives_1.isArrayOfType)(seq, primitives_1.isString) &&
+        seq?.length === 2 &&
+        (seq[0].startsWith('\x1b[48') || seq[0].startsWith('\x1b[38')) &&
+        (seq[1].startsWith('\x1b[49') || seq[1].startsWith('\x1b[39')));
+}
+/** * Check if a value represents a valid `Ansi16Value`. */
+function _isAnsi16ColorValue(value) {
+    return ((0, non_primitives_1.isArrayOfType)(value, primitives_1.isNumber) &&
+        value?.length === 2 &&
+        value[0] >= 30 &&
+        value[0] <= 107 &&
+        (value[1] === 39 || value[1] === 49));
+}
+/** * Check if a value represents a valid `CSS16Color` against `Ansi16Value`. */
+function _isCSS16Color(value) {
+    return value?.startsWith('css-') && value?.replace('css-', '') in constants_1.CSS_16_COLORS;
+}
+/**
+ * * Convert a `CSS16Color` value in `Hex6` format
+ *
+ * @param value `CSS16Color` value to convert
+ * @returns Converted `CSS16Color` value in `Hex6` format
+ */
+function _css16ToHex(value) {
+    return constants_1.CSS_16_COLORS?.[value?.replace('css-', '')];
+}