@hypernym/bundler 0.1.1 → 0.1.2

package/dist/bin/index.mjs

@@ -25,7 +25,7 @@ const externals = [
 ];
 
 const name = "bundler";
-const version = `0.1.1`;
+const version = `0.1.2`;
 
 const cl = console.log;
 const log = (...args) => {
@@ -260,7 +260,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 +270,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 +279,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({

package/dist/types/index.d.ts

@@ -13,23 +13,74 @@ 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 BuildHooks {
     /**
@@ -59,6 +110,10 @@ 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)[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/bundler",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "author": "Hypernym Studio",
   "description": "ESM & TS module bundler.",
   "license": "MIT",