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

package/README.md

@@ -1 +1,15 @@
 # @vezham/config
+
+Build, test, metadata, navigation, and deployment presets.
+
+Import presets directly from package subpaths, such as
+`@vezham/config/vite` and `@vezham/config/vitest/react`.
+
+Package builds use `defineConfig` from `@vezham/config/vite-lib`, or
+`@vezham/config/vite-lib/react` for React packages. Both presets discover source
+entries from package exports and CLI entries, preserve ES modules, keep
+package dependencies external, copy CSS and HTML assets, and generate declarations.
+
+Workspace entry points load TypeScript source before the first build. Publishing
+replaces those entries with compiled ESM and declarations; the workspace loader
+and its dependencies are not included in the npm output.

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

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

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

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

package/dist/lib/deploy/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { generateDeployConfig } from "./index.js";
+//#region src/lib/deploy/cli.ts
+var [, , command = "generate", projectRoot = process.cwd()] = process.argv;
+if (command === "generate") {
+	const files = generateDeployConfig({ projectRoot });
+	console.log(`Generated ${files.length} deploy files for ${projectRoot}`);
+} else {
+	console.error(`Unknown deploy command "${command}". Use "generate".`);
+	process.exitCode = 1;
+}
+//#endregion

package/dist/lib/deploy/firebase.d.ts

@@ -0,0 +1,3 @@
+import type { DeployFile, VxAppConfig, VxDeployConfig } from './types';
+export declare const getFirebaseDeployFile: (workspaceRoot: string, projectRoot: string, appConfig: VxAppConfig, deployConfig: VxDeployConfig) => DeployFile;
+//# sourceMappingURL=firebase.d.ts.map

package/dist/lib/deploy/firebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/firebase.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EAQV,WAAW,EACX,cAAc,EACf,MAAM,SAAS,CAAA;AAiMhB,eAAO,MAAM,qBAAqB,GAChC,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,WAAW,WAAW,EACtB,cAAc,cAAc,KAC3B,UAWF,CAAA"}

package/dist/lib/deploy/firebase.js

