@dongfangw/study-kit 0.0.0-stage → 0.1.0

package/lib/slidev.js

@@ -0,0 +1,755 @@
+/**
+ * Slidev 课件按需构建 + 静态托管。
+ *
+ * 背景：teaching-case/mdPPT 各节是独立 Slidev 工程（slides.md + 本地主题 ../../theme-neversink）。
+ * 但部分历史工作区的 mdPPT/theme-neversink 曾是指向外部主题目录的符号链接，
+ * 位于只读挂载（/mnt/data）上；vite 构建时要在主题 node_modules 下写 .vite-temp/.vite 缓存，
+ * 直接构建会 EROFS。因此这里把 deck 与主题复制到可写缓存（默认 os.tmpdir()）构成镜像树，
+ * 保持 `../../theme-neversink` 的相对布局，再用全局 slidev CLI 构建出静态 SPA，
+ * 经 /aero-kb/slidev/<key>/ 托管（--base 重写资源前缀）。
+ *
+ * 流程：meta?p=... → 判断 slides.md → 计算 key → 过期则入队构建（并发上限 2，超时 8 分钟）
+ *       → 构建产物 dist/ 静态托管（index.html 回退）；meta.json 记录 srcMtime 用于失效判断。
+ */
+import { createHash } from 'node:crypto';
+import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { resolveSlidevBin } from './slidevBin.js';
+import { getSlidevEnv } from './slidevEnv.js';
+import { sendFile } from './static.js';
+import { isInside } from '@aero/library-core';
+// ---------------------------------------------------------------------------
+// 常量与缓存根
+// ---------------------------------------------------------------------------
+/** 单个构建进程允许的最长时间（首次需复制主题镜像 700MB+ 并跑 vite，比较慢）。 */
+const BUILD_TIMEOUT_MS = 8 * 60_000;
+/** 并发构建上限（构建很吃 CPU/内存）。 */
+const MAX_PARALLEL = 2;
+/** 构建日志环形缓冲上限（字符）。 */
+const MAX_LOG_CHARS = 40_000;
+/** meta.json 中保留的日志尾部。 */
+const META_LOG_TAIL = 16_000;
+/** 静态资源 key：sha1 十六进制。 */
+const KEY_RE = /^[0-9a-f]{8,64}$/;
+const CACHE_ROOT = process.env.AERO_SLIDEV_CACHE
+    ? path.resolve(process.env.AERO_SLIDEV_CACHE)
+    : path.join(os.tmpdir(), 'aero-slidev');
+const THEMES_DIR = path.join(CACHE_ROOT, 'themes');
+function sha1(text) {
+    return createHash('sha1').update(text).digest('hex');
+}
+// ---------------------------------------------------------------------------
+// 工具函数
+// ---------------------------------------------------------------------------
+/** 目录下文件的最近 mtime（跳过指定子目录/扩展名，用于判断源是否变化）。 */
+function maxMtimeOf(dir, opts) {
+    let max = 0;
+    const walk = (d, depth) => {
+        if (depth > opts.maxDepth)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith('.'))
+                continue;
+            const abs = path.join(d, e.name);
+            if (e.isDirectory()) {
+                if (!opts.skipDirs.has(e.name))
+                    walk(abs, depth + 1);
+                continue;
+            }
+            if (!e.isFile())
+                continue;
+            if (opts.skipExts.has(path.extname(e.name).toLowerCase()))
+                continue;
+            try {
+                max = Math.max(max, statSync(abs).mtimeMs);
+            }
+            catch {
+                /* 忽略竞态 */
+            }
+        }
+    };
+    walk(dir, 0);
+    try {
+        max = Math.max(max, statSync(dir).mtimeMs);
+    }
+    catch {
+        /* ignore */
+    }
+    return max;
+}
+/** 读取 slides.md 前置 YAML 中的 theme 字段（只读文件头 4KB）。 */
+function readThemeRef(slidesAbs) {
+    let text;
+    try {
+        text = readFileSync(slidesAbs, 'utf8').slice(0, 4096);
+    }
+    catch {
+        return null;
+    }
+    const m = /^\s*theme:\s*(\S+)\s*$/m.exec(text);
+    if (m === null || m[1] === undefined)
+        return null;
+    return m[1].replace(/^['"]|['"]$/g, '');
+}
+/** 安全地限制相对路径在 base 内。 */
+function safeJoin(base, rel) {
+    const abs = path.resolve(base, rel);
+    if (!isInside(base, abs))
+        throw new Error('非法路径');
+    return abs;
+}
+function trimLog(log) {
+    let total = 0;
+    for (let i = log.length - 1; i >= 0; i--) {
+        total += (log[i] ?? '').length;
+        if (total > MAX_LOG_CHARS) {
+            log.splice(0, i + 1);
+            return;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// 主题镜像（复制到可写缓存，跨 deck 共享）
+// ---------------------------------------------------------------------------
+const themeMirrors = new Map();
+async function mirrorTheme(themeAbs) {
+    const id = sha1(themeAbs).slice(0, 16);
+    const dest = path.join(THEMES_DIR, id);
+    const inflight = themeMirrors.get(id);
+    if (inflight !== undefined)
+        return inflight;
+    const job = (async () => {
+        const metaFile = path.join(dest, '.aero-mirror.json');
+        const srcReal = realpathSync(themeAbs);
+        const srcMtime = maxMtimeOf(srcReal, {
+            skipDirs: new Set(['node_modules', '.git', 'docs']),
+            skipExts: new Set(),
+            maxDepth: 6,
+        });
+        let fresh = false;
+        try {
+            const m = JSON.parse(readFileSync(metaFile, 'utf8'));
+            if (typeof m.mtime === 'number' && m.mtime >= srcMtime && existsSync(path.join(dest, 'package.json')))
+                fresh = true;
+        }
+        catch {
+            /* 无 meta → 重建 */
+        }
+        if (!fresh) {
+            const tmp = `${dest}.tmp-${process.pid}`;
+            rmSync(tmp, { recursive: true, force: true });
+            mkdirSync(tmp, { recursive: true });
+            // 复制整个主题（含 node_modules：vite 需要主题自身依赖解析 @slidev/types、unocss 等）。
+            cpSync(srcReal, tmp, {
+                recursive: true,
+                dereference: true,
+                filter: (src) => {
+                    const base = path.basename(src);
+                    if (base === '.git' || base === 'docs')
+                        return false;
+                    // 跳过悬空符号链接：dereference: true 会 stat 其目标，目标缺失时整个镜像拷贝
+                    // 以 ENOENT 中止（曾因 theme node_modules/node_modules -> /mnt/newdata/… 悬空，
+                    // 导致所有课件构建失败、工作台长时间无结果）。
+                    try {
+                        if (lstatSync(src).isSymbolicLink())
+                            statSync(src);
+                    }
+                    catch {
+                        return false;
+                    }
+                    return true;
+                },
+            });
+            writeFileSync(path.join(tmp, '.aero-mirror.json'), JSON.stringify({ mtime: srcMtime, src: themeAbs }));
+            rmSync(dest, { recursive: true, force: true });
+            renameSync(tmp, dest);
+        }
+        return dest;
+    })();
+    themeMirrors.set(id, job);
+    try {
+        return await job;
+    }
+    finally {
+        themeMirrors.delete(id);
+    }
+}
+const jobs = new Map();
+const queue = [];
+const pendingRebuild = new Set();
+const activeChildren = new Set();
+let running = 0;
+/** 构建签名：hash 路由 + 前缀 base + JS 内 BASE_URL 常量改写（见 attemptBuild 注释）。 */
+const BUILDER_SIG = 'slidev-hash-v9';
+function readDeckMeta(key) {
+    try {
+        return JSON.parse(readFileSync(path.join(CACHE_ROOT, key, 'meta.json'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeDeckMeta(key, meta) {
+    mkdirSync(path.join(CACHE_ROOT, key), { recursive: true });
+    writeFileSync(path.join(CACHE_ROOT, key, 'meta.json'), JSON.stringify(meta));
+}
+/** 启动一个构建（调用方需保证并发/去重）。 */
+function startBuild(req) {
+    running++;
+    const log = [];
+    const job = buildOne(req, log).finally(() => {
+        running--;
+        jobs.delete(req.key);
+        drainQueue();
+    });
+    jobs.set(req.key, { promise: job, log });
+    void job;
+}
+function drainQueue() {
+    while (running < MAX_PARALLEL && queue.length > 0) {
+        const next = queue.shift();
+        if (next !== undefined)
+            startBuild(next);
+    }
+}
+function ensureBuild(req) {
+    if (jobs.has(req.key))
+        return;
+    if (running >= MAX_PARALLEL) {
+        queue.push(req);
+        return;
+    }
+    startBuild(req);
+}
+/** 把 JS 产物里内联的 BASE_URL 字符串常量替换为空串（路由/资源相对解析，见 attemptBuild 注释）。 */
+const REWRITE_EXTS = new Set(['.js', '.mjs', '.cjs']);
+function rewriteBaseConstant(key, distDir) {
+    const literal = `/aero-kb/slidev/${key}/`;
+    let count = 0;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const abs = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                walk(abs);
+                continue;
+            }
+            if (!e.isFile() || !REWRITE_EXTS.has(path.extname(e.name).toLowerCase()))
+                continue;
+            let text;
+            try {
+                text = readFileSync(abs, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            let changed = false;
+            for (const q of ['`', '"', "'"]) {
+                // 形态 1：完整字面量 `LIT` → 空字面量（getSlidePath 简单拼接 / createWebHashHistory）
+                const needle1 = q + literal + q;
+                if (text.includes(needle1)) {
+                    count += text.split(needle1).length - 1;
+                    text = text.replaceAll(needle1, q + q);
+                    changed = true;
+                }
+                // 形态 2：模板前缀 `LIT${…}` → `${…}`（getSlidePath 的模板拼接形态；literal 自带结尾斜杠）
+                const needle2 = q + literal + '${';
+                if (text.includes(needle2)) {
+                    count += text.split(needle2).length - 1;
+                    text = text.replaceAll(needle2, q + '${');
+                    changed = true;
+                }
+            }
+            // 修正：Vite 的资源前缀助手 `function(e){return BASE + e}` 会被形态 1 剥成 `return``+e`，
+            // 其后的 import.meta.resolve(e)（或 new URL(e, import.meta.url)）无法解析「无前导 /、./」的相对路径，
+            // 抛 TypeError 导致整份课件运行时白屏。这里把 `return``+` 还原为绝对 BASE 前缀（资源仍正确落在 <key>/assets/ 下），
+            // 而 createWebHashHistory(`LIT`) 这类「BASE 作函数实参」的形态 1 剥离不受影响。
+            if (text.includes('return``+')) {
+                text = text.replaceAll('return``+', 'return`' + literal + '`+');
+                changed = true;
+            }
+            if (changed)
+                writeFileSync(abs, text);
+        }
+    };
+    walk(distDir);
+    return count;
+}
+/** 移除产物 HTML 中的 <base> 标签：vue-router hash 路由会把它当作 hash base 前缀写入 URL 导致 404。 */
+function removeBaseTags(distDir) {
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const abs = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                walk(abs);
+                continue;
+            }
+            if (!e.isFile() || path.extname(e.name).toLowerCase() !== '.html')
+                continue;
+            let text;
+            try {
+                text = readFileSync(abs, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            const next = text.replace(/<base[^>]*>/g, '');
+            if (next !== text)
+                writeFileSync(abs, next);
+        }
+    };
+    walk(distDir);
+}
+/** 单 deck 构建：镜像复制 → slidev build → 记录 meta。重试直到 pendingRebuild 清空。 */
+async function buildOne(req, log) {
+    do {
+        pendingRebuild.delete(req.key);
+        await attemptBuild(req, log);
+    } while (pendingRebuild.has(req.key));
+}
+/**
+ * 在镜像副本的 slides.md 前置 YAML 里强制 `routerMode: hash`（不动源文件）。
+ *
+ * Slidev 52 起 `--router-mode hash` CLI 参数已移除，且 parser 默认 routerMode 为 "history"；
+ * 而本插件的构建后处理（改写 BASE_URL / 去 <base>）是按 hash 路由设计的。这里直接向
+ * resolveConfig 会并入的 frontmatter 注入 routerMode: hash 来保证 hash 路由。
+ */
+function forceHashRoute(deckMirror) {
+    const slidesAbs = path.join(deckMirror, 'slides.md');
+    if (!existsSync(slidesAbs))
+        return;
+    let text;
+    try {
+        text = readFileSync(slidesAbs, 'utf8');
+    }
+    catch {
+        return;
+    }
+    if (!/^\s*---\s*\r?\n/.test(text))
+        return;
+    if (/^\s*routerMode:\s*hash\b/m.test(text))
+        return;
+    text = text.replace(/^(\s*---\s*\r?\n)/, '$1routerMode: hash\n');
+    try {
+        writeFileSync(slidesAbs, text);
+    }
+    catch {
+        /* 注入失败不致命：退化为 history 路由 */
+    }
+}
+async function attemptBuild(req, log) {
+    const { key, relPath, deckAbs } = req;
+    const keyDir = path.join(CACHE_ROOT, key);
+    const distDir = path.join(keyDir, 'dist');
+    const workDir = path.join(keyDir, '.work');
+    const base = `/aero-kb/slidev/${key}/`;
+    const bin = resolveSlidevBin();
+    rmSync(distDir, { recursive: true, force: true });
+    mkdirSync(keyDir, { recursive: true });
+    if (bin === null) {
+        writeDeckMeta(key, {
+            builtAt: 0,
+            srcMtime: 0,
+            error: '未找到 slidev CLI。请安装：npm i -g @slidev/cli（或设置 AERO_SLIDEV_BIN 指向 slidev 可执行文件）。',
+            log: '',
+            builder: BUILDER_SIG,
+        });
+        return;
+    }
+    const slidesAbs = path.join(deckAbs, 'slides.md');
+    try {
+        const dbg = process.env.AERO_SLIDEV_DEBUG === '1' ? (m) => console.error(`[slidev:${key.slice(0, 6)}] ${m}`) : () => { };
+        dbg(`attemptBuild start deckAbs=${deckAbs}`);
+        // 1) 源新鲜度（deck 全部文件 + 主题源码，不含 node_modules/导出物）
+        const deckMtime = maxMtimeOf(deckAbs, {
+            skipDirs: new Set(['node_modules', 'dist', '.git']),
+            skipExts: new Set(['.pdf']),
+            maxDepth: 8,
+        });
+        dbg('mtime ok');
+        // 2) 构建镜像树：deck 副本 + 主题符号链接（相对布局与源一致）
+        rmSync(workDir, { recursive: true, force: true });
+        mkdirSync(workDir, { recursive: true });
+        const deckMirror = path.join(workDir, path.dirname(relPath));
+        dbg('copy deck start');
+        cpSync(deckAbs, deckMirror, {
+            recursive: true,
+            dereference: false,
+            filter: (src) => {
+                const baseName = path.basename(src);
+                if (baseName === 'node_modules' || baseName === 'dist' || baseName === '.git')
+                    return false;
+                if (path.extname(baseName).toLowerCase() === '.pdf')
+                    return false;
+                return true;
+            },
+        });
+        dbg('copy deck done');
+        // 在镜像副本注入 routerMode: hash（Slidev 52 默认 history，插件后处理按 hash 设计）。
+        forceHashRoute(deckMirror);
+        const themeRef = readThemeRef(slidesAbs);
+        if (themeRef === null || !themeRef.startsWith('.')) {
+            throw new Error('slides.md 未声明本地主题路径（theme: ./…），暂不支持 npm 包名主题');
+        }
+        const themeAbs = path.resolve(deckAbs, themeRef);
+        if (!existsSync(path.join(themeAbs, 'package.json'))) {
+            throw new Error(`主题目录不存在：${themeAbs}`);
+        }
+        const linkTarget = path.resolve(workDir, path.dirname(relPath), themeRef);
+        const workPrefix = workDir.endsWith(path.sep) ? workDir : workDir + path.sep;
+        if (!linkTarget.startsWith(workPrefix))
+            throw new Error(`主题路径越界：${themeRef}`);
+        mkdirSync(path.dirname(linkTarget), { recursive: true });
+        rmSync(linkTarget, { recursive: true, force: true });
+        dbg('mirror theme start');
+        // Windows 创建目录符号链接需要管理员/开发者模式（否则 EPERM）。
+        // 目录型 junction 无需提权即可创建，作为 Windows 下的等价替代。
+        symlinkSync(await mirrorTheme(themeAbs), linkTarget, process.platform === 'win32' ? 'junction' : undefined);
+        dbg('mirror theme done');
+        // 3) 构建：hash 路由（frontmatter 已注入 routerMode: hash）+ 前缀 base。
+        //    history 路由与 vue-router 的 base 叠加会产生 base 重复的路径（导航直接 404）。
+        //    hash 路由下 BASE_URL 前缀会被 Slidev 的 getSlidePath 拼进路由造成 404，
+        //    因此构建后把 JS 里内联的 BASE_URL 常量 "/aero-kb/slidev/<key>/" 替换为空串：
+        //    · 资源拼接处：""+"assets/…" 相对当前模块/文档解析，仍落在 <key>/assets/ 下 ✓
+        //    · 路由拼接处：""+"2" → 相对导航 → 干净的 #/2 ✓
+        //    注：Slidev 52 起 `--router-mode hash` CLI 参数已移除，只能靠配置控制，故不在 args 里传。
+        await runBuild(bin, ['build', '--base', base, '--out', distDir], deckMirror, log);
+        dbg('build done');
+        const rewrites = rewriteBaseConstant(key, distDir);
+        if (rewrites === 0)
+            throw new Error('构建产物中未找到 BASE_URL 内联常量，路由改写失败（slidev 版本行为变化？）');
+        removeBaseTags(distDir);
+        // srcMtime 必须与 currentStatus 的新鲜度口径一致：max(deck, 主题)。
+        let themeMtime = 0;
+        try {
+            themeMtime = maxMtimeOf(realpathSync(themeAbs), {
+                skipDirs: new Set(['node_modules', '.git', 'docs']),
+                skipExts: new Set(),
+                maxDepth: 6,
+            });
+        }
+        catch {
+            /* 主题 mtime 不可读时按 0 处理 */
+        }
+        writeDeckMeta(key, {
+            builtAt: Date.now(),
+            srcMtime: Math.max(deckMtime, themeMtime),
+            log: log.join('').slice(-META_LOG_TAIL),
+            builder: BUILDER_SIG,
+        });
+    }
+    catch (err) {
+        rmSync(distDir, { recursive: true, force: true });
+        const msg = err instanceof Error ? err.message : String(err);
+        writeDeckMeta(key, {
+            builtAt: 0,
+            srcMtime: 0,
+            error: msg,
+            log: log.join('').slice(-META_LOG_TAIL),
+            builder: BUILDER_SIG,
+        });
+    }
+    finally {
+        rmSync(workDir, { recursive: true, force: true });
+    }
+}
+function runBuild(bin, args, cwd, log) {
+    return new Promise((resolve, reject) => {
+        const dbg = process.env.AERO_SLIDEV_DEBUG === '1' ? (m) => console.error(`[slidev:spawn] ${m}`) : () => { };
+        dbg(`spawn ${process.execPath} ${bin} ${args.join(' ')} cwd=${cwd}`);
+        const child = spawn(process.execPath, [bin, ...args], {
+            cwd,
+            env: { ...process.env, NO_COLOR: '1', FORCE_COLOR: '0', GIT_TERMINAL_PROMPT: '0' },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        activeChildren.add(child);
+        dbg(`spawned pid=${child.pid ?? '?'}`);
+        const onData = (b) => {
+            log.push(b.toString('utf8'));
+            trimLog(log);
+        };
+        child.stdout?.on('data', onData);
+        child.stderr?.on('data', onData);
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+        }, BUILD_TIMEOUT_MS);
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            activeChildren.delete(child);
+            reject(err);
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            activeChildren.delete(child);
+            dbg(`closed code=${String(code)}`);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(code === null ? '构建超时（超过 8 分钟）或被终止' : `构建进程退出码 ${code}`));
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// 状态查询
+// ---------------------------------------------------------------------------
+function metaBody(partial) {
+    return {
+        ok: true,
+        isDeck: false,
+        relPath: '',
+        key: '',
+        status: 'not-deck',
+        builtAt: 0,
+        slidesUrl: '',
+        presenterUrl: '',
+        error: '',
+        log: '',
+        ...partial,
+    };
+}
+function currentStatus(key, root, relPath) {
+    const job = jobs.get(key);
+    if (job !== undefined)
+        return { status: 'building', builtAt: 0, error: '', log: job.log.join('').slice(-META_LOG_TAIL) };
+    if (queue.some((q) => q.key === key))
+        return { status: 'queued', builtAt: 0, error: '', log: '' };
+    const deckMeta = readDeckMeta(key);
+    const distIndex = path.join(CACHE_ROOT, key, 'dist', 'index.html');
+    const built = deckMeta !== null && deckMeta.builtAt > 0 && deckMeta.builder === BUILDER_SIG && (deckMeta.error === undefined || deckMeta.error === '') && existsSync(distIndex);
+    // 已构建且源未变化 → ready；源变化 → 自动重建
+    if (built && deckMeta !== null) {
+        const deckAbs = safeJoin(root, path.dirname(relPath));
+        const srcMtime = maxMtimeOf(deckAbs, {
+            skipDirs: new Set(['node_modules', 'dist', '.git']),
+            skipExts: new Set(['.pdf']),
+            maxDepth: 8,
+        });
+        const themeRef = readThemeRef(path.join(deckAbs, 'slides.md'));
+        let fresh = false;
+        if (themeRef !== null && themeRef.startsWith('.')) {
+            const themeAbs = path.resolve(deckAbs, themeRef);
+            try {
+                const t = maxMtimeOf(realpathSync(themeAbs), {
+                    skipDirs: new Set(['node_modules', '.git', 'docs']),
+                    skipExts: new Set(),
+                    maxDepth: 6,
+                });
+                fresh = Math.max(srcMtime, t) <= deckMeta.srcMtime;
+            }
+            catch {
+                fresh = false;
+            }
+        }
+        else {
+            fresh = srcMtime <= deckMeta.srcMtime;
+        }
+        if (fresh)
+            return { status: 'ready', builtAt: deckMeta.builtAt, error: '', log: deckMeta.log };
+        return { status: 'missing', builtAt: 0, error: '', log: '' };
+    }
+    if (deckMeta !== null && deckMeta.error !== undefined && deckMeta.error !== '') {
+        return { status: 'error', builtAt: 0, error: deckMeta.error, log: deckMeta.log };
+    }
+    return { status: 'missing', builtAt: 0, error: '', log: '' };
+}
+// ---------------------------------------------------------------------------
+// HTTP 处理
+// ---------------------------------------------------------------------------
+const DIST_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json',
+    '.map': 'application/json',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.gif': 'image/gif',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.wasm': 'application/wasm',
+    '.xml': 'application/xml',
+    '.txt': 'text/plain; charset=utf-8',
+    '.webmanifest': 'application/manifest+json',
+};
+function sendJson(res, code, body) {
+    const data = JSON.stringify(body);
+    res.statusCode = code;
+    res.setHeader('Content-Type', 'application/json; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-store');
+    res.end(data);
+}
+function sendText(res, code, text) {
+    res.statusCode = code;
+    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-store');
+    res.end(text);
+}
+function serveDist(key, file, req, res) {
+    const distDir = path.join(CACHE_ROOT, key, 'dist');
+    if (!existsSync(path.join(distDir, 'index.html'))) {
+        sendText(res, 404, '课件尚未构建完成，请稍后刷新');
+        return;
+    }
+    let abs;
+    try {
+        const rel = file !== '' ? decodeURIComponent(file) : '';
+        abs = safeJoin(distDir, rel);
+    }
+    catch {
+        sendText(res, 403, 'forbidden');
+        return;
+    }
+    try {
+        if (!existsSync(abs) || statSync(abs).isDirectory()) {
+            abs = path.join(distDir, 'index.html');
+            res.setHeader('Cache-Control', 'no-store');
+        }
+        else if (path.extname(abs).toLowerCase() === '.html') {
+            res.setHeader('Cache-Control', 'no-store');
+        }
+        else {
+            // 产物经构建后改写（文件名哈希不代表最终内容），用协商缓存避免浏览器命中旧构建。
+            res.setHeader('Cache-Control', 'no-cache');
+        }
+        const ext = path.extname(abs).toLowerCase();
+        sendFile(req, res, abs, DIST_TYPES[ext] ?? 'application/octet-stream');
+    }
+    catch {
+        sendText(res, 404, 'not found');
+    }
+}
+/**
+ * /aero-kb/slidev 路由：
+ *  - GET /aero-kb/slidev/meta?p=<rel>&cwd=…&rebuild=1  → 状态/触发构建
+ *  - GET /aero-kb/slidev/<key>/<file…>                  → 构建产物静态托管
+ */
+export function createSlidevHandler(opts) {
+    return (req, res) => {
+        void handleSlidev(req, res, opts);
+    };
+}
+/**
+ * 实际处理逻辑（异步）：meta 分支在缺构建链时要跑环境体检，因此整体是 async。
+ * 静态产物分支是同步读写，但同样走这里以保持单一入口。
+ */
+async function handleSlidev(req, res, opts) {
+    const url = new URL(req.url ?? '/', 'http://localhost');
+    const parts = url.pathname.split('/').filter(Boolean);
+    const seg = parts[2] ?? '';
+    const hintCwd = url.searchParams.get('cwd') ?? undefined;
+    try {
+        if (seg === 'meta') {
+            const rel = url.searchParams.get('p') ?? '';
+            const root = opts.resolveKbRoot(hintCwd);
+            if (root === null) {
+                sendJson(res, 200, metaBody({ ok: false, relPath: rel, error: '未找到空气动力学知识库目录' }));
+                return;
+            }
+            const abs = safeJoin(root, rel);
+            if (path.basename(abs).toLowerCase() !== 'slides.md' || !existsSync(abs)) {
+                sendJson(res, 200, metaBody({ isDeck: false, relPath: rel, status: 'not-deck', error: '不是 Slidev 课件（slides.md）' }));
+                return;
+            }
+            const key = sha1(`${root}\n${rel}`).slice(0, 16);
+            const deckAbs = path.dirname(abs);
+            if (resolveSlidevBin() === null) {
+                // 顺带把体检结果一起回给前端：用户不必再点一次「检查环境」才能看到缺什么、怎么装。
+                const env = await getSlidevEnv({ slidesAbs: abs });
+                sendJson(res, 200, metaBody({
+                    isDeck: true, relPath: rel, key, status: 'no-toolchain',
+                    error: env.summary === '' ? '本机 Slidev 构建链未就绪。' : `本机 Slidev 构建链未就绪：${env.summary}`,
+                    env,
+                }));
+                return;
+            }
+            const force = url.searchParams.get('rebuild') === '1';
+            const dbgM = process.env.AERO_SLIDEV_DEBUG === '1' ? (m) => console.error(`[slidev:meta ${key.slice(0, 6)}] ${m}`) : () => { };
+            dbgM(`meta p=${rel.slice(-30)} rebuild=${url.searchParams.get('rebuild') ?? ''}`);
+            if (force) {
+                if (jobs.has(key) || pendingRebuild.has(key)) {
+                    // 正在构建：标记完成后自动再构建一次
+                    dbgM('force during build -> pendingRebuild.add');
+                    pendingRebuild.add(key);
+                }
+                else {
+                    dbgM('force idle -> rm cache');
+                    rmSync(path.join(CACHE_ROOT, key), { recursive: true, force: true });
+                }
+            }
+            const st = currentStatus(key, root, rel);
+            if (st.status === 'missing') {
+                ensureBuild({ key, relPath: rel, deckAbs });
+            }
+            const status = st.status === 'missing' ? 'building' : st.status;
+            const distDir = path.join(CACHE_ROOT, key, 'dist');
+            sendJson(res, 200, metaBody({
+                isDeck: true,
+                relPath: rel,
+                key,
+                status,
+                builtAt: st.builtAt,
+                slidesUrl: `/aero-kb/slidev/${key}/index.html`,
+                presenterUrl: existsSync(path.join(distDir, 'presenter.html')) ? `/aero-kb/slidev/${key}/presenter.html` : `/aero-kb/slidev/${key}/index.html#/presenter/1`,
+                error: st.error,
+                log: st.log,
+            }));
+            return;
+        }
+        if (KEY_RE.test(seg)) {
+            serveDist(seg, parts.slice(3).join('/'), req, res);
+            return;
+        }
+        sendText(res, 404, 'not found');
+    }
+    catch (err) {
+        sendJson(res, 500, { ok: false, error: err instanceof Error ? err.message : String(err) });
+    }
+}
+/** 插件卸载时终止所有构建子进程。 */
+export function disposeSlidev() {
+    for (const child of activeChildren) {
+        try {
+            child.kill('SIGKILL');
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    activeChildren.clear();
+    jobs.clear();
+    queue.length = 0;
+    pendingRebuild.clear();
+    running = 0;
+}
+//# sourceMappingURL=slidev.js.map