es-toolkit 1.12.0 → 1.13.0

package/dist/index.mjs

@@ -1,71 +1,86 @@
-import "./chunk-NKLIE2OI.mjs";
-import "./chunk-4OIZM4HS.mjs";
-import {
-  withTimeout
-} from "./chunk-XWPCDIFC.mjs";
-import "./chunk-J3GE7DEU.mjs";
+import "./chunk-SPKLWVNJ.mjs";
 import "./chunk-XT74R35S.mjs";
+import {
+  kebabCase
+} from "./chunk-EYYZQFOP.mjs";
+import {
+  lowerCase
+} from "./chunk-5IKVJGHO.mjs";
 import {
   snakeCase
 } from "./chunk-F3WCQQET.mjs";
 import {
   startCase
 } from "./chunk-QXTNZR7B.mjs";
+import "./chunk-4OIZM4HS.mjs";
+import {
+  withTimeout
+} from "./chunk-IIDZ3KAJ.mjs";
+import "./chunk-CVVZHOJX.mjs";
+import {
+  delay
+} from "./chunk-O64NE2P4.mjs";
 import {
   camelCase
 } from "./chunk-Y5V7UAZZ.mjs";
 import {
   capitalize
 } from "./chunk-U56ZOM7L.mjs";
+import "./chunk-WVQ7YVRK.mjs";
+import "./chunk-B645AYL4.mjs";
 import {
-  kebabCase
-} from "./chunk-EYYZQFOP.mjs";
+  isNull
+} from "./chunk-AIRSKN47.mjs";
 import {
-  lowerCase
-} from "./chunk-5IKVJGHO.mjs";
-import "./chunk-WVQ7YVRK.mjs";
-import "./chunk-ASJF5D6C.mjs";
+  isUndefined
+} from "./chunk-VH2PV426.mjs";
 import {
   isEqual
 } from "./chunk-JYSV56US.mjs";
+import {
+  isLength
+} from "./chunk-27QMXBLJ.mjs";
 import {
   isNil
 } from "./chunk-WMM7TZLG.mjs";
 import {
   isNotNil
 } from "./chunk-BMRTZMRE.mjs";
+import "./chunk-54TK5BIS.mjs";
 import {
-  isNull
-} from "./chunk-AIRSKN47.mjs";
-import {
-  isUndefined
-} from "./chunk-VH2PV426.mjs";
+  omitBy
+} from "./chunk-BCTYOXT7.mjs";
 import {
-  delay
-} from "./chunk-O64NE2P4.mjs";
-import "./chunk-OSOLEQLZ.mjs";
+  pick
+} from "./chunk-HPFDYUGP.mjs";
 import {
   pickBy
 } from "./chunk-6CLH5YZ2.mjs";
 import {
   clone
 } from "./chunk-U4JGKZ56.mjs";
+import {
+  flattenObject
+} from "./chunk-XGQWTHW6.mjs";
+import {
+  isPlainObject
+} from "./chunk-MIGAC7F4.mjs";
 import {
   invert
 } from "./chunk-OLX53VEF.mjs";
 import {
   omit
-} from "./chunk-U7V3G7CR.mjs";
-import {
-  omitBy
-} from "./chunk-BCTYOXT7.mjs";
-import {
-  pick
-} from "./chunk-HPFDYUGP.mjs";
+} from "./chunk-WFZXCGEG.mjs";
 import "./chunk-FUS75PJ7.mjs";
+import {
+  round
+} from "./chunk-5PMKOZ2F.mjs";
 import {
   sumBy
 } from "./chunk-5L4VWRFX.mjs";
+import {
+  clamp
+} from "./chunk-MLCL773E.mjs";
 import {
   inRange
 } from "./chunk-BH6HLGBA.mjs";
