@remix-run/test 0.2.0 → 0.4.0

package/dist/lib/config.js

@@ -40,19 +40,23 @@ const cliOptions = {
     },
     'glob.browser': {
         type: 'string',
-        description: 'Glob pattern for browser test files',
+        multiple: true,
+        description: 'Glob pattern(s) for browser test files',
     },
     'glob.e2e': {
         type: 'string',
-        description: 'Glob pattern for E2E test files',
+        multiple: true,
+        description: 'Glob pattern(s) for E2E test files',
     },
     'glob.exclude': {
         type: 'string',
-        description: 'Glob pattern for paths to exclude from discovery',
+        multiple: true,
+        description: 'Glob pattern(s) for paths to exclude from discovery',
     },
     'glob.test': {
         type: 'string',
-        description: 'Glob pattern for all test files',
+        multiple: true,
+        description: 'Glob pattern(s) for all test files',
     },
     concurrency: {
         type: 'string',
@@ -109,7 +113,12 @@ const cliOptions = {
     project: {
         type: 'string',
         short: 'p',
-        description: 'Filter to a specific Playwright project (comma-separated)',
+        multiple: true,
+        description: 'Filter to specific Playwright project(s)',
+    },
+    pool: {
+        type: 'string',
+        description: 'Pool used to run server and E2E test files: forks, threads (default: forks)',
     },
     reporter: {
         type: 'string',
@@ -119,7 +128,8 @@ const cliOptions = {
     type: {
         type: 'string',
         short: 't',
-        description: 'Comma-separated test types to run (default: server,browser,e2e)',
+        multiple: true,
+        description: 'Test types to run (default: server, browser, e2e)',
     },
     watch: {
         type: 'boolean',
@@ -143,16 +153,17 @@ const defaultValues = {
         functions: undefined,
     },
     glob: {
-        test: '**/*.test{,.e2e,.browser}.{ts,tsx}',
-        browser: '**/*.test.browser.{ts,tsx}',
-        e2e: '**/*.test.e2e.{ts,tsx}',
-        exclude: 'node_modules/**',
+        test: ['**/*.test{,.e2e,.browser}.{ts,tsx}'],
+        browser: ['**/*.test.browser.{ts,tsx}'],
+        e2e: ['**/*.test.e2e.{ts,tsx}'],
+        exclude: ['node_modules/**'],
     },
-    reporter: process.env.CI === 'true' ? 'files' : 'spec',
-    type: 'server,browser,e2e',
-    setup: undefined,
+    pool: 'forks',
     playwrightConfig: undefined,
     project: undefined,
+    reporter: process.env.CI === 'true' ? 'files' : 'spec',
+    setup: undefined,
+    type: ['server', 'browser', 'e2e'],
     watch: false,
 };
 export async function loadConfig(args = process.argv.slice(2), cwd = process.cwd()) {
@@ -161,12 +172,21 @@ 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]',
+        'Usage: remix-test [glob...] [options]',
         '',
         'Arguments:',
-        `  glob                     Glob pattern for test files (default: "${defaultValues.glob.test}")`,
+        `  glob                     Glob pattern(s) for test files (default: "${defaultValues.glob.test.join(', ')}")`,
         '',
         'Options:',
     ];
@@ -181,17 +201,25 @@ export function getRemixTestHelpText(_target = process.stdout) {
 function parseCliArgs(args) {
     return util.parseArgs({ args, options: cliOptions, allowPositionals: true });
 }
+function toArray(value) {
+    return Array.isArray(value) ? [...value] : [value];
+}
+function toCommaSeparatedArray(value) {
+    return toArray(value).flatMap((item) => item
+        .split(',')
+        .map((part) => part.trim())
+        .filter(Boolean));
+}
 function resolveConfig(fileConfig, { values: cliValues, positionals }) {
     let fileCoverage = typeof fileConfig.coverage === 'boolean' ? {} : fileConfig.coverage || {};
     return {
         glob: {
-            test: positionals[0] ??
-                cliValues['glob.test'] ??
-                fileConfig.glob?.test ??
-                defaultValues.glob.test,
-            browser: cliValues['glob.browser'] ?? fileConfig.glob?.browser ?? defaultValues.glob.browser,
-            e2e: cliValues['glob.e2e'] ?? fileConfig.glob?.e2e ?? defaultValues.glob.e2e,
-            exclude: cliValues['glob.exclude'] ?? fileConfig.glob?.exclude ?? defaultValues.glob.exclude,
+            test: toArray(positionals.length > 0
+                ? positionals
+                : (cliValues['glob.test'] ?? fileConfig.glob?.test ?? defaultValues.glob.test)),
+            browser: toArray(cliValues['glob.browser'] ?? fileConfig.glob?.browser ?? defaultValues.glob.browser),
+            e2e: toArray(cliValues['glob.e2e'] ?? fileConfig.glob?.e2e ?? defaultValues.glob.e2e),
+            exclude: toArray(cliValues['glob.exclude'] ?? fileConfig.glob?.exclude ?? defaultValues.glob.exclude),
         },
         browser: {
             echo: cliValues['browser.echo'] ?? fileConfig.browser?.echo ?? defaultValues.browser.echo,
@@ -201,12 +229,18 @@ function resolveConfig(fileConfig, { values: cliValues, positionals }) {
         coverage: cliValues.coverage === true || !!fileConfig.coverage
             ? {
                 dir: cliValues['coverage.dir'] ?? fileCoverage.dir ?? defaultValues.coverage.dir,
-                include: cliValues['coverage.include'] ??
-                    fileCoverage.include ??
-                    defaultValues.coverage.include,
-                exclude: cliValues['coverage.exclude'] ??
-                    fileCoverage.exclude ??
-                    defaultValues.coverage.exclude,
+                include: (() => {
+                    let raw = cliValues['coverage.include'] ??
+                        fileCoverage.include ??
+                        defaultValues.coverage.include;
+                    return raw === undefined ? undefined : toArray(raw);
+                })(),
+                exclude: (() => {
+                    let raw = cliValues['coverage.exclude'] ??
+                        fileCoverage.exclude ??
+                        defaultValues.coverage.exclude;
+                    return raw === undefined ? undefined : toArray(raw);
+                })(),
                 statements: cliValues['coverage.statements'] !== undefined
                     ? Number(cliValues['coverage.statements'])
                     : fileCoverage.statements !== undefined
@@ -231,12 +265,22 @@ function resolveConfig(fileConfig, { values: cliValues, positionals }) {
             : undefined,
         setup: cliValues.setup ?? fileConfig.setup ?? defaultValues.setup,
         playwrightConfig: cliValues.playwrightConfig ?? fileConfig.playwrightConfig ?? defaultValues.playwrightConfig,
-        project: cliValues.project ?? fileConfig.project ?? defaultValues.project,
+        pool: resolvePool(cliValues.pool ?? fileConfig.pool ?? defaultValues.pool),
+        project: (() => {
+            let raw = cliValues.project ?? fileConfig.project ?? defaultValues.project;
+            return raw === undefined ? undefined : toCommaSeparatedArray(raw);
+        })(),
         reporter: cliValues.reporter ?? fileConfig.reporter ?? defaultValues.reporter,
-        type: cliValues.type ?? fileConfig.type ?? defaultValues.type,
+        type: toCommaSeparatedArray(cliValues.type ?? fileConfig.type ?? defaultValues.type),
         watch: cliValues.watch ?? fileConfig.watch ?? defaultValues.watch,
     };
 }
+function resolvePool(value) {
+    if (value === 'forks' || value === 'threads') {
+        return value;
+    }
+    throw new Error(`Unsupported test pool "${value}". Supported pools are: forks, threads`);
+}
 async function loadConfigFile(configPath, cwd) {
     let candidates = configPath
         ? [path.resolve(cwd, configPath)]
@@ -244,12 +288,17 @@ async function loadConfigFile(configPath, cwd) {
     for (let candidate of candidates) {
         try {
             await fsp.access(candidate);
-            let mod = await importModule(candidate, import.meta);
-            return mod.default ?? mod;
         }
         catch {
-            // not found or failed to load — try next
+            // not found — try the next candidate
+            continue;
         }
+        // The file exists; let import errors propagate rather than silently
+        // falling through to defaults — that masking is what hid "Windows
+        // absolute paths aren't valid ESM specifiers" by classifying every
+        // browser test as a server test.
+        let mod = await importModule(candidate, import.meta);
+        return mod.default ?? mod;
     }
     return {};
 }

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,5 +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,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAwD7C"}
+{"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/fake-timers.js

@@ -15,21 +15,40 @@ export function createFakeTimers() {
     let clearTimeoutMock = mock.method(globalThis, 'clearTimeout', cancel);
     let setIntervalMock = mock.method(globalThis, 'setInterval', ((fn, delay = 0) => schedule(fn, delay, Math.max(0, delay))));
     let clearIntervalMock = mock.method(globalThis, 'clearInterval', cancel);
+    function takeNext(targetTime) {
+        let next = pending.filter((t) => t.time <= targetTime).sort((a, b) => a.time - b.time)[0];
+        if (!next)
+            return null;
+        currentTime = next.time;
+        pending = pending.filter((t) => t.id !== next.id);
+        // Requeue intervals before running the callback so that calling
+        // clearInterval(id) from inside the callback can cancel the next firing.
+        if (next.repeatMs !== undefined) {
+            pending.push({ ...next, time: next.time + Math.max(1, next.repeatMs) });
+        }
+        return next;
+    }
     return {
         advance(ms) {
             let targetTime = currentTime + ms;
             while (true) {
-                let next = pending.filter((t) => t.time <= targetTime).sort((a, b) => a.time - b.time)[0];
+                let next = takeNext(targetTime);
+                if (!next)
+                    break;
+                next.fn();
+            }
+            currentTime = targetTime;
+        },
+        async advanceAsync(ms) {
+            let targetTime = currentTime + ms;
+            while (true) {
+                let next = takeNext(targetTime);
                 if (!next)
                     break;
-                currentTime = next.time;
-                pending = pending.filter((t) => t.id !== next.id);
-                // Requeue intervals before running the callback so that calling
-                // clearInterval(id) from inside the callback can cancel the next firing.
-                if (next.repeatMs !== undefined) {
-                    pending.push({ ...next, time: next.time + Math.max(1, next.repeatMs) });
-                }
                 next.fn();
+                // Drain microtasks so Promise continuations (and any timers they
+                // schedule) can settle before we look for the next firing.
+                await Promise.resolve();
             }
             currentTime = targetTime;
         },

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":"AAkBA,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAUpF"}
+{"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

@@ -6,7 +6,8 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { tsImport } from 'tsx/esm/api';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
 import { IS_BUN } from "./runtime.js";
 function hasImportMetaResolve(meta) {
     return 'resolve' in meta && typeof meta.resolve === 'function';
@@ -19,11 +20,20 @@ function hasImportMetaResolve(meta) {
  * @returns The imported module namespace.
  */
 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 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;
     if (IS_BUN) {
         if (!hasImportMetaResolve(meta)) {
             throw new Error('importModule() requires import.meta.resolve() in Bun');
         }
-        return import(__rewriteRelativeImportExtension(meta.resolve(specifier, meta.url)));
+        return import(__rewriteRelativeImportExtension(meta.resolve(resolvedSpecifier, meta.url)));
     }
-    return tsImport(specifier, 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/dot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/dot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAc,WAAW,EAAE,MAAM,cAAc,CAAA;AAEnE,qBAAa,WAAY,YAAW,QAAQ;;IAI1C,cAAc,CAAC,MAAM,EAAE,MAAM,QAAI;IAEjC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,QAc3C;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QA6B3C;CACF"}
+{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/dot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAc,WAAW,EAAE,MAAM,cAAc,CAAA;AAEnE,qBAAa,WAAY,YAAW,QAAQ;;IAM1C,cAAc,CAAC,MAAM,EAAE,MAAM,QAAI;IAEjC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,QAmB3C;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QA+B3C;CACF"}

package/dist/lib/reporters/dot.js

@@ -3,8 +3,16 @@ import { normalizeLine } from "../normalize.js";
 export class DotReporter {
     #failures = [];
     #dotCount = 0;
+    #files = new Set();
+    #suites = new Set();
     onSectionStart(_label) { }
     onResult(results, _env) {
+        for (let test of results.tests) {
+            if (test.filePath)
+                this.#files.add(test.filePath);
+            if (test.suiteName)
+                this.#suites.add(test.suiteName);
+        }
         for (let test of results.tests) {
             if (test.status === 'passed') {
                 process.stdout.write(colors.green('.'));
@@ -43,6 +51,8 @@ export class DotReporter {
         let { passed, failed, skipped, todo } = counts;
         let info = colors.cyan('ℹ');
         console.log();
+        console.log(`${info} files ${this.#files.size}`);
+        console.log(`${info} suites ${this.#suites.size}`);
         console.log(`${info} tests ${passed + failed + skipped + todo}`);
         console.log(`${info} pass ${passed}`);
         console.log(`${info} fail ${failed}`);

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

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAc,WAAW,EAAE,MAAM,cAAc,CAAA;AAEnE,qBAAa,aAAc,YAAW,QAAQ;;IAG5C,cAAc,CAAC,MAAM,EAAE,MAAM,QAAI;IAEjC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,QA8B1C;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAgC3C;CACF"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAc,WAAW,EAAE,MAAM,cAAc,CAAA;AAEnE,qBAAa,aAAc,YAAW,QAAQ;;IAK5C,cAAc,CAAC,MAAM,EAAE,MAAM,QAAI;IAEjC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,QAmC1C;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAkC3C;CACF"}

package/dist/lib/reporters/files.js

@@ -3,8 +3,16 @@ import { colors } from "../colors.js";
 import { normalizeLine } from "../normalize.js";
 export class FilesReporter {
     #failures = [];
+    #files = new Set();
+    #suites = new Set();
     onSectionStart(_label) { }
     onResult(results, env) {
+        for (let test of results.tests) {
+            if (test.filePath)
+                this.#files.add(test.filePath);
+            if (test.suiteName)
+                this.#suites.add(test.suiteName);
+        }
         let filePath = results.tests[0]?.filePath;
         let fileName = filePath ? path.relative(process.cwd(), filePath) : '(unknown)';
         let envLabel = env ? ` ${colors.dim(`[${env}]`)}` : '';
@@ -58,6 +66,8 @@ export class FilesReporter {
         let { passed, failed, skipped, todo } = counts;
         let info = colors.cyan('ℹ');
         console.log();
+        console.log(`${info} files ${this.#files.size}`);
+        console.log(`${info} suites ${this.#suites.size}`);
         console.log(`${info} tests ${passed + failed + skipped + todo}`);
         console.log(`${info} pass ${passed}`);
         console.log(`${info} fail ${failed}`);

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/reporters/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAc,WAAW,EAAE,MAAM,cAAc,CAAA;AAEnE,qBAAa,YAAa,YAAW,QAAQ;;IAG3C,cAAc,CAAC,KAAK,EAAE,MAAM,QAE3B;IAED,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,QA8H1C;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAgC3C;CACF"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/lib/reporters/spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAc,WAAW,EAAE,MAAM,cAAc,CAAA;AAEnE,qBAAa,YAAa,YAAW,QAAQ;;IAK3C,cAAc,CAAC,KAAK,EAAE,MAAM,QAE3B;IAED,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,QAmI1C;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAkC3C;CACF"}