es-toolkit 1.12.0-dev.281 → 1.12.0-dev.282

package/dist/array/index.mjs

@@ -1,4 +1,13 @@
 import "../chunk-DDH7K4QM.mjs";
+import {
+  zipWith
+} from "../chunk-4KYXHZ4R.mjs";
+import {
+  unzip
+} from "../chunk-UYZKMBDO.mjs";
+import {
+  unzipWith
+} from "../chunk-IFNXROZR.mjs";
 import {
   without
 } from "../chunk-PYEYV7BY.mjs";
@@ -18,8 +27,11 @@ import {
   zipObject
 } from "../chunk-6GWEY5EL.mjs";
 import {
-  zipWith
-} from "../chunk-4KYXHZ4R.mjs";
+  takeWhile
+} from "../chunk-2IXFGSUA.mjs";
+import {
+  toFilled
+} from "../chunk-OP4OAKQJ.mjs";
 import {
   union
 } from "../chunk-R6QA7PLZ.mjs";
@@ -39,11 +51,11 @@ import {
   uniqWith
 } from "../chunk-237HGSZS.mjs";
 import {
-  unzip
-} from "../chunk-UYZKMBDO.mjs";
+  partition
+} from "../chunk-DN3NOZ3H.mjs";
 import {
-  unzipWith
-} from "../chunk-IFNXROZR.mjs";
+  sample
+} from "../chunk-2KNLZB7V.mjs";
 import {
   sampleSize
 } from "../chunk-EHSKB6DF.mjs";
@@ -65,11 +77,11 @@ import {
   takeRightWhile
 } from "../chunk-NTLX2MPV.mjs";
 import {
-  takeWhile
-} from "../chunk-2IXFGSUA.mjs";
+  intersection
+} from "../chunk-FVVSE2F2.mjs";
 import {
-  toFilled
-} from "../chunk-OP4OAKQJ.mjs";
+  intersectionBy
+} from "../chunk-O6UXZR3U.mjs";
 import {
   intersectionWith
 } from "../chunk-XI7KRD2C.mjs";
@@ -89,14 +101,14 @@ import {
   orderBy
 } from "../chunk-7B7W36UP.mjs";
 import {
-  partition
-} from "../chunk-DN3NOZ3H.mjs";
-import {
-  sample
-} from "../chunk-2KNLZB7V.mjs";
+  flatMap
+} from "../chunk-UY76KTPE.mjs";
 import {
   flattenDeep
 } from "../chunk-ML727RRJ.mjs";
+import {
+  flatten
+} from "../chunk-33MSBDC6.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -110,11 +122,11 @@ import {
   initial
 } from "../chunk-XPSOKBRZ.mjs";
 import {
-  intersection
-} from "../chunk-FVVSE2F2.mjs";
+  difference
+} from "../chunk-JPUKH67K.mjs";
 import {
-  intersectionBy
-} from "../chunk-O6UXZR3U.mjs";
+  differenceBy
+} from "../chunk-LVWX5B43.mjs";
 import {
   differenceWith
 } from "../chunk-6NVQAHXP.mjs";
