es-toolkit 1.50.0-dev.2057 → 1.50.0-dev.2059

package/dist/function/rest.js

@@ -24,7 +24,7 @@
 *
 * // Using start index 1
 * const transformedFnWithStart = rest(fn, 1);
-* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
 *
 * // With fewer arguments than the start index
 * console.log(transformedFn(1)); // [1, undefined, []]

package/dist/function/rest.mjs

@@ -24,7 +24,7 @@
 *
 * // Using start index 1
 * const transformedFnWithStart = rest(fn, 1);
-* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
 *
 * // With fewer arguments than the start index
 * console.log(transformedFn(1)); // [1, undefined, []]

package/dist/object/cloneDeepWith.d.mts

@@ -34,7 +34,9 @@
  * // Clone an array with a customizer
  * const arr = [1, 2, 3];
  * const clonedArr = cloneDeepWith(arr, (value) => {
- *   return value + 1; // Increment each value
+ *   if (typeof value === 'number') {
+ *     return value + 1; // Increment each number
+ *   }
  * });
  * console.log(clonedArr); // [2, 3, 4]
  * console.log(clonedArr === arr); // false

package/dist/object/cloneDeepWith.d.ts

@@ -34,7 +34,9 @@
  * // Clone an array with a customizer
  * const arr = [1, 2, 3];
  * const clonedArr = cloneDeepWith(arr, (value) => {
- *   return value + 1; // Increment each value
+ *   if (typeof value === 'number') {
+ *     return value + 1; // Increment each number
+ *   }
  * });
  * console.log(clonedArr); // [2, 3, 4]
  * console.log(clonedArr === arr); // false

package/dist/object/cloneDeepWith.js

@@ -40,7 +40,9 @@ const require_isBuffer = require("../predicate/isBuffer.js");
 * // Clone an array with a customizer
 * const arr = [1, 2, 3];
 * const clonedArr = cloneDeepWith(arr, (value) => {
-*   return value + 1; // Increment each value
+*   if (typeof value === 'number') {
+*     return value + 1; // Increment each number
+*   }
 * });
 * console.log(clonedArr); // [2, 3, 4]
 * console.log(clonedArr === arr); // false

package/dist/object/cloneDeepWith.mjs

@@ -40,7 +40,9 @@ import { isBuffer } from "../predicate/isBuffer.mjs";
 * // Clone an array with a customizer
 * const arr = [1, 2, 3];
 * const clonedArr = cloneDeepWith(arr, (value) => {
-*   return value + 1; // Increment each value
+*   if (typeof value === 'number') {
+*     return value + 1; // Increment each number
+*   }
 * });
 * console.log(clonedArr); // [2, 3, 4]
 * console.log(clonedArr === arr); // false

package/dist/object/flattenObject.d.mts

@@ -5,12 +5,18 @@ interface FlattenObjectOptions {
    * @default '.'
    */
   delimiter?: string;
+  /**
+   * If true, arrays are kept as values instead of being flattened.
+   * @default false
+   */
+  preserveArrays?: boolean;
 }
 /**
  * Flattens a nested object into a single level object with delimiter-separated keys.
  *
  * @param object - The object to flatten.
  * @param [options.delimiter='.'] - The delimiter to use between nested keys.
+ * @param [options.preserveArrays=false] - If true, arrays are kept as values instead of being flattened.
  * @returns The flattened object.
  *
  * @example
@@ -31,9 +37,18 @@ interface FlattenObjectOptions {
  * //   'd.0': 2,
  * //   'd.1': 3
  * // }
+ *
+ * const preserved = flattenObject(nestedObject, { preserveArrays: true });
+ * console.log(preserved);
+ * // Output:
+ * // {
+ * //   'a.b.c': 1,
+ * //   'd': [2, 3]
+ * // }
  */
 declare function flattenObject(object: object, {
-  delimiter
+  delimiter,
+  preserveArrays
 }?: FlattenObjectOptions): Record<string, any>;
 //#endregion
 export { flattenObject };

package/dist/object/flattenObject.d.ts

@@ -5,12 +5,18 @@ interface FlattenObjectOptions {
    * @default '.'
    */
   delimiter?: string;
+  /**
+   * If true, arrays are kept as values instead of being flattened.
+   * @default false
+   */
+  preserveArrays?: boolean;
 }
 /**
  * Flattens a nested object into a single level object with delimiter-separated keys.
  *
  * @param object - The object to flatten.
  * @param [options.delimiter='.'] - The delimiter to use between nested keys.
+ * @param [options.preserveArrays=false] - If true, arrays are kept as values instead of being flattened.
  * @returns The flattened object.
  *
  * @example
@@ -31,9 +37,18 @@ interface FlattenObjectOptions {
  * //   'd.0': 2,
  * //   'd.1': 3
  * // }
+ *
+ * const preserved = flattenObject(nestedObject, { preserveArrays: true });
+ * console.log(preserved);
+ * // Output:
+ * // {
+ * //   'a.b.c': 1,
+ * //   'd': [2, 3]
+ * // }
  */
 declare function flattenObject(object: object, {
-  delimiter
+  delimiter,
+  preserveArrays
 }?: FlattenObjectOptions): Record<string, any>;
 //#endregion
 export { flattenObject };

