{"id":22539,"library":"vite-auto-import-resolvers","title":"vite-auto-import-resolvers","description":"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.","status":"active","version":"3.2.1","language":"javascript","source_language":"en","source_url":"https://github.com/dishait/vite-auto-import-resolvers","tags":["javascript","vue","vite","resolver","unplugin-auto-imports","typescript"],"install":[{"cmd":"npm install vite-auto-import-resolvers","lang":"bash","label":"npm"},{"cmd":"yarn add vite-auto-import-resolvers","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-auto-import-resolvers","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency: the resolvers integrate with unplugin-auto-import's resolver system.","package":"unplugin-auto-import","optional":false},{"reason":"Peer dependency: designed to work as a Vite plugin.","package":"vite","optional":false}],"imports":[{"note":"ESM-only since v3.0.0; CJS require will fail in most environments.","wrong":"const { dirResolver } = require('vite-auto-import-resolvers')","symbol":"dirResolver","correct":"import { dirResolver } from 'vite-auto-import-resolvers'"},{"note":"Named export, not default. Must be used as a separate Vite plugin.","wrong":"import DirResolverHelper from 'vite-auto-import-resolvers'","symbol":"DirResolverHelper","correct":"import { DirResolverHelper } from 'vite-auto-import-resolvers'"},{"note":"Named export; automatically detects installed packages (vue, vue-router, pinia, etc.) for import presets.","wrong":"","symbol":"AutoGenerateImports","correct":"import { AutoGenerateImports } from 'vite-auto-import-resolvers'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite';\nimport Vue from '@vitejs/plugin-vue';\nimport AutoImports from 'unplugin-auto-import/vite';\nimport { dirResolver, DirResolverHelper } from 'vite-auto-import-resolvers';\n\nexport default defineConfig({\n  plugins: [\n    Vue(),\n    DirResolverHelper(),\n    AutoImports({\n      imports: ['vue'],\n      resolvers: [dirResolver()],\n    }),\n  ],\n});","lang":"typescript","description":"Basic setup: adds DirResolverHelper and dirResolver to auto-import modules from src/composables."},"warnings":[{"fix":"Ensure your project uses ESM (e.g., type:'module' in package.json or .mjs files).","message":"v3.0.0 broke compatibility with CJS environments; the package became ESM-only.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Add DirResolverHelper() to the plugins array in vite.config, placed before AutoImports.","message":"DirResolverHelper must be added as a plugin before AutoImports; otherwise dirResolver may not work.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consider using unplugin-auto-import's built-in 'dirs': { 'src/composables': true } instead.","message":"unplugin-auto-import now has a built-in 'dirs' option that may replace vite-auto-import-resolvers.","severity":"deprecated","affected_versions":">=0.6.9"},{"fix":"Ensure packages are installed or manually specify imports if using optional dependencies.","message":"The AutoGenerateImports helper only works if the target packages (vue, vue-router, pinia, etc.) are actually installed; otherwise it generates empty imports.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"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').","cause":"Package is ESM-only since v3.0.0, but CJS require is used.","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module not supported"},{"fix":"Ensure named import: import { dirResolver } from 'vite-auto-import-resolvers'. Also check that the package is installed.","cause":"dirResolver was imported incorrectly (e.g., default import or destructured from wrong path).","error":"TypeError: dirResolver is not a function"},{"fix":"Add DirResolverHelper() to plugins before AutoImports, e.g., plugins: [Vue(), DirResolverHelper(), AutoImports({...})].","cause":"DirResolverHelper plugin is missing or not placed before AutoImports in plugins array.","error":"Uncaught ReferenceError: foo is not defined (when using auto-import)"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}