privatenumber/lintroll

Lintroll

Batteries-included ESLint with 12+ plugins for TypeScript, Vue, React, JSON, YAML, and Markdown.

CLI

lintroll .                          # Lint directory
lintroll . --fix                    # Auto-fix
lintroll . --fix --cache            # Fix with caching
lintroll --git .                    # Only git-tracked files
lintroll --git --fix .              # Fix only tracked files
lintroll --staged --fix             # Pre-commit hook
lintroll . --node                   # Enable Node.js rules
lintroll . --node=./scripts         # Node.js rules for specific paths
lintroll . --quiet                  # Errors only (no warnings)
lintroll . --allow-abbreviation db  # Allow specific abbreviations

Style Rules

| Rule | Enforced style | |------|---------------| | Indentation | Tabs | | Quotes | Single | | Semicolons | Always | | Line length | 100 chars max | | Trailing commas | Multiline only | | Functions | Arrow (except this/arguments/generators/hoisting) | | Types | type = over interface | | Type imports | Separate import type from value imports | | No any | Use unknown and narrow | | Unused vars | Prefix with _ (e.g. _unused) | | No abbreviations | db → database, env → environment, pkg → packageJson | | Import extensions | .js not .ts (unless allowImportingTsExtensions: true) | | React filenames | PascalCase (UserProfile.tsx) |

Abbreviation Mapping

Common renames enforced by unicorn/prevent-abbreviations:

| Abbreviation | Full name | |-------------|-----------| | args | arguments_ (reserved word) | | db | database | | env | environment | | pkg | packageJson | | temp | temporary | | res | response | | req | request | | dir | directory | | err | error | | msg | message |

Loop indices i, j are always allowed. Add more with --allow-abbreviation.

ESLint Config

Zero-config:

// eslint.config.js
export { default } from 'lintroll'

Custom:

// eslint.config.ts
import { defineConfig, pvtnbr } from 'lintroll'

export default defineConfig([
    { ignores: ['tests/fixtures/**/*'] },
    ...pvtnbr({
        node: true,
        allowAbbreviations: {
            exactWords: ['i', 'j'],
            substrings: ['db', 'env']
        }
    })
])

For full API types, see node_modules/lintroll/dist/index.d.mts.

Auto-Detection

| Feature | Detection | |---------|-----------| | Vue.js | *.vue files present — rules apply automatically | | TypeScript | tsconfig.json present | | Node.js | .cjs, .mts, scripts/**, bin entries |

Ignored by Default

• node_modules/**, dist/**, vendor/**
• package-lock.json, pnpm-lock.yaml
• *.min.js, .vitepress
• AI assistant files: CLAUDE.md, .claude/, copilot.json, .cursorrules

JSON/YAML

• package.json keys auto-sorted: name → version → description → ... → scripts → dependencies → devDependencies
• JSON style: tabs, trailing commas, spaces around braces { "key": "value" }

Gotchas

• Abbreviation rules disabled in .d.ts — declaration files follow standard conventions
• .ts extensions in imports — use .js unless tsconfig has allowImportingTsExtensions: true
• Markdown code blocks in skills/ directories — automatically ignored (not linted as project code)