@docubook/flame 2.0.0-beta.2 → 2.0.0-beta.3

package/.docu/lib/logger-CQyNTE6L.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-CQyNTE6L.js","names":[],"sources":["../../package.json","../node/logger.ts"],"sourcesContent":["{\n  \"name\": \"@docubook/flame\",\n  \"version\": \"2.0.0-beta.3\",\n  \"description\": \"A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"flame\": \"./bin/cli.js\"\n  },\n  \"files\": [\n    \"bin\",\n    \"template\",\n    \"docu.schema.json\",\n    \".docu\",\n    \"!.docu/__tests__\",\n    \"!.docu/dist\",\n    \"!.docu/build-cache.json\",\n    \"README.md\",\n    \"LICENSE\"\n  ],\n  \"publishConfig\": {\n    \"registry\": \"https://registry.npmjs.org/\",\n    \"access\": \"public\"\n  },\n  \"engines\": {\n    \"node\": \">=20.11\",\n    \"bun\": \">=1.4.0\"\n  },\n  \"scripts\": {\n    \"dev\": \"bun .docu/node/server.ts\",\n    \"build\": \"NODE_ENV=production bun .docu/node/build.ts\",\n    \"clean\": \"bun .docu/node/clean.ts\",\n    \"preview\": \"bun .docu/node/preview.ts\",\n    \"deploy\": \"bun .docu/node/deploy.ts\",\n    \"compile:lib\": \"node bin/compile-lib.mjs\",\n    \"test\": \"vitest run\",\n    \"lint\": \"oxlint .\",\n    \"prepublishOnly\": \"bun .docu/node/clean.ts && oxlint . && vitest run && node bin/compile-lib.mjs\"\n  },\n  \"keywords\": [\n    \"docubook\",\n    \"documentation\",\n    \"static-site\",\n    \"daisyui\",\n    \"bun\",\n    \"docs framework\",\n    \"react\",\n    \"react-dom\"\n  ],\n  \"homepage\": \"https://github.com/DocuBook/docubook/tree/main/packages/flame\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/DocuBook/docubook.git\",\n    \"directory\": \"packages/flame\"\n  },\n  \"author\": \"wildan.nrs\",\n  \"author-url\": \"https://wildan.dev\",\n  \"license\": \"MIT\",\n  \"dependencies\": {\n    \"@docubook/core\": \"workspace:^\",\n    \"@docubook/markdown\": \"workspace:^\",\n    \"@docubook/themes-colors\": \"workspace:^\",\n    \"@docubook/ui-react\": \"workspace:^\",\n    \"@mdx-js/react\": \"^3.0.1\",\n    \"@tailwindcss/cli\": \"4.3.0\",\n    \"@tailwindcss/typography\": \"0.5.16\",\n    \"bun-plugin-tailwind\": \"^0.1.2\",\n    \"daisyui\": \"^5.5.19\",\n    \"lucide-react\": \"^1.14.0\",\n    \"react\": \"^19.2.7\",\n    \"react-dom\": \"^19.2.7\",\n    \"unified\": \"^11.0.0\",\n    \"vite\": \"^8.2.1\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"peerDependencies\": {\n    \"@sentry/bun\": \"^10.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@sentry/bun\": {\n      \"optional\": true\n    }\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^22.0.0\",\n    \"@types/react\": \"^19.0.0\",\n    \"@types/react-dom\": \"^19.0.0\",\n    \"bun-types\": \"^1.4.0\",\n    \"tailwindcss\": \"^4.3.0\",\n    \"typescript\": \"^7.0.2\"\n  }\n}\n","/**\n * Interactive CLI logger with spinner and tree-style route display.\n * Inspired by Next.js/Turbopack build output.\n *\n * Supports structured logging via environment variables:\n * - LOG_LEVEL: debug | info | warn | error (default: info)\n * - LOG_FORMAT: json | pretty (default: pretty)\n */\n\nimport { loadDocuConfig } from \"./paths\";\nimport pkg from \"../../package.json\" with { type: \"json\" };\n\nconst docuConfig = loadDocuConfig();\nconst isCI = !!(process.env.CI || process.env.NO_COLOR || !process.stdout.isTTY);\nconst LOG_FORMAT = process.env.LOG_FORMAT || \"pretty\";\nconst isJSON = LOG_FORMAT === \"json\";\n\ntype LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\nconst LEVELS: Record<LogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };\nconst currentLevel = LEVELS[(process.env.LOG_LEVEL as LogLevel) || \"info\"] ?? LEVELS.info;\n\nfunction shouldLog(level: LogLevel): boolean {\n  return LEVELS[level] >= currentLevel;\n}\n\nfunction jsonLog(level: LogLevel, msg: string, meta?: Record<string, unknown>) {\n  if (!shouldLog(level)) return;\n  const entry = { ts: new Date().toISOString(), ...meta, level, msg };\n  const out = level === \"error\" ? console.error : level === \"warn\" ? console.warn : console.log;\n  out(JSON.stringify(entry));\n}\n\n/** Returns true if the caller should skip (already handled or filtered). */\nfunction guard(level: LogLevel, msg: string, meta?: Record<string, unknown>): boolean {\n  if (isJSON) {\n    jsonLog(level, msg, meta);\n    return true;\n  }\n  return !shouldLog(level);\n}\n\nconst c =\n  isCI || isJSON\n    ? {\n        reset: \"\",\n        bold: \"\",\n        dim: \"\",\n        green: \"\",\n        cyan: \"\",\n        magenta: \"\",\n        yellow: \"\",\n        red: \"\",\n        white: \"\",\n        gray: \"\",\n      }\n    : {\n        reset: \"\\x1b[0m\",\n        bold: \"\\x1b[1m\",\n        dim: \"\\x1b[2m\",\n        green: \"\\x1b[32m\",\n        cyan: \"\\x1b[36m\",\n        magenta: \"\\x1b[35m\",\n        yellow: \"\\x1b[33m\",\n        red: \"\\x1b[31m\",\n        white: \"\\x1b[37m\",\n        gray: \"\\x1b[90m\",\n      };\n\nconst SPINNER_FRAMES = [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"];\n\nclass Spinner {\n  private frame = 0;\n  private message = \"\";\n  private timer: ReturnType<typeof setInterval> | null = null;\n\n  info(finalMsg: string) {\n    if (this.timer) clearInterval(this.timer);\n    this.timer = null;\n    if (isCI) {\n      console.log(`ℹ ${finalMsg}`);\n    } else {\n      process.stdout.write(`\\r\\x1b[K${c.cyan}ℹ${c.reset} ${finalMsg}\\n`);\n      process.stdout.write(\"\\x1b[?25h\");\n    }\n  }\n\n  start(msg: string) {\n    this.message = msg;\n    if (isCI) {\n      console.log(`… ${msg}`);\n      return;\n    }\n    this.frame = 0;\n    process.stdout.write(\"\\x1b[?25l\");\n    this.render();\n    this.timer = setInterval(() => this.render(), 80);\n  }\n\n  stop(finalMsg: string) {\n    if (this.timer) clearInterval(this.timer);\n    this.timer = null;\n    if (isCI) {\n      console.log(`✓ ${finalMsg}`);\n      return;\n    }\n    process.stdout.write(`\\r\\x1b[K${c.green}✓${c.reset} ${finalMsg}\\n`);\n    process.stdout.write(\"\\x1b[?25h\");\n  }\n\n  private render() {\n    const f = SPINNER_FRAMES[this.frame % SPINNER_FRAMES.length];\n    process.stdout.write(`\\r${c.cyan}${f}${c.reset} ${this.message}`);\n    this.frame++;\n  }\n}\n\ninterface RouteItem {\n  title: string;\n  href: string;\n  noLink?: boolean;\n  items?: RouteItem[];\n}\n\nconst MAX_ROUTE_LINES = 5;\nlet routeLineCount = 0;\nlet routeTruncated = false;\n\nfunction printRouteTree(routes: RouteItem[], prefix = \"\", isRoot = true) {\n  for (let i = 0; i < routes.length; i++) {\n    if (routeTruncated) return;\n    if (routeLineCount >= MAX_ROUTE_LINES) {\n      routeTruncated = true;\n      process.stdout.write(`${prefix}${c.dim}...${c.reset}\\n`);\n      return;\n    }\n\n    const route = routes[i];\n    const last = i === routes.length - 1;\n    const connector = isRoot ? \"\" : last ? \"└── \" : \"├── \";\n    const childPrefix = isRoot ? \"\" : last ? \"    \" : \"│   \";\n\n    const path = route.noLink\n      ? `${c.dim}${route.href}${c.reset}`\n      : `${c.white}${route.href}${c.reset}`;\n\n    const label = route.noLink ? `${c.gray}(group)${c.reset}` : \"\";\n\n    process.stdout.write(`${prefix}${connector}${path} ${label}\\n`);\n    routeLineCount++;\n\n    if (route.items?.length) {\n      printRouteTree(route.items, prefix + childPrefix, false);\n    }\n  }\n}\n\nexport const logger = {\n  spinner: new Spinner(),\n\n  buildStart() {\n    if (guard(\"info\", \"build_start\", { package: \"@docubook/flame\", version: pkg.version })) return;\n    console.log(\n      `\\n${c.bold}${c.cyan}  🔥 DocuBook Flame${c.reset} ${c.dim}v${pkg.version}${c.reset}\\n`\n    );\n  },\n\n  bundleStart() {\n    if (guard(\"info\", \"bundle_start\")) return;\n    this.spinner.start(\"Building client bundle...\");\n  },\n\n  bundleDone(ms: number) {\n    if (guard(\"info\", \"bundle_done\", { duration_ms: ms })) return;\n    this.spinner.stop(`Client bundle compiled ${c.dim}(${ms}ms)${c.reset}`);\n  },\n\n  indexStart() {\n    if (guard(\"info\", \"index_start\")) return;\n    this.spinner.start(\"Generating search index...\");\n  },\n\n  indexDone(records: number, ms: number, skipped = false) {\n    if (guard(\"info\", \"index_done\", { records, duration_ms: ms, skipped })) return;\n    this.spinner.stop(\n      skipped\n        ? `Search index cached ${c.dim}(${ms}ms)${c.reset}`\n        : `Search index generated ${c.dim}(${records} records, ${ms}ms)${c.reset}`\n    );\n  },\n\n  routes() {\n    if (guard(\"debug\", \"routes\")) return;\n    const routes = docuConfig.routes as RouteItem[] | undefined;\n    if (!routes?.length) return;\n\n    console.log(`\\n${c.bold}  Routes${c.reset} ${c.dim}(${countRoutes(routes)} pages)${c.reset}\\n`);\n    routeLineCount = 0;\n    routeTruncated = false;\n    printRouteTree(routes, \"  \");\n  },\n\n  ready(port: number, hmr = false) {\n    if (guard(\"info\", \"server_ready\", { port, hmr })) return;\n    console.log(\n      `\\n${c.green}${c.bold}  ✓ Ready${c.reset} in ${c.bold}http://localhost:${port}/docs/${c.reset}`\n    );\n    if (hmr) console.log(`${c.dim}  HMR enabled — watching docs/ for changes${c.reset}`);\n    console.log(\"\");\n  },\n\n  request(method: string, pathname: string, status: number, duration_ms?: number) {\n    if (guard(\"info\", \"http_request\", { method, path: pathname, status, duration_ms })) return;\n    const color = status >= 500 ? c.red : status >= 400 ? c.gray : c.green;\n    const ts = new Date().toLocaleTimeString();\n    const dur = duration_ms != null ? ` ${c.dim}${duration_ms}ms${c.reset}` : \"\";\n    console.log(\n      `${c.dim}  ${ts}${c.reset} ${method} ${pathname} ${color}${status}${c.reset}${dur}`\n    );\n  },\n\n  debug(msg: string, meta?: Record<string, unknown>) {\n    if (guard(\"debug\", msg, meta)) return;\n    console.log(`${c.gray}  [debug] ${msg}${c.reset}`);\n  },\n\n  warn(msg: string, meta?: Record<string, unknown>) {\n    if (guard(\"warn\", msg, meta)) return;\n    console.warn(`${c.yellow}  ⚠ ${msg}${c.reset}`);\n  },\n\n  error(msg: string, meta?: Record<string, unknown>) {\n    if (guard(\"error\", msg, meta)) return;\n    console.error(`${c.red}  ✖ ${msg}${c.reset}`);\n  },\n};\n\nfunction countRoutes(routes: RouteItem[]): number {\n  let count = 0;\n  for (const r of routes) {\n    if (!r.noLink) count++;\n    if (r.items) count += countRoutes(r.items);\n  }\n  return count;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACYA,IAAM,aAAa,eAAe;AAClC,IAAM,OAAO,CAAC,EAAE,QAAQ,IAAI,MAAM,QAAQ,IAAI,YAAY,CAAC,QAAQ,OAAO;AAE1E,IAAM,UADa,QAAQ,IAAI,cAAc,cACf;AAG9B,IAAM,SAAmC;CAAE,OAAO;CAAG,MAAM;CAAG,MAAM;CAAG,OAAO;AAAE;AAChF,IAAM,eAAe,OAAQ,QAAQ,IAAI,aAA0B,WAAW,OAAO;AAErF,SAAS,UAAU,OAA0B;CAC3C,OAAO,OAAO,UAAU;AAC1B;AAEA,SAAS,QAAQ,OAAiB,KAAa,MAAgC;CAC7E,IAAI,CAAC,UAAU,KAAK,GAAG;CACvB,MAAM,QAAQ;EAAE,qBAAI,IAAI,KAAK,EAAA,CAAE,YAAY;EAAG,GAAG;EAAM;EAAO;CAAI;CAElE,CADY,UAAU,UAAU,QAAQ,QAAQ,UAAU,SAAS,QAAQ,OAAO,QAAQ,IAAA,CACtF,KAAK,UAAU,KAAK,CAAC;AAC3B;;AAGA,SAAS,MAAM,OAAiB,KAAa,MAAyC;CACpF,IAAI,QAAQ;EACV,QAAQ,OAAO,KAAK,IAAI;EACxB,OAAO;CACT;CACA,OAAO,CAAC,UAAU,KAAK;AACzB;AAEA,IAAM,IACJ,QAAQ,SACJ;CACE,OAAO;CACP,MAAM;CACN,KAAK;CACL,OAAO;CACP,MAAM;CACN,SAAS;CACT,QAAQ;CACR,KAAK;CACL,OAAO;CACP,MAAM;AACR,IACA;CACE,OAAO;CACP,MAAM;CACN,KAAK;CACL,OAAO;CACP,MAAM;CACN,SAAS;CACT,QAAQ;CACR,KAAK;CACL,OAAO;CACP,MAAM;AACR;AAEN,IAAM,iBAAiB;CAAC;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;AAAG;AAExE,IAAM,UAAN,MAAc;CACZ,QAAgB;CAChB,UAAkB;CAClB,QAAuD;CAEvD,KAAK,UAAkB;EACrB,IAAI,KAAK,OAAO,cAAc,KAAK,KAAK;EACxC,KAAK,QAAQ;EACb,IAAI,MACF,QAAQ,IAAI,KAAK,UAAU;OACtB;GACL,QAAQ,OAAO,MAAM,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG;GACjE,QAAQ,OAAO,MAAM,WAAW;EAClC;CACF;CAEA,MAAM,KAAa;EACjB,KAAK,UAAU;EACf,IAAI,MAAM;GACR,QAAQ,IAAI,KAAK,KAAK;GACtB;EACF;EACA,KAAK,QAAQ;EACb,QAAQ,OAAO,MAAM,WAAW;EAChC,KAAK,OAAO;EACZ,KAAK,QAAQ,kBAAkB,KAAK,OAAO,GAAG,EAAE;CAClD;CAEA,KAAK,UAAkB;EACrB,IAAI,KAAK,OAAO,cAAc,KAAK,KAAK;EACxC,KAAK,QAAQ;EACb,IAAI,MAAM;GACR,QAAQ,IAAI,KAAK,UAAU;GAC3B;EACF;EACA,QAAQ,OAAO,MAAM,WAAW,EAAE,MAAM,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG;EAClE,QAAQ,OAAO,MAAM,WAAW;CAClC;CAEA,SAAiB;EACf,MAAM,IAAI,eAAe,KAAK,QAAQ,eAAe;EACrD,QAAQ,OAAO,MAAM,KAAK,EAAE,OAAO,IAAI,EAAE,MAAM,GAAG,KAAK,SAAS;EAChE,KAAK;CACP;AACF;AASA,IAAM,kBAAkB;AACxB,IAAI,iBAAiB;AACrB,IAAI,iBAAiB;AAErB,SAAS,eAAe,QAAqB,SAAS,IAAI,SAAS,MAAM;CACvE,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;EACtC,IAAI,gBAAgB;EACpB,IAAI,kBAAkB,iBAAiB;GACrC,iBAAiB;GACjB,QAAQ,OAAO,MAAM,GAAG,SAAS,EAAE,IAAI,KAAK,EAAE,MAAM,GAAG;GACvD;EACF;EAEA,MAAM,QAAQ,OAAO;EACrB,MAAM,OAAO,MAAM,OAAO,SAAS;EACnC,MAAM,YAAY,SAAS,KAAK,OAAO,SAAS;EAChD,MAAM,cAAc,SAAS,KAAK,OAAO,SAAS;EAElD,MAAM,OAAO,MAAM,SACf,GAAG,EAAE,MAAM,MAAM,OAAO,EAAE,UAC1B,GAAG,EAAE,QAAQ,MAAM,OAAO,EAAE;EAEhC,MAAM,QAAQ,MAAM,SAAS,GAAG,EAAE,KAAK,SAAS,EAAE,UAAU;EAE5D,QAAQ,OAAO,MAAM,GAAG,SAAS,YAAY,KAAK,GAAG,MAAM,GAAG;EAC9D;EAEA,IAAI,MAAM,OAAO,QACf,eAAe,MAAM,OAAO,SAAS,aAAa,KAAK;CAE3D;AACF;AAEA,IAAa,SAAS;CACpB,SAAS,IAAI,QAAQ;CAErB,aAAa;EACX,IAAI,MAAM,QAAQ,eAAe;GAAE,SAAS;GAAmB,SAAS,gBAAI;EAAQ,CAAC,GAAG;EACxF,QAAQ,IACN,KAAK,EAAE,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,GAAG,EAAE,IAAI,GAAG,gBAAI,UAAU,EAAE,MAAM,GACtF;CACF;CAEA,cAAc;EACZ,IAAI,MAAM,QAAQ,cAAc,GAAG;EACnC,KAAK,QAAQ,MAAM,2BAA2B;CAChD;CAEA,WAAW,IAAY;EACrB,IAAI,MAAM,QAAQ,eAAe,EAAE,aAAa,GAAG,CAAC,GAAG;EACvD,KAAK,QAAQ,KAAK,0BAA0B,EAAE,IAAI,GAAG,GAAG,KAAK,EAAE,OAAO;CACxE;CAEA,aAAa;EACX,IAAI,MAAM,QAAQ,aAAa,GAAG;EAClC,KAAK,QAAQ,MAAM,4BAA4B;CACjD;CAEA,UAAU,SAAiB,IAAY,UAAU,OAAO;EACtD,IAAI,MAAM,QAAQ,cAAc;GAAE;GAAS,aAAa;GAAI;EAAQ,CAAC,GAAG;EACxE,KAAK,QAAQ,KACX,UACI,uBAAuB,EAAE,IAAI,GAAG,GAAG,KAAK,EAAE,UAC1C,0BAA0B,EAAE,IAAI,GAAG,QAAQ,YAAY,GAAG,KAAK,EAAE,OACvE;CACF;CAEA,SAAS;EACP,IAAI,MAAM,SAAS,QAAQ,GAAG;EAC9B,MAAM,SAAS,WAAW;EAC1B,IAAI,CAAC,QAAQ,QAAQ;EAErB,QAAQ,IAAI,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,GAAG,EAAE,IAAI,GAAG,YAAY,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;EAC9F,iBAAiB;EACjB,iBAAiB;EACjB,eAAe,QAAQ,IAAI;CAC7B;CAEA,MAAM,MAAc,MAAM,OAAO;EAC/B,IAAI,MAAM,QAAQ,gBAAgB;GAAE;GAAM;EAAI,CAAC,GAAG;EAClD,QAAQ,IACN,KAAK,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,MAAM,EAAE,KAAK,mBAAmB,KAAK,QAAQ,EAAE,OAC1F;EACA,IAAI,KAAK,QAAQ,IAAI,GAAG,EAAE,IAAI,4CAA4C,EAAE,OAAO;EACnF,QAAQ,IAAI,EAAE;CAChB;CAEA,QAAQ,QAAgB,UAAkB,QAAgB,aAAsB;EAC9E,IAAI,MAAM,QAAQ,gBAAgB;GAAE;GAAQ,MAAM;GAAU;GAAQ;EAAY,CAAC,GAAG;EACpF,MAAM,QAAQ,UAAU,MAAM,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO,EAAE;EACjE,MAAM,sBAAK,IAAI,KAAK,EAAA,CAAE,mBAAmB;EACzC,MAAM,MAAM,eAAe,OAAO,IAAI,EAAE,MAAM,YAAY,IAAI,EAAE,UAAU;EAC1E,QAAQ,IACN,GAAG,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,SAAS,EAAE,QAAQ,KAChF;CACF;CAEA,MAAM,KAAa,MAAgC;EACjD,IAAI,MAAM,SAAS,KAAK,IAAI,GAAG;EAC/B,QAAQ,IAAI,GAAG,EAAE,KAAK,YAAY,MAAM,EAAE,OAAO;CACnD;CAEA,KAAK,KAAa,MAAgC;EAChD,IAAI,MAAM,QAAQ,KAAK,IAAI,GAAG;EAC9B,QAAQ,KAAK,GAAG,EAAE,OAAO,MAAM,MAAM,EAAE,OAAO;CAChD;CAEA,MAAM,KAAa,MAAgC;EACjD,IAAI,MAAM,SAAS,KAAK,IAAI,GAAG;EAC/B,QAAQ,MAAM,GAAG,EAAE,IAAI,MAAM,MAAM,EAAE,OAAO;CAC9C;AACF;AAEA,SAAS,YAAY,QAA6B;CAChD,IAAI,QAAQ;CACZ,KAAK,MAAM,KAAK,QAAQ;EACtB,IAAI,CAAC,EAAE,QAAQ;EACf,IAAI,EAAE,OAAO,SAAS,YAAY,EAAE,KAAK;CAC3C;CACA,OAAO;AACT"}

