shakapacker 9.0.0 → 9.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4cfe1097512ba4c08cc57b061192f0bb0ad8d5d41a508a5f978068d447eae8c
-  data.tar.gz: 9dfe66dc0d435f1b045bb51455869fb7da0008055e9d062673b666722a360221
+  metadata.gz: 5ac40ff5ddf8db373b1de0efaf805a033d7ba87641d84bde529669761b8e64d2
+  data.tar.gz: 5d0abb49ede8ad2aa37c94e9148e4def579c3eabb8c6e8d94a127796941ed559
 SHA512:
-  metadata.gz: f09b82882e96e0867be91135dda3eff2d77b629571d4ff7fde8b2a6c4748cb9749ce9e6a80c47ec117b083ef79734d23b99ddb971950f941c328b52877277ccb
-  data.tar.gz: c19b394a110cd6beebe23715af218fbc932d5052498911ea51824a790c917a4d7fbd76ed92b3144d5d605e886a648b6d05c27b179dacc097fee5936446a1ce65
+  metadata.gz: 5309f5d9beef93aaa0434e0e8ab93118545ecad507ade518ab56a332980d804536e36762670d21245d67d6c60e126367b1ea4edd8e4766daf20c294871ea1263
+  data.tar.gz: 4fb22afab6e203194018a1be9096aac472bffdbc08d58fc7a5b04a23c5e5d8c52084a17830d8ffb5156a6e4798de061f6f671474638616b7ffecd6c6348916f5

data/.gitignore

@@ -16,6 +16,9 @@ gemfiles/*.lock
 .yalc
 yalc.lock
 
+# Config exporter output directory
+shakapacker-config-exports/
+
 # TypeScript generated files
 package/**/*.d.ts
 package/**/*.d.ts.map

data/CHANGELOG.md

@@ -11,11 +11,105 @@
 
 Changes since the last non-beta release.
 
