shakapacker 10.2.0 → 10.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 441942bb193dab20df1d0956197e3d441adb6fef5e25001a4eb1f05c69543312
-  data.tar.gz: 4aea05e5fa5f72da3b65fd108514400ca6c7140c85cdf7d10aa1d6edf6118d43
+  metadata.gz: 66455bdf084a5e63422cf5741b2ce549b2dc77dcd36553e8e5fa7dcc6ce34286
+  data.tar.gz: a7030178f8ec26e3c1243fbdeb806c2746d6b14484bc99142a35f3fa3f57e9dd
 SHA512:
-  metadata.gz: a2d3907c1a2d5121c7b70f72cb46c8ea09157e263241803b67ce2d250f7183121442bc0e0b6387d1552008565a3802e5a57c6447f4f6bee0d3e3f9214f16786f
-  data.tar.gz: 3b59158ac878b1403defdc3a22293a2559bb99d13c106175d2c72d637596ad4dfbdd5174aea80222070f50ee911bb7e585a1cae830886bb75be9f942f310e6ed
+  metadata.gz: ec0476cbbaaa7044f9f06a3fe207caad61350c309164deffa47d5990e583b025c03e235b4e0e110adac394461fce264b887a71de6159a43ce5664e7a8a133992
+  data.tar.gz: 3d625e63b6f838c9febaaad2dda13d43cd7486748d7e39d6ff09e5675d06ab8b85414b9d323c41a3b09fca5adb19ec193b6d90d5651dce92f8573cd18e23937f

data/CHANGELOG.md

