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

data/lib/generators/react_on_rails/templates/base/base/config/webpack/serverWebpackConfig.js.tt

@@ -44,19 +44,53 @@ const configureServer = () => {
   };
   serverWebpackConfig.plugins.unshift(new bundler.optimize.LimitChunkCountPlugin({ maxChunks: 1 }));
 
-  // Custom output for the server-bundle that matches the config in
-  // config/initializers/react_on_rails.rb
-  // Server bundles are output to a private directory (not public) for security
+  // Custom output for the server-bundle
+<% if shakapacker_version_9_or_higher? -%>
+  // Using Shakapacker 9.0+ privateOutputPath for automatic sync with shakapacker.yml
+  // This eliminates manual path configuration and keeps configs in sync.
+  // Falls back to hardcoded path if private_output_path is not configured.
+  const serverBundleOutputPath = config.privateOutputPath ||
+    require('path').resolve(__dirname, '../../ssr-generated');
+<% else -%>
+  // Using hardcoded path (Shakapacker < 9.0)
+  // For Shakapacker 9.0+, consider using config.privateOutputPath instead
+  // to automatically sync with shakapacker.yml private_output_path.
+  const serverBundleOutputPath = require('path').resolve(__dirname, '../../ssr-generated');
+<% end -%>
+
   serverWebpackConfig.output = {
     filename: 'server-bundle.js',
     globalObject: 'this',
     // If using the React on Rails Pro node server renderer, uncomment the next line
     // libraryTarget: 'commonjs2',
-    path: require('path').resolve(__dirname, '../../ssr-generated'),
+    path: serverBundleOutputPath,
     // No publicPath needed since server bundles are not served via web
     // https://webpack.js.org/configuration/output/#outputglobalobject
   };
 
