@sudobility/testomniac_runner_service 0.1.58 → 0.1.60

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

@@ -85,7 +85,7 @@ export class PageAnalyzer {
         if (!surface)
             return;
         const existing = await context.api.getTestElementsByTestSurface(surface.id, true);
-        const desiredTitles = new Set(params.desiredTitles);
+        const desiredKeys = new Set(params.desiredKeys.map(key => key.trim()).filter(Boolean));
         const obsoleteIds = existing
             .filter(testElement => {
             const isGenerated = Boolean(testElement.isGenerated);
@@ -98,7 +98,8 @@ export class PageAnalyzer {
                 (params.dependencyTestElementId ?? null)) {
                 return false;
             }
-            return !desiredTitles.has(testElement.title);
+            const existingKey = this.getPersistedGeneratedKey(testElement);
+            return !existingKey || !desiredKeys.has(existingKey);
         })
             .map(testElement => testElement.id);
         if (obsoleteIds.length === 0)
@@ -172,10 +173,11 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
+            generatedKey: this.buildGeneratedKey("navigation", startingPageStateId, path),
         };
     }
     buildHoverTestElement(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestElementId) {
-        const label = item.accessibleName || item.textContent || item.selector;
+        const label = this.describeActionableItem(item);
         return {
             title: `Hover over ${label}`,
             type: "interaction",
@@ -200,10 +202,11 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
+            generatedKey: this.buildGeneratedKey("hover", startingPageStateId, dependencyTestElementId, item.stableKey ?? item.selector ?? label),
         };
     }
     buildClickTestElement(item, startingPath, sizeClass, uid, startingPageStateId, dependencyTestElementId) {
-        const label = item.accessibleName || item.textContent || item.selector;
+        const label = this.describeActionableItem(item);
         return {
             title: `Click ${label}`,
             type: "interaction",
@@ -228,6 +231,7 @@ export class PageAnalyzer {
             ],
             globalExpectations: [],
             uid,
+            generatedKey: this.buildGeneratedKey("click", startingPageStateId, dependencyTestElementId, item.stableKey ?? item.selector ?? label),
         };
     }
     isHoverOnly(testElement) {
@@ -245,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) {
@@ -402,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) {
@@ -446,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) {
@@ -468,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) {
@@ -512,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) {
@@ -547,6 +598,7 @@ export class PageAnalyzer {
                     },
                 ],
                 uid,
+                generatedKey: this.buildGeneratedKey("password", startingPageStateId, form.selector, formType, variant.description, variant.password),
             };
         });
     }
@@ -565,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 = []) {
@@ -845,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}`,
@@ -867,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}`,
@@ -890,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));
@@ -916,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;
@@ -1252,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) {
@@ -1450,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) {
@@ -1521,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) {
@@ -1544,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) {
@@ -1585,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) {
@@ -1630,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) {
@@ -1660,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) {
@@ -1689,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) {
@@ -1706,7 +1771,7 @@ export class PageAnalyzer {
             inputType === "checkbox");
     }
     buildControlInteractionTestElement(item, startingPath, sizeClass, uid, startingPageStateId) {
-        const label = item.accessibleName || item.textContent || item.selector;
+        const label = this.describeActionableItem(item);
         const role = (item.role ?? "").toLowerCase();
         const inputType = (item.inputType ?? "").toLowerCase();
         const isTab = role === "tab";
@@ -1791,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) {
@@ -1873,12 +1939,30 @@ export class PageAnalyzer {
             value.includes("disabled"));
     }
     describeActionableItem(item) {
-        return (item.accessibleName ||
+        const described = (item.accessibleName ||
             item.textContent ||
             String(item.attributes?._containerTitle ?? "") ||
             String(item.attributes?.labelText ?? "") ||
-            String(item.attributes?.placeholder ?? "") ||
-            item.selector);
+            String(item.attributes?.placeholder ?? "")).trim();
+        if (described)
+            return described;
+        const selector = item.selector ?? "";
+        if (selector.includes("data-tmnc-id")) {
+            const role = item.role?.trim();
+            const inputType = item.inputType?.trim();
+            if (role)
+                return role;
+            if (inputType)
+                return inputType;
+            if (item.actionKind === "navigate")
+                return "link";
+            if (item.actionKind === "fill")
+                return "input";
+            if (item.actionKind === "select")
+                return "select";
+            return "control";
+        }
+        return selector || item.actionKind || "control";
     }
     semanticText(item) {
         return [