react_on_rails 16.2.0.beta.8 → 16.2.0.beta.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2d569c0148019a12155710806cbd6f3d94f6641ffd074099dc9b4255b0202d6
-  data.tar.gz: 8abd5fedee13d2d2d1bfa6fc6a03e8a6d11710ece7fb84b26fb3afc387156d75
+  metadata.gz: da10987e43490e2a8da60fccb2033038aa9fa6a9b5ccce9add3f9d0da795474c
+  data.tar.gz: 9e7a3a46c8bb8e0fcc57142b5a1218ea58d5155d54614038d035e2e6b39fdf47
 SHA512:
-  metadata.gz: 22ef214ab6d5c12257a9ebc3fbf01c56c4211405ac4398628b1d69813d236d39dfe02d48168d4fabb0a0eb5d54ce624fb37790776952e4300547e502170432a4
-  data.tar.gz: e1fdf86179a42c10af444265839d2e95fe15b3771f0606038ce1c01611efcd96c03d34c1e94682b718b6011c6f0d9c049b59b1713bdb75fa942a23e08e0c60b2
+  metadata.gz: d9f6d5be2b5bf2437adc711b6ac77e64fb7c6540d34bdce6380e98bf919872ec59e897b87869e25221f1f461ac91b25fc146c48701eb161630cb9bea7c44c7a1
+  data.tar.gz: 5ec66977d53c808a8983277c6534e24fe966123105c4738e20995a9bb45be34a139030fe3e70ffe3251bb9961470371841bea040e558deb3fc974c154d6bdb7d

data/CHANGELOG.md

@@ -23,17 +23,11 @@ After a release, please make sure to run `bundle exec rake update_changelog`. Th
 
 Changes since the last non-beta release.
 
-#### Changed
-
-- **Generator Configuration Modernization**: Updated the generator to enable recommended configurations by default for new applications:
-
-  - `config.build_test_command` is now uncommented and set to `"RAILS_ENV=test bin/shakapacker"` by default, enabling automatic asset building during tests for better integration test reliability
-  - `config.auto_load_bundle = true` is now set by default, enabling automatic loading of component bundles
-  - `config.components_subdirectory = "ror_components"` is now set by default, organizing React components in a dedicated subdirectory
+#### Fixed
 
