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

package/LICENSE.md

@@ -0,0 +1,48 @@
+# TestSpectra Commercial Software License Agreement
+
+Copyright (c) 2026 TestSpectra. All rights reserved.
+
+IMPORTANT NOTICE: This software is NOT open-source. Although distribution archives,
+npm packages, and editor extensions are publicly downloadable, installation,
+execution, and use of the Software are strictly conditioned upon obtaining a valid
+Commercial License or an authorized Evaluation/Trial License from TestSpectra.
+
+1. GRANT OF LICENSE
+   Subject to payment of applicable license fees or an active authorized evaluation
+   period, TestSpectra grants you a non-exclusive, non-transferable, revocable license
+   to install and execute the Software solely for authoring, debugging, and executing
+   automated software tests.
+
+2. LICENSE ACTIVATION & ENFORCEMENT
+   - Use of the Software requires activation via a valid License Key, authorized CI token,
+     or active TestSpectra Cloud account.
+   - Any attempt to circumvent, disable, modify, reverse engineer, or tamper with the
+     license verification mechanisms, cryptographic signatures, or binary checks is
+     a material breach of this Agreement and automatically terminates your license.
+
+3. RESTRICTIONS
+   You shall not, and shall not permit any third party to:
+   - Decompile, disassemble, reverse engineer, or derive source code from the binaries,
+     compiled scripts, or libraries of the Software.
+   - Sublicense, sell, rent, lease, distribute, or host the Software as a service for third parties.
+   - Re-brand, white-label, or package the Software or any of its components as part of a
+     competing commercial QA, testing, or developer tooling product.
+   - Modify, alter, or remove any proprietary notices, copyright labels, or license headers.
+
+4. INTELLECTUAL PROPERTY
+   The Software, including its source code, architecture, Rust core engine, algorithms,
+   matchers, extensions, interfaces, and documentation, represents valuable intellectual
+   property and trade secrets of TestSpectra.
+
+5. TERMINATION
+   This license is effective until terminated. Your rights under this license will terminate
+   automatically without notice if you fail to comply with any of its terms, or upon expiration
+   of your active subscription or trial term. Upon termination, you must cease all use of
+   the Software and delete all copies in your possession.
+
+6. DISCLAIMER OF WARRANTY & LIMITATION OF LIABILITY
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+   INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+   PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+   FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+   ARISING FROM THE USE OF OR INABILITY TO USE THE SOFTWARE.

package/bin/testspectra-react.js

@@ -1,7 +1,7 @@
-#!/usr/bin/env node
-import { runCli } from '../dist/cli.js';
-
-runCli().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
+#!/usr/bin/env node
+import { runCli } from '../dist/cli.js';
+
+runCli().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/cli.js

@@ -1,8 +1,10 @@
 // src/cli.ts
