@hypernym/bundler 0.31.2 → 0.32.0

package/README.md

@@ -297,10 +297,10 @@ export default defineConfig({
 
 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.
+- `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
@@ -325,6 +325,30 @@ export default defineConfig({
 })
 ```
 
+## comments
+
+- Type: `boolean | CommentsOptions | undefined`
+- Default: `{ legal: true, annotation: true, jsdoc: false }`
+
+Specifies which comments are preserved in the output.
+
+- `true` - Preserve legal, annotation, and JSDoc comments.
+- `false` - Strip all comments.
+- `object` - Granular control over comment categories:
+  - `legal` - `@license`, `@preserve`, `//!`, `/*!`.
+  - `annotation` - `@__PURE__`, `@__NO_SIDE_EFFECTS__`, `@vite-ignore`.
+  - `jsdoc` - JSDoc comments.
+
+```ts
+// bundler.config.ts
+
+import { defineConfig } from '@hypernym/bundler'
+
+export default defineConfig({
+  comments: true,
+})
+```
+
 ## Hooks
 
 List of lifecycle hooks that are called at various phases:

package/dist/bin/index.js

@@ -9,7 +9,7 @@ import { build as build$1 } from "../build/index.js";
 
 //#region src/bin/meta.ts
 const name = `Hyperbundler`;
-const version = `0.31.2`;
+const version = `0.32.0`;
 
 //#endregion
 //#region src/utils/logger.ts
@@ -73,24 +73,6 @@ function formatBytes(bytes) {
 
 //#endregion
 //#region src/config.ts
-/**
-* List of global default patterns for external module identifiers.
-*
-* @example
-*
-* ```ts
-* import { externals } from '@hypernym/bundler'
-*
-* export default defineConfig({
-*   entries: [
-*     {
-*       input: './src/index.ts',
-*       externals: [...externals, 'id', /regexp/]
-*     },
-*   ]
-* })
-* ```
-*/
 const externals = [
 	/^node:/,
 	/^@types/,
@@ -103,20 +85,20 @@ const externals = [
 
 //#endregion
 //#region src/bin/loader.ts
-async function getTSConfigPath(cwd$1, filePath = "tsconfig.json") {
-	const tsconfigPath = resolve(cwd$1, filePath);
+async function getTSConfigPath(cwd, filePath = "tsconfig.json") {
+	const tsconfigPath = resolve(cwd, filePath);
 	if (await exists(tsconfigPath)) return tsconfigPath;
 }
 async function loadConfig(filePath, defaults) {
-	const cwd$1 = defaults.cwd;
+	const cwd = defaults.cwd;
 	const result = await build({
-		input: resolve(cwd$1, filePath),
+		input: resolve(cwd, filePath),
 		write: false,
 		external: (id) => !(isAbsolute(id) || /^(\.|@\/|~\/)/.test(id)),
 		tsconfig: defaults.tsconfig,
 		output: { format: "esm" }
 	});
-	const tempConfig = resolve(cwd$1, "node_modules/.hypernym/bundler/config.js");
+	const tempConfig = resolve(cwd, "node_modules/.hypernym/bundler/config.js");
 	await write(tempConfig, result.output[0].code);
 	const config = (await import(tempConfig)).default;
 	return {
@@ -162,14 +144,14 @@ async function createConfigLoader(args) {
 async function createBuilder(config) {
 	const { options, path: configPath } = config;
 	const { hooks } = options;
-	const cl$1 = console.log;
+	const cl = console.log;
 	await hooks?.["bundle:start"]?.(options);
-	cl$1();
+	cl();
 	logger.info(dim(`v${version}`));
-	cl$1("Config", dim(configPath));
-	cl$1();
-	cl$1("Processing specified entries...");
-	cl$1();
+	cl("Config", dim(configPath));
+	cl();
+	cl("Processing specified entries...");
+	cl();
 	await build$1(options).then((stats) => {
 		const entriesLength = options.entries.length;
 		const totalEntries = `${entriesLength} ${entriesLength > 1 ? "entries" : "entry"}`;
@@ -177,12 +159,12 @@ async function createBuilder(config) {
 		const totalFiles = `${stats.files.length} file${filesLength > 1 ? "s" : ""}`;
 		const buildTime = formatMs(stats.buildTime);
 		const buildSize = formatBytes(stats.size);
-		cl$1();
-		cl$1("Stats:", dim(`${totalEntries}, ${totalFiles}, ${buildSize}, ${buildTime}`));
-		cl$1();
-		cl$1("All entries successfully processed.");
-		cl$1("Bundle is optimized and ready for production.");
-		cl$1();
+		cl();
+		cl("Stats:", dim(`${totalEntries}, ${totalFiles}, ${buildSize}, ${buildTime}`));
+		cl();
+		cl("All entries successfully processed.");
+		cl("Bundle is optimized and ready for production.");
+		cl();
 	}).catch(error);
 	await hooks?.["bundle:end"]?.(options);
 }

package/dist/build/index.js

@@ -101,7 +101,7 @@ function parseOutputPath(path) {
 //#endregion
 //#region src/bin/build.ts
 function logEntryStats(stats) {
-	const cl$1 = console.log;
+	const cl = console.log;
 	const base = parse(stats.path).base;
 	const path = stats.path.replace(base, "");
 	let format = stats.format;
@@ -109,11 +109,11 @@ function logEntryStats(stats) {
 	if (format === "es" || format === "module") format = "esm";
 	const output = dim(path) + base;
 	const outputLength = output.length + 2;
-	cl$1(dim("+"), format.padEnd(5), output.padEnd(outputLength), dim(`[${formatBytes(stats.size)}, ${formatMs(stats.buildTime)}]`));
-	if (stats.logs) for (const log of stats.logs) cl$1("!", log.level.padEnd(5), output.padEnd(outputLength), dim(log.log.message));
+	cl(dim("+"), format.padEnd(5), output.padEnd(outputLength), dim(`[${formatBytes(stats.size)}, ${formatMs(stats.buildTime)}]`));
+	if (stats.logs) for (const log of stats.logs) cl("!", log.level.padEnd(5), output.padEnd(outputLength), dim(log.log.message));
 }
 async function build(options) {
-	const { cwd: cwdir = cwd(), outDir = "dist", entries, externals, tsconfig, hooks, minify } = options;
+	const { cwd: cwdir = cwd(), outDir = "dist", entries, externals, tsconfig, hooks, minify, comments } = options;
 	let start = 0;
 	const buildStats = {
 		cwd: cwdir,
@@ -168,7 +168,12 @@ async function build(options) {
 					name: entry.name,
 					globals: entry.globals,
 					extend: entry.extend,
-					plugins: entry.paths ? [outputPaths(entry.paths)] : void 0
+					plugins: entry.paths ? [outputPaths(entry.paths)] : void 0,
+					comments: entry.comments || comments || {
+						legal: true,
+						annotation: true,
+						jsdoc: false
+					}
 				};
 				const entryOptions = {
 					...entryInput,