npm - @untestutils/nuxt - Versions diffs - 0.5.0 - Mend

@untestutils/nuxt 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (70) hide show

package/LICENSE +21 -0
package/dist/config/index.d.mts +58 -0
package/dist/config/index.d.ts +59 -0
package/dist/config/index.d.ts.map +1 -0
package/dist/config/index.mjs +323 -0
package/dist/config/utils.d.mts +12 -0
package/dist/config/utils.d.ts +13 -0
package/dist/config/utils.d.ts.map +1 -0
package/dist/config/utils.mjs +79 -0
package/dist/environment/index.d.mts +22 -0
package/dist/environment/index.d.ts +23 -0
package/dist/environment/index.d.ts.map +1 -0
package/dist/environment/index.mjs +129 -0
package/dist/index.d.mts +36 -0
package/dist/index.d.ts +65 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.mjs +355 -0
package/dist/module/index.d.mts +3 -0
package/dist/module/index.d.ts +4 -0
package/dist/module/index.d.ts.map +1 -0
package/dist/module/index.mjs +294 -0
package/dist/runtime/browser-entry.d.mts +5 -0
package/dist/runtime/browser-entry.d.ts +6 -0
package/dist/runtime/browser-entry.d.ts.map +1 -0
package/dist/runtime/browser-entry.mjs +2 -0
package/dist/runtime/entry.d.mts +1 -0
package/dist/runtime/entry.d.ts +2 -0
package/dist/runtime/entry.d.ts.map +1 -0
package/dist/runtime/entry.mjs +9 -0
package/dist/runtime/index.d.mts +81 -0
package/dist/runtime/index.d.ts +82 -0
package/dist/runtime/index.d.ts.map +1 -0
package/dist/runtime/index.mjs +156 -0
package/dist/runtime/mocks/vue-devtools.d.mts +12 -0
package/dist/runtime/mocks/vue-devtools.d.ts +13 -0
package/dist/runtime/mocks/vue-devtools.d.ts.map +1 -0
package/dist/runtime/mocks/vue-devtools.mjs +12 -0
package/dist/runtime/nuxt-root.d.mts +3 -0
package/dist/runtime/nuxt-root.d.ts +4 -0
package/dist/runtime/nuxt-root.d.ts.map +1 -0
package/dist/runtime/nuxt-root.mjs +29 -0
package/dist/runtime/shared/environment.d.mts +52 -0
package/dist/runtime/shared/environment.d.ts +53 -0
package/dist/runtime/shared/environment.d.ts.map +1 -0
package/dist/runtime/shared/environment.mjs +79 -0
package/dist/runtime/shared/h3-v1.d.mts +7 -0
package/dist/runtime/shared/h3-v1.d.ts +8 -0
package/dist/runtime/shared/h3-v1.d.ts.map +1 -0
package/dist/runtime/shared/h3-v1.mjs +50 -0
package/dist/runtime/shared/h3-v2.d.mts +7 -0
package/dist/runtime/shared/h3-v2.d.ts +8 -0
package/dist/runtime/shared/h3-v2.d.ts.map +1 -0
package/dist/runtime/shared/h3-v2.mjs +32 -0
package/dist/runtime/shared/h3.d.mts +4 -0
package/dist/runtime/shared/h3.d.ts +5 -0
package/dist/runtime/shared/h3.d.ts.map +1 -0
package/dist/runtime/shared/h3.mjs +3 -0
package/dist/runtime/shared/nuxt.d.mts +2 -0
package/dist/runtime/shared/nuxt.d.ts +3 -0
package/dist/runtime/shared/nuxt.d.ts.map +1 -0
package/dist/runtime/shared/nuxt.mjs +17 -0
package/dist/runtime/shared/vue-wrapper-plugin.d.mts +12 -0
package/dist/runtime/shared/vue-wrapper-plugin.d.ts +13 -0
package/dist/runtime/shared/vue-wrapper-plugin.d.ts.map +1 -0
package/dist/runtime/shared/vue-wrapper-plugin.mjs +42 -0
package/dist/runtime/suspended.d.mts +45 -0
package/dist/runtime/suspended.d.ts +46 -0
package/dist/runtime/suspended.d.ts.map +1 -0
package/dist/runtime/suspended.mjs +259 -0
package/package.json +150 -0

