@rstest/browser 0.11.6 → 0.11.8

package/src/rpcProtocol.ts

@@ -1,218 +0,0 @@
-export type BrowserLocatorText =
-  | { type: 'string'; value: string }
-  | { type: 'regexp'; source: string; flags?: string };
-
-export type BrowserLocatorStep =
-  | {
-      type: 'getByRole';
-      role: string;
-      options?: {
-        name?: BrowserLocatorText;
-        exact?: boolean;
-        checked?: boolean;
-        disabled?: boolean;
-        expanded?: boolean;
-        selected?: boolean;
-        pressed?: boolean;
-        includeHidden?: boolean;
-        level?: number;
-      };
-    }
-  | {
-      type: 'locator';
-      selector: string;
-    }
-  | {
-      type: 'getByText';
-      text: BrowserLocatorText;
-      options?: { exact?: boolean };
-    }
-  | {
-      type: 'getByLabel';
-      text: BrowserLocatorText;
-      options?: { exact?: boolean };
-    }
-  | {
-      type: 'getByPlaceholder';
-      text: BrowserLocatorText;
-      options?: { exact?: boolean };
-    }
-  | {
-      type: 'getByAltText';
-      text: BrowserLocatorText;
-      options?: { exact?: boolean };
-    }
-  | {
-      type: 'getByTitle';
-      text: BrowserLocatorText;
-      options?: { exact?: boolean };
-    }
-  | {
-      type: 'getByTestId';
-      text: BrowserLocatorText;
-    }
-  | {
-      type: 'filter';
-      options: {
-        hasText?: BrowserLocatorText;
-        hasNotText?: BrowserLocatorText;
-        has?: BrowserLocatorIR;
-        hasNot?: BrowserLocatorIR;
-      };
-    }
-  | { type: 'and'; locator: BrowserLocatorIR }
-  | { type: 'or'; locator: BrowserLocatorIR }
-  | { type: 'nth'; index: number }
-  | { type: 'first' }
-  | { type: 'last' };
-
-export type BrowserLocatorIR = {
-  steps: BrowserLocatorStep[];
-};
-
-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;
-  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;
-};
-
-const isRecord = (value: unknown): value is Record<string, unknown> => {
-  return typeof value === 'object' && value !== null;
-};
-
-const readString = (
-  value: Record<string, unknown>,
-  key: string,
-  label: string,
-): string => {
-  const result = value[key];
-  if (typeof result !== 'string') {
-    throw new Error(`Invalid browser RPC request: ${label} must be a string`);
-  }
-  return result;
-};
-
-const readUnknownArray = (
-  value: Record<string, unknown>,
-  key: string,
-  label: string,
-): unknown[] => {
-  const result = value[key];
-  if (!Array.isArray(result)) {
-    throw new Error(`Invalid browser RPC request: ${label} must be an array`);
-  }
-  return result;
-};
-
-const parseBrowserLocatorIR = (
-  value: unknown,
-  label: string,
-): BrowserLocatorIR => {
-  if (!isRecord(value)) {
-    throw new Error(`Invalid browser RPC request: ${label} must be an object`);
-  }
-
-  const steps = value.steps;
-  if (!Array.isArray(steps)) {
-    throw new Error(
-      `Invalid browser RPC request: ${label}.steps must be an array`,
-    );
-  }
-
-  return value as BrowserLocatorIR;
-};
-
-export const validateBrowserRpcRequest = (
-  payload: unknown,
-): BrowserRpcRequest => {
-  if (!isRecord(payload)) {
-    throw new Error('Invalid browser RPC request: payload must be an object');
-  }
-
-  const kind = readString(payload, 'kind', 'kind');
-  if (kind !== 'locator' && kind !== 'expect' && kind !== 'config') {
-    throw new Error(
-      `Invalid browser RPC request: unsupported kind ${JSON.stringify(kind)}`,
-    );
-  }
-
-  const request: BrowserRpcRequest = {
-    id: readString(payload, 'id', 'id'),
-    testPath: readString(payload, 'testPath', 'testPath'),
-    runId: readString(payload, 'runId', 'runId'),
-    kind,
-    locator: parseBrowserLocatorIR(payload.locator, 'locator'),
-    method: readString(payload, 'method', 'method'),
-    args: readUnknownArray(payload, 'args', 'args'),
-  };
-
-  const isNot = payload.isNot;
-  if (isNot !== undefined) {
-    if (typeof isNot !== 'boolean') {
-      throw new Error('Invalid browser RPC request: isNot must be a boolean');
-    }
-    request.isNot = isNot;
-  }
-
-  const timeout = payload.timeout;
-  if (timeout !== undefined) {
-    if (typeof timeout !== 'number') {
-      throw new Error('Invalid browser RPC request: timeout must be a number');
-    }
-    request.timeout = timeout;
-  }
-
-  return request;
-};
-
-/**
- * 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 };
-  readSnapshotFile: { filepath: string };
-  saveSnapshotFile: { filepath: string; content: string };
-  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/src/runSession.ts

@@ -1,110 +0,0 @@
-/**
- * Run generation/session lifecycle contract shared by browser scheduling paths.
- */
-export type RunSession = {
-  token: number;
-  cancelled: boolean;
-  cancelSignal: Promise<void>;
-  signalCancel: () => void;
-  done?: Promise<void>;
-};
-
-const createCancelSignal = (): {
-  signal: Promise<void>;
-  resolve: () => void;
-} => {
-  let settled = false;
-  let resolveSignal: () => void = () => {};
-
-  const signal = new Promise<void>((resolve) => {
-    resolveSignal = () => {
-      if (!settled) {
-        settled = true;
-        resolve();
-      }
-    };
-  });
-
-  return {
-    signal,
-    resolve: resolveSignal,
-  };
-};
-
-export const createRunSession = (token: number): RunSession => {
-  const { signal, resolve } = createCancelSignal();
-  return {
-    token,
-    cancelled: false,
-    cancelSignal: signal,
-    signalCancel: resolve,
-  };
-};
-
-type CancelOptions<T extends RunSession> = {
-  waitForDone?: boolean;
-  onCancel?: (session: T) => Promise<void> | void;
-};
-
-/**
- * Canonical run-token lifecycle manager.
- * Centralizes token increment, invalidation, and cancellation semantics.
- */
-export class RunSessionLifecycle<T extends RunSession> {
-  private currentToken = 0;
-  private active: T | null = null;
-
-  get activeSession(): T | null {
-    return this.active;
-  }
-
-  get activeToken(): number {
-    return this.currentToken;
-  }
-
-  createSession(factory: (token: number) => T): T {
-    const session = factory(++this.currentToken);
-    this.active = session;
-    return session;
-  }
-
-  isTokenActive(token: number): boolean {
-    return token === this.currentToken;
-  }
-
-  isTokenStale(token: number): boolean {
-    return !this.isTokenActive(token);
-  }
-
-  invalidateActiveToken(): number {
-    this.currentToken += 1;
-    return this.currentToken;
-  }
-
-  clearIfActive(session: T): void {
-    if (this.active === session) {
-      this.active = null;
-    }
-  }
-
-  async cancel(session: T, options?: CancelOptions<T>): Promise<void> {
-    const waitForDone = options?.waitForDone ?? true;
-
-    if (!session.cancelled) {
-      session.cancelled = true;
-      session.signalCancel();
-      await options?.onCancel?.(session);
-    }
-
-    if (waitForDone) {
-      await session.done?.catch(() => {});
-    }
-  }
-
-  async cancelActive(options?: CancelOptions<T>): Promise<void> {
-    if (!this.active) {
-      return;
-    }
-    await this.cancel(this.active, options);
-  }
-}