-  **Note:** These changes only affect newly generated applications. Existing applications are unaffected and do not need to make any changes. If you want to adopt these settings in an existing app, you can manually add them to your `config/initializers/react_on_rails.rb` file. [PR 2039](https://github.com/shakacode/react_on_rails/pull/2039) by [justin808](https://github.com/justin808).
+- **Duplicate Rake Task Execution**: Fixed rake tasks executing twice during asset precompilation and other rake operations. Rails Engine was loading task files twice: once via explicit `load` calls in the `rake_tasks` block (Railtie layer) and once via automatic file loading from `lib/tasks/` (Engine layer). This caused `react_on_rails:assets:webpack`, `react_on_rails:generate_packs`, and `react_on_rails:locale` tasks to run twice, significantly increasing build times. Removed explicit `load` calls and now rely on Rails Engine's standard auto-loading behavior. [PR 2052](https://github.com/shakacode/react_on_rails/pull/2052) by [justin808](https://github.com/justin808).
 
-### [16.2.0.beta.4] - 2025-11-12
+### [v16.2.0.beta.8] - 2025-11-16
 
 #### Added
 
@@ -49,6 +43,8 @@ Changes since the last non-beta release.
 
 - **Use as Git dependency**: All packages can now be installed as Git dependencies. This is useful for development and testing purposes. See [CONTRIBUTING.md](./CONTRIBUTING.md#git-dependencies) for documentation. [PR #1873](https://github.com/shakacode/react_on_rails/pull/1873) by [alexeyr-ci2](https://github.com/alexeyr-ci2).
 
+- **Doctor Checks for :async Loading Strategy**: Added proactive diagnostic checks to the React on Rails doctor tool to detect usage of the `:async` loading strategy in projects without React on Rails Pro. The feature scans view files and initializer configuration, providing clear guidance to either upgrade to Pro or use alternative loading strategies like `:defer` or `:sync` to avoid component registration race conditions. [PR 2010](https://github.com/shakacode/react_on_rails/pull/2010) by [justin808](https://github.com/justin808).
+
 #### Changed
 
 - **Shakapacker 9.0.0 Upgrade**: Upgraded Shakapacker from 8.2.0 to 9.0.0 with Babel transpiler configuration for compatibility. Key changes include:
@@ -63,6 +59,10 @@ Changes since the last non-beta release.
 
 - **`generated_component_packs_loading_strategy` now defaults based on Pro license**: When using Shakapacker >= 8.2.0, the default loading strategy is now `:async` for Pro users and `:defer` for non-Pro users. This provides optimal performance for Pro users while maintaining compatibility for non-Pro users. You can still explicitly set the strategy in your configuration. [PR #1993](https://github.com/shakacode/react_on_rails/pull/1993) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
 
+- **Generator Configuration Modernization**: Updated the generator to enable recommended configurations by default for new applications. `config.build_test_command` is now uncommented and set to `"RAILS_ENV=test bin/shakapacker"` by default, enabling automatic asset building during tests for better integration test reliability. `config.auto_load_bundle = true` is now set by default, enabling automatic loading of component bundles. `config.components_subdirectory = "ror_components"` is now set by default, organizing React components in a dedicated subdirectory. **Note:** These changes only affect newly generated applications. Existing applications are unaffected and do not need to make any changes. If you want to adopt these settings in an existing app, you can manually add them to your `config/initializers/react_on_rails.rb` file. [PR 2039](https://github.com/shakacode/react_on_rails/pull/2039) by [justin808](https://github.com/justin808).
+
+- **Removed Babel Dependency Installation**: The generator no longer installs `@babel/preset-react` or `@babel/preset-typescript` packages. Shakapacker handles JavaScript transpiler configuration (Babel, SWC, or esbuild) via the `javascript_transpiler` setting in `shakapacker.yml`. SWC is now the default transpiler and includes built-in support for React and TypeScript. Users who explicitly choose Babel will need to manually install and configure the required presets. This change reduces unnecessary dependencies and aligns with Shakapacker's modular transpiler approach. [PR 2051](https://github.com/shakacode/react_on_rails/pull/2051) by [justin808](https://github.com/justin808).
+
 #### Documentation
 
 - **Simplified Configuration Files**: Improved configuration documentation and generator template for better clarity and usability. Reduced generator template from 67 to 42 lines (37% reduction). Added comprehensive testing configuration guide. Reorganized configuration docs into Essential vs Advanced sections. Enhanced Doctor program with diagnostics for server rendering and test compilation consistency. [PR #2011](https://github.com/shakacode/react_on_rails/pull/2011) by [justin808](https://github.com/justin808).
@@ -77,6 +77,14 @@ Changes since the last non-beta release.
 
 - **Body Duplication Bug On Streaming**: Fixed a bug that happens while streaming if the node renderer connection closed after streaming some chunks to the client. [PR #1995](https://github.com/shakacode/react_on_rails/pull/1995) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
 
+- **bin/dev --verbose Option**: Fixed `OptionParser::InvalidOption` error that occurred when using the `--verbose`/`-v` flag. The flag was documented in help text but not functional. Now properly implemented with flag parsing and passing verbose option through method calls. [PR 2023](https://github.com/shakacode/react_on_rails/pull/2023) by [justin808](https://github.com/justin808).
+
+- **Shakapacker Template Configuration**: Fixed shakapacker.yml template to prevent unnecessary "Slow setup for development" warnings by setting `compile: false` as the default configuration. This allows development environments to inherit the setting instead of forcing on-demand compilation when using Procfiles with `bin/dev` that already run the shakapacker dev server or watch mode. [PR 2021](https://github.com/shakacode/react_on_rails/pull/2021) by [justin808](https://github.com/justin808).
+
+#### Improved
+
+- **Concurrent Streaming Performance**: Implemented concurrent draining of streamed React components using the async gem. Instead of processing components sequentially, the system now uses a producer-consumer pattern with bounded buffering to allow multiple components to stream simultaneously while maintaining per-component chunk ordering. [PR 2015](https://github.com/shakacode/react_on_rails/pull/2015) by [ihabadham](https://github.com/ihabadham).
+
 #### Breaking Changes
 
 - **`config.immediate_hydration` configuration removed**: The `config.immediate_hydration` setting in `config/initializers/react_on_rails.rb` has been removed. Immediate hydration is now automatically enabled for React on Rails Pro users and automatically disabled for non-Pro users.
@@ -1837,7 +1845,8 @@ such as:
 
 - Fix several generator-related issues.
 
-[unreleased]: https://github.com/shakacode/react_on_rails/compare/16.2.0.beta.4...master
+[unreleased]: https://github.com/shakacode/react_on_rails/compare/v16.2.0.beta.8...master
+[v16.2.0.beta.8]: https://github.com/shakacode/react_on_rails/compare/16.2.0.beta.4...v16.2.0.beta.8
 [16.2.0.beta.4]: https://github.com/shakacode/react_on_rails/compare/16.1.1...16.2.0.beta.4
 [16.1.1]: https://github.com/shakacode/react_on_rails/compare/16.1.0...16.1.1
 [16.1.0]: https://github.com/shakacode/react_on_rails/compare/16.0.0...16.1.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    react_on_rails (16.2.0.beta.8)
+    react_on_rails (16.2.0.beta.10)
       addressable
       connection_pool
       execjs (~> 2.5)

data/knip.ts

@@ -162,7 +162,7 @@ const config: KnipConfig = {
         'url-loader',
         // Transitive dependency of shakapacker but listed as direct dependency
         'webpack-merge',
-        // Dependencies not detected in production mode
+        // Dependencies not detected in production mode (runtime injected or dynamic imports)
         '@babel/runtime',
         'mini-css-extract-plugin',
         'css-loader',

data/lib/generators/react_on_rails/base_generator.rb

@@ -4,10 +4,12 @@ require "rails/generators"
 require "fileutils"
 require_relative "generator_messages"
 require_relative "generator_helper"
+require_relative "js_dependency_manager"
 module ReactOnRails
   module Generators
     class BaseGenerator < Rails::Generators::Base
       include GeneratorHelper
+      include JsDependencyManager
 
       Rails::Generators.hide_namespace(namespace)
       source_root(File.expand_path("templates", __dir__))
@@ -107,7 +109,7 @@ module ReactOnRails
         run "bundle"
       end
 
-      def update_gitignore_for_generated_bundles
+      def update_gitignore_for_auto_registration
         gitignore_path = File.join(destination_root, ".gitignore")
         return unless File.exist?(gitignore_path)
 
@@ -146,123 +148,6 @@ module ReactOnRails
 
       private
 
-      def setup_js_dependencies
-        add_js_dependencies
-        install_js_dependencies
-      end
-
-      def add_js_dependencies
-        add_react_on_rails_package
-        add_react_dependencies
-        add_css_dependencies
-        add_dev_dependencies
-      end
-
-      def add_react_on_rails_package
-        major_minor_patch_only = /\A\d+\.\d+\.\d+\z/
-
-        # Try to use package_json gem first, fall back to direct npm commands
-        react_on_rails_pkg = if ReactOnRails::VERSION.match?(major_minor_patch_only)
-                               ["react-on-rails@#{ReactOnRails::VERSION}"]
-                             else
-                               puts "Adding the latest react-on-rails NPM module. " \
-                                    "Double check this is correct in package.json"
-                               ["react-on-rails"]
-                             end
-
-        puts "Installing React on Rails package..."
-        return if add_npm_dependencies(react_on_rails_pkg)
-
-        puts "Using direct npm commands as fallback"
-        success = system("npm", "install", *react_on_rails_pkg)
-        handle_npm_failure("react-on-rails package", react_on_rails_pkg) unless success
-      end
-
-      def add_react_dependencies
-        puts "Installing React dependencies..."
-        react_deps = %w[
-          react
-          react-dom
-          @babel/preset-react
-          prop-types
-          babel-plugin-transform-react-remove-prop-types
-          babel-plugin-macros
-        ]
-        return if add_npm_dependencies(react_deps)
-
-        success = system("npm", "install", *react_deps)
-        handle_npm_failure("React dependencies", react_deps) unless success
-      end
-
-      def add_css_dependencies
-        puts "Installing CSS handling dependencies..."
-        css_deps = %w[
-          css-loader
-          css-minimizer-webpack-plugin
-          mini-css-extract-plugin
-          style-loader
-        ]
-        return if add_npm_dependencies(css_deps)
-
-        success = system("npm", "install", *css_deps)
-        handle_npm_failure("CSS dependencies", css_deps) unless success
-      end
-
-      def add_dev_dependencies
-        puts "Installing development dependencies..."
-        dev_deps = %w[
-          @pmmmwh/react-refresh-webpack-plugin
-          react-refresh
-        ]
-        return if add_npm_dependencies(dev_deps, dev: true)
-
-        success = system("npm", "install", "--save-dev", *dev_deps)
-        handle_npm_failure("development dependencies", dev_deps, dev: true) unless success
-      end
-
-      def install_js_dependencies
-        # Detect which package manager to use
-        success = if File.exist?(File.join(destination_root, "yarn.lock"))
-                    system("yarn", "install")
-                  elsif File.exist?(File.join(destination_root, "pnpm-lock.yaml"))
-                    system("pnpm", "install")
-                  elsif File.exist?(File.join(destination_root, "package-lock.json")) ||
-                        File.exist?(File.join(destination_root, "package.json"))
-                    # Use npm for package-lock.json or as default fallback
-                    system("npm", "install")
-                  else
-                    true # No package manager detected, skip
-                  end
-
-        unless success
-          GeneratorMessages.add_warning(<<~MSG.strip)
-            ⚠️  JavaScript dependencies installation failed.
-
-            This could be due to network issues or missing package manager.
-            You can install dependencies manually later by running:
-            • npm install (if using npm)
-            • yarn install (if using yarn)
-            • pnpm install (if using pnpm)
-          MSG
-        end
-
-        success
-      end
-
-      def handle_npm_failure(dependency_type, packages, dev: false)
-        install_command = dev ? "npm install --save-dev" : "npm install"
-        GeneratorMessages.add_warning(<<~MSG.strip)
-          ⚠️  Failed to install #{dependency_type}.
-
-          The following packages could not be installed automatically:
-          #{packages.map { |pkg| "  • #{pkg}" }.join("\n")}
-
-          This could be due to network issues or missing package manager.
-          You can install them manually later by running:
-            #{install_command} #{packages.join(' ')}
-        MSG
-      end
-
       def copy_webpack_main_config(base_path, config)
         webpack_config_path = "config/webpack/webpack.config.js"
 

data/lib/generators/react_on_rails/install_generator.rb

@@ -4,12 +4,14 @@ require "rails/generators"
 require "json"
 require_relative "generator_helper"
 require_relative "generator_messages"
+require_relative "js_dependency_manager"
 
 module ReactOnRails
   module Generators
     # rubocop:disable Metrics/ClassLength
     class InstallGenerator < Rails::Generators::Base
       include GeneratorHelper
+      include JsDependencyManager
 
       # fetch USAGE file for details generator description
       source_root(File.expand_path(__dir__))
@@ -113,10 +115,7 @@ module ReactOnRails
       end
 
       def setup_react_dependencies
-        @added_dependencies_to_package_json ||= false
-        @ran_direct_installs ||= false
-        add_js_dependencies
-        install_js_dependencies if @added_dependencies_to_package_json && !@ran_direct_installs
+        setup_js_dependencies
       end
 
       # NOTE: other requirements for existing files such as .gitignore or application.
@@ -366,29 +365,8 @@ module ReactOnRails
 
       def install_typescript_dependencies
         puts Rainbow("📝 Installing TypeScript dependencies...").yellow
-
-        # Install TypeScript and React type definitions
-        typescript_packages = %w[
-          typescript
-          @types/react
-          @types/react-dom
-          @babel/preset-typescript
-        ]
-
-        # Try using GeneratorHelper first (package manager agnostic)
-        return if add_npm_dependencies(typescript_packages, dev: true)
-
-        # Fallback to npm if GeneratorHelper fails
-        success = system("npm", "install", "--save-dev", *typescript_packages)
-        return if success
-
-        warning = <<~MSG.strip
-          ⚠️  Failed to install TypeScript dependencies automatically.
-
-          Please run manually:
-              npm install --save-dev #{typescript_packages.join(' ')}
-        MSG
-        GeneratorMessages.add_warning(warning)
+        # Delegate to shared module for consistent dependency management
+        add_typescript_dependencies
       end
 
       def create_css_module_types
@@ -450,159 +428,6 @@ module ReactOnRails
         puts Rainbow("✅ Created tsconfig.json").green
       end
 
-      def add_js_dependencies
-        add_react_on_rails_package
-        add_react_dependencies
-        add_css_dependencies
-        add_rspack_dependencies if options.rspack?
-        add_dev_dependencies
-      end
-
-      def add_react_on_rails_package
-        major_minor_patch_only = /\A\d+\.\d+\.\d+\z/
-
-        # Try to use package_json gem first, fall back to direct npm commands
-        react_on_rails_pkg = if ReactOnRails::VERSION.match?(major_minor_patch_only)
-                               ["react-on-rails@#{ReactOnRails::VERSION}"]
-                             else
-                               puts "Adding the latest react-on-rails NPM module. " \
-                                    "Double check this is correct in package.json"
-                               ["react-on-rails"]
-                             end
-
-        puts "Installing React on Rails package..."
-        if add_npm_dependencies(react_on_rails_pkg)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        puts "Using direct npm commands as fallback"
-        success = system("npm", "install", *react_on_rails_pkg)
-        @ran_direct_installs = true if success
-        handle_npm_failure("react-on-rails package", react_on_rails_pkg) unless success
-      end
-
-      def add_react_dependencies
-        puts "Installing React dependencies..."
-        react_deps = %w[
-          react
-          react-dom
-          @babel/preset-react
-          prop-types
-          babel-plugin-transform-react-remove-prop-types
-          babel-plugin-macros
-        ]
-        if add_npm_dependencies(react_deps)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", *react_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("React dependencies", react_deps) unless success
-      end
-
-      def add_css_dependencies
-        puts "Installing CSS handling dependencies..."
-        css_deps = %w[
-          css-loader
-          css-minimizer-webpack-plugin
-          mini-css-extract-plugin
-          style-loader
-        ]
-        if add_npm_dependencies(css_deps)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", *css_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("CSS dependencies", css_deps) unless success
-      end
-
-      def add_rspack_dependencies
-        puts "Installing Rspack core dependencies..."
-        rspack_deps = %w[
-          @rspack/core
-          rspack-manifest-plugin
-        ]
-        if add_npm_dependencies(rspack_deps)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", *rspack_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("Rspack dependencies", rspack_deps) unless success
-      end
-
-      def add_dev_dependencies
-        puts "Installing development dependencies..."
-        dev_deps = if options.rspack?
-                     %w[
-                       @rspack/cli
-                       @rspack/plugin-react-refresh
-                       react-refresh
-                     ]
-                   else
-                     %w[
-                       @pmmmwh/react-refresh-webpack-plugin
-                       react-refresh
-                     ]
-                   end
-        if add_npm_dependencies(dev_deps, dev: true)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", "--save-dev", *dev_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("development dependencies", dev_deps, dev: true) unless success
-      end
-
-      def install_js_dependencies
-        # Detect which package manager to use
-        success = if File.exist?(File.join(destination_root, "yarn.lock"))
-                    system("yarn", "install")
-                  elsif File.exist?(File.join(destination_root, "pnpm-lock.yaml"))
-                    system("pnpm", "install")
-                  elsif File.exist?(File.join(destination_root, "package-lock.json")) ||
-                        File.exist?(File.join(destination_root, "package.json"))
-                    # Use npm for package-lock.json or as default fallback
-                    system("npm", "install")
-                  else
-                    true # No package manager detected, skip
-                  end
-
-        unless success
-          GeneratorMessages.add_warning(<<~MSG.strip)
-            ⚠️  JavaScript dependencies installation failed.
-
-            This could be due to network issues or missing package manager.
-            You can install dependencies manually later by running:
-            • npm install (if using npm)
-            • yarn install (if using yarn)
-            • pnpm install (if using pnpm)
-          MSG
-        end
-
-        success
-      end
-
-      def handle_npm_failure(dependency_type, packages, dev: false)
-        install_command = dev ? "npm install --save-dev" : "npm install"
-        GeneratorMessages.add_warning(<<~MSG.strip)
-          ⚠️  Failed to install #{dependency_type}.
-
-          The following packages could not be installed automatically:
-          #{packages.map { |pkg| "  • #{pkg}" }.join("\n")}
-
-          This could be due to network issues or missing package manager.
-          You can install them manually later by running:
-            #{install_command} #{packages.join(' ')}
-        MSG
-      end
-
       # Removed: Shakapacker auto-installation logic (now explicit dependency)
 
       # Removed: Shakapacker 8+ is now required as explicit dependency

data/lib/generators/react_on_rails/js_dependency_manager.rb

@@ -0,0 +1,332 @@
+# frozen_string_literal: true
+
+require_relative "generator_messages"
+
+# rubocop:disable Metrics/ModuleLength
+module ReactOnRails
+  module Generators
+    # Shared module for managing JavaScript dependencies across generators
+    # This module provides common functionality for adding and installing
+    # JS dependencies to avoid code duplication between generators.
+    #
+    # Since react_on_rails requires shakapacker, and shakapacker includes
+    # package_json as a dependency, the package_json gem is always available.
+    #
+    # == Required Methods
+    # Including classes must include GeneratorHelper module which provides:
+    # - add_npm_dependencies(packages, dev: false): Add packages via package_json gem
+    # - package_json: Access to PackageJson instance (always available via shakapacker)
+    # - destination_root: Generator destination directory
+    #
+    # == Optional Methods
+    # Including classes may define:
+    # - options.rspack?: Returns true if --rspack flag is set (for Rspack support)
+    # - options.typescript?: Returns true if --typescript flag is set (for TypeScript support)
+    #
+    # == Installation Behavior
+    # The module ALWAYS runs package manager install after adding dependencies.
+    # This is safe because package_json gem's install method is idempotent - it only
+    # installs what's actually needed from package.json. This prevents edge cases
+    # where package.json was modified but dependencies weren't installed.
+    #
+    # == Error Handling Philosophy
+    # All dependency addition methods use a graceful degradation approach:
+    # - Methods return false on failure instead of raising exceptions
+    # - StandardError is caught at the lowest level (add_package) and higher levels (add_*_dependencies)
+    # - Failures trigger user-facing warnings via GeneratorMessages
+    # - Warnings provide clear manual installation instructions
+    #
+    # This ensures the generator ALWAYS completes successfully, even when:
+    # - Network connectivity issues prevent package downloads
+    # - Package manager (npm/yarn/pnpm) has permission errors
+    # - package_json gem encounters unexpected states
+    #
+    # Users can manually run package installation commands after generator completion.
+    # This is preferable to generator crashes that leave Rails apps in incomplete states.
+    #
+    # == Usage
+    # Include this module in generator classes and call setup_js_dependencies
+    # to handle all JS dependency installation via package_json gem.
+    module JsDependencyManager
+      # Core React dependencies required for React on Rails
+      # Note: @babel/preset-react and babel plugins are NOT included here because:
+      # - Shakapacker handles JavaScript transpiler configuration (babel, swc, or esbuild)
+      # - Users configure their preferred transpiler via shakapacker.yml javascript_transpiler setting
+      # - SWC is now the default and doesn't need Babel presets
+      # - For Babel users, shakapacker will install babel-loader and its dependencies
+      REACT_DEPENDENCIES = %w[
+        react
+        react-dom
+        prop-types
+      ].freeze
+
+      # CSS processing dependencies for webpack
+      CSS_DEPENDENCIES = %w[
+        css-loader
+        css-minimizer-webpack-plugin
+        mini-css-extract-plugin
+        style-loader
+      ].freeze
+
+      # Development-only dependencies for hot reloading (Webpack)
+      DEV_DEPENDENCIES = %w[
+        @pmmmwh/react-refresh-webpack-plugin
+        react-refresh
+      ].freeze
+
+      # Rspack core dependencies (only installed when --rspack flag is used)
+      RSPACK_DEPENDENCIES = %w[
+        @rspack/core
+        rspack-manifest-plugin
+      ].freeze
+
+      # Rspack development dependencies for hot reloading
+      RSPACK_DEV_DEPENDENCIES = %w[
+        @rspack/cli
+        @rspack/plugin-react-refresh
+        react-refresh
+      ].freeze
+
+      # TypeScript dependencies (only installed when --typescript flag is used)
+      # Note: @babel/preset-typescript is NOT included because:
+      # - SWC is now the default javascript_transpiler (has built-in TypeScript support)
+      # - Shakapacker handles the transpiler configuration via shakapacker.yml
+      # - If users choose javascript_transpiler: 'babel', they should manually add @babel/preset-typescript
+      #   and configure it in their babel.config.js
+      TYPESCRIPT_DEPENDENCIES = %w[
+        typescript
+        @types/react
+        @types/react-dom
+      ].freeze
+
+      private
+
+      def setup_js_dependencies
+        add_js_dependencies
+
+        # Always run install to ensure all dependencies are properly installed.
+        # The package_json gem's install method is idempotent and safe to call
+        # even if packages were already added - it will only install what's needed.
+        # This ensures edge cases where package.json was modified but install wasn't
+        # run are handled correctly.
+        install_js_dependencies
+      end
+
+      def add_js_dependencies
+        add_react_on_rails_package
+        add_react_dependencies
+        add_css_dependencies
+        # Rspack dependencies are only added when --rspack flag is used
+        add_rspack_dependencies if respond_to?(:options) && options&.rspack?
+        # Dev dependencies vary based on bundler choice
+        add_dev_dependencies
+      end
+
+      def add_react_on_rails_package
+        # Use exact version match between gem and npm package for stable releases
+        # For pre-release versions (e.g., 16.1.0-rc.1), use latest to avoid installing
+        # a version that may not exist in the npm registry
+        major_minor_patch_only = /\A\d+\.\d+\.\d+\z/
+        react_on_rails_pkg = if ReactOnRails::VERSION.match?(major_minor_patch_only)
+                               "react-on-rails@#{ReactOnRails::VERSION}"
+                             else
+                               puts "Adding the latest react-on-rails NPM module. " \
+                                    "Double check this is correct in package.json"
+                               "react-on-rails"
+                             end
+
+        puts "Installing React on Rails package..."
+        return if add_package(react_on_rails_pkg)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add react-on-rails package.
+
+          You can install it manually by running:
+            npm install #{react_on_rails_pkg}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding react-on-rails package: #{e.message}
+
+          You can install it manually by running:
+            npm install #{react_on_rails_pkg}
+        MSG
+      end
+
+      def add_react_dependencies
+        puts "Installing React dependencies..."
+        return if add_packages(REACT_DEPENDENCIES)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add React dependencies.
+
+          You can install them manually by running:
+            npm install #{REACT_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding React dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install #{REACT_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_css_dependencies
+        puts "Installing CSS handling dependencies..."
+        return if add_packages(CSS_DEPENDENCIES)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add CSS dependencies.
+
+          You can install them manually by running:
+            npm install #{CSS_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding CSS dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install #{CSS_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_rspack_dependencies
+        puts "Installing Rspack core dependencies..."
+        return if add_packages(RSPACK_DEPENDENCIES)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add Rspack dependencies.
+
+          You can install them manually by running:
+            npm install #{RSPACK_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding Rspack dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install #{RSPACK_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_typescript_dependencies
+        puts "Installing TypeScript dependencies..."
+        return if add_packages(TYPESCRIPT_DEPENDENCIES, dev: true)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add TypeScript dependencies.
+
+          You can install them manually by running:
+            npm install --save-dev #{TYPESCRIPT_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding TypeScript dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install --save-dev #{TYPESCRIPT_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_dev_dependencies
+        puts "Installing development dependencies..."
+
+        # Use Rspack-specific dev dependencies if --rspack flag is set
+        dev_deps = if respond_to?(:options) && options&.rspack?
+                     RSPACK_DEV_DEPENDENCIES
+                   else
+                     DEV_DEPENDENCIES
+                   end
+
+        return if add_packages(dev_deps, dev: true)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add development dependencies.
+
+          You can install them manually by running:
+            npm install --save-dev #{dev_deps.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding development dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install --save-dev #{dev_deps.join(' ')}
+        MSG
+      end
+
+      # Add a single dependency using package_json gem
+      #
+      # This method is used internally for adding the react-on-rails package
+      # with version-specific handling (react-on-rails@VERSION).
+      # For batch operations, use add_packages instead.
+      #
+      # The exact: true flag ensures version pinning aligns with the gem version,
+      # preventing version mismatches between the Ruby gem and NPM package.
+      #
+      # @param package [String] Package specifier (e.g., "react-on-rails@16.0.0")
+      # @param dev [Boolean] Whether to add as dev dependency
+      # @return [Boolean] true if successful, false otherwise
+      def add_package(package, dev: false)
+        pj = package_json
+        return false unless pj
+
+        begin
+          # Ensure package is in array format for package_json gem
+          packages_array = [package]
+          if dev
+            pj.manager.add(packages_array, type: :dev, exact: true)
+          else
+            pj.manager.add(packages_array, exact: true)
+          end
+          true
+        rescue StandardError
+          # Return false to trigger warning in calling method
+          false
+        end
+      end
+
+      # Add multiple dependencies at once using package_json gem
+      #
+      # This method delegates to GeneratorHelper's add_npm_dependencies for
+      # better package manager abstraction and batch processing efficiency.
+      #
+      # @param packages [Array<String>] Package names to add
+      # @param dev [Boolean] Whether to add as dev dependencies
+      # @return [Boolean] true if successful, false otherwise
+      def add_packages(packages, dev: false)
+        # Use the add_npm_dependencies helper from GeneratorHelper
+        add_npm_dependencies(packages, dev: dev)
+      end
+
+      def install_js_dependencies
+        # Use package_json gem's install method (always available via shakapacker)
+        # package_json is guaranteed to be available because:
+        # 1. react_on_rails gemspec requires shakapacker
+        # 2. shakapacker gemspec requires package_json
+        # 3. GeneratorHelper provides package_json method
+        pj = package_json
+        unless pj
+          GeneratorMessages.add_warning("package_json not available, skipping dependency installation")
+          return false
+        end
+
+        pj.manager.install
+        true
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  JavaScript dependencies installation failed: #{e.message}
+
+          This could be due to network issues or package manager problems.
+          You can install dependencies manually later by running:
+          • npm install (if using npm)
+          • yarn install (if using yarn)
+          • pnpm install (if using pnpm)
+        MSG
+        false
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/ModuleLength

data/lib/generators/react_on_rails/templates/base/base/config/shakapacker.yml

@@ -36,8 +36,15 @@ default: &default
   # Reload manifest.json on all requests so we reload latest compiled packs
   cache_manifest: false
 
-  # Select loader to use, available options are 'babel' (default), 'swc' or 'esbuild'
-  webpack_loader: 'babel'
+  # Select JavaScript transpiler to use
+  # Available options: 'swc' (default, 20x faster), 'babel', 'esbuild', or 'none'
+  # Use 'none' when providing a completely custom webpack configuration
+  # Note: When using rspack, swc is used automatically regardless of this setting
+  javascript_transpiler: "swc"
+
+  # Select assets bundler to use
+  # Available options: 'webpack' (default) or 'rspack'
+  assets_bundler: "webpack"
 
   # Raises an error if there is a mismatch in the shakapacker gem and npm package being used
   ensure_consistent_versioning: true

data/lib/react_on_rails/engine.rb

@@ -83,10 +83,7 @@ module ReactOnRails
       ReactOnRails::ServerRenderingPool.reset_pool
     end
 
-    rake_tasks do
-      load File.expand_path("../tasks/generate_packs.rake", __dir__)
-      load File.expand_path("../tasks/assets.rake", __dir__)
-      load File.expand_path("../tasks/locale.rake", __dir__)
-    end
+    # Rake tasks are automatically loaded from lib/tasks/*.rake by Rails::Engine
+    # No need to explicitly load them here to avoid duplicate loading
   end
 end

data/lib/react_on_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ReactOnRails
-  VERSION = "16.2.0.beta.8"
+  VERSION = "16.2.0.beta.10"
 end

data/react_on_rails_pro/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ..
   specs:
-    react_on_rails (16.2.0.beta.8)
+    react_on_rails (16.2.0.beta.10)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,7 +20,7 @@ PATH
 PATH
   remote: .
   specs:
-    react_on_rails_pro (16.2.0.beta.8)
+    react_on_rails_pro (16.2.0.beta.10)
       addressable
       async (>= 2.6)
       connection_pool
@@ -28,7 +28,7 @@ PATH
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.2.0.beta.8)
+      react_on_rails (= 16.2.0.beta.10)
 
 GEM
   remote: https://rubygems.org/

data/react_on_rails_pro/lib/react_on_rails_pro/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module ReactOnRailsPro
-  VERSION = "16.2.0.beta.8"
+  VERSION = "16.2.0.beta.10"
   PROTOCOL_VERSION = "2.0.0"
 end

data/react_on_rails_pro/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-on-rails-pro-node-renderer",
-  "version": "16.2.0-beta.8",
+  "version": "16.2.0-beta.10",
   "protocolVersion": "2.0.0",
   "description": "react-on-rails-pro JavaScript for react_on_rails_pro Ruby gem",
   "exports": {

data/react_on_rails_pro/spec/dummy/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ../../..
   specs:
-    react_on_rails (16.2.0.beta.8)
+    react_on_rails (16.2.0.beta.10)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,7 +20,7 @@ PATH
 PATH
   remote: ../..
   specs:
-    react_on_rails_pro (16.2.0.beta.8)
+    react_on_rails_pro (16.2.0.beta.10)
       addressable
       async (>= 2.6)
       connection_pool
@@ -28,7 +28,7 @@ PATH
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.2.0.beta.8)
+      react_on_rails (= 16.2.0.beta.10)
 
 GEM
   remote: https://rubygems.org/

data/react_on_rails_pro/spec/dummy/bin/shakapacker-precompile-hook

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Shakapacker precompile hook for React on Rails Pro test dummy app
+#
+# This script loads the shared test helper implementation.
+# For production apps, use the generator template which includes a standalone implementation.
+
+# Find the gem root directory (four levels up from react_on_rails_pro/spec/dummy/bin)
+gem_root = File.expand_path("../../../..", __dir__)
+shared_hook = File.join(gem_root, "spec", "support", "shakapacker_precompile_hook_shared.rb")
+
+unless File.exist?(shared_hook)
+  warn "❌ Error: Shared precompile hook not found at #{shared_hook}"
+  exit 1
+end
+
+# Load and execute the shared hook
+load shared_hook

data/react_on_rails_pro/spec/dummy/config/shakapacker.yml

@@ -19,6 +19,11 @@ default: &default
   # Reload manifest.json on all requests so we reload latest compiled packs
   cache_manifest: false
 
+  # Hook to run before webpack compilation (e.g., for generating dynamic entry points)
+  # SECURITY: Only reference trusted scripts within your project. Ensure the hook path
+  # points to a file within the project root that you control.
+  precompile_hook: 'bin/shakapacker-precompile-hook'
+
   # Extract and emit a css file
   extract_css: true
 

data/sig/react_on_rails/generators/js_dependency_manager.rbs

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+module ReactOnRails
+  module Generators
+    # Type signatures for JsDependencyManager module
+    #
+    # This module provides common functionality for managing JavaScript dependencies
+    # in Rails generators using the package_json gem (available via shakapacker).
+    module JsDependencyManager
+      # Core React dependencies required for React on Rails
+      REACT_DEPENDENCIES: Array[String]
+
+      # CSS processing dependencies for webpack
+      CSS_DEPENDENCIES: Array[String]
+
+      # Development-only dependencies for hot reloading (Webpack)
+      DEV_DEPENDENCIES: Array[String]
+
+      # Rspack core dependencies (only installed when --rspack flag is used)
+      RSPACK_DEPENDENCIES: Array[String]
+
+      # Rspack development dependencies for hot reloading
+      RSPACK_DEV_DEPENDENCIES: Array[String]
+
+      # TypeScript dependencies (only installed when --typescript flag is used)
+      TYPESCRIPT_DEPENDENCIES: Array[String]
+
+      private
+
+      # Sets up JavaScript dependencies by adding and installing packages
+      #
+      # This method orchestrates the entire dependency setup process:
+      # 1. Adds all required packages to package.json
+      # 2. Runs package manager install
+      #
+      # @return [void]
+      def setup_js_dependencies: () -> void
+
+      # Adds all JavaScript dependencies to package.json
+      #
+      # This method calls individual add_*_dependencies methods in sequence.
+      # All errors are handled gracefully with warnings rather than exceptions.
+      #
+      # @return [void]
+      def add_js_dependencies: () -> void
+
+      # Adds the react-on-rails package to package.json
+      #
+      # Uses version matching for stable releases, or latest for pre-releases.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_react_on_rails_package: () -> void
+
+      # Adds React dependencies to package.json
+      #
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_react_dependencies: () -> void
+
+      # Adds CSS processing dependencies to package.json
+      #
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_css_dependencies: () -> void
+
+      # Adds Rspack dependencies to package.json
+      #
+      # Only called when --rspack flag is set.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_rspack_dependencies: () -> void
+
+      # Adds TypeScript dependencies to package.json as dev dependencies
+      #
+      # Only called when --typescript flag is set.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_typescript_dependencies: () -> void
+
+      # Adds development dependencies to package.json
+      #
+      # Chooses between Webpack or Rspack dev dependencies based on --rspack flag.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_dev_dependencies: () -> void
+
+      # Adds a single package using package_json gem
+      #
+      # This method is used internally for adding the react-on-rails package
+      # with version-specific handling (react-on-rails@VERSION).
+      # For batch operations, use add_packages instead.
+      #
+      # @param package [String] Package specifier (e.g., "react-on-rails@16.0.0")
+      # @param dev [bool] Whether to add as dev dependency
+      # @return [bool] true if successful, false otherwise
+      def add_package: (String package, ?dev: bool) -> bool
+
+      # Adds multiple packages at once using package_json gem
+      #
+      # Delegates to GeneratorHelper's add_npm_dependencies for better
+      # package manager abstraction and batch processing efficiency.
+      #
+      # @param packages [Array<String>] Package names to add
+      # @param dev [bool] Whether to add as dev dependencies
+      # @return [bool] true if successful, false otherwise
+      def add_packages: (Array[String] packages, ?dev: bool) -> bool
+
+      # Installs JavaScript dependencies using package_json gem
+      #
+      # Always available via shakapacker dependency chain.
+      # Adds warning to GeneratorMessages if installation fails.
+      #
+      # @return [bool] true if successful, false otherwise
+      def install_js_dependencies: () -> bool
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails
 version: !ruby/object:Gem::Version
-  version: 16.2.0.beta.8
+  version: 16.2.0.beta.10
 platform: ruby
 authors:
 - Justin Gordon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-17 00:00:00.000000000 Z
+date: 2025-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -167,6 +167,7 @@ files:
 - lib/generators/react_on_rails/generator_helper.rb
 - lib/generators/react_on_rails/generator_messages.rb
 - lib/generators/react_on_rails/install_generator.rb
+- lib/generators/react_on_rails/js_dependency_manager.rb
 - lib/generators/react_on_rails/react_no_redux_generator.rb
 - lib/generators/react_on_rails/react_with_redux_generator.rb
 - lib/generators/react_on_rails/templates/.eslintrc
@@ -606,6 +607,7 @@ files:
 - react_on_rails_pro/spec/dummy/bin/setup
 - react_on_rails_pro/spec/dummy/bin/shakapacker
 - react_on_rails_pro/spec/dummy/bin/shakapacker-dev-server
+- react_on_rails_pro/spec/dummy/bin/shakapacker-precompile-hook
 - react_on_rails_pro/spec/dummy/bin/spring
 - react_on_rails_pro/spec/dummy/bin/sprockets
 - react_on_rails_pro/spec/dummy/bin/term_display
@@ -973,6 +975,7 @@ files:
 - sig/react_on_rails/configuration.rbs
 - sig/react_on_rails/controller.rbs
 - sig/react_on_rails/error.rbs
+- sig/react_on_rails/generators/js_dependency_manager.rbs
 - sig/react_on_rails/git_utils.rbs
 - sig/react_on_rails/helper.rbs
 - sig/react_on_rails/json_parse_error.rbs