shakapacker 9.3.0 → 9.3.1

data/docs/configuration.md

@@ -25,7 +25,7 @@ Common configuration options with their defaults:
 | ------------------------------ | ------- | --------------------------------------- | ---------------------------------------------------------- |
 | `assets_bundler`               | string  | `"webpack"`                             | Bundler to use: `"webpack"` or `"rspack"`                  |
 | `assets_bundler_config_path`   | string  | `"config/webpack"` or `"config/rspack"` | Directory containing bundler config files                  |
-| `javascript_transpiler`        | string  | `"swc"` or `"babel"`                    | Transpiler: `"swc"`, `"babel"`, or `"esbuild"`             |
+| `javascript_transpiler`        | string  | `"swc"`\*                               | Transpiler: `"swc"`, `"babel"`, or `"esbuild"`             |
 | `source_path`                  | string  | `"app/javascript"`                      | Root directory for JavaScript source files                 |
 | `source_entry_path`            | string  | `"packs"`                               | Subdirectory within `source_path` for entry points         |
 | `nested_entries`               | boolean | `true`                                  | Discover entry points in subdirectories                    |
@@ -44,6 +44,8 @@ Common configuration options with their defaults:
 
 For detailed explanations, examples, and additional options, see the sections below.
 
+**\*Note on `javascript_transpiler` default**: The installation template sets this to `"swc"` for new projects. However, at runtime, if no explicit value is configured, webpack defaults to `"babel"` (for backward compatibility) while rspack defaults to `"swc"`.
+
 ## Basic Configuration
 
 ### `assets_bundler`
@@ -91,23 +93,27 @@ assets_bundler_config_path: "."
 ### `javascript_transpiler`
 
 **Type:** `string`
-**Default:** `"swc"` (or `"babel"` for webpack when not specified)
+**Default:** `"swc"` (new installations), `"babel"` (webpack runtime), `"swc"` (rspack runtime)
 **Options:** `"swc"`, `"babel"`, or `"esbuild"`
 
 Specifies which transpiler to use for JavaScript/TypeScript.
 
 ```yaml
-# Use SWC (recommended - 20x faster than Babel)
+# Use SWC (recommended - 20x faster than Babel, set by default in new installations)
 javascript_transpiler: "swc"
 
-# Use Babel (for maximum compatibility)
+# Use Babel (for maximum compatibility, webpack runtime default if not configured)
 javascript_transpiler: "babel"
 
 # Use esbuild (fastest, but may have compatibility issues)
 javascript_transpiler: "esbuild"
 ```
 
-**Note:** When using rspack, swc is used automatically regardless of this setting due to built-in support.
+**Important default behavior:**
+
+- **New installations**: The installation template explicitly sets `javascript_transpiler: "swc"`
+- **Webpack runtime default**: If not explicitly configured, defaults to `"babel"` for backward compatibility
+- **Rspack runtime default**: If not explicitly configured, defaults to `"swc"` as rspack is a newer bundler
 
 See [Transpiler Performance Guide](transpiler-performance.md) for benchmarks and migration guides.
 

data/docs/css-modules-export-mode.md

@@ -150,11 +150,45 @@ If you prefer to keep the v8 default export behavior during migration, you can o
 
 ## Reverting to Default Exports (v8 Behavior)
 
-To use the v8-style default exports instead of v9's named exports:
+To use the v8-style default exports instead of v9's named exports, you have several options:
 
-### Option 1: Update `config/webpack/commonWebpackConfig.js` (Recommended)
+### Option 1: Configuration File (Easiest - Recommended)
 
