@testspectra/react 1.1.8-rc.18 → 1.1.8-rc.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/react",
-  "version": "1.1.8-rc.18",
+  "version": "1.1.8-rc.20",
   "description": "Bundled Vitest browser-mode runner for React component testing with the TestSpectra Spectra.* DSL",
   "keywords": [
     "testspectra",
@@ -31,7 +31,8 @@
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "vitest.config.ts"
   ],
   "dependencies": {
     "@testing-library/react": "^16.0.0",
@@ -41,7 +42,7 @@
     "cross-spawn": "^7.0.6",
     "playwright": "^1.48.0",
     "vitest": "^2.1.8",
-    "@testspectra/matchers": "1.1.8-rc.18"
+    "@testspectra/matchers": "1.1.8-rc.20"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/vitest.config.ts

@@ -0,0 +1,117 @@
+/**
+ * Bundled Vitest browser-mode configuration for @testspectra/react.
+ *
+ * Consumers never author this file themselves — `spectra test` / `testspectra-react test` loads
+ * it programmatically (see src/cli.ts). `root` is deliberately kept fixed at THIS package's own
+ * directory (not the consumer's project) — `@vitest/browser`'s transitive dependencies
+ * (`@testing-library/dom`, `@testing-library/user-event`) live under this package's own
+ * `node_modules` under pnpm's strict per-package isolation, and Vite's dependency optimizer
+ * fails to resolve them if `root` points elsewhere. Test discovery and auto-import instead use
+ * absolute paths built from `TESTSPECTRA_TEST_ROOT` (see auto_import.ts and cli.ts).
+ */
+
+import { readdirSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import react from '@vitejs/plugin-react';
+import { defineConfig } from 'vitest/config';
+
+const packageDir = fileURLToPath(new URL('.', import.meta.url));
+const setupFile = path.join(packageDir, 'src/setup.ts');
+const testRoot = (process.env.TESTSPECTRA_TEST_ROOT || process.cwd()).replace(/\\/g, '/');
+
+/** Scans <testRoot>/page-objects, /support/steps, /fixtures — mirrors the Rust orchestrator's
+ * AutoImportManifest scan for E2E (docs/v2/cli/ambient-types-generator.md), reimplemented here
+ * in Node (this config file), since there is no Rust orchestrator in this mode. */
+function buildAutoImportManifest(root: string) {
+  function scanEntityDir(subdir: string, filePattern: (platform: string) => string) {
+    const dir = path.join(root, subdir);
+    if (!existsSync(dir)) return [] as Array<{ name: string; path: string }>;
+    const entries: Array<{ name: string; path: string }> = [];
+    for (const name of readdirSync(dir, { withFileTypes: true })) {
+      if (!name.isDirectory()) continue;
+      for (const platform of ['web', 'common']) {
+        for (const ext of ['tsx', 'ts']) {
+          const candidate = path.join(dir, name.name, filePattern(platform).replace(/\.tsx?$/, `.${ext}`));
+          if (existsSync(candidate)) {
+            entries.push({ name: name.name, path: candidate.replace(/\\/g, '/') });
+            break;
+          }
+        }
+        if (entries.at(-1)?.name === name.name) break;
+      }
+    }
+    return entries;
+  }
+
+  function scanFixtures(): Array<{ name: string; path: string }> {
+    const dir = path.join(root, 'fixtures');
+    if (!existsSync(dir)) return [];
+    return readdirSync(dir)
+      .filter((f) => f.endsWith('.json'))
+      .map((f) => ({ name: f.replace(/\.json$/, ''), path: path.join(dir, f).replace(/\\/g, '/') }));
+  }
+
+  return {
+    pageObjects: scanEntityDir('page-objects', (p) => `${p}.tsx`),
+    steps: scanEntityDir('support/steps', (p) => `${p}.step.tsx`),
+    fixtures: scanFixtures(),
+  };
+}
+
+export default defineConfig({
+  root: packageDir,
+  plugins: [react()],
+  define: {
+    __TESTSPECTRA_AUTO_IMPORT_MANIFEST__: JSON.stringify(buildAutoImportManifest(testRoot)),
+    __TESTSPECTRA_STEP_DELAY_MS__: JSON.stringify(Number(process.env.TESTSPECTRA_STEP_DELAY) || 0),
+    __TESTSPECTRA_SEMANTIC_REPORTER__: JSON.stringify(process.env.TESTSPECTRA_SEMANTIC_REPORTER === '1'),
+  },
+  server: {
+    fs: { allow: [packageDir, testRoot] },
+  },
+  test: {
+    globals: true,
+    setupFiles: [setupFile],
+    // When spectra test drives this run, @testspectra/cli's own Reporter (the same semantic,
+    // natural-English reporter E2E uses) owns 100% of the terminal output, fed by the
+    // [TESTSPECTRA_*] lines emitEvent() now prints (see prelude.ts) — Vitest's own console
+    // reporter would just double/clutter that output, so it's silenced here. Standalone
+    // `pnpm test` / `testspectra-react test` (this env var unset) keeps Vitest's normal reporter.
+    reporters: process.env.TESTSPECTRA_SEMANTIC_REPORTER === '1' ? [] : 'default',
+    // When TESTSPECTRA_TEST_ROOT is unset, this is the package's own `pnpm test` run (no consumer
+    // spawning it) — discover its own smoke test instead of a nonexistent specs/ under packageDir.
+    // When set (spawned by cli.ts for a real consumer), only that consumer's specs/ are included —
+    // deliberately NOT this package's own src/__tests__/**, so a consumer's `spectra test` output
+    // never shows this package's internal smoke test mixed in.
+    dir: process.env.TESTSPECTRA_TEST_ROOT ? testRoot : undefined,
+    include: process.env.TESTSPECTRA_TEST_ROOT
+      ? ['specs/**/web.test.tsx', 'specs/**/*.test.tsx']
+      : ['src/**/*.test.tsx'],
+    browser: {
+      enabled: true,
+      provider: 'playwright',
+      name: 'chromium',
+      // Vitest's CLI does NOT reliably override a `browser.headless` value already set here by
+      // `--browser.headless=false` (verified empirically: the spawned Chromium process still
+      // carried `--headless` even with the CLI flag passed) — so headed/headless is threaded
+      // through as an env var (set by cli.ts) that this config file, which we fully control,
+      // reads directly, instead of depending on Vitest's CLI/config-file merge semantics.
+      headless: process.env.TESTSPECTRA_HEADLESS !== 'false',
+      // Vitest 2.x browser mode has no numeric worker-count knob (unlike the E2E Rust orchestrator's
+      // WorkerSizingEngine) — only this parallel/sequential switch. `spectra test --concurrency 1`
+      // maps to sequential; any other value (or omitted) keeps Vitest's own parallel default.
+      fileParallelism: process.env.TESTSPECTRA_FILE_PARALLELISM !== 'false',
+      // Zero browser-discovery logic lives in this package (see cli.ts's RunComponentTestsOptions
+      // comment) — `spectra test` locates the Chrome-for-Testing binary `spectra doctor` already
+      // manages for the E2E CDP driver and passes it in via this env var, so component testing
+      // reuses that install instead of requiring a separate `playwright install` download. Omitted
+      // when run standalone (e.g. this package's own `pnpm test`), where Playwright falls back to
+      // its own bundled/downloaded browser.
+      providerOptions: process.env.TESTSPECTRA_BROWSER_EXECUTABLE
+        ? { launch: { executablePath: process.env.TESTSPECTRA_BROWSER_EXECUTABLE } }
+        : undefined,
+    },
+  },
+});