es-toolkit 1.10.1-dev.250 → 1.10.1-dev.252

package/dist/compat/index.mjs

@@ -1,30 +1,31 @@
 import "../chunk-NKLIE2OI.mjs";
-import "../chunk-ARZ5BDR6.mjs";
-import "../chunk-YCTGSM4S.mjs";
+import "../chunk-4OIZM4HS.mjs";
+import {
+  withTimeout
+} from "../chunk-XWPCDIFC.mjs";
+import "../chunk-J3GE7DEU.mjs";
+import {
+  delay
+} from "../chunk-O64NE2P4.mjs";
+import "../chunk-XT74R35S.mjs";
+import {
+  lowerCase
+} from "../chunk-5IKVJGHO.mjs";
+import {
+  snakeCase
+} from "../chunk-F3WCQQET.mjs";
 import {
   startCase
 } from "../chunk-QXTNZR7B.mjs";
-import {
-  startsWith
-} from "../chunk-SR5RPVRM.mjs";
 import {
   camelCase
 } from "../chunk-Y5V7UAZZ.mjs";
 import {
   capitalize
 } from "../chunk-U56ZOM7L.mjs";
-import {
-  endsWith
-} from "../chunk-ZFRI6VS4.mjs";
 import {
   kebabCase
 } from "../chunk-EYYZQFOP.mjs";
-import {
-  lowerCase
-} from "../chunk-5IKVJGHO.mjs";
-import {
-  snakeCase
-} from "../chunk-F3WCQQET.mjs";
 import "../chunk-WVQ7YVRK.mjs";
 import "../chunk-ASJF5D6C.mjs";
 import {
@@ -42,10 +43,10 @@ import {
 import {
   isUndefined
 } from "../chunk-VH2PV426.mjs";
-import {
-  delay
-} from "../chunk-O64NE2P4.mjs";
 import "../chunk-54TK5BIS.mjs";
+import {
+  pick
+} from "../chunk-HPFDYUGP.mjs";
 import {
   pickBy
 } from "../chunk-6CLH5YZ2.mjs";
@@ -60,39 +61,39 @@ import {
 } from "../chunk-OLX53VEF.mjs";
 import {
   omit
-} from "../chunk-QZITBKWX.mjs";
+} from "../chunk-U7V3G7CR.mjs";
 import {
   omitBy
 } from "../chunk-BCTYOXT7.mjs";
-import {
-  pick
-} from "../chunk-HPFDYUGP.mjs";
 import "../chunk-FUS75PJ7.mjs";
 import {
   sumBy
 } from "../chunk-5L4VWRFX.mjs";
+import {
+  inRange
+} from "../chunk-BH6HLGBA.mjs";
 import {
   meanBy
 } from "../chunk-MY4G7R3I.mjs";
 import {
   mean
 } from "../chunk-5ASRKEB4.mjs";
+import {
+  sum
+} from "../chunk-2SLTL4KL.mjs";
 import {
   range
 } from "../chunk-DPH2KE6O.mjs";
 import {
   round
 } from "../chunk-5PMKOZ2F.mjs";
-import {
-  sum
-} from "../chunk-2SLTL4KL.mjs";
 import {
   clamp
 } from "../chunk-MLCL773E.mjs";
-import {
-  inRange
-} from "../chunk-BH6HLGBA.mjs";
 import "../chunk-DDH7K4QM.mjs";
+import {
+  without
+} from "../chunk-PYEYV7BY.mjs";
 import {
   xor
 } from "../chunk-L7FQX5MN.mjs";
@@ -111,12 +112,18 @@ import {
 import {
   zipWith
 } from "../chunk-4KYXHZ4R.mjs";
+import {
+  union
+} from "../chunk-R6QA7PLZ.mjs";
 import {
   unionBy
 } from "../chunk-NFS7RWWE.mjs";
 import {
   unionWith
 } from "../chunk-2ZCITDMK.mjs";
+import {
+  uniq
+} from "../chunk-DVK2N4KC.mjs";
 import {
   uniqBy
 } from "../chunk-B4COTK4K.mjs";
@@ -130,8 +137,14 @@ import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
 import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
+import {
+  randomInt
+} from "../chunk-GIWAOOFY.mjs";
+import {
+  random
+} from "../chunk-SYWMYQYJ.mjs";
 import {
   shuffle
 } from "../chunk-G7UQ5PUR.mjs";
@@ -154,11 +167,8 @@ import {
   toFilled
 } from "../chunk-OP4OAKQJ.mjs";
 import {
-  union
-} from "../chunk-R6QA7PLZ.mjs";
-import {
-  uniq
-} from "../chunk-DVK2N4KC.mjs";
+  intersectionWith
+} from "../chunk-XI7KRD2C.mjs";
 import {
   keyBy
 } from "../chunk-AJKZMN2V.mjs";
@@ -181,14 +191,8 @@ import {
   sample
 } from "../chunk-2KNLZB7V.mjs";
 import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
-import {
-  randomInt
-} from "../chunk-GIWAOOFY.mjs";
-import {
-  random
-} from "../chunk-SYWMYQYJ.mjs";
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -208,8 +212,8 @@ import {
   intersectionBy
 } from "../chunk-O6UXZR3U.mjs";
 import {
-  intersectionWith
-} from "../chunk-XI7KRD2C.mjs";
+  differenceWith
+} from "../chunk-6NVQAHXP.mjs";
 import {
   drop
 } from "../chunk-S3CORED5.mjs";
