@lincyaw/web 1.0.0-rc.0 → 1.0.0-rc.2

package/src/domain/app-config.ts

@@ -0,0 +1,91 @@
+import type { CrossFormLinks, NavItem, SiteShell } from './config.ts'
+import type { Neighbour, WebPage } from './pages.ts'
+import type { HomeDocument } from './workspace-home.ts'
+import type { SitePageLayout } from './themes.ts'
+import type { SiteLandingPage } from './landing.ts'
+
+/** The element of a page whose JSON tells the viewer app what the page is (`AppConfig`). */
+export const APP_CONFIG_ELEMENT = 'presmium-app'
+
+/** A language a document is shown in: its own, or a translation's below `<base><lang>/`. */
+export interface SiteLocale {
+  lang: string
+  label: string
+  /** The site path of the document in this language, ending with `/`. */
+  base: string
+  /** A translated document can choose a different page layout. */
+  layout?: SitePageLayout
+}
+
+/** What a page of the web form has around the document: the site's shell. */
+export interface SiteConfig {
+  /** The site's title: the document's, or the workspace's on its home page. */
+  title: string
+  /** The workspace brand and its root, shared by every document's shell. */
+  brandTitle?: string
+  root?: string
+  /** A page's presentation within the selected site theme. */
+  layout?: SitePageLayout
+  shell: SiteShell
+  /** The navigation in this page's language (a translation's own, when the workspace gives one). */
+  nav?: NavItem[]
+  /** The workspace's list of documents, when the document is one of several. */
+  home?: string
+  /** The document's languages, its own first; one when it has no translation. */
+  locales: SiteLocale[]
+  /** The workspace's documents in its order, for the sidebar; a document's first tag is its group there. */
+  documents?: { dir: string, title: string, href: string, group?: string }[]
+  /** The documents before and after this one in the workspace: the pager goes on to them. */
+  neighbours?: { prev?: Neighbour, next?: Neighbour }
+  links: CrossFormLinks
+}
+
+/**
+ * What the HTML of a page tells the viewer app (as JSON in `#presmium-app`): the same app shows every page of every
+ * document, in a built site, in a dev server and in the workbench, so what a page is comes with the page.
+ */
+export interface AppConfig {
+  /** A page of a document, the workspace's home page (its list of documents), or a page that does not exist. */
+  kind: 'document' | 'home' | 'missing'
+  /** The document's directory in the workspace (`''` for the document at its root). */
+  document: string
+  /** One compiled block in a read-only authoring widget; no live or source-edit transport. */
+  block?: string
+  /** The document's site path, ending with `/`: its pages, its published files and its plugins' run-time files. */
+  base: string
+  /** The language of the page; a translation's pages are below `<base><lang>/`. */
+  lang: string
+  /** The form the page shows: the document's pages (`web`, by default), or its slides alone. */
+  form?: 'web' | 'slides'
+  /** Where the page's IR is: JSON `{ revision, doc }`. */
+  ir?: string
+  /** The IR's changes as the dev server compiles them (server-sent events). */
+  events?: string
+  /** The Presmium server's routes (`<path>__presmium/<plugin>/…`), ending with `/`; `/` when omitted. */
+  server?: string
+  /** The document's own code (`document-bundle.ts`), when it has any. */
+  bundle?: string
+  /** The search index of the page's language (MiniSearch's JSON). */
+  search?: string
+  /** The page shown: `index` or a chapter's path (`webPages`). */
+  page?: string
+  /** The site's root shows every section of its canonical landing document on one page. */
+  landing?: boolean
+  /** A translation's pages, at the paths of the original's (`translationPages`); a document's own are its `webPages`. */
+  pages?: WebPage[]
+  site: SiteConfig
+  /** The workspace's documents, on its home page. */
+  documents?: HomeDocument[]
+  /** An independent website page; it does not use the teaching-document runtime. */
+  landingPage?: SiteLandingPage
+  /** The plugin packages whose browser parts the page runs: the document's (and the operator's, on a site); the home page's are the operator's. */
+  plugins?: string[]
+  /** Who may embed the page: the workbench's origins. */
+  origins: string[]
+  /** Where a dev server opens a source line in the author's editor. */
+  source?: string
+  /** A built site's offline service worker. */
+  serviceWorker?: string
+  /** Whether the page was rendered on the server: the app then hydrates it. */
+  rendered?: boolean
+}