-This approach modifies the common webpack configuration that applies to all environments:
+The simplest way to restore v8 behavior is to set the `css_modules_export_mode` option in your `config/shakapacker.yml`:
+
+```yaml
+# config/shakapacker.yml
+default: &default
+  # ... other settings ...
+
+  # CSS Modules export mode
+  # named (default) - Use named exports with camelCase conversion (v9 default)
+  # default - Use default export with both original and camelCase names (v8 behavior)
+  css_modules_export_mode: default
+```
+
+This configuration automatically adjusts the CSS loader settings:
+
+- Sets `namedExport: false` to enable default exports
+- Sets `exportLocalsConvention: 'camelCase'` to export both original and camelCase versions
+
+**Restart your development server** after changing this setting for the changes to take effect.
+
+With this configuration, you can continue using v8-style imports:
+
+```js
+// Works with css_modules_export_mode: default
+import styles from "./Component.module.css"
+;<div className={styles.container}>
+  <button className={styles.button}>Click me</button>
+  <button className={styles["my-button"]}>Kebab-case</button>
+  <button className={styles.myButton}>Also available</button>
+</div>
+```
+
+### Option 2: Manual Webpack Configuration (Advanced)
+
+If you need more control or can't use the configuration file approach, you can manually modify the webpack configuration that applies to all environments:
 
 ```js
 // config/webpack/commonWebpackConfig.js
@@ -198,7 +232,7 @@ const commonWebpackConfig = () => {
 module.exports = commonWebpackConfig
 ```
 
-### Option 2: Create `config/webpack/environment.js` (Alternative)
+### Option 3: Create `config/webpack/environment.js` (Alternative)
 
 If you prefer using a separate environment file:
 
@@ -239,12 +273,12 @@ module.exports = environment
 
 Then reference this in your environment-specific configs (development.js, production.js, etc.).
 
-### Option 3: (Optional) Sass Modules
+### Option 4: (Optional) Sass Modules
 
 If you also use Sass modules, add similar configuration for SCSS files:
 
 ```js
-// For Option 1 approach, extend the overrideCssModulesConfig function:
+// For Option 2 approach (manual webpack config), extend the overrideCssModulesConfig function:
 const overrideCssModulesConfig = (config) => {
   // Handle both CSS and SCSS rules
   const styleRules = config.module.rules.filter(

data/docs/transpiler-migration.md

@@ -4,10 +4,13 @@
 
 ## Default Transpilers
 
-Shakapacker uses different default JavaScript transpilers based on the bundler:
+Shakapacker v9 transpiler defaults depend on the bundler and installation:
 
-- **Webpack**: `babel` (default) - Maintains backward compatibility
-- **Rspack**: `swc` (default) - Modern, faster transpiler for new bundler
+- **New installations (v9+)**: `swc` - Installation template explicitly sets SWC (20x faster than Babel)
+- **Webpack runtime default**: `babel` - Used when no explicit config is provided (maintains backward compatibility)
+- **Rspack runtime default**: `swc` - Rspack defaults to SWC as it's a newer bundler with modern defaults
+
+**Key distinction**: The installation template (`lib/install/config/shakapacker.yml`) explicitly sets `javascript_transpiler: "swc"` for new projects, but if you're upgrading or have no explicit config, webpack falls back to Babel for backward compatibility.
 
 ## Available Transpilers
 
@@ -22,15 +25,15 @@ Set the transpiler in your `config/shakapacker.yml`:
 
 ```yaml
 default: &default
-  # For webpack users (babel is default, no change needed)
-  javascript_transpiler: babel
-
-  # To opt-in to SWC for better performance
+  # SWC is the default (recommended - 20x faster than Babel)
   javascript_transpiler: swc
 
-  # For rspack users (swc is default, no change needed)
+  # To use Babel for backward compatibility
+  javascript_transpiler: babel
+
+  # For rspack users (defaults to swc if not specified)
   assets_bundler: rspack
