@prover-coder-ai/eslint-plugin-suggest-members 0.0.0

package/.jscpd.json

@@ -0,0 +1,16 @@
+{
+	"threshold": 0,
+	"minTokens": 30,
+	"minLines": 5,
+	"ignore": [
+		"**/node_modules/**",
+		"**/build/**",
+		"**/dist/**",
+		"**/*.min.js",
+		"**/reports/**"
+	],
+	"skipComments": true,
+	"ignorePattern": [
+		"private readonly \\w+: \\w+;\\s*private readonly \\w+: \\w+;\\s*private \\w+: \\w+ \\| null = null;\\s*private \\w+: \\w+ \\| null = null;"
+	]
+}

package/README.md

@@ -0,0 +1,104 @@
+# `@prover-coder-ai/eslint-plugin-suggest-members`
+
+Production‑ready ESLint plugin that suggests corrections for typos in TypeScript/JavaScript code. Built with Functional Core / Imperative Shell and Effect‑TS.
+
+## ✨ Key Features
+
+- Smart suggestions for typos (similarity scoring)
+- TypeScript‑aware diagnostics with signatures
+- Filesystem‑based module path suggestions
+- Fully typed, Effect‑TS based architecture
+
+## ⚙️ Configuration (ESLint v9+ Flat Config)
+
+```js
+// eslint.config.js
+import suggestMembers from "@prover-coder-ai/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-missing-names": "error",
+      "suggest-members/suggest-module-paths": "error"
+    }
+  }
+]
+```
+
+## ✅ Example Diagnostics
+
+### Export Suggestions (`suggest-exports`)
+```ts
+// ❌ Typo in React hook import
+export { useStae, useEffect } from "react"
+// ✅ ESLint Error: Export 'useStae' does not exist on type 'typeof import("react")'. Did you mean:
+//    - useState
+//    - useRef
+//    - useMemo
+//    - useCallback
+```
+
+### Member Suggestions (`suggest-members`)
+```ts
+// ❌ Typo in localStorage method
+localStorage.get1Item("token")
+// ✅ ESLint Error: Property 'get1Item' does not exist on type 'Storage'. Did you mean:
+//    - getItem(key: string): string | null
+//    - setItem(key: string, value: string)
+//    - removeItem(key: string)
+//    - clear(): void
+```
+
+### Module Path Suggestions (`suggest-module-paths`)
+```ts
+// ❌ 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
+```
+
+### Import Suggestions (`suggest-imports`)
+```ts
+// ❌ Typo in named import
+import { saveRe1f } from "./hooks"
+// ✅ ESLint Error: Export 'saveRe1f' does not exist on type 'typeof import("./hooks")'. Did you mean:
+//    - saveRef
+//    - saveState
+//    - useRef
+//    - useState
+```
+
+### Missing Name Suggestions (`suggest-missing-names`)
+```ts
+// ❌ Typo in local identifier
+const formatGree1ting = () => "ok"
+formatGreeting()
+// ✅ ESLint Error: Cannot find name 'formatGreeting'. Did you mean:
+//    - formatGree1ting(): string
+```
+
+## 📚 Rules
+
+| Name | Description | TS Required |
+| --- | --- | --- |
+| [suggest-exports](docs/rules/suggest-exports.md) | Suggests corrections for missing exports | ✅ |
+| [suggest-imports](docs/rules/suggest-imports.md) | Suggests corrections for missing imports | ✅ |
+| [suggest-members](docs/rules/suggest-members.md) | Suggests corrections for missing members | ✅ |
+| [suggest-missing-names](docs/rules/suggest-missing-names.md) | Suggests corrections for unresolved identifiers | ✅ |
+| [suggest-module-paths](docs/rules/suggest-module-paths.md) | Suggests corrections for missing module paths | ❌ |
+
+## Development
+
+```sh
+pnpm --filter @prover-coder-ai/eslint-plugin-suggest-members test
+```

package/biome.json

@@ -0,0 +1,37 @@
+{
+	"vcs": {
+		"enabled": false,
+		"clientKind": "git",
+		"useIgnoreFile": false
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": false,
+		"indentStyle": "tab"
+	},
+	"assist": {
+		"actions": {
+			"source": {
+				"organizeImports": "off"
+			}
+		}
+	},
+	"linter": {
+		"enabled": false,
+		"rules": {
+			"recommended": false,
+			"suspicious": {
+				"noExplicitAny": "off"
+			}
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"enabled": false,
+			"quoteStyle": "double",
+			"semicolons": "asNeeded"
+		}
+	}
+}

