shakapacker 9.3.0.beta.5 → 9.3.0.beta.7

data/package/configExporter/cli.ts

@@ -351,7 +351,7 @@ QUICK START (for troubleshooting):
 
   # Advanced output options
   bin/shakapacker-config --build=dev --stdout             # View in terminal
-  bin/shakapacker-config --build=dev --output=config.yaml # Save to specific file`
+  bin/shakapacker-config --build=dev --output=config.yml # Save to specific file`
     )
     .strict()
     .parseSync()
@@ -566,7 +566,7 @@ async function runValidateCommand(options: ExportOptions): Promise<number> {
       }
     }
 
-    console.log("\n" + "=".repeat(80))
+    console.log(`\n${"=".repeat(80)}`)
     console.log("🔍 Validating Builds")
     console.log("=".repeat(80))
     console.log(`\nValidating ${buildsToValidate.length} build(s)...\n`)
@@ -577,7 +577,7 @@ async function runValidateCommand(options: ExportOptions): Promise<number> {
         "   This includes all webpack/rspack compilation logs, warnings, and progress messages"
       )
       console.log("   Use without --verbose to see only errors and summaries\n")
-      console.log("=".repeat(80) + "\n")
+      console.log(`${"=".repeat(80)}\n`)
     }
 
     const results = []
