sela-core 1.0.0

package/dist/utils/DOMUtils.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOMUtils = void 0;
+class DOMUtils {
+    /**
+     * Sanitizes a Playwright selector (which may contain `>>`) into a CSS-safe
+     * selector by extracting only the last segment. Returns the last meaningful
+     * CSS part so querySelector can be used inside the correct context.
+     */
+    static sanitizeSelector(selector) {
+        const parts = selector.split(">>").map((s) => s.trim());
+        return parts[parts.length - 1];
+    }
+    /**
+     * Given a Playwright `>>` selector, returns each segment in order.
+     * e.g. "#my-iframe >> #shadow-host >> #btn"
+     *   → ["#my-iframe", "#shadow-host", "#btn"]
+     */
+    static parseSegments(selector) {
+        return selector.split(">>").map((s) => s.trim());
+    }
+    // src/utils/DOMUtils.ts (חלק רלוונטי)
+    // בתוך DOMUtils.ts
+    static async getNeighborhoodDom(page, fullSelector) {
+        // וודא שה-Return Type מעודכן כאן!
+        const segments = fullSelector.split(" >> ").map((s) => s.trim());
+        // כאן קוראים לפונקציה הפרטית שכתבנו קודם
+        const result = await this._getNeighborhoodFromFrame(page, segments);
+        // השגיאה שהצגת (Property length does not exist) קרתה כאן כנראה בלוג או בבדיקה
+        if (!result.dom || result.dom.length === 0) {
+            console.warn("[DOM-EXTRACT] ⚠️ No DOM content extracted");
+        }
+        return result; // מחזירים את האובייקט המלא { dom, successfulPath }
+    }
+    /**
+     * When a selector has multiple ">>" segments, the first segments are
+     * typically iframe selectors. This helper drills into the correct frame
+     * before running the DOM extraction.
+     */
+    static async _getNeighborhoodFromFrame(page, segments) {
+        const targetSelector = segments[segments.length - 1];
+        let currentContext = page;
+        const successfulPath = [];
+        try {
+            // עוברים על כל הפריימים בשרשרת
+            for (let i = 0; i < segments.length - 1; i++) {
+                const selector = segments[i];
+                console.log(`[DOM-EXTRACT] 🕳️ Attempting to enter frame: ${selector}`);
+                let frameHandle = await currentContext
+                    .locator(selector)
+                    .elementHandle({ timeout: 2000 })
+                    .catch(() => null);
+                if (!frameHandle) {
+                    console.warn(`[DOM-EXTRACT] ⚠️ Frame ${selector} not found. Stopping drill at: ${successfulPath.join(" >> ") || "root"}`);
+                    break; // עוצרים ומחלצים מאיפה שהצלחנו להגיע
+                }
+                const frame = await frameHandle.contentFrame();
+                if (frame) {
+                    currentContext = frame;
+                    successfulPath.push(selector); // שומרים את ה-Breadcrumb
+                    console.log(`[DOM-EXTRACT] 🌐 Successfully entered context: ${selector}`);
+                }
+                else {
+                    break;
+                }
+            }
+            const dom = await DOMUtils._evaluateNeighborhood(currentContext, targetSelector);
+            return { dom, successfulPath };
+        }
+        catch (e) {
+            console.error(`[DOM-EXTRACT] ⚠️ Critical error: ${e.message}`);
+            return {
+                dom: await DOMUtils._evaluateNeighborhood(page, targetSelector),
+                successfulPath: [],
+            };
+        }
+    }
+    /**
+     * Runs the neighborhood-DOM extraction script inside the given execution
+     * context (either a Page or a Frame).
+     */
+    static async _evaluateNeighborhood(context, selector) {
+        console.log(`[DOM-EXTRACT] 🧠 Force-Extracting full context DOM for: "${selector}"`);
+        const result = await context.evaluate(() => {
+            let indexCounter = 0;
+            const processNode = (node) => {
+                // 1. טיפול בטקסט
+                if (node.nodeType === Node.TEXT_NODE) {
+                    const text = node.textContent?.trim();
+                    return text ? text : null;
+                }
+                // 2. סינון אלמנטים לא רלוונטיים
+                if (node.nodeType !== Node.ELEMENT_NODE &&
+                    !(node instanceof ShadowRoot))
+                    return null;
+                const el = node instanceof ShadowRoot
+                    ? node.host
+                    : node;
+                const tag = node instanceof ShadowRoot ? "shadow-root" : el.tagName.toLowerCase();
+                if (["script", "style", "link", "svg"].includes(tag))
+                    return null;
+                // 3. איסוף אטריביוטים
+                const attrs = [];
+                const preserved = [
+                    "id",
+                    "class",
+                    "data-testid",
+                    "name",
+                    "role",
+                    "src",
+                    "srcdoc",
+                ];
+                preserved.forEach((a) => {
+                    const v = el.getAttribute?.(a);
+                    if (v) {
+                        // שומרים מספיק מ-srcdoc כדי שה-AI יזהה מה יש בפנים
+                        const val = a === "srcdoc" ? v.substring(0, 200) : v;
+                        attrs.push(`${a}="${val}"`);
+                    }
+                });
+                attrs.push(`fx-id="${indexCounter++}"`);
+                // 4. איסוף ילדים (כולל Shadow DOM)
+                const childrenArr = [];
+                if (el instanceof HTMLElement && el.shadowRoot) {
+                    childrenArr.push(...Array.from(el.shadowRoot.childNodes));
+                }
+                childrenArr.push(...Array.from(node.childNodes));
+                // 5. עיבוד ילדים וטקסט פנימי
+                const childrenHtml = childrenArr
+                    .map(processNode)
+                    .filter(Boolean)
+                    .join("");
+                // אם אין ילדים אבל יש טקסט (כמו בכפתור), ניקח אותו
+                const innerContent = childrenHtml || node.textContent?.trim() || "";
+                const attrStr = attrs.length > 0 ? " " + attrs.join(" ") : "";
+                return `<${tag}${attrStr}>${innerContent}</${tag}>`;
+            };
+            const root = document.body || document.documentElement;
+            return processNode(root) || "";
+        });
+        return result;
+    }
+    static getElementDNA = async (page, selector) => {
+        return await page
+            .locator(selector)
+            .first()
+            .evaluate((el) => {
+            const rect = el.getBoundingClientRect();
+            const style = window.getComputedStyle(el);
+            const neighbors = Array.from(el.parentElement?.children || [])
+                .filter((child) => child !== el)
+                .map((child) => child.innerText?.substring(0, 20))
+                .filter(Boolean);
+            return {
+                tagName: el.tagName,
+                text: el.innerText,
+                attributes: Object.fromEntries(Array.from(el.attributes).map((a) => [a.name, a.value])),
+                styles: {
+                    backgroundColor: style.backgroundColor,
+                    color: style.color,
+                    display: style.display,
+                    visibility: style.visibility,
+                },
+                rect: {
+                    x: rect.x,
+                    y: rect.y,
+                    width: rect.width,
+                    height: rect.height,
+                },
+                hierarchy: {
+                    parentTag: el.parentElement?.tagName || "",
+                    parentClass: el.parentElement?.className || "",
+                    neighborTexts: neighbors,
+                },
+            };
+        });
+    };
+}
+exports.DOMUtils = DOMUtils;

