@pobammer-ts/eslint-cease-nonsense-rules 0.4.1 → 0.4.3

package/dist/rules/use-exhaustive-dependencies.d.ts

@@ -1,3 +1,98 @@
-import type { Rule } from "eslint";
+import { TSESTree } from "@typescript-eslint/types";
+import type { Rule, Scope } from "eslint";
+/**
+ * Stable result configuration.
+ */
+type StableResult = boolean | ReadonlySet<number> | ReadonlySet<string>;
+declare function resetTestingMetrics(): void;
+/**
+ * Minimal definition information used for stability analysis.
+ */
+interface VariableDefinitionLike {
+    readonly node: TSESTree.Node | Rule.Node;
+    readonly type: string;
+}
+/**
+ * Minimal variable interface compatible with ESLint scope variables.
+ */
+interface VariableLike {
+    readonly defs: ReadonlyArray<VariableDefinitionLike>;
+}
+/**
+ * Capture information from closure analysis.
+ */
+interface CaptureInfo {
+    readonly name: string;
+    readonly node: TSESTree.Node;
+    readonly usagePath: string;
+    readonly variable: VariableLike | undefined;
+    readonly depth: number;
+}
+/**
+ * Checks if a stable array index is being accessed.
+ *
+ * @param stableResult - The stable result set.
+ * @param node - The variable declarator node.
+ * @param identifierName - The identifier name being accessed.
+ * @returns True if accessing a stable array index.
+ */
+declare function isStableArrayIndex(stableResult: StableResult | undefined, node: Scope.Definition["node"], identifierName: string): boolean;
+/**
+ * Checks if a value is stable (doesn't need to be in dependencies).
+ *
+ * @param variable - The variable to check.
+ * @param identifierName - The identifier name being accessed.
+ * @param stableHooks - Map of stable hooks.
+ * @returns True if the value is stable.
+ */
+declare function isStableValue(variable: VariableLike | undefined, identifierName: string, stableHooks: Map<string, StableResult>): boolean;
+/**
+ * Checks if an identifier is in a TypeScript type-only position.
+ * Type parameters and type annotations are compile-time only and should not be dependencies.
+ *
+ * @param identifier - The identifier node to check.
+ * @returns True if the identifier is in a type-only position.
+ */
+declare function isInTypePosition(identifier: TSESTree.Identifier): boolean;
+/**
+ * Checks if a variable is declared directly in the component/hook body OR is a prop (parameter).
+ * Per React rules, only variables "declared directly inside the component body" are reactive.
+ * This includes props (function parameters).
+ * Variables from outer scopes (module-level, parent functions) are non-reactive.
+ *
+ * @param variable - The variable to check.
+ * @param closureNode - The closure node (useEffect callback, etc.).
+ * @returns True if the variable is declared in the component body or is a prop.
+ */
+declare function isDeclaredInComponentBody(variable: VariableLike, closureNode: TSESTree.Node): boolean;
+/**
+ * Collects all captured identifiers from a closure.
+ *
+ * @param node - The closure node (function/arrow function).
+ * @param scope - The scope of the closure.
+ * @param sourceCode - The source code instance.
+ * @returns Array of captured identifiers.
+ */
+declare function collectCaptures(node: TSESTree.Node, scope: Scope.Scope, sourceCode: Rule.RuleContext["sourceCode"]): ReadonlyArray<CaptureInfo>;
+/**
+ * Converts stableResult configuration to internal format.
+ *
+ * @param stableResult - The stable result configuration.
+ * @returns The internal stable result format.
+ */
+declare function convertStableResult(stableResult: boolean | number | ReadonlyArray<number> | ReadonlyArray<string>): StableResult;
 declare const useExhaustiveDependencies: Rule.RuleModule;
+export declare const __testing: {
+    collectCaptures: typeof collectCaptures;
+    convertStableResult: typeof convertStableResult;
+    isDeclaredInComponentBody: typeof isDeclaredInComponentBody;
+    isInTypePosition: typeof isInTypePosition;
+    isStableArrayIndex: typeof isStableArrayIndex;
+    isStableValue: typeof isStableValue;
+    metrics: {
+        moduleLevelStableConst: number;
+        outerScopeSkip: number;
+    };
+    resetMetrics: typeof resetTestingMetrics;
+};
 export default useExhaustiveDependencies;