shakapacker 9.3.0 → 9.3.1

data/lib/shakapacker/configuration.rb

@@ -339,6 +339,31 @@ class Shakapacker::Configuration
     javascript_transpiler
   end
 
+  # Returns the CSS Modules export mode configuration
+  #
+  # Controls how CSS Module class names are exported in JavaScript:
+  # - "named" (default): Use named exports with camelCase conversion (v9 behavior)
+  # - "default": Use default export with both original and camelCase names (v8 behavior)
+  #
+  # @return [String] "named" or "default"
+  # @raise [ArgumentError] if an invalid value is configured
+  def css_modules_export_mode
+    @css_modules_export_mode ||= begin
+      mode = fetch(:css_modules_export_mode) || "named"
+
+      # Validate the configuration value
+      valid_modes = ["named", "default"]
+      unless valid_modes.include?(mode)
+        raise ArgumentError,
+          "Invalid css_modules_export_mode: '#{mode}'. " \
+          "Valid values are: #{valid_modes.map { |m| "'#{m}'" }.join(', ')}. " \
+          "See https://github.com/shakacode/shakapacker/blob/main/docs/css-modules-export-mode.md"
+      end
+
+      mode
+    end
+  end
+
   # Returns the path to the bundler configuration directory
   #
   # This is where webpack.config.js or rspack.config.js should be located.
@@ -353,6 +378,25 @@ class Shakapacker::Configuration
     rspack? ? "config/rspack" : "config/webpack"
   end
 
+  # Returns the raw configuration data hash
+  #
+  # Returns the merged configuration from the shakapacker.yml file for the current environment.
+  # The hash has symbolized keys loaded from the config file. Individual config values can be
+  # accessed through specific accessor methods like {#source_path}, which apply defaults via {#fetch}.
+  #
+  # The returned hash is frozen to prevent accidental mutations. To access config values,
+  # use the provided accessor methods instead of modifying this hash directly.
+  #
+  # @return [Hash<Symbol, Object>] the raw configuration data with symbolized keys (frozen)
+  # @example
+  #   config.data[:source_path]  #=> "app/javascript"
+  #   config.data[:compile]      #=> true
+  # @note The hash is frozen to prevent mutations. Use accessor methods for safe config access.
+  # @api public
+  def data
+    @data ||= load.freeze
+  end
+
   private
 
     def default_javascript_transpiler
@@ -363,6 +407,9 @@ class Shakapacker::Configuration
     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?
@@ -495,10 +542,6 @@ class Shakapacker::Configuration
       [private_full_path.cleanpath.to_s, public_full_path.cleanpath.to_s]
     end
 
-    def data
-      @data ||= load
-    end
-
     def load
       config = begin
         YAML.load_file(config_path.to_s, aliases: true)

data/lib/shakapacker/dev_server_runner.rb

@@ -18,6 +18,8 @@ module Shakapacker
         exit(0)
       end
 
+      Shakapacker.ensure_node_env!
+
       # Check for --build flag
       build_index = argv.index("--build")
       if build_index
@@ -65,6 +67,8 @@ module Shakapacker
     end
 
     def self.run_with_build_config(argv, build_config)
+      Shakapacker.ensure_node_env!
+
       # Apply build config environment variables
       build_config[:environment].each do |key, value|
         ENV[key] = value.to_s

data/lib/shakapacker/doctor.rb

@@ -914,7 +914,7 @@ module Shakapacker
             return unless doctor.config.config_path.exist?
 
             puts "\nConfiguration values for '#{doctor.config.env}' environment:"
-            config_data = doctor.config.send(:data)
+            config_data = doctor.config.data
 
             if config_data.any?
               print_config_data(config_data)

data/lib/shakapacker/version.rb

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

data/package/config.ts

@@ -6,12 +6,11 @@ const { ensureTrailingSlash } = require("./utils/helpers")
 const { railsEnv } = require("./env")
 const configPath = require("./utils/configPath")
 const defaultConfigPath = require("./utils/defaultConfigPath")
