@vezham/config 26.0.0-alpha.5 → 26.0.0-alpha.6

package/dist/lib/presets/docs/config.js

@@ -0,0 +1,39 @@
+import { readYamlConfig } from "../../yaml-config.js";
+import { resolveI18n } from "../../i18n.js";
+import path from "node:path";
+//#region src/lib/presets/docs/config.ts
+var defaultContentDir = "content/docs";
+var defaultDocsRoute = "/docs";
+var defaultOpenApiDir = "openapi";
+var docsImageRoute = (docsRoute) => {
+	return `/og${docsRoute}`;
+};
+var resolveDocsConfig = (config = {}) => {
+	const docsRoute = config.docsRoute ?? defaultDocsRoute;
+	return {
+		docsDir: defaultContentDir,
+		docsRoute,
+		docsImageRoute: docsImageRoute(docsRoute),
+		openapiDir: defaultOpenApiDir,
+		ogOutputDir: `public${docsImageRoute(docsRoute)}`
+	};
+};
+var loadVxDocsConfig = (projectRoot = process.cwd()) => {
+	const configFile = path.join(projectRoot, "vx.app.yaml");
+	const config = readYamlConfig(configFile);
+	return {
+		config,
+		configFile,
+		docs: {
+			...config.docs,
+			og: {
+				...config.og,
+				...config.docs?.og
+			}
+		},
+		i18n: resolveI18n(config.i18n),
+		routes: config.routes ?? []
+	};
+};
+//#endregion
+export { loadVxDocsConfig, resolveDocsConfig };

package/dist/lib/presets/docs/files.d.ts

@@ -0,0 +1,2 @@
+export declare const generatedDirectories: (dir: string) => string[];
+//# sourceMappingURL=files.d.ts.map

package/dist/lib/presets/docs/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/files.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAAM,EAgBxD,CAAA"}

package/dist/lib/presets/docs/files.js

@@ -0,0 +1,13 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/lib/presets/docs/files.ts
+var generatedDirectories = (dir) => {
+	if (!fs.existsSync(dir)) return [];
+	return fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+		if (!entry.isDirectory()) return [];
+		const entryPath = path.join(dir, entry.name);
+		return entry.name === "(generated)" ? [entryPath] : generatedDirectories(entryPath);
+	});
+};
+//#endregion
+export { generatedDirectories };

package/dist/lib/presets/docs/index.d.ts

@@ -0,0 +1,7 @@
+export { type DocsMdxMacroImportAliasOptions, type DocsMdxOptions, docsMdx, docsMdxMacroImportAlias, defineConfig } from './vite';
+export { type OgConfig, type DocsConfig, type I18nConfig, type VxDocsConfig, resolveDocsConfig, loadVxDocsConfig } from './config';
+export { generateDocs } from './openapi';
+export { generateDocsOgImages } from './og';
+export { type DocsStaticPaths, type DocsPrerenderPage, type RouteOg, type RouteConfig, type RouteInput, type DocsPrerenderPagesOptions } from './types';
+export { getDocsStaticPaths, getDocsPrerenderPages, getPrerenderPages } from './routes';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/presets/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACnB,OAAO,EACP,uBAAuB,EACvB,YAAY,EACb,MAAM,QAAQ,CAAA;AACf,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,MAAM,CAAA;AAC3C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,yBAAyB,EAC/B,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,UAAU,CAAA"}

package/dist/lib/presets/docs/index.js

@@ -0,0 +1,6 @@
+import { defineConfig, docsMdx, docsMdxMacroImportAlias } from "./vite.js";
+import { loadVxDocsConfig, resolveDocsConfig } from "./config.js";
+import { generateDocs } from "./openapi.js";
+import { getDocsPrerenderPages, getDocsStaticPaths, getPrerenderPages } from "./routes.js";
+import { generateDocsOgImages } from "./og.js";
+export { defineConfig, docsMdx, docsMdxMacroImportAlias, generateDocs, generateDocsOgImages, getDocsPrerenderPages, getDocsStaticPaths, getPrerenderPages, loadVxDocsConfig, resolveDocsConfig };

package/dist/lib/presets/docs/mdx-path.d.ts

