@rstest/browser 0.10.4 → 0.10.6

package/dist/browser-container/container-static/js/854.c59f71483d.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! LICENSE: 854.c59f71483d.js.LICENSE.txt */

package/dist/browser-container/container-static/js/{index.8fb1588e4a.js → index.fedc31dff3.js}

@@ -4,7 +4,7 @@
         1617 (e, t, s) {
             var l = s(9793);
             let r = "__rstest_dispatch_response__";
-            var o = s(619), a = s(5203), i = s(1499), n = s(405), c = s(7541);
+            var o = s(4472), a = s(6961), i = s(6194), n = s(405), c = s(7541);
             let d = (e)=>{
                 let { message: t } = e;
                 return (0, l.jsx)("div", {
@@ -15,7 +15,7 @@
                     })
                 });
             };
-            var u = s(4079), p = s(4198), h = s(3862), f = s(1529), x = s(1051);
+            var u = s(165), p = s(179), h = s(8753), f = s(184), x = s(5676);
             let m = (e, t)=>{
                 if (!t) return e;
                 let s = t.endsWith("/") ? t.slice(0, -1) : t;
@@ -32,7 +32,7 @@
                     }
                 }, "*"), fetch(`/__open-in-editor?file=${encodeURIComponent(e)}`).catch(()=>{});
             };
-            var j = s(4759), v = s(9119), y = s(6505), _ = s(1165), C = s(4172);
+            var j = s(1910), v = s(8366), y = s(4560), _ = s(4484), C = s(7527);
             let w = {
                 idle: {
                     label: "Idle",
@@ -78,7 +78,7 @@
                     })
                 }
             };
-            var k = s(5910), S = s(4625), F = s(1874), N = s(4776), A = s(2353), P = s(5502), M = s(5087), z = s(8231);
+            var k = s(4909), S = s(7602), F = s(3106), N = s(1725), A = s(9122), P = s(1687), M = s(7046), z = s(4668);
             let O = {
                 iPhoneSE: {
                     width: 375,
@@ -514,7 +514,7 @@
                     ]
                 });
             };
-            var D = s(3938);
+            var D = s(3401);
             let G = (e)=>{
                 let { className: t, style: s, direction: r = "horizontal", children: o, autoSaveId: a, ...i } = e, c = n.Children.toArray(o).filter((e)=>n.isValidElement(e) && e.type === Z), d = n.useCallback(()=>{
                     if (!a) return null;
@@ -567,7 +567,7 @@
                     children: t
                 });
             };
-            var L = s(8602), q = s(1572), H = s(3573);
+            var L = s(7795), q = s(7319), H = s(7752);
             let J = (e)=>(0, l.jsxs)("svg", {
                     xmlns: "http://www.w3.org/2000/svg",
                     fill: "none",
@@ -1585,7 +1585,7 @@
                     ]
                 });
             };
-            var X = s(7778), K = s(6946), Y = s(6765), Q = s(6822), ee = s(8946), et = s(9885);
+            var X = s(2524), K = s(4333), Y = s(3534), Q = s(5749), ee = s(1695), et = s(1255);
             let es = (0, n.memo)((e)=>{
                 let { counts: t, isRunning: s } = e, r = s && 0 === t.running;
                 return (0, l.jsx)("div", {
@@ -1725,7 +1725,7 @@
                     ]
                 });
             };
-            var er = s(7944), eo = s(5119), ea = s(9886), ei = s(640), en = s(7094);
+            var er = s(6530), eo = s(9790), ea = s(2741), ei = s(2669), en = s(6405);
             let ec = (e)=>`__project__${e}`, ed = (e, t)=>`${e}::suite::${t.join("::")}`, eu = (e, t)=>{
                 let s = e;
                 for(let e = 1; e <= t.length; e++)s = ed(s, t.slice(0, e));
@@ -3045,7 +3045,7 @@
     }, (o = self.rspackChunk_rstest_browser_ui = self.rspackChunk_rstest_browser_ui || []).forEach(r.bind(null, 0)), o.push = r.bind(null, o.push.bind(o));
     var c = n.O(void 0, [
         "783",
-        "3"
+        "854"
     ], ()=>n(1617));
     c = n.O(c);
 })();

