@funstack/static 0.0.2 → 0.0.3

package/dist/docs/learn/SSR.md

@@ -0,0 +1,104 @@
+# Server-Side Rendering
+
+In FUNSTACK Static, **Server-Side Rendering (SSR)** means a build-time process that pre-renders your React components (including client components) to HTML. This can make the initial paint faster.
+
+FUNSTACK Static supports a `ssr` option to enable SSR. This page explains when to enable this option and what to consider.
+
+## What is SSR?
+
+By default, FUNSTACK Static renders only the Root shell to HTML. The App component is delivered as an RSC payload and rendered client-side. When you enable `ssr: true`, the App component is also rendered to HTML at build time:
+
+```typescript
+funstackStatic({
+  root: "./src/root.tsx",
+  app: "./src/App.tsx",
+  ssr: true,
+});
+```
+
+## Pros
+
+### Faster Paint on Initial Page Load
+
+With SSR enabled, the full page content is visible in the HTML before JavaScript loads. Users see meaningful content immediately, rather than waiting for JavaScript to download, parse, and execute.
+
+This improves perceived performance, especially on:
+
+- Slower network connections
+- Lower-powered devices
+- Pages with significant content above the fold
+
+The browser can start painting content as soon as the HTML arrives, while JavaScript loads in the background. Once loaded, React hydrates the existing HTML to make it interactive.
+
+## Cons
+
+### Client Components Must Be SSR-Capable
+
+When SSR is enabled, your client components run during the build process to generate HTML. This means they must work in a server-like environment where browser APIs are not available.
+
+Components that directly access browser-only APIs will cause build errors:
+
+```tsx
+"use client";
+
+// This will fail during SSR build
+export function BrowserOnlyComponent() {
+  const width = window.innerWidth; // window is not defined during SSR
+  return <div>Width: {width}</div>;
+}
+```
+
+To make components SSR-capable, use `useSyncExternalStore` with a server snapshot:
+
+```tsx
+"use client";
+
+import { useSyncExternalStore } from "react";
+
+function subscribeToWidth(callback: () => void) {
+  window.addEventListener("resize", callback);
+  return () => window.removeEventListener("resize", callback);
+}
+
+function getWidth() {
+  return window.innerWidth;
+}
+
+function getServerWidth() {
+  return 0; // Fallback value during SSR
+}
+
+export function SSRSafeComponent() {
+  const width = useSyncExternalStore(
+    subscribeToWidth,
+    getWidth,
+    getServerWidth,
+  );
+  return <div>Width: {width}</div>;
+}
+```
+
+Common browser APIs to watch for:
+
+- `window` and `document`
+- `localStorage` and `sessionStorage`
+- `location` (use your router's APIs instead)
+
+## When to Use SSR
+
+**Enable SSR when:**
+
+- You want the fastest possible initial paint
+- Your client components are already SSR-compatible
+- You're building content-heavy pages
+
+**Keep SSR disabled when:**
+
+- Your app relies heavily on browser-only APIs
+- You prefer simpler client component development
+- Initial paint speed is not a priority
+
+## See Also
+
+- [How It Works](/funstack-static/learn/how-it-works) - Understanding the build process
+- [funstackStatic()](/funstack-static/api/funstack-static) - Configuration reference

package/dist/entries/client.d.mts

@@ -1 +1 @@
-export { };
+import "../client/entry.mjs";

package/dist/entries/rsc-client.d.mts

@@ -1,3 +1,3 @@
-import { ClientWrapper, RegistryContext } from "../rsc-client/clientWrapper.mjs";
+import { DeferredComponent, RegistryContext } from "../rsc-client/clientWrapper.mjs";
 import "../rsc-client/entry.mjs";
-export { ClientWrapper, RegistryContext };
+export { DeferredComponent, RegistryContext };

package/dist/entries/rsc-client.mjs

@@ -1,6 +1,6 @@
 "use client";
 
-import { ClientWrapper, RegistryContext } from "../rsc-client/clientWrapper.mjs";
+import { DeferredComponent, RegistryContext } from "../rsc-client/clientWrapper.mjs";
 import "../rsc-client/entry.mjs";
 
-export { ClientWrapper, RegistryContext };
+export { DeferredComponent, RegistryContext };

package/dist/entries/server.d.mts

@@ -1,2 +1,2 @@
-import { defer } from "../rsc/defer.mjs";
-export { defer };
+import { DeferOptions, defer } from "../rsc/defer.mjs";
+export { type DeferOptions, defer };

package/dist/plugin/index.d.mts

@@ -19,11 +19,27 @@ interface FunstackStaticOptions {
    * @default dist/public
    */
   publicOutDir?: string;
+  /**
+   * Enable server-side rendering of the App component.
+   * When false, only the Root shell is SSR'd and the App renders client-side.
+   * When true, both Root and App are SSR'd and the client hydrates.
+   *
+   * @default false
+   */
+  ssr?: boolean;
+  /**
+   * Path to a module that runs on the client side before React hydration.
+   * Use this for client-side instrumentation like Sentry, analytics, or feature flags.
+   * The module is imported for its side effects only (no exports needed).
+   */
+  clientInit?: string;
 }
 declare function funstackStatic({
   root,
   app,
-  publicOutDir
+  publicOutDir,
+  ssr,
+  clientInit
 }: FunstackStaticOptions): (Plugin | Plugin[])[];
 //#endregion
 export { FunstackStaticOptions, funstackStatic };

package/dist/plugin/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/plugin/index.ts"],"sourcesContent":[],"mappings":";;;UAMiB,qBAAA;;AAAjB;AAkBC;;;EAKC,IAAA,EAAA,MAAA;EACC;;;;;;;;;;;;iBAJqB,cAAA;;;;GAIrB,yBAAyB,SAAS"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/plugin/index.ts"],"mappings":";;;UAMiB,qBAAA;;AAAjB;;;;EAME,IAAA;EAKA;;;;EAAA,GAAA;EAoBU;AACX;;;;EAfC,YAAA;EAoBA;;;;;;;EAZA,GAAA;EAUA;;;;;EAJA,UAAA;AAAA;AAAA,iBAGsB,cAAA,CAAA;EACtB,IAAA;EACA,GAAA;EACA,YAAA;EACA,GAAA;EACA;AAAA,GACC,qBAAA,IAAyB,MAAA,GAAS,MAAA"}

package/dist/plugin/index.mjs

@@ -4,9 +4,10 @@ import path from "node:path";
 import rsc from "@vitejs/plugin-rsc";
 
 //#region src/plugin/index.ts
