@andrew_l/toolkit 0.2.4 → 0.2.5

package/dist/index.d.cts

@@ -114,23 +114,6 @@ declare function chunkSeries(list: number[], step?: number): number[][];
  */
 declare function difference<T>(...arrays: readonly T[][]): T[];
 
-/**
- * Returns the intersection of arrays.
- *
- * This function takes arrays and returns a new array containing the elements that are
- * present in all arrays.
- *
- * @template T - The type of elements in the array.
- * @returns {T[]} A new array containing the elements that are present in both arrays.
- *
- * @example
- * const array1 = [1, 2, 3, 4, 5];
- * const array2 = [3, 4, 5, 6, 7];
- * const result = intersection(array1, array2);
- * // result will be [3, 4, 5] since these elements are in both arrays.
- */
-declare function intersection<T>(...arrays: readonly T[][]): T[];
-
 type MaybePropertyKey<T> = T extends object
   ? keyof T | PropertyKey
   : PropertyKey;
@@ -149,6 +132,28 @@ type IsPropertyKey<T, V, L> = T extends object
     : L
   : PropertyKeyLiteralToType<L>;
 
+declare function groupBy<T, K extends MaybePropertyKey<T>>(array: readonly T[], keyBy: K, objectMode?: false): Map<IsPropertyKey<T, K, K>, T[]>;
+declare function groupBy<T, K>(array: readonly T[], keyBy: (item: T) => K, objectMode?: false): Map<K, T[]>;
+declare function groupBy<T, K extends MaybePropertyKey<T>>(array: readonly T[], keyBy: K, objectMode: true): Record<K, T[]>;
+declare function groupBy<T, K extends PropertyKey>(array: readonly T[], keyBy: (item: T) => K, objectMode: true): Record<K, T[]>;
+
+/**
+ * Returns the intersection of arrays.
+ *
+ * This function takes arrays and returns a new array containing the elements that are
+ * present in all arrays.
+ *
+ * @template T - The type of elements in the array.
+ * @returns {T[]} A new array containing the elements that are present in both arrays.
+ *
+ * @example
+ * const array1 = [1, 2, 3, 4, 5];
+ * const array2 = [3, 4, 5, 6, 7];
+ * const result = intersection(array1, array2);
+ * // result will be [3, 4, 5] since these elements are in both arrays.
+ */
+declare function intersection<T>(...arrays: readonly T[][]): T[];
+
 /**
  * Maps each element of an array based on a provided key.
  *
@@ -316,13 +321,45 @@ declare function uniq<T extends any[]>(value: T): T;
  */
 declare function uniqBy<T>(array: T[], comparator: ((value: T) => any) | PropertyKey): T[];
 