package/dist/utils/StackUtils.d.ts

@@ -0,0 +1,11 @@
+export declare class StackUtils {
+    static getCallerInfo(stackOverride?: string): {
+        filePath: string;
+        fileName: string;
+        line: number;
+        column: number;
+        locationKey: string;
+    };
+    static getActionKey(testTitle: string, action: string, index: number): string;
+}
+//# sourceMappingURL=StackUtils.d.ts.map

package/dist/utils/StackUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StackUtils.d.ts","sourceRoot":"","sources":["../../src/utils/StackUtils.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAU;IACrB,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG;QAC5C,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB;IAmED,MAAM,CAAC,YAAY,CACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM;CA6BV"}

package/dist/utils/StackUtils.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StackUtils = void 0;
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+class StackUtils {
+    static getCallerInfo(stackOverride) {
+        let stack = "";
+        if (stackOverride) {
+            stack = stackOverride;
+        }
+        else {
+            const originalStackTraceLimit = Error.stackTraceLimit;
+            Error.stackTraceLimit = 20;
+            stack = new Error().stack || "";
+            Error.stackTraceLimit = originalStackTraceLimit;
+        }
+        const lines = stack.split("\n");
+        const testLine = lines.find((line) => {
+            const lowerLine = line.toLowerCase();
+            // שימוש בבדיקה פשוטה של מחרוזות שמתאימה גם ל-/ וגם ל-\
+            const isInternal = lowerLine.includes("node_modules") ||
+                lowerLine.includes("stackutils") ||
+                lowerLine.includes("fixtures/index") ||
+                lowerLine.includes("fixtures\\index") ||
+                lowerLine.includes("src/fixtures") ||
+                lowerLine.includes("src\\fixtures") ||
+                lowerLine.includes("vitest");
+            const isTestFile = lowerLine.includes(".spec.ts") ||
+                lowerLine.includes(".test.ts") ||
+                lowerLine.includes(".ts");
+            return isTestFile && !isInternal;
+        });
+        if (!testLine)
+            return {
+                filePath: "",
+                fileName: "",
+                line: 0,
+                column: 0,
+                locationKey: "unknown",
+            };
+        const match = testLine.match(/(?:at\s+)?(?:.*\s+\()?(.+?):(\d+):(\d+)\)?/);
+        if (!match)
+            return {
+                filePath: "",
+                fileName: "",
+                line: 0,
+                column: 0,
+                locationKey: "unknown",
+            };
+        const filePath = path.normalize(match[1]);
+        const line = parseInt(match[2], 10);
+        const column = parseInt(match[3], 10);
+        const fileName = path.basename(filePath);
+        const fileKey = fileName.replace(/\./g, "_");
+        return {
+            filePath,
+            fileName,
+            line,
+            column,
+            locationKey: `${fileKey}_L${line}_C${column}`,
+        };
+    }
+    static getActionKey(testTitle, action, index) {
+        const stack = new Error().stack || "";
+        const lines = stack.split("\n");
+        const filteredStack = lines
+            .filter((line) => line.includes("at "))
+            .filter((line) => !line.includes("node_modules") &&
+            !line.includes("StackUtils") &&
+            !line.includes("fixtures/index") &&
+            !line.includes("internal/"))
+            .map((line) => line.trim());
+        const topFrame = filteredStack[0] || "unknown_location";
+        // Regex משופר:
+        // 1. מחליף לוכסנים של ווינדוס בלוכסנים רגילים.
+        // 2. לוקח רק את שם הקובץ ומספר השורה (למשל auth.spec.ts:10).
+        // 3. מתעלם מכל מה שלפני שם הקובץ (הנתיב האבסולוטי).
+        const cleanedFrame = topFrame
+            .replace(/\\/g, "/")
+            .replace(/.*\/([^\/]+\.[jt]s:\d+).*/, "$1") // שומר filename:line
+            .replace(/:\d+$/, (match) => match); // וידוא סופי שהשורה שם
+        const rawKey = `${testTitle}#${cleanedFrame}#${action}#${index}`;
+        return crypto.createHash("md5").update(rawKey).digest("hex");
+    }
+}
+exports.StackUtils = StackUtils;

