@ia-qa/self-healing 1.5.8 → 1.6.2

package/dist/nameDrift.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Name drift — the rename your suite actually depends on.
+ *
+ * `diffMappings` classifies a relabelled element as `renamed`: the selector still
+ * resolves, the click still lands on the right thing, so the verdict stays PASS
+ * and a human is asked to eyeball the copy change. That reading is correct for a
+ * suite written in CSS. It is exactly wrong for one written with
+ * `getByRole('button', { name: 'Save' })`, where the label *is* the locator: the
+ * gate goes green while the suite goes red.
+ *
+ * This module is the arbiter between the two readings, and it needs one fact the
+ * contract cannot hold — what the tests reference. That fact comes from
+ * `.ia-qa/usage.json` (`ia-qa-heal ingest`), read from disk, never from the
+ * network.
+ *
+ * It deliberately lives **outside** `src/browser/match.js`. That file is shipped
+ * twice (npm + the zero-install web flow) and must stay dependency-free, so the
+ * classification it computes is left untouched and this pass only *escalates* on
+ * top of it. The web tool, which has no usage.json, keeps behaving exactly as
+ * before.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REASON_LABEL = void 0;
+exports.assessNameDrift = assessNameDrift;
+exports.escalateVerdict = escalateVerdict;
+exports.formatFinding = formatFinding;
+exports.mergeFindings = mergeFindings;
+const nameLocators_1 = require("./nameLocators");
+const norm = nameLocators_1.normalizeName;
+/**
+ * Which recorded test occurrences could be pointing at this element?
+ *
+ * A `getByRole('button', …)` site only speaks about buttons; `getByText` and
+ * `cy.contains` constrain nothing, so they are kept for any role. Filtering here
+ * rather than at scan time keeps the inventory framework-neutral.
+ */
+function sitesFor(usage, name, role) {
+    const all = usage.names?.[norm(name)] ?? [];
+    return all.filter((s) => {
+        const roles = (0, nameLocators_1.candidateRoles)(s);
+        return roles === null || roles.indexOf(role) !== -1;
+    });
+}
+/**
+ * Assess every `renamed` row against what the suite references.
+ *
+ * Returns one finding per rename the tests actually depend on. A rename nobody
+ * tests produces nothing — which is why adopting this costs no new noise.
+ */
+function assessNameDrift(rows, afterElements, usage) {
+    if (!usage || !usage.names)
+        return [];
+    const findings = [];
+    for (const row of rows) {
+        if (row.status !== 'renamed' || !row.newName || !row.role)
+            continue;
+        const oldName = row.name ?? '';
+        if (oldName === '')
+            continue;
+        const sites = sitesFor(usage, oldName, row.role);
+        if (sites.length === 0)
+            continue;
+        // A site is rewritable only when its call constrains the role and that role
+        // is the drifted element's. Everything else names a bare string, and no
+        // contract can say which node wears it.
+        const rewritable = sites.filter((s) => {
+            const roles = (0, nameLocators_1.candidateRoles)(s);
+            return roles !== null && roles.indexOf(row.role) !== -1;
+        });
+        const unattributable = sites.filter((s) => rewritable.indexOf(s) === -1);
+        // Does the OLD label still exist on something these calls could reach? Then
+        // the locator has not stopped matching — it has started matching something
+        // *else*. Rewriting it would silently retarget a passing test, so this is
+        // the name-space twin of `rebound` and it belongs to a human.
+        //
+        // The role set is the one the CALLS can reach, not the drifted element's
+        // alone: `getByLabel` resolves against any form control, so a renamed
+        // checkbox does not license rewriting a label a textbox still carries.
+        const reachable = new Set([row.role]);
+        for (const s of rewritable)
+            for (const r of (0, nameLocators_1.candidateRoles)(s) ?? [])
+                reachable.add(r);
+        const shadowed = afterElements.some((e) => reachable.has(e.role) && norm(e.name) === norm(oldName));
+        // Symmetrically: the NEW label must be unique among the roles the calls can
+        // reach, not merely among the drifted element's own role. Scoping this to
+        // `row.role` would let a renamed checkbox emit `getByLabel('Email')` while a
+        // textbox already answers to it — a locator matching two elements, which is
+        // a Playwright strict-mode failure rather than a heal.
+        const targets = afterElements.filter((e) => reachable.has(e.role) && norm(e.name) === norm(row.newName));
+        const reason = shadowed
+            ? 'shadowed'
+            : targets.length === 0
+                ? 'no-target'
+                : targets.length > 1
+                    ? 'ambiguous-target'
+                    : rewritable.length === 0
+                        ? 'text-anchored'
+                        : 'fixable';
+        findings.push({
+            role: row.role,
+            oldName,
+            newName: row.newName,
+            selector: row.selector ?? '',
+            sites,
+            rewritable,
+            unattributable,
+            fixable: reason === 'fixable',
+            reason,
+        });
+    }
+    return findings;
+}
+/**
+ * Raise a verdict to account for name drift.
+ *
+ * A rename the suite depends on and that we can rewrite is a FIX — same class as
+ * a healable selector. One we cannot rewrite without guessing is a BLOCK, for the
+ * same reason `ambiguous` is: a FIX exits 0, and exiting 0 on a suite that is
+ * about to fail is the bug this whole module exists to close. A verdict is only
+ * ever raised, never lowered.
+ */
+function escalateVerdict(current, findings) {
+    if (findings.length === 0)
+        return current;
+    if (current === 'BLOCK')
+        return 'BLOCK';
+    // An occurrence we refuse to attribute is not a smaller problem than one we
+    // cannot resolve — in both cases a human has to look, and FIX exits 0.
+    if (findings.some((f) => !f.fixable || f.unattributable.length > 0))
+        return 'BLOCK';
+    return current === 'PASS' ? 'FIX' : current;
+}
+exports.REASON_LABEL = {
+    fixable: 'rewritable — one element carries the new label',
+    shadowed: 'the old label still exists on another element: your locator now targets it',
+    'ambiguous-target': 'several elements carry the new label — pick one by hand',
+    'no-target': 'the new label matches no element in this contract',
+    'text-anchored': 'only text-anchored references — the contract cannot say what they target',
+};
+const sitesLine = (sites) => {
+    const where = sites.slice(0, 3).map((s) => `${s.file}:${s.line}`).join(', ');
+    return where + (sites.length > 3 ? ` +${sites.length - 3} more` : '');
+};
+/** One block per finding, shared by `diff`, `fix` and `run`. */
+function formatFinding(f) {
+    const mark = f.fixable && f.unattributable.length === 0 ? '✏️ ' : '⛔';
+    const lines = [`   ${mark} ${f.role} "${f.oldName}" → "${f.newName}"`];
+    if (f.rewritable.length > 0) {
+        lines.push(`        ${f.rewritable.length} role-anchored reference${f.rewritable.length === 1 ? '' : 's'}` +
+            `${f.fixable ? ' — rewritten' : ''}: ${sitesLine(f.rewritable)}`);
+    }
+    if (f.unattributable.length > 0) {
+        lines.push(`        ${f.unattributable.length} text-anchored reference${f.unattributable.length === 1 ? '' : 's'}` +
+            ` — NOT rewritten, confirm by hand: ${sitesLine(f.unattributable)}`);
+        lines.push(`        (getByText/contains name a string, not an element; the contract maps interactive`);
+        lines.push(`         elements only, so it cannot prove they meant this one.)`);
+    }
+    lines.push(`        ${exports.REASON_LABEL[f.reason]}`);
+    return lines.join('\n');
+}
+/** De-dupe findings across pages: a shared header renames once, not 40 times. */
+function mergeFindings(groups) {
+    const byKey = new Map();
+    for (const group of groups) {
+        for (const f of group) {
+            const key = `${f.role}${norm(f.oldName)}${norm(f.newName)}`;
+            const existing = byKey.get(key);
+            // Keep the strictest reading: one page proving the rewrite unsafe is enough.
+            const safety = (x) => (x.fixable ? 1 : 0) + (x.unattributable.length === 0 ? 1 : 0);
+            if (!existing || safety(f) < safety(existing))
+                byKey.set(key, f);
+        }
+    }
+    return Array.from(byKey.values());
+}
+//# sourceMappingURL=nameDrift.js.map

