docs(site): publish translated core data pages

scripts/project-doc-site.spec.ts

@@ -178,7 +178,7 @@ describe('docsPages locale routes', () => {
       const counterpart = byRoute.get(`en/${page.route}`)
       expect(counterpart, page.route).toBeDefined()
       expect(counterpart?.locale).toBe('en')
-      if (page.source.startsWith('docs/user/') || page.route === 'reference/cordis-primer.md') {
+      if (page.contentLocale === 'zh-CN') {
         expect(page.source).toMatch(/\.zh\.md$/)
         expect(page.contentLocale).toBe('zh-CN')
         expect(counterpart?.source).toBe(page.source.replace(/\.zh\.md$/, '.md'))
@@ -190,6 +190,22 @@ describe('docsPages locale routes', () => {
     }
   })
 
+  it('projects translated core-data pages while retaining explicit English fallbacks', () => {
+    const rootPages = docsPages.filter(page => (
+      page.locale === 'root' && page.route.startsWith('reference/core-data-structures/')
+    ))
+    const translated = rootPages.filter(page => page.contentLocale === 'zh-CN')
+    const fallbacks = rootPages.filter(page => page.contentLocale === 'en-US')
+
+    expect(translated).toHaveLength(18)
+    expect(translated.every(page => page.source.endsWith('.zh.md'))).toBe(true)
+    expect(fallbacks.map(page => page.source).sort()).toEqual([
+      'docs/core-data-structures/commands.md',
+      'docs/core-data-structures/goal.md',
+      'docs/core-data-structures/pty.md',
+    ])
+  })
+
   it('publishes the Cordis core API under matching locale structures', () => {
     const files = ['context.md', 'events.md', 'fiber.md', 'registry.md', 'service.md']
     for (const file of files) {

website/docs.ts

@@ -237,6 +237,35 @@ const cordisPrimerReference = pairedPages([
   },
 ])
 
+const coreDataReference = pairedPages(([
+  ['core.md', '核心数据结构', 'Core data structures', 0],
+  ['scope.md', '作用域', 'Scopes', 1],
+  ['session.md', '会话', 'Sessions', 2],
+  ['system-prompt.md', '系统提示词', 'System prompts', 4],
+  ['tools.md', '工具', 'Tools', 5],
+  ['llm-streaming.md', 'LLM 流式响应', 'LLM streaming', 6],
+  ['bash.md', 'Bash 执行', 'Bash execution', 7],
+  ['filesystem.md', '文件系统', 'Filesystem', 9],
+  ['code-runtime.md', '代码运行时', 'Code runtime', 10],
+  ['compaction.md', '上下文压缩', 'Compaction', 11],
+  ['subagent.md', '子代理', 'Subagents', 12],
+  ['workflow.md', '工作流', 'Workflows', 13],
+  ['skills.md', '技能', 'Skills', 14],
+  ['approval.md', '审批', 'Approvals', 15],
+  ['user-interaction.md', '用户交互', 'User interaction', 16],
+  ['sandbox.md', '沙箱', 'Sandboxing', 18],
+  ['web.md', 'Web 访问', 'Web access', 19],
+  ['persistence.md', '会话持久化', 'Session persistence', 20],
+] as const).map(([file, rootLabel, enLabel, order]): PairedPage => ({
+  source: `docs/core-data-structures/${file}`,
+  route: `reference/core-data-structures/${file}`,
+  label: { root: rootLabel, en: enLabel },
+  sidebar: { root: 'zh-reference', en: 'en-reference' },
+  section: { root: '数据结构', en: 'Data structures' },
+  order,
+  ...(file === 'core.md' ? { sourceAliases: ['docs/core-data-structures'] } : {}),
+})))
+
 const reference = mirroredPages([
   ...([
     ['docs/architecture.md', 'reference/index.md', '架构', 'Architecture', 0],
@@ -283,28 +312,10 @@ const reference = mirroredPages([
     order,
   })),
   ...([
-    ['core.md', '核心数据结构', 'Core data structures'],
+    ['goal.md', '目标', 'Goals', 3],
-    ['scope.md', '作用域', 'Scopes'],
+    ['pty.md', 'PTY 会话', 'PTY sessions', 8],
-    ['session.md', '会话', 'Sessions'],
+    ['commands.md', '命令', 'Human commands', 17],
-    ['goal.md', '目标', 'Goals'],
+  ] as const).map(([file, rootLabel, enLabel, order]): MirroredPage => ({
-    ['system-prompt.md', '系统提示词', 'System prompts'],
-    ['tools.md', '工具', 'Tools'],
-    ['llm-streaming.md', 'LLM 流式响应', 'LLM streaming'],
-    ['bash.md', 'Bash 执行', 'Bash execution'],
-    ['pty.md', 'PTY 会话', 'PTY sessions'],
-    ['filesystem.md', '文件系统', 'Filesystem'],
-    ['code-runtime.md', '代码运行时', 'Code runtime'],
-    ['compaction.md', '上下文压缩', 'Compaction'],
-    ['subagent.md', '子代理', 'Subagents'],
-    ['workflow.md', '工作流', 'Workflows'],
-    ['skills.md', '技能', 'Skills'],
-    ['approval.md', '审批', 'Approvals'],
-    ['user-interaction.md', '用户交互', 'User interaction'],
-    ['commands.md', '命令', 'Human commands'],
-    ['sandbox.md', '沙箱', 'Sandboxing'],
-    ['web.md', 'Web 访问', 'Web access'],
-    ['persistence.md', '会话持久化', 'Session persistence'],
-  ] as const).map(([file, rootLabel, enLabel], order): MirroredPage => ({
     source: `docs/core-data-structures/${file}`,
     route: `reference/core-data-structures/${file}`,
     contentLocale: 'en-US',
@@ -312,7 +323,6 @@ const reference = mirroredPages([
     sidebar: { root: 'zh-reference', en: 'en-reference' },
     section: { root: '数据结构', en: 'Data structures' },
     order,
-    ...(file === 'core.md' ? { sourceAliases: ['docs/core-data-structures'] } : {}),
   })),
   ...([
     ['adding-a-package.md', '新增 Package', 'Adding a package'],
@@ -336,5 +346,6 @@ export const docsPages: DocsPage[] = [
   ...develop,
   ...cordisTutorial,
   ...cordisPrimerReference,
+  ...coreDataReference,
   ...reference,
 ]