Registry / web-framework / vite-plugin-imp

vite-plugin-imp

library2.4.0jsnpmunverified

Vite plugin for automatic import of UI library component styles and on-demand library imports (e.g., lodash). Version 2.4.0 supports Vite >= 2.0.0. It transforms named imports into deep imports with style files, with built-in resolvers for popular libraries like Ant Design, Element Plus, Vant, and Lodash. Key differentiators: automatic style injection without manual configuration, support for custom libraries via config, and built-in resolver presets. Default behavior replaces import statements only in build mode. Requires Vite 2+ and ships TypeScript definitions. Release cadence: minor updates as needed.

web-framework

npm install vite-plugin-imp

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-IMP

vite-plugin-imp

web-frameworkjavascriptv2.4.0

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 vitePluginImp from 'vite-plugin-imp'

✗ const vitePluginImp = require('vite-plugin-imp')

ESM-only; default export is the plugin function.

vitePluginImp

✓ import vitePluginImp from 'vite-plugin-imp'

✗ import { vitePluginImp } from 'vite-plugin-imp'

This package exports a default function, not a named export.

LibItem

✓ import type { LibItem } from 'vite-plugin-imp'

✗ import { LibItem } from 'vite-plugin-imp'

LibItem is a TypeScript type; import as type to avoid runtime inclusion.

ImpConfig

✓ import type { ImpConfig } from 'vite-plugin-imp'

✗ import { ImpConfig } from 'vite-plugin-imp'

ImpConfig is a TypeScript type; import as type.

Configures vite-plugin-imp to auto-import lodash methods as deep imports and antd styles.

import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue'; import vitePluginImp from 'vite-plugin-imp'; export default defineConfig({ plugins: [ vue(), vitePluginImp({ libList: [ { libName: 'lodash', libDirectory: '', camel2DashComponentName: false, }, { libName: 'antd', style(name) { return `antd/es/${name}/style/index.js`; }, }, ], }), ], });

Debug

Known issues

breakingDeprecated in favor of unplugin-vue-components for Vue projects. vite-plugin-imp may not receive future updates.

fix

Migrate to unplugin-vue-components (and unplugin-auto-import) for better compatibility with Vite 3+.

affects: >=2.0.0

gotchareplaceOldImport defaults to false in serve mode and true in build mode. This can lead to inconsistent behavior between development and production.

fix

Explicitly set replaceOldImport in the config to make behavior consistent across serve and build.

affects: >=2.0.0

gotchaBuilt-in resolvers expect libraries to be listed in dependencies, not devDependencies, otherwise style import may fail.

fix

Ensure libraries like antd, element-plus, etc. are in your package.json dependencies.

affects: >=2.0.0

gotchaThe plugin only transforms import statements that are at the top level of a module. Dynamic imports or conditional imports inside functions are not processed.

fix

Avoid dynamic imports of library components if you rely on this plugin; use static top-level imports instead.

affects: >=2.0.0

deprecatedBuilt-in resolvers are static and may become outdated as UI libraries evolve. Newer libraries are not added.

fix

Consider using unplugin-vue-components which has a more active resolver ecosystem.

affects: >=2.4.0

Errors

Common errors & fixes

Error: [vite-plugin-imp] The library 'XXX' is not found in the 'libList' configuration.

You are using a library that is not in the built-in list or not manually configured in libList.

fix

Add an entry for the library in the libList array, providing a style function.

SyntaxError: Cannot use import statement outside a module

Using require() to import the plugin in a CommonJS context.

fix

Use ESM import syntax: import vitePluginImp from 'vite-plugin-imp'

TypeError: vitePluginImp is not a function

Using named import { vitePluginImp } instead of default import.

fix

Use default import: import vitePluginImp from 'vite-plugin-imp'

Error: [vite-plugin-imp] The plugin requires Vite >= 2.0.0-beta.5

Your Vite version is too old.

fix

Upgrade Vite to version >= 2.0.0-beta.5.

Module not found: Error: Can't resolve 'vite-plugin-imp'

The package is not installed or is installed as devDependency and not available in the build environment.

fix

Run npm install vite-plugin-imp -D or ensure it is in devDependencies.

Upgrade

Version history

2.4.0latest on npm

Audit

Dependencies

viterequiredpeer dependency required to operate as a Vite plugin; version >= 2.0.0-beta.5

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/onebay/vite-plugin-imp ↗

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