react_on_rails 17.1.0.rc.2 → 17.1.0.rc.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 755a6c4b2ac4efd6c1591b88a4bce952b792911ee2a59fb0e9a4e199d3b96330
-  data.tar.gz: 3db2f83572bb6c064b2af1b3b82475f8987ae883d288b5a683a8e776561a6020
+  metadata.gz: 0e7d9c8f6a68c9aeb59fa6094c0a1a26ad619abe7a5a636c83bb5838f4cde0b8
+  data.tar.gz: bee1a6f8dd68cf9f40241125380aecc869cccd3cc79126343b2a0b8642f0d0f1
 SHA512:
-  metadata.gz: 86943c8e0e56d4aac18559eeffc022148faa3d6e42da438e888af5395f9f91a89229414a829400790d5460c7ef32c9f29b2090b321c3a7bd8f919fbcb0279e65
-  data.tar.gz: fd7e49db1ff4ddbdad5619545deba2485c20fe37dc2b26b401ab82d164fbf6c82a1272d87a4bf74d70b1426ff592231021c7f7ec779e4018b7d86940b7fb7cb6
+  metadata.gz: 61992afb879fc1677b1310110b65e542fd7685e10c5242a9328fd791bb1acea99e219c5e75ead0badfe910defb1969863d8db59862e21c7856c7d08f86b5597f
+  data.tar.gz: 8a84822dc47c9ed9168f0db02e5d208df6b97cec9a8478598edcc4211e1fb0776f5dcd7c0b8140328e44c2c6c72c3ff4a3aef6211acb5ec9f8da865376a2b633

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    react_on_rails (17.1.0.rc.2)
+    react_on_rails (17.1.0.rc.3)
       addressable
       connection_pool
       execjs (~> 2.5)

data/lib/generators/react_on_rails/generator_helper.rb

@@ -486,8 +486,10 @@ module GeneratorHelper
     match = react_version.match(/(\d+)\.(\d+)\.(\d+)(?:[-.]([0-9A-Za-z.-]+))?/)
     return nil unless match
 
-    # Return the matched version (without pre-release suffix for comparison)
-    "#{match[1]}.#{match[2]}.#{match[3]}"
+    return nil unless Gem::Version.correct?(match[0])
+
+    # Preserve prerelease identifiers so callers can distinguish stable releases.
+    match[0]
   rescue StandardError
     nil
   end

data/lib/generators/react_on_rails/js_dependency_manager.rb

@@ -145,23 +145,23 @@ module ReactOnRails
       ].freeze
 
       # React Server Components dependencies (only installed when --rsc flag is used)
-      # Requires React 19.2.x with patch >= 19.2.7 - see https://react.dev/reference/rsc/server-components
+      # Requires React 19.2.x with patch >= 19.2.8 - see https://react.dev/reference/rsc/server-components
       RSC_DEPENDENCIES = %w[
         react-on-rails-rsc
       ].freeze
 
       # React peer-dependency range for generated RSC apps. This governs the `react` / `react-dom`
       # installs (see add_react_dependencies) and intentionally stays on the React 19.2.x line
-      # with a 19.2.7 minimum. Do not widen this to later minors just because those releases are
+      # with a 19.2.8 minimum. Do not widen this to later minors just because those releases are
       # current on npm; React's RSC runtime and bundler integration can change between minors.
       #
       # This is intentionally distinct from RSC_PACKAGE_VERSION_PIN below, which pins
       # `react-on-rails-rsc`. Coordination note for #3609: Pro package metadata and generated apps
-      # use the tested React 19.2.x range with the exact stable RSC package pin.
-      RSC_REACT_VERSION_RANGE = "~19.2.7"
-      # Pinned to the stable 19.2.1 package, which carries the coordinated React 19.2.7 RSC peer floor
-      # required by the React on Rails Pro 17 runtime check.
-      RSC_PACKAGE_VERSION_PIN = "19.2.1"
+      # use the tested React 19.2.x range with the exact RSC package pin.
+      RSC_REACT_VERSION_RANGE = "~19.2.8"
+      # Qualify the JSX/TSX loader and Rspack chunk fixes during the 19.3.0 RC soak.
+      # Keep the React 19.2 runtime line independent from the RSC package minor.
+      RSC_PACKAGE_VERSION_PIN = "19.3.0-rc.3"
 
       private
 
@@ -255,7 +255,7 @@ module ReactOnRails
         say "Installing React dependencies..."
 
         # RSC requires the coordinated React 19.2.x patch line.
-        # Pin React to ~19.2.7 while using the matching stable RSC package.
+        # Pin React to ~19.2.8 while using the matching stable RSC package.
         react_deps = if respond_to?(:use_rsc?) && use_rsc?
                        ["react@#{RSC_REACT_VERSION_RANGE}", "react-dom@#{RSC_REACT_VERSION_RANGE}",
                         "prop-types@^15.0.0"]