-import { Config, YamlConfig, LegacyConfig } from "./types"
+import { Config, YamlConfig } from "./types"
 const {
   isValidYamlConfig,
   createConfigValidationError,
-  isPartialConfig,
-  isValidConfig
+  isPartialConfig
 } = require("./utils/typeGuards")
 const {
   isFileNotFoundError,

data/package/configExporter/cli.ts

@@ -309,58 +309,61 @@ QUICK START (for troubleshooting):
       description:
         "Generate only server config (fallback when no config file exists)"
     })
-    .check((argv) => {
-      if (argv.webpack && argv.rspack) {
+    .check((parsedArgs) => {
+      if (parsedArgs.webpack && parsedArgs.rspack) {
         throw new Error(
           "--webpack and --rspack are mutually exclusive. Please specify only one."
         )
       }
-      if (argv["client-only"] && argv["server-only"]) {
+      if (parsedArgs["client-only"] && parsedArgs["server-only"]) {
         throw new Error(
           "--client-only and --server-only are mutually exclusive. Please specify only one."
         )
       }
-      if (argv.output && argv["save-dir"]) {
+      if (parsedArgs.output && parsedArgs["save-dir"]) {
         throw new Error(
           "--output and --save-dir are mutually exclusive. Use one or the other."
         )
       }
-      if (argv.stdout && argv["save-dir"]) {
+      if (parsedArgs.stdout && parsedArgs["save-dir"]) {
         throw new Error(
           "--stdout and --save-dir are mutually exclusive. Use one or the other."
         )
       }
-      if (argv.build && argv["all-builds"]) {
+      if (parsedArgs.build && parsedArgs["all-builds"]) {
         throw new Error(
           "--build and --all-builds are mutually exclusive. Use one or the other."
         )
       }
-      if (argv.validate && argv["validate-build"]) {
+      if (parsedArgs.validate && parsedArgs["validate-build"]) {
         throw new Error(
           "--validate and --validate-build are mutually exclusive. Use one or the other."
         )
       }
-      if (argv.validate && (argv.build || argv["all-builds"])) {
+      if (
+        parsedArgs.validate &&
+        (parsedArgs.build || parsedArgs["all-builds"])
+      ) {
         throw new Error(
           "--validate cannot be used with --build or --all-builds."
         )
       }
-      if (argv["all-builds"] && argv.output) {
+      if (parsedArgs["all-builds"] && parsedArgs.output) {
         throw new Error(
           "--all-builds and --output are mutually exclusive. Use --save-dir instead."
         )
       }
-      if (argv["all-builds"] && argv.stdout) {
+      if (parsedArgs["all-builds"] && parsedArgs.stdout) {
         throw new Error(
           "--all-builds and --stdout are mutually exclusive. Use --save-dir instead."
         )
       }
-      if (argv.stdout && argv.output) {
+      if (parsedArgs.stdout && parsedArgs.output) {
         throw new Error(
           "--stdout and --output are mutually exclusive. Use one or the other."
         )
       }
-      if (argv.ssr && !argv.init) {
+      if (parsedArgs.ssr && !parsedArgs.init) {
         throw new Error(
           "--ssr can only be used with --init. Use: bin/shakapacker-config --init --ssr"
         )
@@ -539,7 +542,7 @@ end
   // Make executable
   try {
     chmodSync(binStubPath, 0o755)
-  } catch (e) {
+  } catch (_e) {
     // chmod might fail on some systems, but mode in writeFileSync should handle it
   }
 }
@@ -646,6 +649,7 @@ async function runValidateCommand(options: ExportOptions): Promise<number> {
         "development"
 
       // Auto-detect bundler using the build's environment
+      // eslint-disable-next-line no-await-in-loop -- Sequential execution required: each build modifies shared global state (env vars, config cache) that must be cleared/restored between iterations
       const defaultBundler = await autoDetectBundler(
         buildEnv,
         appRoot,
@@ -660,6 +664,7 @@ async function runValidateCommand(options: ExportOptions): Promise<number> {
       )
 
       // Validate the build
+      // eslint-disable-next-line no-await-in-loop -- Sequential execution required: each build modifies shared global state (env vars, config cache) that must be cleared/restored between iterations
       const result = await validator.validateBuild(resolvedBuild, appRoot)
       results.push(result)
 
@@ -738,6 +743,7 @@ async function runAllBuildsCommand(options: ExportOptions): Promise<number> {
 
       // Create a modified options object for this build
       const buildOptions = { ...resolvedOptions, build: buildName }
+      // eslint-disable-next-line no-await-in-loop -- Sequential execution required: each build modifies shared global state (env vars, config cache) that must be cleared/restored between iterations
       const configs = await loadConfigsForEnv(undefined, buildOptions, appRoot)
 
       for (const { config: cfg, metadata } of configs) {
@@ -817,6 +823,7 @@ async function runDoctorMode(
           // Clear shakapacker config cache between builds
           shakapackerConfigCache = null
 
+          // eslint-disable-next-line no-await-in-loop -- Sequential execution required: each build modifies shared global state (env vars, config cache) that must be cleared/restored between iterations
           const configs = await loadConfigsForEnv(
             undefined,
             { ...options, build: buildName },
@@ -884,6 +891,7 @@ async function runDoctorMode(
         process.env.WEBPACK_SERVE = "true"
       }
 
+      // eslint-disable-next-line no-await-in-loop -- Sequential execution required: each config modifies shared global state (env vars, config cache) that must be cleared/restored between iterations
       const configs = await loadConfigsForEnv(env, options, appRoot)
 
       for (const { config, metadata } of configs) {
@@ -922,7 +930,6 @@ async function runDoctorMode(
         }
 
         const fullPath = resolve(targetDir, filename)
-        const fileOutput: FileOutput = { filename, content: output, metadata }
         FileWriter.writeSingleFile(fullPath, output)
         createdFiles.push(fullPath)
       }
@@ -1099,19 +1106,17 @@ async function loadConfigsForEnv(
         console.warn(
           `[Config Exporter] Warning: Skipping dangerous environment variable: ${key}`
         )
-        continue
-      }
-      if (!isBuildEnvVar(key)) {
+      } else if (!isBuildEnvVar(key)) {
         console.warn(
           `[Config Exporter] Warning: Skipping non-whitelisted environment variable: ${key}. ` +
             `Allowed variables are: ${BUILD_ENV_VARS.join(", ")}`
         )
-        continue
-      }
-      if (options.verbose) {
-        console.log(`[Config Exporter]   ${key}=${value}`)
+      } else {
+        if (options.verbose) {
+          console.log(`[Config Exporter]   ${key}=${value}`)
+        }
+        process.env[key] = value
       }
-      process.env[key] = value
     }
 
     // Determine final env: CLI flag > build config NODE_ENV > default
@@ -1193,7 +1198,7 @@ async function loadConfigsForEnv(
   if (configFile.endsWith(".ts")) {
     try {
       require("ts-node/register/transpile-only")
-    } catch (error) {
+    } catch (_error) {
       throw new Error(
         "TypeScript config detected but ts-node is not available. " +
           "Install ts-node as a dev dependency: npm install --save-dev ts-node"
@@ -1630,7 +1635,7 @@ function loadShakapackerConfig(
 
       return result
     }
-  } catch (error: unknown) {
+  } catch (_error: unknown) {
     console.warn(
       `[Config Exporter] Error loading shakapacker config, defaulting to webpack`
     )

data/package/dev_server.ts

@@ -1,8 +1,8 @@
 // These are the raw shakapacker dev server config settings from the YML file with ENV overrides applied.
-import { DevServerConfig } from "./types"
+import type { DevServerConfig, Config } from "./types"
 
 const { isBoolean } = require("./utils/helpers")
-const config = require("./config")
+const config = require("./config") as Config
 
 const envFetch = (key: string): string | boolean | undefined => {
   const value = process.env[key]

data/package/env.ts

@@ -51,7 +51,7 @@ try {
     // File not found, use default configuration
     try {
       config = load(readFileSync(defaultConfigPath, "utf8")) as ConfigFile
-    } catch (defaultError) {
+    } catch (_defaultError) {
       throw new Error(
         `Failed to load Shakapacker configuration.\n` +
           `Neither user config (${configPath}) nor default config (${defaultConfigPath}) could be loaded.\n\n` +

data/package/environments/__type-tests__/rspack-plugin-compatibility.ts

@@ -9,26 +9,26 @@
 import type { RspackPlugin, RspackPluginInstance } from "../types"
 
 // Test 1: RspackPlugin should be assignable to RspackPluginInstance
-const testPluginToInstance = (plugin: RspackPlugin): RspackPluginInstance =>
+const _testPluginToInstance = (plugin: RspackPlugin): RspackPluginInstance =>
   plugin
 
 // Test 2: RspackPluginInstance should be assignable to RspackPlugin
-const testInstanceToPlugin = (instance: RspackPluginInstance): RspackPlugin =>
+const _testInstanceToPlugin = (instance: RspackPluginInstance): RspackPlugin =>
   instance
 
 // Test 3: Array compatibility
-const testArrayCompatibility = (
+const _testArrayCompatibility = (
   plugins: RspackPlugin[]
 ): RspackPluginInstance[] => plugins
-const testArrayCompatibilityReverse = (
+const _testArrayCompatibilityReverse = (
   instances: RspackPluginInstance[]
 ): RspackPlugin[] => instances
 
 // Test 4: Optional parameter compatibility
-const testOptionalParam = (
+const _testOptionalParam = (
   plugin?: RspackPlugin
 ): RspackPluginInstance | undefined => plugin
-const testOptionalParamReverse = (
+const _testOptionalParamReverse = (
   instance?: RspackPluginInstance
 ): RspackPlugin | undefined => instance
 

data/package/environments/base.ts

@@ -1,13 +1,13 @@
-/* eslint global-require: 0 */
 /* eslint import/no-dynamic-require: 0 */
 
 import { Dirent } from "fs"
 import type { Configuration, Entry } from "webpack"
+import type { Config } from "../types"
 
 const { basename, dirname, join, relative, resolve } = require("path")
 const { existsSync, readdirSync } = require("fs")
 const extname = require("path-complete-extname")
-const config = require("../config")
+const config = require("../config") as Config
 const { isProduction } = require("../env")
 
 const pluginsPath = resolve(

data/package/environments/development.ts

@@ -5,13 +5,12 @@
 
 import type {
   WebpackConfigWithDevServer,
-  RspackConfigWithDevServer,
-  ReactRefreshWebpackPlugin,
-  ReactRefreshRspackPlugin
+  RspackConfigWithDevServer
 } from "./types"
+import type { Config } from "../types"
 
 const { merge } = require("webpack-merge")
-const config = require("../config")
+const config = require("../config") as Config
 const baseConfig = require("./base")
 const webpackDevServerConfig = require("../webpackDevServerConfig")
 const { runningWebpackDevServer } = require("../env")
@@ -41,7 +40,6 @@ const webpackDevConfig = (): WebpackConfigWithDevServer => {
     devServerConfig.hot &&
     moduleExists("@pmmmwh/react-refresh-webpack-plugin")
   ) {
-    // eslint-disable-next-line global-require
     const ReactRefreshWebpackPlugin = require("@pmmmwh/react-refresh-webpack-plugin")
     webpackConfig.plugins = [
       ...(webpackConfig.plugins || []),
@@ -74,7 +72,6 @@ const rspackDevConfig = (): RspackConfigWithDevServer => {
     devServerConfig.hot &&
     moduleExists("@rspack/plugin-react-refresh")
   ) {
-    // eslint-disable-next-line global-require
     const ReactRefreshPlugin = require("@rspack/plugin-react-refresh")
     rspackConfig.plugins = [
       ...(rspackConfig.plugins || []),

data/package/environments/production.ts

@@ -3,7 +3,6 @@
  * @module environments/production
  */
 
-/* eslint global-require: 0 */
 /* eslint import/no-dynamic-require: 0 */
 
 import type {
@@ -11,12 +10,13 @@ import type {
   WebpackPluginInstance
 } from "webpack"
 import type { CompressionPluginConstructor } from "./types"
+import type { Config } from "../types"
 
 const { resolve } = require("path")
 const { merge } = require("webpack-merge")
 const baseConfig = require("./base")
 const { moduleExists } = require("../utils/helpers")
-const config = require("../config")
+const config = require("../config") as Config
 
 const optimizationPath = resolve(
   __dirname,

data/package/environments/test.ts

@@ -4,9 +4,10 @@
  */
 
 import type { Configuration as WebpackConfiguration } from "webpack"
+import type { Config } from "../types"
 
 const { merge } = require("webpack-merge")
-const config = require("../config")
+const config = require("../config") as Config
 const baseConfig = require("./base")
 
 interface TestConfig {

data/package/esbuild/index.ts

@@ -1,4 +1,3 @@
-/* eslint global-require: 0 */
 /* eslint import/no-dynamic-require: 0 */
 
 import { resolve } from "path"
@@ -21,7 +20,6 @@ const getLoaderExtension = (filename: string): string => {
 const getCustomConfig = (): Partial<RuleSetRule> => {
   const path = resolve("config", "esbuild.config.js")
   if (existsSync(path)) {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
     return require(path)
   }
   return {}

data/package/index.d.ts

@@ -7,6 +7,7 @@
  * When adding/modifying exports in index.ts, update this file accordingly.
  */
 
+// @ts-expect-error: webpack is an optional peer dependency (using type-only import)
 import type { Configuration, RuleSetRule } from "webpack"
 import type { Config, DevServerConfig, Env } from "./types"
 

data/package/index.d.ts.template

@@ -7,6 +7,7 @@
  * When adding/modifying exports in index.ts, update this file accordingly.
  */
 
+// @ts-expect-error: webpack is an optional peer dependency (using type-only import)
 import type { Configuration, RuleSetRule } from "webpack"
 import type { Config, DevServerConfig, Env } from "./types"
 

data/package/index.ts

@@ -1,4 +1,3 @@
-/* eslint global-require: 0 */
 /* eslint import/no-dynamic-require: 0 */
 
 import * as webpackMerge from "webpack-merge"

data/package/plugins/rspack.ts

@@ -1,8 +1,10 @@
+import type { Config } from "../types"
+
 const { requireOrError } = require("../utils/requireOrError")
 
 const { RspackManifestPlugin } = requireOrError("rspack-manifest-plugin")
 const rspack = requireOrError("@rspack/core")
-const config = require("../config")
+const config = require("../config") as Config
 const { isProduction } = require("../env")
 const { moduleExists } = require("../utils/helpers")
 

data/package/plugins/webpack.ts

@@ -1,9 +1,11 @@
+import type { Config } from "../types"
+
 const { requireOrError } = require("../utils/requireOrError")
 // TODO: Change to `const { WebpackAssetsManifest }` when dropping 'webpack-assets-manifest < 6.0.0' (Node >=20.10.0) support
 const WebpackAssetsManifest = requireOrError("webpack-assets-manifest")
 const webpack = requireOrError("webpack")
-const config = require("../config")
-const { isProduction, isDevelopment } = require("../env")
+const config = require("../config") as Config
+const { isProduction } = require("../env")
 const { moduleExists } = require("../utils/helpers")
 
 const getPlugins = (): unknown[] => {
@@ -15,7 +17,7 @@ const getPlugins = (): unknown[] => {
   const plugins = [
     new webpack.EnvironmentPlugin(process.env),
     new WebpackAssetsManifestConstructor({
-      merge: isDevelopment,
+      merge: true,
       entrypoints: true,
       writeToDisk: true,
       output: config.manifestPath,

data/package/rspack/index.ts

@@ -1,4 +1,3 @@
-/* eslint global-require: 0 */
 /* eslint import/no-dynamic-require: 0 */
 
 // Mixed require/import syntax:
@@ -7,9 +6,10 @@
 import { resolve } from "path"
 import { existsSync } from "fs"
 import type { RspackConfigWithDevServer } from "../environments/types"
+import type { Config } from "../types"
 
 const webpackMerge = require("webpack-merge")
-const config = require("../config")
+const config = require("../config") as Config
 const baseConfig = require("../environments/base")
 const devServer = require("../dev_server")
 const env = require("../env")
@@ -36,7 +36,7 @@ const generateRspackConfig = (
 
   const { nodeEnv } = env
   const path = resolve(__dirname, "../environments", `${nodeEnv}.js`)
-  // eslint-disable-next-line @typescript-eslint/no-require-imports
+
   const environmentConfig = existsSync(path) ? require(path) : baseConfig
 
   // Create base rspack config

data/package/rules/file.ts

@@ -1,4 +1,4 @@
-import { dirname, sep, normalize } from "path"
+import { dirname, normalize } from "path"
 
 const {
   additional_paths: additionalPaths,

data/package/rules/raw.ts

@@ -1,4 +1,6 @@
-const config = require("../config")
+import type { Config } from "../types"
+
+const config = require("../config") as Config
 
 const rspackRawConfig = () => ({
   resourceQuery: /raw/,

data/package/rules/rspack.ts

@@ -1,5 +1,3 @@
-/* eslint global-require: 0 */
-
 const { moduleExists } = require("../utils/helpers")
 const { debug, info, warn } = require("../utils/debug")
 

data/package/rules/sass.ts

@@ -1,5 +1,3 @@
-/* eslint global-require: 0 */
-
 const { getStyleRule } = require("../utils/getStyleRule")
 const { canProcess, packageMajorVersion } = require("../utils/helpers")
 const { additional_paths: extraPaths } = require("../config")

data/package/rules/webpack.ts

@@ -1,4 +1,3 @@
-/* eslint global-require: 0 */
 /* eslint import/no-dynamic-require: 0 */
 
 export = [

data/package/swc/index.ts

@@ -1,4 +1,3 @@
-/* eslint global-require: 0 */
 /* eslint import/no-dynamic-require: 0 */
 
 import { resolve } from "path"
@@ -18,7 +17,6 @@ const isTypescriptFile = (filename: string): boolean =>
 const getCustomConfig = (): Partial<RuleSetRule> => {
   const path = resolve("config", "swc.config.js")
   if (existsSync(path)) {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
     return require(path)
   }
   return {}

data/package/types.ts

@@ -15,6 +15,7 @@ export interface Config {
   source_entry_path: string
   nested_entries: boolean
   css_extract_ignore_order_warnings: boolean
+  css_modules_export_mode?: "named" | "default"
   public_root_path: string
   public_output_path: string
   private_output_path?: string
@@ -53,8 +54,6 @@ export interface Env {
 type Header =
   | Array<{ key: string; value: string }>
   | Record<string, string | string[]>
-type ServerType = "http" | "https" | "spdy"
-type WebSocketType = "sockjs" | "ws"
 
 /**
  * This has the same keys and behavior as https://webpack.js.org/configuration/dev-server/ except:
@@ -63,7 +62,7 @@ type WebSocketType = "sockjs" | "ws"
  * @see {import('webpack-dev-server').Configuration}
  */
 export interface DevServerConfig {
-  allowed_hosts?: "all" | "auto" | string | string[]
+  allowed_hosts?: string | string[]
   bonjour?: boolean | Record<string, unknown> // bonjour.BonjourOptions
   client?: Record<string, unknown> // Client
   compress?: boolean
@@ -71,7 +70,7 @@ export interface DevServerConfig {
   headers?: Header | (() => Header)
   history_api_fallback?: boolean | Record<string, unknown> // HistoryApiFallbackOptions
   hmr?: "only" | boolean
-  host?: "local-ip" | "local-ipv4" | "local-ipv6" | string
+  host?: string
   http2?: boolean
   https?: boolean | https.ServerOptions
   ipc?: boolean | string
@@ -85,23 +84,21 @@ export interface DevServerConfig {
     | string[]
     | Record<string, unknown>
     | Record<string, unknown>[]
-  port?: "auto" | string | number
+  port?: string | number
   proxy?: unknown // ProxyConfigMap | ProxyConfigArray
   setup_exit_signals?: boolean
-  static?: boolean | string | unknown // Static | Array<string | Static>
-  watch_files?: string | string[] | unknown // WatchFiles | Array<WatchFiles | string>
+  static?: unknown // Static | Array<string | Static>
+  watch_files?: unknown // WatchFiles | Array<WatchFiles | string>
   web_socket_server?:
     | string
     | boolean
-    | WebSocketType
     | {
-        type?: string | boolean | WebSocketType
+        type?: string | boolean
         options?: Record<string, unknown>
       }
   server?:
     | string
     | boolean
-    | ServerType
-    | { type?: string | boolean | ServerType; options?: https.ServerOptions }
+    | { type?: string | boolean; options?: https.ServerOptions }
   [otherWebpackDevServerConfigKey: string]: unknown
 }