feat(docs): publish versioned release documentation

1 files changed, 33 insertions, 0 deletions

diff --git a/website/scripts/docs-versions.test.ts b/website/scripts/docs-versions.test.ts
new file mode 100644
index 00000000..dc450b37
--- /dev/null
+++ b/website/scripts/docs-versions.test.ts
@@ -0,0 +1,33 @@
+import { describe, expect, test } from 'bun:test';
+import { normalizeVersion, sortVersionsNewestFirst } from './docs-versions.mjs';
+
+describe('normalizeVersion', () => {
+  test.each([
+    ['0.7.5', '0.7.5'],
+    ['v0.7.5', '0.7.5'],
+  ])('normalizes %s', (input, expected) => {
+    expect(normalizeVersion(input)).toBe(expected);
+  });
+
+  test('rejects non-release refs', () => {
+    expect(() => normalizeVersion('preview-123')).toThrow();
+  });
+});
+
+describe('sortVersionsNewestFirst', () => {
+  test('sorts semantic versions numerically', () => {
+    const versions = [
+      { version: '0.6.10' },
+      { version: '0.7.2' },
+      { version: '0.7.10' },
+      { version: '0.5.12' },
+    ];
+
+    expect(sortVersionsNewestFirst(versions).map(({ version }) => version)).toEqual([
+      '0.7.10',
+      '0.7.2',
+      '0.6.10',
+      '0.5.12',
+    ]);
+  });
+});