phantom-build 0.4.1 → 0.4.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Randy Wilson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,7 +10,7 @@ npm install phantom-build
 
 ## What It Does
 
-Phantom runs at build time (Vite or Webpack) and does two things:
+Phantom runs at build time (Vite, Webpack, or Rspack) and does two things:
 
 **1. Handler extraction** — Event handlers that touch browser APIs (`window`, `document`, `localStorage`, etc.) are extracted into separate chunks and loaded on-demand when the user first interacts.
 
@@ -112,7 +112,7 @@ export function InteractiveComponent() {
 Phantom produces:
 
 - **Client code** — handlers are replaced with lightweight stubs that lazy-load the real logic on first click
-- **Chunk modules** — each handler's logic lives in its own small file, loaded on demand
+- **Chunk modules** — handlers from the same source file are grouped into a single chunk module, loaded on demand
 
 The stub calls `e.preventDefault()` and `e.stopPropagation()` synchronously (before the import), so critical event behavior is never delayed. The heavy logic (`window.location.href`, `localStorage`, etc.) loads asynchronously.
 
@@ -227,6 +227,12 @@ phantom({
 
   // SSR mode: skip all transforms for server builds. Default: false
   ssr: false,
+
+  // Automatically detect SSR boundaries for components.
+  // 'auto': Analyze and add results to manifest (report-only)
+  // 'annotate': Prepend "use client" to ClientOnly modules
+  // false: Disabled (default)
+  ssrBoundaries: false,
 })
 ```
 
@@ -264,6 +270,24 @@ export default {
 };
 ```
 
+#### Rsbuild
+
+```ts
+// rsbuild.config.server.ts
+import { defineConfig } from '@rsbuild/core';
+import { pluginReact } from '@rsbuild/plugin-react';
+import phantom from 'phantom-build/rspack';
+
+export default defineConfig({
+  plugins: [pluginReact()],
+  tools: {
+    rspack: {
+      plugins: [phantom({ ssr: true })],
+    },
+  },
+});
+```
+
 #### Typical Setup
 
 Most custom SSR setups (e.g., .NET + React, Express + React) use two bundler configs:
@@ -492,7 +516,7 @@ node benchmarks/lighthouse-compare.mjs --runs=5
 
 - Node.js >= 18
 - React 16.6+ (for `React.lazy` and `Suspense`)
-- Vite or Webpack
+- Vite, Webpack, or Rspack (Rsbuild)
 - For SSR: any custom server setup (Express, .NET, etc.) — not framework-specific
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phantom-build",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Automatic code-splitting for React — extracts event handlers into lazy-loaded chunks and wraps below-fold components in React.lazy + Suspense at build time",
   "type": "module",
   "main": "./dist/index.js",