@@ -0,0 +1,106 @@
+import { normalizePath, resolveProjectPath } from "./paths.js";
+import { cdnRewrites } from "./presets.js";
+import path from "node:path";
+//#region src/lib/deploy/firebase.ts
+var cacheHeader = (source, value) => ({
+	source,
+	headers: [{
+		key: "Cache-Control",
+		value
+	}]
+});
+var unique = (values) => [...new Set(values)];
+var firebaseDeployPresets = {
+	cdn: {
+		public: "dist",
+		rewrites: cdnRewrites
+	},
+	spa: {
+		public: "dist",
+		fallback: "/index.html"
+	},
+	"start-spa": {
+		public: ".output/public",
+		fallback: "/_shell.html"
+	}
+};
+var defaultFirebaseDeployPreset = firebaseDeployPresets["start-spa"];
+var getFirebaseDeployPreset = (preset) => {
+	if (!preset) return defaultFirebaseDeployPreset;
+	if (preset === "next" || preset === "tanstack-start") throw new Error(`The "${preset}" deploy preset supports Vercel only`);
+	return firebaseDeployPresets[preset];
+};
+var getDefaultFirebaseHeaders = (appConfig, options = {}, fallback) => {
+	const { app = true, docs = Boolean(appConfig.docs), routes = true, static: staticAssets = true } = options;
+	const docsRoute = appConfig.docs?.docsRoute ?? "/docs";
+	const localizedDocsRoutes = (appConfig.i18n?.languages ?? []).filter((language) => language !== appConfig.i18n?.defaultLanguage).flatMap((language) => {
+		const localizedDocsRoute = `/${language}${docsRoute}`;
+		return [localizedDocsRoute, `${localizedDocsRoute.replace(/\/$/, "")}/**`];
+	});
+	const routeSources = unique([
+		...app ? ["/"] : [],
+		...docs ? [
+			docsRoute,
+			`${docsRoute.replace(/\/$/, "")}/**`,
+			...localizedDocsRoutes
+		] : [],
+		...routes ? (appConfig.routes ?? []).map((route) => route.path).filter((route) => route.startsWith("/api")) : []
+	].filter(Boolean));
+	return [...staticAssets ? [
+		cacheHeader("/sw.js", "no-cache,no-store,must-revalidate"),
+		cacheHeader("/manifest.webmanifest", "public,max-age=300"),
+		...fallback ? [cacheHeader(fallback, "public,max-age=300")] : [],
+		cacheHeader("/assets/**", "public,max-age=31536000,immutable"),
+		cacheHeader("**/*.@(html|json|txt|md)", "public,max-age=300")
+	] : [], ...routeSources.map((source) => cacheHeader(source, "public,max-age=300"))];
+};
+var getDefaultLanguageRedirects = (appConfig) => {
+	const defaultLanguage = appConfig.i18n?.defaultLanguage;
+	return defaultLanguage ? [{
+		source: `/${defaultLanguage}`,
+		destination: "/",
+		type: 301
+	}, {
+		source: `/${defaultLanguage}/:path*`,
+		destination: "/:path",
+		type: 301
+	}] : [];
+};
+var resolveFirebasePublicDir = (workspaceRoot, projectRoot, publicDir = ".output/public") => {
+	const resolvedPublicDir = path.isAbsolute(publicDir) ? publicDir : path.join(projectRoot, publicDir);
+	return normalizePath(path.relative(workspaceRoot, resolvedPublicDir));
+};
+var getFirebaseConfig = (workspaceRoot, projectRoot, appConfig, deployConfig) => {
+	const firebase = deployConfig.firebase ?? {};
+	const preset = getFirebaseDeployPreset(deployConfig.preset);
+	const headers = firebase.headers === false ? void 0 : Array.isArray(firebase.headers) ? firebase.headers : getDefaultFirebaseHeaders(appConfig, firebase.headers, preset.fallback);
+	const redirects = [...firebase.redirects ?? [], ...deployConfig.redirectDefaultLanguage ? getDefaultLanguageRedirects(appConfig) : []];
+	const rewrites = firebase.rewrites === false ? void 0 : firebase.rewrites ?? preset.rewrites ?? (preset.fallback ? [{
+		source: "**",
+		destination: preset.fallback
+	}] : void 0);
+	return { hosting: {
+		public: resolveFirebasePublicDir(workspaceRoot, projectRoot, firebase.public ?? preset.public),
+		ignore: firebase.ignore ?? [
+			"firebase.json",
+			"**/.*",
+			"**/node_modules/**",
+			"**/*.d.ts",
+			"**/*.d.ts.map",
+			"**/*.tsbuildinfo"
+		],
+		cleanUrls: firebase.cleanUrls ?? true,
+		...headers ? { headers } : {},
+		...redirects.length > 0 ? { redirects } : {},
+		...rewrites ? { rewrites } : {}
+	} };
+};
+var getFirebaseDeployFile = (workspaceRoot, projectRoot, appConfig, deployConfig) => {
+	const projectPath = resolveProjectPath(workspaceRoot, projectRoot);
+	return {
+		path: path.join(workspaceRoot, "vx/deploy/firebase", `${projectPath}.json`),
+		content: `${JSON.stringify(getFirebaseConfig(workspaceRoot, projectRoot, appConfig, deployConfig), null, 2)}\n`
+	};
+};
+//#endregion
+export { getFirebaseDeployFile };

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

