shakapacker 9.0.0.beta.3 → 9.0.0.beta.4

data/package/utils/helpers.js

@@ -25,6 +25,46 @@ const canProcess = (rule, fn) => {
   return null
 }
 
+const validateBabelDependencies = () => {
+  // Only validate core dependencies that are absolutely required
+  // Additional packages like presets are optional and project-specific
+  const coreRequiredPackages = ["@babel/core", "babel-loader"]
+
+  const missingCorePackages = coreRequiredPackages.filter(
+    (pkg) => !moduleExists(pkg)
+  )
+
+  if (missingCorePackages.length > 0) {
+    const installCommand = `npm install --save-dev ${missingCorePackages.join(" ")}`
+
+    // Check for commonly needed packages and suggest them
+    const suggestedPackages = [
+      "@babel/preset-env",
+      "@babel/plugin-transform-runtime",
+      "@babel/runtime"
+    ]
+
+    const missingSuggested = suggestedPackages.filter(
+      (pkg) => !moduleExists(pkg)
+    )
+    let additionalHelp = ""
+
+    if (missingSuggested.length > 0) {
+      additionalHelp =
+        `\n\nYou may also need: ${missingSuggested.join(", ")}\n` +
+        `Install with: npm install --save-dev ${missingSuggested.join(" ")}`
+    }
+
+    throw new Error(
+      `Babel is configured but core packages are missing: ${missingCorePackages.join(", ")}\n\n` +
+        `To fix this, run:\n  ${installCommand}${additionalHelp}\n\n` +
+        `💡 Tip: Consider migrating to SWC for 20x faster compilation:\n` +
+        `   1. Set javascript_transpiler: 'swc' in config/shakapacker.yml\n` +
+        `   2. Run: npm install @swc/core swc-loader`
+    )
+  }
+}
+
 const loaderMatches = (configLoader, loaderToCheck, fn) => {
   if (configLoader !== loaderToCheck) {
     return null
@@ -32,9 +72,33 @@ const loaderMatches = (configLoader, loaderToCheck, fn) => {
 
   const loaderName = `${configLoader}-loader`
 
+  // Special validation for babel to check all dependencies
+  if (configLoader === "babel") {
+    validateBabelDependencies()
+  }
+
   if (!moduleExists(loaderName)) {
+    let installCommand = ""
+    let migrationHelp = ""
+
+    if (configLoader === "babel") {
+      installCommand =
+        "npm install --save-dev babel-loader @babel/core @babel/preset-env @babel/plugin-transform-runtime @babel/runtime"
+      migrationHelp =
+        "\n\n💡 Tip: Consider migrating to SWC for 20x faster compilation:\n" +
+        "   1. Set javascript_transpiler: 'swc' in config/shakapacker.yml\n" +
+        "   2. Run: npm install @swc/core swc-loader"
+    } else if (configLoader === "swc") {
+      installCommand = "npm install --save-dev @swc/core swc-loader"
+      migrationHelp =
+        "\n\n✨ SWC is 20x faster than Babel with zero configuration!"
+    } else if (configLoader === "esbuild") {
+      installCommand = "npm install --save-dev esbuild esbuild-loader"
+    }
+
     throw new Error(
-      `Your Shakapacker config specified using ${configLoader}, but ${loaderName} package is not installed. Please install ${loaderName} first.`
+      `Your Shakapacker config specified using ${configLoader}, but ${loaderName} package is not installed.\n\n` +
+        `To fix this, run:\n  ${installCommand}${migrationHelp}`
     )
   }
 
@@ -56,6 +120,7 @@ module.exports = {
   ensureTrailingSlash,
   canProcess,
   moduleExists,
+  validateBabelDependencies,
   loaderMatches,
   packageFullVersion,
   packageMajorVersion

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shakapacker",
-  "version": "9.0.0-beta.3",
+  "version": "9.0.0-beta.4",
   "description": "Use webpack to manage app-like JavaScript modules in Rails",
   "homepage": "https://github.com/shakacode/shakapacker",
   "bugs": {

data/test/package/rules/babel.test.js

@@ -11,6 +11,7 @@ jest.mock("../../../package/config", () => {
   const original = jest.requireActual("../../../package/config")
   return {
     ...original,
+    javascript_transpiler: "babel", // Force babel for this test
     additional_paths: [...original.additional_paths, "node_modules/included"]
   }
 })
@@ -32,6 +33,21 @@ const createWebpackConfig = (file, use) => ({
 })
 
 describe("babel", () => {
+  // Mock validateBabelDependencies to avoid actual dependency checking in tests
+  beforeAll(() => {
+    jest.mock("../../../package/utils/helpers", () => {
+      const original = jest.requireActual("../../../package/utils/helpers")
+      return {
+        ...original,
+        validateBabelDependencies: jest.fn() // Mock to do nothing
+      }
+    })
+  })
+
+  afterAll(() => {
+    jest.unmock("../../../package/utils/helpers")
+  })
+
   test("process source path", async () => {
     const normalPath = `${pathToAppJavascript}/a.js`
     const [tracked, loader] = createTrackLoader()

data/yarn.lock

@@ -1042,7 +1042,7 @@
 
 "@types/eslint-scope@^3.7.3", "@types/eslint-scope@^3.7.7":
   version "3.7.7"
-  resolved "https://registry.npmjs.org/@types/eslint-scope/-/eslint-scope-3.7.7.tgz"
+  resolved "https://registry.npmjs.org/@types/eslint-scope/-/eslint-scope-3.7.7.tgz#3108bd5f18b0cdb277c867b3dd449c9ed7079ac5"
   integrity sha512-MzMFlSLBqNF2gcHWO0G1vP/YQyfvrxZ0bF+u7mzUdZ1/xK4A4sru+nraZz5i3iEIk1l1uyicaDVTB4QbbEkAYg==
   dependencies:
     "@types/eslint" "*"
@@ -1389,7 +1389,7 @@
 
 "@webassemblyjs/wasm-edit@^1.12.1", "@webassemblyjs/wasm-edit@^1.14.1":
   version "1.14.1"
-  resolved "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.14.1.tgz"
+  resolved "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.14.1.tgz#ac6689f502219b59198ddec42dcd496b1004d597"
   integrity sha512-RNJUIQH/J8iA/1NzlE4N7KtyZNHi3w7at7hDjvRNm5rcUXa00z1vRz3glZoULfJ5mpvYhLybmVcwcjGrC1pRrQ==
   dependencies:
     "@webassemblyjs/ast" "1.14.1"
@@ -5629,7 +5629,7 @@ tapable@^2.1.1, tapable@^2.2.0, tapable@^2.2.1:
 
 terser-webpack-plugin@^5.3.10, terser-webpack-plugin@^5.3.11:
   version "5.3.14"
-  resolved "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.14.tgz"
+  resolved "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.14.tgz#9031d48e57ab27567f02ace85c7d690db66c3e06"
   integrity sha512-vkZjpUjb6OMS7dhV+tILUW6BhpDR7P2L/aQSAv+Uwk+m8KATX9EccViHTJR2qDtACKPIYndLGCyl3FMo+r2LMw==
   dependencies:
     "@jridgewell/trace-mapping" "^0.3.25"
@@ -6166,7 +6166,7 @@ which@^2.0.1:
 
 wildcard@^2.0.0, wildcard@^2.0.1:
   version "2.0.1"
-  resolved "https://registry.npmjs.org/wildcard/-/wildcard-2.0.1.tgz"
+  resolved "https://registry.npmjs.org/wildcard/-/wildcard-2.0.1.tgz#5ab10d02487198954836b6349f74fff961e10f67"
   integrity sha512-CC1bOL87PIWSBhDcTrdeLo6eGT7mCFtrg0uIJtqJUFyK+eJnzl8A1niH56uu7KMa5XFrtiV+AQuHO3n7DsHnLQ==
 
 word-wrap@^1.2.5:

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shakapacker
 version: !ruby/object:Gem::Version
-  version: 9.0.0.beta.3
+  version: 9.0.0.beta.4
 platform: ruby
 authors:
 - David Heinemeier Hansson
@@ -178,6 +178,7 @@ files:
 - docs/sprockets.md
 - docs/style_loader_vs_mini_css.md
 - docs/subresource_integrity.md
+- docs/transpiler-performance.md
 - docs/troubleshooting.md
 - docs/using_esbuild_loader.md
 - docs/using_swc_loader.md
@@ -239,7 +240,6 @@ files:
 - lib/tasks/shakapacker/install.rake
 - lib/tasks/shakapacker/verify_config.rake
 - lib/tasks/shakapacker/verify_install.rake
-- package-lock.json
 - package.json
 - package/babel/preset.js
 - package/config.js
@@ -314,7 +314,7 @@ homepage: https://github.com/shakacode/shakapacker
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/shakacode/shakapacker/tree/v9.0.0.beta.3
+  source_code_uri: https://github.com/shakacode/shakapacker/tree/v9.0.0.beta.4
 rdoc_options: []
 require_paths:
 - lib