Registry / web-framework / eslint-plugin-unimport

eslint-plugin-unimport

library1.0.0jsnpmunverified

ESLint plugin (v1.0.0, latest) that automatically inserts imports from Unimport into ESLint fixes. Integrates with unplugin-auto-import and Nuxt to auto-fix missing imports in codebases using auto-import features. ESM-only since v1.0.0, requires ESLint ^9.0.0 || ^8.45.0. Differentiator: bridges Unimport's auto-import with ESLint's autofix, making auto-imported symbols explicit in source files.

web-framework testing

npm install eslint-plugin-unimport

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-PLUGIN-UNIM

eslint-plugin-unimport

web-frameworkjavascriptv1.0.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–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

createAutoInsert

✓ import { createAutoInsert } from 'eslint-plugin-unimport'

✗ const createAutoInsert = require('eslint-plugin-unimport')

ESM-only since v1.0.0, require() will throw.

createAutoInsert (default)

✓ import createAutoInsert from 'eslint-plugin-unimport'

✗ import { default as createAutoInsert } from 'eslint-plugin-unimport'

Default export is createAutoInsert; named export also available.

default (plugin object)

✓ import unimportPlugin from 'eslint-plugin-unimport'

✗ const unimportPlugin = require('eslint-plugin-unimport')

ESM-only; plugin object for flat config: unimportPlugin.configs.recommended.

Sets up eslint-plugin-unimport with a flat config, reading auto-import items from a JSON file.

import fs from 'node:fs'; import { createAutoInsert } from 'eslint-plugin-unimport'; export default [ { plugins: { unimport: (await import('eslint-plugin-unimport')).default, }, }, { rules: { 'unimport/auto-insert': 'error', }, }, ...createAutoInsert({ imports: JSON.parse(fs.readFileSync('.unimport-items.json', 'utf-8')), }), ];

Debug

Known issues

breakingv1.0.0 switched to ESM-only; projects using CommonJS require() will break.

fix

Migrate to ESM or use dynamic import().

affects: >=1.0.0

gotchaThe plugin requires a pre-generated .unimport-items.json from unplugin-auto-import with dumpUnimportItems: true.

fix

Ensure unplugin-auto-import config includes dumpUnimportItems: true and the file exists before running ESLint.

affects: >=0.0.1

gotchaFlat config only; the plugin does not support legacy eslintrc format.

fix

Use eslint.config.js/.mjs file with flat config.

affects: >=1.0.0

deprecatedv0.x used a different plugin format; v0.0.2 had a breaking change in plugin format.

fix

Upgrade to v1.0.0 and follow new configuration pattern.

affects: <1.0.0

Errors

Common errors & fixes

Cannot find module 'eslint-plugin-unimport'

Package not installed or ESM-only require() call.

fix

Install the package: npm install eslint-plugin-unimport. If using require(), switch to import.

Error: .unimport-items.json not found

unplugin-auto-import not configured to dump items or file not generated.

fix

Add dumpUnimportItems: true to AutoImport config and run build/dev to generate the file.

ESLint couldn't find the plugin 'unimport'

Plugin not properly registered in flat config.

fix

Add plugin object: plugins: { unimport: (await import('eslint-plugin-unimport')).default }.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

eslintrequiredpeer dependency, plugin requires ESLint to function

Agent activity

8 hits · last 30 days

node

Google (search)

Resources

githubhttps://github.com/antfu/eslint-plugin-unimport ↗

packagehttps://www.npmjs.com/package/eslint-plugin-unimport ↗