Skip to main content

Changelog

All notable changes to the package will be documented here.

[4.23.24] - 2025-10-26​

  • Fixed pluralization issue with suffixed '-foot' --> '-feet' for format methods in converter classes.

[4.23.23] - 2025-10-26​

  • Fixed pluralization issue with 'foot' --> 'feet' for format methods in converter classes.
  • Exported GENERAL_UNITS (used in Unit class) and CATEGORIZED_UNITS (used in Converter classes) from 'nhb-toolbox/constants'.

[4.23.21] - 2025-10-25​

  • Fixed return type (now maintains proper order in the tuple) for supportedUnits() converter method.

[4.23.20] - 2025-10-25​

  • Fixed return type for supportedUnits() converter method.
  • Added new package subpath for Color class: 'nhb-toolbox/color'.

[4.23.11] - 2025-10-24​

  • Added new base method supportedUnits() to get an array/tuple of supported unit names.
  • Fixed precision issues in several conversion factors across converter classes.
  • Optimized the formatTo() method for improved performance.

[4.23.10] - 2025-10-24​

  • Added metre variants of units where needed in converter classes.
  • Updated & Optimized subpath exports for converter classes and functions.

[4.23.1] - 2025-10-24​

  • Exported all the converter classes from the 'nhb-toolbox/converter' sub-path too.

[4.23.0] - 2025-10-24​

  • Added new unit converter classes and their combined function Converter (aliased converter).
  • Introduced new utility types: Replace ReplaceFirst and $Record.
  • Exported pluralizer, verbalizer, httpStatus and new Converter utility through different package sub-paths.

[4.21.14] - 2025-10-14​

  • Moved getTimeZoneName method to Chronos plugin system, usable via timeZonePlugin and enhanced timeZonePlugin.

[4.21.10] - 2025-10-13​

  • Moved round method to Chronos plugin system, usable via roundPlugin.
  • Updated tsdoc for some Chronos methods with proper references.

[4.21.4] - 2025-10-13​

  • Added new type $UTCOffset and applied in corresponding Chronos methods.

[4.21.1] - 2025-10-13​

  • Updated TypeScript compiler target from ESNext to ES2023 for more stable and predictable JavaScript output.
    • Ensures consistent syntax across TypeScript versions.

[4.21.0] - 2025-10-12​

  • Renamed RomanNumeralCap type to RomanCapital and allow only strict 1-3999 and RomanNumeral type to LooseRomanNumeral.
  • Removed all Roman numeral type helpers and recreated a strict RomanNumeral with other internal types.

[4.20.92] - 2025-10-12​

  • Fixed RomanNumeralCap type and added @remarks section.

[4.20.91] - 2025-10-12​

  • Updated tsdoc for fromNow() Chronos method: modified @remarks section.

[4.20.90] - 2025-10-12​

  • Updated formatUnitWithPlural utility: now returns singular unit for both 0 and 1.
  • Updated fromNow() Chronos method: fixed issues when provided unit level value is 0.

[4.20.89] - 2025-10-12​

  • Updated behavior of fromNow() Chronos method: excluded week level and included millisecond for consistency. Refactored internal logic.

[4.20.88] - 2025-10-11​

  • Added new utility romanToInteger and its aliases to convert Roman numerals to Arabic numeric representation and updated input validation for convertToRomanNumerals.
  • Added new utility type Repeat to repeat literal string, it works like String.prototype.repeat() but on type-level.

[4.20.87] - 2025-10-08​

  • Added new constants and types related to country information, e.g. full country name, code, ISO code etc.

[4.20.86] - 2025-10-08​

  • Added new number utility getFactors and its alias to calculate factors of a given number (integer).

[4.20.84] - 2025-10-07​

  • Added new number utility factorial and its alias to calculate factorial of a given number (integer).

[4.20.80] - 2025-10-07​

🕧 Updates in Chronos​

  • Added overload signatures for isWeekend, isWorkDay and isBusinessHour methods from businessPlugin.
  • Fixed issues with isBusinessHour: previously skipped business start and end hours in some cases.
  • Added new utility type RangeTuple to create ranged tuple.

[4.20.69-70] - 2025-10-07​

