@hypernym/bundler 0.20.0 → 0.21.0

package/README.md

@@ -105,32 +105,32 @@ npx hyperbundler --config hyper.config.ts
 
 ## Formats
 
-During transformation, file formats are automatically resolved and in most cases there is no need for additional configuration.
+During transformation, file formats are automatically resolved, and in most cases, no additional configuration is required.
 
-`Hyperbundler` module environment for generated files defaults to `esm`, which means the outputs will have a `.mjs` extension unless otherwise specified. For TypeScript declarations, the appropriate extension will be `.d.mts`.
+The default module environment for generated files is `esm`, which means output files will have a `.mjs` extension unless otherwise specified. For TypeScript declarations, the corresponding extension will be `.d.mts`.
 
-Formats can also be explicitly specified for each entry, if necessary.
+Formats can also be explicitly specified for each entry, if needed.
 
 ### Inputs
 
-Default transformation behaviour for all `chunk` entries:
+Default transformation behavior for all `chunk` entries:
 
-- `./srcDir/file.js` resolves to `./outDir/file.mjs`
-- `./srcDir/file.mjs` resolves to `./outDir/file.mjs`
-- `./srcDir/file.cjs` resolves to `./outDir/file.cjs`
-- `./srcDir/file.ts` resolves to `./outDir/file.mjs`
-- `./srcDir/file.mts` resolves to `./outDir/file.mjs`
-- `./srcDir/file.cts` resolves to `./outDir/file.cjs`
+- `./srcDir/file.js` → `./outDir/file.mjs`
+- `./srcDir/file.mjs` → `./outDir/file.mjs`
+- `./srcDir/file.cjs` → `./outDir/file.cjs`
+- `./srcDir/file.ts` → `./outDir/file.mjs`
+- `./srcDir/file.mts` → `./outDir/file.mjs`
+- `./srcDir/file.cts` → `./outDir/file.cjs`
 
 ### Declarations
 
-Default transformation behaviour for all `dts` entries:
+Default transformation behavior for all `dts` entries:
 
-- `./srcDir/file.ts` resolves to `./outDir/file.d.mts`
+- `./srcDir/file.ts` → `./outDir/file.d.mts`
 
 ## Options
 
-All options are documented with descriptions and examples so autocompletion will be offered as you type. Simply hover over the property and see what it does in the quick info tooltip.
+All options come with descriptions and examples. As you type, you’ll get suggestions and can see quick info by hovering over any property.
 
 ### entries
 