package/dist/nameDrift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameDrift.js","sourceRoot":"","sources":["../src/nameDrift.ts"],"names":[],"mappings":"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"}

package/dist/nameLocators.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Static inventory of **name-anchored** locators — the other half of `ingest`.
+ *
+ * `usage.selectors` answers "which CSS selectors does the suite use?". That was
+ * only ever half the question: a suite written the modern way does not hold CSS
+ * at all. `page.getByRole('button', { name: 'Save' })`, `cy.contains('Save')` and
+ * `By.linkText('Save')` are anchored on the **accessible name**, so they survive
+ * every selector rewrite this tool can perform and break on the one kind of drift
+ * it used to classify as harmless: a rename.
+ *
+ * Same discipline as `ingest`: quoted literals in known call shapes, no
+ * execution, no AST, no network. A name built by concatenation or holding `${…}`
+ * is invisible here — and invisible to the rewrite below too, which is why it is
+ * skipped rather than guessed at.
+ *
+ * Framework parity is the point (guardrail: Playwright / Cypress / Selenium must
+ * all be first-class). Every shape below carries what the contract needs to check
+ * it: a name, and a role when the call states one.
+ */
+export type NameShape = 'playwright-role' | 'playwright-text' | 'playwright-label' | 'playwright-placeholder' | 'playwright-title' | 'playwright-alt' | 'cypress-contains' | 'selenium-linktext';
+/** Where a name-anchored locator was found. Serialized into `.ia-qa/usage.json`. */
+export interface NameSite {
+    file: string;
+    line: number;
+    shape: NameShape;
+    /** The ARIA role the call states, when it states one (`getByRole` only). */
+    role?: string;
+    /**
+     * The name exactly as the source writes it. The inventory is keyed by the
+     * normalized form so lookups are case- and whitespace-insensitive, but every
+     * message a human reads must quote what is actually in their file — telling
+     * someone to look for `"save"` when the line says `'Save'` costs them a grep.
+     */
+    text: string;
+}
+/** A single occurrence, with everything needed to rewrite it in place. */
+export interface NameHit {
+    /** The literal name as written in the source. */
+    name: string;
+    role?: string;
+    shape: NameShape;
+    site: NameSite;
+    /** The exact source substring of the call, used as a rewrite needle. */
+    call: string;
+    /** The same substring with the name literal replaced. */
+    rename: (newName: string) => string;
+}
+export declare const normalizeName: (s?: string) => string;
+/**
+ * The roles a name-anchored call can be checked against.
+ *
+ * `getByLabel` / `getByPlaceholder` do not name a role, but `extractInPage`
+ * derives an accessible name from `<label>`, then `placeholder`, then `name` —
+ * so both resolve against form-control roles and nothing else.
+ */
+export declare const SHAPE_ROLES: Partial<Record<NameShape, string[]>>;
+/**
+ * Every role `extractInPage` can emit — the complete vocabulary of a contract.
+ *
+ * A locator asking for anything else is asking about a part of the page the
+ * mapping never claimed to hold. `getByRole('heading', …)` is the common case:
+ * headings are not interactive, so no contract has ever contained one, and
+ * "absent from the contract" would mean "absent from the app" only if the two
+ * were the same thing. They are not, and a checker that forgets it reports every
+ * heading in the suite as broken.
+ */
+export declare const CONTRACT_ROLES: Set<string>;
+/**
+ * Shapes whose miss is *evidence* that a test targets nothing.
+ *
+ * The contract maps interactive elements only. `getByText('Terms of service')`
+ * may well point at a paragraph the mapping never saw, so its absence proves
+ * nothing — reporting it would be a false positive, and one false positive costs
+ * more than ten honest "inconclusive". A stated role, a label or a placeholder,
+ * on the other hand, can designate something the contract holds — provided the
+ * role is one the contract speaks (see `judgeable` below).
+ */
+export declare const AUTHORITATIVE_SHAPES: Set<NameShape>;
+/**
+ * Can this occurrence's absence from a contract be read as a finding?
+ *
+ * Both halves must hold: a shape that names an element the contract enumerates,
+ * AND a role the contract can actually contain.
+ */
+export declare function judgeable(site: {
+    shape: NameShape;
+    role?: string;
+}): boolean;
+/** Wrap `name` in a quote it does not contain; escape as a last resort. */
+export declare function quoteLiteral(name: string): string;
+/**
+ * Find every name-anchored locator in `text`.
+ *
+ * Overlapping shapes are resolved by source position: the first definition that
+ * claims a character range wins, which is why the two-argument `cy.contains` is
+ * declared before the one-argument form.
+ */
+export declare function scanNameLocators(text: string, file: string): NameHit[];
+/** Roles a hit can legitimately resolve to, or `null` when it constrains nothing. */
+export declare function candidateRoles(hit: {
+    role?: string;
+    shape: NameShape;
+}): string[] | null;

