@docubook/flame 2.0.0-beta.0 → 2.0.0-beta.2

package/.docu/lib/logger-CycvLCrQ.js

@@ -0,0 +1,312 @@
+import { d as loadDocuConfig } from "./paths-BtOIPBQ9.js";
+var package_default = {
+	name: "@docubook/flame",
+	version: "2.0.0-beta.2",
+	description: "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
+	type: "module",
+	bin: { "flame": "./bin/cli.js" },
+	files: [
+		"bin",
+		"template",
+		"docu.schema.json",
+		".docu",
+		"!.docu/__tests__",
+		"!.docu/dist",
+		"!.docu/build-cache.json",
+		"README.md",
+		"LICENSE"
+	],
+	publishConfig: {
+		"registry": "https://registry.npmjs.org/",
+		"access": "public"
+	},
+	engines: {
+		"node": ">=20.11",
+		"bun": ">=1.1.0"
+	},
+	scripts: {
+		"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",
+		"compile:lib": "node bin/compile-lib.mjs",
+		"test": "vitest run",
+		"lint": "eslint .",
+		"prepublishOnly": "bun .docu/node/clean.ts && eslint . && vitest run && node bin/compile-lib.mjs"
+	},
+	keywords: [
+		"docubook",
+		"documentation",
+		"static-site",
+		"daisyui",
+		"bun",
+		"docs framework",
+		"react",
+		"react-dom"
+	],
+	homepage: "https://github.com/DocuBook/docubook/tree/main/packages/flame",
+	repository: {
+		"type": "git",
+		"url": "git+https://github.com/DocuBook/docubook.git",
+		"directory": "packages/flame"
+	},
+	author: "wildan.nrs",
+	"author-url": "https://wildan.dev",
+	license: "MIT",
+	dependencies: {
+		"@docubook/core": "workspace:^",
+		"@docubook/markdown": "workspace:^",
+		"@docubook/themes-colors": "workspace:^",
+		"@docubook/ui-react": "workspace:^",
+		"@mdx-js/react": "^3.0.1",
+		"@tailwindcss/cli": "4.3.0",
+		"@tailwindcss/typography": "0.5.16",
+		"bun-plugin-tailwind": "^0.1.2",
+		"daisyui": "^5.5.19",
+		"vite": "^8.2.1",
+		"lucide-react": "^1.14.0",
+		"react": "^19.2.7",
+		"react-dom": "^19.2.7",
+		"unified": "^11.0.0",
+		"zod": "^4.4.3"
+	},
+	peerDependencies: { "@sentry/bun": "^10.0.0" },
+	peerDependenciesMeta: { "@sentry/bun": { "optional": true } },
+	devDependencies: {
+		"@eslint/js": "^10.0.1",
+		"@types/node": "^22.0.0",
+		"@types/react": "^19.0.0",
+		"@types/react-dom": "^19.0.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",
+		"tailwindcss": "^4.3.0",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.59.2"
+	}
+};
+//#endregion
+//#region .docu/node/logger.ts
+/**
+* Interactive CLI logger with spinner and tree-style route display.
+* Inspired by Next.js/Turbopack build output.
+*
+* Supports structured logging via environment variables:
+* - LOG_LEVEL: debug | info | warn | error (default: info)
+* - LOG_FORMAT: json | pretty (default: pretty)
+*/
+var docuConfig = loadDocuConfig();
+var isCI = !!(process.env.CI || process.env.NO_COLOR || !process.stdout.isTTY);
+var isJSON = (process.env.LOG_FORMAT || "pretty") === "json";
+var LEVELS = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+var currentLevel = LEVELS[process.env.LOG_LEVEL || "info"] ?? LEVELS.info;
+function shouldLog(level) {
+	return LEVELS[level] >= currentLevel;
+}
+function jsonLog(level, msg, meta) {
+	if (!shouldLog(level)) return;
+	const entry = {
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		...meta,
+		level,
+		msg
+	};
+	(level === "error" ? console.error : level === "warn" ? console.warn : console.log)(JSON.stringify(entry));
+}
+/** Returns true if the caller should skip (already handled or filtered). */
+function guard(level, msg, meta) {
+	if (isJSON) {
+		jsonLog(level, msg, meta);
+		return true;
+	}
+	return !shouldLog(level);
+}
+var c = isCI || isJSON ? {
+	reset: "",
+	bold: "",
+	dim: "",
+	green: "",
+	cyan: "",
+	magenta: "",
+	yellow: "",
+	red: "",
+	white: "",
+	gray: ""
+} : {
+	reset: "\x1B[0m",
+	bold: "\x1B[1m",
+	dim: "\x1B[2m",
+	green: "\x1B[32m",
+	cyan: "\x1B[36m",
+	magenta: "\x1B[35m",
+	yellow: "\x1B[33m",
+	red: "\x1B[31m",
+	white: "\x1B[37m",
+	gray: "\x1B[90m"
+};
+var SPINNER_FRAMES = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+var Spinner = class {
+	frame = 0;
+	message = "";
+	timer = null;
+	info(finalMsg) {
+		if (this.timer) clearInterval(this.timer);
+		this.timer = null;
+		if (isCI) console.log(`ℹ ${finalMsg}`);
+		else {
+			process.stdout.write(`\r\x1b[K${c.cyan}ℹ${c.reset} ${finalMsg}\n`);
+			process.stdout.write("\x1B[?25h");
+		}
+	}
+	start(msg) {
+		this.message = msg;
+		if (isCI) {
+			console.log(`… ${msg}`);
+			return;
+		}
+		this.frame = 0;
+		process.stdout.write("\x1B[?25l");
+		this.render();
+		this.timer = setInterval(() => this.render(), 80);
+	}
+	stop(finalMsg) {
+		if (this.timer) clearInterval(this.timer);
+		this.timer = null;
+		if (isCI) {
+			console.log(`✓ ${finalMsg}`);
+			return;
+		}
+		process.stdout.write(`\r\x1b[K${c.green}✓${c.reset} ${finalMsg}\n`);
+		process.stdout.write("\x1B[?25h");
+	}
+	render() {
+		const f = SPINNER_FRAMES[this.frame % SPINNER_FRAMES.length];
+		process.stdout.write(`\r${c.cyan}${f}${c.reset} ${this.message}`);
+		this.frame++;
+	}
+};
+var MAX_ROUTE_LINES = 5;
+var routeLineCount = 0;
+var routeTruncated = false;
+function printRouteTree(routes, prefix = "", isRoot = true) {
+	for (let i = 0; i < routes.length; i++) {
+		if (routeTruncated) return;
+		if (routeLineCount >= MAX_ROUTE_LINES) {
+			routeTruncated = true;
+			process.stdout.write(`${prefix}${c.dim}...${c.reset}\n`);
+			return;
+		}
+		const route = routes[i];
+		const last = i === routes.length - 1;
+		const connector = isRoot ? "" : last ? "└── " : "├── ";
+		const childPrefix = isRoot ? "" : last ? "    " : "│   ";
+		const path = route.noLink ? `${c.dim}${route.href}${c.reset}` : `${c.white}${route.href}${c.reset}`;
+		const label = route.noLink ? `${c.gray}(group)${c.reset}` : "";
+		process.stdout.write(`${prefix}${connector}${path} ${label}\n`);
+		routeLineCount++;
+		if (route.items?.length) printRouteTree(route.items, prefix + childPrefix, false);
+	}
+}
+var logger = {
+	spinner: new Spinner(),
+	buildStart() {
+		if (guard("info", "build_start", {
+			package: "@docubook/flame",
+			version: package_default.version
+		})) return;
+		console.log(`\n${c.bold}${c.cyan}  🔥 DocuBook Flame${c.reset} ${c.dim}v${package_default.version}${c.reset}\n`);
+	},
+	bundleStart() {
+		if (guard("info", "bundle_start")) return;
+		this.spinner.start("Building client bundle...");
+	},
+	bundleDone(ms) {
+		if (guard("info", "bundle_done", { duration_ms: ms })) return;
+		this.spinner.stop(`Client bundle compiled ${c.dim}(${ms}ms)${c.reset}`);
+	},
+	indexStart() {
+		if (guard("info", "index_start")) return;
+		this.spinner.start("Generating search index...");
+	},
+	indexDone(records, ms, skipped = false) {
+		if (guard("info", "index_done", {
+			records,
+			duration_ms: ms,
+			skipped
+		})) return;
+		this.spinner.stop(skipped ? `Search index cached ${c.dim}(${ms}ms)${c.reset}` : `Search index generated ${c.dim}(${records} records, ${ms}ms)${c.reset}`);
+	},
+	routes() {
+		if (guard("debug", "routes")) return;
+		const routes = docuConfig.routes;
+		if (!routes?.length) return;
+		console.log(`\n${c.bold}  Routes${c.reset} ${c.dim}(${countRoutes(routes)} pages)${c.reset}\n`);
+		routeLineCount = 0;
+		routeTruncated = false;
+		printRouteTree(routes, "  ");
+	},
+	ready(port, hmr = false) {
+		if (guard("info", "server_ready", {
+			port,
+			hmr
+		})) return;
+		console.log(`\n${c.green}${c.bold}  ✓ Ready${c.reset} in ${c.bold}http://localhost:${port}/docs/${c.reset}`);
+		if (hmr) console.log(`${c.dim}  HMR enabled — watching docs/ for changes${c.reset}`);
+		console.log("");
+	},
+	request(method, pathname, status, duration_ms) {
+		if (guard("info", "http_request", {
+			method,
+			path: pathname,
+			status,
+			duration_ms
+		})) return;
+		const color = status >= 500 ? c.red : status >= 400 ? c.gray : c.green;
+		const ts = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+		const dur = duration_ms != null ? ` ${c.dim}${duration_ms}ms${c.reset}` : "";
+		console.log(`${c.dim}  ${ts}${c.reset} ${method} ${pathname} ${color}${status}${c.reset}${dur}`);
+	},
+	debug(msg, meta) {
+		if (guard("debug", msg, meta)) return;
+		console.log(`${c.gray}  [debug] ${msg}${c.reset}`);
+	},
+	warn(msg, meta) {
+		if (guard("warn", msg, meta)) return;
+		console.warn(`${c.yellow}  ⚠ ${msg}${c.reset}`);
+	},
+	error(msg, meta) {
+		if (guard("error", msg, meta)) return;
+		console.error(`${c.red}  ✖ ${msg}${c.reset}`);
+	}
+};
+function countRoutes(routes) {
+	let count = 0;
+	for (const r of routes) {
+		if (!r.noLink) count++;
+		if (r.items) count += countRoutes(r.items);
+	}
+	return count;
+}
+//#endregion
+export { logger as t };
+
+//# sourceMappingURL=logger-CycvLCrQ.js.map