@@ -0,0 +1,7 @@
+import type { I18nConfig } from './config';
+export declare const docsPathFromMdx: (docsDir: string, docsRoute: string, i18n: I18nConfig, filePath: string) => {
+    locale: string;
+    markdownPath: string;
+    routePath: string;
+} | undefined;
+//# sourceMappingURL=mdx-path.d.ts.map

package/dist/lib/presets/docs/mdx-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-path.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/mdx-path.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,WAAW,MAAM,EACjB,MAAM,UAAU,EAChB,UAAU,MAAM;;;;aA0BjB,CAAA"}

package/dist/lib/presets/docs/mdx-path.js

@@ -0,0 +1,19 @@
+import { slash } from "../files.js";
+import path from "node:path";
+//#region src/lib/presets/docs/mdx-path.ts
+var docsPathFromMdx = (docsDir, docsRoute, i18n, filePath) => {
+	const relativePath = slash(path.relative(docsDir, filePath));
+	if (!relativePath.endsWith(".mdx")) return;
+	const localizedLanguage = i18n.languages.find((lang) => lang !== i18n.defaultLanguage && relativePath.endsWith(`.${lang}.mdx`));
+	const suffix = localizedLanguage ? `.${localizedLanguage}.mdx` : ".mdx";
+	const segments = relativePath.slice(0, -suffix.length).split("/").filter((segment) => !(segment.startsWith("(") && segment.endsWith(")")));
+	if (segments[segments.length - 1] === "index") segments.pop();
+	const routePath = segments.length ? `${docsRoute}/${segments.join("/")}` : docsRoute;
+	return {
+		locale: localizedLanguage ?? i18n.defaultLanguage,
+		markdownPath: segments.length ? `${routePath}.md` : `${docsRoute}/index.md`,
+		routePath
+	};
+};
+//#endregion
+export { docsPathFromMdx };

package/dist/lib/presets/docs/og-image.d.ts

@@ -0,0 +1,9 @@
+export type OgImageProps = {
+    title: string;
+    description?: string;
+    site?: string;
+    logo?: string;
+    theme?: 'dark' | 'light';
+};
+export declare const OgImage: ({ title, description, site, logo, theme }: OgImageProps) => import("react").JSX.Element;
+//# sourceMappingURL=og-image.d.ts.map

package/dist/lib/presets/docs/og-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"og-image.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/og-image.tsx"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB,CAAA;AAGD,eAAO,MAAM,OAAO,GAAI,2CAMrB,YAAY,gCA6Fd,CAAA"}

package/dist/lib/presets/docs/og-image.js

@@ -0,0 +1,88 @@
+import { renderToStaticMarkup } from "react-dom/server";
+import { VezhamLogo } from "@vezham/icons-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/lib/presets/docs/og-image.tsx
+/** @jsxRuntime automatic */
+/** @jsxImportSource react */
+var OgImage = ({ title, description, site = "Vezham", logo, theme = "light" }) => {
+	const colors = theme === "dark" ? {
+		background: "#18181b",
+		foreground: "#fafafa",
+		muted: "#a1a1aa"
+	} : {
+		background: "#f5f5f5",
+		foreground: "#18181b",
+		muted: "#71717a"
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		style: {
+			display: "flex",
+			flexDirection: "column",
+			width: "100%",
+			height: "100%",
+			color: colors.foreground,
+			padding: 64,
+			backgroundColor: colors.background
+		},
+		children: [
+			/* @__PURE__ */ jsx("p", {
+				style: {
+					fontFamily: "Inter",
+					fontWeight: 700,
+					fontSize: 76,
+					lineHeight: 1.1,
+					margin: 0,
+					lineClamp: 2
+				},
+				children: title
+			}),
+			description && /* @__PURE__ */ jsx("p", {
+				style: {
+					fontFamily: "Inter",
+					fontSize: 34,
+					lineHeight: 1.4,
+					color: colors.muted,
+					margin: 0,
+					marginTop: 24,
+					lineClamp: 3
+				},
+				children: description
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				style: {
+					display: "flex",
+					alignItems: "center",
+					gap: 12,
+					marginTop: "auto",
+					paddingTop: 24,
+					color: colors.foreground
+				},
+				children: [logo ? /* @__PURE__ */ jsx("img", {
+					alt: "",
+					width: 48,
+					height: 48,
+					src: logo,
+					style: { objectFit: "contain" }
+				}) : /* @__PURE__ */ jsx("img", {
+					alt: "Vezham",
+					width: 48,
+					height: 48,
+					src: `data:image/svg+xml;base64,${Buffer.from(renderToStaticMarkup(/* @__PURE__ */ jsx(VezhamLogo, {
+						size: 48,
+						color: colors.foreground
+					}))).toString("base64")}`
+				}), site && /* @__PURE__ */ jsx("p", {
+					style: {
+						fontFamily: "Jura",
+						fontSize: 36,
+						fontWeight: 600,
+						margin: 0
+					},
+					children: site
+				})]
+			})
+		]
+	});
+};
+//#endregion
+export { OgImage };

