@rstest/browser 0.11.5 → 0.11.7

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/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;
-};

package/src/watchRerunPlanner.ts

@@ -1,77 +0,0 @@
-import { normalize } from 'pathe';
-import type { TestFileInfo } from './protocol';
-
-type WatchPlannerProjectEntry = {
-  project: {
-    name: string;
-  };
-  testFiles: string[];
-};
-
-type WatchRerunPlannerInput = {
-  projectEntries: WatchPlannerProjectEntry[];
-  previousTestFiles: TestFileInfo[];
-  affectedTestFiles: string[];
-};
-
-type WatchRerunPlan = {
-  currentTestFiles: TestFileInfo[];
-  filesChanged: boolean;
-  normalizedAffectedTestFiles: string[];
-  affectedTestFiles: TestFileInfo[];
-};
-
-const serializeTestFiles = (files: TestFileInfo[]): string => {
-  return JSON.stringify(
-    files.map((f) => `${f.projectName}:${f.testPath}`).sort(),
-  );
-};
-
-const normalizeTestFiles = (files: TestFileInfo[]): TestFileInfo[] => {
-  return files.map((file) => ({
-    ...file,
-    testPath: normalize(file.testPath),
-  }));
-};
-
-export const collectWatchTestFiles = (
-  projectEntries: WatchPlannerProjectEntry[],
-): TestFileInfo[] => {
-  return projectEntries.flatMap((entry) =>
-    entry.testFiles.map((testPath) => ({
-      testPath: normalize(testPath),
-      projectName: entry.project.name,
-    })),
-  );
-};
-
-export const planWatchRerun = ({
-  projectEntries,
-  previousTestFiles,
-  affectedTestFiles,
-}: WatchRerunPlannerInput): WatchRerunPlan => {
-  const currentTestFiles = collectWatchTestFiles(projectEntries);
-  const normalizedPrevious = normalizeTestFiles(previousTestFiles);
-  const filesChanged =
-    serializeTestFiles(currentTestFiles) !==
-    serializeTestFiles(normalizedPrevious);
-
-  const normalizedAffectedTestFiles = affectedTestFiles.map((testFile) =>
-    normalize(testFile),
-  );
-
-  const currentFileMap = new Map(
-    currentTestFiles.map((file) => [file.testPath, file] as const),
-  );
-
-  const matchedAffectedFiles = normalizedAffectedTestFiles
-    .map((testFile) => currentFileMap.get(testFile))
-    .filter((file): file is TestFileInfo => Boolean(file));
-
-  return {
-    currentTestFiles,
-    filesChanged,
-    normalizedAffectedTestFiles,
-    affectedTestFiles: matchedAffectedFiles,
-  };
-};