build: migrate from rollup to esbuild for faster builds

Author: jdalton

.config/.oxlintrc.json

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview esbuild configuration for fast builds with smaller bundles
+ */
+
+import { builtinModules } from 'node:module'
+import path from 'node:path'
+
+const rootPath = path.join(import.meta.dirname, '..')
+const srcPath = path.join(rootPath, 'src')
+const distPath = path.join(rootPath, 'dist')
+
+// External packages that should not be bundled
+const EXTERNAL_PACKAGES = new Set(['@socketsecurity/registry'])
+
+// Build configuration for CommonJS output
+export const buildConfig = {
+  entryPoints: [`${srcPath}/index.ts`],
+  outdir: distPath,
+  bundle: true,
+  format: 'cjs',
+  platform: 'node',
+  // Minimum Node version from package.json
+  target: 'node18',
+  sourcemap: false,
+  minify: true,
+  treeShaking: true,
+  // For bundle analysis
+  metafile: true,
+  logLevel: 'info',
+
+  // Preserve module structure for better tree-shaking
+  splitting: false,
+
+  // External dependencies
+  external: [
+    // Node.js built-ins
+    ...builtinModules,
+    ...builtinModules.map(m => `node:${m}`),
+    // External packages
+    ...Array.from(EXTERNAL_PACKAGES)
+  ],
+
+  // Banner for generated code
+  banner: {
+    js: '/* Socket PackageURL - Built with esbuild */'
+  },
+
+  // TypeScript configuration
+  tsconfig: path.join(rootPath, 'tsconfig.json'),
+
+  // Define constants for optimization
+  define: {
+    'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'production')
+  }
+}
+
+// Watch configuration for development
+export const watchConfig = {
+  ...buildConfig,
+  minify: false,
+  sourcemap: 'inline',
+  logLevel: 'debug',
+  watch: {
+    onRebuild(error, result) {
+      if (error) {
+        console.error('Watch build failed:', error)
+      } else {
+        console.log('Watch build succeeded')
+        if (result.metafile) {
+          const analysis = analyzeMetafile(result.metafile)
+          console.log(analysis)
+        }
+      }
+    }
+  }
+}
+
+/**
+ * Analyze build output for size information
+ */
+function analyzeMetafile(metafile) {
+  const outputs = Object.keys(metafile.outputs)
+  let totalSize = 0
+
+  const files = outputs.map(file => {
+    const output = metafile.outputs[file]
+    totalSize += output.bytes
+    return {
+      name: path.relative(rootPath, file),
+      size: (output.bytes / 1024).toFixed(2) + ' KB'
+    }
+  })
+
+  return {
+    files,
+    totalSize: (totalSize / 1024).toFixed(2) + ' KB'
+  }
+}
+
+export { analyzeMetafile }

.config/babel.config.js

@@ -86,6 +86,12 @@ TypeScript implementation of [Package URL specification](https://github.com/pack
 
 ### TypeScript Patterns
 
+#### Import Style
+🚨 MANDATORY - Type imports must be on separate lines:
+- ✅ `import { parseScriptArgs, isQuiet } from './argv.mjs'`
+  `import type { ArgParserConfig } from './argv.mjs'`
+- ❌ `import { parseScriptArgs, isQuiet, type ArgParserConfig } from './argv.mjs'`
+
 #### Optional Properties
 With `exactOptionalPropertyTypes`, assign conditionally:
 - ✅ `if (value !== undefined) { this.prop = value }`

.config/esbuild.config.mjs

@@ -34,21 +34,14 @@
     "check:lint": "node scripts/lint.mjs --all",
     "build": "node scripts/build.mjs",
     "check:tsc": "tsgo --noEmit -p .config/tsconfig.check.json",
-    "clean:dist": "node scripts/clean.mjs --dist",
-    "clean:dist:types": "node scripts/clean.mjs --dist-types",
     "clean": "node scripts/clean.mjs",
-    "clean:cache": "node scripts/clean.mjs --cache",
-    "clean:coverage": "node scripts/clean.mjs --coverage",
-    "clean:node_modules": "node scripts/clean.mjs --node-modules",
     "coverage": "node scripts/coverage.mjs",
     "coverage:test": "node scripts/coverage.mjs --code-only",
     "coverage:percent": "node scripts/coverage-percent.mjs",
     "coverage:type": "type-coverage",
     "coverage:type:verbose": "type-coverage --detail",
     "lint": "node scripts/lint.mjs",
     "fix": "node scripts/lint.mjs --fix",
-    "knip:dependencies": "knip --dependencies",
-    "knip:exports": "knip --include exports,duplicates",
     "prepare": "husky",
     "prepublishOnly": "echo 'ERROR: Use GitHub Actions workflow for publishing' && exit 1",
     "test": "node scripts/test.mjs",
@@ -60,18 +53,10 @@
     "update:data:npm": "node ./scripts/update-data-npm.mjs"
   },
   "devDependencies": {
-    "@babel/core": "7.28.4",
-    "@babel/plugin-transform-runtime": "7.28.3",
-    "@babel/preset-typescript": "7.27.1",
-    "@babel/runtime": "7.28.4",
     "@biomejs/biome": "2.2.4",
     "@dotenvx/dotenvx": "1.49.0",
     "@eslint/compat": "1.3.2",
     "@eslint/js": "9.35.0",
-    "@rollup/plugin-babel": "6.0.4",
-    "@rollup/plugin-commonjs": "28.0.6",
-    "@rollup/plugin-json": "6.1.0",
-    "@rollup/plugin-node-resolve": "16.0.1",
     "@socketsecurity/registry": "1.5.3",
     "@types/node": "24.6.2",
     "@typescript/native-preview": "7.0.0-dev.20250926.1",
@@ -80,6 +65,7 @@
     "all-the-package-names-v1.3905.0": "npm:[email protected]",
     "del-cli": "6.0.0",
     "dev-null-cli": "2.0.0",
+    "esbuild": "^0.25.10",
     "eslint": "9.35.0",
     "eslint-plugin-import-x": "4.16.1",
     "eslint-plugin-n": "17.23.1",
@@ -88,11 +74,8 @@
     "fast-glob": "3.3.3",
     "globals": "16.4.0",
     "husky": "9.1.7",
-    "knip": "5.63.1",
     "npm-run-all2": "8.0.4",
-    "oxlint": "1.15.0",
     "pacote": "21.0.1",
-    "rollup": "4.50.1",
     "semver": "7.7.2",
     "taze": "19.6.0",
     "type-coverage": "2.29.7",