@@ -81,13 +96,10 @@ import {
 import {
   range
 } from "./chunk-DPH2KE6O.mjs";
-import {
-  round
-} from "./chunk-5PMKOZ2F.mjs";
-import {
-  clamp
-} from "./chunk-MLCL773E.mjs";
 import "./chunk-DDH7K4QM.mjs";
+import {
+  unzipWith
+} from "./chunk-IFNXROZR.mjs";
 import {
   without
 } from "./chunk-PYEYV7BY.mjs";
@@ -109,6 +121,9 @@ import {
 import {
   zipWith
 } from "./chunk-4KYXHZ4R.mjs";
+import {
+  toFilled
+} from "./chunk-OP4OAKQJ.mjs";
 import {
   union
 } from "./chunk-R6QA7PLZ.mjs";
@@ -131,8 +146,8 @@ import {
   unzip
 } from "./chunk-UYZKMBDO.mjs";
 import {
-  unzipWith
-} from "./chunk-IFNXROZR.mjs";
+  sample
+} from "./chunk-2KNLZB7V.mjs";
 import {
   sampleSize
 } from "./chunk-EHSKB6DF.mjs";
@@ -147,7 +162,7 @@ import {
 } from "./chunk-G7UQ5PUR.mjs";
 import {
   tail
-} from "./chunk-OF6NM4G7.mjs";
+} from "./chunk-TJ4Z5I7M.mjs";
 import {
   take
 } from "./chunk-ME352XO7.mjs";
@@ -161,8 +176,8 @@ import {
   takeWhile
 } from "./chunk-2IXFGSUA.mjs";
 import {
-  toFilled
-} from "./chunk-OP4OAKQJ.mjs";
+  intersectionBy
+} from "./chunk-O6UXZR3U.mjs";
 import {
   intersectionWith
 } from "./chunk-XI7KRD2C.mjs";
@@ -184,9 +199,6 @@ import {
 import {
   partition
 } from "./chunk-DN3NOZ3H.mjs";
-import {
-  sample
-} from "./chunk-2KNLZB7V.mjs";
 import {
   flattenDeep
 } from "./chunk-ML727RRJ.mjs";
@@ -206,8 +218,8 @@ import {
   intersection
 } from "./chunk-FVVSE2F2.mjs";
 import {
-  intersectionBy
-} from "./chunk-O6UXZR3U.mjs";
+  differenceBy
+} from "./chunk-LVWX5B43.mjs";
 import {
   differenceWith
 } from "./chunk-6NVQAHXP.mjs";
@@ -244,9 +256,6 @@ import {
 import {
   difference
 } from "./chunk-JPUKH67K.mjs";
-import {
-  differenceBy
-} from "./chunk-LVWX5B43.mjs";
 import "./chunk-F47GLYUU.mjs";
 import {
   AbortError
@@ -255,6 +264,9 @@ import {
   TimeoutError
 } from "./chunk-KIOYQRMQ.mjs";
 import "./chunk-236H5JZJ.mjs";
+import {
+  negate
+} from "./chunk-BOOQBJN2.mjs";
 import {
   noop
 } from "./chunk-LKXCOLNY.mjs";
@@ -267,10 +279,7 @@ import {
 import {
   debounce
 } from "./chunk-3IP4JVLL.mjs";
-import {
-  negate
-} from "./chunk-BOOQBJN2.mjs";
-import "./chunk-424M7IR7.mjs";
+import "./chunk-24FKGR6U.mjs";
 export {
   AbortError,
   TimeoutError,
@@ -294,6 +303,7 @@ export {
   flatMap,
   flatten,
   flattenDeep,
+  flattenObject,
   forEachRight,
   groupBy,
   head,
@@ -304,9 +314,11 @@ export {
   intersectionWith,
   invert,
   isEqual,
+  isLength,
   isNil,
   isNotNil,
   isNull,
+  isPlainObject,
   isUndefined,
   kebabCase,
   keyBy,

package/dist/math/clamp.mjs

@@ -1,7 +1,7 @@
 import {
   clamp
 } from "../chunk-MLCL773E.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   clamp
 };

package/dist/math/inRange.mjs

@@ -1,7 +1,7 @@
 import {
   inRange
 } from "../chunk-BH6HLGBA.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   inRange
 };

package/dist/math/index.mjs

@@ -1,7 +1,13 @@
 import "../chunk-FUS75PJ7.mjs";
+import {
+  round
+} from "../chunk-5PMKOZ2F.mjs";
 import {
   sumBy
 } from "../chunk-5L4VWRFX.mjs";
+import {
+  clamp
+} from "../chunk-MLCL773E.mjs";
 import {
   inRange
 } from "../chunk-BH6HLGBA.mjs";
@@ -17,19 +23,13 @@ import {
 import {
   range
 } from "../chunk-DPH2KE6O.mjs";
-import {
-  round
-} from "../chunk-5PMKOZ2F.mjs";
-import {
-  clamp
-} from "../chunk-MLCL773E.mjs";
 import {
   randomInt
 } from "../chunk-GIWAOOFY.mjs";
 import {
   random
 } from "../chunk-SYWMYQYJ.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   clamp,
   inRange,

package/dist/math/mean.mjs

@@ -2,7 +2,7 @@ import {
   mean
 } from "../chunk-5ASRKEB4.mjs";
 import "../chunk-2SLTL4KL.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   mean
 };

package/dist/math/meanBy.mjs

@@ -3,7 +3,7 @@ import {
 } from "../chunk-MY4G7R3I.mjs";
 import "../chunk-5ASRKEB4.mjs";
 import "../chunk-2SLTL4KL.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   meanBy
 };

package/dist/math/random.mjs

@@ -1,7 +1,7 @@
 import {
   random
 } from "../chunk-SYWMYQYJ.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   random
 };

package/dist/math/randomInt.mjs

@@ -2,7 +2,7 @@ import {
   randomInt
 } from "../chunk-GIWAOOFY.mjs";
 import "../chunk-SYWMYQYJ.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   randomInt
 };

package/dist/math/range.mjs

@@ -1,7 +1,7 @@
 import {
   range
 } from "../chunk-DPH2KE6O.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   range
 };

