@vijaypjavvadi/bdd2pw 1.0.0

package/dist/parser/gherkinParser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Gherkin parser — wraps `@cucumber/gherkin` and produces a `FeatureIR`.
+ * See docs/ARCHITECTURE.md §2.
+ */
+import type { FeatureIR } from "../types";
+export declare class GherkinParseError extends Error {
+    readonly file: string;
+    readonly line?: number | undefined;
+    constructor(message: string, file: string, line?: number | undefined);
+}
+export declare function parseFeature(filePath: string): Promise<FeatureIR>;
+export declare function parseFeatureSource(source: string, sourceFile: string): FeatureIR;
+/**
+ * Substitute `<placeholder>` tokens in a step's text with values from an
+ * Examples row. Used by the orchestrator when expanding Scenario Outlines.
+ */
+export declare function substituteOutlinePlaceholders(text: string, row: Record<string, string>): string;

package/dist/parser/gherkinParser.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Gherkin parser — wraps `@cucumber/gherkin` and produces a `FeatureIR`.
+ * See docs/ARCHITECTURE.md §2.
+ */
+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 });
+exports.GherkinParseError = void 0;
+exports.parseFeature = parseFeature;
+exports.parseFeatureSource = parseFeatureSource;
+exports.substituteOutlinePlaceholders = substituteOutlinePlaceholders;
+const fs = __importStar(require("fs-extra"));
+const gherkin_1 = require("@cucumber/gherkin");
+const messages_1 = require("@cucumber/messages");
+class GherkinParseError extends Error {
+    constructor(message, file, line) {
+        super(message);
+        this.file = file;
+        this.line = line;
+        this.name = "GherkinParseError";
+    }
+}
+exports.GherkinParseError = GherkinParseError;
+async function parseFeature(filePath) {
+    if (!(await fs.pathExists(filePath))) {
+        throw new GherkinParseError(`Feature file not found: ${filePath}`, filePath);
+    }
+    const source = await fs.readFile(filePath, "utf8");
+    return parseFeatureSource(source, filePath);
+}
+function parseFeatureSource(source, sourceFile) {
+    const builder = new gherkin_1.AstBuilder(messages_1.IdGenerator.uuid());
+    const matcher = new gherkin_1.GherkinClassicTokenMatcher();
+    const parser = new gherkin_1.Parser(builder, matcher);
+    let document;
+    try {
+        document = parser.parse(source);
+    }
+    catch (err) {
+        throw new GherkinParseError(`Failed to parse Gherkin: ${err.message}`, sourceFile);
+    }
+    const feature = document.feature;
+    if (!feature) {
+        throw new GherkinParseError(`No Feature: declaration found in ${sourceFile}`, sourceFile);
+    }
+    const tags = (feature.tags ?? []).map((t) => t.name);
+    let background;
+    const scenarios = [];
+    for (const child of feature.children ?? []) {
+        if (child.background) {
+            background = child.background.steps.map(toStepIR);
+        }
+        else if (child.scenario) {
+            scenarios.push(toScenarioIR(child.scenario));
+        }
+    }
+    return {
+        name: feature.name ?? "(unnamed feature)",
+        description: feature.description?.trim() || undefined,
+        background,
+        scenarios,
+        tags,
+        sourceFile,
+    };
+}
+function toScenarioIR(scenario) {
+    const steps = (scenario.steps ?? []).map(toStepIR);
+    const tags = (scenario.tags ?? []).map((t) => t.name);
+    let examples;
+    // Scenario Outline → flatten Examples table into row records
+    if (scenario.examples && scenario.examples.length > 0) {
+        examples = [];
+        for (const block of scenario.examples) {
+            const headers = (block.tableHeader?.cells ?? []).map((c) => c.value);
+            for (const row of block.tableBody ?? []) {
+                const record = {};
+                const cells = row.cells ?? [];
+                headers.forEach((h, i) => {
+                    record[h] = cells[i]?.value ?? "";
+                });
+                examples.push(record);
+            }
+        }
+    }
+    return {
+        name: scenario.name ?? "(unnamed scenario)",
+        steps,
+        examples,
+        tags,
+    };
+}
+function toStepIR(step) {
+    const keyword = String(step.keyword ?? "").trim();
+    const text = String(step.text ?? "").trim();
+    let argument;
+    if (step.docString) {
+        argument = String(step.docString.content ?? "");
+    }
+    else if (step.dataTable) {
+        argument = (step.dataTable.rows ?? []).map((r) => (r.cells ?? []).map((c) => String(c.value ?? "")));
+    }
+    return { keyword, text, argument };
+}
+/**
+ * Substitute `<placeholder>` tokens in a step's text with values from an
+ * Examples row. Used by the orchestrator when expanding Scenario Outlines.
+ */
+function substituteOutlinePlaceholders(text, row) {
+    return text.replace(/<([^>]+)>/g, (_m, key) => row[key] ?? `<${key}>`);
+}
+//# sourceMappingURL=gherkinParser.js.map

