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

package/.docu/lib/{html.shared-DSn-7_6t.js → html.shared-WwQnhDty.js}

@@ -1,14 +1,14 @@
-import { a as DOCS_DIR, c as PROJECT_ROOT, d as loadDocuConfig, l as STYLES_DIR, o as FRAMEWORK_ROOT, s as LIB_DIR, t as ASSETS_DIR, u as cleanOldBundles } from "./paths-BtOIPBQ9.js";
-import { a as isExternalUrl, h as normalizeImporterPath, n as docsHtmlHref, o as scanMdxFiles, r as formatDate2, t as cn } from "./utils-DA17MyQG.js";
+import { a as DOCS_DIR, c as PROJECT_ROOT, d as loadDocuConfig, f as resolveProjectFile, l as STYLES_DIR, o as FRAMEWORK_ROOT, s as LIB_DIR, t as ASSETS_DIR, u as cleanOldBundles } from "./paths-Bl2cdp9E.js";
+import { c as scanMdxFiles, f as cspMeta, i as formatDate2, n as cn, o as isExternalUrl, r as docsHtmlHref, v as normalizeImporterPath } from "./utils-B_CoyKie.js";
 import { builtinModules, createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
-import { mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
+import { mkdir, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { createHash } from "node:crypto";
 import { build } from "vite";
 import { generateThemeCss, presetRegistry, resolveTheme } from "@docubook/themes-colors";
+import { createHash } from "node:crypto";
 import React, { createContext, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { z } from "zod";
 import { MDXRemote, createDefaultRehypePlugins, createDefaultRemarkPlugins, extractFrontmatter, extractFrontmatterWithContent, extractTocsFromRawMdx, serialize } from "@docubook/core";
@@ -402,6 +402,8 @@ var BuildPluginBuilder = class {
 	* Execute the transformHtml chain in pipeline pattern.
 	* Each callback receives the **previous** callback's return value (or the
 	* original HTML for the first). Every callback **must** return a string.
+	* Callbacks returning a non-string (e.g. `undefined`) are skipped with a
+	* warning — the current HTML passes through unchanged for that step.
 	* Errors inside individual callbacks are caught and logged — the current
 	* HTML passes through unchanged for that step.
 	*
@@ -412,7 +414,9 @@ var BuildPluginBuilder = class {
 	async runTransformHtmlChain(html, context) {
 		let result = html;
 		for (let i = 0; i < this._transformHtml.length; i++) try {
-			result = await this._transformHtml[i](result, context);
+			const next = await this._transformHtml[i](result, context);
+			if (typeof next === "string") result = next;
+			else console.warn(`[plugin] transformHtml callback #${i + 1} returned invalid type (expected a string), keeping previous HTML`);
 		} catch (err) {
 			console.error(`[plugin] transformHtml callback #${i + 1} error: ${err instanceof Error ? err.message : String(err)}`);
 		}
@@ -464,6 +468,230 @@ var BuildPluginBuilder = class {
 		else console.warn(`[plugin] ${hookName} callback returned unexpected type (got ${typeof result}), expected string or string[], skipping`);
 	}
 };
+/** Toolchain fingerprint: Bun version on Bun, Deno version on Deno, Node elsewhere. */
+function runtimeStamp() {
+	const g = globalThis;
+	const bun = g.Bun;
+	if (typeof bun?.version === "string" && bun.version.length > 0) return `bun-${bun.version}`;
+	const deno = g.Deno;
+	if (typeof deno?.version?.deno === "string" && deno.version.deno.length > 0) return `deno-${deno.version.deno}`;
+	const proc = g.process;
+	if (typeof proc?.version === "string" && proc.version.length > 0) return `node-${proc.version}`;
+	return "node-unknown";
+}
+/**
+* True when a CSS file can change Tailwind v4 output.
+* v4 is CSS-first: `@theme`, `@source`, `@plugin`, `@custom-variant`,
+* `@utility`, `@config`, `@apply`/`@variant`, and `@import "tailwindcss"`
+* all live in CSS. Plain CSS without these cannot affect the CLI output,
+* so it is excluded to avoid false cache busts. Broad match deliberate:
+* false positive busts safe, false negative serves stale CSS.
+*/
+function isTailwindRelevantCss(content) {
+	return content.includes("@theme") || content.includes("@source") || content.includes("@plugin") || content.includes("@custom-variant") || content.includes("@utility") || content.includes("@config") || content.includes("@apply") || content.includes("@variant") || content.includes("@layer") || content.includes("tailwindcss");
+}
+var IMPORT_RE = /@import\s+(?:url\()?["']([^"']+)["']/g;
+var MAX_IMPORT_DEPTH = 10;
+/** Resolve `./` + `../` imports only — bare specifiers are version-pinned deps. */
+function resolveRelativeImport(spec, fromDir) {
+	if (!spec.startsWith(".")) return void 0;
+	const clean = spec.split("?")[0].split("#")[0];
+	if (clean.length === 0) return void 0;
+	return join(fromDir, clean);
+}
+/**
+* Read a CSS file plus transitively imported relative files.
+* Non-relevant files contribute "" themselves, but their imports are still
+* followed (nested file may carry `@theme`). `visited` breaks import cycles.
+* Missing/unreadable files resolve to "" — never throws.
+*/
+function readCssWithImports(path, visited, depth = 0) {
+	if (depth > MAX_IMPORT_DEPTH || visited.has(path)) return "";
+	visited.add(path);
+	let content = "";
+	try {
+		if (!existsSync(path)) return "";
+		content = readFileSync(path, "utf-8");
+	} catch {
+		return "";
+	}
+	let out = isTailwindRelevantCss(content) ? content : "";
+	try {
+		const dir = join(path, "..");
+		for (const m of content.matchAll(IMPORT_RE)) {
+			const resolved = resolveRelativeImport(m[1] ?? "", dir);
+			if (resolved) out += readCssWithImports(resolved, visited, depth + 1);
+		}
+	} catch {}
+	return out;
+}
+function scanCssDir(dir, visited) {
+	let out = "";
+	try {
+		const entries = readdirSync(dir, { withFileTypes: true });
+		for (const e of entries) {
+			const full = join(dir, e.name);
+			if (e.isDirectory()) {
+				if (e.name === "assets" || e.name.startsWith(".") || e.name === "node_modules") continue;
+				out += scanCssDir(full, visited);
+			} else if (e.name.endsWith(".css")) out += readCssWithImports(full, visited);
+		}
+	} catch {}
+	return out;
+}
+function scanRootCss(root, visited) {
+	let out = "";
+	try {
+		const entries = readdirSync(root, { withFileTypes: true });
+		for (const e of entries) if (e.isFile() && e.name.endsWith(".css")) out += readCssWithImports(join(root, e.name), visited);
+	} catch {}
+	return out;
+}
+/** Hash @theme/@source/@plugin-bearing CSS in project docs/ + root *.css. */
+function tailwindCssThemeInputs(root) {
+	const visited = /* @__PURE__ */ new Set();
+	return scanCssDir(join(root, "docs"), visited) + scanRootCss(root, visited);
+}
+var TAILWIND_CONFIG_FILES = [
+	"tailwind.config.ts",
+	"tailwind.config.js",
+	"tailwind.config.mjs",
+	"tailwind.config.cjs",
+	"tailwind.config.mts",
+	"tailwind.config.cts",
+	"postcss.config.js",
+	"postcss.config.mjs",
+	"postcss.config.cjs"
+];
+/**
+* JS config still affects v4 when referenced via `@config`
+* (plus PostCSS pipeline config). Content hashed when present.
+*/
+function tailwindJsConfigInputs(root) {
+	let out = "";
+	for (const name of TAILWIND_CONFIG_FILES) try {
+		const p = join(root, name);
+		if (existsSync(p)) out += readFileSync(p, "utf-8") + "\0";
+	} catch {}
+	return out;
+}
+function readInstalledVersion(pkg, roots) {
+	for (const root of roots) try {
+		const p = join(root, "node_modules", ...pkg.split("/"), "package.json");
+		if (existsSync(p)) {
+			const parsed = JSON.parse(readFileSync(p, "utf-8"));
+			if (typeof parsed.version === "string" && parsed.version.length > 0) return parsed.version;
+		}
+	} catch {}
+	return "";
+}
+/** Pin resolved CSS-affecting deps into the key (installed version wins). */
+function tailwindVersionPins(root) {
+	const names = [
+		"tailwindcss",
+		"@tailwindcss/cli",
+		"@tailwindcss/typography",
+		"daisyui"
+	];
+	let extra = "";
+	const roots = [root, FRAMEWORK_ROOT];
+	for (const name of names) {
+		const installed = readInstalledVersion(name, roots);
+		if (installed) extra += `${name}@${installed}\0`;
+	}
+	try {
+		const pkgPath = join(root, "package.json");
+		if (existsSync(pkgPath)) {
+			const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+			for (const name of names) {
+				const range = pkg.dependencies?.[name] ?? pkg.devDependencies?.[name] ?? "";
+				if (range) extra += `${name}:${range}\0`;
+			}
+		}
+	} catch {}
+	return extra;
+}
+/**
+* Extra Tailwind inputs beyond globals.css + theme.
+* v4 is CSS-first: user overrides live in `@theme`/`@source`/`@plugin`
+* blocks inside CSS files under the project root (e.g. docs slash star dot css),
+* plus JS config referenced via `@config` and installed plugin versions.
+* Missing files resolve to "" — never throws.
+*/
+function tailwindExtraInputs(root = resolveProjectFile()) {
+	return tailwindCssThemeInputs(root) + "\0" + tailwindJsConfigInputs(root) + tailwindVersionPins(root);
+}
+/**
+* Shared Tailwind cache key: globals.css + theme + tailwind config +
+* toolchain version. Used by both hydrate.ts (Bun) and hydrate.node.ts
+* (Vite) so the two runtimes agree on filenames. Segments joined with NUL
+* so `("ab","c")` and `("a","bc")` hash differently.
+*/
+function computeTailwindCacheKey(globals, themeSuffix, projectRoot = resolveProjectFile()) {
+	const h = createHash("sha256");
+	h.update(globals);
+	h.update("\0");
+	h.update(themeSuffix);
+	h.update("\0");
+	h.update(tailwindExtraInputs(projectRoot));
+	h.update("\0");
+	h.update(runtimeStamp());
+	h.update("\0");
+	h.update(`v4`);
+	return h.digest("hex").slice(0, 16);
+}
+/** Read globals.css content ("" when missing). Shared by both hydrators. */
+function readGlobalsCss() {
+	const globalsPath = join(STYLES_DIR, "globals.css");
+	return existsSync(globalsPath) ? readFileSync(globalsPath, "utf-8") : "";
+}
+/**
+* Atomic file write: tmp + rename so a crash mid-write never leaves a
+* half-written cache/CSS behind. Tmp name includes pid so parallel
+* builds (`bun run --parallel`) do not clobber each other.
+*/
+async function atomicWriteFile(writeFile, rename, unlink, target, data) {
+	const proc = globalThis.process;
+	const tmp = `${target}.tmp-${typeof proc?.pid === "number" ? proc.pid : Math.floor(Math.random() * 1e9)}-${Date.now()}`;
+	try {
+		await writeFile(tmp, data);
+		await rename(tmp, target);
+	} catch (err) {
+		try {
+			await unlink(tmp);
+		} catch {}
+		throw err;
+	}
+}
+/** Wire memory-pressure hook once: OS low-memory → drop parsed page maps. */
+var memoryPressureHooked = false;
+function hookMemoryPressure(clear) {
+	if (memoryPressureHooked) return;
+	memoryPressureHooked = true;
+	try {
+		globalThis.process?.on?.("memoryPressure", () => {
+			try {
+				clear();
+			} catch {}
+		});
+	} catch {}
+}
+/**
+* Hash of compiled MDX module sources (sorted keys + content).
+* Used to skip the JS bundle rebuild when no page content changed.
+*/
+function hashMdxSources(mdxSources) {
+	const h = createHash("sha256");
+	const slugs = Object.keys(mdxSources).sort();
+	h.update(`v4:${runtimeStamp()}:`);
+	for (const slug of slugs) {
+		h.update(slug);
+		h.update("\0");
+		h.update(mdxSources[slug]);
+		h.update("\0");
+	}
+	return h.digest("hex").slice(0, 16);
+}
 //#endregion
 //#region .docu/node/fs-scanner.ts
 function toTitleCase$1(str) {
@@ -652,16 +880,15 @@ function resolveTailwindBin() {
 	const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin.tailwindcss;
 	return join(dirname(pkgPath), binRel);
 }
-/** Compute a cache key from globals.css + theme config content. */
+/** Compute a cache key from globals.css + theme + config + toolchain. */
 function tailwindCacheKey() {
-	const globalsPath = join(STYLES_DIR, "globals.css");
-	const globalsContent = existsSync(globalsPath) ? readFileSync(globalsPath, "utf-8") : "";
+	const globalsContent = readGlobalsCss();
 	let themeSuffix = "";
 	try {
 		const themeColors = getThemeConfig();
 		if (themeColors) themeSuffix = JSON.stringify(themeColors);
 	} catch {}
-	return createHash("sha256").update(globalsContent + themeSuffix).digest("hex").slice(0, 16);
+	return computeTailwindCacheKey(globalsContent, themeSuffix);
 }
 /**
 * Build Tailwind CSS with content-based caching.
@@ -697,7 +924,7 @@ async function buildTailwindCss(key) {
 		throw new Error(`Tailwind CSS build failed:\n${stderr}`, { cause: err });
 	}
 	let cssContent = await readFile(tmpCss, "utf-8");
-	await unlink(tmpCss);
+	await unlink(tmpCss).catch(() => {});
 	try {
 		const themeColors = getThemeConfig();
 		if (themeColors) cssContent = buildThemeCss(cssContent, themeColors);
@@ -706,7 +933,7 @@ async function buildTailwindCss(key) {
 	}
 	const cssFile = `client-${key}.css`;
 	const outPath = join(ASSETS_DIR, cssFile);
-	if (!existsSync(outPath)) await writeFile(outPath, cssContent);
+	if (!existsSync(outPath)) await atomicWriteFile(writeFile, rename, unlink, outPath, cssContent);
 	return {
 		file: cssFile,
 		content: cssContent
@@ -1053,7 +1280,7 @@ function frontmatterField(frontmatter, key) {
 * (defaults + .html link fixes + user plugins) and runs `serialize()`.
 */
 async function serializeWithDocPlugins(rawMdx, opts = {}, pre) {
-	const { strippedContent, frontmatter } = pre ?? extractFrontmatterWithContent(rawMdx, opts.frontmatterSchema);
+	const { strippedContent, frontmatter } = pre ?? (opts.frontmatterSchema ? extractFrontmatterWithContent(rawMdx, opts.frontmatterSchema) : extractFrontmatterWithContent(rawMdx));
 	const defaultRemark = createDefaultRemarkPlugins();
 	const defaultRehype = createDefaultRehypePlugins();
 	const finalRemark = [
@@ -1091,7 +1318,7 @@ async function serializeWithDocPlugins(rawMdx, opts = {}, pre) {
 */
 async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugins, frontmatterSchema, pre) {
 	const tocs = extractTocsFromRawMdx(rawMdx);
-	const frontmatter = pre?.frontmatter ?? extractFrontmatterWithContent(rawMdx, frontmatterSchema).frontmatter;
+	const frontmatter = pre?.frontmatter ?? (frontmatterSchema ? extractFrontmatterWithContent(rawMdx, frontmatterSchema).frontmatter : extractFrontmatterWithContent(rawMdx).frontmatter);
 	const serialized = await serializeWithDocPlugins(rawMdx, {
 		remarkPlugins,
 		rehypePlugins,
@@ -1159,6 +1386,12 @@ function registerPageContent(href, raw) {
 function getPageContent(href) {
 	return pageContent.get(href);
 }
+/** Drop derived page maps under OS memory pressure (Bun 1.4 `memoryPressure`). */
+function clearDerivedPageCaches() {
+	pageContent.clear();
+	pageStripped.clear();
+	pageFrontmatter.clear();
+}
 async function compileMdxModule(rawMdx, remarkPlugins, rehypePlugins, href) {
 	const serialized = await serializeWithDocPlugins(rawMdx, {
 		outputFormat: "program",
@@ -1367,6 +1600,21 @@ function getRouteMap() {
 	return map;
 }
 /**
+* Single pagination entry builder (DRY) — one `readPageFrontmatter` call
+* serves both prev + next from the parse-once registry, so no file is
+* re-read or re-parsed. `description` rides along on prev too; the UI
+* keeps the paired prev minimal by design and only renders the rich
+* title + description when prev stands alone (last page, no next).
+*/
+function toPaginationEntry(href, routeMap) {
+	const fm = readPageFrontmatter(href);
+	return {
+		href,
+		title: fm.title || routeMap.get(href) || "",
+		description: fm.description || ""
+	};
+}
+/**
 * Frontmatter for a page — read from the parse-once registry (populated
 * during compilation) instead of re-reading + re-parsing the file. Falls
 * back to a direct read only for pages the dev server has not compiled yet,
@@ -1397,14 +1645,9 @@ function getPreviousNext(pathname) {
 			prev: null,
 			next: null
 		};
-		const fm = readPageFrontmatter(first);
 		return {
 			prev: null,
-			next: {
-				href: first,
-				title: fm.title || routeMap.get(first) || "",
-				description: fm.description || ""
-			}
+			next: toPaginationEntry(first, routeMap)
 		};
 	}
 	const paths = flattenRoutes();
@@ -1416,18 +1659,9 @@ function getPreviousNext(pathname) {
 	const routeMap = getRouteMap();
 	const prevHref = index > 0 ? paths[index - 1] : null;
 	const nextHref = index < paths.length - 1 ? paths[index + 1] : null;
-	const prevFm = prevHref ? readPageFrontmatter(prevHref) : null;
-	const nextFm = nextHref ? readPageFrontmatter(nextHref) : null;
 	return {
-		prev: prevHref ? {
-			href: prevHref,
-			title: prevFm?.title || routeMap.get(prevHref) || ""
-		} : null,
-		next: nextHref ? {
-			href: nextHref,
-			title: nextFm?.title || routeMap.get(nextHref) || "",
-			description: nextFm?.description || ""
-		} : null
+		prev: prevHref ? toPaginationEntry(prevHref, routeMap) : null,
+		next: nextHref ? toPaginationEntry(nextHref, routeMap) : null
 	};
 }
 //#endregion
@@ -1438,7 +1672,8 @@ function Pagination({ pathname, className, prevIcon, nextIcon, linkClassName })
 	return /* @__PURE__ */ jsx(PaginationDocs, {
 		prev: prev ? {
 			href: docsHtmlHref(`/docs${prev.href}`),
-			title: prev.title
+			title: prev.title,
+			description: prev.description
 		} : void 0,
 		next: next ? {
 			href: docsHtmlHref(`/docs${next.href}`),
@@ -2417,7 +2652,7 @@ function htmlShell(opts) {
   ${favicon ? `<link rel="icon" type="image/x-icon" href="${escapeHtml(resolvePath(favicon))}">` : ""}${themeStyle}
   <link rel="preload" href="${escapeHtml(assetPrefix + css)}" as="style">
   <link rel="stylesheet" href="${escapeHtml(assetPrefix + css)}">
-  ${csp ? `<meta http-equiv="Content-Security-Policy" content="${escapeHtml(csp)}">` : ""}
+  ${csp ? `<meta http-equiv="Content-Security-Policy" content="${escapeHtml(cspMeta(csp))}">` : ""}
   ${seoTags}
   <script${nonceAttr}>try{if(localStorage.getItem("theme")==="dark")document.documentElement.classList.add("dark")}catch(e){}<\/script>${headInjection}
 </head>
@@ -2462,6 +2697,6 @@ function hmrScript(nonce) {
 <\/script>`;
 }
 //#endregion
-export { loadPlugins as S, registerPageContent as _, IndexPage as a, computeInlineThemeCss as b, captureException as c, compileMdx as d, compileMdxModule as f, getPageStripped as g, getPageFrontmatter as h, DocsLayout as i, initSentry as l, getPageContent as m, hmrScript as n, NotFoundPage as o, frontmatterField as p, htmlShell as r, DocsPage as s, errorHtml as t, generateSearchIndex as u, getGitLastModifiedBatch as v, BuildPluginBuilder as x, buildClientBundle as y };
+export { hashMdxSources as C, loadPlugins as D, BuildPluginBuilder as E, atomicWriteFile as S, runtimeStamp as T, getPageStripped as _, IndexPage as a, buildClientBundle as b, captureException as c, clearDerivedPageCaches as d, compileMdx as f, getPageFrontmatter as g, getPageContent as h, DocsLayout as i, initSentry as l, frontmatterField as m, hmrScript as n, NotFoundPage as o, compileMdxModule as p, htmlShell as r, DocsPage as s, errorHtml as t, generateSearchIndex as u, registerPageContent as v, hookMemoryPressure as w, computeInlineThemeCss as x, getGitLastModifiedBatch as y };
 
-//# sourceMappingURL=html.shared-DSn-7_6t.js.map
+//# sourceMappingURL=html.shared-WwQnhDty.js.map