package/dist/math/round.mjs

@@ -1,7 +1,7 @@
 import {
   round
 } from "../chunk-5PMKOZ2F.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   round
 };

package/dist/math/sum.mjs

@@ -1,7 +1,7 @@
 import {
   sum
 } from "../chunk-2SLTL4KL.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   sum
 };

package/dist/math/sumBy.mjs

@@ -2,7 +2,7 @@ import {
   sumBy
 } from "../chunk-5L4VWRFX.mjs";
 import "../chunk-2SLTL4KL.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   sumBy
 };

package/dist/object/clone.mjs

@@ -1,7 +1,7 @@
 import {
   clone
 } from "../chunk-U4JGKZ56.mjs";
-import "../chunk-424M7IR7.mjs";
+import "../chunk-24FKGR6U.mjs";
 export {
   clone
 };

package/dist/object/flattenObject.d.mts

@@ -0,0 +1,28 @@
+/**
+ * Flattens a nested object into a single level object with dot-separated keys.
+ *
+ * @param {object} object - The object to flatten.
+ * @returns {Record<string, any>} - The flattened object.
+ *
+ * @example
+ * const nestedObject = {
+ *   a: {
+ *     b: {
+ *       c: 1
+ *     }
+ *   },
+ *   d: [2, 3]
+ * };
+ *
+ * const flattened = flattenObject(nestedObject);
+ * console.log(flattened);
+ * // Output:
+ * // {
+ * //   'a.b.c': 1,
+ * //   'd.0': 2,
+ * //   'd.1': 3
+ * // }
+ */
+declare function flattenObject(object: object): Record<string, any>;
+
+export { flattenObject };

package/dist/object/flattenObject.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Flattens a nested object into a single level object with dot-separated keys.
+ *
+ * @param {object} object - The object to flatten.
+ * @returns {Record<string, any>} - The flattened object.
+ *
+ * @example
+ * const nestedObject = {
+ *   a: {
+ *     b: {
+ *       c: 1
+ *     }
+ *   },
+ *   d: [2, 3]
+ * };
+ *
+ * const flattened = flattenObject(nestedObject);
+ * console.log(flattened);
+ * // Output:
+ * // {
+ * //   'a.b.c': 1,
+ * //   'd.0': 2,
+ * //   'd.1': 3
+ * // }
+ */
+declare function flattenObject(object: object): Record<string, any>;
+
+export { flattenObject };

package/dist/object/flattenObject.js

