@d1g1tal/tsbuild 1.3.1 → 1.4.1

package/README.md

@@ -44,7 +44,24 @@ If `declaration` is not enabled, phase 2 is just the esbuild step.
 
 ## Quick Start
 
-The only thing tsbuild requires in `tsconfig.json` is an `outDir`. Everything else carries over from your existing config:
+The only thing tsbuild requires in `tsconfig.json` is an `outDir`. Everything else carries over from your existing config.
+
+### Minimal config — no `tsbuild` section needed
+
+```jsonc
+{
+  "compilerOptions": {
+    "outDir": "./dist"
+    // ... your existing TypeScript config
+  }
+}
+```
+
+Entry points are inferred from `package.json` automatically, and all dependencies are treated as external by default.
+
+### Bundle a specific package into the output
+
+By default, bare specifiers (e.g. `lodash-es`) are kept as external imports. Use `noExternal` to force a package to be inlined into the bundle:
 
 ```jsonc
 {
@@ -52,7 +69,59 @@ The only thing tsbuild requires in `tsconfig.json` is an `outDir`. Everything el
     "outDir": "./dist"
     // ... your existing TypeScript config
   },
-  "tsbuild": {} // entry points are inferred from package.json automatically
+  "tsbuild": {
+    "noExternal": ["evicting-cache"]  // bundle evicting-cache into the output instead of leaving it as an import
+  }
+}
+```
+
+### Preferred `tsconfig.json` setup — incremental (recommended)
+
+`incremental` defaults to `true` in tsbuild unless you explicitly set it to `false` in your `tsconfig.json`. With incremental enabled, TypeScript only re-emits changed files on each build and the declaration cache is preserved across runs, making repeated builds significantly faster.
+
+```jsonc
+{
+  "compilerOptions": {
+    "outDir": "./dist",
+    "declaration": true,
+    "incremental": true,           // redundant — tsbuild enables this by default, but explicit is clear
+    "isolatedDeclarations": true,  // recommended: enables faster parallel declaration emit
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Bundler", // recommended for library builds processed by a bundler
+    // lib controls platform detection — omitting "DOM" targets Node.js (platform: "node").
+    // Add "DOM" to target the browser (platform: "browser").
+    "lib": ["ESNext"]             // Node.js library — no DOM APIs
+    // "lib": ["ESNext", "DOM"]   // Browser library — includes DOM APIs, sets platform to "browser"
+  }
+}
+```
+
+### Preferred `tsconfig.json` setup — non-incremental
+
+Set `incremental: false` to opt out of the `.tsbuildinfo` cache entirely. Every build is a full compilation from scratch. Useful for CI environments where you want deterministic, cache-free output.
+
+```jsonc
+{
+  "compilerOptions": {
+    "outDir": "./dist",
+    "declaration": true,
+    "incremental": false,          // disables TypeScript's .tsbuildinfo cache and tsbuild's DTS cache
+    "isolatedDeclarations": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Bundler", // recommended for library builds processed by a bundler
+    // lib controls platform detection — omitting "DOM" targets Node.js (platform: "node").
+    // Add "DOM" to target the browser (platform: "browser").
+    "lib": ["ESNext"]             // Node.js library — no DOM APIs
+    // "lib": ["ESNext", "DOM"]   // Browser library — includes DOM APIs, sets platform to "browser"
+  }
 }
 ```
 

package/dist/{KY7JTF4C.js → TY4W6KLM.js}

