@andrew_l/toolkit 0.2.4 → 0.2.7

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
  *
@@ -2715,6 +2792,12 @@ declare function isPromise<T = void>(value: any): value is Promise<T>;
  */
 declare const isPrimitive: (value: unknown) => value is Primitive;
 
+type LogLevel = Exclude<keyof Logger, 'extend'>;
+/**
+ * Set global log level.
+ * @group Utility Functions
+ */
+declare const loggerSetLevel: (level: LogLevel) => void;
 /**
  * Create pretty simple `console.log` wrapper interface.
  *
@@ -3520,6 +3603,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 +3822,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 +4995,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, loggerSetLevel, 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.mjs

@@ -1,9 +1,9 @@
-import _get from 'lodash/get';
-import _cloneDeep from 'lodash/cloneDeep';
-import _cloneDeepWith from 'lodash/cloneDeepWith';
-import _defaultsDeep from 'lodash/defaultsDeep';
-import _set from 'lodash/set';
-import _unset from 'lodash/unset';
+import _get from 'lodash/get.js';
+import _cloneDeep from 'lodash/cloneDeep.js';
+import _cloneDeepWith from 'lodash/cloneDeepWith.js';
+import _defaultsDeep from 'lodash/defaultsDeep.js';
+import _set from 'lodash/set.js';
+import _unset from 'lodash/unset.js';
 
 const isClient = typeof globalThis?.window !== "undefined";
 const isDef = (val) => typeof val !== "undefined";
@@ -237,6 +237,30 @@ function difference(...arrays) {
   return Array.from(set);
 }
 
+function groupBy(array, keyBy, objectMode) {
+  const getItemKey = isFunction(keyBy) ? keyBy : (item) => item?.[keyBy];
+  let key;
+  if (objectMode === true) {
+    const result2 = {};
+    for (const item of array) {
+      key = getItemKey(item);
+      result2[key] = result2[key] || [];
+      result2[key].push(item);
+    }
+    return result2;
+  }
+  const result = /* @__PURE__ */ new Map();
+  for (const item of array) {
+    key = getItemKey(item);
+    if (!result.has(key)) {
+      result.set(key, [item]);
+    } else {
+      result.get(key).push(item);
+    }
+  }
+  return result;
+}
+
 function intersection(...arrays) {
   if (arrays.length === 0) return [];
   if (arrays.length === 1) return arrays[0];
@@ -347,6 +371,7 @@ let AssertionError;
     (r) => r.BrowserAssertionError
   ) : await import('node:assert').then((r) => r.AssertionError);
 })();
+
 function ok(value, message) {
   if (!value) {
     throw toError$1(
@@ -368,6 +393,11 @@ function equal(actual, expected, message) {
     });
   }
 }