package/.docu/lib/logger-CycvLCrQ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-CycvLCrQ.js","names":[],"sources":["../../package.json","../node/logger.ts"],"sourcesContent":["{\n  \"name\": \"@docubook/flame\",\n  \"version\": \"2.0.0-beta.2\",\n  \"description\": \"A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"flame\": \"./bin/cli.js\"\n  },\n  \"files\": [\n    \"bin\",\n    \"template\",\n    \"docu.schema.json\",\n    \".docu\",\n    \"!.docu/__tests__\",\n    \"!.docu/dist\",\n    \"!.docu/build-cache.json\",\n    \"README.md\",\n    \"LICENSE\"\n  ],\n  \"publishConfig\": {\n    \"registry\": \"https://registry.npmjs.org/\",\n    \"access\": \"public\"\n  },\n  \"engines\": {\n    \"node\": \">=20.11\",\n    \"bun\": \">=1.1.0\"\n  },\n  \"scripts\": {\n    \"dev\": \"bun .docu/node/server.ts\",\n    \"build\": \"NODE_ENV=production bun .docu/node/build.ts\",\n    \"clean\": \"bun .docu/node/clean.ts\",\n    \"preview\": \"bun .docu/node/preview.ts\",\n    \"deploy\": \"bun .docu/node/deploy.ts\",\n    \"compile:lib\": \"node bin/compile-lib.mjs\",\n    \"test\": \"vitest run\",\n    \"lint\": \"eslint .\",\n    \"prepublishOnly\": \"bun .docu/node/clean.ts && eslint . && vitest run && node bin/compile-lib.mjs\"\n  },\n  \"keywords\": [\n    \"docubook\",\n    \"documentation\",\n    \"static-site\",\n    \"daisyui\",\n    \"bun\",\n    \"docs framework\",\n    \"react\",\n    \"react-dom\"\n  ],\n  \"homepage\": \"https://github.com/DocuBook/docubook/tree/main/packages/flame\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/DocuBook/docubook.git\",\n    \"directory\": \"packages/flame\"\n  },\n  \"author\": \"wildan.nrs\",\n  \"author-url\": \"https://wildan.dev\",\n  \"license\": \"MIT\",\n  \"dependencies\": {\n    \"@docubook/core\": \"workspace:^\",\n    \"@docubook/markdown\": \"workspace:^\",\n    \"@docubook/themes-colors\": \"workspace:^\",\n    \"@docubook/ui-react\": \"workspace:^\",\n    \"@mdx-js/react\": \"^3.0.1\",\n    \"@tailwindcss/cli\": \"4.3.0\",\n    \"@tailwindcss/typography\": \"0.5.16\",\n    \"bun-plugin-tailwind\": \"^0.1.2\",\n    \"daisyui\": \"^5.5.19\",\n    \"vite\": \"^8.2.1\",\n    \"lucide-react\": \"^1.14.0\",\n    \"react\": \"^19.2.7\",\n    \"react-dom\": \"^19.2.7\",\n    \"unified\": \"^11.0.0\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"peerDependencies\": {\n    \"@sentry/bun\": \"^10.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@sentry/bun\": {\n      \"optional\": true\n    }\n  },\n  \"devDependencies\": {\n    \"@eslint/js\": \"^10.0.1\",\n    \"@types/node\": \"^22.0.0\",\n    \"@types/react\": \"^19.0.0\",\n    \"@types/react-dom\": \"^19.0.0\",\n    \"bun-types\": \"^1.3.0\",\n    \"eslint\": \"^10.3.0\",\n    \"eslint-plugin-perfectionist\": \"^5.9.0\",\n    \"eslint-plugin-react\": \"^7.37.5\",\n    \"eslint-plugin-react-hooks\": \"^7.1.1\",\n    \"tailwindcss\": \"^4.3.0\",\n    \"typescript\": \"^5.9.3\",\n    \"typescript-eslint\": \"^8.59.2\"\n  }\n}\n","/**\n * Interactive CLI logger with spinner and tree-style route display.\n * Inspired by Next.js/Turbopack build output.\n *\n * Supports structured logging via environment variables:\n * - LOG_LEVEL: debug | info | warn | error (default: info)\n * - LOG_FORMAT: json | pretty (default: pretty)\n */\n\nimport { loadDocuConfig } from \"./paths\";\nimport pkg from \"../../package.json\" with { type: \"json\" };\n\nconst docuConfig = loadDocuConfig();\nconst isCI = !!(process.env.CI || process.env.NO_COLOR || !process.stdout.isTTY);\nconst LOG_FORMAT = process.env.LOG_FORMAT || \"pretty\";\nconst isJSON = LOG_FORMAT === \"json\";\n\ntype LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\nconst LEVELS: Record<LogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };\nconst currentLevel = LEVELS[(process.env.LOG_LEVEL as LogLevel) || \"info\"] ?? LEVELS.info;\n\nfunction shouldLog(level: LogLevel): boolean {\n  return LEVELS[level] >= currentLevel;\n}\n\nfunction jsonLog(level: LogLevel, msg: string, meta?: Record<string, unknown>) {\n  if (!shouldLog(level)) return;\n  const entry = { ts: new Date().toISOString(), ...meta, level, msg };\n  const out = level === \"error\" ? console.error : level === \"warn\" ? console.warn : console.log;\n  out(JSON.stringify(entry));\n}\n\n/** Returns true if the caller should skip (already handled or filtered). */\nfunction guard(level: LogLevel, msg: string, meta?: Record<string, unknown>): boolean {\n  if (isJSON) {\n    jsonLog(level, msg, meta);\n    return true;\n  }\n  return !shouldLog(level);\n}\n\nconst c =\n  isCI || isJSON\n    ? {\n        reset: \"\",\n        bold: \"\",\n        dim: \"\",\n        green: \"\",\n        cyan: \"\",\n        magenta: \"\",\n        yellow: \"\",\n        red: \"\",\n        white: \"\",\n        gray: \"\",\n      }\n    : {\n        reset: \"\\x1b[0m\",\n        bold: \"\\x1b[1m\",\n        dim: \"\\x1b[2m\",\n        green: \"\\x1b[32m\",\n        cyan: \"\\x1b[36m\",\n        magenta: \"\\x1b[35m\",\n        yellow: \"\\x1b[33m\",\n        red: \"\\x1b[31m\",\n        white: \"\\x1b[37m\",\n        gray: \"\\x1b[90m\",\n      };\n\nconst SPINNER_FRAMES = [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"];\n\nclass Spinner {\n  private frame = 0;\n  private message = \"\";\n  private timer: ReturnType<typeof setInterval> | null = null;\n\n  info(finalMsg: string) {\n    if (this.timer) clearInterval(this.timer);\n    this.timer = null;\n    if (isCI) {\n      console.log(`ℹ ${finalMsg}`);\n    } else {\n      process.stdout.write(`\\r\\x1b[K${c.cyan}ℹ${c.reset} ${finalMsg}\\n`);\n      process.stdout.write(\"\\x1b[?25h\");\n    }\n  }\n\n  start(msg: string) {\n    this.message = msg;\n    if (isCI) {\n      console.log(`… ${msg}`);\n      return;\n    }\n    this.frame = 0;\n    process.stdout.write(\"\\x1b[?25l\");\n    this.render();\n    this.timer = setInterval(() => this.render(), 80);\n  }\n\n  stop(finalMsg: string) {\n    if (this.timer) clearInterval(this.timer);\n    this.timer = null;\n    if (isCI) {\n      console.log(`✓ ${finalMsg}`);\n      return;\n    }\n    process.stdout.write(`\\r\\x1b[K${c.green}✓${c.reset} ${finalMsg}\\n`);\n    process.stdout.write(\"\\x1b[?25h\");\n  }\n\n  private render() {\n    const f = SPINNER_FRAMES[this.frame % SPINNER_FRAMES.length];\n    process.stdout.write(`\\r${c.cyan}${f}${c.reset} ${this.message}`);\n    this.frame++;\n  }\n}\n\ninterface RouteItem {\n  title: string;\n  href: string;\n  noLink?: boolean;\n  items?: RouteItem[];\n}\n\nconst MAX_ROUTE_LINES = 5;\nlet routeLineCount = 0;\nlet routeTruncated = false;\n\nfunction printRouteTree(routes: RouteItem[], prefix = \"\", isRoot = true) {\n  for (let i = 0; i < routes.length; i++) {\n    if (routeTruncated) return;\n    if (routeLineCount >= MAX_ROUTE_LINES) {\n      routeTruncated = true;\n      process.stdout.write(`${prefix}${c.dim}...${c.reset}\\n`);\n      return;\n    }\n\n    const route = routes[i];\n    const last = i === routes.length - 1;\n    const connector = isRoot ? \"\" : last ? \"└── \" : \"├── \";\n    const childPrefix = isRoot ? \"\" : last ? \"    \" : \"│   \";\n\n    const path = route.noLink\n      ? `${c.dim}${route.href}${c.reset}`\n      : `${c.white}${route.href}${c.reset}`;\n\n    const label = route.noLink ? `${c.gray}(group)${c.reset}` : \"\";\n\n    process.stdout.write(`${prefix}${connector}${path} ${label}\\n`);\n    routeLineCount++;\n\n    if (route.items?.length) {\n      printRouteTree(route.items, prefix + childPrefix, false);\n    }\n  }\n}\n\nexport const logger = {\n  spinner: new Spinner(),\n\n  buildStart() {\n    if (guard(\"info\", \"build_start\", { package: \"@docubook/flame\", version: pkg.version })) return;\n    console.log(\n      `\\n${c.bold}${c.cyan}  🔥 DocuBook Flame${c.reset} ${c.dim}v${pkg.version}${c.reset}\\n`\n    );\n  },\n\n  bundleStart() {\n    if (guard(\"info\", \"bundle_start\")) return;\n    this.spinner.start(\"Building client bundle...\");\n  },\n\n  bundleDone(ms: number) {\n    if (guard(\"info\", \"bundle_done\", { duration_ms: ms })) return;\n    this.spinner.stop(`Client bundle compiled ${c.dim}(${ms}ms)${c.reset}`);\n  },\n\n  indexStart() {\n    if (guard(\"info\", \"index_start\")) return;\n    this.spinner.start(\"Generating search index...\");\n  },\n\n  indexDone(records: number, ms: number, skipped = false) {\n    if (guard(\"info\", \"index_done\", { records, duration_ms: ms, skipped })) return;\n    this.spinner.stop(\n      skipped\n        ? `Search index cached ${c.dim}(${ms}ms)${c.reset}`\n        : `Search index generated ${c.dim}(${records} records, ${ms}ms)${c.reset}`\n    );\n  },\n\n  routes() {\n    if (guard(\"debug\", \"routes\")) return;\n    const routes = docuConfig.routes as RouteItem[] | undefined;\n    if (!routes?.length) return;\n\n    console.log(`\\n${c.bold}  Routes${c.reset} ${c.dim}(${countRoutes(routes)} pages)${c.reset}\\n`);\n    routeLineCount = 0;\n    routeTruncated = false;\n    printRouteTree(routes, \"  \");\n  },\n\n  ready(port: number, hmr = false) {\n    if (guard(\"info\", \"server_ready\", { port, hmr })) return;\n    console.log(\n      `\\n${c.green}${c.bold}  ✓ Ready${c.reset} in ${c.bold}http://localhost:${port}/docs/${c.reset}`\n    );\n    if (hmr) console.log(`${c.dim}  HMR enabled — watching docs/ for changes${c.reset}`);\n    console.log(\"\");\n  },\n\n  request(method: string, pathname: string, status: number, duration_ms?: number) {\n    if (guard(\"info\", \"http_request\", { method, path: pathname, status, duration_ms })) return;\n    const color = status >= 500 ? c.red : status >= 400 ? c.gray : c.green;\n    const ts = new Date().toLocaleTimeString();\n    const dur = duration_ms != null ? ` ${c.dim}${duration_ms}ms${c.reset}` : \"\";\n    console.log(\n      `${c.dim}  ${ts}${c.reset} ${method} ${pathname} ${color}${status}${c.reset}${dur}`\n    );\n  },\n\n  debug(msg: string, meta?: Record<string, unknown>) {\n    if (guard(\"debug\", msg, meta)) return;\n    console.log(`${c.gray}  [debug] ${msg}${c.reset}`);\n  },\n\n  warn(msg: string, meta?: Record<string, unknown>) {\n    if (guard(\"warn\", msg, meta)) return;\n    console.warn(`${c.yellow}  ⚠ ${msg}${c.reset}`);\n  },\n\n  error(msg: string, meta?: Record<string, unknown>) {\n    if (guard(\"error\", msg, meta)) return;\n    console.error(`${c.red}  ✖ ${msg}${c.reset}`);\n  },\n};\n\nfunction countRoutes(routes: RouteItem[]): number {\n  let count = 0;\n  for (const r of routes) {\n    if (!r.noLink) count++;\n    if (r.items) count += countRoutes(r.items);\n  }\n  return count;\n}\n"],"mappings":"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"}

