moderndash 1.2.0 → 2.0.0

package/README.md

@@ -25,9 +25,12 @@
   <a href="https://www.npmjs.com/package/moderndash">
     <img alt="npm" src="https://img.shields.io/npm/dw/moderndash">
   </a>
-  <img alt="node-current" src="https://img.shields.io/node/v/moderndash">
+  <a href="https://www.npmjs.com/package/moderndash">
+    <img alt="npm" src="https://img.shields.io/npm/v/moderndash?color=blue&label=version">
+  </a>
+  <img alt="node-current" src="https://img.shields.io/node/v/moderndash?color=blue">
   <a href="https://github.com/Maggi64/moderndash/blob/main/LICENSE">
-    <img alt="GitHub" src="https://img.shields.io/github/license/maggi64/moderndash">
+    <img alt="GitHub" src="https://img.shields.io/github/license/maggi64/moderndash?color=orange">
   </a>
 </div>
 
@@ -58,7 +61,7 @@ arr.filter(Boolean)
 npm install moderndash
 ```
 
-## FAQ
+## 🗃 FAQ
 
 ### Why is X lodash function not included?
 Please refer to [You-Dont-Need-Lodash](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore) or [youmightnotneed.com/lodash](https://youmightnotneed.com/lodash) for native replacements.  
@@ -67,4 +70,12 @@ If you still believe a function is missing, please open an issue.
 ### Why no pipe utility functions?
 The upcoming [pipe operator](https://github.com/tc39/proposal-pipeline-operator) in JavaScript will provide function composition, so the framework focuses on providing other useful utility functions that are not yet available.
 
-The pipe operator can already be included via [babel](https://babeljs.io/docs/en/babel-plugin-proposal-pipeline-operator).
+The pipe operator can already be included via [babel](https://babeljs.io/docs/en/babel-plugin-proposal-pipeline-operator).
+
+## 💌 Love & Thanks
+
+To [type-fest](https://github.com/sindresorhus/type-fest) for providing some valuable types.
+
+## 🧰 Contribute
+
+Check the [contribute](https://github.com/Maggi64/moderndash/blob/main/CONTRIBUTE.md) section!

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(src_exports, {
   escapeHtml: () => escapeHtml,
   escapeRegExp: () => escapeRegExp,
   group: () => group,
+  hash: () => hash,
   intersection: () => intersection,
   isEmpty: () => isEmpty,
   isEqual: () => isEqual,
@@ -54,12 +55,13 @@ __export(src_exports, {
   pascalCase: () => pascalCase,
   pick: () => pick,
   races: () => races,
+  randomElem: () => randomElem,
   randomFloat: () => randomFloat,
   randomInt: () => randomInt,
+  randomString: () => randomString,
   range: () => range,
   retry: () => retry,
   round: () => round,
-  sample: () => sample,
   set: () => set,
   shuffle: () => shuffle,
   sleep: () => sleep,
@@ -74,6 +76,7 @@ __export(src_exports, {
   times: () => times,
   titleCase: () => titleCase,
   toDecorator: () => toDecorator,
+  tryCatch: () => tryCatch,
   unescapeHtml: () => unescapeHtml,
   unique: () => unique
 });
@@ -222,26 +225,6 @@ function* range(start, end, step = 1) {
   }
 }
 
-// src/array/sample.ts
-function sample(array, multi) {
-  if (multi === void 0) {
-    if (array.length === 0)
-      return void 0;
-    return getSingleSample(array);
-  }
-  if (multi && array.length === 0)
-    return [];
-  const result = new Array(multi);
-  for (let i = 0; i < multi; i++) {
-    result[i] = getSingleSample(array);
-  }
-  return result;
-}
-function getSingleSample(array) {
-  const randomIndex = Math.floor(Math.random() * array.length);
-  return array[randomIndex];
-}
-
 // src/array/shuffle.ts
 function shuffle(array) {
   const shuffledArray = [...array];
@@ -308,6 +291,71 @@ function unique(array, compareFn = (a, b) => isEqual(a, b)) {
   });
 }
 
+// src/crypto/hash.ts
+async function hash(data, algorithm = "SHA-256") {
+  const encoder = new TextEncoder();
+  const dataBuffer = typeof data === "string" ? encoder.encode(data) : encoder.encode(JSON.stringify(data));
+  const hashBuffer = await crypto.subtle.digest(algorithm, dataBuffer);
+  const hashArray = [...new Uint8Array(hashBuffer)];
+  const hexValues = hashArray.map((b) => b.toString(16).padStart(2, "0"));
+  return hexValues.join("");
+}
+
+// src/crypto/randomInt.ts
+function randomInt(min, max) {
+  if (min > max)
+    throw new Error("min must be less than or equal to max");
+  const range2 = max - min + 1;
+  const randomBuffer = new Uint32Array(1);
+  crypto.getRandomValues(randomBuffer);
+  return min + randomBuffer[0] % range2;
+}
+
+// src/crypto/randomElem.ts
+function randomElem(array, multi) {
+  if (multi === void 0) {
+    if (array.length === 0)
+      return void 0;
+    return getSingleElement(array);
+  }
+  if (multi && array.length === 0)
+    return [];
+  const result = new Array(multi);
+  for (let i = 0; i < multi; i++) {
+    result[i] = getSingleElement(array);
+  }
+  return result;
+}
+function getSingleElement(array) {
+  const randomIndex = randomInt(0, array.length - 1);
+  return array[randomIndex];
+}
+
+// src/crypto/randomFloat.ts
+function randomFloat(min, max) {
+  if (min > max)
+    throw new Error("min must be less than or equal to max");
+  const range2 = max - min;
+  const randomBuffer = new Uint32Array(1);
+  crypto.getRandomValues(randomBuffer);
+  const random = randomBuffer[0] / 4294967295;
+  return min + random * range2;
+}
+
+// src/crypto/randomString.ts
+var DEFAULT_CHARSET = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+function randomString(length, charSet = DEFAULT_CHARSET) {
+  const randomValues = new Uint32Array(length);
+  crypto.getRandomValues(randomValues);
+  let result = "";
+  const charSetLength = charSet.length;
+  for (let i = 0; i < length; i++) {
+    const randomIndex = randomValues[i] % charSetLength;
+    result += charSet[randomIndex];
+  }
+  return result;
+}
+
 // src/decorator/toDecorator.ts
 function toDecorator(func) {
   return function(...args) {
@@ -454,27 +502,6 @@ function median(numbers) {
   return sortedArray.length % 2 === 0 ? (sortedArray[mid - 1] + sortedArray[mid]) / 2 : sortedArray[mid];
 }
 
-// src/number/randomFloat.ts
-function randomFloat(min, max) {
-  if (min > max)
-    throw new Error("min must be less than or equal to max");
-  const range2 = max - min;
-  const randomBuffer = new Uint32Array(1);
-  crypto.getRandomValues(randomBuffer);
-  const random = randomBuffer[0] / 4294967295;
-  return min + random * range2;
-}
-
-// src/number/randomInt.ts
-function randomInt(min, max) {
-  if (min > max)
-    throw new Error("min must be less than or equal to max");
-  const range2 = max - min + 1;
-  const randomBuffer = new Uint32Array(1);
-  crypto.getRandomValues(randomBuffer);
-  return min + randomBuffer[0] % range2;
-}
-
 // src/number/round.ts
 function round(number, precision = 2) {
   const factor = Math.pow(10, precision);
@@ -664,6 +691,18 @@ function timeout(promise, timeout2) {
   });
 }
 
+// src/promise/tryCatch.ts
+async function tryCatch(promise) {
+  try {
+    const data = await promise;
+    return [data, void 0];
+  } catch (error) {
+    if (error instanceof Error)
+      return [void 0, error];
+    throw error;
+  }
+}
+
 // src/string/splitWords.ts
 function splitWords(str) {
   const regex = new RegExp(
@@ -819,6 +858,7 @@ function isUrl(str) {
   escapeHtml,
   escapeRegExp,
   group,
+  hash,
   intersection,
   isEmpty,
   isEqual,
@@ -834,12 +874,13 @@ function isUrl(str) {
   pascalCase,
   pick,
   races,
+  randomElem,
   randomFloat,
   randomInt,
+  randomString,
   range,
   retry,
   round,
-  sample,
   set,
   shuffle,
   sleep,
@@ -854,6 +895,7 @@ function isUrl(str) {
   times,
   titleCase,
   toDecorator,
+  tryCatch,
   unescapeHtml,
   unique
 });