package/dist/lib/presets/docs/og-output.d.ts

@@ -0,0 +1,5 @@
+export declare const createOgOutput: (projectRoot: string) => {
+    add(files: string[], image: Buffer): void;
+    finish(): void;
+};
+//# sourceMappingURL=og-output.d.ts.map

package/dist/lib/presets/docs/og-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"og-output.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/og-output.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM;eAgCnC,MAAM,EAAE,SAAS,MAAM;;CAsBrC,CAAA"}

package/dist/lib/presets/docs/og-output.js

@@ -0,0 +1,34 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/lib/presets/docs/og-output.ts
+var createOgOutput = (projectRoot) => {
+	const root = path.resolve(projectRoot, "public/og");
+	const manifest = path.join(root, ".vx-generated.json");
+	const previous = fs.existsSync(manifest) ? JSON.parse(fs.readFileSync(manifest, "utf8")) : [];
+	const resolveFile = (file) => {
+		const resolved = path.resolve(root, file);
+		const relative = path.relative(root, resolved);
+		if (!relative || relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative) || path.extname(resolved) !== ".png") throw new Error(`Invalid generated OG image path: ${file}`);
+		return resolved;
+	};
+	if (!Array.isArray(previous) || !previous.every((file) => typeof file === "string")) throw new Error(`Invalid OG output manifest: ${manifest}`);
+	const previousFiles = previous.map(resolveFile);
+	const generated = /* @__PURE__ */ new Map();
+	return {
+		add(files, image) {
+			const resolvedFiles = files.map(resolveFile);
+			for (const file of resolvedFiles) generated.set(file, image);
+		},
+		finish() {
+			for (const [file, image] of generated) {
+				fs.mkdirSync(path.dirname(file), { recursive: true });
+				fs.writeFileSync(file, image);
+			}
+			for (const file of previousFiles) if (!generated.has(file)) fs.rmSync(file, { force: true });
+			fs.mkdirSync(root, { recursive: true });
+			fs.writeFileSync(manifest, `${JSON.stringify([...generated.keys()].map((file) => path.relative(root, file).split(path.sep).join("/")).sort(), null, 2)}\n`);
+		}
+	};
+};
+//#endregion
+export { createOgOutput };

package/dist/lib/presets/docs/og.d.ts

@@ -0,0 +1,9 @@
+import type { ReactElement } from 'react';
+import { type DocsConfig, type I18nConfig } from './config';
+import type { OgImageProps } from './og-image';
+import { type RouteInput } from './types';
+export declare const generateDocsOgImages: (projectRoot: string, config: DocsConfig, i18n: I18nConfig, { routes, renderImage }?: {
+    routes?: RouteInput[];
+    renderImage?: (props: OgImageProps) => ReactElement;
+}) => Promise<number>;
+//# sourceMappingURL=og.d.ts.map

package/dist/lib/presets/docs/og.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"og.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/og.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAIzC,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAqB,MAAM,UAAU,CAAA;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AAoGzC,eAAO,MAAM,oBAAoB,GAC/B,aAAa,MAAM,EACnB,QAAQ,UAAU,EAClB,MAAM,UAAU,EAChB,0BAGG;IACD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;IACrB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,CAAA;CAC/C,oBAsEP,CAAA"}