@@ -451,8 +451,8 @@ module ReactOnRails
         if rsc_package_version_prerelease?
           "React Server Components package pin: all --rsc installs temporarily use " \
             "react-on-rails-rsc@#{RSC_PACKAGE_VERSION_PIN}, including Webpack projects. " \
-            "This prerelease keeps react-on-rails-rsc/WebpackPlugin compatible while adding " \
-            "react-on-rails-rsc/RspackPlugin. Keep the pin until stable " \
+            "This prerelease includes the qualified client-export parsing fixes and " \
+            "react-on-rails-rsc/RspackPlugin splitChunks fix. Keep the pin until stable " \
             "react-on-rails-rsc@#{rsc_stable_package_version_target} " \
             "is published and tagged latest."
         else
@@ -466,9 +466,9 @@ module ReactOnRails
       def rsc_dependency_pin_failed_warning
         if rsc_package_version_prerelease?
           "Warning: Could not install the pinned react-on-rails-rsc@#{RSC_PACKAGE_VERSION_PIN}. " \
-            "All RSC projects are temporarily pinned to that version: the prerelease keeps " \
-            "react-on-rails-rsc/WebpackPlugin compatible while adding react-on-rails-rsc/RspackPlugin, " \
-            "and the unversioned `latest` tag may not include both until stable " \
+            "All RSC projects are temporarily pinned to that version for its client-export parsing " \
+            "and react-on-rails-rsc/RspackPlugin splitChunks fixes. The unversioned `latest` tag " \
+            "does not include these fixes until stable " \
             "#{rsc_stable_package_version_target} " \
             "is published, so the generator left the version pin in package.json rather than " \
             "install a potentially incompatible version."

data/lib/generators/react_on_rails/rsc_setup.rb

@@ -82,9 +82,17 @@ module ReactOnRails
         react_version = detect_react_version
         return if react_version.nil? # React not installed yet, will be installed by generator
 
-        major, minor, patch = react_version.split(".").map(&:to_i)
+        version = Gem::Version.new(react_version)
+        major, minor, patch = version.segments
 
