react_on_rails 15.0.0.rc.2 → 16.0.1.rc.0

data/lib/react_on_rails/engine.rb

@@ -8,5 +8,11 @@ module ReactOnRails
       VersionChecker.build.log_if_gem_and_node_package_versions_differ
       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
   end
 end

data/lib/react_on_rails/git_utils.rb

@@ -11,9 +11,19 @@ module ReactOnRails
       return false if git_installed && status&.empty?
 
       error = if git_installed
-                "You have uncommitted code. Please commit or stash your changes before continuing"
+                <<~MSG.strip
+                  You have uncommitted changes. Please commit or stash them before continuing.
+
+                  The React on Rails generator creates many new files and it's important to keep
+                  your existing changes separate from the generated code for easier review.
+                MSG
               else
-                "You do not have Git installed. Please install Git, and commit your changes before continuing"
+                <<~MSG.strip
+                  Git is not installed. Please install Git and commit your changes before continuing.
+
+                  The React on Rails generator creates many new files and version control helps
+                  track what was generated versus your existing code.
+                MSG
               end
       message_handler.add_error(error)
       true

data/lib/react_on_rails/helper.rb

@@ -11,10 +11,12 @@ require "addressable/uri"
 require "react_on_rails/utils"
 require "react_on_rails/json_output"
 require "active_support/concern"
+require "react_on_rails/pro/helper"
 
 module ReactOnRails
   module Helper
     include ReactOnRails::Utils::Required
+    include ReactOnRails::Pro::Helper
 
     COMPONENT_HTML_KEY = "componentHtml"
 
@@ -61,12 +63,13 @@ module ReactOnRails
 
       case server_rendered_html
       when String
-        build_react_component_result_for_server_rendered_string(
+        html = build_react_component_result_for_server_rendered_string(
           server_rendered_html: server_rendered_html,
           component_specification_tag: internal_result[:tag],
           console_script: console_script,
           render_options: render_options
         )
+        html.html_safe
       when Hash
         msg = <<~MSG
           Use react_component_hash (not react_component) to return a Hash to your ruby view code. See
@@ -126,7 +129,7 @@ module ReactOnRails
       # stream_react_component doesn't have the prerender option
       # Because setting prerender to false is equivalent to calling react_component with prerender: false
       options[:prerender] = true
-      options = options.merge(force_load: true) unless options.key?(:force_load)
+      options = options.merge(immediate_hydration: true) unless options.key?(:immediate_hydration)
       run_stream_inside_fiber do
         internal_stream_react_component(component_name, options)
       end
@@ -208,6 +211,7 @@ module ReactOnRails
     #
     def react_component_hash(component_name, options = {})
       options[:prerender] = true
+
       internal_result = internal_react_component(component_name, options)
       server_rendered_html = internal_result[:result]["html"]
       console_script = internal_result[:result]["consoleReplayScript"]
@@ -224,6 +228,7 @@ module ReactOnRails
           console_script: console_script,
           render_options: render_options
         )
+
       else
         msg = <<~MSG
           Render-Function used by react_component_hash for #{component_name} is expected to return
@@ -247,13 +252,14 @@ module ReactOnRails
     # props: Ruby Hash or JSON string which contains the properties to pass to the redux store.
     # Options
     #    defer: false -- pass as true if you wish to render this below your component.
-    #    force_load: false -- pass as true if you wish to hydrate this store immediately instead of
-    #                        waiting for the page to load.
-    def redux_store(store_name, props: {}, defer: false, force_load: nil)
-      force_load = ReactOnRails.configuration.force_load if force_load.nil?
+    #    immediate_hydration: false -- React on Rails Pro (licensed) feature. Pass as true if you wish to
+    #                        hydrate this store immediately instead of waiting for the page to load.
+    def redux_store(store_name, props: {}, defer: false, immediate_hydration: nil)
+      immediate_hydration = ReactOnRails.configuration.immediate_hydration if immediate_hydration.nil?
+
       redux_store_data = { store_name: store_name,
                            props: props,
-                           force_load: force_load }
+                           immediate_hydration: immediate_hydration }
       if defer
         registered_stores_defer_render << redux_store_data
         "YOU SHOULD NOT SEE THIS ON YOUR VIEW -- Uses as a code block, like <% redux_store %> " \
