toolbox-x 2.0.12 → 2.0.14

package/dist/{array-D8VGEDBI.d.mts → array-CbAKXvhH.d.mts}

@@ -19,6 +19,8 @@ import { E as NestedPrimitiveKey, ot as NormalPrimitiveKey, y as GenericObject }
 //#region src/types/array.d.ts
 /** * Flatten Array or Wrap in Array */
 type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
+/** * Union of type `T` and array of `T` */
+type TypeOrArray<T> = T | Array<T>;
 /**
  * * Configuration for `createOptionsArray`.
  * - Defines the mapping between keys in the input objects and the keys in the output options.
@@ -127,4 +129,4 @@ interface FindOptions<T extends GenericObject = {}> {
   data?: T[] | (() => T[]);
 }
 //#endregion
-export { Flattened as a, OrderOption as c, SortOptions as d, FirstFieldValue as i, SortByOption as l, FindOptions as n, Option as o, FirstFieldKey as r, OptionsConfig as s, FieldValue as t, SortNature as u };
+export { Flattened as a, OrderOption as c, SortOptions as d, TypeOrArray as f, FirstFieldValue as i, SortByOption as l, FindOptions as n, Option as o, FirstFieldKey as r, OptionsConfig as s, FieldValue as t, SortNature as u };

package/dist/{array-ChT6TxQ7.d.cts → array-EVkwcL_k.d.cts}

@@ -19,6 +19,8 @@ import { E as NestedPrimitiveKey, ot as NormalPrimitiveKey, y as GenericObject }
 //#region src/types/array.d.ts
 /** * Flatten Array or Wrap in Array */
 type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