package/.docu/lib/{paths-BtOIPBQ9.js → paths-Bl2cdp9E.js}

@@ -7,7 +7,27 @@ import { readdir, rm, unlink } from "node:fs/promises";
 * PROJECT_ROOT: Where the user's project lives (docs/, docu.json)
 */
 var FRAMEWORK_ROOT = resolve(import.meta.dirname, "../..");
-var PROJECT_ROOT = process.cwd();
+/**
+* Find the project root by walking up from cwd until docu.json is found.
+* Falls back to cwd when not found (tests, ad-hoc scripts). Bun 1.4
+* `run --parallel --filter` may change cwd per workspace task, so a bare
+* process.cwd() can point at the wrong package.
+*/
+function findProjectRoot() {
+	let dir = process.cwd();
+	for (let i = 0; i < 6; i++) {
+		try {
+			if (existsSync(join(dir, "docu.json"))) return dir;
+		} catch {
+			break;
+		}
+		const parent = resolve(dir, "..");
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return process.cwd();
+}
+var PROJECT_ROOT = findProjectRoot();
 join(FRAMEWORK_ROOT, ".docu/pages");
 var STYLES_DIR = join(FRAMEWORK_ROOT, ".docu/styles");
 var nodeDir = join(FRAMEWORK_ROOT, ".docu/node");
@@ -19,6 +39,10 @@ var CACHE_FILE = join(PROJECT_ROOT, ".docu/build-cache.json");
 var DOCS_DIR = join(PROJECT_ROOT, "docs");
 var DOCS_ASSETS_DIR = join(PROJECT_ROOT, "docs/assets");
 var DOCU_CONFIG_PATH = join(PROJECT_ROOT, "docu.json");
+/** Resolve a project-relative file against the discovered PROJECT_ROOT. */
+function resolveProjectFile(...segments) {
+	return join(PROJECT_ROOT, ...segments);
+}
 var _config = null;
 /** Clean stale client bundles from a previous build. */
 async function cleanOldBundles(preserve) {
@@ -47,6 +71,6 @@ function loadDocuConfig() {
 	return _config;
 }
 //#endregion
-export { DOCS_DIR as a, PROJECT_ROOT as c, loadDocuConfig as d, DOCS_ASSETS_DIR as i, STYLES_DIR as l, CACHE_FILE as n, FRAMEWORK_ROOT as o, DIST_DIR as r, LIB_DIR as s, ASSETS_DIR as t, cleanOldBundles as u };
+export { DOCS_DIR as a, PROJECT_ROOT as c, loadDocuConfig as d, resolveProjectFile as f, DOCS_ASSETS_DIR as i, STYLES_DIR as l, CACHE_FILE as n, FRAMEWORK_ROOT as o, DIST_DIR as r, LIB_DIR as s, ASSETS_DIR as t, cleanOldBundles as u };
 
-//# sourceMappingURL=paths-BtOIPBQ9.js.map
+//# sourceMappingURL=paths-Bl2cdp9E.js.map

package/.docu/lib/paths-Bl2cdp9E.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-Bl2cdp9E.js","names":[],"sources":["../node/paths.ts"],"sourcesContent":["import { resolve, join } from \"node:path\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { readdir, rm, unlink } from \"node:fs/promises\";\nimport type { DocuConfig } from \"./types\";\n\n/**\n * FRAMEWORK_ROOT: Where the package code lives (.docu/components, .docu/pages, .docu/styles, .docu/node)\n * PROJECT_ROOT: Where the user's project lives (docs/, docu.json)\n */\n\n// .docu/node/paths.ts → package root is 2 levels up\nexport const FRAMEWORK_ROOT = resolve(import.meta.dirname, \"../..\");\n\n/**\n * Find the project root by walking up from cwd until docu.json is found.\n * Falls back to cwd when not found (tests, ad-hoc scripts). Bun 1.4\n * `run --parallel --filter` may change cwd per workspace task, so a bare\n * process.cwd() can point at the wrong package.\n */\nfunction findProjectRoot(): string {\n  let dir = process.cwd();\n  for (let i = 0; i < 6; i++) {\n    try {\n      if (existsSync(join(dir, \"docu.json\"))) return dir;\n    } catch {\n      break;\n    }\n    const parent = resolve(dir, \"..\");\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return process.cwd();\n}\nexport const PROJECT_ROOT = findProjectRoot();\n\n// Framework paths (internal)\nexport const PAGES_DIR = join(FRAMEWORK_ROOT, \".docu/pages\");\nexport const STYLES_DIR = join(FRAMEWORK_ROOT, \".docu/styles\");\nconst nodeDir = join(FRAMEWORK_ROOT, \".docu/node\");\nconst libDir = join(FRAMEWORK_ROOT, \".docu/lib\");\nexport const LIB_DIR = existsSync(nodeDir) ? nodeDir : libDir;\n\n// Build output (user project)\nexport const DIST_DIR = join(PROJECT_ROOT, \".docu/dist\");\nexport const ASSETS_DIR = join(DIST_DIR, \"assets\");\nexport const CACHE_FILE = join(PROJECT_ROOT, \".docu/build-cache.json\");\n\n// Project paths (user content)\nexport const DOCS_DIR = join(PROJECT_ROOT, \"docs\");\nexport const DOCS_ASSETS_DIR = join(PROJECT_ROOT, \"docs/assets\");\nexport const DOCU_CONFIG_PATH = join(PROJECT_ROOT, \"docu.json\");\n\n/** Resolve a project-relative file against the discovered PROJECT_ROOT. */\nexport function resolveProjectFile(...segments: string[]): string {\n  return join(PROJECT_ROOT, ...segments);\n}\n\n// Config singleton\nlet _config: DocuConfig | null = null;\n\n/** Clean stale client bundles from a previous build. */\nexport async function cleanOldBundles(preserve?: Set<string>) {\n  try {\n    const files = await readdir(ASSETS_DIR);\n    for (const file of files) {\n      if (preserve?.has(file)) continue;\n      if (file.startsWith(\"client.\") || file.startsWith(\"client-\")) {\n        await unlink(join(ASSETS_DIR, file));\n      }\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      console.error(\"Failed to clean old bundles:\", (err as Error).message);\n    }\n  }\n  try {\n    await rm(join(ASSETS_DIR, \"chunks\"), { recursive: true, force: true });\n  } catch (err) {\n    // chunks dir may not exist, or permission error — log to avoid silent failure\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      console.warn(\"[flame] Failed to clean chunks dir:\", (err as Error).message);\n    }\n  }\n}\n\nexport function loadDocuConfig(): DocuConfig {\n  if (_config) return _config;\n  if (!existsSync(DOCU_CONFIG_PATH)) {\n    throw new Error(`docu.json not found at ${DOCU_CONFIG_PATH}`);\n  }\n  _config = JSON.parse(readFileSync(DOCU_CONFIG_PATH, \"utf-8\"));\n  return _config!;\n}\n"],"mappings":";;;;;;;;AAWA,IAAa,iBAAiB,QAAQ,YAAY,SAAS,OAAO;;;;;;;AAQlE,SAAS,kBAA0B;CACjC,IAAI,MAAM,QAAQ,IAAI;CACtB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,IAAI;GACF,IAAI,WAAW,KAAK,KAAK,WAAW,CAAC,GAAG,OAAO;EACjD,QAAQ;GACN;EACF;EACA,MAAM,SAAS,QAAQ,KAAK,IAAI;EAChC,IAAI,WAAW,KAAK;EACpB,MAAM;CACR;CACA,OAAO,QAAQ,IAAI;AACrB;AACA,IAAa,eAAe,gBAAgB;AAGnB,KAAK,gBAAgB,aAAa;AAC3D,IAAa,aAAa,KAAK,gBAAgB,cAAc;AAC7D,IAAM,UAAU,KAAK,gBAAgB,YAAY;AACjD,IAAM,SAAS,KAAK,gBAAgB,WAAW;AAC/C,IAAa,UAAU,WAAW,OAAO,IAAI,UAAU;AAGvD,IAAa,WAAW,KAAK,cAAc,YAAY;AACvD,IAAa,aAAa,KAAK,UAAU,QAAQ;AACjD,IAAa,aAAa,KAAK,cAAc,wBAAwB;AAGrE,IAAa,WAAW,KAAK,cAAc,MAAM;AACjD,IAAa,kBAAkB,KAAK,cAAc,aAAa;AAC/D,IAAa,mBAAmB,KAAK,cAAc,WAAW;;AAG9D,SAAgB,mBAAmB,GAAG,UAA4B;CAChE,OAAO,KAAK,cAAc,GAAG,QAAQ;AACvC;AAGA,IAAI,UAA6B;;AAGjC,eAAsB,gBAAgB,UAAwB;CAC5D,IAAI;EACF,MAAM,QAAQ,MAAM,QAAQ,UAAU;EACtC,KAAK,MAAM,QAAQ,OAAO;GACxB,IAAI,UAAU,IAAI,IAAI,GAAG;GACzB,IAAI,KAAK,WAAW,SAAS,KAAK,KAAK,WAAW,SAAS,GACzD,MAAM,OAAO,KAAK,YAAY,IAAI,CAAC;EAEvC;CACF,SAAS,KAAK;EACZ,IAAK,IAA8B,SAAS,UAC1C,QAAQ,MAAM,gCAAiC,IAAc,OAAO;CAExE;CACA,IAAI;EACF,MAAM,GAAG,KAAK,YAAY,QAAQ,GAAG;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;CACvE,SAAS,KAAK;EAEZ,IAAK,IAA8B,SAAS,UAC1C,QAAQ,KAAK,uCAAwC,IAAc,OAAO;CAE9E;AACF;AAEA,SAAgB,iBAA6B;CAC3C,IAAI,SAAS,OAAO;CACpB,IAAI,CAAC,WAAW,gBAAgB,GAC9B,MAAM,IAAI,MAAM,0BAA0B,kBAAkB;CAE9D,UAAU,KAAK,MAAM,aAAa,kBAAkB,OAAO,CAAC;CAC5D,OAAO;AACT"}

