@hypernym/bundler 0.6.2 → 0.7.0

package/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Ivo Dolenc, Hypernym Studio
+Copyright (c) 2024 Ivo Dolenc, Hypernym Studio
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -21,7 +21,8 @@ npm i -D @hypernym/bundler
 
 1. Create a `bundler.config.ts` file at the root of your project:
 
-> **Note**
+> [!NOTE]
+>
 > Configuration also accepts `.js`, `.mjs`, `.ts`, `.mts` formats.
 
 ```ts
@@ -258,6 +259,28 @@ export default defineConfig({
 })
 ```
 
+### alias
+
+- Type: `true`
+- Default: `undefined`
+
+Specifies global path alias support.
+
+If true, it enables import prefixes:
+
+- `@/*`
+- `~/*`
+
+```ts
+// Imports module from './src/utils/index.js'
+import { module } from '@/utils/index.js'
+
+// or
+
+// Imports module from './src/utils/index.js'
+import { module } from '~/utils/index.js'
+```
+
 ## CLI
 
 ### Custom Config
@@ -270,11 +293,13 @@ npx hyperbundler --config my.config.js
 
 ## Community
 
-Feel free to use the official [discussions](https://github.com/hypernym-studio/bundler/discussions) for any additional questions.
+Feel free to ask questions or share new ideas.
+
+Use the official [discussions](https://github.com/hypernym-studio/bundler/discussions) to get involved.
 
 ## License
 
-Developed in 🇭🇷 Croatia
+Developed in 🇭🇷 Croatia.
 
 Released under the [MIT](LICENSE.txt) license.
 

package/dist/bin/index.mjs

@@ -14,6 +14,7 @@ import { getLogFilter } from 'rollup/getLogFilter';
 import _replace from '@rollup/plugin-replace';
 import _json from '@rollup/plugin-json';
 import _resolve from '@rollup/plugin-node-resolve';
+import _alias from '@rollup/plugin-alias';
 import { dts } from 'rollup-plugin-dts';
 import { createFilter } from '@rollup/pluginutils';
 
@@ -26,7 +27,7 @@ const externals = [
 ];
 
 const name = "bundler";
-const version = `0.6.2`;
+const version = `0.7.0`;
 
 const cl = console.log;
 const logger = {
@@ -188,6 +189,7 @@ function esbuild(options) {
 const replacePlugin = _replace.default ?? _replace;
 const jsonPlugin = _json.default ?? _json;
 const resolvePlugin = _resolve.default ?? _resolve;
+const aliasPlugin = _alias.default ?? _alias;
 async function build(cwd, options) {
   const { outDir = "dist", hooks } = options;
   let start = 0;
@@ -201,6 +203,13 @@ async function build(cwd, options) {
     await hooks["build:start"](options, buildStats);
   if (options.entries) {
     start = Date.now();
+    const aliasDir = `${resolve(cwd, "./src")}/`;
+    const aliasOptions = {
+      entries: [
+        { find: /^@\//, replacement: aliasDir },
+        { find: /^~\//, replacement: aliasDir }
+      ]
+    };
     for (const entry of options.entries) {
       const entryStart = Date.now();
       let logFilter = getLogFilter(entry.logFilter || []);
@@ -242,6 +251,9 @@ async function build(cwd, options) {
           const resolveOptions = isObject(_entry.pluginsOptions.resolve) ? _entry.pluginsOptions.resolve : void 0;
           _entry.plugins.unshift(resolvePlugin(resolveOptions));
         }
+        if (options.alias) {
+          _entry.plugins.unshift(aliasPlugin(aliasOptions));
+        }
         if (hooks?.["build:entry:start"]) {
           await hooks["build:entry:start"](_entry, buildStats);
         }
@@ -298,6 +310,9 @@ async function build(cwd, options) {
           outro: entry.outro,
           paths: entry.paths
         };
+        if (options.alias) {
+          _entry.plugins.unshift(aliasPlugin(aliasOptions));
+        }
         if (hooks?.["build:entry:start"]) {
           await hooks["build:entry:start"](_entry, buildStats);
         }

package/dist/types/index.d.ts

@@ -235,6 +235,24 @@ interface Options {
      * @default undefined
      */
     hooks?: HooksOptions;
+    /**
+     * Specifies global path alias support.
+     *
+     * If true, it enables import prefixes:
+     *
+     * - `@/*`
+     * - `~/*`
+     *
+     * @example
+     *
+     * ```ts
+     * // Imports module from './src/utils/index.js'
+     * import { module } from '@/utils/index.js'
+     * ```
+     *
+     * @default undefined
+     */
+    alias?: true;
 }
 
 interface BuildLogs {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/bundler",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "author": "Hypernym Studio",
   "description": "ESM & TS module bundler.",
   "license": "MIT",
@@ -43,6 +43,10 @@
     "format": "prettier --config .config/prettier.config.js --write .",
     "prepublishOnly": "npm run build"
   },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=v18.0.0"
+  },
   "peerDependencies": {
     "@types/node": ">=20.0.0",
     "typescript": ">=5.0.0"
@@ -59,25 +63,23 @@
     "@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",
+    "@hypernym/utils": "^2.3.0",
+    "@rollup/plugin-alias": "^5.1.0",
+    "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-replace": "^5.0.5",
-    "esbuild": "^0.19.8",
-    "rollup": "^4.6.0",
+    "esbuild": "^0.19.11",
+    "rollup": "^4.9.5",
     "rollup-plugin-dts": "^6.1.0"
   },
   "devDependencies": {
     "@hypernym/eslint-config": "^2.0.3",
     "@hypernym/prettier-config": "^2.0.3",
-    "@hypernym/tsconfig": "^1.1.0",
-    "@types/node": "^20.10.0",
-    "eslint": "^8.54.0",
-    "prettier": "^3.1.0",
-    "tsx": "^4.5.0",
-    "typescript": "^5.3.2"
-  },
-  "engines": {
-    "node": ">=v18.0.0"
+    "@hypernym/tsconfig": "^1.2.0",
+    "@types/node": "^20.11.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.2",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
   }
 }