Registry / devops / rollup-plugin-resolve-alias

rollup-plugin-resolve-alias

library0.2.1jsnpmunverified

A Rollup plugin to create module import aliases, simplifying paths in bundled code. Current stable version is 0.2.1, with no active development since 2018. It provides a simple API via an 'aliases' object, but lacks features like array aliases or custom resolvers found in more modern alternatives like @rollup/plugin-alias. Ships TypeScript types. Requires Rollup >=0.20.0. Use with caution for new projects; prefer @rollup/plugin-alias instead.

devops

npm install rollup-plugin-resolve-alias

package ↗homepage ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-RESO

rollup-plugin-resolve-alias

devopsjavascriptv0.2.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import resolveAlias from 'rollup-plugin-resolve-alias'

✗ const resolveAlias = require('rollup-plugin-resolve-alias')

ESM-only; CommonJS require not supported (package has no CJS export).

resolveAlias

✓ import resolveAlias from 'rollup-plugin-resolve-alias'

✗ import { resolveAlias } from 'rollup-plugin-resolve-alias'

Default export, not named. Named import will result in undefined.

types

✓ import type { RollupPluginResolveAliasOptions } from 'rollup-plugin-resolve-alias'

TypeScript types are included; use 'import type' for type-only imports.

Shows basic usage of rollup-plugin-resolve-alias with two aliases to map module paths.

import resolveAlias from 'rollup-plugin-resolve-alias'; export default { input: 'src/main.js', output: { file: 'bundle.js', format: 'cjs' }, plugins: [ resolveAlias({ aliases: { '@': './src', 'utils': './src/utils' } }) ] };

Debug

Known issues

deprecatedPackage is no longer maintained. Consider using @rollup/plugin-alias instead.

fix

Replace with @rollup/plugin-alias: npm install @rollup/plugin-alias -D and update config.

affects: >=0.0.0

breakingVersion 0.2.0 changed the API from an options object with 'resolve' to the current 'aliases' object.

fix

If migrating from 0.1.x, change the plugin configuration to use the 'aliases' key instead of top-level mappings.

affects: >=0.2.0

gotchaAlias values must be absolute paths or relative to the project root, not relative to the importing file.

fix

Ensure aliases resolve correctly by using absolute paths or paths relative to process.cwd().

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'rollup-plugin-resolve-alias'

Package not installed or installed incorrectly.

fix

Run 'npm install rollup-plugin-resolve-alias --save-dev' or ensure it's in devDependencies.

TypeError: resolveAlias is not a function

CommonJS require used instead of ESM import.

fix

Use ES module syntax: import resolveAlias from 'rollup-plugin-resolve-alias'

Uncaught TypeError: Cannot destructure property 'aliases' of 'undefined' or 'null'.

Calling resolveAlias() without passing an options object.

fix

Pass an object with an 'aliases' key: resolveAlias({ aliases: { '@': './src' } })

Upgrade

Version history

0.2.1latest on npm

Audit

Dependencies

rolluprequiredpeer dependency, required as plugin for Rollup

Agent activity

4 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/rollup-plugin-resolve-alias ↗

homepagehttps://gitlab.com/gluons/rollup-plugin-resolve-alias ↗