@ia-qa/self-healing 1.5.7 → 1.6.1

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.7",
+  "version": "1.6.1",
   "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",