@sudobility/testomniac_runner_service 0.1.57 → 0.1.59

package/dist/analyzer/page-analyzer/generators/variants.js.map

@@ -1 +1 @@
-{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../../../src/analyzer/page-analyzer/generators/variants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAAa,EACb,OAAwB;IAExB,MAAM,KAAK,GAAG,QAAQ,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE/B,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE;QACpD,KAAK,EAAE,aAAa,OAAO,CAAC,WAAW,EAAE;QACzC,WAAW,EAAE,uCAAuC,OAAO,CAAC,WAAW,EAAE;QACzE,mBAAmB,EAAE,OAAO,CAAC,kBAAkB;QAC/C,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;QACnC,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;QAClC,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,uBAAuB,CAAC,SAAS,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAChD,GAAG,EACH,OAAO,CAAC,EAAE,EACV,SAAS,CAAC,EAAE,CACb,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,MAAM,GAAG,CAAC,oBAAoB,CAAC;YAC7B,aAAa,EAAE,EAAE,CAAC,EAAE;YACpB,gBAAgB,EAAE,UAAU,CAAC,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../../../src/analyzer/page-analyzer/generators/variants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAAa,EACb,OAAwB;IAExB,MAAM,KAAK,GAAG,QAAQ,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,aAAa,OAAO,CAAC,WAAW,EAAE,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,CAAC,iCAAiC,CAAC,OAAO,EAAE;YACxD,YAAY;YACZ,WAAW,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE;QACpD,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,uCAAuC,OAAO,CAAC,WAAW,EAAE;QACzE,mBAAmB,EAAE,OAAO,CAAC,kBAAkB;QAC/C,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;QACnC,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;QAClC,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,uBAAuB,CAAC,SAAS,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAChD,GAAG,EACH,OAAO,CAAC,EAAE,EACV,SAAS,CAAC,EAAE,CACb,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,MAAM,GAAG,CAAC,oBAAoB,CAAC;YAC7B,aAAa,EAAE,EAAE,CAAC,EAAE;YACpB,gBAAgB,EAAE,UAAU,CAAC,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,CAAC,iCAAiC,CAAC,OAAO,EAAE;QACxD,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,YAAY;QACZ,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;KACtE,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,6 +1,9 @@
 import type { TestElement, Expectation } from "@sudobility/testomniac_types";
 import type { AnalyzerContext } from "./types";
 export type { AnalyzerContext } from "./types";
+type GeneratedTestElement = TestElement & {
+    generatedKey?: string;
+};
 /**
  * PageAnalyzer generates expectations and discovers new test elements
  * during discovery mode.
@@ -16,6 +19,13 @@ export declare class PageAnalyzer {
      * Called AFTER expertises evaluate and the target page state is established.
      */
     generateTestElements(testElement: TestElement, context: AnalyzerContext): Promise<void>;
+    reconcileGeneratedSurfaceElements(context: AnalyzerContext, params: {
+        surfaceId?: number | null;
+        surfaceTitle: string;
+        desiredKeys: string[];
+        dependencyTestElementId?: number;
+    }): Promise<void>;
+    private findExistingSurfaceByTitle;
     private getScaffoldSurfaceItems;
     private ensureSurfaceRun;
     private isMouseActionable;
@@ -27,6 +37,11 @@ export declare class PageAnalyzer {
     private isHoverOnly;
     private getPrimarySelector;
     private getItemKey;
+    withGeneratedKey(testElement: GeneratedTestElement, ...parts: Array<string | number | null | undefined>): GeneratedTestElement;
+    getGeneratedKey(testElement: Pick<GeneratedTestElement, "generatedKey" | "title">): string;
+    private getPersistedGeneratedKey;
+    private buildGeneratedKey;
+    private buildStepSignature;
     private ensureTargetPageState;
     private ensureScaffolds;
     private ensureStoredForms;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzer/page-analyzer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAQZ,MAAM,8BAA8B,CAAC;AAYtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAa/C,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,EAAE;IAkC7D;;;OAGG;IACG,oBAAoB,CACxB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IA0BhB,OAAO,CAAC,uBAAuB;YAgBjB,gBAAgB;IAkB9B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,UAAU;YAUJ,qBAAqB;YAsFrB,eAAe;YAkBf,iBAAiB;IAoB/B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,sBAAsB;IAgE9B,OAAO,CAAC,oBAAoB;IAoF5B,OAAO,CAAC,4BAA4B;IAoDpC,OAAO,CAAC,8BAA8B;IA6FtC,OAAO,CAAC,yBAAyB;IAoDjC,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,cAAc;IAsFtB,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,kCAAkC;IAiD1C,OAAO,CAAC,cAAc;IAqDtB,OAAO,CAAC,gBAAgB;IAwDxB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,uBAAuB;IA4K/B,OAAO,CAAC,wBAAwB;IAkChC,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gCAAgC;IAsuBxC,OAAO,CAAC,uBAAuB;IAsB/B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,sCAAsC;IA+G9C,OAAO,CAAC,wBAAwB;IA+ChC,OAAO,CAAC,uBAAuB;IAsD/B,OAAO,CAAC,2BAA2B;IA2HnC,OAAO,CAAC,oCAAoC;IA2C5C,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,gCAAgC;IA4CxC,OAAO,CAAC,gCAAgC;IA6DxC,OAAO,CAAC,2BAA2B;IA6CnC,OAAO,CAAC,4BAA4B;IA2CpC,OAAO,CAAC,iCAAiC;IAiBzC,OAAO,CAAC,kCAAkC;IA6G1C,OAAO,CAAC,iCAAiC;IAoDzC,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,+BAA+B;IAWvC,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,2BAA2B;IAgBnC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,yBAAyB;IA0BjC,OAAO,CAAC,yBAAyB;IAyCjC,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,0BAA0B;IAuClC,OAAO,CAAC,wBAAwB;CAyEjC"}
+{"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/index.js

@@ -78,6 +78,39 @@ export class PageAnalyzer {
         await generateKeyboardAndDisclosureTestElements(this, resolvedContext);
         await generateVariantTestElements(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)
+            return;
+        const existing = await context.api.getTestElementsByTestSurface(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;
+            if (!isGenerated || !isActive)
+                return false;
+            if (testElement.startingPageStateId !== context.currentPageStateId)
+                return false;
+            if ((testElement.dependencyTestElementId ?? null) !==
+                (params.dependencyTestElementId ?? null)) {
+                return false;
+            }
+            const existingKey = this.getPersistedGeneratedKey(testElement);
+            return !existingKey || !desiredKeys.has(existingKey);
+        })
+            .map(testElement => testElement.id);
+        if (obsoleteIds.length === 0)
+            return;
+        await context.api.retireTestElements(obsoleteIds);
+    }
+    async findExistingSurfaceByTitle(context, title) {
+        const surfaces = await context.api.getTestSurfacesByRunner(context.runnerId);
+        const surface = surfaces.find(candidate => candidate.title === title);
+        return surface ? { id: surface.id, title: surface.title } : null;
+    }
     getScaffoldSurfaceItems(context, scaffold) {
         return this.normalizeActionableItems(context.actionableItems).filter(item => {
             if (!this.isSurfaceCandidate(item) || !item.selector)
@@ -140,6 +173,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
+            generatedKey: this.buildGeneratedKey("navigation", startingPageStateId, path),
         };
     }
     buildHoverTestElement(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestElementId) {
@@ -168,6 +202,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
+            generatedKey: this.buildGeneratedKey("hover", startingPageStateId, dependencyTestElementId, item.stableKey ?? item.selector ?? label),
         };
     }
     buildClickTestElement(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestElementId) {
@@ -196,6 +231,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
+            generatedKey: this.buildGeneratedKey("click", startingPageStateId, dependencyTestElementId, item.stableKey ?? item.selector ?? label),
         };
     }
     isHoverOnly(testElement) {
@@ -213,6 +249,49 @@ export class PageAnalyzer {
         const selector = item.selector;
         return stableKey ?? selector ?? null;
     }
+    withGeneratedKey(testElement, ...parts) {
+        return {
+            ...testElement,
+            generatedKey: this.buildGeneratedKey(...parts),
+        };
+    }
+    getGeneratedKey(testElement) {
+        return (testElement.generatedKey?.trim() || testElement.title).trim();
+    }
+    getPersistedGeneratedKey(testElement) {
+        const generatedKey = testElement.generatedKey?.trim();
+        if (generatedKey)
+            return generatedKey;
+        const title = testElement.title?.trim();
+        return title || null;
+    }
+    buildGeneratedKey(...parts) {
+        const normalized = parts
+            .map(part => (part == null ? "" : String(part).trim()))
+            .filter(Boolean);
+        const raw = normalized.join("||");
+        const digest = createHash("sha1").update(raw).digest("hex").slice(0, 16);
+        const prefix = normalized
+            .slice(0, 3)
+            .map(part => part
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/^-+|-+$/g, ""))
+            .filter(Boolean)
+            .join(":")
+            .slice(0, 80);
+        return prefix ? `${prefix}:${digest}` : digest;
+    }
+    buildStepSignature(steps) {
+        return steps
+            .map(step => [
+            step.action?.actionType ?? "",
+            step.action?.path ?? "",
+            step.action?.value ?? "",
+            step.action?.description ?? "",
+        ].join("|"))
+            .join("||");
+    }
     async ensureTargetPageState(context) {
         const scaffoldIdsBySelector = await this.ensureScaffolds(context);
         for (const item of context.actionableItems) {
@@ -370,6 +449,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations("Render page without runtime errors"),
             uid,
+            generatedKey: this.buildGeneratedKey("render", startingPageStateId, pageId, currentPath),
         };
     }
     buildFormTestElement(form, formLabel, formType, currentPath, sizeClass, uid, startingPageStateId, validValues) {
@@ -414,6 +494,7 @@ export class PageAnalyzer {
                 this.makeExpectation("field_error_clears_after_fix", `Validation errors on ${formLabel} should clear once the fields are corrected`),
             ],
             uid,
+            generatedKey: this.buildGeneratedKey("form-positive", startingPageStateId, form.selector, formType),
         };
     }
     buildNegativeFormTestElement(form, formLabel, formType, omittedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
@@ -436,6 +517,7 @@ export class PageAnalyzer {
                 }),
             ],
             uid,
