nhb-toolbox 4.11.4 → 4.11.6

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CapitalizeOptions, R as RandomIdOptions, a as CaseFormat, M as MaskOptions, N as Numeric, P as Percent, b as ColorInputArray, H as Hex6, c as RGB, d as HSL, e as Hex8, f as RGBA, g as HSLA, h as Hex, A as AlphaValues, S as SolidValues, G as GenericObject, F as Flattened, O as OwnKeys, i as FindOptions, j as SortByOption, k as OrderOption, l as OptionsConfig, m as FieldValue, n as SortNature, o as FormDataConfigs, p as ParsedFormData, q as SerializedForm, r as CustomFile, s as FileUpload, t as OriginFileObj, u as FlattenPartial, v as Any, w as PartialOrRequired, x as SanitizeOptions, D as DotNotationKey, y as Stringified, z as Numberified, Q as QueryObject, B as QueryString, E as StrictObject, I as Constructor, V as VoidFunction, J as DelayedFn, K as ClassDetails, T as ThrottledFn, L as PaginatorOptions, U as PaginatorMeta, W as PageListOptions, X as FromMetaOptions, Y as FalsyPrimitive, Z as NormalPrimitive, _ as Primitive, $ as AsyncFunction, a0 as GenericFn } from './types-uginMOiI.mjs';
-export { a1 as Color, a1 as Colour } from './types-uginMOiI.mjs';
+import { C as CapitalizeOptions, R as RandomIdOptions, a as CaseFormat, M as MaskOptions, N as Numeric, P as Percent, b as ColorInputArray, H as Hex6, c as RGB, d as HSL, e as Hex8, f as RGBA, g as HSLA, h as Hex, A as AlphaValues, S as SolidValues, G as GenericObject, F as Flattened, O as OwnKeys, i as FindOptions, j as SortByOption, k as OrderOption, l as OptionsConfig, m as FieldValue, n as SortNature, o as FormDataConfigs, p as ParsedFormData, q as SerializedForm, r as CustomFile, s as FileUpload, t as OriginFileObj, u as FlattenPartial, v as Any, w as PartialOrRequired, x as SanitizeOptions, D as DotNotationKey, y as Stringified, z as Numberified, Q as QueryObject, B as QueryString, E as StrictObject, I as Constructor, V as VoidFunction, J as DelayedFn, K as ClassDetails, T as ThrottledFn, L as PaginatorOptions, U as PaginatorMeta, W as PageListOptions, X as FromMetaOptions, Y as FalsyPrimitive, Z as NormalPrimitive, _ as Primitive, $ as AsyncFunction, a0 as GenericFn } from './typedefs-BYmqOW77.mjs';
+export { a1 as Color, a1 as Colour } from './typedefs-BYmqOW77.mjs';
 import { D as DecimalOptions, b as ConvertedDecimal, R as RandomNumberOptions, c as CurrencyCode, L as LocaleCode, S as SupportedCurrency, d as ConvertOptions, P as PercentageOptions, N as NumberType, e as RangeOptions, f as RangedNumbers, G as GreetingConfigs, T as Time, U as UTCOffSet } from './Chronos-v7ni8eaQ.mjs';
 export { g as Unit, g as UnitConverter } from './Chronos-v7ni8eaQ.mjs';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CapitalizeOptions, R as RandomIdOptions, a as CaseFormat, M as MaskOptions, N as Numeric, P as Percent, b as ColorInputArray, H as Hex6, c as RGB, d as HSL, e as Hex8, f as RGBA, g as HSLA, h as Hex, A as AlphaValues, S as SolidValues, G as GenericObject, F as Flattened, O as OwnKeys, i as FindOptions, j as SortByOption, k as OrderOption, l as OptionsConfig, m as FieldValue, n as SortNature, o as FormDataConfigs, p as ParsedFormData, q as SerializedForm, r as CustomFile, s as FileUpload, t as OriginFileObj, u as FlattenPartial, v as Any, w as PartialOrRequired, x as SanitizeOptions, D as DotNotationKey, y as Stringified, z as Numberified, Q as QueryObject, B as QueryString, E as StrictObject, I as Constructor, V as VoidFunction, J as DelayedFn, K as ClassDetails, T as ThrottledFn, L as PaginatorOptions, U as PaginatorMeta, W as PageListOptions, X as FromMetaOptions, Y as FalsyPrimitive, Z as NormalPrimitive, _ as Primitive, $ as AsyncFunction, a0 as GenericFn } from './types-C33n5Qt0.js';
-export { a1 as Color, a1 as Colour } from './types-C33n5Qt0.js';
+import { C as CapitalizeOptions, R as RandomIdOptions, a as CaseFormat, M as MaskOptions, N as Numeric, P as Percent, b as ColorInputArray, H as Hex6, c as RGB, d as HSL, e as Hex8, f as RGBA, g as HSLA, h as Hex, A as AlphaValues, S as SolidValues, G as GenericObject, F as Flattened, O as OwnKeys, i as FindOptions, j as SortByOption, k as OrderOption, l as OptionsConfig, m as FieldValue, n as SortNature, o as FormDataConfigs, p as ParsedFormData, q as SerializedForm, r as CustomFile, s as FileUpload, t as OriginFileObj, u as FlattenPartial, v as Any, w as PartialOrRequired, x as SanitizeOptions, D as DotNotationKey, y as Stringified, z as Numberified, Q as QueryObject, B as QueryString, E as StrictObject, I as Constructor, V as VoidFunction, J as DelayedFn, K as ClassDetails, T as ThrottledFn, L as PaginatorOptions, U as PaginatorMeta, W as PageListOptions, X as FromMetaOptions, Y as FalsyPrimitive, Z as NormalPrimitive, _ as Primitive, $ as AsyncFunction, a0 as GenericFn } from './typedefs-C3luCa9l.js';
+export { a1 as Color, a1 as Colour } from './typedefs-C3luCa9l.js';
 import { D as DecimalOptions, b as ConvertedDecimal, R as RandomNumberOptions, c as CurrencyCode, L as LocaleCode, S as SupportedCurrency, d as ConvertOptions, P as PercentageOptions, N as NumberType, e as RangeOptions, f as RangedNumbers, G as GreetingConfigs, T as Time, U as UTCOffSet } from './Chronos-v7ni8eaQ.js';
 export { g as Unit, g as UnitConverter } from './Chronos-v7ni8eaQ.js';
 

package/dist/{types-uginMOiI.d.mts → typedefs-BYmqOW77.d.mts}

