feat: add @vitejs/plugin-rsc (#521)

Co-authored-by: 翠 <[email protected]>

Author: hi-ogawa

.github/workflows/ci-rsc.yml

@@ -0,0 +1,61 @@
+name: ci-rsc
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    paths:
+      - "packages/plugin-rsc/**"
+      - "pnpm-lock.yaml"
+      - ".github/workflows/ci-rsc.yml"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.number || github.sha }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda # v4.1.0
+      - run: pnpm i
+      - run: pnpm build
+      - run: pnpm -C packages/plugin-rsc tsc
+      - run: pnpm -C packages/plugin-rsc test
+
+  test-e2e:
+    name: test-rsc (${{ matrix.os }} / ${{ matrix.browser }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      # TODO: shard?
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        browser: [chromium]
+        include:
+          - os: ubuntu-latest
+            browser: firefox
+          - os: macos-latest
+            browser: webkit
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda # v4.1.0
+      - run: pnpm i
+      - run: pnpm build
+      - run: pnpm -C packages/plugin-rsc exec playwright install ${{ matrix.browser }}
+      - run: pnpm -C packages/plugin-rsc test-e2e-ci --project=${{ matrix.browser }}
+        env:
+          TEST_ISOLATED: true
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results-${{ matrix.os }}-${{ matrix.browser }}
+          path: |
+            packages/plugin-rsc/test-results

README.md

@@ -15,13 +15,18 @@
 
 See [`@vitejs/plugin-react` documentation](packages/plugin-react/README.md) and [`@vitejs/plugin-react-swc` documentation](packages/plugin-react-swc/README.md)
 
+# Vite Plugin RSC
+
+See [`@vitejs/plugin-rsc` documentation](packages/plugin-rsc/README.md)
+
 ## Packages
 
 | Package                                               | Version (click for changelogs)                                                                                                             |
 | ----------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |
 | [@vitejs/plugin-react](packages/plugin-react)         | [![plugin-react version](https://img.shields.io/npm/v/@vitejs/plugin-react.svg?label=%20)](packages/plugin-react/CHANGELOG.md)             |
 | [@vitejs/plugin-react-oxc](packages/plugin-react-oxc) | [![plugin-react-oxc version](https://img.shields.io/npm/v/@vitejs/plugin-react-oxc.svg?label=%20)](packages/plugin-react-oxc/CHANGELOG.md) |
 | [@vitejs/plugin-react-swc](packages/plugin-react-swc) | [![plugin-react-swc version](https://img.shields.io/npm/v/@vitejs/plugin-react-swc.svg?label=%20)](packages/plugin-react-swc/CHANGELOG.md) |
+| [@vitejs/plugin-rsc](packages/plugin-rsc)             | [![plugin-rsc version](https://img.shields.io/npm/v/@vitejs/plugin-rsc.svg?label=%20)](packages/plugin-rsc/CHANGELOG.md)                   |
 
 ## License
 

eslint.config.js

@@ -9,7 +9,12 @@ import globals from 'globals'
 
 export default tseslint.config(
   {
-    ignores: ['**/dist/**', '**/playground-temp/**', '**/temp/**'],
+    ignores: [
+      '**/dist/**',
+      '**/playground-temp/**',
+      '**/temp/**',
+      'packages/plugin-rsc/**',
+    ],
   },
   eslint.configs.recommended,
   ...tseslint.configs.recommended,

package.json

@@ -36,7 +36,7 @@
     "@eslint/js": "^9.30.1",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^22.16.0",
-    "@vitejs/release-scripts": "^1.5.0",
+    "@vitejs/release-scripts": "^1.6.0",
     "eslint": "^9.30.1",
     "eslint-plugin-import-x": "^4.16.1",
     "eslint-plugin-n": "^17.20.0",
@@ -72,6 +72,9 @@
     ]
   },
   "pnpm": {
+    "overrides": {
+      "@vitejs/plugin-rsc": "workspace:*"
+    },
     "packageExtensions": {
       "generouted": {
         "peerDependencies": {

packages/plugin-rsc/.gitignore

@@ -0,0 +1,13 @@
+node_modules
+dist
+.vercel
+.vite-node
+.wrangler
+.netlify
+*.log
+*.tgz
+test-results
+*.tsbuildinfo
+.debug
+.vite-inspect
+.claude

packages/plugin-rsc/CHANGELOG.md

@@ -0,0 +1,172 @@
+# Changelog
+
+## v0.4.10 (2025-07-04)
+
+- feat: add `@vitejs/plugin-rsc` ([#521](https://github.com/vitejs/vite-plugin-react/pull/521))
+
+---
+
+Older versions were released as [`@hi-ogawa/vite-rsc`](https://github.com/hi-ogawa/vite-plugins/tree/main/packages/rsc).
+
+## v0.4.9 (2025-07-03)
+
+- feat: re-export plugin from base exports entry ([#1125](https://github.com/hi-ogawa/vite-plugins/pull/1125))
+- feat: re-export `transformHoistInlineDirective` ([#1122](https://github.com/hi-ogawa/vite-plugins/pull/1122))
+- fix: don't copy vite manifest from rsc to client ([#1118](https://github.com/hi-ogawa/vite-plugins/pull/1118))
+
+## v0.4.8 (2025-07-01)
+
+- fix: copy all server assets to client by default and output `__vite_rsc_encryption_key` to fs directly ([#1102](https://github.com/hi-ogawa/vite-plugins/pull/1102))
+- fix: stable client build ([#1094](https://github.com/hi-ogawa/vite-plugins/pull/1094))
+
+## v0.4.7 (2025-06-28)
+
+- feat: re-export `encodeReply` and `createTemporaryReferenceSet` from `react-server-dom/client` in `rsc` ([#1089](https://github.com/hi-ogawa/vite-plugins/pull/1089))
+- chore: add `use cache` example ([#1089](https://github.com/hi-ogawa/vite-plugins/pull/1089))
+- refactor: output code without indent ([#1087](https://github.com/hi-ogawa/vite-plugins/pull/1087))
+
+## v0.4.6 (2025-06-27)
+
+- fix: correctly resolve server function created by 3rd party package during dev ([#1067](https://github.com/hi-ogawa/vite-plugins/pull/1067))
+- fix: correctly resolve client boundary created by server package during dev ([#1050](https://github.com/hi-ogawa/vite-plugins/pull/1050))
+- fix: copy only css assets from server build to client build by default ([#1072](https://github.com/hi-ogawa/vite-plugins/pull/1072))
+- fix: fix single quote string in `loadModule('ssr', 'index')` ([#1064](https://github.com/hi-ogawa/vite-plugins/pull/1064))
+- fix: stabilize server build by externalizing encryption key file ([#1069](https://github.com/hi-ogawa/vite-plugins/pull/1069))
+- fix: check build instead of `import.meta.env.DEV` ([#1083](https://github.com/hi-ogawa/vite-plugins/pull/1083))
+- perf: strip code during scan build ([#1066](https://github.com/hi-ogawa/vite-plugins/pull/1066))
+- feat: support preserving client reference original value ([#1078](https://github.com/hi-ogawa/vite-plugins/pull/1078))
+- feat: add `enableActionEncryption` option for debugging purpose ([#1084](https://github.com/hi-ogawa/vite-plugins/pull/1084))
+- feat: add `ignoredClientInServerPackageWarning` option ([#1065](https://github.com/hi-ogawa/vite-plugins/pull/1065))
+
+## v0.4.5 (2025-06-22)
+
+- feat: rsc css transform for default export identifier ([#1046](https://github.com/hi-ogawa/vite-plugins/pull/1046))
+- feat: add `import.meta.viteRsc.loadBootstrapScriptContent` ([#1042](https://github.com/hi-ogawa/vite-plugins/pull/1042))
+- fix: only include jsx/tsx for rsc css export transform ([#1034](https://github.com/hi-ogawa/vite-plugins/pull/1034))
+- fix: ensure server-only and client-only not externalized ([#1045](https://github.com/hi-ogawa/vite-plugins/pull/1045))
+- fix: use static import for `loadCss` virtuals during build ([#1043](https://github.com/hi-ogawa/vite-plugins/pull/1043))
+
+## v0.4.4 (2025-06-20)
+
+- feat: automatic rsc css export transform ([#1030](https://github.com/hi-ogawa/vite-plugins/pull/1030))
+- feat: add plugin to workaround cloudflare error ([#1014](https://github.com/hi-ogawa/vite-plugins/pull/1014))
+- feat: add load module dev proxy ([#1012](https://github.com/hi-ogawa/vite-plugins/pull/1012))
+- feat: add `serverHandler` option to allow using ssr environment as main handler  ([#1008](https://github.com/hi-ogawa/vite-plugins/pull/1008))
+- feat: support `loadModule(environment, entry)` ([#1007](https://github.com/hi-ogawa/vite-plugins/pull/1007))
+- refactor: tweak renderHtml types and naming ([#1029](https://github.com/hi-ogawa/vite-plugins/pull/1029))
+
+## v0.4.3 (2025-06-18)
+
+- feat: add rsc css export transform helper ([#1002](https://github.com/hi-ogawa/vite-plugins/pull/1002))
+- feat: support `loadCss(importer)` ([#1001](https://github.com/hi-ogawa/vite-plugins/pull/1001))
+
+## v0.4.2 (2025-06-17)
+
+- fix: allow custom `outDir` + chore: cloudflare single worker setup ([#990](https://github.com/hi-ogawa/vite-plugins/pull/990))
+- fix: transform `__webpack_require__` global ([#980](https://github.com/hi-ogawa/vite-plugins/pull/980))
+- fix: inline and optimize react deps in ssr environment ([#982](https://github.com/hi-ogawa/vite-plugins/pull/982))
+- refactor: resolve self runtime import instead of `dedupe` ([#975](https://github.com/hi-ogawa/vite-plugins/pull/975))
+- refactor: emit assets manifest during `writeBundle` ([#972](https://github.com/hi-ogawa/vite-plugins/pull/972))
+- refactor: use `../` instead of `./../` path in output ([#963](https://github.com/hi-ogawa/vite-plugins/pull/963))
+
+## v0.4.1 (2025-06-15)
+
+- fix: re-publish to fix vendored dependency
+
+## v0.4.0 (2025-06-15)
+
+- refactor!: rework multi environment API (bootstrap script) ([#958](https://github.com/hi-ogawa/vite-plugins/pull/958))
+- refactor!: rework multi environment API (ssr module) ([#957](https://github.com/hi-ogawa/vite-plugins/pull/957))
+- refactor!: simplify plugin options in favor of `rollupOptions.input` ([#956](https://github.com/hi-ogawa/vite-plugins/pull/956))
+- feat: expose `rsc-html-stream` utils ([#950](https://github.com/hi-ogawa/vite-plugins/pull/950))
+- fix: fix missing rsc css on build ([#949](https://github.com/hi-ogawa/vite-plugins/pull/949))
+
+## v0.3.4 (2025-06-12)
+
+- fix: fix internal import to allow stable react vendor chunk ([#824](https://github.com/hi-ogawa/vite-plugins/pull/824))
+- fix: compat for old react plugin ([#939](https://github.com/hi-ogawa/vite-plugins/pull/939))
+
+## v0.3.3 (2025-06-12)
+
+- feat: support rolldown-vite ([#931](https://github.com/hi-ogawa/vite-plugins/pull/931))
+- fix: allow usage without react plugin ([#934](https://github.com/hi-ogawa/vite-plugins/pull/934))
+- chore: docs ([#921](https://github.com/hi-ogawa/vite-plugins/pull/921))
+
+## v0.3.2 (2025-06-10)
+
+- feat: auto initialize ([#925](https://github.com/hi-ogawa/vite-plugins/pull/925))
+- fix: emit assets manifest only in server build ([#929](https://github.com/hi-ogawa/vite-plugins/pull/929))
+- refactor: inline react-server-dom in ssr (2) ([#927](https://github.com/hi-ogawa/vite-plugins/pull/927))
+- chore: add `@cloudflare/vite-plugin` example ([#926](https://github.com/hi-ogawa/vite-plugins/pull/926))
+
+## v0.3.1 (2025-06-06)
+
+- refactor: vendor react-server-dom ([#854](https://github.com/hi-ogawa/vite-plugins/pull/854))
+
+## v0.3.0 (2025-06-05)
+
+- feat!: rsc css code split ([#876](https://github.com/hi-ogawa/vite-plugins/pull/876))
+- feat: encrypt closure bind values ([#897](https://github.com/hi-ogawa/vite-plugins/pull/897))
+- fix: client element as bound arg encryption ([#905](https://github.com/hi-ogawa/vite-plugins/pull/905))
+- fix: throw on client reference call on server ([#900](https://github.com/hi-ogawa/vite-plugins/pull/900))
+
+## v0.2.4 (2025-05-26)
+
+- fix: fix stale css import in non-boundary client module ([#887](https://github.com/hi-ogawa/vite-plugins/pull/887))
+- fix: fix non-client-boundary client module hmr in tailwind example ([#886](https://github.com/hi-ogawa/vite-plugins/pull/886))
+
+## v0.2.3 (2025-05-22)
+
+- fix: support Windows ([#884](https://github.com/hi-ogawa/vite-plugins/pull/884))
+- fix: remove stale ssr styles during dev ([#879](https://github.com/hi-ogawa/vite-plugins/pull/879))
+- fix: add `vary` header to avoid rsc payload on tab re-open ([#877](https://github.com/hi-ogawa/vite-plugins/pull/877))
+
+## v0.2.2 (2025-05-18)
+
+- fix: emit server assets and copy to client ([#861](https://github.com/hi-ogawa/vite-plugins/pull/861))
+- fix: css modules hmr ([#860](https://github.com/hi-ogawa/vite-plugins/pull/860))
+- fix: fix `collectCssByUrl` error ([#856](https://github.com/hi-ogawa/vite-plugins/pull/856))
+- fix: show invalid transform error with code frame ([#871](https://github.com/hi-ogawa/vite-plugins/pull/871))
+- perf: preload client reference deps before non-cached import ([#850](https://github.com/hi-ogawa/vite-plugins/pull/850))
+
+## v0.2.1 (2025-05-13)
+
+- feat: automatic client package heuristics ([#830](https://github.com/hi-ogawa/vite-plugins/pull/830))
+- fix: add browser entry to  `optimizeDeps.entries` ([#846](https://github.com/hi-ogawa/vite-plugins/pull/846))
+- fix: resolve self package from project root ([#845](https://github.com/hi-ogawa/vite-plugins/pull/845))
+- refactor: use `rsc-html-stream` ([#843](https://github.com/hi-ogawa/vite-plugins/pull/843))
+
+## v0.2.0 (2025-05-12)
+
+- feat: apply tree-shaking to all client references (2nd approach) ([#838](https://github.com/hi-ogawa/vite-plugins/pull/838))
+- feat: support nonce ([#813](https://github.com/hi-ogawa/vite-plugins/pull/813))
+- feat: support css in rsc environment ([#825](https://github.com/hi-ogawa/vite-plugins/pull/825))
+- feat: support css in client references ([#823](https://github.com/hi-ogawa/vite-plugins/pull/823))
+- fix: handle html escape and binary data in ssr rsc payload ([#839](https://github.com/hi-ogawa/vite-plugins/pull/839))
+- fix: wrap virtual to workaround module runner entry issues ([#832](https://github.com/hi-ogawa/vite-plugins/pull/832))
+- fix: scan build in two environments ([#820](https://github.com/hi-ogawa/vite-plugins/pull/820))
+- refactor: simplify client reference mapping ([#836](https://github.com/hi-ogawa/vite-plugins/pull/836))
+- refactor!: remove `entries.css` ([#831](https://github.com/hi-ogawa/vite-plugins/pull/831))
+- refactor: client reference ssr preinit/preload via proxy and remove `prepareDestination` ([#828](https://github.com/hi-ogawa/vite-plugins/pull/828))
+- refactor: tweak asset links api ([#826](https://github.com/hi-ogawa/vite-plugins/pull/826))
+
+## v0.1.1 (2025-05-07)
+
+- fix: statically import client references virtual ([#815](https://github.com/hi-ogawa/vite-plugins/pull/815))
+- fix: fix base for findSourceMapURL ([#812](https://github.com/hi-ogawa/vite-plugins/pull/812))
+- fix: fix module runner line offset in `findSourceMapURL` ([#810](https://github.com/hi-ogawa/vite-plugins/pull/810))
+
+## v0.1.0 (2025-05-01)
+
+- feat: support `findSourceMapURL` for `createServerReference` ([#796](https://github.com/hi-ogawa/vite-plugins/pull/796))
+- feat: support `findSourceMapURL` for component stack and replay logs ([#779](https://github.com/hi-ogawa/vite-plugins/pull/779))
+- feat: support temporary references ([#776](https://github.com/hi-ogawa/vite-plugins/pull/776))
+- feat: support custom base ([#775](https://github.com/hi-ogawa/vite-plugins/pull/775))
+- feat: refactor assets manifest and expose it to rsc build ([#767](https://github.com/hi-ogawa/vite-plugins/pull/767))
+- feat: ssr modulepreload only for build ([#763](https://github.com/hi-ogawa/vite-plugins/pull/763))
+- feat: tree shake unused reference exports ([#761](https://github.com/hi-ogawa/vite-plugins/pull/761))
+- feat: re-export react-server-dom ([#744](https://github.com/hi-ogawa/vite-plugins/pull/744))
+- feat: support css entry ([#737](https://github.com/hi-ogawa/vite-plugins/pull/737))
+- feat wrap client packages in virtual (support `clientPackages` options) ([#718](https://github.com/hi-ogawa/vite-plugins/pull/718))
+- feat: modulepreload client reference on ssr ([#703](https://github.com/hi-ogawa/vite-plugins/pull/703))
+- feat: create vite-rsc ([#692](https://github.com/hi-ogawa/vite-plugins/pull/692))