+            generatedKey: this.buildGeneratedKey("form-negative", startingPageStateId, form.selector, formType, omittedField.selector),
         };
     }
     buildFormCorrectionTestElement(form, formLabel, formType, correctedField, currentPath, sizeClass, uid, startingPageStateId, validValues) {
@@ -480,6 +562,7 @@ export class PageAnalyzer {
                 this.makeExpectation("feedback_not_duplicated", `Form ${formLabel} should not show duplicate feedback after correction`),
             ],
             uid,
+            generatedKey: this.buildGeneratedKey("form-correction", startingPageStateId, form.selector, formType, correctedField.selector),
         };
     }
     buildPasswordTestElements(form, formLabel, formType, currentPath, sizeClass, uid, startingPageStateId, validValues, passwordRequirements) {
@@ -515,6 +598,7 @@ export class PageAnalyzer {
                     },
                 ],
                 uid,
+                generatedKey: this.buildGeneratedKey("password", startingPageStateId, form.selector, formType, variant.description, variant.password),
             };
         });
     }
@@ -533,6 +617,7 @@ export class PageAnalyzer {
             })),
             globalExpectations: this.defaultFlowExpectations(`Journey to ${currentPath} should complete without runtime errors`),
             uid,
+            generatedKey: this.buildGeneratedKey("dependency-journey", startingPageStateId, currentPath, this.buildStepSignature(journeySteps)),
         };
     }
     buildFormSteps(form, valuesBySelector, omittedSelector, postSubmitExpectations = []) {
@@ -813,6 +898,7 @@ export class PageAnalyzer {
                     this.makeExpectation(ExpectationType.LoadingCompletes, `Search results for ${formLabel} should finish loading`),
                 ],
                 uid,
+                generatedKey: this.buildGeneratedKey("search", startingPageStateId, form.selector, searchField.selector),
             },
             {
                 title: `Search Empty State — ${formLabel}`,
@@ -835,6 +921,7 @@ export class PageAnalyzer {
                     this.makeExpectation(ExpectationType.LoadingCompletes, `No-result search for ${formLabel} should finish loading`),
                 ],
                 uid,
+                generatedKey: this.buildGeneratedKey("search-empty", startingPageStateId, form.selector, searchField.selector),
             },
             {
                 title: `Search Recovery — ${formLabel}`,
@@ -858,6 +945,7 @@ export class PageAnalyzer {
                     this.makeExpectation(ExpectationType.LoadingCompletes, `Search recovery for ${formLabel} should finish loading`),
                 ],
                 uid,
+                generatedKey: this.buildGeneratedKey("search-recovery", startingPageStateId, form.selector, searchField.selector),
             },
         ];
         const clearAction = actionableItems.find(item => this.isSearchClearItem(item));
