chore(build): add esbuild minify validation check

Add validation script to ensure esbuild config maintains minify: false.
Minification breaks ESM/CJS interop and makes debugging harder.

Author: jdalton

scripts/check.mjs

@@ -49,6 +49,13 @@ async function main() {
           ...(process.platform === 'win32' && { shell: true }),
         },
       },
+      {
+        args: ['scripts/validate-esbuild-minify.mjs'],
+        command: 'node',
+        options: {
+          ...(process.platform === 'win32' && { shell: true }),
+        },
+      },
     ]
 
     const exitCodes = await runParallel(checks)

scripts/validate-esbuild-minify.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Validates that esbuild configuration has minify: false.
+ * Minification breaks ESM/CJS interop and makes debugging harder.
+ */
+
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const rootPath = path.join(__dirname, '..')
+
+/**
+ * Validate esbuild configuration has minify: false.
+ */
+async function validateEsbuildMinify() {
+  const configPath = path.join(rootPath, '.config/esbuild.config.mjs')
+
+  try {
+    // Dynamic import of the esbuild config
+    const config = await import(configPath)
+
+    const violations = []
+
+    // Check buildConfig
+    if (config.buildConfig) {
+      if (config.buildConfig.minify !== false) {
+        violations.push({
+          config: 'buildConfig',
+          value: config.buildConfig.minify,
+          message: 'buildConfig.minify must be false',
+          location: `${configPath}:242`,
+        })
+      }
+    }
+
+    // Check watchConfig
+    if (config.watchConfig) {
+      if (config.watchConfig.minify !== false) {
+        violations.push({
+          config: 'watchConfig',
+          value: config.watchConfig.minify,
+          message: 'watchConfig.minify must be false',
+          location: `${configPath}:270`,
+        })
+      }
+    }
+
+    return violations
+  } catch (error) {
+    console.error(`Failed to load esbuild config: ${error.message}`)
+    process.exitCode = 1
+    return []
+  }
+}
+
+async function main() {
+  const violations = await validateEsbuildMinify()
+
+  if (violations.length === 0) {
+    console.log('✓ esbuild minify validation passed')
+    process.exitCode = 0
+    return
+  }
+
+  console.error('❌ esbuild minify validation failed\n')
+
+  for (const violation of violations) {
+    console.error(`  ${violation.message}`)
+    console.error(`  Found: minify: ${violation.value}`)
+    console.error(`  Expected: minify: false`)
+    console.error(`  Location: ${violation.location}`)
+    console.error('')
+  }
+
+  console.error('Minification breaks ESM/CJS interop and makes debugging harder.')
+  console.error('')
+
+  process.exitCode = 1
+}
+
+main().catch(error => {
+  console.error('Validation failed:', error)
+  process.exitCode = 1
+})