package/.docu/lib/node-DPTySdwG.js

@@ -0,0 +1,80 @@
+import { createServer } from "node:http";
+//#region .docu/node/runtime/node.ts
+function toWebRequest(req, port, hostname) {
+	const url = `http://${req.headers.host ?? `${hostname}:${port}`}${req.url ?? "/"}`;
+	const headers = new Headers();
+	for (const [key, value] of Object.entries(req.headers)) {
+		if (value === void 0) continue;
+		if (Array.isArray(value)) for (const v of value) headers.append(key, v);
+		else headers.set(key, value);
+	}
+	const method = req.method ?? "GET";
+	const hasBody = method !== "GET" && method !== "HEAD";
+	return new Request(url, {
+		method,
+		headers,
+		body: hasBody ? req : void 0,
+		duplex: hasBody ? "half" : void 0
+	});
+}
+async function writeResponse(response, res) {
+	const headers = {};
+	const setCookie = response.headers.getSetCookie?.() ?? [];
+	response.headers.forEach((value, key) => {
+		if (key === "set-cookie") return;
+		headers[key] = value;
+	});
+	if (setCookie.length > 0) headers["set-cookie"] = setCookie;
+	res.writeHead(response.status, headers);
+	if (!response.body) {
+		res.end();
+		return;
+	}
+	const reader = response.body.getReader();
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			if (!res.write(value)) await new Promise((resolve) => res.once("drain", resolve));
+		}
+		res.end();
+	} catch {
+		await reader.cancel().catch(() => {});
+		res.destroy();
+	}
+}
+var nodeAdapter = {
+	name: "node",
+	serve(fetch, options) {
+		const hostname = options.hostname ?? "localhost";
+		const server = createServer((req, res) => {
+			Promise.resolve().then(() => fetch(toWebRequest(req, options.port, hostname))).then((response) => writeResponse(response, res)).catch((err) => {
+				console.error(err);
+				if (!res.headersSent) res.writeHead(500, { "Content-Type": "text/plain" });
+				res.end("Internal Server Error");
+			});
+		});
+		if (options.idleTimeout !== void 0) {
+			server.timeout = options.idleTimeout * 1e3;
+			server.keepAliveTimeout = options.idleTimeout * 1e3;
+		}
+		return new Promise((resolve, reject) => {
+			server.once("error", reject);
+			server.listen(options.port, () => {
+				const address = server.address();
+				resolve({
+					port: typeof address === "object" && address ? address.port : options.port,
+					hostname,
+					stop: () => new Promise((res2, rej2) => {
+						server.closeAllConnections?.();
+						server.close((err) => err ? rej2(err) : res2());
+					})
+				});
+			});
+		});
+	}
+};
+//#endregion
+export { nodeAdapter as t };
+
+//# sourceMappingURL=node-DPTySdwG.js.map

