@sun-asterisk/sungen 1.0.17 → 1.0.19

package/dist/core/live-scanner/step-replayer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Step Replayer
+ * Replays Gherkin steps on a live Playwright page to reveal dynamic elements.
+ * Takes a snapshot and finds elements after each action.
+ */
+import type { Page } from 'playwright';
+import { LiveElement } from './types';
+interface ParsedStepInfo {
+    keyword: string;
+    text: string;
+    selectorRef?: string;
+    dataRef?: string;
+    elementType?: string;
+    nth?: number;
+}
+interface ReplayResult {
+    elements: Record<string, LiveElement>;
+    errors: string[];
+}
+/**
+ * Replay a sequence of Gherkin steps on a Playwright page,
+ * finding and interacting with elements along the way.
+ */
+export declare function replaySteps(page: Page, steps: ParsedStepInfo[], featurePath: string, baseUrl: string): Promise<ReplayResult>;
+export {};
+//# sourceMappingURL=step-replayer.d.ts.map

package/dist/core/live-scanner/step-replayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-replayer.d.ts","sourceRoot":"","sources":["../../../src/core/live-scanner/step-replayer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAkB,MAAM,SAAS,CAAC;AAGtD,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,cAAc,EAAE,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CA6EvB"}

package/dist/core/live-scanner/step-replayer.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Step Replayer
+ * Replays Gherkin steps on a live Playwright page to reveal dynamic elements.
+ * Takes a snapshot and finds elements after each action.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaySteps = replaySteps;
+const element_finder_1 = require("./element-finder");
+const selector_resolver_1 = require("../../generators/test-generator/utils/selector-resolver");
+/**
+ * Replay a sequence of Gherkin steps on a Playwright page,
+ * finding and interacting with elements along the way.
+ */
+async function replaySteps(page, steps, featurePath, baseUrl) {
+    const elements = {};
+    const errors = [];
+    let currentContext = 'page';
+    for (const step of steps) {
+        try {
+            const action = detectAction(step.text);
+            // Handle navigation (Given User is on [x] page)
+            if (action === 'navigate') {
+                await page.goto(baseUrl + featurePath, { waitUntil: 'networkidle', timeout: 15000 });
+                await settle(page);
+                if (step.selectorRef) {
+                    const key = generateElementKey(step.selectorRef, step.elementType);
+                    // Record the page element but don't search for it on the DOM
+                    elements[key] = {
+                        gherkinRef: step.selectorRef,
+                        gherkinType: step.elementType || 'page',
+                        selectorType: '',
+                        selectorValue: featurePath,
+                        role: '',
+                        name: step.selectorRef,
+                        testid: null,
+                        tag: '',
+                        placeholder: null,
+                        label: null,
+                        context: 'page',
+                        matchMethod: 'exact_role',
+                        exact: false,
+                        warning: null,
+                    };
+                }
+                continue;
+            }
+            // Skip steps without element references
+            if (!step.selectorRef)
+                continue;
+            const key = generateElementKey(step.selectorRef, step.elementType);
+            const nth = step.nth || 0;
+            const elementType = step.elementType || 'button';
+            // Find the element on the page
+            const element = await (0, element_finder_1.findElement)(page, step.selectorRef, elementType, nth);
+            element.context = currentContext;
+            // Record in matrix (first match wins for duplicate keys)
+            if (!elements[key]) {
+                elements[key] = element;
+            }
+            // Execute the action if element was found
+            if (element.matchMethod !== 'unresolved') {
+                if (action === 'click') {
+                    await executeClick(page, step.selectorRef, elementType, nth);
+                    await settle(page);
+                    currentContext = await detectCurrentContext(page, currentContext, step.text);
+                }
+                else if (action === 'fill') {
+                    // For fill actions during scanning, use a placeholder value
+                    // We just need to verify the element exists
+                }
+                // 'see' and 'wait' actions: just record, don't interact
+            }
+            else {
+                errors.push(`Step "${step.text}": element [${step.selectorRef}] not found`);
+                // Continue scanning remaining steps — record what we can even if some elements are missing
+            }
+        }
+        catch (error) {
+            errors.push(`Step "${step.text}": ${error.message}`);
+            // On navigation or critical errors, stop replaying this scenario
+            if (error.message.includes('Navigation') || error.message.includes('net::')) {
+                break;
+            }
+        }
+    }
+    return { elements, errors };
+}
+async function executeClick(page, ref, elementType, nth) {
+    const namePattern = new RegExp(escapeRegex(ref), 'i');
+    // Try role-based click first
+    const { getRoleFallbacks } = require('./role-fallback');
+    const roles = getRoleFallbacks(elementType);
+    for (const role of roles) {
+        try {
+            const locator = page.getByRole(role, { name: namePattern });
+            const target = nth > 0 ? locator.nth(nth) : locator.first();
+            if (await target.isVisible({ timeout: 3000 })) {
+                await target.click({ timeout: 5000 });
+                return;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Fallback to text click
+    try {
+        const locator = page.getByText(namePattern);
+        const target = nth > 0 ? locator.nth(nth) : locator.first();
+        await target.click({ timeout: 5000 });
+    }
+    catch {
+        // Try testid as last resort
+        const normalized = ref.toLowerCase().replace(/[\s_-]+/g, '-');
+        await page.locator(`[data-testid*="${normalized}" i]`).first().click({ timeout: 5000 });
+    }
+}
+function detectAction(text) {
+    const lower = text.toLowerCase();
+    if (/\b(is on|navigate|go to|visit|open)\b/.test(lower) && /\bpage\b/.test(lower))
+        return 'navigate';
+    if (/\b(click|press|tap|submit)\b/.test(lower))
+        return 'click';
+    if (/\b(fill|enter|type|input)\b/.test(lower))
+        return 'fill';
+    if (/\b(see|verify|check|expect|visible|displayed)\b/.test(lower))
+        return 'see';
+    if (/\b(select|choose|pick)\b/.test(lower))
+        return 'select';
+    if (/\b(wait)\b/.test(lower))
+        return 'wait';
+    return 'see';
+}
+async function detectCurrentContext(page, previous, stepText) {
+    const lower = stepText.toLowerCase();
+    // Check if we opened a dialog/modal
+    if (/\b(dialog|modal|panel)\b/.test(lower)) {
+        return 'dialog';
+    }
+    // Check if a dialog is now visible on the page
+    try {
+        const dialogLocator = page.getByRole('dialog');
+        if (await dialogLocator.count() > 0) {
+            return 'dialog';
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Check for menu
+    if (/\b(menu|dropdown)\b/.test(lower)) {
+        return 'menu';
+    }
+    try {
+        const menuLocator = page.getByRole('menu');
+        if (await menuLocator.count() > 0) {
+            return 'menu';
+        }
+    }
+    catch {
+        // ignore
+    }
+    return previous;
+}
+async function settle(page) {
+    try {
+        await page.waitForLoadState('networkidle', { timeout: 5000 });
+    }
+    catch {
+        // Timeout is acceptable — page may have long-polling connections
+    }
+    // Small extra wait for animations/transitions
+    await page.waitForTimeout(300);
+}
+function generateElementKey(ref, elementType) {
+    // Use the same key generation as the scaffold generator
+    // so live-scan keys match scaffold keys in the map command.
+    return selector_resolver_1.SelectorResolver.generateKey(ref);
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=step-replayer.js.map

package/dist/core/live-scanner/step-replayer.js.map

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

package/dist/core/live-scanner/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Live Scanner Types
+ * Defines the data structures for live DOM scanning and matrix file output.
+ *
+ * Selector types map directly to Playwright locator strategies:
+ *   testid      → page.getByTestId(value)
+ *   role        → page.getByRole(value, { name })
+ *   label       → page.getByLabel(value)
+ *   placeholder → page.getByPlaceholder(value)
+ *   text        → page.getByText(value)
+ */
+export type MatchMethod = 'testid' | 'exact_role' | 'role_fallback' | 'label' | 'placeholder' | 'text_only' | 'unresolved';
+export type SelectorType = 'testid' | 'role' | 'label' | 'placeholder' | 'text';
+export type ElementContext = 'page' | 'dialog' | 'menu' | 'modal' | 'popup';
+export interface LiveElement {
+    gherkinRef: string;
+    gherkinType: string;
+    selectorType: SelectorType | '';
+    selectorValue: string;
+    role: string;
+    name: string;
+    testid: string | null;
+    tag: string;
+    placeholder: string | null;
+    label: string | null;
+    context: ElementContext;
+    matchMethod: MatchMethod;
+    exact: boolean;
+    warning: string | null;
+}
+export interface LiveScanScenario {
+    auth: string | null;
+    extends: string | null;
+    path: string;
+    elements: Record<string, LiveElement>;
+}
+export interface LiveScanResult {
+    screen: string;
+    baseUrl: string;
+    scannedAt: string;
+    scenarios: Record<string, LiveScanScenario>;
+}
+export interface LiveScanOptions {
+    baseUrl?: string;
+    screenName: string;
+    screensDir: string;
+    headed?: boolean;
+    authDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/live-scanner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/live-scanner/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAE3H,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,GAAG,EAAE,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/core/live-scanner/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Live Scanner Types
+ * Defines the data structures for live DOM scanning and matrix file output.
+ *
+ * Selector types map directly to Playwright locator strategies:
+ *   testid      → page.getByTestId(value)
+ *   role        → page.getByRole(value, { name })
+ *   label       → page.getByLabel(value)
+ *   placeholder → page.getByPlaceholder(value)
+ *   text        → page.getByText(value)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/live-scanner/types.js.map

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

package/dist/generators/cli.js

@@ -80,7 +80,7 @@ const program = new commander_1.Command();
 program
     .name('qa-generator')
     .description('AI-Native QA Selector DSL Generator')
-    .version('1.0.17');
+    .version('1.0.19');
 // ============================================================================
 // Command: discover
 // ============================================================================

package/dist/generators/scaffold-generator/index.d.ts

@@ -4,10 +4,11 @@
  */
 export interface ScaffoldElement {
     locator: string;
-    type: 'placeholder' | 'role' | 'text' | 'label' | 'page';
+    type: 'placeholder' | 'role' | 'text' | 'label' | 'page' | 'testid';
     value: string;
     name?: string;
     nth: number;
+    exact?: boolean;
 }
 export interface ScaffoldResult {
     [key: string]: ScaffoldElement;
@@ -22,7 +23,7 @@ export interface MapResult {
     elementCount: number;
     dataRefCount: number;
     selectorsSkipped?: boolean;
-    testDataSkipped?: boolean;
+    testDataMerged?: boolean;
 }
 export declare class ScaffoldGenerator {
     /**
@@ -112,6 +113,16 @@ export declare class ScaffoldGenerator {
         outputPath: string;
         elementCount: number;
     }>;
+    /**
+     * Enrich scaffold with live-scan data if a .live-scan.yaml file exists.
+     * Uses the Playwright locator strategy detected by live-scan:
+     *   testid      → type: testid, value: <testid>
+     *   role        → type: role, value: <aria-role>, name: <accessible-name>
+     *   label       → type: label, value: <label-text>
+     *   placeholder → type: placeholder, value: <placeholder-text>
+     *   text        → type: text, value: <visible-text>
+     */
+    private enrichWithLiveScan;
     /**
      * Helper to capitalize first letter
      */
@@ -134,6 +145,13 @@ export declare class ScaffoldGenerator {
      * Write selectors YAML file
      */
     private writeSelectorsYaml;
+    /**
+     * Smart-merge test-data objects:
+     * - Keys present in both: keep the existing value (user may have filled it in)
+     * - Keys only in fresh (new refs in features): add with empty value
+     * - Keys only in existing (removed from features): drop them
+     */
+    private mergeTestData;
     /**
      * Write test-data YAML file
      */

package/dist/generators/scaffold-generator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/scaffold-generator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;CACxC;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAiBD,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc;IAKzD;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAQpD;;OAEG;IACH,OAAO,CAAC,eAAe;IAqDvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAsEzB;;;OAGG;IACH;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqH7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAyB1E;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAUP;;OAEG;IACH,kBAAkB,CAChB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,OAAe,GAC9B;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAsB/C;;OAEG;IACH,kBAAkB,CAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBpE;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAqB,EAAE,cAAc,GAAE,OAAe,GAAG,SAAS,EAAE;IAyElH;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAmB1B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/scaffold-generator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;CACxC;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAiBD,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc;IAKzD;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAQpD;;OAEG;IACH,OAAO,CAAC,eAAe;IAqDvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAyEzB;;;OAGG;IACH;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqH7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAyB1E;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAUP;;OAEG;IACH,kBAAkB,CAChB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,OAAe,GAC9B;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAsB/C;;OAEG;IACH,kBAAkB,CAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBpE;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA6G1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAqB,EAAE,cAAc,GAAE,OAAe,GAAG,SAAS,EAAE;IAoFlH;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAqB1B"}

package/dist/generators/scaffold-generator/index.js

@@ -125,6 +125,9 @@ class ScaffoldGenerator {
         if (/^(logo|image|img|icon)\b/.test(lowerText) || /^\d*\s*(logo|image|img|icon)\b/.test(lowerText)) {
             return 'img';
         }
+        if (/^(dialog|modal)\b/.test(lowerText) || /^\d*\s*(dialog|modal)\b/.test(lowerText)) {
+            return 'dialog';
+        }
         if (/^(heading|header)\b/.test(lowerText) || /^\d*\s*(heading|header)\b/.test(lowerText)) {
             return 'heading';
         }
@@ -317,7 +320,7 @@ class ScaffoldGenerator {
             case 'see':
                 // For assertions - respect targetType for role-based elements
                 if (targetType === 'img' || targetType === 'button' || targetType === 'link' ||
-                    targetType === 'checkbox' || targetType === 'radio' || targetType === 'heading') {
+                    targetType === 'checkbox' || targetType === 'radio' || targetType === 'heading' || targetType === 'dialog') {
                     const seeRoleValue = this.getRoleValue(targetType);
                     return {
                         locator: '',
@@ -383,6 +386,8 @@ class ScaffoldGenerator {
                 return 'img';
             case 'heading':
                 return 'heading';
+            case 'dialog':
+                return 'dialog';
             default:
                 return 'button'; // Default to button
         }
@@ -495,6 +500,119 @@ class ScaffoldGenerator {
         }
         return results;
     }
+    /**
+     * Enrich scaffold with live-scan data if a .live-scan.yaml file exists.
+     * Uses the Playwright locator strategy detected by live-scan:
+     *   testid      → type: testid, value: <testid>
+     *   role        → type: role, value: <aria-role>, name: <accessible-name>
+     *   label       → type: label, value: <label-text>
+     *   placeholder → type: placeholder, value: <placeholder-text>
+     *   text        → type: text, value: <visible-text>
+     */
+    enrichWithLiveScan(scaffold, liveScanPath) {
+        if (!fs_1.default.existsSync(liveScanPath)) {
+            return scaffold;
+        }
+        let matrixData;
+        try {
+            const { readMatrix, mergeMatrixElements } = require('../../core/live-scanner/matrix-reader');
+            matrixData = readMatrix(liveScanPath);
+            if (!matrixData)
+                return scaffold;
+            const elements = mergeMatrixElements(matrixData);
+            if (!elements || Object.keys(elements).length === 0)
+                return scaffold;
+            console.log(`   🔗 Using live-scan data from ${path_1.default.basename(liveScanPath)}`);
+            let enrichedCount = 0;
+            let warningCount = 0;
+            const enriched = { ...scaffold };
+            for (const [key, scaffoldElement] of Object.entries(enriched)) {
+                // Try exact key first, then base key without --N suffix or --type suffix
+                let liveElement = elements[key];
+                if (!liveElement && key.includes('--')) {
+                    const baseKey = key.replace(/--.*$/, '');
+                    liveElement = elements[baseKey];
+                }
+                if (!liveElement) {
+                    continue;
+                }
+                // If live-scan couldn't find the element, clear the identifying field so user must fill manually
+                if (liveElement.matchMethod === 'unresolved') {
+                    if (scaffoldElement.name !== undefined) {
+                        enriched[key] = { ...scaffoldElement, name: '' };
+                    }
+                    else {
+                        enriched[key] = { ...scaffoldElement, value: '' };
+                    }
+                    continue;
+                }
+                // Use the Playwright locator strategy that live-scan detected
+                const selectorType = liveElement.selectorType;
+                // Only set exact when true (omit from YAML when false for cleaner output)
+                const exactField = liveElement.exact ? { exact: true } : {};
+                if (selectorType === 'testid' && liveElement.testid) {
+                    // page.getByTestId('value')
+                    enriched[key] = {
+                        ...scaffoldElement,
+                        type: 'testid',
+                        value: liveElement.testid,
+                    };
+                }
+                else if (selectorType === 'role' && liveElement.role) {
+                    // page.getByRole('button', { name: 'Submit' })
+                    enriched[key] = {
+                        ...scaffoldElement,
+                        type: 'role',
+                        value: liveElement.role,
+                        name: liveElement.name || liveElement.gherkinRef,
+                        ...exactField,
+                    };
+                }
+                else if (selectorType === 'label' && liveElement.label) {
+                    // page.getByLabel('Username')
+                    enriched[key] = {
+                        ...scaffoldElement,
+                        type: 'label',
+                        value: liveElement.label,
+                        ...exactField,
+                    };
+                }
+                else if (selectorType === 'placeholder' && liveElement.placeholder) {
+                    // page.getByPlaceholder('Enter email')
+                    enriched[key] = {
+                        ...scaffoldElement,
+                        type: 'placeholder',
+                        value: liveElement.placeholder,
+                        ...exactField,
+                    };
+                }
+                else if (selectorType === 'text') {
+                    // page.getByText('Welcome')
+                    enriched[key] = {
+                        ...scaffoldElement,
+                        type: 'text',
+                        value: liveElement.name || liveElement.gherkinRef,
+                        ...exactField,
+                    };
+                }
+                else {
+                    continue;
+                }
+                enrichedCount++;
+                if (liveElement.warning) {
+                    warningCount++;
+                    console.log(`   ⚠️  ${key}: ${liveElement.warning}`);
+                }
+            }
+            const textOnlyCount = Object.keys(enriched).length - enrichedCount;
+            console.log(`   📊 Live-scan: ${enrichedCount} enriched, ${textOnlyCount} text-inferred${warningCount > 0 ? `, ${warningCount} warnings` : ''}`);
+            return enriched;
+        }
+        catch (error) {
+            console.warn(`   ⚠️  Failed to read live-scan data: ${error.message}`);
+            return scaffold;
+        }
+    }
     /**
      * Helper to capitalize first letter
      */
@@ -534,6 +652,9 @@ class ScaffoldGenerator {
             // Build scaffolds from this file
             const selectorScaffold = this.buildScaffold(elements);
             const testDataScaffold = this.buildTestData(dataRefs);
+            // Enrich scaffold with live-scan data if available
+            const liveScanPath = path_1.default.join(selectorsDir, `${filename}.live-scan.yaml`);
+            const liveScanEnriched = this.enrichWithLiveScan(selectorScaffold, liveScanPath);
             // Check if files exist
             const selectorsPath = path_1.default.join(selectorsDir, `${filename}.yaml`);
             const selectorsOverridePath = path_1.default.join(selectorsDir, `${filename}.override.yaml`);
@@ -543,11 +664,19 @@ class ScaffoldGenerator {
             const testDataExists = fs_1.default.existsSync(testDataPath);
             // Write selectors YAML (BASE ONLY - never touch override files)
             if (!selectorsExists || forceOverwrite) {
-                this.writeSelectorsYaml(selectorScaffold, selectorsPath, filename);
+                this.writeSelectorsYaml(liveScanEnriched, selectorsPath, filename);
             }
             // Override file is NEVER touched by map command
-            // Write test-data YAML (BASE ONLY - never touch override files)
-            if (!testDataExists || forceOverwrite) {
+            // Write test-data YAML — always smart-merge regardless of --force:
+            // • existing keys keep their current value
+            // • new keys from features are added (empty string)
+            // • keys no longer referenced in features are removed
+            if (testDataExists) {
+                const existingRaw = yaml_1.default.parse(fs_1.default.readFileSync(testDataPath, 'utf-8')) || {};
+                const merged = this.mergeTestData(existingRaw, testDataScaffold);
+                this.writeTestDataYaml(merged, testDataPath, filename);
+            }
+            else {
                 this.writeTestDataYaml(testDataScaffold, testDataPath, filename);
             }
             // Override file is NEVER touched by map command
@@ -555,10 +684,10 @@ class ScaffoldGenerator {
                 featureFile: filename,
                 selectorsPath,
                 testDataPath,
-                elementCount: Object.keys(selectorScaffold).length,
+                elementCount: Object.keys(liveScanEnriched).length,
                 dataRefCount: dataRefs.length,
                 selectorsSkipped: selectorsExists && !forceOverwrite,
-                testDataSkipped: testDataExists && !forceOverwrite,
+                testDataMerged: testDataExists,
             });
         }
         return results;
@@ -644,14 +773,45 @@ class ScaffoldGenerator {
         });
         fs_1.default.writeFileSync(outputPath, header + yamlContent, 'utf-8');
     }
+    /**
+     * Smart-merge test-data objects:
+     * - Keys present in both: keep the existing value (user may have filled it in)
+     * - Keys only in fresh (new refs in features): add with empty value
+     * - Keys only in existing (removed from features): drop them
+     */
+    mergeTestData(existing, fresh) {
+        const merged = {};
+        for (const key of Object.keys(fresh)) {
+            if (key in existing) {
+                const existingVal = existing[key];
+                const freshVal = fresh[key];
+                if (typeof freshVal === 'object' && typeof existingVal === 'object') {
+                    // Both are nested — recurse
+                    merged[key] = this.mergeTestData(existingVal, freshVal);
+                }
+                else {
+                    // Keep the existing (user-supplied) value
+                    merged[key] = existingVal;
+                }
+            }
+            else {
+                // New key — add with the scaffold default (empty string or nested object)
+                merged[key] = fresh[key];
+            }
+            // Keys present in existing but absent from fresh are intentionally dropped (no longer referenced)
+        }
+        return merged;
+    }
     /**
      * Write test-data YAML file
      */
     writeTestDataYaml(testData, outputPath, screenName) {
-        const header = `# ${this.capitalizeFirst(screenName)} Screen Test Data (Auto-generated)
-# ⚠️  AUTO-GENERATED - Consider editing only the override file
-# To override values, copy to ${screenName}.override.yaml
-# Manual edits to this file will be lost on regeneration
+        const header = `# ${this.capitalizeFirst(screenName)} Screen Test Data
+# Managed by: sungen map (smart-merge)
+# • New {{variable}} refs are added automatically (empty value)
+# • Removed refs are dropped on the next sungen map run
+# • Your existing values are never overwritten
+# To fix a value permanently, copy the key to ${screenName}.override.yaml
 #
 # Reference in features using {{variable}} syntax