@remix-run/test 0.3.0 → 0.4.1

package/README.md

@@ -1,4 +1,4 @@
-# `test`
+# test
 
 A test framework for JavaScript and TypeScript projects.
 
@@ -50,13 +50,6 @@ remix test "src/**/*.test.ts" "tests/**/*.test.tsx"
 
 Or, you may control via the `glob.test` config field/CLI arg. Each `glob.*` field accepts a single string or an array of patterns, and `--glob.*` flags can be repeated on the CLI.
 
-If you install `@remix-run/test` directly instead of the umbrella `remix` package, the same runner is available as `remix-test`:
-
-```sh
-npm i @remix-run/test
-remix-test
-```
-
 ### Config File
 
 Create a `remix-test.config.ts` (or `.js`) file at the root of your project (shown with default values):
@@ -216,11 +209,11 @@ suite('My Test Suite', () => {
 
 ### Programmatic runner
 
-`@remix-run/test/cli` exports `runRemixTest()` for tools that want to run the test runner without
+`remix/test/cli` exports `runRemixTest()` for tools that want to run the test runner without
 exiting the current process:
 
 ```ts
-import { runRemixTest } from '@remix-run/test/cli'
+import { runRemixTest } from 'remix/test/cli'
 
 let exitCode = await runRemixTest({
   argv: ['--type', 'server'],
@@ -228,7 +221,7 @@ let exitCode = await runRemixTest({
 })
 ```
 
-`runRemixTest()` returns the runner exit code. The `remix test` and `remix-test` bin wrappers call
+`runRemixTest()` returns the runner exit code. The `remix test` bin wrapper calls
 `process.exit()` with that code when the run finishes so open workers, browsers, or project handles
 cannot keep the CLI alive.
 

package/dist/app/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/app/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAQjC,wBAAsB,WAAW,CAC/B,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkChD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/app/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAWjC,wBAAsB,WAAW,CAC/B,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkChD"}

package/dist/app/server.js

@@ -8,6 +8,8 @@ import { fileURLToPath } from 'node:url';
 import { SourceMapConsumer, SourceMapGenerator } from 'source-map-js';
 import { getBrowserTestRootDir, IS_RUNNING_FROM_SRC } from "../lib/config.js";
 import { transformTypeScript } from "../lib/ts-transform.js";
+const log = (str) => console.log(`[remix:test] ${str}`);
+const logError = (str, e) => console.error(`[remix:test] Error: ${str}\n`, e);
 export async function startServer(browserFiles) {
     let handle = createRequestHandler(browserFiles);
     let port = 44101;
@@ -16,7 +18,7 @@ export async function startServer(browserFiles) {
         try {
             let server = http.createServer((req, res) => {
                 handle(req, res).catch((error) => {
-                    console.error(`[remix-test] Unhandled error for ${req.url}:`, error);
+                    logError(`Unhandled error for ${req.url}`, error);
                     if (!res.headersSent) {
                         res.writeHead(500, { 'Content-Type': 'text/plain' });
                     }
@@ -28,7 +30,7 @@ export async function startServer(browserFiles) {
                 server.once('error', reject);
                 server.listen(port, () => {
                     server.removeListener('error', reject);
-                    console.log(`Test server running on http://localhost:${port}`);
+                    log(`Test server running on http://localhost:${port}`);
                     resolve();
                 });
             });
@@ -38,7 +40,7 @@ export async function startServer(browserFiles) {
             if (error.code !== 'EADDRINUSE')
                 throw error;
             lastError = error;
-            console.log(`Port ${port} is in use, trying another port...`);
+            log(`Port ${port} is in use, trying another port...`);
             port += 1;
         }
     }
@@ -88,7 +90,7 @@ function createRequestHandler(browserFiles) {
                     return;
                 }
                 catch (error) {
-                    console.error(`[remix-test] Error serving ${url.pathname}:`, error);
+                    logError(`Error serving ${url.pathname}`, error);
                     sendText(res, 500, String(error));
                     return;
                 }
@@ -134,9 +136,8 @@ async function serveScript(res, filePath, urlPath, rootDir) {
             code = result.code;
         }
         catch (error) {
-            let msg = error instanceof Error ? error.message : String(error);
-            console.error(`[remix-test] Failed to transform ${urlPath}: ${msg}`);
-            sendText(res, 500, msg);
+            logError(`Failed to transform ${urlPath}`, error);
+            sendText(res, 500, `Failed to transform ${urlPath}`);
             return;
         }
     }
@@ -147,9 +148,8 @@ async function serveScript(res, filePath, urlPath, rootDir) {
         code = await rewriteImports(code, filePath, rootDir);
     }
     catch (error) {
-        let msg = error instanceof Error ? error.message : String(error);
-        console.error(`[remix-test] Failed to rewrite imports for ${urlPath}: ${msg}`);
-        sendText(res, 500, msg);
+        logError(`Failed to rewrite imports for ${urlPath}`, error);
+        sendText(res, 500, `Failed to rewrite imports for ${urlPath}`);
         return;
     }
     res.writeHead(200, { 'Content-Type': 'application/javascript' });

package/dist/cli.d.ts

@@ -1,8 +1,38 @@
 import { getRemixTestHelpText } from './lib/config.ts';
 export { getRemixTestHelpText };
+/**
+ * Options accepted by {@link runRemixTest}.
+ */
 export interface RunRemixTestOptions {
+    /**
+     * Argument vector to parse. When omitted, `process.argv.slice(2)` is used
+     * so the regular CLI flags work transparently.
+     */
     argv?: string[];
+    /**
+     * Working directory the runner resolves config and test files against
+     * (default `process.cwd()`).
+     */
     cwd?: string;
 }
+/**
+ * Programmatic entry point for the `remix-test` CLI. Loads the user's
+ * {@link RemixTestConfig}, discovers test files, and runs them through the
+ * server/browser/E2E pipelines configured by the project. In watch mode the
+ * promise resolves when the user terminates the runner; otherwise it resolves
+ * once the run finishes.
+ *
+ * @param options Optional overrides for the parsed argv and working directory.
+ * @returns The exit code the host process should use (`0` on success, `1` on
+ *          test failure or unrecoverable error).
+ *
+ * @example
+ * ```ts
+ * import { runRemixTest } from '@remix-run/test/cli'
+ *
+ * let exitCode = await runRemixTest()
+ * process.exit(exitCode)
+ * ```
+ */
 export declare function runRemixTest(options?: RunRemixTestOptions): Promise<number>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,EAIrB,MAAM,iBAAiB,CAAA;AAWxB,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAK/B,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAWD,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAerF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,EAIrB,MAAM,iBAAiB,CAAA;AAWxB,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAK/B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAerF"}

package/dist/cli.js

@@ -10,6 +10,25 @@ import { IS_BUN } from "./lib/runtime.js";
 import { isMainThread } from 'node:worker_threads';
 export { getRemixTestHelpText };
 const MISSING_PLAYWRIGHT_MESSAGE = 'Playwright is required to run browser and E2E tests. Install it with `npm i -D playwright`.';
+/**
+ * Programmatic entry point for the `remix-test` CLI. Loads the user's
+ * {@link RemixTestConfig}, discovers test files, and runs them through the
+ * server/browser/E2E pipelines configured by the project. In watch mode the
+ * promise resolves when the user terminates the runner; otherwise it resolves
+ * once the run finishes.
+ *
+ * @param options Optional overrides for the parsed argv and working directory.
+ * @returns The exit code the host process should use (`0` on success, `1` on
+ *          test failure or unrecoverable error).
+ *
+ * @example
+ * ```ts
+ * import { runRemixTest } from '@remix-run/test/cli'
+ *
+ * let exitCode = await runRemixTest()
+ * process.exit(exitCode)
+ * ```
+ */
 export async function runRemixTest(options = {}) {
     let argv = options.argv ?? process.argv.slice(2);
     let cwd = await resolveCwd(options.cwd ?? process.cwd());

package/dist/lib/config.d.ts

@@ -1,7 +1,18 @@
 import type { PlaywrightTestConfig } from 'playwright/test';
 export declare const IS_RUNNING_FROM_SRC: boolean;
 export declare function getBrowserTestRootDir(): string;
+/**
+ * Worker pool used by `remix-test` to run server and E2E test files.
+ * `'forks'` (default) uses child processes for stronger isolation; `'threads'`
+ * uses worker threads for projects that prefer lower-overhead startup.
+ */
 export type RemixTestPool = 'forks' | 'threads';
+/**
+ * User-facing configuration for the `remix-test` CLI. Every field is
+ * optional — unset fields fall back to runner defaults. The same shape can
+ * be exported from a config file (see `--config`) or passed inline to
+ * {@link runRemixTest} via the corresponding flags.
+ */
 export interface RemixTestConfig {
     /**
      * Options for controlling the playwright browser
@@ -101,5 +112,14 @@ export interface ResolvedRemixTestConfig {
     watch: boolean;
 }
 export declare function loadConfig(args?: string[], cwd?: string): Promise<ResolvedRemixTestConfig>;
+/**
+ * Returns the formatted `remix-test --help` text. Useful for embedding the
+ * runner's CLI options in higher-level tooling.
+ *
+ * @param _target Output stream the help text will be written to. Reserved
+ *                for future use (e.g. width-aware formatting); currently
+ *                unused.
+ * @returns The help text as a single string ready to write to a stream.
+ */
 export declare function getRemixTestHelpText(_target?: NodeJS.WriteStream): string;
 //# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.js

@@ -172,6 +172,15 @@ export async function loadConfig(args = process.argv.slice(2), cwd = process.cwd
     let config = resolveConfig(fileConfig, parsed);
     return config;
 }
+/**
+ * Returns the formatted `remix-test --help` text. Useful for embedding the
+ * runner's CLI options in higher-level tooling.
+ *
+ * @param _target Output stream the help text will be written to. Reserved
+ *                for future use (e.g. width-aware formatting); currently
+ *                unused.
+ * @returns The help text as a single string ready to write to a stream.
+ */
 export function getRemixTestHelpText(_target = process.stdout) {
     let lines = [
         'Usage: remix-test [glob...] [options]',

package/dist/lib/context.d.ts

@@ -13,7 +13,7 @@ export interface TestServer {
     close(): Promise<void>;
 }
 /**
- * Test Context providing utilities for testing via remix-test.  The context is
+ * Test Context providing utilities for testing via `remix-test`.  The context is
  * passed as the first argument to the {@link test}/{@link it} functions.
  *
  * @example
@@ -33,8 +33,8 @@ export interface TestContext {
      */
     after(fn: () => void): void;
     /**
-     * Mock tracker for the current test. Mirrors the shape of Node's
-     * `t.mock`. Method mocks created here are auto-restored on test completion.
+     * Mock tracker for the current test using {@link mock}. Mirrors the shape of Node's
+     * `t.mock`. Method mocks created via `t.mock` are auto-restored on test completion.
      */
     mock: {
         /**
@@ -67,8 +67,8 @@ export interface TestContext {
     /**
      * Wires a running test server up to a Playwright page so the test can drive
      * it. The server is closed automatically when the test ends. Pair with
-     * `createTestServer` from `@remix-run/node-fetch-server/test` (or any other
-     * source of a `{ baseUrl, close }` handle) to spin up the server first.
+     * {@link createTestServer} from `@remix-run/node-fetch-server/test` to spin
+     * up the server.
      *
      * @param server - The running server the page should target
      * @returns A `Page` whose `baseURL` is set to `server.baseUrl`.

package/dist/lib/coverage-loader.js

@@ -3,8 +3,8 @@ import { fileURLToPath } from 'node:url';
 import { transformTypeScript } from "./ts-transform.js";
 // Custom ESM loader hook for TypeScript files.
 //
-// Replaces tsx's minified transformation with an un-minified esbuild transform
-// that preserves line structure. This ensures V8 coverage byte offsets map
+// Applies an un-minified esbuild transform that preserves line structure.
+// This ensures V8 coverage byte offsets map
 // cleanly to TypeScript source lines via the inline source map, giving
 // accurate per-line coverage rather than collapsing multiple statements onto
 // a single minified line.

package/dist/lib/coverage.js

@@ -151,7 +151,7 @@ export async function collectServerCoverageMap(coverageDataDir, cwd, testFiles)
                 if (success)
                     converted++;
             }
-            catch (e) {
+            catch {
                 // Skip files that can't be converted
             }
         }

package/dist/lib/fake-timers.d.ts

@@ -1,12 +1,44 @@
+/**
+ * Handle returned by `mock.timers.enable()` for driving fake timers during a
+ * test. While enabled, `setTimeout`, `setInterval`, `clearTimeout`,
+ * `clearInterval`, and `Date.now` use the fake clock instead of the real one;
+ * timers fire only when the test calls `advance` (or `advanceAsync`).
+ *
+ * @example
+ * ```ts
+ * it('debounces save calls', (t) => {
+ *   let timers = t.mock.timers.enable()
+ *   let save = t.mock.fn()
+ *   let debounced = debounce(save, 100)
+ *   debounced(); debounced(); debounced()
+ *   timers.advance(100)
+ *   assert.equal(save.mock.calls.length, 1)
+ * })
+ * ```
+ */
 export interface FakeTimers {
+    /**
+     * Advance the fake clock by `ms` milliseconds, synchronously firing every
+     * timer whose deadline is reached during the advance.
+     *
+     * @param ms Number of milliseconds to advance.
+     */
     advance(ms: number): void;
     /**
      * Like `advance`, but yields to microtasks between each timer firing so
      * Promise continuations (and any timers they schedule) can settle before
      * the next firing is processed. Use this when a callback awaits work that
      * itself depends on the fake clock.
+     *
+     * @param ms Number of milliseconds to advance.
+     * @returns A promise that resolves once all reachable timers have fired.
      */
     advanceAsync(ms: number): Promise<void>;
+    /**
+     * Restore the original timer functions and the real clock. Called
+     * automatically after the test finishes; may also be called early to
+     * disable fake timers mid-test.
+     */
     restore(): void;
 }
 export declare function createFakeTimers(): FakeTimers;

package/dist/lib/fake-timers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fake-timers.d.ts","sourceRoot":"","sources":["../../src/lib/fake-timers.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CA0E7C"}
+{"version":3,"file":"fake-timers.d.ts","sourceRoot":"","sources":["../../src/lib/fake-timers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CA0E7C"}

package/dist/lib/framework.d.ts

@@ -1,7 +1,9 @@
 import type { TestContext } from './context.ts';
+declare function describeImpl(name: string, fn: () => void): void;
+declare function describeImpl(name: string, meta: SuiteMeta, fn: () => void): void;
 /**
- * Groups related tests into a named suite. Suites can be nested snd will be displayed
- * as such or joined with ` > ` in reporter output. Lifecycle hooks registered inside
+ * Groups related tests into a named suite. Suites can be nested and will be displayed
+ * as such in reporter output. Lifecycle hooks registered inside
  * a `describe` block apply only to tests within that block.
  *
  * @example
@@ -15,9 +17,10 @@ import type { TestContext } from './context.ts';
  * describe.todo('planned suite')
  *
  * @param name - The suite name shown in reporter output.
+ * @param meta - Suite metadata such as `skip` or `only`.
  * @param fn - A function that registers the tests and lifecycle hooks in this suite.
  */
-export declare const describe: ((name: string, metaOrFn: SuiteMeta | (() => void), fn?: (() => void) | undefined) => void) & {
+export declare const describe: typeof describeImpl & {
     skip: (name: string, fn: () => void) => void;
     only: (name: string, fn: () => void) => void;
     todo: (name: string) => void;
@@ -31,6 +34,8 @@ type TestMeta = {
     only?: boolean;
 };
 type TestFn = (t: TestContext) => void | Promise<void>;
+declare function itImpl(name: string, fn: TestFn): void;
+declare function itImpl(name: string, meta: TestMeta, fn: TestFn): void;
 /**
  * Defines a single test case. The optional `TestContext` argument `t` provides
  * mock helpers and per-test cleanup registration.
@@ -47,21 +52,22 @@ type TestFn = (t: TestContext) => void | Promise<void>;
  * it.todo('coming soon')
  *
  * @param name - The test name shown in reporter output.
+ * @param meta - Test metadata such as `skip` or `only`.
  * @param fn - The test body, receiving a {@link TestContext} as its first argument.
  */
-export declare const it: ((name: string, metaOrFn: TestFn | TestMeta, fn?: TestFn | undefined) => void) & {
+export declare const it: typeof itImpl & {
     skip: (name: string, fn?: TestFn | undefined) => void;
     only: (name: string, fn: TestFn) => void;
     todo: (name: string) => void;
 };
 /** Alias for {@link describe}. */
-export declare const suite: ((name: string, metaOrFn: SuiteMeta | (() => void), fn?: (() => void) | undefined) => void) & {
+export declare const suite: typeof describeImpl & {
     skip: (name: string, fn: () => void) => void;
     only: (name: string, fn: () => void) => void;
     todo: (name: string) => void;
 };
 /** Alias for {@link it}. */
-export declare const test: ((name: string, metaOrFn: TestFn | TestMeta, fn?: TestFn | undefined) => void) & {
+export declare const test: typeof itImpl & {
     skip: (name: string, fn?: TestFn | undefined) => void;
     only: (name: string, fn: TestFn) => void;
     todo: (name: string) => void;

package/dist/lib/framework.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/lib/framework.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAkF/C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,QAAQ;;;;CAiBpB,CAAA;AAED,KAAK,SAAS,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AACnD,KAAK,QAAQ,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAClD,KAAK,MAAM,GAAG,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAUtD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,EAAE;;;;CAiBd,CAAA;AAED,kCAAkC;AAClC,eAAO,MAAM,KAAK;;;;CAAW,CAAA;AAC7B,4BAA4B;AAC5B,eAAO,MAAM,IAAI;;;;CAAK,CAAA;AA2BtB;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGvD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGvD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGtD;AAED,mEAAiE;AACjE,eAAO,MAAM,MAAM,kBAAY,CAAA;AAC/B,kEAAgE;AAChE,eAAO,MAAM,KAAK,iBAAW,CAAA"}
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/lib/framework.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AA4F/C,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;AACzD,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;AAO1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ;;;;CAUnB,CAAA;AAEF,KAAK,SAAS,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AACnD,KAAK,QAAQ,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAClD,KAAK,MAAM,GAAG,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAatD,iBAAS,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;AAC/C,iBAAS,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;AAO/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,EAAE;;;;CAUb,CAAA;AAEF,kCAAkC;AAClC,eAAO,MAAM,KAAK;;;;CAAW,CAAA;AAC7B,4BAA4B;AAC5B,eAAO,MAAM,IAAI;;;;CAAK,CAAA;AA2BtB;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGvD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGvD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAGtD;AAED,mEAAiE;AACjE,eAAO,MAAM,MAAM,kBAAY,CAAA;AAC/B,kEAAgE;AAChE,eAAO,MAAM,KAAK,iBAAW,CAAA"}

package/dist/lib/framework.js

@@ -26,6 +26,14 @@ function registerDescribe(name, fn, flags) {
         throw new Error(`Duplicate suite name: "${fullName}"`);
     }
     let suite = { name: fullName, tests: [], ...flags };
+    // Children inherit `skip`/`only` from their parent so that
+    // `describe.skip('parent', () => describe('child', () => it(...)))` actually
+    // skips the child's tests. The executor walks `rootSuites` as a flat list and
+    // only inspects each suite's own flag, so the propagation has to happen here.
+    if (currentSuite?.skip)
+        suite.skip = true;
+    if (currentSuite?.only)
+        suite.only = true;
     // Inherit lifecycle hooks from parent suite (or root hooks if at top level)
     let parent = currentSuite ?? rootHooks;
     if (parent.beforeEach)
@@ -53,9 +61,14 @@ function registerDescribe(name, fn, flags) {
         currentSuite = prevSuite;
     }
 }
+function describeImpl(name, metaOrFn, fn) {
+    let meta = typeof metaOrFn === 'function' ? {} : metaOrFn;
+    let suiteFn = typeof metaOrFn === 'function' ? metaOrFn : fn;
+    registerDescribe(name, suiteFn, meta);
+}
 /**
- * Groups related tests into a named suite. Suites can be nested snd will be displayed
- * as such or joined with ` > ` in reporter output. Lifecycle hooks registered inside
+ * Groups related tests into a named suite. Suites can be nested and will be displayed
+ * as such in reporter output. Lifecycle hooks registered inside
  * a `describe` block apply only to tests within that block.
  *
  * @example
@@ -69,13 +82,10 @@ function registerDescribe(name, fn, flags) {
  * describe.todo('planned suite')
  *
  * @param name - The suite name shown in reporter output.
+ * @param meta - Suite metadata such as `skip` or `only`.
  * @param fn - A function that registers the tests and lifecycle hooks in this suite.
  */
-export const describe = Object.assign((name, metaOrFn, fn) => {
-    let meta = typeof metaOrFn === 'function' ? {} : metaOrFn;
-    let suiteFn = typeof metaOrFn === 'function' ? metaOrFn : fn;
-    registerDescribe(name, suiteFn, meta);
-}, {
+export const describe = Object.assign(describeImpl, {
     skip: (name, fn) => registerDescribe(name, fn, { skip: true }),
     only: (name, fn) => registerDescribe(name, fn, { only: true }),
     todo: (name) => {
@@ -93,6 +103,11 @@ function registerIt(name, fn, flags) {
     }
     suite.tests.push({ name, fn, suite, ...flags });
 }
+function itImpl(name, metaOrFn, fn) {
+    let meta = typeof metaOrFn === 'function' ? {} : metaOrFn;
+    let testFn = typeof metaOrFn === 'function' ? metaOrFn : fn;
+    registerIt(name, testFn, meta);
+}
 /**
  * Defines a single test case. The optional `TestContext` argument `t` provides
  * mock helpers and per-test cleanup registration.
@@ -109,13 +124,10 @@ function registerIt(name, fn, flags) {
  * it.todo('coming soon')
  *
  * @param name - The test name shown in reporter output.
+ * @param meta - Test metadata such as `skip` or `only`.
  * @param fn - The test body, receiving a {@link TestContext} as its first argument.
  */
-export const it = Object.assign((name, metaOrFn, fn) => {
-    let meta = typeof metaOrFn === 'function' ? {} : metaOrFn;
-    let testFn = typeof metaOrFn === 'function' ? metaOrFn : fn;
-    registerIt(name, testFn, meta);
-}, {
+export const it = Object.assign(itImpl, {
     skip: (name, fn) => registerIt(name, fn ?? (() => { }), { skip: true }),
     only: (name, fn) => registerIt(name, fn, { only: true }),
     todo: (name) => {

package/dist/lib/import-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-module.d.ts","sourceRoot":"","sources":["../../src/lib/import-module.ts"],"names":[],"mappings":"AAoBA,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAkBpF"}
+{"version":3,"file":"import-module.d.ts","sourceRoot":"","sources":["../../src/lib/import-module.ts"],"names":[],"mappings":"AAmBA,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAoBpF"}

package/dist/lib/import-module.js

@@ -8,7 +8,6 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 };
 import * as path from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { tsImport } from 'tsx/esm/api';
 import { IS_BUN } from "./runtime.js";
 function hasImportMetaResolve(meta) {
     return 'resolve' in meta && typeof meta.resolve === 'function';
@@ -23,8 +22,8 @@ function hasImportMetaResolve(meta) {
 export async function importModule(specifier, meta) {
     // Absolute Windows paths (`C:\foo\bar.ts`) aren't valid ESM specifiers — only
     // `file:///C:/foo/bar.ts` URLs, relative specifiers, or POSIX absolute paths
-    // are. Convert any absolute filesystem path to its `file:` URL so loaders like
-    // `tsImport` and `import()` accept it on every platform. POSIX absolute paths
+    // are. Convert any absolute filesystem path to its `file:` URL so module
+    // loaders and `import()` accept it on every platform. POSIX absolute paths
     // happen to work as specifiers without conversion, but going through
     // `pathToFileURL` is safe and platform-agnostic.
     let resolvedSpecifier = path.isAbsolute(specifier) ? pathToFileURL(specifier).href : specifier;
@@ -34,5 +33,7 @@ export async function importModule(specifier, meta) {
         }
         return import(__rewriteRelativeImportExtension(meta.resolve(resolvedSpecifier, meta.url)));
     }
-    return tsImport(resolvedSpecifier, meta.url);
+    // node-tsx uses Node APIs that fail in Bun if statically imported
+    let { loadModule } = await import('@remix-run/node-tsx/load-module');
+    return loadModule(resolvedSpecifier, meta.url);
 }

package/dist/lib/reporters/results.d.ts

@@ -1,4 +1,4 @@
-import type { V8CoverageEntry } from '../coverage';
+import type { V8CoverageEntry } from '../coverage.ts';
 export interface TestResult {
     name: string;
     suiteName: string;

package/dist/lib/reporters/results.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;IAChD,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,yBAAyB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnF;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAA"}
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;IAChD,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,yBAAyB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnF;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAA"}

package/dist/lib/runner-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner-browser.d.ts","sourceRoot":"","sources":["../../src/lib/runner-browser.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAWzD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAGlB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IACtE,OAAO,EAAE,WAAW,CAAA;IACpB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B,CAAC,CA6HD"}
+{"version":3,"file":"runner-browser.d.ts","sourceRoot":"","sources":["../../src/lib/runner-browser.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAazD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAGlB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IACtE,OAAO,EAAE,WAAW,CAAA;IACpB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B,CAAC,CAiKD"}

package/dist/lib/runner-browser.js

@@ -3,6 +3,7 @@ import { colors } from "./colors.js";
 import { getBrowserTestRootDir } from "./config.js";
 import { collectCoverageMapFromPlaywright, } from "./coverage.js";
 import { getBrowserLauncher, getPlaywrightLaunchOptions, getPlaywrightPageOptions, } from "./playwright.js";
+const BROWSER_TEST_FILE_TIMEOUT_MS = 90_000;
 // The harness reports each test result with `filePath` set to the
 // `/scripts/<rel>` URL the iframe loaded. Reporters expect a real filesystem
 // path so they can compute `path.relative(cwd, ...)` cleanly; otherwise they
@@ -27,12 +28,10 @@ export async function runBrowserTests(options) {
     try {
         browser = await getBrowserLauncher(options.playwrightUseOpts).launch(getPlaywrightLaunchOptions(options.playwrightUseOpts));
         page = await browser.newPage(getPlaywrightPageOptions(options.playwrightUseOpts));
-        // Cap how long we'll wait for a browser-test file to signal completion.
-        // Playwright's default is 30s; bumping to 60s buys headroom for slower
-        // suites without letting a hung test hide forever. Plumb this through
-        // config later if anyone needs to tune it.
-        page.setDefaultTimeout(90_000);
-        page.setDefaultNavigationTimeout(90_000);
+        // Cap individual browser operations, then separately watch for per-file
+        // progress so large suites can run longer than this without hiding hangs.
+        page.setDefaultTimeout(BROWSER_TEST_FILE_TIMEOUT_MS);
+        page.setDefaultNavigationTimeout(BROWSER_TEST_FILE_TIMEOUT_MS);
         if (options.console) {
             page.on('console', (msg) => console.log(`${colors.dim('[browser console]')} ${msg.text()}`));
         }
@@ -47,6 +46,26 @@ export async function runBrowserTests(options) {
         let totalSkipped = 0;
         let totalTodo = 0;
         let rootDir = getBrowserTestRootDir();
+        let completedFiles = 0;
+        let totalFiles = options.testFiles?.length ?? 0;
+        let progressTimeoutId;
+        let rejectProgressTimeout = () => { };
+        let progressTimeoutPromise = new Promise((_, reject) => {
+            rejectProgressTimeout = reject;
+        });
+        function clearProgressTimeout() {
+            if (progressTimeoutId !== undefined) {
+                clearTimeout(progressTimeoutId);
+                progressTimeoutId = undefined;
+            }
+        }
+        function resetProgressTimeout() {
+            clearProgressTimeout();
+            progressTimeoutId = setTimeout(() => {
+                let progress = totalFiles > 0 ? ` (${completedFiles}/${totalFiles} files completed)` : '';
+                rejectProgressTimeout(new Error(`Timed out waiting ${BROWSER_TEST_FILE_TIMEOUT_MS}ms for browser test progress${progress}`));
+            }, BROWSER_TEST_FILE_TIMEOUT_MS);
+        }
         await page.route('**/file-results', async (route) => {
             let results = route.request().postDataJSON();
             for (let test of results.tests) {
@@ -58,6 +77,8 @@ export async function runBrowserTests(options) {
             totalFailed += results.failed;
             totalSkipped += results.skipped;
             totalTodo += results.todo;
+            completedFiles++;
+            resetProgressTimeout();
             await route.fulfill({ status: 200 });
         });
         // Fail the tests if any /scripts/ request fails (harness scripts, test
@@ -77,8 +98,19 @@ export async function runBrowserTests(options) {
         });
         // Prevent unhandled rejection if we fail before setting up the listener
         errorPromise.catch(() => { });
-        await page.goto(options.baseUrl);
-        await Promise.race([page.waitForFunction('window.__testsDone'), errorPromise]);
+        progressTimeoutPromise.catch(() => { });
+        resetProgressTimeout();
+        try {
+            await page.goto(options.baseUrl);
+            await Promise.race([
+                page.waitForFunction('window.__testsDone', undefined, { timeout: 0 }),
+                errorPromise,
+                progressTimeoutPromise,
+            ]);
+        }
+        finally {
+            clearProgressTimeout();
+        }
         if (coverageEnabled) {
             let entries = (await page.coverage.stopJSCoverage());
             if (entries.length > 0) {