@hypernym/bundler 0.13.0 → 0.14.0

package/README.md

@@ -58,7 +58,7 @@ import { defineConfig } from '@hypernym/bundler'
 export default defineConfig({
   entries: [
     { input: './src/index.ts' },
-    { declaration: './src/types/index.ts' },
+    { dts: './src/types/index.ts' },
     {
       input: './src/utils/index.ts',
       output: './dist/utils/utils.min.mjs',
@@ -99,11 +99,34 @@ Set a custom config path via the CLI command:
 npx hyperbundler --config hyper.config.ts
 ```
 
-## Options
+## Formats
+
+During transformation, file formats are automatically resolved and in most cases there is no need for additional configuration.
+
+`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`.
+
+Formats can also be explicitly specified for each entry, if necessary.
+
+### Inputs
+
+Default transformation behaviour 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`
 
-All options are documented with descriptions and examples so auto-completion will be offered as you type.
+### Declarations
 
-Simply hover over the property and see what it does in the `quickinfo`.
+Default transformation behaviour for all `dts` entries:
+
+- `./srcDir/file.ts` resolves to `./outDir/file.d.mts`
+
+## Options
+
+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`.
 
 ### entries
 
@@ -121,7 +144,7 @@ import { defineConfig } from '@hypernym/bundler'
 export default defineConfig({
   entries: [
     { input: './src/index.ts' }, // => './dist/index.mjs'
-    { declaration: './src/types.ts' }, // => './dist/types.d.ts'
+    { dts: './src/types.ts' }, // => './dist/types.d.mts'
     // ...
   ],
 })
@@ -140,9 +163,7 @@ import { defineConfig } from '@hypernym/bundler'
 
 export default defineConfig({
   entries: [
-    {
-      input: './src/index.ts', // => './dist/index.mjs'
-    },
+    { input: './src/index.ts' }, // => './dist/index.mjs'
   ],
 })
 ```
@@ -160,9 +181,19 @@ import { defineConfig } from '@hypernym/bundler'
 
 export default defineConfig({
   entries: [
-    {
-      { declaration: './src/types.ts' }, // => './dist/types.d.ts'
-    },
+    { declaration: './src/types.ts' }, // => './dist/types.d.mts'
+  ],
+})
+```
+
+Also, it is possible to use `dts` alias.
+
+```ts
+import { defineConfig } from '@hypernym/bundler'
+
+export default defineConfig({
+  entries: [
+    { dts: './src/types.ts' }, // => './dist/types.d.mts'
   ],
 })
 ```
@@ -373,7 +404,7 @@ export default defineConfig({
 
 ### build:entry:start
 
-- Type: `(options: BuildEntryOptions, stats: BuildStats) => void | Promise<void>`
+- Type: `(entry: BuildEntryOptions, stats: BuildEntryStats) => void | Promise<void>`
 - Default: `undefined`
 
 Called on each entry just before the build process.
@@ -388,12 +419,12 @@ import { plugin1, plugin2 } from './src/utils/plugins.js'
 
 export default defineConfig({
   hooks: {
-    'build:entry:start': async (options, stats) => {
+    'build:entry:start': async (entry, stats) => {
       // adds custom plugins for a specific entry only
-      if (options.input?.includes('./src/index.ts')) {
-        options.defaultPlugins = [
+      if (entry.input?.includes('./src/index.ts')) {
+        entry.defaultPlugins = [
           plugin1(), // adds a custom plugin before the default bundler plugins
-          ...options.defaultPlugins, // list of default bundler plugins
+          ...entry.defaultPlugins, // list of default bundler plugins
           plugin2(), // adds a custom plugin after the default bundler plugins
         ]
       }
@@ -404,7 +435,7 @@ export default defineConfig({
 
 ### build:entry:end
 
-- Type: `(options: BuildEntryOptions, stats: BuildStats) => void | Promise<void>`
+- Type: `(entry: BuildEntryOptions, stats: BuildEntryStats) => void | Promise<void>`
 - Default: `undefined`
 
 Called on each entry right after the build process is completed.
@@ -416,7 +447,7 @@ import { defineConfig } from '@hypernym/bundler'
 
 export default defineConfig({
   hooks: {
-    'build:entry:end': async (options, stats) => {
+    'build:entry:end': async (entry, stats) => {
       // ...
     },
   },

package/dist/bin/index.mjs

@@ -3,7 +3,7 @@ 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, isUndefined, isObject } from '@hypernym/utils';
@@ -25,24 +25,23 @@ const externals = [
 ];
 
 const logo = `\u2726\u2726`;
-const name$1 = "hyperbundler";
-const logoname = `${logo} ${name$1}`;
-const version = `0.13.0`;
+const version = `0.14.0`;
 
-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();
   }
 };
@@ -74,17 +73,35 @@ function formatBytes(bytes) {
   return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${units[i]}`;
 }
 
-function getOutputPath(outDir, input, types = false) {
+function getOutputPath(outDir, input, dts) {
   const _input = input.startsWith("./") ? input.slice(2) : input;
   let output = _input.replace(_input.split("/")[0], outDir);
-  const ts = types ? "d.ts" : "mjs";
-  const mts = types ? "d.mts" : "mjs";
-  const cts = types ? "d.cts" : "cjs";
-  if (output.endsWith(".ts")) output = `${output.slice(0, -2)}${ts}`;
-  if (output.endsWith(".mts")) output = `${output.slice(0, -3)}${mts}`;
-  if (output.endsWith(".cts")) output = `${output.slice(0, -3)}${cts}`;
+  const ext = dts ? "d.mts" : "mjs";
+  const cts = dts ? "d.cts" : "cjs";
+  if (output.endsWith(".js")) output = `${output.slice(0, -2)}${ext}`;
+  else if (output.endsWith(".ts")) output = `${output.slice(0, -2)}${ext}`;
+  else if (output.endsWith(".mts")) output = `${output.slice(0, -3)}${ext}`;
+  else if (output.endsWith(".cts")) output = `${output.slice(0, -3)}${cts}`;
   if (outDir.startsWith("./") || outDir.startsWith("../")) return output;
-  return `./${output}`;
+  else return `./${output}`;
+}
+
+function getLongestOutput(outDir, entries) {
+  const outputs = [];
+  for (const entry of entries) {
+    if (entry.copy) outputs.push(entry.copy.output);
+    if (entry.input) {
+      const out = entry.output || getOutputPath(outDir, entry.input);
+      outputs.push(out);
+    }
+    if (entry.declaration || entry.dts) {
+      const dts = entry.declaration || entry.dts;
+      const out = entry.output || getOutputPath(outDir, dts, true);
+      outputs.push(out);
+    }
+    if (entry.template) outputs.push(entry.output);
+  }
+  return Math.max(...outputs.map((v) => v.length));
 }
 
 async function loadConfig(cwd, filePath, defaults) {
@@ -186,7 +203,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 +211,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 +249,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 = {
@@ -265,6 +297,7 @@ async function build(cwd, options) {
             else return `./${path}`;
           };
           const fileStats = {
+            cwd,
             path: `${parseOutput(_entry.output)}/${parseInput(copyInput)}`,
             size: totalSize,
             buildTime: Date.now() - entryStart,
@@ -273,36 +306,27 @@ async function build(cwd, options) {
           };
           buildStats.files.push(fileStats);
           buildStats.size = buildStats.size + stats.size;
-          logModuleStats(fileStats);
+          logModuleStats(fileStats, longestOutput);
         }
       }
       if (entry.input) {
         const logFilter = getLogFilter(entry.logFilter || []);
-        const _output = getOutputPath(outDir, entry.input);
+        const _output = entry.output || getOutputPath(outDir, entry.input);
         let _format = "esm";
         if (_output.endsWith(".cjs")) _format = "cjs";
         const buildLogs = [];
         const _entry = {
           input: entry.input,
-          output: entry.output || _output,
+          output: _output,
           externals: entry.externals || options.externals,
           format: entry.format || _format,
-          transformers: entry.transformers,
+          ...entry,
           defaultPlugins: [
             esbuild({
               minify: !isUndefined(entry.minify) ? entry.minify : options.minify,
               ...entry.transformers?.esbuild
             })
-          ],
-          plugins: entry.plugins,
-          banner: entry.banner,
-          footer: entry.footer,
-          intro: entry.intro,
-          outro: entry.outro,
-          paths: entry.paths,
-          name: entry.name,
-          globals: entry.globals,
-          extend: entry.extend
+          ]
         };
         if (!entry.plugins) {
           if (_entry.transformers?.json) {
@@ -312,7 +336,7 @@ async function build(cwd, options) {
           if (_entry.transformers?.replace) {
             _entry.defaultPlugins.unshift(
               replacePlugin({
-                true: true,
+                preventAssignment: true,
                 ..._entry.transformers.replace
               })
             );
@@ -325,7 +349,15 @@ async function build(cwd, options) {
             aliasPlugin(_entry.transformers?.alias || aliasOptions)
           );
         }
-        await hooks?.["build:entry:start"]?.(_entry, buildStats);
+        const fileStats = {
+          cwd,
+          path: _entry.output,
+          size: 0,
+          buildTime: entryStart,
+          format: _entry.format,
+          logs: buildLogs
+        };
+        await hooks?.["build:entry:start"]?.(_entry, fileStats);
         const _build = await rollup({
           input: resolve(cwd, _entry.input),
           external: _entry.externals,
@@ -347,46 +379,42 @@ async function build(cwd, options) {
           extend: _entry.extend
         });
         const stats = await stat(resolve(cwd, _entry.output));
-        const file = {
-          path: _entry.output,
-          size: stats.size,
-          buildTime: Date.now() - entryStart,
-          format: _entry.format,
-          logs: buildLogs
-        };
-        buildStats.files.push(file);
+        fileStats.size = stats.size;
+        fileStats.buildTime = Date.now() - entryStart;
+        fileStats.logs = buildLogs;
+        buildStats.files.push(fileStats);
         buildStats.size = buildStats.size + stats.size;
-        logModuleStats(file);
-        await hooks?.["build:entry:end"]?.(_entry, buildStats);
+        logModuleStats(fileStats, longestOutput);
+        await hooks?.["build:entry:end"]?.(_entry, fileStats);
       }
-      if (entry.declaration) {
+      if (entry.dts || entry.declaration) {
         const logFilter = getLogFilter(entry.logFilter || []);
-        const _output = getOutputPath(outDir, entry.declaration, true);
-        let _format = "esm";
-        if (_output.endsWith(".d.cts")) _format = "cjs";
         const buildLogs = [];
+        const dts$1 = entry.dts || entry.declaration;
         const _entry = {
-          input: entry.declaration,
-          output: entry.output || _output,
+          dts: dts$1,
+          output: entry.output || getOutputPath(outDir, dts$1, true),
           externals: entry.externals || options.externals,
-          format: entry.format || _format,
-          transformers: entry.transformers,
-          defaultPlugins: [dts(entry.transformers?.dts)],
-          plugins: entry.plugins,
-          banner: entry.banner,
-          footer: entry.footer,
-          intro: entry.intro,
-          outro: entry.outro,
-          paths: entry.paths
+          format: entry.format || "esm",
+          ...entry,
+          defaultPlugins: [dts(entry.transformers?.dts)]
         };
         if (!entry.plugins) {
           _entry.defaultPlugins.unshift(
             aliasPlugin(_entry.transformers?.alias || aliasOptions)
           );
         }
-        await hooks?.["build:entry:start"]?.(_entry, buildStats);
+        const fileStats = {
+          cwd,
+          path: _entry.output,
+          size: 0,
+          buildTime: entryStart,
+          format: "dts",
+          logs: buildLogs
+        };
+        await hooks?.["build:entry:start"]?.(_entry, fileStats);
         const _build = await rollup({
-          input: resolve(cwd, _entry.input),
+          input: resolve(cwd, _entry.dts),
           external: _entry.externals,
           plugins: _entry.plugins || _entry.defaultPlugins,
           onLog: (level, log) => {
@@ -403,28 +431,21 @@ async function build(cwd, options) {
           paths: _entry.paths
         });
         const stats = await stat(resolve(cwd, _entry.output));
-        const fileStats = {
-          path: _entry.output,
-          size: stats.size,
-          buildTime: Date.now() - entryStart,
-          format: "dts",
-          logs: buildLogs
-        };
+        fileStats.size = stats.size;
+        fileStats.buildTime = Date.now() - entryStart;
+        fileStats.logs = buildLogs;
         buildStats.files.push(fileStats);
         buildStats.size = buildStats.size + stats.size;
-        logModuleStats(fileStats);
-        await hooks?.["build:entry:end"]?.(_entry, buildStats);
+        logModuleStats(fileStats, longestOutput);
+        await hooks?.["build:entry:end"]?.(_entry, fileStats);
       }
       if (entry.template && entry.output) {
         const buildLogs = [];
-        const _entry = {
-          template: entry.template,
-          output: entry.output
-        };
-        await write(_entry.output, _entry.template);
-        const stats = await stat(resolve(cwd, _entry.output));
+        await write(entry.output, entry.template);
+        const stats = await stat(resolve(cwd, entry.output));
         const fileStats = {
-          path: _entry.output,
+          cwd,
+          path: entry.output,
           size: stats.size,
           buildTime: Date.now() - entryStart,
           format: "tmp",
@@ -432,7 +453,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;
@@ -446,35 +467,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/index.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+const externals = [
+  /^node:/,
+  /^@types/,
+  /^@rollup/,
+  /^@hypernym/,
+  /^rollup/
+];
+function defineConfig(options) {
+  return options;
+}
+
+function resolvePaths(options) {
+  return (id) => {
+    for (const resolver of options) {
+      const { find, replacement } = resolver;
+      if (id.match(find)) id = replacement;
+    }
+    return id;
+  };
+}
+
+exports.defineConfig = defineConfig;
+exports.externals = externals;
+exports.resolvePaths = resolvePaths;