es-toolkit 1.9.0 → 1.10.0-dev.204

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # es-toolkit Changelog
 
+## Version v1.10.0
+
+Released on July 14th, 2024.
+
+### Features
+
+
+- Add support for [capitalize](https://es-toolkit.slash.page/reference/string/capitalize.html), [snakeCase](https://es-toolkit.slash.page/reference/string/snakeCase.html), [kebabCase](https://es-toolkit.slash.page/reference/string/kebabCase.html), [camelCase](https://es-toolkit.slash.page/reference/string/camelCase.html) and [lowerCase](https://es-toolkit.slash.page/reference/string/lowerCase.html). (https://github.com/toss/es-toolkit/pull/152, https://github.com/toss/es-toolkit/pull/161, https://github.com/toss/es-toolkit/pull/162, https://github.com/toss/es-toolkit/pull/166, [21d6530](https://github.com/toss/es-toolkit/commit/21d6530e16471d596410d57d59fd3ced8fc5569f)).
+- Add support for [negate](https://es-toolkit.slash.page/reference/function/negate.html). (https://github.com/toss/es-toolkit/pull/177)
+- Add support for [isEqual](https://es-toolkit.slash.page/reference/predicate/isEqual.html). (https://github.com/toss/es-toolkit/pull/174)
+- Add support for [clone](https://es-toolkit.slash.page/reference/object/clone.html). (https://github.com/toss/es-toolkit/pull/155)
+- Add support for [toFilled](https://es-toolkit.slash.page/reference/array/toFilled.html). (https://github.com/toss/es-toolkit/pull/154)
+- Add support for [initial](https://es-toolkit.slash.page/reference/array/initial.html) and [last](https://es-toolkit.slash.page/reference/array/last.html). (https://github.com/toss/es-toolkit/pull/188, https://github.com/toss/es-toolkit/pull/149)
+- Add support for [flattenDeep](https://es-toolkit.slash.page/reference/array/flattenDeep.html). (https://github.com/toss/es-toolkit/pull/160)
+
+### Performance Improvements
+
+- Optimize the performance of [isNil](https://es-toolkit.slash.page/reference/predicate/isNil.html) by simplifying its check. ([489ac76](https://github.com/toss/es-toolkit/commit/489ac76fc62f97cbfa3ca9eec2e0a4c03c4f5b1c))
+- Optimize the performance of [sum](https://es-toolkit.slash.page/reference/array/sum.html). (https://github.com/toss/es-toolkit/pull/155)
+
+
+
 ## Version v1.9.0
 
 Released on July 10th, 2024.
@@ -8,7 +30,6 @@ Released on July 10th, 2024.
 - Add support for [unzip](https://es-toolkit.slash.page/reference/array/unzip.html). (https://github.com/toss/es-toolkit/pull/130)
 - Add support for [flatten](https://es-toolkit.slash.page/reference/array/flatten.html), which is six times faster than `Array#flat`. (https://github.com/toss/es-toolkit/pull/147)
 
-
 ## Version v1.8.0
 
 Released on July 5th, 2024.

package/README.md

@@ -2,7 +2,7 @@
 
 # es-toolkit · [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/toss/slash/blob/main/LICENSE) [![codecov](https://codecov.io/gh/toss/es-toolkit/graph/badge.svg?token=8N5S3AR3C7)](https://codecov.io/gh/toss/es-toolkit) [![NPM badge](https://img.shields.io/npm/v/es-toolkit?logo=npm)](https://www.npmjs.com/package/es-toolkit) [![JSR badge](https://jsr.io/badges/@es-toolkit/es-toolkit)](https://jsr.io/@es-toolkit/es-toolkit)
 
-English | [한국어](https://github.com/toss/es-toolkit/blob/main/README-ko_kr.md)
+English | [한국어](https://github.com/toss/es-toolkit/blob/main/README-ko_kr.md) | [简体中文](https://github.com/toss/es-toolkit/blob/main/README-zh_hans.md)
 
 es-toolkit is a state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.
 

package/dist/array/chunk.mjs

@@ -1,7 +1,7 @@
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   chunk
 };

package/dist/array/compact.mjs

@@ -1,7 +1,7 @@
 import {
   compact
 } from "../chunk-DTJJIMKJ.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   compact
 };

package/dist/array/countBy.mjs

@@ -1,7 +1,7 @@
 import {
   countBy
 } from "../chunk-CRSKT4WW.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   countBy
 };

package/dist/array/difference.mjs

@@ -1,7 +1,7 @@
 import {
   difference
 } from "../chunk-JPUKH67K.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   difference
 };

package/dist/array/differenceBy.mjs

@@ -1,7 +1,7 @@
 import {
   differenceBy
 } from "../chunk-LVWX5B43.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   differenceBy
 };

package/dist/array/differenceWith.mjs

@@ -1,7 +1,7 @@
 import {
   differenceWith
 } from "../chunk-6NVQAHXP.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   differenceWith
 };

package/dist/array/drop.mjs

@@ -1,7 +1,7 @@
 import {
   drop
 } from "../chunk-S3CORED5.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   drop
 };

package/dist/array/dropRight.mjs

@@ -1,7 +1,7 @@
 import {
   dropRight
 } from "../chunk-JEKUA56R.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   dropRight
 };

package/dist/array/dropRightWhile.mjs

@@ -2,7 +2,7 @@ import {
   dropRightWhile
 } from "../chunk-JE6JKZU3.mjs";
 import "../chunk-LJ2C6MVP.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   dropRightWhile
 };

package/dist/array/dropWhile.mjs

@@ -1,7 +1,7 @@
 import {
   dropWhile
 } from "../chunk-LJ2C6MVP.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   dropWhile
 };

package/dist/array/fill.mjs

@@ -1,7 +1,7 @@
 import {
   fill
 } from "../chunk-C4WE4GLC.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   fill
 };

package/dist/array/flatten.mjs

@@ -1,7 +1,7 @@
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   flatten
 };

package/dist/array/flattenDeep.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Utility type for recursively unpacking nested array types to extract the type of the innermost element
+ *
+ * @example
+ * ExtractNestedArrayType<(number | (number | number[])[])[]>
+ * // number
+ *
+ * ExtractNestedArrayType<(boolean | (string | number[])[])[]>
+ * // string | number | boolean
+ */
+type ExtractNestedArrayType<T> = T extends ReadonlyArray<infer U> ? ExtractNestedArrayType<U> : T;
+/**
+ * Flattens all depths of a nested array.
+ *
+ * @template T - The type of elements within the array.
+ * @param {T[]} arr - The array to flatten.
+ * @returns {Array<ExtractNestedArrayType<T>>} A new array that has been flattened.
+ *
+ * @example
+ * const arr = flattenDeep([1, [2, [3]], [4, [5, 6]]]);
+ * // Returns: [1, 2, 3, 4, 5, 6]
+ */
+declare function flattenDeep<T>(arr: readonly T[]): Array<ExtractNestedArrayType<T>>;
+
+export { flattenDeep };

package/dist/array/flattenDeep.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Utility type for recursively unpacking nested array types to extract the type of the innermost element
+ *
+ * @example
+ * ExtractNestedArrayType<(number | (number | number[])[])[]>
+ * // number
+ *
+ * ExtractNestedArrayType<(boolean | (string | number[])[])[]>
+ * // string | number | boolean
+ */
+type ExtractNestedArrayType<T> = T extends ReadonlyArray<infer U> ? ExtractNestedArrayType<U> : T;
+/**
+ * Flattens all depths of a nested array.
+ *
+ * @template T - The type of elements within the array.
+ * @param {T[]} arr - The array to flatten.
+ * @returns {Array<ExtractNestedArrayType<T>>} A new array that has been flattened.
+ *
+ * @example
+ * const arr = flattenDeep([1, [2, [3]], [4, [5, 6]]]);
+ * // Returns: [1, 2, 3, 4, 5, 6]
+ */
+declare function flattenDeep<T>(arr: readonly T[]): Array<ExtractNestedArrayType<T>>;
+
+export { flattenDeep };

package/dist/array/flattenDeep.js

@@ -0,0 +1,52 @@
+"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/array/flattenDeep.ts
+var flattenDeep_exports = {};
+__export(flattenDeep_exports, {
+  flattenDeep: () => flattenDeep
+});
+module.exports = __toCommonJS(flattenDeep_exports);
+
+// src/array/flatten.ts
+function flatten(arr, depth = 1) {
+  const result = [];
+  const flooredDepth = Math.floor(depth);
+  const recursive = (arr2, currentDepth) => {
+    for (const item of arr2) {
+      if (Array.isArray(item) && currentDepth < flooredDepth) {
+        recursive(item, currentDepth + 1);
+      } else {
+        result.push(item);
+      }
+    }
+  };
+  recursive(arr, 0);
+  return result;
+}
+
+// src/array/flattenDeep.ts
+function flattenDeep(arr) {
+  return flatten(arr, Infinity);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  flattenDeep
+});
+//# sourceMappingURL=flattenDeep.js.map

