sela-core 1.0.0 → 1.0.2

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQnD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQnD"}

package/dist/cli/commands/init.js

@@ -36,7 +36,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerInit = registerInit;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const CONFIG_TEMPLATE_TS = `import { defineConfig } from 'sela';
+const PACKAGE_NAME = 'sela-core';
+const CONFIG_TEMPLATE_TS = `import { defineConfig } from '${PACKAGE_NAME}';
 
 export default defineConfig({
   healingPolicy: 'balanced',
@@ -45,7 +46,7 @@ export default defineConfig({
   dnaStoragePath: 'sela-snapshots',
 });
 `;
-const CONFIG_TEMPLATE_JS = `const { defineConfig } = require('sela');
+const CONFIG_TEMPLATE_JS = `const { defineConfig } = require('${PACKAGE_NAME}');
 
 module.exports = defineConfig({
   healingPolicy: 'balanced',
@@ -59,7 +60,7 @@ function registerInit(program) {
     program
         .command('init')
         .description('Initialize Sela in the current project')
-        .option('--update-imports', 'Swap @playwright/test imports to sela in spec files')
+        .option('--no-update-imports', 'Skip swapping @playwright/test imports to sela-core')
         .action(async (opts) => {
         await runInit(opts);
     });
@@ -81,6 +82,7 @@ async function runInit(opts) {
         console.error(`✅ Created ${configFile}`);
     }
     // ── Environment variables ────────────────────────────────────────
+    loadDotEnv(cwd);
     const missing = REQUIRED_ENV_VARS.filter((k) => !process.env[k]);
     if (missing.length > 0) {
         console.error(`\n⚠️  Missing environment variables:`);
@@ -91,19 +93,38 @@ async function runInit(opts) {
     else {
         console.error(`✅ Environment variables OK`);
     }
-    // ── Optional import swap ─────────────────────────────────────────
-    if (opts.updateImports) {
+    // ── Import swap (default ON; opt out with --no-update-imports) ──
+    if (opts.updateImports !== false) {
         const swapped = swapImports(cwd, isTs);
-        console.error(`✅ Updated imports in ${swapped} spec file(s)`);
+        if (swapped > 0) {
+            console.error(`✅ Updated imports in ${swapped} spec file(s) → '${PACKAGE_NAME}'`);
+        }
+        else {
+            console.error(`ℹ️  No @playwright/test imports to swap`);
+        }
+    }
+    console.error(`\n📖 Spec files should import from:`);
+    console.error(`   import { test, expect } from '${PACKAGE_NAME}'\n`);
+}
+function loadDotEnv(cwd) {
+    const envPath = path.join(cwd, '.env');
+    if (!fs.existsSync(envPath))
+        return;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const dotenv = require('dotenv');
+        dotenv.config({ path: envPath });
+    }
+    catch {
+        // dotenv missing — skip silently
     }
-    console.error(`\n📖 Replace imports in your spec files:`);
-    console.error(`   from: import { test, expect } from '@playwright/test'`);
-    console.error(`   to:   import { test, expect } from 'sela'\n`);
 }
 function walkDir(dir, exts) {
     const results = [];
-    const ignore = new Set(['node_modules', 'dist', '.git']);
+    const ignore = new Set(['node_modules', 'dist', '.git', 'sela-snapshots', 'fixwright-snapshots', 'test-results', 'playwright-report']);
     function walk(current) {
+        if (!fs.existsSync(current))
+            return;
         for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
             if (entry.isDirectory()) {
                 if (!ignore.has(entry.name))
@@ -118,12 +139,15 @@ function walkDir(dir, exts) {
     return results;
 }
 function swapImports(cwd, isTs) {
-    const exts = isTs ? ['.spec.ts', '.test.ts'] : ['.spec.js', '.test.js'];
+    const exts = isTs
+        ? ['.spec.ts', '.test.ts', '.spec.js', '.test.js']
+        : ['.spec.js', '.test.js'];
     const files = walkDir(cwd, exts);
     let swapped = 0;
+    const importRegex = /(from\s+|require\s*\(\s*)(['"])@playwright\/test\2/g;
     for (const filePath of files) {
         const content = fs.readFileSync(filePath, 'utf8');
-        const updated = content.replace(/from\s+['"]@playwright\/test['"]/g, `from 'sela'`);
+        const updated = content.replace(importRegex, (_m, prefix, quote) => `${prefix}${quote}${PACKAGE_NAME}${quote}`);
         if (updated !== content) {
             fs.writeFileSync(filePath, updated, 'utf8');
             swapped++;

package/dist/cli/index.js

@@ -1,5 +1,47 @@
 "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 });
+// Load .env from CWD before anything else reads process.env
+const path = __importStar(require("path"));
+try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    require('dotenv').config({ path: path.join(process.cwd(), '.env') });
+}
+catch {
+    // dotenv missing or .env absent — continue silently
+}
 const commander_1 = require("commander");
 const ErrorHandler_js_1 = require("./ErrorHandler.js");
 const init_js_1 = require("./commands/init.js");
@@ -16,7 +58,7 @@ const program = new commander_1.Command();
 program
     .name('sela')
     .description('Sela CLI — proactive DNA management for Fixwright')
-    .version('1.0.0')
+    .version('1.0.2')
     .exitOverride(ErrorHandler_js_1.handleError)
     .configureOutput({ outputError: () => { } });
 // ── sela init ────────────────────────────────────────────────────────────────

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

@@ -1 +1 @@
-{"version":3,"file":"expectProxy.d.ts","sourceRoot":"","sources":["../../src/fixtures/expectProxy.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,OAAO,EAER,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA2N5D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,kBAAkB,EAAE,IAAI,EACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,6CAA6C;AAClE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,GAChD,CAAC,cAAc,EAAE,OAAO,KAAK,GAAG,CA2DlC"}
+{"version":3,"file":"expectProxy.d.ts","sourceRoot":"","sources":["../../src/fixtures/expectProxy.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,OAAO,EAER,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAgO5D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,kBAAkB,EAAE,IAAI,EACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,6CAA6C;AAClE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,GAChD,CAAC,cAAc,EAAE,OAAO,KAAK,GAAG,CAiElC"}

package/dist/fixtures/expectProxy.js

@@ -29,6 +29,11 @@ function isRealLocator(value) {
         return false;
     if (typeof value !== "object")
         return false;
+    // Fixwright locator proxies expose `_fixwrightSelector`. The proxy forwards
+    // `_frame` via Reflect.get so `hasFrame` would lie — explicitly reject them
+    // here. Callers should unwrap via `resolveProxy` first.
+    if (value._fixwrightSelector !== undefined)
+        return false;
     const hasFrame = value._frame !== undefined ||
         value._impl?._frame !== undefined;
     const isFrameLocator = value._frameSelector !== undefined ||
@@ -206,6 +211,11 @@ resolveProxy) {
                 resolved = unwrapped;
         }
         const base = (0, test_1.expect)(resolved);
+        // Defensive: if for any reason `base` is not an object, return it as-is
+        // rather than crashing inside `new Proxy(...)`.
+        if (base === null || typeof base !== "object") {
+            return base;
+        }
         // Step 2 — only wrap matchers for genuine page-level Locator objects.
         if (!isRealLocator(resolved)) {
             return base;

package/dist/fixtures/index.d.ts

@@ -1,4 +1,6 @@
+import { Locator } from "@playwright/test";
 import { createHealingExpect } from "./expectProxy";
+export declare function resolveFixwrightProxy(value: unknown): Locator | null;
 export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
     expect: ReturnType<typeof createHealingExpect>;
 }, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAk2BpD,eAAO,MAAM,IAAI;YACP,UAAU,CAAC,OAAO,mBAAmB,CAAC;wGA+F9C,CAAC;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EAER,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAWpD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAIpE;AA02BD,eAAO,MAAM,IAAI;YACP,UAAU,CAAC,OAAO,mBAAmB,CAAC;wGA+F9C,CAAC;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/fixtures/index.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHealingExpect = exports.test = void 0;
+exports.resolveFixwrightProxy = resolveFixwrightProxy;
 const test_1 = require("@playwright/test");
 const StackUtils_1 = require("../utils/StackUtils");
 const HealingRegistry_1 = require("../engine/HealingRegistry");
@@ -43,6 +44,15 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const registry = HealingRegistry_1.HealingRegistry.getInstance();
 const proxyToActiveLocator = new WeakMap();
+// Module-level resolver — moduleExpect.ts uses this to unwrap a Fixwright
+// locator proxy back to its live underlying Playwright Locator without
+// needing access to the WeakMap directly.
+function resolveFixwrightProxy(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const getActive = proxyToActiveLocator.get(value);
+    return getActive ? getActive() : null;
+}
 // ─── Action classification (identical to original) ────────────────
 const INTERCEPTED_ACTIONS = [
     "click",
@@ -461,6 +471,12 @@ function createFrameLocatorProxy(rawFrameLocator, frameSelector, rawPage, testTi
 //  3. Exposes _fixwrightUnsubscribe so the fixture can clean up.
 // ─────────────────────────────────────────────────────────────────
 function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCounter, elementSelectorOnly) {
+    // Defensive: Proxy ctor throws "Cannot create proxy with a non-object as target"
+    // when downstream callers (e.g. chained traps) pass a non-Locator return value.
+    // Returning the raw value lets the caller see it unchanged instead of crashing.
+    if (rawLocator === null || rawLocator === undefined || typeof rawLocator !== "object") {
+        return rawLocator;
+    }
     // ── Resolve immediately (handles post-heal proxy creation) ────
     const initialResolved = registry.resolveSelector(selector);
     let currentFullSelector = initialResolved;
@@ -517,9 +533,13 @@ function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCoun
             // ── getBy* ───────────────────────────────────────────────
             if (prop in GET_BY_METHODS) {
                 return (...args) => {
+                    const nextLocator = activeLocator[prop](...args);
+                    if (nextLocator === null || nextLocator === undefined || typeof nextLocator !== "object") {
+                        return nextLocator;
+                    }
                     const semanticSelector = GET_BY_METHODS[prop](args);
                     const childFullSelector = `${currentFullSelector} >> ${semanticSelector}`;
-                    return createLocatorProxy(activeLocator[prop](...args), childFullSelector, rawPage, testTitle, actionCounter, semanticSelector);
+                    return createLocatorProxy(nextLocator, childFullSelector, rawPage, testTitle, actionCounter, semanticSelector);
                 };
             }
             // ── Chainable methods ────────────────────────────────────
@@ -527,6 +547,9 @@ function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCoun
             if (chainables.includes(prop)) {
                 return (...args) => {
                     const nextLocator = activeLocator[prop](...args);
+                    if (nextLocator === null || nextLocator === undefined || typeof nextLocator !== "object") {
+                        return nextLocator;
+                    }
                     let nextFull = currentFullSelector;
                     let nextElement = currentElementSelector;
                     if (prop === "locator") {

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

@@ -1 +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"}
+{"version":3,"file":"moduleExpect.d.ts","sourceRoot":"","sources":["../../src/fixtures/moduleExpect.ts"],"names":[],"mappings":"AAuCA,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAa1C"}

package/dist/fixtures/moduleExpect.js

@@ -7,6 +7,7 @@ exports.expect = expect;
 const test_1 = require("@playwright/test");
 const singleton_js_1 = require("../engine/singleton.js");
 const expectProxy_js_1 = require("./expectProxy.js");
+const index_js_1 = require("./index.js");
 function extractPage(value) {
     if (!value || typeof value !== 'object')
         return null;
@@ -40,7 +41,7 @@ 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, expectProxy_js_1.createHealingExpect)(singleton_js_1.sharedEngine, page, filePath, 0, index_js_1.resolveFixwrightProxy)(value);
     }
     return (0, test_1.expect)(value);
 }

package/dist/index.d.ts

@@ -1,7 +1,7 @@
+export { defineConfig } from './config/defineConfig.js';
+export type { SelaConfig, ResolvedConfig } from './config/SelaConfig.js';
 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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzE,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"}

package/dist/index.js

@@ -1,13 +1,14 @@
 "use strict";
-// Sela — AI self-healing Playwright wrapper
+// sela-core — 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.
+//   import { test, expect } from 'sela-core'
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineConfig = exports.expect = exports.test = exports.selectors = exports.devices = exports.webkit = exports.firefox = exports.chromium = void 0;
+exports.expect = exports.test = exports.selectors = exports.devices = exports.webkit = exports.firefox = exports.chromium = exports.defineConfig = void 0;
+// Config DSL exported FIRST so `sela.config.ts` can `import { defineConfig }`
+// without triggering the heavier fixtures/engine graph during config load.
+var defineConfig_js_1 = require("./config/defineConfig.js");
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return defineConfig_js_1.defineConfig; } });
 // Playwright value exports (launchers, devices, etc.)
 var test_1 = require("@playwright/test");
 Object.defineProperty(exports, "chromium", { enumerable: true, get: function () { return test_1.chromium; } });
@@ -19,10 +20,7 @@ Object.defineProperty(exports, "selectors", { enumerable: true, get: function ()
 // 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')
+// Sela's healing expect — works standalone (import { expect } from 'sela-core')
 // 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sela-core",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "AI self-healing Playwright wrapper — drop-in replacement for @playwright/test",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -57,7 +57,7 @@
   "devDependencies": {
     "@playwright/test": "^1.58.2",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.6.2",
     "jest": "^30.3.0",
     "jsdom": "^29.0.1",
     "ts-jest": "^29.4.6",