package/src/schedulerSeam.ts

@@ -1,49 +0,0 @@
-import type { ExecutorCycleOutcome } from '@rstest/core/internal/browser';
-import type { BrowserDispatchRequest } from './protocol';
-import type { BrowserProviderPage } from './providers';
-
-/**
- * The contract between the controller and whichever run branch executes a run.
- * It lives outside both so the schedulers never reach back into the controller
- * for a type: the controller owns the run's shape, the schedulers own the run.
- */
-
-/**
- * The watch-session control surface a watch-mode controller run hands back with
- * its initial cycle. Every rerun trigger the host owns (dev rebuild, HMR, the
- * in-page rerun button) resolves its own scope and then signals core's
- * invalidation subscriber; core resets the cycle state and calls back into
- * {@link BrowserWatchSession.runCycle} to execute it. A trigger that resolves to
- * no work never signals, so a scope matching none of this host's files produces
- * no cycle and no cycle output.
- */
-export type BrowserWatchSession = {
-  /** Execute the scope the last trigger resolved, as one cycle outcome. */
-  runCycle: (testPaths: string[]) => Promise<ExecutorCycleOutcome>;
-  /** Explicit path-scoped rerun request (a CLI shortcut's browser fanout). */
-  requestRerun: (testPaths?: string[]) => Promise<void>;
-};
-
-/**
- * What a run branch produces. Results and errors accumulate in the sinks the
- * controller owns, so a scheduler reports only what it alone knows: how long
- * the tests took, the session it left behind, and how to tear down a runtime
- * that does not outlive the run.
- */
-export type SchedulerRunResult = {
-  testTime: number;
-  watchSession?: BrowserWatchSession;
-  close?: () => Promise<void>;
-};
-
-/**
- * How the shared dispatch layer reaches the pages of whichever run branch is
- * live. Only the running branch knows its pages, so it installs the resolver
- * and the dispatch layer stays branch-agnostic.
- */
-export type DispatchPageResolver = (
-  target?: BrowserDispatchRequest['target'],
-) => {
-  runnerPage?: BrowserProviderPage;
-  containerPage?: BrowserProviderPage;
-};