package/dist/parser/gherkinParser.js.map

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

package/dist/repo/projectScaffolder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Project scaffolder — when the target repo lacks `playwright.config.ts`,
+ * delegates to `@vijaypjavvadi/pw-emit`'s `emitProject()` to copy templates
+ * into place so the emitted spec has a runnable home.
+ *
+ * `emitProject()` is itself idempotent — files that already exist are
+ * left untouched. So calling this on a repo that already has a config
+ * is a no-op + warnings.
+ */
+import type { ReviewItem } from "../types";
+export interface ScaffoldProjectOptions {
+    repoRoot: string;
+    templatesDir?: string;
+    /** Injected as `baseURL` in playwright.config.ts. */
+    baseUrl?: string;
+    /** Injected as `name` in package.json. */
+    projectName?: string;
+}
+export interface ScaffoldProjectResult {
+    filesWritten: string[];
+    alreadyExisted: boolean;
+    warnings: ReviewItem[];
+}
+export declare function scaffoldProject(opts: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;

package/dist/repo/projectScaffolder.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Project scaffolder — when the target repo lacks `playwright.config.ts`,
+ * delegates to `@vijaypjavvadi/pw-emit`'s `emitProject()` to copy templates
+ * into place so the emitted spec has a runnable home.
+ *
+ * `emitProject()` is itself idempotent — files that already exist are
+ * left untouched. So calling this on a repo that already has a config
+ * is a no-op + warnings.
+ */
+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 });
+exports.scaffoldProject = scaffoldProject;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const pw_emit_1 = require("@vijaypjavvadi/pw-emit");
+async function scaffoldProject(opts) {
+    const configPath = path.join(opts.repoRoot, "playwright.config.ts");
+    const alreadyExisted = await fs.pathExists(configPath);
+    const result = await (0, pw_emit_1.emitProject)({
+        outDir: opts.repoRoot,
+        templatesDir: opts.templatesDir,
+        baseUrl: opts.baseUrl,
+        projectName: opts.projectName,
+    });
+    return {
+        filesWritten: result.filesWritten,
+        alreadyExisted,
+        warnings: result.warnings,
+    };
+}
+//# sourceMappingURL=projectScaffolder.js.map

package/dist/repo/projectScaffolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectScaffolder.js","sourceRoot":"","sources":["../../src/repo/projectScaffolder.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBH,0CAkBC;AAtCD,6CAA+B;AAC/B,2CAA6B;AAC7B,oDAAqD;AAkB9C,KAAK,UAAU,eAAe,CACnC,IAA4B;IAE5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IACpE,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAW,EAAC;QAC/B,MAAM,EAAE,IAAI,CAAC,QAAQ;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,cAAc;QACd,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC"}

package/dist/repo/repoScanner.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Repo scanner — reads `pages/*.page.ts` via `ts-morph` and builds a map of
+ * existing Page Object classes (fields + methods) so the resolver can
+ * decide reuse / augment / create.
+ *
+ * What it extracts per class:
+ *   - className
+ *   - field names + their initialiser locator expression (best-effort, so
+ *     pomResolver can decide presence; not used for re-emission)
+ *   - method names + parameter signatures + raw body
+ *
+ * Out of scope: detecting decorators, generic constraints, inherited fields.
+ * Augment-mode emission preserves whole methods verbatim (origin: 'existing').
+ */
+import type { PageObjectIR } from "../types";
+export interface RepoScanResult {
+    repoRoot: string;
+    hasPlaywrightConfig: boolean;
+    pageObjects: Map<string, PageObjectIR>;
+}
+export declare function scanRepo(repoRoot: string): Promise<RepoScanResult>;