package/dist/array/flattenDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/array/flattenDeep.ts","../../src/array/flatten.ts"],"sourcesContent":["import { flatten } from './flatten.ts';\n\n/**\n * Utility type for recursively unpacking nested array types to extract the type of the innermost element\n *\n * @example\n * ExtractNestedArrayType<(number | (number | number[])[])[]>\n * // number\n *\n * ExtractNestedArrayType<(boolean | (string | number[])[])[]>\n * // string | number | boolean\n */\ntype ExtractNestedArrayType<T> = T extends ReadonlyArray<infer U> ? ExtractNestedArrayType<U> : T;\n\n/**\n * Flattens all depths of a nested array.\n *\n * @template T - The type of elements within the array.\n * @param {T[]} arr - The array to flatten.\n * @returns {Array<ExtractNestedArrayType<T>>} A new array that has been flattened.\n *\n * @example\n * const arr = flattenDeep([1, [2, [3]], [4, [5, 6]]]);\n * // Returns: [1, 2, 3, 4, 5, 6]\n */\nexport function flattenDeep<T>(arr: readonly T[]): Array<ExtractNestedArrayType<T>> {\n  return flatten(arr, Infinity) as Array<ExtractNestedArrayType<T>>;\n}\n","/**\n * Flattens an array up to the specified depth.\n *\n * @template T - The type of elements within the array.\n * @template D - The depth to which the array should be flattened.\n * @param {T[]} arr - The array to flatten.\n * @param {D} depth - The depth level specifying how deep a nested array structure should be flattened. Defaults to 1.\n * @returns {Array<FlatArray<T[], D>>} A new array that has been flattened.\n *\n * @example\n * const arr = flatten([1, [2, 3], [4, [5, 6]]], 1);\n * // Returns: [1, 2, 3, 4, [5, 6]]\n *\n * const arr = flatten([1, [2, 3], [4, [5, 6]]], 2);\n * // Returns: [1, 2, 3, 4, 5, 6]\n */\nexport function flatten<T, D extends number = 1>(arr: readonly T[], depth = 1 as D): Array<FlatArray<T[], D>> {\n  const result: Array<FlatArray<T[], D>> = [];\n  const flooredDepth = Math.floor(depth);\n\n  const recursive = (arr: readonly T[], currentDepth: number) => {\n    for (const item of arr) {\n      if (Array.isArray(item) && currentDepth < flooredDepth) {\n        recursive(item, currentDepth + 1);\n      } else {\n        result.push(item as FlatArray<T[], D>);\n      }\n    }\n  };\n\n  recursive(arr, 0);\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACgBO,SAAS,QAAiC,KAAmB,QAAQ,GAAkC;AAC5G,QAAM,SAAmC,CAAC;AAC1C,QAAM,eAAe,KAAK,MAAM,KAAK;AAErC,QAAM,YAAY,CAACA,MAAmB,iBAAyB;AAC7D,eAAW,QAAQA,MAAK;AACtB,UAAI,MAAM,QAAQ,IAAI,KAAK,eAAe,cAAc;AACtD,kBAAU,MAAM,eAAe,CAAC;AAAA,MAClC,OAAO;AACL,eAAO,KAAK,IAAyB;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAEA,YAAU,KAAK,CAAC;AAChB,SAAO;AACT;;;ADPO,SAAS,YAAe,KAAqD;AAClF,SAAO,QAAQ,KAAK,QAAQ;AAC9B;","names":["arr"]}

package/dist/array/flattenDeep.mjs

@@ -0,0 +1,9 @@
+import {
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
+import "../chunk-33MSBDC6.mjs";
+import "../chunk-2HIMLZE3.mjs";
+export {
+  flattenDeep
+};
+//# sourceMappingURL=flattenDeep.mjs.map

package/dist/array/forEachRight.mjs

@@ -1,7 +1,7 @@
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   forEachRight
 };

package/dist/array/groupBy.mjs

@@ -1,7 +1,7 @@
 import {
   groupBy
 } from "../chunk-E6E4RZLN.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   groupBy
 };

