@hairy/utils 1.46.0 → 1.49.0

package/dist/{index.d.ts → index.d.cts}

@@ -1,15 +1,16 @@
-export { chunk, clone, cloneDeep, cloneDeepWith, cloneWith, concat, debounce, find, get, groupBy, isArguments, isArray, isArrayBuffer, isArrayLike, isArrayLikeObject, isBoolean, isBuffer, isDate, isElement, isEmpty, isEqual, isEqualWith, isError, isFunction, isInteger, isMap, isMatch, isMatchWith, isNaN, isNative, isNull, isNumber, isObject, isObjectLike, isPlainObject, isRegExp as isRegexp, isSet, isString, isSymbol, isUndefined, isWeakMap, isWeakSet, join, keyBy, keys, max, maxBy, merge, mergeWith, min, minBy, omit, omitBy, once, pick, pickBy, range, set, truncate, uniq, uniqBy, uniqWith, values } from 'lodash-es';
-import _Bignumber from 'bignumber.js';
+import { chunk, clone, cloneDeep, cloneDeepWith, cloneWith, concat, debounce, find, get, groupBy, isArguments, isArray, isArrayBuffer, isArrayLike, isArrayLikeObject, isBoolean, isBuffer, isDate, isElement, isEmpty, isEqual, isEqualWith, isError, isFunction, isInteger, isMap, isMatch, isMatchWith, isNaN, isNative, isNull, isNumber, isObject, isObjectLike, isPlainObject, isRegExp as isRegexp, isSet, isString, isSymbol, isUndefined, isWeakMap, isWeakSet, join, keyBy, keys, max, maxBy, merge, mergeWith, min, minBy, omit, omitBy, once, pick, pickBy, range, set, truncate, uniq, uniqBy, uniqWith, values } from "lodash-es";
+import _Bignumber from "bignumber.js";
 
+//#region src/browser/file.d.ts
 interface OpenFilePickerOptions {
-    /**
-     * select multiple files
-     */
-    multiple?: boolean;
-    /**
-     * Choose the default format for the file
-     */
-    accept?: string;
+  /**
+   * select multiple files
+   */
+  multiple?: boolean;
+  /**
+   * Choose the default format for the file
+   */
+  accept?: string;
 }
 /**
  * Select multiple files
@@ -18,10 +19,10 @@ declare function openFilePicker(option?: OpenFilePickerOptions): Promise<File[]>
 /** @deprecated use openFilePicker */
 declare const showOpenFilePicker: typeof openFilePicker;
 interface OpenImagePickerOptions {
-    /**
-     * select multiple images
-     */
-    multiple?: boolean;
+  /**
+   * select multiple images
+   */
+  multiple?: boolean;
 }
 /**
  * Select multiple images
@@ -51,30 +52,32 @@ type ReaderType = 'readAsArrayBuffer' | 'readAsBinaryString' | 'readAsDataURL' |
  * @param file file object
  */
 declare function readFileReader<T extends ReaderType>(formType: T, file: File): Promise<T extends "readAsArrayBuffer" ? ArrayBuffer : string>;
-
+//#endregion
+//#region src/typings/atom.d.ts
 type Numeric = string | number | bigint;
 type Numberish = Numeric | {
-    toString: (...args: any[]) => string;
+  toString: (...args: any[]) => string;
 } | undefined | null;
 interface DynamicObject {
-    [key: string]: any;
+  [key: string]: any;
 }
 interface NumericObject {
-    [key: string]: Numeric;
+  [key: string]: Numeric;
 }
 interface StringObject {
-    [key: string]: string;
+  [key: string]: string;
 }
 interface NumberObject {
-    [key: string]: string;
+  [key: string]: string;
 }
 interface SymbolObject {
-    [key: string]: symbol;
+  [key: string]: symbol;
 }
 type Key = string | number | symbol;
 type BooleanLike = any;
 type Noop = (...args: any[]) => any;
-
+//#endregion
+//#region src/typings/util.d.ts
 /**
  *  Any type that can be used where a big number is needed.
  */
@@ -83,7 +86,7 @@ type Arrayable<T> = T | T[];
 type Promisify<T> = Promise<Awaited<T>>;
 type ElementOf<T> = T extends (infer E)[] ? E : never;
 type Nullable<T> = T | null | undefined;
-type Fn$1<T = void> = () => T;
+type Fn<T = void> = () => T;
 type AnyFn = (...args: any[]) => any;
 type PromiseFn = (...args: any[]) => Promise<any>;
 type IfAny<T, Y, N> = 0 extends 1 & T ? Y : N;
