@tanstack/redact 0.0.21 → 0.1.0

package/dist/server/stream.js

@@ -1,37 +1,70 @@
-// packages/redact/src/server/stream.ts
+// src/server/stream.ts
 import {
   beginSSR,
   endSSR,
-  installSSRDispatcher,
-  uninstallSSRDispatcher,
-  applyContextSnapshot
-} from "./dispatcher";
-import { walk } from "./walk";
-import { BOUNDARY_REVEAL_RUNTIME, revealScript } from "./bootstrap-script";
-import { escapeScript } from "./escape";
+  applyContextSnapshot,
+  currentSSRFrame
+} from "./dispatcher.js";
+import { walk } from "./walk.js";
+import { browserError, isBrowserToken, isBrowserError } from "../core/browser.js";
+import { BOUNDARY_REVEAL_RUNTIME, revealScript } from "./bootstrap-script.js";
+import { escapeAttr, escapeScript } from "./escape.js";
+import { resourceURL } from "../core/resource-hints.js";
+function createState() {
+  let wake;
+  const state = {
+    nextId: 0,
+    pending: /* @__PURE__ */ new Set(),
+    closed: false,
+    errored: null,
+    aborted: false,
+    reason: void 0,
+    cancelled: new Promise((resolve) => {
+      wake = resolve;
+    }),
+    abort(reason) {
+      if (state.closed || state.aborted) return;
+      state.aborted = true;
+      state.reason = isBrowserToken(reason) ? browserError(reason) : reason ?? new Error("The render was aborted by the server without a reason.");
+      wake();
+    }
+  };
+  return state;
+}
 async function streamHtml(children, emit, options, state) {
-  installSSRDispatcher();
-  beginSSR(options.identifierPrefix);
-  const nonce = options.nonce;
+  const nonce = scriptNonce(options);
   try {
     const boundaries = [];
     const shellChunks = [];
+    let head = 0;
     const bufferedEmit = (chunk) => {
       shellChunks.push(chunk);
     };
     let shellRendered = false;
     let rootRetries = 0;
+    let resources;
     while (!shellRendered) {
       const chunkCount = shellChunks.length;
       const boundaryCount = boundaries.length;
       const nextId = state.nextId;
+      head = 0;
+      const previous = beginSSR(options.identifierPrefix);
+      currentSSRFrame().styleNonce = typeof options.nonce === "object" ? options.nonce?.style : void 0;
+      if (resources) currentSSRFrame().resources = resources;
+      let suspended;
       try {
+        if (state.aborted) throw state.reason;
         walk(children, {
           emit: bufferedEmit,
           onSuspend: (b) => boundaries.push(b),
-          nextBoundaryId: () => state.nextId++
+          nextBoundaryId: () => state.nextId++,
+          onBrowserBailout: options.onBrowserBailout,
+          onHead: () => {
+            head = shellChunks.length;
+          }
         });
         shellRendered = true;
+        state.frame = currentSSRFrame();
       } catch (err) {
         shellChunks.length = chunkCount;
         boundaries.length = boundaryCount;
@@ -40,12 +73,19 @@ async function streamHtml(children, emit, options, state) {
         if (++rootRetries > 50) {
           throw new Error("renderToReadableStream exceeded 50 root suspension retries.");
         }
-        await err;
+        suspended = err;
+      } finally {
+        resources = currentSSRFrame().resources;
+        endSSR(previous);
       }
+      if (suspended) await Promise.race([suspended, state.cancelled]);
     }
+    const hints = state.frame?.resources?.drain();
+    if (hints) shellChunks.splice(head, 0, hints);
+    if (state.frame) state.frame.shellFlushed = true;
     const hasBootstrap = bootstrapScriptContentToArray(options.bootstrapScriptContent).length > 0 || (options.bootstrapScripts?.length ?? 0) > 0 || (options.bootstrapModules?.length ?? 0) > 0;
     if (boundaries.length > 0 || hasBootstrap) {
-      shellChunks.push(`<script${nonce ? ` nonce="${nonce}"` : ""}>${BOUNDARY_REVEAL_RUNTIME}<\/script>`);
+      shellChunks.push(`<script${nonce ? ` nonce="${escapeAttr(nonce)}"` : ""}>${BOUNDARY_REVEAL_RUNTIME}<\/script>`);
       for (const content of bootstrapScriptContentToArray(options.bootstrapScriptContent)) {
         shellChunks.push(inlineBootstrapTag(content, nonce));
       }
@@ -57,46 +97,74 @@ async function streamHtml(children, emit, options, state) {
       }
     }
     if (shellChunks.length) emit(normalizeDocumentShell(shellChunks.join("")));
+    state.onShellReady?.();
     for (const b of boundaries) streamBoundary(b, emit, options, state);
     await drain(state);
   } catch (err) {
+    if (isBrowserError(err)) {
+      err = new Error(
+        "The server render could not complete because client rendering was requested outside a Suspense boundary.",
+        Object.hasOwn(err, "cause") ? { cause: err.cause } : void 0
+      );
+    }
     state.errored = err;
     if (options.onError) options.onError(err);
     throw err;
   } finally {
-    endSSR();
-    uninstallSSRDispatcher();
     state.closed = true;
   }
 }
 function streamBoundary(b, emit, options, state) {
+  const nonce = scriptNonce(options);
   const task = (async () => {
     try {
-      await b.thenable;
-    } catch (err) {
-      if (options.onError) options.onError(err);
+      await Promise.race([b.thenable, state.cancelled]);
+    } catch {
     }
     if (state.closed) return;
+    const defer = (error) => {
+      if (isBrowserError(error)) options.onBrowserBailout?.(error, { componentStack: error.componentStack || b.componentStack });
+      else options.onError?.(error);
+      emit(`<script${nonce ? ` nonce="${escapeAttr(nonce)}"` : ""}>$RB(${b.id}${isBrowserError(error) ? "" : ",1"})<\/script>`);
+    };
+    if (state.aborted) {
+      defer(state.reason);
+      return;
+    }
     const parts = [];
     const sub = [];
+    const resourceScope = {};
+    let styles;
+    const previous = beginSSR(options.identifierPrefix, state.frame);
+    state.frame?.resources?.takeStylesheets();
     const restore = applyContextSnapshot(b.contextSnapshot);
     try {
       walk(b.children, {
         emit: (s) => parts.push(s),
         onSuspend: (n) => sub.push(n),
-        nextBoundaryId: () => state.nextId++
+        nextBoundaryId: () => state.nextId++,
+        onBrowserBailout: options.onBrowserBailout,
+        componentStack: b.componentStack,
+        resourceScope
       });
+      state.frame?.resources?.mergeScope(resourceScope);
     } catch (err) {
-      if (options.onError) options.onError(err);
-      restore();
+      if (isThenable(err)) {
+        streamBoundary({ ...b, thenable: err }, emit, options, state);
+      } else defer(err);
       return;
+    } finally {
+      restore();
+      endSSR(previous);
+      const hints = state.frame?.resources?.drain();
+      styles = state.frame?.resources?.takeStylesheets();
+      if (hints) emit(hints);
     }
-    restore();
-    emit(`<div hidden id="S:${b.id}">${parts.join("")}</div>${revealScript(b.id, options.nonce)}`);
+    emit(`<div hidden id="S:${b.id}">${parts.join("")}</div>${revealScript(b.id, nonce, styles)}`);
     for (const s of sub) streamBoundary(s, emit, options, state);
   })();
   state.pending.add(task);
-  task.finally(() => state.pending.delete(task));
+  task.then(() => state.pending.delete(task), () => state.pending.delete(task));
 }
 async function drain(state) {
   while (state.pending.size > 0) {
@@ -106,12 +174,15 @@ async function drain(state) {
 function isThenable(value) {
   return !!value && typeof value.then === "function";
 }
+function scriptNonce(options) {
+  return typeof options.nonce === "string" ? options.nonce : options.nonce?.script;
+}
 function bootstrapScriptContentToArray(content) {
   if (content === void 0) return [];
   return typeof content === "string" ? [content] : [...content];
 }
 function inlineBootstrapTag(content, defaultNonce) {
-  const nAttr = defaultNonce ? ` nonce="${defaultNonce}"` : "";
+  const nAttr = defaultNonce ? ` nonce="${escapeAttr(defaultNonce)}"` : "";
   return `<script${nAttr}>${escapeScript(content)}<\/script>`;
 }
 function normalizeDocumentShell(html) {
@@ -146,26 +217,37 @@ function stripLeadingHeadTags(value) {
   return rest;
 }
 function bootstrapTag(entry, kind, defaultNonce) {
-  const src = typeof entry === "string" ? entry : entry.src;
+  const src = escapeAttr(resourceURL(typeof entry === "string" ? entry : entry.src));
   const nonce = typeof entry === "string" ? defaultNonce : entry.nonce ?? defaultNonce;
-  const nAttr = nonce ? ` nonce="${nonce}"` : "";
+  const nAttr = nonce ? ` nonce="${escapeAttr(nonce)}"` : "";
   if (kind === "module") return `<script type="module"${nAttr} src="${src}"><\/script>`;
   return `<script async${nAttr} src="${src}"><\/script>`;
 }
 function renderToReadableStream(children, options = {}) {
-  const state = {
-    nextId: 0,
-    pending: /* @__PURE__ */ new Set(),
-    closed: false,
-    errored: null
-  };
+  const state = createState();
   const encoder = new TextEncoder();
+  let abortListener;
+  const detachAbortListener = () => {
+    if (abortListener) {
+      options.signal?.removeEventListener("abort", abortListener);
+      abortListener = void 0;
+    }
+  };
   let allReadyResolve;
   let allReadyReject;
   const allReady = new Promise((r, rej) => {
     allReadyResolve = r;
     allReadyReject = rej;
   });
+  allReady.catch(() => {
+  });
+  let shellResolve;
+  let shellReject;
+  const shell = new Promise((resolve, reject) => {
+    shellResolve = resolve;
+    shellReject = reject;
+  });
+  state.onShellReady = () => queueMicrotask(() => shellResolve(Object.assign(stream, { allReady })));
   const stream = new ReadableStream({
     start(controller) {
       const emit = (chunk) => {
@@ -174,8 +256,17 @@ function renderToReadableStream(children, options = {}) {
         } catch {
         }
       };
+      if (options.signal) {
+        abortListener = () => {
+          detachAbortListener();
+          state.abort(options.signal.reason);
+        };
+        options.signal.addEventListener("abort", abortListener);
+        if (options.signal.aborted) abortListener();
+      }
       streamHtml(children, emit, options, state).then(
         () => {
+          detachAbortListener();
           try {
             controller.close();
           } catch {
@@ -183,46 +274,51 @@ function renderToReadableStream(children, options = {}) {
           allReadyResolve();
         },
         (err) => {
+          detachAbortListener();
           try {
             controller.error(err);
           } catch {
           }
           allReadyReject(err);
+          shellReject(err);
         }
       );
-      options.signal?.addEventListener("abort", () => {
-        state.closed = true;
-        try {
-          controller.close();
-        } catch {
-        }
-      });
+    },
+    cancel(reason) {
+      state.abort(reason);
+      detachAbortListener();
     }
   });
-  return Promise.resolve(Object.assign(stream, { allReady }));
+  return shell;
 }
 function renderToPipeableStream(children, options = {}) {
-  const state = {
-    nextId: 0,
-    pending: /* @__PURE__ */ new Set(),
-    closed: false,
-    errored: null
-  };
+  const state = createState();
   const buffers = [];
   let dest = null;
   let shellReady = false;
+  let shellFailed = false;
   let finished = false;
-  let aborted = false;
+  let failed = false;
+  let failure;
+  const finishDestination = (target) => {
+    if (failed && target.destroy) target.destroy(failure);
+    else target.end();
+  };
   const flushTo = (w) => {
     if (!buffers.length) return;
     for (const b of buffers) w.write(b);
     buffers.length = 0;
   };
   const emit = (chunk) => {
-    if (aborted || finished) return;
+    if (finished) return;
     if (dest) dest.write(chunk);
     else buffers.push(chunk);
   };
+  state.onShellReady = () => queueMicrotask(() => {
+    if (shellFailed) return;
+    shellReady = true;
+    options.onShellReady?.();
+  });
   streamHtml(children, emit, options, state).then(
     () => {
       finished = true;
@@ -230,30 +326,26 @@ function renderToPipeableStream(children, options = {}) {
       options.onAllReady?.();
     },
     (err) => {
+      finished = true;
+      failed = true;
+      failure = err;
       if (!shellReady) {
+        shellFailed = true;
         options.onShellError?.(err);
       } else {
-        options.onError?.(err);
-        if (dest) dest.end();
+        if (dest) finishDestination(dest);
       }
     }
   );
-  queueMicrotask(() => {
-    if (aborted || finished) return;
-    shellReady = true;
-    options.onShellReady?.();
-  });
   return {
     pipe(target) {
       dest = target;
-      flushTo(target);
-      if (finished) target.end();
+      if (!failed) flushTo(target);
+      if (finished) finishDestination(target);
       return target;
     },
-    abort(_reason) {
-      aborted = true;
-      state.closed = true;
-      if (dest) dest.end();
+    abort(reason) {
+      state.abort(reason);
     }
   };
 }

package/dist/server/stream.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/server/stream.ts"],
-  "sourcesContent": ["import type { ReactNode } from '../core'\nimport {\n  beginSSR,\n  endSSR,\n  installSSRDispatcher,\n  uninstallSSRDispatcher,\n  applyContextSnapshot,\n} from './dispatcher'\nimport { walk, type SuspendedBoundary } from './walk'\nimport { BOUNDARY_REVEAL_RUNTIME, revealScript } from './bootstrap-script'\nimport { escapeScript } from './escape'\n\nexport interface StreamOptions {\n  identifierPrefix?: string\n  nonce?: string\n  bootstrapScriptContent?: string | ReadonlyArray<string>\n  bootstrapScripts?: ReadonlyArray<string | { src: string; async?: boolean; nonce?: string }>\n  bootstrapModules?: ReadonlyArray<string | { src: string; nonce?: string }>\n  onError?: (error: unknown) => string | void\n  signal?: AbortSignal\n  progressiveChunkSize?: number\n}\n\nexport interface ReadableStreamResult extends ReadableStream<Uint8Array> {\n  allReady: Promise<void>\n}\n\nexport interface PipeableWritable {\n  write(chunk: string): unknown\n  end(): unknown\n}\n\nexport interface OrchestratorState {\n  nextId: number\n  pending: Set<Promise<void>>\n  closed: boolean\n  errored: unknown | null\n}\n\ntype Emit = (chunk: string) => void\n\nexport async function streamHtml(\n  children: ReactNode,\n  emit: Emit,\n  options: StreamOptions,\n  state: OrchestratorState,\n): Promise<void> {\n  installSSRDispatcher()\n  beginSSR(options.identifierPrefix)\n  const nonce = options.nonce\n\n  try {\n    const boundaries: SuspendedBoundary[] = []\n\n    // Buffer shell + bootstrap into a string[] and flush as a single emit.\n    // Per-emit overhead in renderToReadableStream is TextEncoder.encode +\n    // controller.enqueue \u2014 each walkHost normally fires 3+ emits (opening\n    // tag, per-attribute, closing bracket), which for a ~30-component tree\n    // is ~100 stream-controller round-trips. Batching collapses those into\n    // one encode and one enqueue per shell \u2014 measured ~2-4% of total SSR\n    // time on CPU profiles.\n    const shellChunks: string[] = []\n    const bufferedEmit: Emit = (chunk) => {\n      shellChunks.push(chunk)\n    }\n\n    // 1. Render the shell. A root-level `use(promise)` has no Suspense\n    // boundary to capture it, but App Router SSR commonly suspends at this\n    // level while resolving the RSC stream. Wait and retry without leaking\n    // partial shell chunks or boundary ids from the aborted attempt.\n    let shellRendered = false\n    let rootRetries = 0\n    while (!shellRendered) {\n      const chunkCount = shellChunks.length\n      const boundaryCount = boundaries.length\n      const nextId = state.nextId\n      try {\n        walk(children, {\n          emit: bufferedEmit,\n          onSuspend: (b) => boundaries.push(b),\n          nextBoundaryId: () => state.nextId++,\n        })\n        shellRendered = true\n      } catch (err) {\n        shellChunks.length = chunkCount\n        boundaries.length = boundaryCount\n        state.nextId = nextId\n        if (!isThenable(err)) throw err\n        if (++rootRetries > 50) {\n          throw new Error('renderToReadableStream exceeded 50 root suspension retries.')\n        }\n        await err\n      }\n    }\n\n    // 2. Inject runtime + bootstrap scripts (once, after shell). Skip the\n    // reveal/event-replay runtime when nothing needs it \u2014 no suspensions to\n    // reveal and no bootstrap scripts to guard against early user input. That\n    // keeps fully-static SSR responses byte-equivalent to a plain walk and\n    // matches React's behavior where `renderToReadableStream` of a static\n    // tree emits only the markup.\n    const hasBootstrap =\n      bootstrapScriptContentToArray(options.bootstrapScriptContent).length > 0 ||\n      (options.bootstrapScripts?.length ?? 0) > 0 ||\n      (options.bootstrapModules?.length ?? 0) > 0\n    if (boundaries.length > 0 || hasBootstrap) {\n      shellChunks.push(`<script${nonce ? ` nonce=\"${nonce}\"` : ''}>${BOUNDARY_REVEAL_RUNTIME}</script>`)\n      for (const content of bootstrapScriptContentToArray(options.bootstrapScriptContent)) {\n        shellChunks.push(inlineBootstrapTag(content, nonce))\n      }\n      for (const s of options.bootstrapScripts ?? []) {\n        shellChunks.push(bootstrapTag(s, 'script', nonce))\n      }\n      for (const m of options.bootstrapModules ?? []) {\n        shellChunks.push(bootstrapTag(m, 'module', nonce))\n      }\n    }\n\n    if (shellChunks.length) emit(normalizeDocumentShell(shellChunks.join('')))\n\n    // 3. Stream suspended boundaries as they resolve\n    for (const b of boundaries) streamBoundary(b, emit, options, state)\n    await drain(state)\n  } catch (err) {\n    state.errored = err\n    if (options.onError) options.onError(err)\n    throw err\n  } finally {\n    endSSR()\n    uninstallSSRDispatcher()\n    state.closed = true\n  }\n}\n\nfunction streamBoundary(\n  b: SuspendedBoundary,\n  emit: Emit,\n  options: StreamOptions,\n  state: OrchestratorState,\n): void {\n  const task = (async () => {\n    try {\n      await b.thenable\n    } catch (err) {\n      if (options.onError) options.onError(err)\n    }\n    if (state.closed) return\n\n    // Re-render the boundary's children into a string, restoring the\n    // provider stack from when the boundary first suspended.\n    const parts: string[] = []\n    const sub: SuspendedBoundary[] = []\n    const restore = applyContextSnapshot(b.contextSnapshot)\n    try {\n      walk(b.children, {\n        emit: (s) => parts.push(s),\n        onSuspend: (n) => sub.push(n),\n        nextBoundaryId: () => state.nextId++,\n      })\n    } catch (err) {\n      if (options.onError) options.onError(err)\n      restore()\n      return\n    }\n    restore()\n\n    emit(`<div hidden id=\"S:${b.id}\">${parts.join('')}</div>${revealScript(b.id, options.nonce)}`)\n\n    // Recurse: any nested suspensions inside the now-revealed content\n    for (const s of sub) streamBoundary(s, emit, options, state)\n  })()\n  state.pending.add(task)\n  task.finally(() => state.pending.delete(task))\n}\n\nasync function drain(state: OrchestratorState): Promise<void> {\n  while (state.pending.size > 0) {\n    await Promise.race(state.pending)\n  }\n}\n\nfunction isThenable(value: unknown): value is Promise<unknown> {\n  return !!value && typeof (value as { then?: unknown }).then === 'function'\n}\n\nfunction bootstrapScriptContentToArray(\n  content: StreamOptions['bootstrapScriptContent'],\n): string[] {\n  if (content === undefined) return []\n  return typeof content === 'string' ? [content] : [...content]\n}\n\nfunction inlineBootstrapTag(content: string, defaultNonce: string | undefined): string {\n  const nAttr = defaultNonce ? ` nonce=\"${defaultNonce}\"` : ''\n  return `<script${nAttr}>${escapeScript(content)}</script>`\n}\n\nfunction normalizeDocumentShell(html: string): string {\n  const doctypeIndex = html.indexOf('<!DOCTYPE html><html')\n  if (doctypeIndex <= 0) return html\n\n  const headPrefix = html.slice(0, doctypeIndex)\n  if (!isHeadPrefix(headPrefix)) return html\n\n  const documentHtml = html.slice(doctypeIndex)\n  const headOpen = documentHtml.match(/<head(?:\\s[^>]*)?>/)\n  if (!headOpen || headOpen.index === undefined) return html\n\n  const insertAt = headOpen.index + headOpen[0].length\n  return documentHtml.slice(0, insertAt) + headPrefix + documentHtml.slice(insertAt)\n}\n\nfunction isHeadPrefix(value: string): boolean {\n  if (!value) return false\n  return stripLeadingHeadTags(value).trim() === ''\n}\n\nfunction stripLeadingHeadTags(value: string): string {\n  let rest = value\n  let changed = true\n  while (changed) {\n    changed = false\n    const next = rest.replace(\n      /^\\s*(?:<meta\\b[^>]*>|<link\\b[^>]*>|<base\\b[^>]*>|<title\\b[^>]*>[\\s\\S]*?<\\/title>|<style\\b[^>]*>[\\s\\S]*?<\\/style>|<script\\b[^>]*>[\\s\\S]*?<\\/script>)/i,\n      '',\n    )\n    if (next !== rest) {\n      rest = next\n      changed = true\n    }\n  }\n  return rest\n}\n\nfunction bootstrapTag(\n  entry: string | { src: string; async?: boolean; nonce?: string },\n  kind: 'script' | 'module',\n  defaultNonce: string | undefined,\n): string {\n  const src = typeof entry === 'string' ? entry : entry.src\n  const nonce = typeof entry === 'string' ? defaultNonce : entry.nonce ?? defaultNonce\n  const nAttr = nonce ? ` nonce=\"${nonce}\"` : ''\n  if (kind === 'module') return `<script type=\"module\"${nAttr} src=\"${src}\"></script>`\n  return `<script async${nAttr} src=\"${src}\"></script>`\n}\n\n// ---------------------------------------------------------------------------\n// Web Streams: renderToReadableStream\n// ---------------------------------------------------------------------------\n\nexport function renderToReadableStream(\n  children: ReactNode,\n  options: StreamOptions = {},\n): Promise<ReadableStreamResult> {\n  const state: OrchestratorState = {\n    nextId: 0,\n    pending: new Set(),\n    closed: false,\n    errored: null,\n  }\n  const encoder = new TextEncoder()\n\n  let allReadyResolve!: () => void\n  let allReadyReject!: (e: unknown) => void\n  const allReady = new Promise<void>((r, rej) => {\n    allReadyResolve = r\n    allReadyReject = rej\n  })\n\n  const stream = new ReadableStream<Uint8Array>({\n    start(controller) {\n      const emit = (chunk: string) => {\n        try {\n          controller.enqueue(encoder.encode(chunk))\n        } catch {}\n      }\n\n      streamHtml(children, emit, options, state).then(\n        () => {\n          try {\n            controller.close()\n          } catch {}\n          allReadyResolve()\n        },\n        (err) => {\n          try {\n            controller.error(err)\n          } catch {}\n          allReadyReject(err)\n        },\n      )\n\n      options.signal?.addEventListener('abort', () => {\n        state.closed = true\n        try {\n          controller.close()\n        } catch {}\n      })\n    },\n  })\n\n  return Promise.resolve(Object.assign(stream, { allReady }))\n}\n\n// ---------------------------------------------------------------------------\n// Node Streams: renderToPipeableStream\n// ---------------------------------------------------------------------------\n\nexport interface PipeableHandle {\n  pipe<T extends PipeableWritable>(dest: T): T\n  abort(reason?: unknown): void\n}\n\nexport interface PipeableOptions extends StreamOptions {\n  onShellReady?: () => void\n  onShellError?: (err: unknown) => void\n  onAllReady?: () => void\n}\n\nexport function renderToPipeableStream(\n  children: ReactNode,\n  options: PipeableOptions = {},\n): PipeableHandle {\n  const state: OrchestratorState = {\n    nextId: 0,\n    pending: new Set(),\n    closed: false,\n    errored: null,\n  }\n\n  const buffers: string[] = []\n  let dest: PipeableWritable | null = null\n  let shellReady = false\n  let finished = false\n  let aborted = false\n\n  const flushTo = (w: PipeableWritable) => {\n    if (!buffers.length) return\n    for (const b of buffers) w.write(b)\n    buffers.length = 0\n  }\n\n  const emit: Emit = (chunk) => {\n    if (aborted || finished) return\n    if (dest) dest.write(chunk)\n    else buffers.push(chunk)\n  }\n\n  // Kick off rendering\n  streamHtml(children, emit, options, state).then(\n    () => {\n      finished = true\n      if (dest) dest.end()\n      options.onAllReady?.()\n    },\n    (err) => {\n      if (!shellReady) {\n        options.onShellError?.(err)\n      } else {\n        options.onError?.(err)\n        if (dest) dest.end()\n      }\n    },\n  )\n\n  // We call onShellReady once the first synchronous emit has landed.\n  // streamHtml above runs the shell synchronously before the first await in drain(),\n  // so we can schedule onShellReady right after the first microtask.\n  queueMicrotask(() => {\n    if (aborted || finished) return\n    shellReady = true\n    options.onShellReady?.()\n  })\n\n  return {\n    pipe<T extends PipeableWritable>(target: T): T {\n      dest = target\n      flushTo(target)\n      if (finished) target.end()\n      return target\n    },\n    abort(_reason?: unknown) {\n      aborted = true\n      state.closed = true\n      if (dest) dest.end()\n    },\n  }\n}\n"],
-  "mappings": ";AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,YAAoC;AAC7C,SAAS,yBAAyB,oBAAoB;AACtD,SAAS,oBAAoB;AA+B7B,eAAsB,WACpB,UACA,MACA,SACA,OACe;AACf,uBAAqB;AACrB,WAAS,QAAQ,gBAAgB;AACjC,QAAM,QAAQ,QAAQ;AAEtB,MAAI;AACF,UAAM,aAAkC,CAAC;AASzC,UAAM,cAAwB,CAAC;AAC/B,UAAM,eAAqB,CAAC,UAAU;AACpC,kBAAY,KAAK,KAAK;AAAA,IACxB;AAMA,QAAI,gBAAgB;AACpB,QAAI,cAAc;AAClB,WAAO,CAAC,eAAe;AACrB,YAAM,aAAa,YAAY;AAC/B,YAAM,gBAAgB,WAAW;AACjC,YAAM,SAAS,MAAM;AACrB,UAAI;AACF,aAAK,UAAU;AAAA,UACb,MAAM;AAAA,UACN,WAAW,CAAC,MAAM,WAAW,KAAK,CAAC;AAAA,UACnC,gBAAgB,MAAM,MAAM;AAAA,QAC9B,CAAC;AACD,wBAAgB;AAAA,MAClB,SAAS,KAAK;AACZ,oBAAY,SAAS;AACrB,mBAAW,SAAS;AACpB,cAAM,SAAS;AACf,YAAI,CAAC,WAAW,GAAG,EAAG,OAAM;AAC5B,YAAI,EAAE,cAAc,IAAI;AACtB,gBAAM,IAAI,MAAM,6DAA6D;AAAA,QAC/E;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAQA,UAAM,eACJ,8BAA8B,QAAQ,sBAAsB,EAAE,SAAS,MACtE,QAAQ,kBAAkB,UAAU,KAAK,MACzC,QAAQ,kBAAkB,UAAU,KAAK;AAC5C,QAAI,WAAW,SAAS,KAAK,cAAc;AACzC,kBAAY,KAAK,UAAU,QAAQ,WAAW,KAAK,MAAM,EAAE,IAAI,uBAAuB,YAAW;AACjG,iBAAW,WAAW,8BAA8B,QAAQ,sBAAsB,GAAG;AACnF,oBAAY,KAAK,mBAAmB,SAAS,KAAK,CAAC;AAAA,MACrD;AACA,iBAAW,KAAK,QAAQ,oBAAoB,CAAC,GAAG;AAC9C,oBAAY,KAAK,aAAa,GAAG,UAAU,KAAK,CAAC;AAAA,MACnD;AACA,iBAAW,KAAK,QAAQ,oBAAoB,CAAC,GAAG;AAC9C,oBAAY,KAAK,aAAa,GAAG,UAAU,KAAK,CAAC;AAAA,MACnD;AAAA,IACF;AAEA,QAAI,YAAY,OAAQ,MAAK,uBAAuB,YAAY,KAAK,EAAE,CAAC,CAAC;AAGzE,eAAW,KAAK,WAAY,gBAAe,GAAG,MAAM,SAAS,KAAK;AAClE,UAAM,MAAM,KAAK;AAAA,EACnB,SAAS,KAAK;AACZ,UAAM,UAAU;AAChB,QAAI,QAAQ,QAAS,SAAQ,QAAQ,GAAG;AACxC,UAAM;AAAA,EACR,UAAE;AACA,WAAO;AACP,2BAAuB;AACvB,UAAM,SAAS;AAAA,EACjB;AACF;AAEA,SAAS,eACP,GACA,MACA,SACA,OACM;AACN,QAAM,QAAQ,YAAY;AACxB,QAAI;AACF,YAAM,EAAE;AAAA,IACV,SAAS,KAAK;AACZ,UAAI,QAAQ,QAAS,SAAQ,QAAQ,GAAG;AAAA,IAC1C;AACA,QAAI,MAAM,OAAQ;AAIlB,UAAM,QAAkB,CAAC;AACzB,UAAM,MAA2B,CAAC;AAClC,UAAM,UAAU,qBAAqB,EAAE,eAAe;AACtD,QAAI;AACF,WAAK,EAAE,UAAU;AAAA,QACf,MAAM,CAAC,MAAM,MAAM,KAAK,CAAC;AAAA,QACzB,WAAW,CAAC,MAAM,IAAI,KAAK,CAAC;AAAA,QAC5B,gBAAgB,MAAM,MAAM;AAAA,MAC9B,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,UAAI,QAAQ,QAAS,SAAQ,QAAQ,GAAG;AACxC,cAAQ;AACR;AAAA,IACF;AACA,YAAQ;AAER,SAAK,qBAAqB,EAAE,EAAE,KAAK,MAAM,KAAK,EAAE,CAAC,SAAS,aAAa,EAAE,IAAI,QAAQ,KAAK,CAAC,EAAE;AAG7F,eAAW,KAAK,IAAK,gBAAe,GAAG,MAAM,SAAS,KAAK;AAAA,EAC7D,GAAG;AACH,QAAM,QAAQ,IAAI,IAAI;AACtB,OAAK,QAAQ,MAAM,MAAM,QAAQ,OAAO,IAAI,CAAC;AAC/C;AAEA,eAAe,MAAM,OAAyC;AAC5D,SAAO,MAAM,QAAQ,OAAO,GAAG;AAC7B,UAAM,QAAQ,KAAK,MAAM,OAAO;AAAA,EAClC;AACF;AAEA,SAAS,WAAW,OAA2C;AAC7D,SAAO,CAAC,CAAC,SAAS,OAAQ,MAA6B,SAAS;AAClE;AAEA,SAAS,8BACP,SACU;AACV,MAAI,YAAY,OAAW,QAAO,CAAC;AACnC,SAAO,OAAO,YAAY,WAAW,CAAC,OAAO,IAAI,CAAC,GAAG,OAAO;AAC9D;AAEA,SAAS,mBAAmB,SAAiB,cAA0C;AACrF,QAAM,QAAQ,eAAe,WAAW,YAAY,MAAM;AAC1D,SAAO,UAAU,KAAK,IAAI,aAAa,OAAO,CAAC;AACjD;AAEA,SAAS,uBAAuB,MAAsB;AACpD,QAAM,eAAe,KAAK,QAAQ,sBAAsB;AACxD,MAAI,gBAAgB,EAAG,QAAO;AAE9B,QAAM,aAAa,KAAK,MAAM,GAAG,YAAY;AAC7C,MAAI,CAAC,aAAa,UAAU,EAAG,QAAO;AAEtC,QAAM,eAAe,KAAK,MAAM,YAAY;AAC5C,QAAM,WAAW,aAAa,MAAM,oBAAoB;AACxD,MAAI,CAAC,YAAY,SAAS,UAAU,OAAW,QAAO;AAEtD,QAAM,WAAW,SAAS,QAAQ,SAAS,CAAC,EAAE;AAC9C,SAAO,aAAa,MAAM,GAAG,QAAQ,IAAI,aAAa,aAAa,MAAM,QAAQ;AACnF;AAEA,SAAS,aAAa,OAAwB;AAC5C,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,qBAAqB,KAAK,EAAE,KAAK,MAAM;AAChD;AAEA,SAAS,qBAAqB,OAAuB;AACnD,MAAI,OAAO;AACX,MAAI,UAAU;AACd,SAAO,SAAS;AACd,cAAU;AACV,UAAM,OAAO,KAAK;AAAA,MAChB;AAAA,MACA;AAAA,IACF;AACA,QAAI,SAAS,MAAM;AACjB,aAAO;AACP,gBAAU;AAAA,IACZ;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,aACP,OACA,MACA,cACQ;AACR,QAAM,MAAM,OAAO,UAAU,WAAW,QAAQ,MAAM;AACtD,QAAM,QAAQ,OAAO,UAAU,WAAW,eAAe,MAAM,SAAS;AACxE,QAAM,QAAQ,QAAQ,WAAW,KAAK,MAAM;AAC5C,MAAI,SAAS,SAAU,QAAO,wBAAwB,KAAK,SAAS,GAAG;AACvE,SAAO,gBAAgB,KAAK,SAAS,GAAG;AAC1C;AAMO,SAAS,uBACd,UACA,UAAyB,CAAC,GACK;AAC/B,QAAM,QAA2B;AAAA,IAC/B,QAAQ;AAAA,IACR,SAAS,oBAAI,IAAI;AAAA,IACjB,QAAQ;AAAA,IACR,SAAS;AAAA,EACX;AACA,QAAM,UAAU,IAAI,YAAY;AAEhC,MAAI;AACJ,MAAI;AACJ,QAAM,WAAW,IAAI,QAAc,CAAC,GAAG,QAAQ;AAC7C,sBAAkB;AAClB,qBAAiB;AAAA,EACnB,CAAC;AAED,QAAM,SAAS,IAAI,eAA2B;AAAA,IAC5C,MAAM,YAAY;AAChB,YAAM,OAAO,CAAC,UAAkB;AAC9B,YAAI;AACF,qBAAW,QAAQ,QAAQ,OAAO,KAAK,CAAC;AAAA,QAC1C,QAAQ;AAAA,QAAC;AAAA,MACX;AAEA,iBAAW,UAAU,MAAM,SAAS,KAAK,EAAE;AAAA,QACzC,MAAM;AACJ,cAAI;AACF,uBAAW,MAAM;AAAA,UACnB,QAAQ;AAAA,UAAC;AACT,0BAAgB;AAAA,QAClB;AAAA,QACA,CAAC,QAAQ;AACP,cAAI;AACF,uBAAW,MAAM,GAAG;AAAA,UACtB,QAAQ;AAAA,UAAC;AACT,yBAAe,GAAG;AAAA,QACpB;AAAA,MACF;AAEA,cAAQ,QAAQ,iBAAiB,SAAS,MAAM;AAC9C,cAAM,SAAS;AACf,YAAI;AACF,qBAAW,MAAM;AAAA,QACnB,QAAQ;AAAA,QAAC;AAAA,MACX,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,SAAO,QAAQ,QAAQ,OAAO,OAAO,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC5D;AAiBO,SAAS,uBACd,UACA,UAA2B,CAAC,GACZ;AAChB,QAAM,QAA2B;AAAA,IAC/B,QAAQ;AAAA,IACR,SAAS,oBAAI,IAAI;AAAA,IACjB,QAAQ;AAAA,IACR,SAAS;AAAA,EACX;AAEA,QAAM,UAAoB,CAAC;AAC3B,MAAI,OAAgC;AACpC,MAAI,aAAa;AACjB,MAAI,WAAW;AACf,MAAI,UAAU;AAEd,QAAM,UAAU,CAAC,MAAwB;AACvC,QAAI,CAAC,QAAQ,OAAQ;AACrB,eAAW,KAAK,QAAS,GAAE,MAAM,CAAC;AAClC,YAAQ,SAAS;AAAA,EACnB;AAEA,QAAM,OAAa,CAAC,UAAU;AAC5B,QAAI,WAAW,SAAU;AACzB,QAAI,KAAM,MAAK,MAAM,KAAK;AAAA,QACrB,SAAQ,KAAK,KAAK;AAAA,EACzB;AAGA,aAAW,UAAU,MAAM,SAAS,KAAK,EAAE;AAAA,IACzC,MAAM;AACJ,iBAAW;AACX,UAAI,KAAM,MAAK,IAAI;AACnB,cAAQ,aAAa;AAAA,IACvB;AAAA,IACA,CAAC,QAAQ;AACP,UAAI,CAAC,YAAY;AACf,gBAAQ,eAAe,GAAG;AAAA,MAC5B,OAAO;AACL,gBAAQ,UAAU,GAAG;AACrB,YAAI,KAAM,MAAK,IAAI;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AAKA,iBAAe,MAAM;AACnB,QAAI,WAAW,SAAU;AACzB,iBAAa;AACb,YAAQ,eAAe;AAAA,EACzB,CAAC;AAED,SAAO;AAAA,IACL,KAAiC,QAAc;AAC7C,aAAO;AACP,cAAQ,MAAM;AACd,UAAI,SAAU,QAAO,IAAI;AACzB,aAAO;AAAA,IACT;AAAA,IACA,MAAM,SAAmB;AACvB,gBAAU;AACV,YAAM,SAAS;AACf,UAAI,KAAM,MAAK,IAAI;AAAA,IACrB;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { ReactNode } from '../core'\nimport {\n  beginSSR,\n  endSSR,\n  applyContextSnapshot,\n  currentSSRFrame,\n  type SSRFrame,\n} from './dispatcher'\nimport { walk, type SuspendedBoundary, type BrowserBailoutCallback } from './walk'\nimport { browserError, isBrowserToken, isBrowserError } from '../core/browser'\nimport { BOUNDARY_REVEAL_RUNTIME, revealScript } from './bootstrap-script'\nimport { escapeAttr, escapeScript } from './escape'\nimport { resourceURL } from '../core/resource-hints'\nimport type { ResourceScope } from './resource-hints'\n\nexport interface StreamOptions {\n  identifierPrefix?: string\n  nonce?: string | { script?: string; style?: string }\n  bootstrapScriptContent?: string | ReadonlyArray<string>\n  bootstrapScripts?: ReadonlyArray<string | { src: string; async?: boolean; nonce?: string }>\n  bootstrapModules?: ReadonlyArray<string | { src: string; nonce?: string }>\n  onError?: (error: unknown) => string | void\n  onBrowserBailout?: BrowserBailoutCallback\n  signal?: AbortSignal\n  progressiveChunkSize?: number\n}\n\nexport interface ReadableStreamResult extends ReadableStream<Uint8Array> {\n  allReady: Promise<void>\n}\n\nexport interface PipeableWritable {\n  write(chunk: string): unknown\n  end(): unknown\n  destroy?(error?: unknown): unknown\n}\n\nexport interface OrchestratorState {\n  nextId: number\n  pending: Set<Promise<void>>\n  closed: boolean\n  errored: unknown | null\n  aborted: boolean\n  reason: unknown\n  abort: (reason?: unknown) => void\n  cancelled: Promise<void>\n  onShellReady?: () => void\n  frame?: SSRFrame\n}\n\nfunction createState(): OrchestratorState {\n  let wake!: () => void\n  const state: OrchestratorState = {\n    nextId: 0, pending: new Set(), closed: false, errored: null,\n    aborted: false, reason: undefined,\n    cancelled: new Promise<void>((resolve) => { wake = resolve }),\n    abort(reason) {\n      if (state.closed || state.aborted) return\n      state.aborted = true\n      state.reason = isBrowserToken(reason) ? browserError(reason) : reason ?? new Error('The render was aborted by the server without a reason.')\n      wake()\n    },\n  }\n  return state\n}\n\ntype Emit = (chunk: string) => void\n\nexport async function streamHtml(\n  children: ReactNode,\n  emit: Emit,\n  options: StreamOptions,\n  state: OrchestratorState,\n): Promise<void> {\n  const nonce = scriptNonce(options)\n\n  try {\n    const boundaries: SuspendedBoundary[] = []\n\n    // Buffer shell + bootstrap into a string[] and flush as a single emit.\n    // Per-emit overhead in renderToReadableStream is TextEncoder.encode +\n    // controller.enqueue \u2014 each walkHost normally fires 3+ emits (opening\n    // tag, per-attribute, closing bracket), which for a ~30-component tree\n    // is ~100 stream-controller round-trips. Batching collapses those into\n    // one encode and one enqueue per shell \u2014 measured ~2-4% of total SSR\n    // time on CPU profiles.\n    const shellChunks: string[] = []\n    let head = 0\n    const bufferedEmit: Emit = (chunk) => {\n      shellChunks.push(chunk)\n    }\n\n    // 1. Render the shell. A root-level `use(promise)` has no Suspense\n    // boundary to capture it, but App Router SSR commonly suspends at this\n    // level while resolving the RSC stream. Wait and retry without leaking\n    // partial shell chunks or boundary ids from the aborted attempt.\n    let shellRendered = false\n    let rootRetries = 0\n    let resources: SSRFrame['resources']\n    while (!shellRendered) {\n      const chunkCount = shellChunks.length\n      const boundaryCount = boundaries.length\n      const nextId = state.nextId\n      head = 0\n      const previous = beginSSR(options.identifierPrefix)\n      currentSSRFrame().styleNonce = typeof options.nonce === 'object' ? options.nonce?.style : undefined\n      if (resources) currentSSRFrame().resources = resources\n      let suspended: Promise<unknown> | undefined\n      try {\n        if (state.aborted) throw state.reason\n        walk(children, {\n          emit: bufferedEmit,\n          onSuspend: (b) => boundaries.push(b),\n          nextBoundaryId: () => state.nextId++,\n          onBrowserBailout: options.onBrowserBailout,\n          onHead: () => { head = shellChunks.length },\n        })\n        shellRendered = true\n        state.frame = currentSSRFrame()\n      } catch (err) {\n        shellChunks.length = chunkCount\n        boundaries.length = boundaryCount\n        state.nextId = nextId\n        if (!isThenable(err)) throw err\n        if (++rootRetries > 50) {\n          throw new Error('renderToReadableStream exceeded 50 root suspension retries.')\n        }\n        suspended = err\n      } finally {\n        resources = currentSSRFrame().resources\n        endSSR(previous)\n      }\n      if (suspended) await Promise.race([suspended, state.cancelled])\n    }\n\n    const hints = state.frame?.resources?.drain()\n    if (hints) shellChunks.splice(head, 0, hints)\n    if (state.frame) state.frame.shellFlushed = true\n\n    // 2. Inject runtime + bootstrap scripts (once, after shell). Skip the\n    // reveal/event-replay runtime when nothing needs it \u2014 no suspensions to\n    // reveal and no bootstrap scripts to guard against early user input. That\n    // keeps fully-static SSR responses byte-equivalent to a plain walk and\n    // matches React's behavior where `renderToReadableStream` of a static\n    // tree emits only the markup.\n    const hasBootstrap =\n      bootstrapScriptContentToArray(options.bootstrapScriptContent).length > 0 ||\n      (options.bootstrapScripts?.length ?? 0) > 0 ||\n      (options.bootstrapModules?.length ?? 0) > 0\n    if (boundaries.length > 0 || hasBootstrap) {\n      shellChunks.push(`<script${nonce ? ` nonce=\"${escapeAttr(nonce)}\"` : ''}>${BOUNDARY_REVEAL_RUNTIME}</script>`)\n      for (const content of bootstrapScriptContentToArray(options.bootstrapScriptContent)) {\n        shellChunks.push(inlineBootstrapTag(content, nonce))\n      }\n      for (const s of options.bootstrapScripts ?? []) {\n        shellChunks.push(bootstrapTag(s, 'script', nonce))\n      }\n      for (const m of options.bootstrapModules ?? []) {\n        shellChunks.push(bootstrapTag(m, 'module', nonce))\n      }\n    }\n\n    if (shellChunks.length) emit(normalizeDocumentShell(shellChunks.join('')))\n    state.onShellReady?.()\n\n    // 3. Stream suspended boundaries as they resolve\n    for (const b of boundaries) streamBoundary(b, emit, options, state)\n    await drain(state)\n  } catch (err) {\n    if (isBrowserError(err)) {\n      err = new Error('The server render could not complete because client rendering was requested outside a Suspense boundary.',\n        Object.hasOwn(err, 'cause') ? { cause: err.cause } : undefined)\n    }\n    state.errored = err\n    if (options.onError) options.onError(err)\n    throw err\n  } finally {\n    state.closed = true\n  }\n}\n\nfunction streamBoundary(\n  b: SuspendedBoundary,\n  emit: Emit,\n  options: StreamOptions,\n  state: OrchestratorState,\n): void {\n  const nonce = scriptNonce(options)\n  const task = (async () => {\n    try {\n      await Promise.race([b.thenable, state.cancelled])\n    } catch {}\n    if (state.closed) return\n\n    const defer = (error: unknown) => {\n      if (isBrowserError(error)) options.onBrowserBailout?.(error, { componentStack: (error as any).componentStack || b.componentStack })\n      else options.onError?.(error)\n      emit(`<script${nonce ? ` nonce=\"${escapeAttr(nonce)}\"` : ''}>$RB(${b.id}${isBrowserError(error) ? '' : ',1'})</script>`)\n    }\n    if (state.aborted) { defer(state.reason); return }\n\n    // Re-render the boundary's children into a string, restoring the\n    // provider stack from when the boundary first suspended.\n    const parts: string[] = []\n    const sub: SuspendedBoundary[] = []\n    const resourceScope: ResourceScope = {}\n    let styles: string[][] | undefined\n    const previous = beginSSR(options.identifierPrefix, state.frame)\n    state.frame?.resources?.takeStylesheets()\n    const restore = applyContextSnapshot(b.contextSnapshot)\n    try {\n      walk(b.children, {\n        emit: (s) => parts.push(s),\n        onSuspend: (n) => sub.push(n),\n        nextBoundaryId: () => state.nextId++,\n        onBrowserBailout: options.onBrowserBailout,\n        componentStack: b.componentStack,\n        resourceScope,\n      })\n      state.frame?.resources?.mergeScope(resourceScope)\n    } catch (err) {\n      if (isThenable(err)) {\n        streamBoundary({ ...b, thenable: err }, emit, options, state)\n      } else defer(err)\n      return\n    } finally {\n      restore()\n      endSSR(previous)\n      const hints = state.frame?.resources?.drain()\n      styles = state.frame?.resources?.takeStylesheets()\n      if (hints) emit(hints)\n    }\n\n    emit(`<div hidden id=\"S:${b.id}\">${parts.join('')}</div>${revealScript(b.id, nonce, styles)}`)\n\n    // Recurse: any nested suspensions inside the now-revealed content\n    for (const s of sub) streamBoundary(s, emit, options, state)\n  })()\n  state.pending.add(task)\n  task.then(() => state.pending.delete(task), () => state.pending.delete(task))\n}\n\nasync function drain(state: OrchestratorState): Promise<void> {\n  while (state.pending.size > 0) {\n    await Promise.race(state.pending)\n  }\n}\n\nfunction isThenable(value: unknown): value is Promise<unknown> {\n  return !!value && typeof (value as { then?: unknown }).then === 'function'\n}\n\nfunction scriptNonce(options: StreamOptions): string | undefined {\n  return typeof options.nonce === 'string' ? options.nonce : options.nonce?.script\n}\n\nfunction bootstrapScriptContentToArray(\n  content: StreamOptions['bootstrapScriptContent'],\n): string[] {\n  if (content === undefined) return []\n  return typeof content === 'string' ? [content] : [...content]\n}\n\nfunction inlineBootstrapTag(content: string, defaultNonce: string | undefined): string {\n  const nAttr = defaultNonce ? ` nonce=\"${escapeAttr(defaultNonce)}\"` : ''\n  return `<script${nAttr}>${escapeScript(content)}</script>`\n}\n\nfunction normalizeDocumentShell(html: string): string {\n  const doctypeIndex = html.indexOf('<!DOCTYPE html><html')\n  if (doctypeIndex <= 0) return html\n\n  const headPrefix = html.slice(0, doctypeIndex)\n  if (!isHeadPrefix(headPrefix)) return html\n\n  const documentHtml = html.slice(doctypeIndex)\n  const headOpen = documentHtml.match(/<head(?:\\s[^>]*)?>/)\n  if (!headOpen || headOpen.index === undefined) return html\n\n  const insertAt = headOpen.index + headOpen[0].length\n  return documentHtml.slice(0, insertAt) + headPrefix + documentHtml.slice(insertAt)\n}\n\nfunction isHeadPrefix(value: string): boolean {\n  if (!value) return false\n  return stripLeadingHeadTags(value).trim() === ''\n}\n\nfunction stripLeadingHeadTags(value: string): string {\n  let rest = value\n  let changed = true\n  while (changed) {\n    changed = false\n    const next = rest.replace(\n      /^\\s*(?:<meta\\b[^>]*>|<link\\b[^>]*>|<base\\b[^>]*>|<title\\b[^>]*>[\\s\\S]*?<\\/title>|<style\\b[^>]*>[\\s\\S]*?<\\/style>|<script\\b[^>]*>[\\s\\S]*?<\\/script>)/i,\n      '',\n    )\n    if (next !== rest) {\n      rest = next\n      changed = true\n    }\n  }\n  return rest\n}\n\nfunction bootstrapTag(\n  entry: string | { src: string; async?: boolean; nonce?: string },\n  kind: 'script' | 'module',\n  defaultNonce: string | undefined,\n): string {\n  const src = escapeAttr(resourceURL(typeof entry === 'string' ? entry : entry.src))\n  const nonce = typeof entry === 'string' ? defaultNonce : entry.nonce ?? defaultNonce\n  const nAttr = nonce ? ` nonce=\"${escapeAttr(nonce)}\"` : ''\n  if (kind === 'module') return `<script type=\"module\"${nAttr} src=\"${src}\"></script>`\n  return `<script async${nAttr} src=\"${src}\"></script>`\n}\n\n// ---------------------------------------------------------------------------\n// Web Streams: renderToReadableStream\n// ---------------------------------------------------------------------------\n\nexport function renderToReadableStream(\n  children: ReactNode,\n  options: StreamOptions = {},\n): Promise<ReadableStreamResult> {\n  const state = createState()\n  const encoder = new TextEncoder()\n  let abortListener: (() => void) | undefined\n  const detachAbortListener = () => {\n    if (abortListener) {\n      options.signal?.removeEventListener('abort', abortListener)\n      abortListener = undefined\n    }\n  }\n\n  let allReadyResolve!: () => void\n  let allReadyReject!: (e: unknown) => void\n  const allReady = new Promise<void>((r, rej) => {\n    allReadyResolve = r\n    allReadyReject = rej\n  })\n  // Shell failures reject the outer promise before callers receive allReady.\n  allReady.catch(() => {})\n  let shellResolve!: (stream: ReadableStreamResult) => void\n  let shellReject!: (error: unknown) => void\n  const shell = new Promise<ReadableStreamResult>((resolve, reject) => {\n    shellResolve = resolve\n    shellReject = reject\n  })\n  state.onShellReady = () => queueMicrotask(() => shellResolve(Object.assign(stream, { allReady })))\n\n  const stream = new ReadableStream<Uint8Array>({\n    start(controller) {\n      const emit = (chunk: string) => {\n        try {\n          controller.enqueue(encoder.encode(chunk))\n        } catch {}\n      }\n\n      if (options.signal) {\n        abortListener = () => {\n          detachAbortListener()\n          state.abort(options.signal!.reason)\n        }\n        options.signal.addEventListener('abort', abortListener)\n        if (options.signal.aborted) abortListener()\n      }\n\n      streamHtml(children, emit, options, state).then(\n        () => {\n          detachAbortListener()\n          try {\n            controller.close()\n          } catch {}\n          allReadyResolve()\n        },\n        (err) => {\n          detachAbortListener()\n          try {\n            controller.error(err)\n          } catch {}\n          allReadyReject(err)\n          shellReject(err)\n        },\n      )\n\n    },\n    cancel(reason) {\n      state.abort(reason)\n      detachAbortListener()\n    },\n  })\n\n  return shell\n}\n\n// ---------------------------------------------------------------------------\n// Node Streams: renderToPipeableStream\n// ---------------------------------------------------------------------------\n\nexport interface PipeableHandle {\n  pipe<T extends PipeableWritable>(dest: T): T\n  abort(reason?: unknown): void\n}\n\nexport interface PipeableOptions extends StreamOptions {\n  onShellReady?: () => void\n  onShellError?: (err: unknown) => void\n  onAllReady?: () => void\n}\n\nexport function renderToPipeableStream(\n  children: ReactNode,\n  options: PipeableOptions = {},\n): PipeableHandle {\n  const state = createState()\n\n  const buffers: string[] = []\n  let dest: PipeableWritable | null = null\n  let shellReady = false\n  let shellFailed = false\n  let finished = false\n  let failed = false\n  let failure: unknown\n\n  const finishDestination = (target: PipeableWritable) => {\n    if (failed && target.destroy) target.destroy(failure)\n    else target.end()\n  }\n\n  const flushTo = (w: PipeableWritable) => {\n    if (!buffers.length) return\n    for (const b of buffers) w.write(b)\n    buffers.length = 0\n  }\n\n  const emit: Emit = (chunk) => {\n    if (finished) return\n    if (dest) dest.write(chunk)\n    else buffers.push(chunk)\n  }\n\n  state.onShellReady = () => queueMicrotask(() => {\n    if (shellFailed) return\n    shellReady = true\n    options.onShellReady?.()\n  })\n\n  // Kick off rendering\n  streamHtml(children, emit, options, state).then(\n    () => {\n      finished = true\n      if (dest) dest.end()\n      options.onAllReady?.()\n    },\n    (err) => {\n      finished = true\n      failed = true\n      failure = err\n      if (!shellReady) {\n        shellFailed = true\n        options.onShellError?.(err)\n      } else {\n        if (dest) finishDestination(dest)\n      }\n    },\n  )\n\n  return {\n    pipe<T extends PipeableWritable>(target: T): T {\n      dest = target\n      if (!failed) flushTo(target)\n      if (finished) finishDestination(target)\n      return target\n    },\n    abort(reason?: unknown) {\n      state.abort(reason)\n    },\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/server/walk.d.ts

@@ -1,19 +1,32 @@
-import { type ReactNode } from '../core';
-import { type ContextSnapshot } from './dispatcher';
+import { type ReactNode } from "../core/index.js";
+import { type ContextSnapshot } from "./dispatcher.js";
+import type { ResourceScope } from "./resource-hints.js";
+export interface ServerErrorInfo {
+    componentStack: string;
+}
+export type BrowserBailoutCallback = (error: Error, errorInfo: ServerErrorInfo) => void;
 export interface SuspendedBoundary {
     id: number;
     fallbackHTML: string;
     children: ReactNode;
     thenable: Promise<any>;
     contextSnapshot: ContextSnapshot;
+    componentStack: string;
 }
 export interface WalkOptions {
     emit: (chunk: string) => void;
+    onHead?: () => void;
     onSuspend?: ((boundary: SuspendedBoundary) => void) | undefined;
+    onBrowserBailout?: BrowserBailoutCallback | undefined;
+    componentStack?: string | undefined;
+    thrownInfo?: {
+        componentStack?: string | undefined;
+    };
     nextBoundaryId: () => number;
     bootstrapped?: boolean | undefined;
     isBoundaryResolution?: boolean | undefined;
     isSvg?: boolean | undefined;
+    resourceScope?: ResourceScope | undefined;
     /**
      * Tracks whether the most recent emission within the *current text flow*
      * ended with a text node. When the next emission is also text, we emit a