@d1g1tal/tsbuild 1.8.9 → 1.8.10

package/CHANGELOG.md

@@ -1,3 +1,46 @@
+## [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/dist/{QXXMXCRU.js → 4JXWHUXF.js}

@@ -1676,12 +1676,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 +1747,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 +1788,7 @@ async function buildIife(primaryOutputs, entryPointNames, outdir, globalName, so
       splitting: false,
       outdir: iifeOutdir,
       sourcemap: sourcemapValue,
+      minify,
       write: false,
       logLevel: "warning",
       plugins
@@ -2143,17 +2145,17 @@ 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 minify Whether the current build is minified, for future cache compatibility checks
    */
-  persistCache() {
+  persistCache(minify) {
     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));
+      tasks.push(this.cache.save(this.declarationFiles, minify));
     }
     if (tasks.length === 0) {
       return;
@@ -2309,8 +2311,12 @@ 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;
   /**
    * Creates a new build cache instance and begins pre-loading the cache asynchronously.
    * @param projectRoot - Root directory of the project
@@ -2323,6 +2329,7 @@ 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.
@@ -2331,7 +2338,11 @@ 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;
+      }
+      this.minifySnapshot = cache.minify;
+      return cache;
     } catch {
       return void 0;
     }
@@ -2359,9 +2370,13 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
    * Saves declaration files to the compressed cache file with version 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.
    */
-  async save(source) {
-    await Files.writeCompressed(this.cacheFilePath, { version: dtsCacheVersion, files: source });
+  async save(source, minify) {
+    this.latestFiles = source;
+    this.minifySnapshot = minify;
+    await Files.writeCompressed(this.cacheFilePath, { version: dtsCacheVersion, files: source, minify });
   }
   /**
    * Loads the previous build's output manifest synchronously.
@@ -2395,6 +2410,31 @@ var IncrementalBuildCache = class _IncrementalBuildCache {
     await mkdir4(this.cacheDirectoryPath, defaultDirOptions);
     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
+   */
+  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 });
+  }
   /** Invalidates the build cache by removing the cache directory. */
   invalidate() {
     this.invalidated = true;
@@ -2650,11 +2690,12 @@ 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.8.10"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const buildCache = this.configuration.buildCache;
-      const force = this.configuration.tsbuild.force;
+      const forcedForMinify = await (buildCache?.requiresRebuild(this.buildConfiguration.minify) ?? Promise.resolve(false));
+      const force = this.configuration.tsbuild.force || forcedForMinify;
       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,11 +2728,13 @@ var _TypeScriptProject = class _TypeScriptProject {
           newOutputs.push(path);
         }
       }
-      this.fileManager.persistCache();
+      this.fileManager.persistCache(this.buildConfiguration.minify);
       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(() => {
         });
       }

package/dist/tsbuild.js

@@ -2,7 +2,7 @@
 import {
   BuildError,
   TypeScriptProject
-} from "./QXXMXCRU.js";
+} from "./4JXWHUXF.js";
 import "./QL4XMDMJ.js";
 
 // src/tsbuild.ts
@@ -30,7 +30,7 @@ if (help) {
   process.exit(0);
 }
 if (version) {
-  console.log("1.8.9");
+  console.log("1.8.10");
   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>;
@@ -202,14 +203,23 @@ type CachedDeclaration = {
     /** Triple-slash file reference directives extracted during pre-processing */
     fileReferences: ReadonlySet<string>;
 };
+/** 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>;
+    /** Minify mode of the last successful JS output generation */
+    minify?: boolean;
+};
 /** Interface for build cache operations */
-interface BuildCache {
+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>): Promise<void>;
+    save(source: ReadonlyMap<string, CachedDeclaration>, minify: boolean): Promise<void>;
     /** Checks if the cache is valid */
     isValid(): boolean;
     /** Checks if a file path is the TypeScript build info file */
@@ -222,6 +232,10 @@ 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 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>;
 }
 type TypeScriptConfiguration = Readonly<Modify<TypeScriptOptions, {
     clean: boolean;
@@ -234,7 +248,7 @@ type TypeScriptConfiguration = Readonly<Modify<TypeScriptOptions, {
     /** Diagnostics encountered while parsing the config file */
     configFileParsingDiagnostics: Diagnostic[];
     /** Build cache instance for incremental builds */
-    buildCache: BuildCache | undefined;
+    buildCache: BuildCacheManager | undefined;
     /** Module Specifiers in 'include', 'exclude', & 'files' */
     include?: string[];
     exclude?: string[];
@@ -392,4 +406,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,6 +1,6 @@
 import {
   TypeScriptProject
-} from "./QXXMXCRU.js";
+} from "./4JXWHUXF.js";
 import "./QL4XMDMJ.js";
 export {
   TypeScriptProject

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/tsbuild",
   "author": "D1g1talEntr0py",
-  "version": "1.8.9",
+  "version": "1.8.10",
   "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"