-  javascript_transpiler: swc
+  # javascript_transpiler can be set, but rspack defaults to swc
 ```
 
 ## Migration Guide

data/docs/using_swc_loader.md

@@ -1,8 +1,6 @@
 # Using SWC Loader
 
-:warning: This feature is currently experimental. The configuration and API are subject to change during the beta release cycle.
-
-If you face any issues, please report at https://github.com/shakacode/shakapacker/issues.
+SWC is the recommended JavaScript transpiler in Shakapacker v9+, and is set as the default in new installations. If you face any issues, please report them at [Shakapacker Issues](https://github.com/shakacode/shakapacker/issues).
 
 ## About SWC
 
@@ -12,20 +10,23 @@ It supports all ECMAScript features and it's designed to be a drop-in replacemen
 
 For comparison between SWC and Babel, see the docs at https://swc.rs/docs/migrating-from-babel.
 
-> **Note:** SWC is also natively built into RSpack bundler, providing even faster compilation speeds. When using RSpack (`assets_bundler: 'rspack'`), SWC is used automatically regardless of the `javascript_transpiler` setting.
+> **Note:** SWC is also natively built into RSpack bundler, providing even faster compilation speeds. When using RSpack (`assets_bundler: 'rspack'`), SWC is the default if `javascript_transpiler` is not explicitly set.
+
+## Using SWC in your Shakapacker project
 
-## Switching your Shakapacker project to SWC
+For new installations of Shakapacker v9+, SWC is automatically configured in the installation template.
 
-In order to use SWC as your compiler today. You need to do two things:
+**Note**: While the installation template sets SWC as the default, webpack's runtime fallback (when no explicit config exists) remains Babel for backward compatibility. Rspack always defaults to SWC.
+
+If you're upgrading from v8 or earlier and want to switch from Babel to SWC:
 
 1. Make sure you've installed `@swc/core` and `swc-loader` packages.
 
-```
+```bash
 npm install @swc/core swc-loader
 ```
 
-2. Add or change `javascript_transpiler` value in your default `shakapacker.yml` config to `swc`
-   The default configuration of babel is done by using `package.json` to use the file within the `shakapacker` package.
+2. Confirm `javascript_transpiler` is set to `swc` in your `config/shakapacker.yml`:
 
 ```yml
 default: &default
@@ -43,7 +44,9 @@ default: &default
   # Reload manifest.json on all requests so we reload latest compiled packs
   cache_manifest: false
 
-  # Select JavaScript transpiler to use, available options are 'babel' (default) or 'swc'
+  # Select JavaScript transpiler to use
+  # Available options: 'swc' (default, 20x faster), 'babel', or 'esbuild'
+  # Note: When using rspack, swc is used automatically regardless of this setting
   javascript_transpiler: "swc"
 ```
 

data/docs/v9_upgrade.md

@@ -145,9 +145,18 @@ import * as styles from './Component.module.css';
    - TypeScript: Change to namespace imports (`import * as styles`)
    - Kebab-case class names are automatically converted to camelCase
 
-2. **Keep v8 behavior** temporarily:
+2. **Keep v8 behavior** temporarily using configuration file (Easiest):
+
+   ```yaml
+   # config/shakapacker.yml
+   css_modules_export_mode: default
+   ```
+
+   This allows you to keep using default imports while migrating gradually
+
+3. **Keep v8 behavior** using webpack configuration (Advanced):
    - Override the css-loader configuration as shown in [CSS Modules Export Mode documentation](./css-modules-export-mode.md)
-   - This gives you time to migrate gradually
+   - Provides more control over the configuration
 
 **Benefits of the change:**
 

data/eslint.config.fast.js