package/src/domain/config.ts

@@ -1,13 +1,18 @@
 import { isRecord } from '@lincyaw/kernel'
 import { DEFAULT_LANG } from '@lincyaw/kernel/contracts'
+import { siteTheme } from './themes.ts'
+import type { SiteTheme } from './themes.ts'
 
 export const WEB_ID = 'presmium.web'
 
-export interface FormOptions {
+/** The settings that link the web form and the slides to each other. */
+export interface CrossFormLinks {
+  /** The document has slides: at `slidesUrl`, else beside its web form (`../slides`). */
   slides?: boolean
   slidesUrl?: string
+  /** The document has a web form: at `webUrl`, else beside its slides (`../web`). */
+  web?: boolean
   webUrl?: string
-  routerMode?: 'history' | 'hash'
 }
 
 export interface NavItem {
@@ -17,6 +22,7 @@ export interface NavItem {
 }
 
 export interface SiteShell {
+  theme?: SiteTheme
   nav?: NavItem[]
   footer?: { message?: string, copyright?: string }
   head?: { description?: string, image?: string }
@@ -37,8 +43,8 @@ function navItems(value: unknown): NavItem[] {
   })
 }
 
-export function siteShell(config: Record<string, unknown>): SiteShell {
-  const shell: SiteShell = {}
+export function siteShell(config: Record<string, unknown>, lang?: string): SiteShell {
+  const shell: SiteShell = { theme: siteTheme(config, lang) }
   const nav = navItems(config.nav)
   if (nav.length > 0) shell.nav = nav
   if (isRecord(config.footer)) {
@@ -66,17 +72,19 @@ function url(value: unknown): string | undefined {
   return typeof value === 'string' && value.trim() ? value.trim().replace(/\/+$/, '') : undefined
 }
 
-export function formOptions(presmium: unknown, renderers?: unknown): FormOptions {
+export function crossFormLinks(presmium: unknown, renderers?: unknown): CrossFormLinks {
   const all = isRecord(presmium) ? presmium : {}
   const config = { ...(isRecord(all.web) ? all.web : {}), ...(isRecord(all[WEB_ID]) ? all[WEB_ID] : {}) }
   const configured = isRecord(renderers) ? renderers : {}
   const slides = configured.slides
   const slidesUrl = url(config.slidesUrl)
+  const webUrl = url(config.webUrl)
+  const none = Object.keys(configured).length === 0
   return {
-    slides: Boolean(slidesUrl) || slides !== undefined || Object.keys(configured).length === 0,
+    slides: Boolean(slidesUrl) || slides !== undefined || none,
     slidesUrl,
-    webUrl: url(config.webUrl),
-    routerMode: isRecord(slides) && slides.routerMode === 'hash' ? 'hash' : 'history',
+    web: Boolean(webUrl) || configured.web !== undefined || none,
+    webUrl,
   }
 }
 
@@ -94,6 +102,6 @@ export function rendererConfig(ctx: { config: Record<string, unknown>, base: str
     port: Number.isInteger(port) && port > 0 ? port : undefined,
     lang: ctx.lang || DEFAULT_LANG,
     ...ctx.server ? { server: ctx.server.url } : {},
-    shell: siteShell(ctx.config),
+    shell: siteShell(ctx.config, ctx.lang),
   }
 }

package/src/domain/dev-updates.ts

@@ -0,0 +1,12 @@
+/** The event by which a dev server tells a page that its document changed. */
+export const UPDATE_EVENT = 'ir'
+
+/**
+ * A change of the document from the IR revision `base` to `revision`: the sections that changed (`update`) when the
+ * page has `base`; otherwise the page reads the whole IR again.
+ */
+export interface DevUpdateEvent<Update = unknown> {
+  revision: string
+  base?: string
+  update?: Update
+}

package/src/domain/index.ts

@@ -1,7 +1,17 @@
-export { formOptions, offlineEnabled, rendererConfig, siteShell, WEB_ID } from './config.ts'
-export type { FormOptions, NavItem, SiteShell, WebRendererConfig } from './config.ts'
-export { SITE_LABELS, WEB_MESSAGES } from './messages.ts'
-export { IR_ENDPOINT, requested, samePage, SERVER_PROXY, SERVICE_WORKER, SLIDE_PARAM, slideUrl, SOURCE_ENDPOINT, urlPath, viewSearch, webUrl } from './links.ts'
-export type { Requested } from './links.ts'
-export { neighbour, pageLink, pageMarkdown, pageOf, searchDocuments, sectionLinks, sidebar, toPages, translationPages } from './pages.ts'
-export type { Neighbour, SearchDocument, SidebarItem, WebPage } from './pages.ts'
+export { crossFormLinks, offlineEnabled, rendererConfig, siteShell, WEB_ID } from './config.ts'
+export type { CrossFormLinks, NavItem, SiteShell, WebRendererConfig } from './config.ts'
+export { UPDATE_EVENT } from './dev-updates.ts'
+export type { DevUpdateEvent } from './dev-updates.ts'
+export { WEB_MESSAGES } from './messages.ts'
+export { APP_CONFIG_ELEMENT } from './app-config.ts'
+export type { AppConfig, SiteConfig, SiteLocale } from './app-config.ts'
+export { parsePositionQuery, parsePrintQuery, positionUrl, PRINTED_ATTRIBUTE, printQuery, SERVICE_WORKER, SLIDE_PARAM, urlPath, withPositionQuery } from './links.ts'
+export type { SlidesPrintQuery } from './links.ts'
+export type { PositionQuery } from './links.ts'
+export { chapterRedirects, pageLink, SEARCH_FIELDS, searchDocuments, sectionLinks, translationPages, webPages } from './pages.ts'
+export type { Neighbour, SearchDocument, WebPage } from './pages.ts'
+export type { HomeDocument } from './workspace-home.ts'
+export { SITE_THEME_IDS, SITE_THEMES, siteTheme, sitePageLayout } from './themes.ts'
+export type { SiteTheme, SiteThemeId, SiteThemeParams, SitePageLayout } from './themes.ts'
+export { parseLandingPage, SITE_CONTENT_ELEMENT } from './landing.ts'
+export type { SiteAction, SiteHero, SiteLandingPage, SiteLandingSection, SiteContent, SiteContentDocument } from './landing.ts'

package/src/domain/landing.ts

@@ -0,0 +1,83 @@
+import { deckLocale, isRecord } from '@lincyaw/kernel'
+import { WEB_MESSAGES } from './messages.ts'
+
+export interface SiteAction { text: string, link: string, variant?: 'primary' | 'secondary' }
+export interface SiteHero { eyebrow?: string, title: string, description?: string, image?: string, imageAlt?: string, actions?: SiteAction[] }
+interface SiteSection { id: string, title?: string, description?: string }
+export type SiteLandingSection =
+  | SiteSection & { type: 'features', items: { title: string, description?: string, image?: string, imageAlt?: string, link?: string }[] }
+  | SiteSection & { type: 'documents', tags?: string[], directories?: string[] }
+  | SiteSection & { type: 'media', kind: 'image' | 'video', src: string, alt?: string, poster?: string, captions?: Record<string, string> }
+  | SiteSection & { type: 'text', body: string }
+  | SiteSection & { type: 'cta', title: string, actions: SiteAction[] }
+
+/** Website content is independent of teaching documents and may reference their published collection. */
+export interface SiteLandingPage { schemaVersion: 1, title: string, description?: string, hero?: SiteHero, sections: SiteLandingSection[] }
+
+export interface SiteContentDocument { id: string, title: string, href: string, description?: string, lang?: string, tags?: string[], pages?: number }
+export interface SiteContent { schemaVersion: 1, title: string, base: string, lang: string, documents: SiteContentDocument[] }
+export const SITE_CONTENT_ELEMENT = 'presmium-site-data'
+
+/** One validator for inline definitions and JSON files, used before replacing an existing build. */
+export function parseLandingPage(value: unknown, lang?: string): SiteLandingPage {
+  const fail = (path: string): never => { throw new Error(WEB_MESSAGES[deckLocale(lang)].invalidSiteParameter(path)) }
+  const record = (item: unknown, path: string): Record<string, unknown> => isRecord(item) ? item : fail(path)
+  const text = (item: unknown, path: string): string => typeof item === 'string' && item.trim() ? item.trim() : fail(path)
+  const optional = (item: unknown, path: string): string | undefined => item === undefined ? undefined : typeof item === 'string' ? item : fail(path)
+  const url = (item: unknown, path: string): string => {
+    const result = text(item, path)
+    if (/^(?:javascript|vbscript|data):/i.test(result)) fail(path)
+    return result
+  }
+  const strings = (item: unknown, path: string): string[] | undefined => item === undefined ? undefined : Array.isArray(item) ? item.map((word, i) => text(word, `${path}.${i}`)) : fail(path)
+  const actions = (item: unknown, path: string): SiteAction[] => {
+    if (!Array.isArray(item)) return fail(path)
+    return item.map((input, i) => {
+      const action = record(input, `${path}.${i}`)
+      if (action.variant !== undefined && action.variant !== 'primary' && action.variant !== 'secondary') fail(`${path}.${i}.variant`)
+      return { text: text(action.text, `${path}.${i}.text`), link: url(action.link, `${path}.${i}.link`), ...action.variant ? { variant: action.variant as SiteAction['variant'] } : {} }
+    })
+  }
+  const input = record(value, 'site.landing')
+  if (input.schemaVersion !== undefined && input.schemaVersion !== 1) fail('site.landing.schemaVersion')
+  const page: SiteLandingPage = { schemaVersion: 1, title: text(input.title, 'site.landing.title'), description: optional(input.description, 'site.landing.description'), sections: [] }
+  if (input.hero !== undefined) {
+    const hero = record(input.hero, 'site.landing.hero')
+    page.hero = {
+      title: text(hero.title, 'site.landing.hero.title'),
+      eyebrow: optional(hero.eyebrow, 'site.landing.hero.eyebrow'),
+      description: optional(hero.description, 'site.landing.hero.description'),
+      image: hero.image === undefined ? undefined : url(hero.image, 'site.landing.hero.image'),
+      imageAlt: optional(hero.imageAlt, 'site.landing.hero.imageAlt'),
+      actions: hero.actions === undefined ? undefined : actions(hero.actions, 'site.landing.hero.actions'),
+    }
+  }
+  if (!Array.isArray(input.sections)) fail('site.landing.sections')
+  const ids = new Set<string>()
+  page.sections = (input.sections as unknown[]).map((item, i): SiteLandingSection => {
+    const at = `site.landing.sections.${i}`, section = record(item, at)
+    const id = text(section.id, `${at}.id`)
+    if (ids.has(id) || /\s/.test(id) || id === 'pm-site-main') fail(`${at}.id`)
+    ids.add(id)
+    const common: SiteSection = { id, title: optional(section.title, `${at}.title`), description: optional(section.description, `${at}.description`) }
+    switch (section.type) {
+      case 'text': return { ...common, type: 'text', body: text(section.body, `${at}.body`) }
+      case 'cta': return { ...common, type: 'cta', title: text(section.title, `${at}.title`), actions: actions(section.actions, `${at}.actions`) }
+      case 'documents': return { ...common, type: 'documents', tags: strings(section.tags, `${at}.tags`), directories: strings(section.directories, `${at}.directories`) }
+      case 'features': {
+        if (!Array.isArray(section.items)) fail(`${at}.items`)
+        return { ...common, type: 'features', items: (section.items as unknown[]).map((item, j) => {
+          const feature = record(item, `${at}.items.${j}`)
+          return { title: text(feature.title, `${at}.items.${j}.title`), description: optional(feature.description, `${at}.items.${j}.description`), image: feature.image === undefined ? undefined : url(feature.image, `${at}.items.${j}.image`), imageAlt: optional(feature.imageAlt, `${at}.items.${j}.imageAlt`), link: feature.link === undefined ? undefined : url(feature.link, `${at}.items.${j}.link`) }
+        }) }
+      }
+      case 'media': {
+        if (section.kind !== 'image' && section.kind !== 'video') fail(`${at}.kind`)
+        const captions = section.captions === undefined ? undefined : Object.fromEntries(Object.entries(record(section.captions, `${at}.captions`)).map(([lang, file]) => [lang, url(file, `${at}.captions.${lang}`)]))
+        return { ...common, type: 'media', kind: section.kind as 'image' | 'video', src: url(section.src, `${at}.src`), alt: optional(section.alt, `${at}.alt`), poster: section.poster === undefined ? undefined : url(section.poster, `${at}.poster`), captions }
+      }
+      default: return fail(`${at}.type`)
+    }
+  })
+  return page
+}

package/src/domain/links.ts

@@ -1,37 +1,42 @@
 import type { IRDocument } from '@lincyaw/kernel'
-import type { FormOptions } from './config.ts'
 
 export function urlPath(path: string): string {
   return encodeURI(path).replace(/[#?]/g, char => encodeURIComponent(char))
 }
 
-export function samePage(a: string, b: string): boolean {
-  const page = (path: string) => path.replace(/(?:\.html|\/)$/, '')
-  return page(a) === page(b)
-}
-
 export const SERVICE_WORKER = 'presmium-sw.js'
 
-export const SOURCE_ENDPOINT = '/__presmium/source'
+export const SLIDE_PARAM = 'slide'
 
-export const IR_ENDPOINT = '/__presmium/ir'
+/** The address of a form's page (the web form's, or the slides') that shows a slide and its step. */
+export function positionUrl(base: string, slide: number, step = 0): string {
+  return `${base.replace(/\/$/, '')}/?${SLIDE_PARAM}=${slide}${step > 0 && Number.isFinite(step) ? `&step=${step}` : ''}`
+}
 
-export const SERVER_PROXY = '^/__presmium/(?!(?:ir|source)(?:[/?]|$))'
+/** What a slides page prints (an export): each slide at its last step, or every step with `steps`; `slides` by number from 1, else all. */
+export interface SlidesPrintQuery {
+  steps: boolean
+  slides?: number[]
+}
 
-export const SLIDE_PARAM = 'slide'
+/** The attribute of the root element of a printing page once its slides are ready to print. */
+export const PRINTED_ATTRIBUTE = 'data-presmium-printed'
 
-export function slideUrl(slidesUrl: string, options: FormOptions, slide: number, step = 0): string {
-  const path = `${options.routerMode === 'hash' ? '/#/' : '/'}${slide}`
-  return `${slidesUrl}${path}${step > 0 && Number.isFinite(step) ? `?clicks=${step}` : ''}`
+export function printQuery(print: SlidesPrintQuery): string {
+  return `?print${print.steps ? '&steps' : ''}${print.slides ? `&slides=${print.slides.join(',')}` : ''}`
 }
 
-export function webUrl(webBase: string, slide: number, step = 0): string {
-  return `${webBase}/?${SLIDE_PARAM}=${slide}${step > 0 ? `&step=${step}` : ''}`
+export function parsePrintQuery(search: string): SlidesPrintQuery | undefined {
+  const params = new URLSearchParams(search)
+  if (!params.has('print')) return undefined
+  const slides = params.get('slides')?.split(',').map(Number).filter(n => Number.isInteger(n) && n > 0)
+  return { steps: params.has('steps'), ...slides ? { slides } : {} }
 }
 
 const POSITION_PARAMS = [SLIDE_PARAM, 'section', 'step', 'view']
 
-export function viewSearch(search: string, position?: { view: string, section: string, step: number }): string {
+/** The query string with its position parameters replaced by the given position, or removed. */
+export function withPositionQuery(search: string, position?: { view: string, section: string, step: number }): string {
   const params = new URLSearchParams(search)
   for (const name of POSITION_PARAMS) params.delete(name)
   if (position) {
@@ -43,13 +48,13 @@ export function viewSearch(search: string, position?: { view: string, section: s
   return query ? `?${query}` : ''
 }
 
-export interface Requested {
+export interface PositionQuery {
   section?: string
   step?: number
   view?: string
 }
 
-export function requested(search: string, doc: IRDocument): Requested {
+export function parsePositionQuery(search: string, doc: IRDocument): PositionQuery {
   const params = new URLSearchParams(search)
   const slide = Number(params.get(SLIDE_PARAM))
   const section = params.get('section') ?? doc.sections[slide - 1]?.id

package/src/domain/messages.ts

@@ -2,7 +2,16 @@ import type { Locale } from '@lincyaw/kernel/contracts'
 
 export const WEB_MESSAGES = {
   'zh-CN': {
+    courseContents: '课程目录',
+    startReading: '开始阅读',
+    browseDocuments: '浏览文稿',
+    documentCount: (count: number) => `${count} 份文稿`,
+    unknownTheme: (name: string) => `找不到主题“${name}”。请选择 course、docs 或 showcase。`,
+    invalidSiteParameter: (name: string) => `站点配置 ${name} 无效。请检查主题配置中的值。`,
+    invalidLanding: '站点首页配置无效。请检查 site.landing 的独立页面定义或文稿目录，并只保留 site.landing 或 site.home。',
     viewMenu: '视图',
+    blockPreviewFailed: '无法显示此预览。请检查内容块与素材。',
+    startFailed: '无法打开此文稿。请重新加载页面。',
     openInSlides: '在幻灯片中打开',
     slides: '幻灯片',
     readOnWeb: '在网页中阅读',
@@ -10,96 +19,98 @@ export const WEB_MESSAGES = {
     pager: '翻页',
     mobileNav: '打开导航菜单',
     extraNav: '更多导航',
-    documents: '文档列表',
-    documentsHeading: '文档',
-    searchDocuments: '搜索文档',
+    documents: '文稿列表',
+    documentsHeading: '文稿',
+    searchDocuments: '搜索文稿',
     tags: '标签',
     allTags: '全部',
-    noDocuments: '没有文档',
+    noDocuments: '没有文稿',
     files: '工作区文件',
     search: '搜索',
     pages: (count: number) => `${count} 页`,
     checked: '检查通过',
     warnings: (count: number) => `${count} 个警告`,
     errors: (count: number) => `${count} 个错误`,
-    mcp: '连接外部 agent（MCP）',
     trail: '位置',
     close: '关闭',
+    skipToContent: '跳到正文',
+    outline: '本页大纲',
+    prevChapter: '上一页',
+    nextChapter: '下一页',
+    menu: '目录',
+    returnToTop: '回到顶部',
+    appearance: '外观',
+    toLight: '切换到浅色模式',
+    toDark: '切换到深色模式',
+    language: '切换语言',
+    notFound: '页面不存在',
+    notFoundText: '这个地址没有对应的页面，可能已经移动或删除。',
+    backHome: '返回首页',
+    searchPlaceholder: '搜索这份文稿',
+    noResults: (query: string) => `没有结果：“${query}”`,
+    keyEnter: '回车键',
+    keyUp: '上箭头',
+    keyDown: '下箭头',
+    keyEscape: 'Esc 键',
+    searchSelect: '选择',
+    searchNavigate: '切换',
+    searchClose: '关闭',
+    searchShortcut: 'Ctrl K',
   },
   'en': {
+    courseContents: 'Course Contents',
+    startReading: 'Start Reading',
+    browseDocuments: 'Browse Documents',
+    documentCount: (count: number) => `${count} ${count === 1 ? 'document' : 'documents'}`,
+    unknownTheme: (name: string) => `Theme “${name}” was not found. Choose course, docs or showcase.`,
+    invalidSiteParameter: (name: string) => `Site setting ${name} is invalid. Check the value in the theme configuration.`,
+    invalidLanding: 'The site home configuration is invalid. Check the independent page definition or document directory in site.landing, and use either site.landing or site.home.',
     viewMenu: 'View',
-    openInSlides: 'Open in the slides',
+    blockPreviewFailed: 'Couldn’t show this preview. Check its blocks and assets.',
+    startFailed: 'Couldn’t open this document. Please reload the page.',
+    openInSlides: 'Open in Slides',
     slides: 'Slides',
-    readOnWeb: 'Read on the web',
+    readOnWeb: 'Read on the Web',
     sidebarNav: 'Sidebar Navigation',
     pager: 'Pager',
-    mobileNav: 'mobile navigation',
-    extraNav: 'extra navigation',
+    mobileNav: 'Open Navigation Menu',
+    extraNav: 'More Navigation',
     documents: 'Documents',
     documentsHeading: 'Documents',
-    searchDocuments: 'Search the documents',
+    searchDocuments: 'Search documents',
     tags: 'Tags',
     allTags: 'All',
     noDocuments: 'No documents',
-    files: 'Workspace files',
+    files: 'Workspace Files',
     search: 'Search',
     pages: (count: number) => `${count} ${count === 1 ? 'page' : 'pages'}`,
     checked: 'Checks pass',
     warnings: (count: number) => `${count} ${count === 1 ? 'warning' : 'warnings'}`,
     errors: (count: number) => `${count} ${count === 1 ? 'error' : 'errors'}`,
-    mcp: 'Connect an outside agent (MCP)',
     trail: 'Location',
     close: 'Close',
-  },
-} satisfies Record<Locale, unknown>
-
-export const SITE_LABELS = {
-  'zh-CN': {
-    themeConfig: {
-      outline: { level: [2, 3], label: '本页大纲' },
-      docFooter: { prev: '上一章', next: '下一章' },
-      sidebarMenuLabel: '目录',
-      returnToTopLabel: '回到顶部',
-      darkModeSwitchLabel: '外观',
-      lightModeSwitchTitle: '切换到浅色模式',
-      darkModeSwitchTitle: '切换到深色模式',
-      skipToContentLabel: '跳到正文',
-      langMenuLabel: '切换语言',
-      lastUpdated: { text: '最后更新于' },
-      notFound: {
-        title: '页面不存在',
-        quote: '这个地址没有对应的页面，可能已经移动或删除。',
-        linkLabel: '返回首页',
-        linkText: '返回首页',
-      },
-    },
-    search: {
-      button: { buttonText: '搜索', buttonAriaLabel: '搜索' },
-      modal: {
-        displayDetails: '显示详细列表',
-        resetButtonTitle: '清除',
-        backButtonTitle: '关闭搜索',
-        noResultsText: '没有结果',
-        footer: {
-          selectText: '选择',
-          selectKeyAriaLabel: '回车键',
-          navigateText: '切换',
-          navigateUpKeyAriaLabel: '上箭头',
-          navigateDownKeyAriaLabel: '下箭头',
-          closeText: '关闭',
-          closeKeyAriaLabel: 'Esc 键',
-        },
-      },
-    } as Record<string, unknown> | undefined,
-  },
-  'en': {
-    themeConfig: {
-      outline: { level: [2, 3], label: 'On this page' },
-      docFooter: { prev: 'Previous chapter', next: 'Next chapter' },
-      sidebarMenuLabel: 'Menu',
-      returnToTopLabel: 'Return to top',
-      darkModeSwitchLabel: 'Appearance',
-    },
-    search: undefined as Record<string, unknown> | undefined,
+    skipToContent: 'Skip to Content',
+    outline: 'On This Page',
+    prevChapter: 'Previous Page',
+    nextChapter: 'Next Page',
+    menu: 'Menu',
+    returnToTop: 'Return to Top',
+    appearance: 'Appearance',
+    toLight: 'Switch to Light Mode',
+    toDark: 'Switch to Dark Mode',
+    language: 'Change Language',
+    notFound: 'Page Not Found',
+    notFoundText: 'Nothing is at this address; it may have moved or been removed.',
+    backHome: 'Back to Home',
+    searchPlaceholder: 'Search this document',
+    noResults: (query: string) => `No results for “${query}”`,
+    keyEnter: 'Enter',
+    keyUp: 'Up arrow',
+    keyDown: 'Down arrow',
+    keyEscape: 'Esc',
+    searchSelect: 'to select',
+    searchNavigate: 'to navigate',
+    searchClose: 'to close',
+    searchShortcut: 'Ctrl K',
   },
 } satisfies Record<Locale, unknown>