@modern-js/runtime 3.9.2 → 3.9.3

package/dist/types/core/server/stream/deferredScriptOutputCoordinator.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Serializes the router's deferred-data resolver scripts with React's Fizz
+ * output without rewriting either producer's bytes.
+ *
+ * Why this exists:
+ * - A resolver script settles the client-side Promise created for a
+ *   `defer()` key. It must be sent when that individual server Promise
+ *   settles; waiting for the whole React stream would unnecessarily delay
+ *   hydration and interactivity behind unrelated Suspense boundaries.
+ * - React and the resolver callbacks are independent stream producers. A
+ *   direct `write()` can therefore land in a partial HTML tag, a hidden Fizz
+ *   segment container, or between that container and its continuation
+ *   instruction.
+ * - React's public streaming callbacks expose shell/all-ready lifecycle
+ *   events, not a safe byte-level insertion point. React chunk sizes and
+ *   `progressiveChunkSize` are buffering heuristics, not HTML or Fizz
+ *   boundaries.
+ *
+ * The coordinator deliberately recognizes the Fizz continuation containers
+ * and instructions used by the supported React stream format. This is a
+ * compatibility boundary: when the supported React/Fizz output protocol is
+ * changed, update this recognizer and its Node, Edge, HTML, SVG, MathML, and
+ * table continuation tests together. It is not intended to be a general HTML
+ * rewriter.
+ *
+ * Shell completion only makes a resolver eligible to send. The resolver is
+ * emitted after a root-level HTML boundary and, for a continuation segment,
+ * after React's matching continuation instruction.
+ */
+export declare class DeferredScriptOutputCoordinator {
+    private readonly emit;
+    private readonly pendingResolvers;
+    private readonly openElements;
+    private shellFinished;
+    private closed;
+    private state;
+    private currentTagName;
+    private currentAttributes;
+    private currentAttributeName;
+    private currentAttributeValue;
+    private currentAttributeHasValue;
+    private declarationPrefix;
+    private commentTail;
+    private rawTextElement;
+    private rawTextSearch;
+    private continuationProtocolScript;
+    private continuationProtocolTail;
+    private hasContinuationProtocolCall;
+    private awaitingContinuationProtocol;
+    constructor(emit: (chunk: string) => void);
+    enqueueResolver(script: string): void;
+    /**
+     * Keep this separate from the ShellChunkStatus assignment. The caller sets
+     * FINISH at the existing marker position, then calls this after the marker
+     * chunk's afterMark bytes have been observed.
+     */
+    markShellFinished(): void;
+    writeReact(chunk: string): void;
+    finish(): void;
+    abort(): void;
+    private isSafeBoundary;
+    private flushResolvers;
+    private consume;
+    private startTag;
+    private startAttribute;
+    private completeAttribute;
+    private completeStartTag;
+    private completeEndTag;
+    private consumeRawText;
+    private completeRawTextEndTag;
+    private closeOpenElement;
+}

package/package.json

@@ -15,7 +15,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.9.2",
+  "version": "3.9.3",
   "engines": {
     "node": ">=20"
   },
@@ -215,12 +215,12 @@
     "isbot": "3.8.0",
     "react-helmet": "^6.1.0",
     "react-is": "^18.3.1",
-    "@modern-js/plugin": "3.9.2",
-    "@modern-js/plugin-data-loader": "3.9.2",
-    "@modern-js/render": "3.9.2",
-    "@modern-js/runtime-utils": "3.9.2",
-    "@modern-js/utils": "3.9.2",
-    "@modern-js/types": "3.9.2"
+    "@modern-js/plugin": "3.9.3",
+    "@modern-js/plugin-data-loader": "3.9.3",
+    "@modern-js/render": "3.9.3",
+    "@modern-js/runtime-utils": "3.9.3",
+    "@modern-js/types": "3.9.3",
+    "@modern-js/utils": "3.9.3"
   },
   "peerDependencies": {
     "react": ">=18.3.1",
@@ -228,10 +228,10 @@
   },
   "devDependencies": {
     "@remix-run/web-fetch": "^4.1.3",
-    "@rsbuild/core": "2.2.7",
-    "@rslib/core": "1.0.0",
-    "@testing-library/dom": "^10.4.1",
-    "@testing-library/react": "^16.3.2",
+    "@rsbuild/core": "2.2.9",
+    "@rslib/core": "1.0.1",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
     "@types/cookie": "0.6.0",
     "@types/invariant": "^2.2.37",
     "@types/loadable__server": "5.12.11",
@@ -240,7 +240,7 @@
     "react-dom": "^19.2.8",
     "ts-node": "^10.9.2",
     "typescript": "^5",
-    "@modern-js/app-tools": "3.9.2",
+    "@modern-js/app-tools": "3.9.3",
     "@modern-js/rslib": "2.68.10",
     "@scripts/rstest-config": "2.66.0"
   },