react_on_rails 16.3.0 → 16.4.0.rc.0

data/lib/react_on_rails/smart_error.rb

@@ -25,6 +25,8 @@ module ReactOnRails
         component_not_registered_solution
       when :missing_auto_loaded_bundle
         missing_auto_loaded_bundle_solution
+      when :missing_auto_loaded_store_bundle
+        missing_auto_loaded_store_bundle_solution
       when :hydration_mismatch
         hydration_mismatch_solution
       when :server_rendering_error
@@ -64,6 +66,8 @@ module ReactOnRails
         "Component '#{component_name}' Not Registered"
       when :missing_auto_loaded_bundle
         "Auto-loaded Bundle Missing"
+      when :missing_auto_loaded_store_bundle
+        "Auto-loaded Store Bundle Missing"
       when :hydration_mismatch
         "Hydration Mismatch"
       when :server_rendering_error
@@ -93,6 +97,11 @@ module ReactOnRails
           Component '#{component_name}' is configured for auto-loading but its bundle is missing.
           Expected location: #{additional_context[:expected_path]}
         DESC
+      when :missing_auto_loaded_store_bundle
+        <<~DESC
+          Redux store '#{component_name}' is configured for auto-loading but its bundle is missing.
+          Expected location: #{additional_context[:expected_path]}
+        DESC
       when :hydration_mismatch
         <<~DESC
           The server-rendered HTML doesn't match what React rendered on the client.
@@ -182,6 +191,23 @@ module ReactOnRails
       SOLUTION
     end
 
+    def missing_auto_loaded_store_bundle_solution
+      <<~SOLUTION
+        1. Run the pack generation task:
+           #{Rainbow('bundle exec rake react_on_rails:generate_packs').cyan}
+
+        2. Ensure your store is in a directory matching stores_subdirectory under packer_source_path:
+           #{Rainbow("#{ReactOnRails::PackerUtils.packer_source_path}/**/#{ReactOnRails.configuration.stores_subdirectory || 'ror_stores'}/#{component_name}.js").cyan}
+
+        3. Check that the store file follows naming conventions:
+           - Store file: #{Rainbow("#{component_name}.js").cyan} or #{Rainbow("#{component_name}.ts").cyan}
+           - Must export default a store generator function
+
+        4. Verify stores_subdirectory is configured:
+           #{Rainbow("config.stores_subdirectory = 'ror_stores'").cyan}
+      SOLUTION
+    end
+
     def hydration_mismatch_solution
       <<~SOLUTION
         Common causes and solutions:

data/lib/react_on_rails/test_helper.rb

@@ -26,7 +26,7 @@ module ReactOnRails
     # faster. The helper looks for these processes and will abort recompiling if it finds them
     # to be running.
     #
-    # See docs/additional-reading/rspec-configuration.md for more info
+    # See docs/building-features/testing-configuration.md for more info
     #
     # Params:
     # config - config for rspec

data/lib/react_on_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ReactOnRails
-  VERSION = "16.3.0"
+  VERSION = "16.4.0.rc.0"
 end

data/lib/react_on_rails/version_checker.rb

@@ -154,7 +154,8 @@ module ReactOnRails
     end
 
     def validate_exact_version!
-      return if node_package_version.raw.nil? || node_package_version.local_path_or_url?
+      return if node_package_version.raw.nil? || node_package_version.local_path_or_url? ||
+                node_package_version.workspace_protocol?
 
       return unless node_package_version.semver_wildcard?
 
@@ -178,7 +179,8 @@ module ReactOnRails
     end
 
     def validate_version_match!
-      return if node_package_version.raw.nil? || node_package_version.local_path_or_url?
+      return if node_package_version.raw.nil? || node_package_version.local_path_or_url? ||
+                node_package_version.workspace_protocol?
 
       return if node_package_version.parts == gem_version_parts
 
@@ -324,8 +326,14 @@ module ReactOnRails
         !raw.nil? && raw.include?("/") && !raw.start_with?("npm:")
       end
 
+      def workspace_protocol?
+        # pnpm workspace protocol: workspace:* or workspace:^
+        # Used for monorepo internal dependencies
+        !raw.nil? && raw.start_with?("workspace:")
+      end
+
       def parts
-        return if local_path_or_url?
+        return if local_path_or_url? || workspace_protocol?
 
         match = raw.match(VERSION_PARTS_REGEX)
         unless match

data/lib/tasks/generate_packs.rake

@@ -3,16 +3,17 @@
 # rubocop:disable Metrics/BlockLength
 namespace :react_on_rails do
   desc <<~DESC
-    If there is a file inside any directory matching config.components_subdirectory, this command generates corresponding packs.
+    If there is a file inside any directory matching config.components_subdirectory or
+    config.stores_subdirectory, this command generates corresponding packs.
 
     This task will:
     - Clean out existing generated directories (javascript/generated and javascript/packs/generated)
     - List all files being deleted for transparency
-    - Generate new pack files for discovered React components
+    - Generate new pack files for discovered React components and Redux stores
     - Skip generation if files are already up to date
 
     Generated directories:
-    - app/javascript/packs/generated/ (client pack files)
+    - app/javascript/packs/generated/ (client pack files for components and stores)
     - app/javascript/generated/ (server bundle files)
   DESC
 
@@ -23,6 +24,9 @@ namespace :react_on_rails do
       puts Rainbow("🚀 Starting React on Rails pack generation...").bold
       puts Rainbow("📁 Auto-load bundle: #{ReactOnRails.configuration.auto_load_bundle}").cyan
       puts Rainbow("📂 Components subdirectory: #{ReactOnRails.configuration.components_subdirectory}").cyan
+      if ReactOnRails.configuration.stores_subdirectory.present?
+        puts Rainbow("📂 Stores subdirectory: #{ReactOnRails.configuration.stores_subdirectory}").cyan
+      end
       puts ""
     end
 

data/rakelib/dummy_apps.rake

@@ -6,9 +6,9 @@ namespace :dummy_apps do
   include ReactOnRails::TaskHelpers
 
   task :pnpm_install do
-    pnpm_install_cmd = "pnpm install"
-    sh_in_dir(dummy_app_dir, pnpm_install_cmd)
-    sh_in_dir(dummy_app_dir, "yalc link react-on-rails")
+    # Dummy apps are now part of the pnpm workspace, so install must run from the workspace root.
+    # Running `pnpm install` from a workspace member directory doesn't resolve other workspace packages.
+    sh_in_dir(monorepo_root, "pnpm install")
   end
 
   task dummy_app: [:pnpm_install] do

data/rakelib/node_package.rake

@@ -6,10 +6,10 @@ namespace :node_package do
   include ReactOnRails::TaskHelpers
 
   task :build do
-    puts "Building Node Package and running 'yalc publish'"
-    sh "pnpm run build && pnpm yalc:publish"
+    puts "Building Node Package"
+    sh "pnpm run build"
   end
 end
 
-desc "Prepares node_package by building and symlinking any example/dummy apps present"
+desc "Prepares node_package by building the TypeScript to JavaScript"
 task node_package: "node_package:build"

data/rakelib/rbs.rake

@@ -18,7 +18,7 @@ namespace :rbs do
     # spawned shell commands via Open3.capture3() do NOT inherit bundle context
     # Wrap in Timeout to prevent hung processes in CI environments (60 second timeout)
     stdout, stderr, status = Timeout.timeout(60) do
-      Open3.capture3("bundle exec rbs -I sig validate")
+      Open3.capture3("bundle exec rbs -I sig -r pathname validate")
     end
 
     if status.success?

data/rakelib/shakapacker_examples.rake

@@ -49,7 +49,7 @@ namespace :shakapacker_examples do # rubocop:disable Metrics/BlockLength
     # automatically included as a dependency in older Shakapacker versions
     dev_deps["@babel/plugin-transform-runtime"] = "^7.24.0" if dev_deps
 
-    # Add npm overrides to force specific React version, preventing yalc-linked
+    # Add npm overrides to force specific React version, preventing
     # react-on-rails from pulling in React 19 as a transitive dependency
     package_json["overrides"] = {
       "react" => react_version,
@@ -87,7 +87,9 @@ namespace :shakapacker_examples do # rubocop:disable Metrics/BlockLength
                 "echo \"gem 'react_on_rails', path: '#{relative_gem_root}'\" >> #{example_type.gemfile}")
       # Shakapacker is automatically included as a dependency via react_on_rails.gemspec (>= 6.0)
       bundle_install_in(example_type.dir)
-      sh_in_dir(example_type.dir, "rake shakapacker:install")
+      # Use unbundled_sh_in_dir to ensure we're using the generated app's Gemfile
+      # and gem versions, not the parent workspace's bundle context.
+      unbundled_sh_in_dir(example_type.dir, "bundle exec rake shakapacker:install")
       # Skip validation when running generators on example apps during development.
       # The generator validates that certain config options exist in the initializer,
       # but during example generation, we're often testing against the current gem
@@ -97,7 +99,9 @@ namespace :shakapacker_examples do # rubocop:disable Metrics/BlockLength
       generator_commands = example_type.generator_shell_commands.map do |cmd|
         "REACT_ON_RAILS_SKIP_VALIDATION=true #{cmd}"
       end
-      sh_in_dir(example_type.dir, generator_commands)
+      # Use unbundled_sh_in_dir to ensure the generator uses the example app's
+      # gem versions, not the parent workspace's cached bundle context.
+      unbundled_sh_in_dir(example_type.dir, generator_commands)
       # Re-run bundle install since dev_tests generator adds rspec-rails and coveralls to Gemfile
       bundle_install_in(example_type.dir)
 
@@ -109,14 +113,18 @@ namespace :shakapacker_examples do # rubocop:disable Metrics/BlockLength
         # Run npm install BEFORE shakapacker:binstubs to ensure the npm shakapacker version
         # matches the gem version. The binstubs task loads the Rails environment which
         # validates version matching between gem and npm package.