@@ -0,0 +1,4 @@
+import type { GenerateDeployConfigOptions } from './types';
+export type { GenerateDeployConfigOptions } from './types';
+export declare const generateDeployConfig: (options?: GenerateDeployConfigOptions) => string[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,2BAA2B,EAG5B,MAAM,SAAS,CAAA;AAGhB,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAA;AAwD1D,eAAO,MAAM,oBAAoB,GAC/B,UAAS,2BAAgC,aAoB1C,CAAA"}

package/dist/lib/deploy/index.js

@@ -0,0 +1,42 @@
+import { readYamlConfig } from "../yaml-config.js";
+import { getFirebaseDeployFile } from "./firebase.js";
+import { getVercelDeployFile } from "./vercel.js";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+//#region src/lib/deploy/index.ts
+var writeDeployFile = ({ path: file, content }) => {
+	mkdirSync(path.dirname(file), { recursive: true });
+	writeFileSync(file, content);
+};
+var findWorkspaceRoot = (projectRoot) => {
+	let currentDir = path.resolve(projectRoot);
+	while (true) {
+		if (existsSync(path.join(currentDir, "nx.json"))) return currentDir;
+		const parentDir = path.dirname(currentDir);
+		if (parentDir === currentDir) return process.cwd();
+		currentDir = parentDir;
+	}
+};
+var loadYamlConfig = (projectRoot, fileName) => {
+	const configFile = path.resolve(projectRoot, fileName);
+	return existsSync(configFile) ? readYamlConfig(configFile) : void 0;
+};
+var getDeployFiles = (appConfig, deployConfig, projectRoot) => {
+	const workspaceRoot = findWorkspaceRoot(projectRoot);
+	return deployConfig.providers.map((provider) => {
+		if (provider === "firebase") return getFirebaseDeployFile(workspaceRoot, projectRoot, appConfig, deployConfig);
+		if (provider === "vercel") return getVercelDeployFile(workspaceRoot, projectRoot, deployConfig);
+		throw new Error(`Unsupported deploy provider "${provider}"`);
+	});
+};
+var generateDeployConfig = (options = {}) => {
+	const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+	const appConfig = loadYamlConfig(projectRoot, "vx.app.yaml");
+	const deployConfig = loadYamlConfig(projectRoot, "vx.deploy.yaml");
+	if (!appConfig || !deployConfig) return [];
+	const files = getDeployFiles(appConfig, deployConfig, projectRoot);
+	for (const file of files) writeDeployFile(file);
+	return files.map((file) => file.path);
+};
+//#endregion
+export { generateDeployConfig };

package/dist/lib/deploy/paths.d.ts

@@ -0,0 +1,3 @@
+export declare const normalizePath: (value: string) => string;
+export declare const resolveProjectPath: (workspaceRoot: string, projectRoot: string) => string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/deploy/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,WAAoC,CAAA;AAE/E,eAAO,MAAM,kBAAkB,GAC7B,eAAe,MAAM,EACrB,aAAa,MAAM,WACwC,CAAA"}

package/dist/lib/deploy/paths.js

@@ -0,0 +1,6 @@
+import path from "node:path";
+//#region src/lib/deploy/paths.ts
+var normalizePath = (value) => value.split(path.sep).join("/");
+var resolveProjectPath = (workspaceRoot, projectRoot) => normalizePath(path.relative(workspaceRoot, projectRoot));
+//#endregion
+export { normalizePath, resolveProjectPath };

package/dist/lib/deploy/presets.d.ts

@@ -0,0 +1,5 @@
+export declare const cdnRewrites: {
+    source: string;
+    destination: string;
+}[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/lib/deploy/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/presets.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;GASvB,CAAA"}

package/dist/lib/deploy/presets.js

@@ -0,0 +1,10 @@
+//#region src/lib/deploy/presets.ts
+var cdnRewrites = [{
+	source: "/api/heartbeat",
+	destination: "/api/heartbeat.json"
+}, {
+	source: "/api/pulse",
+	destination: "/api/pulse.txt"
+}];
+//#endregion
+export { cdnRewrites };

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

@@ -0,0 +1,97 @@
+export type HostingProvider = 'firebase' | 'vercel';
+/**
+ * Deployment shapes are provider-specific: static Firebase Hosting, or SSR on
+ * Vercel. Choose the preset for the application runtime and routing model.
+ */
+export type DeployPreset = 'cdn' | 'spa' | 'start-spa' | 'next' | 'tanstack-start';
+export type FirebaseDeployPresetName = Exclude<DeployPreset, 'next' | 'tanstack-start'>;
+export type VxDeployConfig = {
+    preset?: DeployPreset;
+    providers: HostingProvider[];
+    redirectDefaultLanguage?: boolean;
+    firebase?: FirebaseDeployConfig;
+    vercel?: VercelDeployConfig;
+};
+export type VxAppConfig = {
+    docs?: {
+        docsRoute?: string;
+    };
+    i18n?: {
+        defaultLanguage: string;
+        languages: string[];
+    };
+    routes?: RouteConfig[];
+};
+export type RouteConfig = {
+    path: string;
+    source?: string;
+};
+export type FirebaseDeployConfig = {
+    cleanUrls?: boolean;
+    headers?: false | FirebaseHeader[] | FirebaseHeaderOptions;
+    ignore?: string[];
+    public?: string;
+    redirects?: FirebaseRedirect[];
+    rewrites?: false | FirebaseRewrite[];
+};
+export type FirebaseHeaderOptions = {
+    app?: boolean;
+    docs?: boolean;
+    routes?: boolean;
+    static?: boolean;
+};
+export type FirebaseHeader = {
+    source: string;
+    headers: Array<{
+        key: string;
+        value: string;
+    }>;
+};
+export type FirebaseRedirect = {
+    source: string;
+    destination: string;
+    type: number;
+};
+export type FirebaseRewrite = {
+    source: string;
+    destination: string;
+};
+export type FirebaseConfig = {
+    hosting: {
+        public: string;
+        ignore: string[];
+        cleanUrls?: boolean;
+        headers?: FirebaseHeader[];
+        redirects?: FirebaseRedirect[];
+        rewrites?: FirebaseRewrite[];
+    };
+};
+export type VercelDeployConfig = {
+    buildCommand?: string;
+};
+export type VercelFramework = 'nextjs' | 'tanstack-start' | 'vite' | null;
+export type VercelConfig = {
+    $schema: string;
+    buildCommand?: string;
+    framework: VercelFramework;
+    outputDirectory?: string;
+    rewrites?: FirebaseRewrite[];
+};
+export type FirebaseDeployPreset = {
+    public: string;
+    fallback?: string;
+    rewrites?: FirebaseRewrite[];
+};
+export type VercelDeployPreset = {
+    framework: VercelFramework;
+    outputDirectory?: string;
+    rewrites?: FirebaseRewrite[];
+};
+export type GenerateDeployConfigOptions = {
+    projectRoot?: string;
+};
+export type DeployFile = {
+    path: string;
+    content: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/deploy/vercel.d.ts

@@ -0,0 +1,3 @@
+import type { DeployFile, VxDeployConfig } from './types';
+export declare const getVercelDeployFile: (workspaceRoot: string, projectRoot: string, deployConfig: VxDeployConfig) => DeployFile;
+//# sourceMappingURL=vercel.d.ts.map

package/dist/lib/deploy/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/lib/deploy/vercel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EAIV,cAAc,EACf,MAAM,SAAS,CAAA;AAsBhB,eAAO,MAAM,mBAAmB,GAC9B,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,cAAc,cAAc,KAC3B,UAqBF,CAAA"}

package/dist/lib/deploy/vercel.js

@@ -0,0 +1,47 @@
+import { resolveProjectPath } from "./paths.js";
+import { cdnRewrites } from "./presets.js";
+import path from "node:path";
+//#region src/lib/deploy/vercel.ts
+var vercelDeployPresets = {
+	cdn: {
+		framework: "vite",
+		outputDirectory: "dist",
+		rewrites: cdnRewrites
+	},
+	spa: {
+		framework: "vite",
+		outputDirectory: "dist",
+		rewrites: [{
+			source: "/(.*)",
+			destination: "/index.html"
+		}]
+	},
+	"start-spa": {
+		framework: null,
+		outputDirectory: ".output/public",
+		rewrites: [{
+			source: "/(.*)",
+			destination: "/_shell.html"
+		}]
+	},
+	next: { framework: "nextjs" },
+	"tanstack-start": { framework: "tanstack-start" }
+};
+var getVercelDeployFile = (workspaceRoot, projectRoot, deployConfig) => {
+	const projectPath = resolveProjectPath(workspaceRoot, projectRoot);
+	const vercel = deployConfig.vercel ?? {};
+	const preset = deployConfig.preset ? vercelDeployPresets[deployConfig.preset] : vercelDeployPresets["start-spa"];
+	const config = {
+		$schema: "https://openapi.vercel.sh/vercel.json",
+		framework: preset.framework,
+		...preset.outputDirectory ? { outputDirectory: preset.outputDirectory } : {},
+		...preset.rewrites ? { rewrites: preset.rewrites } : {},
+		...vercel.buildCommand ? { buildCommand: vercel.buildCommand } : {}
+	};
+	return {
+		path: path.join(workspaceRoot, "vx/deploy/vercel", `${projectPath}.json`),
+		content: `${JSON.stringify(config, null, 2)}\n`
+	};
+};
+//#endregion
+export { getVercelDeployFile };

package/dist/lib/framework.d.ts

@@ -0,0 +1,3 @@
+export type Framework = 'vite' | 'tanstack' | 'tanstack-docs' | 'next';
+export declare const validateFramework: (value: unknown) => Framework;
+//# sourceMappingURL=framework.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/lib/framework.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,MAAM,CAAA;AAEtE,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,SAWlD,CAAA"}

package/dist/lib/framework.js

@@ -0,0 +1,7 @@
+//#region src/lib/framework.ts
+var validateFramework = (value) => {
+	if (value === "vite" || value === "tanstack" || value === "tanstack-docs" || value === "next") return value;
+	throw new Error("vx.app.yaml framework must be vite, tanstack, tanstack-docs, or next");
+};
+//#endregion
+export { validateFramework };

package/dist/lib/i18n.d.ts

@@ -0,0 +1,6 @@
+export type I18nConfig = {
+    defaultLanguage: string;
+    languages: string[];
+};
+export declare const resolveI18n: (i18n?: I18nConfig) => I18nConfig;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/lib/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/lib/i18n.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,KAAG,UAQ/C,CAAA"}

package/dist/lib/i18n.js

@@ -0,0 +1,11 @@
+//#region src/lib/i18n.ts
+var resolveI18n = (i18n) => {
+	const defaultLanguage = i18n?.defaultLanguage ?? "en";
+	const configuredLanguages = i18n?.languages ?? [];
+	return {
+		defaultLanguage,
+		languages: configuredLanguages.includes(defaultLanguage) ? configuredLanguages : [...configuredLanguages, defaultLanguage]
+	};
+};
+//#endregion
+export { resolveI18n };

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

@@ -0,0 +1,4 @@
+import type { WithNxOptions } from '@nx/next/plugins/with-nx';
+export type NextConfig = WithNxOptions;
+export declare const defineConfig: (overrides?: NextConfig) => import("@nx/next/src/utils/config").NextConfigFn;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/next/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,MAAM,MAAM,UAAU,GAAG,aAAa,CAAA;AAYtC,eAAO,MAAM,YAAY,GAAI,YAAW,UAAe,qDAmBtD,CAAA"}

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

@@ -0,0 +1,29 @@
+import { workspaceRoot } from "@nx/devkit";
+import { composePlugins, withNx } from "@nx/next";
+//#region src/lib/integrations/next/index.ts
+var defaults = {
+	nx: {},
+	typescript: { tsconfigPath: "tsconfig.app.json" },
+	turbopack: { root: workspaceRoot }
+};
+var defineConfig = (overrides = {}) => {
+	const config = {
+		...defaults,
+		...overrides,
+		nx: {
+			...defaults.nx,
+			...overrides.nx
+		},
+		typescript: {
+			...defaults.typescript,
+			...overrides.typescript
+		},
+		turbopack: {
+			...defaults.turbopack,
+			...overrides.turbopack
+		}
+	};
+	return composePlugins(withNx)(config);
+};
+//#endregion
+export { defineConfig };

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

@@ -0,0 +1,11 @@
+import type { PlaywrightTestConfig } from '@playwright/test';
+type WebServerConfig = Exclude<NonNullable<PlaywrightTestConfig['webServer']>, unknown[]>;
+export type PlaywrightConfig = Omit<PlaywrightTestConfig, 'webServer'> & {
+    webServer: WebServerConfig;
+};
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+export declare const defineConfig: (configFile: string, config: PlaywrightConfig) => PlaywrightTestConfig<{}, {}>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/playwright/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAS5D,KAAK,eAAe,GAAG,OAAO,CAC5B,WAAW,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,EAC9C,OAAO,EAAE,CACV,CAAA;AAMD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAAG;IACvE,SAAS,EAAE,eAAe,CAAA;CAC3B,CAAA;AAqCD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,QAAQ,gBAAgB,iCAmCxE,CAAA"}

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

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { workspaceRoot } from "@nx/devkit";
+import { nxE2EPreset } from "@nx/playwright/preset";
+import { defineConfig as defineConfig$1, devices } from "@playwright/test";
+import { parseEnv } from "node:util";
+//#region src/lib/integrations/playwright/index.ts
+var isCI = Boolean(process.env.CI);
+var testTimeout = isCI ? 18e4 : 12e4;
+var webServerTimeout = isCI ? 4e5 : 3e5;
+var defaultProjects = [
+	{
+		name: "chromium",
+		use: { ...devices["Desktop Chrome"] }
+	},
+	{
+		name: "firefox",
+		use: { ...devices["Desktop Firefox"] }
+	},
+	{
+		name: "webkit",
+		use: { ...devices["Desktop Safari"] }
+	},
+	{
+		name: "Microsoft Edge",
+		use: {
+			...devices["Desktop Edge"],
+			channel: "msedge"
+		}
+	},
+	{
+		name: "Google Chrome",
+		use: {
+			...devices["Desktop Chrome"],
+			channel: "chrome"
+		}
+	},
+	{
+		name: "Mobile Chrome",
+		use: { ...devices["Pixel 5"] }
+	},
+	{
+		name: "Mobile Safari",
+		use: { ...devices["iPhone 12"] }
+	}
+];
+/**
+* See https://playwright.dev/docs/test-configuration.
+*/
+var defineConfig = (configFile, config) => {
+	const envFile = join(dirname(configFile), ".env");
+	const env = existsSync(envFile) ? parseEnv(readFileSync(envFile, "utf8")) : {};
+	const port = process.env.PRE_PORT || env.PRE_PORT || 8080;
+	const baseURL = process.env.BASE_URL || env.BASE_URL || `http://localhost:${port}`;
+	const { projects, use, webServer, ...restConfig } = config;
+	return defineConfig$1({
+		...nxE2EPreset(configFile, { testDir: "./src" }),
+		timeout: testTimeout,
+		workers: 1,
+		...restConfig,
+		use: {
+			baseURL,
+			trace: "on-first-retry",
+			...use
+		},
+		webServer: {
+			url: baseURL,
+			timeout: webServerTimeout,
+			reuseExistingServer: !isCI && process.env.PLAYWRIGHT_REUSE_SERVER !== "false",
+			cwd: workspaceRoot,
+			...webServer
+		},
+		projects: projects ?? defaultProjects
+	});
+};
+//#endregion
+export { defineConfig };

package/dist/lib/integrations/playwright/test.d.ts

@@ -0,0 +1,5 @@
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+    browserHealth: void;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect } from '@playwright/test';
+//# sourceMappingURL=test.d.ts.map

package/dist/lib/integrations/playwright/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/playwright/test.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,IAAI;mBAAgC,IAAI;wGAyCnD,CAAA;AAEF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/lib/integrations/playwright/test.js

@@ -0,0 +1,23 @@
+import { expect, expect as expect$1, test as test$1 } from "@playwright/test";
+//#region src/lib/integrations/playwright/test.ts
+var test = test$1.extend({ browserHealth: [async ({ page }, use) => {
+	const runtimeErrors = [];
+	const consoleErrors = [];
+	const notFoundDocuments = /* @__PURE__ */ new Set();
+	page.on("pageerror", (error) => runtimeErrors.push(error.message));
+	page.on("console", (message) => {
+		if (message.type() === "error") consoleErrors.push({
+			text: message.text(),
+			url: message.location().url
+		});
+	});
+	page.on("response", (response) => {
+		const request = response.request();
+		if (response.status() === 404 && request.isNavigationRequest() && request.frame() === page.mainFrame()) notFoundDocuments.add(response.url());
+	});
+	await use();
+	const unexpectedErrors = consoleErrors.filter((error) => !(notFoundDocuments.has(error.url) && /^Failed to load resource: the server responded with a status of 404(?: \((?:Not Found)?\))?$/.test(error.text)));
+	expect$1([...runtimeErrors, ...unexpectedErrors.map((error) => error.text)]).toEqual([]);
+}, { auto: true }] });
+//#endregion
+export { expect, test };

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

@@ -0,0 +1,12 @@
+import type { ConfigEnv, UserConfig, UserConfigExport } from 'vite';
+export declare const getProjectPackageName: (projectRoot?: string) => string;
+export declare const getViteCacheDir: (projectRoot?: string) => string;
+export type ViteConfig = UserConfig & {
+    test?: Record<string, unknown>;
+};
+export type ViteConfigFactory = (env: ConfigEnv) => ViteConfig | Promise<ViteConfig>;
+export type ViteConfigOverrides = ViteConfig | ViteConfigFactory;
+export declare const getViteConfig: (projectRoot?: string) => ViteConfig;
+export declare const createViteConfig: (getDefaults: (projectRoot: string, env: ConfigEnv) => ViteConfig, overrides?: ViteConfigOverrides) => UserConfigExport;
+export declare const defineConfig: (overrides?: ViteConfigOverrides) => UserConfigExport;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/integrations/vite/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAgBnE,eAAO,MAAM,qBAAqB,GAAI,oBAA2B,WAYhE,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,oBAA2B,WAKxD,CAAA;AAEH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,SAAS,KACX,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAErC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,iBAAiB,CAAA;AAEhE,eAAO,MAAM,aAAa,GAAI,oBAA2B,KAAG,UAI1D,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAC3B,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,KAAK,UAAU,EAChE,YAAW,mBAAwB,KAClC,gBAYC,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAI,YAAW,mBAAwB,qBACpB,CAAA"}