bunup 0.3.15 → 0.3.16

package/README.md

@@ -7,10 +7,10 @@ An extremely fast, zero-config bundler for TypeScript & JavaScript, powered by [
 
 | Bundler | Format   | Build Time     | Build Time (with dts) |
 | ------- | -------- | -------------- | --------------------- |
-| bunup   | esm, cjs | **0.86ms ⚡️** | **7.54ms ⚡️**        |
-| tsdown  | esm, cjs | 3.57ms         | 15.73ms               |
-| unbuild | esm, cjs | 12.79ms        | 252.01ms              |
-| tsup    | esm, cjs | 10.53ms        | 665.55ms              |
+| bunup   | esm, cjs | **0.86ms ⚡️** | **5.44ms ⚡️**        |
+| tsdown  | esm, cjs | 3.85ms         | 11.03ms               |
+| unbuild | esm, cjs | 12.90ms        | 252.92ms              |
+| tsup    | esm, cjs | 10.99ms        | 671.39ms              |
 
 _Lower build time is better. Benchmark run on the same code with identical output formats._
 

package/build/cli.mjs

@@ -20,7 +20,7 @@ To fix this, use named entries in your configuration:
   }
 }
 
-See: https://bunup.arshadyaseen.com/#named-entries`,{muted:!0,verticalSpace:!0}),t.push({name:c,path:o})}else t.push({name:i,path:o}),e.add(i),r[i]=o}if(Array.isArray(n))for(let i of n){let o=A(i);s(o,i)}else if(typeof n==="object")Object.entries(n).forEach(([i,o])=>{s(i,o)});else{let i=A(n);s(i,n)}return t}function pn(n,t){return`[dir]/${n}${t}`}import{loadTsConfig as zn}from"load-tsconfig";function dn(n){try{return zn(".",n)}catch(t){return l.warn(`Failed to load tsconfig: ${m(t)}`),{path:n,data:{},files:[]}}}import J from"node:path";async function hn(n){let t=[".ts",".js",".mjs",".cjs",".mts",".cts",".json",".jsonc"];for(let e of t){let r=J.join(n,`bunup.config${e}`);try{if(!await Bun.file(r).exists())continue;let i=await Kn(r,e);if(!i)continue;return{configs:Xn(i,n),configFilePath:r}}catch(s){throw new x(`Failed to load config from ${r}: ${m(s)}`)}}return{configs:[],configFilePath:""}}async function Kn(n,t){if(t===".json"||t===".jsonc")return Qn(n);return Zn(n)}async function Qn(n){try{let t=await Bun.file(n).text(),e=JSON.parse(t);return e.bunup||e}catch(t){throw new Error(`Invalid JSON in config file. ${m(t)}`)}}async function Zn(n){try{let t=await import(`file://${n}`),e=t.default||t;if(!e)return l.warn(`No export found in ${n}. Make sure you're exporting your configuration.`),{};return e}catch(t){throw new Error(`Failed to import config file. ${m(t)}`)}}function Xn(n,t){let e=[];if(Fn(n))Vn(n,t,e);else if(Array.isArray(n))nt(n,t,e);else if(n&&typeof n==="object")e.push({options:n,rootDir:t});else throw new Error("Invalid configuration format. Expected an object, array, or workspace configuration.");return e}function Fn(n){return Array.isArray(n)&&n.length>0&&n.every((t)=>typeof t==="object"&&t!==null&&("name"in t)&&("root"in t)&&("config"in t))}function Vn(n,t,e){for(let r of n){let s=J.resolve(t,r.root);if(Array.isArray(r.config))for(let i of r.config)e.push({options:{name:r.name,...i},rootDir:s});else e.push({options:{name:r.name,...r.config},rootDir:s})}}function nt(n,t,e){for(let r of n){if(!r||typeof r!=="object")throw new Error("Invalid configuration item. Expected an object.");e.push({options:r,rootDir:t})}}async function xn(n){let t=J.join(n,"package.json");try{if(!await Bun.file(t).exists())return{packageJson:null,path:t};let r=await Bun.file(t).text();return{packageJson:JSON.parse(r),path:t}}catch(e){return l.warn(`Failed to load package.json at ${t}: ${m(e)}`),{packageJson:null,path:t}}}function wn(n,t){return{name:"bunup:external-plugin",setup(e){e.onResolve({filter:/.*/},(r)=>{let s=r.path;if(n.some((o)=>o.test(s))&&!t.some((o)=>o.test(s)))return{path:s,external:!0};return null})}}}var B=new Set;async function L(n,t){if(!n.entry||n.entry.length===0||!n.outDir)throw new x("Nothing to build. Please make sure you have provided a proper bunup configuration or cli arguments.");let{packageJson:e,path:r}=await xn(t);if(e)l.cli(`Using package.json: ${w(r,2)}`,{muted:!0});let s=e?.type,i=M(n,e),o=k(n),a=[wn(i,o)],c=S(n.entry),u=K(n,t),g=n.format.flatMap((f)=>c.map((R)=>{return tt(n,t,R,f,s,a,u)}));if(await Promise.all(g),n.dts){let f=dn(n.preferredTsconfigPath);if(f.path)l.cli(`Using tsconfig: ${w(f.path,2)}`,{muted:!0});let R=n.format.filter((b)=>{if(b==="iife"&&!N(s)&&n.format.includes("cjs"))return!1;return!0}),En=typeof n.dts==="object"&&n.dts.entry?S(n.dts.entry):c;try{await Promise.all(En.map(async(b)=>{let vn=await gn(t,b.path,n,f,e);await Promise.all(R.map(async(Rn)=>{let jn=X(Rn,s),W=`${t}/${n.outDir}/${b.name}${jn}`;await Bun.write(W,vn);let An=Bun.file(W).size||0;l.progress("DTS",w(W),q(An),n.name)}))}))}catch(b){throw new d(m(b))}}}async function tt(n,t,e,r,s,i,o){let a=Z(r,s),c=await Bun.build({...o,entrypoints:[`${t}/${e.path}`],format:r,naming:{entry:pn(e.name,a)},splitting:V(n.splitting,r),plugins:i,throw:!1});if(!c.success)c.logs.forEach((f)=>{if(f.level==="error")throw new x(f.message);else if(f.level==="warning")l.warn(f.message);else if(f.level==="info")l.info(f.message)});let u=`${t}/${n.outDir}/${e.name}${a}`,g=Bun.file(u).size||0;l.progress(r.toUpperCase(),w(u),q(g),n.name)}var H="0.3.15";var yn="https://bun.sh/docs/installation",bn="https://bunup.arshadyaseen.com/#cli-options";function y(n){return(t,e)=>{e[n]=t===!0?!0:t==="true"}}function v(n){return(t,e)=>{if(typeof t==="string")e[n]=t;else throw new h(`Option --${n} requires a string value`)}}function $n(n){return(t,e)=>{if(typeof t==="string")e[n]=t.split(",");else throw new h(`Option --${n} requires a string value`)}}function rt(){console.log(`
+See: https://bunup.arshadyaseen.com/#named-entries`,{muted:!0,verticalSpace:!0}),t.push({name:c,path:o})}else t.push({name:i,path:o}),e.add(i),r[i]=o}if(Array.isArray(n))for(let i of n){let o=A(i);s(o,i)}else if(typeof n==="object")Object.entries(n).forEach(([i,o])=>{s(i,o)});else{let i=A(n);s(i,n)}return t}function pn(n,t){return`[dir]/${n}${t}`}import{loadTsConfig as zn}from"load-tsconfig";function dn(n){try{return zn(".",n)}catch(t){return l.warn(`Failed to load tsconfig: ${m(t)}`),{path:n,data:{},files:[]}}}import J from"node:path";async function hn(n){let t=[".ts",".js",".mjs",".cjs",".mts",".cts",".json",".jsonc"];for(let e of t){let r=J.join(n,`bunup.config${e}`);try{if(!await Bun.file(r).exists())continue;let i=await Kn(r,e);if(!i)continue;return{configs:Xn(i,n),configFilePath:r}}catch(s){throw new x(`Failed to load config from ${r}: ${m(s)}`)}}return{configs:[],configFilePath:""}}async function Kn(n,t){if(t===".json"||t===".jsonc")return Qn(n);return Zn(n)}async function Qn(n){try{let t=await Bun.file(n).text(),e=JSON.parse(t);return e.bunup||e}catch(t){throw new Error(`Invalid JSON in config file. ${m(t)}`)}}async function Zn(n){try{let t=await import(`file://${n}`),e=t.default||t;if(!e)return l.warn(`No export found in ${n}. Make sure you're exporting your configuration.`),{};return e}catch(t){throw new Error(`Failed to import config file. ${m(t)}`)}}function Xn(n,t){let e=[];if(Fn(n))Vn(n,t,e);else if(Array.isArray(n))nt(n,t,e);else if(n&&typeof n==="object")e.push({options:n,rootDir:t});else throw new Error("Invalid configuration format. Expected an object, array, or workspace configuration.");return e}function Fn(n){return Array.isArray(n)&&n.length>0&&n.every((t)=>typeof t==="object"&&t!==null&&("name"in t)&&("root"in t)&&("config"in t))}function Vn(n,t,e){for(let r of n){let s=J.resolve(t,r.root);if(Array.isArray(r.config))for(let i of r.config)e.push({options:{name:r.name,...i},rootDir:s});else e.push({options:{name:r.name,...r.config},rootDir:s})}}function nt(n,t,e){for(let r of n){if(!r||typeof r!=="object")throw new Error("Invalid configuration item. Expected an object.");e.push({options:r,rootDir:t})}}async function xn(n){let t=J.join(n,"package.json");try{if(!await Bun.file(t).exists())return{packageJson:null,path:t};let r=await Bun.file(t).text();return{packageJson:JSON.parse(r),path:t}}catch(e){return l.warn(`Failed to load package.json at ${t}: ${m(e)}`),{packageJson:null,path:t}}}function wn(n,t){return{name:"bunup:external-plugin",setup(e){e.onResolve({filter:/.*/},(r)=>{let s=r.path;if(n.some((o)=>o.test(s))&&!t.some((o)=>o.test(s)))return{path:s,external:!0};return null})}}}var B=new Set;async function L(n,t){if(!n.entry||n.entry.length===0||!n.outDir)throw new x("Nothing to build. Please make sure you have provided a proper bunup configuration or cli arguments.");let{packageJson:e,path:r}=await xn(t);if(e)l.cli(`Using package.json: ${w(r,2)}`,{muted:!0});let s=e?.type,i=M(n,e),o=k(n),a=[wn(i,o)],c=S(n.entry),u=K(n,t),g=n.format.flatMap((f)=>c.map((R)=>{return tt(n,t,R,f,s,a,u)}));if(await Promise.all(g),n.dts){let f=dn(n.preferredTsconfigPath);if(f.path)l.cli(`Using tsconfig: ${w(f.path,2)}`,{muted:!0});let R=n.format.filter((b)=>{if(b==="iife"&&!N(s)&&n.format.includes("cjs"))return!1;return!0}),En=typeof n.dts==="object"&&n.dts.entry?S(n.dts.entry):c;try{await Promise.all(En.map(async(b)=>{let vn=await gn(t,b.path,n,f,e);await Promise.all(R.map(async(Rn)=>{let jn=X(Rn,s),W=`${t}/${n.outDir}/${b.name}${jn}`;await Bun.write(W,vn);let An=Bun.file(W).size||0;l.progress("DTS",w(W),q(An),n.name)}))}))}catch(b){throw new d(m(b))}}}async function tt(n,t,e,r,s,i,o){let a=Z(r,s),c=await Bun.build({...o,entrypoints:[`${t}/${e.path}`],format:r,naming:{entry:pn(e.name,a)},splitting:V(n.splitting,r),plugins:i,throw:!1});if(!c.success)c.logs.forEach((f)=>{if(f.level==="error")throw new x(f.message);else if(f.level==="warning")l.warn(f.message);else if(f.level==="info")l.info(f.message)});let u=`${t}/${n.outDir}/${e.name}${a}`,g=Bun.file(u).size||0;l.progress(r.toUpperCase(),w(u),q(g),n.name)}var H="0.3.16";var yn="https://bun.sh/docs/installation",bn="https://bunup.arshadyaseen.com/#cli-options";function y(n){return(t,e)=>{e[n]=t===!0?!0:t==="true"}}function v(n){return(t,e)=>{if(typeof t==="string")e[n]=t;else throw new h(`Option --${n} requires a string value`)}}function $n(n){return(t,e)=>{if(typeof t==="string")e[n]=t.split(",");else throw new h(`Option --${n} requires a string value`)}}function rt(){console.log(`
 Bunup - An extremely fast, zero-config bundler for JavaScript and TypeScript, powered by Bun.
 `),console.log("For more information on available options, visit:"),console.log(`\x1B[36m\x1B[4m${bn}\x1B[0m
 `),process.exit(0)}function st(){console.log(H),process.exit(0)}var it={name:{flags:["n","name"],handler:v("name")},format:{flags:["f","format"],handler:(n,t)=>{if(typeof n==="string")t.format=n.split(",");else throw new h("Option --format requires a string value")}},outDir:{flags:["o","out-dir"],handler:v("outDir")},minify:{flags:["m","minify"],handler:y("minify")},watch:{flags:["w","watch"],handler:y("watch")},dts:{flags:["d","dts"],handler:y("dts")},banner:{flags:["b","banner"],handler:v("banner")},footer:{flags:["f","footer"],handler:v("footer")},external:{flags:["e","external"],handler:$n("external")},sourcemap:{flags:["sm","sourcemap"],handler:v("sourcemap")},target:{flags:["t","target"],handler:v("target")},minifyWhitespace:{flags:["mw","minify-whitespace"],handler:y("minifyWhitespace")},minifyIdentifiers:{flags:["mi","minify-identifiers"],handler:y("minifyIdentifiers")},minifySyntax:{flags:["ms","minify-syntax"],handler:y("minifySyntax")},clean:{flags:["c","clean"],handler:y("clean")},splitting:{flags:["s","splitting"],handler:y("splitting")},noExternal:{flags:["ne","no-external"],handler:$n("noExternal")}},ot={help:{flags:["h","help"],handler:()=>rt()},version:{flags:["v","version"],handler:()=>st()}},U={};for(let n of Object.values(it))if(n)for(let t of n.flags)U[t]=n.handler;for(let n of Object.values(ot))for(let t of n.flags)U[t]=n.handler;function On(n){let t={},e={},r=0;while(r<n.length){let s=n[r];if(s.startsWith("--")){let i,o;if(s.includes("=")){let[a,c]=s.slice(2).split("=",2);i=a,o=c}else{i=s.slice(2);let a=n[r+1];if(o=a&&!a.startsWith("-")?a:!0,typeof o==="string")r++}if(i==="entry")if(typeof o==="string"){let a=A(o);if(e[a])l.warn(`Duplicate entry name '${a}' derived from '${o}'. Overwriting previous entry.`);e[a]=o}else throw new h("Option --entry requires a string value");else if(i.startsWith("entry.")){let a=i.slice(6);if(typeof o==="string"){if(e[a])l.warn(`Duplicate entry name '${a}' provided via --entry.${a}. Overwriting previous entry.`);e[a]=o}else throw new h(`Option --entry.${a} requires a string value`)}else{let a=U[i];if(a)a(o,t);else throw new h(`Unknown option: --${i}`)}}else if(s.startsWith("-")){let i=s.slice(1),o=n[r+1],a=o&&!o.startsWith("-")?o:!0;if(typeof a==="string")r++;let c=U[i];if(c)c(a,t);else throw new h(`Unknown option: -${i}`)}else{let i=A(s);if(e[i])l.warn(`Duplicate entry name '${i}' derived from positional argument '${s}'. Overwriting previous entry.`);e[i]=s}r++}if(Object.keys(e).length>0)t.entry=e;return t}(()=>{if(typeof Bun==="undefined")throw new h(`Bunup requires Bun to run.

package/build/index.d.mts

@@ -1,12 +1,220 @@
-import * as bun from 'bun';
 
+//#region \0virtual:/home/runner/work/bunup/bunup/src/options.d.ts
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Loader = NonNullable<BunBuildOptions["loader"]>[string];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Define = BunBuildOptions["define"];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Sourcemap = BunBuildOptions["sourcemap"];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Format = Exclude<BunBuildOptions["format"], undefined>;
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Target = BunBuildOptions["target"];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type External = (string | RegExp)[];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Entry = Arrayable<string> | Record<string, string>;
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type DtsOptions = {
 	/**
 	* Entry point files for TypeScript declaration file generation
@@ -40,6 +248,10 @@ type DtsOptions = {
 	*/
 	resolve?: boolean | (string | RegExp)[]
 };
+/**
+	* Name of the build configuration
+	* Used for logging and identification purposes
+	*/
 interface BunupOptions {
 	/**
 	* Name of the build configuration
@@ -224,13 +436,15 @@ interface BunupOptions {
 	loader?: Record<string, Loader>;
 }
 
+//#endregion
+//#region \0virtual:/home/runner/work/bunup/bunup/src/types.d.ts
 type PromiseOr<T> = Promise<T> | T;
 type WithOptional<
 	T,
 	K extends keyof T
 > = Omit<T, K> & Partial<Pick<T, K>>;
 type Arrayable<T> = T | T[];
-type Bun = typeof bun;
+type Bun = typeof import("bun");
 type BunBuildOptions = Parameters<Bun["build"]>[0];
 type DefineConfigEntry = Omit<WithOptional<BunupOptions, "outDir" | "format">, "watch">;
 type DefineWorkspaceEntry = {
@@ -239,10 +453,14 @@ type DefineWorkspaceEntry = {
 	config: DefineConfigEntry | DefineConfigEntry[]
 };
 
+//#endregion
+//#region \0virtual:/home/runner/work/bunup/bunup/src/define.d.ts
 declare function defineConfig(options: DefineConfigEntry | DefineConfigEntry[]): DefineConfigEntry | DefineConfigEntry[];
 declare function defineWorkspace(options: DefineWorkspaceEntry[]): DefineWorkspaceEntry[];
 
+//#endregion
+//#region \0virtual:/home/runner/work/bunup/bunup/src/build.d.ts
 declare function build(options: BunupOptions, rootDir: string): Promise<void>;
 
-export { build, defineConfig, defineWorkspace };
-export type { DefineConfigEntry, DefineWorkspaceEntry };
+//#endregion
+export { DefineConfigEntry, DefineWorkspaceEntry, build, defineConfig, defineWorkspace };

package/build/index.d.ts

@@ -1,12 +1,220 @@
-import * as bun from 'bun';
 
+//#region \0virtual:/home/runner/work/bunup/bunup/src/options.d.ts
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Loader = NonNullable<BunBuildOptions["loader"]>[string];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Define = BunBuildOptions["define"];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Sourcemap = BunBuildOptions["sourcemap"];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Format = Exclude<BunBuildOptions["format"], undefined>;
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Target = BunBuildOptions["target"];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type External = (string | RegExp)[];
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type Entry = Arrayable<string> | Record<string, string>;
+/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @example
+	* // Using a string path
+	* entry: 'src/index.ts' // Generates index.d.ts
+	*
+	* // Using string paths in an array
+	* entry: ['src/index.ts']  // Generates index.d.ts
+	*
+	* // Using named outputs as an object
+	* entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
+	*/
 type DtsOptions = {
 	/**
 	* Entry point files for TypeScript declaration file generation
@@ -40,6 +248,10 @@ type DtsOptions = {
 	*/
 	resolve?: boolean | (string | RegExp)[]
 };
+/**
+	* Name of the build configuration
+	* Used for logging and identification purposes
+	*/
 interface BunupOptions {
 	/**
 	* Name of the build configuration
@@ -224,13 +436,15 @@ interface BunupOptions {
 	loader?: Record<string, Loader>;
 }
 
+//#endregion
+//#region \0virtual:/home/runner/work/bunup/bunup/src/types.d.ts
 type PromiseOr<T> = Promise<T> | T;
 type WithOptional<
 	T,
 	K extends keyof T
 > = Omit<T, K> & Partial<Pick<T, K>>;
 type Arrayable<T> = T | T[];
-type Bun = typeof bun;
+type Bun = typeof import("bun");
 type BunBuildOptions = Parameters<Bun["build"]>[0];
 type DefineConfigEntry = Omit<WithOptional<BunupOptions, "outDir" | "format">, "watch">;
 type DefineWorkspaceEntry = {
@@ -239,10 +453,14 @@ type DefineWorkspaceEntry = {
 	config: DefineConfigEntry | DefineConfigEntry[]
 };
 
+//#endregion
+//#region \0virtual:/home/runner/work/bunup/bunup/src/define.d.ts
 declare function defineConfig(options: DefineConfigEntry | DefineConfigEntry[]): DefineConfigEntry | DefineConfigEntry[];
 declare function defineWorkspace(options: DefineWorkspaceEntry[]): DefineWorkspaceEntry[];
 
+//#endregion
+//#region \0virtual:/home/runner/work/bunup/bunup/src/build.d.ts
 declare function build(options: BunupOptions, rootDir: string): Promise<void>;
 
-export { build, defineConfig, defineWorkspace };
-export type { DefineConfigEntry, DefineWorkspaceEntry };
+//#endregion
+export { DefineConfigEntry, DefineWorkspaceEntry, build, defineConfig, defineWorkspace };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunup",
-  "version": "0.3.15",
+  "version": "0.3.16",
   "description": "An extremely fast, zero-config bundler for TypeScript & JavaScript, powered by Bun.",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -18,7 +18,7 @@
     "@types/bun": "^1.2.5",
     "@typescript-eslint/eslint-plugin": "^7.3.1",
     "bumpp": "^10.1.0",
-    "bunup": "^0.3.7",
+    "bunup": "^0.3.15",
     "eslint": "^8.57.1",
     "husky": "^9.1.7",
     "prettier": "^3.5.3",