@lincyaw/web 0.0.0-stage → 1.0.0-rc.0

package/src/client/theme.ts

@@ -0,0 +1,322 @@
+import { createServerClient, createSharedStates, currentLocale, installHost, OPERATIONS, pluginsOf, PmIcon, PmPresenterPanels, PmToolbar, presmiumService, provideServer, registerPresmiumPlugin, reportPluginFailure, startHost, stopPresmium } from '@lincyaw/host'
+import type { ServerClient, SyncTransports } from '@lincyaw/host'
+import { errorMessage } from '@lincyaw/kernel'
+import type { IRDocument } from '@lincyaw/kernel'
+import { createViewer, followOperations, getView, installViewer, installViewerPlugin, OverlayHost, PmComponentFallback, registerComponent, useViewer, withSlideGlobals } from '@lincyaw/viewer'
+import type { LiveUpdate, Position, Viewer } from '@lincyaw/viewer'
+import { applyUpdate } from '@lincyaw/viewer/domain'
+import type { Theme } from 'vitepress'
+import { inBrowser, useData, withBase } from 'vitepress'
+import DefaultTheme from 'vitepress/theme-without-fonts'
+import type { Component } from 'vue'
+import { computed, defineAsyncComponent, defineComponent, h, nextTick, onMounted, ref, shallowRef, watch } from 'vue'
+import { IR_ENDPOINT, offlineEnabled, requested, samePage, SERVICE_WORKER, sectionLinks, sidebar, slideUrl, SOURCE_ENDPOINT, toPages, translationPages, viewSearch, WEB_MESSAGES } from '../domain/index.ts'
+import type { FormOptions } from '../domain/index.ts'
+import { createViewerHost, createViewerNavigation } from './host.ts'
+import { PAGES, PresmiumPage, ViewMenu } from './page.ts'
+import type { WebPreviewPage } from './preview.ts'
+import './style.css'
+
+export interface ViewerModule {
+  name: string
+  load: () => Promise<unknown>
+}
+
+export interface ThemeInput {
+  doc: IRDocument
+  revision?: string
+  components: Record<string, () => Promise<unknown>>
+  plugins: (() => Promise<unknown>)[]
+  viewers?: ViewerModule[]
+  translations?: Record<string, () => Promise<{ default: IRDocument }>>
+  preview?: (page: WebPreviewPage) => void
+}
+
+interface ThemeOptions {
+  form?: FormOptions
+  server?: boolean
+  document?: string
+  home?: string
+  ir?: string
+}
+
+interface UpdateEvent {
+  update: LiveUpdate
+  base: string
+  revision: string
+}
+
+async function startKernel(loaders: ThemeInput['plugins'], doc: IRDocument, viewer: Viewer, transports: SyncTransports, server?: ServerClient): Promise<void> {
+  const config = doc.config.presmium
+  const modules = await Promise.all(loaders.map(load => load().catch((error) => {
+    console.error('[presmium] a plugin module failed to load', error)
+    return {}
+  })))
+  modules.flatMap(module => pluginsOf(module, config)).forEach(registerPresmiumPlugin)
+  await startHost({ mode: 'document', config, navigation: createViewerNavigation(viewer), transports, server, environments: doc.config.execute?.environments })
+}
+
+function clientOnly(name: string, load: () => Promise<unknown>): Component {
+  const loaded = defineAsyncComponent(() => load().then(module => withSlideGlobals((module as { default: Component }).default)))
+  return defineComponent({
+    name,
+    inheritAttrs: false,
+    setup(_, { attrs, slots }) {
+      const mounted = ref(false)
+      onMounted(() => {
+        mounted.value = true
+      })
+      return () => (mounted.value
+        ? h(loaded, attrs, slots)
+        : h('div', { 'class': 'pm-client-only', 'data-component': name }, [h(PmComponentFallback)]))
+    },
+  })
+}
+
+async function loadViewerPlugins(modules: ViewerModule[]): Promise<void> {
+  await Promise.all(modules.map(async ({ name, load }) => {
+    const id = `${name} (viewer)`
+    try {
+      const reason = installViewerPlugin(((await load()) as { default?: unknown }).default, id)
+      if (reason) reportPluginFailure(id, reason)
+    } catch (error) {
+      console.error(`[presmium] ${id} failed to load`, error)
+      reportPluginFailure(id, errorMessage(error))
+    }
+  }))
+}
+
+function serviceWorker(offline: boolean): void {
+  if (!('serviceWorker' in navigator)) return
+  if (!offline) {
+    void navigator.serviceWorker.getRegistrations().then(registrations => registrations
+      .filter(registration => (registration.active ?? registration.waiting ?? registration.installing)?.scriptURL.endsWith(`/${SERVICE_WORKER}`))
+      .forEach(registration => void registration.unregister()))
+    return
+  }
+  const register = () => navigator.serviceWorker.register(withBase(`/${SERVICE_WORKER}`)).catch((error) => {
+    console.warn('[presmium] offline support unavailable', error)
+  })
+  if (document.readyState === 'complete') void register()
+  else window.addEventListener('load', register, { once: true })
+}
+
+function slidesIcon() {
+  return h('svg', { 'viewBox': '0 0 24 24', 'width': '1em', 'height': '1em', 'aria-hidden': 'true', 'fill': 'none', 'stroke': 'currentColor', 'stroke-width': 2, 'stroke-linecap': 'round', 'stroke-linejoin': 'round' }, [
+    h('rect', { x: 2, y: 3, width: 20, height: 14, rx: 2 }),
+    h('path', { d: 'M8 21h8M12 17v4' }),
+  ])
+}
+
+function localizeHiddenLabels(): void {
+  const t = WEB_MESSAGES[currentLocale()]
+  for (const [id, text] of [['sidebar-aria-label', t.sidebarNav], ['doc-footer-aria-label', t.pager]] as const) {
+    const label = document.getElementById(id)
+    if (label && label.textContent !== text) label.textContent = text
+  }
+  for (const [selector, text] of [['.VPNavBarHamburger', t.mobileNav], ['.VPNavBarExtra > button', t.extraNav]] as const) {
+    for (const button of document.querySelectorAll(selector)) {
+      if (button.getAttribute('aria-label') !== text) button.setAttribute('aria-label', text)
+    }
+  }
+}
+
+const slidesBase = ref<string>()
+let preview: ThemeInput['preview']
+let viewersReady: Promise<void> = Promise.resolve()
+
+const Layout = defineComponent({
+  name: 'PresmiumLayout',
+  setup() {
+    const viewer = useViewer()
+    const { theme, page, isDark } = useData()
+    onMounted(async () => {
+      const agent = preview
+      preview = undefined
+      agent?.({ viewer, dark: isDark })
+      localizeHiddenLabels()
+      watch(() => page.value.relativePath, () => void nextTick(localizeHiddenLabels), { flush: 'post' })
+      const form: FormOptions = theme.value.presmium?.form ?? {}
+      if (form.slides) slidesBase.value = form.slidesUrl ?? new URL('../slides', new URL(withBase('/'), location.href)).href
+      const ask = requested(location.search, viewer.doc.value)
+      if (ask.section || ask.view) {
+        history.replaceState(history.state, '', location.pathname + viewSearch(location.search) + location.hash)
+        if (ask.section) viewer.show({ section: ask.section, step: ask.step ?? 0 })
+        if (ask.view) {
+          await viewersReady
+          if (getView(ask.view)) viewer.setView(ask.view)
+        }
+      }
+      watch([viewer.view, viewer.position], ([view, position]) => {
+        const search = viewSearch(location.search, getView(view)?.kind === 'overlay' ? { view, ...position } : undefined)
+        if (search !== location.search) history.replaceState(history.state, '', location.pathname + search + location.hash)
+      }, { immediate: true })
+    })
+    const home = () => {
+      const href = theme.value.presmium?.home
+      return href ? h('a', { class: 'pm-site-link', href }, [h(PmIcon, { name: 'arrow-left', size: 14, strokeWidth: 2 }), WEB_MESSAGES[currentLocale()].documents]) : null
+    }
+    const footer = () => {
+      const { message, copyright } = (theme.value.footer ?? {}) as { message?: string, copyright?: string }
+      if (!message && !copyright) return null
+      return h('footer', { class: 'pm-site-footer' }, [
+        message ? h('p', { class: 'pm-site-footer__message', innerHTML: message }) : null,
+        copyright ? h('p', { class: 'pm-site-footer__copyright', innerHTML: copyright }) : null,
+      ])
+    }
+    return () => h(DefaultTheme.Layout, null, {
+      'nav-bar-content-after': () => [home(), h(ViewMenu, { class: 'pm-view-menu--bar' }), h(PmToolbar, { class: 'pm-toolbar--bar' })],
+      'nav-screen-content-after': () => [home(), h(ViewMenu, { class: 'pm-view-menu--screen' }), h(PmToolbar, { class: 'pm-toolbar--screen' })],
+      'doc-after': footer,
+      'layout-bottom': () => [
+        h('div', { class: 'vp-doc pm-overlay-views' }, [h(OverlayHost)]),
+        viewer.view.value === 'presenter' ? h(PmPresenterPanels, { to: '.pm-presenter__side', docked: true }) : null,
+      ],
+    })
+  },
+})
+
+function followDevServer(original: () => IRDocument, revision: string | undefined, endpoint: string, follow: (doc: IRDocument) => void): void {
+  const hot = import.meta.hot
+  if (!hot) return
+  let current = revision
+  let updates = 0
+  let asked = 0
+  let answered = 0
+  const fetchCurrent = async () => {
+    const request = ++asked
+    const since = updates
+    try {
+      const response = await fetch(endpoint, { cache: 'no-store' })
+      if (!response.ok) return
+      const { revision: latest, doc } = await response.json() as { revision: string, doc: IRDocument }
+      if (updates !== since || request < answered || latest === current) return
+      answered = request
+      current = latest
+      follow(doc)
+    } catch (error) {
+      console.warn('[presmium] could not get the current document from the dev server', error)
+    }
+  }
+  hot.on('presmium:update', ({ update, base, revision: next }: UpdateEvent) => {
+    if (base !== current) {
+      void fetchCurrent()
+      return
+    }
+    current = next
+    updates++
+    follow(applyUpdate(original(), update))
+  })
+  hot.on('vite:ws:connect', () => void fetchCurrent())
+  void fetchCurrent()
+}
+
+function localeOf(path: string, base: string, langs: string[]): string {
+  const rest = path.startsWith(base) ? path.slice(base.length) : path.replace(/^\//, '')
+  const first = rest.split('/')[0]!
+  return langs.includes(first) ? first : 'root'
+}
+
+export function createPresmiumTheme(input: ThemeInput): Theme {
+  return {
+    extends: DefaultTheme,
+    Layout,
+    enhanceApp({ app, router, siteData }) {
+      const presmium: ThemeOptions = siteData.value.themeConfig.presmium ?? {}
+      const form: FormOptions = presmium.form ?? {}
+      const translations = input.translations ?? {}
+      const langs = Object.keys(translations)
+      const original = shallowRef(input.doc)
+      const locale = ref('root')
+      const loaded = new Map<string, Promise<IRDocument>>()
+      const documentOf = (lang: string): Promise<IRDocument> => {
+        if (lang === 'root' || !translations[lang]) return Promise.resolve(original.value)
+        let doc = loaded.get(lang)
+        if (!doc) loaded.set(lang, doc = translations[lang]().then(module => module.default))
+        return doc
+      }
+      const pages = computed(() => (locale.value === 'root' ? toPages(current.doc.value) : translationPages(current.doc.value, toPages(original.value))))
+      const prefix = computed(() => (locale.value === 'root' ? '' : `/${locale.value}`))
+      const links = computed(() => sectionLinks(pages.value, prefix.value))
+      const pageOf = (position: Position) => withBase((links.value[position.section] ?? `${prefix.value}/`).split('#')[0]!)
+      const current = createViewer(input.doc, {
+        renderer: 'web',
+        sectionHref: id => withBase(links.value[id] ?? `${prefix.value}/#${id}`),
+        sectionHeading(section, step) {
+          if (!slidesBase.value) return null
+          const t = WEB_MESSAGES[currentLocale()]
+          return h('a', {
+            'class': 'pm-open-slides',
+            'href': slideUrl(slidesBase.value, form, section.index, step),
+            'title': t.openInSlides,
+            'aria-label': t.openInSlides,
+            'data-label': t.slides,
+          }, [slidesIcon()])
+        },
+        diagnostics: import.meta.env.DEV,
+        openSource: import.meta.env.DEV && presmium.document === undefined
+          ? source => void fetch(`${SOURCE_ENDPOINT}?file=${encodeURIComponent(source.file)}&line=${source.line}`, { method: 'POST', headers: { 'Presmium-Request': 'source' } })
+          : undefined,
+        navigate: position => void router.go(pageOf(position)),
+        openPresenter(position) {
+          const url = new URL(location.href)
+          url.hash = ''
+          url.search = viewSearch(url.search, { view: 'presenter', ...position })
+          window.open(url.href, 'presmium-presenter', 'popup,width=1100,height=720')
+        },
+      })
+      router.onBeforePageLoad = async (to) => {
+        if (locale.value === 'root') original.value = current.doc.value
+        const lang = localeOf(new URL(to, 'http://site').pathname, siteData.value.base, langs)
+        const doc = await documentOf(lang)
+        locale.value = lang
+        if (current.doc.value !== doc) current.replace(doc)
+      }
+      const ownPage = (path: string) => {
+        const { base } = siteData.value
+        if (!path.startsWith(base)) return false
+        const lang = localeOf(path, base, langs)
+        let rest = path.slice(base.length + (lang === 'root' ? 0 : lang.length + 1))
+        try {
+          rest = decodeURI(rest)
+        } catch {
+        }
+        const name = rest === '' || rest === 'index.html' ? 'index' : rest.replace(/\.html$/, '')
+        return toPages(original.value).some(page => page.path === name) || (lang !== 'root' && pages.value.some(page => page.path === name))
+      }
+      router.onBeforeRouteChange = (to) => {
+        if (!inBrowser) return
+        const url = new URL(to, location.href)
+        if (url.origin !== location.origin || samePage(url.pathname, location.pathname) || ownPage(url.pathname)) return
+        location.assign(url.href)
+        return false
+      }
+      const shared = createSharedStates(input.doc.meta.title)
+      installHost(app, createViewerHost(current, { lang: siteData.value.lang, shared }))
+      installViewer(app, current)
+      app.provide(PAGES, { pages, prefix })
+      app.component('PresmiumPage', PresmiumPage)
+      for (const [name, load] of Object.entries(input.components)) registerComponent(name, clientOnly(name, load))
+      if (!inBrowser) return
+      preview = input.preview
+      viewersReady = loadViewerPlugins(input.viewers ?? [])
+      const server = presmium.server ? createServerClient({ document: presmium.document }) : undefined
+      provideServer(server)
+      void startKernel(input.plugins, input.doc, current, shared.transports, server)
+      watch(() => presmiumService(OPERATIONS), (operations, _, onCleanup) => {
+        if (operations) onCleanup(followOperations(current, operations))
+      }, { immediate: true })
+      if (import.meta.env.PROD) serviceWorker(offlineEnabled(input.doc.config.presmium))
+      followDevServer(() => original.value, input.revision, presmium.ir ?? IR_ENDPOINT, (doc) => {
+        original.value = doc
+        if (locale.value === 'root') current.replace(doc)
+        const site = siteData.value
+        const nav = sidebar(doc, toPages(doc))
+        if (site.title === doc.meta.title && JSON.stringify(site.themeConfig.sidebar) === JSON.stringify(nav)) return
+        siteData.value = { ...site, title: doc.meta.title, themeConfig: { ...site.themeConfig, sidebar: nav } }
+      })
+    },
+  }
+}
+
+import.meta.hot?.dispose(() => stopPresmium())

package/src/domain/config.ts

@@ -0,0 +1,99 @@
+import { isRecord } from '@lincyaw/kernel'
+import { DEFAULT_LANG } from '@lincyaw/kernel/contracts'
+
+export const WEB_ID = 'presmium.web'
+
+export interface FormOptions {
+  slides?: boolean
+  slidesUrl?: string
+  webUrl?: string
+  routerMode?: 'history' | 'hash'
+}
+
+export interface NavItem {
+  text: string
+  link?: string
+  items?: NavItem[]
+}
+
+export interface SiteShell {
+  nav?: NavItem[]
+  footer?: { message?: string, copyright?: string }
+  head?: { description?: string, image?: string }
+  sitemap?: { hostname: string }
+}
+
+function text(value: unknown): string | undefined {
+  return typeof value === 'string' && value.trim() ? value.trim() : undefined
+}
+
+function navItems(value: unknown): NavItem[] {
+  if (!Array.isArray(value)) return []
+  return value.flatMap((item): NavItem[] => {
+    if (!isRecord(item) || !text(item.text)) return []
+    const items = navItems(item.items)
+    const link = text(item.link)
+    return link || items.length > 0 ? [{ text: text(item.text)!, ...link ? { link } : {}, ...items.length > 0 ? { items } : {} }] : []
+  })
+}
+
+export function siteShell(config: Record<string, unknown>): SiteShell {
+  const shell: SiteShell = {}
+  const nav = navItems(config.nav)
+  if (nav.length > 0) shell.nav = nav
+  if (isRecord(config.footer)) {
+    const footer = { message: text(config.footer.message), copyright: text(config.footer.copyright) }
+    if (footer.message || footer.copyright) shell.footer = Object.fromEntries(Object.entries(footer).filter(([, v]) => v)) as SiteShell['footer']
+  }
+  if (isRecord(config.head)) {
+    const head = { description: text(config.head.description), image: text(config.head.image) }
+    if (head.description || head.image) shell.head = Object.fromEntries(Object.entries(head).filter(([, v]) => v)) as SiteShell['head']
+  }
+  const hostname = isRecord(config.sitemap) ? text(config.sitemap.hostname) : undefined
+  if (hostname) shell.sitemap = { hostname: hostname.replace(/\/+$/, '') }
+  return shell
+}
+
+export interface WebRendererConfig {
+  base: string
+  port?: number
+  lang: string
+  server?: string
+  shell: SiteShell
+}
+
+function url(value: unknown): string | undefined {
+  return typeof value === 'string' && value.trim() ? value.trim().replace(/\/+$/, '') : undefined
+}
+
+export function formOptions(presmium: unknown, renderers?: unknown): FormOptions {
+  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)
+  return {
+    slides: Boolean(slidesUrl) || slides !== undefined || Object.keys(configured).length === 0,
+    slidesUrl,
+    webUrl: url(config.webUrl),
+    routerMode: isRecord(slides) && slides.routerMode === 'hash' ? 'hash' : 'history',
+  }
+}
+
+const PUBLISH_ID = 'presmium.publish'
+
+export function offlineEnabled(presmium: unknown): boolean {
+  const publish = isRecord(presmium) ? presmium[PUBLISH_ID] : undefined
+  return !(isRecord(publish) && publish.offline === false)
+}
+
+export function rendererConfig(ctx: { config: Record<string, unknown>, base: string, lang?: string, server?: { url: string } }): WebRendererConfig {
+  const port = Number(ctx.config.port)
+  return {
+    base: ctx.base,
+    port: Number.isInteger(port) && port > 0 ? port : undefined,
+    lang: ctx.lang || DEFAULT_LANG,
+    ...ctx.server ? { server: ctx.server.url } : {},
+    shell: siteShell(ctx.config),
+  }
+}

