nhb-toolbox 4.28.54 → 4.28.57

package/CHANGELOG.md

@@ -4,6 +4,15 @@
 
 All notable changes to the package will be documented here.
 
+## [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* in `BanglaCalendar`.
+
 ## [4.28.54] - 2026-01-02
 
 - **Optimized** `Color.applyOpacity` and **updated** its behavior to return a *new* `Color` instance instead of mutating the original.

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/BanglaCalendar.js

@@ -212,7 +212,7 @@ class BanglaCalendar {
         return (0, helpers_1._formatDateCore)(format || 'ddd, DD mmmm (SS), YYYY বঙ্গাব্দ', dateComponents);
     }
     #processGregYear(bnYear, bnMonth) {
-        const baseGregYear = bnYear ?? this.year.en + constants_1.BN_YEAR_OFFSET;
+        const baseGregYear = (bnYear ?? this.year.en) + constants_1.BN_YEAR_OFFSET;
         const gregYear = (bnMonth ?? this.month.en) > 10 ? baseGregYear + 1 : baseGregYear;
         return { baseGregYear, gregYear };
     }

package/dist/dts/array/Finder.d.ts

@@ -3,8 +3,8 @@ import type { Maybe, OwnKeys } from '../types/index';
 import type { FindOptions } from './types';
 type KeySelector<T> = Extract<OwnKeys<T>, string | number> | ((item: T) => string | number);
 /**
- * The `Finder` class performs optimized searching on arrays.
- * It supports binary search, fuzzy search, and smart caching with TTL.
+ * @class `Finder` performs optimized searching on arrays.
+ *      - It supports binary search, fuzzy search, and smart caching with TTL.
  */
 export declare class Finder<T extends GenericObject> {
     #private;

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

@@ -1,7 +1,7 @@
 import type { Percent } from '../number/types';
 import type { Analogous, ColorType, CSSColor, Hex6, Hex8, HSL, HSLA, RGB, RGBA, Tetrad, Triad } from './types';
 /**
- * * Represents a color in {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA} formats.
+ * @class Represents a color in {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA} formats.
  *
  * @remarks
  * - Instance methods allow transforming, adjusting, and deriving new colors.
@@ -85,12 +85,12 @@ export declare class Color {
      */
     constructor(color: ColorType);
     /**
-     * * Creates a new `Color` instance using a standard (CSS) named color and automatically converts it to all other supported formats: `Hex`, `Hex8`, `RGB`, `RGBA`, `HSL`, and `HSLA`.
+     * * Creates a new `Color` instance using a standard (CSS) named color and automatically converts it to all other supported formats: {@link Hex6 Hex}, {@link Hex8}, {@link RGB}, {@link RGBA}, {@link HSL}, and {@link HSLA}.
      *
      * @description
-     * This allows you to use any valid named color from standard `150+ `CSS color names (e.g., `"red"`, `"blue"`, `"rebeccapurple"`)
+     * This allows you to use any valid named color from standard `150+` CSS color names (e.g., `"red"`, `"blue"`, `"rebeccapurple"`)
      *
-     * @param color - A named color string from standard `150+ `CSS color names ({@link CSSColor}).
+     * @param color - A named color string from standard `150+` CSS color names ({@link CSSColor}).
      *
      * @remarks
      * - Instance methods allow transforming, adjusting, and deriving new colors.
@@ -124,7 +124,7 @@ export declare class Color {
      * - Instance methods allow transforming, adjusting, and deriving new colors.
      * - Static methods provide format validation and type-guard–style checks for supported color representations.
      *
-     * @param color - An optional input color string in any supported format (`Hex`, `Hex8`, `RGB`, `RGBA`, `HSL`, or `HSLA`) or a named color string from standard `150+ `CSS color names ({@link CSSColor}) to convert in all other (includes the current format) formats.
+     * @param color - An optional input color string in any supported format (`Hex`, `Hex8`, `RGB`, `RGBA`, `HSL`, or `HSLA`) or a named color string from standard `150+` CSS color names ({@link CSSColor}) to convert in all other (includes the current format) formats.
      *
      * @example
      * // Convert an existing Hex color to all other formats
@@ -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/BanglaCalendar.d.ts

@@ -1,10 +1,9 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { $BnEn, BanglaDate, BanglaDateFormat, BanglaDayName, BanglaMonth, BanglaMonthName, BanglaSeasonName, BanglaYear, BnCalendarConfig, BnCalendarVariant } from './types';
 /**
- * * Represents a date in the Bangla calendar system with support for different variants.
- *
- * - This class provides functionality to create, manipulate, and convert dates between the Bangla and Gregorian calendar systems.
- * - It supports two calendar variants: `'revised-2019'` (default) and `'revised-1966'`.
+ * @class Represents a date in the Bangla calendar system with support for different variants.
+ *      - This class provides functionality to create, manipulate, convert dates between the Bangla and Gregorian calendar systems.
+ *      - It supports two Bangla calendar variants: `'revised-2019'` (default) and `'revised-1966'`.
  *
  * @example
  * // Create from current date

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

@@ -3,10 +3,9 @@ import type { LooseLiteral, TupleOf } from '../utils/types';
 import { INTERNALS } from './constants';
 import type { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeOnlyFormat, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
 /**
- * * Creates a new immutable `Chronos` instance.
- *
- * **Note**:
- * - *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC and convert it to the **equivalent local time** using the current environment's UTC offset.*
+ * @class Creates a new immutable `Chronos` instance.
+ *      - **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
+ *        and convert it to the **equivalent local time** using the current environment's UTC offset.*
  *
  * @param value - A date value (`number`, `string`, `Date`, or `Chronos` object).
  *

package/dist/dts/hash/Cipher.d.ts

@@ -1,6 +1,6 @@
 /**
- * * Lightweight stream-cipher–style encryption utility using `HMAC-SHA256` for keystream generation and authentication.
- *   - The class derives separate encryption and MAC keys from the provided secret.
+ * @class Lightweight stream-cipher–style encryption utility using `HMAC-SHA256` for keystream generation and authentication.
+ *      - The class derives separate encryption and MAC keys from the provided secret.
  *
  * @remarks
  * - **The encryption scheme is:**

package/dist/dts/hash/Signet.d.ts

@@ -2,8 +2,9 @@ import type { GenericObject } from '../object/types';
 import type { Maybe } from '../types/index';
 import type { DecodedToken, SignetPayload, SignOptions, TokenString, VerifiedToken, VerifyOptions } from './types';
 /**
- * * A lightweight, secure implementation of JWT-like tokens using `HMAC-SHA256` signatures.
- *   - This class provides methods to create, verify, and decode tokens with a simple API similar to JSON Web Tokens (`JWT`) but with a smaller footprint and zero dependencies.
+ * @class A lightweight, secure implementation of JWT-like tokens using `HMAC-SHA256` signatures.
+ *      - This class provides methods to create, verify, and decode tokens with a simple API similar to JSON Web Tokens (`JWT`)
+ *        but with a smaller footprint and zero dependencies.
  *
  * @remarks
  * - **Features:**

package/dist/dts/http-status/HttpStatus.d.ts

@@ -1,7 +1,7 @@
 import type { Maybe } from '../types/index';
 import type { HttpStatusCode, HttpStatusName, StatusCategory, StatusCode, StatusEntry, StatusName } from './types';
 /**
- * * Utility class for retrieving and managing HTTP status codes with rich MDN-based metadata.
+ * @class Utility class for retrieving and managing HTTP status codes with rich MDN-based metadata.
  *
  * @remarks
  * - Supports lookup by code or name (both `SOME_NAME` and `Some Name` formats).

package/dist/dts/pluralizer/Pluralizer.d.ts

@@ -1,13 +1,13 @@
 import type { PluralizeOptions } from './types';
 /**
- * * Handles English word pluralization and singularization with support for irregular forms and uncountable nouns.
+ * @class Handles English word pluralization and singularization with support for irregular forms and uncountable nouns.
  *
- * - Provides methods to convert words between singular and plural forms, check if a word is plural or singular, and manage custom pluralization rules.
- * - Supports adding custom pluralization and singularization rules, as well as uncountable nouns.
- * - Automatically handles common irregular forms like "child" to "children"
- * - Automatically loads common irregular forms and uncountable nouns.
- * - Supports options for count-based pluralization, allowing for inclusive formatting.
- * - This class is useful for applications that need to handle natural language processing, such as chatbots, content management systems, or any text processing tasks that require accurate pluralization.
+ *      - Provides methods to convert words between singular and plural forms, check if a word is plural or singular, and manage custom pluralization rules.
+ *      - Supports adding custom pluralization and singularization rules, as well as uncountable nouns.
+ *      - Automatically handles common irregular forms like "child" to "children"
+ *      - Automatically loads common irregular forms and uncountable nouns.
+ *      - Supports options for count-based pluralization, allowing for inclusive formatting.
+ *      - This class is useful for applications that need to handle natural language processing, such as chatbots, content management systems, or any text processing tasks that require accurate pluralization.
  *
  * @remarks
  * - For simpler pluralization (plural with only 's'), please refer to {@link https://toolbox.nazmul-nhb.dev/docs/utilities/string/formatUnitWithPlural formatUnitWithPlural} instead.

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');
@@ -60,7 +59,7 @@ export declare function isBGColor(value: string): value is BGColor;
 /** * Check if a string represent `TextStyle` used in `LogStyler`. */
 export declare function isTextStyle(value: string): value is TextStyle;
 /**
- * * Utility class for styling console log output with `ANSI` (`Node.js`) or `CSS` (Browser).
+ * @class Utility class for styling console log output with `ANSI` (`Node.js`) or `CSS` (Browser).
  *
  * @remarks
  * - Allows chaining of style methods or initializing with predefined styles.
@@ -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/dts/utils/Paginator.d.ts

@@ -1,5 +1,5 @@
 import type { FromMetaOptions, PageListOptions, PaginatorMeta, PaginatorOptions } from './types';
-/** * Generates pagination logic, offsets, metadata and other pagination logic(s) for APIs and UIs. */
+/** @class Generates pagination logic, offsets, metadata and other pagination logic(s) for APIs and UIs. */
 export declare class Paginator {
     #private;
     /**

package/dist/dts/verbalizer/Verbalizer.d.ts

@@ -1,12 +1,12 @@
 /**
- * * Handles English verb conjugation between base, past tense, and past participle forms.
+ * @class Handles English verb conjugation between base, past tense, and past participle forms.
  *
- * - Provides methods to convert verbs between base, past, and past participle forms, check verb forms, and manage custom conjugation rules.
- * - Supports adding custom conjugation rules and irregular verbs.
- * - Automatically handles common irregular verbs like "go" to "went" (past) and "gone" (past participle).
- * - Automatically loads common irregular verbs and conjugation rules.
- * - Preserves case sensitivity of input verbs.
- * - This class is useful for natural language processing tasks, such as chatbots, text analysis, or content generation systems requiring accurate verb conjugation.
+ *      - Provides methods to convert verbs between base, past, and past participle forms, check verb forms, and manage custom conjugation rules.
+ *      - Supports adding custom conjugation rules and irregular verbs.
+ *      - Automatically handles common irregular verbs like "go" to "went" (past) and "gone" (past participle).
+ *      - Automatically loads common irregular verbs and conjugation rules.
+ *      - Preserves case sensitivity of input verbs.
+ *      - This class is useful for natural language processing tasks, such as chatbots, text analysis, or content generation systems requiring accurate verb conjugation.
  *
  * @remarks
  * For ready to use instance, please refer to {@link https://toolbox.nazmul-nhb.dev/docs/utilities/string/verbalizer verbalizer} instead.

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/BanglaCalendar.js

@@ -209,7 +209,7 @@ export class BanglaCalendar {
         return _formatDateCore(format || 'ddd, DD mmmm (SS), YYYY বঙ্গাব্দ', dateComponents);
     }
     #processGregYear(bnYear, bnMonth) {
-        const baseGregYear = bnYear ?? this.year.en + BN_YEAR_OFFSET;
+        const baseGregYear = (bnYear ?? this.year.en) + BN_YEAR_OFFSET;
         const gregYear = (bnMonth ?? this.month.en) > 10 ? baseGregYear + 1 : baseGregYear;
         return { baseGregYear, gregYear };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.54",
+  "version": "4.28.57",
   "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",
@@ -52,7 +52,7 @@
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^16.5.0",
+    "globals": "^17.0.0",
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "lint-staged": "^16.2.7",