feat: support rstest in testing library

.changeset/easy-waves-pump.md

@@ -0,0 +1,6 @@
+---
+"@lynx-js/react-webpack-plugin": patch
+"@lynx-js/react-rsbuild-plugin": patch
+---
+
+Support rstest for testing library using a dedicated testing loader.

.changeset/fair-plums-share.md

@@ -0,0 +1,11 @@
+---
+"@lynx-js/testing-environment": minor
+---
+
+**BREAKING CHANGE**:
+
+Align the public test-environment API around `LynxEnv`.
+
+`LynxTestingEnv` now expects a `{ window }`-shaped environment instead of relying on a concrete `JSDOM` instance or `global.jsdom`. Callers that construct `LynxTestingEnv` manually or initialize the environment through globals should migrate to `new LynxTestingEnv({ window })` or set `global.lynxEnv`.
+
+This release also adds the `@lynx-js/testing-environment/env/rstest` entry for running the shared testing-environment suite under rstest.

.changeset/ninety-pants-tease.md

@@ -0,0 +1,5 @@
+---
+"create-rspeedy": patch
+---
+
+Add Rstest ReactLynx Testing Library template.

.changeset/red-lamps-arrive.md

@@ -0,0 +1,26 @@
+---
+"@lynx-js/react": patch
+---
+
+Support rstest for testing library, you can use rstest with RLTL now:
+
+Create a config file `rstest.config.ts` with the following content:
+
+```ts
+import { defineConfig } from '@rstest/core';
+import { withLynxConfig } from '@lynx-js/react/testing-library/rstest-config';
+
+export default defineConfig({
+  extends: withLynxConfig(),
+});
+```
+
+`@lynx-js/react/testing-library/rstest-config` will automatically load your `lynx.config.ts` and apply the same configuration to rstest, so you can keep your test environment consistent with your development environment.
+
+And then use rstest as usual:
+
+```bash
+$ rstest
+```
+
+For more usage detail, see https://rstest.rs/

.github/workflows/test.yml

@@ -208,6 +208,15 @@ jobs:
         pnpm run build --mode development
         pnpm run lint
         pnpm run test
+        cd `mktemp -d`
+        npx --registry http://localhost:4873 create-rspeedy-canary@latest --template react --dir create-rspeedy-regression-rstest-rltl --tools eslint,rstest-rltl
+        cd create-rspeedy-regression-rstest-rltl
+        npx --registry http://localhost:4873 upgrade-rspeedy-canary@latest
+        pnpm install --registry=http://localhost:4873
+        pnpm run build
+        pnpm run build --mode development
+        pnpm run lint
+        pnpm run test
   test-react:
     needs: build
     uses: ./.github/workflows/workflow-test.yml

package.json

@@ -32,6 +32,7 @@
     "@rsbuild/core": "catalog:rsbuild",
     "@rslib/core": "^0.19.6",
     "@rspack/core": "catalog:rspack",
+    "@rstest/core": "catalog:rstest",
     "@svitejs/changesets-changelog-github-compact": "^1.2.0",
     "@tsconfig/node22": "^22.0.5",
     "@tsconfig/strictest": "^2.0.8",

packages/lynx/gesture-runtime/vitest.config.ts

@@ -1,8 +1,10 @@
-import { defineConfig, mergeConfig } from 'vitest/config';
-import { createVitestConfig } from '@lynx-js/react/testing-library/vitest-config';
+import { defineConfig } from 'vitest/config';
+import { vitestTestingLibraryPlugin } from '@lynx-js/react/testing-library/plugins';
 
