@rstest/browser 0.9.4 → 0.9.6

package/dist/sessionRegistry.d.ts

@@ -1,5 +1,5 @@
 import type { BrowserProviderContext, BrowserProviderPage } from './providers';
-export type RunnerSessionRecord = {
+type RunnerSessionRecord = {
     id: string;
     testFile: string;
     projectName: string;

package/dist/watchRerunPlanner.d.ts

@@ -1,5 +1,5 @@
 import type { TestFileInfo } from './protocol';
-export type WatchPlannerProjectEntry = {
+type WatchPlannerProjectEntry = {
     project: {
         name: string;
     };
@@ -10,7 +10,7 @@ type WatchRerunPlannerInput = {
     previousTestFiles: TestFileInfo[];
     affectedTestFiles: string[];
 };
-export type WatchRerunPlan = {
+type WatchRerunPlan = {
     currentTestFiles: TestFileInfo[];
     filesChanged: boolean;
     normalizedAffectedTestFiles: string[];

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@rstest/browser",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Browser mode support for Rstest testing framework.",
+  "keywords": [
+    "rstest",
+    "browser",
+    "test",
+    "rstack",
+    "rspack"
+  ],
   "bugs": {
     "url": "https://github.com/web-infra-dev/rstest/issues"
   },
@@ -10,16 +17,8 @@
     "url": "https://github.com/web-infra-dev/rstest",
     "directory": "packages/browser"
   },
-  "keywords": [
-    "rstest",
-    "browser",
-    "test",
-    "rstack",
-    "rspack"
-  ],
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
   "exports": {
     ".": {
       "types": "./dist/browser.d.ts",
@@ -33,6 +32,7 @@
       "default": "./package.json"
     }
   },
+  "main": "./dist/index.js",
   "files": [
     "dist",
     "src",
@@ -45,26 +45,25 @@
     "open-editor": "^6.0.0",
     "pathe": "^2.0.3",
     "sirv": "^3.0.2",
-    "ws": "^8.19.0"
+    "ws": "^8.20.0"
   },
   "devDependencies": {
-    "@rslib/core": "0.20.0",
+    "@rslib/core": "0.20.2",
     "@types/convert-source-map": "^2.0.3",
     "@types/picomatch": "^4.0.2",
     "@types/ws": "^8.18.1",
-    "@typescript/native-preview": "7.0.0-dev.20260317.1",
+    "@typescript/native-preview": "7.0.0-dev.20260331.1",
     "@vitest/snapshot": "^3.2.4",
     "birpc": "^4.0.0",
-    "picocolors": "^1.1.1",
-    "picomatch": "^4.0.3",
-    "playwright": "^1.58.2",
+    "picomatch": "^4.0.4",
+    "playwright": "^1.59.0",
+    "@rstest/browser-ui": "0.0.0",
     "@rstest/tsconfig": "0.0.1",
-    "@rstest/core": "0.9.4",
-    "@rstest/browser-ui": "0.0.0"
+    "@rstest/core": "0.9.6"
   },
   "peerDependencies": {
     "playwright": "^1.49.1",
-    "@rstest/core": "^0.9.4"
+    "@rstest/core": "^0.9.6"
   },
   "peerDependenciesMeta": {
     "playwright": {
@@ -80,7 +79,7 @@
   },
   "scripts": {
     "build": "rslib build",
-    "typecheck": "tsc --noEmit",
-    "dev": "rslib build --watch"
+    "dev": "rslib build --watch",
+    "typecheck": "pnpm -w exec tsc --noEmit -p packages/browser/tsconfig.json"
   }
 }

package/src/client/dispatchTransport.ts

@@ -8,7 +8,7 @@ import {
   DISPATCH_RPC_REQUEST_TYPE,
 } from '../protocol';
 
-export const DEFAULT_RPC_TIMEOUT_MS = 30_000;
+const DEFAULT_RPC_TIMEOUT_MS = 30_000;
 
 export const getRpcTimeout = (): number => {
   return (

package/src/client/sourceMapSupport.ts

@@ -111,18 +111,10 @@ export const preloadRunnerSourceMap = async (): Promise<void> => {
   await preloadSourceMap(runnerUrl);
 };
 
-/**
- * Clear cache (for testing purposes)
- */
-export const clearCache = (): void => {
-  sourceMapCache.clear();
-  sourceMapPayloadCache.clear();
-};
-
 /**
  * Stack frame interface matching @vitest/snapshot's format
  */
-export interface StackFrame {
+interface StackFrame {
   file: string;
   line: number;
   column: number;

package/src/concurrency.ts

@@ -5,7 +5,7 @@ import type { Rstest } from '@rstest/core/browser';
 // Keep this in one place so executors reuse the same worker semantics.
 const DEFAULT_MAX_HEADLESS_WORKERS = 12;
 
-export type HeadlessConcurrencyContext = Pick<Rstest, 'command'> & {
+type HeadlessConcurrencyContext = Pick<Rstest, 'command'> & {
   normalizedConfig: {
     pool: {
       maxWorkers?: string | number;
@@ -13,7 +13,7 @@ export type HeadlessConcurrencyContext = Pick<Rstest, 'command'> & {
   };
 };
 
-export const getNumCpus = (): number => {
+const getNumCpus = (): number => {
   return os.availableParallelism?.() ?? os.cpus().length;
 };
 

package/src/configValidation.ts

@@ -44,7 +44,7 @@ const validateViewport = (viewport: unknown): void => {
 
 export const validateBrowserConfig = (context: Rstest): void => {
   for (const project of context.projects) {
-    const browser = project.normalizedConfig.browser;
+    const { browser, output } = project.normalizedConfig;
     if (!browser.enabled) {
       continue;
     }
@@ -66,5 +66,11 @@ export const validateBrowserConfig = (context: Rstest): void => {
     if (!isPlainObject(browser.providerOptions)) {
       throw new Error('browser.providerOptions must be a plain object.');
     }
+
+    if (output?.bundleDependencies === false) {
+      throw new Error(
+        'output.bundleDependencies false is not supported in browser mode.',
+      );
+    }
   }
 };

package/src/dispatchCapabilities.ts

@@ -27,7 +27,7 @@ type RunnerDispatchSuiteStartPayload = ReporterHookArg<'onTestSuiteStart'>;
 type RunnerDispatchSuiteResultPayload = ReporterHookArg<'onTestSuiteResult'>;
 type RunnerDispatchCaseStartPayload = ReporterHookArg<'onTestCaseStart'>;
 
-export type RunnerDispatchCallbacks = {
+type RunnerDispatchCallbacks = {
   onTestFileStart: (payload: RunnerPayload<'file-start'>) => Promise<void>;
   onTestFileReady: (payload: RunnerDispatchFileReadyPayload) => Promise<void>;
   onTestSuiteStart: (payload: RunnerDispatchSuiteStartPayload) => Promise<void>;

package/src/headedSerialTaskQueue.ts

@@ -1,4 +1,4 @@
-export type HeadedSerialTask = () => Promise<void>;
+type HeadedSerialTask = () => Promise<void>;
 
 /**
  * Serializes headed browser file execution so only one task runs at a time.

package/src/headlessLatestRerunScheduler.ts

@@ -1,4 +1,4 @@
-export type HeadlessLatestRerunScheduler<TFile> = {
+type HeadlessLatestRerunScheduler<TFile> = {
   enqueueLatest: (files: TFile[]) => Promise<void>;
   whenIdle: () => Promise<void>;
 };

package/src/hostController.ts

@@ -22,7 +22,6 @@ import {
   type RuntimeConfig,
   rsbuild,
   serializableConfig,
-  TEMP_RSTEST_OUTPUT_DIR,
   type Test,
   type TestFileResult,
   type TestResult,
@@ -519,6 +518,30 @@ type BrowserLazyCompilationConfig = {
   test?: (module: LazyCompilationModule) => boolean;
 };
 
+/**
+ * Resolve the actual port the dev server is listening on.
+ *
+ * Rsbuild's `devServer.listen()` may return `0` when configured with
+ * `server.port: 0` because its internal `getPort` never reads back the
+ * OS-assigned ephemeral port.  This helper falls back to
+ * `httpServer.address()` to obtain the real bound port.
+ */
+export const resolveListenPort = (
+  listenPort: number,
+  httpServer: {
+    address: () => ReturnType<import('node:net').Server['address']>;
+  } | null,
+): number => {
+  if (listenPort) {
+    return listenPort;
+  }
+  const addr = httpServer?.address();
+  if (addr && typeof addr === 'object') {
+    return addr.port;
+  }
+  return listenPort;
+};
+
 export const createBrowserLazyCompilationConfig = (
   setupFiles: string[],
 ): BrowserLazyCompilationConfig => {
@@ -543,11 +566,12 @@ export const createBrowserLazyCompilationConfig = (
   };
 };
 
-export const createBrowserRsbuildDevConfig = (isWatchMode: boolean) => {
+export const createBrowserRsbuildDevConfig = (_isWatchMode: boolean) => {
   return {
-    // Disable HMR in non-watch mode (tests run once and exit).
-    // Aligns with node mode behavior (packages/core/src/core/rsbuild.ts).
-    hmr: isWatchMode,
+    writeToDisk: isDebug(),
+    // Keep HMR enabled in browser mode even for one-shot runs.
+    // lazyCompilation depends on HMR runtime wiring for async import chains.
+    hmr: true,
     client: {
       logLevel: 'error' as const,
     },
@@ -1389,6 +1413,18 @@ const createBrowserRuntime = async ({
     getPortSilently: true,
   });
 
+  if (isDebug()) {
+    await rsbuildInstance.inspectConfig({
+      writeToDisk: true,
+      extraConfigs: {
+        rstest: {
+          ...context.normalizedConfig,
+          projects: browserProjects.map((p) => p.normalizedConfig),
+        },
+      },
+    });
+  }
+
   // Serve prebuilt container assets (SPA) via sirv
   const serveContainer = containerDistPath
     ? sirv(containerDistPath, {
@@ -1537,7 +1573,8 @@ const createBrowserRuntime = async ({
     },
   );
 
-  const { port } = await devServer.listen();
+  const { port: listenPort } = await devServer.listen();
+  const port = resolveListenPort(listenPort, devServer.httpServer);
 
   // Create WebSocket server on an available port
   // Using port: 0 lets the OS assign an available port, avoiding conflicts
@@ -1574,10 +1611,10 @@ const createBrowserRuntime = async ({
       dispatchHandlers,
       wss,
     };
-  } catch (_error) {
+  } catch (error) {
     wss.close();
     await devServer.close();
-    throw _error;
+    throw error;
   }
 };
 
@@ -1831,14 +1868,15 @@ export const runBrowserController = async (
 
   const isWatchMode = context.command === 'watch';
   const enableCliShortcuts = isWatchMode && isBrowserWatchCliShortcutsEnabled();
+  const browserTempOutputRoot = context.normalizedConfig.output.distPath.root;
   const tempDir =
     isWatchMode && watchContext.runtime
       ? watchContext.runtime.tempDir
       : isWatchMode
-        ? join(context.rootPath, TEMP_RSTEST_OUTPUT_DIR, 'browser', 'watch')
+        ? join(context.rootPath, browserTempOutputRoot, 'browser', 'watch')
         : join(
             context.rootPath,
-            TEMP_RSTEST_OUTPUT_DIR,
+            browserTempOutputRoot,
             'browser',
             Date.now().toString(),
           );
@@ -3225,7 +3263,7 @@ export const listBrowserTests = async (
 
   const tempDir = join(
     context.rootPath,
-    TEMP_RSTEST_OUTPUT_DIR,
+    context.normalizedConfig.output.distPath.root,
     'browser',
     `list-${Date.now()}`,
   );

package/src/protocol.ts

@@ -9,12 +9,8 @@ import type { SnapshotUpdateState } from '@vitest/snapshot';
 
 export type {
   BrowserLocatorIR,
-  BrowserLocatorStep,
-  BrowserLocatorText,
   BrowserRpcRequest,
-  BrowserRpcResponse,
   SnapshotRpcRequest,
-  SnapshotRpcResponse,
 } from './rpcProtocol';
 export { validateBrowserRpcRequest } from './rpcProtocol';
 
@@ -166,11 +162,6 @@ export type BrowserDispatchResponse = {
   stale?: boolean;
 };
 
-export type BrowserDispatchResponseEnvelope = {
-  type: typeof DISPATCH_RESPONSE_TYPE;
-  payload: BrowserDispatchResponse;
-};
-
 export type BrowserDispatchHandler = (
   request: BrowserDispatchRequest,
 ) => Promise<unknown>;

package/src/rpcProtocol.ts

@@ -178,12 +178,6 @@ export const validateBrowserRpcRequest = (
   return request;
 };
 
-export type BrowserRpcResponse = {
-  id: string;
-  result?: unknown;
-  error?: string;
-};
-
 /**
  * Snapshot RPC request from runner iframe.
  * The container will forward these to the host via WebSocket RPC.
@@ -209,12 +203,3 @@ export type SnapshotRpcRequest =
       method: 'removeSnapshotFile';
       args: { filepath: string };
     };
-
-/**
- * Snapshot RPC response from container to runner iframe.
- */
-export type SnapshotRpcResponse = {
-  id: string;
-  result?: unknown;
-  error?: string;
-};

package/src/sessionRegistry.ts

@@ -1,6 +1,6 @@
 import type { BrowserProviderContext, BrowserProviderPage } from './providers';
 
-export type RunnerSessionRecord = {
+type RunnerSessionRecord = {
   id: string;
   testFile: string;
   projectName: string;

package/src/watchCliShortcuts.ts

@@ -70,7 +70,9 @@ export async function setupBrowserWatchCliShortcuts({
     try {
       process.stdin.setRawMode(false);
       process.stdin.pause();
-    } catch {}
+    } catch {
+      // do nothing
+    }
 
     process.stdin.off('keypress', handleKeypress);
   };

package/src/watchRerunPlanner.ts

@@ -1,7 +1,7 @@
 import { normalize } from 'pathe';
 import type { TestFileInfo } from './protocol';
 
-export type WatchPlannerProjectEntry = {
+type WatchPlannerProjectEntry = {
   project: {
     name: string;
   };
@@ -14,7 +14,7 @@ type WatchRerunPlannerInput = {
   affectedTestFiles: string[];
 };
 
-export type WatchRerunPlan = {
+type WatchRerunPlan = {
   currentTestFiles: TestFileInfo[];
   filesChanged: boolean;
   normalizedAffectedTestFiles: string[];

package/dist/browser-container/container-static/js/927.514b181bd2.js.LICENSE.txt

@@ -1 +0,0 @@
-/*! LICENSE: 927.514b181bd2.js.LICENSE.txt */