react_on_rails 16.2.0.beta.8 → 16.2.0.beta.11

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.11
 platform: ruby
 authors:
 - Justin Gordon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-17 00:00:00.000000000 Z
+date: 2025-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -140,6 +140,7 @@ files:
 - Steepfile
 - TODO.md
 - WARP.md
+- analysis/rake-task-duplicate-analysis.md
 - app/helpers/react_on_rails_helper.rb
 - bin/ci-local
 - bin/ci-rerun-failures
@@ -167,6 +168,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
@@ -190,7 +192,7 @@ files:
 - lib/generators/react_on_rails/templates/base/base/bin/shakapacker-precompile-hook
 - lib/generators/react_on_rails/templates/base/base/bin/switch-bundler
 - lib/generators/react_on_rails/templates/base/base/config/initializers/react_on_rails.rb.tt
-- lib/generators/react_on_rails/templates/base/base/config/shakapacker.yml
+- lib/generators/react_on_rails/templates/base/base/config/shakapacker.yml.tt
 - lib/generators/react_on_rails/templates/base/base/config/webpack/clientWebpackConfig.js.tt
 - lib/generators/react_on_rails/templates/base/base/config/webpack/commonWebpackConfig.js.tt
 - lib/generators/react_on_rails/templates/base/base/config/webpack/development.js.tt
@@ -606,6 +608,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
@@ -972,7 +975,12 @@ files:
 - sig/react_on_rails.rbs
 - sig/react_on_rails/configuration.rbs
 - sig/react_on_rails/controller.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
+- sig/react_on_rails/dev/server_manager.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