@bleedingdev/modern-js-runtime-extensions 3.9.0-ultramodern.17 → 3.9.0-ultramodern.18

package/dist/cjs/rendererHead.js

@@ -57,8 +57,9 @@ var __webpack_exports__ = {};
         "createWebHeadMarkerStripper",
         "default",
         "finishHeadRender",
-        "abortHeadRender",
+        "LATE_HEAD_MESSAGE",
         "beginHeadRender",
+        "abortHeadRender",
         "completeHeadRender",
         "createHeadChunkProcessor",
         "publishHeadRender",
@@ -71,6 +72,7 @@ var __webpack_exports__ = {};
     const MARKER_SUFFIX = '"></template>';
     const RECORD_ID_WIDTH = 12;
     const MARKER_LENGTH = MARKER_PREFIX.length + 1 + 36 + RECORD_ID_WIDTH + MARKER_SUFFIX.length;
+    const LATE_HEAD_MESSAGE = "<Helmet> rendered in a boundary that completed after the shell; head tags dropped. Move it above the Suspense boundary or set server.ssrByEntries[entry].mode to 'string'.";
     const HEAD_STATE = Symbol('modern.rendererHead');
     const getState = (context)=>{
         const headContext = context;
@@ -91,7 +93,12 @@ var __webpack_exports__ = {};
         transaction.nextRecordId += 1;
         return token;
     };
-    const beginHeadRender = (context)=>{
+    const dropLateHead = (transaction)=>{
+        if (transaction.lateHeadReported) return;
+        transaction.lateHeadReported = true;
+        transaction.reportLateHead(LATE_HEAD_MESSAGE);
+    };
+    const beginHeadRender = (context, reportLateHead)=>{
         const state = getState(context);
         state.transaction = {
             recordsByToken: new Map(),
@@ -100,7 +107,9 @@ var __webpack_exports__ = {};
             nextRecordId: 0,
             nonce: globalThis.crypto.randomUUID(),
             previousRecords: state.publishedRecords,
-            sealed: false
+            sealed: false,
+            reportLateHead,
+            lateHeadReported: false
         };
         state.publish?.([]);
     };
@@ -111,7 +120,6 @@ var __webpack_exports__ = {};
         const hadPublisher = void 0 !== state.publish;
         state.publish = (records)=>publish(records);
         if (!hadPublisher) state.publish([]);
-        if (transaction.sealed) return null;
         const token = createToken(transaction);
         transaction.recordsByToken.set(token, createRecord());
         return {
@@ -141,7 +149,9 @@ var __webpack_exports__ = {};
             const token = html.slice(tokenStart, end);
             if (transaction.recordsByToken.has(token)) {
                 stripped += html.slice(cursor, start);
-                if (!transaction.sealed && !transaction.committedTokens.has(token)) {
+                if (transaction.sealed) {
+                    if (!transaction.committedTokens.has(token)) dropLateHead(transaction);
+                } else if (!transaction.committedTokens.has(token)) {
                     transaction.committedTokens.add(token);
                     transaction.committedRecords.push(transaction.recordsByToken.get(token));
                 }
@@ -227,6 +237,7 @@ var __webpack_exports__ = {};
         });
     };
     __webpack_require__.d(__webpack_exports__, {}, {
+        LATE_HEAD_MESSAGE: LATE_HEAD_MESSAGE,
         abortHeadRender: abortHeadRender,
         beginHeadRender: beginHeadRender,
         collectHeadRecord: collectHeadRecord,
@@ -238,6 +249,7 @@ var __webpack_exports__ = {};
         publishHeadRender: publishHeadRender
     });
 })();
+exports.LATE_HEAD_MESSAGE = __webpack_exports__.LATE_HEAD_MESSAGE;
 exports.abortHeadRender = __webpack_exports__.abortHeadRender;
 exports.beginHeadRender = __webpack_exports__.beginHeadRender;
 exports.collectHeadRecord = __webpack_exports__.collectHeadRecord;
