@hypernym/bundler 0.1.1 → 0.2.0

package/dist/bin/index.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import process, { stdout, cwd } from 'node:process';
+import process, { cwd } from 'node:process';
 import { createArgs } from '@hypernym/args';
-import { readFile, mkdir, writeFile, stat } from 'node:fs/promises';
+import { readFile, stat } from 'node:fs/promises';
 import { resolve, parse } from 'node:path';
-import { exists } from '@hypernym/utils/node';
-import { dim, magenta, red, cyan, green } from '@hypernym/colors';
+import { exists, writeFile } from '@hypernym/utils/fs';
+import { cyan, dim, red, magenta, green } from '@hypernym/colors';
 import { build as build$1, transform } from 'esbuild';
 import { createSpinner } from '@hypernym/spinner';
 import { isObject } from '@hypernym/utils';
@@ -25,31 +25,28 @@ const externals = [
 ];
 
 const name = "bundler";
-const version = `0.1.1`;
+const version = `0.2.0`;
 
 const cl = console.log;
-const log = (...args) => {
-  let length = args.length + 2;
-  const cols = stdout.columns || 80;
-  const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-  for (const arg of args) {
-    length = length + arg.replace(/\u001b\[.*?m/g, "").length;
-  }
-  const repeatLength = cols <= length + time.length ? 0 : cols - (length + time.length);
-  return cl(...args, " ".repeat(repeatLength), dim(time));
-};
 const logger = {
+  info: (...args) => {
+    const time = `[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`;
+    return cl(cyan(name), dim(time), ...args);
+  },
+  error: (...args) => {
+    const time = `[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`;
+    return cl(red(name), dim(time), ...args);
+  },
   exit: (message) => {
-    cl();
-    log(dim(name), dim(version));
-    log(magenta(name), message);
-    cl();
+    const time = `[${(/* @__PURE__ */ new Date()).toLocaleTimeString()}]`;
+    cl(magenta(name), dim(time), version);
+    cl(magenta(name), dim(time), message);
     return process.exit(1);
   }
 };
 
 function error(err) {
-  log(red(name), "Something went wrong...");
+  logger.error("Something went wrong...");
   console.error(err);
   return process.exit(1);
 }
@@ -106,9 +103,7 @@ async function loadConfig(cwd, filePath, defaults) {
     packages: "external"
   });
   const code = result.outputFiles[0].text;
