nhb-toolbox 0.9.3 → 0.9.5

package/dist/array/index.d.ts

@@ -0,0 +1,20 @@
+import type { Flatten, SelectOptions } from './types';
+/**
+ * * Flattens a nested array recursively or wraps any non-array data type in an array.
+ *
+ * @typeParam T : The type of the input, which can be a nested array or a non-array value.
+ * @param input - The input value, which can be a nested array or a non-array value.
+ * @returns A fully flattened array of type `Flatten<T>`. If the input is not an array, it wraps it in a single-element array.
+ */
+export declare const flattenArray: <T>(input: T | T[]) => Flatten<T>[];
+/**
+ * * Converts an array of objects into a formatted array of select options.
+ *
+ * @typeParam T - The type of each object in the `data` array.
+ * @param data - An array of objects to convert into select options.
+ * @param valueKey - The key in each object to use as the `value` field in the select options.
+ * @param labelKey - The key in each object to use as the `label` field in the select options.
+ * @returns An array of select options, where each option has a `value` and `label` field.
+ */
+export declare const createSelectOptions: <T extends Record<string, string | number | null | undefined>>(data: T[], valueKey: keyof T, labelKey: keyof T) => SelectOptions[];
+//# sourceMappingURL=index.d.ts.map

package/dist/array/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,CAAC,EAO1D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,QAEtD,CAAC,EAAE,YACC,MAAM,CAAC,YACP,MAAM,CAAC,KACf,aAAa,EASf,CAAC"}

package/dist/array/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSelectOptions = exports.flattenArray = void 0;
+/**
+ * * Flattens a nested array recursively or wraps any non-array data type in an array.
+ *
+ * @typeParam T : The type of the input, which can be a nested array or a non-array value.
+ * @param input - The input value, which can be a nested array or a non-array value.
+ * @returns A fully flattened array of type `Flatten<T>`. If the input is not an array, it wraps it in a single-element array.
+ */
+const flattenArray = (input) => {
+    if (!Array.isArray(input))
+        return [input];
+    return input.reduce((acc, item) => {
+        // If item is an array, recursively flatten it; otherwise, add it directly.
+        return acc.concat(Array.isArray(item) ? (0, exports.flattenArray)(item) : [item]);
+    }, []);
+};
+exports.flattenArray = flattenArray;
+/**
+ * * Converts an array of objects into a formatted array of select options.
+ *
+ * @typeParam T - The type of each object in the `data` array.
+ * @param data - An array of objects to convert into select options.
+ * @param valueKey - The key in each object to use as the `value` field in the select options.
+ * @param labelKey - The key in each object to use as the `label` field in the select options.
+ * @returns An array of select options, where each option has a `value` and `label` field.
+ */
+const createSelectOptions = (data, valueKey, labelKey) => {
+    if (data && data.length) {
+        return data.map((datum) => ({
+            value: String(datum[valueKey] ?? ''),
+            label: String(datum[labelKey] ?? ''),
+        }));
+    }
+    else {
+        return [];
+    }
+};
+exports.createSelectOptions = createSelectOptions;

package/dist/array/types.d.ts

@@ -0,0 +1,9 @@
+/** - Flatten Array */
+export type Flatten<T> = T extends (infer U)[] ? Flatten<U> : T;
+/** - Select Options */
+export interface SelectOptions {
+    value: string;
+    label: string;
+}
+/**  */
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/array/types.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEhE,uBAAuB;AACvB,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED,OAAO"}

package/dist/array/types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**  */
+// export interface 

package/dist/colors/types.d.ts

@@ -1,7 +1,8 @@
 /** - A string, number for generating color. */
 export type ColorInput = string | number;
 /** - An array of strings/numbers or nested arrays of strings/numbers for generating colors. */
-export type ColorInputArray = (ColorInput | ColorInputArray)[];
+export interface ColorInputArray extends Array<ColorInput | ColorInputArray> {
+}
 /** - Opacity options */
 export type OpacityValue = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100;
 //# sourceMappingURL=types.d.ts.map

