nhb-toolbox 4.28.7 → 4.28.10

package/CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.28.10] - 2025-12-03
+
+- **Added** *new* `addOrOverrideCode` method and **modified** *existing* + **introduced** *new types* for `HttpStatus` class.
+
+## [4.28.8] - 2025-12-03
+
+- **Fixed** a *tree-shaking issue* affecting `Chronos` and other *date/time utilities* by removing a *pre-compiled* `RegExp` instance from **date/constants**.
+
 ## [4.28.7] - 2025-12-02
 
 - **Updated** *invalid links* in *tsdoc* of the *hash utilities*.

package/dist/cjs/date/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MS_MAP = exports.TIME_UNIT_REGEX = exports.TIME_UNIT_VARIANTS = exports.ZODIAC_PRESETS = exports.VEDIC_ZODIAC_SIGNS = exports.WESTERN_ZODIAC_SIGNS = exports.DATE_PART_RANGES = exports.SORTED_TIME_FORMATS = exports.TIME_FORMATS = exports.MILLISECOND_FORMATS = exports.ZONE_FORMATS = exports.SECOND_FORMATS = exports.MINUTE_FORMATS = exports.HOUR_FORMATS = exports.DAY_FORMATS = exports.DATE_FORMATS = exports.MONTH_FORMATS = exports.YEAR_FORMATS = exports.MONTHS = exports.DAYS = exports.INTERNALS = void 0;
+exports.MS_MAP = exports.TIME_UNIT_VARIANTS = exports.ZODIAC_PRESETS = exports.VEDIC_ZODIAC_SIGNS = exports.WESTERN_ZODIAC_SIGNS = exports.DATE_PART_RANGES = exports.SORTED_TIME_FORMATS = exports.TIME_FORMATS = exports.MILLISECOND_FORMATS = exports.ZONE_FORMATS = exports.SECOND_FORMATS = exports.MINUTE_FORMATS = exports.HOUR_FORMATS = exports.DAY_FORMATS = exports.DATE_FORMATS = exports.MONTH_FORMATS = exports.YEAR_FORMATS = exports.MONTHS = exports.DAYS = exports.INTERNALS = void 0;
 exports.INTERNALS = Symbol('Internals');
 exports.DAYS = /* @__PURE__ */ Object.freeze([
     'Sunday',
@@ -106,11 +106,6 @@ exports.TIME_UNIT_VARIANTS = /* @__PURE__ */ Object.freeze({
     second: ['s', 'sec', 'secs', 'second', 'seconds'],
     millisecond: ['ms', 'msec', 'msecs', 'millisecond', 'milliseconds'],
 });
-const TIME_UNIT_REGEX_STR = /* @__PURE__ */ Object.freeze(Object.values(exports.TIME_UNIT_VARIANTS)
-    .flat()
-    .sort((a, b) => b.length - a.length)
-    .join('|'));
-exports.TIME_UNIT_REGEX = /* @__PURE__ */ Object.freeze(new RegExp(`^(?<value>-?\\d*\\.?\\d+) *(?<unit>${TIME_UNIT_REGEX_STR})?$`, 'i'));
 exports.MS_MAP = /* @__PURE__ */ Object.freeze((() => {
     const s = 1000;
     const m = s * 60;

package/dist/cjs/date/guards.js

@@ -10,7 +10,6 @@ exports.isTimeWithUnit = isTimeWithUnit;
 const primitives_1 = require("../guards/primitives");
 const specials_1 = require("../guards/specials");
 const utilities_1 = require("../number/utilities");
-const constants_1 = require("./constants");
 const timezone_1 = require("./timezone");
 function isValidTime(value) {
     if (!(0, primitives_1.isNonEmptyString)(value))
@@ -67,5 +66,6 @@ function isDateLike(value) {
     return false;
 }
 function isTimeWithUnit(value) {
-    return (0, primitives_1.isNonEmptyString)(value) && constants_1.TIME_UNIT_REGEX.test(value);
+    return ((0, primitives_1.isNonEmptyString)(value) &&
+        /^-?\d*\.?\d+ *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.test(value));
 }

package/dist/cjs/date/parse.js

@@ -21,7 +21,7 @@ function _parse(str, sec = false) {
     if (!(0, primitives_1.isNonEmptyString)(str) || str.length > 100) {
         throw new RangeError(`Value must be a string with length between 1 and 99!`);
     }
-    const match = constants_1.TIME_UNIT_REGEX.exec(str);
+    const match = /^(?<value>-?\d*\.?\d+) *(?<unit>milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.exec(str);
     if (!match?.groups)
         return NaN;
     const unit = (match.groups.unit ?? 'ms').toLowerCase();

package/dist/cjs/http-status/HttpStatus.js

@@ -47,12 +47,20 @@ class HttpStatus {
         }
         return added;
     }
+    addOrOverrideCode(...entries) {
+        for (const entry of entries) {
+            this.#storeEntry(entry);
+            HttpStatus.Groups[entry.category].push(entry.code);
+        }
+        return this;
+    }
     list(category) {
+        const entries = [...this.#codesByNumber.values()];
         if (!category) {
-            return [...this.#codesByNumber.values()];
+            return entries;
         }
         else {
-            return [...this.#codesByNumber.values()].filter((entry) => entry.category === category);
+            return entries.filter((entry) => entry.category === category);
         }
     }
     #storeEntry(entry) {

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

@@ -40,7 +40,5 @@ export declare const TIME_UNIT_VARIANTS: Readonly<{
     readonly second: readonly ["s", "sec", "secs", "second", "seconds"];
     readonly millisecond: readonly ["ms", "msec", "msecs", "millisecond", "milliseconds"];
 }>;
-/** `RegExp` for time unit variants */
-export declare const TIME_UNIT_REGEX: Readonly<RegExp>;
 /** Map to different time units to milliseconds */
 export declare const MS_MAP: Readonly<Record<"year" | "y" | "yr" | "yrs" | "years" | "month" | "mo" | "months" | "week" | "w" | "weeks" | "day" | "d" | "days" | "hour" | "h" | "hr" | "hrs" | "hours" | "minute" | "m" | "min" | "mins" | "minutes" | "second" | "s" | "sec" | "secs" | "seconds" | "millisecond" | "ms" | "msec" | "msecs" | "milliseconds", number>>;

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

@@ -486,8 +486,12 @@ export type ChronosWithOptions = Partial<{
     /** Milliseconds of the second, from 0 to 999. */
     millisecond: Milliseconds;
 }>;
+/** Mapped type to {@link TIME_UNIT_VARIANTS} */
+export type $TimeUnitVarMap = typeof TIME_UNIT_VARIANTS;
+/** Key of {@link TIME_UNIT_VARIANTS} */
+export type $TimeUnitKey = keyof typeof TIME_UNIT_VARIANTS;
 /** Variants of different time units in lowercase */
-export type $TimeUnitVar = (typeof TIME_UNIT_VARIANTS)[keyof typeof TIME_UNIT_VARIANTS][number];
+export type $TimeUnitVar<U extends $TimeUnitKey = $TimeUnitKey> = $TimeUnitVarMap[U][number];
 /** Variants of different time units in lowercase, uppercase  and capitalized */
 export type $UnitAnyCase = Capitalize<$TimeUnitVar> | Uppercase<$TimeUnitVar> | $TimeUnitVar;
 /** Number (time value) with variants of different time units */

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

@@ -1,4 +1,4 @@
-import type { HttpStatusName, StatusCategory, StatusCode, StatusEntry } from './types';
+import type { HttpStatusCode, HttpStatusName, StatusCategory, StatusCode, StatusEntry, StatusName } from './types';
 /**
  * * Utility class for retrieving and managing HTTP status codes with rich MDN-based metadata.
  *
@@ -37,10 +37,16 @@ export declare class HttpStatus {
     #private;
     /**
      * * Static category groups for quick reference.
-     * * Populated at runtime from the provided data.
+     * @remarks Populated at runtime from default and the provided data.
      */
     static Groups: Record<StatusCategory, StatusCode[]>;
     constructor();
+    /**
+     * * Get status entry by standard numeric HTTP code.
+     * @param code Standard HTTP status code.
+     * @returns Matching standard status entry.
+     */
+    getByCode(code: HttpStatusCode): StatusEntry;
     /**
      * * Get status entry by numeric HTTP code.
      * @param code HTTP status code.
@@ -48,11 +54,17 @@ export declare class HttpStatus {
      */
     getByCode(code: StatusCode): StatusEntry | undefined;
     /**
-     * * Get status entry by name (either SOME_NAME or "Some Name").
-     * @param name Status name.
+     * * Get status entry by standard name (either as `SOME_NAME` or `Some Name`).
+     * @param name Standard status name either as `SOME_NAME` or `Some Name`.
+     * @returns Matching standard status entry.
+     */
+    getByName(name: HttpStatusName): StatusEntry;
+    /**
+     * * Get status entry by name (either as `SOME_NAME` or `Some Name`).
+     * @param name Status name either as `SOME_NAME` or `Some Name`.
      * @returns Matching status entry or `undefined` if not found.
      */
-    getByName(name: HttpStatusName): StatusEntry | undefined;
+    getByName(name: StatusName): StatusEntry | undefined;
     /**
      * * Override the short message of an existing code.
      * @param code HTTP status code.
@@ -64,6 +76,7 @@ export declare class HttpStatus {
      * * Add one or more new HTTP status code entries.
      *
      * @remarks
+     * - New entries are compared **by their `code` value** to determine uniqueness.
      * - If a code already exists, it will be skipped and not overwritten.
      * - Returns `true` if at least one code was successfully added.
      * - Returns `false` if all provided codes already exist.
@@ -72,6 +85,15 @@ export declare class HttpStatus {
      * @returns `true` if at least one code was added, otherwise `false`.
      */
     addCode(...entries: StatusEntry[]): boolean;
+    /**
+     * * Add/override one or more HTTP status code entries.
+     *
+     * @remarks New entries use their `code` value as the comparison key and will overwrite existing ones.
+     *
+     * @param entries One or more status entries to add/override.
+     * @returns The modified instance with the newly added/updated entries.
+     */
+    addOrOverrideCode(...entries: StatusEntry[]): HttpStatus;
     /**
      * * List all codes, optionally filtered by category.
      * @param category Optional category filter.

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

@@ -1,4 +1,4 @@
-/** Data for HTTP Status Codes */
+/** HTTP status data from {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status MDN} */
 export declare const HTTP_STATUS_DATA: readonly [{
     readonly category: "informational";
     readonly link: "https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/100";
@@ -504,7 +504,7 @@ export declare const HTTP_STATUS_DATA: readonly [{
     readonly message: "Network Authentication Required";
     readonly description: "Indicates that the client needs to authenticate to gain network access.";
 }];
-/** List of HTTP Status Names with Corresponding Codes */
+/** List of {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status HTTP Status Names with Corresponding Codes} */
 export declare const HTTP_STATUS_CODES: Readonly<{
     /**
      * * {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/100 Continue}

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

@@ -1,28 +1,44 @@
 import type { LooseLiteral } from '../utils/types';
 import type { HTTP_STATUS_DATA } from './constants';
-/** HTTP Status Code, e.g. `404`, `500` etc. */
-export type StatusCode = LooseLiteral<(typeof HTTP_STATUS_DATA)[number]['code']>;
-/** Name for the Status Code in Uppercase snake case, e.g. `"NOT_FOUND"`, `"INTERNAL_SERVER_ERROR"` */
-export type StatusName = LooseLiteral<(typeof HTTP_STATUS_DATA)[number]['name']>;
-/** Name for the Status Code in Human readable form, e.g. `"Not Found"`, `"Internal Server Error"`  */
-export type StatusNameReadable = LooseLiteral<(typeof HTTP_STATUS_DATA)[number]['readableName']>;
-/** Name for the Status Code in both Human readable and Uppercase snake case */
-export type HttpStatusName = StatusName | StatusNameReadable;
+/** Mapped type of HTTP status entries */
+export type $HttpStatusMap = (typeof HTTP_STATUS_DATA)[number];
+/** HTTP status name variants: `name` or `readableName` */
+export type $StatusNameVar = 'name' | 'readableName';
 /** * Categories of HTTP status codes: `"informational"`, `"success"`, `"redirection"`, `"clientError`" or `"serverError"` */
-export type StatusCategory = (typeof HTTP_STATUS_DATA)[number]['category'];
+export type StatusCategory = $HttpStatusMap['category'];
+/** - Extracts standard HTTP status codes by the given `Category` name. Defaults to all {@link StatusCategory categories}. */
+export type HttpStatusCode<Category extends StatusCategory = StatusCategory> = $HttpStatusMap extends infer Target ? Target extends $HttpStatusMap ? Target['category'] extends Category ? Target['code'] : never : never : never;
+/** Standard HTTP Status Code, e.g. `404`, `500` etc. + any number */
+export type StatusCode = LooseLiteral<HttpStatusCode>;
+/**
+ * - Extracts standard HTTP status names filtered by {@link $StatusNameVar variant} and {@link StatusCategory category}.
+ *   - Defaults to all `variants` and `categories`.
+ *
+ * @remarks
+ * - `Name` selects either the `name` (CONSTANT_CASE) or `readableName` (Title Case).
+ * - `Category` restricts results to the chosen HTTP status {@link StatusCategory category}.
+ * - Produces a union of all matching literal status name values.
+ */
+export type HttpStatusName<Name extends $StatusNameVar = $StatusNameVar, Category extends StatusCategory = StatusCategory> = $HttpStatusMap extends infer Target ? Target extends $HttpStatusMap ? Target['category'] extends Category ? Target[Name] : never : never : never;
+/** Standard HTTP status name in `CONSTANT_CASE`, e.g. `"INTERNAL_SERVER_ERROR"` + any string */
+export type StatusName = LooseLiteral<HttpStatusName>;
+/** HTTP status name (`CONSTANT_CASE`) in {@link StatusEntry} interface */
+export type EntryStatusName = LooseLiteral<HttpStatusName<'name'>>;
+/** HTTP status name (`Title Case`) in {@link StatusEntry} interface */
+export type EntryReadableName = LooseLiteral<HttpStatusName<'readableName'>>;
 /** * Shape of an HTTP status entry. */
 export interface StatusEntry {
     /** HTTP Status Code, e.g. `404`, `500` etc. */
     code: StatusCode;
-    /** Name for the Status Code in Uppercase snake case, e.g. `"NOT_FOUND"`, `"INTERNAL_SERVER_ERROR"` */
-    name: StatusName;
-    /** Name for the Status Code in Human readable form, e.g. `"Not Found"`, `"Internal Server Error"`  */
-    readableName: StatusNameReadable;
+    /** HTTP status name in `CONSTANT_CASE`, e.g. `"NOT_FOUND"`, `"INTERNAL_SERVER_ERROR"` */
+    name: EntryStatusName;
+    /** HTTP status name in `Title Case` form, e.g. `"Not Found"`, `"Internal Server Error"`  */
+    readableName: EntryReadableName;
     /** Link to full `MDN` Docs if available */
     link?: string;
     /** Short message, Can override using `httpStatus.setMessage` method */
     message: string;
-    /** A brief description if available */
+    /** A brief description of the status code */
     description: string;
     /** The type of HTTP Status: `"informational"`, `"success"`, `"redirection"`, `"clientError`" or `"serverError"` */
     category: StatusCategory;

package/dist/esm/date/constants.js

@@ -103,11 +103,6 @@ export const TIME_UNIT_VARIANTS = /* @__PURE__ */ Object.freeze({
     second: ['s', 'sec', 'secs', 'second', 'seconds'],
     millisecond: ['ms', 'msec', 'msecs', 'millisecond', 'milliseconds'],
 });
-const TIME_UNIT_REGEX_STR = /* @__PURE__ */ Object.freeze(Object.values(TIME_UNIT_VARIANTS)
-    .flat()
-    .sort((a, b) => b.length - a.length)
-    .join('|'));
-export const TIME_UNIT_REGEX = /* @__PURE__ */ Object.freeze(new RegExp(`^(?<value>-?\\d*\\.?\\d+) *(?<unit>${TIME_UNIT_REGEX_STR})?$`, 'i'));
 export const MS_MAP = /* @__PURE__ */ Object.freeze((() => {
     const s = 1000;
     const m = s * 60;

package/dist/esm/date/guards.js

@@ -1,7 +1,6 @@
 import { isNonEmptyString, isString } from '../guards/primitives.js';
 import { isNumericString } from '../guards/specials.js';
 import { normalizeNumber } from '../number/utilities.js';
-import { TIME_UNIT_REGEX } from './constants.js';
 import { IANA_TZ_IDS } from './timezone.js';
 export function isValidTime(value) {
     if (!isNonEmptyString(value))
@@ -58,5 +57,6 @@ export function isDateLike(value) {
     return false;
 }
 export function isTimeWithUnit(value) {
-    return isNonEmptyString(value) && TIME_UNIT_REGEX.test(value);
+    return (isNonEmptyString(value) &&
+        /^-?\d*\.?\d+ *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.test(value));
 }

package/dist/esm/date/parse.js

@@ -1,6 +1,6 @@
 import { isNonEmptyString, isNumber } from '../guards/primitives.js';
 import { isNumericString } from '../guards/specials.js';
-import { MS_MAP, TIME_UNIT_REGEX } from './constants.js';
+import { MS_MAP } from './constants.js';
 import { isTimeWithUnit } from './guards.js';
 export function parseMSec(value, sec = false) {
     if (isNumericString(value)) {
@@ -18,7 +18,7 @@ function _parse(str, sec = false) {
     if (!isNonEmptyString(str) || str.length > 100) {
         throw new RangeError(`Value must be a string with length between 1 and 99!`);
     }
-    const match = TIME_UNIT_REGEX.exec(str);
+    const match = /^(?<value>-?\d*\.?\d+) *(?<unit>milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.exec(str);
     if (!match?.groups)
         return NaN;
     const unit = (match.groups.unit ?? 'ms').toLowerCase();

package/dist/esm/http-status/HttpStatus.js

@@ -44,12 +44,20 @@ export class HttpStatus {
         }
         return added;
     }
+    addOrOverrideCode(...entries) {
+        for (const entry of entries) {
+            this.#storeEntry(entry);
+            HttpStatus.Groups[entry.category].push(entry.code);
+        }
+        return this;
+    }
     list(category) {
+        const entries = [...this.#codesByNumber.values()];
         if (!category) {
-            return [...this.#codesByNumber.values()];
+            return entries;
         }
         else {
-            return [...this.#codesByNumber.values()].filter((entry) => entry.category === category);
+            return entries.filter((entry) => entry.category === category);
         }
     }
     #storeEntry(entry) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.7",
+  "version": "4.28.10",
   "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",