@@ -45,191 +45,76 @@ interface MaskOptions {
 /** Formatted query string as `?${string}` = `?key=value&...` or empty string. */
 type QueryString = `?${string}` | '';
 
-/** - Generic object with `unknown` value */
-type StrictObject = Record<string, unknown>;
-/** - Generic object but with `any` value */
-type GenericObject = Record<string, any>;
-/**
- * * Represents a value that can be used in a query object.
- * - Can be a primitive, an array of primitives, or a nested query object.
- */
-type QueryObjectValue = NormalPrimitive | NormalPrimitive[] | QueryObject;
-/**
- * * Represents a query object with string keys and `QueryObjectValue` values.
- * - Supports nested objects and arrays.
- */
-type QueryObject = {
-    [key: string]: QueryObjectValue;
-};
-/** - Object type with string or number or boolean as value for each key. */
-type GenericObjectPrimitive = Record<string, string | number | boolean>;
-/** - Dot-notation keys for nested objects with unknown value (including optional properties) */
-type DotNotationKeyStrict<T> = T extends AdvancedTypes ? never : T extends StrictObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (StrictObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
-}[keyof T & string] : never;
-/** - Dot-notation keys for nested objects with `any` value (including optional properties) */
-type DotNotationKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
-}[keyof T & string] : never;
-/** - Object keys where the value is an array (including optional properties) */
-type KeyForArray<T> = T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (Array<unknown>) ? K : never;
-}[keyof T & string] : never;
-/** - Object keys where the value is a non-array/non-advanced type object (including optional properties) */
-type KeyForObject<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? NonNullable<T[K]> extends AdvancedTypes ? never : K : never;
-}[keyof T & string] : never;
-/** - Extract only keys with string values from an object, including nested dot-notation keys. */
-type NestedKeyString<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends string ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedKeyString<NonNullable<T[K]>>}` : never;
-}[keyof T & string] : never;
-/** - Extract only primitive keys from an object, including nested dot-notation keys. */
-type NestedPrimitiveKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (NormalPrimitive) ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedPrimitiveKey<NonNullable<T[K]>>}` : never;
-}[keyof T & string] : never;
-/** - Options for `sanitizeData` utility. */
-interface SanitizeOptions<T> {
-    /**
-     * An array of dot-notation keys to exclude from the sanitized output.
-     * This is only applicable when sanitizing plain objects or arrays of objects.
-     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
-     */
-    keysToIgnore?: DotNotationKey<T>[];
-    /** Whether to trim string values. Defaults to `true`. */
-    trimStrings?: boolean;
-    /** Whether to exclude nullish (`null` or `undefined`) values. Defaults to `false`. */
-    ignoreNullish?: boolean;
-    /** Whether to exclude all falsy values (`false`, `0`, `empty string: ''`, `null`, `undefined`. Defaults to `false`. */
-    ignoreFalsy?: boolean;
-    /** Whether to exclude empty object(s) and array(s) (`{}`, `[]`). Defaults to `false`. */
-    ignoreEmpty?: boolean;
-    /**
-     * An array of dot-notation key paths that must be preserved in the sanitized output.
-     * Use `"*"` to retain all keys. This applies primarily to plain or nested objects and arrays of objects.
-     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
-     */
-    requiredKeys?: '*' | DotNotationKey<T>[];
-}
-/** - Type of data value converted to `string` */
-type Stringified<T> = {
-    [K in keyof T]: T[K] extends (infer U)[] ? Stringified<U>[] : T[K] extends object | null | undefined ? Stringified<T[K]> : T[K] extends string | number ? string : T[K];
-};
-/** - Type of data value converted to `number` */
-type Numberified<T> = {
-    [K in keyof T]: T[K] extends (infer U)[] ? Numberified<U>[] : T[K] extends object | null | undefined ? Numberified<T[K]> : T[K] extends string ? number : T[K] extends number ? T[K] : number;
+/** Uncontrolled any to use for edge cases */
+type Any = any;
+declare const __brand: unique symbol;
+type Brand<B> = {
+    [__brand]: B;
 };
-
-/** * Flatten Array or Wrap in Array */
-type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
+/** Create a branded type. */
+type Branded<T, B> = T & Brand<B>;
+/** Utility type to flatten Partial type */
+type FlattenPartial<T> = Partial<{
+    [K in keyof T]: T[K];
+}>;
+/** Union of `number` and numeric string */
+type Numeric = number | `${number}`;
+/** Union of All Primitive Types (i.e. `string | number | boolean | symbol | bigint | null | undefined`) */
+type Primitive = string | number | boolean | symbol | bigint | null | undefined;
+/** Union of Normal Primitive Types (i.e. `string | number | boolean | null | undefined`) */
+type NormalPrimitive = string | number | boolean | null | undefined;
+/** Extract normal primitive key(s) (i.e. `string | number | boolean | null | undefined`) from an object */
+type NormalPrimitiveKey<T> = {
+    [K in keyof T]: T[K] extends NormalPrimitive ? K : never;
+}[keyof T];
 /**
- * * Configuration for `createOptionsArray`.
- * - Defines the mapping between keys in the input objects and the keys in the output options.
- *
- * @typeParam T - The type of the objects in the input array.
- * @typeParam K1 - The name of the key for the first field in the output (default: `'value'`).
- * @typeParam K2 - The name of the key for the second field in the output (default: `'label'`).
- * @typeParam V - Whether to keep the `value` field as number if it is a number. Defaults to `false`.
+ * * Keys of an object that are part of the object type itself.
+ * This excludes keys that are inherited from the prototype chain.
+ * This type is useful for extracting keys that are part of the object's own properties.
+ * It is used in the `OwnKeys` type to filter out keys that are not part of the object properties.
  */
-interface OptionsConfig<T, K1, K2, V extends boolean = false> {
-    /**
-     * - The key in the input objects to use for the first field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
-     * @example
-     * // If the input objects have an `id` field and you want to use it as the `value` field in the output:
-     * createOptionsArray(data, {firstFieldKey: 'id'}).
-     */
-    firstFieldKey: NormalPrimitiveKey<T>;
-    /**
-     * - The key in the input objects to use for the second field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
-     * @example
-     * // If the input objects have a `name` field and you want to use it as the `label` field in the output:
-     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name'}).
-     */
-    secondFieldKey: NormalPrimitiveKey<T>;
-    /**
-     * - The name of the first field in the output object.
-     * - Defaults to `'value'`.
-     * @example
-     * // If you want the output field to be named `'key'` instead of `'value'`:
-     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key'}).
-     */
-    firstFieldName?: K1;
-    /**
-     * - The name of the second field in the output object.
-     * - Defaults to `'label'`.
-     * @example
-     * // If you want the output field to be named `'title'` instead of `'label'`:
-     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key', secondFieldName: 'title'}).
-     */
-    secondFieldName?: K2;
-    /**
-     * - If `true`, numeric values from `firstFieldKey` will remain as numbers.
-     * - All other values (including booleans, null, undefined) will be converted to strings.
-     * - When `false` (default), all values are converted to strings.
-     * - Defaults to `false`.
-     * @example
-     * // Numeric IDs remain as numbers
-     * createOptionsArray(data, {
-     *   firstFieldKey: 'id',
-     *   secondFieldKey: 'name',
-     *   retainNumberValue: true
-     * });
-     *
-     * // All values become strings (default behavior)
-     * createOptionsArray(data, {
-     *   firstFieldKey: 'id',
-     *   secondFieldKey: 'name'
-     * });
-     */
-    retainNumberValue?: V;
-}
-/** Type for first field key */
-type FirstFieldKey<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = T[OptionsConfig<T, K1, K2, V>['firstFieldKey']];
-/** Type for firs field value */
-type FirstFieldValue<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = V extends true ? FirstFieldKey<T, K1, K2, V> extends (Exclude<FirstFieldKey<T, K1, K2, V>, number>) ? string : number : string;
-/** Type of values for the option fields */
-type FieldValue<P extends K1 | K2, T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = P extends K1 ? FirstFieldValue<T, K1, K2, V> : string;
-/** Type of an option in `OptionsArray` */
-type Option<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = {
-    [P in K1 | K2]: FieldValue<P, T, K1, K2, V>;
-};
-/** * Option for sorting order. */
-interface OrderOption {
-    /**
-     * * The order in which to sort the array. Defaults to `'asc'`.
-     * - `'asc'`: Sort in ascending order.
-     * - `'desc'`: Sort in descending order.
-     */
-    sortOrder?: 'asc' | 'desc';
-}
-/** * Options for setting sortByField for sorting an array of objects. */
-interface SortByOption<T extends GenericObject> extends OrderOption {
-    /** The field by which to sort the objects in the array. */
-    sortByField: NestedPrimitiveKey<T>;
-}
-/** * Options for sorting array. */
-type SortOptions<T> = T extends GenericObject ? SortByOption<T> : OrderOption;
-/** Optional settings to configure comparison behavior. */
-interface SortNature {
-    /** If true, compares string chunks without case sensitivity. Defaults to `true`. */
-    caseInsensitive?: boolean;
-    /** If true, uses localeCompare for string chunk comparisons. Defaults to `false`. */
-    localeAware?: boolean;
-}
-/** * Options for customizing the search behavior. */
-interface FindOptions<T = unknown> {
-    /** * Enables fuzzy matching when exact match fails. Defaults to `false`. */
-    fuzzy?: boolean;
-    /** * Optional key for caching the result. Defaults to `finder-cache` */
-    cacheKey?: string;
-    /** * Forces binary search even for small datasets. Defaults to `false`. */
-    forceBinary?: boolean;
-    /** * If true, matcher and keys will be normalized to lowercase. Defaults to `true`. */
-    caseInsensitive?: boolean;
-    /** * If true, uses built in `Array.sort()`. Defaults to `true`. Pass `false` if data is already sorted. */
-    needSorting?: boolean;
-    /** * Optional data source to use instead of constructor items. */
-    data?: T[] | (() => T[]);
+type OwnKeys<T> = {
+    [K in keyof T]: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+/** Extract primitive (string, number or boolean) key(s) from an object */
+type NonNullishPrimitiveKey<T> = {
+    [K in keyof T]: T[K] extends string | number | boolean ? K : never;
+}[keyof T];
+/** Falsy primitive type  */
+type FalsyPrimitive = false | 0 | '' | null | undefined;
+/** A generic class constructor */
+type Constructor = new (...args: any[]) => unknown;
+/** Generic function type */
+type GenericFn = (...args: unknown[]) => unknown;
+/** Generic function type that returns `void` */
+type VoidFunction = (...args: any[]) => void;
+/** Debounced function type after certain delay */
+type DelayedFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
+/** Throttled function type after specific delay */
+type ThrottledFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
+/** Asynchronous function type */
+type AsyncFunction<T> = (...args: unknown[]) => Promise<T>;
+/** Advanced non-primitive types */
+type AdvancedTypes = Array<unknown> | File | FileList | Blob | Date | RegExp | WeakMap<WeakKey, unknown> | WeakSet<WeakKey> | Map<unknown, unknown> | Set<unknown> | Function | GenericFn | VoidFunction | AsyncFunction<unknown> | Promise<unknown> | Error | EvalError | RangeError | ReferenceError | SyntaxError | TypeError | URIError | bigint | symbol;
+/** Helper to detect if a type has methods */
+type HasMethods<T> = {
+    [K in keyof T]: T[K] extends Function ? true : never;
+}[keyof T] extends never ? false : true;
+/** * Represents detailed information about a class's methods. */
+interface ClassDetails {
+    /** * List of instance method names defined directly on the class prototype. */
+    instanceNames: string[];
+    /** * List of static method names defined directly on the class constructor. */
+    staticNames: string[];
+    /** * Number of instance methods. */
+    instances: number;
+    /** * Number of static methods. */
+    statics: number;
+    /** * Total number of instance and static methods combined. */
+    total: number;
 }
+/** Literal type for `partial` and `required` */
+type PartialOrRequired = 'partial' | 'required';
 
 /**
  * * Class representing a color and its conversions among `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` and `HSLA` formats.
@@ -331,7 +216,7 @@ declare class Color {
      */
     constructor(color: CSSColor);
     /** - Iterates over the color representations (Hex, RGB, HSL). */
-    [Symbol.iterator](): Generator<HSL | Hex6 | Hex8 | RGB | RGBA | HSLA, void, unknown>;
+    [Symbol.iterator](): Generator<HSL | RGB | HSLA | RGBA | Hex6 | Hex8, void, unknown>;
     /**
      * @instance Applies or modifies the opacity of a color. Mutate the original instance.
      * - For solid colors (Hex6/RGB/HSL): Adds an alpha channel with the specified opacity.
@@ -768,6 +653,192 @@ type Tetrad = [Color, Color, Color, Color];
 /** CSS named color, also includes different response colors */
 type CSSColor = keyof typeof CSS_COLORS;
 
+/** - Generic object with `unknown` value */
+type StrictObject = Record<string, unknown>;
+/** - Generic object but with `any` value */
+type GenericObject = Record<string, any>;
+/**
+ * * Represents a value that can be used in a query object.
+ * - Can be a primitive, an array of primitives, or a nested query object.
+ */
+type QueryObjectValue = NormalPrimitive | NormalPrimitive[] | QueryObject;
+/**
+ * * Represents a query object with string keys and `QueryObjectValue` values.
+ * - Supports nested objects and arrays.
+ */
+type QueryObject = {
+    [key: string]: QueryObjectValue;
+};
+/** - Object type with string or number or boolean as value for each key. */
+type GenericObjectPrimitive = Record<string, string | number | boolean>;
+/** - Dot-notation keys for nested objects with unknown value (including optional properties) */
+type DotNotationKeyStrict<T> = T extends AdvancedTypes ? never : T extends StrictObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (StrictObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
+}[keyof T & string] : never;
+/** - Dot-notation keys for nested objects with `any` value (including optional properties) */
+type DotNotationKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
+}[keyof T & string] : never;
+/** - Object keys where the value is an array (including optional properties) */
+type KeyForArray<T> = T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (Array<unknown>) ? K : never;
+}[keyof T & string] : never;
+/** - Object keys where the value is a non-array/non-advanced type object (including optional properties) */
+type KeyForObject<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? NonNullable<T[K]> extends AdvancedTypes ? never : K : never;
+}[keyof T & string] : never;
+/** - Extract only keys with string values from an object, including nested dot-notation keys. */
+type NestedKeyString<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends string ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedKeyString<NonNullable<T[K]>>}` : never;
+}[keyof T & string] : never;
+/** - Extract only primitive keys from an object, including nested dot-notation keys. */
+type NestedPrimitiveKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (NormalPrimitive) ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedPrimitiveKey<NonNullable<T[K]>>}` : never;
+}[keyof T & string] : never;
+/** - Options for `sanitizeData` utility. */
+interface SanitizeOptions<T> {
+    /**
+     * An array of dot-notation keys to exclude from the sanitized output.
+     * This is only applicable when sanitizing plain objects or arrays of objects.
+     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
+     */
+    keysToIgnore?: DotNotationKey<T>[];
+    /** Whether to trim string values. Defaults to `true`. */
+    trimStrings?: boolean;
+    /** Whether to exclude nullish (`null` or `undefined`) values. Defaults to `false`. */
+    ignoreNullish?: boolean;
+    /** Whether to exclude all falsy values (`false`, `0`, `empty string: ''`, `null`, `undefined`. Defaults to `false`. */
+    ignoreFalsy?: boolean;
+    /** Whether to exclude empty object(s) and array(s) (`{}`, `[]`). Defaults to `false`. */
+    ignoreEmpty?: boolean;
+    /**
+     * An array of dot-notation key paths that must be preserved in the sanitized output.
+     * Use `"*"` to retain all keys. This applies primarily to plain or nested objects and arrays of objects.
+     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
+     */
+    requiredKeys?: '*' | DotNotationKey<T>[];
+}
+/** - Type of data value converted to `string` */
+type Stringified<T> = {
+    [K in keyof T]: T[K] extends (infer U)[] ? Stringified<U>[] : T[K] extends object | null | undefined ? Stringified<T[K]> : T[K] extends string | number ? string : T[K];
+};
+/** - Type of data value converted to `number` */
+type Numberified<T> = {
+    [K in keyof T]: T[K] extends (infer U)[] ? Numberified<U>[] : T[K] extends object | null | undefined ? Numberified<T[K]> : T[K] extends string ? number : T[K] extends number ? T[K] : number;
+};
+
+/** * Flatten Array or Wrap in Array */
+type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
+/**
+ * * Configuration for `createOptionsArray`.
+ * - Defines the mapping between keys in the input objects and the keys in the output options.
+ *
+ * @typeParam T - The type of the objects in the input array.
+ * @typeParam K1 - The name of the key for the first field in the output (default: `'value'`).
+ * @typeParam K2 - The name of the key for the second field in the output (default: `'label'`).
+ * @typeParam V - Whether to keep the `value` field as number if it is a number. Defaults to `false`.
+ */
+interface OptionsConfig<T, K1, K2, V extends boolean = false> {
+    /**
+     * - The key in the input objects to use for the first field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
+     * @example
+     * // If the input objects have an `id` field and you want to use it as the `value` field in the output:
+     * createOptionsArray(data, {firstFieldKey: 'id'}).
+     */
+    firstFieldKey: NormalPrimitiveKey<T>;
+    /**
+     * - The key in the input objects to use for the second field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
+     * @example
+     * // If the input objects have a `name` field and you want to use it as the `label` field in the output:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name'}).
+     */
+    secondFieldKey: NormalPrimitiveKey<T>;
+    /**
+     * - The name of the first field in the output object.
+     * - Defaults to `'value'`.
+     * @example
+     * // If you want the output field to be named `'key'` instead of `'value'`:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key'}).
+     */
+    firstFieldName?: K1;
+    /**
+     * - The name of the second field in the output object.
+     * - Defaults to `'label'`.
+     * @example
+     * // If you want the output field to be named `'title'` instead of `'label'`:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key', secondFieldName: 'title'}).
+     */
+    secondFieldName?: K2;
+    /**
+     * - If `true`, numeric values from `firstFieldKey` will remain as numbers.
+     * - All other values (including booleans, null, undefined) will be converted to strings.
+     * - When `false` (default), all values are converted to strings.
+     * - Defaults to `false`.
+     * @example
+     * // Numeric IDs remain as numbers
+     * createOptionsArray(data, {
+     *   firstFieldKey: 'id',
+     *   secondFieldKey: 'name',
+     *   retainNumberValue: true
+     * });
+     *
+     * // All values become strings (default behavior)
+     * createOptionsArray(data, {
+     *   firstFieldKey: 'id',
+     *   secondFieldKey: 'name'
+     * });
+     */
+    retainNumberValue?: V;
+}
+/** Type for first field key */
+type FirstFieldKey<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = T[OptionsConfig<T, K1, K2, V>['firstFieldKey']];
+/** Type for firs field value */
+type FirstFieldValue<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = V extends true ? FirstFieldKey<T, K1, K2, V> extends (Exclude<FirstFieldKey<T, K1, K2, V>, number>) ? string : number : string;
+/** Type of values for the option fields */
+type FieldValue<P extends K1 | K2, T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = P extends K1 ? FirstFieldValue<T, K1, K2, V> : string;
+/** Type of an option in `OptionsArray` */
+type Option<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = {
+    [P in K1 | K2]: FieldValue<P, T, K1, K2, V>;
+};
+/** * Option for sorting order. */
+interface OrderOption {
+    /**
+     * * The order in which to sort the array. Defaults to `'asc'`.
+     * - `'asc'`: Sort in ascending order.
+     * - `'desc'`: Sort in descending order.
+     */
+    sortOrder?: 'asc' | 'desc';
+}
+/** * Options for setting sortByField for sorting an array of objects. */
+interface SortByOption<T extends GenericObject> extends OrderOption {
+    /** The field by which to sort the objects in the array. */
+    sortByField: NestedPrimitiveKey<T>;
+}
+/** * Options for sorting array. */
+type SortOptions<T> = T extends GenericObject ? SortByOption<T> : OrderOption;
+/** Optional settings to configure comparison behavior. */
+interface SortNature {
+    /** If true, compares string chunks without case sensitivity. Defaults to `true`. */
+    caseInsensitive?: boolean;
+    /** If true, uses localeCompare for string chunk comparisons. Defaults to `false`. */
+    localeAware?: boolean;
+}
+/** * Options for customizing the search behavior. */
+interface FindOptions<T = unknown> {
+    /** * Enables fuzzy matching when exact match fails. Defaults to `false`. */
+    fuzzy?: boolean;
+    /** * Optional key for caching the result. Defaults to `finder-cache` */
+    cacheKey?: string;
+    /** * Forces binary search even for small datasets. Defaults to `false`. */
+    forceBinary?: boolean;
+    /** * If true, matcher and keys will be normalized to lowercase. Defaults to `true`. */
+    caseInsensitive?: boolean;
+    /** * If true, uses built in `Array.sort()`. Defaults to `true`. Pass `false` if data is already sorted. */
+    needSorting?: boolean;
+    /** * Optional data source to use instead of constructor items. */
+    data?: T[] | (() => T[]);
+}
+
 /** - Configuration options to control FormData generation behavior. */
 interface FormDataConfigs<T> {
     /**
@@ -865,77 +936,6 @@ type SerializedForm<T extends boolean> = T extends false ? Record<string, string
 /** * Represents the parsed form data. */
 type ParsedFormData<T> = T extends string ? Record<string, string | string[]> : Record<string, string | string[] | File | File[]>;
 
-/** Uncontrolled any to use for edge cases */
-type Any = any;
-declare const __brand: unique symbol;
-type Brand<B> = {
-    [__brand]: B;
-};
-/** Create a branded type. */
-type Branded<T, B> = T & Brand<B>;
-/** Utility type to flatten Partial type */
-type FlattenPartial<T> = Partial<{
-    [K in keyof T]: T[K];
-}>;
-/** Union of `number` and numeric string */
-type Numeric = number | `${number}`;
-/** Union of All Primitive Types (i.e. `string | number | boolean | symbol | bigint | null | undefined`) */
-type Primitive = string | number | boolean | symbol | bigint | null | undefined;
-/** Union of Normal Primitive Types (i.e. `string | number | boolean | null | undefined`) */
-type NormalPrimitive = string | number | boolean | null | undefined;
-/** Extract normal primitive key(s) (i.e. `string | number | boolean | null | undefined`) from an object */
-type NormalPrimitiveKey<T> = {
-    [K in keyof T]: T[K] extends NormalPrimitive ? K : never;
-}[keyof T];
-/**
- * * Keys of an object that are part of the object type itself.
- * This excludes keys that are inherited from the prototype chain.
- * This type is useful for extracting keys that are part of the object's own properties.
- * It is used in the `OwnKeys` type to filter out keys that are not part of the object properties.
- */
-type OwnKeys<T> = {
-    [K in keyof T]: {} extends Pick<T, K> ? never : K;
-}[keyof T];
-/** Extract primitive (string, number or boolean) key(s) from an object */
-type NonNullishPrimitiveKey<T> = {
-    [K in keyof T]: T[K] extends string | number | boolean ? K : never;
-}[keyof T];
-/** Falsy primitive type  */
-type FalsyPrimitive = false | 0 | '' | null | undefined;
-/** A generic class constructor */
-type Constructor = new (...args: any[]) => unknown;
-/** Generic function type */
-type GenericFn = (...args: unknown[]) => unknown;
-/** Generic function type that returns `void` */
-type VoidFunction = (...args: any[]) => void;
-/** Debounced function type after certain delay */
-type DelayedFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
-/** Throttled function type after specific delay */
-type ThrottledFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
-/** Asynchronous function type */
-type AsyncFunction<T> = (...args: unknown[]) => Promise<T>;
-/** Advanced non-primitive types */
-type AdvancedTypes = Array<unknown> | File | FileList | Blob | Date | RegExp | WeakMap<WeakKey, unknown> | WeakSet<WeakKey> | Map<unknown, unknown> | Set<unknown> | Function | GenericFn | VoidFunction | AsyncFunction<unknown> | Promise<unknown> | Error | EvalError | RangeError | ReferenceError | SyntaxError | TypeError | URIError | bigint | symbol;
-/** Helper to detect if a type has methods */
-type HasMethods<T> = {
-    [K in keyof T]: T[K] extends Function ? true : never;
-}[keyof T] extends never ? false : true;
-/** * Represents detailed information about a class's methods. */
-interface ClassDetails {
-    /** * List of instance method names defined directly on the class prototype. */
-    instanceNames: string[];
-    /** * List of static method names defined directly on the class constructor. */
-    staticNames: string[];
-    /** * Number of instance methods. */
-    instances: number;
-    /** * Number of static methods. */
-    statics: number;
-    /** * Total number of instance and static methods combined. */
-    total: number;
-}
-/** Literal type for `partial` and `required` */
-type PartialOrRequired = 'partial' | 'required';
-
 /** Options to initialize Paginator */
 interface PaginatorOptions {
     /** The total number of items. */

package/dist/{types-C33n5Qt0.d.ts → typedefs-C3luCa9l.d.ts}

@@ -45,191 +45,76 @@ interface MaskOptions {
 /** Formatted query string as `?${string}` = `?key=value&...` or empty string. */
 type QueryString = `?${string}` | '';
 
-/** - Generic object with `unknown` value */
-type StrictObject = Record<string, unknown>;
-/** - Generic object but with `any` value */
-type GenericObject = Record<string, any>;
-/**
- * * Represents a value that can be used in a query object.
- * - Can be a primitive, an array of primitives, or a nested query object.
- */
-type QueryObjectValue = NormalPrimitive | NormalPrimitive[] | QueryObject;
-/**
- * * Represents a query object with string keys and `QueryObjectValue` values.
- * - Supports nested objects and arrays.
- */
-type QueryObject = {
-    [key: string]: QueryObjectValue;
-};
-/** - Object type with string or number or boolean as value for each key. */
-type GenericObjectPrimitive = Record<string, string | number | boolean>;
-/** - Dot-notation keys for nested objects with unknown value (including optional properties) */
-type DotNotationKeyStrict<T> = T extends AdvancedTypes ? never : T extends StrictObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (StrictObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
-}[keyof T & string] : never;
-/** - Dot-notation keys for nested objects with `any` value (including optional properties) */
-type DotNotationKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
-}[keyof T & string] : never;
-/** - Object keys where the value is an array (including optional properties) */
-type KeyForArray<T> = T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (Array<unknown>) ? K : never;
-}[keyof T & string] : never;
-/** - Object keys where the value is a non-array/non-advanced type object (including optional properties) */
-type KeyForObject<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? NonNullable<T[K]> extends AdvancedTypes ? never : K : never;
-}[keyof T & string] : never;
-/** - Extract only keys with string values from an object, including nested dot-notation keys. */
-type NestedKeyString<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends string ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedKeyString<NonNullable<T[K]>>}` : never;
-}[keyof T & string] : never;
-/** - Extract only primitive keys from an object, including nested dot-notation keys. */
-type NestedPrimitiveKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
-    [K in keyof T & string]: NonNullable<T[K]> extends (NormalPrimitive) ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedPrimitiveKey<NonNullable<T[K]>>}` : never;
-}[keyof T & string] : never;
-/** - Options for `sanitizeData` utility. */
-interface SanitizeOptions<T> {
-    /**
-     * An array of dot-notation keys to exclude from the sanitized output.
-     * This is only applicable when sanitizing plain objects or arrays of objects.
-     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
-     */
-    keysToIgnore?: DotNotationKey<T>[];
-    /** Whether to trim string values. Defaults to `true`. */
-    trimStrings?: boolean;
-    /** Whether to exclude nullish (`null` or `undefined`) values. Defaults to `false`. */
-    ignoreNullish?: boolean;
-    /** Whether to exclude all falsy values (`false`, `0`, `empty string: ''`, `null`, `undefined`. Defaults to `false`. */
-    ignoreFalsy?: boolean;
-    /** Whether to exclude empty object(s) and array(s) (`{}`, `[]`). Defaults to `false`. */
-    ignoreEmpty?: boolean;
-    /**
-     * An array of dot-notation key paths that must be preserved in the sanitized output.
-     * Use `"*"` to retain all keys. This applies primarily to plain or nested objects and arrays of objects.
-     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
-     */
-    requiredKeys?: '*' | DotNotationKey<T>[];
-}
-/** - Type of data value converted to `string` */
-type Stringified<T> = {
-    [K in keyof T]: T[K] extends (infer U)[] ? Stringified<U>[] : T[K] extends object | null | undefined ? Stringified<T[K]> : T[K] extends string | number ? string : T[K];
-};
-/** - Type of data value converted to `number` */
-type Numberified<T> = {
-    [K in keyof T]: T[K] extends (infer U)[] ? Numberified<U>[] : T[K] extends object | null | undefined ? Numberified<T[K]> : T[K] extends string ? number : T[K] extends number ? T[K] : number;
+/** Uncontrolled any to use for edge cases */
+type Any = any;
+declare const __brand: unique symbol;
+type Brand<B> = {
+    [__brand]: B;
 };
-
-/** * Flatten Array or Wrap in Array */
-type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
+/** Create a branded type. */
+type Branded<T, B> = T & Brand<B>;
+/** Utility type to flatten Partial type */
+type FlattenPartial<T> = Partial<{
+    [K in keyof T]: T[K];
+}>;
+/** Union of `number` and numeric string */
+type Numeric = number | `${number}`;
+/** Union of All Primitive Types (i.e. `string | number | boolean | symbol | bigint | null | undefined`) */
+type Primitive = string | number | boolean | symbol | bigint | null | undefined;
+/** Union of Normal Primitive Types (i.e. `string | number | boolean | null | undefined`) */
+type NormalPrimitive = string | number | boolean | null | undefined;
+/** Extract normal primitive key(s) (i.e. `string | number | boolean | null | undefined`) from an object */
+type NormalPrimitiveKey<T> = {
+    [K in keyof T]: T[K] extends NormalPrimitive ? K : never;
+}[keyof T];
 /**
- * * Configuration for `createOptionsArray`.
- * - Defines the mapping between keys in the input objects and the keys in the output options.
- *
- * @typeParam T - The type of the objects in the input array.
- * @typeParam K1 - The name of the key for the first field in the output (default: `'value'`).
- * @typeParam K2 - The name of the key for the second field in the output (default: `'label'`).
- * @typeParam V - Whether to keep the `value` field as number if it is a number. Defaults to `false`.
+ * * Keys of an object that are part of the object type itself.
+ * This excludes keys that are inherited from the prototype chain.
+ * This type is useful for extracting keys that are part of the object's own properties.
+ * It is used in the `OwnKeys` type to filter out keys that are not part of the object properties.
  */
-interface OptionsConfig<T, K1, K2, V extends boolean = false> {
-    /**
-     * - The key in the input objects to use for the first field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
-     * @example
-     * // If the input objects have an `id` field and you want to use it as the `value` field in the output:
-     * createOptionsArray(data, {firstFieldKey: 'id'}).
-     */
-    firstFieldKey: NormalPrimitiveKey<T>;
-    /**
-     * - The key in the input objects to use for the second field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
-     * @example
-     * // If the input objects have a `name` field and you want to use it as the `label` field in the output:
-     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name'}).
-     */
-    secondFieldKey: NormalPrimitiveKey<T>;
-    /**
-     * - The name of the first field in the output object.
-     * - Defaults to `'value'`.
-     * @example
-     * // If you want the output field to be named `'key'` instead of `'value'`:
-     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key'}).
-     */
-    firstFieldName?: K1;
-    /**
-     * - The name of the second field in the output object.
-     * - Defaults to `'label'`.
-     * @example
-     * // If you want the output field to be named `'title'` instead of `'label'`:
-     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key', secondFieldName: 'title'}).
-     */
-    secondFieldName?: K2;
-    /**
-     * - If `true`, numeric values from `firstFieldKey` will remain as numbers.
-     * - All other values (including booleans, null, undefined) will be converted to strings.
-     * - When `false` (default), all values are converted to strings.
-     * - Defaults to `false`.
-     * @example
-     * // Numeric IDs remain as numbers
-     * createOptionsArray(data, {
-     *   firstFieldKey: 'id',
-     *   secondFieldKey: 'name',
-     *   retainNumberValue: true
-     * });
-     *
-     * // All values become strings (default behavior)
-     * createOptionsArray(data, {
-     *   firstFieldKey: 'id',
-     *   secondFieldKey: 'name'
-     * });
-     */
-    retainNumberValue?: V;
-}
-/** Type for first field key */
-type FirstFieldKey<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = T[OptionsConfig<T, K1, K2, V>['firstFieldKey']];
-/** Type for firs field value */
-type FirstFieldValue<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = V extends true ? FirstFieldKey<T, K1, K2, V> extends (Exclude<FirstFieldKey<T, K1, K2, V>, number>) ? string : number : string;
-/** Type of values for the option fields */
-type FieldValue<P extends K1 | K2, T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = P extends K1 ? FirstFieldValue<T, K1, K2, V> : string;
-/** Type of an option in `OptionsArray` */
-type Option<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = {
-    [P in K1 | K2]: FieldValue<P, T, K1, K2, V>;
-};
-/** * Option for sorting order. */
-interface OrderOption {
-    /**
-     * * The order in which to sort the array. Defaults to `'asc'`.
-     * - `'asc'`: Sort in ascending order.
-     * - `'desc'`: Sort in descending order.
-     */
-    sortOrder?: 'asc' | 'desc';
-}
-/** * Options for setting sortByField for sorting an array of objects. */
-interface SortByOption<T extends GenericObject> extends OrderOption {
-    /** The field by which to sort the objects in the array. */
-    sortByField: NestedPrimitiveKey<T>;
-}
-/** * Options for sorting array. */
-type SortOptions<T> = T extends GenericObject ? SortByOption<T> : OrderOption;
-/** Optional settings to configure comparison behavior. */
-interface SortNature {
-    /** If true, compares string chunks without case sensitivity. Defaults to `true`. */
-    caseInsensitive?: boolean;
-    /** If true, uses localeCompare for string chunk comparisons. Defaults to `false`. */
-    localeAware?: boolean;
-}
-/** * Options for customizing the search behavior. */
-interface FindOptions<T = unknown> {
-    /** * Enables fuzzy matching when exact match fails. Defaults to `false`. */
-    fuzzy?: boolean;
-    /** * Optional key for caching the result. Defaults to `finder-cache` */
-    cacheKey?: string;
-    /** * Forces binary search even for small datasets. Defaults to `false`. */
-    forceBinary?: boolean;
-    /** * If true, matcher and keys will be normalized to lowercase. Defaults to `true`. */
-    caseInsensitive?: boolean;
-    /** * If true, uses built in `Array.sort()`. Defaults to `true`. Pass `false` if data is already sorted. */
-    needSorting?: boolean;
-    /** * Optional data source to use instead of constructor items. */
-    data?: T[] | (() => T[]);
+type OwnKeys<T> = {
+    [K in keyof T]: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+/** Extract primitive (string, number or boolean) key(s) from an object */
+type NonNullishPrimitiveKey<T> = {
+    [K in keyof T]: T[K] extends string | number | boolean ? K : never;
+}[keyof T];
+/** Falsy primitive type  */
+type FalsyPrimitive = false | 0 | '' | null | undefined;
+/** A generic class constructor */
+type Constructor = new (...args: any[]) => unknown;
+/** Generic function type */
+type GenericFn = (...args: unknown[]) => unknown;
+/** Generic function type that returns `void` */
+type VoidFunction = (...args: any[]) => void;
+/** Debounced function type after certain delay */
+type DelayedFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
+/** Throttled function type after specific delay */
+type ThrottledFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
+/** Asynchronous function type */
+type AsyncFunction<T> = (...args: unknown[]) => Promise<T>;
+/** Advanced non-primitive types */
+type AdvancedTypes = Array<unknown> | File | FileList | Blob | Date | RegExp | WeakMap<WeakKey, unknown> | WeakSet<WeakKey> | Map<unknown, unknown> | Set<unknown> | Function | GenericFn | VoidFunction | AsyncFunction<unknown> | Promise<unknown> | Error | EvalError | RangeError | ReferenceError | SyntaxError | TypeError | URIError | bigint | symbol;
+/** Helper to detect if a type has methods */
+type HasMethods<T> = {
+    [K in keyof T]: T[K] extends Function ? true : never;
+}[keyof T] extends never ? false : true;
+/** * Represents detailed information about a class's methods. */
+interface ClassDetails {
+    /** * List of instance method names defined directly on the class prototype. */
+    instanceNames: string[];
+    /** * List of static method names defined directly on the class constructor. */
+    staticNames: string[];
+    /** * Number of instance methods. */
+    instances: number;
+    /** * Number of static methods. */
+    statics: number;
+    /** * Total number of instance and static methods combined. */
+    total: number;
 }
+/** Literal type for `partial` and `required` */
+type PartialOrRequired = 'partial' | 'required';
 
 /**
  * * Class representing a color and its conversions among `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` and `HSLA` formats.
@@ -331,7 +216,7 @@ declare class Color {
      */
     constructor(color: CSSColor);
     /** - Iterates over the color representations (Hex, RGB, HSL). */
-    [Symbol.iterator](): Generator<HSL | Hex6 | Hex8 | RGB | RGBA | HSLA, void, unknown>;
+    [Symbol.iterator](): Generator<HSL | RGB | HSLA | RGBA | Hex6 | Hex8, void, unknown>;
     /**
      * @instance Applies or modifies the opacity of a color. Mutate the original instance.
      * - For solid colors (Hex6/RGB/HSL): Adds an alpha channel with the specified opacity.
@@ -768,6 +653,192 @@ type Tetrad = [Color, Color, Color, Color];
 /** CSS named color, also includes different response colors */
 type CSSColor = keyof typeof CSS_COLORS;
 
+/** - Generic object with `unknown` value */
+type StrictObject = Record<string, unknown>;
+/** - Generic object but with `any` value */
+type GenericObject = Record<string, any>;
+/**
+ * * Represents a value that can be used in a query object.
+ * - Can be a primitive, an array of primitives, or a nested query object.
+ */
+type QueryObjectValue = NormalPrimitive | NormalPrimitive[] | QueryObject;
+/**
+ * * Represents a query object with string keys and `QueryObjectValue` values.
+ * - Supports nested objects and arrays.
+ */
+type QueryObject = {
+    [key: string]: QueryObjectValue;
+};
+/** - Object type with string or number or boolean as value for each key. */
+type GenericObjectPrimitive = Record<string, string | number | boolean>;
+/** - Dot-notation keys for nested objects with unknown value (including optional properties) */
+type DotNotationKeyStrict<T> = T extends AdvancedTypes ? never : T extends StrictObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (StrictObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
+}[keyof T & string] : never;
+/** - Dot-notation keys for nested objects with `any` value (including optional properties) */
+type DotNotationKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? `${K}` | `${K}.${DotNotationKey<NonNullable<T[K]>>}` : `${K}`;
+}[keyof T & string] : never;
+/** - Object keys where the value is an array (including optional properties) */
+type KeyForArray<T> = T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (Array<unknown>) ? K : never;
+}[keyof T & string] : never;
+/** - Object keys where the value is a non-array/non-advanced type object (including optional properties) */
+type KeyForObject<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (GenericObject) ? NonNullable<T[K]> extends AdvancedTypes ? never : K : never;
+}[keyof T & string] : never;
+/** - Extract only keys with string values from an object, including nested dot-notation keys. */
+type NestedKeyString<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends string ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedKeyString<NonNullable<T[K]>>}` : never;
+}[keyof T & string] : never;
+/** - Extract only primitive keys from an object, including nested dot-notation keys. */
+type NestedPrimitiveKey<T> = T extends AdvancedTypes ? never : T extends GenericObject ? HasMethods<T> extends true ? never : {
+    [K in keyof T & string]: NonNullable<T[K]> extends (NormalPrimitive) ? K : NonNullable<T[K]> extends GenericObject ? `${K}.${NestedPrimitiveKey<NonNullable<T[K]>>}` : never;
+}[keyof T & string] : never;
+/** - Options for `sanitizeData` utility. */
+interface SanitizeOptions<T> {
+    /**
+     * An array of dot-notation keys to exclude from the sanitized output.
+     * This is only applicable when sanitizing plain objects or arrays of objects.
+     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
+     */
+    keysToIgnore?: DotNotationKey<T>[];
+    /** Whether to trim string values. Defaults to `true`. */
+    trimStrings?: boolean;
+    /** Whether to exclude nullish (`null` or `undefined`) values. Defaults to `false`. */
+    ignoreNullish?: boolean;
+    /** Whether to exclude all falsy values (`false`, `0`, `empty string: ''`, `null`, `undefined`. Defaults to `false`. */
+    ignoreFalsy?: boolean;
+    /** Whether to exclude empty object(s) and array(s) (`{}`, `[]`). Defaults to `false`. */
+    ignoreEmpty?: boolean;
+    /**
+     * An array of dot-notation key paths that must be preserved in the sanitized output.
+     * Use `"*"` to retain all keys. This applies primarily to plain or nested objects and arrays of objects.
+     * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
+     */
+    requiredKeys?: '*' | DotNotationKey<T>[];
+}
+/** - Type of data value converted to `string` */
+type Stringified<T> = {
+    [K in keyof T]: T[K] extends (infer U)[] ? Stringified<U>[] : T[K] extends object | null | undefined ? Stringified<T[K]> : T[K] extends string | number ? string : T[K];
+};
+/** - Type of data value converted to `number` */
+type Numberified<T> = {
+    [K in keyof T]: T[K] extends (infer U)[] ? Numberified<U>[] : T[K] extends object | null | undefined ? Numberified<T[K]> : T[K] extends string ? number : T[K] extends number ? T[K] : number;
+};
+
+/** * Flatten Array or Wrap in Array */
+type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
+/**
+ * * Configuration for `createOptionsArray`.
+ * - Defines the mapping between keys in the input objects and the keys in the output options.
+ *
+ * @typeParam T - The type of the objects in the input array.
+ * @typeParam K1 - The name of the key for the first field in the output (default: `'value'`).
+ * @typeParam K2 - The name of the key for the second field in the output (default: `'label'`).
+ * @typeParam V - Whether to keep the `value` field as number if it is a number. Defaults to `false`.
+ */
+interface OptionsConfig<T, K1, K2, V extends boolean = false> {
+    /**
+     * - The key in the input objects to use for the first field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
+     * @example
+     * // If the input objects have an `id` field and you want to use it as the `value` field in the output:
+     * createOptionsArray(data, {firstFieldKey: 'id'}).
+     */
+    firstFieldKey: NormalPrimitiveKey<T>;
+    /**
+     * - The key in the input objects to use for the second field of the option. Only primitive values (`string | number | boolean | null | undefined`) are accepted.
+     * @example
+     * // If the input objects have a `name` field and you want to use it as the `label` field in the output:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name'}).
+     */
+    secondFieldKey: NormalPrimitiveKey<T>;
+    /**
+     * - The name of the first field in the output object.
+     * - Defaults to `'value'`.
+     * @example
+     * // If you want the output field to be named `'key'` instead of `'value'`:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key'}).
+     */
+    firstFieldName?: K1;
+    /**
+     * - The name of the second field in the output object.
+     * - Defaults to `'label'`.
+     * @example
+     * // If you want the output field to be named `'title'` instead of `'label'`:
+     * createOptionsArray(data, {firstFieldKey: 'id', secondFieldKey: 'name', firstFieldName: 'key', secondFieldName: 'title'}).
+     */
+    secondFieldName?: K2;
+    /**
+     * - If `true`, numeric values from `firstFieldKey` will remain as numbers.
+     * - All other values (including booleans, null, undefined) will be converted to strings.
+     * - When `false` (default), all values are converted to strings.
+     * - Defaults to `false`.
+     * @example
+     * // Numeric IDs remain as numbers
+     * createOptionsArray(data, {
+     *   firstFieldKey: 'id',
+     *   secondFieldKey: 'name',
+     *   retainNumberValue: true
+     * });
+     *
+     * // All values become strings (default behavior)
+     * createOptionsArray(data, {
+     *   firstFieldKey: 'id',
+     *   secondFieldKey: 'name'
+     * });
+     */
+    retainNumberValue?: V;
+}
+/** Type for first field key */
+type FirstFieldKey<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = T[OptionsConfig<T, K1, K2, V>['firstFieldKey']];
+/** Type for firs field value */
+type FirstFieldValue<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = V extends true ? FirstFieldKey<T, K1, K2, V> extends (Exclude<FirstFieldKey<T, K1, K2, V>, number>) ? string : number : string;
+/** Type of values for the option fields */
+type FieldValue<P extends K1 | K2, T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = P extends K1 ? FirstFieldValue<T, K1, K2, V> : string;
+/** Type of an option in `OptionsArray` */
+type Option<T extends GenericObject, K1 extends string = 'value', K2 extends string = 'label', V extends boolean = false> = {
+    [P in K1 | K2]: FieldValue<P, T, K1, K2, V>;
+};
+/** * Option for sorting order. */
+interface OrderOption {
+    /**
+     * * The order in which to sort the array. Defaults to `'asc'`.
+     * - `'asc'`: Sort in ascending order.
+     * - `'desc'`: Sort in descending order.
+     */
+    sortOrder?: 'asc' | 'desc';
+}
+/** * Options for setting sortByField for sorting an array of objects. */
+interface SortByOption<T extends GenericObject> extends OrderOption {
+    /** The field by which to sort the objects in the array. */
+    sortByField: NestedPrimitiveKey<T>;
+}
+/** * Options for sorting array. */
+type SortOptions<T> = T extends GenericObject ? SortByOption<T> : OrderOption;
+/** Optional settings to configure comparison behavior. */
+interface SortNature {
+    /** If true, compares string chunks without case sensitivity. Defaults to `true`. */
+    caseInsensitive?: boolean;
+    /** If true, uses localeCompare for string chunk comparisons. Defaults to `false`. */
+    localeAware?: boolean;
+}
+/** * Options for customizing the search behavior. */
+interface FindOptions<T = unknown> {
+    /** * Enables fuzzy matching when exact match fails. Defaults to `false`. */
+    fuzzy?: boolean;
+    /** * Optional key for caching the result. Defaults to `finder-cache` */
+    cacheKey?: string;
+    /** * Forces binary search even for small datasets. Defaults to `false`. */
+    forceBinary?: boolean;
+    /** * If true, matcher and keys will be normalized to lowercase. Defaults to `true`. */
+    caseInsensitive?: boolean;
+    /** * If true, uses built in `Array.sort()`. Defaults to `true`. Pass `false` if data is already sorted. */
+    needSorting?: boolean;
+    /** * Optional data source to use instead of constructor items. */
+    data?: T[] | (() => T[]);
+}
+
 /** - Configuration options to control FormData generation behavior. */
 interface FormDataConfigs<T> {
     /**
@@ -865,77 +936,6 @@ type SerializedForm<T extends boolean> = T extends false ? Record<string, string
 /** * Represents the parsed form data. */
 type ParsedFormData<T> = T extends string ? Record<string, string | string[]> : Record<string, string | string[] | File | File[]>;
 
-/** Uncontrolled any to use for edge cases */
-type Any = any;
-declare const __brand: unique symbol;
-type Brand<B> = {
-    [__brand]: B;
-};
-/** Create a branded type. */
-type Branded<T, B> = T & Brand<B>;
-/** Utility type to flatten Partial type */
-type FlattenPartial<T> = Partial<{
-    [K in keyof T]: T[K];
-}>;
-/** Union of `number` and numeric string */
-type Numeric = number | `${number}`;
-/** Union of All Primitive Types (i.e. `string | number | boolean | symbol | bigint | null | undefined`) */
-type Primitive = string | number | boolean | symbol | bigint | null | undefined;
-/** Union of Normal Primitive Types (i.e. `string | number | boolean | null | undefined`) */
-type NormalPrimitive = string | number | boolean | null | undefined;
-/** Extract normal primitive key(s) (i.e. `string | number | boolean | null | undefined`) from an object */
-type NormalPrimitiveKey<T> = {
-    [K in keyof T]: T[K] extends NormalPrimitive ? K : never;
-}[keyof T];
-/**
- * * Keys of an object that are part of the object type itself.
- * This excludes keys that are inherited from the prototype chain.
- * This type is useful for extracting keys that are part of the object's own properties.
- * It is used in the `OwnKeys` type to filter out keys that are not part of the object properties.
- */
-type OwnKeys<T> = {
-    [K in keyof T]: {} extends Pick<T, K> ? never : K;
-}[keyof T];
-/** Extract primitive (string, number or boolean) key(s) from an object */
-type NonNullishPrimitiveKey<T> = {
-    [K in keyof T]: T[K] extends string | number | boolean ? K : never;
-}[keyof T];
-/** Falsy primitive type  */
-type FalsyPrimitive = false | 0 | '' | null | undefined;
-/** A generic class constructor */
-type Constructor = new (...args: any[]) => unknown;
-/** Generic function type */
-type GenericFn = (...args: unknown[]) => unknown;
-/** Generic function type that returns `void` */
-type VoidFunction = (...args: any[]) => void;
-/** Debounced function type after certain delay */
-type DelayedFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
-/** Throttled function type after specific delay */
-type ThrottledFn<T extends VoidFunction> = (...args: Parameters<T>) => void;
-/** Asynchronous function type */
-type AsyncFunction<T> = (...args: unknown[]) => Promise<T>;
-/** Advanced non-primitive types */
-type AdvancedTypes = Array<unknown> | File | FileList | Blob | Date | RegExp | WeakMap<WeakKey, unknown> | WeakSet<WeakKey> | Map<unknown, unknown> | Set<unknown> | Function | GenericFn | VoidFunction | AsyncFunction<unknown> | Promise<unknown> | Error | EvalError | RangeError | ReferenceError | SyntaxError | TypeError | URIError | bigint | symbol;
-/** Helper to detect if a type has methods */
-type HasMethods<T> = {
-    [K in keyof T]: T[K] extends Function ? true : never;
-}[keyof T] extends never ? false : true;
-/** * Represents detailed information about a class's methods. */
-interface ClassDetails {
-    /** * List of instance method names defined directly on the class prototype. */
-    instanceNames: string[];
-    /** * List of static method names defined directly on the class constructor. */
-    staticNames: string[];
-    /** * Number of instance methods. */
-    instances: number;
-    /** * Number of static methods. */
-    statics: number;
-    /** * Total number of instance and static methods combined. */
-    total: number;
-}
-/** Literal type for `partial` and `required` */
-type PartialOrRequired = 'partial' | 'required';
-
 /** Options to initialize Paginator */
 interface PaginatorOptions {
     /** The total number of items. */

package/dist/{types.d.mts → typedefs.d.mts}

@@ -1,2 +1,2 @@
-export { as as AdvancedTypes, a6 as AlphaColors, a7 as AlphaValue, A as AlphaValues, ar as AnagramOptions, a8 as Analogous, v as Any, $ as AsyncFunction, at as Branded, af as CSSColor, C as CapitalizeOptions, a as CaseFormat, K as ClassDetails, a9 as ColorInput, b as ColorInputArray, ab as ColorType, ac as ColorTypeAlpha, ad as ColorTypeSolid, aa as Colors, I as Constructor, ae as ConvertedColors, r as CustomFile, J as DelayedFn, D as DotNotationKey, ak as DotNotationKeyStrict, Y as FalsyPrimitive, m as FieldValue, aj as FileError, s as FileUpload, i as FindOptions, a2 as FirstFieldKey, a3 as FirstFieldValue, u as FlattenPartial, F as Flattened, o as FormDataConfigs, X as FromMetaOptions, a0 as GenericFn, G as GenericObject, al as GenericObjectPrimitive, d as HSL, g as HSLA, au as HasMethods, h as Hex, H as Hex6, e as Hex8, am as KeyForArray, an as KeyForObject, M as MaskOptions, ao as NestedKeyString, ap as NestedPrimitiveKey, av as NonNullishPrimitiveKey, Z as NormalPrimitive, aw as NormalPrimitiveKey, z as Numberified, N as Numeric, a4 as Option, l as OptionsConfig, k as OrderOption, t as OriginFileObj, O as OwnKeys, W as PageListOptions, U as PaginatorMeta, L as PaginatorOptions, p as ParsedFormData, w as PartialOrRequired, P as Percent, _ as Primitive, Q as QueryObject, aq as QueryObjectValue, B as QueryString, c as RGB, f as RGBA, R as RandomIdOptions, x as SanitizeOptions, q as SerializedForm, ag as SolidColors, S as SolidValues, j as SortByOption, n as SortNature, a5 as SortOptions, E as StrictObject, y as Stringified, ah as Tetrad, T as ThrottledFn, ai as Triad, V as VoidFunction } from './types-uginMOiI.mjs';
+export { as as AdvancedTypes, a6 as AlphaColors, a7 as AlphaValue, A as AlphaValues, ar as AnagramOptions, a8 as Analogous, v as Any, $ as AsyncFunction, at as Branded, af as CSSColor, C as CapitalizeOptions, a as CaseFormat, K as ClassDetails, a9 as ColorInput, b as ColorInputArray, ab as ColorType, ac as ColorTypeAlpha, ad as ColorTypeSolid, aa as Colors, I as Constructor, ae as ConvertedColors, r as CustomFile, J as DelayedFn, D as DotNotationKey, ak as DotNotationKeyStrict, Y as FalsyPrimitive, m as FieldValue, aj as FileError, s as FileUpload, i as FindOptions, a2 as FirstFieldKey, a3 as FirstFieldValue, u as FlattenPartial, F as Flattened, o as FormDataConfigs, X as FromMetaOptions, a0 as GenericFn, G as GenericObject, al as GenericObjectPrimitive, d as HSL, g as HSLA, au as HasMethods, h as Hex, H as Hex6, e as Hex8, am as KeyForArray, an as KeyForObject, M as MaskOptions, ao as NestedKeyString, ap as NestedPrimitiveKey, av as NonNullishPrimitiveKey, Z as NormalPrimitive, aw as NormalPrimitiveKey, z as Numberified, N as Numeric, a4 as Option, l as OptionsConfig, k as OrderOption, t as OriginFileObj, O as OwnKeys, W as PageListOptions, U as PaginatorMeta, L as PaginatorOptions, p as ParsedFormData, w as PartialOrRequired, P as Percent, _ as Primitive, Q as QueryObject, aq as QueryObjectValue, B as QueryString, c as RGB, f as RGBA, R as RandomIdOptions, x as SanitizeOptions, q as SerializedForm, ag as SolidColors, S as SolidValues, j as SortByOption, n as SortNature, a5 as SortOptions, E as StrictObject, y as Stringified, ah as Tetrad, T as ThrottledFn, ai as Triad, V as VoidFunction } from './typedefs-BYmqOW77.mjs';
 export { K as ApplyChangeOptions, h as ChronosFormat, i as ChronosInput, j as ChronosMethods, k as ChronosObject, C as ChronosStatics, d as ConvertOptions, b as ConvertedDecimal, c as CurrencyCode, l as DateParts, m as Day, n as DayPart, o as DayPartConfig, D as DecimalOptions, F as FormatOptions, O as FrankFurter, V as GetChangeOptions, X as GetDifferenceOptions, _ as GetOriginalOptions, $ as GetPercentOptions, a0 as GetValueOptions, G as GreetingConfigs, H as Hour, p as Hours, a1 as InversePercentageOptions, L as LocaleCode, M as Millisecond, q as Minute, r as Minutes, s as Month, t as MonthDate, u as NegativeUTCHour, N as NumberType, P as PercentageOptions, v as PositiveUTCHour, Q as Quarter, R as RandomNumberOptions, e as RangeOptions, f as RangedNumbers, a2 as SIPrefix, w as Second, x as Seconds, y as StrictFormat, S as SupportedCurrency, T as Time, z as TimeDuration, A as TimeFormats, B as TimeParts, E as TimeUnit, I as TimeZone, J as UTCMinute, U as UTCOffSet, a3 as UnitKey, a4 as UnitLabel, a5 as UnitNumberMethods, W as WithoutOrigin, Y as Year, Z as ZodiacSign } from './Chronos-v7ni8eaQ.mjs';

package/dist/{types.d.ts → typedefs.d.ts}

@@ -1,2 +1,2 @@
-export { as as AdvancedTypes, a6 as AlphaColors, a7 as AlphaValue, A as AlphaValues, ar as AnagramOptions, a8 as Analogous, v as Any, $ as AsyncFunction, at as Branded, af as CSSColor, C as CapitalizeOptions, a as CaseFormat, K as ClassDetails, a9 as ColorInput, b as ColorInputArray, ab as ColorType, ac as ColorTypeAlpha, ad as ColorTypeSolid, aa as Colors, I as Constructor, ae as ConvertedColors, r as CustomFile, J as DelayedFn, D as DotNotationKey, ak as DotNotationKeyStrict, Y as FalsyPrimitive, m as FieldValue, aj as FileError, s as FileUpload, i as FindOptions, a2 as FirstFieldKey, a3 as FirstFieldValue, u as FlattenPartial, F as Flattened, o as FormDataConfigs, X as FromMetaOptions, a0 as GenericFn, G as GenericObject, al as GenericObjectPrimitive, d as HSL, g as HSLA, au as HasMethods, h as Hex, H as Hex6, e as Hex8, am as KeyForArray, an as KeyForObject, M as MaskOptions, ao as NestedKeyString, ap as NestedPrimitiveKey, av as NonNullishPrimitiveKey, Z as NormalPrimitive, aw as NormalPrimitiveKey, z as Numberified, N as Numeric, a4 as Option, l as OptionsConfig, k as OrderOption, t as OriginFileObj, O as OwnKeys, W as PageListOptions, U as PaginatorMeta, L as PaginatorOptions, p as ParsedFormData, w as PartialOrRequired, P as Percent, _ as Primitive, Q as QueryObject, aq as QueryObjectValue, B as QueryString, c as RGB, f as RGBA, R as RandomIdOptions, x as SanitizeOptions, q as SerializedForm, ag as SolidColors, S as SolidValues, j as SortByOption, n as SortNature, a5 as SortOptions, E as StrictObject, y as Stringified, ah as Tetrad, T as ThrottledFn, ai as Triad, V as VoidFunction } from './types-C33n5Qt0.js';
+export { as as AdvancedTypes, a6 as AlphaColors, a7 as AlphaValue, A as AlphaValues, ar as AnagramOptions, a8 as Analogous, v as Any, $ as AsyncFunction, at as Branded, af as CSSColor, C as CapitalizeOptions, a as CaseFormat, K as ClassDetails, a9 as ColorInput, b as ColorInputArray, ab as ColorType, ac as ColorTypeAlpha, ad as ColorTypeSolid, aa as Colors, I as Constructor, ae as ConvertedColors, r as CustomFile, J as DelayedFn, D as DotNotationKey, ak as DotNotationKeyStrict, Y as FalsyPrimitive, m as FieldValue, aj as FileError, s as FileUpload, i as FindOptions, a2 as FirstFieldKey, a3 as FirstFieldValue, u as FlattenPartial, F as Flattened, o as FormDataConfigs, X as FromMetaOptions, a0 as GenericFn, G as GenericObject, al as GenericObjectPrimitive, d as HSL, g as HSLA, au as HasMethods, h as Hex, H as Hex6, e as Hex8, am as KeyForArray, an as KeyForObject, M as MaskOptions, ao as NestedKeyString, ap as NestedPrimitiveKey, av as NonNullishPrimitiveKey, Z as NormalPrimitive, aw as NormalPrimitiveKey, z as Numberified, N as Numeric, a4 as Option, l as OptionsConfig, k as OrderOption, t as OriginFileObj, O as OwnKeys, W as PageListOptions, U as PaginatorMeta, L as PaginatorOptions, p as ParsedFormData, w as PartialOrRequired, P as Percent, _ as Primitive, Q as QueryObject, aq as QueryObjectValue, B as QueryString, c as RGB, f as RGBA, R as RandomIdOptions, x as SanitizeOptions, q as SerializedForm, ag as SolidColors, S as SolidValues, j as SortByOption, n as SortNature, a5 as SortOptions, E as StrictObject, y as Stringified, ah as Tetrad, T as ThrottledFn, ai as Triad, V as VoidFunction } from './typedefs-C3luCa9l.js';
 export { K as ApplyChangeOptions, h as ChronosFormat, i as ChronosInput, j as ChronosMethods, k as ChronosObject, C as ChronosStatics, d as ConvertOptions, b as ConvertedDecimal, c as CurrencyCode, l as DateParts, m as Day, n as DayPart, o as DayPartConfig, D as DecimalOptions, F as FormatOptions, O as FrankFurter, V as GetChangeOptions, X as GetDifferenceOptions, _ as GetOriginalOptions, $ as GetPercentOptions, a0 as GetValueOptions, G as GreetingConfigs, H as Hour, p as Hours, a1 as InversePercentageOptions, L as LocaleCode, M as Millisecond, q as Minute, r as Minutes, s as Month, t as MonthDate, u as NegativeUTCHour, N as NumberType, P as PercentageOptions, v as PositiveUTCHour, Q as Quarter, R as RandomNumberOptions, e as RangeOptions, f as RangedNumbers, a2 as SIPrefix, w as Second, x as Seconds, y as StrictFormat, S as SupportedCurrency, T as Time, z as TimeDuration, A as TimeFormats, B as TimeParts, E as TimeUnit, I as TimeZone, J as UTCMinute, U as UTCOffSet, a3 as UnitKey, a4 as UnitLabel, a5 as UnitNumberMethods, W as WithoutOrigin, Y as Year, Z as ZodiacSign } from './Chronos-v7ni8eaQ.js';

package/dist/typedefs.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=typedefs.js.map
+//# sourceMappingURL=typedefs.js.map

package/dist/typedefs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"typedefs.js"}

package/dist/typedefs.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=typedefs.mjs.map
+//# sourceMappingURL=typedefs.mjs.map

package/dist/typedefs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"typedefs.mjs"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.11.4",
+  "version": "4.11.6",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -49,40 +49,27 @@
   },
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
     },
     "./types": {
-      "import": {
-        "types": "./dist/dts/types/index.d.mts",
-        "default": "./dist/dts/types/index.d.mts"
-      },
-      "require": {
-        "types": "./dist/dts/types/index.d.ts",
-        "default": "./dist/dts/types/index.d.ts"
-      }
-    },
-    "./chronos": {
-      "import": {
-        "types": "./dist/chronos.d.mts",
-        "default": "./dist/chronos.mjs"
-      },
-      "require": {
-        "types": "./dist/chronos.d.ts",
-        "default": "./dist/chronos.js"
-      }
+      "types": "./dist/typedefs.d.ts",
+      "default": "./dist/typedefs.d.ts"
     }
   },
+  "./chronos": {
+    "types": "./dist/chronos.d.ts",
+    "import": "./dist/chronos.mjs",
+    "require": "./dist/chronos.js"
+  },
   "typesVersions": {
     "*": {
       "chronos": [
         "dist/chronos.d.ts"
+      ],
+      "types": [
+        "dist/typedefs.d.ts"
       ]
     }
   },

package/dist/types.js

@@ -1,4 +0,0 @@
-'use strict';
-
-//# sourceMappingURL=types.js.map
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/dist/types.mjs

@@ -1,3 +0,0 @@
-
-//# sourceMappingURL=types.mjs.map
-//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"types.mjs"}