@sohanemon/utils 5.0.2 → 5.0.4

package/dist/functions/index.d.ts

@@ -209,3 +209,33 @@ export declare const mergeRefs: MergeRefs;
  * @example goToClientSideHash('my-element');
  */
 export declare function goToClientSideHash(id: string, opts?: ScrollIntoViewOptions): void;
+/**
+ * Escapes a string for use in a regular expression.
+ *
+ * @param str - The string to escape
+ * @returns - The escaped string
+ *
+ * @example
+ * const escapedString = escapeRegExp('Hello, world!');
+ * // escapedString === 'Hello\\, world!'
+ */
+export declare function escapeRegExp(str: string): string;
+/**
+ * Normalizes a string by:
+ * - Applying Unicode normalization (NFC)
+ * - Optionally removing diacritic marks (accents)
+ * - Optionally trimming leading/trailing non-alphanumeric characters
+ * - Optionally converting to lowercase
+ *
+ * @param str - The string to normalize
+ * @param options - Normalization options
+ * @param options.lowercase - Whether to convert the result to lowercase (default: true)
+ * @param options.removeAccents - Whether to remove diacritic marks like accents (default: true)
+ * @param options.removeNonAlphanumeric - Whether to trim non-alphanumeric characters from the edges (default: true)
+ * @returns The normalized string
+ */
+export declare function normalizeText(str?: string | null, options?: {
+    lowercase?: boolean;
+    removeAccents?: boolean;
+    removeNonAlphanumeric?: boolean;
+}): string;

package/dist/functions/index.js

@@ -374,3 +374,46 @@ export function goToClientSideHash(id, opts) {
     el.scrollIntoView({ behavior: 'smooth', block: 'start', ...opts });
     window.history.pushState(null, '', `#${id}`);
 }
+/**
+ * Escapes a string for use in a regular expression.
+ *
+ * @param str - The string to escape
+ * @returns - The escaped string
+ *
+ * @example
+ * const escapedString = escapeRegExp('Hello, world!');
+ * // escapedString === 'Hello\\, world!'
+ */
+export function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Normalizes a string by:
+ * - Applying Unicode normalization (NFC)
+ * - Optionally removing diacritic marks (accents)
+ * - Optionally trimming leading/trailing non-alphanumeric characters
+ * - Optionally converting to lowercase
+ *
+ * @param str - The string to normalize
+ * @param options - Normalization options
+ * @param options.lowercase - Whether to convert the result to lowercase (default: true)
+ * @param options.removeAccents - Whether to remove diacritic marks like accents (default: true)
+ * @param options.removeNonAlphanumeric - Whether to trim non-alphanumeric characters from the edges (default: true)
+ * @returns The normalized string
+ */
+export function normalizeText(str, options = {}) {
+    if (!str)
+        return '';
+    const { lowercase = true, removeAccents = true, removeNonAlphanumeric = true, } = options;
+    let result = str.normalize('NFC');
+    if (removeAccents) {
+        result = result.replace(/\p{M}/gu, ''); // remove accents
+    }
+    if (removeNonAlphanumeric) {
+        result = result.replace(/^[^\p{L}\p{N}]*|[^\p{L}\p{N}]*$/gu, ''); // trim edges
+    }
+    if (lowercase) {
+        result = result.toLocaleLowerCase();
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sohanemon/utils",
-  "version": "5.0.2",
+  "version": "5.0.4",
   "author": "Sohan Emon <sohanemon@outlook.com>",
   "description": "",
   "type": "module",