@hypernym/bundler 0.12.0 → 0.13.1

package/README.md

@@ -36,10 +36,6 @@
 
 1. Create a `bundler.config.ts` file at the root of your project:
 
-> [!NOTE]
->
-> Configuration also accepts `.js`, `.mjs`, `.ts`, `.mts` formats.
-
 ```ts
 // bundler.config.ts
 
@@ -66,9 +62,7 @@ export default defineConfig({
     {
       input: './src/utils/index.ts',
       output: './dist/utils/utils.min.mjs',
-      transformers: {
-        esbuild: { minify: true },
-      },
+      minify: true,
     },
     // ...
   ],
@@ -81,35 +75,33 @@ export default defineConfig({
 npx hyperbundler
 ```
 
-<details>
-<summary>CLI Output</summary>
+## Config
 
-<br>
-<p>Example of CLI Output:</p>
-
-```txt
-┌─────────────────┐
-│ ✦✦ HYPERBUNDLER │ v0.11.0
-└─────────────────┘
-i Config bundler.config.ts
-i Bundling started...
-* Processing [8:07:26 PM] Transforming files
-│
-├─ + esm ./dist/index.mjs (50ms) 313 B
-├─ + dts ./dist/types/index.d.ts (1.23s) 13.61 KB
-├─ + esm ./dist/bin/index.mjs (119ms) 16.53 KB
-│
-* Succeeded [8:07:28 PM] Module transformation is done
-✔ Bundling fully completed in 1.40s
-✔ 3 modules transformed. Total size is 30.45 KB
-✦✦ HYPERBUNDLER [8:07:28 PM] Bundle is generated and ready for production
+`Hyperbundler` automatically detects custom configuration from the project root that can override or extend the build behavior.
+
+Configuration file also accepts `.js`, `.mjs`, `.ts`, `.mts` formats.
+
+```ts
+// bundler.config.{js,mjs,ts,mts}
+
+import { defineConfig } from '@hypernym/bundler'
+
+export default defineConfig({
+  // ...
+})
 ```
 
-</details>
+### Custom path
+
+Set a custom config path via the CLI command:
+
+```sh
+npx hyperbundler --config hyper.config.ts
+```
 
 ## Options
 
-All options are documented with descriptions and examples, and auto-completion will be offered as you type.
+All options are documented with descriptions and examples so auto-completion will be offered as you type.
 
 Simply hover over the property and see what it does in the `quickinfo`.
 
@@ -294,6 +286,36 @@ Now imports can be used like this:
 import { module } from '#/utils' // #
 ```
 
+### minify
+
+- Type: `boolean`
+- Default: `undefined`
+
+Specifies the minification for all `chunk` entries.
+
+```ts
+// bundler.config.ts
+
+import { defineConfig } from '@hypernym/bundler'
+
+export default defineConfig({
+  minify: true,
+})
+```
+
+It can also be set per entry.
+
+```ts
+export default defineConfig({
+  entries: [
+    {
+      input: './src/index.ts',
+      minify: true,
+    },
+  ],
+})
+```
+
 ## Hooks
 
 List of lifecycle hooks that are called at various phases:
