nhb-toolbox 4.23.24 → 4.24.0

package/CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.24.0] - 2025-10-30
+
+- **Added** new color utility `generateRandomColor` with alias `getRandomColor` and **deprecated** `generateRandomColorInHexRGB`.
+
+## [4.23.25] - 2025-10-27
+
+- **Updated** tsdoc for `Chronos` *constructor* and **optimized** *internal logic* for some *checker methods*.
+
 ## [4.23.24] - 2025-10-26
 
 - **Fixed** *pluralization issue* with ***suffixed*** `'-foot' --> '-feet'` for *format methods* in *converter classes*.
@@ -13,7 +21,7 @@ All notable changes to the package will be documented here.
 ## [4.23.23] - 2025-10-26
 
 - **Fixed** *pluralization issue* with `'foot' --> 'feet'` for *format methods* in *converter classes*.
-- **Renamed** the export of `GENERAL_UNITS` (used in `Unit` class) and `CATEGORIZED_UNITS` (used in `Converter` classes) from `'nhb-toolbox/constants'`.
+- **Exported** `GENERAL_UNITS` (used in `Unit` class) and `CATEGORIZED_UNITS` (used in `Converter` classes) from `'nhb-toolbox/constants'`.
 
 ## [4.23.21] - 2025-10-25
 

package/dist/cjs/colors/random.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateRandomColorInHexRGB = exports.generateRandomHSLColor = void 0;
+exports.generateRandomColor = generateRandomColor;
 const convert_1 = require("./convert");
 const helpers_1 = require("./helpers");
+const utils_1 = require("./utils");
 const generatedColors = new Set();
 const recentColors = [];
 const generateRandomHSLColor = (maxColors = 16) => {
@@ -22,3 +24,17 @@ const generateRandomColorInHexRGB = (maxColors = 16) => {
     return (0, convert_1.convertColorCode)((0, exports.generateRandomHSLColor)(maxColors));
 };
 exports.generateRandomColorInHexRGB = generateRandomColorInHexRGB;
+function generateRandomColor(options) {
+    const { colorType = 'hex', maxColors = 16 } = options ?? {};
+    const hsl = (0, exports.generateRandomHSLColor)(maxColors);
+    const hslValues = (0, utils_1.extractSolidColorValues)(hsl);
+    switch (colorType) {
+        case 'hsl':
+            return hsl;
+        case 'rgb':
+            return (0, convert_1.convertHslToRgb)(...hslValues);
+        case 'hex':
+        default:
+            return (0, convert_1.convertHslToHex)(...hslValues);
+    }
+}

package/dist/cjs/date/Chronos.js

@@ -393,18 +393,18 @@ class Chronos {
     }
     isSame(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() ===
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp ===
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() <
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp <
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() >
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp >
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));

package/dist/cjs/index.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateFactorial = exports.calculateAverage = exports.verbalizer = exports.Verbalizer = exports.pluralizer = exports.Pluralizer = exports.VolumeConverter = exports.TimeConverter = exports.TemperatureConverter = exports.MassConverter = exports.LengthConverter = exports.DataConverter = exports.converter = exports.Converter = exports.AreaConverter = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
 exports.convertRomanToNumeric = exports.convertRomanToInteger = exports.convertRomanToArabic = exports.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = exports.arabicToRoman = exports.isPerfectSquare = exports.isPartOfFibonacciSeries = exports.isPartOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isNumberInvalid = exports.isMultiple = exports.isInvalidNumber = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areNumbersInvalid = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.UnitConverter = exports.Unit = exports.Currency = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.roundToDecimal = exports.roundNumber = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getRandomInt = exports.getFactors = exports.getFactorial = exports.getDivisors = exports.getAverageOfNumbers = exports.getAverage = exports.factorsOf = exports.factorial = exports.convertToFixed = void 0;
-exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.numberToOrdinal = exports.normalizeNumber = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.wordToNumber = exports.wordsToNumber = exports.toRomanNumeral = exports.toRoman = exports.romanToNumeric = exports.romanToInteger = exports.romanToArabic = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.convertWordToNumber = exports.convertWordsToNumber = exports.convertToRomanNumerals = void 0;
-exports.averageByField = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.isDateLike = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = void 0;
-exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.extractObjectKeysDeep = exports.extractObjectKeys = exports.extractKeysDeep = exports.extractKeys = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = void 0;
-exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = void 0;
-exports.HttpStatus = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = void 0;
+exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.getRandomColor = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.generateRandomColor = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.numberToOrdinal = exports.normalizeNumber = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.wordToNumber = exports.wordsToNumber = exports.toRomanNumeral = exports.toRoman = exports.romanToNumeric = exports.romanToInteger = exports.romanToArabic = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.convertWordToNumber = exports.convertWordsToNumber = exports.convertToRomanNumerals = void 0;
+exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.isDateLike = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = void 0;
+exports.extractNewFields = exports.extractObjectKeysDeep = exports.extractObjectKeys = exports.extractKeysDeep = exports.extractKeys = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = exports.averageByField = exports.shuffleArray = void 0;
+exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryStringLiteral = exports.parseQueryString = exports.literalQueryStringToObject = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = void 0;
+exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.httpStatus = exports.HttpStatus = exports.isValidSet = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
@@ -165,8 +165,10 @@ Object.defineProperty(exports, "getNumbersInRange", { enumerable: true, get: fun
 var initials_1 = require("./colors/initials");
 Object.defineProperty(exports, "getColorForInitial", { enumerable: true, get: function () { return initials_1.getColorForInitial; } });
 var random_1 = require("./colors/random");
+Object.defineProperty(exports, "generateRandomColor", { enumerable: true, get: function () { return random_1.generateRandomColor; } });
 Object.defineProperty(exports, "generateRandomColorInHexRGB", { enumerable: true, get: function () { return random_1.generateRandomColorInHexRGB; } });
 Object.defineProperty(exports, "generateRandomHSLColor", { enumerable: true, get: function () { return random_1.generateRandomHSLColor; } });
+Object.defineProperty(exports, "getRandomColor", { enumerable: true, get: function () { return random_1.generateRandomColor; } });
 var convert_3 = require("./colors/convert");
 Object.defineProperty(exports, "convertColorCode", { enumerable: true, get: function () { return convert_3.convertColorCode; } });
 Object.defineProperty(exports, "convertHex8ToHsla", { enumerable: true, get: function () { return convert_3.convertHex8ToHsla; } });

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

@@ -1,4 +1,4 @@
-import type { HSL, RandomHexRGB } from './types';
+import type { $ColorType, HSL, RandomColor, RandomColorOptions, RandomHexRGB } from './types';
 /**
  * * Utility to generate a unique random HSL color.
  *
@@ -7,9 +7,39 @@ import type { HSL, RandomHexRGB } from './types';
  */
 export declare const generateRandomHSLColor: (maxColors?: number) => HSL;
 /**
- * * Utility to generate a unique random color in Hex6 and RGB format.
+ * @deprecated For better performance and flexible use cases, please consider using {@link generateRandomColor}.
+ *
+ * * Utility to generate a unique random color in `Hex6` and `RGB` format.
  *
  * @param maxColors - The maximum number of recent colors to store in memory. Default is `16`.
  * @returns An object of generated unique random color in both `Hex` and `RGB` formats.
  */
 export declare const generateRandomColorInHexRGB: (maxColors?: number) => RandomHexRGB;
+/**
+ * * Generates a random color in one of three formats: `Hex6`, `RGB`, or `HSL`.
+ *
+ * @remarks
+ * - If no `options` or `colorType` option is provided, the function defaults to returning a color in `Hex6` format.
+ * - The `colorType` option determines the return type:
+ *   - `'hex'` → returns a `Hex6` string e.g. `'#34E2EF'`
+ *   - `'rgb'` → returns an `RGB` string e.g. `'hsl(223, 96%, 53%)'`
+ *   - `'hsl'` → returns an `HSL` string e.g. `'rgb(235, 159, 45)'`
+ * - The `maxColors` option controls how many recently generated colors are kept in memory to prevent repetition.
+ *   By default, this value is `16`. Increasing it allows more unique color variations before repeating.
+ *
+ * @param options - Configuration options for random color generation, including `colorType` and `maxColors`.
+ * @returns A random color in the specified format (`Hex6`, `RGB`, or `HSL`).
+ *
+ * @example
+ * ```ts
+ * const hex = generateRandomColor();
+ * // inferred: Hex6
+ *
+ * const rgb = generateRandomColor({ colorType: 'rgb' });
+ * // inferred: RGB
+ *
+ * const hsl = generateRandomColor({ colorType: 'hsl', maxColors: 32 });
+ * // inferred: HSL, with a larger unique color memory pool
+ * ```
+ */
+export declare function generateRandomColor<C extends $ColorType | undefined = undefined>(options?: RandomColorOptions<C>): RandomColor<C>;

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

@@ -55,6 +55,17 @@ export type RandomHexRGB = {
     /** Represents an RGB color string. */
     rgb: RGB;
 };
+/** Basic color type: `hex`, `rgb` or `hsl`. */
+export type $ColorType = 'hex' | 'rgb' | 'hsl';
+/** Options for random color generation. */
+export interface RandomColorOptions<Color extends $ColorType | undefined> {
+    /** The type of expected return type of color: `hex`, `rgb` or `hsl`. Default is `'hex'`. */
+    colorType?: Color;
+    /** The maximum number of recent colors to store in memory. Default is `16`. */
+    maxColors?: number;
+}
+/** Infers the return color type (`Hex6`, `RGB`, or `HSL`) based on the provided color type. */
+export type RandomColor<Color extends $ColorType | undefined = undefined> = Color extends 'hsl' ? HSL : Color extends 'rgb' ? RGB : Hex6;
 /** * Union type representing a color in Hex6, RGB, or HSL format. */
 export type ColorTypeSolid = Hex6 | RGB | HSL;
 /** * Union type representing a color in Hex8, RGBA, or HSLA format. */

package/dist/dts/converter/Converter.d.ts

@@ -8,7 +8,7 @@ import { $Time } from './time';
 import type { $Unit, Converted } from './types';
 import { $Volume } from './volume';
 /**
- * @function Converter : This is a unit converter function that creates instances of specific converter classes based on the provided unit.
+ * @function Converter - This is a unit converter function that creates instances of specific converter class based on the provided unit.
  *
  * @description Converts values between compatible units (time, length, data, temperature, mass, area, volume).
  * The returned instance exposes only methods relevant to the provided unit type.

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

@@ -31,9 +31,9 @@ export declare class Chronos {
     /** Use `readonly and/or private` methods outside `Chronos`. Purpose: Plugin creation. */
     protected static [INTERNALS]: ChronosInternals;
     /**
-     * * `Chronos` date/time in Native JS `Date` format.
+     * * `Chronos` date/time as Native JS `Date` object.
      *
-     * - **NOTE**: It is **HIGHLY** advised *not to rely* on this public property to access native JS `Date`. It's not reliable when timezone and/or UTC related operations are performed. If you really need to use native `Date`, use `toDate` method.  THis property is purely for developer convenience and sugar.
+     * - **NOTE**: It is **HIGHLY** advised *not to rely* on this public property to access native JS `Date`. It's not reliable when timezone and/or UTC related operations are performed. If you really need to use native `Date`, use `toDate` method. This property is purely for developer convenience and sugar.
      */
     native: Date;
     /** Origin of the `Chronos` instance (Method that created `new Chronos`), useful fo tracking instance. */
@@ -68,9 +68,6 @@ export declare class Chronos {
     /**
      * * 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 as `Date` object, it will be used as is.
      *
      * @returns Instance of `Chronos` with all methods and properties.
@@ -79,9 +76,6 @@ export declare class Chronos {
     /**
      * * 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 as `Chronos` object.
      *
      * @returns Instance of `Chronos` with all methods and properties.
@@ -175,7 +169,7 @@ export declare class Chronos {
     /** @instance Returns a date as a string value in ISO format. */
     toISOString(): string;
     /**
-     * @instance Wrapper over native `toLocaleString`
+     * @instance Wrapper over native `toLocaleString`.
      * @description Converts a date and time to a string by using the current or specified locale.
      *
      * @param locales A locale string, array of locale strings, Intl.Locale object, or array of Intl.Locale objects that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
@@ -212,9 +206,9 @@ export declare class Chronos {
      *                 (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
      *	 - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for detailed usage.
      *
-     * @param useUTC - If `true`, formats the date in UTC (equivalent to `formatUTC()`);
+     * @param useUTC - If `true`, formats the date in UTC (equivalent to `formatUTC()`).
      *                 Defaults to `false` (local time).
-     * @returns A formatted date string in the specified format
+     * @returns A formatted date string in the specified format.
      */
     formatStrict(format?: StrictFormat, useUTC?: boolean): string;
     /**

package/dist/dts/index.d.ts

@@ -33,7 +33,7 @@ export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime
 export { getOrdinal as cardinalToOrdinal, clampNumber, formatCurrency as convertNumberToCurrency, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, formatCurrency, getOrdinal, getOrdinal as getOrdinalNumber, getRandomFloat as getRandomDecimal, getRandomFloat, normalizeNumber, getOrdinal as numberToOrdinal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 export { getColorForInitial } from './colors/initials';
-export { generateRandomColorInHexRGB, generateRandomHSLColor } from './colors/random';
+export { generateRandomColor, generateRandomColorInHexRGB, generateRandomHSLColor, generateRandomColor as getRandomColor, } from './colors/random';
 export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert';
 export { Color, Color as Colour } from './colors/Color';
 export { extractAlphaColorValues, extractSolidColorValues } from './colors/utils';

package/dist/esm/colors/random.js

@@ -1,5 +1,6 @@
-import { convertColorCode } from './convert.js';
+import { convertColorCode, convertHslToHex, convertHslToRgb } from './convert.js';
 import { _generateRandomHSL, _isSimilarToLast } from './helpers.js';
+import { extractSolidColorValues } from './utils.js';
 const generatedColors = new Set();
 const recentColors = [];
 export const generateRandomHSLColor = (maxColors = 16) => {
@@ -17,3 +18,17 @@ export const generateRandomHSLColor = (maxColors = 16) => {
 export const generateRandomColorInHexRGB = (maxColors = 16) => {
     return convertColorCode(generateRandomHSLColor(maxColors));
 };
+export function generateRandomColor(options) {
+    const { colorType = 'hex', maxColors = 16 } = options ?? {};
+    const hsl = generateRandomHSLColor(maxColors);
+    const hslValues = extractSolidColorValues(hsl);
+    switch (colorType) {
+        case 'hsl':
+            return hsl;
+        case 'rgb':
+            return convertHslToRgb(...hslValues);
+        case 'hex':
+        default:
+            return convertHslToHex(...hslValues);
+    }
+}

package/dist/esm/date/Chronos.js

@@ -390,18 +390,18 @@ export class Chronos {
     }
     isSame(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() ===
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp ===
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() <
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp <
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() >
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp >
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));

package/dist/esm/index.js

@@ -18,7 +18,7 @@ export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime
 export { getOrdinal as cardinalToOrdinal, clampNumber, formatCurrency as convertNumberToCurrency, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, formatCurrency, getOrdinal, getOrdinal as getOrdinalNumber, getRandomFloat as getRandomDecimal, getRandomFloat, normalizeNumber, getOrdinal as numberToOrdinal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities.js';
 export { getNumbersInRange } from './number/range.js';
 export { getColorForInitial } from './colors/initials.js';
-export { generateRandomColorInHexRGB, generateRandomHSLColor } from './colors/random.js';
+export { generateRandomColor, generateRandomColorInHexRGB, generateRandomHSLColor, generateRandomColor as getRandomColor, } from './colors/random.js';
 export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert.js';
 export { Color, Color as Colour } from './colors/Color.js';
 export { extractAlphaColorValues, extractSolidColorValues } from './colors/utils.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.23.24",
+  "version": "4.24.0",
   "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",
@@ -41,7 +41,7 @@
   "devDependencies": {
     "@eslint/js": "^9.38.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.9.1",
+    "@types/node": "^24.9.2",
     "@typescript-eslint/eslint-plugin": "^8.46.2",
     "@typescript-eslint/parser": "^8.46.2",
     "eslint": "^9.38.0",