+/** * Union of type `T` and array of `T` */
+type TypeOrArray<T> = T | Array<T>;
 /**
  * * Configuration for `createOptionsArray`.
  * - Defines the mapping between keys in the input objects and the keys in the output options.
@@ -127,4 +129,4 @@ interface FindOptions<T extends GenericObject = {}> {
   data?: T[] | (() => T[]);
 }
 //#endregion
-export { Flattened as a, OrderOption as c, SortOptions as d, FirstFieldValue as i, SortByOption as l, FindOptions as n, Option as o, FirstFieldKey as r, OptionsConfig as s, FieldValue as t, SortNature as u };
+export { Flattened as a, OrderOption as c, SortOptions as d, TypeOrArray as f, FirstFieldValue as i, SortByOption as l, FindOptions as n, Option as o, FirstFieldKey as r, OptionsConfig as s, FieldValue as t, SortNature as u };

package/dist/dom.cjs

@@ -18,93 +18,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_specials = require('./specials-dkYP1Nh2.cjs');
 const require_basics = require('./basics-Bb5ovcvz.cjs');
-const require_objectify = require('./objectify--6hPlQ7r.cjs');
+const require_query = require('./query-BUBCpo-q.cjs');
 
-//#region src/dom/query.ts
-/**
-* * Utility to generate query parameters from an object.
-*
-* @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"
-*/
-function generateQueryParams(params = {}) {
-	const flattenedParams = require_objectify.flattenObjectKeyValue(params);
-	const queryParams = Object.entries(flattenedParams)?.filter(([_, value]) => value != null && !(require_primitives.isString(value) && value?.trim() === ""))?.flatMap(([key, value]) => Array.isArray(value) ? value?.filter((v) => v != null && !(require_primitives.isString(v) && v.trim() === ""))?.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(String(v))}`) : `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join("&");
-	return queryParams ? `?${queryParams}` : "";
-}
-/**
-* * Get query params as standard `JavaScript` Object `Record<string, string>`. You can define the type by passing a type argument.
-*
-* - **Note:** *Extracts query parameters from the current URL (window.location.search).*
-*
-* @returns Query string as key-value paired object. `Record<string, string>`.
-*/
-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.
-*/
-function updateQueryParam(key, value) {
-	const url = new URL(window.location.href);
-	url.searchParams.set(key, value);
-	window.history.replaceState({}, "", url?.toString());
-}
-/**
-* Parses a query string (with optional `?` prefix) into an object.
-* Supports multiple values for the same key by returning arrays.
-* Optionally parses primitive string values into actual types (e.g., "1" → 1, "true" → true).
-*
-* @remarks This utility is designed to parse generic string, for literal use, try {@link parseQueryStringLiteral}.
-*
-* - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
-*
-* @param query - The query string to parse.
-* @param parsePrimitives - Whether to convert stringified primitives into real values (default: true).
-* @returns An object where keys are strings and values can be string, array, number, boolean, or null/undefined.
-*/
-function parseQueryString(query, parsePrimitives = true) {
-	const params = new URLSearchParams(query.startsWith("?") ? query.slice(1) : query);
-	const entries = {};
-	for (const [key, value] of params.entries()) if (key in entries) {
-		const current = entries[key];
-		const array = Array.isArray(current) ? [...current, value] : [current, value];
-		entries[key] = parsePrimitives ? require_basics.deepParsePrimitives(array) : array;
-	} else entries[key] = value;
-	return parsePrimitives ? require_objectify.parseObjectValues(entries) : entries;
-}
-/**
-* Parses a query string (with optional `?` prefix) into an object.
-* Supports multiple values for the same key by returning arrays.
-* It returns properly typed object.
-*
-* @remarks This utility is designed to parse literal string, for generic use, try {@link parseQueryString}.
-*
-* - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
-*
-* @param query - The literal query string to parse.
-* @returns An object where keys are strings and values can be string, array, or null/undefined.
-*/
-function parseQueryStringLiteral(query) {
-	const params = new URLSearchParams(query.startsWith("?") ? query.slice(1) : query);
-	const entries = {};
-	for (const [key, value] of params.entries()) if (key in entries) {
-		const current = entries[key];
-		entries[key] = Array.isArray(current) ? [...current, value] : [current, value];
-	} else entries[key] = value;
-	return entries;
-}
-
-//#endregion
 //#region src/dom/storage.ts
 /**
 * * Get item from local storage.
@@ -338,15 +253,15 @@ const createFormData = (data, configs) => {
 	const _addToFormData = (key, value) => {
 		const transformedKey = _transformKey(key);
 		if (_compareKeyPaths(transformedKey, ignoreKeys)) return;
-		if (require_objectify.isCustomFileArray(value)) value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
-		else if (require_objectify.isFileUpload(value)) {
-			if (value?.fileList) value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
-			else if (value?.file) if (require_objectify.isCustomFile(value?.file)) formData.append(transformedKey, value?.file?.originFileObj);
+		if (require_query.isCustomFileArray(value)) for (const file of value) formData.append(transformedKey, file?.originFileObj);
+		else if (require_query.isFileUpload(value)) {
+			if (value?.fileList) for (const file of value.fileList) formData.append(transformedKey, file?.originFileObj);
+			else if (value?.file) if (require_query.isCustomFile(value?.file)) formData.append(transformedKey, value?.file?.originFileObj);
 			else formData.append(transformedKey, value?.file);
-		} else if (require_objectify.isFileOrBlob(value)) formData.append(transformedKey, value);
-		else if (require_objectify.isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value.item(i));
+		} else if (require_query.isFileOrBlob(value)) formData.append(transformedKey, value);
+		else if (require_query.isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value?.item(i));
 		else if (Array.isArray(value)) {
-			if (require_objectify.isFileArray(value)) if (_shouldBreakArray(key)) value?.forEach((item, index) => {
+			if (require_query.isFileArray(value)) if (_shouldBreakArray(key)) value?.forEach((item, index) => {
 				_addToFormData(`${transformedKey}[${index}]`, item);
 			});
 			else value?.forEach((item) => {
@@ -381,7 +296,7 @@ const createFormData = (data, configs) => {
 			if (_shouldDotNotate(fullKey)) _addToFormData(fullKey, value);
 			else if (require_specials.isNotEmptyObject(value) && !_shouldStringify(fullKey)) if (require_basics.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else _processObject(value, key);
-			else if (require_objectify.isFileOrBlob(value)) _addToFormData(key, value);
+			else if (require_query.isFileOrBlob(value)) _addToFormData(key, value);
 			else if (require_basics.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else if (require_specials.isEmptyObject(value)) {
 				if (_isRequiredKey(fullKey)) _addToFormData(key, JSON.stringify(value));
@@ -409,7 +324,7 @@ function serializeForm(form, toQueryString = false) {
 		if (data[key]) data[key] = Array.isArray(data[key]) ? [...data[key], value.toString()] : [data[key], value.toString()];
 		else data[key] = value.toString();
 	});
-	if (toQueryString) return generateQueryParams(data);
+	if (toQueryString) return require_query.generateQueryParams(data);
 	return data;
 }
 /**
@@ -436,7 +351,7 @@ function parseFormData(data, parsePrimitives = true) {
 		else if (Array.isArray(existing)) parsed[key] = [...existing, value];
 		else parsed[key] = value;
 	});
-	if (parsePrimitives) return require_objectify.parseObjectValues(parsed);
+	if (parsePrimitives) return require_query.parseObjectValues(parsed);
 	else return parsed;
 }
 
@@ -444,26 +359,26 @@ function parseFormData(data, parsePrimitives = true) {
 exports.convertToFormData = createFormData;
 exports.copyToClipboard = copyToClipboard;
 exports.createFormData = createFormData;
-exports.createQueryParams = generateQueryParams;
-exports.formatQueryParams = generateQueryParams;
-exports.generateQueryParams = generateQueryParams;
+exports.createQueryParams = require_query.generateQueryParams;
+exports.formatQueryParams = require_query.generateQueryParams;
+exports.generateQueryParams = require_query.generateQueryParams;
 exports.getFromLocalStorage = getFromLocalStorage;
 exports.getFromSessionStorage = getFromSessionStorage;
-exports.getQueryParams = getQueryParams;
-exports.getQueryStringAsObject = parseQueryString;
-exports.isCustomFile = require_objectify.isCustomFile;
-exports.isCustomFileArray = require_objectify.isCustomFileArray;
-exports.isFileArray = require_objectify.isFileArray;
-exports.isFileList = require_objectify.isFileList;
-exports.isFileOrBlob = require_objectify.isFileOrBlob;
-exports.isFileUpload = require_objectify.isFileUpload;
-exports.isOriginFileObj = require_objectify.isOriginFileObj;
-exports.isValidFormData = require_objectify.isValidFormData;
-exports.literalQueryStringToObject = parseQueryStringLiteral;
+exports.getQueryParams = require_query.getQueryParams;
+exports.getQueryStringAsObject = require_query.parseQueryString;
+exports.isCustomFile = require_query.isCustomFile;
+exports.isCustomFileArray = require_query.isCustomFileArray;
+exports.isFileArray = require_query.isFileArray;
+exports.isFileList = require_query.isFileList;
+exports.isFileOrBlob = require_query.isFileOrBlob;
+exports.isFileUpload = require_query.isFileUpload;
+exports.isOriginFileObj = require_query.isOriginFileObj;
+exports.isValidFormData = require_query.isValidFormData;
+exports.literalQueryStringToObject = require_query.parseQueryStringLiteral;
 exports.parseFormData = parseFormData;
-exports.parseQueryString = parseQueryString;
-exports.parseQueryStringLiteral = parseQueryStringLiteral;
-exports.queryStringToObject = parseQueryString;
+exports.parseQueryString = require_query.parseQueryString;
+exports.parseQueryStringLiteral = require_query.parseQueryStringLiteral;
+exports.queryStringToObject = require_query.parseQueryString;
 exports.removeFromLocalStorage = removeFromLocalStorage;
 exports.removeFromSessionStorage = removeFromSessionStorage;
 exports.saveToLocalStorage = saveToLocalStorage;
@@ -471,4 +386,4 @@ exports.saveToSessionStorage = saveToSessionStorage;
 exports.serializeForm = serializeForm;
 exports.smoothScrollTo = smoothScrollTo;
 exports.toggleFullScreen = toggleFullScreen;
-exports.updateQueryParam = updateQueryParam;
+exports.updateQueryParam = require_query.updateQueryParam;

package/dist/dom.d.cts

@@ -14,67 +14,10 @@
  * limitations under the License.
  */
 
