kitfly 0.2.1 → 0.2.4

package/scripts/build.ts

@@ -5,6 +5,7 @@
  *
  * Options:
  *   -o, --out <dir>   Output directory [env: KITFLY_BUILD_OUT] [default: dist]
+ *   --profile <name>  Active content profile [env: KITFLY_PROFILE]
  *   --raw             Include raw markdown files [env: KITFLY_BUILD_RAW] [default: true]
  *   --no-raw          Don't include raw markdown files
  *   --help            Show help message
@@ -20,13 +21,15 @@ import { loadPluginInjections, type PluginInjections } from "../src/plugin-loade
 import {
 	buildBreadcrumbsStatic,
 	buildFooter,
+	buildLogoImgHtml,
 	buildNavStatic,
 	buildPageMeta,
-	buildSlideNav,
+	buildSlideNavHierarchical,
 	buildToc,
 	type ContentFile,
 	collectFiles,
 	// Navigation/template building
+	collectPlanningVisualsContainmentWarnings,
 	collectSlides,
 	envBool,
 	// Config helpers
@@ -35,22 +38,30 @@ import {
 	escapeHtml,
 	// File utilities
 	exists,
+	filterByProfile,
+	filterUnknownPlanningVisualsTypeDiagnostics,
 	filterUnknownSlidesVisualsTypeDiagnostics,
 	// Provenance
 	generateProvenance,
+	loadDataBindings,
 	// YAML/Config parsing
 	loadSiteConfig,
+	mergeFrontmatterWithBody,
 	type Provenance,
+	pagePathForData,
 	// Markdown utilities
 	parseFrontmatter,
 	parseYaml,
+	resolveBindings,
 	resolveStylesPath,
 	resolveTemplatePath,
 	rewriteRelativeAssetUrls,
+	runPrebuildHooks,
 	// Types
 	type SiteConfig,
 	slugify,
 	validatePath,
+	validatePlanningVisualsFences,
 	validateSlidesVisualsFences,
 } from "../src/shared.ts";
 import { generateThemeCSS, getPrismUrls, loadTheme, type Theme } from "../src/theme.ts";
@@ -60,6 +71,41 @@ const DEFAULT_OUT = "dist";
 
 let ROOT = process.cwd();
 let OUT_DIR = DEFAULT_OUT;
+let ACTIVE_PROFILE: string | undefined;
+
+async function applyDataBindingsToMarkdown(
+	rawMarkdown: string,
+	filePath: string,
+	config: SiteConfig,
+): Promise<{ frontmatter: Record<string, unknown>; body: string }> {
+	const parsed = parseFrontmatter(rawMarkdown);
+	const dataRef = typeof parsed.frontmatter.data === "string" ? parsed.frontmatter.data.trim() : "";
+	if (!dataRef) return parsed;
+
+	const pagePath = pagePathForData(ROOT, config.docroot, filePath);
+	const bindings = await loadDataBindings(dataRef, pagePath, ROOT, config.docroot, config.dataroot);
+	return {
+		frontmatter: parsed.frontmatter,
+		body: resolveBindings(parsed.body, bindings, pagePath),
+	};
+}
+
+async function applyDataBindingsForSlides(
+	rawMarkdown: string,
+	filePath: string,
+	config: SiteConfig,
+): Promise<string> {
+	const resolved = await applyDataBindingsToMarkdown(rawMarkdown, filePath, config);
+	return mergeFrontmatterWithBody(rawMarkdown, resolved.body);
+}
+
+function normalizeMsysPath(p: string): string {
+	// Git Bash / MSYS-style paths: /c/Users/... -> C:\Users\...
+	if (process.platform !== "win32") return p;
+	const m = p.match(/^\/([a-zA-Z])\/(.*)$/);
+	if (!m) return p;
+	return `${m[1].toUpperCase()}:\\${m[2].replaceAll("/", "\\")}`;
+}
 
 // ---------------------------------------------------------------------------
 // CLI argument parsing
@@ -69,6 +115,7 @@ interface ParsedArgs {
 	folder?: string;
 	out?: string;
 	raw?: boolean;
+	profile?: string;
 }
 
 function parseArgs(argv: string[]): ParsedArgs {
@@ -80,6 +127,9 @@ function parseArgs(argv: string[]): ParsedArgs {
 		if ((arg === "--out" || arg === "-o") && next && !next.startsWith("-")) {
 			result.out = next;
 			i++;
+		} else if (arg === "--profile" && next && !next.startsWith("-")) {
+			result.profile = next;
+			i++;
 		} else if (arg === "--raw") {
 			result.raw = true;
 		} else if (arg === "--no-raw") {
@@ -91,12 +141,13 @@ function parseArgs(argv: string[]): ParsedArgs {
 	return result;
 }
 
-function getConfig(): { folder?: string; out: string; raw: boolean } {
+function getConfig(): { folder?: string; out: string; raw: boolean; profile?: string } {
 	const args = parseArgs(process.argv.slice(2));
 	return {
 		folder: args.folder,
 		out: args.out ?? envString("KITFLY_BUILD_OUT", DEFAULT_OUT),
 		raw: args.raw ?? envBool("KITFLY_BUILD_RAW", true),
+		profile: args.profile ?? process.env.KITFLY_PROFILE,
 	};
 }
 
@@ -106,6 +157,27 @@ async function resolveSiteAssetsDir(siteRoot: string): Promise<string | null> {
 	return null;
 }
 
+type FenceValidationFlags = {
+	slidesVisuals: boolean;
+	planningVisuals: boolean;
+};
+
+async function getFenceValidationFlags(root: string): Promise<FenceValidationFlags> {
+	try {
+		const raw = await readFile(join(root, "kitfly.plugins.yaml"), "utf-8");
+		const parsed = parseYaml(raw) as unknown as Record<string, unknown>;
+		const enabled = Array.isArray(parsed?.plugins) ? (parsed.plugins as unknown[]) : [];
+		return {
+			slidesVisuals: enabled.some((p) => typeof p === "string" && p.startsWith("slides-visuals@")),
+			planningVisuals: enabled.some(
+				(p) => typeof p === "string" && p.startsWith("planning-visuals@"),
+			),
+		};
+	} catch {
+		return { slidesVisuals: false, planningVisuals: false };
+	}
+}
+
 function computePathPrefix(urlKey: string): string {
 	const clean = urlKey.replace(/^\/+/, "").replace(/\.html$/, "");
 	if (!clean) return "./";
@@ -169,6 +241,7 @@ async function renderFile(
 	config: SiteConfig,
 	theme: Theme,
 	plugins: PluginInjections,
+	fenceValidation: FenceValidationFlags,
 ): Promise<string> {
 	const uiVersion = provenance.version ? `v${provenance.version}` : "unversioned";
 	const content = await readFile(filePath, "utf-8");
@@ -189,17 +262,33 @@ async function renderFile(
 		}
 		htmlContent = `<h1>${title}</h1>\n<pre><code class="language-json">${escapeHtml(prettyJson)}</code></pre>`;
 	} else {
-		const { frontmatter, body } = parseFrontmatter(content);
+		const { frontmatter, body } = await applyDataBindingsToMarkdown(content, filePath, config);
 		if (frontmatter.title) {
 			title = frontmatter.title as string;
 		}
 		pageMeta = buildPageMeta(frontmatter);
+		if (fenceValidation.planningVisuals) {
+			const diagnostics = filterUnknownPlanningVisualsTypeDiagnostics(
+				validatePlanningVisualsFences(body),
+			);
+			if (diagnostics.length) {
+				const msg = diagnostics
+					.slice(0, 12)
+					.map((d) => `  - ${filePath}:${d.line} ${d.message}`)
+					.join("\n");
+				throw new Error(`planning-visuals fence contract violations:\n${msg}`);
+			}
+			const warnings = collectPlanningVisualsContainmentWarnings(body);
+			for (const warning of warnings.slice(0, 12)) {
+				console.warn(`  ⚠ ${filePath}:${warning.line} ${warning.message}`);
+			}
+		}
 		htmlContent = marked.parse(body) as string;
 	}
 
 	const pathPrefix = computePathPrefix(urlKey);
 	const nav = buildNavStatic(files, urlKey, config, pathPrefix);
-	const footer = buildFooter(provenance, config);
+	const footer = buildFooter(provenance, config, pathPrefix);
 	const breadcrumbs = buildBreadcrumbsStatic(urlKey, pathPrefix, files, config);
 	const toc = buildToc(htmlContent);
 	const brandTarget = config.brand.external ? ' target="_blank" rel="noopener"' : "";
@@ -207,32 +296,50 @@ async function renderFile(
 	const prismUrls = getPrismUrls(theme);
 	const logoClass = config.brand.logoType === "wordmark" ? "logo-wordmark" : "logo-icon";
 	const brandInitial = escapeHtml(config.brand.name.trim().charAt(0).toUpperCase() || "K");
+	const mobileLogoHtml = buildLogoImgHtml({
+		logo: config.brand.logo || "assets/brand/logo.png",
+		logoDark: config.brand.logoDark,
+		alt: config.brand.name,
+		className: `logo-img ${logoClass}`,
+		pathPrefix,
+		onerrorFallback: true,
+	});
+	const sidebarLogoHtml = buildLogoImgHtml({
+		logo: config.brand.logo || "assets/brand/logo.png",
+		logoDark: config.brand.logoDark,
+		alt: config.brand.name,
+		className: "logo-img",
+		pathPrefix,
+		onerrorFallback: true,
+	});
 
 	return template
 		.replace("{{BODY_CLASS}}", "mode-docs")
-		.replace(/\{\{PATH_PREFIX\}\}/g, pathPrefix)
-		.replace(/\{\{BRAND_URL\}\}/g, config.brand.url)
-		.replace(/\{\{BRAND_TARGET\}\}/g, brandTarget)
-		.replace(/\{\{BRAND_NAME\}\}/g, config.brand.name)
-		.replace(/\{\{BRAND_INITIAL\}\}/g, brandInitial)
-		.replace(/\{\{BRAND_LOGO\}\}/g, config.brand.logo || "assets/brand/logo.png")
-		.replace(/\{\{BRAND_FAVICON\}\}/g, config.brand.favicon || "assets/brand/favicon.png")
-		.replace(/\{\{BRAND_LOGO_CLASS\}\}/g, logoClass)
-		.replace(/\{\{SITE_TITLE\}\}/g, config.title)
-		.replace("{{TITLE}}", title)
-		.replace("{{VERSION}}", uiVersion)
-		.replace("{{BRANCH}}", provenance.gitBranch)
-		.replace("{{BREADCRUMBS}}", breadcrumbs)
-		.replace("{{PAGE_META}}", pageMeta)
-		.replace("{{NAV}}", nav)
-		.replace("{{CONTENT}}", htmlContent)
-		.replace("{{TOC}}", toc)
-		.replace("{{FOOTER}}", footer)
-		.replace("{{THEME_CSS}}", themeCSS)
-		.replace("{{PLUGIN_HEAD}}", plugins.head)
-		.replace("{{PLUGIN_BODY_END}}", plugins.bodyEnd)
-		.replace("{{PRISM_LIGHT_URL}}", prismUrls.light)
-		.replace("{{PRISM_DARK_URL}}", prismUrls.dark)
+		.replace(/\{\{PATH_PREFIX\}\}/g, () => pathPrefix)
+		.replace(/\{\{BRAND_URL\}\}/g, () => config.brand.url)
+		.replace(/\{\{BRAND_TARGET\}\}/g, () => brandTarget)
+		.replace(/\{\{BRAND_NAME\}\}/g, () => config.brand.name)
+		.replace(/\{\{BRAND_INITIAL\}\}/g, () => brandInitial)
+		.replace("{{MOBILE_BRAND_LOGO_IMG}}", () => mobileLogoHtml)
+		.replace("{{SIDEBAR_BRAND_LOGO_IMG}}", () => sidebarLogoHtml)
+		.replace(/\{\{BRAND_LOGO\}\}/g, () => config.brand.logo || "assets/brand/logo.png")
+		.replace(/\{\{BRAND_FAVICON\}\}/g, () => config.brand.favicon || "assets/brand/favicon.png")
+		.replace(/\{\{BRAND_LOGO_CLASS\}\}/g, () => logoClass)
+		.replace(/\{\{SITE_TITLE\}\}/g, () => config.title)
+		.replace("{{TITLE}}", () => title)
+		.replace("{{VERSION}}", () => uiVersion)
+		.replace("{{BRANCH}}", () => provenance.gitBranch)
+		.replace("{{BREADCRUMBS}}", () => breadcrumbs)
+		.replace("{{PAGE_META}}", () => pageMeta)
+		.replace("{{NAV}}", () => nav)
+		.replace("{{CONTENT}}", () => htmlContent)
+		.replace("{{TOC}}", () => toc)
+		.replace("{{FOOTER}}", () => footer)
+		.replace("{{THEME_CSS}}", () => themeCSS)
+		.replace("{{PLUGIN_HEAD}}", () => plugins.head)
+		.replace("{{PLUGIN_BODY_END}}", () => plugins.bodyEnd)
+		.replace("{{PRISM_LIGHT_URL}}", () => prismUrls.light)
+		.replace("{{PRISM_DARK_URL}}", () => prismUrls.dark)
 		.replace("{{HOT_RELOAD_SCRIPT}}", "");
 }
 
@@ -274,32 +381,50 @@ sections:
 	const pathPrefix = "./";
 	const logoClass = config.brand.logoType === "wordmark" ? "logo-wordmark" : "logo-icon";
 	const brandInitial = escapeHtml(config.brand.name.trim().charAt(0).toUpperCase() || "K");
+	const mobileLogoHtml = buildLogoImgHtml({
+		logo: config.brand.logo || "assets/brand/logo.png",
+		logoDark: config.brand.logoDark,
+		alt: config.brand.name,
+		className: `logo-img ${logoClass}`,
+		pathPrefix,
+		onerrorFallback: true,
+	});
+	const sidebarLogoHtml = buildLogoImgHtml({
+		logo: config.brand.logo || "assets/brand/logo.png",
+		logoDark: config.brand.logoDark,
+		alt: config.brand.name,
+		className: "logo-img",
+		pathPrefix,
+		onerrorFallback: true,
+	});
 
 	return template
 		.replace("{{BODY_CLASS}}", "mode-docs")
-		.replace(/\{\{PATH_PREFIX\}\}/g, pathPrefix)
-		.replace(/\{\{BRAND_URL\}\}/g, config.brand.url)
-		.replace(/\{\{BRAND_TARGET\}\}/g, brandTarget)
-		.replace(/\{\{BRAND_NAME\}\}/g, config.brand.name)
-		.replace(/\{\{BRAND_INITIAL\}\}/g, brandInitial)
-		.replace(/\{\{BRAND_LOGO\}\}/g, config.brand.logo || "assets/brand/logo.png")
-		.replace(/\{\{BRAND_FAVICON\}\}/g, config.brand.favicon || "assets/brand/favicon.png")
-		.replace(/\{\{BRAND_LOGO_CLASS\}\}/g, logoClass)
-		.replace(/\{\{SITE_TITLE\}\}/g, config.title)
+		.replace(/\{\{PATH_PREFIX\}\}/g, () => pathPrefix)
+		.replace(/\{\{BRAND_URL\}\}/g, () => config.brand.url)
+		.replace(/\{\{BRAND_TARGET\}\}/g, () => brandTarget)
+		.replace(/\{\{BRAND_NAME\}\}/g, () => config.brand.name)
+		.replace(/\{\{BRAND_INITIAL\}\}/g, () => brandInitial)
+		.replace("{{MOBILE_BRAND_LOGO_IMG}}", () => mobileLogoHtml)
+		.replace("{{SIDEBAR_BRAND_LOGO_IMG}}", () => sidebarLogoHtml)
+		.replace(/\{\{BRAND_LOGO\}\}/g, () => config.brand.logo || "assets/brand/logo.png")
+		.replace(/\{\{BRAND_FAVICON\}\}/g, () => config.brand.favicon || "assets/brand/favicon.png")
+		.replace(/\{\{BRAND_LOGO_CLASS\}\}/g, () => logoClass)
+		.replace(/\{\{SITE_TITLE\}\}/g, () => config.title)
 		.replace("{{TITLE}}", "Getting Started")
-		.replace("{{VERSION}}", uiVersion)
-		.replace("{{BRANCH}}", provenance.gitBranch)
+		.replace("{{VERSION}}", () => uiVersion)
+		.replace("{{BRANCH}}", () => provenance.gitBranch)
 		.replace("{{BREADCRUMBS}}", "")
 		.replace("{{PAGE_META}}", "")
 		.replace("{{NAV}}", "<ul></ul>")
-		.replace("{{CONTENT}}", htmlContent)
+		.replace("{{CONTENT}}", () => htmlContent)
 		.replace("{{TOC}}", "")
-		.replace("{{FOOTER}}", buildFooter(provenance, config))
-		.replace("{{THEME_CSS}}", themeCSS)
-		.replace("{{PLUGIN_HEAD}}", plugins.head)
-		.replace("{{PLUGIN_BODY_END}}", plugins.bodyEnd)
-		.replace("{{PRISM_LIGHT_URL}}", prismUrls.light)
-		.replace("{{PRISM_DARK_URL}}", prismUrls.dark)
+		.replace("{{FOOTER}}", () => buildFooter(provenance, config, pathPrefix))
+		.replace("{{THEME_CSS}}", () => themeCSS)
+		.replace("{{PLUGIN_HEAD}}", () => plugins.head)
+		.replace("{{PLUGIN_BODY_END}}", () => plugins.bodyEnd)
+		.replace("{{PRISM_LIGHT_URL}}", () => prismUrls.light)
+		.replace("{{PRISM_DARK_URL}}", () => prismUrls.dark)
 		.replace("{{HOT_RELOAD_SCRIPT}}", "");
 }
 
@@ -310,24 +435,18 @@ async function renderSlidesIndex(
 	config: SiteConfig,
 	theme: Theme,
 	plugins: PluginInjections,
+	fenceValidation: FenceValidationFlags,
 ): Promise<string> {
 	const uiVersion = provenance.version ? `v${provenance.version}` : "unversioned";
 	const pathPrefix = "./";
-	const slides = await collectSlides(files);
-	let validateFences = false;
-	try {
-		const raw = await readFile(join(ROOT, "kitfly.plugins.yaml"), "utf-8");
-		const parsed = parseYaml(raw) as unknown as Record<string, unknown>;
-		const enabled = Array.isArray(parsed?.plugins) ? (parsed.plugins as unknown[]) : [];
-		validateFences = enabled.some((p) => typeof p === "string" && p.startsWith("slides-visuals@"));
-	} catch {
-		// no config, skip
-	}
+	const slides = await collectSlides(files, {
+		markdownTransform: (raw, file) => applyDataBindingsForSlides(raw, file.path, config),
+	});
 	const renderedSlides = await Promise.all(
 		slides.map(async (slide, i) => {
 			let inner = "";
 			if (slide.kind === "markdown") {
-				if (validateFences) {
+				if (fenceValidation.slidesVisuals) {
 					const diagnostics = filterUnknownSlidesVisualsTypeDiagnostics(
 						validateSlidesVisualsFences(slide.body),
 					);
@@ -339,6 +458,22 @@ async function renderSlidesIndex(
 						throw new Error(`slides-visuals fence contract violations:\n${msg}`);
 					}
 				}
+				if (fenceValidation.planningVisuals) {
+					const diagnostics = filterUnknownPlanningVisualsTypeDiagnostics(
+						validatePlanningVisualsFences(slide.body),
+					);
+					if (diagnostics.length) {
+						const msg = diagnostics
+							.slice(0, 12)
+							.map((d) => `  - ${slide.sourcePath}:${d.line} ${d.message}`)
+							.join("\n");
+						throw new Error(`planning-visuals fence contract violations:\n${msg}`);
+					}
+					const warnings = collectPlanningVisualsContainmentWarnings(slide.body);
+					for (const warning of warnings.slice(0, 12)) {
+						console.warn(`  ⚠ ${slide.sourcePath}:${warning.line} ${warning.message}`);
+					}
+				}
 				inner = marked.parse(slide.body) as string;
 			} else if (slide.kind === "yaml") {
 				inner = `<pre><code class="language-yaml">${escapeHtml(slide.body)}</code></pre>`;
@@ -376,38 +511,56 @@ async function renderSlidesIndex(
           </div>
         </div>`;
 
-	const nav = buildSlideNav(slides, config, "slide-1");
+	const nav = buildSlideNavHierarchical(slides, config, "slide-1");
 	const brandTarget = config.brand.external ? ' target="_blank" rel="noopener"' : "";
 	const logoClass = config.brand.logoType === "wordmark" ? "logo-wordmark" : "logo-icon";
 	const themeCSS = generateThemeCSS(theme);
 	const prismUrls = getPrismUrls(theme);
 	const brandInitial = escapeHtml(config.brand.name.trim().charAt(0).toUpperCase() || "K");
+	const mobileLogoHtml = buildLogoImgHtml({
+		logo: config.brand.logo || "assets/brand/logo.png",
+		logoDark: config.brand.logoDark,
+		alt: config.brand.name,
+		className: `logo-img ${logoClass}`,
+		pathPrefix,
+		onerrorFallback: true,
+	});
+	const sidebarLogoHtml = buildLogoImgHtml({
+		logo: config.brand.logo || "assets/brand/logo.png",
+		logoDark: config.brand.logoDark,
+		alt: config.brand.name,
+		className: "logo-img",
+		pathPrefix,
+		onerrorFallback: true,
+	});
 
 	return template
 		.replace("{{BODY_CLASS}}", "mode-slides")
-		.replace(/\{\{PATH_PREFIX\}\}/g, pathPrefix)
-		.replace(/\{\{BRAND_URL\}\}/g, config.brand.url)
-		.replace(/\{\{BRAND_TARGET\}\}/g, brandTarget)
-		.replace(/\{\{BRAND_NAME\}\}/g, config.brand.name)
-		.replace(/\{\{BRAND_INITIAL\}\}/g, brandInitial)
-		.replace(/\{\{BRAND_LOGO\}\}/g, config.brand.logo || "assets/brand/logo.png")
-		.replace(/\{\{BRAND_FAVICON\}\}/g, config.brand.favicon || "assets/brand/favicon.png")
-		.replace(/\{\{BRAND_LOGO_CLASS\}\}/g, logoClass)
-		.replace(/\{\{SITE_TITLE\}\}/g, config.title)
-		.replace("{{TITLE}}", config.title)
-		.replace("{{VERSION}}", uiVersion)
-		.replace("{{BRANCH}}", provenance.gitBranch)
+		.replace(/\{\{PATH_PREFIX\}\}/g, () => pathPrefix)
+		.replace(/\{\{BRAND_URL\}\}/g, () => config.brand.url)
+		.replace(/\{\{BRAND_TARGET\}\}/g, () => brandTarget)
+		.replace(/\{\{BRAND_NAME\}\}/g, () => config.brand.name)
+		.replace(/\{\{BRAND_INITIAL\}\}/g, () => brandInitial)
+		.replace("{{MOBILE_BRAND_LOGO_IMG}}", () => mobileLogoHtml)
+		.replace("{{SIDEBAR_BRAND_LOGO_IMG}}", () => sidebarLogoHtml)
+		.replace(/\{\{BRAND_LOGO\}\}/g, () => config.brand.logo || "assets/brand/logo.png")
+		.replace(/\{\{BRAND_FAVICON\}\}/g, () => config.brand.favicon || "assets/brand/favicon.png")
+		.replace(/\{\{BRAND_LOGO_CLASS\}\}/g, () => logoClass)
+		.replace(/\{\{SITE_TITLE\}\}/g, () => config.title)
+		.replace("{{TITLE}}", () => config.title)
+		.replace("{{VERSION}}", () => uiVersion)
+		.replace("{{BRANCH}}", () => provenance.gitBranch)
 		.replace("{{BREADCRUMBS}}", "")
 		.replace("{{PAGE_META}}", "")
-		.replace("{{NAV}}", nav)
-		.replace("{{CONTENT}}", htmlContent)
+		.replace("{{NAV}}", () => nav)
+		.replace("{{CONTENT}}", () => htmlContent)
 		.replace("{{TOC}}", "")
-		.replace("{{FOOTER}}", buildFooter(provenance, config))
-		.replace("{{THEME_CSS}}", themeCSS)
-		.replace("{{PLUGIN_HEAD}}", plugins.head)
-		.replace("{{PLUGIN_BODY_END}}", plugins.bodyEnd)
-		.replace("{{PRISM_LIGHT_URL}}", prismUrls.light)
-		.replace("{{PRISM_DARK_URL}}", prismUrls.dark)
+		.replace("{{FOOTER}}", () => buildFooter(provenance, config, pathPrefix))
+		.replace("{{THEME_CSS}}", () => themeCSS)
+		.replace("{{PLUGIN_HEAD}}", () => plugins.head)
+		.replace("{{PLUGIN_BODY_END}}", () => plugins.bodyEnd)
+		.replace("{{PRISM_LIGHT_URL}}", () => prismUrls.light)
+		.replace("{{PRISM_DARK_URL}}", () => prismUrls.dark)
 		.replace("{{HOT_RELOAD_SCRIPT}}", "");
 }
 
@@ -416,6 +569,7 @@ export interface BuildOptions {
 	folder?: string;
 	out?: string;
 	raw?: boolean; // Include raw markdown files (default: true)
+	profile?: string;
 }
 
 let INCLUDE_RAW = true;
@@ -430,18 +584,29 @@ export async function build(options: BuildOptions = {}) {
 	if (options.raw === false) {
 		INCLUDE_RAW = false;
 	}
+	ACTIVE_PROFILE = options.profile;
 	await buildSite();
 }
 
 // Rename internal function
 async function buildSite() {
-	const DIST = join(ROOT, OUT_DIR);
+	const DIST = resolve(ROOT, normalizeMsysPath(OUT_DIR));
 
 	console.log("Building site...\n");
 
 	// Load configuration
 	const config = await loadSiteConfig(ROOT);
 	console.log(`  ✓ Loaded config: "${config.title}" (${config.sections.length} sections)`);
+	if (config.prebuild?.length) {
+		await runPrebuildHooks(
+			config.prebuild,
+			ROOT,
+			"build",
+			ACTIVE_PROFILE,
+			config.dataroot || "data",
+		);
+		console.log(`  ✓ prebuild hooks (${config.prebuild.length})`);
+	}
 
 	// Load theme
 	const theme = await loadTheme(ROOT);
@@ -465,6 +630,7 @@ async function buildSite() {
 		root: ROOT,
 		mode: config.mode === "slides" ? "slides" : "docs",
 	});
+	const fenceValidation = await getFenceValidationFlags(ROOT);
 
 	// Copy CSS
 	const css = await readFile(await resolveStylesPath(ROOT), "utf-8");
@@ -499,7 +665,11 @@ async function buildSite() {
 	}
 
 	// Collect and render all files
-	const files = await collectFiles(ROOT, config);
+	const files = await filterByProfile(
+		await collectFiles(ROOT, config),
+		ACTIVE_PROFILE,
+		config.profiles,
+	);
 
 	if (files.length === 0) {
 		// No content - render Getting Started page
@@ -511,7 +681,15 @@ async function buildSite() {
 	}
 
 	if (config.mode === "slides") {
-		const html = await renderSlidesIndex(template, files, provenance, config, theme, plugins);
+		const html = await renderSlidesIndex(
+			template,
+			files,
+			provenance,
+			config,
+			theme,
+			plugins,
+			fenceValidation,
+		);
 		await writeFile(join(DIST, "index.html"), html);
 		console.log(`  ✓ index.html (slides mode, ${files.length} source files)`);
 		await generateAIAccessibility(DIST, files, config, provenance);
@@ -530,6 +708,7 @@ async function buildSite() {
 			config,
 			theme,
 			plugins,
+			fenceValidation,
 		);
 
 		// Create output path
@@ -556,6 +735,7 @@ async function buildSite() {
 					config,
 					theme,
 					plugins,
+					fenceValidation,
 				);
 				await writeFile(join(DIST, "index.html"), homeHtml);
 				console.log(`  ✓ index.html (from ${config.home})`);
@@ -571,6 +751,7 @@ async function buildSite() {
 					config,
 					theme,
 					plugins,
+					fenceValidation,
 				);
 				await writeFile(join(DIST, "index.html"), indexHtml);
 				console.log("  ✓ index.html");
@@ -588,6 +769,7 @@ async function buildSite() {
 			config,
 			theme,
 			plugins,
+			fenceValidation,
 		);
 		await writeFile(join(DIST, "index.html"), indexHtml);
 		console.log("  ✓ index.html");
@@ -733,6 +915,7 @@ Usage: bun run build [folder] [options]
 
 Options:
   -o, --out <dir>       Output directory [env: KITFLY_BUILD_OUT] [default: ${DEFAULT_OUT}]
+  --profile <name>      Active content profile [env: KITFLY_PROFILE]
   --raw                 Include raw markdown files [env: KITFLY_BUILD_RAW] [default: true]
   --no-raw              Don't include raw markdown files
   --help                Show this help message
@@ -752,5 +935,6 @@ Examples:
 		folder: cfg.folder,
 		out: cfg.out,
 		raw: cfg.raw,
+		profile: cfg.profile,
 	}).catch(console.error);
 }