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

package/.docu/components/ScrollTo.tsx

@@ -8,9 +8,10 @@ interface ScrollToProps {
   className?: string;
   showIcon?: boolean;
   offset?: number;
+  onScrollToTop?: () => void;
 }
 
-export function ScrollTo({ className, showIcon = true }: ScrollToProps) {
+export function ScrollTo({ className, showIcon = true, onScrollToTop }: ScrollToProps) {
   const [isVisible, setIsVisible] = useState(false);
 
   const checkScroll = useCallback(() => {
@@ -41,15 +42,20 @@ export function ScrollTo({ className, showIcon = true }: ScrollToProps) {
     };
   }, [checkScroll]);
 
-  const scrollToTop = useCallback((e: React.MouseEvent) => {
-    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: React.MouseEvent) => {
+      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 (
     <div
@@ -61,7 +67,7 @@ export function ScrollTo({ className, showIcon = true }: ScrollToProps) {
       )}
     >
       <a
-        href="#"
+        href="#top"
         onClick={scrollToTop}
         className={cn(
           "inline-flex items-center text-sm",

package/.docu/components/Toc.tsx

@@ -62,9 +62,9 @@ export default function Toc({ tocs }: TocProps) {
         }
       }
 
-      if (currentId && currentId !== activeIdRef.current) {
+      if (currentId !== activeIdRef.current) {
         setActiveId(currentId);
-        history.replaceState(null, "", `#${currentId}`);
+        history.replaceState(null, "", currentId ? `#${currentId}` : "#top");
       }
     };
 
@@ -100,22 +100,43 @@ export default function Toc({ tocs }: TocProps) {
     }, 1000);
   }, []);
 
+  const handleScrollToTop = useCallback(() => {
+    clickedIdRef.current = "__top__";
+    setActiveId(null);
+    history.replaceState(null, "", "#top");
+    if (clickTimerRef.current) clearTimeout(clickTimerRef.current);
+    clickTimerRef.current = setTimeout(() => {
+      clickedIdRef.current = null;
+    }, 1000);
+  }, []);
+
   useEffect(() => {
     return () => {
       if (clickTimerRef.current) clearTimeout(clickTimerRef.current);
     };
   }, []);
 
+  const activeItemRef = useRef<HTMLDivElement | null>(null);
+
+  useEffect(() => {
+    if (activeId && activeItemRef.current && !clickedIdRef.current) {
+      activeItemRef.current.scrollIntoView({
+        block: "nearest",
+        behavior: "smooth",
+      });
+    }
+  }, [activeId]);
+
   if (!tocs.length) return null;
 
   return (
-    <div className="flex w-full flex-col gap-2">
-      <div className="flex items-center gap-2">
+    <div className="flex h-full min-h-0 w-full flex-col gap-2">
+      <div className="flex shrink-0 items-center gap-2">
         <ListIcon className="h-4 w-4" />
         <h3 className="text-sm font-medium">On this page</h3>
       </div>
 
-      <div className="relative">
+      <div className="relative min-h-0 flex-1 overflow-y-auto overscroll-contain pr-1">
         <div className="relative text-sm">
           <div className="bg-base-300 absolute top-0 left-0 h-full w-px" />
 
@@ -128,6 +149,7 @@ export default function Toc({ tocs }: TocProps) {
               return (
                 <div
                   key={href}
+                  ref={isActive ? activeItemRef : undefined}
                   className={cn(
                     "relative flex items-center transition-all duration-200",
                     isActive && "bg-primary/5"
@@ -206,9 +228,12 @@ export default function Toc({ tocs }: TocProps) {
             })}
           </div>
         </div>
-      </div>
 
-      <ScrollTo className="mt-2" />
+        <div className="mt-2 grid grid-cols-[28px_minmax(0,1fr)] items-start px-4 text-sm">
+          <div aria-hidden="true" />
+          <ScrollTo className="mt-0" onScrollToTop={handleScrollToTop} />
+        </div>
+      </div>
     </div>
   );
 }

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

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-3LRUTZZD.js";
-import "./chunk-42JQLAKP.js";
+} from "./chunk-FERG25YW.js";
+import "./chunk-URBATJEC.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-IN2QAGDZ.js";
+import "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/build.deno.ts

package/.docu/lib/{build.impl-AZBZN66Q.js → build.impl-3ZOQORN3.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   runBuildCli
-} from "./chunk-3LRUTZZD.js";
-import "./chunk-42JQLAKP.js";
+} from "./chunk-FERG25YW.js";
+import "./chunk-URBATJEC.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-IN2QAGDZ.js";
+import "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 export {
   runBuild,

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

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-3LRUTZZD.js";
-import "./chunk-42JQLAKP.js";
+} from "./chunk-FERG25YW.js";
+import "./chunk-URBATJEC.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-IN2QAGDZ.js";
+import "./chunk-6EOUQCRM.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/build.node.ts

package/.docu/lib/{chunk-IN2QAGDZ.js → chunk-6EOUQCRM.js}

