@docubook/flame 1.6.0 → 1.6.2

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

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-JTH4JBBS.js";
-import "./chunk-IJFMQFWW.js";
+} from "./chunk-OREEWUOV.js";
+import "./chunk-WSJC3PRH.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-Y2TAEAUQ.js";
+import "./chunk-TU7G4RJV.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/build.deno.ts

package/.docu/lib/{build.impl-N2MBT3CM.js → build.impl-CFTUVIX7.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   runBuildCli
-} from "./chunk-JTH4JBBS.js";
-import "./chunk-IJFMQFWW.js";
+} from "./chunk-OREEWUOV.js";
+import "./chunk-WSJC3PRH.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-Y2TAEAUQ.js";
+import "./chunk-TU7G4RJV.js";
 import "./chunk-4IQXHHPF.js";
 export {
   runBuild,

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

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-JTH4JBBS.js";
-import "./chunk-IJFMQFWW.js";
+} from "./chunk-OREEWUOV.js";
+import "./chunk-WSJC3PRH.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-Y2TAEAUQ.js";
+import "./chunk-TU7G4RJV.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/build.node.ts

package/.docu/lib/{chunk-ZA5QB5UK.js → chunk-77NNQDFX.js}

@@ -14,7 +14,7 @@ import {
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-IJFMQFWW.js";
+} from "./chunk-WSJC3PRH.js";
 import {
   SECURITY_HEADERS,
   generateNonce,
@@ -27,7 +27,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-Y2TAEAUQ.js";
+} from "./chunk-TU7G4RJV.js";
 import {
   DIST_DIR,
   DOCS_DIR,

package/.docu/lib/{chunk-TI6M4643.js → chunk-KHRQUSNL.js}

@@ -9,6 +9,98 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 var WORKFLOW_DIR = join(PROJECT_ROOT, ".github/workflows");
 var WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
+var NGINX_CONF = `server {
+  listen 80;
+  server_name _;
+  root /usr/share/nginx/html;
+  index index.html;
+
+  gzip on;
+  gzip_types text/html text/css application/javascript image/svg+xml;
+
+  # Security headers (HSTS effective when HTTPS is terminated upstream)
+  add_header X-Frame-Options "DENY" always;
+  add_header X-Content-Type-Options "nosniff" always;
+  add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
+  add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+  add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+
+  location /assets/ {
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+    add_header X-Frame-Options "DENY" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+  }
+
+  location /docs/assets/ {
+    expires 7d;
+    add_header Cache-Control "public";
+    add_header X-Frame-Options "DENY" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+  }
+
+  location / {
+    try_files $uri $uri.html $uri/ =404;
+  }
+}
+`;
+var DOCKERIGNORE = `node_modules
+.git
+*.DS_Store
+.docu/dist
+.docu/lib
+.env
+.env.*
+.npmrc
+*.log
+`;
+function detectPkgManager(dir) {
+  const bunLockFile = existsSync(join(dir, "bun.lock")) ? "bun.lock" : existsSync(join(dir, "bun.lockb")) ? "bun.lockb" : null;
+  if (bunLockFile) {
+    return {
+      baseImage: "oven/bun:1",
+      lockFile: bunLockFile,
+      installCmd: "bun install --frozen-lockfile",
+      runCmd: "bun",
+      cache: "",
+      setupAction: "bun"
+    };
+  }
+  if (existsSync(join(dir, "pnpm-lock.yaml"))) {
+    return {
+      baseImage: "node:22-alpine",
+      lockFile: "pnpm-lock.yaml",
+      installCmd: "corepack enable && pnpm install --frozen-lockfile",
+      runCmd: "pnpm",
+      cache: "pnpm",
+      setupAction: "pnpm"
+    };
+  }
+  if (existsSync(join(dir, "yarn.lock"))) {
+    return {
+      baseImage: "node:22-alpine",
+      lockFile: "yarn.lock",
+      installCmd: "yarn install --frozen-lockfile",
+      runCmd: "yarn",
+      cache: "yarn",
+      setupAction: "node"
+    };
+  }
+  return {
+    baseImage: "node:22-alpine",
+    lockFile: "package-lock.json",
+    installCmd: "npm ci",
+    runCmd: "npm",
+    cache: "npm",
+    setupAction: "node"
+  };
+}
 var HEADERS_FILE = `/*
   X-Frame-Options: DENY
   X-Content-Type-Options: nosniff
@@ -35,20 +127,21 @@ async function runBuild() {
     process.env.FLAME_BUILD_SILENT = "1";
     process.env.LOG_LEVEL = "error";
   }
-  const { runBuildCli } = await import("./build.impl-N2MBT3CM.js");
+  const { runBuildCli } = await import("./build.impl-CFTUVIX7.js");
   await runBuildCli();
 }
 async function writeDockerFiles() {
   const dockerDir = PROJECT_ROOT;
+  const pm = detectPkgManager(dockerDir);
   if (!existsSync(join(dockerDir, "Dockerfile"))) {
     await writeFile(
       join(dockerDir, "Dockerfile"),
-      `FROM node:22-alpine AS builder
+      `FROM ${pm.baseImage} AS builder
 WORKDIR /app
-COPY package.json package-lock.json ./
-RUN npm ci
+COPY package.json ${pm.lockFile} ./
+RUN ${pm.installCmd}
 COPY . .
-RUN npm run build
+RUN ${pm.runCmd} run build
 
 FROM nginx:alpine
 COPY --from=builder /app/.docu/dist /usr/share/nginx/html
@@ -61,73 +154,96 @@ CMD ["nginx", "-g", "daemon off;"]
     log.created("\u{1F4C4} Created Dockerfile");
   }
   if (!existsSync(join(dockerDir, "nginx.conf"))) {
-    await writeFile(
-      join(dockerDir, "nginx.conf"),
-      `server {
-  listen 80;
-  server_name _;
-  root /usr/share/nginx/html;
-  index index.html;
-
-  gzip on;
-  gzip_types text/html text/css application/javascript image/svg+xml;
-
-  # Security headers (HSTS effective when HTTPS is terminated upstream)
-  add_header X-Frame-Options "DENY" always;
-  add_header X-Content-Type-Options "nosniff" always;
-  add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-  add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-  add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
-
-  location /assets/ {
-    expires 1y;
-    add_header Cache-Control "public, immutable";
-    add_header X-Frame-Options "DENY" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
-  }
-
-  location /docs/assets/ {
-    expires 7d;
-    add_header Cache-Control "public";
-    add_header X-Frame-Options "DENY" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+    await writeFile(join(dockerDir, "nginx.conf"), NGINX_CONF);
+    log.created("\u{1F4C4} Created nginx.conf");
   }
-
-  location / {
-    try_files $uri $uri.html $uri/ =404;
+  if (!existsSync(join(dockerDir, ".dockerignore"))) {
+    await writeFile(join(dockerDir, ".dockerignore"), DOCKERIGNORE);
+    log.created("\u{1F4C4} Created .dockerignore");
   }
 }
-`
+function generateWorkflowYml() {
+  const pm = detectPkgManager(PROJECT_ROOT);
+  const setupSteps = [
+    "      - uses: actions/checkout@v7",
+    "        with:",
+    "          fetch-depth: 0",
+    ""
+  ];
+  if (pm.setupAction === "bun") {
+    setupSteps.push(
+      "      - uses: oven-sh/setup-bun@v2",
+      "        with:",
+      "          bun-version: latest",
+      ""
     );
-    log.created("\u{1F4C4} Created nginx.conf");
-  }
-  if (!existsSync(join(dockerDir, ".dockerignore"))) {
-    await writeFile(
-      join(dockerDir, ".dockerignore"),
-      `node_modules
-.git
-*.DS_Store
-.docu/dist
-.docu/lib
-.env
-.env.*
-.npmrc
-*.log
-`
+  } else if (pm.setupAction === "pnpm") {
+    setupSteps.push(
+      "      - uses: pnpm/action-setup@v6",
+      "",
+      "      - uses: actions/setup-node@v6",
+      "        with:",
+      "          node-version: 22",
+      `          cache: ${pm.cache}`,
+      ""
+    );
+  } else {
+    setupSteps.push(
+      "      - uses: actions/setup-node@v6",
+      "        with:",
+      "          node-version: 22",
+      `          cache: ${pm.cache}`,
+      ""
     );
-    log.created("\u{1F4C4} Created .dockerignore");
   }
+  return [
+    `name: Deploy to GitHub Pages`,
+    "",
+    "on:",
+    "  push:",
+    "    branches: [main]",
+    "  workflow_dispatch:",
+    "",
+    "permissions:",
+    "  contents: read",
+    "  pages: write",
+    "  id-token: write",
+    "",
+    "concurrency:",
+    '  group: "pages"',
+    "  cancel-in-progress: false",
+    "",
+    "jobs:",
+    "  build:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    ...setupSteps,
+    `      - run: ${pm.installCmd}`,
+    "",
+    `      - run: ${pm.runCmd} run build`,
+    "",
+    "      - name: Add .nojekyll",
+    "        run: touch .docu/dist/.nojekyll",
+    "",
+    "      - uses: actions/upload-pages-artifact@v3",
+    "        with:",
+    "          path: .docu/dist",
+    "",
+    "  deploy:",
+    "    environment:",
+    "      name: github-pages",
+    "      url: ${{ steps.deployment.outputs.page_url }}",
+    "    runs-on: ubuntu-latest",
+    "    needs: build",
+    "    steps:",
+    "      - id: deployment",
+    "        uses: actions/deploy-pages@v4"
+  ].join("\n");
 }
 async function writeGhaWorkflow() {
   if (!existsSync(WORKFLOW_FILE)) {
     await mkdir(WORKFLOW_DIR, { recursive: true });
-    await writeFile(WORKFLOW_FILE, GITHUB_ACTIONS_WORKFLOW);
+    await writeFile(WORKFLOW_FILE, generateWorkflowYml());
     log.created("\u{1F4C4} Created .github/workflows/deploy.yml");
   }
 }
@@ -149,55 +265,6 @@ async function runDeploy() {
     log.out("   Push to GitHub and enable Pages (Settings \u2192 Pages \u2192 Source: GitHub Actions)");
   }
 }
-var GITHUB_ACTIONS_WORKFLOW = `name: Deploy to GitHub Pages
-
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-
-      - run: npm install
-
-      - run: npm run build
-
-      - name: Add .nojekyll
-        run: touch .docu/dist/.nojekyll
-
-      - uses: actions/upload-pages-artifact@v3
-        with:
-          path: .docu/dist
-
-  deploy:
-    environment:
-      name: github-pages
-      url: \${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - id: deployment
-        uses: actions/deploy-pages@v4
-`;
 
 export {
   runDeploy

package/.docu/lib/{chunk-UUS45SUC.js → chunk-N25ZVCKO.js}

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

package/.docu/lib/{chunk-JTH4JBBS.js → chunk-OREEWUOV.js}

@@ -13,7 +13,7 @@ import {
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-IJFMQFWW.js";
+} from "./chunk-WSJC3PRH.js";
 import {
   cspHeader,
   generateNonce,
@@ -21,7 +21,7 @@ import {
 } from "./chunk-EOK6KATZ.js";
 import {
   logger
-} from "./chunk-Y2TAEAUQ.js";
+} from "./chunk-TU7G4RJV.js";
 import {
   ASSETS_DIR,
   CACHE_FILE,

package/.docu/lib/{chunk-Y2TAEAUQ.js → chunk-TU7G4RJV.js}

@@ -5,7 +5,7 @@ import {
 // package.json
 var package_default = {
   name: "@docubook/flame",
-  version: "1.6.0",
+  version: "1.6.2",
   description: "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   type: "module",
   bin: {

package/.docu/lib/{chunk-IJFMQFWW.js → chunk-WSJC3PRH.js}

@@ -103,8 +103,8 @@ var BuildPluginBuilder = class {
   _remarkPlugins = [];
   _transformFrontmatter = [];
   _transformHtml = [];
-  constructor(config3) {
-    this.config = config3;
+  constructor(config2) {
+    this.config = config2;
   }
   /**
    * Collect and deduplicate all `<body>` injection snippets from registered plugins.
@@ -646,8 +646,8 @@ function getThemeConfig() {
   if (process.env.FLAME_THEME) {
     return process.env.FLAME_THEME;
   }
-  const config3 = loadDocuConfig();
-  return config3.themes?.colors;
+  const config2 = loadDocuConfig();
+  return config2.themes?.colors;
 }
 function buildThemeCss(baseCss, themeConfig) {
   try {
@@ -683,19 +683,19 @@ import { existsSync, readFileSync, readdirSync as readdirSync2 } from "node:fs";
 import { promisify } from "node:util";
 import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
 import { createHash } from "node:crypto";
-function extractConfigIcons(config3) {
+function extractConfigIcons(config2) {
   const icons = [];
   const pushIf = (s) => {
     if (s) icons.push(s);
   };
-  config3.home?.hero?.actions?.forEach((a) => pushIf(a.icon));
-  config3.home?.features?.forEach((f) => pushIf(f.icon));
+  config2.home?.hero?.actions?.forEach((a) => pushIf(a.icon));
+  config2.home?.features?.forEach((f) => pushIf(f.icon));
   (function walk(routes3) {
     for (const r of routes3) {
       pushIf(r.context?.icon);
       if (r.items) walk(r.items);
     }
-  })(config3.routes ?? []);
+  })(config2.routes ?? []);
   return [...new Set(icons.filter((n) => /^[A-Z]/.test(n)))];
 }
 var execFileAsync = promisify(execFile);
@@ -874,17 +874,25 @@ async function buildClientBundle() {
         {
           name: "docu-config",
           setup(build2) {
-            build2.onResolve({ filter: /docu\.json$/ }, (args) => ({
+            build2.onResolve({ filter: /client-routes$/ }, (args) => ({
               path: args.path,
-              namespace: "docu-config"
+              namespace: "client-routes"
             }));
-            build2.onLoad({ filter: /.*/, namespace: "docu-config" }, () => {
-              const config3 = loadDocuConfig();
+            build2.onLoad({ filter: /.*/, namespace: "client-routes" }, () => {
+              const config2 = loadDocuConfig();
               const resolved = {
-                ...config3,
-                routes: resolveRoutes(config3.routes)
+                ...config2,
+                routes: resolveRoutes(config2.routes)
+              };
+              return {
+                contents: [
+                  `import type { DocuRoute, DocuConfig } from "./types";`,
+                  `const docuConfig = ${JSON.stringify(resolved)};`,
+                  `export const routes = docuConfig.routes || [];`,
+                  `export const config = docuConfig;`
+                ].join("\n"),
+                loader: "ts"
               };
-              return { contents: JSON.stringify(resolved), loader: "json" };
             });
           }
         }
@@ -2028,15 +2036,10 @@ function Anchor({
   return /* @__PURE__ */ jsx15("a", { href, className: baseClasses, ...props, children });
 }
 
-// docu-config-runtime:../../docu.json
-import { readFileSync as readFileSync2 } from "node:fs";
-import { join as join4 } from "node:path";
-var config = JSON.parse(readFileSync2(join4(process.cwd(), "docu.json"), "utf-8"));
-var docu_default = config;
-
 // .docu/node/client-routes.ts
-var routes2 = docu_default.routes || [];
-var config2 = docu_default;
+var docuConfig5 = loadDocuConfig();
+var routes2 = resolveRoutes(docuConfig5.routes || []);
+var config = docuConfig5;
 
 // .docu/components/Sublink.tsx
 import { jsx as jsx16, jsxs as jsxs12 } from "react/jsx-runtime";
@@ -2078,7 +2081,7 @@ function Sublink({
       }
     );
     if (level >= 1) {
-      if (config2.sidebar?.context === "separator") {
+      if (config.sidebar?.context === "separator") {
         const sectionOffsets = { 1: 16, 2: 32 };
         let overlap = 14;
         for (let l = 1; l < level; l++) {
@@ -2187,7 +2190,7 @@ function Menu({ onNavigate, className = "", pathname, routes: routes3 = [] }) {
     () => pathname || (typeof window !== "undefined" ? window.location.pathname : "/docs")
   );
   if (!currentPath.startsWith("/docs")) return null;
-  const mode = config2.sidebar?.context || "dropdown";
+  const mode = config.sidebar?.context || "dropdown";
   const navProps = {
     "aria-label": "Documentation navigation",
     className: cn("transition-all duration-200", className)
@@ -2249,7 +2252,7 @@ function Menu({ onNavigate, className = "", pathname, routes: routes3 = [] }) {
 }
 
 // .docu/components/DocsLayout.tsx
-var docuConfig5 = loadDocuConfig();
+var docuConfig6 = loadDocuConfig();
 function DocsLayout({ children, repoUrl, pathname = "/docs" }) {
   return React2.createElement(
     "div",
@@ -2270,7 +2273,7 @@ function DocsLayout({ children, repoUrl, pathname = "/docs" }) {
         React2.createElement(
           "div",
           { className: "flex h-full flex-col overflow-y-auto px-4" },
-          React2.createElement(Menu, { pathname, routes: docuConfig5.routes || [] })
+          React2.createElement(Menu, { pathname, routes: docuConfig6.routes || [] })
         )
       ),
       React2.createElement(
@@ -2282,7 +2285,7 @@ function DocsLayout({ children, repoUrl, pathname = "/docs" }) {
           React2.createElement(
             "nav",
             { className: "flex items-center gap-6 text-sm font-medium text-base-content/80" },
-            ...(docuConfig5.navbar?.menu || []).map((item) => {
+            ...(docuConfig6.navbar?.menu || []).map((item) => {
               const isExternal = /^https?:\/\//.test(item.href);
               const isDocsActive = item.href === "/docs";
               return React2.createElement(

package/.docu/lib/clean.js

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

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

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

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

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

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

@@ -1,8 +1,8 @@
 import {
   runPreview
-} from "./chunk-UUS45SUC.js";
+} from "./chunk-N25ZVCKO.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-Y2TAEAUQ.js";
+import "./chunk-TU7G4RJV.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/preview.deno.ts

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

@@ -1,8 +1,8 @@
 import {
   runPreview
-} from "./chunk-UUS45SUC.js";
+} from "./chunk-N25ZVCKO.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-Y2TAEAUQ.js";
+import "./chunk-TU7G4RJV.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/preview.node.ts

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

@@ -1,9 +1,9 @@
 import {
   runServer
-} from "./chunk-ZA5QB5UK.js";
-import "./chunk-IJFMQFWW.js";
+} from "./chunk-77NNQDFX.js";
+import "./chunk-WSJC3PRH.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-Y2TAEAUQ.js";
+import "./chunk-TU7G4RJV.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/server.deno.ts

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

@@ -1,9 +1,9 @@
 import {
   runServer
-} from "./chunk-ZA5QB5UK.js";
-import "./chunk-IJFMQFWW.js";
+} from "./chunk-77NNQDFX.js";
+import "./chunk-WSJC3PRH.js";
 import "./chunk-EOK6KATZ.js";
-import "./chunk-Y2TAEAUQ.js";
+import "./chunk-TU7G4RJV.js";
 import "./chunk-4IQXHHPF.js";
 
 // .docu/node/server.node.ts

package/.docu/node/client-routes.ts

@@ -1,5 +1,7 @@
 import type { DocuRoute, DocuConfig } from "./types";
-import docuConfig from "../../docu.json" with { type: "json" };
+import { loadDocuConfig } from "./paths";
+import { resolveRoutes } from "./fs-scanner";
 
-export const routes: DocuRoute[] = docuConfig.routes || [];
+const docuConfig = loadDocuConfig();
+export const routes: DocuRoute[] = resolveRoutes(docuConfig.routes || []);
 export const config = docuConfig as unknown as DocuConfig;

package/.docu/node/deploy.shared.ts

@@ -16,6 +16,113 @@ import { DIST_DIR, PROJECT_ROOT } from "./paths";
 const WORKFLOW_DIR = join(PROJECT_ROOT, ".github/workflows");
 const WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
 
+export const NGINX_CONF = `server {
+  listen 80;
+  server_name _;
+  root /usr/share/nginx/html;
+  index index.html;
+
+  gzip on;
+  gzip_types text/html text/css application/javascript image/svg+xml;
+
+  # Security headers (HSTS effective when HTTPS is terminated upstream)
+  add_header X-Frame-Options "DENY" always;
+  add_header X-Content-Type-Options "nosniff" always;
+  add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
+  add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+  add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+
+  location /assets/ {
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+    add_header X-Frame-Options "DENY" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+  }
+
+  location /docs/assets/ {
+    expires 7d;
+    add_header Cache-Control "public";
+    add_header X-Frame-Options "DENY" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+  }
+
+  location / {
+    try_files $uri $uri.html $uri/ =404;
+  }
+}
+`;
+
+export const DOCKERIGNORE = `node_modules
+.git
+*.DS_Store
+.docu/dist
+.docu/lib
+.env
+.env.*
+.npmrc
+*.log
+`;
+
+export function detectPkgManager(dir: string): {
+  baseImage: string;
+  lockFile: string;
+  installCmd: string;
+  runCmd: string;
+  cache: string;
+  setupAction: string;
+} {
+  const bunLockFile = existsSync(join(dir, "bun.lock"))
+    ? "bun.lock"
+    : existsSync(join(dir, "bun.lockb"))
+      ? "bun.lockb"
+      : null;
+  if (bunLockFile) {
+    return {
+      baseImage: "oven/bun:1",
+      lockFile: bunLockFile,
+      installCmd: "bun install --frozen-lockfile",
+      runCmd: "bun",
+      cache: "",
+      setupAction: "bun",
+    };
+  }
+  if (existsSync(join(dir, "pnpm-lock.yaml"))) {
+    return {
+      baseImage: "node:22-alpine",
+      lockFile: "pnpm-lock.yaml",
+      installCmd: "corepack enable && pnpm install --frozen-lockfile",
+      runCmd: "pnpm",
+      cache: "pnpm",
+      setupAction: "pnpm",
+    };
+  }
+  if (existsSync(join(dir, "yarn.lock"))) {
+    return {
+      baseImage: "node:22-alpine",
+      lockFile: "yarn.lock",
+      installCmd: "yarn install --frozen-lockfile",
+      runCmd: "yarn",
+      cache: "yarn",
+      setupAction: "node",
+    };
+  }
+  // default: npm
+  return {
+    baseImage: "node:22-alpine",
+    lockFile: "package-lock.json",
+    installCmd: "npm ci",
+    runCmd: "npm",
+    cache: "npm",
+    setupAction: "node",
+  };
+}
+
 export const HEADERS_FILE = `/*
   X-Frame-Options: DENY
   X-Content-Type-Options: nosniff
@@ -50,16 +157,17 @@ async function runBuild() {
 
 async function writeDockerFiles() {
   const dockerDir = PROJECT_ROOT;
+  const pm = detectPkgManager(dockerDir);
 
   if (!existsSync(join(dockerDir, "Dockerfile"))) {
     await writeFile(
       join(dockerDir, "Dockerfile"),
-      `FROM node:22-alpine AS builder
+      `FROM ${pm.baseImage} AS builder
 WORKDIR /app
-COPY package.json package-lock.json ./
-RUN npm ci
+COPY package.json ${pm.lockFile} ./
+RUN ${pm.installCmd}
 COPY . .
-RUN npm run build
+RUN ${pm.runCmd} run build
 
 FROM nginx:alpine
 COPY --from=builder /app/.docu/dist /usr/share/nginx/html
@@ -73,75 +181,103 @@ CMD ["nginx", "-g", "daemon off;"]
   }
 
   if (!existsSync(join(dockerDir, "nginx.conf"))) {
-    await writeFile(
-      join(dockerDir, "nginx.conf"),
-      `server {
-  listen 80;
-  server_name _;
-  root /usr/share/nginx/html;
-  index index.html;
-
-  gzip on;
-  gzip_types text/html text/css application/javascript image/svg+xml;
-
-  # Security headers (HSTS effective when HTTPS is terminated upstream)
-  add_header X-Frame-Options "DENY" always;
-  add_header X-Content-Type-Options "nosniff" always;
-  add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-  add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-  add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
-
-  location /assets/ {
-    expires 1y;
-    add_header Cache-Control "public, immutable";
-    add_header X-Frame-Options "DENY" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
-  }
-
-  location /docs/assets/ {
-    expires 7d;
-    add_header Cache-Control "public";
-    add_header X-Frame-Options "DENY" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+    await writeFile(join(dockerDir, "nginx.conf"), NGINX_CONF);
+    log.created("📄 Created nginx.conf");
   }
 
-  location / {
-    try_files $uri $uri.html $uri/ =404;
+  if (!existsSync(join(dockerDir, ".dockerignore"))) {
+    await writeFile(join(dockerDir, ".dockerignore"), DOCKERIGNORE);
+    log.created("📄 Created .dockerignore");
   }
 }
-`
-    );
-    log.created("📄 Created nginx.conf");
-  }
 
-  if (!existsSync(join(dockerDir, ".dockerignore"))) {
-    await writeFile(
-      join(dockerDir, ".dockerignore"),
-      `node_modules
-.git
-*.DS_Store
-.docu/dist
-.docu/lib
-.env
-.env.*
-.npmrc
-*.log
-`
+function generateWorkflowYml(): string {
+  const pm = detectPkgManager(PROJECT_ROOT);
+
+  const setupSteps: string[] = [
+    "      - uses: actions/checkout@v7",
+    "        with:",
+    "          fetch-depth: 0",
+    "",
+  ];
+
+  if (pm.setupAction === "bun") {
+    setupSteps.push(
+      "      - uses: oven-sh/setup-bun@v2",
+      "        with:",
+      "          bun-version: latest",
+      ""
+    );
+  } else if (pm.setupAction === "pnpm") {
+    setupSteps.push(
+      "      - uses: pnpm/action-setup@v6",
+      "",
+      "      - uses: actions/setup-node@v6",
+      "        with:",
+      "          node-version: 22",
+      `          cache: ${pm.cache}`,
+      ""
+    );
+  } else {
+    // npm / yarn
+    setupSteps.push(
+      "      - uses: actions/setup-node@v6",
+      "        with:",
+      "          node-version: 22",
+      `          cache: ${pm.cache}`,
+      ""
     );
-    log.created("📄 Created .dockerignore");
   }
+
+  return [
+    `name: Deploy to GitHub Pages`,
+    "",
+    "on:",
+    "  push:",
+    "    branches: [main]",
+    "  workflow_dispatch:",
+    "",
+    "permissions:",
+    "  contents: read",
+    "  pages: write",
+    "  id-token: write",
+    "",
+    "concurrency:",
+    '  group: "pages"',
+    "  cancel-in-progress: false",
+    "",
+    "jobs:",
+    "  build:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    ...setupSteps,
+    `      - run: ${pm.installCmd}`,
+    "",
+    `      - run: ${pm.runCmd} run build`,
+    "",
+    "      - name: Add .nojekyll",
+    "        run: touch .docu/dist/.nojekyll",
+    "",
+    "      - uses: actions/upload-pages-artifact@v3",
+    "        with:",
+    "          path: .docu/dist",
+    "",
+    "  deploy:",
+    "    environment:",
+    "      name: github-pages",
+    "      url: ${{ steps.deployment.outputs.page_url }}",
+    "    runs-on: ubuntu-latest",
+    "    needs: build",
+    "    steps:",
+    "      - id: deployment",
+    "        uses: actions/deploy-pages@v4",
+  ].join("\n");
 }
 
 async function writeGhaWorkflow() {
   if (!existsSync(WORKFLOW_FILE)) {
     await mkdir(WORKFLOW_DIR, { recursive: true });
-    await writeFile(WORKFLOW_FILE, GITHUB_ACTIONS_WORKFLOW);
+    await writeFile(WORKFLOW_FILE, generateWorkflowYml());
     log.created("📄 Created .github/workflows/deploy.yml");
   }
 }
@@ -168,53 +304,3 @@ export async function runDeploy(): Promise<void> {
     log.out("   Push to GitHub and enable Pages (Settings → Pages → Source: GitHub Actions)");
   }
 }
-
-const GITHUB_ACTIONS_WORKFLOW = `name: Deploy to GitHub Pages
-
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-
-      - run: npm install
-
-      - run: npm run build
-
-      - name: Add .nojekyll
-        run: touch .docu/dist/.nojekyll
-
-      - uses: actions/upload-pages-artifact@v3
-        with:
-          path: .docu/dist
-
-  deploy:
-    environment:
-      name: github-pages
-      url: \${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - id: deployment
-        uses: actions/deploy-pages@v4
-`;

package/.docu/node/deploy.ts

@@ -11,9 +11,9 @@ import { mkdir } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { DIST_DIR, PROJECT_ROOT } from "./paths";
-import { HEADERS_FILE } from "./deploy.shared";
+import { HEADERS_FILE, NGINX_CONF, DOCKERIGNORE } from "./deploy.shared";
 
-export { HEADERS_FILE };
+export { HEADERS_FILE, NGINX_CONF, DOCKERIGNORE };
 
 const WORKFLOW_DIR = join(PROJECT_ROOT, ".github/workflows");
 const WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
@@ -43,49 +43,6 @@ async function runBuild() {
   }
 }
 
-export const NGINX_CONF = `server {
-  listen 80;
-  server_name _;
-  root /usr/share/nginx/html;
-  index index.html;
-
-  gzip on;
-  gzip_types text/html text/css application/javascript image/svg+xml;
-
-  # Security headers (server-level, inherited by all locations)
-  # HSTS effective when HTTPS is terminated upstream (reverse proxy / LB)
-  add_header X-Frame-Options "DENY" always;
-  add_header X-Content-Type-Options "nosniff" always;
-  add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-  add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-  add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
-
-  location /assets/ {
-    expires 1y;
-    add_header Cache-Control "public, immutable";
-    add_header X-Frame-Options "DENY" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
-  }
-
-  location /docs/assets/ {
-    expires 7d;
-    add_header Cache-Control "public";
-    add_header X-Frame-Options "DENY" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
-  }
-
-  location / {
-    try_files $uri $uri.html $uri/ =404;
-  }
-}
-`;
-
 export const DOCKERFILE_BUN = `FROM oven/bun:1 AS builder
 WORKDIR /app
 COPY package.json bun.lock ./
@@ -101,17 +58,6 @@ EXPOSE 80
 CMD ["nginx", "-g", "daemon off;"]
 `;
 
-export const DOCKERIGNORE = `node_modules
-.git
-*.DS_Store
-.docu/dist
-.docu/lib
-.env
-.env.*
-.npmrc
-*.log
-`;
-
 async function writeDockerFiles() {
   const dockerDir = PROJECT_ROOT;
 
@@ -182,7 +128,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 

package/.docu/node/hydrate.node.ts

@@ -270,17 +270,27 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
         {
           name: "docu-config",
           setup(build) {
-            build.onResolve({ filter: /docu\.json$/ }, (args) => ({
+            // Components import as "../node/client-routes" (no .ts extension),
+            // so filter matches the path tail without requiring the extension.
+            build.onResolve({ filter: /client-routes$/ }, (args) => ({
               path: args.path,
-              namespace: "docu-config",
+              namespace: "client-routes",
             }));
-            build.onLoad({ filter: /.*/, namespace: "docu-config" }, () => {
+            build.onLoad({ filter: /.*/, namespace: "client-routes" }, () => {
               const config = loadDocuConfig();
               const resolved = {
                 ...config,
                 routes: resolveRoutes(config.routes as DocuRoute[] | undefined),
               };
-              return { contents: JSON.stringify(resolved), loader: "json" };
+              return {
+                contents: [
+                  `import type { DocuRoute, DocuConfig } from "./types";`,
+                  `const docuConfig = ${JSON.stringify(resolved)};`,
+                  `export const routes = docuConfig.routes || [];`,
+                  `export const config = docuConfig;`,
+                ].join("\n"),
+                loader: "ts",
+              };
             });
           },
         },

package/.docu/node/hydrate.ts

@@ -142,17 +142,27 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
       {
         name: "docu-config",
         setup(build) {
-          build.onResolve({ filter: /docu\.json$/ }, (args) => ({
+          // Components import as "../node/client-routes" (no .ts extension),
+          // so filter matches the path tail without requiring the extension.
+          build.onResolve({ filter: /client-routes$/ }, (args) => ({
             path: args.path,
-            namespace: "docu-config",
+            namespace: "client-routes",
           }));
-          build.onLoad({ filter: /.*/, namespace: "docu-config" }, () => {
+          build.onLoad({ filter: /.*/, namespace: "client-routes" }, () => {
             const config = loadDocuConfig();
             const resolved = {
               ...config,
               routes: resolveRoutes(config.routes as DocuRoute[] | undefined),
             };
-            return { contents: JSON.stringify(resolved), loader: "json" };
+            return {
+              contents: [
+                `import type { DocuRoute, DocuConfig } from "./types";`,
+                `const docuConfig = ${JSON.stringify(resolved)};`,
+                `export const routes = docuConfig.routes || [];`,
+                `export const config = docuConfig;`,
+              ].join("\n"),
+              loader: "ts",
+            };
           });
         },
       },

package/bin/compile-lib.mjs

@@ -35,30 +35,6 @@ await build({
   packages: "external",
   jsx: "automatic",
   logLevel: "info",
-  plugins: [
-    {
-      // The SSR component graph imports `docu.json` statically
-      // (client-routes.ts). At runtime that must be the USER's project
-      // config, so replace the import with a cwd-relative read instead of
-      // baking the monorepo's docu.json into the published bundle.
-      name: "docu-config-runtime",
-      setup(build) {
-        build.onResolve({ filter: /docu\.json$/ }, (args) => ({
-          path: args.path,
-          namespace: "docu-config-runtime",
-        }));
-        build.onLoad({ filter: /.*/, namespace: "docu-config-runtime" }, () => ({
-          contents: [
-            `import { readFileSync } from "node:fs";`,
-            `import { join } from "node:path";`,
-            `const config = JSON.parse(readFileSync(join(process.cwd(), "docu.json"), "utf-8"));`,
-            `export default config;`,
-          ].join("\n"),
-          loader: "js",
-        }));
-      },
-    },
-  ],
 });
 
 // esbuild's service process keeps Deno's event loop alive after one-shot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docubook/flame",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   "type": "module",
   "bin": {
@@ -57,8 +57,8 @@
     "@docubook/core": "^1.8.2",
     "@docubook/mdx-content": "^3.4.5",
     "@docubook/runt": "^1.0.0",
-    "@docubook/themes-colors": "^1.0.2",
-    "@docubook/ui-react": "^1.0.0"
+    "@docubook/ui-react": "^1.0.0",
+    "@docubook/themes-colors": "^1.0.2"
   },
   "peerDependencies": {
     "@sentry/bun": "^10.0.0"