phantom-pr 0.4.19 → 0.5.1

package/dist/core/analysis/astExtractor.js

@@ -0,0 +1,354 @@
+/**
+ * AST extractor that analyzes React/TypeScript component files.
+ * Uses TypeScript's built-in compiler API (no external parser dependency).
+ *
+ * Pure function: parse file → return ComponentAnalysis.
+ * Handles parse errors gracefully (returns partial analysis, doesn't throw).
+ */
+import ts from 'typescript';
+import { emptyAnalysis } from './types.js';
+/**
+ * Extract component analysis from a React/TypeScript file.
+ * @param filePath - Path to the file (for reference in output)
+ * @param fileContent - Source code content
+ * @returns ComponentAnalysis with extracted structure info
+ */
+export function extractComponentAnalysis(filePath, fileContent) {
+    try {
+        const sourceFile = ts.createSourceFile(filePath, fileContent, ts.ScriptTarget.Latest, true, // setParentNodes
+        filePath.endsWith('.tsx') || filePath.endsWith('.jsx')
+            ? ts.ScriptKind.TSX
+            : ts.ScriptKind.TS);
+        const imports = extractImports(sourceFile);
+        const branches = extractBranches(sourceFile);
+        const effects = extractEffects(sourceFile);
+        const children = extractChildren(sourceFile, imports);
+        const externalCalls = extractExternalCalls(sourceFile, imports);
+        const props = extractProps(sourceFile);
+        return {
+            filePath,
+            branches,
+            effects,
+            children,
+            externalCalls,
+            props,
+        };
+    }
+    catch {
+        // Parse errors → return empty analysis (fail-closed, no throw)
+        return emptyAnalysis(filePath);
+    }
+}
+/** Extract import map: identifier → module path */
+function extractImports(sourceFile) {
+    const imports = new Map();
+    ts.forEachChild(sourceFile, (node) => {
+        if (ts.isImportDeclaration(node) && node.moduleSpecifier) {
+            const modulePath = node.moduleSpecifier.text;
+            const clause = node.importClause;
+            if (clause) {
+                // Default import
+                if (clause.name) {
+                    imports.set(clause.name.text, modulePath);
+                }
+                // Named imports
+                if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+                    for (const el of clause.namedBindings.elements) {
+                        imports.set(el.name.text, modulePath);
+                    }
+                }
+                // Namespace import
+                if (clause.namedBindings && ts.isNamespaceImport(clause.namedBindings)) {
+                    imports.set(clause.namedBindings.name.text, modulePath);
+                }
+            }
+        }
+    });
+    return imports;
+}
+/** Extract conditional branches (if, ternary, switch, logical operators) */
+function extractBranches(sourceFile) {
+    const branches = [];
+    function visit(node) {
+        const line = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+        // if statement
+        if (ts.isIfStatement(node)) {
+            branches.push({
+                line,
+                condition: node.expression.getText(sourceFile),
+                paths: 2,
+                kind: 'if',
+            });
+        }
+        // ternary expression
+        if (ts.isConditionalExpression(node)) {
+            branches.push({
+                line,
+                condition: node.condition.getText(sourceFile),
+                paths: 2,
+                kind: 'ternary',
+            });
+        }
+        // switch statement
+        if (ts.isSwitchStatement(node)) {
+            const caseCount = node.caseBlock.clauses.length;
+            branches.push({
+                line,
+                condition: node.expression.getText(sourceFile),
+                paths: caseCount,
+                kind: 'switch',
+            });
+        }
+        // logical operators (&& / ||) used for short-circuit rendering
+        if (ts.isBinaryExpression(node)) {
+            if (node.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken ||
+                node.operatorToken.kind === ts.SyntaxKind.BarBarToken) {
+                // Only count as branch if it looks like JSX short-circuit: `cond && <Element />`
+                if (ts.isJsxElement(node.right) || ts.isJsxSelfClosingElement(node.right) || ts.isJsxFragment(node.right)) {
+                    branches.push({
+                        line,
+                        condition: node.left.getText(sourceFile),
+                        paths: 2,
+                        kind: 'logical',
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return branches;
+}
+/** Extract React effect hooks (useEffect, useLayoutEffect, useMemo, useCallback) */
+function extractEffects(sourceFile) {
+    const effects = [];
+    const effectHooks = new Set(['useEffect', 'useLayoutEffect', 'useMemo', 'useCallback']);
+    function visit(node) {
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            let hookName = null;
+            // Direct call: useEffect(...)
+            if (ts.isIdentifier(callee) && effectHooks.has(callee.text)) {
+                hookName = callee.text;
+            }
+            // Property access: React.useEffect(...)
+            if (ts.isPropertyAccessExpression(callee) && ts.isIdentifier(callee.name) && effectHooks.has(callee.name.text)) {
+                hookName = callee.name.text;
+            }
+            if (hookName) {
+                const line = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+                const deps = extractDependencies(node);
+                const hasCleanup = checkForCleanup(node);
+                effects.push({
+                    line,
+                    dependencies: deps,
+                    hasCleanup,
+                    kind: hookName,
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return effects;
+}
+/** Extract dependency array items from effect call */
+function extractDependencies(callExpr) {
+    // Second argument is typically the dependency array
+    const depsArg = callExpr.arguments[1];
+    if (!depsArg || !ts.isArrayLiteralExpression(depsArg)) {
+        return [];
+    }
+    return depsArg.elements.map((el) => el.getText()).filter(Boolean);
+}
+/** Check if effect callback has a cleanup function (return statement) */
+function checkForCleanup(callExpr) {
+    const callback = callExpr.arguments[0];
+    if (!callback)
+        return false;
+    // Arrow function or function expression
+    if (ts.isArrowFunction(callback) || ts.isFunctionExpression(callback)) {
+        // Check for return statement in body
+        if (ts.isBlock(callback.body)) {
+            return callback.body.statements.some((stmt) => ts.isReturnStatement(stmt) && stmt.expression !== undefined);
+        }
+        // Concise arrow: () => cleanup (returns the cleanup directly)
+        // This is unusual for useEffect but technically valid
+        return false;
+    }
+    return false;
+}
+/** Extract child components rendered in JSX */
+function extractChildren(sourceFile, imports) {
+    const children = [];
+    const seen = new Set();
+    function isInsideConditional(node) {
+        let current = node.parent;
+        while (current) {
+            if (ts.isIfStatement(current) || ts.isConditionalExpression(current)) {
+                return true;
+            }
+            if (ts.isBinaryExpression(current)) {
+                if (current.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken ||
+                    current.operatorToken.kind === ts.SyntaxKind.BarBarToken) {
+                    return true;
+                }
+            }
+            current = current.parent;
+        }
+        return false;
+    }
+    function visit(node) {
+        let componentName = null;
+        let line = 0;
+        // <ComponentName /> or <ComponentName>...</ComponentName>
+        if (ts.isJsxSelfClosingElement(node)) {
+            const tagName = node.tagName;
+            if (ts.isIdentifier(tagName) && isUpperCase(tagName.text[0])) {
+                componentName = tagName.text;
+                line = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+            }
+        }
+        if (ts.isJsxOpeningElement(node)) {
+            const tagName = node.tagName;
+            if (ts.isIdentifier(tagName) && isUpperCase(tagName.text[0])) {
+                componentName = tagName.text;
+                line = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+            }
+        }
+        if (componentName && !seen.has(componentName)) {
+            seen.add(componentName);
+            const importPath = imports.get(componentName) ?? 'unknown';
+            children.push({
+                name: componentName,
+                importPath,
+                line,
+                isConditional: isInsideConditional(node),
+            });
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return children;
+}
+/** Extract external function calls (from imported modules) */
+function extractExternalCalls(sourceFile, imports) {
+    const calls = [];
+    const seen = new Set();
+    function visit(node) {
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            let moduleName = null;
+            let methodName = null;
+            // Direct imported call: fetchData(...)
+            if (ts.isIdentifier(callee) && imports.has(callee.text)) {
+                moduleName = imports.get(callee.text) ?? null;
+                methodName = callee.text;
+            }
+            // Property access: api.fetchData(...)
+            if (ts.isPropertyAccessExpression(callee)) {
+                const obj = callee.expression;
+                if (ts.isIdentifier(obj) && imports.has(obj.text)) {
+                    moduleName = imports.get(obj.text) ?? null;
+                    methodName = callee.name.text;
+                }
+            }
+            if (moduleName && methodName) {
+                const key = `${moduleName}:${methodName}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    const line = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+                    const args = node.arguments.map((arg) => extractArgPattern(arg));
+                    calls.push({
+                        module: moduleName,
+                        method: methodName,
+                        line,
+                        arguments: args,
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return calls;
+}
+/** Extract a simplified pattern from an argument */
+function extractArgPattern(arg) {
+    if (ts.isIdentifier(arg)) {
+        return arg.text;
+    }
+    if (ts.isStringLiteral(arg)) {
+        return `"${arg.text}"`;
+    }
+    if (ts.isNumericLiteral(arg)) {
+        return arg.text;
+    }
+    if (ts.isObjectLiteralExpression(arg)) {
+        return '{...}';
+    }
+    if (ts.isArrayLiteralExpression(arg)) {
+        return '[...]';
+    }
+    return '?';
+}
+/** Extract component props from function parameters or type annotations */
+function extractProps(sourceFile) {
+    const props = [];
+    function visit(node) {
+        // Function component: function Foo(props: { name: string }) or function Foo({ name }: Props)
+        if (ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node)) {
+            const firstParam = node.parameters[0];
+            if (firstParam) {
+                extractPropsFromParam(firstParam, props, sourceFile);
+            }
+        }
+        // Arrow function: const Foo = (props: Props) => ...
+        if (ts.isVariableDeclaration(node) && node.initializer && ts.isArrowFunction(node.initializer)) {
+            const firstParam = node.initializer.parameters[0];
+            if (firstParam) {
+                extractPropsFromParam(firstParam, props, sourceFile);
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return props;
+}
+/** Extract prop info from a function parameter */
+function extractPropsFromParam(param, props, sourceFile) {
+    // Destructured props: ({ name, age = 0 }: Props)
+    if (ts.isObjectBindingPattern(param.name)) {
+        for (const element of param.name.elements) {
+            if (ts.isBindingElement(element) && ts.isIdentifier(element.name)) {
+                const defaultVal = element.initializer?.getText(sourceFile);
+                const prop = {
+                    name: element.name.text,
+                    type: element.dotDotDotToken ? 'rest' : 'unknown',
+                    required: element.initializer === undefined,
+                };
+                if (defaultVal !== undefined) {
+                    prop.defaultValue = defaultVal;
+                }
+                props.push(prop);
+            }
+        }
+        return;
+    }
+    // Type annotation on props param: (props: { name: string })
+    if (param.type && ts.isTypeLiteralNode(param.type)) {
+        for (const member of param.type.members) {
+            if (ts.isPropertySignature(member) && member.name && ts.isIdentifier(member.name)) {
+                props.push({
+                    name: member.name.text,
+                    type: member.type?.getText(sourceFile) ?? 'unknown',
+                    required: member.questionToken === undefined,
+                });
+            }
+        }
+    }
+}
+function isUpperCase(char) {
+    return char !== undefined && char === char.toUpperCase() && char !== char.toLowerCase();
+}
+//# sourceMappingURL=astExtractor.js.map

package/dist/core/analysis/astExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astExtractor.js","sourceRoot":"","sources":["../../../src/core/analysis/astExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAS5B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CACpC,QAAQ,EACR,WAAW,EACX,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EAAE,iBAAiB;QACvB,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpD,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG;YACnB,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CACrB,CAAC;QAEF,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QAEvC,OAAO;YACL,QAAQ;YACR,QAAQ;YACR,OAAO;YACP,QAAQ;YACR,aAAa;YACb,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;QAC/D,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,SAAS,cAAc,CAAC,UAAyB;IAC/C,MAAM,OAAO,GAAc,IAAI,GAAG,EAAE,CAAC;IAErC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;QACnC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzD,MAAM,UAAU,GAAI,IAAI,CAAC,eAAoC,CAAC,IAAI,CAAC;YACnE,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC;YACjC,IAAI,MAAM,EAAE,CAAC;gBACX,iBAAiB;gBACjB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC5C,CAAC;gBACD,gBAAgB;gBAChB,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;oBACpE,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;wBAC/C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACxC,CAAC;gBACH,CAAC;gBACD,mBAAmB;gBACnB,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;oBACvE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4EAA4E;AAC5E,SAAS,eAAe,CAAC,UAAyB;IAChD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,SAAS,KAAK,CAAC,IAAa;QAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAEhF,eAAe;QACf,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC9C,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;QACL,CAAC;QAED,qBAAqB;QACrB,IAAI,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC7C,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;QACL,CAAC;QAED,mBAAmB;QACnB,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC9C,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;QAED,+DAA+D;QAC/D,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,IACE,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,uBAAuB;gBACjE,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,EACrD,CAAC;gBACD,iFAAiF;gBACjF,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1G,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI;wBACJ,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;wBACxC,KAAK,EAAE,CAAC;wBACR,IAAI,EAAE,SAAS;qBAChB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oFAAoF;AACpF,SAAS,cAAc,CAAC,UAAyB;IAC/C,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAExF,SAAS,KAAK,CAAC,IAAa;QAC1B,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;YAC/B,IAAI,QAAQ,GAAkB,IAAI,CAAC;YAEnC,8BAA8B;YAC9B,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5D,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,CAAC;YACD,wCAAwC;YACxC,IAAI,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/G,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBAChF,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;gBAEzC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,YAAY,EAAE,IAAI;oBAClB,UAAU;oBACV,IAAI,EAAE,QAA8B;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sDAAsD;AACtD,SAAS,mBAAmB,CAAC,QAA2B;IACtD,oDAAoD;IACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,yEAAyE;AACzE,SAAS,eAAe,CAAC,QAA2B;IAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,wCAAwC;IACxC,IAAI,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtE,qCAAqC;QACrC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAClC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CACtE,CAAC;QACJ,CAAC;QACD,8DAA8D;QAC9D,sDAAsD;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+CAA+C;AAC/C,SAAS,eAAe,CAAC,UAAyB,EAAE,OAAkB;IACpE,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,SAAS,mBAAmB,CAAC,IAAa;QACxC,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,OAAO,OAAO,EAAE,CAAC;YACf,IAAI,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,IACE,OAAO,CAAC,aAAa,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,uBAAuB;oBACpE,OAAO,CAAC,aAAa,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,EACxD,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,KAAK,CAAC,IAAa;QAC1B,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,0DAA0D;QAC1D,IAAI,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;gBAC7B,IAAI,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;gBAC7B,IAAI,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACxB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,SAAS,CAAC;YAC3D,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,aAAa;gBACnB,UAAU;gBACV,IAAI;gBACJ,aAAa,EAAE,mBAAmB,CAAC,IAAI,CAAC;aACzC,CAAC,CAAC;QACL,CAAC;QAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,SAAS,oBAAoB,CAAC,UAAyB,EAAE,OAAkB;IACzE,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,SAAS,KAAK,CAAC,IAAa;QAC1B,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;YAC/B,IAAI,UAAU,GAAkB,IAAI,CAAC;YACrC,IAAI,UAAU,GAAkB,IAAI,CAAC;YAErC,uCAAuC;YACvC,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;gBAC9C,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;YAC3B,CAAC;YAED,sCAAsC;YACtC,IAAI,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC;gBAC9B,IAAI,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClD,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;oBAC3C,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;gBAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,MAAM,IAAI,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;oBAChF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;oBAEjE,KAAK,CAAC,IAAI,CAAC;wBACT,MAAM,EAAE,UAAU;wBAClB,MAAM,EAAE,UAAU;wBAClB,IAAI;wBACJ,SAAS,EAAE,IAAI;qBAChB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oDAAoD;AACpD,SAAS,iBAAiB,CAAC,GAAY;IACrC,IAAI,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC;IACzB,CAAC;IACD,IAAI,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2EAA2E;AAC3E,SAAS,YAAY,CAAC,UAAyB;IAC7C,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,SAAS,KAAK,CAAC,IAAa;QAC1B,6FAA6F;QAC7F,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,UAAU,EAAE,CAAC;gBACf,qBAAqB,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/F,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAClD,IAAI,UAAU,EAAE,CAAC;gBACf,qBAAqB,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kDAAkD;AAClD,SAAS,qBAAqB,CAAC,KAA8B,EAAE,KAAiB,EAAE,UAAyB;IACzG,iDAAiD;IACjD,IAAI,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClE,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC5D,MAAM,IAAI,GAAa;oBACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI;oBACvB,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;oBACjD,QAAQ,EAAE,OAAO,CAAC,WAAW,KAAK,SAAS;iBAC5C,CAAC;gBACF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;gBACjC,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO;IACT,CAAC;IAED,4DAA4D;IAC5D,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClF,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;oBACtB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,SAAS;oBACnD,QAAQ,EAAE,MAAM,CAAC,aAAa,KAAK,SAAS;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAwB;IAC3C,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;AAC1F,CAAC"}

package/dist/core/analysis/index.d.ts

@@ -0,0 +1,3 @@
+export type { BranchInfo, EffectInfo, ChildComponent, ExternalCall, PropInfo, ComponentAnalysis, } from './types.js';
+export { emptyAnalysis } from './types.js';
+export { extractComponentAnalysis } from './astExtractor.js';

package/dist/core/analysis/index.js

@@ -0,0 +1,3 @@
+export { emptyAnalysis } from './types.js';
+export { extractComponentAnalysis } from './astExtractor.js';
+//# sourceMappingURL=index.js.map

package/dist/core/analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/analysis/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/analysis/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * AST analysis types for extracting component structure.
+ * Used for intelligent context selection and post-generation validation.
+ */
+/** Information about a conditional branch in the component. */
+export type BranchInfo = {
+    line: number;
+    condition: string;
+    paths: number;
+    kind: 'if' | 'ternary' | 'switch' | 'logical';
+};
+/** Information about a React effect hook. */
+export type EffectInfo = {
+    line: number;
+    dependencies: string[];
+    hasCleanup: boolean;
+    kind: 'useEffect' | 'useLayoutEffect' | 'useMemo' | 'useCallback';
+};
+/** Information about a child component rendered in JSX. */
+export type ChildComponent = {
+    name: string;
+    importPath: string;
+    line: number;
+    isConditional: boolean;
+};
+/** Information about an external function/method call. */
+export type ExternalCall = {
+    module: string;
+    method: string;
+    line: number;
+    arguments: string[];
+};
+/** Information about a component prop. */
+export type PropInfo = {
+    name: string;
+    type: string;
+    required: boolean;
+    defaultValue?: string;
+};
+/** Complete analysis result for a React/TypeScript component file. */
+export type ComponentAnalysis = {
+    filePath: string;
+    branches: BranchInfo[];
+    effects: EffectInfo[];
+    children: ChildComponent[];
+    externalCalls: ExternalCall[];
+    props: PropInfo[];
+};
+/** Empty analysis for error cases or non-component files. */
+export declare function emptyAnalysis(filePath: string): ComponentAnalysis;

package/dist/core/analysis/types.js

@@ -0,0 +1,16 @@
+/**
+ * AST analysis types for extracting component structure.
+ * Used for intelligent context selection and post-generation validation.
+ */
+/** Empty analysis for error cases or non-component files. */
+export function emptyAnalysis(filePath) {
+    return {
+        filePath,
+        branches: [],
+        effects: [],
+        children: [],
+        externalCalls: [],
+        props: [],
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/analysis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/analysis/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoDH,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,aAAa,EAAE,EAAE;QACjB,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC"}

package/dist/core/context/contextSelector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Intelligent context selection using AST analysis.
+ * Minimizes token usage while maximizing test generation quality.
+ *
+ * Pure functions only - no file I/O (receives file contents as input).
+ */
+import type { ComponentAnalysis } from '../analysis/types.js';
+/** A file selected for context with priority and reason. */
+export type SelectedContextFile = {
+    path: string;
+    content: string;
+    priority: 'required' | 'recommended' | 'optional';
+    reason: string;
+};
+/** Input for context selection. */
+export type ContextSelectionInput = {
+    targetPath: string;
+    targetContent: string;
+    existingTestPath?: string;
+    existingTestContent?: string;
+    availableFiles: Map<string, string>;
+    analysis: ComponentAnalysis;
+    maxTokens: number;
+};
+/**
+ * Select context files based on analysis and heuristics.
+ * Returns files sorted by priority with reasons for selection.
+ */
+export declare function selectContext(input: ContextSelectionInput): SelectedContextFile[];