🔍 ESLint Plugin: suggest-members


Production-ready ESLint plugin that intelligently suggests corrections for typos in TypeScript/JavaScript code. Built with Functional Core, Imperative Shell architecture for maximum reliability and performance.

✨ Key Features

- 🎯 Smart Suggestions: Advanced similarity algorithms (Levenshtein + context analysis)
- 🚀 TypeScript Integration: Full type-aware analysis with graceful fallbacks
- ⚡ High Performance: Optimized for large codebases with caching
- 🛡️ Zero Breaking: Never interrupts your linting workflow
- 🧪 100% Tested: Comprehensive test coverage with property-based testing
- 📦 ESM Ready: Modern ES modules with TypeScript support

🎯 Real-World Examples

$3

``typescript
// ❌ Typo in React hook import
import { useStae, useEffect } from 'react'
// ~~~~~~~
// ✅ ESLint Error: Module 'react' does not export 'useStae'. Did you mean:
// - useState
// - useRef
// - useMemo
// - useCallback
`

$3

`typescript
// ❌ Typo in localStorage method
localStorage.get1Item('token')
// ~~~~~~~~
// ✅ ESLint Error: Property "get1Item" does not exist. Did you mean:
// - getItem(key: string): string | null
// - setItem(key: string, value: string)
// - removeItem(key: string)
// - clear(): void
`

$3

`typescript
// ❌ Typo in file path
import styles from './HamsterKo1mbatPage.css'
// ~~~~~~~~~~~~~~~~~~~~~~
// ✅ ESLint Error: Cannot find module "./HamsterKo1mbatPage.css". Did you mean:
// - ./HamsterKombatPage.css
// - ./HamsterKombatPage.tsx
// - ./HamsterKombatPage
// - ../ThemeParamsPage.css
`

$3

`typescript
// ❌ Typo in named import
import { saveRe1f } from './hooks'
// ~~~~~~~~
// ✅ ESLint Error: Variable "saveRe1f" is not defined. Did you mean:
// - saveRef
// - saveState
// - useRef
// - useState
`

📦 Installation

`bash


npm

npm install -D @ton-ai-core/eslint-plugin-suggest-members

yarn

yarn add -D @ton-ai-core/eslint-plugin-suggest-members

pnpm

pnpm add -D @ton-ai-core/eslint-plugin-suggest-members
`

⚙️ Configuration

$3

`javascript
// eslint.config.js
import suggestMembers from "@ton-ai-core/eslint-plugin-suggest-members";

export default [
{
files: ["*/.{ts,tsx,js,jsx}"],
plugins: {
"suggest-members": suggestMembers
},
rules: {
"suggest-members/suggest-exports": "error",
"suggest-members/suggest-imports": "error",
"suggest-members/suggest-members": "error",
"suggest-members/suggest-module-paths": "error"
}
}
];
`

$3


`json
{
"plugins": ["@ton-ai-core/suggest-members"],
"rules": {
"@ton-ai-core/suggest-members/suggest-exports": "error",
"@ton-ai-core/suggest-members/suggest-imports": "error",
"@ton-ai-core/suggest-members/suggest-members": "error",
"@ton-ai-core/suggest-members/suggest-module-paths": "error"
}
}
`

$3

Instead of manually configuring each rule, you can use our recommended configuration that automatically enables all rules:

#### ESLint v9+ (Flat Config)
`javascript
// eslint.config.js
import suggestMembers from "@ton-ai-core/eslint-plugin-suggest-members";

export default [
{
files: ["*/.{ts,tsx,js,jsx}"],
plugins: {
"suggest-members": suggestMembers
},
...suggestMembers.configs.recommended // Automatically enables all rules
}
];
`

#### ESLint v8 (Legacy Config)
`json
{
"extends": ["plugin:@ton-ai-core/suggest-members/recommended"],
"plugins": ["@ton-ai-core/suggest-members"]
}
`

$3


`json
// tsconfig.json - Required for full functionality
{
"compilerOptions": {
"strict": true,
"noImplicitAny": true
},
"include": ["src/*/"]
}
`

🔧 Rules Reference

| Rule | Description | TypeScript Required |
|------|-------------|-------------------|
| suggest-exports | Suggests corrections for non-existent exports | ✅ Recommended |
| suggest-imports | Suggests corrections for non-existent imports | ✅ Recommended |
| suggest-members | Suggests corrections for object properties/methods | ✅ Required |
| suggest-module-paths | Suggests corrections for module paths | ❌ Filesystem only |

🚀 Performance & Reliability

$3

- ⚡ Fast: < 100ms analysis per file
- 🧠 Smart Caching: Reuses TypeScript program instances
- 🛡️ Graceful Fallbacks: Works without TypeScript service
- 📊 Memory Efficient: Optimized for large codebases

$3

`typescript
// Functional Core: Pure functions only
const calculateSimilarity = (target: string, candidates: readonly string[]): SimilarityScore[]

// Imperative Shell: Controlled effects
const validateWithTypeScript = Effect.gen(function* (_) {
const typeChecker = yield* _(TypeScriptService)
const members = yield* _(getTypeMembers(type))
return createSuggestions(members)
})
`

🧪 Testing & Quality

`bash


Run all tests

npm test

Test specific rules

npm run test:rules

Integration testing

npm run test:integration

Lint and build

npm run build
`

$3

- ✅ 100% Test Coverage: 20/20 tests passing
- ✅ Zero ESLint Errors: Clean codebase
- ✅ TypeScript Strict: Full type safety
- ✅ Performance: Benchmarked on 1000+ file projects

🤝 Contributing

We welcome contributions! Please see our ROADMAP.md for planned features.

$3

`bash
git clone https://github.com/ton-ai-core/eslint-plugin-suggest-members.git
cd eslint-plugin-suggest-members
npm install
npm run build
npm test
`

$3

- 🏗️ Functional Core, Imperative Shell: Pure functions + controlled effects
- 🔒 Type Safety: No any`, exhaustive pattern matching
- 🧪 Test-Driven: Property-based + unit + integration tests
- 📚 Documentation: Every function has mathematical invariants

📋 Changelog

See CHANGELOG.md for detailed release notes.

🆘 Support

- 🐛 Bug Reports: GitHub Issues
- 💡 Feature Requests: GitHub Discussions
- 📖 Documentation: README.md + inline JSDoc

📄 License

MIT © TON AI

---

Made with ❤️ by the TON AI team