es-toolkit 1.10.1-dev.229 → 1.10.1-dev.231

package/dist/compat/index.mjs

@@ -1,5 +1,6 @@
 import "../chunk-NKLIE2OI.mjs";
-import "../chunk-QKYYOLJ6.mjs";
+import "../chunk-ARZ5BDR6.mjs";
+import "../chunk-XT74R35S.mjs";
 import {
   camelCase
 } from "../chunk-Y5V7UAZZ.mjs";
@@ -15,6 +16,9 @@ import {
 import {
   snakeCase
 } from "../chunk-F3WCQQET.mjs";
+import {
+  startCase
+} from "../chunk-MJA7DAOJ.mjs";
 import "../chunk-WVQ7YVRK.mjs";
 import "../chunk-ASJF5D6C.mjs";
 import {
@@ -32,11 +36,13 @@ import {
 import {
   isUndefined
 } from "../chunk-VH2PV426.mjs";
-import "../chunk-ARZ5BDR6.mjs";
 import {
   delay
 } from "../chunk-O64NE2P4.mjs";
-import "../chunk-OSOLEQLZ.mjs";
+import "../chunk-54TK5BIS.mjs";
+import {
+  set
+} from "../chunk-GL7PPRA4.mjs";
 import {
   clone
 } from "../chunk-U4JGKZ56.mjs";
@@ -74,22 +80,6 @@ import {
 import {
   sum
 } from "../chunk-2SLTL4KL.mjs";
-import "../chunk-236H5JZJ.mjs";
-import {
-  debounce
-} from "../chunk-3IP4JVLL.mjs";
-import {
-  negate
-} from "../chunk-BOOQBJN2.mjs";
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
-import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
 import {
   clamp
 } from "../chunk-MLCL773E.mjs";
@@ -97,12 +87,6 @@ import {
   inRange
 } from "../chunk-BH6HLGBA.mjs";
 import "../chunk-DDH7K4QM.mjs";
-import {
-  unzipWith
-} from "../chunk-IFNXROZR.mjs";
-import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
 import {
   xor
 } from "../chunk-L7FQX5MN.mjs";
@@ -121,21 +105,12 @@ import {
 import {
   zipWith
 } from "../chunk-4KYXHZ4R.mjs";
-import {
-  toFilled
-} from "../chunk-OP4OAKQJ.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-OXAZEEGP.mjs";
@@ -146,17 +121,11 @@ import {
   unzip
 } from "../chunk-UYZKMBDO.mjs";
 import {
-  sample
-} from "../chunk-2KNLZB7V.mjs";
-import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
-import {
-  randomInt
-} from "../chunk-GIWAOOFY.mjs";
+  unzipWith
+} from "../chunk-IFNXROZR.mjs";
 import {
-  random
-} from "../chunk-SYWMYQYJ.mjs";
+  without
+} from "../chunk-PYEYV7BY.mjs";
 import {
   shuffle
 } from "../chunk-G7UQ5PUR.mjs";
@@ -176,11 +145,14 @@ import {
   takeWhile
 } from "../chunk-2IXFGSUA.mjs";
 import {
-  intersectionBy
-} from "../chunk-O6UXZR3U.mjs";
+  toFilled
+} from "../chunk-OP4OAKQJ.mjs";
 import {
-  intersectionWith
-} from "../chunk-XI7KRD2C.mjs";
+  union
+} from "../chunk-R6QA7PLZ.mjs";
+import {
+  uniq
+} from "../chunk-DVK2N4KC.mjs";
 import {
   keyBy
 } from "../chunk-AJKZMN2V.mjs";
@@ -200,8 +172,17 @@ import {
   partition
 } from "../chunk-DN3NOZ3H.mjs";
 import {
-  flattenDeep
-} from "../chunk-ML727RRJ.mjs";
+  sample
+} from "../chunk-2KNLZB7V.mjs";
+import {
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
+import {
+  randomInt
+} from "../chunk-GIWAOOFY.mjs";
+import {
+  random
+} from "../chunk-SYWMYQYJ.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -218,11 +199,11 @@ import {
   intersection
 } from "../chunk-FVVSE2F2.mjs";
 import {
-  differenceBy
-} from "../chunk-LVWX5B43.mjs";
+  intersectionBy
+} from "../chunk-O6UXZR3U.mjs";
 import {
-  differenceWith
-} from "../chunk-6NVQAHXP.mjs";
+  intersectionWith
+} from "../chunk-XI7KRD2C.mjs";
 import {
   drop
 } from "../chunk-S3CORED5.mjs";
