unplugin-dts-bundle-generator 3.1.1 → 3.3.0

package/README.md

@@ -5,8 +5,9 @@
 [![Licence](https://img.shields.io/npm/l/unplugin-dts-bundle-generator)](./LICENCE)
 [![GitHub Actions](https://img.shields.io/github/actions/workflow/status/f-lawe/unplugin-dts-bundle-generator/pr-checks.yml)](https://github.com/f-lawe/unplugin-dts-bundle-generator/actions/workflows/pr-checks.yml)
 
-Ever wanted to easily package your typescript library with a bundled declaration file? Integrate [DTS Bundle Generator](https://github.com/timocov/dts-bundle-generator) within [Vite](https://github.com/vitejs/vite) or any other blundler supported by [Unplugin](https://github.com/unjs/unplugin)!
-(see available bundlers below)
+Ever wanted to easily package your typescript library with a bundled declaration file? Integrate [DTS Bundle Generator](https://github.com/timocov/dts-bundle-generator) within your favourite bundler thanks to [Unplugin](https://github.com/unjs/unplugin)!
+
+_(see available bundlers below)_
 
 ## Installation
 ```sh
@@ -18,22 +19,21 @@ yarn add --dev unplugin-dts-bundle-generator
 ```
 
 ## Usage
-Currently, only Vite and Rollup are fully supported, more bundlers to come. Please open a PR or an issue if you need another export and want to speed up the process, so we can work it out!
+Only those bundlers are supported at the moment:
 
 <details>
-<summary>Vite</summary><br>
+<summary>ESBuild</summary><br>
 
-With Vite, add this block to your `vite.config.ts`:
+With ESBuild, add this block when calling `esbuild.build()`:
 
 ```ts
-import path from 'node:path';
-import dtsBundleGenerator from 'unplugin-dts-bundle-generator/vite';
-import { defineConfig, normalizePath } from 'vite';
+import * as esbuild from 'esbuild';
+import dtsBundleGenerator from 'unplugin-dts-bundle-generator/rollup';
 
-export default defineConfig({
+await esbuild.build({
   plugins: [
     dtsBundleGenerator({
-      fileName: 'my-lib.d.ts',
+      outfile: 'my-lib.d.ts',
       output: {
         // output config
       },
@@ -43,19 +43,48 @@ export default defineConfig({
       compilation: {
         // compilation options
       }
-    })
+    }),
   ],
-  build: {
-    lib: {
-      entry: normalizePath('src/index.ts'),
-      formats: ['es'],
-      fileName: 'my-lib.js'
-    }
-  }
+  entryPoints: 'src/index.ts',
+  outfile: 'my-lib.js',
+  format: 'esm',
+  bundle: true,
 });
 ```
 <br></details>
 
+<details>
+<summary>Rolldown</summary><br>
+
+With Rolldown, add this block to your `rolldown.config.ts`:
+
+```ts
+import dtsBundleGenerator from 'unplugin-dts-bundle-generator/rolldown';
+
+export default {
+  plugins: [
+    dtsBundleGenerator({
+      file: 'my-lib.d.ts',
+      output: {
+        // output config
+      },
+      libraries: {
+        // libraries config
+      },
+      compilation: {
+        // compilation options
+      }
+    }),
+  ],
+  input: 'src/index.ts',
+  output: {
+    dir: 'dist',
+    format: 'es',
+  },
+};
+```
+<br></details>
+
 <details>
 <summary>Rollup</summary><br>
 
@@ -67,7 +96,7 @@ import dtsBundleGenerator from 'unplugin-dts-bundle-generator/rollup';
 export default {
   plugins: [
     dtsBundleGenerator({
-      fileName: 'my-lib.d.ts',
+      file: 'my-lib.d.ts',
       output: {
         // output config
       },
@@ -88,6 +117,46 @@ export default {
 ```
 <br></details>
 
+<details>
+<summary>Vite</summary><br>
+
+With Vite, add this block to your `vite.config.ts`:
+
+```ts
+import path from 'node:path';
+import dtsBundleGenerator from 'unplugin-dts-bundle-generator/vite';
+import { defineConfig, normalizePath } from 'vite';
+
+export default defineConfig({
+  plugins: [
+    dtsBundleGenerator({
+      fileName: 'my-lib.d.ts',
+      output: {
+        // output config
+      },
+      libraries: {
+        // libraries config
+      },
+      compilation: {
+        // compilation options
+      }
+    })
+  ],
+  build: {
+    lib: {
+      entry: normalizePath('src/index.ts'),
+      formats: ['es'],
+      fileName: 'my-lib.js'
+    }
+  }
+});
+```
+<br></details>
+
+⚠️ Be careful! Plugin options may vary depending on the bundler you are using.
+
+Feel free to open a PR or an issue if you need another export and want to speed up the process, so we can work it out.
+
 ## Configuration
 
 This library handle both single and multiple entrypoints. You can use any of the output, libraries and compilation options available in the [config file](https://github.com/timocov/dts-bundle-generator/blob/master/src/config-file/README.md) of DTS Bundle Generator.

package/dist/dts-bundle-generator.d.ts

@@ -1,11 +1,20 @@
 import { CompilationOptions, EntryPointConfig } from 'dts-bundle-generator';
 
-export interface Options {
-	fileName: string | ((entryName: string) => string);
+export interface DtsBundleGeneratorOptions {
 	output?: EntryPointConfig["output"];
 	libraries?: EntryPointConfig["libraries"];
 	compilation?: CompilationOptions;
 }
+export interface OptionsForESBuild extends DtsBundleGeneratorOptions {
+	outfile?: string;
+}
+export interface OptionsForRollup extends DtsBundleGeneratorOptions {
+	file?: string;
+}
+export interface OptionsForVite extends DtsBundleGeneratorOptions {
+	fileName: string | ((entryName: string) => string);
+}
+export type Options = OptionsForESBuild | OptionsForRollup | OptionsForVite;
 declare const _default: import("unplugin").UnpluginInstance<Options, false>;
 
 export {

package/dist/esbuild.cjs.js

@@ -0,0 +1 @@
+"use strict";const u=require("unplugin"),e=require("./factory.cjs.js"),r=u.createEsbuildPlugin(e.unpluginFactory);module.exports=r;

package/dist/esbuild.d.ts

@@ -0,0 +1,17 @@
+import { CompilationOptions, EntryPointConfig } from 'dts-bundle-generator';
+
+export interface DtsBundleGeneratorOptions {
+	output?: EntryPointConfig["output"];
+	libraries?: EntryPointConfig["libraries"];
+	compilation?: CompilationOptions;
+}
+export interface OptionsForESBuild extends DtsBundleGeneratorOptions {
+	outfile?: string;
+}
+declare const _default: (options: OptionsForESBuild) => import("esbuild").Plugin;
+
+export {
+	_default as default,
+};
+
+export {};

package/dist/esbuild.es.js

@@ -0,0 +1,6 @@
+import { createEsbuildPlugin as o } from "unplugin";
+import { u as r } from "./factory.es.js";
+const i = o(r);
+export {
+  i as default
+};

package/dist/factory.cjs.js

@@ -1,2 +1,2 @@
-"use strict";const f=require("node:buffer"),m=require("node:fs"),u=require("node:path"),d=require("node:zlib"),b=require("dts-bundle-generator"),s=require("picocolors"),c=(i,t)=>{typeof t=="string"?Object.assign(i,{default:t}):Array.isArray(t)?t.forEach(r=>{Object.assign(i,{[u.basename(r,u.extname(r))]:r})}):Object.assign(i,t)},h=i=>{const t=[],r={},l={},g=typeof i.fileName=="string"?()=>i.fileName:i.fileName;return{name:"unplugin-dts-bundle-generator",buildEnd(){const e=Object.values(r).map(n=>({filePath:n,libraries:i.libraries,output:i.output}));b.generateDtsBundle(e,i.compilation).forEach((n,a)=>t.push({compressedSize:d.gzipSync(n).length,content:n,outFile:g(Object.keys(r)[a]),size:f.Buffer.byteLength(n)}))},writeBundle(){t.forEach(e=>m.writeFileSync(u.resolve(l.outDir??"",e.outFile),e.content))},rollup:{buildStart(e){c(r,e.input)},outputOptions(e){return l.outDir=e.dir,e}},vite:{configResolved(e){e.build.lib&&c(r,e.build.lib.entry),l.outDir=e.build.outDir},closeBundle(){const e=t.length.toString();this.environment.logger.info(`
-${s.green("✓")} ${e} declaration bundles generated.`);const n={maximumFractionDigits:2,minimumFractionDigits:2},a=Math.max(...t.map(o=>o.outFile.length));t.forEach(o=>this.environment.logger.info(s.dim(`${l.outDir}/`)+s.cyan(`${o.outFile}`)+" ".repeat(a-o.outFile.length+2)+s.gray(`${(o.size/1e3).toLocaleString("en",n)} kB  │ `)+s.dim(`gzip: ${(o.compressedSize/1e3).toLocaleString("en",n)} kB`)))}}}};exports.unpluginFactory=h;
+"use strict";const f=require("node:buffer"),h=require("node:fs"),c=require("node:path"),g=require("node:zlib"),y=require("dts-bundle-generator"),a=require("picocolors"),d=s=>{const o={},n=[],l=[];return{name:"unplugin-dts-bundle-generator",buildEnd(){l.forEach(e=>n.push({entryPointConfig:{filePath:e.in,libraries:s.libraries,output:s.output},outFile:e.out,size:-1,compressedSize:-1}))},writeBundle(){n.forEach((e,r)=>{if(e.size===-1){const t=y.generateDtsBundle([e.entryPointConfig],s.compilation)[0];h.writeFileSync(e.outFile,t),n[r].size=f.Buffer.byteLength(t),n[r].compressedSize=g.gzipSync(t).length}})},esbuild:{config(e){if(!e.entryPoints)return;const r=s,t=typeof e.entryPoints=="string"?[e.entryPoints]:Array.isArray(e.entryPoints)?e.entryPoints:Object.values(e.entryPoints);t.length===1&&(r.outfile||e.outfile)?l[0]={in:typeof t[0]=="string"?t[0]:t[0].in,out:r.outfile||e.outfile}:t.map(i=>typeof i!="string"?i:{in:i,out:c.basename(i).split(".")[0]}).forEach(i=>{l.push({in:i.in,out:`${e.outdir}/${i.out}.d.ts`})})}},rollup:{buildStart(e){Array.isArray(e.input)?e.input.length===1?e.input.forEach((r,t)=>l.push({in:r,out:o.outFile??`${t}`})):e.input.forEach((r,t)=>l.push({in:r,out:o.outDir?`${o.outDir}/${c.basename(r).split(".")[0]}.d.ts`:`${t}`})):Object.entries(e.input).forEach(([r,t])=>l.push({in:t,out:o.outDir?`${o.outDir}/${c.basename(t).split(".")[0]}.d.ts`:r}))},outputOptions(e){if(n.length===0){o.outFile=e.file,o.outDir=e.dir;return}const r=s;n.length===1&&(r.file||e.file)?n[0].outFile=r.file??e.file.replace(/\.js$/,".d.ts"):n.forEach((t,i)=>{const u=`${c.basename(t.entryPointConfig.filePath).split(".")[0]}.d.ts`;n[i].outFile=`${e.dir}/${u}`})}},vite:{configResolved(e){const r=s;if(e.build.lib){const t=(i="default")=>typeof r.fileName=="string"?`${e.build.outDir}/${r.fileName}`:`${e.build.outDir}/${r.fileName(i)}`;typeof e.build.lib.entry=="string"?l.push({in:e.build.lib.entry,out:t()}):Array.isArray(e.build.lib.entry)?e.build.lib.entry.forEach((i,u)=>l.push({in:i,out:t(`${u}`)})):Object.entries(e.build.lib.entry).forEach(([i,u])=>l.push({in:u,out:t(i)}))}o.outDir=e.build.outDir},closeBundle(){const e=n.length.toString();this.environment.logger.info(`
+${a.green("✓")} ${e} declaration bundles generated.`);const r=Math.max(...n.map(i=>i.outFile.length)),t={maximumFractionDigits:2,minimumFractionDigits:2};n.forEach(i=>this.environment.logger.info(a.dim(`${o.outDir}`)+a.cyan(i.outFile.replace(o.outDir??"",""))+" ".repeat(r-i.outFile.length+2)+a.gray(`${(i.size/1e3).toLocaleString("en",t)} kB`)+a.dim(` │ gzip: ${(i.compressedSize/1e3).toLocaleString("en",t)} kB`)))}}}};exports.unpluginFactory=d;

package/dist/factory.es.js

@@ -1,67 +1,112 @@
 import { Buffer as c } from "node:buffer";
-import f from "node:fs";
-import m from "node:path";
-import d from "node:zlib";
-import { generateDtsBundle as b } from "dts-bundle-generator";
-import l from "picocolors";
-const u = (i, t) => {
-  typeof t == "string" ? Object.assign(i, {
-    default: t
-  }) : Array.isArray(t) ? t.forEach((r) => {
-    Object.assign(i, {
-      [m.basename(r, m.extname(r))]: r
-    });
-  }) : Object.assign(i, t);
-}, z = (i) => {
-  const t = [], r = {}, s = {}, g = typeof i.fileName == "string" ? () => i.fileName : i.fileName;
+import m from "node:fs";
+import f from "node:path";
+import h from "node:zlib";
+import { generateDtsBundle as g } from "dts-bundle-generator";
+import a from "picocolors";
+const F = (s) => {
+  const n = {}, o = [], l = [];
   return {
     name: "unplugin-dts-bundle-generator",
     buildEnd() {
-      const e = Object.values(r).map((o) => ({
-        filePath: o,
-        libraries: i.libraries,
-        output: i.output
-      }));
-      b(e, i.compilation).forEach((o, a) => t.push({
-        compressedSize: d.gzipSync(o).length,
-        content: o,
-        outFile: g(Object.keys(r)[a]),
-        size: c.byteLength(o)
+      l.forEach((e) => o.push({
+        entryPointConfig: {
+          filePath: e.in,
+          libraries: s.libraries,
+          output: s.output
+        },
+        outFile: e.out,
+        size: -1,
+        compressedSize: -1
       }));
     },
     writeBundle() {
-      t.forEach((e) => f.writeFileSync(
-        m.resolve(s.outDir ?? "", e.outFile),
-        e.content
-      ));
+      o.forEach((e, r) => {
+        if (e.size === -1) {
+          const t = g([e.entryPointConfig], s.compilation)[0];
+          m.writeFileSync(e.outFile, t), o[r].size = c.byteLength(t), o[r].compressedSize = h.gzipSync(t).length;
+        }
+      });
+    },
+    esbuild: {
+      config(e) {
+        if (!e.entryPoints)
+          return;
+        const r = s, t = typeof e.entryPoints == "string" ? [e.entryPoints] : Array.isArray(e.entryPoints) ? e.entryPoints : Object.values(e.entryPoints);
+        t.length === 1 && (r.outfile || e.outfile) ? l[0] = {
+          in: typeof t[0] == "string" ? t[0] : t[0].in,
+          out: r.outfile || e.outfile
+        } : t.map(
+          (i) => typeof i != "string" ? i : {
+            in: i,
+            out: f.basename(i).split(".")[0]
+          }
+        ).forEach((i) => {
+          l.push({
+            in: i.in,
+            out: `${e.outdir}/${i.out}.d.ts`
+          });
+        });
+      }
     },
     rollup: {
       buildStart(e) {
-        u(r, e.input);
+        Array.isArray(e.input) ? e.input.length === 1 ? e.input.forEach((r, t) => l.push({
+          in: r,
+          out: n.outFile ?? `${t}`
+        })) : e.input.forEach((r, t) => l.push({
+          in: r,
+          out: n.outDir ? `${n.outDir}/${f.basename(r).split(".")[0]}.d.ts` : `${t}`
+        })) : Object.entries(e.input).forEach(([r, t]) => l.push({
+          in: t,
+          out: n.outDir ? `${n.outDir}/${f.basename(t).split(".")[0]}.d.ts` : r
+        }));
       },
       outputOptions(e) {
-        return s.outDir = e.dir, e;
+        if (o.length === 0) {
+          n.outFile = e.file, n.outDir = e.dir;
+          return;
+        }
+        const r = s;
+        o.length === 1 && (r.file || e.file) ? o[0].outFile = r.file ?? e.file.replace(/\.js$/, ".d.ts") : o.forEach((t, i) => {
+          const u = `${f.basename(t.entryPointConfig.filePath).split(".")[0]}.d.ts`;
+          o[i].outFile = `${e.dir}/${u}`;
+        });
       }
     },
     vite: {
       configResolved(e) {
-        e.build.lib && u(r, e.build.lib.entry), s.outDir = e.build.outDir;
+        const r = s;
+        if (e.build.lib) {
+          const t = (i = "default") => typeof r.fileName == "string" ? `${e.build.outDir}/${r.fileName}` : `${e.build.outDir}/${r.fileName(i)}`;
+          typeof e.build.lib.entry == "string" ? l.push({
+            in: e.build.lib.entry,
+            out: t()
+          }) : Array.isArray(e.build.lib.entry) ? e.build.lib.entry.forEach((i, u) => l.push({
+            in: i,
+            out: t(`${u}`)
+          })) : Object.entries(e.build.lib.entry).forEach(([i, u]) => l.push({
+            in: u,
+            out: t(i)
+          }));
+        }
+        n.outDir = e.build.outDir;
       },
       closeBundle() {
-        const e = t.length.toString();
+        const e = o.length.toString();
         this.environment.logger.info(`
-${l.green("✓")} ${e} declaration bundles generated.`);
-        const o = {
+${a.green("✓")} ${e} declaration bundles generated.`);
+        const r = Math.max(...o.map((i) => i.outFile.length)), t = {
           maximumFractionDigits: 2,
           minimumFractionDigits: 2
-        }, a = Math.max(...t.map((n) => n.outFile.length));
-        t.forEach((n) => this.environment.logger.info(
-          l.dim(`${s.outDir}/`) + l.cyan(`${n.outFile}`) + " ".repeat(a - n.outFile.length + 2) + l.gray(`${(n.size / 1e3).toLocaleString("en", o)} kB  │ `) + l.dim(`gzip: ${(n.compressedSize / 1e3).toLocaleString("en", o)} kB`)
+        };
+        o.forEach((i) => this.environment.logger.info(
+          a.dim(`${n.outDir}`) + a.cyan(i.outFile.replace(n.outDir ?? "", "")) + " ".repeat(r - i.outFile.length + 2) + a.gray(`${(i.size / 1e3).toLocaleString("en", t)} kB`) + a.dim(` │ gzip: ${(i.compressedSize / 1e3).toLocaleString("en", t)} kB`)
         ));
       }
     }
   };
 };
 export {
-  z as u
+  F as u
 };

package/dist/rolldown.cjs.js

@@ -0,0 +1 @@
+"use strict";const n=require("unplugin"),o=require("./factory.cjs.js"),r=n.createRolldownPlugin(o.unpluginFactory);module.exports=r;

package/dist/rolldown.d.ts

@@ -0,0 +1,17 @@
+import { CompilationOptions, EntryPointConfig } from 'dts-bundle-generator';
+
+export interface DtsBundleGeneratorOptions {
+	output?: EntryPointConfig["output"];
+	libraries?: EntryPointConfig["libraries"];
+	compilation?: CompilationOptions;
+}
+export interface OptionsForRolldown extends DtsBundleGeneratorOptions {
+	file?: string;
+}
+declare const _default: (options: OptionsForRolldown) => any;
+
+export {
+	_default as default,
+};
+
+export {};

package/dist/rolldown.es.js

@@ -0,0 +1,6 @@
+import { createRolldownPlugin as o } from "unplugin";
+import { u as r } from "./factory.es.js";
+const n = o(r);
+export {
+  n as default
+};

package/dist/rollup.d.ts

@@ -1,12 +1,14 @@
 import { CompilationOptions, EntryPointConfig } from 'dts-bundle-generator';
 
-export interface Options {
-	fileName: string | ((entryName: string) => string);
+export interface DtsBundleGeneratorOptions {
 	output?: EntryPointConfig["output"];
 	libraries?: EntryPointConfig["libraries"];
 	compilation?: CompilationOptions;
 }
-declare const _default: (options: Options) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
+export interface OptionsForRollup extends DtsBundleGeneratorOptions {
+	file?: string;
+}
+declare const _default: (options: OptionsForRollup) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
 
 export {
 	_default as default,

package/dist/vite.d.ts

@@ -1,12 +1,14 @@
 import { CompilationOptions, EntryPointConfig } from 'dts-bundle-generator';
 
-export interface Options {
-	fileName: string | ((entryName: string) => string);
+export interface DtsBundleGeneratorOptions {
 	output?: EntryPointConfig["output"];
 	libraries?: EntryPointConfig["libraries"];
 	compilation?: CompilationOptions;
 }
-declare const _default: (options: Options) => import("vite").Plugin<any> | import("vite").Plugin<any>[];
+export interface OptionsForVite extends DtsBundleGeneratorOptions {
+	fileName: string | ((entryName: string) => string);
+}
+declare const _default: (options: OptionsForVite) => import("vite").Plugin<any> | import("vite").Plugin<any>[];
 
 export {
 	_default as default,

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "unplugin-dts-bundle-generator",
-  "version": "3.1.1",
+  "version": "3.3.0",
   "description": "DTS bundle generator for Unplugin",
   "keywords": [
     "unplugin",
-    "vite",
-    "webpack",
+    "esbuild",
+    "rolldown",
     "rollup",
+    "vite",
     "dts",
     "bundle",
     "typescript"
   ],
-  "repository": "https://github.com/f-lawe/unplugin-dts-bundle-generator",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/f-lawe/unplugin-dts-bundle-generator.git"
+  },
   "license": "MIT",
   "author": "François Lavaud-Wernert <francois@lavaud.family>",
   "type": "module",
@@ -21,6 +25,16 @@
       "import": "./dist/dts-bundle-generator.es.js",
       "require": "./dist/dts-bundle-generator.cjs.js"
     },
+    "./esbuild": {
+      "types": "./dist/esbuild.d.ts",
+      "import": "./dist/esbuild.es.js",
+      "require": "./dist/esbuild.cjs.js"
+    },
+    "./rolldown": {
+      "types": "./dist/rolldown.d.ts",
+      "import": "./dist/rolldown.es.js",
+      "require": "./dist/rolldown.cjs.js"
+    },
     "./rollup": {
       "types": "./dist/rollup.d.ts",
       "import": "./dist/rollup.es.js",
@@ -37,13 +51,14 @@
   "source": "src/index.ts",
   "types": "dist/dts-bundle-generator.d.ts",
   "scripts": {
-    "build": "npm run build:vite",
-    "build:rollup": "npm run build:vite & rollup --config rollup.config.ts",
-    "build:vite": "vite build",
+    "build": "vite build",
     "clean": "rimraf dist",
     "lint": "eslint . --fix && sort-package-json",
     "lint:ci": "eslint . && sort-package-json --check",
     "prepack": "npm run clean && npm run build",
+    "test:esbuild": "npm run build & rimraf dist-esbuild & node ./test/esbuild.config.ts",
+    "test:rolldown": "npm run build & rimraf dist-rollup & rolldown --config ./test/rollup.config.ts",
+    "test:rollup": "npm run build & rimraf dist-rollup & rollup --config ./test/rollup.config.ts",
     "typecheck": "tsc --noEmit",
     "typecheck:ci": "tsc --noEmit",
     "watch": "vite build --watch"
@@ -58,11 +73,12 @@
     "@nuxt/schema": "^3.17.4",
     "@rollup/plugin-typescript": "^12.1.4",
     "@types/node": "^24.0.4",
+    "esbuild": "^0.25.8",
     "eslint": "^9.12.0",
     "jiti": "^2.4.2",
     "rimraf": "^6.0.1",
+    "rolldown": "^1.0.0-beta.32",
     "rollup": "^4.41.0",
-    "rollup-plugin-node-externals": "^8.0.0",
     "sort-package-json": "^3.3.1",
     "tslib": "^2.8.1",
     "typescript": "^5.0.2",