@clarify-labs/cli 0.10.2 → 0.11.0

package/output/{engine-CSSL_gGd.js → engine-DfF5RJjC.js}

@@ -22,6 +22,24 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import SwaggerParser from "@apidevtools/swagger-parser";
 import { tmpdir } from "node:os";
 import { createRequire } from "node:module";
+//#region source/parsers/content/diagnostic.ts
+function displayPath(filePath, projectRoot) {
+	if (!filePath) return void 0;
+	if (!projectRoot) return filePath.replace(/^[A-Za-z]:\//, "").replace(/^\/+/, "");
+	const normalized = relative(projectRoot, filePath);
+	return normalized && !normalized.startsWith("..") && !isAbsolute(normalized) ? normalized : filePath.replace(/^[A-Za-z]:\//, "").replace(/^\/+/, "");
+}
+function createContentDiagnostic(options) {
+	const { error } = options;
+	return {
+		kind: options.kind,
+		title: options.title,
+		message: options.message,
+		filePath: displayPath(options.filePath, options.projectRoot),
+		details: error instanceof Error ? options.includeStack ? error.stack ?? error.message : error.message : String(error)
+	};
+}
+//#endregion
 //#region source/parsers/markdown/mdx.ts
 function getLanguage(className) {
 	return (Array.isArray(className) ? className : typeof className === "string" ? className.split(/\s+/) : []).find((item) => typeof item === "string" && item.startsWith("language-"))?.replace(/^language-/, "") || "txt";
@@ -57,9 +75,18 @@ var rehypePlugins = [
 		parseMetaString: parseCodeMeta
 	}]
 ];
-function formatMdxDiagnostic(error) {
-	if (error instanceof Error) return error.message;
-	return String(error);
+function createContentCompileDiagnostic(options) {
+	const { format, phase, error, filePath, projectRoot } = options;
+	const label = format === "mdx" ? "MDX" : "Markdown";
+	return createContentDiagnostic({
+		kind: format,
+		title: `${label} ${phase} error`,
+		message: phase === "syntax" ? "This page could not be compiled. Fix the MDX syntax or component usage above, then reload the route." : `This page could not be compiled. Fix the ${label} syntax or plugin error below, then reload the route.`,
+		error,
+		filePath,
+		projectRoot,
+		includeStack: phase === "compilation"
+	});
 }
 /**
 * Validate MDX content for diagnostics WITHOUT running the build-time rehype
@@ -90,13 +117,13 @@ async function compileMdxContent(content, filePath, projectRoot) {
 	} catch (error) {
 		return {
 			ok: false,
-			diagnostic: {
-				kind: "mdx",
-				title: "MDX syntax error",
-				message: "This page could not be compiled. Fix the MDX syntax or component usage above, then reload the route.",
-				filePath: filePath && projectRoot ? filePath.replace(projectRoot + "/", "").replace(/^\/+/, "") : filePath ? filePath.replace(/^[A-Za-z]:\//, "").replace(/^\/+/, "") : void 0,
-				details: formatMdxDiagnostic(error)
-			}
+			diagnostic: createContentCompileDiagnostic({
+				format: "mdx",
+				phase: "syntax",
+				error,
+				filePath,
+				projectRoot
+			})
 		};
 	}
 }
@@ -352,10 +379,10 @@ function frontmatterKeywords(frontmatter) {
 	const keywords = Array.isArray(value) ? value.filter((item) => typeof item === "string") : typeof value === "string" ? value.split(",").map((keyword) => keyword.trim()).filter(Boolean) : [];
 	return keywords.length > 0 ? keywords : void 0;
 }
-function withAlternates(route, routes, i18n) {
+function withAlternates(route, routes, locales) {
 	const basePath = route.basePath ?? route.path;
 	const routeByLocaleAndBase = new Map(routes.filter((r) => !r.locale || r.path === `/${r.locale}` || r.path.startsWith(`/${r.locale}/`)).map((r) => [`${r.locale ?? ""}:${r.basePath ?? r.path}`, r]));
-	const alternates = Object.fromEntries(i18n.locales.flatMap((locale) => {
+	const alternates = Object.fromEntries(locales.locales.flatMap((locale) => {
 		const alternate = routeByLocaleAndBase.get(`${locale.code}:${basePath}`);
 		return alternate ? [[locale.code, alternate.path]] : [];
 	}));
@@ -368,11 +395,11 @@ function withAlternates(route, routes, i18n) {
 * 为默认语言的 locale-prefixed 路由生成无前缀的"裸路径别名"，方便不带语言
 * 前缀的 URL 也能访问。标记 `isBareAlias` 以便搜索索引生成时过滤重复索引。
 */
-function generateBareAliases(routes, i18n) {
+function generateBareAliases(routes, locales) {
 	const bareRoutes = [];
 	const seenBare = new Set(routes.map((r) => r.path));
 	for (const route of routes) {
-		if (route.locale !== i18n.defaultLocale) continue;
+		if (route.locale !== locales.default) continue;
 		const bp = route.basePath ?? route.path;
 		if (bp === route.path || seenBare.has(bp)) continue;
 		seenBare.add(bp);
@@ -384,42 +411,42 @@ function generateBareAliases(routes, i18n) {
 	}
 	return bareRoutes;
 }
-async function findLocalizedContentRoutes(contentRoot, i18n, options = {}) {
-	if (!i18n) return findContentRoutes(contentRoot, contentRoot, options);
+async function findLocalizedContentRoutes(contentRoot, locales, options = {}) {
+	if (!locales) return findContentRoutes(contentRoot, contentRoot, options);
 	const localizedRoutes = [];
-	for (const locale of i18n.locales) {
+	for (const locale of locales.locales) {
 		const localeRoot = join(contentRoot, locale.code);
 		const discovered = await findContentRoutes(localeRoot, localeRoot, options);
 		for (const route of discovered) {
 			const basePath = route.basePath ?? route.path;
 			localizedRoutes.push({
 				...route,
-				path: localizedRoutePath(basePath, locale.code, i18n),
+				path: localizedRoutePath(basePath, locale.code, locales),
 				basePath,
 				locale: locale.code,
 				module: { virtualModuleId: virtualModuleIdForLocalizedRoute(contentRoot, route.source.filePath) }
 			});
 		}
 	}
-	if (i18n.missing === "fallback") {
+	if (locales.missing === "fallback") {
 		const routeByLocaleAndBase = new Map(localizedRoutes.map((route) => [`${route.locale ?? ""}:${route.basePath ?? route.path}`, route]));
-		const defaultRoutes = localizedRoutes.filter((route) => route.locale === i18n.defaultLocale);
+		const defaultRoutes = localizedRoutes.filter((route) => route.locale === locales.default);
 		for (const sourceRoute of defaultRoutes) {
 			const basePath = sourceRoute.basePath ?? sourceRoute.path;
-			for (const locale of i18n.locales) {
+			for (const locale of locales.locales) {
 				const key = `${locale.code}:${basePath}`;
 				if (routeByLocaleAndBase.has(key)) continue;
 				localizedRoutes.push({
 					...sourceRoute,
-					path: localizedRoutePath(basePath, locale.code, i18n),
+					path: localizedRoutePath(basePath, locale.code, locales),
 					locale: locale.code,
 					isFallback: true
 				});
 			}
 		}
 	}
-	const routesWithAlternates = localizedRoutes.map((route) => withAlternates(route, localizedRoutes, i18n));
-	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, i18n)];
+	const routesWithAlternates = localizedRoutes.map((route) => withAlternates(route, localizedRoutes, locales));
+	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, locales)];
 }
 function buildNavigation(routes) {
 	const root = [];
@@ -452,6 +479,7 @@ function routeIntentFromPagesItem(item) {
 		kind: "page",
 		ref: item
 	};
+	if ("group" in item) throw new Error("Navigation groups do not resolve to route intents");
 	if ("openapi" in item) return {
 		kind: "openapi",
 		ref: item.openapi,
@@ -479,19 +507,23 @@ function firstNavigationPath(nodes) {
 }
 function collectExplicitPagePathIntents(tabs) {
 	const intents = [];
-	for (const tab of tabs ?? []) {
-		if (!tab.pages || tab.pages === "FileTree") continue;
-		for (const group of tab.pages) for (const item of group.pages) if (typeof item !== "string" && "page" in item && item.path) {
+	const collectItems = (items) => {
+		for (const item of items) if (typeof item !== "string" && "group" in item) collectItems(item.pages);
+		else if (typeof item !== "string" && "page" in item && item.path) {
 			const intent = routeIntentFromPagesItem(item);
 			if (intent.kind === "page" && intent.path) intents.push({
 				...intent,
 				path: intent.path
 			});
 		}
+	};
+	for (const tab of tabs ?? []) {
+		if (!tab.pages || tab.pages === "FileTree") continue;
+		for (const group of tab.pages) collectItems(group.pages);
 	}
 	return intents;
 }
-function applyConfiguredPageRoutePaths(routes, tabs, i18n) {
+function applyConfiguredPageRoutePaths(routes, tabs, locales) {
 	const pageIntents = collectExplicitPagePathIntents(tabs);
 	if (!pageIntents.length) return routes;
 	const additions = [];
@@ -507,15 +539,15 @@ function applyConfiguredPageRoutePaths(routes, tabs, i18n) {
 			existingKeys.add(key);
 			additions.push({
 				...route,
-				path: route.locale && i18n ? localizedRoutePath(targetBasePath, route.locale, i18n) : targetBasePath,
+				path: route.locale && locales ? localizedRoutePath(targetBasePath, route.locale, locales) : targetBasePath,
 				basePath: targetBasePath
 			});
 		}
 	}
 	const nextRoutes = [...routes, ...additions];
-	const routesWithAlternates = i18n ? nextRoutes.map((route) => withAlternates(route, nextRoutes, i18n)) : nextRoutes;
-	if (!i18n) return routesWithAlternates;
-	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, i18n)];
+	const routesWithAlternates = locales ? nextRoutes.map((route) => withAlternates(route, nextRoutes, locales)) : nextRoutes;
+	if (!locales) return routesWithAlternates;
+	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, locales)];
 }
 function buildNavigationFromPagesConfig(routes, config) {
 	if (!config || config === "FileTree") return buildNavigation(routes);
@@ -538,28 +570,38 @@ function buildNavigationFromTabsConfig(routes, tabs) {
 }
 function buildNavigationFromConfig(routes, config) {
 	const routeMap = new Map(routes.map((r) => [r.path, r]));
-	return config.map((group) => {
-		const children = group.pages.map((item) => {
-			const intent = routeIntentFromPagesItem(item);
-			if (intent.kind === "openapi") {
-				const path = openAPIPagePathFromRef(intent.ref, intent.tagFilter, intent.path);
-				const route = routeMap.get(path);
-				return {
-					path,
-					title: resolveLocalizedText(intent.title, "", "") ?? route?.meta.title ?? kebabToTitle(path.split("/").pop() ?? intent.ref),
-					icon: intent.icon,
-					sections: route?.meta.sections ? navigationSections(route.meta.sections) : void 0
-				};
-			}
-			const path = routePathFromRef(intent.ref, intent.path);
+	const buildItem = (item) => {
+		if (typeof item !== "string" && "group" in item) {
+			const children = item.pages.map(buildItem);
+			return {
+				path: firstNavigationPath(children),
+				title: resolveLocalizedText(item.group, "", "") ?? "",
+				icon: item.icon,
+				children
+			};
+		}
+		const intent = routeIntentFromPagesItem(item);
+		if (intent.kind === "openapi") {
+			const path = openAPIPagePathFromRef(intent.ref, intent.tagFilter, intent.path);
 			const route = routeMap.get(path);
 			return {
-				path: intent.redirect ? normalizePath(intent.redirect) : path,
+				path,
 				title: resolveLocalizedText(intent.title, "", "") ?? route?.meta.title ?? kebabToTitle(path.split("/").pop() ?? intent.ref),
 				icon: intent.icon,
 				sections: route?.meta.sections ? navigationSections(route.meta.sections) : void 0
 			};
-		});
+		}
+		const path = routePathFromRef(intent.ref, intent.path);
+		const route = routeMap.get(path);
+		return {
+			path: intent.redirect ? normalizePath(intent.redirect) : path,
+			title: resolveLocalizedText(intent.title, "", "") ?? route?.meta.title ?? kebabToTitle(path.split("/").pop() ?? intent.ref),
+			icon: intent.icon,
+			sections: route?.meta.sections ? navigationSections(route.meta.sections) : void 0
+		};
+	};
+	return config.map((group) => {
+		const children = group.pages.map(buildItem);
 		return {
 			path: children[0]?.path ?? "/",
 			title: resolveLocalizedText(group.group, "", "") ?? "",
@@ -568,51 +610,61 @@ function buildNavigationFromConfig(routes, config) {
 		};
 	});
 }
-function localizeNavigationPaths(nodes, locale, i18n) {
+function localizeNavigationPaths(nodes, locale, locales) {
 	return nodes.map((node) => ({
 		...node,
-		path: localizedRoutePath(node.path, locale, i18n),
-		children: node.children ? localizeNavigationPaths(node.children, locale, i18n) : void 0
+		path: localizedRoutePath(node.path, locale, locales),
+		children: node.children ? localizeNavigationPaths(node.children, locale, locales) : void 0
 	}));
 }
-function buildLocalizedNavigationForLocale(routes, config, locale, i18n) {
+function buildLocalizedNavigationForLocale(routes, config, locale, locales) {
 	if (!config || config === "FileTree") return localizeNavigationPaths(buildNavigation(routes.map((route) => ({
 		...route,
 		path: route.basePath ?? route.path
-	}))), locale, i18n);
+	}))), locale, locales);
 	const routeMap = new Map(routes.map((route) => [route.basePath ?? route.path, route]));
-	return config.map((group) => {
-		const children = group.pages.map((item) => {
-			const intent = routeIntentFromPagesItem(item);
-			const basePath = intent.kind === "openapi" ? openAPIPagePathFromRef(intent.ref, intent.tagFilter, intent.path) : routePathFromRef(intent.ref, intent.path);
-			const route = routeMap.get(basePath);
-			const path = route?.path ?? localizedRoutePath(basePath, locale, i18n);
+	const buildItem = (item) => {
+		if (typeof item !== "string" && "group" in item) {
+			const children = item.pages.map(buildItem);
 			return {
-				path: (intent.kind === "page" && intent.redirect ? localizedRoutePath(routePathFromRef(intent.redirect), locale, i18n) : void 0) ?? path,
-				title: resolveLocalizedText(intent.title, locale, i18n.defaultLocale) ?? route?.meta.title ?? kebabToTitle(basePath.split("/").pop() ?? intent.ref),
-				icon: intent.icon,
-				sections: route?.meta.sections ? navigationSections(route.meta.sections) : void 0
+				path: firstNavigationPath(children),
+				title: resolveLocalizedText(item.group, locale, locales.default) ?? "",
+				icon: item.icon,
+				children
 			};
-		});
+		}
+		const intent = routeIntentFromPagesItem(item);
+		const basePath = intent.kind === "openapi" ? openAPIPagePathFromRef(intent.ref, intent.tagFilter, intent.path) : routePathFromRef(intent.ref, intent.path);
+		const route = routeMap.get(basePath);
+		const path = route?.path ?? localizedRoutePath(basePath, locale, locales);
+		return {
+			path: (intent.kind === "page" && intent.redirect ? localizedRoutePath(routePathFromRef(intent.redirect), locale, locales) : void 0) ?? path,
+			title: resolveLocalizedText(intent.title, locale, locales.default) ?? route?.meta.title ?? kebabToTitle(basePath.split("/").pop() ?? intent.ref),
+			icon: intent.icon,
+			sections: route?.meta.sections ? navigationSections(route.meta.sections) : void 0
+		};
+	};
+	return config.map((group) => {
+		const children = group.pages.map(buildItem);
 		return {
-			path: children[0]?.path ?? localizedRoutePath("/", locale, i18n),
-			title: resolveLocalizedText(group.group, locale, i18n.defaultLocale) ?? "",
+			path: children[0]?.path ?? localizedRoutePath("/", locale, locales),
+			title: resolveLocalizedText(group.group, locale, locales.default) ?? "",
 			icon: group.icon,
 			children
 		};
 	});
 }
-function buildLocalizedNavigationFromTabsConfig(routes, tabs, i18n) {
-	if (!i18n) return void 0;
+function buildLocalizedNavigationFromTabsConfig(routes, tabs, localesConfig) {
+	if (!localesConfig) return void 0;
 	const locales = {};
-	for (const locale of i18n.locales) {
+	for (const locale of localesConfig.locales) {
 		const localeRoutes = routes.filter((route) => route.locale === locale.code);
 		locales[locale.code] = { tabs: tabs.map((tab) => {
-			const children = buildLocalizedNavigationForLocale(localeRoutes, tab.pages, locale.code, i18n);
+			const children = buildLocalizedNavigationForLocale(localeRoutes, tab.pages, locale.code, localesConfig);
 			return {
 				type: "tab",
 				path: firstNavigationPath(children),
-				title: resolveLocalizedText(tab.tab, locale.code, i18n.defaultLocale) ?? "",
+				title: resolveLocalizedText(tab.tab, locale.code, localesConfig.default) ?? "",
 				icon: tab.icon,
 				children
 			};
@@ -679,7 +731,7 @@ function inferRouteForFile(filePath, contentRoot, defaultLocale) {
 	const localeSegmentIndex = fileLocale ? segments.indexOf(fileLocale) : -1;
 	const basePath = basePathFromRef(localeSegmentIndex >= 0 ? segments.slice(localeSegmentIndex + 1).join("/") : ref);
 	const path = fileLocale && defaultLocale ? localizedRoutePath(basePath, fileLocale, {
-		defaultLocale,
+		default: defaultLocale,
 		missing: "fallback",
 		locales: []
 	}) : basePath;
@@ -732,12 +784,12 @@ async function handleDevRouteRequest(req, res, routes, context) {
 	}
 	const file = typeof body === "object" && body !== null ? body.file : void 0;
 	if (typeof file === "string" && file.length > 0) {
-		const route = resolveRouteForFile(file, routes, context.projectConfig.i18n?.defaultLocale);
+		const route = resolveRouteForFile(file, routes, context.projectConfig.locales?.default);
 		if (route) {
 			res.end(JSON.stringify(toDevRouteEntry(route)));
 			return;
 		}
-		const inferred = inferRouteForFile(file, context.contentRoot, context.projectConfig.i18n?.defaultLocale);
+		const inferred = inferRouteForFile(file, context.contentRoot, context.projectConfig.locales?.default);
 		res.end(JSON.stringify(inferred));
 		return;
 	}
@@ -763,8 +815,7 @@ function resolveThemeConfig(theme = {}) {
 		layout: {
 			...presetTheme.layout,
 			...theme.layout
-		},
-		editor: theme.editor ?? presetTheme.editor
+		}
 	};
 }
 //#endregion
@@ -772,26 +823,26 @@ function resolveThemeConfig(theme = {}) {
 var clarifyLogoConfigSchema = z.union([z.string(), z.object({
 	light: z.string().optional(),
 	dark: z.string().optional()
-})]);
+}).strict()]);
 var clarifyFaviconConfigSchema = z.union([z.string(), z.object({
 	light: z.string().optional(),
 	dark: z.string().optional()
-})]);
+}).strict()]);
 var clarifyLocalizedTextSchema = z.union([z.string(), z.record(z.string(), z.string())]);
 var clarifyLocaleConfigSchema = z.object({
 	code: z.string(),
 	label: z.string(),
 	dir: z.union([z.literal("ltr"), z.literal("rtl")]).optional()
-});
-var clarifyI18nConfigSchema = z.object({
-	defaultLocale: z.string().optional(),
+}).strict();
+var clarifyLocalesConfigSchema = z.object({
+	default: z.string().optional(),
 	missing: z.union([
 		z.literal("fallback"),
 		z.literal("404"),
 		z.literal("hide")
 	]).optional(),
 	locales: z.array(clarifyLocaleConfigSchema).min(1)
-}).superRefine((config, ctx) => {
+}).strict().superRefine((config, ctx) => {
 	const localeCodes = /* @__PURE__ */ new Set();
 	for (const [index, locale] of config.locales.entries()) {
 		if (localeCodes.has(locale.code)) ctx.addIssue({
@@ -805,17 +856,17 @@ var clarifyI18nConfigSchema = z.object({
 		});
 		localeCodes.add(locale.code);
 	}
-	if (config.defaultLocale && !localeCodes.has(config.defaultLocale)) ctx.addIssue({
+	if (config.default && !localeCodes.has(config.default)) ctx.addIssue({
 		code: z.ZodIssueCode.custom,
-		message: "defaultLocale must be one of i18n.locales",
-		path: ["defaultLocale"]
+		message: "default must be one of locales.locales",
+		path: ["default"]
 	});
 });
 var clarifyNavbarLinkSchema = z.object({
 	label: clarifyLocalizedTextSchema,
 	href: z.string(),
 	external: z.boolean().optional()
-});
+}).strict();
 var clarifyBannerConfigOptionsSchema = z.object({
 	content: clarifyLocalizedTextSchema,
 	dismissible: z.boolean().optional(),
@@ -833,45 +884,46 @@ var clarifyVariableValueSchema = z.lazy(() => z.union([
 	z.record(z.string(), clarifyVariableValueSchema)
 ]));
 var clarifyVariablesConfigSchema = z.record(z.string(), clarifyVariableValueSchema);
-var clarifySourceConfigSchema = z.object({
-	repository: z.string(),
+var clarifyRepositoryConfigSchema = z.object({
+	url: z.string().optional(),
 	branch: z.string().optional(),
 	directory: z.string().optional()
-});
-var clarifyPagesItemSchema = z.union([
+}).strict();
+var clarifyPagesItemSchema = z.lazy(() => z.union([
 	z.string(),
+	clarifyPagesGroupSchema,
 	z.object({
 		page: z.string(),
 		path: z.string().optional(),
 		title: clarifyLocalizedTextSchema.optional(),
 		icon: z.string().optional(),
 		redirect: z.string().optional()
-	}),
+	}).strict(),
 	z.object({
 		openapi: z.string(),
 		path: z.string().optional(),
 		icon: z.string().optional(),
 		title: clarifyLocalizedTextSchema.optional(),
-		filter: z.object({ tags: z.array(z.string()).optional() }).optional()
-	})
-]);
-var clarifyPagesGroupSchema = z.object({
+		filter: z.object({ tags: z.array(z.string()).optional() }).strict().optional()
+	}).strict()
+]));
+var clarifyPagesGroupSchema = z.lazy(() => z.object({
 	group: clarifyLocalizedTextSchema,
 	icon: z.string().optional(),
 	pages: z.array(clarifyPagesItemSchema)
-});
+}).strict());
 var clarifyPagesConfigSchema = z.union([z.array(clarifyPagesGroupSchema), z.literal("FileTree")]);
 var clarifyTabItemSchema = z.object({
 	tab: clarifyLocalizedTextSchema,
 	icon: z.string().optional(),
 	pages: clarifyPagesConfigSchema.optional()
-});
+}).strict();
 var clarifyTabsConfigSchema = z.array(clarifyTabItemSchema);
 var clarifyThemePresetSchema = z.enum(["default", "base"]);
 var clarifyThemeModeColorValueSchema = z.object({
 	light: z.string().optional(),
 	dark: z.string().optional()
-});
+}).strict();
 var clarifyThemeColorValueSchema = z.union([z.string(), clarifyThemeModeColorValueSchema]);
 var clarifyThemeColorTokensConfigSchema = z.object({
 	primary: clarifyThemeColorValueSchema.optional(),
@@ -882,42 +934,65 @@ var clarifyThemeColorTokensConfigSchema = z.object({
 	muted: clarifyThemeColorValueSchema.optional(),
 	border: clarifyThemeColorValueSchema.optional(),
 	codeBackground: clarifyThemeColorValueSchema.optional()
-});
+}).strict();
 var clarifyThemeRadiusTokensConfigSchema = z.object({
 	sm: z.string().optional(),
 	md: z.string().optional(),
 	lg: z.string().optional(),
 	xl: z.string().optional()
-});
+}).strict();
 var clarifyThemeTokensConfigSchema = z.object({
 	colors: clarifyThemeColorTokensConfigSchema.optional(),
 	radius: clarifyThemeRadiusTokensConfigSchema.optional()
-});
-var clarifyThemeLayoutConfigSchema = z.object({ maxWidth: z.string().optional() });
+}).strict();
+var clarifyThemeLayoutConfigSchema = z.object({ maxWidth: z.string().optional() }).strict();
 var clarifyThemeConfigSchema = z.object({
 	preset: clarifyThemePresetSchema.optional(),
 	tokens: clarifyThemeTokensConfigSchema.optional(),
-	layout: clarifyThemeLayoutConfigSchema.optional(),
-	editor: z.boolean().optional()
-});
+	layout: clarifyThemeLayoutConfigSchema.optional()
+}).strict();
+function featureSchema(shape, defaults) {
+	const objectSchema = z.object({
+		enabled: z.boolean().default(true),
+		...shape
+	}).strict().default({
+		enabled: true,
+		...defaults
+	});
+	return z.union([z.boolean(), objectSchema]).default({
+		enabled: true,
+		...defaults
+	}).transform((value) => typeof value === "boolean" ? {
+		enabled: value,
+		...defaults
+	} : value);
+}
+var clarifyFeaturesConfigSchema = z.object({
+	search: featureSchema({ provider: z.literal("pagefind").default("pagefind") }, { provider: "pagefind" }),
+	repository: featureSchema(clarifyRepositoryConfigSchema.shape, {}),
+	themeEditor: featureSchema({}, {}),
+	openapi: featureSchema({ playground: z.boolean().default(true) }, { playground: true })
+}).strict();
 var clarifyProjectConfigSchema = z.object({
 	title: z.string().optional(),
 	description: z.string().optional(),
 	siteUrl: z.string().optional(),
-	source: clarifySourceConfigSchema.optional(),
+	routePrefix: z.string().default("/"),
+	assetPrefix: z.string().optional(),
 	logo: clarifyLogoConfigSchema.optional(),
 	homeUrl: z.string().optional(),
 	favicon: clarifyFaviconConfigSchema.optional(),
 	theme: clarifyThemeConfigSchema.optional(),
-	routePrefix: z.string().optional(),
-	assetPrefix: z.string().optional(),
-	navbar: z.object({ links: z.array(clarifyNavbarLinkSchema).optional() }).optional(),
+	navigation: z.object({
+		links: z.array(clarifyNavbarLinkSchema).optional(),
+		tabs: clarifyTabsConfigSchema.optional()
+	}).strict().optional(),
 	banner: clarifyBannerConfigOptionsSchema.optional(),
 	footer: clarifyFooterConfigSchema.optional(),
+	locales: clarifyLocalesConfigSchema.optional(),
 	variables: clarifyVariablesConfigSchema.optional(),
-	i18n: clarifyI18nConfigSchema.optional(),
-	tabs: clarifyTabsConfigSchema.optional()
-});
+	features: clarifyFeaturesConfigSchema.optional()
+}).strict();
 //#endregion
 //#region source/core/config/config.ts
 function formatIssuePath(path) {
@@ -939,17 +1014,20 @@ function validateProjectConfig(value) {
 	if (!result.success) throw new Error(formatProjectConfigError(result.error));
 	return result.data;
 }
-function resolveI18nConfig(i18n) {
-	if (!i18n) return void 0;
-	const firstLocale = i18n.locales[0]?.code;
-	const defaultLocale = i18n.defaultLocale ?? firstLocale;
+function resolveLocalesConfig(locales) {
+	if (!locales) return void 0;
+	const firstLocale = locales.locales[0]?.code;
+	const defaultLocale = locales.default ?? firstLocale;
 	if (!defaultLocale) return void 0;
 	return {
-		defaultLocale,
-		missing: i18n.missing ?? "fallback",
-		locales: i18n.locales
+		default: defaultLocale,
+		missing: locales.missing ?? "fallback",
+		locales: locales.locales
 	};
 }
+function resolveFeaturesConfig(features = {}) {
+	return clarifyFeaturesConfigSchema.parse(features);
+}
 function resolveRoutePrefix(routePrefix) {
 	const trimmed = routePrefix?.trim();
 	if (!trimmed || trimmed === "/") return "/";
@@ -970,26 +1048,24 @@ function resolveProjectConfig(config = {}) {
 		title: config.title ?? "Clarify Docs",
 		description: config.description ?? "",
 		siteUrl: config.siteUrl,
-		source: config.source,
+		routePrefix,
+		assetPrefix: resolveAssetPrefix(config.assetPrefix, routePrefix),
 		logo: config.logo,
 		homeUrl: config.homeUrl,
 		favicon: config.favicon,
-		routePrefix,
-		assetPrefix: resolveAssetPrefix(config.assetPrefix, routePrefix),
 		theme: resolveThemeConfig(config.theme),
-		navbar: config.navbar,
+		navigation: config.navigation,
 		banner: config.banner,
 		footer: config.footer,
+		locales: resolveLocalesConfig(config.locales),
 		variables: config.variables ?? {},
-		i18n: resolveI18nConfig(config.i18n),
-		tabs: config.tabs
+		features: resolveFeaturesConfig(config.features)
 	};
 }
 //#endregion
 //#region source/core/config/user-config.ts
 function defineConfig(config) {
-	validateProjectConfig(config);
-	return config;
+	return validateClarifyConfig(config);
 }
 /**
 * Config filenames Clarify CLI looks for at the project root, in resolution
@@ -1013,18 +1089,23 @@ function assertConfigObject(config, configFile) {
 }
 function loadJsonConfig(configFile) {
 	const config = assertConfigObject(JSON.parse(readFileSync(configFile, "utf-8")), configFile);
-	const projectConfig = validateProjectConfig(config);
-	const ssg = config.ssg && typeof config.ssg === "object" && !Array.isArray(config.ssg) ? config.ssg : void 0;
-	return {
+	if ("plugins" in config) throw new Error("[clarify] clarify.json does not support plugins; use clarify.ts or clarify.js");
+	return validateClarifyConfig(config);
+}
+function validateClarifyConfig(config) {
+	const { plugins, ...projectConfigInput } = config;
+	if (plugins !== void 0 && !Array.isArray(plugins)) throw new Error("[clarify] config field \"plugins\" is invalid: Expected an array");
+	const projectConfig = validateProjectConfig(projectConfigInput);
+	return plugins ? {
 		...projectConfig,
-		...ssg ? { ssg } : {}
-	};
+		plugins
+	} : projectConfig;
 }
 async function loadClarifyConfig(root, env) {
 	const configFile = findClarifyConfigFile(root);
 	if (!configFile) return {};
 	if (configFile.endsWith(".json")) return loadJsonConfig(configFile);
-	return assertConfigObject((await loadConfigFromFile(env, configFile, root, "silent"))?.config, configFile);
+	return validateClarifyConfig(assertConfigObject((await loadConfigFromFile(env, configFile, root, "silent"))?.config, configFile));
 }
 /**
 * File extensions Clarify treats as content files. Kept in sync with the
@@ -1050,9 +1131,9 @@ function buildProjectInfo(context) {
 		contentRoot: (contentRoot.startsWith(projectRoot) ? contentRoot.slice(projectRoot.length).replace(/^[/\\]+/, "") : contentRoot) || "source",
 		projectRoot
 	};
-	if (projectConfig.i18n) response.i18n = {
-		defaultLocale: projectConfig.i18n.defaultLocale,
-		locales: projectConfig.i18n.locales.map((l) => l.code)
+	if (projectConfig.locales) response.locales = {
+		default: projectConfig.locales.default,
+		locales: projectConfig.locales.locales.map((l) => l.code)
 	};
 	return response;
 }
@@ -1112,10 +1193,23 @@ function resolveVirtualModuleId(id, modules, routes) {
 	if (route) return resolveVirtualId(route.module.virtualModuleId);
 	return null;
 }
-function generateConfigModule(projectConfig, buildOptions, version) {
+function generateConfigModule(projectConfig, version) {
 	const runtimeConfig = {
-		...projectConfig,
-		...buildOptions
+		title: projectConfig.title,
+		description: projectConfig.description,
+		siteUrl: projectConfig.siteUrl,
+		routePrefix: projectConfig.routePrefix,
+		assetPrefix: projectConfig.assetPrefix,
+		logo: projectConfig.logo,
+		homeUrl: projectConfig.homeUrl,
+		favicon: projectConfig.favicon,
+		theme: projectConfig.theme,
+		navigation: projectConfig.navigation,
+		banner: projectConfig.banner,
+		footer: projectConfig.footer,
+		locales: projectConfig.locales,
+		variables: projectConfig.variables,
+		features: projectConfig.features
 	};
 	if (version) runtimeConfig.version = version;
 	return `export const config = ${JSON.stringify(runtimeConfig)};`;
@@ -1207,16 +1301,10 @@ function createRuntimeSlotsModule(plugins = [], root = process.cwd()) {
 	}
 	return `export const runtimeSlots = {\n${[...grouped.entries()].map(([name, list]) => `  ${JSON.stringify(name)}: [\n    ${list.join(",\n    ")}\n  ]`).join(",\n")}\n};\n`;
 }
-function generateMdxErrorModule(diagnostic) {
+function generateContentDiagnosticModule(diagnostic) {
 	return `import { createContentDiagnosticComponent } from '@clarify-labs/renderer';
 
-export const contentDiagnostic = ${JSON.stringify({
-		kind: diagnostic.kind ?? "mdx",
-		title: diagnostic.title,
-		message: diagnostic.message,
-		filePath: diagnostic.filePath,
-		details: diagnostic.details
-	})};
+export const contentDiagnostic = ${JSON.stringify(diagnostic)};
 
 export default createContentDiagnosticComponent(contentDiagnostic);
 `;
@@ -1225,7 +1313,7 @@ function buildVirtualModules(args) {
 	const modules = /* @__PURE__ */ new Map();
 	const clientEntryModule = createClientEntryModule({ themeEditor: args.themeEditor });
 	const allPlugins = [...args.plugins ?? []];
-	modules.set(VIRTUAL_CONFIG, generateConfigModule(args.projectConfig, args.generateOptions, args.version));
+	modules.set(VIRTUAL_CONFIG, generateConfigModule(args.projectConfig, args.version));
 	modules.set(VIRTUAL_ROUTES, generateRoutesModule(args.routes, args.navigation, "client"));
 	modules.set(VIRTUAL_SERVER_ROUTES, generateRoutesModule(args.routes, args.navigation, "server"));
 	modules.set(VIRTUAL_SLOTS, createRuntimeSlotsModule(allPlugins, args.generateOptions.projectRoot));
@@ -1234,7 +1322,7 @@ function buildVirtualModules(args) {
 	modules.set(VIRTUAL_CLIENT_ENTRY, clientEntryModule);
 	modules.set(RESOLVED_CLIENT_ENTRY, clientEntryModule);
 	for (const route of args.routes) {
-		const moduleContent = route.diagnostic ? generateMdxErrorModule(route.diagnostic) : `export { default } from ${moduleSpecifier(route.source.filePath)};`;
+		const moduleContent = route.diagnostic ? generateContentDiagnosticModule(route.diagnostic) : `export { default } from ${moduleSpecifier(route.source.filePath)};`;
 		modules.set(route.module.virtualModuleId, moduleContent);
 	}
 	return modules;
@@ -1285,26 +1373,42 @@ function createNormalizedContentPlugin(engine) {
 		}
 	};
 }
-function createMdxPlugin() {
-	return mdxPlugin({
-		include: ["**/*.mdx"],
-		format: "mdx",
-		jsxImportSource: "react",
-		providerImportSource: "@clarify-labs/renderer",
-		remarkPlugins,
-		rehypePlugins
-	});
+function createContentCompileTransform(transform, format, projectRoot, errorPolicy = () => "diagnostic") {
+	return async function contentCompileTransform(code, id) {
+		try {
+			return await transform.call(this, code, id);
+		} catch (error) {
+			if (errorPolicy() === "throw") throw error;
+			return {
+				code: generateContentDiagnosticModule(createContentCompileDiagnostic({
+					format,
+					phase: "compilation",
+					error,
+					filePath: id.replace(/\?.*$/, ""),
+					projectRoot
+				})),
+				map: null
+			};
+		}
+	};
 }
-function createMarkdownPlugin() {
-	return mdxPlugin({
-		include: ["**/*.md"],
-		format: "md",
+function createContentCompilerPlugin(format, projectRoot, errorPolicy) {
+	const markdown = format === "markdown";
+	const plugin = mdxPlugin({
+		include: [markdown ? "**/*.md" : "**/*.mdx"],
+		format: markdown ? "md" : "mdx",
 		jsxImportSource: "react",
 		providerImportSource: "@clarify-labs/renderer",
 		remarkPlugins,
-		remarkRehypeOptions: { allowDangerousHtml: true },
-		rehypePlugins: [rehypeRaw, ...rehypePlugins]
+		...markdown ? { remarkRehypeOptions: { allowDangerousHtml: true } } : {},
+		rehypePlugins: markdown ? [rehypeRaw, ...rehypePlugins] : rehypePlugins
 	});
+	const transform = typeof plugin.transform === "function" ? plugin.transform : plugin.transform?.handler;
+	if (!transform) return plugin;
+	return {
+		...plugin,
+		transform: createContentCompileTransform(transform, format, projectRoot, errorPolicy)
+	};
 }
 function createClarifyViteCorePlugin(engine, normalizedContentPlugin, markdown, mdx) {
 	let viteConfig;
@@ -1426,13 +1530,22 @@ function createClarifyViteCorePlugin(engine, normalizedContentPlugin, markdown,
 * site itself - it only bridges Vite lifecycle hooks to the engine.
 */
 function createViteAdapter(engine) {
+	let contentCompileErrorPolicy = "diagnostic";
+	const errorPolicy = () => contentCompileErrorPolicy;
 	const normalizedContentPlugin = createNormalizedContentPlugin(engine);
-	const markdown = createMarkdownPlugin();
-	const mdx = createMdxPlugin();
+	const markdown = createContentCompilerPlugin("markdown", engine.root, errorPolicy);
+	const mdx = createContentCompilerPlugin("mdx", engine.root, errorPolicy);
+	const compilePolicyPlugin = {
+		name: "clarify:content-compile-policy",
+		configResolved(config) {
+			contentCompileErrorPolicy = config.command === "build" ? "throw" : "diagnostic";
+		}
+	};
 	const tailwind = tailwindcss();
 	return [
 		...react(),
 		...Array.isArray(tailwind) ? tailwind : [tailwind],
+		compilePolicyPlugin,
 		normalizedContentPlugin,
 		createClarifyViteCorePlugin(engine, normalizedContentPlugin, markdown, mdx),
 		markdown,
@@ -1441,7 +1554,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.10.2",
+	version: "0.11.0",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -1521,8 +1634,7 @@ function resolveBuildOptions(options = {}) {
 	return {
 		projectRoot: options.projectRoot ?? process.cwd(),
 		rootDirectory: options.rootDirectory ?? "source",
-		outputDirectory: options.outputDirectory,
-		ssg: { failOnError: options.ssg?.failOnError ?? true }
+		outputDirectory: options.outputDirectory
 	};
 }
 //#endregion
@@ -1580,7 +1692,7 @@ function llmsTxtListItem(route, basePath) {
 	return description ? `- [${route.meta.title}](${basePath}${contentArtifactUrl}): ${description}` : `- [${route.meta.title}](${basePath}${contentArtifactUrl})`;
 }
 function llmsTxtLocaleLabel(locale, projectConfig) {
-	return projectConfig.i18n?.locales.find((item) => item.code === locale)?.label ?? locale;
+	return projectConfig.locales?.locales.find((item) => item.code === locale)?.label ?? locale;
 }
 function groupRoutesByLocale(routes) {
 	const groups = /* @__PURE__ */ new Map();
@@ -1592,7 +1704,7 @@ function groupRoutesByLocale(routes) {
 }
 function groupLlmsTxtRoutesByLocale(routes, projectConfig) {
 	const routesBySource = /* @__PURE__ */ new Map();
-	const defaultLocale = projectConfig.i18n?.defaultLocale;
+	const defaultLocale = projectConfig.locales?.default;
 	for (const route of routes) {
 		const sourceKey = `${route.locale ?? defaultLocale ?? "default"}:${route.basePath ?? route.artifacts?.contentArtifactUrl ?? route.path}`;
 		const previousRoute = routesBySource.get(sourceKey);
@@ -1794,9 +1906,6 @@ var OPENAPI_HTTP_METHODS = [
 	"trace"
 ];
 var CLARIFY_OPENAPI_SECTION_ID_EXTENSION = "x-clarify-section-id";
-function errorMessage(error) {
-	return error instanceof Error ? error.message : String(error);
-}
 function isSameOpenAPIFile(url, filePath) {
 	try {
 		return resolve(fileURLToPath(url)) === resolve(filePath);
@@ -1911,7 +2020,7 @@ function extractOpenAPISections(spec, filterTags) {
 	}
 	return sections;
 }
-async function readOpenAPISpec(filePath, contentProcessor) {
+async function readOpenAPISpec(filePath, contentProcessor, projectRoot) {
 	try {
 		if (!contentProcessor) return {
 			ok: true,
@@ -1934,13 +2043,14 @@ async function readOpenAPISpec(filePath, contentProcessor) {
 	} catch (error) {
 		return {
 			ok: false,
-			diagnostic: {
+			diagnostic: createContentDiagnostic({
 				kind: "openapi",
 				title: "OpenAPI spec parse failed",
-				message: `Clarify could not parse ${filePath}.`,
+				message: "Clarify could not parse this OpenAPI specification.",
+				error,
 				filePath,
-				details: errorMessage(error)
-			}
+				projectRoot
+			})
 		};
 	}
 }
@@ -1971,32 +2081,25 @@ export const routeData = {};
 export default createOpenApiRouteComponent({ ...routeData, spec });
 `;
 }
-function generateOpenAPIErrorModule(diagnostic) {
-	return `import { createContentDiagnosticComponent } from '@clarify-labs/renderer';
-
-export const contentDiagnostic = ${JSON.stringify({
-		kind: diagnostic.kind ?? "openapi",
-		title: diagnostic.title,
-		message: diagnostic.message,
-		filePath: diagnostic.filePath,
-		details: diagnostic.details
-	})};
-
-export default createContentDiagnosticComponent(contentDiagnostic);
-`;
-}
 //#endregion
 //#region source/plugins/openapi/index.ts
 function collectOpenAPIPageIntents(config) {
 	const intents = [];
-	function visitPages(pages) {
-		if (!pages || pages === "FileTree") return;
-		for (const group of pages) for (const item of group.pages) {
+	function visitItems(items) {
+		for (const item of items) {
+			if (typeof item !== "string" && "group" in item) {
+				visitItems(item.pages);
+				continue;
+			}
 			const intent = routeIntentFromPagesItem(item);
 			if (intent.kind === "openapi" && (intent.path || intent.tagFilter?.length)) intents.push(intent);
 		}
 	}
-	for (const tab of config.tabs ?? []) visitPages(tab.pages);
+	function visitPages(pages) {
+		if (!pages || pages === "FileTree") return;
+		for (const group of pages) visitItems(group.pages);
+	}
+	for (const tab of config.navigation?.tabs ?? []) visitPages(tab.pages);
 	return intents;
 }
 function virtualModuleIdFromPath(path) {
@@ -2019,14 +2122,14 @@ function cloneOpenAPIRoute(route, overrides = {}) {
 		...overrides
 	};
 }
-function findOpenAPIRoutesForContentRoot(contentRoot, i18n) {
-	if (!i18n) return findOpenAPIRoutes(contentRoot);
+function findOpenAPIRoutesForContentRoot(contentRoot, locales) {
+	if (!locales) return findOpenAPIRoutes(contentRoot);
 	const localizedRoutes = [];
-	for (const locale of i18n.locales) {
+	for (const locale of locales.locales) {
 		const localeRoot = join(contentRoot, locale.code);
 		for (const route of findOpenAPIRoutes(localeRoot, localeRoot)) {
 			const basePath = route.basePath ?? route.path;
-			const path = localizedRoutePath(basePath, locale.code, i18n);
+			const path = localizedRoutePath(basePath, locale.code, locales);
 			localizedRoutes.push({
 				...route,
 				path,
@@ -2036,15 +2139,15 @@ function findOpenAPIRoutesForContentRoot(contentRoot, i18n) {
 			});
 		}
 	}
-	if (i18n.missing === "fallback") {
+	if (locales.missing === "fallback") {
 		const routeByLocaleAndBase = new Map(localizedRoutes.map((route) => [`${route.locale ?? ""}:${route.basePath ?? route.path}`, route]));
-		const defaultRoutes = localizedRoutes.filter((route) => route.locale === i18n.defaultLocale);
+		const defaultRoutes = localizedRoutes.filter((route) => route.locale === locales.default);
 		for (const sourceRoute of defaultRoutes) {
 			const basePath = sourceRoute.basePath ?? sourceRoute.path;
-			for (const locale of i18n.locales) {
+			for (const locale of locales.locales) {
 				const key = `${locale.code}:${basePath}`;
 				if (routeByLocaleAndBase.has(key)) continue;
-				const path = localizedRoutePath(basePath, locale.code, i18n);
+				const path = localizedRoutePath(basePath, locale.code, locales);
 				localizedRoutes.push(cloneOpenAPIRoute(sourceRoute, {
 					path,
 					locale: locale.code,
@@ -2071,7 +2174,7 @@ function createConfiguredOpenAPIRoutes(routes, config) {
 			const key = `${route.locale ?? ""}:${targetBasePath}`;
 			if (existingKeys.has(key)) continue;
 			existingKeys.add(key);
-			const path = route.locale && config.i18n ? localizedRoutePath(targetBasePath, route.locale, config.i18n) : targetBasePath;
+			const path = route.locale && config.locales ? localizedRoutePath(targetBasePath, route.locale, config.locales) : targetBasePath;
 			additions.push(cloneOpenAPIRoute(route, {
 				path,
 				basePath: targetBasePath,
@@ -2084,12 +2187,12 @@ function createConfiguredOpenAPIRoutes(routes, config) {
 		}
 	}
 	const nextRoutes = [...routes, ...additions];
-	if (!config.i18n) return nextRoutes;
-	const routesWithAlternates = nextRoutes.map((route) => withAlternates(route, nextRoutes, config.i18n));
+	if (!config.locales) return nextRoutes;
+	const routesWithAlternates = nextRoutes.map((route) => withAlternates(route, nextRoutes, config.locales));
 	const bareAliases = [];
 	const seenBare = new Set(routesWithAlternates.map((route) => route.path));
 	for (const route of routesWithAlternates) {
-		if (route.locale !== config.i18n.defaultLocale) continue;
+		if (route.locale !== config.locales.default) continue;
 		const basePath = route.basePath ?? route.path;
 		if (basePath === route.path || seenBare.has(basePath)) continue;
 		seenBare.add(basePath);
@@ -2128,7 +2231,7 @@ function createOpenAPIPlugin() {
 		hooks: {
 			"routes:discover": (input, ctx) => ({
 				...input,
-				routes: [...input.routes, ...findOpenAPIRoutesForContentRoot(input.contentRoot, ctx.projectConfig.i18n)]
+				routes: [...input.routes, ...findOpenAPIRoutesForContentRoot(input.contentRoot, ctx.projectConfig.locales)]
 			}),
 			"routes:discovered": async (routes, ctx) => {
 				specs.clear();
@@ -2141,7 +2244,7 @@ function createOpenAPIPlugin() {
 					const result = specFromCache ? {
 						ok: true,
 						spec: specFromCache
-					} : await readOpenAPISpec(route.source.filePath, processor);
+					} : await readOpenAPISpec(route.source.filePath, processor, ctx.generateOptions.projectRoot);
 					if (!result.ok) {
 						route.diagnostic = result.diagnostic;
 						route.meta.title = route.meta.title || "OpenAPI parse error";
@@ -2188,7 +2291,7 @@ function createOpenAPIPlugin() {
 				for (const [routeSpecModuleId, spec] of specModules) modules.set(specVirtualModuleId(routeSpecModuleId), generateOpenAPISpecModule(spec));
 				for (const route of ctx.routes) {
 					if (route.kind !== "openapi") continue;
-					if (route.diagnostic) modules.set(route.module.virtualModuleId, generateOpenAPIErrorModule(route.diagnostic));
+					if (route.diagnostic) modules.set(route.module.virtualModuleId, generateContentDiagnosticModule(route.diagnostic));
 					else if (route.openapi?.sourceSpecId) {
 						const routeSpecModuleId = route.openapi.routeSpecModuleId ?? route.openapi.sourceSpecId;
 						if (!specModules.has(routeSpecModuleId)) continue;
@@ -2285,7 +2388,7 @@ async function generateDevSearchIndex(ctx, root, pagefind) {
 			const result = await index.addCustomRecord({
 				url: route.path,
 				content,
-				language: toPagefindLanguage(route.locale ?? ctx.projectConfig.i18n?.defaultLocale),
+				language: toPagefindLanguage(route.locale ?? ctx.projectConfig.locales?.default),
 				meta: { title: route.meta.title }
 			});
 			assertNoPagefindErrors(`addCustomRecord ${route.path}`, result.errors);
@@ -2328,6 +2431,7 @@ function createSearchIndexPlugin() {
 		name: "clarify:search-index",
 		hooks: {
 			async "dev:configureServer"(server, ctx) {
+				if (!ctx.projectConfig.features.search.enabled) return;
 				const pagefind = await import("pagefind");
 				let currentRoot;
 				const staleRoots = /* @__PURE__ */ new Set();
@@ -2367,6 +2471,7 @@ function createSearchIndexPlugin() {
 				});
 			},
 			async "build:done"(ctx) {
+				if (!ctx.projectConfig.features.search.enabled) return;
 				const outputDirectory = ctx.generateOptions.outputDirectory;
 				if (!outputDirectory) return;
 				const pageCount = await generatePagefindIndex({ outputRoot: resolve(ctx.generateOptions.projectRoot, outputDirectory) });
@@ -2419,16 +2524,18 @@ function createSeoPlugin() {
 	return {
 		name: "clarify:seo",
 		hooks: { "build:assets"(ctx) {
+			const assets = [];
 			const sitemap = createSitemapXml(ctx.routes, ctx.projectConfig);
 			const robots = createRobotsTxt(ctx.projectConfig);
-			if (!sitemap || !robots) return [];
-			return [{
+			if (sitemap) assets.push({
 				fileName: "sitemap.xml",
 				source: sitemap
-			}, {
+			});
+			if (robots) assets.push({
 				fileName: "robots.txt",
 				source: robots
-			}];
+			});
+			return assets;
 		} }
 	};
 }
@@ -2444,7 +2551,8 @@ function encodePath(path) {
 	return path.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
 }
 function createSourceEditUrl(filePath, contentRoot, source) {
-	const repository = normalizeRepositoryUrl(source.repository);
+	if (!source.url) return "";
+	const repository = normalizeRepositoryUrl(source.url);
 	const branch = source.branch ?? "main";
 	const sourcePath = [source.directory ? trimSlashes(source.directory) : "", relative(contentRoot, filePath).replaceAll("\\", "/")].filter(Boolean).join("/");
 	return `${repository}/edit/${encodeURIComponent(branch)}/${encodePath(sourcePath)}`;
@@ -2462,7 +2570,8 @@ function createSourceLinksPlugin() {
 	return {
 		name: "clarify:source-links",
 		hooks: { "routes:discovered": (routes, ctx) => {
-			attachSourceEditUrls(routes, join(ctx.generateOptions.projectRoot, ctx.generateOptions.rootDirectory), ctx.projectConfig.source);
+			if (!ctx.projectConfig.features.repository.enabled) return routes;
+			attachSourceEditUrls(routes, join(ctx.generateOptions.projectRoot, ctx.generateOptions.rootDirectory), ctx.projectConfig.features.repository);
 			return routes;
 		} }
 	};
@@ -2577,18 +2686,18 @@ async function resolveProjectContext(options = {}, env = {
 }) {
 	const projectRoot = resolve(options.projectRoot ?? process.cwd());
 	const initialBuildOptions = resolveBuildOptions(options);
-	const contentRoot = join(projectRoot, initialBuildOptions.rootDirectory);
 	const configFilePath = findClarifyConfigFile(projectRoot);
 	const config = configFilePath && existsSync(configFilePath) ? await loadClarifyConfig(projectRoot, env) : {};
 	const mergedOptions = {
 		...config,
 		...options,
 		projectRoot,
-		rootDirectory: initialBuildOptions.rootDirectory,
-		outputDirectory: initialBuildOptions.outputDirectory
+		rootDirectory: options.rootDirectory ?? initialBuildOptions.rootDirectory,
+		outputDirectory: options.outputDirectory ?? initialBuildOptions.outputDirectory
 	};
 	const resolvedProjectConfig = resolveProjectConfig(mergedOptions);
 	const resolvedBuildOptions = resolveBuildOptions(mergedOptions);
+	const contentRoot = join(projectRoot, resolvedBuildOptions.rootDirectory);
 	return {
 		projectRoot,
 		contentRoot,
@@ -2678,9 +2787,9 @@ function canonicalUrl(contextOrConfig, route) {
 /** Inject `lang` (and optional `dir`) onto the `<html>` tag for the route locale. */
 function injectHtmlLocaleAttributes(html, contextOrConfig, route) {
 	const projectConfig = resolveProjectConfigFromContext(contextOrConfig);
-	const localeCode = route?.locale ?? projectConfig.i18n?.defaultLocale;
+	const localeCode = route?.locale ?? projectConfig.locales?.default;
 	if (!localeCode) return html;
-	const dir = (projectConfig.i18n?.locales.find((locale) => locale.code === localeCode))?.dir;
+	const dir = (projectConfig.locales?.locales.find((locale) => locale.code === localeCode))?.dir;
 	return html.replace(/<html\b([^>]*)>/i, (_match, attributes) => {
 		let nextAttributes = attributes.replace(/\s+lang=("[^"]*"|'[^']*'|[^\s>]*)/i, "").replace(/\s+dir=("[^"]*"|'[^']*'|[^\s>]*)/i, "");
 		nextAttributes = `${nextAttributes} lang="${escapeHtml(localeCode)}"`;
@@ -2858,7 +2967,7 @@ async function buildSSRBundle(root, ssrEntry, ssrOutDir, plugins) {
 		}
 	});
 }
-async function renderSSGRoutes(routes, contextOrConfig, outputDirectory, ssrBundlePath, failOnError = true) {
+async function renderSSGRoutes(routes, contextOrConfig, outputDirectory, ssrBundlePath) {
 	const { render } = await import(pathToFileURL(ssrBundlePath).href);
 	const template = readIndexHtml(outputDirectory);
 	if (!template) throw new Error(`[clarify] index.html not found in outputDirectory "${outputDirectory}". Make sure Vite build produces it.`);
@@ -2870,7 +2979,7 @@ async function renderSSGRoutes(routes, contextOrConfig, outputDirectory, ssrBund
 		}
 	} catch (err) {
 		console.error(`[clarify] Failed to render route "${route.path}":`, err);
-		if (failOnError) throw err;
+		throw err;
 	}
 }
 //#endregion
@@ -2947,10 +3056,10 @@ var ClarifyContext = class {
 		this.currentPlugins = plugins;
 	}
 	get isI18n() {
-		return Boolean(this.projectConfig.i18n);
+		return Boolean(this.projectConfig.locales);
 	}
 	get defaultLocale() {
-		return this.projectConfig.i18n?.defaultLocale;
+		return this.projectConfig.locales?.default;
 	}
 	get(key) {
 		return this.values.get(key);
@@ -3020,6 +3129,12 @@ function loadVirtualModule(id, modules) {
 	const bareId = stripVirtualPrefix(id);
 	return modules.get(bareId) ?? modules.get(id) ?? null;
 }
+function assertNoContentDiagnostics(routes) {
+	const failures = routes.filter((route) => route.diagnostic);
+	if (failures.length === 0) return;
+	const summary = failures.map((route) => `- ${route.path}: ${route.diagnostic?.title ?? "Content error"}${route.diagnostic?.filePath ? ` (${route.diagnostic.filePath})` : ""}`).join("\n");
+	throw new Error(`[clarify] Content diagnostics prevented the build:\n${summary}`);
+}
 var ClarifyEngine = class {
 	options;
 	root;
@@ -3138,10 +3253,10 @@ var ClarifyEngine = class {
 	async discoverSite() {
 		const plugins = this.ctx.plugins;
 		const contentRoot = this.ctx.contentRoot;
-		const { i18n, tabs } = this.ctx.projectConfig;
+		const { locales, navigation: navigationConfig } = this.ctx.projectConfig;
 		let routes = await runPhase(plugins, "site:discover", this.ctx, async () => {
 			const options = { contentProcessor: createProjectContentProcessor(plugins, this.ctx) };
-			const discovered = i18n ? await findLocalizedContentRoutes(contentRoot, i18n, options) : await findContentRoutes(contentRoot, contentRoot, options);
+			const discovered = locales ? await findLocalizedContentRoutes(contentRoot, locales, options) : await findContentRoutes(contentRoot, contentRoot, options);
 			const result = await runHooks(plugins, "routes:discover", {
 				contentRoot,
 				routes: discovered
@@ -3170,8 +3285,9 @@ var ClarifyEngine = class {
 				};
 			});
 		});
-		routes = applyConfiguredPageRoutePaths(routes, tabs, i18n);
-		const navigation = tabs ? i18n ? buildLocalizedNavigationFromTabsConfig(routes, tabs, i18n) ?? {
+		const tabs = navigationConfig?.tabs;
+		routes = applyConfiguredPageRoutePaths(routes, tabs, locales);
+		const navigation = tabs ? locales ? buildLocalizedNavigationFromTabsConfig(routes, tabs, locales) ?? {
 			kind: "localized-tabbed",
 			locales: {}
 		} : buildNavigationFromTabsConfig(routes, tabs) : {
@@ -3201,7 +3317,7 @@ var ClarifyEngine = class {
 				routes: this.routes,
 				navigation: this.navigation,
 				plugins: this.plugins,
-				themeEditor: this.runtime.command === "serve" || this.runtime.themeEditor === true || this.projectConfig.theme.editor,
+				themeEditor: this.runtime.command === "serve" || this.runtime.themeEditor === true || this.projectConfig.features.themeEditor.enabled,
 				version: this.ctx.version
 			});
 			this.virtualModules = await runHooks(this.plugins, "modules:before", this.virtualModules, this.ctx);
@@ -3244,6 +3360,7 @@ var ClarifyEngine = class {
 		await runPhase(this.plugins, "ssg", this.ctx, async () => {
 			if (process.env.SKIP_CLARIFY_SSG) return;
 			if (!await runInterceptHooks(this.plugins, "ssg:shouldRun", this.ctx)) return;
+			assertNoContentDiagnostics(this.routes);
 			const outputDir = this.runtime.outputDirectory ?? this.generateOptions.outputDirectory;
 			if (!outputDir) throw new Error("[clarify] outputDirectory is required before SSG runs");
 			const ssrOutputDir = join(outputDir, ".ssr");
@@ -3257,10 +3374,10 @@ var ClarifyEngine = class {
 					plugins: this.runtime.ssrPlugins ?? []
 				});
 				const ssrBundlePath = join(ssrOutputDir, "entry-server.js");
-				await renderSSGRoutes(this.routes, this.runtimeContext(), outputDir, ssrBundlePath, this.generateOptions.ssg.failOnError);
+				await renderSSGRoutes(this.routes, this.runtimeContext(), outputDir, ssrBundlePath);
 			} catch (err) {
 				console.error("[clarify] SSG failed:", err);
-				if (this.generateOptions.ssg.failOnError) throw err;
+				throw err;
 			} finally {
 				if (tempEntryPath) try {
 					rmSync(tempEntryPath, { force: true });
@@ -3304,4 +3421,4 @@ function createClarifyEngine(options = {}) {
 //#endregion
 export { cliPackageVersion as a, defineConfig as c, createClarifyTempDir as i, createClarifyEngine as n, cliPackageVersionWithCaret as o, createClarifyRuntimeAliases as r, createViteAdapter as s, ClarifyEngine as t };
 
-//# sourceMappingURL=engine-CSSL_gGd.js.map
+//# sourceMappingURL=engine-DfF5RJjC.js.map