@dailephd/my-frontend-observer 0.8.1

package/dist/browser/evidenceCapture.d.ts

@@ -0,0 +1,62 @@
+import type { Page, Locator, ElementHandle } from 'playwright';
+import type { EvidenceField } from '../domain/evidence.js';
+import type { Diagnostic } from '../domain/diagnostics.js';
+import type { NamedTarget, Viewport } from '../request/request.js';
+import type { TargetEvidenceRecord, TargetLocatorAttempt, TargetResolution } from '../domain/schema.js';
+/**
+ * Captures the v0.1 minimum page evidence (docs/PROJECT_MILESTONES.md
+ * "Minimum page evidence") from the already-navigated, already-ready page.
+ * `documentWidth`/`documentHeight` are the one explicitly *derived* pair -
+ * max(scroll, client) in each axis - everything else is a direct browser
+ * read, per the Batch 1 evidence-source model.
+ */
+export declare function capturePageEvidence(page: Page, requestedUrl: string, viewport: Viewport): Promise<Record<string, EvidenceField<unknown>>>;
+export interface TargetEvidenceCaptureResult {
+    targetEvidence: Record<string, TargetEvidenceRecord>;
+    diagnostics: Diagnostic[];
+}
+export interface ResolvedTargetInfo {
+    name: string;
+    attempts: TargetLocatorAttempt[];
+    status: TargetResolution['selectionStatus'];
+    selectedIndex?: number;
+    locator?: Locator;
+    handle?: ElementHandle<Element>;
+    unavailableReason?: string;
+}
+/**
+ * Looks up one already-resolved configured target by its stable observer
+ * name (case-insensitively, matching the same case-insensitive comparison
+ * `request.ts#normalizeRequest` already uses for target-name uniqueness) -
+ * never a second locator/resolution algorithm, just a lookup into the
+ * `resolveConfiguredTargets` result already computed once for this
+ * observation.
+ */
+export declare function findResolvedTarget(resolved: readonly ResolvedTargetInfo[], name: string): ResolvedTargetInfo | undefined;
+/**
+ * The one canonical target-resolution algorithm (Phase 1 of the v0.2 Batch 3
+ * three-phase design below), exported so v0.3 Batch 2 scroll-scenario
+ * runtime-snapshot capture can resolve configured targets exactly once and
+ * reuse the same live `{locator, handle}` pairs across its initial/final
+ * snapshots, instead of re-implementing resolution with different locator
+ * semantics. Callers own disposing any returned `handle`.
+ */
+export declare function resolveConfiguredTargets(page: Page, targets: readonly NamedTarget[]): Promise<ResolvedTargetInfo[]>;
+/**
+ * Observes every explicitly configured target from the same live page,
+ * honoring the frozen ordered-locator resolution contract: 0 matches tries
+ * the next locator; exactly 1 match selects and stops; more than 1 match is
+ * ambiguous and stops (never falls through); an unevaluable locator is
+ * unavailable and stops (never falls through). Ambiguity never triggers
+ * fallback.
+ *
+ * Batch 3 restructures this into three phases over one resolved set: (1)
+ * resolve every configured target exactly once, keeping a live
+ * `{locator, handle}` for each match; (2) compute bounded pairwise DOM
+ * containment among only the resolved configured targets, reusing those
+ * same handles (never re-resolving, never a second/independent resolution
+ * algorithm); (3) measure every resolved target and assemble its evidence,
+ * attaching the phase-2 containment result. Every handle is disposed once,
+ * after all three phases, regardless of outcome.
+ */
+export declare function captureTargetEvidence(page: Page, targets: readonly NamedTarget[]): Promise<TargetEvidenceCaptureResult>;

package/dist/browser/evidenceCapture.js

