@docubook/flame 1.5.0 → 1.5.1

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

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-654THQOR.js";
-import "./chunk-2QHMGZIL.js";
+} from "./chunk-E4OIJWCU.js";
+import "./chunk-AI7QAMMZ.js";
 import "./chunk-RE4NGTMT.js";
-import "./chunk-HH4YXWEF.js";
+import "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/build.deno.ts

package/.docu/lib/{build.impl-ST63VRTV.js → build.impl-7KJ4ZTAJ.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   runBuildCli
-} from "./chunk-654THQOR.js";
-import "./chunk-2QHMGZIL.js";
+} from "./chunk-E4OIJWCU.js";
+import "./chunk-AI7QAMMZ.js";
 import "./chunk-RE4NGTMT.js";
-import "./chunk-HH4YXWEF.js";
+import "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 export {
   runBuild,

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

@@ -1,9 +1,9 @@
 import {
   runBuildCli
-} from "./chunk-654THQOR.js";
-import "./chunk-2QHMGZIL.js";
+} from "./chunk-E4OIJWCU.js";
+import "./chunk-AI7QAMMZ.js";
 import "./chunk-RE4NGTMT.js";
-import "./chunk-HH4YXWEF.js";
+import "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/build.node.ts

package/.docu/lib/{chunk-X6GYOIYZ.js → chunk-7ZEUL6PR.js}

@@ -14,7 +14,7 @@ import {
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-2QHMGZIL.js";
+} from "./chunk-AI7QAMMZ.js";
 import {
   SECURITY_HEADERS,
   generateNonce,
@@ -27,7 +27,7 @@ import {
 } from "./chunk-RE4NGTMT.js";
 import {
   logger
-} from "./chunk-HH4YXWEF.js";
+} from "./chunk-PTRZ2S2C.js";
 import {
   DIST_DIR,
   DOCS_DIR,

package/.docu/lib/{chunk-2QHMGZIL.js → chunk-AI7QAMMZ.js}

@@ -847,15 +847,6 @@ async function buildClientBundle() {
               return { contents: JSON.stringify(resolved), loader: "json" };
             });
           }
-        },
-        {
-          name: "mdx-jsx-runtime",
-          setup(build2) {
-            build2.onLoad({ filter: /next-mdx-remote[/\\].*jsx-runtime/ }, () => {
-              const source = nodeEnv === "production" ? `module.exports.jsxRuntime = require("react/jsx-runtime");` : `module.exports.jsxRuntime = require("react/jsx-dev-runtime");`;
-              return { contents: source, loader: "js" };
-            });
-          }
         }
       ]
     });

package/.docu/lib/{chunk-654THQOR.js → chunk-E4OIJWCU.js}

