feat: migrate build system to TypeScript (v0.4.0)

Author: Morgy93

CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2025-09-30
+
+### Changed
+
+- **Build System**: Complete migration from JavaScript to TypeScript for build configuration
+  - `esbuild.js` → `esbuild.ts`: Build configuration now fully typed with TypeScript interfaces
+  - Added `tsx` dependency for direct TypeScript execution without compilation step
+  - Updated npm scripts to use `tsx` for running TypeScript files directly
+  - Cleaned up duplicate and legacy JavaScript build files
+
+### Improved
+
+- **Type Safety**: Enhanced type safety across build infrastructure with proper TypeScript interfaces
+- **Developer Experience**: Better IntelliSense and error detection in build configuration
+- **Code Quality**: Significantly reduced JavaScript percentage in source files
+- **Build Performance**: Streamlined build process with modern TypeScript tooling
+
+### Technical Details
+
+- Source code is now primarily TypeScript (11 TypeScript files vs 2 configuration files)
+- Only `eslint.config.mjs` and `.vscode-test.mjs` remain as JavaScript (tooling requirements)
+- All build and development workflows use native TypeScript execution via `tsx`
+- Enhanced type annotations for esbuild plugins and configuration objects
+- Maintained full backward compatibility with existing functionality
+
 ## [0.3.0] - 2025-09-30
 
 ### Updated

esbuild.js esbuild.tsesbuild.js renamed to esbuild.ts

@@ -17,34 +17,33 @@
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
 
-const esbuild = require("esbuild");
+import * as esbuild from 'esbuild';
 
-const production = process.argv.includes('--production');
-const watch = process.argv.includes('--watch');
+const production: boolean = process.argv.includes('--production');
+const watch: boolean = process.argv.includes('--watch');
 
-/**
- * @type {import('esbuild').Plugin}
- */
-const esbuildProblemMatcherPlugin = {
+const esbuildProblemMatcherPlugin: esbuild.Plugin = {
 	name: 'esbuild-problem-matcher',
 
-	setup(build) {
+	setup(build: esbuild.PluginBuild): void {
 		build.onStart(() => {
 			console.log('[watch] build started');
 		});
-		build.onEnd((result) => {
+		build.onEnd((result: esbuild.BuildResult) => {
 			result.errors.forEach(({ text, location }) => {
 				console.error(`✘ [ERROR] ${text}`);
-				console.error(`    ${location.file}:${location.line}:${location.column}:`);
+				if (location) {
+					console.error(`    ${location.file}:${location.line}:${location.column}:`);
+				}
 			});
 			console.log('[watch] build finished');
 		});
 	},
 };
 
-async function main() {
+async function main(): Promise<void> {
 	// Build extension
-	const extensionCtx = await esbuild.context({
+	const extensionCtx: esbuild.BuildContext = await esbuild.context({
 		entryPoints: ['src/extension.ts'],
 		bundle: true,
 		format: 'cjs',
@@ -59,7 +58,7 @@ async function main() {
 	});
 
 	// Build tests
-	const testCtx = await esbuild.context({
+	const testCtx: esbuild.BuildContext = await esbuild.context({
 		entryPoints: ['src/test/*.test.ts'],
 		bundle: true,
 		format: 'cjs',
@@ -72,6 +71,7 @@ async function main() {
 		logLevel: 'silent',
 		plugins: [esbuildProblemMatcherPlugin],
 	});
+
 	if (watch) {
 		await Promise.all([
 			extensionCtx.watch(),
@@ -85,7 +85,7 @@ async function main() {
 	}
 }
 
-main().catch(e => {
+main().catch((e: Error) => {
 	console.error(e);
 	process.exit(1);
 });

eslint.config.mjs

@@ -22,6 +22,7 @@ import tsParser from "@typescript-eslint/parser";
 
 export default [{
     files: ["**/*.ts"],
+    ignores: ["esbuild.ts", "dist/**/*", "node_modules/**/*"],
 }, {
     plugins: {
         "@typescript-eslint": typescriptEslint,

package-lock.json

@@ -2,7 +2,7 @@
   "name": "vscode-ddev-phpstan",
   "displayName": "DDEV PHPStan",
   "description": "PHP static analysis with PHPStan in DDEV containers for VS Code",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "publisher": "OpenForgeProject",
   "license": "GPL-3.0",
   "engines": {
@@ -114,18 +114,18 @@
     "url": "https://github.com/OpenForgeProject/vscode-ddev-phpstan"
   },
   "scripts": {
-    "compile": "esbuild src/extension.ts --bundle --outfile=dist/extension.js --external:vscode --format=cjs --platform=node",
-    "compile-tests": "esbuild src/test/*.test.ts --bundle --outdir=dist/test --external:vscode --external:mocha --format=cjs --platform=node",
-    "watch": "npm run compile -- --watch",
-    "package": "npm run compile -- --minify",
+    "compile": "tsx esbuild.ts",
+    "compile-tests": "tsx esbuild.ts",
+    "watch": "tsx esbuild.ts --watch",
+    "package": "tsx esbuild.ts --production",
     "vscode:prepublish": "npm run package",
     "test": "npm run compile-tests && vscode-test",
     "lint": "eslint src --ext ts"
   },
   "devDependencies": {
-    "@types/vscode": "^1.100.0",
-    "@types/node": "^24.x",
     "@types/mocha": "^10.0.9",
+    "@types/node": "^24.x",
+    "@types/vscode": "^1.100.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "@vscode/test-cli": "^0.0.11",
@@ -136,6 +136,7 @@
     "mocha": "^11.7.3",
     "ovsx": "^0.9.0",
     "sinon": "^21.0.0",
+    "tsx": "^4.20.6",
     "typescript": "^5.6.3"
   }
 }