@hypernym/bundler 0.4.0 → 0.6.0

package/dist/bin/_empty.ts

@@ -0,0 +1 @@
+// Generated by @hypernym/bundler

package/dist/bin/index.mjs

@@ -7,6 +7,7 @@ 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 { fileURLToPath } from 'node:url';
 import { isObject } from '@hypernym/utils';
 import { rollup } from 'rollup';
 import { getLogFilter } from 'rollup/getLogFilter';
@@ -25,7 +26,7 @@ const externals = [
 ];
 
 const name = "bundler";
-const version = `0.4.0`;
+const version = `0.6.0`;
 
 const cl = console.log;
 const logger = {
@@ -202,7 +203,7 @@ async function build(cwd, options) {
     start = Date.now();
     for (const entry of options.entries) {
       const entryStart = Date.now();
-      const logFilter = getLogFilter(entry.logFilter || []);
+      let logFilter = getLogFilter(entry.logFilter || []);
       if ("input" in entry) {
         const _output = getOutputPath(outDir, entry.input);
         let _format = "esm";
@@ -217,7 +218,13 @@ async function build(cwd, options) {
           plugins: [esbuild(entry.plugins?.esbuild)],
           pluginsOptions: entry.plugins,
           banner: entry.banner,
-          footer: entry.footer
+          footer: entry.footer,
+          intro: entry.intro,
+          outro: entry.outro,
+          paths: entry.paths,
+          name: entry.name,
+          globals: entry.globals,
+          extend: entry.extend
         };
         if (_entry.pluginsOptions?.json) {
           const jsonOptions = isObject(_entry.pluginsOptions.json) ? _entry.pluginsOptions.json : void 0;
@@ -251,7 +258,13 @@ async function build(cwd, options) {
           file: resolve(cwd, _entry.output),
           format: _entry.format,
           banner: _entry.banner,
-          footer: _entry.footer
+          footer: _entry.footer,
+          intro: _entry.intro,
+          outro: _entry.outro,
+          paths: _entry.paths,
+          name: _entry.name,
+          globals: _entry.globals,
+          extend: _entry.extend
         });
         const stats = await stat(resolve(cwd, _entry.output));
         buildStats.files.push({
@@ -280,7 +293,10 @@ async function build(cwd, options) {
           plugins: [dts(entry.plugins?.dts)],
           pluginsOptions: entry.plugins,
           banner: entry.banner,
-          footer: entry.footer
+          footer: entry.footer,
+          intro: entry.intro,
+          outro: entry.outro,
+          paths: entry.paths
         };
         if (hooks?.["build:entry:start"]) {
           await hooks["build:entry:start"](_entry, buildStats);
@@ -298,7 +314,10 @@ async function build(cwd, options) {
           file: resolve(cwd, _entry.output),
           format: _entry.format,
           banner: _entry.banner,
-          footer: _entry.footer
+          footer: _entry.footer,
+          intro: _entry.intro,
+          outro: _entry.outro,
+          paths: _entry.paths
         });
         const stats = await stat(resolve(cwd, _entry.output));
         buildStats.files.push({
@@ -313,6 +332,44 @@ async function build(cwd, options) {
           await hooks["build:entry:end"](_entry, buildStats);
         }
       }
+      if ("template" in entry) {
+        logFilter = getLogFilter(entry.logFilter || ["!code:EMPTY_BUNDLE"]);
+        const _distDir = parse(fileURLToPath(import.meta.url)).dir;
+        const _output = entry.output;
+        let _format = "esm";
+        if (_output.endsWith(".cjs"))
+          _format = "cjs";
+        const buildLogs = [];
+        const _entry = {
+          template: resolve(_distDir, "_empty.ts"),
+          output: _output,
+          content: entry.content,
+          plugins: [esbuild(entry.plugins?.esbuild)],
+          pluginsOptions: entry.plugins,
+          format: entry.format || _format
+        };
+        const _build = await rollup({
+          input: _entry.template,
+          plugins: _entry.plugins,
+          onLog: (level, log) => {
+            if (logFilter(log))
+              buildLogs.push({ level, log });
+          }
+        });
+        await _build.write({
+          file: resolve(cwd, _entry.output),
+          intro: _entry.content
+        });
+        const stats = await stat(resolve(cwd, _entry.output));
+        buildStats.files.push({
+          path: _entry.output,
+          size: stats.size,
+          buildTime: Date.now() - entryStart,
+          format: _entry.format,
+          logs: buildLogs
+        });
+        buildStats.size = buildStats.size + stats.size;
+      }
     }
     buildStats.buildTime = Date.now() - start;
   }

package/dist/types/index.d.ts

@@ -51,6 +51,24 @@ interface EntryBase {
      * @default undefined
      */
     footer?: OutputOptions['footer'];
+    /**
+     * Specifies the code at the beginning that goes inside any _format-specific_ wrapper.
+     *
+     * @default undefined
+     */
+    intro?: OutputOptions['intro'];
+    /**
+     * Specifies the code at the end that goes inside any _format-specific_ wrapper.
+     *
+     * @default undefined
+     */
+    outro?: OutputOptions['outro'];
+    /**
+     * Maps external module IDs to paths.
+     *
+     * @default undefined
+     */
+    paths?: OutputOptions['paths'];
     /**
      * Specifies custom filters that will display only certain log messages.
      *
@@ -69,6 +87,28 @@ interface EntryInput extends EntryBase {
      * @default undefined
      */
     plugins?: PluginsInput;
+    /**
+     * Specifies the global variable name that representing exported bundle.
+     *
+     * Intended for `umd/iife` formats.
+     *
+     * @default undefined
+     */
+    name?: OutputOptions['name'];
+    /**
+     * Specifies global _module ID_ and _variable name_ pairs necessary for external imports.
+     *
+     * Intended for `umd/iife` formats.
+     *
+     * @default undefined
+     */
+    globals?: OutputOptions['globals'];
+    /**
+     * Specifies whether to extend the global variable defined by the `name` option.
+     *
+     * Intended for `umd/iife` formats.
+     */
+    extend?: OutputOptions['extend'];
 }
 interface EntryTypes extends EntryBase {
     /**
@@ -82,7 +122,64 @@ interface EntryTypes extends EntryBase {
      */
     plugins?: PluginsTypes;
 }
-type EntryOptions = EntryInput | EntryTypes;
+interface EntryTemplate extends Pick<EntryBase, 'logFilter'> {
+    /**
+     * Specifies the build entry as a module template.
+     *
+     * Provides the ability to dynamically inject template content during the build phase.
+     *
+     * @example
+     *
+     * ```ts
+     * export default defineConfig({
+     *   entries: [
+     *     {
+     *       template: true,
+     *       output: './dist/template.ts',
+     *       content: '// TypeScript code...',
+     *     },
+     *   ]
+     * })
+     * ```
+     */
+    template: true;
+    /**
+     * Specifies the path of the transformed module template.
+     */
+    output: string;
+    /**
+     * Specifies the content of the module template.
+     */
+    content: OutputOptions['intro'];
+    /**
+     * Specifies the format of the generated module template.
+     *
+     * @example
+     *
+     * ```ts
+     * export default defineConfig({
+     *   entries: [
+     *     {
+     *       template: true,
+     *       output: './dist/template.json',
+     *       content: '{}',
+     *       format: 'json',
+     *     },
+     *   ]
+     * })
+     * ```
+     *
+     * @default 'esm'
+     */
+    format?: string;
+    /**
+     * Specifies plugin options.
+     *
+     * @default undefined
+     */
+    plugins?: Pick<PluginsInput, 'esbuild'>;
+}
+type EntryOptions = EntryInput | EntryTypes | EntryTemplate;
 
 interface Options {
     /**
@@ -346,4 +443,4 @@ interface HooksOptions {
 declare const externals: RegExp[];
 declare function defineConfig(options: Options): Options;
 
-export { type BuildLogs, type BuildStats, type EntryBase, type EntryInput, type EntryOptions, type EntryTypes, type HooksOptions, type Options, type PluginsInput, type PluginsTypes, defineConfig, externals };
+export { type BuildLogs, type BuildStats, type EntryBase, type EntryInput, type EntryOptions, type EntryTemplate, type EntryTypes, type HooksOptions, type Options, type PluginsInput, type PluginsTypes, defineConfig, externals };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/bundler",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "author": "Hypernym Studio",
   "description": "ESM & TS module bundler.",
   "license": "MIT",
@@ -71,8 +71,8 @@
     "@hypernym/eslint-config": "^2.0.2",
     "@hypernym/prettier-config": "^2.0.2",
     "@hypernym/tsconfig": "^1.1.0",
-    "@types/node": "^20.8.7",
-    "eslint": "^8.51.0",
+    "@types/node": "^20.8.9",
+    "eslint": "^8.52.0",
     "prettier": "^3.0.3",
     "tsx": "^3.14.0",
     "typescript": "^5.2.2"