@@ -13,14 +13,14 @@ import {
   htmlShell,
   initSentry,
   loadPlugins
-} from "./chunk-2QHMGZIL.js";
+} from "./chunk-AI7QAMMZ.js";
 import {
   generateNonce,
   scanMdxFiles
 } from "./chunk-RE4NGTMT.js";
 import {
   logger
-} from "./chunk-HH4YXWEF.js";
+} from "./chunk-PTRZ2S2C.js";
 import {
   ASSETS_DIR,
   CACHE_FILE,
@@ -32,99 +32,12 @@ import {
 } from "./chunk-J5NMYSBJ.js";
 
 // .docu/node/build.impl.ts
-import { readFile, writeFile, mkdir, readdir as readdir2, copyFile } from "node:fs/promises";
-import { existsSync as existsSync2 } from "node:fs";
+import { readFile, writeFile, mkdir, readdir, copyFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
 import { createHash } from "node:crypto";
-import { join as join2, dirname } from "node:path";
+import { join, dirname } from "node:path";
 import React from "react";
 import { renderToString } from "react-dom/server";
-
-// .docu/node/build-summary.ts
-import { readdir, stat } from "node:fs/promises";
-import { join, relative, extname } from "node:path";
-import { existsSync } from "node:fs";
-var MAX_FILES_SHOWN = 10;
-var SEP = "\u2500".repeat(60);
-function formatSize(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(2)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
-}
-async function walkFiles(dir) {
-  const out = [];
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      out.push(...await walkFiles(full));
-    } else if (entry.isFile()) {
-      const s = await stat(full);
-      out.push({ path: full, size: s.size });
-    }
-  }
-  return out;
-}
-async function collectBuildOutput(distDir) {
-  if (!existsSync(distDir)) return null;
-  const all = await walkFiles(distDir);
-  if (all.length === 0) return null;
-  const files = all.map((f) => ({ path: relative(distDir, f.path), size: f.size })).sort((a, b) => b.size !== a.size ? b.size - a.size : a.path.localeCompare(b.path));
-  const byExt = /* @__PURE__ */ new Map();
-  for (const f of files) {
-    const ext = extname(f.path) || "(none)";
-    const entry = byExt.get(ext) ?? { ext, count: 0, size: 0 };
-    entry.count++;
-    entry.size += f.size;
-    byExt.set(ext, entry);
-  }
-  const byType = [...byExt.values()].sort(
-    (a, b) => b.size !== a.size ? b.size - a.size : b.count - a.count
-  );
-  return {
-    files,
-    byType,
-    totalFiles: files.length,
-    totalSize: files.reduce((sum, f) => sum + f.size, 0)
-  };
-}
-function formatBuildSummary(output) {
-  const lines = [];
-  lines.push("\u{1F4E6} Build Output Summary:");
-  lines.push(SEP);
-  const shown = output.files.slice(0, MAX_FILES_SHOWN);
-  const nameWidth = Math.min(Math.max(...shown.map((f) => f.path.length), 1), 50);
-  for (const f of shown) {
-    lines.push(`  ${f.path.padEnd(nameWidth)}  ${formatSize(f.size).padStart(10)}`);
-  }
-  const remaining = output.totalFiles - shown.length;
-  if (remaining > 0) {
-    lines.push(`  ... and ${remaining} more file${remaining === 1 ? "" : "s"}`);
-  }
-  lines.push(SEP);
-  lines.push("\u{1F4CA} Summary by Type:");
-  const extWidth = Math.max(...output.byType.map((t) => t.ext.length), 1);
-  for (const t of output.byType) {
-    const plural = t.count === 1 ? "file" : "files";
-    lines.push(
-      `  ${t.ext.padEnd(extWidth)}   ${String(t.count).padStart(3)} ${plural}   ${formatSize(
-        t.size
-      ).padStart(10)}`
-    );
-  }
-  lines.push(SEP);
-  const totalPlural = output.totalFiles === 1 ? "file" : "files";
-  lines.push(
-    `\u{1F4C8} Total: ${output.totalFiles} ${totalPlural}   ${formatSize(output.totalSize).padStart(10)}`
-  );
-  lines.push(SEP);
-  return lines.join("\n");
-}
-async function generateBuildSummary(distDir) {
-  const output = await collectBuildOutput(distDir);
-  return output ? formatBuildSummary(output) : null;
-}
-
-// .docu/node/build.impl.ts
 function parseArgs() {
   const args = process.argv.slice(2);
   return {
@@ -137,7 +50,7 @@ function hashContent(content) {
 }
 async function readCache() {
   try {
-    if (existsSync2(CACHE_FILE)) {
+    if (existsSync(CACHE_FILE)) {
       const data = await readFile(CACHE_FILE, "utf-8");
       return JSON.parse(data);
     }
@@ -229,12 +142,12 @@ ${msg}`, { cause: err });
   return html;
 }
 async function copyDirectoryRecursive(src, dest) {
-  if (!existsSync2(src)) return;
+  if (!existsSync(src)) return;
   await mkdir(dest, { recursive: true });
-  const entries = await readdir2(src, { withFileTypes: true });
+  const entries = await readdir(src, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = join2(src, entry.name);
-    const destPath = join2(dest, entry.name);
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
     if (entry.isDirectory()) {
       await copyDirectoryRecursive(srcPath, destPath);
     } else {
@@ -256,7 +169,7 @@ async function runBuild() {
   }
   await mkdir(DIST_DIR, { recursive: true });
   await mkdir(ASSETS_DIR, { recursive: true });
-  await copyDirectoryRecursive(DOCS_ASSETS_DIR, join2(DIST_DIR, "docs", "assets"));
+  await copyDirectoryRecursive(DOCS_ASSETS_DIR, join(DIST_DIR, "docs", "assets"));
   const mdxFiles = await scanMdxFiles(DOCS_DIR);
   const cache = args.force ? {} : await readCache();
   let built = 0;
@@ -287,8 +200,8 @@ async function runBuild() {
   logger.spinner.start("Building pages...");
   t = performance.now();
   const allRelPaths = mdxFiles.map((f) => f.absPath.replace(PROJECT_ROOT + "/", ""));
-  const indexMdxFull = join2(DOCS_DIR, "index.mdx");
-  if (existsSync2(indexMdxFull)) {
+  const indexMdxFull = join(DOCS_DIR, "index.mdx");
+  if (existsSync(indexMdxFull)) {
     allRelPaths.push(indexMdxFull.replace(PROJECT_ROOT + "/", ""));
   }
   const gitDates = await getGitLastModifiedBatch(allRelPaths);
@@ -298,8 +211,8 @@ async function runBuild() {
   for (const file of mdxFiles) {
     const rebuildDecision = shouldRebuild(file.path, file.mtime, cache);
     if (rebuildDecision === "no") {
-      const outputPath = join2(DIST_DIR, "docs", `${file.path}.html`);
-      if (existsSync2(outputPath) && !assetsChanged) {
+      const outputPath = join(DIST_DIR, "docs", `${file.path}.html`);
+      if (existsSync(outputPath) && !assetsChanged) {
         skipped++;
         continue;
       }
@@ -316,8 +229,8 @@ async function runBuild() {
       const cached = cache[file.path];
       if (cached && cached.hash === contentHash) {
         if (!assetsChanged) {
-          const outputPath = join2(DIST_DIR, "docs", `${file.path}.html`);
-          if (existsSync2(outputPath)) {
+          const outputPath = join(DIST_DIR, "docs", `${file.path}.html`);
+          if (existsSync(outputPath)) {
             cache[file.path] = { ...cached, mtime: file.mtime, builtAt: Date.now() };
             skipped++;
             continue;
@@ -340,7 +253,7 @@ async function runBuild() {
           builder,
           pageNonce
         );
-        const outputPath = join2(DIST_DIR, "docs", `${capturedFile.path}.html`);
+        const outputPath = join(DIST_DIR, "docs", `${capturedFile.path}.html`);
         await mkdir(dirname(outputPath), { recursive: true });
         await writeFile(outputPath, html);
         cache[capturedFile.path] = {
@@ -362,7 +275,7 @@ async function runBuild() {
     await Promise.all(buildTasks.slice(i, i + CONCURRENCY).map((fn) => fn()));
   }
   try {
-    const indexMdxPath = join2(DOCS_DIR, "index.mdx");
+    const indexMdxPath = join(DOCS_DIR, "index.mdx");
     const indexRaw = await readFile(indexMdxPath, "utf-8");
     const indexRelPath = indexMdxPath.replace(PROJECT_ROOT + "/", "");
     const indexHtml = await renderDocsPage(
@@ -374,8 +287,8 @@ async function runBuild() {
       builder,
       generateNonce()
     );
-    await mkdir(join2(DIST_DIR, "docs"), { recursive: true });
-    await writeFile(join2(DIST_DIR, "docs", "index.html"), indexHtml);
+    await mkdir(join(DIST_DIR, "docs"), { recursive: true });
+    await writeFile(join(DIST_DIR, "docs", "index.html"), indexHtml);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     errors.push(`index.mdx: ${msg}`);
@@ -395,7 +308,7 @@ async function runBuild() {
     nonce: generateNonce(),
     themeCss: inlineThemeCss
   });
-  await writeFile(join2(DIST_DIR, "index.html"), landingHtml);
+  await writeFile(join(DIST_DIR, "index.html"), landingHtml);
   const notFoundPage = React.createElement(
     DocsLayout,
     { repoUrl: docuConfig.repo?.url },
@@ -412,7 +325,7 @@ async function runBuild() {
     nonce: generateNonce(),
     themeCss: inlineThemeCss
   });
-  await writeFile(join2(DIST_DIR, "404.html"), notFoundHtml);
+  await writeFile(join(DIST_DIR, "404.html"), notFoundHtml);
   logger.spinner.stop(
     `Built ${built} pages (${skipped} cached) \x1B[90m(${Math.round(performance.now() - t)}ms)\x1B[0m`
   );
@@ -420,8 +333,8 @@ async function runBuild() {
     const pages = mdxFiles.map((f) => ({
       slug: f.path,
       title: f.path.split("/").pop() || f.path,
-      filePath: join2(DOCS_DIR, f.path),
-      outputPath: join2(DIST_DIR, "docs", `${f.path}.html`)
+      filePath: join(DOCS_DIR, f.path),
+      outputPath: join(DIST_DIR, "docs", `${f.path}.html`)
     }));
     await builder.runOnEnd(pages);
   }
@@ -430,12 +343,6 @@ async function runBuild() {
   const indexCount = await generateSearchIndex();
   logger.indexDone(indexCount, Math.round(performance.now() - t));
   logger.routes();
-  console.log("");
-  const buildSummary = await generateBuildSummary(DIST_DIR);
-  if (buildSummary) {
-    console.log(buildSummary);
-    console.log("");
-  }
   await writeCache(cache);
   if (errors.length > 0) {
     console.error(`

package/.docu/lib/{chunk-C6RZ2KBH.js → chunk-IR5TVJOV.js}

@@ -12,7 +12,7 @@ var WORKFLOW_FILE = join(WORKFLOW_DIR, "deploy.yml");
 async function runDeploy() {
   console.log("\u{1F4E6} Building for production...\n");
   process.env.NODE_ENV = "production";
-  const { runBuildCli } = await import("./build.impl-ST63VRTV.js");
+  const { runBuildCli } = await import("./build.impl-7KJ4ZTAJ.js");
   await runBuildCli();
   await writeFile(join(DIST_DIR, ".nojekyll"), "");
   if (!existsSync(WORKFLOW_FILE)) {

package/.docu/lib/{chunk-HH4YXWEF.js → chunk-PTRZ2S2C.js}

@@ -5,7 +5,7 @@ import {
 // package.json
 var package_default = {
   name: "@docubook/flame",
-  version: "1.5.0",
+  version: "1.5.1",
   description: "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   type: "module",
   bin: {
@@ -89,13 +89,11 @@ var package_default = {
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    autoprefixer: "^10.4.0",
     "bun-types": "^1.3.0",
     eslint: "^10.3.0",
     "eslint-plugin-perfectionist": "^5.9.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
-    postcss: "^8.4.0",
     tailwindcss: "^4.3.0",
     typescript: "^5.9.3",
     "typescript-eslint": "^8.59.2"

package/.docu/lib/{chunk-ZOWTASXL.js → chunk-TE52TIEW.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-RE4NGTMT.js";
 import {
   logger
-} from "./chunk-HH4YXWEF.js";
+} from "./chunk-PTRZ2S2C.js";
 import {
   DIST_DIR
 } from "./chunk-J5NMYSBJ.js";

package/.docu/lib/clean.js

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-HH4YXWEF.js";
+} from "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/clean.ts

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

@@ -1,6 +1,6 @@
 import {
   runDeploy
-} from "./chunk-C6RZ2KBH.js";
+} from "./chunk-IR5TVJOV.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/deploy.deno.ts

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

@@ -1,6 +1,6 @@
 import {
   runDeploy
-} from "./chunk-C6RZ2KBH.js";
+} from "./chunk-IR5TVJOV.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/deploy.node.ts

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

@@ -1,8 +1,8 @@
 import {
   runPreview
-} from "./chunk-ZOWTASXL.js";
+} from "./chunk-TE52TIEW.js";
 import "./chunk-RE4NGTMT.js";
-import "./chunk-HH4YXWEF.js";
+import "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/preview.deno.ts

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

@@ -1,8 +1,8 @@
 import {
   runPreview
-} from "./chunk-ZOWTASXL.js";
+} from "./chunk-TE52TIEW.js";
 import "./chunk-RE4NGTMT.js";
-import "./chunk-HH4YXWEF.js";
+import "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/preview.node.ts

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

@@ -1,9 +1,9 @@
 import {
   runServer
-} from "./chunk-X6GYOIYZ.js";
-import "./chunk-2QHMGZIL.js";
+} from "./chunk-7ZEUL6PR.js";
+import "./chunk-AI7QAMMZ.js";
 import "./chunk-RE4NGTMT.js";
-import "./chunk-HH4YXWEF.js";
+import "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/server.deno.ts

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

@@ -1,9 +1,9 @@
 import {
   runServer
-} from "./chunk-X6GYOIYZ.js";
-import "./chunk-2QHMGZIL.js";
+} from "./chunk-7ZEUL6PR.js";
+import "./chunk-AI7QAMMZ.js";
 import "./chunk-RE4NGTMT.js";
-import "./chunk-HH4YXWEF.js";
+import "./chunk-PTRZ2S2C.js";
 import "./chunk-J5NMYSBJ.js";
 
 // .docu/node/server.node.ts

package/.docu/node/build.impl.ts

@@ -26,7 +26,6 @@ import { htmlShell } from "./html.shared";
 import { generateSearchIndex } from "./search-indexer";
 import { buildClientBundle, computeInlineThemeCss } from "./hydrate.node";
 import { logger } from "./logger";
-import { generateBuildSummary } from "./build-summary";
 import { initSentry, captureException } from "./sentry";
 import { loadPlugins } from "./plugin-loader";
 import { BuildPluginBuilder } from "./plugin-builder";
@@ -396,13 +395,6 @@ export async function runBuild(): Promise<void> {
   logger.indexDone(indexCount, Math.round(performance.now() - t));
 
   logger.routes();
-  console.log("");
-
-  const buildSummary = await generateBuildSummary(DIST_DIR);
-  if (buildSummary) {
-    console.log(buildSummary);
-    console.log("");
-  }
 
   await writeCache(cache);
 

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

@@ -226,18 +226,7 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
             });
           },
         },
-        {
-          name: "mdx-jsx-runtime",
-          setup(build) {
-            build.onLoad({ filter: /next-mdx-remote[/\\].*jsx-runtime/ }, () => {
-              const source =
-                nodeEnv === "production"
-                  ? `module.exports.jsxRuntime = require("react/jsx-runtime");`
-                  : `module.exports.jsxRuntime = require("react/jsx-dev-runtime");`;
-              return { contents: source, loader: "js" };
-            });
-          },
-        },
+
       ],
     });
   } finally {

package/.docu/node/hydrate.ts

@@ -92,18 +92,7 @@ export async function buildClientBundle(): Promise<{ js: string; css: string }>
           });
         },
       },
