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

package/dist/compat/index.mjs

@@ -1,5 +1,5 @@
 import "../chunk-NKLIE2OI.mjs";
-import "../chunk-QKYYOLJ6.mjs";
+import "../chunk-XT74R35S.mjs";
 import {
   camelCase
 } from "../chunk-Y5V7UAZZ.mjs";
@@ -15,6 +15,9 @@ import {
 import {
   snakeCase
 } from "../chunk-F3WCQQET.mjs";
+import {
+  startCase
+} from "../chunk-MJA7DAOJ.mjs";
 import "../chunk-WVQ7YVRK.mjs";
 import "../chunk-ASJF5D6C.mjs";
 import {
@@ -74,22 +77,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 +84,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 +102,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 +118,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 +142,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 +169,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 +196,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 +219,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 +237,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
@@ -331,6 +334,7 @@ export {
   sampleSize,
   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

@@ -81,4 +81,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

@@ -81,4 +81,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

@@ -94,6 +94,7 @@ __export(src_exports, {
   sampleSize: () => sampleSize,
   shuffle: () => shuffle,
   snakeCase: () => snakeCase,
+  startCase: () => startCase,
   sum: () => sum,
   sumBy: () => sumBy,
   tail: () => tail,
@@ -990,6 +991,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,
@@ -1052,6 +1070,7 @@ var lowerCase = (str) => {
   sampleSize,
   shuffle,
   snakeCase,
+  startCase,
   sum,
   sumBy,
   tail,