eslint-plugin-file-progress-2

5.1.0 verified Sat Apr 25 auth: no javascript

ESLint plugin that prints real-time file processing progress and detailed summaries during lint runs. Version 5.1.0 (stable, released April 2026) requires Node >=22 and ESLint ^9.0.0 || ^10.2.1. Supports TypeScript with full type declarations. Key differentiators: customizable prefix marks, directory name hiding, prefix hiding, dual ESM/CJS exports, and presets like 'recommended-detailed' for throughput metrics. Active development with frequent releases.

Common errors

error Error [ERR_REQUIRE_ESM]: require() of ES Module /path/to/node_modules/eslint-plugin-file-progress-2/dist/index.js from /path/to/project/file.js not supported. ↓

cause CJS require() used with v5 ESM-only plugin.

fix

Use import plugin from 'eslint-plugin-file-progress-2' or set type: 'module' in package.json.

error TypeError: Cannot destructure property 'rules' of 'require(...)' as it is undefined. ↓

cause CJS require() of plugin returns undefined because v5 is ESM-only.

fix

Switch to ESM import syntax: import { rules } from 'eslint-plugin-file-progress-2'.

error Error: Cannot find module 'eslint-plugin-file-progress-2/configs' ↓

cause Importing configs from a subpath instead of main entry.

fix

Use import { configs } from 'eslint-plugin-file-progress-2' directly.

error The engine "node" is incompatible with this module. Expected version ">=22.0.0". Got "18.0.0" ↓

cause Node version below 22.

fix

Upgrade Node to v22 or later.

Warnings

breaking Version 5.0.0 changed plugin entry to ESM-only; CJS require() will fail. ↓

fix Use dynamic import() or switch to ESM in your project.

breaking Node.js >=22.0.0 required as of v5; older versions will not work. ↓

fix Upgrade Node.js to v22 or later.

deprecated The `progress.prefixMark` option was added in v3.4.0; previous customization of prefix symbol is no longer supported. ↓

fix Use `settings.progress.prefixMark` instead of overriding the prefix directly.

gotcha The prefix mark defaults to a checkmark/cross; if you set a custom prefixMark, ensure it does not conflict with success/failure marks. ↓

fix Set prefixMark to a unique character or emoji.

gotcha Dual export map (main/module) in v3.4.3 may cause resolution issues in some bundlers if both fields are present. ↓

fix Use explicit imports from the ESM path (index.js) for bundlers.

Install

npm install eslint-plugin-file-progress-2

yarn add eslint-plugin-file-progress-2

pnpm add eslint-plugin-file-progress-2

Imports

default
wrong
```
const plugin = require('eslint-plugin-file-progress-2')
```
correct
```
import plugin from 'eslint-plugin-file-progress-2'
```
ESM-only since v5; CJS users must use dynamic import or upgrade to Node >=22 with --experimental-require-module.

rules

wrong

const { rules } = require('eslint-plugin-file-progress-2')

correct

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

Named export for rules object; CJS require will throw in v5+.

configs

wrong

import configs from 'eslint-plugin-file-progress-2/configs'

correct

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

Configs are a named export from the main entry point, not a separate path.

PluginConfig
```
import type { PluginConfig } from 'eslint-plugin-file-progress-2'
```
TypeScript type export available for configuring plugin settings.

Quickstart

Shows ESLint flat config with plugin import, recommended preset, and custom progress settings.

import plugin from 'eslint-plugin-file-progress-2';
import { configs } from 'eslint-plugin-file-progress-2';

export default [
  ...configs.recommended,
  {
    plugins: {
      'file-progress-2': plugin
    },
    settings: {
      progress: {
        prefixMark: '⏳',
        successMark: '✅',
        failureMark: '❌',
        hidePrefix: false,
        hideDirectoryNames: false,
        fileNameOnNewLine: false
      }
    }
  }
];