package/dist/array/head.mjs

@@ -1,7 +1,7 @@
 import {
   head
 } from "../chunk-HM2JT2RX.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-2HIMLZE3.mjs";
 export {
   head
 };

package/dist/array/index.d.mts

@@ -10,6 +10,7 @@ export { dropRightWhile } from './dropRightWhile.mjs';
 export { dropWhile } from './dropWhile.mjs';
 export { fill } from './fill.mjs';
 export { flatten } from './flatten.mjs';
+export { flattenDeep } from './flattenDeep.mjs';
 export { forEachRight } from './forEachRight.mjs';
 export { groupBy } from './groupBy.mjs';
 export { intersection } from './intersection.mjs';
@@ -44,3 +45,6 @@ export { zipWith } from './zipWith.mjs';
 export { without } from './without.mjs';
 export { head } from './head.mjs';
 export { tail } from './tail.mjs';
+export { toFilled } from './toFilled.mjs';
+export { last } from './last.mjs';
+export { initial } from './initial.mjs';

package/dist/array/index.d.ts

@@ -10,6 +10,7 @@ export { dropRightWhile } from './dropRightWhile.js';
 export { dropWhile } from './dropWhile.js';
 export { fill } from './fill.js';
 export { flatten } from './flatten.js';
+export { flattenDeep } from './flattenDeep.js';
 export { forEachRight } from './forEachRight.js';
 export { groupBy } from './groupBy.js';
 export { intersection } from './intersection.js';