@@ -884,6 +972,7 @@ export class PageAnalyzer {
                     this.makeExpectation(ExpectationType.ResultsRestored, `Clearing ${formLabel} should restore the initial results baseline`),
                 ],
                 uid,
+                generatedKey: this.buildGeneratedKey("search-clear", startingPageStateId, form.selector, searchField.selector, clearAction.selector),
             });
         }
         return tests;
@@ -1220,6 +1309,7 @@ export class PageAnalyzer {
             steps,
             globalExpectations: this.defaultFlowExpectations(`${title} should complete without runtime errors`),
             uid: context.uid,
+            generatedKey: this.buildGeneratedKey("semantic-journey", context.currentPageStateId, context.currentPath, this.buildStepSignature(steps)),
         };
     }
     buildJourneyAction(item, description, expectations) {
@@ -1418,6 +1508,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations("Variant selection should complete without runtime errors"),
             uid: context.uid,
+            generatedKey: this.buildGeneratedKey("variant-selection", context.currentPageStateId, item.selector, plannedValue),
         };
     }
     buildVariantPurchaseJourney(item, purchaseAction, context) {
@@ -1489,6 +1580,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations(`Variant purchase journey for ${label} should execute cleanly`),
             uid: context.uid,
+            generatedKey: this.buildGeneratedKey("variant-purchase", context.currentPageStateId, item.selector, plannedValue, purchaseAction.selector),
         };
     }
     buildRequiredVariantGuardTestElement(item, requiredField, purchaseAction, context) {
@@ -1512,6 +1604,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations(`${label} should be enforced before ${purchaseLabel}`),
             uid: context.uid,
+            generatedKey: this.buildGeneratedKey("variant-guard", context.currentPageStateId, item.selector, requiredField.selector, purchaseAction.selector),
         };
     }
     findRequiredVariantField(item, forms) {
@@ -1553,6 +1646,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations("Disclosure interaction should complete without runtime errors"),
             uid,
+            generatedKey: this.buildGeneratedKey("disclosure-click", startingPageStateId, item.stableKey ?? item.selector ?? label),
         };
     }
     buildKeyboardActivateTestElement(item, key, titlePrefix, expectations, startingPath, sizeClass, uid, startingPageStateId) {
@@ -1598,6 +1692,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations("Keyboard activation should complete without runtime errors"),
             uid,
+            generatedKey: this.buildGeneratedKey("keyboard", startingPageStateId, key === " " ? "space" : key, item.stableKey ?? item.selector ?? label),
         };
     }
     buildDialogCloseTestElement(item, startingPath, sizeClass, uid, startingPageStateId) {
@@ -1628,6 +1723,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations("Dialog should close cleanly"),
             uid,
+            generatedKey: this.buildGeneratedKey("dialog-close", startingPageStateId, item.stableKey ?? item.selector ?? label),
         };
     }
     buildEscapeDialogTestElement(startingPath, sizeClass, uid, startingPageStateId) {
@@ -1657,6 +1753,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: this.defaultFlowExpectations("Dialog should close on Escape without runtime errors"),
             uid,
+            generatedKey: this.buildGeneratedKey("dialog-escape", startingPageStateId, startingPath),
         };
     }
     shouldUseDirectControlInteraction(item) {
@@ -1759,6 +1856,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),
         };
     }
     buildImmutableControlExpectations(item, label) {