@clarify-labs/cli 0.10.3 → 0.11.0

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

@@ -379,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]] : [];
 	}));
@@ -395,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);
@@ -411,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 = [];
@@ -523,7 +523,7 @@ function collectExplicitPagePathIntents(tabs) {
 	}
 	return intents;
 }
-function applyConfiguredPageRoutePaths(routes, tabs, i18n) {
+function applyConfiguredPageRoutePaths(routes, tabs, locales) {
 	const pageIntents = collectExplicitPagePathIntents(tabs);
 	if (!pageIntents.length) return routes;
 	const additions = [];
@@ -539,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);
@@ -610,25 +610,25 @@ 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]));
 	const buildItem = (item) => {
 		if (typeof item !== "string" && "group" in item) {
 			const children = item.pages.map(buildItem);
 			return {
 				path: firstNavigationPath(children),
-				title: resolveLocalizedText(item.group, locale, i18n.defaultLocale) ?? "",
+				title: resolveLocalizedText(item.group, locale, locales.default) ?? "",
 				icon: item.icon,
 				children
 			};
@@ -636,10 +636,10 @@ function buildLocalizedNavigationForLocale(routes, config, locale, i18n) {
 		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 path = route?.path ?? localizedRoutePath(basePath, locale, locales);
 		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),
+			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
 		};
@@ -647,24 +647,24 @@ function buildLocalizedNavigationForLocale(routes, config, locale, i18n) {
 	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
 			};
@@ -731,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;
@@ -784,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;
 	}
@@ -815,8 +815,7 @@ function resolveThemeConfig(theme = {}) {
 		layout: {
 			...presetTheme.layout,
 			...theme.layout
-		},
-		editor: theme.editor ?? presetTheme.editor
+		}
 	};
 }
 //#endregion
@@ -824,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({
@@ -857,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(),
@@ -885,11 +884,11 @@ 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()
-});
+}).strict();
 var clarifyPagesItemSchema = z.lazy(() => z.union([
 	z.string(),
 	clarifyPagesGroupSchema,
@@ -899,32 +898,32 @@ var clarifyPagesItemSchema = z.lazy(() => z.union([
 		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()
-	})
+		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(),
@@ -935,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) {
@@ -992,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 "/";
@@ -1023,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
@@ -1066,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
@@ -1103,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;
 }
@@ -1165,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)};`;
@@ -1272,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));
@@ -1497,7 +1538,7 @@ function createViteAdapter(engine) {
 	const compilePolicyPlugin = {
 		name: "clarify:content-compile-policy",
 		configResolved(config) {
-			contentCompileErrorPolicy = config.command === "build" && engine.generateOptions.ssg.failOnError ? "throw" : "diagnostic";
+			contentCompileErrorPolicy = config.command === "build" ? "throw" : "diagnostic";
 		}
 	};
 	const tailwind = tailwindcss();
@@ -1513,7 +1554,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.10.3",
+	version: "0.11.0",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -1593,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
@@ -1652,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();
@@ -1664,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);
@@ -2059,7 +2099,7 @@ function collectOpenAPIPageIntents(config) {
 		if (!pages || pages === "FileTree") return;
 		for (const group of pages) visitItems(group.pages);
 	}
-	for (const tab of config.tabs ?? []) visitPages(tab.pages);
+	for (const tab of config.navigation?.tabs ?? []) visitPages(tab.pages);
 	return intents;
 }
 function virtualModuleIdFromPath(path) {
@@ -2082,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,
@@ -2099,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,
@@ -2134,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,
@@ -2147,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);
@@ -2191,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();
@@ -2348,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);
@@ -2391,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();
@@ -2430,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) });
@@ -2482,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;
 		} }
 	};
 }
@@ -2507,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)}`;
@@ -2525,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;
 		} }
 	};
@@ -2640,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,
@@ -2741,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)}"`;
@@ -2921,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.`);
@@ -2933,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
@@ -3010,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);
@@ -3207,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
@@ -3239,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) : {
@@ -3270,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);
@@ -3313,7 +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;
-			if (this.generateOptions.ssg.failOnError) assertNoContentDiagnostics(this.routes);
+			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");
@@ -3327,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 });
@@ -3374,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-CyFtr8Pz.js.map
+//# sourceMappingURL=engine-DfF5RJjC.js.map