nhb-toolbox 2.8.1 → 2.8.3

package/dist/colors/helpers.js

@@ -1,20 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._extractAlphaColorValues = exports._extractSolidColorValues = exports._isSimilarToLast = exports._generateRandomHSL = exports._applyOpacity = exports._convertOpacityToHex = void 0;
-exports._isHex6 = _isHex6;
-exports._isRGB = _isRGB;
-exports._isHSL = _isHSL;
-exports._isHex8 = _isHex8;
-exports._isRGBA = _isRGBA;
-exports._isHSLA = _isHSLA;
-exports._isValidAlpha = _isValidAlpha;
 /**
  * * Converts opacity percentage (0-100) to a 2-digit hex string.
  *
  * @param opacity - The opacity value as a percentage (0-100).
  * @returns A 2-digit hex string representing the alpha value.
  */
-const _convertOpacityToHex = (opacity) => {
+export const _convertOpacityToHex = (opacity) => {
     // Ensure opacity is between 0 and 100
     const validOpacity = Math.min(100, Math.max(0, opacity));
     // Convert to a value between 0 and 255, then to a hex string
@@ -22,29 +12,26 @@ const _convertOpacityToHex = (opacity) => {
     // Ensure it's 2 digits (e.g., 0x0A instead of 0xA)
     return alpha.toString(16).padStart(2, '0').toUpperCase();
 };
-exports._convertOpacityToHex = _convertOpacityToHex;
 /**
  * * Applies an opacity value to a color string.
  * @param color The color string to apply opacity to.
  * @param opacity The opacity value as a percentage (0-100).
  * @returns The color string with the opacity value applied.
  */
-const _applyOpacity = (color, opacity) => {
+export const _applyOpacity = (color, opacity) => {
     return color.concat(opacity);
 };
-exports._applyOpacity = _applyOpacity;
 /**
  * * Helper function to generate a random HSL color.
  *
  * @returns A random HSL color string.
  */
-const _generateRandomHSL = () => {
+export const _generateRandomHSL = () => {
     const hue = Math.floor(Math.random() * 360);
     const saturation = 75 + Math.floor(Math.random() * 25);
     const lightness = 50 + Math.floor(Math.random() * 15);
     return `hsl(${hue}, ${saturation}%, ${lightness}%)`;
 };
-exports._generateRandomHSL = _generateRandomHSL;
 /**
  * * Helper function to check if the new color is visually too similar to the previous one.
  * * It compares the hue, saturation, and lightness difference between the new color and the last one generated.
@@ -53,7 +40,7 @@ exports._generateRandomHSL = _generateRandomHSL;
  * @param newColor - The new color to compare.
  * @returns `Boolean` : `true` if the new color is similar to the previous one.
  */
-const _isSimilarToLast = (recentColors, newColor) => {
+export const _isSimilarToLast = (recentColors, newColor) => {
     if (recentColors.length === 0)
         return false;
     const newHSL = newColor.match(/hsl\((\d+), (\d+)%, (\d+)%\)/);
@@ -73,7 +60,6 @@ const _isSimilarToLast = (recentColors, newColor) => {
         saturationDifference < 24 &&
         lightnessDifference < 16);
 };
-exports._isSimilarToLast = _isSimilarToLast;
 /**
  * * Extracts numbers from a color string like `rgb(66, 103, 69)` or `hsl(120, 42.86%, 41.18%)`.
  * * Converts percentage values to decimal (e.g., `42.86%` → `42.86`).
@@ -81,10 +67,9 @@ exports._isSimilarToLast = _isSimilarToLast;
  * @param colorString The color string in RGB or HSL format.
  * @returns An array of extracted numbers.
  */
-const _extractSolidColorValues = (colorString) => {
+export const _extractSolidColorValues = (colorString) => {
     return (colorString.match(/[\d.]+%?/g) || []).map((value) => parseFloat(value));
 };
-exports._extractSolidColorValues = _extractSolidColorValues;
 /**
  * * Extracts numbers from a color string like `rgba(66, 103, 69, 0.6)` or `hsla(120, 42.86%, 41.18%, 0.9)`.
  * * Converts percentage values to decimal (e.g., `42.86%` → `42.86`).
@@ -92,17 +77,16 @@ exports._extractSolidColorValues = _extractSolidColorValues;
  * @param colorString The color string in RGB or HSL format.
  * @returns An array of extracted numbers.
  */
-const _extractAlphaColorValues = (colorString) => {
+export const _extractAlphaColorValues = (colorString) => {
     return (colorString.match(/[\d.]+%?/g) || []).map((value) => parseFloat(value));
 };
-exports._extractAlphaColorValues = _extractAlphaColorValues;
 /**
  * * Checks if a color is in `Hex` format.
  *
  * @param color Color to check.
  * @returns Boolean: `true` if it's a `Hex` color, `false` if not.
  */
-function _isHex6(color) {
+export function _isHex6(color) {
     return /^#[0-9A-Fa-f]{6}$/.test(color);
 }
 /**
@@ -111,7 +95,7 @@ function _isHex6(color) {
  * @param color Color to check.
  * @returns Boolean: `true` if it's an `RGB` color, `false` if not.
  */
-function _isRGB(color) {
+export function _isRGB(color) {
     return /^rgb\(\d{1,3},\s*\d{1,3},\s*\d{1,3}\)$/.test(color);
 }
 /**
@@ -120,7 +104,7 @@ function _isRGB(color) {
  * @param color Color to check.
  * @returns Boolean: `true` if it's an `HSL` color, `false` if not.
  */
-function _isHSL(color) {
+export function _isHSL(color) {
     return /^hsl\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%\)$/.test(color);
 }
 /**
@@ -130,7 +114,7 @@ function _isHSL(color) {
  * @param color Color to check.
  * @returns Boolean: `true` if it's a `Hex8` color, `false` if not.
  */
-function _isHex8(color) {
+export function _isHex8(color) {
     return /^#[0-9A-Fa-f]{8}$/.test(color);
 }
 /**
@@ -140,7 +124,7 @@ function _isHex8(color) {
  * @param color Color to check.
  * @returns Boolean: `true` if it's an `RGBA` color, `false` if not.
  */
-function _isRGBA(color) {
+export function _isRGBA(color) {
     return /^rgba\(\d{1,3},\s*\d{1,3},\s*\d{1,3},\s*(0|1|0?\.\d+)\)$/.test(color);
 }
 /**
@@ -150,7 +134,7 @@ function _isRGBA(color) {
  * @param color Color to check.
  * @returns Boolean: `true` if it's an `HSLA` color, `false` if not.
  */
-function _isHSLA(color) {
+export function _isHSLA(color) {
     return /^hsla\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%,\s*(0|1|0?\.\d+)\)$/.test(color);
 }
 /**
@@ -158,6 +142,6 @@ function _isHSLA(color) {
  * @param value Alpha value to check.
  * @returns Boolean: `true` if it's a valid alpha value, `false` if not.
  */
-function _isValidAlpha(value) {
+export function _isValidAlpha(value) {
     return value >= 0 && value <= 1 && !isNaN(value);
 }

package/dist/colors/initials.d.ts

@@ -1,4 +1,4 @@
-import type { ColorInput, ColorInputArray, OpacityValue } from './types';
+import type { ColorInputArray, OpacityValue } from './types';
 /**
  *  * Generates a hex color based on the first character (initial) of a string or number.
  *
@@ -9,7 +9,7 @@ import type { ColorInput, ColorInputArray, OpacityValue } from './types';
  * @param opacity - A value from 0 to 100 representing the opacity percentage.
  * @returns A hex color for the first character of the provided string/number.
  */
-export declare function getColorForInitial(input: ColorInput, opacity?: OpacityValue): string;
+export declare function getColorForInitial(input: string | number, opacity?: OpacityValue): string;
 /**
  *  * Generates an array of hex colors based on the first character (initial) of an array of strings/numbers or even nested arrays of strings/numbers.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../../src/colors/initials.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,CAAC;AAEV;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,EAAE,CAAC"}
+{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../../src/colors/initials.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,CAAC;AAEV;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,EAAE,CAAC"}

package/dist/colors/initials.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getColorForInitial = getColorForInitial;
-const constants_1 = require("./constants");
-const helpers_1 = require("./helpers");
+import { alphabetColorPalette, numberColorPalette } from './constants';
+import { _applyOpacity, _convertOpacityToHex } from './helpers';
 /**
  *  * Generates a hex color based on the first character (initial) of a string or number; or an array of hex colors based on the first character (initial) of an array of strings/numbers or even nested arrays of strings/numbers.
  *
@@ -14,40 +11,40 @@ const helpers_1 = require("./helpers");
  * @param opacity - A value from 0 to 100 representing the opacity percentage.
  * @returns A hex color for a string/number, or an array of hex colors for each element of the provided array.
  */
-function getColorForInitial(input = '', opacity = 100) {
+export function getColorForInitial(input = '', opacity = 100) {
     let initial;
-    const hexOpacity = (0, helpers_1._convertOpacityToHex)(opacity);
+    const hexOpacity = _convertOpacityToHex(opacity);
     const numbers = '0123456789';
     // Handle empty string case
     if (!input)
-        return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
+        return _applyOpacity('#010514', hexOpacity);
     // Handle string input
     if (typeof input === 'string') {
         initial = input[0];
         // Handle number as string
         if (numbers.includes(initial)) {
-            return (0, helpers_1._applyOpacity)(constants_1.numberColorPalette[parseInt(initial, 10)], hexOpacity);
+            return _applyOpacity(numberColorPalette[parseInt(initial, 10)], hexOpacity);
         }
         const upperInitial = initial.toUpperCase();
         const index = upperInitial.charCodeAt(0) - 'A'.charCodeAt(0);
         // Validate alphabet
-        if (index >= 0 && index < constants_1.alphabetColorPalette.length) {
-            return (0, helpers_1._applyOpacity)(constants_1.alphabetColorPalette[index], hexOpacity);
+        if (index >= 0 && index < alphabetColorPalette.length) {
+            return _applyOpacity(alphabetColorPalette[index], hexOpacity);
         }
-        return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
+        return _applyOpacity('#010514', hexOpacity);
         // Handle number input
     }
     else if (typeof input === 'number' && !isNaN(input)) {
         initial = input.toString()[0];
         if (numbers.includes(initial)) {
-            return (0, helpers_1._applyOpacity)(constants_1.numberColorPalette[parseInt(initial, 10)], hexOpacity);
+            return _applyOpacity(numberColorPalette[parseInt(initial, 10)], hexOpacity);
         }
-        return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
+        return _applyOpacity('#010514', hexOpacity);
         // Handle array of strings/numbers
     }
     else if (Array.isArray(input)) {
         if (input.length < 1)
-            return [...constants_1.alphabetColorPalette, ...constants_1.numberColorPalette].map((color) => (0, helpers_1._applyOpacity)(color, hexOpacity));
+            return [...alphabetColorPalette, ...numberColorPalette].map((color) => _applyOpacity(color, hexOpacity));
         return input
             .map((el) => {
             if (Array.isArray(el)) {
@@ -57,5 +54,5 @@ function getColorForInitial(input = '', opacity = 100) {
         })
             .flat();
     }
-    return (0, helpers_1._applyOpacity)('#010514', hexOpacity);
+    return _applyOpacity('#010514', hexOpacity);
 }

package/dist/colors/random.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateRandomColorInHexRGB = exports.generateRandomHSLColor = void 0;
-const convert_1 = require("./convert");
-const helpers_1 = require("./helpers");
+import { convertColorCode } from './convert';
+import { _generateRandomHSL, _isSimilarToLast } from './helpers';
 /** Track previously generated colors. */
 const generatedColors = new Set();
 /** Array of recently generated colors */
@@ -13,13 +10,13 @@ const recentColors = [];
  * @param maxColors - The maximum number of recent colors to store in memory. Default is `16`.
  * @returns Generated unique random color in `HSL` format.
  */
-const generateRandomHSLColor = (maxColors = 16) => {
+export const generateRandomHSLColor = (maxColors = 16) => {
     let color;
     // Keep generating until a unique color is found that is also different from the last one
     do {
-        color = (0, helpers_1._generateRandomHSL)();
+        color = _generateRandomHSL();
     } while (generatedColors.has(color) ||
-        (0, helpers_1._isSimilarToLast)(recentColors, color));
+        _isSimilarToLast(recentColors, color));
     // Add the newly generated color to the set and recent colors
     generatedColors.add(color);
     recentColors.push(color);
@@ -29,14 +26,12 @@ const generateRandomHSLColor = (maxColors = 16) => {
     }
     return color;
 };
-exports.generateRandomHSLColor = generateRandomHSLColor;
 /**
  * * Utility to generate a unique random color in Hex and RGB format.
  *
  * @param maxColors - The maximum number of recent colors to store in memory. Default is `16`.
  * @returns An object of generated unique random color in both `Hex` and `RGB` formats.
  */
-const generateRandomColorInHexRGB = (maxColors = 16) => {
-    return (0, convert_1.convertColorCode)((0, exports.generateRandomHSLColor)(maxColors));
+export const generateRandomColorInHexRGB = (maxColors = 16) => {
+    return convertColorCode(generateRandomHSLColor(maxColors));
 };
-exports.generateRandomColorInHexRGB = generateRandomColorInHexRGB;

package/dist/colors/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/form/convert.js

@@ -1,17 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isEmptyFormData = exports.convertIntoFormData = void 0;
-const basics_1 = require("../array/basics");
+import { isInvalidOrEmptyArray } from '../array/basics';
 /**
  * * Utility to convert object into FormData.
  *
  * @param data Data to convert into FormData.
  * @returns Converted FormData.
  */
-const convertIntoFormData = (data) => {
+export const convertIntoFormData = (data) => {
     const formData = new FormData();
     Object.entries(data).forEach(([key, value]) => {
-        if (!(0, basics_1.isInvalidOrEmptyArray)(value) && value[0]?.originFileObj) {
+        if (!isInvalidOrEmptyArray(value) && value[0]?.originFileObj) {
             formData.append(key, value[0].originFileObj);
         }
         else if (value !== undefined && value !== null && value !== '') {
@@ -20,17 +17,15 @@ const convertIntoFormData = (data) => {
     });
     return formData;
 };
-exports.convertIntoFormData = convertIntoFormData;
 /**
  * * Check if a formdata object is empty.
  *
  * @param data FormData to check.
  * @returns Boolean (`true`/`false`) Whether the formdata is empty.
  */
-const isEmptyFormData = (data) => {
+export const isEmptyFormData = (data) => {
     if ('entries' in data && typeof data.entries === 'function') {
         return Array.from(data.entries()).length === 0;
     }
     throw new Error('`FormData.entries()` is not supported in this environment!');
 };
-exports.isEmptyFormData = isEmptyFormData;

package/dist/form/guards.js

@@ -1,15 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isOriginFileObj = isOriginFileObj;
-exports.isCustomFile = isCustomFile;
-exports.isCustomFileArray = isCustomFileArray;
-exports.isFileUpload = isFileUpload;
 /**
  * * Checks if a given value is an `OriginFileObj`.
  * @param value - The value to check.
  * @returns `true` if the value is a valid `OriginFileObj`, otherwise `false`.
  */
-function isOriginFileObj(value) {
+export function isOriginFileObj(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value)) {
         return false;
     }
@@ -21,7 +15,7 @@ function isOriginFileObj(value) {
  * @param value - The value to check.
  * @returns `true` if the value is a valid `CustomFile`, otherwise `false`.
  */
-function isCustomFile(value) {
+export function isCustomFile(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value)) {
         return false;
     }
@@ -33,7 +27,7 @@ function isCustomFile(value) {
  * @param value - The value to check.
  * @returns `true` if the value is a valid `CustomFile[]`, otherwise `false`.
  */
-function isCustomFileArray(value) {
+export function isCustomFileArray(value) {
     return (Array.isArray(value) && value.length > 0 && value.every(isCustomFile));
 }
 /**
@@ -41,7 +35,7 @@ function isCustomFileArray(value) {
  * @param value - The value to check.
  * @returns `true` if the value is a valid `FileUpload`, otherwise `false`.
  */
-function isFileUpload(value) {
+export function isFileUpload(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value)) {
         return false;
     }

package/dist/form/transform.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createControlledFormData = void 0;
-const basics_1 = require("../array/basics");
-const basics_2 = require("../object/basics");
-const guards_1 = require("./guards");
+import { isInvalidOrEmptyArray } from '../array/basics';
+import { isEmptyObject } from '../object/basics';
+import { isCustomFile, isCustomFileArray, isFileUpload } from './guards';
 /**
  * * Utility to convert object into FormData in a controlled way.
  *
@@ -12,7 +9,7 @@ const guards_1 = require("./guards");
  *
  * @returns FormData instance containing the sanitized and transformed data
  */
-const createControlledFormData = (data, configs) => {
+export const createControlledFormData = (data, configs) => {
     const formData = new FormData();
     const { stringifyNested = '*' } = configs || {};
     /** - Helper function to check if a key matches a dotNotation path to preserve. */
@@ -39,15 +36,15 @@ const createControlledFormData = (data, configs) => {
             configs?.lowerCaseKeys?.includes(key)) ?
             key.toLowerCase()
             : key;
-        if ((0, guards_1.isCustomFileArray)(value)) {
+        if (isCustomFileArray(value)) {
             value.forEach((file) => formData.append(transformedKey, file.originFileObj));
         }
-        else if ((0, guards_1.isFileUpload)(value)) {
+        else if (isFileUpload(value)) {
             if (value.fileList) {
                 value.fileList.forEach((file) => formData.append(transformedKey, file.originFileObj));
             }
             else if (value.file) {
-                if ((0, guards_1.isCustomFile)(value.file)) {
+                if (isCustomFile(value.file)) {
                     formData.append(transformedKey, value.file.originFileObj);
                 }
                 else {
@@ -58,7 +55,7 @@ const createControlledFormData = (data, configs) => {
         else if (value instanceof Blob || value instanceof File) {
             formData.append(transformedKey, value);
         }
-        else if (Array.isArray(value) && !(0, basics_1.isInvalidOrEmptyArray)(value)) {
+        else if (Array.isArray(value) && !isInvalidOrEmptyArray(value)) {
             if (shouldBreakArray(key)) {
                 value.forEach((item, index) => {
                     _addToFormData(`${transformedKey}[${index}]`, item);
@@ -70,7 +67,7 @@ const createControlledFormData = (data, configs) => {
         }
         else if (typeof value === 'object' &&
             value !== null &&
-            !(0, basics_2.isEmptyObject)(value)) {
+            !isEmptyObject(value)) {
             if (shouldStringify(key) && !shouldDotNotate(key)) {
                 formData.append(transformedKey, JSON.stringify(value));
             }
@@ -123,4 +120,3 @@ const createControlledFormData = (data, configs) => {
     _processObject(data);
     return formData;
 };
-exports.createControlledFormData = createControlledFormData;

package/dist/form/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/guards/non-primitives.d.ts

@@ -31,62 +31,62 @@ export declare function isDate(value: unknown): value is Date;
  */
 export declare function isObjectWithKeys<T extends Record<string, unknown>>(value: unknown, keys: (keyof T)[]): value is T;
 /**
- * Type guard to check if a value is an empty object.
+ * * Type guard to check if a value is an empty object.
  * @param value - The value to check.
  * @returns `true` if the value is an empty object, otherwise `false`.
  */
 export declare function isEmptyObject(value: unknown): value is Record<string, unknown>;
 /**
- * Type guard to check if a value is an array of a specific type.
+ * * Type guard to check if a value is an array of a specific type.
  * @param value - The value to check.
  * @param typeCheck - The type guard function to check each item of the array.
  * @returns `true` if the value is an array of the specified type, otherwise `false`.
  */
 export declare function isArrayOfType<T>(value: unknown, typeCheck: (item: unknown) => item is T): value is T[];
 /**
- * Type guard to check if a value is a Promise.
+ * * Type guard to check if a value is a Promise.
  * @param value - The value to check.
  * @returns `true` if the value is a Promise, otherwise `false`.
  */
 export declare function isPromise(value: unknown): value is Promise<unknown>;
 /**
- * Type guard to check if a value is a Set.
+ * * Type guard to check if a value is a Set.
  * @param value - The value to check.
  * @returns `true` if the value is a Set, otherwise `false`.
  */
 export declare function isSet<T>(value: unknown): value is Set<T>;
 /**
- * Type guard to check if a value is a Map.
+ * * Type guard to check if a value is a Map.
  * @param value - The value to check.
  * @returns `true` if the value is a Map, otherwise `false`.
  */
 export declare function isMap<K, V>(value: unknown): value is Map<K, V>;
 /**
- * Type guard to check if a value is a RegExp.
+ * * Type guard to check if a value is a RegExp.
  * @param value - The value to check.
  * @returns `true` if the value is a RegExp, otherwise `false`.
  */
 export declare function isRegExp(value: unknown): value is RegExp;
 /**
- * Type guard to check if a value is an Error object.
+ * * Type guard to check if a value is an Error object.
  * @param value - The value to check.
  * @returns `true` if the value is an Error object, otherwise `false`.
  */
 export declare function isError(value: unknown): value is Error;
 /**
- * Type guard to check if a value is a BigInt.
+ * * Type guard to check if a value is a BigInt.
  * @param value - The value to check.
  * @returns `true` if the value is a BigInt, otherwise `false`.
  */
 export declare function isBigInt(value: unknown): value is bigint;
 /**
- * Type guard to check if a string is valid JSON.
+ * * Type guard to check if a string is valid JSON.
  * @param value - The value to check.
  * @returns `true` if the value is valid JSON, otherwise `false`.
  */
 export declare function isJSON(value: unknown): value is string;
 /**
- * Type guard to check if a function returns a Promise.
+ * * Type guard to check if a function returns a Promise.
  * @param fn - The function to check.
  * @returns `true` if the function returns a Promise, otherwise `false`.
  */