feat: add Astro reference site and organize book contents

site/tests/browser/site.spec.ts

@@ -0,0 +1,31 @@
+import { expect, test } from '@playwright/test';
+
+test('home and book are usable without client JavaScript', async ({ page }, testInfo) => {
+  const failures: string[] = [];
+  page.on('response', (response) => { if (response.status() >= 400) failures.push(response.url()); });
+  await page.goto('./');
+  await expect(page.getByRole('heading', { level: 1 })).toContainText('探索できる世界へ');
+  expect(await page.evaluate(() => document.documentElement.scrollWidth <= window.innerWidth)).toBe(true);
+  await page.screenshot({ path: testInfo.outputPath('home.png'), fullPage: true });
+  await page.getByRole('link', { name: 'Book', exact: true }).click();
+  await expect(page.getByRole('heading', { level: 1 })).toContainText('通信の約束まで');
+  await page.getByRole('link', { name: '第1章から読む' }).click();
+  await expect(page.getByRole('heading', { level: 1 })).toHaveText('1. コンセプト');
+  if (testInfo.project.name === 'mobile') {
+    await page.locator('.mobile-chapters summary').click();
+    await page.locator('.mobile-chapters').getByRole('link', { name: '3. Protocol', exact: true }).click();
+  } else {
+    await page.locator('.sidebar').getByRole('link', { name: '3. Protocol', exact: true }).click();
+  }
+  await expect(page.getByRole('heading', { level: 1 })).toHaveText('3. Protocol');
+  await page.screenshot({ path: testInfo.outputPath('book.png'), fullPage: false });
+  expect(await page.evaluate(() => document.documentElement.scrollWidth <= window.innerWidth)).toBe(true);
+  // Cross-chapter Japanese fragment links must reach the matching heading.
+  await page.locator('article').getByRole('link', { name: '4.2. Text View' }).first().click();
+  await expect(page.getByRole('heading', { level: 1 })).toHaveText('4.2. Text View');
+  await expect(page).toHaveURL(/4\.2-text-view\/#/);
+  await page.goto('book/draft/filesystem-discovery/');
+  await expect(page.locator('.draft-notice')).toContainText('Draft');
+  expect(await page.evaluate(() => document.documentElement.scrollWidth <= window.innerWidth)).toBe(true);
+  expect(failures).toEqual([]);
+});

site/tests/document-links.test.mjs

@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import test from 'node:test';
+import documentLinks, { contentsRoot, documentHref, normalizeBase } from '../plugins/document-links.mjs';
+
+const source = path.join(contentsRoot, '3-protocol.md');
+test('canonical, draft and cross-directory links keep their fragments', () => {
+  assert.equal(documentHref('4.2-text-view.md#参照表記', source), '/book/4.2-text-view/#参照表記');
+  assert.equal(documentHref('draft/unresolved-issues.md', source), '/book/draft/unresolved-issues/');
+  assert.equal(documentHref('../3-protocol.md#value', path.join(contentsRoot, 'draft/rust-api-model.md')), '/book/3-protocol/#value');
+});
+test('base prefix and query are preserved', () => {
+  assert.equal(normalizeBase('/reference'), '/reference/');
+  assert.equal(documentHref('4-client.md?from=book#known-space', source, '/reference'), '/reference/book/4-client/?from=book#known-space');
+});
+test('external URLs, local anchors and non-Markdown assets are untouched', () => {
+  for (const url of ['https://example.test/file.md', '//example.test/file.md', '#名前と文字列', 'mailto:user@example.test', './image.svg']) {
+    assert.equal(documentHref(url, source), url);
+  }
+});
+test('invalid base and links escaping contents are rejected', () => {
+  for (const base of ['relative', '//example.test', '/foo?x', '/../x']) assert.throws(() => normalizeBase(base));
+  assert.throws(() => documentHref('../secret.md', source));
+});
+test('remark handles reference links but leaves code examples unchanged', () => {
+  const tree = { type: 'root', children: [
+    { type: 'link', url: '4-client.md', children: [] },
+    { type: 'definition', url: '4-client.md#known-space' },
+    { type: 'code', value: '[example](4-client.md)' },
+  ] };
+  documentLinks() (tree, { path: source });
+  assert.equal(tree.children[0].url, '/book/4-client/');
+  assert.equal(tree.children[1].url, '/book/4-client/#known-space');
+  assert.equal(tree.children[2].value, '[example](4-client.md)');
+});