@@ -92,51 +95,30 @@ type ConstructorType<T = void> = new (...args: any[]) => T;
 type ArgumentsType<T> = T extends ((...args: infer A) => any) ? A : never;
 type PromiseType<P extends PromiseLike<any>> = P extends PromiseLike<infer T> ? T : never;
 type BrowserNativeObject = Date | FileList | File;
-type Option<L extends Key = 'label', V extends Key = 'value', C extends Key = 'children'> = {
-    [P in L]?: string;
-} & {
-    [P in V]?: Numeric;
-} & {
-    [P in C]?: Option<L, V, C>[];
-};
-type OmitBy<T, V> = {
-    [K in keyof T as T[K] extends V ? never : K]: T[K];
-};
-type PickBy<T, U> = {
-    [K in keyof T as T[K] extends U ? K : never]: T[K];
-};
+type Option<L extends Key = 'label', V extends Key = 'value', C extends Key = 'children'> = { [P in L]?: string } & { [P in V]?: Numeric } & { [P in C]?: Option<L, V, C>[] };
+type OmitBy<T, V> = { [K in keyof T as T[K] extends V ? never : K]: T[K] };
+type PickBy<T, U> = { [K in keyof T as T[K] extends U ? K : never]: T[K] };
 type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
 type Assign<T, U> = Omit<T, keyof U> & U;
 type NonUndefined<T> = T extends undefined ? never : T;
-
-type DeepReadonly<T> = {
-    readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
-};
-type DeepRequired<T> = {
-    [P in keyof T]-?: T[P] extends object ? DeepRequired<T[P]> : T[P];
-};
-type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-type DeepReplace<T, K = unknown, V = unknown> = {
-    [P in keyof T]: K extends P ? V : DeepReplace<T[P], K, V>;
-};
+//#endregion
+//#region src/typings/deep.d.ts
+type DeepReadonly<T> = { readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P] };
+type DeepRequired<T> = { [P in keyof T]-?: T[P] extends object ? DeepRequired<T[P]> : T[P] };
+type DeepPartial<T> = { [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P] };
+type DeepReplace<T, K = unknown, V = unknown> = { [P in keyof T]: K extends P ? V : DeepReplace<T[P], K, V> };
 type DeepKeyof<T> = T extends object ? keyof T | DeepKeyof<T[keyof T]> : never;
-type MergeInsertions<T> = T extends object ? {
-    [K in keyof T]: MergeInsertions<T[K]>;
-} : T;
-type DeepMerge<F, S> = MergeInsertions<{
-    [K in keyof F | keyof S]: K extends keyof S & keyof F ? DeepMerge<F[K], S[K]> : K extends keyof S ? S[K] : K extends keyof F ? F[K] : never;
-}>;
-type DeepMap<T, V, ST = BrowserNativeObject> = IsAny<T> extends true ? any : T extends ST ? V : T extends object ? {
-    [K in keyof T]: DeepMap<NonUndefined<T[K]>, V, ST>;
-} : V;
-
+type MergeInsertions<T> = T extends object ? { [K in keyof T]: MergeInsertions<T[K]> } : T;
+type DeepMerge<F, S> = MergeInsertions<{ [K in keyof F | keyof S]: K extends keyof S & keyof F ? DeepMerge<F[K], S[K]> : K extends keyof S ? S[K] : K extends keyof F ? F[K] : never }>;
+type DeepMap<T, V, ST = BrowserNativeObject> = IsAny<T> extends true ? any : T extends ST ? V : T extends object ? { [K in keyof T]: DeepMap<NonUndefined<T[K]>, V, ST> } : V;
+//#endregion
+//#region src/browser/util.d.ts
 declare function redirectTo(url: string, target?: string): void;
 declare function dialsPhone(phoneNumber: string): void;
-declare function on<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['addEventListener']> | [string, Fn$1 | null, ...any]): void;
-declare function off<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['removeEventListener']> | [string, Fn$1 | null, ...any]): void;
-
+declare function on<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['addEventListener']> | [string, Fn | null, ...any]): void;
+declare function off<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['removeEventListener']> | [string, Fn | null, ...any]): void;
+//#endregion
+//#region src/is/index.d.ts
 declare const isBrowser: () => boolean;
 declare const isWeex: () => boolean;
 declare const isIE: () => boolean | "";
@@ -152,7 +134,8 @@ declare const isMobile: () => boolean;
 declare const isFormData: (value: any) => value is FormData;
 declare const isWindow: (value: any) => value is Window;
 declare const isTruthy: <T>(value: T) => value is NonNullable<T>;
