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

package/src/node/sites.ts

@@ -1,531 +0,0 @@
-import { existsSync, mkdirSync, readdirSync, realpathSync, rmSync, statSync } from 'node:fs'
-import { createServer } from 'node:http'
-import type { IncomingMessage, ServerResponse } from 'node:http'
-import type { AddressInfo } from 'node:net'
-import type { Duplex } from 'node:stream'
-import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { DEFAULT_LANG, deckLocale, docBlocks, errorMessage, isRecord, localRequestRefusal, nodeMdast } from '@lincyaw/kernel'
-import type { DocumentLink, Finding, IRDocument, MdastNode, RenderContext, RenderOutput, SiteDevServer, SiteDocument, SiteSpec, SourcePos } from '@lincyaw/kernel'
-import { FONT_LICENSE, fontLicense, optimizeDeps } from '@lincyaw/kernel/node'
-import { createProxyServer } from 'http-proxy-3'
-import { pageLink, searchDocuments, sectionLinks, siteShell, SITE_LABELS, toPages, translationPages, urlPath } from '../domain/index.ts'
-import type { Neighbour, SearchDocument, WebPage } from '../domain/index.ts'
-import { clientModules } from './addons.ts'
-import type { ClientModules } from './addons.ts'
-import { publishedFile } from './publish.ts'
-import type { DocumentPage } from './publish.ts'
-import { buildDocument, devDocument } from './renderer.ts'
-import type { DocumentDevServer, DocumentSite } from './renderer.ts'
-import { allowed, browserPackages, languageLabel, linkDependencies, OG_TITLE, presmiumRoot, SRC_EXCLUDE, write } from './site.ts'
-import type { WorkspaceOptions } from './site.ts'
-import { vitepressBuild, vitepressDev } from './vitepress.ts'
-
-const HOME_THEME = fileURLToPath(new URL('../client/home.ts', import.meta.url))
-const VITE_PLUGIN = fileURLToPath(new URL('./vite.ts', import.meta.url))
-const LOOPBACK = '127.0.0.1'
-const GENERATED = '// Generated by @lincyaw/web for a workspace site; do not edit.'
-const LIST_PAGE = 'documents'
-const WORKSPACE_FILE = 'presmium.workspace.yaml'
-const DECK_ENTRY = 'lecture.md'
-const REMOTE = /^(?:[a-z][a-z\d+.-]*:|\/\/|#)/i
-const LINK_LANGUAGE = new WeakMap<DocumentLink, string>()
-const SHELL_KEYS = ['nav', 'footer', 'head', 'sitemap']
-
-function shellOptions(site: SiteSpec): Record<string, unknown> {
-  return Object.fromEntries(SHELL_KEYS.filter(key => key in site.config).map(key => [key, site.config[key]]))
-}
-
-function homeDocument(site: SiteSpec): SiteDocument | undefined {
-  return site.home === undefined ? undefined : site.documents.find(doc => doc.dir === site.home && doc.dir !== '')
-}
-
-function listLink(site: SiteSpec, base: string): string {
-  return homeDocument(site) ? `${base}${LIST_PAGE}.html` : base
-}
-
-export interface HomeDocument {
-  dir: string
-  title: string
-  lang?: string
-  tags?: string[]
-  href: string
-  description?: string
-  pages?: number
-  problems?: { errors: number, warnings: number }
-  sections?: { id: string, title: string, href: string }[]
-}
-
-function documentBase(base: string, dir: string): string {
-  return dir ? `${base}${urlPath(dir)}/` : base
-}
-
-function endpoints(base: string): WorkspaceOptions['endpoints'] {
-  return { ir: `${base}@lincyaw/ir`, source: `${base}@lincyaw/source` }
-}
-
-function homeDocuments(site: SiteSpec, base: string, compiled: ReadonlyMap<string, IRDocument> = new Map()): HomeDocument[] {
-  return site.documents.map(({ dir, title, lang, tags, doc }) => ({ dir, title, ...lang ? { lang } : {}, ...tags?.length ? { tags } : {}, href: documentBase(base, dir), ...cardOf(compiled.get(dir) ?? doc, documentBase(base, dir)) }))
-}
-
-function siteLanguages(site: SiteSpec, lang: string): string[] {
-  return [...new Set(site.documents.flatMap(entry => (entry.translations ?? []).map(t => t.lang)))].filter(other => other !== lang)
-}
-
-function translationOf(entry: SiteDocument, lang: string): { doc: IRDocument, pages: WebPage[] } | undefined {
-  const translated = entry.translations?.find(t => t.lang === lang)
-  return translated && entry.doc ? { doc: translated.doc, pages: translationPages(translated.doc, toPages(entry.doc)) } : undefined
-}
-
-function localeDocuments(site: SiteSpec, base: string, lang: string): HomeDocument[] {
-  return site.documents.map((entry) => {
-    const translated = translationOf(entry, lang)
-    if (!translated) return homeDocuments({ ...site, documents: [entry] }, base)[0]!
-    const root = `${documentBase(base, entry.dir)}${lang}/`
-    return { dir: entry.dir, title: translated.doc.meta.title, lang, ...entry.tags?.length ? { tags: entry.tags } : {}, href: root, ...cardOf(translated.doc, root, translated.pages) }
-  })
-}
-
-function cardOf(doc: IRDocument | undefined, root: string, pages = doc && toPages(doc)): Pick<HomeDocument, 'description' | 'pages' | 'problems' | 'sections'> {
-  if (!doc || !pages) return {}
-  const description = typeof doc.meta.description === 'string' ? doc.meta.description.trim() : ''
-  const count = (severity: Finding['severity']) => doc.diagnostics.filter(finding => finding.severity === severity).length
-  const links = sectionLinks(pages)
-  const sections = doc.sections.flatMap(section => (section.title && links[section.id] ? [{ id: section.id, title: section.title, href: `${root}${links[section.id]!.slice(1)}` }] : []))
-  return { ...description ? { description } : {}, pages: pages.length, problems: { errors: count('error'), warnings: count('warning') }, sections }
-}
-
-function packageDir(name: string, from: string): string | undefined {
-  for (let dir = from; ; dir = dirname(dir)) {
-    const candidate = join(dir, 'node_modules', name)
-    if (existsSync(join(candidate, 'package.json'))) return realpathSync(candidate)
-    if (dirname(dir) === dir) return undefined
-  }
-}
-
-function siteModules(ctx: RenderContext): ClientModules {
-  const { components, plugins, viewers, vite } = clientModules({ ...ctx, deckDir: join(ctx.workDir, 'site-plugins') }, [])
-  return { components, plugins, viewers, vite, nodeVite: [] }
-}
-
-function decoded(text: string): string {
-  try {
-    return decodeURIComponent(text)
-  } catch {
-    return text
-  }
-}
-
-function documentLinkOf(ctx: RenderContext): (source: SourcePos, url: string) => DocumentLink | undefined {
-  if (ctx.documentLink) return (source, url) => ctx.documentLink!(source, url)
-  return (source, url) => {
-    const path = url.replace(/[?#].*$/s, '')
-    if (REMOTE.test(url) || !path || path.startsWith('/')) return undefined
-    let target: string
-    try {
-      target = realpathSync(resolve(dirname(source.file), decoded(path)))
-    } catch {
-      return undefined
-    }
-    const stat = statSync(target)
-    const dir = stat.isFile() && basename(target) === DECK_ENTRY ? dirname(target) : stat.isDirectory() && existsSync(join(target, DECK_ENTRY)) ? target : undefined
-    const rel = dir === undefined ? undefined : relative(realpathSync(ctx.workspaceRoot), dir)
-    if (rel === undefined || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) return undefined
-    const hash = url.indexOf('#')
-    const fragment = hash < 0 ? '' : decoded(url.slice(hash + 1))
-    return { dir: rel.split(sep).join('/'), ...fragment ? { fragment } : {} }
-  }
-}
-
-function labelSection(doc: IRDocument, label: string): string | undefined {
-  const named = (node: MdastNode): boolean => node.identifier === label || node.label === label || Boolean(node.children?.some(named))
-  for (const { section, block } of docBlocks(doc)) {
-    if (block.id === label || nodeMdast(block.node).some(named)) return section.id
-  }
-  return undefined
-}
-
-function documentPage(site: SiteSpec, base: string, docs: Map<string, IRDocument>): DocumentPage {
-  return (link) => {
-    const { dir, fragment } = link
-    const entry = site.documents.find(other => other.dir === dir)
-    if (!entry) return undefined
-    const lang = LINK_LANGUAGE.get(link)
-    const translated = lang ? translationOf(entry, lang) : undefined
-    const root = `${documentBase(base, dir)}${translated ? `${lang}/` : ''}`
-    const anchor = fragment ? `#${encodeURIComponent(fragment)}` : ''
-    const doc = docs.get(dir)
-    if (!doc || !fragment) return `${root}${anchor}`
-    const links = sectionLinks(translated?.pages ?? toPages(doc))
-    if (links[fragment]) return `${root}${links[fragment].slice(1)}`
-    const section = labelSection(doc, fragment)
-    return `${root}${(section ? links[section]!.split('#')[0]! : '/').slice(1)}${anchor}`
-  }
-}
-
-function sourceFiles(doc: IRDocument): Set<string> {
-  return new Set([...doc.sections.map(section => section.source.file), ...[...docBlocks(doc)].map(({ block }) => block.source.file)])
-}
-
-function translatedFiles(doc: IRDocument, translations: SiteDocument['translations'] = []): Map<string, string> {
-  const original = sourceFiles(doc)
-  const files = new Map<string, string>()
-  for (const { lang, doc: translated } of translations) {
-    for (const file of sourceFiles(translated)) if (!original.has(file)) files.set(file, lang)
-  }
-  return files
-}
-
-function documentContext(ctx: RenderContext, site: SiteSpec, dir: string, doc: IRDocument, outDir: string, workDir: string): RenderContext {
-  const linkOf = documentLinkOf(ctx)
-  const entry = site.documents.find(other => other.dir === dir)
-  const translated = translatedFiles(doc, entry?.translations)
-  const documentLink = (source: SourcePos, url: string): DocumentLink | undefined => {
-    const link = linkOf(source, url)
-    const lang = translated.get(source.file)
-    if (link && lang) LINK_LANGUAGE.set(link, lang)
-    return link
-  }
-  const deckDir = join(ctx.workspaceRoot, dir)
-  const pluginDirs: Record<string, string> = {}
-  for (const name of doc.config.plugins) {
-    const found = isAbsolute(name) ? name : ctx.pluginDirs[name] ?? packageDir(name, deckDir)
-    if (found && existsSync(found)) pluginDirs[name] = found
-  }
-  return {
-    ...ctx,
-    deckDir,
-    outDir,
-    workDir,
-    config: shellOptions(site),
-    plugins: doc.config.plugins.filter(name => pluginDirs[name]),
-    pluginDirs,
-    lang: doc.meta.lang,
-    base: documentBase(ctx.base, dir),
-    vitePlugins: [],
-    translations: entry?.translations,
-    documentLink,
-    localAsset(source, url) {
-      if (documentLink(source, url)) return undefined
-      if (!url.startsWith('/') || url.startsWith('//')) {
-        const found = ctx.localAsset(source, url)
-        return found && basename(realpathSync(found.file)) === DECK_ENTRY ? undefined : found
-      }
-      const path = url.replace(/[?#].*$/s, '')
-      let file = join(deckDir, 'public', path)
-      try {
-        file = join(deckDir, 'public', decodeURIComponent(path))
-      } catch {
-      }
-      if (!existsSync(file)) return undefined
-      const rel = relative(dirname(source.file), join(deckDir, 'public', path)).split(sep).join('/')
-      return ctx.localAsset(source, `${rel}${url.slice(path.length)}`)
-    },
-  }
-}
-
-function documentWorkDir(ctx: RenderContext, dir: string): string {
-  return join(ctx.workDir, 'documents', dir ? encodeURIComponent(dir) : '_')
-}
-
-function firstPage(entry: SiteDocument, doc?: IRDocument): Neighbour {
-  const page = doc && toPages(doc)[0]
-  return { text: page?.title ?? entry.title, link: `${urlPath(entry.dir)}/` }
-}
-
-function lastPage(entry: SiteDocument, doc?: IRDocument): Neighbour {
-  const page = doc && toPages(doc).at(-1)
-  return page ? { text: page.title, link: `${urlPath(entry.dir)}${pageLink(page)}` } : { text: entry.title, link: `${urlPath(entry.dir)}/` }
-}
-
-function siteLinks(site: SiteSpec, base: string, dir: string, docs: Map<string, IRDocument>): Pick<WorkspaceOptions, 'neighbours' | 'search'> {
-  const listed = site.documents.filter(entry => entry.dir !== '')
-  const i = listed.findIndex(entry => entry.dir === dir)
-  const before = listed[i - 1]
-  const after = listed[i + 1]
-  const search: SearchDocument[] = listed.flatMap((entry) => {
-    const doc = docs.get(entry.dir)
-    return entry.dir === dir || !doc ? [] : searchDocuments(doc, documentBase(base, entry.dir), toPages(doc), [entry.title])
-  })
-  return {
-    neighbours: i < 0 ? {} : { ...before ? { prev: lastPage(before, docs.get(before.dir)) } : {}, ...after ? { next: firstPage(after, docs.get(after.dir)) } : {} },
-    search,
-  }
-}
-
-function documentSite(ctx: RenderContext, site: SiteSpec, dir: string, extra: ClientModules, served: boolean, allow: string[], docs: Map<string, IRDocument>): DocumentSite {
-  const base = documentBase(ctx.base, dir)
-  const single = site.documents.length === 1 && site.documents[0]!.dir === ''
-  return {
-    documentPage: documentPage(site, ctx.base, docs),
-    workspace: { document: dir, home: single ? base : listLink(site, ctx.base), endpoints: endpoints(base), served, allow, ...siteLinks(site, ctx.base, dir, docs) },
-    extra,
-    config: join(ctx.workspaceRoot, WORKSPACE_FILE),
-  }
-}
-
-function sitemapPages(site: SiteSpec): string[] {
-  return site.documents.flatMap((entry) => {
-    if (!entry.doc || !entry.dir) return []
-    const translated = (entry.translations ?? []).flatMap(({ lang }) => translationOf(entry, lang)?.pages.map(page => pageLink(page, `/${lang}`)) ?? [])
-    return [...toPages(entry.doc).map(page => pageLink(page)), ...translated].map(link => `${urlPath(entry.dir)}${link}`.replace(/^\//, ''))
-  })
-}
-
-function writeHome(workDir: string, site: SiteSpec, ctx: RenderContext, modules: ClientModules, allow?: string[]): string {
-  const root = join(workDir, 'site')
-  const lang = typeof site.config.lang === 'string' ? site.config.lang : site.documents.find(doc => doc.lang)?.lang ?? ctx.lang ?? DEFAULT_LANG
-  const labels = SITE_LABELS[deckLocale(lang)]
-  const shell = siteShell(site.config)
-  const dataFile = join(workDir, 'home.json')
-  const home = homeDocument(site)
-  const target = home && documentBase(ctx.base, home.dir)
-  const titles = isRecord(site.config.locales) ? site.config.locales : {}
-  const locales = siteLanguages(site, lang).map((other) => {
-    const own = titles[other]
-    const translatedHome = home && translationOf(home, other) ? `${target}${other}/` : target
-    return {
-      lang: other,
-      label: languageLabel(other),
-      title: isRecord(own) && typeof own.title === 'string' ? own.title : site.title,
-      themeConfig: SITE_LABELS[deckLocale(other)].themeConfig,
-      documents: localeDocuments(site, ctx.base, other),
-      ...translatedHome ? { redirect: translatedHome, list: `${ctx.base}${other}/${LIST_PAGE}.html` } : {},
-    }
-  })
-  write(dataFile, JSON.stringify({ title: site.title, label: languageLabel(lang), documents: homeDocuments(site, ctx.base), locales, sitemap: sitemapPages(site) }))
-  write(join(workDir, '.gitignore'), '*\n')
-  linkDependencies(root)
-  const optimize = optimizeDeps(root, browserPackages(modules))
-  const publicDir = join(root, 'public')
-  write(join(publicDir, FONT_LICENSE), fontLicense(import.meta.url))
-  const image = shell.head?.image && (/^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(shell.head.image)
-    ? shell.head.image
-    : publishedFile(ctx, publicDir, ctx.base, { file: join(ctx.workspaceRoot, WORKSPACE_FILE), line: 1 }, shell.head.image))
-  const head: unknown[] = shell.head
-    ? [['meta', { property: 'og:type', content: 'website' }], ...shell.head.description ? [['meta', { property: 'og:description', content: shell.head.description }]] : [], ...image ? [['meta', { property: 'og:image', content: shell.sitemap && image.startsWith('/') ? `${shell.sitemap.hostname}${image}` : image }]] : []]
-    : []
-  const config = {
-    lang,
-    base: ctx.base,
-    cleanUrls: false,
-    ignoreDeadLinks: true,
-    srcExclude: SRC_EXCLUDE,
-    ...shell.head?.description ? { description: shell.head.description } : {},
-    head,
-    themeConfig: { ...labels.themeConfig, ...shell.nav ? { nav: shell.nav } : {}, ...shell.footer ? { footer: shell.footer } : {} },
-  }
-  const sitemap = shell.sitemap ? `site.sitemap = { hostname: ${JSON.stringify(`${shell.sitemap.hostname}${ctx.base}`)}, transformItems: items => [...items, ...data.sitemap.map(url => ({ url }))] }\n` : ''
-  const vite = modules.vite.map((file, i) => `import vite${i} from ${JSON.stringify(file)}\n`).join('')
-  write(join(root, '.vitepress/config.mjs'), `${GENERATED}
-import { readFileSync } from 'node:fs'
-import { presmiumReady } from ${JSON.stringify(VITE_PLUGIN)}
-${vite}
-const site = ${JSON.stringify(config, null, 2)}
-const data = JSON.parse(readFileSync(${JSON.stringify(dataFile)}, 'utf8'))
-site.title = data.title
-site.themeConfig.presmium = { home: true, documents: data.documents${target ? `, redirect: ${JSON.stringify(target)}, list: ${JSON.stringify(`${ctx.base}${LIST_PAGE}.html`)}` : ''} }
-// The languages of the documents' translations (P-123): a locale each, which lists the documents in its language.
-if (data.locales.length > 0) {
-  site.locales = { root: { label: data.label, lang: site.lang } }
-  for (const locale of data.locales) {
-    const presmium = { ...site.themeConfig.presmium, documents: locale.documents, ...locale.redirect ? { redirect: locale.redirect, list: locale.list } : {} }
-    site.locales[locale.lang] = { label: locale.label, lang: locale.lang, title: locale.title, themeConfig: { ...locale.themeConfig, presmium } }
-  }
-}
-site.vite = { plugins: [presmiumReady(), ...[${modules.vite.map((_, i) => `vite${i}`).join(', ')}].flatMap(config => config?.plugins ?? [])], resolve: { dedupe: ['vue'] }${optimize.include.length + optimize.exclude.length > 0 ? `, optimizeDeps: ${JSON.stringify(optimize)}` : ''}${allow ? `, server: { fs: { allow: ${JSON.stringify(allow)} } }` : ''} }
-${sitemap}${shell.head ? OG_TITLE : ''}
-export default site
-`)
-  const load = (file: string) => `() => import(${JSON.stringify(file)})`
-  write(join(root, '.vitepress/theme/index.ts'), `${GENERATED}
-import { createSiteHomeTheme } from ${JSON.stringify(HOME_THEME)}
-
-const ssr = import.meta.env.SSR
-export default createSiteHomeTheme({
-  plugins: ssr ? [] : [
-${modules.plugins.map(file => `    ${load(file)},`).join('\n')}
-  ],
-})
-`)
-  writeIndex(root, home?.title, target)
-  const langs = new Set(locales.map(locale => locale.lang))
-  for (const entry of readdirSync(root, { withFileTypes: true })) {
-    if (entry.isDirectory() && !entry.name.startsWith('.') && !['public', 'node_modules'].includes(entry.name) && !langs.has(entry.name)) rmSync(join(root, entry.name), { recursive: true, force: true })
-  }
-  for (const locale of locales) writeIndex(join(root, locale.lang), locale.documents.find(doc => doc.dir === home?.dir)?.title, locale.redirect, true)
-  return root
-}
-
-function writeIndex(dir: string, title: string | undefined, target: string | undefined, clientOnly = false): void {
-  const list = `---\nlayout: page\n---\n\n${clientOnly ? '<ClientOnly><PresmiumSiteHome /></ClientOnly>' : '<PresmiumSiteHome />'}\n`
-  if (target) {
-    const refresh = JSON.stringify(['meta', { 'http-equiv': 'refresh', 'content': `0; url=${target}` }])
-    write(join(dir, 'index.md'), `---\nlayout: page\ntitle: ${JSON.stringify(title ?? '')}\nhead:\n  - ${refresh}\n---\n\n<PresmiumSiteRedirect />\n`)
-    write(join(dir, `${LIST_PAGE}.md`), list)
-  } else {
-    write(join(dir, 'index.md'), list)
-    rmSync(join(dir, `${LIST_PAGE}.md`), { force: true })
-  }
-}
-
-export async function buildSite(site: SiteSpec, ctx: RenderContext): Promise<RenderOutput> {
-  const extra = siteModules(ctx)
-  const single = site.documents.length === 1 && site.documents[0]!.dir === ''
-  if (!single && ctx.config.home !== false) {
-    const work = join(ctx.workDir, 'home')
-    const root = writeHome(work, site, ctx, siteModules(ctx))
-    const code = await vitepressBuild(root, ctx.outDir)
-    if (code !== 0) throw new Error(`vitepress build of the home page exited with code ${code}`)
-  }
-  const docs = new Map(site.documents.flatMap(entry => (entry.doc ? [[entry.dir, entry.doc] as const] : [])))
-  for (const entry of site.documents) {
-    if (!entry.doc) continue
-    const workDir = documentWorkDir(ctx, entry.dir)
-    const dctx = documentContext(ctx, site, entry.dir, entry.doc, join(ctx.outDir, entry.dir), workDir)
-    try {
-      await buildDocument(entry.doc, dctx, workDir, documentSite(ctx, site, entry.dir, extra, false, [], docs))
-    } catch (error) {
-      throw new Error(`document ${entry.dir || '.'}: ${errorMessage(error)}`)
-    }
-  }
-  return { outDir: ctx.outDir, skipped: [] }
-}
-
-export async function devSite(site: SiteSpec, ctx: RenderContext, compile: (dir: string) => Promise<IRDocument>): Promise<SiteDevServer> {
-  const extra = siteModules(ctx)
-  const shared = allowed(presmiumRoot(), ...Object.values(ctx.pluginDirs))
-  const latest = new Map<string, IRDocument>()
-  const documents = new Map<string, Promise<DocumentDevServer>>()
-  const linking = new Map<string, DocumentSite>()
-  let home: Promise<{ port: number, close(): Promise<void> }> | undefined
-  let closed = false
-  const stopping = new AbortController()
-  const base = ctx.base
-
-  const startDocument = (dir: string): Promise<DocumentDevServer> => {
-    let started = documents.get(dir)
-    if (!started) {
-      started = (async () => {
-        const doc = latest.get(dir) ?? await compile(dir)
-        latest.set(dir, doc)
-        const workDir = documentWorkDir(ctx, dir)
-        mkdirSync(join(workDir, 'site'), { recursive: true })
-        const dctx = documentContext(ctx, site, dir, doc, workDir, workDir)
-        const allow = allowed(join(workDir, 'site'), dctx.deckDir, ...Object.values(dctx.pluginDirs), ...shared)
-        const document = documentSite(ctx, site, dir, extra, true, allow, latest)
-        linking.set(dir, document)
-        return devDocument(doc, dctx, document, 0, { host: LOOPBACK, signal: stopping.signal })
-      })()
-      started.catch(() => documents.delete(dir))
-      documents.set(dir, started)
-    }
-    return started
-  }
-
-  const startHome = () => {
-    if (home) return home
-    home = (async () => {
-      const work = join(ctx.workDir, 'home')
-      mkdirSync(join(work, 'site'), { recursive: true })
-      const root = writeHome(work, site, ctx, siteModules(ctx), allowed(join(work, 'site'), ...shared))
-      const server = await vitepressDev(root, 0, () => {}, { host: LOOPBACK, signal: stopping.signal })
-      return { port: server.port, close: () => server.close() }
-    })()
-    home.catch(() => {
-      home = undefined
-    })
-    return home
-  }
-
-  const targetOf = async (path: string): Promise<number> => {
-    const listed = new Set(site.documents.map(doc => doc.dir))
-    for (const [dir, server] of documents) {
-      if (listed.has(dir)) continue
-      documents.delete(dir)
-      latest.delete(dir)
-      linking.delete(dir)
-      void server.then(s => s.close(), () => undefined)
-    }
-    let rest = path.startsWith(base) ? path.slice(base.length) : undefined
-    if (rest !== undefined) {
-      try {
-        rest = decodeURIComponent(rest)
-      } catch {
-      }
-    }
-    const dir = rest === undefined
-      ? undefined
-      : [...listed].filter(d => d === '' || rest === d || rest!.startsWith(`${d}/`)).sort((a, b) => b.length - a.length)[0]
-    if (dir !== undefined) return (await startDocument(dir)).port
-    return (await startHome()).port
-  }
-
-  const proxy = createProxyServer({ ws: true, xfwd: false })
-  proxy.on('error', (error: Error, _req: unknown, res: unknown) => {
-    const response = res as ServerResponse | Duplex | undefined
-    if (response && 'writeHead' in response && !response.headersSent) {
-      response.writeHead(502, { 'Content-Type': 'text/plain; charset=utf-8' })
-      response.end(`site proxy error: ${error.message}`)
-    } else {
-      response?.destroy?.()
-    }
-  })
-  const pathOf = (req: IncomingMessage) => new URL(req.url ?? '/', 'http://site').pathname
-  const server = createServer((req, res) => {
-    const refused = localRequestRefusal(req.headers)
-    if (refused) {
-      res.writeHead(403, { 'Content-Type': 'text/plain; charset=utf-8' })
-      res.end(refused)
-      return
-    }
-    const path = pathOf(req)
-    targetOf(path).then(
-      port => proxy.web(req, res, { target: `http://${LOOPBACK}:${port}` }),
-      (error: unknown) => {
-        if (res.headersSent) return res.destroy()
-        res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' })
-        res.end(`the site could not show ${path}: ${errorMessage(error)}`)
-      },
-    )
-  })
-  server.on('upgrade', (req: IncomingMessage, socket: Duplex, head: Buffer) => {
-    if (localRequestRefusal(req.headers)) return socket.destroy()
-    targetOf(pathOf(req)).then(
-      port => proxy.ws(req, socket, head, { target: `http://${LOOPBACK}:${port}` }),
-      () => socket.destroy(),
-    )
-  })
-  const host = typeof ctx.config.host === 'string' && ctx.config.host ? ctx.config.host : '127.0.0.1'
-  const port = await new Promise<number>((resolve, reject) => {
-    server.once('error', reject)
-    server.listen(Number(ctx.config.port) || 0, host, () => resolve((server.address() as AddressInfo).port))
-  })
-
-  return {
-    url: `http://${host === '0.0.0.0' || host === '::' ? '127.0.0.1' : host}:${port}${base}`,
-    async update(dir: string, doc: IRDocument) {
-      if (closed) return
-      latest.set(dir, doc)
-      const entry = site.documents.find(d => d.dir === dir)
-      const known: SiteDocument = { dir, title: doc.meta.title, ...doc.meta.lang ? { lang: doc.meta.lang } : {}, ...Array.isArray(doc.meta.tags) ? { tags: (doc.meta.tags as unknown[]).filter((t): t is string => typeof t === 'string') } : {} }
-      if (entry) Object.assign(entry, known)
-      else site.documents.push(known)
-      for (const [other, document] of linking) Object.assign(document.workspace!, siteLinks(site, base, other, latest))
-      const running = documents.get(dir)
-      if (running) void running.then(server => server.update(doc)).catch((error: unknown) => console.error(`[presmium] the site did not update ${dir}: ${errorMessage(error)}`))
-    },
-    async close() {
-      closed = true
-      stopping.abort()
-      proxy.close()
-      await new Promise<void>((done) => {
-        server.close(() => done())
-        server.closeAllConnections()
-      })
-      const all = [...documents.values(), ...home ? [home] : []]
-      documents.clear()
-      await Promise.all(all.map(started => Promise.race([started.then(s => s.close(), () => undefined), new Promise(done => setTimeout(done, 10_000).unref())])))
-    },
-  }
-}