@docubook/flame 1.7.2 → 2.0.0-alpha.1

package/.docu/lib/{chunk-HRO7ONJQ.js → chunk-MQWWCO6O.js}

@@ -7,13 +7,15 @@ import {
   buildClientBundle,
   captureException,
   compileMdx,
+  compileMdxModule,
   computeInlineThemeCss,
+  frontmatterField,
   generateSearchIndex,
   getGitLastModifiedBatch,
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-B6LGUADD.js";
+} from "./chunk-TRT6WQZG.js";
 import {
   cspHeader,
   generateNonce,
@@ -21,7 +23,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-PJIJEPNR.js";
+} from "./chunk-JRERMREW.js";
 import {
   ASSETS_DIR,
   CACHE_FILE,
@@ -48,7 +50,7 @@ function buildSeoMeta(config, frontmatter, slug) {
     url,
     siteName: config.meta?.title || ""
   };
-  const image = typeof frontmatter.image === "string" && frontmatter.image || config.meta?.ogImage;
+  const image = frontmatterField(frontmatter, "image") || config.meta?.ogImage;
   if (image) {
     try {
       result.image = new URL(image, image.startsWith("/") ? baseURL : `${baseURL}/docs/`).href;
@@ -121,8 +123,8 @@ ${msg}`, { cause: err });
       content
     });
   }
-  const title = (typeof frontmatter.title === "string" ? frontmatter.title : "") || slug || "Docs";
-  const description = typeof frontmatter.description === "string" ? frontmatter.description : "";
+  const title = frontmatterField(frontmatter, "title") || slug || "Docs";
+  const description = frontmatterField(frontmatter, "description");
   const slugParts = slug ? slug.split("/") : [];
   const page = React.createElement(
     DocsLayout,
@@ -131,12 +133,15 @@ ${msg}`, { cause: err });
       slug: slugParts,
       title,
       description,
-      date: frontmatter.date || void 0,
-      content: result.content,
+      date: frontmatterField(frontmatter, "date") || void 0,
+      // Render MDX content as its own root: client hydrates the island as a
+      // separate root, so SSR must be root-relative too or useId-based ids
+      // (mdx-compiler components) mismatch during hydration.
+      content: renderToString(result.content),
       tocs: result.tocs,
       filePath,
       repoUrl: docuConfig.repo?.url,
-      compiledSource: result.compiledSource
+      mdxSlug: slug
     })
   );
   const body = renderToString(page);
