codesift-mcp 0.3.0 → 0.5.0

package/dist/tools/react-tools.d.ts

@@ -0,0 +1,263 @@
+import type { CodeSymbol, CallNode } from "../types.js";
+export { buildJsxAdjacency, buildComponentTree, extractJsxComponents, extractHookCalls, extractHookNames, findRuleOfHooksViolations, findRenderRisks };
+export declare const REACT_STDLIB_HOOKS: Set<string>;
+interface JsxAdjacency {
+    /** component id → components it renders */
+    children: Map<string, CodeSymbol[]>;
+}
+/**
+ * Extract PascalCase JSX element names from source code.
+ * Returns the set of component names used via `<ComponentName ...>` or `<ComponentName/>`.
+ * HTML elements (lowercase) are skipped.
+ */
+declare function extractJsxComponents(source: string): Set<string>;
+/**
+ * Build component → rendered-components adjacency from the index.
+ * Only considers symbols with kind "component" (requires Wave 1 extractor).
+ */
+declare function buildJsxAdjacency(symbols: CodeSymbol[]): JsxAdjacency;
+/**
+ * BFS the component composition tree from a root component.
+ * Returns a CallNode tree of rendered components up to maxDepth.
+ */
+declare function buildComponentTree(root: CodeSymbol, adjacency: JsxAdjacency, maxDepth: number): CallNode;
+export interface TraceComponentTreeOptions {
+    depth?: number | undefined;
+    output_format?: "json" | "mermaid" | undefined;
+    include_source?: boolean | undefined;
+    include_tests?: boolean | undefined;
+}
+/**
+ * Trace the React component composition tree from a root component.
+ * Returns a tree of JSX children (which components the root renders,
+ * and recursively their children).
+ */
+export declare function traceComponentTree(repo: string, rootComponent: string, options?: TraceComponentTreeOptions): Promise<CallNode | {
+    mermaid: string;
+    root: string;
+    depth: number;
+}>;
+export interface HookCall {
+    name: string;
+    line: number;
+    is_stdlib: boolean;
+    context: string;
+}
+export interface HookInventoryEntry {
+    name: string;
+    kind: "component" | "hook";
+    file: string;
+    start_line: number;
+    hook_count: number;
+    hooks: HookCall[];
+    violations: string[];
+}
+export interface HookUsageSummary {
+    name: string;
+    count: number;
+    is_stdlib: boolean;
+}
+export interface AnalyzeHooksResult {
+    entries: HookInventoryEntry[];
+    total_components: number;
+    total_custom_hooks: number;
+    hook_usage: HookUsageSummary[];
+    violations_count: number;
+}
+/**
+ * Scan a component/hook source for Rule of Hooks violations.
+ * Detects: hook inside if/for/while/switch, hook after early return.
+ * Returns a list of human-readable violation descriptions.
+ */
+declare function findRuleOfHooksViolations(source: string): string[];
+/**
+ * Extract unique hook names from source (no line numbers, no cap).
+ * Use when you only need the set of hooks — e.g. React context bundle.
+ */
+declare function extractHookNames(source: string): Set<string>;
+/**
+ * Extract hook calls from source with their relative line number.
+ */
+declare function extractHookCalls(source: string): HookCall[];
+/**
+ * Analyze hook usage across components and custom hooks in a repo.
+ *
+ * Returns:
+ * - per-symbol inventory (hooks called, violations)
+ * - codebase-wide hook usage summary
+ * - Rule of Hooks violation count
+ */
+export declare function analyzeHooks(repo: string, options?: {
+    component_name?: string | undefined;
+    file_pattern?: string | undefined;
+    include_tests?: boolean | undefined;
+    max_entries?: number | undefined;
+}): Promise<AnalyzeHooksResult>;
+export interface RenderRisk {
+    type: "inline-object" | "inline-array" | "inline-function" | "unstable-default" | "missing-memo";
+    line: number;
+    context: string;
+    suggestion: string;
+}
+export interface RenderAnalysisEntry {
+    name: string;
+    file: string;
+    start_line: number;
+    is_memoized: boolean;
+    risk_count: number;
+    risk_level: "low" | "medium" | "high";
+    risks: RenderRisk[];
+    /** Components rendered as children (from JSX), useful to see impact */
+    children_count: number;
+}
+export interface AnalyzeRendersResult {
+    entries: RenderAnalysisEntry[];
+    total_components: number;
+    high_risk_count: number;
+    summary: {
+        inline_objects: number;
+        inline_arrays: number;
+        inline_functions: number;
+        unstable_defaults: number;
+        missing_memo: number;
+    };
+}
+/**
+ * Analyze a single component source for re-render risks.
+ */
+declare function findRenderRisks(source: string): RenderRisk[];
+/**
+ * Analyze re-render risk across React components in a repo.
+ *
+ * Detects:
+ * - Inline object/array/function props in JSX (new reference every render)
+ * - Unstable default parameter values ([] or {} in component params)
+ * - Components not wrapped in React.memo that render children (missing-memo)
+ *
+ * Returns per-component risk assessment with actionable suggestions.
+ */
+/**
+ * Format an AnalyzeRendersResult as human-readable Markdown.
+ * Used by analyzeRenders when format="markdown" is requested.
+ */
+export declare function formatRendersMarkdown(result: AnalyzeRendersResult): string;
+export declare function analyzeRenders(repo: string, options?: {
+    component_name?: string | undefined;
+    file_pattern?: string | undefined;
+    include_tests?: boolean | undefined;
+    max_entries?: number | undefined;
+    format?: "json" | "markdown" | undefined;
+}): Promise<AnalyzeRendersResult | string>;
+export interface ReactContextInfo {
+    name: string;
+    created_in: {
+        file: string;
+        line: number;
+    };
+    providers: {
+        file: string;
+        line: number;
+    }[];
+    consumers: {
+        file: string;
+        component: string;
+        line: number;
+    }[];
+}
+export interface ContextGraph {
+    contexts: ReactContextInfo[];
+}
+/**
+ * Build a graph of React Context flows: createContext → Provider → useContext consumers.
+ *
+ * Single-pass scan over all symbols (capped at 500). No cycle detection — relies
+ * on visited set keyed by context name to prevent re-processing.
+ *
+ * Detection patterns:
+ * - createContext call: `const X = createContext(...)` or `const X = React.createContext(...)`
+ * - Provider usage: `<X.Provider value={...}>` (anywhere in any source)
+ * - Consumer usage: `useContext(X)` (anywhere in any source)
+ *
+ * Phase 2 features (not implemented here):
+ * - Cycle detection in provider chains
+ * - Re-render impact analysis ("which consumers re-render when X changes")
+ * - Context value type tracking
+ */
+export declare function buildContextGraph(symbols: CodeSymbol[]): ContextGraph;
+export interface CompilerReadinessResult {
+    /** 0-100 readiness score (100 = fully compatible) */
+    readiness_score: number;
+    total_components: number;
+    /** Components with 0 bailout patterns */
+    compatible_components: number;
+    /** Components with ≥1 bailout pattern */
+    bailout_components: number;
+    /** Count of redundant manual memoization (safe to remove post-adoption) */
+    redundant_memoization: number;
+    /** Bailout issues by pattern, sorted by frequency */
+    issues: Array<{
+        pattern: string;
+        count: number;
+        description: string;
+    }>;
+    /** Top components with most bailout issues */
+    top_bailout_components: Array<{
+        name: string;
+        file: string;
+        issues: number;
+    }>;
+}
+/**
+ * Audit a React codebase for React Compiler (v1.0) adoption readiness.
+ *
+ * Scans all components for patterns that cause the compiler to silently
+ * bail out of auto-memoization. Returns a readiness score (0-100) with
+ * prioritized fix list.
+ *
+ * No competitor offers codebase-wide compiler readiness analysis.
+ */
+export declare function auditCompilerReadiness(repo: string, options?: {
+    file_pattern?: string | undefined;
+    include_tests?: boolean | undefined;
+}): Promise<CompilerReadinessResult>;
+export interface ReactQuickstartResult {
+    /** Repository overview */
+    overview: {
+        total_components: number;
+        total_custom_hooks: number;
+        likely_root_component: string | null;
+        stack: {
+            state_management: string | null;
+            routing: string | null;
+            ui_library: string | null;
+            form_library: string | null;
+            build_tool: string | null;
+        };
+    };
+    /** Critical pattern violations (XSS, Rule of Hooks, memory leaks) */
+    critical_issues: Array<{
+        pattern: string;
+        count: number;
+        severity: "critical" | "warning";
+    }>;
+    /** Top 5 most-used hooks across components */
+    top_hooks: Array<{
+        name: string;
+        count: number;
+    }>;
+    /** Suggested next queries for the agent to run */
+    suggested_queries: string[];
+}
+/**
+ * Day-1 onboarding composite for React projects. Single call that runs:
+ * - Component/hook inventory
+ * - Stack detection (state mgmt, routing, UI lib, form lib, build tool)
+ * - Critical pattern scan (XSS, Rule of Hooks, memory leaks)
+ * - Top hook usage summary
+ * - Suggested follow-up queries
+ *
+ * Meant to be the first tool a React developer runs on an unfamiliar codebase.
+ * Replaces 5-6 manual tool calls with one structured report.
+ */
+export declare function reactQuickstart(repo: string): Promise<ReactQuickstartResult>;
+//# sourceMappingURL=react-tools.d.ts.map

package/dist/tools/react-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-tools.d.ts","sourceRoot":"","sources":["../../src/tools/react-tools.ts"],"names":[],"mappings":"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"}