+function empty$1(value, message) {
+  if (isEmpty(value)) {
+    throw toError$1(empty$1, value, message, "Expected not empty value.");
+  }
+}
 function object(value, message) {
   if (!isObject(value)) {
     throw toError$1(object, value, message, "Expected object value.");
@@ -398,6 +428,36 @@ function number$1(value, message) {
     throw toError$1(number$1, value, message, "Expected number value.");
   }
 }
+function date(value, message) {
+  if (!isDate(value)) {
+    throw toError$1(date, value, message, "Expected date value.");
+  }
+}
+function fn(value, message) {
+  if (!isNumber(value)) {
+    throw toError$1(fn, value, message, "Expected function value.");
+  }
+}
+function greaterThan(value, target, message) {
+  if (!isNumber(value) || value < target) {
+    throw toError$1(
+      greaterThan,
+      value,
+      message,
+      "Expected number value greater then " + target + "."
+    );
+  }
+}
+function lessThan(value, target, message) {
+  if (!isNumber(value) || value > target) {
+    throw toError$1(
+      lessThan,
+      value,
+      message,
+      "Expected number value less then " + target + "."
+    );
+  }
+}
 function array(value, message) {
   if (!Array.isArray(value)) {
     throw toError$1(array, value, message, "Expected array value.");
@@ -431,7 +491,12 @@ const assert = {
   arrayNumbers: arrayNumbers,
   arrayStrings: arrayStrings,
   boolean: boolean,
+  date: date,
+  empty: empty$1,
   equal: equal,
+  fn: fn,
+  greaterThan: greaterThan,
+  lessThan: lessThan,
   notEmptyString: notEmptyString,
   number: number$1,
   object: object,
@@ -439,6 +504,53 @@ const assert = {
   string: string
 };
 
+function weightedRoundRobin(arr) {
+  ok(arr.length > 0, "Array must contain at least one item.");
+  const instance = new WeightedRoundRobin(
+    arr.map((v) => ({
+      item: v.item,
+      weight: Math.min(v.weight ?? 1, 1)
+    }))
+  );
+  return () => instance.nextItem();
+}
+const gcd = (a, b) => !b ? a : gcd(b, a % b);
+class WeightedRoundRobin {
+  constructor(items) {
+    this.items = items;
+    this.maxWeight = this._calculateMaxWeight();
+    this.gcdWeight = this._calculateGCD();
+  }
+  currentIndex = -1;
+  currentWeight = 0;
+  maxWeight;
+  gcdWeight;
+  _calculateGCD() {
+    return this.items.reduce(
+      (acc, curr) => gcd(acc, curr.weight),
+      this.items[0].weight
+    );
+  }
+  _calculateMaxWeight() {
+    return Math.max(...this.items.map((s) => s.weight));
+  }
+  nextItem() {
+    const n = this.items.length;
+    while (true) {
+      this.currentIndex = (this.currentIndex + 1) % n;
+      if (this.currentIndex === 0) {
+        this.currentWeight -= this.gcdWeight;
+        if (this.currentWeight <= 0) {
+          this.currentWeight = this.maxWeight;
+        }
+      }
+      if (this.items[this.currentIndex].weight >= this.currentWeight) {
+        return this.items[this.currentIndex].item;
+      }
+    }
+  }
+}
+
 class Base64Encoding {
   alphabet;
   padding;
@@ -647,13 +759,12 @@ const def = (obj, key, value, writable = false) => {
 const rndCharacters = "abcdefghijklmnopqrstuvwxyz0123456789";
 const charactersLength = rndCharacters.length;
 function randomString(length) {
-  let result = "";
-  for (let i = 0; i < length; i++) {
-    result += rndCharacters.charAt(
-      Math.floor(Math.random() * charactersLength)
-    );
+  let str = "";
+  let num = isNumber(length) ? Math.max(0, length) : 0;
+  while (num--) {
+    str += rndCharacters[charactersLength * Math.random() | 0];
   }
-  return result;
+  return str;
 }
 
 const objectKeys = /* @__PURE__ */ new WeakMap();
@@ -1446,27 +1557,57 @@ function flatten(obj, {
   isObjectCompare = isObject
 } = {}) {
   const result = {};
-  const processed = /* @__PURE__ */ new WeakSet();
-  const handle = (node, prefix, initial) => {
-    if (processed.has(node)) return;
-    if (isObjectCompare(node)) {
-      processed.add(node);
-      prefix = prefix && !initial ? `${prefix}${separator}` : prefix;
-      for (const [key, value] of Object.entries(node)) {
-        handle(value, `${prefix}${key}`);
-      }
+  const seen = /* @__PURE__ */ new WeakSet();
+  if (isObjectCompare(obj)) {
+    iter(
+      result,
+      seen,
+      isObjectCompare,
+      separator,
+      withArrays,
+      obj,
+      initialPrefix,
+      true
+    );
+  }
+  return result;
+}
+function iter(output, seen, isObjectCompare, separator, withArrays, val, key, initial) {
+  if (seen.has(val)) return;
+  let k, pfx = key && !initial ? key + separator : key;
+  if (Array.isArray(val)) {
+    seen.add(val);
+    if (!withArrays) {
+      output[key] = val;
       return;
     }
-    if (Array.isArray(node) && withArrays) {
-      processed.add(node);
-      prefix = prefix && !initial ? `${prefix}${separator}` : prefix;
-      node.forEach((value, idx) => handle(value, `${prefix}${idx}`));
-      return;
+    for (k = 0; k < val.length; k++) {
+      iter(
+        output,
+        seen,
+        isObjectCompare,
+        separator,
+        withArrays,
+        val[k],
+        pfx + k
+      );
     }
-    result[prefix] = node;
-  };
-  handle(obj, initialPrefix, true);
-  return result;
+  } else if (isObjectCompare(val)) {
+    seen.add(val);
+    for (k in val) {
+      iter(
+        output,
+        seen,
+        isObjectCompare,
+        separator,
+        withArrays,
+        val[k],
+        pfx + k
+      );
+    }
+  } else {
+    output[key] = val;
+  }
 }
 
 function has(value, keys) {
@@ -1547,12 +1688,40 @@ const toMap = (obj) => {
   return map;
 };
 
-function unflatten(obj, separator = "_") {
-  const result = {};
-  Object.keys(obj).forEach((path) => {
-    set(result, path.split(separator), obj[path]);
-  });
-  return result;
+const badKeys = Object.freeze(
+  /* @__PURE__ */ new Set(["constructor", "__proto__", "prototype"])
+);
+function unflatten(input, separator = "_") {
+  if (!isObject(input)) {
+    return {};
+  }
+  let arr, tmp, output;
+  let i = 0, k, key;
+  for (k in input) {
+    tmp = output;
+    arr = k.split(separator);
+    for (i = 0; i < arr.length; ) {
+      key = arr[i++];
+      if (tmp == null) {
+        tmp = empty(+key);
+        output = output || tmp;
+      }
+      if (badKeys.has(key)) break;
+      if (i < arr.length) {
+        if (key in tmp) {
+          tmp = tmp[key];
+        } else {
+          tmp = tmp[key] = empty(+arr[i]);
+        }
+      } else {
+        tmp[key] = input[k];
+      }
+    }
+  }
+  return output;
+}
+function empty(key) {
+  return key === key ? [] : {};
 }
 
 const unset = _unset;
@@ -3177,7 +3346,7 @@ function getFileExtension(name, withDot = true) {
     return null;
   }
   const ext = name.split(".").at(-1)?.split("?")?.at(0);
-  return ext ? withDot ? ext : `.${ext}` : null;
+  return ext ? withDot ? `.${ext}` : ext : null;
 }
 
 const DEF_PROTOCOLS = ["http://", "https://"];
@@ -3195,7 +3364,21 @@ function getFileName(value) {
   if (!ext) {
     return value;
   }
-  return value.slice(0, -ext.length - 1);
+  return value.slice(0, -ext.length);
+}
+
+function getMostSpecificPaths(keys) {
+  keys = [...keys].sort();
+  const result = [];
+  for (let i = 0; i < keys.length; i++) {
+    const currentPath = keys[i];
+    const nextPath = keys[i + 1];
+    if (currentPath === nextPath) continue;
+    if (!nextPath || !nextPath.startsWith(currentPath + ".")) {
+      result.push(currentPath);
+    }
+  }
+  return result;
 }
 
 function humanFileSize(bytes, digits = 1, withSpace = true) {
@@ -3297,19 +3480,37 @@ function tryStringify(o) {
   }
 }
 
-const IS_DEV = env.isDevelopment || env.bool("DEV", false);
+const LEVEL_NUM = {
+  debug: 0,
+  log: 1,
+  info: 2,
+  warn: 3,
+  error: 4
+};
+let currentLogLevel = LEVEL_NUM.log;
+const loggerSetLevel = (level) => {
+  number$1(LEVEL_NUM[level], `Invalid log level: ${level}`);
+  currentLogLevel = LEVEL_NUM[level];
+};
 const logger = (...baseArgs) => {
+  if (isString(baseArgs[0]?.url)) {
+    baseArgs[0] = baseArgs[0]?.url;
+  }
   if (typeof baseArgs[0] === "string" && baseArgs[0][0] !== "[") {
     baseArgs[0] = `[${baseArgs[0].split("/").at(-1).split("?", 1)[0]}]`;
   }
   const writeLog = (level, ...[pattern, ...args]) => {
+    const levelNum = LEVEL_NUM[level];
+    if (levelNum < currentLogLevel) {
+      return;
+    }
     if (!isString(pattern)) {
       console[level](...baseArgs, pattern, ...args);
       return;
     }
     const unusedArgs = [];
     const formatted = sprintf(pattern, args, unusedArgs);
-    console[level](...baseArgs, ...formatted, ...unusedArgs);
+    console[level](...baseArgs, formatted, ...unusedArgs);
   };
   const log = writeLog.bind(null, "log");
   const info = writeLog.bind(null, "info");
@@ -3327,9 +3528,6 @@ const logger = (...baseArgs) => {
     debug,
     extend
   };
-  Object.defineProperty(instance, "debug", {
-    get: () => IS_DEV ? debug : noop
-  });
   return instance;
 };
 
@@ -4220,5 +4418,5 @@ function wrapText(value, maxLength = 30) {
   return value;
 }
 
-export { AppError, AsyncIterableQueue, BrowserAssertionError, CancellablePromise, ColorParser, instance as EJSON, EJSONStream, FindMean, FixedMap, FixedWeakMap, LruCache, Queue, SimpleEventEmitter, TWEMOJI_REGEX, TimeBucket, TimeSpan, 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 { AppError, AsyncIterableQueue, BrowserAssertionError, CancellablePromise, ColorParser, instance as EJSON, EJSONStream, FindMean, FixedMap, FixedWeakMap, LruCache, Queue, SimpleEventEmitter, TWEMOJI_REGEX, TimeBucket, TimeSpan, 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, loggerSetLevel, 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 };
 //# sourceMappingURL=index.mjs.map