🕧 Updates in Chronos​

  • Added alias for some methods available through plugins: greet for getGreeting, getSeasonName for season, zodiac for getZodiacSign
  • Updated behaviors of isWeekend, isWorkDay and isBusinessHour methods from businessPlugin, now accepts indices of weekend day as tuple.
  • Updated internal states for most of the plugins; Renamed some internal types and exposed some.

[4.20.66] - 2025-10-05​

  • Updated isObjectWithKeys: now returns more structured object shape with provided keys.

[4.20.64] - 2025-10-05​

  • Updated extractObjectKeys: now have overload signatures, returns a tuple or an array of keys (string literal).
  • Updated extractObjectKeysDeep no longer returns a tuple, instead now it returns an array of keys (string literal).

[4.20.60] - 2025-10-04​

  • Added new utility types ArrayToTuple<T[]> and Tuple<T>.
  • Updated the return type of extractObjectKeys, now it returns tuple of exact top-level keys.
  • Added new utility extractObjectKeysDeep to extract tuple of all nested keys.
  • Updated query string parser utilities to receive generic return type.
  • Added new utility literalQueryStringToObject to parse literal query string.

[4.20.56] - 2025-10-02​

  • Updated isDeepEqual utility: Now it accepts arguments of unknown types.

[4.20.54] - 2025-10-02​

  • Added new utility extractObjectKeys to extract keys of an object with proper typing.
  • Updated isObjectWithKeys: now properly typed.

[4.20.52] - 2025-09-26​

  • Added new Chronos plugin greetingPlugin for accessing getGreeting method in Chronos instances.
  • Fixed some docs and internal type related issues in convertObjectValues utility.

[4.20.50] - 2025-09-25​

  • Fixed return type of convertObjectValues utility to correctly reflect the transformed object structure and keys option is now more strict: only accepts keys which values are string and/or number and the array cannot be left empty.
  • Updated options type for with() static method of Chronos.

[4.20.48] - 2025-09-22​

  • Wrapped ChronosMethods type in LooseLiteral to allow passing custom method names without type errors when creating a custom Chronos Plugin.
  • Updated error message in convert method in Currency class.

[4.20.46] - 2025-09-22​

  • Chronos class is now exported via subpath 'nhb-toolbox/chronos'.

[4.20.44] - 2025-09-20​

  • Updated type related issues in Finder class. Now it accepts array of objects only.

[4.20.40] - 2025-09-18​

  • Added new utility types: DeepPartialAll, Join,Split along with ValidArray, List and more.

[4.20.32] - 2025-09-17​

  • Renamed isPastParticiple() method to isParticiple() in Verbalizer/verbalizer.
  • Optimized internal logic for toPast() and toParticiple() methods in Verbalizer/verbalizer.
  • Updated all the rules for Verbalizer/verbalizer.

[4.20.30] - 2025-09-17​

  • Reduced unpacked size by removing tsdoc comments from js (both cjs and esm) outputs.
  • Updated tsdoc for Verbalizer/verbalizer: added reference to documentation site.

[4.20.27] - 2025-09-16​

  • Fixed issues: (failed to convert already past/participle regular verbs) with toPast() and toParticiple() methods in Verbalizer/verbalizer.

[4.20.26] - 2025-09-16​

  • Optimized internal logic in both Pluralizer and Verbalizer.

[4.20.24] - 2025-09-15​

  • Added new class Verbalizer and its shared instance verbalizer for verb form(s) manipulation.
  • Updated Pluralizer/pluralizer's internal mechanism to trim input(s) and output(s).

[4.20.20] - 2025-09-04​

🎨 Updates for Stylog/LogStyler​

  • Reorganized full stylog module.
  • Renamed string() method to toANSI() and applyStyles() to toCSS().
  • Added new ansi16() method to apply ANSI-16 color codes.
  • Added new hsl() and bgHSL() methods to colorize using custom hsl color values.
  • Added new rgb() and bgRGB() methods to colorize using custom rgb color values.
  • Added new hex() and bgHex() methods to colorize using custom hex color values.

[4.20.17] - 2025-09-02​

  • Added color support detector for shell/console for Stylog/LogStyler.