package/dist/colors/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,+FAA+F;AAC/F,MAAM,MAAM,eAAe,GAAG,CAAC,UAAU,GAAG,eAAe,CAAC,EAAE,CAAC;AAE/D,wBAAwB;AACxB,MAAM,MAAM,YAAY,GACrB,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,GAAG,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,+FAA+F;AAC/F,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,UAAU,GAAG,eAAe,CAAC;CAAG;AAE/E,wBAAwB;AACxB,MAAM,MAAM,YAAY,GACrB,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,GAAG,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { capitalizeString, truncateString, generateRandomID } from './string';
 export { getColorForFirstCharacter } from './colors';
+export { flattenArray, createSelectOptions } from './array';
+export { generateQueryParams } from './object';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getColorForFirstCharacter = exports.generateRandomID = exports.truncateString = exports.capitalizeString = void 0;
+exports.generateQueryParams = exports.createSelectOptions = exports.flattenArray = exports.getColorForFirstCharacter = exports.generateRandomID = exports.truncateString = exports.capitalizeString = void 0;
 var string_1 = require("./string");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return string_1.capitalizeString; } });
 Object.defineProperty(exports, "truncateString", { enumerable: true, get: function () { return string_1.truncateString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return string_1.generateRandomID; } });
 var colors_1 = require("./colors");
 Object.defineProperty(exports, "getColorForFirstCharacter", { enumerable: true, get: function () { return colors_1.getColorForFirstCharacter; } });
+var array_1 = require("./array");
+Object.defineProperty(exports, "flattenArray", { enumerable: true, get: function () { return array_1.flattenArray; } });
+Object.defineProperty(exports, "createSelectOptions", { enumerable: true, get: function () { return array_1.createSelectOptions; } });
+var object_1 = require("./object");
+Object.defineProperty(exports, "generateQueryParams", { enumerable: true, get: function () { return object_1.generateQueryParams; } });

package/dist/object/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * * Utility function to generate query parameters from an object.
+ *
+ * @template T - A generic type extending `Record<string, string | number | string[] | number[]>`.
+ * @param params - Object containing query parameters.
+ * @returns A query string as a URL-encoded string, e.g., `?key1=value1&key2=value2`.
+ *
+ * @example
+ * generateQueryParams({ key1: 'value1', key2: 42 }); // "?key1=value1&key2=42"
+ * generateQueryParams({ key1: ['value1', 'value2'], key2: 42 }); // "?key1=value1&key1=value2&key2=42"
+ */
+export declare const generateQueryParams: <T extends Record<string, string | number | string[] | number[]>>(params?: T) => string;
+//# sourceMappingURL=index.d.ts.map

package/dist/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,WAEvD,CAAC,KACP,MAkBF,CAAC"}

package/dist/object/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateQueryParams = void 0;
+/**
+ * * Utility function to generate query parameters from an object.
+ *
+ * @template T - A generic type extending `Record<string, string | number | string[] | number[]>`.
+ * @param params - Object containing query parameters.
+ * @returns A query string as a URL-encoded string, e.g., `?key1=value1&key2=value2`.
+ *
+ * @example
+ * generateQueryParams({ key1: 'value1', key2: 42 }); // "?key1=value1&key2=42"
+ * generateQueryParams({ key1: ['value1', 'value2'], key2: 42 }); // "?key1=value1&key1=value2&key2=42"
+ */
+const generateQueryParams = (params = {}) => {
+    const queryParams = Object.entries(params)
+        .filter(([_, value]) => value !== undefined && value !== null)
+        .flatMap(([key, value]) => Array.isArray(value)
+        ? value.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(String(v))}`)
+        : `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
+        .join('&');
+    return queryParams ? `?${queryParams}` : '';
+};
+exports.generateQueryParams = generateQueryParams;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",