nhb-toolbox 4.25.0 → 4.25.4

package/CHANGELOG.md

@@ -6,6 +6,11 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.25.1-4] - 2025-11-04
+
+- **Added** *alias* for `Chronos` *static method* `use`: `register`.
+- **Updated** *tsdoc* for `Chronos` *static methods* `use` and `register`.
+
 ## [4.25.0] - 2025-11-03
 
 - **Added** new `Chronos` method `durationString(...)` and **Fixed** issues with internal *duration normalization logic*.

package/dist/cjs/date/Chronos.js

@@ -1008,6 +1008,9 @@ class Chronos {
             plugin(_a);
         }
     }
+    static register(plugin) {
+        _a.use(plugin);
+    }
 }
 exports.Chronos = Chronos;
 _a = Chronos;

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

@@ -770,8 +770,25 @@ export declare class Chronos {
      * @static Injects a plugin into the `Chronos` system.
      * @param plugin The plugin to inject.
      *
+     * @remarks
+     * - Using this (`use`) method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * 	- To prevent this incorrect *linter error* in `React` projects, prefer using {@link register} method (alias `use` method).
+     *
      * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
      * - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
      */
     static use(plugin: ChronosPlugin): void;
+    /**
+     * @static Registers a plugin into the `Chronos` system.
+     * @param plugin The plugin to register.
+     *
+     * @remarks
+     * - This is just an alias for {@link use} method.
+     * - Using {@link use} method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * 	- To prevent this incorrect *linter error* in `React` projects, prefer using this (`register`) method over {@link use} method.
+     *
+     * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
+     * - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
+     */
+    static register(plugin: ChronosPlugin): void;
 }

package/dist/dts/date/chronos-statics.d.ts

@@ -87,10 +87,27 @@ export interface ChronosStatics {
      * @static Injects a plugin into the `Chronos` system.
      * @param plugin The plugin to inject.
      *
+     * @remarks
+     * - Using this (`use`) method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * 	- To prevent this incorrect *linter error* in `React` projects, prefer using {@link register} method (alias `use` method).
+     *
      * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
-     * - See full list of plugins and the methods they register {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins here}.
+     * - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
      */
     use(plugin: ChronosPlugin): void;
+    /**
+     * @static Registers a plugin into the `Chronos` system.
+     * @param plugin The plugin to register.
+     *
+     * @remarks
+     * - This is just an alias for {@link use} method.
+     * - Using {@link use} method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * 	- To prevent this incorrect *linter error* in `React` projects, prefer using this (`register`) method over {@link use} method.
+     *
+     * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
+     * - See {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins full list of plugins and the methods they register}.
+     */
+    register(plugin: ChronosPlugin): void;
     /**
      * * Returns the current date and time in a specified format in local time.
      * * Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55`

package/dist/esm/date/Chronos.js

@@ -1005,5 +1005,8 @@ export class Chronos {
             plugin(_a);
         }
     }
+    static register(plugin) {
+        _a.use(plugin);
+    }
 }
 _a = Chronos;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.25.0",
+  "version": "4.25.4",
   "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",
@@ -39,12 +39,12 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@eslint/js": "^9.39.0",
+    "@eslint/js": "^9.39.1",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.9.2",
-    "@typescript-eslint/eslint-plugin": "^8.46.2",
-    "@typescript-eslint/parser": "^8.46.2",
-    "eslint": "^9.39.0",
+    "@types/node": "^24.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.3",
+    "@typescript-eslint/parser": "^8.46.3",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "globals": "^16.5.0",
@@ -56,7 +56,7 @@
     "ts-jest": "^29.4.5",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.2"
+    "typescript-eslint": "^8.46.3"
   },
   "keywords": [
     "toolbox",