vite-plugin-react-server 1.2.0-alpha.1 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # Vite React Server Plugin
 
-A Vite plugin that enables React Server Components (RSC) streaming and static HTML page generation. This plugin enables a unique "Native ESM" developer experience based on the React Server Components specifications.
+A Vite plugin that enables React Server Components (RSC) streaming and static HTML page generation. This plugin uses **React conditions** to automatically provide the optimal implementation for each execution environment.
 
 **React Components as part of your build tooling** - not just as a dependency.
 
@@ -11,7 +11,7 @@ A Vite plugin that enables React Server Components (RSC) streaming and static HT
 - **Native ESM for React**: Your React components are true ESM modules that work anywhere
 - **React as Configuration**: Serialize React Server Components for static hosting
 - **On-Demand Loading**: Only streams the pages you're actually developing
-
+- **React condition**: Automatically adapts to client/server environments
 
 ## Quick Start
 
@@ -40,31 +40,152 @@ export default defineConfig({
 
 ```tsx
 // src/page.tsx
-export function Page({ url }) {
+export const Page = ({ url }: { url: string }) => {
   return <div>Hello from {url}</div>;
-}
+};
+```
+
+**Run the Development Server:**
+
+```bash
+NODE_OPTIONS="--conditions react-server" npx vite
+# or
+npx vite
 ```
 
+Both these commands show the same application with roughly the same developer experience.
+
+**React Condition System**
+
+The `react-server` condition is needed for the ESM system to consume the React dependencies. What it boils down to is the following semantics:
+
+- When we say we want to "render HTML", it means we need the client environment
+- When we say we want to "render RSC", it means we need the server environment
+
+Just like HTML, RSC is simply a string. It's the serialized product of your React Components. Since it's serialized, we are free to send it back and forth from one thread to another using worker threads. This plugin enables exactly this worker thread approach by managing the React condition for you. This explains why both:
+
+```bash
+NODE_OPTIONS="--conditions react-server" npx vite
+# or
+npx vite
+```
+
+Return the same application, but we now understand that the former will need an `html-worker` and the latter will need the `rsc-worker` to both serialize RSC and HTML.
+
+**Visit your app:** Open `http://localhost:5173` in your browser. You should see "Hello from /" displayed.
+
+**What's Next?**
+- Add more pages to `build.pages` array
+- Create server actions with `"use server"`
+- Add client components with `"use client"`
+- Customize your HTML template
+
 ## Development & Build
 
+The plugin supports both traditional multi-step builds and modern Environment API builds:
+
+### Traditional Build (Multi-Step)
+
+```bash
+# Build all environments separately
+npm run build:static    # vite build
+npm run build:client    # vite build --ssr  
+npm run build:server    # NODE_OPTIONS="--conditions react-server" vite build
+```
+
+**Note**: The traditional build approach is supported but may need configuration adjustments for proper server environment handling.
+
+### Environment API Build (Single-Step)
+
+The plugin now supports Vite's Environment API with two modes:
+
+#### Server-First Mode (Faster)
+```bash
+NODE_OPTIONS='--conditions react-server' vite build --app
+```
+- **Static generation** on main thread
+- **HTML rendering** via html-worker
+- **Benefits**: Faster execution, easier debugging, direct component access
+
+#### Client-First Mode (Isolated)
+```bash
+vite build --app
+```
+- **Static generation** on RSC worker thread  
+- **HTML rendering** on main thread
+- **Benefits**: Server thread isolation, custom RSC worker supportLsrve
+
+### Automatic Environment Detection
+
+The plugin uses Node.js conditions to automatically load the correct implementation:
+
+```typescript
+// The plugin automatically detects and loads the right implementation
+import { getCondition } from './config/getCondition.js';
+
+const condition = getCondition(); // Returns 'client' or 'server'
+const { vitePluginReactServer } = await import(`./plugin.${condition}.js`);
+```
+
+### Development Scripts
+
+#### Traditional approach:
+
+This has the benefit of controlling and debugging each build separately
+
 ```json
 {
+  "type": "module",
   "scripts": {
-    "dev": "NODE_OPTIONS='--conditions react-server' vite",
-    "dev:client": "vite",
-    "build": "vite build && vite build --ssr && NODE_OPTIONS='--conditions react-server' vite build",
-    "debug-build": "NODE_ENV=development && vite build --mode vite build --mode development && NODE_OPTIONS='--conditions react-server' vite build",
+    "dev:rsc": "NODE_OPTIONS='--conditions react-server' vite",
+    "dev:ssr": "vite",
+    "build": "NODE_OPTIONS='--conditions react-server' vite build --app",
+    "preview": "vite preview"
   }
 }
 ```
 
-- **`npm run dev`**: Server-side development with direct React pipeline
-- **`npm run dev:client`**: Client-side development with worker threads
-- **`npm run build`**: Creates optimized static, client, and server builds
+### Development Modes
+
+The plugin supports two development paradigms. Both produce **identical output** but differ in architecture:
+
+| Mode | Condition | Command | Architecture | Benefits |
+|------|-----------|---------|--------------|----------|
+| **RSC** | `react-server` | `npm run dev:rsc` | RSC on main thread | Easier debugging, React in config |
+| **SSR** | `null` (default) | `npm run dev:ssr` | RSC in worker | Better isolation, traditional SSR split |
 
-## Environment-Based Execution
+### Development Mode Details
 
-The plugin uses environment detection to determine execution context:
+- **`npm run dev:rsc`** (RSC Mode):
+  - Main thread has `react-server` condition
+  - RSC processing runs directly (no worker)
+  - Easier debugging - breakpoints work in server components
+  - Supports React in config files (e.g., `vite.react.config.tsx`)
+
+- **`npm run dev:ssr`** (SSR Mode):
+  - Main thread is client-focused
+  - RSC processing runs in isolated worker thread
+  - Closer to traditional SSR/client architecture
+
+### Build Process
+
+- **`npm run build`** (Build Environment):
+  1. **Static Build:** `vite build` → `dist/static/`
+  2. **Client Build:** `vite build --ssr` → `dist/client/`
+  3. **Server Build:** `NODE_OPTIONS="--conditions react-server" vite build --ssr` → `dist/server/` + final `dist/static/`
+     - `use client`/`use server` boundary transformations
+     - `index.html` and `index.rsc` to `dist/static/${route}` for each `build.pages`
+
+- **`npm run dev-build`**:
+  - Debug the build process
+  - Avoids the "this error message is hidden in production" and shows the full error
+  - Development build is not intended for production
+
+## React condition
+
+The plugin automatically adapts to different execution environments using Node.js conditions:
+
+### Environment Detection
 
 ```typescript
 import { getCondition } from "vite-plugin-react-server/config";
@@ -74,34 +195,61 @@ if (getCondition() !== "react-server") {
 }
 ```
 
-- **Client Mode** (default): Uses worker threads for RSC requests
-- **Server Mode** (`NODE_OPTIONS="--conditions react-server"`): Direct React pipeline
+### Execution Modes
+
+- **RSC Mode** (`npm run dev:rsc`):
+  - Condition: `react-server` on main thread
+  - RSC processing runs directly on the main Vite thread
+  - Easier debugging - breakpoints work in server components
+  - Supports React in config files
+
+- **SSR Mode** (`npm run dev:ssr`):
+  - Condition: default (client-focused main thread)
+  - RSC processing runs in isolated worker thread
+  - Traditional SSR/client architecture
+
+- **Build Mode** (`npm run build`):
+  - Command: `NODE_OPTIONS='--conditions react-server' vite build --app`
+  - Builds all Vite environments (client, ssr, server)
+  - Generates static HTML files
+
+### Module Structure
+
+The plugin uses condition-based module loading:
+
+```
+plugin/
+├── index.ts                    # Main entry point with condition detection
+├── plugin.client.ts            # Client environment implementation
+├── plugin.server.ts            # Server environment implementation
+├── dev-server/
+│   ├── index.ts                # Condition-based loader
+│   ├── index.client.ts         # Client implementation
+│   ├── index.server.ts         # Server implementation
+│   └── ...                     # Other modules follow same pattern
+└── ...
+```
+
+This ensures:
+- **Client environments** get lightweight, browser-compatible implementations
+- **Server environments** get full-featured RSC processing capabilities
+- **No runtime overhead** from unused server code in client environments
 
 ## Advanced Features
 
 ### Props and Routing
 
 ```tsx
-// React components configure routing
-const createRouter = (file) => (url) => {
-  switch (url) {
-    case "/": return `src/home/${file}`;
-    case "/about": return `src/about/${file}`;
-    default: return `src/404/${file}`;
-  }
-};
-
+// Simple string-based routing
 export default defineConfig({
   plugins: vitePluginReactServer({
-    Page: createRouter("page.tsx"),
-    props: createRouter("props.ts"),
+    Page: "src/page/page.tsx",
+    props: "src/page/props.ts",
     build: { pages: ["/", "/about"] }
   }),
 });
 ```
 
-
-
 ### Server Actions
 
 ```tsx
@@ -121,6 +269,16 @@ export function TodoForm() {
 
 ### Client Components
 
+```tsx
+// src/components/Link.client.tsx
+"use client";
+import React from 'react';
+
+export function Link({ to, children }: { to: string, children: React.ReactNode }) {
+  return <a href={to}>{children}</a>;
+}
+```
+
 ```tsx
 // Counter.client.tsx
 "use client";
@@ -132,30 +290,13 @@ export function Counter() {
 }
 ```
 
-## Build Output
-
-The plugin generates three build targets:
-
-```
-dist/
-├── static/     # Browser-ready static files (HTML + RSC)
-├── client/     # Server-side rendering modules  
-└── server/     # React Server Components modules
-```
-
+**Key Points:**
+- Use `"use client"` directive at the top of client component files
+- Use `.client.` suffix in filenames for auto-discovery
+- Client components can use React hooks and browser APIs
+- They're automatically transformed and optimized during build
 
-## Documentation
 
-| Topic | Description |
-|-------|-------------|
-| [Getting Started](./docs/getting-started.md) | Complete installation and setup guide |
-| [Core Concepts](./docs/core-concepts.md) | Architecture, RSC, and plugin design |
-| [Configuration](./docs/configuration.md) | All configuration options and examples |
-| [CSS Handling](./docs/css-handling.md) | CSS collection, inlining, and optimization |
-| [Server Actions](./docs/server-actions.md) | Server-side functions and database integration |
-| [Static Site Generation](./docs/static-site-generation.md) | Building and deploying static sites |
-| [API Reference](./docs/api-reference.md) | Complete API documentation |
-| [Advanced Topics](./docs/advanced-topics.md) | Custom workers and extending the plugin |
 
 ## Requirements
 
@@ -167,6 +308,25 @@ dist/
 
 This project uses experimental React features and includes a patch system for compatibility. See [Patch System](./docs/patch-system.md) for maintenance details.
 
+## Documentation
+
+| Topic |
+|-------|
+| [Getting Started](./docs/getting-started.md) |
+| [Core Concepts](./docs/core-concepts.md) |
+| [Configuration Guide](./docs/configuration.md) |
+| [CSS & Styling](./docs/css-handling.md) |
+| [Server Actions](./docs/server-actions.md) |
+| [Build & Deployment](./docs/build-orchestration.md) |
+| [Advanced Development](./docs/advanced-topics.md) |
+| [Plugin Internals](./docs/transformer-plugin.md) |
+| [Worker System](./docs/rsc-worker.md) |
+| [API Reference](./docs/api-reference.md) |
+| [React Compatibility](./docs/react-type-compatibility.md) |
+| [Troubleshooting](./docs/troubleshooting-guide.md) |
+| [Package Exports](./docs/package-exports.md) |
+
+
 ## License
 
-MIT License - see [LICENSE](./LICENSE) file for details.
+MIT License - see [LICENSE](./LICENSE) file for details.

package/dist/client.d.ts

@@ -1,4 +1,7 @@
-export * from './plugin/plugin.client.js';
+export { vitePluginReactServer } from "./plugin/plugin.client.js";
 export * from './plugin/react-client/index.js';
+export { handleServerAction } from './plugin/dev-server/index.js';
+export { handleRscStream } from './plugin/stream/index.js';
 export type * from './plugin/types.js';
+export type * from './plugin/react-client/types.js';
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAKA,cAAc,2BAA2B,CAAA;AACzC,cAAc,gCAAgC,CAAA;AAE9C,mBAAmB,mBAAmB,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAGjE,cAAc,gCAAgC,CAAA;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,gCAAgC,CAAA"}

package/dist/client.js

@@ -3,9 +3,8 @@
  * Copyright (c) Nico Brinkkemper
  * MIT License
  */
-export { vitePluginReactClient, vitePluginReactServer } from './plugin/plugin.client.js';
-export { createWorkerStream } from './plugin/react-client/createWorkerStream.js';
-export { handleWorkerRscStream } from './plugin/react-client/handleWorkerRscStream.js';
-export { handleWorkerServerAction } from './plugin/react-client/handleWorkerServerAction.js';
-export { reactClientPlugin } from './plugin/react-client/plugin.js';
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlcyI6W10sInNvdXJjZXNDb250ZW50IjpbXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7OyJ9
+export { vitePluginReactServer } from './plugin/plugin.client.js';
+export { reactClientPlugin } from './plugin/react-client/index.js';
+export { handleServerAction } from './plugin/dev-server/index.js';
+export { handleRscStream } from './plugin/stream/index.js';
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlcyI6W10sInNvdXJjZXNDb250ZW50IjpbXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7In0=

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-export declare const vitePluginReactServer: any;
-export type * from './plugin/types.js';
+import type { VitePluginReactClientFn, VitePluginReactServerFn } from "./plugin/types.js";
+export declare const vitePluginReactServer: VitePluginReactServerFn, vitePluginReactClient: VitePluginReactClientFn;
+export type * from "./plugin/types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,KAKhC,CAAA;AAGF,mBAAmB,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAQ3B,eAAO,MAAQ,qBAAqB,2BAAE,qBAAqB,yBAK1D,CAAC;AAGF,mBAAmB,mBAAmB,CAAC"}

package/dist/index.js

@@ -3,15 +3,12 @@
  * Copyright (c) Nico Brinkkemper
  * MIT License
  */
-import __variableDynamicImportRuntimeHelper from './_virtual/dynamic-import-helper.js';
+import { getCondition } from './plugin/config/getCondition.js';
 
-const condition = process.env["NODE_OPTIONS"]?.match(/--conditions[= ]react-server/) ? "server" : "client";
-const vitePluginReactServer = await __variableDynamicImportRuntimeHelper((/* #__PURE__ */ Object.assign({})), `./plugin/react-server/plugin.${condition}.js`, 4).then((m) => {
-  if (!("vitePluginReactServer" in m)) {
-    throw new Error(`Could not find vitePluginReactServer in ./plugin/react-server/plugin.${condition}.js`);
-  }
-  return m["vitePluginReactServer"];
-});
+const condition = getCondition("");
+const dir = new URL("./", import.meta.url).pathname.replace(/\/$/, "");
+console.log(`[index.ts] Condition: ${condition}, importing: ${dir}/plugin/plugin.${condition}.js`);
+const { vitePluginReactServer, vitePluginReactClient } = await import(`${dir}/plugin/plugin.${condition}.js`);
 
-export { vitePluginReactServer };
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VzIjpbIi4uL2luZGV4LnRzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5jb25zdCBjb25kaXRpb24gPSBwcm9jZXNzLmVudlsnTk9ERV9PUFRJT05TJ10/Lm1hdGNoKC8tLWNvbmRpdGlvbnNbPSBdcmVhY3Qtc2VydmVyLykgPyAnc2VydmVyJyA6ICdjbGllbnQnXG5cbmV4cG9ydCBjb25zdCB2aXRlUGx1Z2luUmVhY3RTZXJ2ZXIgPSBhd2FpdCBpbXBvcnQoYC4vcGx1Z2luL3JlYWN0LXNlcnZlci9wbHVnaW4uJHtjb25kaXRpb259LmpzYCkudGhlbihtID0+IHtcbiAgaWYoISgndml0ZVBsdWdpblJlYWN0U2VydmVyJyBpbiBtKSl7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBDb3VsZCBub3QgZmluZCB2aXRlUGx1Z2luUmVhY3RTZXJ2ZXIgaW4gLi9wbHVnaW4vcmVhY3Qtc2VydmVyL3BsdWdpbi4ke2NvbmRpdGlvbn0uanNgKTtcbiAgfVxuICByZXR1cm4gbVsndml0ZVBsdWdpblJlYWN0U2VydmVyJ11cbn0pXG5cbi8vIHR5cGVzXG5leHBvcnQgdHlwZSAqIGZyb20gJy4vcGx1Z2luL3R5cGVzLmpzJyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7O0FBRUEsTUFBTSxTQUFBLEdBQVksUUFBUSxHQUFJLENBQUEsY0FBYyxHQUFHLEtBQU0sQ0FBQSw4QkFBOEIsSUFBSSxRQUFXLEdBQUEsUUFBQTtBQUUzRixNQUFNLHdCQUF3QixNQUFNLG9DQUFBLG1DQUFBLEdBQUEsQ0FBQSw2QkFBQSxFQUFBLFNBQUEsQ0FBQSxHQUFBLENBQUEsRUFBQSxDQUFBLENBQWdELENBQU8sS0FBSyxDQUFLLENBQUEsS0FBQTtBQUMxRyxFQUFHLElBQUEsRUFBRSwyQkFBMkIsQ0FBRyxDQUFBLEVBQUE7QUFDakMsSUFBQSxNQUFNLElBQUksS0FBQSxDQUFNLENBQXdFLHFFQUFBLEVBQUEsU0FBUyxDQUFLLEdBQUEsQ0FBQSxDQUFBO0FBQUE7QUFFeEcsRUFBQSxPQUFPLEVBQUUsdUJBQXVCLENBQUE7QUFDbEMsQ0FBQzs7OzsifQ==
+export { vitePluginReactClient, vitePluginReactServer };
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VzIjpbIi4uL2luZGV4LnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGdldENvbmRpdGlvbiB9IGZyb20gXCIuL3BsdWdpbi9jb25maWcvZ2V0Q29uZGl0aW9uLmpzXCI7XG5pbXBvcnQgdHlwZSB7XG4gIFZpdGVQbHVnaW5SZWFjdENsaWVudEZuLFxuICBWaXRlUGx1Z2luUmVhY3RTZXJ2ZXJGbixcbn0gZnJvbSBcIi4vcGx1Z2luL3R5cGVzLmpzXCI7XG5cbmNvbnN0IGNvbmRpdGlvbiA9IGdldENvbmRpdGlvbihcIlwiKTtcbi8vIG5vIHRyYWlsaW5nIHNsYXNoXG5jb25zdCBkaXIgPSBuZXcgVVJMKFwiLi9cIiwgaW1wb3J0Lm1ldGEudXJsKS5wYXRobmFtZS5yZXBsYWNlKC9cXC8kLywgXCJcIik7XG5cbmNvbnNvbGUubG9nKGBbaW5kZXgudHNdIENvbmRpdGlvbjogJHtjb25kaXRpb259LCBpbXBvcnRpbmc6ICR7ZGlyfS9wbHVnaW4vcGx1Z2luLiR7Y29uZGl0aW9ufS5qc2ApO1xuXG5leHBvcnQgY29uc3QgeyB2aXRlUGx1Z2luUmVhY3RTZXJ2ZXIsIHZpdGVQbHVnaW5SZWFjdENsaWVudCB9ID0gKGF3YWl0IGltcG9ydChcbiAgYCR7ZGlyfS9wbHVnaW4vcGx1Z2luLiR7Y29uZGl0aW9ufS5qc2BcbikpIGFzIHtcbiAgdml0ZVBsdWdpblJlYWN0U2VydmVyOiBWaXRlUGx1Z2luUmVhY3RTZXJ2ZXJGbjtcbiAgdml0ZVBsdWdpblJlYWN0Q2xpZW50OiBWaXRlUGx1Z2luUmVhY3RDbGllbnRGbjtcbn07XG5cbi8vIHR5cGVzXG5leHBvcnQgdHlwZSAqIGZyb20gXCIuL3BsdWdpbi90eXBlcy5qc1wiO1xuIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7QUFNQSxNQUFNLFNBQUEsR0FBWSxhQUFhLEVBQUUsQ0FBQTtBQUVqQyxNQUFNLEdBQUEsR0FBTSxJQUFJLEdBQUEsQ0FBSSxJQUFNLEVBQUEsTUFBQSxDQUFBLElBQUEsQ0FBWSxHQUFHLENBQUUsQ0FBQSxRQUFBLENBQVMsT0FBUSxDQUFBLEtBQUEsRUFBTyxFQUFFLENBQUE7QUFFckUsT0FBQSxDQUFRLElBQUksQ0FBeUIsc0JBQUEsRUFBQSxTQUFTLGdCQUFnQixHQUFHLENBQUEsZUFBQSxFQUFrQixTQUFTLENBQUssR0FBQSxDQUFBLENBQUE7QUFFcEYsTUFBQSxFQUFFLHVCQUF1QixxQkFBc0IsRUFBQSxHQUFLLE1BQU0sT0FDckUsQ0FBQSxFQUFHLEdBQUcsQ0FBQSxlQUFBLEVBQWtCLFNBQVMsQ0FBQSxHQUFBLENBQUE7Ozs7In0=

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "vite-plugin-react-server",
-    "version": "1.2.0-alpha.1",
+    "version": "1.2.0",
     "description": "Vite plugin for React Server Components (RSC)",
     "type": "module",
     "main": "./dist/plugin/index.js",
@@ -24,20 +24,36 @@
         "./rsc-worker": "./dist/plugin/worker/rsc/index.js",
         "./worker": "./dist/plugin/worker/index.js",
         "./package.json": "./package.json",
-        "./patch": "./scripts/patch.mjs",
+        "./patch": "./bin/patch.mjs",
         "./check-react-version": "./scripts/check-react-version.mjs",
         "./components": "./dist/plugin/components/index.js",
         "./types": "./dist/plugin/types.js",
-        "./utils": "./dist/plugin/utils/index.js",
+        "./utils": {
+            "react-server": "./dist/plugin/utils/index.server.js",
+            "default": "./dist/plugin/utils/index.js"
+        },
         "./metrics": "./dist/plugin/metrics/index.js",
+        "./stream": "./dist/plugin/stream/index.js",
+        "./stream/client": "./dist/plugin/stream/index.client.js",
+        "./stream/server": "./dist/plugin/stream/index.server.js",
         "./env": "./dist/plugin/env/plugin.js",
         "./config": "./dist/plugin/config/index.js",
         "./error": "./dist/plugin/error/index.js",
         "./vendor": "./dist/plugin/vendor/index.js",
+        "./vendor.server": "./dist/plugin/vendor/vendor.server.js",
+        "./vendor.client": "./dist/plugin/vendor/vendor.client.js",
+        "./vendor.static": "./dist/plugin/vendor/vendor.static.js",
         "./file-preserver": "./dist/plugin/file-preserver/plugin.js",
         "./loader": "./dist/plugin/loader/index.js",
         "./helpers": "./dist/plugin/helpers/index.js",
-        "./react-loader": "./dist/plugin/loader/react-loader.js",
+        "./helpers/resolveStreamElements": "./dist/plugin/helpers/resolveStreamElements.js",
+        "./dev-server": "./dist/plugin/dev-server/index.js",
+        "./dev-server/configureReactServer": "./dist/plugin/dev-server/configureReactServer.js",
+        "./dev-server/handleServerAction": "./dist/plugin/dev-server/handleServerAction.js",
+        "./stream/handleRscStream": "./dist/plugin/stream/handleRscStream.js",
+        "./stream/createRscStream": "./dist/plugin/stream/createRscStream.js",
+        "./dev-server/restartWorker": "./dist/plugin/dev-server/restartWorker.js",
+        "./dev-server/cleanupServerAction": "./dist/plugin/dev-server/cleanupServerAction.js",
         "./env-loader": "./dist/plugin/loader/env-loader.js",
         "./css-loader": "./dist/plugin/loader/css-loader.js",
         "./directives": "./dist/plugin/loader/directives/index.js"
@@ -54,7 +70,7 @@
                 "./dist/plugin/react-server/plugin.d.ts"
             ],
             "static": [
-                "./dist/plugin/static/plugin.d.ts"
+                "./dist/plugin/react-static/index.d.ts"
             ],
             "components": [
                 "./dist/plugin/components/index.d.ts"
@@ -65,12 +81,30 @@
             "metrics": [
                 "./dist/plugin/metrics/index.d.ts"
             ],
+            "stream": [
+                "./dist/plugin/stream/index.d.ts"
+            ],
+            "stream/client": [
+                "./dist/plugin/stream/index.client.d.ts"
+            ],
+            "stream/server": [
+                "./dist/plugin/stream/index.server.d.ts"
+            ],
             "config": [
                 "./dist/plugin/config/index.d.ts"
             ],
             "env": [
                 "./dist/plugin/env/plugin.d.ts"
             ],
+            "vendor.server": [
+                "./dist/plugin/vendor/vendor.server.d.ts"
+            ],
+            "vendor.client": [
+                "./dist/plugin/vendor/vendor.client.d.ts"
+            ],
+            "vendor.static": [
+                "./dist/plugin/vendor/vendor.static.d.ts"
+            ],
             "vendor": [
                 "./dist/plugin/vendor/index.d.ts"
             ],
@@ -95,8 +129,26 @@
             "helpers": [
                 "./dist/plugin/helpers/index.d.ts"
             ],
+            "dev-server": [
+                "./dist/plugin/dev-server/index.d.ts"
+            ],
+            "dev-server/configureReactServer": [
+                "./dist/plugin/dev-server/configureReactServer.d.ts"
+            ],
+            "dev-server/handleServerAction": [
+                "./dist/plugin/dev-server/handleServerAction.d.ts"
+            ],
+            "stream/handleRscStream": [
+                "./dist/plugin/stream/handleRscStream.d.ts"
+            ],
+            "stream/createRscStream": [
+                "./dist/plugin/stream/createRscStream.d.ts"
+            ],
             "directives": [
                 "./dist/plugin/loader/directives/index.d.ts"
+            ],
+            "helpers/resolveStreamElements": [
+                "./dist/plugin/helpers/resolveStreamElements.d.ts"
             ]
         }
     },
@@ -105,6 +157,8 @@
         "version:major": "node scripts/bump-version.mjs major",
         "version:minor": "node scripts/bump-version.mjs minor",
         "version:patch": "node scripts/bump-version.mjs patch",
+        "docs:toc": "node scripts/generate-toc.mjs",
+        "docs:remove-toc": "node scripts/remove-toc.mjs",
         "build": "npm run clean && npm run build:types && npm run build:vite",
         "build:types": "tsc --build --force",
         "build:vite": "vite build && chmod +x bin/patch.mjs",
@@ -112,30 +166,47 @@
         "prepublishOnly": "npm run build",
         "lint": "eslint ./plugin --fix",
         "setup:test-fixtures": "npx tsx test/setup.ts",
-        "test:server": "NODE_OPTIONS='--conditions react-server' vitest run test/server",
-        "test:client": "vitest run test/client",
-        "test:build": "NODE_OPTIONS='--conditions react-server' vitest run test/server/build.test.ts",
-        "test:unit": "NODE_OPTIONS='--conditions react-server' vitest run test/unit;",
+        "pretest:server": "npm run build",
+        "test:server": "NODE_OPTIONS='--conditions react-server' vitest run",
+        "pretest:client": "npm run build",
+        "test:client": "vitest run",
+        "test:examples": "npm run test:both -- test/examples",
+        "test:streams": "npm run test:both -- test/streams",
+        "test:dev": "NODE_OPTIONS='--conditions react-server' vitest run test/dev",
+        "pretest:both": "npm run build",
+        "test:both": "./scripts/test-both.sh",
+        "test:build": "npm run test:examples -- test/examples/build.test.ts",
+        "test:unit": "NODE_OPTIONS='--conditions react-server' vitest run test/unit/*",
         "test:tee": "rm -f build.log && npm run test:build 2>&1 | tee build.log",
         "test:rsc-worker": "npm run build && vitest run test/client/rsc-worker.test.ts",
-        "test:large-html": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/large-html.test.ts",
-        "test:metrics": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/metrics.test.ts",
-        "test:hooks": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/hooks.test.ts",
-        "test:inline-css": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/inline-css.test.ts",
-        "test:dev-server-env": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/dev-server-env.test.ts",
-        "test:rsc-server": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/rsc-server.test.ts",
+        "test:large-html": "npm run test:examples -- test/examples/large-html-handling.test.ts",
+        "test:metrics": "npm run test:examples -- test/examples/metrics.test.ts",
+        "test:error-boundaries": "npm run test:examples -- test/examples/error-boundaries-build.test.ts test/examples/error-boundaries.test.ts",
+        "test:inline-css": "npm run test:examples -- test/examples/inline-css.test.ts",
+        "test:dev-server-env": "npm run test:dev -- test/dev/dev-server-env.test.ts",
+        "test:rsc-server": "npm run test:dev -- test/dev/rsc-server.test.ts",
+        "test:stress": "npm run build && vitest run test/stress",
+        "stress-test": "npx tsx test/stress/stress-test-cli.ts",
         "test:client-env": "npm run build && vitest run test/client/dev-client-server-env.test.ts",
-        "test:todo": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/todo.test.ts",
-        "test:server-action": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/server-action.test.ts",
+        "test:todo": "npm run test:examples -- test/examples/todo-server-actions.test.ts",
+        "test:server-action": "npm run test:examples -- test/examples/server-actions.test.ts",
         "test:server-action-client": "npm run build && vitest run test/client/server-action.test.ts",
-        "test:server-action-integration": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/server/server-action-integration.test.ts",
-        "test:directives": "npm run build && NODE_OPTIONS='--conditions react-server' vitest run test/unit/analyzeModule",
-        "test:server-action-integration-client": "npm run build && vitest run test/client/server-action-integration.test.ts",
-        "test": "npm run build && npm run test:server && npm run test:client && npm run test:unit",
+        "test:server-action-integration": "npm run test:examples -- test/examples/server-action-integration.test.ts",
+        "test:directives": "npm run test -- test/unit/analyzeModule",
+        "test:server-action-integration-client": "vitest run test/client/server-action-integration.test.ts",
+        "test:cors": "node test/cors-test.js",
+        "test:typecheck": "NODE_OPTIONS='--conditions react-server' vitest run ./test/types --typecheck ",
+        "pretest": "npm run build",
+        "test-all": "npm run test:server && npm run test:client && npm run test:unit && npm run test:typecheck",
+        "test": "npm run test:both",
+        "test:e2e": "playwright test",
+        "test:e2e:server": "npx tsx test/e2e/server.ts",
         "test-base-url": "export BASE_URL='/test-base-url/' && npm run build && npm run test:server",
-        "test:coverage": "npm run setup:test-fixtures && NODE_OPTIONS='--conditions react-server' vitest run --coverage",
+        "test:coverage": "NODE_OPTIONS='--conditions react-server' vitest run --typecheck --coverage",
         "test:ui": "npm run setup:test-fixtures && vitest --ui",
         "test:bidoof-template": "cd ../bidoof-template && npm run build:preview",
+        "test:mmc": "cd ../mmc && npm run build",
+        "test:app-build": "cd ../bidoof-template && npx vite build --app; cd -",
         "experimental:clean-install": "npm install react-server-dom-esm react@experimental react-dom@experimental react-server-dom-esm --save-peer",
         "experimental:copy": "cp -r ./oss-experimental/* ./node_modules/",
         "experimental:patch": "npx patch-package react-server-dom-esm react react-dom --exclude 'nothing'",
@@ -143,7 +214,9 @@
         "experimental:setup": "rm -rf patches/* && npm run experimental:clean-install && npm run experimental:copy && npm run experimental:patch && npm run experimental:move-patches",
         "experimental:patch-react": "npm run experimental:clean-install && node scripts/check-react-version.mjs && node bin/patch.mjs",
         "postinstall": "patch-package",
-        "test-parse": "node -e \"const acorn = require('acorn'); const ast = acorn.parse('export async function test() {}', { sourceType: 'module', ecmaVersion: 'latest' }); console.log(JSON.stringify(ast, null, 2));\""
+        "test-parse": "node -e \"const acorn = require('acorn'); const ast = acorn.parse('export async function test() {}', { sourceType: 'module', ecmaVersion: 'latest' }); console.log(JSON.stringify(ast, null, 2));\"",
+        "precoverage": "npm run build",
+        "coverage": "npm run test:coverage"
     },
     "keywords": [
         "vite",
@@ -166,8 +239,8 @@
     },
     "homepage": "https://github.com/nicobrinkkemper/vite-plugin-react-server#readme",
     "peerDependencies": {
-        "react": "^0.0.0-experimental-0ff1d13b-20250507",
-        "react-dom": "^0.0.0-experimental-0ff1d13b-20250507",
+        "react": "^0.0.0-experimental-f93b9fd4-20251217",
+        "react-dom": "^0.0.0-experimental-f93b9fd4-20251217",
         "react-server-dom-esm": "^0.0.1",
         "vite": "*"
     },
@@ -184,6 +257,7 @@
     },
     "devDependencies": {
         "@eslint/js": "^9.28.0",
+        "@playwright/test": "^1.58.1",
         "@types/react": "^19.0.9",
         "@types/react-dom": "^19.0.3",
         "@vitest/coverage-v8": "^3.0.4",
@@ -193,14 +267,15 @@
         "globals": "^16.2.0",
         "happy-dom": "^17.1.8",
         "patch-package": "^8.0.0",
-        "rollup": "^4.34.0",
+        "playwright": "^1.58.1",
         "source-map": "^0.7.4",
+        "supports-color": "^10.0.0",
         "ts-node": "^10.9.2",
         "tslib": "^2.8.1",
         "tsx": "^4.19.2",
         "typescript": "^5.7.3",
         "typescript-eslint": "^8.33.1",
-        "vite": "^6.0.11",
+        "vite": "^6.3.5",
         "vitest": "^3.0.4",
         "webpack-sources": "^3.2.3"
     },