-import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-DyVg8BFt.cjs";
-import { F as QueryString } from "./string-EMT7czsU.cjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-CHFqlgPr.cjs";
+import { J as Deserializer, ft as Serializer, y as GenericObject } from "./object-DyVg8BFt.cjs";
+import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "./query-BLsaWi3q.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-DA-YShnM.cjs";
 
-//#region src/dom/query.d.ts
-/**
- * * Utility to generate query parameters from an object.
- *
- * @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"
- */
-declare function generateQueryParams<T extends QueryObject>(params?: T): QueryString;
-/**
- * * Get query params as standard `JavaScript` Object `Record<string, string>`. You can define the type by passing a type argument.
- *
- * - **Note:** *Extracts query parameters from the current URL (window.location.search).*
- *
- * @returns Query string as key-value paired object. `Record<string, string>`.
- */
-declare function getQueryParams<QParams extends Record<string, string>>(): QParams;
-/**
- * * 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.
- */
-declare function updateQueryParam(key: string, value: string): void;
-/**
- * Parses a query string (with optional `?` prefix) into an object.
- * Supports multiple values for the same key by returning arrays.
- * Optionally parses primitive string values into actual types (e.g., "1" → 1, "true" → true).
- *
- * @remarks This utility is designed to parse generic string, for literal use, try {@link parseQueryStringLiteral}.
- *
- * - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
- *
- * @param query - The query string to parse.
- * @param parsePrimitives - Whether to convert stringified primitives into real values (default: true).
- * @returns An object where keys are strings and values can be string, array, number, boolean, or null/undefined.
- */
-declare function parseQueryString<QParams extends ParsedQueryGeneric>(query: string, parsePrimitives?: boolean): QParams;
-/**
- * Parses a query string (with optional `?` prefix) into an object.
- * Supports multiple values for the same key by returning arrays.
- * It returns properly typed object.
- *
- * @remarks This utility is designed to parse literal string, for generic use, try {@link parseQueryString}.
- *
- * - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
- *
- * @param query - The literal query string to parse.
- * @returns An object where keys are strings and values can be string, array, or null/undefined.
- */
-declare function parseQueryStringLiteral<Q extends string>(query: Q): ParsedQuery<Q>;
-//#endregion
 //#region src/dom/storage.d.ts
 /**
  * * Get item from local storage.
@@ -223,6 +166,6 @@ declare function serializeForm<T extends boolean = false>(form: HTMLFormElement,
  * @param parsePrimitives - Whether to parse string values into primitive types (e.g., boolean, number, array, object). Defaults to `true`.
  * @returns The parsed form data as an object.
  */