package/.docu/lib/node-DPTySdwG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-DPTySdwG.js","names":[],"sources":["../node/runtime/node.ts"],"sourcesContent":["import { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport type { FetchHandler, RuntimeAdapter, ServerHandle, ServerOptions } from \"./types\";\n\nfunction toWebRequest(req: IncomingMessage, port: number, hostname: string): Request {\n  const host = req.headers.host ?? `${hostname}:${port}`;\n  const url = `http://${host}${req.url ?? \"/\"}`;\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n  const method = req.method ?? \"GET\";\n  const hasBody = method !== \"GET\" && method !== \"HEAD\";\n  return new Request(url, {\n    method,\n    headers,\n    // IncomingMessage is an async iterable of Buffer chunks; Request accepts\n    // an async iterable body when half-duplex is declared.\n    body: hasBody ? (req as unknown as BodyInit) : undefined,\n    // @ts-expect-error -- required by undici for streaming request bodies\n    duplex: hasBody ? \"half\" : undefined,\n  });\n}\n\nasync function writeResponse(response: Response, res: ServerResponse): Promise<void> {\n  const headers: Record<string, string | string[]> = {};\n  const setCookie = response.headers.getSetCookie?.() ?? [];\n  response.headers.forEach((value, key) => {\n    if (key === \"set-cookie\") return;\n    headers[key] = value;\n  });\n  if (setCookie.length > 0) headers[\"set-cookie\"] = setCookie;\n\n  // Flush headers immediately so streaming responses (SSE) reach the client\n  // before the first body chunk.\n  res.writeHead(response.status, headers);\n\n  if (!response.body) {\n    res.end();\n    return;\n  }\n\n  const reader = response.body.getReader();\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      // Incremental piping — never buffer the full body (SSE streams forever).\n      const ok = res.write(value);\n      if (!ok) await new Promise<void>((resolve) => res.once(\"drain\", resolve));\n    }\n    res.end();\n  } catch {\n    // Client disconnected mid-stream; cancel the source.\n    await reader.cancel().catch(() => {});\n    res.destroy();\n  }\n}\n\nexport const nodeAdapter: RuntimeAdapter = {\n  name: \"node\",\n\n  serve(fetch: FetchHandler, options: ServerOptions): Promise<ServerHandle> {\n    const hostname = options.hostname ?? \"localhost\";\n\n    const server = createServer((req, res) => {\n      Promise.resolve()\n        .then(() => fetch(toWebRequest(req, options.port, hostname)))\n        .then((response) => writeResponse(response, res))\n        .catch((err) => {\n          console.error(err);\n          if (!res.headersSent) {\n            res.writeHead(500, { \"Content-Type\": \"text/plain\" });\n          }\n          res.end(\"Internal Server Error\");\n        });\n    });\n\n    if (options.idleTimeout !== undefined) {\n      server.timeout = options.idleTimeout * 1000;\n      // keepAliveTimeout must not undercut idleTimeout or Node closes\n      // long-lived SSE connections early.\n      server.keepAliveTimeout = options.idleTimeout * 1000;\n    }\n\n    return new Promise((resolve, reject) => {\n      server.once(\"error\", reject);\n      server.listen(options.port, () => {\n        const address = server.address();\n        const port = typeof address === \"object\" && address ? address.port : options.port;\n        resolve({\n          port,\n          hostname,\n          stop: () =>\n            new Promise<void>((res2, rej2) => {\n              server.closeAllConnections?.();\n              server.close((err) => (err ? rej2(err) : res2()));\n            }),\n        });\n      });\n    });\n  },\n};\n"],"mappings":";;AAGA,SAAS,aAAa,KAAsB,MAAc,UAA2B;CAEnF,MAAM,MAAM,UADC,IAAI,QAAQ,QAAQ,GAAG,SAAS,GAAG,SACnB,IAAI,OAAO;CACxC,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,OAAO,GAAG;EACtD,IAAI,UAAU,KAAA,GAAW;EACzB,IAAI,MAAM,QAAQ,KAAK,GACrB,KAAK,MAAM,KAAK,OAAO,QAAQ,OAAO,KAAK,CAAC;OAE5C,QAAQ,IAAI,KAAK,KAAK;CAE1B;CACA,MAAM,SAAS,IAAI,UAAU;CAC7B,MAAM,UAAU,WAAW,SAAS,WAAW;CAC/C,OAAO,IAAI,QAAQ,KAAK;EACtB;EACA;EAGA,MAAM,UAAW,MAA8B,KAAA;EAE/C,QAAQ,UAAU,SAAS,KAAA;CAC7B,CAAC;AACH;AAEA,eAAe,cAAc,UAAoB,KAAoC;CACnF,MAAM,UAA6C,CAAC;CACpD,MAAM,YAAY,SAAS,QAAQ,eAAe,KAAK,CAAC;CACxD,SAAS,QAAQ,SAAS,OAAO,QAAQ;EACvC,IAAI,QAAQ,cAAc;EAC1B,QAAQ,OAAO;CACjB,CAAC;CACD,IAAI,UAAU,SAAS,GAAG,QAAQ,gBAAgB;CAIlD,IAAI,UAAU,SAAS,QAAQ,OAAO;CAEtC,IAAI,CAAC,SAAS,MAAM;EAClB,IAAI,IAAI;EACR;CACF;CAEA,MAAM,SAAS,SAAS,KAAK,UAAU;CACvC,IAAI;EACF,SAAS;GACP,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAC1C,IAAI,MAAM;GAGV,IAAI,CADO,IAAI,MAAM,KAChB,GAAI,MAAM,IAAI,SAAe,YAAY,IAAI,KAAK,SAAS,OAAO,CAAC;EAC1E;EACA,IAAI,IAAI;CACV,QAAQ;EAEN,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;EACpC,IAAI,QAAQ;CACd;AACF;AAEA,IAAa,cAA8B;CACzC,MAAM;CAEN,MAAM,OAAqB,SAA+C;EACxE,MAAM,WAAW,QAAQ,YAAY;EAErC,MAAM,SAAS,cAAc,KAAK,QAAQ;GACxC,QAAQ,QAAQ,CAAC,CACd,WAAW,MAAM,aAAa,KAAK,QAAQ,MAAM,QAAQ,CAAC,CAAC,CAAC,CAC5D,MAAM,aAAa,cAAc,UAAU,GAAG,CAAC,CAAC,CAChD,OAAO,QAAQ;IACd,QAAQ,MAAM,GAAG;IACjB,IAAI,CAAC,IAAI,aACP,IAAI,UAAU,KAAK,EAAE,gBAAgB,aAAa,CAAC;IAErD,IAAI,IAAI,uBAAuB;GACjC,CAAC;EACL,CAAC;EAED,IAAI,QAAQ,gBAAgB,KAAA,GAAW;GACrC,OAAO,UAAU,QAAQ,cAAc;GAGvC,OAAO,mBAAmB,QAAQ,cAAc;EAClD;EAEA,OAAO,IAAI,SAAS,SAAS,WAAW;GACtC,OAAO,KAAK,SAAS,MAAM;GAC3B,OAAO,OAAO,QAAQ,YAAY;IAChC,MAAM,UAAU,OAAO,QAAQ;IAE/B,QAAQ;KACN,MAFW,OAAO,YAAY,YAAY,UAAU,QAAQ,OAAO,QAAQ;KAG3E;KACA,YACE,IAAI,SAAe,MAAM,SAAS;MAChC,OAAO,sBAAsB;MAC7B,OAAO,OAAO,QAAS,MAAM,KAAK,GAAG,IAAI,KAAK,CAAE;KAClD,CAAC;IACL,CAAC;GACH,CAAC;EACH,CAAC;CACH;AACF"}