[4.20.16] - 2025-09-01​

  • Added new method string() in LogStyler (also in Stylog) and made applyStyles() method public.

[4.20.11] - 2025-09-01​

  • Added new Symbol methods in Chronos: Symbol.isConcatSpreadable and Symbol.match.
  • Fixed string coercion issues with toPrimitive Symbol method in Chronos.
  • Redesigned chronos (Chronos wrapper) with Proxy and updated TSDoc for chronos.

[4.20.10] - 2025-09-01​

  • Added new utility types: RequireAtLeast, RequireExactly, RequireBetween.
  • Added new static Chronos method Chronos.with(options) to create Chronos instance from specified time component(s).

[4.20.1] - 2025-08-31​

  • Exported helper function and guards used for Stylog and LogStyler: hexToAnsi, isCSSColor, isBGColor, isTextStyle.

[4.20.0] - 2025-08-31​

  • Added new class LogStyler and its chainable Stylog utility to log styled input in the console.

[4.14.16] - 2025-08-30​

  • Updated types related to object flattening utilities: FlattenDotKey, DotValue, FlattenDotValue, FlattenLeafKey, LeafValue and FlattenLeafValue.
  • Made all the (output) properties of FlattenDotValue and FlattenLeafValue optional to avoid issues.

[4.14.14] - 2025-08-27​

  • Updated DeepPartial type to preserve optional properties of advanced types like File, FileList, Chronos etc.

[4.14.13] - 2025-08-24​

  • Updated return type for getColorForInitial utility and improved internal logic and error type for color generator utilities.

[4.14.12] - 2025-08-23​

  • Updated error type for trimString utility.

[4.14.10] - 2025-08-17​

  • Added new utility wordsToNumber utility with alias: convertWordsToNumber, convertWordToNumber and wordToNumber

[4.14.9] - 2025-08-16​

  • Fixed minor internal issues and updated JSDoc for Pluralizer.

[4.14.4-8] - 2025-08-13 - 2025-08-14​

  • Updated internal logic of convertStringCase utility, added new options parameter.
  • Fixed multiple internal issues and JSDoc; Optimized internal logic.

[4.14.1-3] - 2025-08-11 - 2025-08-12​

  • Updated JSDoc, dev dependencies and fixed minor issues.

[4.14.0] - 2025-08-11​

  • Added new class HttpStatus for retrieving and managing HTTP status codes.

[4.13.11] - 2025-08-06​

  • Fixed an issue with getZodiacSign method in Chronos that could not return correct Vedic sign.

[4.13.10] - 2025-08-02​

  • Updated docs for isPlural and isSingular methods in Pluralizer.
  • Updated getTimeZoneName() and getTimeZoneNameShort() methods in Chronos to accept an optional UTC offset.
  • Changed return type of getTimeZoneName() to string | UTCOffset using LooseLiteral<UTCOffset>.

[4.13.9] - 2025-07-31​

  • Added new Chronos method getTimeZoneName() to get full time-zone name.
  • Added new Chronos timeZonePlugin method getTimeZoneNameShort() to get abbreviated time-zone name.

[4.13.7] - 2025-07-23​

  • Updated isPlural and isSingular methods in Pluralizer class to handle more cases.
  • Ran full test on pluralizer and fixed some known issues.

[4.13.3-6] - 2025-07-22​

  • Reordered rules for pluralizer and fixed other issues.

[4.13.3] - 2025-07-22​

  • Updated pluralization/uncountable rules, case restoration method and fixed other bugs in pluralizer.
  • Updated docs for pluralizer, Pluralizer and formatUnitWithPlural.

[4.13.1] - 2025-07-22​

  • Updated docs in README for pluralizer.

[4.13.0] - 2025-07-22​

  • Added new Pluralizer class and utility pluralizer (shared instance of Pluralizer class) with multiple methods.
  • Refactored codes in number utilities, introduced new normalizeNumber utility.

[4.12.80-81] - 2025-07-19​

  • Updated convertArrayToString to accept array of any primitive values.
  • Fully integrated with nhb-scripts.

[4.12.70] - 2025-07-08​

  • Updated numeric string related issues, specifically in isNumber & isNumericString and other helper functions.

