@sudobility/testomniac_runner_service 0.1.65 → 0.1.67

package/dist/analyzer/page-analyzer/index.js

@@ -4,16 +4,19 @@ import { createHash } from "node:crypto";
 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";
+import { generateNavigationTestInteractions } from "./generators/navigation";
+import { generateScaffoldTestInteractions } from "./generators/scaffolds";
+import { generateRenderTestInteractions } from "./generators/render";
+import { generateFormTestInteractions } from "./generators/forms";
+import { generateE2ETestInteractions } from "./generators/e2e";
+import { generateSemanticJourneyTestInteractions } from "./generators/semantic-journeys";
+import { generateDialogLifecycleTestInteractions } from "./generators/dialogs";
+import { generateKeyboardAndDisclosureTestInteractions } from "./generators/keyboard-disclosure";
+import { generateVariantTestInteractions } from "./generators/variants";
+import { generateContentTestInteractions } from "./generators/content";
+function logAnalyzer(step, details) {
+    console.info("[PageAnalyzer]", step, details ?? {});
+}
 /**
  * PageAnalyzer generates expectations and discovers new test elements
  * during discovery mode.
@@ -23,8 +26,10 @@ export class PageAnalyzer {
      * Generate baseline expectations for a test element.
      * Called BEFORE expertises evaluate.
      */
