To Camel Case

1/**
2 * Converts a string to camelCase.
3 *
4 * Handles acronyms properly, ensuring that something like
5 * "XMLHttpRequest" becomes "xmlHttpRequest".
6 *
7 * @param str - The input string.
8 * @returns The camelCased string.
9 *
10 * @example
11 * toCamelCase("hello world-example"); // "helloWorldExample"
12 * toCamelCase("XMLHttpRequest"); // "xmlHttpRequest"
13 */
14export function toCamelCase(str: string): string {
15  const result = str
16    // Split acronym groups into proper boundaries
17    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
18    // Split between lowercase/digit and uppercase
19    .replace(/([a-z\d])([A-Z])/g, '$1 $2')
20    // Normalize spaces/underscores/dashes
21    .replace(/[-_\s]+/g, ' ')
22    // Lowercase everything to start clean
23    .toLowerCase()
24    // Capitalize first letter of each "word" after the first
25    .replace(/\s+(\w)/g, (_, c) => c.toUpperCase())
26    // Remove any remaining spaces and trim
27    .replace(/\s+/g, '')
28    .trim();
29 
30  // Ensure first character is lowercase for camelCase
31  return result.charAt(0).toLowerCase() + result.slice(1);
32}