package/dist/environment/index.mjs ADDED Viewed

@@ -0,0 +1,129 @@
+import { defu } from "defu";
+import { joinURL } from "ufo";
+import { getPackageInfoSync } from "local-pkg";
+import { indexedDB } from "fake-indexeddb";
+import { setupWindow } from "../runtime/shared/environment.mjs";
+const happyDomEnvironment = async (_global, { happyDom = {} }) => {
+	const { Window, GlobalWindow } = await import("happy-dom");
+	const window = new (GlobalWindow || Window)(happyDom);
+	return {
+		window,
+		teardown() {
+			window.happyDOM.abort();
+		}
+	};
+};
+const jsdomEnvironment = async (global, { jsdom = {} }) => {
+	const { CookieJar, JSDOM, ResourceLoader, VirtualConsole } = await import("jsdom");
+	const jsdomOptions = defu(jsdom, {
+		html: "<!DOCTYPE html>",
+		url: "http://localhost:3000",
+		contentType: "text/html",
+		pretendToBeVisual: true,
+		includeNodeLocations: false,
+		runScripts: "dangerously",
+		console: false,
+		cookieJar: false
+	});
+	const virtualConsole = jsdomOptions.console && global.console ? new VirtualConsole() : undefined;
+	const forwardConsole = virtualConsole ? forwardVirtualConsole(virtualConsole, global.console) : undefined;
+	const window = new JSDOM(jsdomOptions.html ?? "<!DOCTYPE html>", {
+		...jsdomOptions,
+		resources: jsdomOptions.resources ?? (jsdomOptions.userAgent ? new ResourceLoader({ userAgent: jsdomOptions.userAgent }) : undefined),
+		virtualConsole: forwardConsole,
+		cookieJar: jsdomOptions.cookieJar ? new CookieJar() : undefined
+	}).window;
+	window.scrollTo = () => {};
+	return {
+		window,
+		teardown() {
+			window.close();
+		}
+	};
+};
+const environmentMap = {
+	"happy-dom": happyDomEnvironment,
+	jsdom: jsdomEnvironment
+};
+const vitestMajor = Number(getPackageInfoSync("vitest")?.version?.split(".")[0]);
+class IntersectionObserverStub {
+	root = null;
+	rootMargin = "";
+	scrollMargin = "";
+	thresholds = [];
+	observe() {}
+	unobserve() {}
+	disconnect() {}
+	takeRecords() {
+		return [];
+	}
+}
+function forwardVirtualConsole(virtualConsole, console) {
+	if ("sendTo" in virtualConsole && typeof virtualConsole.sendTo === "function") {
+		return virtualConsole.sendTo(console);
+	}
+	return virtualConsole.forwardTo(console);
+}
+async function importVitestEnvironments() {
+	const sub = vitestMajor >= 5 ? "runtime" : "environments";
+	return import(
+		/* @vite-ignore */
+		`vitest/${sub}`
+);
+}
+function resolveDomFactory(name) {
+	if (name === "jsdom") return environmentMap.jsdom;
+	return environmentMap["happy-dom"];
+}
+const environment = {
+	name: "untestutils",
+	viteEnvironment: "client",
+	async setup(global, environmentOptions) {
+		const { populateGlobal } = await importVitestEnvironments();
+		const url = joinURL(environmentOptions.nuxt?.url ?? "http://localhost:3000", environmentOptions.nuxtRuntimeConfig?.app?.baseURL || "/");
+		const { window: win, teardown } = await resolveDomFactory(environmentOptions.nuxt?.domEnvironment)(global, defu(environmentOptions, {
+			happyDom: { url },
+			jsdom: { url }
+		}));
+		if (environmentOptions.nuxt?.mock?.intersectionObserver) {
+			win.IntersectionObserver ||= IntersectionObserverStub;
+		}
+		if (environmentOptions.nuxt?.mock?.indexedDb) {
+			win.indexedDB = indexedDB;
+		}
+		const teardownWindow = await setupWindow(win, {
+			...environmentOptions,
+			nuxt: {
+				rootId: environmentOptions.nuxt?.rootId,
+				h3Version: environmentOptions.nuxt?.h3Version,
+				url: environmentOptions.nuxt?.url,
+				domEnvironment: environmentOptions.nuxt?.domEnvironment,
+				mock: environmentOptions.nuxt?.mock
+			}
+		});
+		const { keys, originals } = populateGlobal(global, win, {
+			bindFunctions: true,
+			additionalKeys: ["fetch", "Request"]
+		});
+		return { teardown() {
+			keys.forEach((key) => {
+				Reflect.deleteProperty(global, key);
+			});
+			teardownWindow();
+			if (vitestMajor >= 5) {
+				originals.forEach((descriptor, k) => {
+					Object.defineProperty(global, k, descriptor);
+				});
+			} else {
+				originals.forEach((v, k) => {
+					Reflect.set(global, k, v);
+				});
+			}
+			if (!global.IntersectionObserver) {
+				global.IntersectionObserver = IntersectionObserverStub;
+			}
+			teardown();
+		} };
+	}
+};
+export default environment;