package/docs/rules/no-loop-over-enums.md

@@ -0,0 +1,29 @@
+# Avoid looping over enums (`example-typed-linting/no-loop-over-enums`)
+
+💭 This rule requires [type information](https://typescript-eslint.io/linting/typed-linting).
+
+<!-- end auto-generated rule header -->
+
+Example rule that demonstrates banning `for-in` looping over `enum`s.
+
+## Valid
+
+```ts
+const values = {};
+for (const a in values) {
+}
+```
+
+```ts
+const values = [];
+for (const a of values) {
+}
+```
+
+## Invalid
+
+```ts
+enum Values {}
+for (const a of values) {
+}
+```

package/docs/rules/suggest-exports.md

@@ -0,0 +1,15 @@
+# Suggest export names (`suggest-exports`)
+
+Reports when a re-export targets a missing export and suggests the closest matches.
+
+Example:
+
+```ts
+// ❌ Typo in React hook import
+export { useStae, useEffect } from "react"
+// ✅ ESLint Error: Export 'useStae' does not exist on type 'typeof import("react")'. Did you mean:
+//    - useState
+//    - useRef
+//    - useMemo
+//    - useCallback
+```

package/docs/rules/suggest-imports.md

@@ -0,0 +1,15 @@
+# Suggest import names (`suggest-imports`)
+
+Reports when a named import does not exist and suggests similar exports.
+
+Example:
+
+```ts
+// ❌ Typo in named import
+import { saveRe1f } from "./hooks"
+// ✅ ESLint Error: Export 'saveRe1f' does not exist on type 'typeof import("./hooks")'. Did you mean:
+//    - saveRef
+//    - saveState
+//    - useRef
+//    - useState
+```

package/docs/rules/suggest-members.md

@@ -0,0 +1,15 @@
+# Suggest member names (`suggest-members`)
+
+Reports when accessing a missing member and suggests similar properties/methods with signatures.
+
+Example:
+
+```ts
+// ❌ Typo in localStorage method
+localStorage.get1Item("token")
+// ✅ ESLint Error: Property 'get1Item' does not exist on type 'Storage'. Did you mean:
+//    - getItem(key: string): string | null
+//    - setItem(key: string, value: string)
+//    - removeItem(key: string)
+//    - clear(): void
+```

package/docs/rules/suggest-missing-names.md

@@ -0,0 +1,13 @@
+# Suggest missing names (`suggest-missing-names`)
+
+Reports unresolved identifiers and suggests similar in-scope names with signatures.
+
+Example:
+
+```ts
+// ❌ Typo in local identifier
+const formatGree1ting = () => "ok"
+formatGreeting()
+// ✅ ESLint Error: Cannot find name 'formatGreeting'. Did you mean:
+//    - formatGree1ting(): string
+```

package/docs/rules/suggest-module-paths.md

@@ -0,0 +1,15 @@
+# Suggest module paths (`suggest-module-paths`)
+
+Reports when a module path cannot be resolved and suggests similar paths.
+
+Example:
+
+```ts
+// ❌ 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
+```

package/eslint.config.mts

@@ -0,0 +1,265 @@
+// eslint.config.mjs
+// @ts-check
+import eslint from '@eslint/js';
+import eslintPlugin from "eslint-plugin-eslint-plugin";
+import tseslint from 'typescript-eslint';
+import vitest from "eslint-plugin-vitest";
+import suggestMembers from "@ton-ai-core/eslint-plugin-suggest-members";
+import sonarjs from "eslint-plugin-sonarjs";
+import unicorn from "eslint-plugin-unicorn";
+import * as effectEslint from "@effect/eslint-plugin";
+import { fixupPluginRules } from "@eslint/compat";
+import codegen from "eslint-plugin-codegen";
+import importPlugin from "eslint-plugin-import";
+import simpleImportSort from "eslint-plugin-simple-import-sort";
+import sortDestructureKeys from "eslint-plugin-sort-destructure-keys";
+import globals from "globals";
+import eslintCommentsConfigs from "@eslint-community/eslint-plugin-eslint-comments/configs";
+
+const codegenPlugin = fixupPluginRules(
+	codegen as unknown as Parameters<typeof fixupPluginRules>[0],
+);
+const suggestMembersRecommended = suggestMembers.configs["recommended"];
+
+export default tseslint.config(
+  { ignores: ["lib"] },
+  eslint.configs.recommended,
+  tseslint.configs.recommendedTypeChecked,
+  eslintPlugin.configs.recommended,
+  tseslint.configs.strictTypeChecked,
+  effectEslint.configs.dprint,
+  ...(suggestMembersRecommended ? [suggestMembersRecommended] : []),
+  eslintCommentsConfigs.recommended,
+  {
+    name: "analyzers",
+    languageOptions: {
+      parser: tseslint.parser,
+	  globals: { ...globals.node, ...globals.browser },
+      parserOptions: {
+        projectService: {
+          allowDefaultProject: ["*.config.*"],
+          defaultProject: "tsconfig.json",
+        },
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+	plugins: {
+		sonarjs,
+		unicorn,
+		import: fixupPluginRules(importPlugin),
+		"sort-destructure-keys": sortDestructureKeys,
+		"simple-import-sort": simpleImportSort,
+		codegen: codegenPlugin,
+	},
+	files: ["**/*.ts", '**/*.{test,spec}.{ts,tsx}', '**/tests/**', '**/__tests__/**'],
+	settings: {
+		"import/parsers": {
+			"@typescript-eslint/parser": [".ts", ".tsx"],
+		},
+		"import/resolver": {
+			typescript: {
+				alwaysTryTypes: true,
+			},
+		},
+	},
+	rules: {
+		...sonarjs.configs.recommended.rules,
+		...unicorn.configs.recommended.rules,
+		"no-restricted-imports": ["error", {
+			paths: [
+				{
+					name: "ts-pattern",
+					message: "Use Effect.Match instead of ts-pattern.",
+				},
+				{
+					name: "zod",
+					message: "Use @effect/schema for schemas and validation.",
+				},
+			],
+		}],
+		"codegen/codegen": "error",
+		"import/first": "error",
+		"import/newline-after-import": "error",
+		"import/no-duplicates": "error",
+		"import/no-unresolved": "off",
+		"import/order": "off",
+		"simple-import-sort/imports": "off",
+		"sort-destructure-keys/sort-destructure-keys": "error",
+		"no-fallthrough": "off",
+		"no-irregular-whitespace": "off",
+		"object-shorthand": "error",
+		"prefer-destructuring": "off",
+		"sort-imports": "off",
+		"no-unused-vars": "off",
+		"prefer-rest-params": "off",
+		"prefer-spread": "off",
+		"unicorn/prefer-top-level-await": "off",
+		"unicorn/prevent-abbreviations": "off",
+		"unicorn/no-null": "off",
+		complexity: ["error", 8],
+		"max-lines-per-function": [
+			"error",
+			{ max: 50, skipBlankLines: true, skipComments: true },
+		],
+		"max-params": ["error", 5],
+		"max-depth": ["error", 4],
+		"max-lines": [
+			"error",
+			{ max: 300, skipBlankLines: true, skipComments: true },
+		],
+
+		"@typescript-eslint/restrict-template-expressions": ["error", {
+			allowNumber: true,
+			allowBoolean: true,
+			allowNullish: false,
+			allowAny: false,
+			allowRegExp: false
+		}],
+		"@eslint-community/eslint-comments/no-use": "error",
+		"@eslint-community/eslint-comments/no-unlimited-disable": "error",
+		"@eslint-community/eslint-comments/disable-enable-pair": "error",
+		"@eslint-community/eslint-comments/no-unused-disable": "error",
+		"no-restricted-syntax": [
+				"error",
+				{
+					selector: "TSUnknownKeyword",
+					message: "Запрещено 'unknown'.",
+				},
+				{
+					selector: "TryStatement",
+					message: "Используй Effect.try / catchAll вместо try/catch в core/app/domain.",
+				},
+				{
+					selector: "SwitchStatement",
+					message: [
+						"Switch statements are forbidden in functional programming paradigm.",
+						"How to fix: Use Effect.Match instead.",
+						"Example:",
+						"  import { Match } from 'effect';",
+						"  type Item = { type: 'this' } | { type: 'that' };",
+						"  const result = Match.value(item).pipe(",
+						"    Match.when({ type: 'this' }, (it) => processThis(it)),",
+						"    Match.when({ type: 'that' }, (it) => processThat(it)),",
+						"    Match.exhaustive,",
+						"  );",
+					].join("\n"),
+				},
+				{
+					selector: 'CallExpression[callee.name="require"]',
+					message: "Avoid using require(). Use ES6 imports instead.",
+				},
+				{
+					selector: "ThrowStatement > Literal:not([value=/^\\w+Error:/])",
+					message:
+						'Do not throw string literals or non-Error objects. Throw new Error("...") instead.',
+				},
+				{
+					selector:
+						"FunctionDeclaration[async=true], FunctionExpression[async=true], ArrowFunctionExpression[async=true]",
+					message:
+						"Запрещён async/await — используй Effect.gen / Effect.tryPromise.",
+				},
+				{
+					selector: "NewExpression[callee.name='Promise']",
+					message:
+						"Запрещён new Promise — используй Effect.async / Effect.tryPromise.",
+				},
+				{
+					selector: "CallExpression[callee.object.name='Promise']",
+					message:
+						"Запрещены Promise.* — используй комбинаторы Effect (all, forEach, etc.).",
+				},
+				{
+					selector: "CallExpression[callee.property.name='push'] > SpreadElement.arguments",
+					message: "Do not use spread arguments in Array.push",
+				},
+		],
+		"no-throw-literal": "error",
+		"@typescript-eslint/no-restricted-types": [
+				"error",
+				{
+					types: {
+						unknown: {
+							message:
+								"Не используем 'unknown'. Уточни тип или наведи порядок в источнике данных.",
+						},
+						Promise: {
+							message: "Запрещён Promise — используй Effect.Effect<A, E, R>.",
+							suggest: ["Effect.Effect"],
+						},
+						"Promise<*>": {
+							message:
+								"Запрещён Promise<T> — используй Effect.Effect<T, E, R>.",
+							suggest: ["Effect.Effect<T, E, R>"],
+						},
+					},
+				},
+			],
+		"@typescript-eslint/use-unknown-in-catch-callback-variable": "off",
+		// "no-throw-literal": "off",
+		"@typescript-eslint/only-throw-error": [
+			"error",
+			{ allowThrowingUnknown: false, allowThrowingAny: false },
+		],
+		"@typescript-eslint/array-type": ["warn", {
+			default: "generic",
+			readonly: "generic"
+		}],
+		"@typescript-eslint/member-delimiter-style": 0,
+		"@typescript-eslint/no-non-null-assertion": "off",
+		"@typescript-eslint/ban-types": "off",
+		"@typescript-eslint/no-explicit-any": "off",
+		"@typescript-eslint/no-empty-interface": "off",
+		"@typescript-eslint/consistent-type-imports": "warn",
+		"@typescript-eslint/no-unused-vars": ["error", {
+			argsIgnorePattern: "^_",
+			varsIgnorePattern: "^_"
+		}],
+		"@typescript-eslint/ban-ts-comment": "off",
+		"@typescript-eslint/camelcase": "off",
+		"@typescript-eslint/explicit-function-return-type": "off",
+		"@typescript-eslint/explicit-module-boundary-types": "off",
+		"@typescript-eslint/interface-name-prefix": "off",
+		"@typescript-eslint/no-array-constructor": "off",
+		"@typescript-eslint/no-use-before-define": "off",
+		"@typescript-eslint/no-namespace": "off",
+		"@effect/dprint": ["error", {
+			config: {
+				indentWidth: 2,
+				lineWidth: 120,
+				semiColons: "asi",
+				quoteStyle: "alwaysDouble",
+				trailingCommas: "never",
+				operatorPosition: "maintain",
+				"arrowFunction.useParentheses": "force"
+			}
+		}]
+	}
+  },
+  {
+    files: ['**/*.{test,spec}.{ts,tsx}', 'tests/**', '**/__tests__/**'],
+    ...vitest.configs.all,
+    languageOptions: {
+      globals: {
+        ...vitest.environments.env.globals,
+      },
+    },
+    rules: {
+      // Allow eslint-disable/enable comments in test files for fine-grained control
+      '@eslint-community/eslint-comments/no-use': 'off',
+      // Disable line count limit for E2E tests that contain multiple test cases
+      'max-lines-per-function': 'off',
+      // `it.effect` is not recognized by sonar rule; disable to avoid false positives
+      'sonarjs/no-empty-test-file': 'off',
+    },
+  },
+
+  // 3) Для JS-файлов отключим типо-зависимые проверки
+  {
+    files: ['**/*.{js,cjs,mjs}'],
+    extends: [tseslint.configs.disableTypeChecked],
+  },
+
+  // 4) Глобальные игноры
+  { ignores: ['dist/**', 'build/**', 'coverage/**', '**/dist/**'] },
+);