webanvil 0.0.13 → 0.0.16

package/README.md

@@ -83,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`:
 
@@ -203,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
 
@@ -335,7 +335,8 @@ 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.
@@ -343,13 +344,13 @@ 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`                |
+| 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 (declarations)    | `>=5 <7.1.0`                         | `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
@@ -360,8 +361,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.
+`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
 
@@ -507,6 +509,24 @@ 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
@@ -514,11 +534,15 @@ 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()
+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()
+        })
+    })
 })
 ```
 

package/dist/_chunks/commands.mjs

@@ -102,7 +102,8 @@ const supportedTools = {
 	},
 	vitest: {
 		packageName: "vitest",
-		range: ">=4.1.10 <5"
+		range: ">=4.1.11 <5",
+		allowProjectOverride: false
 	},
 	playwright: {
 		packageName: "@playwright/test",
@@ -131,7 +132,7 @@ const supportedTools = {
 	},
 	typescript: {
 		packageName: "typescript",
-		range: ">=5 <7"
+		range: ">=5 <7.1.0"
 	},
 	"typescript-native": {
 		packageName: "@typescript/native-preview",
@@ -1121,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}`;

package/dist/e2e.d.mts

@@ -1,2 +1,73 @@
 import { defineConfig, devices, expect, test } from "@playwright/test";
-export { defineConfig, devices, expect, 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

@@ -1,2 +1,5 @@
-import { defineConfig, devices, expect, test } from "@playwright/test";
-export { defineConfig, devices, expect, test };
+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";

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.13",
+    "version": "0.0.16",
     "description": "A unified CLI for building, testing, linting, formatting, and type-checking JavaScript and TypeScript projects.",
     "keywords": [
         "build-tool",
@@ -46,6 +46,16 @@
             "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",
@@ -119,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",
@@ -143,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"
     },