package/.docu/lib/preview.deno.js

@@ -1,5 +1,5 @@
 import { t as denoAdapter } from "./deno-DmEaKggj.js";
-import { t as runPreview } from "./preview.impl-CXJS2tQS.js";
+import { t as runPreview } from "./preview.impl-CnsbLmDA.js";
 //#region .docu/node/preview.deno.ts
 await runPreview(denoAdapter);
 //#endregion

package/.docu/lib/{preview.impl-CXJS2tQS.js → preview.impl-CnsbLmDA.js}

@@ -1,6 +1,6 @@
-import { r as DIST_DIR } from "./paths-BtOIPBQ9.js";
+import { r as DIST_DIR } from "./paths-Bl2cdp9E.js";
 import { c as SECURITY_HEADERS, f as injectNonce, i as getContentType, l as cspHeader, u as generateNonce } from "./utils-DA17MyQG.js";
-import { t as logger } from "./logger-CycvLCrQ.js";
+import { t as logger } from "./logger-CQyNTE6L.js";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 import { readFile } from "node:fs/promises";
@@ -74,4 +74,4 @@ async function runPreview(adapter) {
 //#endregion
 export { runPreview as t };
 
-//# sourceMappingURL=preview.impl-CXJS2tQS.js.map
+//# sourceMappingURL=preview.impl-CnsbLmDA.js.map

package/.docu/lib/{preview.impl-CXJS2tQS.js.map → preview.impl-CnsbLmDA.js.map}

@@ -1 +1 @@
-{"version":3,"file":"preview.impl-CXJS2tQS.js","names":[],"sources":["../node/preview.impl.ts"],"sourcesContent":["/**\n * Runtime-neutral preview server — mirror of `preview.ts` (Bun-only,\n * protected) driven by a `RuntimeAdapter` and `node:fs` file reads.\n */\n\nimport { existsSync, statSync, readFileSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { RuntimeAdapter, ServerHandle } from \"./runtime\";\nimport { logger } from \"./logger\";\nimport { DIST_DIR } from \"./paths\";\nimport { getContentType } from \"./utils\";\nimport { SECURITY_HEADERS, generateNonce, cspHeader, injectNonce } from \"./security\";\n\nfunction resolveFile(pathname: string): string | null {\n  const path = pathname.slice(1);\n  const isWithinDist = (p: string) => p === DIST_DIR || p.startsWith(DIST_DIR + \"/\");\n\n  if (!path.includes(\".\")) {\n    const withIndex = resolve(DIST_DIR, path, \"index.html\");\n    if (isWithinDist(withIndex) && existsSync(withIndex)) return withIndex;\n    const withHtml = resolve(DIST_DIR, path + \".html\");\n    if (isWithinDist(withHtml) && existsSync(withHtml)) return withHtml;\n  }\n\n  const exact = resolve(DIST_DIR, path);\n  if (!isWithinDist(exact)) return null;\n  try {\n    if (statSync(exact).isFile()) return exact;\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n  }\n  return null;\n}\n\nexport async function runPreview(adapter: RuntimeAdapter): Promise<ServerHandle | null> {\n  const PORT = parseInt(process.env.PORT || \"4173\", 10);\n\n  logger.buildStart();\n\n  if (!existsSync(DIST_DIR)) {\n    logger.spinner.start(\"Checking build output...\");\n    logger.spinner.info(\"dist not found. Run \\x1b[1mflame build\\x1b[0m first.\");\n    process.exit(0);\n  }\n\n  const notFoundPath = resolve(DIST_DIR, \"404.html\");\n\n  const handle = await adapter.serve(\n    async (req) => {\n      const url = new URL(req.url);\n      const pathname = decodeURIComponent(url.pathname);\n\n      const filePath = resolveFile(pathname);\n\n      if (filePath) {\n        const contentType = getContentType(filePath);\n        if (contentType === \"text/html\") {\n          const nonce = generateNonce();\n          const html = await readFile(filePath, \"utf-8\");\n          const modified = injectNonce(html, nonce);\n          return new Response(modified, {\n            headers: {\n              \"Content-Type\": \"text/html\",\n              ...SECURITY_HEADERS,\n              \"Content-Security-Policy\": cspHeader(nonce),\n            },\n          });\n        }\n        return new Response(readFileSync(filePath), {\n          headers: { \"Content-Type\": contentType },\n        });\n      }\n\n      if (existsSync(notFoundPath)) {\n        const nonce = generateNonce();\n        const html = await readFile(notFoundPath, \"utf-8\");\n        const modified = injectNonce(html, nonce);\n        return new Response(modified, {\n          status: 404,\n          headers: {\n            \"Content-Type\": \"text/html\",\n            ...SECURITY_HEADERS,\n            \"Content-Security-Policy\": cspHeader(nonce),\n          },\n        });\n      }\n\n      return new Response(\"404 - Not Found\", { status: 404 });\n    },\n    { port: PORT }\n  );\n\n  logger.ready(handle.port);\n  return handle;\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAS,YAAY,UAAiC;CACpD,MAAM,OAAO,SAAS,MAAM,CAAC;CAC7B,MAAM,gBAAgB,MAAc,MAAM,YAAY,EAAE,WAAW,WAAW,GAAG;CAEjF,IAAI,CAAC,KAAK,SAAS,GAAG,GAAG;EACvB,MAAM,YAAY,QAAQ,UAAU,MAAM,YAAY;EACtD,IAAI,aAAa,SAAS,KAAK,WAAW,SAAS,GAAG,OAAO;EAC7D,MAAM,WAAW,QAAQ,UAAU,OAAO,OAAO;EACjD,IAAI,aAAa,QAAQ,KAAK,WAAW,QAAQ,GAAG,OAAO;CAC7D;CAEA,MAAM,QAAQ,QAAQ,UAAU,IAAI;CACpC,IAAI,CAAC,aAAa,KAAK,GAAG,OAAO;CACjC,IAAI;EACF,IAAI,SAAS,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO;CACvC,SAAS,KAAK;EACZ,IAAK,IAA8B,SAAS,UAAU,MAAM;CAC9D;CACA,OAAO;AACT;AAEA,eAAsB,WAAW,SAAuD;CACtF,MAAM,OAAO,SAAS,QAAQ,IAAI,QAAQ,QAAQ,EAAE;CAEpD,OAAO,WAAW;CAElB,IAAI,CAAC,WAAW,QAAQ,GAAG;EACzB,OAAO,QAAQ,MAAM,0BAA0B;EAC/C,OAAO,QAAQ,KAAK,sDAAsD;EAC1E,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,eAAe,QAAQ,UAAU,UAAU;CAEjD,MAAM,SAAS,MAAM,QAAQ,MAC3B,OAAO,QAAQ;EACb,MAAM,MAAM,IAAI,IAAI,IAAI,GAAG;EAG3B,MAAM,WAAW,YAFA,mBAAmB,IAAI,QAEX,CAAQ;EAErC,IAAI,UAAU;GACZ,MAAM,cAAc,eAAe,QAAQ;GAC3C,IAAI,gBAAgB,aAAa;IAC/B,MAAM,QAAQ,cAAc;IAC5B,MAAM,OAAO,MAAM,SAAS,UAAU,OAAO;IAC7C,MAAM,WAAW,YAAY,MAAM,KAAK;IACxC,OAAO,IAAI,SAAS,UAAU,EAC5B,SAAS;KACP,gBAAgB;KAChB,GAAG;KACH,2BAA2B,UAAU,KAAK;IAC5C,EACF,CAAC;GACH;GACA,OAAO,IAAI,SAAS,aAAa,QAAQ,GAAG,EAC1C,SAAS,EAAE,gBAAgB,YAAY,EACzC,CAAC;EACH;EAEA,IAAI,WAAW,YAAY,GAAG;GAC5B,MAAM,QAAQ,cAAc;GAC5B,MAAM,OAAO,MAAM,SAAS,cAAc,OAAO;GACjD,MAAM,WAAW,YAAY,MAAM,KAAK;GACxC,OAAO,IAAI,SAAS,UAAU;IAC5B,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,GAAG;KACH,2BAA2B,UAAU,KAAK;IAC5C;GACF,CAAC;EACH;EAEA,OAAO,IAAI,SAAS,mBAAmB,EAAE,QAAQ,IAAI,CAAC;CACxD,GACA,EAAE,MAAM,KAAK,CACf;CAEA,OAAO,MAAM,OAAO,IAAI;CACxB,OAAO;AACT"}
+{"version":3,"file":"preview.impl-CnsbLmDA.js","names":[],"sources":["../node/preview.impl.ts"],"sourcesContent":["/**\n * Runtime-neutral preview server — mirror of `preview.ts` (Bun-only,\n * protected) driven by a `RuntimeAdapter` and `node:fs` file reads.\n */\n\nimport { existsSync, statSync, readFileSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { RuntimeAdapter, ServerHandle } from \"./runtime\";\nimport { logger } from \"./logger\";\nimport { DIST_DIR } from \"./paths\";\nimport { getContentType } from \"./utils\";\nimport { SECURITY_HEADERS, generateNonce, cspHeader, injectNonce } from \"./security\";\n\nfunction resolveFile(pathname: string): string | null {\n  const path = pathname.slice(1);\n  const isWithinDist = (p: string) => p === DIST_DIR || p.startsWith(DIST_DIR + \"/\");\n\n  if (!path.includes(\".\")) {\n    const withIndex = resolve(DIST_DIR, path, \"index.html\");\n    if (isWithinDist(withIndex) && existsSync(withIndex)) return withIndex;\n    const withHtml = resolve(DIST_DIR, path + \".html\");\n    if (isWithinDist(withHtml) && existsSync(withHtml)) return withHtml;\n  }\n\n  const exact = resolve(DIST_DIR, path);\n  if (!isWithinDist(exact)) return null;\n  try {\n    if (statSync(exact).isFile()) return exact;\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n  }\n  return null;\n}\n\nexport async function runPreview(adapter: RuntimeAdapter): Promise<ServerHandle | null> {\n  const PORT = parseInt(process.env.PORT || \"4173\", 10);\n\n  logger.buildStart();\n\n  if (!existsSync(DIST_DIR)) {\n    logger.spinner.start(\"Checking build output...\");\n    logger.spinner.info(\"dist not found. Run \\x1b[1mflame build\\x1b[0m first.\");\n    process.exit(0);\n  }\n\n  const notFoundPath = resolve(DIST_DIR, \"404.html\");\n\n  const handle = await adapter.serve(\n    async (req) => {\n      const url = new URL(req.url);\n      const pathname = decodeURIComponent(url.pathname);\n\n      const filePath = resolveFile(pathname);\n\n      if (filePath) {\n        const contentType = getContentType(filePath);\n        if (contentType === \"text/html\") {\n          const nonce = generateNonce();\n          const html = await readFile(filePath, \"utf-8\");\n          const modified = injectNonce(html, nonce);\n          return new Response(modified, {\n            headers: {\n              \"Content-Type\": \"text/html\",\n              ...SECURITY_HEADERS,\n              \"Content-Security-Policy\": cspHeader(nonce),\n            },\n          });\n        }\n        return new Response(readFileSync(filePath), {\n          headers: { \"Content-Type\": contentType },\n        });\n      }\n\n      if (existsSync(notFoundPath)) {\n        const nonce = generateNonce();\n        const html = await readFile(notFoundPath, \"utf-8\");\n        const modified = injectNonce(html, nonce);\n        return new Response(modified, {\n          status: 404,\n          headers: {\n            \"Content-Type\": \"text/html\",\n            ...SECURITY_HEADERS,\n            \"Content-Security-Policy\": cspHeader(nonce),\n          },\n        });\n      }\n\n      return new Response(\"404 - Not Found\", { status: 404 });\n    },\n    { port: PORT }\n  );\n\n  logger.ready(handle.port);\n  return handle;\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAS,YAAY,UAAiC;CACpD,MAAM,OAAO,SAAS,MAAM,CAAC;CAC7B,MAAM,gBAAgB,MAAc,MAAM,YAAY,EAAE,WAAW,WAAW,GAAG;CAEjF,IAAI,CAAC,KAAK,SAAS,GAAG,GAAG;EACvB,MAAM,YAAY,QAAQ,UAAU,MAAM,YAAY;EACtD,IAAI,aAAa,SAAS,KAAK,WAAW,SAAS,GAAG,OAAO;EAC7D,MAAM,WAAW,QAAQ,UAAU,OAAO,OAAO;EACjD,IAAI,aAAa,QAAQ,KAAK,WAAW,QAAQ,GAAG,OAAO;CAC7D;CAEA,MAAM,QAAQ,QAAQ,UAAU,IAAI;CACpC,IAAI,CAAC,aAAa,KAAK,GAAG,OAAO;CACjC,IAAI;EACF,IAAI,SAAS,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO;CACvC,SAAS,KAAK;EACZ,IAAK,IAA8B,SAAS,UAAU,MAAM;CAC9D;CACA,OAAO;AACT;AAEA,eAAsB,WAAW,SAAuD;CACtF,MAAM,OAAO,SAAS,QAAQ,IAAI,QAAQ,QAAQ,EAAE;CAEpD,OAAO,WAAW;CAElB,IAAI,CAAC,WAAW,QAAQ,GAAG;EACzB,OAAO,QAAQ,MAAM,0BAA0B;EAC/C,OAAO,QAAQ,KAAK,sDAAsD;EAC1E,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,eAAe,QAAQ,UAAU,UAAU;CAEjD,MAAM,SAAS,MAAM,QAAQ,MAC3B,OAAO,QAAQ;EACb,MAAM,MAAM,IAAI,IAAI,IAAI,GAAG;EAG3B,MAAM,WAAW,YAFA,mBAAmB,IAAI,QAEX,CAAQ;EAErC,IAAI,UAAU;GACZ,MAAM,cAAc,eAAe,QAAQ;GAC3C,IAAI,gBAAgB,aAAa;IAC/B,MAAM,QAAQ,cAAc;IAC5B,MAAM,OAAO,MAAM,SAAS,UAAU,OAAO;IAC7C,MAAM,WAAW,YAAY,MAAM,KAAK;IACxC,OAAO,IAAI,SAAS,UAAU,EAC5B,SAAS;KACP,gBAAgB;KAChB,GAAG;KACH,2BAA2B,UAAU,KAAK;IAC5C,EACF,CAAC;GACH;GACA,OAAO,IAAI,SAAS,aAAa,QAAQ,GAAG,EAC1C,SAAS,EAAE,gBAAgB,YAAY,EACzC,CAAC;EACH;EAEA,IAAI,WAAW,YAAY,GAAG;GAC5B,MAAM,QAAQ,cAAc;GAC5B,MAAM,OAAO,MAAM,SAAS,cAAc,OAAO;GACjD,MAAM,WAAW,YAAY,MAAM,KAAK;GACxC,OAAO,IAAI,SAAS,UAAU;IAC5B,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,GAAG;KACH,2BAA2B,UAAU,KAAK;IAC5C;GACF,CAAC;EACH;EAEA,OAAO,IAAI,SAAS,mBAAmB,EAAE,QAAQ,IAAI,CAAC;CACxD,GACA,EAAE,MAAM,KAAK,CACf;CAEA,OAAO,MAAM,OAAO,IAAI;CACxB,OAAO;AACT"}

package/.docu/lib/preview.node.js

@@ -1,5 +1,5 @@
 import { t as nodeAdapter } from "./node-DPTySdwG.js";
-import { t as runPreview } from "./preview.impl-CXJS2tQS.js";
+import { t as runPreview } from "./preview.impl-CnsbLmDA.js";
 //#region .docu/node/preview.node.ts
 await runPreview(nodeAdapter);
 //#endregion

package/.docu/lib/server.deno.js

@@ -1,5 +1,5 @@
 import { t as denoAdapter } from "./deno-DmEaKggj.js";
-import { t as runServer } from "./server.impl-CJuWimfN.js";
+import { t as runServer } from "./server.impl-CXTzYqbF.js";
 //#region .docu/node/server.deno.ts
 await runServer(denoAdapter);
 //#endregion

package/.docu/lib/{server.impl-CJuWimfN.js → server.impl-CXTzYqbF.js}

@@ -1,7 +1,7 @@
-import { a as DOCS_DIR, c as PROJECT_ROOT, d as loadDocuConfig, r as DIST_DIR } from "./paths-BtOIPBQ9.js";
-import { S as loadPlugins, a as IndexPage, b as computeInlineThemeCss, c as captureException, d as compileMdx, i as DocsLayout, l as initSentry, n as hmrScript, o as NotFoundPage, p as frontmatterField, r as htmlShell, s as DocsPage, t as errorHtml, u as generateSearchIndex, x as BuildPluginBuilder, y as buildClientBundle } from "./html.shared-DSn-7_6t.js";
+import { a as DOCS_DIR, c as PROJECT_ROOT, d as loadDocuConfig, r as DIST_DIR } from "./paths-Bl2cdp9E.js";
+import { D as loadPlugins, E as BuildPluginBuilder, a as IndexPage, b as buildClientBundle, c as captureException, f as compileMdx, i as DocsLayout, l as initSentry, m as frontmatterField, n as hmrScript, o as NotFoundPage, r as htmlShell, s as DocsPage, t as errorHtml, u as generateSearchIndex, x as computeInlineThemeCss } from "./html.shared-FwgbE1WG.js";
 import { c as SECURITY_HEADERS, d as htmlResponse, g as wrapPluginResponse, i as getContentType, m as isSlugSafe, p as isPathSafe, s as stripDocsHtmlSuffix, u as generateNonce } from "./utils-DA17MyQG.js";
-import { t as logger } from "./logger-CycvLCrQ.js";
+import { t as logger } from "./logger-CQyNTE6L.js";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, statSync, watch } from "node:fs";
 import { dirname, join, resolve } from "node:path";
@@ -355,4 +355,4 @@ async function runServer(adapter) {
 //#endregion
 export { runServer as t };
 
-//# sourceMappingURL=server.impl-CJuWimfN.js.map
+//# sourceMappingURL=server.impl-CXTzYqbF.js.map

package/.docu/lib/{server.impl-CJuWimfN.js.map → server.impl-CXTzYqbF.js.map}

@@ -1 +1 @@
-{"version":3,"file":"server.impl-CJuWimfN.js","names":[],"sources":["../node/server-routes.ts","../node/server.impl.ts"],"sourcesContent":["import { readFile, stat } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { readFileSync, statSync } from \"node:fs\";\nimport React, { type ReactNode } from \"react\";\nimport { renderToString } from \"react-dom/server\";\nimport { compileMdx, frontmatterField } from \"./mdx\";\nimport { getContentType } from \"./utils\";\nimport { DOCS_DIR, DIST_DIR, PROJECT_ROOT } from \"./paths\";\nimport { BuildPluginBuilder } from \"./plugin-builder\";\nimport type { PageContext } from \"./plugin\";\nimport type { DocuConfig, TocItem } from \"./types\";\nimport DocsPage from \"../pages/docs/[[...slug]]\";\nimport NotFoundPage from \"../pages/404\";\nimport IndexPage from \"../pages/index\";\nimport { DocsLayout } from \"../components/DocsLayout\";\nimport { generateNonce, isPathSafe, isSlugSafe, htmlResponse, SECURITY_HEADERS } from \"./security\";\nimport { htmlShell as createHtmlShell, hmrScript, errorHtml } from \"./html.shared\";\n\nexport interface ServerState {\n  docuConfig: DocuConfig;\n  assetManifest: { css: string; js: string };\n  inlineThemeCss?: string;\n  builder: BuildPluginBuilder | null;\n}\n\nfunction createHtmlResponse(\n  title: string,\n  description: string,\n  body: string,\n  status: number,\n  state: ServerState,\n  depth = 0\n): Response {\n  const nonce = generateNonce();\n  const favicon = state.docuConfig.meta?.favicon || \"/favicon.ico\";\n  const html = createHtmlShell({\n    title,\n    description,\n    body,\n    favicon,\n    css: state.assetManifest.css,\n    js: state.assetManifest.js,\n    nonce,\n    extraScripts: hmrScript(nonce),\n    themeCss: state.inlineThemeCss,\n    depth,\n    // 404 pages can be requested at arbitrary depths (e.g. a noLink section\n    // path typed in the address bar) — relative asset paths would resolve\n    // against the wrong directory and break CSS/JS.\n    absoluteAssets: status === 404,\n  });\n  /** Dev-only: serves compiledSource → MDXRemote eval path (no CSP in production). */\n  return htmlResponse(html, nonce, status, true);\n}\n\n// Dev-only memo: compileMdx per request is ~70ms; repeat navigations with\n// an unchanged file (same mtime) reuse the compiled result. The dev server\n// has no other per-page cache — without this every navigation re-parses MDX.\n// ponytail: unbounded Map is fine — docs sites have a handful of pages; cap\n// with an LRU only if a project exceeds thousands of routes.\nconst docsCache = new Map<\n  string,\n  { mtimeMs: number; doc: NonNullable<Awaited<ReturnType<typeof getDocsForSlug>>> }\n>();\n\nasync function getDocsForSlug(\n  slug: string,\n  state: ServerState\n): Promise<{\n  content: ReactNode;\n  compiledSource: string;\n  frontmatter: Record<string, unknown>;\n  tocs: TocItem[];\n  filePath: string;\n  resolvedContent: string;\n} | null> {\n  if (!isSlugSafe(slug, DOCS_DIR)) return null;\n\n  const paths = [\n    resolve(DOCS_DIR, slug, \"index.mdx\"),\n    resolve(DOCS_DIR, `${slug}.mdx`),\n    resolve(DOCS_DIR, slug, \"index.md\"),\n    resolve(DOCS_DIR, `${slug}.md`),\n  ];\n\n  const resolvedDocsDir = resolve(DOCS_DIR);\n  let filePath: string | null = null;\n  let raw: string | null = null;\n  for (const p of paths) {\n    const resolvedCandidate = resolve(p);\n    if (\n      resolvedCandidate !== resolvedDocsDir &&\n      !resolvedCandidate.startsWith(resolvedDocsDir + \"/\")\n    ) {\n      continue;\n    }\n    try {\n      raw = await readFile(resolvedCandidate, \"utf-8\");\n      filePath = resolvedCandidate;\n      break;\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n    }\n  }\n  if (!filePath || !raw) return null;\n\n  const relPath = filePath.replace(PROJECT_ROOT + \"/\", \"\");\n\n  const mtimeMs = (await stat(filePath)).mtimeMs;\n  const cached = docsCache.get(relPath);\n  if (cached && cached.mtimeMs === mtimeMs) {\n    return cached.doc;\n  }\n\n  let content = raw;\n  if (state.builder) {\n    const transformed = await state.builder.runOnLoad(relPath, content);\n    if (transformed?.contents) {\n      content = transformed.contents;\n    }\n  }\n\n  const remarkPlugins = state.builder?.collectRemarkPlugins();\n  const rehypePlugins = state.builder?.collectRehypePlugins();\n  const result = await compileMdx(content, relPath, undefined, remarkPlugins, rehypePlugins);\n\n  let frontmatter = result.frontmatter as Record<string, unknown>;\n  if (state.builder) {\n    frontmatter = await state.builder.runTransformFrontmatterChain(frontmatter, {\n      slug: slug || \"/\",\n      filePath: relPath,\n      content,\n    });\n  }\n\n  const doc = {\n    content: result.content,\n    compiledSource: result.compiledSource,\n    frontmatter,\n    tocs: result.tocs,\n    filePath: relPath,\n    resolvedContent: content,\n  };\n  docsCache.set(relPath, { mtimeMs, doc });\n  return doc;\n}\n\nasync function renderDocsServerPage(\n  doc: NonNullable<Awaited<ReturnType<typeof getDocsForSlug>>>,\n  slug: string[],\n  pathname: string,\n  state: ServerState\n): Promise<Response> {\n  const title = frontmatterField(doc.frontmatter, \"title\") || slug.join(\"/\") || \"Docs\";\n  const description = frontmatterField(doc.frontmatter, \"description\");\n\n  const page = React.createElement(\n    DocsLayout,\n    { repoUrl: state.docuConfig.repo?.url, pathname },\n    React.createElement(DocsPage, {\n      slug,\n      title,\n      description,\n      date: frontmatterField(doc.frontmatter, \"date\") || undefined,\n      // Same root-relative SSR as build — see build.ts.\n      content: renderToString(doc.content),\n      tocs: doc.tocs,\n      filePath: doc.filePath,\n      repoUrl: state.docuConfig.repo?.url,\n      compiledSource: doc.compiledSource,\n    })\n  );\n\n  const body = renderToString(page);\n\n  // Match build.ts depth calculation: slug.split(\"/\").length, fallback to 1 for empty\n  const depth = slug.length || 1;\n\n  if (state.builder) {\n    const ctx: PageContext = {\n      slug: slug.join(\"/\") || \"/\",\n      filePath: doc.filePath,\n      frontmatter: doc.frontmatter,\n      content: doc.resolvedContent,\n      config: state.docuConfig,\n    };\n    const headExtra = state.builder.collectHead(ctx);\n    const bodyExtra = state.builder.collectBody(ctx);\n    const nonce = generateNonce();\n    const favicon = state.docuConfig.meta?.favicon || \"/favicon.ico\";\n    let html = createHtmlShell({\n      title,\n      description,\n      body,\n      favicon,\n      css: state.assetManifest.css,\n      js: state.assetManifest.js,\n      nonce,\n      extraScripts: hmrScript(nonce),\n      themeCss: state.inlineThemeCss,\n      headExtra,\n      bodyExtra,\n      depth,\n    });\n    html = await state.builder.runTransformHtmlChain(html, ctx);\n    /** Dev-only: serves compiledSource → MDXRemote eval path (no CSP in production). */\n    return htmlResponse(html, nonce, 200, true);\n  }\n\n  return createHtmlResponse(title, description, body, 200, state, depth);\n}\n\nfunction renderPage(\n  Component: React.ComponentType<Record<string, unknown>>,\n  title: string,\n  description: string,\n  status: number,\n  state: ServerState,\n  props: Record<string, unknown> = {},\n  depth = 0\n): Response {\n  const page = React.createElement(\n    DocsLayout,\n    { repoUrl: state.docuConfig.repo?.url, pathname: \"/docs\" },\n    React.createElement(Component, props)\n  );\n  const body = renderToString(page);\n  return createHtmlResponse(title, description, body, status, state, depth);\n}\n\nexport async function handleDocsIndex(state: ServerState): Promise<Response> {\n  const doc = await getDocsForSlug(\"\", state);\n  if (!doc) return renderPage(NotFoundPage, \"404 - Not Found\", \"\", 404, state, {}, 1);\n  return renderDocsServerPage(doc, [], \"/docs\", state);\n}\n\nexport async function handleDocsRoute(slug: string[], state: ServerState): Promise<Response> {\n  const path = slug.join(\"/\");\n  const doc = await getDocsForSlug(path, state);\n  if (!doc)\n    return renderPage(NotFoundPage, \"404 - Not Found\", \"\", 404, state, {}, slug.length || 1);\n  return renderDocsServerPage(doc, slug, `/docs/${path}`, state);\n}\n\nexport function handleIndex(state: ServerState): Response {\n  const page = React.createElement(IndexPage);\n  const body = renderToString(page);\n  return createHtmlResponse(\n    state.docuConfig.meta?.title || \"DocuBook\",\n    state.docuConfig.meta?.description || \"\",\n    body,\n    200,\n    state\n  );\n}\n\nexport function handleNotFound(state: ServerState, depth = 0): Response {\n  return renderPage(NotFoundPage, \"404 - Not Found\", \"\", 404, state, {}, depth);\n}\n\nexport function serveStatic(pathname: string): Response | null {\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(pathname);\n  } catch {\n    return null;\n  }\n  if (!isPathSafe(pathname, DIST_DIR)) return null;\n  const assetPath = resolve(DIST_DIR, decoded.slice(1));\n  try {\n    const s = statSync(assetPath);\n    if (s.isFile()) {\n      return new Response(readFileSync(assetPath), {\n        headers: { \"Content-Type\": getContentType(pathname) },\n      });\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n  }\n\n  if (decoded.startsWith(\"/docs/assets/\")) {\n    const docsAssetsDir = resolve(DOCS_DIR, \"assets\");\n    const requestedRelative = decoded.slice(\"/docs/assets/\".length);\n    const docsAsset = resolve(docsAssetsDir, requestedRelative);\n    const docsAssetsDirWithSep = docsAssetsDir.endsWith(\"/\") ? docsAssetsDir : docsAssetsDir + \"/\";\n    if (docsAsset !== docsAssetsDir && !docsAsset.startsWith(docsAssetsDirWithSep)) return null;\n    try {\n      const s = statSync(docsAsset);\n      if (s.isFile()) {\n        return new Response(readFileSync(docsAsset), {\n          headers: { \"Content-Type\": getContentType(pathname) },\n        });\n      }\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n    }\n  }\n  return null;\n}\n\nexport function serverErrorResponse(error: unknown): Response {\n  const msg = error instanceof Error ? error.message : \"Unknown error\";\n  const st =\n    process.env.NODE_ENV !== \"production\" && error instanceof Error ? error.stack : undefined;\n  return new Response(errorHtml(msg, st), {\n    status: 500,\n    headers: {\n      \"Content-Type\": \"text/html\",\n      ...SECURITY_HEADERS,\n      \"Content-Security-Policy\": \"default-src 'none'; style-src 'unsafe-inline'\",\n    },\n  });\n}\n","/**\n * Runtime-neutral dev server — mirror of `server.ts` (Bun-only, protected)\n * driven by a `RuntimeAdapter` (./runtime) instead of `Bun.serve`,\n * with manual route matching instead of `Bun.FileSystemRouter`. The page set\n * is static (`/`, `/docs/[[...slug]]`, `/404`), so a router is unnecessary.\n */\n\nimport { watch, existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { createRequire } from \"node:module\";\nimport type { RuntimeAdapter, ServerHandle } from \"./runtime\";\nimport { DOCS_DIR, loadDocuConfig } from \"./paths\";\nimport { loadPlugins } from \"./plugin-loader\";\nimport { BuildPluginBuilder } from \"./plugin-builder\";\nimport { buildClientBundle, computeInlineThemeCss } from \"./hydrate.node\";\nimport { generateSearchIndex } from \"./search-indexer\";\nimport { logger } from \"./logger\";\nimport { initSentry, captureException } from \"./sentry\";\nimport {\n  serveStatic,\n  handleDocsIndex,\n  handleDocsRoute,\n  handleIndex,\n  handleNotFound,\n  serverErrorResponse,\n  type ServerState,\n} from \"./server-routes\";\nimport { wrapPluginResponse } from \"./security\";\nimport { stripDocsHtmlSuffix } from \"./utils\";\n\nexport async function runServer(adapter: RuntimeAdapter): Promise<ServerHandle> {\n  const docuConfig = loadDocuConfig();\n\n  const parsedPort = parseInt(process.env.PORT ?? \"3000\", 10);\n  const PORT =\n    Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535 ? parsedPort : 3000;\n\n  logger.buildStart();\n\n  await initSentry();\n\n  logger.bundleStart();\n  let t = performance.now();\n  const assetManifest = await buildClientBundle();\n  logger.bundleDone(Math.round(performance.now() - t));\n\n  const inlineThemeCss = computeInlineThemeCss();\n\n  logger.indexStart();\n  t = performance.now();\n  const records = await generateSearchIndex();\n  logger.indexDone(records, Math.round(performance.now() - t));\n\n  logger.routes();\n\n  // Plugin setup — all hooks active (onLoad, remark/rehype, frontmatter, head/body, html transform, handleRequest)\n  const pluginsConfig = docuConfig.plugins ?? [];\n  const builder = pluginsConfig.length > 0 ? new BuildPluginBuilder(docuConfig) : null;\n\n  if (builder) {\n    const plugins = await loadPlugins(pluginsConfig);\n\n    for (const plugin of plugins) {\n      await plugin.setup(builder);\n    }\n  }\n\n  const state: ServerState = {\n    docuConfig,\n    assetManifest,\n    inlineThemeCss,\n    builder,\n  };\n\n  const hmrClients = new Set<ReadableStreamDefaultController>();\n\n  const require = createRequire(import.meta.url);\n  /** Locate the installed @docubook/markdown source dir (workspace link), if any. */\n  function resolveMdxContentSrc(): string | null {\n    try {\n      const pkgDir = dirname(require.resolve(\"@docubook/markdown/package.json\"));\n      const src = join(pkgDir, \"src\");\n      return existsSync(src) ? src : null;\n    } catch {\n      return null;\n    }\n  }\n\n  let hmrTimeout: ReturnType<typeof setTimeout> | null = null;\n  const watcher = watch(DOCS_DIR, { recursive: true }, (_event, filename) => {\n    if (!filename || (!filename.endsWith(\".mdx\") && !filename.endsWith(\".md\"))) return;\n    if (hmrTimeout) clearTimeout(hmrTimeout);\n    hmrTimeout = setTimeout(() => {\n      for (const client of [...hmrClients]) {\n        try {\n          client.enqueue(new TextEncoder().encode(\"data: reload\\n\\n\"));\n        } catch {\n          hmrClients.delete(client);\n        }\n      }\n    }, 300);\n  });\n\n  // Rebuild the client bundle when component sources change (e.g. the\n  // @docubook/markdown workspace package) so interactive islands pick up\n  // edits, then reload connected clients. MDX edits are handled by the watcher\n  // above — no rebuild needed, content recompiles per request.\n  let srcHmrTimeout: ReturnType<typeof setTimeout> | null = null;\n  const mdxContentSrc = resolveMdxContentSrc();\n  const srcWatcher = mdxContentSrc\n    ? watch(mdxContentSrc, { recursive: true }, (_event, filename) => {\n        if (!filename || !/\\.(ts|tsx|js|jsx|css)$/.test(filename)) return;\n        if (srcHmrTimeout) clearTimeout(srcHmrTimeout);\n        srcHmrTimeout = setTimeout(async () => {\n          try {\n            state.assetManifest = await buildClientBundle();\n            logger.warn(\"[hmr] client bundle rebuilt (component change)\");\n          } catch (e) {\n            logger.warn(\n              `[hmr] bundle rebuild failed: ${e instanceof Error ? e.message : String(e)}`\n            );\n          }\n          for (const client of [...hmrClients]) {\n            try {\n              client.enqueue(new TextEncoder().encode(\"data: reload\\n\\n\"));\n            } catch {\n              hmrClients.delete(client);\n            }\n          }\n        }, 300);\n      })\n    : null;\n\n  process.on(\"SIGINT\", () => {\n    watcher.close();\n    srcWatcher?.close();\n    process.exit(0);\n  });\n  process.on(\"SIGTERM\", () => {\n    watcher.close();\n    srcWatcher?.close();\n    process.exit(0);\n  });\n\n  let handle: ServerHandle | null = null;\n\n  const fetchHandler = async (req: Request): Promise<Response> => {\n    const url = new URL(req.url);\n    // Generated links carry `.html` (matching the static build output);\n    // route them to the same handler as their extensionless form.\n    const pathname = stripDocsHtmlSuffix(url.pathname);\n    const startTime = performance.now();\n\n    if (builder) {\n      const pluginResponse = await builder.runHandleRequest(req, {\n        port: handle?.port ?? PORT,\n        hostname: handle?.hostname ?? \"localhost\",\n      });\n      if (pluginResponse) {\n        const securedResponse = wrapPluginResponse(pluginResponse, true);\n        logger.request(\n          req.method,\n          pathname,\n          securedResponse.status,\n          Math.round(performance.now() - startTime)\n        );\n        return securedResponse;\n      }\n    }\n\n    try {\n      if (pathname === \"/__hmr\") {\n        const stream = new ReadableStream({\n          start(controller) {\n            hmrClients.add(controller);\n            controller.enqueue(new TextEncoder().encode(\"data: connected\\n\\n\"));\n          },\n          cancel(controller) {\n            hmrClients.delete(controller);\n          },\n        });\n        return new Response(stream, {\n          headers: {\n            \"Content-Type\": \"text/event-stream\",\n            \"Cache-Control\": \"no-cache\",\n            Connection: \"keep-alive\",\n          },\n        });\n      }\n\n      if (pathname.startsWith(\"/assets/\") || /\\.\\w+$/.test(pathname)) {\n        const staticRes = serveStatic(pathname);\n        if (staticRes) return staticRes;\n      }\n\n      let response: Response;\n\n      // Manual route matching — same routes Bun.FileSystemRouter derives\n      // from `.docu/pages/` (\"/\", \"/docs/[[...slug]]\", \"/404\").\n      if (pathname === \"/\") {\n        response = handleIndex(state);\n      } else if (pathname === \"/docs\" || pathname === \"/docs/\") {\n        response = await handleDocsIndex(state);\n      } else if (pathname.startsWith(\"/docs/\")) {\n        const slug = pathname.slice(\"/docs/\".length).split(\"/\").filter(Boolean);\n        response =\n          slug.length === 0 ? await handleDocsIndex(state) : await handleDocsRoute(slug, state);\n      } else {\n        response = handleNotFound(state);\n      }\n\n      logger.request(\n        req.method,\n        pathname,\n        response.status,\n        Math.round(performance.now() - startTime)\n      );\n      return response;\n    } catch (err) {\n      captureException(err, { method: req.method, pathname });\n      logger.request(req.method, pathname, 500, Math.round(performance.now() - startTime));\n      return serverErrorResponse(err);\n    }\n  };\n\n  handle = await adapter.serve(fetchHandler, { port: PORT, idleTimeout: 255 });\n\n  logger.ready(handle.port, true);\n  return handle;\n}\n"],"mappings":"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"}
+{"version":3,"file":"server.impl-CXTzYqbF.js","names":[],"sources":["../node/server-routes.ts","../node/server.impl.ts"],"sourcesContent":["import { readFile, stat } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { readFileSync, statSync } from \"node:fs\";\nimport React, { type ReactNode } from \"react\";\nimport { renderToString } from \"react-dom/server\";\nimport { compileMdx, frontmatterField } from \"./mdx\";\nimport { getContentType } from \"./utils\";\nimport { DOCS_DIR, DIST_DIR, PROJECT_ROOT } from \"./paths\";\nimport { BuildPluginBuilder } from \"./plugin-builder\";\nimport type { PageContext } from \"./plugin\";\nimport type { DocuConfig, TocItem } from \"./types\";\nimport DocsPage from \"../pages/docs/[[...slug]]\";\nimport NotFoundPage from \"../pages/404\";\nimport IndexPage from \"../pages/index\";\nimport { DocsLayout } from \"../components/DocsLayout\";\nimport { generateNonce, isPathSafe, isSlugSafe, htmlResponse, SECURITY_HEADERS } from \"./security\";\nimport { htmlShell as createHtmlShell, hmrScript, errorHtml } from \"./html.shared\";\n\nexport interface ServerState {\n  docuConfig: DocuConfig;\n  assetManifest: { css: string; js: string };\n  inlineThemeCss?: string;\n  builder: BuildPluginBuilder | null;\n}\n\nfunction createHtmlResponse(\n  title: string,\n  description: string,\n  body: string,\n  status: number,\n  state: ServerState,\n  depth = 0\n): Response {\n  const nonce = generateNonce();\n  const favicon = state.docuConfig.meta?.favicon || \"/favicon.ico\";\n  const html = createHtmlShell({\n    title,\n    description,\n    body,\n    favicon,\n    css: state.assetManifest.css,\n    js: state.assetManifest.js,\n    nonce,\n    extraScripts: hmrScript(nonce),\n    themeCss: state.inlineThemeCss,\n    depth,\n    // 404 pages can be requested at arbitrary depths (e.g. a noLink section\n    // path typed in the address bar) — relative asset paths would resolve\n    // against the wrong directory and break CSS/JS.\n    absoluteAssets: status === 404,\n  });\n  /** Dev-only: serves compiledSource → MDXRemote eval path (no CSP in production). */\n  return htmlResponse(html, nonce, status, true);\n}\n\n// Dev-only memo: compileMdx per request is ~70ms; repeat navigations with\n// an unchanged file (same mtime) reuse the compiled result. The dev server\n// has no other per-page cache — without this every navigation re-parses MDX.\n// ponytail: unbounded Map is fine — docs sites have a handful of pages; cap\n// with an LRU only if a project exceeds thousands of routes.\nconst docsCache = new Map<\n  string,\n  { mtimeMs: number; doc: NonNullable<Awaited<ReturnType<typeof getDocsForSlug>>> }\n>();\n\nasync function getDocsForSlug(\n  slug: string,\n  state: ServerState\n): Promise<{\n  content: ReactNode;\n  compiledSource: string;\n  frontmatter: Record<string, unknown>;\n  tocs: TocItem[];\n  filePath: string;\n  resolvedContent: string;\n} | null> {\n  if (!isSlugSafe(slug, DOCS_DIR)) return null;\n\n  const paths = [\n    resolve(DOCS_DIR, slug, \"index.mdx\"),\n    resolve(DOCS_DIR, `${slug}.mdx`),\n    resolve(DOCS_DIR, slug, \"index.md\"),\n    resolve(DOCS_DIR, `${slug}.md`),\n  ];\n\n  const resolvedDocsDir = resolve(DOCS_DIR);\n  let filePath: string | null = null;\n  let raw: string | null = null;\n  for (const p of paths) {\n    const resolvedCandidate = resolve(p);\n    if (\n      resolvedCandidate !== resolvedDocsDir &&\n      !resolvedCandidate.startsWith(resolvedDocsDir + \"/\")\n    ) {\n      continue;\n    }\n    try {\n      raw = await readFile(resolvedCandidate, \"utf-8\");\n      filePath = resolvedCandidate;\n      break;\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n    }\n  }\n  if (!filePath || !raw) return null;\n\n  const relPath = filePath.replace(PROJECT_ROOT + \"/\", \"\");\n\n  const mtimeMs = (await stat(filePath)).mtimeMs;\n  const cached = docsCache.get(relPath);\n  if (cached && cached.mtimeMs === mtimeMs) {\n    return cached.doc;\n  }\n\n  let content = raw;\n  if (state.builder) {\n    const transformed = await state.builder.runOnLoad(relPath, content);\n    if (transformed?.contents) {\n      content = transformed.contents;\n    }\n  }\n\n  const remarkPlugins = state.builder?.collectRemarkPlugins();\n  const rehypePlugins = state.builder?.collectRehypePlugins();\n  const result = await compileMdx(content, relPath, undefined, remarkPlugins, rehypePlugins);\n\n  let frontmatter = result.frontmatter as Record<string, unknown>;\n  if (state.builder) {\n    frontmatter = await state.builder.runTransformFrontmatterChain(frontmatter, {\n      slug: slug || \"/\",\n      filePath: relPath,\n      content,\n    });\n  }\n\n  const doc = {\n    content: result.content,\n    compiledSource: result.compiledSource,\n    frontmatter,\n    tocs: result.tocs,\n    filePath: relPath,\n    resolvedContent: content,\n  };\n  docsCache.set(relPath, { mtimeMs, doc });\n  return doc;\n}\n\nasync function renderDocsServerPage(\n  doc: NonNullable<Awaited<ReturnType<typeof getDocsForSlug>>>,\n  slug: string[],\n  pathname: string,\n  state: ServerState\n): Promise<Response> {\n  const title = frontmatterField(doc.frontmatter, \"title\") || slug.join(\"/\") || \"Docs\";\n  const description = frontmatterField(doc.frontmatter, \"description\");\n\n  const page = React.createElement(\n    DocsLayout,\n    { repoUrl: state.docuConfig.repo?.url, pathname },\n    React.createElement(DocsPage, {\n      slug,\n      title,\n      description,\n      date: frontmatterField(doc.frontmatter, \"date\") || undefined,\n      // Same root-relative SSR as build — see build.ts.\n      content: renderToString(doc.content),\n      tocs: doc.tocs,\n      filePath: doc.filePath,\n      repoUrl: state.docuConfig.repo?.url,\n      compiledSource: doc.compiledSource,\n    })\n  );\n\n  const body = renderToString(page);\n\n  // Match build.ts depth calculation: slug.split(\"/\").length, fallback to 1 for empty\n  const depth = slug.length || 1;\n\n  if (state.builder) {\n    const ctx: PageContext = {\n      slug: slug.join(\"/\") || \"/\",\n      filePath: doc.filePath,\n      frontmatter: doc.frontmatter,\n      content: doc.resolvedContent,\n      config: state.docuConfig,\n    };\n    const headExtra = state.builder.collectHead(ctx);\n    const bodyExtra = state.builder.collectBody(ctx);\n    const nonce = generateNonce();\n    const favicon = state.docuConfig.meta?.favicon || \"/favicon.ico\";\n    let html = createHtmlShell({\n      title,\n      description,\n      body,\n      favicon,\n      css: state.assetManifest.css,\n      js: state.assetManifest.js,\n      nonce,\n      extraScripts: hmrScript(nonce),\n      themeCss: state.inlineThemeCss,\n      headExtra,\n      bodyExtra,\n      depth,\n    });\n    html = await state.builder.runTransformHtmlChain(html, ctx);\n    /** Dev-only: serves compiledSource → MDXRemote eval path (no CSP in production). */\n    return htmlResponse(html, nonce, 200, true);\n  }\n\n  return createHtmlResponse(title, description, body, 200, state, depth);\n}\n\nfunction renderPage(\n  Component: React.ComponentType<Record<string, unknown>>,\n  title: string,\n  description: string,\n  status: number,\n  state: ServerState,\n  props: Record<string, unknown> = {},\n  depth = 0\n): Response {\n  const page = React.createElement(\n    DocsLayout,\n    { repoUrl: state.docuConfig.repo?.url, pathname: \"/docs\" },\n    React.createElement(Component, props)\n  );\n  const body = renderToString(page);\n  return createHtmlResponse(title, description, body, status, state, depth);\n}\n\nexport async function handleDocsIndex(state: ServerState): Promise<Response> {\n  const doc = await getDocsForSlug(\"\", state);\n  if (!doc) return renderPage(NotFoundPage, \"404 - Not Found\", \"\", 404, state, {}, 1);\n  return renderDocsServerPage(doc, [], \"/docs\", state);\n}\n\nexport async function handleDocsRoute(slug: string[], state: ServerState): Promise<Response> {\n  const path = slug.join(\"/\");\n  const doc = await getDocsForSlug(path, state);\n  if (!doc)\n    return renderPage(NotFoundPage, \"404 - Not Found\", \"\", 404, state, {}, slug.length || 1);\n  return renderDocsServerPage(doc, slug, `/docs/${path}`, state);\n}\n\nexport function handleIndex(state: ServerState): Response {\n  const page = React.createElement(IndexPage);\n  const body = renderToString(page);\n  return createHtmlResponse(\n    state.docuConfig.meta?.title || \"DocuBook\",\n    state.docuConfig.meta?.description || \"\",\n    body,\n    200,\n    state\n  );\n}\n\nexport function handleNotFound(state: ServerState, depth = 0): Response {\n  return renderPage(NotFoundPage, \"404 - Not Found\", \"\", 404, state, {}, depth);\n}\n\nexport function serveStatic(pathname: string): Response | null {\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(pathname);\n  } catch {\n    return null;\n  }\n  if (!isPathSafe(pathname, DIST_DIR)) return null;\n  const assetPath = resolve(DIST_DIR, decoded.slice(1));\n  try {\n    const s = statSync(assetPath);\n    if (s.isFile()) {\n      return new Response(readFileSync(assetPath), {\n        headers: { \"Content-Type\": getContentType(pathname) },\n      });\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n  }\n\n  if (decoded.startsWith(\"/docs/assets/\")) {\n    const docsAssetsDir = resolve(DOCS_DIR, \"assets\");\n    const requestedRelative = decoded.slice(\"/docs/assets/\".length);\n    const docsAsset = resolve(docsAssetsDir, requestedRelative);\n    const docsAssetsDirWithSep = docsAssetsDir.endsWith(\"/\") ? docsAssetsDir : docsAssetsDir + \"/\";\n    if (docsAsset !== docsAssetsDir && !docsAsset.startsWith(docsAssetsDirWithSep)) return null;\n    try {\n      const s = statSync(docsAsset);\n      if (s.isFile()) {\n        return new Response(readFileSync(docsAsset), {\n          headers: { \"Content-Type\": getContentType(pathname) },\n        });\n      }\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n    }\n  }\n  return null;\n}\n\nexport function serverErrorResponse(error: unknown): Response {\n  const msg = error instanceof Error ? error.message : \"Unknown error\";\n  const st =\n    process.env.NODE_ENV !== \"production\" && error instanceof Error ? error.stack : undefined;\n  return new Response(errorHtml(msg, st), {\n    status: 500,\n    headers: {\n      \"Content-Type\": \"text/html\",\n      ...SECURITY_HEADERS,\n      \"Content-Security-Policy\": \"default-src 'none'; style-src 'unsafe-inline'\",\n    },\n  });\n}\n","/**\n * Runtime-neutral dev server — mirror of `server.ts` (Bun-only, protected)\n * driven by a `RuntimeAdapter` (./runtime) instead of `Bun.serve`,\n * with manual route matching instead of `Bun.FileSystemRouter`. The page set\n * is static (`/`, `/docs/[[...slug]]`, `/404`), so a router is unnecessary.\n */\n\nimport { watch, existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { createRequire } from \"node:module\";\nimport type { RuntimeAdapter, ServerHandle } from \"./runtime\";\nimport { DOCS_DIR, loadDocuConfig } from \"./paths\";\nimport { loadPlugins } from \"./plugin-loader\";\nimport { BuildPluginBuilder } from \"./plugin-builder\";\nimport { buildClientBundle, computeInlineThemeCss } from \"./hydrate.node\";\nimport { generateSearchIndex } from \"./search-indexer\";\nimport { logger } from \"./logger\";\nimport { initSentry, captureException } from \"./sentry\";\nimport {\n  serveStatic,\n  handleDocsIndex,\n  handleDocsRoute,\n  handleIndex,\n  handleNotFound,\n  serverErrorResponse,\n  type ServerState,\n} from \"./server-routes\";\nimport { wrapPluginResponse } from \"./security\";\nimport { stripDocsHtmlSuffix } from \"./utils\";\n\nexport async function runServer(adapter: RuntimeAdapter): Promise<ServerHandle> {\n  const docuConfig = loadDocuConfig();\n\n  const parsedPort = parseInt(process.env.PORT ?? \"3000\", 10);\n  const PORT =\n    Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535 ? parsedPort : 3000;\n\n  logger.buildStart();\n\n  await initSentry();\n\n  logger.bundleStart();\n  let t = performance.now();\n  const assetManifest = await buildClientBundle();\n  logger.bundleDone(Math.round(performance.now() - t));\n\n  const inlineThemeCss = computeInlineThemeCss();\n\n  logger.indexStart();\n  t = performance.now();\n  const records = await generateSearchIndex();\n  logger.indexDone(records, Math.round(performance.now() - t));\n\n  logger.routes();\n\n  // Plugin setup — all hooks active (onLoad, remark/rehype, frontmatter, head/body, html transform, handleRequest)\n  const pluginsConfig = docuConfig.plugins ?? [];\n  const builder = pluginsConfig.length > 0 ? new BuildPluginBuilder(docuConfig) : null;\n\n  if (builder) {\n    const plugins = await loadPlugins(pluginsConfig);\n\n    for (const plugin of plugins) {\n      await plugin.setup(builder);\n    }\n  }\n\n  const state: ServerState = {\n    docuConfig,\n    assetManifest,\n    inlineThemeCss,\n    builder,\n  };\n\n  const hmrClients = new Set<ReadableStreamDefaultController>();\n\n  const require = createRequire(import.meta.url);\n  /** Locate the installed @docubook/markdown source dir (workspace link), if any. */\n  function resolveMdxContentSrc(): string | null {\n    try {\n      const pkgDir = dirname(require.resolve(\"@docubook/markdown/package.json\"));\n      const src = join(pkgDir, \"src\");\n      return existsSync(src) ? src : null;\n    } catch {\n      return null;\n    }\n  }\n\n  let hmrTimeout: ReturnType<typeof setTimeout> | null = null;\n  const watcher = watch(DOCS_DIR, { recursive: true }, (_event, filename) => {\n    if (!filename || (!filename.endsWith(\".mdx\") && !filename.endsWith(\".md\"))) return;\n    if (hmrTimeout) clearTimeout(hmrTimeout);\n    hmrTimeout = setTimeout(() => {\n      for (const client of [...hmrClients]) {\n        try {\n          client.enqueue(new TextEncoder().encode(\"data: reload\\n\\n\"));\n        } catch {\n          hmrClients.delete(client);\n        }\n      }\n    }, 300);\n  });\n\n  // Rebuild the client bundle when component sources change (e.g. the\n  // @docubook/markdown workspace package) so interactive islands pick up\n  // edits, then reload connected clients. MDX edits are handled by the watcher\n  // above — no rebuild needed, content recompiles per request.\n  let srcHmrTimeout: ReturnType<typeof setTimeout> | null = null;\n  const mdxContentSrc = resolveMdxContentSrc();\n  const srcWatcher = mdxContentSrc\n    ? watch(mdxContentSrc, { recursive: true }, (_event, filename) => {\n        if (!filename || !/\\.(ts|tsx|js|jsx|css)$/.test(filename)) return;\n        if (srcHmrTimeout) clearTimeout(srcHmrTimeout);\n        srcHmrTimeout = setTimeout(async () => {\n          try {\n            state.assetManifest = await buildClientBundle();\n            logger.warn(\"[hmr] client bundle rebuilt (component change)\");\n          } catch (e) {\n            logger.warn(\n              `[hmr] bundle rebuild failed: ${e instanceof Error ? e.message : String(e)}`\n            );\n          }\n          for (const client of [...hmrClients]) {\n            try {\n              client.enqueue(new TextEncoder().encode(\"data: reload\\n\\n\"));\n            } catch {\n              hmrClients.delete(client);\n            }\n          }\n        }, 300);\n      })\n    : null;\n\n  process.on(\"SIGINT\", () => {\n    watcher.close();\n    srcWatcher?.close();\n    process.exit(0);\n  });\n  process.on(\"SIGTERM\", () => {\n    watcher.close();\n    srcWatcher?.close();\n    process.exit(0);\n  });\n\n  let handle: ServerHandle | null = null;\n\n  const fetchHandler = async (req: Request): Promise<Response> => {\n    const url = new URL(req.url);\n    // Generated links carry `.html` (matching the static build output);\n    // route them to the same handler as their extensionless form.\n    const pathname = stripDocsHtmlSuffix(url.pathname);\n    const startTime = performance.now();\n\n    if (builder) {\n      const pluginResponse = await builder.runHandleRequest(req, {\n        port: handle?.port ?? PORT,\n        hostname: handle?.hostname ?? \"localhost\",\n      });\n      if (pluginResponse) {\n        const securedResponse = wrapPluginResponse(pluginResponse, true);\n        logger.request(\n          req.method,\n          pathname,\n          securedResponse.status,\n          Math.round(performance.now() - startTime)\n        );\n        return securedResponse;\n      }\n    }\n\n    try {\n      if (pathname === \"/__hmr\") {\n        const stream = new ReadableStream({\n          start(controller) {\n            hmrClients.add(controller);\n            controller.enqueue(new TextEncoder().encode(\"data: connected\\n\\n\"));\n          },\n          cancel(controller) {\n            hmrClients.delete(controller);\n          },\n        });\n        return new Response(stream, {\n          headers: {\n            \"Content-Type\": \"text/event-stream\",\n            \"Cache-Control\": \"no-cache\",\n            Connection: \"keep-alive\",\n          },\n        });\n      }\n\n      if (pathname.startsWith(\"/assets/\") || /\\.\\w+$/.test(pathname)) {\n        const staticRes = serveStatic(pathname);\n        if (staticRes) return staticRes;\n      }\n\n      let response: Response;\n\n      // Manual route matching — same routes Bun.FileSystemRouter derives\n      // from `.docu/pages/` (\"/\", \"/docs/[[...slug]]\", \"/404\").\n      if (pathname === \"/\") {\n        response = handleIndex(state);\n      } else if (pathname === \"/docs\" || pathname === \"/docs/\") {\n        response = await handleDocsIndex(state);\n      } else if (pathname.startsWith(\"/docs/\")) {\n        const slug = pathname.slice(\"/docs/\".length).split(\"/\").filter(Boolean);\n        response =\n          slug.length === 0 ? await handleDocsIndex(state) : await handleDocsRoute(slug, state);\n      } else {\n        response = handleNotFound(state);\n      }\n\n      logger.request(\n        req.method,\n        pathname,\n        response.status,\n        Math.round(performance.now() - startTime)\n      );\n      return response;\n    } catch (err) {\n      captureException(err, { method: req.method, pathname });\n      logger.request(req.method, pathname, 500, Math.round(performance.now() - startTime));\n      return serverErrorResponse(err);\n    }\n  };\n\n  handle = await adapter.serve(fetchHandler, { port: PORT, idleTimeout: 255 });\n\n  logger.ready(handle.port, true);\n  return handle;\n}\n"],"mappings":"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"}

package/.docu/lib/server.node.js

@@ -1,5 +1,5 @@
 import { t as nodeAdapter } from "./node-DPTySdwG.js";
-import { t as runServer } from "./server.impl-CJuWimfN.js";
+import { t as runServer } from "./server.impl-CXTzYqbF.js";
 //#region .docu/node/server.node.ts
 await runServer(nodeAdapter);
 //#endregion

package/.docu/node/build.impl.ts

@@ -6,7 +6,7 @@
  * The Node/Deno build entries call `runBuildCli()`.
  */
 
-import { readFile, writeFile, mkdir, readdir, copyFile } from "node:fs/promises";
+import { readFile, writeFile, mkdir, readdir, copyFile, rename, unlink } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { join, dirname } from "node:path";
@@ -39,7 +39,16 @@ import { initSentry, captureException } from "./sentry";
 import { loadPlugins } from "./plugin-loader";
 import { BuildPluginBuilder } from "./plugin-builder";
 import { scanMdxFiles } from "./utils";
-import type { BuildCache, CliArgs } from "./types";
+import type { BuildCache, BuildCacheMeta, CliArgs } from "./types";
+import { isCacheEntry } from "./types";
+import {
+  BUILD_CACHE_VERSION,
+  atomicWriteFile,
+  hashMdxSources,
+  hookMemoryPressure,
+  runtimeStamp,
+} from "./cache-key";
+import { clearDerivedPageCaches } from "./mdx";
 import { generateNonce, cspHeader } from "./security";
 import type { PageMeta, PageContext } from "./plugin";
 import { buildSeoMeta } from "./seo";
@@ -64,7 +73,12 @@ async function readCache(): Promise<BuildCache> {
   try {
     if (existsSync(CACHE_FILE)) {
       const data = await readFile(CACHE_FILE, "utf-8");
-      return JSON.parse(data);
+      const parsed = JSON.parse(data) as BuildCache;
+      const meta = parsed.__meta__ as BuildCacheMeta | undefined;
+      if (!meta || meta.version !== BUILD_CACHE_VERSION || meta.runtime !== runtimeStamp()) {
+        return {};
+      }
+      return parsed;
     }
   } catch (err) {
     console.error("Failed to load build cache:", (err as Error).message);
@@ -72,8 +86,19 @@ async function readCache(): Promise<BuildCache> {
   return {};
 }
 
+function stampCache(cache: BuildCache): void {
+  cache.__meta__ = {
+    hash: `${BUILD_CACHE_VERSION}:${runtimeStamp()}`,
+    mtime: 0,
+    builtAt: Date.now(),
+    version: BUILD_CACHE_VERSION,
+    runtime: runtimeStamp(),
+  };
+}
+
 async function writeCache(cache: BuildCache): Promise<void> {
-  await writeFile(CACHE_FILE, JSON.stringify(cache, null, 2));
+  stampCache(cache);
+  await atomicWriteFile(writeFile, rename, unlink, CACHE_FILE, JSON.stringify(cache, null, 2));
 }
 
 function parseConcurrency(): number {
@@ -84,13 +109,38 @@ type RebuildDecision = "yes" | "hash_check" | "no";
 
 function shouldRebuild(path: string, mtime: number, cache: BuildCache): RebuildDecision {
   const cached = cache[path];
-  if (!cached) return "yes";
-  if (mtime > cached.builtAt) return "hash_check";
+  if (!isCacheEntry(cached)) return "yes";
+  if (mtime > cached.builtAt + 2000) return "hash_check";
+  if (Math.abs(mtime - cached.builtAt) <= 2000 && mtime !== cached.mtime) return "hash_check";
+  if (mtime !== cached.mtime && mtime > cached.mtime) return "hash_check";
   return "no";
 }
 
 let assetManifest = { js: "client.js", css: "client.css" };
 
+/**
+ * Reuse manifest.json on bundle cache hit; fall back to a full rebuild
+ * when the manifest is missing or malformed.
+ */
+async function resolveAssetManifest(
+  bundleHit: boolean,
+  mdxSources: Record<string, string>
+): Promise<{ js: string; css: string }> {
+  if (!bundleHit) return buildClientBundle(mdxSources);
+  try {
+    const manifest = JSON.parse(await readFile(join(ASSETS_DIR, "manifest.json"), "utf-8")) as {
+      js?: string;
+      css?: string;
+    };
+    if (typeof manifest.js === "string" && typeof manifest.css === "string") {
+      return { js: manifest.js, css: manifest.css };
+    }
+  } catch {
+    // corrupt/missing manifest — rebuild below
+  }
+  return buildClientBundle(mdxSources);
+}
+
 let inlineThemeCss: string | undefined;
 
 async function renderDocsPage(
@@ -180,7 +230,7 @@ async function renderDocsPage(
   const seo = buildSeoMeta(docuConfig, frontmatter, slug || "");
   // MDX content hydrates from the bundled ESM module (mdx-hydrate), not
   // new Function — no 'unsafe-eval' needed in the CSP.
-  const csp = cspHeader(nonce);
+  const csp = nonce ? cspHeader(nonce) : undefined;
   let html = htmlShell({
     title,
     description,
@@ -223,6 +273,8 @@ export async function runBuild(): Promise<void> {
   const docuConfig = loadDocuConfig();
   const args = parseArgs();
 
+  hookMemoryPressure(clearDerivedPageCaches);
+
   logger.buildStart();
 
   if (args.clean) {
@@ -311,14 +363,20 @@ export async function runBuild(): Promise<void> {
 
   logger.bundleStart();
   let t = performance.now();
-  assetManifest = await buildClientBundle(mdxSources);
+  const bundleHash = hashMdxSources(mdxSources);
+  const lastBundle = cache["__bundle__"];
+  const bundleHit =
+    isCacheEntry(lastBundle) &&
+    lastBundle.hash === bundleHash &&
+    existsSync(join(ASSETS_DIR, "manifest.json"));
+  assetManifest = await resolveAssetManifest(bundleHit, mdxSources);
   logger.bundleDone(Math.round(performance.now() - t));
 
   inlineThemeCss = computeInlineThemeCss();
 
   const lastManifest = cache["__assets__"];
   const assetsChanged =
-    !lastManifest || lastManifest.hash !== `${assetManifest.js}:${assetManifest.css}`;
+    !isCacheEntry(lastManifest) || lastManifest.hash !== `${assetManifest.js}:${assetManifest.css}`;
   if (assetsChanged) {
     cache["__assets__"] = {
       hash: `${assetManifest.js}:${assetManifest.css}`,
@@ -326,6 +384,9 @@ export async function runBuild(): Promise<void> {
       builtAt: Date.now(),
     };
   }
+  if (!bundleHit) {
+    cache["__bundle__"] = { hash: bundleHash, mtime: 0, builtAt: Date.now() };
+  }
 
   logger.spinner.start("Building pages...");
   t = performance.now();
@@ -366,7 +427,7 @@ export async function runBuild(): Promise<void> {
     if (rebuildDecision === "hash_check") {
       const contentHash = hashContent(rawMdx);
       const cached = cache[file.path];
-      if (cached && cached.hash === contentHash) {
+      if (isCacheEntry(cached) && cached.hash === contentHash) {
         if (!assetsChanged) {
           const outputPath = join(DIST_DIR, "docs", `${file.path}.html`);
           if (existsSync(outputPath)) {
@@ -438,7 +499,11 @@ export async function runBuild(): Promise<void> {
 
   const landingPage = React.createElement(IndexPage);
   const landingFavicon = docuConfig.meta?.favicon || "/docs/assets/images/favicon.ico";
-  const landingSeo = buildSeoMeta(docuConfig, docuConfig.meta as Record<string, unknown>, "");
+  const landingSeo = buildSeoMeta(
+    docuConfig,
+    docuConfig.meta as unknown as Record<string, unknown>,
+    ""
+  );
   const landingNonce = generateNonce();
   const landingHtml = htmlShell({
     title: docuConfig.meta?.title || "DocuBook",