@vitejs/plugin-rsc 0.5.15 → 0.5.16

package/README.md

@@ -453,6 +453,30 @@ This module re-exports RSC runtime API provided by `react-server-dom/server.edge
 - `decodeAction/decodeReply/decodeFormState/loadServerAction/createTemporaryReferenceSet`
 - `encodeReply/createClientTemporaryReferenceSet`
 
+#### Vite-specific extension: `renderToReadableStream` (experimental)
+
+> [!NOTE]
+> This is a Vite-specific extension to the standard React RSC API. The official `react-server-dom` does not provide this callback mechanism.
+
+`renderToReadableStream` API is extended with an optional third parameter with `onClientReference` callback.
+This is invoked whenever a client reference is used in RSC stream rendering.
+
+```ts
+function renderToReadableStream<T>(
+  data: T,
+  // standard options (e.g. temporaryReferences, onError, etc.)
+  options?: object,
+  // vite-specific options
+  extraOptions?: {
+    onClientReference?: (metadata: {
+      id: string
+      name: string
+      deps: { js: string[]; css: string[] }
+    }) => void
+  },
+): ReadableStream<Uint8Array>
+```
+
 ### `@vitejs/plugin-rsc/ssr`
 
 This module re-exports RSC runtime API provided by `react-server-dom/client.edge`

package/dist/core/rsc.d.ts

@@ -7,6 +7,14 @@ declare function setRequireModule(options: {
 declare function loadServerAction(id: string): Promise<Function>;
 declare function createServerManifest(): BundlerConfig;
 declare function createServerDecodeClientManifest(): ModuleMap;
-declare function createClientManifest(): BundlerConfig;
+declare function createClientManifest(options?: {
+  /**
+  * @internal
+  */
+  onClientReference?: (metadata: {
+    id: string;
+    name: string;
+  }) => void;
+}): BundlerConfig;
 //#endregion
 export { createClientManifest, createServerDecodeClientManifest, createServerManifest, loadServerAction, setRequireModule };

package/dist/core/rsc.js

@@ -1,3 +1,3 @@
-import { a as setRequireModule, i as loadServerAction, n as createServerDecodeClientManifest, r as createServerManifest, t as createClientManifest } from "../rsc-DRNoX2Q6.js";
+import { a as setRequireModule, i as loadServerAction, n as createServerDecodeClientManifest, r as createServerManifest, t as createClientManifest } from "../rsc-BCFg12vs.js";
 
 export { createClientManifest, createServerDecodeClientManifest, createServerManifest, loadServerAction, setRequireModule };

package/dist/react/rsc.d.ts

@@ -2,7 +2,15 @@ import { loadServerAction, setRequireModule } from "../core/rsc.js";
 import { ReactFormState } from "react-dom/client";
 
 //#region src/react/rsc.d.ts
-declare function renderToReadableStream<T>(data: T, options?: object): ReadableStream<Uint8Array>;
+declare function renderToReadableStream<T>(data: T, options?: object, extraOptions?: {
+  /**
+  * @internal
+  */
+  onClientReference?: (metadata: {
+    id: string;
+    name: string;
+  }) => void;
+}): ReadableStream<Uint8Array>;
 declare function createFromReadableStream<T>(stream: ReadableStream<Uint8Array>, options?: object): Promise<T>;
 declare function registerClientReference<T>(proxy: T, id: string, name: string): T;
 declare const registerServerReference: <T>(ref: T, id: string, name: string) => T;

package/dist/react/rsc.js

@@ -1,10 +1,10 @@
-import { a as setRequireModule, i as loadServerAction, n as createServerDecodeClientManifest, r as createServerManifest, t as createClientManifest } from "../rsc-DRNoX2Q6.js";
+import { a as setRequireModule, i as loadServerAction, n as createServerDecodeClientManifest, r as createServerManifest, t as createClientManifest } from "../rsc-BCFg12vs.js";
 import * as ReactClient from "@vitejs/plugin-rsc/vendor/react-server-dom/client.edge";
 import * as ReactServer from "@vitejs/plugin-rsc/vendor/react-server-dom/server.edge";
 
 //#region src/react/rsc.ts
-function renderToReadableStream(data, options) {
-	return ReactServer.renderToReadableStream(data, createClientManifest(), options);
+function renderToReadableStream(data, options, extraOptions) {
+	return ReactServer.renderToReadableStream(data, createClientManifest({ onClientReference: extraOptions?.onClientReference }), options);
 }
 function createFromReadableStream(stream, options = {}) {
 	return ReactClient.createFromReadableStream(stream, {

package/dist/{rsc-DRNoX2Q6.js → rsc-BCFg12vs.js}

@@ -62,13 +62,17 @@ function createServerDecodeClientManifest() {
 		} });
 	} });
 }
-function createClientManifest() {
+function createClientManifest(options) {
 	const cacheTag = import.meta.env.DEV ? createReferenceCacheTag() : "";
 	return new Proxy({}, { get(_target, $$id, _receiver) {
 		tinyassert(typeof $$id === "string");
 		let [id, name] = $$id.split("#");
 		tinyassert(id);
 		tinyassert(name);
+		options?.onClientReference?.({
+			id,
+			name
+		});
 		return {
 			id: id + cacheTag,
 			name,

package/dist/rsc.d.ts

@@ -1,4 +1,19 @@
 import { createClientManifest, createServerManifest, loadServerAction, setRequireModule } from "./core/rsc.js";
-import { createClientTemporaryReferenceSet, createFromReadableStream, createTemporaryReferenceSet, decodeAction, decodeFormState, decodeReply, encodeReply, registerClientReference, registerServerReference, renderToReadableStream } from "./react/rsc.js";
+import { i as ResolvedAssetDeps } from "./plugin-V6VFxi_0.js";
+import "./index-DJ0AhQ9B.js";
+import { createClientTemporaryReferenceSet, createFromReadableStream, createTemporaryReferenceSet, decodeAction, decodeFormState, decodeReply, encodeReply, registerClientReference, registerServerReference } from "./react/rsc.js";
 import { decryptActionBoundArgs, encryptActionBoundArgs } from "./utils/encryption-runtime.js";
+
+//#region src/rsc.d.ts
+declare function renderToReadableStream<T>(data: T, options?: object, extraOptions?: {
+  /**
+  * @experimental
+  */
+  onClientReference?: (metadata: {
+    id: string;
+    name: string;
+    deps: ResolvedAssetDeps;
+  }) => void;
+}): ReadableStream<Uint8Array>;
+//#endregion
 export { createClientManifest, createClientTemporaryReferenceSet, createFromReadableStream, createServerManifest, createTemporaryReferenceSet, decodeAction, decodeFormState, decodeReply, decryptActionBoundArgs, encodeReply, encryptActionBoundArgs, loadServerAction, registerClientReference, registerServerReference, renderToReadableStream, setRequireModule };

package/dist/rsc.js

@@ -1,7 +1,8 @@
 import { a as toReferenceValidationVirtual } from "./shared-Chot7h9j.js";
-import { a as setRequireModule, i as loadServerAction, r as createServerManifest, t as createClientManifest } from "./rsc-DRNoX2Q6.js";
-import { createClientTemporaryReferenceSet, createFromReadableStream, createTemporaryReferenceSet, decodeAction, decodeFormState, decodeReply, encodeReply, registerClientReference, registerServerReference, renderToReadableStream } from "./react/rsc.js";
+import { a as setRequireModule, i as loadServerAction, r as createServerManifest, t as createClientManifest } from "./rsc-BCFg12vs.js";
+import { createClientTemporaryReferenceSet, createFromReadableStream, createTemporaryReferenceSet, decodeAction, decodeFormState, decodeReply, encodeReply, registerClientReference, registerServerReference, renderToReadableStream as renderToReadableStream$1 } from "./react/rsc.js";
 import { decryptActionBoundArgs, encryptActionBoundArgs } from "./utils/encryption-runtime.js";
+import assetsManifest from "virtual:vite-rsc/assets-manifest";
 import serverReferences from "virtual:vite-rsc/server-references";
 
 //#region src/rsc.tsx
@@ -27,6 +28,19 @@ function initialize() {
 		}
 	} });
 }
+function renderToReadableStream(data, options, extraOptions) {
+	return renderToReadableStream$1(data, options, { onClientReference(metadata) {
+		const deps = assetsManifest.clientReferenceDeps[metadata.id] ?? {
+			js: [],
+			css: []
+		};
+		extraOptions?.onClientReference?.({
+			id: metadata.id,
+			name: metadata.name,
+			deps
+		});
+	} });
+}
 
 //#endregion
 export { createClientManifest, createClientTemporaryReferenceSet, createFromReadableStream, createServerManifest, createTemporaryReferenceSet, decodeAction, decodeFormState, decodeReply, decryptActionBoundArgs, encodeReply, encryptActionBoundArgs, loadServerAction, registerClientReference, registerServerReference, renderToReadableStream, setRequireModule };

package/dist/utils/encryption-runtime.js

@@ -1,6 +1,6 @@
 import { r as once } from "../dist-DZUJDIM2.js";
 import { a as fromBase64, i as encryptBuffer, n as concatArrayStream, r as decryptBuffer, t as arrayToStream } from "../encryption-utils-BPYvebX4.js";
-import "../rsc-DRNoX2Q6.js";
+import "../rsc-BCFg12vs.js";
 import { createFromReadableStream, renderToReadableStream } from "../react/rsc.js";
 import encryptionKeySource from "virtual:vite-rsc/encryption-key";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitejs/plugin-rsc",
-  "version": "0.5.15",
+  "version": "0.5.16",
   "description": "React Server Components (RSC) support for Vite.",
   "keywords": [
     "react",