nhb-toolbox 3.0.0 → 3.1.0

package/dist/dom/query.d.ts

@@ -0,0 +1,28 @@
+import type { QueryObject } from '../object/types';
+/**
+ * * Utility to generate query parameters from an object.
+ *
+ * @template T - A generic type extending `QueryObject`.
+ * @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"
+ * generateQueryParams({ key1: '', key2: null }); // ""
+ * generateQueryParams({ key1: true, key2: false }); // "?key1=true&key2=false"
+ * generateQueryParams({ filters: { category: 'laptop', price: 1000 } }); // "?category=laptop&price=1000"
+ */
+export declare const generateQueryParams: <T extends QueryObject>(params?: T) => `?${string}` | "";
+/**
+ * * Get query params as standard `JavaScript` Object `Record<string, string>`.
+ * @returns Query string as key-value paired object. `Record<string, string>`.
+ */
+export declare function getQueryParams(): Record<string, string>;
+/**
+ * * Update query params in the browser URL with given key and value.
+ * @param key Key for the query to update.
+ * @param value Value to updated against the given key.
+ */
+export declare function updateQueryParam(key: string, value: string): void;
+//# sourceMappingURL=query.d.ts.map

package/dist/dom/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/dom/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,WAChD,CAAC,KACP,IAAI,MAAM,EAAE,GAAG,EAkCjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAI1D"}

package/dist/dom/query.js

