Registry / testing / eslint-plugin-file-progress

eslint-plugin-file-progress

library4.0.0-beta.1jsnpmunverified

An ESLint plugin that displays a file-by-file progress indicator during linting. Current stable version is v3.0.2 (latest release), with v4.0.0-beta.1 targeting ESLint v10. Released under MIT. Key differentiators: minimal dependencies (nanospinner, picocolors), provides recommended config presets, supports hiding progress in CI via settings or the 'recommended-ci' config. Requires Node.js ^20.19.0 || ^22.13.0 || >=24.0.0 and ESLint >=9 (v3) or >=10 (v4 beta).

testing

npm install eslint-plugin-file-progress

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-PLUGIN-FILE

eslint-plugin-file-progress

testingjavascriptv4.0.0-beta.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–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

default

✓ import progress from 'eslint-plugin-file-progress'

✗ const progress = require('eslint-plugin-file-progress')

ESM-only since v2. CommonJS require does not work; use dynamic import if needed.

configs

✓ import progress from 'eslint-plugin-file-progress'; export default [progress.configs.recommended]

✗ import { configs } from 'eslint-plugin-file-progress'

configs is a property of the default export, not a named export.

rules

✓ import progress from 'eslint-plugin-file-progress'; // then use progress.rules['progress/activate']

✗ import { rules } from 'eslint-plugin-file-progress'

rules is a property of the default export. Named import of rules is incorrect.

ESLint flat config (eslint.config.js/ts) using the recommended config preset and custom settings.

import progress from 'eslint-plugin-file-progress'; export default [ progress.configs.recommended, { name: 'custom-progress', rules: { 'progress/activate': 1, }, settings: { progress: { hide: false, hideFileName: false, successMessage: 'Lint done...', }, }, }, ];

Debug

Known issues

breakingESLint v10 support requires plugin v4.x (currently beta). v3.x does not work with ESLint v10.

fix

Use eslint-plugin-file-progress@^4.0.0-beta.1 with ESLint v10, or stick with ESLint v9.

affects: >=3.0.0 <4.0.0

breakingPlugin v2 and later are ESM-only and require ESLint v9 or higher. Node.js require() will fail.

fix

Use dynamic import() in CommonJS files or migrate to ESM. ESLint v9+ supports flat config.

affects: >=2.0.0

breakingIn v3.0.0, the 'noCI' config preset was renamed to 'recommended-ci'. The old 'noCI' is no longer available.

fix

Use progress.configs['recommended-ci'] instead of progress.configs.noCI.

affects: >=3.0.0

gotchaThe 'progress/activate' rule must be set to severity 1 (warn) or 2 (error) to enable the progress output. Setting it to 0 disables the plugin entirely.

fix

Use 'progress/activate': 1 in your config.

affects: >=1.0.0

gotchaThe 'recommended-ci' config automatically hides progress when the CI environment variable is set to 'true'. In environments where CI is not set, you must manually set settings.progress.hide: true.

fix

Set settings.progress.hide: true in your config for non-standard CI environments.

affects: >=3.0.0

Errors

Common errors & fixes

Error: Cannot find module 'eslint-plugin-file-progress'

Plugin not installed as a dev dependency.

fix

Run 'npm install -D eslint-plugin-file-progress' or 'yarn add --dev eslint-plugin-file-progress'.

TypeError: progress is not a function

Using default import in a CommonJS file with require.

fix

Use 'const progress = (await import('eslint-plugin-file-progress')).default;' or switch to ESM.

ESLint couldn't find the config 'progress/recommended'.

Using an incorrect config name (e.g., 'progress/recommended' instead of the correct property access).

fix

Use 'progress.configs.recommended' in flat config.

Upgrade

Version history

4.0.0-beta.1latest on npm

Audit

Dependencies

eslintrequiredpeer dependency: plugin requires ESLint to run

nanospinnerrequiredruntime dependency: used for terminal spinner animation

picocolorsrequiredruntime dependency: used for terminal text coloring

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/sibiraj-s/eslint-plugin-file-progress ↗

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