package/src/sessionRegistry.ts

@@ -1,89 +0,0 @@
-import type { BrowserProviderContext, BrowserProviderPage } from './providers';
-
-type RunnerSessionRecord = {
-  id: string;
-  testFile: string;
-  projectName: string;
-  runToken: number;
-  mode: 'headless-page' | 'headed-iframe';
-  createdAt: number;
-  context?: BrowserProviderContext;
-  page?: BrowserProviderPage;
-  metadata?: Record<string, unknown>;
-};
-
-type RunnerSessionInput = Omit<RunnerSessionRecord, 'id' | 'createdAt'> & {
-  id?: string;
-  createdAt?: number;
-};
-
-/**
- * Execution target index for host scheduling.
- * Provides lookup by session id, test file, and run token without coupling to UI topology.
- */
-export class RunnerSessionRegistry {
-  private nextId = 0;
-  private sessionsById = new Map<string, RunnerSessionRecord>();
-  private sessionIdByTestFile = new Map<string, string>();
-
-  register(input: RunnerSessionInput): RunnerSessionRecord {
-    const id = input.id ?? `runner-session-${++this.nextId}`;
-    const createdAt = input.createdAt ?? Date.now();
-
-    const record: RunnerSessionRecord = {
-      ...input,
-      id,
-      createdAt,
-    };
-
-    this.sessionsById.set(id, record);
-    this.sessionIdByTestFile.set(record.testFile, id);
-    return record;
-  }
-
-  getById(id: string): RunnerSessionRecord | undefined {
-    return this.sessionsById.get(id);
-  }
-
-  getByTestFile(testFile: string): RunnerSessionRecord | undefined {
-    const id = this.sessionIdByTestFile.get(testFile);
-    if (!id) {
-      return undefined;
-    }
-    return this.sessionsById.get(id);
-  }
-
-  list(): RunnerSessionRecord[] {
-    return Array.from(this.sessionsById.values());
-  }
-
-  listByRunToken(runToken: number): RunnerSessionRecord[] {
-    return this.list().filter((session) => session.runToken === runToken);
-  }
-
-  deleteById(id: string): boolean {
-    const record = this.sessionsById.get(id);
-    if (!record) {
-      return false;
-    }
-
-    this.sessionsById.delete(id);
-    if (this.sessionIdByTestFile.get(record.testFile) === id) {
-      this.sessionIdByTestFile.delete(record.testFile);
-    }
-    return true;
-  }
-
-  deleteByTestFile(testFile: string): boolean {
-    const id = this.sessionIdByTestFile.get(testFile);
-    if (!id) {
-      return false;
-    }
-    return this.deleteById(id);
-  }
-
-  clear(): void {
-    this.sessionsById.clear();
-    this.sessionIdByTestFile.clear();
-  }
-}

package/src/sourceMap/sourceMapLoader.ts

