@vezham/config 0.0.0-stage → 26.0.0-alpha.6

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

@@ -0,0 +1,114 @@
+import { createViteConfig, getViteConfig } from "../../integrations/vite/index.js";
+import { readYamlConfig } from "../../yaml-config.js";
+import { unique, walkFiles } from "../files.js";
+import { expandFilesystemRoute, normalizeRoute, routePathFromFile, routeRootFromGlob } from "../route-files.js";
+import fs from "node:fs";
+import path from "node:path";
+import { mergeConfig } from "vite";
+import { createRequire } from "node:module";
+//#region src/lib/presets/app/index.ts
+var trimTrailingWildcard = (value) => value.endsWith("/*") ? value.slice(0, -2) : value;
+var getTsConfigPathAliases = (projectRoot = process.cwd()) => {
+	const tsconfigFile = path.resolve(projectRoot, "tsconfig.app.json");
+	if (!fs.existsSync(tsconfigFile)) return {};
+	try {
+		const paths = JSON.parse(fs.readFileSync(tsconfigFile, "utf8")).compilerOptions?.paths ?? {};
+		return Object.fromEntries(Object.entries(paths).map(([alias, values]) => {
+			const value = values[0];
+			if (!value) return null;
+			return [trimTrailingWildcard(alias), path.resolve(projectRoot, trimTrailingWildcard(value))];
+		}).filter((entry) => entry !== null));
+	} catch {
+		return {};
+	}
+};
+var getServerConfig = () => {
+	const { env } = process;
+	const hostname = env.CI ? "localhost" : env.HOST_NAME || "localhost";
+	return {
+		port: Number(env.PORT),
+		host: hostname
+	};
+};
+var getPreviewConfig = () => {
+	const { env } = process;
+	const hostname = env.CI ? "localhost" : env.HOST_NAME || "localhost";
+	const configuredPort = Number(env.PRE_PORT) || Number(env.PORT);
+	return {
+		port: env.TSS_PRERENDERING === "true" ? 0 : configuredPort || void 0,
+		host: hostname
+	};
+};
+var getReactPackageDir = (projectRoot = process.cwd()) => {
+	const requireFromProject = createRequire(path.join(projectRoot, "package.json"));
+	return path.dirname(requireFromProject.resolve("react/package.json"));
+};
+var getViteDefaults = (projectRoot = process.cwd()) => ({
+	...getViteConfig(projectRoot),
+	envPrefix: ["V_"],
+	server: getServerConfig(),
+	resolve: {
+		alias: getTsConfigPathAliases(projectRoot),
+		tsconfigPaths: true
+	},
+	build: {
+		outDir: "./dist",
+		emptyOutDir: true,
+		reportCompressedSize: true,
+		commonjsOptions: { transformMixedEsModules: true }
+	}
+});
+var getPreviewOverride = (env) => ({ preview: process.env.TSS_PRERENDERING === "true" ? {
+	host: "localhost",
+	port: 0
+} : env.command === "build" ? void 0 : getPreviewConfig() });
+var getResolveOverride = (env, projectRoot = process.cwd()) => ({ resolve: {
+	dedupe: ["react", "react-dom"],
+	alias: env.command === "build" ? { "react/jsx-dev-runtime": path.join(getReactPackageDir(projectRoot), "cjs/react-jsx-dev-runtime.development.js") } : void 0
+} });
+var defineConfig = (overrides = {}) => createViteConfig((projectRoot, env) => mergeConfig(mergeConfig(getViteDefaults(projectRoot), getPreviewOverride(env)), getResolveOverride(env, projectRoot)), overrides);
+var uniquePrerenderPages = (pages) => {
+	return [...new Map(pages.map((page) => [page.path, page])).values()];
+};
+var appRouteFileOptions = {
+	emptyRoutePath: "/",
+	rootRouteSegments: new Set(["__root", "__root__"]),
+	stripLazySuffix: true
+};
+var getStaticPageRoutes = (projectRoot) => {
+	const routesDir = path.join(projectRoot, "src/routes");
+	return unique(walkFiles(routesDir).filter((filePath) => [".jsx", ".tsx"].includes(path.extname(filePath))).map((filePath) => routePathFromFile(routesDir, filePath, appRouteFileOptions)).filter((routePath) => routePath !== void 0).filter((routePath) => !routePath.startsWith("/api/")).sort((left, right) => left.localeCompare(right)));
+};
+var createPrerenderPage = (route) => {
+	if (typeof route.prerender === "object" && route.prerender.outputPath) return {
+		path: route.path,
+		prerender: { outputPath: route.prerender.outputPath }
+	};
+	const shouldWriteIndex = route.path !== "/" && path.extname(route.path) === "" && !route.path.startsWith("/api/");
+	return {
+		path: route.path,
+		prerender: shouldWriteIndex ? { outputPath: `${route.path}/index.html` } : void 0
+	};
+};
+var createFilesystemRoutePrerenderPages = (projectRoot, route) => {
+	return expandFilesystemRoute(projectRoot, route, appRouteFileOptions).map((pagePath) => createPrerenderPage({
+		...route,
+		path: pagePath
+	}));
+};
+var assertSupportedRoute = (route) => {
+	if (!routeRootFromGlob(route.path) || route.source === "routes") return;
+	throw new Error(`Unsupported route source "${route.source ?? "none"}" for glob route "${route.path}". Use source "routes" or provide an exact path.`);
+};
+var getPrerenderPages = (projectRoot = process.cwd(), { routes: extraRoutes = [] } = {}) => {
+	const routeEntries = [...readYamlConfig(path.join(projectRoot, "vx.app.yaml")).routes ?? [], ...extraRoutes].map(normalizeRoute);
+	for (const route of routeEntries) assertSupportedRoute(route);
+	return uniquePrerenderPages([
+		createPrerenderPage({ path: "/" }),
+		...getStaticPageRoutes(projectRoot).map((pagePath) => createPrerenderPage({ path: pagePath })),
+		...routeEntries.flatMap((route) => route.prerender === false ? [] : createFilesystemRoutePrerenderPages(projectRoot, route)),
+		...routeEntries.filter((route) => !routeRootFromGlob(route.path)).filter((route) => route.prerender !== false).map(createPrerenderPage)
+	]);
+};
+//#endregion
+export { defineConfig, getPrerenderPages };

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

