es-toolkit 1.9.0-dev.177 → 1.9.0-dev.179

package/dist/index.mjs

@@ -2,11 +2,17 @@ import "./chunk-ARZ5BDR6.mjs";
 import {
   delay
 } from "./chunk-O64NE2P4.mjs";
-import "./chunk-YOFIBRET.mjs";
+import "./chunk-MPBVTIU3.mjs";
+import {
+  capitalize
+} from "./chunk-U56ZOM7L.mjs";
 import {
   snakeCase
 } from "./chunk-VRFIBW4H.mjs";
 import "./chunk-MAJSPFA6.mjs";
+import {
+  isUndefined
+} from "./chunk-VH2PV426.mjs";
 import {
   isNil
 } from "./chunk-OHQAR5AU.mjs";
@@ -16,10 +22,10 @@ import {
 import {
   isNull
 } from "./chunk-AIRSKN47.mjs";
-import {
-  isUndefined
-} from "./chunk-VH2PV426.mjs";
 import "./chunk-PMHULJNL.mjs";
+import {
+  omit
+} from "./chunk-QZITBKWX.mjs";
 import {
   omitBy
 } from "./chunk-BCTYOXT7.mjs";
@@ -32,10 +38,10 @@ import {
 import {
   invert
 } from "./chunk-74WWMNZS.mjs";
-import {
-  omit
-} from "./chunk-QZITBKWX.mjs";
 import "./chunk-TLVQSNOE.mjs";
+import {
+  meanBy
+} from "./chunk-IZAD2S7R.mjs";
 import {
   range
 } from "./chunk-DPH2KE6O.mjs";
@@ -48,35 +54,13 @@ import {
 import {
   inRange
 } from "./chunk-BH6HLGBA.mjs";
-import {
-  meanBy
-} from "./chunk-IZAD2S7R.mjs";
 import {
   mean
 } from "./chunk-GDC64SYJ.mjs";
 import {
   sum
 } from "./chunk-2SLTL4KL.mjs";
-import "./chunk-N6EM6ETS.mjs";
-import {
-  noop
-} from "./chunk-LKXCOLNY.mjs";
-import {
-  once
-} from "./chunk-CMBC4MXG.mjs";
-import {
-  throttle
-} from "./chunk-QOJGMVVR.mjs";
-import {
-  debounce
-} from "./chunk-3IP4JVLL.mjs";
-import "./chunk-NLN3GQ7D.mjs";
-import {
-  xor
-} from "./chunk-L7FQX5MN.mjs";
-import {
-  xorBy
-} from "./chunk-Q47NGNXT.mjs";
+import "./chunk-OJSIDS6H.mjs";
 import {
   xorWith
 } from "./chunk-QRSJBBFY.mjs";
@@ -89,18 +73,9 @@ import {
 import {
   zipWith
 } from "./chunk-4KYXHZ4R.mjs";
-import {
-  unionBy
-} from "./chunk-NFS7RWWE.mjs";
-import {
-  unionWith
-} from "./chunk-2ZCITDMK.mjs";
 import {
   uniqBy
 } from "./chunk-OXAZEEGP.mjs";
-import {
-  uniqWith
-} from "./chunk-237HGSZS.mjs";
 import {
   unzip
 } from "./chunk-UYZKMBDO.mjs";
@@ -111,11 +86,11 @@ import {
   without
 } from "./chunk-PYEYV7BY.mjs";
 import {
-  shuffle
-} from "./chunk-G7UQ5PUR.mjs";
+  xor
+} from "./chunk-L7FQX5MN.mjs";
 import {
-  tail
-} from "./chunk-OF6NM4G7.mjs";
+  xorBy
+} from "./chunk-Q47NGNXT.mjs";
 import {
   take
 } from "./chunk-ME352XO7.mjs";
@@ -138,11 +113,14 @@ import {
   uniq
 } from "./chunk-DVK2N4KC.mjs";
 import {
-  keyBy
-} from "./chunk-AJKZMN2V.mjs";
+  unionBy
+} from "./chunk-NFS7RWWE.mjs";
 import {
-  last
-} from "./chunk-KPBQ7OUY.mjs";
+  unionWith
+} from "./chunk-2ZCITDMK.mjs";
+import {
+  uniqWith
+} from "./chunk-237HGSZS.mjs";
 import {
   maxBy
 } from "./chunk-OOKNBU4V.mjs";
@@ -168,11 +146,11 @@ import {
   random
 } from "./chunk-SYWMYQYJ.mjs";
 import {
-  flatten
-} from "./chunk-33MSBDC6.mjs";
+  shuffle
+} from "./chunk-G7UQ5PUR.mjs";
 import {
-  forEachRight
-} from "./chunk-IEA53J7P.mjs";
+  tail
+} from "./chunk-OF6NM4G7.mjs";
 import {
   groupBy
 } from "./chunk-E6E4RZLN.mjs";
