chore(docs): make prerendering React 19 compatible

react-ssr-prepass reads ReactCurrentDispatcher from the React
internals, which React 19 no longer exposes, so the docs prerender
crashed. It was only used to await AsyncComponent.preload() before
renderToString, and the loading-state render already triggers
preload() itself, so a yarn patch on the documentation-framework
replaces it with re-rendering until no loading placeholder is left.
The same fix should land in the documentation-framework itself.

Author: SamTV12345

.gitignore

@@ -31,4 +31,5 @@ lerna-debug.log
 .vscode
 # For vim
 *.swp
-.yarn
+.yarn/*
+!.yarn/patches

.yarn/patches/@patternfly-documentation-framework-npm-6.49.2-02e7a8d840.patch

@@ -0,0 +1,65 @@
+diff --git a/scripts/webpack/prerender.js b/scripts/webpack/prerender.js
+index 37306139a11cabc0c89e2eee637ea8af88693cd9..03f0c1d909a9bc516c5006cb4f8805c250e060bf 100644
+--- a/scripts/webpack/prerender.js
++++ b/scripts/webpack/prerender.js
+@@ -1,10 +1,44 @@
+ const React = require('react');
+ const ReactDOMServer = require('react-dom/server');
+ const { ServerLocation } = require('@reach/router');
+-const ssrPrepass = require('react-ssr-prepass');
+ // react, react-dom, and @reach/router are all EXCLUDED from the ssr-bundle.js
+ // The versions imported above are used instead, which allows us to use <ServerLocation>
+-// const ssrPrepass = require('react-ssr-prepass');
++
++// Let pending dynamic imports (AsyncComponent.preload) settle before re-rendering
++const flushAsync = () => new Promise((resolve) => setImmediate(() => setImmediate(resolve)));
++
++// The loading state rendered by asyncComponentFactory while a page chunk loads
++const LOADING_MARKER = 'style="height:100vh">Loading...';
++
++// react-ssr-prepass walked the element tree to await AsyncComponent.preload(), but it
++// relies on React internals that no longer exist in React 19. AsyncComponent already
++// kicks off preload() from its loading-state render, so rendering to a fixpoint with
++// plain renderToString preloads the same chunks using only public React APIs.
++let prerenderCount = 0;
++
++async function renderToStringWithPreload(element) {
++  const maxPasses = 4;
++  const start = Date.now();
++  let passes = 1;
++  let html = ReactDOMServer.renderToString(element);
++  if (++prerenderCount % 25 === 0) {
++    console.log(`  [prerender #${prerenderCount}] heap=${Math.round(process.memoryUsage().heapUsed / 1048576)}MB`);
++  }
++
++  for (; passes < maxPasses && html.includes(LOADING_MARKER); passes++) {
++    // The first render has kicked off preload(); give the dynamic imports a chance
++    // to settle, then render again until no loading placeholder is left.
++    await (passes === 1 ? flushAsync() : new Promise((resolve) => setTimeout(resolve, 50)));
++    html = ReactDOMServer.renderToString(element);
++  }
++
++  const elapsed = Date.now() - start;
++  if (elapsed > 5000 || html.includes(LOADING_MARKER)) {
++    console.log(`  rendered in ${passes} passes, ${elapsed}ms${html.includes(LOADING_MARKER) ? ' (loading placeholder left!)' : ''}`);
++  }
++
++  return html;
++}
+ 
+ // This function is effectively synchronous because it mutates global.setTimeout
+ // Only allow one copy at a time to run
+@@ -44,12 +78,7 @@ async function prerender(url) {
+   const WrappedApp = React.createElement(ServerLocation, { url },
+     React.createElement(App)
+   );
+-  await ssrPrepass(WrappedApp, element => {
+-    if (element.type.name === 'AsyncComponent') {
+-      return element.type.preload();
+-    }
+-  });
+-  const string = ReactDOMServer.renderToString(WrappedApp);
++  const string = await renderToStringWithPreload(WrappedApp);
+ 
+   return string;
+ }

package.json

@@ -124,6 +124,7 @@
     ]
   },
   "resolutions": {
-    "dompurify": "3.4.13"
+    "dompurify": "3.4.13",
+    "@patternfly/documentation-framework": "patch:@patternfly/documentation-framework@npm%3A6.49.2#~/.yarn/patches/@patternfly-documentation-framework-npm-6.49.2-02e7a8d840.patch"
   }
 }

yarn.lock

@@ -4963,7 +4963,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@patternfly/documentation-framework@npm:^6.40.0":
+"@patternfly/documentation-framework@npm:6.49.2":
   version: 6.49.2
   resolution: "@patternfly/documentation-framework@npm:6.49.2"
   dependencies:
@@ -5039,6 +5039,82 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@patternfly/documentation-framework@patch:@patternfly/documentation-framework@npm%3A6.49.2#~/.yarn/patches/@patternfly-documentation-framework-npm-6.49.2-02e7a8d840.patch":
+  version: 6.49.2
+  resolution: "@patternfly/documentation-framework@patch:@patternfly/documentation-framework@npm%3A6.49.2#~/.yarn/patches/@patternfly-documentation-framework-npm-6.49.2-02e7a8d840.patch::version=6.49.2&hash=e7d433"
+  dependencies:
+    "@babel/core": "npm:^7.29.0"
+    "@babel/preset-env": "npm:7.29.0"
+    "@babel/preset-react": "npm:^7.28.5"
+    "@mdx-js/util": "npm:1.6.22"
+    "@patternfly/ast-helpers": "npm:^1.26.2"
+    "@reach/router": "npm:@gatsbyjs/reach-router@1.3.9"
+    "@rspack/core": "npm:^1.7.7"
+    "@rspack/dev-server": "npm:^1.2.1"
+    autoprefixer: "npm:10.4.27"
+    babel-loader: "npm:^10.0.0"
+    camelcase-css: "npm:2.0.1"
+    chokidar: "npm:4.0.3"
+    codesandbox: "npm:2.2.3"
+    commander: "npm:4.1.1"
+    css-loader: "npm:6.11.0"
+    detab: "npm:2.0.4"
+    express: "npm:4.22.1"
+    file-loader: "npm:6.2.0"
+    file-saver: "npm:1.3.8"
+    fs-extra: "npm:9.1.0"
+    glob: "npm:12.0.0"
+    handlebars: "npm:4.7.8"
+    hast-to-hyperscript: "npm:9.0.1"
+    hast-util-to-text: "npm:2.0.1"
+    html-formatter: "npm:0.1.9"
+    html-webpack-plugin: "npm:5.6.6"
+    js-yaml: "npm:4.1.1"
+    mdast-util-to-hast: "npm:9.1.2"
+    mdurl: "npm:1.0.1"
+    null-loader: "npm:4.0.1"
+    parse-entities: "npm:2.0.0"
+    path-browserify: "npm:1.0.1"
+    postcss: "npm:^8.5.8"
+    postcss-loader: "npm:7.3.4"
+    process: "npm:^0.11.10"
+    puppeteer: "npm:^24.37.5"
+    puppeteer-cluster: "npm:^0.25.0"
+    react-docgen: "npm:6.0.4"
+    react-ssr-prepass: "npm:1.6.0"
+    remark-footnotes: "npm:1.0.0"
+    remark-frontmatter: "npm:2.0.0"
+    remark-mdx: "npm:2.0.0-next.8"
+    remark-mdxjs: "npm:2.0.0-next.8"
+    remark-parse: "npm:8.0.3"
+    remark-squeeze-paragraphs: "npm:4.0.0"
+    sharp: "npm:0.34.5"
+    style-to-object: "npm:0.4.4"
+    to-vfile: "npm:6.1.0"
+    typedoc: "npm:0.23.28"
+    typescript: "npm:4.9.5"
+    unified: "npm:9.2.2"
+    unist-util-remove: "npm:2.1.0"
+    unist-util-visit: "npm:2.0.3"
+    url-loader: "npm:4.1.1"
+    vfile-reporter: "npm:6.0.2"
+    webpack-bundle-analyzer: "npm:5.2.0"
+    webpack-dev-server: "npm:5.2.3"
+    webpack-merge: "npm:5.10.0"
+  peerDependencies:
+    "@patternfly/patternfly": ^6.6.0
+    "@patternfly/react-code-editor": ^6.6.0
+    "@patternfly/react-core": ^6.6.0
+    "@patternfly/react-icons": ^6.6.0
+    "@patternfly/react-table": ^6.6.0
+    react: ^17.0.0 || ^18.0.0
+    react-dom: ^17.0.0 || ^18.0.0
+  bin:
+    pf-docs-framework: scripts/cli/cli.js
+  checksum: 10c0/315007bd0c1b780c3f789027c8443267e30564fc4b6fc31f14d06dca1cbed8907b7b5bfa006c3149803365c58ee1380df09f5f10e0994426771bb39516418ef3
+  languageName: node
+  linkType: hard
+
 "@patternfly/patternfly-a11y@npm:5.2.1":
   version: 5.2.1
   resolution: "@patternfly/patternfly-a11y@npm:5.2.1"