@@ -1,4 +1,5 @@
 - For the changelog of versions prior to v6, see the [5.x stable branch of rails/webpacker](https://github.com/rails/webpacker/tree/5-x-stable).
+- **Please see the [v10 Upgrade Guide](./docs/v10_upgrade.md) for upgrading to version 10 and accounting for breaking changes.**
 - **Please see the [v9 Upgrade Guide](./docs/v9_upgrade.md) for upgrading to version 9 and accounting for breaking changes.**
 - Please see the [v8 Upgrade Guide](./docs/v8_upgrade.md) for upgrading to version 8 and accounting for breaking changes.
 - Please see the [v7 Upgrade Guide](./docs/v7_upgrade.md) for upgrading to new spelling in version 7.
@@ -9,6 +10,32 @@
 
 ## [Unreleased]
 
+## [v10.3.1] - August 3, 2026
+
+### Fixed
+
+- **Fixed 502 responses for proxied dev server assets under `rack-proxy` v1.** [PR #1222](https://github.com/shakacode/shakapacker/pull/1222) by [jcbpl](https://github.com/jcbpl). Fixes [#1220](https://github.com/shakacode/shakapacker/issues/1220).
+- **Fixed dev-server liveness checks treating refused macOS 27 connections as running.** The Ruby probe now verifies the connected socket's `SO_ERROR` result before proxying asset requests, avoiding false-positive dev-server detection and resulting 502 responses. [PR #1225](https://github.com/shakacode/shakapacker/pull/1225) by [justin808](https://github.com/justin808). Fixes [#1224](https://github.com/shakacode/shakapacker/issues/1224).
+- **Fixed webpack Babel, SWC, and esbuild rules skipping explicitly included `.cjs` files.** [PR #1219](https://github.com/shakacode/shakapacker/pull/1219) by [oiahoon](https://github.com/oiahoon). Fixes [#1218](https://github.com/shakacode/shakapacker/issues/1218).
+- **Added a `shakapacker:doctor` warning for Rspack React Refresh v2 configs that still use the v1 default-export constructor pattern.** [PR #1207](https://github.com/shakacode/shakapacker/pull/1207) by [justin808](https://github.com/justin808). Existing configs with `const ReactRefreshPlugin = require("@rspack/plugin-react-refresh")` followed by `new ReactRefreshPlugin()` can fail after upgrading to `@rspack/plugin-react-refresh` v2 with `ReactRefreshPlugin is not a constructor`; Doctor now points to the affected JS/TS config file and suggests the named-export/default/module compatibility form. Fixes [#1204](https://github.com/shakacode/shakapacker/issues/1204).
+- **Fixed the missing-`@babel/core` failure to report an actionable install message.** [PR #1212](https://github.com/shakacode/shakapacker/pull/1212) by [justin808](https://github.com/justin808). Babel-transpiled builds whose app lacks `@babel/core` previously surfaced a raw module-resolution error from the Babel 8 compatibility check; the rule now explains which package to install and how to switch `javascript_transpiler` instead. Refs [#1163](https://github.com/shakacode/shakapacker/issues/1163).
+
+### Documentation
+
+- **Documented the required `css-loader@^7.1.4` in the v10 Rspack upgrade instructions.** [PR #1211](https://github.com/shakacode/shakapacker/pull/1211) by [justin808](https://github.com/justin808). The v10 upgrade guide's copy-paste Rspack v2 commands omitted `css-loader`, so apps following them could upgrade into an unsatisfied peer dependency.
+
+## [v10.3.0] - July 5, 2026
+
+### Added
+
+- **Allowed `webpack-dev-server` v6**. [PR #1102](https://github.com/shakacode/shakapacker/pull/1102) by [G-Rath](https://github.com/G-Rath).
+
+### Fixed
+
+- **Fixed implicit SWC defaults for existing webpack/Babel apps without `swc-loader`.** [PR #1206](https://github.com/shakacode/shakapacker/pull/1206) by [justin808](https://github.com/justin808). Webpack apps that omit both `javascript_transpiler` and the deprecated `webpack_loader` now fall back to Babel with a warning when Shakapacker's bundled SWC default is active, `swc-loader` is missing, and Babel is present. Explicit transpiler settings, webpack apps with `swc-loader`, and Rspack's built-in SWC path keep their existing behavior. Closes [#1203](https://github.com/shakacode/shakapacker/issues/1203).
+- **Fixed JavaScript config loading for missing Rails environments to use the production fallback.** [PR #1206](https://github.com/shakacode/shakapacker/pull/1206) by [justin808](https://github.com/justin808). When `RAILS_ENV` has no matching section in `config/shakapacker.yml`, the Node package config now merges the `production` section instead of only bundled defaults, matching Ruby configuration loading and honoring explicit production `javascript_transpiler`, `source_path`, `dev_server`, and related settings for custom environments such as staging.
+- **Fixed helper binstubs delegating Node resolution to Ruby `exec` in unset and empty `PATH` environments.** [PR #1200](https://github.com/shakacode/shakapacker/pull/1200) and [PR #1201](https://github.com/shakacode/shakapacker/pull/1201) by [justin808](https://github.com/justin808). Restores shell-compatible Node lookup for `bin/shakapacker-config` and `bin/diff-bundler-config` after the `v10.2.0` Ruby-binstub regression, while keeping friendly missing-Node errors for `ENOENT` and `EACCES`.
+
 ## [v10.2.0] - July 3, 2026
 
 ### Added
@@ -973,7 +1000,9 @@ Note: [Rubygem is 6.3.0.pre.rc.1](https://rubygems.org/gems/shakapacker/versions
 
 See [CHANGELOG.md in rails/webpacker (up to v5.4.3)](https://github.com/rails/webpacker/blob/master/CHANGELOG.md)
 
-[Unreleased]: https://github.com/shakacode/shakapacker/compare/v10.2.0...main
+[Unreleased]: https://github.com/shakacode/shakapacker/compare/v10.3.1...main
+[v10.3.1]: https://github.com/shakacode/shakapacker/compare/v10.3.0...v10.3.1
+[v10.3.0]: https://github.com/shakacode/shakapacker/compare/v10.2.0...v10.3.0
 [v10.2.0]: https://github.com/shakacode/shakapacker/compare/v10.1.0...v10.2.0
 [v10.1.0]: https://github.com/shakacode/shakapacker/compare/v10.0.0...v10.1.0
 [v10.0.0]: https://github.com/shakacode/shakapacker/compare/v9.7.0...v10.0.0

data/README.md

@@ -114,7 +114,8 @@ and release-to-release upgrade paths.
 
 Older major-version docs:
 
-- [v10.0.0 release notes](https://github.com/shakacode/shakapacker/releases/tag/v10.0.0)
+- [v10 upgrade guide](https://github.com/shakacode/shakapacker/blob/main/docs/v10_upgrade.md)
+  ([docs site](https://shakapacker.com/docs/v10_upgrade/))
 - [v9 upgrade guide](https://shakapacker.com/docs/v9_upgrade/)
 - [v8 upgrade guide](https://shakapacker.com/docs/v8_upgrade/)
 - [v7 upgrade guide](https://shakapacker.com/docs/v7_upgrade/)

data/lib/install/bin/diff-bundler-config

@@ -1,7 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "rbconfig"
 require "yaml"
 
 # This binstub is managed by Shakapacker. Delete it and rerun the install or init command to regenerate it.
@@ -14,36 +13,39 @@ def shakapacker_app_root
   Dir.pwd
 end
 
-def shakapacker_executable_candidates(executable)
-  extensions = [
-    RbConfig::CONFIG["EXEEXT"],
-    *ENV.fetch("PATHEXT", "").split(File::PATH_SEPARATOR)
-  ].compact.reject(&:empty?)
-  return [executable] if extensions.empty? || File.extname(executable) != ""
+def shakapacker_node_binary
+  "node"
+end
 
-  ([executable] + extensions.map { |extension| "#{executable}#{extension}" }).uniq
+def shakapacker_warn_missing_node
+  warn '[Shakapacker] Could not find Node.js executable "node". ' \
+       "Install Node.js and try again."
+  exit 1
 end
 
-def shakapacker_find_executable(executable)
-  ENV.fetch("PATH", "").split(File::PATH_SEPARATOR, -1).each do |path|
-    search_path = path.empty? ? Dir.pwd : path
+def shakapacker_exec_env(launch_dir)
+  return {} unless ENV.key?("PATH")
 
-    shakapacker_executable_candidates(executable).each do |candidate|
-      executable_path = File.join(search_path, candidate)
-      return executable_path if File.file?(executable_path) && File.executable?(executable_path)
-    end
-  end
+  path_entries = ENV["PATH"].split(File::PATH_SEPARATOR, -1)
+  path_entries = [""] if path_entries.empty?
 
-  nil
+  normalized_path = path_entries.map do |entry|
+    entry.empty? ? launch_dir : File.absolute_path(entry, launch_dir)
+  end.join(File::PATH_SEPARATOR)
+
+  { "PATH" => normalized_path }
 end
 
-def shakapacker_node_binary
-  node_bin = shakapacker_find_executable("node")
-  return node_bin if node_bin
+def shakapacker_exec_node(script_path, argv, launch_dir)
+  exec_env = shakapacker_exec_env(launch_dir)
 
-  warn '[Shakapacker] Could not find Node.js executable "node". ' \
-       "Install Node.js and try again."
-  exit 1
+  if exec_env.empty?
+    exec shakapacker_node_binary, script_path, *argv
+  else
+    exec exec_env, shakapacker_node_binary, script_path, *argv
+  end
+rescue Errno::ENOENT, Errno::EACCES
+  shakapacker_warn_missing_node
 end
 
 def shakapacker_node_env
@@ -130,9 +132,9 @@ end
 ENV["RAILS_ENV"] ||= ENV["RACK_ENV"] || "development"
 ENV["NODE_ENV"] ||= shakapacker_node_env
 
+launch_dir = Dir.pwd
 app_root = shakapacker_app_root
 client_root = shakapacker_client_root(app_root)
-node_bin = shakapacker_node_binary
 script_paths = shakapacker_package_script_paths(app_root, client_root, "diff-bundler-config.cjs")
 script_path = script_paths.find { |path| File.file?(path) }
 
@@ -142,5 +144,5 @@ unless script_path
 end
 
 Dir.chdir(app_root) do
-  exec node_bin, script_path, *ARGV
+  shakapacker_exec_node(script_path, ARGV, launch_dir)
 end

data/lib/install/bin/shakapacker-config

@@ -1,7 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "rbconfig"
 require "yaml"
 
 # This binstub is managed by Shakapacker. Delete it and rerun the install or init command to regenerate it.
@@ -14,36 +13,39 @@ def shakapacker_app_root
   Dir.pwd
 end
 
-def shakapacker_executable_candidates(executable)
-  extensions = [
-    RbConfig::CONFIG["EXEEXT"],
-    *ENV.fetch("PATHEXT", "").split(File::PATH_SEPARATOR)
-  ].compact.reject(&:empty?)
-  return [executable] if extensions.empty? || File.extname(executable) != ""
+def shakapacker_node_binary
+  "node"
+end
 
-  ([executable] + extensions.map { |extension| "#{executable}#{extension}" }).uniq
+def shakapacker_warn_missing_node
+  warn '[Shakapacker] Could not find Node.js executable "node". ' \
+       "Install Node.js and try again."
+  exit 1
 end
 
-def shakapacker_find_executable(executable)
-  ENV.fetch("PATH", "").split(File::PATH_SEPARATOR, -1).each do |path|
-    search_path = path.empty? ? Dir.pwd : path
+def shakapacker_exec_env(launch_dir)
+  return {} unless ENV.key?("PATH")
 
-    shakapacker_executable_candidates(executable).each do |candidate|
-      executable_path = File.join(search_path, candidate)
-      return executable_path if File.file?(executable_path) && File.executable?(executable_path)
-    end
-  end
+  path_entries = ENV["PATH"].split(File::PATH_SEPARATOR, -1)
+  path_entries = [""] if path_entries.empty?
 
-  nil
+  normalized_path = path_entries.map do |entry|
+    entry.empty? ? launch_dir : File.absolute_path(entry, launch_dir)
+  end.join(File::PATH_SEPARATOR)
+
+  { "PATH" => normalized_path }
 end
 
-def shakapacker_node_binary
-  node_bin = shakapacker_find_executable("node")
-  return node_bin if node_bin
+def shakapacker_exec_node(script_path, argv, launch_dir)
+  exec_env = shakapacker_exec_env(launch_dir)
 
-  warn '[Shakapacker] Could not find Node.js executable "node". ' \
-       "Install Node.js and try again."
-  exit 1
+  if exec_env.empty?
+    exec shakapacker_node_binary, script_path, *argv
+  else
+    exec exec_env, shakapacker_node_binary, script_path, *argv
+  end
+rescue Errno::ENOENT, Errno::EACCES
+  shakapacker_warn_missing_node
 end
 
 def shakapacker_node_env
@@ -130,9 +132,9 @@ end
 ENV["RAILS_ENV"] ||= ENV["RACK_ENV"] || "development"
 ENV["NODE_ENV"] ||= shakapacker_node_env
 
+launch_dir = Dir.pwd
 app_root = shakapacker_app_root
 client_root = shakapacker_client_root(app_root)
-node_bin = shakapacker_node_binary
 script_paths = shakapacker_package_script_paths(app_root, client_root, "shakapacker-config.cjs")
 script_path = script_paths.find { |path| File.file?(path) }
 
@@ -142,5 +144,5 @@ unless script_path
 end
 
 Dir.chdir(app_root) do
-  exec node_bin, script_path, *ARGV
+  shakapacker_exec_node(script_path, ARGV, launch_dir)
 end

data/lib/install/config/shakapacker.yml

@@ -59,7 +59,9 @@ default: &default
   cache_manifest: false
 
   # Select JavaScript transpiler to use
-  # Available options: 'swc' (default, 20x faster), 'babel', 'esbuild', or 'none'
+  # Available options: 'swc' (bundled default), 'babel', 'esbuild', or 'none'
+  # Webpack apps that omit this setting use the bundled SWC default when swc-loader is
+  # installed, but fall back to Babel with a warning when only Babel tooling is present.
   # Use 'none' when providing a completely custom webpack configuration
   # Note: When using rspack, swc is used automatically regardless of this setting
   javascript_transpiler: "swc"

data/lib/install/package.json

@@ -11,7 +11,7 @@
     "webpack": "^5.101.0",
     "webpack-assets-manifest": "^5.0.6 || ^6.0.0",
     "webpack-cli": "^4.9.2 || ^5.0.0 || ^6.0.0 || ^7.0.0",
-    "webpack-dev-server": "^5.2.2",
+    "webpack-dev-server": "^5.2.2 || ^6.0.0",
     "webpack-merge": "^5.8.0 || ^6.0.0",
     "webpack-subresource-integrity": "^5.1.0"
   },

data/lib/shakapacker/configuration.rb

@@ -50,6 +50,13 @@ class Shakapacker::Configuration
     /\A(?:--config|-c|--node-env|--nodeEnv|--bundler|--build|--init|--list-builds)(?:=.*)?\z/
   private_constant :SHAKAPACKER_MANAGED_COMPILE_FLAG_PATTERN
 
+  IMPLICIT_SWC_BABEL_FALLBACK_WARNING =
+    "`javascript_transpiler` is not set in config/shakapacker.yml. " \
+    "Shakapacker defaults to SWC, but swc-loader is not installed and Babel was detected, so Babel will be used. " \
+    "Set `javascript_transpiler: babel` (or `swc`) explicitly to silence this message. " \
+    "See https://github.com/shakacode/shakapacker/blob/main/docs/transpiler-migration.md"
+  private_constant :IMPLICIT_SWC_BABEL_FALLBACK_WARNING
+
   DISALLOWED_WEBPACK_COMPILE_FLAGS =
     (SHAKAPACKER_NODE_FLAGS + SHAKAPACKER_RUNNER_COMMANDS + SHAKAPACKER_WATCH_FLAGS +
       SHAKAPACKER_MANAGED_COMPILE_FLAGS).freeze
@@ -357,24 +364,54 @@ class Shakapacker::Configuration
   # Resolution order:
   # 1. javascript_transpiler setting in config file
   # 2. webpack_loader setting in config file (deprecated)
-  # 3. Default based on bundler (swc for rspack, babel for webpack)
+  # 3. Bundled defaults
+  # 4. Babel fallback for implicit webpack/SWC defaults when swc-loader is missing
   #
   # Validates that the configured transpiler matches installed packages.
   #
   # @return [String] "babel", "swc", or "esbuild"
   def javascript_transpiler
-    # Show deprecation warning if using old 'webpack_loader' key
-    if data.has_key?(:webpack_loader) && !data.has_key?(:javascript_transpiler)
-      $stderr.puts "⚠️  DEPRECATION WARNING: The 'webpack_loader' configuration option is deprecated. Please use 'javascript_transpiler' instead as it better reflects its purpose of configuring JavaScript transpilation regardless of the bundler used."
-    end
+    return @javascript_transpiler if defined?(@javascript_transpiler)
+
+    @javascript_transpiler =
+      begin
+        javascript_transpiler_configured = config_value_configured?(:javascript_transpiler)
+        webpack_loader_configured = config_value_present?(:webpack_loader)
+
+        # Show deprecation warning if using old 'webpack_loader' key
+        if webpack_loader_configured && !javascript_transpiler_configured
+          $stderr.puts "⚠️  DEPRECATION WARNING: The 'webpack_loader' configuration option is deprecated. Please use 'javascript_transpiler' instead as it better reflects its purpose of configuring JavaScript transpilation regardless of the bundler used."
+        end
+
+        # Use explicit config if set, otherwise default based on bundler
+        current_javascript_transpiler =
+          if javascript_transpiler_configured
+            fetch(:javascript_transpiler)
+          elsif data.has_key?(:javascript_transpiler)
+            defaults[:javascript_transpiler]
+          else
+            fetch(:javascript_transpiler)
+          end
+
+        transpiler =
+          if webpack_loader_configured && !javascript_transpiler_configured
+            fetch(:webpack_loader) || default_javascript_transpiler
+          else
+            current_javascript_transpiler || fetch(:webpack_loader) || default_javascript_transpiler
+          end
 
-    # Use explicit config if set, otherwise default based on bundler
-    transpiler = fetch(:javascript_transpiler) || fetch(:webpack_loader) || default_javascript_transpiler
+        if !javascript_transpiler_configured &&
+            !webpack_loader_configured &&
+            implicit_swc_to_babel_fallback?(transpiler)
+          $stderr.puts IMPLICIT_SWC_BABEL_FALLBACK_WARNING
+          transpiler = "babel"
+        end
 
-    # Validate transpiler configuration
-    validate_transpiler_configuration(transpiler) unless self.class.installing
+        # Validate transpiler configuration
+        validate_transpiler_configuration(transpiler) unless self.class.installing
 
-    transpiler
+        transpiler
+      end
   end
 
   # Deprecated alias for {#javascript_transpiler}
@@ -461,42 +498,124 @@ class Shakapacker::Configuration
       rspack? ? "swc" : "babel"
     end
 
+    def implicit_swc_to_babel_fallback?(transpiler)
+      webpack? &&
+        transpiler == "swc" &&
+        !package_dependency?("swc-loader") &&
+        package_dependency?("babel-loader")
+    end
+
+    def package_dependency?(package_name)
+      declared_package_dependencies.key?(package_name)
+    end
+
+    def config_value_present?(key)
+      return false unless data.has_key?(key)
+
+      value = data[key]
+      value.is_a?(String) && !value.strip.empty?
+    end
+
+    def config_value_configured?(key)
+      return false unless data.has_key?(key)
+
+      value = data[key]
+      return false if value.nil?
+      return false if value.is_a?(String) && value.strip.empty?
+
+      true
+    end
+
+    def declared_package_dependencies
+      return @declared_package_dependencies if defined?(@declared_package_dependencies)
+
+      @declared_package_dependencies =
+        package_json_paths.reverse_each.each_with_object({}) do |path, dependencies|
+          package_json = parse_package_json(path)
+          next unless package_json
+
+          dependencies.merge!(installable_package_dependencies(package_json))
+        end
+    end
+
+    def installable_package_dependencies(package_json)
+      (package_json["optionalDependencies"] || {})
+        .merge(package_json["devDependencies"] || {})
+        .merge(package_json["dependencies"] || {})
+    end
+
+    def package_json_paths
+      @package_json_paths ||= package_root_paths
+        .map { |path| path.join("package.json") }
+        .select(&:exist?)
+    end
+
+    def parse_package_json(path)
+      JSON.parse(File.read(path))
+    rescue JSON::ParserError, SystemCallError
+      nil
+    end
+
+    def package_root_paths
+      @package_root_paths ||= [javascript_package_root_path, root_path].uniq
+    end
+
+    def javascript_package_root_path
+      @javascript_package_root_path ||= begin
+        resolved_source_path = source_path.expand_path
+        app_root = root_path.expand_path
+
+        if path_within?(resolved_source_path, app_root)
+          current = resolved_source_path
+          loop do
+            break current if current.join("package.json").exist?
+            break root_path if current == app_root
+
+            parent = current.dirname
+            break root_path if parent == current
+
+            current = parent
+          end
+        else
+          root_path
+        end
+      rescue StandardError
+        root_path
+      end
+    end
+
+    def path_within?(path, parent)
+      path.to_s == parent.to_s || path.to_s.start_with?("#{parent}#{File::SEPARATOR}")
+    end
+
     def validate_transpiler_configuration(transpiler)
       return unless ENV["NODE_ENV"] != "test" # Skip validation in test environment
 
       # Skip validation if transpiler is set to 'none' (custom webpack config)
       return if transpiler == "none"
 
-      # Check if package.json exists
-      package_json_path = root_path.join("package.json")
-      return unless package_json_path.exist?
+      all_deps = declared_package_dependencies
+      return if all_deps.empty?
 
-      begin
-        package_json = JSON.parse(File.read(package_json_path))
-        all_deps = (package_json["dependencies"] || {}).merge(package_json["devDependencies"] || {})
-
-        # Check for transpiler mismatch
-        has_babel = all_deps.keys.any? { |pkg| pkg.start_with?("@babel/", "babel-") }
-        has_swc = all_deps.keys.any? { |pkg| pkg.include?("swc") }
-        has_esbuild = all_deps.keys.any? { |pkg| pkg.include?("esbuild") }
-
-        case transpiler
-        when "babel"
-          if !has_babel && has_swc
-            warn_transpiler_mismatch("Babel", "SWC packages found but Babel is configured")
-          end
-        when "swc"
-          if !has_swc && has_babel
-            warn_transpiler_mismatch("SWC", "Babel packages found but SWC is configured")
-          end
-        when "esbuild"
-          if !has_esbuild && (has_babel || has_swc)
-            other = has_babel ? "Babel" : "SWC"
-            warn_transpiler_mismatch("esbuild", "#{other} packages found but esbuild is configured")
-          end
+      # Check for transpiler mismatch
+      has_babel = all_deps.keys.any? { |pkg| pkg.start_with?("@babel/", "babel-") }
+      has_swc = all_deps.keys.any? { |pkg| pkg.include?("swc") }
+      has_esbuild = all_deps.keys.any? { |pkg| pkg.include?("esbuild") }
+
+      case transpiler
+      when "babel"
+        if !has_babel && has_swc
+          warn_transpiler_mismatch("Babel", "SWC packages found but Babel is configured")
+        end
+      when "swc"
+        if !has_swc && has_babel
+          warn_transpiler_mismatch("SWC", "Babel packages found but SWC is configured")
+        end
+      when "esbuild"
+        if !has_esbuild && (has_babel || has_swc)
+          other = has_babel ? "Babel" : "SWC"
+          warn_transpiler_mismatch("esbuild", "#{other} packages found but esbuild is configured")
         end
-      rescue JSON::ParserError
-        # Ignore if package.json is malformed
       end
     end
 

data/lib/shakapacker/dev_server.rb

@@ -47,8 +47,13 @@ class Shakapacker::DevServer
   # @return [Boolean] true if the dev server is running
   def running?
     if config.dev_server.present?
-      Socket.tcp(host, port, connect_timeout: connect_timeout).close
-      true
+      socket = Socket.tcp(host, port, connect_timeout: connect_timeout)
+
+      begin
+        socket.getsockopt(Socket::SOL_SOCKET, Socket::SO_ERROR).int.zero?
+      ensure
+        socket.close
+      end
     else
       false
     end

data/lib/shakapacker/dev_server_proxy.rb

@@ -11,6 +11,10 @@ class Shakapacker::DevServerProxy < Rack::Proxy
 
   def perform_request(env)
     if env["PATH_INFO"].start_with?("/#{public_output_uri_path}") && dev_server.running?
+      # rack-proxy v1 refuses to derive the backend from the Host header.
+      env["rack.backend"] = URI::Generic.build(
+        scheme: dev_server.protocol, host: dev_server.host, port: dev_server.port
+      )
       env["HTTP_HOST"] = env["HTTP_X_FORWARDED_HOST"] = dev_server.host
       env["HTTP_X_FORWARDED_SERVER"] = dev_server.host_with_port
       env["HTTP_PORT"] = env["HTTP_X_FORWARDED_PORT"] = dev_server.port.to_s

data/lib/shakapacker/doctor.rb

@@ -59,6 +59,9 @@ module Shakapacker
       "@rspack/plugin-react-refresh" => "^2.0.0"
     }.freeze
 
+    RSPACK_REACT_REFRESH_PACKAGE = "@rspack/plugin-react-refresh".freeze
+    VERSION_UPPER_BOUND_OPERATORS = %w[< <=].freeze
+
     CUSTOM_HYBRID_LOADER_DEPS = %w[
       babel-loader
       esbuild-loader
@@ -170,6 +173,7 @@ module Shakapacker
         check_css_modules_configuration
         check_bundler_dependencies if config_exists?
         check_rspack_cache_configuration if config_exists?
+        check_rspack_react_refresh_plugin_constructor if config_exists?
         check_file_type_dependencies if config_exists?
         check_sri_dependencies if config_exists?
         check_peer_dependencies
@@ -511,12 +515,14 @@ module Shakapacker
 
       def check_javascript_transpiler_dependencies
         transpiler = explicit_javascript_transpiler
+        implicit_babel_fallback = false
 
         if transpiler.nil?
-          @info << "No javascript_transpiler configured - defaulting to SWC (20x faster than Babel)"
-          transpiler = "swc"
+          transpiler = javascript_transpiler
+          implicit_babel_fallback = transpiler == "babel"
         end
 
+        @resolved_javascript_transpiler = transpiler
         return if transpiler == "none"
 
         bundler = assets_bundler
@@ -541,7 +547,7 @@ module Shakapacker
         case transpiler
         when "babel"
           check_babel_dependencies
-          check_babel_performance_suggestion
+          check_babel_performance_suggestion unless implicit_babel_fallback
         when "swc"
           check_swc_dependencies(bundler) unless inferred_hybrid_graph
         when "esbuild"
@@ -573,6 +579,20 @@ module Shakapacker
         @info << "Consider switching to SWC for 20x faster compilation. Set javascript_transpiler: 'swc' in shakapacker.yml"
       end
 
+      def implicit_javascript_transpiler
+        if assets_bundler == "webpack" && !package_installed?("swc-loader") && package_installed?("babel-loader")
+          @info << "`javascript_transpiler` is not set in config/shakapacker.yml. " \
+                   "Shakapacker defaults to SWC, but swc-loader is not installed and Babel was detected, so Babel will be used. " \
+                   "Set `javascript_transpiler: babel` (or `swc`) explicitly to silence this message. " \
+                   "See https://github.com/shakacode/shakapacker/blob/main/docs/transpiler-migration.md"
+          "babel"
+        else
+          @info << "No javascript_transpiler configured - using bundled SWC default. " \
+                   "Set javascript_transpiler: 'swc' or 'babel' explicitly in shakapacker.yml to silence this message."
+          "swc"
+        end
+      end
+
       def check_swc_dependencies(bundler)
         if bundler == "webpack"
           unless package_installed?("@swc/core")
@@ -862,14 +882,89 @@ module Shakapacker
                      "See https://rspack.rs/config/cache for options.")
       end
 
+      def check_rspack_react_refresh_plugin_constructor
+        return unless rspack_react_refresh_check_applicable?
+        return unless rspack_react_refresh_plugin_v2_or_newer?
+
+        rspack_react_refresh_config_paths.each do |path|
+          content = File.read(path)
+          next unless legacy_rspack_react_refresh_constructor?(content)
+
+          relative = config_path_for_warning(path)
+          add_action_required("Rspack React Refresh config #{relative} uses the " \
+                              "#{RSPACK_REACT_REFRESH_PACKAGE} v1 default-export constructor pattern. " \
+                              "With #{RSPACK_REACT_REFRESH_PACKAGE} v2, rspack may fail with " \
+                              "'ReactRefreshPlugin is not a constructor'.")
+          add_fix_hint("Use a compat constructor: const ReactRefresh = require(\"#{RSPACK_REACT_REFRESH_PACKAGE}\"); " \
+                       "const ReactRefreshRspackPlugin = ReactRefresh.ReactRefreshRspackPlugin || " \
+                       "ReactRefresh.default || ReactRefresh; then call new ReactRefreshRspackPlugin().")
+        rescue SystemCallError => e
+          add_info_warning("Unable to validate Rspack React Refresh config #{config_path_for_warning(path)}: #{e.message}")
+        end
+      end
+
+      def rspack_react_refresh_check_applicable?
+        assets_bundler == "rspack" || unconfigured_hybrid_loader_graph?
+      end
+
+      def rspack_react_refresh_plugin_v2_or_newer?
+        version = installed_package_version(RSPACK_REACT_REFRESH_PACKAGE)
+        return version >= Gem::Version.new("2.0.0") if version
+
+        package_specifier_allows_version_or_newer?(
+          package_json_dependency_version(RSPACK_REACT_REFRESH_PACKAGE),
+          Gem::Version.new("2.0.0")
+        )
+      end
+
+      def rspack_react_refresh_config_paths
+        config_dir = rspack_react_refresh_config_dir
+        config_dir_path = Pathname.new(File.join(root_path.to_s, config_dir))
+        return [] unless config_dir_path.directory?
+
+        path = active_bundler_config_path_in(config_dir)
+        path ? [path] : []
+      end
+
+      def rspack_react_refresh_config_dir
+        config_dir = config.assets_bundler_config_path.to_s
+
+        if assets_bundler == "rspack" || same_directory_hybrid_config_present?(config_dir)
+          config_dir
+        else
+          "config/rspack"
+        end
+      end
+
+      def legacy_rspack_react_refresh_constructor?(content)
+        stripped = strip_rspack_config_comments_and_literals(content, preserve_literals: [RSPACK_REACT_REFRESH_PACKAGE])
+        constructor_names = []
+
+        constructor_names.concat(stripped.scan(
+          /\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*require\(\s*["']#{Regexp.escape(RSPACK_REACT_REFRESH_PACKAGE)}["']\s*\)(?=\s*(?:[;,\)]|$))/
+        ).flatten)
+        constructor_names.concat(stripped.scan(
+          /\bimport\s+([A-Za-z_$][\w$]*)\s*(?:,\s*\{[^}]*\}\s*)?\s+from\s*["']#{Regexp.escape(RSPACK_REACT_REFRESH_PACKAGE)}["']/
+        ).flatten)
+        constructor_names.concat(stripped.scan(
+          /\bimport\s+\*\s+as\s+([A-Za-z_$][\w$]*)\s+from\s*["']#{Regexp.escape(RSPACK_REACT_REFRESH_PACKAGE)}["']/
+        ).flatten)
+
+        constructor_names.uniq.any? do |constructor_name|
+          stripped.match?(/\bnew\s+#{Regexp.escape(constructor_name)}\s*\(/)
+        end
+      end
+
       # Returns the single active config path the runner would load, or nil. Mirrors the
       # resolution order in Shakapacker::Runner#find_rspack_config_with_fallback so the
       # doctor inspects the same file the build will actually use (and so unused sibling
       # configs in the same directory don't trigger spurious warnings).
       # NOTE: keep this candidate list in sync with Runner#find_rspack_config_with_fallback.
       def active_assets_bundler_config_path
-        config_dir = config.assets_bundler_config_path.to_s
+        active_bundler_config_path_in(config.assets_bundler_config_path.to_s)
+      end
 
+      def active_bundler_config_path_in(config_dir)
         candidates = %w[ts js].map { |ext| Pathname.new(File.join(root_path.to_s, config_dir, "rspack.config.#{ext}")) }
         candidates += %w[ts js].map { |ext| Pathname.new(File.join(root_path.to_s, config_dir, "webpack.config.#{ext}")) }
         if default_rspack_config_dir?(config_dir)
@@ -928,7 +1023,7 @@ module Shakapacker
         stripped.gsub(%r{/(?:\\.|\[[^\]\n]*\]|[^/\n\\\[])+?/[gimsuy]*}, "")
       end
 
-      def strip_rspack_config_comments_and_literals(content)
+      def strip_rspack_config_comments_and_literals(content, preserve_literals: [])
         stripped = +""
         index = 0
 
@@ -971,8 +1066,12 @@ module Shakapacker
             end
 
             literal = content[index...literal_end]
-            stripped << '""'
-            stripped << literal.gsub(/[^\n]/, "")
+            if preserved_js_string_literal?(literal, char, preserve_literals)
+              stripped << literal
+            else
+              stripped << '""'
+              stripped << literal.gsub(/[^\n]/, "")
+            end
             index = literal_end
           elsif char == "`"
             literal_end = index + 1
@@ -1013,6 +1112,12 @@ module Shakapacker
         stripped
       end
 
+      def preserved_js_string_literal?(literal, quote, preserve_literals)
+        return false unless literal.end_with?(quote)
+
+        preserve_literals.include?(literal[1...-1])
+      end
+
       def direct_export_cache_disabled?(stripped)
         # Match `cache: false` only near an exported config object at brace depth
         # 1. This avoids warning on local base config objects while still
@@ -1167,8 +1272,9 @@ module Shakapacker
           return versions.min
         end
 
+        return package_version_from_range_specifier(cleaned) if cleaned.match?(/[<>=]/)
         return nil unless cleaned.match?(/\A[\^~]?\d/)
-        return nil if cleaned.match?(/(\s|\|\||[<>=:]|\A(?:git|file|link|workspace|npm):)/)
+        return nil if cleaned.match?(/(\s|\|\||:|\A(?:git|file|link|workspace|npm):)/)
 
         match = cleaned.sub(/\A[\^~]/, "").match(/\A(\d+(?:\.\d+){0,2})(?:-[0-9A-Za-z.-]+)?\z/)
         match && Gem::Version.new(match[1])
@@ -1176,6 +1282,48 @@ module Shakapacker
         nil
       end
 
+      def package_version_from_range_specifier(specifier)
+        lower_bounds = specifier.scan(/(?:\A|\s)(?:>=|>)\s*(\d+(?:\.\d+){0,2})(?:-[0-9A-Za-z.-]+)?/)
+        versions = lower_bounds.flatten.map { |version| Gem::Version.new(version) }
+
+        versions.max
+      rescue ArgumentError
+        nil
+      end
+
+      def package_specifier_allows_version_or_newer?(specifier, minimum)
+        return false unless specifier
+
+        cleaned = specifier.strip
+        if cleaned.include?("||")
+          return cleaned.split("||").any? { |part| package_specifier_allows_version_or_newer?(part, minimum) }
+        end
+        return false if cleaned.match?(/(:|\A(?:git|file|link|workspace|npm):)/)
+
+        if cleaned.match?(/[<>=]/)
+          return package_range_specifier_allows_version_or_newer?(cleaned, minimum)
+        end
+
+        version = package_version_from_specifier(cleaned)
+        version && version >= minimum
+      end
+
+      def package_range_specifier_allows_version_or_newer?(specifier, minimum)
+        comparators = specifier.scan(/(?:\A|\s)(<=|<|>=|>|=)\s*(\d+(?:\.\d+){0,2})(?:-[0-9A-Za-z.-]+)?/)
+        return false if comparators.empty?
+
+        equalities = comparators.select { |operator, _version| operator == "=" }
+        return equalities.any? { |_operator, version| Gem::Version.new(version) >= minimum } if equalities.any?
+
+        upper_bounds = comparators.select { |operator, _version| VERSION_UPPER_BOUND_OPERATORS.include?(operator) }
+        upper_bounds.all? do |operator, version|
+          parsed = Gem::Version.new(version)
+          operator == "<" ? parsed > minimum : parsed >= minimum
+        end
+      rescue ArgumentError
+        false
+      end
+
       def declared_package_dependencies
         @declared_package_dependencies ||= begin
           package_json_paths.reverse_each.each_with_object({}) do |path, dependencies|
@@ -1271,13 +1419,20 @@ module Shakapacker
 
       def javascript_transpiler_configured?
         !javascript_transpiler_env_override.nil? ||
-          config_key_defined?(:javascript_transpiler) ||
-          config_key_defined?(:webpack_loader)
+          config_key_configured?(:javascript_transpiler) ||
+          config_key_present?(:webpack_loader)
       end
 
       def javascript_transpiler
-        transpiler = javascript_transpiler_env_override || config.javascript_transpiler
-        blank_config_value?(transpiler) ? default_javascript_transpiler : transpiler
+        return @resolved_javascript_transpiler if defined?(@resolved_javascript_transpiler)
+
+        @resolved_javascript_transpiler =
+          if javascript_transpiler_configured?
+            transpiler = javascript_transpiler_env_override || config.javascript_transpiler
+            blank_config_value?(transpiler) ? default_javascript_transpiler : transpiler
+          else
+            implicit_javascript_transpiler
+          end
       end
 
       def explicit_javascript_transpiler
@@ -1329,7 +1484,7 @@ module Shakapacker
       end
 
       def blank_config_value?(value)
-        value.nil? || (value.respond_to?(:empty?) && value.empty?)
+        value.nil? || (value.is_a?(String) && value.strip.empty?) || (value.respond_to?(:empty?) && value.empty?)
       end
 
       def default_javascript_transpiler
@@ -1337,14 +1492,15 @@ module Shakapacker
       end
 
       def config_key_present?(key)
-        !blank_config_value?(config_value(key))
+        value = config_value(key)
+        value.is_a?(String) && !value.strip.empty?
       end
 
-      def config_key_defined?(key)
+      def config_key_configured?(key)
         return false unless config.respond_to?(:data)
 
         data = config.data
-        data.respond_to?(:key?) && data.key?(key)
+        data.respond_to?(:key?) && data.key?(key) && !blank_config_value?(data[key])
       end
 
       def config_value(key)
@@ -1383,7 +1539,7 @@ module Shakapacker
           if path_within?(source_path, app_root)
             current = source_path
             loop do
-              break current if package_root_marker?(current)
+              break current if current.join("package.json").exist?
               break root_path if current == app_root
 
               parent = current.dirname
@@ -1458,7 +1614,7 @@ module Shakapacker
       def detect_package_manager
         root_package_manager = package_manager_for(root_path)
 
-        package_root_paths.each do |package_root|
+        package_manager_root_paths.each do |package_root|
           next if package_root == root_path
 
           package_manager_name = package_manager_for(package_root)
@@ -1478,6 +1634,34 @@ module Shakapacker
         nil
       end
 
+      def package_manager_root_paths
+        @package_manager_root_paths ||= [javascript_package_manager_root_path, root_path].uniq
+      end
+
+      def javascript_package_manager_root_path
+        @javascript_package_manager_root_path ||= begin
+          source_path = config.source_path.expand_path
+          app_root = root_path.expand_path
+
+          if path_within?(source_path, app_root)
+            current = source_path
+            loop do
+              break current if package_root_marker?(current)
+              break root_path if current == app_root
+
+              parent = current.dirname
+              break root_path if parent == current
+
+              current = parent
+            end
+          else
+            root_path
+          end
+        rescue StandardError
+          root_path
+        end
+      end
+
       def versions_compatible?(gem_version, npm_version)
         # Handle pre-release versions and ranges properly
         npm_clean = npm_version.gsub(/[\^~]/, "")

data/lib/shakapacker/version.rb

@@ -1,4 +1,4 @@
 module Shakapacker
   # Change the version in package.json too, please!
-  VERSION = "10.2.0".freeze
+  VERSION = "10.3.1".freeze
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shakapacker",
-  "version": "10.2.0",
+  "version": "10.3.1",
   "description": "Use webpack to manage app-like JavaScript modules in Rails",
   "homepage": "https://github.com/shakacode/shakapacker",
   "bugs": {
@@ -127,7 +127,7 @@
     "webpack": "^5.101.0",
     "webpack-assets-manifest": "^5.0.6 || ^6.0.0",
     "webpack-cli": "^4.9.2 || ^5.0.0 || ^6.0.0 || ^7.0.0",
-    "webpack-dev-server": "^5.2.2",
+    "webpack-dev-server": "^5.2.2 || ^6.0.0",
     "webpack-subresource-integrity": "^5.1.0"
   },
   "peerDependenciesMeta": {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shakapacker
 version: !ruby/object:Gem::Version
-  version: 10.2.0
+  version: 10.3.1
 platform: ruby
 authors:
 - David Heinemeier Hansson
@@ -225,7 +225,7 @@ homepage: https://github.com/shakacode/shakapacker
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/shakacode/shakapacker/tree/v10.2.0
+  source_code_uri: https://github.com/shakacode/shakapacker/tree/v10.3.1
 rdoc_options: []
 require_paths:
 - lib