@d1g1tal/tsbuild 1.6.5 → 1.7.0

package/CHANGELOG.md

@@ -1,3 +1,83 @@
+## [1.7.0](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.6.5...v1.7.0) (2026-03-27)
+
+### Features
+
+* **build:** add support for ES2025 ScriptTarget (2aecca9dc4ac67cd3e27021e34054a7c7552ebe9)
+- Add `ES2025` targeting map for TS `ScriptTarget.ES2025` so newly produced esbuild configurations will honor it.
+
+
+### Bug Fixes
+
+* **dts:** infer reference types for node protocols and correct module mapping (03c4ec5859b3741b7f30d590b38ea9c729128eea)
+- Add logic in the `DeclarationBundler` to automatically infer `/// <reference types="node" />` when `node:` protocol imports are merged in, so the generated `.d.ts` file remains self-contained.
+- Stop stripping inline `type` keywords from import statements in the `DeclarationProcessor`, preserving them for `.d.ts` output correctness.
+- Remove unused `inlineTypePattern` import due to removing the stripping logic.
+- Fix minor property initialization order formatting in `DeclarationBundler`.
+- Add testing specific to these fixes in `declaration-bundler.test.ts` and `declaration-processor.test.ts`.
+
+* **env:** support dynamic process.env extraction in config values (9469b5963d9ac5c1473bf500e96baa841b04b586)
+- Expand `process.env` references dynamically in ESBuild `define` objects to support runtime-bound values instead of just static strings.
+
+* **release:** manually update the workspace file since pnpm can't seem to get it right (8795a7497ab9cc26991001ef09145f8d92097841)
+
+### Code Refactoring
+
+* **core:** simplify promise handling in TypeScript build configuration (e7b154ad9cf38347bf93cb3a48301753cead58e0)
+- Remove intermediate `entryPointsPromise` variable and `.catch()` swallowing since rejection is natively handled when awaited later in the `build()` process.
+- Improve the `tsbuildOptions` setup.
+
+* **style:** remove explicit return types and clean up syntax (c306735aefb8ff4d4227f5bdaae21e7d0ed53f32)
+- Remove redundant explicit return types from internal utility functions across several files (`constants`, `decorators`, `dts`, `file-manager`, `files`, `json`, `logger`, `paths`, etc.).
+- Allow TypeScript to infer these return types automatically, reducing visual noise.
+- Simplify closures to arrow functions or shortened arrow syntax where applicable.
+
+
+### Documentation
+
+* **EADDRINUSE:** add issue draft for WSL2 network issue (5f5ea0d31f6df8e85a4e586c5f8018a56e5b2702)
+- Add a detailed bug report draft describing the `EADDRINUSE` issue that occurs on every single activation attempt when running under WSL2 with `networkingMode=Mirrored`.
+- Include a minimal reproduction case that demonstrates the underlying Node.js `net.createServer().listen()` race condition in WSL2 mirrored networking.
+- Provide expected behavior and output logs for the VS Code extension failure.
+- Suggest a direct bind and instance retention fix instead of the current close-and-reopen approach.
+
+* **README:** update isolatedModules and TS strict requirements (c4a491791b8ad9d90c909ce9a2f8d03e1aeb0521)
+- Update the minimum supported TypeScript badge to `>=5.6.3`.
+- Clarify that `isolatedModules` is strictly required due to the reliance on esbuild for transpilation.
+- Remove the `strict` option note for newer TS versions since it is enabled by default in TypeScript 6.0+.
+- Add an "Advanced Features" section explicitly explaining *why* `isolatedModules` is necessary for esbuild.
+
+
+### Miscellaneous Chores
+
+* **deps:** update package and lockfile dependencies (5a9f0623ffc63b42ddcdd7d2bc1882510f0a7d60)
+- Update various devDependencies, including `typescript` to `^6.0.2` and related `@typescript-eslint` packages.
+- Update `vitest` and coverage plugins to `^4.1.2`.
+- Remove `@babel/plugin-proposal-decorators` and `@rolldown/plugin-babel` and replace Babel decorator handling in vitest config with a custom `esbuild` transformer.
+- Add a `test:compat` script entry to test against 5 minor versions of TypeScript.
+- Specify a peer dependency requirement for `typescript: >=5.6.3`.
+- Modify `package.json` `types` field.
+- Refresh and resolve `pnpm-lock.yaml` according to the new dependency state.
+
+* **vscode:** set TS SDK path in settings (6e6622483d6648ba6cf283b362622665bd1dbede)
+- Configure `.vscode/settings.json` to use the workspace `node_modules/typescript/lib` for the TypeScript language server.
+
+
+### Tests
+
+* **compat:** introduce multi-version TypeScript testing script (3ad98b8cc914d6e7c37237713b11568e97ef1bbf)
+- Add a new compatibility test script `test-ts-compat.ts` that iterates through minor TypeScript versions dynamically.
+- Conditionally add support for testing `ES2024` and `ES2025` script targets only if the installed version of TS contains them.
+- Implement a comprehensive type-guard/API compatibility test in `typescript-compatibility.test.ts` to guarantee runtime API availability.
+- Update `tsconfig.json` for tests with required strict compatibility changes.
+
+
+### Continuous Integration
+
+* **github:** add workflow for testing TypeScript compatibility (0c9bbbf8301ad66c4321fa9878169d66bbb1eda7)
+- Create a new GitHub Actions workflow to run the test suite against multiple versions of TypeScript (5.6.3 to 6.0).
+- Ensure backwards compatibility of the tools when run with older minimal supported TypeScript versions.
+- Set up basic jobs utilizing `pnpm` and Node.js 24.
+
 ## [1.6.5](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.6.4...v1.6.5) (2026-03-21)
 
 ### Code Refactoring

