webanvil 0.0.12 → 0.0.15

package/README.md

@@ -25,6 +25,7 @@ Table of contents
     - [A web app](#a-web-app)
     - [Storybook](#storybook)
     - [A Node project](#a-node-project)
+    - [Browser tests](#browser-tests)
 - [Configuration](#configuration)
     - [Tool selection](#tool-selection)
     - [Native tool configuration](#native-tool-configuration)
@@ -48,6 +49,7 @@ wa clean      # remove tracked build output
 wa check      # check formatting, linting, and types
 wa check --fix # format files and apply safe lint fixes before type checking
 wa test       # run tests, watch them, collect coverage, or open the UI
+wa e2e        # build, preview, and run browser tests
 wa lint       # lint files
 wa format      # format files
 wa typecheck   # type-check the project
@@ -64,6 +66,7 @@ What it includes
 | Tracked output cleanup     | `wa clean`                         | WebAnvil                                          |
 | Static checks              | `wa check`                         | Oxfmt, Oxlint, TypeScript Native, or svelte-check |
 | Tests                      | `wa test`                          | Vitest                                            |
+| Browser tests              | `wa e2e`                           | Playwright Test and Chromium                      |
 | Linting                    | `wa lint`                          | Oxlint                                            |
 | Formatting                 | `wa format`                        | Oxfmt                                             |
 | Type checking              | `wa typecheck`                     | TypeScript Native or svelte-check                 |
@@ -80,10 +83,10 @@ npm install --save-dev webanvil
 ```
 
 Your package manager remains responsible for dependencies, the lockfile, and
-the installed tree. WebAnvil never installs or updates tools. When a supported
-tool is declared directly by the active project, or by a workspace that contains
-it, WebAnvil uses that installed version. Otherwise it uses the exact version
-shipped with WebAnvil.
+the installed tree. WebAnvil never installs or updates tools. Except for the
+bundled Vitest and Playwright test toolchains, WebAnvil uses a compatible tool
+declared directly by the active project or containing workspace before its
+exact fallback.
 
 Add the scripts you want to `package.json`:
 
@@ -95,6 +98,7 @@ Add the scripts you want to `package.json`:
         "clean": "wa clean",
         "check": "wa check",
         "test": "wa test",
+        "e2e": "wa e2e",
         "lint": "wa lint",
         "format": "wa format",
         "typecheck": "wa typecheck"
@@ -114,6 +118,7 @@ npm run build
 npm run clean
 npm run check
 npm run test
+npm run e2e
 npm run lint
 npm run format
 npm run typecheck
@@ -198,8 +203,8 @@ package build still owns `--out-dir`.
 Set `storybook.test: false` to exclude Storybook stories, including `play`
 functions, from `wa test`. Chromium is downloaded by
 `@playwright/browser-chromium` when your package manager runs install scripts.
-If the project declares Vitest, Storybook tests require version `4.1.10` to
-match the bundled browser provider.
+Storybook tests use WebAnvil's bundled Vitest and browser provider as one
+version-matched toolchain.
 
 ### A Node project
 
@@ -330,21 +335,23 @@ over the matching WebAnvil block.
 ### Tool selection
 
 WebAnvil selects compatible project and workspace declarations before its own
-fallbacks. A transitive or merely hoisted package is not selected. Each command
+fallbacks, except for its bundled Vitest and Playwright test toolchains. A
+transitive or merely hoisted package is not selected. Each command
 preflights the engines it can dispatch before `webanvil.config.*` is loaded or
 its plugins are evaluated, so a declared command engine that is missing, has
 invalid package identity, or is outside the supported range fails first.
 
-| Tool                       | Supported project/workspace versions | Exact WebAnvil fallback |
-| -------------------------- | ------------------------------------ | ----------------------- |
-| Vite                       | `>=8.1.5 <9`                         | `8.1.5`                 |
-| Vitest                     | `>=4.1.10 <5`                        | `4.1.10`                |
-| Storybook                  | `>=10.5.9 <11`                       | `10.5.9`                |
-| Rolldown                   | `>=1.2.0 <2`                         | `1.2.0`                 |
-| Oxlint                     | `>=1.75.0 <2`                        | `1.75.0`                |
-| Oxfmt                      | `>=0.60.0 <0.61`                     | `0.60.0`                |
-| TypeScript (declarations)  | `>=5 <7`                             | `6.0.3`                 |
-| TypeScript Native (`tsgo`) | `>=7.0.0-dev.20260707.2 <7.0.0`      | `7.0.0-dev.20260707.2`  |
+| Tool                         | Supported project/workspace versions | Exact WebAnvil fallback |
+| ---------------------------- | ------------------------------------ | ----------------------- |
+| Vite                         | `>=8.1.5 <9`                         | `8.1.5`                 |
+| Vitest                       | Bundled only                         | `4.1.11`                |
+| Playwright Test and Chromium | Bundled only                         | `1.58.2`                |
+| Storybook                    | `>=10.5.9 <11`                       | `10.5.9`                |
+| Rolldown                     | `>=1.2.0 <2`                         | `1.2.0`                 |
+| Oxlint                       | `>=1.75.0 <2`                        | `1.75.0`                |
+| Oxfmt                        | `>=0.60.0 <0.61`                     | `0.60.0`                |
+| TypeScript (declarations)    | `>=5 <7`                             | `6.0.3`                 |
+| TypeScript Native (`tsgo`)   | `>=7.0.0-dev.20260707.2 <7.0.0`      | `7.0.0-dev.20260707.2`  |
 
 When a tool is first used, the CLI reports its package, version, and source, for
 example `Using rolldown 1.2.0 (project)` or
@@ -354,6 +361,10 @@ The TypeScript compiler is selected only after configuration enables a
 declaration build, but before Rolldown starts that build. It follows the same
 direct project/workspace declaration and exact-fallback rules.
 
+`wa test` and `wa e2e` always use WebAnvil's bundled Vitest and Playwright
+toolchains. This keeps each runner on the same version as its `webanvil/test` or
+`webanvil/e2e` API.
+
 ### Native tool configuration
 
 The `vite`, `test`, `rolldown`, `lint`, and `format` blocks use the owning
@@ -369,6 +380,10 @@ Precedence is:
 3. the matching native block in `webanvil.config.*`;
 4. WebAnvil defaults.
 
+A `playwright.config.*` is different: it takes full control of `wa e2e`,
+including the server lifecycle and browser configuration. WebAnvil still runs
+its bundled Playwright Test binary.
+
 WebAnvil-owned `build`, `copy`, cross-engine `plugins`, and CLI behavior remain
 orchestration settings. `rolldown.input` and per-format `rolldown.output`
 options extend Node builds; WebAnvil still owns the input roots, output
@@ -494,6 +509,56 @@ These are run-specific modes; keep persistent Vitest configuration in
 `vitest.config.*`. `--ui-port` selects a strict loopback port and requires
 `--ui`.
 
+Import the bundled test API from WebAnvil so test registration and execution
+always use the same Vitest instance:
+
+```ts
+import { context, describe, expect, it } from "webanvil/test"
+
+describe("calculator", () => {
+    context("with two values", () => {
+        it("adds them", () => {
+            expect(1 + 1).toBe(2)
+        })
+    })
+})
+```
+
+Native Vitest configuration can import `defineConfig` from
+`webanvil/test/config`.
+
+### Browser tests
+
+`wa e2e` builds a web project, starts a production preview, and runs Playwright
+Test files in `e2e/`. Import the test API from WebAnvil so the runner and test
+code use the bundled matching version:
+
+```ts
+import { context, describe, expect, it } from "webanvil/e2e"
+
+describe("home page", () => {
+    context("when a visitor opens it", () => {
+        it("shows its heading", async ({ page }) => {
+            await page.goto("/")
+            await expect(page.getByRole("heading")).toBeVisible()
+        })
+    })
+})
+```
+
+The generated configuration provides a `chromium` project, so `wa e2e --project
+chromium` works without a Playwright config. Use `--headed`, `--debug`, or `--ui`
+for an interactive run. WebAnvil ships Playwright Test and Chromium, but the host
+still needs the browser system libraries. On Linux CI, install them with:
+
+```sh
+npx playwright install --with-deps chromium
+```
+
+For advanced configuration, add `playwright.config.*`. WebAnvil then delegates
+directly to Playwright and does not build or start a server. Configure
+Playwright's `webServer` option in that file when the tests need one.
+
 ### Cleaning build output
 
 `wa build` records the actual emitted and copied files in
@@ -543,6 +608,7 @@ Command reference
 | `wa dev [entry]`          | Starts Vite or a Node build watcher. A configured Storybook starts with the Node watcher.                 | `--mode`, `--out-dir`, `--host`, `--port`, `--copy`, `--bundle`, `--no-bundle`, `--formats`, `--declaration`, `--sourcemap`, `--minify`, `--platform`, `--target` |
 | `wa preview`              | Serves a Vite production build or configured static Storybook output.                                     | `--out-dir`, `--host`, `--port`, `--open`                                                                                                                         |
 | `wa test [filters...]`    | Runs Vitest once, in watch mode, with coverage, or UI.                                                    | `--environment`, `--watch`, `--coverage`, `--ui`, `--ui-port`                                                                                                     |
+| `wa e2e [filters...]`     | Builds, previews, and runs Playwright browser tests. Native Playwright configuration takes control.       | `--host`, `--port`, `--ui`, `--headed`, `--debug`, `--project`                                                                                                    |
 | `wa lint [paths...]`      | Runs Oxlint and treats warnings as failures.                                                              | `--fix`                                                                                                                                                           |
 | `wa format [paths...]`    | Formats with Oxfmt.                                                                                       | `--check`                                                                                                                                                         |
 | `wa typecheck [paths...]` | Type-checks with TypeScript Native.                                                                       | No options                                                                                                                                                        |

package/dist/_chunks/commands.mjs

@@ -17,6 +17,7 @@ import { playwright } from "@vitest/browser-playwright";
 import { storybookTest } from "@storybook/addon-vitest/vitest-plugin";
 import { consola } from "consola";
 import { randomUUID } from "node:crypto";
+import { tmpdir } from "node:os";
 const entry = defineArgument({
 	name: "entry",
 	description: "Web entry or Node public root; unbundled Node builds emit its reachable graph with preserveModules."
@@ -101,7 +102,14 @@ const supportedTools = {
 	},
 	vitest: {
 		packageName: "vitest",
-		range: ">=4.1.10 <5"
+		range: ">=4.1.11 <5",
+		allowProjectOverride: false
+	},
+	playwright: {
+		packageName: "@playwright/test",
+		range: ">=1.58.2 <2",
+		bin: "playwright",
+		allowProjectOverride: false
 	},
 	storybook: {
 		packageName: "storybook",
@@ -343,7 +351,7 @@ var Toolchain = class {
 	}
 	async #resolve(name) {
 		const definition = supportedTools[name];
-		const declaration = await findDeclaration(this.cwd, definition.packageName);
+		const declaration = definition.allowProjectOverride === false ? void 0 : await findDeclaration(this.cwd, definition.packageName);
 		if (declaration !== void 0) return loadResolvedTool(name, definition, declaration.directory, "project");
 		const webanvilPackageRoot = dirname$1(await findContainingManifest(fileURLToPath(import.meta.url)));
 		return loadResolvedTool(name, definition, webanvilPackageRoot, "webanvil");
@@ -1114,7 +1122,7 @@ const useToolExecutable = async (name, toolchain = new Toolchain(process.cwd()))
 	if (tool.executable === void 0) throw new Error(`${tool.packageName} does not expose an executable`);
 	return tool.executable;
 };
-const storybookVitestVersion = "4.1.10";
+const storybookVitestVersion = "4.1.11";
 const relativeModule = (from, to) => {
 	const path = relative(from, to).replaceAll("\\", "/");
 	return path.startsWith(".") ? path : `./${path}`;
@@ -1255,6 +1263,11 @@ const declaration = defineOption({
 	arity: 1,
 	schema: z.enum(["true", "false"]).transform((value) => value === "true")
 });
+const debug = defineOption({
+	name: "debug",
+	description: "Run browser tests in Playwright debug mode.",
+	arity: 0
+});
 const environment = defineOption({
 	name: "environment",
 	description: "Vitest environment to use for this run.",
@@ -1276,6 +1289,11 @@ const host = defineOption({
 	description: "Host interface for the web server.",
 	arity: 1
 });
+const headed = defineOption({
+	name: "headed",
+	description: "Run browser tests with a visible browser window.",
+	arity: 0
+});
 const minify = defineOption({
 	name: "minify",
 	description: "Minify the build output: true or false.",
@@ -1308,6 +1326,12 @@ const platform = defineOption({
 		"neutral"
 	])
 });
+const project = defineOption({
+	name: "project",
+	description: "Run one named Playwright project.",
+	arity: 1,
+	schema: z.string().min(1)
+});
 const port = defineOption({
 	name: "port",
 	description: "Port for the web server.",
@@ -1331,7 +1355,7 @@ const target = defineOption({
 });
 const ui = defineOption({
 	name: "ui",
-	description: "Start the Vitest user interface.",
+	description: "Start the test user interface.",
 	arity: 0
 });
 const uiPort = defineOption({
@@ -1362,7 +1386,7 @@ const build = async (mode, entry, outDir, options = {}, plugins = [], viteConfig
 		const rolldown = await useToolApi("rolldown", void 0, toolchain);
 		await runNodeBuild(await createNodeBuildPlan(entry, outDir, options, resolveRolldownPlugins(plugins), rolldownConfig, toolchain), rolldown.rolldown);
 		logger.success(`Built ${entry} to ${outDir}`);
-		return;
+		return outDir;
 	}
 	const web = await build.webConfig(entry, outDir, options, plugins, viteConfig, toolchain, explicit);
 	const target = web.outDir;
@@ -1379,6 +1403,7 @@ const build = async (mode, entry, outDir, options = {}, plugins = [], viteConfig
 		...copied
 	]);
 	logger.success(`Built ${entry} to ${outDir}`);
+	return target;
 };
 build.webConfig = async (entry, outDir, options, plugins, viteConfig = {}, toolchain = new Toolchain(process.cwd()), explicit = {}) => {
 	assertSyntaxTarget(options.target);
@@ -1831,7 +1856,7 @@ var dev_default = defineCommand({
 		return commandRun(toolchain)(arguments_, config);
 	}
 });
-const preview = async (outDir, host, port, useOutDir = false, waitForTermination = untilTerminated, openBrowser, viteConfig = {}) => {
+const startPreview = async (outDir, host, port, useOutDir = false, openBrowser, viteConfig = {}) => {
 	logger.start("Starting web preview");
 	const vite = await useToolApi("vite");
 	const hasViteConfig = await hasToolConfig("vite");
@@ -1848,7 +1873,10 @@ const preview = async (outDir, host, port, useOutDir = false, waitForTermination
 			...openBrowser === void 0 ? {} : { open: openBrowser }
 		}
 	});
-	const server = await vite.preview(config);
+	return vite.preview(config);
+};
+const preview = async (outDir, host, port, useOutDir = false, waitForTermination = untilTerminated, openBrowser, viteConfig = {}) => {
+	const server = await startPreview(outDir, host, port, useOutDir, openBrowser, viteConfig);
 	try {
 		server.printUrls();
 		await waitForTermination();
@@ -1872,6 +1900,94 @@ var preview_default = defineCommand({
 		return preview(outDir ?? (storybook === void 0 ? config.build?.outDir ?? "dist" : storybookOutputDir(storybook)), host, port, outDir !== void 0 || storybook !== void 0, untilTerminated, open, config.vite);
 	}
 });
+const localUrl = (server) => {
+	const url = server.resolvedUrls?.local?.[0] ?? server.resolvedUrls?.network?.[0];
+	if (url === void 0) throw new Error("WebAnvil could not determine the preview URL for browser tests");
+	return url;
+};
+const argumentsFor = (filters, options, config, passWithNoTests = false) => [
+	"test",
+	...config === void 0 ? [] : ["--config", config],
+	...filters,
+	...passWithNoTests ? ["--pass-with-no-tests"] : [],
+	...options.ui ? ["--ui"] : [],
+	...options.headed ? ["--headed"] : [],
+	...options.debug ? ["--debug"] : [],
+	...options.project === void 0 ? [] : ["--project", options.project]
+];
+const defaultE2EConfig = (testDir, baseURL, outputDir) => ({
+	outputDir,
+	projects: [{
+		name: "chromium",
+		use: { browserName: "chromium" }
+	}],
+	testDir,
+	use: { baseURL }
+});
+const defaultConfig = (testDir, baseURL, outputDir) => `${JSON.stringify(defaultE2EConfig(testDir, baseURL, outputDir), void 0, 4)}\n`;
+const runPlaywright = async (filters, options, config, baseURL, passWithNoTests = false) => {
+	await execa(await useToolExecutable("playwright"), argumentsFor(filters, options, config, passWithNoTests), {
+		cwd: process.cwd(),
+		env: {
+			...process.env,
+			...baseURL === void 0 ? {} : { WEBANVIL_E2E_URL: baseURL },
+			PLAYWRIGHT_TEST: "1"
+		},
+		stdio: "inherit"
+	});
+};
+const e2e = async (filters, options = {}) => {
+	logger.start("Running end-to-end tests");
+	if (await hasToolConfig("playwright")) {
+		await runPlaywright(filters, options);
+		logger.success("End-to-end tests passed");
+		return;
+	}
+	const { config } = await loadConfig();
+	const effective = resolveEffectiveBuildConfig(config, {}, false);
+	if (effective.mode !== "web") throw new Error("wa e2e requires build.mode: \"web\" or a native playwright.config.* file");
+	const toolchain = new Toolchain(process.cwd());
+	const server = await startPreview(await build(effective.mode, effective.entry, effective.outDir, effective, config.plugins ?? [], config.vite, config.rolldown, toolchain), options.host, options.port, true, false, config.vite);
+	let directory;
+	try {
+		const baseURL = localUrl(server);
+		directory = await mkdtemp(join$1(tmpdir(), "webanvil-playwright-"));
+		const configPath = join$1(directory, "playwright.config.mjs");
+		await writeFile(configPath, `export default ${defaultConfig(resolve$1(process.cwd(), "e2e"), baseURL, join$1(directory, "test-results"))}`);
+		await runPlaywright(filters, options, configPath, baseURL, true);
+	} finally {
+		await Promise.all([server.close(), ...directory === void 0 ? [] : [rm(directory, {
+			force: true,
+			recursive: true
+		})]]);
+	}
+	logger.success("End-to-end tests passed");
+};
+var e2e_default = defineCommand({
+	name: "e2e",
+	description: "Run end-to-end browser tests.",
+	arguments: [filters],
+	options: [
+		host,
+		port,
+		ui,
+		headed,
+		debug,
+		project
+	],
+	run: async ({ filters, host, port, ui, headed, debug, project }) => {
+		const nativePlaywrightConfig = await hasToolConfig("playwright");
+		await Promise.all([useTool("playwright"), ...nativePlaywrightConfig ? [] : [useTool("vite")]]);
+		return e2e(filters, {
+			debug,
+			headed,
+			host,
+			port,
+			project,
+			ui
+		});
+	}
+});
 const test = async (filters, config = {}, options = {}, waitForTermination = untilTerminated, storybook = {}) => {
 	if (options.uiPort !== void 0 && options.ui !== true) throw new Error("--ui-port requires --ui");
 	logger.start("Running tests");
@@ -1956,4 +2072,4 @@ var test_default = defineCommand({
 		return runTest(arguments_);
 	}
 });
-export { build, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, coverage, declaration, dev, dev_default, entry, environment, filters, fix$1 as fix, format, format_default, formats, host, lint, lint_default, logger, minify, mode, open, outDir, paths, platform, port, preview, preview_default, sourcemap, target, test, test_default, typecheck, typecheck_default, ui, uiPort, watch };
+export { build, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, coverage, debug, declaration, dev, dev_default, e2e, e2e_default, entry, environment, filters, fix$1 as fix, format, format_default, formats, headed, host, lint, lint_default, logger, minify, mode, open, outDir, paths, platform, port, preview, preview_default, project, sourcemap, target, test, test_default, typecheck, typecheck_default, ui, uiPort, watch };

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { build_default, check_default, clean_default, dev_default, format_default, lint_default, logger, preview_default, test_default, typecheck_default } from "./_chunks/commands.mjs";
+import { build_default, check_default, clean_default, dev_default, e2e_default, format_default, lint_default, logger, preview_default, test_default, typecheck_default } from "./_chunks/commands.mjs";
 import { execute } from "cmdore";
 import { fileURLToPath } from "node:url";
 import { readPackageJSON } from "pkg-types";
@@ -9,6 +9,7 @@ const main = async (...varargs) => {
 		check_default,
 		clean_default,
 		dev_default,
+		e2e_default,
 		format_default,
 		lint_default,
 		preview_default,

package/dist/e2e.d.mts

@@ -0,0 +1,73 @@
+import { defineConfig, devices, expect, test } from "@playwright/test";
+declare const describe: {
+  (title: string, callback: () => void): void;
+  (callback: () => void): void;
+  (title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  only(title: string, callback: () => void): void;
+  only(callback: () => void): void;
+  only(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  skip(title: string, callback: () => void): void;
+  skip(callback: () => void): void;
+  skip(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  fixme(title: string, callback: () => void): void;
+  fixme(callback: () => void): void;
+  fixme(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  serial: {
+    (title: string, callback: () => void): void;
+    (callback: () => void): void;
+    (title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+    only(title: string, callback: () => void): void;
+    only(callback: () => void): void;
+    only(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  };
+  parallel: {
+    (title: string, callback: () => void): void;
+    (callback: () => void): void;
+    (title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+    only(title: string, callback: () => void): void;
+    only(callback: () => void): void;
+    only(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  };
+  configure: (options: {
+    mode?: "default" | "parallel" | "serial";
+    retries?: number;
+    timeout?: number;
+  }) => void;
+};
+declare const context: {
+  (title: string, callback: () => void): void;
+  (callback: () => void): void;
+  (title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  only(title: string, callback: () => void): void;
+  only(callback: () => void): void;
+  only(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  skip(title: string, callback: () => void): void;
+  skip(callback: () => void): void;
+  skip(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  fixme(title: string, callback: () => void): void;
+  fixme(callback: () => void): void;
+  fixme(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  serial: {
+    (title: string, callback: () => void): void;
+    (callback: () => void): void;
+    (title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+    only(title: string, callback: () => void): void;
+    only(callback: () => void): void;
+    only(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  };
+  parallel: {
+    (title: string, callback: () => void): void;
+    (callback: () => void): void;
+    (title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+    only(title: string, callback: () => void): void;
+    only(callback: () => void): void;
+    only(title: string, details: import("playwright/test").TestDetails, callback: () => void): void;
+  };
+  configure: (options: {
+    mode?: "default" | "parallel" | "serial";
+    retries?: number;
+    timeout?: number;
+  }) => void;
+};
+declare const it: import("playwright/test").TestType<import("playwright/test").PlaywrightTestArgs & import("playwright/test").PlaywrightTestOptions, import("playwright/test").PlaywrightWorkerArgs & import("playwright/test").PlaywrightWorkerOptions>;
+export { context, defineConfig, describe, devices, expect, it, test };

package/dist/e2e.mjs

@@ -0,0 +1,5 @@
+import { defineConfig, devices, expect, test, test as test$1 } from "@playwright/test";
+const describe = test$1.describe;
+const context = test$1.describe;
+const it = test$1;
+export { context, defineConfig, describe, devices, expect, it, test };

package/dist/index.d.mts

@@ -1,11 +1,11 @@
 import { rename } from "node:fs/promises";
 import { z } from "zod";
 import { TsconfigJson } from "get-tsconfig";
+import { TestUserConfig } from "vitest/config";
 import { InlineConfig, PluginOption, UserConfig as UserConfig$1 } from "vite";
 import { OxfmtConfig } from "oxfmt";
 import { OxlintConfig } from "oxlint";
 import { InputOptions, OutputOptions, Plugin } from "rolldown";
-import { TestUserConfig } from "vitest/config";
 import { IsolatedDeclarationsOptions } from "rolldown/experimental";
 declare const entry$1: {
   readonly name: "entry";
@@ -35,7 +35,7 @@ declare const isUnpluginAdapter: (plugin: unknown) => plugin is UnpluginAdapter;
 declare const isWebAnvilPlugin: (plugin: unknown) => plugin is WebAnvilPlugin;
 declare const resolveRolldownPlugins: (plugins: WebAnvilPlugin[]) => Plugin[];
 declare const resolveVitePlugins: (plugins: WebAnvilPlugin[]) => PluginOption[];
-type ToolName = "vite" | "vitest" | "rolldown" | "oxlint" | "oxfmt" | "storybook" | "typescript" | "typescript-native";
+type ToolName = "vite" | "vitest" | "playwright" | "rolldown" | "oxlint" | "oxfmt" | "storybook" | "typescript" | "typescript-native";
 type OptionalToolName = "svelte-check";
 type AnyToolName = ToolName | OptionalToolName;
 type ToolSource = "project" | "webanvil";
@@ -293,7 +293,7 @@ type WebBuild = {
   vite: ViteApi;
 };
 declare const build: {
-  (mode: "web" | "node", entry: string, outDir: string, options?: BuildOptions, plugins?: WebAnvilPlugin[], viteConfig?: UserConfig$1, rolldownConfig?: RolldownConfig, toolchain?: Toolchain, explicit?: ExplicitWebBuild): Promise<void>;
+  (mode: "web" | "node", entry: string, outDir: string, options?: BuildOptions, plugins?: WebAnvilPlugin[], viteConfig?: UserConfig$1, rolldownConfig?: RolldownConfig, toolchain?: Toolchain, explicit?: ExplicitWebBuild): Promise<string>;
   webConfig(entry: string, outDir: string, options: BuildOptions, plugins: WebAnvilPlugin[], viteConfig?: UserConfig$1, toolchain?: Toolchain, explicit?: ExplicitWebBuild): Promise<WebBuild>;
   publicOutputFiles({ outDir, publicDir }: WebBuild): Promise<string[]>;
   web(web: WebBuild): Promise<string[]>;
@@ -379,7 +379,7 @@ type TypecheckOptions = {
   svelteCheck: ResolvedTool | undefined;
 };
 declare const typecheck: (paths: string[], options?: TypecheckOptions) => Promise<void>;
-declare const _default$8: import("cmdore").Command<readonly import("cmdore").Option[], readonly [{
+declare const _default$9: import("cmdore").Command<readonly import("cmdore").Option[], readonly [{
   readonly name: "paths";
   readonly description: "Files or directories to check.";
   readonly variadic: true;
@@ -484,8 +484,48 @@ declare const _default$3: import("cmdore").Command<readonly [{
   readonly name: "entry";
   readonly description: "Web entry or Node public root; unbundled Node builds emit its reachable graph with preserveModules.";
 }]>;
-declare const format: (paths: string[], check?: boolean, config?: FormatConfig) => Promise<void>;
+type E2EOptions = {
+  debug?: boolean;
+  headed?: boolean;
+  host?: string;
+  port?: number;
+  project?: string;
+  ui?: boolean;
+};
+declare const e2e: (filters: string[], options?: E2EOptions) => Promise<void>;
 declare const _default$4: import("cmdore").Command<readonly [{
+  readonly name: "host";
+  readonly description: "Host interface for the web server.";
+  readonly arity: 1;
+}, {
+  readonly name: "port";
+  readonly description: "Port for the web server.";
+  readonly arity: 1;
+  readonly schema: import("zod").ZodCoercedNumber<unknown>;
+}, {
+  readonly name: "ui";
+  readonly description: "Start the test user interface.";
+  readonly arity: 0;
+}, {
+  readonly name: "headed";
+  readonly description: "Run browser tests with a visible browser window.";
+  readonly arity: 0;
+}, {
+  readonly name: "debug";
+  readonly description: "Run browser tests in Playwright debug mode.";
+  readonly arity: 0;
+}, {
+  readonly name: "project";
+  readonly description: "Run one named Playwright project.";
+  readonly arity: 1;
+  readonly schema: import("zod").ZodString;
+}], readonly [{
+  readonly name: "filters";
+  readonly description: "Test files or names to run.";
+  readonly variadic: true;
+}]>;
+declare const format: (paths: string[], check?: boolean, config?: FormatConfig) => Promise<void>;
+declare const _default$5: import("cmdore").Command<readonly [{
   readonly name: "check";
   readonly description: "Check formatting without writing files.";
   readonly arity: 0;
@@ -495,7 +535,7 @@ declare const _default$4: import("cmdore").Command<readonly [{
   readonly variadic: true;
 }]>;
 declare const lint: (paths: string[], fix?: boolean, config?: LintConfig) => Promise<void>;
-declare const _default$5: import("cmdore").Command<readonly [{
+declare const _default$6: import("cmdore").Command<readonly [{
   readonly name: "fix";
   readonly description: "Apply safe lint fixes.";
   readonly arity: 0;
@@ -505,7 +545,7 @@ declare const _default$5: import("cmdore").Command<readonly [{
   readonly variadic: true;
 }]>;
 declare const preview: (outDir: string, host?: string, port?: number, useOutDir?: boolean, waitForTermination?: () => Promise<void>, openBrowser?: boolean, viteConfig?: UserConfig$1) => Promise<void>;
-declare const _default$6: import("cmdore").Command<readonly [{
+declare const _default$7: import("cmdore").Command<readonly [{
   readonly name: "out-dir";
   readonly description: "Directory where the build output is written.";
   readonly arity: 1;
@@ -530,7 +570,7 @@ declare const test: (filters: string[], config?: TestConfig, options?: {
   uiPort?: number;
   watch?: boolean;
 }, waitForTermination?: () => Promise<void>, storybook?: StorybookConfig) => Promise<void>;
-declare const _default$7: import("cmdore").Command<readonly [{
+declare const _default$8: import("cmdore").Command<readonly [{
   readonly name: "environment";
   readonly description: "Vitest environment to use for this run.";
   readonly arity: 1;
@@ -544,7 +584,7 @@ declare const _default$7: import("cmdore").Command<readonly [{
   readonly arity: 0;
 }, {
   readonly name: "ui";
-  readonly description: "Start the Vitest user interface.";
+  readonly description: "Start the test user interface.";
   readonly arity: 0;
 }, {
   readonly name: "ui-port";
@@ -588,6 +628,11 @@ declare const declaration: {
     false: "false";
   }>, z.ZodTransform<boolean, "true" | "false">>;
 };
+declare const debug: {
+  readonly name: "debug";
+  readonly description: "Run browser tests in Playwright debug mode.";
+  readonly arity: 0;
+};
 declare const environment: {
   readonly name: "environment";
   readonly description: "Vitest environment to use for this run.";
@@ -612,6 +657,11 @@ declare const host: {
   readonly description: "Host interface for the web server.";
   readonly arity: 1;
 };
+declare const headed: {
+  readonly name: "headed";
+  readonly description: "Run browser tests with a visible browser window.";
+  readonly arity: 0;
+};
 declare const minify$1: {
   readonly name: "minify";
   readonly description: "Minify the build output: true or false.";
@@ -650,6 +700,12 @@ declare const platform$1: {
     neutral: "neutral";
   }>;
 };
+declare const project: {
+  readonly name: "project";
+  readonly description: "Run one named Playwright project.";
+  readonly arity: 1;
+  readonly schema: z.ZodString;
+};
 declare const port: {
   readonly name: "port";
   readonly description: "Port for the web server.";
@@ -673,7 +729,7 @@ declare const target$1: {
 };
 declare const ui: {
   readonly name: "ui";
-  readonly description: "Start the Vitest user interface.";
+  readonly description: "Start the test user interface.";
   readonly arity: 0;
 };
 declare const uiPort: {
@@ -689,4 +745,4 @@ declare const watch: {
 };
 declare function defineConfig(config: UserConfig): UserConfig;
 declare function defineConfig(config: UserConfigFactory): UserConfigFactory;
-export { BuildConfig, ConfigExport, CopyMapping, FormatConfig, LintConfig, ResolvedConfig, RolldownConfig, StorybookConfig, SyntaxTarget, TestConfig, UnpluginAdapter, UserConfig, UserConfigFactory, ViteConfig, WebAnvilPlugin, WebAnvilUnplugin, assertSyntaxTarget, build, _default as buildCommand, buildConfigSchema, bundle$1 as bundle, check, _default$1 as checkCommand, checkProject, clean, _default$2 as cleanCommand, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig, definePlugin, dev, _default$3 as devCommand, effectiveUserConfigSchema, entry$1 as entry, environment, filters, fix, format, _default$4 as formatCommand, formatConfigSchema, formats$1 as formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, _default$5 as lintCommand, lintConfigSchema, loadConfig, minify$1 as minify, mode, open, outDir$1 as outDir, paths, platform$1 as platform, port, preview, _default$6 as previewCommand, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap$1 as sourcemap, storybookConfigSchema, syntaxTargetSchema, target$1 as target, test, _default$7 as testCommand, testConfigSchema, typecheck, _default$8 as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };
+export { BuildConfig, ConfigExport, CopyMapping, FormatConfig, LintConfig, ResolvedConfig, RolldownConfig, StorybookConfig, SyntaxTarget, TestConfig, UnpluginAdapter, UserConfig, UserConfigFactory, ViteConfig, WebAnvilPlugin, WebAnvilUnplugin, assertSyntaxTarget, build, _default as buildCommand, buildConfigSchema, bundle$1 as bundle, check, _default$1 as checkCommand, checkProject, clean, _default$2 as cleanCommand, copy, copyMappingSchema, coverage, debug, declaration, defaultConfig, defineConfig, definePlugin, dev, _default$3 as devCommand, e2e, _default$4 as e2eCommand, effectiveUserConfigSchema, entry$1 as entry, environment, filters, fix, format, _default$5 as formatCommand, formatConfigSchema, formats$1 as formats, headed, host, isUnpluginAdapter, isWebAnvilPlugin, lint, _default$6 as lintCommand, lintConfigSchema, loadConfig, minify$1 as minify, mode, open, outDir$1 as outDir, paths, platform$1 as platform, port, preview, _default$7 as previewCommand, project, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap$1 as sourcemap, storybookConfigSchema, syntaxTargetSchema, target$1 as target, test, _default$8 as testCommand, testConfigSchema, typecheck, _default$9 as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { build, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, coverage, declaration, dev, dev_default, entry, environment, filters, fix, format, format_default, formats, host, lint, lint_default, minify, mode, open, outDir, paths, platform, port, preview, preview_default, sourcemap, target, test, test_default, typecheck, typecheck_default, ui, uiPort, watch } from "./_chunks/commands.mjs";
+import { build, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, coverage, debug, declaration, dev, dev_default, e2e, e2e_default, entry, environment, filters, fix, format, format_default, formats, headed, host, lint, lint_default, minify, mode, open, outDir, paths, platform, port, preview, preview_default, project, sourcemap, target, test, test_default, typecheck, typecheck_default, ui, uiPort, watch } from "./_chunks/commands.mjs";
 import { assertSyntaxTarget, buildConfigSchema, copyMappingSchema, defaultConfig, defineConfig as defineConfig$1, definePlugin, effectiveUserConfigSchema, formatConfigSchema, isUnpluginAdapter, isWebAnvilPlugin, lintConfigSchema, loadConfig, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, storybookConfigSchema, syntaxTargetSchema, testConfigSchema, userConfigSchema, viteConfigSchema, withConfig } from "./_chunks/config.mjs";
 function defineConfig(config) {
 	return defineConfig$1(config);
 }
-export { assertSyntaxTarget, build, build_default as buildCommand, buildConfigSchema, bundle, check, check_default as checkCommand, checkProject, clean, clean_default as cleanCommand, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig, definePlugin, dev, dev_default as devCommand, effectiveUserConfigSchema, entry, environment, filters, fix, format, format_default as formatCommand, formatConfigSchema, formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, lint_default as lintCommand, lintConfigSchema, loadConfig, minify, mode, open, outDir, paths, platform, port, preview, preview_default as previewCommand, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap, storybookConfigSchema, syntaxTargetSchema, target, test, test_default as testCommand, testConfigSchema, typecheck, typecheck_default as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };
+export { assertSyntaxTarget, build, build_default as buildCommand, buildConfigSchema, bundle, check, check_default as checkCommand, checkProject, clean, clean_default as cleanCommand, copy, copyMappingSchema, coverage, debug, declaration, defaultConfig, defineConfig, definePlugin, dev, dev_default as devCommand, e2e, e2e_default as e2eCommand, effectiveUserConfigSchema, entry, environment, filters, fix, format, format_default as formatCommand, formatConfigSchema, formats, headed, host, isUnpluginAdapter, isWebAnvilPlugin, lint, lint_default as lintCommand, lintConfigSchema, loadConfig, minify, mode, open, outDir, paths, platform, port, preview, preview_default as previewCommand, project, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap, storybookConfigSchema, syntaxTargetSchema, target, test, test_default as testCommand, testConfigSchema, typecheck, typecheck_default as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };

package/dist/test/config.d.mts

@@ -0,0 +1 @@
+export * from "vitest/config";

package/dist/test/config.mjs

@@ -0,0 +1,2 @@
+export * from "vitest/config";
+export {};

package/dist/test.d.mts

@@ -0,0 +1,3 @@
+export * from "vitest";
+declare const context: import("vitest").SuiteAPI;
+export { context };

package/dist/test.mjs

@@ -0,0 +1,4 @@
+import { describe } from "vitest";
+export * from "vitest";
+const context = describe;
+export { context };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "webanvil",
-    "version": "0.0.12",
+    "version": "0.0.15",
     "description": "A unified CLI for building, testing, linting, formatting, and type-checking JavaScript and TypeScript projects.",
     "keywords": [
         "build-tool",
@@ -41,6 +41,21 @@
             "import": "./dist/index.mjs",
             "default": "./dist/index.mjs"
         },
+        "./e2e": {
+            "types": "./dist/e2e.d.mts",
+            "import": "./dist/e2e.mjs",
+            "default": "./dist/e2e.mjs"
+        },
+        "./test": {
+            "types": "./dist/test.d.mts",
+            "import": "./dist/test.mjs",
+            "default": "./dist/test.mjs"
+        },
+        "./test/config": {
+            "types": "./dist/test/config.d.mts",
+            "import": "./dist/test/config.mjs",
+            "default": "./dist/test/config.mjs"
+        },
         "./storybook/test/preset": {
             "types": "./dist/storybook/test/preset.d.mts",
             "import": "./dist/storybook/test/preset.mjs",
@@ -106,6 +121,7 @@
     },
     "dependencies": {
         "@playwright/browser-chromium": "1.58.2",
+        "@playwright/test": "1.58.2",
         "@storybook/addon-vitest": "10.5.9",
         "@storybook/react-vite": "10.5.9",
         "@storybook/svelte-vite": "10.5.9",
@@ -113,10 +129,10 @@
         "@storybook/web-components-vite": "10.5.9",
         "@types/node": "^26.1.1",
         "@typescript/native-preview": "7.0.0-dev.20260707.2",
-        "@vitest/browser": "4.1.10",
-        "@vitest/browser-playwright": "4.1.10",
-        "@vitest/coverage-v8": "4.1.10",
-        "@vitest/ui": "4.1.10",
+        "@vitest/browser": "4.1.11",
+        "@vitest/browser-playwright": "4.1.11",
+        "@vitest/coverage-v8": "4.1.11",
+        "@vitest/ui": "4.1.11",
         "c12": "^4.0.0-beta.5",
         "cmdore": "^0.4.1",
         "consola": "^3.4.2",
@@ -137,7 +153,7 @@
         "tinyglobby": "^0.2.15",
         "typescript": "6.0.3",
         "vite": "8.1.5",
-        "vitest": "4.1.10",
+        "vitest": "4.1.11",
         "yaml": "^2.9.0",
         "zod": "^4.4.3"
     },