package/.docu/lib/paths-BtOIPBQ9.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { readdir, rm, unlink } from "node:fs/promises";
+//#region .docu/node/paths.ts
+/**
+* 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)
+*/
+var FRAMEWORK_ROOT = resolve(import.meta.dirname, "../..");
+var PROJECT_ROOT = process.cwd();
+join(FRAMEWORK_ROOT, ".docu/pages");
+var STYLES_DIR = join(FRAMEWORK_ROOT, ".docu/styles");
+var nodeDir = join(FRAMEWORK_ROOT, ".docu/node");
+var libDir = join(FRAMEWORK_ROOT, ".docu/lib");
+var LIB_DIR = existsSync(nodeDir) ? nodeDir : libDir;
+var DIST_DIR = join(PROJECT_ROOT, ".docu/dist");
+var ASSETS_DIR = join(DIST_DIR, "assets");
+var CACHE_FILE = join(PROJECT_ROOT, ".docu/build-cache.json");
+var DOCS_DIR = join(PROJECT_ROOT, "docs");
+var DOCS_ASSETS_DIR = join(PROJECT_ROOT, "docs/assets");
+var DOCU_CONFIG_PATH = join(PROJECT_ROOT, "docu.json");
+var _config = null;
+/** Clean stale client bundles from a previous build. */
+async function cleanOldBundles(preserve) {
+	try {
+		const files = await readdir(ASSETS_DIR);
+		for (const file of files) {
+			if (preserve?.has(file)) continue;
+			if (file.startsWith("client.") || file.startsWith("client-")) await unlink(join(ASSETS_DIR, file));
+		}
+	} catch (err) {
+		if (err.code !== "ENOENT") console.error("Failed to clean old bundles:", err.message);
+	}
+	try {
+		await rm(join(ASSETS_DIR, "chunks"), {
+			recursive: true,
+			force: true
+		});
+	} catch (err) {
+		if (err.code !== "ENOENT") console.warn("[flame] Failed to clean chunks dir:", err.message);
+	}
+}
+function loadDocuConfig() {
+	if (_config) return _config;
+	if (!existsSync(DOCU_CONFIG_PATH)) throw new Error(`docu.json not found at ${DOCU_CONFIG_PATH}`);
+	_config = JSON.parse(readFileSync(DOCU_CONFIG_PATH, "utf-8"));
+	return _config;
+}
+//#endregion
+export { DOCS_DIR as a, PROJECT_ROOT as c, loadDocuConfig as d, DOCS_ASSETS_DIR as i, STYLES_DIR as l, CACHE_FILE as n, FRAMEWORK_ROOT as o, DIST_DIR as r, LIB_DIR as s, ASSETS_DIR as t, cleanOldBundles as u };
+
+//# sourceMappingURL=paths-BtOIPBQ9.js.map