@@ -247,7 +247,7 @@ export default defineConfig({
 
 ### outDir
 
-- Type: `string`
+- Type: `string | undefined`
 - Default: `dist`
 
 Specifies the output directory for production bundle.
@@ -258,14 +258,14 @@ Specifies the output directory for production bundle.
 import { defineConfig } from '@hypernym/bundler'
 
 export default defineConfig({
-  outDir: 'output',
+  outDir: './output',
 })
 ```
 
 ### externals
 
-- Type: `(string | RegExp)[]`
-- Default: `[/^node:/, /^@types/, /^@rollup/, /^@hypernym/, /^rollup/, ...pkg.dependencies]`
+- Type: `(string | RegExp)[] | undefined`
+- Default: `[/^node:/, /^@types/, /^@rollup/, /^@rolldown/, /^@hypernym/, /^rollup/, /^rolldown/, ...pkg.dependencies]`
 
 Specifies the module IDs or regular expressions that match module IDs to be treated as external and excluded from the bundle.
 
@@ -296,10 +296,15 @@ export default defineConfig({
 
 ### minify
 
-- Type: `boolean`
+- Type: `boolean | 'dce-only' | MinifyOptions | undefined`
 - Default: `undefined`
 
-Specifies the minification for all `chunk` entries.
+Controls code minification for all `chunk` entries.
+
+- `true`: Enable full minification including code compression and dead code elimination.
+- `false`: Disable minification (default).
+- `'dce-only'`: Only perform dead code elimination without code compression.
+- `MinifyOptions`: Fine-grained control over minification settings.
 
 ```ts
 // bundler.config.ts
@@ -339,7 +344,7 @@ List of lifecycle hooks that are called at various phases:
 
 ### bundle:start
 
-- Type: `(options: Options) => void | Promise<void>`
+- Type: `(options: Options) => void | Promise<void> | undefined`
 - Default: `undefined`
 
 Called at the beginning of bundling.
@@ -360,7 +365,7 @@ export default defineConfig({
 
 ### build:start
 
-- Type: `(options: Options, stats: BuildStats) => void | Promise<void>`
+- Type: `(options: Options, stats: BuildStats) => void | Promise<void> | undefined`
 - Default: `undefined`
 
 Called at the beginning of building.
@@ -381,7 +386,7 @@ export default defineConfig({
 
 ### build:entry:start
 
-- Type: `(entry: BuildEntryOptions, stats: BuildEntryStats) => void | Promise<void>`
+- Type: `(entry: BuildEntryOptions, stats: BuildEntryStats) => void | Promise<void> | undefined`
 - Default: `undefined`
 
 Called on each entry just before the build process.
@@ -405,7 +410,7 @@ export default defineConfig({
 
 ### build:entry:end
 
-- Type: `(entry: BuildEntryOptions, stats: BuildEntryStats) => void | Promise<void>`
+- Type: `(entry: BuildEntryOptions, stats: BuildEntryStats) => void | Promise<void> | undefined`
 - Default: `undefined`
 
 Called on each entry right after the build process is completed.
@@ -426,7 +431,7 @@ export default defineConfig({
 
 ### build:end
 
-- Type: `(options: Options, stats: BuildStats) => void | Promise<void>`
+- Type: `(options: Options, stats: BuildStats) => void | Promise<void> | undefined`
 - Default: `undefined`
 
 Called right after building is complete.
@@ -447,7 +452,7 @@ export default defineConfig({
 
 ### bundle:end
 
-- Type: `(options: Options) => void | Promise<void>`
+- Type: `(options: Options) => void | Promise<void> | undefined`
 - Default: `undefined`
 
 Called right after bundling is complete.

package/dist/bin/index.mjs

@@ -9,7 +9,7 @@ import { build as build$1 } from "../build/index.mjs";
 
 //#region src/bin/meta.ts
 const name = `Hyperbundler`;
-const version = `0.20.0`;
+const version = `0.21.0`;
 
 //#endregion
 //#region src/utils/logger.ts
@@ -114,7 +114,7 @@ async function loadConfig(filePath, defaults) {
 		input: resolve(cwd$1, filePath),
 		write: false,
 		external: (id) => !(isAbsolute(id) || /^(\.|@\/|~\/)/.test(id)),
-		resolve: { tsconfigFilename: defaults.tsconfig },
+		tsconfig: defaults.tsconfig,
 		output: { format: "esm" }
 	});
 	const tempConfig = resolve(cwd$1, "node_modules/.hypernym/bundler/config.mjs");

package/dist/build/index.mjs

@@ -92,6 +92,11 @@ function getOutputPath(outDir, input, { extension = "auto" } = {}) {
 	}
 	return outDir.startsWith("./") || outDir.startsWith("../") ? output : `./${output}`;
 }
+function parseOutputPath(path) {
+	if (!path) return;
+	if (path.startsWith("./")) return path;
+	else return `./${path}`;
+}
 
 //#endregion
 //#region src/bin/build.ts
@@ -109,7 +114,7 @@ function logEntryStats(stats) {
 	if (stats.logs) for (const log of stats.logs) cl$1("!", log.level.padEnd(5), output.padEnd(outputLength), dim(log.log.message));
 }
 async function build(options) {
-	const { cwd: cwdir = cwd(), outDir = "dist", tsconfig, hooks } = options;
+	const { cwd: cwdir = cwd(), outDir = "dist", entries, externals, tsconfig, hooks, minify } = options;
 	let start = 0;
 	const buildStats = {
 		cwd: cwdir,
@@ -118,164 +123,100 @@ async function build(options) {
 		files: []
 	};
 	await hooks?.["build:start"]?.(options, buildStats);
-	if (options.entries) {
+	if (entries) {
 		start = Date.now();
-		for (const entry of options.entries) {
+		for (const entry of entries) {
 			const entryStart = Date.now();
-			if (entry.input) {
+			if (entry.input || entry.dts) {
 				const buildLogs = [];
-				const _output = entry.output || getOutputPath(outDir, entry.input);
+				const isChunk = !isUndefined(entry.input);
+				const outputRawPath = parseOutputPath(entry.output) || getOutputPath(outDir, entry.input || entry.dts, { extension: isChunk ? "auto" : "dts" });
+				const outputResolvePath = resolve(cwdir, outputRawPath);
 				let format = entry.format || "esm";
-				if (_output.endsWith(".cjs")) format = "cjs";
-				const _entry = {
-					...entry,
-					input: entry.input,
-					output: _output,
-					format,
-					externals: entry.externals || options.externals,
-					minify: !isUndefined(entry.minify) ? entry.minify : options.minify
-				};
-				const input = resolve(cwdir, _entry.input);
-				const output = resolve(cwdir, _entry.output);
-				const entryStats = {
-					cwd: cwdir,
-					path: _entry.output,
-					size: 0,
-					buildTime: entryStart,
-					format,
-					logs: buildLogs
-				};
-				await hooks?.["build:entry:start"]?.(_entry, entryStats);
-				const bundle = await rolldown({
-					input,
-					external: _entry.externals,
-					plugins: _entry.plugins,
+				if (outputRawPath.endsWith(".cjs")) format = "cjs";
+				const entryInput = {
+					input: resolve(cwdir, entry.input || entry.dts),
+					external: entry.externals || externals,
+					plugins: isChunk ? entry.plugins : entry.plugins || [dts({
+						...entry.dtsPlugin,
+						emitDtsOnly: true
+					})],
 					onLog: (level, log, handler) => {
-						if (_entry.onLog) _entry.onLog(level, log, handler, buildLogs);
+						if (entry.onLog) entry.onLog(level, log, handler, buildLogs);
 						else buildLogs.push({
 							level,
 							log
 						});
 					},
-					resolve: {
-						..._entry.resolve,
-						tsconfigFilename: _entry.resolve?.tsconfigFilename || tsconfig
-					},
-					define: _entry.define
-				});
-				await bundle.write({
-					file: output,
-					minify: _entry.minify,
-					format: _entry.format,
-					banner: _entry.banner,
-					footer: _entry.footer,
-					intro: _entry.intro,
-					outro: _entry.outro,
-					name: _entry.name,
-					globals: _entry.globals,
-					extend: _entry.extend,
-					plugins: _entry.paths ? [outputPaths(_entry.paths)] : void 0
-				});
-				const stats = await stat(output);
-				entryStats.size = stats.size;
-				entryStats.buildTime = Date.now() - entryStart;
-				entryStats.logs = buildLogs;
-				buildStats.files.push(entryStats);
-				buildStats.size = buildStats.size + stats.size;
-				logEntryStats(entryStats);
-				await hooks?.["build:entry:end"]?.(_entry, entryStats);
-			}
-			if (entry.dts) {
-				const buildLogs = [];
-				const _entry = {
-					...entry,
-					output: entry.output || getOutputPath(outDir, entry.dts, { extension: "dts" }),
-					externals: entry.externals || options.externals,
-					format: entry.format || "esm",
-					plugins: [dts({
-						...entry.dtsPlugin,
-						emitDtsOnly: true
-					})]
+					resolve: entry.resolve,
+					define: entry.define,
+					inject: entry.inject,
+					tsconfig: entry.tsconfig || tsconfig
+				};
+				const entryOutput = {
+					file: isChunk ? outputResolvePath : void 0,
+					minify: isChunk ? !isUndefined(entry.minify) ? entry.minify : minify : void 0,
+					format,
+					banner: entry.banner,
+					footer: entry.footer,
+					intro: entry.intro,
+					outro: entry.outro,
+					name: entry.name,
+					globals: entry.globals,
+					extend: entry.extend,
+					plugins: entry.paths ? [outputPaths(entry.paths)] : void 0
+				};
+				const entryOptions = {
+					...entryInput,
+					...entryOutput,
+					externals: entryInput.external
 				};
-				const input = resolve(cwdir, _entry.dts);
-				const output = resolve(cwdir, _entry.output);
 				const entryStats = {
 					cwd: cwdir,
-					path: _entry.output,
+					path: outputRawPath,
 					size: 0,
 					buildTime: entryStart,
-					format: "dts",
+					format: isChunk ? format : "dts",
 					logs: buildLogs
 				};
-				await hooks?.["build:entry:start"]?.(_entry, entryStats);
-				const bundle = await rolldown({
-					input,
-					external: _entry.externals,
-					plugins: _entry.plugins,
-					onLog: (level, log, handler) => {
-						if (_entry.onLog) _entry.onLog(level, log, handler, buildLogs);
-						else buildLogs.push({
-							level,
-							log
-						});
-					},
-					resolve: {
-						..._entry.resolve,
-						tsconfigFilename: _entry.resolve?.tsconfigFilename || tsconfig
-					},
-					define: _entry.define
-				});
-				const generated = await bundle.generate({
-					format: _entry.format,
-					banner: _entry.banner,
-					footer: _entry.footer,
-					intro: _entry.intro,
-					outro: _entry.outro,
-					name: _entry.name,
-					globals: _entry.globals,
-					extend: _entry.extend,
-					plugins: _entry.paths ? [outputPaths(_entry.paths)] : void 0
-				});
-				await write(_entry.output, generated.output[0].code);
-				const stats = await stat(output);
+				await hooks?.["build:entry:start"]?.(entryOptions, entryStats);
+				const bundle = await rolldown(entryInput);
+				if (isChunk) await bundle.write(entryOutput);
+				else {
+					const generated = await bundle.generate(entryOutput);
+					await write(outputResolvePath, generated.output[0].code);
+				}
+				const stats = await stat(outputResolvePath);
 				entryStats.size = stats.size;
 				entryStats.buildTime = Date.now() - entryStart;
 				entryStats.logs = buildLogs;
 				buildStats.files.push(entryStats);
 				buildStats.size = buildStats.size + stats.size;
 				logEntryStats(entryStats);
-				await hooks?.["build:entry:end"]?.(_entry, entryStats);
+				await hooks?.["build:entry:end"]?.(entryOptions, entryStats);
 			}
 			if (entry.copy) {
-				const outputPath = getOutputPath(outDir, entry.copy, { extension: "original" });
-				const _entry = {
-					input: entry.copy,
-					output: entry.output || outputPath
-				};
-				const input = resolve(cwdir, _entry.input);
-				const output = resolve(cwdir, _entry.output);
-				await copy(input, output, {
+				const inputResolvePath = resolve(cwdir, entry.copy);
+				const outputRawPath = parseOutputPath(entry.output) || getOutputPath(outDir, entry.copy, { extension: "original" });
+				const outputResolvePath = resolve(cwdir, outputRawPath);
+				await copy(inputResolvePath, outputResolvePath, {
 					recursive: entry.recursive || true,
 					filter: entry.filter
 				}).catch(error);
-				const stats = await stat(output);
+				const stats = await stat(outputResolvePath);
 				let totalSize = 0;
 				if (!stats.isDirectory()) totalSize = stats.size;
 				else {
-					const files = await readdir(output);
+					const files = await readdir(outputResolvePath);
 					for (const file of files) {
-						const filePath = resolve(output, file);
+						const filePath = resolve(outputResolvePath, file);
 						const fileStat = await stat(filePath);
 						totalSize = totalSize + fileStat.size;
 					}
 				}
-				const parseOutput = (path) => {
-					if (path.startsWith("./")) return path;
-					else return `./${path}`;
-				};
 				const entryStats = {
 					cwd: cwdir,
-					path: parseOutput(_entry.output),
+					path: outputRawPath,
 					size: totalSize,
 					buildTime: Date.now() - entryStart,
 					format: "copy",
@@ -286,11 +227,13 @@ async function build(options) {
 				logEntryStats(entryStats);
 			}
 			if (entry.template && entry.output) {
-				await write(entry.output, entry.template);
-				const stats = await stat(resolve(cwdir, entry.output));
+				const outputRawPath = parseOutputPath(entry.output);
+				const outputResolvePath = resolve(cwdir, outputRawPath);
+				await write(outputResolvePath, entry.template);
+				const stats = await stat(outputResolvePath);
 				const entryStats = {
 					cwd: cwdir,
-					path: entry.output,
+					path: outputRawPath,
 					size: stats.size,
 					buildTime: Date.now() - entryStart,
 					format: "tmp",

package/dist/index.d.mts

@@ -138,12 +138,26 @@ interface EntryBase {
    * @default undefined
    */
   define?: InputOptions['define'];
+  /**
+   * Specifies Rolldown `inject` options.
+   *
+   * @default undefined
+   */
+  inject?: InputOptions['inject'];
   /**
    * Specifies Rolldown plugins.
    *
    * @default undefined
    */
   plugins?: RolldownPluginOption;
+  /**
+   * Specifies the path to the `tsconfig` file.
+   *
+   * By default, if the file `tsconfig.json` exists in the project root, it will be used as the default config file.
+   *
+   * @default undefined
+   */
+  tsconfig?: InputOptions['tsconfig'];
 }
 interface EntryChunk extends EntryBase {
   /**
@@ -202,11 +216,16 @@ interface EntryChunk extends EntryBase {
    */
   extend?: OutputOptions['extend'];
   /**
-   * Minifies the generated code if enabled.
+   * Controls code minification.
+   *
+   * - `true`: Enable full minification including code compression and dead code elimination.
+   * - `false`: Disable minification (default).
+   * - `'dce-only'`: Only perform dead code elimination without code compression.
+   * - `MinifyOptions`: Fine-grained control over minification settings.
    *
    * @default undefined
    */
-  minify?: boolean;
+  minify?: OutputOptions['minify'];
   dts?: never;
   dtsPlugin?: never;
   copy?: never;
@@ -387,7 +406,7 @@ interface Options {
    *
    * ```ts
    * export default defineConfig({
-   *   outDir: 'output',
+   *   outDir: './output',
    * })
    * ```
    *
@@ -432,7 +451,12 @@ interface Options {
    */
   hooks?: HooksOptions;
   /**
-   * Specifies the minification for all `chunk` entries.
+   * Controls code minification for all `chunk` entries.
+   *
+   * - `true`: Enable full minification including code compression and dead code elimination.
+   * - `false`: Disable minification (default).
+   * - `'dce-only'`: Only perform dead code elimination without code compression.
+   * - `MinifyOptions`: Fine-grained control over minification settings.
    *
    * @example
    *
@@ -457,7 +481,7 @@ interface Options {
    *
    * @default undefined
    */
-  minify?: boolean;
+  minify?: OutputOptions['minify'];
   /**
    * Specifies the path to the project root (current working directory).
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/bundler",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "author": "Hypernym Studio",
   "description": "ESM & TS module bundler.",
   "license": "MIT",
@@ -58,8 +58,8 @@
     "@hypernym/args": "^0.3.3",
     "@hypernym/colors": "^1.0.5",
     "@hypernym/utils": "^3.4.5",
-    "rolldown": "1.0.0-beta.32",
-    "rolldown-plugin-dts": "^0.15.7"
+    "rolldown": "^1.0.0-beta.34",
+    "rolldown-plugin-dts": "^0.15.9"
   },
   "devDependencies": {
     "@hypernym/eslint-config": "^3.6.3",