sela-core 1.0.0

package/dist/fixtures/moduleExpect.d.ts

@@ -0,0 +1,2 @@
+export declare function expect(value: unknown): any;
+//# sourceMappingURL=moduleExpect.d.ts.map

package/dist/fixtures/moduleExpect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleExpect.d.ts","sourceRoot":"","sources":["../../src/fixtures/moduleExpect.ts"],"names":[],"mappings":"AAsCA,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAO1C"}

package/dist/fixtures/moduleExpect.js

@@ -0,0 +1,46 @@
+"use strict";
+// Standalone module-level expect for `import { expect } from 'sela'` usage.
+// Creates a per-call healing expect using the shared engine singleton.
+// Falls back to raw Playwright expect for non-Locator values.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expect = expect;
+const test_1 = require("@playwright/test");
+const singleton_js_1 = require("../engine/singleton.js");
+const expectProxy_js_1 = require("./expectProxy.js");
+function extractPage(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    // Fixwright locator proxy exposes _fixwrightPage directly
+    const proxied = value._fixwrightPage;
+    if (proxied)
+        return proxied;
+    // Playwright public API: Locator.page()
+    if (typeof value.page === 'function') {
+        try {
+            return value.page();
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function getCallerFile() {
+    const lines = new Error().stack?.split('\n') ?? [];
+    for (let i = 3; i < lines.length; i++) {
+        if (/\.(spec|test)\.[jt]sx?/.test(lines[i])) {
+            const m = lines[i].match(/\((.+?):\d+:\d+\)/);
+            if (m)
+                return m[1];
+        }
+    }
+    return '';
+}
+function expect(value) {
+    const page = extractPage(value);
+    if (page) {
+        const filePath = getCallerFile();
+        return (0, expectProxy_js_1.createHealingExpect)(singleton_js_1.sharedEngine, page, filePath, 0)(value);
+    }
+    return (0, test_1.expect)(value);
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type * from '@playwright/test';
+export { chromium, firefox, webkit, devices, selectors } from '@playwright/test';
+export { test } from './fixtures/index.js';
+export { expect } from './fixtures/moduleExpect.js';
+export { defineConfig } from './config/defineConfig.js';
+export type { SelaConfig, ResolvedConfig } from './config/SelaConfig.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,mBAAmB,kBAAkB,CAAC;AAGtC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIjF,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+// Sela — AI self-healing Playwright wrapper
+//
+// Drop-in replacement for @playwright/test:
+//   import { test, expect } from 'sela'
+//
+// All Playwright primitives are re-exported. Only `test` and `expect`
+// are overridden with Sela's healing versions.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = exports.expect = exports.test = exports.selectors = exports.devices = exports.webkit = exports.firefox = exports.chromium = void 0;
+// Playwright value exports (launchers, devices, etc.)
+var test_1 = require("@playwright/test");
+Object.defineProperty(exports, "chromium", { enumerable: true, get: function () { return test_1.chromium; } });
+Object.defineProperty(exports, "firefox", { enumerable: true, get: function () { return test_1.firefox; } });
+Object.defineProperty(exports, "webkit", { enumerable: true, get: function () { return test_1.webkit; } });
+Object.defineProperty(exports, "devices", { enumerable: true, get: function () { return test_1.devices; } });
+Object.defineProperty(exports, "selectors", { enumerable: true, get: function () { return test_1.selectors; } });
+// Sela's extended test — includes DNA capture, trace collection,
+// locator proxy, and fixture-scoped healing expect
+var index_js_1 = require("./fixtures/index.js");
+Object.defineProperty(exports, "test", { enumerable: true, get: function () { return index_js_1.test; } });
+// Sela's healing expect — works standalone (import { expect } from 'sela')
+// Detects page from locator, falls back to raw PW expect for non-locators
+var moduleExpect_js_1 = require("./fixtures/moduleExpect.js");
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return moduleExpect_js_1.expect; } });
+// Config DSL — defineConfig() provides TypeScript inference for sela.config.ts
+var defineConfig_js_1 = require("./config/defineConfig.js");
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return defineConfig_js_1.defineConfig; } });

package/dist/services/ASTSourceUpdater.d.ts

