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

package/dist/lib/integrations/vite/index.js

@@ -0,0 +1,34 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { defineConfig as defineConfig$1, mergeConfig } from "vite";
+//#region src/lib/integrations/vite/index.ts
+var findWorkspaceRoot = (startDir = process.cwd()) => {
+	let currentDir = path.resolve(startDir);
+	while (currentDir !== path.dirname(currentDir)) {
+		if (existsSync(path.join(currentDir, "pnpm-workspace.yaml"))) return currentDir;
+		currentDir = path.dirname(currentDir);
+	}
+	return path.resolve(startDir);
+};
+var getProjectPackageName = (projectRoot = process.cwd()) => {
+	const packageJsonFile = path.resolve(projectRoot, "package.json");
+	if (!existsSync(packageJsonFile)) return path.basename(projectRoot);
+	try {
+		return JSON.parse(readFileSync(packageJsonFile, "utf8")).name;
+	} catch {
+		return path.basename(projectRoot);
+	}
+};
+var getViteCacheDir = (projectRoot = process.cwd()) => path.resolve(findWorkspaceRoot(projectRoot), "node_modules/.vite", getProjectPackageName(projectRoot));
+var getViteConfig = (projectRoot = process.cwd()) => ({
+	root: projectRoot,
+	cacheDir: getViteCacheDir(projectRoot),
+	test: {}
+});
+var createViteConfig = (getDefaults, overrides = {}) => defineConfig$1(async (env) => {
+	const resolvedOverrides = typeof overrides === "function" ? await overrides(env) : overrides;
+	return mergeConfig(getDefaults(path.resolve(String(resolvedOverrides.root ?? process.cwd())), env), resolvedOverrides);
+});
+var defineConfig = (overrides = {}) => createViteConfig(getViteConfig, overrides);
+//#endregion
+export { createViteConfig, defineConfig, getProjectPackageName, getViteCacheDir, getViteConfig };

package/dist/lib/integrations/vite-lib/base.d.ts

@@ -0,0 +1,3 @@
+import { type ViteConfigOverrides } from '../vite';
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => import("vite").UserConfigFnPromise;
+//# sourceMappingURL=base.d.ts.map

package/dist/lib/integrations/vite-lib/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/vite-lib/base.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,SAAS,CAAA;AAuBhB,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,uCAgB5D,CAAA"}

package/dist/lib/integrations/vite-lib/base.js

@@ -0,0 +1,31 @@
+import { getViteConfig } from "../vite/index.js";
+import path from "node:path";
+import { defineConfig, mergeConfig } from "vite";
+import dts from "vite-plugin-dts";
+//#region src/lib/integrations/vite-lib/base.ts
+var getViteLibConfig = (projectRoot = process.cwd()) => ({
+	...getViteConfig(projectRoot),
+	plugins: [dts({
+		entryRoot: path.join(projectRoot, "src"),
+		tsconfigPath: path.join(projectRoot, "tsconfig.lib.json")
+	})],
+	build: {
+		outDir: "./dist",
+		emptyOutDir: true,
+		reportCompressedSize: true,
+		commonjsOptions: { transformMixedEsModules: true },
+		lib: {
+			entry: path.join(projectRoot, "src/index.ts"),
+			fileName: "index",
+			formats: ["es"]
+		}
+	}
+});
+var defineConfig$1 = (overrides = {}) => defineConfig(async (env) => {
+	const resolved = typeof overrides === "function" ? await overrides(env) : overrides;
+	const defaults = getViteLibConfig(path.resolve(resolved.root ?? process.cwd()));
+	if (resolved.build?.lib && resolved.build.lib.formats && defaults.build?.lib) delete defaults.build.lib.formats;
+	return mergeConfig(defaults, resolved);
+});
+//#endregion
+export { defineConfig$1 as defineConfig };

package/dist/lib/integrations/vite-lib/index.d.ts

@@ -0,0 +1,3 @@
+import type { ViteConfigOverrides } from '../vite';
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => import("vite").UserConfigFnPromise;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/integrations/vite-lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/vite-lib/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAgC9D,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,uCA6C5D,CAAA"}

package/dist/lib/integrations/vite-lib/index.js