@@ -1933,6 +1933,13 @@ var IncrementalBuildCache = class {
   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;
+  }
   /**
    * Custom inspection tag for type.
    * @returns The string 'IncrementalBuildCache'
@@ -2091,7 +2098,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     return Files.empty(this.buildConfiguration.outDir);
   }
   async build() {
-    Logger.header(`\u{1F680} tsbuild v${"1.3.1"}${this.configuration.compilerOptions.incremental ? " [incremental]" : ""}`);
+    Logger.header(`\u{1F680} tsbuild v${"1.4.1"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const filesWereEmitted = await this.typeCheck();
@@ -2322,7 +2329,11 @@ var _TypeScriptProject = class _TypeScriptProject {
         try {
           const pkgJson = JSON.parse(packageJsonContent);
           const outDir = typeScriptOptions.compilerOptions?.outDir ?? configResult.config.compilerOptions?.outDir ?? defaultOutDirectory;
+          const hasExportFields = pkgJson.exports !== void 0 || pkgJson.bin !== void 0 || pkgJson.main !== void 0 || pkgJson.module !== void 0;
           inferredEntryPoints = inferEntryPoints(pkgJson, outDir);
+          if (hasExportFields && inferredEntryPoints === void 0) {
+            Logger.warn(`Could not infer entry points from package.json exports (output paths do not match outDir "${outDir}"). Add explicit entryPoints to your tsconfig.json tsbuild configuration.`);
+          }
         } catch {
         }
       }
@@ -2389,7 +2400,7 @@ var _TypeScriptProject = class _TypeScriptProject {
       } else if (await Paths.isFile(resolvedPath)) {
         expandedEntryPoints[name] = resolvedPath;
       } else {
-        throw new ConfigurationError(`Entry point does not exist: ${entryPoint}`);
+        throw new ConfigurationError(`Entry point does not exist: ${entryPoint}. Add explicit entryPoints to your tsconfig.json tsbuild configuration.`);
       }
     }
     return expandedEntryPoints;

package/dist/index.d.ts

@@ -188,9 +188,15 @@ type CachedDeclaration = {
 };
 /** Interface for build cache operations */
 interface BuildCache {
+    /** 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>;
+    /** Checks if the cache is valid */
+    isValid(): boolean;
+    /** Checks if a file path is the TypeScript build info file */
     isBuildInfoFile(filePath: AbsolutePath): boolean;
 }
 type TypeScriptConfiguration = Readonly<PrettyModify<TypeScriptOptions, {

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   TypeScriptProject
-} from "./KY7JTF4C.js";
+} from "./TY4W6KLM.js";
 import "./7FPDHUPW.js";
 export {
   TypeScriptProject

package/dist/tsbuild.js

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

package/package.json

@@ -1,8 +1,30 @@
 {
   "name": "@d1g1tal/tsbuild",
-  "version": "1.3.1",
-  "packageManager": "pnpm@10.30.3",
+  "author": "D1g1talEntr0py",
+  "version": "1.4.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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/D1g1talEntr0py/tsbuild.git"
+  },
+  "bugs": {
+    "url": "https://github.com/D1g1talEntr0py/tsbuild/issues"
+  },
+  "maintainers": [
+    {
+      "name": "D1g1talEntr0py",
+      "email": "jason.dimeo@gmail.com"
+    }
+  ],
+  "engines": {
+    "node": ">=20.16.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
   "type": "module",
   "exports": {
     ".": {
@@ -12,47 +34,13 @@
   },
   "files": [
     "./dist",
-    "./schema.json"
+    "./schema.json",
+    "README.md",
+    "LICENSE"
   ],
   "bin": {
     "tsbuild": "./dist/tsbuild.js"
   },
-  "scripts": {
-    "prepare": "git config core.hooksPath .githooks",
-    "build": "tsx ./src/tsbuild.ts",
-    "build:watch": "tsx ./src/tsbuild.ts --watch",
-    "type-check": "tsx ./src/tsbuild.ts --noEmit",
-    "lint": "eslint ./src",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "pnpm lint && pnpm build"
-  },
-  "keywords": [
-    "typescript",
-    "build",
-    "bundler",
-    "esbuild",
-    "declarations",
-    "dts",
-    "esm"
-  ],
-  "author": "D1g1talEntr0py",
-  "license": "MIT",
-  "engines": {
-    "node": ">=20.16.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/D1g1talEntr0py/tsbuild.git"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public"
-  },
-  "bugs": {
-    "url": "https://github.com/D1g1talEntr0py/tsbuild/issues"
-  },
-  "homepage": "https://github.com/D1g1talEntr0py/tsbuild#readme",
   "dependencies": {
     "@d1g1tal/watchr": "1.0.0",
     "esbuild": "^0.27.3",
@@ -60,17 +48,34 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.5",
     "@typescript-eslint/eslint-plugin": "^8.56.1",
     "@typescript-eslint/parser": "^8.56.1",
     "@vitest/coverage-v8": "4.0.18",
-    "eslint": "^10.0.2",
+    "eslint": "^10.0.3",
     "eslint-plugin-jsdoc": "^62.7.1",
     "fs-monkey": "^1.1.0",
-    "memfs": "^4.56.10",
+    "memfs": "^4.56.11",
     "tsx": "^4.21.0",
     "typescript": "5.9.3",
     "typescript-eslint": "^8.56.1",
     "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "typescript",
+    "build",
+    "bundler",
+    "esbuild",
+    "declarations",
+    "dts",
+    "esm"
+  ],
+  "scripts": {
+    "build": "tsx ./src/tsbuild.ts",
+    "build:watch": "tsx ./src/tsbuild.ts --watch",
+    "type-check": "tsx ./src/tsbuild.ts --noEmit",
+    "lint": "eslint ./src",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
   }
-}
+}