@@ -0,0 +1,77 @@
+"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/object/flattenObject.ts
+var flattenObject_exports = {};
+__export(flattenObject_exports, {
+  flattenObject: () => flattenObject
+});
+module.exports = __toCommonJS(flattenObject_exports);
+
+// src/predicate/isPlainObject.ts
+function isPlainObject(object) {
+  if (typeof object !== "object") {
+    return false;
+  }
+  if (object == null) {
+    return false;
+  }
+  if (Object.getPrototypeOf(object) === null) {
+    return true;
+  }
+  if (object.toString() !== "[object Object]") {
+    return false;
+  }
+  let proto = object;
+  while (Object.getPrototypeOf(proto) !== null) {
+    proto = Object.getPrototypeOf(proto);
+  }
+  return Object.getPrototypeOf(object) === proto;
+}
+
+// src/object/flattenObject.ts
+function flattenObject(object) {
+  return flattenObjectImpl(object);
+}
+function flattenObjectImpl(object, prefix = "") {
+  const result = {};
+  const keys = Object.keys(object);
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    const value = object[key];
+    const prefixedKey = prefix ? `${prefix}.${key}` : key;
+    if (isPlainObject(value) && Object.keys(value).length > 0) {
+      Object.assign(result, flattenObjectImpl(value, prefixedKey));
+      continue;
+    }
+    if (Array.isArray(value)) {
+      for (let index = 0; index < value.length; index++) {
+        result[`${prefixedKey}.${index}`] = value[index];
+      }
+      continue;
+    }
+    result[prefixedKey] = value;
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  flattenObject
+});
+//# sourceMappingURL=flattenObject.js.map

package/dist/object/flattenObject.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/object/flattenObject.ts","../../src/predicate/isPlainObject.ts"],"sourcesContent":["import { isPlainObject } from \"../predicate/isPlainObject.ts\";\n\n/**\n * Flattens a nested object into a single level object with dot-separated keys.\n * \n * @param {object} object - The object to flatten.\n * @returns {Record<string, any>} - The flattened object.\n * \n * @example\n * const nestedObject = {\n *   a: {\n *     b: {\n *       c: 1\n *     }\n *   },\n *   d: [2, 3]\n * };\n * \n * const flattened = flattenObject(nestedObject);\n * console.log(flattened); \n * // Output:\n * // {\n * //   'a.b.c': 1,\n * //   'd.0': 2,\n * //   'd.1': 3\n * // }\n */\nexport function flattenObject(object: object): Record<string, any> {\n  return flattenObjectImpl(object);\n}\n\nfunction flattenObjectImpl(object: object, prefix = ''): Record<string, any> {\n  const result: Record<string, any> = {};\n  const keys = Object.keys(object);\n\n  for (let i = 0; i < keys.length; i++) {\n    const key = keys[i];\n    const value = (object as any)[key];\n\n    const prefixedKey = prefix ? `${prefix}.${key}` : key;\n\n    if (isPlainObject(value) && Object.keys(value).length > 0) {\n      Object.assign(result, flattenObjectImpl(value, prefixedKey));\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      for (let index = 0; index < value.length; index++) {\n        result[`${prefixedKey}.${index}`] = value[index];\n      }\n      continue;\n    }\n\n    result[prefixedKey] = value;\n  }\n\n  return result;\n}","/**\n * Checks if a given value is a plain object.\n * \n * @param {object} object - The value to check.\n * @returns {boolean} - True if the value is a plain object, otherwise false.\n * \n * @example\n * console.log(isPlainObject({})); // true\n * console.log(isPlainObject([])); // false\n * console.log(isPlainObject(null)); // false\n * console.log(isPlainObject(Object.create(null))); // true\n * console.log(Buffer.from('hello, world')); // false\n */\nexport function isPlainObject(object: object): boolean {\n  if (typeof object !== 'object') {\n    return false;\n  }\n\n  if (object == null) {\n    return false;\n  }\n\n  if (Object.getPrototypeOf(object) === null) {\n    return true;\n  }\n\n  if (object.toString() !== '[object Object]') {\n    return false;\n  }\n\n  let proto = object;\n\n  while (Object.getPrototypeOf(proto) !== null) {\n    proto = Object.getPrototypeOf(proto);\n  }\n\n  return Object.getPrototypeOf(object) === proto;\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,SAAS,cAAc,QAAyB;AACrD,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,MAAM;AAClB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,eAAe,MAAM,MAAM,MAAM;AAC1C,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,SAAS,MAAM,mBAAmB;AAC3C,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ;AAEZ,SAAO,OAAO,eAAe,KAAK,MAAM,MAAM;AAC5C,YAAQ,OAAO,eAAe,KAAK;AAAA,EACrC;AAEA,SAAO,OAAO,eAAe,MAAM,MAAM;AAC3C;;;ADVO,SAAS,cAAc,QAAqC;AACjE,SAAO,kBAAkB,MAAM;AACjC;AAEA,SAAS,kBAAkB,QAAgB,SAAS,IAAyB;AAC3E,QAAM,SAA8B,CAAC;AACrC,QAAM,OAAO,OAAO,KAAK,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,QAAS,OAAe,GAAG;AAEjC,UAAM,cAAc,SAAS,GAAG,MAAM,IAAI,GAAG,KAAK;AAElD,QAAI,cAAc,KAAK,KAAK,OAAO,KAAK,KAAK,EAAE,SAAS,GAAG;AACzD,aAAO,OAAO,QAAQ,kBAAkB,OAAO,WAAW,CAAC;AAC3D;AAAA,IACF;AAEA,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,eAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;AACjD,eAAO,GAAG,WAAW,IAAI,KAAK,EAAE,IAAI,MAAM,KAAK;AAAA,MACjD;AACA;AAAA,IACF;AAEA,WAAO,WAAW,IAAI;AAAA,EACxB;AAEA,SAAO;AACT;","names":[]}

