@untestutils/core 0.5.1 → 0.5.3

package/dist/drivers/cli-framework.d.mts

@@ -1,4 +1,4 @@
-import { type Recipe, type PrepareCtx, type StartCtx, type SharePolicy } from "../index.mjs";
+import type { Recipe, PrepareCtx, StartCtx, SharePolicy } from "../types.mjs";
 export interface ResolveBinOptions {
 	roots: string[];
 	packageJsonIds?: string[];
@@ -8,6 +8,9 @@ export interface ResolveBinOptions {
 }
 /**
 * Resolve a CLI entry from the app under test (or cwd).
+*
+* Prefer filesystem paths under `node_modules/` first — packages with tight
+* `exports` (e.g. vinxi) reject `require.resolve('pkg/bin/…')` / `pkg/package.json`.
 */
 export declare function resolveBin(opts: ResolveBinOptions): string;
 export type SpawnSpec = {
@@ -25,6 +28,8 @@ export interface CliFrameworkRecipeOptions {
 	hashInputs?: string[];
 	readyPath?: string;
 	readyTimeoutMs?: number;
+	/** See {@link FrameworkBaseOptions.workspaceDeps}. */
+	workspaceDeps?: boolean | "auto";
 	prepare?: (ctx: PrepareCtx & {
 		root: string;
 	}) => Promise<SpawnSpec | void> | SpawnSpec | void;
@@ -34,6 +39,8 @@ export interface CliFrameworkRecipeOptions {
 	verifyAfterPrepare?: (ctx: PrepareCtx & {
 		root: string;
 	}) => Promise<void>;
+	/** Called after the managed process stops (e.g. restore ephemeral next.config). */
+	afterStop?: () => Promise<void> | void;
 }
 export type FrameworkBaseOptions = {
 	id?: string;
@@ -42,6 +49,13 @@ export type FrameworkBaseOptions = {
 	hashInputs?: string[];
 	readyPath?: string;
 	readyTimeoutMs?: number;
+	/**
+	* Include monorepo package src dirs in prepare hash.
+	* - true — always
+	* - auto — when a pnpm workspace is detected above root
+	* - omit / false — off (default for CLI adapters)
+	*/
+	workspaceDeps?: boolean | "auto";
 };
 export declare function frameworkRoots(root: string): string[];
 /**

package/dist/drivers/cli-framework.d.ts

@@ -1,4 +1,5 @@
-import { runCommand, type Recipe, type PrepareCtx, type StartCtx, type SharePolicy } from '..';
+import { runCommand } from '../process';
+import type { Recipe, PrepareCtx, StartCtx, SharePolicy } from '../types';
 export interface ResolveBinOptions {
     roots: string[];
     packageJsonIds?: string[];
@@ -8,6 +9,9 @@ export interface ResolveBinOptions {
 }
 /**
  * Resolve a CLI entry from the app under test (or cwd).
+ *
+ * Prefer filesystem paths under `node_modules/` first — packages with tight
+ * `exports` (e.g. vinxi) reject `require.resolve('pkg/bin/…')` / `pkg/package.json`.
  */
 export declare function resolveBin(opts: ResolveBinOptions): string;
 export type SpawnSpec = {
@@ -25,6 +29,8 @@ export interface CliFrameworkRecipeOptions {
     hashInputs?: string[];
     readyPath?: string;
     readyTimeoutMs?: number;
+    /** See {@link FrameworkBaseOptions.workspaceDeps}. */
+    workspaceDeps?: boolean | 'auto';
     prepare?: (ctx: PrepareCtx & {
         root: string;
     }) => Promise<SpawnSpec | void> | SpawnSpec | void;
@@ -34,6 +40,8 @@ export interface CliFrameworkRecipeOptions {
     verifyAfterPrepare?: (ctx: PrepareCtx & {
         root: string;
     }) => Promise<void>;
+    /** Called after the managed process stops (e.g. restore ephemeral next.config). */
+    afterStop?: () => Promise<void> | void;
 }
 export type FrameworkBaseOptions = {
     id?: string;
@@ -42,6 +50,13 @@ export type FrameworkBaseOptions = {
     hashInputs?: string[];
     readyPath?: string;
     readyTimeoutMs?: number;
+    /**
+     * Include monorepo package src dirs in prepare hash.
+     * - true — always
+     * - auto — when a pnpm workspace is detected above root
+     * - omit / false — off (default for CLI adapters)
+     */
+    workspaceDeps?: boolean | 'auto';
 };
 export declare function frameworkRoots(root: string): string[];
 /**

package/dist/drivers/cli-framework.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-framework.d.ts","sourceRoot":"","sources":["../../src/drivers/cli-framework.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,UAAU,EACV,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,IAAI,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAmC1D;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/F,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5E,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAuE1E;AAED,gBAAgB;AAChB,eAAO,MAAM,aAAa,EAAE;IAC1B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,aAAa,EAAE,OAAO,aAAa,CAAC;CACO,CAAC"}
+{"version":3,"file":"cli-framework.d.ts","sourceRoot":"","sources":["../../src/drivers/cli-framework.ts"],"names":[],"mappings":"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"}

package/dist/drivers/cli-framework.mjs

@@ -1,7 +1,11 @@
 import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import { dirname, join, resolve } from "pathe";
-import { defineRecipe, loopbackUrl, waitForHttpReady, spawnManaged, runCommand } from "../index.mjs";
+import { defineRecipe } from "../recipes.mjs";
+import { loopbackUrl } from "../paths.mjs";
+import { waitForHttpReady } from "../ready.mjs";
+import { spawnManaged, runCommand } from "../process.mjs";
+import { appendWorkspaceHashInputs } from "./matrix.mjs";
 
 export function resolveBin(opts) {
 	const seen = new Set();
@@ -11,6 +15,18 @@ export function resolveBin(opts) {
 		seen.add(key);
 		const pkgPath = join(key, "package.json");
 		if (!existsSync(pkgPath)) continue;
+		for (const id of opts.directIds ?? []) {
+			const fsPath = join(key, "node_modules", id);
+			if (existsSync(fsPath)) return fsPath;
+		}
+		for (const pkgId of opts.packageJsonIds ?? []) {
+			const pkgName = pkgId.replace(/\/package\.json$/, "");
+			const pkgRoot = join(key, "node_modules", pkgName);
+			for (const rel of opts.binRelative ?? []) {
+				const bin = join(pkgRoot, rel);
+				if (existsSync(bin)) return bin;
+			}
+		}
 		let req;
 		try {
 			req = createRequire(pkgPath);
@@ -60,10 +76,11 @@ export function cliFrameworkRecipe(opts) {
 		id: opts.id,
 		share: opts.share ?? (opts.prepare ? "always" : "never"),
 		hashInputs: async () => {
-			const inputs = [...opts.hashInputs ?? [root]];
+			let inputs = [...opts.hashInputs ?? [root]];
 			if (opts.env && Object.keys(opts.env).length) {
 				inputs.push(`env:${JSON.stringify(opts.env)}`);
 			}
+			inputs = await appendWorkspaceHashInputs(inputs, root, opts.workspaceDeps);
 			return inputs;
 		},
 		ready: async () => {},
@@ -122,7 +139,10 @@ export function cliFrameworkRecipe(opts) {
 				kind: "url+dir",
 				url,
 				dir: ctx.outDir,
-				stop: managed.stop,
+				stop: async () => {
+					await managed.stop();
+					if (opts.afterStop) await opts.afterStop();
+				},
 				pid: managed.pid
 			};
 		}

package/dist/drivers/command.d.mts

@@ -1,4 +1,4 @@
-import { type Recipe } from "../index.mjs";
+import type { Recipe } from "../types.mjs";
 export interface CommandOptions {
 	id: string;
 	cwd?: string;

package/dist/drivers/command.d.ts

@@ -1,4 +1,4 @@
-import { type Recipe } from '..';
+import type { Recipe } from '../types';
 export interface CommandOptions {
     id: string;
     cwd?: string;

package/dist/drivers/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/drivers/command.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,IAAI,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA6DpD;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/drivers/command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA6DpD;AAED,eAAe,OAAO,CAAC"}

package/dist/drivers/command.mjs

@@ -1,5 +1,8 @@
 import { resolve } from "pathe";
-import { defineRecipe, loopbackUrl, waitForHttpReady, spawnManaged } from "../index.mjs";
+import { defineRecipe } from "../recipes.mjs";
+import { loopbackUrl } from "../paths.mjs";
+import { waitForHttpReady } from "../ready.mjs";
+import { spawnManaged } from "../process.mjs";
 export function command(opts) {
 	const cwd = opts.cwd ? resolve(opts.cwd) : undefined;
 	const recipe = defineRecipe({

package/dist/drivers/config-override.d.mts

@@ -0,0 +1,61 @@
+/**
+* Write `contents` to `path` (backing up any existing file). Returns `restore`
+* that puts the previous contents back (or deletes the path if it was new).
+* Use when the file must stay for a long-running process; prefer
+* {@link withEphemeralFile} when the whole critical section is one async fn.
+*/
+export declare function installEphemeralFile(path: string, contents: string | Buffer): Promise<() => Promise<void>>;
+/**
+* Write `contents` to `path`, run `fn`, then restore the previous file (or delete
+* if it did not exist). Safe for tools that only load config from a fixed name
+* (e.g. Next.js `next.config.*`).
+*/
+export declare function withEphemeralFile<T>(path: string, contents: string | Buffer, fn: () => Promise<T>): Promise<T>;
+/**
+* Replace `configPath` with an ESM module that merges the previous file + `overrides`,
+* then restore. The previous file is copied to a sibling with a real extension so
+* bundlers (vinxi/esbuild, Next) can import it.
+*/
+export declare function withMergedConfigOverride<T>(configPath: string, overrides: Record<string, unknown>, fn: () => Promise<T>): Promise<T>;
+/** Like {@link withMergedConfigOverride} but restore is deferred (long-running processes). */
+export declare function installMergedConfigOverride(configPath: string, overrides: Record<string, unknown>): Promise<() => Promise<void>>;
+/** Write a file (creating parents). Does not restore — for outDir ephemeral configs. */
+export declare function writeEphemeralConfig(path: string, contents: string): Promise<void>;
+/**
+* Serialize a JSON-compatible object as `export default <json>`.
+* Suitable for plain config overrides (no functions).
+*/
+export declare function serializeDefaultExport(value: unknown): string;
+/**
+* Build an ESM module that default-exports merge of `baseImportSpecifier` and overrides.
+* `baseImportSpecifier` must be a valid import path string (absolute file URL or relative).
+*/
+export declare function serializeMergedDefaultExport(opts: {
+	baseImportSpecifier: string;
+	overrides: Record<string, unknown>;
+	/** Variable name for the base module default export. */
+	baseName?: string;
+}): string;
+/** Common config filenames to probe under a project root. */
+export declare function findFirstExistingConfig(root: string, basenames: string[]): string | undefined;
+export declare function readTextIfExists(path: string): Promise<string | undefined>;
+/** Append a stable hash fragment for config overrides. */
+export declare function configOverrideHashInput(key: string, value: unknown): string;
+/**
+* ESM module for `vite --config`: load the app's vite config from `appRoot`,
+* then mergeConfig with JSON-serializable overrides.
+*/
+export declare function serializeViteMergeConfigModule(opts: {
+	appRoot: string;
+	overrides: Record<string, unknown>;
+}): string;
+/**
+* ESM module for Astro `--config`: merge user config import with overrides.
+* `baseImportSpecifier` should be an absolute file URL to the user's astro config.
+*/
+export declare function serializeAstroMergeConfigModule(opts: {
+	baseImportSpecifier: string;
+	overrides: Record<string, unknown>;
+}): string;
+/** Shallow-aware deep merge for plain JSON-like config objects (no class instances). */
+export declare function deepMergePlain<T extends Record<string, unknown>>(base: T, patch: Partial<T> | Record<string, unknown>): T;

package/dist/drivers/config-override.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Write `contents` to `path` (backing up any existing file). Returns `restore`
+ * that puts the previous contents back (or deletes the path if it was new).
+ * Use when the file must stay for a long-running process; prefer
+ * {@link withEphemeralFile} when the whole critical section is one async fn.
+ */
+export declare function installEphemeralFile(path: string, contents: string | Buffer): Promise<() => Promise<void>>;
+/**
+ * Write `contents` to `path`, run `fn`, then restore the previous file (or delete
+ * if it did not exist). Safe for tools that only load config from a fixed name
+ * (e.g. Next.js `next.config.*`).
+ */
+export declare function withEphemeralFile<T>(path: string, contents: string | Buffer, fn: () => Promise<T>): Promise<T>;
+/**
+ * Replace `configPath` with an ESM module that merges the previous file + `overrides`,
+ * then restore. The previous file is copied to a sibling with a real extension so
+ * bundlers (vinxi/esbuild, Next) can import it.
+ */
+export declare function withMergedConfigOverride<T>(configPath: string, overrides: Record<string, unknown>, fn: () => Promise<T>): Promise<T>;
+/** Like {@link withMergedConfigOverride} but restore is deferred (long-running processes). */
+export declare function installMergedConfigOverride(configPath: string, overrides: Record<string, unknown>): Promise<() => Promise<void>>;
+/** Write a file (creating parents). Does not restore — for outDir ephemeral configs. */
+export declare function writeEphemeralConfig(path: string, contents: string): Promise<void>;
+/**
+ * Serialize a JSON-compatible object as `export default <json>`.
+ * Suitable for plain config overrides (no functions).
+ */
+export declare function serializeDefaultExport(value: unknown): string;
+/**
+ * Build an ESM module that default-exports merge of `baseImportSpecifier` and overrides.
+ * `baseImportSpecifier` must be a valid import path string (absolute file URL or relative).
+ */
+export declare function serializeMergedDefaultExport(opts: {
+    baseImportSpecifier: string;
+    overrides: Record<string, unknown>;
+    /** Variable name for the base module default export. */
+    baseName?: string;
+}): string;
+/** Common config filenames to probe under a project root. */
+export declare function findFirstExistingConfig(root: string, basenames: string[]): string | undefined;
+export declare function readTextIfExists(path: string): Promise<string | undefined>;
+/** Append a stable hash fragment for config overrides. */
+export declare function configOverrideHashInput(key: string, value: unknown): string;
+/**
+ * ESM module for `vite --config`: load the app's vite config from `appRoot`,
+ * then mergeConfig with JSON-serializable overrides.
+ */
+export declare function serializeViteMergeConfigModule(opts: {
+    appRoot: string;
+    overrides: Record<string, unknown>;
+}): string;
+/**
+ * ESM module for Astro `--config`: merge user config import with overrides.
+ * `baseImportSpecifier` should be an absolute file URL to the user's astro config.
+ */
+export declare function serializeAstroMergeConfigModule(opts: {
+    baseImportSpecifier: string;
+    overrides: Record<string, unknown>;
+}): string;
+/** Shallow-aware deep merge for plain JSON-like config objects (no class instances). */
+export declare function deepMergePlain<T extends Record<string, unknown>>(base: T, patch: Partial<T> | Record<string, unknown>): T;
+//# sourceMappingURL=config-override.d.ts.map

package/dist/drivers/config-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-override.d.ts","sourceRoot":"","sources":["../../src/drivers/config-override.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,GACxB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAkC9B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,8FAA8F;AAC9F,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA0B9B;AAED,wFAAwF;AACxF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAUT;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAM7F;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGhF;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAE3E;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,MAAM,CAWT;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,MAAM,CAST;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,CAAC,CAmBH"}

package/dist/drivers/config-override.mjs

@@ -0,0 +1,149 @@
+import { existsSync } from "node:fs";
+import { copyFile, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+import { dirname, join } from "pathe";
+
+export async function installEphemeralFile(path, contents) {
+	const dir = dirname(path);
+	await mkdir(dir, { recursive: true });
+	const backup = `${path}.untestutils-bak`;
+	const hadFile = existsSync(path);
+	if (hadFile) {
+		await copyFile(path, backup);
+	}
+	await writeFile(path, contents);
+	return async () => {
+		try {
+			await unlink(path);
+		} catch {}
+		if (hadFile) {
+			try {
+				await rename(backup, path);
+			} catch {
+				try {
+					await copyFile(backup, path);
+					await unlink(backup);
+				} catch {}
+			}
+		} else {
+			try {
+				await unlink(backup);
+			} catch {}
+		}
+	};
+}
+
+export async function withEphemeralFile(path, contents, fn) {
+	const restore = await installEphemeralFile(path, contents);
+	try {
+		return await fn();
+	} finally {
+		await restore();
+	}
+}
+
+export async function withMergedConfigOverride(configPath, overrides, fn) {
+	const restore = await installMergedConfigOverride(configPath, overrides);
+	try {
+		return await fn();
+	} finally {
+		await restore();
+	}
+}
+
+export async function installMergedConfigOverride(configPath, overrides) {
+	const dir = dirname(configPath);
+	await mkdir(dir, { recursive: true });
+	const base = configPath.match(/^(.*?)(\.[cm]?[jt]s)$/);
+	const basePath = base ? `${base[1]}.untestutils-base${base[2]}` : `${configPath}.untestutils-base.mjs`;
+	const hadFile = existsSync(configPath);
+	if (hadFile) {
+		await copyFile(configPath, basePath);
+	}
+	const contents = hadFile ? serializeMergedDefaultExport({
+		baseImportSpecifier: pathToFileURL(basePath).href,
+		overrides
+	}) : serializeDefaultExport(overrides);
+	const restoreFile = await installEphemeralFile(configPath, contents);
+	return async () => {
+		await restoreFile();
+		try {
+			await unlink(basePath);
+		} catch {}
+	};
+}
+
+export async function writeEphemeralConfig(path, contents) {
+	await mkdir(dirname(path), { recursive: true });
+	await writeFile(path, contents, "utf8");
+}
+
+export function serializeDefaultExport(value) {
+	return `export default ${JSON.stringify(value, null, 2)};\n`;
+}
+
+export function serializeMergedDefaultExport(opts) {
+	const baseName = opts.baseName ?? "base";
+	const overridesJson = JSON.stringify(opts.overrides, null, 2);
+	return [
+		`import ${baseName}Mod from ${JSON.stringify(opts.baseImportSpecifier)};`,
+		`const ${baseName} = ${baseName}Mod?.default ?? ${baseName}Mod;`,
+		`const overrides = ${overridesJson};`,
+		`export default { ...(${baseName} && typeof ${baseName} === 'object' ? ${baseName} : {}), ...overrides };`,
+		""
+	].join("\n");
+}
+
+export function findFirstExistingConfig(root, basenames) {
+	for (const name of basenames) {
+		const p = join(root, name);
+		if (existsSync(p)) return p;
+	}
+	return undefined;
+}
+export async function readTextIfExists(path) {
+	if (!existsSync(path)) return undefined;
+	return readFile(path, "utf8");
+}
+
+export function configOverrideHashInput(key, value) {
+	return `${key}:${JSON.stringify(value)}`;
+}
+
+export function serializeViteMergeConfigModule(opts) {
+	return [
+		`import { mergeConfig, loadConfigFromFile, defineConfig } from "vite";`,
+		`const overrides = ${JSON.stringify(opts.overrides)};`,
+		`const appRoot = ${JSON.stringify(opts.appRoot)};`,
+		`export default defineConfig(async (env) => {`,
+		`  const loaded = await loadConfigFromFile(env, undefined, appRoot);`,
+		`  return mergeConfig(loaded?.config ?? {}, overrides);`,
+		`});`,
+		""
+	].join("\n");
+}
+
+export function serializeAstroMergeConfigModule(opts) {
+	return [
+		`import { mergeConfig } from "astro/config";`,
+		`import userMod from ${JSON.stringify(opts.baseImportSpecifier)};`,
+		`const user = userMod?.default ?? userMod;`,
+		`const overrides = ${JSON.stringify(opts.overrides)};`,
+		`export default mergeConfig(user && typeof user === "object" ? user : {}, overrides);`,
+		""
+	].join("\n");
+}
+
+export function deepMergePlain(base, patch) {
+	const out = { ...base };
+	for (const [k, v] of Object.entries(patch)) {
+		if (v === undefined) continue;
+		const prev = out[k];
+		if (v && typeof v === "object" && !Array.isArray(v) && prev && typeof prev === "object" && !Array.isArray(prev)) {
+			out[k] = deepMergePlain(prev, v);
+		} else {
+			out[k] = v;
+		}
+	}
+	return out;
+}

package/dist/drivers/define-driver.d.mts

@@ -1,4 +1,8 @@
-import type { Recipe } from "../index.mjs";
+import type { Recipe } from "../types.mjs";
 /** Framework/app adapter → Recipe. Core never imports frameworks. */
 export type Driver<Opts = unknown> = (opts: Opts) => Recipe;
+/**
+* Wrap a driver so every produced recipe has a non-empty `id` and a valid `share`.
+* Missing `share` defaults to `always` (same as most built-in drivers).
+*/
 export declare function defineDriver<Opts>(impl: Driver<Opts>): Driver<Opts>;

package/dist/drivers/define-driver.d.ts

@@ -1,5 +1,9 @@
-import type { Recipe } from '..';
+import type { Recipe } from '../types';
 /** Framework/app adapter → Recipe. Core never imports frameworks. */
 export type Driver<Opts = unknown> = (opts: Opts) => Recipe;
+/**
+ * Wrap a driver so every produced recipe has a non-empty `id` and a valid `share`.
+ * Missing `share` defaults to `always` (same as most built-in drivers).
+ */
 export declare function defineDriver<Opts>(impl: Driver<Opts>): Driver<Opts>;
 //# sourceMappingURL=define-driver.d.ts.map

package/dist/drivers/define-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/define-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAEjC,qEAAqE;AACrE,MAAM,MAAM,MAAM,CAAC,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;AAE5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAEnE"}
+{"version":3,"file":"define-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/define-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,UAAU,CAAC;AAEpD,qEAAqE;AACrE,MAAM,MAAM,MAAM,CAAC,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;AAI5D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAmBnE"}

package/dist/drivers/define-driver.mjs

@@ -1,3 +1,28 @@
+const SHARE_POLICIES = new Set([
+	"always",
+	"never",
+	"prepare-only"
+]);
+
 export function defineDriver(impl) {
-	return impl;
+	return (opts) => {
+		const recipe = impl(opts);
+		if (!recipe || typeof recipe !== "object") {
+			throw new Error("[untestutils] defineDriver: driver must return a Recipe");
+		}
+		const id = typeof recipe.id === "string" ? recipe.id.trim() : "";
+		if (!id) {
+			throw new Error("[untestutils] defineDriver: recipe.id is required");
+		}
+		const share = recipe.share ?? "always";
+		if (!SHARE_POLICIES.has(share)) {
+			throw new Error(`[untestutils] defineDriver: invalid share "${String(recipe.share)}" (use always|never|prepare-only)`);
+		}
+		if (recipe.id === id && recipe.share === share) return recipe;
+		return {
+			...recipe,
+			id,
+			share
+		};
+	};
 }

package/dist/drivers/host.d.mts

@@ -1,4 +1,4 @@
-import { type Recipe } from "../index.mjs";
+import type { Recipe } from "../types.mjs";
 import { type Driver } from "./define-driver.mjs";
 export interface HostOptions {
 	id: string;

package/dist/drivers/host.d.ts

@@ -1,4 +1,4 @@
-import { type Recipe } from '..';
+import type { Recipe } from '../types';
 import { type Driver } from './define-driver';
 export interface HostOptions {
     id: string;

package/dist/drivers/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/drivers/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,MAAM,EAAE,MAAM,IAAI,CAAC;AACnF,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,WAAW,CA0BnC,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/drivers/host.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,WAAW,CA0BnC,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/drivers/host.mjs

@@ -1,4 +1,6 @@
-import { defineRecipe, normalizeBaseUrl, waitForHttpReady } from "../index.mjs";
+import { defineRecipe } from "../recipes.mjs";
+import { normalizeBaseUrl } from "../paths.mjs";
+import { waitForHttpReady } from "../ready.mjs";
 import { defineDriver } from "./define-driver.mjs";
 
 export const host = defineDriver((opts) => {

package/dist/drivers/index.d.mts

@@ -10,3 +10,6 @@ export { host } from "./host.mjs";
 export type { HostOptions } from "./host.mjs";
 export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals } from "./cli-framework.mjs";
 export type { ResolveBinOptions, SpawnSpec, CliFrameworkRecipeOptions, FrameworkBaseOptions } from "./cli-framework.mjs";
+export { matrixRecipe, findWorkspaceRoot, workspacePackageSrcDirs, shouldIncludeWorkspaceDeps, appendWorkspaceHashInputs } from "./matrix.mjs";
+export type { MatrixCapableOptions, MatrixRecipeOptions } from "./matrix.mjs";
+export { installEphemeralFile, withEphemeralFile, withMergedConfigOverride, installMergedConfigOverride, writeEphemeralConfig, serializeDefaultExport, serializeMergedDefaultExport, serializeViteMergeConfigModule, serializeAstroMergeConfigModule, findFirstExistingConfig, readTextIfExists, configOverrideHashInput, deepMergePlain } from "./config-override.mjs";

package/dist/drivers/index.d.ts

@@ -10,4 +10,7 @@ export { host } from './host';
 export type { HostOptions } from './host';
 export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals, } from './cli-framework';
 export type { ResolveBinOptions, SpawnSpec, CliFrameworkRecipeOptions, FrameworkBaseOptions, } from './cli-framework';
+export { matrixRecipe, findWorkspaceRoot, workspacePackageSrcDirs, shouldIncludeWorkspaceDeps, appendWorkspaceHashInputs, } from './matrix';
+export type { MatrixCapableOptions, MatrixRecipeOptions } from './matrix';
+export { installEphemeralFile, withEphemeralFile, withMergedConfigOverride, installMergedConfigOverride, writeEphemeralConfig, serializeDefaultExport, serializeMergedDefaultExport, serializeViteMergeConfigModule, serializeAstroMergeConfigModule, findFirstExistingConfig, readTextIfExists, configOverrideHashInput, deepMergePlain, } from './config-override';
 //# sourceMappingURL=index.d.ts.map

package/dist/drivers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,EAC/B,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/drivers/index.mjs

@@ -4,3 +4,5 @@ export { staticDir } from "./static-dir.mjs";
 export { nodeEntry } from "./node-entry.mjs";
 export { host } from "./host.mjs";
 export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals } from "./cli-framework.mjs";
+export { matrixRecipe, findWorkspaceRoot, workspacePackageSrcDirs, shouldIncludeWorkspaceDeps, appendWorkspaceHashInputs } from "./matrix.mjs";
+export { installEphemeralFile, withEphemeralFile, withMergedConfigOverride, installMergedConfigOverride, writeEphemeralConfig, serializeDefaultExport, serializeMergedDefaultExport, serializeViteMergeConfigModule, serializeAstroMergeConfigModule, findFirstExistingConfig, readTextIfExists, configOverrideHashInput, deepMergePlain } from "./config-override.mjs";

package/dist/drivers/matrix.d.mts

@@ -0,0 +1,34 @@
+import type { Recipe } from "../types.mjs";
+/** Minimal options every framework matrix can merge. */
+export type MatrixCapableOptions = {
+	id?: string;
+	root: string;
+	env?: Record<string, string>;
+	hashInputs?: string[];
+};
+export type MatrixRecipeOptions<Opts extends MatrixCapableOptions> = {
+	label: string;
+	/**
+	* Custom merge of base + variant patch. Default: shallow spread, deep `env`,
+	* concat `hashInputs` + `variant:${name}`.
+	*/
+	merge?: (base: Opts, patch: Partial<Opts>, id: string, variantName: string) => Opts;
+};
+/**
+* Expand one recipe base into many recipes with distinct ids / identity.
+* Variant key `default` keeps `base.id`; other keys become `${baseId}__${key}`.
+*/
+export declare function matrixRecipe<Opts extends MatrixCapableOptions>(factory: (opts: Opts) => Recipe, base: Opts, variants: Record<string, Partial<Opts>>, options: MatrixRecipeOptions<Opts>): Record<string, Recipe>;
+/** Walk up from `from` looking for `pnpm-workspace.yaml` / `.yml`. */
+export declare function findWorkspaceRoot(from: string): string | undefined;
+/** Collect packages/NAME/src dirs under the workspace root (for prepare hash). */
+export declare function workspacePackageSrcDirs(from: string): Promise<string[]>;
+/**
+* Whether to include workspace package src dirs in hash inputs.
+* - true: always
+* - auto: when a pnpm workspace root is found
+* - false / undefined: never (CLI adapters default off; Nuxt keeps its own default)
+*/
+export declare function shouldIncludeWorkspaceDeps(workspaceDeps: boolean | "auto" | undefined, root: string): boolean;
+/** Append workspace src dirs to hash inputs when enabled. */
+export declare function appendWorkspaceHashInputs(inputs: string[], root: string, workspaceDeps: boolean | "auto" | undefined): Promise<string[]>;

package/dist/drivers/matrix.d.ts

@@ -0,0 +1,35 @@
+import type { Recipe } from '../types';
+/** Minimal options every framework matrix can merge. */
+export type MatrixCapableOptions = {
+    id?: string;
+    root: string;
+    env?: Record<string, string>;
+    hashInputs?: string[];
+};
+export type MatrixRecipeOptions<Opts extends MatrixCapableOptions> = {
+    label: string;
+    /**
+     * Custom merge of base + variant patch. Default: shallow spread, deep `env`,
+     * concat `hashInputs` + `variant:${name}`.
+     */
+    merge?: (base: Opts, patch: Partial<Opts>, id: string, variantName: string) => Opts;
+};
+/**
+ * Expand one recipe base into many recipes with distinct ids / identity.
+ * Variant key `default` keeps `base.id`; other keys become `${baseId}__${key}`.
+ */
+export declare function matrixRecipe<Opts extends MatrixCapableOptions>(factory: (opts: Opts) => Recipe, base: Opts, variants: Record<string, Partial<Opts>>, options: MatrixRecipeOptions<Opts>): Record<string, Recipe>;
+/** Walk up from `from` looking for `pnpm-workspace.yaml` / `.yml`. */
+export declare function findWorkspaceRoot(from: string): string | undefined;
+/** Collect packages/NAME/src dirs under the workspace root (for prepare hash). */
+export declare function workspacePackageSrcDirs(from: string): Promise<string[]>;
+/**
+ * Whether to include workspace package src dirs in hash inputs.
+ * - true: always
+ * - auto: when a pnpm workspace root is found
+ * - false / undefined: never (CLI adapters default off; Nuxt keeps its own default)
+ */
+export declare function shouldIncludeWorkspaceDeps(workspaceDeps: boolean | 'auto' | undefined, root: string): boolean;
+/** Append workspace src dirs to hash inputs when enabled. */
+export declare function appendWorkspaceHashInputs(inputs: string[], root: string, workspaceDeps: boolean | 'auto' | undefined): Promise<string[]>;
+//# sourceMappingURL=matrix.d.ts.map

package/dist/drivers/matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/drivers/matrix.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,IAAI,SAAS,oBAAoB,IAAI;IACnE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,oBAAoB,EAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,EAC/B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EACvC,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCxB;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAclE;AAED,kFAAkF;AAClF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa7E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAIT;AAED,6DAA6D;AAC7D,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAC1C,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB"}

package/dist/drivers/matrix.mjs

@@ -0,0 +1,76 @@
+import { existsSync } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { dirname, join, resolve } from "pathe";
+
+export function matrixRecipe(factory, base, variants, options) {
+	if (!base.root) {
+		throw new Error(`[untestutils/${options.label}] matrix() requires base.root`);
+	}
+	const baseId = base.id ?? `${options.label}-default`;
+	const out = {};
+	const merge = options.merge ?? ((b, patch, id, variantName) => ({
+		...b,
+		...patch,
+		id,
+		env: {
+			...b.env ?? {},
+			...patch.env ?? {}
+		},
+		hashInputs: [
+			...b.hashInputs ?? [b.root],
+			...patch.hashInputs ?? [],
+			`variant:${variantName}`
+		]
+	}));
+	for (const [name, patch] of Object.entries(variants)) {
+		const id = name === "default" ? baseId : `${baseId}__${name}`;
+		if (out[id]) {
+			throw new Error(`[untestutils/${options.label}] matrix() duplicate id "${id}"`);
+		}
+		const recipe = factory(merge(base, patch, id, name));
+		if (Object.values(out).some((r) => r.id === recipe.id)) {
+			throw new Error(`[untestutils/${options.label}] matrix() duplicate id "${recipe.id}"`);
+		}
+		out[id] = recipe;
+	}
+	return out;
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export function shouldIncludeWorkspaceDeps(workspaceDeps, root) {
+	if (workspaceDeps === true) return true;
+	if (workspaceDeps === "auto") return Boolean(findWorkspaceRoot(root));
+	return false;
+}
+
+export async function appendWorkspaceHashInputs(inputs, root, workspaceDeps) {
+	if (!shouldIncludeWorkspaceDeps(workspaceDeps, root)) return inputs;
+	return [...inputs, ...await workspacePackageSrcDirs(root)];
+}

package/dist/drivers/node-entry.d.mts

@@ -1,4 +1,4 @@
-import { type Recipe } from "../index.mjs";
+import type { Recipe } from "../types.mjs";
 export interface NodeEntryOptions {
 	id: string;
 	entry: string;

package/dist/drivers/node-entry.d.ts

@@ -1,4 +1,4 @@
-import { type Recipe } from '..';
+import type { Recipe } from '../types';
 export interface NodeEntryOptions {
     id: string;
     entry: string;

package/dist/drivers/node-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-entry.d.ts","sourceRoot":"","sources":["../../src/drivers/node-entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,IAAI,CAAC;AAEZ,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAoDxD;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"node-entry.d.ts","sourceRoot":"","sources":["../../src/drivers/node-entry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAoDxD;AAED,eAAe,SAAS,CAAC"}

package/dist/drivers/node-entry.mjs

@@ -1,6 +1,9 @@
 import { existsSync } from "node:fs";
 import { resolve } from "pathe";
-import { defineRecipe, loopbackUrl, waitForHttpReady, spawnManaged } from "../index.mjs";
+import { defineRecipe } from "../recipes.mjs";
+import { loopbackUrl } from "../paths.mjs";
+import { waitForHttpReady } from "../ready.mjs";
+import { spawnManaged } from "../process.mjs";
 export function nodeEntry(opts) {
 	const entry = resolve(opts.entry);
 	const cwd = opts.cwd ? resolve(opts.cwd) : undefined;

package/dist/drivers/static-dir.d.mts

@@ -1,4 +1,4 @@
-import { type Recipe } from "../index.mjs";
+import type { Recipe } from "../types.mjs";
 export interface StaticDirOptions {
 	id: string;
 	root: string;

package/dist/drivers/static-dir.d.ts

@@ -1,4 +1,4 @@
-import { type Recipe } from '..';
+import type { Recipe } from '../types';
 export interface StaticDirOptions {
     id: string;
     root: string;

package/dist/drivers/static-dir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-dir.d.ts","sourceRoot":"","sources":["../../src/drivers/static-dir.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+C,KAAK,MAAM,EAAE,MAAM,IAAI,CAAC;AAgB9E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA8ExD;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"static-dir.d.ts","sourceRoot":"","sources":["../../src/drivers/static-dir.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAgBvC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA8ExD;AAED,eAAe,SAAS,CAAC"}

package/dist/drivers/static-dir.mjs

@@ -2,7 +2,9 @@ import { createServer } from "node:http";
 import { existsSync } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
 import { extname, join, normalize, resolve, sep } from "pathe";
-import { defineRecipe, loopbackUrl, waitForHttpReady } from "../index.mjs";
+import { defineRecipe } from "../recipes.mjs";
+import { loopbackUrl } from "../paths.mjs";
+import { waitForHttpReady } from "../ready.mjs";
 const MIME = {
 	".html": "text/html; charset=utf-8",
 	".js": "text/javascript; charset=utf-8",

package/dist/harness.d.mts

@@ -1,4 +1,18 @@
 import type { HarnessHandle, Recipe, UseHarnessOptions } from "./types.mjs";
-export declare function useHarness(recipe: string | Recipe, _opts?: UseHarnessOptions): Promise<HarnessHandle>;
+import { type OrchestratorOptions, type PreparedTarget } from "./orchestrator.mjs";
+export type LeaseOptions = OrchestratorOptions & UseHarnessOptions;
+export interface LeasedTarget extends HarnessHandle {
+	/** Drop this process's handle bookkeeping. Does not stop shared recipe servers. */
+	release: () => Promise<void>;
+}
+export declare function prepareOnce(recipe: string | Recipe, opts?: LeaseOptions): Promise<PreparedTarget>;
+/**
+* Prepare/start a recipe and return a handle with explicit `release`.
+* Prefer this over `useHarness` when you need RAII-style cleanup bookkeeping.
+*/
+export declare function leaseTarget(recipe: string | Recipe, opts?: LeaseOptions): Promise<LeasedTarget>;
+/** Lease a target, run `fn`, always `release` afterward. */
+export declare function withHarness<T>(recipe: string | Recipe, fn: (handle: HarnessHandle) => Promise<T>, opts?: LeaseOptions): Promise<T>;
+export declare function useHarness(recipe: string | Recipe, opts?: UseHarnessOptions): Promise<HarnessHandle>;
 export declare function getCurrentHarness(): HarnessHandle | undefined;
 export declare function getHarness(id: string): HarnessHandle | undefined;

package/dist/harness.d.ts

@@ -1,5 +1,19 @@
 import type { HarnessHandle, Recipe, UseHarnessOptions } from './types';
-export declare function useHarness(recipe: string | Recipe, _opts?: UseHarnessOptions): Promise<HarnessHandle>;
+import { type OrchestratorOptions, type PreparedTarget } from './orchestrator';
+export type LeaseOptions = OrchestratorOptions & UseHarnessOptions;
+export interface LeasedTarget extends HarnessHandle {
+    /** Drop this process's handle bookkeeping. Does not stop shared recipe servers. */
+    release: () => Promise<void>;
+}
+export declare function prepareOnce(recipe: string | Recipe, opts?: LeaseOptions): Promise<PreparedTarget>;
+/**
+ * Prepare/start a recipe and return a handle with explicit `release`.
+ * Prefer this over `useHarness` when you need RAII-style cleanup bookkeeping.
+ */
+export declare function leaseTarget(recipe: string | Recipe, opts?: LeaseOptions): Promise<LeasedTarget>;
+/** Lease a target, run `fn`, always `release` afterward. */
+export declare function withHarness<T>(recipe: string | Recipe, fn: (handle: HarnessHandle) => Promise<T>, opts?: LeaseOptions): Promise<T>;
+export declare function useHarness(recipe: string | Recipe, opts?: UseHarnessOptions): Promise<HarnessHandle>;
 export declare function getCurrentHarness(): HarnessHandle | undefined;
 export declare function getHarness(id: string): HarnessHandle | undefined;
 //# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAOxE,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,SAAS,CAE7D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE"}
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEnE,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,mFAAmF;IACnF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAMD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,cAAc,CAAC,CAKzB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED,4DAA4D;AAC5D,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,SAAS,CAE7D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE"}

package/dist/harness.mjs

@@ -3,12 +3,40 @@ import { createHarnessHandle, ensurePrepared } from "./orchestrator.mjs";
 import { resolveArtifactsRoot } from "./paths.mjs";
 const storage = new AsyncLocalStorage();
 const handles = new Map();
-export async function useHarness(recipe, _opts = {}) {
-	const prepared = await ensurePrepared(recipe, { artifactsRoot: resolveArtifactsRoot() });
+function artifactsFrom(opts) {
+	return opts.artifactsRoot ?? resolveArtifactsRoot(opts.cwd);
+}
+export async function prepareOnce(recipe, opts = {}) {
+	return ensurePrepared(recipe, {
+		artifactsRoot: artifactsFrom(opts),
+		cwd: opts.cwd
+	});
+}
+
+export async function leaseTarget(recipe, opts = {}) {
+	const prepared = await prepareOnce(recipe, opts);
 	const handle = createHarnessHandle(prepared);
 	handles.set(handle.id, handle);
 	storage.enterWith(handle);
-	return handle;
+	return {
+		...handle,
+		release: async () => {
+			handles.delete(handle.id);
+		}
+	};
+}
+
+export async function withHarness(recipe, fn, opts = {}) {
+	const leased = await leaseTarget(recipe, opts);
+	try {
+		return await fn(leased);
+	} finally {
+		await leased.release();
+	}
+}
+export async function useHarness(recipe, opts = {}) {
+	const leased = await leaseTarget(recipe, opts);
+	return leased;
 }
 export function getCurrentHarness() {
 	return storage.getStore();

package/dist/index.d.mts

@@ -1,7 +1,9 @@
 export type { Recipe, RecipeFactory, RecipeRegistry, Running, HarnessHandle, SharePolicy, PrepareCtx, StartCtx, HashCtx, UseHarnessOptions } from "./types.mjs";
 export { SCHEMA_VERSION } from "./types.mjs";
 export { defineRecipe, defineRecipes, ensureRecipes, getRegisteredRecipe, getRecipesModulePath, listRegisteredRecipes, clearRegisteredRecipes } from "./recipes.mjs";
-export { useHarness, getCurrentHarness, getHarness } from "./harness.mjs";
+export { useHarness, getCurrentHarness, getHarness, leaseTarget, prepareOnce, withHarness } from "./harness.mjs";
+export type { LeaseOptions, LeasedTarget } from "./harness.mjs";
+export { sanitizeSession, resolveSessionArtifactsRoot } from "./session.mjs";
 export { ensurePrepared, stopAllTargets, reclaimStaleTargets, resolveRecipe, detachLiveTargetsForTests } from "./orchestrator.mjs";
 export { TargetRegistry, envKey, envDirKey } from "./target-registry.mjs";
 export { ArtifactStore } from "./artifact-store.mjs";
@@ -27,3 +29,6 @@ export { host } from "./drivers/host.mjs";
 export type { HostOptions } from "./drivers/host.mjs";
 export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals } from "./drivers/cli-framework.mjs";
 export type { ResolveBinOptions, SpawnSpec, CliFrameworkRecipeOptions, FrameworkBaseOptions } from "./drivers/cli-framework.mjs";
+export { matrixRecipe, findWorkspaceRoot, workspacePackageSrcDirs, shouldIncludeWorkspaceDeps, appendWorkspaceHashInputs } from "./drivers/matrix.mjs";
+export type { MatrixCapableOptions, MatrixRecipeOptions } from "./drivers/matrix.mjs";
+export { installEphemeralFile, withEphemeralFile, withMergedConfigOverride, installMergedConfigOverride, writeEphemeralConfig, serializeDefaultExport, serializeMergedDefaultExport, serializeViteMergeConfigModule, serializeAstroMergeConfigModule, findFirstExistingConfig, readTextIfExists, configOverrideHashInput, deepMergePlain } from "./drivers/config-override.mjs";

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export type { Recipe, RecipeFactory, RecipeRegistry, Running, HarnessHandle, SharePolicy, PrepareCtx, StartCtx, HashCtx, UseHarnessOptions, } from './types';
 export { SCHEMA_VERSION } from './types';
 export { defineRecipe, defineRecipes, ensureRecipes, getRegisteredRecipe, getRecipesModulePath, listRegisteredRecipes, clearRegisteredRecipes, } from './recipes';
-export { useHarness, getCurrentHarness, getHarness } from './harness';
+export { useHarness, getCurrentHarness, getHarness, leaseTarget, prepareOnce, withHarness, } from './harness';
+export type { LeaseOptions, LeasedTarget } from './harness';
+export { sanitizeSession, resolveSessionArtifactsRoot } from './session';
 export { ensurePrepared, stopAllTargets, reclaimStaleTargets, resolveRecipe, detachLiveTargetsForTests, } from './orchestrator';
 export { TargetRegistry, envKey, envDirKey } from './target-registry';
 export { ArtifactStore } from './artifact-store';
@@ -27,4 +29,7 @@ export { host } from './drivers/host';
 export type { HostOptions } from './drivers/host';
 export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals, } from './drivers/cli-framework';
 export type { ResolveBinOptions, SpawnSpec, CliFrameworkRecipeOptions, FrameworkBaseOptions, } from './drivers/cli-framework';
+export { matrixRecipe, findWorkspaceRoot, workspacePackageSrcDirs, shouldIncludeWorkspaceDeps, appendWorkspaceHashInputs, } from './drivers/matrix';
+export type { MatrixCapableOptions, MatrixRecipeOptions } from './drivers/matrix';
+export { installEphemeralFile, withEphemeralFile, withMergedConfigOverride, installMergedConfigOverride, writeEphemeralConfig, serializeDefaultExport, serializeMergedDefaultExport, serializeViteMergeConfigModule, serializeAstroMergeConfigModule, findFirstExistingConfig, readTextIfExists, configOverrideHashInput, deepMergePlain, } from './drivers/config-override';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,MAAM,EACN,aAAa,EACb,cAAc,EACd,OAAO,EACP,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,EACP,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EACL,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,iBAAiB,EACjB,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAG7F,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -1,6 +1,7 @@
 export { SCHEMA_VERSION } from "./types.mjs";
 export { defineRecipe, defineRecipes, ensureRecipes, getRegisteredRecipe, getRecipesModulePath, listRegisteredRecipes, clearRegisteredRecipes } from "./recipes.mjs";
-export { useHarness, getCurrentHarness, getHarness } from "./harness.mjs";
+export { useHarness, getCurrentHarness, getHarness, leaseTarget, prepareOnce, withHarness } from "./harness.mjs";
+export { sanitizeSession, resolveSessionArtifactsRoot } from "./session.mjs";
 export { ensurePrepared, stopAllTargets, reclaimStaleTargets, resolveRecipe, detachLiveTargetsForTests } from "./orchestrator.mjs";
 export { TargetRegistry, envKey, envDirKey } from "./target-registry.mjs";
 export { ArtifactStore } from "./artifact-store.mjs";
@@ -20,3 +21,5 @@ export { staticDir } from "./drivers/static-dir.mjs";
 export { nodeEntry } from "./drivers/node-entry.mjs";
 export { host } from "./drivers/host.mjs";
 export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals } from "./drivers/cli-framework.mjs";
+export { matrixRecipe, findWorkspaceRoot, workspacePackageSrcDirs, shouldIncludeWorkspaceDeps, appendWorkspaceHashInputs } from "./drivers/matrix.mjs";
+export { installEphemeralFile, withEphemeralFile, withMergedConfigOverride, installMergedConfigOverride, writeEphemeralConfig, serializeDefaultExport, serializeMergedDefaultExport, serializeViteMergeConfigModule, serializeAstroMergeConfigModule, findFirstExistingConfig, readTextIfExists, configOverrideHashInput, deepMergePlain } from "./drivers/config-override.mjs";

package/dist/ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAG3B,0DAA0D;AAC1D,eAAO,MAAM,OAAO,EAAE;IACpB,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,UAAU,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC;CAIrG,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAezE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAsB,EAC5B,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAiBf"}
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAG3B,0DAA0D;AAC1D,eAAO,MAAM,OAAO,EAAE;IACpB,YAAY,EAAE,CACZ,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,KACzC,UAAU,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC;CAK1C,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAezE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAsB,EAC5B,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/session.d.mts

@@ -0,0 +1,12 @@
+/** Sanitize session segment for filesystem / env use. */
+export declare function sanitizeSession(session: string): string;
+/**
+* Resolve artifacts root with optional session isolation.
+* Explicit `artifactsRoot` wins; otherwise `session` / `UNTESTUTILS_SESSION`
+* nests under `.untestutils/sessions/<session>/`.
+*/
+export declare function resolveSessionArtifactsRoot(opts?: {
+	artifactsRoot?: string;
+	session?: string;
+	cwd?: string;
+}): string;

package/dist/session.d.ts

@@ -0,0 +1,13 @@
+/** Sanitize session segment for filesystem / env use. */
+export declare function sanitizeSession(session: string): string;
+/**
+ * Resolve artifacts root with optional session isolation.
+ * Explicit `artifactsRoot` wins; otherwise `session` / `UNTESTUTILS_SESSION`
+ * nests under `.untestutils/sessions/<session>/`.
+ */
+export declare function resolveSessionArtifactsRoot(opts?: {
+    artifactsRoot?: string;
+    session?: string;
+    cwd?: string;
+}): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAGA,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,GAAE;IACJ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,MAAM,CAOR"}

package/dist/session.mjs

@@ -0,0 +1,19 @@
+import { join, resolve } from "pathe";
+import { resolveArtifactsRoot } from "./paths.mjs";
+
+export function sanitizeSession(session) {
+	const s = session.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+	if (!s) {
+		throw new Error("[untestutils] session must be a non-empty identifier");
+	}
+	return s;
+}
+
+export function resolveSessionArtifactsRoot(opts = {}) {
+	const cwd = opts.cwd ?? process.cwd();
+	if (opts.artifactsRoot) return resolve(cwd, opts.artifactsRoot);
+	const base = resolveArtifactsRoot(cwd);
+	const session = opts.session ?? process.env.UNTESTUTILS_SESSION;
+	if (session) return join(base, "sessions", sanitizeSession(session));
+	return base;
+}

package/dist/types.d.mts

@@ -86,7 +86,9 @@ export interface HarnessHandle {
 	};
 	dispose?: () => Promise<void>;
 }
+/** Options for `useHarness` / `leaseTarget` (orchestrator path). */
 export interface UseHarnessOptions {
-	browser?: boolean;
+	artifactsRoot?: string;
+	cwd?: string;
 }
 export declare const SCHEMA_VERSION: 1;

package/dist/types.d.ts

@@ -86,8 +86,10 @@ export interface HarnessHandle {
     };
     dispose?: () => Promise<void>;
 }
+/** Options for `useHarness` / `leaseTarget` (orchestrator path). */
 export interface UseHarnessOptions {
-    browser?: boolean;
+    artifactsRoot?: string;
+    cwd?: string;
 }
 export declare const SCHEMA_VERSION: 1;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CAAC;AAE9D,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1E,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5F,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAChG;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,CAAC,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,QAAQ,EAAE,MAAM,CAAC;IACvC,KAAK,EAAE;QACL,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC3C,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,cAAc,EAAG,CAAU,CAAC"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@untestutils/core",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Recipe harness core — locks, registry, orchestrator, drivers",
-  "license": "MIT",
   "homepage": "https://s00d.github.io/untestutils/",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/s00d/untestutils.git",