es-toolkit 1.10.1 → 1.11.0-dev.263

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,10 +1,4 @@
 import "../chunk-236H5JZJ.mjs";
-import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
 import {
   debounce
 } from "../chunk-3IP4JVLL.mjs";
@@ -14,7 +8,13 @@ import {
 import {
   noop
 } from "../chunk-LKXCOLNY.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import {
+  once
+} from "../chunk-CMBC4MXG.mjs";
+import {
+  throttle
+} from "../chunk-QOJGMVVR.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

@@ -9,6 +9,7 @@ export { dropRight } from './array/dropRight.mjs';
 export { dropRightWhile } from './array/dropRightWhile.mjs';
 export { dropWhile } from './array/dropWhile.mjs';
 export { fill } from './array/fill.mjs';
+export { flatMap } from './array/flatMap.mjs';
 export { flatten } from './array/flatten.mjs';
 export { flattenDeep } from './array/flattenDeep.mjs';
 export { forEachRight } from './array/forEachRight.mjs';
@@ -49,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';
@@ -76,8 +78,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 { capitalize } from './string/capitalize.mjs';

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { dropRight } from './array/dropRight.js';
 export { dropRightWhile } from './array/dropRightWhile.js';
 export { dropWhile } from './array/dropWhile.js';
 export { fill } from './array/fill.js';
+export { flatMap } from './array/flatMap.js';
 export { flatten } from './array/flatten.js';
 export { flattenDeep } from './array/flattenDeep.js';
 export { forEachRight } from './array/forEachRight.js';
@@ -49,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';
@@ -76,8 +78,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 { capitalize } from './string/capitalize.js';

package/dist/index.js

@@ -30,11 +30,32 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
   AbortError: () => AbortError,
+  TimeoutError: () => TimeoutError,
   camelCase: () => camelCase,
   capitalize: () => capitalize,
   chunk: () => chunk,
@@ -52,6 +73,7 @@ __export(src_exports, {
   dropRightWhile: () => dropRightWhile,
   dropWhile: () => dropWhile,
   fill: () => fill,
+  flatMap: () => flatMap,
   flatten: () => flatten,
   flattenDeep: () => flattenDeep,
   forEachRight: () => forEachRight,
@@ -93,6 +115,7 @@ __export(src_exports, {
   sampleSize: () => sampleSize,
   shuffle: () => shuffle,
   snakeCase: () => snakeCase,
+  startCase: () => startCase,
   sum: () => sum,
   sumBy: () => sumBy,
   tail: () => tail,
@@ -110,6 +133,7 @@ __export(src_exports, {
   uniqWith: () => uniqWith,
   unzip: () => unzip,
   unzipWith: () => unzipWith,
+  withTimeout: () => withTimeout,
   without: () => without,
   xor: () => xor,
   xorBy: () => xorBy,
@@ -182,12 +206,27 @@ function differenceWith(firstArr, secondArr, areItemsEqual) {
 
 // src/array/drop.ts
 function drop(arr, itemsCount) {
+  itemsCount = Math.max(itemsCount, 0);
   return arr.slice(itemsCount);
 }
 
 // src/array/dropRight.ts
 function dropRight(arr, itemsCount) {
-  return arr.slice(0, -itemsCount);
+  itemsCount = Math.min(-itemsCount, 0);
+  if (itemsCount === 0) {
+    return arr.slice();
+  }
+  return arr.slice(0, itemsCount);
+}
+
+// src/array/dropRightWhile.ts
+function dropRightWhile(arr, canContinueDropping) {
+  for (let i = arr.length - 1; i >= 0; i--) {
+    if (!canContinueDropping(arr[i])) {
+      return arr.slice(0, i + 1);
+    }
+  }
+  return [];
 }
 
 // src/array/dropWhile.ts
@@ -199,21 +238,15 @@ function dropWhile(arr, canContinueDropping) {
   return arr.slice(dropEndIndex);
 }
 
-// src/array/dropRightWhile.ts
-function dropRightWhile(arr, canContinueDropping) {
-  const reversed = arr.slice().reverse();
-  const dropped = dropWhile(reversed, canContinueDropping);
-  return dropped.slice().reverse();
-}
-
 // src/array/fill.ts
-function fill(arr, value, start = 0, end = arr.length) {
-  start = Math.max(start, 0);
-  end = Math.min(end, arr.length);
-  for (let i = start; i < end; i++) {
-    arr[i] = value;
+function fill(array, value, start = 0, end = array.length) {
+  const length = array.length;
+  const finalStart = Math.max(start >= 0 ? start : length + start, 0);
+  const finalEnd = Math.min(end >= 0 ? end : length + end, length);
+  for (let i = finalStart; i < finalEnd; i++) {
+    array[i] = value;
   }
-  return arr;
+  return array;
 }
 
 // src/array/flatten.ts
@@ -233,6 +266,11 @@ function flatten(arr, depth = 1) {
   return result;
 }
 
+// src/array/flatMap.ts
+function flatMap(arr, iteratee, depth = 1) {
+  return flatten(arr.map((item) => iteratee(item)), depth);
+}
+
 // src/array/flattenDeep.ts
 function flattenDeep(arr) {
   return flatten(arr, Infinity);
@@ -640,6 +678,14 @@ var AbortError = class extends Error {
   }
 };
 
+// src/error/TimeoutError.ts
+var TimeoutError = class extends Error {
+  constructor(message = "The operation was timed out") {
+    super(message);
+    this.name = "TimeoutError";
+  }
+};
+
 // src/function/debounce.ts
 function debounce(func, debounceMs, { signal } = {}) {
   let timeoutId = null;
@@ -825,7 +871,9 @@ function pickBy(obj, shouldPick) {
 // src/object/invert.ts
 function invert(obj) {
   const result = {};
-  for (const key in obj) {
+  const keys = Object.keys(obj);
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
     const value = obj[key];
     result[value] = key;
   }
@@ -940,6 +988,21 @@ function delay(ms, { signal } = {}) {
   });
 }
 
+// src/promise/timeout.ts
+function timeout(ms) {
+  return __async(this, null, function* () {
+    yield delay(ms);
+    throw new TimeoutError();
+  });
+}
+
+// src/promise/withTimeout.ts
+function withTimeout(run, ms) {
+  return __async(this, null, function* () {
+    return Promise.race([run(), timeout(ms)]);
+  });
+}
+
 // src/string/capitalize.ts
 var capitalize = (str) => {
   return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
@@ -979,9 +1042,27 @@ var lowerCase = (str) => {
   const words = getWords(str);
   return words.map((word) => word.toLowerCase()).join(" ");
 };
+
+// src/string/startCase.ts
+function startCase(str) {
+  const words = getWords(str.trim());
+  let result = "";
+  for (const word of words) {
+    if (result) {
+      result += " ";
+    }
+    if (word === word.toUpperCase()) {
+      result += word;
+    } else {
+      result += word[0].toUpperCase() + word.slice(1).toLowerCase();
+    }
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AbortError,
+  TimeoutError,
   camelCase,
   capitalize,
   chunk,
@@ -999,6 +1080,7 @@ var lowerCase = (str) => {
   dropRightWhile,
   dropWhile,
   fill,
+  flatMap,
   flatten,
   flattenDeep,
   forEachRight,
@@ -1040,6 +1122,7 @@ var lowerCase = (str) => {
   sampleSize,
   shuffle,
   snakeCase,
+  startCase,
   sum,
   sumBy,
   tail,
@@ -1057,6 +1140,7 @@ var lowerCase = (str) => {
   uniqWith,
   unzip,
   unzipWith,
+  withTimeout,
   without,
   xor,
   xorBy,