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

package/dist/array/index.mjs

@@ -1,10 +1,4 @@
 import "../chunk-DDH7K4QM.mjs";
-import {
-  unzipWith
-} from "../chunk-IFNXROZR.mjs";
-import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
 import {
   xor
 } from "../chunk-L7FQX5MN.mjs";
@@ -23,21 +17,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";
@@ -48,13 +33,11 @@ import {
   unzip
 } from "../chunk-UYZKMBDO.mjs";
 import {
-  sample
-} from "../chunk-2KNLZB7V.mjs";
+  unzipWith
+} from "../chunk-IFNXROZR.mjs";
 import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
-import "../chunk-GIWAOOFY.mjs";
-import "../chunk-SYWMYQYJ.mjs";
+  without
+} from "../chunk-PYEYV7BY.mjs";
 import {
   shuffle
 } from "../chunk-G7UQ5PUR.mjs";
@@ -74,11 +57,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";
@@ -98,8 +84,13 @@ import {
   partition
 } from "../chunk-DN3NOZ3H.mjs";
 import {
-  flattenDeep
-} from "../chunk-ML727RRJ.mjs";
+  sample
+} from "../chunk-2KNLZB7V.mjs";
+import {
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
+import "../chunk-GIWAOOFY.mjs";
+import "../chunk-SYWMYQYJ.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -116,11 +107,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";
@@ -139,6 +130,9 @@ import {
 import {
   flatMap
 } from "../chunk-KBXHURLW.mjs";
+import {
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
@@ -154,6 +148,12 @@ import {
 import {
   difference
 } from "../chunk-JPUKH67K.mjs";
+import {
+  differenceBy
+} from "../chunk-LVWX5B43.mjs";
+import {
+  differenceWith
+} from "../chunk-6NVQAHXP.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   chunk,

package/dist/chunk-54TK5BIS.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-54TK5BIS.mjs.map

package/dist/chunk-GL7PPRA4.mjs

@@ -0,0 +1,25 @@
+// 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;
+}
+
+export {
+  set
+};
+//# sourceMappingURL=chunk-GL7PPRA4.mjs.map

package/dist/chunk-GL7PPRA4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/object/set.ts"],"sourcesContent":["/**\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: Settable, path: Path, value: any): T {\n  if (obj instanceof Map || obj instanceof Set) {\n    throw new TypeError('Set or Map is not supported');\n  }\n  //TODO: memoize\n  const keys = Array.isArray(path)\n    ? path\n    : String(path as string)\n        .replace(/\\[|\\]/g, match => {\n          return match === '[' ? '.' : '';\n        })\n        .split('.');\n\n  let pointer: any = obj;\n\n  for (let i = 0; i < keys.length - 1; i++) {\n    const key = keys[i];\n    const nextKey = keys[i + 1];\n    if (pointer[key] == null || typeof pointer[key] !== 'object') {\n      pointer[key] = /^\\d+$/.test(nextKey as string) ? [] : {};\n    }\n    pointer = pointer[key];\n  }\n\n  pointer[keys[keys.length - 1]] = value;\n  return obj as T;\n}\n\ntype Settable = object | any[];\ntype Path = string | number | Array<string | number>;\n"],"mappings":";AA2BO,SAAS,IAAO,KAAe,MAAY,OAAe;AAC/D,MAAI,eAAe,OAAO,eAAe,KAAK;AAC5C,UAAM,IAAI,UAAU,6BAA6B;AAAA,EACnD;AAEA,QAAM,OAAO,MAAM,QAAQ,IAAI,IAC3B,OACA,OAAO,IAAc,EAClB,QAAQ,UAAU,WAAS;AAC1B,WAAO,UAAU,MAAM,MAAM;AAAA,EAC/B,CAAC,EACA,MAAM,GAAG;AAEhB,MAAI,UAAe;AAEnB,WAAS,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;AACxC,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,UAAU,KAAK,IAAI,CAAC;AAC1B,QAAI,QAAQ,GAAG,KAAK,QAAQ,OAAO,QAAQ,GAAG,MAAM,UAAU;AAC5D,cAAQ,GAAG,IAAI,QAAQ,KAAK,OAAiB,IAAI,CAAC,IAAI,CAAC;AAAA,IACzD;AACA,cAAU,QAAQ,GAAG;AAAA,EACvB;AAEA,UAAQ,KAAK,KAAK,SAAS,CAAC,CAAC,IAAI;AACjC,SAAO;AACT;","names":[]}

package/dist/chunk-MJA7DAOJ.mjs

@@ -0,0 +1,25 @@
+import {
+  getWords
+} from "./chunk-WVQ7YVRK.mjs";
+
+// 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;
+}
+
+export {
+  startCase
+};
+//# sourceMappingURL=chunk-MJA7DAOJ.mjs.map

package/dist/chunk-MJA7DAOJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/string/startCase.ts"],"sourcesContent":["import { getWords } from './_internal/getWords';\n\n/**\n * Converts the first character of each word in a string to uppercase and the remaining characters to lowercase.\n *\n * Start case is the naming convention in which each word is written with an initial capital letter.\n * @param {string} str - The string to convert.\n * @returns {string} The converted string.\n *\n * @example\n * const result1 = startCase('hello world');  // result will be 'Hello World'\n * const result2 = startCase('HELLO WORLD');  // result will be 'Hello World'\n * const result3 = startCase('hello-world');  // result will be 'Hello World'\n * const result4 = startCase('hello_world');  // result will be 'Hello World'\n */\nexport function startCase(str: string): string {\n  const words = getWords(str.trim());\n  let result = '';\n  for (const word of words) {\n    if (result) {\n      result += ' ';\n    }\n    if (word === word.toUpperCase()) {\n      result += word;\n    } else {\n      result += word[0].toUpperCase() + word.slice(1).toLowerCase();\n    }\n  }\n  return result;\n}\n"],"mappings":";;;;;AAeO,SAAS,UAAU,KAAqB;AAC7C,QAAM,QAAQ,SAAS,IAAI,KAAK,CAAC;AACjC,MAAI,SAAS;AACb,aAAW,QAAQ,OAAO;AACxB,QAAI,QAAQ;AACV,gBAAU;AAAA,IACZ;AACA,QAAI,SAAS,KAAK,YAAY,GAAG;AAC/B,gBAAU;AAAA,IACZ,OAAO;AACL,gBAAU,KAAK,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC,EAAE,YAAY;AAAA,IAC9D;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-XT74R35S.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-XT74R35S.mjs.map

package/dist/compat/index.d.mts

@@ -70,6 +70,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';
@@ -80,6 +81,7 @@ 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/compat/index.d.ts

@@ -70,6 +70,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';
@@ -80,6 +81,7 @@ 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/compat/index.js

@@ -92,8 +92,10 @@ __export(compat_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)) {
@@ -991,6 +1014,23 @@ var lowerCase = (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;
+}
+
 // src/compat/array/chunk.ts
 function chunk2(arr, size = 1) {
   size = Math.max(Math.floor(size), 0);
@@ -1059,8 +1099,10 @@ function chunk2(arr, size = 1) {
   round,
   sample,
   sampleSize,
+  set,
   shuffle,
   snakeCase,
+  startCase,
   sum,
   sumBy,
   tail,