@d1g1tal/tsbuild 1.7.5 → 1.8.0

package/CHANGELOG.md

@@ -1,3 +1,35 @@
+## [1.8.0](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.7.5...v1.8.0) (2026-04-09)
+
+### Features
+
+* **build:** add support for esbuild plugins and iife output (b4ffefbf01e0b3c1bb017f9ce0f87608235c9a6b)
+- add iife plugin to generate iife bundle
+- add resolve-plugin to resolve string/tuple plugin options to plugin instances
+- update type definitions for BuildOptions and create PluginReference type
+- update json schema to support new plugin format and iife options
+- register plugins during build
+
+
+### Miscellaneous Chores
+
+* **deps:** remove overrides from package.json and update watchr package (7d87c0b207a76a17c37fb10df2d1686d5f23713b)
+* **deps:** update dependencies (142c13fff1425e477239ac7f8bdb0a8fcffd3c07)
+- update @types/node to ^25.5.2
+- update @typescript-eslint/eslint-plugin to ^8.58.1
+- update @typescript-eslint/parser to ^8.58.1
+- update @vitest/coverage-v8 to ^4.1.4
+- update typescript-eslint to ^8.58.1
+- update vitest to ^4.1.4
+- update various transitive dependencies in pnpm-lock.yaml
+
+
+### Tests
+
+* **plugins:** add tests for iife and resolve plugins (63371ebd3652831ae168a1fbc18f32d2d436707b)
+- add unit tests for iife plugin covering build options, entry point identification, virtual loader, and file output
+- add unit tests for resolve-plugin utility covering pass-through, string, tuple references, and error handling
+- add a test fixture for the iife plugin
+
 ## [1.7.5](https://github.com/D1g1talEntr0py/tsbuild/compare/v1.7.4...v1.7.5) (2026-04-07)
 
 ### Bug Fixes

package/dist/{5BZX3OK7.js → YKY7BYLQ.js}