@@ -0,0 +1,50 @@
+import { flattenObjectKeyValue } from '../object/objectify';
+/**
+ * * Utility to generate query parameters from an object.
+ *
+ * @template T - A generic type extending `QueryObject`.
+ * @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"
+ * generateQueryParams({ key1: '', key2: null }); // ""
+ * generateQueryParams({ key1: true, key2: false }); // "?key1=true&key2=false"
+ * generateQueryParams({ filters: { category: 'laptop', price: 1000 } }); // "?category=laptop&price=1000"
+ */
+export const generateQueryParams = (params = {}) => {
+    // Flatten the nested object into key-value pairs
+    const flattenedParams = flattenObjectKeyValue(params);
+    // Generate the query string
+    const queryParams = Object.entries(flattenedParams)
+        .filter(([_, value]) => value !== undefined &&
+        value !== null &&
+        !(typeof value === 'string' && value.trim() === ''))
+        .flatMap(([key, value]) => Array.isArray(value) ?
+        value
+            .filter((v) => v !== undefined &&
+            v !== null &&
+            !(typeof v === 'string' && v.trim() === ''))
+            .map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(typeof v === 'boolean' ? String(v) : String(v))}`)
+        : `${encodeURIComponent(key)}=${encodeURIComponent(typeof value === 'boolean' ? String(value) : String(value))}`)
+        .join('&');
+    return queryParams ? `?${queryParams}` : '';
+};
+/**
+ * * Get query params as standard `JavaScript` Object `Record<string, string>`.
+ * @returns Query string as key-value paired object. `Record<string, string>`.
+ */
+export function getQueryParams() {
+    return Object.fromEntries(new URLSearchParams(window.location.search));
+}
+/**
+ * * Update query params in the browser URL with given key and value.
+ * @param key Key for the query to update.
+ * @param value Value to updated against the given key.
+ */
+export function updateQueryParam(key, value) {
+    const url = new URL(window.location.href);
+    url.searchParams.set(key, value);
+    window.history.replaceState({}, '', url.toString());
+}

package/dist/dom/storage.d.ts

@@ -0,0 +1,41 @@
+/**
+ * * Get item(s) from local storage.
+ *
+ * @param key - Key to get item(s) from local storage.
+ * @returns Returns saved item(s) from local storage if it exists with that key.
+ */
+export declare const getFromLocalStorage: <T>(key: string) => T | null;
+/**
+ * * Save item(s) in local storage.
+ *
+ * @param key - Key to save an item(s).
+ * @param value - The item(s)/value to save.
+ */
+export declare const saveToLocalStorage: <T>(key: string, value: T) => void;
+/**
+ * * Remove item(s) from local storage.
+ *
+ * @param key - Key to delete item(s) from local storage.
+ */
+export declare const removeFromLocalStorage: (key: string) => void;
+/**
+ * * Get item(s) from session storage.
+ *
+ * @param key - Key to get item(s) from session storage.
+ * @returns Returns saved item(s) from session storage if it exists with that key.
+ */
+export declare const getFromSessionStorage: <T>(key: string) => T | null;
+/**
+ * * Save item(s) in session storage.
+ *
+ * @param key - Key to save an item(s).
+ * @param value - The item(s)/value to save.
+ */
+export declare const saveToSessionStorage: <T>(key: string, value: T) => void;
+/**
+ * * Remove item(s) from session storage.
+ *
+ * @param key - Key to delete item(s) from session storage.
+ */
+export declare const removeFromSessionStorage: (key: string) => void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/dom/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/dom/storage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,OAAO,MAAM,KAAG,CAAC,GAAG,IAMxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,OAAO,MAAM,SAAS,CAAC,KAAG,IAE7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAS,MAAM,KAAG,IAEpD,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,OAAO,MAAM,KAAG,CAAC,GAAG,IAM1D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,OAAO,MAAM,SAAS,CAAC,KAAG,IAE/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAS,MAAM,KAAG,IAEtD,CAAC"}

package/dist/dom/storage.js

@@ -0,0 +1,60 @@
+// * ****************** Local Storage ****************** * //
+/**
+ * * Get item(s) from local storage.
+ *
+ * @param key - Key to get item(s) from local storage.
+ * @returns Returns saved item(s) from local storage if it exists with that key.
+ */
+export const getFromLocalStorage = (key) => {
+    const item = localStorage.getItem(key);
+    if (!item)
+        return null;
+    return JSON.parse(item);
+};
+/**
+ * * Save item(s) in local storage.
+ *
+ * @param key - Key to save an item(s).
+ * @param value - The item(s)/value to save.
+ */
+export const saveToLocalStorage = (key, value) => {
+    localStorage.setItem(key, JSON.stringify(value));
+};
+/**
+ * * Remove item(s) from local storage.
+ *
+ * @param key - Key to delete item(s) from local storage.
+ */
+export const removeFromLocalStorage = (key) => {
+    localStorage.removeItem(key);
+};
+// * ****************** Session Storage ****************** * //
+/**
+ * * Get item(s) from session storage.
+ *
+ * @param key - Key to get item(s) from session storage.
+ * @returns Returns saved item(s) from session storage if it exists with that key.
+ */
+export const getFromSessionStorage = (key) => {
+    const item = sessionStorage.getItem(key);
+    if (!item)
+        return null;
+    return JSON.parse(item);
+};
+/**
+ * * Save item(s) in session storage.
+ *
+ * @param key - Key to save an item(s).
+ * @param value - The item(s)/value to save.
+ */
+export const saveToSessionStorage = (key, value) => {
+    sessionStorage.setItem(key, JSON.stringify(value));
+};
+/**
+ * * Remove item(s) from session storage.
+ *
+ * @param key - Key to delete item(s) from session storage.
+ */
+export const removeFromSessionStorage = (key) => {
+    sessionStorage.removeItem(key);
+};

package/dist/dom/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * * Scrolls smoothly to the given element with an optional vertical offset.
+ * @param element The target element to scroll to.
+ * @param offset Additional vertical offset in pixels (positive moves down, negative moves up).
+ */
+export declare function smoothScrollTo(element: HTMLElement, offset?: number): void;
+/** * Toggle full-screen using browser API. */
+export declare function toggleFullScreen(): void;
+/**
+ * * Copy text to clipboard.
+ * @param text Text to copy in clipboard.
+ */
+export declare function copyToClipboard(text: string): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/dom/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/dom/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAI,QAQ9D;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,SAM/B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,iBAMjD"}

package/dist/dom/utils.js

@@ -0,0 +1,34 @@
+/**
+ * * Scrolls smoothly to the given element with an optional vertical offset.
+ * @param element The target element to scroll to.
+ * @param offset Additional vertical offset in pixels (positive moves down, negative moves up).
+ */
+export function smoothScrollTo(element, offset = 0) {
+    element.scrollIntoView({ behavior: 'smooth', block: 'start' });
+    if (offset !== 0) {
+        setTimeout(() => {
+            window.scrollBy({ top: offset, behavior: 'smooth' });
+        }, 300); // Delay to ensure smooth scrolling effect
+    }
+}
+/** * Toggle full-screen using browser API. */
+export function toggleFullScreen() {
+    if (!document.fullscreenElement) {
+        document.documentElement.requestFullscreen();
+    }
+    else if (document.exitFullscreen) {
+        document.exitFullscreen();
+    }
+}
+/**
+ * * Copy text to clipboard.
+ * @param text Text to copy in clipboard.
+ */
+export async function copyToClipboard(text) {
+    try {
+        await navigator.clipboard.writeText(text);
+    }
+    catch (err) {
+        console.error('Failed to copy:', err);
+    }
+}

package/dist/index.d.ts

@@ -14,12 +14,15 @@ export { Color, Color as Colour } from './colors/Color';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, removeDuplicatesFromArray, } from './array/transform';
-export { createControlledFormData as convertIntoFormData, createControlledFormData, } from './form/convert';
-export { isCustomFile, isCustomFileArray, isFileUpload, isOriginFileObj, isValidFormData, isFileArray, isFileList, } from './form/guards';
-export { cloneObject, countObjectFields, generateQueryParams, } from './object/basics';
+export { createControlledFormData as convertIntoFormData, createControlledFormData, createControlledFormData as createFormData, } from './form/convert';
+export { isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileUpload, isOriginFileObj, isValidFormData, } from './form/guards';
+export { cloneObject, countObjectFields } from './object/basics';
 export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObjectDotNotation, flattenObjectKeyValue, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';
 export { sanitizeData } from './object/sanitize';
 export { convertObjectValues } from './object/convert';
+export { generateQueryParams, getQueryParams, updateQueryParam, } from './dom/query';
+export { copyToClipboard, smoothScrollTo, toggleFullScreen } from './dom/utils';
+export { getFromLocalStorage, getFromSessionStorage, removeFromLocalStorage, removeFromSessionStorage, saveToLocalStorage, saveToSessionStorage, } from './dom/storage';
 export { convertArrayToString, debounceAction, isDeepEqual, throttleAction, } from './utils';
 export { isBoolean, isFalsy, isInteger, isNonEmptyString, isNull, isNumber, isPositiveInteger, isPrimitive, isString, isSymbol, isTruthy, isUndefined, } from './guards/primitives';
 export { isReturningPromise as doesReturnPromise, isArray, isArrayOfType, isValidArray as isArrayWithLength, isBigInt, isDate, isEmptyObject, isEmptyObject as isEmptyObjectGuard, isError, isFunction, isJSON, isJSON as isJSONObject, isMap, isNotEmptyObject, isObject, isEmptyObject as isObjectEmpty, isObjectWithKeys, isPromise, isRegExp, isRegExp as isRegularExpression, isReturningPromise, isSet, isValidArray, isJSON as isValidJSON, isMap as isValidMap, isNotEmptyObject as isValidObject, isSet as isValidSet, } from './guards/non-primitives';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"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,EACN,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,IAAI,mBAAmB,GAC7C,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACN,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,MAAM,IAAI,YAAY,EACtB,UAAU,EACV,KAAK,EACL,KAAK,IAAI,WAAW,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,aAAa,IAAI,oBAAoB,EACrC,sBAAsB,EACtB,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,gBAAgB,EAChB,OAAO,EACP,OAAO,IAAI,aAAa,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,WAAW,EACX,cAAc,IAAI,uBAAuB,EACzC,cAAc,EACd,cAAc,IAAI,gBAAgB,EAClC,cAAc,EACd,cAAc,IAAI,WAAW,EAC7B,cAAc,IAAI,4BAA4B,EAC9C,cAAc,EACd,cAAc,IAAI,sBAAsB,GACxC,MAAM,oBAAoB,CAAC;AAE5B,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,KAAK,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxD,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,EACN,wBAAwB,IAAI,mBAAmB,EAC/C,wBAAwB,EACxB,wBAAwB,IAAI,cAAc,GAC1C,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,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,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,SAAS,EACT,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW,GACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACN,kBAAkB,IAAI,iBAAiB,EACvC,OAAO,EACP,aAAa,EACb,YAAY,IAAI,iBAAiB,EACjC,QAAQ,EACR,MAAM,EACN,aAAa,EACb,aAAa,IAAI,kBAAkB,EACnC,OAAO,EACP,UAAU,EACV,MAAM,EACN,MAAM,IAAI,YAAY,EACtB,KAAK,EACL,gBAAgB,EAChB,QAAQ,EACR,aAAa,IAAI,aAAa,EAC9B,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,QAAQ,IAAI,mBAAmB,EAC/B,kBAAkB,EAClB,KAAK,EACL,YAAY,EACZ,MAAM,IAAI,WAAW,EACrB,KAAK,IAAI,UAAU,EACnB,gBAAgB,IAAI,aAAa,EACjC,KAAK,IAAI,UAAU,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,IAAI,iBAAiB,EAClC,WAAW,EACX,MAAM,EACN,aAAa,IAAI,SAAS,EAC1B,aAAa,IAAI,iBAAiB,EAClC,eAAe,EACf,aAAa,EACb,KAAK,EACL,MAAM,EACN,OAAO,IAAI,YAAY,EACvB,KAAK,IAAI,UAAU,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -19,13 +19,17 @@ export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmp
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, removeDuplicatesFromArray, } from './array/transform';
 // ! Form Utilities
-export { createControlledFormData as convertIntoFormData, createControlledFormData, } from './form/convert';
-export { isCustomFile, isCustomFileArray, isFileUpload, isOriginFileObj, isValidFormData, isFileArray, isFileList, } from './form/guards';
+export { createControlledFormData as convertIntoFormData, createControlledFormData, createControlledFormData as createFormData, } from './form/convert';
+export { isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileUpload, isOriginFileObj, isValidFormData, } from './form/guards';
 // ! Object Utilities
-export { cloneObject, countObjectFields, generateQueryParams, } from './object/basics';
+export { cloneObject, countObjectFields } from './object/basics';
 export { extractNewFields, extractUpdatedAndNewFields, extractUpdatedFields, flattenObjectDotNotation, flattenObjectKeyValue, mergeAndFlattenObjects, mergeObjects, } from './object/objectify';
 export { sanitizeData } from './object/sanitize';
 export { convertObjectValues } from './object/convert';
+// ! DOM Utilities
+export { generateQueryParams, getQueryParams, updateQueryParam, } from './dom/query';
+export { copyToClipboard, smoothScrollTo, toggleFullScreen } from './dom/utils';
+export { getFromLocalStorage, getFromSessionStorage, removeFromLocalStorage, removeFromSessionStorage, saveToLocalStorage, saveToSessionStorage, } from './dom/storage';
 // ! Other Utilities
 export { convertArrayToString, debounceAction, isDeepEqual, throttleAction, } from './utils';
 // ! Primitive Type Guards

package/dist/object/basics.d.ts

@@ -1,19 +1,4 @@
-import type { GenericObject, QueryObject } from './types';
-/**
- * * Utility to generate query parameters from an object.
- *
- * @template T - A generic type extending `QueryObject`.
- * @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"
- * generateQueryParams({ key1: '', key2: null }); // ""
- * generateQueryParams({ key1: true, key2: false }); // "?key1=true&key2=false"
- * generateQueryParams({ filters: { category: 'laptop', price: 1000 } }); // "?category=laptop&price=1000"
- */
-export declare const generateQueryParams: <T extends QueryObject>(params?: T) => string;
+import type { GenericObject } from './types';
 /**
  * * Deep clone an object.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/object/basics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,WAChD,CAAC,KACP,MAkCF,CAAC;AACF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,CAE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,MAInE,CAAC"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../src/object/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,CAE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,aAAa,OAAO,CAAC,KAAG,MAInE,CAAC"}

package/dist/object/basics.js

@@ -1,36 +1,3 @@
-import { flattenObjectKeyValue } from './objectify';
-/**
- * * Utility to generate query parameters from an object.
- *
- * @template T - A generic type extending `QueryObject`.
- * @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"
- * generateQueryParams({ key1: '', key2: null }); // ""
- * generateQueryParams({ key1: true, key2: false }); // "?key1=true&key2=false"
- * generateQueryParams({ filters: { category: 'laptop', price: 1000 } }); // "?category=laptop&price=1000"
- */
-export const generateQueryParams = (params = {}) => {
-    // Flatten the nested object into key-value pairs
-    const flattenedParams = flattenObjectKeyValue(params);
-    // Generate the query string
-    const queryParams = Object.entries(flattenedParams)
-        .filter(([_, value]) => value !== undefined &&
-        value !== null &&
-        !(typeof value === 'string' && value.trim() === ''))
-        .flatMap(([key, value]) => Array.isArray(value) ?
-        value
-            .filter((v) => v !== undefined &&
-            v !== null &&
-            !(typeof v === 'string' && v.trim() === ''))
-            .map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(typeof v === 'boolean' ? String(v) : String(v))}`)
-        : `${encodeURIComponent(key)}=${encodeURIComponent(typeof value === 'boolean' ? String(value) : String(value))}`)
-        .join('&');
-    return queryParams ? `?${queryParams}` : '';
-};
 /**
  * * Deep clone an object.
  *

package/package.json

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