+  // Validate server bundle output path configuration
+<% if shakapacker_version_9_or_higher? -%>
+  // For Shakapacker 9.0+, verify privateOutputPath is configured in shakapacker.yml
+  if (!config.privateOutputPath) {
+    console.warn('⚠️  Shakapacker 9.0+ detected but private_output_path not configured in shakapacker.yml');
+    console.warn('   Add to config/shakapacker.yml:');
+    console.warn('     private_output_path: ssr-generated');
+    console.warn('   Run: rails react_on_rails:doctor to validate your configuration');
+  }
+<% else -%>
+  // For Shakapacker < 9.0, verify hardcoded path syncs with Rails config
+  // 1. Ensure config/initializers/react_on_rails.rb has: config.server_bundle_output_path = "ssr-generated"
+  // 2. Run: rails react_on_rails:doctor to verify configuration
+  const fs = require('fs');
+  if (!fs.existsSync(serverBundleOutputPath)) {
+    console.warn(`⚠️  Server bundle output directory does not exist: ${serverBundleOutputPath}`);
+    console.warn('   It will be created during build, but ensure React on Rails is configured:');
+    console.warn('   config.server_bundle_output_path = "ssr-generated" in config/initializers/react_on_rails.rb');
+    console.warn('   Run: rails react_on_rails:doctor to validate your configuration');
+  }
+<% end -%>
+
+
   // Don't hash the server bundle b/c would conflict with the client manifest
   // And no need for the MiniCssExtractPlugin
   serverWebpackConfig.plugins = serverWebpackConfig.plugins.filter(

data/lib/react_on_rails/configuration.rb

@@ -1,5 +1,23 @@
 # frozen_string_literal: true
 
+require "active_support/core_ext/enumerable"
+require "active_support/core_ext/object/blank"
+
+# Polyfill for compact_blank (added in Rails 6.1) to support Rails 5.2-6.0
+unless [].respond_to?(:compact_blank)
+  module Enumerable
+    def compact_blank
+      reject(&:blank?)
+    end
+  end
+
+  class Array
+    def compact_blank
+      reject(&:blank?)
+    end
+  end
+end
+
 # rubocop:disable Metrics/ClassLength
 
 module ReactOnRails
@@ -10,6 +28,7 @@ module ReactOnRails
 
   DEFAULT_GENERATED_ASSETS_DIR = File.join(%w[public webpack], Rails.env).freeze
   DEFAULT_COMPONENT_REGISTRY_TIMEOUT = 5000
+  DEFAULT_SERVER_BUNDLE_OUTPUT_PATH = "ssr-generated"
 
   def self.configuration
     @configuration ||= Configuration.new(
@@ -46,7 +65,7 @@ module ReactOnRails
       # Set to 0 to disable the timeout and wait indefinitely for component registration.
       component_registry_timeout: DEFAULT_COMPONENT_REGISTRY_TIMEOUT,
       generated_component_packs_loading_strategy: nil,
-      server_bundle_output_path: "ssr-generated",
+      server_bundle_output_path: DEFAULT_SERVER_BUNDLE_OUTPUT_PATH,
       enforce_private_server_bundles: false
     )
   end
@@ -184,6 +203,7 @@ module ReactOnRails
       check_component_registry_timeout
       validate_generated_component_packs_loading_strategy
       validate_enforce_private_server_bundles
+      auto_detect_server_bundle_path_from_shakapacker
     end
 
     private
@@ -257,6 +277,57 @@ module ReactOnRails
                                  "the public directory. Please set it to a directory outside of public."
     end
 
+    # Auto-detect server_bundle_output_path from Shakapacker 9.0+ private_output_path
+    # Checks if user explicitly set a value and warns them to use auto-detection instead
+    def auto_detect_server_bundle_path_from_shakapacker
+      # Skip if Shakapacker is not available
+      return unless defined?(::Shakapacker)
+
+      # Check if Shakapacker config has private_output_path method (9.0+)
+      return unless ::Shakapacker.config.respond_to?(:private_output_path)
+
+      # Get the private_output_path from Shakapacker
+      private_path = ::Shakapacker.config.private_output_path
+      return unless private_path
+
+      relative_path = ReactOnRails::Utils.normalize_to_relative_path(private_path)
+
+      # Check if user explicitly configured server_bundle_output_path
+      if server_bundle_output_path != ReactOnRails::DEFAULT_SERVER_BUNDLE_OUTPUT_PATH
+        warn_about_explicit_configuration(relative_path)
+        return
+      end
+
+      apply_shakapacker_private_output_path(relative_path)
+    rescue StandardError => e
+      # Fail gracefully - if auto-detection fails, keep the default
+      Rails.logger&.debug("ReactOnRails: Could not auto-detect server bundle path from " \
+                          "Shakapacker: #{e.message}")
+    end
+
+    def warn_about_explicit_configuration(shakapacker_path)
+      # Normalize both paths for comparison
+      normalized_config = server_bundle_output_path.to_s.chomp("/")
+      normalized_shakapacker = shakapacker_path.to_s.chomp("/")
+
+      # Only warn if there's a mismatch
+      return if normalized_config == normalized_shakapacker
+
+      Rails.logger&.warn(
+        "ReactOnRails: server_bundle_output_path is explicitly set to '#{server_bundle_output_path}' " \
+        "but shakapacker.yml private_output_path is '#{shakapacker_path}'. " \
+        "Consider removing server_bundle_output_path from your React on Rails initializer " \
+        "to use the auto-detected value from shakapacker.yml."
+      )
+    end
+
+    def apply_shakapacker_private_output_path(relative_path)
+      self.server_bundle_output_path = relative_path
+
+      Rails.logger&.debug("ReactOnRails: Auto-detected server_bundle_output_path from " \
+                          "shakapacker.yml private_output_path: '#{relative_path}'")
+    end
+
     def check_minimum_shakapacker_version
       ReactOnRails::PackerUtils.raise_shakapacker_version_incompatible_for_basic_pack_generation unless
         ReactOnRails::PackerUtils.supports_basic_pack_generation?
@@ -360,13 +431,16 @@ module ReactOnRails
     def ensure_webpack_generated_files_exists
       return unless webpack_generated_files.empty?
 
-      self.webpack_generated_files = [
-        "manifest.json",
-        server_bundle_js_file,
-        rsc_bundle_js_file,
-        react_client_manifest_file,
-        react_server_client_manifest_file
-      ].compact_blank
+      files = ["manifest.json", server_bundle_js_file]
+
+      if ReactOnRails::Utils.react_on_rails_pro?
+        pro_config = ReactOnRailsPro.configuration
+        files << pro_config.rsc_bundle_js_file
+        files << pro_config.react_client_manifest_file
+        files << pro_config.react_server_client_manifest_file
+      end
+
+      self.webpack_generated_files = files.compact_blank
     end
 
     def configure_skip_display_none_deprecation

data/lib/react_on_rails/dev/pack_generator.rb

@@ -2,6 +2,7 @@
 
 require "English"
 require "stringio"
+require_relative "../packer_utils"
 
 module ReactOnRails
   module Dev

data/lib/react_on_rails/dev/server_manager.rb

@@ -3,6 +3,7 @@
 require "English"
 require "open3"
 require "rainbow"
+require_relative "../packer_utils"
 
 module ReactOnRails
   module Dev

data/lib/react_on_rails/doctor.rb

@@ -667,6 +667,7 @@ module ReactOnRails
       end
     end
 
+    # rubocop:disable Metrics/CyclomaticComplexity
     def analyze_server_rendering_config(content)
       checker.add_info("\n🖥️  Server Rendering:")
 
@@ -678,6 +679,19 @@ module ReactOnRails
         checker.add_info("  server_bundle_js_file: server-bundle.js (default)")
       end
 
+      # Server bundle output path
+      server_bundle_path_match = content.match(/config\.server_bundle_output_path\s*=\s*["']([^"']+)["']/)
+      default_path = ReactOnRails::DEFAULT_SERVER_BUNDLE_OUTPUT_PATH
+      rails_bundle_path = server_bundle_path_match ? server_bundle_path_match[1] : default_path
+      checker.add_info("  server_bundle_output_path: #{rails_bundle_path}")
+
+      # Enforce private server bundles
+      enforce_private_match = content.match(/config\.enforce_private_server_bundles\s*=\s*([^\s\n,]+)/)
+      checker.add_info("  enforce_private_server_bundles: #{enforce_private_match[1]}") if enforce_private_match
+
+      # Check Shakapacker integration and provide recommendations
+      check_shakapacker_private_output_path(rails_bundle_path)
+
       # RSC bundle file (Pro feature)
       rsc_bundle_match = content.match(/config\.rsc_bundle_js_file\s*=\s*["']([^"']+)["']/)
       if rsc_bundle_match
@@ -702,9 +716,9 @@ module ReactOnRails
 
       checker.add_info("  raise_on_prerender_error: #{raise_on_error_match[1]}")
     end
-    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/CyclomaticComplexity
 
-    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+    # rubocop:disable Metrics/CyclomaticComplexity
     def analyze_performance_config(content)
       checker.add_info("\n⚡ Performance & Loading:")
 
@@ -1387,9 +1401,85 @@ module ReactOnRails
     end
 
     def log_debug(message)
-      return unless defined?(Rails.logger) && Rails.logger
+      Rails.logger&.debug(message)
+    end
+
+    # Check Shakapacker private_output_path integration and provide recommendations
+    def check_shakapacker_private_output_path(rails_bundle_path)
+      return report_no_shakapacker unless defined?(::Shakapacker)
+      return report_upgrade_shakapacker unless ::Shakapacker.config.respond_to?(:private_output_path)
+
+      check_shakapacker_9_private_output_path(rails_bundle_path)
+    rescue StandardError => e
+      checker.add_info("\n  ℹ️  Could not check Shakapacker config: #{e.message}")
+    end
+
+    def report_no_shakapacker
+      checker.add_info("\n  ℹ️  Shakapacker not detected - using manual configuration")
+    end
+
+    def report_upgrade_shakapacker
+      checker.add_info(<<~MSG.strip)
+        \n  💡 Recommendation: Upgrade to Shakapacker 9.0+
+
+        Shakapacker 9.0+ adds 'private_output_path' in shakapacker.yml for server bundles.
+        This eliminates the need to configure server_bundle_output_path separately.
+
+        Benefits:
+        - Single source of truth in shakapacker.yml
+        - Automatic detection by React on Rails
+        - No configuration duplication
+      MSG
+    end
+
+    def check_shakapacker_9_private_output_path(rails_bundle_path)
+      private_path = ::Shakapacker.config.private_output_path
+
+      if private_path
+        report_shakapacker_path_status(private_path, rails_bundle_path)
+      else
+        report_configure_private_output_path(rails_bundle_path)
+      end
+    end
+
+    def report_shakapacker_path_status(private_path, rails_bundle_path)
+      relative_path = ReactOnRails::Utils.normalize_to_relative_path(private_path)
+      # Normalize both paths for comparison (remove trailing slashes)
+      normalized_relative = relative_path.to_s.chomp("/")
+      normalized_rails = rails_bundle_path.to_s.chomp("/")
+
+      if normalized_relative == normalized_rails
+        checker.add_success("\n  ✅ Using Shakapacker 9.0+ private_output_path: '#{relative_path}'")
+        checker.add_info("     Auto-detected from shakapacker.yml - no manual config needed")
+      else
+        report_configuration_mismatch(relative_path, rails_bundle_path)
+      end
+    end
+
+    def report_configuration_mismatch(relative_path, rails_bundle_path)
+      checker.add_warning(<<~MSG.strip)
+        \n  ⚠️  Configuration mismatch detected!
+
+        Shakapacker private_output_path: '#{relative_path}'
+        React on Rails server_bundle_output_path: '#{rails_bundle_path}'
+
+        Recommendation: Remove server_bundle_output_path from your React on Rails
+        initializer and let it auto-detect from shakapacker.yml private_output_path.
+      MSG
+    end
+
+    def report_configure_private_output_path(rails_bundle_path)
+      checker.add_info(<<~MSG.strip)
+        \n  💡 Recommendation: Configure private_output_path in shakapacker.yml
+
+        Add to config/shakapacker.yml:
+          private_output_path: #{rails_bundle_path}
 
-      Rails.logger.debug(message)
+        This will:
+        - Keep webpack and Rails configs in sync automatically
+        - Enable auto-detection by React on Rails
+        - Serve as single source of truth for server bundle location
+      MSG
     end
   end
   # rubocop:enable Metrics/ClassLength

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/system_checker.rb

@@ -213,17 +213,20 @@ module ReactOnRails
 
         return unless npm_version && defined?(ReactOnRails::VERSION)
 
-        # Clean version strings for comparison (remove ^, ~, =, etc.)
-        clean_npm_version = npm_version.gsub(/[^0-9.]/, "")
+        # Normalize NPM version format to Ruby gem format for comparison
+        # Uses existing VersionSyntaxConverter to handle dash/dot differences
+        # (e.g., "16.2.0-beta.10" → "16.2.0.beta.10")
+        converter = ReactOnRails::VersionSyntaxConverter.new
+        normalized_npm_version = converter.npm_to_rubygem(npm_version)
         gem_version = ReactOnRails::VERSION
 
-        if clean_npm_version == gem_version
+        if normalized_npm_version == gem_version
           add_success("✅ React on Rails gem and NPM package versions match (#{gem_version})")
           check_version_patterns(npm_version, gem_version)
         else
           # Check for major version differences
           gem_major = gem_version.split(".")[0].to_i
-          npm_major = clean_npm_version.split(".")[0].to_i
+          npm_major = normalized_npm_version.split(".")[0].to_i
 
           if gem_major != npm_major # rubocop:disable Style/NegatedIfElseCondition
             add_error(<<~MSG.strip)

data/lib/react_on_rails/utils.rb

@@ -443,6 +443,60 @@ module ReactOnRails
       end
     end
 
+    # Converts an absolute path (String or Pathname) to a path relative to Rails.root.
+    # If the path is already relative or doesn't contain Rails.root, returns it as-is.
+    #
+    # This method is used to normalize paths from Shakapacker's privateOutputPath (which is
+    # absolute) to relative paths suitable for React on Rails configuration.
+    #
+    # Note: Absolute paths that don't start with Rails.root are intentionally passed through
+    # unchanged. While there's no known use case for server bundles outside Rails.root,
+    # this behavior preserves the original path for debugging and error messages.
+    #
+    # @param path [String, Pathname] The path to normalize
+    # @return [String, nil] The relative path as a string, or nil if path is nil
+    #
+    # @example Converting absolute paths within Rails.root
+    #   # Assuming Rails.root is "/app"
+    #   normalize_to_relative_path("/app/ssr-generated") # => "ssr-generated"
+    #   normalize_to_relative_path("/app/foo/bar")       # => "foo/bar"
+    #
+    # @example Already relative paths pass through
+    #   normalize_to_relative_path("ssr-generated")      # => "ssr-generated"
+    #   normalize_to_relative_path("./ssr-generated")    # => "./ssr-generated"
+    #
+    # @example Absolute paths outside Rails.root (edge case)
+    #   normalize_to_relative_path("/other/path/bundles") # => "/other/path/bundles"
+    # rubocop:disable Metrics/CyclomaticComplexity
+    def self.normalize_to_relative_path(path)
+      return nil if path.nil?
+
+      path_str = path.to_s
+      rails_root_str = Rails.root.to_s.chomp("/")
+
+      # Treat as "inside Rails.root" only for exact match or a subdirectory
+      inside_rails_root = rails_root_str.present? &&
+                          (path_str == rails_root_str || path_str.start_with?("#{rails_root_str}/"))
+
+      # If path is within Rails.root, remove that prefix
+      if inside_rails_root
+        # Remove Rails.root and any leading slash
+        path_str.sub(%r{^#{Regexp.escape(rails_root_str)}/?}, "")
+      else
+        # Path is already relative or outside Rails.root
+        # Warn if it's an absolute path outside Rails.root (edge case)
+        if path_str.start_with?("/") && !inside_rails_root
+          Rails.logger&.warn(
+            "ReactOnRails: Detected absolute path outside Rails.root: '#{path_str}'. " \
+            "Server bundles are typically stored within Rails.root. " \
+            "Verify this is intentional."
+          )
+        end
+        path_str
+      end
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity
+
     def self.default_troubleshooting_section
       <<~DEFAULT
         📞 Get Help & Support:

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.11"
 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.11)
       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.11)
       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.11)
 
 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.11"
   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.11",
   "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.11)
       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.11)
       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.11)
 
 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/dev/file_manager.rbs