@@ -17,11 +17,12 @@ module.exports = [
   // Global ignores (replaces .eslintignore)
   {
     ignores: [
-      "lib/**",
-      "**/node_modules/**",
-      "vendor/**",
-      "spec/**",
-      "package/**" // TODO: Remove after issue #644 is resolved (lints package/ TS source files)
+      "lib/**", // Ruby files, not JavaScript
+      "**/node_modules/**", // Third-party dependencies
+      "vendor/**", // Vendored dependencies
+      "spec/**", // Ruby specs, not JavaScript
+      "package/**/*.js", // Generated/compiled JavaScript from TypeScript
+      "package/**/*.d.ts" // Generated TypeScript declaration files
     ]
   },
 
@@ -63,7 +64,11 @@ module.exports = [
       "import/no-extraneous-dependencies": "off",
       // TypeScript handles extensions, not needed for JS imports
       "import/extensions": "off",
-      indent: ["error", 2]
+      indent: ["error", 2],
+      // Allow for...of loops - modern JS syntax
+      "no-restricted-syntax": "off",
+      // Allow console statements - used for debugging/logging throughout
+      "no-console": "off"
     },
     settings: {
       react: {
@@ -130,13 +135,120 @@ module.exports = [
       "@typescript-eslint/no-use-before-define": ["error"],
       "@typescript-eslint/no-unused-vars": [
         "error",
-        { argsIgnorePattern: "^_" }
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" }
       ],
       "@typescript-eslint/no-explicit-any": "error",
-      "@typescript-eslint/explicit-module-boundary-types": "off"
+      "@typescript-eslint/explicit-module-boundary-types": "off",
+      "no-undef": "off"
     }
   },
 
+  // Global rule for all TypeScript files in package/
+  // Suppress require() imports - these are intentional for CommonJS compatibility
+  // Will be addressed in Phase 3 (breaking changes) - see #708
+  {
+    files: ["package/**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-require-imports": "off",
+      "global-require": "off",
+      "import/no-import-module-exports": "off"
+    }
+  },
+
+  // Consolidated override for package/config.ts and package/babel/preset.ts
+  {
+    files: ["package/babel/preset.ts", "package/config.ts"],
+    rules: {
+      "@typescript-eslint/no-unused-vars": "off",
+      "import/order": "off",
+      "import/newline-after-import": "off",
+      "import/first": "off",
+      "@typescript-eslint/no-explicit-any": "off",
+      "no-useless-escape": "off"
+    }
+  },
+
+  // configExporter module overrides
+  {
+    files: ["package/configExporter/**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-use-before-define": "off",
+      "import/no-dynamic-require": "off",
+      "class-methods-use-this": "off",
+      "import/prefer-default-export": "off",
+      "no-underscore-dangle": "off",
+      "no-restricted-globals": "off",
+      "@typescript-eslint/no-unused-vars": "off",
+      "@typescript-eslint/no-explicit-any": "off"
+    }
+  },
+
+  // Utils module overrides
+  {
+    files: [
+      "package/utils/inliningCss.ts",
+      "package/utils/errorCodes.ts",
+      "package/utils/errorHelpers.ts",
+      "package/utils/pathValidation.ts",
+      "package/utils/getStyleRule.ts",
+      "package/utils/helpers.ts",
+      "package/utils/validateDependencies.ts",
+      "package/webpackDevServerConfig.ts"
+    ],
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off",
+      "no-useless-escape": "off"
+    }
+  },
+
+  // Plugins and optimization overrides
+  {
+    files: ["package/plugins/**/*.ts", "package/optimization/**/*.ts"],
+    rules: {
+      "import/prefer-default-export": "off"
+    }
+  },
+
+  // Rules, rspack, swc, esbuild, and other modules
+  {
+    files: [
+      "package/index.ts",
+      "package/rspack/index.ts",
+      "package/rules/**/*.ts",
+      "package/swc/index.ts",
+      "package/esbuild/index.ts",
+      "package/dev_server.ts",
+      "package/env.ts"
+    ],
+    rules: {
+      "@typescript-eslint/no-unused-vars": "off",
+      "import/prefer-default-export": "off",
+      "no-underscore-dangle": "off"
+    }
+  },
+
+  // Environments module overrides
+  {
+    files: ["package/environments/**/*.ts"],
+    rules: {
+      "import/prefer-default-export": "off",
+      "no-underscore-dangle": "off"
+    }
+  },
+
+  // Type tests are intentionally unused - they test type compatibility
+  {
+    files: ["package/**/__type-tests__/**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-unused-vars": "off"
+    }
+  },
+
+  // Note: Type-aware rule overrides from main config (e.g., @typescript-eslint/no-unsafe-*,
+  // @typescript-eslint/restrict-template-expressions) are intentionally omitted here since
+  // fast mode doesn't enable type-aware linting (no parserOptions.project specified).
+  // This keeps fast mode performant while maintaining consistency for non-type-aware rules.
+
   // Prettier config must be last to override other configs
   prettierConfig
 ]

data/eslint.config.js

@@ -19,13 +19,7 @@ module.exports = [
       "vendor/**", // Vendored dependencies
       "spec/**", // Ruby specs, not JavaScript
       "package/**/*.js", // Generated/compiled JavaScript from TypeScript
-      "package/**/*.d.ts", // Generated TypeScript declaration files
-      // Temporarily ignore TypeScript files until technical debt is resolved
-      // See ESLINT_TECHNICAL_DEBT.md for tracking
-      // TODO: Remove this once ESLint issues are fixed (tracked in #723)
-      // Exception: configExporter is being fixed in #707
-      "package/**/*.ts",
-      "!package/configExporter/**/*.ts" // Enable linting for configExporter (issue #707)
+      "package/**/*.d.ts" // Generated TypeScript declaration files
     ]
   },
 