-function funstackStatic({ root, app, publicOutDir = "dist/public" }) {
+function funstackStatic({ root, app, publicOutDir = "dist/public", ssr = false, clientInit }) {
 	let resolvedRootEntry = "__uninitialized__";
 	let resolvedAppEntry = "__uninitialized__";
+	let resolvedClientInitEntry;
 	return [
 		{
 			name: "@funstack/static:config-pre",
@@ -28,6 +29,7 @@ function funstackStatic({ root, app, publicOutDir = "dist/public" }) {
 			configResolved(config) {
 				resolvedRootEntry = path.resolve(config.root, root);
 				resolvedAppEntry = path.resolve(config.root, app);
+				if (clientInit) resolvedClientInitEntry = path.resolve(config.root, clientInit);
 			},
 			configEnvironment(_name, config) {
 				if (config.optimizeDeps?.include) config.optimizeDeps.include = config.optimizeDeps.include.map((entry) => {
@@ -41,10 +43,17 @@ function funstackStatic({ root, app, publicOutDir = "dist/public" }) {
 			resolveId(id) {
 				if (id === "virtual:funstack/root") return "\0virtual:funstack/root";
 				if (id === "virtual:funstack/app") return "\0virtual:funstack/app";
+				if (id === "virtual:funstack/config") return "\0virtual:funstack/config";
+				if (id === "virtual:funstack/client-init") return "\0virtual:funstack/client-init";
 			},
 			load(id) {
 				if (id === "\0virtual:funstack/root") return `export { default } from "${resolvedRootEntry}";`;
 				if (id === "\0virtual:funstack/app") return `export { default } from "${resolvedAppEntry}";`;
+				if (id === "\0virtual:funstack/config") return `export const ssr = ${JSON.stringify(ssr)};`;
+				if (id === "\0virtual:funstack/client-init") {
+					if (resolvedClientInitEntry) return `import "${resolvedClientInitEntry}";`;
+					return "";
+				}
 			}
 		},
 		{

package/dist/plugin/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/plugin/index.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport rsc from \"@vitejs/plugin-rsc\";\nimport { buildApp } from \"../build/buildApp\";\nimport { serverPlugin } from \"./server\";\n\nexport interface FunstackStaticOptions {\n  /**\n   * Root component of the page.\n   * The file should `export default` a React component that renders the whole page.\n   * (`<html>...</html>`).\n   */\n  root: string;\n  /**\n   * Entry point of your application.\n   * The file should `export default` a React component that renders the application content.\n   */\n  app: string;\n  /**\n   * Output directory for build.\n   *\n   * @default dist/public\n   */\n  publicOutDir?: string;\n}\n\nexport default function funstackStatic({\n  root,\n  app,\n  publicOutDir = \"dist/public\",\n}: FunstackStaticOptions): (Plugin | Plugin[])[] {\n  let resolvedRootEntry: string = \"__uninitialized__\";\n  let resolvedAppEntry: string = \"__uninitialized__\";\n\n  return [\n    {\n      name: \"@funstack/static:config-pre\",\n      // Placed early because the rsc plugin sets the outDir to the default value\n      config(config) {\n        return {\n          environments: {\n            client: {\n              build: {\n                outDir:\n                  config.environments?.client?.build?.outDir ?? publicOutDir,\n              },\n            },\n          },\n        };\n      },\n    },\n    serverPlugin(),\n    rsc({\n      entries: {\n        rsc: \"@funstack/static/entries/rsc\",\n        ssr: \"@funstack/static/entries/ssr\",\n        client: \"@funstack/static/entries/client\",\n      },\n      serverHandler: false,\n    }),\n    {\n      name: \"@funstack/static:config\",\n      configResolved(config) {\n        resolvedRootEntry = path.resolve(config.root, root);\n        resolvedAppEntry = path.resolve(config.root, app);\n      },\n      // Needed for properly bundling @vitejs/plugin-rsc for browser.\n      // See: https://github.com/vitejs/vite-plugin-react/tree/79bf57cc8b9c77e33970ec2e876bd6d2f1568d5d/packages/plugin-rsc#using-vitejsplugin-rsc-as-a-framework-packages-dependencies\n      configEnvironment(_name, config) {\n        if (config.optimizeDeps?.include) {\n          config.optimizeDeps.include = config.optimizeDeps.include.map(\n            (entry) => {\n              if (entry.startsWith(\"@vitejs/plugin-rsc\")) {\n                entry = `@funstack/static > ${entry}`;\n              }\n              return entry;\n            },\n          );\n        }\n      },\n    },\n    {\n      name: \"@funstack/static:virtual-entry\",\n      resolveId(id) {\n        if (id === \"virtual:funstack/root\") {\n          return \"\\0virtual:funstack/root\";\n        }\n        if (id === \"virtual:funstack/app\") {\n          return \"\\0virtual:funstack/app\";\n        }\n      },\n      load(id) {\n        if (id === \"\\0virtual:funstack/root\") {\n          return `export { default } from \"${resolvedRootEntry}\";`;\n        }\n        if (id === \"\\0virtual:funstack/app\") {\n          return `export { default } from \"${resolvedAppEntry}\";`;\n        }\n      },\n    },\n    {\n      name: \"@funstack/static:build\",\n      async buildApp(builder) {\n        await buildApp(builder, this);\n      },\n    },\n  ];\n}\n"],"mappings":";;;;;;AA0BA,SAAwB,eAAe,EACrC,MACA,KACA,eAAe,iBACgC;CAC/C,IAAI,oBAA4B;CAChC,IAAI,mBAA2B;AAE/B,QAAO;EACL;GACE,MAAM;GAEN,OAAO,QAAQ;AACb,WAAO,EACL,cAAc,EACZ,QAAQ,EACN,OAAO,EACL,QACE,OAAO,cAAc,QAAQ,OAAO,UAAU,cACjD,EACF,EACF,EACF;;GAEJ;EACD,cAAc;EACd,IAAI;GACF,SAAS;IACP,KAAK;IACL,KAAK;IACL,QAAQ;IACT;GACD,eAAe;GAChB,CAAC;EACF;GACE,MAAM;GACN,eAAe,QAAQ;AACrB,wBAAoB,KAAK,QAAQ,OAAO,MAAM,KAAK;AACnD,uBAAmB,KAAK,QAAQ,OAAO,MAAM,IAAI;;GAInD,kBAAkB,OAAO,QAAQ;AAC/B,QAAI,OAAO,cAAc,QACvB,QAAO,aAAa,UAAU,OAAO,aAAa,QAAQ,KACvD,UAAU;AACT,SAAI,MAAM,WAAW,qBAAqB,CACxC,SAAQ,sBAAsB;AAEhC,YAAO;MAEV;;GAGN;EACD;GACE,MAAM;GACN,UAAU,IAAI;AACZ,QAAI,OAAO,wBACT,QAAO;AAET,QAAI,OAAO,uBACT,QAAO;;GAGX,KAAK,IAAI;AACP,QAAI,OAAO,0BACT,QAAO,4BAA4B,kBAAkB;AAEvD,QAAI,OAAO,yBACT,QAAO,4BAA4B,iBAAiB;;GAGzD;EACD;GACE,MAAM;GACN,MAAM,SAAS,SAAS;AACtB,UAAM,SAAS,SAAS,KAAK;;GAEhC;EACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/plugin/index.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport rsc from \"@vitejs/plugin-rsc\";\nimport { buildApp } from \"../build/buildApp\";\nimport { serverPlugin } from \"./server\";\n\nexport interface FunstackStaticOptions {\n  /**\n   * Root component of the page.\n   * The file should `export default` a React component that renders the whole page.\n   * (`<html>...</html>`).\n   */\n  root: string;\n  /**\n   * Entry point of your application.\n   * The file should `export default` a React component that renders the application content.\n   */\n  app: string;\n  /**\n   * Output directory for build.\n   *\n   * @default dist/public\n   */\n  publicOutDir?: string;\n  /**\n   * Enable server-side rendering of the App component.\n   * When false, only the Root shell is SSR'd and the App renders client-side.\n   * When true, both Root and App are SSR'd and the client hydrates.\n   *\n   * @default false\n   */\n  ssr?: boolean;\n  /**\n   * Path to a module that runs on the client side before React hydration.\n   * Use this for client-side instrumentation like Sentry, analytics, or feature flags.\n   * The module is imported for its side effects only (no exports needed).\n   */\n  clientInit?: string;\n}\n\nexport default function funstackStatic({\n  root,\n  app,\n  publicOutDir = \"dist/public\",\n  ssr = false,\n  clientInit,\n}: FunstackStaticOptions): (Plugin | Plugin[])[] {\n  let resolvedRootEntry: string = \"__uninitialized__\";\n  let resolvedAppEntry: string = \"__uninitialized__\";\n  let resolvedClientInitEntry: string | undefined;\n\n  return [\n    {\n      name: \"@funstack/static:config-pre\",\n      // Placed early because the rsc plugin sets the outDir to the default value\n      config(config) {\n        return {\n          environments: {\n            client: {\n              build: {\n                outDir:\n                  config.environments?.client?.build?.outDir ?? publicOutDir,\n              },\n            },\n          },\n        };\n      },\n    },\n    serverPlugin(),\n    rsc({\n      entries: {\n        rsc: \"@funstack/static/entries/rsc\",\n        ssr: \"@funstack/static/entries/ssr\",\n        client: \"@funstack/static/entries/client\",\n      },\n      serverHandler: false,\n    }),\n    {\n      name: \"@funstack/static:config\",\n      configResolved(config) {\n        resolvedRootEntry = path.resolve(config.root, root);\n        resolvedAppEntry = path.resolve(config.root, app);\n        if (clientInit) {\n          resolvedClientInitEntry = path.resolve(config.root, clientInit);\n        }\n      },\n      // Needed for properly bundling @vitejs/plugin-rsc for browser.\n      // See: https://github.com/vitejs/vite-plugin-react/tree/79bf57cc8b9c77e33970ec2e876bd6d2f1568d5d/packages/plugin-rsc#using-vitejsplugin-rsc-as-a-framework-packages-dependencies\n      configEnvironment(_name, config) {\n        if (config.optimizeDeps?.include) {\n          config.optimizeDeps.include = config.optimizeDeps.include.map(\n            (entry) => {\n              if (entry.startsWith(\"@vitejs/plugin-rsc\")) {\n                entry = `@funstack/static > ${entry}`;\n              }\n              return entry;\n            },\n          );\n        }\n      },\n    },\n    {\n      name: \"@funstack/static:virtual-entry\",\n      resolveId(id) {\n        if (id === \"virtual:funstack/root\") {\n          return \"\\0virtual:funstack/root\";\n        }\n        if (id === \"virtual:funstack/app\") {\n          return \"\\0virtual:funstack/app\";\n        }\n        if (id === \"virtual:funstack/config\") {\n          return \"\\0virtual:funstack/config\";\n        }\n        if (id === \"virtual:funstack/client-init\") {\n          return \"\\0virtual:funstack/client-init\";\n        }\n      },\n      load(id) {\n        if (id === \"\\0virtual:funstack/root\") {\n          return `export { default } from \"${resolvedRootEntry}\";`;\n        }\n        if (id === \"\\0virtual:funstack/app\") {\n          return `export { default } from \"${resolvedAppEntry}\";`;\n        }\n        if (id === \"\\0virtual:funstack/config\") {\n          return `export const ssr = ${JSON.stringify(ssr)};`;\n        }\n        if (id === \"\\0virtual:funstack/client-init\") {\n          if (resolvedClientInitEntry) {\n            return `import \"${resolvedClientInitEntry}\";`;\n          }\n          return \"\";\n        }\n      },\n    },\n    {\n      name: \"@funstack/static:build\",\n      async buildApp(builder) {\n        await buildApp(builder, this);\n      },\n    },\n  ];\n}\n"],"mappings":";;;;;;AAwCA,SAAwB,eAAe,EACrC,MACA,KACA,eAAe,eACf,MAAM,OACN,cAC+C;CAC/C,IAAI,oBAA4B;CAChC,IAAI,mBAA2B;CAC/B,IAAI;AAEJ,QAAO;EACL;GACE,MAAM;GAEN,OAAO,QAAQ;AACb,WAAO,EACL,cAAc,EACZ,QAAQ,EACN,OAAO,EACL,QACE,OAAO,cAAc,QAAQ,OAAO,UAAU,cACjD,EACF,EACF,EACF;;GAEJ;EACD,cAAc;EACd,IAAI;GACF,SAAS;IACP,KAAK;IACL,KAAK;IACL,QAAQ;IACT;GACD,eAAe;GAChB,CAAC;EACF;GACE,MAAM;GACN,eAAe,QAAQ;AACrB,wBAAoB,KAAK,QAAQ,OAAO,MAAM,KAAK;AACnD,uBAAmB,KAAK,QAAQ,OAAO,MAAM,IAAI;AACjD,QAAI,WACF,2BAA0B,KAAK,QAAQ,OAAO,MAAM,WAAW;;GAKnE,kBAAkB,OAAO,QAAQ;AAC/B,QAAI,OAAO,cAAc,QACvB,QAAO,aAAa,UAAU,OAAO,aAAa,QAAQ,KACvD,UAAU;AACT,SAAI,MAAM,WAAW,qBAAqB,CACxC,SAAQ,sBAAsB;AAEhC,YAAO;MAEV;;GAGN;EACD;GACE,MAAM;GACN,UAAU,IAAI;AACZ,QAAI,OAAO,wBACT,QAAO;AAET,QAAI,OAAO,uBACT,QAAO;AAET,QAAI,OAAO,0BACT,QAAO;AAET,QAAI,OAAO,+BACT,QAAO;;GAGX,KAAK,IAAI;AACP,QAAI,OAAO,0BACT,QAAO,4BAA4B,kBAAkB;AAEvD,QAAI,OAAO,yBACT,QAAO,4BAA4B,iBAAiB;AAEtD,QAAI,OAAO,4BACT,QAAO,sBAAsB,KAAK,UAAU,IAAI,CAAC;AAEnD,QAAI,OAAO,kCAAkC;AAC3C,SAAI,wBACF,QAAO,WAAW,wBAAwB;AAE5C,YAAO;;;GAGZ;EACD;GACE,MAAM;GACN,MAAM,SAAS,SAAS;AACtB,UAAM,SAAS,SAAS,KAAK;;GAEhC;EACF"}

package/dist/rsc/defer.d.mts

@@ -3,6 +3,18 @@ import { ReactElement, ReactNode } from "react";
 //#region src/rsc/defer.d.ts
 interface DeferEntry {
   state: DeferEntryState;
+  name?: string;
+}
+/**
+ * Options for the defer function.
+ */
+interface DeferOptions {
+  /**
+   * Optional name for debugging purposes.
+   * In development: included in the RSC payload file name.
+   * In production: logged when the payload file is emitted.
+   */
+  name?: string;
 }
 interface LoadedDeferEntry extends DeferEntry {
   state: Exclude<DeferEntryState, {
@@ -24,7 +36,7 @@ type DeferEntryState = {
 };
 declare class DeferRegistry {
   #private;
-  register(element: ReactElement, id: string): void;
+  register(element: ReactElement, id: string, name?: string): void;
   load(id: string): LoadedDeferEntry | undefined;
   has(id: string): boolean;
   /**
@@ -34,6 +46,7 @@ declare class DeferRegistry {
   loadAll(): AsyncGenerator<{
     id: string;
     data: string;
+    name?: string;
   }, void, unknown>;
 }
 /**
@@ -42,9 +55,11 @@ declare class DeferRegistry {
  * During the client side rendering, fetching of the payload will be
  * deferred until the returned ReactNode is actually rendered.
  *
+ * @param element - The React element to defer.
+ * @param options - Optional configuration for the deferred payload.
  * @returns A ReactNode that virtually contains the result of rendering the given component.
  */
-declare function defer(element: ReactElement): ReactNode;
+declare function defer(element: ReactElement, options?: DeferOptions): ReactNode;
 //#endregion
-export { DeferRegistry, defer };
+export { DeferOptions, DeferRegistry, defer };
 //# sourceMappingURL=defer.d.mts.map

package/dist/rsc/defer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"defer.d.mts","names":[],"sources":["../../src/rsc/defer.tsx"],"sourcesContent":[],"mappings":";;;UAMiB,UAAA;SACR;AADT;AAIiB,UAAA,gBAAA,SAAyB,UAAR,CAAA;EACjB,KAAA,EAAR,OAAQ,CAAA,eAAA,EAAA;IAAR,KAAA,EAAA,SAAA;EADiC,CAAA,CAAA;;AAEzC,KAEI,eAAA,GAAe;EAGL,KAAA,EAAA,SAAA;EAIc,OAAA,EAJd,YAIc;CAAf,GAAA;EAAc,KAAA,EAAA,WAAA;EAWf,MAAA,EAXC,cAWY,CAXG,UAWH,CAAA;CAGN,GAAA;EAIA,KAAA,EAAA,OAAA;EAgDJ,IAAA,EAAA,MAAA;CAAA,GAAA;EAiFA,KAAA,EAAA,OAAK;;;cAxIR,aAAA;;oBAGO;oBAIA;;;;;;aAgDJ;;;;;;;;;;;;;iBAiFA,KAAA,UAAe,eAAe"}
+{"version":3,"file":"defer.d.mts","names":[],"sources":["../../src/rsc/defer.tsx"],"mappings":";;;UAMiB,UAAA;EACf,KAAA,EAAO,eAAA;EACP,IAAA;AAAA;;;;UAMe,YAAA;EANf;;;AAMF;;EAME,IAAA;AAAA;AAAA,UAGe,gBAAA,SAAyB,UAAA;EACxC,KAAA,EAAO,OAAA,CAAQ,eAAA;IAAmB,KAAA;EAAA;AAAA;AAAA,KAG/B,eAAA;EAEC,KAAA;EACA,OAAA,EAAS,YAAA;AAAA;EAGT,KAAA;EACA,MAAA,EAAQ,cAAA,CAAe,UAAA;AAAA;EAGvB,KAAA;EACA,IAAA;AAAA;EAGA,KAAA;EACA,KAAA;AAAA;AAAA,cAeO,aAAA;EAAA;EAGX,QAAA,CAAS,OAAA,EAAS,YAAA,EAAc,EAAA,UAAY,IAAA;EAI5C,IAAA,CAAK,EAAA,WAAa,gBAAA;EAwClB,GAAA,CAAI,EAAA;EAtEsB;;;;EA8EnB,OAAA,CAAA,GAAO,cAAA;;;;;;;;;AAvDhB;;;;;;;iBA2IgB,KAAA,CACd,OAAA,EAAS,YAAA,EACT,OAAA,GAAU,YAAA,GACT,SAAA"}

package/dist/rsc/defer.mjs

@@ -2,16 +2,26 @@ import { getPayloadIDFor } from "./rscModule.mjs";
 import { drainStream } from "../util/drainStream.mjs";
 import { jsx } from "react/jsx-runtime";
 import { renderToReadableStream } from "@vitejs/plugin-rsc/react/rsc";
-import { ClientWrapper } from "#rsc-client";
+import { DeferredComponent } from "#rsc-client";
 
 //#region src/rsc/defer.tsx
+/**
+* Sanitizes a name for use in file paths.
+* Replaces non-alphanumeric characters with underscores and limits length.
+*/
+function sanitizeName(name) {
+	return name.replace(/[^a-zA-Z0-9_-]/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "").slice(0, 50);
+}
 var DeferRegistry = class {
 	#registry = /* @__PURE__ */ new Map();
-	register(element, id) {
-		this.#registry.set(id, { state: {
-			element,
-			state: "pending"
-		} });
+	register(element, id, name) {
+		this.#registry.set(id, {
+			state: {
+				element,
+				state: "pending"
+			},
+			name
+		});
 	}
 	load(id) {
 		const entry = this.#registry.get(id);
@@ -58,7 +68,11 @@ var DeferRegistry = class {
 	*/
 	async *loadAll() {
 		const errors = [];
-		const loadedEntries = Array.from(this.#registry, ([id, entry]) => [id, this.#loadEntry(entry)]);
+		const loadedEntries = Array.from(this.#registry, ([id, entry]) => [
+			id,
+			this.#loadEntry(entry),
+			entry.name
+		]);
 		if (loadedEntries.length === 0) return;
 		const completed = [];
 		let waiting;
@@ -68,19 +82,21 @@ var DeferRegistry = class {
 			remainingCount--;
 			waiting?.();
 		};
-		for (const [id, loadedEntry] of loadedEntries) (async () => {
+		for (const [id, loadedEntry, name] of loadedEntries) (async () => {
 			try {
 				switch (loadedEntry.state.state) {
 					case "streaming":
 						onComplete({
 							id,
-							data: await drainStream(loadedEntry.state.stream)
+							data: await drainStream(loadedEntry.state.stream),
+							name
 						});
 						break;
 					case "ready":
 						onComplete({
 							id,
-							data: loadedEntry.state.data
+							data: loadedEntry.state.data,
+							name
 						});
 						break;
 					case "error":
@@ -111,12 +127,16 @@ const deferRegistry = new DeferRegistry();
 * During the client side rendering, fetching of the payload will be
 * deferred until the returned ReactNode is actually rendered.
 *
+* @param element - The React element to defer.
+* @param options - Optional configuration for the deferred payload.
 * @returns A ReactNode that virtually contains the result of rendering the given component.
 */
-function defer(element) {
-	const id = getPayloadIDFor(crypto.randomUUID());
-	deferRegistry.register(element, id);
-	return /* @__PURE__ */ jsx(ClientWrapper, { moduleID: id });
+function defer(element, options) {
+	const name = options?.name;
+	const sanitizedName = name ? sanitizeName(name) : void 0;
+	const id = getPayloadIDFor(sanitizedName ? `${sanitizedName}-${crypto.randomUUID()}` : crypto.randomUUID());
+	deferRegistry.register(element, id, name);
+	return /* @__PURE__ */ jsx(DeferredComponent, { moduleID: id });
 }
 
 //#endregion

package/dist/rsc/defer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"defer.mjs","names":["#registry","#loadEntry"],"sources":["../../src/rsc/defer.tsx"],"sourcesContent":["import type { ReactElement, ReactNode } from \"react\";\nimport { renderToReadableStream } from \"@vitejs/plugin-rsc/react/rsc\";\nimport { ClientWrapper } from \"#rsc-client\";\nimport { drainStream } from \"../util/drainStream\";\nimport { getPayloadIDFor } from \"./rscModule\";\n\nexport interface DeferEntry {\n  state: DeferEntryState;\n}\n\nexport interface LoadedDeferEntry extends DeferEntry {\n  state: Exclude<DeferEntryState, { state: \"pending\" }>;\n}\n\ntype DeferEntryState =\n  | {\n      state: \"pending\";\n      element: ReactElement;\n    }\n  | {\n      state: \"streaming\";\n      stream: ReadableStream<Uint8Array>;\n    }\n  | {\n      state: \"ready\";\n      data: string;\n    }\n  | {\n      state: \"error\";\n      error: unknown;\n    };\n\nexport class DeferRegistry {\n  #registry = new Map<string, DeferEntry>();\n\n  register(element: ReactElement, id: string) {\n    this.#registry.set(id, { state: { element, state: \"pending\" } });\n  }\n\n  load(id: string): LoadedDeferEntry | undefined {\n    const entry = this.#registry.get(id);\n    if (!entry) {\n      return undefined;\n    }\n    return this.#loadEntry(entry);\n  }\n\n  #loadEntry(entry: DeferEntry): LoadedDeferEntry {\n    const { state } = entry;\n    switch (state.state) {\n      case \"pending\": {\n        const stream = renderToReadableStream<ReactNode>(state.element);\n        const [stream1, stream2] = stream.tee();\n        entry.state = { state: \"streaming\", stream: stream1 };\n        (async () => {\n          const chunks: string[] = [];\n          const decoder = new TextDecoder();\n          for await (const chunk of stream2) {\n            chunks.push(decoder.decode(chunk, { stream: true }));\n          }\n          chunks.push(decoder.decode());\n          entry.state = {\n            state: \"ready\",\n            data: chunks.join(\"\"),\n          };\n        })().catch((error) => {\n          entry.state = { state: \"error\", error };\n        });\n        return entry as LoadedDeferEntry;\n      }\n      case \"streaming\":\n      case \"ready\":\n      case \"error\": {\n        return entry as LoadedDeferEntry;\n      }\n    }\n    state satisfies never;\n  }\n\n  has(id: string): boolean {\n    return this.#registry.has(id);\n  }\n\n  /**\n   * Iterates over all entries in parallel.\n   * Yields results as each stream completes.\n   */\n  async *loadAll() {\n    const errors: unknown[] = [];\n\n    // Phase 1: Start all entries loading\n    const loadedEntries = Array.from(\n      this.#registry,\n      ([id, entry]) => [id, this.#loadEntry(entry)] as const,\n    );\n\n    if (loadedEntries.length === 0) return;\n\n    type Result = { id: string; data: string };\n\n    // Completion queue\n    const completed: Array<Result | { error: unknown }> = [];\n    let waiting: (() => void) | undefined;\n    let remainingCount = loadedEntries.length;\n\n    const onComplete = (result: Result | { error: unknown }) => {\n      completed.push(result);\n      remainingCount--;\n      waiting?.();\n    };\n\n    // Phase 2: Start all operations (each pushes to queue when done)\n    for (const [id, loadedEntry] of loadedEntries) {\n      (async () => {\n        try {\n          switch (loadedEntry.state.state) {\n            case \"streaming\":\n              onComplete({\n                id,\n                data: await drainStream(loadedEntry.state.stream),\n              });\n              break;\n            case \"ready\":\n              onComplete({ id, data: loadedEntry.state.data });\n              break;\n            case \"error\":\n              onComplete({ error: loadedEntry.state.error });\n              break;\n          }\n        } catch (error) {\n          onComplete({ error });\n        }\n      })();\n    }\n\n    // Phase 3: Yield from queue as results arrive\n    while (remainingCount > 0 || completed.length > 0) {\n      if (completed.length === 0) {\n        await new Promise<void>((r) => {\n          waiting = r;\n        });\n        waiting = undefined;\n      }\n      for (const result of completed.splice(0)) {\n        if (\"error\" in result) {\n          errors.push(result.error);\n        } else {\n          yield result;\n        }\n      }\n    }\n\n    if (errors.length > 0) {\n      throw new AggregateError(errors);\n    }\n  }\n}\n\nexport const deferRegistry = new DeferRegistry();\n\n/**\n * Renders given Server Component into a separate RSC payload.\n *\n * During the client side rendering, fetching of the payload will be\n * deferred until the returned ReactNode is actually rendered.\n *\n * @returns A ReactNode that virtually contains the result of rendering the given component.\n */\nexport function defer(element: ReactElement): ReactNode {\n  const id = getPayloadIDFor(crypto.randomUUID());\n  deferRegistry.register(element, id);\n\n  return <ClientWrapper moduleID={id} />;\n}\n"],"mappings":";;;;;;;AAgCA,IAAa,gBAAb,MAA2B;CACzB,4BAAY,IAAI,KAAyB;CAEzC,SAAS,SAAuB,IAAY;AAC1C,QAAKA,SAAU,IAAI,IAAI,EAAE,OAAO;GAAE;GAAS,OAAO;GAAW,EAAE,CAAC;;CAGlE,KAAK,IAA0C;EAC7C,MAAM,QAAQ,MAAKA,SAAU,IAAI,GAAG;AACpC,MAAI,CAAC,MACH;AAEF,SAAO,MAAKC,UAAW,MAAM;;CAG/B,WAAW,OAAqC;EAC9C,MAAM,EAAE,UAAU;AAClB,UAAQ,MAAM,OAAd;GACE,KAAK,WAAW;IAEd,MAAM,CAAC,SAAS,WADD,uBAAkC,MAAM,QAAQ,CAC7B,KAAK;AACvC,UAAM,QAAQ;KAAE,OAAO;KAAa,QAAQ;KAAS;AACrD,KAAC,YAAY;KACX,MAAM,SAAmB,EAAE;KAC3B,MAAM,UAAU,IAAI,aAAa;AACjC,gBAAW,MAAM,SAAS,QACxB,QAAO,KAAK,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC,CAAC;AAEtD,YAAO,KAAK,QAAQ,QAAQ,CAAC;AAC7B,WAAM,QAAQ;MACZ,OAAO;MACP,MAAM,OAAO,KAAK,GAAG;MACtB;QACC,CAAC,OAAO,UAAU;AACpB,WAAM,QAAQ;MAAE,OAAO;MAAS;MAAO;MACvC;AACF,WAAO;;GAET,KAAK;GACL,KAAK;GACL,KAAK,QACH,QAAO;;;CAMb,IAAI,IAAqB;AACvB,SAAO,MAAKD,SAAU,IAAI,GAAG;;;;;;CAO/B,OAAO,UAAU;EACf,MAAM,SAAoB,EAAE;EAG5B,MAAM,gBAAgB,MAAM,KAC1B,MAAKA,WACJ,CAAC,IAAI,WAAW,CAAC,IAAI,MAAKC,UAAW,MAAM,CAAC,CAC9C;AAED,MAAI,cAAc,WAAW,EAAG;EAKhC,MAAM,YAAgD,EAAE;EACxD,IAAI;EACJ,IAAI,iBAAiB,cAAc;EAEnC,MAAM,cAAc,WAAwC;AAC1D,aAAU,KAAK,OAAO;AACtB;AACA,cAAW;;AAIb,OAAK,MAAM,CAAC,IAAI,gBAAgB,cAC9B,EAAC,YAAY;AACX,OAAI;AACF,YAAQ,YAAY,MAAM,OAA1B;KACE,KAAK;AACH,iBAAW;OACT;OACA,MAAM,MAAM,YAAY,YAAY,MAAM,OAAO;OAClD,CAAC;AACF;KACF,KAAK;AACH,iBAAW;OAAE;OAAI,MAAM,YAAY,MAAM;OAAM,CAAC;AAChD;KACF,KAAK;AACH,iBAAW,EAAE,OAAO,YAAY,MAAM,OAAO,CAAC;AAC9C;;YAEG,OAAO;AACd,eAAW,EAAE,OAAO,CAAC;;MAErB;AAIN,SAAO,iBAAiB,KAAK,UAAU,SAAS,GAAG;AACjD,OAAI,UAAU,WAAW,GAAG;AAC1B,UAAM,IAAI,SAAe,MAAM;AAC7B,eAAU;MACV;AACF,cAAU;;AAEZ,QAAK,MAAM,UAAU,UAAU,OAAO,EAAE,CACtC,KAAI,WAAW,OACb,QAAO,KAAK,OAAO,MAAM;OAEzB,OAAM;;AAKZ,MAAI,OAAO,SAAS,EAClB,OAAM,IAAI,eAAe,OAAO;;;AAKtC,MAAa,gBAAgB,IAAI,eAAe;;;;;;;;;AAUhD,SAAgB,MAAM,SAAkC;CACtD,MAAM,KAAK,gBAAgB,OAAO,YAAY,CAAC;AAC/C,eAAc,SAAS,SAAS,GAAG;AAEnC,QAAO,oBAAC,iBAAc,UAAU,KAAM"}
+{"version":3,"file":"defer.mjs","names":["#registry","#loadEntry"],"sources":["../../src/rsc/defer.tsx"],"sourcesContent":["import type { ReactElement, ReactNode } from \"react\";\nimport { renderToReadableStream } from \"@vitejs/plugin-rsc/react/rsc\";\nimport { DeferredComponent } from \"#rsc-client\";\nimport { drainStream } from \"../util/drainStream\";\nimport { getPayloadIDFor } from \"./rscModule\";\n\nexport interface DeferEntry {\n  state: DeferEntryState;\n  name?: string;\n}\n\n/**\n * Options for the defer function.\n */\nexport interface DeferOptions {\n  /**\n   * Optional name for debugging purposes.\n   * In development: included in the RSC payload file name.\n   * In production: logged when the payload file is emitted.\n   */\n  name?: string;\n}\n\nexport interface LoadedDeferEntry extends DeferEntry {\n  state: Exclude<DeferEntryState, { state: \"pending\" }>;\n}\n\ntype DeferEntryState =\n  | {\n      state: \"pending\";\n      element: ReactElement;\n    }\n  | {\n      state: \"streaming\";\n      stream: ReadableStream<Uint8Array>;\n    }\n  | {\n      state: \"ready\";\n      data: string;\n    }\n  | {\n      state: \"error\";\n      error: unknown;\n    };\n\n/**\n * Sanitizes a name for use in file paths.\n * Replaces non-alphanumeric characters with underscores and limits length.\n */\nfunction sanitizeName(name: string): string {\n  return name\n    .replace(/[^a-zA-Z0-9_-]/g, \"_\")\n    .replace(/_+/g, \"_\")\n    .replace(/^_|_$/g, \"\")\n    .slice(0, 50);\n}\n\nexport class DeferRegistry {\n  #registry = new Map<string, DeferEntry>();\n\n  register(element: ReactElement, id: string, name?: string) {\n    this.#registry.set(id, { state: { element, state: \"pending\" }, name });\n  }\n\n  load(id: string): LoadedDeferEntry | undefined {\n    const entry = this.#registry.get(id);\n    if (!entry) {\n      return undefined;\n    }\n    return this.#loadEntry(entry);\n  }\n\n  #loadEntry(entry: DeferEntry): LoadedDeferEntry {\n    const { state } = entry;\n    switch (state.state) {\n      case \"pending\": {\n        const stream = renderToReadableStream<ReactNode>(state.element);\n        const [stream1, stream2] = stream.tee();\n        entry.state = { state: \"streaming\", stream: stream1 };\n        (async () => {\n          const chunks: string[] = [];\n          const decoder = new TextDecoder();\n          for await (const chunk of stream2) {\n            chunks.push(decoder.decode(chunk, { stream: true }));\n          }\n          chunks.push(decoder.decode());\n          entry.state = {\n            state: \"ready\",\n            data: chunks.join(\"\"),\n          };\n        })().catch((error) => {\n          entry.state = { state: \"error\", error };\n        });\n        return entry as LoadedDeferEntry;\n      }\n      case \"streaming\":\n      case \"ready\":\n      case \"error\": {\n        return entry as LoadedDeferEntry;\n      }\n    }\n    state satisfies never;\n  }\n\n  has(id: string): boolean {\n    return this.#registry.has(id);\n  }\n\n  /**\n   * Iterates over all entries in parallel.\n   * Yields results as each stream completes.\n   */\n  async *loadAll() {\n    const errors: unknown[] = [];\n\n    // Phase 1: Start all entries loading\n    const loadedEntries = Array.from(\n      this.#registry,\n      ([id, entry]) => [id, this.#loadEntry(entry), entry.name] as const,\n    );\n\n    if (loadedEntries.length === 0) return;\n\n    type Result = { id: string; data: string; name?: string };\n\n    // Completion queue\n    const completed: Array<Result | { error: unknown }> = [];\n    let waiting: (() => void) | undefined;\n    let remainingCount = loadedEntries.length;\n\n    const onComplete = (result: Result | { error: unknown }) => {\n      completed.push(result);\n      remainingCount--;\n      waiting?.();\n    };\n\n    // Phase 2: Start all operations (each pushes to queue when done)\n    for (const [id, loadedEntry, name] of loadedEntries) {\n      (async () => {\n        try {\n          switch (loadedEntry.state.state) {\n            case \"streaming\":\n              onComplete({\n                id,\n                data: await drainStream(loadedEntry.state.stream),\n                name,\n              });\n              break;\n            case \"ready\":\n              onComplete({ id, data: loadedEntry.state.data, name });\n              break;\n            case \"error\":\n              onComplete({ error: loadedEntry.state.error });\n              break;\n          }\n        } catch (error) {\n          onComplete({ error });\n        }\n      })();\n    }\n\n    // Phase 3: Yield from queue as results arrive\n    while (remainingCount > 0 || completed.length > 0) {\n      if (completed.length === 0) {\n        await new Promise<void>((r) => {\n          waiting = r;\n        });\n        waiting = undefined;\n      }\n      for (const result of completed.splice(0)) {\n        if (\"error\" in result) {\n          errors.push(result.error);\n        } else {\n          yield result;\n        }\n      }\n    }\n\n    if (errors.length > 0) {\n      throw new AggregateError(errors);\n    }\n  }\n}\n\nexport const deferRegistry = new DeferRegistry();\n\n/**\n * Renders given Server Component into a separate RSC payload.\n *\n * During the client side rendering, fetching of the payload will be\n * deferred until the returned ReactNode is actually rendered.\n *\n * @param element - The React element to defer.\n * @param options - Optional configuration for the deferred payload.\n * @returns A ReactNode that virtually contains the result of rendering the given component.\n */\nexport function defer(\n  element: ReactElement,\n  options?: DeferOptions,\n): ReactNode {\n  const name = options?.name;\n  const sanitizedName = name ? sanitizeName(name) : undefined;\n  const rawId = sanitizedName\n    ? `${sanitizedName}-${crypto.randomUUID()}`\n    : crypto.randomUUID();\n  const id = getPayloadIDFor(rawId);\n  deferRegistry.register(element, id, name);\n\n  return <DeferredComponent moduleID={id} />;\n}\n"],"mappings":"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"}

package/dist/rsc/entry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.mts","names":[],"sources":["../../src/rsc/entry.tsx"],"sourcesContent":[],"mappings":";;;KAQY,UAAA;QACJ,KAAA,CAAM;AADd,CAAA;AAkCA;AAoBC;AAWD;AAOsB,iBAtCA,SAAA,CAAA,CAsCQ,EAtCK,OAsCL,CAtCa,QAsCb,CAAA;cAhBxB,aAAA,SAAsB,KAAA,CAgBY;EAAkB,MAAA,EAAA,GAAA,GAAA,GAAA;EAAR,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,MAAA,EAAA,GAAA,GAAA,GAAA;;AAqD5B,iBA5DN,eAAA,CA4DW,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IA5D+B,aA4D/B;;;;iBArDL,QAAA,UAAkB,UAAU,QAAQ;;;;AAqD/B,iBAAL,KAAA,CAAA,CAAK,EAAA,OAAA,CAAA;EAAA,IAAA,gBAAA,WAAA,gBAAA,CAAA,CAAA"}
+{"version":3,"file":"entry.d.mts","names":[],"sources":["../../src/rsc/entry.tsx"],"mappings":";;;KAQY,UAAA;EACV,IAAA,EAAM,KAAA,CAAM,SAAA;AAAA;;;;iBA2BQ,SAAA,CAAA,GAAa,OAAA,CAAQ,QAAA;AAAA,cA+ErC,aAAA,SAAsB,KAAA;EAC1B,MAAA;cACY,OAAA,UAAiB,MAAA;AAAA;AAAA,iBAOf,eAAA,CAAgB,KAAA,YAAiB,KAAA,IAAS,aAAA;;;;iBAOpC,QAAA,CAAS,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,QAAA;AAlBzD;;;AAAA,iBA2FqB,KAAA,CAAA,GAAK,OAAA"}

package/dist/rsc/entry.mjs

@@ -4,30 +4,71 @@ import { stripBasePath } from "../util/basePath.mjs";
 import { defer, deferRegistry } from "./defer.mjs";
 import { generateAppMarker } from "./marker.mjs";
 import { jsx } from "react/jsx-runtime";
+import { ssr } from "virtual:funstack/config";
 import { renderToReadableStream } from "@vitejs/plugin-rsc/rsc";
 
 //#region src/rsc/entry.tsx
-async function devMainRSCStream() {
+async function loadEntries() {
 	const Root = (await import("virtual:funstack/root")).default;
 	const App = (await import("virtual:funstack/app")).default;
 	if (Root === void 0) throw new Error("Failed to load RSC root entry module. Check your entry file to ensure it has a default export.");
 	if (App === void 0) throw new Error("Failed to load RSC app entry module. Check your entry file to ensure it has a default export.");
-	return renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx(App, {}) }) });
+	return {
+		Root,
+		App
+	};
 }
 /**
 * Entrypoint to serve HTML response in dev environment
 */
 async function serveHTML() {
+	const timings = [];
 	const marker = generateAppMarker();
-	const rootRscStream = await devMainRSCStream();
-	const ssrResult = await (await import.meta.viteRsc.loadModule("ssr")).renderHTML(rootRscStream, {
-		appEntryMarker: marker,
-		build: false
-	});
-	return new Response(ssrResult.stream, {
-		status: ssrResult.status,
-		headers: { "Content-type": "text/html" }
-	});
+	const entriesStart = performance.now();
+	const { Root, App } = await loadEntries();
+	timings.push(`entries;dur=${performance.now() - entriesStart}`);
+	const ssrModuleStart = performance.now();
+	const ssrEntryModule = await import.meta.viteRsc.loadModule("ssr");
+	timings.push(`ssr-module;dur=${performance.now() - ssrModuleStart}`);
+	if (ssr) {
+		const rscStart = performance.now();
+		const rootRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx(App, {}) }) });
+		timings.push(`rsc;dur=${performance.now() - rscStart}`);
+		const ssrStart = performance.now();
+		const ssrResult = await ssrEntryModule.renderHTML(rootRscStream, {
+			appEntryMarker: marker,
+			build: false,
+			ssr: true
+		});
+		timings.push(`ssr;dur=${performance.now() - ssrStart}`);
+		return new Response(ssrResult.stream, {
+			status: ssrResult.status,
+			headers: {
+				"Content-type": "text/html",
+				"Server-Timing": timings.join(", ")
+			}
+		});
+	} else {
+		const rscStart = performance.now();
+		const shellRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx("span", { id: marker }) }) });
+		const clientRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx(App, {}) }) });
+		timings.push(`rsc;dur=${performance.now() - rscStart}`);
+		const ssrStart = performance.now();
+		const ssrResult = await ssrEntryModule.renderHTML(shellRscStream, {
+			appEntryMarker: marker,
+			build: false,
+			ssr: false,
+			clientRscStream
+		});
+		timings.push(`ssr;dur=${performance.now() - ssrStart}`);
+		return new Response(ssrResult.stream, {
+			status: ssrResult.status,
+			headers: {
+				"Content-type": "text/html",
+				"Server-Timing": timings.join(", ")
+			}
+		});
+	}
 }
 var ServeRSCError = class extends Error {
 	status;
@@ -44,27 +85,44 @@ function isServeRSCError(error) {
 * Servers an RSC stream response
 */
 async function serveRSC(request) {
+	const timings = [];
 	const pathname = stripBasePath(new URL(request.url).pathname);
 	if (pathname === devMainRscPath) {
-		const rootRscStream = await devMainRSCStream();
+		const entriesStart = performance.now();
+		const { Root, App } = await loadEntries();
+		timings.push(`entries;dur=${performance.now() - entriesStart}`);
+		const rscStart = performance.now();
+		const rootRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx(App, {}) }) });
+		timings.push(`rsc;dur=${performance.now() - rscStart}`);
 		return new Response(rootRscStream, {
 			status: 200,
-			headers: { "content-type": "text/x-component;charset=utf-8" }
+			headers: {
+				"content-type": "text/x-component;charset=utf-8",
+				"Server-Timing": timings.join(", ")
+			}
 		});
 	}
 	const moduleId = extractIDFromModulePath(pathname);
 	if (!moduleId) throw new ServeRSCError(`Invalid RSC module path: ${pathname}`, 404);
