chore(workflow): migrate unit test runner from vitest to rstest

Replace vitest with @rstest/core across all packages and apps. Each
project gains an rstest.config.ts; shared boilerplate (coverage, dotenv,
jsdom storage polyfill, style stubs, photon externals, __VERSION__
define) is factored into scripts/rstest-*.ts.

Two rstest behaviors required workarounds, each tracked upstream:

- apps/studio launch-electron: rstest mocks are an rspack build-time
  transform, so import(variable) escapes them and would spawn a real
  Electron process. Use string-literal imports.
  (web-infra-dev/rstest#1454)

- apps/studio updater-handlers: rstest externalizes node-env deps by
  default and still evaluates an externalized module even when mocked,
  so the real electron-updater crashed at import. Bundle all deps via
  output.bundleDependencies. (web-infra-dev/rstest#1456)

core merge-browser-parse: replace the brittle absolute 15MB cap on the
merged report with a guard relative to a single report, so it tracks the
report-template size instead of breaking as the viewer bundle grows.

Validation: pnpm run lint; full test:coverage (13 projects, 2328 tests)
all green.

Claude-Session: https://claude.ai/code/session_011FdpdFgXxUwWgRxpALzfoE

Author: fi3ework

CONTRIBUTING.md

@@ -181,7 +181,7 @@ MIDSCENE_MODEL_NAME="qwen3-vl-plus"
 
 If you've fixed a bug or added code that should be tested, then add some tests.
 
-You can add unit test cases in the `<PACKAGE_DIR>/tests` folder. The test runner is based on [Vitest](https://vitest.dev/).
+You can add unit test cases in the `<PACKAGE_DIR>/tests` folder. The test runner is based on [Rstest](https://rstest.rs/).
 
 ### Run Unit Tests
 

apps/android-playground/package.json

@@ -16,10 +16,10 @@
   },
   "devDependencies": {
     "@rsbuild/core": "^1.6.15",
-    "@rsbuild/plugin-less": "^1.5.0",
-    "@rsbuild/plugin-node-polyfill": "1.4.2",
-    "@rsbuild/plugin-react": "^1.4.1",
-    "@rsbuild/plugin-svgr": "^1.2.2",
+    "@rsbuild/plugin-less": "^1.6.4",
+    "@rsbuild/plugin-node-polyfill": "1.4.6",
+    "@rsbuild/plugin-react": "^1.4.6",
+    "@rsbuild/plugin-svgr": "^1.3.1",
     "@rsbuild/plugin-type-check": "^1.3.2",
     "@types/react": "^18.3.1",
     "@types/react-dom": "^18.3.1",

apps/chrome-extension/package.json

@@ -9,7 +9,7 @@
     "dev:simple": "rsbuild dev --open",
     "preview": "rsbuild preview",
     "pack-extension": "node scripts/pack-extension.js",
-    "test": "vitest run"
+    "test": "rstest"
   },
   "dependencies": {
     "@ant-design/icons": "^5.3.1",
@@ -34,24 +34,25 @@
   },
   "devDependencies": {
     "@rsbuild/core": "^1.6.15",
-    "rimraf": "~3.0.2",
-    "@rsbuild/plugin-less": "^1.5.0",
-    "@rsbuild/plugin-node-polyfill": "1.4.2",
-    "@rsbuild/plugin-react": "^1.4.1",
-    "@rsbuild/plugin-svgr": "^1.2.2",
+    "@rsbuild/plugin-less": "^1.6.4",
+    "@rsbuild/plugin-node-polyfill": "1.4.6",
+    "@rsbuild/plugin-react": "^1.4.6",
+    "@rsbuild/plugin-svgr": "^1.3.1",
     "@rsbuild/plugin-type-check": "^1.3.2",
+    "@rstest/core": "0.10.6",
     "@tailwindcss/postcss": "4.1.11",
     "@types/chrome": "0.0.279",
     "@types/react": "^18.3.1",
     "@types/react-dom": "^18.3.1",
     "archiver": "^6.0.0",
     "concurrently": "^8.2.0",
+    "jsdom": "29.0.2",
     "less": "^4.2.0",
     "openai": "6.3.0",
+    "rimraf": "~3.0.2",
     "rsbuild-plugin-workspace-dev": "0.0.1",
     "tailwindcss": "4.1.11",
     "typescript": "^5.8.3",
-    "vitest": "3.0.5",
     "web-ext": "9.0.0"
   }
 }

apps/chrome-extension/rstest.config.ts

@@ -0,0 +1,19 @@
+import path from 'node:path';
+import { pluginReact } from '@rsbuild/plugin-react';
+import { defineConfig } from '@rstest/core';
+import { createCoverageConfig } from '../../scripts/rstest-coverage';
+import { stubStyleRules } from '../../scripts/rstest-style-stub';
+
+export default defineConfig({
+  plugins: [pluginReact()],
+  coverage: createCoverageConfig(__dirname),
+  // Default to node; jsdom is selected per file via the `@vitest-environment
+  // jsdom` docblock. The storage polyfill is harmless under node, so it can be
+  // applied globally.
+  testEnvironment: 'node',
+  setupFiles: [
+    path.resolve(__dirname, '../../scripts/rstest-jsdom-storage.ts'),
+  ],
+  include: ['tests/**/*.test.{ts,tsx}'],
+  ...stubStyleRules,
+});

apps/chrome-extension/tests/bridge-start-stop.test.ts

@@ -10,9 +10,9 @@
  * - Users cannot stop/start listening in bridge mode
  * - Users cannot change remote server URL because the input is always disabled
  *
- * Run: npx vitest run apps/chrome-extension/tests/bridge-start-stop.test.ts
+ * Run: npx rstest run apps/chrome-extension/tests/bridge-start-stop.test.ts
  */
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, rs } from '@rstest/core';
 
 // ─── BridgeConnector unit tests ──────────────────────────────────────────────
 

apps/chrome-extension/tests/browser-extension-playground.test.tsx

@@ -1,26 +1,26 @@
+import { afterEach, beforeEach, describe, expect, it, rs } from '@rstest/core';
 /**
  * @vitest-environment jsdom
  */
 import { act } from 'react';
 import type React from 'react';
 import { createRoot } from 'react-dom/client';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
-const mockPlaygroundSDK = vi.fn();
+const mockPlaygroundSDK = rs.fn();
 const universalPlaygroundProps: Array<Record<string, unknown>> = [];
-const mockTabsQuery = vi.fn();
-const mockOnActivatedAddListener = vi.fn();
-const mockOnActivatedRemoveListener = vi.fn();
+const mockTabsQuery = rs.fn();
+const mockOnActivatedAddListener = rs.fn();
+const mockOnActivatedRemoveListener = rs.fn();
 
-vi.mock('@midscene/playground', () => ({
+rs.mock('@midscene/playground', () => ({
   PlaygroundSDK: class MockPlaygroundSDK {
     constructor(config: unknown) {
       mockPlaygroundSDK(config);
     }
   },
 }));
 
-vi.mock('@midscene/visualizer', () => ({
+rs.mock('@midscene/visualizer', () => ({
   UniversalPlayground: (props: Record<string, unknown>) => {
     universalPlaygroundProps.push(props);
     return <div>universal-playground</div>;
@@ -34,7 +34,7 @@ vi.mock('@midscene/visualizer', () => ({
   },
 }));
 
-vi.mock('../../src/utils/chrome', () => ({
+rs.mock('../../src/utils/chrome', () => ({
   getExtensionVersion: () => '1.0.0',
 }));
 
@@ -68,20 +68,20 @@ describe('BrowserExtensionPlayground', () => {
         },
       },
     });
-    vi.stubGlobal('__SDK_VERSION__', 'test-sdk');
+    rs.stubGlobal('__SDK_VERSION__', 'test-sdk');
   });
 
   afterEach(() => {
     document.body.innerHTML = '';
-    vi.unstubAllGlobals();
+    rs.unstubAllGlobals();
   });
 
   it('creates PlaygroundSDK even when env config is empty', async () => {
     const { BrowserExtensionPlayground } = await import(
       '../src/components/playground'
     );
-    const onPlaygroundSDKChange = vi.fn();
-    const getAgent = vi.fn(() => ({ page: { screenshot: vi.fn() } }));
+    const onPlaygroundSDKChange = rs.fn();
+    const getAgent = rs.fn(() => ({ page: { screenshot: rs.fn() } }));
     const container = document.createElement('div');
     document.body.appendChild(container);
     const root = createRoot(container);

apps/chrome-extension/tests/event-memory-stress.test.ts

@@ -9,9 +9,9 @@
  * JSON.stringify is a close proxy for that cost. We measure actual heap usage
  * to prove the old approach exceeds Chrome Service Worker memory limits (~256-512 MB).
  *
- * Run: npx vitest run apps/chrome-extension/tests/event-memory-stress.test.ts
+ * Run: npx rstest run apps/chrome-extension/tests/event-memory-stress.test.ts
  */
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it } from '@rstest/core';
 
 // --- Helpers ---
 

apps/chrome-extension/tests/playground-popup.test.tsx

@@ -1,20 +1,20 @@
+import { afterEach, beforeEach, describe, expect, it, rs } from '@rstest/core';
 /**
  * @vitest-environment jsdom
  */
 import { act } from 'react';
 import type React from 'react';
 import { useEffect } from 'react';
 import { createRoot } from 'react-dom/client';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
-const setPopupTab = vi.fn();
+const setPopupTab = rs.fn();
 const getAgentRefs: Array<unknown> = [];
 let sdkSyncEffectCount = 0;
 
-vi.mock('@midscene/visualizer', () => ({
+rs.mock('@midscene/visualizer', () => ({
   NavActions: () => null,
   globalThemeConfig: () => ({}),
-  safeOverrideAIConfig: vi.fn(),
+  safeOverrideAIConfig: rs.fn(),
   useEnvConfig: (selector?: (state: Record<string, unknown>) => unknown) => {
     const state = {
       config: {
@@ -27,21 +27,21 @@ vi.mock('@midscene/visualizer', () => ({
   },
 }));
 
-vi.mock('antd', () => ({
+rs.mock('antd', () => ({
   ConfigProvider: ({ children }: { children: React.ReactNode }) => children,
   Dropdown: ({ children }: { children: React.ReactNode }) => children,
 }));
 
-vi.mock('@midscene/shared/env', () => ({
+rs.mock('@midscene/shared/env', () => ({
   MIDSCENE_MODEL_API_KEY: 'test-key',
 }));
 
-vi.mock('@midscene/web/chrome-extension', () => ({
+rs.mock('@midscene/web/chrome-extension', () => ({
   ChromeExtensionProxyPage: class ChromeExtensionProxyPage {},
   ChromeExtensionProxyPageAgent: class ChromeExtensionProxyPageAgent {},
 }));
 
-vi.mock('../src/components/playground', () => ({
+rs.mock('../src/components/playground', () => ({
   BrowserExtensionPlayground: ({
     getAgent,
     onPlaygroundSDKChange,
@@ -60,11 +60,11 @@ vi.mock('../src/components/playground', () => ({
   },
 }));
 
-vi.mock('../src/extension/bridge', () => ({
+rs.mock('../src/extension/bridge', () => ({
   default: () => <div>bridge</div>,
 }));
 
-vi.mock('../src/extension/recorder', () => ({
+rs.mock('../src/extension/recorder', () => ({
   default: () => <div>recorder</div>,
 }));
 

apps/chrome-extension/tests/stop-recording-fixes.test.ts

@@ -7,9 +7,9 @@
  * 3. Batched AI description generation: concurrency is bounded
  * 4. Logger sanitization: events arrays are never passed to loggers
  *
- * Run: npx vitest run apps/chrome-extension/tests/stop-recording-fixes.test.ts
+ * Run: npx rstest run apps/chrome-extension/tests/stop-recording-fixes.test.ts
  */
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, rs } from '@rstest/core';
 
 // --- Helpers ---
 

apps/chrome-extension/tests/yaml-language-settings.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, rs } from '@rstest/core';
 import {
   DEFAULT_YAML_LANGUAGE_PREFERENCE,
   YAML_LANGUAGE_STORAGE_KEY,
@@ -10,7 +10,7 @@ import {
 describe('yaml language settings', () => {
   it('falls back to auto when storage is empty', () => {
     const storage = {
-      getItem: vi.fn(() => null),
+      getItem: rs.fn(() => null),
     };
 
     expect(getStoredYamlLanguagePreference(storage)).toBe(
@@ -20,23 +20,23 @@ describe('yaml language settings', () => {
 
   it('returns a custom language stored by the user', () => {
     const storage = {
-      getItem: vi.fn(() => 'Japanese'),
+      getItem: rs.fn(() => 'Japanese'),
     };
 
     expect(getStoredYamlLanguagePreference(storage)).toBe('Japanese');
   });
 
   it('returns an explicitly stored YAML language', () => {
     const storage = {
-      getItem: vi.fn(() => 'Chinese'),
+      getItem: rs.fn(() => 'Chinese'),
     };
 
     expect(getStoredYamlLanguagePreference(storage)).toBe('Chinese');
   });
 
   it('persists YAML language preference with the expected key', () => {
     const storage = {
-      setItem: vi.fn(),
+      setItem: rs.fn(),
     };
 
     persistYamlLanguagePreference('English', storage);