viteboard 0.2.0 → 0.2.1

package/vite.config.ts

@@ -1,1172 +1,6 @@
-// @ts-nocheck — runs under esbuild/Node at dev time; not part of the `tsc` (src-only) build.
-import { defineConfig, type Plugin, type Connect } from "vite";
-import { promises as fs } from "node:fs";
-import * as path from "node:path";
-import os from "node:os";
-import { execFile } from "node:child_process";
-import { createHash } from "node:crypto";
-import { promisify } from "node:util";
-import type { IncomingMessage, ServerResponse } from "node:http";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { renderPdfFromHtml as renderPdfFromHtmlPortable, sanitizePdfFileName as sanitizePdfFileNamePortable } from "./bin/pdf-export.mjs";
-
-const WORKSPACE_DIR = ".workspace";
-const WORKSPACE_FILE = "workspace.json";
-const IGNORE_DIRS = new Set([
-  ".git",
-  "node_modules",
-  "dist",
-  "build",
-  "coverage",
-  ".next",
-  "out",
-]);
-
-const MIME: Record<string, string> = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".webp": "image/webp",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".md": "text/markdown; charset=utf-8",
-  ".json": "application/json; charset=utf-8",
-};
-
-const MIME_EXT: Record<string, string> = {
-  "image/png": ".png",
-  "image/jpeg": ".jpg",
-  "image/webp": ".webp",
-  "image/gif": ".gif",
-  "image/svg+xml": ".svg",
-};
-const MANAGED_ASSET_RE = /^assets\/[a-f0-9]{64}\.(png|jpe?g|webp|gif|svg)$/i;
-const ROOT_LINK_HEADER = '</llms.txt>; rel="describedby"; type="text/plain", </.well-known/viteboard.json>; rel="alternate"; type="application/json"';
-
-const execFileAsync = promisify(execFile);
-
-type WorkspaceManifest = {
-  version: 1;
-  projects: WorkspaceProjectRecord[];
-};
-
-type WorkspaceProjectRecord = {
-  id: string;
-  label: string;
-  rootPath: string;
-};
-
-type WorkspaceProject = WorkspaceProjectRecord & {
-  docsRoots: DocsRoot[];
-};
-
-type DocsRoot = {
-  id: string;
-  projectId: string;
-  projectLabel: string;
-  absPath: string;
-  relativePath: string;
-  displayPath: string;
-};
-
-type WorkspaceResponse = {
-  projects: Array<{
-    id: string;
-    label: string;
-    rootPath: string;
-    docsRoots: Array<{
-      id: string;
-      projectId: string;
-      projectLabel: string;
-      relativePath: string;
-      displayPath: string;
-    }>;
-  }>;
-};
-
-type TreeNode =
-  | { type: "file"; name: string; path: string }
-  | { type: "dir"; name: string; path: string; children: TreeNode[] };
-
-function contentApiPlugin(): Plugin {
-  const cwd = process.cwd();
-  const packageRoot = path.dirname(fileURLToPath(import.meta.url));
-  const workspaceDir = path.resolve(cwd, WORKSPACE_DIR);
-  const workspaceFile = path.join(workspaceDir, WORKSPACE_FILE);
-  const machineDir = path.join(packageRoot, "content", "machine");
-
-  function send(res: ServerResponse, status: number, body: unknown): void {
-    res.statusCode = status;
-    res.setHeader("Content-Type", "application/json; charset=utf-8");
-    res.end(JSON.stringify(body));
-  }
-
-  function sendText(res: ServerResponse, status: number, body: string, type: string): void {
-    res.statusCode = status;
-    res.setHeader("Content-Type", type);
-    res.end(body);
-  }
-
-  function sendBinary(res: ServerResponse, status: number, body: Buffer, type: string, fileName?: string): void {
-    res.statusCode = status;
-    res.setHeader("Content-Type", type);
-    if (fileName) res.setHeader("Content-Disposition", `attachment; filename="${fileName.replace(/[\r\n\"]/g, "-")}"`);
-    res.end(body);
-  }
-
-  async function readMachineAsset(fileName: string): Promise<string> {
-    return fs.readFile(path.join(machineDir, fileName), "utf-8");
-  }
-
-  let chromiumBinaryPromise: Promise<string> | null = null;
-
-  async function resolveChromiumBinary(): Promise<string> {
-    if (chromiumBinaryPromise) return chromiumBinaryPromise;
-    chromiumBinaryPromise = (async () => {
-      const candidates = ["chromium-browser", "chromium", "google-chrome", "google-chrome-stable"];
-      for (const candidate of candidates) {
-        try {
-          await execFileAsync("which", [candidate]);
-          return candidate;
-        } catch {
-          /* keep trying */
-        }
-      }
-      throw new Error("No Chromium-compatible browser is available for PDF export.");
-    })();
-    return chromiumBinaryPromise;
-  }
-
-  function sanitizePdfFileName(input: string): string {
-    const cleaned = String(input ?? "").trim().replace(/[\\/:*?"<>|]+/g, "-").replace(/\s+/g, " ").slice(0, 120) || "export";
-    return cleaned.toLowerCase().endsWith(".pdf") ? cleaned : `${cleaned}.pdf`;
-  }
-
-  function mmToInches(mm: number): number {
-    return mm / 25.4;
-  }
-
-  async function openCdpPage(port: string, url: string): Promise<string> {
-    const res = await fetch(`http://127.0.0.1:${port}/json/new?about:blank`, { method: "PUT" });
-    const target = await res.json() as { webSocketDebuggerUrl: string };
-    if (!target.webSocketDebuggerUrl) throw new Error("Could not open Chromium page target for PDF export.");
-    return target.webSocketDebuggerUrl;
-  }
-
-  async function printPdfViaCdp(wsUrl: string, url: string, pdf: {
-    displayHeaderFooter: boolean;
-    headerTemplate?: string;
-    footerTemplate?: string;
-    marginTopMm?: number;
-    marginBottomMm?: number;
-    marginLeftMm?: number;
-    marginRightMm?: number;
-  }): Promise<Buffer> {
-    const ws = new WebSocket(wsUrl);
-    let nextId = 0;
-    const pending = new Map<number, { resolve: (value: any) => void; reject: (error: Error) => void }>();
-    let loadResolve: (() => void) | null = null;
-    const loaded = new Promise<void>((resolve) => { loadResolve = resolve; });
-    ws.onmessage = (event) => {
-      const message = JSON.parse(String(event.data));
-      if (message.method === "Page.loadEventFired") {
-        loadResolve?.();
-        loadResolve = null;
-        return;
-      }
-      if (!message.id) return;
-      const entry = pending.get(message.id);
-      if (!entry) return;
-      pending.delete(message.id);
-      if (message.error) entry.reject(new Error(message.error.message || "CDP error"));
-      else entry.resolve(message.result);
-    };
-    const opened = new Promise<void>((resolve, reject) => {
-      ws.onopen = () => resolve();
-      ws.onerror = () => reject(new Error("Could not connect to Chromium PDF export session."));
-    });
-    const send = (method: string, params: Record<string, unknown> = {}) => new Promise<any>((resolve, reject) => {
-      const id = ++nextId;
-      pending.set(id, { resolve, reject });
-      ws.send(JSON.stringify({ id, method, params }));
-    });
-    await opened;
-    try {
-      await send("Page.enable");
-      await send("Runtime.enable");
-      await send("Page.navigate", { url });
-      await loaded;
-      await send("Runtime.evaluate", {
-        expression: "document.fonts ? document.fonts.ready.then(() => true) : true",
-        awaitPromise: true,
-        returnByValue: true,
-      });
-      const result = await send("Page.printToPDF", {
-        printBackground: true,
-        preferCSSPageSize: true,
-        displayHeaderFooter: pdf.displayHeaderFooter,
-        headerTemplate: pdf.headerTemplate ?? "<div></div>",
-        footerTemplate: pdf.footerTemplate ?? "<div></div>",
-        marginTop: mmToInches(pdf.marginTopMm ?? 12),
-        marginBottom: mmToInches(pdf.marginBottomMm ?? 12),
-        marginLeft: mmToInches(pdf.marginLeftMm ?? 12),
-        marginRight: mmToInches(pdf.marginRightMm ?? 12),
-      }) as { data: string };
-      return Buffer.from(result.data, "base64");
-    } finally {
-      try { ws.close(); } catch { /* ignore */ }
-    }
-  }
-
-  async function renderPdfFromHtml(html: string, fileName: string, pdf: {
-    displayHeaderFooter?: boolean;
-    headerTemplate?: string;
-    footerTemplate?: string;
-    marginTopMm?: number;
-    marginBottomMm?: number;
-    marginLeftMm?: number;
-    marginRightMm?: number;
-  } = {}): Promise<Buffer> {
-    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "viteboard-pdf-"));
-    const htmlPath = path.join(tmpDir, "publication.html");
-    const profileDir = path.join(tmpDir, "profile");
-    const browser = await resolveChromiumBinary();
-    let browserProcess: import("node:child_process").ChildProcess | null = null;
-    try {
-      await fs.writeFile(htmlPath, html, "utf-8");
-      await fs.mkdir(profileDir, { recursive: true });
-      browserProcess = execFile(browser, [
-        "--headless",
-        "--disable-gpu",
-        "--no-sandbox",
-        `--user-data-dir=${profileDir}`,
-        "--remote-debugging-port=0",
-        "about:blank",
-      ], { windowsHide: true });
-      const activePortPath = path.join(profileDir, "DevToolsActivePort");
-      for (let attempt = 0; attempt < 100; attempt += 1) {
-        try {
-          const raw = await fs.readFile(activePortPath, "utf-8");
-          const port = raw.split(/\r?\n/)[0]?.trim();
-          if (!port) throw new Error("Chromium debugging port missing.");
-          const wsUrl = await openCdpPage(port, pathToFileURL(htmlPath).href);
-          return await printPdfViaCdp(wsUrl, pathToFileURL(htmlPath).href, {
-            displayHeaderFooter: Boolean(pdf.displayHeaderFooter),
-            headerTemplate: pdf.headerTemplate,
-            footerTemplate: pdf.footerTemplate,
-            marginTopMm: pdf.marginTopMm,
-            marginBottomMm: pdf.marginBottomMm,
-            marginLeftMm: pdf.marginLeftMm,
-            marginRightMm: pdf.marginRightMm,
-          });
-        } catch {
-          await new Promise((resolve) => setTimeout(resolve, 100));
-        }
-      }
-      throw new Error("Timed out starting Chromium PDF export session.");
-    } finally {
-      if (browserProcess) {
-        const exited = new Promise<void>((resolve) => {
-          browserProcess?.once("exit", () => resolve());
-          browserProcess?.once("close", () => resolve());
-        });
-        try { browserProcess.kill(); } catch { /* ignore */ }
-        await Promise.race([exited, new Promise((resolve) => setTimeout(resolve, 500))]);
-      }
-      await fs.rm(tmpDir, { recursive: true, force: true });
-    }
-  }
-
-  function revisionForText(content: string): string {
-    return createHash("sha1").update(content).digest("hex");
-  }
-
-  function readBody(req: IncomingMessage): Promise<string> {
-    return new Promise((resolve, reject) => {
-      let data = "";
-      req.on("data", (chunk) => {
-        data += chunk;
-        if (data.length > 64 * 1024 * 1024) {
-          reject(new Error("Payload too large"));
-          req.destroy();
-        }
-      });
-      req.on("end", () => resolve(data));
-      req.on("error", reject);
-    });
-  }
-
-  function hashPath(value: string): string {
-    let hash = 2166136261;
-    for (let i = 0; i < value.length; i++) {
-      hash ^= value.charCodeAt(i);
-      hash = Math.imul(hash, 16777619);
-    }
-    return (hash >>> 0).toString(36);
-  }
-
-  async function canonicalizeProjectRoot(rootPath: string): Promise<string> {
-    const resolved = path.resolve(rootPath);
-    try {
-      return path.resolve(await fs.realpath(resolved));
-    } catch {
-      return resolved;
-    }
-  }
-
-  function isNestedPath(parent: string, child: string): boolean {
-    const rel = path.relative(parent, child);
-    return rel !== "" && rel !== "." && !rel.startsWith("..") && !path.isAbsolute(rel);
-  }
-
-  function findOverlappingProject(
-    projects: WorkspaceProjectRecord[],
-    candidateRoot: string,
-    ignoreProjectId?: string
-  ): WorkspaceProjectRecord | null {
-    for (const project of projects) {
-      if (ignoreProjectId && project.id === ignoreProjectId) continue;
-      if (
-        project.rootPath === candidateRoot ||
-        isNestedPath(project.rootPath, candidateRoot) ||
-        isNestedPath(candidateRoot, project.rootPath)
-      ) {
-        return project;
-      }
-    }
-    return null;
-  }
-
-  function overlapError(existing: WorkspaceProjectRecord, candidateRoot: string): string {
-    if (existing.rootPath === candidateRoot) {
-      return `\"${existing.label}\" is already added. Pick a different folder, or remove the existing project first.`;
-    }
-    if (isNestedPath(existing.rootPath, candidateRoot)) {
-      return `That folder is inside the existing workspace project \"${existing.label}\". ViteBoard only allows one project root per nested path.`;
-    }
-    return `That folder contains the existing workspace project \"${existing.label}\". Add the more specific project instead, or remove the current one first.`;
-  }
-
-  async function ensureWorkspaceDir(): Promise<void> {
-    await fs.mkdir(workspaceDir, { recursive: true });
-  }
-
-  async function loadManifest(): Promise<WorkspaceManifest> {
-    try {
-      const raw = await fs.readFile(workspaceFile, "utf-8");
-      const parsed = JSON.parse(raw) as Partial<WorkspaceManifest>;
-      const rawProjects = Array.isArray(parsed.projects)
-        ? parsed.projects.filter((item): item is WorkspaceProjectRecord => {
-            return !!item && typeof item.id === "string" && typeof item.rootPath === "string";
-          })
-        : [];
-      const projects: WorkspaceProjectRecord[] = [];
-      const seenIds = new Set<string>();
-      const seenPaths = new Set<string>();
-      for (const item of rawProjects) {
-        const rootPath = await canonicalizeProjectRoot(item.rootPath);
-        const id = item.id.trim() || `project-${hashPath(rootPath)}`;
-        if (seenIds.has(id) || seenPaths.has(rootPath)) continue;
-        seenIds.add(id);
-        seenPaths.add(rootPath);
-        projects.push({
-          id,
-          label: typeof item.label === "string" && item.label.trim() ? item.label.trim() : path.basename(rootPath),
-          rootPath,
-        });
-      }
-      return { version: 1, projects };
-    } catch {
-      return { version: 1, projects: [] };
-    }
-  }
-
-  async function saveManifest(manifest: WorkspaceManifest): Promise<void> {
-    await ensureWorkspaceDir();
-    await fs.writeFile(workspaceFile, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
-  }
-
-  async function dirExists(absPath: string): Promise<boolean> {
-    try {
-      return (await fs.stat(absPath)).isDirectory();
-    } catch {
-      return false;
-    }
-  }
-
-  async function loadProjects(): Promise<WorkspaceProjectRecord[]> {
-    return (await loadManifest()).projects;
-  }
-
-  async function openProjectPicker(): Promise<string | null> {
-    if (process.platform === "darwin") {
-      try {
-        const { stdout } = await execFileAsync("osascript", [
-          "-e",
-          'set chosenFolder to choose folder with prompt "Select a project root to add to ViteBoard"',
-          "-e",
-          'POSIX path of chosenFolder',
-        ]);
-        const picked = stdout.trim();
-        return picked || null;
-      } catch {
-        return null;
-      }
-    }
-
-    if (process.platform === "win32") {
-      const script = [
-        "Add-Type -AssemblyName System.Windows.Forms",
-        '$dialog = New-Object System.Windows.Forms.FolderBrowserDialog',
-        '$dialog.Description = "Select a project root to add to ViteBoard"',
-        '$dialog.ShowNewFolderButton = $false',
-        'if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {',
-        '  [Console]::Out.Write($dialog.SelectedPath)',
-        '}',
-      ].join("; ");
-      try {
-        const { stdout } = await execFileAsync("powershell", [
-          "-NoProfile",
-          "-STA",
-          "-Command",
-          script,
-        ]);
-        const picked = stdout.trim();
-        return picked || null;
-      } catch {
-        return null;
-      }
-    }
-
-    const linuxPickers: Array<[string, string[]]> = [
-      ["zenity", ["--file-selection", "--directory", "--title=Select a project root to add to ViteBoard"]],
-      ["kdialog", ["--getexistingdirectory", ".", "Select a project root to add to ViteBoard"]],
-    ];
-    let sawInstalledPicker = false;
-    for (const [command, args] of linuxPickers) {
-      try {
-        await execFileAsync("which", [command]);
-        sawInstalledPicker = true;
-        const { stdout } = await execFileAsync(command, args);
-        const picked = stdout.trim();
-        if (picked) return picked;
-      } catch {
-        if (sawInstalledPicker) return null;
-      }
-    }
-    throw new Error("No supported folder picker found. Install zenity or kdialog.");
-  }
-
-  function isIgnoredDir(name: string): boolean {
-    return name.startsWith(".") || IGNORE_DIRS.has(name);
-  }
-
-  async function discoverDocsRoots(project: WorkspaceProjectRecord): Promise<DocsRoot[]> {
-    const roots: DocsRoot[] = [];
-    const projectRoot = path.resolve(project.rootPath);
-
-    async function walk(absDir: string): Promise<void> {
-      let entries: import("node:fs").Dirent[];
-      try {
-        entries = await fs.readdir(absDir, { withFileTypes: true });
-      } catch {
-        return;
-      }
-
-      for (const entry of entries) {
-        if (!entry.isDirectory()) continue;
-        if (isIgnoredDir(entry.name)) continue;
-        const child = path.join(absDir, entry.name);
-        if (entry.name === "docs") {
-          const relativePath = path.relative(projectRoot, child).replace(/\\/g, "/") || "docs";
-          roots.push({
-            id: `root-${hashPath(child)}`,
-            projectId: project.id,
-            projectLabel: project.label,
-            absPath: child,
-            relativePath,
-            displayPath: relativePath,
-          });
-        }
-        await walk(child);
-      }
-    }
-
-    if (await dirExists(projectRoot)) {
-      if (path.basename(projectRoot) === "docs") {
-        roots.push({
-          id: `root-${hashPath(projectRoot)}`,
-          projectId: project.id,
-          projectLabel: project.label,
-          absPath: projectRoot,
-          relativePath: "docs",
-          displayPath: "docs",
-        });
-      }
-      await walk(projectRoot);
-    }
-
-    roots.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
-    return roots.filter((root, index, list) => list.findIndex((other) => other.absPath === root.absPath) === index);
-  }
-
-  async function getWorkspace(): Promise<WorkspaceProject[]> {
-    const projects = await loadProjects();
-    const out: WorkspaceProject[] = [];
-
-    for (const project of projects) {
-      if (!(await dirExists(project.rootPath))) continue;
-      out.push({
-        ...project,
-        docsRoots: await discoverDocsRoots(project),
-      });
-    }
-    return out;
-  }
-
-  function toWorkspaceResponse(projects: WorkspaceProject[]): WorkspaceResponse {
-    return {
-      projects: projects.map((project) => ({
-        id: project.id,
-        label: project.label,
-        rootPath: project.rootPath,
-        docsRoots: project.docsRoots.map((root) => ({
-          id: root.id,
-          projectId: root.projectId,
-          projectLabel: root.projectLabel,
-          relativePath: root.relativePath,
-          displayPath: root.displayPath,
-        })),
-      })),
-    };
-  }
-
-  async function resolveRoot(rootId: string): Promise<{ root: DocsRoot; nestedRoots: Set<string> } | null> {
-    const projects = await getWorkspace();
-    for (const project of projects) {
-      const root = project.docsRoots.find((item) => item.id === rootId);
-      if (!root) continue;
-      const nestedRoots = new Set(
-        project.docsRoots
-          .filter((item) => item.id !== root.id && item.absPath.startsWith(root.absPath + path.sep))
-          .map((item) => item.absPath)
-      );
-      return { root, nestedRoots };
-    }
-    return null;
-  }
-
-  function safeResolve(root: string, rel: string): string | null {
-    const normalized = path.normalize(String(rel ?? "").replace(/^[/\\]+/, "")).replace(/\\/g, "/");
-    const abs = path.resolve(root, normalized);
-    if (abs !== root && !abs.startsWith(root + path.sep)) return null;
-    return abs;
-  }
-
-  function normalizeRelativePath(input: string): string {
-    const parts: string[] = [];
-    for (const raw of String(input ?? "").replace(/\\/g, "/").split("/")) {
-      const part = raw.trim();
-      if (!part || part === ".") continue;
-      if (part === "..") {
-        if (parts.length > 0) parts.pop();
-        continue;
-      }
-      parts.push(part);
-    }
-    return parts.join("/");
-  }
-
-  function dirnamePosix(filePath: string): string {
-    const normalized = normalizeRelativePath(filePath);
-    const idx = normalized.lastIndexOf("/");
-    return idx === -1 ? "" : normalized.slice(0, idx);
-  }
-
-  function resolveDocRelativePath(fromFile: string, target: string): string | null {
-    const raw = String(target ?? "").trim();
-    if (!raw || /^(https?:|mailto:|tel:|#|data:)/i.test(raw)) return null;
-    if (raw.startsWith("/")) return normalizeRelativePath(raw);
-    const base = dirnamePosix(fromFile);
-    return normalizeRelativePath(base ? `${base}/${raw}` : raw);
-  }
-
-  function isManagedAssetPath(relPath: string): boolean {
-    return MANAGED_ASSET_RE.test(normalizeRelativePath(relPath));
-  }
-
-  async function collectFiles(dir: string, base = ""): Promise<string[]> {
-    let entries: import("node:fs").Dirent[];
-    try {
-      entries = await fs.readdir(dir, { withFileTypes: true });
-    } catch {
-      return [];
-    }
-
-    const files: string[] = [];
-    for (const entry of entries) {
-      if (entry.name.startsWith(".")) continue;
-      const rel = base ? `${base}/${entry.name}` : entry.name;
-      const abs = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        files.push(...(await collectFiles(abs, rel)));
-      } else {
-        files.push(rel);
-      }
-    }
-    return files;
-  }
-
-  function collectBoardAssetRefs(raw: unknown): Set<string> {
-    const refs = new Set<string>();
-    if (typeof raw !== "object" || raw === null) return refs;
-    const elements = Array.isArray((raw as { elements?: unknown[] }).elements)
-      ? (raw as { elements: unknown[] }).elements
-      : [];
-    for (const element of elements) {
-      if (typeof element !== "object" || element === null) continue;
-      const data = (element as { data?: Record<string, unknown> }).data;
-      const src = typeof data?.src === "string" ? normalizeRelativePath(data.src) : "";
-      if (isManagedAssetPath(src)) refs.add(src);
-    }
-    return refs;
-  }
-
-  function collectMarkdownAssetRefs(markdown: string, docPath: string): Set<string> {
-    const refs = new Set<string>();
-    const imagePatterns = [
-      /!\[[^\]]*\]\(([^)\s]+)\)/g,
-      /<img\b[^>]*\bsrc=["']([^"']+)["'][^>]*>/gi,
-    ];
-
-    for (const pattern of imagePatterns) {
-      pattern.lastIndex = 0;
-      let match: RegExpExecArray | null;
-      while ((match = pattern.exec(markdown))) {
-        const resolved = resolveDocRelativePath(docPath, match[1]);
-        if (resolved && isManagedAssetPath(resolved)) refs.add(resolved);
-      }
-    }
-
-    return refs;
-  }
-
-  async function cleanupManagedAssets(rootAbsPath: string, preservePaths: string[] = []): Promise<number> {
-    const allFiles = await collectFiles(rootAbsPath);
-    const managedAssets = allFiles.filter((file) => isManagedAssetPath(file));
-    if (managedAssets.length === 0) return 0;
-
-    const referenced = new Set<string>();
-    for (const relPath of allFiles) {
-      const abs = safeResolve(rootAbsPath, relPath);
-      if (!abs) continue;
-      if (relPath.endsWith(".board.json")) {
-        try {
-          const raw = JSON.parse(await fs.readFile(abs, "utf-8"));
-          for (const ref of collectBoardAssetRefs(raw)) referenced.add(ref);
-        } catch {
-          // Ignore unreadable or invalid boards; cleanup stays conservative.
-        }
-        continue;
-      }
-      if (relPath.endsWith(".md")) {
-        try {
-          const markdown = await fs.readFile(abs, "utf-8");
-          for (const ref of collectMarkdownAssetRefs(markdown, relPath)) referenced.add(ref);
-        } catch {
-          // Ignore unreadable docs; cleanup stays conservative.
-        }
-      }
-    }
-
-    for (const relPath of preservePaths) {
-      const normalized = normalizeRelativePath(relPath);
-      if (isManagedAssetPath(normalized)) referenced.add(normalized);
-    }
-
-    let removed = 0;
-    for (const relPath of managedAssets) {
-      if (referenced.has(relPath)) continue;
-      const abs = safeResolve(rootAbsPath, relPath);
-      if (!abs) continue;
-      try {
-        await fs.unlink(abs);
-        removed++;
-      } catch (err) {
-        if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
-      }
-    }
-    return removed;
-  }
-
-  async function walkDocsRoot(dir: string, base: string, nestedRoots: Set<string>): Promise<TreeNode[]> {
-    let entries: import("node:fs").Dirent[];
-    try {
-      entries = await fs.readdir(dir, { withFileTypes: true });
-    } catch {
-      return [];
-    }
-    const nodes: TreeNode[] = [];
-    for (const entry of entries) {
-      if (entry.name.startsWith(".")) continue;
-      const absEntry = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (nestedRoots.has(absEntry)) continue;
-        const rel = base ? `${base}/${entry.name}` : entry.name;
-        nodes.push({
-          type: "dir",
-          name: entry.name,
-          path: rel,
-          children: await walkDocsRoot(absEntry, rel, nestedRoots),
-        });
-      } else {
-        nodes.push({
-          type: "file",
-          name: entry.name,
-          path: base ? `${base}/${entry.name}` : entry.name,
-        });
-      }
-    }
-    nodes.sort((a, b) => {
-      if (a.type !== b.type) return a.type === "dir" ? -1 : 1;
-      return a.name.localeCompare(b.name);
-    });
-    return nodes;
-  }
-
-  /** Walk the project tree for Raw sidebar mode. */
-  async function walkProjectTree(dir: string, base: string): Promise<TreeNode[]> {
-    let entries: import("node:fs").Dirent[];
-    try {
-      entries = await fs.readdir(dir, { withFileTypes: true });
-    } catch {
-      return [];
-    }
-    const nodes: TreeNode[] = [];
-    for (const entry of entries) {
-      if (entry.name.startsWith(".")) continue;
-      const rel = base ? `${base}/${entry.name}` : entry.name;
-      if (entry.isDirectory()) {
-        if (isIgnoredDir(entry.name)) continue;
-        nodes.push({
-          type: "dir",
-          name: entry.name,
-          path: rel,
-          children: await walkProjectTree(path.join(dir, entry.name), rel),
-        });
-      } else {
-        nodes.push({ type: "file", name: entry.name, path: rel });
-      }
-    }
-    nodes.sort((a, b) => {
-      if (a.type !== b.type) return a.type === "dir" ? -1 : 1;
-      return a.name.localeCompare(b.name);
-    });
-    return nodes;
-  }
-
-  async function sendMachineFile(res: ServerResponse, fileName: string, contentType: string): Promise<void> {
-    return sendText(res, 200, await readMachineAsset(fileName), contentType);
-  }
-
-  const handler: Connect.NextHandleFunction = (req, res, next) => {
-    const url = req.url ?? "";
-    const parsed = new URL(url, "http://localhost");
-    const route = parsed.pathname;
-
-    if (route === "/" || route === "/index.html") {
-      res.setHeader("Link", ROOT_LINK_HEADER);
-      return next();
-    }
-
-    if (route === "/llms.txt") {
-      void sendMachineFile(res, "llms.txt", "text/plain; charset=utf-8");
-      return;
-    }
-
-    if (route === "/.well-known/viteboard.json") {
-      void sendMachineFile(res, "viteboard.json", "application/json; charset=utf-8");
-      return;
-    }
-
-    if (route === "/viteboard-guide.md") {
-      void sendMachineFile(res, "guide.md", "text/markdown; charset=utf-8");
-      return;
-    }
-
-    if (route === "/board-v1.schema.json") {
-      void sendMachineFile(res, "board-v1.schema.json", "application/schema+json; charset=utf-8");
-      return;
-    }
-
-    if (route === "/viteboard-example.board.json") {
-      void sendMachineFile(res, "example.board.json", "application/json; charset=utf-8");
-      return;
-    }
-
-    if (!route.startsWith("/__api/")) return next();
-
-    void (async () => {
-      try {
-        const method = (req.method ?? "GET").toUpperCase();
-
-        if (route === "/__api/workspace" && method === "GET") {
-          return send(res, 200, await toWorkspaceResponse(await getWorkspace()));
-        }
-
-        if (route === "/__api/workspace/project" && method === "POST") {
-          const { rootPath, label } = JSON.parse(await readBody(req));
-          const absRoot = await canonicalizeProjectRoot(String(rootPath ?? "").trim());
-          if (!absRoot || !(await dirExists(absRoot))) {
-            return send(res, 400, { error: "Project root not found" });
-          }
-          const manifest = await loadManifest();
-          const existingProject = manifest.projects.find((item) => item.rootPath === absRoot);
-          const projectId = existingProject?.id ?? `project-${hashPath(absRoot)}`;
-          const overlap = findOverlappingProject(manifest.projects, absRoot, projectId);
-          if (overlap) return send(res, 409, { error: overlapError(overlap, absRoot) });
-          const project: WorkspaceProjectRecord = {
-            id: projectId,
-            label: String(label ?? "").trim() || path.basename(absRoot) || absRoot,
-            rootPath: absRoot,
-          };
-          const existingIndex = manifest.projects.findIndex((item) => item.rootPath === absRoot || item.id === project.id);
-          if (existingIndex === -1) manifest.projects.push(project);
-          else manifest.projects.splice(existingIndex, 1, project);
-          await saveManifest(manifest);
-          return send(res, 200, await toWorkspaceResponse(await getWorkspace()));
-        }
-
-        if (route === "/__api/workspace/pick-project" && method === "POST") {
-          const picked = await openProjectPicker();
-          if (!picked) return send(res, 200, { cancelled: true, workspace: await toWorkspaceResponse(await getWorkspace()) });
-          const absRoot = await canonicalizeProjectRoot(picked);
-          if (!(await dirExists(absRoot))) return send(res, 400, { error: "Project root not found" });
-          const manifest = await loadManifest();
-          const existingProject = manifest.projects.find((item) => item.rootPath === absRoot);
-          const projectId = existingProject?.id ?? `project-${hashPath(absRoot)}`;
-          const overlap = findOverlappingProject(manifest.projects, absRoot, projectId);
-          if (overlap) return send(res, 409, { error: overlapError(overlap, absRoot) });
-          const project: WorkspaceProjectRecord = {
-            id: projectId,
-            label: path.basename(absRoot) || absRoot,
-            rootPath: absRoot,
-          };
-          const existingIndex = manifest.projects.findIndex((item) => item.rootPath === absRoot || item.id === project.id);
-          if (existingIndex === -1) manifest.projects.push(project);
-          else manifest.projects.splice(existingIndex, 1, project);
-          await saveManifest(manifest);
-          return send(res, 200, { cancelled: false, workspace: await toWorkspaceResponse(await getWorkspace()), addedProjectId: project.id });
-        }
-
-        if (route === "/__api/workspace/project/docs-root" && method === "POST") {
-          const { projectId } = JSON.parse(await readBody(req));
-          const manifest = await loadManifest();
-          const project = manifest.projects.find((item) => item.id === String(projectId ?? ""));
-          if (!project) return send(res, 404, { error: "Project not found" });
-          const docsPath = path.join(project.rootPath, "docs");
-          await fs.mkdir(docsPath, { recursive: true });
-          const workspace = await getWorkspace();
-          const refreshedProject = workspace.find((item) => item.id === project.id);
-          const root = refreshedProject?.docsRoots.find((item) => item.absPath === docsPath)
-            ?? refreshedProject?.docsRoots[0];
-          if (!root) return send(res, 500, { error: "Could not create docs root" });
-          return send(res, 200, {
-            root: {
-              id: root.id,
-              projectId: root.projectId,
-              projectLabel: root.projectLabel,
-              relativePath: root.relativePath,
-              displayPath: root.displayPath,
-            },
-            workspace: await toWorkspaceResponse(workspace),
-          });
-        }
-
-        if (route === "/__api/workspace/project/docs-area" && method === "POST") {
-          const { projectId, folderName } = JSON.parse(await readBody(req));
-          const manifest = await loadManifest();
-          const project = manifest.projects.find((item) => item.id === String(projectId ?? ""));
-          if (!project) return send(res, 404, { error: "Project not found" });
-          const folderPath = path.join(project.rootPath, String(folderName ?? ""));
-          const docsPath = path.join(folderPath, "docs");
-          await fs.mkdir(docsPath, { recursive: true });
-          const workspace = await getWorkspace();
-          const refreshedProject = workspace.find((item) => item.id === project.id);
-          const root = refreshedProject?.docsRoots.find((item) => item.absPath === docsPath);
-          if (!root) return send(res, 500, { error: "Could not create docs area" });
-          return send(res, 200, {
-            root: {
-              id: root.id,
-              projectId: root.projectId,
-              projectLabel: root.projectLabel,
-              relativePath: root.relativePath,
-              displayPath: root.displayPath,
-            },
-            workspace: await toWorkspaceResponse(workspace),
-          });
-        }
-
-        if (route === "/__api/workspace/project/create-docs-folder" && method === "POST") {
-          const { projectId, parentPath } = JSON.parse(await readBody(req));
-          const manifest = await loadManifest();
-          const project = manifest.projects.find((item) => item.id === String(projectId ?? ""));
-          if (!project) return send(res, 404, { error: "Project not found" });
-          const docsPath = path.join(project.rootPath, String(parentPath ?? ""), "docs");
-          await fs.mkdir(docsPath, { recursive: true });
-          return send(res, 200, { ok: true, workspace: await toWorkspaceResponse(await getWorkspace()) });
-        }
-
-        if (route === "/__api/workspace/project" && method === "DELETE") {
-          const id = parsed.searchParams.get("id") ?? "";
-          const manifest = await loadManifest();
-          manifest.projects = manifest.projects.filter((item) => item.id !== id);
-          await saveManifest(manifest);
-          return send(res, 200, await toWorkspaceResponse(await getWorkspace()));
-        }
-
-        if (route === "/__api/tree" && method === "GET") {
-          const rootId = parsed.searchParams.get("rootId") ?? "";
-          const resolved = await resolveRoot(rootId);
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const tree = await walkDocsRoot(resolved.root.absPath, "", resolved.nestedRoots);
-          return send(res, 200, { tree });
-        }
-
-        if (route === "/__api/project-tree" && method === "GET") {
-          const projectId = parsed.searchParams.get("projectId") ?? "";
-          const workspace = await getWorkspace();
-          const project = workspace.find(p => p.id === projectId);
-          if (!project) return send(res, 404, { error: "Project not found" });
-          const tree = await walkProjectTree(project.rootPath, "");
-          return send(res, 200, { tree });
-        }
-
-        if (route === "/__api/file" && method === "GET") {
-          const rootId = parsed.searchParams.get("rootId") ?? "";
-          const rel = parsed.searchParams.get("path") ?? "";
-          const resolved = await resolveRoot(rootId);
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, rel);
-          if (!abs) return send(res, 400, { error: "Invalid path" });
-          try {
-            const content = await fs.readFile(abs, "utf-8");
-            return send(res, 200, { path: rel, content, revision: revisionForText(content) });
-          } catch {
-            return send(res, 404, { error: "Not found" });
-          }
-        }
-
-        if (route === "/__api/file" && method === "PUT") {
-          const { rootId, path: rel, content, expectedRevision } = JSON.parse(await readBody(req));
-          const resolved = await resolveRoot(String(rootId ?? ""));
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, String(rel));
-          if (!abs) return send(res, 400, { error: "Invalid path" });
-          let currentContent: string | null = null;
-          try {
-            currentContent = await fs.readFile(abs, "utf-8");
-          } catch (err) {
-            if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
-          }
-          const currentRevision = currentContent === null ? null : revisionForText(currentContent);
-          if (typeof expectedRevision === "string" && expectedRevision !== currentRevision) {
-            return send(res, 409, {
-              error: "File changed on disk",
-              currentRevision,
-              path: rel,
-            });
-          }
-          await fs.mkdir(path.dirname(abs), { recursive: true });
-          const nextContent = String(content ?? "");
-          await fs.writeFile(abs, nextContent, "utf-8");
-          const revision = revisionForText(nextContent);
-          return send(res, 200, { ok: true, path: rel, revision });
-        }
-
-        if (route === "/__api/directory" && method === "PUT") {
-          const { rootId, path: rel } = JSON.parse(await readBody(req));
-          const resolved = await resolveRoot(String(rootId ?? ""));
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, String(rel));
-          if (!abs) return send(res, 400, { error: "Invalid path" });
-          await fs.mkdir(abs, { recursive: true });
-          return send(res, 200, { ok: true, path: rel });
-        }
-
-        if (route === "/__api/file" && method === "DELETE") {
-          const rootId = parsed.searchParams.get("rootId") ?? "";
-          const rel = parsed.searchParams.get("path") ?? "";
-          const resolved = await resolveRoot(rootId);
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, rel);
-          if (!abs) return send(res, 400, { error: "Invalid path" });
-          try {
-            await fs.unlink(abs);
-          } catch (err) {
-            if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
-          }
-          return send(res, 200, { ok: true });
-        }
-
-        if (route === "/__api/file" && method === "PATCH") {
-          // Rename/move: { rootId, oldPath, newPath }
-          const { rootId, oldPath, newPath, ignoreMissing } = JSON.parse(await readBody(req));
-          const resolved = await resolveRoot(String(rootId ?? ""));
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const absOld = safeResolve(resolved.root.absPath, String(oldPath));
-          const absNew = safeResolve(resolved.root.absPath, String(newPath));
-          if (!absOld || !absNew) return send(res, 400, { error: "Invalid path" });
-          await fs.mkdir(path.dirname(absNew), { recursive: true });
-          try {
-            await fs.rename(absOld, absNew);
-          } catch (err) {
-            if (ignoreMissing && (err as NodeJS.ErrnoException).code === "ENOENT") {
-              return send(res, 200, { ok: true, path: newPath, skipped: true });
-            }
-            throw err;
-          }
-          return send(res, 200, { ok: true, path: newPath });
-        }
-
-        if (route === "/__api/board" && method === "GET") {
-          const rootId = parsed.searchParams.get("rootId") ?? "";
-          const id = parsed.searchParams.get("id") ?? "";
-          const resolved = await resolveRoot(rootId);
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, `${id}.board.json`);
-          if (!abs) return send(res, 400, { error: "Invalid id" });
-          try {
-            const content = await fs.readFile(abs, "utf-8");
-            return send(res, 200, { id, doc: JSON.parse(content), revision: revisionForText(content) });
-          } catch {
-            return send(res, 404, { error: "Not found" });
-          }
-        }
-
-        if (route === "/__api/board" && method === "PUT") {
-          const { rootId, id, doc, expectedRevision } = JSON.parse(await readBody(req));
-          const resolved = await resolveRoot(String(rootId ?? ""));
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, `${String(id)}.board.json`);
-          if (!abs) return send(res, 400, { error: "Invalid id" });
-          let currentContent: string | null = null;
-          try {
-            currentContent = await fs.readFile(abs, "utf-8");
-          } catch (err) {
-            if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
-          }
-          const currentRevision = currentContent === null ? null : revisionForText(currentContent);
-          if (typeof expectedRevision === "string" && expectedRevision !== currentRevision) {
-            return send(res, 409, {
-              error: "Board changed on disk",
-              currentRevision,
-              id,
-            });
-          }
-          await fs.mkdir(path.dirname(abs), { recursive: true });
-          const nextContent = JSON.stringify(doc, null, 2) + "\n";
-          await fs.writeFile(abs, nextContent, "utf-8");
-          const revision = revisionForText(nextContent);
-          return send(res, 200, { ok: true, id, revision });
-        }
-
-        if (route === "/__api/board" && method === "DELETE") {
-          const rootId = parsed.searchParams.get("rootId") ?? "";
-          const id = parsed.searchParams.get("id") ?? "";
-          const resolved = await resolveRoot(rootId);
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, `${id}.board.json`);
-          if (!abs) return send(res, 400, { error: "Invalid id" });
-          try {
-            await fs.unlink(abs);
-          } catch (err) {
-            if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
-          }
-          return send(res, 200, { ok: true, id });
-        }
-
-        if (route === "/__api/asset" && method === "GET") {
-          const rootId = parsed.searchParams.get("rootId") ?? "";
-          const rel = parsed.searchParams.get("path") ?? "";
-          const resolved = await resolveRoot(rootId);
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const abs = safeResolve(resolved.root.absPath, rel);
-          if (!abs) return send(res, 400, { error: "Invalid path" });
-          try {
-            const buf = await fs.readFile(abs);
-            res.statusCode = 200;
-            res.setHeader("Content-Type", MIME[path.extname(abs).toLowerCase()] ?? "application/octet-stream");
-            res.setHeader("Cache-Control", "no-cache");
-            return res.end(buf);
-          } catch {
-            return send(res, 404, { error: "Not found" });
-          }
-        }
-
-        if (route === "/__api/asset" && method === "POST") {
-          const { rootId, name, base64, mimeType } = JSON.parse(await readBody(req));
-          const resolved = await resolveRoot(String(rootId ?? ""));
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const bytes = Buffer.from(String(base64), "base64");
-          const ext = MIME_EXT[String(mimeType ?? "")] ?? (path.extname(String(name ?? "")) || ".png").toLowerCase();
-          const digest = createHash("sha256").update(bytes).digest("hex");
-          const rel = `assets/${digest}${ext}`;
-          const abs = safeResolve(resolved.root.absPath, rel);
-          if (!abs) return send(res, 400, { error: "Invalid path" });
-          await fs.mkdir(path.dirname(abs), { recursive: true });
-          try {
-            await fs.access(abs);
-          } catch {
-            await fs.writeFile(abs, bytes);
-          }
-          return send(res, 200, { ok: true, path: rel });
-        }
-
-        if (route === "/__api/asset/cleanup" && method === "POST") {
-          const { rootId, preservePaths } = JSON.parse(await readBody(req));
-          const resolved = await resolveRoot(String(rootId ?? ""));
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const removed = await cleanupManagedAssets(
-            resolved.root.absPath,
-            Array.isArray(preservePaths) ? preservePaths.filter((item): item is string => typeof item === "string") : []
-          );
-          return send(res, 200, { ok: true, removed });
-        }
-
-        if (route === "/__api/export/pdf" && method === "POST") {
-          const { html, fileName, pdf } = JSON.parse(await readBody(req));
-          if (typeof html !== "string" || !html.trim()) {
-            return send(res, 400, { error: "Missing HTML payload" });
-          }
-          const pdfBuffer = await renderPdfFromHtmlPortable(html, String(fileName ?? "export.pdf"), typeof pdf === "object" && pdf ? pdf : {});
-          return sendBinary(res, 200, pdfBuffer, "application/pdf", sanitizePdfFileNamePortable(String(fileName ?? "export.pdf")));
-        }
-
-        if (route === "/__api/workspace-file" && method === "GET") {
-          await ensureWorkspaceDir();
-          const manifest = await loadManifest();
-          return sendText(res, 200, JSON.stringify(manifest, null, 2) + "\n", "application/json; charset=utf-8");
-        }
-
-        return send(res, 404, { error: "Unknown endpoint" });
-      } catch (err) {
-        return send(res, 500, { error: (err as Error).message });
-      }
-    })();
-  };
-
-  return {
-    name: "viteboard-content-api",
-    configureServer(server) {
-      server.middlewares.use(handler);
-    },
-    configurePreviewServer(server) {
-      server.middlewares.use(handler);
-    },
-  };
-}
+import { defineConfig } from "vite";
+import { createContentApiPlugin } from "./bin/content-api-plugin.mjs";
 
 export default defineConfig({
-  plugins: [contentApiPlugin()],
+  plugins: [createContentApiPlugin()],
 });