+type WrrItem<T> = {
+    item: T;
+    weight?: number;
+};
+/**
+ * Creates a function that returns a weighted round-robin item from the provided array.
+ *
+ * The input array should contain objects with an `item` property and a `weight` property.
+ * The `weight` determines the relative likelihood of selecting an item.
+ * Items with higher weights will appear more frequently in the selection.
+ *
+ * If the `weight` property is missing or falsy, it defaults to `1`.
+ * An empty array will result in a function that always returns `undefined`.
+ *
+ * @example
+ * const getItem = weightedRoundRobin([
+ *   { item: 'a', weight: 2 },
+ *   { item: 'b', weight: 3 },
+ *   { item: 'c' },
+ * ]);
+ *
+ * console.log(getItem()); // 'a', 'b', or 'c'
+ *
+ * @group Array
+ */
+declare function weightedRoundRobin<T = unknown>(arr: WrrItem<T>[]): () => T;
+
 declare function ok(value: unknown, message?: string | Error): asserts value;
 declare function equal<T>(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
+declare function empty(value: unknown, message?: string | Error): asserts value;
 declare function object(value: unknown, message?: string | Error): asserts value is object;
 declare function string(value: unknown, message?: string | Error): asserts value is string;
 declare function boolean(value: unknown, message?: string | Error): asserts value is boolean;
 declare function notEmptyString(value: unknown, message?: string | Error): asserts value is string;
 declare function number(value: unknown, message?: string | Error): asserts value is number;
+declare function date(value: unknown, message?: string | Error): asserts value is Date;
+declare function fn(value: unknown, message?: string | Error): asserts value is Function;
+declare function greaterThan(value: unknown, target: number, message?: string | Error): asserts value is number;
+declare function lessThan(value: unknown, target: number, message?: string | Error): asserts value is number;
 /**
  * @param {unknown} value
  * @param {string | Error} [message]
@@ -336,14 +373,19 @@ declare const assert_array: typeof array;
 declare const assert_arrayNumbers: typeof arrayNumbers;
 declare const assert_arrayStrings: typeof arrayStrings;
 declare const assert_boolean: typeof boolean;
+declare const assert_date: typeof date;
+declare const assert_empty: typeof empty;
 declare const assert_equal: typeof equal;
+declare const assert_fn: typeof fn;
+declare const assert_greaterThan: typeof greaterThan;
+declare const assert_lessThan: typeof lessThan;
 declare const assert_notEmptyString: typeof notEmptyString;
 declare const assert_number: typeof number;
 declare const assert_object: typeof object;
 declare const assert_ok: typeof ok;
 declare const assert_string: typeof string;
 declare namespace assert {
-  export { assert_array as array, assert_arrayNumbers as arrayNumbers, assert_arrayStrings as arrayStrings, assert_boolean as boolean, assert_equal as equal, assert_notEmptyString as notEmptyString, assert_number as number, assert_object as object, assert_ok as ok, assert_string as string };
+  export { assert_array as array, assert_arrayNumbers as arrayNumbers, assert_arrayStrings as arrayStrings, assert_boolean as boolean, assert_date as date, assert_empty as empty, assert_equal as equal, assert_fn as fn, assert_greaterThan as greaterThan, assert_lessThan as lessThan, assert_notEmptyString as notEmptyString, assert_number as number, assert_object as object, assert_ok as ok, assert_string as string };
 }
 
 type Base64ToBytesOptions = {
@@ -695,9 +737,17 @@ type FunctionArgs<Args extends any[] = any[], Return = void> = (
   ...args: Args
 ) => Return;
 
-type DeepPartial<T> = T extends object
-  ? { [P in keyof T]?: DeepPartial<T[P]> }
-  : T;
+type DeepPartial<T> = T extends Date
+  ? T
+  : T extends object
+    ? { [P in keyof T]?: DeepPartial<T[P]> }
+    : T;
+
+type DeepReadonly<T> = T extends unknown[]
+  ? Readonly<T>
+  : T extends object
+    ? Readonly<{ [P in keyof T]: DeepReadonly<T[P]> }>
+    : Readonly<T>;
 
 type AnyFunction = (...args: any[]) => any;
 
@@ -2531,7 +2581,12 @@ declare function isSuccess<T extends ExecResult>(value: T): value is ExecResultT
 declare function isSkip<T extends ExecResult>(value: T): value is ExecResultToSkip<T>;
 
 /**
- * Extracts file extension from filename or url link
+ * Extract file extension from string
+ *
+ * @example
+ * getFileExtension('Andrew L - CV.pdf'); // 'pdf'
+ *
+ * @group Files
  */
 declare function getFileExtension(name: string, withDot?: boolean): string | null;
 
@@ -2545,6 +2600,28 @@ declare function getFileExtension(name: string, withDot?: boolean): string | nul
  */
 declare function getFileName(value: string): string | null;
 
+/**
+ * Filters an array of paths to retain only the most specific (deepest) paths,
+ * removing any path that is a prefix of another path.
+ *
+ * @param {string[]} keys - An array of dot-separated string paths.
+ * @returns {string[]} - A new array containing only the most specific paths.
+ *
+ * @example
+ * const inputPaths = [
+ *   'profile',
+ *   'profile.basic',
+ *   'profile.basic.fullName',
+ *   'profile.updatedAt'
+ * ];
+ *
+ * const result = getMostSpecificPaths(inputPaths);
+ * console.log(result); // ['profile.basic.fullName', 'profile.updatedAt']
+ *
+ * @group Files
+ */
+declare function getMostSpecificPaths(keys: string[]): string[];
+
 /**
  * Converts bytes amount into human readably string
  *
@@ -3520,6 +3597,7 @@ interface FlattenOptions {
  * // { 'root-user-name': 'Jane', 'root-user-profile-age': 30 }
  *
  * @group Object
+ * @author lukeed
  */
 declare function flatten(obj: Record<string, unknown>, { separator, initialPrefix, withArrays, isObjectCompare, }?: FlattenOptions): Record<string, unknown>;
 
@@ -3738,8 +3816,9 @@ declare const toMap: <T extends object>(obj: T) => Map<keyof T, T[keyof T]>;
  * // }
  *
  * @group Object
+ * @author lukeed
  */
-declare function unflatten(obj: object, separator?: string): {};
+declare function unflatten(input: object, separator?: string): any;
 
 /**
  * Same as `set` but unset by dot notation
@@ -4910,4 +4989,4 @@ declare function wrapText(value: string, maxLength?: number): string;
  */
 declare function toError<T>(value: T, unknownMessage?: string): T extends Error ? T : Error;
 
-export { type AnyFunction, AppError, type ArgumentsType, type Arrayable, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, BrowserAssertionError, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DeepPartial, type Defer, instance as EJSON, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, type Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, type RetryOnErrorConfig, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, _default as TWEMOJI_REGEX, type ThemeConfig, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getRandomInt, getRandomTime, getWords, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };
+export { type AnyFunction, AppError, type ArgumentsType, type Arrayable, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, BrowserAssertionError, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DeepPartial, type DeepReadonly, type Defer, instance as EJSON, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, type Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, type RetryOnErrorConfig, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, _default as TWEMOJI_REGEX, type ThemeConfig, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, type WrrItem, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };

package/dist/index.d.mts

@@ -114,23 +114,6 @@ declare function chunkSeries(list: number[], step?: number): number[][];
  */
 declare function difference<T>(...arrays: readonly T[][]): T[];
 
-/**
- * Returns the intersection of arrays.
- *
- * This function takes arrays and returns a new array containing the elements that are
- * present in all arrays.
- *
- * @template T - The type of elements in the array.
- * @returns {T[]} A new array containing the elements that are present in both arrays.
- *
- * @example
- * const array1 = [1, 2, 3, 4, 5];
- * const array2 = [3, 4, 5, 6, 7];
- * const result = intersection(array1, array2);
- * // result will be [3, 4, 5] since these elements are in both arrays.
- */
-declare function intersection<T>(...arrays: readonly T[][]): T[];
-
 type MaybePropertyKey<T> = T extends object
   ? keyof T | PropertyKey
   : PropertyKey;
@@ -149,6 +132,28 @@ type IsPropertyKey<T, V, L> = T extends object
     : L
   : PropertyKeyLiteralToType<L>;
 
+declare function groupBy<T, K extends MaybePropertyKey<T>>(array: readonly T[], keyBy: K, objectMode?: false): Map<IsPropertyKey<T, K, K>, T[]>;
+declare function groupBy<T, K>(array: readonly T[], keyBy: (item: T) => K, objectMode?: false): Map<K, T[]>;
+declare function groupBy<T, K extends MaybePropertyKey<T>>(array: readonly T[], keyBy: K, objectMode: true): Record<K, T[]>;
+declare function groupBy<T, K extends PropertyKey>(array: readonly T[], keyBy: (item: T) => K, objectMode: true): Record<K, T[]>;
+
+/**
+ * Returns the intersection of arrays.
+ *
+ * This function takes arrays and returns a new array containing the elements that are
+ * present in all arrays.
+ *
+ * @template T - The type of elements in the array.
+ * @returns {T[]} A new array containing the elements that are present in both arrays.
+ *
+ * @example
+ * const array1 = [1, 2, 3, 4, 5];
+ * const array2 = [3, 4, 5, 6, 7];
+ * const result = intersection(array1, array2);
+ * // result will be [3, 4, 5] since these elements are in both arrays.
+ */
+declare function intersection<T>(...arrays: readonly T[][]): T[];
+
 /**
  * Maps each element of an array based on a provided key.
  *
@@ -316,13 +321,45 @@ declare function uniq<T extends any[]>(value: T): T;
  */
 declare function uniqBy<T>(array: T[], comparator: ((value: T) => any) | PropertyKey): T[];
 
+type WrrItem<T> = {
+    item: T;
+    weight?: number;
+};
+/**
+ * Creates a function that returns a weighted round-robin item from the provided array.
+ *
+ * The input array should contain objects with an `item` property and a `weight` property.
+ * The `weight` determines the relative likelihood of selecting an item.
+ * Items with higher weights will appear more frequently in the selection.
+ *
+ * If the `weight` property is missing or falsy, it defaults to `1`.
+ * An empty array will result in a function that always returns `undefined`.
+ *
+ * @example
+ * const getItem = weightedRoundRobin([
+ *   { item: 'a', weight: 2 },
+ *   { item: 'b', weight: 3 },
+ *   { item: 'c' },
+ * ]);
+ *
+ * console.log(getItem()); // 'a', 'b', or 'c'
+ *
+ * @group Array
+ */
+declare function weightedRoundRobin<T = unknown>(arr: WrrItem<T>[]): () => T;
+
 declare function ok(value: unknown, message?: string | Error): asserts value;
 declare function equal<T>(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
+declare function empty(value: unknown, message?: string | Error): asserts value;
 declare function object(value: unknown, message?: string | Error): asserts value is object;
 declare function string(value: unknown, message?: string | Error): asserts value is string;
 declare function boolean(value: unknown, message?: string | Error): asserts value is boolean;
 declare function notEmptyString(value: unknown, message?: string | Error): asserts value is string;
 declare function number(value: unknown, message?: string | Error): asserts value is number;
+declare function date(value: unknown, message?: string | Error): asserts value is Date;
+declare function fn(value: unknown, message?: string | Error): asserts value is Function;
+declare function greaterThan(value: unknown, target: number, message?: string | Error): asserts value is number;
+declare function lessThan(value: unknown, target: number, message?: string | Error): asserts value is number;
 /**
  * @param {unknown} value
  * @param {string | Error} [message]
@@ -336,14 +373,19 @@ declare const assert_array: typeof array;
 declare const assert_arrayNumbers: typeof arrayNumbers;
 declare const assert_arrayStrings: typeof arrayStrings;
 declare const assert_boolean: typeof boolean;
+declare const assert_date: typeof date;
+declare const assert_empty: typeof empty;
 declare const assert_equal: typeof equal;
+declare const assert_fn: typeof fn;
+declare const assert_greaterThan: typeof greaterThan;
+declare const assert_lessThan: typeof lessThan;
 declare const assert_notEmptyString: typeof notEmptyString;
 declare const assert_number: typeof number;
 declare const assert_object: typeof object;
 declare const assert_ok: typeof ok;
 declare const assert_string: typeof string;
 declare namespace assert {
-  export { assert_array as array, assert_arrayNumbers as arrayNumbers, assert_arrayStrings as arrayStrings, assert_boolean as boolean, assert_equal as equal, assert_notEmptyString as notEmptyString, assert_number as number, assert_object as object, assert_ok as ok, assert_string as string };
+  export { assert_array as array, assert_arrayNumbers as arrayNumbers, assert_arrayStrings as arrayStrings, assert_boolean as boolean, assert_date as date, assert_empty as empty, assert_equal as equal, assert_fn as fn, assert_greaterThan as greaterThan, assert_lessThan as lessThan, assert_notEmptyString as notEmptyString, assert_number as number, assert_object as object, assert_ok as ok, assert_string as string };
 }
 
 type Base64ToBytesOptions = {
@@ -695,9 +737,17 @@ type FunctionArgs<Args extends any[] = any[], Return = void> = (
   ...args: Args
 ) => Return;
 
-type DeepPartial<T> = T extends object
-  ? { [P in keyof T]?: DeepPartial<T[P]> }
-  : T;
+type DeepPartial<T> = T extends Date
+  ? T
+  : T extends object
+    ? { [P in keyof T]?: DeepPartial<T[P]> }
+    : T;
+
+type DeepReadonly<T> = T extends unknown[]
+  ? Readonly<T>
+  : T extends object
+    ? Readonly<{ [P in keyof T]: DeepReadonly<T[P]> }>
+    : Readonly<T>;
 
 type AnyFunction = (...args: any[]) => any;
 
@@ -2531,7 +2581,12 @@ declare function isSuccess<T extends ExecResult>(value: T): value is ExecResultT
 declare function isSkip<T extends ExecResult>(value: T): value is ExecResultToSkip<T>;
 
 /**
- * Extracts file extension from filename or url link
+ * Extract file extension from string
+ *
+ * @example
+ * getFileExtension('Andrew L - CV.pdf'); // 'pdf'
+ *
+ * @group Files
  */
 declare function getFileExtension(name: string, withDot?: boolean): string | null;
 
@@ -2545,6 +2600,28 @@ declare function getFileExtension(name: string, withDot?: boolean): string | nul
  */
 declare function getFileName(value: string): string | null;
 
+/**
+ * Filters an array of paths to retain only the most specific (deepest) paths,
+ * removing any path that is a prefix of another path.
+ *
+ * @param {string[]} keys - An array of dot-separated string paths.
+ * @returns {string[]} - A new array containing only the most specific paths.
+ *
+ * @example
+ * const inputPaths = [
+ *   'profile',
+ *   'profile.basic',
+ *   'profile.basic.fullName',
+ *   'profile.updatedAt'
+ * ];
+ *
+ * const result = getMostSpecificPaths(inputPaths);
+ * console.log(result); // ['profile.basic.fullName', 'profile.updatedAt']
+ *
+ * @group Files
+ */
+declare function getMostSpecificPaths(keys: string[]): string[];
+
 /**
  * Converts bytes amount into human readably string
  *
@@ -3520,6 +3597,7 @@ interface FlattenOptions {
  * // { 'root-user-name': 'Jane', 'root-user-profile-age': 30 }
  *
  * @group Object
+ * @author lukeed
  */
 declare function flatten(obj: Record<string, unknown>, { separator, initialPrefix, withArrays, isObjectCompare, }?: FlattenOptions): Record<string, unknown>;
 
@@ -3738,8 +3816,9 @@ declare const toMap: <T extends object>(obj: T) => Map<keyof T, T[keyof T]>;
  * // }
  *
  * @group Object
+ * @author lukeed
  */
-declare function unflatten(obj: object, separator?: string): {};
+declare function unflatten(input: object, separator?: string): any;
 
 /**
  * Same as `set` but unset by dot notation
@@ -4910,4 +4989,4 @@ declare function wrapText(value: string, maxLength?: number): string;
  */
 declare function toError<T>(value: T, unknownMessage?: string): T extends Error ? T : Error;
 
-export { type AnyFunction, AppError, type ArgumentsType, type Arrayable, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, BrowserAssertionError, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DeepPartial, type Defer, instance as EJSON, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, type Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, type RetryOnErrorConfig, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, _default as TWEMOJI_REGEX, type ThemeConfig, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getRandomInt, getRandomTime, getWords, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };
+export { type AnyFunction, AppError, type ArgumentsType, type Arrayable, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, BrowserAssertionError, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DeepPartial, type DeepReadonly, type Defer, instance as EJSON, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, type Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, type RetryOnErrorConfig, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, _default as TWEMOJI_REGEX, type ThemeConfig, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, type WrrItem, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };

package/dist/index.d.ts

@@ -114,23 +114,6 @@ declare function chunkSeries(list: number[], step?: number): number[][];
  */
 declare function difference<T>(...arrays: readonly T[][]): T[];
 
-/**
- * Returns the intersection of arrays.
- *
- * This function takes arrays and returns a new array containing the elements that are
- * present in all arrays.
- *
- * @template T - The type of elements in the array.
- * @returns {T[]} A new array containing the elements that are present in both arrays.
- *
- * @example
- * const array1 = [1, 2, 3, 4, 5];
- * const array2 = [3, 4, 5, 6, 7];
- * const result = intersection(array1, array2);
- * // result will be [3, 4, 5] since these elements are in both arrays.
- */
-declare function intersection<T>(...arrays: readonly T[][]): T[];
-
 type MaybePropertyKey<T> = T extends object
   ? keyof T | PropertyKey
   : PropertyKey;
@@ -149,6 +132,28 @@ type IsPropertyKey<T, V, L> = T extends object
     : L
   : PropertyKeyLiteralToType<L>;
 
+declare function groupBy<T, K extends MaybePropertyKey<T>>(array: readonly T[], keyBy: K, objectMode?: false): Map<IsPropertyKey<T, K, K>, T[]>;
+declare function groupBy<T, K>(array: readonly T[], keyBy: (item: T) => K, objectMode?: false): Map<K, T[]>;
+declare function groupBy<T, K extends MaybePropertyKey<T>>(array: readonly T[], keyBy: K, objectMode: true): Record<K, T[]>;
+declare function groupBy<T, K extends PropertyKey>(array: readonly T[], keyBy: (item: T) => K, objectMode: true): Record<K, T[]>;
+
+/**
+ * Returns the intersection of arrays.
+ *
+ * This function takes arrays and returns a new array containing the elements that are
+ * present in all arrays.
+ *
+ * @template T - The type of elements in the array.
+ * @returns {T[]} A new array containing the elements that are present in both arrays.
+ *
+ * @example
+ * const array1 = [1, 2, 3, 4, 5];
+ * const array2 = [3, 4, 5, 6, 7];
+ * const result = intersection(array1, array2);
+ * // result will be [3, 4, 5] since these elements are in both arrays.
+ */
+declare function intersection<T>(...arrays: readonly T[][]): T[];
+
 /**
  * Maps each element of an array based on a provided key.
  *
@@ -316,13 +321,45 @@ declare function uniq<T extends any[]>(value: T): T;
  */
 declare function uniqBy<T>(array: T[], comparator: ((value: T) => any) | PropertyKey): T[];
 
+type WrrItem<T> = {
+    item: T;
+    weight?: number;
+};
+/**
+ * Creates a function that returns a weighted round-robin item from the provided array.
+ *
+ * The input array should contain objects with an `item` property and a `weight` property.
+ * The `weight` determines the relative likelihood of selecting an item.
+ * Items with higher weights will appear more frequently in the selection.
+ *
+ * If the `weight` property is missing or falsy, it defaults to `1`.
+ * An empty array will result in a function that always returns `undefined`.
+ *
+ * @example
+ * const getItem = weightedRoundRobin([
+ *   { item: 'a', weight: 2 },
+ *   { item: 'b', weight: 3 },
+ *   { item: 'c' },
+ * ]);
+ *
+ * console.log(getItem()); // 'a', 'b', or 'c'
+ *
+ * @group Array
+ */
+declare function weightedRoundRobin<T = unknown>(arr: WrrItem<T>[]): () => T;
+
 declare function ok(value: unknown, message?: string | Error): asserts value;
 declare function equal<T>(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
+declare function empty(value: unknown, message?: string | Error): asserts value;
 declare function object(value: unknown, message?: string | Error): asserts value is object;
 declare function string(value: unknown, message?: string | Error): asserts value is string;
 declare function boolean(value: unknown, message?: string | Error): asserts value is boolean;
 declare function notEmptyString(value: unknown, message?: string | Error): asserts value is string;
 declare function number(value: unknown, message?: string | Error): asserts value is number;
+declare function date(value: unknown, message?: string | Error): asserts value is Date;
+declare function fn(value: unknown, message?: string | Error): asserts value is Function;
+declare function greaterThan(value: unknown, target: number, message?: string | Error): asserts value is number;
+declare function lessThan(value: unknown, target: number, message?: string | Error): asserts value is number;
 /**
  * @param {unknown} value
  * @param {string | Error} [message]
@@ -336,14 +373,19 @@ declare const assert_array: typeof array;
 declare const assert_arrayNumbers: typeof arrayNumbers;
 declare const assert_arrayStrings: typeof arrayStrings;
 declare const assert_boolean: typeof boolean;
+declare const assert_date: typeof date;
+declare const assert_empty: typeof empty;
 declare const assert_equal: typeof equal;
+declare const assert_fn: typeof fn;
+declare const assert_greaterThan: typeof greaterThan;
+declare const assert_lessThan: typeof lessThan;
 declare const assert_notEmptyString: typeof notEmptyString;
 declare const assert_number: typeof number;
 declare const assert_object: typeof object;
 declare const assert_ok: typeof ok;
 declare const assert_string: typeof string;
 declare namespace assert {
-  export { assert_array as array, assert_arrayNumbers as arrayNumbers, assert_arrayStrings as arrayStrings, assert_boolean as boolean, assert_equal as equal, assert_notEmptyString as notEmptyString, assert_number as number, assert_object as object, assert_ok as ok, assert_string as string };
+  export { assert_array as array, assert_arrayNumbers as arrayNumbers, assert_arrayStrings as arrayStrings, assert_boolean as boolean, assert_date as date, assert_empty as empty, assert_equal as equal, assert_fn as fn, assert_greaterThan as greaterThan, assert_lessThan as lessThan, assert_notEmptyString as notEmptyString, assert_number as number, assert_object as object, assert_ok as ok, assert_string as string };
 }
 
 type Base64ToBytesOptions = {
@@ -695,9 +737,17 @@ type FunctionArgs<Args extends any[] = any[], Return = void> = (
   ...args: Args
 ) => Return;
 
-type DeepPartial<T> = T extends object
-  ? { [P in keyof T]?: DeepPartial<T[P]> }
-  : T;
+type DeepPartial<T> = T extends Date
+  ? T
+  : T extends object
+    ? { [P in keyof T]?: DeepPartial<T[P]> }
+    : T;
+
+type DeepReadonly<T> = T extends unknown[]
+  ? Readonly<T>
+  : T extends object
+    ? Readonly<{ [P in keyof T]: DeepReadonly<T[P]> }>
+    : Readonly<T>;
 
 type AnyFunction = (...args: any[]) => any;
 
@@ -2531,7 +2581,12 @@ declare function isSuccess<T extends ExecResult>(value: T): value is ExecResultT
 declare function isSkip<T extends ExecResult>(value: T): value is ExecResultToSkip<T>;
 
 /**
- * Extracts file extension from filename or url link
+ * Extract file extension from string
+ *
+ * @example
+ * getFileExtension('Andrew L - CV.pdf'); // 'pdf'
+ *
+ * @group Files
  */
 declare function getFileExtension(name: string, withDot?: boolean): string | null;
 
@@ -2545,6 +2600,28 @@ declare function getFileExtension(name: string, withDot?: boolean): string | nul
  */
 declare function getFileName(value: string): string | null;
 
+/**
+ * Filters an array of paths to retain only the most specific (deepest) paths,
+ * removing any path that is a prefix of another path.
+ *
+ * @param {string[]} keys - An array of dot-separated string paths.
+ * @returns {string[]} - A new array containing only the most specific paths.
+ *
+ * @example
+ * const inputPaths = [
+ *   'profile',
+ *   'profile.basic',
+ *   'profile.basic.fullName',
+ *   'profile.updatedAt'
+ * ];
+ *
+ * const result = getMostSpecificPaths(inputPaths);
+ * console.log(result); // ['profile.basic.fullName', 'profile.updatedAt']
+ *
+ * @group Files
+ */
+declare function getMostSpecificPaths(keys: string[]): string[];
+
 /**
  * Converts bytes amount into human readably string
  *
@@ -3520,6 +3597,7 @@ interface FlattenOptions {
  * // { 'root-user-name': 'Jane', 'root-user-profile-age': 30 }
  *
  * @group Object
+ * @author lukeed
  */
 declare function flatten(obj: Record<string, unknown>, { separator, initialPrefix, withArrays, isObjectCompare, }?: FlattenOptions): Record<string, unknown>;
 
@@ -3738,8 +3816,9 @@ declare const toMap: <T extends object>(obj: T) => Map<keyof T, T[keyof T]>;
  * // }
  *
  * @group Object
+ * @author lukeed
  */
-declare function unflatten(obj: object, separator?: string): {};
+declare function unflatten(input: object, separator?: string): any;
 
 /**
  * Same as `set` but unset by dot notation
@@ -4910,4 +4989,4 @@ declare function wrapText(value: string, maxLength?: number): string;
  */
 declare function toError<T>(value: T, unknownMessage?: string): T extends Error ? T : Error;
 
-export { type AnyFunction, AppError, type ArgumentsType, type Arrayable, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, BrowserAssertionError, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DeepPartial, type Defer, instance as EJSON, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, type Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, type RetryOnErrorConfig, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, _default as TWEMOJI_REGEX, type ThemeConfig, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getRandomInt, getRandomTime, getWords, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };
+export { type AnyFunction, AppError, type ArgumentsType, type Arrayable, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, BrowserAssertionError, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DeepPartial, type DeepReadonly, type Defer, instance as EJSON, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, type Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, type RetryOnErrorConfig, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, _default as TWEMOJI_REGEX, type ThemeConfig, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, type WrrItem, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };