Vite 构建集成

Folio 的 Vite 入口：

import { folio } from "@uichat-mira/folio/vite";

基本接入#

folio({
  contentDir: "content",
  config,
  exclude: (sourcePath) => /(^|\/)README\.md$/i.test(sourcePath),
  route: (_sourcePath, doc) => doc.path,
  staticRoutes: true,
});

内容发现链#

读取 Markdown
→ parseFolioDoc
→ exclude
→ route
→ normalize path
→ compareFolioDocs

随后生成：

import docs, { roots } from "virtual:folio/content";

正式发布的 @uichat-mira/folio@0.1.1 已包含虚拟模块的 TypeScript 声明（FolioDoc[]、string[]），并通过真实 Registry 独立消费者验收。只在 TS 工程中导入虚拟模块时，须在 compilerOptions.types 注册已安装的 @uichat-mira/folio；不需要自己写 declare module。

staticRoutes#

false                    // 不生成静态 route
true                     // 使用默认静态构建
FolioStaticBuildOptions  // consumer 自定义

plugin 在 Vite writeBundle 阶段读取最终 manifest，并写入 build.outDir。