package/dist/repo/repoScanner.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Repo scanner — reads `pages/*.page.ts` via `ts-morph` and builds a map of
+ * existing Page Object classes (fields + methods) so the resolver can
+ * decide reuse / augment / create.
+ *
+ * What it extracts per class:
+ *   - className
+ *   - field names + their initialiser locator expression (best-effort, so
+ *     pomResolver can decide presence; not used for re-emission)
+ *   - method names + parameter signatures + raw body
+ *
+ * Out of scope: detecting decorators, generic constraints, inherited fields.
+ * Augment-mode emission preserves whole methods verbatim (origin: 'existing').
+ */
+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 });
+exports.scanRepo = scanRepo;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const ts_morph_1 = require("ts-morph");
+async function scanRepo(repoRoot) {
+    const pageObjects = new Map();
+    const hasPlaywrightConfig = await fs.pathExists(path.join(repoRoot, "playwright.config.ts"));
+    const pagesDir = path.join(repoRoot, "pages");
+    if (!(await fs.pathExists(pagesDir))) {
+        return { repoRoot, hasPlaywrightConfig, pageObjects };
+    }
+    const project = new ts_morph_1.Project({
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: { allowJs: false, noEmit: true, target: 99 /* ESNext */ },
+    });
+    project.addSourceFilesAtPaths(path.join(pagesDir, "*.page.ts"));
+    for (const sourceFile of project.getSourceFiles()) {
+        const filePath = sourceFile.getFilePath().toString();
+        for (const cls of sourceFile.getClasses()) {
+            const className = cls.getName();
+            if (!className)
+                continue;
+            const fields = cls
+                .getProperties()
+                .filter((p) => {
+                const t = p.getType().getText();
+                // Heuristic: keep `Locator` typed fields; skip `Page`, `string`, etc.
+                return t.includes("Locator");
+            })
+                .map((p) => parseLocatorField(p.getName(), p.getInitializer()?.getText()));
+            const methods = cls.getMethods().map((m) => {
+                const params = m.getParameters().map((p) => ({
+                    name: p.getName(),
+                    type: p.getType().getText() || "unknown",
+                }));
+                const body = m.getBodyText() ?? "";
+                return {
+                    name: m.getName(),
+                    params,
+                    body,
+                    origin: "existing",
+                };
+            });
+            pageObjects.set(className, {
+                className,
+                filePath,
+                fields,
+                methods,
+                exists: true,
+            });
+        }
+    }
+    return { repoRoot, hasPlaywrightConfig, pageObjects };
+}
+/**
+ * Parse a class field initialiser like
+ *   `page.getByRole('button', { name: 'Sign in' })`
+ * back into a `LocatorChoice`. Best-effort — we mainly need the
+ * `fieldName` for the resolver's "is this field present?" check; the
+ * `api`/`args` are advisory.
+ */
+function parseLocatorField(fieldName, init) {
+    const fallback = {
+        api: "locator",
+        args: '""',
+        fieldName,
+        source: { tag: "" },
+        confidence: "fallback",
+    };
+    if (!init)
+        return fallback;
+    const m = init.match(/(?:this\.)?page\.(getByRole|getByLabel|getByPlaceholder|getByTestId|getByText|locator)\s*\(([\s\S]*)\)\s*;?\s*$/);
+    if (!m)
+        return fallback;
+    return {
+        api: m[1],
+        args: m[2].trim(),
+        fieldName,
+        source: { tag: "" },
+        confidence: "unique",
+    };
+}
+//# sourceMappingURL=repoScanner.js.map

package/dist/repo/repoScanner.js.map

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

package/dist/reports/reviewReport.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generate `BDD_REVIEW.md` — every warning, fallback, ambiguity, and
+ * `tsc --noEmit` diagnostic for human review. See docs/ARCHITECTURE.md §10.
+ *
+ * The report is the deliverable, not a clean compile (FR-12). Sections:
+ *   1. Summary  (counts by severity)
+ *   2. Errors   (block testing — fix first)
+ *   3. Warnings (likely correct but worth a glance)
+ *   4. Info     (FYI, ambiguous locators, fallback steps, etc.)
+ *   5. Manual TODOs — every step that fell through to a TODO comment
+ */
+import type { ReviewItem } from "../types";
+export interface WriteReviewInput {
+    repoRoot: string;
+    items: ReviewItem[];
+    feature: string;
+    url: string;
+}
+export declare function writeReviewReport(input: WriteReviewInput): Promise<string>;

