@docubook/flame 1.7.2 → 2.0.0-alpha.1

package/.docu/lib/{chunk-B6LGUADD.js → chunk-TRT6WQZG.js}

@@ -801,13 +801,12 @@ function collectAllLucideIcons() {
     join2(FRAMEWORK_ROOT, "..", "mdx-content", "dist"),
     join2(FRAMEWORK_ROOT, "..", "ui-react", "dist"),
     join2(FRAMEWORK_ROOT, "..", "core", "dist"),
-    join2(FRAMEWORK_ROOT, "..", "runt", "dist"),
     join2(FRAMEWORK_ROOT, "..", "themes-colors", "dist")
   ];
   for (const d of depDirs) scanDirLucideIcons(resolve2(d), icons);
   return [...icons];
 }
-async function buildClientBundle() {
+async function buildClientBundle(mdxSources = {}) {
   await mkdir(ASSETS_DIR, { recursive: true });
   const twKey = tailwindCacheKey();
   await cleanOldBundles(/* @__PURE__ */ new Set([`client-${twKey}.css`]));
@@ -854,7 +853,7 @@ async function buildClientBundle() {
               }
               if (args.importer) {
                 const normalized = normalizeImporterPath(args.importer);
-                if (normalized.includes("/mdx-content/dist/")) {
+                if (normalized.includes("/markdown/dist/")) {
                   return { path: getLucideRealEntry(), namespace: "file" };
                 }
               }
@@ -895,6 +894,61 @@ async function buildClientBundle() {
               };
             });
           }
+        },
+        {
+          // Serves per-page compiled MDX (program format) as real modules so
+          // the client hydrates the content island without `new Function`.
+          // client.ts imports `{ mdxModules } from "./mdx-manifest"`.
+          name: "mdx-hydrate",
+          setup(build2) {
+            const require2 = createRequire(import.meta.url);
+            const mdxModuleDeps = {
+              "react/jsx-runtime": require2.resolve("react/jsx-runtime"),
+              "react/jsx-dev-runtime": require2.resolve("react/jsx-dev-runtime"),
+              "@mdx-js/react": require2.resolve("@mdx-js/react")
+            };
+            build2.onResolve(
+              { filter: /^(react\/jsx-runtime|react\/jsx-dev-runtime|@mdx-js\/react)$/ },
+              (args) => {
+                if (args.namespace !== "mdx-module") return;
+                return { path: mdxModuleDeps[args.path], namespace: "file" };
+              }
+            );
+            build2.onResolve({ filter: /^mdx-module:/ }, (args) => ({
+              path: args.path,
+              namespace: "mdx-module"
+            }));
+            build2.onLoad({ filter: /.*/, namespace: "mdx-module" }, (args) => {
+              const slug = args.path.slice("mdx-module:".length);
+              const contents = mdxSources[slug];
+              if (contents == null) {
+                return {
+                  errors: [{ text: `unknown mdx module: ${slug}` }],
+                  contents: "",
+                  loader: "js"
+                };
+              }
+              return { contents, loader: "js" };
+            });
+            build2.onResolve({ filter: /mdx-manifest$/ }, (args) => ({
+              path: args.path,
+              namespace: "mdx-manifest"
+            }));
+            build2.onLoad({ filter: /.*/, namespace: "mdx-manifest" }, () => {
+              const slugs = Object.keys(mdxSources).sort();
+              const imports = slugs.map((slug, i) => {
+                const key = slug.replace(/["\\]/g, "");
+                return `import * as _mdx${i} from "mdx-module:${key}";`;
+              }).join("\n");
+              const map = slugs.map((slug, i) => `${JSON.stringify(slug)}: _mdx${i}`).join(", ");
+              return {
+                contents: `${imports}
+export const mdxModules = { ${map} };
+`,
+                loader: "js"
+              };
+            });
+          }
         }
       ]
     });
@@ -915,10 +969,196 @@ async function buildClientBundle() {
   return { js: jsFile, css: cssFile };
 }
 