@@ -261,7 +267,7 @@ module ReactOnRails
       else
         registered_stores << redux_store_data
         result = render_redux_store_data(redux_store_data)
-        prepend_render_rails_context(result)
+        prepend_render_rails_context(result).html_safe
       end
     end
 
@@ -334,7 +340,7 @@ module ReactOnRails
 
       html = result["html"]
       console_log_script = result["consoleLogScript"]
-      raw("#{html}#{render_options.replay_console ? console_log_script : ''}")
+      raw("#{html}#{console_log_script if render_options.replay_console}")
     rescue ExecJS::ProgramError => err
       raise ReactOnRails::PrerenderError.new(component_name: "N/A (server_render_js called)",
                                              err: err,
@@ -401,7 +407,7 @@ module ReactOnRails
           result.merge!(
             # URL settings
             href: uri.to_s,
-            location: "#{uri.path}#{uri.query.present? ? "?#{uri.query}" : ''}",
+            location: "#{uri.path}#{"?#{uri.query}" if uri.query.present?}",
             scheme: uri.scheme, # http
             host: uri.host, # foo.com
             port: uri.port,
@@ -440,8 +446,6 @@ module ReactOnRails
 
     # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity
 
-    private
-
     def run_stream_inside_fiber
       unless ReactOnRails::Utils.react_on_rails_pro?
         raise ReactOnRails::Error,
@@ -641,24 +645,7 @@ module ReactOnRails
 
       # Setup the page_loaded_js, which is the same regardless of prerendering or not!
       # The reason is that React is smart about not doing extra work if the server rendering did its job.
-      component_specification_tag = content_tag(:script,
-                                                json_safe_and_pretty(render_options.client_props).html_safe,
-                                                type: "application/json",
-                                                class: "js-react-on-rails-component",
-                                                id: "js-react-on-rails-component-#{render_options.dom_id}",
-                                                "data-component-name" => render_options.react_component_name,
-                                                "data-trace" => (render_options.trace ? true : nil),
-                                                "data-dom-id" => render_options.dom_id,
-                                                "data-store-dependencies" => render_options.store_dependencies&.to_json,
-                                                "data-force-load" => (render_options.force_load ? true : nil))
-
-      if render_options.force_load
-        component_specification_tag.concat(
-          content_tag(:script, %(
-typeof ReactOnRails === 'object' && ReactOnRails.reactOnRailsComponentLoaded('#{render_options.dom_id}');
-          ).html_safe)
-        )
-      end
+      component_specification_tag = generate_component_script(render_options)
 
       load_pack_for_generated_component(react_component_name, render_options)
       # Create the HTML rendering part
@@ -672,20 +659,7 @@ typeof ReactOnRails === 'object' && ReactOnRails.reactOnRailsComponentLoaded('#{
     end
 
     def render_redux_store_data(redux_store_data)
-      store_hydration_data = content_tag(:script,
-                                         json_safe_and_pretty(redux_store_data[:props]).html_safe,
-                                         type: "application/json",
-                                         "data-js-react-on-rails-store" => redux_store_data[:store_name].html_safe,
-                                         "data-force-load" => (redux_store_data[:force_load] ? true : nil))
-
-      if redux_store_data[:force_load]
-        store_hydration_data.concat(
-          content_tag(:script, <<~JS.strip_heredoc.html_safe
-            typeof ReactOnRails === 'object' && ReactOnRails.reactOnRailsStoreLoaded('#{redux_store_data[:store_name]}');
-          JS
-          )
-        )
-      end
+      store_hydration_data = generate_store_script(redux_store_data)
 
       prepend_render_rails_context(store_hydration_data)
     end
@@ -814,6 +788,7 @@ typeof ReactOnRails === 'object' && ReactOnRails.reactOnRailsComponentLoaded('#{
 
     if defined?(ScoutApm)
       include ScoutApm::Tracer
+
       instrument_method :react_component, type: "ReactOnRails", name: "react_component"
       instrument_method :react_component_hash, type: "ReactOnRails", name: "react_component_hash"
     end

data/lib/react_on_rails/packer_utils.rb

@@ -3,27 +3,18 @@
 module ReactOnRails
   module PackerUtils
     def self.using_packer?
-      using_shakapacker_const? || using_webpacker_const?
+      using_shakapacker_const?
     end
 
     def self.using_shakapacker_const?
       return @using_shakapacker_const if defined?(@using_shakapacker_const)
 
       @using_shakapacker_const = ReactOnRails::Utils.gem_available?("shakapacker") &&
-                                 shakapacker_version_requirement_met?("7.0.0")
-    end
-
-    def self.using_webpacker_const?
-      return @using_webpacker_const if defined?(@using_webpacker_const)
-
-      @using_webpacker_const = (ReactOnRails::Utils.gem_available?("shakapacker") &&
-                          shakapacker_version_as_array[0] <= 6) ||
-                               ReactOnRails::Utils.gem_available?("webpacker")
+                                 shakapacker_version_requirement_met?("8.2.0")
     end
 
     def self.packer_type
       return "shakapacker" if using_shakapacker_const?
-      return "webpacker" if using_webpacker_const?
 
       nil
     end
@@ -31,12 +22,8 @@ module ReactOnRails
     def self.packer
       return nil unless using_packer?
 
-      if using_shakapacker_const?
-        require "shakapacker"
-        return ::Shakapacker
-      end
-      require "webpacker"
-      ::Webpacker
+      require "shakapacker"
+      ::Shakapacker
     end
 
     def self.dev_server_running?
@@ -106,7 +93,6 @@ module ReactOnRails
     end
 
     def self.precompile?
-      return ::Webpacker.config.webpacker_precompile? if using_webpacker_const?
       return ::Shakapacker.config.shakapacker_precompile? if using_shakapacker_const?
 
       false

data/lib/react_on_rails/packs_generator.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 require "fileutils"
+require "set"
 
 module ReactOnRails
   # rubocop:disable Metrics/ClassLength
   class PacksGenerator
     CONTAINS_CLIENT_OR_SERVER_REGEX = /\.(server|client)($|\.)/
+    COMPONENT_EXTENSIONS = /\.(jsx?|tsx?)$/
     MINIMUM_SHAKAPACKER_VERSION = "6.5.1"
 
     def self.instance
@@ -16,13 +18,20 @@ module ReactOnRails
       return unless ReactOnRails.configuration.auto_load_bundle
 
       add_generated_pack_to_server_bundle
+
+      # Clean any non-generated files from directories
+      clean_non_generated_files_with_feedback
+
       are_generated_files_present_and_up_to_date = Dir.exist?(generated_packs_directory_path) &&
                                                    File.exist?(generated_server_bundle_file_path) &&
                                                    !stale_or_missing_packs?
 
-      return if are_generated_files_present_and_up_to_date
+      if are_generated_files_present_and_up_to_date
+        puts Rainbow("✅ Generated packs are up to date, no regeneration needed").green
+        return
+      end
 
-      clean_generated_packs_directory
+      clean_generated_directories_with_feedback
       generate_packs
     end
 
@@ -182,9 +191,112 @@ module ReactOnRails
       "#{generated_nonentrypoints_path}/#{generated_server_bundle_file_name}.js"
     end
 
-    def clean_generated_packs_directory
-      FileUtils.rm_rf(generated_packs_directory_path)
-      FileUtils.mkdir_p(generated_packs_directory_path)
+    def clean_non_generated_files_with_feedback
+      directories_to_clean = [generated_packs_directory_path, generated_server_bundle_directory_path].compact.uniq
+      expected_files = build_expected_files_set
+
+      puts Rainbow("🧹 Cleaning non-generated files...").yellow
+
+      total_deleted = directories_to_clean.sum do |dir_path|
+        clean_unexpected_files_from_directory(dir_path, expected_files)
+      end
+
+      display_cleanup_summary(total_deleted)
+    end
+
+    def build_expected_files_set
+      expected_pack_files = Set.new
+      common_component_to_path.each_value { |path| expected_pack_files << generated_pack_path(path) }
+      client_component_to_path.each_value { |path| expected_pack_files << generated_pack_path(path) }
+
+      if ReactOnRails.configuration.server_bundle_js_file.present?
+        expected_server_bundle = generated_server_bundle_file_path
+      end
+
+      { pack_files: expected_pack_files, server_bundle: expected_server_bundle }
+    end
+
+    def clean_unexpected_files_from_directory(dir_path, expected_files)
+      return 0 unless Dir.exist?(dir_path)
+
+      existing_files = Dir.glob("#{dir_path}/**/*").select { |f| File.file?(f) }
+      unexpected_files = find_unexpected_files(existing_files, dir_path, expected_files)
+
+      if unexpected_files.any?
+        delete_unexpected_files(unexpected_files, dir_path)
+        unexpected_files.length
+      else
+        puts Rainbow("   No unexpected files found in #{dir_path}").cyan
+        0
+      end
+    end
+
+    def find_unexpected_files(existing_files, dir_path, expected_files)
+      existing_files.reject do |file|
+        if dir_path == generated_server_bundle_directory_path
+          file == expected_files[:server_bundle]
+        else
+          expected_files[:pack_files].include?(file)
+        end
+      end
+    end
+
+    def delete_unexpected_files(unexpected_files, dir_path)
+      puts Rainbow("   Deleting #{unexpected_files.length} unexpected files from #{dir_path}:").cyan
+      unexpected_files.each do |file|
+        puts Rainbow("     - #{File.basename(file)}").blue
+        File.delete(file)
+      end
+    end
+
+    def display_cleanup_summary(total_deleted)
+      if total_deleted.positive?
+        puts Rainbow("🗑️  Deleted #{total_deleted} unexpected files total").red
+      else
+        puts Rainbow("✨ No unexpected files to delete").green
+      end
+    end
+
+    def clean_generated_directories_with_feedback
+      directories_to_clean = [
+        generated_packs_directory_path,
+        generated_server_bundle_directory_path
+      ].compact.uniq
+
+      puts Rainbow("🧹 Cleaning generated directories...").yellow
+
+      total_deleted = directories_to_clean.sum { |dir_path| clean_directory_with_feedback(dir_path) }
+
+      if total_deleted.positive?
+        puts Rainbow("🗑️  Deleted #{total_deleted} generated files total").red
+      else
+        puts Rainbow("✨ No files to delete, directories are clean").green
+      end
+    end
+
+    def clean_directory_with_feedback(dir_path)
+      return create_directory_with_feedback(dir_path) unless Dir.exist?(dir_path)
+
+      files = Dir.glob("#{dir_path}/**/*").select { |f| File.file?(f) }
+
+      if files.any?
+        puts Rainbow("   Deleting #{files.length} files from #{dir_path}:").cyan
+        files.each { |file| puts Rainbow("     - #{File.basename(file)}").blue }
+        FileUtils.rm_rf(dir_path)
+        FileUtils.mkdir_p(dir_path)
+        files.length
+      else
+        puts Rainbow("   Directory #{dir_path} is already empty").cyan
+        FileUtils.rm_rf(dir_path)
+        FileUtils.mkdir_p(dir_path)
+        0
+      end
+    end
+
+    def create_directory_with_feedback(dir_path)
+      puts Rainbow("   Directory #{dir_path} does not exist, creating...").cyan
+      FileUtils.mkdir_p(dir_path)
+      0
     end
 
     def server_bundle_entrypoint
@@ -198,6 +310,13 @@ module ReactOnRails
       "#{source_entry_path}/generated"
     end
 
+    def generated_server_bundle_directory_path
+      return nil if ReactOnRails.configuration.make_generated_server_bundle_the_entrypoint
+
+      source_entrypoint_parent = Pathname(ReactOnRails::PackerUtils.packer_source_entry_path).parent
+      "#{source_entrypoint_parent}/generated"
+    end
+
     def relative_component_path_from_generated_pack(ror_component_path)
       component_file_pathname = Pathname.new(ror_component_path)
       component_generated_pack_path = generated_pack_path(ror_component_path)
@@ -228,14 +347,20 @@ module ReactOnRails
       paths.to_h { |path| [component_name(path), path] }
     end
 
+    def filter_component_files(paths)
+      paths.grep(COMPONENT_EXTENSIONS)
+    end
+
     def common_component_to_path
       common_components_paths = Dir.glob("#{components_search_path}/*").grep_v(CONTAINS_CLIENT_OR_SERVER_REGEX)
-      component_name_to_path(common_components_paths)
+      filtered_paths = filter_component_files(common_components_paths)
+      component_name_to_path(filtered_paths)
     end
 
     def client_component_to_path
       client_render_components_paths = Dir.glob("#{components_search_path}/*.client.*")
-      client_specific_components = component_name_to_path(client_render_components_paths)
+      filtered_client_paths = filter_component_files(client_render_components_paths)
+      client_specific_components = component_name_to_path(filtered_client_paths)
 
       duplicate_components = common_component_to_path.slice(*client_specific_components.keys)
       duplicate_components.each_key { |component| raise_client_component_overrides_common(component) }
@@ -245,7 +370,8 @@ module ReactOnRails
 
     def server_component_to_path
       server_render_components_paths = Dir.glob("#{components_search_path}/*.server.*")
-      server_specific_components = component_name_to_path(server_render_components_paths)
+      filtered_server_paths = filter_component_files(server_render_components_paths)
+      server_specific_components = component_name_to_path(filtered_server_paths)
 
       duplicate_components = common_component_to_path.slice(*server_specific_components.keys)
       duplicate_components.each_key { |component| raise_server_component_overrides_common(component) }

data/lib/react_on_rails/pro/NOTICE

@@ -0,0 +1,21 @@
+# React on Rails Pro License
+
+The files in this directory and its subdirectories are licensed under the **React on Rails Pro** license, which is separate from the MIT license that covers the core React on Rails functionality.
+
+## License Terms
+
+These files are proprietary software and are **NOT** covered by the MIT license found in the root LICENSE.md file. Usage requires a valid React on Rails Pro license.
+
+## Distribution
+
+Files in this directory will be **omitted** from future distributions of the open source React on Rails Ruby gem. They are exclusively available to React on Rails Pro licensees.
+
+## License Reference
+
+For the complete React on Rails Pro license terms, see: `REACT-ON-RAILS-PRO-LICENSE.md` in the root directory of this repository.
+
+## More Information
+
+For React on Rails Pro licensing information and to obtain a license, please visit:
+- [React on Rails Pro](https://www.shakacode.com/react-on-rails-pro/)
+- Contact: [react_on_rails@shakacode.com](mailto:react_on_rails@shakacode.com)

data/lib/react_on_rails/pro/helper.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+# /*
+#  * Copyright (c) 2025 Shakacode LLC
+#  *
+#  * This file is NOT licensed under the MIT (open source) license.
+#  * It is part of the React on Rails Pro offering and is licensed separately.
+#  *
+#  * Unauthorized copying, modification, distribution, or use of this file,
+#  * via any medium, is strictly prohibited without a valid license agreement
+#  * from Shakacode LLC.
+#  *
+#  * For licensing terms, please see:
+#  * https://github.com/shakacode/react_on_rails/blob/master/REACT-ON-RAILS-PRO-LICENSE.md
+#  */
+
+module ReactOnRails
+  module Pro
+    module Helper
+      IMMEDIATE_HYDRATION_PRO_WARNING = "[REACT ON RAILS] The 'immediate_hydration' feature requires a " \
+                                        "React on Rails Pro license. " \
+                                        "Please visit https://shakacode.com/react-on-rails-pro to learn more."
+
+      # Generates the complete component specification script tag.
+      # Handles both immediate hydration (Pro feature) and standard cases.
+      def generate_component_script(render_options)
+        # Setup the page_loaded_js, which is the same regardless of prerendering or not!
+        # The reason is that React is smart about not doing extra work if the server rendering did its job.
+        component_specification_tag = content_tag(:script,
+                                                  json_safe_and_pretty(render_options.client_props).html_safe,
+                                                  type: "application/json",
+                                                  class: "js-react-on-rails-component",
+                                                  id: "js-react-on-rails-component-#{render_options.dom_id}",
+                                                  "data-component-name" => render_options.react_component_name,
+                                                  "data-trace" => (render_options.trace ? true : nil),
+                                                  "data-dom-id" => render_options.dom_id,
+                                                  "data-store-dependencies" =>
+                                                    render_options.store_dependencies&.to_json,
+                                                  "data-immediate-hydration" =>
+                                                    (render_options.immediate_hydration ? true : nil))
+
+        # Add immediate invocation script if immediate hydration is enabled
+        spec_tag = if render_options.immediate_hydration
+                     # Escape dom_id for JavaScript context
+                     escaped_dom_id = escape_javascript(render_options.dom_id)
+                     immediate_script = content_tag(:script, %(
+          typeof ReactOnRails === 'object' && ReactOnRails.reactOnRailsComponentLoaded('#{escaped_dom_id}');
+        ).html_safe)
+                     "#{component_specification_tag}\n#{immediate_script}"
+                   else
+                     component_specification_tag
+                   end
+
+        pro_warning_badge = pro_warning_badge_if_needed(render_options.explicitly_disabled_pro_options)
+        "#{pro_warning_badge}\n#{spec_tag}".html_safe
+      end
+
+      # Generates the complete store hydration script tag.
+      # Handles both immediate hydration (Pro feature) and standard cases.
+      def generate_store_script(redux_store_data)
+        pro_options_check_result = ReactOnRails::Pro::Utils.disable_pro_render_options_if_not_licensed(redux_store_data)
+        redux_store_data = pro_options_check_result[:raw_options]
+        explicitly_disabled_pro_options = pro_options_check_result[:explicitly_disabled_pro_options]
+
+        store_hydration_data = content_tag(:script,
+                                           json_safe_and_pretty(redux_store_data[:props]).html_safe,
+                                           type: "application/json",
+                                           "data-js-react-on-rails-store" => redux_store_data[:store_name].html_safe,
+                                           "data-immediate-hydration" =>
+                                             (redux_store_data[:immediate_hydration] ? true : nil))
+
+        # Add immediate invocation script if immediate hydration is enabled and Pro license is valid
+        store_hydration_scripts = if redux_store_data[:immediate_hydration]
+                                    # Escape store_name for JavaScript context
+                                    escaped_store_name = escape_javascript(redux_store_data[:store_name])
+                                    immediate_script = content_tag(:script, <<~JS.strip_heredoc.html_safe
+                                      typeof ReactOnRails === 'object' && ReactOnRails.reactOnRailsStoreLoaded('#{escaped_store_name}');
+                                    JS
+                                    )
+                                    "#{store_hydration_data}\n#{immediate_script}"
+                                  else
+                                    store_hydration_data
+                                  end
+
+        pro_warning_badge = pro_warning_badge_if_needed(explicitly_disabled_pro_options)
+        "#{pro_warning_badge}\n#{store_hydration_scripts}".html_safe
+      end
+
+      def pro_warning_badge_if_needed(explicitly_disabled_pro_options)
+        return "" unless explicitly_disabled_pro_options.any?
+
+        disabled_features_message = disabled_pro_features_message(explicitly_disabled_pro_options)
+        warning_message = "[REACT ON RAILS] #{disabled_features_message}\n" \
+                          "Please visit https://shakacode.com/react-on-rails-pro to learn more."
+        puts warning_message
+        Rails.logger.warn warning_message
+
+        tooltip_text = "#{disabled_features_message} Click to learn more."
+
+        <<~HTML.strip
+          <a href="https://shakacode.com/react-on-rails-pro" target="_blank" rel="noopener noreferrer" title="#{tooltip_text}">
+            <div style="position: fixed; top: 0; right: 0; width: 180px; height: 180px; overflow: hidden; z-index: 9999; pointer-events: none;">
+              <div style="position: absolute; top: 50px; right: -40px; transform: rotate(45deg); background-color: rgba(220, 53, 69, 0.85); color: white; padding: 7px 40px; text-align: center; font-weight: bold; font-family: sans-serif; font-size: 12px; box-shadow: 0 2px 8px rgba(0,0,0,0.3); pointer-events: auto;">
+                React On Rails Pro Required
+              </div>
+            </div>
+          </a>
+        HTML
+      end
+
+      def disabled_pro_features_message(explicitly_disabled_pro_options)
+        return "".html_safe unless explicitly_disabled_pro_options.any?
+
+        feature_list = explicitly_disabled_pro_options.join(", ")
+        feature_word = explicitly_disabled_pro_options.size == 1 ? "feature" : "features"
+        "The '#{feature_list}' #{feature_word} " \
+          "#{explicitly_disabled_pro_options.size == 1 ? 'requires' : 'require'} a " \
+          "React on Rails Pro license. "
+      end
+    end
+  end
+end

data/lib/react_on_rails/pro/utils.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# /*
+#  * Copyright (c) 2025 Shakacode LLC
+#  *
+#  * This file is NOT licensed under the MIT (open source) license.
+#  * It is part of the React on Rails Pro offering and is licensed separately.
+#  *
+#  * Unauthorized copying, modification, distribution, or use of this file,
+#  * via any medium, is strictly prohibited without a valid license agreement
+#  * from Shakacode LLC.
+#  *
+#  * For licensing terms, please see:
+#  * https://github.com/shakacode/react_on_rails/blob/master/REACT-ON-RAILS-PRO-LICENSE.md
+#  */
+
+module ReactOnRails
+  module Pro
+    module Utils
+      PRO_ONLY_OPTIONS = %i[immediate_hydration].freeze
+
+      # Checks if React on Rails Pro features are available
+      # @return [Boolean] true if Pro license is valid, false otherwise
+      def self.support_pro_features?
+        ReactOnRails::Utils.react_on_rails_pro_licence_valid?
+      end
+
+      def self.disable_pro_render_options_if_not_licensed(raw_options)
+        if support_pro_features?
+          return {
+            raw_options: raw_options,
+            explicitly_disabled_pro_options: []
+          }
+        end
+
+        raw_options_after_disable = raw_options.dup
+
+        explicitly_disabled_pro_options = PRO_ONLY_OPTIONS.select do |option|
+          # Use global configuration if it's not overridden in the options
+          next ReactOnRails.configuration.send(option) if raw_options[option].nil?
+
+          raw_options[option]
+        end
+        explicitly_disabled_pro_options.each { |option| raw_options_after_disable[option] = false }
+
+        {
+          raw_options: raw_options_after_disable,
+          explicitly_disabled_pro_options: explicitly_disabled_pro_options
+        }
+      end
+    end
+  end
+end