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

package/dist/compat/index.mjs

@@ -1,4 +1,5 @@
 import "../chunk-NKLIE2OI.mjs";
+import "../chunk-ARZ5BDR6.mjs";
 import "../chunk-XT74R35S.mjs";
 import {
   camelCase
@@ -35,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";
@@ -332,6 +335,7 @@ export {
   round,
   sample,
   sampleSize,
+  set,
   shuffle,
   snakeCase,
   startCase,

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/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';

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';

package/dist/index.js

@@ -92,6 +92,7 @@ __export(src_exports, {
   round: () => round,
   sample: () => sample,
   sampleSize: () => sampleSize,
+  set: () => set,
   shuffle: () => shuffle,
   snakeCase: () => snakeCase,
   startCase: () => startCase,
@@ -881,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)) {
@@ -1068,6 +1090,7 @@ function startCase(str) {
   round,
   sample,
   sampleSize,
+  set,
   shuffle,
   snakeCase,
   startCase,