@docubook/flame 1.0.0-beta.50 → 1.0.0-beta.70

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.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { cn } from "../../lib/utils";
+import { cn } from "../../node/utils";
 import { ChevronLeft, ChevronRight } from "lucide-react";
 import { useMemo, type ReactNode } from "react";
 
@@ -504,7 +504,7 @@ export function PaginationDocs({ prev, next, className }: PaginationDocsProps) {
         {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"
+            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" />
@@ -519,7 +519,7 @@ export function PaginationDocs({ prev, next, className }: PaginationDocsProps) {
         {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"
+            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

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 } from "./mdx";
 import {
   DOCS_DIR,
   DIST_DIR,
@@ -113,38 +104,16 @@ 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;
+  let result;
   try {
-    const serialized = await serialize(strippedContent, {
-      mdxOptions: {
-        rehypePlugins: createDefaultRehypePlugins(),
-        remarkPlugins: createDefaultRemarkPlugins(),
-      },
-    });
-    compiledSource = serialized.compiledSource;
+    result = await compileMdx(rawMdx, filePath);
   } 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 +123,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 +194,7 @@ async function build() {
   logger.spinner.start("Building pages...");
   t = performance.now();
 
-  const CONCURRENCY = parseInt(process.env.BUILD_CONCURRENCY || "10", 10);
+  const CONCURRENCY = Math.max(1, parseInt(process.env.BUILD_CONCURRENCY || "10", 10) || 10);
   const buildTasks = [];
   const errors: string[] = [];
 

package/.docu/{lib → node}/fs-scanner.ts

@@ -107,7 +107,7 @@ function fileNodesToRoutes(nodes: FileNode[], parentHref = ""): DocuRoute[] {
       if (isIndexFile) continue;
 
       const segment = node.relPath.split("/").pop()!;
-      const href = parentHref ? `${parentHref}/${segment}` : `/${node.relPath}`;
+      const href = `/${segment}`;
 
       routes.push({
         title: toTitleCase(baseName),
@@ -116,7 +116,7 @@ function fileNodesToRoutes(nodes: FileNode[], parentHref = ""): DocuRoute[] {
     } else {
       const dirTitle = toTitleCase(node.name);
       const segment = node.relPath.split("/").pop()!;
-      const dirHref = parentHref ? `${parentHref}/${segment}` : `/${node.relPath}`;
+      const dirHref = `/${segment}`;
 
       const children = fileNodesToRoutes(node.children || [], dirHref);
 

package/.docu/node/mdx.ts

@@ -0,0 +1,51 @@
+import React from "react";
+import {
+  serialize,
+  extractTocsFromRawMdx,
+  extractFrontmatterWithContent,
+  createDefaultRehypePlugins,
+  createDefaultRemarkPlugins,
+  MDXRemote,
+} from "@docubook/core";
+import { createMdxComponents } from "@docubook/mdx-content";
+import { getGitLastModified } from "./utils";
+
+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): 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 || (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}/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/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.50",
+  "version": "1.0.0-beta.70",
   "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 ."
   }