+	const deferLoadStart = performance.now();
 	const entry = deferRegistry.load(moduleId);
 	if (!entry) throw new ServeRSCError(`RSC component not found: ${moduleId}`, 404);
+	timings.push(`defer-load;dur=${performance.now() - deferLoadStart}`);
 	const { state } = entry;
 	switch (state.state) {
 		case "streaming": return new Response(state.stream, {
 			status: 200,
-			headers: { "content-type": "text/x-component;charset=utf-8" }
+			headers: {
+				"content-type": "text/x-component;charset=utf-8",
+				"Server-Timing": timings.join(", ")
+			}
 		});
 		case "ready": return new Response(state.data, {
 			status: 200,
-			headers: { "content-type": "text/x-component;charset=utf-8" }
+			headers: {
+				"content-type": "text/x-component;charset=utf-8",
+				"Server-Timing": timings.join(", ")
+			}
 		});
 		case "error": throw new ServeRSCError(`Failed to load RSC component: ${state.error}`, 500);
 	}
@@ -74,14 +132,21 @@ async function serveRSC(request) {
 */
 async function build() {
 	const marker = generateAppMarker();
-	const Root = (await import("virtual:funstack/root")).default;
-	const App = (await import("virtual:funstack/app")).default;
-	const rootRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx("span", { id: marker }) }) });
-	const appRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(App, {}) });
+	const { Root, App } = await loadEntries();
+	let rootRscStream;
+	let appRscStream;
+	if (ssr) {
+		rootRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx(App, {}) }) });
+		appRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx(App, {}) }) });
+	} else {
+		rootRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx("span", { id: marker }) }) });
+		appRscStream = renderToReadableStream({ root: /* @__PURE__ */ jsx(App, {}) });
+	}
 	return {
 		html: (await (await import.meta.viteRsc.loadModule("ssr")).renderHTML(rootRscStream, {
 			appEntryMarker: marker,
-			build: true
+			build: true,
+			ssr
 		})).stream,
 		appRsc: appRscStream,
 		deferRegistry

package/dist/rsc/entry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry.mjs","names":[],"sources":["../../src/rsc/entry.tsx"],"sourcesContent":["import \"./defer\";\nimport { renderToReadableStream } from \"@vitejs/plugin-rsc/rsc\";\nimport { devMainRscPath } from \"./request\";\nimport { generateAppMarker } from \"./marker\";\nimport { deferRegistry } from \"./defer\";\nimport { extractIDFromModulePath } from \"./rscModule\";\nimport { stripBasePath } from \"../util/basePath\";\n\nexport type RscPayload = {\n  root: React.ReactNode;\n};\n\nasync function devMainRSCStream() {\n  const Root = (await import(\"virtual:funstack/root\")).default;\n  const App = (await import(\"virtual:funstack/app\")).default;\n\n  // Sanity check; this may happen when user-provided entry file\n  // does not have a default export.\n  if (Root === undefined) {\n    throw new Error(\n      \"Failed to load RSC root entry module. Check your entry file to ensure it has a default export.\",\n    );\n  }\n  if (App === undefined) {\n    throw new Error(\n      \"Failed to load RSC app entry module. Check your entry file to ensure it has a default export.\",\n    );\n  }\n\n  const rootRscStream = renderToReadableStream<RscPayload>({\n    root: (\n      <Root>\n        <App />\n      </Root>\n    ),\n  });\n  return rootRscStream;\n}\n\n/**\n * Entrypoint to serve HTML response in dev environment\n */\nexport async function serveHTML(): Promise<Response> {\n  const marker = generateAppMarker();\n\n  const rootRscStream = await devMainRSCStream();\n\n  const ssrEntryModule = await import.meta.viteRsc.loadModule<\n    typeof import(\"../ssr/entry\")\n  >(\"ssr\");\n  const ssrResult = await ssrEntryModule.renderHTML(rootRscStream, {\n    appEntryMarker: marker,\n    build: false,\n  });\n\n  // respond html\n  return new Response(ssrResult.stream, {\n    status: ssrResult.status,\n    headers: {\n      \"Content-type\": \"text/html\",\n    },\n  });\n}\n\nclass ServeRSCError extends Error {\n  status: 404 | 500;\n  constructor(message: string, status: 404 | 500) {\n    super(message);\n    this.name = \"ServeRSCError\";\n    this.status = status;\n  }\n}\n\nexport function isServeRSCError(error: unknown): error is ServeRSCError {\n  return error instanceof Error && error.name === \"ServeRSCError\";\n}\n\n/**\n * Servers an RSC stream response\n */\nexport async function serveRSC(request: Request): Promise<Response> {\n  const url = new URL(request.url);\n  const pathname = stripBasePath(url.pathname);\n  if (pathname === devMainRscPath) {\n    // root RSC stream is requested\n    const rootRscStream = await devMainRSCStream();\n    return new Response(rootRscStream, {\n      status: 200,\n      headers: {\n        \"content-type\": \"text/x-component;charset=utf-8\",\n      },\n    });\n  }\n\n  const moduleId = extractIDFromModulePath(pathname);\n  if (!moduleId) {\n    throw new ServeRSCError(`Invalid RSC module path: ${pathname}`, 404);\n  }\n\n  const entry = deferRegistry.load(moduleId);\n  if (!entry) {\n    throw new ServeRSCError(`RSC component not found: ${moduleId}`, 404);\n  }\n  const { state } = entry;\n  switch (state.state) {\n    case \"streaming\": {\n      return new Response(state.stream, {\n        status: 200,\n        headers: {\n          \"content-type\": \"text/x-component;charset=utf-8\",\n        },\n      });\n    }\n    case \"ready\": {\n      return new Response(state.data, {\n        status: 200,\n        headers: {\n          \"content-type\": \"text/x-component;charset=utf-8\",\n        },\n      });\n    }\n    case \"error\": {\n      throw new ServeRSCError(\n        `Failed to load RSC component: ${state.error}`,\n        500,\n      );\n    }\n  }\n}\n\n/**\n * Build handler\n */\nexport async function build() {\n  const marker = generateAppMarker();\n\n  const Root = (await import(\"virtual:funstack/root\")).default;\n  const App = (await import(\"virtual:funstack/app\")).default;\n\n  const rootRscStream = renderToReadableStream<RscPayload>({\n    root: (\n      <Root>\n        <span id={marker} />\n      </Root>\n    ),\n  });\n\n  const appRscStream = renderToReadableStream<RscPayload>({\n    root: <App />,\n  });\n\n  const ssrEntryModule = await import.meta.viteRsc.loadModule<\n    typeof import(\"../ssr/entry\")\n  >(\"ssr\");\n\n  const ssrResult = await ssrEntryModule.renderHTML(rootRscStream, {\n    appEntryMarker: marker,\n    build: true,\n  });\n\n  return {\n    html: ssrResult.stream,\n    appRsc: appRscStream,\n    deferRegistry,\n  };\n}\n\nexport { defer } from \"./defer\";\n\nif (import.meta.hot) {\n  import.meta.hot.accept();\n}\n"],"mappings":";;;;;;;;;AAYA,eAAe,mBAAmB;CAChC,MAAM,QAAQ,MAAM,OAAO,0BAA0B;CACrD,MAAM,OAAO,MAAM,OAAO,yBAAyB;AAInD,KAAI,SAAS,OACX,OAAM,IAAI,MACR,iGACD;AAEH,KAAI,QAAQ,OACV,OAAM,IAAI,MACR,gGACD;AAUH,QAPsB,uBAAmC,EACvD,MACE,oBAAC,kBACC,oBAAC,QAAM,GACF,EAEV,CAAC;;;;;AAOJ,eAAsB,YAA+B;CACnD,MAAM,SAAS,mBAAmB;CAElC,MAAM,gBAAgB,MAAM,kBAAkB;CAK9C,MAAM,YAAY,OAHK,MAAM,OAAO,KAAK,QAAQ,WAE/C,MAAM,EAC+B,WAAW,eAAe;EAC/D,gBAAgB;EAChB,OAAO;EACR,CAAC;AAGF,QAAO,IAAI,SAAS,UAAU,QAAQ;EACpC,QAAQ,UAAU;EAClB,SAAS,EACP,gBAAgB,aACjB;EACF,CAAC;;AAGJ,IAAM,gBAAN,cAA4B,MAAM;CAChC;CACA,YAAY,SAAiB,QAAmB;AAC9C,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,SAAS;;;AAIlB,SAAgB,gBAAgB,OAAwC;AACtE,QAAO,iBAAiB,SAAS,MAAM,SAAS;;;;;AAMlD,eAAsB,SAAS,SAAqC;CAElE,MAAM,WAAW,cADL,IAAI,IAAI,QAAQ,IAAI,CACG,SAAS;AAC5C,KAAI,aAAa,gBAAgB;EAE/B,MAAM,gBAAgB,MAAM,kBAAkB;AAC9C,SAAO,IAAI,SAAS,eAAe;GACjC,QAAQ;GACR,SAAS,EACP,gBAAgB,kCACjB;GACF,CAAC;;CAGJ,MAAM,WAAW,wBAAwB,SAAS;AAClD,KAAI,CAAC,SACH,OAAM,IAAI,cAAc,4BAA4B,YAAY,IAAI;CAGtE,MAAM,QAAQ,cAAc,KAAK,SAAS;AAC1C,KAAI,CAAC,MACH,OAAM,IAAI,cAAc,4BAA4B,YAAY,IAAI;CAEtE,MAAM,EAAE,UAAU;AAClB,SAAQ,MAAM,OAAd;EACE,KAAK,YACH,QAAO,IAAI,SAAS,MAAM,QAAQ;GAChC,QAAQ;GACR,SAAS,EACP,gBAAgB,kCACjB;GACF,CAAC;EAEJ,KAAK,QACH,QAAO,IAAI,SAAS,MAAM,MAAM;GAC9B,QAAQ;GACR,SAAS,EACP,gBAAgB,kCACjB;GACF,CAAC;EAEJ,KAAK,QACH,OAAM,IAAI,cACR,iCAAiC,MAAM,SACvC,IACD;;;;;;AAQP,eAAsB,QAAQ;CAC5B,MAAM,SAAS,mBAAmB;CAElC,MAAM,QAAQ,MAAM,OAAO,0BAA0B;CACrD,MAAM,OAAO,MAAM,OAAO,yBAAyB;CAEnD,MAAM,gBAAgB,uBAAmC,EACvD,MACE,oBAAC,kBACC,oBAAC,UAAK,IAAI,SAAU,GACf,EAEV,CAAC;CAEF,MAAM,eAAe,uBAAmC,EACtD,MAAM,oBAAC,QAAM,EACd,CAAC;AAWF,QAAO;EACL,OANgB,OAJK,MAAM,OAAO,KAAK,QAAQ,WAE/C,MAAM,EAE+B,WAAW,eAAe;GAC/D,gBAAgB;GAChB,OAAO;GACR,CAAC,EAGgB;EAChB,QAAQ;EACR;EACD;;AAKH,IAAI,OAAO,KAAK,IACd,QAAO,KAAK,IAAI,QAAQ"}
+{"version":3,"file":"entry.mjs","names":["ssrEnabled"],"sources":["../../src/rsc/entry.tsx"],"sourcesContent":["import \"./defer\";\nimport { renderToReadableStream } from \"@vitejs/plugin-rsc/rsc\";\nimport { devMainRscPath } from \"./request\";\nimport { generateAppMarker } from \"./marker\";\nimport { deferRegistry } from \"./defer\";\nimport { extractIDFromModulePath } from \"./rscModule\";\nimport { stripBasePath } from \"../util/basePath\";\n\nexport type RscPayload = {\n  root: React.ReactNode;\n};\n\nimport { ssr as ssrEnabled } from \"virtual:funstack/config\";\n\nasync function loadEntries() {\n  const Root = (await import(\"virtual:funstack/root\")).default;\n  const App = (await import(\"virtual:funstack/app\")).default;\n\n  // Sanity check; this may happen when user-provided entry file\n  // does not have a default export.\n  if (Root === undefined) {\n    throw new Error(\n      \"Failed to load RSC root entry module. Check your entry file to ensure it has a default export.\",\n    );\n  }\n  if (App === undefined) {\n    throw new Error(\n      \"Failed to load RSC app entry module. Check your entry file to ensure it has a default export.\",\n    );\n  }\n  return { Root, App };\n}\n\n/**\n * Entrypoint to serve HTML response in dev environment\n */\nexport async function serveHTML(): Promise<Response> {\n  const timings: string[] = [];\n  const marker = generateAppMarker();\n\n  const entriesStart = performance.now();\n  const { Root, App } = await loadEntries();\n  timings.push(`entries;dur=${performance.now() - entriesStart}`);\n\n  const ssrModuleStart = performance.now();\n  const ssrEntryModule = await import.meta.viteRsc.loadModule<\n    typeof import(\"../ssr/entry\")\n  >(\"ssr\");\n  timings.push(`ssr-module;dur=${performance.now() - ssrModuleStart}`);\n\n  if (ssrEnabled) {\n    // SSR on: single RSC stream with full tree\n    const rscStart = performance.now();\n    const rootRscStream = renderToReadableStream<RscPayload>({\n      root: (\n        <Root>\n          <App />\n        </Root>\n      ),\n    });\n    timings.push(`rsc;dur=${performance.now() - rscStart}`);\n\n    const ssrStart = performance.now();\n    const ssrResult = await ssrEntryModule.renderHTML(rootRscStream, {\n      appEntryMarker: marker,\n      build: false,\n      ssr: true,\n    });\n    timings.push(`ssr;dur=${performance.now() - ssrStart}`);\n\n    return new Response(ssrResult.stream, {\n      status: ssrResult.status,\n      headers: {\n        \"Content-type\": \"text/html\",\n        \"Server-Timing\": timings.join(\", \"),\n      },\n    });\n  } else {\n    // SSR off: shell RSC for SSR, full RSC for client\n    const rscStart = performance.now();\n    const shellRscStream = renderToReadableStream<RscPayload>({\n      root: (\n        <Root>\n          <span id={marker} />\n        </Root>\n      ),\n    });\n    const clientRscStream = renderToReadableStream<RscPayload>({\n      root: (\n        <Root>\n          <App />\n        </Root>\n      ),\n    });\n    timings.push(`rsc;dur=${performance.now() - rscStart}`);\n\n    const ssrStart = performance.now();\n    const ssrResult = await ssrEntryModule.renderHTML(shellRscStream, {\n      appEntryMarker: marker,\n      build: false,\n      ssr: false,\n      clientRscStream,\n    });\n    timings.push(`ssr;dur=${performance.now() - ssrStart}`);\n\n    return new Response(ssrResult.stream, {\n      status: ssrResult.status,\n      headers: {\n        \"Content-type\": \"text/html\",\n        \"Server-Timing\": timings.join(\", \"),\n      },\n    });\n  }\n}\n\nclass ServeRSCError extends Error {\n  status: 404 | 500;\n  constructor(message: string, status: 404 | 500) {\n    super(message);\n    this.name = \"ServeRSCError\";\n    this.status = status;\n  }\n}\n\nexport function isServeRSCError(error: unknown): error is ServeRSCError {\n  return error instanceof Error && error.name === \"ServeRSCError\";\n}\n\n/**\n * Servers an RSC stream response\n */\nexport async function serveRSC(request: Request): Promise<Response> {\n  const timings: string[] = [];\n  const url = new URL(request.url);\n  const pathname = stripBasePath(url.pathname);\n  if (pathname === devMainRscPath) {\n    // root RSC stream is requested (HMR re-fetch always sends full tree)\n    const entriesStart = performance.now();\n    const { Root, App } = await loadEntries();\n    timings.push(`entries;dur=${performance.now() - entriesStart}`);\n\n    const rscStart = performance.now();\n    const rootRscStream = renderToReadableStream<RscPayload>({\n      root: (\n        <Root>\n          <App />\n        </Root>\n      ),\n    });\n    timings.push(`rsc;dur=${performance.now() - rscStart}`);\n\n    return new Response(rootRscStream, {\n      status: 200,\n      headers: {\n        \"content-type\": \"text/x-component;charset=utf-8\",\n        \"Server-Timing\": timings.join(\", \"),\n      },\n    });\n  }\n\n  const moduleId = extractIDFromModulePath(pathname);\n  if (!moduleId) {\n    throw new ServeRSCError(`Invalid RSC module path: ${pathname}`, 404);\n  }\n\n  const deferLoadStart = performance.now();\n  const entry = deferRegistry.load(moduleId);\n  if (!entry) {\n    throw new ServeRSCError(`RSC component not found: ${moduleId}`, 404);\n  }\n  timings.push(`defer-load;dur=${performance.now() - deferLoadStart}`);\n\n  const { state } = entry;\n  switch (state.state) {\n    case \"streaming\": {\n      return new Response(state.stream, {\n        status: 200,\n        headers: {\n          \"content-type\": \"text/x-component;charset=utf-8\",\n          \"Server-Timing\": timings.join(\", \"),\n        },\n      });\n    }\n    case \"ready\": {\n      return new Response(state.data, {\n        status: 200,\n        headers: {\n          \"content-type\": \"text/x-component;charset=utf-8\",\n          \"Server-Timing\": timings.join(\", \"),\n        },\n      });\n    }\n    case \"error\": {\n      throw new ServeRSCError(\n        `Failed to load RSC component: ${state.error}`,\n        500,\n      );\n    }\n  }\n}\n\n/**\n * Build handler\n */\nexport async function build() {\n  const marker = generateAppMarker();\n  const { Root, App } = await loadEntries();\n\n  let rootRscStream: ReadableStream<Uint8Array>;\n  let appRscStream: ReadableStream<Uint8Array>;\n\n  if (ssrEnabled) {\n    // SSR on: both streams have full tree\n    rootRscStream = renderToReadableStream<RscPayload>({\n      root: (\n        <Root>\n          <App />\n        </Root>\n      ),\n    });\n    appRscStream = renderToReadableStream<RscPayload>({\n      root: (\n        <Root>\n          <App />\n        </Root>\n      ),\n    });\n  } else {\n    // SSR off: root stream has shell, app stream has App only\n    rootRscStream = renderToReadableStream<RscPayload>({\n      root: (\n        <Root>\n          <span id={marker} />\n        </Root>\n      ),\n    });\n    appRscStream = renderToReadableStream<RscPayload>({\n      root: <App />,\n    });\n  }\n\n  const ssrEntryModule = await import.meta.viteRsc.loadModule<\n    typeof import(\"../ssr/entry\")\n  >(\"ssr\");\n\n  const ssrResult = await ssrEntryModule.renderHTML(rootRscStream, {\n    appEntryMarker: marker,\n    build: true,\n    ssr: ssrEnabled,\n  });\n\n  return {\n    html: ssrResult.stream,\n    appRsc: appRscStream,\n    deferRegistry,\n  };\n}\n\nexport { defer } from \"./defer\";\n\nif (import.meta.hot) {\n  import.meta.hot.accept();\n}\n"],"mappings":"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"}