@clarify-labs/cli 0.8.0 → 0.9.0

package/output/{plugin-B7c0iHMy.cjs → plugin-JvxU6ZjU.cjs}

@@ -36,14 +36,14 @@ shiki = __toESM(shiki, 1);
 let unist_util_visit = require("unist-util-visit");
 let _clarify_labs_renderer = require("@clarify-labs/renderer");
 let yaml = require("yaml");
-let remark = require("remark");
 let gray_matter = require("gray-matter");
 gray_matter = __toESM(gray_matter, 1);
+let remark = require("remark");
+let node_url = require("node:url");
 let _apidevtools_swagger_parser = require("@apidevtools/swagger-parser");
 _apidevtools_swagger_parser = __toESM(_apidevtools_swagger_parser, 1);
 let node_os = require("node:os");
 let zod = require("zod");
-let node_url = require("node:url");
 let vite = require("vite");
 let node_module = require("node:module");
 //#region source/core/utils.ts
@@ -169,23 +169,76 @@ function readRouteArtifactContent(route) {
 	const content = readRouteContent(route);
 	return shouldUseUtf8Signature(route) ? withUtf8Signature(content) : content;
 }
+function isLlmsTxtRoute(route) {
+	return !route.path.split("/").includes("404");
+}
+function llmsTxtDescription(route) {
+	if (route.description) return route.description;
+	const sections = route.sections?.filter((section) => section.level === 2).slice(0, 3).map((section) => section.title);
+	if (sections?.length) return `Covers ${sections.join(", ")}.`;
+	if (route.keywords?.length) return `Related topics: ${route.keywords.join(", ")}.`;
+	if (route.kind === "openapi") return "OpenAPI artifact for machine-readable API reference data.";
+}
+function llmsTxtListItem(route, basePath) {
+	if (!route.contentArtifactUrl) return void 0;
+	const description = llmsTxtDescription(route);
+	return description ? `- [${route.title}](${basePath}${route.contentArtifactUrl}): ${description}` : `- [${route.title}](${basePath}${route.contentArtifactUrl})`;
+}
+function llmsTxtLocaleLabel(locale, projectConfig) {
+	return projectConfig.i18n?.locales.find((item) => item.code === locale)?.label ?? locale;
+}
+function groupRoutesByLocale(routes) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const route of routes) {
+		const key = route.locale ?? "default";
+		groups.set(key, [...groups.get(key) ?? [], route]);
+	}
+	return groups;
+}
+function groupLlmsTxtRoutesByLocale(routes, projectConfig) {
+	const routesBySource = /* @__PURE__ */ new Map();
+	const defaultLocale = projectConfig.i18n?.defaultLocale;
+	for (const route of routes) {
+		const sourceKey = `${route.locale ?? defaultLocale ?? "default"}:${route.basePath ?? route.contentArtifactUrl ?? route.path}`;
+		const previousRoute = routesBySource.get(sourceKey);
+		if (!previousRoute || previousRoute.locale && !route.locale) routesBySource.set(sourceKey, route);
+	}
+	return groupRoutesByLocale([...routesBySource.values()].map((route) => ({
+		...route,
+		locale: route.locale ?? defaultLocale
+	})));
+}
+function llmsTxtDocsSectionTitle(locale, groupCount, projectConfig) {
+	if (groupCount <= 1) return "Docs";
+	return `Docs - ${locale === "default" ? "Default" : llmsTxtLocaleLabel(locale, projectConfig)}`;
+}
 function createLlmsTxt(routes, projectConfig) {
 	const basePath = normalizeBasePath(projectConfig.routePrefix);
 	const lines = [`# ${projectConfig.title}`, ""];
 	if (projectConfig.description) lines.push(`> ${projectConfig.description}`, "");
-	lines.push("## Docs");
-	for (const route of routes.filter((route) => route.kind === "mdx")) {
-		if (!route.contentArtifactUrl) continue;
-		lines.push(`- [${route.title}](${basePath}${route.contentArtifactUrl})`);
+	lines.push("This file lists the source-ready Markdown and OpenAPI artifacts for this documentation site.", "");
+	const mdxRoutes = routes.filter((route) => route.kind === "mdx" && isLlmsTxtRoute(route));
+	if (mdxRoutes.length > 0) {
+		const localizedGroups = groupLlmsTxtRoutesByLocale(mdxRoutes, projectConfig);
+		for (const [locale, localeRoutes] of localizedGroups) {
+			lines.push(`## ${llmsTxtDocsSectionTitle(locale, localizedGroups.size, projectConfig)}`);
+			for (const route of localeRoutes) {
+				const item = llmsTxtListItem(route, basePath);
+				if (item) lines.push(item);
+			}
+			lines.push("");
+		}
 	}
-	const openApiRoutes = routes.filter((route) => route.kind === "openapi");
+	const openApiRoutes = routes.filter((route) => route.kind === "openapi" && isLlmsTxtRoute(route));
 	if (openApiRoutes.length > 0) {
-		lines.push("", "## OpenAPI");
+		if (lines.at(-1) !== "") lines.push("");
+		lines.push("## OpenAPI");
 		for (const route of openApiRoutes) {
-			if (!route.contentArtifactUrl) continue;
-			lines.push(`- [${route.title}](${basePath}${route.contentArtifactUrl})`);
+			const item = llmsTxtListItem(route, basePath);
+			if (item) lines.push(item);
 		}
 	}
+	while (lines.at(-1) === "") lines.pop();
 	return `${lines.join("\n")}\n`;
 }
 function createLlmsTxtArtifact(routes, projectConfig) {
@@ -345,6 +398,101 @@ function parseFrontmatter(content) {
 	};
 }
 //#endregion
+//#region source/parsers/content.ts
+async function transformContent(transform, input) {
+	return transform ? await transform(input) : input;
+}
+function createContentProcessor(transform) {
+	return {
+		async processMdx(source, filePath) {
+			const { frontmatter, content } = parseFrontmatter(source);
+			const transformed = await transformContent(transform, {
+				kind: "mdx",
+				source,
+				filePath,
+				frontmatter,
+				content
+			});
+			return {
+				frontmatter: transformed.frontmatter,
+				content: transformed.content
+			};
+		},
+		async processText(source, kind, filePath) {
+			return (await transformContent(transform, {
+				kind,
+				source,
+				filePath,
+				frontmatter: {},
+				content: source
+			})).content;
+		}
+	};
+}
+//#endregion
+//#region source/core/hooks.ts
+async function runHooks(plugins, hookName, input, ctx) {
+	let result = input;
+	for (const plugin of plugins) {
+		const hook = plugin.hooks?.[hookName];
+		if (!hook) continue;
+		try {
+			result = await hook(result, ctx);
+		} catch (err) {
+			throw new Error(`[clarify] plugin "${plugin.name}" hook "${hookName}" failed: ${err}`, { cause: err });
+		}
+	}
+	return result;
+}
+async function runDevConfigureServerHooks(plugins, server, ctx) {
+	for (const plugin of plugins) {
+		const hook = plugin.hooks?.["dev:configureServer"];
+		if (!hook) continue;
+		try {
+			await hook(server, ctx);
+		} catch (err) {
+			throw new Error(`[clarify] plugin "${plugin.name}" hook "dev:configureServer" failed: ${err}`, { cause: err });
+		}
+	}
+}
+async function runBuildAssetsHooks(plugins, ctx) {
+	const assets = [];
+	for (const plugin of plugins) {
+		const hook = plugin.hooks?.["build:assets"];
+		if (!hook) continue;
+		try {
+			const pluginAssets = await hook(ctx);
+			assets.push(...pluginAssets);
+		} catch (err) {
+			throw new Error(`[clarify] plugin "${plugin.name}" hook "build:assets" failed: ${err}`, { cause: err });
+		}
+	}
+	return assets;
+}
+async function runBuildDoneHooks(plugins, ctx) {
+	for (const plugin of plugins) {
+		const hook = plugin.hooks?.["build:done"];
+		if (!hook) continue;
+		try {
+			await hook(ctx);
+		} catch (err) {
+			throw new Error(`[clarify] plugin "${plugin.name}" hook "build:done" failed: ${err}`, { cause: err });
+		}
+	}
+}
+//#endregion
+//#region source/core/content.ts
+var contentProcessors = /* @__PURE__ */ new WeakMap();
+function createProjectContentProcessor(plugins, ctx) {
+	return createContentProcessor((input) => runHooks(plugins, "content:transform", input, ctx));
+}
+function setProjectContentProcessor(ctx, processor) {
+	contentProcessors.set(ctx, processor);
+}
+function getProjectContentProcessor(ctx) {
+	return contentProcessors.get(ctx);
+}
+//#endregion
 //#region source/parsers/routes.ts
 function kebabToTitle(str) {
 	return str.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
@@ -421,18 +569,19 @@ function resolveLocalizedText(text, locale, fallbackLocale) {
 	if (text === void 0) return void 0;
 	return text[locale] ?? (fallbackLocale ? text[fallbackLocale] : void 0) ?? Object.values(text)[0];
 }
-function findContentRoutes(dir, base = dir) {
+async function findContentRoutes(dir, base = dir, options = {}) {
 	const routes = [];
 	if (!(0, node_fs.existsSync)(dir)) return routes;
 	const entries = (0, node_fs.readdirSync)(dir, { withFileTypes: true });
 	for (const entry of entries) {
 		const fullPath = (0, node_path.join)(dir, entry.name);
-		if (entry.isDirectory()) routes.push(...findContentRoutes(fullPath, base));
+		if (entry.isDirectory()) routes.push(...await findContentRoutes(fullPath, base, options));
 		else if (entry.isFile() && /\.mdx?$/.test(entry.name)) {
 			const relativePath = (0, node_path.relative)(base, fullPath);
 			const pathParts = relativePath.replace(/\.mdx?$/, "").split("/");
 			const cleanPath = ("/" + pathParts.map((p) => p === "index" ? "" : p).filter(Boolean).join("/")).replace(/\/+/g, "/").replace(/\/$/, "") || "/";
-			const { frontmatter, content } = parseFrontmatter((0, node_fs.readFileSync)(fullPath, "utf-8"));
+			const source = (0, node_fs.readFileSync)(fullPath, "utf-8");
+			const { frontmatter, content } = await (options.contentProcessor ?? createContentProcessor()).processMdx(source, fullPath);
 			let title = typeof frontmatter.title === "string" ? frontmatter.title : "";
 			if (!title) {
 				const lastPart = pathParts[pathParts.length - 1] ?? "";
@@ -689,6 +838,13 @@ var OPENAPI_HTTP_METHODS = [
 function errorMessage(error) {
 	return error instanceof Error ? error.message : String(error);
 }
+function isSameOpenAPIFile(url, filePath) {
+	try {
+		return (0, node_path.resolve)((0, node_url.fileURLToPath)(url)) === (0, node_path.resolve)(filePath);
+	} catch {
+		return (0, node_path.resolve)(url) === (0, node_path.resolve)(filePath);
+	}
+}
 function findOpenAPIRoutes(dir, base = dir) {
 	const routes = [];
 	if (!(0, node_fs.existsSync)(dir)) return routes;
@@ -752,12 +908,26 @@ function extractOpenAPISections(spec, filterTags) {
 	}
 	return sections;
 }
-async function readOpenAPISpec(filePath) {
+async function readOpenAPISpec(filePath, contentProcessor) {
 	try {
-		return {
+		if (!contentProcessor) return {
 			ok: true,
 			spec: await _apidevtools_swagger_parser.default.dereference(filePath)
 		};
+		const source = (0, node_fs.readFileSync)(filePath, "utf-8");
+		const transformedSource = await contentProcessor.processText(source, "openapi", filePath);
+		if (transformedSource === source) return {
+			ok: true,
+			spec: await _apidevtools_swagger_parser.default.dereference(filePath)
+		};
+		return {
+			ok: true,
+			spec: await _apidevtools_swagger_parser.default.dereference(filePath, { resolve: { transformedOpenAPISource: {
+				order: 1,
+				canRead: (file) => isSameOpenAPIFile(file.url, filePath),
+				read: () => transformedSource
+			} } })
+		};
 	} catch (error) {
 		return {
 			ok: false,
@@ -1018,7 +1188,7 @@ function createOpenAPIPlugin() {
 					const result = specFromCache ? {
 						ok: true,
 						spec: specFromCache
-					} : await readOpenAPISpec(route.filePath);
+					} : await readOpenAPISpec(route.filePath, getProjectContentProcessor(ctx));
 					if (!result.ok) {
 						route.diagnostic = result.diagnostic;
 						route.title = route.title || "OpenAPI parse error";
@@ -1335,9 +1505,51 @@ function createSourceLinksPlugin() {
 	};
 }
 //#endregion
+//#region source/parsers/variables.ts
+var variablePattern = /{{\s*([A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*)\s*}}/g;
+function getVariableValue(variables, path) {
+	let current = variables;
+	for (const segment of path.split(".")) {
+		if (!current || typeof current !== "object" || Array.isArray(current)) return void 0;
+		current = current[segment];
+	}
+	return current;
+}
+function stringifyVariableValue(variables, path, stack) {
+	if (stack.includes(path)) throw new Error(`[clarify] variable "${path}" contains a circular reference: ${[...stack, path].join(" -> ")}`);
+	const value = getVariableValue(variables, path);
+	if (value === void 0 || typeof value === "object") return void 0;
+	if (typeof value !== "string") return String(value);
+	return value.replace(variablePattern, (match, nestedPath) => stringifyVariableValue(variables, nestedPath, [...stack, path]) ?? match);
+}
+function applyVariables(content, variables = {}) {
+	return content.replace(variablePattern, (match, path) => stringifyVariableValue(variables, path, []) ?? match);
+}
+//#endregion
+//#region source/plugins/variables/index.ts
+function applyVariablesToFrontmatter(frontmatter, variables) {
+	const nextFrontmatter = { ...frontmatter };
+	for (const key of ["title", "description"]) {
+		if (typeof nextFrontmatter[key] !== "string") continue;
+		nextFrontmatter[key] = applyVariables(nextFrontmatter[key], variables);
+	}
+	return nextFrontmatter;
+}
+function createVariablesPlugin() {
+	return {
+		name: "clarify:variables",
+		hooks: { "content:transform": (input, ctx) => ({
+			...input,
+			frontmatter: applyVariablesToFrontmatter(input.frontmatter, ctx.projectConfig.variables),
+			content: applyVariables(input.content, ctx.projectConfig.variables)
+		}) }
+	};
+}
+//#endregion
 //#region source/core/builtin.ts
 function createBuiltinPlugins(options = {}) {
 	const plugins = [
+		createVariablesPlugin(),
 		createOpenAPIPlugin(),
 		createSourceLinksPlugin(),
 		createContentArtifactsPlugin(),
@@ -1406,6 +1618,13 @@ var clarifyFooterConfigSchema = zod.z.object({
 	socials: zod.z.record(zod.z.string(), zod.z.string()).optional(),
 	copyright: clarifyLocalizedTextSchema.optional()
 }).strict();
+var clarifyVariableValueSchema = zod.z.lazy(() => zod.z.union([
+	zod.z.string(),
+	zod.z.number(),
+	zod.z.boolean(),
+	zod.z.record(zod.z.string(), clarifyVariableValueSchema)
+]));
+var clarifyVariablesConfigSchema = zod.z.record(zod.z.string(), clarifyVariableValueSchema);
 var clarifySourceConfigSchema = zod.z.object({
 	repository: zod.z.string(),
 	branch: zod.z.string().optional(),
@@ -1483,9 +1702,11 @@ var clarifyProjectConfigSchema = zod.z.object({
 	favicon: clarifyFaviconConfigSchema.optional(),
 	theme: clarifyThemeConfigSchema.optional(),
 	routePrefix: zod.z.string().optional(),
+	assetPrefix: zod.z.string().optional(),
 	navbar: zod.z.object({ links: zod.z.array(clarifyNavbarLinkSchema).optional() }).optional(),
 	banner: clarifyBannerConfigSchema.optional(),
 	footer: clarifyFooterConfigSchema.optional(),
+	variables: clarifyVariablesConfigSchema.optional(),
 	i18n: clarifyI18nConfigSchema.optional(),
 	tabs: clarifyTabsConfigSchema.optional()
 });
@@ -1545,7 +1766,22 @@ function resolveI18nConfig(i18n) {
 		locales: i18n.locales
 	};
 }
+function resolveRoutePrefix(routePrefix) {
+	const trimmed = routePrefix?.trim();
+	if (!trimmed || trimmed === "/") return "/";
+	return `/${trimmed.replace(/^\/+|\/+$/g, "")}/`;
+}
+function resolveAssetPrefix(assetPrefix, routePrefix) {
+	const trimmed = assetPrefix?.trim();
+	if (trimmed === void 0) return routePrefix;
+	if (trimmed === "./" || trimmed === "") return trimmed || "/";
+	if (!trimmed || trimmed === "/") return "/";
+	if (/^[a-z][a-z\d+.-]*:\/\//i.test(trimmed)) return trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
+	if (trimmed.startsWith("./") || trimmed.startsWith("../")) return trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
+	return `/${trimmed.replace(/^\/+|\/+$/g, "")}/`;
+}
 function resolveProjectConfig(config = {}) {
+	const routePrefix = resolveRoutePrefix(config.routePrefix);
 	return {
 		title: config.title ?? "Clarify Docs",
 		description: config.description ?? "",
@@ -1554,15 +1790,137 @@ function resolveProjectConfig(config = {}) {
 		logo: config.logo,
 		homeUrl: config.homeUrl,
 		favicon: config.favicon,
-		routePrefix: config.routePrefix ?? "/",
+		routePrefix,
+		assetPrefix: resolveAssetPrefix(config.assetPrefix, routePrefix),
 		theme: resolveThemeConfig(config.theme),
 		navbar: config.navbar,
 		banner: config.banner,
 		footer: config.footer,
+		variables: config.variables ?? {},
 		i18n: resolveI18nConfig(config.i18n),
 		tabs: config.tabs
 	};
 }
+/** Serialize a ContentRoute into the minimal shape exposed to tooling. */
+function toDevRouteEntry(route) {
+	return {
+		path: route.path,
+		filePath: route.filePath,
+		locale: route.locale,
+		basePath: route.basePath,
+		kind: route.kind,
+		title: route.title
+	};
+}
+/**
+* Resolve a single file path to its preview route.
+*
+* Selection order:
+*  1. Routes whose `filePath` exactly matches.
+*  2. Among matches, prefer the one whose `locale` matches the file's locale
+*     directory (e.g. `source/zh-CN/x.mdx` → locale `zh-CN`).
+*  3. If no locale match, fall back to the default locale (if i18n is enabled)
+*     or the first match.
+*/
+function resolveRouteForFile(filePath, routes, defaultLocale) {
+	const matches = routes.filter((r) => r.filePath === filePath);
+	if (matches.length === 0) return void 0;
+	if (matches.length === 1) return matches[0];
+	const fileLocale = inferLocaleFromPath(filePath);
+	if (fileLocale) {
+		const localeMatch = matches.find((r) => r.locale === fileLocale);
+		if (localeMatch) return localeMatch;
+	}
+	if (defaultLocale) {
+		const defaultMatch = matches.find((r) => r.locale === defaultLocale);
+		if (defaultMatch) return defaultMatch;
+	}
+	return matches[0];
+}
+/**
+* Derive a best-effort preview route for a file that is not in the route
+* manifest (e.g. a draft or newly created file). The path is computed from the
+* file's location relative to the content root, following the same convention
+* as route discovery (`source/{locale}/path/index.mdx` → `/{locale}/path`).
+*
+* Returns null when the file is outside the content root or is not a
+* recognized content file type.
+*/
+function inferRouteForFile(filePath, contentRoot, defaultLocale) {
+	const ref = (0, node_path.relative)(contentRoot, filePath);
+	if (!ref || ref.startsWith("..")) return null;
+	const isMdx = /\.mdx?$/.test(filePath);
+	const isOpenApi = /\.openapi\.(json|ya?ml)$/.test(filePath);
+	if (!isMdx && !isOpenApi) return null;
+	const segments = ref.split("/");
+	const fileLocale = inferLocaleFromPath(filePath);
+	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,
+		missing: "fallback",
+		locales: []
+	}) : basePath;
+	const title = segments[segments.length - 1]?.replace(/\.(mdx?|openapi\.(json|ya?ml))$/, "") || "Untitled";
+	return {
+		path: normalizePath(path),
+		filePath,
+		locale: fileLocale,
+		basePath: normalizePath(basePath),
+		kind: isMdx ? "mdx" : "openapi",
+		title,
+		inferred: true
+	};
+}
+/** Best-effort locale inference from a file path segment like `.../zh-CN/x.mdx`. */
+function inferLocaleFromPath(filePath) {
+	const segments = filePath.split("/");
+	for (const segment of segments) if (/^[a-z]{2,3}(-[A-Z][a-z]{3})?(-[A-Z]{2})?$/.test(segment)) return segment;
+}
+/** Read and parse the JSON body of an IncomingMessage. */
+function readJsonBody(req) {
+	return new Promise((resolveBody, reject) => {
+		const chunks = [];
+		req.on("data", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
+		req.on("error", reject);
+		req.on("end", () => {
+			const raw = Buffer.concat(chunks).toString("utf-8").trim();
+			if (!raw) return resolveBody({});
+			try {
+				resolveBody(JSON.parse(raw));
+			} catch (err) {
+				reject(err);
+			}
+		});
+	});
+}
+/**
+* Handle a request to the dev route endpoint. Pure function — does not touch
+* the network directly, only reads the request body and writes to `res`.
+*/
+async function handleDevRouteRequest(req, res, routes, projectConfig, contentRoot) {
+	res.setHeader("Content-Type", "application/json; charset=utf-8");
+	let body;
+	try {
+		body = await readJsonBody(req);
+	} catch {
+		res.statusCode = 400;
+		res.end(JSON.stringify({ error: "Invalid JSON body" }));
+		return;
+	}
+	const file = typeof body === "object" && body !== null ? body.file : void 0;
+	if (typeof file === "string" && file.length > 0) {
+		const route = resolveRouteForFile(file, routes, projectConfig.i18n?.defaultLocale);
+		if (route) {
+			res.end(JSON.stringify(toDevRouteEntry(route)));
+			return;
+		}
+		const inferred = inferRouteForFile(file, contentRoot, projectConfig.i18n?.defaultLocale);
+		res.end(JSON.stringify(inferred));
+		return;
+	}
+	res.end(JSON.stringify(routes.map(toDevRouteEntry)));
+}
 //#endregion
 //#region source/core/env-types.ts
 var GENERATED_FILE_NAME = "clarify-env.d.ts";
@@ -1612,57 +1970,6 @@ function writeClarifyEnvDts(projectRoot, plugins) {
 	(0, node_fs.writeFileSync)(filePath, next, "utf-8");
 }
 //#endregion
-//#region source/core/hooks.ts
-async function runHooks(plugins, hookName, input, ctx) {
-	let result = input;
-	for (const plugin of plugins) {
-		const hook = plugin.hooks?.[hookName];
-		if (!hook) continue;
-		try {
-			result = await hook(result, ctx);
-		} catch (err) {
-			throw new Error(`[clarify] plugin "${plugin.name}" hook "${hookName}" failed: ${err}`, { cause: err });
-		}
-	}
-	return result;
-}
-async function runDevConfigureServerHooks(plugins, server, ctx) {
-	for (const plugin of plugins) {
-		const hook = plugin.hooks?.["dev:configureServer"];
-		if (!hook) continue;
-		try {
-			await hook(server, ctx);
-		} catch (err) {
-			throw new Error(`[clarify] plugin "${plugin.name}" hook "dev:configureServer" failed: ${err}`, { cause: err });
-		}
-	}
-}
-async function runBuildAssetsHooks(plugins, ctx) {
-	const assets = [];
-	for (const plugin of plugins) {
-		const hook = plugin.hooks?.["build:assets"];
-		if (!hook) continue;
-		try {
-			const pluginAssets = await hook(ctx);
-			assets.push(...pluginAssets);
-		} catch (err) {
-			throw new Error(`[clarify] plugin "${plugin.name}" hook "build:assets" failed: ${err}`, { cause: err });
-		}
-	}
-	return assets;
-}
-async function runBuildDoneHooks(plugins, ctx) {
-	for (const plugin of plugins) {
-		const hook = plugin.hooks?.["build:done"];
-		if (!hook) continue;
-		try {
-			await hook(ctx);
-		} catch (err) {
-			throw new Error(`[clarify] plugin "${plugin.name}" hook "build:done" failed: ${err}`, { cause: err });
-		}
-	}
-}
-//#endregion
 //#region source/core/options.ts
 function resolveBuildOptions(options = {}) {
 	return {
@@ -1673,12 +1980,90 @@ function resolveBuildOptions(options = {}) {
 	};
 }
 //#endregion
+//#region source/core/user-config.ts
+function defineConfig(config) {
+	validateProjectConfig(config);
+	return config;
+}
+/**
+* Config filenames Clarify CLI looks for at the project root, in resolution
+* order. Exported so other modules (e.g. the dev `project-info` endpoint) can
+* surface the same list to tooling without duplicating it.
+*/
+var CONFIG_FILENAMES = [
+	"clarify.ts",
+	"clarify.js",
+	"clarify.json"
+];
+function findClarifyConfigFile(root) {
+	for (const filename of CONFIG_FILENAMES) {
+		const filePath = (0, node_path.resolve)(root, filename);
+		if ((0, node_fs.existsSync)(filePath)) return filePath;
+	}
+}
+function assertConfigObject(config, configFile) {
+	if (!config || typeof config !== "object" || Array.isArray(config)) throw new Error(`[clarify] ${configFile} must export a configuration object`);
+	return config;
+}
+function loadJsonConfig(configFile) {
+	const config = assertConfigObject(JSON.parse((0, node_fs.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 {
+		...projectConfig,
+		...ssg ? { ssg } : {}
+	};
+}
+async function loadClarifyConfig(root, env) {
+	const configFile = findClarifyConfigFile(root);
+	if (!configFile) return {};
+	if (configFile.endsWith(".json")) return loadJsonConfig(configFile);
+	return assertConfigObject((await (0, vite.loadConfigFromFile)(env, configFile, root, "silent"))?.config, configFile);
+}
+/**
+* File extensions Clarify treats as content files. Kept in sync with the
+* patterns used by route discovery in `parsers/routes.ts` and the OpenAPI
+* page generator. Exposed to tooling so the extension's "is this a content
+* file?" check stays accurate without duplicating the regex.
+*/
+var CONTENT_FILE_EXTENSIONS = [
+	".md",
+	".mdx",
+	".openapi.json",
+	".openapi.yaml",
+	".openapi.yml"
+];
+/**
+* Build the project-info response payload from the resolved plugin state.
+*/
+function buildProjectInfo(projectRoot, contentRoot, projectConfig) {
+	const response = {
+		configFilenames: CONFIG_FILENAMES,
+		contentFileExtensions: CONTENT_FILE_EXTENSIONS,
+		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)
+	};
+	return response;
+}
+/**
+* Handle a request to the project-info endpoint. Responds to any method
+* (GET is typical) with the JSON payload — there is no request body to parse.
+*/
+function handleProjectInfoRequest(_req, res, projectRoot, contentRoot, projectConfig) {
+	res.setHeader("Content-Type", "application/json; charset=utf-8");
+	res.end(JSON.stringify(buildProjectInfo(projectRoot, contentRoot, projectConfig)));
+}
+//#endregion
 //#region source/core/site.ts
 async function discoverRoutesForRoot(routeRoot, locale, plugins, ctx) {
 	return (await runHooks(plugins, "routes:discover", {
 		contentRoot: routeRoot,
 		locale,
-		routes: findContentRoutes(routeRoot)
+		routes: await findContentRoutes(routeRoot, routeRoot, { contentProcessor: getProjectContentProcessor(ctx) })
 	}, ctx)).routes;
 }
 async function discoverRoutes(root, contentRoot, plugins, ctx) {
@@ -1743,6 +2128,7 @@ async function resolveClarifySite(options = {}, resolveOptions = {}) {
 		routes: [],
 		navigation: []
 	};
+	setProjectContentProcessor(ctx, createProjectContentProcessor(plugins, ctx));
 	let routes = await discoverRoutes(root, contentRoot, plugins, ctx);
 	routes = await runHooks(plugins, "routes:discovered", routes, ctx);
 	routes = applyConfiguredPageRoutePaths(routes, projectConfig.tabs, projectConfig.i18n);
@@ -1945,42 +2331,6 @@ async function renderSSGRoutes(routes, projectConfig, outputDirectory, ssrBundle
 	}
 }
 //#endregion
-//#region source/core/user-config.ts
-function defineConfig(config) {
-	validateProjectConfig(config);
-	return config;
-}
-var CONFIG_FILENAMES = [
-	"clarify.ts",
-	"clarify.js",
-	"clarify.json"
-];
-function findClarifyConfigFile(root) {
-	for (const filename of CONFIG_FILENAMES) {
-		const filePath = (0, node_path.resolve)(root, filename);
-		if ((0, node_fs.existsSync)(filePath)) return filePath;
-	}
-}
-function assertConfigObject(config, configFile) {
-	if (!config || typeof config !== "object" || Array.isArray(config)) throw new Error(`[clarify] ${configFile} must export a configuration object`);
-	return config;
-}
-function loadJsonConfig(configFile) {
-	const config = assertConfigObject(JSON.parse((0, node_fs.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 {
-		...projectConfig,
-		...ssg ? { ssg } : {}
-	};
-}
-async function loadClarifyConfig(root, env) {
-	const configFile = findClarifyConfigFile(root);
-	if (!configFile) return {};
-	if (configFile.endsWith(".json")) return loadJsonConfig(configFile);
-	return assertConfigObject((await (0, vite.loadConfigFromFile)(env, configFile, root, "silent"))?.config, configFile);
-}
-//#endregion
 //#region source/core/plugin.ts
 function loadVirtualModule(id, modules) {
 	const bareId = stripVirtualPrefix(id);
@@ -2071,7 +2421,7 @@ function clarifyPlugin(options = {}) {
 			async config() {
 				await resolveRoutesAndSpecs();
 				return {
-					base: projectConfig.routePrefix,
+					base: projectConfig.assetPrefix,
 					build: {
 						...generateOptions.outputDirectory ? { outDir: generateOptions.outputDirectory } : {},
 						manifest: true
@@ -2128,6 +2478,11 @@ function clarifyPlugin(options = {}) {
 			async configureServer(server) {
 				server.watcher.add(contentRoot);
 				if (configFilePath) server.watcher.add(configFilePath);
+				server.middlewares.use((req, res, next) => {
+					if (req.url === "/dev/query-preview-route" && req.method === "POST") return handleDevRouteRequest(req, res, routes, projectConfig, contentRoot);
+					if (req.url === "/dev/project-info" && (req.method === "GET" || req.method === "HEAD")) return handleProjectInfoRequest(req, res, root, contentRoot, projectConfig);
+					next();
+				});
 				const handleContentTreeChange = async (filePath) => {
 					const relativeContentFile = (0, node_path.relative)(contentRoot, (0, node_path.isAbsolute)(filePath) ? filePath : (0, node_path.join)(root, filePath));
 					if (!(relativeContentFile && !relativeContentFile.startsWith("..") && !(0, node_path.isAbsolute)(relativeContentFile))) return;
@@ -2246,4 +2601,4 @@ Object.defineProperty(exports, "resolveClarifySite", {
 	}
 });
 
-//# sourceMappingURL=plugin-B7c0iHMy.cjs.map
+//# sourceMappingURL=plugin-JvxU6ZjU.cjs.map