moderndash 3.2.0 → 3.3.0

package/dist/index.d.ts

@@ -51,7 +51,7 @@ declare function count<TElem, TKey extends PropertyKey>(array: readonly TElem[],
  * @template TMinLength The minimum length of the array.
  */
 type ArrayMinLength<TElem, TMinLenght extends number> = BuildArrayMinLength<TElem, TMinLenght, []>;
-type BuildArrayMinLength<TElem, TMinLength extends number, Current extends TElem[]> = Current['length'] extends TMinLength ? [...Current, ...TElem[]] : BuildArrayMinLength<TElem, TMinLength, [...Current, TElem]>;
+type BuildArrayMinLength<TElem, TMinLength extends number, Current extends TElem[]> = Current["length"] extends TMinLength ? [...Current, ...TElem[]] : BuildArrayMinLength<TElem, TMinLength, [...Current, TElem]>;
 
 type CompareFunction<TArrays extends ArrayMinLength<unknown[], 2>> = (a: TArrays[0][number], b: ArrayTail<TArrays>[number][number]) => boolean;
 type ArrayTail<TArray extends unknown[]> = TArray extends [unknown, ...infer U] ? U : never;
@@ -227,7 +227,7 @@ declare function shuffle<TElem>(array: readonly TElem[]): TElem[];
  * @returns Returns a new sorted array.
 */
 declare function sort<TElem>(array: readonly TElem[], ...orders: {
-    order?: 'asc' | 'desc';
+    order?: "asc" | "desc";
     by?: (item: TElem) => number | bigint | Date | string;
 }[]): TElem[];
 
@@ -337,7 +337,7 @@ type JsonPrimitive = string | number | boolean | null;
 */
 type Jsonifiable = JsonPrimitive | JsonifiableObject | JsonifiableArray;
 
-type SupportedAlgorithms = 'SHA-256' | 'SHA-384' | 'SHA-512';
+type SupportedAlgorithms = "SHA-256" | "SHA-384" | "SHA-512";
 /**
  * Generates a hash from the given data using the specified algorithm.
  *
@@ -435,7 +435,7 @@ declare function randomString(length: number, charSet?: string): string;
  *
  * Look at {@link debounce} for the non-decorator version.
  *
- * *Requires TypeScript >=5.0 or `experimentalDecorators` flag enabled.*
+ * *Requires the [experimentalDecorators](https://www.typescriptlang.org/tsconfig#experimentalDecorators) flag to be set.*
  *
  * @example
  * ```typescript
@@ -461,7 +461,7 @@ declare function decDebounce(wait: number): (target: unknown, key: string, descr
  *
  * Look at {@link maxCalls} for the non-decorator version.
  *
- * *Requires TypeScript >=5.0 or `experimentalDecorators` flag enabled.*
+ * *Requires the [experimentalDecorators](https://www.typescriptlang.org/tsconfig#experimentalDecorators) flag to be set.*
  *
  * @example
  * ```typescript
@@ -545,7 +545,7 @@ declare function memoize<TFunc extends GenericFunction<TFunc>, Cache extends Map
  *
  * Look at {@link memoize} for the non-decorator version.
  *
- * *Requires TypeScript >=5.0 or `experimentalDecorators` flag enabled.*
+ * *Requires the [experimentalDecorators](https://www.typescriptlang.org/tsconfig#experimentalDecorators) flag to be set.*
  *
  * @example
  * ```typescript
@@ -573,7 +573,7 @@ declare function decMemoize(options?: Parameters<typeof memoize>[1]): (target: u
  *
  * Look at {@link minCalls} for the non-decorator version.
  *
- * *Requires TypeScript >=5.0 or `experimentalDecorators` flag enabled.*
+ * *Requires the [experimentalDecorators](https://www.typescriptlang.org/tsconfig#experimentalDecorators) flag to be set.*
  * @example
  * ```typescript
  * class TestClass {
@@ -596,7 +596,7 @@ declare function decMinCalls(n: number): (target: unknown, key: string, descript
  *
  * Look at {@link throttle} for the non-decorator version.
  *
- * *Requires TypeScript >=5.0 or `experimentalDecorators` flag enabled.*
+ * *Requires the [experimentalDecorators](https://www.typescriptlang.org/tsconfig#experimentalDecorators) flag to be set.*
  *
  * @example
  * ```typescript
@@ -1214,9 +1214,10 @@ declare function snakeCase(str: string): string;
  * // => ['hello', 'world', '123']
  *
  * @param str The string to split into words.
+ * @param forceFallback Force the use of the positive lookahead fallback. Only used for testing.
  * @returns An array of words.
  */
-declare function splitWords(str: string): string[];
+declare function splitWords(str: string, forceFallback?: boolean): string[];
 
 /**
  * Converts a string to Title Case.
@@ -1293,8 +1294,9 @@ declare function trimStart(str: string, chars: string): string;
 declare function unescapeHtml(str: string): string;
 
 /**
- * Checks if `value` is an empty object, collection, map, or set.
+ * Checks if a value is empty.
  *
+ * Supports: strings, arrays, objects, maps, sets, typed arrays.
  * @example
  * isEmpty(null)
  * // => true
@@ -1314,7 +1316,7 @@ declare function unescapeHtml(str: string): string;
  * isEmpty({ 'a': 1 })
  * // => false
  * @param value The value to check.
- * @returns Returns `true` if given vlaue is empty, else `false`.
+ * @returns Returns `true` if `value` is empty, else `false`.
  */
 declare function isEmpty(value: string | object | null | undefined): boolean;
 
@@ -1322,9 +1324,11 @@ declare function isEmpty(value: string | object | null | undefined): boolean;
  * Performs a deep comparison between two values to determine if they are
  * equivalent.
  *
+ * Supports: primitives, arrays, objects, dates, regexes, maps, sets, buffers, typed arrays
+ *
  * @example
- * var object = { 'a': 1 };
- * var other = { 'a': 1 };
+ * var object = { a: { b: 2 } };
+ * var other = { a: { b: 2 } };
  *
  * isEqual(object, other);
  * // => true

package/dist/index.js

@@ -646,12 +646,25 @@ 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) {
-  return str.split(splitWordsRegex).filter(Boolean);
+function splitWords(str, forceFallback = false) {
+  return lookbehindWordBoundary && !forceFallback ? str.split(lookbehindWordBoundary).filter(Boolean) : splitWordsFallback(str);
+}
+var wordBoundaryFallback = /[^\dA-Za-z]|(?=[A-Z][a-z])/;
+var lookbehindReplacement = /([a-z])([A-Z])/g;
+var lookbehindWordBoundary = tryLookbehindRegex();
+function tryLookbehindRegex() {
+  try {
+    return 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
+    );
+  } catch {
+    return void 0;
+  }
+}
+function splitWordsFallback(str) {
+  const modifiedStr = str.replace(lookbehindReplacement, (match, p1, p2) => p1 + "\0" + p2);
+  return modifiedStr.split(wordBoundaryFallback).filter(Boolean).map((word) => word.replace(/\u0000/g, ""));
 }
 
 // src/string/deburr.ts