package/dist/browser-container/index.html

@@ -12,7 +12,7 @@
     <script>
       window.__RSTEST_BROWSER_OPTIONS__ = __RSTEST_OPTIONS_PLACEHOLDER__;
     </script>
-  <script defer src="/container-static/js/lib-react.62b27a21db.js"></script><script defer src="/container-static/js/3.d3d6c6e4cf.js"></script><script defer src="/container-static/js/index.8fb1588e4a.js"></script><link href="/container-static/css/index.5c72297783.css" rel="stylesheet"></head>
+  <script defer src="/container-static/js/lib-react.62b27a21db.js"></script><script defer src="/container-static/js/854.c59f71483d.js"></script><script defer src="/container-static/js/index.fedc31dff3.js"></script><link href="/container-static/css/index.0521ff95b1.css" rel="stylesheet"></head>
   <body>
     <div id="root"></div>
   </body>

package/dist/browserRpcRegistry.d.ts

@@ -13,6 +13,5 @@
  *   toHaveValues
  * - Artifacts intentionally excluded for now: screenshot/toMatchScreenshot/
  *   trace/video
- */
-export declare const supportedLocatorActions: Set<string>;
+ */ export declare const supportedLocatorActions: Set<string>;
 export declare const supportedExpectElementMatchers: Set<string>;

package/dist/client/api.d.ts

@@ -1,3 +1,3 @@
 import { Locator, page, setTestIdAttribute } from './locator.js';
-export type { BrowserPage, BrowserSerializable, LocatorBlurOptions, LocatorCheckOptions, LocatorClickOptions, LocatorDblclickOptions, LocatorDispatchEventInit, LocatorFillOptions, LocatorFilterOptions, LocatorFocusOptions, LocatorGetByRoleOptions, LocatorHoverOptions, LocatorKeyboardModifier, LocatorMouseButton, LocatorPosition, LocatorPressOptions, LocatorScrollIntoViewIfNeededOptions, LocatorSelectOptionOptions, LocatorSetInputFilesOptions, LocatorTextOptions, LocatorWaitForOptions, } from './locator.js';
+export type { BrowserPage, BrowserSerializable, LocatorBlurOptions, LocatorCheckOptions, LocatorClickOptions, LocatorDblclickOptions, LocatorDispatchEventInit, LocatorFillOptions, LocatorFilterOptions, LocatorFocusOptions, LocatorGetByRoleOptions, LocatorHoverOptions, LocatorKeyboardModifier, LocatorMouseButton, LocatorPosition, LocatorPressOptions, LocatorScrollIntoViewIfNeededOptions, LocatorSelectOptionOptions, LocatorSetInputFilesOptions, LocatorTextOptions, LocatorWaitForOptions } from './locator.js';
 export { Locator, page, setTestIdAttribute };

package/dist/client/dispatchTransport.d.ts

@@ -9,8 +9,7 @@ export declare const createRequestId: (prefix: string) => string;
  * {@link sendRunnerLifecycle}, so the request id only needs to be unique — it is
  * produced by the shared {@link createRequestId} factory rather than a bespoke
  * per-runner counter.
