codesift-mcp 0.9.5 → 0.10.0

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

@@ -0,0 +1,59 @@
+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;
+        };
+    };
+    /**
+     * High-priority pattern hits for onboarding. Entries use `severity: "critical"` for
+     * XSS / Rule-of-Hooks / effect-loop issues. For **backward compatibility**, legacy
+     * scans that were pre–Tier 5 (`useEffect-missing-cleanup`, `rsc-non-serializable-prop`)
+     * remain in this array with `severity: "warning"` — do not assume the field name
+     * implies severity. Tier 5 warning-only patterns live in `warnings`; style bucket in `style_issues`.
+     */
+    critical_issues: Array<{
+        pattern: string;
+        count: number;
+        severity: "critical" | "warning";
+    }>;
+    /** Tier 5: warning-severity findings (derived-state, stale-closure, context value inline) */
+    warnings: Array<{
+        pattern: string;
+        count: number;
+        severity: "warning";
+    }>;
+    /** Tier 5: style-severity findings (button-no-type, jsx-no-target-blank) */
+    style_issues: Array<{
+        pattern: string;
+        count: number;
+        severity: "style";
+    }>;
+    /** 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-quickstart-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-quickstart-tools.d.ts","sourceRoot":"","sources":["../../src/tools/react-quickstart-tools.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,QAAQ,EAAE;QACR,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,KAAK,EAAE;YACL,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;YAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;YAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;YAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;SAC3B,CAAC;KACH,CAAC;IACF;;;;;;OAMG;IACH,eAAe,EAAE,KAAK,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;KAClC,CAAC,CAAC;IACH,6FAA6F;IAC7F,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,SAAS,CAAC;KACrB,CAAC,CAAC;IACH,4EAA4E;IAC5E,YAAY,EAAE,KAAK,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,8CAA8C;IAC9C,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,qBAAqB,CAAC,CAsJhC"}

package/dist/tools/react-quickstart-tools.js

@@ -0,0 +1,164 @@
+/**
+ * React day-1 onboarding composite.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { isTestFileStrict as isTestFile } from "../utils/test-file.js";
+/**
+ * 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 async function reactQuickstart(repo) {
+    const { searchPatterns } = await import("./pattern-tools.js");
+    const { analyzeProject } = await import("./project-tools.js");
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository not found: ${repo}`);
+    // Inventory
+    const components = index.symbols.filter((s) => s.kind === "component" && !isTestFile(s.file));
+    const hooks = index.symbols.filter((s) => s.kind === "hook" && !isTestFile(s.file));
+    // Find likely root component: prefer App > Root > Main > Layout > Page
+    const rootNames = ["App", "Root", "Main", "Layout", "Page"];
+    const likelyRoot = components.find((c) => rootNames.includes(c.name))?.name
+        ?? components[0]?.name
+        ?? null;
+    // Stack detection via analyze_project
+    let stack = {
+        state_management: null,
+        routing: null,
+        ui_library: null,
+        form_library: null,
+        build_tool: null,
+    };
+    try {
+        const proj = await analyzeProject(repo, { force: false });
+        const rc = proj?.conventions?.react_conventions;
+        const si = proj?.stack;
+        if (rc) {
+            stack = {
+                state_management: rc.state_management ?? null,
+                routing: rc.routing ?? null,
+                ui_library: rc.ui_library ?? null,
+                form_library: rc.form_library ?? null,
+                build_tool: si?.build_tool ?? null,
+            };
+        }
+        else if (si) {
+            stack.build_tool = si.build_tool ?? null;
+        }
+    }
+    catch {
+        // analyze_project may fail on non-React repos — fall through
+    }
+    // Critical pattern scans — run in parallel.
+    // Tier 5: scan list expanded with new patterns, results routed to severity-based buckets.
+    const scanList = [
+        { name: "dangerously-set-html", severity: "critical" },
+        { name: "hook-in-condition", severity: "critical" },
+        { name: "conditional-render-hook", severity: "critical" },
+        { name: "useEffect-missing-cleanup", severity: "warning" },
+        { name: "useEffect-setstate-loop", severity: "critical" },
+        { name: "rsc-non-serializable-prop", severity: "warning" },
+        // Tier 5 — warning bucket
+        { name: "derived-state", severity: "warning" },
+        { name: "stale-closure-setstate", severity: "warning" },
+        { name: "context-provider-value-inline", severity: "warning" },
+        // Tier 5 — warning (tabnabbing): surfaced in critical_issues with legacy warnings
+        { name: "jsx-no-target-blank", severity: "warning" },
+        { name: "button-no-type", severity: "style" },
+        // Tier 6 — extending Tier 5 coverage
+        { name: "derived-state-reducer", severity: "warning" },
+        { name: "derived-state-custom-setter", severity: "warning" },
+        { name: "stale-closure-toggle", severity: "warning" },
+        { name: "stale-closure-broken-functional", severity: "warning" },
+        { name: "context-provider-value-via-variable", severity: "warning" },
+        { name: "context-provider-value-inline-destructured", severity: "warning" },
+        { name: "react-lazy-no-suspense-same-file", severity: "style" },
+        { name: "rsc-non-serializable-prop-deep", severity: "critical" },
+        { name: "error-boundary-incomplete", severity: "warning" },
+    ];
+    const scanResults = await Promise.all(scanList.map(async ({ name, severity }) => {
+        try {
+            const result = await searchPatterns(repo, name, { max_results: 20 });
+            return { pattern: name, count: result.matches.length, severity };
+        }
+        catch {
+            return { pattern: name, count: 0, severity };
+        }
+    }));
+    // Severity-aware bucketing — cap each at 10 entries.
+    const hits = scanResults.filter((r) => r.count > 0);
+    const critical_issues = hits
+        .filter((r) => r.severity === "critical")
+        .slice(0, 10);
+    // Legacy: pre-Tier-5 patterns marked "warning" stay in critical_issues for backward compat;
+    // Tier 5 warnings (derived-state, stale-closure, context-provider) go to dedicated bucket.
+    const tier5WarningPatterns = new Set([
+        // Tier 5
+        "derived-state", "stale-closure-setstate", "context-provider-value-inline",
+        // Tier 6 — same warning bucket
+        "derived-state-reducer", "derived-state-custom-setter",
+        "stale-closure-toggle", "stale-closure-broken-functional",
+        "context-provider-value-via-variable", "context-provider-value-inline-destructured",
+        "error-boundary-incomplete",
+    ]);
+    for (const r of hits) {
+        if (r.severity === "warning" && !tier5WarningPatterns.has(r.pattern) && critical_issues.length < 10) {
+            critical_issues.push({ pattern: r.pattern, count: r.count, severity: "warning" });
+        }
+    }
+    const warnings = hits
+        .filter((r) => r.severity === "warning" && tier5WarningPatterns.has(r.pattern))
+        .slice(0, 10);
+    const style_issues = hits
+        .filter((r) => r.severity === "style")
+        .slice(0, 10);
+    // Top hooks used across components
+    const hookCounts = new Map();
+    for (const c of components) {
+        if (!c.source)
+            continue;
+        const matches = c.source.matchAll(/\b(use[A-Z]\w*)\s*\(/g);
+        for (const m of matches) {
+            const name = m[1];
+            hookCounts.set(name, (hookCounts.get(name) ?? 0) + 1);
+        }
+    }
+    const top_hooks = [...hookCounts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([name, count]) => ({ name, count }));
+    // Suggested next queries
+    const suggested_queries = [];
+    if (likelyRoot) {
+        suggested_queries.push(`trace_component_tree("${likelyRoot}")  // explore render hierarchy`);
+    }
+    suggested_queries.push(`analyze_renders()  // find re-render risks`);
+    suggested_queries.push(`analyze_hooks()  // Rule of Hooks + hook inventory`);
+    if (components.length >= 10) {
+        suggested_queries.push(`audit_compiler_readiness()  // React Compiler adoption check`);
+    }
+    if (critical_issues.some((i) => i.severity === "critical")) {
+        suggested_queries.push(`search_patterns("dangerously-set-html")  // investigate XSS risks`);
+    }
+    return {
+        overview: {
+            total_components: components.length,
+            total_custom_hooks: hooks.length,
+            likely_root_component: likelyRoot,
+            stack,
+        },
+        critical_issues,
+        warnings,
+        style_issues,
+        top_hooks,
+        suggested_queries,
+    };
+}
+//# sourceMappingURL=react-quickstart-tools.js.map

package/dist/tools/react-quickstart-tools.js.map

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

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

@@ -0,0 +1,75 @@
+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;
+    /**
+     * JSX **render-tree** depth: longest path in edges from this component up to a
+     * root in the reverse adjacency. Same numeric value as `prop_chain_depth`;
+     * this name reflects semantics (not prop-drilling depth). `null` only when
+     * `metadata.skipped === "extractor-failure"`.
+     */
+    jsx_render_depth: number | null;
+    /**
+     * @deprecated Use `jsx_render_depth`. Same value — retained for backward compatibility.
+     * Render-tree depth, not prop-flow depth.
+     */
+    prop_chain_depth: number | null;
+    /** Suggestion text including "NOT prop-drilling depth" disclaimer when depth >= 3 */
+    suggestion?: string;
+}
+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;
+    };
+    /** Diagnostic metadata — see `analyzeRenders` implementation for when this is set. */
+    metadata?: {
+        skipped?: "extractor-failure";
+    };
+}
+/**
+ * Analyze a single component source for re-render risks.
+ */
+declare function findRenderRisks(source: string): RenderRisk[];
+/**
+ * Format an AnalyzeRendersResult as human-readable Markdown.
+ * Used by analyzeRenders when format="markdown" is requested.
+ */
+export declare function formatRendersMarkdown(result: AnalyzeRendersResult): string;
+/**
+ * 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.
+ */
+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 { findRenderRisks };
+//# sourceMappingURL=react-render-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-render-tools.d.ts","sourceRoot":"","sources":["../../src/tools/react-render-tools.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,cAAc,CAAC;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,sFAAsF;IACtF,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;CAC9C;AAUD;;GAEG;AACH,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CA2DrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAwB1E;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CAC1C,GACA,OAAO,CAAC,oBAAoB,GAAG,MAAM,CAAC,CAwIxC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/tools/react-render-tools.js