@@ -142,10 +136,10 @@ module.exports = [
       // Disable base rule in favor of TypeScript version
       "no-use-before-define": "off",
       "@typescript-eslint/no-use-before-define": ["error"],
-      // Allow unused vars if they start with underscore (convention for ignored params)
+      // Allow unused vars if they start with underscore (convention for ignored params and type tests)
       "@typescript-eslint/no-unused-vars": [
         "error",
-        { argsIgnorePattern: "^_" }
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" }
       ],
       // Strict: no 'any' types allowed - use 'unknown' or specific types instead
       "@typescript-eslint/no-explicit-any": "error",
@@ -157,37 +151,42 @@ module.exports = [
     }
   },
 
+  // Global rule for all TypeScript files in package/
+  // Suppress require() imports - these are intentional for CommonJS compatibility
+  // Will be addressed in Phase 3 (breaking changes) - see #708
+  {
+    files: ["package/**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-require-imports": "off",
+      "global-require": "off",
+      "import/no-import-module-exports": "off"
+    }
+  },
+
   // Temporary overrides for files with remaining errors
   // See ESLINT_TECHNICAL_DEBT.md for detailed documentation
   //
-  // These overrides suppress ~172 errors that require either:
+  // These overrides suppress ~94 type safety errors that require:
   // 1. Major type refactoring (any/unsafe-* rules)
-  // 2. Potential breaking changes (module system)
-  // 3. Significant code restructuring
+  // 2. Proper type definitions for config objects
   //