@@ -133,12 +145,6 @@ import {
 import {
   fill
 } from "../chunk-YFN6KOC4.mjs";
-import {
-  flatMap
-} from "../chunk-UY76KTPE.mjs";
-import {
-  flatten
-} from "../chunk-33MSBDC6.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -148,12 +154,6 @@ import {
 import {
   countBy
 } from "../chunk-CRSKT4WW.mjs";
-import {
-  difference
-} from "../chunk-JPUKH67K.mjs";
-import {
-  differenceBy
-} from "../chunk-LVWX5B43.mjs";
 import "../chunk-424M7IR7.mjs";
 export {
   chunk,

package/dist/{chunk-Y5V7UAZZ.mjs → chunk-32AEPQYI.mjs}

@@ -1,9 +1,9 @@
-import {
-  capitalize
-} from "./chunk-U56ZOM7L.mjs";
 import {
   getWords
 } from "./chunk-WVQ7YVRK.mjs";
+import {
+  capitalize
+} from "./chunk-U56ZOM7L.mjs";
 
 // src/string/camelCase.ts
 function camelCase(str) {
@@ -18,4 +18,4 @@ function camelCase(str) {
 export {
   camelCase
 };
-//# sourceMappingURL=chunk-Y5V7UAZZ.mjs.map
+//# sourceMappingURL=chunk-32AEPQYI.mjs.map

package/dist/chunk-54TK5BIS.mjs

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

package/dist/chunk-MIGAC7F4.mjs

@@ -0,0 +1,25 @@
+// 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;
+}
+
+export {
+  isPlainObject
+};
+//# sourceMappingURL=chunk-MIGAC7F4.mjs.map

package/dist/chunk-MIGAC7F4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/predicate/isPlainObject.ts"],"sourcesContent":["/**\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":";AAaO,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;","names":[]}

package/dist/chunk-WGX4WINP.mjs

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

package/dist/chunk-XGQWTHW6.mjs

@@ -0,0 +1,34 @@
+import {
+  isPlainObject
+} from "./chunk-MIGAC7F4.mjs";
+
+// 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;
+}
+
+export {
+  flattenObject
+};
+//# sourceMappingURL=chunk-XGQWTHW6.mjs.map

package/dist/chunk-XGQWTHW6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/object/flattenObject.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}"],"mappings":";;;;;AA2BO,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/compat/index.d.mts

@@ -70,6 +70,7 @@ export { pick } from '../object/pick.mjs';
 export { pickBy } from '../object/pickBy.mjs';
 export { invert } from '../object/invert.mjs';
 export { clone } from '../object/clone.mjs';
+export { flattenObject } from '../object/flattenObject.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
 export { isNil } from '../predicate/isNil.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
@@ -457,6 +458,30 @@ declare function get(object: unknown, path: PropertyKey | readonly PropertyKey[]
  */
 declare function set<T>(obj: object, path: PropertyKey | readonly PropertyKey[], value: unknown): T;
 
+/**
+ * Checks if a given value is a plain object.
+ *
+ * A plain object is an object created by the `{}` literal, `new Object()`, or
+ * `Object.create(null)`.
+ *
+ * This function also handles objects with custom
+ * `Symbol.toStringTag` properties.
+ *
+ * `Symbol.toStringTag` is a built-in symbol that a constructor can use to customize the
+ * default string description of objects.
+ *
+ * @param {unknown} [object] - The value to check.
+ * @returns {boolean} - True if the value is a plain object, otherwise false.
+ *
+ * @example
+ * console.log(isPlainObject({})); // true
+ * console.log(isPlainObject([])); // false
+ * console.log(isPlainObject(null)); // false
+ * console.log(isPlainObject(Object.create(null))); // true
+ * console.log(isPlainObject(new Map())); // false
+ */
+declare function isPlainObject(object?: unknown): boolean;
+
 /**
  * Checks if a string contains another string at the beginning of the string.
  *
@@ -527,4 +552,4 @@ declare function max<T>(items?: readonly T[]): T;
  */
 declare function min<T>(items?: readonly T[]): T;
 
-export { chunk, concat, difference, endsWith, get, max, min, set, startsWith, zipObjectDeep };
+export { chunk, concat, difference, endsWith, get, isPlainObject, max, min, set, startsWith, zipObjectDeep };

package/dist/compat/index.d.ts

@@ -70,6 +70,7 @@ export { pick } from '../object/pick.js';
 export { pickBy } from '../object/pickBy.js';
 export { invert } from '../object/invert.js';
 export { clone } from '../object/clone.js';
+export { flattenObject } from '../object/flattenObject.js';
 export { isEqual } from '../predicate/isEqual.js';
 export { isNil } from '../predicate/isNil.js';
 export { isNotNil } from '../predicate/isNotNil.js';
@@ -457,6 +458,30 @@ declare function get(object: unknown, path: PropertyKey | readonly PropertyKey[]
  */
 declare function set<T>(obj: object, path: PropertyKey | readonly PropertyKey[], value: unknown): T;
 
+/**
+ * Checks if a given value is a plain object.
+ *
+ * A plain object is an object created by the `{}` literal, `new Object()`, or
+ * `Object.create(null)`.
+ *
+ * This function also handles objects with custom
+ * `Symbol.toStringTag` properties.
+ *
+ * `Symbol.toStringTag` is a built-in symbol that a constructor can use to customize the
+ * default string description of objects.
+ *
+ * @param {unknown} [object] - The value to check.
+ * @returns {boolean} - True if the value is a plain object, otherwise false.
+ *
+ * @example
+ * console.log(isPlainObject({})); // true
+ * console.log(isPlainObject([])); // false
+ * console.log(isPlainObject(null)); // false
+ * console.log(isPlainObject(Object.create(null))); // true
+ * console.log(isPlainObject(new Map())); // false
+ */
+declare function isPlainObject(object?: unknown): boolean;
+
 /**
  * Checks if a string contains another string at the beginning of the string.
  *
@@ -527,4 +552,4 @@ declare function max<T>(items?: readonly T[]): T;
  */
 declare function min<T>(items?: readonly T[]): T;
 
-export { chunk, concat, difference, endsWith, get, max, min, set, startsWith, zipObjectDeep };
+export { chunk, concat, difference, endsWith, get, isPlainObject, max, min, set, startsWith, zipObjectDeep };

package/dist/compat/index.js

@@ -79,6 +79,7 @@ __export(compat_exports, {
   flatMap: () => flatMap,
   flatten: () => flatten,
   flattenDeep: () => flattenDeep,
+  flattenObject: () => flattenObject,
   forEachRight: () => forEachRight,
   get: () => get,
   groupBy: () => groupBy,
@@ -93,6 +94,7 @@ __export(compat_exports, {
   isNil: () => isNil,
   isNotNil: () => isNotNil,
   isNull: () => isNull,
+  isPlainObject: () => isPlainObject2,
   isUndefined: () => isUndefined,
   kebabCase: () => kebabCase,
   keyBy: () => keyBy,
@@ -926,6 +928,53 @@ 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;
+}
+
 // src/predicate/isEqual.ts
 function isEqual(a, b) {
   if (Object.is(a, b)) {
@@ -1211,6 +1260,36 @@ function get(object, path, defaultValue) {
   return current != null ? current : defaultValue;
 }
 
+// src/compat/predicate/isPlainObject.ts
+function isPlainObject2(object) {
+  var _a;
+  if (typeof object !== "object") {
+    return false;
+  }
+  if (object == null) {
+    return false;
+  }
+  if (Object.getPrototypeOf(object) === null) {
+    return true;
+  }
+  if (object.toString() !== "[object Object]") {
+    const tag = object[Symbol.toStringTag];
+    if (tag == null) {
+      return false;
+    }
+    const isTagReadonly = !((_a = Object.getOwnPropertyDescriptor(object, Symbol.toStringTag)) == null ? void 0 : _a.writable);
+    if (isTagReadonly) {
+      return false;
+    }
+    return object.toString() === `[object ${tag}]`;
+  }
+  let proto = object;
+  while (Object.getPrototypeOf(proto) !== null) {
+    proto = Object.getPrototypeOf(proto);
+  }
+  return Object.getPrototypeOf(object) === proto;
+}
+
 // src/compat/string/startsWith.ts
 var startsWith = (str, target, position = 0) => {
   return str.startsWith(target, position);
@@ -1273,6 +1352,7 @@ function min(items = []) {
   flatMap,
   flatten,
   flattenDeep,
+  flattenObject,
   forEachRight,
   get,
   groupBy,
@@ -1287,6 +1367,7 @@ function min(items = []) {
   isNil,
   isNotNil,
   isNull,
+  isPlainObject,
   isUndefined,
   kebabCase,
   keyBy,