-import { spawn } from "node:child_process";
+import spawn from "cross-spawn";
+import path from "node:path";
 import { fileURLToPath } from "node:url";
 async function runComponentTests(options = {}) {
-  const cwd = options.cwd ?? process.cwd();
+  const rawCwd = options.cwd ?? process.cwd();
+  const cwd = path.resolve(rawCwd);
   const configPath = fileURLToPath(new URL("../vitest.config.ts", import.meta.url));
   const ext = process.platform === "win32" ? ".cmd" : "";
   const vitestBin = fileURLToPath(new URL(`../node_modules/.bin/vitest${ext}`, import.meta.url));
@@ -11,7 +13,11 @@ async function runComponentTests(options = {}) {
     args.push("--reporter=default", "--reporter=json", `--outputFile.json=${options.outputFile}`);
   }
   if (options.spec) {
-    args.push(options.spec);
+    let specPattern = options.spec.replace(/\\/g, "/");
+    if (path.isAbsolute(options.spec)) {
+      specPattern = path.relative(cwd, options.spec).replace(/\\/g, "/");
+    }
+    args.push(specPattern);
   }
   const semanticReporter = Boolean(options.onLine);
   return new Promise((resolve) => {
@@ -20,14 +26,13 @@ async function runComponentTests(options = {}) {
       cwd,
       env: {
         ...process.env,
-        TESTSPECTRA_TEST_ROOT: cwd,
+        TESTSPECTRA_TEST_ROOT: cwd.replace(/\\/g, "/"),
         TESTSPECTRA_HEADLESS: options.headless === false ? "false" : "true",
         TESTSPECTRA_STEP_DELAY: String(options.stepDelayMs ?? 0),
         TESTSPECTRA_FILE_PARALLELISM: options.concurrency === 1 ? "false" : "true",
         ...options.browserExecutablePath ? { TESTSPECTRA_BROWSER_EXECUTABLE: options.browserExecutablePath } : {},
         TESTSPECTRA_SEMANTIC_REPORTER: semanticReporter ? "1" : "0"
-      },
-      shell: process.platform === "win32"
+      }
     });
     if (semanticReporter) {
       const handleData = (buf) => {
@@ -64,7 +69,29 @@ async function runCli(argv = process.argv.slice(2)) {
     const parsed = parseInt(String(rawDelay), 10);
     if (!isNaN(parsed) && parsed >= 0) stepDelayMs = parsed;
   }
-  const spec = getFlagValue(argv, "--spec", "-s");
+  let spec = getFlagValue(argv, "--spec", "-s");
+  if (!spec) {
+    const flagsWithValues = /* @__PURE__ */ new Set([
+      "--step-delay",
+      "--delay",
+      "--spec",
+      "-s",
+      "--output",
+      "-o",
+      "--concurrency",
+      "-c",
+      "--browser-executable"
+    ]);
+    for (let i = 1; i < argv.length; i++) {
+      const arg = argv[i];
+      if (arg.startsWith("-")) {
+        if (flagsWithValues.has(arg)) i++;
+      } else {
+        spec = arg;
+        break;
+      }
+    }
+  }
   const outputFile = getFlagValue(argv, "--output", "-o");
   const rawConcurrency = getFlagValue(argv, "--concurrency", "-c");
   let concurrency;

package/dist/index.js

@@ -51,6 +51,14 @@ var DomDriverBridge = class {
       "Spectra.navigate() is not supported in component testing mode. Use Spectra.mount(<Component />) to render a component tree instead of navigating a URL."
     );
   }
+  async setCookies(setCookieHeaders, _url) {
+    const headers = Array.isArray(setCookieHeaders) ? setCookieHeaders : [setCookieHeaders];
+    for (const header of headers) {
+      if (typeof document !== "undefined") {
+        document.cookie = header;
+      }
+    }
+  }
   async back() {
     throw new Error("Spectra.back() is not supported in component testing mode.");
   }
@@ -284,7 +292,9 @@ var DomDriverBridge = class {
   }
   async shouldHaveNoConsoleErrors() {
     if (this.consoleErrors.length > 0) {
-      throw new Error(`Expected no console errors, but found ${this.consoleErrors.length}: ${this.consoleErrors.join("; ")}`);
+      throw new Error(
+        `Expected no console errors, but found ${this.consoleErrors.length}: ${this.consoleErrors.join("; ")}`
+      );
     }
   }
   async clearCookies() {
@@ -337,10 +347,12 @@ async function mount(element) {
 }
 
 // src/cli.ts
-import { spawn } from "node:child_process";
+import spawn from "cross-spawn";
+import path from "node:path";
 import { fileURLToPath } from "node:url";
 async function runComponentTests(options = {}) {
-  const cwd = options.cwd ?? process.cwd();
+  const rawCwd = options.cwd ?? process.cwd();
+  const cwd = path.resolve(rawCwd);
   const configPath = fileURLToPath(new URL("../vitest.config.ts", import.meta.url));
   const ext = process.platform === "win32" ? ".cmd" : "";
   const vitestBin = fileURLToPath(new URL(`../node_modules/.bin/vitest${ext}`, import.meta.url));
@@ -349,7 +361,11 @@ async function runComponentTests(options = {}) {
     args.push("--reporter=default", "--reporter=json", `--outputFile.json=${options.outputFile}`);
   }
   if (options.spec) {
-    args.push(options.spec);
+    let specPattern = options.spec.replace(/\\/g, "/");
+    if (path.isAbsolute(options.spec)) {
+      specPattern = path.relative(cwd, options.spec).replace(/\\/g, "/");
+    }
+    args.push(specPattern);
   }
   const semanticReporter = Boolean(options.onLine);
   return new Promise((resolve) => {
@@ -358,14 +374,13 @@ async function runComponentTests(options = {}) {
       cwd,
       env: {
         ...process.env,
-        TESTSPECTRA_TEST_ROOT: cwd,
+        TESTSPECTRA_TEST_ROOT: cwd.replace(/\\/g, "/"),
         TESTSPECTRA_HEADLESS: options.headless === false ? "false" : "true",
         TESTSPECTRA_STEP_DELAY: String(options.stepDelayMs ?? 0),
         TESTSPECTRA_FILE_PARALLELISM: options.concurrency === 1 ? "false" : "true",
         ...options.browserExecutablePath ? { TESTSPECTRA_BROWSER_EXECUTABLE: options.browserExecutablePath } : {},
         TESTSPECTRA_SEMANTIC_REPORTER: semanticReporter ? "1" : "0"
-      },
-      shell: process.platform === "win32"
+      }
     });
     if (semanticReporter) {
       const handleData = (buf) => {
@@ -402,7 +417,29 @@ async function runCli(argv = process.argv.slice(2)) {
     const parsed = parseInt(String(rawDelay), 10);
     if (!isNaN(parsed) && parsed >= 0) stepDelayMs = parsed;
   }
-  const spec = getFlagValue(argv, "--spec", "-s");
+  let spec = getFlagValue(argv, "--spec", "-s");
+  if (!spec) {
+    const flagsWithValues = /* @__PURE__ */ new Set([
+      "--step-delay",
+      "--delay",
+      "--spec",
+      "-s",
+      "--output",
+      "-o",
+      "--concurrency",
+      "-c",
+      "--browser-executable"
+    ]);
+    for (let i = 1; i < argv.length; i++) {
+      const arg = argv[i];
+      if (arg.startsWith("-")) {
+        if (flagsWithValues.has(arg)) i++;
+      } else {
+        spec = arg;
+        break;
+      }
+    }
+  }
   const outputFile = getFlagValue(argv, "--output", "-o");
   const rawConcurrency = getFlagValue(argv, "--concurrency", "-c");
   let concurrency;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/react",
-  "version": "1.1.8-rc.2",
+  "version": "1.1.8-rc.20",
   "description": "Bundled Vitest browser-mode runner for React component testing with the TestSpectra Spectra.* DSL",
   "keywords": [
     "testspectra",
@@ -31,33 +31,35 @@
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "vitest.config.ts"
   ],
-  "scripts": {
-    "build": "node scripts/build.js",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run --config ./vitest.config.ts",
-    "prepublishOnly": "npm run build"
-  },
   "dependencies": {
-    "@testspectra/matchers": "workspace:*",
     "@testing-library/react": "^16.0.0",
     "@testing-library/user-event": "^14.5.2",
     "@vitejs/plugin-react": "^4.3.1",
     "@vitest/browser": "^2.1.8",
+    "cross-spawn": "^7.0.6",
     "playwright": "^1.48.0",
-    "vitest": "catalog:"
+    "vitest": "^2.1.8",
+    "@testspectra/matchers": "1.1.8-rc.20"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
   "devDependencies": {
-    "@types/node": "catalog:",
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^20.14.0",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
-    "esbuild": "catalog:",
-    "typescript": "catalog:"
+    "esbuild": "^0.28.2",
+    "typescript": "^5.6.3"
   },
-  "license": "SEE LICENSE IN LICENSE.md"
-}
+  "license": "SEE LICENSE IN LICENSE.md",
+  "scripts": {
+    "build": "node scripts/build.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config ./vitest.config.ts"
+  }
+}

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,
+    },
+  },
+});