@vijaypjavvadi/bdd2pw 1.0.0

package/dist/transformers/locatorPicker.js

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * Locator picker — given an `ElementIR` and the full snapshot context,
+ * choose the most stable Playwright locator API.
+ *
+ * Priority chain (FR-6):
+ *   getByRole > getByLabel > getByPlaceholder > getByTestId > getByText
+ *   > locator(css) > locator(xpath)
+ *
+ * The output `LocatorChoice` is then handed to `@vijaypjavvadi/pw-emit`
+ * which renders it into TS. We never render here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickLocator = pickLocator;
+exports.dedupeLocators = dedupeLocators;
+const naming_1 = require("../utils/naming");
+/**
+ * Pick the highest-priority unique locator for `element`. Uniqueness is
+ * checked against `allElements` — if multiple elements would match the
+ * candidate locator, we fall down the chain.
+ */
+function pickLocator(element, allElements) {
+    const fieldName = synthFieldName(element);
+    // 1. getByRole + accessible name — most stable
+    if (element.role && element.name) {
+        const rivals = allElements.filter((e) => e !== element && e.role === element.role && e.name === element.name);
+        return {
+            api: "getByRole",
+            args: `${JSON.stringify(element.role)}, { name: ${JSON.stringify(element.name)} }`,
+            fieldName,
+            source: element,
+            confidence: rivals.length === 0 ? "unique" : "ambiguous",
+        };
+    }
+    // 2. getByLabel — for form inputs with associated <label>
+    if (element.label) {
+        const rivals = allElements.filter((e) => e !== element && e.label === element.label);
+        return {
+            api: "getByLabel",
+            args: JSON.stringify(element.label),
+            fieldName,
+            source: element,
+            confidence: rivals.length === 0 ? "unique" : "ambiguous",
+        };
+    }
+    // 3. getByPlaceholder
+    if (element.placeholder) {
+        const rivals = allElements.filter((e) => e !== element && e.placeholder === element.placeholder);
+        return {
+            api: "getByPlaceholder",
+            args: JSON.stringify(element.placeholder),
+            fieldName,
+            source: element,
+            confidence: rivals.length === 0 ? "unique" : "ambiguous",
+        };
+    }
+    // 4. getByTestId — when the app uses data-testid (best stability across releases)
+    if (element.testId) {
+        const rivals = allElements.filter((e) => e !== element && e.testId === element.testId);
+        return {
+            api: "getByTestId",
+            args: JSON.stringify(element.testId),
+            fieldName,
+            source: element,
+            confidence: rivals.length === 0 ? "unique" : "ambiguous",
+        };
+    }
+    // 5. getByText — last semantic choice.
+    //    Skipped for status regions (error / alert / notification banners),
+    //    where text content is volatile (changes per scenario) but the id
+    //    is stable. Without this skip, `<div id="error">{current message}</div>`
+    //    becomes `getByText("{current message}")` — which then breaks any
+    //    assertion that expects a DIFFERENT error string.
+    const isStatusRegion = element.cssSelector !== undefined && STATUS_REGION_RE.test(element.cssSelector);
+    if (!isStatusRegion &&
+        element.text &&
+        element.text.trim().length > 0 &&
+        element.text.length < 80) {
+        const rivals = allElements.filter((e) => e !== element && e.text === element.text);
+        return {
+            api: "getByText",
+            args: JSON.stringify(element.text),
+            fieldName,
+            source: element,
+            confidence: rivals.length === 0 ? "unique" : "ambiguous",
+        };
+    }
+    // 6. CSS selector
+    if (element.cssSelector) {
+        return {
+            api: "locator",
+            args: JSON.stringify(element.cssSelector),
+            fieldName,
+            source: element,
+            confidence: "fallback",
+        };
+    }
+    // 7. xpath — last resort
+    if (element.xpath) {
+        return {
+            api: "locator",
+            args: JSON.stringify(`xpath=${element.xpath}`),
+            fieldName,
+            source: element,
+            confidence: "fallback",
+        };
+    }
+    // Nothing usable — emit a tag-only locator and flag as fallback
+    return {
+        api: "locator",
+        args: JSON.stringify(element.tag),
+        fieldName,
+        source: element,
+        confidence: "fallback",
+    };
+}
+/**
+ * Pattern for "status region" elements — error / alert / notification banners.
+ * When the CSS id (or class) matches this, we prefer the id-derived field
+ * name over the text-derived one, because:
+ *   1. The text content is incidental — `<div id="error">` shows different
+ *      copy depending on what failed, but it's still "the error region".
+ *   2. Field names like `yourUsernameIsInvalid` (text-derived) defeat the
+ *      step matcher's "I should see an error message" rule, which looks
+ *      for fields with `Alert`/`Error`/`Message` suffixes.
+ * Naming a status region after its id (`error`, `errorMessage`,
+ * `notificationBanner`) is what a test author would write by hand.
+ */
+const STATUS_REGION_RE = /(error|alert|message|warning|success|notification|status)/i;
+/**
+ * Synthesise a camelCase TS field name for an element.
+ *
+ * Priority order for the *base name*:
+ *   0. CSS id when it matches STATUS_REGION_RE — special case so error
+ *      banners get stable names regardless of their current text content.
+ *   1. element.name (accessible name)
+ *   2. element.label
+ *   3. element.placeholder
+ *   4. element.testId
+ *   5. element.text (first 40 chars)
+ *   6. CSS id from element.cssSelector (`#username` → `username`)
+ *   7. CSS class from element.cssSelector (`.foo-bar` → `fooBar`)
+ *   8. `<role|tag>Element` last resort
+ *
+ * Then appends a role-derived suffix if it's not already there:
+ *   "username" + role:textbox → "usernameInput"
+ *   "submit"   + role:button  → "submitButton"
+ */
+function synthFieldName(element) {
+    // 0. Status region special case
+    const idDerived = cssSelectorToName(element.cssSelector);
+    if (idDerived && STATUS_REGION_RE.test(idDerived)) {
+        const cleaned = idDerived.replace(/[^a-zA-Z0-9 ]/g, " ").trim();
+        return (0, naming_1.camelCase)(cleaned) || "errorRegion";
+    }
+    const baseName = element.name ??
+        element.label ??
+        element.placeholder ??
+        element.testId ??
+        element.text?.slice(0, 40) ??
+        idDerived ??
+        `${element.role ?? element.tag}Element`;
+    const cleaned = baseName.replace(/[^a-zA-Z0-9 ]/g, " ").trim();
+    let fieldName = (0, naming_1.camelCase)(cleaned) || "element";
+    const suffix = roleToSuffix(element.role, element.tag);
+    if (suffix && !fieldName.toLowerCase().endsWith(suffix.toLowerCase())) {
+        fieldName += suffix;
+    }
+    return fieldName;
+}
+/**
+ * Best-effort name extraction from a CSS selector. Handles common shapes:
+ *   #username       → "username"
+ *   .foo-bar        → "foo bar"
+ *   div#main        → "main"
+ *   a.wp-block-btn  → "wp block btn"
+ * Returns undefined for selectors with no usable id/class.
+ */
+function cssSelectorToName(selector) {
+    if (!selector)
+        return undefined;
+    // Prefer #id over .class
+    const idMatch = selector.match(/#([a-zA-Z][\w-]*)/);
+    if (idMatch)
+        return idMatch[1].replace(/-/g, " ");
+    const classMatch = selector.match(/\.([a-zA-Z][\w-]*)/);
+    if (classMatch)
+        return classMatch[1].replace(/-/g, " ");
+    return undefined;
+}
+function roleToSuffix(role, tag) {
+    switch (role) {
+        case "button":
+            return "Button";
+        case "link":
+            return "Link";
+        case "textbox":
+        case "searchbox":
+            return "Input";
+        case "checkbox":
+            return "Checkbox";
+        case "radio":
+            return "Radio";
+        case "combobox":
+        case "listbox":
+            return "Select";
+        case "heading":
+            return "Heading";
+        case "alert":
+            return "Alert";
+        case "img":
+            return "Image";
+        default:
+            break;
+    }
+    switch (tag) {
+        case "input":
+            return "Input";
+        case "select":
+            return "Select";
+        case "textarea":
+            return "Textarea";
+        case "a":
+            return "Link";
+        case "button":
+            return "Button";
+        default:
+            return "";
+    }
+}
+/**
+ * Dedupe a list of locator choices.
+ *
+ *   1. **By locator identity (api + args).** When two `LocatorChoice`s
+ *      resolve to the same Playwright call (e.g. a `<label>` and the
+ *      `<input>` it labels both produce `getByLabel('Username')`), keep
+ *      only the FIRST. Without this, the live scanner emits
+ *      `username = page.getByLabel('Username')` AND
+ *      `usernameInput = page.getByLabel('Username')` — two fields, one
+ *      element, confusing for tests and noisy in the POM.
+ *      The kept entry uses the LONGER fieldName when names differ —
+ *      `usernameInput` is more useful than `username` because the
+ *      step-matcher's preferredSuffix logic looks for `*Input`.
+ *
+ *   2. **By field name collision.** If two elements legitimately deserve
+ *      different `LocatorChoice`s but happen to synthesise the same
+ *      fieldName, suffix the later one with `2`, `3`, … so emitted TS
+ *      stays valid.
+ *
+ * Stable-sorted by input order otherwise.
+ */
+function dedupeLocators(choices) {
+    // Pass 1: collapse by locator identity. Picks the better field name.
+    const byLocator = new Map();
+    for (const c of choices) {
+        const key = `${c.api}::${c.args}`;
+        const existing = byLocator.get(key);
+        if (!existing) {
+            byLocator.set(key, c);
+            continue;
+        }
+        // Prefer the longer / more descriptive field name (usernameInput > username)
+        if (c.fieldName.length > existing.fieldName.length) {
+            byLocator.set(key, c);
+        }
+    }
+    const collapsed = Array.from(byLocator.values());
+    // Pass 2: resolve any remaining fieldName collisions with a numeric suffix.
+    const seen = new Map();
+    const out = [];
+    for (const c of collapsed) {
+        const count = seen.get(c.fieldName) ?? 0;
+        seen.set(c.fieldName, count + 1);
+        if (count === 0) {
+            out.push(c);
+        }
+        else {
+            out.push({ ...c, fieldName: `${c.fieldName}${count + 1}` });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=locatorPicker.js.map

package/dist/transformers/locatorPicker.js.map

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

package/dist/transformers/pomResolver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * POM resolver — given a requested page name and the existing POM map from
+ * the repo scanner, decide reuse / augment / create. See docs/ARCHITECTURE.md §2.
+ *
+ * Decision table (referenced fields = field names the matched steps need):
+ *   ┌────────────┬──────────────────────────────┬──────────┐
+ *   │ POM exists │ all referenced fields present│ decision │
+ *   ├────────────┼──────────────────────────────┼──────────┤
+ *   │     no     │      n/a                     │ CREATE   │
+ *   │     yes    │      yes                     │ REUSE    │
+ *   │     yes    │      no                      │ AUGMENT  │
+ *   └────────────┴──────────────────────────────┴──────────┘
+ */
+import type { PageObjectIR } from "../types";
+export type PomDecision = "REUSE" | "AUGMENT" | "CREATE";
+export interface ResolvePomInput {
+    requestedName: string;
+    existing: Map<string, PageObjectIR>;
+    /** Element field names referenced by the matched steps. */
+    referencedFields: string[];
+}
+export interface ResolvePomResult {
+    decision: PomDecision;
+    existing?: PageObjectIR;
+    /** Field names referenced but not yet present on the existing POM. */
+    missingFields: string[];
+}
+export declare function resolvePom(input: ResolvePomInput): ResolvePomResult;

package/dist/transformers/pomResolver.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * POM resolver — given a requested page name and the existing POM map from
+ * the repo scanner, decide reuse / augment / create. See docs/ARCHITECTURE.md §2.
+ *
+ * Decision table (referenced fields = field names the matched steps need):
+ *   ┌────────────┬──────────────────────────────┬──────────┐
+ *   │ POM exists │ all referenced fields present│ decision │
+ *   ├────────────┼──────────────────────────────┼──────────┤
+ *   │     no     │      n/a                     │ CREATE   │
+ *   │     yes    │      yes                     │ REUSE    │
+ *   │     yes    │      no                      │ AUGMENT  │
+ *   └────────────┴──────────────────────────────┴──────────┘
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePom = resolvePom;
+function resolvePom(input) {
+    const { requestedName, existing, referencedFields } = input;
+    const found = existing.get(requestedName);
+    if (!found) {
+        return {
+            decision: "CREATE",
+            missingFields: [...new Set(referencedFields)],
+        };
+    }
+    const presentFieldNames = new Set(found.fields.map((f) => f.fieldName));
+    const missingFields = [
+        ...new Set(referencedFields.filter((f) => !presentFieldNames.has(f))),
+    ];
+    if (missingFields.length === 0) {
+        return { decision: "REUSE", existing: found, missingFields: [] };
+    }
+    return { decision: "AUGMENT", existing: found, missingFields };
+}
+//# sourceMappingURL=pomResolver.js.map

package/dist/transformers/pomResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pomResolver.js","sourceRoot":"","sources":["../../src/transformers/pomResolver.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAoBH,gCAqBC;AArBD,SAAgB,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAE1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,MAAM,aAAa,GAAG;QACpB,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KACtE,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AACjE,CAAC"}

package/dist/transformers/stepMatcher.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Step matcher — Gherkin step text → POM method call / expect() assertion.
+ *
+ * Phase 1: rule-based only. The rule table covers the standard verb set:
+ *   - navigation:  "I am on / navigate to / open / visit / go to"
+ *   - input:       "I enter / type / fill X (in)to <field>"
+ *   - selection:   "I select <option> from <select>"
+ *   - clicking:    "I click / press / tap <button>"
+ *   - check/uncheck: "I check / uncheck <checkbox>"
+ *   - visibility:  "I (should) see / I should NOT see"
+ *   - text equals: "I should see <X> in <field>" / "<field> should contain <X>"
+ *   - URL:         "the URL should be / contain"
+ *
+ * LLM fallback for unmatched steps is wired but defaults to off; falls
+ * through to a `// TODO` warning. See docs/ARCHITECTURE.md §2 (LLM branch).
+ */
+import type { PageObjectIR, ScenarioIR, StepBinding, StepIR } from "../types";
+export interface MatchStepsInput {
+    scenarios: ScenarioIR[];
+    pom: PageObjectIR;
+    /** camelCase variable name for the POM in the spec (e.g. `loginPage`). */
+    pageVar: string;
+    llmProvider?: "anthropic" | "openai" | "gemini";
+    governanceUrl?: string;
+}
+/**
+ * Match every step in every scenario to a POM call / assertion / TODO.
+ * Background steps are also threaded through if the orchestrator passes
+ * them as a synthetic scenario.
+ */
+export declare function matchSteps(input: MatchStepsInput): Promise<StepBinding[][]>;
+/**
+ * Try every rule in priority order; return the first match.
+ * Falls through to a warning binding when nothing matches.
+ */
+export declare function matchStep(step: StepIR, pom: PageObjectIR, pageVar: string): StepBinding;