@@ -0,0 +1,79 @@
+import { SelectorSegment } from "./LLMService";
+import { AdvisoryBuffer } from "./HealingAdvisory";
+import type { SmartChainSegment } from "./LLMService";
+export interface ASTUpdateResult {
+    success: boolean;
+    reason: string;
+    strategy: string;
+    lineUpdated?: number;
+    cascadeFixed?: number;
+    /** The normalized locator string that was written to disk. Single source of truth for runtime. */
+    healedLocatorString?: string;
+    /** Populated by semantic dispatch: where the definition was mutated. */
+    definitionSite?: {
+        file: string;
+        line: number;
+    };
+    /** Number of test functions referencing the mutated constant (blast radius). */
+    blastRadius?: number;
+}
+interface CallerContext {
+    filePath: string;
+    line: number;
+}
+export declare class ASTSourceUpdater {
+    private project;
+    readonly advisoryBuffer: AdvisoryBuffer;
+    flushAdvisories(): void;
+    constructor();
+    private readonly WRAPPER_IDENTIFIERS;
+    private readonly STRUCTURAL_ROLES;
+    private readonly INTERACTIVE_ROLES;
+    update(caller: CallerContext, oldSelector: string, newSelector: string, aiSegments?: SelectorSegment[], fullSelectorContext?: string, contentChange?: {
+        oldText: string;
+        newText: string;
+    }, smartChainSegments?: SmartChainSegment[], originalChainHint?: SmartChainSegment[]): ASTUpdateResult;
+    private strategySmartChain;
+    private attemptPartialChainHeal;
+    private strategyChainCollapse;
+    private runStrategyG;
+    private strategyFrameUpstream;
+    private strategyDeepSymbolResolution;
+    private strategyInlineSemanticFix;
+    private strategyTemplateLiteral;
+    private strategySemanticFragmentScan;
+    private findMatchingChainTail;
+    private replaceChainTailOnly;
+    private applySemanticFix;
+    /**
+     * Guard: returns false when replacing oldNode with proposedNewText would
+     * substitute a hardcoded string literal for an Identifier or
+     * PropertyAccessExpression — which is the definition-site mutation bug.
+     * All other replacements are allowed.
+     */
+    private static isSafeReplacement;
+    private replaceCallArgument;
+    private semanticToInternal;
+    private performCascadeHeal;
+    private fixPropertyAccessDefinition;
+    private isBlockedByStructuralWall;
+    private identifySuspectIdentifier;
+    private getEnclosingStatement;
+    private findNodeAtLine;
+    private findCallExpressionsInRange;
+    private replaceFrameLocatorArg;
+    private replaceStringLiteralInRange;
+    private updateObjectProperty;
+    private lineToOffset;
+    resolveFilePath(raw: string): string | null;
+    private semanticDispatch;
+    private handleIdentifierArg;
+    private handlePropertyAccessArg;
+    private handleTemplateLiteralArg;
+    private traceSpanExpression;
+    private handleCallExpressionArg;
+    private validateFileSyntax;
+    private broadcastAndReturn;
+}
+export {};
+//# sourceMappingURL=ASTSourceUpdater.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ASTSourceUpdater.d.ts","sourceRoot":"","sources":["../../src/services/ASTSourceUpdater.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQ/C,OAAO,EAAE,cAAc,EAAgB,MAAM,mBAAmB,CAAC;AAOjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMtD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAg5DD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAU;IACzB,QAAQ,CAAC,cAAc,iBAAwB;IAE/C,eAAe,IAAI,IAAI;;IAiBvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAcjC;IAEH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CA8B9B;IAEH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAuB/B;IAMH,MAAM,CACJ,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,eAAe,EAAE,EAC9B,mBAAmB,CAAC,EAAE,MAAM,EAC5B,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACpD,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,EACxC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GACtC,eAAe;IA8PlB,OAAO,CAAC,kBAAkB;IAsM1B,OAAO,CAAC,uBAAuB;IA6F/B,OAAO,CAAC,qBAAqB;IAyF7B,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,qBAAqB;IA0G7B,OAAO,CAAC,4BAA4B;IAoRpC,OAAO,CAAC,yBAAyB;IAsGjC,OAAO,CAAC,uBAAuB;IA4E/B,OAAO,CAAC,4BAA4B;IA4EpC,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,oBAAoB;IAwB5B,OAAO,CAAC,gBAAgB;IAwBxB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAUhC,OAAO,CAAC,mBAAmB;IAuC3B,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,2BAA2B;IAsCnC,OAAO,CAAC,yBAAyB;IAqCjC,OAAO,CAAC,yBAAyB;IA+CjC,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,0BAA0B;IAmBlC,OAAO,CAAC,sBAAsB;IA2B9B,OAAO,CAAC,2BAA2B;IAoCnC,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,YAAY;IAUpB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAa3C,OAAO,CAAC,gBAAgB;IAkExB,OAAO,CAAC,mBAAmB;IAiF3B,OAAO,CAAC,uBAAuB;IAiF/B,OAAO,CAAC,wBAAwB;IAkFhC,OAAO,CAAC,mBAAmB;IA8C3B,OAAO,CAAC,uBAAuB;IAoF/B,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,kBAAkB;CAgB3B"}