@@ -468,16 +490,6 @@ export default defineConfig({
 })
 ```
 
-## CLI
-
-### Custom Config
-
-Set a custom config path via the CLI command:
-
-```sh
-npx hyperbundler --config hyper.config.ts
-```
-
 ## Community
 
 Feel free to ask questions or share new ideas.

package/dist/bin/index.mjs

@@ -3,10 +3,10 @@ import process, { cwd } from 'node:process';
 import { createArgs } from '@hypernym/args';
 import { resolve, dirname, parse } from 'node:path';
 import { read, exists, write, copy, readdir } from '@hypernym/utils/fs';
-import { dim, cyan, bold, green } from '@hypernym/colors';
+import { dim, cyan } from '@hypernym/colors';
 import { build as build$1, transform } from 'esbuild';
 import { stat } from 'node:fs/promises';
-import { isString, isObject } from '@hypernym/utils';
+import { isString, isUndefined, isObject } from '@hypernym/utils';
 import { rollup } from 'rollup';
 import { getLogFilter } from 'rollup/getLogFilter';
 import replacePlugin from '@rollup/plugin-replace';
@@ -25,24 +25,23 @@ const externals = [
 ];
 
 const logo = `\u2726\u2726`;
-const name$1 = "hyperbundler";
-const logoname = `${logo} ${name$1}`;
-const version = `0.12.0`;
+const version = `0.13.1`;
 
-const name = logoname.toUpperCase();
 const cl = console.log;
+const separator = `/`;
 const logger = {
   info: (...args) => {
-    const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-    return cl(name, dim(`[${time}]`), ...args);
+    cl(logo, dim(separator), ...args);
   },
   error: (...args) => {
-    const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-    return cl(name, dim(`[${time}]`), ...args);
+    cl();
+    cl(logo, dim(separator), ...args);
+    cl();
   },
   exit: (message) => {
-    const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-    cl(name, dim(`[${time}]`), message);
+    cl();
+    cl(logo, dim(separator), message);
+    cl();
     return process.exit();
   }
 };
@@ -87,6 +86,28 @@ function getOutputPath(outDir, input, types = false) {
   return `./${output}`;
 }
 
+function getLongestOutput(outDir, entries) {
+  const outputs = [];
+  for (const entry of entries) {
+    if ("copy" in entry && entry.copy) {
+      const out = entry.copy.output;
+      outputs.push(out);
+    }
+    if ("input" in entry && entry.input) {
+      const out = entry.output || getOutputPath(outDir, entry.input);
+      outputs.push(out);
+    }
+    if ("declaration" in entry && entry.declaration) {
+      const out = entry.output || getOutputPath(outDir, entry.declaration, true);
+      outputs.push(out);
+    }
+    if ("template" in entry && entry.template) {
+      outputs.push(entry.output);
+    }
+  }
+  return Math.max(...outputs.map((v) => v.length));
+}
+
 async function loadConfig(cwd, filePath, defaults) {
   const result = await build$1({
     entryPoints: [resolve(cwd, filePath)],
@@ -186,7 +207,7 @@ function esbuild(options) {
   };
 }
 
-function logModuleStats(file) {
+function logModuleStats(file, longestOutput) {
   const cl = console.log;
   const base = parse(file.path).base;
   const path = file.path.replace(base, "");
@@ -194,16 +215,30 @@ function logModuleStats(file) {
   if (format.includes("system")) format = "sys";
   if (format === "commonjs") format = "cjs";
   if (format === "module") format = "esm";
+  longestOutput = longestOutput + 2;
+  const ansiCode = 9;
+  const pathDim = dim(path);
+  const output = pathDim + base;
+  const pathDimNoAnsi = pathDim.length - ansiCode;
+  const difference = longestOutput - pathDimNoAnsi - base.length;
+  const padLength = output.length + difference;
   cl(
-    dim("\u251C\u2500"),
-    `+ ${format}`,
-    dim(path) + base,
-    dim(`(${formatMs(file.buildTime)})`),
+    dim("+"),
+    format.padEnd(5),
+    output.padEnd(padLength),
+    dim("time"),
+    formatMs(file.buildTime).padEnd(7),
+    dim("size"),
     formatBytes(file.size)
   );
   if (file.logs) {
     for (const log of file.logs) {
-      cl(dim("\u251C\u2500"), `! ${log.level}`, dim(path) + base, dim(log.log.message));
+      cl(
+        dim("!"),
+        log.level.padEnd(5),
+        output.padEnd(padLength),
+        dim(log.log.message)
+      );
     }
   }
 }
@@ -218,6 +253,7 @@ async function build(cwd, options) {
   };
   await hooks?.["build:start"]?.(options, buildStats);
   if (options.entries) {
+    const longestOutput = getLongestOutput(outDir, options.entries);
     start = Date.now();
     const aliasDir = resolve(cwd, "./src");
     let aliasOptions = {
@@ -273,7 +309,7 @@ async function build(cwd, options) {
           };
           buildStats.files.push(fileStats);
           buildStats.size = buildStats.size + stats.size;
-          logModuleStats(fileStats);
+          logModuleStats(fileStats, longestOutput);
         }
       }
       if (entry.input) {
@@ -288,7 +324,12 @@ async function build(cwd, options) {
           externals: entry.externals || options.externals,
           format: entry.format || _format,
           transformers: entry.transformers,
-          defaultPlugins: [esbuild(entry.transformers?.esbuild)],
+          defaultPlugins: [
+            esbuild({
+              minify: !isUndefined(entry.minify) ? entry.minify : options.minify,
+              ...entry.transformers?.esbuild
+            })
+          ],
           plugins: entry.plugins,
           banner: entry.banner,
           footer: entry.footer,
@@ -351,7 +392,7 @@ async function build(cwd, options) {
         };
         buildStats.files.push(file);
         buildStats.size = buildStats.size + stats.size;
-        logModuleStats(file);
+        logModuleStats(file, longestOutput);
         await hooks?.["build:entry:end"]?.(_entry, buildStats);
       }
       if (entry.declaration) {
@@ -407,7 +448,7 @@ async function build(cwd, options) {
         };
         buildStats.files.push(fileStats);
         buildStats.size = buildStats.size + stats.size;
-        logModuleStats(fileStats);
+        logModuleStats(fileStats, longestOutput);
         await hooks?.["build:entry:end"]?.(_entry, buildStats);
       }
       if (entry.template && entry.output) {
@@ -427,7 +468,7 @@ async function build(cwd, options) {
         };
         buildStats.files.push(fileStats);
         buildStats.size = buildStats.size + stats.size;
-        logModuleStats(fileStats);
+        logModuleStats(fileStats, longestOutput);
       }
     }
     buildStats.buildTime = Date.now() - start;
@@ -441,35 +482,28 @@ async function createBuilder(cwd, config) {
   const { hooks } = options;
   const cl = console.log;
   await hooks?.["bundle:start"]?.(options);
-  const line = "\u2500".repeat(logoname.length + 2);
-  cl();
-  cl(dim(`\u250C${line}\u2510`));
-  cl(dim("\u2502"), `${logoname.toUpperCase()}`, dim("\u2502"), dim(`v${version}`));
-  cl(dim(`\u2514${line}\u2518`));
-  cl(dim(bold("i")), "Config", dim(configPath));
-  cl(dim(bold("i")), "Bundling started...");
+  logger.info(dim(`v${version}`));
+  cl("Config", dim(configPath));
+  cl("Bundling started...");
   cl(
-    dim(bold("*")),
     "Processing",
     dim(`[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`),
     "Transforming files"
   );
-  cl(dim("\u2502"));
+  cl();
   await build(cwd, options).then((stats) => {
-    const check = green(bold("\u2714"));
-    const buildTime = green(formatMs(stats.buildTime));
-    const buildSize = green(formatBytes(stats.size));
+    const buildTime = dim(formatMs(stats.buildTime));
+    const buildSize = dim(formatBytes(stats.size));
     const totalModules = stats.files.length;
-    const modules = totalModules > 1 ? `${green(totalModules)} modules` : `${green(totalModules)} module`;
-    cl(dim("\u2502"));
+    const modules = totalModules > 1 ? `${totalModules} modules` : `${totalModules} module`;
+    cl();
     cl(
-      dim(bold("*")),
       "Succeeded",
       dim(`[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`),
       "Module transformation is done"
     );
-    cl(check, `Bundling fully completed in ${buildTime}`);
-    cl(check, `${modules} transformed. Total size is ${buildSize}`);
+    cl(`Bundling fully completed in ${buildTime}`);
+    cl(`${modules} transformed. Total size is ${buildSize}`);
     logger.info(`Bundle is generated and ready for production`);
     cl();
   }).catch(error);

package/dist/types/index.d.ts

@@ -126,6 +126,12 @@ interface EntryChunk extends EntryBase {
      * Intended for `umd/iife` formats.
      */
     extend?: OutputOptions['extend'];
+    /**
+     * Minifies the generated code if enabled.
+     *
+     * @default undefined
+     */
+    minify?: boolean;
     declaration?: never;
     copy?: never;
     template?: never;
@@ -158,6 +164,7 @@ interface EntryDeclaration extends EntryBase {
     name?: never;
     globals?: never;
     extend?: never;
+    minify?: never;
 }
 interface CopyOptions {
     /**
@@ -213,6 +220,7 @@ interface EntryCopy {
     name?: never;
     globals?: never;
     extend?: never;
+    minify?: never;
 }
 interface EntryTemplate {
     /**
@@ -244,6 +252,7 @@ interface EntryTemplate {
     name?: never;
     globals?: never;
     extend?: never;
+    minify?: never;
 }
 type EntryOptions = EntryChunk | EntryDeclaration | EntryCopy | EntryTemplate;
 
@@ -350,6 +359,33 @@ interface Options {
      * @default undefined
      */
     alias?: Alias[];
+    /**
+     * Specifies the minification for all `chunk` entries.
+     *
+     * @example
+     *
+     * ```ts
+     * export default defineConfig({
+     *   minify: true,
+     * })
+     * ```
+     *
+     * It can also be set per entry.
+     *
+     * ```ts
+     * export default defineConfig({
+     *   entries: [
+     *     {
+     *       input: './src/index.ts',
+     *       minify: true,
+     *     },
+     *   ],
+     * })
+     * ```
+     *
+     * @default undefined
+     */
+    minify?: boolean;
 }
 
 interface BuildLogs {
@@ -545,6 +581,21 @@ interface ConfigLoader {
  * ```
  */
 declare const externals: RegExp[];
+/**
+ * `Hyperbundler` automatically detects custom configuration from the project root that 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({
+ *   // ...
+ * })
+ * ```
+ */
 declare function defineConfig(options: Options): Options;
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/bundler",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "author": "Hypernym Studio",
   "description": "ESM & TS module bundler.",
   "license": "MIT",
@@ -20,14 +20,13 @@
   ],
   "keywords": [
     "module",
-    "modules",
     "bundling",
     "javascript",
     "typescript",
     "hyperbundler",
+    "declarations",
     "bundler",
     "builder",
-    "package",
     "bundle",
     "types",
     "build",
@@ -66,13 +65,13 @@
     "@hypernym/args": "^0.3.0",
     "@hypernym/colors": "^1.0.1",
     "@hypernym/utils": "^3.4.0",
-    "@rollup/plugin-alias": "^5.1.0",
+    "@rollup/plugin-alias": "^5.1.1",
     "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-node-resolve": "^15.2.4",
     "@rollup/plugin-replace": "^5.0.7",
-    "@rollup/pluginutils": "^5.1.0",
-    "esbuild": "^0.23.1",
-    "rollup": "^4.22.2",
+    "@rollup/pluginutils": "^5.1.1",
+    "esbuild": "^0.24.0",
+    "rollup": "^4.22.4",
     "rollup-plugin-dts": "^6.1.1"
   },
   "devDependencies": {
@@ -80,7 +79,7 @@
     "@hypernym/prettier-config": "^3.2.0",
     "@hypernym/tsconfig": "^2.4.0",
     "@types/node": "^22.5.5",
-    "eslint": "^9.10.0",
+    "eslint": "^9.11.0",
     "prettier": "^3.3.3",
     "typescript": "^5.5.4"
   }