#424

frontend/src/lib/help.test.ts

@@ -0,0 +1,56 @@
+import { describe, expect, it } from 'vitest'
+
+import { createHelpFixture } from '@/test/helpFixtures'
+
+
+describe ('Help file catalogue', () => {
+  it ('uses current_edition rather than the newest file, without YAML titles', async () => {
+    const { api } = createHelpFixture ()
+    expect (api.getHelpArticle ('guide')?.languages.ja.currentEdition).toBe ('2026-10-02')
+    expect (await api.getHelpSearchEntries ('ja')).toEqual ([
+	{ identifier: 'guide', edition: '2026-10-02',
+	  title: 'ホーム', body: '\nタグを検索する' },
+	{ identifier: '設定 手順', edition: '2026-10-03',
+	  title: '設定', body: '\nタグを設定する' }])
+  })
+
+  it ('orders same-day editions numerically and separates languages', () => {
+    const { api } = createHelpFixture ()
+    expect (api.getHelpEditions ('guide', 'ja')).toEqual ([
+	'2026-10-01', '2026-10-02', '2026-10-02.2', '2026-10-02.3', '2026-10-02.10'])
+    expect (api.getHelpEditions ('guide', 'en')).toEqual (['2026-10-02'])
+  })
+
+  it ('derives each edition title from its first H1', async () => {
+    const { api, raw } = createHelpFixture ()
+    expect (await api.getHelpEditionText ('guide', 'ja', '2026-10-01'))
+	.toEqual ({ title: '旧ホーム', body: '\n過去限定本文' })
+    raw['../../help/guide/editions/ja/2026-10-02.mdx']
+	.mockResolvedValue ('\uFEFF# 改題\r\n\r\n本文\r\n# 別見出し')
+    expect (await api.getHelpEditionText ('guide', 'ja', '2026-10-02'))
+	.toEqual ({ title: '改題', body: '\r\n本文\r\n# 別見出し' })
+  })
+
+  it ('returns missing resources without substituting another edition', async () => {
+    const { api } = createHelpFixture ()
+    expect (api.getHelpArticle ('absent')).toBeNull ()
+    expect (api.getHelpEditions ('absent', 'ja')).toEqual ([])
+    expect (await api.getHelpEdition ('guide', 'ja', 'missing')).toBeNull ()
+    expect (await api.getHelpEditionText ('guide', 'fr', '2026-10-02')).toBeNull ()
+  })
+
+  it ('rejects a missing current file instead of silently hiding an article', async () => {
+    const { api, raw } = createHelpFixture ()
+    delete raw['../../help/guide/editions/ja/2026-10-02.mdx']
+    await expect (api.getHelpSearchEntries ('ja')).rejects.toThrow ()
+  })
+
+  it ('reports raw loading failures and missing leading H1', async () => {
+    const { api, raw } = createHelpFixture ()
+    const loader = raw['../../help/guide/editions/ja/2026-10-02.mdx']
+    loader.mockRejectedValueOnce (new Error ('fixture failure'))
+    await expect (api.getHelpSearchEntries ('ja')).rejects.toThrow ('fixture failure')
+    loader.mockResolvedValueOnce ('本文\n# 遅い見出し')
+    await expect (api.getHelpEditionText ('guide', 'ja', '2026-10-02')).rejects.toThrow ()
+  })
+})