Add toTitleCase() strring util

.changeset/ninety-mayflies-grab.md

@@ -0,0 +1,5 @@
+---
+'svelte-ux': patch
+---
+
+Add `toTitleCase()` strring util

src/lib/utils/string.test.ts

@@ -0,0 +1,17 @@
+import { describe, it, expect } from 'vitest';
+
+import { toTitleCase } from './string';
+
+describe('toTitleCase()', () => {
+  it('basic', () => {
+    const original = 'this is a test';
+    const expected = 'This is a Test';
+    expect(toTitleCase(original)).equal(expected);
+  });
+
+  it('basic', () => {
+    const original = 'A long time ago';
+    const expected = 'A Long Time Ago';
+    expect(toTitleCase(original)).equal(expected);
+  });
+});

src/lib/utils/string.ts

@@ -5,6 +5,23 @@ export function isUpperCase(str: string) {
   return /^[A-Z]*$/.test(str);
 }
 
+/**
+ * Returns string with the first letter of each word converted to uppercase (and remainder as lowercase)
+ */
+export function toTitleCase(str: string, ignore = ['a', 'an', 'is', 'the']) {
+  return str
+    .toLowerCase()
+    .split(' ')
+    .map((word, index) => {
+      if (index > 0 && ignore.includes(word)) {
+        return word;
+      } else {
+        return word.charAt(0).toUpperCase() + word.slice(1);
+      }
+    })
+    .join(' ');
+}
+
 /**
  * Generates a unique Id, with prefix if provided
  */