package/src/domain/index.ts

@@ -0,0 +1,7 @@
+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'

package/src/domain/links.ts

@@ -0,0 +1,62 @@
+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 IR_ENDPOINT = '/__presmium/ir'
+
+export const SERVER_PROXY = '^/__presmium/(?!(?:ir|source)(?:[/?]|$))'
+
+export const SLIDE_PARAM = 'slide'
+
+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 webUrl(webBase: string, slide: number, step = 0): string {
+  return `${webBase}/?${SLIDE_PARAM}=${slide}${step > 0 ? `&step=${step}` : ''}`
+}
+
+const POSITION_PARAMS = [SLIDE_PARAM, 'section', 'step', 'view']
+
+export function viewSearch(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) {
+    params.set('view', position.view)
+    params.set('section', position.section)
+    params.set('step', String(position.step))
+  }
+  const query = params.toString()
+  return query ? `?${query}` : ''
+}
+
+export interface Requested {
+  section?: string
+  step?: number
+  view?: string
+}
+
+export function requested(search: string, doc: IRDocument): Requested {
+  const params = new URLSearchParams(search)
+  const slide = Number(params.get(SLIDE_PARAM))
+  const section = params.get('section') ?? doc.sections[slide - 1]?.id
+  const step = Number(params.get('step'))
+  return {
+    section: doc.sections.some(s => s.id === section) ? section! : undefined,
+    step: Number.isInteger(step) && step >= 0 ? step : undefined,
+    view: params.get('view') ?? undefined,
+  }
+}