-    generateExpectations(testElement) {
-        const steps = Array.isArray(testElement.steps) ? testElement.steps : [];
+    generateExpectations(testInteraction) {
+        const steps = Array.isArray(testInteraction.steps)
+            ? testInteraction.steps
+            : [];
         const expectations = [
             {
                 expectationType: ExpectationType.PageLoaded,
@@ -56,55 +61,110 @@ export class PageAnalyzer {
      * Generate new test elements for scaffolds and page content.
      * Called AFTER expertises evaluate and the target page state is established.
      */
-    async generateTestElements(testElement, context) {
+    async generateTestInteractions(testInteraction, context) {
+        logAnalyzer("generate:start", {
+            sourceTitle: testInteraction.title,
+            sourceType: testInteraction.type,
+            sourcePriority: testInteraction.priority,
+            sourceSurfaceTags: testInteraction.surface_tags,
+            currentTestInteractionId: context.currentTestInteractionId,
+            currentTestSurfaceId: context.currentTestSurfaceId,
+            currentSurfaceRunId: context.currentSurfaceRunId ?? null,
+            beginningPageStateId: context.beginningPageStateId,
+            currentPageStateId: context.currentPageStateId,
+            currentPath: context.currentPath,
+            actionableItemsCount: context.actionableItems.length,
+            formsCount: context.forms.length,
+            scaffoldsCount: context.scaffolds.length,
+        });
         const normalizedContext = this.normalizeContext(context);
         const currentPageStateId = await this.ensureTargetPageState(normalizedContext);
         const resolvedContext = {
             ...normalizedContext,
             currentPageStateId,
         };
-        if (this.isHoverOnly(testElement)) {
-            await generateHoverFollowUpCases(this, testElement, resolvedContext);
+        logAnalyzer("generate:resolved-context", {
+            sourceTitle: testInteraction.title,
+            sourceType: testInteraction.type,
+            currentTestInteractionId: resolvedContext.currentTestInteractionId,
+            currentTestSurfaceId: resolvedContext.currentTestSurfaceId,
+            currentSurfaceRunId: resolvedContext.currentSurfaceRunId ?? null,
+            beginningPageStateId: resolvedContext.beginningPageStateId,
+            currentPageStateId: resolvedContext.currentPageStateId,
+            currentPath: resolvedContext.currentPath,
+        });
+        if (this.isHoverOnly(testInteraction)) {
+            logAnalyzer("generate:hover-only", {
+                sourceTitle: testInteraction.title,
+                currentTestInteractionId: resolvedContext.currentTestInteractionId,
+                currentPageStateId: resolvedContext.currentPageStateId,
+            });
+            await generateHoverFollowUpCases(this, testInteraction, resolvedContext);
             return;
         }
-        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);
-        await generateNavigationTestElements(this, resolvedContext);
+        logAnalyzer("generate:full-pass", {
+            sourceTitle: testInteraction.title,
+            currentTestInteractionId: resolvedContext.currentTestInteractionId,
+            currentPageStateId: resolvedContext.currentPageStateId,
+        });
+        await generateRenderTestInteractions(this, resolvedContext);
+        await generateFormTestInteractions(this, resolvedContext);
+        await generateSemanticJourneyTestInteractions(this, resolvedContext);
+        await generateE2ETestInteractions(this, resolvedContext);
+        await generateDialogLifecycleTestInteractions(this, resolvedContext);
+        await generateScaffoldTestInteractions(this, resolvedContext);
+        await generateContentTestInteractions(this, resolvedContext);
+        await generateKeyboardAndDisclosureTestInteractions(this, resolvedContext);
+        await generateVariantTestInteractions(this, resolvedContext);
+        await generateNavigationTestInteractions(this, resolvedContext);
     }
     async reconcileGeneratedSurfaceElements(context, params) {
         const surface = params.surfaceId != null
             ? { id: params.surfaceId, title: params.surfaceTitle }
             : await this.findExistingSurfaceByTitle(context, params.surfaceTitle);
-        if (!surface)
+        if (!surface) {
+            logAnalyzer("reconcile:surface-missing", {
+                requestedSurfaceId: params.surfaceId ?? null,
+                requestedSurfaceTitle: params.surfaceTitle,
+                dependencyTestInteractionId: params.dependencyTestInteractionId ?? null,
+                desiredKeysCount: params.desiredKeys.length,
+            });
             return;
-        const existing = await context.api.getTestElementsByTestSurface(surface.id, true);
+        }
+        const existing = await context.api.getTestInteractionsByTestSurface(surface.id, true);
         const desiredKeys = new Set(params.desiredKeys.map(key => key.trim()).filter(Boolean));
         const obsoleteIds = existing
-            .filter(testElement => {
-            const isGenerated = Boolean(testElement.isGenerated);
-            const isActive = testElement.isActive !== false;
+            .filter(testInteraction => {
+            const isGenerated = Boolean(testInteraction.isGenerated);
+            const isActive = testInteraction.isActive !== false;
             if (!isGenerated || !isActive)
                 return false;
-            if (testElement.startingPageStateId !== context.currentPageStateId)
+            if (testInteraction.startingPageStateId !== context.currentPageStateId)
                 return false;
-            if ((testElement.dependencyTestElementId ?? null) !==
-                (params.dependencyTestElementId ?? null)) {
+            if ((testInteraction.dependencyTestInteractionId ?? null) !==
+                (params.dependencyTestInteractionId ?? null)) {
                 return false;
             }
-            const existingKey = this.getPersistedGeneratedKey(testElement);
+            const existingKey = this.getPersistedGeneratedKey(testInteraction);
             return !existingKey || !desiredKeys.has(existingKey);
         })
-            .map(testElement => testElement.id);
+            .map(testInteraction => testInteraction.id);
+        logAnalyzer("reconcile:evaluated", {
+            surfaceId: surface.id,
+            surfaceTitle: surface.title,
+            dependencyTestInteractionId: params.dependencyTestInteractionId ?? null,
+            desiredKeysCount: desiredKeys.size,
+            existingCount: existing.length,
+            obsoleteIds,
+        });
         if (obsoleteIds.length === 0)
             return;
-        await context.api.retireTestElements(obsoleteIds);
+        await context.api.retireTestInteractions(obsoleteIds);
+        logAnalyzer("reconcile:retired", {
+            surfaceId: surface.id,
+            surfaceTitle: surface.title,
+            obsoleteIds,
+        });
     }
     async findExistingSurfaceByTitle(context, title) {
         const surfaces = await context.api.getTestSurfacesByRunner(context.runnerId);
@@ -123,12 +183,23 @@ export class PageAnalyzer {
         const openSurfaceRuns = await api.getOpenTestSurfaceRuns(bundleRunId);
         const existing = openSurfaceRuns.find(surfaceRun => surfaceRun.testSurfaceId === testSurfaceId);
         if (existing) {
+            logAnalyzer("surface-run:reused", {
+                bundleRunId,
+                testSurfaceId,
+                surfaceRunId: existing.id,
+            });
             return existing;
         }
-        return api.createTestSurfaceRun({
+        const created = await api.createTestSurfaceRun({
             testSurfaceId,
             testSurfaceBundleRunId: bundleRunId,
         });
+        logAnalyzer("surface-run:created", {
+            bundleRunId,
+            testSurfaceId,
+            surfaceRunId: created.id,
+        });
+        return created;
     }
     isMouseActionable(item) {
         return (item.visible &&
@@ -149,7 +220,7 @@ export class PageAnalyzer {
             return null;
         }
     }
-    buildNavigationTestElement(path, sizeClass, uid, startingPageStateId) {
+    buildNavigationTestInteraction(path, sizeClass, uid, startingPageStateId) {
         return {
             title: `Navigate to ${path}`,
             type: "navigation",
@@ -176,15 +247,15 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("navigation", startingPageStateId, path),
         };
     }
-    buildHoverTestElement(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestElementId) {
+    buildHoverTestInteraction(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestInteractionId) {
         const label = this.describeActionableItem(item);
         return {
             title: `Hover over ${label}`,
             type: "interaction",
             sizeClass,
             surface_tags: ["interaction", "hover"],
-            priority: 4,
-            dependencyTestElementId,
+            priority: 1,
+            dependencyTestInteractionId,
             startingPageStateId,
             startingPath,
             steps: [
@@ -202,10 +273,10 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
-            generatedKey: this.buildGeneratedKey("hover", startingPageStateId, dependencyTestElementId, item.stableKey ?? item.selector ?? label),
+            generatedKey: this.buildGeneratedKey("hover", startingPageStateId, dependencyTestInteractionId, item.stableKey ?? item.selector ?? label),
         };
     }
-    buildClickTestElement(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestElementId) {
+    buildClickTestInteraction(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestInteractionId) {
         const label = this.describeActionableItem(item);
         return {
             title: `Click ${label}`,
@@ -213,7 +284,7 @@ export class PageAnalyzer {
             sizeClass,
             surface_tags: ["interaction", "click"],
             priority: 5,
-            dependencyTestElementId,
+            dependencyTestInteractionId,
             startingPageStateId,
             startingPath,
             steps: [
@@ -231,16 +302,20 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
-            generatedKey: this.buildGeneratedKey("click", startingPageStateId, dependencyTestElementId, item.stableKey ?? item.selector ?? label),
+            generatedKey: this.buildGeneratedKey("click", startingPageStateId, dependencyTestInteractionId, item.stableKey ?? item.selector ?? label),
         };
     }
-    isHoverOnly(testElement) {
-        const steps = Array.isArray(testElement.steps) ? testElement.steps : [];
+    isHoverOnly(testInteraction) {
+        const steps = Array.isArray(testInteraction.steps)
+            ? testInteraction.steps
+            : [];
         return (steps.length === 1 &&
             steps[0]?.action?.actionType === PlaywrightAction.Hover);
     }
-    getPrimarySelector(testElement) {
-        const steps = Array.isArray(testElement.steps) ? testElement.steps : [];
+    getPrimarySelector(testInteraction) {
+        const steps = Array.isArray(testInteraction.steps)
+            ? testInteraction.steps
+            : [];
         const step = steps[0];
         return step?.action.path ?? null;
     }
@@ -249,20 +324,20 @@ export class PageAnalyzer {
         const selector = item.selector;
         return stableKey ?? selector ?? null;
     }
-    withGeneratedKey(testElement, ...parts) {
+    withGeneratedKey(testInteraction, ...parts) {
         return {
-            ...testElement,
+            ...testInteraction,
             generatedKey: this.buildGeneratedKey(...parts),
         };
     }
-    getGeneratedKey(testElement) {
-        return (testElement.generatedKey?.trim() || testElement.title).trim();
+    getGeneratedKey(testInteraction) {
+        return (testInteraction.generatedKey?.trim() || testInteraction.title).trim();
     }
-    getPersistedGeneratedKey(testElement) {
-        const generatedKey = testElement.generatedKey?.trim();
+    getPersistedGeneratedKey(testInteraction) {
+        const generatedKey = testInteraction.generatedKey?.trim();
         if (generatedKey)
             return generatedKey;
-        const title = testElement.title?.trim();
+        const title = testInteraction.title?.trim();
         return title || null;
     }
     buildGeneratedKey(...parts) {
@@ -396,7 +471,7 @@ export class PageAnalyzer {
     normalizeForms(forms) {
         return Array.isArray(forms) ? forms : [];
     }
-    buildRenderTestElement(currentPath, sizeClass, uid, startingPageStateId, pageId) {
+    buildRenderTestInteraction(currentPath, sizeClass, uid, startingPageStateId, pageId) {
         return {
             title: `Render — ${currentPath}`,
             type: "render",
@@ -452,7 +527,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("render", startingPageStateId, pageId, currentPath),
         };
     }
-    buildFormTestElement(form, formLabel, formType, currentPath, sizeClass, uid, startingPageStateId, validValues) {
+    buildFormTestInteraction(form, formLabel, formType, currentPath, sizeClass, uid, startingPageStateId, validValues) {
         const steps = this.buildFormSteps(form, validValues, undefined);
         return {
             title: `Form — ${formLabel}`,
@@ -497,7 +572,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("form-positive", startingPageStateId, form.selector, formType),
         };
     }
-    buildNegativeFormTestElement(form, formLabel, formType, omittedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
+    buildNegativeFormTestInteraction(form, formLabel, formType, omittedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
         const steps = this.buildFormSteps(form, validValues, omittedField.selector, this.buildValuePreservationExpectations(form, validValues, omittedField.selector));
         return {
             title: `Form Negative — ${formLabel} (missing ${this.fieldLabel(omittedField)})`,
@@ -520,7 +595,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("form-negative", startingPageStateId, form.selector, formType, omittedField.selector),
         };
     }
-    buildFormCorrectionTestElement(form, formLabel, formType, correctedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
+    buildFormCorrectionTestInteraction(form, formLabel, formType, correctedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
         const steps = this.buildFormSteps(form, validValues, correctedField.selector, this.buildValuePreservationExpectations(form, validValues, correctedField.selector));
         const correctionValue = validValues[correctedField.selector];
         if (correctionValue) {
@@ -565,7 +640,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("form-correction", startingPageStateId, form.selector, formType, correctedField.selector),
         };
     }
-    buildPasswordTestElements(form, formLabel, formType, currentPath, sizeClass, uid, startingPageStateId, validValues, passwordRequirements) {
+    buildPasswordTestInteractions(form, formLabel, formType, currentPath, sizeClass, uid, startingPageStateId, validValues, passwordRequirements) {
         const passwordFields = form.fields.filter(field => field.type === "password");
         if (passwordFields.length === 0)
             return [];
@@ -602,7 +677,7 @@ export class PageAnalyzer {
             };
         });
     }
-    buildE2ETestElement(currentPath, sizeClass, uid, startingPageStateId, journeySteps) {
+    buildE2ETestInteraction(currentPath, sizeClass, uid, startingPageStateId, journeySteps) {
         return {
             title: `E2E — Journey to ${currentPath}`,
             type: "e2e",
@@ -864,7 +939,7 @@ export class PageAnalyzer {
             .toLowerCase();
         return field.type === "search" || /\bsearch\b/.test(text);
     }
-    buildSearchTestElements(form, formLabel, currentPath, sizeClass, uid, startingPageStateId, validValues, actionableItems) {
+    buildSearchTestInteractions(form, formLabel, currentPath, sizeClass, uid, startingPageStateId, validValues, actionableItems) {
         const searchField = form.fields.find(field => this.isSearchField(field));
         if (!searchField)
             return [];
@@ -998,7 +1073,7 @@ export class PageAnalyzer {
         const descriptor = namedField?.label || namedField?.name || `form ${index + 1}`;
         return `${descriptor} @ ${form.selector}`;
     }
-    buildSemanticJourneyTestElements(context) {
+    buildSemanticJourneyTestInteractions(context) {
         const items = this.selectRepresentativeItems(context.actionableItems.filter(item => item.visible && !item.disabled && Boolean(item.selector)));
         const journeys = [];
         const collectionCount = this.estimateCollectionCount(context.html);
@@ -1006,7 +1081,7 @@ export class PageAnalyzer {
         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, [
+            journeys.push(this.buildJourneyTestInteraction("Commerce journey", ["commerce", "cart", "checkout"], context, [
                 this.buildJourneyAction(addToCart, "Add item to cart", [
                     this.makeExpectation("navigation_or_state_changed", "Adding an item to cart should update the page state"),
                     this.makeExpectation("count_changed", "Adding an item should update a visible count", {
@@ -1076,7 +1151,7 @@ export class PageAnalyzer {
                     severity: ExpectationSeverity.ShouldPass,
                 }));
             }
-            journeys.push(this.buildJourneyTestElement("Remove item from collection", ["commerce", "remove"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Remove item from collection", ["commerce", "remove"], context, [
                 this.buildJourneyAction(removeItem, "Remove item", removeExpectations),
             ]));
         }
@@ -1096,13 +1171,13 @@ export class PageAnalyzer {
                 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, [
+            journeys.push(this.buildJourneyTestInteraction("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));
         if (authEntry) {
-            journeys.push(this.buildJourneyTestElement("Authentication entry journey", ["auth"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Authentication entry journey", ["auth"], context, [
                 this.buildJourneyAction(authEntry, "Open authentication entry point", [
                     this.makeExpectation("navigation_or_state_changed", "Authentication entry should open the next auth state"),
                     this.makeExpectation("loading_completes", "Authentication entry flow should settle"),
@@ -1112,7 +1187,7 @@ 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, [
+            journeys.push(this.buildJourneyTestInteraction("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"),
@@ -1122,7 +1197,7 @@ export class PageAnalyzer {
         }
         const logoutAction = items.find(item => this.isLogoutAction(item));
         if (logoutAction) {
-            journeys.push(this.buildJourneyTestElement("Logout journey", ["auth", "logout"], context, [
+            journeys.push(this.buildJourneyTestInteraction("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"),
@@ -1138,7 +1213,7 @@ export class PageAnalyzer {
         }
         const retryAction = items.find(item => this.isRetryAction(item));
         if (retryAction) {
-            journeys.push(this.buildJourneyTestElement("Retry recovery journey", ["recovery", "retry"], context, [
+            journeys.push(this.buildJourneyTestInteraction("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", {
@@ -1164,7 +1239,7 @@ export class PageAnalyzer {
             if (this.isVideoLikeItem(mediaCandidate)) {
                 mediaExpectations.push(this.makeExpectation("video_playable", "Opened video should be playable"));
             }
-            journeys.push(this.buildJourneyTestElement("Media open journey", ["media"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Media open journey", ["media"], context, [
                 this.buildJourneyAction(mediaCandidate, "Open media", mediaExpectations),
             ]));
         }
@@ -1185,7 +1260,7 @@ export class PageAnalyzer {
                 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
+            journeys.push(this.buildJourneyTestInteraction(quantityDelta === -1
                 ? "Quantity decrease journey"
                 : quantityDelta === 1
                     ? "Quantity increase journey"
@@ -1199,14 +1274,14 @@ export class PageAnalyzer {
         }
         const filterAction = items.find(item => this.isFilterAction(item));
         if (filterAction) {
-            journeys.push(this.buildJourneyTestElement("Filter results journey", ["filter"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Filter results journey", ["filter"], context, [
                 this.buildJourneyAction(filterAction, "Apply filter", [
                     this.makeExpectation("navigation_or_state_changed", "Applying a filter should change the result state"),
                     this.makeExpectation("results_changed", "Applying a filter should change the visible result summary"),
                     this.makeExpectation("loading_completes", "Filter update should complete loading"),
                 ]),
             ]));
-            journeys.push(this.buildJourneyTestElement("Filter persistence journey", ["filter", "reload"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Filter persistence journey", ["filter", "reload"], context, [
                 this.buildJourneyAction(filterAction, "Apply filter", [
                     this.makeExpectation("navigation_or_state_changed", "Applying a filter should change the result state"),
                 ]),
@@ -1220,7 +1295,7 @@ export class PageAnalyzer {
         }
         const sortAction = items.find(item => this.isSortAction(item));
         if (sortAction) {
-            journeys.push(this.buildJourneyTestElement("Sort results journey", ["sort"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Sort results journey", ["sort"], context, [
                 this.buildJourneyAction(sortAction, "Change sort order", [
                     this.makeExpectation("navigation_or_state_changed", "Changing sort should update the result state"),
                     this.makeExpectation("collection_order_changed", "Changing sort should change the visible collection ordering"),
@@ -1230,7 +1305,7 @@ export class PageAnalyzer {
         }
         const paginationAction = items.find(item => this.isPaginationAction(item));
         if (paginationAction) {
-            journeys.push(this.buildJourneyTestElement("Pagination journey", ["list", "pagination"], context, [
+            journeys.push(this.buildJourneyTestInteraction("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"),
@@ -1241,7 +1316,7 @@ export class PageAnalyzer {
             ]));
         }
         if (addToCart) {
-            journeys.push(this.buildJourneyTestElement("Cart persistence journey", ["commerce", "reload"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Cart persistence journey", ["commerce", "reload"], context, [
                 this.buildJourneyAction(addToCart, "Add item to cart", [
                     this.makeExpectation("navigation_or_state_changed", "Adding an item should change page state before reload"),
                 ]),
@@ -1260,7 +1335,7 @@ export class PageAnalyzer {
             ]));
         }
         if (collectionCount > 0 && removeItem && createCollectionAction) {
-            journeys.push(this.buildJourneyTestElement("Collection mutation recovery journey", ["list", "crud", "recovery"], context, [
+            journeys.push(this.buildJourneyTestInteraction("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,
@@ -1281,7 +1356,7 @@ export class PageAnalyzer {
             this.isMediaOpenItem(item) ||
             this.isAuthEntryItem(item));
         if (backCandidate) {
-            journeys.push(this.buildJourneyTestElement("Back and forward navigation journey", ["navigation", "history"], context, [
+            journeys.push(this.buildJourneyTestInteraction("Back and forward navigation journey", ["navigation", "history"], context, [
                 this.buildJourneyAction(backCandidate, "Navigate to next state", [
                     this.makeExpectation("navigation_or_state_changed", "Navigation should move to a different state"),
                 ]),
@@ -1297,7 +1372,7 @@ export class PageAnalyzer {
         }
         return journeys;
     }
-    buildJourneyTestElement(title, surfaceTags, context, steps) {
+    buildJourneyTestInteraction(title, surfaceTags, context, steps) {
         return {
             title: `${title} — ${context.currentPath}`,
             type: "e2e",
@@ -1414,18 +1489,18 @@ export class PageAnalyzer {
     isCheckboxLike(field) {
         return field.type === "checkbox" || field.type === "radio";
     }
-    buildKeyboardAndDisclosureTestElements(context) {
+    buildKeyboardAndDisclosureTestInteractions(context) {
         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)) {
-                tests.push(this.buildDisclosureToggleTestElement(item, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
-                tests.push(this.buildKeyboardActivateTestElement(item, "Enter", "Activate disclosure with Enter", [
+                tests.push(this.buildDisclosureToggleTestInteraction(item, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
+                tests.push(this.buildKeyboardActivateTestInteraction(item, "Enter", "Activate disclosure with Enter", [
                     this.makeExpectation("expanded_state_changed", "Enter should toggle the disclosure state", {
                         targetPath: item.selector,
                     }),
                 ], context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
-                tests.push(this.buildKeyboardActivateTestElement(item, " ", "Activate disclosure with Space", [
+                tests.push(this.buildKeyboardActivateTestInteraction(item, " ", "Activate disclosure with Space", [
                     this.makeExpectation("expanded_state_changed", "Space should toggle the disclosure state", {
                         targetPath: item.selector,
                     }),
@@ -1433,12 +1508,12 @@ export class PageAnalyzer {
                 continue;
             }
             if (this.isKeyboardPrimaryAction(item)) {
-                tests.push(this.buildKeyboardActivateTestElement(item, "Enter", "Activate with Enter", [
+                tests.push(this.buildKeyboardActivateTestInteraction(item, "Enter", "Activate with Enter", [
                     this.makeExpectation("navigation_or_state_changed", "Enter key activation should change the page or control state"),
                 ], context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
             }
             if (this.isKeyboardToggleAction(item)) {
-                tests.push(this.buildKeyboardActivateTestElement(item, " ", "Toggle with Space", [
+                tests.push(this.buildKeyboardActivateTestInteraction(item, " ", "Toggle with Space", [
                     this.makeExpectation(ExpectationType.ElementChecked, "Space key activation should toggle the control state", {
                         targetPath: item.selector,
                     }),
@@ -1447,13 +1522,13 @@ export class PageAnalyzer {
         }
         return tests;
     }
-    buildVariantTestElements(context) {
+    buildVariantTestInteractions(context) {
         const items = this.selectRepresentativeItems(context.actionableItems.filter(item => item.visible &&
             !item.disabled &&
             Boolean(item.selector) &&
             this.isVariantSelector(item)));
         const tests = items
-            .map(item => this.buildVariantTestElement(item, context))
+            .map(item => this.buildVariantTestInteraction(item, context))
             .filter((item) => Boolean(item));
         const purchaseAction = context.actionableItems.find(item => item.visible &&
             !item.disabled &&
@@ -1465,12 +1540,12 @@ export class PageAnalyzer {
                 tests.push(purchaseJourney);
             const requiredField = this.findRequiredVariantField(item, context.forms);
             if (requiredField && purchaseAction) {
-                tests.push(this.buildRequiredVariantGuardTestElement(item, requiredField, purchaseAction, context));
+                tests.push(this.buildRequiredVariantGuardTestInteraction(item, requiredField, purchaseAction, context));
             }
         }
         return tests;
     }
-    buildVariantTestElement(item, context) {
+    buildVariantTestInteraction(item, context) {
         const plannedValue = this.extractSelectableValue(item);
         if (!plannedValue || !item.selector)
             return null;
@@ -1583,7 +1658,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("variant-purchase", context.currentPageStateId, item.selector, plannedValue, purchaseAction.selector),
         };
     }
-    buildRequiredVariantGuardTestElement(item, requiredField, purchaseAction, context) {
+    buildRequiredVariantGuardTestInteraction(item, requiredField, purchaseAction, context) {
         const label = this.describeActionableItem(item);
         const purchaseLabel = this.describeActionableItem(purchaseAction);
         return {
@@ -1617,7 +1692,7 @@ export class PageAnalyzer {
         }
         return undefined;
     }
-    buildDisclosureToggleTestElement(item, startingPath, sizeClass, uid, startingPageStateId) {
+    buildDisclosureToggleTestInteraction(item, startingPath, sizeClass, uid, startingPageStateId) {
         const label = this.describeActionableItem(item);
         return {
             title: `Toggle disclosure ${label}`,
@@ -1649,7 +1724,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("disclosure-click", startingPageStateId, item.stableKey ?? item.selector ?? label),
         };
     }
-    buildKeyboardActivateTestElement(item, key, titlePrefix, expectations, startingPath, sizeClass, uid, startingPageStateId) {
+    buildKeyboardActivateTestInteraction(item, key, titlePrefix, expectations, startingPath, sizeClass, uid, startingPageStateId) {
         const label = this.describeActionableItem(item);
         return {
             title: `${titlePrefix} ${label}`,
@@ -1695,7 +1770,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("keyboard", startingPageStateId, key === " " ? "space" : key, item.stableKey ?? item.selector ?? label),
         };
     }
-    buildDialogCloseTestElement(item, startingPath, sizeClass, uid, startingPageStateId) {
+    buildDialogCloseTestInteraction(item, startingPath, sizeClass, uid, startingPageStateId) {
         const label = this.describeActionableItem(item);
         return {
             title: `Close dialog via ${label}`,
@@ -1726,7 +1801,7 @@ export class PageAnalyzer {
             generatedKey: this.buildGeneratedKey("dialog-close", startingPageStateId, item.stableKey ?? item.selector ?? label),
         };
     }
-    buildEscapeDialogTestElement(startingPath, sizeClass, uid, startingPageStateId) {
+    buildEscapeDialogTestInteraction(startingPath, sizeClass, uid, startingPageStateId) {
         return {
             title: "Close dialog with Escape",
             type: "interaction",
@@ -1770,7 +1845,7 @@ export class PageAnalyzer {
             inputType === "radio" ||
             inputType === "checkbox");
     }
-    buildControlInteractionTestElement(item, startingPath, sizeClass, uid, startingPageStateId) {
+    buildControlInteractionTestInteraction(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestInteractionId) {
         const label = this.describeActionableItem(item);
         const role = (item.role ?? "").toLowerCase();
         const inputType = (item.inputType ?? "").toLowerCase();
@@ -1836,6 +1911,7 @@ export class PageAnalyzer {
                 role || inputType || item.actionKind || "control",
             ],
             priority: 3,
+            dependencyTestInteractionId,
             startingPageStateId,
             startingPath,
             steps: [
@@ -1856,7 +1932,7 @@ export class PageAnalyzer {
                 ? `${label} should remain non-interactive despite appearing disabled`
                 : `${label} should react without runtime errors`),
             uid,
-            generatedKey: this.buildGeneratedKey("control", startingPageStateId, isImmutable ? "immutable" : "enabled", role || inputType || item.actionKind || "control", item.stableKey ?? item.selector ?? label),
+            generatedKey: this.buildGeneratedKey("control", startingPageStateId, dependencyTestInteractionId, isImmutable ? "immutable" : "enabled", role || inputType || item.actionKind || "control", item.stableKey ?? item.selector ?? label),
         };
     }
     buildImmutableControlExpectations(item, label) {