nhb-toolbox 4.28.52 → 4.28.53

package/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 All notable changes to the package will be documented here.
 
+## [4.28.53] - 2026-01-01
+
+- **Optimized** *internal utilities* to enhance **runtime performance** and **editor IntelliSense**.
+
 ## [4.28.52] - 2025-12-30
 
 - **Added** *new* methods for `BanglaCalendar`: `addDays`, `addWeeks`, `addMonths`, `addYears`, `valueOf` and `[Symbol.toPrimitive]`.

package/dist/cjs/date/parse.js

@@ -6,16 +6,15 @@ const specials_1 = require("../guards/specials");
 const constants_1 = require("./constants");
 const guards_1 = require("./guards");
 function parseMSec(value, sec = false) {
-    if ((0, specials_1.isNumericString)(value)) {
+    if ((0, primitives_1.isNumber)(value) || (0, specials_1.isNumericString)(value)) {
         return _parse(`${value}s`, sec);
     }
     else if ((0, guards_1.isTimeWithUnit)(value)) {
         return _parse(value, sec);
     }
-    else if ((0, primitives_1.isNumber)(value)) {
-        return _parse(`${value}s`, sec);
+    else {
+        return NaN;
     }
-    return NaN;
 }
 function _parse(str, sec = false) {
     if (!(0, primitives_1.isNonEmptyString)(str) || str.length > 100) {

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

@@ -1,11 +1,11 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { Maybe } from '../types/index';
 import type { $BnEn, $GMTOffset, $TimeZoneIdentifier, BanglaSeasonName, BnCalendarVariant, TimeZoneNameNative } from './types';
-/** Core formatting logic shared by `formatDate` and `Chronos` class */
+/** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */
 export declare function _formatDateCore(format: string, dateComponents: Record<string, string>): string;
 /** Core formatting logic shared by `formatDate` and `Chronos` class */
 export declare function _formatDate(format: string, year: number, month: number, day: number, date: number, hours: number, minutes: number, seconds: number, milliseconds: number, offset: string): string;
-/** Normalize a time string with by adding offset at the end */
+/** Normalize a time string by adding offset at the end */
 export declare function _normalizeOffset(timeStr: string): string;
 /** Converts milliseconds to seconds */
 export declare const _toSeconds: (ms: number) => number;
@@ -18,8 +18,11 @@ type $ResolvedTzName<T extends $TzNameType> = Maybe<T extends 'long' ? TimeZoneN
 export declare function _resolveNativeTzName<T extends $TzNameType>(tzId: $TzId, type: T, date?: Date): $ResolvedTzName<T>;
 /** Convert `GMT±HH:mm` string to `UTC±HH:mm` format*/
 export declare function _gmtToUtcOffset(gmt: Maybe<string>): Maybe<"UTC+00:15" | "UTC+00:30" | "UTC+00:45" | "UTC+00:00" | "UTC+01:15" | "UTC+01:30" | "UTC+01:45" | "UTC+01:00" | "UTC+02:15" | "UTC+02:30" | "UTC+02:45" | "UTC+02:00" | "UTC+03:15" | "UTC+03:30" | "UTC+03:45" | "UTC+03:00" | "UTC+04:15" | "UTC+04:30" | "UTC+04:45" | "UTC+04:00" | "UTC+05:15" | "UTC+05:30" | "UTC+05:45" | "UTC+05:00" | "UTC+06:15" | "UTC+06:30" | "UTC+06:45" | "UTC+06:00" | "UTC+07:15" | "UTC+07:30" | "UTC+07:45" | "UTC+07:00" | "UTC+08:15" | "UTC+08:30" | "UTC+08:45" | "UTC+08:00" | "UTC+09:15" | "UTC+09:30" | "UTC+09:45" | "UTC+09:00" | "UTC+10:15" | "UTC+10:30" | "UTC+10:45" | "UTC+10:00" | "UTC+14:15" | "UTC+14:30" | "UTC+14:45" | "UTC+14:00" | "UTC+11:15" | "UTC+11:30" | "UTC+11:45" | "UTC+11:00" | "UTC+12:15" | "UTC+12:30" | "UTC+12:45" | "UTC+12:00" | "UTC+13:15" | "UTC+13:30" | "UTC+13:45" | "UTC+13:00" | "UTC-00:15" | "UTC-00:30" | "UTC-00:45" | "UTC-00:00" | "UTC-01:15" | "UTC-01:30" | "UTC-01:45" | "UTC-01:00" | "UTC-02:15" | "UTC-02:30" | "UTC-02:45" | "UTC-02:00" | "UTC-03:15" | "UTC-03:30" | "UTC-03:45" | "UTC-03:00" | "UTC-04:15" | "UTC-04:30" | "UTC-04:45" | "UTC-04:00" | "UTC-05:15" | "UTC-05:30" | "UTC-05:45" | "UTC-05:00" | "UTC-06:15" | "UTC-06:30" | "UTC-06:45" | "UTC-06:00" | "UTC-07:15" | "UTC-07:30" | "UTC-07:45" | "UTC-07:00" | "UTC-08:15" | "UTC-08:30" | "UTC-08:45" | "UTC-08:00" | "UTC-09:15" | "UTC-09:30" | "UTC-09:45" | "UTC-09:00" | "UTC-10:15" | "UTC-10:30" | "UTC-10:45" | "UTC-10:00" | "UTC-14:15" | "UTC-14:30" | "UTC-14:45" | "UTC-14:00" | "UTC-11:15" | "UTC-11:30" | "UTC-11:45" | "UTC-11:00" | "UTC-12:15" | "UTC-12:30" | "UTC-12:45" | "UTC-12:00" | "UTC-13:15" | "UTC-13:30" | "UTC-13:45" | "UTC-13:00">;
+/** Get Bangla season name by month index (`0-11`) */
 export declare function _getBnSeason<L extends $BnEn = 'bn'>(month: number, locale?: L | $BnEn): BanglaSeasonName<L>;
+/** Check whether a Bangla year is leap by Gregorian and Bangla years and calendar variant */
 export declare function _isBnLeapYear(by: number, gy: number, v?: BnCalendarVariant): boolean;
+/** Extract selective unit values from {@link Date} object */
 export declare function _extractDateUnits(date: Date): {
     gy: number;
     $gm: Enumerate<12>;
@@ -27,10 +30,15 @@ export declare function _extractDateUnits(date: Date): {
     gd: NumberRange<1, 31>;
     wd: Enumerate<7>;
 };
+/** Get Gregorian base year from {@link Date} object for Bangla year */
 export declare function _getGregBaseYear(date: Date): number;
+/** Get Bangla year from {@link Date} object */
 export declare function _getBnYear(date: Date): number;
+/** Get timestamp in milliseconds between midnight, January 1, 1970 (UTC) and the specified {@link Date} object */
 export declare function _getUtcTs(date: Date): number;
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) for specific {@link Date} */
 export declare function _getElapsedDays(date: Date): number;
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) and month index for specific `Date` and Bangla calendar variant */
 export declare function _bnDaysMonthIdx(date: Date, variant?: BnCalendarVariant): {
     days: number;
     monthIdx: number;

package/dist/esm/date/parse.js

@@ -3,16 +3,15 @@ import { isNumericString } from '../guards/specials.js';
 import { MS_MAP } from './constants.js';
 import { isTimeWithUnit } from './guards.js';
 export function parseMSec(value, sec = false) {
-    if (isNumericString(value)) {
+    if (isNumber(value) || isNumericString(value)) {
         return _parse(`${value}s`, sec);
     }
     else if (isTimeWithUnit(value)) {
         return _parse(value, sec);
     }
-    else if (isNumber(value)) {
-        return _parse(`${value}s`, sec);
+    else {
+        return NaN;
     }
-    return NaN;
 }
 function _parse(str, sec = false) {
     if (!isNonEmptyString(str) || str.length > 100) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.52",
+  "version": "4.28.53",
   "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",
@@ -47,8 +47,8 @@
     "@eslint/js": "^9.39.2",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.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.50.1"
+    "typescript-eslint": "^8.51.0"
   },
   "keywords": [
     "toolbox",