@untestutils/vitest 0.5.1 → 0.5.3

package/dist/fixtures.d.mts

@@ -1,4 +1,4 @@
-import type { APIRequestContext, BrowserContext, Page, Response } from "playwright-core";
+import type { APIRequestContext, Browser, BrowserContext, Page, Response } from "playwright-core";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, type TestAPI } from "vitest";
 import { type Recipe } from "@untestutils/core";
 import { type HarnessBrowserName } from "./browsers.mjs";
@@ -8,8 +8,10 @@ export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserN
 export interface HarnessFixtures {
 	/** Recipe id or Recipe — set via `test.override({ harness: 'site' })`. */
 	harness: string | Recipe | undefined;
-	/** Playwright engine — from `UNTESTUTILS_BROWSER` or plugin `browsers`. */
+	/** Playwright engine — from inject / `UNTESTUTILS_BROWSER` / plugin `browsers`. */
 	browserName: HarnessBrowserName;
+	/** Worker-scoped Playwright browser (one launch per worker). */
+	browser: Browser;
 	page: Page;
 	goto: (path: string, options?: Record<string, unknown>) => Promise<Response | null>;
 	baseURL: string;

package/dist/fixtures.d.ts

@@ -8,8 +8,10 @@ export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserN
 export interface HarnessFixtures {
     /** Recipe id or Recipe — set via `test.override({ harness: 'site' })`. */
     harness: string | Recipe | undefined;
-    /** Playwright engine — from `UNTESTUTILS_BROWSER` or plugin `browsers`. */
+    /** Playwright engine — from inject / `UNTESTUTILS_BROWSER` / plugin `browsers`. */
     browserName: HarnessBrowserName;
+    /** Worker-scoped Playwright browser (one launch per worker). */
+    browser: Browser;
     page: Page;
     goto: (path: string, options?: Record<string, unknown>) => Promise<Response | null>;
     baseURL: string;
@@ -20,10 +22,6 @@ export declare const browserApi: {
     launch: (name?: HarnessBrowserName) => Promise<Browser>;
 };
 /** @internal */
-export declare function getBrowser(name?: HarnessBrowserName): Promise<Browser>;
-/** @internal reset for tests */
-export declare function resetBrowserPromise(): void;
-/** @internal */
 export declare function resolveBaseURL(): Promise<string>;
 type CookieInput = Parameters<BrowserContext['addCookies']>[0][number];
 type GotoFixture = (path: string, options?: Record<string, unknown>) => Promise<Response | null>;

package/dist/fixtures.d.ts.map

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

package/dist/fixtures.mjs

@@ -1,9 +1,10 @@
-import { afterAll, afterEach, beforeAll, beforeEach, describe, test as base } from "vitest";
+import { afterAll, afterEach, beforeAll, beforeEach, describe, inject, test as base } from "vitest";
 import { getCurrentHarness, normalizeBaseUrl, useHarness } from "@untestutils/core";
 import { resolveHarnessBrowserName } from "./browsers.mjs";
+import { providedContextAugmentation } from "./provided-context.mjs";
+void providedContextAugmentation;
 export { afterAll, afterEach, beforeAll, beforeEach, describe };
 export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserName } from "./browsers.mjs";
-const browserPromises = new Map();
 
 export const browserApi = { 
 
@@ -15,19 +16,12 @@ async launch(name = "chromium") {
 	}
 	return launcher.launch({ headless: true });
 } };