[4.12.68-69] - 2025-07-05​

  • Updated Docs: Added links to other npm packages.

[4.12.67] - 2025-07-03​

  • Fixed some import alias typo.

[4.12.66] - 2025-07-02​

  • Updated convertArrayToString function, now accepts array of objects and have 2 overload signatures with options.
  • Updated RenameKeys utility type by fixing some minor issues.

[4.12.64] - 2025-07-02​

  • Added more utility types.
  • Updated JSDoc for some Chronos methods.

[4.12.61] - 2025-06-28​

  • Added new utility type Expand<T> to resolve complex helper-wrapped types into readable structures, similar to Prettify<T> but only for special types to use with.
  • Improved type display for special cases where types were previously wrapped in multiple utility layers (e.g., MergeAll, FlattenValue etc.).

[4.12.60] - 2025-06-27​

  • Added new array utilities:

    • sumByField
    • averageByField
    • sumFieldDifference
    • groupAndSumByField
    • groupAndAverageByField

  • Updated splitArrayByProperty utility to allow nested field as dot-notation.

[4.12.50] - 2025-06-27​

  • Updated return type definition and enhanced internal logic for mergeObjects, mergeAndFlattenObjects, flattenObjectKeyValue, flattenObjectDotNotation.
  • Created new utility types for the mentioned utilities.

[4.12.48] - 2025-06-24​

  • Fixed typo for utility name splitArrayByProperty.
  • Added new utilities getInstanceGetterNames and getStaticGetterNames;
  • Updated getClassDetails and its return type.

[4.12.46] - 2025-06-24​

  • Added new utilities spitArrayByProperty splitArrayByProperty and deleteFields.

[4.12.44] - 2025-06-23​

  • Updated getDatesInRange() method in Chronos: fixed an option conflict.

[4.12.43] - 2025-06-22​

  • Updated getDatesInRange() method in Chronos, now accepts both day-names and day-index array for skipDays and onlyDays.
  • Updated JSDoc for some functions and methods.

[4.12.42] - 2025-06-21​

  • Updated JSDoc for some functions and methods.
  • Updated and Optimized getDatesInRange() method in Chronos. Added new option onlyDays to get dates for only the provided days.
  • Allowed formatStrict() method in Chronos to accept other string values [made less strict].

[4.12.41] - 2025-06-17​

  • Updated getDatesInRange() and getDatesForDay() Chronos methods' options to change the date rounding behaviour.

[4.12.40] - 2025-06-17​

  • Added new utility: convertMinutesToTime to convert minutes into clock-time (H:mm) format.
  • Exposed important constants to consumers via 'nhb-toolbox/constants' import path.

🕧 Updates for Chronos​

  • Added new instance method getDatesInRange() to get dates in the range as ISO date string.
  • Fixed a bug by rounding the date to the start hour of the day and updated internal logic in static getDatesForDay() method.

[4.12.36] - 2025-06-13​

  • Added new convertSync() method in Currency class to convert currency without network request.

[4.12.34-35] - 2025-06-12​

  • Updated format() and convert() methods in Currency class:
    • format() method now accepts CurrencyCode as optional second parameter
    • convert() method now returns a new Currency instance.

[4.12.33] - 2025-06-11​

  • Trim input string for numberToWordsOrdinal utility.
  • Preserve File, FileList and other file related object(s) when processing nested object(s) using sanitizeData.

[4.12.32] - 2025-06-11​

  • Fixed a bug in sanitizeData and createFormData where key selections did not allow to choose keys with null/undefined value(s).
  • Fixed a bug in createFormData where values of nested object(s) incorrectly converted to lowercase. Process date-like object(s) more efficiently in both utilities.

[4.12.31] - 2025-06-10​

  • Added new utility to convert number or numeric string to ordinal word.
  • Updated JSDoc for some types.
  • Upgraded TypeScript version to 5.8.3 and other dev-dependencies.

[4.12.28-30] - 2025-06-06​

  • Resolved a compile-time not-assignable error that occurred when optional properties were present in parameters of sanitizeData, createFormData, and other utility functions.
  • Added additional utility types and integrated them into various parts of the package to improve type safety and maintainability.