@@ -788,18 +801,16 @@ function unescapeHtml(str) {
 
 // src/validate/isEmpty.ts
 function isEmpty(value) {
-  if (value === null || value === void 0) {
+  if (value === null || value === void 0)
     return true;
-  }
-  if (typeof value === "string" || Array.isArray(value)) {
+  if (typeof value === "string" || Array.isArray(value))
     return value.length === 0;
-  }
-  if (value instanceof Map || value instanceof Set) {
+  if (value instanceof Map || value instanceof Set)
     return value.size === 0;
-  }
-  if (typeof value === "object") {
+  if (ArrayBuffer.isView(value))
+    return value.byteLength === 0;
+  if (typeof value === "object")
     return Object.keys(value).length === 0;
-  }
   return false;
 }
 
@@ -809,17 +820,22 @@ function isEqual(a, b) {
     return true;
   if (typeof a !== typeof b)
     return false;
-  if (Array.isArray(a) && Array.isArray(b)) {
+  if (Array.isArray(a) && Array.isArray(b))
     return isSameArray(a, b);
-  }
-  if (a instanceof Date && b instanceof Date) {
+  if (a instanceof Date && b instanceof Date)
     return a.getTime() === b.getTime();
-  }
-  if (a instanceof RegExp && b instanceof RegExp) {
+  if (a instanceof RegExp && b instanceof RegExp)
     return a.toString() === b.toString();
-  }
-  if (isPlainObject(a) && isPlainObject(b)) {
+  if (isPlainObject(a) && isPlainObject(b))
     return isSameObject(a, b);
+  if (a instanceof ArrayBuffer && b instanceof ArrayBuffer)
+    return dataViewsAreEqual(new DataView(a), new DataView(b));
+  if (a instanceof DataView && b instanceof DataView)
+    return dataViewsAreEqual(a, b);
+  if (isTypedArray(a) && isTypedArray(b)) {
+    if (a.byteLength !== b.byteLength)
+      return false;
+    return isSameArray(a, b);
   }
   return false;
 }
@@ -837,12 +853,20 @@ function isSameObject(a, b) {
 function isSameArray(a, b) {
   if (a.length !== b.length)
     return false;
-  for (const [i, element] of a.entries()) {
-    if (!isEqual(element, b[i]))
+  return a.every((element, index) => isEqual(element, b[index]));
+}
+function dataViewsAreEqual(a, b) {
+  if (a.byteLength !== b.byteLength)
+    return false;
+  for (let offset = 0; offset < a.byteLength; offset++) {
+    if (a.getUint8(offset) !== b.getUint8(offset))
       return false;
   }
   return true;
 }
+function isTypedArray(value) {
+  return ArrayBuffer.isView(value) && !(value instanceof DataView);
+}
 
 // src/validate/isUrl.ts
 function isUrl(str) {