test(changelog): add changelog generator and pages tests

主要变更：

- 新增 changelog 生成器的单元测试

- 新增 changelog 页面的集成测试

- 覆盖 sidebar 配置、页面结构和组件功能

Co-Authored-By: Hagicode <noreply@hagicode.com>

Author: newbe36524

tests/repo-changelog-generator.test.mjs

@@ -0,0 +1,153 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+
+import {
+  buildReleaseWindows,
+  buildRepositoryChangelog,
+  collectTagWindowCommits,
+  listRepositoryTags,
+} from '../scripts/generate-multi-repo-changelog.mjs';
+
+function git(repoDir, args, env = {}) {
+  return execFileSync('git', ['-C', repoDir, ...args], {
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      ...env,
+    },
+  });
+}
+
+async function createTempRepository(t) {
+  const repoDir = await mkdtemp(path.join(os.tmpdir(), 'docs-changelog-'));
+  t.after(async () => {
+    await rm(repoDir, { recursive: true, force: true });
+  });
+
+  git(repoDir, ['init', '-b', 'main']);
+  git(repoDir, ['config', 'user.name', 'Docs Test']);
+  git(repoDir, ['config', 'user.email', 'docs-test@example.com']);
+
+  return repoDir;
+}
+
+async function commitFile(repoDir, filename, content, date, subject, body = '') {
+  await writeFile(path.join(repoDir, filename), content, 'utf8');
+  git(repoDir, ['add', filename]);
+
+  const args = ['commit', '-m', subject];
+  if (body.length > 0) {
+    args.push('-m', body);
+  }
+
+  git(repoDir, args, {
+    GIT_AUTHOR_DATE: date,
+    GIT_COMMITTER_DATE: date,
+  });
+}
+
+test('generator builds adjacent tag windows and skips commits before the earliest tag', async (t) => {
+  const repoDir = await createTempRepository(t);
+
+  await commitFile(repoDir, 'notes.md', '# init\n', '2026-01-01T00:00:00Z', 'chore: init');
+  git(repoDir, ['tag', '0.1.0']);
+
+  await commitFile(
+    repoDir,
+    'notes.md',
+    '# init\n\nsecond\n',
+    '2026-01-02T00:00:00Z',
+    'feat: add second change',
+    'detail for second change',
+  );
+  await commitFile(
+    repoDir,
+    'notes.md',
+    '# init\n\nsecond\n\nthird\n',
+    '2026-01-03T00:00:00Z',
+    'fix: prepare release two',
+    'detail for release two',
+  );
+  git(repoDir, ['tag', 'v0.2.0']);
+
+  await commitFile(
+    repoDir,
+    'notes.md',
+    '# init\n\nsecond\n\nthird\n\nfourth\n',
+    '2026-01-04T00:00:00Z',
+    'docs: release three',
+  );
+  git(repoDir, ['tag', 'V0.3.0']);
+
+  const tags = listRepositoryTags(repoDir);
+  assert.deepEqual(
+    tags.map((tag) => tag.name),
+    ['0.1.0', 'v0.2.0', 'V0.3.0'],
+  );
+
+  const windows = buildReleaseWindows(tags);
+  assert.deepEqual(
+    windows.map((window) => [window.previousTag.name, window.currentTag.name]),
+    [
+      ['0.1.0', 'v0.2.0'],
+      ['v0.2.0', 'V0.3.0'],
+    ],
+  );
+
+  const secondReleaseCommits = collectTagWindowCommits(repoDir, '0.1.0', 'v0.2.0');
+  assert.equal(secondReleaseCommits.length, 2);
+  assert.deepEqual(
+    secondReleaseCommits.map((commit) => commit.title),
+    ['feat: add second change', 'fix: prepare release two'],
+  );
+  assert.deepEqual(
+    secondReleaseCommits.map((commit) => commit.detail),
+    ['detail for second change', 'detail for release two'],
+  );
+
+  const changelog = buildRepositoryChangelog(
+    {
+      repoKey: 'fixture',
+      repoPath: repoDir,
+      outputPath: 'unused.json',
+    },
+    {
+      monorepoRoot: '/',
+    },
+  );
+
+  assert.equal(changelog.releases.length, 2);
+  assert.deepEqual(
+    changelog.releases.map((release) => release.tag),
+    ['V0.3.0', 'v0.2.0'],
+  );
+  assert.equal(changelog.releases[0].commitCount, 1);
+  assert.equal(changelog.releases[1].commitCount, 2);
+  assert.equal(changelog.releases[0].commits[0].title, 'docs: release three');
+  assert.equal(changelog.releases[1].commits[0].title, 'feat: add second change');
+});
+
+test('generator returns a valid empty release list for repositories with a single tag', async (t) => {
+  const repoDir = await createTempRepository(t);
+
+  await commitFile(repoDir, 'README.md', 'single tag repo\n', '2026-02-01T00:00:00Z', 'feat: first release');
+  git(repoDir, ['tag', 'v1.0.0']);
+
+  const changelog = buildRepositoryChangelog(
+    {
+      repoKey: 'single',
+      repoPath: repoDir,
+      outputPath: 'unused.json',
+    },
+    {
+      monorepoRoot: '/',
+    },
+  );
+
+  assert.equal(changelog.repoKey, 'single');
+  assert.equal(changelog.releases.length, 0);
+});