@@ -1,96 +0,0 @@
-import type {
-  DecodedSourceMapXInput,
-  EncodedSourceMapXInput,
-} from '@jridgewell/trace-mapping';
-import convert from 'convert-source-map';
-
-export type SourceMapPayload = EncodedSourceMapXInput | DecodedSourceMapXInput;
-
-type Fetcher = typeof fetch;
-
-export const normalizeJavaScriptUrl = (
-  value: string,
-  options?: {
-    origin?: string;
-  },
-): string | null => {
-  try {
-    const url = options?.origin
-      ? new URL(value, options.origin)
-      : new URL(value);
-
-    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
-      return null;
-    }
-
-    url.search = '';
-    url.hash = '';
-    return url.toString();
-  } catch {
-    return null;
-  }
-};
-
-const resolveInlineSourceMap = (code: string): SourceMapPayload | null => {
-  const converter = convert.fromSource(code);
-  if (!converter) {
-    return null;
-  }
-
-  return converter.toObject() as SourceMapPayload;
-};
-
-const fetchSourceMap = async (
-  jsUrl: string,
-  fetcher: Fetcher,
-): Promise<SourceMapPayload | null> => {
-  const jsResponse = await fetcher(jsUrl);
-  if (!jsResponse.ok) {
-    return null;
-  }
-
-  const code = await jsResponse.text();
-  const inlineMap = resolveInlineSourceMap(code);
-  if (inlineMap) {
-    return inlineMap;
-  }
-
-  const mapResponse = await fetcher(`${jsUrl}.map`);
-  if (!mapResponse.ok) {
-    return null;
-  }
-
-  return (await mapResponse.json()) as SourceMapPayload;
-};
-
-export const loadSourceMapWithCache = async ({
-  jsUrl,
-  cache,
-  force = false,
-  origin,
-  fetcher = fetch,
-}: {
-  jsUrl: string;
-  cache: Map<string, SourceMapPayload | null>;
-  force?: boolean;
-  origin?: string;
-  fetcher?: Fetcher;
-}): Promise<SourceMapPayload | null> => {
-  const normalizedUrl = normalizeJavaScriptUrl(jsUrl, { origin });
-  if (!normalizedUrl) {
-    return null;
-  }
-
-  if (!force && cache.has(normalizedUrl)) {
-    return cache.get(normalizedUrl) ?? null;
-  }
-
-  try {
-    const sourceMap = await fetchSourceMap(normalizedUrl, fetcher);
-    cache.set(normalizedUrl, sourceMap);
-    return sourceMap;
-  } catch {
-    cache.set(normalizedUrl, null);
-    return null;
-  }
-};

package/src/viewportPresets.ts

@@ -1,69 +0,0 @@
-/**
- * Runtime source of truth for browser viewport presets.
- *
- * 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.
- *
- * 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 const BROWSER_VIEWPORT_PRESET_IDS = [
-  'iPhoneSE',
-  'iPhoneXR',
-  'iPhone12Pro',
-  'iPhone14ProMax',
-  'Pixel7',
-  'SamsungGalaxyS8Plus',
-  'SamsungGalaxyS20Ultra',
-  'iPadMini',
-  'iPadAir',
-  'iPadPro',
-  'SurfacePro7',
-  'SurfaceDuo',
-  'GalaxyZFold5',
-  'AsusZenbookFold',
-  'SamsungGalaxyA51A71',
-  'NestHub',
-  'NestHubMax',
-] as const;
-
-type BrowserViewportPresetId = (typeof BROWSER_VIEWPORT_PRESET_IDS)[number];
-
-type BrowserViewportSize = {
-  width: number;
-  height: number;
-};
-
-export const BROWSER_VIEWPORT_PRESET_DIMENSIONS: Record<
-  BrowserViewportPresetId,
-  BrowserViewportSize
-> = {
-  iPhoneSE: { width: 375, height: 667 },
-  iPhoneXR: { width: 414, height: 896 },
-  iPhone12Pro: { width: 390, height: 844 },
-  iPhone14ProMax: { width: 430, height: 932 },
-  Pixel7: { width: 412, height: 915 },
-  SamsungGalaxyS8Plus: { width: 360, height: 740 },
-  SamsungGalaxyS20Ultra: { width: 412, height: 915 },
-  iPadMini: { width: 768, height: 1024 },
-  iPadAir: { width: 820, height: 1180 },
-  iPadPro: { width: 1024, height: 1366 },
-  SurfacePro7: { width: 912, height: 1368 },
-  SurfaceDuo: { width: 540, height: 720 },
-  GalaxyZFold5: { width: 344, height: 882 },
-  AsusZenbookFold: { width: 853, height: 1280 },
-  SamsungGalaxyA51A71: { width: 412, height: 914 },
-  NestHub: { width: 1024, height: 600 },
-  NestHubMax: { width: 1280, height: 800 },
-};
-
-export const resolveBrowserViewportPreset = (
-  presetId: string,
-): BrowserViewportSize | null => {
-  const size =
-    BROWSER_VIEWPORT_PRESET_DIMENSIONS[presetId as BrowserViewportPresetId];
-  return size ?? null;
-};