package/README.md

@@ -6,7 +6,7 @@
 [![codecov](https://codecov.io/gh/D1g1talEntr0py/tsbuild/graph/badge.svg)](https://codecov.io/gh/D1g1talEntr0py/tsbuild)
 [![License: MIT](https://img.shields.io/github/license/D1g1talEntr0py/tsbuild)](https://github.com/D1g1talEntr0py/tsbuild/blob/main/LICENSE)
 [![Node.js](https://img.shields.io/node/v/@d1g1tal/tsbuild)](https://nodejs.org)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript->=5.6.3-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 
 A TypeScript build tool that combines three tools into one workflow: **TypeScript's type system** for correctness, **esbuild** for speed, and **SWC** for legacy decorator metadata (optional, not installed by default). Built for modern ESM-only projects on Node.js 22+.
 
@@ -125,8 +125,7 @@ By default, bare specifiers (e.g. `lodash-es`) are kept as external imports. Use
     "outDir": "./dist",
     "declaration": true,
     "incremental": true,           // redundant — tsbuild enables this by default, but explicit is clear
-    "isolatedDeclarations": true,  // recommended: enables faster parallel declaration emit
-    "isolatedModules": true,
+    "isolatedModules": true,       // required — flags constructs esbuild can't safely transpile
     "verbatimModuleSyntax": true,
     "strict": true,
     "target": "ESNext",
@@ -149,11 +148,10 @@ Set `incremental: false` to opt out of the `.tsbuildinfo` cache entirely. Every
   "compilerOptions": {
     "outDir": "./dist",
     "declaration": true,
-    "incremental": false,          // disables TypeScript's .tsbuildinfo cache and tsbuild's DTS cache
-    "isolatedDeclarations": true,
-    "isolatedModules": true,
+    "incremental": false,          	// disables TypeScript's .tsbuildinfo cache and tsbuild's DTS cache
+    "isolatedModules": true,				// required — flags constructs esbuild can't safely transpile
     "verbatimModuleSyntax": true,
-    "strict": true,
+    "strict": true,									// Not needed with TypeScript 6 and above, since strict mode is enabled by default
     "target": "ESNext",
     "module": "ESNext",
     "moduleResolution": "Bundler", // recommended for library builds processed by a bundler
@@ -429,6 +427,24 @@ By default, bare specifiers (e.g., `lodash`) are treated as external when `platf
 
 ## Advanced Features
 
+### Isolated Modules
+
+Because tsbuild uses esbuild for transpilation, and esbuild processes each file independently without a full type graph, you should set `isolatedModules: true` in your `tsconfig.json`:
+
+```jsonc
+{
+  "compilerOptions": {
+    "isolatedModules": true
+  }
+}
+```
+
+This tells TypeScript to flag any construct that requires cross-file knowledge to transpile correctly — things like `const enum`, ambient module augmentation, or re-exporting a type without the `type` keyword. Without this, esbuild may encounter one of these patterns and silently emit incorrect code, since it has no way to identify the problem at transpile time.
+
+With `isolatedModules: true`, TypeScript catches these issues during the type-check phase, before esbuild runs, so you get a clear error instead of a subtle runtime bug.
+
+**`verbatimModuleSyntax` implies `isolatedModules`:** If you have `verbatimModuleSyntax: true` in your config, it already enforces all of `isolatedModules` and goes further by requiring `import type` for all type-only imports. If you're using `verbatimModuleSyntax`, adding `isolatedModules` is redundant but harmless.
+
 ### Decorator Metadata
 
 #### TC39 Standard Decorators (recommended)

package/dist/{GQLOAEUW.js → GNBUFD72.js}

@@ -3,7 +3,7 @@ import {
   Json,
   Paths,
   typeScriptExtensionExpression
-} from "./7FPDHUPW.js";
+} from "./YC2FB45E.js";
 
 // src/plugins/decorator-metadata.ts
 import { dirname } from "node:path";

package/dist/{SFYLP6W7.js → QNWF5BZL.js}

@@ -22,14 +22,13 @@ import {
   dtsCacheFile,
   dtsCacheVersion,
   format,
-  inlineTypePattern,
   newLine,
   processEnvExpansionPattern,
   sourceScriptExtensionExpression,
   toEsTarget,
   toJsxRenderingMode,
   typeMatcher
-} from "./7FPDHUPW.js";
+} from "./YC2FB45E.js";
 
 // src/errors.ts
 import { SyntaxKind } from "typescript";
@@ -614,29 +613,7 @@ var DeclarationProcessor = class _DeclarationProcessor {
       return length;
     }
     for (const node of sourceFile.statements) {
-      if (isImportDeclaration(node)) {
-        if (node.importClause?.phaseModifier === SyntaxKind2.TypeKeyword) {
-          const importKeywordEnd = node.getStart() + "import".length;
-          const typeMatch = code.slice(importKeywordEnd, node.getEnd()).match(typeMatcher);
-          if (typeMatch?.index !== void 0) {
-            const typeKeywordStart = importKeywordEnd + typeMatch.index;
-            const typeKeywordEnd = typeKeywordStart + "type".length;
-            code.remove(typeKeywordStart, typeKeywordEnd + getTrailingWhitespaceLength(typeKeywordEnd, node.getEnd()));
-          }
-        } else {
-          inlineTypePattern.lastIndex = 0;
-          let match;
-          const replacements = [];
-          while ((match = inlineTypePattern.exec(code.slice(node.getStart(), node.getEnd()))) !== null) {
-            const typeKeywordStart = node.getStart() + match.index + match[1].length;
-            const typeKeywordEnd = typeKeywordStart + "type".length;
-            replacements.push({ start: typeKeywordStart, end: typeKeywordEnd + getTrailingWhitespaceLength(typeKeywordEnd, node.getEnd()) });
-          }
-          for (let i = replacements.length - 1; i >= 0; i--) {
-            code.remove(replacements[i].start, replacements[i].end);
-          }
-        }
-      } else if (isExportDeclaration(node)) {
+      if (isExportDeclaration(node)) {
         if (node.exportClause && isNamedExports(node.exportClause) && node.exportClause.elements.length === 0 && !node.moduleSpecifier) {
           code.remove(getStart(node), getEnd(node));
         } else if (node.isTypeOnly) {
@@ -1295,9 +1272,15 @@ var DeclarationBundler = class {
         codeBlocks.push(strippedCode.trim());
       }
     }
-    const uniqueTypeReferences = [...new Set(allTypeReferences)];
+    const typeReferencesSet = new Set(allTypeReferences);
     const uniqueFileReferences = [...new Set(allFileReferences)];
     const mergedExternalImports = mergeImports(allExternalImports);
+    for (const imp of mergedExternalImports) {
+      if (imp.includes('"node:') || imp.includes("'node:")) {
+        typeReferencesSet.add("node");
+      }
+    }
+    const uniqueTypeReferences = [...typeReferencesSet];
     const finalValueExports = [...new Set(allValueExports)];
     const finalValueExportsSet = new Set(finalValueExports);
     const finalTypeExports = [...new Set(allTypeExports.filter((typeExport) => !finalValueExportsSet.has(typeExport)))];
@@ -2100,6 +2083,7 @@ import { performance as performance2 } from "node:perf_hooks";
 import { sys as sys2, createIncrementalProgram, formatDiagnostics, formatDiagnosticsWithColorAndContext, parseJsonConfigFileContent, readConfigFile, findConfigFile } from "typescript";
 var globCharacters = /[*?\\[\]!].*$/;
 var domPredicate = (lib) => lib.toUpperCase() === "DOM";
+var tsLogo = TextFormat.bgBlue(TextFormat.bold(TextFormat.whiteBright(" TS ")));
 var diagnosticsHost = { getNewLine: () => sys2.newLine, getCurrentDirectory: sys2.getCurrentDirectory, getCanonicalFileName: (fileName) => fileName };
 var _triggerRebuild_dec, _processDeclarations_dec, _transpile_dec, _typeCheck_dec, _build_dec, _TypeScriptProject_decorators, _init3;
 _TypeScriptProject_decorators = [closeOnExit], _build_dec = [measure("Build")], _typeCheck_dec = [measure("Type-checking")], _transpile_dec = [measure("Transpile", true)], _processDeclarations_dec = [measure("Bundle Declarations", true)], _triggerRebuild_dec = [debounce(100)];
@@ -2128,10 +2112,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     }
     this.fileManager = new FileManager(buildCache);
     this.builderProgram = createIncrementalProgram({ rootNames, options: this.configuration.compilerOptions, projectReferences, configFileParsingDiagnostics });
-    const entryPointsPromise = this.getEntryPoints(entryPoints);
-    entryPointsPromise.catch(() => {
-    });
-    this.buildConfiguration = { entryPoints: entryPointsPromise, target: toEsTarget(target), outDir, ...tsbuildOptions };
+    this.buildConfiguration = { entryPoints: this.getEntryPoints(entryPoints), target: toEsTarget(target), outDir, ...tsbuildOptions };
   }
   /**
    * Cleans the output directory
@@ -2141,8 +2122,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     return Files.empty(this.buildConfiguration.outDir);
   }
   async build() {
-    const tsLogo = TextFormat.bgBlue(TextFormat.bold(TextFormat.whiteBright(" TS ")));
-    Logger.header(`${tsLogo} tsbuild v${"1.6.5"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
+    Logger.header(`${tsLogo} tsbuild v${"1.7.0"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const filesWereEmitted = await this.typeCheck();
@@ -2201,7 +2181,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     }
     if (this.configuration.compilerOptions.emitDecoratorMetadata) {
       try {
-        const { swcDecoratorMetadataPlugin } = await import("./GQLOAEUW.js");
+        const { swcDecoratorMetadataPlugin } = await import("./GNBUFD72.js");
         plugins.push(swcDecoratorMetadataPlugin);
       } catch {
         throw new ConfigurationError("emitDecoratorMetadata is enabled but @swc/core is not installed. Install it with: pnpm add -D @swc/core");
@@ -2533,10 +2513,10 @@ var _TypeScriptProject = class _TypeScriptProject {
    * @returns Elapsed time in milliseconds
    */
   static elapsed(markName) {
-    const endMark = performance2.mark(`${markName}:end`);
-    const ms = ~~(endMark.startTime - performance2.getEntriesByName(markName, "mark")[0].startTime);
+    const { name, startTime } = performance2.mark(`${markName}:end`);
+    const ms = ~~(startTime - performance2.getEntriesByName(markName, "mark")[0].startTime);
     performance2.clearMarks(markName);
-    performance2.clearMarks(endMark.name);
+    performance2.clearMarks(name);
     return ms;
   }
 };

package/dist/{7FPDHUPW.js → YC2FB45E.js}

@@ -81,6 +81,7 @@ var scriptTargetToEsTarget = {
   [ScriptTarget.ES2022]: "ES2022",
   [ScriptTarget.ES2023]: "ES2023",
   [ScriptTarget.ES2024]: "ES2024",
+  [ScriptTarget.ES2025]: "ES2025",
   [ScriptTarget.ESNext]: "ESNext",
   [ScriptTarget.JSON]: "ESNext"
 };
@@ -119,7 +120,6 @@ var typeMatcher = /\btype\b/;
 var sourceScriptExtensionExpression = /(?<!\.d)\.[jt]sx?$/;
 var typeScriptExtensionExpression = /(\.tsx?)$/;
 var processEnvExpansionPattern = /\$\{process\.env\.([^}]+)\}/g;
-var inlineTypePattern = /([{,]\s+)type\s+/g;
 
 // src/paths.ts
 import { lstat } from "node:fs/promises";
@@ -279,7 +279,6 @@ export {
   sourceScriptExtensionExpression,
   typeScriptExtensionExpression,
   processEnvExpansionPattern,
-  inlineTypePattern,
   Paths,
   Json
 };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-import { Plugin, TsconfigRaw } from "esbuild";
-import { FileSystemEvent, WatchrOptions } from "@d1g1tal/watchr";
-import { CompilerOptions, Diagnostic, ProjectReference, ScriptTarget } from "typescript";
-import { PerformanceEntry, PerformanceMeasureOptions } from "node:perf_hooks";
+/// <reference types="node" />
+
+import type { Plugin, TsconfigRaw } from "esbuild";
+import type { FileSystemEvent, WatchrOptions } from "@d1g1tal/watchr";
+import type { CompilerOptions, Diagnostic, ProjectReference, ScriptTarget } from "typescript";
+import type { PerformanceEntry, PerformanceMeasureOptions } from "node:perf_hooks";
 
 declare global {
     interface ImportMeta {

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   TypeScriptProject
-} from "./SFYLP6W7.js";
-import "./7FPDHUPW.js";
+} from "./QNWF5BZL.js";
+import "./YC2FB45E.js";
 export {
   TypeScriptProject
 };

package/dist/tsbuild.js

@@ -2,8 +2,8 @@
 import {
   BuildError,
   TypeScriptProject
-} from "./SFYLP6W7.js";
-import "./7FPDHUPW.js";
+} from "./QNWF5BZL.js";
+import "./YC2FB45E.js";
 
 // src/tsbuild.ts
 import { sys } from "typescript";
@@ -30,7 +30,7 @@ if (help) {
   process.exit(0);
 }
 if (version) {
-  console.log("1.6.5");
+  console.log("1.7.0");
   process.exit(0);
 }
 var typeScriptOptions = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/tsbuild",
   "author": "D1g1talEntr0py",
-  "version": "1.6.5",
+  "version": "1.7.0",
   "license": "MIT",
   "description": "A fast, ESM-only TypeScript build tool combining the TypeScript API for type checking and declaration generation, esbuild for bundling, and SWC for decorator metadata.",
   "homepage": "https://github.com/D1g1talEntr0py/tsbuild#readme",
@@ -26,6 +26,7 @@
     "access": "public"
   },
   "type": "module",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -43,26 +44,27 @@
     "tsbuild": "./dist/tsbuild.js"
   },
   "dependencies": {
-    "@d1g1tal/watchr": "^1.0.4",
+    "@d1g1tal/watchr": "^1.0.5",
     "esbuild": "^0.27.4",
     "magic-string": "^0.30.21"
   },
   "devDependencies": {
-    "@babel/plugin-proposal-decorators": "^7.29.0",
     "@eslint/js": "^10.0.1",
-    "@rolldown/plugin-babel": "^0.2.2",
     "@types/node": "^25.5.0",
-    "@typescript-eslint/eslint-plugin": "^8.57.1",
-    "@typescript-eslint/parser": "^8.57.1",
-    "@vitest/coverage-v8": "^4.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
+    "@vitest/coverage-v8": "^4.1.2",
     "eslint": "^10.1.0",
-    "eslint-plugin-jsdoc": "^62.8.0",
+    "eslint-plugin-jsdoc": "^62.8.1",
     "fs-monkey": "^1.1.0",
-    "memfs": "^4.56.11",
+    "memfs": "^4.57.1",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.1",
-    "vitest": "^4.1.0"
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.57.2",
+    "vitest": "^4.1.2"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.6.3"
   },
   "keywords": [
     "typescript",
@@ -83,6 +85,7 @@
     "lint": "eslint ./src",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:compat": "tsx tests/scripts/test-ts-compat.ts --versions 5"
   }
 }