@d1g1tal/tsbuild 1.2.5 → 1.3.1

package/README.md

@@ -1,11 +1,11 @@
 # tsbuild
 
-[![npm version](https://img.shields.io/npm/v/%40d1g1tal/tsbuild?color=blue)](https://www.npmjs.com/package/@d1g1tal/tsbuild)
-[![npm downloads](https://img.shields.io/npm/dm/%40d1g1tal/tsbuild)](https://www.npmjs.com/package/@d1g1tal/tsbuild)
+[![npm version](https://img.shields.io/npm/v/@d1g1tal/tsbuild?color=blue)](https://www.npmjs.com/package/@d1g1tal/tsbuild)
+[![npm downloads](https://img.shields.io/npm/dm/@d1g1tal/tsbuild)](https://www.npmjs.com/package/@d1g1tal/tsbuild)
 [![CI](https://github.com/D1g1talEntr0py/tsbuild/actions/workflows/ci.yml/badge.svg)](https://github.com/D1g1talEntr0py/tsbuild/actions/workflows/ci.yml)
 [![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/%40d1g1tal/tsbuild)](https://nodejs.org)
+[![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+.
@@ -478,17 +478,19 @@ The TypeScript declaration bundling system was originally inspired by rollup-plu
 
 ## Comparison with Other Tools
 
-| Feature | tsbuild | tsup | tsc |
-|---------|---------|------|-----|
-| Type Checking | ✅ Full | ✅ Full | ✅ Full |
-| Bundling | ✅ esbuild | ✅ esbuild | ❌ N/A |
-| Declaration Bundling | ✅ Custom Bundler | ✅ rollup-plugin-dts | ❌ N/A |
-| 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 |
-| Production Ready | ⚠️ Experimental | ✅ Yes | ✅ Yes |
+| Feature | tsbuild | tsup | tsdown | tsc |
+|---------|---------|------|--------|-----|
+| Type Checking | ✅ Full | ✅ Full | ⚠️ Via DTS only | ✅ Full |
+| Bundling | ✅ esbuild | ✅ esbuild | ✅ Rolldown | ❌ N/A |
+| Declaration Bundling | ✅ Custom Bundler | ✅ rollup-plugin-dts¹ | ✅ rolldown-plugin-dts | ❌ N/A |
+| TC39 Decorators | ✅ Native | ✅ Native | ✅ Native | ✅ Native |
+| Legacy Decorator Metadata | ✅ SWC (manual install) | ✅ SWC | ✅ SWC | ✅ Native |
+| CommonJS Support | ❌ None | ✅ Yes | ✅ Yes | ✅ Yes |
+| Watch Mode | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
+| Incremental Builds | ✅ Yes | ⚠️ Limited | ⚠️ Limited | ✅ Yes |
+| Production Ready | ⚠️ Experimental | ✅ Yes | ✅ Yes | ✅ Yes |
+
+> ¹ tsup uses **esbuild** for JS bundling and **rollup-plugin-dts** (a Rollup plugin) for declaration bundling. `--experimental-dts` uses `@microsoft/api-extractor` instead. An optional `--treeshake` flag also delegates tree-shaking to Rollup.
 
 ## Development
 

package/dist/{O7CHVFME.js → KY7JTF4C.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'
@@ -1872,7 +1943,7 @@ var IncrementalBuildCache = class {
 };
 
 // src/entry-points.ts
-var importConditions = ["import", "default"];
+var importConditions = ["import", "node", "module", "default"];
 function stemOf(filePath) {
   const base = filePath.split("/").at(-1) ?? "";
   const dot = base.indexOf(".");
@@ -1908,8 +1979,12 @@ function resolveConditionalExport(exportValue) {
   }
   for (const condition of importConditions) {
     const value = exportValue[condition];
-    if (typeof value === "string") {
-      return value;
+    if (value === void 0) {
+      continue;
+    }
+    const resolved = resolveConditionalExport(value);
+    if (resolved !== void 0) {
+      return resolved;
     }
   }
   return void 0;
@@ -1971,10 +2046,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 +2059,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 +2091,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     return Files.empty(this.buildConfiguration.outDir);
   }
   async build() {
-    Logger.header(`\u{1F680} tsbuild v${"1.2.5"}${this.configuration.compilerOptions.incremental ? " [incremental]" : ""}`);
+    Logger.header(`\u{1F680} tsbuild v${"1.3.1"}${this.configuration.compilerOptions.incremental ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const filesWereEmitted = await this.typeCheck();
@@ -2053,12 +2129,19 @@ var _TypeScriptProject = class _TypeScriptProject {
   }
   async typeCheck() {
     await this.fileManager.initialize();
+    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);
     }
-    return this.fileManager.finalize();
+    performance2.mark("finalize:start");
+    const result = this.fileManager.finalize();
+    addPerformanceStep("Finalize", _TypeScriptProject.elapsed("finalize:start"));
+    return result;
   }
   async transpile() {
     const plugins = [outputPlugin()];
@@ -2224,7 +2307,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));
     }
@@ -2234,7 +2317,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);
@@ -2273,7 +2356,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: {
@@ -2373,11 +2456,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}`);
@@ -2385,6 +2468,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/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 "./O7CHVFME.js";
+} from "./KY7JTF4C.js";
 import "./7FPDHUPW.js";
 export {
   TypeScriptProject

package/dist/tsbuild.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d1g1tal/tsbuild",
-  "version": "1.2.5",
+  "version": "1.3.1",
   "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",