package/.docu/lib/paths-BtOIPBQ9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-BtOIPBQ9.js","names":[],"sources":["../node/paths.ts"],"sourcesContent":["import { resolve, join } from \"node:path\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { readdir, rm, unlink } from \"node:fs/promises\";\nimport type { DocuConfig } from \"./types\";\n\n/**\n * FRAMEWORK_ROOT: Where the package code lives (.docu/components, .docu/pages, .docu/styles, .docu/node)\n * PROJECT_ROOT: Where the user's project lives (docs/, docu.json)\n */\n\n// .docu/node/paths.ts → package root is 2 levels up\nexport const FRAMEWORK_ROOT = resolve(import.meta.dirname, \"../..\");\nexport const PROJECT_ROOT = process.cwd();\n\n// Framework paths (internal)\nexport const PAGES_DIR = join(FRAMEWORK_ROOT, \".docu/pages\");\nexport const STYLES_DIR = join(FRAMEWORK_ROOT, \".docu/styles\");\nconst nodeDir = join(FRAMEWORK_ROOT, \".docu/node\");\nconst libDir = join(FRAMEWORK_ROOT, \".docu/lib\");\nexport const LIB_DIR = existsSync(nodeDir) ? nodeDir : libDir;\n\n// Build output (user project)\nexport const DIST_DIR = join(PROJECT_ROOT, \".docu/dist\");\nexport const ASSETS_DIR = join(DIST_DIR, \"assets\");\nexport const CACHE_FILE = join(PROJECT_ROOT, \".docu/build-cache.json\");\n\n// Project paths (user content)\nexport const DOCS_DIR = join(PROJECT_ROOT, \"docs\");\nexport const DOCS_ASSETS_DIR = join(PROJECT_ROOT, \"docs/assets\");\nexport const DOCU_CONFIG_PATH = join(PROJECT_ROOT, \"docu.json\");\n\n// Config singleton\nlet _config: DocuConfig | null = null;\n\n/** Clean stale client bundles from a previous build. */\nexport async function cleanOldBundles(preserve?: Set<string>) {\n  try {\n    const files = await readdir(ASSETS_DIR);\n    for (const file of files) {\n      if (preserve?.has(file)) continue;\n      if (file.startsWith(\"client.\") || file.startsWith(\"client-\")) {\n        await unlink(join(ASSETS_DIR, file));\n      }\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      console.error(\"Failed to clean old bundles:\", (err as Error).message);\n    }\n  }\n  try {\n    await rm(join(ASSETS_DIR, \"chunks\"), { recursive: true, force: true });\n  } catch (err) {\n    // chunks dir may not exist, or permission error — log to avoid silent failure\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      console.warn(\"[flame] Failed to clean chunks dir:\", (err as Error).message);\n    }\n  }\n}\n\nexport function loadDocuConfig(): DocuConfig {\n  if (_config) return _config;\n  if (!existsSync(DOCU_CONFIG_PATH)) {\n    throw new Error(`docu.json not found at ${DOCU_CONFIG_PATH}`);\n  }\n  _config = JSON.parse(readFileSync(DOCU_CONFIG_PATH, \"utf-8\"));\n  return _config!;\n}\n"],"mappings":";;;;;;;;AAWA,IAAa,iBAAiB,QAAQ,YAAY,SAAS,OAAO;AAClE,IAAa,eAAe,QAAQ,IAAI;AAGf,KAAK,gBAAgB,aAAa;AAC3D,IAAa,aAAa,KAAK,gBAAgB,cAAc;AAC7D,IAAM,UAAU,KAAK,gBAAgB,YAAY;AACjD,IAAM,SAAS,KAAK,gBAAgB,WAAW;AAC/C,IAAa,UAAU,WAAW,OAAO,IAAI,UAAU;AAGvD,IAAa,WAAW,KAAK,cAAc,YAAY;AACvD,IAAa,aAAa,KAAK,UAAU,QAAQ;AACjD,IAAa,aAAa,KAAK,cAAc,wBAAwB;AAGrE,IAAa,WAAW,KAAK,cAAc,MAAM;AACjD,IAAa,kBAAkB,KAAK,cAAc,aAAa;AAC/D,IAAa,mBAAmB,KAAK,cAAc,WAAW;AAG9D,IAAI,UAA6B;;AAGjC,eAAsB,gBAAgB,UAAwB;CAC5D,IAAI;EACF,MAAM,QAAQ,MAAM,QAAQ,UAAU;EACtC,KAAK,MAAM,QAAQ,OAAO;GACxB,IAAI,UAAU,IAAI,IAAI,GAAG;GACzB,IAAI,KAAK,WAAW,SAAS,KAAK,KAAK,WAAW,SAAS,GACzD,MAAM,OAAO,KAAK,YAAY,IAAI,CAAC;EAEvC;CACF,SAAS,KAAK;EACZ,IAAK,IAA8B,SAAS,UAC1C,QAAQ,MAAM,gCAAiC,IAAc,OAAO;CAExE;CACA,IAAI;EACF,MAAM,GAAG,KAAK,YAAY,QAAQ,GAAG;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;CACvE,SAAS,KAAK;EAEZ,IAAK,IAA8B,SAAS,UAC1C,QAAQ,KAAK,uCAAwC,IAAc,OAAO;CAE9E;AACF;AAEA,SAAgB,iBAA6B;CAC3C,IAAI,SAAS,OAAO;CACpB,IAAI,CAAC,WAAW,gBAAgB,GAC9B,MAAM,IAAI,MAAM,0BAA0B,kBAAkB;CAE9D,UAAU,KAAK,MAAM,aAAa,kBAAkB,OAAO,CAAC;CAC5D,OAAO;AACT"}

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

