@sudobility/testomniac_runner_service 0.1.53 → 0.1.55

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

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

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

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

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

@@ -1,8 +1,19 @@
 import { PlaywrightAction, ExpectationType, ExpectationSeverity, } from "@sudobility/testomniac_types";
-import { computeHashes } from "../browser/page-utils";
+import { computeHashes } from "../../browser/page-utils";
 import { createHash } from "node:crypto";
-import { fillValuePlanner } from "../planners/fill-value-planner";
-import { AUTH_URL_PATTERNS, SIGNUP_URL_PATTERNS } from "../config/constants";
+import { fillValuePlanner } from "../../planners/fill-value-planner";
+import { AUTH_URL_PATTERNS, SIGNUP_URL_PATTERNS } from "../../config/constants";
+import { generateHoverFollowUpCases } from "./generators/hover-follow-up";
+import { generateNavigationTestElements } from "./generators/navigation";
+import { generateScaffoldTestElements } from "./generators/scaffolds";
+import { generateRenderTestElements } from "./generators/render";
+import { generateFormTestElements } from "./generators/forms";
+import { generateE2ETestElements } from "./generators/e2e";
+import { generateSemanticJourneyTestElements } from "./generators/semantic-journeys";
+import { generateDialogLifecycleTestElements } from "./generators/dialogs";
+import { generateKeyboardAndDisclosureTestElements } from "./generators/keyboard-disclosure";
+import { generateVariantTestElements } from "./generators/variants";
+import { generateContentTestElements } from "./generators/content";
 /**
  * PageAnalyzer generates expectations and discovers new test elements
  * during discovery mode.
@@ -13,6 +24,7 @@ export class PageAnalyzer {
      * Called BEFORE expertises evaluate.
      */
     generateExpectations(testElement) {
+        const steps = Array.isArray(testElement.steps) ? testElement.steps : [];
         const expectations = [
             {
                 expectationType: ExpectationType.PageLoaded,
@@ -28,8 +40,8 @@ export class PageAnalyzer {
             },
         ];
         // If test element has only a navigation action, no more expectations
-        const isNavigationOnly = testElement.steps.length === 1 &&
-            testElement.steps[0].action.actionType === PlaywrightAction.Goto;
+        const isNavigationOnly = steps.length === 1 &&
+            steps[0]?.action?.actionType === PlaywrightAction.Goto;
         if (!isNavigationOnly) {
             expectations.push({
                 expectationType: ExpectationType.NoConsoleErrors,
@@ -45,414 +57,35 @@ export class PageAnalyzer {
      * Called AFTER expertises evaluate and the target page state is established.
      */
     async generateTestElements(testElement, context) {
-        const currentPageStateId = await this.ensureTargetPageState(context);
+        const normalizedContext = this.normalizeContext(context);
+        const currentPageStateId = await this.ensureTargetPageState(normalizedContext);
         const resolvedContext = {
-            ...context,
+            ...normalizedContext,
             currentPageStateId,
         };
         if (this.isHoverOnly(testElement)) {
-            await this.generateHoverFollowUpCases(testElement, resolvedContext);
-            return;
-        }
-        // a. Navigation test elements — for every link on the page
-        await this.generateNavigationTestElements(resolvedContext);
-        // b. Render test elements — capture render coverage for the page
-        await this.generateRenderTestElements(resolvedContext);
-        // c. Form and password test elements — build form workflows from extracted forms
-        await this.generateFormTestElements(resolvedContext);
-        // d. Synthetic journey test elements — build generic business flows from common UI verbs
-        await this.generateSemanticJourneyTestElements(resolvedContext);
-        // e. Journey test elements — preserve discovered multi-step flows as standalone e2e tests
-        await this.generateE2ETestElements(resolvedContext);
-        // f. Dialog lifecycle cases — only when a dialog is already open in the analyzed state
-        await this.generateDialogLifecycleTestElements(resolvedContext);
-        // g. Scaffold test elements — for each scaffold's actionable elements
-        await this.generateScaffoldTestElements(resolvedContext);
-        // h. Content test elements — for non-scaffold actionable elements
-        await this.generateContentTestElements(resolvedContext);
-        // i. Keyboard/disclosure cases
-        await this.generateKeyboardAndDisclosureTestElements(resolvedContext);
-        // j. Variant/option cases
-        await this.generateVariantTestElements(resolvedContext);
-    }
-    async generateHoverFollowUpCases(testElement, context) {
-        const selector = this.getPrimarySelector(testElement);
-        if (!selector || !context.currentPageStateId)
-            return;
-        const beginningItems = context.beginningPageStateId > 0
-            ? await context.api.getItemsByPageState(context.beginningPageStateId)
-            : [];
-        const beginningKeys = new Set(beginningItems.map(item => this.getItemKey(item)).filter(Boolean));
-        const revealedItems = 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);
-            const tc = await context.api.ensureTestElement(context.runnerId, context.currentTestSurfaceId, clickCase);
-            await context.api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: context.currentSurfaceRunId ?? undefined,
-            });
-            return;
-        }
-        for (const item of revealedItems) {
-            const nextHover = this.buildHoverTestElement(item, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId, context.currentTestElementId);
-            const tc = await context.api.ensureTestElement(context.runnerId, context.currentTestSurfaceId, nextHover);
-            await context.api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: context.currentSurfaceRunId ?? undefined,
-            });
-        }
-    }
-    async generateNavigationTestElements(context) {
-        if (context.pageRequiresLogin)
+            await generateHoverFollowUpCases(this, testElement, resolvedContext);
             return;
-        const { api, runnerId, sizeClass, uid, navigationSurface, bundleRun } = context;
-        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
-        const surfaceRun = await this.ensureSurfaceRun(api, navigationSurface.id, bundleRun.id);
-        for (const link of links) {
-            if (!link.href)
-                continue;
-            const path = this.extractRelativePath(link.href);
-            if (!path)
-                continue;
-            const testElement = this.buildNavigationTestElement(path, sizeClass, uid, context.currentPageStateId);
-            const tc = await api.ensureTestElement(runnerId, navigationSurface.id, testElement);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateScaffoldTestElements(context) {
-        const { api, runnerId, sizeClass, uid, bundleRun } = context;
-        for (const scaffold of context.scaffolds) {
-            const scaffoldItems = this.selectRepresentativeItems(this.getScaffoldSurfaceItems(context, scaffold));
-            if (scaffoldItems.length === 0)
-                continue;
-            // Ensure a test surface for this scaffold
-            const surfaceTitle = `Scaffold: ${scaffold.type}`;
-            const surface = await api.ensureTestSurface(runnerId, {
-                title: surfaceTitle,
-                description: `Tests for ${scaffold.type} scaffold`,
-                startingPageStateId: context.currentPageStateId,
-                startingPath: context.currentPath,
-                sizeClass,
-                priority: 3,
-                surface_tags: ["scaffold", scaffold.type],
-                uid,
-            });
-            context.events.onTestSurfaceCreated({
-                surfaceId: surface.id,
-                title: surface.title,
-            });
-            await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-            const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-            for (const item of scaffoldItems) {
-                const testElement = this.shouldUseDirectControlInteraction(item)
-                    ? this.buildControlInteractionTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId)
-                    : this.buildHoverTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId);
-                const tc = await api.ensureTestElement(runnerId, surface.id, testElement);
-                await api.createTestElementRun({
-                    testElementId: tc.id,
-                    testSurfaceRunId: surfaceRun.id,
-                });
-            }
         }
+        await generateNavigationTestElements(this, resolvedContext);
+        await generateRenderTestElements(this, resolvedContext);
+        await generateFormTestElements(this, resolvedContext);
+        await generateSemanticJourneyTestElements(this, resolvedContext);
+        await generateE2ETestElements(this, resolvedContext);
+        await generateDialogLifecycleTestElements(this, resolvedContext);
+        await generateScaffoldTestElements(this, resolvedContext);
+        await generateContentTestElements(this, resolvedContext);
+        await generateKeyboardAndDisclosureTestElements(this, resolvedContext);
+        await generateVariantTestElements(this, resolvedContext);
     }
     getScaffoldSurfaceItems(context, scaffold) {
-        return context.actionableItems.filter(item => {
+        return this.normalizeActionableItems(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, {
-            title: `Render: ${context.currentPath}`,
-            description: `Render validation for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 2,
-            surface_tags: ["render"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        const testElement = this.buildRenderTestElement(context.currentPath, sizeClass, uid, context.currentPageStateId, context.pageId);
-        const tc = await api.ensureTestElement(runnerId, surface.id, testElement);
-        await api.createTestElementRun({
-            testElementId: tc.id,
-            testSurfaceRunId: surfaceRun.id,
-        });
-    }
-    async generateFormTestElements(context) {
-        if (context.forms.length === 0)
-            return;
-        const { api, runnerId, sizeClass, uid, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Forms: ${context.currentPath}`,
-            description: `Form workflows for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 2,
-            surface_tags: ["form"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (let index = 0; index < context.forms.length; index++) {
-            const form = context.forms[index];
-            const formType = this.identifyFormType(form, context.currentPath);
-            const formLabel = this.describeForm(form, index);
-            const validValues = this.planFormValues(form, context.actionableItems);
-            if (this.isSearchForm(form)) {
-                const searchTests = this.buildSearchTestElements(form, formLabel, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues, context.actionableItems);
-                for (const searchTest of searchTests) {
-                    const searchElement = await api.ensureTestElement(runnerId, surface.id, searchTest);
-                    await api.createTestElementRun({
-                        testElementId: searchElement.id,
-                        testSurfaceRunId: surfaceRun.id,
-                    });
-                }
-                continue;
-            }
-            const positive = this.buildFormTestElement(form, formLabel, formType, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues);
-            const positiveElement = await api.ensureTestElement(runnerId, surface.id, positive);
-            await api.createTestElementRun({
-                testElementId: positiveElement.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-            for (const field of form.fields.filter(field => this.isNegativeCandidateField(field))) {
-                const negative = this.buildNegativeFormTestElement(form, formLabel, formType, field, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues);
-                const negativeElement = await api.ensureTestElement(runnerId, surface.id, negative);
-                await api.createTestElementRun({
-                    testElementId: negativeElement.id,
-                    testSurfaceRunId: surfaceRun.id,
-                });
-                const correction = this.buildFormCorrectionTestElement(form, formLabel, formType, field, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues);
-                const correctionElement = await api.ensureTestElement(runnerId, surface.id, correction);
-                await api.createTestElementRun({
-                    testElementId: correctionElement.id,
-                    testSurfaceRunId: surfaceRun.id,
-                });
-            }
-            if (this.isPasswordScenario(formType, form)) {
-                const passwordTests = this.buildPasswordTestElements(form, formLabel, formType, context.currentPath, sizeClass, uid, context.currentPageStateId, validValues, this.detectPasswordRequirements(this.extractVisibleText(context.html)));
-                for (const passwordTest of passwordTests) {
-                    const passwordElement = await api.ensureTestElement(runnerId, surface.id, passwordTest);
-                    await api.createTestElementRun({
-                        testElementId: passwordElement.id,
-                        testSurfaceRunId: surfaceRun.id,
-                    });
-                }
-            }
-        }
-    }
-    async generateE2ETestElements(context) {
-        if (context.journeySteps.length < 2)
-            return;
-        const { api, runnerId, sizeClass, uid, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Journeys: ${context.currentPath}`,
-            description: `End-to-end journeys reaching ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 2,
-            surface_tags: ["e2e"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        const e2e = this.buildE2ETestElement(context.currentPath, sizeClass, uid, context.currentPageStateId, context.journeySteps);
-        const tc = await api.ensureTestElement(runnerId, surface.id, e2e);
-        await api.createTestElementRun({
-            testElementId: tc.id,
-            testSurfaceRunId: surfaceRun.id,
-        });
-    }
-    async generateSemanticJourneyTestElements(context) {
-        const journeys = this.buildSemanticJourneyTestElements(context);
-        if (journeys.length === 0)
-            return;
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Journeys: ${context.currentPath}`,
-            description: `Semantic multi-step journeys from ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 2,
-            surface_tags: ["e2e", "semantic-journey"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const journey of journeys) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, journey);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateDialogLifecycleTestElements(context) {
-        if (!this.pageHasOpenDialog(context.html))
-            return;
-        const closeCandidates = this.selectRepresentativeItems(context.actionableItems.filter(item => item.visible &&
-            !item.disabled &&
-            item.selector &&
-            this.isDialogCloseItem(item)));
-        const tests = [];
-        for (const item of closeCandidates) {
-            tests.push(this.buildDialogCloseTestElement(item, context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
-        }
-        tests.push(this.buildEscapeDialogTestElement(context.currentPath, context.sizeClass, context.uid, context.currentPageStateId));
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Dialogs: ${context.currentPath}`,
-            description: `Dialog lifecycle checks for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 2,
-            surface_tags: ["dialog"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const test of tests) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, test);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateKeyboardAndDisclosureTestElements(context) {
-        const tests = this.buildKeyboardAndDisclosureTestElements(context);
-        if (tests.length === 0)
-            return;
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Keyboard: ${context.currentPath}`,
-            description: `Keyboard parity and disclosure checks for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 3,
-            surface_tags: ["keyboard", "disclosure"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const test of tests) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, test);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateVariantTestElements(context) {
-        const tests = this.buildVariantTestElements(context);
-        if (tests.length === 0)
-            return;
-        const { api, runnerId, bundleRun } = context;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: `Variants: ${context.currentPath}`,
-            description: `Variant and option state checks for ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass: context.sizeClass,
-            priority: 2,
-            surface_tags: ["variant", "option"],
-            uid: context.uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const test of tests) {
-            const tc = await api.ensureTestElement(runnerId, surface.id, test);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
-    async generateContentTestElements(context) {
-        const { api, runnerId, sizeClass, uid, bundleRun, pageId: _pageId, } = context;
-        // Content items are those NOT in a scaffold
-        const contentItems = this.selectRepresentativeItems(context.actionableItems.filter(item => item.scaffoldId == null && this.isSurfaceCandidate(item)));
-        if (contentItems.length === 0)
-            return;
-        const surfaceTitle = `Page: ${context.currentPath}`;
-        const surface = await api.ensureTestSurface(runnerId, {
-            title: surfaceTitle,
-            description: `Tests for page content at ${context.currentPath}`,
-            startingPageStateId: context.currentPageStateId,
-            startingPath: context.currentPath,
-            sizeClass,
-            priority: 3,
-            surface_tags: ["page-content"],
-            uid,
-        });
-        context.events.onTestSurfaceCreated({
-            surfaceId: surface.id,
-            title: surface.title,
-        });
-        await api.ensureBundleSurfaceLink(bundleRun.testSurfaceBundleId, surface.id);
-        const surfaceRun = await this.ensureSurfaceRun(api, surface.id, bundleRun.id);
-        for (const item of contentItems) {
-            const testElement = this.shouldUseDirectControlInteraction(item)
-                ? this.buildControlInteractionTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId)
-                : this.buildHoverTestElement(item, context.currentPath, sizeClass, uid, context.currentPageStateId);
-            const tc = await api.ensureTestElement(runnerId, surface.id, testElement);
-            await api.createTestElementRun({
-                testElementId: tc.id,
-                testSurfaceRunId: surfaceRun.id,
-            });
-        }
-    }
     async ensureSurfaceRun(api, testSurfaceId, bundleRunId) {
         const openSurfaceRuns = await api.getOpenTestSurfaceRuns(bundleRunId);
         const existing = openSurfaceRuns.find(surfaceRun => surfaceRun.testSurfaceId === testSurfaceId);
@@ -566,11 +199,13 @@ export class PageAnalyzer {
         };
     }
     isHoverOnly(testElement) {
-        return (testElement.steps.length === 1 &&
-            testElement.steps[0].action.actionType === PlaywrightAction.Hover);
+        const steps = Array.isArray(testElement.steps) ? testElement.steps : [];
+        return (steps.length === 1 &&
+            steps[0]?.action?.actionType === PlaywrightAction.Hover);
     }
     getPrimarySelector(testElement) {
-        const step = testElement.steps[0];
+        const steps = Array.isArray(testElement.steps) ? testElement.steps : [];
+        const step = steps[0];
         return step?.action.path ?? null;
     }
     getItemKey(item) {
@@ -649,16 +284,39 @@ export class PageAnalyzer {
         return scaffoldIdsBySelector;
     }
     async ensureStoredForms(pageStateId, context) {
-        if (context.forms.length === 0)
+        const forms = this.normalizeForms(context.forms);
+        if (forms.length === 0)
             return;
         const existing = await context.api.getFormsByPageState(pageStateId);
         const existingSelectors = new Set(existing.map(form => form.selector));
-        for (const form of context.forms) {
+        for (const form of forms) {
             if (existingSelectors.has(form.selector))
                 continue;
             await context.api.insertForm(pageStateId, form, this.identifyFormType(form, context.currentPath));
         }
     }
+    normalizeContext(context) {
+        return {
+            ...context,
+            html: typeof context.html === "string" ? context.html : "",
+            scaffolds: Array.isArray(context.scaffolds) ? context.scaffolds : [],
+            scaffoldSelectorByItemSelector: context.scaffoldSelectorByItemSelector &&
+                typeof context.scaffoldSelectorByItemSelector === "object"
+                ? context.scaffoldSelectorByItemSelector
+                : {},
+            actionableItems: this.normalizeActionableItems(context.actionableItems),
+            forms: this.normalizeForms(context.forms),
+            journeySteps: Array.isArray(context.journeySteps)
+                ? context.journeySteps
+                : [],
+        };
+    }
+    normalizeActionableItems(items) {
+        return Array.isArray(items) ? items : [];
+    }
+    normalizeForms(forms) {
+        return Array.isArray(forms) ? forms : [];
+    }
     buildRenderTestElement(currentPath, sizeClass, uid, startingPageStateId, pageId) {
         return {
             title: `Render — ${currentPath}`,
@@ -2550,4 +2208,4 @@ export class PageAnalyzer {
         return variants;
     }
 }
-//# sourceMappingURL=page-analyzer.js.map
+//# sourceMappingURL=index.js.map