webanvil 0.0.11 → 0.0.13

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
@@ -56,17 +58,18 @@ wa typecheck   # type-check the project
 What it includes
 ----------------
 
-| Project job                | WebAnvil command                   | Tool                             |
-| -------------------------- | ---------------------------------- | -------------------------------- |
-| Web builds and development | `wa build`, `wa dev`, `wa preview` | Vite                             |
-| Node builds and watch mode | `wa build`, `wa dev`               | Rolldown                         |
-| Design-system Storybook    | `wa build`, `wa dev`, `wa preview` | Storybook                        |
-| Tracked output cleanup     | `wa clean`                         | WebAnvil                         |
-| Static checks              | `wa check`                         | Oxfmt, Oxlint, TypeScript Native |
-| Tests                      | `wa test`                          | Vitest                           |
-| Linting                    | `wa lint`                          | Oxlint                           |
-| Formatting                 | `wa format`                        | Oxfmt                            |
-| Type checking              | `wa typecheck`                     | TypeScript Native                |
+| Project job                | WebAnvil command                   | Tool                                              |
+| -------------------------- | ---------------------------------- | ------------------------------------------------- |
+| Web builds and development | `wa build`, `wa dev`, `wa preview` | Vite                                              |
+| Node builds and watch mode | `wa build`, `wa dev`               | Rolldown                                          |
+| Design-system Storybook    | `wa build`, `wa dev`, `wa preview` | Storybook                                         |
+| 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                 |
 
 Getting started
 ---------------
@@ -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
@@ -124,6 +129,12 @@ first failure. It is read-only by default. Use `wa check --fix` to format files
 and apply safe lint fixes before type checking. Tests stay separate under
 `wa test`.
 
+For a Svelte project, add `svelte-check` to the package's `devDependencies`.
+Then `wa typecheck` and `wa check` use it for project-wide diagnostics through
+the package's `tsconfig.json`. WebAnvil otherwise uses TypeScript Native.
+Explicit file paths such as `wa typecheck src/file.ts` always use TypeScript
+Native because `svelte-check` checks a project rather than individual files.
+
 ### A web app
 
 Set the build mode to `"web"` and point it at an HTML entry point. `wa dev` starts Vite's development server, `wa build` produces a production bundle, and `wa preview` serves that bundle locally.