package/src/domain/messages.ts

@@ -0,0 +1,105 @@
+import type { Locale } from '@lincyaw/kernel/contracts'
+
+export const WEB_MESSAGES = {
+  'zh-CN': {
+    viewMenu: '视图',
+    openInSlides: '在幻灯片中打开',
+    slides: '幻灯片',
+    readOnWeb: '在网页中阅读',
+    sidebarNav: '侧边栏导航',
+    pager: '翻页',
+    mobileNav: '打开导航菜单',
+    extraNav: '更多导航',
+    documents: '文档列表',
+    documentsHeading: '文档',
+    searchDocuments: '搜索文档',
+    tags: '标签',
+    allTags: '全部',
+    noDocuments: '没有文档',
+    files: '工作区文件',
+    search: '搜索',
+    pages: (count: number) => `${count} 页`,
+    checked: '检查通过',
+    warnings: (count: number) => `${count} 个警告`,
+    errors: (count: number) => `${count} 个错误`,
+    mcp: '连接外部 agent（MCP）',
+    trail: '位置',
+    close: '关闭',
+  },
+  'en': {
+    viewMenu: 'View',
+    openInSlides: 'Open in the slides',
+    slides: 'Slides',
+    readOnWeb: 'Read on the web',
+    sidebarNav: 'Sidebar Navigation',
+    pager: 'Pager',
+    mobileNav: 'mobile navigation',
+    extraNav: 'extra navigation',
+    documents: 'Documents',
+    documentsHeading: 'Documents',
+    searchDocuments: 'Search the documents',
+    tags: 'Tags',
+    allTags: 'All',
+    noDocuments: 'No documents',
+    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,
+  },
+} satisfies Record<Locale, unknown>