-
-export function getBrowser(name) {
-	const browserName = name ?? resolveHarnessBrowserName();
-	let p = browserPromises.get(browserName);
-	if (!p) {
-		p = browserApi.launch(browserName);
-		browserPromises.set(browserName, p);
-	}
-	return p;
-}
-
-export function resetBrowserPromise() {
-	browserPromises.clear();
+function resolveBrowserNameFromInject() {
+	try {
+		const injected = inject("untestutilsBrowser");
+		if (injected) return injected;
+	} catch {}
+	return resolveHarnessBrowserName();
 }
 
 export async function resolveBaseURL() {
@@ -93,12 +87,13 @@ export async function waitForNuxt(page, mode) {
 }
 
 export async function usePageFixture(baseURL, use) {
-	const browser = await getBrowser();
+	const browser = await browserApi.launch();
 	const context = await browser.newContext({ baseURL });
 	patchContextCookies(context, baseURL);
 	const page = await context.newPage();
 	await use(page);
 	await context.close().catch(() => {});
+	await browser.close().catch(() => {});
 }
 
 export async function useRequestFixture(baseURL, use) {
@@ -123,11 +118,21 @@ export async function importExpectModule() {
 }
 export { expect } from "@playwright/test";
 
-export const test = base.extend("harness", undefined).extend("browserName", () => resolveHarnessBrowserName()).extend("baseURL", async ({ harness }) => {
+export const test = base.extend("harness", undefined).extend("browserName", () => resolveBrowserNameFromInject()).extend(
+	"browser",
+	{ scope: "worker" },
+	
+	
+	async ({}, { onCleanup }) => {
+		const browserName = resolveBrowserNameFromInject();
+		const browser = await browserApi.launch(browserName);
+		onCleanup(() => browser.close().catch(() => {}));
+		return browser;
+	}
+).extend("baseURL", async ({ harness }) => {
 	if (harness) await useHarness(harness);
 	return resolveBaseURL();
-}).extend("page", async ({ baseURL, browserName }, { onCleanup }) => {
-	const browser = await getBrowser(browserName);
+}).extend("page", async ({ baseURL, browser }, { onCleanup }) => {
 	const context = await browser.newContext({ baseURL });
 	patchContextCookies(context, baseURL);
 	const page = await context.newPage();

package/dist/global-setup.d.mts

@@ -1,2 +1,2 @@
 import type { TestProject } from "vitest/node";
-export default function globalSetup(_project: TestProject): Promise<() => Promise<void>>;
+export default function globalSetup(project: TestProject): Promise<() => Promise<void>>;

package/dist/global-setup.d.ts

@@ -1,3 +1,3 @@
 import type { TestProject } from 'vitest/node';
-export default function globalSetup(_project: TestProject): Promise<() => Promise<void>>;
+export default function globalSetup(project: TestProject): Promise<() => Promise<void>>;
 //# sourceMappingURL=global-setup.d.ts.map

package/dist/global-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-setup.d.ts","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAkB/C,wBAA8B,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA0C7F"}
+{"version":3,"file":"global-setup.d.ts","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8B/C,wBAA8B,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAyD5F"}

package/dist/global-setup.mjs

@@ -1,11 +1,21 @@
 import { pathToFileURL } from "node:url";
 import { ensurePrepared, stopAllTargets, reclaimStaleTargets, getRegisteredRecipe, listRegisteredRecipes, resolveArtifactsRoot, TargetRegistry, progress } from "@untestutils/core";
+import { providedContextAugmentation } from "./provided-context.mjs";
+void providedContextAugmentation;
 async function loadRecipesModule() {
 	const mod = process.env.UNTESTUTILS_RECIPES_MODULE;
 	if (!mod) return;
 	await import(pathToFileURL(mod).href);
 }
-export default async function globalSetup(_project) {
+function readRegistryUrls(artifactsRoot, map) {
+	const urls = {};
+	for (const [id, entry] of Object.entries(map)) {
+		if (entry?.url) urls[id] = entry.url;
+	}
+	void artifactsRoot;
+	return urls;
+}
+export default async function globalSetup(project) {
 	await loadRecipesModule();
 	const artifactsRoot = resolveArtifactsRoot();
 	
@@ -28,10 +38,21 @@ export default async function globalSetup(_project) {
 		}
 		progress.waveReady();
 		progress.massRun();
-	} else {
-		const registry = new TargetRegistry(artifactsRoot);
-		const map = await registry.read();
-		registry.applyAllToEnv(map);
+	}
+	const registry = new TargetRegistry(artifactsRoot);
+	const map = await registry.read();
+	registry.applyAllToEnv(map);
+	const urls = readRegistryUrls(artifactsRoot, map);
+	const browsers = JSON.parse(process.env.UNTESTUTILS_BROWSERS || "[\"chromium\"]");
+	const payload = {
+		recipesModule: process.env.UNTESTUTILS_RECIPES_MODULE,
+		artifactsRoot,
+		session: process.env.UNTESTUTILS_SESSION,
+		browsers,
+		urls
+	};
+	if (typeof project?.provide === "function") {
+		project.provide("untestutils", payload);
 	}
 	void listRegisteredRecipes();
 	return async () => {

package/dist/index.d.mts

@@ -3,10 +3,10 @@
 * Config files must import the plugin from `untestutils/vitest/plugin`
 * so `test.extend` is not evaluated during config load.
 */
-export { untestutils } from "./plugin.mjs";
-export type { UntestutilsPluginOptions } from "./plugin.mjs";
-export { useHarness, defineRecipes, defineRecipe } from "@untestutils/core";
-export type { HarnessHandle, Recipe } from "@untestutils/core";
+export { untestutils, createVitestProjects } from "./plugin.mjs";
+export type { UntestutilsPluginOptions, UntestutilsProvidedSession } from "./plugin.mjs";
+export { useHarness, defineRecipes, defineRecipe, leaseTarget, prepareOnce, withHarness } from "@untestutils/core";
+export type { HarnessHandle, Recipe, LeasedTarget } from "@untestutils/core";
 export { describe, expect, test, beforeAll, afterAll, beforeEach, afterEach } from "./fixtures.mjs";
 export type { HarnessFixtures, HarnessBrowserName } from "./fixtures.mjs";
 export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserName } from "./browsers.mjs";

package/dist/index.d.ts

@@ -3,10 +3,10 @@
  * Config files must import the plugin from `untestutils/vitest/plugin`
  * so `test.extend` is not evaluated during config load.
  */
-export { untestutils } from './plugin';
-export type { UntestutilsPluginOptions } from './plugin';
-export { useHarness, defineRecipes, defineRecipe } from '@untestutils/core';
-export type { HarnessHandle, Recipe } from '@untestutils/core';
+export { untestutils, createVitestProjects } from './plugin';
+export type { UntestutilsPluginOptions, UntestutilsProvidedSession } from './plugin';
+export { useHarness, defineRecipes, defineRecipe, leaseTarget, prepareOnce, withHarness, } from '@untestutils/core';
+export type { HarnessHandle, Recipe, LeasedTarget } from '@untestutils/core';
 export { describe, expect, test, beforeAll, afterAll, beforeEach, afterEach } from './fixtures';
 export type { HarnessFixtures, HarnessBrowserName } from './fixtures';
 export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserName, } from './browsers';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAChG,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AACrF,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAChG,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 
-export { untestutils } from "./plugin.mjs";
-export { useHarness, defineRecipes, defineRecipe } from "@untestutils/core";
+export { untestutils, createVitestProjects } from "./plugin.mjs";
+export { useHarness, defineRecipes, defineRecipe, leaseTarget, prepareOnce, withHarness } from "@untestutils/core";
 export { describe, expect, test, beforeAll, afterAll, beforeEach, afterEach } from "./fixtures.mjs";
 export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserName } from "./browsers.mjs";

package/dist/plugin.d.mts

@@ -5,6 +5,7 @@ export type { CreateCoverageConfigOptions, CoverageThresholds, UntestutilsCovera
 export { createCoverageConfig, DEFAULT_COVERAGE_THRESHOLDS, UNTESTUTILS_WORKSPACE_PACKAGES } from "./coverage.mjs";
 export type { HarnessBrowserName } from "./browsers.mjs";
 export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserName } from "./browsers.mjs";
+export type { UntestutilsProvidedSession } from "./provided-context.mjs";
 export interface UntestutilsPluginOptions {
 	/**
 	* Recipe map from `defineRecipes(...)` — import and pass it.
@@ -21,9 +22,14 @@ export interface UntestutilsPluginOptions {
 	/** Artifacts directory (sets `UNTESTUTILS_ARTIFACTS_DIR`). */
 	artifactsRoot?: string;
 	/**
+	* Isolate TargetRegistry / locks under `.untestutils/sessions/<session>/`
+	* so parallel Vitest + Playwright runs do not tear down each other's servers.
+	*/
+	session?: string;
+	/**
 	* Playwright engines for the `page` / `goto` fixtures.
-	* Default `['chromium']`. First entry sets `UNTESTUTILS_BROWSER` for workers;
-	* run multiple engines via separate Vitest projects / env overrides.
+	* Default `['chromium']`. Multiple engines inject one Vitest project per browser
+	* via `injectTestProjects` (each provides `untestutilsBrowser`).
 	*/
 	browsers?: HarnessBrowserName[];
 	/**
@@ -32,22 +38,48 @@ export interface UntestutilsPluginOptions {
 	*/
 	coverage?: boolean | CreateCoverageConfigOptions;
 }
+type VitestConfigBag = Record<string, unknown> & {
+	sequence?: {
+		setupFiles?: string;
+	};
+	globalSetup?: string | string[];
+	setupFiles?: string | string[];
+	coverage?: UntestutilsCoverageConfig | Record<string, unknown>;
+	environment?: string;
+	provide?: Record<string, unknown>;
+	name?: string;
+};
+interface VitestPluginContextLike {
+	vitest: {
+		config: {
+			project?: string | string[];
+		};
+		projects: Array<{
+			name: string;
+		}>;
+	};
+	project: {
+		name: string;
+		config: VitestConfigBag;
+		provide: (key: string, value: unknown) => void;
+	};
+	injectTestProjects: (config: unknown | unknown[]) => Promise<Array<{
+		name: string;
+	}>>;
+}
 interface VitestPlugin {
 	name: string;
-	configureVitest?: (ctx: {
-		project: {
-			config: Record<string, unknown> & {
-				sequence?: {
-					setupFiles?: string;
-				};
-				globalSetup?: string | string[];
-				setupFiles?: string | string[];
-				coverage?: UntestutilsCoverageConfig | Record<string, unknown>;
-			};
-		};
-	}) => void;
+	configureVitest?: (ctx: VitestPluginContextLike) => void | Promise<void>;
 }
 /**
 * Vitest/Vite plugin — import from `untestutils/vitest/plugin` in vitest.config.
 */
 export declare function untestutils(options?: UntestutilsPluginOptions): VitestPlugin;
+/**
+* Build separate Vitest project configs for e2e (recipe plugin) and Nuxt unit.
+* Mixing both in one project throws — use this helper instead.
+*/
+export declare function createVitestProjects(opts: {
+	e2e?: Record<string, unknown>;
+	unit?: Record<string, unknown>;
+}): Array<Record<string, unknown>>;

package/dist/plugin.d.ts

@@ -8,6 +8,7 @@ export type { CreateCoverageConfigOptions, CoverageThresholds, UntestutilsCovera
 export { createCoverageConfig, DEFAULT_COVERAGE_THRESHOLDS, UNTESTUTILS_WORKSPACE_PACKAGES, } from './coverage';
 export type { HarnessBrowserName } from './browsers';
 export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserName, } from './browsers';
+export type { UntestutilsProvidedSession } from './provided-context';
 export interface UntestutilsPluginOptions {
     /**
      * Recipe map from `defineRecipes(...)` — import and pass it.
@@ -23,10 +24,15 @@ export interface UntestutilsPluginOptions {
     prewarm?: string[];
     /** Artifacts directory (sets `UNTESTUTILS_ARTIFACTS_DIR`). */
     artifactsRoot?: string;
+    /**
+     * Isolate TargetRegistry / locks under `.untestutils/sessions/<session>/`
+     * so parallel Vitest + Playwright runs do not tear down each other's servers.
+     */
+    session?: string;
     /**
      * Playwright engines for the `page` / `goto` fixtures.
-     * Default `['chromium']`. First entry sets `UNTESTUTILS_BROWSER` for workers;
-     * run multiple engines via separate Vitest projects / env overrides.
+     * Default `['chromium']`. Multiple engines inject one Vitest project per browser
+     * via `injectTestProjects` (each provides `untestutilsBrowser`).
      */
     browsers?: HarnessBrowserName[];
     /**
@@ -35,20 +41,38 @@ export interface UntestutilsPluginOptions {
      */
     coverage?: boolean | CreateCoverageConfigOptions;
 }
+type VitestConfigBag = Record<string, unknown> & {
+    sequence?: {
+        setupFiles?: string;
+    };
+    globalSetup?: string | string[];
+    setupFiles?: string | string[];
+    coverage?: UntestutilsCoverageConfig | Record<string, unknown>;
+    environment?: string;
+    provide?: Record<string, unknown>;
+    name?: string;
+};
+interface VitestPluginContextLike {
+    vitest: {
+        config: {
+            project?: string | string[];
+        };
+        projects: Array<{
+            name: string;
+        }>;
+    };
+    project: {
+        name: string;
+        config: VitestConfigBag;
+        provide: (key: string, value: unknown) => void;
+    };
+    injectTestProjects: (config: unknown | unknown[]) => Promise<Array<{
+        name: string;
+    }>>;
+}
 interface VitestPlugin {
     name: string;
-    configureVitest?: (ctx: {
-        project: {
-            config: Record<string, unknown> & {
-                sequence?: {
-                    setupFiles?: string;
-                };
-                globalSetup?: string | string[];
-                setupFiles?: string | string[];
-                coverage?: UntestutilsCoverageConfig | Record<string, unknown>;
-            };
-        };
-    }) => void;
+    configureVitest?: (ctx: VitestPluginContextLike) => void | Promise<void>;
 }
 /** @internal injectable fs/require for companion resolution tests */
 export declare const companionIo: {
@@ -62,4 +86,12 @@ export declare function resolveCompanion(name: 'global-setup' | 'setup-file'): s
  * Vitest/Vite plugin — import from `untestutils/vitest/plugin` in vitest.config.
  */
 export declare function untestutils(options?: UntestutilsPluginOptions): VitestPlugin;
+/**
+ * Build separate Vitest project configs for e2e (recipe plugin) and Nuxt unit.
+ * Mixing both in one project throws — use this helper instead.
+ */
+export declare function createVitestProjects(opts: {
+    e2e?: Record<string, unknown>;
+    unit?: Record<string, unknown>;
+}): Array<Record<string, unknown>>;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,YAAY,CAAC;AAE/E,YAAY,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,2BAA2B,CAAC;CAClD;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,OAAO,EAAE;YACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;gBAChC,QAAQ,CAAC,EAAE;oBAAE,UAAU,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACnC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;gBAChC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;gBAC/B,QAAQ,CAAC,EAAE,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aAChE,CAAC;SACH,CAAC;KACH,KAAK,IAAI,CAAC;CACZ;AAWD,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE;IACxB,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,aAAa,EAAE,OAAO,aAAa,CAAC;CAKrC,CAAC;AAEF,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,GAAG,MAAM,CAsB5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,wBAA6B,GAAG,YAAY,CA0DhF"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,YAAY,CAAC;AAK/E,YAAY,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,2BAA2B,CAAC;CAClD;AAED,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC/C,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,UAAU,uBAAuB;IAC/B,MAAM,EAAE;QACN,MAAM,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;SAAE,CAAC;QACxC,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnC,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KAChD,CAAC;IACF,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACvF;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAWD,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE;IACxB,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,aAAa,EAAE,OAAO,aAAa,CAAC;CAKrC,CAAC;AAEF,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,GAAG,MAAM,CAsB5E;AAuED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,wBAA6B,GAAG,YAAY,CAgDhF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6CjC"}

package/dist/plugin.mjs

@@ -2,9 +2,11 @@ import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "pathe";
-import { ensureRecipes, debug, getRecipesModulePath } from "@untestutils/core";
+import { ensureRecipes, debug, getRecipesModulePath, resolveSessionArtifactsRoot, sanitizeSession } from "@untestutils/core";
 import { createCoverageConfig } from "./coverage.mjs";
 import { normalizeHarnessBrowsers } from "./browsers.mjs";
+import { providedContextAugmentation } from "./provided-context.mjs";
+void providedContextAugmentation;
 export { createCoverageConfig, DEFAULT_COVERAGE_THRESHOLDS, UNTESTUTILS_WORKSPACE_PACKAGES } from "./coverage.mjs";
 export { HARNESS_BROWSER_NAMES, normalizeHarnessBrowsers, resolveHarnessBrowserName } from "./browsers.mjs";
 
@@ -37,51 +39,128 @@ export function resolveCompanion(name) {
 	if (companionIo.existsSync(localTs)) return localTs;
 	throw new Error(`[untestutils] missing companion ${name}`);
 }
+function wireProjectConfig(config, options, browsers, resolvedRoot, recipesModule) {
+	const env = config.environment;
+	if (env === "untestutils" || env === "nuxt") {
+		throw new Error("[untestutils] Do not mix `untestutils/vitest/plugin` (e2e) with `environment: 'untestutils'` (unit). Use separate Vitest projects.");
+	}
+	config.sequence ??= {};
+	config.sequence.setupFiles = "list";
+	config.globalSetup = [...asArray(config.globalSetup), companion("global-setup")];
+	config.setupFiles = [...asArray(config.setupFiles), companion("setup-file")];
+	if (options.coverage) {
+		const next = options.coverage === true ? createCoverageConfig() : createCoverageConfig(options.coverage);
+		config.coverage = {
+			...typeof config.coverage === "object" && config.coverage ? config.coverage : {},
+			...next,
+			exclude: [...config.coverage?.exclude ?? [], ...next.exclude],
+			include: next.include,
+			thresholds: {
+				...config.coverage?.thresholds ?? {},
+				...next.thresholds
+			}
+		};
+	}
+	process.env.UNTESTUTILS_PREWARM = JSON.stringify(options.prewarm ?? []);
+	process.env.UNTESTUTILS_BROWSERS = JSON.stringify(browsers);
+	if (!process.env.UNTESTUTILS_BROWSER) {
+		process.env.UNTESTUTILS_BROWSER = browsers[0];
+	}
+	process.env.UNTESTUTILS_ARTIFACTS_DIR = resolvedRoot;
+	if (options.session) process.env.UNTESTUTILS_SESSION = sanitizeSession(options.session);
+	if (recipesModule) {
+		process.env.UNTESTUTILS_RECIPES_MODULE = recipesModule;
+	} else if ((options.prewarm ?? []).length) {
+		debug("vitest", "prewarm set but recipes module path unknown — pass recipes from defineRecipes(..., import.meta.url)");
+	}
+}
+function sessionPayload(browsers, resolvedRoot, recipesModule, session) {
+	return {
+		recipesModule,
+		artifactsRoot: resolvedRoot,
+		session: session ? sanitizeSession(session) : undefined,
+		browsers,
+		urls: {}
+	};
+}
 
 export function untestutils(options = {}) {
 	if (options.recipes) {
 		ensureRecipes(options.recipes);
 	}
-	const artifactsRoot = options.artifactsRoot;
-	const prewarm = options.prewarm ?? [];
-	const recipesModule = options.recipesModule ?? getRecipesModulePath();
 	const browsers = normalizeHarnessBrowsers(options.browsers);
+	const recipesModule = options.recipesModule ?? getRecipesModulePath();
+	const resolvedRoot = resolveSessionArtifactsRoot({
+		artifactsRoot: options.artifactsRoot,
+		session: options.session
+	});
 	return {
 		name: "untestutils",
-		configureVitest({ project }) {
+		async configureVitest(ctx) {
+			const { project, vitest, injectTestProjects } = ctx;
 			const config = project.config;
-			config.sequence ??= {};
-			config.sequence.setupFiles = "list";
-			config.globalSetup = [...asArray(config.globalSetup), companion("global-setup")];
-			config.setupFiles = [...asArray(config.setupFiles), companion("setup-file")];
-			if (options.coverage) {
-				const next = options.coverage === true ? createCoverageConfig() : createCoverageConfig(options.coverage);
-				config.coverage = {
-					...typeof config.coverage === "object" && config.coverage ? config.coverage : {},
-					...next,
-					exclude: [...config.coverage?.exclude ?? [], ...next.exclude],
-					include: next.include,
-					thresholds: {
-						...config.coverage?.thresholds ?? {},
-						...next.thresholds
+			wireProjectConfig(config, options, browsers, resolvedRoot, recipesModule);
+			const payload = sessionPayload(browsers, resolvedRoot, recipesModule, options.session);
+			project.provide("untestutils", payload);
+			project.provide("untestutilsBrowser", browsers[0]);
+			if (browsers.length > 1 && typeof injectTestProjects === "function") {
+				const extras = browsers.slice(1);
+				for (const browser of extras) {
+					const name = `untestutils-${browser}`;
+					const filter = vitest.config.project;
+					if (Array.isArray(filter) && !filter.includes(name)) {
+						filter.push(name);
 					}
-				};
-			}
-			process.env.UNTESTUTILS_PREWARM = JSON.stringify(prewarm);
-			process.env.UNTESTUTILS_BROWSERS = JSON.stringify(browsers);
-			if (!process.env.UNTESTUTILS_BROWSER) {
-				process.env.UNTESTUTILS_BROWSER = browsers[0];
-			}
-			if (artifactsRoot) process.env.UNTESTUTILS_ARTIFACTS_DIR = artifactsRoot;
-			if (recipesModule) {
-				process.env.UNTESTUTILS_RECIPES_MODULE = recipesModule;
-			} else if (prewarm.length) {
-				debug("vitest", "prewarm set but recipes module path unknown — pass recipes from defineRecipes(..., import.meta.url)");
+				}
+				await injectTestProjects(extras.map((browser) => ({ test: {
+					name: `untestutils-${browser}`,
+					provide: {
+						untestutils: payload,
+						untestutilsBrowser: browser
+					}
+				} })));
 			}
-			debug("vitest", "configured globalSetup + setupFiles");
+			debug("vitest", "configured globalSetup + setupFiles + provide session");
 		}
 	};
 }
+
+export function createVitestProjects(opts) {
+	const projects = [];
+	if (opts.e2e) {
+		const test = opts.e2e.test ?? {};
+		if (test.environment === "untestutils" || test.environment === "nuxt") {
+			throw new Error("[untestutils] createVitestProjects({ e2e }) must not set environment: 'untestutils'. Put unit under { unit }.");
+		}
+		projects.push({
+			...opts.e2e,
+			test: {
+				name: "e2e",
+				...test
+			}
+		});
+	}
+	if (opts.unit) {
+		const test = opts.unit.test ?? {};
+		const plugins = opts.unit.plugins ?? [];
+		const hasE2e = plugins.some((p) => typeof p === "object" && p !== null && "name" in p && p.name === "untestutils");
+		if (hasE2e) {
+			throw new Error("[untestutils] createVitestProjects({ unit }) must not include the e2e `untestutils()` plugin.");
+		}
+		projects.push({
+			...opts.unit,
+			test: {
+				name: "unit",
+				environment: "untestutils",
+				...test
+			}
+		});
+	}
+	if (!projects.length) {
+		throw new Error("[untestutils] createVitestProjects requires at least one of { e2e, unit }");
+	}
+	return projects;
+}
 function asArray(v) {
 	if (!v) return [];
 	return Array.isArray(v) ? v : [v];

package/dist/provided-context.d.mts

@@ -0,0 +1,20 @@
+/**
+* Serializable harness session passed via Vitest `provide` / `inject`.
+* Env vars remain a fallback for Playwright Test and CLI.
+*/
+export interface UntestutilsProvidedSession {
+	recipesModule?: string;
+	artifactsRoot: string;
+	session?: string;
+	browsers: Array<"chromium" | "firefox" | "webkit">;
+	/** Recipe id → live URL after globalSetup prewarm / registry apply. */
+	urls: Record<string, string>;
+}
+declare module "vitest" {
+	interface ProvidedContext {
+		untestutils: UntestutilsProvidedSession;
+		untestutilsBrowser: "chromium" | "firefox" | "webkit";
+	}
+}
+/** Side-effect anchor so the `vitest` module augmentation is retained at runtime. */
+export declare const providedContextAugmentation: boolean;

package/dist/provided-context.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Serializable harness session passed via Vitest `provide` / `inject`.
+ * Env vars remain a fallback for Playwright Test and CLI.
+ */
+export interface UntestutilsProvidedSession {
+    recipesModule?: string;
+    artifactsRoot: string;
+    session?: string;
+    browsers: Array<'chromium' | 'firefox' | 'webkit'>;
+    /** Recipe id → live URL after globalSetup prewarm / registry apply. */
+    urls: Record<string, string>;
+}
+declare module 'vitest' {
+    interface ProvidedContext {
+        untestutils: UntestutilsProvidedSession;
+        untestutilsBrowser: 'chromium' | 'firefox' | 'webkit';
+    }
+}
+/** Side-effect anchor so the `vitest` module augmentation is retained at runtime. */
+export declare const providedContextAugmentation = true;
+//# sourceMappingURL=provided-context.d.ts.map

package/dist/provided-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provided-context.d.ts","sourceRoot":"","sources":["../src/provided-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IACnD,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,OAAO,QAAQ,QAAQ,CAAC;IACtB,UAAU,eAAe;QACvB,WAAW,EAAE,0BAA0B,CAAC;QACxC,kBAAkB,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;KACvD;CACF;AAED,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,OAAO,CAAC"}

package/dist/provided-context.mjs

@@ -0,0 +1,2 @@
+
+export const providedContextAugmentation = true;

package/dist/setup-file.d.mts

@@ -1 +1,2 @@
-export {};
+/** Apply provided recipe URLs into process.env when keys are missing. */
+export declare function applySessionUrls(urls: Record<string, string>): void;

package/dist/setup-file.d.ts

@@ -1,3 +1,6 @@
+import { type UntestutilsProvidedSession } from './provided-context';
+/** Apply provided recipe URLs into process.env when keys are missing. */
+export declare function applySessionUrls(urls: Record<string, string>): void;
 /** @internal */
-export declare function applyWorkerSetup(): Promise<void>;
+export declare function applyWorkerSetup(sessionOverride?: UntestutilsProvidedSession): Promise<void>;
 //# sourceMappingURL=setup-file.d.ts.map

package/dist/setup-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-file.d.ts","sourceRoot":"","sources":["../src/setup-file.ts"],"names":[],"mappings":"AAOA,gBAAgB;AAChB,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUtD"}
+{"version":3,"file":"setup-file.d.ts","sourceRoot":"","sources":["../src/setup-file.ts"],"names":[],"mappings":"AAOA,OAAO,EAA+B,KAAK,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAalG,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKnE;AAED,gBAAgB;AAChB,wBAAsB,gBAAgB,CACpC,eAAe,CAAC,EAAE,0BAA0B,GAC3C,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/setup-file.mjs

@@ -1,15 +1,40 @@
 
 import { pathToFileURL } from "node:url";
-import { resolveArtifactsRoot, TargetRegistry } from "@untestutils/core";
+import { envKey, resolveArtifactsRoot, TargetRegistry } from "@untestutils/core";
+import { providedContextAugmentation } from "./provided-context.mjs";
+void providedContextAugmentation;
+async function tryInjectSession() {
+	try {
+		const { inject } = await import("vitest");
+		return inject("untestutils");
+	} catch {
+		return undefined;
+	}
+}
+
+export function applySessionUrls(urls) {
+	for (const [id, url] of Object.entries(urls)) {
+		const key = envKey(id);
+		if (!process.env[key]) process.env[key] = url;
+	}
+}
 
-export async function applyWorkerSetup() {
-	const recipesModule = process.env.UNTESTUTILS_RECIPES_MODULE;
+export async function applyWorkerSetup(sessionOverride) {
+	const session = sessionOverride ?? await tryInjectSession();
+	const recipesModule = session?.recipesModule ?? process.env.UNTESTUTILS_RECIPES_MODULE;
 	if (recipesModule) {
 		await import(pathToFileURL(recipesModule).href);
+		if (!process.env.UNTESTUTILS_RECIPES_MODULE) {
+			process.env.UNTESTUTILS_RECIPES_MODULE = recipesModule;
+		}
+	}
+	const artifactsRoot = session?.artifactsRoot ?? resolveArtifactsRoot();
+	if (session?.artifactsRoot && !process.env.UNTESTUTILS_ARTIFACTS_DIR) {
+		process.env.UNTESTUTILS_ARTIFACTS_DIR = session.artifactsRoot;
 	}
-	const artifactsRoot = resolveArtifactsRoot();
 	const registry = new TargetRegistry(artifactsRoot);
 	const map = await registry.read();
 	registry.applyAllToEnv(map);
+	if (session?.urls) applySessionUrls(session.urls);
 }
 await applyWorkerSetup();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@untestutils/vitest",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "homepage": "https://s00d.github.io/untestutils/",
   "license": "MIT",
   "repository": {
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "pathe": "^2.0.3",
-    "@untestutils/core": "0.5.1"
+    "@untestutils/core": "0.5.3"
   },
   "devDependencies": {
     "@types/node": "^26.6.1",