@hypernym/bundler 0.31.3 → 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.3`;
+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/,

package/dist/build/index.js

@@ -113,7 +113,7 @@ function logEntryStats(stats) {
 	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,

package/dist/index.d.ts

@@ -170,6 +170,19 @@ interface EntryBase {
    * @default undefined
    */
   tsconfig?: InputOptions['tsconfig'];
+  /**
+   * 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.
+   *
+   * @default { legal: true, annotation: true, jsdoc: false }
+   */
+  comments?: OutputOptions['comments'];
 }
 interface EntryChunk extends EntryBase {
   /**
@@ -465,10 +478,10 @@ interface Options {
   /**
    * 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.
    *
    * @example
    *
@@ -524,6 +537,20 @@ interface Options {
    * @default undefined
    */
   tsconfig?: string;
+  /**
+   * Specifies which comments are preserved in the output.
+   *
+   * @example
+   *
+   * ```ts
+   * export default defineConfig({
+   *   comments: true,
+   * })
+   * ```
+   *
+   * @default { legal: true, annotation: true, jsdoc: false }
+   */
+  comments?: OutputOptions['comments'];
 }
 //#endregion
 //#region src/types/hooks.d.ts

package/dist/index.js

@@ -1,24 +1,6 @@
 export * from "./build/index.js"
 
 //#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/,
@@ -28,25 +10,6 @@ const externals = [
 	/^rollup/,
 	/^rolldown/
 ];
-/**
-* ESM & TS module bundler.
-*
-* Automatically detects a custom configuration file at the project root, which can override or extend the build behavior.
-*
-* Configuration file also accepts `.js`, `.mjs`, `.ts`, `.mts` formats.
-*
-* @example
-*
-* ```ts
-* import { defineConfig } from '@hypernym/bundler'
-*
-* export default defineConfig({
-*   // ...
-* })
-* ```
-*
-* @see [Repository](https://github.com/hypernym-studio/bundler)
-*/
 function defineConfig(options) {
 	return options;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/bundler",
-  "version": "0.31.3",
+  "version": "0.32.0",
   "author": "Hypernym Studio",
   "description": "ESM & TS module bundler.",
   "license": "MIT",
@@ -58,14 +58,14 @@
     "@hypernym/args": "^0.3.4",
     "@hypernym/colors": "^1.0.6",
     "@hypernym/utils": "^3.4.7",
-    "rolldown": "^1.0.0-rc.2",
-    "rolldown-plugin-dts": "^0.21.9"
+    "rolldown": "^1.0.0-rc.4",
+    "rolldown-plugin-dts": "^0.22.1"
   },
   "devDependencies": {
     "@hypernym/eslint-config": "^3.6.7",
     "@hypernym/prettier-config": "^3.2.11",
     "@hypernym/tsconfig": "^2.6.5",
-    "@types/node": "^24.10.10",
+    "@types/node": "^24.10.13",
     "eslint": "^9.39.2",
     "prettier": "^3.8.1",
     "typescript": "^5.9.3"