@vijaypjavvadi/bdd2pw 1.0.0

package/dist/transformers/stepMatcher.js

@@ -0,0 +1,461 @@
+"use strict";
+/**
+ * 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).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchSteps = matchSteps;
+exports.matchStep = matchStep;
+const naming_1 = require("../utils/naming");
+/**
+ * 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.
+ */
+async function matchSteps(input) {
+    const out = [];
+    for (const scenario of input.scenarios) {
+        out.push(scenario.steps.map((step) => matchStep(step, input.pom, input.pageVar)));
+    }
+    return out;
+}
+/**
+ * Try every rule in priority order; return the first match.
+ * Falls through to a warning binding when nothing matches.
+ */
+function matchStep(step, pom, pageVar) {
+    for (const rule of RULES) {
+        const m = step.text.match(rule.pattern);
+        if (m) {
+            const result = rule.build(m, step, pom, pageVar);
+            if (result)
+                return result;
+        }
+    }
+    return {
+        step,
+        warning: `no rule matched: "${step.keyword} ${step.text}"`,
+    };
+}
+// --- Rule registry ---------------------------------------------------------
+/**
+ * Subject prefix accepted at the start of a step. Real-world Cucumber suites
+ * mix several conventions:
+ *   "I click the login button"           — first-person (most common)
+ *   "user clicks the login button"       — third-person (selenium14, etc.)
+ *   "User clicks the login button"       — capitalised
+ *   "the user clicks the login button"   — definite article
+ *
+ * All rules use this prefix instead of a hard-coded `^I ` so the same rule
+ * matches all four shapes. Verbs are normalised on the rule side (no need
+ * to also accept "clicks" + "click" — the regex below has both).
+ */
+const SUBJ = "(?:I|user|User|the user|the User)";
+const RULES = [
+    // 1. Navigation: "I am on the login page" / "I navigate to /foo"
+    {
+        pattern: new RegExp(`^(?:${SUBJ} )?(?:am on|navigate to|navigates? to|open|opens?|visit|visits?|go to|goes? to|am at|is at) (?:the )?(?:.+?\\s+)?["']?([^"']+?)["']?(?: page)?$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            // The non-greedy `(?:.+?\s+)?` before the captured target lets us
+            // handle both shapes:
+            //   "I navigate to the login page"        → m[1] = "login"
+            //   "User navigate to Login Page for Admin \"https://x.com/login\"" → m[1] = "https://x.com/login"
+            const target = m[1].trim();
+            const hasGoto = pom.methods.some((mm) => mm.name === "goto");
+            if (hasGoto) {
+                return {
+                    step,
+                    pomCall: { page: pageVar, method: "goto", args: [] },
+                };
+            }
+            return {
+                step,
+                pomCall: { page: pageVar, method: "goto", args: [JSON.stringify(target)] },
+            };
+        },
+    },
+    // 2a. Input with explicit value + field: 'I enter "alice" in(to) the username field'
+    {
+        pattern: new RegExp(`^${SUBJ} (?:enter|enters|type|types|fill|fills) ["']([^"']*)["'] (?:in|into|in to) (?:the )?(.+?)(?: field| input| box)?$`, "i"),
+        build: (m, step, pom, pageVar) => fillFieldBinding(step, pom, pageVar, m[2].trim(), m[1]),
+    },
+    // 2c. Compound input: 'user enter email "X" password "Y"'.
+    //     Common in real-world Cucumber suites (e.g. selenium14/LoginCMS).
+    //     Emits a `customBody` with one fill() per (field, value) pair.
+    //     Pattern: SUBJ verb FIELD1 "VAL1" FIELD2 "VAL2" [FIELD3 "VAL3" ...]
+    //     The `(?:and )?` between pairs is optional ("email X password Y" or
+    //     "email X and password Y").
+    {
+        pattern: new RegExp(`^${SUBJ} (?:enter|enters|type|types|fill|fills) (?:(?:the )?(\\w+) ["']([^"']*)["'](?: and| and the| ,)?\\s*){2,}$`, "i"),
+        build: (_m, step, pom, pageVar) => {
+            // Re-extract all (field, value) pairs from the step text — the regex
+            // above only captures the LAST match in the iteration, so we need a
+            // second pass with `g` flag to get all of them.
+            const pairRe = /(?:the )?(\w+)\s+["']([^"']*)["']/g;
+            const pairs = [];
+            let pm;
+            // Strip the leading subject + verb to avoid false matches
+            const tail = step.text.replace(new RegExp(`^${SUBJ} (?:enter|enters|type|types|fill|fills) `, "i"), "");
+            while ((pm = pairRe.exec(tail)) !== null) {
+                pairs.push({ field: pm[1], value: pm[2] });
+            }
+            if (pairs.length < 2)
+                return null;
+            const lines = [];
+            for (const { field, value } of pairs) {
+                const f = findField(pom, field, ["Input", "Field", "Box", "Textbox"]);
+                if (!f) {
+                    // Couldn't resolve one of the fields — bail out so the step
+                    // becomes a TODO instead of a half-correct emission.
+                    return null;
+                }
+                lines.push(`await ${pageVar}.${f.fieldName}.fill(${JSON.stringify(value)});`);
+            }
+            return { step, customBody: lines.join("\n") };
+        },
+    },
+    // 2b. Reversed word order: 'I enter username "alice"' / 'I type password "secret"'
+    //     Common in real-world Cucumber suites (e.g. test/test/login.feature).
+    //     Also handles empty values: `I enter username ""`.
+    {
+        pattern: new RegExp(`^${SUBJ} (?:enter|enters|type|types|fill|fills) (?:the )?(.+?) ["']([^"']*)["']$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            // If the captured "field" is itself a quoted value already handled by 2a,
+            // skip — but 2a's pattern wouldn't end here so 2b is safe.
+            return fillFieldBinding(step, pom, pageVar, m[1].trim(), m[2]);
+        },
+    },
+    // 3. Click: "I click the login button" / "I press 'Sign in'"
+    //    Captures the explicit role suffix (button/link/icon) so findField
+    //    can restrict to fields with the matching suffix. Without this,
+    //    "click the login button" would match `testLoginHeading` via the
+    //    generic substring fallback.
+    {
+        pattern: new RegExp(`^(?:${SUBJ} )?(?:click|clicks|press|presses|tap|taps)(?: on)? (?:the )?["']?([^"']+?)["']?(?:\\s+(button|link|icon|tab))?$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const hint = m[1].trim();
+            const explicitRole = m[2]; // 'button' | 'link' | 'icon' | 'tab' | undefined
+            const suffixes = explicitRole
+                ? [capitalize(explicitRole)]
+                : ["Button", "Link"];
+            const field = findField(pom, hint, suffixes);
+            if (!field)
+                return null;
+            const method = findOrSynthMethod(pom, `click${capitalize(field.fieldName)}`, []);
+            if (method && method.kind === "existing") {
+                return { step, pomCall: { page: pageVar, method: method.name, args: [] } };
+            }
+            return {
+                step,
+                pomCall: { page: pageVar, method: `${field.fieldName}.click`, args: [] },
+            };
+        },
+    },
+    // 4. Selection: 'I select "USA" from (the) country dropdown'
+    {
+        pattern: new RegExp(`^${SUBJ} (?:select|selects) ["']([^"']+)["'] from (?:the )?(.+?)(?: dropdown| select)?$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const value = m[1];
+            const hint = m[2].trim();
+            const field = findField(pom, hint, ["Select", "Dropdown"]);
+            if (!field)
+                return null;
+            return {
+                step,
+                pomCall: {
+                    page: pageVar,
+                    method: `${field.fieldName}.selectOption`,
+                    args: [JSON.stringify(value)],
+                },
+            };
+        },
+    },
+    // 5. Check / uncheck checkbox
+    {
+        pattern: new RegExp(`^${SUBJ} (check|checks|uncheck|unchecks) (?:the )?(.+?)(?: checkbox)?$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const verb = m[1].toLowerCase() === "check" ? "check" : "uncheck";
+            const hint = m[2].trim();
+            const field = findField(pom, hint, ["Checkbox", "Toggle"]);
+            if (!field)
+                return null;
+            return {
+                step,
+                pomCall: { page: pageVar, method: `${field.fieldName}.${verb}`, args: [] },
+            };
+        },
+    },
+    // 6. Visibility: "I (should) see <X>" — assertion
+    {
+        pattern: new RegExp(`^${SUBJ} (?:should )?(?:see|sees) (?:the )?["']?([^"']+?)["']?$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const hint = m[1].trim();
+            const field = findField(pom, hint, []);
+            const locatorExpr = field
+                ? `${pageVar}.${field.fieldName}`
+                : `${pageVar}.page.getByText(${JSON.stringify(hint)})`;
+            return {
+                step,
+                assertion: { locator: locatorExpr, matcher: "toBeVisible" },
+            };
+        },
+    },
+    // 7. Negative visibility: "I should NOT see <X>"
+    {
+        pattern: new RegExp(`^${SUBJ} should not see (?:the )?["']?([^"']+?)["']?$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const hint = m[1].trim();
+            const field = findField(pom, hint, []);
+            const locatorExpr = field
+                ? `${pageVar}.${field.fieldName}`
+                : `${pageVar}.page.getByText(${JSON.stringify(hint)})`;
+            return {
+                step,
+                assertion: { locator: locatorExpr, matcher: "toBeHidden" },
+            };
+        },
+    },
+    // 8. Error message catch-all (must run BEFORE the generic text-equality
+    //    rule, otherwise rule 9 below would consume "I should see the/an error
+    //    message X" with a toHaveText matcher and a non-unique getByText fallback.
+    //    Accepts both "the error message" and "an error message" wordings.
+    //    The locator preference order goes Alert > Error > Message — when the
+    //    page has a dedicated alert/error field, use it instead of generic text.
+    {
+        pattern: new RegExp(`^${SUBJ} should see (?:the|an|a) error(?: message)? ["']([^"']+)["']$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const expected = m[1];
+            const field = findField(pom, "errorMessage", ["Alert", "Error", "Message"]) ??
+                findField(pom, "error", ["Alert", "Error"]);
+            const locatorExpr = field
+                ? `${pageVar}.${field.fieldName}`
+                : `${pageVar}.page.getByText(${JSON.stringify(expected)})`;
+            return {
+                step,
+                assertion: {
+                    locator: locatorExpr,
+                    matcher: "toContainText",
+                    expected: JSON.stringify(expected),
+                },
+            };
+        },
+    },
+    // 9a. Text "containing" / "with text" — substring match.
+    //     MUST run before rule 9b (exact text), otherwise:
+    //       "I should see a welcome message containing 'Congratulations'"
+    //     would match rule 9b with hint="a welcome message containing" and
+    //     emit toHaveText("Congratulations") — which fails when the actual
+    //     element text is "Congratulations student. You successfully logged in!".
+    {
+        pattern: new RegExp(`^${SUBJ} should see (?:the |a |an )?(.+?) (?:containing|that contains?|with(?: the)? text|having text) ["']([^"']+)["']$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const hint = m[1].trim();
+            const expected = m[2];
+            const field = findField(pom, hint, ["Message", "Heading", "Text", "Label"]);
+            const locatorExpr = field
+                ? `${pageVar}.${field.fieldName}`
+                : `${pageVar}.page.getByText(${JSON.stringify(expected)})`;
+            return {
+                step,
+                assertion: {
+                    locator: locatorExpr,
+                    matcher: "toContainText",
+                    expected: JSON.stringify(expected),
+                },
+            };
+        },
+    },
+    // 9b. Text equality: 'I should see the welcome message "Welcome, Alice"'
+    //     Strict toHaveText — the entire element text must equal the expected
+    //     value. Use rule 9a above for substring semantics.
+    {
+        pattern: new RegExp(`^${SUBJ} should see (?:the |a |an )?(.+?) ["']([^"']+)["']$`, "i"),
+        build: (m, step, pom, pageVar) => {
+            const hint = m[1].trim();
+            const expected = m[2];
+            const field = findField(pom, hint, ["Message", "Heading", "Text", "Label"]);
+            const locatorExpr = field
+                ? `${pageVar}.${field.fieldName}`
+                : `${pageVar}.page.getByText(${JSON.stringify(expected)})`;
+            return {
+                step,
+                assertion: {
+                    locator: locatorExpr,
+                    matcher: "toHaveText",
+                    expected: JSON.stringify(expected),
+                },
+            };
+        },
+    },
+    // 10. Remain on page: "I should remain on the login page"
+    {
+        pattern: new RegExp(`^${SUBJ} should remain on (?:the )?(.+?)(?: page)?$`, "i"),
+        build: (m, step, _pom, pageVar) => {
+            const target = m[1].trim();
+            return {
+                step,
+                assertion: {
+                    locator: `${pageVar}.page`,
+                    matcher: "toHaveURL",
+                    expected: `new RegExp(${JSON.stringify(target.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))})`,
+                },
+            };
+        },
+    },
+    // 11. Redirect: "I should be redirected to the logged-in page" / "to /dashboard"
+    //     Asserts URL changed away from the previous page. Best-effort: regex matches
+    //     the target token in the URL.
+    {
+        pattern: new RegExp(`^${SUBJ} (?:should be |am |is )?redirected to (?:the )?(.+?)(?: page)?$`, "i"),
+        build: (m, step, _pom, pageVar) => {
+            const target = m[1].trim();
+            const slug = target.replace(/\s+/g, "[-_/]?");
+            return {
+                step,
+                assertion: {
+                    locator: `${pageVar}.page`,
+                    matcher: "toHaveURL",
+                    expected: `new RegExp(${JSON.stringify(slug)})`,
+                },
+            };
+        },
+    },
+    // 12. Attribute check: 'the password field should be of type "password"'
+    {
+        pattern: /^the (.+?) field should (?:be of type|have type) ["']([^"']+)["']$/i,
+        build: (m, step, pom, pageVar) => {
+            const fieldHint = m[1].trim();
+            const expected = m[2];
+            const field = findField(pom, fieldHint, ["Input", "Field", "Box", "Textbox"]);
+            const locatorExpr = field
+                ? `${pageVar}.${field.fieldName}`
+                : `${pageVar}.page.locator(${JSON.stringify(`[name="${fieldHint}"]`)})`;
+            return {
+                step,
+                assertion: {
+                    locator: locatorExpr,
+                    matcher: "toHaveAttribute",
+                    expected: `"type", ${JSON.stringify(expected)}`,
+                },
+            };
+        },
+    },
+    // 13. URL prefix/contains: 'the current URL should start with "https"'
+    {
+        pattern: /^the (?:current )?URL should (?:start with|begin with|contain|include) ["']([^"']+)["']$/i,
+        build: (m, step, _pom, pageVar) => {
+            const expected = m[1];
+            // start-with → anchored regex; contain → unanchored
+            const verb = step.text.toLowerCase();
+            const isPrefix = verb.includes("start with") || verb.includes("begin with");
+            const escaped = expected.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            return {
+                step,
+                assertion: {
+                    locator: `${pageVar}.page`,
+                    matcher: "toHaveURL",
+                    expected: `new RegExp(${JSON.stringify(isPrefix ? "^" + escaped : escaped)})`,
+                },
+            };
+        },
+    },
+];
+/**
+ * Shared helper for both word orders of the input-into-field rule.
+ * Picks an existing `fill<Field>` method if defined, else uses a direct locator call.
+ */
+function fillFieldBinding(step, pom, pageVar, fieldHint, value) {
+    const field = findField(pom, fieldHint, ["Input", "Field", "Box", "Textbox"]);
+    if (!field)
+        return null;
+    const method = findOrSynthMethod(pom, `fill${capitalize(field.fieldName)}`, [
+        { name: "v", type: "string" },
+    ]);
+    if (method && method.kind === "existing") {
+        return {
+            step,
+            pomCall: { page: pageVar, method: method.name, args: [JSON.stringify(value)] },
+        };
+    }
+    return {
+        step,
+        pomCall: {
+            page: pageVar,
+            method: `${field.fieldName}.fill`,
+            args: [JSON.stringify(value)],
+        },
+    };
+}
+// --- Helpers ---------------------------------------------------------------
+/**
+ * Find a POM field whose name reasonably matches `hint`.
+ *
+ * Resolution order:
+ *   1. Exact case-insensitive match.
+ *   2. norm + each preferred suffix (so "login" + ["Button"] → "loginButton").
+ *   3. If preferredSuffixes is non-empty: ONLY consider fields whose name
+ *      ends with one of those suffixes. Within that subset:
+ *      a. Substring match (hint inside fieldName, or vice versa)
+ *      b. If exactly one field matches the suffix at all, return it
+ *         (e.g. "I click the login button" with one *Button on the page →
+ *         that button, regardless of name)
+ *   4. Generic substring match across all fields (last resort).
+ *
+ * Fixes the bug where "login button" matched `testLoginHeading` because
+ * "login" is a substring of "testloginheading" — even though there was a
+ * perfectly good `submitButton` on the same page.
+ */
+function findField(pom, hint, preferredSuffixes) {
+    const norm = (0, naming_1.camelCase)(hint.replace(/[^a-zA-Z0-9 ]/g, ""));
+    const lower = norm.toLowerCase();
+    // 1. Exact match
+    let f = pom.fields.find((x) => x.fieldName.toLowerCase() === lower);
+    if (f)
+        return f;
+    // 2. norm + each preferred suffix
+    for (const suf of preferredSuffixes) {
+        const target = (norm + suf).toLowerCase();
+        f = pom.fields.find((x) => x.fieldName.toLowerCase() === target);
+        if (f)
+            return f;
+    }
+    // 3. Suffix-constrained matching — prefer same-role fields
+    if (preferredSuffixes.length > 0) {
+        const suffixMatched = pom.fields.filter((x) => preferredSuffixes.some((s) => x.fieldName.toLowerCase().endsWith(s.toLowerCase())));
+        // 3a. substring match within the suffix-matched subset
+        f = suffixMatched.find((x) => x.fieldName.toLowerCase().includes(lower) || lower.includes(x.fieldName.toLowerCase()));
+        if (f)
+            return f;
+        // 3b. exactly one suffix-matched field on the whole page → use it
+        if (suffixMatched.length === 1)
+            return suffixMatched[0];
+    }
+    // 4. Generic substring match (last resort, may hit cross-role fields)
+    f = pom.fields.find((x) => x.fieldName.toLowerCase().includes(lower));
+    if (f)
+        return f;
+    f = pom.fields.find((x) => lower.includes(x.fieldName.toLowerCase()));
+    return f;
+}
+function findOrSynthMethod(pom, desiredName, _params) {
+    const existing = pom.methods.find((m) => m.name === desiredName);
+    if (existing)
+        return { kind: "existing", name: existing.name };
+    return { kind: "synth", name: desiredName };
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=stepMatcher.js.map

package/dist/transformers/stepMatcher.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Intermediate representation (IR) shared across parser, transformers, and emitters.
+ * See docs/SCOPE.md §13 for the canonical shape.
+ */
+export interface FeatureIR {
+    name: string;
+    description?: string;
+    background?: StepIR[];
+    scenarios: ScenarioIR[];
+    tags: string[];
+    sourceFile: string;
+}
+export interface ScenarioIR {
+    name: string;
+    steps: StepIR[];
+    /** Populated for `Scenario Outline` — one row per `Examples:` entry. */
+    examples?: Record<string, string>[];
+    tags: string[];
+}
+export interface StepIR {
+    keyword: "Given" | "When" | "Then" | "And" | "But";
+    text: string;
+    /** Doc string or data table argument when present. */
+    argument?: string | string[][];
+}
+export interface ElementIR {
+    role?: string;
+    name?: string;
+    label?: string;
+    placeholder?: string;
+    testId?: string;
+    text?: string;
+    cssSelector?: string;
+    xpath?: string;
+    tag: string;
+    bounds?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+export interface LocatorChoice {
+    api: "getByRole" | "getByLabel" | "getByPlaceholder" | "getByTestId" | "getByText" | "locator";
+    args: string;
+    /** camelCase TS field name (e.g. `submitButton`). */
+    fieldName: string;
+    source: ElementIR;
+    confidence: "unique" | "ambiguous" | "fallback";
+}
+export interface PageObjectIR {
+    className: string;
+    filePath: string;
+    url?: string;
+    fields: LocatorChoice[];
+    methods: PomMethodIR[];
+    /** True when the file already exists on disk and we're augmenting. */
+    exists: boolean;
+}
+export interface PomMethodIR {
+    name: string;
+    params: {
+        name: string;
+        type: string;
+    }[];
+    /** Pre-rendered TS body. */
+    body: string;
+    origin: "existing" | "generated";
+}
+export interface StepBinding {
+    step: StepIR;
+    pomCall?: {
+        page: string;
+        method: string;
+        args: string[];
+    };
+    assertion?: {
+        locator: string;
+        matcher: string;
+        expected?: string;
+    };
+    /**
+     * Pre-rendered body for compound steps (one Gherkin step → multiple TS
+     * statements). When present, the emitter writes `customBody` verbatim
+     * instead of synthesising lines from `pomCall` / `assertion`.
+     * Example: `When user enter email "x" password "y"` → two `.fill()` lines.
+     */
+    customBody?: string;
+    /** Populated when no clean mapping was found. */
+    warning?: string;
+}
+export interface ReviewItem {
+    severity: "info" | "warn" | "error";
+    file?: string;
+    line?: number;
+    message: string;
+    suggestion?: string;
+}
+export interface ScaffoldOptions {
+    feature: string;
+    url: string;
+    page: string;
+    repo: string;
+    pages?: string[];
+    storageState?: string;
+    headed?: boolean;
+    llm?: "anthropic" | "openai" | "gemini";
+    governanceUrl?: string;
+    templates?: string;
+    dryRun?: boolean;
+    noValidate?: boolean;
+    telemetry?: boolean;
+    force?: boolean;
+    /**
+     * Skip page discovery entirely — use an empty element list. Useful for
+     * rule-only probing (CI, offline analysis, "what does the matcher do
+     * with this feature?" investigations). Synthesised goto() still works
+     * because it uses `--url` directly. Field-referencing rules will fall
+     * to TODO since the POM has no fields.
+     */
+    noDiscovery?: boolean;
+    /**
+     * If set, read snapshot from this JSON file instead of launching a
+     * browser. Phase 1a fallback; also used by regression tests for
+     * offline runs.
+     */
+    snapshotFile?: string;
+}
+export interface ScaffoldResult {
+    filesWritten: string[];
+    reviewItems: ReviewItem[];
+    tscErrorCount: number;
+    reviewReportPath: string;
+}
+export interface AnalyzeOptions {
+    feature: string;
+    url: string;
+    storageState?: string;
+    headed?: boolean;
+}
+export interface AnalyzeResult {
+    feature: FeatureIR;
+    discoveredLocators: LocatorChoice[];
+    bindings: StepBinding[];
+    warnings: ReviewItem[];
+}
+export interface UpdatePomOptions {
+    page: string;
+    url: string;
+    repo: string;
+    storageState?: string;
+    headed?: boolean;
+    templates?: string;
+}
+export interface UpdatePomResult {
+    added: {
+        fields: number;
+        methods: number;
+    };
+    preserved: {
+        fields: number;
+        methods: number;
+    };
+    filePath: string;
+    reviewItems: ReviewItem[];
+}

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Intermediate representation (IR) shared across parser, transformers, and emitters.
+ * See docs/SCOPE.md §13 for the canonical shape.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Structured logger. JSON to stdout. Pretty-print only when TTY + DEBUG set.
+ */
+import pino from "pino";
+export declare const logger: pino.Logger<never, boolean>;
+export type Logger = typeof logger;