{"id":26956,"library":"eslint-import-resolver-oxc","title":"eslint-import-resolver-oxc","description":"An ESLint import resolver wrapping oxc-resolver for eslint-plugin-import and eslint-plugin-import-x. Current stable version is 0.15.0, with frequent releases (multiple minor/patch versions in 2024). Key differentiators: significantly faster than eslint-import-resolver-node by leveraging the Rust-based oxc-resolver; supports configuration via bundler configs (Vite, Rspack, Webpack) and auto-detection of tsconfig/jsconfig; offers both sync and async resolver-next API. Ships TypeScript types, ESM/CJS compatible, and requires oxc-resolver as a peer dependency. Community alternative to eslint-import-resolver-typescript.","status":"active","version":"0.15.0","language":"javascript","source_language":"en","source_url":"https://github.com/9romise/eslint-import-resolver-oxc","tags":["javascript","eslint","eslint-plugin-import","eslint-plugin-import-x","eslint-import-resolver","typescript"],"install":[{"cmd":"npm install eslint-import-resolver-oxc","lang":"bash","label":"npm"},{"cmd":"yarn add eslint-import-resolver-oxc","lang":"bash","label":"yarn"},{"cmd":"pnpm add eslint-import-resolver-oxc","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core resolver engine, required as peer dependency.","package":"oxc-resolver","optional":false},{"reason":"Integration target (optional since v4 plugin can also be used).","package":"eslint-plugin-import","optional":true},{"reason":"Integration target (optional).","package":"eslint-plugin-import-x","optional":true}],"imports":[{"note":"Named export, not default export.","wrong":"import createOxcImportResolver from 'eslint-import-resolver-oxc'","symbol":"createOxcImportResolver","correct":"import { createOxcImportResolver } from 'eslint-import-resolver-oxc'"},{"note":"Utility to transform Vite config for resolver options.","symbol":"transformViteConfig","correct":"import { transformViteConfig } from 'eslint-import-resolver-oxc'"},{"note":"Utility to transform Rspack config for resolver options (experimental).","symbol":"transformRspackConfig","correct":"import { transformRspackConfig } from 'eslint-import-resolver-oxc'"}],"quickstart":{"code":"// eslint.config.js\nimport { createOxcImportResolver } from 'eslint-import-resolver-oxc'\n\nexport default [\n  {\n    settings: {\n      'import-x/resolver-next': [\n        createOxcImportResolver({\n          conditionNames: ['node', 'import', 'require'],\n          extensions: ['.js', '.mjs', '.cjs', '.jsx', '.ts', '.mts', '.cts', '.tsx', '.d.ts', '.d.mts', '.d.cts'],\n        }),\n      ],\n    },\n  },\n]","lang":"typescript","description":"Configure eslint-plugin-import-x with oxc resolver using flat config (ESM)."},"warnings":[{"fix":"Run 'npm install oxc-resolver' as an additional dependency.","message":"v0.15.0: oxc-resolver changed from bundled dependency to peer dependency – must install manually.","severity":"breaking","affected_versions":">=0.15.0"},{"fix":"Ensure oxc-resolver version 8 is installed.","message":"v0.14.0: oxc-resolver updated to ^8.0.0, major version bump may cause incompatibilities.","severity":"breaking","affected_versions":">=0.14.0 <0.15.0"},{"fix":"Use the older resolver API for eslint-plugin-import-x <4.5.0 (settings['import-x/resolver'] = 'oxc').","message":"The resolver-next API (createOxcImportResolver) is only available for eslint-plugin-import-x >=4.5.0 with flat config.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use await createOxcImportResolver({ bundlerConfig: 'vite.config.ts' }) in an async context.","message":"bundlerConfig support for Vite, Rspack, Webpack is experimental and only works with the async createOxcImportResolver function.","severity":"gotcha","affected_versions":">=0.10.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install oxc-resolver: npm install oxc-resolver --save-dev","cause":"oxc-resolver is a peer dependency and not automatically installed.","error":"Cannot find module 'oxc-resolver'"},{"fix":"Ensure package is installed: npm install eslint-import-resolver-oxc --save-dev. If using ESM, check package.json has \"type\": \"module\" or use .mjs extension.","cause":"Misconfiguration or package not installed.","error":"Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'eslint-import-resolver-oxc'"},{"fix":"Use 'import-x/resolver-next' for eslint-plugin-import-x >=4.5.0, or 'import-x/resolver' for older versions.","cause":"Using an incorrect key for the resolver in settings.","error":"Invalid resolver configuration: unsupported resolver type"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}