@sudobility/testomniac_runner_service 0.1.52 → 0.1.54

package/dist/analyzer/{page-analyzer.d.ts → page-analyzer/index.d.ts}

@@ -1,30 +1,6 @@
-import type { TestElement, Expectation, ActionableItem, SizeClass, TestSurfaceResponse, TestSurfaceBundleRunResponse, FormInfo, TestStep } from "@sudobility/testomniac_types";
-import type { ApiClient } from "../api/client";
-import type { DetectedScaffoldRegion } from "../scanner/component-detector";
-import type { ScanEventHandler } from "../orchestrator/types";
-export interface AnalyzerContext {
-    runnerId: number;
-    sizeClass: SizeClass;
-    uid?: string;
-    currentTestElementId: number;
-    currentTestSurfaceId: number;
-    currentSurfaceRunId: number | null;
-    html: string;
-    currentPageStateId: number;
-    beginningPageStateId: number;
-    currentPath: string;
-    pageId: number;
-    pageRequiresLogin: boolean;
-    scaffolds: DetectedScaffoldRegion[];
-    scaffoldSelectorByItemSelector: Record<string, string>;
-    actionableItems: ActionableItem[];
-    forms: FormInfo[];
-    journeySteps: TestStep[];
-    navigationSurface: TestSurfaceResponse;
-    bundleRun: TestSurfaceBundleRunResponse;
-    api: ApiClient;
-    events: ScanEventHandler;
-}
+import type { TestElement, Expectation } from "@sudobility/testomniac_types";
+import type { AnalyzerContext } from "./types";
+export type { AnalyzerContext } from "./types";
 /**
  * PageAnalyzer generates expectations and discovers new test elements
  * during discovery mode.
@@ -40,17 +16,7 @@ export declare class PageAnalyzer {
      * Called AFTER expertises evaluate and the target page state is established.
      */
     generateTestElements(testElement: TestElement, context: AnalyzerContext): Promise<void>;
-    private generateHoverFollowUpCases;
-    private generateNavigationTestElements;
-    private generateScaffoldTestElements;
-    private generateRenderTestElements;
-    private generateFormTestElements;
-    private generateE2ETestElements;
-    private generateSemanticJourneyTestElements;
-    private generateDialogLifecycleTestElements;
-    private generateKeyboardAndDisclosureTestElements;
-    private generateVariantTestElements;
-    private generateContentTestElements;
+    private getScaffoldSurfaceItems;
     private ensureSurfaceRun;
     private isMouseActionable;
     private isSurfaceCandidate;