@@ -0,0 +1,500 @@
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+import { TARGET_LANDMARK_ROLES } from '../domain/schema.js';
+function diagnostic(code, message, targetName) {
+    const base = { code, severity: DIAGNOSTIC_SEVERITY[code], message };
+    return targetName === undefined ? base : { ...base, targetName };
+}
+function browserField(value) {
+    return { state: 'available', source: 'browser', value };
+}
+function derivedField(value, derivedFrom) {
+    return { state: 'available', source: 'derived', value, derivedFrom };
+}
+function computedField(value) {
+    return { state: 'available', source: 'computed-browser', value };
+}
+function unavailableField(reason) {
+    return { state: 'unavailable', reason };
+}
+/**
+ * Captures the v0.1 minimum page evidence (docs/PROJECT_MILESTONES.md
+ * "Minimum page evidence") from the already-navigated, already-ready page.
+ * `documentWidth`/`documentHeight` are the one explicitly *derived* pair -
+ * max(scroll, client) in each axis - everything else is a direct browser
+ * read, per the Batch 1 evidence-source model.
+ */
+export async function capturePageEvidence(page, requestedUrl, viewport) {
+    const raw = await page.evaluate(() => ({
+        title: document.title,
+        windowScrollX: window.scrollX,
+        windowScrollY: window.scrollY,
+        documentScrollWidth: document.documentElement.scrollWidth,
+        documentScrollHeight: document.documentElement.scrollHeight,
+        documentClientWidth: document.documentElement.clientWidth,
+        documentClientHeight: document.documentElement.clientHeight,
+    }));
+    const documentWidth = Math.max(raw.documentScrollWidth, raw.documentClientWidth);
+    const documentHeight = Math.max(raw.documentScrollHeight, raw.documentClientHeight);
+    return {
+        requestedUrl: browserField(requestedUrl),
+        finalUrl: browserField(page.url()),
+        title: browserField(raw.title),
+        viewportWidth: browserField(viewport.width),
+        viewportHeight: browserField(viewport.height),
+        devicePixelRatio: browserField(await page.evaluate(() => window.devicePixelRatio)),
+        documentScrollWidth: browserField(raw.documentScrollWidth),
+        documentScrollHeight: browserField(raw.documentScrollHeight),
+        documentClientWidth: browserField(raw.documentClientWidth),
+        documentClientHeight: browserField(raw.documentClientHeight),
+        documentWidth: derivedField(documentWidth, ['documentScrollWidth', 'documentClientWidth']),
+        documentHeight: derivedField(documentHeight, ['documentScrollHeight', 'documentClientHeight']),
+        windowScrollX: browserField(raw.windowScrollX),
+        windowScrollY: browserField(raw.windowScrollY),
+    };
+}
+/**
+ * Extracts only the target element's own role/name from a Playwright
+ * `ariaSnapshot()` string (e.g. `- button "Click me"`), never its
+ * descendants - bounded, target-local semantic evidence, not an
+ * accessibility-tree dump. A generic `- text: ...` line (no distinct ARIA
+ * role) or an empty snapshot both mean "no reliable role/name", not a role
+ * of "text".
+ */
+function parseAriaSnapshotFirstLine(snapshot) {
+    const firstLine = snapshot.split('\n')[0]?.trim();
+    if (!firstLine)
+        return undefined;
+    // No trailing `$` anchor: an element with no accessible name still produces
+    // a role line with unquoted trailing content (e.g. `- banner: Site Header`,
+    // verified empirically against real Chromium), which must still yield the
+    // role even though there is no quoted, genuinely-computed accessible name
+    // to report - trailing unquoted text is never treated as a name.
+    const match = /^-\s+([A-Za-z][\w-]*)\s*(?:"([^"]*)")?:?/.exec(firstLine);
+    if (!match)
+        return undefined;
+    const role = match[1];
+    const name = match[2];
+    if (role === undefined || role === 'text')
+        return undefined;
+    return name !== undefined && name.length > 0 ? { role, name } : { role };
+}
+/** Builds the shared unresolved-target evidence record (not-found/ambiguous/unavailable) with the full ordered attempt history and no selected locator. Containment is reported separately by the caller (its own "self unresolved" reason differs from the measurement-unavailable reason used here). */
+function unresolvedTargetRecord(selectionStatus, attempts, reason, containment) {
+    const resolution = {
+        selectionMethod: 'ordered-locators',
+        selectionStatus,
+        usedFallback: false,
+        confidence: 'none',
+        attempts,
+    };
+    return {
+        resolution: { state: 'available', source: 'derived', value: resolution, derivedFrom: ['locator-attempts'] },
+        tag: unavailableField(reason),
+        geometry: unavailableField(reason),
+        style: unavailableField(reason),
+        layout: unavailableField(reason),
+        visibility: unavailableField(reason),
+        semantics: unavailableField(reason),
+        semanticState: unavailableField(reason),
+        landmark: unavailableField(reason),
+        containment,
+    };
+}
+const TARGET_LANDMARK_ROLE_SET = new Set(TARGET_LANDMARK_ROLES);
+/**
+ * Reads the resolved element's own native form-control properties and
+ * explicit `aria-*` attributes: bounded, target-local browser/ARIA state.
+ * `ariaSnapshot()`'s bracket annotations were verified empirically (real
+ * Chromium via the installed Playwright 1.62.1) to appear only for
+ * true/mixed values - they cannot distinguish an explicit false from "not
+ * applicable to this element", and they never expose `aria-current` at all.
+ * This direct property/attribute read is the investigated, honest
+ * alternative for exactly those two gaps; it still reads only real
+ * browser-native/ARIA semantics (never class names, CSS, text content, or
+ * source ownership). A key is present in the result only when the browser
+ * exposes that state as applicable to this specific element.
+ */
+async function captureSemanticState(handle) {
+    return handle.evaluate((el) => {
+        const result = {};
+        const ariaDisabled = el.getAttribute('aria-disabled');
+        const nativeDisabled = 'disabled' in el ? Boolean(el.disabled) : false;
+        if (nativeDisabled || ariaDisabled !== null)
+            result.disabled = nativeDisabled || ariaDisabled === 'true';
+        const ariaExpanded = el.getAttribute('aria-expanded');
+        if (ariaExpanded !== null)
+            result.expanded = ariaExpanded === 'true';
+        const ariaChecked = el.getAttribute('aria-checked');
+        const isNativeCheckable = el instanceof HTMLInputElement && (el.type === 'checkbox' || el.type === 'radio');
+        if (ariaChecked !== null) {
+            result.checked = ariaChecked === 'mixed' ? 'mixed' : ariaChecked === 'true';
+        }
+        else if (isNativeCheckable) {
+            result.checked = el.indeterminate ? 'mixed' : el.checked;
+        }
+        const ariaSelected = el.getAttribute('aria-selected');
+        if (ariaSelected !== null)
+            result.selected = ariaSelected === 'true';
+        const ariaPressed = el.getAttribute('aria-pressed');
+        if (ariaPressed !== null)
+            result.pressed = ariaPressed === 'mixed' ? 'mixed' : ariaPressed === 'true';
+        const ariaCurrent = el.getAttribute('aria-current');
+        if (ariaCurrent !== null && ariaCurrent !== 'false' && ariaCurrent.length > 0) {
+            result.current = ariaCurrent === 'true' ? true : ariaCurrent;
+        }
+        return result;
+    });
+}
+/** Wraps the raw captured state: an empty object means no supported state applies to this target ("not-applicable"), never an unexplained empty available value. */
+function semanticStateEvidence(raw) {
+    if (Object.keys(raw).length === 0) {
+        return { state: 'not-applicable', reason: 'no supported semantic state is exposed for this target' };
+    }
+    return { state: 'available', source: 'computed-browser', value: raw };
+}
+/** Derives landmark identity from the already-captured browser-exposed role only - never from locator kind or HTML tag (Section 15). */
+function landmarkEvidence(role) {
+    if (role === undefined)
+        return unavailableField('no distinct accessible role is exposed for this target');
+    if (TARGET_LANDMARK_ROLE_SET.has(role)) {
+        return { state: 'available', source: 'derived', value: role, derivedFrom: ['semantics.role'] };
+    }
+    return { state: 'not-applicable', reason: `role "${role}" is not a recognized landmark role` };
+}
+/**
+ * Wraps a computed configured-target-only containment result into the
+ * persisted EvidenceField. `selfUnresolvedReason` covers the case where the
+ * current target itself never resolved (Section 18: containment is
+ * `unavailable`, not partial, when there is no resolved element to check
+ * containment for). A computed result with any `unresolvedTargetIds` is
+ * `partial` (already-proven relationships are preserved, never dropped);
+ * with none, it is `available`.
+ */
+function containmentEvidence(computed, selfUnresolvedReason) {
+    if (selfUnresolvedReason !== undefined)
+        return { state: 'unavailable', reason: selfUnresolvedReason };
+    if (!computed)
+        return { state: 'unavailable', reason: 'containment could not be computed' };
+    if (computed.unresolvedTargetIds.length > 0) {
+        return {
+            state: 'partial',
+            source: 'browser',
+            value: computed,
+            reason: `containment could not be evaluated against: ${computed.unresolvedTargetIds.join(', ')}`,
+        };
+    }
+    return { state: 'available', source: 'browser', value: computed };
+}
+/**
+ * Captures the full target evidence for one resolved (single-match) target
+ * element, from the same live page/readiness state as the page evidence and
+ * screenshot: tag/geometry/style/layout/visibility (v0.1), role/name
+ * semantics (v0.1, via `ariaSnapshot()`), and semantic state/landmark
+ * (Batch 3). Takes an already-resolved `{ locator, handle }` pair - not a
+ * raw CSS selector, and never re-resolves - so every locator kind converges
+ * on this one measurement path and containment (computed once by the caller
+ * across every resolved target before this runs) is simply passed through.
+ */
+async function captureResolvedTargetRecord(target, handle, attempts, selectedLocatorIndex, containment) {
+    const raw = await handle.evaluate((el) => {
+        const rect = el.getBoundingClientRect();
+        const computed = getComputedStyle(el);
+        return {
+            tag: el.tagName.toLowerCase(),
+            geometry: { x: rect.x, y: rect.y, width: rect.width, height: rect.height, right: rect.right, bottom: rect.bottom },
+            style: { display: computed.display, position: computed.position, overflowX: computed.overflowX, overflowY: computed.overflowY },
+            layout: {
+                scrollWidth: el.scrollWidth,
+                scrollHeight: el.scrollHeight,
+                clientWidth: el.clientWidth,
+                clientHeight: el.clientHeight,
+                scrollTop: el.scrollTop,
+                scrollLeft: el.scrollLeft,
+            },
+            computedVisibility: computed.visibility,
+        };
+    });
+    const visible = raw.style.display !== 'none' && raw.computedVisibility !== 'hidden' && raw.geometry.width > 0 && raw.geometry.height > 0;
+    let semantics;
+    let resolvedRole;
+    try {
+        const snapshot = await target.ariaSnapshot();
+        const parsed = parseAriaSnapshotFirstLine(snapshot);
+        semantics = parsed ? computedField(parsed) : unavailableField('no distinct accessible role/name is exposed for this target');
+        resolvedRole = parsed?.role;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        semantics = unavailableField(`accessibility snapshot failed: ${message}`);
+    }
+    let semanticState;
+    try {
+        semanticState = semanticStateEvidence(await captureSemanticState(handle));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        semanticState = unavailableField(`semantic-state evaluation failed: ${message}`);
+    }
+    const resolution = {
+        selectionMethod: 'ordered-locators',
+        selectionStatus: 'matched',
+        selectedLocatorKind: attempts[selectedLocatorIndex]?.locatorKind ?? 'css',
+        selectedLocatorIndex,
+        usedFallback: selectedLocatorIndex > 0,
+        confidence: 'exact',
+        attempts,
+    };
+    return {
+        record: {
+            resolution: { state: 'available', source: 'derived', value: resolution, derivedFrom: ['locator-attempts'] },
+            tag: browserField(raw.tag),
+            geometry: browserField(raw.geometry),
+            style: computedField(raw.style),
+            layout: browserField(raw.layout),
+            visibility: derivedField({ visible }, ['style.display', 'computed-visibility', 'geometry.width', 'geometry.height']),
+            semantics,
+            semanticState,
+            landmark: landmarkEvidence(resolvedRole),
+            containment,
+        },
+        visible,
+    };
+}
+/**
+ * A CSS quoted-string literal for an attribute selector value (`[attr="..."]`).
+ * Only backslash and double-quote need escaping inside a CSS quoted string;
+ * this keeps the configured id/data-attribute value literal - it is never
+ * reinterpreted as selector syntax (e.g. a value containing `#`, `.`, `[`,
+ * or `"` still matches exactly, it cannot escape the attribute-value
+ * position it was placed in).
+ */
+function cssAttributeValueLiteral(value) {
+    return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+/**
+ * Maps one frozen v0.2 TargetLocator to the Playwright `Locator` that
+ * resolves it - the single point where locator kind becomes a real browser
+ * query. `role`/`text` use Playwright's own semantic locators (real
+ * accessibility-tree/text resolution, not a hand-rolled approximation);
+ * `id`/`data-attribute` use an exact CSS attribute-equals selector (never
+ * `#id`/bare-value syntax, so the configured value can never be
+ * reinterpreted as selector syntax); `semantic-element` uses a plain tag
+ * selector from the Batch 1 frozen tag set; `css` is unchanged v0.1
+ * behavior. Every kind converges on the same Playwright `Locator` type, so
+ * cardinality/measurement downstream never branches on locator kind again.
+ */
+function buildPlaywrightLocator(page, locator) {
+    switch (locator.kind) {
+        case 'css':
+            return page.locator(locator.selector);
+        case 'id':
+            return page.locator(`[id=${cssAttributeValueLiteral(locator.value)}]`);
+        case 'data-attribute':
+            return page.locator(`[${locator.attribute}=${cssAttributeValueLiteral(locator.value)}]`);
+        case 'semantic-element':
+            return page.locator(locator.tag);
+        case 'role':
+            return page.getByRole(locator.role, locator.name === undefined ? undefined : { name: locator.name, exact: true });
+        case 'text':
+            return page.getByText(locator.text, { exact: true });
+    }
+}
+/**
+ * Evaluates one locator against the live page: builds its real Playwright
+ * `Locator` and measures cardinality via `.count()` (no waiting, no
+ * `.first()`/`.nth(0)` shortcut that would silently resolve an ambiguous
+ * match). A locator that cannot be constructed or counted reliably is
+ * `unavailable`, never silently treated as zero matches.
+ */
+async function evaluateLocatorAttempt(page, locator) {
+    try {
+        const playwrightLocator = buildPlaywrightLocator(page, locator);
+        const matchCount = await playwrightLocator.count();
+        if (matchCount === 0)
+            return { playwrightLocator, outcome: { status: 'not-found', matchCount: 0 } };
+        if (matchCount > 1)
+            return { playwrightLocator, outcome: { status: 'ambiguous', matchCount } };
+        return { playwrightLocator, outcome: { status: 'matched', matchCount: 1 } };
+    }
+    catch {
+        return { playwrightLocator: undefined, outcome: { status: 'unavailable' } };
+    }
+}
+/**
+ * Looks up one already-resolved configured target by its stable observer
+ * name (case-insensitively, matching the same case-insensitive comparison
+ * `request.ts#normalizeRequest` already uses for target-name uniqueness) -
+ * never a second locator/resolution algorithm, just a lookup into the
+ * `resolveConfiguredTargets` result already computed once for this
+ * observation.
+ */
+export function findResolvedTarget(resolved, name) {
+    const lower = name.toLowerCase();
+    return resolved.find((info) => info.name.toLowerCase() === lower);
+}
+/**
+ * The one canonical target-resolution algorithm (Phase 1 of the v0.2 Batch 3
+ * three-phase design below), exported so v0.3 Batch 2 scroll-scenario
+ * runtime-snapshot capture can resolve configured targets exactly once and
+ * reuse the same live `{locator, handle}` pairs across its initial/final
+ * snapshots, instead of re-implementing resolution with different locator
+ * semantics. Callers own disposing any returned `handle`.
+ */
+export async function resolveConfiguredTargets(page, targets) {
+    const infos = [];
+    for (const target of targets) {
+        const attempts = [];
+        let stopStatus;
+        let matchedIndex;
+        let matchedPlaywrightLocator;
+        for (let index = 0; index < target.locators.length; index += 1) {
+            const locator = target.locators[index];
+            const { playwrightLocator, outcome } = await evaluateLocatorAttempt(page, locator);
+            attempts.push({
+                locatorIndex: index,
+                locatorKind: locator.kind,
+                status: outcome.status,
+                ...(outcome.matchCount !== undefined ? { matchCount: outcome.matchCount } : {}),
+            });
+            if (outcome.status === 'matched' && playwrightLocator) {
+                stopStatus = 'matched';
+                matchedIndex = index;
+                matchedPlaywrightLocator = playwrightLocator;
+                break;
+            }
+            if (outcome.status === 'ambiguous') {
+                stopStatus = 'ambiguous';
+                break;
+            }
+            if (outcome.status === 'unavailable') {
+                stopStatus = 'unavailable';
+                break;
+            }
+            // 'not-found': fall through to the next configured locator.
+        }
+        if (stopStatus === 'matched' && matchedPlaywrightLocator && matchedIndex !== undefined) {
+            try {
+                const handles = await matchedPlaywrightLocator.elementHandles();
+                const handle = handles[0];
+                if (handle) {
+                    infos.push({
+                        name: target.name,
+                        attempts,
+                        status: 'matched',
+                        selectedIndex: matchedIndex,
+                        locator: matchedPlaywrightLocator,
+                        handle: handle,
+                    });
+                }
+                else {
+                    infos.push({ name: target.name, attempts, status: 'not-found' });
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                infos.push({ name: target.name, attempts, status: 'unavailable', unavailableReason: `target evaluation failed: ${message}` });
+            }
+        }
+        else if (stopStatus === 'ambiguous') {
+            infos.push({ name: target.name, attempts, status: 'ambiguous' });
+        }
+        else if (stopStatus === 'unavailable') {
+            infos.push({ name: target.name, attempts, status: 'unavailable' });
+        }
+        else {
+            infos.push({ name: target.name, attempts, status: 'not-found' });
+        }
+    }
+    return infos;
+}
+/**
+ * Observes every explicitly configured target from the same live page,
+ * honoring the frozen ordered-locator resolution contract: 0 matches tries
+ * the next locator; exactly 1 match selects and stops; more than 1 match is
+ * ambiguous and stops (never falls through); an unevaluable locator is
+ * unavailable and stops (never falls through). Ambiguity never triggers
+ * fallback.
+ *
+ * Batch 3 restructures this into three phases over one resolved set: (1)
+ * resolve every configured target exactly once, keeping a live
+ * `{locator, handle}` for each match; (2) compute bounded pairwise DOM
+ * containment among only the resolved configured targets, reusing those
+ * same handles (never re-resolving, never a second/independent resolution
+ * algorithm); (3) measure every resolved target and assemble its evidence,
+ * attaching the phase-2 containment result. Every handle is disposed once,
+ * after all three phases, regardless of outcome.
+ */
+export async function captureTargetEvidence(page, targets) {
+    const targetEvidence = {};
+    const diagnostics = [];
+    // Phase 1: resolve every configured target exactly once.
+    const infos = await resolveConfiguredTargets(page, targets);
+    try {
+        // Phase 2: bounded pairwise DOM containment among the configured targets
+        // only (never unconfigured ancestors), in configured target order.
+        const containmentByName = new Map();
+        for (const info of infos) {
+            if (info.status !== 'matched' || !info.handle)
+                continue;
+            const selfHandle = info.handle;
+            const containedByTargetIds = [];
+            const evaluatedTargetIds = [];
+            const unresolvedTargetIds = [];
+            for (const other of infos) {
+                if (other.name === info.name)
+                    continue;
+                if (other.status === 'matched' && other.handle) {
+                    evaluatedTargetIds.push(other.name);
+                    const contains = await other.handle.evaluate((elOther, elSelf) => elOther !== elSelf && elOther.contains(elSelf), selfHandle);
+                    if (contains)
+                        containedByTargetIds.push(other.name);
+                }
+                else {
+                    unresolvedTargetIds.push(other.name);
+                }
+            }
+            containmentByName.set(info.name, containmentEvidence({ containedByTargetIds, evaluatedTargetIds, unresolvedTargetIds }, undefined));
+        }
+        // Phase 3: measure resolved targets and assemble every target's evidence.
+        for (const info of infos) {
+            if (info.status === 'matched' && info.locator && info.handle && info.selectedIndex !== undefined) {
+                try {
+                    const containment = containmentByName.get(info.name) ?? containmentEvidence(undefined, 'containment could not be computed');
+                    const { record, visible } = await captureResolvedTargetRecord(info.locator, info.handle, info.attempts, info.selectedIndex, containment);
+                    targetEvidence[info.name] = record;
+                    if (!visible) {
+                        diagnostics.push(diagnostic('target-hidden', `target "${info.name}" resolved but is not visible`, info.name));
+                    }
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    const reason = `target evaluation failed: ${message}`;
+                    targetEvidence[info.name] = unresolvedTargetRecord('unavailable', info.attempts, reason, containmentEvidence(undefined, `target itself could not be measured: ${reason}`));
+                    diagnostics.push(diagnostic('browser-evidence-unavailable', reason, info.name));
+                }
+                continue;
+            }
+            const selfUnresolvedReason = `target itself did not resolve (status: ${info.status})`;
+            if (info.status === 'ambiguous') {
+                const lastAttempt = info.attempts[info.attempts.length - 1];
+                const matchCount = lastAttempt?.matchCount ?? 0;
+                targetEvidence[info.name] = unresolvedTargetRecord('ambiguous', info.attempts, `target locator matched ${matchCount} elements; expected exactly one`, containmentEvidence(undefined, selfUnresolvedReason));
+                diagnostics.push(diagnostic('target-ambiguous', `${matchCount} elements matched a locator for target "${info.name}"`, info.name));
+            }
+            else if (info.status === 'unavailable') {
+                const reason = info.unavailableReason ?? `target locator could not be evaluated reliably for "${info.name}"`;
+                targetEvidence[info.name] = unresolvedTargetRecord('unavailable', info.attempts, reason, containmentEvidence(undefined, selfUnresolvedReason));
+                diagnostics.push(diagnostic('browser-evidence-unavailable', reason, info.name));
+            }
+            else {
+                targetEvidence[info.name] = unresolvedTargetRecord('not-found', info.attempts, 'no configured locator matched an element', containmentEvidence(undefined, selfUnresolvedReason));
+                diagnostics.push(diagnostic('target-missing', `no locator matched an element for target "${info.name}"`, info.name));
+            }
+        }
+    }
+    finally {
+        await Promise.all(infos.filter((info) => info.handle).map((info) => info.handle.dispose()));
+    }
+    return { targetEvidence, diagnostics };
+}
+//# sourceMappingURL=evidenceCapture.js.map

package/dist/browser/evidenceCapture.js.map

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

package/dist/browser/scrollCapture.d.ts

@@ -0,0 +1,32 @@
+import type { Page } from 'playwright';
+import type { Viewport } from '../request/request.js';
+import type { ScrollRuntimeSnapshot } from '../domain/schema.js';
+import type { ResolvedTargetInfo } from './evidenceCapture.js';
+/**
+ * Captures one point-in-time bounded `ScrollRuntimeSnapshot` (Batch 1 frozen
+ * contract) from the live page, using already-resolved target handles -
+ * never re-resolving targets itself. Called twice by the scenario lifecycle
+ * (once before the scroll action, once after stabilization) against the
+ * exact same `resolved` set, so "which browser element is target X" is
+ * answered exactly once per observation's scenario capture.
+ */
+export declare function captureScrollRuntimeSnapshot(page: Page, resolved: readonly ResolvedTargetInfo[], viewport: Viewport): Promise<ScrollRuntimeSnapshot>;
+/**
+ * Immediate, non-smooth window scroll using the Batch 1 normalized delta.
+ * `behavior: 'instant'` guarantees no smooth-scroll animation regardless of
+ * any `scroll-behavior: smooth` the observed page's own CSS declares - the
+ * position change is synchronous within this one `evaluate()` call.
+ */
+export declare function performWindowScrollBy(page: Page, deltaX: number, deltaY: number): Promise<void>;
+/**
+ * Immediate, non-smooth scroll of one uniquely-resolved configured target
+ * element, using the same `behavior: 'instant'` primitive as
+ * {@link performWindowScrollBy} - one stabilization/execution contract for
+ * both action kinds, never a forked one. `element.scrollBy` is a real,
+ * browser-native immediate-scroll method on every `Element` (no dependency
+ * on the target actually being scrollable - a non-overflowing target simply
+ * produces no position change, which is a valid, honestly-reported outcome).
+ */
+export declare function performTargetScrollBy(handle: NonNullable<ResolvedTargetInfo['handle']>, deltaX: number, deltaY: number): Promise<void>;
+/** The Batch 1 frozen stabilization contract: exactly two `requestAnimationFrame` cycles on the live page, no timers/sleeps/network-idle substitutes. */
+export declare function waitTwoAnimationFrames(page: Page): Promise<void>;