@@ -0,0 +1,234 @@
+/**
+ * React static render-risk analysis.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { isTestFileStrict as isTestFile } from "../utils/test-file.js";
+import { buildJsxAdjacency, buildReverseAdjacency, computePropChainDepth } from "./react-component-tree-tools.js";
+/** Patterns for inline prop creation in JSX — each creates a new reference every render */
+const INLINE_OBJECT_RE = /\b\w+\s*=\s*\{\s*\{/g; // prop={{ ... }}
+const INLINE_ARRAY_RE = /\b\w+\s*=\s*\{\s*\[/g; // prop={[ ... ]}
+const INLINE_FN_RE = /\bon[A-Z]\w*\s*=\s*\{\s*(?:\([^)]*\)|[a-z_$][\w$]*)\s*=>/g; // onX={() => ...}
+/** Default prop values that create new references: = [] or = {} in params */
+const UNSTABLE_DEFAULT_RE = /(?:[:,]\s*)(\w+)\s*=\s*(\[\s*\]|\{\s*\})/g;
+/**
+ * Analyze a single component source for re-render risks.
+ */
+function findRenderRisks(source) {
+    const risks = [];
+    const lines = source.split("\n");
+    for (let i = 0; i < lines.length && risks.length < 20; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        const trimmed = line.trim();
+        // Skip comments
+        if (trimmed.startsWith("//") || trimmed.startsWith("*"))
+            continue;
+        // Inline object prop: prop={{ key: val }}
+        if (INLINE_OBJECT_RE.test(line)) {
+            INLINE_OBJECT_RE.lastIndex = 0;
+            risks.push({
+                type: "inline-object",
+                line: lineNum,
+                context: trimmed.slice(0, 120),
+                suggestion: "Extract to a const or useMemo — object literal creates new reference every render",
+            });
+        }
+        // Inline array prop: prop={[1, 2, 3]}
+        if (INLINE_ARRAY_RE.test(line)) {
+            INLINE_ARRAY_RE.lastIndex = 0;
+            risks.push({
+                type: "inline-array",
+                line: lineNum,
+                context: trimmed.slice(0, 120),
+                suggestion: "Extract to a const or useMemo — array literal creates new reference every render",
+            });
+        }
+        // Inline function in event handler: onClick={() => ...}
+        if (INLINE_FN_RE.test(line)) {
+            INLINE_FN_RE.lastIndex = 0;
+            risks.push({
+                type: "inline-function",
+                line: lineNum,
+                context: trimmed.slice(0, 120),
+                suggestion: "Extract to useCallback or a named handler — arrow function creates new reference every render",
+            });
+        }
+        // Unstable default value: { items = [], config = {} }
+        UNSTABLE_DEFAULT_RE.lastIndex = 0;
+        let dm;
+        while ((dm = UNSTABLE_DEFAULT_RE.exec(line)) !== null && risks.length < 20) {
+            risks.push({
+                type: "unstable-default",
+                line: lineNum,
+                context: trimmed.slice(0, 120),
+                suggestion: `Default value \`${dm[1]} = ${dm[2]}\` creates new reference every render — hoist to module const`,
+            });
+        }
+    }
+    return risks;
+}
+/**
+ * Format an AnalyzeRendersResult as human-readable Markdown.
+ * Used by analyzeRenders when format="markdown" is requested.
+ */
+export function formatRendersMarkdown(result) {
+    const lines = [];
+    lines.push("# Render Analysis");
+    lines.push("");
+    lines.push(`Total components: ${result.total_components} | High risk: ${result.high_risk_count}`);
+    lines.push("");
+    lines.push("## Summary");
+    lines.push(`- inline_objects: ${result.summary.inline_objects}`);
+    lines.push(`- inline_arrays: ${result.summary.inline_arrays}`);
+    lines.push(`- inline_functions: ${result.summary.inline_functions}`);
+    lines.push(`- unstable_defaults: ${result.summary.unstable_defaults}`);
+    lines.push(`- missing_memo: ${result.summary.missing_memo}`);
+    lines.push("");
+    lines.push("## Entries");
+    lines.push("");
+    lines.push("| Component | File | Risk | Issues | Children | Chain | Memo |");
+    lines.push("|-----------|------|------|--------|----------|-------|------|");
+    for (const e of result.entries) {
+        const file = e.file.length > 40 ? "…" + e.file.slice(-39) : e.file;
+        const chain = e.jsx_render_depth === null ? "—" : String(e.jsx_render_depth);
+        lines.push(`| ${e.name} | ${file}:${e.start_line} | ${e.risk_level} | ${e.risk_count} | ${e.children_count} | ${chain} | ${e.is_memoized ? "✓" : "✗"} |`);
+    }
+    return lines.join("\n");
+}
+/**
+ * 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.
+ */
+export async function analyzeRenders(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    const componentName = options?.component_name;
+    const filePattern = options?.file_pattern;
+    const includeTests = options?.include_tests ?? false;
+    const maxEntries = options?.max_entries ?? 100;
+    let components = index.symbols.filter((s) => s.kind === "component");
+    if (!includeTests)
+        components = components.filter((s) => !isTestFile(s.file));
+    if (componentName)
+        components = components.filter((s) => s.name === componentName);
+    if (filePattern)
+        components = components.filter((s) => s.file.includes(filePattern));
+    // Tier 5 — extractor-failure: only when we have indexed JSX files but zero
+    // component symbols while other symbols exist — likely classification/extractor
+    // issues. Pure `.ts`/non-JSX indexes are not flagged (avoids false positives on
+    // headless/util libraries).
+    const hasJsxIndexedFiles = index.files.some((f) => f.path.endsWith(".tsx") || f.path.endsWith(".jsx"));
+    const extractorFailure = components.length === 0 &&
+        index.symbols.length > 0 &&
+        hasJsxIndexedFiles;
+    // Tier 5 — sort components alphabetically by id ?? name BEFORE building adjacency
+    // for deterministic cycle handling.
+    const sortedComponents = [...components].sort((a, b) => (a.id ?? a.name).localeCompare(b.id ?? b.name));
+    // Build reverse adjacency once, share memo across all per-component calls (O(V+E) total).
+    const adjacency = buildJsxAdjacency(sortedComponents);
+    const reverseAdj = buildReverseAdjacency(adjacency);
+    const memo = new Map();
+    const inProgress = new Set();
+    const entries = [];
+    const summary = { inline_objects: 0, inline_arrays: 0, inline_functions: 0, unstable_defaults: 0, missing_memo: 0 };
+    let highRiskCount = 0;
+    for (const sym of sortedComponents) {
+        if (entries.length >= maxEntries)
+            break;
+        if (!sym.source)
+            continue;
+        const isMemoized = /\b(?:React\.)?memo\s*\(/.test(sym.source);
+        const risks = findRenderRisks(sym.source);
+        // Count children rendered (PascalCase JSX elements)
+        const childrenSet = new Set();
+        const jsxPattern = /<([A-Z][a-zA-Z0-9_$]*)\b/g;
+        let jm;
+        while ((jm = jsxPattern.exec(sym.source)) !== null) {
+            if (jm[1] !== sym.name)
+                childrenSet.add(jm[1]);
+        }
+        // Check missing-memo: component renders children and is not memoized
+        if (!isMemoized && childrenSet.size > 0 && risks.length > 0) {
+            risks.push({
+                type: "missing-memo",
+                line: 1,
+                context: `${sym.name} renders ${childrenSet.size} child component(s) and has ${risks.length} inline props`,
+                suggestion: "Wrap in React.memo() — parent re-renders will propagate to children via new prop references",
+            });
+            summary.missing_memo++;
+        }
+        // Aggregate summary counts
+        for (const r of risks) {
+            if (r.type === "inline-object")
+                summary.inline_objects++;
+            else if (r.type === "inline-array")
+                summary.inline_arrays++;
+            else if (r.type === "inline-function")
+                summary.inline_functions++;
+            else if (r.type === "unstable-default")
+                summary.unstable_defaults++;
+        }
+        // Risk level classification — factors children_count to amplify components
+        // that propagate prop instability to many children (Bug #4 fix).
+        const riskLevel = ((risks.length >= 3 && childrenSet.size >= 3) || risks.length >= 5) ? "high" :
+            (risks.length >= 2 || (risks.length >= 1 && childrenSet.size >= 1)) ? "medium" : "low";
+        if (riskLevel === "high")
+            highRiskCount++;
+        // Tier 5 — render-tree depth (longest acyclic path from this component up to a root).
+        // `reverseAdj` is keyed by `sym.id` exclusively (see line 130), so any fallback to
+        // sym.name would silently look up a non-existent key. CodeSymbol.id is required by
+        // the type contract — dropping the prior `?? sym.name` fallback that masked unset id.
+        const depth = computePropChainDepth(sym.id, reverseAdj, memo, inProgress);
+        // Tier 5 — suggestion text with explicit "NOT prop-drilling depth" disclaimer
+        // when depth >= 3 (AC 8: prevents the metric from being silently relabeled
+        // as semantic prop-flow depth, which is Tier 6 scope).
+        const suggestion = depth >= 3
+            ? `Component is rendered ${depth} edges deep in the JSX render tree. NOT prop-drilling depth — this metric measures render-tree depth only, without tracing which props are consumed vs passed through. Use as a hint to investigate; combine with manual review or trace_component_tree to confirm whether props are actually being drilled. Semantic prop-flow tracking is Tier 6 scope.`
+            : undefined;
+        // Only include components with risks or if specifically queried
+        if (risks.length > 0 || componentName) {
+            entries.push({
+                name: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                is_memoized: isMemoized,
+                risk_count: risks.length,
+                risk_level: riskLevel,
+                risks,
+                children_count: childrenSet.size,
+                jsx_render_depth: extractorFailure ? null : depth,
+                prop_chain_depth: extractorFailure ? null : depth,
+                ...(suggestion ? { suggestion } : {}),
+            });
+        }
+    }
+    // Sort: high risk first, then by risk_count descending
+    entries.sort((a, b) => {
+        const levelOrder = { high: 3, medium: 2, low: 1 };
+        const ld = levelOrder[b.risk_level] - levelOrder[a.risk_level];
+        if (ld !== 0)
+            return ld;
+        return b.risk_count - a.risk_count;
+    });
+    const jsonResult = {
+        entries,
+        total_components: components.length,
+        high_risk_count: highRiskCount,
+        summary,
+        ...(extractorFailure ? { metadata: { skipped: "extractor-failure" } } : {}),
+    };
+    if (options?.format === "markdown") {
+        return formatRendersMarkdown(jsonResult);
+    }
+    return jsonResult;
+}
+export { findRenderRisks };
+//# sourceMappingURL=react-render-tools.js.map

package/dist/tools/react-render-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-render-tools.js","sourceRoot":"","sources":["../../src/tools/react-render-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAsDlH,2FAA2F;AAC3F,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,CAAO,iBAAiB;AACxE,MAAM,eAAe,GAAG,sBAAsB,CAAC,CAAS,iBAAiB;AACzE,MAAM,YAAY,GAAG,2DAA2D,CAAC,CAAC,kBAAkB;AAEpG,6EAA6E;AAC7E,MAAM,mBAAmB,GAAG,2CAA2C,CAAC;AAExE;;GAEG;AACH,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,gBAAgB;QAChB,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElE,0CAA0C;QAC1C,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC9B,UAAU,EAAE,mFAAmF;aAChG,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,eAAe,CAAC,SAAS,GAAG,CAAC,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC9B,UAAU,EAAE,kFAAkF;aAC/F,CAAC,CAAC;QACL,CAAC;QAED,wDAAwD;QACxD,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC9B,UAAU,EAAE,+FAA+F;aAC5G,CAAC,CAAC;QACL,CAAC;QAED,sDAAsD;QACtD,mBAAmB,CAAC,SAAS,GAAG,CAAC,CAAC;QAClC,IAAI,EAA0B,CAAC;QAC/B,OAAO,CAAC,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC3E,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC9B,UAAU,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,+DAA+D;aAC/G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA4B;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,gBAAgB,iBAAiB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAClG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,MAAM,KAAK,GACT,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,IAAI,IAAI,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,cAAc,MAAM,KAAK,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5J,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,OAMC;IAED,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,EAAE,cAAc,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,EAAE,YAAY,CAAC;IAC1C,MAAM,YAAY,GAAG,OAAO,EAAE,aAAa,IAAI,KAAK,CAAC;IACrD,MAAM,UAAU,GAAG,OAAO,EAAE,WAAW,IAAI,GAAG,CAAC;IAE/C,IAAI,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IACrE,IAAI,CAAC,YAAY;QAAE,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,IAAI,aAAa;QAAE,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IACnF,IAAI,WAAW;QAAE,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAErF,2EAA2E;IAC3E,gFAAgF;IAChF,gFAAgF;IAChF,4BAA4B;IAC5B,MAAM,kBAAkB,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC1D,CAAC;IACF,MAAM,gBAAgB,GACpB,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACxB,kBAAkB,CAAC;IAErB,kFAAkF;IAClF,oCAAoC;IACpC,MAAM,gBAAgB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrD,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAC/C,CAAC;IACF,0FAA0F;IAC1F,MAAM,SAAS,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACpH,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;YAAE,MAAM;QACxC,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,SAAS;QAE1B,MAAM,UAAU,GAAG,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE1C,oDAAoD;QACpD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,MAAM,UAAU,GAAG,2BAA2B,CAAC;QAC/C,IAAI,EAA0B,CAAC;QAC/B,OAAO,CAAC,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI;gBAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;QAClD,CAAC;QAED,qEAAqE;QACrE,IAAI,CAAC,UAAU,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,YAAY,WAAW,CAAC,IAAI,+BAA+B,KAAK,CAAC,MAAM,eAAe;gBAC1G,UAAU,EAAE,6FAA6F;aAC1G,CAAC,CAAC;YACH,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,CAAC;QAED,2BAA2B;QAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe;gBAAE,OAAO,CAAC,cAAc,EAAE,CAAC;iBACpD,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc;gBAAE,OAAO,CAAC,aAAa,EAAE,CAAC;iBACvD,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB;gBAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;iBAC7D,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB;gBAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;QACtE,CAAC;QAED,2EAA2E;QAC3E,iEAAiE;QACjE,MAAM,SAAS,GACb,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC9E,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;QAEzF,IAAI,SAAS,KAAK,MAAM;YAAE,aAAa,EAAE,CAAC;QAE1C,sFAAsF;QACtF,mFAAmF;QACnF,mFAAmF;QACnF,sFAAsF;QACtF,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAE1E,8EAA8E;QAC9E,2EAA2E;QAC3E,uDAAuD;QACvD,MAAM,UAAU,GAAG,KAAK,IAAI,CAAC;YAC3B,CAAC,CAAC,yBAAyB,KAAK,2VAA2V;YAC3X,CAAC,CAAC,SAAS,CAAC;QAEd,gEAAgE;QAChE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,WAAW,EAAE,UAAU;gBACvB,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,UAAU,EAAE,SAAS;gBACrB,KAAK;gBACL,cAAc,EAAE,WAAW,CAAC,IAAI;gBAChC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;gBACjD,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;gBACjD,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAyB;QACvC,OAAO;QACP,gBAAgB,EAAE,UAAU,CAAC,MAAM;QACnC,eAAe,EAAE,aAAa;QAC9B,OAAO;QACP,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,mBAA4B,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrF,CAAC;IAEF,IAAI,OAAO,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Shared React-specific constants used across React analysis tools.
+ */
+export declare const REACT_STDLIB_HOOKS: Set<string>;
+//# sourceMappingURL=react-shared-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-shared-tools.d.ts","sourceRoot":"","sources":["../../src/tools/react-shared-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,kBAAkB,aAM7B,CAAC"}

package/dist/tools/react-shared-tools.js

@@ -0,0 +1,12 @@
+/**
+ * Shared React-specific constants used across React analysis tools.
+ */
+// ── React stdlib hooks (used as denylist in tracing and inventory) ──
+export const REACT_STDLIB_HOOKS = new Set([
+    "useState", "useEffect", "useCallback", "useMemo", "useRef",
+    "useContext", "useReducer", "useLayoutEffect", "useImperativeHandle",
+    "useDebugValue", "useDeferredValue", "useTransition", "useId",
+    "useSyncExternalStore", "useInsertionEffect", "useOptimistic",
+    "useFormState", "useFormStatus", "use",
+]);
+//# sourceMappingURL=react-shared-tools.js.map

package/dist/tools/react-shared-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-shared-tools.js","sourceRoot":"","sources":["../../src/tools/react-shared-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ;IAC3D,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB;IACpE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,OAAO;IAC7D,sBAAsB,EAAE,oBAAoB,EAAE,eAAe;IAC7D,cAAc,EAAE,eAAe,EAAE,KAAK;CACvC,CAAC,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * React Suspense and lazy component analysis helpers.
+ */
+import type { CodeSymbol } from "../types.js";
+/**
+ * Walk UP the JSX render tree from a component, looking for any ancestor whose
+ * source contains a Suspense boundary. Returns the first ancestor found, or
+ * null if no Suspense exists anywhere in the upward chain.
+ *
+ * Tier 7 — closes the cross-file FP in `react-lazy-no-suspense-same-file` regex
+ * (Tier 6 limitation). Reuses `buildReverseAdjacency` infrastructure from Tier 5.
+ * Cycle-safe via visited set (BFS on potentially cyclic graph).
+ */
+export declare function findSuspenseAncestor(componentId: string, reverseAdjacency: Map<string, string[]>, symbolsById: Map<string, CodeSymbol>): {
+    name: string;
+    file: string;
+} | null;
+/**
+ * Find all React.lazy() / lazy() usages whose containing component lacks a
+ * Suspense boundary anywhere in its ancestor chain. Cross-file proper detection.
+ * Tier 7 — complements the single-file regex `react-lazy-no-suspense-same-file`.
+ */
+export interface LazyWithoutSuspense {
+    name: string;
+    file: string;
+    start_line: number;
+}
+export declare function findLazyComponentsWithoutSuspense(symbols: CodeSymbol[]): LazyWithoutSuspense[];
+//# sourceMappingURL=react-suspense-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-suspense-tools.d.ts","sourceRoot":"","sources":["../../src/tools/react-suspense-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAsH9C;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBvC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,UAAU,EAAE,GACpB,mBAAmB,EAAE,CAmDvB"}