nhb-toolbox 2.7.0 → 2.7.2

package/dist/array/basics.d.ts

@@ -25,7 +25,7 @@ export declare const filterArrayOfObjects: <T extends GenericObject>(array: T[],
  * @param value - The value to check.
  * @returns `true` if the value is not an array, an empty array, or an array containing only `null`, `undefined`, empty objects, or empty arrays.
  */
-export declare const isValidEmptyArray: <T>(value: T | T[]) => boolean;
+export declare const isInvalidOrEmptyArray: <T>(value: T) => boolean;
 /**
  * * Shuffle the elements of an array.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,SACpD,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,GAAE,KACnE,CAAC,EAeH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,OAWrD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,EAW7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,GAAG,SAEvD,CAAC"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,SACpD,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,GAAE,KACnE,CAAC,EAeH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,CAAC,KAAG,OAWnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,EAW7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,GAAG,SAEvD,CAAC"}

package/dist/array/basics.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLastArrayElement = exports.shuffleArray = exports.isValidEmptyArray = exports.filterArrayOfObjects = exports.flattenArray = void 0;
+exports.getLastArrayElement = exports.shuffleArray = exports.isInvalidOrEmptyArray = exports.filterArrayOfObjects = exports.flattenArray = void 0;
 /**
  * * Flattens a nested array recursively or wraps any non-array data type in an array.
  *
@@ -45,7 +45,7 @@ exports.filterArrayOfObjects = filterArrayOfObjects;
  * @param value - The value to check.
  * @returns `true` if the value is not an array, an empty array, or an array containing only `null`, `undefined`, empty objects, or empty arrays.
  */
-const isValidEmptyArray = (value) => {
+const isInvalidOrEmptyArray = (value) => {
     if (!Array.isArray(value))
         return true;
     if (value.length === 0)
@@ -54,7 +54,7 @@ const isValidEmptyArray = (value) => {
         (Array.isArray(item) && item.length === 0) || // Empty array
         (typeof item === 'object' && Object.keys(item || {}).length === 0));
 };
-exports.isValidEmptyArray = isValidEmptyArray;
+exports.isInvalidOrEmptyArray = isInvalidOrEmptyArray;
 /**
  * * Shuffle the elements of an array.
  *
@@ -62,7 +62,7 @@ exports.isValidEmptyArray = isValidEmptyArray;
  * @returns Shuffled array.
  */
 const shuffleArray = (array) => {
-    if ((0, exports.isValidEmptyArray)(array))
+    if ((0, exports.isInvalidOrEmptyArray)(array))
         return array;
     const shuffled = structuredClone(array);
     for (let i = shuffled.length - 1; i > 0; i--) {

package/dist/form/convert.js

@@ -11,7 +11,7 @@ const basics_1 = require("../array/basics");
 const convertIntoFormData = (data) => {
     const formData = new FormData();
     Object.entries(data).forEach(([key, value]) => {
-        if (!(0, basics_1.isValidEmptyArray)(value) && value[0]?.originFileObj) {
+        if (!(0, basics_1.isInvalidOrEmptyArray)(value) && value[0]?.originFileObj) {
             formData.append(key, value[0].originFileObj);
         }
         else if (value !== undefined && value !== null && value !== '') {

package/dist/form/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/form/transform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,QACzD,CAAC,YACG,eAAe,CAAC,CAAC,CAAC,KAC1B,QAkIF,CAAC"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/form/transform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,QACzD,CAAC,YACG,eAAe,CAAC,CAAC,CAAC,KAC1B,QAwIF,CAAC"}

package/dist/form/transform.js

@@ -15,28 +15,26 @@ const guards_1 = require("./guards");
 const createControlledFormData = (data, configs) => {
     const formData = new FormData();
     const { stringifyNested = '*' } = configs || {};
-    /** Helper function to check if a key matches a dotNotation path to preserve. */
-    const shouldDotNotate = (fullKey) => {
-        if (Array.isArray(configs?.dotNotateNested)) {
-            return configs?.dotNotateNested?.some((path) => fullKey === path || fullKey.startsWith(`${path}.`));
-        }
-        return configs?.dotNotateNested === '*';
+    /** - Helper function to check if a key matches a dotNotation path to preserve. */
+    const shouldDotNotate = (key) => {
+        return Array.isArray(configs?.dotNotateNested) ?
+            configs.dotNotateNested.some((path) => key === path || key.startsWith(`${path}.`))
+            : configs?.dotNotateNested === '*';
     };
     /** - Helper function to check if a key matches a stringifyNested key. */
-    const shouldStringifyNested = (fullKey) => {
-        if (Array.isArray(stringifyNested)) {
-            return stringifyNested?.some((path) => fullKey === path || fullKey.startsWith(`${path}.`));
-        }
-        return stringifyNested === '*';
+    const shouldStringify = (key) => {
+        return Array.isArray(stringifyNested) ?
+            stringifyNested.some((path) => key === path || key.startsWith(`${path}.`))
+            : stringifyNested === '*';
     };
     /** - Helper function to check if a key matches a breakArray key. */
-    const shouldBreakArray = (fullKey) => {
-        if (Array.isArray(configs?.breakArray)) {
-            return configs?.breakArray?.some((path) => fullKey === path || fullKey.startsWith(`${path}.`));
-        }
-        return configs?.breakArray === '*';
+    const shouldBreakArray = (key) => {
+        return Array.isArray(configs?.breakArray) ?
+            configs.breakArray.some((path) => key === path || key.startsWith(`${path}.`))
+            : configs?.breakArray === '*';
     };
-    const addToFormData = (key, value) => {
+    /** * Helper function to add values to formData */
+    const _addToFormData = (key, value) => {
         const transformedKey = (configs?.lowerCaseKeys === '*' ||
             configs?.lowerCaseKeys?.includes(key)) ?
             key.toLowerCase()
@@ -52,10 +50,13 @@ const createControlledFormData = (data, configs) => {
                 formData.append(transformedKey, value.fileList[0].originFileObj);
             }
         }
-        else if (Array.isArray(value) && !(0, basics_1.isValidEmptyArray)(value)) {
+        else if (value instanceof Blob || value instanceof File) {
+            formData.append(transformedKey, value);
+        }
+        else if (Array.isArray(value) && !(0, basics_1.isInvalidOrEmptyArray)(value)) {
             if (shouldBreakArray(key)) {
                 value.forEach((item, index) => {
-                    addToFormData(`${transformedKey}[${index}]`, item);
+                    _addToFormData(`${transformedKey}[${index}]`, item);
                 });
             }
             else {
@@ -65,12 +66,12 @@ const createControlledFormData = (data, configs) => {
         else if (typeof value === 'object' &&
             value !== null &&
             !(0, basics_2.isEmptyObject)(value)) {
-            if (shouldStringifyNested(key) && !shouldDotNotate(key)) {
+            if (shouldStringify(key) && !shouldDotNotate(key)) {
                 formData.append(transformedKey, JSON.stringify(value));
             }
             else {
                 Object.entries(value).forEach(([nestedKey, nestedValue]) => {
-                    addToFormData(`${key}.${nestedKey}`, nestedValue);
+                    _addToFormData(`${key}.${nestedKey}`, nestedValue);
                 });
             }
         }
@@ -79,11 +80,14 @@ const createControlledFormData = (data, configs) => {
                 configs?.requiredKeys?.includes(key);
             const isNotNullish = value != null && value !== '';
             if (isNotNullish || isRequired) {
-                formData.append(transformedKey, value);
+                formData.append(transformedKey, typeof value === 'boolean' ?
+                    String(value)
+                    : String(value ?? ''));
             }
         }
     };
-    const processObject = (obj, parentKey = '') => {
+    /** - Helper to process object */
+    const _processObject = (obj, parentKey = '') => {
         Object.entries(obj).forEach(([key, value]) => {
             const fullKey = (parentKey ?
                 `${parentKey}.${key}`
@@ -97,23 +101,23 @@ const createControlledFormData = (data, configs) => {
             }
             // Check if this key is preserved
             if (shouldDotNotate(fullKey)) {
-                // If it's a preserved path, we need to append the value directly as the key
-                addToFormData(fullKey, value);
+                // If it's a preserved path, append the value directly
+                _addToFormData(fullKey, value);
             }
             else if (typeof value === 'object' &&
                 !Array.isArray(value) &&
                 value != null &&
                 !stringifyNested) {
                 // Process nested objects
-                processObject(value, key);
+                _processObject(value, key);
             }
             else {
                 // For other cases, just append as key-value
-                addToFormData(key, value);
+                _addToFormData(key, value);
             }
         });
     };
-    processObject(data);
+    _processObject(data);
     return formData;
 };
 exports.createControlledFormData = createControlledFormData;

package/dist/form/types.d.ts

@@ -1,46 +1,90 @@
 import type { DotNotationKey } from '../object/types';
-/** - Configuration options to control the formData. */
+/** - Configuration options to control FormData generation behavior. */
 export interface FormDataConfigs<T> {
-    /** - Keys to exclude from processing. Ignored keys are ignored even if they're in other options. */
+    /**
+     * * An array of dot-notation keys to exclude from processing.
+     * * Ignored keys are omitted entirely, even if included in other options.
+     */
     ignoreKeys?: DotNotationKey<T>[];
-    /** - Keys to preserve even if falsy. `*` to include all keys. */
+    /**
+     * * Specifies which keys should be included even if their values are falsy.
+     * * Use `*` to preserve all keys.
+     */
     requiredKeys?: '*' | DotNotationKey<T>[];
-    /**  - Keys to convert to lowercase. `*` to include all keys. */
+    /**
+     * * Defines which keys should be converted to lowercase.
+     * * Use `*` to apply to all keys.
+     */
     lowerCaseKeys?: '*' | DotNotationKey<T>[];
-    /** - Dot-notation paths to preserve (e.g., 'user.settings'). `*` to include all keys. In this case `user` is an object and `settings` should also be an object. If `dotNotateNested` and `stringifyNested` both have the same key(s) or `*` it will prioritize `dotNotateNested`. */
+    /**
+     * * An array of dot-notation paths to preserve in their original structure.
+     * - Example: `'user.settings'` ensures `user` remains an object, and `settings` is not flattened.
+     * - Use `*` to preserve all keys in their dot-notation format.
+     * - If a key exists in both `dotNotateNested` and `stringifyNested`, `dotNotateNested` takes precedence.
+     */
     dotNotateNested?: '*' | DotNotationKey<T>[];
-    /** - Dot-notation paths to stringify nested objects instead of flattening or dot-notate them. Defaults to `*`, use `*` to stringify every nested object. In this case the value of the last part of the key should also be an object. If `dotNotateNested` and `stringifyNested` both have the same key(s) or `*` it will prioritize `dotNotateNested`. */
+    /**
+     * * Specifies which nested objects should be stringified instead of being flattened or dot-notated.
+     * - Defaults to `*`, meaning all nested objects will be stringified. Which is standard in modern form submissions.
+     * - Use `*` to stringify all nested objects.
+     * - If a key exists in both `dotNotateNested` and `stringifyNested`, `dotNotateNested` takes precedence.
+     */
     stringifyNested?: '*' | DotNotationKey<T>[];
-    /** - Break arrays in the format `{key[0]: value, key[0]: value,}` for specific key(s) or for all (`*`). `*` to include all keys. */
+    /**
+     * * Controls how arrays should be serialized in FormData.
+     * - If a key is included, the array will be broken into individual key-value pairs (`key[0]: value, key[1]: value`).
+     * - Use `*` to apply this behavior to all array keys.
+     */
     breakArray?: '*' | DotNotationKey<T>[];
-    /** - Whether to trim string values */
+    /** - Enables automatic trimming of string values before appending them to FormData. */
     trimStrings?: boolean;
 }
-/** - Interface for file-type in some upload libraries like `FilePond` or `Ant-Design's Upload` */
+/** * Represents a file upload operation, commonly used in libraries like `FilePond` or `Ant Design Upload`. */
 export interface FileUpload {
+    /** The primary file being uploaded. */
     file: CustomFile;
+    /** The list of files associated with the upload. */
     fileList: CustomFile[];
 }
+/** * Represents a custom file structure used in file upload components. */
 export interface CustomFile {
+    /** Unique identifier for the file. */
     uid: string;
+    /** The timestamp (milliseconds) when the file was last modified. */
     lastModified: number;
+    /** A string representation of the last modified date. */
     lastModifiedDate: string;
+    /** The name of the file. */
     name: string;
+    /** The size of the file in bytes. */
     size: number;
+    /** The MIME type of the file. */
     type: string;
+    /** Upload progress percentage (0-100). */
     percent: number;
+    /** The original file object before any transformations. */
     originFileObj: OriginFileObj;
+    /** The URL for a thumbnail preview of the file. */
     thumbUrl: string;
+    /** Optional error information if the upload fails. */
     error?: FileError;
+    /** Optional server response after a successful upload. */
     response?: string;
+    /** Optional status of the file upload (e.g., "uploading", "done", "error"). */
     status?: string;
 }
+/** * Represents the original file object before any modifications. */
 export interface OriginFileObj {
+    /** Unique identifier for the original file. */
     uid: string;
 }
+/** * Represents an error that occurs during a file upload. */
 export interface FileError {
+    /** HTTP status code of the error. */
     status: number;
+    /** The HTTP method used for the request (e.g., "POST", "PUT"). */
     method: string;
+    /** The URL where the upload was attempted. */
     url: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/form/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,uDAAuD;AACvD,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,oGAAoG;IACpG,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,iEAAiE;IACjE,YAAY,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,gEAAgE;IAChE,aAAa,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,qRAAqR;IACrR,eAAe,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,2VAA2V;IAC3V,eAAe,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,oIAAoI;IACpI,UAAU,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,kGAAkG;AAClG,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/form/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,uEAAuE;AACvE,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzC;;;OAGG;IACH,aAAa,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5C;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvC,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+GAA+G;AAC/G,MAAM,WAAW,UAAU;IAC1B,uCAAuC;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IAC1B,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,aAAa,EAAE,aAAa,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC7B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACzB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACZ"}

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
 export { convertColorCode, convertHex8ToHsla, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToHex8, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert';
 export { Color } from './colors/Color';
-export { filterArrayOfObjects, flattenArray, isValidEmptyArray, shuffleArray, getLastArrayElement, } from './array/basics';
+export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, removeDuplicatesFromArray, } from './array/transform';
 export { convertIntoFormData, isEmptyFormData } from './form/convert';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGzE,OAAO,EACN,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,UAAU,EACV,KAAK,GACL,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACN,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,GACd,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGzE,OAAO,EACN,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,UAAU,EACV,KAAK,GACL,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,IAAI,iBAAiB,EAC1C,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACN,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cloneObject = exports.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.removeDuplicatesFromArray = exports.createOptionsArray = exports.sortAnArray = exports.getLastArrayElement = exports.shuffleArray = exports.isValidEmptyArray = exports.flattenArray = exports.filterArrayOfObjects = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.isOdd = exports.isMultiple = exports.isEven = exports.getRandomNumber = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.replaceAllInString = exports.convertStringCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
-exports.throttleAction = exports.isDeepEqual = exports.debounceAction = exports.convertArrayToString = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = void 0;
+exports.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.removeDuplicatesFromArray = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.isOdd = exports.isMultiple = exports.isEven = exports.getRandomNumber = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.replaceAllInString = exports.convertStringCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.throttleAction = exports.isDeepEqual = exports.debounceAction = exports.convertArrayToString = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = void 0;
 // ! String Utilities
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
@@ -58,9 +58,10 @@ Object.defineProperty(exports, "Color", { enumerable: true, get: function () { r
 var basics_3 = require("./array/basics");
 Object.defineProperty(exports, "filterArrayOfObjects", { enumerable: true, get: function () { return basics_3.filterArrayOfObjects; } });
 Object.defineProperty(exports, "flattenArray", { enumerable: true, get: function () { return basics_3.flattenArray; } });
-Object.defineProperty(exports, "isValidEmptyArray", { enumerable: true, get: function () { return basics_3.isValidEmptyArray; } });
-Object.defineProperty(exports, "shuffleArray", { enumerable: true, get: function () { return basics_3.shuffleArray; } });
 Object.defineProperty(exports, "getLastArrayElement", { enumerable: true, get: function () { return basics_3.getLastArrayElement; } });
+Object.defineProperty(exports, "isInvalidOrEmptyArray", { enumerable: true, get: function () { return basics_3.isInvalidOrEmptyArray; } });
+Object.defineProperty(exports, "isValidEmptyArray", { enumerable: true, get: function () { return basics_3.isInvalidOrEmptyArray; } });
+Object.defineProperty(exports, "shuffleArray", { enumerable: true, get: function () { return basics_3.shuffleArray; } });
 var sort_1 = require("./array/sort");
 Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return sort_1.sortAnArray; } });
 var transform_1 = require("./array/transform");

package/dist/utils/index.js

@@ -44,7 +44,7 @@ exports.isDeepEqual = isDeepEqual;
  * @returns Converted array in string format with the separator.
  */
 const convertArrayToString = (array, separator = ',') => {
-    if (!basics_1.isValidEmptyArray) {
+    if (!basics_1.isInvalidOrEmptyArray) {
         throw new Error('Please, provide a valid array!');
     }
     return array.join(separator);

package/package.json

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