[Fizz] Add react-dom/static Entry Point for Prerendering

[sebmarkbage]

This will be used to add optimizations for static server prerendering.

import {prerender} from "react-dom/static";

For Node I went with:

import {prerenderToNodeStreams} from "react-dom/static";

This always waits for the whole tree to complete before returning a result object.

For the Node.js API I opted to make it more like the Browser API than renderToPipeableStream. So it returns a Promise and accepts an AbortSignal. This is more in line with more modern Node APIs anyway. It also uses full stream.Readable instead of the made up "PipeableStream". Since we're not live streaming we don't need the flush() call so it can just be a regular Readable.

Currently this is only enabled in the experimental build. I confirmed that the entry points and npm files don't get exposed in the stable build.

Notably this "static" is not the same static as "renderToStaticMarkup" where "static" means server-only. That use case will likely be consumed by something like RSC-only without client components.

[sizebot]

Comparing: 0f0aca3...059de2c

Critical size changes

Includes critical production bundles, as well as any change greater than 2%:

Name	+/-	Base	Current	+/- gzip	Base gzip	Current gzip
oss-stable/react-dom/cjs/react-dom.production.min.js	=	131.64 kB	131.64 kB	=	42.30 kB	42.30 kB
oss-experimental/react-dom/cjs/react-dom.production.min.js	=	136.92 kB	136.92 kB	=	43.89 kB	43.89 kB
facebook-www/ReactDOM-prod.classic.js	=	440.83 kB	440.83 kB	=	80.64 kB	80.64 kB
facebook-www/ReactDOM-prod.modern.js	=	426.13 kB	426.13 kB	=	78.45 kB	78.45 kB
facebook-www/ReactDOMForked-prod.classic.js	=	441.61 kB	441.61 kB	=	80.87 kB	80.87 kB
oss-experimental/react-dom/cjs/react-dom-static.browser.development.js	+∞%	0.00 kB	243.84 kB	+∞%	0.00 kB	59.19 kB
oss-experimental/react-dom/cjs/react-dom-static.browser.production.min.js	+∞%	0.00 kB	35.95 kB	+∞%	0.00 kB	12.39 kB
oss-experimental/react-dom/cjs/react-dom-static.node.development.js	+∞%	0.00 kB	245.69 kB	+∞%	0.00 kB	59.41 kB
oss-experimental/react-dom/cjs/react-dom-static.node.production.min.js	+∞%	0.00 kB	39.51 kB	+∞%	0.00 kB	13.47 kB
oss-experimental/react-dom/static.browser.js	+∞%	0.00 kB	0.23 kB	+∞%	0.00 kB	0.16 kB
oss-experimental/react-dom/static.js	+∞%	0.00 kB	0.06 kB	+∞%	0.00 kB	0.08 kB
oss-experimental/react-dom/static.node.js	+∞%	0.00 kB	0.22 kB	+∞%	0.00 kB	0.16 kB

Significant size changes

Includes any change greater than 0.2%:

Expand to show

Name	+/-	Base	Current	+/- gzip	Base gzip	Current gzip
oss-experimental/react-dom/cjs/react-dom-static.browser.development.js	+∞%	0.00 kB	243.84 kB	+∞%	0.00 kB	59.19 kB
oss-experimental/react-dom/cjs/react-dom-static.browser.production.min.js	+∞%	0.00 kB	35.95 kB	+∞%	0.00 kB	12.39 kB
oss-experimental/react-dom/cjs/react-dom-static.node.development.js	+∞%	0.00 kB	245.69 kB	+∞%	0.00 kB	59.41 kB
oss-experimental/react-dom/cjs/react-dom-static.node.production.min.js	+∞%	0.00 kB	39.51 kB	+∞%	0.00 kB	13.47 kB
oss-experimental/react-dom/static.browser.js	+∞%	0.00 kB	0.23 kB	+∞%	0.00 kB	0.16 kB
oss-experimental/react-dom/static.js	+∞%	0.00 kB	0.06 kB	+∞%	0.00 kB	0.08 kB
oss-experimental/react-dom/static.node.js	+∞%	0.00 kB	0.22 kB	+∞%	0.00 kB	0.16 kB

Generated by 🚫 dangerJS against 059de2c

[sebmarkbage]

Going forward, I think this API is the only one that should be guaranteed to be deterministic. The other dynamic one is not. However since the implementation will overlap a lot it probably doesn't make much of a difference.

[gnoff]

Do these not use the DCE check code because they are not client and won’t always be bundled?

[sebmarkbage]

It matters less on the server so not worth the code. If you're setting up a server environment you are down a deeper rabbit hole anyway.

[slorber]

Hey, just stumbled upon react-dom/static

• Is this still considered experimental?
• Are there any docs for these exports?
• Should I use this for Docusaurus SSG? (currently we use this)
• Is it usable without rendering the full page? (ie, rendering just a div, and not html+body+div)