@@ -248,6 +260,7 @@ exports.createWebHeadMarkerStripper = __webpack_exports__.createWebHeadMarkerStr
 exports.finishHeadRender = __webpack_exports__.finishHeadRender;
 exports.publishHeadRender = __webpack_exports__.publishHeadRender;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "LATE_HEAD_MESSAGE",
     "abortHeadRender",
     "beginHeadRender",
     "collectHeadRecord",

package/dist/cjs/request-policy/policyCore.js

@@ -81,7 +81,7 @@ const toOrigin = (value)=>{
     if (!value) return;
     try {
         return new URL(value).origin;
-    } catch (error) {
+    } catch  {
         return;
     }
 };

package/dist/cjs/request-policy/transport.js

@@ -87,7 +87,7 @@ const shouldRetryWithDefaults = (method, statusCode, error, retryableStatusCodes
 const shouldRetry = (retryOptions, context, retryableStatusCodes)=>{
     if ('function' == typeof retryOptions?.shouldRetry) try {
         return retryOptions.shouldRetry(context);
-    } catch (error) {
+    } catch  {
         return false;
     }
     return shouldRetryWithDefaults(context.method, context.statusCode, context.error, retryableStatusCodes);
@@ -104,7 +104,7 @@ const emitDegradedEvent = (transport, event)=>{
     if ('function' != typeof transport?.onDegraded) return;
     try {
         transport.onDegraded(event);
-    } catch (error) {}
+    } catch  {}
 };
 const withTimeout = async (promise, timeoutMs, signalBuilder)=>{
     if (!timeoutMs || timeoutMs <= 0) {

package/dist/esm/rendererHead.mjs

@@ -4,6 +4,7 @@ const MARKER_PREFIX = `<template ${MARKER_ATTRIBUTE}="`;
 const MARKER_SUFFIX = '"></template>';
 const RECORD_ID_WIDTH = 12;
 const MARKER_LENGTH = MARKER_PREFIX.length + 1 + 36 + RECORD_ID_WIDTH + MARKER_SUFFIX.length;
+const LATE_HEAD_MESSAGE = "<Helmet> rendered in a boundary that completed after the shell; head tags dropped. Move it above the Suspense boundary or set server.ssrByEntries[entry].mode to 'string'.";
 const HEAD_STATE = Symbol('modern.rendererHead');
 const getState = (context)=>{
     const headContext = context;
@@ -24,7 +25,12 @@ const createToken = (transaction)=>{
     transaction.nextRecordId += 1;
     return token;
 };
-const beginHeadRender = (context)=>{
+const dropLateHead = (transaction)=>{
+    if (transaction.lateHeadReported) return;
+    transaction.lateHeadReported = true;
+    transaction.reportLateHead(LATE_HEAD_MESSAGE);
+};
+const beginHeadRender = (context, reportLateHead)=>{
     const state = getState(context);
     state.transaction = {
         recordsByToken: new Map(),
@@ -33,7 +39,9 @@ const beginHeadRender = (context)=>{
         nextRecordId: 0,
         nonce: globalThis.crypto.randomUUID(),
         previousRecords: state.publishedRecords,
-        sealed: false
+        sealed: false,
+        reportLateHead,
+        lateHeadReported: false
     };
     state.publish?.([]);
 };
@@ -44,7 +52,6 @@ const collectHeadRecord = (context, createRecord, publish)=>{
     const hadPublisher = void 0 !== state.publish;
     state.publish = (records)=>publish(records);
     if (!hadPublisher) state.publish([]);
-    if (transaction.sealed) return null;
     const token = createToken(transaction);
     transaction.recordsByToken.set(token, createRecord());
     return {
@@ -74,7 +81,9 @@ const consumeMarkers = (context, html)=>{
         const token = html.slice(tokenStart, end);
         if (transaction.recordsByToken.has(token)) {
             stripped += html.slice(cursor, start);
-            if (!transaction.sealed && !transaction.committedTokens.has(token)) {
+            if (transaction.sealed) {
+                if (!transaction.committedTokens.has(token)) dropLateHead(transaction);
+            } else if (!transaction.committedTokens.has(token)) {
                 transaction.committedTokens.add(token);
                 transaction.committedRecords.push(transaction.recordsByToken.get(token));
             }
@@ -159,4 +168,4 @@ const createWebHeadMarkerStripper = (context)=>{
         }
     });
 };
-export { abortHeadRender, beginHeadRender, collectHeadRecord, collectHeadState, completeHeadRender, createHeadChunkProcessor, createWebHeadMarkerStripper, finishHeadRender, publishHeadRender };
+export { LATE_HEAD_MESSAGE, abortHeadRender, beginHeadRender, collectHeadRecord, collectHeadState, completeHeadRender, createHeadChunkProcessor, createWebHeadMarkerStripper, finishHeadRender, publishHeadRender };

package/dist/esm/request-policy/policyCore.mjs

@@ -30,7 +30,7 @@ const toOrigin = (value)=>{
     if (!value) return;
     try {
         return new URL(value).origin;
-    } catch (error) {
+    } catch  {
         return;
     }
 };

package/dist/esm/request-policy/transport.mjs

@@ -58,7 +58,7 @@ const shouldRetryWithDefaults = (method, statusCode, error, retryableStatusCodes
 const shouldRetry = (retryOptions, context, retryableStatusCodes)=>{
     if ('function' == typeof retryOptions?.shouldRetry) try {
         return retryOptions.shouldRetry(context);
-    } catch (error) {
+    } catch  {
         return false;
     }
     return shouldRetryWithDefaults(context.method, context.statusCode, context.error, retryableStatusCodes);
@@ -75,7 +75,7 @@ const emitDegradedEvent = (transport, event)=>{
     if ('function' != typeof transport?.onDegraded) return;
     try {
         transport.onDegraded(event);
-    } catch (error) {}
+    } catch  {}
 };
 const withTimeout = async (promise, timeoutMs, signalBuilder)=>{
     if (!timeoutMs || timeoutMs <= 0) {

package/dist/esm-node/rendererHead.mjs

@@ -5,6 +5,7 @@ const MARKER_PREFIX = `<template ${MARKER_ATTRIBUTE}="`;
 const MARKER_SUFFIX = '"></template>';
 const RECORD_ID_WIDTH = 12;
 const MARKER_LENGTH = MARKER_PREFIX.length + 1 + 36 + RECORD_ID_WIDTH + MARKER_SUFFIX.length;
+const LATE_HEAD_MESSAGE = "<Helmet> rendered in a boundary that completed after the shell; head tags dropped. Move it above the Suspense boundary or set server.ssrByEntries[entry].mode to 'string'.";
 const HEAD_STATE = Symbol('modern.rendererHead');
 const getState = (context)=>{
     const headContext = context;
@@ -25,7 +26,12 @@ const createToken = (transaction)=>{
     transaction.nextRecordId += 1;
     return token;
 };
-const beginHeadRender = (context)=>{
+const dropLateHead = (transaction)=>{
+    if (transaction.lateHeadReported) return;
+    transaction.lateHeadReported = true;
+    transaction.reportLateHead(LATE_HEAD_MESSAGE);
+};
+const beginHeadRender = (context, reportLateHead)=>{
     const state = getState(context);
     state.transaction = {
         recordsByToken: new Map(),
@@ -34,7 +40,9 @@ const beginHeadRender = (context)=>{
         nextRecordId: 0,
         nonce: globalThis.crypto.randomUUID(),
         previousRecords: state.publishedRecords,
-        sealed: false
+        sealed: false,
+        reportLateHead,
+        lateHeadReported: false
     };
     state.publish?.([]);
 };
@@ -45,7 +53,6 @@ const collectHeadRecord = (context, createRecord, publish)=>{
     const hadPublisher = void 0 !== state.publish;
     state.publish = (records)=>publish(records);
     if (!hadPublisher) state.publish([]);
-    if (transaction.sealed) return null;
     const token = createToken(transaction);
     transaction.recordsByToken.set(token, createRecord());
     return {
@@ -75,7 +82,9 @@ const consumeMarkers = (context, html)=>{
         const token = html.slice(tokenStart, end);
         if (transaction.recordsByToken.has(token)) {
             stripped += html.slice(cursor, start);
-            if (!transaction.sealed && !transaction.committedTokens.has(token)) {
+            if (transaction.sealed) {
+                if (!transaction.committedTokens.has(token)) dropLateHead(transaction);
+            } else if (!transaction.committedTokens.has(token)) {
                 transaction.committedTokens.add(token);
                 transaction.committedRecords.push(transaction.recordsByToken.get(token));
             }
@@ -160,4 +169,4 @@ const createWebHeadMarkerStripper = (context)=>{
         }
     });
 };
-export { abortHeadRender, beginHeadRender, collectHeadRecord, collectHeadState, completeHeadRender, createHeadChunkProcessor, createWebHeadMarkerStripper, finishHeadRender, publishHeadRender };
+export { LATE_HEAD_MESSAGE, abortHeadRender, beginHeadRender, collectHeadRecord, collectHeadState, completeHeadRender, createHeadChunkProcessor, createWebHeadMarkerStripper, finishHeadRender, publishHeadRender };

package/dist/esm-node/request-policy/policyCore.mjs

@@ -31,7 +31,7 @@ const toOrigin = (value)=>{
     if (!value) return;
     try {
         return new URL(value).origin;
-    } catch (error) {
+    } catch  {
         return;
     }
 };

package/dist/esm-node/request-policy/transport.mjs

@@ -59,7 +59,7 @@ const shouldRetryWithDefaults = (method, statusCode, error, retryableStatusCodes
 const shouldRetry = (retryOptions, context, retryableStatusCodes)=>{
     if ('function' == typeof retryOptions?.shouldRetry) try {
         return retryOptions.shouldRetry(context);
-    } catch (error) {
+    } catch  {
         return false;
     }
     return shouldRetryWithDefaults(context.method, context.statusCode, context.error, retryableStatusCodes);
@@ -76,7 +76,7 @@ const emitDegradedEvent = (transport, event)=>{
     if ('function' != typeof transport?.onDegraded) return;
     try {
         transport.onDegraded(event);
-    } catch (error) {}
+    } catch  {}
 };
 const withTimeout = async (promise, timeoutMs, signalBuilder)=>{
     if (!timeoutMs || timeoutMs <= 0) {

package/dist/types/helmetCompat.d.ts

@@ -63,7 +63,7 @@ export type HelmetCompatState<Element> = {
     style: HeadDatum<Element>;
     title: HeadDatum<Element>;
 };
-export declare const renderHeadMarker: <Element>(react: ElementFactory<Element>, marker: MarkerProps | null | undefined) => Element | null;
+export declare const renderHeadMarker: <Element>(react: ElementFactory<Element>, marker: MarkerProps | undefined) => Element | null;
 export declare const markPriorityHeadRecord: (record: object, prioritize: boolean | undefined) => void;
 export declare const isPriorityHeadTag: (tag: object) => boolean;
 export declare const headTagsToComponents: <Element>(react: ElementFactory<Element>, tagName: string, tags: HeadTag[]) => Element[];

package/dist/types/rendererHead.d.ts

@@ -1,11 +1,13 @@
 declare const MARKER_ATTRIBUTE = "data-modern-helmet";
 export type RendererHeadMarkerProps = Record<typeof MARKER_ATTRIBUTE, string>;
 export * from './helmetCompat.js';
-export declare const beginHeadRender: (context: object) => void;
-export declare const collectHeadRecord: <RecordType>(context: object, createRecord: () => RecordType, publish: (records: RecordType[]) => void) => RendererHeadMarkerProps | null | undefined;
+export type ReportLateHead = (message: string) => void;
+export declare const LATE_HEAD_MESSAGE = "<Helmet> rendered in a boundary that completed after the shell; head tags dropped. Move it above the Suspense boundary or set server.ssrByEntries[entry].mode to 'string'.";
+export declare const beginHeadRender: (context: object, reportLateHead: ReportLateHead) => void;
+export declare const collectHeadRecord: <RecordType>(context: object, createRecord: () => RecordType, publish: (records: RecordType[]) => void) => RendererHeadMarkerProps | undefined;
 export declare const collectHeadState: <RecordType, StateType>(context: object, createRecord: () => RecordType, derive: (records: RecordType[]) => StateType, target: {
     helmet?: StateType;
-}) => RendererHeadMarkerProps | null | undefined;
+}) => RendererHeadMarkerProps | undefined;
 export declare const publishHeadRender: (context: object) => void;
 export declare const finishHeadRender: (context: object) => void;
 export declare const completeHeadRender: (context: object, html: string) => string;

package/package.json

@@ -11,7 +11,7 @@
     "directory": "packages/runtime/runtime-extensions"
   },
   "license": "MIT",
-  "version": "3.9.0-ultramodern.17",
+  "version": "3.9.0-ultramodern.18",
   "engines": {
     "node": ">=26.7.0"
   },
@@ -70,14 +70,6 @@
       },
       "default": "./dist/esm/localisedLoaderIdentity.mjs"
     },
-    "./react-context": {
-      "types": "./dist/types/reactContext.d.ts",
-      "node": {
-        "import": "./dist/esm-node/reactContext.mjs",
-        "require": "./dist/cjs/reactContext.js"
-      },
-      "default": "./dist/esm/reactContext.mjs"
-    },
     "./context-extensions": {
       "types": "./dist/types/contextExtensions.d.ts",
       "node": {
@@ -222,10 +214,6 @@
         "./dist/types/localisedLoaderIdentity.d.ts",
         "./src/localisedLoaderIdentity.ts"
       ],
-      "react-context": [
-        "./dist/types/reactContext.d.ts",
-        "./src/reactContext.ts"
-      ],
       "context-extensions": [
         "./dist/types/contextExtensions.d.ts",
         "./src/contextExtensions.ts"
@@ -286,7 +274,7 @@
   },
   "devDependencies": {
     "@loadable/component": "5.16.7",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.17",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.18",
     "@rsbuild/core": "2.2.9",
     "@rslib/core": "1.0.2",
     "@scripts/rstest-config": "2.66.0",
@@ -315,8 +303,8 @@
     }
   },
   "dependencies": {
-    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.9.0-ultramodern.17",
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.17",
+    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.9.0-ultramodern.18",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.18",
     "react-helmet-async": "3.0.0"
   },
   "scripts": {

package/src/helmetCompat.ts

@@ -149,7 +149,7 @@ const createElementFactory = <Element>(react: ElementFactory<Element>) =>
 
 export const renderHeadMarker = <Element>(
   react: ElementFactory<Element>,
-  marker: MarkerProps | null | undefined,
+  marker: MarkerProps | undefined,
 ): Element | null =>
   marker ? createElementFactory(react)('template', marker) : null;
 

package/src/rendererHead.ts

@@ -9,6 +9,10 @@ export type RendererHeadMarkerProps = Record<typeof MARKER_ATTRIBUTE, string>;
 export * from './helmetCompat';
 
 type PublishRecords = (records: unknown[]) => void;
+export type ReportLateHead = (message: string) => void;
+
+export const LATE_HEAD_MESSAGE =
+  "<Helmet> rendered in a boundary that completed after the shell; head tags dropped. Move it above the Suspense boundary or set server.ssrByEntries[entry].mode to 'string'.";
 
 type HeadTransaction = {
   recordsByToken: Map<string, unknown>;
@@ -18,6 +22,8 @@ type HeadTransaction = {
   nonce: string;
   previousRecords: unknown[];
   sealed: boolean;
+  reportLateHead: ReportLateHead;
+  lateHeadReported: boolean;
 };
 
 type HeadState = {
@@ -48,7 +54,16 @@ const createToken = (transaction: HeadTransaction): string => {
   return token;
 };
 
-export const beginHeadRender = (context: object): void => {
+const dropLateHead = (transaction: HeadTransaction): void => {
+  if (transaction.lateHeadReported) return;
+  transaction.lateHeadReported = true;
+  transaction.reportLateHead(LATE_HEAD_MESSAGE);
+};
+
+export const beginHeadRender = (
+  context: object,
+  reportLateHead: ReportLateHead,
+): void => {
   const state = getState(context);
   state.transaction = {
     recordsByToken: new Map(),
@@ -58,6 +73,8 @@ export const beginHeadRender = (context: object): void => {
     nonce: globalThis.crypto.randomUUID(),
     previousRecords: state.publishedRecords,
     sealed: false,
+    reportLateHead,
+    lateHeadReported: false,
   };
   state.publish?.([]);
 };
@@ -66,7 +83,7 @@ export const collectHeadRecord = <RecordType>(
   context: object,
   createRecord: () => RecordType,
   publish: (records: RecordType[]) => void,
-): RendererHeadMarkerProps | null | undefined => {
+): RendererHeadMarkerProps | undefined => {
   const state = getState(context);
   const transaction = state.transaction;
   if (transaction === undefined) {
@@ -78,10 +95,8 @@ export const collectHeadRecord = <RecordType>(
   if (!hadPublisher) {
     state.publish([]);
   }
-  if (transaction.sealed) {
-    return null;
-  }
-
+  // A Helmet rendered after the seal still gets a marker: it is dropped, and
+  // reported, only if its boundary actually commits to the output.
   const token = createToken(transaction);
   transaction.recordsByToken.set(token, createRecord());
   return { [MARKER_ATTRIBUTE]: token };
@@ -92,7 +107,7 @@ export const collectHeadState = <RecordType, StateType>(
   createRecord: () => RecordType,
   derive: (records: RecordType[]) => StateType,
   target: { helmet?: StateType },
-): RendererHeadMarkerProps | null | undefined =>
+): RendererHeadMarkerProps | undefined =>
   collectHeadRecord(context, createRecord, records => {
     target.helmet = derive(records);
   });
@@ -123,7 +138,9 @@ const consumeMarkers = (context: object, html: string): string => {
       stripped += html.slice(cursor, end + MARKER_SUFFIX.length);
     } else {
       stripped += html.slice(cursor, start);
-      if (!transaction.sealed && !transaction.committedTokens.has(token)) {
+      if (transaction.sealed) {
+        if (!transaction.committedTokens.has(token)) dropLateHead(transaction);
+      } else if (!transaction.committedTokens.has(token)) {
         transaction.committedTokens.add(token);
         transaction.committedRecords.push(
           transaction.recordsByToken.get(token),

package/src/request-policy/policyCore.ts

@@ -92,7 +92,7 @@ export const toOrigin = (value?: string) => {
   }
   try {
     return new URL(value).origin;
-  } catch (error) {
+  } catch {
     return undefined;
   }
 };

package/src/request-policy/transport.ts

@@ -131,7 +131,7 @@ const shouldRetry = (
   if (typeof retryOptions?.shouldRetry === 'function') {
     try {
       return retryOptions.shouldRetry(context);
-    } catch (error) {
+    } catch {
       return false;
     }
   }
@@ -176,7 +176,7 @@ const emitDegradedEvent = (
 
   try {
     transport.onDegraded(event);
-  } catch (error) {
+  } catch {
     // best-effort telemetry only
   }
 };

package/tests/headRuntime.test.tsx

@@ -10,7 +10,7 @@ const getHelmetData = (context: object) => getHelmetContext(context)?.helmet;
 const createServerContext = () => ({ isBrowser: false }) as any;
 
 const renderWithContext = (context: any, node: React.ReactNode) => {
-  rendererHead.beginHeadRender(context);
+  rendererHead.beginHeadRender(context, () => {});
   try {
     const html = renderToString(
       wrapServerRoot(node, {

package/tests/rendererHead.test.ts

@@ -5,6 +5,8 @@ import {
   collectHeadRecord,
   completeHeadRender,
   createHeadChunkProcessor,
+  LATE_HEAD_MESSAGE,
+  publishHeadRender,
 } from '../src';
 import { createNodeHeadMarkerStripper, pipeNodeHeadStream } from '../src/node';
 
@@ -15,7 +17,7 @@ describe('renderer head transactions', () => {
   it('commits only markers observed in completed output', () => {
     const context = {};
     let published: string[] = [];
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     const committed = collectHeadRecord(
       context,
       () => 'committed',
@@ -35,9 +37,50 @@ describe('renderer head transactions', () => {
     expect(published).toEqual(['committed']);
   });
 
+  it('reports head records whose markers commit after the seal', () => {
+    const context = {};
+    const reports: string[] = [];
+    let published: string[] = [];
+    const publish = (records: string[]) => {
+      published = records;
+    };
+    beginHeadRender(context, message => reports.push(message));
+    const shell = collectHeadRecord(context, () => 'shell', publish)!;
+    // A boundary rendered before the seal but flushed after it.
+    const flushedLate = collectHeadRecord(context, () => 'flushed', publish)!;
+    const processor = createHeadChunkProcessor(context);
+    expect(processor.push(`a${marker(shell)}`)).toBe('a');
+    publishHeadRender(context);
+    // A boundary rendered after the seal.
+    const renderedLate = collectHeadRecord(context, () => 'rendered', publish)!;
+    // A retry that renders a Helmet and then suspends again never commits.
+    collectHeadRecord(context, () => 'discarded', publish);
+    expect(reports).toEqual([]);
+
+    expect(processor.push(`b${marker(flushedLate)}${marker(shell)}`)).toBe('b');
+    expect(processor.finish(`c${marker(renderedLate)}`)).toBe('c');
+
+    expect(published).toEqual(['shell']);
+    expect(reports).toEqual([LATE_HEAD_MESSAGE]);
+  });
+
+  it('does not report a late Helmet whose boundary never commits', () => {
+    const context = {};
+    const reports: string[] = [];
+    beginHeadRender(context, message => reports.push(message));
+    publishHeadRender(context);
+    collectHeadRecord(
+      context,
+      () => 'discarded',
+      () => {},
+    );
+    expect(completeHeadRender(context, 'done')).toBe('done');
+    expect(reports).toEqual([]);
+  });
+
   it('preserves user templates that are not current transaction markers', () => {
     const context = {};
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     const userTemplate =
       '<template data-modern-helmet="h00000000-0000-0000-0000-000000000000000000000000"></template>';
 
@@ -46,7 +89,7 @@ describe('renderer head transactions', () => {
 
   it('strips markers split across chunks without corrupting unicode', () => {
     const sampleContext = {};
-    beginHeadRender(sampleContext);
+    beginHeadRender(sampleContext, () => {});
     const sampleProps = collectHeadRecord(
       sampleContext,
       () => 'head',
@@ -56,7 +99,7 @@ describe('renderer head transactions', () => {
 
     for (let split = 1; split < sampleHtml.length; split += 1) {
       const context = {};
-      beginHeadRender(context);
+      beginHeadRender(context, () => {});
       const props = collectHeadRecord(
         context,
         () => 'head',
@@ -78,12 +121,12 @@ describe('renderer head transactions', () => {
       published = records;
     };
 
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     const previous = collectHeadRecord(context, () => 'previous', publish)!;
     completeHeadRender(context, marker(previous));
     expect(published).toEqual(['previous']);
 
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     expect(published).toEqual([]);
     collectHeadRecord(context, () => 'provisional', publish);
     abortHeadRender(context);
@@ -93,7 +136,7 @@ describe('renderer head transactions', () => {
   it('strips split markers from a Node stream', async () => {
     const context = {};
     let published: string[] = [];
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     const props = collectHeadRecord(
       context,
       () => 'node',
@@ -127,7 +170,7 @@ describe('renderer head transactions', () => {
     const prefix = Buffer.from('x'.repeat(9 * 1024));
     const unicodeTail = Buffer.from('č尾');
     const input = Buffer.concat([prefix, unicodeTail]);
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     const stripper = createNodeHeadMarkerStripper(context, terminalMarker);
     const output = new Promise<string>((resolve, reject) => {
       let rendered = '';
@@ -152,7 +195,7 @@ describe('renderer head transactions', () => {
     const terminalMarker = '<!-- shell stream end -->';
     const input = Buffer.from(`shell${terminalMarker}č尾`);
     const markerOffset = Buffer.byteLength('shell') + 7;
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     const stripper = createNodeHeadMarkerStripper(context, terminalMarker);
     const output = new Promise<string>((resolve, reject) => {
       let rendered = '';

package/tests/shellStream.test.ts

@@ -62,10 +62,10 @@ describe('conserving web shell stream', () => {
     const publish = (records: string[]) => {
       published = records;
     };
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     const previous = collectHeadRecord(context, () => 'previous', publish)!;
     completeHeadRender(context, headMarker(previous));
-    beginHeadRender(context);
+    beginHeadRender(context, () => {});
     collectHeadRecord(context, () => 'incomplete', publish);
     const bytes = encoder.encode(`α${'x'.repeat(9 * 1024)}尾`);
     const stream = createConservingWebShellStream(

package/dist/cjs/reactContext.js

@@ -1,45 +0,0 @@
-"use strict";
-var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.d = (exports1, getters, values)=>{
-        var define = (defs, kind)=>{
-            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
-                enumerable: true,
-                [kind]: defs[key]
-            });
-        };
-        define(getters, "get");
-        define(values, "value");
-    };
-})();
-(()=>{
-    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
-})();
-(()=>{
-    __webpack_require__.r = (exports1)=>{
-        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
-            value: 'Module'
-        });
-        Object.defineProperty(exports1, '__esModule', {
-            value: true
-        });
-    };
-})();
-var __webpack_exports__ = {};
-__webpack_require__.r(__webpack_exports__);
-function getRuntimeReactContext(kind, create) {
-    const key = Symbol.for(`@modern-js/runtime:react-context:v1:${kind}`);
-    const contexts = globalThis;
-    contexts[key] ??= create();
-    return contexts[key];
-}
-__webpack_require__.d(__webpack_exports__, {
-    getRuntimeReactContext: ()=>getRuntimeReactContext
-});
-exports.getRuntimeReactContext = __webpack_exports__.getRuntimeReactContext;
-for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "getRuntimeReactContext"
-].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
-Object.defineProperty(exports, '__esModule', {
-    value: true
-});

package/dist/esm/reactContext.mjs

@@ -1,7 +0,0 @@
-function getRuntimeReactContext(kind, create) {
-    const key = Symbol.for(`@modern-js/runtime:react-context:v1:${kind}`);
-    const contexts = globalThis;
-    contexts[key] ??= create();
-    return contexts[key];
-}
-export { getRuntimeReactContext };

package/dist/esm-node/reactContext.mjs

@@ -1,8 +0,0 @@
-import "node:module";
-function getRuntimeReactContext(kind, create) {
-    const key = Symbol.for(`@modern-js/runtime:react-context:v1:${kind}`);
-    const contexts = globalThis;
-    contexts[key] ??= create();
-    return contexts[key];
-}
-export { getRuntimeReactContext };

package/dist/types/reactContext.d.ts

@@ -1,6 +0,0 @@
-/**
- * Federation can bundle a runtime subpath separately from its shared root.
- * Share React context identity across those copies, leaving request values to
- * React's providers. Public and internal contexts retain separate identities.
- */
-export declare function getRuntimeReactContext<T>(kind: 'public' | 'internal', create: () => T): T;

package/src/reactContext.ts

@@ -1,16 +0,0 @@
-/**
- * Federation can bundle a runtime subpath separately from its shared root.
- * Share React context identity across those copies, leaving request values to
- * React's providers. Public and internal contexts retain separate identities.
- */
-export function getRuntimeReactContext<T>(
-  kind: 'public' | 'internal',
-  create: () => T,
-): T {
-  const key = Symbol.for(`@modern-js/runtime:react-context:v1:${kind}`);
-  const contexts = globalThis as typeof globalThis & {
-    [key: symbol]: unknown;
-  };
-  contexts[key] ??= create();
-  return contexts[key] as T;
-}