@rstest/browser 0.7.9

package/src/index.ts

@@ -0,0 +1,18 @@
+import type { Rstest } from '@rstest/core/browser';
+import {
+  type ListBrowserTestsResult,
+  listBrowserTests as listBrowserTestsImpl,
+  runBrowserController,
+} from './hostController';
+
+export async function runBrowserTests(context: Rstest): Promise<void> {
+  await runBrowserController(context);
+}
+
+export async function listBrowserTests(
+  context: Rstest,
+): Promise<ListBrowserTestsResult> {
+  return listBrowserTestsImpl(context);
+}
+
+export type { ListBrowserTestsResult };

package/src/manifest.d.ts

@@ -0,0 +1,41 @@
+declare module '@rstest/browser-manifest' {
+  /** Project configuration from manifest */
+  export type ManifestProjectConfig = {
+    name: string;
+    environmentName: string;
+    projectRoot: string;
+  };
+
+  /** Test context for a project */
+  export type ManifestTestContext = {
+    getTestKeys: () => string[];
+    loadTest: (key: string) => Promise<unknown>;
+    projectRoot: string;
+  };
+
+  /** All projects configuration (multi-project support) */
+  export const projects: ManifestProjectConfig[];
+
+  /** Setup loaders for each project, keyed by project name */
+  export const projectSetupLoaders: Record<
+    string,
+    Array<() => Promise<unknown>>
+  >;
+
+  /** Test contexts for each project, keyed by project name */
+  export const projectTestContexts: Record<string, ManifestTestContext>;
+
+  // Backward compatibility exports (use first project as default)
+
+  /** @deprecated Use `projects[0]` instead */
+  export const projectConfig: ManifestProjectConfig;
+
+  /** @deprecated Use `projectSetupLoaders[projectName]` instead */
+  export const setupLoaders: Array<() => Promise<unknown>>;
+
+  /** @deprecated Use `projectTestContexts[projectName].getTestKeys()` instead */
+  export function getTestKeys(): string[];
+
+  /** @deprecated Use `projectTestContexts[projectName].loadTest(key)` instead */
+  export function loadTest(key: string): Promise<unknown>;
+}

package/src/protocol.ts

@@ -0,0 +1,132 @@
+import type {
+  RuntimeConfig,
+  Test,
+  TestFileResult,
+  TestResult,
+} from '@rstest/core/browser-runtime';
+import type { SnapshotUpdateState } from '@vitest/snapshot';
+
+export type SerializedRuntimeConfig = RuntimeConfig;
+
+export type BrowserProjectRuntime = {
+  name: string;
+  environmentName: string;
+  projectRoot: string;
+  runtimeConfig: SerializedRuntimeConfig;
+};
+
+/**
+ * Test file info with associated project name.
+ * Used to track which project a test file belongs to.
+ */
+export type TestFileInfo = {
+  testPath: string;
+  projectName: string;
+};
+
+/**
+ * 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 BrowserHostConfig = {
+  rootPath: string;
+  projects: BrowserProjectRuntime[];
+  snapshot: {
+    updateSnapshot: SnapshotUpdateState;
+  };
+  testFile?: string; // Optional: if provided, only run this specific test file
+  /**
+   * Base URL for runner (iframe) pages.
+   */
+  runnerUrl?: string;
+  /**
+   * WebSocket port for container RPC.
+   */
+  wsPort?: number;
+  /**
+   * Execution mode. Defaults to 'run'.
+   */
+  mode?: BrowserExecutionMode;
+  /**
+   * 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;
+};
+
+export type BrowserClientMessage =
+  | { type: 'ready' }
+  | {
+      type: 'file-start';
+      payload: { testPath: string; projectName: string };
+    }
+  | { type: 'case-result'; payload: TestResult }
+  | { type: 'file-complete'; payload: TestFileResult }
+  | {
+      type: 'log';
+      payload: {
+        level: 'log' | 'warn' | 'error' | 'info' | 'debug';
+        content: string;
+        testPath: string;
+        type: 'stdout' | 'stderr';
+        trace?: string;
+      };
+    }
+  | {
+      type: 'fatal';
+      payload: { message: string; stack?: string };
+    }
+  | { type: 'complete' }
+  // Collect mode messages
+  | {
+      type: 'collect-result';
+      payload: { testPath: string; project: string; tests: Test[] };
+    }
+  | { type: 'collect-complete' }
+  // Snapshot RPC requests (from runner iframe to container)
+  | {
+      type: 'snapshot-rpc-request';
+      payload: SnapshotRpcRequest;
+    };
+
+/**
+ * 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: { testPath: string };
+    }
+  | {
+      id: string;
+      method: 'readSnapshotFile';
+      args: { filepath: string };
+    }
+  | {
+      id: string;
+      method: 'saveSnapshotFile';
+      args: { filepath: string; content: string };
+    }
+  | {
+      id: string;
+      method: 'removeSnapshotFile';
+      args: { filepath: string };
+    };
+
+/**
+ * Snapshot RPC response from container to runner iframe.
+ */
+export type SnapshotRpcResponse = {
+  id: string;
+  result?: unknown;
+  error?: string;
+};