-const defaultConfig = await createVitestConfig();
-const config = defineConfig({
+export default defineConfig({
+  plugins: [
+    vitestTestingLibraryPlugin(),
+  ],
   test: {
     name: 'lynx/gesture-runtime',
     setupFiles: ['__test__/utils/setup.ts'],
@@ -13,5 +15,3 @@ const config = defineConfig({
     exclude: ['__test__/utils/**'],
   },
 });
-
-export default mergeConfig(defaultConfig, config);

packages/motion/vitest.config.ts

@@ -1,8 +1,10 @@
-import { defineConfig, mergeConfig } from 'vitest/config';
-import { createVitestConfig } from '@lynx-js/react/testing-library/vitest-config';
+import { defineConfig } from 'vitest/config';
+import { vitestTestingLibraryPlugin } from '@lynx-js/react/testing-library/plugins';
 
-const defaultConfig = await createVitestConfig();
-const config = defineConfig({
+export default defineConfig({
+  plugins: [
+    vitestTestingLibraryPlugin(),
+  ],
   test: {
     include: ['__tests__/**/*.test.{js,ts,jsx,tsx}'],
     exclude: ['__tests__/utils/**'],
@@ -11,5 +13,3 @@ const config = defineConfig({
     },
   },
 });
-
-export default mergeConfig(defaultConfig, config);

packages/react/package.json

@@ -101,9 +101,17 @@
       "default": "./testing-library/dist/pure.js"
     },
     "./testing-library/vitest-config": {
-      "types": "./testing-library/types/vitest-config.d.ts",
+      "types": "./testing-library/dist/vitest.config.d.ts",
       "default": "./testing-library/dist/vitest.config.js"
     },
+    "./testing-library/plugins": {
+      "types": "./testing-library/dist/plugins/index.d.ts",
+      "default": "./testing-library/dist/plugins/index.js"
+    },
+    "./testing-library/rstest-config": {
+      "types": "./testing-library/dist/rstest-config.d.ts",
+      "default": "./testing-library/dist/rstest-config.js"
+    },
     "./package.json": "./package.json"
   },
   "types": "./types/react.d.ts",
@@ -183,11 +191,15 @@
   },
   "peerDependencies": {
     "@lynx-js/types": "*",
+    "@rstest/core": "*",
     "@types/react": "^18"
   },
   "peerDependenciesMeta": {
     "@lynx-js/types": {
       "optional": true
+    },
+    "@rstest/core": {
+      "optional": true
     }
   }
 }

packages/react/testing-library/.npmignore

@@ -1,4 +1,6 @@
 *
-!dist/*
-!dist/env/*
+*
+!dist
+!dist/**/*
+!types
 !types/*

packages/react/testing-library/README.md

@@ -8,30 +8,69 @@ Similar to [react-testing-library](https://github.com/testing-library/react-test
 
 ## Setup
 
+### Rstest
+
+Setup rstest with `@lynx-js/react/testing-library/rstest-config`.
+
+Recommended for library projects:
+
+```ts
+import { defineConfig } from '@rstest/core';
+import { withDefaultConfig } from '@lynx-js/react/testing-library/rstest-config';
+
+export default defineConfig({
+  extends: withDefaultConfig(),
+});
+```
+
+Use `withLynxConfig` when you want to reuse your app's `lynx.config.ts`:
+
+```ts
+// rstest.config.ts
+import { defineConfig } from '@rstest/core';
+import { withLynxConfig } from '@lynx-js/react/testing-library/rstest-config';
+
+export default defineConfig({
+  extends: withLynxConfig(),
+});
+```
+
+Difference between `withLynxConfig` and `withDefaultConfig`:
+
+- `withLynxConfig`: app-oriented. Loads your `lynx.config.ts` and converts it to rstest config, so rspeedy/lynx settings are reused in tests.
+- `withDefaultConfig`: library-oriented. Only applies testing-library defaults (`jsdom`, setup files, globals) and lets you provide the rest via `modifyRstestConfig`.
+
+Then you can start writing tests and run them with rstest!
+
+For more usage detail, see https://rstest.rs/
+
+### Vitest
+
 Setup vitest:
 
 ```js
-// vitest.config.js
-import { defineConfig, mergeConfig } from 'vitest/config';
-import { createVitestConfig } from '@lynx-js/react/testing-library/vitest-config';
+import { defineConfig } from 'vitest/config';
+import { vitestTestingLibraryPlugin } from '@lynx-js/react/testing-library/plugins';
 
-const defaultConfig = createVitestConfig();
-const config = defineConfig({
+export default defineConfig({
+  plugins: [
+    vitestTestingLibraryPlugin(),
+  ],
   test: {
     // ...
   },
 });
-
-export default mergeConfig(defaultConfig, config);
 ```
 
 Then you can start writing tests and run them with vitest!
 
+`createVitestConfig` is still supported for backward compatibility, but is deprecated.
+
 ## Usage
 
-```js
+```jsx
 import '@testing-library/jest-dom';
-import { test, expect } from 'vitest';
+import { test, expect } from 'vitest'; // or '@rstest/core'
 import { render } from '@lynx-js/react/testing-library';
 
 test('renders options.wrapper around node', async () => {

packages/react/testing-library/package.json

@@ -6,14 +6,19 @@
   "scripts": {
     "build": "rslib build",
     "dev": "rslib build --watch",
+    "rstest": "rstest",
     "test": "npm run test:base && npm run test:3.1",
     "test:3.1": "vitest --config vitest.3.1.config.ts",
     "test:base": "vitest",
     "test:ui": "vitest --ui"
   },
   "devDependencies": {
     "@lynx-js/react": "workspace:*",
+    "@lynx-js/react-rsbuild-plugin": "workspace:*",
+    "@lynx-js/rspeedy": "workspace:*",
     "@lynx-js/testing-environment": "workspace:*",
+    "@rsbuild/core": "catalog:rsbuild",
+    "@rstest/adapter-rsbuild": "^0.2.3",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1"
   }

packages/react/testing-library/rslib.config.ts

@@ -9,12 +9,14 @@ export default defineConfig({
     {
       format: 'esm',
       syntax: 'es2022',
-      dts: false,
+      dts: true,
       bundle: true,
       source: {
         entry: {
           'pure': './src/pure.jsx',
-          'env/vitest': './src/env/vitest.ts',
+          'env/index': './src/env/index.ts',
+          'plugins/index': './src/plugins/index.ts',
+          'rstest-config': './src/rstest-config.ts',
         },
       },
       output: {
@@ -23,6 +25,9 @@ export default defineConfig({
           /^\.\.\/\.\.\/runtime\/lib/,
           /^preact/,
           /^vitest/,
+          '@rstest/core',
+          '@rsbuild/core',
+          '@lynx-js/rspeedy',
         ],
       },
     },
@@ -33,9 +38,13 @@ export default defineConfig({
       bundle: false,
       source: {
         entry: {
-          'index': './src/index.jsx',
-          'vitest.config': './src/vitest.config.js',
-          'vitest-global-setup': './src/vitest-global-setup.js',
+          'index': [
+            './src/index.jsx',
+            './src/vitest.config.ts',
+            './src/env/vitest.ts',
+            './src/env/rstest.ts',
+            './src/setupFiles/**/*.js',
+          ],
         },
       },
       output: {

packages/react/testing-library/rstest.config.ts

@@ -0,0 +1,44 @@
+import { defineConfig } from '@rstest/core';
+import { pluginReactLynx } from '@lynx-js/react-rsbuild-plugin';
+import { withDefaultConfig } from './src/rstest-config.ts';
+
+export default defineConfig({
+  extends: withDefaultConfig({
+    modifyRstestConfig(config) {
+      return {
+        ...config,
+        tools: {
+          swc: {
+            jsc: {
+              transform: {
+                useDefineForClassFields: true,
+              },
+            },
+          },
+        },
+        plugins: [
+          ...(config.plugins || []),
+          pluginReactLynx(),
+        ],
+        source: {
+          ...config.source,
+          define: {
+            ...config.source?.define,
+            __ALOG__: 'true',
+          },
+        },
+        resolve: {
+          ...config.resolve,
+          // in order to make our test case work for
+          // both vitest and rstest, we need to alias
+          // `vitest` to `@rstest/core`
+          alias: {
+            ...config.resolve?.alias,
+            vitest: require.resolve('./vitest-polyfill.cjs'),
+          },
+        },
+        include: ['src/**/*.test.{js,jsx,ts,tsx}', '!src/__tests__/3.1/**/*.{js,jsx,ts,tsx}'],
+      };
+    },
+  }),
+});

packages/react/testing-library/src/__tests__/act.test.jsx

@@ -201,7 +201,7 @@ test('fireEvent triggers useEffect calls', async () => {
       [
         "rLynxChange",
         {
-          "data": "{"patchList":[{"snapshotPatch":[0,"__snapshot_e8d0a_test_4",2,4,2,[1],0,null,3,4,3,[0],1,2,3,null,1,-1,2,null],"id":2}]}",
+          "data": "{"patchList":[{"snapshotPatch":[0,"__snapshot_268b9_test_4",2,4,2,[1],0,null,3,4,3,[0],1,2,3,null,1,-1,2,null],"id":2}]}",
           "patchOptions": {
             "isHydration": true,
             "pipelineOptions": {
@@ -236,7 +236,7 @@ test('fireEvent triggers useEffect calls', async () => {
             ],
             "extraProps": undefined,
             "id": 2,
-            "type": "__snapshot_e8d0a_test_4",
+            "type": "__snapshot_268b9_test_4",
             "values": [
               "2:0:",
             ],
@@ -261,7 +261,7 @@ test('fireEvent triggers useEffect calls', async () => {
         ],
         "extraProps": undefined,
         "id": 2,
-        "type": "__snapshot_e8d0a_test_4",
+        "type": "__snapshot_268b9_test_4",
         "values": [
           "2:0:",
         ],
@@ -285,7 +285,7 @@ test('fireEvent triggers useEffect calls', async () => {
       [
         "rLynxChange",
         {
-          "data": "{"patchList":[{"snapshotPatch":[0,"__snapshot_e8d0a_test_4",2,4,2,[1],0,null,3,4,3,[0],1,2,3,null,1,-1,2,null],"id":2}]}",
+          "data": "{"patchList":[{"snapshotPatch":[0,"__snapshot_268b9_test_4",2,4,2,[1],0,null,3,4,3,[0],1,2,3,null,1,-1,2,null],"id":2}]}",
           "patchOptions": {
             "isHydration": true,
             "pipelineOptions": {