Registry / web-framework / vite-plugin-resolve-externals

vite-plugin-resolve-externals

library0.2.2jsnpmunverified

A Vite plugin (v0.2.2) that resolves external dependencies by mapping import specifiers to global variables or custom code snippets. It allows configuring external mappings via plugin options or Vite's resolve.externals configuration. Useful for replacing Node.js or client-side libraries with CDN scripts in Vite projects. It supports both simple global mappings and advanced code generation for scoped exports. No recent updates; stable but minimal feature set compared to alternatives like rollup-plugin-external-globals. Suitable for small to medium projects needing quick externals resolution.

web-framework devops

npm install vite-plugin-resolve-externals

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-RESOLV

vite-plugin-resolve-externals

web-frameworkjavascriptv0.2.2

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 resolveExternalsPlugin from 'vite-plugin-resolve-externals'

✗ const resolveExternalsPlugin = require('vite-plugin-resolve-externals')

The package is ESM-only. Use import syntax for Vite config.

resolveExternalsPlugin (default)

✓ import * as plugin from 'vite-plugin-resolve-externals'

✗ import { resolveExternalsPlugin } from 'vite-plugin-resolve-externals'

The package exports a single default function; no named export exists.

resolveExternalsPlugin via CJS require()

✓ const resolveExternalsPlugin = (await import('vite-plugin-resolve-externals')).default

✗ const resolveExternalsPlugin = require('vite-plugin-resolve-externals')

CommonJS require() will fail in ESM context. Use dynamic import() with .default.

Basic setup: map 'vue' to global 'Vue', 'vue-router' to 'VueRouter', 'axios' to 'axios' in Vite project.

// vite.config.js import { defineConfig } from 'vite'; import resolveExternalsPlugin from 'vite-plugin-resolve-externals'; export default defineConfig({ plugins: [ resolveExternalsPlugin({ vue: 'Vue', 'vue-router': 'VueRouter', axios: 'axios', }), ], });

Debug

Known issues

gotchaThe plugin overrides Vite's resolve.externals if both are set. Configure via plugin option only to avoid conflicts.

fix

Prefer passing externals as the first argument to resolveExternalsPlugin() instead of using resolve.externals in Vite config.

affects: >=0.2.2

gotchaWhen using custom code strings for globals, ensure they are valid JavaScript. Syntax errors will cause silent build failures.

fix

Wrap custom exports in a function that returns a template literal. Test by building with --debug flag.

affects: >=0.2.2

deprecatedThe 'resolve.externals' configuration in Vite's resolve option is deprecated; use the plugin's argument instead.

fix

Move externals from resolve.externals to the plugin call: resolveExternalsPlugin({...})

affects: >=0.2.0

breakingPlugin no longer reads from 'resolve.externals' by default; must pass explicitly.

fix

Pass externals as argument to resolveExternalsPlugin().

affects: >=0.2.0

gotchaNamed exports from custom code strings may not work if the global variable is not defined at build time.

fix

Ensure the global is available in the browser before the script runs, e.g., via CDN script tags.

affects: >=0.2.2

Errors

Common errors & fixes

Error: Cannot find module 'vite-plugin-resolve-externals'

Package not installed or used in TypeScript without type declarations.

fix

Install as devDependency: npm install -D vite-plugin-resolve-externals

TypeError: resolveExternalsPlugin is not a function

Using named import instead of default import.

fix

Use 'import resolveExternalsPlugin from ...' or 'import * as pkg from ...; pkg.default(...)'

SyntaxError: Unexpected token 'export'

Using require() in an ESM context (vite.config.js is ESM by default).

fix

Replace require() with import or use dynamic import: const resolve = (await import(...)).default

Error: The externals option in 'resolve' is not supported by this plugin anymore

Plugin version prior to 0.2.0? Actually, version 0.2.0+ ignores resolve.externals.

fix

Pass externals directly to resolveExternalsPlugin() as the first argument.

Upgrade

Version history

0.2.2latest on npm

Audit

Dependencies

viterequiredpeer dependency; plugin runs within Vite's build pipeline

Agent activity

8 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/lceric/vite-plugin-resolve-externals ↗

packagehttps://www.npmjs.com/package/vite-plugin-resolve-externals ↗