-
+//#endregion
+//#region ../../node_modules/.pnpm/change-case@5.4.4/node_modules/change-case/dist/index.d.ts
 /**
  * Supported locale values. Use `false` to ignore locale.
  * Defaults to `undefined`, which uses the host environment.
@@ -162,19 +145,19 @@ type Locale = string[] | string | false | undefined;
  * Options used for converting strings to pascal/camel case.
  */
 interface PascalCaseOptions extends Options {
-    mergeAmbiguousCharacters?: boolean;
+  mergeAmbiguousCharacters?: boolean;
 }
 /**
  * Options used for converting strings to any case.
  */
 interface Options {
-    locale?: Locale;
-    split?: (value: string) => string[];
-    /** @deprecated Pass `split: splitSeparateNumbers` instead. */
-    separateNumbers?: boolean;
-    delimiter?: string;
-    prefixCharacters?: string;
-    suffixCharacters?: string;
+  locale?: Locale;
+  split?: (value: string) => string[];
+  /** @deprecated Pass `split: splitSeparateNumbers` instead. */
+  separateNumbers?: boolean;
+  delimiter?: string;
+  prefixCharacters?: string;
+  suffixCharacters?: string;
 }
 /**
  * Convert a string to space separated lower case (`foo bar`).
@@ -224,14 +207,15 @@ declare function snakeCase(input: string, options?: Options): string;
  * Convert a string to header case (`Foo-Bar`).
  */
 declare function trainCase(input: string, options?: Options): string;
-
+//#endregion
+//#region src/number/index.d.ts
 declare const DEFAULT_BIGNUM_CONFIG: _Bignumber.Config;
 declare namespace Bignumber {
-    type RoundingMode = _Bignumber.RoundingMode;
-    type Format = _Bignumber.Format;
-    type Config = _Bignumber.Config;
-    type Instance = _Bignumber.Instance;
-    type Value = _Bignumber.Value;
+  type RoundingMode = _Bignumber.RoundingMode;
+  type Format = _Bignumber.Format;
+  type Config = _Bignumber.Config;
+  type Instance = _Bignumber.Instance;
+  type Value = _Bignumber.Value;
 }
 declare const Bignumber: typeof _Bignumber;
 /**
@@ -240,47 +224,47 @@ declare const Bignumber: typeof _Bignumber;
  * do not use Bignumber directly, use bignumber function instead
  */
 declare const BIG_INTS: {
-    t: {
-        v: number;
-        d: number;
-        n: string;
-    };
-    b: {
-        v: number;
-        d: number;
-        n: string;
-    };
-    m: {
-        v: number;
-        d: number;
-        n: string;
-    };
-    k: {
-        v: number;
-        d: number;
-        n: string;
-    };
+  t: {
+    v: number;
+    d: number;
+    n: string;
+  };
+  b: {
+    v: number;
+    d: number;
+    n: string;
+  };
+  m: {
+    v: number;
+    d: number;
+    n: string;
+  };
+  k: {
+    v: number;
+    d: number;
+    n: string;
+  };
 };
 type Delimiter = 'k' | 'm' | 'b' | 't';
 interface DecimalOptions {
-    d?: number;
-    r?: Bignumber.RoundingMode;
+  d?: number;
+  r?: Bignumber.RoundingMode;
 }
 interface FormatGroupOptions {
-    size?: number;
-    symbol?: string;
+  size?: number;
+  symbol?: string;
 }
 interface FormatNumericOptions {
-    delimiters?: Delimiter[] | false;
-    rounding?: Bignumber.RoundingMode;
-    decimals?: number;
-    decimalsZero?: boolean;
-    default?: string;
-    format?: Bignumber.Format;
+  delimiters?: Delimiter[] | false;
+  rounding?: Bignumber.RoundingMode;
+  decimals?: number;
+  decimalsZero?: boolean;
+  default?: string;
+  format?: Bignumber.Format;
 }
 declare function bignumber(n?: Numberish, base?: number): _Bignumber;
 declare namespace bignumber {
-    var clone: (config: Bignumber.Config) => typeof _Bignumber;
+  var clone: (config: Bignumber.Config) => typeof _Bignumber;
 }
 declare function gte(a: Numberish, b: Numberish): boolean;
 declare function gt(a: Numberish, b: Numberish): boolean;
