@clarify-labs/cli 0.8.2 → 0.9.0

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

@@ -1801,6 +1801,126 @@ function resolveProjectConfig(config = {}) {
 		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";
@@ -1860,6 +1980,84 @@ 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", {
@@ -2133,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);
@@ -2316,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;
@@ -2434,4 +2601,4 @@ Object.defineProperty(exports, "resolveClarifySite", {
 	}
 });
 
-//# sourceMappingURL=plugin-DyceHdXd.cjs.map
+//# sourceMappingURL=plugin-JvxU6ZjU.cjs.map