@d1g1tal/tsbuild 1.8.10 → 1.9.1

package/CHANGELOG.md

@@ -1,3 +1,98 @@
+## [1.9.1](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.9.0...v1.9.1) (2026-06-14)
+
+### Performance Improvements
+
+* **loader:** improve loader caching key uniqueness and safety (319eb4f938458aa69ccdc71783a8116934769e6a)
+- Add file inode and configuration status metrics to the transformation cache keys
+- Migrate from async block writes to safe, synchronous filesystem writes
+- Recover on-the-fly from zero-byte or corrupt cached module assets
+
+
+### Code Refactoring
+
+* **tsbuild:** remove test-only flush methods and standardize process exit (bebbc91a1516dff7560fd373358496d170f15e60)
+- Avoid direct process.exit calls and handle exit state through process.exitCode
+- Remove the flushBackgroundCleanup project hook, refactoring test suites to poll for output removal instead
+- Simplify dependency path resolution by referencing internal promises directly
+
+
+### Documentation
+
+* refine project guidelines and update copilot instructions (3b7d6bed70d84968be88793897bfa5580931d098)
+- Clean up githooks file permissions and mode headers
+- Condense Copilot instructions into a unified, high-density reference snapshot
+- Document target values and criteria for performance optimization checks
+
+
+### Miscellaneous Chores
+
+* **bench:** remove platform-specific details and introduce non-dts benchmarks (5887e241de3d4c22967030815f3ff548ac445276)
+- Remove platform-specific MAXRSS memory measurements to ensure portable benchmark execution
+- Introduce comparative benchmarks testing tsbuild with decoration emitting disabled
+- Improve child process crash diagnostics and print cleaner terminal result layouts
+
+
+### Build System
+
+* **deps:** upgrade Node engine, package manager, and dependencies (a695f4e2e1a7af8b2036e8ed1f2c766cdcaeb21f)
+- Raise Node.js requirement to >=22.6.0 and pnpm package manager to 11.6.0
+- Upgrade esbuild production dependency to 0.28.1
+- Update multiple devDependencies including ESLint, typescript-eslint, memory-fs, and Vitest
+- Regenerate the lockfile to align with package version bumps
+
+## [1.9.0](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.8.10...v1.9.0) (2026-05-23)
+
+### Features
+
+* **cache:** implement configuration fingerprinting for incremental builds (4bb8b9ec6415cd5a3bd15d9a5265725c3ff0242c)
+- Introduces deterministic JSON fingerprinting covering platform, target, formats, and bundler options
+- Replaces strict boolean minification caching with robust multi-variable configuration fingerprints
+- Compares fresh configurations with on-disk persisted fingerprint states to flush outputs dynamically
+- Enhances cache manager implementations allowing seamless integration with esbuild pipelines
+- Overrides unit tests validating caching scenarios evaluating string-based hashes correctly
+
+
+### Performance Improvements
+
+* **core:** optimize iteration loops during data serialization (08cd6d3f77af3b58072dab008bee7a3217cc1d56)
+- Restructures array destructuring and explicit index loops addressing slow map operations
+- Avoids `Object.entries()` array memory spikes during physical build loop mapping
+- Optimizes the declaration exports loop preventing excessive intermediary filtering blocks
+- Reduces overall execution times slightly during intensive build output parsing
+
+
+### Documentation
+
+* **readme:** update build documentation with cache and loader details (764514b987812743ffd11153e678e6723f8e09e4)
+- Details the configuration change detection mechanism that avoids stale caches when the config differs
+- Adds a dedicated section for the self-hosting loader to help clarify bootstrapping logic
+
+
+### Styles
+
+* **docs:** prune redundant jsdoc comments across codebase (3b106dade1b5bc7dc713ef37463a984ca40f02b4)
+- Removes repetitive property comments from standard interfaces like typescript configurations
+- Strips excess constructor `@param` tags throughout standard object models
+- Erases leftover `@returns` definitions across standard helper functions
+- Fixes minor spacing issues affecting multiple comment block fragments
+
+
+### Miscellaneous Chores
+
+* **eslint:** disable excessive jsdoc property requirements (11f4d21f0515841cdd2c5b1e112db67f42cbaf02)
+- Reduces the strictness of JSDoc returns and param description rules
+- Subdues linting checks on empty constructors and standard types to cut down developer fatigue
+
+
+### Tests
+
+* **project:** refactor integration suites adopting build method structures (749970133479e51bc8d9a68c591ac926d394170e)
+- Rewrites older validation strategies bypassing internal private methods completely
+- Tests public `project.build()` execution flows simulating realistic cli invocations directly
+- Handles unexpected esbuild crash reporting verifications robustly
+- Adjusts browser platform resolving logic testing ensuring appropriate outputs trigger successfully
+- Drops deprecated testing suites previously locked behind internal mock validations
+
 ## [1.8.10](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.8.9...v1.8.10) (2026-05-23)
 
 ### Bug Fixes

