@rshono/core 1.0.0-rc.11 → 1.0.0-rc.13

package/dist/runtime/entry.ssr.js

@@ -4,27 +4,21 @@ import { renderToReadableStream } from 'react-dom/server';
 import { createFromReadableStream } from 'react-server-dom-rspack/client';
 import { isControlDigest } from './control.js';
 import { injectFlightPayload } from './flight-inject.js';
-// From the baked config, not `process.env.NODE_ENV`: this is a property of the build, and a deploy
-// target need not have a `process` at all.
+// The baked config, not `process.env.NODE_ENV`: a deploy target need not have a `process`.
 const isDev = __RSHONO_CONFIG__.isDev;
 /** Escapes text going into HTML body content — a stack trace is untrusted input. */
 function escapeHtml(text) {
     return text.replace(/[&<>]/g, (char) => (char === '&' ? '&amp;' : char === '<' ? '&lt;' : '&gt;'));
 }
 /**
- * The last-resort 500 document, for when SSR fails before a single byte of the real shell was sent.
+ * The last-resort 500 document, for when SSR fails before a byte of the real shell was sent.
  *
- * Deliberately plain HTML with no client runtime attached: the flight payload comes from the same
- * failed render, so hydrating it would mismatch and React — whose root container is the whole
- * `document` — would tear the page down, blanking the very message being rendered here. Styling is
- * inline because the page's stylesheet links were part of the render that just failed.
+ * Plain HTML with no client runtime and no stylesheet links: both came from the render that just failed,
+ * and hydrating a mismatched payload would tear the page down over this very message. A string rather than
+ * a component for the same reason — React is what failed. It must end with the document trailer, which
+ * `injectFlightPayload` holds back and re-emits.
  *
- * A string rather than a component, for the same reason: React is what just failed, and rendering
- * this through it again is a dependency the fallback does not need. It must end with the document
- * trailer, which is what `injectFlightPayload` holds back and re-emits.
- *
- * The detail is dev-only. In production this stays a generic message, matching how the `error` page
- * from routes.ts redacts.
+ * The detail is dev-only, matching how the app's `error` page redacts.
  */
 function failureDocument(error) {
     const detail = isDev ? (error instanceof Error ? (error.stack ?? `${error.name}: ${error.message}`) : String(error)) : null;
@@ -59,13 +53,10 @@ export async function renderHTML(rscStream, options) {
         payload ??= createFromReadableStream(rscForSsr, options.nonce ? { nonce: options.nonce } : undefined);
         return React.use(payload).root;
     }
-    // React hands `onError` every error it meets while streaming, including ones an error boundary
-    // contained — and with no handler installed it logs each one itself. Almost all of them are errors
-    // it read out of the flight payload, where they arrive as React's redacted stand-in: a `digest`
-    // and no message. The RSC layer has already reported the real one in full, so the default handler
-    // prints an alarming, detail-free duplicate for a request a boundary handled perfectly well. Only
-    // an error carrying no digest started life in this render — a client component that threw during
-    // SSR — and that one nothing else will report.
+    // React hands `onError` every error it meets while streaming, contained ones included. Almost all arrive
+    // out of the flight payload as its redacted stand-in — a `digest` and no message — and the RSC layer has
+    // already reported those in full. Only an error carrying no digest started life in this render, and that
+    // one nothing else will report.
     let reported;
     const onError = (error) => {
         if (typeof error?.digest === 'string')
@@ -83,16 +74,14 @@ export async function renderHTML(rscStream, options) {
             formState: options.formState,
             signal: options.signal,
             nonce: options.nonce,
-            // Deliberately returns nothing, so the digest React gives the client's `onRecoverableError`
-            // stays exactly what it was before a handler was installed here.
+            // Returns nothing, so the digest React gives the client's `onRecoverableError` is unchanged.
             onError,
         });
     }
     catch (error) {
         if (isControlDigest(error?.digest))
             throw error;
-        // `onError` runs first for the failure that aborts the shell, so this reports only what it let
-        // through: an error out of the flight payload, whose detail the RSC layer alone has.
+        // `onError` runs first for the failure that aborts the shell, so this reports only what it let through.
         if (!options.signal?.aborted && error !== reported)
             options.onShellError?.(error);
         status = 500;

package/dist/runtime/entry.ssr.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.ssr.js","sourceRoot":"","sources":["../../src/runtime/entry.ssr.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\nimport type { ReactFormState } from 'react-dom/client';\nimport { renderToReadableStream } from 'react-dom/server';\nimport { createFromReadableStream } from 'react-server-dom-rspack/client';\nimport { isControlDigest } from './control.js';\nimport { injectFlightPayload } from './flight-inject.js';\nimport type { RscPayload } from './entry.rsc.js';\n\nexport interface RenderHTMLOptions {\n  bootstrapScripts?: string[];\n  formState?: ReactFormState;\n  signal?: AbortSignal;\n  nonce?: string;\n  /**\n   * Called when SSR fails before the shell is sent. Reporting is the RSC layer's job — this module\n   * is compiled into the SSR layer, which gets its own instance of every module it imports, so a\n   * handler registered through `@rshono/core/server` isn't reachable from in here.\n   */\n  onShellError?: (error: unknown) => void;\n  /**\n   * Called for an error that happened during SSR and *originated* in SSR — a client component that\n   * threw while rendering on the server, whether a boundary went on to contain it or it took the\n   * shell down with it. See {@link renderHTML} for why the ones that didn't originate here are\n   * dropped instead.\n   */\n  onError?: (error: unknown) => void;\n  /**\n   * Called once the response stream has ended, however it ended.\n   *\n   * The RSC layer uses it to detach the listener forwarding client-disconnect aborts into this render —\n   * see `renderComponent`. Without a hook here that listener outlives the request and retains the whole\n   * rendered tree, so this is load-bearing rather than a convenience.\n   */\n  onDone?: () => void;\n}\n\n// From the baked config, not `process.env.NODE_ENV`: this is a property of the build, and a deploy\n// target need not have a `process` at all.\nconst isDev = __RSHONO_CONFIG__.isDev;\n\n/** Escapes text going into HTML body content — a stack trace is untrusted input. */\nfunction escapeHtml(text: string): string {\n  return text.replace(/[&<>]/g, (char) => (char === '&' ? '&amp;' : char === '<' ? '&lt;' : '&gt;'));\n}\n\n/**\n * The last-resort 500 document, for when SSR fails before a single byte of the real shell was sent.\n *\n * Deliberately plain HTML with no client runtime attached: the flight payload comes from the same\n * failed render, so hydrating it would mismatch and React — whose root container is the whole\n * `document` — would tear the page down, blanking the very message being rendered here. Styling is\n * inline because the page's stylesheet links were part of the render that just failed.\n *\n * A string rather than a component, for the same reason: React is what just failed, and rendering\n * this through it again is a dependency the fallback does not need. It must end with the document\n * trailer, which is what `injectFlightPayload` holds back and re-emits.\n *\n * The detail is dev-only. In production this stays a generic message, matching how the `error` page\n * from routes.ts redacts.\n */\nfunction failureDocument(error: unknown): ReadableStream<Uint8Array> {\n  const detail = isDev ? (error instanceof Error ? (error.stack ?? `${error.name}: ${error.message}`) : String(error)) : null;\n  const html =\n    '<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"utf-8\">' +\n    '<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">' +\n    '<title>500 — Internal Server Error</title></head>' +\n    '<body style=\"margin:0;padding:2rem;font:16px/1.6 system-ui,-apple-system,sans-serif;color:#18181b\">' +\n    '<h1 style=\"margin:0 0 .5rem;font-size:1.25rem\">500 — Internal Server Error</h1>' +\n    '<p style=\"margin:0 0 1.5rem;color:#52525b\">' +\n    (isDev\n      ? 'Server-side rendering failed before the page shell could be sent, so the app’s error page could not be reached either.'\n      : 'Something went wrong while rendering this page. Please try again.') +\n    '</p>' +\n    (detail\n      ? '<pre style=\"margin:0;padding:1rem;overflow:auto;background:#f4f4f5;border-left:3px solid #ef4444;' +\n        `font:13px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;white-space:pre-wrap;word-break:break-word\">${escapeHtml(detail)}</pre>`\n      : '') +\n    '</body></html>';\n  const bytes = new TextEncoder().encode(html);\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.enqueue(bytes);\n      controller.close();\n    },\n  });\n}\n\nexport async function renderHTML(rscStream: ReadableStream<Uint8Array>, options: RenderHTMLOptions) {\n  // One copy is rendered to HTML here; the other rides along in that HTML for the client to hydrate from.\n  const [rscForSsr, rscForClient] = rscStream.tee();\n\n  let payload: Promise<RscPayload>;\n  function SsrRoot() {\n    payload ??= createFromReadableStream<RscPayload>(rscForSsr, options.nonce ? { nonce: options.nonce } : undefined);\n    return React.use(payload).root;\n  }\n\n  // React hands `onError` every error it meets while streaming, including ones an error boundary\n  // contained — and with no handler installed it logs each one itself. Almost all of them are errors\n  // it read out of the flight payload, where they arrive as React's redacted stand-in: a `digest`\n  // and no message. The RSC layer has already reported the real one in full, so the default handler\n  // prints an alarming, detail-free duplicate for a request a boundary handled perfectly well. Only\n  // an error carrying no digest started life in this render — a client component that threw during\n  // SSR — and that one nothing else will report.\n  let reported: unknown;\n  const onError = (error: unknown): void => {\n    if (typeof (error as { digest?: unknown } | null)?.digest === 'string') return;\n    if (options.signal?.aborted) return; // an abort is the client leaving, not a fault\n    reported = error;\n    options.onError?.(error);\n  };\n\n  let htmlStream: ReadableStream<Uint8Array>;\n  let status: number | undefined;\n  try {\n    htmlStream = await renderToReadableStream(<SsrRoot />, {\n      bootstrapScripts: options.bootstrapScripts,\n      formState: options.formState,\n      signal: options.signal,\n      nonce: options.nonce,\n      // Deliberately returns nothing, so the digest React gives the client's `onRecoverableError`\n      // stays exactly what it was before a handler was installed here.\n      onError,\n    });\n  } catch (error) {\n    if (isControlDigest((error as { digest?: unknown } | null)?.digest)) throw error;\n    // `onError` runs first for the failure that aborts the shell, so this reports only what it let\n    // through: an error out of the flight payload, whose detail the RSC layer alone has.\n    if (!options.signal?.aborted && error !== reported) options.onShellError?.(error);\n    status = 500;\n    htmlStream = failureDocument(error);\n  }\n\n  const responseStream = htmlStream.pipeThrough(injectFlightPayload(rscForClient, { nonce: options.nonce, onDone: options.onDone }));\n\n  return { stream: responseStream, status };\n}\n"]}
+{"version":3,"file":"entry.ssr.js","sourceRoot":"","sources":["../../src/runtime/entry.ssr.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\nimport type { ReactFormState } from 'react-dom/client';\nimport { renderToReadableStream } from 'react-dom/server';\nimport { createFromReadableStream } from 'react-server-dom-rspack/client';\nimport { isControlDigest } from './control.js';\nimport { injectFlightPayload } from './flight-inject.js';\nimport type { RscPayload } from './entry.rsc.js';\n\nexport interface RenderHTMLOptions {\n  bootstrapScripts?: string[];\n  formState?: ReactFormState;\n  signal?: AbortSignal;\n  nonce?: string;\n  /**\n   * Called when SSR fails before the shell is sent. Reporting is the RSC layer's job: this module is\n   * compiled into the SSR layer, which gets its own instance of every module it imports, so a handler\n   * registered through `@rshono/core/server` is not reachable from here.\n   */\n  onShellError?: (error: unknown) => void;\n  /**\n   * Called for an error that *originated* in SSR — a client component that threw while rendering on the\n   * server. See {@link renderHTML} for why the others are dropped.\n   */\n  onError?: (error: unknown) => void;\n  /**\n   * Called once the response stream has ended, however it ended. Load-bearing: the RSC layer uses it to\n   * detach the abort forwarder that would otherwise retain the whole rendered tree.\n   */\n  onDone?: () => void;\n}\n\n// The baked config, not `process.env.NODE_ENV`: a deploy target need not have a `process`.\nconst isDev = __RSHONO_CONFIG__.isDev;\n\n/** Escapes text going into HTML body content — a stack trace is untrusted input. */\nfunction escapeHtml(text: string): string {\n  return text.replace(/[&<>]/g, (char) => (char === '&' ? '&amp;' : char === '<' ? '&lt;' : '&gt;'));\n}\n\n/**\n * The last-resort 500 document, for when SSR fails before a byte of the real shell was sent.\n *\n * Plain HTML with no client runtime and no stylesheet links: both came from the render that just failed,\n * and hydrating a mismatched payload would tear the page down over this very message. A string rather than\n * a component for the same reason — React is what failed. It must end with the document trailer, which\n * `injectFlightPayload` holds back and re-emits.\n *\n * The detail is dev-only, matching how the app's `error` page redacts.\n */\nfunction failureDocument(error: unknown): ReadableStream<Uint8Array> {\n  const detail = isDev ? (error instanceof Error ? (error.stack ?? `${error.name}: ${error.message}`) : String(error)) : null;\n  const html =\n    '<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"utf-8\">' +\n    '<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">' +\n    '<title>500 — Internal Server Error</title></head>' +\n    '<body style=\"margin:0;padding:2rem;font:16px/1.6 system-ui,-apple-system,sans-serif;color:#18181b\">' +\n    '<h1 style=\"margin:0 0 .5rem;font-size:1.25rem\">500 — Internal Server Error</h1>' +\n    '<p style=\"margin:0 0 1.5rem;color:#52525b\">' +\n    (isDev\n      ? 'Server-side rendering failed before the page shell could be sent, so the app’s error page could not be reached either.'\n      : 'Something went wrong while rendering this page. Please try again.') +\n    '</p>' +\n    (detail\n      ? '<pre style=\"margin:0;padding:1rem;overflow:auto;background:#f4f4f5;border-left:3px solid #ef4444;' +\n        `font:13px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;white-space:pre-wrap;word-break:break-word\">${escapeHtml(detail)}</pre>`\n      : '') +\n    '</body></html>';\n  const bytes = new TextEncoder().encode(html);\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.enqueue(bytes);\n      controller.close();\n    },\n  });\n}\n\nexport async function renderHTML(rscStream: ReadableStream<Uint8Array>, options: RenderHTMLOptions) {\n  // One copy is rendered to HTML here; the other rides along in that HTML for the client to hydrate from.\n  const [rscForSsr, rscForClient] = rscStream.tee();\n\n  let payload: Promise<RscPayload>;\n  function SsrRoot() {\n    payload ??= createFromReadableStream<RscPayload>(rscForSsr, options.nonce ? { nonce: options.nonce } : undefined);\n    return React.use(payload).root;\n  }\n\n  // React hands `onError` every error it meets while streaming, contained ones included. Almost all arrive\n  // out of the flight payload as its redacted stand-in — a `digest` and no message — and the RSC layer has\n  // already reported those in full. Only an error carrying no digest started life in this render, and that\n  // one nothing else will report.\n  let reported: unknown;\n  const onError = (error: unknown): void => {\n    if (typeof (error as { digest?: unknown } | null)?.digest === 'string') return;\n    if (options.signal?.aborted) return; // an abort is the client leaving, not a fault\n    reported = error;\n    options.onError?.(error);\n  };\n\n  let htmlStream: ReadableStream<Uint8Array>;\n  let status: number | undefined;\n  try {\n    htmlStream = await renderToReadableStream(<SsrRoot />, {\n      bootstrapScripts: options.bootstrapScripts,\n      formState: options.formState,\n      signal: options.signal,\n      nonce: options.nonce,\n      // Returns nothing, so the digest React gives the client's `onRecoverableError` is unchanged.\n      onError,\n    });\n  } catch (error) {\n    if (isControlDigest((error as { digest?: unknown } | null)?.digest)) throw error;\n    // `onError` runs first for the failure that aborts the shell, so this reports only what it let through.\n    if (!options.signal?.aborted && error !== reported) options.onShellError?.(error);\n    status = 500;\n    htmlStream = failureDocument(error);\n  }\n\n  const responseStream = htmlStream.pipeThrough(injectFlightPayload(rscForClient, { nonce: options.nonce, onDone: options.onDone }));\n\n  return { stream: responseStream, status };\n}\n"]}

package/dist/runtime/flight-inject.d.ts

@@ -1,25 +1,18 @@
 /**
- * Carrying the flight payload inside the HTML document, so the browser hydrates from bytes it
- * already has rather than fetching the page a second time.
+ * Carrying the flight payload inside the HTML document, so the browser hydrates from bytes it already has
+ * rather than fetching the page twice. The reader is `readFlightPayload` in `entry.client.tsx`.
  *
- * The wire format is `rsc-html-stream`'s — a run of
- * `<script>(self.__FLIGHT_DATA||=[]).push("…")</script>` tags — but the implementation is
- * first-party, because that package's `injectRSCPayload` tests each HTML chunk for the document
- * trailer with `endsWith`. React's byte writer packs its output into 2 kB views and splits any write
- * that straddles one, so `</body></html>` can arrive as two chunks; upstream then fails to hold it
- * back, and the document ends up with two trailers and the payload script after the first of them.
- * A page's byte layout is deterministic, so that is not an intermittent fault — an unlucky page is
- * malformed on every request. `test/unit.test.mjs` pins the split-trailer cases.
- *
- * The reader for this format is `readFlightPayload` in `entry.client.tsx`.
+ * The wire format is `rsc-html-stream`'s — a run of `<script>(self.__FLIGHT_DATA||=[]).push("…")</script>`
+ * tags — but the implementation is first-party, because that package tests each HTML chunk for the
+ * document trailer with `endsWith`: React's byte writer splits any write straddling its 2 kB views, so
+ * `</body></html>` can arrive as two chunks and the document ends up with two trailers.
  */
 /**
- * {@link Transformer} plus the `cancel` hook the Streams standard added for a cancelled readable side.
+ * {@link Transformer} plus the `cancel` hook the Streams standard added for a cancelled readable side —
+ * declared here because the bundled lib types have not caught up with what Node calls.
  *
- * Node calls it (verified on 22.x) but the bundled lib types have not caught up, so it is declared
- * here rather than reached for with an `any`. It matters because `cancel` is the only notification
- * that a response ended *without* finishing, and both users of it release a listener that would
- * otherwise outlive the request.
+ * It matters because `cancel` is the only notification that a response ended *without* finishing, and both
+ * users of it release a listener that would otherwise outlive the request.
  */
 export type CancellableTransformer<I, O> = Transformer<I, O> & {
     cancel?: (reason?: unknown) => void;

package/dist/runtime/flight-inject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flight-inject.d.ts","sourceRoot":"","sources":["../../src/runtime/flight-inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,CAAC;AAwDvG,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CAAO,GACpD,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAwJzC"}
+{"version":3,"file":"flight-inject.d.ts","sourceRoot":"","sources":["../../src/runtime/flight-inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,CAAC;AAkDvG,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CAAO,GACpD,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAiJzC"}

package/dist/runtime/flight-inject.js

@@ -1,17 +1,11 @@
 /**
- * Carrying the flight payload inside the HTML document, so the browser hydrates from bytes it
- * already has rather than fetching the page a second time.
+ * Carrying the flight payload inside the HTML document, so the browser hydrates from bytes it already has
+ * rather than fetching the page twice. The reader is `readFlightPayload` in `entry.client.tsx`.
  *
- * The wire format is `rsc-html-stream`'s — a run of
- * `<script>(self.__FLIGHT_DATA||=[]).push("…")</script>` tags — but the implementation is
- * first-party, because that package's `injectRSCPayload` tests each HTML chunk for the document
- * trailer with `endsWith`. React's byte writer packs its output into 2 kB views and splits any write
- * that straddles one, so `</body></html>` can arrive as two chunks; upstream then fails to hold it
- * back, and the document ends up with two trailers and the payload script after the first of them.
- * A page's byte layout is deterministic, so that is not an intermittent fault — an unlucky page is
- * malformed on every request. `test/unit.test.mjs` pins the split-trailer cases.
- *
- * The reader for this format is `readFlightPayload` in `entry.client.tsx`.
+ * The wire format is `rsc-html-stream`'s — a run of `<script>(self.__FLIGHT_DATA||=[]).push("…")</script>`
+ * tags — but the implementation is first-party, because that package tests each HTML chunk for the
+ * document trailer with `endsWith`: React's byte writer splits any write straddling its 2 kB views, so
+ * `</body></html>` can arrive as two chunks and the document ends up with two trailers.
  */
 const encoder = new TextEncoder();
 /** What React closes an `<html>` document with, and what this module re-emits after the last payload script. */
@@ -26,21 +20,16 @@ const unschedule = (handle) => {
         clearTimeout(handle);
 };
 /**
- * Escapes the two sequences that would end a `<script>` element early.
- *
- * Guarded by an `includes('<')` because a flight payload usually has no `<` in it at all, and the
- * scan is far cheaper than two regex passes over 30 kB. `</script` becomes `</\script` rather than
- * `<\/script`, which would break the valid JS `0</script/` (a regexp literal).
+ * Escapes the two sequences that would end a `<script>` element early. Guarded by `includes('<')`, which is
+ * far cheaper than two regex passes over 30 kB of payload that usually has no `<` in it. `</script` becomes
+ * `</\script`, not `<\/script`, which would break the valid JS `0</script/`.
  */
 function escapeScript(script) {
     return script.includes('<') ? script.replace(/<!--/g, '<\\!--').replace(/<\/(script)/gi, '</\\$1') : script;
 }
 /**
- * The bytes of `chunk` as a latin1 string, which is the form `btoa` takes.
- *
- * Sliced rather than `String.fromCharCode(...chunk)`, which passes one argument per byte and
- * overflows the call stack on a chunk of any size. The slice width is a stack-safety choice, not a
- * tuned one — this is only reached for a chunk that split a multi-byte character.
+ * The bytes of `chunk` as a latin1 string, which is the form `btoa` takes. Sliced because
+ * `String.fromCharCode(...chunk)` passes one argument per byte and overflows the stack.
  */
 function latin1(chunk) {
     let out = '';
@@ -68,13 +57,11 @@ export function injectFlightPayload(rscStream, options = {}) {
     const batch = [];
     let boundary = null;
     /**
-     * Set once the consumer has gone away, so nothing downstream tries to enqueue into a readable that
-     * can no longer take it.
+     * Set once the consumer has gone away, so nothing tries to enqueue into a readable that cannot take it.
      *
-     * It cannot simply be the `cancel` hook that sets this. Per the Streams standard, cancelling the
-     * readable *after* the close algorithm has started returns the pending finish promise without
-     * running the transformer's `cancel` at all — and `flush` awaiting the whole flight payload is
-     * precisely that window. So a failed enqueue is also treated as the signal, wherever one happens.
+     * The `cancel` hook alone cannot set this: per the Streams standard, cancelling the readable after the
+     * close algorithm has started skips the transformer's `cancel` entirely — and `flush` awaiting the whole
+     * payload is precisely that window. So a failed enqueue counts as the signal too.
      */
     let cancelled = false;
     /** Held so {@link cancelled} can release the teed RSC branch rather than leaving it to be pumped. */
@@ -83,10 +70,9 @@ export function injectFlightPayload(rscStream, options = {}) {
      * Emits the HTML buffered since the last boundary, holding back the document trailer for
      * {@link TransformStream.flush} to re-emit after the payload scripts.
      *
-     * The batch is joined before the trailer is looked for, so a trailer React split across two views
-     * is still found — that is the whole reason this module is not `rsc-html-stream/server`. React
-     * writes its final flush in one synchronous run, so every chunk of the trailer lands in the same
-     * batch; a trailer split *across* batches is not a shape React produces.
+     * The batch is joined before the trailer is looked for, so one React split across two views is still
+     * found. React writes its final flush in one synchronous run, so a trailer split across *batches* is not
+     * a shape it produces.
      */
     function emitBatch(controller) {
         boundary = null;
@@ -110,8 +96,8 @@ export function injectFlightPayload(rscStream, options = {}) {
     }
     async function writeFlight(controller) {
         const reader = (flightReader = rscStream.getReader());
-        // `fatal`, so a chunk that split a multi-byte character throws rather than emitting U+FFFD and
-        // corrupting the payload — the catch below falls back to a byte-exact encoding for it.
+        // `fatal`, so a chunk that split a multi-byte character throws instead of emitting U+FFFD; the catch
+        // below falls back to a byte-exact encoding for it.
         const decoder = new TextDecoder('utf-8', { fatal: true });
         const push = (literal) => controller.enqueue(encoder.encode(scriptOpen + literal + scriptClose));
         for (;;) {
@@ -120,9 +106,8 @@ export function injectFlightPayload(rscStream, options = {}) {
             const { done, value } = await reader.read();
             if (done)
                 break;
-            // Only the *decode* is guarded. Wrapping the `push` in the same `try` conflated a split
-            // multi-byte character with a controller nobody is reading any more, and answered the second by
-            // re-encoding the chunk and enqueueing it again — which throws in turn, out of the catch.
+            // Only the decode is guarded: a `push` inside the same `try` would answer a dead controller by
+            // re-encoding the chunk and enqueueing it again.
             let literal;
             try {
                 literal = escapeScript(JSON.stringify(decoder.decode(value, { stream: true })));
@@ -132,8 +117,8 @@ export function injectFlightPayload(rscStream, options = {}) {
             }
             if (cancelled)
                 return;
-            // A failed enqueue means the consumer is gone. Stop pumping and release the RSC branch, so
-            // `flush` unparks now rather than whenever the flight payload would have ended on its own.
+            // A failed enqueue means the consumer is gone: release the RSC branch so `flush` unparks now rather
+            // than whenever the payload would have ended on its own.
             try {
                 push(literal);
             }
@@ -154,10 +139,8 @@ export function injectFlightPayload(rscStream, options = {}) {
             batch.push(chunk);
             if (boundary)
                 return;
-            // A macrotask, not a microtask: React writes a whole flush into its stream in one synchronous
-            // run, but `pipeThrough` delivers those chunks to us one microtask at a time. Only a task
-            // boundary guarantees the flush has arrived in full — a script injected between two of its
-            // chunks would land inside a tag.
+            // A macrotask, not a microtask: React writes a whole flush in one synchronous run but `pipeThrough`
+            // delivers it one microtask at a time, and a script injected between two chunks lands inside a tag.
             boundary = schedule(() => {
                 try {
                     emitBatch(controller);
@@ -169,7 +152,9 @@ export function injectFlightPayload(rscStream, options = {}) {
                 }
                 if (!startedFlight) {
                     startedFlight = true;
-                    writeFlight(controller)
+                    // Deliberately not awaited: this runs inside a scheduled callback with nothing to return to, and
+                    // the chain already routes a write failure to `controller.error` before settling `flightDone`.
+                    void writeFlight(controller)
                         .catch((error) => controller.error(error))
                         .then(flightDone);
                 }
@@ -177,11 +162,9 @@ export function injectFlightPayload(rscStream, options = {}) {
         },
         async flush(controller) {
             await flightWritten;
-            // That await spans the entire flight payload, and the consumer can go away inside it — a
-            // browser's stop button, a navigation away, a proxy timeout. `cancel` below is *not* what tells
-            // us so (see `cancelled`), which leaves the enqueue throwing `ERR_INVALID_STATE` as the only
-            // signal. Unguarded it rejects `flush`, and nothing owns that rejection: it surfaces as an
-            // unhandled one and, where the host does not swallow it, takes the process down.
+            // That await spans the whole payload, and the consumer can go away inside it — with `cancel` skipped
+            // (see `cancelled`), a throwing enqueue is the only signal. Unguarded it rejects `flush`, which
+            // nothing owns and which surfaces as an unhandled rejection.
             try {
                 if (boundary) {
                     unschedule(boundary);
@@ -196,8 +179,7 @@ export function injectFlightPayload(rscStream, options = {}) {
                 flightReader?.cancel().catch(() => { });
             }
             finally {
-                // Unconditional, and the reason this is a `finally`: `onDone` is what releases the abort
-                // forwarder in `renderComponent`, so it has to run however the response ended.
+                // A `finally` because `onDone` releases the abort forwarder in `renderComponent`, however this ended.
                 onDone?.();
             }
         },
@@ -208,8 +190,8 @@ export function injectFlightPayload(rscStream, options = {}) {
                 boundary = null;
             }
             batch.length = 0;
-            // Without this the teed RSC branch keeps being pumped for a response nobody will read, and the
-            // tee's other half buffers every chunk waiting for this one to catch up.
+            // Otherwise the teed RSC branch keeps being pumped for a response nobody will read, and the tee's
+            // other half buffers every chunk waiting for this one to catch up.
             flightReader?.cancel(reason).catch(() => { });
             // Unparks `flush` if it is waiting on a payload that will now never arrive.
             flightDone();

package/dist/runtime/flight-inject.js.map

@@ -1 +1 @@
-{"version":3,"file":"flight-inject.js","sourceRoot":"","sources":["../../src/runtime/flight-inject.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Carrying the flight payload inside the HTML document, so the browser hydrates from bytes it\n * already has rather than fetching the page a second time.\n *\n * The wire format is `rsc-html-stream`'s — a run of\n * `<script>(self.__FLIGHT_DATA||=[]).push(\"…\")</script>` tags — but the implementation is\n * first-party, because that package's `injectRSCPayload` tests each HTML chunk for the document\n * trailer with `endsWith`. React's byte writer packs its output into 2 kB views and splits any write\n * that straddles one, so `</body></html>` can arrive as two chunks; upstream then fails to hold it\n * back, and the document ends up with two trailers and the payload script after the first of them.\n * A page's byte layout is deterministic, so that is not an intermittent fault — an unlucky page is\n * malformed on every request. `test/unit.test.mjs` pins the split-trailer cases.\n *\n * The reader for this format is `readFlightPayload` in `entry.client.tsx`.\n */\n\n/**\n * {@link Transformer} plus the `cancel` hook the Streams standard added for a cancelled readable side.\n *\n * Node calls it (verified on 22.x) but the bundled lib types have not caught up, so it is declared\n * here rather than reached for with an `any`. It matters because `cancel` is the only notification\n * that a response ended *without* finishing, and both users of it release a listener that would\n * otherwise outlive the request.\n */\nexport type CancellableTransformer<I, O> = Transformer<I, O> & { cancel?: (reason?: unknown) => void };\n\nconst encoder = new TextEncoder();\n\n/** What React closes an `<html>` document with, and what this module re-emits after the last payload script. */\nconst TRAILER = '</body></html>';\nconst TRAILER_BYTES = encoder.encode(TRAILER);\n\n/**\n * A macrotask boundary. `setImmediate` where there is one (Node, Bun, Deno's node compat), which is\n * the current turn's check phase rather than a timer; `setTimeout` is the portable fallback that\n * every other runtime has. A Node timer has a 1ms floor and every HTML flush would pay it — worth\n * the two lines: uncontended time-to-last-byte on a 30 kB payload, 4.7ms → 3.0ms.\n */\ntype TaskHandle = ReturnType<typeof setTimeout> | ReturnType<typeof setImmediate>;\nconst hasSetImmediate = typeof setImmediate === 'function';\nconst schedule: (fn: () => void) => TaskHandle = hasSetImmediate ? setImmediate : (fn) => setTimeout(fn, 0);\nconst unschedule = (handle: TaskHandle): void => {\n  if (hasSetImmediate) clearImmediate(handle as ReturnType<typeof setImmediate>);\n  else clearTimeout(handle as ReturnType<typeof setTimeout>);\n};\n\n/**\n * Escapes the two sequences that would end a `<script>` element early.\n *\n * Guarded by an `includes('<')` because a flight payload usually has no `<` in it at all, and the\n * scan is far cheaper than two regex passes over 30 kB. `</script` becomes `</\\script` rather than\n * `<\\/script`, which would break the valid JS `0</script/` (a regexp literal).\n */\nfunction escapeScript(script: string): string {\n  return script.includes('<') ? script.replace(/<!--/g, '<\\\\!--').replace(/<\\/(script)/gi, '</\\\\$1') : script;\n}\n\n/**\n * The bytes of `chunk` as a latin1 string, which is the form `btoa` takes.\n *\n * Sliced rather than `String.fromCharCode(...chunk)`, which passes one argument per byte and\n * overflows the call stack on a chunk of any size. The slice width is a stack-safety choice, not a\n * tuned one — this is only reached for a chunk that split a multi-byte character.\n */\nfunction latin1(chunk: Uint8Array): string {\n  let out = '';\n  for (let at = 0; at < chunk.length; at += 8192) out += String.fromCharCode(...chunk.subarray(at, at + 8192));\n  return out;\n}\n\n/** Whether `buffer`'s first `length` bytes end with the document trailer. */\nfunction endsWithTrailer(buffer: Uint8Array, length: number): boolean {\n  if (length < TRAILER_BYTES.length) return false;\n  const from = length - TRAILER_BYTES.length;\n  for (let i = 0; i < TRAILER_BYTES.length; i++) {\n    if (buffer[from + i] !== TRAILER_BYTES[i]) return false;\n  }\n  return true;\n}\n\nexport function injectFlightPayload(\n  rscStream: ReadableStream<Uint8Array>,\n  options: { nonce?: string; onDone?: () => void } = {},\n): TransformStream<Uint8Array, Uint8Array> {\n  const { nonce, onDone } = options;\n  const scriptOpen = `<script${nonce ? ` nonce=\"${nonce}\"` : ''}>(self.__FLIGHT_DATA||=[]).push(`;\n  const scriptClose = ')</script>';\n\n  const { promise: flightWritten, resolve: flightDone } = Promise.withResolvers<void>();\n  let startedFlight = false;\n\n  const batch: Uint8Array[] = [];\n  let boundary: TaskHandle | null = null;\n\n  /**\n   * Set once the consumer has gone away, so nothing downstream tries to enqueue into a readable that\n   * can no longer take it.\n   *\n   * It cannot simply be the `cancel` hook that sets this. Per the Streams standard, cancelling the\n   * readable *after* the close algorithm has started returns the pending finish promise without\n   * running the transformer's `cancel` at all — and `flush` awaiting the whole flight payload is\n   * precisely that window. So a failed enqueue is also treated as the signal, wherever one happens.\n   */\n  let cancelled = false;\n  /** Held so {@link cancelled} can release the teed RSC branch rather than leaving it to be pumped. */\n  let flightReader: ReadableStreamDefaultReader<Uint8Array> | null = null;\n\n  /**\n   * Emits the HTML buffered since the last boundary, holding back the document trailer for\n   * {@link TransformStream.flush} to re-emit after the payload scripts.\n   *\n   * The batch is joined before the trailer is looked for, so a trailer React split across two views\n   * is still found — that is the whole reason this module is not `rsc-html-stream/server`. React\n   * writes its final flush in one synchronous run, so every chunk of the trailer lands in the same\n   * batch; a trailer split *across* batches is not a shape React produces.\n   */\n  function emitBatch(controller: TransformStreamDefaultController<Uint8Array>): void {\n    boundary = null;\n    let total = 0;\n    for (const chunk of batch) total += chunk.byteLength;\n    if (total === 0) {\n      batch.length = 0;\n      return;\n    }\n\n    const joined = new Uint8Array(total);\n    let at = 0;\n    for (const chunk of batch) {\n      joined.set(chunk, at);\n      at += chunk.byteLength;\n    }\n    batch.length = 0;\n\n    const end = endsWithTrailer(joined, total) ? total - TRAILER_BYTES.length : total;\n    if (end > 0) controller.enqueue(joined.subarray(0, end));\n  }\n\n  async function writeFlight(controller: TransformStreamDefaultController<Uint8Array>): Promise<void> {\n    const reader = (flightReader = rscStream.getReader());\n    // `fatal`, so a chunk that split a multi-byte character throws rather than emitting U+FFFD and\n    // corrupting the payload — the catch below falls back to a byte-exact encoding for it.\n    const decoder = new TextDecoder('utf-8', { fatal: true });\n    const push = (literal: string) => controller.enqueue(encoder.encode(scriptOpen + literal + scriptClose));\n    for (;;) {\n      if (cancelled) return;\n      const { done, value } = await reader.read();\n      if (done) break;\n      // Only the *decode* is guarded. Wrapping the `push` in the same `try` conflated a split\n      // multi-byte character with a controller nobody is reading any more, and answered the second by\n      // re-encoding the chunk and enqueueing it again — which throws in turn, out of the catch.\n      let literal: string;\n      try {\n        literal = escapeScript(JSON.stringify(decoder.decode(value, { stream: true })));\n      } catch {\n        literal = `Uint8Array.from(atob(${JSON.stringify(btoa(latin1(value)))}), m => m.codePointAt(0))`;\n      }\n      if (cancelled) return;\n      // A failed enqueue means the consumer is gone. Stop pumping and release the RSC branch, so\n      // `flush` unparks now rather than whenever the flight payload would have ended on its own.\n      try {\n        push(literal);\n      } catch {\n        cancelled = true;\n        reader.cancel().catch(() => {});\n        return;\n      }\n    }\n    if (cancelled) return;\n    const remaining = decoder.decode();\n    if (remaining.length) push(escapeScript(JSON.stringify(remaining)));\n  }\n\n  const transformer: CancellableTransformer<Uint8Array, Uint8Array> = {\n    transform(chunk, controller) {\n      batch.push(chunk);\n      if (boundary) return;\n      // A macrotask, not a microtask: React writes a whole flush into its stream in one synchronous\n      // run, but `pipeThrough` delivers those chunks to us one microtask at a time. Only a task\n      // boundary guarantees the flush has arrived in full — a script injected between two of its\n      // chunks would land inside a tag.\n      boundary = schedule(() => {\n        try {\n          emitBatch(controller);\n        } catch (error) {\n          controller.error(error);\n          flightDone();\n          return;\n        }\n        if (!startedFlight) {\n          startedFlight = true;\n          writeFlight(controller)\n            .catch((error) => controller.error(error))\n            .then(flightDone);\n        }\n      });\n    },\n    async flush(controller) {\n      await flightWritten;\n      // That await spans the entire flight payload, and the consumer can go away inside it — a\n      // browser's stop button, a navigation away, a proxy timeout. `cancel` below is *not* what tells\n      // us so (see `cancelled`), which leaves the enqueue throwing `ERR_INVALID_STATE` as the only\n      // signal. Unguarded it rejects `flush`, and nothing owns that rejection: it surfaces as an\n      // unhandled one and, where the host does not swallow it, takes the process down.\n      try {\n        if (boundary) {\n          unschedule(boundary);\n          emitBatch(controller);\n        }\n        if (!cancelled) controller.enqueue(encoder.encode(TRAILER));\n      } catch {\n        // Nowhere left to put the trailer. A response the client abandoned is not a fault.\n        cancelled = true;\n        flightReader?.cancel().catch(() => {});\n      } finally {\n        // Unconditional, and the reason this is a `finally`: `onDone` is what releases the abort\n        // forwarder in `renderComponent`, so it has to run however the response ended.\n        onDone?.();\n      }\n    },\n    cancel(reason) {\n      cancelled = true;\n      if (boundary) {\n        unschedule(boundary);\n        boundary = null;\n      }\n      batch.length = 0;\n      // Without this the teed RSC branch keeps being pumped for a response nobody will read, and the\n      // tee's other half buffers every chunk waiting for this one to catch up.\n      flightReader?.cancel(reason).catch(() => {});\n      // Unparks `flush` if it is waiting on a payload that will now never arrive.\n      flightDone();\n      onDone?.();\n    },\n  };\n  return new TransformStream<Uint8Array, Uint8Array>(transformer);\n}\n"]}
+{"version":3,"file":"flight-inject.js","sourceRoot":"","sources":["../../src/runtime/flight-inject.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Carrying the flight payload inside the HTML document, so the browser hydrates from bytes it already has\n * rather than fetching the page twice. The reader is `readFlightPayload` in `entry.client.tsx`.\n *\n * The wire format is `rsc-html-stream`'s — a run of `<script>(self.__FLIGHT_DATA||=[]).push(\"…\")</script>`\n * tags — but the implementation is first-party, because that package tests each HTML chunk for the\n * document trailer with `endsWith`: React's byte writer splits any write straddling its 2 kB views, so\n * `</body></html>` can arrive as two chunks and the document ends up with two trailers.\n */\n\n/**\n * {@link Transformer} plus the `cancel` hook the Streams standard added for a cancelled readable side —\n * declared here because the bundled lib types have not caught up with what Node calls.\n *\n * It matters because `cancel` is the only notification that a response ended *without* finishing, and both\n * users of it release a listener that would otherwise outlive the request.\n */\nexport type CancellableTransformer<I, O> = Transformer<I, O> & { cancel?: (reason?: unknown) => void };\n\nconst encoder = new TextEncoder();\n\n/** What React closes an `<html>` document with, and what this module re-emits after the last payload script. */\nconst TRAILER = '</body></html>';\nconst TRAILER_BYTES = encoder.encode(TRAILER);\n\n/**\n * A macrotask boundary: `setImmediate` where there is one, which is the current turn's check phase rather\n * than a timer, and `setTimeout` as the portable fallback. A Node timer has a 1ms floor that every HTML\n * flush would pay — 4.7ms → 3.0ms time-to-last-byte on a 30 kB payload.\n */\ntype TaskHandle = ReturnType<typeof setTimeout> | ReturnType<typeof setImmediate>;\nconst hasSetImmediate = typeof setImmediate === 'function';\nconst schedule: (fn: () => void) => TaskHandle = hasSetImmediate ? setImmediate : (fn) => setTimeout(fn, 0);\nconst unschedule = (handle: TaskHandle): void => {\n  if (hasSetImmediate) clearImmediate(handle as ReturnType<typeof setImmediate>);\n  else clearTimeout(handle as ReturnType<typeof setTimeout>);\n};\n\n/**\n * Escapes the two sequences that would end a `<script>` element early. Guarded by `includes('<')`, which is\n * far cheaper than two regex passes over 30 kB of payload that usually has no `<` in it. `</script` becomes\n * `</\\script`, not `<\\/script`, which would break the valid JS `0</script/`.\n */\nfunction escapeScript(script: string): string {\n  return script.includes('<') ? script.replace(/<!--/g, '<\\\\!--').replace(/<\\/(script)/gi, '</\\\\$1') : script;\n}\n\n/**\n * The bytes of `chunk` as a latin1 string, which is the form `btoa` takes. Sliced because\n * `String.fromCharCode(...chunk)` passes one argument per byte and overflows the stack.\n */\nfunction latin1(chunk: Uint8Array): string {\n  let out = '';\n  for (let at = 0; at < chunk.length; at += 8192) out += String.fromCharCode(...chunk.subarray(at, at + 8192));\n  return out;\n}\n\n/** Whether `buffer`'s first `length` bytes end with the document trailer. */\nfunction endsWithTrailer(buffer: Uint8Array, length: number): boolean {\n  if (length < TRAILER_BYTES.length) return false;\n  const from = length - TRAILER_BYTES.length;\n  for (let i = 0; i < TRAILER_BYTES.length; i++) {\n    if (buffer[from + i] !== TRAILER_BYTES[i]) return false;\n  }\n  return true;\n}\n\nexport function injectFlightPayload(\n  rscStream: ReadableStream<Uint8Array>,\n  options: { nonce?: string; onDone?: () => void } = {},\n): TransformStream<Uint8Array, Uint8Array> {\n  const { nonce, onDone } = options;\n  const scriptOpen = `<script${nonce ? ` nonce=\"${nonce}\"` : ''}>(self.__FLIGHT_DATA||=[]).push(`;\n  const scriptClose = ')</script>';\n\n  const { promise: flightWritten, resolve: flightDone } = Promise.withResolvers<void>();\n  let startedFlight = false;\n\n  const batch: Uint8Array[] = [];\n  let boundary: TaskHandle | null = null;\n\n  /**\n   * Set once the consumer has gone away, so nothing tries to enqueue into a readable that cannot take it.\n   *\n   * The `cancel` hook alone cannot set this: per the Streams standard, cancelling the readable after the\n   * close algorithm has started skips the transformer's `cancel` entirely — and `flush` awaiting the whole\n   * payload is precisely that window. So a failed enqueue counts as the signal too.\n   */\n  let cancelled = false;\n  /** Held so {@link cancelled} can release the teed RSC branch rather than leaving it to be pumped. */\n  let flightReader: ReadableStreamDefaultReader<Uint8Array> | null = null;\n\n  /**\n   * Emits the HTML buffered since the last boundary, holding back the document trailer for\n   * {@link TransformStream.flush} to re-emit after the payload scripts.\n   *\n   * The batch is joined before the trailer is looked for, so one React split across two views is still\n   * found. React writes its final flush in one synchronous run, so a trailer split across *batches* is not\n   * a shape it produces.\n   */\n  function emitBatch(controller: TransformStreamDefaultController<Uint8Array>): void {\n    boundary = null;\n    let total = 0;\n    for (const chunk of batch) total += chunk.byteLength;\n    if (total === 0) {\n      batch.length = 0;\n      return;\n    }\n\n    const joined = new Uint8Array(total);\n    let at = 0;\n    for (const chunk of batch) {\n      joined.set(chunk, at);\n      at += chunk.byteLength;\n    }\n    batch.length = 0;\n\n    const end = endsWithTrailer(joined, total) ? total - TRAILER_BYTES.length : total;\n    if (end > 0) controller.enqueue(joined.subarray(0, end));\n  }\n\n  async function writeFlight(controller: TransformStreamDefaultController<Uint8Array>): Promise<void> {\n    const reader = (flightReader = rscStream.getReader());\n    // `fatal`, so a chunk that split a multi-byte character throws instead of emitting U+FFFD; the catch\n    // below falls back to a byte-exact encoding for it.\n    const decoder = new TextDecoder('utf-8', { fatal: true });\n    const push = (literal: string) => controller.enqueue(encoder.encode(scriptOpen + literal + scriptClose));\n    for (;;) {\n      if (cancelled) return;\n      const { done, value } = await reader.read();\n      if (done) break;\n      // Only the decode is guarded: a `push` inside the same `try` would answer a dead controller by\n      // re-encoding the chunk and enqueueing it again.\n      let literal: string;\n      try {\n        literal = escapeScript(JSON.stringify(decoder.decode(value, { stream: true })));\n      } catch {\n        literal = `Uint8Array.from(atob(${JSON.stringify(btoa(latin1(value)))}), m => m.codePointAt(0))`;\n      }\n      if (cancelled) return;\n      // A failed enqueue means the consumer is gone: release the RSC branch so `flush` unparks now rather\n      // than whenever the payload would have ended on its own.\n      try {\n        push(literal);\n      } catch {\n        cancelled = true;\n        reader.cancel().catch(() => {});\n        return;\n      }\n    }\n    if (cancelled) return;\n    const remaining = decoder.decode();\n    if (remaining.length) push(escapeScript(JSON.stringify(remaining)));\n  }\n\n  const transformer: CancellableTransformer<Uint8Array, Uint8Array> = {\n    transform(chunk, controller) {\n      batch.push(chunk);\n      if (boundary) return;\n      // A macrotask, not a microtask: React writes a whole flush in one synchronous run but `pipeThrough`\n      // delivers it one microtask at a time, and a script injected between two chunks lands inside a tag.\n      boundary = schedule(() => {\n        try {\n          emitBatch(controller);\n        } catch (error) {\n          controller.error(error);\n          flightDone();\n          return;\n        }\n        if (!startedFlight) {\n          startedFlight = true;\n          // Deliberately not awaited: this runs inside a scheduled callback with nothing to return to, and\n          // the chain already routes a write failure to `controller.error` before settling `flightDone`.\n          void writeFlight(controller)\n            .catch((error) => controller.error(error))\n            .then(flightDone);\n        }\n      });\n    },\n    async flush(controller) {\n      await flightWritten;\n      // That await spans the whole payload, and the consumer can go away inside it — with `cancel` skipped\n      // (see `cancelled`), a throwing enqueue is the only signal. Unguarded it rejects `flush`, which\n      // nothing owns and which surfaces as an unhandled rejection.\n      try {\n        if (boundary) {\n          unschedule(boundary);\n          emitBatch(controller);\n        }\n        if (!cancelled) controller.enqueue(encoder.encode(TRAILER));\n      } catch {\n        // Nowhere left to put the trailer. A response the client abandoned is not a fault.\n        cancelled = true;\n        flightReader?.cancel().catch(() => {});\n      } finally {\n        // A `finally` because `onDone` releases the abort forwarder in `renderComponent`, however this ended.\n        onDone?.();\n      }\n    },\n    cancel(reason) {\n      cancelled = true;\n      if (boundary) {\n        unschedule(boundary);\n        boundary = null;\n      }\n      batch.length = 0;\n      // Otherwise the teed RSC branch keeps being pumped for a response nobody will read, and the tee's\n      // other half buffers every chunk waiting for this one to catch up.\n      flightReader?.cancel(reason).catch(() => {});\n      // Unparks `flush` if it is waiting on a payload that will now never arrive.\n      flightDone();\n      onDone?.();\n    },\n  };\n  return new TransformStream<Uint8Array, Uint8Array>(transformer);\n}\n"]}

package/dist/runtime/hot-update.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Walking the page from the build it is running to the build the dev server has announced. Its own module
+ * because every decision in it is about *giving up correctly*, which is worth testing on its own.
+ *
+ * Dev-only: the sole caller sits behind `import.meta.webpackHot`, which a production build replaces with
+ * `false`.
+ */
+/** The slice of `import.meta.webpackHot` the walk uses. */
+export interface HotRuntime {
+    /**
+     * Fetches the update manifest for the build the page is running and, with `autoApply`, applies it.
+     *
+     * Resolves with the updated module ids, or with **null** when the manifest 404s — which the runtime
+     * treats as "nothing to do" rather than an error. Rejects only when an update was found and could not be
+     * applied.
+     */
+    check(autoApply?: boolean): Promise<Array<string | number> | null>;
+    status(): string;
+}
+/** Why the page has to be reloaded rather than patched — `error` only where one was thrown. */
+export interface ReloadReason {
+    reason: string;
+    error?: unknown;
+}
+/**
+ * Advances the page to `targetHash()`, applying one build's worth of updates per round, and reports whether
+ * it got there.
+ *
+ * Both hashes are read through functions because both move underneath this loop: an applied update rewrites
+ * `__webpack_hash__`, and a save landing mid-walk moves the target further out. Reading them fresh each
+ * round is what lets one walk absorb a burst of saves.
+ *
+ * Returns `null` once the page is on the target build, or the reason it cannot get there — every one of
+ * which is a reload, because the alternative is a page that silently stops updating:
+ *
+ * - **An update was already in flight.** `check` may only be called from `idle`.
+ * - **`check` rejected.** An update was found and could not be applied — usually a module that declines
+ *   them, which is the ordinary cost of changing something react-refresh cannot patch.
+ * - **`check` resolved with null, or applied without moving the hash.** The chain of `*.hot-update.json`
+ *   files leading to the target is broken — as it is after a dev-server restart, whose first act is to wipe
+ *   the output directory an already-open tab would ask for. The hash cannot move from there, so retrying
+ *   would re-request the same 404 for as long as the tab stays open.
+ */
+export declare function walkHotUpdates(hot: HotRuntime, currentHash: () => string, targetHash: () => string | undefined): Promise<ReloadReason | null>;
+//# sourceMappingURL=hot-update.d.ts.map

package/dist/runtime/hot-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot-update.d.ts","sourceRoot":"","sources":["../../src/runtime/hot-update.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACnE,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAanJ"}

package/dist/runtime/hot-update.js

@@ -0,0 +1,44 @@
+/**
+ * Walking the page from the build it is running to the build the dev server has announced. Its own module
+ * because every decision in it is about *giving up correctly*, which is worth testing on its own.
+ *
+ * Dev-only: the sole caller sits behind `import.meta.webpackHot`, which a production build replaces with
+ * `false`.
+ */
+/**
+ * Advances the page to `targetHash()`, applying one build's worth of updates per round, and reports whether
+ * it got there.
+ *
+ * Both hashes are read through functions because both move underneath this loop: an applied update rewrites
+ * `__webpack_hash__`, and a save landing mid-walk moves the target further out. Reading them fresh each
+ * round is what lets one walk absorb a burst of saves.
+ *
+ * Returns `null` once the page is on the target build, or the reason it cannot get there — every one of
+ * which is a reload, because the alternative is a page that silently stops updating:
+ *
+ * - **An update was already in flight.** `check` may only be called from `idle`.
+ * - **`check` rejected.** An update was found and could not be applied — usually a module that declines
+ *   them, which is the ordinary cost of changing something react-refresh cannot patch.
+ * - **`check` resolved with null, or applied without moving the hash.** The chain of `*.hot-update.json`
+ *   files leading to the target is broken — as it is after a dev-server restart, whose first act is to wipe
+ *   the output directory an already-open tab would ask for. The hash cannot move from there, so retrying
+ *   would re-request the same 404 for as long as the tab stays open.
+ */
+export async function walkHotUpdates(hot, currentHash, targetHash) {
+    while (targetHash() !== undefined && targetHash() !== currentHash()) {
+        if (hot.status() !== 'idle')
+            return { reason: 'a hot update was already in flight' };
+        const before = currentHash();
+        let applied;
+        try {
+            applied = await hot.check(true);
+        }
+        catch (error) {
+            return { reason: 'a hot update failed to apply', error };
+        }
+        if (applied === null || currentHash() === before)
+            return { reason: 'this build cannot be applied on top of the page' };
+    }
+    return null;
+}
+//# sourceMappingURL=hot-update.js.map

package/dist/runtime/hot-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot-update.js","sourceRoot":"","sources":["../../src/runtime/hot-update.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAe,EAAE,WAAyB,EAAE,UAAoC;IACnH,OAAO,UAAU,EAAE,KAAK,SAAS,IAAI,UAAU,EAAE,KAAK,WAAW,EAAE,EAAE,CAAC;QACpE,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAC;QACrF,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,IAAI,OAAsC,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,MAAM,EAAE,8BAA8B,EAAE,KAAK,EAAE,CAAC;QAC3D,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,IAAI,WAAW,EAAE,KAAK,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,iDAAiD,EAAE,CAAC;IACzH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Walking the page from the build it is running to the build the dev server has announced. Its own module\n * because every decision in it is about *giving up correctly*, which is worth testing on its own.\n *\n * Dev-only: the sole caller sits behind `import.meta.webpackHot`, which a production build replaces with\n * `false`.\n */\n\n/** The slice of `import.meta.webpackHot` the walk uses. */\nexport interface HotRuntime {\n  /**\n   * Fetches the update manifest for the build the page is running and, with `autoApply`, applies it.\n   *\n   * Resolves with the updated module ids, or with **null** when the manifest 404s — which the runtime\n   * treats as \"nothing to do\" rather than an error. Rejects only when an update was found and could not be\n   * applied.\n   */\n  check(autoApply?: boolean): Promise<Array<string | number> | null>;\n  status(): string;\n}\n\n/** Why the page has to be reloaded rather than patched — `error` only where one was thrown. */\nexport interface ReloadReason {\n  reason: string;\n  error?: unknown;\n}\n\n/**\n * Advances the page to `targetHash()`, applying one build's worth of updates per round, and reports whether\n * it got there.\n *\n * Both hashes are read through functions because both move underneath this loop: an applied update rewrites\n * `__webpack_hash__`, and a save landing mid-walk moves the target further out. Reading them fresh each\n * round is what lets one walk absorb a burst of saves.\n *\n * Returns `null` once the page is on the target build, or the reason it cannot get there — every one of\n * which is a reload, because the alternative is a page that silently stops updating:\n *\n * - **An update was already in flight.** `check` may only be called from `idle`.\n * - **`check` rejected.** An update was found and could not be applied — usually a module that declines\n *   them, which is the ordinary cost of changing something react-refresh cannot patch.\n * - **`check` resolved with null, or applied without moving the hash.** The chain of `*.hot-update.json`\n *   files leading to the target is broken — as it is after a dev-server restart, whose first act is to wipe\n *   the output directory an already-open tab would ask for. The hash cannot move from there, so retrying\n *   would re-request the same 404 for as long as the tab stays open.\n */\nexport async function walkHotUpdates(hot: HotRuntime, currentHash: () => string, targetHash: () => string | undefined): Promise<ReloadReason | null> {\n  while (targetHash() !== undefined && targetHash() !== currentHash()) {\n    if (hot.status() !== 'idle') return { reason: 'a hot update was already in flight' };\n    const before = currentHash();\n    let applied: Array<string | number> | null;\n    try {\n      applied = await hot.check(true);\n    } catch (error) {\n      return { reason: 'a hot update failed to apply', error };\n    }\n    if (applied === null || currentHash() === before) return { reason: 'this build cannot be applied on top of the page' };\n  }\n  return null;\n}\n"]}

package/dist/runtime/navigation.d.ts

@@ -2,9 +2,9 @@ import { type ReactNode } from 'react';
 /**
  * Imperative navigation actions, reached as `useNavigation().router`.
  *
- * `push` / `replace` / `refresh` are **soft** navigations: the new page's flight
- * payload is fetched and applied in place, so client component state outside the
- * changed subtree survives. Off-site or non-HTTP hrefs fall back to a full load.
+ * `push` / `replace` / `refresh` are **soft** navigations: the new page's flight payload is fetched and
+ * applied in place, so client component state outside the changed subtree survives. Off-site hrefs fall
+ * back to a full load.
  *
  * @example
  * ```tsx
@@ -27,9 +27,8 @@ export interface NavigationRouter {
 /** The current location plus the {@link NavigationRouter}, as returned by {@link useNavigation}. */
 export interface NavigationState {
     /**
-     * The full current {@link URL} — read `url.pathname`, `url.searchParams` and the
-     * rest off it. A fresh instance per navigation, so mutating it affects nothing
-     * else; it is not written back to the address bar either.
+     * The full current {@link URL}. A fresh instance per navigation, so mutating it affects nothing else
+     * — it is not written back to the address bar.
      */
     url: URL;
     /** Matched route params for the current page, e.g. `{ id: '42' }` for `/profile/:id`. */
@@ -38,16 +37,14 @@ export interface NavigationState {
     router: NavigationRouter;
 }
 /**
- * Carries the live {@link NavigationRouter} implementation from the hydration runtime down
- * to {@link RouterProvider}. Framework internal — read the router through
- * {@link useNavigation} instead.
+ * Carries the live {@link NavigationRouter} from the hydration runtime down to {@link RouterProvider}.
  *
  * @internal
  */
 export declare const RouterContext: import("react").Context<NavigationRouter>;
 /**
- * Publishes the per-render location and params so {@link useNavigation} can read
- * them. Framework internal — the RSC entry wraps every page in one.
+ * Publishes the per-render location and params for {@link useNavigation} to read. The RSC entry wraps
+ * every page in one.
  *
  * @internal
  */
@@ -57,16 +54,14 @@ export declare function RouterProvider({ href, params, children }: {
     children: ReactNode;
 }): import("react").JSX.Element;
 /**
- * Reactive access to the current URL and programmatic navigation, in one hook.
+ * Reactive access to the current URL and programmatic navigation, in one hook. Call it from a
+ * `'use client'` component.
  *
- * Call it from a `'use client'` component. The location fields (`url` and
- * `params`) are computed on the server and travel in the flight payload, so they
- * are correct during SSR — no hydration flicker — and update automatically on
- * every navigation. The `router` sub-object holds the imperative actions plus a
- * `pending` flag that is `true` while a client navigation is in flight.
+ * `url` and `params` are computed on the server and travel in the flight payload, so they are correct
+ * during SSR — no hydration flicker — and update on every navigation. `router` holds the imperative
+ * actions plus a `pending` flag, `true` while a soft navigation is in flight.
  *
- * Hooks can't run in a server component; read the same URL data there from
- * `getRequestContext()` (`@rshono/core/server`) instead.
+ * Hooks can't run in a server component; read the same data there from `getRequestContext()`.
  *
  * @example
  * ```tsx