elint

library2.0.1jsnpmunverified

elint is a unified linting orchestrator that wraps ESLint, Stylelint, and Commitlint, providing a single command (elint) to run all three tools with minimal configuration. Version 2.0.1 (latest) supports Node >=10.12.0 and is maintained by x-orpheus. It differentiates by offering a zero-config setup for static analysis of JavaScript/TypeScript, CSS, and commit messages, while also allowing custom presets via .elintrc. Compared to alternatives like standard or Husky, elint bundles multiple linters into one dependency, simplifying CI and pre-commit hooks integration. It supports .eslintignore, .stylelintignore, and caching for performance. However, note that version 2.x introduces breaking changes in configuration structure versus 1.x.

testing

npm install elint

github ↗package ↗

INSTALL

IMPORT

SIG · ELINT

elint

testingjavascriptv2.0.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

default (elint function)

✓ import elint from 'elint'

✗ const elint = require('elint')

ESM-only since v2; CJS require is not supported.

runLint

✓ import { runLint } from 'elint'

Named export for programmatic use, available since v2.

Config type

✓ import type { ElintConfig } from 'elint'

TypeScript users should import type for config interface.

createConfig

✓ import { createConfig } from 'elint'

✗ import createConfig from 'elint'

createConfig is a named export, not default.

Shows zero-config setup with optional .elintrc override, CLI command, and programmatic linting.

// Install elint and peer dependencies // npm install --save-dev elint eslint stylelint @commitlint/cli // .elintrc (optional override) { "eslint": { "config": { "extends": ["eslint:recommended"] } }, "stylelint": { "config": { "extends": ["stylelint-config-standard"] } }, "commitlint": { "config": { "extends": ["@commitlint/config-conventional"] } } } // Run all linters // npx elint --fix // Programmatic usage import elint from 'elint'; const result = elint.lint(['src/**/*.{js,css}'], { fix: true }); console.log(result.results);

elint --version

Debug

Known issues

breakingv2.0.0 changed configuration structure; .elintrc format is different from v1.x

fix

Update .elintrc to use nested keys per linter (eslint, stylelint, commitlint) instead of flat options.

affects: >=2.0.0 <2.0.1

breakingv2 switches to ESM-only exports; CJS require() throws error

fix

Use import statements or dynamic import() in CommonJS contexts.

affects: >=2.0.0

deprecatedelint.lintFiles() is deprecated in v2.0.1; use elint.lint() instead

fix

Replace elint.lintFiles(args) with elint.lint(args).

affects: >=2.0.0

gotchaelint does not install peer dependencies automatically; missing eslint, stylelint, or commitlint causes silent failures

fix

Install peer dependencies explicitly: npm install --save-dev eslint stylelint @commitlint/cli

affects: >=1.0.0

gotchaelint ignores .eslintrc if .elintrc is present with eslint config; merging is not automatic

fix

Either remove .elintrc or include all rules within it; see docs for resolution strategy.

affects: >=2.0.0

Errors

Common errors & fixes

Error: Cannot find module 'eslint'

ESLint peer dependency not installed

fix

Run 'npm install --save-dev eslint' in your project directory.

TypeError: elint.lintFiles is not a function

Using deprecated API from v2

fix

Replace elint.lintFiles() with elint.lint().

SyntaxError: Unexpected token 'export'

CJS require() used with ESM-only package

fix

Use import syntax or set "type": "module" in package.json, or use dynamic import().

ERR_PEER_DEPENDENCY_MISSING

One or more peer dependencies not installed

fix

Run 'npx elint install-peers' or manually npm install the missing package.

Upgrade

Version history

2.0.1latest on npm

Audit

Dependencies

eslintrequiredPeer dependency for JavaScript/TypeScript linting

stylelintoptionalPeer dependency for CSS/SCSS linting

@commitlint/clioptionalPeer dependency for commit message linting

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/x-orpheus/elint ↗

packagehttps://www.npmjs.com/package/elint ↗