Ports the Playwright-driven in-browser testrunner harness into the package as a
parameterized Node module + CLI, exposed via the ./headless subpath export.
Playwright is kept external (dev + optional peer dep) and never reaches the
browser bundle.

@@ -0,0 +52,4 @@
+    viteConfigFile?: string;
+    /** Extra arguments passed through to the Vite CLI. */
+    viteArgs?: string[];
+    /** Milliseconds to wait for Vite to print its URL. Defaults to 30000. */

@@ -6,0 +34,4 @@
+
+### Options
+
+| Option                  | Default                                       | Description                                                                 |

@@ -6,0 +39,4 @@
+| `cwd`                   | `process.cwd()`                               | Directory tests and Vite run from.                                          |
+| `testFiles`             | _discovered_                                  | Explicit test files, relative to `cwd`.                                     |
+| `include`               | `src/**/*.test.{ts,tsx}`                      | Glob(s) used to discover test files.                                        |
+| `testrunnerUrl`         | consumer's `node_modules/@srhazi/gooey-test/dist/testrunner/testrunner.html` | Full testrunner URL (without the `#fragment`).            |

@@ -6,0 +48,4 @@
+| `viteStartupTimeoutMs`  | `30000`                                       | How long to wait for Vite to print its URL.                                 |
+| `timeoutMs`             | `60000`                                       | How long to wait for the testrunner to finish.                              |
+| `browser`               | `chromium`                                    | `chromium`, `firefox`, or `webkit`.                                         |
+| `keepOpenOnFailure`     | `false`                                       | On failure, leave the browser + Vite running and print the testrunner URL.   |

@@ -6,3 +91,4 @@
+
 ## Usage
 
 TBD

@@ -6,0 +20,4 @@
+Run it from the command line:
+
+```
+npx gooey-test-headless [options] [test-file ...]

@@ -0,0 +39,4 @@
+    return parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {

@@ -0,0 +131,4 @@
+        // Browser + Vite keep the event loop alive on purpose; do not exit.
+        return;
+    }
+    process.exitCode = result.exitCode;

@@ -0,0 +155,4 @@
+    return source;
+}
+
+function globToRegExp(pattern: string): RegExp {

@@ -0,0 +206,4 @@
+    }
+}
+
+function findTestFiles(

@@ -0,0 +391,4 @@
+/**
+ * Resolve the testrunner URL that Vite should serve for the given project.
+ *
+ * Preference order:

@@ -0,0 +506,4 @@
+        return await import('@playwright/test');
+    } catch (err) {
+        throw new Error(
+            'Unable to load @playwright/test. Install it in your project (npm install --save-dev @playwright/test) and run `npx playwright install chromium`.\n' +

@@ -0,0 +637,4 @@
+
+        const outcome = await Promise.race([
+            page
+                .waitForSelector('.testrunner.testrunner--pass', {

@@ -0,0 +661,4 @@
+        if (outcome === 'pass') {
+            const testCount = summary.testsPassed;
+            const fileCount = summary.filesPassed;
+            log(

@@ -0,0 +729,4 @@
+            log(`Open the test runner at: ${testRunnerUrl}`);
+            if (options.remoteDebuggingPort !== undefined) {
+                log(
+                    `DevTools: devtools://devtools/bundled/inspector.html?ws=localhost:${options.remoteDebuggingPort}/... (http://localhost:${options.remoteDebuggingPort})`