@@ -106,7 +106,7 @@ var Files = class _Files {
    * @returns The decompressed buffer.
    */
   static decompressBuffer(buffer) {
-    return new Promise((resolve, reject) => brotliDecompress(buffer, (error, result) => error ? reject(error) : resolve(result)));
+    return new Promise((resolve3, reject) => brotliDecompress(buffer, (error, result) => error ? reject(error) : resolve3(result)));
   }
   /**
    * Compress data using Brotli compression.
@@ -115,7 +115,7 @@ var Files = class _Files {
    * @returns The compressed buffer.
    */
   static compressBuffer(buffer) {
-    return new Promise((resolve, reject) => brotliCompress(buffer, (error, result) => error ? reject(error) : resolve(result)));
+    return new Promise((resolve3, reject) => brotliCompress(buffer, (error, result) => error ? reject(error) : resolve3(result)));
   }
   /**
    * Load a file and deserialize it using V8 deserialization.
@@ -1467,6 +1467,190 @@ var externalModulesPlugin = ({ dependencies = [], noExternal = [] }) => {
   };
 };
 
+// src/plugins/resolve-plugin.ts
+import { resolve } from "node:path";
+function isPlugin(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  return "name" in value && typeof value.name === "string" && "setup" in value && typeof value.setup === "function";
+}
+function isFactory(value) {
+  return typeof value === "function";
+}
+async function resolveReference(reference, projectDir) {
+  const [specifier, options] = typeof reference === "string" ? [reference, void 0] : reference;
+  const resolved = Paths.isPath(specifier) ? resolve(projectDir, specifier) : specifier;
+  let module;
+  try {
+    module = await import(resolved);
+  } catch (error) {
+    throw new ConfigurationError(`Failed to load plugin "${specifier}": ${error instanceof Error ? error.message : String(error)}`);
+  }
+  const defaultExport = module.default;
+  if (defaultExport === void 0) {
+    throw new ConfigurationError(`Plugin "${specifier}" has no default export. The module must export a plugin factory function or Plugin object as its default export.`);
+  }
+  if (isFactory(defaultExport)) {
+    const result = defaultExport(options);
+    if (!isPlugin(result)) {
+      throw new ConfigurationError(`Plugin "${specifier}" factory did not return a valid esbuild Plugin (expected { name: string, setup: function }).`);
+    }
+    return result;
+  }
+  if (isPlugin(defaultExport)) {
+    if (options !== void 0) {
+      Logger.warn(`Plugin "${specifier}" is a Plugin object, not a factory function. The provided options will be ignored.`);
+    }
+    return defaultExport;
+  }
+  throw new ConfigurationError(`Plugin "${specifier}" default export is not a function or valid esbuild Plugin object.`);
+}
+async function resolvePlugins(plugins, projectDir) {
+  const resolved = [];
+  for (const entry of plugins) {
+    if (isPlugin(entry)) {
+      resolved.push(entry);
+    } else {
+      resolved.push(await resolveReference(entry, projectDir));
+    }
+  }
+  return resolved;
+}
+
+// src/plugins/iife.ts
+import { basename as basename2, dirname as dirname2, join, relative, resolve as resolve2 } from "node:path";
+import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
+import { build as esbuild } from "esbuild";
+var textDecoder2 = new TextDecoder();
+var jsExtension = ".js";
+function iifePlugin(options) {
+  const globalName = options?.globalName;
+  const files = [];
+  return {
+    files,
+    plugin: {
+      name: "esbuild:iife",
+      /**
+       * Configures the esbuild build instance to produce IIFE output
+       * @param build The esbuild build instance
+       */
+      setup(build) {
+        const outdir = build.initialOptions.outdir;
+        if (!outdir) {
+          return;
+        }
+        const sourcemap = build.initialOptions.sourcemap;
+        const entryPointNames = extractEntryNames(build.initialOptions.entryPoints);
+        build.onEnd(async ({ outputFiles }) => {
+          if (!outputFiles?.length || entryPointNames.length === 0) {
+            return;
+          }
+          const written = await buildIife(outputFiles, entryPointNames, outdir, globalName, sourcemap);
+          files.push(...written);
+        });
+      }
+    }
+  };
+}
+function extractEntryNames(entryPoints) {
+  if (!entryPoints) {
+    return [];
+  }
+  if (Array.isArray(entryPoints)) {
+    const names = [];
+    for (const entry of entryPoints) {
+      if (typeof entry === "string") {
+        names.push(basename2(entry).replace(/\.[^.]+$/, ""));
+      } else {
+        names.push(entry.out ?? basename2(entry.in).replace(/\.[^.]+$/, ""));
+      }
+    }
+    return names;
+  }
+  return Object.keys(entryPoints);
+}
+async function buildIife(outputFiles, entryPointNames, outdir, globalName, sourcemap) {
+  const fileContents = /* @__PURE__ */ new Map();
+  for (const file of outputFiles) {
+    if (file.path.endsWith(jsExtension)) {
+      fileContents.set(file.path, textDecoder2.decode(file.contents));
+    }
+  }
+  const entryPoints = {};
+  for (const name of entryPointNames) {
+    const absPath = join(outdir, name + jsExtension);
+    if (fileContents.has(absPath)) {
+      entryPoints[name] = absPath;
+    }
+  }
+  if (Object.keys(entryPoints).length === 0) {
+    return [];
+  }
+  const hasSourceMap = sourcemap !== void 0 && sourcemap !== false;
+  const iifeOutdir = join(outdir, "iife");
+  const { outputFiles: iifeFiles } = await esbuild({
+    entryPoints,
+    bundle: true,
+    format: "iife",
+    globalName,
+    splitting: false,
+    outdir: iifeOutdir,
+    sourcemap: hasSourceMap ? "external" : false,
+    write: false,
+    logLevel: "warning",
+    footer: globalName ? { js: `globalThis.${globalName} = ${globalName};` } : void 0,
+    plugins: [virtualLoaderPlugin(fileContents)]
+  });
+  const entryOutputs = /* @__PURE__ */ new Set();
+  for (const name of entryPointNames) {
+    entryOutputs.add(join(iifeOutdir, name + jsExtension));
+  }
+  await mkdir3(iifeOutdir, { recursive: true });
+  const written = [];
+  const writes = [];
+  for (const file of iifeFiles) {
+    const basePath = file.path.endsWith(".map") ? file.path.slice(0, -4) : file.path;
+    if (entryOutputs.has(basePath)) {
+      writes.push(writeFile3(file.path, file.contents));
+      written.push({ path: relative(process.cwd(), file.path), size: file.contents.byteLength });
+    }
+  }
+  await Promise.all(writes);
+  return written;
+}
+function virtualLoaderPlugin(fileContents) {
+  return {
+    name: "iife:virtual-loader",
+    /**
+     * Registers onResolve and onLoad hooks for virtual file loading
+     * @param build The esbuild build instance
+     */
+    setup(build) {
+      build.onResolve({ filter: /.*/ }, (args) => {
+        if (args.kind === "entry-point") {
+          return { path: args.path, namespace: "iife" };
+        }
+        if (!args.path.startsWith(".") && !args.path.startsWith("/")) {
+          return { external: true };
+        }
+        const resolved = resolve2(args.resolveDir, args.path);
+        if (fileContents.has(resolved)) {
+          return { path: resolved, namespace: "iife" };
+        }
+        return { external: true };
+      });
+      build.onLoad({ filter: /.*/, namespace: "iife" }, (args) => {
+        const contents = fileContents.get(args.path);
+        if (contents !== void 0) {
+          return { contents, loader: "js", resolveDir: dirname2(args.path) };
+        }
+        return null;
+      });
+    }
+  };
+}
+
 // src/process-manager.ts
 var ProcessEvent = {
   exit: "exit",
@@ -1650,7 +1834,7 @@ var _DebounceManager = class _DebounceManager {
     let timeoutId;
     let pendingResolve;
     return function(...args) {
-      return new Promise((resolve, reject) => {
+      return new Promise((resolve3, reject) => {
         if (timeoutId) {
           clearTimeout(timeoutId);
           _DebounceManager.timers.delete(timeoutId);
@@ -1658,13 +1842,13 @@ var _DebounceManager = class _DebounceManager {
         if (pendingResolve) {
           pendingResolve(void 0);
         }
-        pendingResolve = resolve;
+        pendingResolve = resolve3;
         timeoutId = setTimeout(() => {
           if (timeoutId) {
             _DebounceManager.timers.delete(timeoutId);
           }
           try {
-            resolve(func.apply(this, args));
+            resolve3(func.apply(this, args));
           } catch (error) {
             reject(castError(error));
           } finally {
@@ -2093,7 +2277,7 @@ function inferEntryPoints(packageJson, outDir, sourceDir = "src") {
 }
 
 // src/type-script-project.ts
-import { build as esbuild, formatMessages } from "esbuild";
+import { build as esbuild2, formatMessages } from "esbuild";
 import { performance as performance2 } from "node:perf_hooks";
 import { sys as sys2, createIncrementalProgram, formatDiagnostics, formatDiagnosticsWithColorAndContext, parseJsonConfigFileContent, readConfigFile, findConfigFile } from "typescript";
 var globCharacters = /[*?\\[\]!].*$/;
@@ -2137,7 +2321,7 @@ var _TypeScriptProject = class _TypeScriptProject {
     return Files.empty(this.buildConfiguration.outDir);
   }
   async build() {
-    Logger.header(`${tsLogo} tsbuild v${"1.7.5"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
+    Logger.header(`${tsLogo} tsbuild v${"1.8.0"}${this.configuration.compilerOptions.incremental && this.configuration.buildCache?.isValid() ? " [incremental]" : ""}`);
     try {
       const processes = [];
       const filesWereEmitted = await this.typeCheck();
@@ -2220,7 +2404,12 @@ var _TypeScriptProject = class _TypeScriptProject {
       }
     }
     if (this.buildConfiguration.plugins?.length) {
-      plugins.push(...this.buildConfiguration.plugins);
+      plugins.push(...await resolvePlugins(this.buildConfiguration.plugins, this.directory));
+    }
+    let iife;
+    if (this.buildConfiguration.iife) {
+      iife = iifePlugin(this.buildConfiguration.iife === true ? void 0 : this.buildConfiguration.iife);
+      plugins.push(iife.plugin);
     }
     const define = {};
     if (this.buildConfiguration.env !== void 0) {
@@ -2230,7 +2419,7 @@ var _TypeScriptProject = class _TypeScriptProject {
       }
     }
     try {
-      const { warnings, errors, metafile: { outputs } } = await esbuild({
+      const { warnings, errors, metafile: { outputs } } = await esbuild2({
         format,
         plugins,
         define,
@@ -2282,6 +2471,9 @@ var _TypeScriptProject = class _TypeScriptProject {
       for (const [outputPath, { bytes }] of Object.entries(outputs)) {
         writtenFiles.push({ path: outputPath, size: bytes });
       }
+      if (iife) {
+        writtenFiles.push(...iife.files);
+      }
       return writtenFiles;
     } catch (error) {
       Logger.error("Transpile failed", error);

package/dist/tsbuild.js

@@ -2,7 +2,7 @@
 import {
   BuildError,
   TypeScriptProject
-} from "./5BZX3OK7.js";
+} from "./YKY7BYLQ.js";
 import "./JKGYA2AW.js";
 
 // src/tsbuild.ts
@@ -30,7 +30,7 @@ if (help) {
   process.exit(0);
 }
 if (version) {
-  console.log("1.7.5");
+  console.log("1.8.0");
   process.exit(0);
 }
 var typeScriptOptions = {

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

@@ -104,6 +104,10 @@ type DtsOptions = {
     resolve?: boolean;
 };
 type DtsConfiguration = MarkRequired<DtsOptions, 'resolve'>;
+type IifeOptions = {
+    /** Global variable name for the IIFE bundle (e.g., 'MyLib' becomes `globalThis.MyLib`) */
+    globalName?: string;
+};
 type WatchOptions = PrettyModify<WatchrOptions, {
     enabled: boolean;
     recursive?: boolean;
@@ -156,9 +160,17 @@ type BuildOptions = {
     watch?: WatchOptions;
     /** Emit decorator metadata (requires `@swc/core` as optional dependency) */
     decoratorMetadata?: boolean;
-    /** Custom esbuild plugins */
-    plugins?: Plugin[];
+    /** Produce additional IIFE output alongside ESM. Set to `true` for default IIFE or provide options. */
+    iife?: boolean | IifeOptions;
+    /** Custom esbuild plugins (Plugin objects via programmatic API, or string/tuple references via config) */
+    plugins?: (Plugin | PluginReference)[];
 };
+/**
+ * A reference to an esbuild plugin resolved at build time.
+ * - `string` — bare npm specifier or relative path to a plugin module
+ * - `[string, Record<string, unknown>]` — module specifier with options passed to the factory function
+ */
+type PluginReference = string | [string, Record<string, unknown>];
 type BuildConfiguration = PrettyModify<MarkRequired<BuildOptions, 'entryPoints' | 'splitting' | 'minify' | 'bundle' | 'noExternal' | 'sourceMap'>, {
     watch: WatchConfiguration;
     dts: DtsConfiguration;
@@ -362,4 +374,4 @@ declare class TypeScriptProject implements Closable {
 }
 
 export { TypeScriptProject };
-export type { AbsolutePath, AsyncEntryPoints, Brand, BuildCache, BuildConfiguration, CachedDeclaration, Closable, ClosableConstructor, CompilerOptionOverrides, ConditionalPath, DetailedPerformanceEntry, DetailedPerformanceMeasureOptions, EntryPoints, EsTarget, Fn, FormatSupplier, InferredFunction, JsonString, JsxRenderingMode, LogEntryType, MethodFunction, OptionalReturn, Path, Pattern, PendingFileChange, PerformanceSubStep, ProjectBuildConfiguration, ProjectDependencies, ReadConfigResult, RelativePath, SourceMap, TypeScriptConfiguration, TypeScriptOptions, TypedFunction, WrittenFile };
+export type { AbsolutePath, AsyncEntryPoints, Brand, BuildCache, BuildConfiguration, CachedDeclaration, Closable, ClosableConstructor, CompilerOptionOverrides, ConditionalPath, DetailedPerformanceEntry, DetailedPerformanceMeasureOptions, EntryPoints, EsTarget, 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 "./5BZX3OK7.js";
+} from "./YKY7BYLQ.js";
 import "./JKGYA2AW.js";
 export {
   TypeScriptProject

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/tsbuild",
   "author": "D1g1talEntr0py",
-  "version": "1.7.5",
+  "version": "1.8.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",
@@ -44,24 +44,24 @@
     "tsbuild": "./dist/tsbuild.js"
   },
   "dependencies": {
-    "@d1g1tal/watchr": "^1.0.5",
+    "@d1g1tal/watchr": "^1.0.6",
     "esbuild": "^0.28.0",
     "magic-string": "^0.30.21"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/node": "^25.5.2",
-    "@typescript-eslint/eslint-plugin": "^8.58.0",
-    "@typescript-eslint/parser": "^8.58.0",
-    "@vitest/coverage-v8": "^4.1.3",
+    "@typescript-eslint/eslint-plugin": "^8.58.1",
+    "@typescript-eslint/parser": "^8.58.1",
+    "@vitest/coverage-v8": "^4.1.4",
     "eslint": "^10.2.0",
     "eslint-plugin-jsdoc": "^62.9.0",
     "fs-monkey": "^1.1.0",
     "memfs": "^4.57.1",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",
-    "typescript-eslint": "^8.58.0",
-    "vitest": "^4.1.3"
+    "typescript-eslint": "^8.58.1",
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
     "typescript": ">=5.6.3"

package/schema.json

@@ -193,6 +193,54 @@
             }
           },
           "additionalProperties": false
+        },
+        "plugins": {
+          "type": "array",
+          "markdownDescription": "Custom esbuild plugins to include in the build. Each entry is either:\n- A **string** — npm package name or relative path to a plugin module (default export must be a factory function or Plugin object)\n- A **tuple** `[string, object]` — module specifier with options passed to the factory function\n\nExample:\n```json\n\"plugins\": [\n  \"esbuild-plugin-copy\",\n  [\"esbuild-plugin-alias\", { \"aliases\": { \"@\": \"./src\" } }]\n]\n```",
+          "items": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "Plugin module specifier (npm package or relative path)"
+              },
+              {
+                "type": "array",
+                "description": "Plugin module specifier with options: [specifier, options]",
+                "items": false,
+                "prefixItems": [
+                  {
+                    "type": "string",
+                    "description": "Plugin module specifier (npm package or relative path)"
+                  },
+                  {
+                    "type": "object",
+                    "description": "Options passed to the plugin factory function",
+                    "additionalProperties": true
+                  }
+                ],
+                "minItems": 2,
+                "maxItems": 2
+              }
+            ]
+          }
+        },
+        "iife": {
+          "markdownDescription": "Produce additional IIFE (Immediately Invoked Function Expression) output alongside the primary ESM build.\n\nWhen enabled, each `.js` entry point is wrapped in an IIFE and written to an `iife/` subdirectory under the output directory.\n\nSet to `true` for default behavior, or provide an object with a `globalName` to assign exports to `globalThis`.\n\nExample:\n```json\n\"iife\": { \"globalName\": \"MyLib\" }\n```",
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "globalName": {
+                  "type": "string",
+                  "description": "Global variable name for the IIFE bundle (e.g., 'MyLib' becomes globalThis.MyLib)"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
         }
       }
     }