@@ -0,0 +1,15 @@
+module ReactOnRails
+  module Dev
+    class FileManager
+      def self.cleanup_stale_files: () -> bool
+
+      private
+
+      def self.cleanup_overmind_sockets: () -> bool
+      def self.cleanup_rails_pid_file: () -> bool
+      def self.overmind_running?: () -> bool
+      def self.process_running?: (Integer) -> bool
+      def self.remove_file_if_exists: (String, String) -> bool
+    end
+  end
+end

data/sig/react_on_rails/dev/pack_generator.rbs

@@ -0,0 +1,19 @@
+module ReactOnRails
+  module Dev
+    class PackGenerator
+      def self.generate: (?verbose: bool) -> void
+
+      private
+
+      def self.run_pack_generation: (?silent: bool) -> bool
+      def self.should_run_directly?: () -> bool
+      def self.rails_available?: () -> bool
+      def self.run_rake_task_directly: (?silent: bool) -> bool
+      def self.load_rake_tasks: () -> void
+      def self.prepare_rake_task: () -> untyped
+      def self.capture_output: (bool) { () -> bool } -> bool
+      def self.handle_rake_error: (Exception, bool) -> void
+      def self.run_via_bundle_exec: (?silent: bool) -> (bool | nil)
+    end
+  end
+end