@@ -1,12 +1,8 @@
-import {
-  runPreview
-} from "./chunk-JMQI3FKV.js";
-import {
-  denoAdapter
-} from "./chunk-UISOJ4RW.js";
-import "./chunk-EOK6KATZ.js";
-import "./chunk-IVM5UM44.js";
-import "./chunk-4IQXHHPF.js";
-
-// .docu/node/preview.deno.ts
+import { t as denoAdapter } from "./deno-DmEaKggj.js";
+import { t as runPreview } from "./preview.impl-CXJS2tQS.js";
+//#region .docu/node/preview.deno.ts
 await runPreview(denoAdapter);
+//#endregion
+export {};
+
+//# sourceMappingURL=preview.deno.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview.deno.js","names":[],"sources":["../node/preview.deno.ts"],"sourcesContent":["import { denoAdapter } from \"./runtime\";\nimport { runPreview } from \"./preview.impl\";\n\nawait runPreview(denoAdapter);\n"],"mappings":";;;AAGA,MAAM,WAAW,WAAW"}

package/.docu/lib/preview.impl-CXJS2tQS.js

@@ -0,0 +1,77 @@
+import { r as DIST_DIR } from "./paths-BtOIPBQ9.js";
+import { c as SECURITY_HEADERS, f as injectNonce, i as getContentType, l as cspHeader, u as generateNonce } from "./utils-DA17MyQG.js";
+import { t as logger } from "./logger-CycvLCrQ.js";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { readFile } from "node:fs/promises";
+//#region .docu/node/preview.impl.ts
+/**
+* Runtime-neutral preview server — mirror of `preview.ts` (Bun-only,
+* protected) driven by a `RuntimeAdapter` and `node:fs` file reads.
+*/
+function resolveFile(pathname) {
+	const path = pathname.slice(1);
+	const isWithinDist = (p) => p === DIST_DIR || p.startsWith(DIST_DIR + "/");
+	if (!path.includes(".")) {
+		const withIndex = resolve(DIST_DIR, path, "index.html");
+		if (isWithinDist(withIndex) && existsSync(withIndex)) return withIndex;
+		const withHtml = resolve(DIST_DIR, path + ".html");
+		if (isWithinDist(withHtml) && existsSync(withHtml)) return withHtml;
+	}
+	const exact = resolve(DIST_DIR, path);
+	if (!isWithinDist(exact)) return null;
+	try {
+		if (statSync(exact).isFile()) return exact;
+	} catch (err) {
+		if (err.code !== "ENOENT") throw err;
+	}
+	return null;
+}
+async function runPreview(adapter) {
+	const PORT = parseInt(process.env.PORT || "4173", 10);
+	logger.buildStart();
+	if (!existsSync(DIST_DIR)) {
+		logger.spinner.start("Checking build output...");
+		logger.spinner.info("dist not found. Run \x1B[1mflame build\x1B[0m first.");
+		process.exit(0);
+	}
+	const notFoundPath = resolve(DIST_DIR, "404.html");
+	const handle = await adapter.serve(async (req) => {
+		const url = new URL(req.url);
+		const filePath = resolveFile(decodeURIComponent(url.pathname));
+		if (filePath) {
+			const contentType = getContentType(filePath);
+			if (contentType === "text/html") {
+				const nonce = generateNonce();
+				const html = await readFile(filePath, "utf-8");
+				const modified = injectNonce(html, nonce);
+				return new Response(modified, { headers: {
+					"Content-Type": "text/html",
+					...SECURITY_HEADERS,
+					"Content-Security-Policy": cspHeader(nonce)
+				} });
+			}
+			return new Response(readFileSync(filePath), { headers: { "Content-Type": contentType } });
+		}
+		if (existsSync(notFoundPath)) {
+			const nonce = generateNonce();
+			const html = await readFile(notFoundPath, "utf-8");
+			const modified = injectNonce(html, nonce);
+			return new Response(modified, {
+				status: 404,
+				headers: {
+					"Content-Type": "text/html",
+					...SECURITY_HEADERS,
+					"Content-Security-Policy": cspHeader(nonce)
+				}
+			});
+		}
+		return new Response("404 - Not Found", { status: 404 });
+	}, { port: PORT });
+	logger.ready(handle.port);
+	return handle;
+}
+//#endregion
+export { runPreview as t };
+
+//# sourceMappingURL=preview.impl-CXJS2tQS.js.map