@@ -228,9 +232,6 @@ import {
 import {
   flatMap
 } from "../chunk-UY76KTPE.mjs";
-import {
-  flattenDeep
-} from "../chunk-ML727RRJ.mjs";
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
@@ -249,14 +250,17 @@ import {
 import {
   differenceBy
 } from "../chunk-LVWX5B43.mjs";
-import {
-  differenceWith
-} from "../chunk-6NVQAHXP.mjs";
-import "../chunk-FZEZH22H.mjs";
+import "../chunk-F47GLYUU.mjs";
 import {
   AbortError
 } from "../chunk-DXB7EZUQ.mjs";
+import {
+  TimeoutError
+} from "../chunk-KIOYQRMQ.mjs";
 import "../chunk-236H5JZJ.mjs";
+import {
+  noop
+} from "../chunk-LKXCOLNY.mjs";
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
@@ -269,10 +273,7 @@ import {
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 
 // src/compat/array/chunk.ts
 function chunk2(arr, size = 1) {
@@ -353,8 +354,19 @@ function zipObjectDeep(keys, values) {
   }
   return result;
 }
+
+// src/compat/string/startsWith.ts
+var startsWith = (str, target, position = 0) => {
+  return str.startsWith(target, position);
+};
+
+// src/compat/string/endsWith.ts
+var endsWith = (str, target, position = str.length) => {
+  return str.endsWith(target, position);
+};
 export {
   AbortError,
+  TimeoutError,
   camelCase,
   capitalize,
   chunk2 as chunk,
@@ -436,6 +448,7 @@ export {
   uniqWith,
   unzip,
   unzipWith,
+  withTimeout,
   without,
   xor,
   xorBy,

package/dist/compat/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/compat/array/chunk.ts","../../src/compat/_internal/isIndex.ts","../../src/compat/_internal/toPath.ts","../../src/compat/object/set.ts","../../src/compat/array/zipObjectDeep.ts"],"sourcesContent":["import { chunk as chunkToolkit } from '../../array/chunk.ts';\n\n/**\n * Splits an array into smaller arrays of a specified length.\n *\n * This function takes an input array and divides it into multiple smaller arrays,\n * each of a specified length. If the input array cannot be evenly divided,\n * the final sub-array will contain the remaining elements.\n *\n * @template T The type of elements in the array.\n * @param {T[]} arr - The array to be chunked into smaller arrays.\n * @param {number} size - The size of each smaller array. Must be a positive integer.\n * @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.\n * @throws {Error} Throws an error if `size` is not a positive integer.\n *\n * @example\n * // Splits an array of numbers into sub-arrays of length 2\n * chunk([1, 2, 3, 4, 5], 2);\n * // Returns: [[1, 2], [3, 4], [5]]\n *\n * @example\n * // Splits an array of strings into sub-arrays of length 3\n * chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3);\n * // Returns: [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]\n */\nexport function chunk<T>(arr: readonly T[], size: number = 1): T[][] {\n  size = Math.max(Math.floor(size), 0);\n\n  if (size === 0) {\n    return [];\n  }\n\n  return chunkToolkit(arr, size);\n}\n","const IS_UNSIGNED_INTEGER = /^(?:0|[1-9]\\d*)$/\n\nexport function isIndex(value: PropertyKey) {\n  switch (typeof value) {\n    case 'number': {\n      return Number.isInteger(value) && value >= 0 && value < Number.MAX_SAFE_INTEGER;\n    }\n    case 'symbol': {\n      return false;\n    }\n    case 'string': {\n      return IS_UNSIGNED_INTEGER.test(value);\n    }\n  }\n}","const ESCAPE_REGEXP = /\\\\(\\\\)?/g;\nconst PROPERTY_REGEXP = RegExp(\n  // Match anything that isn't a dot or bracket.\n  \"[^.[\\\\]]+\" +\n    \"|\" +\n    // Or match property names within brackets.\n    \"\\\\[(?:\" +\n    // Match a non-string expression.\n    \"([^\\\"'][^[]*)\" +\n    \"|\" +\n    // Or match strings (supports escaping characters).\n    \"([\\\"'])((?:(?!\\\\2)[^\\\\\\\\]|\\\\\\\\.)*?)\\\\2\" +\n    \")\\\\]\" +\n    \"|\" +\n    // Or match \"\" as the space between consecutive dots or empty brackets.\n    \"(?=(?:\\\\.|\\\\[\\\\])(?:\\\\.|\\\\[\\\\]|$))\",\n  \"g\",\n);\n\n/**\n * Converts a deep key string into an array of path segments.\n *\n * This function takes a string representing a deep key (e.g., 'a.b.c' or 'a[b][c]') and breaks it down into an array of strings, each representing a segment of the path.\n *\n * @param deepKey - The deep key string to convert.\n * @returns An array of strings, each representing a segment of the path.\n *\n * Examples:\n *\n * toPath('a.b.c') // Returns ['a', 'b', 'c']\n * toPath('a[b][c]') // Returns ['a', 'b', 'c']\n * toPath('.a.b.c') // Returns ['', 'a', 'b', 'c']\n * toPath('a[\"b.c\"].d') // Returns ['a', 'b.c', 'd']\n * toPath('') // Returns []\n * toPath('.a[b].c.d[e][\"f.g\"].h') // Returns ['', 'a', 'b', 'c', 'd', 'e', 'f.g', 'h']\n */\nexport function toPath(deepKey: string): string[] {\n  const result: string[] = [];\n\n  if (deepKey[0] === \".\") {\n    result.push(\"\");\n  }\n\n  let match: RegExpExecArray | null;\n\n  while ((match = PROPERTY_REGEXP.exec(deepKey)) !== null) {\n    let [key, expr, quote, substr] = match;\n\n    if (quote) {\n      key = substr.replace(ESCAPE_REGEXP, \"$1\");\n    } else if (expr) {\n      key = expr.trim();\n    }\n\n    result.push(key);\n  }\n\n  return result;\n}\n","import { isIndex } from \"../_internal/isIndex.ts\";\nimport { toPath } from \"../_internal/toPath.ts\";\n\n/**\n * Sets the value at the specified path of the given object. If any part of the path does not exist, it will be created.\n *\n * @template T - The type of the object.\n * @param {Settable} obj - The object to modify.\n * @param {Path} path - The path of the property to set.\n * @param {any} value - The value to set.\n * @returns {T} - The modified object.\n *\n * @example\n * // Set a value in a nested object\n * const obj = { a: { b: { c: 3 } } };\n * set(obj, 'a.b.c', 4);\n * console.log(obj.a.b.c); // 4\n *\n * @example\n * // Set a value in an array\n * const arr = [1, 2, 3];\n * set(arr, 1, 4);\n * console.log(arr[1]); // 4\n *\n * @example\n * // Create non-existent path and set value\n * const obj = {};\n * set(obj, 'a.b.c', 4);\n * console.log(obj); // { a: { b: { c: 4 } } }\n */\nexport function set<T>(obj: object, path: PropertyKey | readonly PropertyKey[], value: unknown): T;\nexport function set<T extends object>(obj: T, path: PropertyKey | readonly PropertyKey[], value: unknown): T {\n  const resolvedPath = Array.isArray(path)\n    ? path\n    : typeof path === 'string'\n      ? toPath(path)\n      : [path];\n\n  let current: any = obj;\n\n  for (let i = 0; i < resolvedPath.length - 1; i++) {\n    const key = resolvedPath[i];\n    const nextKey = resolvedPath[i + 1];\n\n    if (current[key] == null) {\n      current[key] = isIndex(nextKey) ? [] : {};\n    }\n\n    current = current[key];\n  }\n\n  const lastKey = resolvedPath[resolvedPath.length - 1];\n  current[lastKey] = value;\n\n  return obj;\n}\n","import { zip } from \"../../array/zip.ts\";\nimport { set } from \"../object/set.ts\";\n\n/**\n * Creates a deeply nested object given arrays of paths and values.\n *\n * This function takes two arrays: one containing arrays of property paths, and the other containing corresponding values.\n * It returns a new object where paths from the first array are used as key paths to set values, with corresponding elements from the second array as values.\n * Paths can be dot-separated strings or arrays of property names.\n * \n * If the `keys` array is longer than the `values` array, the remaining keys will have `undefined` as their values.\n *\n * @template V - The type of elements in the array.\n * @param {string[] | string[][]} keys - An array of property paths, each path can be a dot-separated string or an array of property names.\n * @param {V[]} values - An array of values corresponding to the property paths.\n * @returns {object} A new object composed of the given property paths and values.\n *\n * @example\n * const paths = ['a.b.c', 'd.e.f'];\n * const values = [1, 2];\n * const result = zipObjectDeep(paths, values);\n * // result will be { a: { b: { c: 1 } }, d: { e: { f: 2 } } }\n *\n * @example\n * const paths = [['a', 'b', 'c'], ['d', 'e', 'f']];\n * const values = [1, 2];\n * const result = zipObjectDeep(paths, values);\n * // result will be { a: { b: { c: 1 } }, d: { e: { f: 2 } } }\n * \n * @example\n * const paths = ['a.b[0].c', 'a.b[1].d'];\n * const values = [1, 2];\n * const result = zipObjectDeep(paths, values);\n * // result will be { 'a': { 'b': [{ 'c': 1 }, { 'd': 2 }] } }\n */\nexport function zipObjectDeep<P extends string | number | symbol, V>(keys: P[], values: V[]): { [K in P]: V } {\n  const result = {} as { [K in P]: V };\n  const zipped = zip(keys, values);\n\n  for (let i = 0; i < zipped.length; i++) {\n    const [key, value] = zipped[i];\n\n    if (key != null) {\n      set(result, key, value);\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBO,SAASA,OAAS,KAAmB,OAAe,GAAU;AACnE,SAAO,KAAK,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC;AAEnC,MAAI,SAAS,GAAG;AACd,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,MAAa,KAAK,IAAI;AAC/B;;;ACjCA,IAAM,sBAAsB;AAErB,SAAS,QAAQ,OAAoB;AAC1C,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK,UAAU;AACb,aAAO,OAAO,UAAU,KAAK,KAAK,SAAS,KAAK,QAAQ,OAAO;AAAA,IACjE;AAAA,IACA,KAAK,UAAU;AACb,aAAO;AAAA,IACT;AAAA,IACA,KAAK,UAAU;AACb,aAAO,oBAAoB,KAAK,KAAK;AAAA,IACvC;AAAA,EACF;AACF;;;ACdA,IAAM,gBAAgB;AACtB,IAAM,kBAAkB;AAAA;AAAA,EAEtB;AAAA,EAaA;AACF;AAmBO,SAAS,OAAO,SAA2B;AAChD,QAAM,SAAmB,CAAC;AAE1B,MAAI,QAAQ,CAAC,MAAM,KAAK;AACtB,WAAO,KAAK,EAAE;AAAA,EAChB;AAEA,MAAI;AAEJ,UAAQ,QAAQ,gBAAgB,KAAK,OAAO,OAAO,MAAM;AACvD,QAAI,CAAC,KAAK,MAAM,OAAO,MAAM,IAAI;AAEjC,QAAI,OAAO;AACT,YAAM,OAAO,QAAQ,eAAe,IAAI;AAAA,IAC1C,WAAW,MAAM;AACf,YAAM,KAAK,KAAK;AAAA,IAClB;AAEA,WAAO,KAAK,GAAG;AAAA,EACjB;AAEA,SAAO;AACT;;;AC3BO,SAAS,IAAsB,KAAQ,MAA4C,OAAmB;AAC3G,QAAM,eAAe,MAAM,QAAQ,IAAI,IACnC,OACA,OAAO,SAAS,WACd,OAAO,IAAI,IACX,CAAC,IAAI;AAEX,MAAI,UAAe;AAEnB,WAAS,IAAI,GAAG,IAAI,aAAa,SAAS,GAAG,KAAK;AAChD,UAAM,MAAM,aAAa,CAAC;AAC1B,UAAM,UAAU,aAAa,IAAI,CAAC;AAElC,QAAI,QAAQ,GAAG,KAAK,MAAM;AACxB,cAAQ,GAAG,IAAI,QAAQ,OAAO,IAAI,CAAC,IAAI,CAAC;AAAA,IAC1C;AAEA,cAAU,QAAQ,GAAG;AAAA,EACvB;AAEA,QAAM,UAAU,aAAa,aAAa,SAAS,CAAC;AACpD,UAAQ,OAAO,IAAI;AAEnB,SAAO;AACT;;;ACpBO,SAAS,cAAqD,MAAW,QAA8B;AAC5G,QAAM,SAAS,CAAC;AAChB,QAAM,SAAS,IAAI,MAAM,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,UAAM,CAAC,KAAK,KAAK,IAAI,OAAO,CAAC;AAE7B,QAAI,OAAO,MAAM;AACf,UAAI,QAAQ,KAAK,KAAK;AAAA,IACxB;AAAA,EACF;AAEA,SAAO;AACT;","names":["chunk"]}
+{"version":3,"sources":["../../src/compat/array/chunk.ts","../../src/compat/_internal/isIndex.ts","../../src/compat/_internal/toPath.ts","../../src/compat/object/set.ts","../../src/compat/array/zipObjectDeep.ts","../../src/compat/string/startsWith.ts","../../src/compat/string/endsWith.ts"],"sourcesContent":["import { chunk as chunkToolkit } from '../../array/chunk.ts';\n\n/**\n * Splits an array into smaller arrays of a specified length.\n *\n * This function takes an input array and divides it into multiple smaller arrays,\n * each of a specified length. If the input array cannot be evenly divided,\n * the final sub-array will contain the remaining elements.\n *\n * @template T The type of elements in the array.\n * @param {T[]} arr - The array to be chunked into smaller arrays.\n * @param {number} size - The size of each smaller array. Must be a positive integer.\n * @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.\n * @throws {Error} Throws an error if `size` is not a positive integer.\n *\n * @example\n * // Splits an array of numbers into sub-arrays of length 2\n * chunk([1, 2, 3, 4, 5], 2);\n * // Returns: [[1, 2], [3, 4], [5]]\n *\n * @example\n * // Splits an array of strings into sub-arrays of length 3\n * chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3);\n * // Returns: [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]\n */\nexport function chunk<T>(arr: readonly T[], size: number = 1): T[][] {\n  size = Math.max(Math.floor(size), 0);\n\n  if (size === 0) {\n    return [];\n  }\n\n  return chunkToolkit(arr, size);\n}\n","const IS_UNSIGNED_INTEGER = /^(?:0|[1-9]\\d*)$/\n\nexport function isIndex(value: PropertyKey) {\n  switch (typeof value) {\n    case 'number': {\n      return Number.isInteger(value) && value >= 0 && value < Number.MAX_SAFE_INTEGER;\n    }\n    case 'symbol': {\n      return false;\n    }\n    case 'string': {\n      return IS_UNSIGNED_INTEGER.test(value);\n    }\n  }\n}","const ESCAPE_REGEXP = /\\\\(\\\\)?/g;\nconst PROPERTY_REGEXP = RegExp(\n  // Match anything that isn't a dot or bracket.\n  \"[^.[\\\\]]+\" +\n    \"|\" +\n    // Or match property names within brackets.\n    \"\\\\[(?:\" +\n    // Match a non-string expression.\n    \"([^\\\"'][^[]*)\" +\n    \"|\" +\n    // Or match strings (supports escaping characters).\n    \"([\\\"'])((?:(?!\\\\2)[^\\\\\\\\]|\\\\\\\\.)*?)\\\\2\" +\n    \")\\\\]\" +\n    \"|\" +\n    // Or match \"\" as the space between consecutive dots or empty brackets.\n    \"(?=(?:\\\\.|\\\\[\\\\])(?:\\\\.|\\\\[\\\\]|$))\",\n  \"g\",\n);\n\n/**\n * Converts a deep key string into an array of path segments.\n *\n * This function takes a string representing a deep key (e.g., 'a.b.c' or 'a[b][c]') and breaks it down into an array of strings, each representing a segment of the path.\n *\n * @param deepKey - The deep key string to convert.\n * @returns An array of strings, each representing a segment of the path.\n *\n * Examples:\n *\n * toPath('a.b.c') // Returns ['a', 'b', 'c']\n * toPath('a[b][c]') // Returns ['a', 'b', 'c']\n * toPath('.a.b.c') // Returns ['', 'a', 'b', 'c']\n * toPath('a[\"b.c\"].d') // Returns ['a', 'b.c', 'd']\n * toPath('') // Returns []\n * toPath('.a[b].c.d[e][\"f.g\"].h') // Returns ['', 'a', 'b', 'c', 'd', 'e', 'f.g', 'h']\n */\nexport function toPath(deepKey: string): string[] {\n  const result: string[] = [];\n\n  if (deepKey[0] === \".\") {\n    result.push(\"\");\n  }\n\n  let match: RegExpExecArray | null;\n\n  while ((match = PROPERTY_REGEXP.exec(deepKey)) !== null) {\n    let [key, expr, quote, substr] = match;\n\n    if (quote) {\n      key = substr.replace(ESCAPE_REGEXP, \"$1\");\n    } else if (expr) {\n      key = expr.trim();\n    }\n\n    result.push(key);\n  }\n\n  return result;\n}\n","import { isIndex } from \"../_internal/isIndex.ts\";\nimport { toPath } from \"../_internal/toPath.ts\";\n\n/**\n * Sets the value at the specified path of the given object. If any part of the path does not exist, it will be created.\n *\n * @template T - The type of the object.\n * @param {Settable} obj - The object to modify.\n * @param {Path} path - The path of the property to set.\n * @param {any} value - The value to set.\n * @returns {T} - The modified object.\n *\n * @example\n * // Set a value in a nested object\n * const obj = { a: { b: { c: 3 } } };\n * set(obj, 'a.b.c', 4);\n * console.log(obj.a.b.c); // 4\n *\n * @example\n * // Set a value in an array\n * const arr = [1, 2, 3];\n * set(arr, 1, 4);\n * console.log(arr[1]); // 4\n *\n * @example\n * // Create non-existent path and set value\n * const obj = {};\n * set(obj, 'a.b.c', 4);\n * console.log(obj); // { a: { b: { c: 4 } } }\n */\nexport function set<T>(obj: object, path: PropertyKey | readonly PropertyKey[], value: unknown): T;\nexport function set<T extends object>(obj: T, path: PropertyKey | readonly PropertyKey[], value: unknown): T {\n  const resolvedPath = Array.isArray(path)\n    ? path\n    : typeof path === 'string'\n      ? toPath(path)\n      : [path];\n\n  let current: any = obj;\n\n  for (let i = 0; i < resolvedPath.length - 1; i++) {\n    const key = resolvedPath[i];\n    const nextKey = resolvedPath[i + 1];\n\n    if (current[key] == null) {\n      current[key] = isIndex(nextKey) ? [] : {};\n    }\n\n    current = current[key];\n  }\n\n  const lastKey = resolvedPath[resolvedPath.length - 1];\n  current[lastKey] = value;\n\n  return obj;\n}\n","import { zip } from \"../../array/zip.ts\";\nimport { set } from \"../object/set.ts\";\n\n/**\n * Creates a deeply nested object given arrays of paths and values.\n *\n * This function takes two arrays: one containing arrays of property paths, and the other containing corresponding values.\n * It returns a new object where paths from the first array are used as key paths to set values, with corresponding elements from the second array as values.\n * Paths can be dot-separated strings or arrays of property names.\n * \n * If the `keys` array is longer than the `values` array, the remaining keys will have `undefined` as their values.\n *\n * @template V - The type of elements in the array.\n * @param {string[] | string[][]} keys - An array of property paths, each path can be a dot-separated string or an array of property names.\n * @param {V[]} values - An array of values corresponding to the property paths.\n * @returns {object} A new object composed of the given property paths and values.\n *\n * @example\n * const paths = ['a.b.c', 'd.e.f'];\n * const values = [1, 2];\n * const result = zipObjectDeep(paths, values);\n * // result will be { a: { b: { c: 1 } }, d: { e: { f: 2 } } }\n *\n * @example\n * const paths = [['a', 'b', 'c'], ['d', 'e', 'f']];\n * const values = [1, 2];\n * const result = zipObjectDeep(paths, values);\n * // result will be { a: { b: { c: 1 } }, d: { e: { f: 2 } } }\n * \n * @example\n * const paths = ['a.b[0].c', 'a.b[1].d'];\n * const values = [1, 2];\n * const result = zipObjectDeep(paths, values);\n * // result will be { 'a': { 'b': [{ 'c': 1 }, { 'd': 2 }] } }\n */\nexport function zipObjectDeep<P extends string | number | symbol, V>(keys: P[], values: V[]): { [K in P]: V } {\n  const result = {} as { [K in P]: V };\n  const zipped = zip(keys, values);\n\n  for (let i = 0; i < zipped.length; i++) {\n    const [key, value] = zipped[i];\n\n    if (key != null) {\n      set(result, key, value);\n    }\n  }\n\n  return result;\n}\n","/**\n * Checks if a string contains another string at the beginning of the string.\n *\n * Checks if one string startsWith another string. Optional position parameter to start searching from a certain index.\n *\n * @param {string} str - The string that might contain the target string.\n * @param {string} target - The string to search for.\n * @param {number} position - An optional offset to start searching in the str string\n * @returns {boolean} - True if the str string starts with the target string.\n *\n * @example\n * const isPrefix = startsWith('fooBar', 'foo') // returns true\n * const isPrefix = startsWith('fooBar', 'bar') // returns false\n * const isPrefix = startsWith('fooBar', 'abc') // returns false\n * const isPrefix = startsWith('fooBar', 'Bar', 2) // returns true\n * const isPrefix = startsWith('fooBar', 'Bar', 5) // returns false\n */\nexport const startsWith = (str: string, target: string, position: number = 0): boolean => {\n  return str.startsWith(target, position);\n};\n","/**\n * Checks if a string contains another string at the end of the string.\n *\n * Checks if one string endsWith another string. Optional position parameter to offset searching before a certain index.\n *\n * @param {string} str - The string that might contain the target string.\n * @param {string} target - The string to search for.\n * @param {number} position - An optional position from the start to search up to this index\n * @returns {boolean} - True if the str string ends with the target string.\n *\n * @example\n * const isPrefix = endsWith('fooBar', 'foo') // returns true\n * const isPrefix = endsWith('fooBar', 'bar') // returns false\n * const isPrefix = endsWith('fooBar', 'abc') // returns false\n * const isPrefix = endsWith('fooBar', 'foo', 3) // returns true\n * const isPrefix = endsWith('fooBar', 'abc', 5) // returns false\n */\nexport const endsWith = (str: string, target: string, position: number = str.length): boolean => {\n  return str.endsWith(target, position);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBO,SAASA,OAAS,KAAmB,OAAe,GAAU;AACnE,SAAO,KAAK,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC;AAEnC,MAAI,SAAS,GAAG;AACd,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,MAAa,KAAK,IAAI;AAC/B;;;ACjCA,IAAM,sBAAsB;AAErB,SAAS,QAAQ,OAAoB;AAC1C,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK,UAAU;AACb,aAAO,OAAO,UAAU,KAAK,KAAK,SAAS,KAAK,QAAQ,OAAO;AAAA,IACjE;AAAA,IACA,KAAK,UAAU;AACb,aAAO;AAAA,IACT;AAAA,IACA,KAAK,UAAU;AACb,aAAO,oBAAoB,KAAK,KAAK;AAAA,IACvC;AAAA,EACF;AACF;;;ACdA,IAAM,gBAAgB;AACtB,IAAM,kBAAkB;AAAA;AAAA,EAEtB;AAAA,EAaA;AACF;AAmBO,SAAS,OAAO,SAA2B;AAChD,QAAM,SAAmB,CAAC;AAE1B,MAAI,QAAQ,CAAC,MAAM,KAAK;AACtB,WAAO,KAAK,EAAE;AAAA,EAChB;AAEA,MAAI;AAEJ,UAAQ,QAAQ,gBAAgB,KAAK,OAAO,OAAO,MAAM;AACvD,QAAI,CAAC,KAAK,MAAM,OAAO,MAAM,IAAI;AAEjC,QAAI,OAAO;AACT,YAAM,OAAO,QAAQ,eAAe,IAAI;AAAA,IAC1C,WAAW,MAAM;AACf,YAAM,KAAK,KAAK;AAAA,IAClB;AAEA,WAAO,KAAK,GAAG;AAAA,EACjB;AAEA,SAAO;AACT;;;AC3BO,SAAS,IAAsB,KAAQ,MAA4C,OAAmB;AAC3G,QAAM,eAAe,MAAM,QAAQ,IAAI,IACnC,OACA,OAAO,SAAS,WACd,OAAO,IAAI,IACX,CAAC,IAAI;AAEX,MAAI,UAAe;AAEnB,WAAS,IAAI,GAAG,IAAI,aAAa,SAAS,GAAG,KAAK;AAChD,UAAM,MAAM,aAAa,CAAC;AAC1B,UAAM,UAAU,aAAa,IAAI,CAAC;AAElC,QAAI,QAAQ,GAAG,KAAK,MAAM;AACxB,cAAQ,GAAG,IAAI,QAAQ,OAAO,IAAI,CAAC,IAAI,CAAC;AAAA,IAC1C;AAEA,cAAU,QAAQ,GAAG;AAAA,EACvB;AAEA,QAAM,UAAU,aAAa,aAAa,SAAS,CAAC;AACpD,UAAQ,OAAO,IAAI;AAEnB,SAAO;AACT;;;ACpBO,SAAS,cAAqD,MAAW,QAA8B;AAC5G,QAAM,SAAS,CAAC;AAChB,QAAM,SAAS,IAAI,MAAM,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,UAAM,CAAC,KAAK,KAAK,IAAI,OAAO,CAAC;AAE7B,QAAI,OAAO,MAAM;AACf,UAAI,QAAQ,KAAK,KAAK;AAAA,IACxB;AAAA,EACF;AAEA,SAAO;AACT;;;AC/BO,IAAM,aAAa,CAAC,KAAa,QAAgB,WAAmB,MAAe;AACxF,SAAO,IAAI,WAAW,QAAQ,QAAQ;AACxC;;;ACFO,IAAM,WAAW,CAAC,KAAa,QAAgB,WAAmB,IAAI,WAAoB;AAC/F,SAAO,IAAI,SAAS,QAAQ,QAAQ;AACtC;","names":["chunk"]}

package/dist/error/AbortError.mjs

@@ -1,7 +1,7 @@
 import {
   AbortError
 } from "../chunk-DXB7EZUQ.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   AbortError
 };

package/dist/error/TimeoutError.d.mts

@@ -0,0 +1,9 @@
+/**
+ * An error class representing an timeout operation.
+ * @augments Error
+ */
+declare class TimeoutError extends Error {
+    constructor(message?: string);
+}
+
+export { TimeoutError };

package/dist/error/TimeoutError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * An error class representing an timeout operation.
+ * @augments Error
+ */
+declare class TimeoutError extends Error {
+    constructor(message?: string);
+}
+
+export { TimeoutError };

package/dist/{string/startsWith.js → error/TimeoutError.js}

@@ -17,17 +17,20 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/string/startsWith.ts
-var startsWith_exports = {};
-__export(startsWith_exports, {
-  startsWith: () => startsWith
+// src/error/TimeoutError.ts
+var TimeoutError_exports = {};
+__export(TimeoutError_exports, {
+  TimeoutError: () => TimeoutError
 });
-module.exports = __toCommonJS(startsWith_exports);
-var startsWith = (str, target, position = 0) => {
-  return str.startsWith(target, position);
+module.exports = __toCommonJS(TimeoutError_exports);
+var TimeoutError = class extends Error {
+  constructor(message = "The operation was timed out") {
+    super(message);
+    this.name = "TimeoutError";
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  startsWith
+  TimeoutError
 });
-//# sourceMappingURL=startsWith.js.map
+//# sourceMappingURL=TimeoutError.js.map

package/dist/error/TimeoutError.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/TimeoutError.ts"],"sourcesContent":["/**\n * An error class representing an timeout operation.\n * @augments Error\n */\nexport class TimeoutError extends Error {\n  constructor(message = 'The operation was timed out') {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YAAY,UAAU,+BAA+B;AACnD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/dist/error/TimeoutError.mjs

@@ -0,0 +1,8 @@
+import {
+  TimeoutError
+} from "../chunk-KIOYQRMQ.mjs";
+import "../chunk-424M7IR7.mjs";
+export {
+  TimeoutError
+};
+//# sourceMappingURL=TimeoutError.mjs.map

package/dist/error/index.d.mts

@@ -1 +1,2 @@
 export { AbortError } from './AbortError.mjs';
+export { TimeoutError } from './TimeoutError.mjs';

package/dist/error/index.d.ts

@@ -1 +1,2 @@
 export { AbortError } from './AbortError.js';
+export { TimeoutError } from './TimeoutError.js';

package/dist/error/index.js

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/error/index.ts
 var error_exports = {};
 __export(error_exports, {
-  AbortError: () => AbortError
+  AbortError: () => AbortError,
+  TimeoutError: () => TimeoutError
 });
 module.exports = __toCommonJS(error_exports);
 
@@ -31,8 +32,17 @@ var AbortError = class extends Error {
     this.name = "AbortError";
   }
 };
+
+// src/error/TimeoutError.ts
+var TimeoutError = class extends Error {
+  constructor(message = "The operation was timed out") {
+    super(message);
+    this.name = "TimeoutError";
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AbortError
+  AbortError,
+  TimeoutError
 });
 //# sourceMappingURL=index.js.map

package/dist/error/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/error/index.ts","../../src/error/AbortError.ts"],"sourcesContent":["export { AbortError } from './AbortError.ts';\n","/**\n * An error class representing an aborted operation.\n * @augments Error\n */\nexport class AbortError extends Error {\n  constructor(message = 'The operation was aborted') {\n    super(message);\n    this.name = 'AbortError';\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YAAY,UAAU,6BAA6B;AACjD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}
+{"version":3,"sources":["../../src/error/index.ts","../../src/error/AbortError.ts","../../src/error/TimeoutError.ts"],"sourcesContent":["export { AbortError } from './AbortError.ts';\nexport { TimeoutError } from './TimeoutError.ts';\n","/**\n * An error class representing an aborted operation.\n * @augments Error\n */\nexport class AbortError extends Error {\n  constructor(message = 'The operation was aborted') {\n    super(message);\n    this.name = 'AbortError';\n  }\n}\n","/**\n * An error class representing an timeout operation.\n * @augments Error\n */\nexport class TimeoutError extends Error {\n  constructor(message = 'The operation was timed out') {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YAAY,UAAU,6BAA6B;AACjD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;;ACLO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YAAY,UAAU,+BAA+B;AACnD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/dist/error/index.mjs

@@ -1,9 +1,13 @@
-import "../chunk-FZEZH22H.mjs";
+import "../chunk-F47GLYUU.mjs";
 import {
   AbortError
 } from "../chunk-DXB7EZUQ.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import {
+  TimeoutError
+} from "../chunk-KIOYQRMQ.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
-  AbortError
+  AbortError,
+  TimeoutError
 };
 //# sourceMappingURL=index.mjs.map

package/dist/function/debounce.mjs

@@ -1,7 +1,7 @@
 import {
   debounce
 } from "../chunk-3IP4JVLL.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   debounce
 };

package/dist/function/index.mjs

@@ -1,4 +1,7 @@
 import "../chunk-236H5JZJ.mjs";
+import {
+  noop
+} from "../chunk-LKXCOLNY.mjs";
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
@@ -11,10 +14,7 @@ import {
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   debounce,
   negate,

package/dist/function/negate.mjs

@@ -1,7 +1,7 @@
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   negate
 };

package/dist/function/noop.mjs

@@ -1,7 +1,7 @@
 import {
   noop
 } from "../chunk-LKXCOLNY.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   noop
 };

package/dist/function/once.mjs

@@ -1,7 +1,7 @@
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   once
 };

package/dist/function/throttle.mjs

@@ -1,7 +1,7 @@
 import {
   throttle
 } from "../chunk-QOJGMVVR.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   throttle
 };

package/dist/index.d.mts

@@ -50,6 +50,7 @@ export { toFilled } from './array/toFilled.mjs';
 export { last } from './array/last.mjs';
 export { initial } from './array/initial.mjs';
 export { AbortError } from './error/AbortError.mjs';
+export { TimeoutError } from './error/TimeoutError.mjs';
 export { debounce } from './function/debounce.mjs';
 export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';
@@ -78,11 +79,10 @@ export { isNotNil } from './predicate/isNotNil.mjs';
 export { isNull } from './predicate/isNull.mjs';
 export { isUndefined } from './predicate/isUndefined.mjs';
 export { delay } from './promise/delay.mjs';
+export { withTimeout } from './promise/withTimeout.mjs';
 export { camelCase } from './string/camelCase.mjs';
 export { snakeCase } from './string/snakeCase.mjs';
 export { kebabCase } from './string/kebabCase.mjs';
 export { lowerCase } from './string/lowerCase.mjs';
 export { startCase } from './string/startCase.mjs';
-export { startsWith } from './string/startsWith.mjs';
-export { endsWith } from './string/endsWith.mjs';
 export { capitalize } from './string/capitalize.mjs';

package/dist/index.d.ts

@@ -50,6 +50,7 @@ export { toFilled } from './array/toFilled.js';
 export { last } from './array/last.js';
 export { initial } from './array/initial.js';
 export { AbortError } from './error/AbortError.js';
+export { TimeoutError } from './error/TimeoutError.js';
 export { debounce } from './function/debounce.js';
 export { noop } from './function/noop.js';
 export { once } from './function/once.js';
@@ -78,11 +79,10 @@ export { isNotNil } from './predicate/isNotNil.js';
 export { isNull } from './predicate/isNull.js';
 export { isUndefined } from './predicate/isUndefined.js';
 export { delay } from './promise/delay.js';
+export { withTimeout } from './promise/withTimeout.js';
 export { camelCase } from './string/camelCase.js';
 export { snakeCase } from './string/snakeCase.js';
 export { kebabCase } from './string/kebabCase.js';
 export { lowerCase } from './string/lowerCase.js';
 export { startCase } from './string/startCase.js';
-export { startsWith } from './string/startsWith.js';
-export { endsWith } from './string/endsWith.js';
 export { capitalize } from './string/capitalize.js';