@@ -316,9 +300,9 @@ declare function integer(value: Numberish): string;
  */
 declare function decimal(value: Numberish, n?: number): string;
 declare function parseNumeric(num: Numberish, delimiters?: Delimiter[]): {
-    v: number;
-    d: number;
-    n: string;
+  v: number;
+  d: number;
+  n: string;
 };
 /**
  * format number thousand separator and unit
@@ -326,7 +310,8 @@ declare function parseNumeric(num: Numberish, delimiters?: Delimiter[]): {
  * @param options
  */
 declare function formatNumeric(value?: Numberish, options?: FormatNumericOptions): string;
-
+//#endregion
+//#region src/string/index.d.ts
 /**
  * Intercept front and back characters, hide middle characters
  * @param value
@@ -334,6 +319,17 @@ declare function formatNumeric(value?: Numberish, options?: FormatNumericOptions
  * @param symbol
  */
 declare function cover(value: string, mode: [number, number, number], symbol?: string): string;
+/**
+ * Shortens an identifier string by showing only the beginning and end portions,
+ * with ellipsis in the middle. Suitable for various types of identifiers like
+ * IPFS CID, transaction hashes, EVM addresses, user IDs, etc.
+ *
+ * @param value - The identifier string to shorten
+ * @param startWith - Number of characters to show at the start (default: 6)
+ * @param endWith - Number of characters to show at the end (default: 6)
+ * @returns Shortened identifier string with ellipsis, or empty string if id is null/undefined
+ */
+declare function shortenId(value: string | null | undefined, startWith?: number, endWith?: number): string;
 /**
  * Replace backslash to slash
  *
@@ -396,7 +392,8 @@ declare function template(str: string, ...args: (string | number | bigint | unde
  * `
  */
 declare function unindent(str: TemplateStringsArray | string): string;
-
+//#endregion
+//#region src/util/compose-promise.d.ts
 type UF$1<VT, RT> = (value: VT) => RT | PromiseLike<RT>;
 type Composed<VT, RT> = (value?: VT) => Promise<RT>;
 /**
@@ -425,8 +422,9 @@ declare function pCompose<VT, R1, R2, R3, R4, R5, RT>(f1: UF$1<R5, RT>, f2: UF$1
 declare function pCompose<VT, R1, R2, R3, R4, R5, R6, RT>(f1: UF$1<R6, RT>, f2: UF$1<R5, R6>, f3: UF$1<R4, R5>, f4: UF$1<R3, R4>, f5: UF$1<R2, R3>, f6: UF$1<R1, R2>, f7: UF$1<VT, R1>): Composed<VT, RT>;
 declare function pCompose<VT, R1, R2, R3, R4, R5, R6, R7, RT>(f1: UF$1<R7, RT>, f2: UF$1<R6, R7>, f3: UF$1<R5, R6>, f4: UF$1<R4, R5>, f5: UF$1<R3, R4>, f6: UF$1<R2, R3>, f7: UF$1<R1, R2>, f8: UF$1<VT, R1>): Composed<VT, RT>;
 declare function pCompose<VT, R1, R2, R3, R4, R5, R6, R7, R8, RT>(f1: UF$1<R8, RT>, f2: UF$1<R7, R8>, f3: UF$1<R6, R7>, f4: UF$1<R5, R6>, f5: UF$1<R4, R5>, f6: UF$1<R3, R4>, f7: UF$1<R2, R3>, f8: UF$1<R1, R2>, f9: UF$1<VT, R1>): Composed<VT, RT>;
-
-type Fn<V, R> = (x: V) => R;
+//#endregion
+//#region src/util/compose.d.ts
+type Fn$1<V, R> = (x: V) => R;
 type Q<T, V> = (...args: T) => V;
 /**
  * Performs function composition in RTL (Right To Left) direction.
@@ -462,20 +460,21 @@ type Q<T, V> = (...args: T) => V;
  * @param ...fns - Iterated over sequentially when returned `function` is called.
  * @returns The `fns` functions are applied from right to left.
  */