package/.docu/lib/preview.impl-CXJS2tQS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.impl-CXJS2tQS.js","names":[],"sources":["../node/preview.impl.ts"],"sourcesContent":["/**\n * Runtime-neutral preview server — mirror of `preview.ts` (Bun-only,\n * protected) driven by a `RuntimeAdapter` and `node:fs` file reads.\n */\n\nimport { existsSync, statSync, readFileSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { RuntimeAdapter, ServerHandle } from \"./runtime\";\nimport { logger } from \"./logger\";\nimport { DIST_DIR } from \"./paths\";\nimport { getContentType } from \"./utils\";\nimport { SECURITY_HEADERS, generateNonce, cspHeader, injectNonce } from \"./security\";\n\nfunction resolveFile(pathname: string): string | null {\n  const path = pathname.slice(1);\n  const isWithinDist = (p: string) => p === DIST_DIR || p.startsWith(DIST_DIR + \"/\");\n\n  if (!path.includes(\".\")) {\n    const withIndex = resolve(DIST_DIR, path, \"index.html\");\n    if (isWithinDist(withIndex) && existsSync(withIndex)) return withIndex;\n    const withHtml = resolve(DIST_DIR, path + \".html\");\n    if (isWithinDist(withHtml) && existsSync(withHtml)) return withHtml;\n  }\n\n  const exact = resolve(DIST_DIR, path);\n  if (!isWithinDist(exact)) return null;\n  try {\n    if (statSync(exact).isFile()) return exact;\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n  }\n  return null;\n}\n\nexport async function runPreview(adapter: RuntimeAdapter): Promise<ServerHandle | null> {\n  const PORT = parseInt(process.env.PORT || \"4173\", 10);\n\n  logger.buildStart();\n\n  if (!existsSync(DIST_DIR)) {\n    logger.spinner.start(\"Checking build output...\");\n    logger.spinner.info(\"dist not found. Run \\x1b[1mflame build\\x1b[0m first.\");\n    process.exit(0);\n  }\n\n  const notFoundPath = resolve(DIST_DIR, \"404.html\");\n\n  const handle = await adapter.serve(\n    async (req) => {\n      const url = new URL(req.url);\n      const pathname = decodeURIComponent(url.pathname);\n\n      const filePath = resolveFile(pathname);\n\n      if (filePath) {\n        const contentType = getContentType(filePath);\n        if (contentType === \"text/html\") {\n          const nonce = generateNonce();\n          const html = await readFile(filePath, \"utf-8\");\n          const modified = injectNonce(html, nonce);\n          return new Response(modified, {\n            headers: {\n              \"Content-Type\": \"text/html\",\n              ...SECURITY_HEADERS,\n              \"Content-Security-Policy\": cspHeader(nonce),\n            },\n          });\n        }\n        return new Response(readFileSync(filePath), {\n          headers: { \"Content-Type\": contentType },\n        });\n      }\n\n      if (existsSync(notFoundPath)) {\n        const nonce = generateNonce();\n        const html = await readFile(notFoundPath, \"utf-8\");\n        const modified = injectNonce(html, nonce);\n        return new Response(modified, {\n          status: 404,\n          headers: {\n            \"Content-Type\": \"text/html\",\n            ...SECURITY_HEADERS,\n            \"Content-Security-Policy\": cspHeader(nonce),\n          },\n        });\n      }\n\n      return new Response(\"404 - Not Found\", { status: 404 });\n    },\n    { port: PORT }\n  );\n\n  logger.ready(handle.port);\n  return handle;\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAS,YAAY,UAAiC;CACpD,MAAM,OAAO,SAAS,MAAM,CAAC;CAC7B,MAAM,gBAAgB,MAAc,MAAM,YAAY,EAAE,WAAW,WAAW,GAAG;CAEjF,IAAI,CAAC,KAAK,SAAS,GAAG,GAAG;EACvB,MAAM,YAAY,QAAQ,UAAU,MAAM,YAAY;EACtD,IAAI,aAAa,SAAS,KAAK,WAAW,SAAS,GAAG,OAAO;EAC7D,MAAM,WAAW,QAAQ,UAAU,OAAO,OAAO;EACjD,IAAI,aAAa,QAAQ,KAAK,WAAW,QAAQ,GAAG,OAAO;CAC7D;CAEA,MAAM,QAAQ,QAAQ,UAAU,IAAI;CACpC,IAAI,CAAC,aAAa,KAAK,GAAG,OAAO;CACjC,IAAI;EACF,IAAI,SAAS,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO;CACvC,SAAS,KAAK;EACZ,IAAK,IAA8B,SAAS,UAAU,MAAM;CAC9D;CACA,OAAO;AACT;AAEA,eAAsB,WAAW,SAAuD;CACtF,MAAM,OAAO,SAAS,QAAQ,IAAI,QAAQ,QAAQ,EAAE;CAEpD,OAAO,WAAW;CAElB,IAAI,CAAC,WAAW,QAAQ,GAAG;EACzB,OAAO,QAAQ,MAAM,0BAA0B;EAC/C,OAAO,QAAQ,KAAK,sDAAsD;EAC1E,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,eAAe,QAAQ,UAAU,UAAU;CAEjD,MAAM,SAAS,MAAM,QAAQ,MAC3B,OAAO,QAAQ;EACb,MAAM,MAAM,IAAI,IAAI,IAAI,GAAG;EAG3B,MAAM,WAAW,YAFA,mBAAmB,IAAI,QAEX,CAAQ;EAErC,IAAI,UAAU;GACZ,MAAM,cAAc,eAAe,QAAQ;GAC3C,IAAI,gBAAgB,aAAa;IAC/B,MAAM,QAAQ,cAAc;IAC5B,MAAM,OAAO,MAAM,SAAS,UAAU,OAAO;IAC7C,MAAM,WAAW,YAAY,MAAM,KAAK;IACxC,OAAO,IAAI,SAAS,UAAU,EAC5B,SAAS;KACP,gBAAgB;KAChB,GAAG;KACH,2BAA2B,UAAU,KAAK;IAC5C,EACF,CAAC;GACH;GACA,OAAO,IAAI,SAAS,aAAa,QAAQ,GAAG,EAC1C,SAAS,EAAE,gBAAgB,YAAY,EACzC,CAAC;EACH;EAEA,IAAI,WAAW,YAAY,GAAG;GAC5B,MAAM,QAAQ,cAAc;GAC5B,MAAM,OAAO,MAAM,SAAS,cAAc,OAAO;GACjD,MAAM,WAAW,YAAY,MAAM,KAAK;GACxC,OAAO,IAAI,SAAS,UAAU;IAC5B,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,GAAG;KACH,2BAA2B,UAAU,KAAK;IAC5C;GACF,CAAC;EACH;EAEA,OAAO,IAAI,SAAS,mBAAmB,EAAE,QAAQ,IAAI,CAAC;CACxD,GACA,EAAE,MAAM,KAAK,CACf;CAEA,OAAO,MAAM,OAAO,IAAI;CACxB,OAAO;AACT"}

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

@@ -1,12 +1,8 @@
-import {
-  runPreview
-} from "./chunk-JMQI3FKV.js";
-import {
-  nodeAdapter
-} from "./chunk-UISOJ4RW.js";
-import "./chunk-EOK6KATZ.js";
-import "./chunk-IVM5UM44.js";
-import "./chunk-4IQXHHPF.js";
-
-// .docu/node/preview.node.ts
+import { t as nodeAdapter } from "./node-DPTySdwG.js";
+import { t as runPreview } from "./preview.impl-CXJS2tQS.js";
+//#region .docu/node/preview.node.ts
 await runPreview(nodeAdapter);
+//#endregion
+export {};
+
+//# sourceMappingURL=preview.node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview.node.js","names":[],"sources":["../node/preview.node.ts"],"sourcesContent":["import { nodeAdapter } from \"./runtime\";\nimport { runPreview } from \"./preview.impl\";\n\nawait runPreview(nodeAdapter);\n"],"mappings":";;;AAGA,MAAM,WAAW,WAAW"}