@d1g1tal/tsbuild 1.8.9 → 1.9.0

package/CHANGELOG.md

@@ -1,3 +1,99 @@
+## [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
+
+* **cache:** fix minify state caching and rename manager interfaces (a66c98ec190b7398b2a9a81d9b02bbf36617c8e4)
+- Added `latestFiles` field to prevent `saveMinifyState()` from overwriting concurrent build declarations
+- Updated `save()` signature to accept and persist `minify: boolean` correctly
+- Fixed `saveMinifyState()` to empty its Map when invalidated, avoiding stale cache writes
+- Updated rebuild forcing logic to trigger when minify mode differs in either direction
+- Renamed `shouldForceForMinify` to `requiresRebuild`
+- Renamed cache types to `BuildCache` and `BuildCacheManager` for clearer API boundaries
+- Propagated minify configuration arguments into `FileManager` and `TypeScriptProject`
+- Added thorough regression tests for incremental cache behaviors and minify configurations
+
+* **iife:** forward minify option to secondary esbuild call (bec434d1ab86ef2de1b3defdc2922fda9cb62890)
+- Captured the minify option from build.initialOptions in iifePlugin
+- Passed the minify parameter down through buildIife() hook
+- Enabled minify inside secondary esbuild configurations when requested
+- Added plugin tests to ensure minify toggles are correctly respected for true and false
+
+
+### Miscellaneous Chores
+
+* **ci:** Update GitHub Actions to latest version (68c227fadab5d71d40afb6c965eeb91139294261)
+
+### Tests
+
+* **core:** improve watch mode and fix diverse testing warnings (b30822589036113be622c655e9a8f995a0f78992)
+- Replaced private method watch() calls with project.build() in integration tests alongside setImmediate flush
+- Added `@d1g1tal/watchr` vi.mock stub to enable integration testing isolation
+- Removed leftover `process.exit()` spies
+- Improved object indexing semantics (dot vs bracket notation) safely ignoring TypeScript index issues in tsbuild.test.ts and benchmark.ts
+- Added assertions via `.toBeDefined()` and updated mock object casting mechanisms
+- Updated `tsconfig.json` to properly traverse and handle local `src/@types` directory
+
+
+### Build System
+
+* **deps:** update dependencies to latest (c7fc745a1f61ad92c3e9328e6e187fdbb8d29348)
+- Updated @types/node, @typescript-eslint plugins, @vitest tools, and eslint-plugin-jsdoc to latest versions in package.json
+- Updated object-deep-merge, postcss, and semver to their latest versions
+- Refreshed pnpm-lock.yaml to lock all dependency updates
+
 ## [1.8.9](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.8.8...v1.8.9) (2026-05-18)
 
 ### 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/{QXXMXCRU.js → S3D7UW6Z.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;
@@ -1676,12 +1661,13 @@ function iifePlugin(options) {
         }
         build.initialOptions.write = false;
         const sourcemap = build.initialOptions.sourcemap;
+        const minify = build.initialOptions.minify;
         const entryPointNames = extractEntryNames(build.initialOptions.entryPoints);
         build.onEnd(async ({ outputFiles }) => {
           if (!outputFiles || outputFiles.length === 0 || entryPointNames.length === 0) {
             return;
           }
-          files.push(...await buildIife(outputFiles, entryPointNames, outdir, options?.globalName, sourcemap));
+          files.push(...await buildIife(outputFiles, entryPointNames, outdir, options?.globalName, sourcemap, minify));
         });
       }
     }