package/README.md

@@ -301,6 +301,8 @@ With incremental enabled, each build maintains two caches inside a `.tsbuild/` d
 
 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.
 
+**Config change detection** — tsbuild stores a fingerprint of the current build configuration (minify, platform, source maps, iife, splitting, banner/footer, env, noExternal, dts options, etc.) alongside the DTS cache. If any of these settings change between builds, the output phase is forced even when TypeScript reports no source changes. The fingerprint is updated at the end of each build so subsequent runs do not repeatedly trigger a forced rebuild.
+
 ### Ignoring the cache directory
 
 The `.tsbuild/` directory contains build artifacts that should not be committed to source control. Add it to your `.gitignore`:
@@ -616,6 +618,10 @@ pnpm test:coverage
 pnpm lint
 ```
 
+### Self-hosting loader
+
+tsbuild bootstraps itself using a minimal custom Node.js module hook (`scripts/loader.ts`). It registers resolve and load hooks via `node:module`'s `registerHooks` API and uses esbuild's `transformSync` to compile TypeScript on-the-fly. Transformed files are cached in `node_modules/.cache/tsbuild-loader`, keyed by file path hash, mtime, byte size, and the running Node.js + esbuild versions, so warm starts pay only a `readFileSync` per file. The cache directory is intentionally kept out of `.tsbuild/` so that `--clearCache` does not blow it away.
+
 ## Contributing
 
 Contributions and feedback are welcome. This is a personal project, so response times may vary, but issues and pull requests will be reviewed.

package/dist/{5DXLYKZU.js → 3ZUONNU3.js}

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

package/dist/{4JXWHUXF.js → 7G6BAIKH.js}

@@ -29,7 +29,7 @@ import {
   toEsTarget,
   toJsxRenderingMode,
   typeMatcher
-} from "./QL4XMDMJ.js";
+} from "./XTZ3MYA7.js";
 
 // src/files.ts
 import { dirname, join } from "node:path";
@@ -43,7 +43,6 @@ var Files = class {
   /**
    * Check if a file exists.
    * @param filePath The path to the file.
-   * @returns True if the file exists, false otherwise.
    */
   static async exists(filePath) {
     try {
@@ -85,7 +84,7 @@ var Files = class {
   }
   /**
    * Write data to a file.
-   * Ensures the directory exists before writing
+   * Ensures the directory exists before writing.
    * @param filePath The path to the file.
    * @param data The data to write to the file.
    * @param options Optional write file options.
@@ -428,11 +427,6 @@ import { basename, posix } from "node:path";
 // src/errors.ts
 import { SyntaxKind } from "typescript";
 var BuildError = class extends Error {
-  /**
-   * Creates a new BuildError
-   * @param message - Error message
-   * @param code - Exit code (default: 1)
-   */
   constructor(message, code = 1) {
     super(message);
     this.code = code;
@@ -442,11 +436,6 @@ var BuildError = class extends Error {
   code;
 };
 var TypeCheckError = class extends BuildError {
-  /**
-   * Creates a new TypeCheckError
-   * @param message - Error message
-   * @param diagnostics - Optional TypeScript diagnostics output
-   */
   constructor(message, diagnostics) {
     super(message, 1);
     this.diagnostics = diagnostics;
@@ -455,31 +444,18 @@ var TypeCheckError = class extends BuildError {
   diagnostics;
 };
 var BundleError = class extends BuildError {
-  /**
-   * Creates a new BundleError
-   * @param message - Error message
-   */
   constructor(message) {
     super(message, 2);
     this.name = "BundleError";
   }
 };
 var ConfigurationError = class extends BuildError {
-  /**
-   * Creates a new ConfigurationError
-   * @param message - Error message
-   */
   constructor(message) {
     super(message, 3);
     this.name = "ConfigurationError";
   }
 };
 var UnsupportedSyntaxError = class extends BundleError {
-  /**
-   * Creates an instance of UnsupportedSyntaxError.
-   * @param node The node with unsupported syntax
-   * @param message The message to display (default: 'Syntax not yet supported')
-   */
   constructor(node, message = "Syntax not yet supported") {
     const syntaxKindName = SyntaxKind[node.kind] ?? `Unknown(${node.kind})`;
     const nodeText = node.getText ? node.getText().slice(0, 100) : "<no text>";
@@ -1300,9 +1276,18 @@ var DeclarationBundler = class _DeclarationBundler {
         }
       }
     }
-    const finalValueExportsSet = new Set(valueExports.map(exportsMapper));
-    const finalTypeExports = [...new Set(typeExports.map(exportsMapper).filter((type2) => !finalValueExportsSet.has(type2)))];
-    return { code: magic.toString(), externalImports, typeExports: finalTypeExports, valueExports: [...finalValueExportsSet] };
+    const finalValueExportsSet = /* @__PURE__ */ new Set();
+    for (const name of valueExports) {
+      finalValueExportsSet.add(exportsMapper(name));
+    }
+    const finalTypeExports = [];
+    for (const type2 of typeExports) {
+      const mapped = exportsMapper(type2);
+      if (!finalValueExportsSet.has(mapped)) {
+        finalTypeExports.push(mapped);
+      }
+    }
+    return { code: magic.toString(), externalImports, typeExports: finalTypeExports, valueExports: Array.from(finalValueExportsSet) };
   }
   /**
    * Combine modules into a single output string
@@ -1516,8 +1501,8 @@ var outputPlugin = () => {
   return {
     name: "esbuild:output-plugin",
     /**
-     * Checks JS entry points for shebangs and sets executable permissions
-     * @param build The esbuild build instance
+     * Checks JS entry points for shebangs and sets executable permissions.
+     * @param build The esbuild plugin build object.
      */
     setup(build) {
       build.onEnd(async ({ metafile }) => {
@@ -1666,8 +1651,8 @@ function iifePlugin(options) {
     plugin: {
       name: "esbuild:iife",
       /**
-       * Configures the esbuild build instance to produce IIFE output
-       * @param build The esbuild build instance
+       * Configures the esbuild build instance to produce IIFE output.
+       * @param build The esbuild plugin build object.
        */
       setup(build) {
         const outdir = build.initialOptions.outdir;
@@ -1882,7 +1867,7 @@ var ProcessManager = class {
     }
     this.close();
   };
-  /** Handles console exit (ctrl+c) */
+  /** Handles SIGINT (ctrl+c) */
   consoleExit = () => {
     Logger.warn("\nProcess terminated by user");
     this.hasHandledExit = true;
@@ -1906,10 +1891,6 @@ var processManager = new ProcessManager();
 // src/decorators/close-on-exit.ts
 function closeOnExit(value, _context) {
   return class extends value {
-    /**
-     * Creates an instance and registers it with the process manager.
-     * @param args Arguments to pass to the original constructor.
-     */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     constructor(...args) {
       super(...args);
@@ -1954,9 +1935,9 @@ var _PerformanceLogger = class _PerformanceLogger {
   }
   /**
    * Measures the performance of a method and logs the result.
-   * @param message - The message to log with the performance measurement.
-   * @param logResult - Whether to log the result of the method.
-   * @returns A Stage 3 method decorator that measures the performance of the method it decorates.
+   * @param message - The message to log with the performance measurement
+   * @param logResult - Whether to include the method return value in the log output
+   * @returns A Stage 3 method decorator that measures execution time of the decorated method
    */
   measure(message, logResult = false) {
     const _measure = (propertyKey, result, options) => {
@@ -2146,16 +2127,19 @@ var FileManager = class {
    * Persists the .tsbuildinfo file and the dts cache to disk in the background. Call this
    * AFTER the build's parallel phases (transpile + dts bundling) have completed so the writes
    * (and Brotli compression for the dts cache) don't compete with esbuild for libuv threadpool slots.
-   * @param minify Whether the current build is minified, for future cache compatibility checks
+   * @param fingerprint Build configuration fingerprint for cache invalidation on config change
+   * @param configChanged True when the build configuration fingerprint changed — forces the new
+   *   fingerprint to be saved even when TypeScript did not re-emit any files, preventing the
+   *   mismatch from triggering unnecessary forced rebuilds on every subsequent build.
    */
-  persistCache(minify) {
+  persistCache(fingerprint, configChanged = false) {
     const tasks = [];
     if (this.pendingBuildInfo) {
       tasks.push(Files.write(this.pendingBuildInfo.path, this.pendingBuildInfo.text));
       this.pendingBuildInfo = void 0;
     }
-    if (this.cache !== void 0 && this.hasEmittedFiles) {
-      tasks.push(this.cache.save(this.declarationFiles, minify));
+    if (this.cache !== void 0 && (this.hasEmittedFiles || configChanged)) {
+      tasks.push(this.cache.save(this.declarationFiles, fingerprint));
     }
     if (tasks.length === 0) {
       return;
@@ -2311,12 +2295,10 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
    * subsequent in-process reads are race-free.
    */
   outputsSnapshot;
-  /** Snapshot of whether previous successful transpile output used minification. */
-  minifySnapshot;
   /** Set to true when invalidate() is called to prevent stale cache from being restored */
   invalidated = false;
-  /** Tracks the most recently saved declaration files so saveMinifyState() doesn't revert them */
-  latestFiles;
+  /** Updated synchronously in save() so fingerprintMatches() sees fresh data without re-reading from disk. */
+  savedFingerprint;
   /**
    * Creates a new build cache instance and begins pre-loading the cache asynchronously.
    * @param projectRoot - Root directory of the project
@@ -2329,7 +2311,6 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
     this.outputsManifestPath = Paths.join(this.cacheDirectoryPath, outputManifestFile);
     this.cacheLoaded = this.loadCache();
     this.outputsSnapshot = _IncrementalBuildCache.loadOutputsSync(this.outputsManifestPath);
-    this.minifySnapshot = void 0;
   }
   /**
    * Loads the cache file asynchronously using V8 deserialization.
@@ -2341,7 +2322,6 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
       if (cache.version !== dtsCacheVersion) {
         return void 0;
       }
-      this.minifySnapshot = cache.minify;
       return cache;
     } catch {
       return void 0;
@@ -2367,16 +2347,33 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
     }
   }
   /**
-   * Saves declaration files to the compressed cache file with version information.
+   * Saves declaration files to the compressed cache file with version and fingerprint information.
    * Uses V8 serialization for faster read performance on subsequent builds.
    * @param source - The declaration files to cache
-   * @param minify - Whether the current build is minified, for future compatibility checks
-   * @remarks This should be called after the build completes successfully, so the cache always reflects a valid state on disk. If the build fails, the in-memory cache is still updated to reflect the latest state, but the on-disk cache remains unchanged to preserve compatibility with future builds. The next successful build will overwrite the cache with the correct state.
+   * @param fingerprint - Deterministic hash of build configuration for cache invalidation on config change
    */
-  async save(source, minify) {
-    this.latestFiles = source;
-    this.minifySnapshot = minify;
-    await Files.writeCompressed(this.cacheFilePath, { version: dtsCacheVersion, files: source, minify });
+  async save(source, fingerprint) {
+    this.savedFingerprint = fingerprint;
+    await Files.writeCompressed(this.cacheFilePath, { version: dtsCacheVersion, files: source, fingerprint });
+  }
+  /**
+   * Checks whether the build configuration has changed since the cache was last saved.
+   * Returns true if the cache is valid and fingerprints match, false if config changed or cache is invalid.
+   * @param currentFingerprint - The fingerprint of the current build configuration
+   * @returns True if the cached configuration matches the current configuration
+   */
+  async fingerprintMatches(currentFingerprint) {
+    if (this.invalidated) {
+      return false;
+    }
+    if (!this.hasPersistedState()) {
+      return false;
+    }
+    if (this.savedFingerprint !== void 0) {
+      return this.savedFingerprint === currentFingerprint;
+    }
+    const cache = await this.cacheLoaded;
+    return cache?.fingerprint === currentFingerprint;
   }
   /**
    * Loads the previous build's output manifest synchronously.
@@ -2411,29 +2408,11 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
     await writeFile4(this.outputsManifestPath, JSON.stringify(this.outputsSnapshot), "utf8");
   }
   /**
-   * Checks whether the current minify mode requires forcing a rebuild.
-   * Forces when the minify setting differs from the previously persisted state in either direction.
-   * Unknown previous state is treated as not-minified (safe default for pre-minify-awareness builds).
-   * @param minify - Current build minify mode
-   * @returns True when a full rebuild should be forced.
-   */
-  async requiresRebuild(minify) {
-    if (!this.hasPersistedState()) {
-      return false;
-    }
-    return minify !== (this.minifySnapshot ?? (await this.cacheLoaded)?.minify ?? false);
-  }
-  /**
-   * Persists minify mode metadata for future incremental-build compatibility checks.
-   * @param minify - Current build minify mode
+   * Checks if the cache is valid (not invalidated).
+   * @returns True if the cache is valid, false if it has been invalidated
    */
-  async saveMinifyState(minify) {
-    this.minifySnapshot = minify;
-    if (this.latestFiles !== void 0) {
-      return;
-    }
-    const files = this.invalidated ? /* @__PURE__ */ new Map() : (await this.cacheLoaded)?.files ?? /* @__PURE__ */ new Map();
-    await Files.writeCompressed(this.cacheFilePath, { version: dtsCacheVersion, files, minify });
+  isValid() {
+    return !this.invalidated;
   }
   /** Invalidates the build cache by removing the cache directory. */
   invalidate() {
@@ -2451,13 +2430,6 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
   isBuildInfoFile(filePath) {
     return filePath === this.buildInfoPath;
   }
-  /**
-   * Checks if the cache is valid (not invalidated).
-   * @returns True if the cache is valid, false if it has been invalidated
-   */
-  isValid() {
-    return !this.invalidated;
-  }
   /**
    * Synchronously checks whether persisted incremental state exists on disk.
    * When the .tsbuildinfo file is missing, the next typecheck will perform a full emit,
@@ -2601,6 +2573,28 @@ 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 serializePattern = (p) => p instanceof RegExp ? `/${p.source}/${p.flags}` : p;
+function buildFingerprint(buildConfig, compilerOptions) {
+  return JSON.stringify({
+    minify: buildConfig.minify,
+    iife: buildConfig.iife,
+    declaration: compilerOptions.declaration,
+    emitDeclarationOnly: compilerOptions.emitDeclarationOnly,
+    emitDecoratorMetadata: compilerOptions.emitDecoratorMetadata,
+    bundle: buildConfig.bundle,
+    splitting: buildConfig.splitting,
+    format,
+    target: buildConfig.target,
+    platform: buildConfig.platform,
+    sourceMap: buildConfig.sourceMap,
+    banner: buildConfig.banner,
+    footer: buildConfig.footer,
+    noExternal: buildConfig.noExternal.map(serializePattern),
+    dtsResolve: buildConfig.dts.resolve,
+    dtsEntryPoints: buildConfig.dts.entryPoints,
+    env: buildConfig.env
+  });
+}
 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/Emit", true)], _transpile_dec = [measure("Transpile", true)], _processDeclarations_dec = [measure("Bundle Declarations", true)], _triggerRebuild_dec = [debounce(100)];
 var _TypeScriptProject = class _TypeScriptProject {
@@ -2634,7 +2628,14 @@ var _TypeScriptProject = class _TypeScriptProject {
     this.buildConfiguration = { entryPoints: this.getEntryPoints(entryPoints), target: toEsTarget(target), outDir, ...tsbuildOptions };
     this.dependencyPaths = Files.read(Paths.absolute(this.directory, "package.json")).then((content) => {
       const { dependencies = {}, peerDependencies = {} } = Json.parse(content);
-      return [.../* @__PURE__ */ new Set([...Object.keys(dependencies), ...Object.keys(peerDependencies)])];
+      const dependencySet = /* @__PURE__ */ new Set();
+      for (const key of Object.keys(dependencies)) {
+        dependencySet.add(key);
+      }
+      for (const key of Object.keys(peerDependencies)) {
+        dependencySet.add(key);
+      }
+      return Array.from(dependencySet);
     }).catch(() => []);
   }
   /**
@@ -2682,20 +2683,14 @@ var _TypeScriptProject = class _TypeScriptProject {
     });
     this.pendingStaleOutputsCleanup = cleanup;
   }
-  /**
-   * Waits for fire-and-forget stale-output cleanup to settle.
-   * Useful for deterministic tests that need to assert post-cleanup filesystem state.
-   */
-  async flushBackgroundCleanup() {
-    await this.pendingStaleOutputsCleanup;
-  }
   async build() {
-    Logger.header(`${tsLogo} tsbuild v${"1.8.10"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
+    Logger.header(`${tsLogo} tsbuild v${"1.9.1"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const buildCache = this.configuration.buildCache;
-      const forcedForMinify = await (buildCache?.requiresRebuild(this.buildConfiguration.minify) ?? Promise.resolve(false));
-      const force = this.configuration.tsbuild.force || forcedForMinify;
+      const currentFingerprint = buildFingerprint(this.buildConfiguration, this.configuration.compilerOptions);
+      const fingerprintMatched = buildCache !== void 0 && await buildCache.fingerprintMatches(currentFingerprint);
+      const force = this.configuration.tsbuild.force || !fingerprintMatched;
       const cleanEnabled = this.configuration.clean && !this.configuration.compilerOptions.noEmit;
       const useManifest = cleanEnabled && buildCache !== void 0 && buildCache.hasPersistedManifest();
       const previousOutputs = useManifest ? buildCache.getPreviousOutputs() : void 0;
@@ -2728,13 +2723,11 @@ var _TypeScriptProject = class _TypeScriptProject {
           newOutputs.push(path);
         }
       }
-      this.fileManager.persistCache(this.buildConfiguration.minify);
+      this.fileManager.persistCache(currentFingerprint, !fingerprintMatched);
       if (buildCache !== void 0 && newOutputs.length > 0) {
         if (previousOutputs !== void 0) {
           this.cleanupStaleOutputs(previousOutputs, newOutputs);
         }
-        void buildCache.saveMinifyState(this.buildConfiguration.minify).catch(() => {
-        });
         void buildCache.saveOutputs(newOutputs).catch(() => {
         });
       }
@@ -2799,11 +2792,11 @@ var _TypeScriptProject = class _TypeScriptProject {
     }
     plugins.push(outputPlugin());
     if (this.buildConfiguration.noExternal.length > 0) {
-      plugins.push(externalModulesPlugin({ dependencies: await this.getProjectDependencyPaths(), noExternal: this.buildConfiguration.noExternal }));
+      plugins.push(externalModulesPlugin({ dependencies: await this.dependencyPaths, noExternal: this.buildConfiguration.noExternal }));
     }
     if (this.configuration.compilerOptions.emitDecoratorMetadata) {
       try {
-        const { swcDecoratorMetadataPlugin } = await import("./5DXLYKZU.js");
+        const { swcDecoratorMetadataPlugin } = await import("./3ZUONNU3.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");
@@ -2869,8 +2862,8 @@ var _TypeScriptProject = class _TypeScriptProject {
         }
       }
       const writtenFiles = [];
-      for (const [outputPath, { bytes }] of Object.entries(outputs)) {
-        writtenFiles.push({ path: outputPath, size: bytes });
+      for (const outputPath in outputs) {
+        writtenFiles.push({ path: outputPath, size: outputs[outputPath].bytes });
       }
       if (iife) {
         writtenFiles.push(...iife.files);
@@ -3025,7 +3018,19 @@ var _TypeScriptProject = class _TypeScriptProject {
         // Auto-inject 'node' only on Node platform — browser/neutral builds shouldn't pay the
         // cost of loading @types/node (~3 MB of declarations). Users can still opt in by
         // listing 'node' explicitly in their tsconfig types array.
-        types: platform2 === Platform.NODE ? [.../* @__PURE__ */ new Set(["node", ...configResult.config.compilerOptions?.types ?? [], ...typeScriptOptions.compilerOptions?.types ?? []])] : [.../* @__PURE__ */ new Set([...configResult.config.compilerOptions?.types ?? [], ...typeScriptOptions.compilerOptions?.types ?? []])]
+        types: (() => {
+          const typesSet = /* @__PURE__ */ new Set();
+          if (platform2 === Platform.NODE) {
+            typesSet.add("node");
+          }
+          for (const t of configResult.config.compilerOptions?.types ?? []) {
+            typesSet.add(t);
+          }
+          for (const t of typeScriptOptions.compilerOptions?.types ?? []) {
+            typesSet.add(t);
+          }
+          return Array.from(typesSet);
+        })()
       }
     };
     const { options, fileNames, errors } = parseJsonConfigFileContent(baseConfig, sys2, directory);
@@ -3066,14 +3071,6 @@ var _TypeScriptProject = class _TypeScriptProject {
     }
     return expandedEntryPoints;
   }
-  /**
-   * Gets the project dependency paths.
-   * The promise is started in the constructor so it overlaps with TS Program creation.
-   * @returns A promise that resolves to an array of project dependency paths.
-   */
-  getProjectDependencyPaths() {
-    return this.dependencyPaths;
-  }
   /**
    * Handles build errors by logging unexpected errors and setting appropriate exit codes.
    * Expected build failures (TypeCheckError, BundleError) are already logged when they occur,

package/dist/{QL4XMDMJ.js → XTZ3MYA7.js}

@@ -130,25 +130,22 @@ var Paths = class {
   }
   /**
    * Computes the absolute path by joining the provided segments.
-   * @param paths Array of path segments to join
-   * @returns The absolute path
+   * @param paths Array of path segments to join.
    */
   static absolute(...paths) {
     return resolve(...paths);
   }
   /**
    * Computes the relative path from one location to another.
-   * @param from The starting location
-   * @param to The target location
-   * @returns The relative path
+   * @param from The starting location.
+   * @param to The target location.
    */
   static relative(from, to) {
     return relative(from, to);
   }
   /**
-   * Returns the directory name of a path.
-   * @param path - The path to evaluate
-   * @returns The directory name of the path
+   * Parses a path string into its component parts.
+   * @param path The path to parse.
    */
   static parse(path) {
     return parse(path);
@@ -157,7 +154,6 @@ var Paths = class {
    * Checks if the given path is a directory.
    * Returns false if the path does not exist.
    * @param path - The path to check
-   * @returns True if the path is a directory, false otherwise
    */
   static async isDirectory(path) {
     try {
@@ -173,7 +169,6 @@ var Paths = class {
    * Checks if the given path is a file.
    * Returns false if the path does not exist.
    * @param path - The path to check
-   * @returns True if the path is a file, false otherwise
    */
   static async isFile(path) {
     try {
@@ -236,7 +231,6 @@ var Json = class {
   /**
    * Parse a JSON string into an object of type T.
    * @param jsonString The JSON string to parse.
-   * @returns The parsed object of type T.
    */
   static parse(jsonString) {
     return JSON.parse(jsonString);
@@ -244,7 +238,6 @@ var Json = class {
   /**
    * Serialize an object of type T into a JSON string.
    * @param data The object to serialize.
-   * @returns The serialized JSON string.
    */
   static serialize(data) {
     return JSON.stringify(data);

package/dist/tsbuild.js

@@ -2,8 +2,8 @@
 import {
   BuildError,
   TypeScriptProject
-} from "./4JXWHUXF.js";
-import "./QL4XMDMJ.js";
+} from "./7G6BAIKH.js";
+import "./XTZ3MYA7.js";
 
 // src/tsbuild.ts
 import { sys } from "typescript";
@@ -27,19 +27,19 @@ if (help) {
     console.log(`  ${`-${short}, --${long}`.padEnd(20)} ${description}`);
   }
   console.log();
-  process.exit(0);
-}
-if (version) {
-  console.log("1.8.10");
-  process.exit(0);
-}
-var typeScriptOptions = {
-  clearCache: args.clearCache,
-  compilerOptions: { noEmit: args.noEmit },
-  tsbuild: { force: args.force, minify: args.minify, watch: { enabled: args.watch } }
-};
-try {
-  await new TypeScriptProject(args.project, typeScriptOptions).build();
-} catch (error) {
-  process.exitCode = error instanceof BuildError ? error.code : 1;
+  process.exitCode = 0;
+} else if (version) {
+  console.log("1.9.1");
+  process.exitCode = 0;
+} else {
+  const typeScriptOptions = {
+    clearCache: args.clearCache,
+    compilerOptions: { noEmit: args.noEmit },
+    tsbuild: { force: args.force, minify: args.minify, watch: { enabled: args.watch } }
+  };
+  try {
+    await new TypeScriptProject(args.project, typeScriptOptions).build();
+  } catch (error) {
+    process.exitCode = error instanceof BuildError ? error.code : 1;
+  }
 }

package/dist/type-script-project.d.ts

@@ -129,11 +129,9 @@ type BuildOptions = {
     project?: Path;
     /** Force a full rebuild, even if no files have changed. Applicable for incremental builds */
     force?: boolean;
-    /** Entry points for the build */
     entryPoints?: EntryPoints<RelativePath>;
     /** Platform target. Auto-detected from tsconfig lib (DOM = browser, no DOM = node) */
     platform?: 'browser' | 'node' | 'neutral';
-    /** Whether to bundle source files together */
     bundle?: boolean;
     /** Remove all files from the output directory before building. Defaults to true */
     clean?: boolean;
@@ -143,21 +141,14 @@ type BuildOptions = {
     external?: Pattern[];
     /** Specific dependencies to bundle (override packages setting) */
     noExternal?: Pattern[];
-    /** Enable code splitting */
     splitting?: boolean;
-    /** Minify the output */
     minify?: boolean;
     /** Source map options. Overrides the value in tsconfig.json CompilerOptions */
     sourceMap?: boolean | 'inline' | 'external' | 'both';
-    /** Banner to inject at the start of output files */
     banner?: BannerOrFooter;
-    /** Footer to inject at the end of output files */
     footer?: BannerOrFooter;
-    /** Environment variables to inject */
     env?: Record<string, string>;
-    /** Declaration bundling configuration */
     dts?: DtsOptions;
-    /** Watch mode configuration */
     watch?: WatchOptions;
     /** Emit decorator metadata (requires `@swc/core` as optional dependency) */
     decoratorMetadata?: boolean;
@@ -196,7 +187,6 @@ type TypeScriptOptions = {
 };
 /** Cached declaration file with pre-processed code and extracted references */
 type CachedDeclaration = {
-    /** Pre-processed declaration code */
     code: string;
     /** Triple-slash type reference directives extracted during pre-processing */
     typeReferences: ReadonlySet<string>;
@@ -209,20 +199,14 @@ type BuildCache = {
     version: number;
     /** Cached declaration files: path -> pre-processed code with extracted references */
     files: Map<string, CachedDeclaration>;
-    /** Minify mode of the last successful JS output generation */
-    minify?: boolean;
+    /** Build configuration fingerprint: hash of output-affecting options (minify, iife, declaration, platform, etc.) */
+    fingerprint?: string;
 };
-/** Interface for build cache operations */
 interface BuildCacheManager {
-    /** Invalidates the build cache */
     invalidate(): void;
-    /** Restores cached declaration files into the provided map */
     restore(target: Map<string, CachedDeclaration>): Promise<void>;
-    /** Saves declaration files to the cache */
-    save(source: ReadonlyMap<string, CachedDeclaration>, minify: boolean): Promise<void>;
-    /** Checks if the cache is valid */
+    save(source: ReadonlyMap<string, CachedDeclaration>, fingerprint: string): Promise<void>;
     isValid(): boolean;
-    /** Checks if a file path is the TypeScript build info file */
     isBuildInfoFile(filePath: AbsolutePath): boolean;
     /** Synchronously checks whether persisted incremental state exists on disk (i.e. .tsbuildinfo). */
     hasPersistedState(): boolean;
@@ -232,24 +216,18 @@ interface BuildCacheManager {
     getPreviousOutputs(): readonly string[] | undefined;
     /** Persists the project-relative output paths produced by the current build. Fire-and-forget. */
     saveOutputs(outputs: readonly string[]): Promise<void>;
-    /** Checks whether current minify mode requires forcing a rebuild. */
-    requiresRebuild(minify: boolean): Promise<boolean>;
-    /** Persists minify mode metadata for future incremental-build compatibility checks. */
-    saveMinifyState(minify: boolean): Promise<void>;
+    /** Checks whether the build configuration has changed since the cache was last saved. */
+    fingerprintMatches(currentFingerprint: string): Promise<boolean>;
 }
 type TypeScriptConfiguration = Readonly<Modify<TypeScriptOptions, {
     clean: boolean;
     compilerOptions: TypeScriptCompilerConfiguration;
     tsbuild: BuildConfiguration;
-    /** Project root directory */
     directory: AbsolutePath;
     /** Absolute paths of root names used to create the TypeScript program */
     rootNames: string[];
-    /** Diagnostics encountered while parsing the config file */
     configFileParsingDiagnostics: Diagnostic[];
-    /** Build cache instance for incremental builds */
     buildCache: BuildCacheManager | undefined;
-    /** Module Specifiers in 'include', 'exclude', & 'files' */
     include?: string[];
     exclude?: string[];
     files?: string[];
@@ -329,11 +307,6 @@ declare class TypeScriptProject implements Closable {
      * @param current - Project-relative paths produced by the current build
      */
     private cleanupStaleOutputs;
-    /**
-     * Waits for fire-and-forget stale-output cleanup to settle.
-     * Useful for deterministic tests that need to assert post-cleanup filesystem state.
-     */
-    flushBackgroundCleanup(): Promise<void>;
     /**
      * Builds the project
      * @returns A promise that resolves when the build is complete.
@@ -383,12 +356,6 @@ declare class TypeScriptProject implements Closable {
      * @returns A promise that resolves to the entry points.
      */
     private getEntryPoints;
-    /**
-     * Gets the project dependency paths.
-     * The promise is started in the constructor so it overlaps with TS Program creation.
-     * @returns A promise that resolves to an array of project dependency paths.
-     */
-    private getProjectDependencyPaths;
     /**
      * Handles build errors by logging unexpected errors and setting appropriate exit codes.
      * Expected build failures (TypeCheckError, BundleError) are already logged when they occur,

package/dist/type-script-project.js

@@ -1,7 +1,7 @@
 import {
   TypeScriptProject
-} from "./4JXWHUXF.js";
-import "./QL4XMDMJ.js";
+} from "./7G6BAIKH.js";
+import "./XTZ3MYA7.js";
 export {
   TypeScriptProject
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/tsbuild",
   "author": "D1g1talEntr0py",
-  "version": "1.8.10",
+  "version": "1.9.1",
   "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": ">=22.0.0"
+    "node": ">=22.6.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -45,23 +45,23 @@
   },
   "dependencies": {
     "@d1g1tal/watchr": "^1.0.6",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.1",
     "magic-string": "^0.30.21"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.9.1",
-    "@typescript-eslint/eslint-plugin": "^8.59.4",
-    "@typescript-eslint/parser": "^8.59.4",
-    "@vitest/coverage-v8": "^4.1.7",
-    "eslint": "^10.4.0",
-    "eslint-plugin-jsdoc": "^63.0.0",
+    "@types/node": "^25.9.3",
+    "@typescript-eslint/eslint-plugin": "^8.61.0",
+    "@typescript-eslint/parser": "^8.61.0",
+    "@vitest/coverage-v8": "^4.1.8",
+    "eslint": "^10.5.0",
+    "eslint-plugin-jsdoc": "^63.0.2",
     "fs-monkey": "^1.1.0",
-    "memfs": "^4.57.2",
+    "memfs": "^4.57.7",
     "mitata": "^1.0.34",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.4",
-    "vitest": "^4.1.7"
+    "typescript-eslint": "^8.61.0",
+    "vitest": "^4.1.8"
   },
   "peerDependencies": {
     "typescript": ">=5.6.3"