Registry / web-framework / vite-auto-import-resolvers

vite-auto-import-resolvers

library3.2.1jsnpmunverified

Vite resolver plugin for unplugin-auto-import, enabling automatic API imports from specified directories (e.g., src/composables) without manual import statements. Current stable version is 3.2.1, with monthly releases. Supports prefix/suffix filtering, include/exclude patterns, path normalization, and auto-generation of import presets based on installed dependencies. Requires unplugin-auto-import >=0.6.9 and Vite >=2.9.1. Key differentiator: simplifies auto-import setup for Vue/Vite projects by resolving directory-based modules. Also provides a DirResolverHelper plugin for proper helper injection. TypeScript types included. Note: unplugin-auto-import now has built-in dirs option; this package may become redundant for new projects.

web-framework

npm install vite-auto-import-resolvers

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-AUTO-IMPORT-R

vite-auto-import-resolvers

web-frameworkjavascriptv3.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.

dirResolver

✓ import { dirResolver } from 'vite-auto-import-resolvers'

✗ const { dirResolver } = require('vite-auto-import-resolvers')

ESM-only since v3.0.0; CJS require will fail in most environments.

DirResolverHelper

✓ import { DirResolverHelper } from 'vite-auto-import-resolvers'

✗ import DirResolverHelper from 'vite-auto-import-resolvers'

Named export, not default. Must be used as a separate Vite plugin.

AutoGenerateImports

✓ import { AutoGenerateImports } from 'vite-auto-import-resolvers'

Named export; automatically detects installed packages (vue, vue-router, pinia, etc.) for import presets.

Basic setup: adds DirResolverHelper and dirResolver to auto-import modules from src/composables.

// vite.config.ts import { defineConfig } from 'vite'; import Vue from '@vitejs/plugin-vue'; import AutoImports from 'unplugin-auto-import/vite'; import { dirResolver, DirResolverHelper } from 'vite-auto-import-resolvers'; export default defineConfig({ plugins: [ Vue(), DirResolverHelper(), AutoImports({ imports: ['vue'], resolvers: [dirResolver()], }), ], });

Debug

Known issues

breakingv3.0.0 broke compatibility with CJS environments; the package became ESM-only.

fix

Ensure your project uses ESM (e.g., type:'module' in package.json or .mjs files).

affects: >=3.0.0

gotchaDirResolverHelper must be added as a plugin before AutoImports; otherwise dirResolver may not work.

fix

Add DirResolverHelper() to the plugins array in vite.config, placed before AutoImports.

affects: >=1.0.0

deprecatedunplugin-auto-import now has a built-in 'dirs' option that may replace vite-auto-import-resolvers.

fix

Consider using unplugin-auto-import's built-in 'dirs': { 'src/composables': true } instead.

affects: >=0.6.9

gotchaThe AutoGenerateImports helper only works if the target packages (vue, vue-router, pinia, etc.) are actually installed; otherwise it generates empty imports.

fix

Ensure packages are installed or manually specify imports if using optional dependencies.

affects: >=2.0.0

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module not supported

Package is ESM-only since v3.0.0, but CJS require is used.

fix

Use import syntax instead: import { dirResolver } from 'vite-auto-import-resolvers'. If using require, upgrade Node.js and use dynamic import: const { dirResolver } = await import('vite-auto-import-resolvers').

TypeError: dirResolver is not a function

dirResolver was imported incorrectly (e.g., default import or destructured from wrong path).

fix

Ensure named import: import { dirResolver } from 'vite-auto-import-resolvers'. Also check that the package is installed.

Uncaught ReferenceError: foo is not defined (when using auto-import)

DirResolverHelper plugin is missing or not placed before AutoImports in plugins array.

fix

Add DirResolverHelper() to plugins before AutoImports, e.g., plugins: [Vue(), DirResolverHelper(), AutoImports({...})].

Upgrade

Version history

3.2.1latest on npm

Audit

Dependencies

unplugin-auto-importrequiredPeer dependency: the resolvers integrate with unplugin-auto-import's resolver system.

viterequiredPeer dependency: designed to work as a Vite plugin.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/dishait/vite-auto-import-resolvers ↗

packagehttps://www.npmjs.com/package/vite-auto-import-resolvers ↗