@@ -0,0 +1,2 @@
+export { defineConfig } from '../app';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/cdn/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA"}

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

@@ -0,0 +1,2 @@
+import { defineConfig } from "../app/index.js";
+export { defineConfig };

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/cli.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { loadVxDocsConfig } from "./config.js";
+import { generateDocs } from "./openapi.js";
+import { generateDocsOgImages } from "./og.js";
+//#region src/lib/presets/docs/cli.ts
+var [, , command = "generate", projectRoot = process.cwd()] = process.argv;
+var { docs, i18n, routes } = loadVxDocsConfig(projectRoot);
+if (command === "generate" || command === "content") {
+	const count = await generateDocs(projectRoot, docs, i18n);
+	console.log(`Generated documentation for ${count} OpenAPI specifications`);
+} else if (command === "og") {
+	const count = await generateDocsOgImages(projectRoot, docs, i18n, { routes });
+	console.log(`Generated ${count} OG images for ${projectRoot}`);
+} else {
+	console.error(`Unknown docs command "${command}". Use "generate", "content", or "og".`);
+	process.exitCode = 1;
+}
+//#endregion

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

@@ -0,0 +1,40 @@
+import { type I18nConfig } from '../../i18n';
+import { type RouteInput } from './types';
+export type { I18nConfig } from '../../i18n';
+export type OgConfig = {
+    logo?: string;
+    site?: string;
+    theme?: 'dark' | 'light';
+};
+export type DocsConfig = {
+    docsRoute?: string;
+    og?: OgConfig;
+};
+export type VxDocsConfig = {
+    docs?: DocsConfig;
+    i18n?: I18nConfig;
+    og?: OgConfig;
+    routes?: RouteInput[];
+};
+export declare const resolveDocsConfig: (config?: DocsConfig) => {
+    docsDir: string;
+    docsRoute: string;
+    docsImageRoute: string;
+    openapiDir: string;
+    ogOutputDir: string;
+};
+export declare const loadVxDocsConfig: (projectRoot?: string) => {
+    config: VxDocsConfig;
+    configFile: string;
+    docs: {
+        og: {
+            logo?: string;
+            site?: string;
+            theme?: "dark" | "light";
+        };
+        docsRoute?: string;
+    };
+    i18n: I18nConfig;
+    routes: RouteInput[];
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/docs/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,YAAY,CAAA;AAEzD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,QAAQ,CAAA;CACd,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACtB,CAAA;AAYD,eAAO,MAAM,iBAAiB,GAAI,SAAQ,UAAe;;;;;;CAUxD,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,oBAA2B;;;;;mBAvCnD,MAAM;mBACN,MAAM;oBACL,MAAM,GAAG,OAAO;;oBAIZ,MAAM;;;;CAkDnB,CAAA"}

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"}