@@ -189,14 +167,11 @@ import {
   intersectionWith
 } from "./chunk-XI7KRD2C.mjs";
 import {
-  difference
-} from "./chunk-JPUKH67K.mjs";
-import {
-  differenceBy
-} from "./chunk-LVWX5B43.mjs";
+  keyBy
+} from "./chunk-AJKZMN2V.mjs";
 import {
-  differenceWith
-} from "./chunk-6NVQAHXP.mjs";
+  last
+} from "./chunk-KPBQ7OUY.mjs";
 import {
   drop
 } from "./chunk-S3CORED5.mjs";
@@ -212,12 +187,15 @@ import {
 import {
   fill
 } from "./chunk-C4WE4GLC.mjs";
-import "./chunk-2M3YVRFS.mjs";
-import "./chunk-T5URDZEQ.mjs";
-import "./chunk-FZEZH22H.mjs";
 import {
-  AbortError
-} from "./chunk-DXB7EZUQ.mjs";
+  flattenDeep
+} from "./chunk-HJPB4KC3.mjs";
+import {
+  flatten
+} from "./chunk-33MSBDC6.mjs";
+import {
+  forEachRight
+} from "./chunk-IEA53J7P.mjs";
 import {
   chunk
 } from "./chunk-E6C5EZQA.mjs";
