nhb-toolbox 4.10.47 → 4.10.50

package/README.md

@@ -10,7 +10,7 @@
     <img src="https://img.shields.io/npm/v/nhb-toolbox.svg?style=for-the-badge&color=teal" alt="Version" />
   </a>
   <a href="https://www.npmjs.com/package/nhb-toolbox" aria-label="License">
-    <img src="https://img.shields.io/npm/l/nhb-toolbox.svg?label=license&style=for-the-badge&color=gold" alt="License" />
+    <img src="https://img.shields.io/npm/l/nhb-toolbox.svg?label=license&style=for-the-badge&color=orange" alt="License" />
   </a>
 </p>
 
@@ -21,7 +21,7 @@
 - **Helper Functions & Classes**: Reusable solutions for everyday tasks
 - **Type Guards & Predicates**: Runtime safety with perfect type inference
 - **Validation Utilities**: Robust data validation patterns
-- **Zero Dependencies**: Lightweight and framework-agnostic
+- **Zero Dependencies**: Framework-agnostic implementation using only native TS/JS with 0 external package
 
 > [Explore Full Documentation →](https://nhb-toolbox.vercel.app/)
 
@@ -49,7 +49,7 @@ yarn add nhb-toolbox
 
 - **Type-Safe Utilities**:Fully typed for perfect TypeScript integration with strict type checking
 - **Modular Design**: Tree-shaking friendly – import only what you need with zero bloat
-- **Zero Dependencies**: Lightweight and framework-agnostic
+- **Zero Dependencies**: No external dependencies - works with any JS/TS framework
 - **IDE Support**: Full type hints with JSDoc-powered API references in your editor
 - **Comprehensive Documentation**: Learn with real-world use cases on [documentation site](https://nhb-toolbox.vercel.app/)
 - **Battle-Tested**: Reliable utilities refined through real-world production use

package/dist/cjs/array/transform.js

@@ -7,6 +7,7 @@ exports.findMissingElements = findMissingElements;
 exports.splitArray = splitArray;
 exports.rotateArray = rotateArray;
 exports.moveArrayElement = moveArrayElement;
+const primitives_1 = require("../guards/primitives");
 const utils_1 = require("../utils");
 /**
  * * Converts an array of objects into a formatted array of options.
@@ -16,10 +17,12 @@ const utils_1 = require("../utils");
  * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
  */
 const createOptionsArray = (data, config) => {
-    const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', } = config || {};
-    if (data && data.length) {
-        return data.map((datum) => ({
-            [firstFieldName]: String(datum[firstFieldKey] ?? ''),
+    const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', numberAsNumber = false, } = config || {};
+    if (data && data?.length) {
+        return data?.map((datum) => ({
+            [firstFieldName]: numberAsNumber && (0, primitives_1.isNumber)(datum[firstFieldKey]) ?
+                datum[firstFieldKey]
+                : String(datum[firstFieldKey] ?? ''),
             [secondFieldName]: String(datum[secondFieldKey] ?? ''),
         }));
     }

package/dist/dts/array/transform.d.ts

@@ -7,7 +7,7 @@ import type { OptionsConfig } from './types';
  * @param config - The configuration object to specify the keys for the `value` (firstFieldName) and `label` (secondFieldName) fields and rename as needed.
  * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
  */
-export declare const createOptionsArray: <T extends GenericObject, K1 extends string = "value", K2 extends string = "label">(data: T[], config: OptionsConfig<T, K1, K2>) => { [P in K1 | K2]: string; }[];
+export declare const createOptionsArray: <T extends GenericObject, K1 extends string = "value", K2 extends string = "label", V extends boolean = false>(data: T[], config: OptionsConfig<T, K1, K2, V>) => Array<{ [P in K1 | K2]: P extends K1 ? V extends true ? T[OptionsConfig<T, K1, K2, V>["firstFieldKey"]] extends string ? string : number : string : string; }>;
 /**
  * * Removes duplicate values from an array, supporting deep comparison for objects and arrays.
  *

package/dist/dts/array/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/array/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,aAAa,EACvB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,kBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC9B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAE,EAgB5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAgBhD;AAED;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACvC,MAAM,EAAE,CAAC,EAAE,EACX,MAAM,EAAE,CAAC,EAAE,EACX,WAAW,EAAE,YAAY,GAAG,aAAa,GACvC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAKX;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAQhE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAQ3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,GAAG,EAAE,CAAC,EAAE,EACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACb,CAAC,EAAE,CAQL"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/array/transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,aAAa,EACvB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,YACjB,CAAC,SAAS,OAAO,gBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KACjC,KAAK,CAAC,GACP,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,GAC3B,CAAC,SAAS,IAAI,GACb,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,SAAS,MAAM,GAC7D,MAAM,GACL,MAAM,GACP,MAAM,GACP,MAAM,GACR,CAwCA,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAgBhD;AAED;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACvC,MAAM,EAAE,CAAC,EAAE,EACX,MAAM,EAAE,CAAC,EAAE,EACX,WAAW,EAAE,YAAY,GAAG,aAAa,GACvC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAKX;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAQhE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAQ3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,GAAG,EAAE,CAAC,EAAE,EACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACb,CAAC,EAAE,CAQL"}

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

@@ -9,30 +9,48 @@ export type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
  * @typeParam T - The type of the objects in the input array.
  * @typeParam K1 - The name of the key for the first field in the output (default: `'value'`).
  * @typeParam K2 - The name of the key for the second field in the output (default: `'label'`).
+ * @typeParam V - Whether to keep the `value` field as number if it is a number. Defaults to `false`.
  */
-export interface OptionsConfig<T, K1, K2> {
+export interface OptionsConfig<T, K1, K2, V extends boolean = false> {
     /**
      * - The key in the input objects to use for the first field of the option.
-     * @example If the input objects have an `id` field and you want to use it as the `value` field in the output, set createOptionsArray(data, {firstFieldKey: 'id'}).
+     * @example
+     * // If the input objects have an `id` field and you want to use it as the `value` field in the output:
+     * createOptionsArray(data, {firstFieldKey: 'id'}).
      */
     firstFieldKey: PrimitiveKey<T>;
     /**
      * - The key in the input objects to use for the second field of the option.
-     * @example If the input objects have a `name` field and you want to use it as the `label` field in the output, set createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name'}).
+     * @example
+     * // If the input objects have a `name` field and you want to use it as the `label` field in the output:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name'}).
      */
     secondFieldKey: PrimitiveKey<T>;
     /**
      * - The name of the first field in the output object.
      * - Defaults to `'value'`.
-     * @example If you want the output field to be named `'key'` instead of `'value'`, set createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key'}).
+     * @example
+     * // If you want the output field to be named `'key'` instead of `'value'`:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key'}).
      */
     firstFieldName?: K1;
     /**
      * - The name of the second field in the output object.
      * - Defaults to `'label'`.
-     * @example If you want the output field to be named `'title'` instead of `'label'`, set createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key', secondFieldName: 'title'}).
+     * @example
+     * // If you want the output field to be named `'title'` instead of `'label'`:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key', secondFieldName: 'title'}).
      */
     secondFieldName?: K2;
+    /**
+     * - If `true`, and the value from `firstFieldKey` is a number if it is originally number, it will be retained as a number.
+     * - Otherwise, all values are converted to strings.
+     * Defaults to `false`.
+     * @example
+     * // Set `numberAsNumber: true` to keep numeric values (like `id`) as numbers instead of strings.
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', numberAsNumber: true}).
+     */
+    numberAsNumber?: V;
 }
 /** * Option for sorting order. */
 export interface OrderOption {

package/dist/dts/array/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/array/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,uCAAuC;AACvC,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;IACvC;;;OAGG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE/B;;;OAGG;IACH,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,WAAW;IACzE,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IAC1B,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACvC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uFAAuF;IACvF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2GAA2G;IAC3G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kEAAkE;IAClE,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/array/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,uCAAuC;AACvC,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,SAAS,OAAO,GAAG,KAAK;IAClE;;;;;OAKG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;IAErB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,WAAW;IACzE,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IAC1B,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACvC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uFAAuF;IACvF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2GAA2G;IAC3G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kEAAkE;IAClE,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACzB"}

package/dist/esm/array/transform.js

@@ -1,3 +1,4 @@
+import { isNumber } from '../guards/primitives';
 import { isDeepEqual } from '../utils';
 /**
  * * Converts an array of objects into a formatted array of options.
@@ -7,10 +8,12 @@ import { isDeepEqual } from '../utils';
  * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
  */
 export const createOptionsArray = (data, config) => {
-    const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', } = config || {};
-    if (data && data.length) {
-        return data.map((datum) => ({
-            [firstFieldName]: String(datum[firstFieldKey] ?? ''),
+    const { firstFieldKey, secondFieldKey, firstFieldName = 'value', secondFieldName = 'label', numberAsNumber = false, } = config || {};
+    if (data && data?.length) {
+        return data?.map((datum) => ({
+            [firstFieldName]: numberAsNumber && isNumber(datum[firstFieldKey]) ?
+                datum[firstFieldKey]
+                : String(datum[firstFieldKey] ?? ''),
             [secondFieldName]: String(datum[secondFieldKey] ?? ''),
         }));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.10.47",
+  "version": "4.10.50",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -157,7 +157,7 @@
     "lint": "node scripts/lint.mjs",
     "fix": "node scripts/fix.mjs",
     "commit": "node scripts/commit.mjs",
-    "count": "node scripts/exports.mjs",
+    "count": "node scripts/count.mjs",
     "types": "node scripts/types.mjs"
   }
 }