@@ -585,7 +585,7 @@ async function runValidateCommand(options: ExportOptions): Promise<number> {
     // Validate each build
     for (const buildName of buildsToValidate) {
       if (options.verbose) {
-        console.log("\n" + "=".repeat(80))
+        console.log(`\n${"=".repeat(80)}`)
         console.log(`📦 VALIDATING BUILD: ${buildName}`)
         console.log("=".repeat(80))
       } else {
@@ -596,6 +596,9 @@ async function runValidateCommand(options: ExportOptions): Promise<number> {
       clearBuildEnvironmentVariables()
       restoreBuildEnvironmentVariables(savedEnv)
 
+      // Clear shakapacker config cache between builds
+      shakapackerConfigCache = null
+
       // Get the build's environment to use for auto-detection
       const buildConfig = config.builds[buildName]
       const buildEnv =
@@ -608,7 +611,11 @@ async function runValidateCommand(options: ExportOptions): Promise<number> {
         "development"
 
       // Auto-detect bundler using the build's environment
-      const defaultBundler = await autoDetectBundler(buildEnv, appRoot)
+      const defaultBundler = await autoDetectBundler(
+        buildEnv,
+        appRoot,
+        options.verbose
+      )
 
       // Resolve build config with the correct default bundler
       const resolvedBuild = loader.resolveBuild(
@@ -692,6 +699,9 @@ async function runAllBuildsCommand(options: ExportOptions): Promise<number> {
       clearBuildEnvironmentVariables()
       restoreBuildEnvironmentVariables(savedEnv)
 
+      // Clear shakapacker config cache between builds
+      shakapackerConfigCache = null
+
       // Create a modified options object for this build
       const buildOptions = { ...resolvedOptions, build: buildName }
       const configs = await loadConfigsForEnv(undefined, buildOptions, appRoot)
@@ -713,7 +723,7 @@ async function runAllBuildsCommand(options: ExportOptions): Promise<number> {
     }
 
     // Print summary
-    console.log("\n" + "=".repeat(80))
+    console.log(`\n${"=".repeat(80)}`)
     console.log("✅ All Builds Exported!")
     console.log("=".repeat(80))
     console.log(`\nCreated ${createdFiles.length} configuration file(s) in:`)
@@ -722,7 +732,7 @@ async function runAllBuildsCommand(options: ExportOptions): Promise<number> {
     createdFiles.forEach((file) => {
       console.log(`  ✓ ${basename(file)}`)
     })
-    console.log("\n" + "=".repeat(80) + "\n")
+    console.log(`\n${"=".repeat(80)}\n`)
 
     return 0
   } catch (error: unknown) {
@@ -743,7 +753,7 @@ async function runDoctorMode(
   const savedEnv = saveBuildEnvironmentVariables()
 
   try {
-    console.log("\n" + "=".repeat(80))
+    console.log(`\n${"=".repeat(80)}`)
     console.log("🔍 Config Exporter - Doctor Mode")
     console.log("=".repeat(80))
 
@@ -770,6 +780,9 @@ async function runDoctorMode(
           clearBuildEnvironmentVariables()
           restoreBuildEnvironmentVariables(savedEnv)
 
+          // Clear shakapacker config cache between builds
+          shakapackerConfigCache = null
+
           const configs = await loadConfigsForEnv(
             undefined,
             { ...options, build: buildName },
@@ -798,9 +811,13 @@ async function runDoctorMode(
         // If config file exists but is invalid, show error and exit
         const errorMessage =
           error instanceof Error ? error.message : String(error)
-        console.error(`\n❌ Config file found but invalid: ${errorMessage}`)
+        console.error(`\n❌ Error loading build configuration:`)
+        console.error(`\n${errorMessage}`)
+        console.error(
+          `\n💡 To fix this issue, check your build config in ${configFilePath}`
+        )
         console.error(
-          `Fix the config file or run: bin/shakapacker-config --init\n`
+          `   or run: bin/shakapacker-config --init to regenerate it.\n`
         )
         throw error
       }
@@ -825,6 +842,9 @@ async function runDoctorMode(
       clearBuildEnvironmentVariables()
       restoreBuildEnvironmentVariables(savedEnv)
 
+      // Clear shakapacker config cache between builds
+      shakapackerConfigCache = null
+
       // Set WEBPACK_SERVE for HMR config
       if (hmr) {
         process.env.WEBPACK_SERVE = "true"
@@ -883,7 +903,7 @@ async function runDoctorMode(
 
 function printDoctorSummary(createdFiles: string[], targetDir: string): void {
   // Print summary
-  console.log("\n" + "=".repeat(80))
+  console.log(`\n${"=".repeat(80)}`)
   console.log("✅ Export Complete!")
   console.log("=".repeat(80))
   console.log(`\nCreated ${createdFiles.length} configuration file(s) in:`)
@@ -906,14 +926,14 @@ function printDoctorSummary(createdFiles: string[], targetDir: string): void {
   }
 
   if (shouldSuggestGitignore) {
-    console.log("\n" + "─".repeat(80))
+    console.log(`\n${"─".repeat(80)}`)
     console.log(
       "💡 Tip: Add the export directory to .gitignore to avoid committing config files:"
     )
     console.log(`\n  echo "${dirName}/" >> .gitignore\n`)
   }
 
-  console.log("\n" + "=".repeat(80) + "\n")
+  console.log(`\n${"=".repeat(80)}\n`)
 }
 
 async function runSaveMode(
@@ -930,7 +950,7 @@ async function runSaveMode(
   if (options.output) {
     // Single file output
     const combined = configs.map((c) => c.config)
-    const metadata = configs[0].metadata
+    const { metadata } = configs[0]
     metadata.configCount = combined.length
 
     const output = formatConfig(
@@ -970,15 +990,15 @@ async function runStdoutMode(
   options: ExportOptions,
   appRoot: string
 ): Promise<void> {
-  const configs = await loadConfigsForEnv(options.env!, options, appRoot)
+  const configs = await loadConfigsForEnv(options.env, options, appRoot)
   const combined = configs.map((c) => c.config)
-  const metadata = configs[0].metadata
+  const { metadata } = configs[0]
   metadata.configCount = combined.length
 
   const config = combined.length === 1 ? combined[0] : combined
   const output = formatConfig(config, metadata, options, appRoot)
 
-  console.log("\n" + "=".repeat(80) + "\n")
+  console.log(`\n${"=".repeat(80)}\n`)
   console.log(output)
 }
 
@@ -986,9 +1006,9 @@ async function runSingleFileMode(
   options: ExportOptions,
   appRoot: string
 ): Promise<void> {
-  const configs = await loadConfigsForEnv(options.env!, options, appRoot)
+  const configs = await loadConfigsForEnv(options.env, options, appRoot)
   const combined = configs.map((c) => c.config)
-  const metadata = configs[0].metadata
+  const { metadata } = configs[0]
   metadata.configCount = combined.length
 
   const config = combined.length === 1 ? combined[0] : combined
@@ -1015,7 +1035,11 @@ async function loadConfigsForEnv(
     // Use a temporary env for auto-detection, will be overridden by build config
     const tempEnv = env || "development"
     const loader = new ConfigFileLoader(options.configFile)
-    const defaultBundler = await autoDetectBundler(tempEnv, appRoot)
+    const defaultBundler = await autoDetectBundler(
+      tempEnv,
+      appRoot,
+      options.verbose
+    )
     const resolvedBuild = loader.resolveBuild(
       options.build,
       options,
@@ -1039,6 +1063,12 @@ async function loadConfigsForEnv(
       "DYLD_INSERT_LIBRARIES"
     ]
 
+    if (options.verbose) {
+      console.log(
+        `[Config Exporter] Setting environment variables from build config...`
+      )
+    }
+
     for (const [key, value] of Object.entries(resolvedBuild.environment)) {
       if (DANGEROUS_ENV_VARS.includes(key)) {
         console.warn(
@@ -1053,6 +1083,9 @@ async function loadConfigsForEnv(
         )
         continue
       }
+      if (options.verbose) {
+        console.log(`[Config Exporter]   ${key}=${value}`)
+      }
       process.env[key] = value
     }
 
@@ -1080,18 +1113,36 @@ async function loadConfigsForEnv(
     const railsEnv =
       options.env || resolvedBuild.environment.RAILS_ENV || finalEnv
     process.env.RAILS_ENV = railsEnv
+
+    // Auto-set CLIENT_BUNDLE_ONLY/SERVER_BUNDLE_ONLY from outputs if not already in environment
+    // This allows webpack configs to return the correct number of bundles
+    if (
+      !resolvedBuild.environment.CLIENT_BUNDLE_ONLY &&
+      !resolvedBuild.environment.SERVER_BUNDLE_ONLY
+    ) {
+      if (buildOutputs.length === 1) {
+        if (buildOutputs[0] === "client") {
+          process.env.CLIENT_BUNDLE_ONLY = "yes"
+        } else if (buildOutputs[0] === "server") {
+          process.env.SERVER_BUNDLE_ONLY = "yes"
+        }
+      }
+    }
   } else {
     // No build config - use CLI env or default
     finalEnv = env || "development"
 
     // Auto-detect bundler if not specified
-    bundler = options.bundler || (await autoDetectBundler(finalEnv, appRoot))
+    bundler =
+      options.bundler ||
+      (await autoDetectBundler(finalEnv, appRoot, options.verbose))
 
     // Set environment variables
     process.env.NODE_ENV = finalEnv
     process.env.RAILS_ENV = finalEnv
   }
 
+  // Handle CLI flags for client/server only
   if (options.clientOnly) {
     process.env.CLIENT_BUNDLE_ONLY = "yes"
   } else if (options.serverOnly) {
@@ -1100,9 +1151,10 @@ async function loadConfigsForEnv(
 
   // Find and load config file
   const configFile =
-    customConfigFile || findConfigFile(bundler, appRoot, finalEnv)
+    customConfigFile ||
+    findConfigFile(bundler, appRoot, finalEnv, options.verbose)
   // Quiet mode for cleaner output - only show if verbose or errors
-  if (process.env.VERBOSE) {
+  if (options.verbose) {
     console.log(`[Config Exporter] Loading config: ${configFile}`)
     console.log(`[Config Exporter] Environment: ${finalEnv}`)
     console.log(`[Config Exporter] Bundler: ${bundler}`)
@@ -1115,7 +1167,6 @@ async function loadConfigsForEnv(
   // Register ts-node for TypeScript config files
   if (configFile.endsWith(".ts")) {
     try {
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
       require("ts-node/register/transpile-only")
     } catch (error) {
       throw new Error(
@@ -1164,8 +1215,19 @@ async function loadConfigsForEnv(
     }
   })
 
-  // eslint-disable-next-line @typescript-eslint/no-var-requires
-  let loadedConfig = require(configFile)
+  let loadedConfig: any
+  try {
+    loadedConfig = require(configFile)
+  } catch (error: unknown) {
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    throw new Error(
+      `Failed to load webpack/rspack config file.\n\n` +
+        `Config file: ${configFile}\n` +
+        `Build: ${buildName || "default"}\n` +
+        `Error: ${errorMessage}\n\n` +
+        `Tip: Check that the config file is valid and doesn't have syntax errors.`
+    )
+  }
 
   // Handle ES module default export
   if (typeof loadedConfig === "object" && "default" in loadedConfig) {
@@ -1198,10 +1260,41 @@ async function loadConfigsForEnv(
     } catch (error: unknown) {
       const errorMessage =
         error instanceof Error ? error.message : String(error)
+
+      // Build detailed environment information for debugging
+      const envDetails = [
+        `Config file: ${configFile}`,
+        `Build: ${buildName || "default"}`,
+        ``,
+        `Current Environment Variables:`,
+        `  NODE_ENV: ${process.env.NODE_ENV || "(not set)"}`,
+        `  RAILS_ENV: ${process.env.RAILS_ENV || "(not set)"}`,
+        `  CLIENT_BUNDLE_ONLY: ${process.env.CLIENT_BUNDLE_ONLY || "(not set)"}`,
+        `  SERVER_BUNDLE_ONLY: ${process.env.SERVER_BUNDLE_ONLY || "(not set)"}`,
+        `  WEBPACK_SERVE: ${process.env.WEBPACK_SERVE || "(not set)"}`,
+        ``,
+        `Bundler env args: ${JSON.stringify(envObject)}`,
+        `Mode: ${finalEnv}`,
+        ``,
+        `Error: ${errorMessage}`,
+        ``
+      ]
+
+      // Add suggestion based on common error patterns
+      let suggestion = `Check your webpack/rspack config for errors. The config function threw an exception when called.`
+      if (errorMessage.includes("NODE_ENV") && !process.env.NODE_ENV) {
+        suggestion =
+          `NODE_ENV is not set. ` +
+          `Your build config should set NODE_ENV in the 'environment' section.\n` +
+          `Example:\n` +
+          `  environment:\n` +
+          `    NODE_ENV: "development"`
+      }
+
       throw new Error(
-        `Failed to execute config function: ${errorMessage}\n` +
-          `Config file: ${configFile}\n` +
-          `Environment: ${JSON.stringify(envObject)}`
+        `Failed to execute config function: ${errorMessage}\n${envDetails.join(
+          "\n"
+        )}\nTip: ${suggestion}`
       )
     }
   }
@@ -1212,29 +1305,81 @@ async function loadConfigsForEnv(
     : [loadedConfig]
   const results: Array<{ config: any; metadata: ConfigMetadata }> = []
 
+  // Validate config count matches expected outputs
+  if (buildOutputs.length > 0 && configs.length !== buildOutputs.length) {
+    const errorLines = [
+      `Webpack config returned ${configs.length} config(s) but outputs array specifies ${buildOutputs.length}.`,
+      ``,
+      `Build: ${buildName || "default"}`,
+      `Config file: ${configFile}`,
+      `Expected outputs: [${buildOutputs.join(", ")}]`,
+      `Actual configs returned: ${configs.length}`,
+      ``,
+      `This mismatch means:`
+    ]
+
+    if (configs.length < buildOutputs.length) {
+      errorLines.push(
+        `  - Your webpack config is returning FEWER configs than expected.`,
+        `  - Either update your webpack config to return ${buildOutputs.length} config(s),`,
+        `  - Or update the 'outputs' array in your build config to match what webpack returns.`
+      )
+    } else {
+      errorLines.push(
+        `  - Your webpack config is returning MORE configs than expected.`,
+        `  - Either update the 'outputs' array to include all ${configs.length} outputs,`,
+        `  - Or update your webpack config to return only ${buildOutputs.length} config(s).`
+      )
+    }
+
+    errorLines.push(
+      ``,
+      `Example fix in build config:`,
+      `  outputs:`,
+      ...Array.from({ length: configs.length }, (_, i) =>
+        i < buildOutputs.length
+          ? `    - ${buildOutputs[i]}`
+          : `    - config-${i + 1}  # Add a name for this config`
+      )
+    )
+
+    throw new Error(errorLines.join("\n"))
+  }
+
+  // Debug logging
+  if (options.verbose || buildOutputs.length > 0) {
+    console.log(
+      `[Config Exporter] Webpack returned ${configs.length} config(s), buildOutputs: [${buildOutputs.join(", ")}]`
+    )
+    if (buildOutputs.length > 0 && configs.length === buildOutputs.length) {
+      console.log(
+        `[Config Exporter] ✓ Config count matches outputs array (${configs.length})`
+      )
+    }
+  }
+
   configs.forEach((cfg, index) => {
-    let configType: "client" | "server" | "all" = "all"
+    let configType: string = "all"
 
     // Use outputs from build config if available
-    if (
-      buildOutputs.length > 0 &&
-      index < buildOutputs.length &&
-      buildOutputs[index]
-    ) {
-      const outputValue = buildOutputs[index]
-      // Validate the output value is a valid config type
-      if (
-        outputValue === "client" ||
-        outputValue === "server" ||
-        outputValue === "all"
-      ) {
-        configType = outputValue
-      } else {
-        throw new Error(
-          `Invalid output type '${outputValue}' at index ${index} in build '${buildName}'. ` +
-            `Allowed values are: client, server, all`
+    if (buildOutputs.length > 0) {
+      // If outputs are specified, skip configs beyond the outputs array
+      if (index >= buildOutputs.length) {
+        console.log(
+          `[Config Exporter] Skipping config[${index}] - beyond outputs array`
         )
+        return // Skip this config
+      }
+
+      const outputValue = buildOutputs[index]
+      if (!outputValue || outputValue.trim() === "") {
+        return // Skip null/undefined/empty string entries
       }
+
+      // Accept any string as a valid output name
+      // Built-in types: client, server, all, client-hmr
+      // Custom types: client-modern, client-legacy, server-bundle, etc.
+      configType = outputValue
     } else if (configs.length === 2) {
       // Likely client and server configs
       configType = index === 0 ? "client" : "server"
@@ -1306,39 +1451,37 @@ function formatConfig(
       return value
     }
     return JSON.stringify({ metadata, config }, jsonReplacer, 2)
-  } else {
-    // inspect format
-    const inspectOptions = {
-      depth: options.depth,
-      colors: false,
-      maxArrayLength: null,
-      maxStringLength: null,
-      breakLength: 120,
-      compact: false
-    }
-
-    let output =
-      "=== METADATA ===\n\n" + inspect(metadata, inspectOptions) + "\n\n"
-    output += "=== CONFIG ===\n\n"
+  }
+  // inspect format
+  const inspectOptions = {
+    depth: options.depth,
+    colors: false,
+    maxArrayLength: null,
+    maxStringLength: null,
+    breakLength: 120,
+    compact: false
+  }
 
-    if (Array.isArray(config)) {
-      output += `Total configs: ${config.length}\n\n`
-      config.forEach((cfg, index) => {
-        output += `--- Config [${index}] ---\n\n`
-        output += inspect(cfg, inspectOptions) + "\n\n"
-      })
-    } else {
-      output += inspect(config, inspectOptions) + "\n"
-    }
+  let output = `=== METADATA ===\n\n${inspect(metadata, inspectOptions)}\n\n`
+  output += "=== CONFIG ===\n\n"
 
-    return output
+  if (Array.isArray(config)) {
+    output += `Total configs: ${config.length}\n\n`
+    config.forEach((cfg, index) => {
+      output += `--- Config [${index}] ---\n\n`
+      output += `${inspect(cfg, inspectOptions)}\n\n`
+    })
+  } else {
+    output += `${inspect(config, inspectOptions)}\n`
   }
+
+  return output
 }
 
 function cleanConfig(obj: any, rootPath: string): any {
   const makePathRelative = (str: string): string => {
     if (typeof str === "string" && str.startsWith(rootPath)) {
-      return "./" + str.substring(rootPath.length + 1)
+      return `./${str.substring(rootPath.length + 1)}`
     }
     return str
   }
@@ -1398,10 +1541,31 @@ function cleanConfig(obj: any, rootPath: string): any {
 /**
  * Loads and returns shakapacker.yml configuration
  */
+// Cache to avoid duplicate loading and logging
+let shakapackerConfigCache: {
+  env: string
+  result: { bundler: "webpack" | "rspack"; configPath: string }
+} | null = null
+
 function loadShakapackerConfig(
   env: string,
-  appRoot: string
+  appRoot: string,
+  verbose = false
 ): { bundler: "webpack" | "rspack"; configPath: string } {
+  // Return cached result if same environment
+  if (shakapackerConfigCache && shakapackerConfigCache.env === env) {
+    if (verbose) {
+      console.log(
+        `[Config Exporter] Using cached bundler config for env: ${env}`
+      )
+    }
+    return shakapackerConfigCache.result
+  }
+
+  if (verbose) {
+    console.log(`[Config Exporter] Loading shakapacker config for env: ${env}`)
+  }
+
   try {
     const configFilePath =
       process.env.SHAKAPACKER_CONFIG ||
@@ -1417,10 +1581,12 @@ function loadShakapackerConfig(
         console.warn(
           `[Config Exporter] Invalid bundler '${bundler}' in shakapacker.yml, defaulting to webpack`
         )
-        return {
-          bundler: "webpack",
+        const result = {
+          bundler: "webpack" as const,
           configPath: bundler === "rspack" ? "config/rspack" : "config/webpack"
         }
+        shakapackerConfigCache = { env, result }
+        return result
       }
 
       // Get config path
@@ -1429,10 +1595,15 @@ function loadShakapackerConfig(
         customConfigPath ||
         (bundler === "rspack" ? "config/rspack" : "config/webpack")
 
+      const result = { bundler, configPath }
+      shakapackerConfigCache = { env, result }
+
+      // Only log on first call (when cache was empty)
       console.log(
         `[Config Exporter] Auto-detected bundler: ${bundler}, config path: ${configPath}`
       )
-      return { bundler, configPath }
+
+      return result
     }
   } catch (error: unknown) {
     console.warn(
@@ -1440,7 +1611,9 @@ function loadShakapackerConfig(
     )
   }
 
-  return { bundler: "webpack", configPath: "config/webpack" }
+  const result = { bundler: "webpack" as const, configPath: "config/webpack" }
+  shakapackerConfigCache = { env, result }
+  return result
 }
 
 /**
@@ -1458,18 +1631,20 @@ function loadShakapackerConfig(
  */
 async function autoDetectBundler(
   env: string,
-  appRoot: string
+  appRoot: string,
+  verbose = false
 ): Promise<"webpack" | "rspack"> {
-  const { bundler } = loadShakapackerConfig(env, appRoot)
+  const { bundler } = loadShakapackerConfig(env, appRoot, verbose)
   return bundler
 }
 
 function findConfigFile(
   bundler: "webpack" | "rspack",
   appRoot: string,
-  env: string
+  env: string,
+  verbose = false
 ): string {
-  const { configPath } = loadShakapackerConfig(env, appRoot)
+  const { configPath } = loadShakapackerConfig(env, appRoot, verbose)
   const extensions = ["ts", "js"]
 
   if (bundler === "rspack") {
@@ -1527,7 +1702,6 @@ function setupNodePath(appRoot: string): void {
       ? `${nodePaths.join(delimiter)}${delimiter}${existingNodePath}`
       : nodePaths.join(delimiter)
 
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
     require("module").Module._initPaths()
   }
 }

data/package/configExporter/fileWriter.ts

@@ -46,24 +46,33 @@ export class FileWriter {
    * Generate filename for a config export
    * Format without build: {bundler}-{env}-{type}.{ext}
    * Format with build: {bundler}-{build}-{type}.{ext}
-   * Examples:
-   *   webpack-development-client.yaml
-   *   rspack-production-server.yaml
-   *   webpack-test-all.json
-   *   webpack-development-client-hmr.yaml
-   *   webpack-dev-client.yaml (with build name)
-   *   rspack-cypress-dev-server.yaml (with build name)
+   *
+   * @param bundler - The bundler type (webpack, rspack)
+   * @param env - The environment (development, production, test)
+   * @param configType - Type of config. Built-in: "client", "server", "all", "client-hmr". Custom: any string from outputs array
+   * @param format - Output format (yaml, json, inspect)
+   * @param buildName - Optional build name that overrides env in filename
+   *
+   * @example
+   * // Built-in types
+   * generateFilename("webpack", "development", "client", "yaml")
+   * // => "webpack-development-client.yml"
+   *
+   * @example
+   * // Custom output names
+   * generateFilename("webpack", "development", "client-modern", "yaml", "dev-hmr")
+   * // => "webpack-dev-hmr-client-modern.yml"
    */
   static generateFilename(
     bundler: string,
     env: string,
-    configType: "client" | "server" | "all" | "client-hmr",
+    configType: string,
     format: "yaml" | "json" | "inspect",
     buildName?: string
   ): string {
     let ext: string
     if (format === "yaml") {
-      ext = "yaml"
+      ext = "yml"
     } else if (format === "json") {
       ext = "json"
     } else {

data/package/configExporter/types.ts

@@ -29,7 +29,12 @@ export interface ConfigMetadata {
   bundler: string
   environment: string
   configFile: string
-  configType: "client" | "server" | "all" | "client-hmr"
+  /**
+   * Type of webpack/rspack config output.
+   * Built-in types: "client", "server", "all", "client-hmr"
+   * Custom types: Any string matching your outputs array (e.g., "client-modern", "client-legacy", "server-bundle")
+   */
+  configType: string
   configCount: number
   buildName?: string // New: name of the build from config file
   environmentVariables: {