feat(plugin-rsc): expose onClientReference callback in renderToReadableStream

[hi-ogawa]

Summary

• Add an experimental onClientReference callback option to renderToReadableStream via a third extraOptions parameter
• The callback is invoked when a client reference is used in RSC stream rendering, providing id, name, and resolved asset dependencies (deps with JS/CSS files)
• This is a Vite-specific extension (not part of official React RSC API)

API

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>

example

import { renderToReadableStream } from "@vitejs/plugin-rsc/rsc"

renderToReadableStream(
  rscPayload,
  options,
  {
    onClientReference(metadata) {
      metadata.deps.js;
      metadata.deps.css;
    }
  }
)

Test plan

• e2e test added for dev and build modes

🤖 Generated with Claude Code