-declare function parseFormData<T extends FormData | string>(data: T, parsePrimitives?: boolean): ParsedFormData<T>;
+declare function parseFormData<D extends FormData | string, P extends boolean = true>(data: D, parsePrimitives?: P): ParsedFormData<D, P>;
 //#endregion
 export { createFormData as convertToFormData, createFormData, copyToClipboard, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, getFromLocalStorage, getFromSessionStorage, getQueryParams, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileOrBlob, isFileUpload, isOriginFileObj, isValidFormData, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, parseFormData, removeFromLocalStorage, removeFromSessionStorage, saveToLocalStorage, saveToSessionStorage, serializeForm, smoothScrollTo, toggleFullScreen, updateQueryParam };

package/dist/dom.d.mts

@@ -14,67 +14,10 @@
  * limitations under the License.
  */
 
-import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-DyVg8BFt.mjs";
-import { F as QueryString } from "./string-GQsmDdYa.mjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-crhNgN40.mjs";
+import { J as Deserializer, ft as Serializer, y as GenericObject } from "./object-DyVg8BFt.mjs";
+import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "./query-Bi_ofCBp.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-DIYoIS0E.mjs";
 
-//#region src/dom/query.d.ts
-/**
- * * Utility to generate query parameters from an object.
- *
- * @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"
- */
-declare function generateQueryParams<T extends QueryObject>(params?: T): QueryString;
-/**
- * * Get query params as standard `JavaScript` Object `Record<string, string>`. You can define the type by passing a type argument.
- *
- * - **Note:** *Extracts query parameters from the current URL (window.location.search).*
- *
- * @returns Query string as key-value paired object. `Record<string, string>`.
- */
-declare function getQueryParams<QParams extends Record<string, string>>(): QParams;
-/**
- * * 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.
- */
-declare function updateQueryParam(key: string, value: string): void;
-/**
- * Parses a query string (with optional `?` prefix) into an object.
- * Supports multiple values for the same key by returning arrays.
- * Optionally parses primitive string values into actual types (e.g., "1" → 1, "true" → true).
- *
- * @remarks This utility is designed to parse generic string, for literal use, try {@link parseQueryStringLiteral}.
- *
- * - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
- *
- * @param query - The query string to parse.
- * @param parsePrimitives - Whether to convert stringified primitives into real values (default: true).
- * @returns An object where keys are strings and values can be string, array, number, boolean, or null/undefined.
- */
-declare function parseQueryString<QParams extends ParsedQueryGeneric>(query: string, parsePrimitives?: boolean): QParams;
-/**
- * Parses a query string (with optional `?` prefix) into an object.
- * Supports multiple values for the same key by returning arrays.
- * It returns properly typed object.
- *
- * @remarks This utility is designed to parse literal string, for generic use, try {@link parseQueryString}.
- *
- * - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
- *
- * @param query - The literal query string to parse.
- * @returns An object where keys are strings and values can be string, array, or null/undefined.
- */
-declare function parseQueryStringLiteral<Q extends string>(query: Q): ParsedQuery<Q>;
-//#endregion
 //#region src/dom/storage.d.ts
 /**
  * * Get item from local storage.
@@ -223,6 +166,6 @@ declare function serializeForm<T extends boolean = false>(form: HTMLFormElement,
  * @param parsePrimitives - Whether to parse string values into primitive types (e.g., boolean, number, array, object). Defaults to `true`.
  * @returns The parsed form data as an object.
  */
