moderndash 2.1.3 → 2.2.0

package/README.md

@@ -63,7 +63,7 @@ npm install moderndash
 
 ## 🚀 Performance
 
-ModernDash aims to outperform Lodash and deliver lightning-fast utility functions. Performance is not an afterthought, but a top priority. You can expect ModernDash to match or even exceed the performance of Lodash in most benchmarks, ensuring that your project stays speedy and efficient.
+ModernDash aims to outperform Lodash and deliver lightning-fast utility functions. Performance is not an afterthought, but a top priority. You can expect ModernDash to exceed or at least match the performance of Lodash in most benchmarks, ensuring that your project stays speedy and efficient.
 
 **[[ Benchmark Results](https://github.com/Maggi64/moderndash/blob/main/benchmark/RESULTS.md) ]**
 
@@ -84,4 +84,4 @@ To [type-fest](https://github.com/sindresorhus/type-fest) for providing some val
 
 ## 🧰 Contribute
 
-Check the [contribute](https://github.com/Maggi64/moderndash/blob/main/CONTRIBUTE.md) section!
+Check the [contribute](https://github.com/Maggi64/moderndash/blob/main/CONTRIBUTE.md) section!

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(src_exports, {
   dropWhile: () => dropWhile,
   escapeHtml: () => escapeHtml,
   escapeRegExp: () => escapeRegExp,
+  flatKeys: () => flatKeys,
   group: () => group,
   hash: () => hash,
   intersection: () => intersection,
@@ -83,8 +84,8 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/array/chunk.ts
-function chunk(array, size) {
-  const intSize = Math.trunc(size);
+function chunk(array, chunkSize) {
+  const intSize = Math.trunc(chunkSize);
   if (array.length === 0 || intSize < 1) {
     return [];
   }
@@ -200,12 +201,10 @@ function intersection(arrayOrCompFn, ...arrays) {
 
 // src/array/range.ts
 function* range(start, end, step = 1) {
-  if (start > end) {
+  if (start > end)
     throw new Error("The start of the range must be less than or equal to the end.");
-  }
-  if (step <= 0) {
+  if (step <= 0)
     throw new Error("The step must be greater than 0.");
-  }
   for (let i = start; i <= end; i += step) {
     yield i;
   }
@@ -488,6 +487,29 @@ function isPlainObject(value) {
   return value?.constructor === Object;
 }
 
+// src/object/flatKeys.ts
+function flatKeys(obj) {
+  const result = {};
+  function addToResult(prefix, value) {
+    if (isPlainObject(value)) {
+      const flatObj = flatKeys(value);
+      for (const [flatKey, flatValue] of Object.entries(flatObj)) {
+        result[`${prefix}.${flatKey}`] = flatValue;
+      }
+    } else if (Array.isArray(value)) {
+      for (const [index, element] of value.entries()) {
+        addToResult(`${prefix}[${index}]`, element);
+      }
+    } else {
+      result[prefix] = value;
+    }
+  }
+  for (const [key, value] of Object.entries(obj)) {
+    addToResult(key, value);
+  }
+  return result;
+}
+
 // src/object/merge.ts
 function merge(target, ...sources) {
   const targetCopy = { ...target };
@@ -516,18 +538,28 @@ function omit(object, keysToOmit) {
 }
 
 // src/object/set.ts
+var validPathRegex = /^(?:[^.[\]]+(?:\[\d+])*(?:\.|\[\d+]))+(?:[^.[\]]+(?:\[\d+])*)+$/;
+var pathSplitRegex = /\.|(?=\[)/g;
+var matchBracketsRegex = /[[\]]/g;
 function set(obj, path, value) {
-  const pathParts = path.split(/[.[\]]/g).filter((x) => Boolean(x.trim()));
+  if (!validPathRegex.test(path))
+    throw new Error("Invalid path, look at the examples for the correct format.");
+  const pathParts = path.split(pathSplitRegex);
   let currentObj = obj;
   for (let index = 0; index < pathParts.length; index++) {
-    const key = pathParts[index];
+    const key = pathParts[index].replace(matchBracketsRegex, "");
     if (index === pathParts.length - 1) {
       currentObj[key] = value;
       break;
     }
-    const nextIsNumber = !Number.isNaN(Number.parseInt(pathParts[index + 1]));
-    if (currentObj[key] === void 0)
-      currentObj[key] = nextIsNumber ? [] : {};
+    const nextElemIn = pathParts[index + 1].startsWith("[") ? "array" : "object";
+    if (currentObj[key] === void 0) {
+      currentObj[key] = nextElemIn === "array" ? [] : {};
+    } else if (nextElemIn === "array" && !Array.isArray(currentObj[key])) {
+      currentObj[key] = [];
+    } else if (nextElemIn === "object" && !isPlainObject(currentObj[key])) {
+      currentObj[key] = {};
+    }
     currentObj = currentObj[key];
   }
   return obj;
@@ -684,17 +716,18 @@ async function tryCatch(promise) {
 }
 
 // src/string/splitWords.ts
+var splitWordsRegex = new RegExp(
+  "[^\\dA-Za-z]|(?<=[a-z])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])"
+  // lookahead for an uppercase letter followed by a lowercase letter
+);
 function splitWords(str) {
-  const regex = new RegExp(
-    "[^\\dA-Za-z]|(?<=[a-z])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])"
-    // lookahead for an uppercase letter followed by a lowercase letter
-  );
-  return str.split(regex).filter(Boolean);
+  return str.split(splitWordsRegex).filter(Boolean);
 }
 
 // src/string/deburr.ts
+var accentControlRegex = /[\u0300-\u036F]/g;
 function deburr(str) {
-  return str.normalize("NFD").replace(/[\u0300-\u036F]/g, "");
+  return str.normalize("NFD").replace(accentControlRegex, "");
 }
 
 // src/string/camelCase.ts
@@ -716,20 +749,22 @@ function capitalize(str) {
 }
 
 // src/string/escapeHtml.ts
+var charRegex = /["&'<>]/g;
+var escapeChars = /* @__PURE__ */ new Map([
+  ["&", "&amp;"],
+  ["<", "&lt;"],
+  [">", "&gt;"],
+  ["'", "&#39;"],
+  ['"', "&quot;"]
+]);
 function escapeHtml(str) {
-  const escapeChars = {
-    "&": "&amp;",
-    "<": "&lt;",
-    ">": "&gt;",
-    "'": "&#39;",
-    '"': "&quot;"
-  };
-  return str.replace(/["&'<>]/g, (char) => escapeChars[char]);
+  return str.replace(charRegex, (char) => escapeChars.get(char));
 }
 
 // src/string/escapeRegExp.ts
+var escapleCharsRegex = /[$()*+.?[\\\]^{|}]/g;
 function escapeRegExp(str) {
-  return str.replace(/[$()*+.?[\\\]^{|}]/g, "\\$&");
+  return str.replace(escapleCharsRegex, "\\$&");
 }
 
 // src/string/kebabCase.ts
@@ -780,15 +815,16 @@ function titleCase(str) {
 }
 
 // src/string/unescapeHtml.ts
+var htmlEntitiesRegex = /&(?:amp|lt|gt|quot|#39);/g;
+var entityMap = /* @__PURE__ */ new Map([
+  ["&amp;", "&"],
+  ["&lt;", "<"],
+  ["&gt;", ">"],
+  ["&quot;", '"'],
+  ["&#39;", "'"]
+]);
 function unescapeHtml(str) {
-  const entityMap = {
-    "&amp;": "&",
-    "&lt;": "<",
-    "&gt;": ">",
-    "&quot;": '"',
-    "&#39;": "'"
-  };
-  return str.replace(/&(?:amp|lt|gt|quot|#(0+)?39);/g, (entity) => entityMap[entity]);
+  return str.replace(htmlEntitiesRegex, (entity) => entityMap.get(entity));
 }
 
 // src/validate/isEmpty.ts
@@ -878,6 +914,7 @@ function isUrl(str) {
   dropWhile,
   escapeHtml,
   escapeRegExp,
+  flatKeys,
   group,
   hash,
   intersection,