-        # Use --legacy-peer-deps to avoid peer dependency conflicts when yalc-linked
+        # Use --legacy-peer-deps to avoid peer dependency conflicts when
         # react-on-rails expects newer React versions
-        sh_in_dir(example_type.dir, "npm install --legacy-peer-deps")
+        # Use --install-links to copy file: dependencies instead of symlinking,
+        # preventing duplicate React instances from webpack resolving through symlinks
+        sh_in_dir(example_type.dir, "npm install --legacy-peer-deps --install-links")
         # Regenerate Shakapacker binstubs after downgrading from 9.x to 8.2.x
         # The binstub format may differ between major versions
         unbundled_sh_in_dir(example_type.dir, "bundle exec rake shakapacker:binstubs")
       else
-        sh_in_dir(example_type.dir, "npm install")
+        # Use --install-links to copy file: dependencies instead of symlinking,
+        # preventing duplicate React instances from webpack resolving through symlinks
+        sh_in_dir(example_type.dir, "npm install --install-links")
       end
       # Generate the component packs after running the generator to ensure all
       # auto-bundled components have corresponding pack files created.

data/sig/react_on_rails/configuration.rbs

@@ -14,6 +14,7 @@ module ReactOnRails
     attr_accessor generated_assets_dirs: Array[String]?
     attr_accessor generated_assets_dir: String
     attr_accessor components_subdirectory: String?
+    attr_accessor stores_subdirectory: String?
     attr_accessor webpack_generated_files: Array[String]
     attr_accessor rendering_extension: String?
     attr_accessor build_test_command: String
@@ -65,6 +66,7 @@ module ReactOnRails
       ?server_render_method: String?,
       ?rendering_props_extension: String?,
       ?components_subdirectory: String?,
+      ?stores_subdirectory: String?,
       ?auto_load_bundle: bool?,
       ?immediate_hydration: bool?,
       ?component_registry_timeout: Integer?,

data/sig/react_on_rails/dev/database_checker.rbs

@@ -0,0 +1,27 @@
+module ReactOnRails
+  module Dev
+    class DatabaseChecker
+      # Result of a database check.
+      # - :ok — database is accessible and ready
+      # - :error — database is missing, inaccessible, or misconfigured
+      # - :not_rails_app — bin/rails was not found (non-Rails project)
+      # - :unknown_error — an unexpected exception occurred during the check
+      type check_result = { status: Symbol, error?: String }
+
+      def self.check_database: (?skip: bool) -> bool
+
+      private
+
+      def self.should_skip_check?: (bool) -> bool
+      def self.run_database_check: () -> check_result
+      def self.parse_check_result: (String, String, Process::Status) -> check_result
+      def self.check_pending_migrations: () -> void
+      def self.print_checking_message: () -> void
+      def self.print_database_ok: () -> void
+      def self.print_skipped_message: (String) -> void
+      def self.print_pending_migrations_warning: () -> void
+      def self.print_database_error: (String?) -> void
+      def self.truncate_error: (String) -> String
+    end
+  end
+end

data/sig/react_on_rails/packer_utils.rbs

@@ -5,8 +5,12 @@ module ReactOnRails
     def self.nested_entries?: () -> bool
     def self.packer_public_output_path: () -> String
     def self.precompile?: () -> bool
+    def self.extract_precompile_hook: () -> String?
+    def self.hook_contains_generate_packs?: (String? hook_value) -> bool
     def self.shakapacker_precompile_hook_configured?: () -> bool
-    def self.shakapacker_precompile_hook_value: () -> String
+    def self.shakapacker_precompile_hook_value: () -> String?
+    def self.hook_script_has_self_guard?: (String? hook_value) -> bool
+    def self.resolve_hook_script_path: (String? hook_value) -> Pathname?
     def self.raise_shakapacker_version_incompatible_for_autobundling: () -> void
     def self.raise_nested_entries_disabled: () -> void
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails
 version: !ruby/object:Gem::Version
-  version: 16.3.0
+  version: 16.4.0.rc.0
 platform: ruby
 authors:
 - Justin Gordon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-06 00:00:00.000000000 Z
+date: 2026-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -191,6 +191,7 @@ files:
 - lib/react_on_rails/configuration.rb
 - lib/react_on_rails/controller.rb
 - lib/react_on_rails/dev.rb
+- lib/react_on_rails/dev/database_checker.rb
 - lib/react_on_rails/dev/file_manager.rb
 - lib/react_on_rails/dev/pack_generator.rb
 - lib/react_on_rails/dev/process_manager.rb
@@ -244,6 +245,7 @@ files:
 - sig/react_on_rails.rbs
 - sig/react_on_rails/configuration.rbs
 - sig/react_on_rails/controller.rbs
+- sig/react_on_rails/dev/database_checker.rbs
 - sig/react_on_rails/dev/file_manager.rbs
 - sig/react_on_rails/dev/pack_generator.rbs
 - sig/react_on_rails/dev/process_manager.rbs