@docubook/flame 2.0.0-alpha.2 → 2.0.0-beta.1

package/.docu/lib/{chunk-42JQLAKP.js → chunk-URBATJEC.js}

@@ -1101,15 +1101,12 @@ var frontmatterSchema = z.object({
   description: z.coerce.string().optional(),
   image: z.coerce.string().optional(),
   date: z.coerce.string().optional()
-});
+}).passthrough();
 function frontmatterField(frontmatter, key) {
   return typeof frontmatter[key] === "string" ? frontmatter[key] : "";
 }
-async function serializeWithDocPlugins(rawMdx, opts = {}) {
-  const { strippedContent } = extractFrontmatterWithContent(
-    rawMdx,
-    opts.frontmatterSchema
-  );
+async function serializeWithDocPlugins(rawMdx, opts = {}, pre) {
+  const { strippedContent, frontmatter } = pre ?? extractFrontmatterWithContent(rawMdx, opts.frontmatterSchema);
   const defaultRemark = createDefaultRemarkPlugins();
   const defaultRehype = createDefaultRehypePlugins();
   const finalRemark = [...defaultRemark, remarkMdxJsxDocsHtmlLinks, ...opts.remarkPlugins ?? []];
@@ -1121,16 +1118,16 @@ async function serializeWithDocPlugins(rawMdx, opts = {}) {
       rehypePlugins: finalRehype,
       remarkPlugins: finalRemark
     }
-  });
+  }).then((serialized) => ({ ...serialized, frontmatter, strippedContent }));
 }
