@docubook/flame 1.0.0-beta.60 → 1.0.0-beta.80

package/.docu/components/Anchor.tsx

@@ -1,6 +1,6 @@
 import { AnchorHTMLAttributes, ReactNode } from "react";
 import { ArrowUpRight } from "lucide-react";
-import { cn, isExternalUrl } from "../lib/utils";
+import { cn, isExternalUrl } from "../node/utils";
 
 export interface AnchorProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
   href?: string;

package/.docu/components/Context.tsx

@@ -1,9 +1,9 @@
 "use client";
 
 import { useState } from "react";
-import { cn } from "../lib/utils";
+import { cn } from "../node/utils";
 import { Dropdown, DropdownItem } from "./base/dropdown";
-import { routes } from "../lib/client-routes";
+import { routes } from "../node/client-routes";
 import { ChevronsUpDown, Check, type LucideIcon } from "lucide-react";
 import * as LucideIcons from "lucide-react";
 

package/.docu/components/DocsLayout.tsx

@@ -1,5 +1,5 @@
 import React from "react";
-import { loadDocuConfig } from "../lib/paths";
+import { loadDocuConfig } from "../node/paths";
 import Menu from "./Menu";
 
 const docuConfig = loadDocuConfig();

package/.docu/components/EditWith.tsx

@@ -1,5 +1,5 @@
 import { SquarePen } from "lucide-react";
-import { isEditEnabled, getEditLink, getRepoUrl } from "../lib/helpers";
+import { isEditEnabled, getEditLink, getRepoUrl } from "../node/helpers";
 
 export interface EditWithProps {
   filePath: string;

package/.docu/components/Menu.tsx

@@ -2,8 +2,8 @@
 
 import { useState } from "react";
 import Sublink from "./Sublink";
-import type { DocuRoute } from "../lib/types";
-import { cn } from "../lib/utils";
+import type { DocuRoute } from "../node/types";
+import { cn } from "../node/utils";
 
 interface MenuProps {
   onNavigate?: () => void;

package/.docu/components/Navbar.tsx

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import { useState } from "react";
 import Anchor from "./Anchor";
-import { cn } from "../lib/utils";
+import { cn } from "../node/utils";
 import {
   Navbar as BaseNavbar,
   Logo as BaseLogo,

package/.docu/components/Pagination.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { getPreviousNext } from "../lib/route";
+import { getPreviousNext } from "../node/route";
 import { PaginationDocs } from "./base/pagination";
 
 interface PaginationProps {

package/.docu/components/ScrollTo.tsx

@@ -2,7 +2,7 @@
 
 import { ArrowUpIcon } from "lucide-react";
 import { useEffect, useState, useCallback } from "react";
-import { cn } from "../lib/utils";
+import { cn } from "../node/utils";
 
 interface ScrollToProps {
   className?: string;

package/.docu/components/Search.tsx

@@ -4,9 +4,9 @@ import { useState, useEffect, useRef, useCallback } from "react";
 import { Search as SearchIcon, FileText, CornerDownLeft, Hash, AlignLeft } from "lucide-react";
 import { Modal, useModal } from "./base/modal";
 import { Kbd, FnKey } from "./base/kbd";
-import { cn } from "../lib/utils";
-import { search, type SearchResult } from "../lib/search";
-import type { SearchRecord } from "../lib/search-indexer";
+import { cn } from "../node/utils";
+import { search, type SearchResult } from "../node/search";
+import type { SearchRecord } from "../node/search-indexer";
 
 interface SearchProps {
   className?: string;
@@ -123,7 +123,7 @@ export default function Search({ className }: SearchProps) {
         boxClassName="w-[calc(100%-2rem)] max-w-[640px] p-0 mx-auto relative z-10"
       >
         <div onKeyDown={handleKeyDown}>
-          <div className="px-4 pt-4 pb-2">
+          <div className="px-4 pb-2 pt-4">
             <div className="border-base-300 flex items-center gap-3 rounded-lg border px-4 py-2.5">
               <SearchIcon className="text-primary h-5 w-5 shrink-0" />
               <input
@@ -132,7 +132,7 @@ export default function Search({ className }: SearchProps) {
                 onChange={handleQueryChange}
                 placeholder="Search documentation..."
                 autoFocus
-                className="placeholder:text-base-content/40 h-8 w-full border-none bg-transparent text-base ring-0 outline-none focus:ring-0 focus:outline-none"
+                className="placeholder:text-base-content/40 h-8 w-full border-none bg-transparent text-base outline-none ring-0 focus:outline-none focus:ring-0"
                 aria-label="Search documentation"
               />
               {query && (
@@ -264,7 +264,7 @@ function GroupedResults({
     <div className="flex flex-col gap-1">
       {groups.map((group) => (
         <div key={group.section}>
-          <div className="text-base-content/50 px-2 pt-3 pb-1 text-xs font-semibold">
+          <div className="text-base-content/50 px-2 pb-1 pt-3 text-xs font-semibold">
             {group.section}
           </div>
           {group.items.map(({ result, globalIndex }) => {

package/.docu/components/Sidebar.tsx

@@ -10,14 +10,14 @@ import {
   FileText,
 } from "lucide-react";
 import { Dropdown, DropdownLink } from "./base/dropdown";
-import { cn } from "../lib/utils";
+import { cn } from "../node/utils";
 import { Context } from "./Context";
 import Menu from "./Menu";
 import { ThemeToggle } from "./Theme";
 import { GitHubLink } from "./Navbar";
 import Search from "./Search";
-import type { TocItem } from "../lib/types";
-import { config as docuConfig, routes } from "../lib/client-routes";
+import type { TocItem } from "../node/types";
+import { config as docuConfig, routes } from "../node/client-routes";
 
 interface SidebarProps {
   tocs?: TocItem[];

package/.docu/components/Social.tsx

@@ -1,4 +1,4 @@
-import { getSocialLinks } from "../lib/helpers";
+import { getSocialLinks } from "../node/helpers";
 
 export interface SocialProps {
   className?: string;

package/.docu/components/Sublink.tsx

@@ -3,8 +3,8 @@
 import { useState } from "react";
 import { ChevronDown } from "lucide-react";
 import Anchor from "./Anchor";
-import type { DocuRoute } from "../lib/types";
-import { cn } from "../lib/utils";
+import type { DocuRoute } from "../node/types";
+import { cn } from "../node/utils";
 
 interface SublinkProps extends DocuRoute {
   level: number;

package/.docu/components/Toc.tsx

@@ -2,9 +2,9 @@
 
 import { useState, useCallback, useEffect, useRef } from "react";
 import { ListIcon } from "lucide-react";
-import { cn } from "../lib/utils";
+import { cn } from "../node/utils";
 import { ScrollTo } from "./ScrollTo";
-import { TocItem } from "../lib/types";
+import { TocItem } from "../node/types";
 
 interface TocProps {
   tocs: TocItem[];

package/.docu/components/base/collapse.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 import { ChevronDown, ChevronRight, Plus, Minus } from "lucide-react";
 import { useState, type ReactNode } from "react";
 

package/.docu/components/base/drawer.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 import { X } from "lucide-react";
 import { useState, type ReactNode } from "react";
 

package/.docu/components/base/dropdown.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { type HTMLAttributes, type ReactNode, forwardRef, useRef, useEffect } from "react";
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 
 export interface DropdownProps extends HTMLAttributes<HTMLDetailsElement> {
   align?: "start" | "end";

package/.docu/components/base/input.tsx

@@ -1,5 +1,5 @@
 import { forwardRef } from "react";
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 
 type InputColor =
   | "neutral"

package/.docu/components/base/kbd.tsx

@@ -13,7 +13,7 @@ import {
   Delete,
   ArrowRightToLine,
 } from "lucide-react";
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 
 type KbdSize = "xs" | "sm" | "md" | "lg" | "xl";
 

package/.docu/components/base/modal.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { forwardRef, useRef, useCallback } from "react";
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 
 interface ModalProps extends React.DialogHTMLAttributes<HTMLDialogElement> {
   children: React.ReactNode;

package/.docu/components/base/pagination/index.ts

@@ -0,0 +1,21 @@
+export { PaginationDocs } from "./pagination-docs";
+export {
+  Pagination,
+  PaginationItem,
+  PaginationButtons,
+  PaginationRange,
+  PaginationInfo,
+  PaginationFull,
+} from "./pagination-numbers";
+export { getPaginationRange } from "./types";
+export type {
+  PaginationRootProps as PaginationProps,
+  PaginationItemProps,
+  PaginationRangeProps,
+  PaginationButtonsProps,
+  PaginationInfoProps,
+  PaginationFullProps,
+  PaginationDocsProps,
+  PaginationSize,
+  PaginationVariant,
+} from "./types";

package/.docu/components/base/pagination/pagination-docs.tsx

@@ -0,0 +1,39 @@
+import { cn } from "../../../node/utils";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+import type { PaginationDocsProps } from "./types";
+
+export function PaginationDocs({ prev, next, className }: PaginationDocsProps) {
+  return (
+    <div className={cn("grid grow grid-cols-1 gap-4 py-8 sm:grid-cols-2", className)}>
+      <div>
+        {prev && (
+          <a
+            href={prev.href}
+            className="btn btn-outline border-base-300 items-start! py-2! h-auto w-full flex-col pl-4 no-underline"
+          >
+            <span className="text-muted-foreground flex items-center text-xs">
+              <ChevronLeft className="mr-1 h-4 w-4" />
+              Previous
+            </span>
+            <span className="text-base-content mt-1 text-sm font-medium">{prev.title}</span>
+          </a>
+        )}
+      </div>
+
+      <div>
+        {next && (
+          <a
+            href={next.href}
+            className="btn btn-outline border-base-300 items-end! py-2! h-auto w-full flex-col pr-4 no-underline"
+          >
+            <span className="text-muted-foreground flex items-center text-xs">
+              Next
+              <ChevronRight className="ml-1 h-4 w-4" />
+            </span>
+            <span className="text-base-content mt-1 text-sm font-medium">{next.title}</span>
+          </a>
+        )}
+      </div>
+    </div>
+  );
+}

package/.docu/components/base/{pagination.tsx → pagination/pagination-numbers.tsx}

@@ -1,136 +1,17 @@
 "use client";
 
-import { cn } from "../../lib/utils";
+import { cn } from "../../../node/utils";
 import { ChevronLeft, ChevronRight } from "lucide-react";
-import { useMemo, type ReactNode } from "react";
-
-type PaginationSize = "lg" | "md" | "sm" | "xs";
-type PaginationVariant = "default" | "square" | "rounded";
-
-interface PaginationRootProps {
-  children?: ReactNode;
-  className?: string;
-  size?: PaginationSize;
-  variant?: PaginationVariant;
-}
-
-interface PaginationItemProps {
-  children: ReactNode;
-  active?: boolean;
-  disabled?: boolean;
-  onClick?: () => void;
-  className?: string;
-  size?: PaginationSize;
-  variant?: PaginationVariant;
-  "aria-label"?: string;
-}
-
-interface PaginationRangeProps {
-  start: number;
-  end: number;
-  total: number;
-  current: number;
-  onPageChange: (page: number) => void;
-  siblingCount?: number;
-  className?: string;
-  size?: PaginationSize;
-  variant?: PaginationVariant;
-}
-
-interface PaginationButtonsProps {
-  page: number;
-  totalPages: number;
-  onPageChange: (page: number) => void;
-  className?: string;
-  size?: PaginationSize;
-  showFirstLast?: boolean;
-  showPrevNext?: boolean;
-  prevLabel?: string;
-  nextLabel?: string;
-  firstLabel?: string;
-  lastLabel?: string;
-  disabled?: boolean;
-}
-
-interface PaginationInfoProps {
-  current: number;
-  total: number;
-  pageSize?: number;
-  className?: string;
-  label?: string;
-  showTotal?: boolean;
-}
-
-interface PaginationFullProps {
-  current: number;
-  total: number;
-  pageSize?: number;
-  onPageChange: (page: number) => void;
-  siblingCount?: number;
-  className?: string;
-  size?: PaginationSize;
-  variant?: PaginationVariant;
-  showFirstLast?: boolean;
-  showPrevNext?: boolean;
-  infoClassName?: string;
-}
-
-interface PaginationDocsProps {
-  prev?: { href: string; title: string };
-  next?: { href: string; title: string };
-  className?: string;
-}
-
-function getPaginationRange({
-  totalCount,
-  pageSize,
-  siblingCount = 1,
-  currentPage,
-}: {
-  totalCount: number;
-  pageSize: number;
-  siblingCount?: number;
-  currentPage: number;
-}): (number | "ellipsis")[] {
-  const totalPages = Math.ceil(totalCount / pageSize);
-  const DOTS = "ellipsis" as const;
-
-  if (totalPages === 1) {
-    return [1];
-  }
-
-  const totalPageNumbers = siblingCount + 5;
-
-  if (totalPages < totalPageNumbers) {
-    return Array.from({ length: totalPages }, (_, i) => i + 1);
-  }
-
-  const leftSiblingIndex = Math.max(currentPage - siblingCount, 1);
-  const rightSiblingIndex = Math.min(currentPage + siblingCount, totalPages);
-
-  const showLeftDots = leftSiblingIndex > 2;
-  const showRightDots = rightSiblingIndex < totalPages - 1;
-
-  if (!showLeftDots && showRightDots) {
-    const leftRange = Array.from({ length: 3 }, (_, i) => i + 1);
-    return [...leftRange, DOTS, totalPages - 1, totalPages];
-  }
-
-  if (showLeftDots && !showRightDots) {
-    const rightRange = Array.from({ length: 3 }, (_, i) => totalPages - 2 + i);
-    return [1, 2, DOTS, ...rightRange];
-  }
-
-  if (showLeftDots && showRightDots) {
-    const middleRange = Array.from(
-      { length: rightSiblingIndex - leftSiblingIndex + 1 },
-      (_, i) => leftSiblingIndex + i
-    );
-    return [1, 2, DOTS, ...middleRange, DOTS, totalPages - 1, totalPages];
-  }
-
-  return [1];
-}
+import { useMemo } from "react";
+import {
+  getPaginationRange,
+  type PaginationRootProps,
+  type PaginationItemProps,
+  type PaginationButtonsProps,
+  type PaginationRangeProps,
+  type PaginationInfoProps,
+  type PaginationFullProps,
+} from "./types";
 
 export function Pagination({
   children,
@@ -496,53 +377,3 @@ export function PaginationFull({
     </div>
   );
 }
-
-export function PaginationDocs({ prev, next, className }: PaginationDocsProps) {
-  return (
-    <div className={cn("grid grow grid-cols-1 gap-4 py-8 sm:grid-cols-2", className)}>
-      <div>
-        {prev && (
-          <a
-            href={prev.href}
-            className="btn btn-outline border-base-300 h-auto w-full flex-col items-start! py-2! pl-4 no-underline"
-          >
-            <span className="text-muted-foreground flex items-center text-xs">
-              <ChevronLeft className="mr-1 h-4 w-4" />
-              Previous
-            </span>
-            <span className="text-base-content mt-1 text-sm font-medium">{prev.title}</span>
-          </a>
-        )}
-      </div>
-
-      <div>
-        {next && (
-          <a
-            href={next.href}
-            className="btn btn-outline border-base-300 h-auto w-full flex-col items-end! py-2! pr-4 no-underline"
-          >
-            <span className="text-muted-foreground flex items-center text-xs">
-              Next
-              <ChevronRight className="ml-1 h-4 w-4" />
-            </span>
-            <span className="text-base-content mt-1 text-sm font-medium">{next.title}</span>
-          </a>
-        )}
-      </div>
-    </div>
-  );
-}
-
-export type {
-  PaginationRootProps as PaginationProps,
-  PaginationItemProps,
-  PaginationRangeProps,
-  PaginationButtonsProps,
-  PaginationInfoProps,
-  PaginationFullProps,
-  PaginationDocsProps,
-  PaginationSize,
-  PaginationVariant,
-};
-
-export { getPaginationRange };

package/.docu/components/base/pagination/types.ts

@@ -0,0 +1,129 @@
+import type { ReactNode } from "react";
+
+export type PaginationSize = "lg" | "md" | "sm" | "xs";
+export type PaginationVariant = "default" | "square" | "rounded";
+
+export interface PaginationRootProps {
+  children?: ReactNode;
+  className?: string;
+  size?: PaginationSize;
+  variant?: PaginationVariant;
+}
+
+export interface PaginationItemProps {
+  children: ReactNode;
+  active?: boolean;
+  disabled?: boolean;
+  onClick?: () => void;
+  className?: string;
+  size?: PaginationSize;
+  variant?: PaginationVariant;
+  "aria-label"?: string;
+}
+
+export interface PaginationRangeProps {
+  start: number;
+  end: number;
+  total: number;
+  current: number;
+  onPageChange: (page: number) => void;
+  siblingCount?: number;
+  className?: string;
+  size?: PaginationSize;
+  variant?: PaginationVariant;
+}
+
+export interface PaginationButtonsProps {
+  page: number;
+  totalPages: number;
+  onPageChange: (page: number) => void;
+  className?: string;
+  size?: PaginationSize;
+  showFirstLast?: boolean;
+  showPrevNext?: boolean;
+  prevLabel?: string;
+  nextLabel?: string;
+  firstLabel?: string;
+  lastLabel?: string;
+  disabled?: boolean;
+}
+
+export interface PaginationInfoProps {
+  current: number;
+  total: number;
+  pageSize?: number;
+  className?: string;
+  label?: string;
+  showTotal?: boolean;
+}
+
+export interface PaginationFullProps {
+  current: number;
+  total: number;
+  pageSize?: number;
+  onPageChange: (page: number) => void;
+  siblingCount?: number;
+  className?: string;
+  size?: PaginationSize;
+  variant?: PaginationVariant;
+  showFirstLast?: boolean;
+  showPrevNext?: boolean;
+  infoClassName?: string;
+}
+
+export interface PaginationDocsProps {
+  prev?: { href: string; title: string };
+  next?: { href: string; title: string };
+  className?: string;
+}
+
+export function getPaginationRange({
+  totalCount,
+  pageSize,
+  siblingCount = 1,
+  currentPage,
+}: {
+  totalCount: number;
+  pageSize: number;
+  siblingCount?: number;
+  currentPage: number;
+}): (number | "ellipsis")[] {
+  const totalPages = Math.ceil(totalCount / pageSize);
+  const DOTS = "ellipsis" as const;
+
+  if (totalPages === 1) {
+    return [1];
+  }
+
+  const totalPageNumbers = siblingCount + 5;
+
+  if (totalPages < totalPageNumbers) {
+    return Array.from({ length: totalPages }, (_, i) => i + 1);
+  }
+
+  const leftSiblingIndex = Math.max(currentPage - siblingCount, 1);
+  const rightSiblingIndex = Math.min(currentPage + siblingCount, totalPages);
+
+  const showLeftDots = leftSiblingIndex > 2;
+  const showRightDots = rightSiblingIndex < totalPages - 1;
+
+  if (!showLeftDots && showRightDots) {
+    const leftRange = Array.from({ length: 3 }, (_, i) => i + 1);
+    return [...leftRange, DOTS, totalPages - 1, totalPages];
+  }
+
+  if (showLeftDots && !showRightDots) {
+    const rightRange = Array.from({ length: 3 }, (_, i) => totalPages - 2 + i);
+    return [1, 2, DOTS, ...rightRange];
+  }
+
+  if (showLeftDots && showRightDots) {
+    const middleRange = Array.from(
+      { length: rightSiblingIndex - leftSiblingIndex + 1 },
+      (_, i) => leftSiblingIndex + i
+    );
+    return [1, 2, DOTS, ...middleRange, DOTS, totalPages - 1, totalPages];
+  }
+
+  return [1];
+}

package/.docu/components/base/theme-controller.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { useEffect, useRef, useState, type ReactNode } from "react";
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 
 export type ThemeName =
   | "light"

package/.docu/components/base/toggle.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 import type { InputHTMLAttributes, ReactNode } from "react";
 import { forwardRef, useState, useEffect } from "react";
 

package/.docu/{lib → node}/build.ts

@@ -4,16 +4,7 @@ import { createHash } from "node:crypto";
 import { join, dirname } from "node:path";
 import React from "react";
 import { renderToString } from "react-dom/server";
-import {
-  serialize,
-  extractTocsFromRawMdx,
-  extractFrontmatterWithContent,
-  createDefaultRehypePlugins,
-  createDefaultRemarkPlugins,
-  MDXRemote,
-} from "@docubook/core";
-import { createMdxComponents } from "@docubook/mdx-content";
-import { getGitLastModified } from "./utils";
+import { compileMdx, getGitLastModifiedBatch } from "./mdx";
 import {
   DOCS_DIR,
   DIST_DIR,
@@ -112,39 +103,22 @@ function htmlShell(title: string, description: string, body: string): string {
   });
 }
 
-async function renderDocsPage(slug: string, rawMdx: string, filePath: string): Promise<string> {
-  const tocs = extractTocsFromRawMdx(rawMdx);
-  const { frontmatter, strippedContent } = extractFrontmatterWithContent<{
-    title?: string;
-    description?: string;
-    date?: string;
-  }>(rawMdx);
-
-  const components = createMdxComponents();
-  let compiledSource: string;
+async function renderDocsPage(
+  slug: string,
+  rawMdx: string,
+  filePath: string,
+  gitDates?: Map<string, string>
+): Promise<string> {
+  let result;
   try {
-    const serialized = await serialize(strippedContent, {
-      mdxOptions: {
-        rehypePlugins: createDefaultRehypePlugins(),
-        remarkPlugins: createDefaultRemarkPlugins(),
-      },
-    });
-    compiledSource = serialized.compiledSource;
+    result = await compileMdx(rawMdx, filePath, gitDates);
   } 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 });
   }
 
-  const content = React.createElement(MDXRemote, {
-    compiledSource,
-    scope: {},
-    frontmatter: {},
-    components,
-  });
-
-  const title = frontmatter.title || slug || "Docs";
-  const description = frontmatter.description || "";
-  const date = frontmatter.date || (await getGitLastModified(filePath));
+  const title = result.frontmatter.title || slug || "Docs";
+  const description = result.frontmatter.description || "";
   const slugParts = slug ? slug.split("/") : [];
 
   const page = React.createElement(
@@ -154,12 +128,12 @@ async function renderDocsPage(slug: string, rawMdx: string, filePath: string): P
       slug: slugParts,
       title,
       description,
-      date: date || undefined,
-      content,
-      tocs,
+      date: result.frontmatter.date || undefined,
+      content: result.content,
+      tocs: result.tocs,
       filePath,
       repoUrl: docuConfig.repo?.url,
-      compiledSource,
+      compiledSource: result.compiledSource,
     })
   );
 
@@ -225,7 +199,20 @@ async function build() {
   logger.spinner.start("Building pages...");
   t = performance.now();
 
-  const CONCURRENCY = parseInt(process.env.BUILD_CONCURRENCY || "10", 10);
+  const allRelPaths = mdxFiles
+    .map((f) => {
+      const mdxPath1 = join(DOCS_DIR, f.path, "index.mdx");
+      const mdxPath2 = join(DOCS_DIR, `${f.path}.mdx`);
+      const mdxPath3 = join(DOCS_DIR, `${f.path}.md`);
+      for (const p of [mdxPath1, mdxPath2, mdxPath3]) {
+        if (existsSync(p)) return p.replace(PROJECT_ROOT + "/", "");
+      }
+      return null;
+    })
+    .filter((p): p is string => p !== null);
+  const gitDates = await getGitLastModifiedBatch(allRelPaths);
+
+  const CONCURRENCY = Math.max(1, parseInt(process.env.BUILD_CONCURRENCY || "10", 10) || 10);
   const buildTasks = [];
   const errors: string[] = [];
 
@@ -263,7 +250,7 @@ async function build() {
 
     buildTasks.push(async () => {
       try {
-        const html = await renderDocsPage(capturedFile.path, capturedRawMdx, relPath);
+        const html = await renderDocsPage(capturedFile.path, capturedRawMdx, relPath, gitDates);
         const outputPath = join(DIST_DIR, "docs", `${capturedFile.path}.html`);
         await mkdir(dirname(outputPath), { recursive: true });
         await writeFile(outputPath, html);
@@ -289,7 +276,7 @@ async function build() {
     const indexMdxPath = join(DOCS_DIR, "index.mdx");
     const indexRaw = await readFile(indexMdxPath, "utf-8");
     const indexRelPath = indexMdxPath.replace(PROJECT_ROOT + "/", "");
-    const indexHtml = await renderDocsPage("", indexRaw, indexRelPath);
+    const indexHtml = await renderDocsPage("", indexRaw, indexRelPath, gitDates);
     await mkdir(join(DIST_DIR, "docs"), { recursive: true });
     await writeFile(join(DIST_DIR, "docs", "index.html"), indexHtml);
   } catch (err) {

package/.docu/node/mdx.ts

@@ -0,0 +1,61 @@
+import React from "react";
+import {
+  serialize,
+  extractTocsFromRawMdx,
+  extractFrontmatterWithContent,
+  createDefaultRehypePlugins,
+  createDefaultRemarkPlugins,
+  MDXRemote,
+} from "@docubook/core";
+import { createMdxComponents } from "@docubook/mdx-content";
+import { getGitLastModified, getGitLastModifiedBatch } from "./utils";
+
+export { getGitLastModifiedBatch };
+
+export interface MdxResult {
+  content: React.ReactElement;
+  compiledSource: string;
+  frontmatter: { title?: string; description?: string; date?: string };
+  tocs: ReturnType<typeof extractTocsFromRawMdx>;
+}
+
+export async function compileMdx(
+  rawMdx: string,
+  filePath: string,
+  gitDates?: Map<string, string>
+): Promise<MdxResult> {
+  const tocs = extractTocsFromRawMdx(rawMdx);
+  const { frontmatter, strippedContent } = extractFrontmatterWithContent<{
+    title?: string;
+    description?: string;
+    date?: string;
+  }>(rawMdx);
+
+  const serialized = await serialize(strippedContent, {
+    mdxOptions: {
+      rehypePlugins: createDefaultRehypePlugins(),
+      remarkPlugins: createDefaultRemarkPlugins(),
+    },
+  });
+
+  const components = createMdxComponents();
+  const content = React.createElement(MDXRemote, {
+    compiledSource: serialized.compiledSource,
+    scope: {},
+    frontmatter: {},
+    components,
+  });
+
+  const date =
+    frontmatter.date ||
+    gitDates?.get(filePath) ||
+    (await getGitLastModified(filePath)) ||
+    undefined;
+
+  return {
+    content,
+    compiledSource: serialized.compiledSource,
+    frontmatter: { ...frontmatter, date },
+    tocs,
+  };
+}

package/.docu/{lib → node}/paths.ts

@@ -3,18 +3,20 @@ import { existsSync, readFileSync } from "node:fs";
 import type { DocuConfig } from "./types";
 
 /**
- * FRAMEWORK_ROOT: Where the package code lives (.docu/components, .docu/pages, .docu/styles, .docu/lib)
+ * FRAMEWORK_ROOT: Where the package code lives (.docu/components, .docu/pages, .docu/styles, .docu/node)
  * PROJECT_ROOT: Where the user's project lives (docs/, docu.json)
  */
 
-// .docu/lib/paths.ts → package root is 2 levels up
+// .docu/node/paths.ts → package root is 2 levels up
 export const FRAMEWORK_ROOT = resolve(import.meta.dirname, "../..");
 export const PROJECT_ROOT = process.cwd();
 
 // Framework paths (internal)
 export const PAGES_DIR = join(FRAMEWORK_ROOT, ".docu/pages");
 export const STYLES_DIR = join(FRAMEWORK_ROOT, ".docu/styles");
-export const LIB_DIR = join(FRAMEWORK_ROOT, ".docu/lib");
+const nodeDir = join(FRAMEWORK_ROOT, ".docu/node");
+const libDir = join(FRAMEWORK_ROOT, ".docu/lib");
+export const LIB_DIR = existsSync(nodeDir) ? nodeDir : libDir;
 
 // Build output (user project)
 export const DIST_DIR = join(PROJECT_ROOT, ".docu/dist");

package/.docu/{lib → node}/search-indexer.ts

@@ -13,6 +13,7 @@
 
 import { readFile, writeFile, readdir, mkdir } from "node:fs/promises";
 import { resolve, join } from "node:path";
+import { extractFrontmatterWithContent } from "@docubook/core";
 import { DOCS_DIR, ASSETS_DIR, loadDocuConfig } from "./paths";
 
 const docuConfig = loadDocuConfig();
@@ -37,25 +38,6 @@ interface Frontmatter {
   description?: string;
 }
 
-function parseFrontmatter(raw: string): { frontmatter: Frontmatter; content: string } {
-  if (!raw.startsWith("---")) return { frontmatter: {}, content: raw };
-  const end = raw.indexOf("---", 3);
-  if (end < 0) return { frontmatter: {}, content: raw };
-
-  const fm: Frontmatter = {};
-  const lines = raw.slice(3, end).trim().split("\n");
-  for (const line of lines) {
-    const match = line.match(/^(\w+):\s*(.+)$/);
-    if (match) {
-      const [, key, value] = match;
-      if (key === "title" || key === "description") {
-        fm[key] = value.trim();
-      }
-    }
-  }
-  return { frontmatter: fm, content: raw.slice(end + 3) };
-}
-
 function getSectionTitle(filePath: string): string {
   const parts = filePath.split("/");
   if (parts.length > 1) {
@@ -75,7 +57,7 @@ function slugify(text: string): string {
 }
 
 function extractRecords(filePath: string, raw: string): SearchRecord[] {
-  const { frontmatter, content } = parseFrontmatter(raw);
+  const { frontmatter, strippedContent: content } = extractFrontmatterWithContent<Frontmatter>(raw);
   const records: SearchRecord[] = [];
   const url = `/docs/${filePath}`;
   const lvl0 = getSectionTitle(filePath);

package/.docu/{lib → node}/server.ts

@@ -4,16 +4,8 @@ import { resolve, join } from "node:path";
 import { watch } from "node:fs";
 import React from "react";
 import { renderToString } from "react-dom/server";
-import {
-  serialize,
-  extractTocsFromRawMdx,
-  extractFrontmatterWithContent,
-  createDefaultRehypePlugins,
-  createDefaultRemarkPlugins,
-  MDXRemote,
-} from "@docubook/core";
-import { createMdxComponents } from "@docubook/mdx-content";
-import { getGitLastModified, getContentType } from "./utils";
+import { getContentType } from "./utils";
+import { compileMdx } from "./mdx";
 import { DOCS_DIR, DIST_DIR, PAGES_DIR, PROJECT_ROOT, loadDocuConfig } from "./paths";
 import DocsPage from "../pages/docs/[[...slug]]";
 import NotFoundPage from "../pages/404";
@@ -139,34 +131,15 @@ async function getDocsForSlug(slug: string) {
     }
   }
   if (!filePath || !raw) return null;
-  const tocs = extractTocsFromRawMdx(raw);
-  const { frontmatter, strippedContent } = extractFrontmatterWithContent<{
-    title?: string;
-    description?: string;
-    date?: string;
-  }>(raw);
-
-  const components = createMdxComponents();
-  const serialized = await serialize(strippedContent, {
-    mdxOptions: {
-      rehypePlugins: createDefaultRehypePlugins(),
-      remarkPlugins: createDefaultRemarkPlugins(),
-    },
-  });
-  const content = React.createElement(MDXRemote, {
-    compiledSource: serialized.compiledSource,
-    scope: {},
-    frontmatter: {},
-    components,
-  });
 
   const relPath = filePath.replace(PROJECT_ROOT + "/", "");
-  const date = frontmatter.date || (await getGitLastModified(relPath)) || undefined;
+  const result = await compileMdx(raw, relPath);
+
   return {
-    content,
-    compiledSource: serialized.compiledSource,
-    frontmatter: { ...frontmatter, date },
-    tocs,
+    content: result.content,
+    compiledSource: result.compiledSource,
+    frontmatter: result.frontmatter,
+    tocs: result.tocs,
     filePath: relPath,
   };
 }

package/.docu/{lib → node}/utils.ts

@@ -33,6 +33,35 @@ export async function getGitLastModified(filePath: string): Promise<string | nul
   }
 }
 
+/** Batch git last modified dates for multiple files in a single spawn */
+export async function getGitLastModifiedBatch(filePaths: string[]): Promise<Map<string, string>> {
+  const result = new Map<string, string>();
+  if (filePaths.length === 0) return result;
+
+  try {
+    const proc = Bun.spawn(
+      ["git", "log", "--format=%cI", "--name-only", "--diff-filter=ACMR", ...filePaths],
+      { stderr: "ignore" }
+    );
+    const text = await new Response(proc.stdout).text();
+    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 {
+    // fallback: return empty map, callers use frontmatter date
+  }
+
+  return result;
+}
+
 const MIME_TYPES: Record<string, string> = {
   html: "text/html",
   css: "text/css",

package/.docu/pages/docs/[[...slug]].tsx

@@ -3,8 +3,8 @@ import DocsBreadcrumb from "../../components/Breadcrumb";
 import Pagination from "../../components/Pagination";
 import { Typography } from "../../components/Typography";
 import EditWith from "../../components/EditWith";
-import { formatDate2 } from "../../lib/utils";
-import type { TocItem } from "../../lib/types";
+import { formatDate2 } from "../../node/utils";
+import type { TocItem } from "../../node/types";
 import { Footer } from "../../components/Footer";
 import Toc from "../../components/Toc";
 

package/.docu/pages/index.tsx

@@ -1,5 +1,5 @@
 import * as icons from "lucide-react";
-import { loadDocuConfig } from "../lib/paths";
+import { loadDocuConfig } from "../node/paths";
 
 const docuConfig = loadDocuConfig();
 

package/bin/cli.js

@@ -78,5 +78,7 @@ if (!(command in COMMAND_MAP)) {
   process.exit(1);
 }
 
-const scriptPath = resolve(__dirname, "../.docu/lib", COMMAND_MAP[command]);
+const nodePath = resolve(__dirname, "../.docu/node", COMMAND_MAP[command]);
+const libPath = resolve(__dirname, "../.docu/lib", COMMAND_MAP[command]);
+const scriptPath = existsSync(nodePath) ? nodePath : libPath;
 await import(scriptPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docubook/flame",
-  "version": "1.0.0-beta.60",
+  "version": "1.0.0-beta.80",
   "description": "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   "type": "module",
   "bin": {
@@ -76,11 +76,11 @@
     "typescript-eslint": "^8.59.2"
   },
   "scripts": {
-    "dev": "bun .docu/lib/server.ts",
-    "build": "NODE_ENV=production bun .docu/lib/build.ts",
-    "clean": "bun .docu/lib/clean.ts",
-    "preview": "bun .docu/lib/preview.ts",
-    "deploy": "bun .docu/lib/deploy.ts",
+    "dev": "bun .docu/node/server.ts",
+    "build": "NODE_ENV=production bun .docu/node/build.ts",
+    "clean": "bun .docu/node/clean.ts",
+    "preview": "bun .docu/node/preview.ts",
+    "deploy": "bun .docu/node/deploy.ts",
     "test": "vitest run",
     "lint": "eslint ."
   }