@rstest/browser 0.10.3 → 0.10.5

package/dist/protocol.d.ts

@@ -1,22 +1,22 @@
-import type { DevicePreset } from '@rstest/core/browser';
-import type { RuntimeConfig, TestFileResult, TestInfo, TestResult } from '@rstest/core/browser-runtime';
+import type { BrowserViewport } from '@rstest/core/internal/browser';
+import type { RuntimeConfig, TestFileResult, TestInfo, TestResult } from '@rstest/core/internal/browser-runtime';
 import type { SnapshotUpdateState } from '@vitest/snapshot';
-export type { BrowserLocatorIR, BrowserRpcRequest, SnapshotRpcRequest, } from './rpcProtocol.js';
+export type { BrowserLocatorIR, BrowserRpcRequest, SnapshotRpcCall, SnapshotRpcMethod, SnapshotRpcMethodArgs, SnapshotRpcRequest } from './rpcProtocol.js';
 export { validateBrowserRpcRequest } from './rpcProtocol.js';
-export declare const DISPATCH_MESSAGE_TYPE = "__rstest_dispatch__";
-export declare const DISPATCH_RESPONSE_TYPE = "__rstest_dispatch_response__";
-export declare const DISPATCH_RPC_BRIDGE_NAME = "__rstest_dispatch_rpc__";
-export declare const DISPATCH_RPC_REQUEST_TYPE = "dispatch-rpc-request";
-export declare const RSTEST_CONFIG_MESSAGE_TYPE = "RSTEST_CONFIG";
-export declare const DISPATCH_NAMESPACE_RUNNER = "runner";
-export declare const DISPATCH_NAMESPACE_BROWSER = "browser";
-export declare const DISPATCH_NAMESPACE_SNAPSHOT = "snapshot";
-export declare const DISPATCH_METHOD_RPC = "rpc";
+export declare const DISPATCH_MESSAGE_TYPE = '__rstest_dispatch__';
+export declare const DISPATCH_RESPONSE_TYPE = '__rstest_dispatch_response__';
+export declare const DISPATCH_RPC_BRIDGE_NAME = '__rstest_dispatch_rpc__';
+export declare const DISPATCH_RPC_REQUEST_TYPE = 'dispatch-rpc-request';
+export declare const RSTEST_CONFIG_MESSAGE_TYPE = 'RSTEST_CONFIG';
+export declare const DISPATCH_NAMESPACE_RUNNER = 'runner';
+export declare const DISPATCH_NAMESPACE_BROWSER = 'browser';
+export declare const DISPATCH_NAMESPACE_SNAPSHOT = 'snapshot';
+export declare const DISPATCH_METHOD_RPC = 'rpc';
 export type SerializedRuntimeConfig = RuntimeConfig;
