toiljs 0.0.122 → 0.0.124

package/build/cli/index.js

@@ -650,11 +650,11 @@ var require_valid = __commonJS({
   "node_modules/semver/functions/valid.js"(exports, module) {
     "use strict";
     var parse = require_parse();
-    var valid = (version2, options) => {
+    var valid2 = (version2, options) => {
       const v = parse(version2, options);
       return v ? v.version : null;
     };
-    module.exports = valid;
+    module.exports = valid2;
   }
 });
 
@@ -871,8 +871,8 @@ var require_eq = __commonJS({
   "node_modules/semver/functions/eq.js"(exports, module) {
     "use strict";
     var compare = require_compare();
-    var eq = (a2, b, loose) => compare(a2, b, loose) === 0;
-    module.exports = eq;
+    var eq2 = (a2, b, loose) => compare(a2, b, loose) === 0;
+    module.exports = eq2;
   }
 });
 
@@ -910,7 +910,7 @@ var require_lte = __commonJS({
 var require_cmp = __commonJS({
   "node_modules/semver/functions/cmp.js"(exports, module) {
     "use strict";
-    var eq = require_eq();
+    var eq2 = require_eq();
     var neq = require_neq();
     var gt = require_gt();
     var gte = require_gte();
@@ -937,7 +937,7 @@ var require_cmp = __commonJS({
         case "":
         case "=":
         case "==":
-          return eq(a2, b, loose);
+          return eq2(a2, b, loose);
         case "!=":
           return neq(a2, b, loose);
         case ">":
@@ -1584,7 +1584,7 @@ var require_satisfies = __commonJS({
   "node_modules/semver/functions/satisfies.js"(exports, module) {
     "use strict";
     var Range = require_range();
-    var satisfies2 = (version2, range, options) => {
+    var satisfies4 = (version2, range, options) => {
       try {
         range = new Range(range, options);
       } catch (er) {
@@ -1592,7 +1592,7 @@ var require_satisfies = __commonJS({
       }
       return range.test(version2);
     };
-    module.exports = satisfies2;
+    module.exports = satisfies4;
   }
 });
 
@@ -1728,14 +1728,14 @@ var require_valid2 = __commonJS({
   "node_modules/semver/ranges/valid.js"(exports, module) {
     "use strict";
     var Range = require_range();
-    var validRange2 = (range, options) => {
+    var validRange4 = (range, options) => {
       try {
         return new Range(range, options).range || "*";
       } catch (er) {
         return null;
       }
     };
-    module.exports = validRange2;
+    module.exports = validRange4;
   }
 });
 
@@ -1747,7 +1747,7 @@ var require_outside = __commonJS({
     var Comparator = require_comparator();
     var { ANY } = Comparator;
     var Range = require_range();
-    var satisfies2 = require_satisfies();
+    var satisfies4 = require_satisfies();
     var gt = require_gt();
     var lt = require_lt();
     var lte = require_lte();
@@ -1774,7 +1774,7 @@ var require_outside = __commonJS({
         default:
           throw new TypeError('Must provide a hilo val of "<" or ">"');
       }
-      if (satisfies2(version2, range, options)) {
+      if (satisfies4(version2, range, options)) {
         return false;
       }
       for (let i2 = 0; i2 < range.set.length; ++i2) {
@@ -1833,12 +1833,12 @@ var require_intersects = __commonJS({
   "node_modules/semver/ranges/intersects.js"(exports, module) {
     "use strict";
     var Range = require_range();
-    var intersects = (r1, r2, options) => {
+    var intersects2 = (r1, r2, options) => {
       r1 = new Range(r1, options);
       r2 = new Range(r2, options);
       return r1.intersects(r2, options);
     };
-    module.exports = intersects;
+    module.exports = intersects2;
   }
 });
 
@@ -1846,7 +1846,7 @@ var require_intersects = __commonJS({
 var require_simplify = __commonJS({
   "node_modules/semver/ranges/simplify.js"(exports, module) {
     "use strict";
-    var satisfies2 = require_satisfies();
+    var satisfies4 = require_satisfies();
     var compare = require_compare();
     module.exports = (versions, range, options) => {
       const set = [];
@@ -1854,7 +1854,7 @@ var require_simplify = __commonJS({
       let prev = null;
       const v = versions.sort((a2, b) => compare(a2, b, options));
       for (const version2 of v) {
-        const included = satisfies2(version2, range, options);
+        const included = satisfies4(version2, range, options);
         if (included) {
           prev = version2;
           if (!first) {
@@ -1899,9 +1899,9 @@ var require_subset = __commonJS({
     var Range = require_range();
     var Comparator = require_comparator();
     var { ANY } = Comparator;
-    var satisfies2 = require_satisfies();
+    var satisfies4 = require_satisfies();
     var compare = require_compare();
-    var subset2 = (sub, dom, options = {}) => {
+    var subset3 = (sub, dom, options = {}) => {
       if (sub === dom) {
         return true;
       }
@@ -1967,15 +1967,15 @@ var require_subset = __commonJS({
           return null;
         }
       }
-      for (const eq of eqSet) {
-        if (gt && !satisfies2(eq, String(gt), options)) {
+      for (const eq2 of eqSet) {
+        if (gt && !satisfies4(eq2, String(gt), options)) {
           return null;
         }
-        if (lt && !satisfies2(eq, String(lt), options)) {
+        if (lt && !satisfies4(eq2, String(lt), options)) {
           return null;
         }
         for (const c2 of dom) {
-          if (!satisfies2(eq, String(c2), options)) {
+          if (!satisfies4(eq2, String(c2), options)) {
             return false;
           }
         }
@@ -2050,7 +2050,7 @@ var require_subset = __commonJS({
       const comp = compare(a2.semver, b.semver, options);
       return comp < 0 ? a2 : comp > 0 ? b : b.operator === "<" && a2.operator === "<=" ? b : a2;
     };
-    module.exports = subset2;
+    module.exports = subset3;
   }
 });
 
@@ -2063,7 +2063,7 @@ var require_semver2 = __commonJS({
     var SemVer = require_semver();
     var identifiers = require_identifiers();
     var parse = require_parse();
-    var valid = require_valid();
+    var valid2 = require_valid();
     var clean2 = require_clean();
     var inc = require_inc();
     var diff = require_diff();
@@ -2079,7 +2079,7 @@ var require_semver2 = __commonJS({
     var rsort = require_rsort();
     var gt = require_gt();
     var lt = require_lt();
-    var eq = require_eq();
+    var eq2 = require_eq();
     var neq = require_neq();
     var gte = require_gte();
     var lte = require_lte();
@@ -2088,21 +2088,21 @@ var require_semver2 = __commonJS({
     var truncate = require_truncate();
     var Comparator = require_comparator();
     var Range = require_range();
-    var satisfies2 = require_satisfies();
+    var satisfies4 = require_satisfies();
     var toComparators = require_to_comparators();
     var maxSatisfying = require_max_satisfying();
     var minSatisfying = require_min_satisfying();
     var minVersion2 = require_min_version();
-    var validRange2 = require_valid2();
+    var validRange4 = require_valid2();
     var outside = require_outside();
     var gtr = require_gtr();
     var ltr = require_ltr();
-    var intersects = require_intersects();
+    var intersects2 = require_intersects();
     var simplifyRange = require_simplify();
-    var subset2 = require_subset();
+    var subset3 = require_subset();
     module.exports = {
       parse,
-      valid,
+      valid: valid2,
       clean: clean2,
       inc,
       diff,
@@ -2118,7 +2118,7 @@ var require_semver2 = __commonJS({
       rsort,
       gt,
       lt,
-      eq,
+      eq: eq2,
       neq,
       gte,
       lte,
@@ -2127,18 +2127,18 @@ var require_semver2 = __commonJS({
       truncate,
       Comparator,
       Range,
-      satisfies: satisfies2,
+      satisfies: satisfies4,
       toComparators,
       maxSatisfying,
       minSatisfying,
       minVersion: minVersion2,
-      validRange: validRange2,
+      validRange: validRange4,
       outside,
       gtr,
       ltr,
-      intersects,
+      intersects: intersects2,
       simplifyRange,
-      subset: subset2,
+      subset: subset3,
       SemVer,
       re: internalRe.re,
       src: internalRe.src,
@@ -3510,7 +3510,7 @@ var PREPROCESSOR_PKG = {
 };
 var TAILWIND_PKGS = ["tailwindcss", "@tailwindcss/vite"];
 var PKG_VERSION = {
-  sass: "^1.104.1",
+  sass: "^1.105.1",
   less: "^4.9.1",
   stylus: "^0.64.0",
   tailwindcss: "^4.3.3",
@@ -4017,6 +4017,88 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 var import_picocolors3 = __toESM(require_picocolors(), 1);
 import { AI_HELPER_IDS, AI_HELPERS, aiHelperFiles, TOIL_DOCS, TOIL_ENV_DTS } from "toiljs/compiler";
 
+// src/cli/testing.ts
+var TEST_DEPENDENCIES = {
+  vitest: "^5.0.3",
+  "@vitest/browser-webdriverio": "^5.0.0",
+  "@vitest/coverage-v8": "^5.0.3",
+  webdriverio: "^10.0.2"
+};
+var TEST_SCRIPTS = {
+  test: "toiljs test",
+  "test:watch": "toiljs test --watch",
+  "test:browser": "toiljs test --browser",
+  "test:all": "toiljs test --all",
+  "test:coverage": "toiljs test --all --coverage"
+};
+function testingFiles() {
+  return {
+    "vitest.config.ts": "import { defineTestConfig } from 'toiljs/vitest';\n\nexport default defineTestConfig();\n",
+    "client/lib/Greeting.ts": [
+      "/** Formats a greeting, treating blank input as an unnamed guest. */",
+      "export class Greeting {",
+      "    public static message(name: string): string {",
+      "        const recipient: string = name.trim() || 'guest';",
+      "        return `Hello, ${recipient}!`;",
+      "    }",
+      "}",
+      ""
+    ].join("\n"),
+    "tests/Greeting.test.ts": [
+      "import { expect, test } from 'vitest';",
+      "import { Greeting } from '../client/lib/Greeting';",
+      "",
+      "test('trims the supplied name', (): void => {",
+      "    expect(Greeting.message('  Ada  ')).toBe('Hello, Ada!');",
+      "});",
+      "",
+      "test('greets an unnamed guest', (): void => {",
+      "    expect(Greeting.message('   ')).toBe('Hello, guest!');",
+      "});",
+      ""
+    ].join("\n"),
+    "client/components/TestCounter.tsx": [
+      "import { useState, type ReactElement } from 'react';",
+      "",
+      "/** A small component used by the starter browser test. */",
+      "export function TestCounter(): ReactElement {",
+      "    const [count, setCount] = useState<number>(0);",
+      "    return (",
+      "        <section>",
+      '            <Toil.Link href="/">Home</Toil.Link>',
+      "            <button onClick={(): void => setCount(count + 1)}>Count: {count}</button>",
+      "        </section>",
+      "    );",
+      "}",
+      ""
+    ].join("\n"),
+    "tests/TestCounter.browser.test.tsx": [
+      "import { afterEach, expect, test } from 'vitest';",
+      "import { page } from 'vitest/browser';",
+      "import { createRoot, type Root } from 'react-dom/client';",
+      "import { TestCounter } from '../client/components/TestCounter';",
+      "",
+      "let root: Root | null = null;",
+      "afterEach((): void => {",
+      "    root?.unmount();",
+      "    root = null;",
+      "    document.body.replaceChildren();",
+      "});",
+      "",
+      "test('increments when clicked in a real browser', async (): Promise<void> => {",
+      "    const host: HTMLDivElement = document.createElement('div');",
+      "    document.body.append(host);",
+      "    root = createRoot(host);",
+      "    root.render(<TestCounter />);",
+      "    await expect.element(page.getByRole('link', { name: 'Home' })).toHaveAttribute('href', '/');",
+      "    await page.getByRole('button', { name: 'Count: 0' }).click();",
+      "    await expect.element(page.getByRole('button', { name: 'Count: 1' })).toBeVisible();",
+      "});",
+      ""
+    ].join("\n")
+  };
+}
+
 // src/cli/validate.ts
 import path3 from "node:path";
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
@@ -4061,12 +4143,13 @@ async function isEmptyDir(dir) {
 function scaffold(name, template, features, aiTools, images) {
   const toilVersion = version();
   const devDependencies = {
+    ...TEST_DEPENDENCIES,
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
-    oxlint: "^1.83.0",
-    "oxlint-tsgolint": "^7.0.2001",
-    prettier: "^3.9.6",
-    toilscript: "^0.1.63",
+    oxlint: "^1.87.0",
+    "oxlint-tsgolint": "^7.0.2003",
+    prettier: "^3.9.9",
+    toilscript: ">=0.1.63",
     typescript: "^7.0.2"
   };
   for (const dep of requiredPackages(features).sort()) {
@@ -4077,6 +4160,7 @@ function scaffold(name, template, features, aiTools, images) {
     private: true,
     type: "module",
     scripts: {
+      ...TEST_SCRIPTS,
       start: "toiljs start",
       dev: "toiljs dev",
       build: "toiljs build",
@@ -4093,6 +4177,7 @@ function scaffold(name, template, features, aiTools, images) {
     devDependencies
   };
   const files = {
+    ...testingFiles(),
     "package.json": JSON.stringify(pkg, null, 4) + "\n",
     "toil.config.ts": "import { defineConfig } from 'toiljs/compiler';\n\nexport default defineConfig({\n" + // The app starter's session routes use the identity fields injected by built-in auth.
     (template === "app" ? "    server: { auth: true },\n" : "") + `    client: {
@@ -4101,13 +4186,13 @@ function scaffold(name, template, features, aiTools, images) {
     },
 });
 `,
-    "tsconfig.json": '{\n    "extends": "toiljs/tsconfig",\n    "compilerOptions": {\n        "paths": { "shared/*": ["./shared/*"] }\n    },\n    "include": ["client", "shared", "emails", "toil.config.ts", "toil-env.d.ts", "toil-routes.d.ts"]\n}\n',
+    "tsconfig.json": '{\n    "extends": "toiljs/tsconfig",\n    "compilerOptions": {\n        "paths": { "shared/*": ["./shared/*"] }\n    },\n    "include": ["client", "shared", "emails", "tests", "vitest.config.ts", "toil.config.ts", "toil-env.d.ts", "toil-routes.d.ts"]\n}\n',
     "oxlint.config.ts": "import toiljs from 'toiljs/oxlint';\n\nexport default toiljs;\n",
     ".prettierrc": '"toiljs/prettier"\n',
     // Generated files don't need formatting. (toilscript server decorators like @main /
     // @remote-on-functions are handled by the toiljs/prettier-plugin, so server/ is not ignored.)
-    ".prettierignore": "node_modules\nbuild\n.toil\nshared/server.ts\ntoil-env.d.ts\ntoil-routes.d.ts\nserver/_emails.ts\nserver/_ssr/\nserver/toil-server-env.d.ts\n",
-    ".gitignore": "node_modules\nbuild\n.toil\nshared/server.ts\ntoil-env.d.ts\ntoil-routes.d.ts\nserver/_ssr/\nhosts/*/_tmpl/\n# Local dev env vars/secrets (never commit)\n.env\n.env.secrets\n",
+    ".prettierignore": "node_modules\nbuild\n.toil\ncoverage\n.vitest\nshared/server.ts\ntoil-env.d.ts\ntoil-routes.d.ts\nserver/_emails.ts\nserver/_ssr/\nserver/toil-server-env.d.ts\n",
+    ".gitignore": "node_modules\nbuild\n.toil\ncoverage\n.vitest\nshared/server.ts\ntoil-env.d.ts\ntoil-routes.d.ts\nserver/_ssr/\nhosts/*/_tmpl/\n# Local dev env vars/secrets (never commit)\n.env\n.env.secrets\n",
     // Use the native TypeScript 7 language server.
     ".vscode/settings.json": JSON.stringify(
       {
@@ -4191,6 +4276,21 @@ function scaffold(name, template, features, aiTools, images) {
       "",
       "    npm run build",
       "",
+      "## Test",
+      "",
+      "Vitest, real-browser testing, and V8 coverage are installed with the project.",
+      "Start with `tests/Greeting.test.ts` and `tests/TestCounter.browser.test.tsx`.",
+      "",
+      "    npm test                 # unit tests",
+      "    npm run test:watch       # unit tests in watch mode",
+      "    npm run test:browser     # real Chrome tests",
+      "    npm run test:all         # unit and browser tests",
+      "    npm run test:coverage    # both suites with V8 coverage",
+      "",
+      "Coverage reports are in `coverage/` (HTML, JSON, and LCOV).",
+      "Chrome and its driver are managed by WebdriverIO on the first browser run.",
+      "See `.toil/docs/frontend/testing.md` for configuration, mocks, and CI.",
+      "",
       "## Editor setup",
       "",
       "Run `npm install` first and use Node 26 for editor tooling.",
@@ -4425,9 +4525,9 @@ async function runCreate(opts2) {
       name = answer.trim() || "my-toil-app";
     }
   }
-  const valid = isValidName(name);
-  if (valid !== true) {
-    cancel(valid);
+  const valid2 = isValidName(name);
+  if (valid2 !== true) {
+    cancel(valid2);
     process.exit(1);
   }
   const targetDir = resolveProjectDir(opts2.cwd, name);
@@ -4602,6 +4702,8 @@ async function runCreate(opts2) {
   if (!install) steps.push("npm install");
   steps.push(`${accent("npm run dev")}   ${dim("start the dev server")}`);
   steps.push(`${accent("npm run build")} ${dim("build for production")}`);
+  steps.push(`${accent("npm test")} ${dim("run the starter unit tests")}`);
+  steps.push(`${accent("npm run test:browser")} ${dim("run the starter browser test")}`);
   steps.push("Install the Oxc plugin for VS Code or WebStorm (README.md \u2192 Editor setup)");
   steps.push("WebStorm: Settings \u2192 Tools \u2192 Oxlint \u2192 Enable type aware rules");
   note(steps.map((l2) => dim("  ") + l2).join("\n"), "Next steps");
@@ -4736,9 +4838,9 @@ function runDb(action, fileArg, opts2) {
 }
 
 // src/cli/doctor.ts
-import fs5 from "node:fs";
-import { createRequire } from "node:module";
-import path6 from "node:path";
+import fs6 from "node:fs";
+import { createRequire as createRequire2 } from "node:module";
+import path7 from "node:path";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
 import {
   loadConfig as loadConfig2,
@@ -5148,10 +5250,240 @@ function hasFailures(summary) {
   return summary.fail > 0;
 }
 
+// src/cli/test-setup.ts
+import fs5 from "node:fs/promises";
+import path6 from "node:path";
+import { createRequire } from "node:module";
+var import_semver3 = __toESM(require_semver2(), 1);
+
+// src/cli/testing-versions.ts
+var import_semver2 = __toESM(require_semver2(), 1);
+function isSupportedTestingRange(name, range) {
+  const supported = TEST_DEPENDENCIES[name];
+  return supported === void 0 || (0, import_semver2.validRange)(range) !== null && (0, import_semver2.subset)(range, supported);
+}
+function isTestingSource(range) {
+  return /^(file:|workspace:|link:|git[+:]|https?:|github:|npm:)/.test(range);
+}
+
+// src/cli/test-setup.ts
+async function findTestConfiguration(root) {
+  const files = await fs5.readdir(root);
+  const custom = files.find((file) => /^vitest\.config\.[cm]?[jt]s$/.test(file)) ?? files.find((file) => /^vite\.config\.[cm]?[jt]s$/.test(file));
+  const source = custom === void 0 ? "" : await fs5.readFile(path6.join(root, custom), "utf8");
+  const native = custom === void 0 || source.includes("from 'toiljs/vitest'") || source.includes('from "toiljs/vitest"');
+  return { file: custom ?? null, native };
+}
+async function writeMissing(root, file, content) {
+  const target = path6.join(root, file);
+  await fs5.mkdir(path6.dirname(target), { recursive: true });
+  try {
+    await fs5.writeFile(target, content, { flag: "wx" });
+    return true;
+  } catch (error) {
+    if (!(error instanceof Error) || !("code" in error) || error.code !== "EEXIST") throw error;
+    return false;
+  }
+}
+async function ensureTesting(root, repairVersions = false) {
+  const pkgPath = path6.join(root, "package.json");
+  const raw = JSON.parse(await fs5.readFile(pkgPath, "utf8"));
+  if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+    throw new Error("toiljs test: package.json must contain an object.");
+  const pkg = raw;
+  for (const field of [pkg.scripts, pkg.dependencies, pkg.devDependencies]) {
+    if (field !== void 0 && (field === null || typeof field !== "object" || Array.isArray(field) || Object.values(field).some((value) => typeof value !== "string")))
+      throw new Error("toiljs test: package scripts and dependencies must be string maps.");
+  }
+  const config = await findTestConfiguration(root);
+  const { native } = config;
+  const changes = [];
+  const skipped = [];
+  let changed = false;
+  let install = false;
+  const require2 = createRequire(pkgPath);
+  for (const [name, range] of Object.entries(TEST_DEPENDENCIES)) {
+    for (const dependencies of [pkg.dependencies, pkg.devDependencies]) {
+      const declared = dependencies?.[name];
+      if (repairVersions && dependencies && declared && !isSupportedTestingRange(name, declared) && !isTestingSource(declared)) {
+        dependencies[name] = range;
+        changes.push(`package.json (${name} ${declared} -> ${range})`);
+        changed = true;
+        install = true;
+      }
+    }
+    if (pkg.dependencies?.[name] === void 0 && pkg.devDependencies?.[name] === void 0) {
+      pkg.devDependencies ??= {};
+      pkg.devDependencies[name] = range;
+      changes.push(`package.json (add ${name})`);
+      changed = true;
+      install = true;
+    }
+    try {
+      require2.resolve(name);
+    } catch {
+      install = true;
+    }
+  }
+  if (repairVersions) {
+    const runnerRange = pkg.dependencies?.vitest ?? pkg.devDependencies?.vitest;
+    const coverageDependencies = pkg.dependencies?.["@vitest/coverage-v8"] !== void 0 ? pkg.dependencies : pkg.devDependencies;
+    if (runnerRange && isSupportedTestingRange("vitest", runnerRange) && coverageDependencies && (0, import_semver3.validRange)(coverageDependencies["@vitest/coverage-v8"] ?? "") !== null) {
+      const installedRunner = await testVersion(require2, "vitest");
+      const installedCoverage = await testVersion(
+        require2,
+        "@vitest/coverage-v8"
+      );
+      const target = installedRunner && installedCoverage && installedRunner !== installedCoverage && (0, import_semver3.satisfies)(installedRunner, runnerRange) ? installedRunner : (0, import_semver3.intersects)(coverageDependencies["@vitest/coverage-v8"], runnerRange) ? coverageDependencies["@vitest/coverage-v8"] : runnerRange;
+      if (coverageDependencies["@vitest/coverage-v8"] !== target) {
+        coverageDependencies["@vitest/coverage-v8"] = target;
+        changes.push("package.json (align V8 coverage with Vitest)");
+        changed = true;
+        install = true;
+      }
+      if (installedRunner && installedCoverage && installedRunner !== installedCoverage)
+        install = true;
+    }
+  }
+  pkg.scripts ??= {};
+  for (const [name, script] of Object.entries(TEST_SCRIPTS)) {
+    if (pkg.scripts[name]?.trim()) continue;
+    pkg.scripts[name] = script;
+    changes.push(`package.json (add script ${name})`);
+    changed = true;
+  }
+  if (changed) await fs5.writeFile(pkgPath, JSON.stringify(raw, null, 4) + "\n");
+  if (config.file === null) {
+    for (const [file, content] of Object.entries(testingFiles()))
+      if (await writeMissing(root, file, content)) changes.push(file);
+  }
+  if (native) await includeTestTypes(root, config.file ?? "vitest.config.ts", changes, skipped);
+  await ignoreTestReports(root, changes);
+  return { install, native, changed: changes, skipped };
+}
+async function includeTestTypes(root, config, changes, skipped) {
+  const file = path6.join(root, "tsconfig.json");
+  let source;
+  try {
+    source = await fs5.readFile(file, "utf8");
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") return;
+    throw error;
+  }
+  try {
+    const raw = JSON.parse(source);
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+      throw new Error("Expected an object");
+    const parsed = raw;
+    if (!isStringArray(parsed.include)) {
+      skipped.push(
+        "tsconfig.json: include tests and the Vitest config in your existing file selection."
+      );
+      return;
+    }
+    const include = parsed.include;
+    const missing = ["tests", config].filter(
+      (entry) => !include.includes(entry)
+    );
+    if (!missing.length) return;
+    include.push(...missing);
+    await fs5.writeFile(file, JSON.stringify(parsed, null, 4) + "\n");
+    changes.push("tsconfig.json (include tests and Vitest config)");
+  } catch {
+    skipped.push(
+      "tsconfig.json: include tests and the Vitest config manually; custom JSON was preserved."
+    );
+  }
+}
+async function ignoreTestReports(root, changes) {
+  const file = path6.join(root, ".gitignore");
+  let source = "";
+  try {
+    source = await fs5.readFile(file, "utf8");
+  } catch (error) {
+    if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") throw error;
+  }
+  const lines = source.split(/\r?\n/).map((line) => line.trim().replace(/\/$/, ""));
+  const missing = ["coverage", ".vitest"].filter(
+    (entry) => !lines.includes(entry) && !lines.includes("/" + entry)
+  );
+  if (!missing.length) return;
+  await fs5.writeFile(
+    file,
+    source + (source && !source.endsWith("\n") ? "\n" : "") + missing.join("\n") + "\n"
+  );
+  changes.push(".gitignore (test reports)");
+}
+async function testVersion(require2, name) {
+  try {
+    const raw = JSON.parse(
+      await fs5.readFile(require2.resolve(`${name}/package.json`), "utf8")
+    );
+    return raw !== null && typeof raw === "object" && "version" in raw && typeof raw.version === "string" ? raw.version : null;
+  } catch {
+    return null;
+  }
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+
+// src/cli/testing-checks.ts
+var import_semver4 = __toESM(require_semver2(), 1);
+function checkTesting(facts) {
+  const configured = Object.keys(TEST_DEPENDENCIES).some(
+    (name) => facts.dependencies[name] !== void 0
+  ) || facts.configuration.file?.startsWith("vitest.config.") === true;
+  const repair = "Run `toiljs doctor --fix`, then your package manager install (or `toiljs test` to install missing tooling).";
+  const checks = Object.entries(TEST_DEPENDENCIES).map(([name, range]) => {
+    const installed = facts.installed[name] ?? null;
+    const declared = facts.dependencies[name];
+    const ok = installed !== null && declared !== void 0 && (0, import_semver4.satisfies)(installed, range) && (isSupportedTestingRange(name, declared) || isTestingSource(declared));
+    return {
+      id: `testing:${name}`,
+      label: name,
+      status: ok ? "pass" : configured ? "fail" : "warn",
+      detail: `${installed ?? "not installed"}; declared ${declared ?? "missing"} (requires ${range})`,
+      fix: ok ? void 0 : repair
+    };
+  });
+  const runner = facts.installed.vitest ?? null;
+  const coverage = facts.installed["@vitest/coverage-v8"] ?? null;
+  if (runner !== null && coverage !== null) {
+    const match = (0, import_semver4.valid)(runner) !== null && (0, import_semver4.valid)(coverage) !== null && (0, import_semver4.eq)(runner, coverage);
+    checks.push({
+      id: "testing:coverage-match",
+      label: "Vitest / V8 coverage versions",
+      status: match ? "pass" : "fail",
+      detail: `vitest ${runner}, @vitest/coverage-v8 ${coverage}`,
+      fix: match ? void 0 : "Install matching versions of vitest and @vitest/coverage-v8; run `toiljs update --yes` to refresh both."
+    });
+  }
+  const configPresent = facts.configuration.file !== null;
+  checks.push({
+    id: "testing:config",
+    label: "Vitest configuration",
+    status: configPresent ? "pass" : "warn",
+    detail: configPresent ? `${facts.configuration.file} (${facts.configuration.native ? "toiljs preset" : "custom, preserved"})` : "missing",
+    fix: configPresent ? void 0 : repair
+  });
+  const missing = Object.keys(TEST_SCRIPTS).filter(
+    (name) => !facts.scripts[name]?.trim()
+  );
+  checks.push({
+    id: "testing:scripts",
+    label: "Unit, browser, watch, and coverage scripts",
+    status: missing.length ? "warn" : "pass",
+    detail: missing.length ? `missing ${missing.join(", ")}` : "configured",
+    fix: missing.length ? repair : void 0
+  });
+  return checks;
+}
+
 // src/cli/doctor.ts
 function readJsonObject(file) {
   try {
-    const parsed = JSON.parse(fs5.readFileSync(file, "utf8"));
+    const parsed = JSON.parse(fs6.readFileSync(file, "utf8"));
     return typeof parsed === "object" && parsed !== null ? parsed : null;
   } catch {
     return null;
@@ -5165,16 +5497,16 @@ function stringRecord(value) {
 }
 function readFile(file) {
   try {
-    return fs5.readFileSync(file, "utf8");
+    return fs6.readFileSync(file, "utf8");
   } catch {
     return null;
   }
 }
 function writeFile(file, content) {
-  fs5.writeFileSync(file, content);
+  fs6.writeFileSync(file, content);
 }
 function isPackageInstalled(root, name) {
-  const require2 = createRequire(path6.join(root, "package.json"));
+  const require2 = createRequire2(path7.join(root, "package.json"));
   for (const id of [`${name}/package.json`, name]) {
     try {
       require2.resolve(id);
@@ -5183,22 +5515,22 @@ function isPackageInstalled(root, name) {
     }
   }
   for (let dir = root; ; ) {
-    if (fs5.existsSync(path6.join(dir, "node_modules", name, "package.json"))) return true;
-    const parent = path6.dirname(dir);
+    if (fs6.existsSync(path7.join(dir, "node_modules", name, "package.json"))) return true;
+    const parent = path7.dirname(dir);
     if (parent === dir) return false;
     dir = parent;
   }
 }
 function installedVersion(root, name) {
-  const require2 = createRequire(path6.join(root, "package.json"));
+  const require2 = createRequire2(path7.join(root, "package.json"));
   let pkgPath = null;
   try {
     pkgPath = require2.resolve(`${name}/package.json`);
   } catch {
     for (let dir = root; pkgPath === null; ) {
-      const candidate = path6.join(dir, "node_modules", name, "package.json");
-      if (fs5.existsSync(candidate)) pkgPath = candidate;
-      const parent = path6.dirname(dir);
+      const candidate = path7.join(dir, "node_modules", name, "package.json");
+      if (fs6.existsSync(candidate)) pkgPath = candidate;
+      const parent = path7.dirname(dir);
       if (parent === dir) break;
       dir = parent;
     }
@@ -5210,7 +5542,7 @@ function installedVersion(root, name) {
 function applyTypeScriptFix(root) {
   const changed = [];
   const skipped = [];
-  const pkgPath = path6.join(root, "package.json");
+  const pkgPath = path7.join(root, "package.json");
   const pkg = readJsonObject(pkgPath);
   if (pkg === null) return { changed, skipped };
   let declared = false;
@@ -5248,14 +5580,14 @@ function looksLikeSemverRange(range) {
   return /^\s*[v^~>=<]*\s*\d+\.\d+/.test(range);
 }
 function gatherRpcFacts(root) {
-  const pkg = readJsonObject(path6.join(root, "package.json"));
+  const pkg = readJsonObject(path7.join(root, "package.json"));
   const scripts = pkg ? stringRecord(pkg.scripts) : {};
   const deps = {
     ...pkg ? stringRecord(pkg.dependencies) : {},
     ...pkg ? stringRecord(pkg.devDependencies) : {}
   };
-  const tsconfig = readJsonObject(path6.join(root, "tsconfig.json"));
-  const gitignore = readFile(path6.join(root, ".gitignore"));
+  const tsconfig = readJsonObject(path7.join(root, "tsconfig.json"));
+  const gitignore = readFile(path7.join(root, ".gitignore"));
   const buildServerWired = [scripts["build:server"], scripts["build"]].some(
     (s) => typeof s === "string" && (s.includes("--rpcModule") || /\btoiljs\s+build\b/.test(s))
   );
@@ -5274,7 +5606,7 @@ function gatherRpcFacts(root) {
 function serverSources(root, toilconfig) {
   const dirs = /* @__PURE__ */ new Set();
   const entries = Array.isArray(toilconfig?.entries) ? toilconfig.entries.filter((e) => typeof e === "string") : [];
-  for (const e of entries) dirs.add(path6.dirname(path6.resolve(root, e)));
+  for (const e of entries) dirs.add(path7.dirname(path7.resolve(root, e)));
   const out2 = [];
   const cap = 200;
   const maxDepth = 16;
@@ -5282,13 +5614,13 @@ function serverSources(root, toilconfig) {
     if (out2.length >= cap || depth > maxDepth) return;
     let listing;
     try {
-      listing = fs5.readdirSync(current, { withFileTypes: true });
+      listing = fs6.readdirSync(current, { withFileTypes: true });
     } catch {
       return;
     }
     for (const entry of listing) {
       if (out2.length >= cap) break;
-      const full = path6.join(current, entry.name);
+      const full = path7.join(current, entry.name);
       if (entry.isDirectory()) {
         if (entry.name !== "node_modules") visit(full, depth + 1);
       } else if (entry.name.endsWith(".ts") && !entry.name.endsWith(".d.ts")) {
@@ -5312,7 +5644,7 @@ function gatherRestFacts(root, toilconfig) {
   return { hasControllers, dispatched };
 }
 function secretDefined(root, key) {
-  const raw = readFile(path6.join(root, ".env.secrets"));
+  const raw = readFile(path7.join(root, ".env.secrets"));
   if (raw === null) return false;
   return new RegExp(`^\\s*(?:export\\s+)?${key}\\s*=\\s*\\S`, "m").test(raw);
 }
@@ -5329,21 +5661,21 @@ function gatherAuthFacts(root, toilconfig) {
 function serverTsconfigPath(root, toilconfig) {
   const dirs = /* @__PURE__ */ new Set();
   const entries = Array.isArray(toilconfig?.entries) ? toilconfig.entries.filter((e) => typeof e === "string") : [];
-  for (const e of entries) dirs.add(path6.dirname(path6.resolve(root, e)));
-  if (dirs.size === 0) dirs.add(path6.join(root, "server"));
+  for (const e of entries) dirs.add(path7.dirname(path7.resolve(root, e)));
+  if (dirs.size === 0) dirs.add(path7.join(root, "server"));
   for (const dir of dirs) {
-    const p = path6.join(dir, "tsconfig.json");
-    if (fs5.existsSync(p)) return p;
+    const p = path7.join(dir, "tsconfig.json");
+    if (fs6.existsSync(p)) return p;
   }
   return null;
 }
 function serverMigrationsExist(root, toilconfig) {
   const dirs = /* @__PURE__ */ new Set();
   const entries = Array.isArray(toilconfig?.entries) ? toilconfig.entries.filter((e) => typeof e === "string") : [];
-  for (const e of entries) dirs.add(path6.dirname(path6.resolve(root, e)));
-  if (dirs.size === 0) dirs.add(path6.join(root, "server"));
+  for (const e of entries) dirs.add(path7.dirname(path7.resolve(root, e)));
+  if (dirs.size === 0) dirs.add(path7.join(root, "server"));
   for (const dir of dirs) {
-    if (fs5.existsSync(path6.join(dir, "migrations"))) return true;
+    if (fs6.existsSync(path7.join(dir, "migrations"))) return true;
   }
   return false;
 }
@@ -5358,7 +5690,7 @@ function tsconfigHasToilPlugin(tsconfig) {
 function applyRpcFix(root) {
   const changed = [];
   const skipped = [];
-  const pkgPath = path6.join(root, "package.json");
+  const pkgPath = path7.join(root, "package.json");
   const pkgRaw = readFile(pkgPath);
   const pkg = pkgRaw !== null ? readJsonObject(pkgPath) : null;
   if (pkg !== null) {
@@ -5397,7 +5729,7 @@ function applyRpcFix(root) {
   } else if (pkgRaw !== null) {
     skipped.push("package.json (unparseable)");
   }
-  const tsPath = path6.join(root, "tsconfig.json");
+  const tsPath = path7.join(root, "tsconfig.json");
   const tsRaw = readFile(tsPath);
   const tsconfig = tsRaw !== null ? readJsonObject(tsPath) : null;
   if (tsconfig !== null) {
@@ -5436,7 +5768,7 @@ function applyRpcFix(root) {
   } else if (tsRaw !== null) {
     skipped.push('tsconfig.json (JSON with comments, add "shared" + paths by hand)');
   }
-  const giPath = path6.join(root, ".gitignore");
+  const giPath = path7.join(root, ".gitignore");
   const giRaw = readFile(giPath);
   if (giRaw === null) {
     writeFile(giPath, `${RPC_GITIGNORE_LINE}
@@ -5448,21 +5780,21 @@ function applyRpcFix(root) {
 `);
     changed.push(".gitignore");
   }
-  const serverToilconfig = readJsonObject(path6.join(root, "toilconfig.json"));
+  const serverToilconfig = readJsonObject(path7.join(root, "toilconfig.json"));
   if (serverToilconfig !== null) {
     const entries = Array.isArray(serverToilconfig.entries) ? serverToilconfig.entries.filter(
       (e) => typeof e === "string"
     ) : [];
     const dirs = /* @__PURE__ */ new Set();
-    for (const e of entries) dirs.add(path6.dirname(path6.resolve(root, e)));
-    if (dirs.size === 0) dirs.add(path6.join(root, "server"));
+    for (const e of entries) dirs.add(path7.dirname(path7.resolve(root, e)));
+    if (dirs.size === 0) dirs.add(path7.join(root, "server"));
     for (const dir of dirs) {
-      const envPath = path6.join(dir, "toil-server-env.d.ts");
+      const envPath = path7.join(dir, "toil-server-env.d.ts");
       if (readFile(envPath) !== TOIL_SERVER_ENV_DTS2) {
         try {
-          fs5.mkdirSync(dir, { recursive: true });
+          fs6.mkdirSync(dir, { recursive: true });
           writeFile(envPath, TOIL_SERVER_ENV_DTS2);
-          changed.push(path6.relative(root, envPath));
+          changed.push(path7.relative(root, envPath));
         } catch {
         }
       }
@@ -5492,7 +5824,7 @@ function prettierPluginPresent(root, pkg) {
     return true;
   }
   for (const name of PRETTIER_CONFIG_FILES) {
-    const raw = readFile(path6.join(root, name));
+    const raw = readFile(path7.join(root, name));
     if (raw !== null && PRETTIER_MENTION.test(raw)) return true;
   }
   return false;
@@ -5501,7 +5833,7 @@ function applyPrettierFix(root, pkg) {
   const changed = [];
   const skipped = [];
   if (prettierPluginPresent(root, pkg)) return { changed, skipped };
-  const pkgPath = path6.join(root, "package.json");
+  const pkgPath = path7.join(root, "package.json");
   const pkgConfig = pkg ? asRecord(pkg.prettier) : null;
   if (pkgConfig !== null) {
     const full = readJsonObject(pkgPath);
@@ -5517,7 +5849,7 @@ function applyPrettierFix(root, pkg) {
     }
   }
   for (const name of [".prettierrc", ".prettierrc.json"]) {
-    const filePath = path6.join(root, name);
+    const filePath = path7.join(root, name);
     const raw = readFile(filePath);
     if (raw === null) continue;
     const obj = readJsonObject(filePath);
@@ -5533,13 +5865,13 @@ function applyPrettierFix(root, pkg) {
     changed.push(name);
     return { changed, skipped };
   }
-  const jsConfig = PRETTIER_CONFIG_FILES.find((name) => readFile(path6.join(root, name)) !== null);
+  const jsConfig = PRETTIER_CONFIG_FILES.find((name) => readFile(path7.join(root, name)) !== null);
   if (jsConfig) {
     skipped.push(`${jsConfig} (add "${PRETTIER_PLUGIN}" to its plugins by hand)`);
     return { changed, skipped };
   }
   writeFile(
-    path6.join(root, ".prettierrc.json"),
+    path7.join(root, ".prettierrc.json"),
     JSON.stringify({ plugins: [PRETTIER_PLUGIN] }, null, 4) + "\n"
   );
   changed.push(".prettierrc.json");
@@ -5553,7 +5885,7 @@ function applyServerEditorFix(root, toilconfig) {
     const parsed = readJsonObject(tsPath);
     if (parsed === null)
       skipped.push(
-        `${path6.relative(root, tsPath)} (remove legacy ts-plugin from JSONC manually)`
+        `${path7.relative(root, tsPath)} (remove legacy ts-plugin from JSONC manually)`
       );
     else if (tsconfigHasToilPlugin(parsed)) {
       const co = asRecord(parsed.compilerOptions);
@@ -5565,12 +5897,12 @@ function applyServerEditorFix(root, toilconfig) {
         if (plugins.length === 0) delete co.plugins;
         else co.plugins = plugins;
         writeFile(tsPath, JSON.stringify(parsed, null, 4) + "\n");
-        changed.push(path6.relative(root, tsPath));
+        changed.push(path7.relative(root, tsPath));
       }
     }
   }
-  const vsPath = path6.join(root, ".vscode/settings.json");
-  const vs = fs5.existsSync(vsPath) ? readJsonObject(vsPath) : {};
+  const vsPath = path7.join(root, ".vscode/settings.json");
+  const vs = fs6.existsSync(vsPath) ? readJsonObject(vsPath) : {};
   if (vs === null)
     skipped.push(".vscode/settings.json (enable js/ts.experimental.useTsgo manually)");
   else {
@@ -5579,7 +5911,7 @@ function applyServerEditorFix(root, toilconfig) {
     delete vs["typescript.enablePromptUseWorkspaceTsdk"];
     vs["js/ts.experimental.useTsgo"] = true;
     if (JSON.stringify(vs) !== before) {
-      fs5.mkdirSync(path6.dirname(vsPath), { recursive: true });
+      fs6.mkdirSync(path7.dirname(vsPath), { recursive: true });
       writeFile(vsPath, JSON.stringify(vs, null, 4) + "\n");
       changed.push(".vscode/settings.json");
     }
@@ -5595,8 +5927,8 @@ async function checkNativeTypeScriptConfig(root) {
       status: "fail",
       detail: "Install TypeScript 7 before validating compiler configuration."
     };
-  const configPath = path6.join(root, "tsconfig.json");
-  if (!fs5.existsSync(configPath))
+  const configPath = path7.join(root, "tsconfig.json");
+  if (!fs6.existsSync(configPath))
     return {
       ...check,
       status: "fail",
@@ -5604,7 +5936,7 @@ async function checkNativeTypeScriptConfig(root) {
       fix: "Create a tsconfig.json extending toiljs/tsconfig."
     };
   try {
-    const apiPath = createRequire(path6.join(root, "package.json")).resolve(
+    const apiPath = createRequire2(path7.join(root, "package.json")).resolve(
       "typescript/unstable/sync"
     );
     const native = await import(pathToFileURL(apiPath).href);
@@ -5637,9 +5969,9 @@ async function checkNativeTypeScriptConfig(root) {
   }
 }
 function checkLintMigration(root) {
-  const pkg = readJsonObject(path6.join(root, "package.json"));
+  const pkg = readJsonObject(path7.join(root, "package.json"));
   const script = asRecord(pkg?.scripts)?.lint;
-  const config = readFile(path6.join(root, "oxlint.config.ts")) ?? readFile(path6.join(root, ".oxlintrc.json")) ?? "";
+  const config = readFile(path7.join(root, "oxlint.config.ts")) ?? readFile(path7.join(root, ".oxlintrc.json")) ?? "";
   const configured = config.includes("toiljs/oxlint") || /["']?typeAware["']?\s*:\s*true/.test(config);
   const scriptOk = typeof script === "string" && /\boxlint\b/.test(script) && !/\beslint\b/.test(script) && (script.includes("--type-aware") || configured);
   const installed = installedVersion(root, "oxlint") !== null && installedVersion(root, "oxlint-tsgolint") !== null;
@@ -5652,8 +5984,8 @@ function checkLintMigration(root) {
   };
 }
 function frameworkMeta() {
-  const pkgPath = path6.resolve(
-    path6.dirname(fileURLToPath3(import.meta.url)),
+  const pkgPath = path7.resolve(
+    path7.dirname(fileURLToPath3(import.meta.url)),
     "..",
     "..",
     "package.json"
@@ -5663,10 +5995,10 @@ function frameworkMeta() {
   const peers = pkg ? stringRecord(pkg.peerDependencies) : {};
   return { node: engines.node ?? ">=24.0.0", peers };
 }
-var LOCKFILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock", "bun.lockb"];
+var LOCKFILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock", "bun.lock", "bun.lockb"];
 function readEntry(clientAbsDir) {
   for (const name of ["toil.tsx", "toil.jsx", "main.tsx", "main.jsx"]) {
-    const source = readFile(path6.join(clientAbsDir, name));
+    const source = readFile(path7.join(clientAbsDir, name));
     if (source !== null && /toiljs\/routes|\bmount\s*\(/.test(source)) return source;
   }
   return null;
@@ -5677,18 +6009,18 @@ function collectSources(root, dir, cap) {
     if (out2.length >= cap) return;
     let entries;
     try {
-      entries = fs5.readdirSync(current, { withFileTypes: true });
+      entries = fs6.readdirSync(current, { withFileTypes: true });
     } catch {
       return;
     }
     for (const entry of entries) {
       if (out2.length >= cap) break;
-      const full = path6.join(current, entry.name);
+      const full = path7.join(current, entry.name);
       if (entry.isDirectory()) {
         if (entry.name !== "node_modules") visit(full);
       } else if (/\.(tsx|jsx)$/.test(entry.name)) {
         const source = readFile(full);
-        if (source !== null) out2.push({ path: path6.relative(root, full), source });
+        if (source !== null) out2.push({ path: path7.relative(root, full), source });
       }
     }
   };
@@ -5724,9 +6056,9 @@ function renderHuman(groups) {
   process.stdout.write(out2.join("\n") + "\n");
 }
 async function runDoctor(opts2) {
-  const root = path6.resolve(opts2.root ?? opts2.cwd);
+  const root = path7.resolve(opts2.root ?? opts2.cwd);
   const meta = frameworkMeta();
-  const projectPkg = readJsonObject(path6.join(root, "package.json"));
+  const projectPkg = readJsonObject(path7.join(root, "package.json"));
   const deps = {
     ...projectPkg ? stringRecord(projectPkg.dependencies) : {},
     ...projectPkg ? stringRecord(projectPkg.devDependencies) : {}
@@ -5738,11 +6070,11 @@ async function runDoctor(opts2) {
   } catch (err) {
     configError = err instanceof Error ? err.message : String(err);
   }
-  const clientAbsDir = cfg ? cfg.clientAbsDir : path6.join(root, "client");
-  const routesAbsDir = cfg ? cfg.routesAbsDir : path6.join(clientAbsDir, "routes");
-  const publicDir = cfg ? cfg.publicDir : path6.join(clientAbsDir, "public");
+  const clientAbsDir = cfg ? cfg.clientAbsDir : path7.join(root, "client");
+  const routesAbsDir = cfg ? cfg.routesAbsDir : path7.join(clientAbsDir, "routes");
+  const publicDir = cfg ? cfg.publicDir : path7.join(clientAbsDir, "public");
   const entrySource = readEntry(clientAbsDir);
-  const indexHtml = readFile(path6.join(publicDir, "index.html"));
+  const indexHtml = readFile(path7.join(publicDir, "index.html"));
   const routes = scanRoutes(routesAbsDir);
   const mainPatterns = routes.filter((r2) => r2.slot === void 0).map((r2) => r2.pattern);
   const assetIssues = findRelativeAssets(collectSources(root, clientAbsDir, 200));
@@ -5755,14 +6087,14 @@ async function runDoctor(opts2) {
   }
   const ppPkg = preprocessorImported ? PREPROCESSOR_PKG[preprocessorImported] : null;
   const preprocessorInstalled = ppPkg === null || ppPkg in deps;
-  const toilconfig = readJsonObject(path6.join(root, "toilconfig.json"));
+  const toilconfig = readJsonObject(path7.join(root, "toilconfig.json"));
   const serverPresent = toilconfig !== null;
   let missingEntries = [];
   let toilscriptInstalled = false;
   let wasmExists = false;
   if (toilconfig) {
     const entries = Array.isArray(toilconfig.entries) ? toilconfig.entries.filter((e) => typeof e === "string") : [];
-    missingEntries = entries.filter((e) => !fs5.existsSync(path6.join(root, e)));
+    missingEntries = entries.filter((e) => !fs6.existsSync(path7.join(root, e)));
     toilscriptInstalled = isPackageInstalled(root, "toilscript");
     const targets = typeof toilconfig.targets === "object" && toilconfig.targets !== null ? toilconfig.targets : {};
     const outFiles = [];
@@ -5772,20 +6104,20 @@ async function runDoctor(opts2) {
         if (typeof outFile === "string") outFiles.push(outFile);
       }
     }
-    wasmExists = outFiles.some((f) => fs5.existsSync(path6.join(root, f)));
+    wasmExists = outFiles.some((f) => fs6.existsSync(path7.join(root, f)));
     if (!wasmExists && outFiles.length === 0) {
       try {
-        wasmExists = fs5.readdirSync(path6.join(root, "build", "server")).some((f) => f.endsWith(".wasm"));
+        wasmExists = fs6.readdirSync(path7.join(root, "build", "server")).some((f) => f.endsWith(".wasm"));
       } catch {
         wasmExists = false;
       }
     }
   }
   const peerName = (n3) => checkPeer(n3, deps[n3] ?? null, meta.peers[n3] ?? "*");
-  const peerChecks = Object.keys(meta.peers).filter((n3) => n3 !== "typescript").map(peerName);
+  const peerChecks = Object.keys(meta.peers).filter((n3) => n3 !== "typescript" && !Object.hasOwn(TEST_DEPENDENCIES, n3)).map(peerName);
   const typeScriptFix = opts2.fix ? applyTypeScriptFix(root) : null;
   const declaredTypeScript = (() => {
-    const pkg = readJsonObject(path6.join(root, "package.json"));
+    const pkg = readJsonObject(path7.join(root, "package.json"));
     if (pkg === null) return deps.typescript ?? null;
     const ranges = [
       "dependencies",
@@ -5807,12 +6139,39 @@ async function runDoctor(opts2) {
   const authFacts = gatherAuthFacts(root, toilconfig);
   const prettierPresent = prettierPluginPresent(
     root,
-    readJsonObject(path6.join(root, "package.json"))
+    readJsonObject(path7.join(root, "package.json"))
   );
   const serverTsPath = serverPresent ? serverTsconfigPath(root, toilconfig) : null;
   const serverTsParsed = serverTsPath ? readJsonObject(serverTsPath) : null;
   const serverTsPluginPresent = serverTsPath === null || serverTsParsed === null ? false : tsconfigHasToilPlugin(serverTsParsed);
-  const applied = [typeScriptFix, rpcFix, prettierFix, editorFix].filter(
+  let testingFix = null;
+  let testingChecks;
+  try {
+    if (opts2.fix && projectPkg !== null) testingFix = await ensureTesting(root, true);
+    const testingPkg = readJsonObject(path7.join(root, "package.json"));
+    testingChecks = checkTesting({
+      dependencies: {
+        ...stringRecord(testingPkg?.dependencies),
+        ...stringRecord(testingPkg?.devDependencies)
+      },
+      scripts: stringRecord(testingPkg?.scripts),
+      installed: Object.fromEntries(
+        Object.keys(TEST_DEPENDENCIES).map((name) => [name, installedVersion(root, name)])
+      ),
+      configuration: await findTestConfiguration(root)
+    });
+  } catch (error) {
+    testingChecks = [
+      {
+        id: "testing:setup",
+        label: "Testing setup",
+        status: "fail",
+        detail: error instanceof Error ? error.message : String(error),
+        fix: "Repair package.json or unreadable test configuration, then run `toiljs doctor --fix`."
+      }
+    ];
+  }
+  const applied = [typeScriptFix, rpcFix, prettierFix, editorFix, testingFix].filter(
     (fix) => fix !== null
   );
   const serverFix = applied.length > 0 ? {
@@ -5829,7 +6188,7 @@ async function runDoctor(opts2) {
         typeScriptCheck,
         checkLintMigration(root),
         await checkNativeTypeScriptConfig(root),
-        checkPackageManager(LOCKFILES.filter((f) => fs5.existsSync(path6.join(root, f))))
+        checkPackageManager(LOCKFILES.filter((f) => fs6.existsSync(path7.join(root, f))))
       ]
     },
     {
@@ -5838,13 +6197,13 @@ async function runDoctor(opts2) {
         checkDir(
           "client-dir",
           "client/ directory",
-          fs5.existsSync(clientAbsDir),
+          fs6.existsSync(clientAbsDir),
           "Create a client/ directory for your app."
         ),
         checkDir(
           "routes-dir",
           "routes/ directory",
-          fs5.existsSync(routesAbsDir),
+          fs6.existsSync(routesAbsDir),
           "Create client/routes/ and add an index.tsx."
         ),
         checkRootElement(indexHtml),
@@ -5855,6 +6214,10 @@ async function runDoctor(opts2) {
         checkDevScripts(projectPkg ? stringRecord(projectPkg.scripts) : {})
       ]
     },
+    {
+      title: "Testing",
+      checks: testingChecks
+    },
     {
       title: "Config + assets",
       checks: [
@@ -5915,8 +6278,8 @@ function renderFix(result) {
 
 // src/cli/generate.ts
 import { randomBytes as randomBytes3, timingSafeEqual } from "node:crypto";
-import fs6 from "node:fs";
-import path7 from "node:path";
+import fs7 from "node:fs";
+import path8 from "node:path";
 import { parseEnv } from "node:util";
 
 // node_modules/@noble/hashes/_u64.js
@@ -6829,10 +7192,10 @@ var ml_kem768 = /* @__PURE__ */ (() => mk(PARAMS[768]))();
 var PRIVATE_KEYS = ["AUTH_SESSION_SECRET", "AUTH_OPRF_SEED", "AUTH_KEM_SK"];
 var PUBLIC_KEY = "VITE_AUTH_KEM_PUBLIC_KEY";
 function read(file) {
-  const stat = fs6.lstatSync(file, { throwIfNoEntry: false });
+  const stat = fs7.lstatSync(file, { throwIfNoEntry: false });
   if (!stat) return "";
   if (!stat.isFile()) throw new Error(`Expected a regular file: ${file}`);
-  return fs6.readFileSync(file, "utf8");
+  return fs7.readFileSync(file, "utf8");
 }
 function append(text2, lines) {
   if (!lines.length) return text2;
@@ -6855,10 +7218,10 @@ function publicKeyFor(secret) {
 }
 function runGenerate(target, opts2 = {}) {
   if (target !== "auth") throw new Error("Usage: toiljs generate auth [--root <dir>]");
-  const root = path7.resolve(opts2.root ?? process.cwd());
-  const envFile = path7.join(root, ".env");
-  const secretsFile = path7.join(root, ".env.secrets");
-  const ignoreFile = path7.join(root, ".gitignore");
+  const root = path8.resolve(opts2.root ?? process.cwd());
+  const envFile = path8.join(root, ".env");
+  const secretsFile = path8.join(root, ".env.secrets");
+  const ignoreFile = path8.join(root, ".gitignore");
   const envText = read(envFile);
   const secretsText = read(secretsFile);
   const ignoreText = read(ignoreFile);
@@ -6896,12 +7259,12 @@ function runGenerate(target, opts2 = {}) {
   const publicAdditions = Object.hasOwn(env, PUBLIC_KEY) ? [] : [`${PUBLIC_KEY}=${publicKey}`];
   const ignoreLines = new Set(ignoreText.split(/\r?\n/));
   const ignoreAdditions = ["/.env", "/.env.secrets"].filter((line) => !ignoreLines.has(line));
-  if (ignoreAdditions.length) fs6.writeFileSync(ignoreFile, append(ignoreText, ignoreAdditions));
-  if (fs6.existsSync(secretsFile)) fs6.chmodSync(secretsFile, 384);
+  if (ignoreAdditions.length) fs7.writeFileSync(ignoreFile, append(ignoreText, ignoreAdditions));
+  if (fs7.existsSync(secretsFile)) fs7.chmodSync(secretsFile, 384);
   if (additions.length)
-    fs6.writeFileSync(secretsFile, append(secretsText, additions), { mode: 384 });
+    fs7.writeFileSync(secretsFile, append(secretsText, additions), { mode: 384 });
   if (publicAdditions.length)
-    fs6.writeFileSync(envFile, append(envText, publicAdditions), { mode: 384 });
+    fs7.writeFileSync(envFile, append(envText, publicAdditions), { mode: 384 });
   process.stdout.write(
     [
       `Authentication keys ready in ${root}. Existing credentials were preserved.`,
@@ -6918,14 +7281,14 @@ function runGenerate(target, opts2 = {}) {
 }
 
 // src/cli/notify.ts
-import fs8 from "node:fs";
+import fs9 from "node:fs";
 import os from "node:os";
-import path9 from "node:path";
+import path10 from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 
 // src/cli/update.ts
-import fs7 from "node:fs";
-import path8 from "node:path";
+import fs8 from "node:fs";
+import path9 from "node:path";
 
 // src/cli/updates.ts
 function parseVersion2(v) {
@@ -6968,13 +7331,14 @@ function buildRows(upgraded, currentDeps) {
 
 // src/cli/update.ts
 function detectPackageManager2(root) {
-  if (fs7.existsSync(path8.join(root, "pnpm-lock.yaml"))) return { name: "pnpm", ncuName: "pnpm" };
-  if (fs7.existsSync(path8.join(root, "yarn.lock"))) return { name: "yarn", ncuName: "yarn" };
-  if (fs7.existsSync(path8.join(root, "bun.lockb"))) return { name: "bun", ncuName: "bun" };
+  if (fs8.existsSync(path9.join(root, "pnpm-lock.yaml"))) return { name: "pnpm", ncuName: "pnpm" };
+  if (fs8.existsSync(path9.join(root, "yarn.lock"))) return { name: "yarn", ncuName: "yarn" };
+  if (fs8.existsSync(path9.join(root, "bun.lock")) || fs8.existsSync(path9.join(root, "bun.lockb")))
+    return { name: "bun", ncuName: "bun" };
   return { name: "npm", ncuName: "npm" };
 }
 function readDependencies(pkgPath) {
-  const parsed = JSON.parse(fs7.readFileSync(pkgPath, "utf8"));
+  const parsed = JSON.parse(fs8.readFileSync(pkgPath, "utf8"));
   if (typeof parsed !== "object" || parsed === null) return {};
   const pkg = parsed;
   const merge = (v) => {
@@ -7002,26 +7366,26 @@ function serverDirs(root) {
   const dirs = /* @__PURE__ */ new Set();
   try {
     const parsed = JSON.parse(
-      fs7.readFileSync(path8.join(root, "toilconfig.json"), "utf8")
+      fs8.readFileSync(path9.join(root, "toilconfig.json"), "utf8")
     );
     const entries = typeof parsed === "object" && parsed !== null && Array.isArray(parsed.entries) ? parsed.entries.filter(
       (e) => typeof e === "string"
     ) : [];
-    for (const e of entries) dirs.add(path8.dirname(path8.resolve(root, e)));
+    for (const e of entries) dirs.add(path9.dirname(path9.resolve(root, e)));
   } catch {
   }
-  if (dirs.size === 0) dirs.add(path8.join(root, "server"));
+  if (dirs.size === 0) dirs.add(path9.join(root, "server"));
   return [...dirs];
 }
 function ensureMigrationsDirs(root) {
   const created = [];
   for (const dir of serverDirs(root)) {
-    if (!fs7.existsSync(dir)) continue;
-    const migrations = path8.join(dir, "migrations");
-    if (fs7.existsSync(migrations)) continue;
-    fs7.mkdirSync(migrations, { recursive: true });
-    fs7.writeFileSync(path8.join(migrations, "README.md"), MIGRATIONS_README);
-    created.push(path8.relative(root, migrations) || "migrations");
+    if (!fs8.existsSync(dir)) continue;
+    const migrations = path9.join(dir, "migrations");
+    if (fs8.existsSync(migrations)) continue;
+    fs8.mkdirSync(migrations, { recursive: true });
+    fs8.writeFileSync(path9.join(migrations, "README.md"), MIGRATIONS_README);
+    created.push(path9.relative(root, migrations) || "migrations");
   }
   return created;
 }
@@ -7037,16 +7401,16 @@ function rowLine(row) {
 function noteWithheld(names) {
   note(
     names.map((n3) => `${dim("-")} ${n3}`).join("\n") + "\n\n" + dim(
-      "Held back: toiljs supports TypeScript 7 only. Compiler updates must stay within 7.x."
+      "Held back: compiler updates must stay within TypeScript 7; native testing updates must stay within the supported Vitest and WebdriverIO versions."
     ),
     warn("Not upgraded")
   );
 }
 var TARGETS = /* @__PURE__ */ new Set(["latest", "minor", "patch", "newest", "greatest"]);
 async function runUpdate(opts2) {
-  const root = path8.resolve(opts2.root ?? opts2.cwd);
-  const pkgPath = path8.join(root, "package.json");
-  if (!fs7.existsSync(pkgPath)) {
+  const root = path9.resolve(opts2.root ?? opts2.cwd);
+  const pkgPath = path9.join(root, "package.json");
+  if (!fs8.existsSync(pkgPath)) {
     throw new Error("No package.json here. Run from your project root or pass --root <dir>.");
   }
   const currentDeps = readDependencies(pkgPath);
@@ -7079,7 +7443,13 @@ async function runUpdate(opts2) {
     return;
   }
   const upgraded = parseNcuJson(res.stdout);
-  const withheld = withheldUpgrades(upgraded);
+  const testConfig = await findTestConfiguration(root);
+  const withheld = [
+    ...withheldUpgrades(upgraded),
+    ...Object.keys(upgraded).filter(
+      (name) => testConfig.native && !isSupportedTestingRange(name, upgraded[name])
+    )
+  ];
   for (const name of withheld) delete upgraded[name];
   if (!isSupportedTypeScriptRange(currentDeps.typescript ?? "") && !upgraded.typescript) {
     const versions = await capture("npm", ["view", "typescript@7", "version", "--json"], root);
@@ -7096,7 +7466,20 @@ async function runUpdate(opts2) {
   if (rows.length === 0) {
     s.stop("Everything is up to date");
     if (withheld.length > 0) noteWithheld(withheld);
-    outro(success("Nothing to update."));
+    if (opts2.yes) {
+      const testing2 = await ensureTesting(root, true);
+      if (testing2.changed.length) note(testing2.changed.join("\n"), "Testing setup");
+      if (testing2.skipped.length) note(testing2.skipped.join("\n"), "Manual changes");
+      if (testing2.install && !await installUpdates(pm.name, root)) return;
+      outro(
+        success(testing2.changed.length ? "Testing setup updated." : "Nothing to update.")
+      );
+    } else
+      outro(
+        success(
+          "Nothing to update. Use `toiljs doctor --fix` or `toiljs update --yes` to add missing testing setup."
+        )
+      );
     return;
   }
   s.stop(`${String(rows.length)} update${rows.length === 1 ? "" : "s"} available`);
@@ -7131,7 +7514,17 @@ async function runUpdate(opts2) {
     outro(dim("No packages selected."));
     return;
   }
-  const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf8"));
+  if (testConfig.native) {
+    const paired = selected.find(
+      (name) => name === "vitest" || name === "@vitest/coverage-v8"
+    );
+    if (paired) {
+      const counterpart = paired === "vitest" ? "@vitest/coverage-v8" : "vitest";
+      upgraded[counterpart] = upgraded[paired];
+      if (!selected.includes(counterpart)) selected.push(counterpart);
+    }
+  }
+  const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf8"));
   const targetTypeScript = selected.includes("typescript") ? upgraded.typescript : currentDeps.typescript;
   if (!targetTypeScript || !isSupportedTypeScriptRange(targetTypeScript)) {
     throw new Error("Select the TypeScript 7 migration before installing updates.");
@@ -7157,23 +7550,30 @@ async function runUpdate(opts2) {
       pkg.devDependencies = deps;
     }
   }
-  fs7.writeFileSync(pkgPath, JSON.stringify(pkg, null, 4) + "\n");
+  fs8.writeFileSync(pkgPath, JSON.stringify(pkg, null, 4) + "\n");
   s.stop("package.json updated");
-  note(dim(`Running ${pm.name} install\u2026`), "Install");
+  const testing = await ensureTesting(root, true);
+  if (testing.changed.length) note(testing.changed.join("\n"), "Testing setup");
+  if (testing.skipped.length) note(testing.skipped.join("\n"), "Manual changes");
+  if (!await installUpdates(pm.name, root)) return;
+  outro(
+    success(`Updated ${String(selected.length)} package${selected.length === 1 ? "" : "s"}.`)
+  );
+}
+async function installUpdates(pm, root) {
+  note(dim(`Running ${pm} install\u2026`), "Install");
   try {
-    await run(pm.name, ["install"], root, { stdio: "inherit" });
+    await run(pm, ["install"], root, { stdio: "inherit" });
   } catch {
     outro(
       danger(
-        `${pm.name} install failed \u2014 package.json was updated to the new versions, but the install did not finish. Fix the error printed above, then run \`${pm.name} install\`.`
+        `${pm} install failed \u2014 package.json was updated to the new versions, but the install did not finish. Fix the error printed above, then run \`${pm} install\`.`
       )
     );
     process.exitCode = 1;
-    return;
+    return false;
   }
-  outro(
-    success(`Updated ${String(selected.length)} package${selected.length === 1 ? "" : "s"}.`)
-  );
+  return true;
 }
 
 // src/cli/version-check.ts
@@ -7248,8 +7648,8 @@ function findOutdated(latest, projectVersion, cliVersion, cliIsLocal, pm) {
 var REGISTRY_URL = "https://registry.npmjs.org/toiljs/latest";
 var FETCH_TIMEOUT_MS = 2e3;
 function cacheFile() {
-  const base = process.env.XDG_CACHE_HOME ?? path9.join(os.homedir(), ".cache");
-  return path9.join(base, "toiljs", "update-check.json");
+  const base = process.env.XDG_CACHE_HOME ?? path10.join(os.homedir(), ".cache");
+  return path10.join(base, "toiljs", "update-check.json");
 }
 async function fetchLatest() {
   const ctrl = new AbortController();
@@ -7275,22 +7675,22 @@ async function fetchLatest() {
 async function resolveLatest() {
   const file = cacheFile();
   try {
-    const cached = parseCheckCache(fs8.readFileSync(file, "utf8"));
+    const cached = parseCheckCache(fs9.readFileSync(file, "utf8"));
     if (cached && isCacheFresh(cached, Date.now())) return cached.latest;
   } catch {
   }
   const latest = await fetchLatest();
   try {
-    fs8.mkdirSync(path9.dirname(file), { recursive: true });
-    fs8.writeFileSync(file, JSON.stringify({ latest, checkedAt: Date.now() }));
+    fs9.mkdirSync(path10.dirname(file), { recursive: true });
+    fs9.writeFileSync(file, JSON.stringify({ latest, checkedAt: Date.now() }));
   } catch {
   }
   return latest;
 }
 function projectToiljsVersion(root) {
   try {
-    const raw = fs8.readFileSync(
-      path9.join(root, "node_modules", "toiljs", "package.json"),
+    const raw = fs9.readFileSync(
+      path10.join(root, "node_modules", "toiljs", "package.json"),
       "utf8"
     );
     const parsed = JSON.parse(raw);
@@ -7315,9 +7715,9 @@ async function notifyIfOutdated(rootArg) {
     if (env.TOILJS_NO_UPDATE_CHECK || env.NO_UPDATE_NOTIFIER || env.CI) return;
     const latest = await resolveLatest();
     if (!latest) return;
-    const root = path9.resolve(rootArg ?? process.cwd());
-    const cliDir = path9.dirname(fileURLToPath4(import.meta.url));
-    const cliIsLocal = cliDir.startsWith(path9.join(root, "node_modules") + path9.sep);
+    const root = path10.resolve(rootArg ?? process.cwd());
+    const cliDir = path10.dirname(fileURLToPath4(import.meta.url));
+    const cliIsLocal = cliDir.startsWith(path10.join(root, "node_modules") + path10.sep);
     const rows = findOutdated(
       latest,
       projectToiljsVersion(root),
@@ -7331,6 +7731,62 @@ async function notifyIfOutdated(rootArg) {
   }
 }
 
+// src/cli/test.ts
+import path11 from "node:path";
+import { createRequire as createRequire3 } from "node:module";
+import { spawn as spawn2 } from "node:child_process";
+function parseTestArgs(args) {
+  let root;
+  let browser = false;
+  let all = false;
+  let watch = false;
+  const forwarded = [];
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index];
+    if (arg === "--root") {
+      const value = args[++index];
+      if (!value) throw new Error("toiljs test: --root requires a directory.");
+      root = value;
+    } else if (arg === "--browser") browser = true;
+    else if (arg === "--all") all = true;
+    else if (arg === "--watch" || arg === "-w") watch = true;
+    else if (arg !== "--") forwarded.push(arg);
+  }
+  if (browser && all) throw new Error("toiljs test: use either --browser or --all.");
+  return { root, browser, all, watch, arguments: forwarded };
+}
+async function runTest(options) {
+  const root = path11.resolve(options.root ?? process.cwd());
+  const setup = await ensureTesting(root);
+  if (setup.install) {
+    const pm = detectPackageManager2(root).name;
+    process.stdout.write(
+      `toiljs test: installing Vitest, browser testing, and V8 coverage with ${pm}.
+`
+    );
+    await run(pm, ["install"], root, { stdio: "inherit" });
+  }
+  const require2 = createRequire3(path11.join(root, "package.json"));
+  const cli = path11.join(
+    path11.dirname(require2.resolve("vitest/package.json")),
+    "vitest.mjs"
+  );
+  const args = [cli, ...options.watch ? [] : ["run"]];
+  const projectFlag = options.arguments.some(
+    (arg) => arg === "--project" || arg.startsWith("--project=")
+  );
+  if (setup.native && !options.all && !projectFlag)
+    args.push("--project", options.browser ? "browser" : "unit");
+  if (!setup.native && options.browser) args.push("--browser");
+  args.push(...options.arguments);
+  const code = await new Promise((resolve, reject) => {
+    const child = spawn2(process.execPath, args, { cwd: root, stdio: "inherit" });
+    child.once("error", reject);
+    child.once("exit", (status) => resolve(status ?? 1));
+  });
+  process.exitCode = code;
+}
+
 // src/cli/index.ts
 var __origEmitWarning = process.emitWarning.bind(process);
 process.emitWarning = ((warning, ...rest) => {
@@ -7437,6 +7893,7 @@ function printHelp() {
       cmd("create [name]", "scaffold a new toiljs app"),
       cmd("configure", "toggle styling features (Sass/Less/Stylus, Tailwind)"),
       cmd("generate auth", "generate private auth keys and the matching client public key"),
+      cmd("test", "run Vitest (auto-installs missing test tooling)"),
       cmd("dev", "start the dev server with HMR"),
       cmd("build", "build the optimized production bundle"),
       cmd("start", "self-host the built app (hyper-express / uWS)"),
@@ -7447,7 +7904,10 @@ function printHelp() {
       bold("Options"),
       cmd("--root <dir>", "project root (default: current directory)"),
       cmd("--port <n>", "dev/start: listen port (or PORT env / client.port; default 3000)"),
-      cmd("--host <h>", "dev/start: bind host, e.g. 0.0.0.0 (or HOST env / client.host; default 127.0.0.1)"),
+      cmd(
+        "--host <h>",
+        "dev/start: bind host, e.g. 0.0.0.0 (or HOST env / client.host; default 127.0.0.1)"
+      ),
       cmd("--threads <n>", "start: production HTTP worker count"),
       cmd("-t, --template", "create: app | minimal | agent"),
       cmd("--style <name>", "create/configure: css | sass | less | stylus"),
@@ -7455,9 +7915,13 @@ function printHelp() {
       cmd("--no-ai", "create: skip AI assistant files (CLAUDE.md, etc.)"),
       cmd("-y, --yes", "create: accept defaults (non-interactive)"),
       cmd("--no-install", "create: don't install dependencies"),
+      cmd("--browser", "test: run real Chrome browser tests"),
+      cmd("--all", "test: run unit and browser projects"),
+      cmd("--coverage", "test: collect V8 coverage reports"),
+      cmd("--watch", "test: watch for changes"),
       cmd("--server", "build: build only the server (regenerate shared/server.ts + wasm)"),
       cmd("--json", "doctor: machine-readable output"),
-      cmd("--fix", "doctor: auto-fix what it can (typed-RPC wiring)"),
+      cmd("--fix", "doctor: repair testing, compiler, and server wiring"),
       cmd("--target <t>", "update: latest | minor | patch | newest | greatest"),
       cmd("-v, --version", "print the toiljs version"),
       "",
@@ -7476,6 +7940,9 @@ async function main() {
   const flags = parseArgs(rest);
   await notifyIfOutdated(flags.root);
   switch (command) {
+    case "test":
+      await runTest(parseTestArgs(rest));
+      break;
     case "create":
       banner();
       await runCreate({
@@ -7534,7 +8001,9 @@ async function main() {
       const shownHost = wildcard || server.host === "127.0.0.1" ? "localhost" : server.host;
       const exposed = server.host !== "127.0.0.1" && server.host !== "localhost" && server.host !== "::1";
       process.stdout.write(
-        accent("  \u279C ") + bold(`http://${shownHost}:${String(server.port)}`) + dim(`   ws channel: ${server.wsPath}`) + (exposed ? "\n" + dim(`     bound to ${server.host}:${String(server.port)} (exposed beyond loopback)`) : "") + "\n\n"
+        accent("  \u279C ") + bold(`http://${shownHost}:${String(server.port)}`) + dim(`   ws channel: ${server.wsPath}`) + (exposed ? "\n" + dim(
+          `     bound to ${server.host}:${String(server.port)} (exposed beyond loopback)`
+        ) : "") + "\n\n"
       );
       break;
     }