Tests: add CHANGELOG consistency checks, fix forwardRef export assertion

Author: jpmarindiaz

tests/bundle/changelog.test.ts

@@ -0,0 +1,62 @@
+// @vitest-environment node
+/**
+ * CHANGELOG.md consistency checks.
+ *
+ * Validates that version headers have matching compare links,
+ * that [Unreleased] points to the latest version, and that
+ * package.json version matches the latest CHANGELOG entry.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const ROOT = resolve(__dirname, '../..');
+
+const changelog = readFileSync(resolve(ROOT, 'CHANGELOG.md'), 'utf-8');
+const pkg = JSON.parse(readFileSync(resolve(ROOT, 'package.json'), 'utf-8'));
+
+/** Extract all `## [x.y.z]` version headers (excludes [Unreleased]). */
+function getVersionHeaders(text: string): string[] {
+  return [...text.matchAll(/^## \[(\d+\.\d+\.\d+)\]/gm)].map((m) => m[1]);
+}
+
+/** Extract all `[x.y.z]: <url>` reference links at the bottom. */
+function getCompareLinks(text: string): Map<string, string> {
+  const links = new Map<string, string>();
+  for (const m of text.matchAll(/^\[([^\]]+)\]:\s*(.+)$/gm)) {
+    links.set(m[1], m[2].trim());
+  }
+  return links;
+}
+
+describe('CHANGELOG.md', () => {
+  const versions = getVersionHeaders(changelog);
+  const links = getCompareLinks(changelog);
+
+  it('has at least one version entry', () => {
+    expect(versions.length).toBeGreaterThan(0);
+  });
+
+  it('latest version matches package.json', () => {
+    expect(versions[0]).toBe(pkg.version);
+  });
+
+  it('every version header has a matching compare link', () => {
+    const missing = versions.filter((v) => !links.has(v));
+    expect(missing).toEqual([]);
+  });
+
+  it('[Unreleased] link points to latest version tag', () => {
+    const unreleased = links.get('Unreleased');
+    expect(unreleased).toBeDefined();
+    expect(unreleased).toContain(`v${versions[0]}...HEAD`);
+  });
+
+  it('compare links are in descending version order', () => {
+    const linkVersions = [...links.keys()].filter((k) => k !== 'Unreleased' && /^\d+\.\d+\.\d+$/.test(k));
+    expect(linkVersions).toEqual(versions);
+  });
+});

tests/bundle/exports.test.ts

@@ -39,7 +39,8 @@ describe('built bundle (dist/monkeytab.js)', () => {
     const bundle = await import(BUNDLE_PATH);
 
     // Core public components from src/browser/index.ts
-    expect(typeof bundle.MonkeyTable).toBe('function');
+    // MonkeyTable is wrapped in forwardRef (since 0.3.0), which returns an object.
+    expect(bundle.MonkeyTable).toBeDefined();
     expect(typeof bundle.BrowserClient).toBe('function');
     expect(typeof bundle.Grid).toBe('function');
     expect(typeof bundle.PaginationBar).toBe('function');
@@ -65,6 +66,6 @@ describe('built bundle (dist/monkeytab.js)', () => {
     // MonkeyTable is the headline export — guard explicitly so the
     // failure message is unambiguous if it ever disappears.
     expect(bundle.MonkeyTable).toBeDefined();
-    expect(bundle.MonkeyTable.name).toBe('MonkeyTable');
+    expect(bundle.MonkeyTable.displayName).toBe('MonkeyTable');
   });
 });