+## [v9.1.1] - October 9, 2025
+
+### Added
+
+- **New config export utility for debugging webpack/rspack configurations** [PR #647](https://github.com/shakacode/shakapacker/pull/647) by [justin808](https://github.com/justin808).
+  - Adds `bin/export-bundler-config` utility with three modes:
+    - **Doctor mode** (`--doctor`): Exports all configs (dev + prod, client + server) to `shakapacker-config-exports/` directory - best for troubleshooting
+    - **Save mode** (`--save`): Export current environment configs to files
+    - **Stdout mode** (default): View configs in terminal
+  - **Output formats:** YAML (with optional inline documentation), JSON, or Node.js inspect
+  - **Smart features:**
+    - Environment isolation ensures dev/prod configs are truly different
+    - Auto-detects bundler from `shakapacker.yml`
+    - Pretty-prints functions (up to 50 lines)
+    - Validates bundler value and output paths
+    - Sanitizes filenames to prevent path traversal
+    - Helpful `.gitignore` suggestions
+  - **Usage:** `bin/export-bundler-config --doctor` or `bundle exec rake shakapacker:export_bundler_config`
+  - Works seamlessly with `rake shakapacker:switch_bundler` for comparing webpack vs rspack configs
+  - Lays groundwork for future config diff feature (tracked in [#667](https://github.com/shakacode/shakapacker/issues/667))
+
+### Fixed
+
+- Fixed NoMethodError when custom environment (e.g., staging) is not defined in shakapacker.yml. [PR #669](https://github.com/shakacode/shakapacker/pull/669) by [justin808](https://github.com/justin808).
+  - When deploying to environments like Heroku staging with `RAILS_ENV=staging`, shakapacker would crash with `undefined method 'deep_symbolize_keys' for nil:NilClass`
+  - **Configuration fallback:** Now properly falls back to production environment configuration (appropriate for staging)
+  - **NODE_ENV handling:** `bin/shakapacker` now automatically sets `NODE_ENV=production` for custom environments (staging, etc.)
+    - Previously: `RAILS_ENV=staging` would set `NODE_ENV=development`, breaking webpack optimizations
+    - Now: `RAILS_ENV` in `[development, test]` uses that value for `NODE_ENV`, everything else uses `production`
+  - Logs informational message when falling back to help with debugging
+  - This ensures shakapacker works with any Rails environment even if not explicitly defined in shakapacker.yml
+  - Fixes [#663](https://github.com/shakacode/shakapacker/issues/663)
+
+## [v9.1.0] - October 8, 2025
+
+**⚠️ IMPORTANT:** This release includes a breaking change for SWC users. Please see the [v9 Upgrade Guide - SWC Loose Mode Breaking Change](./docs/v9_upgrade.md#swc-loose-mode-breaking-change-v910) for migration details.
+
+### ⚠️ Breaking Changes
+
+- **SWC default configuration now uses `loose: false` for spec-compliant transforms** ([#658](https://github.com/shakacode/shakapacker/pull/658))
+  - Previously, Shakapacker set `loose: true` by default in SWC configuration, which caused:
+    - Silent failures with Stimulus controllers
+    - Incorrect behavior with spread operators on iterables (e.g., `[...new Set()]`)
+    - Deviation from both SWC and Babel upstream defaults
+  - Now defaults to `loose: false`, matching SWC's default and fixing compatibility with Stimulus
+  - This aligns with the previous fix to Babel configuration in [PR #107](https://github.com/shakacode/shakapacker/pull/107)
+  - **Migration:** Most projects need no changes as the new default provides spec-compliant behavior. Projects with Stimulus will benefit from this fix. See [v9 Upgrade Guide - SWC Loose Mode](./docs/v9_upgrade.md#swc-loose-mode-breaking-change-v910) for details
+  - If you must restore the old behavior (not recommended), add to `config/swc.config.js`:
+    ```javascript
+    module.exports = {
+      options: {
+        jsc: {
+          // Only use this if you have code that requires loose transforms.
+          // This provides slightly faster build performance but may cause runtime bugs.
+          loose: true // Restore v9.0.0 behavior
+        }
+      }
+    }
+    ```
+
+### Added
+
+- **New `shakapacker:switch_bundler` rake task** for easy switching between webpack and rspack
+  - Automatically updates `config/shakapacker.yml` to switch bundler configuration
+  - Optional `--install-deps` flag to automatically manage dependencies
+  - `--no-uninstall` flag for faster switching by keeping both bundlers installed
+  - **Supports all package managers**: Auto-detects and uses npm, yarn, pnpm, or bun
+  - Shows clear list of packages being added/removed during dependency management
+  - Support for custom dependency configuration via `.shakapacker-switch-bundler-dependencies.yml`
+  - Includes SWC dependencies (`@swc/core`, `swc-loader`) in default webpack setup
+  - Preserves config file structure and comments during updates
+  - Updates `javascript_transpiler` to `swc` when switching to rspack (recommended)
+  - Ruby 2.7+ compatible YAML loading with proper alias/anchor support
+  - Secure command execution (prevents shell injection)
+  - Usage: `rails shakapacker:switch_bundler [webpack|rspack] [--install-deps] [--no-uninstall]`
+  - See rake task help: `rails shakapacker:switch_bundler --help`
+- **Stimulus compatibility built into SWC migration** ([#658](https://github.com/shakacode/shakapacker/pull/658))
+  - `rake shakapacker:migrate_to_swc` now creates `config/swc.config.js` with `keepClassNames: true`
+  - Prevents SWC from mangling class names, which breaks Stimulus controller discovery
+  - Includes React Fast Refresh configuration by default
+- **Comprehensive Stimulus documentation** for SWC users ([#658](https://github.com/shakacode/shakapacker/pull/658))
+  - Added "Using SWC with Stimulus" section to [docs/using_swc_loader.md](./docs/using_swc_loader.md#using-swc-with-stimulus)
+  - Documents symptoms of missing configuration (silent failures)
+  - Explains common errors like `env` and `jsc.target` conflicts
+  - Added Stimulus compatibility checklist to migration guide
+- **Enhanced `rake shakapacker:doctor` for SWC configuration validation** ([#658](https://github.com/shakacode/shakapacker/pull/658))
+  - Detects `loose: true` in config and warns about potential issues
+  - Detects missing `keepClassNames: true` when Stimulus is installed
+  - Detects conflicting `jsc.target` and `env` configuration
+  - Provides actionable warnings with links to documentation
+
 ### Fixed
 
-- Fixed NODE_ENV defaulting to production breaking dev server ([Issue 631](https://github.com/shakacode/shakapacker/issues/631)). NODE_ENV now defaults to development unless RAILS_ENV is explicitly set to production. This ensures the dev server works out of the box without requiring NODE_ENV to be set, and fixes incorrect port and 404 asset errors.
+- Fixed `rake shakapacker:migrate_to_swc` to correctly set `javascript_transpiler: "swc"` instead of unused `swc: true` flag ([#659](https://github.com/shakacode/shakapacker/pull/659))
+  - The migration now properly configures SWC as the transpiler
+  - Users who previously ran the migration should update their `config/shakapacker.yml` to use `javascript_transpiler: "swc"` instead of `swc: true`
+- Restore `RspackPlugin` type as an alias to `RspackPluginInstance` for backward compatibility. The type is now deprecated in favor of `RspackPluginInstance`. [#650](https://github.com/shakacode/shakapacker/issues/650)
 
-## [v9.0.0-beta.8] - October 3, 2025
+## [v9.0.0] - October 5, 2025
 
 See the [v9 Upgrade Guide](https://github.com/shakacode/shakapacker/blob/main/docs/v9_upgrade.md) for detailed migration instructions.
 
@@ -26,7 +120,7 @@ See the [v9 Upgrade Guide](https://github.com/shakacode/shakapacker/blob/main/do
    - Babel dependencies are no longer included as peer dependencies
    - Improves compilation speed by 20x
    - **Migration for existing projects:**
-     - **Option 1 (Recommended):** Switch to SWC - Run `rake shakapacker:migrate:to_swc` or manually:
+     - **Option 1 (Recommended):** Switch to SWC - Run `rake shakapacker:migrate_to_swc` or manually:
        ```yaml
        # config/shakapacker.yml
        javascript_transpiler: "swc"
@@ -38,7 +132,7 @@ See the [v9 Upgrade Guide](https://github.com/shakacode/shakapacker/blob/main/do
        javascript_transpiler: "babel"
        ```
 
-2. **CSS Modules now use named exports by default**
+2. **CSS Modules now use named exports by default** ([PR 599](https://github.com/shakacode/shakapacker/pull/599))
 
    - **JavaScript:** Use named imports: `import { className } from './styles.module.css'`
    - **TypeScript:** Use namespace imports: `import * as styles from './styles.module.css'`
@@ -50,19 +144,20 @@ See the [v9 Upgrade Guide](https://github.com/shakacode/shakapacker/blob/main/do
 
 ### Added
 
-- **Rspack support** as an alternative assets bundler to webpack
+- **Rspack support** as an alternative assets bundler to webpack ([PR 589](https://github.com/shakacode/shakapacker/pull/589), [PR 590](https://github.com/shakacode/shakapacker/pull/590))
   - Configure `assets_bundler: 'rspack'` in `shakapacker.yml`
   - Faster Rust-based bundling with webpack-compatible APIs
   - Built-in SWC loader and CSS extraction
   - Automatic bundler detection in `bin/shakapacker`
-- **TypeScript type definitions** for improved IDE support and autocomplete
+- **TypeScript type definitions** for improved IDE support and autocomplete ([PR 602](https://github.com/shakacode/shakapacker/pull/602))
   - Types available via `import type { WebpackConfig, RspackConfig, EnvironmentConfig } from "shakapacker/types"`
+  - Installer automatically creates TypeScript config files when `tsconfig.json` is detected ([PR 633](https://github.com/shakacode/shakapacker/pull/633))
   - See [TypeScript Documentation](./docs/typescript.md) for migration and usage instructions
-- **Optional peer dependencies** - All peer dependencies now marked as optional, preventing installation warnings while maintaining version compatibility tracking
+- **Optional peer dependencies** - All peer dependencies now marked as optional, preventing installation warnings while maintaining version compatibility tracking ([PR 603](https://github.com/shakacode/shakapacker/pull/603))
 - **Private output path** for server-side rendering bundles ([PR 592](https://github.com/shakacode/shakapacker/pull/592))
   - Configure `private_output_path` for private server bundles separate from public assets
-- **`rake shakapacker:doctor` diagnostic command** to check for configuration issues and missing dependencies
-- **`rake shakapacker:migrate:to_swc`** migration helper to assist with switching from Babel to SWC
+- **`rake shakapacker:doctor` diagnostic command** to check for configuration issues and missing dependencies ([PR 609](https://github.com/shakacode/shakapacker/pull/609))
+- **`rake shakapacker:migrate_to_swc`** migration helper to assist with switching from Babel to SWC ([PR 613](https://github.com/shakacode/shakapacker/pull/613), [PR 635](https://github.com/shakacode/shakapacker/pull/635))
 
 ### Security
 
@@ -75,6 +170,8 @@ See the [v9 Upgrade Guide](https://github.com/shakacode/shakapacker/blob/main/do
 
 ### Fixed
 
+- Fixed NODE_ENV defaulting to production breaking dev server ([PR 632](https://github.com/shakacode/shakapacker/pull/632)). NODE_ENV now defaults to development unless RAILS_ENV is explicitly set to production. This ensures the dev server works out of the box without requiring NODE_ENV to be set.
+- Fixed SWC migration to use `config/swc.config.js` instead of `.swcrc` ([PR 635](https://github.com/shakacode/shakapacker/pull/635)). The `.swcrc` file bypasses webpack-merge and overrides Shakapacker's defaults, while `config/swc.config.js` properly merges with defaults.
 - Fixed private_output_path configuration edge cases ([PR 604](https://github.com/shakacode/shakapacker/pull/604))
 - Updated webpack-dev-server to secure versions (^4.15.2 || ^5.2.2) ([PR 585](https://github.com/shakacode/shakapacker/pull/585))
 
@@ -569,8 +666,8 @@ 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/v9.0.0-beta.8...main
-[v9.0.0-beta.8]: https://github.com/shakacode/shakapacker/compare/v8.4.0...v9.0.0-beta.8
+[Unreleased]: https://github.com/shakacode/shakapacker/compare/v9.0.0...main
+[v9.0.0]: https://github.com/shakacode/shakapacker/compare/v8.4.0...v9.0.0
 [v8.4.0]: https://github.com/shakacode/shakapacker/compare/v8.3.0...v8.4.0
 [v8.3.0]: https://github.com/shakacode/shakapacker/compare/v8.2.0...v8.3.0
 [v8.2.0]: https://github.com/shakacode/shakapacker/compare/v8.1.0...v8.2.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    shakapacker (9.0.0)
+    shakapacker (9.2.0)
       activesupport (>= 5.2)
       package_json
       rack-proxy (>= 0.6.1)