@@ -227,9 +205,38 @@ import {
 import {
   countBy
 } from "./chunk-CRSKT4WW.mjs";
+import {
+  difference
+} from "./chunk-JPUKH67K.mjs";
+import {
+  differenceBy
+} from "./chunk-LVWX5B43.mjs";
+import {
+  differenceWith
+} from "./chunk-6NVQAHXP.mjs";
+import "./chunk-2M3YVRFS.mjs";
+import "./chunk-T5URDZEQ.mjs";
+import "./chunk-FZEZH22H.mjs";
+import {
+  AbortError
+} from "./chunk-DXB7EZUQ.mjs";
+import "./chunk-N6EM6ETS.mjs";
+import {
+  once
+} from "./chunk-CMBC4MXG.mjs";
+import {
+  throttle
+} from "./chunk-QOJGMVVR.mjs";
+import {
+  debounce
+} from "./chunk-3IP4JVLL.mjs";
+import {
+  noop
+} from "./chunk-LKXCOLNY.mjs";
 import "./chunk-2MM5EJJX.mjs";
 export {
   AbortError,
+  capitalize,
   chunk,
   clamp,
   compact,
@@ -245,6 +252,7 @@ export {
   dropWhile,
   fill,
   flatten,
+  flattenDeep,
   forEachRight,
   groupBy,
   head,

package/dist/math/index.mjs

@@ -1,4 +1,7 @@
 import "../chunk-TLVQSNOE.mjs";
+import {
+  meanBy
+} from "../chunk-IZAD2S7R.mjs";
 import {
   range
 } from "../chunk-DPH2KE6O.mjs";
@@ -11,9 +14,6 @@ import {
 import {
   inRange
 } from "../chunk-BH6HLGBA.mjs";
-import {
-  meanBy
-} from "../chunk-IZAD2S7R.mjs";
 import {
   mean
 } from "../chunk-GDC64SYJ.mjs";

package/dist/object/index.mjs

@@ -1,4 +1,7 @@
 import "../chunk-PMHULJNL.mjs";
+import {
+  omit
+} from "../chunk-QZITBKWX.mjs";
 import {
   omitBy
 } from "../chunk-BCTYOXT7.mjs";
@@ -11,9 +14,6 @@ import {
 import {
   invert
 } from "../chunk-74WWMNZS.mjs";
-import {
-  omit
-} from "../chunk-QZITBKWX.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   invert,

package/dist/predicate/index.mjs

@@ -1,4 +1,7 @@
 import "../chunk-MAJSPFA6.mjs";
+import {
+  isUndefined
+} from "../chunk-VH2PV426.mjs";
 import {
   isNil
 } from "../chunk-OHQAR5AU.mjs";
@@ -8,9 +11,6 @@ import {
 import {
   isNull
 } from "../chunk-AIRSKN47.mjs";
-import {
-  isUndefined
-} from "../chunk-VH2PV426.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   isNil,

package/dist/string/capitalize.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Converts the first character of string to upper case and the remaining to lower case.
+ *
+ * @template T - Literal type of the string.
+ * @param {T} str - The string to be converted to uppercase.
+ * @returns {Capitalize<T>} - The capitalized string.
+ *
+ * @example
+ * const result = capitalize('fred') // returns 'Fred'
+ * const result2 = capitalize('FRED') // returns 'Fred'
+ */
+declare const capitalize: <T extends string>(str: T) => Capitalize<T>;
+
+export { capitalize };

package/dist/string/capitalize.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Converts the first character of string to upper case and the remaining to lower case.
+ *
+ * @template T - Literal type of the string.
+ * @param {T} str - The string to be converted to uppercase.
+ * @returns {Capitalize<T>} - The capitalized string.
+ *
+ * @example
+ * const result = capitalize('fred') // returns 'Fred'
+ * const result2 = capitalize('FRED') // returns 'Fred'
+ */
+declare const capitalize: <T extends string>(str: T) => Capitalize<T>;
+
+export { capitalize };

package/dist/string/capitalize.js

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/string/capitalize.ts
+var capitalize_exports = {};
+__export(capitalize_exports, {
+  capitalize: () => capitalize
+});
+module.exports = __toCommonJS(capitalize_exports);
+var capitalize = (str) => {
+  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  capitalize
+});
+//# sourceMappingURL=capitalize.js.map

package/dist/string/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/string/capitalize.ts"],"sourcesContent":["/**\n * Converts the first character of string to upper case and the remaining to lower case.\n *\n * @template T - Literal type of the string.\n * @param {T} str - The string to be converted to uppercase.\n * @returns {Capitalize<T>} - The capitalized string.\n *\n * @example\n * const result = capitalize('fred') // returns 'Fred'\n * const result2 = capitalize('FRED') // returns 'Fred'\n */\n\nexport const capitalize = <T extends string>(str: T): Capitalize<T> => {\n  return (str.charAt(0).toUpperCase() + str.slice(1).toLowerCase()) as Capitalize<T>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAYO,IAAM,aAAa,CAAmB,QAA0B;AACrE,SAAQ,IAAI,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC,EAAE,YAAY;AACjE;","names":[]}

package/dist/string/capitalize.mjs

@@ -0,0 +1,8 @@
+import {
+  capitalize
+} from "../chunk-U56ZOM7L.mjs";
+import "../chunk-2MM5EJJX.mjs";
+export {
+  capitalize
+};
+//# sourceMappingURL=capitalize.mjs.map

package/dist/string/capitalize.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/string/index.d.mts

@@ -1 +1,2 @@
 export { snakeCase } from './snakeCase.mjs';
+export { capitalize } from './capitalize.mjs';

package/dist/string/index.d.ts

@@ -1 +1,2 @@
 export { snakeCase } from './snakeCase.js';
+export { capitalize } from './capitalize.js';

package/dist/string/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/string/index.ts
 var string_exports = {};
 __export(string_exports, {
+  capitalize: () => capitalize,
   snakeCase: () => snakeCase
 });
 module.exports = __toCommonJS(string_exports);
@@ -32,8 +33,14 @@ var snakeCase = (str) => {
   const splitWords = str.match(CASE_SPLIT_PATTERN) || [];
   return splitWords.map((word) => word.toLowerCase()).join("_");
 };
+
+// src/string/capitalize.ts
+var capitalize = (str) => {
+  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  capitalize,
   snakeCase
 });
 //# sourceMappingURL=index.js.map

package/dist/string/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/string/index.ts","../../src/constants/caseSplitPattern.ts","../../src/string/snakeCase.ts"],"sourcesContent":["export { snakeCase } from './snakeCase.ts';\n","/**\n * Regular expression pattern to split strings into words for various case conversions\n *\n * This pattern matchs sequences of characters in a string, considering the following case:\n * - Sequences of two or more uppercase letters followed by an uppercase letter and lowercase letters or digits (for acronyms)\n * - Sequences of one uppercase letter optionally followed by lowercase letters and digits\n * - Single uppercase letters\n * - Sequences of digis\n *\n * The resulting match can be used to convert camelCase, snake_case, kebab-case, and other mixed formats into\n * a consistent format like snake case.\n *\n * @example\n * const matches = 'camelCaseHTTPRequest'.match(CASE_SPLIT_PATTERN);\n * // matchs: ['camel', 'Case', 'HTTP', 'Request']\n */\n\nexport const CASE_SPLIT_PATTERN = /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g;\n","import { CASE_SPLIT_PATTERN } from '../constants';\n\n/**\n * Converts a string to snake case.\n *\n * Snake case is the naming convention in which each word is written in lowercase and separated by an underscore (_) character.\n *\n * @param {string} str - The string that is to be changed to snake case.\n * @returns {string} - The converted string to snake case.\n *\n * @example\n * const convertedStr1 = snakeCase('camelCase') // returns 'camel_case'\n * const convertedStr2 = snakeCase('some whitespace') // returns 'some_whitespace'\n * const convertedStr3 = snakeCase('hyphen-text') // returns 'hyphen_text'\n * const convertedStr4 = snakeCase('HTTPRequest') // returns 'http_request'\n */\n\nexport const snakeCase = (str: string): string => {\n  const splitWords = str.match(CASE_SPLIT_PATTERN) || [];\n  return splitWords.map(word => word.toLowerCase()).join('_');\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBO,IAAM,qBAAqB;;;ACA3B,IAAM,YAAY,CAAC,QAAwB;AAChD,QAAM,aAAa,IAAI,MAAM,kBAAkB,KAAK,CAAC;AACrD,SAAO,WAAW,IAAI,UAAQ,KAAK,YAAY,CAAC,EAAE,KAAK,GAAG;AAC5D;","names":[]}
+{"version":3,"sources":["../../src/string/index.ts","../../src/constants/caseSplitPattern.ts","../../src/string/snakeCase.ts","../../src/string/capitalize.ts"],"sourcesContent":["export { snakeCase } from './snakeCase.ts';\nexport { capitalize } from './capitalize.ts';\n","/**\n * Regular expression pattern to split strings into words for various case conversions\n *\n * This pattern matchs sequences of characters in a string, considering the following case:\n * - Sequences of two or more uppercase letters followed by an uppercase letter and lowercase letters or digits (for acronyms)\n * - Sequences of one uppercase letter optionally followed by lowercase letters and digits\n * - Single uppercase letters\n * - Sequences of digis\n *\n * The resulting match can be used to convert camelCase, snake_case, kebab-case, and other mixed formats into\n * a consistent format like snake case.\n *\n * @example\n * const matches = 'camelCaseHTTPRequest'.match(CASE_SPLIT_PATTERN);\n * // matchs: ['camel', 'Case', 'HTTP', 'Request']\n */\n\nexport const CASE_SPLIT_PATTERN = /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g;\n","import { CASE_SPLIT_PATTERN } from '../constants';\n\n/**\n * Converts a string to snake case.\n *\n * Snake case is the naming convention in which each word is written in lowercase and separated by an underscore (_) character.\n *\n * @param {string} str - The string that is to be changed to snake case.\n * @returns {string} - The converted string to snake case.\n *\n * @example\n * const convertedStr1 = snakeCase('camelCase') // returns 'camel_case'\n * const convertedStr2 = snakeCase('some whitespace') // returns 'some_whitespace'\n * const convertedStr3 = snakeCase('hyphen-text') // returns 'hyphen_text'\n * const convertedStr4 = snakeCase('HTTPRequest') // returns 'http_request'\n */\n\nexport const snakeCase = (str: string): string => {\n  const splitWords = str.match(CASE_SPLIT_PATTERN) || [];\n  return splitWords.map(word => word.toLowerCase()).join('_');\n};\n","/**\n * Converts the first character of string to upper case and the remaining to lower case.\n *\n * @template T - Literal type of the string.\n * @param {T} str - The string to be converted to uppercase.\n * @returns {Capitalize<T>} - The capitalized string.\n *\n * @example\n * const result = capitalize('fred') // returns 'Fred'\n * const result2 = capitalize('FRED') // returns 'Fred'\n */\n\nexport const capitalize = <T extends string>(str: T): Capitalize<T> => {\n  return (str.charAt(0).toUpperCase() + str.slice(1).toLowerCase()) as Capitalize<T>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBO,IAAM,qBAAqB;;;ACA3B,IAAM,YAAY,CAAC,QAAwB;AAChD,QAAM,aAAa,IAAI,MAAM,kBAAkB,KAAK,CAAC;AACrD,SAAO,WAAW,IAAI,UAAQ,KAAK,YAAY,CAAC,EAAE,KAAK,GAAG;AAC5D;;;ACRO,IAAM,aAAa,CAAmB,QAA0B;AACrE,SAAQ,IAAI,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC,EAAE,YAAY;AACjE;","names":[]}

package/dist/string/index.mjs

@@ -1,4 +1,7 @@
-import "../chunk-YOFIBRET.mjs";
+import "../chunk-MPBVTIU3.mjs";
+import {
+  capitalize
+} from "../chunk-U56ZOM7L.mjs";
 import {
   snakeCase
 } from "../chunk-VRFIBW4H.mjs";
@@ -6,6 +9,7 @@ import "../chunk-2M3YVRFS.mjs";
 import "../chunk-T5URDZEQ.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
+  capitalize,
   snakeCase
 };
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.9.0-dev.177+34be6d76",
+  "version": "1.9.0-dev.179+16d326c4",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

package/dist/chunk-NLN3GQ7D.mjs

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

package/dist/chunk-YOFIBRET.mjs

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