tests/repo-changelog-pages.test.mjs

@@ -0,0 +1,97 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { access, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const docsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+test('docs sidebar config exposes the localized changelog group', async () => {
+  const astroConfig = await readFile(path.join(docsRoot, 'astro.config.mjs'), 'utf8');
+
+  assert.match(astroConfig, /label:\s*"变更日志"/);
+  assert.match(astroConfig, /translations:\s*\{\s*en:\s*"Changelog"\s*\}/);
+  assert.match(astroConfig, /autogenerate:\s*\{\s*directory:\s*"changelog"\s*\}/);
+});
+
+test('changelog pages exist for core, web, and desktop in both locales', async () => {
+  const pageExpectations = [
+    {
+      filePath: path.join(docsRoot, 'src', 'content', 'docs', 'changelog', 'core.mdx'),
+      repoLabel: 'Core',
+      locale: 'zh-CN',
+      jsonFile: 'core.json',
+    },
+    {
+      filePath: path.join(docsRoot, 'src', 'content', 'docs', 'changelog', 'web.mdx'),
+      repoLabel: 'Web',
+      locale: 'zh-CN',
+      jsonFile: 'web.json',
+    },
+    {
+      filePath: path.join(docsRoot, 'src', 'content', 'docs', 'changelog', 'desktop.mdx'),
+      repoLabel: 'Desktop',
+      locale: 'zh-CN',
+      jsonFile: 'desktop.json',
+    },
+    {
+      filePath: path.join(docsRoot, 'src', 'content', 'docs', 'en', 'changelog', 'core.mdx'),
+      repoLabel: 'Core',
+      locale: 'en',
+      jsonFile: 'core.json',
+    },
+    {
+      filePath: path.join(docsRoot, 'src', 'content', 'docs', 'en', 'changelog', 'web.mdx'),
+      repoLabel: 'Web',
+      locale: 'en',
+      jsonFile: 'web.json',
+    },
+    {
+      filePath: path.join(docsRoot, 'src', 'content', 'docs', 'en', 'changelog', 'desktop.mdx'),
+      repoLabel: 'Desktop',
+      locale: 'en',
+      jsonFile: 'desktop.json',
+    },
+  ];
+
+  for (const page of pageExpectations) {
+    await access(page.filePath);
+    const content = await readFile(page.filePath, 'utf8');
+
+    assert.match(content, /RepoChangelogPage/);
+    assert.match(content, new RegExp(`repoLabel="${page.repoLabel}"`));
+    assert.match(content, new RegExp(`locale="${page.locale}"`));
+    assert.match(content, new RegExp(page.jsonFile.replace('.', '\\.')));
+  }
+});
+
+test('shared changelog component keeps grouped release markup and explicit empty-state copy', async () => {
+  const componentPath = path.join(docsRoot, 'src', 'components', 'RepoChangelogPage.astro');
+  const component = await readFile(componentPath, 'utf8');
+
+  assert.match(component, /function getCanonicalReleaseAnchor/);
+  assert.match(component, /replace\(\s*\/\^#\/,\s*''\s*\)/);
+  assert.match(component, /replace\(\s*\/\^v\+\/,\s*''\s*\)/);
+  assert.match(component, /toLowerCase\(\)/);
+  assert.match(component, /data-repo-changelog/);
+  assert.match(component, /data-release-filter-select/);
+  assert.match(component, /searchParams\.get\('tag'\)/);
+  assert.match(component, /location\.hash/);
+  assert.match(component, /data-release-anchor-value/);
+  assert.match(component, /findCardByHash/);
+  assert.match(component, /scrollIntoView\(\{ block: 'start', behavior: 'auto' \}\)/);
+  assert.match(component, /focus\(\{ preventScroll: true \}\)/);
+  assert.match(component, /data-release-tag-value/);
+  assert.match(component, /data-release-block/);
+  assert.match(component, /data-commit-item/);
+  assert.match(component, /data-changelog-empty/);
+  assert.match(component, /:global\(html\[data-theme='dark'\]\) \.repo-changelog/);
+  assert.match(component, /--repo-surface/);
+  assert.match(component, /scroll-margin-top: clamp\(5\.5rem, 14vh, 8rem\)/);
+  assert.match(component, /No adjacent-tag releases yet/);
+  assert.match(component, /No commits were collected for this tag window/);
+  assert.match(component, /当前数据集少于两个 tag/);
+  assert.match(component, /此 Tag 区间未采集到提交/);
+  assert.match(component, /release\.tag/);
+  assert.match(component, /commit\.title/);
+});