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

package/.docu/components/Pagination.tsx

@@ -28,7 +28,18 @@ export default function Pagination({
 
   return (
     <PaginationDocs
-      prev={prev ? { href: docsHtmlHref(`/docs${prev.href}`), title: prev.title } : undefined}
+      // `description` rides along always; PaginationDocs keeps the paired prev
+      // minimal by design and renders title + description only when prev is
+      // alone (last page, no next) — single branch point, no duplicated logic.
+      prev={
+        prev
+          ? {
+              href: docsHtmlHref(`/docs${prev.href}`),
+              title: prev.title,
+              description: prev.description,
+            }
+          : undefined
+      }
       next={
         next
           ? {

package/.docu/lib/build.deno.js

@@ -1,4 +1,4 @@
-import { n as runBuildCli } from "./build.impl-Bz_p421t.js";
+import { n as runBuildCli } from "./build.impl-CT-YLyLn.js";
 //#region .docu/node/build.deno.ts
 await runBuildCli();
 process.exit(0);

package/.docu/lib/{build.impl-Bz_p421t.js → build.impl-CT-YLyLn.js}

@@ -1,7 +1,7 @@
 import { a as DOCS_DIR, c as PROJECT_ROOT, d as loadDocuConfig, i as DOCS_ASSETS_DIR, n as CACHE_FILE, r as DIST_DIR, t as ASSETS_DIR } from "./paths-Bl2cdp9E.js";
-import { C as hashMdxSources, D as loadPlugins, E as BuildPluginBuilder, S as atomicWriteFile, T as runtimeStamp, _ as getPageStripped, a as IndexPage, b as buildClientBundle, c as captureException, d as clearDerivedPageCaches, f as compileMdx, g as getPageFrontmatter, h as getPageContent, i as DocsLayout, l as initSentry, m as frontmatterField, o as NotFoundPage, p as compileMdxModule, r as htmlShell, s as DocsPage, u as generateSearchIndex, v as registerPageContent, w as hookMemoryPressure, x as computeInlineThemeCss, y as getGitLastModifiedBatch } from "./html.shared-FwgbE1WG.js";
-import { l as cspHeader, o as scanMdxFiles, u as generateNonce } from "./utils-DA17MyQG.js";
-import { t as logger } from "./logger-CQyNTE6L.js";
+import { C as hashMdxSources, D as loadPlugins, E as BuildPluginBuilder, S as atomicWriteFile, T as runtimeStamp, _ as getPageStripped, a as IndexPage, b as buildClientBundle, c as captureException, d as clearDerivedPageCaches, f as compileMdx, g as getPageFrontmatter, h as getPageContent, i as DocsLayout, l as initSentry, m as frontmatterField, o as NotFoundPage, p as compileMdxModule, r as htmlShell, s as DocsPage, u as generateSearchIndex, v as registerPageContent, w as hookMemoryPressure, x as computeInlineThemeCss, y as getGitLastModifiedBatch } from "./html.shared-WwQnhDty.js";
+import { c as scanMdxFiles, d as cspHeader, p as generateNonce, s as resolveDocsIndexSource } from "./utils-B_CoyKie.js";
+import { t as logger } from "./logger-Cz0CPMi8.js";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { copyFile, mkdir, readFile, readdir, rename, unlink, writeFile } from "node:fs/promises";
@@ -60,7 +60,7 @@ async function readCache() {
 			const data = await readFile(CACHE_FILE, "utf-8");
 			const parsed = JSON.parse(data);
 			const meta = parsed.__meta__;
-			if (!meta || meta.version !== 3 || meta.runtime !== runtimeStamp()) return {};
+			if (!meta || meta.version !== 4 || meta.runtime !== runtimeStamp()) return {};
 			return parsed;
 		}
 	} catch (err) {
@@ -70,10 +70,10 @@ async function readCache() {
 }
 function stampCache(cache) {
 	cache.__meta__ = {
-		hash: `3:${runtimeStamp()}`,
+		hash: `4:${runtimeStamp()}`,
 		mtime: 0,
 		builtAt: Date.now(),
-		version: 3,
+		version: 4,
 		runtime: runtimeStamp()
 	};
 }
@@ -87,9 +87,7 @@ function parseConcurrency() {
 function shouldRebuild(path, mtime, cache) {
 	const cached = cache[path];
 	if (!isCacheEntry(cached)) return "yes";
-	if (mtime > cached.builtAt + 2e3) return "hash_check";
-	if (Math.abs(mtime - cached.builtAt) <= 2e3 && mtime !== cached.mtime) return "hash_check";
-	if (mtime !== cached.mtime && mtime > cached.mtime) return "hash_check";
+	if (mtime !== cached.mtime) return "hash_check";
 	return "no";
 }
 var assetManifest = {
@@ -245,11 +243,11 @@ async function runBuild() {
 		mdxSources[file.path] = await compileMdxModule(content, remarkPlugins, rehypePlugins, `/${file.path}`);
 	});
 	await Promise.all(prePassTasks);
-	const indexMdxPath = join(DOCS_DIR, "index.mdx");
-	if (existsSync(indexMdxPath)) try {
-		let indexContent = await readFile(indexMdxPath, "utf-8");
+	const indexSource = resolveDocsIndexSource(DOCS_DIR);
+	if (indexSource) try {
+		let indexContent = await readFile(indexSource, "utf-8");
 		if (builder) {
-			const relPath = indexMdxPath.replace(PROJECT_ROOT + "/", "");
+			const relPath = indexSource.replace(PROJECT_ROOT + "/", "");
 			const transformed = await builder.runOnLoad(relPath, indexContent);
 			if (transformed?.contents) indexContent = transformed.contents;
 		}
@@ -278,8 +276,7 @@ async function runBuild() {
 	logger.spinner.start("Building pages...");
 	t = performance.now();
 	const allRelPaths = mdxFiles.map((f) => f.absPath.replace(PROJECT_ROOT + "/", ""));
-	const indexMdxFull = join(DOCS_DIR, "index.mdx");
-	if (existsSync(indexMdxFull)) allRelPaths.push(indexMdxFull.replace(PROJECT_ROOT + "/", ""));
+	if (indexSource) allRelPaths.push(indexSource.replace(PROJECT_ROOT + "/", ""));
 	const gitDates = await getGitLastModifiedBatch(allRelPaths);
 	const CONCURRENCY = parseConcurrency();
 	const buildTasks = [];
@@ -342,15 +339,19 @@ async function runBuild() {
 		});
 	}
 	for (let i = 0; i < buildTasks.length; i += CONCURRENCY) await Promise.all(buildTasks.slice(i, i + CONCURRENCY).map((fn) => fn()));
-	try {
-		const indexMdxPath = join(DOCS_DIR, "index.mdx");
-		const indexHtml = await renderDocsPage(docuConfig, "", await readFile(indexMdxPath, "utf-8"), indexMdxPath.replace(PROJECT_ROOT + "/", ""), gitDates, builder, generateNonce());
+	if (indexSource) try {
+		const indexHtml = await renderDocsPage(docuConfig, "", await readFile(indexSource, "utf-8"), indexSource.replace(PROJECT_ROOT + "/", ""), gitDates, builder, generateNonce());
 		await mkdir(join(DIST_DIR, "docs"), { recursive: true });
 		await writeFile(join(DIST_DIR, "docs", "index.html"), indexHtml);
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
-		errors.push(`index.mdx: ${msg}`);
-		console.error(`\n\u274C Failed to build index: ${msg}\n`);
+		errors.push(`index: ${msg}`);
+		console.error(`\n❌ Failed to build index: ${msg}\n`);
+	}
+	else {
+		const msg = "docs root index: docs/index.mdx (or docs/index.md) not found";
+		errors.push(`index: ${msg}`);
+		console.error(`\n❌ Failed to build index: ${msg}\n`);
 	}
 	const landingPage = React.createElement(IndexPage);
 	const landingFavicon = docuConfig.meta?.favicon || "/docs/assets/images/favicon.ico";
@@ -421,4 +422,4 @@ async function runBuildCli() {
 //#endregion
 export { runBuildCli as n, runBuild as t };
 
-//# sourceMappingURL=build.impl-Bz_p421t.js.map
+//# sourceMappingURL=build.impl-CT-YLyLn.js.map

package/.docu/lib/build.impl-CT-YLyLn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.impl-CT-YLyLn.js","names":[],"sources":["../node/types.ts","../node/seo.ts","../node/build.impl.ts"],"sourcesContent":["import type { ThemeConfig } from \"@docubook/themes-colors\";\nimport type { PluginEntry } from \"./plugin\";\n\nexport interface DocuRouteContext {\n  title?: string;\n  icon?: string;\n  description?: string;\n}\n\nexport interface DocuRoute {\n  title: string;\n  href: string;\n  noLink?: boolean;\n  items?: DocuRoute[];\n  context?: DocuRouteContext;\n}\n\nexport interface DocuMeta {\n  title: string;\n  description: string;\n  baseURL: string;\n  favicon?: string;\n  /** Default OG image path (e.g. /docs/assets/images/og.png). Used when page frontmatter has no image. */\n  ogImage?: string;\n}\n\nexport interface SocialLink {\n  name: string;\n  url: string;\n}\n\nexport interface DocuNavbar {\n  logoText: string;\n  logo?: { src?: string; alt?: string };\n  menu: { title: string; href: string }[];\n}\n\nexport interface DocuFooter {\n  social: SocialLink[];\n}\n\nexport interface DocuSidebar {\n  /** How context sections are displayed.\n   *  \"dropdown\" — context switcher dropdown (default)\n   *  \"separator\" — inline group headers in sidebar */\n  context?: \"dropdown\" | \"separator\";\n}\n\nexport interface RepoConfig {\n  url: string;\n  path: string;\n  edit: boolean;\n}\n\nexport interface HeroAction {\n  text: string;\n  link: string;\n  theme?: \"primary\" | \"secondary\" | \"ghost\";\n  icon?: string;\n}\n\nexport interface Hero {\n  tagline?: string;\n  headline: string;\n  description?: string;\n  actions?: HeroAction[];\n}\n\nexport interface HomeFeature {\n  icon?: string;\n  title: string;\n  description: string;\n  link?: string;\n}\n\nexport interface HomeConfig {\n  hero?: Hero;\n  features?: HomeFeature[];\n}\n\nexport interface DocuConfig {\n  meta: DocuMeta;\n  home?: HomeConfig;\n  navbar: DocuNavbar;\n  footer: DocuFooter;\n  repo: RepoConfig;\n  sidebar?: DocuSidebar;\n  routes: DocuRoute[];\n  themes?: {\n    colors: ThemeConfig;\n  };\n  /** List of DocuBook plugins to load. Empty by default — no-op when absent. */\n  plugins?: PluginEntry[];\n}\n\nexport interface BuildCacheEntry {\n  hash: string;\n  mtime: number;\n  builtAt: number;\n}\n\n/** Version stamp stored as `__meta__` — extends entry so the index signature stays valid. */\nexport interface BuildCacheMeta extends BuildCacheEntry {\n  version: number;\n  runtime: string;\n}\n\nexport interface BuildCache {\n  [path: string]: BuildCacheEntry;\n  __meta__?: BuildCacheMeta;\n  __assets__?: BuildCacheEntry;\n  __bundle__?: BuildCacheEntry;\n}\n\n/** Narrow a cache slot to a real page/asset entry (guards `__meta__` shape). */\nexport function isCacheEntry(value: unknown): value is BuildCacheEntry {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Record<string, unknown>;\n  return typeof v.hash === \"string\" && typeof v.mtime === \"number\" && typeof v.builtAt === \"number\";\n}\n\nexport interface CliArgs {\n  force?: boolean;\n  clean?: boolean;\n  ssr?: boolean;\n}\n\nexport interface ParsedDoc {\n  compiledSource: string;\n  frontmatter: Record<string, unknown>;\n  raw: string;\n  scope?: Record<string, unknown>;\n}\n\nexport type { TocItem } from \"@docubook/core\";\n","import type { DocuConfig } from \"./types\";\nimport { frontmatterField } from \"./mdx\";\n\nexport interface SeoMeta {\n  /** Absolute canonical URL */\n  url: string;\n  /** Site name for og:site_name */\n  siteName: string;\n  /** Absolute OG image URL (from frontmatter.image, if set) */\n  image?: string;\n}\n\n/**\n * Build SEO metadata from config and per-page frontmatter.\n * All fields are derived from existing data — no extra config required.\n */\nexport function buildSeoMeta(\n  config: DocuConfig,\n  frontmatter: Record<string, unknown>,\n  slug: string\n): SeoMeta {\n  const baseURL = config.meta?.baseURL?.replace(/\\/+$/, \"\") || \"\";\n  const url = slug ? `${baseURL}/docs/${slug}` : `${baseURL}/`;\n\n  const result: SeoMeta = {\n    url,\n    siteName: config.meta?.title || \"\",\n  };\n\n  // Per-page image from frontmatter, fallback to global default from config\n  const image = frontmatterField(frontmatter, \"image\") || config.meta?.ogImage;\n  if (image) {\n    // Resolve using URL constructor — handles absolute, root-relative, and relative paths\n    try {\n      result.image = new URL(image, image.startsWith(\"/\") ? baseURL : `${baseURL}/docs/`).href;\n    } catch {\n      result.image = image;\n    }\n  }\n\n  return result;\n}\n","/**\n * Runtime-neutral static build — mirror of `build.ts` (Bun-only via its\n * transitive imports, protected) with the Bun-coupled modules swapped for\n * their neutral counterparts: `html.shared` (pure escaping) and\n * `hydrate.node` (esbuild client bundling). Everything else is identical.\n * The Node/Deno build entries call `runBuildCli()`.\n */\n\nimport { readFile, writeFile, mkdir, readdir, copyFile, rename, unlink } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { createHash } from \"node:crypto\";\nimport { join, dirname } from \"node:path\";\nimport React from \"react\";\nimport { renderToString } from \"react-dom/server\";\nimport {\n  compileMdx,\n  compileMdxModule,\n  frontmatterField,\n  getGitLastModifiedBatch,\n  getPageContent,\n  getPageFrontmatter,\n  getPageStripped,\n  registerPageContent,\n} from \"./mdx\";\nimport {\n  DOCS_DIR,\n  DIST_DIR,\n  ASSETS_DIR,\n  CACHE_FILE,\n  DOCS_ASSETS_DIR,\n  PROJECT_ROOT,\n  loadDocuConfig,\n} from \"./paths\";\nimport { htmlShell } from \"./html.shared\";\nimport { generateSearchIndex } from \"./search-indexer\";\nimport { buildClientBundle, computeInlineThemeCss } from \"./hydrate.node\";\nimport { logger } from \"./logger\";\nimport { initSentry, captureException } from \"./sentry\";\nimport { loadPlugins } from \"./plugin-loader\";\nimport { BuildPluginBuilder } from \"./plugin-builder\";\nimport { scanMdxFiles, resolveDocsIndexSource, DEFAULT_FAVICON } from \"./utils\";\nimport type { BuildCache, BuildCacheMeta, CliArgs } from \"./types\";\nimport { isCacheEntry } from \"./types\";\nimport {\n  BUILD_CACHE_VERSION,\n  atomicWriteFile,\n  hashMdxSources,\n  hookMemoryPressure,\n  runtimeStamp,\n} from \"./cache-key\";\nimport { clearDerivedPageCaches } from \"./mdx\";\nimport { generateNonce, cspHeader } from \"./security\";\nimport type { PageMeta, PageContext } from \"./plugin\";\nimport { buildSeoMeta } from \"./seo\";\nimport DocsPage from \"../pages/docs/[[...slug]]\";\nimport IndexPage from \"../pages/index\";\nimport NotFoundPage from \"../pages/404\";\nimport { DocsLayout } from \"../components/DocsLayout\";\n\nfunction parseArgs(): CliArgs {\n  const args = process.argv.slice(2);\n  return {\n    force: args.includes(\"--force\") || args.includes(\"-f\"),\n    clean: args.includes(\"--clean\") || args.includes(\"-c\"),\n  };\n}\n\nfunction hashContent(content: string): string {\n  return createHash(\"sha256\").update(content).digest(\"hex\").slice(0, 16);\n}\n\nasync function readCache(): Promise<BuildCache> {\n  try {\n    if (existsSync(CACHE_FILE)) {\n      const data = await readFile(CACHE_FILE, \"utf-8\");\n      const parsed = JSON.parse(data) as BuildCache;\n      const meta = parsed.__meta__ as BuildCacheMeta | undefined;\n      if (!meta || meta.version !== BUILD_CACHE_VERSION || meta.runtime !== runtimeStamp()) {\n        return {};\n      }\n      return parsed;\n    }\n  } catch (err) {\n    console.error(\"Failed to load build cache:\", (err as Error).message);\n  }\n  return {};\n}\n\nfunction stampCache(cache: BuildCache): void {\n  cache.__meta__ = {\n    hash: `${BUILD_CACHE_VERSION}:${runtimeStamp()}`,\n    mtime: 0,\n    builtAt: Date.now(),\n    version: BUILD_CACHE_VERSION,\n    runtime: runtimeStamp(),\n  };\n}\n\nasync function writeCache(cache: BuildCache): Promise<void> {\n  stampCache(cache);\n  await atomicWriteFile(writeFile, rename, unlink, CACHE_FILE, JSON.stringify(cache, null, 2));\n}\n\nfunction parseConcurrency(): number {\n  return Math.max(1, parseInt(process.env.BUILD_CONCURRENCY || \"4\", 10) || 4);\n}\n\ntype RebuildDecision = \"yes\" | \"hash_check\" | \"no\";\n\nfunction shouldRebuild(path: string, mtime: number, cache: BuildCache): RebuildDecision {\n  const cached = cache[path];\n  if (!isCacheEntry(cached)) return \"yes\";\n  // Any mtime drift vs the recorded one — a newer edit, or mtime moving\n  // backwards (rsync -a, cp -p, snapshot restore) — falls through to the\n  // hash check: hashing an unchanged file is cheap, serving a stale page\n  // is not. Only an untouched mtime skips without reading the file.\n  if (mtime !== cached.mtime) return \"hash_check\";\n  return \"no\";\n}\n\nlet assetManifest = { js: \"client.js\", css: \"client.css\" };\n\n/**\n * Reuse manifest.json on bundle cache hit; fall back to a full rebuild\n * when the manifest is missing or malformed.\n */\nasync function resolveAssetManifest(\n  bundleHit: boolean,\n  mdxSources: Record<string, string>\n): Promise<{ js: string; css: string }> {\n  if (!bundleHit) return buildClientBundle(mdxSources);\n  try {\n    const manifest = JSON.parse(await readFile(join(ASSETS_DIR, \"manifest.json\"), \"utf-8\")) as {\n      js?: string;\n      css?: string;\n    };\n    if (typeof manifest.js === \"string\" && typeof manifest.css === \"string\") {\n      return { js: manifest.js, css: manifest.css };\n    }\n  } catch {\n    // corrupt/missing manifest — rebuild below\n  }\n  return buildClientBundle(mdxSources);\n}\n\nlet inlineThemeCss: string | undefined;\n\nasync function renderDocsPage(\n  docuConfig: ReturnType<typeof loadDocuConfig>,\n  slug: string,\n  rawMdx: string,\n  filePath: string,\n  gitDates?: Map<string, string>,\n  builder?: BuildPluginBuilder | null,\n  nonce?: string\n): Promise<string> {\n  let content = rawMdx;\n  if (builder) {\n    const transformed = await builder.runOnLoad(filePath, content);\n    if (transformed?.contents) {\n      content = transformed.contents;\n    }\n  }\n\n  let result;\n  try {\n    const remarkPlugins = builder?.collectRemarkPlugins();\n    const rehypePlugins = builder?.collectRehypePlugins();\n    // Parse-once: reuse the prePass frontmatter + stripped content so the\n    // SSR phase does not re-extract them. Only when the prePass actually\n    // registered them — otherwise compileMdx does its own extraction.\n    const preFm = getPageFrontmatter(`/${slug}`);\n    const preStripped = getPageStripped(`/${slug}`);\n    const pre =\n      preFm !== undefined && preStripped !== undefined\n        ? { frontmatter: preFm, strippedContent: preStripped }\n        : undefined;\n    result = await compileMdx(\n      content,\n      filePath,\n      gitDates,\n      remarkPlugins,\n      rehypePlugins,\n      undefined,\n      pre\n    );\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : \"Unknown MDX error\";\n    throw new Error(`MDX Error in: docs/${slug}.mdx\\n${msg}`, { cause: err });\n  }\n\n  let frontmatter = result.frontmatter as Record<string, unknown>;\n  if (builder) {\n    frontmatter = await builder.runTransformFrontmatterChain(frontmatter, {\n      slug,\n      filePath,\n      content,\n    });\n  }\n\n  const title = frontmatterField(frontmatter, \"title\") || slug || \"Docs\";\n  const description = frontmatterField(frontmatter, \"description\");\n  const slugParts = slug ? slug.split(\"/\") : [];\n\n  const page = React.createElement(\n    DocsLayout,\n    { repoUrl: docuConfig.repo?.url },\n    React.createElement(DocsPage, {\n      slug: slugParts,\n      title,\n      description,\n      date: frontmatterField(frontmatter, \"date\") || undefined,\n      // Render MDX content as its own root: client hydrates the island as a\n      // separate root, so SSR must be root-relative too or useId-based ids\n      // (mdx-compiler components) mismatch during hydration.\n      content: renderToString(result.content),\n      tocs: result.tocs,\n      filePath,\n      repoUrl: docuConfig.repo?.url,\n      mdxSlug: slug,\n    })\n  );\n\n  const body = renderToString(page);\n\n  const ctx: PageContext = { slug, filePath, frontmatter, content, config: docuConfig };\n  const headExtra = builder?.collectHead(ctx);\n  const bodyExtra = builder?.collectBody(ctx);\n\n  const depth = slug ? slug.split(\"/\").length : 1;\n  const favicon = docuConfig.meta?.favicon || DEFAULT_FAVICON;\n  const seo = buildSeoMeta(docuConfig, frontmatter, slug || \"\");\n  // MDX content hydrates from the bundled ESM module (mdx-hydrate), not\n  // new Function — no 'unsafe-eval' needed in the CSP.\n  const csp = nonce ? cspHeader(nonce) : undefined;\n  let html = htmlShell({\n    title,\n    description,\n    body,\n    favicon,\n    seo,\n    csp,\n    css: assetManifest.css,\n    js: assetManifest.js,\n    nonce,\n    themeCss: inlineThemeCss,\n    depth,\n    headExtra,\n    bodyExtra,\n  });\n\n  if (builder) {\n    html = await builder.runTransformHtmlChain(html, ctx);\n  }\n\n  return html;\n}\n\nasync function copyDirectoryRecursive(src: string, dest: string): Promise<void> {\n  if (!existsSync(src)) return;\n  await mkdir(dest, { recursive: true });\n  const entries = await readdir(src, { withFileTypes: true });\n  for (const entry of entries) {\n    const srcPath = join(src, entry.name);\n    const destPath = join(dest, entry.name);\n    if (entry.isDirectory()) {\n      await copyDirectoryRecursive(srcPath, destPath);\n    } else {\n      await copyFile(srcPath, destPath);\n    }\n  }\n}\n\nexport async function runBuild(): Promise<void> {\n  const docuConfig = loadDocuConfig();\n  const args = parseArgs();\n\n  hookMemoryPressure(clearDerivedPageCaches);\n\n  logger.buildStart();\n\n  if (args.clean) {\n    const { rm } = await import(\"node:fs/promises\");\n    try {\n      await rm(DIST_DIR, { recursive: true, force: true });\n    } catch (err) {\n      console.error(\"Failed to clean dist directory:\", (err as Error).message);\n    }\n  }\n\n  await mkdir(DIST_DIR, { recursive: true });\n  await mkdir(ASSETS_DIR, { recursive: true });\n\n  await copyDirectoryRecursive(DOCS_ASSETS_DIR, join(DIST_DIR, \"docs\", \"assets\"));\n\n  const mdxFiles = await scanMdxFiles(DOCS_DIR);\n  const cache = args.force ? {} : await readCache();\n  let built = 0;\n  let skipped = 0;\n\n  const pluginsConfig = docuConfig.plugins ?? [];\n  const builder = pluginsConfig.length > 0 ? new BuildPluginBuilder(docuConfig) : null;\n  if (builder) {\n    const plugins = await loadPlugins(pluginsConfig);\n    for (const plugin of plugins) {\n      await plugin.setup(builder);\n    }\n    await builder.runOnStart();\n  }\n\n  // Pre-compile every page's MDX to an ESM module (program format) so the\n  // client bundle can hydrate the content island statically — no new Function.\n  // Mirrors the page loop's transform + plugin chain so SSR and client trees\n  // match. Runs for all files regardless of cache; the bundle is shared by\n  // every page, so a content change invalidates the page cache anyway.\n  const mdxSources: Record<string, string> = {};\n  const prePassTasks = mdxFiles.map(async (file) => {\n    let raw: string;\n    try {\n      raw = await readFile(file.absPath, \"utf-8\");\n    } catch {\n      return;\n    }\n    // Cache the original content so the page loop does not re-read the file\n    // (one disk read per file — the frontmatter is parsed once here too).\n    registerPageContent(`/${file.path}`, raw);\n    let content = raw;\n    if (builder) {\n      const relPath = file.absPath.replace(PROJECT_ROOT + \"/\", \"\");\n      const transformed = await builder.runOnLoad(relPath, content);\n      if (transformed?.contents) content = transformed.contents;\n    }\n    const remarkPlugins = builder?.collectRemarkPlugins();\n    const rehypePlugins = builder?.collectRehypePlugins();\n    mdxSources[file.path] = await compileMdxModule(\n      content,\n      remarkPlugins,\n      rehypePlugins,\n      `/${file.path}`\n    );\n  });\n  await Promise.all(prePassTasks);\n\n  // The docs root (index.mdx, or index.md) renders with slug \"\" — mirror that\n  // key so the index page hydrates too. Its render has its own try/catch; skip\n  // on error.\n  const indexSource = resolveDocsIndexSource(DOCS_DIR);\n  if (indexSource) {\n    try {\n      const indexRaw = await readFile(indexSource, \"utf-8\");\n      let indexContent = indexRaw;\n      if (builder) {\n        const relPath = indexSource.replace(PROJECT_ROOT + \"/\", \"\");\n        const transformed = await builder.runOnLoad(relPath, indexContent);\n        if (transformed?.contents) indexContent = transformed.contents;\n      }\n      mdxSources[\"\"] = await compileMdxModule(\n        indexContent,\n        builder?.collectRemarkPlugins(),\n        builder?.collectRehypePlugins()\n      );\n    } catch {\n      // ignore — the index render reports its own error\n    }\n  }\n\n  logger.bundleStart();\n  let t = performance.now();\n  const bundleHash = hashMdxSources(mdxSources);\n  const lastBundle = cache[\"__bundle__\"];\n  const bundleHit =\n    isCacheEntry(lastBundle) &&\n    lastBundle.hash === bundleHash &&\n    existsSync(join(ASSETS_DIR, \"manifest.json\"));\n  assetManifest = await resolveAssetManifest(bundleHit, mdxSources);\n  logger.bundleDone(Math.round(performance.now() - t));\n\n  inlineThemeCss = computeInlineThemeCss();\n\n  const lastManifest = cache[\"__assets__\"];\n  const assetsChanged =\n    !isCacheEntry(lastManifest) || lastManifest.hash !== `${assetManifest.js}:${assetManifest.css}`;\n  if (assetsChanged) {\n    cache[\"__assets__\"] = {\n      hash: `${assetManifest.js}:${assetManifest.css}`,\n      mtime: 0,\n      builtAt: Date.now(),\n    };\n  }\n  if (!bundleHit) {\n    cache[\"__bundle__\"] = { hash: bundleHash, mtime: 0, builtAt: Date.now() };\n  }\n\n  logger.spinner.start(\"Building pages...\");\n  t = performance.now();\n\n  const allRelPaths = mdxFiles.map((f) => f.absPath.replace(PROJECT_ROOT + \"/\", \"\"));\n\n  if (indexSource) {\n    allRelPaths.push(indexSource.replace(PROJECT_ROOT + \"/\", \"\"));\n  }\n  const gitDates = await getGitLastModifiedBatch(allRelPaths);\n\n  const CONCURRENCY = parseConcurrency();\n  const buildTasks = [];\n  const errors: string[] = [];\n\n  for (const file of mdxFiles) {\n    const rebuildDecision = shouldRebuild(file.path, file.mtime, cache);\n\n    if (rebuildDecision === \"no\") {\n      const outputPath = join(DIST_DIR, \"docs\", `${file.path}.html`);\n      if (existsSync(outputPath) && !assetsChanged) {\n        skipped++;\n        continue;\n      }\n    }\n\n    let rawMdx = getPageContent(`/${file.path}`);\n    if (rawMdx === undefined) {\n      try {\n        rawMdx = await readFile(file.absPath, \"utf-8\");\n      } catch (err) {\n        if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n        continue;\n      }\n    }\n\n    if (rebuildDecision === \"hash_check\") {\n      const contentHash = hashContent(rawMdx);\n      const cached = cache[file.path];\n      if (isCacheEntry(cached) && cached.hash === contentHash) {\n        if (!assetsChanged) {\n          const outputPath = join(DIST_DIR, \"docs\", `${file.path}.html`);\n          if (existsSync(outputPath)) {\n            cache[file.path] = { ...cached, mtime: file.mtime, builtAt: Date.now() };\n            skipped++;\n            continue;\n          }\n        }\n      }\n    }\n\n    const relPath = file.absPath.replace(PROJECT_ROOT + \"/\", \"\");\n    const capturedRawMdx = rawMdx;\n    const capturedFile = file;\n\n    buildTasks.push(async () => {\n      try {\n        const pageNonce = generateNonce();\n        const html = await renderDocsPage(\n          docuConfig,\n          capturedFile.path,\n          capturedRawMdx,\n          relPath,\n          gitDates,\n          builder,\n          pageNonce\n        );\n        const outputPath = join(DIST_DIR, \"docs\", `${capturedFile.path}.html`);\n        await mkdir(dirname(outputPath), { recursive: true });\n        await writeFile(outputPath, html);\n        cache[capturedFile.path] = {\n          hash: hashContent(capturedRawMdx),\n          mtime: capturedFile.mtime,\n          builtAt: Date.now(),\n        };\n        built++;\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        errors.push(msg);\n        console.error(`\\n\\u274C ${msg}\\n`);\n      }\n    });\n  }\n\n  for (let i = 0; i < buildTasks.length; i += CONCURRENCY) {\n    await Promise.all(buildTasks.slice(i, i + CONCURRENCY).map((fn) => fn()));\n  }\n\n  if (indexSource) {\n    try {\n      const indexRaw = await readFile(indexSource, \"utf-8\");\n      const indexRelPath = indexSource.replace(PROJECT_ROOT + \"/\", \"\");\n      const indexHtml = await renderDocsPage(\n        docuConfig,\n        \"\",\n        indexRaw,\n        indexRelPath,\n        gitDates,\n        builder,\n        generateNonce()\n      );\n      await mkdir(join(DIST_DIR, \"docs\"), { recursive: true });\n      await writeFile(join(DIST_DIR, \"docs\", \"index.html\"), indexHtml);\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      errors.push(`index: ${msg}`);\n      console.error(`\\n❌ Failed to build index: ${msg}\\n`);\n    }\n  } else {\n    const msg = \"docs root index: docs/index.mdx (or docs/index.md) not found\";\n    errors.push(`index: ${msg}`);\n    console.error(`\\n❌ Failed to build index: ${msg}\\n`);\n  }\n\n  const landingPage = React.createElement(IndexPage);\n  const landingFavicon = docuConfig.meta?.favicon || DEFAULT_FAVICON;\n  const landingSeo = buildSeoMeta(\n    docuConfig,\n    docuConfig.meta as unknown as Record<string, unknown>,\n    \"\"\n  );\n  const landingNonce = generateNonce();\n  const landingHtml = htmlShell({\n    title: docuConfig.meta?.title || \"DocuBook\",\n    description: docuConfig.meta?.description || \"\",\n    body: renderToString(landingPage),\n    favicon: landingFavicon,\n    seo: landingSeo,\n    csp: cspHeader(landingNonce),\n    css: assetManifest.css,\n    js: assetManifest.js,\n    nonce: landingNonce,\n    themeCss: inlineThemeCss,\n  });\n  await writeFile(join(DIST_DIR, \"index.html\"), landingHtml);\n\n  const notFoundPage = React.createElement(\n    DocsLayout,\n    { repoUrl: docuConfig.repo?.url },\n    React.createElement(NotFoundPage)\n  );\n  const notFoundFavicon = docuConfig.meta?.favicon || DEFAULT_FAVICON;\n  const notFoundNonce = generateNonce();\n  const notFoundHtml = htmlShell({\n    title: \"404 - Not Found\",\n    description: \"\",\n    body: renderToString(notFoundPage),\n    favicon: notFoundFavicon,\n    headExtra: ['<meta name=\"robots\" content=\"noindex,follow\">'],\n    csp: cspHeader(notFoundNonce),\n    css: assetManifest.css,\n    js: assetManifest.js,\n    nonce: notFoundNonce,\n    themeCss: inlineThemeCss,\n    // Served as the static-host fallback at ANY requested path — relative\n    // depth can never be right there, so use root-absolute asset URLs.\n    absoluteAssets: true,\n  });\n  await writeFile(join(DIST_DIR, \"404.html\"), notFoundHtml);\n\n  logger.spinner.stop(\n    `Built ${built} pages (${skipped} cached) \\x1b[90m(${Math.round(performance.now() - t)}ms)\\x1b[0m`\n  );\n\n  if (builder) {\n    const pages: PageMeta[] = mdxFiles.map((f) => ({\n      slug: f.path,\n      title: f.path.split(\"/\").pop() || f.path,\n      filePath: join(DOCS_DIR, f.path),\n      outputPath: join(DIST_DIR, \"docs\", `${f.path}.html`),\n    }));\n    await builder.runOnEnd(pages);\n  }\n\n  logger.indexStart();\n  t = performance.now();\n  // No content changed (all pages cached) → the aggregated index is\n  // unchanged too; reuse the existing file instead of regenerating it.\n  const indexSkipped = built === 0 && existsSync(join(ASSETS_DIR, \"search-index.json\"));\n  const indexCount = indexSkipped ? 0 : await generateSearchIndex();\n  logger.indexDone(indexCount, Math.round(performance.now() - t), indexSkipped);\n\n  logger.routes();\n\n  await writeCache(cache);\n\n  if (errors.length > 0) {\n    console.error(`\\n\\u274C Build completed with ${errors.length} error(s)\\n`);\n    process.exit(1);\n  }\n}\n\nexport async function runBuildCli(): Promise<void> {\n  try {\n    await initSentry();\n    await runBuild();\n  } catch (err) {\n    captureException(err);\n    console.error(\"Build failed:\", err);\n    process.exit(1);\n  }\n}\n"],"mappings":"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"}

package/.docu/lib/build.impl-cJPJeQ8r.js

@@ -0,0 +1,2 @@
+import { n as runBuildCli } from "./build.impl-CT-YLyLn.js";
+export { runBuildCli };

package/.docu/lib/build.node.js

@@ -1,4 +1,4 @@
-import { n as runBuildCli } from "./build.impl-Bz_p421t.js";
+import { n as runBuildCli } from "./build.impl-CT-YLyLn.js";
 //#region .docu/node/build.node.ts
 await runBuildCli();
 //#endregion

package/.docu/lib/clean.js

@@ -1,4 +1,4 @@
-import { t as logger } from "./logger-CQyNTE6L.js";
+import { t as logger } from "./logger-Cz0CPMi8.js";
 import { existsSync } from "node:fs";
 import { rm } from "node:fs/promises";
 //#region .docu/node/clean.ts

package/.docu/lib/deploy.deno.js

@@ -1,4 +1,4 @@
-import { t as runDeploy } from "./deploy.shared-fk8eM-r4.js";
+import { t as runDeploy } from "./deploy.shared-CmOzm3b5.js";
 //#region .docu/node/deploy.deno.ts
 try {
 	await runDeploy();

package/.docu/lib/deploy.node.js

@@ -1,4 +1,4 @@
-import { t as runDeploy } from "./deploy.shared-fk8eM-r4.js";
+import { t as runDeploy } from "./deploy.shared-CmOzm3b5.js";
 //#region .docu/node/deploy.node.ts
 runDeploy().catch((err) => {
 	console.error("Deploy failed:", err);

package/.docu/lib/{deploy.shared-fk8eM-r4.js → deploy.shared-CmOzm3b5.js}

@@ -135,7 +135,7 @@ async function runBuild() {
 		process.env.FLAME_BUILD_SILENT = "1";
 		process.env.LOG_LEVEL = "error";
 	}
-	const { runBuildCli } = await import("./build.impl-CtPrlYAE.js");
+	const { runBuildCli } = await import("./build.impl-cJPJeQ8r.js");
 	await runBuildCli();
 }
 async function writeDockerFiles() {
@@ -292,4 +292,4 @@ async function runDeploy() {
 //#endregion
 export { runDeploy as t };
 
-//# sourceMappingURL=deploy.shared-fk8eM-r4.js.map
+//# sourceMappingURL=deploy.shared-CmOzm3b5.js.map

package/.docu/lib/{deploy.shared-fk8eM-r4.js.map → deploy.shared-CmOzm3b5.js.map}

@@ -1 +1 @@
-{"version":3,"file":"deploy.shared-fk8eM-r4.js","names":[],"sources":["../node/deploy.shared.ts"],"sourcesContent":["/**\n * Runtime-neutral deploy — 3 modes:\n *   1. `flame deploy`           → build + generate GitHub Actions workflow\n *   2. `flame deploy --docker`  → build + generate Docker deployment files\n *   3. `flame deploy --docker --silent` → same as #2, minimal output\n *\n * Mirror of deploy.ts (Bun-only, protected) for Node.js and Deno.\n * Runs the neutral build in-process, then prepares .docu/dist.\n */\n\nimport { writeFile, mkdir } from \"node:fs/promises\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { DIST_DIR, PROJECT_ROOT, FRAMEWORK_ROOT } from \"./paths\";\n\nconst FLAME_MAJOR = JSON.parse(\n  readFileSync(resolve(FRAMEWORK_ROOT, \"package.json\"), \"utf-8\")\n).version.split(\".\")[0];\n\nconst WORKFLOW_DIR = join(PROJECT_ROOT, \".github/workflows\");\nconst WORKFLOW_FILE = join(WORKFLOW_DIR, \"deploy.yml\");\n\nexport const NGINX_CONF = `server {\n  listen 80;\n  server_name _;\n  root /usr/share/nginx/html;\n  index index.html;\n\n  gzip on;\n  gzip_types text/html text/css application/javascript image/svg+xml;\n\n  # Security headers (HSTS effective when HTTPS is terminated upstream)\n  add_header X-Frame-Options \"DENY\" always;\n  add_header X-Content-Type-Options \"nosniff\" always;\n  add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains\" always;\n  add_header Referrer-Policy \"strict-origin-when-cross-origin\" always;\n  add_header Permissions-Policy \"camera=(), microphone=(), geolocation=()\" always;\n  add_header Content-Security-Policy \"default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\" always;\n\n  location /assets/ {\n    expires 1y;\n    add_header Cache-Control \"public, immutable\";\n    add_header X-Frame-Options \"DENY\" always;\n    add_header X-Content-Type-Options \"nosniff\" always;\n    add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains\" always;\n    add_header Referrer-Policy \"strict-origin-when-cross-origin\" always;\n    add_header Permissions-Policy \"camera=(), microphone=(), geolocation=()\" always;\n    add_header Content-Security-Policy \"default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\" always;\n  }\n\n  location /docs/assets/ {\n    expires 7d;\n    add_header Cache-Control \"public\";\n    add_header X-Frame-Options \"DENY\" always;\n    add_header X-Content-Type-Options \"nosniff\" always;\n    add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains\" always;\n    add_header Referrer-Policy \"strict-origin-when-cross-origin\" always;\n    add_header Permissions-Policy \"camera=(), microphone=(), geolocation=()\" always;\n    add_header Content-Security-Policy \"default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\" always;\n  }\n\n  location / {\n    try_files $uri $uri.html $uri/ =404;\n  }\n}\n`;\n\nexport const DOCKERIGNORE = `node_modules\n*.DS_Store\n.docu/dist\n.docu/lib\n.env\n.env.*\n.npmrc\n*.log\n`;\n\nexport function detectPkgManager(dir: string): {\n  baseImage: string;\n  lockFile: string;\n  installCmd: string;\n  runCmd: string;\n  cache: string;\n  setupAction: string;\n} {\n  const bunLockFile = existsSync(join(dir, \"bun.lock\"))\n    ? \"bun.lock\"\n    : existsSync(join(dir, \"bun.lockb\"))\n      ? \"bun.lockb\"\n      : null;\n  if (bunLockFile) {\n    return {\n      baseImage: \"oven/bun:1-debian\",\n      lockFile: bunLockFile,\n      installCmd: \"bun install --frozen-lockfile\",\n      runCmd: \"bun\",\n      cache: \"\",\n      setupAction: \"bun\",\n    };\n  }\n  if (existsSync(join(dir, \"pnpm-lock.yaml\"))) {\n    return {\n      baseImage: \"node:22-alpine\",\n      lockFile: \"pnpm-lock.yaml\",\n      installCmd: \"corepack enable && pnpm install --frozen-lockfile\",\n      runCmd: \"pnpm\",\n      cache: \"pnpm\",\n      setupAction: \"pnpm\",\n    };\n  }\n  if (existsSync(join(dir, \"yarn.lock\"))) {\n    return {\n      baseImage: \"node:22-alpine\",\n      lockFile: \"yarn.lock\",\n      installCmd: \"yarn install --frozen-lockfile\",\n      runCmd: \"yarn\",\n      cache: \"yarn\",\n      setupAction: \"node\",\n    };\n  }\n  // default: npm\n  return {\n    baseImage: \"node:22-alpine\",\n    lockFile: \"package-lock.json\",\n    installCmd: \"npm ci\",\n    runCmd: \"npm\",\n    cache: \"npm\",\n    setupAction: \"node\",\n  };\n}\n\nexport const HEADERS_FILE = `/*\n  X-Frame-Options: DENY\n  X-Content-Type-Options: nosniff\n  Strict-Transport-Security: max-age=63072000; includeSubDomains; preload\n  Referrer-Policy: strict-origin-when-cross-origin\n  Permissions-Policy: camera=(), microphone=(), geolocation=()\n  Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\n\n/assets/*\n  Cache-Control: public, max-age=31536000, immutable\n`;\n\nconst isDocker = !!process.env.FLAME_DEPLOY_DOCKER;\nconst isSilent = !!process.env.FLAME_DEPLOY_SILENT;\nconst isCi = !!process.env.FLAME_DEPLOY_CI;\n\n/** Logger that no-ops all non-error output in silent mode. */\nconst log = isSilent\n  ? { info: () => {}, ok: () => {}, created: () => {}, out: () => {} }\n  : {\n      info: (m: string) => console.log(m),\n      ok: () => console.log(\"\\n✅ Ready to deploy!\"),\n      created: (m: string) => console.log(m),\n      out: (m: string) => console.log(m),\n    };\n\nasync function runBuild() {\n  process.env.NODE_ENV = \"production\";\n  if (isSilent) {\n    process.env.FLAME_BUILD_SILENT = \"1\";\n    process.env.LOG_LEVEL = \"error\";\n  }\n  const { runBuildCli } = await import(\"./build.impl\");\n  await runBuildCli();\n}\n\nasync function writeDockerFiles() {\n  const dockerDir = PROJECT_ROOT;\n\n  if (!existsSync(join(dockerDir, \"Dockerfile\"))) {\n    await writeFile(\n      join(dockerDir, \"Dockerfile\"),\n      `FROM ghcr.io/docubook/flame:${FLAME_MAJOR} AS builder\nENV NODE_ENV=production\nWORKDIR /app\nCOPY . .\nRUN flame build\n\nFROM nginx:alpine\nCOPY --from=builder /app/.docu/dist /usr/share/nginx/html\nCOPY nginx.conf /etc/nginx/conf.d/default.conf\nEXPOSE 80\nCMD [\"nginx\", \"-g\", \"daemon off;\"]\n`\n    );\n    log.created(\"📄 Created Dockerfile\");\n  }\n\n  if (!existsSync(join(dockerDir, \"nginx.conf\"))) {\n    await writeFile(join(dockerDir, \"nginx.conf\"), NGINX_CONF);\n    log.created(\"📄 Created nginx.conf\");\n  }\n\n  if (!existsSync(join(dockerDir, \".dockerignore\"))) {\n    await writeFile(join(dockerDir, \".dockerignore\"), DOCKERIGNORE);\n    log.created(\"📄 Created .dockerignore\");\n  }\n}\n\nfunction generateWorkflowYml(): string {\n  const pm = detectPkgManager(PROJECT_ROOT);\n\n  const setupSteps: string[] = [\n    \"      - uses: actions/checkout@v7\",\n    \"        with:\",\n    \"          fetch-depth: 0\",\n    \"\",\n  ];\n\n  if (pm.setupAction === \"bun\") {\n    setupSteps.push(\n      \"      - uses: oven-sh/setup-bun@v2\",\n      \"        with:\",\n      \"          bun-version: latest\",\n      \"\"\n    );\n  } else if (pm.setupAction === \"pnpm\") {\n    setupSteps.push(\n      \"      - uses: pnpm/action-setup@v6\",\n      \"\",\n      \"      - uses: actions/setup-node@v6\",\n      \"        with:\",\n      \"          node-version: 22\",\n      `          cache: ${pm.cache}`,\n      \"\"\n    );\n  } else {\n    // npm / yarn\n    setupSteps.push(\n      \"      - uses: actions/setup-node@v6\",\n      \"        with:\",\n      \"          node-version: 22\",\n      `          cache: ${pm.cache}`,\n      \"\"\n    );\n  }\n\n  return [\n    `name: Deploy to GitHub Pages`,\n    \"\",\n    \"on:\",\n    \"  push:\",\n    \"    branches: [main]\",\n    \"  workflow_dispatch:\",\n    \"\",\n    \"permissions:\",\n    \"  contents: read\",\n    \"  pages: write\",\n    \"  id-token: write\",\n    \"\",\n    \"concurrency:\",\n    '  group: \"pages\"',\n    \"  cancel-in-progress: false\",\n    \"\",\n    \"jobs:\",\n    \"  build:\",\n    \"    runs-on: ubuntu-latest\",\n    \"    steps:\",\n    ...setupSteps,\n    `      - run: ${pm.installCmd}`,\n    \"\",\n    `      - run: ${pm.runCmd} run build`,\n    \"\",\n    \"      - name: Add .nojekyll\",\n    \"        run: touch .docu/dist/.nojekyll\",\n    \"\",\n    \"      - uses: actions/upload-pages-artifact@v3\",\n    \"        with:\",\n    \"          path: .docu/dist\",\n    \"\",\n    \"  deploy:\",\n    \"    environment:\",\n    \"      name: github-pages\",\n    \"      url: ${{ steps.deployment.outputs.page_url }}\",\n    \"    runs-on: ubuntu-latest\",\n    \"    needs: build\",\n    \"    steps:\",\n    \"      - id: deployment\",\n    \"        uses: actions/deploy-pages@v4\",\n  ].join(\"\\n\");\n}\n\nfunction generateDockerWorkflowYml(): string {\n  const imageName = \"ghcr.io/${{ github.repository }}\";\n  return [\n    `name: Build & Push Docker Image`,\n    \"\",\n    \"on:\",\n    \"  push:\",\n    \"    branches: [main]\",\n    \"  workflow_dispatch:\",\n    \"\",\n    \"permissions:\",\n    \"  contents: read\",\n    \"  packages: write\",\n    \"\",\n    \"jobs:\",\n    \"  build:\",\n    \"    runs-on: ubuntu-latest\",\n    \"    steps:\",\n    \"      - uses: actions/checkout@v4\",\n    \"        with:\",\n    \"          fetch-depth: 0\",\n    \"\",\n    \"      - name: Log in to GHCR\",\n    \"        uses: docker/login-action@v3\",\n    \"        with:\",\n    \"          registry: ghcr.io\",\n    \"          username: ${{ github.actor }}\",\n    \"          password: ${{ secrets.GITHUB_TOKEN }}\",\n    \"\",\n    \"      - name: Build & push\",\n    \"        uses: docker/build-push-action@v5\",\n    \"        with:\",\n    \"          context: .\",\n    `          tags: ${imageName}:latest`,\n    \"          push: true\",\n  ].join(\"\\n\");\n}\n\nasync function writeGhaWorkflow() {\n  if (!existsSync(WORKFLOW_FILE)) {\n    await mkdir(WORKFLOW_DIR, { recursive: true });\n    await writeFile(WORKFLOW_FILE, generateWorkflowYml());\n    log.created(\"📄 Created .github/workflows/deploy.yml\");\n  }\n}\n\nconst DOCKER_WORKFLOW_FILE = join(WORKFLOW_DIR, \"deploy-docker.yml\");\n\nasync function writeDockerWorkflow() {\n  if (!existsSync(DOCKER_WORKFLOW_FILE)) {\n    await mkdir(WORKFLOW_DIR, { recursive: true });\n    await writeFile(DOCKER_WORKFLOW_FILE, generateDockerWorkflowYml());\n    log.created(\"📄 Created .github/workflows/deploy-docker.yml\");\n  }\n}\n\nexport async function runDeploy(): Promise<void> {\n  log.info(\"📦 Building for production...\\n\");\n  await runBuild();\n\n  // Common: .nojekyll + _headers\n  await writeFile(join(DIST_DIR, \".nojekyll\"), \"\");\n  await writeFile(join(DIST_DIR, \"_headers\"), HEADERS_FILE);\n\n  if (isDocker) {\n    await writeDockerFiles();\n    if (isCi) await writeDockerWorkflow();\n  } else {\n    await writeGhaWorkflow();\n  }\n\n  log.ok();\n  log.out(\"   Output: .docu/dist/\");\n  if (isDocker) {\n    log.out(\"   Build locally: docker build -t my-docs . && docker run -p 80:80 my-docs\");\n    if (isCi) {\n      log.out(\"   Push to GitHub — CI will build & push Docker image to GHCR\");\n      log.out(\"   Then pull latest image on your hosting platform (Coolify, etc.)\");\n    } else {\n      log.out(\"   For Coolify: connect repo, set build pack to Dockerfile\");\n    }\n  } else {\n    log.out(\"   Push to GitHub and enable Pages (Settings → Pages → Source: GitHub Actions)\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,IAAM,cAAc,KAAK,MACvB,aAAa,QAAQ,gBAAgB,cAAc,GAAG,OAAO,CAC/D,CAAC,CAAC,QAAQ,MAAM,GAAG,CAAC,CAAC;AAErB,IAAM,eAAe,KAAK,cAAc,mBAAmB;AAC3D,IAAM,gBAAgB,KAAK,cAAc,YAAY;AAErD,IAAa,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6C1B,IAAa,eAAe;;;;;;;;;AAU5B,SAAgB,iBAAiB,KAO/B;CACA,MAAM,cAAc,WAAW,KAAK,KAAK,UAAU,CAAC,IAChD,aACA,WAAW,KAAK,KAAK,WAAW,CAAC,IAC/B,cACA;CACN,IAAI,aACF,OAAO;EACL,WAAW;EACX,UAAU;EACV,YAAY;EACZ,QAAQ;EACR,OAAO;EACP,aAAa;CACf;CAEF,IAAI,WAAW,KAAK,KAAK,gBAAgB,CAAC,GACxC,OAAO;EACL,WAAW;EACX,UAAU;EACV,YAAY;EACZ,QAAQ;EACR,OAAO;EACP,aAAa;CACf;CAEF,IAAI,WAAW,KAAK,KAAK,WAAW,CAAC,GACnC,OAAO;EACL,WAAW;EACX,UAAU;EACV,YAAY;EACZ,QAAQ;EACR,OAAO;EACP,aAAa;CACf;CAGF,OAAO;EACL,WAAW;EACX,UAAU;EACV,YAAY;EACZ,QAAQ;EACR,OAAO;EACP,aAAa;CACf;AACF;AAEA,IAAa,eAAe;;;;;;;;;;;AAY5B,IAAM,WAAW,CAAC,CAAC,QAAQ,IAAI;AAC/B,IAAM,WAAW,CAAC,CAAC,QAAQ,IAAI;AAC/B,IAAM,OAAO,CAAC,CAAC,QAAQ,IAAI;;AAG3B,IAAM,MAAM,WACR;CAAE,YAAY,CAAC;CAAG,UAAU,CAAC;CAAG,eAAe,CAAC;CAAG,WAAW,CAAC;AAAE,IACjE;CACE,OAAO,MAAc,QAAQ,IAAI,CAAC;CAClC,UAAU,QAAQ,IAAI,sBAAsB;CAC5C,UAAU,MAAc,QAAQ,IAAI,CAAC;CACrC,MAAM,MAAc,QAAQ,IAAI,CAAC;AACnC;AAEJ,eAAe,WAAW;CACxB,QAAA,IAAA,WAAuB;CACvB,IAAI,UAAU;EACZ,QAAQ,IAAI,qBAAqB;EACjC,QAAQ,IAAI,YAAY;CAC1B;CACA,MAAM,EAAE,gBAAgB,MAAM,OAAO;CACrC,MAAM,YAAY;AACpB;AAEA,eAAe,mBAAmB;CAChC,MAAM,YAAY;CAElB,IAAI,CAAC,WAAW,KAAK,WAAW,YAAY,CAAC,GAAG;EAC9C,MAAM,UACJ,KAAK,WAAW,YAAY,GAC5B,+BAA+B,YAAY;;;;;;;;;;;CAY7C;EACA,IAAI,QAAQ,uBAAuB;CACrC;CAEA,IAAI,CAAC,WAAW,KAAK,WAAW,YAAY,CAAC,GAAG;EAC9C,MAAM,UAAU,KAAK,WAAW,YAAY,GAAG,UAAU;EACzD,IAAI,QAAQ,uBAAuB;CACrC;CAEA,IAAI,CAAC,WAAW,KAAK,WAAW,eAAe,CAAC,GAAG;EACjD,MAAM,UAAU,KAAK,WAAW,eAAe,GAAG,YAAY;EAC9D,IAAI,QAAQ,0BAA0B;CACxC;AACF;AAEA,SAAS,sBAA8B;CACrC,MAAM,KAAK,iBAAiB,YAAY;CAExC,MAAM,aAAuB;EAC3B;EACA;EACA;EACA;CACF;CAEA,IAAI,GAAG,gBAAgB,OACrB,WAAW,KACT,sCACA,iBACA,iCACA,EACF;MACK,IAAI,GAAG,gBAAgB,QAC5B,WAAW,KACT,sCACA,IACA,uCACA,iBACA,8BACA,oBAAoB,GAAG,SACvB,EACF;MAGA,WAAW,KACT,uCACA,iBACA,8BACA,oBAAoB,GAAG,SACvB,EACF;CAGF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,GAAG;EACH,gBAAgB,GAAG;EACnB;EACA,gBAAgB,GAAG,OAAO;EAC1B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,SAAS,4BAAoC;CAE3C,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,eAAe,mBAAmB;CAChC,IAAI,CAAC,WAAW,aAAa,GAAG;EAC9B,MAAM,MAAM,cAAc,EAAE,WAAW,KAAK,CAAC;EAC7C,MAAM,UAAU,eAAe,oBAAoB,CAAC;EACpD,IAAI,QAAQ,yCAAyC;CACvD;AACF;AAEA,IAAM,uBAAuB,KAAK,cAAc,mBAAmB;AAEnE,eAAe,sBAAsB;CACnC,IAAI,CAAC,WAAW,oBAAoB,GAAG;EACrC,MAAM,MAAM,cAAc,EAAE,WAAW,KAAK,CAAC;EAC7C,MAAM,UAAU,sBAAsB,0BAA0B,CAAC;EACjE,IAAI,QAAQ,gDAAgD;CAC9D;AACF;AAEA,eAAsB,YAA2B;CAC/C,IAAI,KAAK,iCAAiC;CAC1C,MAAM,SAAS;CAGf,MAAM,UAAU,KAAK,UAAU,WAAW,GAAG,EAAE;CAC/C,MAAM,UAAU,KAAK,UAAU,UAAU,GAAG,YAAY;CAExD,IAAI,UAAU;EACZ,MAAM,iBAAiB;EACvB,IAAI,MAAM,MAAM,oBAAoB;CACtC,OACE,MAAM,iBAAiB;CAGzB,IAAI,GAAG;CACP,IAAI,IAAI,wBAAwB;CAChC,IAAI,UAAU;EACZ,IAAI,IAAI,4EAA4E;EACpF,IAAI,MAAM;GACR,IAAI,IAAI,+DAA+D;GACvE,IAAI,IAAI,oEAAoE;EAC9E,OACE,IAAI,IAAI,4DAA4D;CAExE,OACE,IAAI,IAAI,gFAAgF;AAE5F"}
+{"version":3,"file":"deploy.shared-CmOzm3b5.js","names":[],"sources":["../node/deploy.shared.ts"],"sourcesContent":["/**\n * Runtime-neutral deploy — 3 modes:\n *   1. `flame deploy`           → build + generate GitHub Actions workflow\n *   2. `flame deploy --docker`  → build + generate Docker deployment files\n *   3. `flame deploy --docker --silent` → same as #2, minimal output\n *\n * Mirror of deploy.ts (Bun-only, protected) for Node.js and Deno.\n * Runs the neutral build in-process, then prepares .docu/dist.\n */\n\nimport { writeFile, mkdir } from \"node:fs/promises\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { DIST_DIR, PROJECT_ROOT, FRAMEWORK_ROOT } from \"./paths\";\n\nconst FLAME_MAJOR = JSON.parse(\n  readFileSync(resolve(FRAMEWORK_ROOT, \"package.json\"), \"utf-8\")\n).version.split(\".\")[0];\n\nconst WORKFLOW_DIR = join(PROJECT_ROOT, \".github/workflows\");\nconst WORKFLOW_FILE = join(WORKFLOW_DIR, \"deploy.yml\");\n\nexport const NGINX_CONF = `server {\n  listen 80;\n  server_name _;\n  root /usr/share/nginx/html;\n  index index.html;\n\n  gzip on;\n  gzip_types text/html text/css application/javascript image/svg+xml;\n\n  # Security headers (HSTS effective when HTTPS is terminated upstream)\n  add_header X-Frame-Options \"DENY\" always;\n  add_header X-Content-Type-Options \"nosniff\" always;\n  add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains\" always;\n  add_header Referrer-Policy \"strict-origin-when-cross-origin\" always;\n  add_header Permissions-Policy \"camera=(), microphone=(), geolocation=()\" always;\n  add_header Content-Security-Policy \"default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\" always;\n\n  location /assets/ {\n    expires 1y;\n    add_header Cache-Control \"public, immutable\";\n    add_header X-Frame-Options \"DENY\" always;\n    add_header X-Content-Type-Options \"nosniff\" always;\n    add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains\" always;\n    add_header Referrer-Policy \"strict-origin-when-cross-origin\" always;\n    add_header Permissions-Policy \"camera=(), microphone=(), geolocation=()\" always;\n    add_header Content-Security-Policy \"default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\" always;\n  }\n\n  location /docs/assets/ {\n    expires 7d;\n    add_header Cache-Control \"public\";\n    add_header X-Frame-Options \"DENY\" always;\n    add_header X-Content-Type-Options \"nosniff\" always;\n    add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains\" always;\n    add_header Referrer-Policy \"strict-origin-when-cross-origin\" always;\n    add_header Permissions-Policy \"camera=(), microphone=(), geolocation=()\" always;\n    add_header Content-Security-Policy \"default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\" always;\n  }\n\n  location / {\n    try_files $uri $uri.html $uri/ =404;\n  }\n}\n`;\n\nexport const DOCKERIGNORE = `node_modules\n*.DS_Store\n.docu/dist\n.docu/lib\n.env\n.env.*\n.npmrc\n*.log\n`;\n\nexport function detectPkgManager(dir: string): {\n  baseImage: string;\n  lockFile: string;\n  installCmd: string;\n  runCmd: string;\n  cache: string;\n  setupAction: string;\n} {\n  const bunLockFile = existsSync(join(dir, \"bun.lock\"))\n    ? \"bun.lock\"\n    : existsSync(join(dir, \"bun.lockb\"))\n      ? \"bun.lockb\"\n      : null;\n  if (bunLockFile) {\n    return {\n      baseImage: \"oven/bun:1-debian\",\n      lockFile: bunLockFile,\n      installCmd: \"bun install --frozen-lockfile\",\n      runCmd: \"bun\",\n      cache: \"\",\n      setupAction: \"bun\",\n    };\n  }\n  if (existsSync(join(dir, \"pnpm-lock.yaml\"))) {\n    return {\n      baseImage: \"node:22-alpine\",\n      lockFile: \"pnpm-lock.yaml\",\n      installCmd: \"corepack enable && pnpm install --frozen-lockfile\",\n      runCmd: \"pnpm\",\n      cache: \"pnpm\",\n      setupAction: \"pnpm\",\n    };\n  }\n  if (existsSync(join(dir, \"yarn.lock\"))) {\n    return {\n      baseImage: \"node:22-alpine\",\n      lockFile: \"yarn.lock\",\n      installCmd: \"yarn install --frozen-lockfile\",\n      runCmd: \"yarn\",\n      cache: \"yarn\",\n      setupAction: \"node\",\n    };\n  }\n  // default: npm\n  return {\n    baseImage: \"node:22-alpine\",\n    lockFile: \"package-lock.json\",\n    installCmd: \"npm ci\",\n    runCmd: \"npm\",\n    cache: \"npm\",\n    setupAction: \"node\",\n  };\n}\n\nexport const HEADERS_FILE = `/*\n  X-Frame-Options: DENY\n  X-Content-Type-Options: nosniff\n  Strict-Transport-Security: max-age=63072000; includeSubDomains; preload\n  Referrer-Policy: strict-origin-when-cross-origin\n  Permissions-Policy: camera=(), microphone=(), geolocation=()\n  Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' data:; connect-src 'self' https:; frame-src https://www.youtube-nocookie.com; frame-ancestors 'none'\n\n/assets/*\n  Cache-Control: public, max-age=31536000, immutable\n`;\n\nconst isDocker = !!process.env.FLAME_DEPLOY_DOCKER;\nconst isSilent = !!process.env.FLAME_DEPLOY_SILENT;\nconst isCi = !!process.env.FLAME_DEPLOY_CI;\n\n/** Logger that no-ops all non-error output in silent mode. */\nconst log = isSilent\n  ? { info: () => {}, ok: () => {}, created: () => {}, out: () => {} }\n  : {\n      info: (m: string) => console.log(m),\n      ok: () => console.log(\"\\n✅ Ready to deploy!\"),\n      created: (m: string) => console.log(m),\n      out: (m: string) => console.log(m),\n    };\n\nasync function runBuild() {\n  process.env.NODE_ENV = \"production\";\n  if (isSilent) {\n    process.env.FLAME_BUILD_SILENT = \"1\";\n    process.env.LOG_LEVEL = \"error\";\n  }\n  const { runBuildCli } = await import(\"./build.impl\");\n  await runBuildCli();\n}\n\nasync function writeDockerFiles() {\n  const dockerDir = PROJECT_ROOT;\n\n  if (!existsSync(join(dockerDir, \"Dockerfile\"))) {\n    await writeFile(\n      join(dockerDir, \"Dockerfile\"),\n      `FROM ghcr.io/docubook/flame:${FLAME_MAJOR} AS builder\nENV NODE_ENV=production\nWORKDIR /app\nCOPY . .\nRUN flame build\n\nFROM nginx:alpine\nCOPY --from=builder /app/.docu/dist /usr/share/nginx/html\nCOPY nginx.conf /etc/nginx/conf.d/default.conf\nEXPOSE 80\nCMD [\"nginx\", \"-g\", \"daemon off;\"]\n`\n    );\n    log.created(\"📄 Created Dockerfile\");\n  }\n\n  if (!existsSync(join(dockerDir, \"nginx.conf\"))) {\n    await writeFile(join(dockerDir, \"nginx.conf\"), NGINX_CONF);\n    log.created(\"📄 Created nginx.conf\");\n  }\n\n  if (!existsSync(join(dockerDir, \".dockerignore\"))) {\n    await writeFile(join(dockerDir, \".dockerignore\"), DOCKERIGNORE);\n    log.created(\"📄 Created .dockerignore\");\n  }\n}\n\nfunction generateWorkflowYml(): string {\n  const pm = detectPkgManager(PROJECT_ROOT);\n\n  const setupSteps: string[] = [\n    \"      - uses: actions/checkout@v7\",\n    \"        with:\",\n    \"          fetch-depth: 0\",\n    \"\",\n  ];\n\n  if (pm.setupAction === \"bun\") {\n    setupSteps.push(\n      \"      - uses: oven-sh/setup-bun@v2\",\n      \"        with:\",\n      \"          bun-version: latest\",\n      \"\"\n    );\n  } else if (pm.setupAction === \"pnpm\") {\n    setupSteps.push(\n      \"      - uses: pnpm/action-setup@v6\",\n      \"\",\n      \"      - uses: actions/setup-node@v6\",\n      \"        with:\",\n      \"          node-version: 22\",\n      `          cache: ${pm.cache}`,\n      \"\"\n    );\n  } else {\n    // npm / yarn\n    setupSteps.push(\n      \"      - uses: actions/setup-node@v6\",\n      \"        with:\",\n      \"          node-version: 22\",\n      `          cache: ${pm.cache}`,\n      \"\"\n    );\n  }\n\n  return [\n    `name: Deploy to GitHub Pages`,\n    \"\",\n    \"on:\",\n    \"  push:\",\n    \"    branches: [main]\",\n    \"  workflow_dispatch:\",\n    \"\",\n    \"permissions:\",\n    \"  contents: read\",\n    \"  pages: write\",\n    \"  id-token: write\",\n    \"\",\n    \"concurrency:\",\n    '  group: \"pages\"',\n    \"  cancel-in-progress: false\",\n    \"\",\n    \"jobs:\",\n    \"  build:\",\n    \"    runs-on: ubuntu-latest\",\n    \"    steps:\",\n    ...setupSteps,\n    `      - run: ${pm.installCmd}`,\n    \"\",\n    `      - run: ${pm.runCmd} run build`,\n    \"\",\n    \"      - name: Add .nojekyll\",\n    \"        run: touch .docu/dist/.nojekyll\",\n    \"\",\n    \"      - uses: actions/upload-pages-artifact@v3\",\n    \"        with:\",\n    \"          path: .docu/dist\",\n    \"\",\n    \"  deploy:\",\n    \"    environment:\",\n    \"      name: github-pages\",\n    \"      url: ${{ steps.deployment.outputs.page_url }}\",\n    \"    runs-on: ubuntu-latest\",\n    \"    needs: build\",\n    \"    steps:\",\n    \"      - id: deployment\",\n    \"        uses: actions/deploy-pages@v4\",\n  ].join(\"\\n\");\n}\n\nfunction generateDockerWorkflowYml(): string {\n  const imageName = \"ghcr.io/${{ github.repository }}\";\n  return [\n    `name: Build & Push Docker Image`,\n    \"\",\n    \"on:\",\n    \"  push:\",\n    \"    branches: [main]\",\n    \"  workflow_dispatch:\",\n    \"\",\n    \"permissions:\",\n    \"  contents: read\",\n    \"  packages: write\",\n    \"\",\n    \"jobs:\",\n    \"  build:\",\n    \"    runs-on: ubuntu-latest\",\n    \"    steps:\",\n    \"      - uses: actions/checkout@v4\",\n    \"        with:\",\n    \"          fetch-depth: 0\",\n    \"\",\n    \"      - name: Log in to GHCR\",\n    \"        uses: docker/login-action@v3\",\n    \"        with:\",\n    \"          registry: ghcr.io\",\n    \"          username: ${{ github.actor }}\",\n    \"          password: ${{ secrets.GITHUB_TOKEN }}\",\n    \"\",\n    \"      - name: Build & push\",\n    \"        uses: docker/build-push-action@v5\",\n    \"        with:\",\n    \"          context: .\",\n    `          tags: ${imageName}:latest`,\n    \"          push: true\",\n  ].join(\"\\n\");\n}\n\nasync function writeGhaWorkflow() {\n  if (!existsSync(WORKFLOW_FILE)) {\n    await mkdir(WORKFLOW_DIR, { recursive: true });\n    await writeFile(WORKFLOW_FILE, generateWorkflowYml());\n    log.created(\"📄 Created .github/workflows/deploy.yml\");\n  }\n}\n\nconst DOCKER_WORKFLOW_FILE = join(WORKFLOW_DIR, \"deploy-docker.yml\");\n\nasync function writeDockerWorkflow() {\n  if (!existsSync(DOCKER_WORKFLOW_FILE)) {\n    await mkdir(WORKFLOW_DIR, { recursive: true });\n    await writeFile(DOCKER_WORKFLOW_FILE, generateDockerWorkflowYml());\n    log.created(\"📄 Created .github/workflows/deploy-docker.yml\");\n  }\n}\n\nexport async function runDeploy(): Promise<void> {\n  log.info(\"📦 Building for production...\\n\");\n  await runBuild();\n\n  // Common: .nojekyll + _headers\n  await writeFile(join(DIST_DIR, \".nojekyll\"), \"\");\n  await writeFile(join(DIST_DIR, \"_headers\"), HEADERS_FILE);\n\n  if (isDocker) {\n    await writeDockerFiles();\n    if (isCi) await writeDockerWorkflow();\n  } else {\n    await writeGhaWorkflow();\n  }\n\n  log.ok();\n  log.out(\"   Output: .docu/dist/\");\n  if (isDocker) {\n    log.out(\"   Build locally: docker build -t my-docs . && docker run -p 80:80 my-docs\");\n    if (isCi) {\n      log.out(\"   Push to GitHub — CI will build & push Docker image to GHCR\");\n      log.out(\"   Then pull latest image on your hosting platform (Coolify, etc.)\");\n    } else {\n      log.out(\"   For Coolify: connect repo, set build pack to Dockerfile\");\n    }\n  } else {\n    log.out(\"   Push to GitHub and enable Pages (Settings → Pages → Source: GitHub Actions)\");\n  }\n}\n"],"mappings":"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"}

package/.docu/lib/{html.shared-FwgbE1WG.js → html.shared-WwQnhDty.js}

@@ -1,5 +1,5 @@
 import { a as DOCS_DIR, c as PROJECT_ROOT, d as loadDocuConfig, f as resolveProjectFile, l as STYLES_DIR, o as FRAMEWORK_ROOT, s as LIB_DIR, t as ASSETS_DIR, u as cleanOldBundles } from "./paths-Bl2cdp9E.js";
-import { a as isExternalUrl, h as normalizeImporterPath, n as docsHtmlHref, o as scanMdxFiles, r as formatDate2, t as cn } from "./utils-DA17MyQG.js";
+import { c as scanMdxFiles, f as cspMeta, i as formatDate2, n as cn, o as isExternalUrl, r as docsHtmlHref, v as normalizeImporterPath } from "./utils-B_CoyKie.js";
 import { builtinModules, createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
@@ -402,6 +402,8 @@ var BuildPluginBuilder = class {
 	* Execute the transformHtml chain in pipeline pattern.
 	* Each callback receives the **previous** callback's return value (or the
 	* original HTML for the first). Every callback **must** return a string.
+	* Callbacks returning a non-string (e.g. `undefined`) are skipped with a
+	* warning — the current HTML passes through unchanged for that step.
 	* Errors inside individual callbacks are caught and logged — the current
 	* HTML passes through unchanged for that step.
 	*
@@ -412,7 +414,9 @@ var BuildPluginBuilder = class {
 	async runTransformHtmlChain(html, context) {
 		let result = html;
 		for (let i = 0; i < this._transformHtml.length; i++) try {
-			result = await this._transformHtml[i](result, context);
+			const next = await this._transformHtml[i](result, context);
+			if (typeof next === "string") result = next;
+			else console.warn(`[plugin] transformHtml callback #${i + 1} returned invalid type (expected a string), keeping previous HTML`);
 		} catch (err) {
 			console.error(`[plugin] transformHtml callback #${i + 1} error: ${err instanceof Error ? err.message : String(err)}`);
 		}
@@ -633,7 +637,7 @@ function computeTailwindCacheKey(globals, themeSuffix, projectRoot = resolveProj
 	h.update("\0");
 	h.update(runtimeStamp());
 	h.update("\0");
-	h.update(`v3`);
+	h.update(`v4`);
 	return h.digest("hex").slice(0, 16);
 }
 /** Read globals.css content ("" when missing). Shared by both hydrators. */
@@ -679,7 +683,7 @@ function hookMemoryPressure(clear) {
 function hashMdxSources(mdxSources) {
 	const h = createHash("sha256");
 	const slugs = Object.keys(mdxSources).sort();
-	h.update(`v3:${runtimeStamp()}:`);
+	h.update(`v4:${runtimeStamp()}:`);
 	for (const slug of slugs) {
 		h.update(slug);
 		h.update("\0");
@@ -1596,6 +1600,21 @@ function getRouteMap() {
 	return map;
 }
 /**
+* Single pagination entry builder (DRY) — one `readPageFrontmatter` call
+* serves both prev + next from the parse-once registry, so no file is
+* re-read or re-parsed. `description` rides along on prev too; the UI
+* keeps the paired prev minimal by design and only renders the rich
+* title + description when prev stands alone (last page, no next).
+*/
+function toPaginationEntry(href, routeMap) {
+	const fm = readPageFrontmatter(href);
+	return {
+		href,
+		title: fm.title || routeMap.get(href) || "",
+		description: fm.description || ""
+	};
+}
+/**
 * Frontmatter for a page — read from the parse-once registry (populated
 * during compilation) instead of re-reading + re-parsing the file. Falls
 * back to a direct read only for pages the dev server has not compiled yet,
@@ -1626,14 +1645,9 @@ function getPreviousNext(pathname) {
 			prev: null,
 			next: null
 		};
-		const fm = readPageFrontmatter(first);
 		return {
 			prev: null,
-			next: {
-				href: first,
-				title: fm.title || routeMap.get(first) || "",
-				description: fm.description || ""
-			}
+			next: toPaginationEntry(first, routeMap)
 		};
 	}
 	const paths = flattenRoutes();
@@ -1645,18 +1659,9 @@ function getPreviousNext(pathname) {
 	const routeMap = getRouteMap();
 	const prevHref = index > 0 ? paths[index - 1] : null;
 	const nextHref = index < paths.length - 1 ? paths[index + 1] : null;
-	const prevFm = prevHref ? readPageFrontmatter(prevHref) : null;
-	const nextFm = nextHref ? readPageFrontmatter(nextHref) : null;
 	return {
-		prev: prevHref ? {
-			href: prevHref,
-			title: prevFm?.title || routeMap.get(prevHref) || ""
-		} : null,
-		next: nextHref ? {
-			href: nextHref,
-			title: nextFm?.title || routeMap.get(nextHref) || "",
-			description: nextFm?.description || ""
-		} : null
+		prev: prevHref ? toPaginationEntry(prevHref, routeMap) : null,
+		next: nextHref ? toPaginationEntry(nextHref, routeMap) : null
 	};
 }
 //#endregion
@@ -1667,7 +1672,8 @@ function Pagination({ pathname, className, prevIcon, nextIcon, linkClassName })
 	return /* @__PURE__ */ jsx(PaginationDocs, {
 		prev: prev ? {
 			href: docsHtmlHref(`/docs${prev.href}`),
-			title: prev.title
+			title: prev.title,
+			description: prev.description
 		} : void 0,
 		next: next ? {
 			href: docsHtmlHref(`/docs${next.href}`),
@@ -2646,7 +2652,7 @@ function htmlShell(opts) {
   ${favicon ? `<link rel="icon" type="image/x-icon" href="${escapeHtml(resolvePath(favicon))}">` : ""}${themeStyle}
   <link rel="preload" href="${escapeHtml(assetPrefix + css)}" as="style">
   <link rel="stylesheet" href="${escapeHtml(assetPrefix + css)}">
-  ${csp ? `<meta http-equiv="Content-Security-Policy" content="${escapeHtml(csp)}">` : ""}
+  ${csp ? `<meta http-equiv="Content-Security-Policy" content="${escapeHtml(cspMeta(csp))}">` : ""}
   ${seoTags}
   <script${nonceAttr}>try{if(localStorage.getItem("theme")==="dark")document.documentElement.classList.add("dark")}catch(e){}<\/script>${headInjection}
 </head>
@@ -2693,4 +2699,4 @@ function hmrScript(nonce) {
 //#endregion
 export { hashMdxSources as C, loadPlugins as D, BuildPluginBuilder as E, atomicWriteFile as S, runtimeStamp as T, getPageStripped as _, IndexPage as a, buildClientBundle as b, captureException as c, clearDerivedPageCaches as d, compileMdx as f, getPageFrontmatter as g, getPageContent as h, DocsLayout as i, initSentry as l, frontmatterField as m, hmrScript as n, NotFoundPage as o, compileMdxModule as p, htmlShell as r, DocsPage as s, errorHtml as t, generateSearchIndex as u, registerPageContent as v, hookMemoryPressure as w, computeInlineThemeCss as x, getGitLastModifiedBatch as y };
 
-//# sourceMappingURL=html.shared-FwgbE1WG.js.map
+//# sourceMappingURL=html.shared-WwQnhDty.js.map