chore: merge origin main

Author: SyMind

.github/renovate.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["github>rstackjs/renovate"],
+  "ignoreDeps": ["@nestjs/common", "@nestjs/core", "@nestjs/platform-express"]
+}

.github/renovate.json5

@@ -17,20 +17,23 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Install pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1 # v4
         id: pnpm-install
 
       - name: Set up Node.js
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
         with:
           node-version-file: ".nvmrc"
 
       - name: Install dependencies
         run: pnpm install
 
+      - name: Install Playwright browsers
+        run: pnpm --filter @rstest-example/browser-locator exec playwright install --with-deps chromium
+
       - name: Build Rspack
         run: |
           pnpm build:rspack
@@ -50,3 +53,6 @@ jobs:
       - name: Build Rsdoctor
         run: |
           pnpm build:rsdoctor
+
+      - name: Test Rstest
+        run: pnpm test:rstest

.github/workflows/ci.yaml

@@ -1,51 +1,21 @@
 # Logs
 logs
 *.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
 
 .DS_Store
 
-# Diagnostic reports (https://nodejs.org/api/report.html)
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
+# dist files
+dist
+doc_build
+.swc
 
 # Coverage directory used by tools like istanbul
 coverage
+!rstest/coverage/
 *.lcov
 
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
 # Dependency directories
 node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
 
 # TypeScript cache
 *.tsbuildinfo
@@ -59,81 +29,9 @@ web_modules/
 # Optional stylelint cache
 .stylelintcache
 
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
 # dotenv environment variable files
 .env
 .env.development.local
 .env.test.local
 .env.production.local
 .env.local
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-out
-.swc
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Gatsby files
-.cache/
-# Comment in the public line in if your project uses Gatsby and not Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
-
-# vuepress build output
-.vuepress/dist
-
-# vuepress v2.x temp and cache directory
-.temp
-.cache
-
-# Docusaurus cache and generated files
-.docusaurus
-
-# Serverless directories
-.serverless/
-
-# FuseBox cache
-.fusebox/
-
-# DynamoDB Local files
-.dynamodb/
-
-# TernJS port file
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
-
-# yarn v2
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
-
-# ignore lock to test more
-yarn.lock
-package-lock.json
-
-.idea/

.gitignore

@@ -1 +1 @@
-22.21.1
+24.15.0

.nvmrc

@@ -0,0 +1,99 @@
+# AGENTS.md
+
+This file provides guidance for AI coding agents working in this repository.
+
+## Repository Overview
+
+- This is a monorepo of example projects for the Rstack ecosystem: Rspack, Rsbuild, Rspress, Rsdoctor, Rslib, and Rstest.
+- Package manager: `pnpm` (see `package.json#packageManager`).
+- Workspace layout: `pnpm-workspace.yaml` includes `rspack/**`, `rsbuild/**`, `rslib/**`, `rspress/**`, `rsdoctor/**`, `rstest/**`.
+
+## Core Purpose of Examples
+
+**The primary goal of each example is to demonstrate "how a specific API achieves a specific effect through specific configuration".**
+
+When creating or modifying examples:
+- **Keep it minimal**: Only include code necessary to demonstrate the target feature/API
+- **Avoid over-engineering**: Don't add complex business logic that distracts from the core demonstration
+- **Focus on the tool, not the ecosystem**: For example, in a test runner example, focus on the test runner's APIs (mocking, assertions, configuration), not on complex DOM manipulation or third-party library integrations
+- **One concept per example**: Each example should ideally demonstrate one main feature or configuration pattern
+- **Clarity over completeness**: A simple, clear example is better than a comprehensive but confusing one
+
+Example of good vs bad:
+```
+# Good: Demonstrates rstest's mocking API
+- Simple mock function usage
+- Clear before/after assertions
+- Minimal setup code
+
+# Bad: Demonstrates rstest's mocking API
+- Complex React component with many interactions
+- Detailed DOM testing with @testing-library
+- Business logic mixed with test assertions
+```
+
+## Quick Start (Local)
+
+Prerequisites:
+- Node.js per `.nvmrc`
+- `corepack` enabled
+
+Common commands:
+- Install deps: `corepack enable && pnpm i`
+- Build everything: `pnpm run build`
+- Build a group:
+  - Rspack examples: `pnpm run build:rspack`
+  - Rsbuild examples: `pnpm run build:rsbuild`
+  - Rspress examples: `pnpm run build:rspress`
+  - Rsdoctor examples: `pnpm run build:rsdoctor`
+  - Rslib examples: `pnpm run build:rslib`
+- Test Rspack examples: `pnpm run test:rspack`
+
+Working in a single example:
+- `cd rspack/basic` (or any other example dir)
+- `pnpm i` (workspace install is preferred at repo root)
+- `pnpm run dev` / `pnpm run build` / `pnpm run test` (depends on the example)
+
+## Where Things Live
+
+Top-level directories:
+- `rspack/`: Rspack examples (often package name prefix `example-*`).
+- `rsbuild/`: Rsbuild examples (often package name prefix `rsbuild-*`).
+- `rspress/`: Rspress examples (often package name prefix `rspress-*`).
+- `rsdoctor/`: Rsdoctor examples (often package name prefix `rsdoctor-*`).
+- `rslib/`: Rslib examples (often package name prefix `rslib-*`).
+
+## Coding Conventions
+
+- Formatting and linting: `Biome` is used (see `biome.json`).
+  - Default JS/TS quote style is single quotes.
+  - Line width is 100.
+- Prefer minimal, example-focused changes. This repo is a collection of runnable examples; avoid refactors that reduce clarity.
+- Keep UI strings and code comments in English unless the surrounding file is already predominantly another language.
+
+## Running/Changing Examples
+
+- Examples are expected to be runnable independently.
+- When changing build tooling or config:
+  - Ensure the example still runs via its `dev` script (if present).
+  - Ensure `build` works at least for the changed example.
+
+## Dependencies & Workspace Notes
+
+- Prefer adding dependencies at the example package level, not in the repo root, unless the dependency is shared.
+- Use `pnpm --filter` to scope commands to a single package or group.
+  - Example: `pnpm --filter "example-basic" dev`
+
+## Agent Workflow Expectations
+
+When making changes:
+- Identify the single example/package impacted.
+- Keep changes scoped to that example unless explicitly requested.
+- Update configuration consistently with the conventions in that subtree.
+- Run the narrowest possible validation command (e.g. `pnpm --filter <pkg> build`) before running broad builds.
+
+## Common Pitfalls
+
+- Avoid editing generated output directories: `dist`, `dist-*`, `doc_build`.
+- Many examples are similar but not identical; do not assume scripts/config match across directories.
+- Some examples may pin specific versions or require particular Node constraints; check the example `package.json`.

