Registry / testing / lint-to-the-future-eslint

lint-to-the-future-eslint

library3.3.0jsnpmunverified

A plugin for lint-to-the-future that integrates with ESLint to track and manage eslint-disable comments across projects. Current stable version is 3.3.0. Release cadence is irregular, with minor releases every few months. Key differentiators: allows incremental adoption of ESLint rules by tracking disable directives, supports both flat config (ESLint >=9) and legacy .eslintrc, and provides a remove API to clean up stale disable comments. Peer dependency on ESLint ^6.0.0 || ^7.0.0 || ^8.0.0 || ^9.0.0. Requires Node.js >=18 since v3.0.0. Uses globby for file filtering since v3.1.0.

testing devops

npm install lint-to-the-future-eslint

github ↗package ↗

INSTALL

IMPORT

SIG · LINT-TO-THE-FUTURE

lint-to-the-future-eslint

testingjavascriptv3.3.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.

default (plugin object)

✓ import lintToTheFutureEslint from 'lint-to-the-future-eslint'

✗ const { LintToTheFutureEslint } = require('lint-to-the-future-eslint')

Package exports a single default object. In CommonJS, use require('lint-to-the-future-eslint').

Plugin (TypeScript type)

✓ import type { Plugin } from 'lint-to-the-future-eslint'

TypeScript typings are included. The Plugin type is for usage with lint-to-the-future's configuration.

Demonstrates basic configuration and programmatic usage of lint-to-the-future-eslint with lint-to-the-future, including flat config support.

// Add lint-to-the-future-eslint to your lint-to-the-future configuration // .lint-to-the-future.json { "plugins": ["lint-to-the-future-eslint"], "files": ["src/**/*.js", "src/**/*.ts", "src/**/*.gjs", "src/**/*.gts"], "eslint": {} } // Run lint-to-the-future to generate report // npx lint-to-the-future build // Example programmatic usage import lintToTheFutureEslint from 'lint-to-the-future-eslint'; const result = await lintToTheFutureEslint({ cwd: process.cwd(), globs: ['src/**/*.js'], eslintOptions: { overrideConfig: { rules: { 'no-console': 'warn' } } } }); console.log(result); // { files: [...], stats: { total: 10, disabled: 3 } }

lint-to-the-future --version

Debug

Known issues

breakingVersion 3.0.0 drops support for Node.js <18 and ESLint 7. Ensure your runtime is Node >=18 and ESLint >=8.

fix

Upgrade Node.js to >=18 and ESLint to ^8.0.0 || ^9.0.0.

affects: >=3.0.0

deprecatedESLint legacy .eslintrc format is still supported but may be removed in a future major version. Flat config is preferred.

fix

Migrate to ESLint flat config (eslint.config.js) for forward compatibility.

affects: >=3.3.0

gotchaThe plugin only processes eslint-disable comments. Other disable directives like eslint-disable-next-line are not tracked unless they span multiple lines.

fix

Ensure your disable comments are formatted as eslint-disable blocks to be detected.

affects: all

gotchaFile filtering uses globby since v3.1.0. Custom file patterns may need adjustment if you were relying on previous filtering behavior.

fix

Review your lint-to-the-future configuration's files glob pattern.

affects: >=3.1.0

gotchaThe plugin does not support ESLint's --no-inline-config flag; inline disable comments are always considered.

fix

If you need to ignore disable comments, use a custom ESLint configuration that overrides noInlineConfig.

affects: all

Errors

Common errors & fixes

Error: Cannot find module 'lint-to-the-future-eslint'

The package is not installed or is missing from node_modules.

fix

Run `npm install lint-to-the-future-eslint --save-dev` or `yarn add lint-to-the-future-eslint --dev`.

TypeError: plugin is not a function

The plugin is used incorrectly in lint-to-the-future configuration (e.g., imported as a named export instead of default).

fix

Use `import lintToTheFutureEslint from 'lint-to-the-future-eslint'` or `const lintToTheFutureEslint = require('lint-to-the-future-eslint')`.

ESLint configuration error: 'lint-to-the-future-eslint' plugin not found

The plugin is listed in eslint's plugins array but not installed.

fix

Install the package: `npm install lint-to-the-future-eslint --save-dev` and ensure it's added to eslint's plugins.

Error [ERR_REQUIRE_ESM]: require() of ES Module not supported

Using CommonJS require() to load the package which is ESM-only in newer versions.

fix

Either use dynamic import() or switch to ESM for your project: add `"type": "module"` to package.json and use import syntax.

Upgrade

Version history

3.3.0latest on npm

Audit

Dependencies

lint-to-the-futurerequiredCore framework that provides the tracking and reporting infrastructure.

eslintrequiredPeer dependency required to lint files and parse eslint-disable comments.

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/mansona/lint-to-the-future-eslint ↗

packagehttps://www.npmjs.com/package/lint-to-the-future-eslint ↗