@@ -113,6 +79,10 @@ export declare class PageAnalyzer {
     private hasDisabledAppearanceSignal;
     private describeActionableItem;
     private semanticText;
+    private selectRepresentativeItems;
+    private representativeActionStyle;
+    private pickRepresentativeItem;
+    private representativePriority;
     private isAddToCartItem;
     private isCheckoutItem;
     private isRemoveItemAction;
@@ -148,4 +118,4 @@ export declare class PageAnalyzer {
     private detectPasswordRequirements;
     private generatePasswordVariants;
 }
-//# sourceMappingURL=page-analyzer.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzer/page-analyzer/index.d.ts.map

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

package/dist/analyzer/{page-analyzer.js → page-analyzer/index.js}

@@ -1,8 +1,19 @@
 import { PlaywrightAction, ExpectationType, ExpectationSeverity, } from "@sudobility/testomniac_types";
-import { computeHashes } from "../browser/page-utils";
+import { computeHashes } from "../../browser/page-utils";
 import { createHash } from "node:crypto";
-import { fillValuePlanner } from "../planners/fill-value-planner";
-import { AUTH_URL_PATTERNS, SIGNUP_URL_PATTERNS } from "../config/constants";
+import { fillValuePlanner } from "../../planners/fill-value-planner";
+import { AUTH_URL_PATTERNS, SIGNUP_URL_PATTERNS } from "../../config/constants";
+import { generateHoverFollowUpCases } from "./generators/hover-follow-up";
+import { generateNavigationTestElements } from "./generators/navigation";
+import { generateScaffoldTestElements } from "./generators/scaffolds";
+import { generateRenderTestElements } from "./generators/render";
+import { generateFormTestElements } from "./generators/forms";
+import { generateE2ETestElements } from "./generators/e2e";
+import { generateSemanticJourneyTestElements } from "./generators/semantic-journeys";
+import { generateDialogLifecycleTestElements } from "./generators/dialogs";
+import { generateKeyboardAndDisclosureTestElements } from "./generators/keyboard-disclosure";
+import { generateVariantTestElements } from "./generators/variants";
+import { generateContentTestElements } from "./generators/content";
 /**
  * PageAnalyzer generates expectations and discovers new test elements
  * during discovery mode.
@@ -51,401 +62,28 @@ export class PageAnalyzer {
             currentPageStateId,
         };
         if (this.isHoverOnly(testElement)) {
-            await this.generateHoverFollowUpCases(testElement, resolvedContext);
+            await generateHoverFollowUpCases(this, testElement, resolvedContext);
             return;
         }
-        // a. Navigation test elements — for every link on the page
-        await this.generateNavigationTestElements(resolvedContext);
-        // b. Render test elements — capture render coverage for the page
-        await this.generateRenderTestElements(resolvedContext);
-        // c. Form and password test elements — build form workflows from extracted forms
-        await this.generateFormTestElements(resolvedContext);
-        // d. Synthetic journey test elements — build generic business flows from common UI verbs
-        await this.generateSemanticJourneyTestElements(resolvedContext);
-        // e. Journey test elements — preserve discovered multi-step flows as standalone e2e tests
-        await this.generateE2ETestElements(resolvedContext);
-        // f. Dialog lifecycle cases — only when a dialog is already open in the analyzed state
-        await this.generateDialogLifecycleTestElements(resolvedContext);
-        // g. Scaffold test elements — for each scaffold's actionable elements
-        await this.generateScaffoldTestElements(resolvedContext);
-        // h. Content test elements — for non-scaffold actionable elements
-        await this.generateContentTestElements(resolvedContext);
-        // i. Keyboard/disclosure cases
-        await this.generateKeyboardAndDisclosureTestElements(resolvedContext);
-        // j. Variant/option cases
-        await this.generateVariantTestElements(resolvedContext);
-    }
-    async generateHoverFollowUpCases(testElement, context) {
-        const selector = this.getPrimarySelector(testElement);
-        if (!selector || !context.currentPageStateId)
-            return;
-        const beginningItems = context.beginningPageStateId > 0
-            ? await context.api.getItemsByPageState(context.beginningPageStateId)
-            : [];
-        const beginningKeys = new Set(beginningItems.map(item => this.getItemKey(item)).filter(Boolean));
-        const revealedItems = context.actionableItems.filter(item => {
-            if (!this.isMouseActionable(item))
+        await generateNavigationTestElements(this, resolvedContext);
+        await generateRenderTestElements(this, resolvedContext);
+        await generateFormTestElements(this, resolvedContext);
+        await generateSemanticJourneyTestElements(this, resolvedContext);
+        await generateE2ETestElements(this, resolvedContext);
+        await generateDialogLifecycleTestElements(this, resolvedContext);
+        await generateScaffoldTestElements(this, resolvedContext);
+        await generateContentTestElements(this, resolvedContext);
+        await generateKeyboardAndDisclosureTestElements(this, resolvedContext);
+        await generateVariantTestElements(this, resolvedContext);
+    }
+    getScaffoldSurfaceItems(context, scaffold) {
+        return context.actionableItems.filter(item => {
+            if (!this.isSurfaceCandidate(item) || !item.selector)
                 return false;
-            const key = this.getItemKey(item);
-            return Boolean(key) && !beginningKeys.has(key);
-        });
-        const hoveredItem = context.actionableItems.find(item => item.selector === selector) ?? null;
-        if (revealedItems.length === 0 && hoveredItem) {
-            const clickCase = this.buildClickTestElement(hoveredItem, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId, context.currentTestElementId);
-            const tc = await context.api.ensureTestElement(context.runnerId, context.currentTestSurfaceId, clickCase);
-            await context.api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: context.currentSurfaceRunId ?? undefined,
-            });
-            return;
-        }
-        for (const item of revealedItems) {
-            const nextHover = this.buildHoverTestElement(item, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId, context.currentTestElementId);
-            const tc = await context.api.ensureTestElement(context.runnerId, context.currentTestSurfaceId, nextHover);
-            await context.api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: context.currentSurfaceRunId ?? undefined,
-            });
-        }
-    }
-    async generateNavigationTestElements(context) {
-        if (context.pageRequiresLogin)
-            return;
-        const { api, runnerId, sizeClass, uid, navigationSurface, bundleRun } = context;
-        const links = context.actionableItems.filter(item => item.actionKind === "navigate" && item.href && item.visible);
-        // Ensure navigation surface is in the bundle
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, navigationSurface.id);
-        // Ensure a surface run exists for the navigation surface under this bundle run
-        const surfaceRun = await this.ensureSurfaceRun(api, navigationSurface.id, bundleRun.id);
-        for (const link of links) {
-            if (!link.href)
-                continue;
-            const path = this.extractRelativePath(link.href);
-            if (!path)
-                continue;
-            const testElement = this.buildNavigationTestElement(path, sizeClass, uid, context.currentPageStateId);
-            const tc = await api.ensureTestElement(runnerId, navigationSurface.id, testElement);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateScaffoldTestElements(context) {
-        const { api, runnerId, sizeClass, uid, bundleRun } = context;
-        for (const scaffold of context.scaffolds) {
-            // Find actionable items belonging to this scaffold
-            const scaffoldItems = context.actionableItems.filter(item => item.scaffoldId != null && this.isSurfaceCandidate(item));
-            if (scaffoldItems.length === 0)
-                continue;
-            // Ensure a test surface for this scaffold
-            const surfaceTitle = `Scaffold: ${scaffold.type}`;
-            const surface = await api.ensureTestSurface(runnerId, {
-                title: surfaceTitle,
-                description: `Tests for ${scaffold.type} scaffold`,
-                startingPageStateId: context.currentPageStateId,
-                startingPath: context.currentPath,
-                sizeClass,
-                priority: 3,
-                surface_tags: ["scaffold", scaffold.type],
-                uid,
-            });
-            context.events.onTestSurfaceCreated({
-                surfaceId: surface.id,
-                title: surface.title,
-            });
-            await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-            const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-            for (const item of scaffoldItems) {
-                const testElement = this.shouldUseDirectControlInteraction(item)
-                    ? this.buildControlInteractionTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId)
-                    : this.buildHoverTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId);
-                const tc = await api.ensureTestElement(runnerId, surface.id, testElement);
-                await api.createTestElementRun({
-                    testElementId: tc.id,
-                    testSurfaceRunId: surfaceRun.id,
-                });
-            }
-        }
-    }
-    async generateRenderTestElements(context) {
-        const { api, runnerId, sizeClass, uid, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Render: ${context.currentPath}`,
-            description: `Render validation for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 2,
-            surface_tags: ["render"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        const testElement = this.buildRenderTestElement(context.currentPath, sizeClass, uid, context.currentPageStateId, context.pageId);
-        const tc = await api.ensureTestElement(runnerId, surface.id, testElement);
-        await api.createTestElementRun({
-            testElementId: tc.id,
-            testSurfaceRunId: surfaceRun.id,
+            return (context.scaffoldSelectorByItemSelector[item.selector] ===
+                scaffold.selector);
         });
     }
-    async generateFormTestElements(context) {
-        if (context.forms.length === 0)
-            return;
-        const { api, runnerId, sizeClass, uid, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Forms: ${context.currentPath}`,
-            description: `Form workflows for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 2,
-            surface_tags: ["form"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (let index = 0; index < context.forms.length; index++) {
-            const form = context.forms[index];
-            const formType = this.identifyFormType(form, context.currentPath);
-            const formLabel = this.describeForm(form, index);
-            const validValues = this.planFormValues(form, context.actionableItems);
-            if (this.isSearchForm(form)) {
-                const searchTests = this.buildSearchTestElements(form, formLabel, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues, context.actionableItems);
-                for (const searchTest of searchTests) {
-                    const searchElement = await api.ensureTestElement(runnerId, surface.id, searchTest);
-                    await api.createTestElementRun({
-                        testElementId: searchElement.id,
-                        testSurfaceRunId: surfaceRun.id,
-                    });
-                }
-                continue;
-            }
-            const positive = this.buildFormTestElement(form, formLabel, formType, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues);
-            const positiveElement = await api.ensureTestElement(runnerId, surface.id, positive);
-            await api.createTestElementRun({
-                testElementId: positiveElement.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-            for (const field of form.fields.filter(field => this.isNegativeCandidateField(field))) {
-                const negative = this.buildNegativeFormTestElement(form, formLabel, formType, field, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues);
-                const negativeElement = await api.ensureTestElement(runnerId, surface.id, negative);
-                await api.createTestElementRun({
-                    testElementId: negativeElement.id,
-                    testSurfaceRunId: surfaceRun.id,
-                });
-                const correction = this.buildFormCorrectionTestElement(form, formLabel, formType, field, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues);
-                const correctionElement = await api.ensureTestElement(runnerId, surface.id, correction);
-                await api.createTestElementRun({
-                    testElementId: correctionElement.id,
-                    testSurfaceRunId: surfaceRun.id,
-                });
-            }
-            if (this.isPasswordScenario(formType, form)) {
-                const passwordTests = this.buildPasswordTestElements(form, formLabel, formType, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues, this.detectPasswordRequirements(this.extractVisibleText(context.html)));
-                for (const passwordTest of passwordTests) {
-                    const passwordElement = await api.ensureTestElement(runnerId, surface.id, passwordTest);
-                    await api.createTestElementRun({
-                        testElementId: passwordElement.id,
-                        testSurfaceRunId: surfaceRun.id,
-                    });
-                }
-            }
-        }
-    }
-    async generateE2ETestElements(context) {
-        if (context.journeySteps.length < 2)
-            return;
-        const { api, runnerId, sizeClass, uid, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Journeys: ${context.currentPath}`,
-            description: `End-to-end journeys reaching ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 2,
-            surface_tags: ["e2e"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        const e2e = this.buildE2ETestElement(context.currentPath, sizeClass, uid, context.currentPageStateId, context.journeySteps);
-        const tc = await api.ensureTestElement(runnerId, surface.id, e2e);
-        await api.createTestElementRun({
-            testElementId: tc.id,
-            testSurfaceRunId: surfaceRun.id,
-        });
-    }
-    async generateSemanticJourneyTestElements(context) {
-        const journeys = this.buildSemanticJourneyTestElements(context);
-        if (journeys.length === 0)
-            return;
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Journeys: ${context.currentPath}`,
-            description: `Semantic multi-step journeys from ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 2,
-            surface_tags: ["e2e", "semantic-journey"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const journey of journeys) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, journey);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateDialogLifecycleTestElements(context) {
-        if (!this.pageHasOpenDialog(context.html))
-            return;
-        const closeCandidates = context.actionableItems.filter(item => item.visible &&
-            !item.disabled &&
-            item.selector &&
-            this.isDialogCloseItem(item));
-        const tests = [];
-        for (const item of closeCandidates) {
-            tests.push(this.buildDialogCloseTestElement(item, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
-        }
-        tests.push(this.buildEscapeDialogTestElement(context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Dialogs: ${context.currentPath}`,
-            description: `Dialog lifecycle checks for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 2,
-            surface_tags: ["dialog"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const test of tests) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, test);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateKeyboardAndDisclosureTestElements(context) {
-        const tests = this.buildKeyboardAndDisclosureTestElements(context);
-        if (tests.length === 0)
-            return;
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Keyboard: ${context.currentPath}`,
-            description: `Keyboard parity and disclosure checks for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 3,
-            surface_tags: ["keyboard", "disclosure"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const test of tests) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, test);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateVariantTestElements(context) {
-        const tests = this.buildVariantTestElements(context);
-        if (tests.length === 0)
-            return;
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Variants: ${context.currentPath}`,
-            description: `Variant and option state checks for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 2,
-            surface_tags: ["variant", "option"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const test of tests) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, test);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateContentTestElements(context) {
-        const { api, runnerId, sizeClass, uid, bundleRun, pageId: _pageId, } = context;
-        // Content items are those NOT in a scaffold
-        const contentItems = context.actionableItems.filter(item => item.scaffoldId == null && this.isSurfaceCandidate(item));
-        if (contentItems.length === 0)
-            return;
-        const surfaceTitle = `Page: ${context.currentPath}`;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: surfaceTitle,
-            description: `Tests for page content at ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 3,
-            surface_tags: ["page-content"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const item of contentItems) {
-            const testElement = this.shouldUseDirectControlInteraction(item)
-                ? this.buildControlInteractionTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId)
-                : this.buildHoverTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId);
-            const tc = await api.ensureTestElement(runnerId, surface.id, testElement);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
     async ensureSurfaceRun(api, testSurfaceId, bundleRunId) {
         const openSurfaceRuns = await api.getOpenTestSurfaceRuns(bundleRunId);
         const existing = openSurfaceRuns.find(surfaceRun => surfaceRun.testSurfaceId === testSurfaceId);
@@ -1245,7 +883,7 @@ export class PageAnalyzer {
         return `${descriptor} @ ${form.selector}`;
     }
     buildSemanticJourneyTestElements(context) {
-        const items = context.actionableItems.filter(item => item.visible && !item.disabled && Boolean(item.selector));
+        const items = this.selectRepresentativeItems(context.actionableItems.filter(item => item.visible && !item.disabled && Boolean(item.selector)));
         const journeys = [];
         const collectionCount = this.estimateCollectionCount(context.html);
         const addToCart = items.find(item => this.isAddToCartItem(item));
@@ -1660,7 +1298,7 @@ export class PageAnalyzer {
         return field.type === "checkbox" || field.type === "radio";
     }
     buildKeyboardAndDisclosureTestElements(context) {
-        const items = context.actionableItems.filter(item => item.visible && !item.disabled && Boolean(item.selector));
+        const items = this.selectRepresentativeItems(context.actionableItems.filter(item => item.visible && !item.disabled && Boolean(item.selector)));
         const tests = [];
         for (const item of items) {
             if (this.isDisclosureItem(item)) {
@@ -1693,10 +1331,10 @@ export class PageAnalyzer {
         return tests;
     }
     buildVariantTestElements(context) {
-        const items = context.actionableItems.filter(item => item.visible &&
+        const items = this.selectRepresentativeItems(context.actionableItems.filter(item => item.visible &&
             !item.disabled &&
             Boolean(item.selector) &&
-            this.isVariantSelector(item));
+            this.isVariantSelector(item)));
         const tests = items
             .map(item => this.buildVariantTestElement(item, context))
             .filter((item) => Boolean(item));
@@ -2178,6 +1816,7 @@ export class PageAnalyzer {
     describeActionableItem(item) {
         return (item.accessibleName ||
             item.textContent ||
+            String(item.attributes?._containerTitle ?? "") ||
             String(item.attributes?.labelText ?? "") ||
             String(item.attributes?.placeholder ?? "") ||
             item.selector);
@@ -2190,12 +1829,93 @@ export class PageAnalyzer {
             String(item.attributes?.placeholder ?? ""),
             String(item.attributes?.name ?? ""),
             String(item.attributes?.id ?? ""),
+            String(item.attributes?._containerTitle ?? ""),
+            String(item.attributes?._containerCtaStyle ?? ""),
             item.href || "",
             item.selector,
         ]
             .join(" ")
             .toLowerCase();
     }
+    selectRepresentativeItems(items) {
+        const groups = new Map();
+        const passthrough = [];
+        for (const item of items) {
+            const containerFingerprint = String(item.attributes?._containerFingerprint ?? "").trim();
+            if (!containerFingerprint) {
+                passthrough.push(item);
+                continue;
+            }
+            const key = `${containerFingerprint}|${this.representativeActionStyle(item)}`;
+            const bucket = groups.get(key) ?? [];
+            bucket.push(item);
+            groups.set(key, bucket);
+        }
+        const representatives = Array.from(groups.values()).map(group => this.pickRepresentativeItem(group));
+        return [...passthrough, ...representatives];
+    }
+    representativeActionStyle(item) {
+        const text = this.semanticText(item);
+        const sourceHints = String(item.attributes?._sourceHints ?? "").toLowerCase();
+        const containerTitle = String(item.attributes?._containerTitle ?? "").toLowerCase();
+        if (sourceHints.includes("promoted-target") ||
+            sourceHints.includes("cursor-pointer")) {
+            return "tile-click";
+        }
+        if (item.actionKind === "navigate" &&
+            containerTitle &&
+            (text.includes(containerTitle) ||
+                (item.href && !this.isCheckoutItem(item)))) {
+            return "tile-click";
+        }
+        if (this.isAddToCartItem(item))
+            return "cta:add-to-cart";
+        if (/\blogin for pricing\b/.test(text))
+            return "cta:login-for-pricing";
+        if (/\bselect options\b/.test(text))
+            return "cta:select-options";
+        if (this.isCheckoutItem(item))
+            return "cta:checkout";
+        if (this.isRemoveItemAction(item))
+            return "cta:remove";
+        if (item.actionKind === "navigate")
+            return "navigate";
+        if (item.actionKind === "select")
+            return "select";
+        if (item.actionKind === "fill")
+            return "fill";
+        return `${item.actionKind}:${text
+            .replace(/\b[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}\b/g, "email")
+            .replace(/\$\s?\d[\d,.]*/g, "price")
+            .replace(/\d+/g, "n")
+            .slice(0, 80)}`;
+    }
+    pickRepresentativeItem(items) {
+        return [...items].sort((left, right) => {
+            const leftScore = this.representativePriority(left);
+            const rightScore = this.representativePriority(right);
+            if (leftScore !== rightScore)
+                return rightScore - leftScore;
+            return (left.selector?.length ?? 0) - (right.selector?.length ?? 0);
+        })[0];
+    }
+    representativePriority(item) {
+        let score = 0;
+        const sourceHints = String(item.attributes?._sourceHints ?? "").toLowerCase();
+        if (sourceHints.includes("promoted-target"))
+            score += 4;
+        if (sourceHints.includes("cursor-pointer"))
+            score += 3;
+        if (item.actionKind === "navigate")
+            score += 2;
+        if (item.actionKind === "click")
+            score += 1;
+        if (String(item.attributes?._testId ?? ""))
+            score += 1;
+        if (item.accessibleName)
+            score += 1;
+        return score;
+    }
     isAddToCartItem(item) {
         return /\b(add to cart|add to bag|buy now|add item)\b/.test(this.semanticText(item));
     }
@@ -2461,4 +2181,4 @@ export class PageAnalyzer {
         return variants;
     }
 }
-//# sourceMappingURL=page-analyzer.js.map
+//# sourceMappingURL=index.js.map