@@ -329,16 +340,17 @@ 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                       | `>=4.1.10 <5`                        | `4.1.10`                |
+| 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
@@ -348,6 +360,9 @@ 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 e2e` always uses WebAnvil's bundled Playwright Test and Chromium. This keeps
+the runner and `webanvil/e2e` test API on the same version.
+
 ### Native tool configuration
 
 The `vite`, `test`, `rolldown`, `lint`, and `format` blocks use the owning
@@ -363,6 +378,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
@@ -488,6 +507,34 @@ These are run-specific modes; keep persistent Vitest configuration in
 `vitest.config.*`. `--ui-port` selects a strict loopback port and requires
 `--ui`.
 
+### 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 { expect, test } from "webanvil/e2e"
+
+test("shows the home page", 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
@@ -537,6 +584,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."
@@ -103,6 +104,12 @@ const supportedTools = {
 		packageName: "vitest",
 		range: ">=4.1.10 <5"
 	},
+	playwright: {
+		packageName: "@playwright/test",
+		range: ">=1.58.2 <2",
+		bin: "playwright",
+		allowProjectOverride: false
+	},
 	storybook: {
 		packageName: "storybook",
 		range: ">=10.5.9 <11",
@@ -132,6 +139,11 @@ const supportedTools = {
 		bin: "tsgo"
 	}
 };
+const optionalTools = { "svelte-check": {
+	packageName: "svelte-check",
+	range: ">=4 <5",
+	bin: "svelte-check"
+} };
 const dependencyFields = [
 	"dependencies",
 	"devDependencies",
@@ -318,6 +330,7 @@ const loadResolvedTool = async (name, definition, anchor, source) => {
 var Toolchain = class {
 	cwd;
 	#tools = /* @__PURE__ */ new Map();
+	#optionalTools = /* @__PURE__ */ new Map();
 	constructor(cwd = process.cwd()) {
 		this.cwd = resolve$1(cwd);
 	}
@@ -328,13 +341,26 @@ var Toolchain = class {
 		this.#tools.set(name, selected);
 		return selected;
 	}
+	resolveOptional(name) {
+		const existing = this.#optionalTools.get(name);
+		if (existing !== void 0) return existing;
+		const selected = this.#resolveOptional(name);
+		this.#optionalTools.set(name, selected);
+		return selected;
+	}
 	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");
 	}
+	async #resolveOptional(name) {
+		const definition = optionalTools[name];
+		const declaration = await findDeclaration(this.cwd, definition.packageName);
+		if (declaration === void 0) return;
+		return loadResolvedTool(name, definition, declaration.directory, "project");
+	}
 };
 const formatResolvedTool = (tool) => `${tool.packageName} ${tool.version} (${tool.source})`;
 const declarationDefaults = {
@@ -1078,9 +1104,20 @@ const useTool = async (name, toolchain = new Toolchain(process.cwd())) => {
 	}
 	return tool;
 };
+const useOptionalTool = async (name, toolchain = new Toolchain(process.cwd())) => {
+	const tool = await toolchain.resolveOptional(name);
+	if (tool === void 0) return;
+	const identity = `${tool.packageRoot}:${tool.version}`;
+	if (!announced.has(identity)) {
+		announced.add(identity);
+		logger.info(`Using ${formatResolvedTool(tool)}`);
+	}
+	return tool;
+};
 const useToolApi = async (name, subpath, toolchain = new Toolchain(process.cwd())) => (await useTool(name, toolchain)).import(subpath);
 const useToolExecutable = async (name, toolchain = new Toolchain(process.cwd())) => {
-	const tool = await useTool(name, toolchain);
+	const tool = name === "svelte-check" ? await useOptionalTool(name, toolchain) : await useTool(name, toolchain);
+	if (tool === void 0) throw new Error(`${name} is not declared by the active project or workspace`);
 	if (tool.executable === void 0) throw new Error(`${tool.packageName} does not expose an executable`);
 	return tool.executable;
 };
@@ -1225,6 +1262,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.",
@@ -1246,6 +1288,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.",
@@ -1278,6 +1325,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.",
@@ -1301,7 +1354,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({
@@ -1332,7 +1385,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;
@@ -1349,6 +1402,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);
@@ -1521,7 +1575,7 @@ const rebaseOxlintConfig = (config, cwd, configDirectory) => ({
 	}) } : {}
 });
 const runTool = async (name, arguments_, config) => {
-	if (name !== "tsgo" && await hasOxcConfig(name)) config = void 0;
+	if ((name === "oxfmt" || name === "oxlint") && await hasOxcConfig(name)) config = void 0;
 	const executable = await useToolExecutable(name === "tsgo" ? "typescript-native" : name);
 	const cwd = process.cwd();
 	const configDirectory = join(cwd, ".webanvil");
@@ -1532,7 +1586,7 @@ const runTool = async (name, arguments_, config) => {
 	const generatedConfig = configWithoutIgnores === void 0 || configPath === void 0 ? configWithoutIgnores : name === "oxfmt" ? rebaseOxfmtConfig(configWithoutIgnores, cwd, configDirectory) : rebaseOxlintConfig(configWithoutIgnores, cwd, configDirectory);
 	const ignoreArguments = name === "oxfmt" ? ignorePatterns.map((pattern) => pattern.startsWith("!") ? pattern.slice(1) : `!${pattern}`) : ignorePatterns.flatMap((pattern) => ["--ignore-pattern", pattern]);
 	const internalIgnoreArguments = name === "oxfmt" ? ["!**/.webanvil/**"] : ["--ignore-pattern", ".webanvil/**"];
-	const toolArguments = name === "tsgo" ? arguments_ : [
+	const toolArguments = name === "tsgo" || name === "svelte-check" ? arguments_ : [
 		...configPath === void 0 ? [] : ["--config", configPath],
 		...ignoreArguments,
 		...internalIgnoreArguments,
@@ -1594,9 +1648,10 @@ const typecheckArguments = async (paths) => {
 	];
 	return getTsconfig(process.cwd(), { typescriptVersion: false })?.config.references?.length ? ["-b", "--noEmit"] : ["--noEmit"];
 };
-const typecheck = async (paths) => {
-	logger.start("Type checking");
-	await runTool("tsgo", await typecheckArguments(paths));
+const typecheck = async (paths, options) => {
+	const svelteCheck = paths.length === 0 ? options === void 0 ? await useOptionalTool("svelte-check") : options.svelteCheck : void 0;
+	logger.start(svelteCheck === void 0 ? "Type checking" : "Checking Svelte");
+	await runTool(svelteCheck === void 0 ? "tsgo" : "svelte-check", svelteCheck === void 0 ? await typecheckArguments(paths) : []);
 	logger.success("Type check passed");
 };
 var typecheck_default = defineCommand({
@@ -1609,23 +1664,25 @@ const fix = defineOption({
 	description: "Format files and apply safe lint fixes.",
 	arity: 0
 });
-const checkProject = async (fixFiles = false, config = {}) => {
+const checkProject = async (fixFiles = false, config = {}, typecheckOptions) => {
 	await format([], !fixFiles, config.format);
 	await lint([], fixFiles, config.lint);
-	await typecheck([]);
+	if (typecheckOptions === void 0) await typecheck([]);
+	else await typecheck([], typecheckOptions);
 };
 var check_default = defineCommand({
 	name: "check",
 	description: "Check formatting, linting, and types, stopping at the first failure.",
 	options: [fix],
 	run: async ({ fix }) => {
-		await Promise.all([
+		const [svelteCheck] = await Promise.all([
+			useOptionalTool("svelte-check"),
 			useTool("oxfmt"),
-			useTool("oxlint"),
-			useTool("typescript-native")
+			useTool("oxlint")
 		]);
+		if (svelteCheck === void 0) await useTool("typescript-native");
 		const { config } = await loadConfig();
-		await checkProject(fix, config);
+		await checkProject(fix, config, { svelteCheck });
 	}
 });
 const clean = async () => {
@@ -1798,7 +1855,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");
@@ -1815,7 +1872,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();
@@ -1839,6 +1899,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");
@@ -1923,4 +2071,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,2 @@
+import { defineConfig, devices, expect, test } from "@playwright/test";
+export { defineConfig, devices, expect, test };

package/dist/e2e.mjs

@@ -0,0 +1,2 @@
+import { defineConfig, devices, expect, test } from "@playwright/test";
+export { defineConfig, devices, expect, test };

package/dist/index.d.mts

@@ -35,10 +35,12 @@ 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";
 type ResolvedTool = {
-  name: ToolName;
+  name: AnyToolName;
   packageName: string;
   version: string;
   source: ToolSource;
@@ -51,6 +53,7 @@ declare class Toolchain {
   readonly cwd: string;
   constructor(cwd?: string);
   resolve(name: ToolName): Promise<ResolvedTool>;
+  resolveOptional(name: OptionalToolName): Promise<ResolvedTool | undefined>;
 }
 type DeclarationLogger = {
   info: (...arguments_: unknown[]) => void;
@@ -290,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[]>;
@@ -372,8 +375,17 @@ declare const _default: import("cmdore").Command<readonly [{
   readonly name: "entry";
   readonly description: "Web entry or Node public root; unbundled Node builds emit its reachable graph with preserveModules.";
 }]>;
+type TypecheckOptions = {
+  svelteCheck: ResolvedTool | undefined;
+};
+declare const typecheck: (paths: string[], options?: TypecheckOptions) => Promise<void>;
+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;
+}]>;
 type CheckConfig = Pick<UserConfig, "format" | "lint">;
-declare const checkProject: (fixFiles?: boolean, config?: CheckConfig) => Promise<void>;
+declare const checkProject: (fixFiles?: boolean, config?: CheckConfig, typecheckOptions?: TypecheckOptions) => Promise<void>;
 declare const _default$1: import("cmdore").Command<readonly [{
   readonly name: "fix";
   readonly description: "Format files and apply safe lint fixes.";
@@ -472,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;
@@ -483,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;
@@ -493,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;
@@ -518,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;
@@ -532,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";
@@ -544,12 +596,6 @@ declare const _default$7: import("cmdore").Command<readonly [{
   readonly description: "Test files or names to run.";
   readonly variadic: true;
 }]>;
-declare const typecheck: (paths: string[]) => Promise<void>;
-declare const _default$8: import("cmdore").Command<readonly import("cmdore").Option[], readonly [{
-  readonly name: "paths";
-  readonly description: "Files or directories to check.";
-  readonly variadic: true;
-}]>;
 declare const bundle$1: {
   readonly name: "bundle";
   readonly description: "Bundle the Node public roots; without it, emit their reachable graph with preserveModules.";
@@ -582,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.";
@@ -606,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.";
@@ -644,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.";
@@ -667,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: {
@@ -683,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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "webanvil",
-    "version": "0.0.11",
+    "version": "0.0.13",
     "description": "A unified CLI for building, testing, linting, formatting, and type-checking JavaScript and TypeScript projects.",
     "keywords": [
         "build-tool",
@@ -41,6 +41,11 @@
             "import": "./dist/index.mjs",
             "default": "./dist/index.mjs"
         },
+        "./e2e": {
+            "types": "./dist/e2e.d.mts",
+            "import": "./dist/e2e.mjs",
+            "default": "./dist/e2e.mjs"
+        },
         "./storybook/test/preset": {
             "types": "./dist/storybook/test/preset.d.mts",
             "import": "./dist/storybook/test/preset.mjs",
@@ -106,6 +111,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",