@@ -241,13 +222,12 @@ import {
 import {
   flatMap
 } from "../chunk-KBXHURLW.mjs";
+import {
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
-import "../chunk-FZEZH22H.mjs";
-import {
-  AbortError
-} from "../chunk-DXB7EZUQ.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -260,6 +240,32 @@ import {
 import {
   difference
 } from "../chunk-JPUKH67K.mjs";
+import {
+  differenceBy
+} from "../chunk-LVWX5B43.mjs";
+import {
+  differenceWith
+} from "../chunk-6NVQAHXP.mjs";
+import "../chunk-FZEZH22H.mjs";
+import {
+  AbortError
+} from "../chunk-DXB7EZUQ.mjs";
+import "../chunk-236H5JZJ.mjs";
+import {
+  once
+} from "../chunk-CMBC4MXG.mjs";
+import {
+  throttle
+} from "../chunk-QOJGMVVR.mjs";
+import {
+  debounce
+} from "../chunk-3IP4JVLL.mjs";
+import {
+  negate
+} from "../chunk-BOOQBJN2.mjs";
+import {
+  noop
+} from "../chunk-LKXCOLNY.mjs";
 import "../chunk-2MM5EJJX.mjs";
 
 // src/compat/array/chunk.ts
@@ -329,8 +335,10 @@ export {
   round,
   sample,
   sampleSize,
+  set,
   shuffle,
   snakeCase,
+  startCase,
   sum,
   sumBy,
   tail,

package/dist/compat/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/compat/array/chunk.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"],"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;","names":["chunk"]}
+{"version":3,"sources":["../../src/compat/array/chunk.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"],"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;","names":["chunk"]}

package/dist/function/index.mjs

@@ -1,4 +1,10 @@
 import "../chunk-236H5JZJ.mjs";
+import {
+  once
+} from "../chunk-CMBC4MXG.mjs";
+import {
+  throttle
+} from "../chunk-QOJGMVVR.mjs";
 import {
   debounce
 } from "../chunk-3IP4JVLL.mjs";
@@ -8,12 +14,6 @@ import {
 import {
   noop
 } from "../chunk-LKXCOLNY.mjs";
-import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   debounce,

package/dist/index.d.mts

@@ -71,6 +71,7 @@ export { pick } from './object/pick.mjs';
 export { pickBy } from './object/pickBy.mjs';
 export { invert } from './object/invert.mjs';
 export { clone } from './object/clone.mjs';
+export { set } from './object/set.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isNil } from './predicate/isNil.mjs';
 export { isNotNil } from './predicate/isNotNil.mjs';
@@ -81,4 +82,5 @@ 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

@@ -71,6 +71,7 @@ export { pick } from './object/pick.js';
 export { pickBy } from './object/pickBy.js';
 export { invert } from './object/invert.js';
 export { clone } from './object/clone.js';
+export { set } from './object/set.js';
 export { isEqual } from './predicate/isEqual.js';
 export { isNil } from './predicate/isNil.js';
 export { isNotNil } from './predicate/isNotNil.js';
@@ -81,4 +82,5 @@ 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

@@ -92,8 +92,10 @@ __export(src_exports, {
   round: () => round,
   sample: () => sample,
   sampleSize: () => sampleSize,
+  set: () => set,
   shuffle: () => shuffle,
   snakeCase: () => snakeCase,
+  startCase: () => startCase,
   sum: () => sum,
   sumBy: () => sumBy,
   tail: () => tail,
@@ -880,6 +882,27 @@ function isPrimitive(value) {
   return value == null || typeof value !== "object" && typeof value !== "function";
 }
 
+// src/object/set.ts
+function set(obj, path, value) {
+  if (obj instanceof Map || obj instanceof Set) {
+    throw new TypeError("Set or Map is not supported");
+  }
+  const keys = Array.isArray(path) ? path : String(path).replace(/\[|\]/g, (match) => {
+    return match === "[" ? "." : "";
+  }).split(".");
+  let pointer = obj;
+  for (let i = 0; i < keys.length - 1; i++) {
+    const key = keys[i];
+    const nextKey = keys[i + 1];
+    if (pointer[key] == null || typeof pointer[key] !== "object") {
+      pointer[key] = /^\d+$/.test(nextKey) ? [] : {};
+    }
+    pointer = pointer[key];
+  }
+  pointer[keys[keys.length - 1]] = value;
+  return obj;
+}
+
 // src/predicate/isEqual.ts
 function isEqual(a, b) {
   if (Object.is(a, b)) {
@@ -990,6 +1013,23 @@ 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,
@@ -1050,8 +1090,10 @@ var lowerCase = (str) => {
   round,
   sample,
   sampleSize,
+  set,
   shuffle,
   snakeCase,
+  startCase,
   sum,
   sumBy,
   tail,