-  // GitHub Issues tracking this technical debt:
-  // - #707: TypeScript: Refactor configExporter module for type safety
-  // - #708: Module System: Modernize to ES6 modules with codemod
-  // - #709: Code Style: Fix remaining ESLint style issues
+  // GitHub Issue tracking this technical debt:
+  // - #790: TypeScript ESLint Phase 2b: Type Safety Improvements (~94 errors)
   {
     // Consolidated override for package/config.ts and package/babel/preset.ts
     // Combines rules from both previous override blocks to avoid duplication
     files: ["package/babel/preset.ts", "package/config.ts"],
     rules: {
-      // From first override block
-      "@typescript-eslint/no-require-imports": "off",
       "@typescript-eslint/no-unused-vars": "off",
       "@typescript-eslint/no-unsafe-call": "off",
       "import/order": "off",
       "import/newline-after-import": "off",
       "import/first": "off",
-      // Additional rules that were in the second override for config.ts
       "@typescript-eslint/no-unsafe-assignment": "off",
       "@typescript-eslint/no-unsafe-member-access": "off",
       "@typescript-eslint/no-unsafe-argument": "off",
       "@typescript-eslint/no-explicit-any": "off",
-      "no-useless-escape": "off",
-      "no-continue": "off"
+      "no-useless-escape": "off"
     }
   },
   {
@@ -205,19 +204,14 @@ module.exports = [
       // Code organization (functions before use due to large file)
       "@typescript-eslint/no-use-before-define": "off",
       // Import style (CommonJS require for dynamic imports)
-      "@typescript-eslint/no-require-imports": "off",
       "import/no-dynamic-require": "off",
-      "global-require": "off",
       // Class methods that are part of public API
       "class-methods-use-this": "off",
       // Template expressions (valid use cases with union types)
       "@typescript-eslint/restrict-template-expressions": "off",
       // Style preferences
-      "no-continue": "off",
       "import/prefer-default-export": "off",
-      "no-await-in-loop": "off",
       "no-underscore-dangle": "off",
-      "no-shadow": "off",
       "no-restricted-globals": "off",
       "@typescript-eslint/no-unused-vars": "off",
       "@typescript-eslint/require-await": "off"
@@ -236,20 +230,26 @@ module.exports = [
     }
   },
   {
-    // Remaining utils files (removed package/config.ts from this block)
+    // Remaining utils files that need type safety improvements
+    // These use dynamic requires and helper functions that return `any`
     files: [
       "package/utils/inliningCss.ts",
       "package/utils/errorCodes.ts",
       "package/utils/errorHelpers.ts",
-      "package/utils/pathValidation.ts"
+      "package/utils/pathValidation.ts",
+      "package/utils/getStyleRule.ts",
+      "package/utils/helpers.ts",
+      "package/utils/validateDependencies.ts",
+      "package/webpackDevServerConfig.ts"
     ],
     rules: {
       "@typescript-eslint/no-unsafe-assignment": "off",
       "@typescript-eslint/no-unsafe-member-access": "off",
       "@typescript-eslint/no-unsafe-argument": "off",
+      "@typescript-eslint/no-unsafe-call": "off",
+      "@typescript-eslint/no-unsafe-return": "off",
       "@typescript-eslint/no-explicit-any": "off",
-      "no-useless-escape": "off",
-      "no-continue": "off"
+      "no-useless-escape": "off"
     }
   },
   {
@@ -257,13 +257,13 @@ module.exports = [
     rules: {
       "@typescript-eslint/no-unsafe-assignment": "off",
       "@typescript-eslint/no-unsafe-call": "off",
+      "@typescript-eslint/no-unsafe-member-access": "off",
       "@typescript-eslint/no-redundant-type-constituents": "off",
       "import/prefer-default-export": "off"
     }
   },
   {
     files: [
-      "package/environments/**/*.ts",
       "package/index.ts",
       "package/rspack/index.ts",
       "package/rules/**/*.ts",
@@ -276,6 +276,8 @@ module.exports = [
       "@typescript-eslint/no-unsafe-assignment": "off",
       "@typescript-eslint/no-unsafe-call": "off",
       "@typescript-eslint/no-unsafe-return": "off",
+      "@typescript-eslint/no-unsafe-member-access": "off",
+      "@typescript-eslint/no-unsafe-argument": "off",
       "@typescript-eslint/no-redundant-type-constituents": "off",
       "@typescript-eslint/no-unused-vars": "off",
       "@typescript-eslint/no-unsafe-function-type": "off",
@@ -283,6 +285,23 @@ module.exports = [
       "no-underscore-dangle": "off"
     }
   },
+  {
+    // package/environments/**/*.ts now passes no-unused-vars rule
+    // Type test functions use underscore prefix (argsIgnorePattern: "^_")
+    // All other variables are used in the code
+    files: ["package/environments/**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-unsafe-assignment": "off",
+      "@typescript-eslint/no-unsafe-call": "off",
+      "@typescript-eslint/no-unsafe-return": "off",
+      "@typescript-eslint/no-unsafe-member-access": "off",
+      "@typescript-eslint/no-unsafe-argument": "off",
+      "@typescript-eslint/no-redundant-type-constituents": "off",
+      "@typescript-eslint/no-unsafe-function-type": "off",
+      "import/prefer-default-export": "off",
+      "no-underscore-dangle": "off"
+    }
+  },
 
   // Prettier config must be last to override other configs
   prettierConfig

data/lib/install/config/shakapacker.yml

@@ -19,6 +19,18 @@ default: &default
   #  css_extract_ignore_order_warnings to true
   css_extract_ignore_order_warnings: false
 
+  # CSS Modules export mode
+  # Controls how CSS Module class names are exported in JavaScript
+  # Defaults to 'named' if not specified. Uncomment and change to 'default' for v8 behavior.
+  # Options:
+  #   - named (default): Use named exports with camelCase conversion (v9 default)
+  #     Example: import { button } from './styles.module.css'
+  #   - default: Use default export with both original and camelCase names (v8 behavior)
+  #     Example: import styles from './styles.module.css'
+  # For gradual migration, you can set this to default to maintain v8 behavior
+  # See https://github.com/shakacode/shakapacker/blob/main/docs/css-modules-export-mode.md
+  # css_modules_export_mode: named
+
   public_root_path: public
   public_output_path: packs
   cache_path: tmp/shakapacker
@@ -41,7 +53,8 @@ default: &default
   cache_manifest: false
 
   # Select JavaScript transpiler to use
-  # Available options: 'swc' (default, 20x faster), 'babel', or 'esbuild'
+  # Available options: 'swc' (default, 20x faster), 'babel', 'esbuild', or 'none'
+  # Use 'none' when providing a completely custom webpack configuration
   # Note: When using rspack, swc is used automatically regardless of this setting
   javascript_transpiler: "swc"