@@ -146,7 +151,7 @@ ${msg}`, { cause: err });
   const depth = slug ? slug.split("/").length : 1;
   const favicon = docuConfig.meta?.favicon || "/docs/assets/images/favicon.ico";
   const seo = buildSeoMeta(docuConfig, frontmatter, slug || "");
-  const csp = cspHeader(nonce, true);
+  const csp = cspHeader(nonce);
   let html = htmlShell({
     title,
     description,
@@ -200,9 +205,55 @@ async function runBuild() {
   const cache = args.force ? {} : await readCache();
   let built = 0;
   let skipped = 0;
+  const pluginsConfig = docuConfig.plugins ?? [];
+  const builder = pluginsConfig.length > 0 ? new BuildPluginBuilder(docuConfig) : null;
+  if (builder) {
+    const plugins = await loadPlugins(pluginsConfig);
+    for (const plugin of plugins) {
+      await plugin.setup(builder);
+    }
+    await builder.runOnStart();
+  }
+  const mdxSources = {};
+  const prePassTasks = mdxFiles.map(async (file) => {
+    let raw;
+    try {
+      raw = await readFile(file.absPath, "utf-8");
+    } catch {
+      return;
+    }
+    let content = raw;
+    if (builder) {
+      const relPath = file.absPath.replace(PROJECT_ROOT + "/", "");
+      const transformed = await builder.runOnLoad(relPath, content);
+      if (transformed?.contents) content = transformed.contents;
+    }
+    const remarkPlugins = builder?.collectRemarkPlugins();
+    const rehypePlugins = builder?.collectRehypePlugins();
+    mdxSources[file.path] = await compileMdxModule(content, remarkPlugins, rehypePlugins);
+  });
+  await Promise.all(prePassTasks);
+  const indexMdxPath = join(DOCS_DIR, "index.mdx");
+  if (existsSync(indexMdxPath)) {
+    try {
+      const indexRaw = await readFile(indexMdxPath, "utf-8");
+      let indexContent = indexRaw;
+      if (builder) {
+        const relPath = indexMdxPath.replace(PROJECT_ROOT + "/", "");
+        const transformed = await builder.runOnLoad(relPath, indexContent);
+        if (transformed?.contents) indexContent = transformed.contents;
+      }
+      mdxSources[""] = await compileMdxModule(
+        indexContent,
+        builder?.collectRemarkPlugins(),
+        builder?.collectRehypePlugins()
+      );
+    } catch {
+    }
+  }
   logger.bundleStart();
   let t = performance.now();
-  assetManifest = await buildClientBundle();
+  assetManifest = await buildClientBundle(mdxSources);
   logger.bundleDone(Math.round(performance.now() - t));
   inlineThemeCss = computeInlineThemeCss();
   const lastManifest = cache["__assets__"];
@@ -214,15 +265,6 @@ async function runBuild() {
       builtAt: Date.now()
     };
   }
-  const pluginsConfig = docuConfig.plugins ?? [];
-  const builder = pluginsConfig.length > 0 ? new BuildPluginBuilder(docuConfig) : null;
-  if (builder) {
-    const plugins = await loadPlugins(pluginsConfig);
-    for (const plugin of plugins) {
-      await plugin.setup(builder);
-    }
-    await builder.runOnStart();
-  }
   logger.spinner.start("Building pages...");
   t = performance.now();
   const allRelPaths = mdxFiles.map((f) => f.absPath.replace(PROJECT_ROOT + "/", ""));
@@ -301,9 +343,9 @@ async function runBuild() {
     await Promise.all(buildTasks.slice(i, i + CONCURRENCY).map((fn) => fn()));
   }
   try {
-    const indexMdxPath = join(DOCS_DIR, "index.mdx");
-    const indexRaw = await readFile(indexMdxPath, "utf-8");
-    const indexRelPath = indexMdxPath.replace(PROJECT_ROOT + "/", "");
+    const indexMdxPath2 = join(DOCS_DIR, "index.mdx");
+    const indexRaw = await readFile(indexMdxPath2, "utf-8");
+    const indexRelPath = indexMdxPath2.replace(PROJECT_ROOT + "/", "");
     const indexHtml = await renderDocsPage(
       docuConfig,
       "",
@@ -332,8 +374,7 @@ async function runBuild() {
     body: renderToString(landingPage),
     favicon: landingFavicon,
     seo: landingSeo,
-    /** unsafe-eval required by mdx-remote hydration — see above. */
-    csp: cspHeader(landingNonce, true),
+    csp: cspHeader(landingNonce),
     css: assetManifest.css,
     js: assetManifest.js,
     nonce: landingNonce,
@@ -353,12 +394,14 @@ async function runBuild() {
     body: renderToString(notFoundPage),
     favicon: notFoundFavicon,
     headExtra: ['<meta name="robots" content="noindex,follow">'],
-    /** unsafe-eval required by mdx-remote hydration — see above. */
-    csp: cspHeader(notFoundNonce, true),
+    csp: cspHeader(notFoundNonce),
     css: assetManifest.css,
     js: assetManifest.js,
     nonce: notFoundNonce,
-    themeCss: inlineThemeCss
+    themeCss: inlineThemeCss,
+    // Served as the static-host fallback at ANY requested path — relative
+    // depth can never be right there, so use root-absolute asset URLs.
+    absoluteAssets: true
   });
   await writeFile(join(DIST_DIR, "404.html"), notFoundHtml);
   logger.spinner.stop(