package/dist/vendor/enquirer.d.ts

@@ -0,0 +1,33 @@
+export declare const Confirm: new (opts: {
+    name?: string;
+    message: string;
+    initial?: boolean;
+}) => {
+    run(): Promise<boolean>;
+};
+export declare const Select: new (opts: {
+    name?: string;
+    message: string;
+    choices: any[];
+    initial?: number;
+    limit?: number;
+}) => {
+    run(): Promise<any>;
+};
+export declare const Input: new (opts: {
+    name?: string;
+    message: string;
+    initial?: string;
+}) => {
+    run(): Promise<string>;
+};
+export declare const AutoComplete: new (opts: {
+    name?: string;
+    message: string;
+    choices: any[];
+    limit?: number;
+    suggest?: (input: string, choices: any[]) => Promise<any[]>;
+}) => {
+    run(): Promise<any>;
+};
+//# sourceMappingURL=enquirer.d.ts.map

package/dist/vendor/enquirer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enquirer.d.ts","sourceRoot":"","sources":["../../src/vendor/enquirer.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,OAAO,aAtBE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK;IAC5E,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAqBM,CAAC;AACnC,eAAO,MAAM,MAAM,aApBE;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,KAAK;IAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;CAcG,CAAC;AACjC,eAAO,MAAM,KAAK,aAdE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK;IACzE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAaG,CAAC;AAC/B,eAAO,MAAM,YAAY,aAZE;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;CAC7D,KAAK;IAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;CAMe,CAAC"}

package/dist/vendor/enquirer.js

@@ -0,0 +1,11 @@
+"use strict";
+// Typed shim for enquirer classes that exist at runtime but are absent from
+// enquirer's official TypeScript declarations (which only expose `export = Enquirer`).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoComplete = exports.Input = exports.Select = exports.Confirm = void 0;
+/* eslint-disable @typescript-eslint/no-var-requires */
+const _eq = require('enquirer');
+exports.Confirm = _eq.Confirm;
+exports.Select = _eq.Select;
+exports.Input = _eq.Input;
+exports.AutoComplete = _eq.AutoComplete;

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "sela-core",
+  "version": "1.0.0",
+  "description": "AI self-healing Playwright wrapper — drop-in replacement for @playwright/test",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "bin": {
+    "sela": "bin/sela.js"
+  },
+  "scripts": {
+    "sela": "tsx src/cli/index.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "prepublishOnly": "npm run build",
+    "test": "npx playwright test demo.spec.ts --headed --retries=0",
+    "test-shadow": "npx playwright test shadow.spec.ts --headed --retries=0",
+    "test-core": "npx playwright test tests/Core/CoreExample.spec.ts --headed --retries=0",
+    "test-DNA": "npx playwright test tests/DnaSurvival/DnaSurvival.spec.ts --headed --retries=0",
+    "test-advanced": "npx playwright test tests/AdvancedLogic/AdvancedLogic.spec.ts --headed --retries=0",
+    "test-isolation": "npx playwright test tests/Isolation/Isolation.spec.ts --headed --retries=0",
+    "test-playwright-actions": "npx playwright test tests/PlaywrightActions/BasicActions/BasicActions.spec.ts --headed --retries=0",
+    "test-forms-actions": "npx playwright test tests/PlaywrightActions/FormsActions/FormsActions.spec.ts --headed --retries=0",
+    "test-locators-actions": "npx playwright test tests/PlaywrightActions/LocatorsActions/LocatorsActions.spec.ts --headed --retries=0",
+    "test-config": "npx playwright test tests/TestConfig/TestConfig.spec.ts --headed --retries=0",
+    "test-safety-guard": "npx playwright test tests/SafetyGuard/SafetyGuard.spec.ts --headed --retries=0",
+    "test-improve-methods": "npx playwright test tests/ImproveMethods/ImproveMethods.spec.ts --headed --retries=0",
+    "test-shadow-dom": "npx playwright test tests/ShadowDom/ShadowDom.spec.ts --headed --retries=0",
+    "test-ut": "npx vitest run tests/unit/DOMUtils.test.ts && npx jest tests/unit/StackUtils.test.ts"
+  },
+  "author": "",
+  "license": "ISC",
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "axios": "^1.13.6",
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.3",
+    "dotenv": "^17.3.1",
+    "enquirer": "^2.4.1",
+    "ora": "^5.4.1",
+    "playwright": "^1.58.2",
+    "ts-morph": "^27.0.2"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.6.0",
+    "jest": "^30.3.0",
+    "jsdom": "^29.0.1",
+    "ts-jest": "^29.4.6",
+    "tsx": "^4.21.0",
+    "vitest": "^4.1.1"
+  }
+}