@d1g1tal/tsbuild 1.2.3 → 1.3.0

package/README.md

@@ -8,9 +8,11 @@
 [![Node.js](https://img.shields.io/node/v/%40d1g1tal/tsbuild)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 
-A self-hosting TypeScript build tool that combines the best of three worlds: **TypeScript's type system**, **esbuild's speed**, and **SWC's decorator metadata support**. tsbuild is designed for modern ESM-only projects targeting 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 20.16.0+.
 
-> **⚠️ Note:** This is an experimental project for personal use. For production use, consider [tsup](https://tsup.egoist.dev/) instead, which is mature, battle-tested, and widely adopted. Or check out the new [tsdown](https://tsdown.dev/) by [void(0)](https://voidzero.dev/).
+TC39 standard decorators are supported natively — no additional dependencies needed. SWC is only required if you are still using `experimentalDecorators` with `emitDecoratorMetadata`.
+
+> **Note:** This is a personal project I built for my own use and decided to share. It works well for me, but it's not battle-hardened for every setup. If you need something production-proven, [tsup](https://tsup.egoist.dev/) is excellent, or take a look at the newer [tsdown](https://tsdown.dev/) by [void(0)](https://voidzero.dev/).
 
 ## Features
 
@@ -19,7 +21,8 @@ A self-hosting TypeScript build tool that combines the best of three worlds: **T
 - 📦 **Declaration Bundling** - Automatically bundles `.d.ts` files into single entry points
 - ⚡ **Incremental Builds** - Intelligent caching with `.tsbuildinfo` for fast rebuilds
 - 👁️ **Watch Mode** - File watching with automatic rebuilds on changes
-- 🎨 **Decorator Metadata** - Optional SWC integration for `emitDecoratorMetadata` support for legacy decorators (Will probably be removed at some point in favor of native ESM decorators only)
+- 🎨 **TC39 Decorators** - Native support for standard decorators, no extra dependencies required
+- 🔧 **Legacy Decorator Metadata** - Optional SWC integration for `emitDecoratorMetadata` when using `experimentalDecorators` (install `@swc/core` separately)
 - 🔌 **Plugin System** - Extensible architecture with custom esbuild plugins
 - 🎯 **ESM-Only** - Pure ESM project with no CommonJS support by design
 - 🧹 **Clean Builds** - Optional output directory cleaning before builds
@@ -28,13 +31,48 @@ A self-hosting TypeScript build tool that combines the best of three worlds: **T
 
 ## Why tsbuild?
 
-tsbuild orchestrates a sophisticated three-phase build process:
+Most TypeScript build setups involve a compromise: use `tsc` alone and lose bundling speed, or use esbuild/swc alone and lose accurate type checking and declaration generation. tsbuild aims to give you both by running each tool for what it's actually good at.
+
+The build runs in two phases:
+
+1. **Type Checking** - TypeScript validates types and, if `declaration` is enabled, captures `.d.ts` files into memory (no disk I/O)
+2. **Output** - Once type checking completes, two things happen in parallel:
+   - esbuild transpiles and bundles the JavaScript
+   - If declarations were captured in phase 1, a custom bundler consolidates the `.d.ts` files into final entry points
+
+If `declaration` is not enabled, phase 2 is just the esbuild step.
+
+## Quick Start
+
+The only thing tsbuild requires in `tsconfig.json` is an `outDir`. Everything else carries over from your existing config:
+
+```jsonc
+{
+  "compilerOptions": {
+    "outDir": "./dist"
+    // ... your existing TypeScript config
+  },
+  "tsbuild": {} // entry points are inferred from package.json automatically
+}
+```
+
+Then, if tsbuild is installed globally:
+
+```bash
+tsbuild
+```
+
+Or if installed locally as a dev dependency, add a script to `package.json` and run it:
 
-1. **Type Checking Phase** - TypeScript compiler validates types and emits `.d.ts` files into memory (not disk)
-2. **Transpile Phase** - esbuild bundles JavaScript with custom plugins for module resolution and output formatting
-3. **DTS Bundle Phase** - Custom minimal bundler combines declaration files through dependency graph traversal and AST transformation
+```json
+{ "scripts": { "build": "tsbuild" } }
+```
 
-This separation of concerns ensures TypeScript handles correctness, esbuild handles speed, and the custom bundler handles declaration consolidation efficiently without creating duplicate TypeScript Programs.
+```bash
+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
 
@@ -57,10 +95,7 @@ With a global install, your projects can use `tsbuild` in `package.json` scripts
 Install as a dev dependency for per-project version pinning (recommended for CI/CD environments):
 
 ```bash
-# pnpm - no SWC dependency (Optional. For legacy decorator metadata. Native ESM decorators are supported without SWC)
-pnpm add -D @d1g1tal/tsbuild --no-optional
-
-# pnpm - with SWC dependency (For legacy decorator metadata)
+# pnpm
 pnpm add -D @d1g1tal/tsbuild
 
 # npm
@@ -70,6 +105,8 @@ npm install -D @d1g1tal/tsbuild
 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
@@ -81,7 +118,22 @@ yarn add -D @d1g1tal/tsbuild
 
 ### Configuration
 
-Add a `tsbuild` property to your `tsconfig.json`:
+#### Your tsconfig.json Does the Heavy Lifting
+
+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.
+
+This means your type-checker and your build always use the exact same TypeScript configuration — no drift, no duplication.
+
+The only `compilerOptions` setting tsbuild requires:
+- **`outDir`** — determines where built files are written
+
+Declaration generation is **not required**. If `declaration: true` is already set in your `tsconfig.json`, tsbuild will automatically generate and bundle `.d.ts` files. If it's not set, tsbuild skips that step — no changes needed either way.
+
+Everything else carries over automatically.
+
+Add a `tsbuild` property to your `tsconfig.json` with only the options you need to customise:
 
 ```jsonc
 {
@@ -92,13 +144,13 @@ Add a `tsbuild` property to your `tsconfig.json`:
     "target": "ESNext",
     "module": "ESNext",
     "lib": [ "ESNext", "DOM" ],
-    "outDir": "./dist", // default value
+    "outDir": "./dist",
     // ... other TypeScript options
   },
   "tsbuild": {
     "clean": true, // Remove all files from output directory before building (default: true)
     "platform": "node", // Will default to "browser" if "DOM" is found in "lib", otherwise "node"
-    "entryPoints": {
+    "entryPoints": { // Optional - tsbuild can infer entry points from package.json if not provided
       "cli": "./src/cli.ts",
       "index": "./src/index.ts"
     },
@@ -111,6 +163,8 @@ Add a `tsbuild` property to your `tsconfig.json`:
 
 ### CLI Commands
 
+The examples below use the bare `tsbuild` command, which works when tsbuild is installed globally. If it's installed locally as a dev dependency, run these through `package.json` scripts (`pnpm build`, etc.) or prefix with `pnpm exec`/`npx` (e.g., `pnpm exec tsbuild --watch`).
+
 ```bash
 # Build once
 tsbuild
@@ -155,6 +209,39 @@ tsbuild --version  # or -v
 }
 ```
 
+## Incremental Builds
+
+tsbuild uses two separate caches to speed up repeated builds, and two flags to control them.
+
+### How it works
+
+Enable incremental compilation in `tsconfig.json`:
+
+```jsonc
+{
+  "compilerOptions": {
+    "incremental": true
+  }
+}
+```
+
+With this set, each build maintains two caches inside a `.tsbuild/` directory:
+
+| Cache | File | What it stores |
+|-------|------|----------------|
+| TypeScript | `.tsbuild/.tsbuildinfo` | Which source files changed and their type information |
+| DTS cache | `.tsbuild/dts_cache.v8.br` | Pre-processed declaration files (Brotli-compressed) |
+
+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.
+
+### 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.
+
+**`--clearCache` (`-c`)** — Deletes the entire `.tsbuild/` directory before building, wiping both `.tsbuildinfo` and the DTS cache. The next build runs as if it's the first time. Use this when you suspect the cache is stale or after significant config changes.
+
+**Normal build (no flags)** — TypeScript compares source file hashes against `.tsbuildinfo`, re-emits only what changed, and the DTS cache is updated accordingly.
+
 ## Configuration Options
 
 tsbuild supports a comprehensive set of options (full schema available in [`schema.json`](./schema.json)):
@@ -255,29 +342,46 @@ By default, bare specifiers (e.g., `lodash`) are treated as external when `platf
 }
 ```
 
-**Note:** The `target` and `outDir` options come from `tsconfig.json` `compilerOptions` and cannot be overridden in the `tsbuild` section. The `force` and `minify` options are typically better controlled via CLI flags (`--force`, `--minify`) rather than in the config.
+**Note:** All `compilerOptions` (including `target`, `outDir`, `module`, `strict`, `paths`, etc.) come from `tsconfig.json` and are not duplicated in the `tsbuild` section. The `force` and `minify` options are generally more useful as CLI flags (`--force`, `--minify`) than as persistent config values.
 
 ## Advanced Features
 
 ### Decorator Metadata
 
-tsbuild supports `emitDecoratorMetadata` through SWC integration:
+#### TC39 Standard Decorators (recommended)
+
+Standard decorators work out of the box — just use them in your code. No configuration, no extra packages.
 
 ```jsonc
 {
   "compilerOptions": {
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true
+    "target": "ESNext"
+    // No experimentalDecorators needed
   }
 }
 ```
 
-You must have `@swc/core` installed (as an optional dependency) for this feature to work:
+#### Legacy Decorators with Metadata (`experimentalDecorators`)
+
+If you are using the older decorator proposal with `emitDecoratorMetadata`, tsbuild delegates the transform to SWC so that metadata is emitted correctly through the esbuild pipeline. This requires `@swc/core` to be installed manually — it is **not** included with tsbuild:
 
 ```bash
 pnpm add -D @swc/core
 ```
 
+Then enable the flags in `tsconfig.json`:
+
+```jsonc
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+tsbuild detects these flags automatically and uses SWC. If `@swc/core` is not installed when these flags are set, the build will fail with a clear message telling you to install it.
+
 ### Custom Plugins
 
 tsbuild supports custom esbuild plugins:
@@ -331,7 +435,7 @@ The declaration bundling system (`src/dts/declaration-bundler.ts`) is a custom i
 
 This custom bundler works entirely with in-memory declaration files, avoiding the overhead of duplicate TypeScript Program creation with some other bundlers.
 
-When a circular dependency is detected between declaration files, tsbuild emits a warning with the full cycle path (e.g., `a.d.ts -> b.d.ts -> a.d.ts`) rather than failing silently or crashing.
+When a circular dependency is detected between declaration files, tsbuild emits a warning with the full cycle path (e.g., `a.d.ts -> b.d.ts -> a.d.ts`) and continues rather than failing silently or crashing.
 
 ## Performance
 
@@ -339,7 +443,7 @@ tsbuild is designed for speed:
 
 - **Incremental builds** - Only recompiles changed files
 - **In-memory declarations** - No intermediate disk I/O for `.d.ts` files
-- **Parallel processing** - Type checking and transpilation run in parallel when possible
+- **Parallel processing** - Declaration bundling and transpilation run in parallel after type checking completes
 - **Smart caching** - Leverages `.tsbuildinfo` for TypeScript incremental compilation
 
 Typical build times for the tsbuild project itself:
@@ -367,9 +471,9 @@ The TypeScript declaration bundling system was originally inspired by rollup-plu
 ## Limitations
 
 - **ESM Only** - No CommonJS support by design
-- **Node.js 20.16.0+** - Requires modern Node.js features
-- **Experimental** - Personal project, not recommended for production use
-- **Limited Configuration in tsconfig.json** - Some options (like `plugins`) are only available via programmatic API
+- **Node.js 20.16.0+** - 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
 
 ## Comparison with Other Tools
@@ -377,9 +481,10 @@ The TypeScript declaration bundling system was originally inspired by rollup-plu
 | Feature | tsbuild | tsup | tsc |
 |---------|---------|------|-----|
 | Type Checking | ✅ Full | ✅ Full | ✅ Full |
-| Fast Bundling | ✅ esbuild | ✅ esbuild | ❌ N/A |
+| Bundling | ✅ esbuild | ✅ esbuild | ❌ N/A |
 | Declaration Bundling | ✅ Custom Bundler | ✅ rollup-plugin-dts | ❌ N/A |
-| Decorator Metadata | ✅ SWC (optional) | ✅ SWC | ✅ Native |
+| TC39 Decorators | ✅ Native | ✅ Native | ✅ Native |
+| Legacy Decorator Metadata | ✅ SWC (manual install) | ✅ SWC | ✅ Native |
 | CommonJS Support | ❌ None | ✅ Yes | ✅ Yes |
 | Watch Mode | ✅ Yes | ✅ Yes | ✅ Yes |
 | Incremental Builds | ✅ Yes | ⚠️ Limited | ✅ Yes |
@@ -412,16 +517,12 @@ pnpm lint
 
 ## Contributing
 
-This is a personal experimental project. While contributions are welcome, please note that the project is not actively maintained for production use.
+Contributions and feedback are welcome. This is a personal project, so response times may vary, but issues and pull requests will be reviewed.
 
 ## License
 
-ISC
+MIT
 
 ## Author
 
 D1g1talEntr0py
-
----
-
-**Remember:** For production projects, use [tsup](https://tsup.egoist.dev/) instead. tsbuild is an educational and experimental project exploring how modern build tools can be composed together.

package/dist/{PWB3B4C6.js → 3HKDLNVH.js}

@@ -340,6 +340,19 @@ var Logger = class _Logger {
     const prefix = indent ? "  \u2514\u2500" : "\u2713";
     console.log(TextFormat.green(`${prefix} ${message}`));
   }
+  /**
+   * Logs sub-step timing entries in a tree format below a parent step.
+   * @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 prefix = i === length - 1 ? "  \u2514\u2500" : "  \u251C\u2500";
+      console.log(`${TextFormat.dim(prefix)} ${TextFormat.bold(name.padEnd(maxNameLength))} ${TextFormat.cyan(duration.padStart(maxDurationLength))}`);
+    }
+  }
   /**
    * Logs a success message.
    * @param message The message to log.
@@ -1495,13 +1508,14 @@ function closeOnExit(value, _context) {
 // src/decorators/performance-logger.ts
 import { PerformanceObserver, performance } from "perf_hooks";
 var type = "measure";
+var pendingSteps = [];
 var _PerformanceLogger_decorators, _init;
 _PerformanceLogger_decorators = [closeOnExit];
 var _PerformanceLogger = class _PerformanceLogger {
   performanceObserver;
   constructor() {
     this.performanceObserver = new PerformanceObserver((list) => {
-      for (const { name, duration, detail: { message, result = [] } } of list.getEntriesByType(type).reverse()) {
+      for (const { name, duration, detail: { message, result = [], steps } } of list.getEntriesByType(type).reverse()) {
         if (message === "Build") {
           Logger.separator();
           if (process.exitCode) {
@@ -1513,6 +1527,9 @@ var _PerformanceLogger = class _PerformanceLogger {
           }
         } else {
           Logger.step(`${message} ${TextFormat.dim(`(${_PerformanceLogger.formatDuration(duration)})`)}`);
+          if (steps?.length) {
+            Logger.subSteps(steps);
+          }
           if (result.length > 0) {
             Logger.success("", ...result);
           }
@@ -1533,6 +1550,9 @@ var _PerformanceLogger = class _PerformanceLogger {
       if (logResult) {
         options.detail.result = result;
       }
+      if (pendingSteps.length > 0) {
+        options.detail.steps = pendingSteps.splice(0);
+      }
       ({ startTime: options.end } = performance.mark(propertyKey));
       performance.measure(propertyKey, options);
       return result;
@@ -1575,6 +1595,9 @@ _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 });
+}
 
 // src/decorators/debounce.ts
 var _DebounceManager_decorators, _init2;
@@ -1643,11 +1666,17 @@ function debounce(wait) {
 }
 
 // src/file-manager.ts
-import { sys as sys2, createSourceFile as createSourceFile2, ScriptTarget as ScriptTarget2 } from "typescript";
+import { createSourceFile as createSourceFile2, ScriptTarget as ScriptTarget2 } from "typescript";
 var FileManager = class {
   hasEmittedFiles = false;
   declarationFiles = /* @__PURE__ */ new Map();
   cache;
+  /** Raw declaration text captured during emit, pending pre-processing */
+  pendingFiles = [];
+  /** Buffered .tsbuildinfo content for async write (avoids sync I/O during emit) */
+  pendingBuildInfo;
+  /** Background cache save promise — awaited in initialize() and close() */
+  pendingSave;
   /**
    * Creates a new file manager.
    * @param buildCache - Optional build cache for incremental builds
@@ -1668,7 +1697,13 @@ var FileManager = class {
    * ```
    */
   async initialize() {
+    if (this.pendingSave) {
+      await this.pendingSave;
+      this.pendingSave = void 0;
+    }
     this.hasEmittedFiles = false;
+    this.pendingFiles.length = 0;
+    this.pendingBuildInfo = void 0;
     if (this.cache) {
       await this.cache.restore(this.declarationFiles);
     } else {
@@ -1684,14 +1719,22 @@ var FileManager = class {
    * ```typescript
    * await manager.initialize();
    * program.emit(undefined, manager.fileWriter, undefined, true);
-   * const hasEmitted = await manager.finalize();
+   * const hasEmitted = manager.finalize();
    * if (hasEmitted) { // Continue with build }
    * ```
    */
-  async finalize() {
+  finalize() {
+    this.processEmittedFiles();
+    const buildInfoWrite = this.pendingBuildInfo ? Files.write(this.pendingBuildInfo.path, this.pendingBuildInfo.text) : void 0;
+    this.pendingBuildInfo = void 0;
     if (this.cache && this.hasEmittedFiles) {
-      await this.cache.save(this.declarationFiles);
+      this.pendingSave = Promise.all([buildInfoWrite, this.cache.save(this.declarationFiles)]).then(() => {
+      });
+    } else if (buildInfoWrite) {
+      this.pendingSave = buildInfoWrite;
     }
+    this.pendingSave?.catch(() => {
+    });
     return this.cache === void 0 || this.hasEmittedFiles;
   }
   /**
@@ -1746,8 +1789,25 @@ var FileManager = class {
    * Clears all stored declaration files.
    */
   close() {
+    this.pendingSave?.then(() => {
+    }, () => {
+    });
+    this.pendingSave = void 0;
+    this.pendingFiles.length = 0;
+    this.pendingBuildInfo = void 0;
     this.declarationFiles.clear();
   }
+  /**
+   * Awaits any in-flight background I/O (cache save, .tsbuildinfo write).
+   * Call this when you need to guarantee all pending writes have completed,
+   * e.g., before reading the cache file from a different instance.
+   */
+  async flush() {
+    if (this.pendingSave) {
+      await this.pendingSave;
+      this.pendingSave = void 0;
+    }
+  }
   /**
    * Writes a single declaration file to disk.
    * @param projectDirectory - Project root for calculating relative paths
@@ -1761,21 +1821,32 @@ var FileManager = class {
   }
   /**
    * Function that intercepts file writes during TypeScript emit.
-   * Declaration files are pre-processed and stored in memory, while .tsbuildinfo is written to disk.
-   * Pre-processing happens immediately so the cache stores ready-to-use declarations.
+   * Captures raw text for deferred pre-processing and buffers .tsbuildinfo for async I/O.
+   * Designed to be as fast as possible since it runs inside TypeScript's synchronous emit() call.
    * @param filePath - The path of the file being written
    * @param text - The content of the file being written
    */
   fileWriter = (filePath, text) => {
     if (this.cache?.isBuildInfoFile(filePath)) {
-      sys2.writeFile(filePath, text);
+      this.pendingBuildInfo = { path: filePath, text };
     } else {
-      this.declarationFiles.set(filePath, DeclarationProcessor.preProcess(createSourceFile2(filePath, text, ScriptTarget2.Latest, true)));
+      this.pendingFiles.push({ path: filePath, text });
     }
     if (!this.hasEmittedFiles) {
       this.hasEmittedFiles = true;
     }
   };
+  /**
+   * Pre-processes all declaration files captured during emit.
+   * Runs createSourceFile + DeclarationProcessor.preProcess for each pending file,
+   * then clears the pending queue.
+   */
+  processEmittedFiles() {
+    for (const { path, text } of this.pendingFiles) {
+      this.declarationFiles.set(path, DeclarationProcessor.preProcess(createSourceFile2(path, text, ScriptTarget2.Latest, true)));
+    }
+    this.pendingFiles.length = 0;
+  }
   /**
    * Custom inspection method for better type representation.
    * @returns The string 'FileManager'
@@ -1971,10 +2042,11 @@ function inferEntryPoints(packageJson, outDir, sourceDir = "src") {
 
 // src/type-script-project.ts
 import { build as esbuild, formatMessages } from "esbuild";
-import { sys as sys3, createIncrementalProgram, formatDiagnostics, formatDiagnosticsWithColorAndContext, parseJsonConfigFileContent, readConfigFile, findConfigFile } from "typescript";
+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 diagnosticsHost = { getNewLine: () => sys3.newLine, getCurrentDirectory: sys3.getCurrentDirectory, getCanonicalFileName: (fileName) => fileName };
+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)];
 var _TypeScriptProject = class _TypeScriptProject {
@@ -1983,7 +2055,7 @@ var _TypeScriptProject = class _TypeScriptProject {
    * @param directory - Project root directory (defaults to current working directory)
    * @param options - Project options to merge with tsconfig.json
    */
-  constructor(directory = sys3.getCurrentDirectory(), options = {}) {
+  constructor(directory = sys2.getCurrentDirectory(), options = {}) {
     __runInitializers(_init3, 5, this);
     __publicField(this, "fileWatcher");
     __publicField(this, "builderProgram");
@@ -2015,7 +2087,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     return Files.empty(this.buildConfiguration.outDir);
   }
   async build() {
-    Logger.header(`\u{1F680} tsbuild v${"1.2.3"}${this.configuration.compilerOptions.incremental ? " [incremental]" : ""}`);
+    Logger.header(`\u{1F680} tsbuild v${"1.3.0"}${this.configuration.compilerOptions.incremental ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const filesWereEmitted = await this.typeCheck();
@@ -2053,11 +2125,19 @@ var _TypeScriptProject = class _TypeScriptProject {
   }
   async typeCheck() {
     await this.fileManager.initialize();
-    const { diagnostics } = this.builderProgram.emit(void 0, this.fileManager.fileWriter, void 0, true);
-    if (diagnostics.length > 0) {
-      _TypeScriptProject.handleTypeErrors("Type-checking failed", diagnostics, this.directory);
-    }
-    return this.fileManager.finalize();
+    performance2.mark("emit:start");
+    const { diagnostics: emitDiagnostics } = this.builderProgram.emit(void 0, this.fileManager.fileWriter, void 0, true);
+    addPerformanceStep("Emit", _TypeScriptProject.elapsed("emit:start"));
+    performance2.mark("diagnostics:start");
+    const allDiagnostics = [...this.builderProgram.getSemanticDiagnostics(), ...emitDiagnostics];
+    addPerformanceStep("Diagnostics", _TypeScriptProject.elapsed("diagnostics:start"));
+    if (allDiagnostics.length > 0) {
+      _TypeScriptProject.handleTypeErrors("Type-checking failed", allDiagnostics, this.directory);
+    }
+    performance2.mark("finalize:start");
+    const result = this.fileManager.finalize();
+    addPerformanceStep("Finalize", _TypeScriptProject.elapsed("finalize:start"));
+    return result;
   }
   async transpile() {
     const plugins = [outputPlugin()];
@@ -2066,7 +2146,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     }
     if (this.configuration.compilerOptions.emitDecoratorMetadata) {
       try {
-        const { swcDecoratorMetadataPlugin } = await import("./DSHNVGWV.js");
+        const { swcDecoratorMetadataPlugin } = await import("./LEZQQWX3.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");
@@ -2223,7 +2303,7 @@ var _TypeScriptProject = class _TypeScriptProject {
    * @returns Resolved configuration and TypeScript parser results
    */
   static resolveConfiguration(directory, typeScriptOptions) {
-    const configResult = readConfigFile(findConfigFile(directory, sys3.fileExists) ?? "./tsconfig.json", sys3.readFile);
+    const configResult = readConfigFile(findConfigFile(directory, sys2.fileExists) ?? "./tsconfig.json", sys2.readFile);
     if (configResult.error !== void 0) {
       throw new ConfigurationError(formatDiagnostics([configResult.error], diagnosticsHost));
     }
@@ -2233,7 +2313,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     const hasExplicitEntryPoints = typeScriptOptions.tsbuild?.entryPoints !== void 0 || configResult.config.tsbuild?.entryPoints !== void 0;
     let inferredEntryPoints;
     if (!hasExplicitEntryPoints && bundle) {
-      const packageJsonContent = sys3.readFile(Paths.join(directory, "package.json"));
+      const packageJsonContent = sys2.readFile(Paths.join(directory, "package.json"));
       if (packageJsonContent) {
         try {
           const pkgJson = JSON.parse(packageJsonContent);
@@ -2272,7 +2352,7 @@ var _TypeScriptProject = class _TypeScriptProject {
         ...typeScriptOptions.compilerOptions
       }
     };
-    const { options, fileNames, errors } = parseJsonConfigFileContent(baseConfig, sys3, directory);
+    const { options, fileNames, errors } = parseJsonConfigFileContent(baseConfig, sys2, directory);
     return {
       ...baseConfig,
       compilerOptions: {
@@ -2372,11 +2452,11 @@ var _TypeScriptProject = class _TypeScriptProject {
     const [[firstFileName, { line: firstLine }] = ["", { line: 0 }]] = filesWithErrors;
     const relativeFirstFileName = Paths.relative(projectDirectory, firstFileName);
     if (errorCount === 1) {
-      Logger.error(`Found 1 error in ${relativeFirstFileName}:${firstLine + 1}${sys3.newLine}`);
+      Logger.error(`Found 1 error in ${relativeFirstFileName}:${firstLine + 1}${sys2.newLine}`);
     } else if (fileCount === 1) {
-      Logger.error(`Found ${errorCount} errors in the same file, starting at: ${relativeFirstFileName}:${firstLine + 1}${sys3.newLine}`);
+      Logger.error(`Found ${errorCount} errors in the same file, starting at: ${relativeFirstFileName}:${firstLine + 1}${sys2.newLine}`);
     } else {
-      Logger.error(`Found ${errorCount} errors in ${fileCount} files.${sys3.newLine}`);
+      Logger.error(`Found ${errorCount} errors in ${fileCount} files.${sys2.newLine}`);
       Logger.error("Errors  Files");
       for (const [fileName, { count, line }] of filesWithErrors) {
         Logger.error(`     ${count}  ${fileName}:${line + 1}`);
@@ -2384,6 +2464,18 @@ var _TypeScriptProject = class _TypeScriptProject {
     }
     throw new TypeCheckError(message, formatDiagnostics(diagnostics, diagnosticsHost));
   }
+  /**
+   * 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')
+   */
+  static elapsed(markName) {
+    const endMark = performance2.mark(`${markName}:end`);
+    const duration = endMark.startTime - performance2.getEntriesByName(markName, "mark")[0].startTime;
+    performance2.clearMarks(markName);
+    performance2.clearMarks(endMark.name);
+    return `${~~duration}ms`;
+  }
 };
 _init3 = __decoratorStart(null);
 __decorateElement(_init3, 1, "build", _build_dec, _TypeScriptProject);

package/dist/{DSHNVGWV.js → LEZQQWX3.js}

@@ -7,7 +7,6 @@ import {
 
 // src/plugins/decorator-metadata.ts
 import { dirname } from "node:path";
-import { transformFile } from "@swc/core";
 var swcOptions = {
   jsc: {
     parser: { syntax: "typescript", decorators: true },
@@ -30,6 +29,7 @@ var swcDecoratorMetadataPlugin = {
   setup(build) {
     build.initialOptions.keepNames = true;
     build.onLoad({ filter: typeScriptExtensionExpression }, async ({ path }) => {
+      const { transformFile } = await import("@swc/core");
       const result = await transformFile(path, swcOptions);
       if (result.map) {
         const sources = [];

package/dist/index.d.ts

@@ -41,9 +41,14 @@ interface Closable {
     close: Callable;
 }
 type ClosableConstructor = Constructor<any[], Closable>;
+type PerformanceSubStep = {
+    name: string;
+    duration: string;
+};
 type PerformanceEntryDetail<T = unknown[]> = {
     message: string;
     result?: T;
+    steps?: PerformanceSubStep[];
 };
 type DetailedPerformanceMeasureOptions<R> = PrettyModify<PerformanceMeasureOptions, {
     detail: PerformanceEntryDetail<R>;
@@ -337,7 +342,13 @@ declare class TypeScriptProject implements Closable {
      * @param projectDirectory - The project directory.
      */
     private static handleTypeErrors;
+    /**
+     * 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')
+     */
+    private static elapsed;
 }
 
 export { TypeScriptProject };
-export type { AbsolutePath, AsyncEntryPoints, Brand, BuildCache, BuildConfiguration, CachedDeclaration, Closable, ClosableConstructor, CompilerOptionOverrides, ConditionalPath, DetailedPerformanceEntry, DetailedPerformanceMeasureOptions, EntryPoints, EsTarget, FormatSupplier, Function, InferredFunction, JsonString, JsxRenderingMode, LogEntryType, MethodFunction, OptionalReturn, Path, Pattern, PendingFileChange, ProjectBuildConfiguration, ProjectDependencies, ReadConfigResult, RelativePath, SourceMap, TypeScriptConfiguration, TypeScriptOptions, TypedFunction, WrittenFile };
+export type { AbsolutePath, AsyncEntryPoints, Brand, BuildCache, BuildConfiguration, CachedDeclaration, Closable, ClosableConstructor, CompilerOptionOverrides, ConditionalPath, DetailedPerformanceEntry, DetailedPerformanceMeasureOptions, EntryPoints, EsTarget, FormatSupplier, Function, InferredFunction, JsonString, JsxRenderingMode, LogEntryType, MethodFunction, OptionalReturn, Path, Pattern, PendingFileChange, PerformanceSubStep, ProjectBuildConfiguration, ProjectDependencies, ReadConfigResult, RelativePath, SourceMap, TypeScriptConfiguration, TypeScriptOptions, TypedFunction, WrittenFile };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   TypeScriptProject
-} from "./PWB3B4C6.js";
+} from "./3HKDLNVH.js";
 import "./7FPDHUPW.js";
 export {
   TypeScriptProject

package/dist/tsbuild.js

@@ -2,7 +2,7 @@
 import {
   BuildError,
   TypeScriptProject
-} from "./PWB3B4C6.js";
+} from "./3HKDLNVH.js";
 import "./7FPDHUPW.js";
 
 // src/tsbuild.ts
@@ -30,7 +30,7 @@ if (help) {
   process.exit(0);
 }
 if (version) {
-  console.log("1.2.3");
+  console.log("1.3.0");
   process.exit(0);
 }
 var typeScriptOptions = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/tsbuild",
-  "version": "1.2.3",
-  "packageManager": "pnpm@10.29.3",
+  "version": "1.3.0",
+  "packageManager": "pnpm@10.30.3",
   "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.",
   "type": "module",
   "exports": {
@@ -72,9 +72,5 @@
     "typescript": "5.9.3",
     "typescript-eslint": "^8.56.1",
     "vitest": "^4.0.18"
-  },
-  "optionalDependencies": {
-    "@swc/core": "^1.15.13",
-    "@swc/types": "^0.1.25"
   }
 }