AGENTS.md

@@ -2,14 +2,16 @@
 
 This repository contains comprehensive examples that demonstrate the Rstack ecosystem tools, including Rspack, Rsbuild, Rspress, and Rsdoctor. These examples showcase common implementation patterns and best practices to help developers leverage the full potential of the Rstack toolchain.
 
+> The `main` branch contains examples for Rspack/Rsbuild v2. For Rspack/Rsbuild 1.x examples, please check the [v1.x](https://github.com/rstackjs/rstack-examples/tree/v1.x) branch.
+
 ## List of Examples
 
-|   [Rspack](https://github.com/web-infra-dev/rspack)   |    <a href="https://github.com/web-infra-dev/rspack" target="blank"><img src="https://assets.rspack.dev/rspack/rspack-banner.png" width="400" /></a>    |  [Examples](./rspack)   |   [Document](https://rspack.dev/)    |
+|   [Rspack](https://github.com/web-infra-dev/rspack)   |    <a href="https://github.com/web-infra-dev/rspack" target="blank"><img src="https://assets.rspack.rs/rspack/rspack-banner.png" width="400" /></a>    |  [Examples](./rspack)   |   [Document](https://rspack.rs/)    |
 | :---------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------: | :----------------------------------: |
-|  [Rsbuild](https://github.com/web-infra-dev/rsbuild)  |  <a href="https://github.com/web-infra-dev/rsbuild" target="blank"><img src="https://assets.rspack.dev/rsbuild/rsbuild-banner.png" width="400" /></a>   |  [Examples](./rsbuild)  |   [Document](https://rsbuild.dev/)   |
-|  [Rspress](https://github.com/web-infra-dev/rspress)  |  <a href="https://github.com/web-infra-dev/rspress" target="blank"><img src="https://assets.rspack.dev/rspress/rspress-banner.png" width="400" /></a>   | [Examples](./rspress/)  |   [Document](https://rspress.dev/)   |
-| [Rsdoctor](https://github.com/web-infra-dev/rsdoctor) | <a href="https://github.com/web-infra-dev/rsdoctor" target="blank"><img src="https://assets.rspack.dev/rsdoctor/rsdoctor-banner.png" width="400" /></a> | [Examples](./rsdoctor/) |  [Document](https://rsdoctor.dev/)   |
-|    [Rslib](https://github.com/web-infra-dev/rslib)    |     <a href="https://github.com/web-infra-dev/rslib" target="blank"><img src="https://assets.rspack.dev/rslib/rslib-banner.png" width="400" /></a>      |   [Examples](./rslib)   | [Document](https://lib.rsbuild.dev/) |
+|  [Rsbuild](https://github.com/web-infra-dev/rsbuild)  |  <a href="https://github.com/web-infra-dev/rsbuild" target="blank"><img src="https://assets.rspack.rs/rsbuild/rsbuild-banner.png" width="400" /></a>   |  [Examples](./rsbuild)  |   [Document](https://rsbuild.rs/)   |
+|  [Rspress](https://github.com/web-infra-dev/rspress)  |  <a href="https://github.com/web-infra-dev/rspress" target="blank"><img src="https://assets.rspack.rs/rspress/rspress-banner.png" width="400" /></a>   | [Examples](./rspress/)  |   [Document](https://rspress.rs/)   |
+| [Rsdoctor](https://github.com/web-infra-dev/rsdoctor) | <a href="https://github.com/web-infra-dev/rsdoctor" target="blank"><img src="https://assets.rspack.rs/rsdoctor/rsdoctor-banner.png" width="400" /></a> | [Examples](./rsdoctor/) |  [Document](https://rsdoctor.rs/)   |
+|    [Rslib](https://github.com/web-infra-dev/rslib)    |     <a href="https://github.com/web-infra-dev/rslib" target="blank"><img src="https://assets.rspack.rs/rslib/rslib-banner.png" width="400" /></a>      |   [Examples](./rslib)   | [Document](https://rslib.rs/) |
 
 ## How to Use
 
@@ -21,7 +23,7 @@ For example, to clone the `/rspack/basic` example, run the following command:
 
 ```bash
 # Clone the basic example
-npx gitpick https://github.com/rspack-contrib/rstack-examples/tree/main/rspack/basic
+npx gitpick https://github.com/rstackjs/rstack-examples/tree/main/rspack/basic
 
 # Enter the basic example directory
 cd basic
@@ -37,7 +39,7 @@ To try all examples, you can clone the current repository to your local.
 1. First, clone the current repository to your local:
 
 ```bash
-git clone git@github.com:rspack-contrib/rstack-examples.git
+git clone git@github.com:rstackjs/rstack-examples.git
 ```
 
 2. Then, choose the example you need, such as the Rsbuild react example: