sela-core 1.0.0

package/dist/services/ArgumentTypeAnalyzer.d.ts

@@ -0,0 +1,26 @@
+import { Node, CallExpression } from "ts-morph";
+export type ArgumentShape = "STRING_LITERAL" | "TEMPLATE_LITERAL" | "IDENTIFIER" | "PROPERTY_ACCESS" | "CALL_EXPRESSION" | "COMPLEX";
+export interface ArgumentAnalysis {
+    shape: ArgumentShape;
+    node: Node;
+    sourceText: string;
+}
+export declare const ALL_LOCATOR_METHODS: Set<string>;
+export declare class ArgumentTypeAnalyzer {
+    /**
+     * Classify the first argument of any CallExpression.
+     * Returns null if the call has no arguments.
+     */
+    static classify(call: CallExpression): ArgumentAnalysis | null;
+    /**
+     * Same as classify() but returns null if the call is not a Playwright
+     * locator method (locator, getByRole, getByLabel, etc.).
+     */
+    static classifyLocatorArg(call: CallExpression): ArgumentAnalysis | null;
+    /**
+     * Returns true when the CallExpression targets a Playwright locator method.
+     */
+    static isLocatorCall(call: CallExpression): boolean;
+    private static classifyNode;
+}
+//# sourceMappingURL=ArgumentTypeAnalyzer.d.ts.map

package/dist/services/ArgumentTypeAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArgumentTypeAnalyzer.d.ts","sourceRoot":"","sources":["../../src/services/ArgumentTypeAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAMhD,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,kBAAkB,GAClB,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,eAAO,MAAM,mBAAmB,aAU9B,CAAC;AASH,qBAAa,oBAAoB;IAC/B;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI;IAW9D;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI;IAKxE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAenD,OAAO,CAAC,MAAM,CAAC,YAAY;CAgC5B"}

package/dist/services/ArgumentTypeAnalyzer.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgumentTypeAnalyzer = exports.ALL_LOCATOR_METHODS = void 0;
+const ts_morph_1 = require("ts-morph");
+// ═══════════════════════════════════════════════════════════════════
+// CONSTANTS
+// ═══════════════════════════════════════════════════════════════════
+exports.ALL_LOCATOR_METHODS = new Set([
+    "locator",
+    "frameLocator",
+    "getByRole",
+    "getByLabel",
+    "getByText",
+    "getByTestId",
+    "getByPlaceholder",
+    "getByAltText",
+    "getByTitle",
+]);
+// ═══════════════════════════════════════════════════════════════════
+// ArgumentTypeAnalyzer
+//
+// Classifies the first argument of a Playwright locator CallExpression.
+// Stateless — no file I/O, no side effects.
+// ═══════════════════════════════════════════════════════════════════
+class ArgumentTypeAnalyzer {
+    /**
+     * Classify the first argument of any CallExpression.
+     * Returns null if the call has no arguments.
+     */
+    static classify(call) {
+        const args = call.getArguments();
+        if (args.length === 0)
+            return null;
+        const arg = args[0];
+        return {
+            shape: ArgumentTypeAnalyzer.classifyNode(arg),
+            node: arg,
+            sourceText: arg.getText(),
+        };
+    }
+    /**
+     * Same as classify() but returns null if the call is not a Playwright
+     * locator method (locator, getByRole, getByLabel, etc.).
+     */
+    static classifyLocatorArg(call) {
+        if (!ArgumentTypeAnalyzer.isLocatorCall(call))
+            return null;
+        return ArgumentTypeAnalyzer.classify(call);
+    }
+    /**
+     * Returns true when the CallExpression targets a Playwright locator method.
+     */
+    static isLocatorCall(call) {
+        const expr = call.getExpression();
+        if (ts_morph_1.Node.isPropertyAccessExpression(expr)) {
+            return exports.ALL_LOCATOR_METHODS.has(expr.getName());
+        }
+        if (ts_morph_1.Node.isIdentifier(expr)) {
+            return exports.ALL_LOCATOR_METHODS.has(expr.getText());
+        }
+        return false;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Private helpers
+    // ─────────────────────────────────────────────────────────────────
+    static classifyNode(node) {
+        // Plain string — value is self-contained in this node.
+        if (ts_morph_1.Node.isStringLiteral(node) ||
+            ts_morph_1.Node.isNoSubstitutionTemplateLiteral(node)) {
+            return "STRING_LITERAL";
+        }
+        // Template with ${...} spans — static segments are healable, spans are not.
+        if (ts_morph_1.Node.isTemplateExpression(node)) {
+            return "TEMPLATE_LITERAL";
+        }
+        // Bare variable name — must trace to declaration.
+        if (ts_morph_1.Node.isIdentifier(node)) {
+            return "IDENTIFIER";
+        }
+        // OBJECT.property — must trace to object literal property value.
+        if (ts_morph_1.Node.isPropertyAccessExpression(node)) {
+            return "PROPERTY_ACCESS";
+        }
+        // fn(...) — must enter function body to find return value.
+        if (ts_morph_1.Node.isCallExpression(node)) {
+            return "CALL_EXPRESSION";
+        }
+        // Binary expressions, conditionals, spreads, etc. — not healable here.
+        return "COMPLEX";
+    }
+}
+exports.ArgumentTypeAnalyzer = ArgumentTypeAnalyzer;

package/dist/services/BlastRadiusAnalyzer.d.ts

@@ -0,0 +1,15 @@
+import { Node, SourceFile, Project } from "ts-morph";
+export type BlastRisk = "low" | "medium" | "high";
+export interface BlastRadiusReport {
+    totalReferences: number;
+    testFunctionCount: number;
+    affectedFiles: string[];
+    risk: BlastRisk;
+}
+export declare class BlastRadiusAnalyzer {
+    static analyze(declarationNode: Node, _sourceFile: SourceFile, _project: Project): BlastRadiusReport;
+    private static doAnalyze;
+    private static getNameNode;
+    private static isTestCall;
+}
+//# sourceMappingURL=BlastRadiusAnalyzer.d.ts.map

package/dist/services/BlastRadiusAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlastRadiusAnalyzer.d.ts","sourceRoot":"","sources":["../../src/services/BlastRadiusAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAc,MAAM,UAAU,CAAC;AAMjE,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;CACjB;AAWD,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CACZ,eAAe,EAAE,IAAI,EACrB,WAAW,EAAE,UAAU,EACvB,QAAQ,EAAE,OAAO,GAChB,iBAAiB;IAgBpB,OAAO,CAAC,MAAM,CAAC,SAAS;IAwDxB,OAAO,CAAC,MAAM,CAAC,WAAW;IAY1B,OAAO,CAAC,MAAM,CAAC,UAAU;CAiB1B"}

package/dist/services/BlastRadiusAnalyzer.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlastRadiusAnalyzer = void 0;
+const ts_morph_1 = require("ts-morph");
+// ═══════════════════════════════════════════════════════════════════
+// BlastRadiusAnalyzer
+//
+// Before mutating a definition-site node, determine how many tests
+// reference it.  Uses ts-morph's findReferences() for cross-file
+// accuracy.  On any analysis failure, defaults to risk:'low' and logs
+// a warning — never blocks healing due to analysis error.
+// ═══════════════════════════════════════════════════════════════════
+class BlastRadiusAnalyzer {
+    static analyze(declarationNode, _sourceFile, _project) {
+        try {
+            return BlastRadiusAnalyzer.doAnalyze(declarationNode);
+        }
+        catch (e) {
+            console.warn(`[BlastRadius] ⚠️ Analysis failed, defaulting to low risk: ${e.message}`);
+            return {
+                totalReferences: 0,
+                testFunctionCount: 0,
+                affectedFiles: [],
+                risk: "low",
+            };
+        }
+    }
+    static doAnalyze(declarationNode) {
+        const nameNode = BlastRadiusAnalyzer.getNameNode(declarationNode);
+        if (!nameNode) {
+            return {
+                totalReferences: 0,
+                testFunctionCount: 0,
+                affectedFiles: [],
+                risk: "low",
+            };
+        }
+        const refs = nameNode.getProject().getLanguageService().findReferences(nameNode);
+        const affectedFilesSet = new Set();
+        let totalRefs = 0;
+        // Key = filePath:startLine of the enclosing test() / it() call.
+        const enclosingTestKeys = new Set();
+        for (const refSymbol of refs) {
+            for (const ref of refSymbol.getReferences()) {
+                if (ref.isDefinition())
+                    continue;
+                totalRefs++;
+                affectedFilesSet.add(ref.getSourceFile().getFilePath());
+                // Walk ancestors to find the enclosing test() or it() call.
+                let ancestor = ref.getNode();
+                while (ancestor) {
+                    if (ts_morph_1.Node.isCallExpression(ancestor) &&
+                        BlastRadiusAnalyzer.isTestCall(ancestor)) {
+                        enclosingTestKeys.add(`${ref.getSourceFile().getFilePath()}:${ancestor.getStartLineNumber()}`);
+                        break;
+                    }
+                    ancestor = ancestor.getParent();
+                }
+            }
+        }
+        const testFunctionCount = enclosingTestKeys.size;
+        const risk = testFunctionCount >= 4
+            ? "high"
+            : testFunctionCount >= 2
+                ? "medium"
+                : "low";
+        return {
+            totalReferences: totalRefs,
+            testFunctionCount,
+            affectedFiles: [...affectedFilesSet],
+            risk,
+        };
+    }
+    static getNameNode(node) {
+        if (ts_morph_1.Node.isVariableDeclaration(node))
+            return node.getNameNode();
+        if (node.getKind() === ts_morph_1.SyntaxKind.PropertyAssignment &&
+            ts_morph_1.Node.isPropertyAssignment(node)) {
+            return node.getNameNode();
+        }
+        // For already-resolved StringLiteral / Identifier targets.
+        return node;
+    }
+    static isTestCall(call) {
+        if (!ts_morph_1.Node.isCallExpression(call))
+            return false;
+        const expr = call.getExpression();
+        // Handles: test("...", ...) and test.only / test.skip etc.
+        if (ts_morph_1.Node.isIdentifier(expr)) {
+            const name = expr.getText();
+            return name === "test" || name === "it";
+        }
+        if (ts_morph_1.Node.isPropertyAccessExpression(expr)) {
+            const obj = expr.getExpression();
+            if (ts_morph_1.Node.isIdentifier(obj)) {
+                const name = obj.getText();
+                return name === "test" || name === "it";
+            }
+        }
+        return false;
+    }
+}
+exports.BlastRadiusAnalyzer = BlastRadiusAnalyzer;

package/dist/services/ChainValidator.d.ts

@@ -0,0 +1,76 @@
+export type ChainSegment = {
+    type: "locator";
+    selector: string;
+} | {
+    type: "frameLocator";
+    selector: string;
+} | {
+    type: "getByRole";
+    role: string;
+    name?: string;
+    exact?: boolean;
+} | {
+    type: "getByLabel";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByText";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByPlaceholder";
+    text: string;
+} | {
+    type: "getByTestId";
+    testId: string;
+} | {
+    type: "getByAltText";
+    text: string;
+} | {
+    type: "getByTitle";
+    text: string;
+} | {
+    type: "filter";
+    hasText?: string;
+    hasNotText?: string;
+    has?: string;
+    hasNot?: string;
+} | {
+    type: "first";
+} | {
+    type: "last";
+} | {
+    type: "nth";
+    index: number;
+};
+export type ReturnType = "Locator" | "FrameLocator" | "unknown";
+export interface ValidationResult {
+    valid: boolean;
+    reason?: string;
+    segments?: ChainSegment[];
+}
+export declare function segmentsToCode(receiver: string, segments: ChainSegment[], multiLine?: boolean): string;
+export interface ChainValidationInput {
+    segments: unknown[];
+    originalRootReceiver: string;
+    proposedRootReceiver: string;
+    rootType?: ReturnType;
+    applySemanticUpgrade?: boolean;
+}
+export interface ChainValidationOutput {
+    valid: boolean;
+    reason?: string;
+    segments?: ChainSegment[];
+    code?: string;
+    multiLine?: boolean;
+}
+export declare class ChainValidator {
+    validate(input: ChainValidationInput): ChainValidationOutput;
+    /**
+     * Lightweight check: does this segment array describe the same
+     * semantic intent as the old flat selector string?
+     * Used as a sanity check before committing an AST write.
+     */
+    intentMatches(segments: ChainSegment[], oldFlatSelector: string): boolean;
+}
+//# sourceMappingURL=ChainValidator.d.ts.map

package/dist/services/ChainValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainValidator.d.ts","sourceRoot":"","sources":["../../src/services/ChainValidator.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AA2cD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,GAAE,OAAe,GACzB,MAAM,CAkER;AAWD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB;IAsE5D;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CA0B1E"}