-export type BrowserViewport = {
-    width: number;
-    height: number;
-} | DevicePreset;
+// `BrowserViewport` is a core config type (`@rstest/core` owns the canonical
+// definition used by `NormalizedBrowserModeConfig`). Re-export it so the host
+// assigns the SAME type across the seam instead of a hand-copied duplicate.
+export type { BrowserViewport };
 export type BrowserProjectRuntime = {
     name: string;
     environmentName: string;
@@ -27,8 +27,7 @@ export type BrowserProjectRuntime = {
 /**
  * Test file info with associated project name.
  * Used to track which project a test file belongs to.
- */
-export type TestFileInfo = {
+ */ export type TestFileInfo = {
     testPath: string;
     projectName: string;
 };
@@ -36,8 +35,24 @@ export type TestFileInfo = {
  * Execution mode for browser tests.
  * - 'run': Execute tests and report results (default)
  * - 'collect': Only collect test metadata without running
- */
-export type BrowserExecutionMode = 'run' | 'collect';
+ */ export type BrowserExecutionMode = 'run' | 'collect';
+/**
+ * Wire shape of a `log` client message payload. The host receives this and maps
+ * it onto core's {@link UserConsoleLog} (notably `level` → `name`); that mapper
+ * (`hostController.ts` `handleLog`) annotates its result as `UserConsoleLog`, so
+ * the map→core direction is compiler-checked. Owning the wire shape here as one
+ * named type keeps the host's input type from drifting away from the producer.
+ */ export type BrowserLogPayload = {
+    level: 'log' | 'warn' | 'error' | 'info' | 'debug';
+    content: string;
+    taskId?: string;
+    taskName?: string;
+    taskParentNames?: string[];
+    taskType?: 'file' | 'suite' | 'case';
+    testPath: string;
+    type: 'stdout' | 'stderr';
+    trace?: string;
+};
 export type BrowserHostConfig = {
     rootPath: string;
     projects: BrowserProjectRuntime[];
@@ -46,31 +61,25 @@ export type BrowserHostConfig = {
     };
     testFile?: string;
     /**
-     * Per-run identifier assigned by the container.
-     * Used by browser RPC calls to prevent stale requests from previous reruns.
-     */
-    runId?: string;
+   * Per-run identifier assigned by the container.
+   * Used by browser RPC calls to prevent stale requests from previous reruns.
+   */ runId?: string;
     /**
-     * Base URL for runner (iframe) pages.
-     */
-    runnerUrl?: string;
+   * Base URL for runner (iframe) pages.
+   */ runnerUrl?: string;
     /**
-     * WebSocket port for container RPC.
-     */
-    wsPort?: number;
+   * WebSocket port for container RPC.
+   */ wsPort?: number;
     /**
-     * Execution mode. Defaults to 'run'.
-     */
-    mode?: BrowserExecutionMode;
+   * Execution mode. Defaults to 'run'.
+   */ mode?: BrowserExecutionMode;
     /**
-     * Debug mode. When true, enables verbose logging in browser.
-     */
-    debug?: boolean;
+   * Debug mode. When true, enables verbose logging in browser.
+   */ debug?: boolean;
     /**
-     * Timeout for RPC operations in milliseconds (e.g., snapshot file operations).
-     * Derived from testTimeout config.
-     */
-    rpcTimeout?: number;
+   * Timeout for RPC operations in milliseconds (e.g., snapshot file operations).
+   * Derived from testTimeout config.
+   */ rpcTimeout?: number;
 };
 export type BrowserClientMessage = {
     type: 'ready';
@@ -88,17 +97,7 @@ export type BrowserClientMessage = {
     payload: TestFileResult;
 } | {
     type: 'log';
-    payload: {
-        level: 'log' | 'warn' | 'error' | 'info' | 'debug';
-        content: string;
-        taskId?: string;
-        taskName?: string;
-        taskParentNames?: string[];
-        taskType?: 'file' | 'suite' | 'case';
-        testPath: string;
-        type: 'stdout' | 'stderr';
-        trace?: string;
-    };
+    payload: BrowserLogPayload;
 } | {
     type: 'fatal';
     payload: {
@@ -120,17 +119,42 @@ export type BrowserClientMessage = {
     type: typeof DISPATCH_RPC_REQUEST_TYPE;
     payload: BrowserDispatchRequest;
 };
+/**
+ * Lifecycle methods the runner emits via `dispatchRunnerLifecycle()` as
+ * dispatch-rpc-requests on the `runner` namespace (as opposed to the
+ * {@link BrowserClientMessage} types it `send()`s). The runner client imports
+ * this instead of redeclaring the list, so the emit site cannot drift from the
+ * host router.
+ */ export type RunnerLifecycleMethod = 'file-ready' | 'suite-start' | 'suite-result' | 'case-start';
+/**
+ * {@link BrowserClientMessage} types that are forwarded to the `runner`
+ * namespace (by message `type`) rather than handled at the transport layer.
+ * `Extract` keeps this a checked subset of the message union — renaming a
+ * message type drops it here, surfacing as a missing handler downstream.
+ */ type RunnerMessageMethod = Extract<BrowserClientMessage['type'], 'file-start' | 'case-result' | 'file-complete' | 'log' | 'fatal'>;
+/**
+ * Single source of truth for every method handled by the `runner` dispatch
+ * namespace. The host handler table is keyed by this union (a missing key is a
+ * compile error), so adding a runner method here forces a matching handler and
+ * cannot silently no-op at runtime.
+ */ export type RunnerDispatchMethod = RunnerLifecycleMethod | RunnerMessageMethod;
 /**
  * Transport-agnostic envelope used by host routing.
  * `namespace + method + args + target` describes an operation independent of
  * the underlying message channel, and `runToken` provides run-level isolation.
- */
-export type BrowserDispatchRequest = {
+ */ export type BrowserDispatchRequest = {
     requestId: string;
+    // Optional so headed/container paths can adopt the same envelope even when
+    // run-token isolation is only enforced in headless scheduling today.
     runToken?: number;
     namespace: string;
     method: string;
     args?: unknown;
+    // Routing reads `namespace`, `method`, `runToken`, and `target.sessionId`
+    // (see dispatchRouter.ts / dispatchBrowserRpcRequest). `target.testFile` and
+    // `target.projectName` are carried for diagnostics / forward-compatibility and
+    // are NOT consulted for routing today — adding a routing-relevant field here
+    // means wiring a reader on the host side, which structural typing won't force.
     target?: {
         testFile?: string;
         sessionId?: string;
@@ -140,8 +164,7 @@ export type BrowserDispatchRequest = {
 /**
  * Dispatch response envelope.
  * `stale: true` signals a safe drop from an older run generation, not a failure.
- */
-export type BrowserDispatchResponse = {
+ */ export type BrowserDispatchResponse = {
     requestId: string;
     runToken?: number;
     result?: unknown;

package/dist/providers/index.d.ts

@@ -1,3 +1,4 @@
+import type { BrowserProvider } from '@rstest/core/internal/browser';
 import type { BrowserRpcRequest } from '../rpcProtocol.js';
 /**
  * Browser provider contract hub.
@@ -12,10 +13,14 @@ import type { BrowserRpcRequest } from '../rpcProtocol.js';
  * - do not reference optional peer provider types from public declarations
  * - keep provider-specific behavior and config decoding inside provider implementations
  * - prefer direct passthrough to provider APIs over provider-specific translation
- */
-export type BrowserProvider = 'playwright';
-/** Minimal console shape needed by host logging bridge. */
-export type BrowserConsoleMessage = {
+ *
+ * The provider-name union is owned by `@rstest/core` (see `BROWSER_PROVIDERS`)
+ * because core's CLI `init` templates need it but cannot import this package
+ * (peer-dependency direction). `providerImplementations` below is keyed by the
+ * re-exported union, so a provider added in core without an implementation here
+ * is a compile error.
+ */ export type { BrowserProvider };
+/** Minimal console shape needed by host logging bridge. */ export type BrowserConsoleMessage = {
     text: () => string;
 };
 /**
@@ -27,29 +32,26 @@ export type BrowserConsoleMessage = {
  * (e.g. WebDriver BiDi), consider pushing page-level orchestration (goto,
  * exposeFunction, addInitScript, event listeners) into provider-specific
  * implementations so hostController only calls high-level semantic methods.
- */
-export type BrowserProviderPage = {
+ */ export type BrowserProviderPage = {
     goto: (url: string, options?: {
         waitUntil?: 'load';
     }) => Promise<unknown>;
     exposeFunction: (name: string, fn: (...args: any[]) => any) => Promise<void>;
     addInitScript: (script: string) => Promise<void>;
     on: {
-        (event: 'popup', listener: (page: BrowserProviderPage) => void): void;
-        (event: 'console', listener: (message: BrowserConsoleMessage) => void): void;
+        (event: 'popup', listener: (page: BrowserProviderPage) => void) : void;
+        (event: 'console', listener: (message: BrowserConsoleMessage) => void) : void;
     };
     close: () => Promise<void>;
     [Symbol.asyncDispose]: () => Promise<void>;
 };
-/** Minimal browser context API surface required by hostController. */
-export type BrowserProviderContext = {
+/** Minimal browser context API surface required by hostController. */ export type BrowserProviderContext = {
     newPage: () => Promise<BrowserProviderPage>;
     on: (event: 'page', listener: (page: BrowserProviderPage) => void) => void;
     close: () => Promise<void>;
     [Symbol.asyncDispose]: () => Promise<void>;
 };
-/** Minimal browser API surface required by hostController. */
-export type BrowserProviderBrowser = {
+/** Minimal browser API surface required by hostController. */ export type BrowserProviderBrowser = {
     close: () => Promise<void>;
     [Symbol.asyncDispose]: () => Promise<void>;
     newContext: (options: {
@@ -60,18 +62,15 @@ export type BrowserProviderBrowser = {
         providerOptions?: Record<string, unknown>;
     }) => Promise<BrowserProviderContext>;
 };
-/** Provider launch result consumed by hostController. */
-export type BrowserProviderRuntime = {
+/** Provider launch result consumed by hostController. */ export type BrowserProviderRuntime = {
     browser: BrowserProviderBrowser;
 };
-/** Input contract for browser launch. */
-export type LaunchBrowserInput = {
+/** Input contract for browser launch. */ export type LaunchBrowserInput = {
     browserName: 'chromium' | 'firefox' | 'webkit';
     headless: boolean | undefined;
     providerOptions: Record<string, unknown>;
 };
-/** Input contract for provider-side browser RPC dispatch. */
-export type DispatchBrowserRpcInput = {
+/** Input contract for provider-side browser RPC dispatch. */ export type DispatchBrowserRpcInput = {
     containerPage?: BrowserProviderPage;
     runnerPage?: BrowserProviderPage;
     request: BrowserRpcRequest;
@@ -83,8 +82,7 @@ export type DispatchBrowserRpcInput = {
  * Any new built-in provider must:
  * - launch browser runtime for test execution
  * - execute browser RPC requests (locator actions + assertions)
- */
-export type BrowserProviderImplementation = {
+ */ export type BrowserProviderImplementation = {
     name: BrowserProvider;
     launchRuntime: (input: LaunchBrowserInput) => Promise<BrowserProviderRuntime>;
     dispatchRpc: (input: DispatchBrowserRpcInput) => Promise<unknown>;

package/dist/providers/playwright/dispatchBrowserRpc.d.ts

@@ -2,10 +2,12 @@
  * Contains adapted logic from Playwright matchers:
  * https://github.com/microsoft/playwright/blob/main/packages/playwright/src/matchers/matchers.ts
  * Copyright (c) Microsoft Corporation, Apache-2.0.
- */
-import type { Page } from 'playwright';
+ */ import type { Page } from 'playwright';
 import type { BrowserRpcRequest } from '../../rpcProtocol.js';
-export declare function dispatchPlaywrightBrowserRpc({ containerPage, runnerPage, request, timeoutFallbackMs, }: {
+// ---------------------------------------------------------------------------
+// Public entry
+// ---------------------------------------------------------------------------
+export declare function dispatchPlaywrightBrowserRpc({ containerPage, runnerPage, request, timeoutFallbackMs }: {
     containerPage?: Page;
     runnerPage?: Page;
     request: BrowserRpcRequest;

package/dist/providers/playwright/expectUtils.d.ts

@@ -2,8 +2,7 @@
  * Contains adapted logic from Playwright matchers:
  * https://github.com/microsoft/playwright/blob/main/packages/playwright/src/matchers/matchers.ts
  * Copyright (c) Microsoft Corporation, Apache-2.0.
- */
-import type { BrowserLocatorText } from '../../rpcProtocol.js';
+ */ import type { BrowserLocatorText } from '../../rpcProtocol.js';
 type ExpectedTextValue = {
     string?: string;
     regexSource?: string;
@@ -21,4 +20,4 @@ export declare const formatExpectError: (result: {
     errorMessage?: string;
     log?: string[];
 }) => string;
-export {};
+export { };

package/dist/providers/playwright/implementation.d.ts

@@ -1,2 +1,2 @@
-import type { BrowserProviderImplementation } from '../index.js';
+import type { BrowserProviderImplementation, BrowserProviderRuntime } from '../index.js';
 export declare const playwrightProviderImplementation: BrowserProviderImplementation;

package/dist/providers/playwright/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { BrowserProviderRuntime } from '../index.js';
-export declare function launchPlaywrightBrowser({ browserName, headless, providerOptions, }: {
+export declare function launchPlaywrightBrowser({ browserName, headless, providerOptions }: {
     browserName: 'chromium' | 'firefox' | 'webkit';
     headless: boolean | undefined;
     providerOptions: Record<string, unknown>;

package/dist/rpcProtocol.d.ts

@@ -83,50 +83,57 @@ export type BrowserLocatorIR = {
 };
 export type BrowserRpcRequest = {
     id: string;
-    /** Absolute test file path for locating runner iframe */
-    testPath: string;
-    /** Run identifier generated by container for stale-request protection. */
-    runId: string;
+    /** Absolute test file path for locating runner iframe */ testPath: string;
+    /** Run identifier generated by container for stale-request protection. */ runId: string;
     kind: 'locator' | 'expect' | 'config';
     locator: BrowserLocatorIR;
     method: string;
     args: unknown[];
     /**
-     * Negation for expect matchers (equivalent to Playwright expect(...).not).
-     * Only meaningful for kind === 'expect'.
-     */
-    isNot?: boolean;
-    /** Optional timeout override (ms). Falls back to browser rpcTimeout. */
-    timeout?: number;
+   * Negation for expect matchers (equivalent to Playwright expect(...).not).
+   * Only meaningful for kind === 'expect'.
+   */ isNot?: boolean;
+    /** Optional timeout override (ms). Falls back to browser rpcTimeout. */ timeout?: number;
 };
 export declare const validateBrowserRpcRequest: (payload: unknown) => BrowserRpcRequest;
 /**
- * Snapshot RPC request from runner iframe.
- * The container will forward these to the host via WebSocket RPC.
- */
-export type SnapshotRpcRequest = {
-    id: string;
-    method: 'resolveSnapshotPath';
-    args: {
+ * Single source of truth for snapshot RPC methods and their argument shapes.
+ * The request union, the client sender, both host-side mappers, and every
+ * exhaustiveness check derive from this map — adding or renaming a method here
+ * forces a compile error at every site that has not been updated.
+ */ export type SnapshotRpcMethodArgs = {
+    resolveSnapshotPath: {
         testPath: string;
     };
-} | {
-    id: string;
-    method: 'readSnapshotFile';
-    args: {
+    readSnapshotFile: {
         filepath: string;
     };
-} | {
-    id: string;
-    method: 'saveSnapshotFile';
-    args: {
+    saveSnapshotFile: {
         filepath: string;
         content: string;
     };
-} | {
-    id: string;
-    method: 'removeSnapshotFile';
-    args: {
+    removeSnapshotFile: {
         filepath: string;
     };
 };
+export type SnapshotRpcMethod = keyof SnapshotRpcMethodArgs;
+/**
+ * Snapshot RPC request from runner iframe.
+ * The container will forward these to the host via WebSocket RPC.
+ */ export type SnapshotRpcRequest = {
+    [M in SnapshotRpcMethod]: {
+        id: string;
+        method: M;
+        args: SnapshotRpcMethodArgs[M];
+    };
+}[SnapshotRpcMethod];
+/**
+ * Client-side snapshot RPC call (request without the transport `id`).
+ * Distributive over {@link SnapshotRpcMethod} so `method` and `args` stay paired
+ * at the call site — a mismatched pair fails to compile.
+ */ export type SnapshotRpcCall = {
+    [M in SnapshotRpcMethod]: {
+        method: M;
+        args: SnapshotRpcMethodArgs[M];
+    };
+}[SnapshotRpcMethod];

package/dist/runSession.d.ts

@@ -1,7 +1,6 @@
 /**
  * Run generation/session lifecycle contract shared by browser scheduling paths.
- */
-export type RunSession = {
+ */ export type RunSession = {
     token: number;
     cancelled: boolean;
     cancelSignal: Promise<void>;
@@ -16,8 +15,7 @@ type CancelOptions<T extends RunSession> = {
 /**
  * Canonical run-token lifecycle manager.
  * Centralizes token increment, invalidation, and cancellation semantics.
- */
-export declare class RunSessionLifecycle<T extends RunSession> {
+ */ export declare class RunSessionLifecycle<T extends RunSession> {
     private currentToken;
     private active;
     get activeSession(): T | null;
@@ -30,4 +28,4 @@ export declare class RunSessionLifecycle<T extends RunSession> {
     cancel(session: T, options?: CancelOptions<T>): Promise<void>;
     cancelActive(options?: CancelOptions<T>): Promise<void>;
 }
-export {};
+export { };

package/dist/sessionRegistry.d.ts

@@ -17,8 +17,7 @@ type RunnerSessionInput = Omit<RunnerSessionRecord, 'id' | 'createdAt'> & {
 /**
  * Execution target index for host scheduling.
  * Provides lookup by session id, test file, and run token without coupling to UI topology.
- */
-export declare class RunnerSessionRegistry {
+ */ export declare class RunnerSessionRegistry {
     private nextId;
     private sessionsById;
     private sessionIdByTestFile;
@@ -31,4 +30,4 @@ export declare class RunnerSessionRegistry {
     deleteByTestFile(testFile: string): boolean;
     clear(): void;
 }
-export {};
+export { };

package/dist/sourceMap/sourceMapLoader.d.ts

@@ -4,11 +4,11 @@ type Fetcher = typeof fetch;
 export declare const normalizeJavaScriptUrl: (value: string, options?: {
     origin?: string;
 }) => string | null;
-export declare const loadSourceMapWithCache: ({ jsUrl, cache, force, origin, fetcher, }: {
+export declare const loadSourceMapWithCache: ({ jsUrl, cache, force, origin, fetcher }: {
     jsUrl: string;
     cache: Map<string, SourceMapPayload | null>;
     force?: boolean;
     origin?: string;
     fetcher?: Fetcher;
 }) => Promise<SourceMapPayload | null>;
-export {};
+export { };

package/dist/viewportPresets.d.ts

@@ -4,8 +4,12 @@
  * IMPORTANT: Keep this list/map in sync with `DevicePreset` typing in
  * `@rstest/core` (`packages/core/src/types/config.ts`) so `defineConfig`
  * autocomplete and runtime validation stay consistent.
- */
-export declare const BROWSER_VIEWPORT_PRESET_IDS: readonly ['iPhoneSE', 'iPhoneXR', 'iPhone12Pro', 'iPhone14ProMax', 'Pixel7', 'SamsungGalaxyS8Plus', 'SamsungGalaxyS20Ultra', 'iPadMini', 'iPadAir', 'iPadPro', 'SurfacePro7', 'SurfaceDuo', 'GalaxyZFold5', 'AsusZenbookFold', 'SamsungGalaxyA51A71', 'NestHub', 'NestHubMax'];
+ *
+ * Upstream source of truth for ids/dimensions is the Chrome DevTools emulated
+ * device list — mirror each device's `screen.vertical` `{ width, height }`:
+ * https://github.com/ChromeDevTools/devtools-frontend/blob/main/front_end/models/emulation/EmulatedDevices.ts
+ * Last verified in sync (all 17): 2026-04-22, devtools-frontend commit abaac05e.
+ */ export declare const BROWSER_VIEWPORT_PRESET_IDS: readonly ['iPhoneSE', 'iPhoneXR', 'iPhone12Pro', 'iPhone14ProMax', 'Pixel7', 'SamsungGalaxyS8Plus', 'SamsungGalaxyS20Ultra', 'iPadMini', 'iPadAir', 'iPadPro', 'SurfacePro7', 'SurfaceDuo', 'GalaxyZFold5', 'AsusZenbookFold', 'SamsungGalaxyA51A71', 'NestHub', 'NestHubMax'];
 type BrowserViewportPresetId = (typeof BROWSER_VIEWPORT_PRESET_IDS)[number];
 type BrowserViewportSize = {
     width: number;
@@ -13,4 +17,4 @@ type BrowserViewportSize = {
 };
 export declare const BROWSER_VIEWPORT_PRESET_DIMENSIONS: Record<BrowserViewportPresetId, BrowserViewportSize>;
 export declare const resolveBrowserViewportPreset: (presetId: string) => BrowserViewportSize | null;
-export {};
+export { };

package/dist/watchCliShortcuts.d.ts

@@ -1,6 +1,6 @@
 export declare const isBrowserWatchCliShortcutsEnabled: () => boolean;
 export declare const getBrowserWatchCliShortcutsHintMessage: () => string;
 export declare const logBrowserWatchReadyMessage: (enableCliShortcuts: boolean) => void;
-export declare function setupBrowserWatchCliShortcuts({ close, }: {
+export declare function setupBrowserWatchCliShortcuts({ close }: {
     close: () => Promise<void>;
 }): Promise<() => void>;

package/dist/watchRerunPlanner.d.ts

@@ -17,5 +17,5 @@ type WatchRerunPlan = {
     affectedTestFiles: TestFileInfo[];
 };
 export declare const collectWatchTestFiles: (projectEntries: WatchPlannerProjectEntry[]) => TestFileInfo[];
-export declare const planWatchRerun: ({ projectEntries, previousTestFiles, affectedTestFiles, }: WatchRerunPlannerInput) => WatchRerunPlan;
-export {};
+export declare const planWatchRerun: ({ projectEntries, previousTestFiles, affectedTestFiles }: WatchRerunPlannerInput) => WatchRerunPlan;
+export { };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rstest/browser",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "description": "Browser mode support for Rstest testing framework.",
   "keywords": [
     "rstest",
@@ -14,7 +14,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/web-infra-dev/rstest",
+    "url": "git+https://github.com/web-infra-dev/rstest.git",
     "directory": "packages/browser"
   },
   "license": "MIT",
@@ -48,22 +48,21 @@
     "ws": "^8.21.0"
   },
   "devDependencies": {
-    "@rslib/core": "0.21.5",
+    "@rslib/core": "0.22.1",
     "@types/convert-source-map": "^2.0.3",
     "@types/picomatch": "^4.0.3",
     "@types/ws": "^8.18.1",
-    "@typescript/native-preview": "7.0.0-dev.20260527.1",
-    "@vitest/snapshot": "^3.2.4",
+    "@vitest/snapshot": "^3.2.6",
     "birpc": "^4.0.0",
     "picomatch": "^4.0.4",
     "playwright": "^1.60.0",
     "@rstest/browser-ui": "0.0.0",
-    "@rstest/core": "0.10.3",
+    "@rstest/core": "0.10.5",
     "@rstest/tsconfig": "0.0.1"
   },
   "peerDependencies": {
     "playwright": "^1.49.1",
-    "@rstest/core": "^0.10.3"
+    "@rstest/core": "^0.10.5"
   },
   "peerDependenciesMeta": {
     "playwright": {
@@ -79,7 +78,6 @@
   },
   "scripts": {
     "build": "rslib build",
-    "dev": "rslib build --watch",
-    "typecheck": "pnpm -w exec tsc --noEmit -p packages/browser/tsconfig.json"
+    "dev": "rslib build --watch"
   }
 }

package/src/AGENTS.md

@@ -15,6 +15,9 @@ flowchart LR
     SR["sessionRegistry.ts\nRunnerSessionRegistry"]
     WP["watchRerunPlanner.ts"]
     LS["headlessLatestRerunScheduler.ts"]
+    HT["headlessTransport.ts\nattachHeadlessRunnerTransport()"]
+    CC["concurrency.ts\ngetHeadlessConcurrency()"]
+    HQ["headedSerialTaskQueue.ts\ncreateHeadedSerialTaskQueue()"]
   end
 
   subgraph UI["@rstest/browser-ui container (headed path)"]
@@ -35,6 +38,9 @@ flowchart LR
   WP --> LS
   HC --> RL
   RL --> SR
+  HC --> CC
+  HC --> HQ
+  HC --> HT
 
   UR <--> HC
   MSG --> MH
@@ -42,7 +48,7 @@ flowchart LR
   RPC --> CH
   CH --> UR
 
-  HC -."headless bridge:\nexposeFunction(__rstest_dispatch__, __rstest_dispatch_rpc__)".-> Runner
+  HT -."headless bridge:\nexposeFunction(__rstest_dispatch__, __rstest_dispatch_rpc__)".-> Runner
 ```
 
 ## Headed transport path

package/src/browserRpcRegistry.ts

@@ -14,7 +14,7 @@
  * - Artifacts intentionally excluded for now: screenshot/toMatchScreenshot/
  *   trace/video
  */
-export const supportedLocatorActions = new Set<string>([
+export const supportedLocatorActions: Set<string> = new Set([
   'click',
   'dblclick',
   'fill',
@@ -32,7 +32,7 @@ export const supportedLocatorActions = new Set<string>([
   'setInputFiles',
 ]);
 
-export const supportedExpectElementMatchers = new Set<string>([
+export const supportedExpectElementMatchers: Set<string> = new Set([
   'toBeVisible',
   'toBeHidden',
   'toBeEnabled',