react-on-rails 16.7.0-rc.0 → 16.7.0-rc.2

package/lib/ReactDOMServer.d.cts

@@ -0,0 +1,2 @@
+export { renderToPipeableStream, renderToString, type PipeableStream } from 'react-dom/server';
+//# sourceMappingURL=ReactDOMServer.d.cts.map

package/lib/reactApis.cjs

@@ -15,7 +15,9 @@ let reactDomClient;
 if (exports.supportsRootApi) {
     // This will never throw an exception, but it's the way to tell Webpack the dependency is optional
     // https://github.com/webpack/webpack/issues/339#issuecomment-47739112
-    // Unfortunately, it only converts the error to a warning.
+    // Unfortunately, it only converts the error to a warning. React 16/17 consumers can suppress
+    // the warning by passing `reactDomClientWarning` from 'react-on-rails/webpackHelpers' to their
+    // webpack `ignoreWarnings` config. See #3137.
     try {
         reactDomClient = require('react-dom/client');
     }

package/lib/reactApis.d.cts

@@ -0,0 +1,11 @@
+import type { ReactElement } from 'react';
+import type { RenderReturnType } from './types/index.ts' with { 'resolution-mode': 'import' };
+export declare const supportsRootApi: boolean;
+export declare const supportsHydrate: boolean;
+type HydrateOrRenderType = (domNode: Element, reactElement: ReactElement) => RenderReturnType;
+export declare const reactHydrate: HydrateOrRenderType;
+export declare function reactRender(domNode: Element, reactElement: ReactElement): RenderReturnType;
+export declare const unmountComponentAtNode: (container: Element) => boolean;
+export declare const ensureReactUseAvailable: () => void;
+export {};
+//# sourceMappingURL=reactApis.d.cts.map

package/lib/webpackHelpers.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reactDomClientWarning = void 0;
+/**
+ * Suppression pattern for the "Module not found: Can't resolve 'react-dom/client'"
+ * warning that webpack emits when building React 16/17 apps with react-on-rails.
+ *
+ * The warning is harmless: react-on-rails detects the React version at runtime and
+ * only calls into react-dom/client when React 18+ is available. But webpack's static
+ * analysis still tries to resolve the conditional require at build time, so the
+ * warning shows up on React 16/17 builds even though the build is healthy.
+ *
+ * Usage in your webpack config (Webpack 5 / Shakapacker):
+ *
+ *   const { reactDomClientWarning } = require('react-on-rails/webpackHelpers');
+ *
+ *   module.exports = {
+ *     // ...
+ *     ignoreWarnings: [reactDomClientWarning],
+ *   };
+ *
+ * Webpack 4 / Webpacker 5 users can pass the same regex to
+ * `stats.warningsFilter` instead, since `ignoreWarnings` is a Webpack 5 option.
+ *
+ * Tracking issue: https://github.com/shakacode/react_on_rails/issues/3137
+ */
+// eslint-disable-next-line import/prefer-default-export -- intentionally named so additional helpers can be added later without a breaking change
+exports.reactDomClientWarning = /Module not found: Error: Can't resolve 'react-dom\/client'/;
+//# sourceMappingURL=webpackHelpers.cjs.map

package/lib/webpackHelpers.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Suppression pattern for the "Module not found: Can't resolve 'react-dom/client'"
+ * warning that webpack emits when building React 16/17 apps with react-on-rails.
+ *
+ * The warning is harmless: react-on-rails detects the React version at runtime and
+ * only calls into react-dom/client when React 18+ is available. But webpack's static
+ * analysis still tries to resolve the conditional require at build time, so the
+ * warning shows up on React 16/17 builds even though the build is healthy.
+ *
+ * Usage in your webpack config (Webpack 5 / Shakapacker):
+ *
+ *   const { reactDomClientWarning } = require('react-on-rails/webpackHelpers');
+ *
+ *   module.exports = {
+ *     // ...
+ *     ignoreWarnings: [reactDomClientWarning],
+ *   };
+ *
+ * Webpack 4 / Webpacker 5 users can pass the same regex to
+ * `stats.warningsFilter` instead, since `ignoreWarnings` is a Webpack 5 option.
+ *
+ * Tracking issue: https://github.com/shakacode/react_on_rails/issues/3137
+ */
+export declare const reactDomClientWarning: RegExp;
+//# sourceMappingURL=webpackHelpers.d.cts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-on-rails",
-  "version": "16.7.0-rc.0",
+  "version": "16.7.0-rc.2",
   "description": "react-on-rails JavaScript for react_on_rails Ruby gem",
   "main": "lib/ReactOnRails.full.js",
   "type": "module",
@@ -30,6 +30,7 @@
     "./createReactOutput": "./lib/createReactOutput.js",
     "./isServerRenderResult": "./lib/isServerRenderResult.js",
     "./reactApis": "./lib/reactApis.cjs",
+    "./webpackHelpers": "./lib/webpackHelpers.cjs",
     "./reactHydrateOrRender": "./lib/reactHydrateOrRender.js",
     "./turbolinksUtils": "./lib/turbolinksUtils.js",
     "./isRenderFunction": "./lib/isRenderFunction.js",
@@ -63,7 +64,8 @@
     "lib/**/*.js",
     "lib/**/*.cjs",
     "lib/**/*.mjs",
-    "lib/**/*.d.ts"
+    "lib/**/*.d.ts",
+    "lib/**/*.d.cts"
   ],
   "bugs": {
     "url": "https://github.com/shakacode/react_on_rails/issues"