Release 2025-05-19

web/src/lib/strings.ts

@@ -0,0 +1,68 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Normalize a string by removing accents and converting it to lowercase.
+ *
+ * @example
+ * normalize(' Café') // 'cafe'
+ */
+const normalize = (str: string): string => {
+  return str
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase()
+    .trim()
+}
+
+/**
+ * Compare two strings after normalizing them.
+ */
+export const areSameNormalized = (str1: string, str2: string): boolean => {
+  return normalize(str1) === normalize(str2)
+}
+
+export type TransformCaseType = 'lower' | 'original' | 'sentence' | 'title' | 'upper'
+
+/**
+ * Transform a string to a different case.
+ *
+ * @example
+ * transformCase('hello WORLD', 'lower') // 'hello world'
+ * transformCase('hello WORLD', 'upper') // 'HELLO WORLD'
+ * transformCase('hello WORLD', 'sentence') // 'Hello world'
+ * transformCase('hello WORLD', 'title') // 'Hello World'
+ * transformCase('hello WORLD', 'original') // 'hello WORLD'
+ */
+export const transformCase = <T extends string, C extends TransformCaseType>(
+  str: T,
+  caseType: C
+): C extends 'lower'
+  ? Lowercase<T>
+  : C extends 'upper'
+    ? Uppercase<T>
+    : C extends 'sentence'
+      ? Capitalize<Lowercase<T>>
+      : C extends 'title'
+        ? Capitalize<Lowercase<T>>
+        : T => {
+  switch (caseType) {
+    case 'lower':
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+      return str.toLowerCase() as any
+    case 'upper':
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+      return str.toUpperCase() as any
+    case 'sentence':
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+      return (str.charAt(0).toUpperCase() + str.slice(1).toLowerCase()) as any
+    case 'title':
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+      return str
+        .split(' ')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ') as any
+    case 'original':
+    default:
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+      return str as any
+  }
+}