-declare function compose<T, V0, V1>(fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V1>;
-declare function compose<T, V0, V1, V2>(fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V2>;
-declare function compose<T, V0, V1, V2, V3>(fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V3>;
-declare function compose<T, V0, V1, V2, V3, V4>(fn4: Fn<V3, V4>, fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V4>;
-declare function compose<T, V0, V1, V2, V3, V4, V5>(fn5: Fn<V4, V5>, fn4: Fn<V3, V4>, fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V5>;
-declare function compose<T, V0, V1, V2, V3, V4, V5, V6>(fn6: Fn<V5, V6>, fn5: Fn<V4, V5>, fn4: Fn<V3, V4>, fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V6>;
-declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7>(fn7: Fn<V6, V7>, fn6: Fn<V5, V6>, fn5: Fn<V4, V5>, fn4: Fn<V3, V4>, fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V7>;
-declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7, V8>(fn8: Fn<V7, V8>, fn7: Fn<V6, V7>, fn6: Fn<V5, V6>, fn5: Fn<V4, V5>, fn4: Fn<V3, V4>, fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V8>;
-declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7, V8, V9>(fn9: Fn<V8, V9>, fn8: Fn<V7, V8>, fn7: Fn<V6, V7>, fn6: Fn<V5, V6>, fn5: Fn<V4, V5>, fn4: Fn<V3, V4>, fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V9>;
-declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7, V8, V9, V10>(fn10: Fn<V9, V10>, fn9: Fn<V8, V9>, fn8: Fn<V7, V8>, fn7: Fn<V6, V7>, fn6: Fn<V5, V6>, fn5: Fn<V4, V5>, fn4: Fn<V3, V4>, fn3: Fn<V2, V3>, fn2: Fn<V1, V2>, fn1: Fn<V0, V1>, fn0: Q<T, V0>): Q<T, V10>;
+declare function compose<T, V0, V1>(fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V1>;
+declare function compose<T, V0, V1, V2>(fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V2>;
+declare function compose<T, V0, V1, V2, V3>(fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V3>;
+declare function compose<T, V0, V1, V2, V3, V4>(fn4: Fn$1<V3, V4>, fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V4>;
+declare function compose<T, V0, V1, V2, V3, V4, V5>(fn5: Fn$1<V4, V5>, fn4: Fn$1<V3, V4>, fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V5>;
+declare function compose<T, V0, V1, V2, V3, V4, V5, V6>(fn6: Fn$1<V5, V6>, fn5: Fn$1<V4, V5>, fn4: Fn$1<V3, V4>, fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V6>;
+declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7>(fn7: Fn$1<V6, V7>, fn6: Fn$1<V5, V6>, fn5: Fn$1<V4, V5>, fn4: Fn$1<V3, V4>, fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V7>;
+declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7, V8>(fn8: Fn$1<V7, V8>, fn7: Fn$1<V6, V7>, fn6: Fn$1<V5, V6>, fn5: Fn$1<V4, V5>, fn4: Fn$1<V3, V4>, fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V8>;
+declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7, V8, V9>(fn9: Fn$1<V8, V9>, fn8: Fn$1<V7, V8>, fn7: Fn$1<V6, V7>, fn6: Fn$1<V5, V6>, fn5: Fn$1<V4, V5>, fn4: Fn$1<V3, V4>, fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V9>;
+declare function compose<T, V0, V1, V2, V3, V4, V5, V6, V7, V8, V9, V10>(fn10: Fn$1<V9, V10>, fn9: Fn$1<V8, V9>, fn8: Fn$1<V7, V8>, fn7: Fn$1<V6, V7>, fn6: Fn$1<V5, V6>, fn5: Fn$1<V4, V5>, fn4: Fn$1<V3, V4>, fn3: Fn$1<V2, V3>, fn2: Fn$1<V1, V2>, fn1: Fn$1<V0, V1>, fn0: Q<T, V0>): Q<T, V10>;
 declare namespace compose {
-    var promise: typeof pCompose;
+  var promise: typeof pCompose;
 }
-
+//#endregion
+//#region src/util/deferred.d.ts
 /**
  * A deferred promise.
  * @param T - The type of the value.
@@ -486,11 +485,12 @@ declare namespace compose {
  * deferred.resolve('value')
  */
 declare class Deferred<T> extends Promise<T> {
-    resolve: (value?: T) => Deferred<T>;
-    reject: (reason?: any) => Deferred<T>;
-    constructor(executor?: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void);
+  resolve: (value?: T) => Deferred<T>;
+  reject: (reason?: any) => Deferred<T>;
+  constructor(executor?: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void);
 }
-
+//#endregion
+//#region src/util/delay.d.ts
 /**
  * Delay for a given number of milliseconds.
  * @param ms - The number of milliseconds to delay.
@@ -500,9 +500,11 @@ declare class Deferred<T> extends Promise<T> {
  * delay(1000).then(() => { console.log('1 second') })
  */
 declare function delay(ms: number): Promise<void>;
-
+//#endregion
+//#region src/util/json.d.ts
 declare function tryParseJson<T = any>(text: string | undefined | null): T | undefined;
-
+//#endregion
+//#region src/util/loop.d.ts
 /**
  * A function that performs a loop operation with delay control.
  * @template T - The return type of the loop function (defaults to void)
@@ -540,32 +542,34 @@ declare function loop_return<T = void>(fn: Looper<T>): Promise<T>;
  * console.log(result)
  * ```
  */
-declare function loop(fn: Looper<void>): Fn$1;
+declare function loop(fn: Looper<void>): Fn;
 declare namespace loop {
-    var _a: typeof loop_return;
-    export { _a as return };
+  var _a: typeof loop_return;
+  export { _a as return };
 }
-
+//#endregion
+//#region src/util/noop.d.ts
 declare const noop: (...args: any) => any;
-
+//#endregion
+//#region src/util/pipe-promise.d.ts
 type UF<VT, RT> = (value: VT) => RT | PromiseLike<RT>;
 type Pipeline<VT, RT> = (value?: VT) => Promise<RT>;
 /**
-Compose promise-returning & async fns into a reusable pipeline.
-
-@param ...input - Iterated over sequentially when returned `function` is called.
-@returns The `input` fns are applied from left to right.
-
-@example
-```
-const addUnicorn = async string => `${string} Unicorn`;
-const addRainbow = async string => `${string} Rainbow`;
-
-const pipeline = pipe.promise(addUnicorn, addRainbow);
-
-console.log(await pipeline('❤️'));
-//=> '❤️ Unicorn Rainbow'
-```
+ * Compose promise-returning & async fns into a reusable pipeline.
+ *
+ * @param ...input - Iterated over sequentially when returned `function` is called.
+ * @returns The `input` fns are applied from left to right.
+ *
+ * @example
+ * ```
+ * const addUnicorn = async string => `${string} Unicorn`;
+ * const addRainbow = async string => `${string} Rainbow`;
+ *
+ * const pipeline = pipe.promise(addUnicorn, addRainbow);
+ *
+ * console.log(await pipeline('❤️'));
+ * //=> '❤️ Unicorn Rainbow'
+ * ```
  */
 declare function pPipe<VT, RT>(f1: UF<VT, RT>): Pipeline<VT, RT>;
 declare function pPipe<VT, R1, RT>(f1: UF<VT, R1>, f2: UF<R1, RT>): Pipeline<VT, RT>;
@@ -576,7 +580,8 @@ declare function pPipe<VT, R1, R2, R3, R4, R5, RT>(f1: UF<VT, R1>, f2: UF<R1, R2
 declare function pPipe<VT, R1, R2, R3, R4, R5, R6, RT>(f1: UF<VT, R1>, f2: UF<R1, R2>, f3: UF<R2, R3>, f4: UF<R3, R4>, f5: UF<R4, R5>, f6: UF<R5, R6>, f7: UF<R6, RT>): Pipeline<VT, RT>;
 declare function pPipe<VT, R1, R2, R3, R4, R5, R6, R7, RT>(f1: UF<VT, R1>, f2: UF<R1, R2>, f3: UF<R2, R3>, f4: UF<R3, R4>, f5: UF<R4, R5>, f6: UF<R5, R6>, f7: UF<R6, R7>, f8: UF<R7, RT>): Pipeline<VT, RT>;
 declare function pPipe<VT, R1, R2, R3, R4, R5, R6, R7, R8, RT>(f1: UF<VT, R1>, f2: UF<R1, R2>, f3: UF<R2, R3>, f4: UF<R3, R4>, f5: UF<R4, R5>, f6: UF<R5, R6>, f7: UF<R6, R7>, f8: UF<R7, R8>, f9: UF<R8, RT>): Pipeline<VT, RT>;
-
+//#endregion
+//#region src/util/pipe.d.ts
 /**
  * Performs function composition in LTR (Left To Right) direction.
  *
@@ -623,15 +628,16 @@ declare function pipe<Args extends unknown[], T0, T1, T2, T3, T4, T5, T6, T7>(..
 declare function pipe<Args extends unknown[], T0, T1, T2, T3, T4, T5, T6, T7, T8>(...fns: [(...xs: Args) => T0, (x: T0) => T1, (x: T1) => T2, (x: T2) => T3, (x: T3) => T4, (x: T4) => T5, (x: T5) => T6, (x: T6) => T7, (x: T7) => T8]): (...xs: Args) => T8;
 declare function pipe<Args extends unknown[], T0, T1, T2, T3, T4, T5, T6, T7, T8, T9>(...fns: [(...xs: Args) => T0, (x: T0) => T1, (x: T1) => T2, (x: T2) => T3, (x: T3) => T4, (x: T4) => T5, (x: T5) => T6, (x: T6) => T7, (x: T7) => T8, (x: T8) => T9]): (...xs: Args) => T9;
 declare namespace pipe {
-    var promise: typeof pPipe;
+  var promise: typeof pPipe;
 }
-
-type Proxyed<T extends object> = T & {
-    proxy: {
-        update: (object?: T) => void;
-        original: () => T | undefined;
-    };
-};
+//#endregion
+//#region src/util/proxy.d.ts
+type Proxyed<T extends object, E extends object = {}> = T & {
+  proxy: {
+    update: (object?: T) => void;
+    source: T | undefined;
+  };
+} & E;
 /**
  * Creates a proxy object that updates the original object when the proxy is updated.
  * @param initObject - The initial object to proxy.
@@ -642,22 +648,25 @@ type Proxyed<T extends object> = T & {
  * const obj = proxy({ name: 'John' })
  * console.log(obj.name) // John
  *
- * proxy.update({ name: 'Jane' })
+ * obj.proxy.update({ name: 'Jane' })
  * console.log(obj.name) // Jane
  *
  * const obj2 = proxy()
  *
  * obj2.any // Error: Proxy not updated. Call object.proxy.update() to update the proxy.
  *
- * proxy.original(obj2) // undefined
+ * obj2.proxy.source // undefined
  * obj2.update({ name: 'John' })
  *
  * // get the original object
- * proxy.original(obj2) // { name: 'John' }
+ * obj2.proxy.source // { name: 'John' }
  * ```
  */
-declare function proxy<T extends object>(initObject?: T): Proxyed<T>;
-
+declare function proxy<T extends object, E extends object = {}>(initObject?: T, initExtend?: E, options?: {
+  strictMessage?: string;
+}): Proxyed<T, E>;
+//#endregion
+//#region src/util/random.d.ts
 /**
  * Get a random item from an array.
  * @param array - The array to get a random item from.
@@ -689,7 +698,8 @@ declare function randomNumber(min: number, max: number): number;
  * randomString(20, 'abcdefghijklmnopqrstuvwxyz') // 20 characters long
  */
 declare function randomString(size?: number, chars?: string): string;
-
+//#endregion
+//#region src/util/serialized.d.ts
 /**
  * formData to object
  * @param formData
@@ -724,7 +734,8 @@ declare function stringify(value: any): string;
  * @returns The numberish value.
  */
 declare function numberish(value: Numberish): string;
-
+//#endregion
+//#region src/util/to.d.ts
 /**
  * Convert a promise to a tuple of [error, data].
  * @param promise - The promise to convert.
@@ -736,7 +747,8 @@ declare function numberish(value: Numberish): string;
  * to(Promise.reject(new Error('error'))) // Promise<[Error, undefined]>
  */
 declare function to<T, U = Error>(promise: Promise<T> | (() => Promise<T>), error?: object): Promise<[U, undefined] | [null, T]>;
-
+//#endregion
+//#region src/util/to-array.d.ts
 /**
  * Convert a value to an array.
  * @param value - The value to convert.
@@ -748,21 +760,23 @@ declare function to<T, U = Error>(promise: Promise<T> | (() => Promise<T>), erro
  * toArray(arrayOrItemOrUndefined, true) // item[]
  */
 declare function toArray<T, R extends boolean>(value?: T | T[], required?: R): R extends true ? T[] : T[] | undefined;
-
+//#endregion
+//#region src/util/unit.d.ts
 type Dimension = Numeric | [Numeric, Numeric] | {
-    width: Numeric;
-    height: Numeric;
+  width: Numeric;
+  height: Numeric;
 };
 declare function unit(value: Numeric, unit?: string): string;
 declare function size(dimension: Dimension, unit?: string): {
-    width: string;
-    height: string;
+  width: string;
+  height: string;
 };
-
+//#endregion
+//#region src/util/util.d.ts
 /** @deprecated Use range instead */
 declare const arange: {
-    (start: number, end?: number, step?: number): number[];
-    (end: number, index: string | number, guard: object): number[];
+  (start: number, end?: number, step?: number): number[];
+  (end: number, index: string | number, guard: object): number[];
 };
 /**
  * Select a value based on a condition.
@@ -804,6 +818,6 @@ declare function unwrap<T extends object>(value: T | (() => T)): T;
  * whenever(value, (value) => { return 'value' }) // value
  */
 declare function whenever<T, C extends (value: Exclude<T, null | undefined>) => any>(value: T, callback: C): ReturnType<C> | undefined;
-declare function call<T extends Fn$1<any>>(fn: T, ...args: Parameters<T>): ReturnType<T>;
-
-export { type AnyFn, type ArgumentsType, type Arrayable, type Assign, type Awaitable, BIG_INTS, Bignumber, type BooleanLike, type BrowserNativeObject, type ConstructorType, DEFAULT_BIGNUM_CONFIG, type DecimalOptions, type DeepKeyof, type DeepMap, type DeepMerge, type DeepPartial, type DeepReadonly, type DeepReplace, type DeepRequired, Deferred, type Delimiter, type Dimension, type DynamicObject, type ElementOf, type Fn$1 as Fn, type FormatGroupOptions, type FormatNumericOptions, type IfAny, type IsAny, type Key, type Looper, type MergeInsertions, type NonUndefined, type Noop, type Nullable, type NumberObject, type Numberish, type Numeric, type NumericObject, type OmitBy, type OpenFilePickerOptions, type OpenImagePickerOptions, type Option, type Overwrite, type PickBy, type PromiseFn, type PromiseType, type Promisify, type Proxyed, type ReaderType, type StringObject, type SymbolObject, arange, average, bignumber, call, camelCase, capitalCase, compose, constantCase, cover, decimal, delay, dialsPhone, divide, dotCase, downloadBlobFile, downloadNetworkFile, downloadUrlFile, ensurePrefix, ensureSuffix, formatNumeric, formdataToObject, gt, gte, integer, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isTruthy, isWeex, isWindow, kebabCase, loop, lt, lte, multiply, noCase, nonnanable, noop, numberify, numberish, objectToFormdata, off, on, openFilePicker, openImagePicker, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pipe, plus, proxy, randomItem, randomNumber, randomString, readFileReader, redirectTo, riposte, select, selectImages, sentenceCase, showOpenFilePicker, showOpenImagePicker, size, slash, snakeCase, stringify, template, to, toArray, trainCase, tryParseJson, unindent, unit, unwrap, whenever, zeroRemove, zerofill };
+declare function call<T extends Fn<any>>(fn: T, ...args: Parameters<T>): ReturnType<T>;
+//#endregion
+export { AnyFn, ArgumentsType, Arrayable, Assign, Awaitable, BIG_INTS, Bignumber, BooleanLike, BrowserNativeObject, ConstructorType, DEFAULT_BIGNUM_CONFIG, DecimalOptions, DeepKeyof, DeepMap, DeepMerge, DeepPartial, DeepReadonly, DeepReplace, DeepRequired, Deferred, Delimiter, Dimension, DynamicObject, ElementOf, Fn, FormatGroupOptions, FormatNumericOptions, IfAny, IsAny, Key, Looper, MergeInsertions, NonUndefined, Noop, Nullable, NumberObject, Numberish, Numeric, NumericObject, OmitBy, OpenFilePickerOptions, OpenImagePickerOptions, Option, Overwrite, PickBy, PromiseFn, PromiseType, Promisify, Proxyed, ReaderType, StringObject, SymbolObject, arange, average, bignumber, call, camelCase, capitalCase, chunk, clone, cloneDeep, cloneDeepWith, cloneWith, compose, concat, constantCase, cover, debounce, decimal, delay, dialsPhone, divide, dotCase, downloadBlobFile, downloadNetworkFile, downloadUrlFile, ensurePrefix, ensureSuffix, find, formatNumeric, formdataToObject, get, groupBy, gt, gte, integer, isAndroid, isArguments, isArray, isArrayBuffer, isArrayLike, isArrayLikeObject, isBoolean, isBrowser, isBuffer, isChrome, isDate, isEdge, isElement, isEmpty, isEqual, isEqualWith, isError, isFF, isFormData, isFunction, isIE, isIE11, isIE9, isIOS, isInteger, isMap, isMatch, isMatchWith, isMobile, isNaN, isNative, isNull, isNumber, isObject, isObjectLike, isPhantomJS, isPlainObject, isRegexp, isSet, isString, isSymbol, isTruthy, isUndefined, isWeakMap, isWeakSet, isWeex, isWindow, join, kebabCase, keyBy, keys, loop, lt, lte, max, maxBy, merge, mergeWith, min, minBy, multiply, noCase, nonnanable, noop, numberify, numberish, objectToFormdata, off, omit, omitBy, on, once, openFilePicker, openImagePicker, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pick, pickBy, pipe, plus, proxy, randomItem, randomNumber, randomString, range, readFileReader, redirectTo, riposte, select, selectImages, sentenceCase, set, shortenId, showOpenFilePicker, showOpenImagePicker, size, slash, snakeCase, stringify, template, to, toArray, trainCase, truncate, tryParseJson, unindent, uniq, uniqBy, uniqWith, unit, unwrap, values, whenever, zeroRemove, zerofill };