package/dist/object/flattenObject.mjs

@@ -0,0 +1,9 @@
+import {
+  flattenObject
+} from "../chunk-XGQWTHW6.mjs";
+import "../chunk-MIGAC7F4.mjs";
+import "../chunk-24FKGR6U.mjs";
+export {
+  flattenObject
+};
+//# sourceMappingURL=flattenObject.mjs.map

package/dist/object/index.d.mts

@@ -4,3 +4,4 @@ export { pick } from './pick.mjs';
 export { pickBy } from './pickBy.mjs';
 export { invert } from './invert.mjs';
 export { clone } from './clone.mjs';
+export { flattenObject } from './flattenObject.mjs';

package/dist/object/index.d.ts

@@ -4,3 +4,4 @@ export { pick } from './pick.js';
 export { pickBy } from './pickBy.js';
 export { invert } from './invert.js';
 export { clone } from './clone.js';
+export { flattenObject } from './flattenObject.js';

package/dist/object/index.js

@@ -35,6 +35,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var object_exports = {};
 __export(object_exports, {
   clone: () => clone,
+  flattenObject: () => flattenObject,
   invert: () => invert,
   omit: () => omit,
   omitBy: () => omitBy,
@@ -133,9 +134,57 @@ function clone(obj) {
 function isPrimitive(value) {
   return value == null || typeof value !== "object" && typeof value !== "function";
 }
+
+// src/predicate/isPlainObject.ts
+function isPlainObject(object) {
+  if (typeof object !== "object") {
+    return false;
+  }
+  if (object == null) {
+    return false;
+  }
+  if (Object.getPrototypeOf(object) === null) {
+    return true;
+  }
+  if (object.toString() !== "[object Object]") {
+    return false;
+  }
+  let proto = object;
+  while (Object.getPrototypeOf(proto) !== null) {
+    proto = Object.getPrototypeOf(proto);
+  }
+  return Object.getPrototypeOf(object) === proto;
+}
+
+// src/object/flattenObject.ts
+function flattenObject(object) {
+  return flattenObjectImpl(object);
+}
+function flattenObjectImpl(object, prefix = "") {
+  const result = {};
+  const keys = Object.keys(object);
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    const value = object[key];
+    const prefixedKey = prefix ? `${prefix}.${key}` : key;
+    if (isPlainObject(value) && Object.keys(value).length > 0) {
+      Object.assign(result, flattenObjectImpl(value, prefixedKey));
+      continue;
+    }
+    if (Array.isArray(value)) {
+      for (let index = 0; index < value.length; index++) {
+        result[`${prefixedKey}.${index}`] = value[index];
+      }
+      continue;
+    }
+    result[prefixedKey] = value;
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clone,
+  flattenObject,
   invert,
   omit,
   omitBy,