@d1g1tal/tsbuild 1.4.1 → 1.6.0

package/README.md

@@ -8,7 +8,7 @@
 [![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/)
 
-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 20.16.0+.
+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+.
 
 TC39 standard decorators are supported natively — no additional dependencies needed. SWC is only required if you are still using `experimentalDecorators` with `emitDecoratorMetadata`.
 
@@ -42,6 +42,46 @@ The build runs in two phases:
 
 If `declaration` is not enabled, phase 2 is just the esbuild step.
 
+## Installation
+
+### Global Installation (Recommended for CLI usage)
+
+Installing globally makes the `tsbuild` command available in your terminal across all projects:
+
+```bash
+# pnpm
+pnpm add -g @d1g1tal/tsbuild
+
+# npm
+npm install -g @d1g1tal/tsbuild
+```
+
+With a global install, your projects can use `tsbuild` in `package.json` scripts without adding it as a dependency.
+
+### Local Installation (Per-project)
+
+Install as a dev dependency for per-project version pinning (recommended for CI/CD environments):
+
+```bash
+# pnpm
+pnpm add -D @d1g1tal/tsbuild
+
+# npm
+npm install -D @d1g1tal/tsbuild
+
+# yarn
+yarn add -D @d1g1tal/tsbuild
+```
+
+`@swc/core` is **not a dependency** and will never be installed automatically. It is only needed if you use `experimentalDecorators` with `emitDecoratorMetadata` — see [Decorator Metadata](#decorator-metadata) for details.
+
+> **Note:** When installed only as a local dev dependency, the `tsbuild` command is not available directly in your terminal. Use it through `package.json` scripts (e.g., `pnpm build`) or invoke it explicitly with `pnpm exec tsbuild` / `npx tsbuild`.
+
+### Requirements
+
+- **Node.js**: >=22.0.0
+- **pnpm**: >=10.13.0 (if using corepack)
+
 ## Quick Start
 
 The only thing tsbuild requires in `tsconfig.json` is an `outDir`. Everything else carries over from your existing config.
@@ -141,47 +181,7 @@ Or if installed locally as a dev dependency, add a script to `package.json` and
 pnpm build
 ```
 
-That's it. tsbuild reads your `compilerOptions`, infers entry points from your `package.json`, and builds. See [Configuration Options](#configuration-options) for everything you can customise.
-
-## Installation
-
-### Global Installation (Recommended for CLI usage)
-
-Installing globally makes the `tsbuild` command available in your terminal across all projects:
-
-```bash
-# pnpm
-pnpm add -g @d1g1tal/tsbuild
-
-# npm
-npm install -g @d1g1tal/tsbuild
-```
-
-With a global install, your projects can use `tsbuild` in `package.json` scripts without adding it as a dependency.
-
-### Local Installation (Per-project)
-
-Install as a dev dependency for per-project version pinning (recommended for CI/CD environments):
-
-```bash
-# pnpm
-pnpm add -D @d1g1tal/tsbuild
-
-# npm
-npm install -D @d1g1tal/tsbuild
-
-# yarn
-yarn add -D @d1g1tal/tsbuild
-```
-
-`@swc/core` is **not a dependency** and will never be installed automatically. It is only needed if you use `experimentalDecorators` with `emitDecoratorMetadata` — see [Decorator Metadata](#decorator-metadata) for details.
-
-> **Note:** When installed only as a local dev dependency, the `tsbuild` command is not available directly in your terminal. Use it through `package.json` scripts (e.g., `pnpm build`) or invoke it explicitly with `pnpm exec tsbuild` / `npx tsbuild`.
-
-### Requirements
-
-- **Node.js**: >=20.16.0
-- **pnpm**: >=9.0.0
+That's it. tsbuild reads your `compilerOptions`, infers entry points from your `package.json`, and builds. See [Configuration Options](#configuration-options) for everything you can customize.
 
 ## Usage
 
@@ -191,7 +191,7 @@ yarn add -D @d1g1tal/tsbuild
 
 Because tsbuild uses the TypeScript compiler API directly, it reads your `compilerOptions` automatically. There is no need to re-declare `target`, `module`, `lib`, `strict`, `paths`, `moduleResolution`, `baseUrl`, or any other TypeScript settings in a separate config — they are already in your `tsconfig.json`, and tsbuild honours them as-is.
 
-The `tsbuild` section only covers options that don't belong in `compilerOptions`: bundling behaviour, entry points, watch mode, output formatting, and similar build-specific settings.
+The `tsbuild` section only covers options that don't belong in `compilerOptions`: bundling behavior, entry points, watch mode, output formatting, and similar build-specific settings.
 
 This means your type-checker and your build always use the exact same TypeScript configuration — no drift, no duplication.
 
@@ -202,7 +202,7 @@ Declaration generation is **not required**. If `declaration: true` is already se
 
 Everything else carries over automatically.
 
-Add a `tsbuild` property to your `tsconfig.json` with only the options you need to customise:
+Add a `tsbuild` property to your `tsconfig.json` with only the options you need to customize:
 
 ```jsonc
 {
@@ -284,17 +284,17 @@ tsbuild uses two separate caches to speed up repeated builds, and two flags to c
 
 ### How it works
 
-Enable incremental compilation in `tsconfig.json`:
+Incremental compilation is **enabled by default** — no configuration needed. To opt out, explicitly set `incremental: false` in `tsconfig.json`:
 
 ```jsonc
 {
   "compilerOptions": {
-    "incremental": true
+    "incremental": false  // disables TypeScript's .tsbuildinfo cache and tsbuild's DTS cache
   }
 }
 ```
 
-With this set, each build maintains two caches inside a `.tsbuild/` directory:
+With incremental enabled, each build maintains two caches inside a `.tsbuild/` directory:
 
 | Cache | File | What it stores |
 |-------|------|----------------|
@@ -303,6 +303,20 @@ With this set, each build maintains two caches inside a `.tsbuild/` directory:
 
 On each build, TypeScript reads `.tsbuildinfo` to determine what changed and only re-emits those files. Changed `.d.ts` files overwrite their entries in the DTS cache; unchanged entries remain valid. If nothing changed, TypeScript skips emission entirely and the output phase is skipped too — this is why incremental rebuilds with no changes take ~5ms.
 
+### Ignoring the cache directory
+
+The `.tsbuild/` directory contains build artifacts that should not be committed to source control. Add it to your `.gitignore`:
+
+```bash
+echo '.tsbuild/' >> .gitignore
+```
+
+Or add the entry manually:
+
+```gitignore
+.tsbuild/
+```
+
 ### Flags
 
 **`--force` (`-f`)** — Runs the output phase (esbuild + DTS bundling) even when TypeScript detects no changes. Useful when something outside the source files changed (e.g. an environment variable or esbuild config) and you need to regenerate output without touching the caches.
@@ -336,7 +350,7 @@ If a directory is provided, all files within will be used as entry points.
 
 When `entryPoints` is omitted entirely, tsbuild automatically infers entry points from `package.json` by reverse-mapping output paths back to their source files. Resolution order:
 
-1. **`exports`** - Subpath export map (wildcard patterns are skipped; `import`/`default` conditions are tried in order)
+1. **`exports`** - Subpath export map (wildcard patterns are skipped; `import`, `node`, `module`, and `default` conditions are tried in order)
 2. **`bin`** - Binary entry points
 3. **`main`** / **`module`** - Legacy fallback (only used when `exports` and `bin` produce no results)
 
@@ -510,7 +524,7 @@ When a circular dependency is detected between declaration files, tsbuild emits
 
 tsbuild is designed for speed:
 
-- **Incremental builds** - Only recompiles changed files
+- **Incremental builds** - Only recompile changed files
 - **In-memory declarations** - No intermediate disk I/O for `.d.ts` files
 - **Parallel processing** - Declaration bundling and transpilation run in parallel after type checking completes
 - **Smart caching** - Leverages `.tsbuildinfo` for TypeScript incremental compilation
@@ -535,12 +549,12 @@ The TypeScript declaration bundling system was originally inspired by rollup-plu
 - **[TypeScript](https://www.typescriptlang.org/)** - Type checking, declaration generation, and module resolution
 - **[SWC](https://swc.rs/)** - Optional decorator metadata transformation
 - **[magic-string](https://github.com/Rich-Harris/magic-string)** - Efficient source code transformation with sourcemap support
-- **[watchr](https://github.com/bevry/watchr)** - File watching for watch mode
+- **[watchr](https://github.com/D1g1talEntr0py/watchr)** - File watching for watch mode
 
 ## Limitations
 
 - **ESM Only** - No CommonJS support by design
-- **Node.js 20.16.0+** - Requires a modern Node.js version
+- **Node.js 22+** - Requires a modern Node.js version
 - **Personal project** - Works well for my use cases, but hasn't been tested across every environment or edge case
 - **Plugins are programmatic only** - Custom esbuild plugins can't be declared in `tsconfig.json`; they require using the `TypeScriptProject` API directly
 - **tsBuildInfoFile Path Changes** - When changing the `tsBuildInfoFile` path in `tsconfig.json`, the old `.tsbuildinfo` file at the previous location will not be automatically cleaned up and must be manually removed

package/dist/{TY4W6KLM.js → Q7VGDC7X.js}

@@ -318,10 +318,12 @@ var Logger = class _Logger {
   }
   /**
    * Logs a header box with a message.
+   * The header is styled with a cyan border and the message is centered inside. ANSI escape codes are stripped from the message when calculating the width to ensure proper formatting.
+   * This ensures the header box is sized correctly even when the message contains color codes or other formatting.
    * @param message The message to display in the header.
    */
   static header(message) {
-    const innerWidth = message.length + 2;
+    const innerWidth = message.replace(new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g"), "").length + 2;
     console.log(TextFormat.cyan(`\u256D${"\u2500".repeat(innerWidth)}\u256E${newLine}\u2502 ${message} \u2502${newLine}\u2570${"\u2500".repeat(innerWidth)}\u256F`));
   }
   /**
@@ -345,10 +347,14 @@ var Logger = class _Logger {
    * @param steps The sub-steps to log.
    */
   static subSteps(steps) {
-    const maxNameLength = steps.reduce((max, { name }) => Math.max(max, name.length), 0);
-    const maxDurationLength = steps.reduce((max, { duration }) => Math.max(max, duration.length), 0);
-    for (let i = 0, length = steps.length; i < length; i++) {
-      const { name, duration } = steps[i];
+    const visible = steps.filter(({ ms }) => ms >= 5);
+    if (visible.length === 0) {
+      return;
+    }
+    const maxNameLength = visible.reduce((max, { name }) => Math.max(max, name.length), 0);
+    const maxDurationLength = visible.reduce((max, { duration }) => Math.max(max, duration.length), 0);
+    for (let i = 0, length = visible.length; i < length; i++) {
+      const { name, duration } = visible[i];
       const prefix = i === length - 1 ? "  \u2514\u2500" : "  \u251C\u2500";
       console.log(`${TextFormat.dim(prefix)} ${TextFormat.bold(name.padEnd(maxNameLength))} ${TextFormat.cyan(duration.padStart(maxDurationLength))}`);
     }
@@ -1595,8 +1601,8 @@ _PerformanceLogger = __decorateElement(_init, 0, "PerformanceLogger", _Performan
 __runInitializers(_init, 1, _PerformanceLogger);
 var PerformanceLogger = _PerformanceLogger;
 var measure = new PerformanceLogger().measure;
-function addPerformanceStep(name, duration) {
-  pendingSteps.push({ name, duration });
+function addPerformanceStep(name, ms) {
+  pendingSteps.push({ name, duration: `${ms}ms`, ms });
 }
 
 // src/decorators/debounce.ts
@@ -1831,9 +1837,9 @@ var FileManager = class {
       this.pendingBuildInfo = { path: filePath, text };
     } else {
       this.pendingFiles.push({ path: filePath, text });
-    }
-    if (!this.hasEmittedFiles) {
-      this.hasEmittedFiles = true;
+      if (!this.hasEmittedFiles) {
+        this.hasEmittedFiles = true;
+      }
     }
   };
   /**
@@ -2059,7 +2065,7 @@ var globCharacters = /[*?\\[\]!].*$/;
 var domPredicate = (lib) => lib.toUpperCase() === "DOM";
 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("Process Declarations", true)], _triggerRebuild_dec = [debounce(100)];
+_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)];
 var _TypeScriptProject = class _TypeScriptProject {
   /**
    * Creates a TypeScript project and prepares it for building/bundling.
@@ -2098,7 +2104,8 @@ var _TypeScriptProject = class _TypeScriptProject {
     return Files.empty(this.buildConfiguration.outDir);
   }
   async build() {
-    Logger.header(`\u{1F680} tsbuild v${"1.4.1"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
+    const tsLogo = TextFormat.bgBlue(TextFormat.bold(TextFormat.whiteBright(" TS ")));
+    Logger.header(`${tsLogo} tsbuild v${"1.6.0"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const filesWereEmitted = await this.typeCheck();
@@ -2148,7 +2155,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     performance2.mark("finalize:start");
     const result = this.fileManager.finalize();
     addPerformanceStep("Finalize", _TypeScriptProject.elapsed("finalize:start"));
-    return result;
+    return result || !this.configuration.compilerOptions.declaration;
   }
   async transpile() {
     const plugins = [outputPlugin()];
@@ -2364,7 +2371,9 @@ var _TypeScriptProject = class _TypeScriptProject {
       compilerOptions: {
         ...{ outDir: defaultOutDirectory, noEmit: false, sourceMap: false, incremental: true, tsBuildInfoFile: Paths.join(cacheDirectory, buildInfoFile), lib: [] },
         ...configResult.config.compilerOptions,
-        ...typeScriptOptions.compilerOptions
+        ...typeScriptOptions.compilerOptions,
+        // Always include 'node' and merge with any user-specified types
+        types: [.../* @__PURE__ */ new Set(["node", ...configResult.config.compilerOptions?.types ?? [], ...typeScriptOptions.compilerOptions?.types ?? []])]
       }
     };
     const { options, fileNames, errors } = parseJsonConfigFileContent(baseConfig, sys2, directory);
@@ -2482,14 +2491,14 @@ var _TypeScriptProject = class _TypeScriptProject {
   /**
    * Calculates elapsed time since a performance mark and clears the mark.
    * @param markName - The name of the performance mark to measure from
-   * @returns Formatted elapsed time string (e.g., '42ms')
+   * @returns Elapsed time in milliseconds
    */
   static elapsed(markName) {
     const endMark = performance2.mark(`${markName}:end`);
-    const duration = endMark.startTime - performance2.getEntriesByName(markName, "mark")[0].startTime;
+    const ms = ~~(endMark.startTime - performance2.getEntriesByName(markName, "mark")[0].startTime);
     performance2.clearMarks(markName);
     performance2.clearMarks(endMark.name);
-    return `${~~duration}ms`;
+    return ms;
   }
 };
 _init3 = __decoratorStart(null);

package/dist/index.d.ts

@@ -44,6 +44,7 @@ type ClosableConstructor = Constructor<any[], Closable>;
 type PerformanceSubStep = {
     name: string;
     duration: string;
+    ms: number;
 };
 type PerformanceEntryDetail<T = unknown[]> = {
     message: string;
@@ -351,7 +352,7 @@ declare class TypeScriptProject implements Closable {
     /**
      * Calculates elapsed time since a performance mark and clears the mark.
      * @param markName - The name of the performance mark to measure from
-     * @returns Formatted elapsed time string (e.g., '42ms')
+     * @returns Elapsed time in milliseconds
      */
     private static elapsed;
 }

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   TypeScriptProject
-} from "./TY4W6KLM.js";
+} from "./Q7VGDC7X.js";
 import "./7FPDHUPW.js";
 export {
   TypeScriptProject

package/dist/tsbuild.js

@@ -2,7 +2,7 @@
 import {
   BuildError,
   TypeScriptProject
-} from "./TY4W6KLM.js";
+} from "./Q7VGDC7X.js";
 import "./7FPDHUPW.js";
 
 // src/tsbuild.ts
@@ -30,7 +30,7 @@ if (help) {
   process.exit(0);
 }
 if (version) {
-  console.log("1.4.1");
+  console.log("1.6.0");
   process.exit(0);
 }
 var typeScriptOptions = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/tsbuild",
   "author": "D1g1talEntr0py",
-  "version": "1.4.1",
+  "version": "1.6.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",
@@ -19,7 +19,7 @@
     }
   ],
   "engines": {
-    "node": ">=20.16.0"
+    "node": ">=22.0.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -42,24 +42,24 @@
     "tsbuild": "./dist/tsbuild.js"
   },
   "dependencies": {
-    "@d1g1tal/watchr": "1.0.0",
-    "esbuild": "^0.27.3",
+    "@d1g1tal/watchr": "^1.0.3",
+    "esbuild": "^0.27.4",
     "magic-string": "^0.30.21"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.3.5",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
-    "@vitest/coverage-v8": "4.0.18",
+    "@types/node": "^25.4.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "@vitest/coverage-v8": "^4.1.0",
     "eslint": "^10.0.3",
-    "eslint-plugin-jsdoc": "^62.7.1",
+    "eslint-plugin-jsdoc": "^62.8.0",
     "fs-monkey": "^1.1.0",
     "memfs": "^4.56.11",
     "tsx": "^4.21.0",
-    "typescript": "5.9.3",
-    "typescript-eslint": "^8.56.1",
-    "vitest": "^4.0.18"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.57.0",
+    "vitest": "^4.1.0"
   },
   "keywords": [
     "typescript",