package/dist/index.d.mts ADDED Viewed

@@ -0,0 +1,36 @@
+import { waitForHttpReady, type Recipe } from "@untestutils/core";
+export type NuxtRun = "server" | "static" | "dev";
+export interface NuxtOptions {
+	id?: string;
+	root: string;
+	run?: NuxtRun;
+	nuxtConfig?: Record<string, unknown>;
+	hashInputs?: string[];
+	/** Include nearby monorepo package src dirs in prepare hash (auto when workspace exists). */
+	workspaceDeps?: boolean | "auto";
+	/** Build/runtime env (e.g. STRATEGY=prefix for fixture variants). */
+	env?: Record<string, string>;
+	readyTimeoutMs?: number;
+	/**
+	* Nitro deploy preset (`node-server`, `azure`, `cloudflare_module`, …).
+	* Merged into `nuxtConfig.nitro.preset` and included in the prepare hash.
+	*/
+	preset?: string;
+}
+export declare const _internals: NuxtInternals;
+/**
+* Nuxt Recipe factory.
+* `run: 'server'` — buildNuxt + node nitro server
+* `run: 'static'` — generate + static file server
+* `run: 'dev'` — nuxi `_dev` only (HMR fixtures; never shared). Default path is still build → nitro.
+*/
+export declare function nuxt(opts: NuxtOptions): Recipe;
+export { waitForHttpReady };
+export type MatrixVariant = Partial<Pick<NuxtOptions, "env" | "nuxtConfig" | "hashInputs" | "run" | "preset" | "readyTimeoutMs" | "workspaceDeps">>;
+/**
+* Expand one Nuxt recipe base into many recipes with distinct ids / identity.
+* Variant key `default` keeps `base.id`; other keys become `${baseId}__${key}`.
+*/
+export declare function matrix(base: NuxtOptions, variants: Record<string, MatrixVariant>): Record<string, Recipe>;
+/** Nuxt-aware goto wait helpers are provided by vitest/playwright runners via playwright page. */
+export default nuxt;

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,65 @@
+import { waitForHttpReady, type Recipe } from '@untestutils/core';
+export type NuxtRun = 'server' | 'static' | 'dev';
+export interface NuxtOptions {
+    id?: string;
+    root: string;
+    run?: NuxtRun;
+    nuxtConfig?: Record<string, unknown>;
+    hashInputs?: string[];
+    /** Include nearby monorepo package src dirs in prepare hash (auto when workspace exists). */
+    workspaceDeps?: boolean | 'auto';
+    /** Build/runtime env (e.g. STRATEGY=prefix for fixture variants). */
+    env?: Record<string, string>;
+    readyTimeoutMs?: number;
+    /**
+     * Nitro deploy preset (`node-server`, `azure`, `cloudflare_module`, …).
+     * Merged into `nuxtConfig.nitro.preset` and included in the prepare hash.
+     */
+    preset?: string;
+}
+declare function resolveKit(rootDir: string): string;
+/**
+ * Resolve Nuxt CLI entry for `run: 'dev'`.
+ * Prefers legacy `nuxi/cli`; falls back to `nuxt/bin/nuxt.mjs` (Nuxt 4 / @nuxt/cli).
+ * Walks fixture → cwd → workspace root so bare fixture package.json still works.
+ */
+declare function resolveNuxiEntry(rootDir: string): string;
+declare function findWorkspaceRoot(from: string): string | undefined;
+declare function workspacePackageSrcDirs(from: string): Promise<string[]>;
+declare function resolveHashInputs(opts: NuxtOptions, root: string): Promise<string[]>;
+declare function withEnv<T>(env: Record<string, string> | undefined, fn: () => Promise<T>): Promise<T>;
+declare function buildNuxtApp(rootDir: string, outDir: string, nuxtConfig?: Record<string, unknown>, ssr?: boolean): Promise<void>;
+declare function generateNuxtApp(rootDir: string, outDir: string, nuxtConfig?: Record<string, unknown>): Promise<void>;
+declare function findServerEntry(outDir: string): string;
+declare function findPublicDir(outDir: string): string;
+/** @internal test seams */
+export interface NuxtInternals {
+    resolveKit: typeof resolveKit;
+    resolveNuxiEntry: typeof resolveNuxiEntry;
+    buildNuxtApp: typeof buildNuxtApp;
+    generateNuxtApp: typeof generateNuxtApp;
+    findServerEntry: typeof findServerEntry;
+    findPublicDir: typeof findPublicDir;
+    findWorkspaceRoot: typeof findWorkspaceRoot;
+    workspacePackageSrcDirs: typeof workspacePackageSrcDirs;
+    resolveHashInputs: typeof resolveHashInputs;
+    withEnv: typeof withEnv;
+}
+export declare const _internals: NuxtInternals;
+/**
+ * Nuxt Recipe factory.
+ * `run: 'server'` — buildNuxt + node nitro server
+ * `run: 'static'` — generate + static file server
+ * `run: 'dev'` — nuxi `_dev` only (HMR fixtures; never shared). Default path is still build → nitro.
+ */
+export declare function nuxt(opts: NuxtOptions): Recipe;
+export { waitForHttpReady };
+export type MatrixVariant = Partial<Pick<NuxtOptions, 'env' | 'nuxtConfig' | 'hashInputs' | 'run' | 'preset' | 'readyTimeoutMs' | 'workspaceDeps'>>;
+/**
+ * Expand one Nuxt recipe base into many recipes with distinct ids / identity.
+ * Variant key `default` keeps `base.id`; other keys become `${baseId}__${key}`.
+ */
+export declare function matrix(base: NuxtOptions, variants: Record<string, MatrixVariant>): Record<string, Recipe>;
+/** Nuxt-aware goto wait helpers are provided by vitest/playwright runners via playwright page. */
+export default nuxt;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/index.mjs ADDED Viewed

