chore(docs): make prerendering React 19 compatible

react-ssr-prepass 1.6.0 (latest) reads ReactCurrentDispatcher from the
React internals, which React 19 no longer exposes, so the docs
prerender crashed. The docs framework only used prepass to await
AsyncComponent.preload() before renderToString, and the loading-state
render already kicks off preload() itself, so a Yarn patch on
@patternfly/documentation-framework replaces prepass with fixpoint
rendering on public React APIs: render, let the dynamic imports
settle, and re-render until no loading placeholder remains.

.gitignore now keeps .yarn/patches while ignoring the rest of .yarn.
The same change should be upstreamed to the documentation-framework.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

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"