es-toolkit 1.12.0 → 1.13.0

package/dist/compat/index.js

@@ -62,10 +62,11 @@ __export(compat_exports, {
   clamp: () => clamp,
   clone: () => clone,
   compact: () => compact,
+  concat: () => concat,
   countBy: () => countBy,
   debounce: () => debounce,
   delay: () => delay,
-  difference: () => difference,
+  difference: () => difference2,
   differenceBy: () => differenceBy,
   differenceWith: () => differenceWith,
   drop: () => drop,
@@ -74,9 +75,11 @@ __export(compat_exports, {
   dropWhile: () => dropWhile,
   endsWith: () => endsWith,
   fill: () => fill,
+  first: () => head,
   flatMap: () => flatMap,
   flatten: () => flatten,
   flattenDeep: () => flattenDeep,
+  flattenObject: () => flattenObject,
   forEachRight: () => forEachRight,
   get: () => get,
   groupBy: () => groupBy,
@@ -88,9 +91,11 @@ __export(compat_exports, {
   intersectionWith: () => intersectionWith,
   invert: () => invert,
   isEqual: () => isEqual,
+  isLength: () => isLength,
   isNil: () => isNil,
   isNotNil: () => isNotNil,
   isNull: () => isNull,
+  isPlainObject: () => isPlainObject2,
   isUndefined: () => isUndefined,
   kebabCase: () => kebabCase,
   keyBy: () => keyBy,
@@ -924,6 +929,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)) {
@@ -977,6 +1029,11 @@ function isUndefined(x) {
   return x === void 0;
 }
 
+// src/predicate/isLength.ts
+function isLength(value) {
+  return typeof value === "number" && value > -1 && value % 1 === 0 && value <= Number.MAX_SAFE_INTEGER;
+}
+
 // src/promise/delay.ts
 function delay(ms, { signal } = {}) {
   return new Promise((resolve, reject) => {
@@ -1076,6 +1133,18 @@ function chunk2(arr, size = 1) {
   return chunk(arr, size);
 }
 
+// src/compat/array/concat.ts
+function concat(...values) {
+  return flatten(values);
+}
+
+// src/compat/array/difference.ts
+function difference2(arr, ...values) {
+  const arr1 = arr;
+  const arr2 = flatten(values);
+  return difference(arr1, arr2);
+}
+
 // src/compat/_internal/isIndex.ts
 var IS_UNSIGNED_INTEGER = /^(?:0|[1-9]\d*)$/;
 function isIndex(value) {
@@ -1197,6 +1266,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);
@@ -1242,6 +1341,7 @@ function min(items = []) {
   clamp,
   clone,
   compact,
+  concat,
   countBy,
   debounce,
   delay,
@@ -1254,9 +1354,11 @@ function min(items = []) {
   dropWhile,
   endsWith,
   fill,
+  first,
   flatMap,
   flatten,
   flattenDeep,
+  flattenObject,
   forEachRight,
   get,
   groupBy,
@@ -1268,9 +1370,11 @@ function min(items = []) {
   intersectionWith,
   invert,
   isEqual,
+  isLength,
   isNil,
   isNotNil,
   isNull,
+  isPlainObject,
   isUndefined,
   kebabCase,
   keyBy,