package/dist/lib/presets/docs/og.js

@@ -0,0 +1,112 @@
+import { walkFiles } from "../files.js";
+import { resolveDocsConfig } from "./config.js";
+import { docsPathFromMdx } from "./mdx-path.js";
+import { createOgOutput } from "./og-output.js";
+import { getDocsMirrorRoutes } from "./routes.js";
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { parse } from "yaml";
+import { ImageResponse } from "@vercel/og";
+//#region src/lib/presets/docs/og.ts
+var uniqueByRoute = (entries) => {
+	const mapped = /* @__PURE__ */ new Map();
+	for (const entry of entries) mapped.set(entry.routePath, entry);
+	return [...mapped.values()];
+};
+var titleFromPath = (pagePath) => {
+	const segments = pagePath.split("/").filter(Boolean);
+	return (segments[segments.length - 1] ?? "Docs").split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+};
+var getMdxEntries = ({ docsDir, docsRoute, ...i18n }) => {
+	return walkFiles(docsDir).flatMap((filePath) => {
+		const entry = docsPathFromMdx(docsDir, docsRoute, i18n, filePath);
+		if (!entry || entry.locale !== i18n.defaultLanguage) return [];
+		const { routePath } = entry;
+		const frontmatter = fs.readFileSync(filePath, "utf8").match(/^---\n([\s\S]*?)\n---/);
+		const meta = frontmatter ? parse(frontmatter[1]) : {};
+		return [{
+			description: typeof meta.description === "string" ? meta.description : "Documentation",
+			routePath,
+			title: typeof meta.title === "string" ? meta.title : titleFromPath(routePath)
+		}];
+	});
+};
+var getDocsOgOutputPaths = ({ docsRoute, entryRoutePath, mirrorRoutes, outputDir }) => {
+	const suffix = entryRoutePath === docsRoute ? "" : entryRoutePath.slice(docsRoute.length);
+	const outputRoot = path.dirname(outputDir);
+	const outputPaths = [path.join(outputDir, `${suffix}/image.png`.replace(/^\//, ""))];
+	if (entryRoutePath === docsRoute) outputPaths.push(path.join(outputRoot, "image.png"));
+	for (const mirrorRoute of mirrorRoutes) outputPaths.push(path.join(outputRoot, mirrorRoute, `${suffix}/image.png`.replace(/^\//, "")));
+	return outputPaths;
+};
+var generateDocsOgImages = async (projectRoot, config, i18n, { routes = [], renderImage } = {}) => {
+	let render = renderImage;
+	if (!render) {
+		const { OgImage } = await import("./og-image.js");
+		render = OgImage;
+	}
+	const resolved = resolveDocsConfig(config);
+	const resolvedDocsDir = path.resolve(projectRoot, resolved.docsDir);
+	const resolvedOutputDir = path.resolve(projectRoot, resolved.ogOutputDir);
+	const mirrorRoutes = getDocsMirrorRoutes(routes).filter((route) => route !== resolved.docsRoute);
+	const entries = uniqueByRoute(getMdxEntries({
+		...i18n,
+		docsDir: resolvedDocsDir,
+		docsRoute: resolved.docsRoute
+	}));
+	const require = createRequire(import.meta.url);
+	const juraFont = fs.readFileSync(require.resolve("@fontsource/jura/files/jura-latin-600-normal.woff"));
+	const interRegular = fs.readFileSync(require.resolve("@fontsource/inter/files/inter-latin-400-normal.woff"));
+	const interBold = fs.readFileSync(require.resolve("@fontsource/inter/files/inter-latin-700-normal.woff"));
+	const logo = resolveDocsOgLogo(projectRoot, config.og?.logo);
+	const output = createOgOutput(projectRoot);
+	const generatedImageCounts = await Promise.all(entries.map(async (entry) => {
+		const outputPaths = getDocsOgOutputPaths({
+			docsRoute: resolved.docsRoute,
+			entryRoutePath: entry.routePath,
+			mirrorRoutes,
+			outputDir: resolvedOutputDir
+		});
+		const response = new ImageResponse(render({
+			...config.og,
+			description: entry.description,
+			logo,
+			title: entry.title
+		}), {
+			fonts: [
+				{
+					data: interRegular,
+					name: "Inter",
+					weight: 400
+				},
+				{
+					data: interBold,
+					name: "Inter",
+					weight: 700
+				},
+				{
+					data: juraFont,
+					name: "Jura",
+					weight: 600
+				}
+			],
+			height: 630,
+			width: 1200
+		});
+		const image = Buffer.from(await response.arrayBuffer());
+		output.add(outputPaths, image);
+		return outputPaths.length;
+	}));
+	output.finish();
+	return generatedImageCounts.reduce((total, count) => total + count, 0);
+};
+var resolveDocsOgLogo = (projectRoot, logo) => {
+	if (!logo || /^(data:|https?:)/.test(logo)) return logo;
+	const filePath = path.resolve(projectRoot, "public", logo.replace(/^\//, ""));
+	if (!fs.existsSync(filePath)) throw new Error(`Missing docs OG logo: ${filePath}`);
+	const extension = path.extname(filePath).slice(1) || "svg+xml";
+	return `data:${extension === "svg" ? "image/svg+xml" : `image/${extension}`};base64,${fs.readFileSync(filePath).toString("base64")}`;
+};
+//#endregion
+export { generateDocsOgImages };

package/dist/lib/presets/docs/openapi.d.ts

@@ -0,0 +1,3 @@
+import { type DocsConfig, type I18nConfig } from './config';
+export declare const generateDocs: (projectRoot: string, config: DocsConfig, i18n: I18nConfig) => Promise<number>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/lib/presets/docs/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/openapi.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAqB,MAAM,UAAU,CAAA;AAuJ9E,eAAO,MAAM,YAAY,GACvB,aAAa,MAAM,EACnB,QAAQ,UAAU,EAClB,MAAM,UAAU,oBAsCjB,CAAA"}

package/dist/lib/presets/docs/openapi.js

@@ -0,0 +1,105 @@
+import { slash, walkFiles, withoutExtension } from "../files.js";
+import { resolveDocsConfig } from "./config.js";
+import { generatedDirectories } from "./files.js";
+import fs from "node:fs";
+import path from "node:path";
+import * as OpenAPI from "@vezham/docs-openapi";
+import { createOpenAPI } from "@vezham/docs-openapi/server";
+//#region src/lib/presets/docs/openapi.ts
+var openapiExtensions = new Set([
+	".json",
+	".yaml",
+	".yml"
+]);
+var openAPISpecIdFromRelativePath = (relativePath) => {
+	const segments = withoutExtension(slash(relativePath)).split("/");
+	if (segments[segments.length - 1] === "index") segments.pop();
+	return segments.length === 0 ? "openapi" : segments.join("/");
+};
+var assertGeneratedOutput = (docsDir, outputDir) => {
+	const relativePath = path.relative(docsDir, outputDir);
+	if (relativePath === "" || relativePath.startsWith(`..${path.sep}`) || path.basename(outputDir) !== "(generated)" || !relativePath.startsWith(`openapi${path.sep}`)) throw new Error(`Refusing to clear unexpected generated docs dir: ${outputDir}`);
+};
+var discoverOpenAPISpecs = (projectRoot, docsDir, openapiDirName) => {
+	const specs = [];
+	const openapiDir = path.join(projectRoot, openapiDirName);
+	const folderSpecs = walkFiles(openapiDir).filter((filePath) => openapiExtensions.has(path.extname(filePath))).sort((left, right) => left.localeCompare(right));
+	for (const inputPath of folderSpecs) {
+		const documentId = openAPISpecIdFromRelativePath(path.relative(openapiDir, inputPath));
+		const outputSegments = documentId === "openapi" ? [] : documentId.split("/");
+		specs.push({
+			documentId,
+			inputPath,
+			outputDir: path.join(docsDir, "openapi", ...outputSegments, "(generated)")
+		});
+	}
+	const documentIds = /* @__PURE__ */ new Set();
+	for (const spec of specs) {
+		if (documentIds.has(spec.documentId)) throw new Error(`Duplicate OpenAPI document id: ${spec.documentId}`);
+		documentIds.add(spec.documentId);
+	}
+	return specs;
+};
+var pageNameFromMdx = (fileName, languages) => {
+	const withoutMdx = fileName.slice(0, -4);
+	for (const language of languages) {
+		const suffix = `.${language}`;
+		if (withoutMdx.endsWith(suffix)) return withoutMdx.slice(0, -suffix.length);
+	}
+	return withoutMdx;
+};
+var pagesInDirectory = (dir, languages) => {
+	const files = /* @__PURE__ */ new Set();
+	const directories = [];
+	for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+		if (entry.isFile() && entry.name.endsWith(".mdx")) files.add(pageNameFromMdx(entry.name, languages));
+		if (entry.isDirectory()) directories.push(entry.name === "(generated)" ? `...${entry.name}` : entry.name);
+	}
+	return [...[...files].sort((left, right) => {
+		if (left === "index") return -1;
+		if (right === "index") return 1;
+		return left.localeCompare(right);
+	}), ...directories.sort((left, right) => left.localeCompare(right))];
+};
+var synchronizeMetaFiles = (docsDir, outputDirectories, languages) => {
+	const metaFiles = new Set(walkFiles(docsDir).filter((filePath) => path.basename(filePath) === "meta.json"));
+	for (const outputDirectory of outputDirectories) metaFiles.add(path.join(path.dirname(outputDirectory), "meta.json"));
+	for (const metaFile of [...metaFiles].sort()) {
+		const pages = pagesInDirectory(path.dirname(metaFile), languages);
+		if (pages.length === 0) continue;
+		const existingContent = fs.existsSync(metaFile) ? fs.readFileSync(metaFile, "utf8") : void 0;
+		const existing = existingContent ? JSON.parse(existingContent) : {};
+		const content = `${JSON.stringify({
+			...existing,
+			pages
+		}, null, 2)}\n`;
+		if (existingContent !== content) fs.writeFileSync(metaFile, content);
+	}
+};
+var generateDocs = async (projectRoot, config, i18n) => {
+	const resolved = resolveDocsConfig(config);
+	const docsDir = path.resolve(projectRoot, resolved.docsDir);
+	const specs = discoverOpenAPISpecs(projectRoot, docsDir, resolved.openapiDir);
+	const generatedRoot = path.join(docsDir, "openapi");
+	fs.mkdirSync(docsDir, { recursive: true });
+	for (const outputDir of generatedDirectories(generatedRoot)) {
+		assertGeneratedOutput(docsDir, outputDir);
+		fs.rmSync(outputDir, {
+			force: true,
+			recursive: true
+		});
+	}
+	await Promise.all(specs.map(async (spec) => {
+		assertGeneratedOutput(docsDir, spec.outputDir);
+		await OpenAPI.generateFiles({
+			input: createOpenAPI({ input: { [spec.documentId]: spec.inputPath } }),
+			groupBy: "tag",
+			meta: true,
+			output: spec.outputDir
+		});
+	}));
+	synchronizeMetaFiles(docsDir, specs.map((spec) => spec.outputDir), i18n.languages);
+	return specs.length;
+};
+//#endregion
+export { generateDocs };

package/dist/lib/presets/docs/routes.d.ts

@@ -0,0 +1,7 @@
+import { type DocsConfig, type I18nConfig } from './config';
+import { type DocsPrerenderPage, type DocsPrerenderPagesOptions, type DocsStaticPaths, type RouteInput } from './types';
+export declare const getDocsStaticPaths: (projectRoot: string, config: DocsConfig | undefined, i18n: I18nConfig) => DocsStaticPaths;
+export declare const getDocsMirrorRoutes: (routes: RouteInput[]) => string[];
+export declare const getDocsPrerenderPages: (projectRoot: string, config: DocsConfig | undefined, i18n: I18nConfig, { extraPages, includeDocsRoot, includeLocalizedDocsRoots, routes }?: DocsPrerenderPagesOptions) => DocsPrerenderPage[];
+export declare const getPrerenderPages: (projectRoot?: string, options?: DocsPrerenderPagesOptions) => DocsPrerenderPage[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/lib/presets/docs/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/routes.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EAGhB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EAEpB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAA;AAwBhB,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,EACnB,QAAQ,UAAU,YAAK,EACvB,MAAM,UAAU,KACf,eA+BF,CAAA;AAiGD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,UAAU,EAAE,aAQvD,CAAA;AAMD,eAAO,MAAM,qBAAqB,GAChC,aAAa,MAAM,EACnB,QAAQ,UAAU,YAAK,EACvB,MAAM,UAAU,EAChB,qEAKG,yBAA8B,wBA+DlC,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,oBAA2B,EAC3B,UAAS,yBAA8B,wBAQxC,CAAA"}

package/dist/lib/presets/docs/routes.js

@@ -0,0 +1,109 @@
+import { unique, walkFiles } from "../files.js";
+import { expandFilesystemRoute, normalizeRoute, routeRootFromGlob } from "../route-files.js";
+import { loadVxDocsConfig, resolveDocsConfig } from "./config.js";
+import { docsPathFromMdx } from "./mdx-path.js";
+import path from "node:path";
+//#region src/lib/presets/docs/routes.ts
+var docsRouteFileOptions = { rootRouteSegments: new Set(["__root__"]) };
+var getNonDefaultLanguages = (i18n) => {
+	return i18n.languages.filter((lang) => lang !== i18n.defaultLanguage);
+};
+var getDocsStaticPathsForLocale = (docsDir, docsRoute, i18n, locale) => {
+	return unique(walkFiles(docsDir).map((filePath) => docsPathFromMdx(docsDir, docsRoute, i18n, filePath)).filter((entry) => entry?.locale === locale).flatMap((entry) => entry ? [entry.routePath, entry.markdownPath] : []));
+};
+var getDocsStaticPaths = (projectRoot, config = {}, i18n) => {
+	const resolved = resolveDocsConfig(config);
+	const docsDir = path.resolve(projectRoot, resolved.docsDir);
+	const defaultDocsStaticPaths = getDocsStaticPathsForLocale(docsDir, resolved.docsRoute, i18n, i18n.defaultLanguage);
+	const openApiStaticPaths = defaultDocsStaticPaths.filter((pagePath) => pagePath.startsWith(`${resolved.docsRoute}/openapi/`));
+	return {
+		defaultDocsStaticPaths,
+		docsShellStaticPaths: defaultDocsStaticPaths.filter((pagePath) => !pagePath.endsWith(".md")),
+		docsStaticPathsByLocale: Object.fromEntries(i18n.languages.map((lang) => [lang, unique([...getDocsStaticPathsForLocale(docsDir, resolved.docsRoute, i18n, lang), ...openApiStaticPaths])])),
+		openApiStaticPaths
+	};
+};
+var shouldWritePrerenderIndex = (pagePath) => {
+	return path.extname(pagePath) === "" && !pagePath.startsWith("/api/");
+};
+var isDocsShellPath = (pagePath) => {
+	return !pagePath.endsWith(".md");
+};
+var createDocsPrerenderPage = (pagePath) => {
+	return {
+		path: pagePath,
+		prerender: shouldWritePrerenderIndex(pagePath) ? { outputPath: `${pagePath}/index.html` } : void 0
+	};
+};
+var normalizeDocsPrerenderPage = (page) => {
+	return typeof page === "string" ? createDocsPrerenderPage(page) : page;
+};
+var replaceDocsRoute = (pagePath, docsRoute, nextRoute) => {
+	if (pagePath === docsRoute) return nextRoute;
+	return pagePath.startsWith(`${docsRoute}/`) ? `${nextRoute}${pagePath.slice(docsRoute.length)}` : pagePath;
+};
+var shouldPrerenderRoute = (route) => {
+	return route.prerender !== false;
+};
+var docsMirrorRouteFromRoute = (route) => {
+	const routeRoot = routeRootFromGlob(route.path);
+	return routeRoot && route.source === "docs" ? routeRoot : void 0;
+};
+var createFilesystemRoutePrerenderPages = (projectRoot, route) => {
+	return expandFilesystemRoute(projectRoot, route, docsRouteFileOptions).map((pagePath) => createDocsPrerenderPageFromRoute({
+		...route,
+		path: pagePath
+	}));
+};
+var shouldGenerateDocsRouteOg = (route) => {
+	const hasDocsMirrorGlob = docsMirrorRouteFromRoute(route) !== void 0;
+	if (typeof route.og === "object") return false;
+	return route.og ?? hasDocsMirrorGlob;
+};
+var assertSupportedRoute = (route) => {
+	if (!routeRootFromGlob(route.path) || route.source === "docs" || route.source === "routes") return;
+	throw new Error(`Unsupported route source "${route.source ?? "none"}" for glob route "${route.path}". Use source "docs", source "routes", or provide an exact path.`);
+};
+var createDocsPrerenderPageFromRoute = (route) => {
+	if (typeof route.prerender === "object" && route.prerender.outputPath) return {
+		path: route.path,
+		prerender: { outputPath: route.prerender.outputPath }
+	};
+	return createDocsPrerenderPage(route.path);
+};
+var getDocsMirrorRoutes = (routes) => {
+	return unique(routes.map(normalizeRoute).filter(shouldGenerateDocsRouteOg).map(docsMirrorRouteFromRoute).filter((route) => route !== void 0));
+};
+var uniquePrerenderPages = (pages) => {
+	return [...new Map(pages.map((page) => [page.path, page])).values()];
+};
+var getDocsPrerenderPages = (projectRoot, config = {}, i18n, { extraPages = [], includeDocsRoot = true, includeLocalizedDocsRoots = true, routes = [] } = {}) => {
+	const resolved = resolveDocsConfig(config);
+	const { defaultDocsStaticPaths, docsShellStaticPaths, docsStaticPathsByLocale } = getDocsStaticPaths(projectRoot, config, i18n);
+	const routeEntries = routes.map(normalizeRoute).filter(shouldPrerenderRoute);
+	for (const route of routeEntries) assertSupportedRoute(route);
+	const globDocsRoutes = unique([...routeEntries.flatMap((route) => {
+		const docsRoute = docsMirrorRouteFromRoute(route);
+		return docsRoute ? [docsRoute] : [];
+	})]);
+	const staticRoutes = routeEntries.filter((route) => !routeRootFromGlob(route.path));
+	return uniquePrerenderPages([
+		...includeDocsRoot ? [createDocsPrerenderPage(resolved.docsRoute)] : [],
+		...defaultDocsStaticPaths.map(createDocsPrerenderPage),
+		...globDocsRoutes.flatMap((route) => docsShellStaticPaths.map((pagePath) => createDocsPrerenderPage(replaceDocsRoute(pagePath, resolved.docsRoute, route)))),
+		...getNonDefaultLanguages(i18n).flatMap((lang) => globDocsRoutes.flatMap((route) => docsStaticPathsByLocale[lang].filter(isDocsShellPath).map((pagePath) => createDocsPrerenderPage(`/${lang}${replaceDocsRoute(pagePath, resolved.docsRoute, route)}`)))),
+		...getNonDefaultLanguages(i18n).flatMap((lang) => [...includeLocalizedDocsRoots ? [createDocsPrerenderPage(`/${lang}`), createDocsPrerenderPage(`/${lang}${resolved.docsRoute}`)] : [], ...docsStaticPathsByLocale[lang].map((pagePath) => createDocsPrerenderPage(`/${lang}${pagePath}`))]),
+		...routeEntries.flatMap((route) => createFilesystemRoutePrerenderPages(projectRoot, route)),
+		...staticRoutes.map(createDocsPrerenderPageFromRoute),
+		...extraPages.map(normalizeDocsPrerenderPage)
+	]);
+};
+var getPrerenderPages = (projectRoot = process.cwd(), options = {}) => {
+	const { docs, i18n, routes } = loadVxDocsConfig(projectRoot);
+	return getDocsPrerenderPages(projectRoot, docs, i18n, {
+		...options,
+		routes: [...routes, ...options.routes ?? []]
+	});
+};
+//#endregion
+export { getDocsMirrorRoutes, getDocsPrerenderPages, getDocsStaticPaths, getPrerenderPages };