package/dist/object/flattenObject.js

@@ -5,6 +5,7 @@ const require_isPlainObject = require("../predicate/isPlainObject.js");
 *
 * @param object - The object to flatten.
 * @param [options.delimiter='.'] - The delimiter to use between nested keys.
+* @param [options.preserveArrays=false] - If true, arrays are kept as values instead of being flattened.
 * @returns The flattened object.
 *
 * @example
@@ -25,11 +26,19 @@ const require_isPlainObject = require("../predicate/isPlainObject.js");
 * //   'd.0': 2,
 * //   'd.1': 3
 * // }
+*
+* const preserved = flattenObject(nestedObject, { preserveArrays: true });
+* console.log(preserved);
+* // Output:
+* // {
+* //   'a.b.c': 1,
+* //   'd': [2, 3]
+* // }
 */
-function flattenObject(object, { delimiter = "." } = {}) {
-	return flattenObjectImpl(object, "", delimiter);
+function flattenObject(object, { delimiter = ".", preserveArrays = false } = {}) {
+	return flattenObjectImpl(object, "", delimiter, preserveArrays);
 }
-function flattenObjectImpl(object, prefix, delimiter) {
+function flattenObjectImpl(object, prefix, delimiter, preserveArrays) {
 	const result = {};
 	const keys = Object.keys(object);
 	for (let i = 0; i < keys.length; i++) {
@@ -37,11 +46,11 @@ function flattenObjectImpl(object, prefix, delimiter) {
 		const value = object[key];
 		const prefixedKey = prefix ? `${prefix}${delimiter}${key}` : key;
 		if (require_isPlainObject.isPlainObject(value) && Object.keys(value).length > 0) {
-			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter));
+			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter, preserveArrays));
 			continue;
 		}
-		if (Array.isArray(value) && value.length > 0) {
-			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter));
+		if (Array.isArray(value) && !preserveArrays && value.length > 0) {
+			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter, preserveArrays));
 			continue;
 		}
 		result[prefixedKey] = value;

package/dist/object/flattenObject.mjs

@@ -5,6 +5,7 @@ import { isPlainObject } from "../predicate/isPlainObject.mjs";
 *
 * @param object - The object to flatten.
 * @param [options.delimiter='.'] - The delimiter to use between nested keys.
+* @param [options.preserveArrays=false] - If true, arrays are kept as values instead of being flattened.
 * @returns The flattened object.
 *
 * @example
@@ -25,11 +26,19 @@ import { isPlainObject } from "../predicate/isPlainObject.mjs";
 * //   'd.0': 2,
 * //   'd.1': 3
 * // }
+*
+* const preserved = flattenObject(nestedObject, { preserveArrays: true });
+* console.log(preserved);
+* // Output:
+* // {
+* //   'a.b.c': 1,
+* //   'd': [2, 3]
+* // }
 */
-function flattenObject(object, { delimiter = "." } = {}) {
-	return flattenObjectImpl(object, "", delimiter);
+function flattenObject(object, { delimiter = ".", preserveArrays = false } = {}) {
+	return flattenObjectImpl(object, "", delimiter, preserveArrays);
 }
-function flattenObjectImpl(object, prefix, delimiter) {
+function flattenObjectImpl(object, prefix, delimiter, preserveArrays) {
 	const result = {};
 	const keys = Object.keys(object);
 	for (let i = 0; i < keys.length; i++) {
@@ -37,11 +46,11 @@ function flattenObjectImpl(object, prefix, delimiter) {
 		const value = object[key];
 		const prefixedKey = prefix ? `${prefix}${delimiter}${key}` : key;
 		if (isPlainObject(value) && Object.keys(value).length > 0) {
-			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter));
+			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter, preserveArrays));
 			continue;
 		}
-		if (Array.isArray(value) && value.length > 0) {
-			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter));
+		if (Array.isArray(value) && !preserveArrays && value.length > 0) {
+			Object.assign(result, flattenObjectImpl(value, prefixedKey, delimiter, preserveArrays));
 			continue;
 		}
 		result[prefixedKey] = value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.50.0-dev.2057+21c76cf3",
+  "version": "1.50.0-dev.2059+87fc74fc",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",
@@ -218,7 +218,8 @@
   "workspaces": [
     "docs",
     "benchmarks",
-    "tests/types"
+    "tests/types",
+    "tests/browser-compat"
   ],
   "scripts": {
     "bench": "yarn workspace benchmarks bench",
@@ -250,6 +251,8 @@
     "broken-link-checker": "0.7.8",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-compat": "^7.0.2",
+    "eslint-plugin-es-x": "^10.0.0",
     "eslint-plugin-no-for-of-array": "^0.0.1",
     "eslint-plugin-prettier": "^5.2.1",
     "eslint-plugin-vue": "^9.28.0",