@ivogt/rsc-router 0.0.0-experimental.2 → 0.0.0-experimental.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ivogt/rsc-router",
-  "version": "0.0.0-experimental.2",
+  "version": "0.0.0-experimental.3",
   "type": "module",
   "description": "Type-safe RSC router with partial rendering support",
   "author": "Ivo Todorov",

package/src/vite/index.ts

@@ -21,6 +21,31 @@ export { exposeLocationStateId } from "./expose-location-state-id.ts";
 
 // Virtual module type declarations in ./version.d.ts
 
+/**
+ * Modules that must be excluded from Vite's dependency optimization.
+ *
+ * When rsc-router is installed from npm, Vite's dep optimizer bundles these modules
+ * into separate chunks. However, @vitejs/plugin-rsc creates virtual proxy modules
+ * for client components that import from the original source paths.
+ *
+ * This creates two different module instances:
+ * 1. Bundled version in /node_modules/.vite/deps/
+ * 2. Original source via plugin-rsc proxy
+ *
+ * When both instances create React Contexts (e.g., OutletContext), React sees them
+ * as different contexts, causing useContext to return undefined even when a Provider
+ * exists in the tree.
+ *
+ * By excluding these modules, we ensure a single module instance is used everywhere.
+ */
+const RSC_ROUTER_EXCLUDE_DEPS = [
+  "@ivogt/rsc-router",
+  "@ivogt/rsc-router/browser",
+  "@ivogt/rsc-router/client",
+  "@ivogt/rsc-router/internal/deps/browser",
+  "@ivogt/rsc-router/internal/deps/html-stream-client",
+];
+
 /**
  * Plugin to transform CJS react-server-dom vendor file to ESM.
  * The @vitejs/plugin-rsc package ships client.browser.js as CommonJS
@@ -455,6 +480,11 @@ export async function rscRouter(
       config() {
         // Configure environments for cloudflare deployment
         return {
+          // Exclude rsc-router modules from optimization to prevent module duplication
+          // This ensures the same Context instance is used by both browser entry and RSC proxy modules
+          optimizeDeps: {
+            exclude: RSC_ROUTER_EXCLUDE_DEPS,
+          },
           resolve: {
             alias: {
               // Map rsc-router/* to @ivogt/rsc-router/* for virtual entries
@@ -486,8 +516,10 @@ export async function rscRouter(
                 },
               },
               // Pre-bundle rsc-html-stream to prevent discovery during first request
+              // Exclude rsc-router modules to ensure same Context instance
               optimizeDeps: {
                 include: ["rsc-html-stream/client"],
+                exclude: RSC_ROUTER_EXCLUDE_DEPS,
               },
             },
             ssr: {
@@ -569,6 +601,11 @@ export async function rscRouter(
           const useVirtualRSC = finalEntries.rsc === VIRTUAL_IDS.rsc;
 
           return {
+            // Exclude rsc-router modules from optimization to prevent module duplication
+            // This ensures the same Context instance is used by both browser entry and RSC proxy modules
+            optimizeDeps: {
+              exclude: RSC_ROUTER_EXCLUDE_DEPS,
+            },
             resolve: {
               alias: {
                 // Map rsc-router/* to @ivogt/rsc-router/* for virtual entries
@@ -599,12 +636,14 @@ export async function rscRouter(
                     },
                   },
                 },
-                ...(useVirtualClient && {
-                  optimizeDeps: {
+                // Always exclude rsc-router modules, conditionally add virtual entry
+                optimizeDeps: {
+                  exclude: RSC_ROUTER_EXCLUDE_DEPS,
+                  ...(useVirtualClient && {
                     // Tell Vite to scan the virtual entry for dependencies
                     entries: [VIRTUAL_IDS.browser],
-                  },
-                }),
+                  }),
+                },
               },
               ...(useVirtualSSR && {
                 ssr: {
@@ -612,6 +651,7 @@ export async function rscRouter(
                     entries: [VIRTUAL_IDS.ssr],
                     // Pre-bundle React for SSR to ensure single instance
                     include: ["react", "react-dom/server.edge", "react/jsx-runtime"],
+                    exclude: RSC_ROUTER_EXCLUDE_DEPS,
                   },
                 },
               }),