@@ -0,0 +1,42 @@
+import { defineConfig as defineConfig$2 } from "./base.js";
+import { cpSync, existsSync, globSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { mergeConfig } from "vite";
+//#region src/lib/integrations/vite-lib/index.ts
+var getPackageEntries = (projectRoot) => {
+	const manifest = path.join(projectRoot, "package.json");
+	if (!existsSync(manifest)) return void 0;
+	const pkg = JSON.parse(readFileSync(manifest, "utf8"));
+	const files = Object.values(pkg.exports ?? {}).map((value) => typeof value === "string" ? value : value["@vx/fe-kit"] ?? value.types).filter((value) => Boolean(value?.startsWith("./src/"))).flatMap((pattern) => globSync(pattern, { cwd: projectRoot }));
+	for (const output of Object.values(pkg.bin ?? {})) files.push(output.replace("./dist/", "src/").replace(/\.js$/, ".ts"));
+	return Object.fromEntries(files.map((file) => [file.replace(/^\.?\/src\//, "").replace(/^src\//, "").replace(/\.tsx?$/, ""), path.resolve(projectRoot, file)]));
+};
+var defineConfig = (overrides = {}) => defineConfig$2(async (env) => {
+	const config = typeof overrides === "function" ? await overrides(env) : overrides;
+	const root = path.resolve(config.root ?? process.cwd());
+	return mergeConfig({
+		plugins: [{
+			name: "vezham:package-assets",
+			closeBundle() {
+				for (const file of globSync("src/**/*.{html,css}", { cwd: root })) cpSync(path.join(root, file), path.join(root, file.replace(/^src\//, "dist/")), { recursive: true });
+			}
+		}],
+		build: {
+			minify: false,
+			lib: {
+				entry: getPackageEntries(root),
+				fileName: (_format, name) => `${name}.js`
+			},
+			rolldownOptions: {
+				external: (id) => !id.startsWith(".") && !path.isAbsolute(id) && !id.startsWith("\0"),
+				output: {
+					preserveModules: true,
+					preserveModulesRoot: path.join(root, "src"),
+					entryFileNames: "[name].js"
+				}
+			}
+		}
+	}, config);
+});
+//#endregion
+export { defineConfig };

package/dist/lib/integrations/vite-lib/react.d.ts

@@ -0,0 +1,3 @@
+import type { ViteConfigOverrides } from '../vite';
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => import("vite").UserConfigFnPromise;
+//# sourceMappingURL=react.d.ts.map

package/dist/lib/integrations/vite-lib/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/vite-lib/react.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAGlD,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,uCAK5D,CAAA"}

package/dist/lib/integrations/vite-lib/react.js

@@ -0,0 +1,10 @@
+import { defineConfig as defineConfig$2 } from "./index.js";
+import { mergeConfig } from "vite";
+import react from "@vitejs/plugin-react-swc";
+//#region src/lib/integrations/vite-lib/react.ts
+var defineConfig = (overrides = {}) => defineConfig$2(async (env) => {
+	const resolved = typeof overrides === "function" ? await overrides(env) : overrides;
+	return mergeConfig({ plugins: [react()] }, resolved);
+});
+//#endregion
+export { defineConfig };

package/dist/lib/integrations/vitest/framework.d.ts

@@ -0,0 +1,4 @@
+import type { Framework } from '../../framework';
+import { type ViteConfigOverrides } from '../vite';
+export declare const defineFrameworkTestConfig: (framework: Framework, overrides?: ViteConfigOverrides) => import("vite").UserConfigExport;
+//# sourceMappingURL=framework.d.ts.map

package/dist/lib/integrations/vitest/framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/vitest/framework.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAGlD,eAAO,MAAM,yBAAyB,GACpC,WAAW,SAAS,EACpB,YAAW,mBAAwB,oCASlC,CAAA"}

package/dist/lib/integrations/vitest/framework.js

@@ -0,0 +1,5 @@
+import { defineTestConfig } from "./shared.js";
+//#region src/lib/integrations/vitest/framework.ts
+var defineFrameworkTestConfig = (framework, overrides = {}) => defineTestConfig(framework === "next" ? "next" : framework === "tanstack-docs" ? "docs" : "react", overrides);
+//#endregion
+export { defineFrameworkTestConfig };

package/dist/lib/integrations/vitest/frameworks/docs-plugins.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+export declare const docsTestPlugins: () => (Plugin<any> | Plugin<any>[])[];
+//# sourceMappingURL=docs-plugins.d.ts.map

package/dist/lib/integrations/vitest/frameworks/docs-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-plugins.d.ts","sourceRoot":"","sources":["../../../../../src/lib/integrations/vitest/frameworks/docs-plugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAsClC,eAAO,MAAM,eAAe,uCAI3B,CAAA"}

package/dist/lib/integrations/vitest/frameworks/docs-plugins.js

@@ -0,0 +1,27 @@
+import { docsMdx, docsMdxMacroImportAlias } from "../../../presets/docs/vite.js";
+import path from "node:path";
+//#region src/lib/integrations/vitest/frameworks/docs-plugins.ts
+var slash = (value) => value.split(path.sep).join("/");
+var projectRootImportAlias = () => {
+	return {
+		name: "@vezham/config:vitest-project-root-import-alias",
+		enforce: "pre",
+		resolveId(source) {
+			if (!source.startsWith("/openapi/")) return null;
+			const [filePath, query] = source.split("?", 2);
+			const resolvedPath = slash(path.resolve(process.cwd(), filePath.slice(1)));
+			return query ? `${resolvedPath}?${query}` : resolvedPath;
+		},
+		transform(code) {
+			if (!code.includes("/openapi/")) return null;
+			return code.replaceAll("\"/openapi/", `"${slash(path.resolve(process.cwd(), "openapi"))}/`).replaceAll("'/openapi/", `'${slash(path.resolve(process.cwd(), "openapi"))}/`);
+		}
+	};
+};
+var docsTestPlugins = () => [
+	projectRootImportAlias(),
+	docsMdxMacroImportAlias({ rewriteContentBase: true }),
+	docsMdx()
+];
+//#endregion
+export { docsTestPlugins };

package/dist/lib/integrations/vitest/frameworks/docs.d.ts

@@ -0,0 +1,3 @@
+import { type ViteConfigOverrides } from '../../vite';
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => import("vite").UserConfigExport;
+//# sourceMappingURL=docs.d.ts.map

package/dist/lib/integrations/vitest/frameworks/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../../src/lib/integrations/vitest/frameworks/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGrD,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,oCAC3B,CAAA"}

package/dist/lib/integrations/vitest/frameworks/docs.js

@@ -0,0 +1,5 @@
+import { defineTestConfig } from "../shared.js";
+//#region src/lib/integrations/vitest/frameworks/docs.ts
+var defineConfig = (overrides = {}) => defineTestConfig("docs", overrides);
+//#endregion
+export { defineConfig };

package/dist/lib/integrations/vitest/frameworks/next.d.ts

@@ -0,0 +1,3 @@
+import { type ViteConfigOverrides } from '../../vite';
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => import("vite").UserConfigExport;
+//# sourceMappingURL=next.d.ts.map

package/dist/lib/integrations/vitest/frameworks/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../../../src/lib/integrations/vitest/frameworks/next.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGrD,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,oCAC3B,CAAA"}

package/dist/lib/integrations/vitest/frameworks/next.js

@@ -0,0 +1,5 @@
+import { defineTestConfig } from "../shared.js";
+//#region src/lib/integrations/vitest/frameworks/next.ts
+var defineConfig = (overrides = {}) => defineTestConfig("next", overrides);
+//#endregion
+export { defineConfig };

package/dist/lib/integrations/vitest/frameworks/react.d.ts

@@ -0,0 +1,3 @@
+import { type ViteConfigOverrides } from '../../vite';
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => import("vite").UserConfigExport;
+//# sourceMappingURL=react.d.ts.map

package/dist/lib/integrations/vitest/frameworks/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../../src/lib/integrations/vitest/frameworks/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGrD,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,oCAC1B,CAAA"}

package/dist/lib/integrations/vitest/frameworks/react.js

@@ -0,0 +1,5 @@
+import { defineTestConfig } from "../shared.js";
+//#region src/lib/integrations/vitest/frameworks/react.ts
+var defineConfig = (overrides = {}) => defineTestConfig("react", overrides);
+//#endregion
+export { defineConfig };

package/dist/lib/integrations/vitest/index.d.ts

@@ -0,0 +1,4 @@
+export { defineConfig } from '../vite';
+export * from '../../framework';
+export * from './framework';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/integrations/vitest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/vitest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA"}

package/dist/lib/integrations/vitest/index.js

@@ -0,0 +1,4 @@
+import { defineConfig } from "../vite/index.js";
+import { validateFramework } from "../../framework.js";
+import { defineFrameworkTestConfig } from "./framework.js";
+export { defineConfig, defineFrameworkTestConfig, validateFramework };

package/dist/lib/integrations/vitest/setup/next.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=next.d.ts.map

package/dist/lib/integrations/vitest/setup/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../../../src/lib/integrations/vitest/setup/next.ts"],"names":[],"mappings":""}

package/dist/lib/integrations/vitest/setup/next.js

@@ -0,0 +1,11 @@
+import { vi } from "vitest";
+//#region src/lib/integrations/vitest/setup/next.ts
+vi.mock("next/navigation", () => ({ useRouter: () => ({
+	back: vi.fn(),
+	forward: vi.fn(),
+	prefetch: vi.fn(),
+	push: vi.fn(),
+	refresh: vi.fn(),
+	replace: vi.fn()
+}) }));
+//#endregion

package/dist/lib/integrations/vitest/setup/react.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=react.d.ts.map

package/dist/lib/integrations/vitest/setup/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../../src/lib/integrations/vitest/setup/react.ts"],"names":[],"mappings":""}

package/dist/lib/integrations/vitest/setup/react.js

@@ -0,0 +1,36 @@
+import * as matchers from "@testing-library/jest-dom/matchers";
+import { cleanup } from "@testing-library/react";
+import { afterEach, beforeEach, expect, vi } from "vitest";
+//#region src/lib/integrations/vitest/setup/react.ts
+var noop = () => void 0;
+var ResizeObserverMock = class {
+	observe = noop;
+	unobserve = noop;
+	disconnect = noop;
+};
+expect.extend(matchers);
+beforeEach(() => {
+	window.scrollTo = vi.fn();
+	Element.prototype.scrollTo = vi.fn();
+});
+if (typeof window !== "undefined" && typeof window.matchMedia !== "function") Object.defineProperty(window, "matchMedia", {
+	writable: true,
+	value: (query) => ({
+		matches: false,
+		media: query,
+		onchange: null,
+		addListener: noop,
+		removeListener: noop,
+		addEventListener: noop,
+		removeEventListener: noop,
+		dispatchEvent: () => false
+	})
+});
+if (typeof globalThis.ResizeObserver !== "function") Object.defineProperty(globalThis, "ResizeObserver", {
+	writable: true,
+	value: ResizeObserverMock
+});
+afterEach(() => {
+	cleanup();
+});
+//#endregion

package/dist/lib/integrations/vitest/shared.d.ts

@@ -0,0 +1,3 @@
+import { type ViteConfigOverrides } from '../vite';
+export declare const defineTestConfig: (feature: "react" | "next" | "docs", overrides?: ViteConfigOverrides) => import("vite").UserConfigExport;
+//# sourceMappingURL=shared.d.ts.map

package/dist/lib/integrations/vitest/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/vitest/shared.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,gBAAgB,GAC3B,SAAS,OAAO,GAAG,MAAM,GAAG,MAAM,EAClC,YAAW,mBAAwB,oCA8BjC,CAAA"}

package/dist/lib/integrations/vitest/shared.js

@@ -0,0 +1,24 @@
+import { defineConfig as defineConfig$1 } from "../vite/index.js";
+import path from "node:path";
+import { mergeConfig } from "vite";
+//#region src/lib/integrations/vitest/shared.ts
+var defineTestConfig = (feature, overrides = {}) => defineConfig$1(async (env) => {
+	const config = typeof overrides === "function" ? await overrides(env) : overrides;
+	const setupFiles = [path.join(import.meta.dirname, "setup/react" + (import.meta.url.endsWith(".ts") ? ".ts" : ".js"))];
+	if (feature === "next") setupFiles.push(path.join(import.meta.dirname, "setup/next" + (import.meta.url.endsWith(".ts") ? ".ts" : ".js")));
+	const plugins = [];
+	if (feature === "docs") {
+		const { docsTestPlugins } = await import("./frameworks/docs-plugins.js");
+		plugins.push(...docsTestPlugins());
+	}
+	return mergeConfig({
+		plugins,
+		test: {
+			environment: "jsdom",
+			setupFiles,
+			fileParallelism: false
+		}
+	}, config);
+});
+//#endregion
+export { defineTestConfig };

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

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

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

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

package/dist/lib/metadata/cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { generateMetadata, watchMetadata } from "./index.js";
+//#region src/lib/metadata/cli.ts
+var [, , command = "generate", projectRoot = process.cwd(), output] = process.argv;
+if (command === "generate") {
+	const files = generateMetadata({ projectRoot });
+	console.log(output === "--json" ? JSON.stringify(files) : `Generated ${files.length} metadata files for ${projectRoot}`);
+} else if (command === "watch") watchMetadata({ projectRoot });
+else {
+	console.error(`Unknown public command "${command}". Use "generate" or "watch".`);
+	process.exitCode = 1;
+}
+//#endregion

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

@@ -0,0 +1,9 @@
+import { type VxConfig } from './types';
+export declare const getVxEnv: ({ core }: VxConfig) => {
+    HOST_NAME: string;
+    V_APP_ID: string;
+    V_APP_NAME: string;
+    V_APP_VER: string;
+};
+export declare const syncEnvContent: (content: string, values: Record<string, string>) => string;
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/lib/metadata/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAavC,eAAO,MAAM,QAAQ,GAAI,UAAU,QAAQ;;;;;CAKzC,CAAA;AAEF,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,EACf,QAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,MA+BF,CAAA"}

package/dist/lib/metadata/env.js

@@ -0,0 +1,36 @@
+//#region src/lib/metadata/env.ts
+var getDomain = (url) => {
+	try {
+		return new URL(url).hostname;
+	} catch {
+		return url.replace(/^https?:\/\//, "").replace(/\/.*$/, "");
+	}
+};
+var getLocalHostName = (url) => getDomain(url).replace(/\.vezham\.app$/, ".vezham.local");
+var getVxEnv = ({ core }) => ({
+	HOST_NAME: getLocalHostName(core.url),
+	V_APP_ID: core.id,
+	V_APP_NAME: core.name,
+	V_APP_VER: core.version
+});
+var syncEnvContent = (content, values) => {
+	const lines = content ? content.replace(/\n$/, "").split("\n") : [];
+	const synced = /* @__PURE__ */ new Set();
+	const envLinePattern = /^([A-Z][A-Z0-9_]*)=/;
+	const nextLines = lines.map((line) => {
+		const key = line.match(envLinePattern)?.[1];
+		if (!key || !(key in values)) return line;
+		synced.add(key);
+		return `${key}=${values[key]}`;
+	});
+	const missingLines = Object.entries(values).filter(([key]) => !synced.has(key)).map(([key, value]) => `${key}=${value}`);
+	if (missingLines.length > 0) {
+		const prePortIndex = nextLines.findIndex((line) => line.startsWith("PRE_PORT="));
+		const portIndex = nextLines.findIndex((line) => line.startsWith("PORT="));
+		const insertIndex = prePortIndex >= 0 ? prePortIndex + 1 : portIndex >= 0 ? portIndex + 1 : 0;
+		nextLines.splice(insertIndex, 0, ...missingLines);
+	}
+	return `${nextLines.join("\n")}\n`;
+};
+//#endregion
+export { getVxEnv, syncEnvContent };

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

@@ -0,0 +1,3 @@
+import type { VxConfig } from './types';
+export declare const syncIndexHtmlContent: (content: string, config: VxConfig, projectRoot?: string) => string;
+//# sourceMappingURL=html.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../src/lib/metadata/html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AA6JvC,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,QAAQ,QAAQ,EAChB,oBAA2B,WA2B5B,CAAA"}

package/dist/lib/metadata/html.js

@@ -0,0 +1,96 @@
+import { getTanStackHead } from "./tanstack.js";
+import { escapeHtml, generatedNotice } from "./render.js";
+//#region src/lib/metadata/html.ts
+var indexMetadataStartMarker = "<!-- VX_METADATA_START -->";
+var indexMetadataEndMarker = "<!-- VX_METADATA_END -->";
+var isDefined = (value) => value !== void 0;
+var normalizeHtmlAttributeName = (name) => name === "charSet" ? "charset" : name;
+var renderHtmlAttribute = ([name, value]) => {
+	if (value === void 0) return;
+	if (value === true) return name;
+	if (value === false) return;
+	return `${normalizeHtmlAttributeName(name)}="${escapeHtml(value)}"`;
+};
+var renderHtmlTag = (tag, attributes, indent = "    ") => {
+	const renderedAttributes = Object.entries(attributes).map(renderHtmlAttribute).filter(isDefined);
+	const inlineTag = `${indent}<${tag} ${renderedAttributes.join(" ")} />`;
+	if (inlineTag.length <= 80) return inlineTag;
+	return `${indent}<${tag}\n${renderedAttributes.map((attribute) => `${indent}  ${attribute}`).join("\n")} />`;
+};
+var escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var getIndexHtmlMetadataBlock = (config, projectRoot = process.cwd()) => {
+	const head = getTanStackHead(config, projectRoot);
+	const [charsetMeta, ...meta] = head.meta;
+	const renderHeadMetaEntry = (entry) => {
+		if (typeof entry.title === "string") return `    <title>${escapeHtml(entry.title)}</title>`;
+		return renderHtmlTag("meta", entry);
+	};
+	const note = (label) => `    <!-- wjdlz/NOTE: ${label} -->`;
+	const isMetaName = (entry, names) => typeof entry.name === "string" && names.includes(entry.name);
+	const webMeta = meta.filter((entry) => entry.title || isMetaName(entry, [
+		"viewport",
+		"author",
+		"keywords",
+		"description"
+	]));
+	const themeMeta = meta.filter((entry) => isMetaName(entry, ["theme-color", "background-color"]));
+	const mobileMeta = meta.filter((entry) => isMetaName(entry, ["mobile-web-app-capable"]));
+	const appleMeta = meta.filter((entry) => typeof entry.name === "string" && entry.name.startsWith("apple-"));
+	const microsoftMeta = meta.filter((entry) => isMetaName(entry, [
+		"application-name",
+		"msapplication-config",
+		"msapplication-starturl"
+	]));
+	const openGraphMeta = meta.filter((entry) => typeof entry.property === "string" && entry.property.startsWith("og:"));
+	const twitterMeta = meta.filter((entry) => typeof entry.name === "string" && entry.name.startsWith("twitter:"));
+	const pwaLinks = head.links.filter((link) => link.rel === "manifest" || link.rel === "icon" || link.rel === "shortcut icon" || link.rel === "mask-icon");
+	const appleLinks = head.links.filter((link) => typeof link.rel === "string" && link.rel.startsWith("apple-touch-"));
+	return [
+		`    ${indexMetadataStartMarker}`,
+		`    <!-- ${generatedNotice} -->`,
+		note("WEB"),
+		...charsetMeta ? [renderHeadMetaEntry(charsetMeta)] : [],
+		renderHtmlTag("meta", {
+			"http-equiv": "X-UA-Compatible",
+			content: "IE=edge"
+		}),
+		...webMeta.map(renderHeadMetaEntry),
+		"",
+		note("PWA::THEME"),
+		...themeMeta.map(renderHeadMetaEntry),
+		...pwaLinks.map((link) => renderHtmlTag("link", link)),
+		"",
+		note("PWA::MOBILE"),
+		...mobileMeta.map(renderHeadMetaEntry),
+		"",
+		note("APPLE"),
+		...appleMeta.map(renderHeadMetaEntry),
+		...appleLinks.map((link) => renderHtmlTag("link", link)),
+		"",
+		note("MICROSOFT"),
+		...microsoftMeta.map(renderHeadMetaEntry),
+		"",
+		note("META"),
+		...openGraphMeta.map(renderHeadMetaEntry),
+		"",
+		note("TWITTER"),
+		...twitterMeta.map(renderHeadMetaEntry),
+		`    ${indexMetadataEndMarker}`
+	].join("\n");
+};
+var getPreservedIndexHeadContent = (headContent) => headContent.split("\n").filter((line) => {
+	const trimmedLine = line.trim();
+	return trimmedLine.startsWith("<base ") || trimmedLine.startsWith("<script ");
+}).join("\n");
+var syncIndexHtmlContent = (content, config, projectRoot = process.cwd()) => {
+	const metadataBlock = getIndexHtmlMetadataBlock(config, projectRoot);
+	const headPattern = /(<head>\n)([\s\S]*?)(\n\s*<\/head>)/;
+	const headMatch = content.match(headPattern);
+	if (!headMatch) throw new Error("Unable to sync Vx metadata because index.html has no head");
+	const [, headStart, headContent, headEnd] = headMatch;
+	const existingBlockPattern = new RegExp(`${escapeRegex(`    ${indexMetadataStartMarker}`)}[\\s\\S]*?${escapeRegex(`    ${indexMetadataEndMarker}`)}`);
+	const nextHeadContent = [getPreservedIndexHeadContent(headContent.replace(existingBlockPattern, "")), metadataBlock].filter(Boolean).join("\n\n");
+	return content.replace(headPattern, `${headStart}${nextHeadContent}${headEnd}`);
+};
+//#endregion
+export { syncIndexHtmlContent };

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

@@ -0,0 +1,7 @@
+import { type GenerateMetadataOptions, type MetadataFile, type VxConfig } from './types';
+export declare const loadVxAppConfig: (projectRoot?: string) => VxConfig;
+export declare const getMetadataFiles: (config: VxConfig, projectRoot?: string) => MetadataFile[];
+export declare const generateMetadata: (options?: GenerateMetadataOptions) => string[];
+export declare const watchMetadata: (options?: GenerateMetadataOptions) => import("node:fs").FSWatcher;
+export type { GenerateMetadataOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/metadata/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,SAAS,CAAA;AAOhB,eAAO,MAAM,eAAe,GAAI,oBAA2B,aAU1D,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,oBAA2B,KAC1B,YAAY,EA+Bd,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,UAAS,uBAA4B,aASrE,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,UAAS,uBAA4B,gCAclE,CAAA;AAGD,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA"}

package/dist/lib/metadata/index.js

@@ -0,0 +1,61 @@
+import { validateFramework } from "../framework.js";
+import { readYamlConfig } from "../yaml-config.js";
+import { getNavigationFiles } from "../navigation/index.js";
+import { getVxEnv, syncEnvContent } from "./env.js";
+import { getGeneratedMetadataModule } from "./render.js";
+import { syncIndexHtmlContent } from "./html.js";
+import { getPublicMetadataFiles } from "./public.js";
+import { existsSync, mkdirSync, readFileSync, watch, writeFileSync } from "node:fs";
+import path from "node:path";
+//#region src/lib/metadata/index.ts
+var writeMetadataFile = ({ path: file, content }) => {
+	mkdirSync(path.dirname(file), { recursive: true });
+	writeFileSync(file, content);
+};
+var loadVxAppConfig = (projectRoot = process.cwd()) => {
+	const configFile = path.resolve(projectRoot, "vx.app.yaml");
+	if (!existsSync(configFile)) throw new Error(`Missing vx.app.yaml at ${configFile}`);
+	const config = readYamlConfig(configFile);
+	validateFramework(config.framework);
+	return config;
+};
+var getMetadataFiles = (config, projectRoot = process.cwd()) => {
+	const indexFile = path.resolve(projectRoot, "index.html");
+	const envFile = path.resolve(projectRoot, ".env");
+	return [
+		...getNavigationFiles(projectRoot),
+		...getPublicMetadataFiles(config, projectRoot),
+		...existsSync(indexFile) ? [{
+			path: indexFile,
+			content: syncIndexHtmlContent(readFileSync(indexFile, "utf8"), config, projectRoot)
+		}] : [],
+		{
+			path: path.join(projectRoot, "src/generated/vx.ts"),
+			content: getGeneratedMetadataModule(config, projectRoot)
+		},
+		{
+			path: envFile,
+			content: syncEnvContent(existsSync(envFile) ? readFileSync(envFile, "utf8") : "", getVxEnv(config))
+		}
+	];
+};
+var generateMetadata = (options = {}) => {
+	const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+	const files = getMetadataFiles(loadVxAppConfig(projectRoot), projectRoot);
+	for (const file of files) writeMetadataFile(file);
+	return files.map((file) => file.path);
+};
+var watchMetadata = (options = {}) => {
+	const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+	const configFile = path.join(projectRoot, "vx.app.yaml");
+	const regenerate = () => {
+		const files = generateMetadata(options);
+		console.log(`Generated ${files.length} metadata files from ${configFile}`);
+	};
+	regenerate();
+	return watch(projectRoot, { persistent: true }, (_event, filename) => {
+		if (filename === "vx.app.yaml" || filename === "vx.nav.yaml") regenerate();
+	});
+};
+//#endregion
+export { generateMetadata, getMetadataFiles, loadVxAppConfig, watchMetadata };