-declare function parseFormData<T extends FormData | string>(data: T, parsePrimitives?: boolean): ParsedFormData<T>;
+declare function parseFormData<D extends FormData | string, P extends boolean = true>(data: D, parsePrimitives?: P): ParsedFormData<D, P>;
 //#endregion
 export { createFormData as convertToFormData, createFormData, copyToClipboard, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, getFromLocalStorage, getFromSessionStorage, getQueryParams, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileOrBlob, isFileUpload, isOriginFileObj, isValidFormData, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, parseFormData, removeFromLocalStorage, removeFromSessionStorage, saveToLocalStorage, saveToSessionStorage, serializeForm, smoothScrollTo, toggleFullScreen, updateQueryParam };

package/dist/dom.mjs

@@ -16,94 +16,9 @@
 
 import { a as isNonEmptyString, d as isString } from "./primitives-Djsevc69.mjs";
 import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-Hq5Ncd6y.mjs";
-import { I as deepParsePrimitives, J as isDateLike, n as trimString } from "./basics-Dald7J6c.mjs";
-import { _ as isOriginFileObj, a as flattenObjectKeyValue, d as isCustomFile, f as isCustomFileArray, g as isFileUpload, h as isFileOrBlob, l as parseObjectValues, m as isFileList, p as isFileArray, v as isValidFormData } from "./objectify-BoIZEKOL.mjs";
+import { J as isDateLike, n as trimString } from "./basics-Dald7J6c.mjs";
+import { C as isValidFormData, S as isOriginFileObj, _ as isCustomFileArray, a as updateQueryParam, b as isFileOrBlob, g as isCustomFile, i as parseQueryStringLiteral, m as parseObjectValues, n as getQueryParams, r as parseQueryString, t as generateQueryParams, v as isFileArray, x as isFileUpload, y as isFileList } from "./query-B4Lrr5Vt.mjs";
 
