Registry / devops / maptalks-rollup-plugin-alias

maptalks-rollup-plugin-alias

library1.3.4jsnpmunverified

Rollup plugin that allows defining import aliases, useful for reducing relative path complexity and simplifying module resolution. The current stable version is 1.3.4, last released in 2018, with no active development. It is a fork of the original rollup-plugin-alias that adds the ability to resolve aliases with file extensions (e.g., .jsx). Compared to the official @rollup/plugin-alias, this package is unmaintained and lacks support for newer Rollup versions or ESM. It is primarily for legacy projects using CommonJS-style Rollup configs.

devops

npm install maptalks-rollup-plugin-alias

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MAPTALKS-ROLLUP-PL

maptalks-rollup-plugin-alias

devopsjavascriptv1.3.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

default alias

✓ import alias from 'rollup-plugin-alias';

✗ const alias = require('rollup-plugin-alias').default;

ES module default import; CommonJS require returns the function directly.

CommonJS require

✓ const alias = require('rollup-plugin-alias');

✗ const { alias } = require('rollup-plugin-alias');

No named export; require returns the default function.

Rollup config usage

✓ import alias from 'rollup-plugin-alias'; alias({ myAlias: './path' })

✗ alias({ resolve: ['.js'], other: true })

The options object expects alias keys mapped to strings; resolve is an optional array.

Demonstrates how to configure maptalks-rollup-plugin-alias in a Rollup config to replace 'vue' with a browser build and set '@' as an alias for the src directory.

// rollup.config.js import alias from 'rollup-plugin-alias'; import resolve from '@rollup/plugin-node-resolve'; export default { input: 'src/index.js', output: { file: 'dist/bundle.js', format: 'iife' }, plugins: [ alias({ vue: './node_modules/vue/dist/vue.esm.browser.js', '@': './src' }), resolve() ] };

Debug

Known issues

breakingThis package is a fork of rollup-plugin-alias but has diverged; breaking changes may exist compared to the original.

fix

Use @rollup/plugin-alias for official support.

affects: >=1.0.0

deprecatedNo longer maintained; last release 2018. Does not support Rollup 3+ ESM configs.

fix

Switch to @rollup/plugin-alias.

affects: >=1.0.0

gotchaThe 'resolve' option only works for relative aliases starting with './'. Absolute paths or module names are not resolved.

fix

Ensure relative aliases use './' prefix if you intend to use the resolve extension mechanism.

affects: >=1.0.0

gotchaThe package name 'maptalks-rollup-plugin-alias' is confusing; it is not related to maptalks library.

fix

Use the original package '@rollup/plugin-alias' to avoid confusion.

affects: >=1.0.0

Errors

Common errors & fixes

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

Package not installed or wrong package name used.

fix

npm install rollup-plugin-alias (or this fork under its npm name).

ReferenceError: require is not defined

Using CommonJS require in an ESM context (e.g., Rollup 3+ config).

fix

Use import statement instead, or rename config to .cjs and use require.

TypeError: alias is not a function

Importing incorrectly, e.g., destructuring a named export that does not exist.

fix

Use default import: import alias from 'rollup-plugin-alias'

Plugin error: Could not resolve entry (rollup-plugin-alias)

Alias configuration incorrect or missing.

fix

Ensure alias keys map to valid modules or paths.

Upgrade

Version history

1.3.4latest on npm

Audit

Dependencies

rolluprequiredRollup peer dependency - plugin is used as a Rollup plugin

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/watertank/rollup-plugin-alias ↗

packagemaptalks-rollup-plugin-alias ↗

homepagehttps://github.com/watertank/rollup-plugin-aliar#readme ↗