+// .docu/node/git.ts
+import { execFile as execFile2 } from "node:child_process";
+import { stat } from "node:fs/promises";
+function runGit(args) {
+  return new Promise((resolve4, reject) => {
+    execFile2("git", args, { maxBuffer: 16 * 1024 * 1024 }, (err, stdout) => {
+      if (err) reject(err);
+      else resolve4(stdout);
+    });
+  });
+}
+function sanitizePath(filePath) {
+  const cleanPath = filePath.replace(/^\//, "");
+  if (!cleanPath || !/^[a-zA-Z0-9\-_/.\s]+$/.test(cleanPath) || /(^|\/)\.\.($|\/)/.test(cleanPath))
+    return null;
+  return cleanPath;
+}
+async function getGitLastModified(filePath) {
+  const cleanPath = sanitizePath(filePath);
+  if (!cleanPath) return null;
+  try {
+    const text = await runGit(["log", "-1", "--format=%cI", "--", cleanPath]);
+    const date = text.trim();
+    return date || null;
+  } catch {
+    return null;
+  }
+}
+async function getFilesystemMtime(filePath) {
+  try {
+    const stats = await stat(filePath);
+    return stats.mtime.toISOString();
+  } catch {
+    return null;
+  }
+}
+async function getGitLastModifiedBatch(filePaths) {
+  const result = /* @__PURE__ */ new Map();
+  if (filePaths.length === 0) return result;
+  const safePaths = [];
+  for (const fp of filePaths) {
+    const cleanPath = sanitizePath(fp);
+    if (!cleanPath) {
+      console.warn(`[git] getGitLastModifiedBatch: skipping invalid path "${fp}"`);
+      continue;
+    }
+    safePaths.push(cleanPath);
+  }
+  if (safePaths.length === 0) return result;
+  try {
+    const text = await runGit([
+      "log",
+      "--format=%cI",
+      "--name-only",
+      "--diff-filter=ACMR",
+      ...safePaths
+    ]);
+    let currentDate = "";
+    for (const line of text.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      if (/^\d{4}-\d{2}-\d{2}T/.test(trimmed)) {
+        currentDate = trimmed;
+      } else if (currentDate && !result.has(trimmed)) {
+        result.set(trimmed, currentDate);
+      }
+    }
+  } catch (err) {
+    console.error("Failed to get git last modified batch for", filePaths, err);
+  }
+  return result;
+}
+
+// .docu/node/mdx.ts
+import React from "react";
+import { z } from "zod";
+import {
+  serialize,
+  extractTocsFromRawMdx,
+  extractFrontmatterWithContent,
+  createDefaultRehypePlugins,
+  createDefaultRemarkPlugins,
+  MDXRemote
+} from "@docubook/core";
+import { createMdxComponents } from "@docubook/markdown";
+function appendHtml(value) {
+  if (typeof value !== "string") return null;
+  if (/^https?:\/\//.test(value)) return null;
+  if (!value.startsWith("/docs/")) return null;
+  if (value.includes("#")) return null;
+  if (value.endsWith(".html")) return null;
+  return `${value}.html`;
+}
+function rehypeDocsHtmlLinks() {
+  return (tree) => {
+    function walk(node) {
+      if (node.type === "element" && node.tagName === "a") {
+        const fixed = appendHtml(node.properties?.href);
+        if (fixed) node.properties.href = fixed;
+      }
+      if (node.children) {
+        for (const child of node.children) walk(child);
+      }
+    }
+    walk(tree);
+    return tree;
+  };
+}
+function remarkMdxJsxDocsHtmlLinks() {
+  return (tree) => {
+    function walk(node) {
+      if ((node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.attributes) {
+        for (const attr of node.attributes) {
+          if (attr.type === "mdxJsxAttribute" && attr.name === "href") {
+            const fixed = appendHtml(attr.value);
+            if (fixed) attr.value = fixed;
+          }
+        }
+      }
+      if (node.children) {
+        for (const child of node.children) walk(child);
+      }
+    }
+    walk(tree);
+    return tree;
+  };
+}
+var frontmatterSchema = z.object({
+  title: z.coerce.string().optional(),
+  description: z.coerce.string().optional(),
+  image: z.coerce.string().optional(),
+  date: z.coerce.string().optional()
+});
+function frontmatterField(frontmatter, key) {
+  return typeof frontmatter[key] === "string" ? frontmatter[key] : "";
+}
+async function serializeWithDocPlugins(rawMdx, opts = {}) {
+  const { strippedContent } = extractFrontmatterWithContent(
+    rawMdx,
+    opts.frontmatterSchema
+  );
+  const defaultRemark = createDefaultRemarkPlugins();
+  const defaultRehype = createDefaultRehypePlugins();
+  const finalRemark = [...defaultRemark, remarkMdxJsxDocsHtmlLinks, ...opts.remarkPlugins ?? []];
+  const finalRehype = [...defaultRehype, rehypeDocsHtmlLinks, ...opts.rehypePlugins ?? []];
+  return serialize(strippedContent, {
+    outputFormat: opts.outputFormat,
+    format: "md",
+    mdxOptions: {
+      rehypePlugins: finalRehype,
+      remarkPlugins: finalRemark
+    }
+  });
+}
+async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugins, frontmatterSchema2) {
+  const tocs = extractTocsFromRawMdx(rawMdx);
+  const { frontmatter } = extractFrontmatterWithContent(rawMdx, frontmatterSchema2);
+  const serialized = await serializeWithDocPlugins(rawMdx, {
+    remarkPlugins,
+    rehypePlugins,
+    frontmatterSchema: frontmatterSchema2
+  });
+  const components = createMdxComponents();
+  const content = React.createElement(MDXRemote, {
+    compiledSource: serialized.compiledSource,
+    scope: {},
+    frontmatter: {},
+    components
+  });
+  const date = frontmatter.date || gitDates?.get(filePath) || await getGitLastModified(filePath) || await getFilesystemMtime(filePath) || void 0;
+  return {
+    content,
+    compiledSource: serialized.compiledSource,
+    frontmatter: { ...frontmatter, date },
+    tocs
+  };
+}
+async function compileMdxModule(rawMdx, remarkPlugins, rehypePlugins) {
+  const serialized = await serializeWithDocPlugins(rawMdx, {
+    outputFormat: "program",
+    remarkPlugins,
+    rehypePlugins
+  });
+  return serialized.compiledSource;
+}
+
 // .docu/node/search-indexer.ts
 import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2 } from "node:fs/promises";
 import { resolve as resolve3, join as join3 } from "node:path";
-import { extractFrontmatterWithContent } from "@docubook/core";
+import { extractFrontmatterWithContent as extractFrontmatterWithContent2 } from "@docubook/core";
 var docuConfig = loadDocuConfig();
 function getSectionTitle(filePath) {
   const parts = filePath.split("/");
@@ -943,11 +1183,11 @@ function stripJsx(content) {
   return result;
 }
 function extractRecords(filePath, raw) {
-  const { frontmatter, strippedContent: content } = extractFrontmatterWithContent(raw);
+  const { frontmatter, strippedContent: content } = extractFrontmatterWithContent2(raw);
   const records = [];
   const url = docsHtmlHref(`/docs/${filePath}`);
   const lvl0 = getSectionTitle(filePath);
-  const lvl1 = frontmatter.title || null;
+  const lvl1 = frontmatterField(frontmatter, "title") || null;
   const hierarchy = {
     lvl0,
     lvl1,
@@ -961,7 +1201,7 @@ function extractRecords(filePath, raw) {
     records.push({
       url,
       hierarchy: { ...hierarchy },
-      content: frontmatter.description || null,
+      content: frontmatterField(frontmatter, "description") || null,
       type: "lvl1"
     });
   }
@@ -1071,161 +1311,6 @@ function captureException(err, context) {
   sentry.captureException(err, context ? { extra: context } : void 0);
 }
 
-// .docu/node/git.ts
-import { execFile as execFile2 } from "node:child_process";
-import { stat } from "node:fs/promises";
-function runGit(args) {
-  return new Promise((resolve4, reject) => {
-    execFile2("git", args, { maxBuffer: 16 * 1024 * 1024 }, (err, stdout) => {
-      if (err) reject(err);
-      else resolve4(stdout);
-    });
-  });
-}
-function sanitizePath(filePath) {
-  const cleanPath = filePath.replace(/^\//, "");
-  if (!cleanPath || !/^[a-zA-Z0-9\-_/.\s]+$/.test(cleanPath) || /(^|\/)\.\.($|\/)/.test(cleanPath))
-    return null;
-  return cleanPath;
-}
-async function getGitLastModified(filePath) {
-  const cleanPath = sanitizePath(filePath);
-  if (!cleanPath) return null;
-  try {
-    const text = await runGit(["log", "-1", "--format=%cI", "--", cleanPath]);
-    const date = text.trim();
-    return date || null;
-  } catch {
-    return null;
-  }
-}
-async function getFilesystemMtime(filePath) {
-  try {
-    const stats = await stat(filePath);
-    return stats.mtime.toISOString();
-  } catch {
-    return null;
-  }
-}
-async function getGitLastModifiedBatch(filePaths) {
-  const result = /* @__PURE__ */ new Map();
-  if (filePaths.length === 0) return result;
-  const safePaths = [];
-  for (const fp of filePaths) {
-    const cleanPath = sanitizePath(fp);
-    if (!cleanPath) {
-      console.warn(`[git] getGitLastModifiedBatch: skipping invalid path "${fp}"`);
-      continue;
-    }
-    safePaths.push(cleanPath);
-  }
-  if (safePaths.length === 0) return result;
-  try {
-    const text = await runGit([
-      "log",
-      "--format=%cI",
-      "--name-only",
-      "--diff-filter=ACMR",
-      ...safePaths
-    ]);
-    let currentDate = "";
-    for (const line of text.split("\n")) {
-      const trimmed = line.trim();
-      if (!trimmed) continue;
-      if (/^\d{4}-\d{2}-\d{2}T/.test(trimmed)) {
-        currentDate = trimmed;
-      } else if (currentDate && !result.has(trimmed)) {
-        result.set(trimmed, currentDate);
-      }
-    }
-  } catch (err) {
-    console.error("Failed to get git last modified batch for", filePaths, err);
-  }
-  return result;
-}
-
-// .docu/node/mdx.ts
-import React from "react";
-import {
-  serialize,
-  extractTocsFromRawMdx,
-  extractFrontmatterWithContent as extractFrontmatterWithContent2,
-  createDefaultRehypePlugins,
-  createDefaultRemarkPlugins,
-  MDXRemote
-} from "@docubook/core";
-import { createMdxComponents } from "@docubook/mdx-content";
-function appendHtml(value) {
-  if (typeof value !== "string") return null;
-  if (/^https?:\/\//.test(value)) return null;
-  if (!value.startsWith("/docs/")) return null;
-  if (value.includes("#")) return null;
-  if (value.endsWith(".html")) return null;
-  return `${value}.html`;
-}
-function rehypeDocsHtmlLinks() {
-  return (tree) => {
-    function walk(node) {
-      if (node.type === "element" && node.tagName === "a") {
-        const fixed = appendHtml(node.properties?.href);
-        if (fixed) node.properties.href = fixed;
-      }
-      if (node.children) {
-        for (const child of node.children) walk(child);
-      }
-    }
-    walk(tree);
-    return tree;
-  };
-}
-function remarkMdxJsxDocsHtmlLinks() {
-  return (tree) => {
-    function walk(node) {
-      if ((node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.attributes) {
-        for (const attr of node.attributes) {
-          if (attr.type === "mdxJsxAttribute" && attr.name === "href") {
-            const fixed = appendHtml(attr.value);
-            if (fixed) attr.value = fixed;
-          }
-        }
-      }
-      if (node.children) {
-        for (const child of node.children) walk(child);
-      }
-    }
-    walk(tree);
-    return tree;
-  };
-}
-async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugins) {
-  const tocs = extractTocsFromRawMdx(rawMdx);
-  const { frontmatter, strippedContent } = extractFrontmatterWithContent2(rawMdx);
-  const defaultRemark = createDefaultRemarkPlugins();
-  const defaultRehype = createDefaultRehypePlugins();
-  const finalRemark = [...defaultRemark, remarkMdxJsxDocsHtmlLinks, ...remarkPlugins ?? []];
-  const finalRehype = [...defaultRehype, rehypeDocsHtmlLinks, ...rehypePlugins ?? []];
-  const serialized = await serialize(strippedContent, {
-    mdxOptions: {
-      rehypePlugins: finalRehype,
-      remarkPlugins: finalRemark
-    }
-  });
-  const components = createMdxComponents();
-  const content = React.createElement(MDXRemote, {
-    compiledSource: serialized.compiledSource,
-    scope: {},
-    frontmatter: {},
-    components
-  });
-  const date = frontmatter.date || gitDates?.get(filePath) || await getGitLastModified(filePath) || await getFilesystemMtime(filePath) || void 0;
-  return {
-    content,
-    compiledSource: serialized.compiledSource,
-    frontmatter: { ...frontmatter, date },
-    tocs
-  };
-}
-
 // .docu/pages/docs/[[...slug]].tsx
 import { ChevronLeft, ChevronRight } from "lucide-react";
 
@@ -1248,6 +1333,9 @@ function DocsBreadcrumb({ paths }) {
 }
 
 // .docu/node/route.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { join as join4 } from "node:path";
+import { extractFrontmatter } from "@docubook/core";
 var docuConfig2 = loadDocuConfig();
 var routes = resolveRoutes(docuConfig2.routes);
 function flattenRoutes() {
@@ -1276,8 +1364,42 @@ 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 = "";
+  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;
+      } catch {
+      }
+    }
+    if (description) break;
+  }
+  descriptionCache.set(href, description);
+  return description;
+}
 function getPreviousNext(pathname) {
   const normalizedPath = pathname.replace(/^\/|$/g, "");
+  if (normalizedPath === "docs" || normalizedPath === "") {
+    const paths2 = flattenRoutes();
+    const routeMap2 = getRouteMap();
+    const first = paths2[0];
+    if (!first) return { prev: null, next: null };
+    return {
+      prev: null,
+      next: {
+        href: first,
+        title: routeMap2.get(first) || "",
+        description: readDescription(first)
+      }
+    };
+  }
   const paths = flattenRoutes();
   const index = paths.findIndex((href) => href === `/${normalizedPath}` || href === normalizedPath);
   if (index === -1) {
@@ -1288,7 +1410,11 @@ function getPreviousNext(pathname) {
   const nextHref = index < paths.length - 1 ? paths[index + 1] : null;
   return {
     prev: prevHref ? { href: prevHref, title: routeMap.get(prevHref) || "" } : null,
-    next: nextHref ? { href: nextHref, title: routeMap.get(nextHref) || "" } : null
+    next: nextHref ? {
+      href: nextHref,
+      title: routeMap.get(nextHref) || "",
+      description: readDescription(nextHref)
+    } : null
   };
 }
 
@@ -1310,7 +1436,11 @@ function Pagination({
     PaginationDocs,
     {
       prev: prev ? { href: docsHtmlHref(`/docs${prev.href}`), title: prev.title } : void 0,
-      next: next ? { href: docsHtmlHref(`/docs${next.href}`), title: next.title } : void 0,
+      next: next ? {
+        href: docsHtmlHref(`/docs${next.href}`),
+        title: next.title,
+        description: next.description
+      } : void 0,
       className,
       prevIcon,
       nextIcon,
@@ -1322,7 +1452,7 @@ function Pagination({
 // .docu/components/Typography.tsx
 import { jsx as jsx3 } from "react/jsx-runtime";
 function Typography({ children }) {
-  return /* @__PURE__ */ jsx3("div", { className: "prose prose-zinc dark:prose-invert prose-code:font-code dark:prose-code:bg-stone-900/25 prose-code:bg-stone-50 prose-pre:bg-background max-lg:prose-headings:scroll-mt-54 prose-headings:scroll-mt-4 prose-code:text-sm prose-code:leading-6 dark:prose-code:text-white prose-code:text-stone-800 prose-code:p-1 prose-code:rounded-md prose-code:border prose-img:rounded-md prose-img:border prose-code:before:content-none prose-code:after:content-none prose-code:px-1.5 prose-code:overflow-x-auto prose-img:my-3 prose-h2:my-4 prose-h2:mt-8 max-w-full! w-full pt-2", children });
+  return /* @__PURE__ */ jsx3("div", { className: "prose prose-zinc dark:prose-invert prose-code:font-code dark:prose-code:bg-stone-900/25 prose-code:bg-stone-50 prose-pre:bg-background max-lg:prose-headings:scroll-mt-16 prose-headings:scroll-mt-4 prose-code:text-sm prose-code:leading-6 dark:prose-code:text-white prose-code:text-stone-800 prose-code:p-1 prose-code:rounded-md prose-code:border prose-img:rounded-md prose-img:border prose-code:before:content-none prose-code:after:content-none prose-code:px-1.5 prose-code:overflow-x-auto prose-img:my-3 prose-h2:my-4 prose-h2:mt-8 w-full max-w-full! pt-2", children });
 }
 
 // .docu/components/EditWith.tsx
@@ -1586,12 +1716,19 @@ function Toc({ tocs }) {
   useEffect2(() => {
     activeIdRef.current = activeId;
   }, [activeId]);
+  const getAnchorOffset = useCallback2(() => {
+    if (typeof window === "undefined") return 100;
+    const first = tocs[0] ? document.getElementById(tocs[0].href.slice(1)) : null;
+    const margin = first ? parseFloat(getComputedStyle(first).scrollMarginTop) : 0;
+    return margin || 100;
+  }, [tocs]);
   useEffect2(() => {
-    if (typeof document === "undefined" || !tocs.length) return;
+    if (typeof window === "undefined" || window.innerWidth < 1024) return;
+    if (!tocs.length) return;
     const isDesktop = window.innerWidth >= 1024;
     const container = isDesktop ? document.getElementById("scroll-container") : null;
     const scrollTarget = container || window;
-    const offset = isDesktop ? 80 : 100;
+    const offset = getAnchorOffset();
     const handleScroll = () => {
       if (clickedIdRef.current) return;
       let currentId = null;
@@ -1625,7 +1762,7 @@ function Toc({ tocs }) {
       scrollTarget.removeEventListener("scroll", listener);
       if (throttleTimer) clearTimeout(throttleTimer);
     };
-  }, [tocs]);
+  }, [tocs, getAnchorOffset]);
   const handleLinkClick = useCallback2((id) => {
     clickedIdRef.current = id;
     setActiveId(id);
@@ -1647,7 +1784,7 @@ function Toc({ tocs }) {
       /* @__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 left-0 top-0 h-full w-px" }),
+      /* @__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;
@@ -1697,14 +1834,29 @@ function Toc({ tocs }) {
                     e.preventDefault();
                     handleLinkClick(id);
                     const el = document.getElementById(id);
-                    if (el) el.scrollIntoView({ behavior: "smooth" });
+                    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 break-words text-sm", children: text })
+                  children: /* @__PURE__ */ jsx8("span", { className: "line-clamp-2 text-sm break-words", children: text })
                 }
               )
             ]
@@ -1728,6 +1880,7 @@ function DocsPage({
   tocs,
   filePath,
   repoUrl,
+  mdxSlug,
   compiledSource
 }) {
   const pathname = slug.join("/");
@@ -1736,7 +1889,7 @@ function DocsPage({
     "div",
     {
       id: "scroll-container",
-      className: "bg-base-100 border-base-300 max-lg:scroll-p-54 relative flex w-full flex-col items-start rounded-b-3xl border shadow-md lg:h-full lg:flex-row lg:overflow-y-auto lg:rounded-xl",
+      className: "bg-base-100 border-base-300 relative flex w-full flex-col items-start rounded-b-3xl border shadow-md max-lg:scroll-p-54 lg:h-full lg:flex-row lg:overflow-y-auto lg:rounded-xl",
       children: [
         /* @__PURE__ */ jsx9(
           "div",
@@ -1758,7 +1911,14 @@ function DocsPage({
                 /* @__PURE__ */ jsxs6(Typography, { children: [
                   /* @__PURE__ */ jsx9("h1", { className: "-mt-0.5 text-3xl", children: title }),
                   description && /* @__PURE__ */ jsx9("p", { className: "text-muted-foreground -mt-4 text-[16.5px]", children: description }),
-                  /* @__PURE__ */ jsx9("div", { id: "mdx-content-island", children: content }),
+                  /* @__PURE__ */ jsx9(
+                    "div",
+                    {
+                      id: "mdx-content-island",
+                      "data-mdx-slug": mdxSlug,
+                      dangerouslySetInnerHTML: { __html: content }
+                    }
+                  ),
                   compiledSource && /* @__PURE__ */ jsx9(
                     "script",
                     {
@@ -1842,8 +2002,8 @@ function renderActionButtonIcon(iconName, className) {
 }
 function ActionButton({ action }) {
   const themeClasses = {
-    primary: "bg-primary text-primary-content hover:bg-primary/90",
-    secondary: "bg-secondary text-secondary-content hover:bg-secondary/90",
+    primary: "bg-primary text-primary-foreground hover:bg-primary/90",
+    secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/90",
     ghost: "bg-transparent text-muted-foreground border border-base-300 hover:bg-base-200"
   };
   const isExternal = isExternalLink(action.link);
@@ -1868,8 +2028,8 @@ function Hero({ hero, className }) {
   const { tagline, headline, description, actions } = hero;
   return /* @__PURE__ */ jsx12("div", { className: cn("mx-auto max-w-4xl px-6 py-32 sm:py-44", className), children: /* @__PURE__ */ jsxs8("div", { className: "text-center", children: [
     tagline && /* @__PURE__ */ jsx12("p", { className: "text-primary mb-4 text-lg font-semibold", children: tagline }),
-    /* @__PURE__ */ jsx12("h1", { className: "text-balance text-5xl font-semibold tracking-tight sm:text-7xl", children: headline }),
-    description && /* @__PURE__ */ jsx12("p", { className: "text-muted-foreground mt-8 text-pretty text-lg sm:text-xl", children: description }),
+    /* @__PURE__ */ jsx12("h1", { className: "text-5xl font-semibold tracking-tight text-balance sm:text-7xl", children: headline }),
+    description && /* @__PURE__ */ jsx12("p", { className: "text-muted-foreground mt-8 text-lg text-pretty sm:text-xl", children: description }),
     actions && actions.length > 0 && /* @__PURE__ */ jsx12("div", { className: "mt-10 flex flex-wrap items-center justify-center gap-4", children: actions.map((action, index) => /* @__PURE__ */ jsx12(ActionButton, { action }, index)) })
   ] }) });
 }
@@ -1956,7 +2116,7 @@ function IndexPage() {
     description: meta.description
   };
   return /* @__PURE__ */ jsxs10("div", { className: "bg-base-100 relative isolate min-h-screen overflow-hidden", children: [
-    /* @__PURE__ */ jsx14("div", { className: "absolute right-4 top-4 z-10", id: "theme-island" }),
+    /* @__PURE__ */ jsx14("div", { className: "absolute top-4 right-4 z-10", id: "theme-island" }),
     /* @__PURE__ */ jsx14(
       "div",
       {
@@ -2360,7 +2520,8 @@ function htmlShell(opts) {
     themeCss,
     depth = 0,
     headExtra,
-    bodyExtra
+    bodyExtra,
+    absoluteAssets = false
   } = opts;
   const nonceAttr = nonce ? ` nonce="${escapeHtml(nonce)}"` : "";
   const themeStyle = themeCss ? `
@@ -2370,8 +2531,8 @@ function htmlShell(opts) {
   const bodyInjection = bodyExtra?.length ? `
   ${bodyExtra.join("\n  ")}` : "";
   const depthPrefix = depth === 0 ? "" : "../".repeat(depth);
-  const assetPrefix = depthPrefix + "assets/";
-  const resolvePath = (path) => path.startsWith("/") ? depthPrefix + path.slice(1) : path;
+  const assetPrefix = absoluteAssets ? "/assets/" : depthPrefix + "assets/";
+  const resolvePath = (path) => absoluteAssets ? path : path.startsWith("/") ? depthPrefix + path.slice(1) : path;
   let seoTags = "";
   if (opts.seo) {
     const s = opts.seo;
@@ -2452,11 +2613,13 @@ export {
   BuildPluginBuilder,
   computeInlineThemeCss,
   buildClientBundle,
+  getGitLastModifiedBatch,
+  frontmatterField,
+  compileMdx,
+  compileMdxModule,
   generateSearchIndex,
   initSentry,
   captureException,
-  getGitLastModifiedBatch,
-  compileMdx,
   DocsPage,
   NotFoundPage,
   IndexPage,