package/dist/nameLocators.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Static inventory of **name-anchored** locators — the other half of `ingest`.
+ *
+ * `usage.selectors` answers "which CSS selectors does the suite use?". That was
+ * only ever half the question: a suite written the modern way does not hold CSS
+ * at all. `page.getByRole('button', { name: 'Save' })`, `cy.contains('Save')` and
+ * `By.linkText('Save')` are anchored on the **accessible name**, so they survive
+ * every selector rewrite this tool can perform and break on the one kind of drift
+ * it used to classify as harmless: a rename.
+ *
+ * Same discipline as `ingest`: quoted literals in known call shapes, no
+ * execution, no AST, no network. A name built by concatenation or holding `${…}`
+ * is invisible here — and invisible to the rewrite below too, which is why it is
+ * skipped rather than guessed at.
+ *
+ * Framework parity is the point (guardrail: Playwright / Cypress / Selenium must
+ * all be first-class). Every shape below carries what the contract needs to check
+ * it: a name, and a role when the call states one.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTHORITATIVE_SHAPES = exports.CONTRACT_ROLES = exports.SHAPE_ROLES = exports.normalizeName = void 0;
+exports.judgeable = judgeable;
+exports.quoteLiteral = quoteLiteral;
+exports.scanNameLocators = scanNameLocators;
+exports.candidateRoles = candidateRoles;
+const normalizeName = (s) => (s == null ? '' : String(s)).toLowerCase().trim().replace(/\s+/g, ' ');
+exports.normalizeName = normalizeName;
+/**
+ * The roles a name-anchored call can be checked against.
+ *
+ * `getByLabel` / `getByPlaceholder` do not name a role, but `extractInPage`
+ * derives an accessible name from `<label>`, then `placeholder`, then `name` —
+ * so both resolve against form-control roles and nothing else.
+ */
+exports.SHAPE_ROLES = {
+    'playwright-label': ['textbox', 'combobox', 'checkbox', 'radio', 'slider'],
+    'playwright-placeholder': ['textbox', 'combobox'],
+    'selenium-linktext': ['link'],
+};
+/**
+ * Every role `extractInPage` can emit — the complete vocabulary of a contract.
+ *
+ * A locator asking for anything else is asking about a part of the page the
+ * mapping never claimed to hold. `getByRole('heading', …)` is the common case:
+ * headings are not interactive, so no contract has ever contained one, and
+ * "absent from the contract" would mean "absent from the app" only if the two
+ * were the same thing. They are not, and a checker that forgets it reports every
+ * heading in the suite as broken.
+ */
+exports.CONTRACT_ROLES = new Set([
+    'button', 'link', 'textbox', 'combobox', 'checkbox', 'radio', 'menuitem', 'tab', 'slider', 'generic',
+]);
+/**
+ * Shapes whose miss is *evidence* that a test targets nothing.
+ *
+ * The contract maps interactive elements only. `getByText('Terms of service')`
+ * may well point at a paragraph the mapping never saw, so its absence proves
+ * nothing — reporting it would be a false positive, and one false positive costs
+ * more than ten honest "inconclusive". A stated role, a label or a placeholder,
+ * on the other hand, can designate something the contract holds — provided the
+ * role is one the contract speaks (see `judgeable` below).
+ */
+exports.AUTHORITATIVE_SHAPES = new Set([
+    'playwright-role',
+    'playwright-label',
+    'playwright-placeholder',
+    'selenium-linktext',
+]);
+/**
+ * Can this occurrence's absence from a contract be read as a finding?
+ *
+ * Both halves must hold: a shape that names an element the contract enumerates,
+ * AND a role the contract can actually contain.
+ */
+function judgeable(site) {
+    if (!exports.AUTHORITATIVE_SHAPES.has(site.shape))
+        return false;
+    const roles = candidateRoles(site);
+    return roles !== null && roles.some((r) => exports.CONTRACT_ROLES.has(r));
+}
+const Q = "(['\"`])";
+/** Body of a quoted literal: no unescaped closing quote, no interpolation. */
+const BODY = '((?:(?!\\1)[^\\\\]|\\\\.)*?)';
+/**
+ * A literal we can read *and* rewrite. A template hole (`${…}`) makes the runtime
+ * value unknowable, and a regex argument (`{ name: /save/i }`) is not a literal at
+ * all — both are left to the human rather than guessed at.
+ */
+function literalName(raw) {
+    if (raw == null)
+        return null;
+    if (raw.includes('${'))
+        return null;
+    return raw.replace(/\\(['"`\\])/g, '$1');
+}
+/** Wrap `name` in a quote it does not contain; escape as a last resort. */
+function quoteLiteral(name) {
+    for (const q of ["'", '"', '`']) {
+        if (name.indexOf(q) === -1 && !(q === '`' && name.includes('${')))
+            return q + name + q;
+    }
+    return "'" + name.replace(/(['\\])/g, '\\$1') + "'";
+}
+/** Replace the `name: '…'` value inside an already-matched `getByRole(…)` call. */
+function renameRoleCall(call, newName) {
+    return call.replace(/(\bname\s*:\s*)(['"`])((?:(?!\2)[^\\]|\\.)*?)\2/, (_m, key) => key + quoteLiteral(newName));
+}
+/** Replace the Nth quoted literal of an already-matched call. */
+function renameNthLiteral(call, newName, nth) {
+    let seen = 0;
+    return call.replace(/(['"`])((?:(?!\1)[^\\]|\\.)*?)\1/g, (m, _q, _body) => {
+        seen++;
+        return seen === nth ? quoteLiteral(newName) : m;
+    });
+}
+/**
+ * Playwright and Testing Library are the same call under two spellings, and a
+ * Cypress suite reaches role-anchored locating only through the second
+ * (`@testing-library/cypress` → `cy.findByRole`). Matching the whole family
+ * rather than Playwright's spelling alone is what keeps the three frameworks at
+ * parity here — otherwise a Cypress suite would have no rewritable locator at
+ * all, and "parity" would mean "we read your file and did nothing".
+ *
+ * `getBy` / `findBy` / `queryBy`, with or without `All`.
+ */
+const V = '(?:get|find|query)(?:All)?By';
+/**
+ * Every needle starts at the `.` so the single-pass rewriter in `fixEngine` — which
+ * only probes at `.` and quote characters — can match it. That covers
+ * `page.getByRole`, `screen.findByRole`, `cy.findByRole`, `cy.contains`,
+ * `By.linkText` and any chained form. A bare destructured `getByText('…')` (React
+ * Testing Library) is inventoried but not rewritten: an accepted, reported miss.
+ */
+const SHAPES = [
+    {
+        shape: 'playwright-role',
+        re: new RegExp(`\\.${V}Role\\(\\s*${Q}([a-z]+)\\1\\s*,\\s*\\{[^{}]*?\\bname\\s*:\\s*(['"\`])((?:(?!\\3)[^\\\\]|\\\\.)*?)\\3[^{}]*\\}\\s*\\)`, 'g'),
+        nameGroup: 4,
+        roleGroup: 2,
+        literalIndex: 2,
+        role: true,
+    },
+    { shape: 'playwright-label', re: new RegExp(`\\.${V}Label(?:Text)?\\(\\s*${Q}${BODY}\\1`, 'g'), nameGroup: 2, literalIndex: 1 },
+    { shape: 'playwright-placeholder', re: new RegExp(`\\.${V}Placeholder(?:Text)?\\(\\s*${Q}${BODY}\\1`, 'g'), nameGroup: 2, literalIndex: 1 },
+    { shape: 'playwright-alt', re: new RegExp(`\\.${V}AltText\\(\\s*${Q}${BODY}\\1`, 'g'), nameGroup: 2, literalIndex: 1 },
+    { shape: 'playwright-title', re: new RegExp(`\\.${V}Title\\(\\s*${Q}${BODY}\\1`, 'g'), nameGroup: 2, literalIndex: 1 },
+    // `By` + `Text(` exactly, so `.getByLabelText(` and `.getByAltText(` are not
+    // candidates for it and the shapes above stay mutually exclusive.
+    { shape: 'playwright-text', re: new RegExp(`\\.${V}Text\\(\\s*${Q}${BODY}\\1`, 'g'), nameGroup: 2, literalIndex: 1 },
+    // `cy.contains(selector, text)` — the text is the SECOND literal. Checked before
+    // the one-argument form so the two-argument call is never read as `contains(text)`.
+    {
+        shape: 'cypress-contains',
+        re: new RegExp(`\\.contains\\(\\s*${Q}${BODY}\\1\\s*,\\s*(['"\`])((?:(?!\\3)[^\\\\]|\\\\.)*?)\\3`, 'g'),
+        nameGroup: 4,
+        literalIndex: 2,
+    },
+    { shape: 'cypress-contains', re: new RegExp(`\\.contains\\(\\s*${Q}${BODY}\\1\\s*\\)`, 'g'), nameGroup: 2, literalIndex: 1 },
+    { shape: 'selenium-linktext', re: new RegExp(`\\.(?:linkText|partialLinkText)\\(\\s*${Q}${BODY}\\1`, 'g'), nameGroup: 2, literalIndex: 1 },
+    // Selenium's constant form, shared by the Java / Python / C# bindings:
+    // `find_element(By.LINK_TEXT, "Save")`.
+    {
+        shape: 'selenium-linktext',
+        re: new RegExp(`\\.(?:LINK_TEXT|PARTIAL_LINK_TEXT)\\s*,\\s*${Q}${BODY}\\1`, 'g'),
+        nameGroup: 2,
+        literalIndex: 1,
+    },
+];
+/**
+ * Find every name-anchored locator in `text`.
+ *
+ * Overlapping shapes are resolved by source position: the first definition that
+ * claims a character range wins, which is why the two-argument `cy.contains` is
+ * declared before the one-argument form.
+ */
+function scanNameLocators(text, file) {
+    const lines = text.split('\n');
+    const lineStart = [];
+    let acc = 0;
+    for (const l of lines) {
+        lineStart.push(acc);
+        acc += l.length + 1;
+    }
+    const lineOf = (index) => {
+        let lo = 0;
+        let hi = lineStart.length - 1;
+        while (lo < hi) {
+            const mid = (lo + hi + 1) >> 1;
+            if (lineStart[mid] <= index)
+                lo = mid;
+            else
+                hi = mid - 1;
+        }
+        return lo + 1;
+    };
+    const claimed = [];
+    const out = [];
+    for (const def of SHAPES) {
+        def.re.lastIndex = 0;
+        let m;
+        while ((m = def.re.exec(text)) !== null) {
+            const start = m.index;
+            const end = start + m[0].length;
+            if (claimed.some(([s, e]) => start < e && end > s))
+                continue;
+            const name = literalName(m[def.nameGroup]);
+            if (name == null || name.trim() === '')
+                continue;
+            claimed.push([start, end]);
+            const call = m[0];
+            const shape = def.shape;
+            const role = def.roleGroup ? m[def.roleGroup] : undefined;
+            const literalIndex = def.literalIndex;
+            out.push({
+                name,
+                role,
+                shape,
+                site: { file, line: lineOf(start), shape, ...(role ? { role } : {}), text: name },
+                call,
+                rename: (newName) => shape === 'playwright-role'
+                    ? renameRoleCall(call, newName)
+                    : renameNthLiteral(call, newName, literalIndex),
+            });
+        }
+    }
+    return out.sort((a, b) => a.site.line - b.site.line);
+}
+/** Roles a hit can legitimately resolve to, or `null` when it constrains nothing. */
+function candidateRoles(hit) {
+    if (hit.role)
+        return [hit.role];
+    return exports.SHAPE_ROLES[hit.shape] ?? null;
+}
+//# sourceMappingURL=nameLocators.js.map

package/dist/nameLocators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameLocators.js","sourceRoot":"","sources":["../src/nameLocators.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-qa/self-healing",
-  "version": "1.5.8",
+  "version": "1.6.2",
   "description": "Local-first self-healing for UI tests: a local MCP server + CLI that map your app's pages to a role/name/selector contract, diff selector drift (PASS/FIX/BLOCK), and apply deterministic fixes to Cypress/Playwright/Selenium tests. Runs on your machine — nothing leaves it.",
   "keywords": [
     "self-healing",