-async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugins, frontmatterSchema2) {
+async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugins, frontmatterSchema2, pre) {
   const tocs = extractTocsFromRawMdx(rawMdx);
-  const { frontmatter } = extractFrontmatterWithContent(rawMdx, frontmatterSchema2);
-  const serialized = await serializeWithDocPlugins(rawMdx, {
-    remarkPlugins,
-    rehypePlugins,
-    frontmatterSchema: frontmatterSchema2
-  });
+  const frontmatter = pre?.frontmatter ?? extractFrontmatterWithContent(rawMdx, frontmatterSchema2).frontmatter;
+  const serialized = await serializeWithDocPlugins(
+    rawMdx,
+    { remarkPlugins, rehypePlugins, frontmatterSchema: frontmatterSchema2 },
+    pre
+  );
   const components = createMdxComponents();
   const content = React.createElement(MDXRemote, {
     compiledSource: serialized.compiledSource,
@@ -1146,12 +1143,37 @@ async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugi
     tocs
   };
 }
-async function compileMdxModule(rawMdx, remarkPlugins, rehypePlugins) {
+var pageFrontmatter = /* @__PURE__ */ new Map();
+function registerPageFrontmatter(href, frontmatter) {
+  pageFrontmatter.set(href, frontmatter);
+}
+function getPageFrontmatter(href) {
+  return pageFrontmatter.get(href);
+}
+var pageStripped = /* @__PURE__ */ new Map();
+function registerPageStripped(href, stripped) {
+  pageStripped.set(href, stripped);
+}
+function getPageStripped(href) {
+  return pageStripped.get(href);
+}
+var pageContent = /* @__PURE__ */ new Map();
+function registerPageContent(href, raw) {
+  pageContent.set(href, raw);
+}
+function getPageContent(href) {
+  return pageContent.get(href);
+}
+async function compileMdxModule(rawMdx, remarkPlugins, rehypePlugins, href) {
   const serialized = await serializeWithDocPlugins(rawMdx, {
     outputFormat: "program",
     remarkPlugins,
     rehypePlugins
   });
+  if (href) {
+    registerPageFrontmatter(href, serialized.frontmatter);
+    registerPageStripped(href, serialized.strippedContent);
+  }
   return serialized.compiledSource;
 }
 
@@ -1278,7 +1300,7 @@ async function generateSearchIndex(docsDir, outputDir) {
   const mdxFiles = await scanMdxFiles(docs);
   const results = await Promise.all(
     mdxFiles.map(async (file) => {
-      const raw = await readFile2(file.absPath, "utf-8");
+      const raw = getPageContent(`/${file.path}`) ?? await readFile2(file.absPath, "utf-8");
       return extractRecords(file.path, raw);
     })
   );
@@ -1364,25 +1386,23 @@ function getRouteMap() {
   routes.forEach((route) => traverse(route));
   return map;
 }
-var descriptionCache = /* @__PURE__ */ new Map();
-function readDescription(href) {
-  const cached = descriptionCache.get(href);
-  if (cached !== void 0) return cached;
-  let description = "";
+function readPageFrontmatter(href) {
+  const registered = getPageFrontmatter(href);
+  if (registered) return registered;
+  let fm = {};
   const rel = href.replace(/^\/|$/g, "");
   for (const ext of [".mdx", ".md"]) {
     for (const file of [join4(DOCS_DIR, `${rel}${ext}`), join4(DOCS_DIR, `${rel}/index${ext}`)]) {
       try {
-        const fm = extractFrontmatter(readFileSync2(file, "utf-8"));
-        description = typeof fm.description === "string" ? fm.description : "";
-        if (description) break;
+        fm = extractFrontmatter(readFileSync2(file, "utf-8"));
+        break;
       } catch {
       }
     }
-    if (description) break;
+    if (Object.keys(fm).length) break;
   }
-  descriptionCache.set(href, description);
-  return description;
+  registerPageFrontmatter(href, fm);
+  return fm;
 }
 function getPreviousNext(pathname) {
   const normalizedPath = pathname.replace(/^\/|$/g, "");
@@ -1391,12 +1411,13 @@ function getPreviousNext(pathname) {
     const routeMap2 = getRouteMap();
     const first = paths2[0];
     if (!first) return { prev: null, next: null };
+    const fm = readPageFrontmatter(first);
     return {
       prev: null,
       next: {
         href: first,
-        title: routeMap2.get(first) || "",
-        description: readDescription(first)
+        title: fm.title || routeMap2.get(first) || "",
+        description: fm.description || ""
       }
     };
   }
@@ -1408,12 +1429,14 @@ 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: routeMap.get(prevHref) || "" } : null,
+    prev: prevHref ? { href: prevHref, title: prevFm?.title || routeMap.get(prevHref) || "" } : null,
     next: nextHref ? {
       href: nextHref,
-      title: routeMap.get(nextHref) || "",
-      description: readDescription(nextHref)
+      title: nextFm?.title || routeMap.get(nextHref) || "",
+      description: nextFm?.description || ""
     } : null
   };
 }
@@ -1642,7 +1665,7 @@ import { ListIcon } from "lucide-react";
 import { ArrowUpIcon } from "lucide-react";
 import { useEffect, useState, useCallback } from "react";
 import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
-function ScrollTo({ className, showIcon = true }) {
+function ScrollTo({ className, showIcon = true, onScrollToTop }) {
   const [isVisible, setIsVisible] = useState(false);
   const checkScroll = useCallback(() => {
     const container = document.getElementById("scroll-container");
@@ -1667,15 +1690,20 @@ function ScrollTo({ className, showIcon = true }) {
       if (timeoutId) clearTimeout(timeoutId);
     };
   }, [checkScroll]);
-  const scrollToTop = useCallback((e) => {
-    e.preventDefault();
-    const container = document.getElementById("scroll-container");
-    if (container) {
-      container.scrollTo({ top: 0, behavior: "smooth" });
-    } else {
-      window.scrollTo({ top: 0, behavior: "smooth" });
-    }
-  }, []);
+  const scrollToTop = useCallback(
+    (e) => {
+      e.preventDefault();
+      onScrollToTop?.();
+      history.replaceState(null, "", "#top");
+      const container = document.getElementById("scroll-container");
+      if (container) {
+        container.scrollTo({ top: 0, behavior: "smooth" });
+      } else {
+        window.scrollTo({ top: 0, behavior: "smooth" });
+      }
+    },
+    [onScrollToTop]
+  );
   return /* @__PURE__ */ jsx7(
     "div",
     {
@@ -1688,7 +1716,7 @@ function ScrollTo({ className, showIcon = true }) {
       children: /* @__PURE__ */ jsxs4(
         "a",
         {
-          href: "#",
+          href: "#top",
           onClick: scrollToTop,
           className: cn(
             "inline-flex items-center text-sm",
@@ -1743,9 +1771,9 @@ function Toc({ tocs }) {
           break;
         }
       }
-      if (currentId && currentId !== activeIdRef.current) {
+      if (currentId !== activeIdRef.current) {
         setActiveId(currentId);
-        history.replaceState(null, "", `#${currentId}`);
+        history.replaceState(null, "", currentId ? `#${currentId}` : "#top");
       }
     };
     handleScroll();
@@ -1772,100 +1800,124 @@ function Toc({ tocs }) {
       clickedIdRef.current = null;
     }, 1e3);
   }, []);
+  const handleScrollToTop = useCallback2(() => {
+    clickedIdRef.current = "__top__";
+    setActiveId(null);
+    history.replaceState(null, "", "#top");
+    if (clickTimerRef.current) clearTimeout(clickTimerRef.current);
+    clickTimerRef.current = setTimeout(() => {
+      clickedIdRef.current = null;
+    }, 1e3);
+  }, []);
   useEffect2(() => {
     return () => {
       if (clickTimerRef.current) clearTimeout(clickTimerRef.current);
     };
   }, []);
+  const activeItemRef = useRef(null);
+  useEffect2(() => {
+    if (activeId && activeItemRef.current && !clickedIdRef.current) {
+      activeItemRef.current.scrollIntoView({
+        block: "nearest",
+        behavior: "smooth"
+      });
+    }
+  }, [activeId]);
   if (!tocs.length) return null;
-  return /* @__PURE__ */ jsxs5("div", { className: "flex w-full flex-col gap-2", children: [
-    /* @__PURE__ */ jsxs5("div", { className: "flex items-center gap-2", children: [
+  return /* @__PURE__ */ jsxs5("div", { className: "flex h-full min-h-0 w-full flex-col gap-2", children: [
+    /* @__PURE__ */ jsxs5("div", { className: "flex shrink-0 items-center gap-2", children: [
       /* @__PURE__ */ jsx8(ListIcon, { className: "h-4 w-4" }),
       /* @__PURE__ */ jsx8("h3", { className: "text-sm font-medium", children: "On this page" })
     ] }),
-    /* @__PURE__ */ jsx8("div", { className: "relative", children: /* @__PURE__ */ jsxs5("div", { className: "relative text-sm", children: [
-      /* @__PURE__ */ jsx8("div", { className: "bg-base-300 absolute top-0 left-0 h-full w-px" }),
-      /* @__PURE__ */ jsx8("div", { className: "flex flex-col", children: tocs.map(({ href, level, text }) => {
-        const id = href.slice(1);
-        const isActive = activeId === id;
-        const levelPadding = (level - 2) * 16;
-        return /* @__PURE__ */ jsxs5(
-          "div",
-          {
-            className: cn(
-              "relative flex items-center transition-all duration-200",
-              isActive && "bg-primary/5"
-            ),
-            children: [
-              /* @__PURE__ */ jsxs5(
-                "div",
-                {
-                  className: cn(
-                    "flex shrink-0 items-center px-1 py-2 transition-all duration-200",
-                    isActive && "border-primary -ml-px border-l-[3px]"
-                  ),
-                  children: [
-                    /* @__PURE__ */ jsx8(
-                      "div",
-                      {
-                        className: cn(
-                          "h-px transition-colors duration-200",
-                          isActive ? "bg-primary w-3" : "bg-base-300 w-2"
-                        )
-                      }
-                    ),
-                    /* @__PURE__ */ jsx8(
-                      "div",
-                      {
-                        className: cn(
-                          "h-1.5 w-1.5 shrink-0 rounded-full transition-colors duration-300",
-                          isActive ? "bg-primary" : "bg-base-300"
-                        )
-                      }
-                    )
-                  ]
-                }
+    /* @__PURE__ */ jsxs5("div", { className: "relative min-h-0 flex-1 overflow-y-auto overscroll-contain pr-1", children: [
+      /* @__PURE__ */ jsxs5("div", { className: "relative text-sm", children: [
+        /* @__PURE__ */ jsx8("div", { className: "bg-base-300 absolute top-0 left-0 h-full w-px" }),
+        /* @__PURE__ */ jsx8("div", { className: "flex flex-col", children: tocs.map(({ href, level, text }) => {
+          const id = href.slice(1);
+          const isActive = activeId === id;
+          const levelPadding = (level - 2) * 16;
+          return /* @__PURE__ */ jsxs5(
+            "div",
+            {
+              ref: isActive ? activeItemRef : void 0,
+              className: cn(
+                "relative flex items-center transition-all duration-200",
+                isActive && "bg-primary/5"
               ),
-              /* @__PURE__ */ jsx8(
-                "a",
-                {
-                  href,
-                  onClick: (e) => {
-                    e.preventDefault();
-                    handleLinkClick(id);
-                    const el = document.getElementById(id);
-                    if (el) {
-                      const offset = getAnchorOffset();
-                      const scroller = window.innerWidth >= 1024 ? document.getElementById("scroll-container") : null;
-                      const elTop = el.getBoundingClientRect().top;
-                      if (scroller) {
-                        scroller.scrollTo({
-                          top: elTop - scroller.getBoundingClientRect().top + scroller.scrollTop - offset,
-                          behavior: "smooth"
-                        });
-                      } else {
-                        window.scrollTo({
-                          top: elTop + window.scrollY - offset,
-                          behavior: "smooth"
-                        });
+              children: [
+                /* @__PURE__ */ jsxs5(
+                  "div",
+                  {
+                    className: cn(
+                      "flex shrink-0 items-center px-1 py-2 transition-all duration-200",
+                      isActive && "border-primary -ml-px border-l-[3px]"
+                    ),
+                    children: [
+                      /* @__PURE__ */ jsx8(
+                        "div",
+                        {
+                          className: cn(
+                            "h-px transition-colors duration-200",
+                            isActive ? "bg-primary w-3" : "bg-base-300 w-2"
+                          )
+                        }
+                      ),
+                      /* @__PURE__ */ jsx8(
+                        "div",
+                        {
+                          className: cn(
+                            "h-1.5 w-1.5 shrink-0 rounded-full transition-colors duration-300",
+                            isActive ? "bg-primary" : "bg-base-300"
+                          )
+                        }
+                      )
+                    ]
+                  }
+                ),
+                /* @__PURE__ */ jsx8(
+                  "a",
+                  {
+                    href,
+                    onClick: (e) => {
+                      e.preventDefault();
+                      handleLinkClick(id);
+                      const el = document.getElementById(id);
+                      if (el) {
+                        const offset = getAnchorOffset();
+                        const scroller = window.innerWidth >= 1024 ? document.getElementById("scroll-container") : null;
+                        const elTop = el.getBoundingClientRect().top;
+                        if (scroller) {
+                          scroller.scrollTo({
+                            top: elTop - scroller.getBoundingClientRect().top + scroller.scrollTop - offset,
+                            behavior: "smooth"
+                          });
+                        } else {
+                          window.scrollTo({
+                            top: elTop + window.scrollY - offset,
+                            behavior: "smooth"
+                          });
+                        }
                       }
-                    }
-                  },
-                  className: cn(
-                    "flex flex-1 items-center py-2 transition-all duration-200",
-                    isActive ? "text-primary font-medium" : "text-base-content/60 hover:text-base-content"
-                  ),
-                  style: { paddingLeft: `${levelPadding + 6}px` },
-                  children: /* @__PURE__ */ jsx8("span", { className: "line-clamp-2 text-sm break-words", children: text })
-                }
-              )
-            ]
-          },
-          href
-        );
-      }) })
-    ] }) }),
-    /* @__PURE__ */ jsx8(ScrollTo, { className: "mt-2" })
+                    },
+                    className: cn(
+                      "flex flex-1 items-center py-2 transition-all duration-200",
+                      isActive ? "text-primary font-medium" : "text-base-content/60 hover:text-base-content"
+                    ),
+                    style: { paddingLeft: `${levelPadding + 6}px` },
+                    children: /* @__PURE__ */ jsx8("span", { className: "line-clamp-2 text-sm break-words", children: text })
+                  }
+                )
+              ]
+            },
+            href
+          );
+        }) })
+      ] }),
+      /* @__PURE__ */ jsxs5("div", { className: "mt-2 grid grid-cols-[28px_minmax(0,1fr)] items-start px-4 text-sm", children: [
+        /* @__PURE__ */ jsx8("div", { "aria-hidden": "true" }),
+        /* @__PURE__ */ jsx8(ScrollTo, { className: "mt-0", onScrollToTop: handleScrollToTop })
+      ] })
+    ] })
   ] });
 }
 
@@ -2650,6 +2702,10 @@ export {
   getGitLastModifiedBatch,
   frontmatterField,
   compileMdx,
+  getPageFrontmatter,
+  getPageStripped,
+  registerPageContent,
+  getPageContent,
   compileMdxModule,
   generateSearchIndex,
   initSentry,

package/.docu/lib/clean.js

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-IN2QAGDZ.js";
+} from "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/clean.ts

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

@@ -1,6 +1,6 @@
 import {
   runDeploy
-} from "./chunk-PJVCY4FK.js";
+} from "./chunk-U7M5SK76.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/deploy.deno.ts

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

@@ -1,6 +1,6 @@
 import {
   runDeploy
-} from "./chunk-PJVCY4FK.js";
+} from "./chunk-U7M5SK76.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/deploy.node.ts

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

@@ -1,11 +1,11 @@
 import {
   runPreview
-} from "./chunk-PGIHPW5L.js";
+} from "./chunk-MQRFIDS4.js";
 import {
   denoAdapter
 } from "./chunk-UISOJ4RW.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-IN2QAGDZ.js";
+import "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/preview.deno.ts

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

@@ -1,11 +1,11 @@
 import {
   runPreview
-} from "./chunk-PGIHPW5L.js";
+} from "./chunk-MQRFIDS4.js";
 import {
   nodeAdapter
 } from "./chunk-UISOJ4RW.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-IN2QAGDZ.js";
+import "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/preview.node.ts

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

@@ -1,12 +1,12 @@
 import {
   runServer
-} from "./chunk-HF3KKRQL.js";
-import "./chunk-42JQLAKP.js";
+} from "./chunk-6HFBJUMG.js";
+import "./chunk-URBATJEC.js";
 import {
   denoAdapter
 } from "./chunk-UISOJ4RW.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-IN2QAGDZ.js";
+import "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/server.deno.ts

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

@@ -1,12 +1,12 @@
 import {
   runServer
-} from "./chunk-HF3KKRQL.js";
-import "./chunk-42JQLAKP.js";
+} from "./chunk-6HFBJUMG.js";
+import "./chunk-URBATJEC.js";
 import {
   nodeAdapter
 } from "./chunk-UISOJ4RW.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-IN2QAGDZ.js";
+import "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/server.node.ts

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

@@ -12,7 +12,16 @@ import { createHash } from "node:crypto";
 import { join, dirname } from "node:path";
 import React from "react";
 import { renderToString } from "react-dom/server";
-import { compileMdx, compileMdxModule, frontmatterField, getGitLastModifiedBatch } from "./mdx";
+import {
+  compileMdx,
+  compileMdxModule,
+  frontmatterField,
+  getGitLastModifiedBatch,
+  getPageContent,
+  getPageFrontmatter,
+  getPageStripped,
+  registerPageContent,
+} from "./mdx";
 import {
   DOCS_DIR,
   DIST_DIR,
@@ -105,7 +114,24 @@ async function renderDocsPage(
   try {
     const remarkPlugins = builder?.collectRemarkPlugins();
     const rehypePlugins = builder?.collectRehypePlugins();
-    result = await compileMdx(content, filePath, gitDates, remarkPlugins, rehypePlugins);
+    // Parse-once: reuse the prePass frontmatter + stripped content so the
+    // SSR phase does not re-extract them. Only when the prePass actually
+    // registered them — otherwise compileMdx does its own extraction.
+    const preFm = getPageFrontmatter(`/${slug}`);
+    const preStripped = getPageStripped(`/${slug}`);
+    const pre =
+      preFm !== undefined && preStripped !== undefined
+        ? { frontmatter: preFm, strippedContent: preStripped }
+        : undefined;
+    result = await compileMdx(
+      content,
+      filePath,
+      gitDates,
+      remarkPlugins,
+      rehypePlugins,
+      undefined,
+      pre
+    );
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Unknown MDX error";
     throw new Error(`MDX Error in: docs/${slug}.mdx\n${msg}`, { cause: err });
@@ -241,6 +267,9 @@ export async function runBuild(): Promise<void> {
     } catch {
       return;
     }
+    // Cache the original content so the page loop does not re-read the file
+    // (one disk read per file — the frontmatter is parsed once here too).
+    registerPageContent(`/${file.path}`, raw);
     let content = raw;
     if (builder) {
       const relPath = file.absPath.replace(PROJECT_ROOT + "/", "");
@@ -249,7 +278,12 @@ export async function runBuild(): Promise<void> {
     }
     const remarkPlugins = builder?.collectRemarkPlugins();
     const rehypePlugins = builder?.collectRehypePlugins();
-    mdxSources[file.path] = await compileMdxModule(content, remarkPlugins, rehypePlugins);
+    mdxSources[file.path] = await compileMdxModule(
+      content,
+      remarkPlugins,
+      rehypePlugins,
+      `/${file.path}`
+    );
   });
   await Promise.all(prePassTasks);
 
@@ -319,12 +353,14 @@ export async function runBuild(): Promise<void> {
       }
     }
 
-    let rawMdx: string;
-    try {
-      rawMdx = await readFile(file.absPath, "utf-8");
-    } catch (err) {
-      if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
-      continue;
+    let rawMdx = getPageContent(`/${file.path}`);
+    if (rawMdx === undefined) {
+      try {
+        rawMdx = await readFile(file.absPath, "utf-8");
+      } catch (err) {
+        if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
+        continue;
+      }
     }
 
     if (rebuildDecision === "hash_check") {
@@ -458,8 +494,11 @@ export async function runBuild(): Promise<void> {
 
   logger.indexStart();
   t = performance.now();
-  const indexCount = await generateSearchIndex();
-  logger.indexDone(indexCount, Math.round(performance.now() - t));
+  // No content changed (all pages cached) → the aggregated index is
+  // unchanged too; reuse the existing file instead of regenerating it.
+  const indexSkipped = built === 0 && existsSync(join(ASSETS_DIR, "search-index.json"));
+  const indexCount = indexSkipped ? 0 : await generateSearchIndex();
+  logger.indexDone(indexCount, Math.round(performance.now() - t), indexSkipped);
 
   logger.routes();