feat(site): extract api reference from components (#464)

site/scripts/api-docs-builder/src/tests/utils.test.ts

@@ -0,0 +1,70 @@
+import { describe, expect, it } from 'vitest';
+import { kebabToPascal, sortProps } from '../utils.js';
+
+describe('kebabToPascal', () => {
+  it("converts 'play-button' to 'PlayButton'", () => {
+    expect(kebabToPascal('play-button')).toBe('PlayButton');
+  });
+
+  it("converts 'slider' to 'Slider'", () => {
+    expect(kebabToPascal('slider')).toBe('Slider');
+  });
+
+  it("converts 'time-display-current' to 'TimeDisplayCurrent'", () => {
+    expect(kebabToPascal('time-display-current')).toBe('TimeDisplayCurrent');
+  });
+});
+
+describe('sortProps', () => {
+  it('sorts required props before optional props', () => {
+    const props = {
+      optional: { type: 'string' },
+      required: { type: 'string', required: true as const },
+    };
+
+    const result = sortProps(props);
+    const keys = Object.keys(result);
+
+    expect(keys).toEqual(['required', 'optional']);
+  });
+
+  it('sorts alphabetically within each group', () => {
+    const props = {
+      zebra: { type: 'string', required: true as const },
+      apple: { type: 'string', required: true as const },
+      mango: { type: 'string' },
+      banana: { type: 'string' },
+    };
+
+    const result = sortProps(props);
+    const keys = Object.keys(result);
+
+    expect(keys).toEqual(['apple', 'zebra', 'banana', 'mango']);
+  });
+
+  it('keeps all-optional props alphabetical', () => {
+    const props = {
+      charlie: { type: 'string' },
+      alpha: { type: 'string' },
+      bravo: { type: 'string' },
+    };
+
+    const result = sortProps(props);
+    const keys = Object.keys(result);
+
+    expect(keys).toEqual(['alpha', 'bravo', 'charlie']);
+  });
+
+  it('keeps all-required props alphabetical', () => {
+    const props = {
+      charlie: { type: 'string', required: true as const },
+      alpha: { type: 'string', required: true as const },
+      bravo: { type: 'string', required: true as const },
+    };
+
+    const result = sortProps(props);
+    const keys = Object.keys(result);
+
+    expect(keys).toEqual(['alpha', 'bravo', 'charlie']);
+  });
+});