- */
-export declare const createRunnerLifecycleRequest: (method: string, args: unknown) => BrowserDispatchRequest;
+ */ export declare const createRunnerLifecycleRequest: (method: string, args: unknown) => BrowserDispatchRequest;
 /**
  * Deliver a runner-lifecycle request fire-and-forget.
  *
@@ -18,9 +17,8 @@ export declare const createRunnerLifecycleRequest: (method: string, args: unknow
  * out: the host echoes a response but the runner ignores it. Failures surface
  * only through the optional `onError` hook (debug logging at the call site),
  * keeping the hot test loop non-blocking.
- */
-export declare const sendRunnerLifecycle: (request: BrowserDispatchRequest, onError?: (error: unknown) => void) => void;
-export declare const dispatchRpc: <T>({ requestId, request, timeoutMs, timeoutMessage, staleMessage, }: {
+ */ export declare const sendRunnerLifecycle: (request: BrowserDispatchRequest, onError?: (error: unknown) => void) => void;
+export declare const dispatchRpc: <T>({ requestId, request, timeoutMs, timeoutMessage, staleMessage }: {
     requestId: string;
     request: BrowserDispatchRequest;
     timeoutMs: number;

package/dist/client/locator.d.ts

@@ -120,6 +120,5 @@ export declare const isLocator: (value: unknown) => value is Locator;
  * Forwards to the host provider (e.g. Playwright `selectors.setTestIdAttribute()`).
  *
  * @default 'data-testid'
- */
-export declare const setTestIdAttribute: (attribute: string) => Promise<void>;
-export {};
+ */ export declare const setTestIdAttribute: (attribute: string) => Promise<void>;
+export { };

package/dist/concurrency.d.ts

@@ -1,5 +1,7 @@
 import { getNumCpus, parseWorkers } from '@rstest/core/internal/browser';
 import type { Rstest } from '@rstest/core/internal/browser';
+// Re-export the shared worker primitives so existing consumers (and unit tests
+// importing from `../src/concurrency`) keep a stable import surface.
 export { getNumCpus, parseWorkers };
 type HeadlessConcurrencyContext = Pick<Rstest, 'command'> & {
     normalizedConfig: {

package/dist/dispatchCapabilities.d.ts

@@ -30,5 +30,5 @@ type CreateHostDispatchRouterOptions = {
     extensionHandlers?: Map<string, BrowserDispatchHandler>;
     onDuplicateNamespace?: (namespace: string) => void;
 };
-export declare const createHostDispatchRouter: ({ routerOptions, runnerCallbacks, runSnapshotRpc, extensionHandlers, onDuplicateNamespace, }: CreateHostDispatchRouterOptions) => HostDispatchRouter;
-export {};
+export declare const createHostDispatchRouter: ({ routerOptions, runnerCallbacks, runSnapshotRpc, extensionHandlers, onDuplicateNamespace }: CreateHostDispatchRouterOptions) => HostDispatchRouter;
+export { };

package/dist/dispatchRouter.d.ts

@@ -7,8 +7,7 @@ type HostDispatchRouterOptions = {
 /**
  * Host-side routing layer for dispatch envelopes.
  * Capabilities are registered by namespace, while routing stays transport-agnostic.
- */
-export declare class HostDispatchRouter {
+ */ export declare class HostDispatchRouter {
     private handlers;
     private options;
     constructor(options?: HostDispatchRouterOptions);
@@ -17,4 +16,4 @@ export declare class HostDispatchRouter {
     has(namespace: string): boolean;
     dispatch(request: BrowserDispatchRequest): Promise<BrowserDispatchResponse>;
 }
-export {};
+export { };

package/dist/headedSerialTaskQueue.d.ts

@@ -1,9 +1,9 @@
 type HeadedSerialTask = () => Promise<void>;
+type HeadedSerialTaskQueue = {
+    enqueue: (task: HeadedSerialTask) => Promise<void>;
+};
 /**
  * Serializes headed browser file execution so only one task runs at a time.
  * The queue keeps draining even if an earlier task rejects.
- */
-export declare const createHeadedSerialTaskQueue: () => {
-    enqueue: (task: HeadedSerialTask) => Promise<void>;
-};
-export {};
+ */ export declare const createHeadedSerialTaskQueue: () => HeadedSerialTaskQueue;
+export { };

package/dist/headlessLatestRerunScheduler.d.ts

@@ -14,6 +14,5 @@ type HeadlessLatestRerunSchedulerOptions<TFile, TRun> = {
 /**
  * Latest-only rerun scheduler for headless watch mode.
  * Keeps only the newest pending payload and interrupts active run generations.
- */
-export declare const createHeadlessLatestRerunScheduler: <TFile, TRun>(options: HeadlessLatestRerunSchedulerOptions<TFile, TRun>) => HeadlessLatestRerunScheduler<TFile>;
-export {};
+ */ export declare const createHeadlessLatestRerunScheduler: <TFile, TRun>(options: HeadlessLatestRerunSchedulerOptions<TFile, TRun>) => HeadlessLatestRerunScheduler<TFile>;
+export { };

package/dist/headlessTransport.d.ts

@@ -7,6 +7,5 @@ type HeadlessRunnerTransportHandlers = {
 /**
  * Headless transport adapter.
  * This only binds page bridge functions and delegates all scheduling decisions upstream.
- */
-export declare const attachHeadlessRunnerTransport: (page: BrowserProviderPage, handlers: HeadlessRunnerTransportHandlers) => Promise<void>;
-export {};
+ */ export declare const attachHeadlessRunnerTransport: (page: BrowserProviderPage, handlers: HeadlessRunnerTransportHandlers) => Promise<void>;
+export { };

package/dist/hostController.d.ts

@@ -14,8 +14,7 @@ type BrowserLazyCompilationConfig = {
  * `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 declare const resolveListenPort: (listenPort: number, httpServer: {
+ */ export declare const resolveListenPort: (listenPort: number, httpServer: {
     address: () => ReturnType<import('node:net').Server['address']>;
 } | null) => number;
 export declare const createBrowserLazyCompilationConfig: (setupFiles: string[]) => BrowserLazyCompilationConfig;
@@ -26,13 +25,19 @@ export declare const createBrowserRsbuildDevConfig: (_isWatchMode: boolean) => {
         logLevel: 'error';
     };
 };
+export declare const createBrowserContextExcludeRegExp: (patterns: string[], projectRoot: string) => RegExp | null;
+// ============================================================================
+// Main Entry Point
+// ============================================================================
 export declare const runBrowserController: (context: RstestContext, options?: BrowserTestRunOptions) => Promise<BrowserTestRunResult | void>;
+// ============================================================================
+// List Browser Tests
+// ============================================================================
 /**
  * Result from collecting browser tests.
  * This is the return type for listBrowserTests, designed for future extraction
  * to a separate browser package.
- */
-export type ListBrowserTestsResult = {
+ */ export type ListBrowserTestsResult = {
     list: ListCommandResult[];
     close: () => Promise<void>;
 };
@@ -40,10 +45,9 @@ export type ListBrowserTestsResult = {
  * Collect test metadata from browser mode projects without running them.
  * This function creates a headless browser runtime, loads test files,
  * and collects their test structure (describe/test declarations).
- */
-export declare const listBrowserTests: (context: RstestContext, options?: {
+ */ export declare const listBrowserTests: (context: RstestContext, options?: {
     shardedEntries?: Map<string, {
         entries: Record<string, string>;
     }>;
 }) => Promise<ListBrowserTestsResult>;
-export {};
+export { };

package/dist/index.d.ts

@@ -4,4 +4,4 @@ import { type ListBrowserTestsResult } from './hostController.js';
 export { validateBrowserConfig };
 export declare function runBrowserTests(context: RstestContext, options?: BrowserTestRunOptions): Promise<BrowserTestRunResult | void>;
 export declare function listBrowserTests(context: RstestContext, options?: Pick<BrowserTestRunOptions, 'shardedEntries'>): Promise<ListBrowserTestsResult>;
-export type { BrowserTestRunOptions, BrowserTestRunResult, ListBrowserTestsResult, };
+export type { BrowserTestRunOptions, BrowserTestRunResult, ListBrowserTestsResult };

package/dist/index.js

@@ -3002,7 +3002,8 @@ const globToRegexp = (glob)=>{
     const regex = picomatch_default().makeRe(glob, {
         fastpaths: false,
         noglobstar: false,
-        bash: false
+        bash: false,
+        dot: true
     });
     if (!regex) throw new Error(`Invalid glob pattern: ${glob}`);
     if (!glob.startsWith('./')) return regex;
@@ -3022,20 +3023,76 @@ const globPatternsToRegExp = (patterns)=>{
     });
     return new RegExp(`(?:${regexParts.join('|')})$`);
 };
-const excludePatternsToRegExp = (patterns)=>{
-    const keywords = [];
-    for (const pattern of patterns){
-        const match = pattern.match(/\*\*\/\.?\{?([^/*{}]+(?:,[^/*{}]+)*)\}?\/?\*?\*?/);
-        if (match) {
-            const parts = match[1].split(',');
-            for (const part of parts){
-                const cleaned = part.replace(/^\./, '');
-                if (cleaned && !keywords.includes(cleaned)) keywords.push(cleaned);
-            }
+const REGEXP_SPECIAL_CHARACTERS = /[|\\{}()[\]^$+*?.]/g;
+const PATH_SEPARATOR_SOURCE = String.raw`[\\/]`;
+const WINDOWS_ABSOLUTE_PATH_SOURCE = String.raw`[A-Za-z]:[\\/]`;
+const escapeRegExp = (value)=>value.replace(REGEXP_SPECIAL_CHARACTERS, '\\$&');
+const normalizePathForRegExp = (value)=>normalize(value).replaceAll('\\', '/');
+const normalizeExcludePatternForRegExp = (value)=>value.startsWith('./') ? `./${normalizePathForRegExp(value.substring(2))}` : normalizePathForRegExp(value);
+const isAbsolutePatternForRegExp = (value)=>value.startsWith('/') || /^[A-Za-z]:\//.test(value);
+const isEscapedRegExpCharacter = (source, index)=>{
+    let backslashCount = 0;
+    for(let current = index - 1; current >= 0 && '\\' === source[current]; current--)backslashCount++;
+    return backslashCount % 2 === 1;
+};
+const replacePathSeparatorsInRegExpSource = (source)=>{
+    let result = '';
+    let inCharacterClass = false;
+    for(let index = 0; index < source.length; index++){
+        const character = source[index];
+        const isEscaped = isEscapedRegExpCharacter(source, index);
+        if ('[' === character && !isEscaped) inCharacterClass = true;
+        if (!inCharacterClass && '\\' === character && '/' === source[index + 1]) {
+            result += PATH_SEPARATOR_SOURCE;
+            index++;
+            continue;
         }
+        result += character;
+        if (']' === character && !isEscaped) inCharacterClass = false;
+    }
+    return result;
+};
+const createRelativeContextExcludeSource = (source, normalizedPattern)=>{
+    if (normalizedPattern.startsWith('./')) return source;
+    return normalizedPattern.startsWith('**/') ? `(?:(?:${source})|\\.(?:${source}))` : `(?:(?:${source})|\\.${PATH_SEPARATOR_SOURCE}(?:${source}))`;
+};
+const createProjectAbsoluteExcludeSource = (source, normalizedPattern)=>normalizedPattern.startsWith('./') || normalizedPattern.startsWith('**/') ? source : `${PATH_SEPARATOR_SOURCE}(?:${source})`;
+const excludePatternsToRegExpSources = (patterns)=>{
+    const sources = patterns.map((pattern)=>{
+        const normalizedPattern = normalizeExcludePatternForRegExp(pattern);
+        const regex = globToRegexp(normalizedPattern);
+        let source = regex.source;
+        if (source.startsWith('^')) source = source.substring(1);
+        if (source.endsWith('$')) source = source.substring(0, source.length - 1);
+        source = replacePathSeparatorsInRegExpSource(source);
+        const isAbsolute = isAbsolutePatternForRegExp(normalizedPattern);
+        const absolute = normalizedPattern.startsWith('./') ? source.substring(2) : source;
+        return {
+            relative: isAbsolute ? source : createRelativeContextExcludeSource(source, normalizedPattern),
+            absolute: isAbsolute ? absolute : createProjectAbsoluteExcludeSource(absolute, normalizedPattern),
+            isAbsolute
+        };
+    });
+    if (0 === sources.length) return null;
+    return sources;
+};
+const createBrowserContextExcludeRegExp = (patterns, projectRoot)=>{
+    const excludeSources = excludePatternsToRegExpSources(patterns);
+    if (!excludeSources) return null;
+    const normalizedProjectRoot = normalizePathForRegExp(projectRoot).replace(/[\\/]$/, '');
+    const projectRootSource = normalizedProjectRoot.split('/').map(escapeRegExp).join(PATH_SEPARATOR_SOURCE);
+    const relativeExcludeSources = excludeSources.filter((source)=>!source.isAbsolute);
+    const absoluteExcludeSources = excludeSources.filter((source)=>source.isAbsolute);
+    const sourceBranches = [];
+    if (relativeExcludeSources.length > 0) {
+        const relativePatternSource = `(?:${relativeExcludeSources.map((source)=>source.relative).join('|')})`;
+        const absolutePatternSource = `(?:${relativeExcludeSources.map((source)=>source.absolute).join('|')})`;
+        const relativeSource = `(?:${relativePatternSource})`;
+        const absoluteSource = normalizedProjectRoot ? `${projectRootSource}(?=${PATH_SEPARATOR_SOURCE})(?:${absolutePatternSource})` : `(?:${absolutePatternSource})`;
+        sourceBranches.push(`(?!${WINDOWS_ABSOLUTE_PATH_SOURCE}|${PATH_SEPARATOR_SOURCE})${relativeSource}`, absoluteSource);
     }
-    if (0 === keywords.length) return null;
-    return new RegExp(`[\\\\/](${keywords.join('|')})[\\\\/]`);
+    if (absoluteExcludeSources.length > 0) sourceBranches.push(`(?:${absoluteExcludeSources.map((source)=>source.relative).join('|')})`);
+    return new RegExp(`^(?:${sourceBranches.join('|')})$`);
 };
 const findTestFileInModules = (modules, entryTestFiles)=>{
     if (!modules) return null;
@@ -3211,7 +3268,7 @@ const generateManifestModule = ({ manifestPath, entries })=>{
         const projectRootPosix = normalize(project.rootPath);
         const includeRegExp = globPatternsToRegExp(project.normalizedConfig.include);
         const excludePatterns = project.normalizedConfig.exclude.patterns;
-        const excludeRegExp = excludePatternsToRegExp(excludePatterns);
+        const excludeRegExp = createBrowserContextExcludeRegExp(excludePatterns, projectRootPosix);
         lines.push(`const ${varName} = import.meta.webpackContext(${JSON.stringify(projectRootPosix)}, {`);
         lines.push('  recursive: true,');
         lines.push(`  regExp: ${includeRegExp.toString()},`);

package/dist/protocol.d.ts

@@ -1,18 +1,21 @@
 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, SnapshotRpcCall, SnapshotRpcMethod, SnapshotRpcMethodArgs, 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;
+// `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;
@@ -24,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;
 };
@@ -33,16 +35,14 @@ 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 = {
+ */ export type BrowserLogPayload = {
     level: 'log' | 'warn' | 'error' | 'info' | 'debug';
     content: string;
     taskId?: string;
@@ -61,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';
@@ -131,33 +125,36 @@ export type BrowserClientMessage = {
  * {@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';
+ */ 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'>;
+ */ 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;
+ */ 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;
@@ -167,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

@@ -19,10 +19,8 @@ import type { BrowserRpcRequest } from '../rpcProtocol.js';
  * (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 = {
+ */ export type { BrowserProvider };
+/** Minimal console shape needed by host logging bridge. */ export type BrowserConsoleMessage = {
     text: () => string;
 };
 /**
@@ -34,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: {
@@ -67,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;
@@ -90,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;