@arsedizioni/ars-utils 21.2.324 → 21.2.326

package/fesm2022/arsedizioni-ars-utils-core.mjs

@@ -311,6 +311,43 @@ class SystemUtils {
         }
         return items[0];
     }
+    /**
+     * Normalize a string by converting it to lowercase and removing extra spaces, with special handling for acronyms and camelCase.
+     * @param s  : the string to normalize
+     * @returns  : The normalized string, or `undefined` if the input is falsy.
+     */
+    static normalize(s) {
+        if (!s)
+            return s;
+        return s
+            .split(' ')
+            .map((word, wordIndex) => {
+            if (!word)
+                return word;
+            // If the word is all uppercase and contains at least one letter, we assume it's an acronym and leave it as is
+            if (word === word.toUpperCase() && /[A-Z]/.test(word)) {
+                return word;
+            }
+            // Otherwise, convert to lowercase letter by letter
+            const chars = word.split('');
+            return chars
+                .map((char, charIndex) => {
+                if (charIndex === 0 && wordIndex === 0) {
+                    // First letter of the first word:
+                    // remains uppercase only if the first 2 letters are both uppercase
+                    const secondChar = chars[1] ?? '';
+                    const keepUppercase = char === char.toUpperCase() &&
+                        secondChar === secondChar.toUpperCase() &&
+                        /[A-Z]/.test(char) &&
+                        /[A-Z]/.test(secondChar);
+                    return keepUppercase ? char : char.toLowerCase();
+                }
+                return char.toLowerCase();
+            })
+                .join('');
+        })
+            .join(' ');
+    }
     /**
      * Wraps bare URLs in the given string with `<a>` anchor tags.
      * @param s - The plain-text or HTML string to process.