@@ -1746,7 +1732,7 @@ ${text.slice(0, exportStart)}
 	${assignment}
 })();${text.slice(exportEnd)}`;
 }
-async function buildIife(primaryOutputs, entryPointNames, outdir, globalName, sourcemap) {
+async function buildIife(primaryOutputs, entryPointNames, outdir, globalName, sourcemap, minify) {
   const { build: esbuild } = await import("esbuild");
   const fileContents = /* @__PURE__ */ new Map();
   const primaryWrites = [];
@@ -1787,6 +1773,7 @@ async function buildIife(primaryOutputs, entryPointNames, outdir, globalName, so
       splitting: false,
       outdir: iifeOutdir,
       sourcemap: sourcemapValue,
+      minify,
       write: false,
       logLevel: "warning",
       plugins
@@ -1880,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;
@@ -1904,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);
@@ -1952,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) => {
@@ -2143,17 +2126,20 @@ 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.
+   * (and Brotli compression for the dts cache) don't compete with esbuild for libuv threadpool slots.
+   * @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() {
+  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));
+    if (this.cache !== void 0 && (this.hasEmittedFiles || configChanged)) {
+      tasks.push(this.cache.save(this.declarationFiles, fingerprint));
     }
     if (tasks.length === 0) {
       return;
@@ -2311,6 +2297,8 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
   outputsSnapshot;
   /** Set to true when invalidate() is called to prevent stale cache from being restored */
   invalidated = false;
+  /** 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
@@ -2331,7 +2319,10 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
   async loadCache() {
     try {
       const cache = await Files.readCompressed(this.cacheFilePath);
-      return cache.version === dtsCacheVersion ? cache : void 0;
+      if (cache.version !== dtsCacheVersion) {
+        return void 0;
+      }
+      return cache;
     } catch {
       return void 0;
     }
@@ -2356,12 +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 fingerprint - Deterministic hash of build configuration for cache invalidation on config change
    */
-  async save(source) {
-    await Files.writeCompressed(this.cacheFilePath, { version: dtsCacheVersion, files: source });
+  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.
@@ -2395,6 +2407,13 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
     await mkdir4(this.cacheDirectoryPath, defaultDirOptions);
     await writeFile4(this.outputsManifestPath, JSON.stringify(this.outputsSnapshot), "utf8");
   }
+  /**
+   * 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;
+  }
   /** Invalidates the build cache by removing the cache directory. */
   invalidate() {
     this.invalidated = true;
@@ -2411,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,
@@ -2561,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 {
@@ -2594,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(() => []);
   }
   /**
@@ -2650,11 +2691,13 @@ var _TypeScriptProject = class _TypeScriptProject {
     await this.pendingStaleOutputsCleanup;
   }
   async build() {
-    Logger.header(`${tsLogo} tsbuild v${"1.8.9"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
+    Logger.header(`${tsLogo} tsbuild v${"1.9.0"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const buildCache = this.configuration.buildCache;
-      const force = this.configuration.tsbuild.force;
+      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;
@@ -2687,7 +2730,7 @@ var _TypeScriptProject = class _TypeScriptProject {
           newOutputs.push(path);
         }
       }
-      this.fileManager.persistCache();
+      this.fileManager.persistCache(currentFingerprint, !fingerprintMatched);
       if (buildCache !== void 0 && newOutputs.length > 0) {
         if (previousOutputs !== void 0) {
           this.cleanupStaleOutputs(previousOutputs, newOutputs);
@@ -2760,7 +2803,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     }
     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");
@@ -2826,8 +2869,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);
@@ -2982,7 +3025,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);

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 "./QXXMXCRU.js";
-import "./QL4XMDMJ.js";
+} from "./S3D7UW6Z.js";
+import "./XTZ3MYA7.js";
 
 // src/tsbuild.ts
 import { sys } from "typescript";
@@ -30,7 +30,7 @@ if (help) {
   process.exit(0);
 }
 if (version) {
-  console.log("1.8.9");
+  console.log("1.9.0");
   process.exit(0);
 }
 var typeScriptOptions = {

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

@@ -53,6 +53,7 @@ type PerformanceEntryDetail<T = unknown[]> = {
     message: string;
     result?: T;
     steps?: PerformanceSubStep[];
+    notes?: string[];
 };
 type DetailedPerformanceMeasureOptions<R> = Modify<PerformanceMeasureOptions, {
     detail: PerformanceEntryDetail<R>;
@@ -128,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;
@@ -142,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;
@@ -195,24 +187,26 @@ 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>;
     /** Triple-slash file reference directives extracted during pre-processing */
     fileReferences: ReadonlySet<string>;
 };
-/** Interface for build cache operations */
-interface BuildCache {
-    /** Invalidates the build cache */
+/** Persistent cache payload stored in .tsbuild/dts_cache.v8.br */
+type BuildCache = {
+    /** Cache format version for compatibility checking */
+    version: number;
+    /** Cached declaration files: path -> pre-processed code with extracted references */
+    files: Map<string, CachedDeclaration>;
+    /** Build configuration fingerprint: hash of output-affecting options (minify, iife, declaration, platform, etc.) */
+    fingerprint?: string;
+};
+interface BuildCacheManager {
     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>): 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;
@@ -222,20 +216,18 @@ interface BuildCache {
     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 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: BuildCache | undefined;
-    /** Module Specifiers in 'include', 'exclude', & 'files' */
+    buildCache: BuildCacheManager | undefined;
     include?: string[];
     exclude?: string[];
     files?: string[];
@@ -392,4 +384,4 @@ declare class TypeScriptProject implements Closable {
 }
 
 export { Plugin, TypeScriptProject };
-export type { AbsolutePath, AsyncEntryPoints, Brand, BuildCache, BuildConfiguration, CachedDeclaration, Closable, ClosableConstructor, CompilerOptionOverrides, ConditionalPath, DetailedPerformanceEntry, DetailedPerformanceMeasureOptions, EntryPoints, EsTarget, Fn, FormatSupplier, IifeOptions, InferredFunction, JsonString, JsxRenderingMode, LogEntryType, MethodFunction, OptionalReturn, Path, Pattern, PendingFileChange, PerformanceSubStep, PluginReference, ProjectBuildConfiguration, ProjectDependencies, ReadConfigResult, RelativePath, SourceMap, TypeScriptConfiguration, TypeScriptOptions, TypedFunction, WrittenFile };
+export type { AbsolutePath, AsyncEntryPoints, Brand, BuildCache, BuildCacheManager, BuildConfiguration, CachedDeclaration, Closable, ClosableConstructor, CompilerOptionOverrides, ConditionalPath, DetailedPerformanceEntry, DetailedPerformanceMeasureOptions, EntryPoints, EsTarget, Fn, FormatSupplier, IifeOptions, InferredFunction, JsonString, JsxRenderingMode, LogEntryType, MethodFunction, OptionalReturn, Path, Pattern, PendingFileChange, PerformanceSubStep, PluginReference, ProjectBuildConfiguration, ProjectDependencies, ReadConfigResult, RelativePath, SourceMap, TypeScriptConfiguration, TypeScriptOptions, TypedFunction, WrittenFile };

package/dist/type-script-project.js

@@ -1,7 +1,7 @@
 import {
   TypeScriptProject
-} from "./QXXMXCRU.js";
-import "./QL4XMDMJ.js";
+} from "./S3D7UW6Z.js";
+import "./XTZ3MYA7.js";
 export {
   TypeScriptProject
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/tsbuild",
   "author": "D1g1talEntr0py",
-  "version": "1.8.9",
+  "version": "1.9.0",
   "license": "MIT",
   "description": "A fast, ESM-only TypeScript build tool combining the TypeScript API for type checking and declaration generation, esbuild for bundling, and SWC for decorator metadata.",
   "homepage": "https://github.com/D1g1talEntr0py/tsbuild#readme",
@@ -50,18 +50,18 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.8.0",
-    "@typescript-eslint/eslint-plugin": "^8.59.3",
-    "@typescript-eslint/parser": "^8.59.3",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@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": "^62.9.0",
+    "eslint-plugin-jsdoc": "^63.0.0",
     "fs-monkey": "^1.1.0",
     "memfs": "^4.57.2",
     "mitata": "^1.0.34",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.3",
-    "vitest": "^4.1.6"
+    "typescript-eslint": "^8.59.4",
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "typescript": ">=5.6.3"