@sudobility/testomniac_runner_service 0.1.51 → 0.1.53

package/dist/analyzer/page-analyzer.js

@@ -83,12 +83,12 @@ export class PageAnalyzer {
             ? await context.api.getItemsByPageState(context.beginningPageStateId)
             : [];
         const beginningKeys = new Set(beginningItems.map(item => this.getItemKey(item)).filter(Boolean));
-        const revealedItems = context.actionableItems.filter(item => {
+        const revealedItems = this.selectRepresentativeItems(context.actionableItems.filter(item => {
             if (!this.isMouseActionable(item))
                 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);
@@ -112,7 +112,7 @@ export class PageAnalyzer {
         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);
+        const links = this.selectRepresentativeItems(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
@@ -134,8 +134,7 @@ export class PageAnalyzer {
     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));
+            const scaffoldItems = this.selectRepresentativeItems(this.getScaffoldSurfaceItems(context, scaffold));
             if (scaffoldItems.length === 0)
                 continue;
             // Ensure a test surface for this scaffold
@@ -168,6 +167,14 @@ export class PageAnalyzer {
             }
         }
     }
+    getScaffoldSurfaceItems(context, scaffold) {
+        return context.actionableItems.filter(item => {
+            if (!this.isSurfaceCandidate(item) || !item.selector)
+                return false;
+            return (context.scaffoldSelectorByItemSelector[item.selector] ===
+                scaffold.selector);
+        });
+    }
     async generateRenderTestElements(context) {
         const { api, runnerId, sizeClass, uid, bundleRun } = context;
         const surface = await api.ensureTestSurface(runnerId, {
@@ -320,10 +327,10 @@ export class PageAnalyzer {
     async generateDialogLifecycleTestElements(context) {
         if (!this.pageHasOpenDialog(context.html))
             return;
-        const closeCandidates = context.actionableItems.filter(item => item.visible &&
+        const closeCandidates = this.selectRepresentativeItems(context.actionableItems.filter(item => item.visible &&
             !item.disabled &&
             item.selector &&
-            this.isDialogCloseItem(item));
+            this.isDialogCloseItem(item)));
         const tests = [];
         for (const item of closeCandidates) {
             tests.push(this.buildDialogCloseTestElement(item, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
@@ -415,7 +422,7 @@ export class PageAnalyzer {
     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));
+        const contentItems = this.selectRepresentativeItems(context.actionableItems.filter(item => item.scaffoldId == null && this.isSurfaceCandidate(item)));
         if (contentItems.length === 0)
             return;
         const surfaceTitle = `Page: ${context.currentPath}`;
@@ -720,6 +727,16 @@ export class PageAnalyzer {
             steps,
             globalExpectations: [
                 ...this.defaultFlowExpectations(`Form ${formLabel} should execute cleanly`),
+                ...(formType === "login" || formType === "signup"
+                    ? [
+                        this.makeExpectation(ExpectationType.NavigationOrStateChanged, `${formLabel} should advance authentication state after a successful submit`, {
+                            severity: ExpectationSeverity.ShouldPass,
+                        }),
+                        this.makeExpectation(ExpectationType.ErrorStateCleared, `${formLabel} should not leave a visible error state after a successful authentication submit`, {
+                            severity: ExpectationSeverity.ShouldPass,
+                        }),
+                    ]
+                    : []),
                 this.makeExpectation(ExpectationType.FormSubmittedSuccessfully, `Form ${formLabel} should submit without client-side errors`),
                 this.makeExpectation(ExpectationType.NetworkRequestMade, `Submitting ${formLabel} should trigger a backend mutation request`, {
                     expectedValue: "mutation",
@@ -742,7 +759,7 @@ export class PageAnalyzer {
         };
     }
     buildNegativeFormTestElement(form, formLabel, formType, omittedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
-        const steps = this.buildFormSteps(form, validValues, omittedField.selector);
+        const steps = this.buildFormSteps(form, validValues, omittedField.selector, this.buildValuePreservationExpectations(form, validValues, omittedField.selector));
         return {
             title: `Form Negative — ${formLabel} (missing ${this.fieldLabel(omittedField)})`,
             type: "form_negative",
@@ -755,6 +772,7 @@ export class PageAnalyzer {
             globalExpectations: [
                 ...this.defaultFlowExpectations(`Negative form check for ${formLabel}`),
                 this.makeExpectation(ExpectationType.ValidationMessageVisible, `Validation feedback should appear when ${this.fieldLabel(omittedField)} is omitted`),
+                this.makeExpectation(ExpectationType.ErrorStateVisible, `Omitting ${this.fieldLabel(omittedField)} should surface an error state`),
                 this.makeExpectation("required_error_shown_for_field", `${this.fieldLabel(omittedField)} should show a required-field error when omitted`, {
                     targetPath: omittedField.selector,
                 }),
@@ -763,7 +781,7 @@ export class PageAnalyzer {
         };
     }
     buildFormCorrectionTestElement(form, formLabel, formType, correctedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
-        const steps = this.buildFormSteps(form, validValues, correctedField.selector);
+        const steps = this.buildFormSteps(form, validValues, correctedField.selector, this.buildValuePreservationExpectations(form, validValues, correctedField.selector));
         const correctionValue = validValues[correctedField.selector];
         if (correctionValue) {
             const correctionStep = this.buildFieldStep(correctedField, correctionValue, this.makeExpectation("field_error_clears_after_fix", `${this.fieldLabel(correctedField)} should clear its validation error after correction`, {
@@ -785,6 +803,7 @@ export class PageAnalyzer {
             steps,
             globalExpectations: [
                 ...this.defaultFlowExpectations(`Correction flow for ${formLabel}`),
+                this.makeExpectation(ExpectationType.ErrorStateCleared, `Error state for ${formLabel} should clear after correcting ${this.fieldLabel(correctedField)}`),
                 this.makeExpectation(ExpectationType.FormSubmittedSuccessfully, `Form ${formLabel} should submit after correcting ${this.fieldLabel(correctedField)}`),
                 this.makeExpectation(ExpectationType.NetworkRequestMade, `Submitting ${formLabel} after correction should trigger a backend mutation request`, {
                     expectedValue: "mutation",
@@ -858,7 +877,7 @@ export class PageAnalyzer {
             uid,
         };
     }
-    buildFormSteps(form, valuesBySelector, omittedSelector) {
+    buildFormSteps(form, valuesBySelector, omittedSelector, postSubmitExpectations = []) {
         const steps = [];
         for (const field of form.fields) {
             if (field.selector === omittedSelector)
@@ -876,7 +895,7 @@ export class PageAnalyzer {
             if (step)
                 steps.push(step);
         }
-        steps.push(...this.buildSubmitSteps(form.submitSelector));
+        steps.push(...this.buildSubmitSteps(form.submitSelector, postSubmitExpectations));
         return steps;
     }
     buildFieldStep(field, value, trailingExpectation) {
@@ -944,7 +963,7 @@ export class PageAnalyzer {
             continueOnFailure: false,
         };
     }
-    buildSubmitSteps(submitSelector) {
+    buildSubmitSteps(submitSelector, postSubmitExpectations = []) {
         if (!submitSelector)
             return [];
         return [
@@ -965,12 +984,39 @@ export class PageAnalyzer {
                     playwrightCode: "await page.waitForLoadState('networkidle')",
                     description: "Wait for post-submit state",
                 },
-                expectations: [],
+                expectations: postSubmitExpectations,
                 description: "Wait for post-submit state",
                 continueOnFailure: true,
             },
         ];
     }
+    buildValuePreservationExpectations(form, valuesBySelector, omittedSelector) {
+        const expectations = [];
+        for (const field of form.fields) {
+            if (field.selector === omittedSelector)
+                continue;
+            const analyzerField = field;
+            const fieldIsImmutable = Boolean(analyzerField.disabled ||
+                analyzerField.readOnly ||
+                this.looksVisuallyDisabledField(analyzerField));
+            if (fieldIsImmutable)
+                continue;
+            const value = valuesBySelector[field.selector];
+            if (!value || this.isSkippableFieldType(field))
+                continue;
+            if (this.isCheckboxLike(field)) {
+                expectations.push(this.makeExpectation(ExpectationType.ElementChecked, `${this.fieldLabel(field)} should preserve its selected state after validation feedback`, {
+                    targetPath: field.selector,
+                }));
+                continue;
+            }
+            expectations.push(this.makeExpectation(ExpectationType.InputValue, `${this.fieldLabel(field)} should preserve its value after validation feedback`, {
+                targetPath: field.selector,
+                expectedValue: value,
+            }));
+        }
+        return expectations;
+    }
     planFormValues(form, actionableItems) {
         const values = {};
         for (const field of form.fields) {
@@ -1132,6 +1178,29 @@ export class PageAnalyzer {
                 ],
                 uid,
             },
+            {
+                title: `Search Recovery — ${formLabel}`,
+                type: "form",
+                sizeClass,
+                surface_tags: ["form", "search", "recovery"],
+                priority: 3,
+                startingPageStateId,
+                startingPath: currentPath,
+                steps: [
+                    ...this.buildFormSteps(form, noResultsValues, undefined),
+                    ...this.buildSearchRecoverySteps(form, searchField, "test"),
+                ],
+                globalExpectations: [
+                    ...this.defaultFlowExpectations(`Search recovery flow ${formLabel}`),
+                    this.makeExpectation(ExpectationType.NetworkRequestMade, `Recovering search results via ${formLabel} should issue GET requests`, {
+                        expectedValue: "GET",
+                        timeoutMs: 3000,
+                        expectedTextTokens: ["search", "q=", "query", "term"],
+                    }),
+                    this.makeExpectation(ExpectationType.LoadingCompletes, `Search recovery for ${formLabel} should finish loading`),
+                ],
+                uid,
+            },
         ];
         const clearAction = actionableItems.find(item => this.isSearchClearItem(item));
         if (clearAction) {
@@ -1161,16 +1230,34 @@ export class PageAnalyzer {
         }
         return tests;
     }
+    buildSearchRecoverySteps(form, searchField, recoveryValue) {
+        const steps = [];
+        const refillStep = this.buildFieldStep(searchField, recoveryValue);
+        if (refillStep) {
+            steps.push(refillStep);
+        }
+        steps.push(...this.buildSubmitSteps(form.submitSelector, [
+            this.makeExpectation(ExpectationType.ResultsChanged, `${this.fieldLabel(searchField)} should recover from the empty state to a different result set`),
+            this.makeExpectation(ExpectationType.InputValue, `${this.fieldLabel(searchField)} should preserve the recovery query after resubmission`, {
+                targetPath: searchField.selector,
+                expectedValue: recoveryValue,
+            }),
+            this.makeExpectation(ExpectationType.LoadingCompletes, "Recovered search results should finish loading"),
+        ]));
+        return steps;
+    }
     describeForm(form, index) {
         const namedField = form.fields.find(field => field.label || field.name);
         const descriptor = namedField?.label || namedField?.name || `form ${index + 1}`;
         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));
         const checkout = items.find(item => this.isCheckoutItem(item));
+        const createCollectionAction = items.find(item => this.isCreateCollectionAction(item));
         if (addToCart && checkout) {
             journeys.push(this.buildJourneyTestElement("Commerce journey", ["commerce", "cart", "checkout"], context, [
                 this.buildJourneyAction(addToCart, "Add item to cart", [
@@ -1207,29 +1294,63 @@ export class PageAnalyzer {
         }
         const removeItem = items.find(item => this.isRemoveItemAction(item));
         if (removeItem) {
+            const removeExpectations = [
+                this.makeExpectation("navigation_or_state_changed", "Removing an item should change the page state"),
+                this.makeExpectation("count_changed", "Removing an item should update a visible count", {
+                    expectedCountDelta: -1,
+                }),
+                this.makeExpectation("cart_summary_changed", "Removing an item should update the cart summary"),
+                this.makeExpectation("row_count_changed", "Removing an item should change the visible row or item count", {
+                    expectedCountDelta: -1,
+                }),
+                this.makeExpectation("results_changed", "Removing an item should change the visible collection state"),
+                this.makeExpectation(ExpectationType.NetworkRequestMade, "Removing an item should trigger a backend mutation request", {
+                    expectedValue: "mutation",
+                    timeoutMs: 3000,
+                }),
+                this.makeExpectation(ExpectationType.NoDuplicateMutationRequests, "Removing an item should not trigger duplicate mutation requests"),
+                this.makeExpectation("feedback_visible", "Removing an item should provide visible feedback", {
+                    expectedTextTokens: ["removed", "updated", "cart", "bag"],
+                    forbiddenTextTokens: ["error", "failed"],
+                }),
+                this.makeExpectation("feedback_not_duplicated", "Removing an item should not show duplicate feedback messages"),
+                this.makeExpectation("loading_completes", "Removal flow should complete loading"),
+                this.makeExpectation("page_responsive", "Page should remain responsive after removal"),
+            ];
+            if (this.estimateCollectionCount(context.html) <= 1) {
+                removeExpectations.push(this.makeExpectation(ExpectationType.EmptyStateVisible, "Removing the last visible item should show an empty state or zero-results message", {
+                    expectedTextTokens: [
+                        "no items",
+                        "no products",
+                        "empty",
+                        "no results",
+                        "nothing found",
+                    ],
+                    severity: ExpectationSeverity.ShouldPass,
+                }));
+            }
             journeys.push(this.buildJourneyTestElement("Remove item from collection", ["commerce", "remove"], context, [
-                this.buildJourneyAction(removeItem, "Remove item", [
-                    this.makeExpectation("navigation_or_state_changed", "Removing an item should change the page state"),
-                    this.makeExpectation("count_changed", "Removing an item should update a visible count", {
-                        expectedCountDelta: -1,
-                    }),
-                    this.makeExpectation("cart_summary_changed", "Removing an item should update the cart summary"),
-                    this.makeExpectation("row_count_changed", "Removing an item should change the visible row or item count", {
-                        expectedCountDelta: -1,
-                    }),
-                    this.makeExpectation(ExpectationType.NetworkRequestMade, "Removing an item should trigger a backend mutation request", {
-                        expectedValue: "mutation",
-                        timeoutMs: 3000,
-                    }),
-                    this.makeExpectation(ExpectationType.NoDuplicateMutationRequests, "Removing an item should not trigger duplicate mutation requests"),
-                    this.makeExpectation("feedback_visible", "Removing an item should provide visible feedback", {
-                        expectedTextTokens: ["removed", "updated", "cart", "bag"],
-                        forbiddenTextTokens: ["error", "failed"],
-                    }),
-                    this.makeExpectation("feedback_not_duplicated", "Removing an item should not show duplicate feedback messages"),
-                    this.makeExpectation("loading_completes", "Removal flow should complete loading"),
-                    this.makeExpectation("page_responsive", "Page should remain responsive after removal"),
-                ]),
+                this.buildJourneyAction(removeItem, "Remove item", removeExpectations),
+            ]));
+        }
+        if (createCollectionAction) {
+            const createExpectations = [
+                this.makeExpectation("navigation_or_state_changed", "Creating or adding a record should change the page state"),
+                this.makeExpectation("row_count_changed", "Creating or adding a record should increase the visible row or item count", {
+                    expectedCountDelta: 1,
+                }),
+                this.makeExpectation("results_changed", "Creating or adding a record should change the visible collection state"),
+                this.makeExpectation(ExpectationType.NetworkRequestMade, "Creating or adding a record should trigger a backend mutation request", {
+                    expectedValue: "mutation",
+                    timeoutMs: 3000,
+                }),
+                this.makeExpectation(ExpectationType.NoDuplicateMutationRequests, "Creating or adding a record should not trigger duplicate mutation requests"),
+                this.makeExpectation("feedback_not_duplicated", "Creating or adding a record should not duplicate visible feedback"),
+                this.makeExpectation("loading_completes", "Create/add flow should complete loading"),
+                this.makeExpectation("page_responsive", "Page should remain responsive after creating or adding a record"),
+            ];
+            journeys.push(this.buildJourneyTestElement("Create or add collection record", ["list", "crud", "create"], context, [
+                this.buildJourneyAction(createCollectionAction, "Create or add record", createExpectations),
             ]));
         }
         const authEntry = items.find(item => this.isAuthEntryItem(item));
@@ -1242,6 +1363,51 @@ export class PageAnalyzer {
                 ]),
             ]));
         }
+        const protectedAction = items.find(item => item !== authEntry && this.isProtectedActionItem(item));
+        if (authEntry && protectedAction) {
+            journeys.push(this.buildJourneyTestElement("Protected action auth gate journey", ["auth", "protected"], context, [
+                this.buildJourneyAction(protectedAction, "Open protected action", [
+                    this.makeExpectation(ExpectationType.NavigationOrStateChanged, "Protected action should open a gated state, redirect, or login requirement"),
+                    this.makeExpectation(ExpectationType.PageResponsive, "Page should remain responsive when auth gating is triggered"),
+                    this.makeExpectation(ExpectationType.LoadingCompletes, "Protected action gate should settle cleanly"),
+                ]),
+            ]));
+        }
+        const logoutAction = items.find(item => this.isLogoutAction(item));
+        if (logoutAction) {
+            journeys.push(this.buildJourneyTestElement("Logout journey", ["auth", "logout"], context, [
+                this.buildJourneyAction(logoutAction, "Log out", [
+                    this.makeExpectation(ExpectationType.NavigationOrStateChanged, "Logging out should change application state"),
+                    this.makeExpectation(ExpectationType.PageResponsive, "Page should remain responsive during logout"),
+                    this.makeExpectation(ExpectationType.LoadingCompletes, "Logout should settle cleanly"),
+                    this.makeExpectation(ExpectationType.FeedbackVisible, "Logout should provide visible confirmation or a clear state change", {
+                        forbiddenTextTokens: ["error", "failed"],
+                    }),
+                    this.makeExpectation(ExpectationType.ErrorStateCleared, "Logout should not leave visible recoverable error state behind", {
+                        severity: ExpectationSeverity.ShouldPass,
+                    }),
+                ]),
+            ]));
+        }
+        const retryAction = items.find(item => this.isRetryAction(item));
+        if (retryAction) {
+            journeys.push(this.buildJourneyTestElement("Retry recovery journey", ["recovery", "retry"], context, [
+                this.buildJourneyAction(retryAction, "Retry failed action", [
+                    this.makeExpectation(ExpectationType.ErrorStateCleared, "Retrying should clear any visible recoverable error state"),
+                    this.makeExpectation(ExpectationType.NetworkRequestMade, "Retrying should trigger a follow-up request or state transition", {
+                        expectedValue: "ANY",
+                        timeoutMs: 3000,
+                    }),
+                    this.makeExpectation("navigation_or_state_changed", "Retrying should change page state or visibly advance recovery"),
+                    this.makeExpectation("loading_completes", "Retry recovery should complete loading"),
+                    this.makeExpectation("page_responsive", "Page should remain responsive during retry recovery"),
+                    this.makeExpectation("feedback_not_duplicated", "Retry recovery should not duplicate visible feedback"),
+                    this.makeExpectation("feedback_visible", "Retry recovery should show updated feedback or state confirmation", {
+                        forbiddenTextTokens: ["error", "failed", "try again"],
+                    }),
+                ]),
+            ]));
+        }
         const mediaCandidate = items.find(item => this.isMediaOpenItem(item));
         if (mediaCandidate) {
             const mediaExpectations = [
@@ -1255,19 +1421,33 @@ export class PageAnalyzer {
                 this.buildJourneyAction(mediaCandidate, "Open media", mediaExpectations),
             ]));
         }
-        const quantityAction = items.find(item => this.isQuantityAction(item));
-        if (quantityAction) {
-            journeys.push(this.buildJourneyTestElement("Quantity adjustment journey", ["commerce", "quantity"], context, [
-                this.buildJourneyAction(quantityAction, "Adjust quantity", [
-                    this.makeExpectation("count_changed", "Adjusting quantity should update a visible count or quantity indicator"),
-                    this.makeExpectation("cart_summary_changed", "Adjusting quantity should update the summary values"),
-                    this.makeExpectation(ExpectationType.NetworkRequestMade, "Adjusting quantity should trigger a backend mutation request", {
-                        expectedValue: "mutation",
-                        timeoutMs: 3000,
-                    }),
-                    this.makeExpectation(ExpectationType.NoDuplicateMutationRequests, "Adjusting quantity should not trigger duplicate mutation requests"),
-                    this.makeExpectation("loading_completes", "Quantity adjustment should complete loading"),
-                ]),
+        for (const quantityAction of items.filter(item => this.isQuantityAction(item))) {
+            const quantityDelta = this.inferQuantityDelta(quantityAction);
+            const quantityExpectations = [
+                this.makeExpectation("count_changed", "Adjusting quantity should update a visible count or quantity indicator", quantityDelta == null
+                    ? undefined
+                    : { expectedCountDelta: quantityDelta }),
+                this.makeExpectation("cart_summary_changed", "Adjusting quantity should update subtotal, totals, or line pricing"),
+                this.makeExpectation("results_changed", "Adjusting quantity should change the visible cart or line-item state"),
+                this.makeExpectation(ExpectationType.NetworkRequestMade, "Adjusting quantity should trigger a backend mutation request", {
+                    expectedValue: "mutation",
+                    timeoutMs: 3000,
+                }),
+                this.makeExpectation(ExpectationType.NoDuplicateMutationRequests, "Adjusting quantity should not trigger duplicate mutation requests"),
+                this.makeExpectation("feedback_not_duplicated", "Quantity adjustment should not duplicate visible feedback"),
+                this.makeExpectation("loading_completes", "Quantity adjustment should complete loading"),
+                this.makeExpectation("page_responsive", "Page should remain responsive during quantity adjustment"),
+            ].filter(Boolean);
+            journeys.push(this.buildJourneyTestElement(quantityDelta === -1
+                ? "Quantity decrease journey"
+                : quantityDelta === 1
+                    ? "Quantity increase journey"
+                    : "Quantity adjustment journey", ["commerce", "quantity"], context, [
+                this.buildJourneyAction(quantityAction, quantityDelta === -1
+                    ? "Decrease quantity"
+                    : quantityDelta === 1
+                        ? "Increase quantity"
+                        : "Adjust quantity", quantityExpectations),
             ]));
         }
         const filterAction = items.find(item => this.isFilterAction(item));
@@ -1306,7 +1486,9 @@ export class PageAnalyzer {
             journeys.push(this.buildJourneyTestElement("Pagination journey", ["list", "pagination"], context, [
                 this.buildJourneyAction(paginationAction, "Paginate list", [
                     this.makeExpectation(ExpectationType.NavigationOrStateChanged, "Pagination should change the visible list state"),
+                    this.makeExpectation("results_changed", "Pagination should change the visible collection contents"),
                     this.makeExpectation("row_count_changed", "Pagination should change the visible rows or items"),
+                    this.makeExpectation("collection_order_changed", "Pagination should change the visible collection ordering or composition"),
                     this.makeExpectation(ExpectationType.LoadingCompletes, "Pagination should complete loading"),
                 ]),
             ]));
@@ -1330,6 +1512,24 @@ export class PageAnalyzer {
                 ]),
             ]));
         }
+        if (collectionCount > 0 && removeItem && createCollectionAction) {
+            journeys.push(this.buildJourneyTestElement("Collection mutation recovery journey", ["list", "crud", "recovery"], context, [
+                this.buildJourneyAction(removeItem, "Remove record", [
+                    this.makeExpectation("row_count_changed", "Removing a record should change the visible collection", {
+                        expectedCountDelta: -1,
+                    }),
+                    this.makeExpectation("results_changed", "Removing a record should change the visible collection contents"),
+                ]),
+                this.waitStep(500, "Wait for collection mutation"),
+                this.buildJourneyAction(createCollectionAction, "Add record back", [
+                    this.makeExpectation("row_count_changed", "Adding a record back should restore visible collection size", {
+                        expectedCountDelta: 1,
+                    }),
+                    this.makeExpectation("results_changed", "Adding a record back should change the visible collection contents again"),
+                    this.makeExpectation("loading_completes", "Collection recovery should complete loading"),
+                ]),
+            ]));
+        }
         const backCandidate = items.find(item => item.actionKind === "navigate" ||
             this.isMediaOpenItem(item) ||
             this.isAuthEntryItem(item));
@@ -1467,7 +1667,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)) {
@@ -1500,13 +1700,27 @@ 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));
-        return items
+            this.isVariantSelector(item)));
+        const tests = items
             .map(item => this.buildVariantTestElement(item, context))
             .filter((item) => Boolean(item));
+        const purchaseAction = context.actionableItems.find(item => item.visible &&
+            !item.disabled &&
+            Boolean(item.selector) &&
+            (this.isAddToCartItem(item) || this.isCheckoutItem(item)));
+        for (const item of items) {
+            const purchaseJourney = this.buildVariantPurchaseJourney(item, purchaseAction, context);
+            if (purchaseJourney)
+                tests.push(purchaseJourney);
+            const requiredField = this.findRequiredVariantField(item, context.forms);
+            if (requiredField && purchaseAction) {
+                tests.push(this.buildRequiredVariantGuardTestElement(item, requiredField, purchaseAction, context));
+            }
+        }
+        return tests;
     }
     buildVariantTestElement(item, context) {
         const plannedValue = this.extractSelectableValue(item);
@@ -1548,6 +1762,110 @@ export class PageAnalyzer {
             uid: context.uid,
         };
     }
+    buildVariantPurchaseJourney(item, purchaseAction, context) {
+        const plannedValue = this.extractSelectableValue(item);
+        if (!plannedValue || !item.selector || !purchaseAction?.selector) {
+            return null;
+        }
+        const label = this.describeActionableItem(item);
+        const purchaseLabel = this.describeActionableItem(purchaseAction);
+        const purchaseExpectations = this.isAddToCartItem(purchaseAction)
+            ? [
+                this.makeExpectation(ExpectationType.NetworkRequestMade, `${purchaseLabel} should trigger a backend mutation request after selecting ${label}`, {
+                    expectedValue: "mutation",
+                    timeoutMs: 3000,
+                }),
+                this.makeExpectation(ExpectationType.NoDuplicateMutationRequests, `${purchaseLabel} should not trigger duplicate mutation requests after selecting ${label}`),
+                this.makeExpectation(ExpectationType.CountChanged, `${purchaseLabel} should update a visible count after selecting ${label}`, {
+                    expectedCountDelta: 1,
+                }),
+                this.makeExpectation(ExpectationType.CartSummaryChanged, `${purchaseLabel} should update cart summary after selecting ${label}`),
+                this.makeExpectation(ExpectationType.FeedbackVisible, `${purchaseLabel} should provide visible feedback after selecting ${label}`, {
+                    expectedTextTokens: ["added", "success", "cart", "bag"],
+                    forbiddenTextTokens: ["error", "failed"],
+                }),
+            ]
+            : [
+                this.makeExpectation(ExpectationType.NetworkRequestMade, `${purchaseLabel} should trigger a request or transition after selecting ${label}`, {
+                    expectedValue: "ANY",
+                    timeoutMs: 3000,
+                    expectedTextTokens: ["checkout", "buy", "order"],
+                }),
+                this.makeExpectation(ExpectationType.NavigationOrStateChanged, `${purchaseLabel} should advance the purchase flow after selecting ${label}`),
+            ];
+        return {
+            title: `Variant purchase journey ${label}`,
+            type: "interaction",
+            sizeClass: context.sizeClass,
+            surface_tags: ["variant", "purchase"],
+            priority: 2,
+            startingPageStateId: context.currentPageStateId,
+            startingPath: context.currentPath,
+            steps: [
+                {
+                    action: {
+                        actionType: PlaywrightAction.SelectOption,
+                        path: item.selector,
+                        value: plannedValue,
+                        playwrightCode: `await page.locator('${item.selector}').selectOption('${this.escapeSingleQuotes(plannedValue)}')`,
+                        description: `Select variant ${label}`,
+                    },
+                    expectations: [
+                        this.makeExpectation(ExpectationType.InputValue, `Selecting ${label} should update the chosen option`, {
+                            targetPath: item.selector,
+                            expectedValue: plannedValue,
+                        }),
+                        this.makeExpectation(ExpectationType.VariantStateChanged, `Selecting ${label} should update product state before purchase`, {
+                            targetPath: item.selector,
+                            expectedValue: plannedValue,
+                        }),
+                    ],
+                    description: `Select variant ${label}`,
+                    continueOnFailure: false,
+                },
+                this.buildJourneyAction(purchaseAction, `Purchase with selected ${label}`, [
+                    ...purchaseExpectations,
+                    this.makeExpectation(ExpectationType.LoadingCompletes, `${purchaseLabel} should complete loading after selecting ${label}`),
+                    this.makeExpectation(ExpectationType.PageResponsive, `Page should remain responsive while completing ${purchaseLabel}`),
+                ]),
+            ],
+            globalExpectations: this.defaultFlowExpectations(`Variant purchase journey for ${label} should execute cleanly`),
+            uid: context.uid,
+        };
+    }
+    buildRequiredVariantGuardTestElement(item, requiredField, purchaseAction, context) {
+        const label = this.describeActionableItem(item);
+        const purchaseLabel = this.describeActionableItem(purchaseAction);
+        return {
+            title: `Variant required guard ${label}`,
+            type: "interaction",
+            sizeClass: context.sizeClass,
+            surface_tags: ["variant", "validation", "guard"],
+            priority: 3,
+            startingPageStateId: context.currentPageStateId,
+            startingPath: context.currentPath,
+            steps: [
+                this.buildJourneyAction(purchaseAction, `Attempt ${purchaseLabel} without selecting ${label}`, [
+                    this.makeExpectation(ExpectationType.RequiredErrorShownForField, `${label} should show required validation before ${purchaseLabel}`, {
+                        targetPath: requiredField.selector,
+                    }),
+                    this.makeExpectation(ExpectationType.PageResponsive, `Page should remain responsive when ${purchaseLabel} is blocked by missing ${label}`),
+                ]),
+            ],
+            globalExpectations: this.defaultFlowExpectations(`${label} should be enforced before ${purchaseLabel}`),
+            uid: context.uid,
+        };
+    }
+    findRequiredVariantField(item, forms) {
+        for (const form of forms) {
+            const field = form.fields.find(field => field.selector === item.selector &&
+                field.required &&
+                this.isSearchField(field) === false);
+            if (field)
+                return field;
+        }
+        return undefined;
+    }
     buildDisclosureToggleTestElement(item, startingPath, sizeClass, uid, startingPageStateId) {
         const label = this.describeActionableItem(item);
         return {
@@ -1600,7 +1918,11 @@ export class PageAnalyzer {
                         playwrightCode: `await page.locator('${item.selector}').focus()`,
                         description: `Focus ${label}`,
                     },
-                    expectations: [],
+                    expectations: [
+                        this.makeExpectation(ExpectationType.ElementFocused, `${label} should be keyboard-focusable`, {
+                            targetPath: item.selector,
+                        }),
+                    ],
                     description: `Focus ${label}`,
                     continueOnFailure: false,
                 },
@@ -1863,6 +2185,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);
@@ -1875,12 +2198,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));
     }
@@ -1888,11 +2292,36 @@ export class PageAnalyzer {
         return /\b(checkout|proceed to checkout|submit order|place order)\b/.test(this.semanticText(item));
     }
     isRemoveItemAction(item) {
-        return /\b(remove|delete|trash|clear item|remove item)\b/.test(this.semanticText(item));
+        return /\b(remove|delete|trash|clear item|remove item|dismiss|archive|hide item|close item)\b/.test(this.semanticText(item));
+    }
+    estimateCollectionCount(html) {
+        const tableRows = (html.match(/<tr\b/gi) ?? []).length;
+        if (tableRows > 0)
+            return tableRows;
+        const listItems = (html.match(/<li\b/gi) ?? []).length;
+        if (listItems > 0)
+            return listItems;
+        const cards = (html.match(/<(?:article|section|div)\b[^>]*(?:product|card|result|item|row)[^>]*>/gi) ?? []).length;
+        return cards;
     }
     isAuthEntryItem(item) {
         return /\b(sign up|register|create account|sign in|log in|login)\b/.test(this.semanticText(item));
     }
+    isProtectedActionItem(item) {
+        return /\b(checkout|pricing|view price|account|settings|billing|subscription|dashboard|admin|manage account|saved items|favorites|download)\b/.test(this.semanticText(item));
+    }
+    isLogoutAction(item) {
+        return /\b(log out|logout|sign out)\b/.test(this.semanticText(item));
+    }
+    isRetryAction(item) {
+        return /\b(retry|try again|resend|send again|reload|refresh|reconnect|resume)\b/.test(this.semanticText(item));
+    }
+    isCreateCollectionAction(item) {
+        const text = this.semanticText(item);
+        if (this.isAddToCartItem(item))
+            return false;
+        return /\b(add row|add record|add item|new row|new record|create item|create record|add another|new item)\b/.test(text);
+    }
     isMediaOpenItem(item) {
         const text = this.semanticText(item);
         return (item.tagName === "VIDEO" ||
@@ -1906,6 +2335,16 @@ export class PageAnalyzer {
     isQuantityAction(item) {
         return /\b(qty|quantity|increase|decrease|increment|decrement|plus|minus)\b/.test(this.semanticText(item));
     }
+    inferQuantityDelta(item) {
+        const text = this.semanticText(item);
+        if (/\b(decrease|decrement|minus|remove one|lower qty|lower quantity)\b/.test(text)) {
+            return -1;
+        }
+        if (/\b(increase|increment|plus|add one|raise qty|raise quantity)\b/.test(text)) {
+            return 1;
+        }
+        return undefined;
+    }
     isFilterAction(item) {
         return /\b(filter|refine|apply filter|show results|category|brand|size|color|price)\b/.test(this.semanticText(item));
     }