package/dist/reports/reviewReport.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Generate `BDD_REVIEW.md` — every warning, fallback, ambiguity, and
+ * `tsc --noEmit` diagnostic for human review. See docs/ARCHITECTURE.md §10.
+ *
+ * The report is the deliverable, not a clean compile (FR-12). Sections:
+ *   1. Summary  (counts by severity)
+ *   2. Errors   (block testing — fix first)
+ *   3. Warnings (likely correct but worth a glance)
+ *   4. Info     (FYI, ambiguous locators, fallback steps, etc.)
+ *   5. Manual TODOs — every step that fell through to a TODO comment
+ */
+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 });
+exports.writeReviewReport = writeReviewReport;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+async function writeReviewReport(input) {
+    const lines = [];
+    const counts = {
+        error: input.items.filter((i) => i.severity === "error").length,
+        warn: input.items.filter((i) => i.severity === "warn").length,
+        info: input.items.filter((i) => i.severity === "info").length,
+    };
+    lines.push("# bdd2pw — Conversion Review");
+    lines.push("");
+    lines.push(`> **Source feature:** \`${input.feature}\``);
+    lines.push(`> **Target URL:** ${input.url}`);
+    lines.push(`> **Generated:** ${new Date().toISOString()}`);
+    lines.push("");
+    lines.push("## Summary");
+    lines.push("");
+    lines.push(`${counts.error} error${counts.error === 1 ? "" : "s"} · ${counts.warn} warning${counts.warn === 1 ? "" : "s"} · ${counts.info} info`);
+    lines.push("");
+    emitSection(lines, "Errors", "error", input.items);
+    emitSection(lines, "Warnings", "warn", input.items);
+    emitSection(lines, "Info", "info", input.items);
+    if (input.items.length === 0) {
+        lines.push("Nothing to review — everything mapped cleanly. Run `npx playwright test` to verify.");
+        lines.push("");
+    }
+    const outPath = path.join(input.repoRoot, "BDD_REVIEW.md");
+    await fs.ensureDir(input.repoRoot);
+    await fs.writeFile(outPath, lines.join("\n"), "utf8");
+    return outPath;
+}
+function emitSection(lines, heading, severity, items) {
+    const filtered = items.filter((i) => i.severity === severity);
+    if (filtered.length === 0)
+        return;
+    lines.push(`## ${heading}`);
+    lines.push("");
+    for (const item of filtered) {
+        const loc = item.file !== undefined
+            ? `\`${item.file}${item.line ? `:${item.line}` : ""}\` — `
+            : "";
+        lines.push(`- ${loc}${item.message}`);
+        if (item.suggestion) {
+            lines.push(`  - Suggestion: ${item.suggestion}`);
+        }
+    }
+    lines.push("");
+}
+//# sourceMappingURL=reviewReport.js.map

package/dist/reports/reviewReport.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HTTP service entry. Express :4300. See docs/SCOPE.md §8b
+ * and docs/ARCHITECTURE.md §3 + §6.
+ */
+import { Application } from "express";
+export interface ServerOptions {
+    port?: number;
+}
+export declare function createApp(): Application;
+export declare function startServer(opts?: ServerOptions): Promise<void>;

package/dist/server.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * HTTP service entry. Express :4300. See docs/SCOPE.md §8b
+ * and docs/ARCHITECTURE.md §3 + §6.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApp = createApp;
+exports.startServer = startServer;
+const express_1 = __importDefault(require("express"));
+const logger_1 = require("./utils/logger");
+const routes_1 = require("./http/routes");
+function createApp() {
+    const app = (0, express_1.default)();
+    app.use(express_1.default.json({ limit: "1mb" }));
+    app.get("/healthz", (_req, res) => res.json({ ok: true }));
+    app.get("/version", (_req, res) => res.json({
+        name: "@vijaypjavvadi/bdd2pw",
+        version: require("../package.json").version,
+        commit: process.env.GIT_COMMIT ?? "unknown",
+    }));
+    (0, routes_1.mountRoutes)(app);
+    return app;
+}
+async function startServer(opts = {}) {
+    const port = opts.port ?? 4300;
+    const app = createApp();
+    app.listen(port, () => {
+        logger_1.logger.info({ port }, "bdd2pw HTTP service listening");
+    });
+}
+if (require.main === module) {
+    startServer({ port: Number(process.env.PORT ?? 4300) }).catch((err) => {
+        logger_1.logger.error({ err }, "server failed to start");
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAUH,8BAgBC;AAED,kCAMC;AAhCD,sDAA+C;AAC/C,2CAAwC;AACxC,0CAA4C;AAM5C,SAAgB,SAAS;IACvB,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAExC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAChC,GAAG,CAAC,IAAI,CAAC;QACP,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO;QAC3C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,SAAS;KAC5C,CAAC,CACH,CAAC;IAEF,IAAA,oBAAW,EAAC,GAAG,CAAC,CAAC;IAEjB,OAAO,GAAG,CAAC;AACb,CAAC;AAEM,KAAK,UAAU,WAAW,CAAC,OAAsB,EAAE;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IAC/B,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,eAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,+BAA+B,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACpE,eAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/transformers/locatorPicker.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ */
+import type { ElementIR, LocatorChoice } from "../types";
+/**
+ * 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.
+ */
+export declare function pickLocator(element: ElementIR, allElements: ElementIR[]): LocatorChoice;
+/**
+ * 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.
+ */
+export declare function dedupeLocators(choices: LocatorChoice[]): LocatorChoice[];