nhb-toolbox 4.28.56 → 4.28.60

package/CHANGELOG.md

@@ -4,9 +4,20 @@
 
 All notable changes to the package will be documented here.
 
+## [4.28.60] - 2026-01-13
+
+- **Fixed** `Chronos.getZodiacSign` boundary handling to correctly wrap across year transitions for *zodiac presets*.
+- **Improved** zodiac resolution logic to ensure consistent results for early-January dates without altering existing zodiac presets.
+- **Updated** `ZodiacArray` and `ZodiacOptions` types to support custom zodiac definitions with *correctly inferred sign names*.
+
+## [4.28.57] - 2026-01-07
+
+- **Enhanced** `Color.isLightColor` with an *optional brightness threshold* for custom light/dark detection.
+- **Refined** `TSDoc` to *improve* **IDE IntelliSense** for selected methods in `Color` and `Stylog`.
+
 ## [4.28.56] - 2026-01-05
 
-- **Resolved** an *issue affecting the conversion of Gregorian date strings to Bangla dates*.
+- **Resolved** an *issue affecting the conversion of Gregorian date strings to Bangla dates* in `BanglaCalendar`.
 
 ## [4.28.54] - 2026-01-02
 

package/dist/cjs/colors/Color.js

@@ -18,17 +18,18 @@ class Color {
     hsla;
     constructor(color) {
         if (color) {
-            if (_a.isCSSColor(color)) {
-                const newColor = new _a(css_colors_1.CSS_COLORS[color?.trim()]);
-                this.hex = newColor.hex;
-                this.hex8 = newColor.hex8;
-                this.rgb = newColor.rgb;
-                this.rgba = newColor.rgba;
-                this.hsl = newColor.hsl;
-                this.hsla = newColor.hsla;
+            const $color = color.trim();
+            if (_a.isCSSColor($color)) {
+                const { hex, hex8, rgb, rgba, hsl, hsla } = new _a(css_colors_1.CSS_COLORS[$color]);
+                this.hex = hex;
+                this.hex8 = hex8;
+                this.rgb = rgb;
+                this.rgba = rgba;
+                this.hsl = hsl;
+                this.hsla = hsla;
             }
             else {
-                const colors = this.#convertColorToOthers(color?.trim());
+                const colors = this.#convertColorToOthers($color);
                 if ('hex8' in colors) {
                     const [r, g, b] = (0, utils_1.extractAlphaColorValues)(colors.rgba);
                     const [h, s, l] = (0, utils_1.extractAlphaColorValues)(colors.hsla);
@@ -40,28 +41,24 @@ class Color {
                     this.hsla = colors.hsla;
                 }
                 else {
-                    const [r, g, b] = (0, utils_1.extractSolidColorValues)(colors.rgb);
-                    const [h, s, l] = (0, utils_1.extractSolidColorValues)(colors.hsl);
                     this.hex = colors.hex.toUpperCase();
-                    this.hex8 = `${colors.hex.toUpperCase()}${(0, helpers_1._percentToHex)(100)}`;
+                    this.hex8 = this.#hex6ToHex8(colors.hex);
                     this.rgb = colors.rgb;
-                    this.rgba = `rgba(${r}, ${g}, ${b}, 1)`;
+                    this.rgba = this.#rgbToRGBA(colors.rgb);
                     this.hsl = colors.hsl;
-                    this.hsla = `hsla(${h}, ${s}%, ${l}%, 1)`;
+                    this.hsla = this.#hslToHSLA(colors.hsl);
                 }
             }
         }
         else {
             const hsl = (0, random_1.generateRandomHSLColor)();
             const { hex, rgb } = (0, convert_1.convertColorCode)(hsl);
-            const [r, g, b] = (0, utils_1.extractSolidColorValues)(rgb);
-            const [h, s, l] = (0, utils_1.extractSolidColorValues)(hsl);
             this.hex = hex.toUpperCase();
-            this.hex8 = `${hex.toUpperCase()}${(0, helpers_1._percentToHex)(100)}`;
+            this.hex8 = this.#hex6ToHex8(hex);
             this.rgb = rgb;
-            this.rgba = `rgba(${r}, ${g}, ${b}, 1)`;
+            this.rgba = this.#rgbToRGBA(rgb);
             this.hsl = hsl;
-            this.hsla = `hsla(${h}, ${s}%, ${l}%, 1)`;
+            this.hsla = this.#hslToHSLA(hsl);
         }
     }
     *[Symbol.iterator]() {
@@ -72,6 +69,17 @@ class Color {
         yield this.hsl;
         yield this.hsla;
     }
+    #hex6ToHex8(hex) {
+        return `${hex.toUpperCase()}${(0, helpers_1._percentToHex)(100)}`;
+    }
+    #rgbToRGBA(rgb) {
+        const [r, g, b] = (0, utils_1.extractSolidColorValues)(rgb);
+        return `rgba(${r}, ${g}, ${b}, 1)`;
+    }
+    #hslToHSLA(hsl) {
+        const [h, s, l] = (0, utils_1.extractSolidColorValues)(hsl);
+        return `hsla(${h}, ${s}%, ${l}%, 1)`;
+    }
     applyOpacity(opacity) {
         const hex8 = `${this.hex.slice(0, 7)}${(0, helpers_1._percentToHex)(opacity)}`.toUpperCase();
         return new _a(hex8);
@@ -168,10 +176,10 @@ class Color {
             return 'AA';
         return 'Fail';
     }
-    isLightColor() {
+    isLightColor(threshold = 127.5) {
         const [r, g, b] = (0, utils_1.extractSolidColorValues)(this.rgb);
         const brightness = (r * 299 + g * 587 + b * 114) / 1000;
-        return brightness > 127.5;
+        return brightness > Math.min(255, Math.max(0, threshold));
     }
     static isHex6(color) {
         return /^#[0-9A-Fa-f]{6}$/.test(color?.trim());

package/dist/cjs/date/constants.js

@@ -74,22 +74,20 @@ exports.WESTERN_ZODIAC_SIGNS = /* @__PURE__ */ Object.freeze([
     ['Libra', [9, 23]],
     ['Scorpio', [10, 23]],
     ['Sagittarius', [11, 22]],
-    ['Capricorn', [12, 22]],
 ]);
 exports.VEDIC_ZODIAC_SIGNS = /* @__PURE__ */ Object.freeze([
     ['Capricorn', [1, 14]],
     ['Aquarius', [2, 13]],
     ['Pisces', [3, 14]],
-    ['Aries', [4, 13]],
-    ['Taurus', [5, 14]],
-    ['Gemini', [6, 14]],
+    ['Aries', [4, 14]],
+    ['Taurus', [5, 15]],
+    ['Gemini', [6, 15]],
     ['Cancer', [7, 16]],
-    ['Leo', [8, 16]],
-    ['Virgo', [9, 16]],
-    ['Libra', [10, 16]],
-    ['Scorpio', [11, 15]],
-    ['Sagittarius', [12, 15]],
-    ['Capricorn', [1, 14]],
+    ['Leo', [8, 17]],
+    ['Virgo', [9, 17]],
+    ['Libra', [10, 17]],
+    ['Scorpio', [11, 16]],
+    ['Sagittarius', [12, 16]],
 ]);
 exports.ZODIAC_PRESETS = /* @__PURE__ */ Object.freeze({
     western: exports.WESTERN_ZODIAC_SIGNS,

package/dist/cjs/date/plugins/zodiacPlugin.js

@@ -14,12 +14,18 @@ const zodiacPlugin = ($Chronos) => {
             month = this.isoMonth;
             date = this.date;
         }
-        const signs = [...(custom ?? constants_1.ZODIAC_PRESETS[preset])].sort((a, b) => a[1][0] * 100 + a[1][1] - (b[1][0] * 100 + b[1][1]));
+        const _toHundreds = (range) => {
+            return range[0] * 100 + range[1];
+        };
+        const signs = [...(custom ?? constants_1.ZODIAC_PRESETS[preset])].sort((a, b) => _toHundreds(a[1]) - _toHundreds(b[1]));
         for (let i = signs.length - 1; i >= 0; i--) {
             const [sign, [m, d]] = signs[i];
             if (month > m || (month === m && date >= d)) {
                 return sign;
             }
+            if (i === 0) {
+                return signs.at(-1)[0];
+            }
         }
         return signs[0][0];
     };

package/dist/dts/colors/Color.d.ts

@@ -266,9 +266,11 @@ export declare class Color {
     getWCAGRating(other: ColorType | CSSColor): 'Fail' | 'AA' | 'AAA';
     /**
      * @instance Determines if the color is light based on its perceived brightness.
+     * @param threshold Optional brightness threshold (`0–255`). Defaults to `127.5`.
+     * @remarks The brightness {@link threshold} is clamped to the valid *RGB range* (`0–255`) to prevent invalid comparisons.
      * @returns `true` if light, `false` if dark.
      */
-    isLightColor(): boolean;
+    isLightColor(threshold?: number): boolean;
     /**
      * @static Checks if a color is in {@link Hex6} format.
      *

package/dist/dts/colors/types.d.ts

@@ -14,7 +14,7 @@ export type Hex = `#${string}`;
  * * Represents a hexadecimal color code.
  * * Format: `#3C6945`
  */
-export type Hex6 = Branded<`#${string}`, 'Hex6'>;
+export type Hex6 = Branded<Hex, 'Hex6'>;
 /**
  * * Represents an RGB color string.
  * * Format: `rgb(R, G, B)`
@@ -37,7 +37,7 @@ export type HSL = `hsl(${number}, ${number}%, ${number}%)` | `hsl(${number},${nu
  * * Represents a hexadecimal color code with optional alpha channel.
  * * Format: `#3C6945FF`
  */
-export type Hex8 = Branded<`#${string}`, 'Hex8'>;
+export type Hex8 = Branded<Hex, 'Hex8'>;
 /**
  * * Represents an RGBA color string, now includes optional alpha (opacity).
  * * Format: `rgba(R, G, B, A)`

package/dist/dts/date/constants.d.ts

@@ -21,15 +21,15 @@ export declare const SORTED_TIME_FORMATS: readonly ("MM" | "SS" | "ms" | "DD" |
 /** Ranges for day parts. */
 export declare const DATE_PART_RANGES: Readonly<Record<DayPart, [ClockHour, ClockHour]>>;
 /** Western Zodiac Signs */
-export declare const WESTERN_ZODIAC_SIGNS: readonly [readonly ["Capricorn", readonly [12, 22]], readonly ["Aquarius", readonly [1, 20]], readonly ["Pisces", readonly [2, 19]], readonly ["Aries", readonly [3, 21]], readonly ["Taurus", readonly [4, 20]], readonly ["Gemini", readonly [5, 21]], readonly ["Cancer", readonly [6, 21]], readonly ["Leo", readonly [7, 23]], readonly ["Virgo", readonly [8, 23]], readonly ["Libra", readonly [9, 23]], readonly ["Scorpio", readonly [10, 23]], readonly ["Sagittarius", readonly [11, 22]], readonly ["Capricorn", readonly [12, 22]]];
+export declare const WESTERN_ZODIAC_SIGNS: readonly [readonly ["Capricorn", readonly [12, 22]], readonly ["Aquarius", readonly [1, 20]], readonly ["Pisces", readonly [2, 19]], readonly ["Aries", readonly [3, 21]], readonly ["Taurus", readonly [4, 20]], readonly ["Gemini", readonly [5, 21]], readonly ["Cancer", readonly [6, 21]], readonly ["Leo", readonly [7, 23]], readonly ["Virgo", readonly [8, 23]], readonly ["Libra", readonly [9, 23]], readonly ["Scorpio", readonly [10, 23]], readonly ["Sagittarius", readonly [11, 22]]];
 /** Vedic Zodiac Sign */
-export declare const VEDIC_ZODIAC_SIGNS: readonly [readonly ["Capricorn", readonly [1, 14]], readonly ["Aquarius", readonly [2, 13]], readonly ["Pisces", readonly [3, 14]], readonly ["Aries", readonly [4, 13]], readonly ["Taurus", readonly [5, 14]], readonly ["Gemini", readonly [6, 14]], readonly ["Cancer", readonly [7, 16]], readonly ["Leo", readonly [8, 16]], readonly ["Virgo", readonly [9, 16]], readonly ["Libra", readonly [10, 16]], readonly ["Scorpio", readonly [11, 15]], readonly ["Sagittarius", readonly [12, 15]], readonly ["Capricorn", readonly [1, 14]]];
+export declare const VEDIC_ZODIAC_SIGNS: readonly [readonly ["Capricorn", readonly [1, 14]], readonly ["Aquarius", readonly [2, 13]], readonly ["Pisces", readonly [3, 14]], readonly ["Aries", readonly [4, 14]], readonly ["Taurus", readonly [5, 15]], readonly ["Gemini", readonly [6, 15]], readonly ["Cancer", readonly [7, 16]], readonly ["Leo", readonly [8, 17]], readonly ["Virgo", readonly [9, 17]], readonly ["Libra", readonly [10, 17]], readonly ["Scorpio", readonly [11, 16]], readonly ["Sagittarius", readonly [12, 16]]];
 /** Zodiac Signs Presets */
 export declare const ZODIAC_PRESETS: Readonly<{
-    readonly western: readonly [readonly ["Capricorn", readonly [12, 22]], readonly ["Aquarius", readonly [1, 20]], readonly ["Pisces", readonly [2, 19]], readonly ["Aries", readonly [3, 21]], readonly ["Taurus", readonly [4, 20]], readonly ["Gemini", readonly [5, 21]], readonly ["Cancer", readonly [6, 21]], readonly ["Leo", readonly [7, 23]], readonly ["Virgo", readonly [8, 23]], readonly ["Libra", readonly [9, 23]], readonly ["Scorpio", readonly [10, 23]], readonly ["Sagittarius", readonly [11, 22]], readonly ["Capricorn", readonly [12, 22]]];
-    readonly vedic: readonly [readonly ["Capricorn", readonly [1, 14]], readonly ["Aquarius", readonly [2, 13]], readonly ["Pisces", readonly [3, 14]], readonly ["Aries", readonly [4, 13]], readonly ["Taurus", readonly [5, 14]], readonly ["Gemini", readonly [6, 14]], readonly ["Cancer", readonly [7, 16]], readonly ["Leo", readonly [8, 16]], readonly ["Virgo", readonly [9, 16]], readonly ["Libra", readonly [10, 16]], readonly ["Scorpio", readonly [11, 15]], readonly ["Sagittarius", readonly [12, 15]], readonly ["Capricorn", readonly [1, 14]]];
-    readonly tropical: readonly [readonly ["Capricorn", readonly [12, 22]], readonly ["Aquarius", readonly [1, 20]], readonly ["Pisces", readonly [2, 19]], readonly ["Aries", readonly [3, 21]], readonly ["Taurus", readonly [4, 20]], readonly ["Gemini", readonly [5, 21]], readonly ["Cancer", readonly [6, 21]], readonly ["Leo", readonly [7, 23]], readonly ["Virgo", readonly [8, 23]], readonly ["Libra", readonly [9, 23]], readonly ["Scorpio", readonly [10, 23]], readonly ["Sagittarius", readonly [11, 22]], readonly ["Capricorn", readonly [12, 22]]];
-    readonly sidereal: readonly [readonly ["Capricorn", readonly [1, 14]], readonly ["Aquarius", readonly [2, 13]], readonly ["Pisces", readonly [3, 14]], readonly ["Aries", readonly [4, 13]], readonly ["Taurus", readonly [5, 14]], readonly ["Gemini", readonly [6, 14]], readonly ["Cancer", readonly [7, 16]], readonly ["Leo", readonly [8, 16]], readonly ["Virgo", readonly [9, 16]], readonly ["Libra", readonly [10, 16]], readonly ["Scorpio", readonly [11, 15]], readonly ["Sagittarius", readonly [12, 15]], readonly ["Capricorn", readonly [1, 14]]];
+    readonly western: readonly [readonly ["Capricorn", readonly [12, 22]], readonly ["Aquarius", readonly [1, 20]], readonly ["Pisces", readonly [2, 19]], readonly ["Aries", readonly [3, 21]], readonly ["Taurus", readonly [4, 20]], readonly ["Gemini", readonly [5, 21]], readonly ["Cancer", readonly [6, 21]], readonly ["Leo", readonly [7, 23]], readonly ["Virgo", readonly [8, 23]], readonly ["Libra", readonly [9, 23]], readonly ["Scorpio", readonly [10, 23]], readonly ["Sagittarius", readonly [11, 22]]];
+    readonly vedic: readonly [readonly ["Capricorn", readonly [1, 14]], readonly ["Aquarius", readonly [2, 13]], readonly ["Pisces", readonly [3, 14]], readonly ["Aries", readonly [4, 14]], readonly ["Taurus", readonly [5, 15]], readonly ["Gemini", readonly [6, 15]], readonly ["Cancer", readonly [7, 16]], readonly ["Leo", readonly [8, 17]], readonly ["Virgo", readonly [9, 17]], readonly ["Libra", readonly [10, 17]], readonly ["Scorpio", readonly [11, 16]], readonly ["Sagittarius", readonly [12, 16]]];
+    readonly tropical: readonly [readonly ["Capricorn", readonly [12, 22]], readonly ["Aquarius", readonly [1, 20]], readonly ["Pisces", readonly [2, 19]], readonly ["Aries", readonly [3, 21]], readonly ["Taurus", readonly [4, 20]], readonly ["Gemini", readonly [5, 21]], readonly ["Cancer", readonly [6, 21]], readonly ["Leo", readonly [7, 23]], readonly ["Virgo", readonly [8, 23]], readonly ["Libra", readonly [9, 23]], readonly ["Scorpio", readonly [10, 23]], readonly ["Sagittarius", readonly [11, 22]]];
+    readonly sidereal: readonly [readonly ["Capricorn", readonly [1, 14]], readonly ["Aquarius", readonly [2, 13]], readonly ["Pisces", readonly [3, 14]], readonly ["Aries", readonly [4, 14]], readonly ["Taurus", readonly [5, 15]], readonly ["Gemini", readonly [6, 15]], readonly ["Cancer", readonly [7, 16]], readonly ["Leo", readonly [8, 17]], readonly ["Virgo", readonly [9, 17]], readonly ["Libra", readonly [10, 17]], readonly ["Scorpio", readonly [11, 16]], readonly ["Sagittarius", readonly [12, 16]]];
 }>;
 /** Variants of different time units */
 export declare const TIME_UNIT_VARIANTS: Readonly<{

package/dist/dts/date/plugins/zodiacPlugin.d.ts

@@ -6,7 +6,7 @@ declare module '../Chronos' {
          * @param options Optional config to choose preset or provide custom zodiac date ranges.
          * @returns The matching zodiac sign from preset/custom list.
          */
-        getZodiacSign(options?: ZodiacOptions): ZodiacSign;
+        getZodiacSign<Sign extends string = ZodiacSign>(options?: ZodiacOptions<Sign>): Sign;
         /**
          * @instance Returns the zodiac sign based on current date or `birthDate` option.
          * @remarks This method is an alias for {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/names#getzodiacsign getZodiacSign} method.
@@ -14,8 +14,8 @@ declare module '../Chronos' {
          * @param options Optional config to choose preset or provide custom zodiac date ranges.
          * @returns The matching zodiac sign from preset/custom list.
          */
-        zodiac(options?: ZodiacOptions): ZodiacSign;
+        zodiac<Sign extends string = ZodiacSign>(options?: ZodiacOptions<Sign>): Sign;
     }
 }
-/** * Plugin to inject `getZodiacSign`/`zodiac` method */
+/** * Plugin to inject `zodiac` related methods */
 export declare const zodiacPlugin: ($Chronos: $Chronos) => void;

package/dist/dts/date/types.d.ts

@@ -304,20 +304,20 @@ export type DayPartConfig = Record<DayPart, [ClockHour, ClockHour]>;
 export type Quarter = 1 | 2 | 3 | 4;
 /** Academic year, e.g. `2024-2025` */
 export type AcademicYear = `${number}-${number}`;
-/** Names of Zodiac signs */
+/** Names of standard Zodiac signs */
 export type ZodiacSign = (typeof WESTERN_ZODIAC_SIGNS)[number][0];
 /** Presets for Zodiac Sign Configuration */
 export type ZodiacPreset = keyof typeof ZODIAC_PRESETS;
 /** Shape of Zodiac signs array */
-export type ZodiacArray = Array<[ZodiacSign, [NumberRange<1, 12>, NumberRange<1, 31>]]>;
+export type ZodiacArray<Sign extends string = ZodiacSign> = Array<[Sign, [NumberRange<1, 12>, NumberRange<1, 31>]] | Readonly<[Sign, Readonly<[NumberRange<1, 12>, NumberRange<1, 31>]>]>>;
 /** Options for configuring Zodiac sign getter */
-export interface ZodiacOptions {
+export interface ZodiacOptions<Sign extends string = ZodiacSign> {
     /** - Optional birthdate in `MM-DD` format (1-based month). */
     birthDate?: MonthDateString;
     /** Optional Zodiac preset to use. Default is `western`. `western` and `tropical`, `vedic` and `sidereal` are same. */
     preset?: ZodiacPreset;
-    /** Custom Zodiac date ranges. */
-    custom?: ZodiacArray;
+    /** Custom Zodiac date ranges. Overrides presets. */
+    custom?: ZodiacArray<Sign> | Readonly<ZodiacArray<Sign>>;
 }
 /** - Represents the full name of a weekday, e.g., 'Monday', 'Tuesday' etc. */
 export type WeekDay = (typeof DAYS)[number];

package/dist/dts/stylog/Stylog.d.ts

@@ -17,12 +17,11 @@ export type AnsiSequence = [string, string];
 /**
  * * Type representing a fully chainable `LogStyler` instance.
  *
- * @remarks - Each property corresponds to a style (foreground color, background color, or text effect) and returns a new `Stylog` instance, allowing fluent chaining like:
- *
- * **This type combines:**
- * - The methods of `LogStyler` (e.g., `.style()`, `.log()`)
- * - Dynamically generated properties for all available `Styles`
- *   that return another `Stylog` instance for chaining.
+ * @remarks
+ * - Each property corresponds to a style and returns a new `Stylog` instance, allowing fluent chaining.
+ * - **This type combines:**
+ *   - The methods of `LogStyler` (e.g., `.style()`, `.log()`)
+ *   - Dynamically generated properties for all available `Styles` that return another `Stylog` instance for chaining.
  *
  * @example
  * Stylog.green.bold.bgBlue.log('Hello World');
@@ -229,7 +228,7 @@ export declare class LogStyler {
     /**
      * * Apply a HEX color to the text foreground.
      *
-     * @param code - HEX color string (e.g., '#4682B4' or '4682B4').
+     * @param code - HEX color string (e.g., `'#4682B4'` or `'4682B4'`).
      * @returns A new `StylogChain` instance with the HEX color applied.
      *
      * @example
@@ -254,7 +253,7 @@ export declare class LogStyler {
     /**
      * * Apply a HEX color to the text background.
      *
-     * @param code - HEX color string (e.g., '#4682B4' or '4682B4').
+     * @param code - HEX color string (e.g., `'#4682B4'` or `'4682B4'`).
      * @returns A new StylogChain instance with the HEX background color applied.
      *
      * @example
@@ -279,7 +278,7 @@ export declare class LogStyler {
     /**
      * * Apply an RGB color to the text foreground using a CSS-like string.
      *
-     * @param code - RGB color string (e.g., 'rgb(11, 45, 1)' or '11, 45, 1').
+     * @param code - RGB color string (e.g., `'rgb(11, 45, 1)'` or `'11, 45, 1'`).
      * @returns A new `StylogChain` instance with the RGB color applied.
      *
      * @example
@@ -325,7 +324,7 @@ export declare class LogStyler {
     /**
      * * Apply an RGB color to the text background using a CSS-like string.
      *
-     * @param code - RGB color string (e.g., 'rgb(225, 169, 196)' or '225, 169, 196').
+     * @param code - RGB color string (e.g., `'rgb(225, 169, 196)'` or `'225, 169, 196'`).
      * @returns A new `StylogChain` instance with the RGB background color applied.
      *
      * @example
@@ -371,7 +370,7 @@ export declare class LogStyler {
     /**
      * * Apply an HSL color to the text foreground using a CSS-like string.
      *
-     * @param code - HSL color string (e.g., 'hsl(50 80.5% 40%)').
+     * @param code - HSL color string (e.g., `'hsl(50 80.5% 40%)'`).
      * @returns A new `StylogChain` instance with the HSL color applied.
      *
      * @example
@@ -396,9 +395,9 @@ export declare class LogStyler {
     /**
      * * Apply an HSL color to the text foreground using individual components.
      *
-     * @param hue - Hue component (0-360).
-     * @param saturation - Saturation component (0-100 or 0-100%).
-     * @param lightness - Lightness component (0-100 or 0-100%).
+     * @param hue - Hue component (`0-360`).
+     * @param saturation - Saturation component (`0-100`).
+     * @param lightness - Lightness component (`0-100`).
      * @returns A new `StylogChain` instance with the HSL color applied.
      *
      * @example
@@ -417,7 +416,7 @@ export declare class LogStyler {
     /**
      * * Apply an HSL color to the text background using a CSS-like string.
      *
-     * @param code - HSL color string (e.g., 'hsl(50 80.5% 40%)').
+     * @param code - HSL color string (e.g., `'hsl(50 80.5% 40%)'`).
      * @returns A new `StylogChain` instance with the HSL background color applied.
      *
      * @example
@@ -442,9 +441,9 @@ export declare class LogStyler {
     /**
      * * Apply an HSL color to the text background using individual components.
      *
-     * @param hue - Hue component (0-360).
-     * @param saturation - Saturation component (0-100 or 0-100%).
-     * @param lightness - Lightness component (0-100 or 0-100%).
+     * @param hue - Hue component (`0-360`).
+     * @param saturation - Saturation component (`0-100`).
+     * @param lightness - Lightness component (`0-100`).
      * @returns A new StylogChain instance with the HSL background color applied.
      *
      * @example

package/dist/esm/colors/Color.js

@@ -15,17 +15,18 @@ export class Color {
     hsla;
     constructor(color) {
         if (color) {
-            if (_a.isCSSColor(color)) {
-                const newColor = new _a(CSS_COLORS[color?.trim()]);
-                this.hex = newColor.hex;
-                this.hex8 = newColor.hex8;
-                this.rgb = newColor.rgb;
-                this.rgba = newColor.rgba;
-                this.hsl = newColor.hsl;
-                this.hsla = newColor.hsla;
+            const $color = color.trim();
+            if (_a.isCSSColor($color)) {
+                const { hex, hex8, rgb, rgba, hsl, hsla } = new _a(CSS_COLORS[$color]);
+                this.hex = hex;
+                this.hex8 = hex8;
+                this.rgb = rgb;
+                this.rgba = rgba;
+                this.hsl = hsl;
+                this.hsla = hsla;
             }
             else {
-                const colors = this.#convertColorToOthers(color?.trim());
+                const colors = this.#convertColorToOthers($color);
                 if ('hex8' in colors) {
                     const [r, g, b] = extractAlphaColorValues(colors.rgba);
                     const [h, s, l] = extractAlphaColorValues(colors.hsla);
@@ -37,28 +38,24 @@ export class Color {
                     this.hsla = colors.hsla;
                 }
                 else {
-                    const [r, g, b] = extractSolidColorValues(colors.rgb);
-                    const [h, s, l] = extractSolidColorValues(colors.hsl);
                     this.hex = colors.hex.toUpperCase();
-                    this.hex8 = `${colors.hex.toUpperCase()}${_percentToHex(100)}`;
+                    this.hex8 = this.#hex6ToHex8(colors.hex);
                     this.rgb = colors.rgb;
-                    this.rgba = `rgba(${r}, ${g}, ${b}, 1)`;
+                    this.rgba = this.#rgbToRGBA(colors.rgb);
                     this.hsl = colors.hsl;
-                    this.hsla = `hsla(${h}, ${s}%, ${l}%, 1)`;
+                    this.hsla = this.#hslToHSLA(colors.hsl);
                 }
             }
         }
         else {
             const hsl = generateRandomHSLColor();
             const { hex, rgb } = convertColorCode(hsl);
-            const [r, g, b] = extractSolidColorValues(rgb);
-            const [h, s, l] = extractSolidColorValues(hsl);
             this.hex = hex.toUpperCase();
-            this.hex8 = `${hex.toUpperCase()}${_percentToHex(100)}`;
+            this.hex8 = this.#hex6ToHex8(hex);
             this.rgb = rgb;
-            this.rgba = `rgba(${r}, ${g}, ${b}, 1)`;
+            this.rgba = this.#rgbToRGBA(rgb);
             this.hsl = hsl;
-            this.hsla = `hsla(${h}, ${s}%, ${l}%, 1)`;
+            this.hsla = this.#hslToHSLA(hsl);
         }
     }
     *[Symbol.iterator]() {
@@ -69,6 +66,17 @@ export class Color {
         yield this.hsl;
         yield this.hsla;
     }
+    #hex6ToHex8(hex) {
+        return `${hex.toUpperCase()}${_percentToHex(100)}`;
+    }
+    #rgbToRGBA(rgb) {
+        const [r, g, b] = extractSolidColorValues(rgb);
+        return `rgba(${r}, ${g}, ${b}, 1)`;
+    }
+    #hslToHSLA(hsl) {
+        const [h, s, l] = extractSolidColorValues(hsl);
+        return `hsla(${h}, ${s}%, ${l}%, 1)`;
+    }
     applyOpacity(opacity) {
         const hex8 = `${this.hex.slice(0, 7)}${_percentToHex(opacity)}`.toUpperCase();
         return new _a(hex8);
@@ -165,10 +173,10 @@ export class Color {
             return 'AA';
         return 'Fail';
     }
-    isLightColor() {
+    isLightColor(threshold = 127.5) {
         const [r, g, b] = extractSolidColorValues(this.rgb);
         const brightness = (r * 299 + g * 587 + b * 114) / 1000;
-        return brightness > 127.5;
+        return brightness > Math.min(255, Math.max(0, threshold));
     }
     static isHex6(color) {
         return /^#[0-9A-Fa-f]{6}$/.test(color?.trim());

package/dist/esm/date/constants.js

@@ -71,22 +71,20 @@ export const WESTERN_ZODIAC_SIGNS = /* @__PURE__ */ Object.freeze([
     ['Libra', [9, 23]],
     ['Scorpio', [10, 23]],
     ['Sagittarius', [11, 22]],
-    ['Capricorn', [12, 22]],
 ]);
 export const VEDIC_ZODIAC_SIGNS = /* @__PURE__ */ Object.freeze([
     ['Capricorn', [1, 14]],
     ['Aquarius', [2, 13]],
     ['Pisces', [3, 14]],
-    ['Aries', [4, 13]],
-    ['Taurus', [5, 14]],
-    ['Gemini', [6, 14]],
+    ['Aries', [4, 14]],
+    ['Taurus', [5, 15]],
+    ['Gemini', [6, 15]],
     ['Cancer', [7, 16]],
-    ['Leo', [8, 16]],
-    ['Virgo', [9, 16]],
-    ['Libra', [10, 16]],
-    ['Scorpio', [11, 15]],
-    ['Sagittarius', [12, 15]],
-    ['Capricorn', [1, 14]],
+    ['Leo', [8, 17]],
+    ['Virgo', [9, 17]],
+    ['Libra', [10, 17]],
+    ['Scorpio', [11, 16]],
+    ['Sagittarius', [12, 16]],
 ]);
 export const ZODIAC_PRESETS = /* @__PURE__ */ Object.freeze({
     western: WESTERN_ZODIAC_SIGNS,

package/dist/esm/date/plugins/zodiacPlugin.js

@@ -11,12 +11,18 @@ export const zodiacPlugin = ($Chronos) => {
             month = this.isoMonth;
             date = this.date;
         }
-        const signs = [...(custom ?? ZODIAC_PRESETS[preset])].sort((a, b) => a[1][0] * 100 + a[1][1] - (b[1][0] * 100 + b[1][1]));
+        const _toHundreds = (range) => {
+            return range[0] * 100 + range[1];
+        };
+        const signs = [...(custom ?? ZODIAC_PRESETS[preset])].sort((a, b) => _toHundreds(a[1]) - _toHundreds(b[1]));
         for (let i = signs.length - 1; i >= 0; i--) {
             const [sign, [m, d]] = signs[i];
             if (month > m || (month === m && date >= d)) {
                 return sign;
             }
+            if (i === 0) {
+                return signs.at(-1)[0];
+            }
         }
         return signs[0][0];
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.56",
+  "version": "4.28.60",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -46,9 +46,9 @@
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.51.0",
-    "@typescript-eslint/parser": "^8.51.0",
+    "@types/node": "^25.0.6",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -60,7 +60,7 @@
     "prettier": "^3.7.4",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.51.0"
+    "typescript-eslint": "^8.53.0"
   },
   "keywords": [
     "toolbox",