@sohanemon/utils 5.0.3 → 5.0.4

package/dist/functions/index.d.ts

@@ -220,3 +220,22 @@ export declare function goToClientSideHash(id: string, opts?: ScrollIntoViewOpti
  * // 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

@@ -387,3 +387,33 @@ export function goToClientSideHash(id, opts) {
 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.3",
+  "version": "5.0.4",
   "author": "Sohan Emon <sohanemon@outlook.com>",
   "description": "",
   "type": "module",