-  const tempDir = resolve(cwd, "node_modules", ".hypernym", "bundler");
-  const tempConfig = resolve(tempDir, "config.mjs");
-  await mkdir(tempDir, { recursive: true });
+  const tempConfig = resolve(cwd, "node_modules/.hypernym/bundler/config.mjs");
   await writeFile(tempConfig, code, "utf-8");
   const content = await import(tempConfig);
   const config = {
@@ -201,8 +196,8 @@ async function build(cwd, options) {
     buildTime: 0,
     files: []
   };
-  if (hooks?.["build:before"])
-    await hooks["build:before"](options);
+  if (hooks?.["build:start"])
+    await hooks["build:start"](options, buildStats);
   if (options.entries) {
     start = Date.now();
     for (const entry of options.entries) {
@@ -260,7 +255,7 @@ async function build(cwd, options) {
         buildStats.size = buildStats.size + stats.size;
       }
       if ("types" in entry) {
-        const { types, plugins } = entry;
+        const { types, externals, plugins, banner, footer } = entry;
         const buildLogs = [];
         const _output = getOutputPath(outDir, types, true);
         let _format = "esm";
@@ -270,6 +265,7 @@ async function build(cwd, options) {
         const format = entry.format || _format;
         const builder = await rollup({
           input: resolve(cwd, types),
+          external: externals || options.externals,
           plugins: [dts(plugins?.dts)],
           onLog: (level, log) => {
             if (logFilter(log))
@@ -278,7 +274,9 @@ async function build(cwd, options) {
         });
         await builder.write({
           file: resolve(cwd, output),
-          format
+          format,
+          banner,
+          footer
         });
         const stats = await stat(resolve(cwd, output));
         buildStats.files.push({
@@ -293,33 +291,24 @@ async function build(cwd, options) {
     }
     buildStats.buildTime = Date.now() - start;
   }
-  if (hooks?.["build:done"])
-    await hooks["build:done"](options);
+  if (hooks?.["build:end"])
+    await hooks["build:end"](options, buildStats);
   return buildStats;
 }
 
 async function createBuilder(cwd, args, options) {
+  const { hooks } = options;
+  if (hooks?.["bundle:start"])
+    await hooks["bundle:start"](options);
+  logger.info(version);
+  logger.info(`Bundling started...`);
   const spinner = createSpinner();
-  cl();
-  log(dim(name), dim(version));
-  log(cyan(name), `Bundling started...`);
   spinner.start({
     message: `Transforming modules ${green("for production...")}`
   });
-  return await build(cwd, options).then((stats) => {
+  await build(cwd, options).then((stats) => {
     spinner.stop({
-      message: `Modules transformation is ${green("done!")}`,
-      template: (mark, message) => {
-        const temp = `${mark}${message}`;
-        const cols = stdout.columns || 80;
-        const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-        const length = (
-          // eslint-disable-next-line no-control-regex
-          temp.replace(/\u001b\[.*?m/g, "").length + time.length + 1
-        );
-        const repeatLength = cols <= length ? 0 : cols - length;
-        return temp + " ".repeat(repeatLength) + dim(time);
-      }
+      message: `Modules transformation is ${green("done!")}`
     });
     const check = green("\u2714");
     const info = cyan("i");
@@ -333,9 +322,9 @@ async function createBuilder(cwd, args, options) {
     const longestSize = Math.max(
       ...stats.files.map((v) => formatBytes(v.size).length)
     );
-    log(check, `Bundling completed in ${buildTime}`);
-    log(check, `${modules} modules transformed. Total size is ${buildSize}`);
-    log(info, "Individual stats per module");
+    cl(check, `Bundling completed in ${buildTime}`);
+    cl(check, `${modules} modules transformed. Total size is ${buildSize}`);
+    cl(info, "Individual stats per module");
     for (const file of stats.files) {
       let format = file.format;
       const base = parse(file.path).base;
@@ -349,11 +338,11 @@ async function createBuilder(cwd, args, options) {
       if (base.includes(".d."))
         format = "dts";
       if (file.logs) {
-        for (const log2 of file.logs) {
-          cl(magenta("!"), magenta(log2.log.message));
+        for (const log of file.logs) {
+          cl(magenta("!"), magenta(log.log.message));
         }
       }
-      log(
+      cl(
         info,
         dim("\u251C\u2500"),
         dim(path) + cyan(base),
@@ -365,7 +354,7 @@ async function createBuilder(cwd, args, options) {
         dim(formatBytes(file.size).padStart(longestSize))
       );
     }
-    log(
+    logger.info(
       check,
       `Bundle is now fully generated and ready ${green("for production!")}`
     );
@@ -374,10 +363,12 @@ async function createBuilder(cwd, args, options) {
       mark: red("\u2716"),
       message: `Modules transformation is ${red("interupted!")}`
     });
-    log(red(name), "Something went wrong...");
+    logger.error("Something went wrong...");
     console.error(err);
     return process.exit(1);
   });
+  if (hooks?.["bundle:end"])
+    await hooks["bundle:end"](options);
 }
 
 async function main() {

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-import { OutputOptions } from 'rollup';
+import { OutputOptions, LogLevel, RollupLog } from 'rollup';
 import { RollupReplaceOptions } from '@rollup/plugin-replace';
 import { RollupJsonOptions } from '@rollup/plugin-json';
 import { RollupNodeResolveOptions } from '@rollup/plugin-node-resolve';
@@ -13,33 +13,109 @@ interface BuildPlugins {
     replace?: RollupReplaceOptions;
 }
 
-interface Entries {
+interface Entry {
+    /**
+     * Specifies the path of the transformed module.
+     *
+     * If not specified, matches the `input` path with the appropriate extension.
+     *
+     * @default undefined
+     */
     output?: string;
+    /**
+     * Specifies the format of the generated module.
+     *
+     * @default 'esm'
+     */
     format?: OutputOptions['format'];
+    /**
+     * Specifies the module IDs, or regular expressions to match module IDs,
+     * that should remain external to the bundle.
+     *
+     * If not specified, infers the IDs from the global `options.externals` option.
+     *
+     * @default undefined
+     */
     externals?: (string | RegExp)[];
+    /**
+     * Specifies the string to be inserted at the beginning of the module.
+     *
+     * @default undefined
+     */
+    banner?: OutputOptions['banner'];
+    /**
+     * Specifies the string to be inserted at the end of the module.
+     *
+     * @default undefined
+     */
+    footer?: OutputOptions['footer'];
+    /**
+     * Specifies custom filters that will display only certain log messages.
+     *
+     * @default undefined
+     */
     logFilter?: string[];
 }
-interface EntriesInput extends Entries {
+interface EntryInput extends Entry {
+    /**
+     * Specifies the path of the module's build source.
+     */
     input: string;
-    banner?: OutputOptions['banner'];
-    footer?: OutputOptions['footer'];
+    /**
+     * Specifies plugin options.
+     *
+     * @default undefined
+     */
     plugins?: BuildPlugins;
 }
-interface EntriesTypes extends Entries {
+interface EntryTypes extends Entry {
+    /**
+     * Specifies the path of the module's build source that contains only TS definitions.
+     */
     types: string;
+    /**
+     * Specifies plugin options.
+     *
+     * @default undefined
+     */
     plugins?: Pick<BuildPlugins, 'dts'>;
 }
-type EntriesOptions = EntriesInput | EntriesTypes;
+type EntriesOptions = EntryInput | EntryTypes;
+
+interface BuildLogs {
+    level: LogLevel;
+    log: RollupLog;
+}
+interface BuildStats {
+    cwd: string;
+    size: number;
+    buildTime: number;
+    files: {
+        path: string;
+        size: number;
+        buildTime: number;
+        format: string;
+        logs: BuildLogs[];
+    }[];
+}
 
-interface BuildHooks {
+interface HooksOptions {
     /**
      * Called just before bundling started.
      */
-    'build:before'?: (options?: Options) => void | Promise<void>;
+    'bundle:start'?: (options?: Options) => void | Promise<void>;
+    /**
+     * Called just before building started.
+     */
+    'build:start'?: (options?: Options, buildStats?: BuildStats) => void | Promise<void>;
+    /**
+     * Called right after building is complete.
+     */
+    'build:end'?: (options?: Options, buildStats?: BuildStats) => void | Promise<void>;
     /**
      * Called right after bundling is complete.
      */
-    'build:done'?: (options?: Options) => void | Promise<void>;
+    'bundle:end'?: (options?: Options) => void | Promise<void>;
 }
 
 interface Options {
@@ -59,15 +135,19 @@ interface Options {
      * Specifies the module IDs, or regular expressions to match module IDs,
      * that should remain external to the bundle.
      *
+     * IDs and regexps from this option are applied globally to all entries.
+     *
+     * Also, it is possible to define externals individually per entry (`entry.externals`).
+     *
      * @default [/^node:/, /^@types/, /^@rollup/, /^@hypernym/, /^rollup/, ...pkg.dependencies]
      */
     externals?: (string | RegExp)[];
     /**
-     * Provides a powerful hooking system to further expand build mode.
+     * Provides a powerful hooking system to further expand bundling mode.
      *
      * @default undefined
      */
-    hooks?: BuildHooks;
+    hooks?: HooksOptions;
 }
 
 declare const externals: RegExp[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/bundler",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "author": "Hypernym Studio",
   "description": "ESM & TS module bundler.",
   "license": "MIT",
@@ -8,6 +8,7 @@
   "homepage": "https://github.com/hypernym-studio/bundler",
   "funding": "https://github.com/sponsors/ivodolenc",
   "type": "module",
+  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
@@ -55,22 +56,22 @@
     }
   },
   "dependencies": {
-    "@hypernym/args": "^0.2.0",
-    "@hypernym/colors": "^1.0.0",
-    "@hypernym/spinner": "^0.1.0",
-    "@hypernym/utils": "^2.0.2",
+    "@hypernym/args": "^0.2.1",
+    "@hypernym/colors": "^1.0.1",
+    "@hypernym/spinner": "^0.2.0",
+    "@hypernym/utils": "^2.1.0",
     "@rollup/plugin-json": "^6.0.1",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-replace": "^5.0.3",
     "esbuild": "^0.19.4",
-    "rollup": "^4.0.2",
+    "rollup": "^4.1.1",
     "rollup-plugin-dts": "^6.1.0"
   },
   "devDependencies": {
-    "@hypernym/eslint-config": "^2.0.1",
-    "@hypernym/prettier-config": "^2.0.1",
+    "@hypernym/eslint-config": "^2.0.2",
+    "@hypernym/prettier-config": "^2.0.2",
     "@hypernym/tsconfig": "^1.1.0",
-    "@types/node": "^20.8.4",
+    "@types/node": "^20.8.6",
     "eslint": "^8.51.0",
     "prettier": "^3.0.3",
     "tsx": "^3.13.0",