To Kebab Case

1/**
2 * Converts a string to kebab-case.
3 *
4 * Handles acronyms and consecutive uppercase letters properly.
5 * Example:
6 *   "XMLHttpRequest" -> "xml-http-request"
7 *
8 * @param str - The input string.
9 * @returns The kebab-cased string.
10 *
11 * @example
12 * toKebabCase("Hello World Again"); // "hello-world-again"
13 * toKebabCase("XMLHttpRequest"); // "xml-http-request"
14 */
15export function toKebabCase(str: string): string {
16  return (
17    str
18      // Split acronym groups (e.g. "XMLHttp" -> "XML-Http")
19      .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')
20      // Split between a lowercase/digit and an uppercase (e.g. "testHTTP" -> "test-HTTP")
21      .replace(/([a-z\d])([A-Z])/g, '$1-$2')
22      // Replace spaces and underscores with hyphens
23      .replace(/[\s_]+/g, '-')
24      .toLowerCase()
25      // Remove leading and trailing hyphens
26      .replace(/^-+|-+$/g, '')
27  );
28}