-//#region src/dom/query.ts
-/**
-* * Utility to generate query parameters from an object.
-*
-* @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"
-*/
-function generateQueryParams(params = {}) {
-	const flattenedParams = flattenObjectKeyValue(params);
-	const queryParams = Object.entries(flattenedParams)?.filter(([_, value]) => value != null && !(isString(value) && value?.trim() === ""))?.flatMap(([key, value]) => Array.isArray(value) ? value?.filter((v) => v != null && !(isString(v) && v.trim() === ""))?.map((v) => `${encodeURIComponent(key)}=${encodeURIComponent(String(v))}`) : `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join("&");
-	return queryParams ? `?${queryParams}` : "";
-}
-/**
-* * Get query params as standard `JavaScript` Object `Record<string, string>`. You can define the type by passing a type argument.
-*
-* - **Note:** *Extracts query parameters from the current URL (window.location.search).*
-*
-* @returns Query string as key-value paired object. `Record<string, string>`.
-*/
-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.
-*/
-function updateQueryParam(key, value) {
-	const url = new URL(window.location.href);
-	url.searchParams.set(key, value);
-	window.history.replaceState({}, "", url?.toString());
-}
-/**
-* Parses a query string (with optional `?` prefix) into an object.
-* Supports multiple values for the same key by returning arrays.
-* Optionally parses primitive string values into actual types (e.g., "1" → 1, "true" → true).
-*
-* @remarks This utility is designed to parse generic string, for literal use, try {@link parseQueryStringLiteral}.
-*
-* - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
-*
-* @param query - The query string to parse.
-* @param parsePrimitives - Whether to convert stringified primitives into real values (default: true).
-* @returns An object where keys are strings and values can be string, array, number, boolean, or null/undefined.
-*/
-function parseQueryString(query, parsePrimitives = true) {
-	const params = new URLSearchParams(query.startsWith("?") ? query.slice(1) : query);
-	const entries = {};
-	for (const [key, value] of params.entries()) if (key in entries) {
-		const current = entries[key];
-		const array = Array.isArray(current) ? [...current, value] : [current, value];
-		entries[key] = parsePrimitives ? deepParsePrimitives(array) : array;
-	} else entries[key] = value;
-	return parsePrimitives ? parseObjectValues(entries) : entries;
-}
-/**
-* Parses a query string (with optional `?` prefix) into an object.
-* Supports multiple values for the same key by returning arrays.
-* It returns properly typed object.
-*
-* @remarks This utility is designed to parse literal string, for generic use, try {@link parseQueryString}.
-*
-* - **Note:** *This function does **not** access or depend on `current URL` a.k.a `window.location.search`.*
-*
-* @param query - The literal query string to parse.
-* @returns An object where keys are strings and values can be string, array, or null/undefined.
-*/
-function parseQueryStringLiteral(query) {
-	const params = new URLSearchParams(query.startsWith("?") ? query.slice(1) : query);
-	const entries = {};
-	for (const [key, value] of params.entries()) if (key in entries) {
-		const current = entries[key];
-		entries[key] = Array.isArray(current) ? [...current, value] : [current, value];
-	} else entries[key] = value;
-	return entries;
-}
-
-//#endregion
 //#region src/dom/storage.ts
 /**
 * * Get item from local storage.
@@ -337,13 +252,13 @@ const createFormData = (data, configs) => {
 	const _addToFormData = (key, value) => {
 		const transformedKey = _transformKey(key);
 		if (_compareKeyPaths(transformedKey, ignoreKeys)) return;
-		if (isCustomFileArray(value)) value?.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+		if (isCustomFileArray(value)) for (const file of value) formData.append(transformedKey, file?.originFileObj);
 		else if (isFileUpload(value)) {
-			if (value?.fileList) value?.fileList.forEach((file) => formData.append(transformedKey, file?.originFileObj));
+			if (value?.fileList) for (const file of value.fileList) formData.append(transformedKey, file?.originFileObj);
 			else if (value?.file) if (isCustomFile(value?.file)) formData.append(transformedKey, value?.file?.originFileObj);
 			else formData.append(transformedKey, value?.file);
 		} else if (isFileOrBlob(value)) formData.append(transformedKey, value);
-		else if (isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value.item(i));
+		else if (isFileList(value)) for (let i = 0; i < value?.length; i++) formData.append(transformedKey, value?.item(i));
 		else if (Array.isArray(value)) {
 			if (isFileArray(value)) if (_shouldBreakArray(key)) value?.forEach((item, index) => {
 				_addToFormData(`${transformedKey}[${index}]`, item);

package/dist/{form-CHFqlgPr.d.cts → form-DA-YShnM.d.cts}

@@ -14,8 +14,9 @@
  * limitations under the License.
  */
 
-import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.cjs";
+import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.cjs";
 import { F as QueryString } from "./string-EMT7czsU.cjs";
+import { f as TypeOrArray } from "./array-EVkwcL_k.cjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */
@@ -111,6 +112,6 @@ interface FileError extends Error {
 /** THe return type of `serializeForm` wither as object or query string. */
 type SerializedForm<T extends boolean> = T extends false ? Record<string, string | string[]> : QueryString;
 /** * Represents the parsed form data. */
-type ParsedFormData<T> = T extends string ? Record<string, string | string[]> : Record<string, string | string[] | File | File[]>;
+type ParsedFormData<T extends FormData | string, P extends boolean> = T extends string ? Record<string, P extends true ? TypeOrArray<NormalPrimitive> : TypeOrArray<string>> : Record<string, P extends true ? TypeOrArray<NormalPrimitive | File> : TypeOrArray<string | File>>;
 //#endregion
 export { OriginFileObj as a, FormDataConfigs as i, FileError as n, ParsedFormData as o, FileUpload as r, SerializedForm as s, CustomFile as t };

package/dist/{form-crhNgN40.d.mts → form-DIYoIS0E.d.mts}

@@ -14,8 +14,9 @@
  * limitations under the License.
  */
 
-import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.mjs";
+import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.mjs";
 import { F as QueryString } from "./string-GQsmDdYa.mjs";
+import { f as TypeOrArray } from "./array-CbAKXvhH.mjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */
@@ -111,6 +112,6 @@ interface FileError extends Error {
 /** THe return type of `serializeForm` wither as object or query string. */
 type SerializedForm<T extends boolean> = T extends false ? Record<string, string | string[]> : QueryString;
 /** * Represents the parsed form data. */
-type ParsedFormData<T> = T extends string ? Record<string, string | string[]> : Record<string, string | string[] | File | File[]>;
+type ParsedFormData<T extends FormData | string, P extends boolean> = T extends string ? Record<string, P extends true ? TypeOrArray<NormalPrimitive> : TypeOrArray<string>> : Record<string, P extends true ? TypeOrArray<NormalPrimitive | File> : TypeOrArray<string | File>>;
 //#endregion
 export { OriginFileObj as a, FormDataConfigs as i, FileError as n, ParsedFormData as o, FileUpload as r, SerializedForm as s, CustomFile as t };

package/dist/guards.d.cts

@@ -16,7 +16,7 @@
 
 import { $ as GenericFn, B as AsyncFunction, Dn as UTCOffset, Ft as DateLike, Z as FalsyPrimitive, _n as TimeWithUnit, at as NormalPrimitive, ct as Numeric, dt as Primitive, jt as ClockTime, nt as Maybe, pt as ValidArray, rt as MethodDescriptor, wt as $TimeZoneIdentifier, xn as TimeZoneIdNative, y as GenericObject } from "./object-DyVg8BFt.cjs";
 import { b as RGB, g as HSLA, h as HSL, s as CSSColor, v as Hex6, x as RGBA, y as Hex8 } from "./Color-asKZqwDF.cjs";
-import { S as isInvalidOrEmptyArray, f as isDeepEqual, v as isPrime } from "./index-BgomIbws.cjs";
+import { S as isInvalidOrEmptyArray, f as isDeepEqual, v as isPrime } from "./index-D00Uqm9S.cjs";
 import { C as isURL, S as isPhoneNumber, _ as isEnvironment, a as isUUIDv4, b as isNode, c as isUUIDv7, d as isBase64, f as isBinaryString, g as isEmailArray, h as isEmail, i as isUUIDv3, l as isUUIDv8, m as isDateString, n as isUUIDv1, o as isUUIDv5, p as isBrowser, r as isUUIDv2, s as isUUIDv6, v as isHexString, w as isUUID, x as isNumericString, y as isIPAddress } from "./uuid-CMNRM9NO.cjs";
 
 //#region src/colors/guards.d.ts

package/dist/guards.d.mts

@@ -16,7 +16,7 @@
 
 import { $ as GenericFn, B as AsyncFunction, Dn as UTCOffset, Ft as DateLike, Z as FalsyPrimitive, _n as TimeWithUnit, at as NormalPrimitive, ct as Numeric, dt as Primitive, jt as ClockTime, nt as Maybe, pt as ValidArray, rt as MethodDescriptor, wt as $TimeZoneIdentifier, xn as TimeZoneIdNative, y as GenericObject } from "./object-DyVg8BFt.mjs";
 import { b as RGB, g as HSLA, h as HSL, s as CSSColor, v as Hex6, x as RGBA, y as Hex8 } from "./Color-B2SgCGbm.mjs";
-import { S as isInvalidOrEmptyArray, f as isDeepEqual, v as isPrime } from "./index-C9x0f9jU.mjs";
+import { S as isInvalidOrEmptyArray, f as isDeepEqual, v as isPrime } from "./index-BbBnKdBb.mjs";
 import { C as isURL, S as isPhoneNumber, _ as isEnvironment, a as isUUIDv4, b as isNode, c as isUUIDv7, d as isBase64, f as isBinaryString, g as isEmailArray, h as isEmail, i as isUUIDv3, l as isUUIDv8, m as isDateString, n as isUUIDv1, o as isUUIDv5, p as isBrowser, r as isUUIDv2, s as isUUIDv6, v as isHexString, w as isUUID, x as isNumericString, y as isIPAddress } from "./uuid-DvQsIl9p.mjs";
 
 //#region src/colors/guards.d.ts

package/dist/{index-C9x0f9jU.d.mts → index-BbBnKdBb.d.mts}

@@ -15,7 +15,7 @@
  */
 
 import { G as ConditionFns, K as Constructor, U as ClassDetails, Xr as ProtoMethodOptions, br as ArrayOfObjectsToStringOptions, dt as Primitive, mt as VoidFn, nt as Maybe, q as DelayedFn, xr as ArrayOfPrimitivesToStringOptions, y as GenericObject } from "./object-DyVg8BFt.mjs";
-import { a as Flattened } from "./array-D8VGEDBI.mjs";
+import { a as Flattened } from "./array-CbAKXvhH.mjs";
 
 //#region src/array/basics.d.ts
 /**

package/dist/{index-BgomIbws.d.cts → index-D00Uqm9S.d.cts}

@@ -15,7 +15,7 @@
  */
 
 import { G as ConditionFns, K as Constructor, U as ClassDetails, Xr as ProtoMethodOptions, br as ArrayOfObjectsToStringOptions, dt as Primitive, mt as VoidFn, nt as Maybe, q as DelayedFn, xr as ArrayOfPrimitivesToStringOptions, y as GenericObject } from "./object-DyVg8BFt.cjs";
-import { a as Flattened } from "./array-ChT6TxQ7.cjs";
+import { a as Flattened } from "./array-EVkwcL_k.cjs";
 
 //#region src/array/basics.d.ts
 /**