@@ -5,7 +5,7 @@ import {
 // package.json
 var package_default = {
   name: "@docubook/flame",
-  version: "2.0.0-alpha.2",
+  version: "2.0.0-beta.1",
   description: "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   type: "module",
   bin: {
@@ -239,9 +239,11 @@ ${c.bold}${c.cyan}  \u{1F525} DocuBook Flame${c.reset} ${c.dim}v${package_defaul
     if (guard("info", "index_start")) return;
     this.spinner.start("Generating search index...");
   },
-  indexDone(records, ms) {
-    if (guard("info", "index_done", { records, duration_ms: ms })) return;
-    this.spinner.stop(`Search index generated ${c.dim}(${records} records, ${ms}ms)${c.reset}`);
+  indexDone(records, ms, skipped = false) {
+    if (guard("info", "index_done", { records, duration_ms: ms, skipped })) return;
+    this.spinner.stop(
+      skipped ? `Search index cached ${c.dim}(${ms}ms)${c.reset}` : `Search index generated ${c.dim}(${records} records, ${ms}ms)${c.reset}`
+    );
   },
   routes() {
     if (guard("debug", "routes")) return;

package/.docu/lib/{chunk-HF3KKRQL.js → chunk-6HFBJUMG.js}

@@ -15,7 +15,7 @@ import {
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-42JQLAKP.js";
+} from "./chunk-URBATJEC.js";
 import {
   SECURITY_HEADERS,
   generateNonce,
@@ -28,7 +28,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-IN2QAGDZ.js";
+} from "./chunk-6EOUQCRM.js";
 import {
   DIST_DIR,
   DOCS_DIR,

package/.docu/lib/{chunk-3LRUTZZD.js → chunk-FERG25YW.js}

@@ -12,10 +12,14 @@ import {
   frontmatterField,
   generateSearchIndex,
   getGitLastModifiedBatch,
+  getPageContent,
+  getPageFrontmatter,
+  getPageStripped,
   htmlShell,
   initSentry,
-  loadPlugins
-} from "./chunk-42JQLAKP.js";
+  loadPlugins,
+  registerPageContent
+} from "./chunk-URBATJEC.js";
 import {
   cspHeader,
   generateNonce,
@@ -23,7 +27,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-IN2QAGDZ.js";
+} from "./chunk-6EOUQCRM.js";
 import {
   ASSETS_DIR,
   CACHE_FILE,
@@ -109,7 +113,18 @@ async function renderDocsPage(docuConfig, slug, rawMdx, filePath, gitDates, buil
   try {
     const remarkPlugins = builder?.collectRemarkPlugins();
     const rehypePlugins = builder?.collectRehypePlugins();
-    result = await compileMdx(content, filePath, gitDates, remarkPlugins, rehypePlugins);
+    const preFm = getPageFrontmatter(`/${slug}`);
+    const preStripped = getPageStripped(`/${slug}`);
+    const pre = preFm !== void 0 && preStripped !== void 0 ? { frontmatter: preFm, strippedContent: preStripped } : void 0;
+    result = await compileMdx(
+      content,
+      filePath,
+      gitDates,
+      remarkPlugins,
+      rehypePlugins,
+      void 0,
+      pre
+    );
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Unknown MDX error";
     throw new Error(`MDX Error in: docs/${slug}.mdx
@@ -222,6 +237,7 @@ async function runBuild() {
     } catch {
       return;
     }
+    registerPageContent(`/${file.path}`, raw);
     let content = raw;
     if (builder) {
       const relPath = file.absPath.replace(PROJECT_ROOT + "/", "");
@@ -230,7 +246,12 @@ async function runBuild() {
     }
     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);
   const indexMdxPath = join(DOCS_DIR, "index.mdx");
@@ -285,12 +306,14 @@ async function runBuild() {
         continue;
       }
     }
-    let rawMdx;
-    try {
-      rawMdx = await readFile(file.absPath, "utf-8");
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-      continue;
+    let rawMdx = getPageContent(`/${file.path}`);
+    if (rawMdx === void 0) {
+      try {
+        rawMdx = await readFile(file.absPath, "utf-8");
+      } catch (err) {
+        if (err.code !== "ENOENT") throw err;
+        continue;
+      }
     }
     if (rebuildDecision === "hash_check") {
       const contentHash = hashContent(rawMdx);
@@ -418,8 +441,9 @@ async function runBuild() {
   }
   logger.indexStart();
   t = performance.now();
-  const indexCount = await generateSearchIndex();
-  logger.indexDone(indexCount, Math.round(performance.now() - t));
+  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();
   await writeCache(cache);
   if (errors.length > 0) {

package/.docu/lib/{chunk-PGIHPW5L.js → chunk-MQRFIDS4.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-IN2QAGDZ.js";
+} from "./chunk-6EOUQCRM.js";
 import {
   DIST_DIR
 } from "./chunk-4IQXHHPF.js";

package/.docu/lib/{chunk-PJVCY4FK.js → chunk-U7M5SK76.js}

@@ -137,7 +137,7 @@ async function runBuild() {
     process.env.FLAME_BUILD_SILENT = "1";
     process.env.LOG_LEVEL = "error";
   }
-  const { runBuildCli } = await import("./build.impl-AZBZN66Q.js");
+  const { runBuildCli } = await import("./build.impl-3ZOQORN3.js");
   await runBuildCli();
 }
 async function writeDockerFiles() {