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

package/dist/lib/metadata/types.d.ts

@@ -0,0 +1,118 @@
+import type { Framework } from '../framework';
+import type { I18nConfig } from '../i18n';
+import { type DocsConfig, type OgConfig } from '../presets/docs/config';
+export type VxConfig = {
+    framework: Framework;
+    core: VxCoreConfig;
+    docs?: DocsConfig;
+    og?: OgConfig;
+    i18n?: I18nConfig;
+    branding: {
+        themeColor: string;
+        backgroundColor: string;
+    };
+    pwa: VxPwaConfig;
+    metadata: VxMetadataConfig;
+};
+type VxCoreConfig = {
+    id: string;
+    name: string;
+    shortName: string;
+    version: string;
+    description: string;
+    publisher: {
+        name: string;
+        url: string;
+    };
+    url: string;
+};
+type VxPwaConfig = {
+    display: string;
+    orientation: string;
+    scope: string;
+    startUrl: string;
+    categories: string[];
+    icons: VxIconSource;
+    screenshots: VxImage[];
+    shortcuts: VxShortcut[];
+};
+export type VxIcon = {
+    src: string;
+    sizes: string;
+    type: string;
+};
+type VxIconSet = {
+    path: string;
+    sizes: number[];
+    type: string;
+};
+export type VxIconSource = VxIcon[] | VxIconSet;
+type VxImage = {
+    src: string;
+    sizes: string;
+    type: string;
+};
+type VxShortcut = {
+    name: string;
+    shortName: string;
+    url: string;
+    icons: VxIconSource;
+};
+type VxMetadataConfig = {
+    title: string;
+    keywords: string[];
+    theme: {
+        lightColor: string;
+        darkColor: string;
+        lightBackgroundColor: string;
+        darkBackgroundColor: string;
+    };
+    platforms: {
+        apple: {
+            mobileWebAppCapable: boolean;
+            webAppCapable: boolean;
+            touchIcon: string;
+            startupImages: VxStartupImageSource;
+        };
+        microsoft: {
+            startUrl: string;
+        };
+    };
+    social: {
+        openGraph: {
+            type: string;
+            image?: string;
+        };
+        twitter: {
+            creator: string;
+            site: string;
+            card: string;
+            image?: string;
+        };
+    };
+};
+export type VxStartupImage = {
+    colorScheme?: 'light' | 'dark';
+    device?: string;
+    width?: number;
+    height?: number;
+    pixelRatio?: number;
+    path?: string;
+    media?: string;
+    src?: string;
+};
+type VxStartupImageSet = {
+    path: string;
+    colorSchemes?: Array<'light' | 'dark'>;
+    sizes: VxStartupImage[];
+};
+export type VxStartupImageSource = VxStartupImage[] | VxStartupImageSet;
+export type GenerateMetadataOptions = {
+    projectRoot?: string;
+};
+export type MetadataFile = {
+    path: string;
+    content: string;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/metadata/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/metadata/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/navigation/app-menu.d.ts

@@ -0,0 +1,2 @@
+export declare const validateAppMenu: (value: unknown, location: string) => void;
+//# sourceMappingURL=app-menu.d.ts.map

package/dist/lib/navigation/app-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-menu.d.ts","sourceRoot":"","sources":["../../../src/lib/navigation/app-menu.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,SAwB/D,CAAA"}

package/dist/lib/navigation/app-menu.js

@@ -0,0 +1,45 @@
+//#region src/lib/navigation/app-menu.ts
+var MENU_FIELDS = new Set([
+	"key",
+	"label",
+	"icon",
+	"groups"
+]);
+var ACTION_FIELDS = new Set([
+	"key",
+	"label",
+	"icon",
+	"shortcut"
+]);
+var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var validateEntry = (value, fields, location, keys) => {
+	if (!object(value)) throw new Error(`${location} must be an object`);
+	for (const field of Object.keys(value)) if (!fields.has(field)) throw new Error(`Unknown field: ${location}.${field}`);
+	for (const field of [
+		"key",
+		"label",
+		"icon",
+		"shortcut"
+	]) if (field === "key" || field === "label" || value[field] !== void 0) {
+		if (typeof value[field] !== "string" || !value[field].trim()) throw new Error(`${location}.${field} must be a non-empty string`);
+	}
+	const key = value.key;
+	if (keys.has(key)) throw new Error(`Duplicate app menu key: ${location}.${key}`);
+	keys.add(key);
+	return value;
+};
+var validateAppMenu = (value, location) => {
+	if (!Array.isArray(value)) throw new Error(`${location} must be an array`);
+	const menuKeys = /* @__PURE__ */ new Set();
+	const actionKeys = /* @__PURE__ */ new Set();
+	for (const entry of value) {
+		const menu = validateEntry(entry, MENU_FIELDS, location, menuKeys);
+		if (!Array.isArray(menu.groups) || !menu.groups.length) throw new Error(`${location}.${menu.key}.groups must be a non-empty array`);
+		for (const group of menu.groups) {
+			if (!Array.isArray(group) || !group.length) throw new Error(`${location}.${menu.key} groups must be non-empty arrays`);
+			for (const action of group) validateEntry(action, ACTION_FIELDS, `${location}.${menu.key}`, actionKeys);
+		}
+	}
+};
+//#endregion
+export { validateAppMenu };

package/dist/lib/navigation/control-center.d.ts

@@ -0,0 +1,2 @@
+export declare const validateControlCenter: (value: unknown, location: string) => void;
+//# sourceMappingURL=control-center.d.ts.map

package/dist/lib/navigation/control-center.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-center.d.ts","sourceRoot":"","sources":["../../../src/lib/navigation/control-center.ts"],"names":[],"mappings":"AA6EA,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,SAcrE,CAAA"}

package/dist/lib/navigation/control-center.js

@@ -0,0 +1,66 @@
+//#region src/lib/navigation/control-center.ts
+var TYPES = new Set([
+	"direction-toggle",
+	"appearance-toggle",
+	"appearance",
+	"theme",
+	"direction",
+	"language",
+	"preview-wifi",
+	"preview-bluetooth",
+	"preview-airdrop",
+	"preview-focus",
+	"preview-stage-manager",
+	"preview-mirroring",
+	"preview-media",
+	"preview-display",
+	"preview-sound",
+	"custom"
+]);
+var FIELDS = new Set([
+	"id",
+	"type",
+	"span",
+	"label",
+	"description",
+	"editable",
+	"action"
+]);
+var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var validateTileFields = (tile, location) => {
+	for (const [field, entry] of Object.entries(tile)) {
+		if (!FIELDS.has(field)) throw new Error(`Unknown field: ${location}.${field}`);
+		if (field === "editable") {
+			if (typeof entry !== "boolean") throw new Error(`${location}.editable must be a boolean`);
+		} else if (typeof entry !== "string" || !entry.trim()) throw new Error(`${location}.${field} must be a non-empty string`);
+	}
+};
+var validateTileAction = (tile, location) => {
+	if (tile.type === "custom") {
+		if (typeof tile.action !== "string" || !tile.action.trim()) throw new Error(`${location}.${tile.id}.action is required`);
+	} else if (tile.action !== void 0) throw new Error(`${location}.${tile.id}.action is only supported for custom tiles`);
+};
+var validateTile = (tile, location, ids) => {
+	if (!object(tile)) throw new Error(`${location}.tiles must contain objects`);
+	validateTileFields(tile, location);
+	if (typeof tile.id !== "string" || !tile.id.trim()) throw new Error(`${location}.id is required`);
+	if (tile.id === "edit-controls") throw new Error(`${location}.edit-controls is a reserved built-in action`);
+	if (ids.has(tile.id)) throw new Error(`Duplicate control center tile id: ${tile.id}`);
+	ids.add(tile.id);
+	if (typeof tile.type !== "string" || !TYPES.has(tile.type)) throw new Error(`Unknown control center tile type: ${tile.type}`);
+	if (![
+		"compact",
+		"standard",
+		"wide",
+		"full"
+	].includes(String(tile.span))) throw new Error(`${location}.${tile.id}.span is invalid`);
+	validateTileAction(tile, location);
+};
+var validateControlCenter = (value, location) => {
+	if (!object(value) || Object.keys(value).some((key) => !["tiles", "editControls"].includes(key)) || !Array.isArray(value.tiles)) throw new Error(`${location} must contain a tiles array`);
+	if (value.editControls !== void 0 && typeof value.editControls !== "boolean") throw new Error(`${location}.editControls must be a boolean`);
+	const ids = /* @__PURE__ */ new Set();
+	for (const tile of value.tiles) validateTile(tile, location, ids);
+};
+//#endregion
+export { validateControlCenter };

package/dist/lib/navigation/index.d.ts

@@ -0,0 +1,5 @@
+export declare const getNavigationFiles: (projectRoot: string) => {
+    path: string;
+    content: string;
+}[];
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/navigation/index.ts"],"names":[],"mappings":"AA8CA,eAAO,MAAM,kBAAkB,GAAI,aAAa,MAAM;;;GAmCrD,CAAA"}

package/dist/lib/navigation/index.js

@@ -0,0 +1,59 @@
+import { readYamlConfig } from "../yaml-config.js";
+import { validateAppMenu } from "./app-menu.js";
+import { validateControlCenter } from "./control-center.js";
+import { validateToolbar } from "./toolbar.js";
+import { existsSync } from "node:fs";
+import path from "node:path";
+//#region src/lib/navigation/index.ts
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var validateItems = (items, location) => {
+	if (!Array.isArray(items)) throw new Error(`${location} must be an array`);
+	const keys = /* @__PURE__ */ new Set();
+	for (const item of items) {
+		if (!isObject(item)) throw new Error(`${location} items must be objects`);
+		for (const field of ["key", "title"]) if (typeof item[field] !== "string" || !item[field].trim()) throw new Error(`${location}.${field} must be a non-empty string`);
+		const key = item.key;
+		if (keys.has(key)) throw new Error(`Duplicate navigation key: ${location}.${key}`);
+		keys.add(key);
+		for (const [field, value] of Object.entries(item)) if (field === "children") validateItems(value, `${location}.${key}.children`);
+		else if (field === "childrenDisplay") {
+			if (value !== "tabs" && value !== "sidebar") throw new Error(`${location}.${key}.childrenDisplay must be tabs or sidebar`);
+		} else if (field === "toolbar") validateToolbar(value, `${location}.${key}.toolbar`);
+		else if (![
+			"key",
+			"title",
+			"href",
+			"icon",
+			"iconActive"
+		].includes(field)) throw new Error(`Unknown navigation field: ${location}.${key}.${field}`);
+		else if (typeof value !== "string") throw new Error(`${location}.${key}.${field} must be a string`);
+	}
+};
+var getNavigationFiles = (projectRoot) => {
+	const file = path.join(projectRoot, "vx.nav.yaml");
+	if (!existsSync(file)) return [];
+	const config = readYamlConfig(file);
+	if (!isObject(config) || Object.keys(config).some((key) => ![
+		"navigation",
+		"appMenu",
+		"controlCenter"
+	].includes(key))) throw new Error(`${file} must contain navigation and optional appMenu or controlCenter`);
+	validateItems(config.navigation, `${file}.navigation`);
+	if (config.appMenu !== void 0) validateAppMenu(config.appMenu, `${file}.appMenu`);
+	if (config.controlCenter !== void 0) validateControlCenter(config.controlCenter, `${file}.controlCenter`);
+	return [{
+		path: path.join(projectRoot, "src/generated/navigation.ts"),
+		content: `// Generated from vx.nav.yaml. DO NOT EDIT.\nimport type { AppNavigationItem, AppMenuItem } from '@vezham/react'\nimport type { ControlCenterConfig } from '@vezham/react/control-center'\n\nexport const navigationItems = ${JSON.stringify(config.navigation, null, 2)} satisfies AppNavigationItem[]\n\nexport const appMenu = ${JSON.stringify(config.appMenu ?? [], null, 2)} satisfies AppMenuItem[]\n\nexport const controlCenter = ${JSON.stringify(config.controlCenter ?? { tiles: [] }, null, 2)} satisfies ControlCenterConfig\n
+export const getNavigationChildren = (key: string) => {
+  const items: readonly AppNavigationItem[] = navigationItems
+  const item = items.find(item => item.key === key)
+  if (!item) {
+    throw new Error('Unknown navigation key: ' + key)
+  }
+  return 'children' in item && Array.isArray(item.children) ? item.children : []
+}
+`
+	}];
+};
+//#endregion
+export { getNavigationFiles };

package/dist/lib/navigation/toolbar.d.ts

@@ -0,0 +1,2 @@
+export declare const validateToolbar: (value: unknown, location: string) => void;
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/lib/navigation/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../../src/lib/navigation/toolbar.ts"],"names":[],"mappings":"AAmEA,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,SAsB/D,CAAA"}

package/dist/lib/navigation/toolbar.js

@@ -0,0 +1,78 @@
+//#region src/lib/navigation/toolbar.ts
+var ACTION_FIELDS = new Set([
+	"key",
+	"label",
+	"icon",
+	"children"
+]);
+var VIEW_ACTION_FIELDS = new Set([
+	"key",
+	"label",
+	"icon",
+	"enabled"
+]);
+var TOOLBAR_FIELDS = new Set([
+	"search",
+	"sync",
+	"filter",
+	"sort",
+	"view",
+	"menuActions",
+	"primaryAction"
+]);
+var SEARCH_FIELDS = new Set(["label", "placeholder"]);
+var VIEW_ACTION_KEYS = new Set(["grid", "list"]);
+var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var validateFields = (value, fields, location) => {
+	for (const key of Object.keys(value)) if (!fields.has(key)) throw new Error(`Unknown field: ${location}.${key}`);
+};
+var validateString = (value, location) => {
+	if (typeof value !== "string" || !value.trim()) throw new Error(`${location} must be a non-empty string`);
+};
+var validateAction = (value, location) => {
+	if (!object(value)) throw new Error(`${location} must be an action object`);
+	validateFields(value, ACTION_FIELDS, location);
+	for (const field of [
+		"key",
+		"label",
+		"icon"
+	]) validateString(value[field], `${location}.${field}`);
+	if (value.children !== void 0) validateActions(value.children, `${location}.children`);
+};
+var validateActions = (value, location, validate = validateAction) => {
+	if (!Array.isArray(value)) throw new Error(`${location} must be an array`);
+	const keys = /* @__PURE__ */ new Set();
+	for (const action of value) {
+		validate(action, location);
+		if (keys.has(action.key)) throw new Error(`Duplicate action key: ${location}.${action.key}`);
+		keys.add(action.key);
+	}
+};
+var validateViewAction = (value, location) => {
+	if (!object(value)) throw new Error(`${location} must contain action objects`);
+	validateFields(value, VIEW_ACTION_FIELDS, location);
+	for (const field of [
+		"key",
+		"label",
+		"icon"
+	]) validateString(value[field], `${location}.${field}`);
+	if (typeof value.key !== "string" || !VIEW_ACTION_KEYS.has(value.key)) throw new Error(`Unknown view action key: ${location}.${value.key}`);
+	if (value.enabled !== void 0 && typeof value.enabled !== "boolean") throw new Error(`${location}.${value.key}.enabled must be a boolean`);
+};
+var validateToolbar = (value, location) => {
+	if (!object(value)) throw new Error(`${location} must be an object`);
+	validateFields(value, TOOLBAR_FIELDS, location);
+	if (value.search !== void 0 && typeof value.search !== "boolean") {
+		if (!object(value.search)) throw new Error(`${location}.search must be a boolean or an object`);
+		validateFields(value.search, SEARCH_FIELDS, `${location}.search`);
+		for (const [field, entry] of Object.entries(value.search)) validateString(entry, `${location}.search.${field}`);
+	}
+	if (value.sync !== void 0 && typeof value.sync !== "boolean") throw new Error(`${location}.sync must be a boolean`);
+	if (value.filter !== void 0 && typeof value.filter !== "boolean") throw new Error(`${location}.filter must be a boolean`);
+	if (value.sort !== void 0 && typeof value.sort !== "boolean") throw new Error(`${location}.sort must be a boolean`);
+	if (value.view !== void 0) validateActions(value.view, `${location}.view`, validateViewAction);
+	if (value.menuActions !== void 0) validateActions(value.menuActions, `${location}.menuActions`);
+	if (value.primaryAction !== void 0 && value.primaryAction !== false) validateAction(value.primaryAction, `${location}.primaryAction`);
+};
+//#endregion
+export { validateToolbar };

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

@@ -0,0 +1,21 @@
+import { type ViteConfigOverrides } from '../../integrations/vite';
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => import("vite").UserConfigExport;
+export type PrerenderPage = {
+    path: string;
+    prerender?: {
+        outputPath: string;
+    };
+};
+export type RouteConfig = {
+    path: string;
+    prerender?: boolean | {
+        outputPath?: string;
+    };
+    source?: 'routes';
+};
+export type RouteInput = RouteConfig | string;
+export type PrerenderPagesOptions = {
+    routes?: RouteInput[];
+};
+export declare const getPrerenderPages: (projectRoot?: string, { routes: extraRoutes }?: PrerenderPagesOptions) => PrerenderPage[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/presets/app/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,mBAAmB,EAGzB,MAAM,yBAAyB,CAAA;AAkIhC,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,oCAQ7D,CAAA;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE;QACV,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EACN,OAAO,GACP;QACE,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACL,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,MAAM,CAAA;AAM7C,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACtB,CAAA;AAuED,eAAO,MAAM,iBAAiB,GAC5B,oBAA2B,EAC3B,0BAA8B,qBAA0B,oBA0BzD,CAAA"}

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