[4.12.27] - 2025-06-02​

  • Updated README.
  • Added new utility types, can be imported from 'nhb-toolbox/utils/types'.

[4.12.25-26] - 2025-06-02​

  • Updated JSDoc for some Chronos methods and exposed INTERNALS Symbol

[4.12.24] - 2025-06-01​

🕧 Updates for Chronos​

  • Reduced bloat by moving rarely used Chronos methods to plugin system.
  • Changed plugin import paths as import { somePlugin } from nhb-toolbox/plugins/somePlugin format so the users can assume the path easily.
  • Updated parameter type for isBusinessHour method: instead of multiple parameters can accept one options object now.

[4.12.23] - 2025-06-01​

🕧 Updates for Chronos​

  • All plugin imports now use statement like import { somePlugin } from 'nhb-toolbox/plugins/plugin-path';
  • Updated getZodiacSign method: includes 2 presets western and vedic with aliases tropical and sidereal.
  • Fixed issues in getZodiacSign method which previously could not parse some date/month range.

[4.12.21-beta.2] - 2025-05-31​

  • Updated types.mjs script for updating the exports fields for plugins in package.json.

[4.12.21-beta.1] - 2025-05-31​

  • Updated getZodiacSign method: includes 2 presets western and vedic.
  • Fixed issues in getZodiacSign method.
  • Experimenting with exporting each Chronos plugin as separate module from the respective locations.

[4.12.20] - 2025-05-31​

🕧 Released Plugin System for Chronos​

  • Plugin injection system for Chronos is now fully functional.

[4.12.13-beta.1] - 2025-05-31​

  • Created more plugins for resource heavy methods of Chronos.

[4.12.13-alpha.2] - 2025-05-30​

  • Solved experimental plugin export/import issues.

[4.12.13-alpha.1] - 2025-05-30​

🕧 Experimenting with Plugin System for Chronos​

  • Introduced plugin injection in Chronos class. Started with season method. Will make convert more methods if this is successful after publishing.

[4.12.12] - 2025-05-30​

🕧 Updates in Chronos​

  • Added new method season to get the name of the season for current Chronos instance. It has configurable options.
  • All Chronos methods that use #format method internally now accepts escape tokens and new token ZZ is introduced to include timezone offset (or Z for UTC time) in the formatted date string.
  • Updated some type names such as Hours ➡ī¸ ClockHour, Minutes ➡ī¸ ClockMinute, Time ➡ī¸ ClockTIme etc. But the core definitions remain the same.

[4.12.10] - 2025-05-30​

🕧 New Chronos Methods​

  • Added 2 new instance methods in Chronos, day and monthName to get day and month names respectively.

ℹī¸ README​

  • Added Signature Utilities section in README.md

[4.12.8] - 2025-05-29​

Types​

  • Added new types Enumerate and NumberRange to generate number literals like 0 | 1 | 2 | ... | 998.
  • Implemented both types in few cases where a return type is number and limited to a range, especially in color and number related functions and Color & Chronos classes.

Method Changed in Chronos​

  • isoWeekday is now isoWeekDay
  • Some method logic changed internally

[4.12.7] - 2025-05-28​

Docs​

  • ➕ Introduced CHANGELOG.md

[4.12.6] - 2025-05-28​

Added​

  • ➕ Chronos.getDatesFromDay() — a new static method to retrieve all matching dates for a given day of the week.

Fixed​

  • 🐛 Minor internal issues and stability improvements.

[4.12.0] - 2025-05-28​

⚠ī¸ Breaking Changes​

  • ⚠ī¸ Deprecation Notice: All versions below 4.12.0 are now marked as deprecated
  • â™ģī¸ Build System: Switched from tsup back to tsc for building the library to resolve compatibility and output issues.

Fixed​

  • 🛠ī¸ Resolved ESM import issues by adding missing .js extensions in internal paths.
  • 🧩 Improved module resolution in strict ESM-only environments.

Improved​

  • 🌲 Full tree-shaking support for ESM builds (CommonJS remains unaffected).
    • 🌲 From the beginning the library was tree-shakable but now it's properly tree-shakable for ESM builds.
    • đŸ“Ļ CommonJS (cjs) build remains unaffected and stable.