-      {
-        name: "mdx-jsx-runtime",
-        setup(build) {
-          build.onLoad({ filter: /next-mdx-remote[/\\].*jsx-runtime/ }, () => {
-            const source =
-              nodeEnv === "production"
-                ? `module.exports.jsxRuntime = require("react/jsx-runtime");`
-                : `module.exports.jsxRuntime = require("react/jsx-dev-runtime");`;
-            return { contents: source, loader: "js" };
-          });
-        },
-      },
+
     ],
   });
 

package/bin/cli.js

@@ -9,9 +9,13 @@ import { spawnSync } from "node:child_process";
 const __dirname = import.meta.dirname;
 
 // Runtime detection — override with FLAME_RUNTIME=bun|node|deno for testing.
+// Deno's npm compat layer may expose `Bun` via globals, check execPath first.
 const runtime =
   process.env.FLAME_RUNTIME ||
-  (typeof Bun !== "undefined" ? "bun" : typeof Deno !== "undefined" ? "deno" : "node");
+  (process.execPath.includes("deno") ? "deno" :
+   typeof Bun !== "undefined" ? "bun" :
+   typeof Deno !== "undefined" ? "deno" :
+   "node");
 
 const COMMAND_MAP = {
   bun: {
@@ -107,13 +111,19 @@ if (command === "init") {
         preview: `${flameCmd} preview`,
         deploy: `${flameCmd} deploy`,
       };
+
+      // Generate deno.json with nodeModulesDir for npm compat.
+      const denoConfig = {
+        nodeModulesDir: "auto",
+      };
+      writeFileSync(join(targetDir, "deno.json"), JSON.stringify(denoConfig, null, 2) + "\n");
     }
     writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 
     const nextSteps = {
       bun: "    bun install\n    bun run dev",
       node: "    npm install\n    npm run dev",
-      deno: "    deno task dev",
+      deno: "    deno task dev\n\n  ⚠️  If you see a freshness error, run:\n    DENO_ALLOW_NEWER=true deno task dev",
     }[runtime];
     console.log(`\n  ✓ Project scaffolded!\n\n  Next steps:\n${nextSteps}\n`);
     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docubook/flame",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   "type": "module",
   "bin": {
@@ -54,8 +54,8 @@
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "unified": "^11.0.0",
-    "@docubook/core": "^1.8.1",
-    "@docubook/mdx-content": "^3.4.2",
+    "@docubook/core": "^1.8.2",
+    "@docubook/mdx-content": "^3.4.3",
     "@docubook/runt": "^1.0.0",
     "@docubook/themes-colors": "^1.0.0",
     "@docubook/ui-react": "^1.0.0"
@@ -73,13 +73,11 @@
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "autoprefixer": "^10.4.0",
     "bun-types": "^1.3.0",
     "eslint": "^10.3.0",
     "eslint-plugin-perfectionist": "^5.9.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
-    "postcss": "^8.4.0",
     "tailwindcss": "^4.3.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.59.2"

package/template/docs/guide/deployment.mdx

@@ -8,7 +8,7 @@ Flame produces **flat static HTML** — no server, no database, no runtime requi
 ## GitHub Pages
 
 ```bash
-npm run deploy
+npm run deploy       # or: bun run deploy / deno task deploy
 ```
 
 This builds the site, adds `.nojekyll`, and generates a GitHub Actions workflow on first run.
@@ -16,7 +16,7 @@ This builds the site, adds `.nojekyll`, and generates a GitHub Actions workflow
 ## Manual
 
 ```bash
-npm run build
+npm run build        # or: bun run build / deno task build
 ```
 
 Upload `.docu/dist/` to any of:

package/.docu/node/build-summary.ts

@@ -1,126 +0,0 @@
-/**
- * Build output summary: walks `dist` after a build, collects generated files
- * and their sizes, groups them by extension, and formats a scannable report
- * for CI logs. Runtime-neutral — uses only `node:fs/promises` and `node:path`
- * so it runs identically under Bun, Node, and Deno.
- */
-
-import { readdir, stat } from "node:fs/promises";
-import { join, relative, extname } from "node:path";
-import { existsSync } from "node:fs";
-
-export interface BuildOutputFile {
-  path: string;
-  size: number;
-}
-
-export interface BuildOutputType {
-  ext: string;
-  count: number;
-  size: number;
-}
-
-export interface BuildOutput {
-  files: BuildOutputFile[];
-  byType: BuildOutputType[];
-  totalFiles: number;
-  totalSize: number;
-}
-
-const MAX_FILES_SHOWN = 10;
-const SEP = "─".repeat(60);
-
-export function formatSize(bytes: number): string {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(2)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
-}
-
-async function walkFiles(dir: string): Promise<BuildOutputFile[]> {
-  const out: BuildOutputFile[] = [];
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      out.push(...(await walkFiles(full)));
-    } else if (entry.isFile()) {
-      const s = await stat(full);
-      out.push({ path: full, size: s.size });
-    }
-  }
-  return out;
-}
-
-/** Collect build output metadata for `distDir`. Returns `null` if the dir is missing or empty. */
-export async function collectBuildOutput(distDir: string): Promise<BuildOutput | null> {
-  if (!existsSync(distDir)) return null;
-  const all = await walkFiles(distDir);
-  if (all.length === 0) return null;
-
-  const files = all
-    .map((f) => ({ path: relative(distDir, f.path), size: f.size }))
-    .sort((a, b) => (b.size !== a.size ? b.size - a.size : a.path.localeCompare(b.path)));
-
-  const byExt = new Map<string, BuildOutputType>();
-  for (const f of files) {
-    const ext = extname(f.path) || "(none)";
-    const entry = byExt.get(ext) ?? { ext, count: 0, size: 0 };
-    entry.count++;
-    entry.size += f.size;
-    byExt.set(ext, entry);
-  }
-  const byType = [...byExt.values()].sort((a, b) =>
-    b.size !== a.size ? b.size - a.size : b.count - a.count
-  );
-
-  return {
-    files,
-    byType,
-    totalFiles: files.length,
-    totalSize: files.reduce((sum, f) => sum + f.size, 0),
-  };
-}
-
-/** Format `output` as a human-readable, color-free summary suitable for CI logs. */
-export function formatBuildSummary(output: BuildOutput): string {
-  const lines: string[] = [];
-  lines.push("📦 Build Output Summary:");
-  lines.push(SEP);
-
-  const shown = output.files.slice(0, MAX_FILES_SHOWN);
-  const nameWidth = Math.min(Math.max(...shown.map((f) => f.path.length), 1), 50);
-  for (const f of shown) {
-    lines.push(`  ${f.path.padEnd(nameWidth)}  ${formatSize(f.size).padStart(10)}`);
-  }
-  const remaining = output.totalFiles - shown.length;
-  if (remaining > 0) {
-    lines.push(`  ... and ${remaining} more file${remaining === 1 ? "" : "s"}`);
-  }
-
-  lines.push(SEP);
-  lines.push("📊 Summary by Type:");
-  const extWidth = Math.max(...output.byType.map((t) => t.ext.length), 1);
-  for (const t of output.byType) {
-    const plural = t.count === 1 ? "file" : "files";
-    lines.push(
-      `  ${t.ext.padEnd(extWidth)}   ${String(t.count).padStart(3)} ${plural}   ${formatSize(
-        t.size
-      ).padStart(10)}`
-    );
-  }
-
-  lines.push(SEP);
-  const totalPlural = output.totalFiles === 1 ? "file" : "files";
-  lines.push(
-    `📈 Total: ${output.totalFiles} ${totalPlural}   ${formatSize(output.totalSize).padStart(10)}`
-  );
-  lines.push(SEP);
-
-  return lines.join("\n");
-}
-
-/** Collect and format the build summary for `distDir`. Returns `null` when there is nothing to report. */
-export async function generateBuildSummary(distDir: string): Promise<string | null> {
-  const output = await collectBuildOutput(distDir);
-  return output ? formatBuildSummary(output) : null;
-}