data/sig/react_on_rails/dev/process_manager.rbs

@@ -0,0 +1,22 @@
+module ReactOnRails
+  module Dev
+    class ProcessManager
+      VERSION_CHECK_TIMEOUT: Integer
+
+      def self.installed?: (String) -> bool
+      def self.ensure_procfile: (String) -> void
+      def self.run_with_process_manager: (String) -> void
+
+      private
+
+      def self.installed_in_current_context?: (String) -> bool
+      def self.version_flags_for: (String) -> Array[String]
+      def self.run_process_if_available: (String, Array[String]) -> bool
+      def self.run_process_outside_bundle: (String, Array[String]) -> bool
+      def self.process_available_in_system?: (String) -> bool
+      def self.with_unbundled_context: () { () -> untyped } -> untyped
+      def self.show_process_manager_installation_help: () -> void
+      def self.valid_procfile_path?: (String) -> bool
+    end
+  end
+end

data/sig/react_on_rails/dev/server_manager.rbs

@@ -0,0 +1,39 @@
+module ReactOnRails
+  module Dev
+    class ServerManager
+      type mode = :development | :production_like | :static | :hmr
+
+      def self.start: (mode, String?, ?verbose: bool, ?route: String?, ?rails_env: String?) -> void
+      def self.kill_processes: () -> void
+      def self.development_processes: () -> Hash[String, String]
+      def self.kill_running_processes: () -> bool
+      def self.find_process_pids: (String) -> Array[Integer]
+      def self.terminate_processes: (Array[Integer]) -> void
+      def self.kill_port_processes: (Array[Integer]) -> bool
+      def self.find_port_pids: (Integer) -> Array[Integer]
+      def self.cleanup_socket_files: () -> bool
+      def self.print_kill_summary: (bool) -> void
+      def self.show_help: () -> void
+      def self.run_from_command_line: (?Array[String]) -> void
+
+      private
+
+      def self.help_usage: () -> String
+      def self.help_commands: () -> String
+      def self.help_options: () -> String
+      def self.help_customization: () -> String
+      def self.help_mode_details: () -> String
+      def self.help_troubleshooting: () -> String
+      def self.run_production_like: (?_verbose: bool, ?route: String?, ?rails_env: String?) -> void
+      def self.run_static_development: (String, ?verbose: bool, ?route: String?) -> void
+      def self.run_development: (String, ?verbose: bool, ?route: String?) -> void
+      def self.print_server_info: (String, Array[String], ?Integer, ?route: String?) -> void
+      def self.print_procfile_info: (String, ?route: String?) -> void
+      def self.procfile_port: (String) -> Integer
+      def self.box_border: (Integer) -> String
+      def self.box_bottom: (Integer) -> String
+      def self.box_empty_line: (Integer) -> String
+      def self.format_box_line: (String, Integer) -> String
+    end
+  end
+end