@@ -0,0 +1,355 @@
+import { createRequire } from "node:module";
+import { existsSync } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { dirname, join, resolve } from "pathe";
+import { pathToFileURL } from "node:url";
+import { defineRecipe, loopbackUrl, waitForHttpReady, spawnManaged, withQuietLogger } from "@untestutils/core";
+import { assertAppRoot, staticDir } from "@untestutils/core";
+function resolveKit(rootDir) {
+	assertAppRoot(rootDir, "nuxt", { requirePackageJson: false });
+	try {
+		return createRequire(join(rootDir, "package.json")).resolve("@nuxt/kit");
+	} catch (e) {
+		throw new Error(`[untestutils/nuxt] cannot resolve @nuxt/kit from ${rootDir} (install nuxt or @nuxt/kit in the fixture/workspace)`, { cause: e });
+	}
+}
+function resolveNuxiEntry(rootDir) {
+	const roots = [
+		rootDir,
+		process.cwd(),
+		findWorkspaceRoot(rootDir)
+	].filter((d) => Boolean(d));
+	const seen = new Set();
+	for (const dir of roots) {
+		const key = resolve(dir);
+		if (seen.has(key)) continue;
+		seen.add(key);
+		try {
+			return createRequire(join(dir, "package.json")).resolve("nuxi/cli");
+		} catch {}
+	}
+	for (const dir of roots) {
+		const key = resolve(dir);
+		try {
+			const nuxtPkg = createRequire(join(key, "package.json")).resolve("nuxt/package.json");
+			const bin = join(dirname(nuxtPkg), "bin/nuxt.mjs");
+			if (existsSync(bin)) return bin;
+		} catch {}
+	}
+	throw new Error(`[untestutils/nuxt] cannot resolve Nuxt CLI from ${rootDir} (tried nuxi/cli and nuxt/bin/nuxt.mjs)`);
+}
+function findWorkspaceRoot(from) {
+	let dir = resolve(from);
+	for (let i = 0; i < 12; i++) {
+		if (existsSync(join(dir, "pnpm-workspace.yaml")) || existsSync(join(dir, "pnpm-workspace.yml"))) {
+			return dir;
+		}
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return undefined;
+}
+async function workspacePackageSrcDirs(from) {
+	const ws = findWorkspaceRoot(from);
+	if (!ws) return [];
+	const packagesDir = join(ws, "packages");
+	if (!existsSync(packagesDir)) return [];
+	const names = await readdir(packagesDir, { withFileTypes: true }).catch(() => []);
+	const out = [];
+	for (const e of names) {
+		if (!e.isDirectory()) continue;
+		const src = join(packagesDir, e.name, "src");
+		if (existsSync(src)) out.push(src);
+	}
+	return out;
+}
+async function resolveHashInputs(opts, root) {
+	const inputs = [...opts.hashInputs ?? [root]];
+	const wantWs = opts.workspaceDeps === true || opts.workspaceDeps !== false && Boolean(findWorkspaceRoot(root));
+	if (wantWs) {
+		inputs.push(...await workspacePackageSrcDirs(root));
+	}
+	if (opts.env && Object.keys(opts.env).length) {
+		inputs.push(`env:${JSON.stringify(opts.env)}`);
+	}
+	if (opts.nuxtConfig) {
+		inputs.push(`nuxtConfig:${JSON.stringify(opts.nuxtConfig)}`);
+	}
+	if (opts.preset) {
+		inputs.push(`preset:${opts.preset}`);
+	}
+	return inputs;
+}
+function mergeNuxtConfig(opts) {
+	const base = { ...opts.nuxtConfig ?? {} };
+	if (!opts.preset) return base;
+	const nitro = {
+		...base.nitro ?? {},
+		preset: opts.preset
+	};
+	return {
+		...base,
+		nitro
+	};
+}
+async function withEnv(env, fn) {
+	if (!env || !Object.keys(env).length) return fn();
+	const prev = {};
+	for (const [k, v] of Object.entries(env)) {
+		prev[k] = process.env[k];
+		process.env[k] = v;
+	}
+	try {
+		return await fn();
+	} finally {
+		for (const [k, v] of Object.entries(prev)) {
+			if (v === undefined) delete process.env[k];
+			else process.env[k] = v;
+		}
+	}
+}
+async function buildNuxtApp(rootDir, outDir, nuxtConfig, ssr = true) {
+	return withQuietLogger(async () => {
+		const kit = await import(pathToFileURL(_internals.resolveKit(rootDir)).href);
+		const nuxt = await kit.loadNuxt({
+			cwd: rootDir,
+			dev: false,
+			overrides: {
+				...nuxtConfig ?? {},
+				ssr,
+				buildDir: join(outDir, ".nuxt"),
+				sourcemap: {
+					server: false,
+					client: false
+				},
+				vite: { build: { minify: false } },
+				nitro: {
+					output: { dir: join(outDir, "output") },
+					minify: false,
+					...nuxtConfig?.nitro ?? {}
+				}
+			}
+		});
+		try {
+			if (!ssr) {}
+			await kit.buildNuxt(nuxt);
+		} finally {
+			await nuxt.close().catch(() => {});
+		}
+	});
+}
+async function generateNuxtApp(rootDir, outDir, nuxtConfig) {
+	return withQuietLogger(async () => {
+		const kit = await import(pathToFileURL(_internals.resolveKit(rootDir)).href);
+		const nuxt = await kit.loadNuxt({
+			cwd: rootDir,
+			dev: false,
+			overrides: {
+				...nuxtConfig ?? {},
+				ssr: true,
+				buildDir: join(outDir, ".nuxt"),
+				nitro: {
+					output: { dir: join(outDir, "output") },
+					static: true,
+					prerender: { crawlLinks: true },
+					...nuxtConfig?.nitro ?? {}
+				}
+			}
+		});
+		try {
+			await kit.buildNuxt(nuxt);
+		} finally {
+			await nuxt.close().catch(() => {});
+		}
+	});
+}
+function findServerEntry(outDir) {
+	const candidates = [join(outDir, "output", "server", "index.mjs"), join(outDir, "output", "server", "index.js")];
+	for (const c of candidates) {
+		if (existsSync(c)) return c;
+	}
+	throw new Error(`[untestutils/nuxt] server entry not found under ${outDir}/output/server`);
+}
+function findPublicDir(outDir) {
+	const candidates = [join(outDir, "output", "public"), join(outDir, "dist")];
+	for (const c of candidates) {
+		if (existsSync(c)) return c;
+	}
+	throw new Error(`[untestutils/nuxt] public dir not found under ${outDir}`);
+}
+export const _internals = {
+	resolveKit,
+	resolveNuxiEntry,
+	buildNuxtApp,
+	generateNuxtApp,
+	findServerEntry,
+	findPublicDir,
+	findWorkspaceRoot,
+	workspacePackageSrcDirs,
+	resolveHashInputs,
+	withEnv
+};
+export function nuxt(opts) {
+	const root = resolve(opts.root);
+	const runMode = opts.run ?? "server";
+	const id = opts.id ?? `nuxt-${runMode}-${root.split("/").pop()}`;
+	const startEnv = { ...opts.env ?? {} };
+	const ensureRoot = () => assertAppRoot(root, "nuxt", { requirePackageJson: false });
+	if (runMode === "dev") {
+		const recipe = defineRecipe({
+			id,
+			share: "never",
+			hashInputs: async () => _internals.resolveHashInputs(opts, root),
+			ready: async () => {},
+			start: async ({ port, host }) => {
+				ensureRoot();
+				return _internals.withEnv(opts.env, async () => {
+					const nuxi = _internals.resolveNuxiEntry(root);
+					const managed = spawnManaged(process.execPath, [nuxi, "_dev"], {
+						cwd: root,
+						env: {
+							...process.env,
+							...startEnv,
+							PORT: String(port),
+							HOST: host,
+							NODE_ENV: "development",
+							NUXT_IGNORE_LOCK: "1"
+						},
+						captureLogs: true
+					});
+					const url = loopbackUrl(port, "/", host);
+					try {
+						await waitForHttpReady(url, {
+							timeoutMs: opts.readyTimeoutMs ?? 18e4,
+							rejectBodyIncludes: ["__NUXT_LOADING__"]
+						});
+					} catch (e) {
+						await managed.stop();
+						throw new Error(`[untestutils/nuxt] ready failed:\n${e}\n--- logs ---\n${managed.logs().slice(-4e3)}`);
+					}
+					return {
+						kind: "url",
+						url,
+						stop: managed.stop,
+						pid: managed.pid
+					};
+				});
+			}
+		});
+		recipe.root = root;
+		return recipe;
+	}
+	if (runMode === "static") {
+		const recipe = defineRecipe({
+			id,
+			share: "always",
+			hashInputs: async () => _internals.resolveHashInputs(opts, root),
+			ready: async () => {},
+			prepare: async ({ outDir }) => {
+				ensureRoot();
+				await _internals.withEnv(opts.env, () => _internals.generateNuxtApp(root, outDir, mergeNuxtConfig(opts)));
+			},
+			start: async (ctx) => {
+				const publicDir = _internals.findPublicDir(ctx.outDir);
+				const serving = staticDir({
+					id: `${id}-static-serve`,
+					root: publicDir
+				});
+				return serving.start(ctx);
+			}
+		});
+		recipe.root = root;
+		return recipe;
+	}
+	const recipe = defineRecipe({
+		id,
+		share: "always",
+		hashInputs: async () => _internals.resolveHashInputs(opts, root),
+		ready: async () => {},
+		prepare: async ({ outDir }) => {
+			ensureRoot();
+			await _internals.withEnv(opts.env, () => _internals.buildNuxtApp(root, outDir, mergeNuxtConfig(opts), true));
+		},
+		start: async ({ port, host, outDir }) => {
+			ensureRoot();
+			const entry = _internals.findServerEntry(outDir);
+			const managed = spawnManaged(process.execPath, [entry], {
+				cwd: root,
+				env: {
+					...process.env,
+					...startEnv,
+					PORT: String(port),
+					HOST: host,
+					NODE_ENV: "production"
+				},
+				captureLogs: true
+			});
+			const url = loopbackUrl(port, "/", host);
+			try {
+				await waitForHttpReady(url, { timeoutMs: opts.readyTimeoutMs ?? 6e4 });
+			} catch (e) {
+				await managed.stop();
+				throw new Error(`[untestutils/nuxt] ready failed:\n${e}\n--- logs ---\n${managed.logs().slice(-4e3)}`);
+			}
+			return {
+				kind: "url+dir",
+				url,
+				dir: outDir,
+				stop: managed.stop,
+				pid: managed.pid
+			};
+		}
+	});
+	recipe.root = root;
+	return recipe;
+}
+export { waitForHttpReady };
+export function matrix(base, variants) {
+	if (!base.root) {
+		throw new Error("[untestutils/nuxt] matrix() requires base.root");
+	}
+	const baseId = base.id ?? `nuxt-${base.run ?? "server"}`;
+	const out = {};
+	for (const [name, patch] of Object.entries(variants)) {
+		const id = name === "default" ? baseId : `${baseId}__${name}`;
+		if (out[id]) {
+			throw new Error(`[untestutils/nuxt] matrix() duplicate id "${id}"`);
+		}
+		const baseNitro = base.nuxtConfig?.nitro ?? {};
+		const patchNitro = patch.nuxtConfig?.nitro ?? {};
+		const merged = {
+			...base,
+			...patch,
+			id,
+			env: {
+				...base.env ?? {},
+				...patch.env ?? {}
+			},
+			nuxtConfig: {
+				...base.nuxtConfig ?? {},
+				...patch.nuxtConfig ?? {},
+				nitro: {
+					...baseNitro,
+					...patchNitro
+				}
+			},
+			hashInputs: [
+				...base.hashInputs ?? [base.root],
+				...patch.hashInputs ?? [],
+				`variant:${name}`
+			]
+		};
+		out[id] = nuxt(merged);
+	}
+	return out;
+}
+export default nuxt;

package/dist/module/index.d.mts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { NuxtModule } from "@nuxt/schema";
+declare const untestutilsModule: NuxtModule;
+export default untestutilsModule;

package/dist/module/index.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import type { NuxtModule } from '@nuxt/schema';
+declare const untestutilsModule: NuxtModule;
+export default untestutilsModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/module/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAA8B,UAAU,EAAE,MAAM,cAAc,CAAC;AAgW3E,QAAA,MAAM,iBAAiB,EAAE,UA4DvB,CAAC;AAEH,eAAe,iBAAiB,CAAC"}