-        if major != RSC_SUPPORTED_REACT_MAJOR || minor != RSC_SUPPORTED_REACT_MINOR
+        if version.prerelease?
+          GeneratorMessages.add_warning(<<~MSG.strip)
+            ⚠️  RSC requires stable React (detected: #{react_version}).
+
+            React prereleases are not supported. Install matching stable React/React DOM versions:
+              #{manual_add_packages_command(["react@#{RSC_REACT_VERSION_RANGE}", "react-dom@#{RSC_REACT_VERSION_RANGE}"])}
+          MSG
+        elsif major != RSC_SUPPORTED_REACT_MAJOR || minor != RSC_SUPPORTED_REACT_MINOR
           GeneratorMessages.add_warning(<<~MSG.strip)
             ⚠️  RSC requires React #{RSC_SUPPORTED_REACT_LINE} (detected: #{react_version})
 
@@ -97,13 +105,14 @@ module ReactOnRails
           MSG
         elsif patch < RSC_MINIMUM_REACT_PATCH
           GeneratorMessages.add_warning(<<~MSG.strip)
-            ⚠️  React #{react_version} is below the recommended minimum for RSC.
+            ⚠️  React #{react_version} is below the required minimum for RSC.
 
-            Please upgrade to at least React #{RSC_MINIMUM_REACT_VERSION}:
-              #{manual_add_packages_command(["react@#{RSC_MINIMUM_REACT_VERSION}", "react-dom@#{RSC_MINIMUM_REACT_VERSION}"])}
+            react-on-rails-rsc #{JsDependencyManager::RSC_PACKAGE_VERSION_PIN} requires
+            matching stable React/React DOM #{RSC_MINIMUM_REACT_VERSION}+ on #{RSC_SUPPORTED_REACT_LINE}.
+            The Node Renderer refuses startup until React and React DOM are upgraded together:
+              #{manual_add_packages_command(["react@#{RSC_REACT_VERSION_RANGE}", "react-dom@#{RSC_REACT_VERSION_RANGE}"])}
 
-            react-on-rails-rsc 19.2.x with patch >= 19.2.1 is coordinated with
-            React/React DOM #{RSC_MINIMUM_REACT_VERSION}+ for the React on Rails Pro 17 RSC runtime.
+            The standalone RSC generator does not upgrade your React or React DOM dependencies.
           MSG
         end
       end

data/lib/react_on_rails/doctor.rb

@@ -4301,7 +4301,9 @@ module ReactOnRails
     RSC_PACKAGE_NAME = "react-on-rails-rsc"
     RSC_MINIMUM_PACKAGE_VERSION = "19.2.1"
     RSC_SUPPORTED_PACKAGE_MAJOR = 19
-    RSC_SUPPORTED_PACKAGE_MINORS = [2].freeze
+    # Package and React minors differ: RSC 19.3 uses the React 19.2.8 runtime.
+    RSC_REACT_MINIMUM_BY_PACKAGE_MINOR = { 2 => "19.2.7", 3 => "19.2.8" }.freeze
+    RSC_SUPPORTED_PACKAGE_MINORS = RSC_REACT_MINIMUM_BY_PACKAGE_MINOR.keys.freeze
     RSC_SUPPORTED_PACKAGE_LINE = RSC_SUPPORTED_PACKAGE_MINORS.map do |minor|
       "#{RSC_SUPPORTED_PACKAGE_MAJOR}.#{minor}.x"
     end.join(" or ")
@@ -4313,7 +4315,10 @@ module ReactOnRails
     RSC_MINIMUM_REACT_VERSION = "19.2.7"
     RSC_MINIMUM_REACT_VERSION_TUPLE = RSC_MINIMUM_REACT_VERSION.split(".").map(&:to_i).freeze
     RSC_SUPPORTED_REACT_MAJOR = RSC_MINIMUM_REACT_VERSION_TUPLE.fetch(0)
-    RSC_SUPPORTED_REACT_LINE = RSC_SUPPORTED_PACKAGE_MINORS.map do |minor|
+    RSC_SUPPORTED_REACT_MINORS = RSC_REACT_MINIMUM_BY_PACKAGE_MINOR.values.map do |version|
+      version.split(".").fetch(1).to_i
+    end.uniq.freeze
+    RSC_SUPPORTED_REACT_LINE = RSC_SUPPORTED_REACT_MINORS.map do |minor|
       "#{RSC_SUPPORTED_REACT_MAJOR}.#{minor}.x"
     end.join(" or ")
     RSC_DIST_TAGS_TO_CHECK = %w[next rc].freeze
@@ -4603,6 +4608,8 @@ module ReactOnRails
       return true unless check_rsc_package_minimum_version(rsc_package)
 
       unless rsc_package_declares_react_peer_dependencies?(rsc_package)
+        return true unless check_rsc_supported_react_packages_for_package(rsc_package, react_version)
+
         checker.add_warning(<<~MSG.strip)
           ⚠️  #{RSC_PACKAGE_NAME} #{rsc_package['version']} does not declare React peer dependencies.
 
@@ -4624,8 +4631,11 @@ module ReactOnRails
       rsc_version = rsc_package["version"].to_s
       return true if rsc_package_version_at_or_above_minimum?(rsc_version)
 
+      react_requirements = RSC_REACT_MINIMUM_BY_PACKAGE_MINOR.map do |minor, minimum|
+        "RSC #{RSC_SUPPORTED_PACKAGE_MAJOR}.#{minor}.x requires stable React/React DOM ~#{minimum}"
+      end.join("; ")
       prerelease_requirement = if RSC_MINIMUM_PACKAGE_PRERELEASE_VERSION.present?
-                                 "\n(or #{RSC_MINIMUM_PACKAGE_PRERELEASE_VERSION} during the 17.0 RC soak)"
+                                 "\n(or #{RSC_MINIMUM_PACKAGE_PRERELEASE_VERSION} during the RC soak)"
                                else
                                  ""
                                end
@@ -4634,10 +4644,10 @@ module ReactOnRails
         🚫 #{RSC_PACKAGE_NAME} #{rsc_version.presence || 'unknown'} is not supported by React on Rails Pro 17 RSC.
 
         React on Rails Pro 17 requires #{RSC_PACKAGE_NAME} >= #{RSC_MINIMUM_PACKAGE_VERSION}#{prerelease_requirement}
-        on the supported #{RSC_SUPPORTED_PACKAGE_LINE} package line
-        with React/React DOM #{RSC_MINIMUM_REACT_VERSION}+.
+        on the supported #{RSC_SUPPORTED_PACKAGE_LINE} package line.
+        #{react_requirements}.
 
-        Fix: npm install react@~#{RSC_MINIMUM_REACT_VERSION} react-dom@~#{RSC_MINIMUM_REACT_VERSION} #{RSC_PACKAGE_NAME}@#{RSC_PACKAGE_INSTALL_VERSION} --save-exact
+        Fix: npm install react@#{ReactOnRails::Generators::JsDependencyManager::RSC_REACT_VERSION_RANGE} react-dom@#{ReactOnRails::Generators::JsDependencyManager::RSC_REACT_VERSION_RANGE} && npm install #{RSC_PACKAGE_NAME}@#{RSC_PACKAGE_INSTALL_VERSION} --save-exact
       MSG
       false
     end
@@ -4665,13 +4675,14 @@ module ReactOnRails
     end
 
     def supported_rsc_react_version?(react_version)
-      supported_rsc_react_line?(react_version) &&
+      npm_prerelease(react_version).empty? &&
+        supported_rsc_react_line?(react_version) &&
         !npm_version_less_than?(react_version, RSC_MINIMUM_REACT_VERSION)
     end
 
     def supported_rsc_react_line?(react_version)
       major, minor, = npm_version_tuple(react_version)
-      major == RSC_SUPPORTED_REACT_MAJOR && RSC_SUPPORTED_PACKAGE_MINORS.include?(minor)
+      major == RSC_SUPPORTED_REACT_MAJOR && RSC_SUPPORTED_REACT_MINORS.include?(minor)
     end
 
     def rsc_react_major_or_newer?(react_version)
@@ -4690,17 +4701,21 @@ module ReactOnRails
 
     def check_rsc_supported_react_version_for_package(rsc_package, package_name, package_version)
       return true if package_version.blank?
-      return true unless unsupported_rsc_react_version?(package_version)
+
+      rsc_minor = npm_version_tuple(rsc_package["version"])[1]
+      minimum_version = RSC_REACT_MINIMUM_BY_PACKAGE_MINOR.fetch(rsc_minor)
+      return true if npm_prerelease(package_version).blank? && supported_rsc_react_line?(package_version) &&
+                     !npm_version_less_than?(package_version, minimum_version)
 
       package_label = package_name == "react" ? "React" : "React DOM"
 
       checker.add_error(<<~MSG.strip)
         🚫 #{RSC_PACKAGE_NAME} #{rsc_package['version']} is installed with unsupported #{package_label} #{package_version}.
 
-        React on Rails Pro 17 RSC currently supports React/React DOM #{RSC_SUPPORTED_REACT_LINE} with patch >= #{RSC_MINIMUM_REACT_VERSION}.
+        React on Rails Pro 17 RSC currently supports stable React/React DOM #{RSC_SUPPORTED_REACT_LINE} with patch >= #{minimum_version}.
         The node renderer enforces the same support window at startup.
 
-        Fix: npm install react@~#{RSC_MINIMUM_REACT_VERSION} react-dom@~#{RSC_MINIMUM_REACT_VERSION} --save-exact
+        Fix: npm install react@~#{minimum_version} react-dom@~#{minimum_version}
       MSG
       false
     end
@@ -4810,7 +4825,8 @@ module ReactOnRails
         checker.add_warning(<<~MSG.strip)
           ⚠️  #{RSC_PACKAGE_NAME} #{installed_version} is behind the npm #{tag} dist-tag #{tag_version}.
 
-          React Server Components track React minor versions. If your React version is on the #{tag_version.split('.')[0, 2].join('.')} line, install the matching RSC package instead of relying on a stale latest tag.
+          Before upgrading, check the candidate package's React peer requirements
+          and the React runtime versions supported by this React on Rails Pro release.
 
           Check peer requirements with:
             npm view #{RSC_PACKAGE_NAME}@#{tag_version} peerDependencies

data/lib/react_on_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ReactOnRails
-  VERSION = "17.1.0.rc.2"
+  VERSION = "17.1.0.rc.3"
 end

data/rakelib/shakapacker_examples.rake

@@ -196,6 +196,14 @@ namespace :shakapacker_examples do # rubocop:disable Metrics/BlockLength
       sh_in_dir(example_type.dir, "touch .gitignore")
       sh_in_dir(example_type.dir,
                 "echo \"gem 'react_on_rails', path: '#{relative_gem_root}'\" >> #{example_type.gemfile}")
+      # json 3.0.0 (2026-09-07) raises ArgumentError on unknown keywords, and Rails < 8.1
+      # ActiveSupport still passes the removed quirks_mode: option to JSON.generate
+      # (fixed upstream in rails/rails#55534; released only in Rails >= 8.1.0).
+      # Self-retires when example apps generate on Rails >= 8.1; also removable if a
+      # json 3.x release restores tolerance for removed keywords.
+      if Gem::Version.new(Rails.version) < Gem::Version.new("8.1")
+        File.write(example_type.gemfile, "gem 'json', '>= 2', '< 3'\n", mode: "a")
+      end
       # Shakapacker is automatically included as a dependency via react_on_rails.gemspec (>= 6.0)
       bundle_install_in(example_type.dir)
       # Use unbundled_sh_in_dir to ensure we're using the generated app's Gemfile

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails
 version: !ruby/object:Gem::Version
-  version: 17.1.0.rc.2
+  version: 17.1.0.rc.3
 platform: ruby
 authors:
 - Justin Gordon