@@ -44,3 +45,6 @@ export { zipWith } from './zipWith.js';
 export { without } from './without.js';
 export { head } from './head.js';
 export { tail } from './tail.js';
+export { toFilled } from './toFilled.js';
+export { last } from './last.js';
+export { initial } from './initial.js';

package/dist/array/index.js

@@ -32,13 +32,16 @@ __export(array_exports, {
   dropWhile: () => dropWhile,
   fill: () => fill,
   flatten: () => flatten,
+  flattenDeep: () => flattenDeep,
   forEachRight: () => forEachRight,
   groupBy: () => groupBy,
   head: () => head,
+  initial: () => initial,
   intersection: () => intersection,
   intersectionBy: () => intersectionBy,
   intersectionWith: () => intersectionWith,
   keyBy: () => keyBy,
+  last: () => last,
   maxBy: () => maxBy,
   minBy: () => minBy,
   orderBy: () => orderBy,
@@ -51,6 +54,7 @@ __export(array_exports, {
   takeRight: () => takeRight,
   takeRightWhile: () => takeRightWhile,
   takeWhile: () => takeWhile,
+  toFilled: () => toFilled,
   union: () => union,
   unionBy: () => unionBy,
   unionWith: () => unionWith,
@@ -182,6 +186,11 @@ function flatten(arr, depth = 1) {
   return result;
 }
 
+// src/array/flattenDeep.ts
+function flattenDeep(arr) {
+  return flatten(arr, Infinity);
+}
+
 // src/array/forEachRight.ts
 function forEachRight(arr, callback) {
   for (let i = arr.length - 1; i >= 0; i--) {
@@ -550,6 +559,31 @@ function tail(arr) {
   }
   return result;
 }
+
+// src/array/toFilled.ts
+function toFilled(arr, value, start = 0, end = arr.length) {
+  const length = arr.length;
+  const finalStart = Math.max(start >= 0 ? start : length + start, 0);
+  const finalEnd = Math.min(end >= 0 ? end : length + end, length);
+  const newArr = arr.slice();
+  for (let i = finalStart; i < finalEnd; i++) {
+    newArr[i] = value;
+  }
+  return newArr;
+}
+
+// src/array/last.ts
+function last(arr) {
+  return arr[arr.length - 1];
+}
+
+// src/array/initial.ts
+function initial(arr) {
+  if (arr.length <= 1) {
+    return [];
+  }
+  return arr.slice(0, -1);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   chunk,
@@ -564,13 +598,16 @@ function tail(arr) {
   dropWhile,
   fill,
   flatten,
+  flattenDeep,
   forEachRight,
   groupBy,
   head,
+  initial,
   intersection,
   intersectionBy,
   intersectionWith,
   keyBy,
+  last,
   maxBy,
   minBy,
   orderBy,
@@ -583,6 +620,7 @@ function tail(arr) {
   takeRight,
   takeRightWhile,
   takeWhile,
+  toFilled,
   union,
   unionBy,
   unionWith,