teamshare-bridge 0.26.11 → 0.26.13

package/dist/lib/browser/page-context.js

@@ -0,0 +1,637 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEXT_CAP = exports.MAX_TOASTS = exports.MAX_ERRORS = exports.MAX_DIALOGS = exports.MAX_FIELDS = exports.WAIT_FOR_VALUES = exports.PAGE_ERROR_SELECTORS = void 0;
+exports.buildPageStateScript = buildPageStateScript;
+exports.readPageState = readPageState;
+exports.compactPageState = compactPageState;
+exports.buildCompactStateScript = buildCompactStateScript;
+exports.readCompactState = readCompactState;
+exports.renderPageStateText = renderPageStateText;
+exports.buildWaitProbeScript = buildWaitProbeScript;
+exports.emptyPageSnapshot = emptyPageSnapshot;
+/**
+ * Rich page state for the debug/MCP browser (2026-10).
+ *
+ * The auto-answer loop already extracts title/URL/headings/errors/toasts/full
+ * text (`extractPageContext` in browse-editor.ts). The debug browser had only a
+ * flat text read, so a QA agent could not SEE a login dialog, its buttons, its
+ * field state, a toast that had already disappeared, or the validation error
+ * that explained a failed submit. In the live Soludesks run that cost five
+ * minutes of raw `evaluate` calls and still ended on the wrong page.
+ *
+ * This module is the shared, structured equivalent: one in-page script returns
+ * a JSON-safe `PageState` with the topmost dialog, its buttons and fields,
+ * visible errors, the persistent toast buffer (page-events.ts), headings,
+ * focus, busy state and optional page text. `compactPageState` is the bounded
+ * version attached to ordinary action results.
+ *
+ * Rules:
+ *  - NEVER return a field VALUE - only `valueLength` (a password must not
+ *    travel through a tool result).
+ *  - The topmost open dialog is the interaction scope. Page fields behind a
+ *    modal are not offered as primary targets.
+ *  - Everything is capped so one snapshot cannot balloon a tool response.
+ */
+const cdp_1 = require("./cdp");
+const DEFAULT_TEXT_CAP = 12_000;
+exports.DEFAULT_TEXT_CAP = DEFAULT_TEXT_CAP;
+const MAX_FIELDS = 40;
+exports.MAX_FIELDS = MAX_FIELDS;
+const MAX_DIALOGS = 8;
+exports.MAX_DIALOGS = MAX_DIALOGS;
+const MAX_ERRORS = 8;
+exports.MAX_ERRORS = MAX_ERRORS;
+const MAX_TOASTS = 10;
+exports.MAX_TOASTS = MAX_TOASTS;
+/**
+ * Selectors that surface user-visible errors/alerts/validation messages.
+ * Deliberately broad (sites use every naming scheme) but every match is
+ * length-capped and deduped by the page script.
+ */
+exports.PAGE_ERROR_SELECTORS = [
+    '[role="alert"]',
+    '[role="status"]',
+    '[aria-invalid="true"]',
+    '[class*="error"]',
+    '[class*="Error"]',
+    '[class*="danger"]',
+    '[class*="warning"]',
+    '[class*="invalid"]',
+    '[class*="field-error"]',
+    '[class*="form-error"]',
+    '[class*="validation-error"]',
+    '[class*="error-message"]',
+    '.text-red',
+    '.text-danger',
+    '.text-error',
+    '[data-sonner-toast]',
+].join(',');
+/**
+ * Build the in-page state script. `includeText` and `maxTextChars` are the only
+ * variable parts; the rest is fixed and capped inside the page.
+ */
+function buildPageStateScript(opts = {}) {
+    const includeText = opts.includeText !== false;
+    const maxText = Math.min(Math.max(Number(opts.maxTextChars) || DEFAULT_TEXT_CAP, 500), 40_000);
+    const maxFields = Math.min(Math.max(Number(opts.maxFields) || MAX_FIELDS, 1), 100);
+    const errorSelectors = JSON.stringify(exports.PAGE_ERROR_SELECTORS);
+    return `
+    (() => {
+      const MAX_TEXT = ${maxText};
+      const MAX_FIELDS = ${maxFields};
+      const MAX_DIALOGS = ${MAX_DIALOGS};
+      const MAX_ERRORS = ${MAX_ERRORS};
+      const MAX_TOASTS = ${MAX_TOASTS};
+      const INCLUDE_TEXT = ${includeText ? 'true' : 'false'};
+      const ERROR_SEL = ${errorSelectors};
+
+      const clean = (v, cap) => String(v == null ? '' : v)
+        .replace(/\\s+/g, ' ')
+        .trim()
+        .slice(0, cap || 300);
+      const vis = (el) => {
+        if (!el || el.nodeType !== 1) return false;
+        const r = el.getBoundingClientRect();
+        if (r.width === 0 || r.height === 0) return false;
+        const cs = getComputedStyle(el);
+        return cs.visibility !== 'hidden' && cs.display !== 'none' && cs.opacity !== '0';
+      };
+      const rect = (el) => {
+        const r = el.getBoundingClientRect();
+        return {
+          x: Math.round(r.x + r.width / 2),
+          y: Math.round(r.y + r.height / 2),
+          width: Math.round(r.width),
+          height: Math.round(r.height),
+        };
+      };
+      const labelOf = (el) => {
+        const aria = el.getAttribute('aria-label');
+        if (aria) return clean(aria, 120);
+        const by = el.getAttribute('aria-labelledby');
+        if (by) {
+          const t = by.split(/\\s+/).map((id) => {
+            const n = document.getElementById(id);
+            return n ? (n.innerText || n.textContent || '') : '';
+          }).join(' ');
+          if (t.trim()) return clean(t, 120);
+        }
+        const id = el.id;
+        if (id) {
+          try {
+            const l = document.querySelector('label[for="' + CSS.escape(id) + '"]');
+            if (l) return clean(l.innerText || l.textContent, 120);
+          } catch (e) {}
+        }
+        const wrap = el.closest && el.closest('label');
+        if (wrap) return clean(wrap.innerText || wrap.textContent, 120);
+        return clean(el.getAttribute('placeholder') || el.getAttribute('name') || el.id || '', 120);
+      };
+      const fieldOf = (el, inDialog) => {
+        const r = rect(el);
+        const type = String(el.type || el.tagName || '').toLowerCase();
+        const valueLength = typeof el.value === 'string' ? el.value.length : 0;
+        const invalid = el.getAttribute('aria-invalid') === 'true' ||
+          (typeof el.checkValidity === 'function' && !el.checkValidity() && valueLength > 0);
+        return {
+          tag: String(el.tagName || '').toLowerCase(),
+          type: type,
+          label: labelOf(el),
+          name: clean(el.getAttribute('name') || el.id || '', 80),
+          autocomplete: clean(el.getAttribute('autocomplete') || '', 60),
+          valueLength: valueLength,
+          required: el.required === true,
+          invalid: invalid,
+          disabled: el.disabled === true,
+          readonly: el.readOnly === true,
+          focused: document.activeElement === el,
+          inDialog: !!inDialog,
+          x: r.x,
+          y: r.y,
+        };
+      };
+      const buttonOf = (el) => {
+        const r = rect(el);
+        return {
+          text: clean(el.innerText || el.textContent || el.value || el.getAttribute('aria-label') || '', 100),
+          type: clean(el.getAttribute('type') || el.tagName || '', 30).toLowerCase(),
+          disabled: el.disabled === true || el.getAttribute('aria-disabled') === 'true',
+          x: r.x,
+          y: r.y,
+        };
+      };
+      const zOf = (el) => {
+        let z = 0;
+        let n = el;
+        let guard = 0;
+        while (n && n !== document.body && guard++ < 8) {
+          const cs = getComputedStyle(n);
+          const v = parseInt(cs.zIndex, 10);
+          if (!isNaN(v)) z = Math.max(z, v);
+          n = n.parentElement;
+        }
+        return z;
+      };
+      const dialogSel = 'dialog[open],[role="dialog"],[aria-modal="true"],' +
+        '[class*="modal"],[class*="Modal"],[class*="dialog"],[class*="Dialog"]';
+      const dialogEls = [...document.querySelectorAll(dialogSel)]
+        .filter(vis)
+        .slice(0, MAX_DIALOGS);
+      const dialogs = dialogEls.map((el, index) => {
+        const title =
+          clean(el.getAttribute('aria-label') || '', 120) ||
+          (() => {
+            const by = el.getAttribute('aria-labelledby');
+            if (by) {
+              const t = by.split(/\\s+/).map((id) => {
+                const n = document.getElementById(id);
+                return n ? (n.innerText || n.textContent || '') : '';
+              }).join(' ');
+              if (t.trim()) return clean(t, 120);
+            }
+            const h = el.querySelector('h1,h2,h3,[class*="title"],[class*="Title"]');
+            return h ? clean(h.innerText || h.textContent, 120) : '';
+          })();
+        const r = rect(el);
+        return {
+          index: index,
+          role: clean(el.getAttribute('role') || (el.tagName || '').toLowerCase(), 30),
+          title: title,
+          text: clean(el.innerText || el.textContent || '', 1600),
+          z: zOf(el),
+          x: r.x,
+          y: r.y,
+          width: r.width,
+          height: r.height,
+          fields: [...el.querySelectorAll('input,textarea,select')]
+            .filter(vis)
+            .filter((f) => String(f.type || '').toLowerCase() !== 'hidden')
+            .slice(0, MAX_FIELDS)
+            .map((f) => fieldOf(f, true)),
+          buttons: [...el.querySelectorAll('button,input[type="submit"],input[type="button"],[role="button"],a')]
+            .filter(vis)
+            .slice(0, 20)
+            .map(buttonOf),
+        };
+      }).sort((a, b) => (a.z - b.z) || (a.index - b.index));
+      // Prefer the dialog that actually holds a login field: a cookie banner
+      // or a newsletter modal can have a higher z-index, but it is not what
+      // the agent is interacting with.
+      const loginTop = [...dialogs].reverse().find((d) =>
+        d.fields.some(
+          (f) =>
+            f.type === 'password' ||
+            f.type === 'email' ||
+            /username|one-time-code|current-password|new-password/.test(
+              f.autocomplete || '',
+            ),
+        ),
+      );
+      const top = loginTop ?? (dialogs.length ? dialogs[dialogs.length - 1] : null);
+      const topEl = dialogEls[top ? top.index : -1] || null;
+      const scope = topEl || document;
+
+      const fields = (top ? top.fields : [...document.querySelectorAll('input,textarea,select')]
+        .slice(0, 200)
+        .filter(vis)
+        .filter((f) => String(f.type || '').toLowerCase() !== 'hidden')
+        .slice(0, MAX_FIELDS)
+        .map((f) => fieldOf(f, false)));
+
+      const errors = [];
+      const pushError = (text, role) => {
+        const t = clean(text, 240);
+        if (t.length < 3) return;
+        if (/^(error|errors|warning|warnings)$/i.test(t)) return;
+        if (errors.some((e) => e.text === t)) return;
+        if (errors.length < MAX_ERRORS) errors.push({ text: t, role: clean(role || '', 30) });
+      };
+      // Alerts and invalid fields first, then the broad class-based sweep.
+      for (const el of [...scope.querySelectorAll('[role="alert"],[aria-invalid="true"]')].filter(vis).slice(0, 4)) {
+        pushError(el.innerText || el.textContent || el.getAttribute('aria-label') || '', el.getAttribute('role') || 'invalid');
+      }
+      for (const el of [...scope.querySelectorAll(ERROR_SEL)].filter(vis).slice(0, 20)) {
+        pushError(el.innerText || el.textContent || '', el.getAttribute('role') || 'error');
+      }
+
+      const toasts = (window.__tsPageEvents || [])
+        .filter((e) => e && e.type !== 'dialog' && e.type !== 'dialog-closed')
+        .slice(-MAX_TOASTS);
+
+      const headings = [...document.querySelectorAll('h1,h2,h3')]
+        .filter(vis)
+        .map((h) => clean(h.innerText || h.textContent || '', 160))
+        .filter(Boolean)
+        .slice(0, 8);
+
+      const active = document.activeElement;
+      const focused = active && ['input', 'textarea', 'select'].includes(String(active.tagName || '').toLowerCase())
+        ? {
+            tag: String(active.tagName || '').toLowerCase(),
+            type: String(active.type || '').toLowerCase(),
+            label: labelOf(active),
+            valueLength: typeof active.value === 'string' ? active.value.length : 0,
+            inDialog: !!(topEl && topEl.contains(active)),
+          }
+        : null;
+
+      const busy = [...document.querySelectorAll('[aria-busy="true"],[data-loading="true"],[class*="loading"],[class*="spinner"]')]
+        .some(vis);
+
+      let text = '';
+      let textTruncated = false;
+      if (INCLUDE_TEXT) {
+        const root = document.querySelector('main,article,[role="main"]') || document.body;
+        const raw = root ? (root.innerText || root.textContent || '') : '';
+        const normalized = raw
+          .replace(/\\r/g, '')
+          .replace(/[ \\t]+\\n/g, '\\n')
+          .replace(/\\n{3,}/g, '\\n\\n')
+          .trim();
+        textTruncated = normalized.length > MAX_TEXT;
+        text = textTruncated ? normalized.slice(0, MAX_TEXT) : normalized;
+      }
+
+      return {
+        url: location.href,
+        title: document.title || '',
+        readyState: document.readyState || 'unknown',
+        headings: headings,
+        dialogs: dialogs,
+        modal: !!top,
+        fields: fields,
+        focused: focused,
+        errors: errors,
+        toasts: toasts,
+        busy: busy,
+        scroll: { x: Math.round(window.scrollX || 0), y: Math.round(window.scrollY || 0) },
+        text: text,
+        textTruncated: textTruncated,
+        maxTextChars: MAX_TEXT,
+      };
+    })()
+  `;
+}
+function emptyState() {
+    return {
+        url: '',
+        title: '',
+        readyState: 'unknown',
+        headings: [],
+        dialogs: [],
+        modal: false,
+        fields: [],
+        focused: null,
+        errors: [],
+        toasts: [],
+        busy: false,
+        scroll: { x: 0, y: 0 },
+        text: '',
+        textTruncated: false,
+        maxTextChars: DEFAULT_TEXT_CAP,
+    };
+}
+/** Read the rich page state. Never throws for a malformed page result. */
+async function readPageState(page, opts = {}) {
+    const raw = await (0, cdp_1.evaluateJs)(page, buildPageStateScript(opts));
+    if (!raw || typeof raw !== 'object')
+        return emptyState();
+    const r = raw;
+    return {
+        ...emptyState(),
+        ...r,
+        dialogs: Array.isArray(r.dialogs) ? r.dialogs : [],
+        fields: Array.isArray(r.fields) ? r.fields : [],
+        errors: Array.isArray(r.errors) ? r.errors : [],
+        toasts: Array.isArray(r.toasts) ? r.toasts : [],
+        headings: Array.isArray(r.headings) ? r.headings : [],
+    };
+}
+/**
+ * Bounded state attached to every mutating action result. Keeps the top
+ * dialog and its controls, a few errors/toasts and focus - enough for the
+ * agent to know what just happened without a second call.
+ */
+function compactPageState(state) {
+    const dialogs = state.dialogs.slice(-2).map((d) => ({
+        title: d.title,
+        role: d.role,
+        text: d.text.slice(0, 400),
+        fields: d.fields.slice(0, 10),
+        buttons: d.buttons.slice(0, 8),
+    }));
+    return {
+        url: state.url,
+        title: state.title,
+        readyState: state.readyState,
+        modal: state.modal,
+        dialogs: dialogs,
+        fields: state.fields.slice(0, 12),
+        focused: state.focused,
+        errors: state.errors.slice(0, 4),
+        toasts: state.toasts.slice(-4),
+        busy: state.busy,
+        scroll: state.scroll,
+    };
+}
+/**
+ * Fast, bounded state for action results and `waitFor` timeouts (2026-10).
+ *
+ * Deliberately smaller than `buildPageStateScript`: it skips the full page
+ * text, all-dialog enumeration, headings and the z-index sort, so attaching it
+ * to every click/type/navigate does not slow a QA run down. Still enough to
+ * see the top modal, its controls, errors, toasts and focus.
+ */
+function buildCompactStateScript() {
+    const errorSelectors = JSON.stringify('[role="alert"],[aria-invalid="true"],[class*="field-error"],[class*="form-error"],[class*="error-message"],[class*="invalid-feedback"],[data-sonner-toast]');
+    return `
+    (() => {
+      const clean = (v, cap) => String(v == null ? '' : v).replace(/\\s+/g, ' ').trim().slice(0, cap || 200);
+      const vis = (el) => {
+        if (!el || el.nodeType !== 1) return false;
+        const r = el.getBoundingClientRect();
+        if (r.width === 0 || r.height === 0) return false;
+        const cs = getComputedStyle(el);
+        return cs.visibility !== 'hidden' && cs.display !== 'none' && cs.opacity !== '0';
+      };
+      const rect = (el) => {
+        const r = el.getBoundingClientRect();
+        return { x: Math.round(r.x + r.width / 2), y: Math.round(r.y + r.height / 2) };
+      };
+      const labelOf = (el) => clean(
+        el.getAttribute('aria-label') ||
+        el.getAttribute('placeholder') ||
+        el.getAttribute('name') ||
+        el.id ||
+        '',
+        100,
+      );
+      const fieldOf = (el, inDialog) => {
+        const r = rect(el);
+        return {
+          tag: String(el.tagName || '').toLowerCase(),
+          type: String(el.type || el.tagName || '').toLowerCase(),
+          label: labelOf(el),
+          name: clean(el.getAttribute('name') || el.id || '', 80),
+          autocomplete: clean(el.getAttribute('autocomplete') || '', 60),
+          valueLength: typeof el.value === 'string' ? el.value.length : 0,
+          required: el.required === true,
+          invalid: el.getAttribute('aria-invalid') === 'true',
+          disabled: el.disabled === true,
+          readonly: el.readOnly === true,
+          focused: document.activeElement === el,
+          inDialog: !!inDialog,
+          x: r.x,
+          y: r.y,
+        };
+      };
+      const buttonOf = (el) => {
+        const r = rect(el);
+        return {
+          text: clean(el.innerText || el.textContent || el.value || el.getAttribute('aria-label') || '', 80),
+          type: clean(el.getAttribute('type') || el.tagName || '', 30).toLowerCase(),
+          disabled: el.disabled === true || el.getAttribute('aria-disabled') === 'true',
+          x: r.x,
+          y: r.y,
+        };
+      };
+      const dialogEls = [...document.querySelectorAll('dialog[open],[role="dialog"],[aria-modal="true"],[class*="modal"],[class*="Modal"],[class*="dialog"],[class*="Dialog"]')]
+        .filter(vis)
+        .slice(0, 3);
+      const loginTop = [...dialogEls].reverse().find((d) =>
+        d.querySelector('input[type="password"],input[type="email"],input[autocomplete="username"],input[autocomplete="one-time-code"]'),
+      );
+      const topEl = loginTop ||
+        [...dialogEls].reverse().find((d) => d.querySelector('input,textarea')) ||
+        dialogEls[dialogEls.length - 1] ||
+        null;
+      const top = topEl ? {
+        role: clean(topEl.getAttribute('role') || (topEl.tagName || '').toLowerCase(), 30),
+        title: clean(
+          topEl.getAttribute('aria-label') ||
+          (topEl.querySelector('h1,h2,h3') ? topEl.querySelector('h1,h2,h3').innerText : '') ||
+          '',
+          120,
+        ),
+        text: clean(topEl.innerText || topEl.textContent || '', 300),
+        fields: [...topEl.querySelectorAll('input,textarea,select')]
+          .filter(vis)
+          .filter((f) => String(f.type || '').toLowerCase() !== 'hidden')
+          .slice(0, 10)
+          .map((f) => fieldOf(f, true)),
+        buttons: [...topEl.querySelectorAll('button,input[type="submit"],input[type="button"],[role="button"],a')]
+          .filter(vis)
+          .slice(0, 8)
+          .map(buttonOf),
+      } : null;
+      const scope = topEl || document;
+      const errors = [];
+      const pushError = (t, role) => {
+        const text = clean(t, 200);
+        if (text.length < 3 || errors.length >= 3) return;
+        if (/^(error|errors|warning|warnings)$/i.test(text)) return;
+        if (!errors.some((e) => e.text === text)) errors.push({ text: text, role: clean(role || '', 24) });
+      };
+      for (const el of [...scope.querySelectorAll('[role="alert"],[aria-invalid="true"]')].filter(vis).slice(0, 3)) {
+        pushError(el.innerText || el.textContent || el.getAttribute('aria-label') || '', el.getAttribute('role') || 'invalid');
+      }
+      for (const el of [...scope.querySelectorAll(${errorSelectors})].filter(vis).slice(0, 8)) {
+        pushError(el.innerText || el.textContent || '', el.getAttribute('role') || 'error');
+      }
+      const active = document.activeElement;
+      const focused = active && ['input', 'textarea', 'select'].includes(String(active.tagName || '').toLowerCase())
+        ? { tag: String(active.tagName || '').toLowerCase(), type: String(active.type || '').toLowerCase(), label: labelOf(active), valueLength: typeof active.value === 'string' ? active.value.length : 0, inDialog: !!(topEl && topEl.contains(active)) }
+        : null;
+      return {
+        url: location.href,
+        title: document.title || '',
+        readyState: document.readyState || 'unknown',
+        modal: !!topEl,
+        dialogs: top ? [top] : [],
+        fields: top ? top.fields : [...document.querySelectorAll('input,textarea,select')]
+          .slice(0, 120)
+          .filter(vis)
+          .filter((f) => String(f.type || '').toLowerCase() !== 'hidden')
+          .slice(0, 12)
+          .map((f) => fieldOf(f, false)),
+        focused: focused,
+        errors: errors,
+        toasts: (window.__tsPageEvents || []).slice(-4),
+        busy: [...document.querySelectorAll('[aria-busy="true"],[data-loading="true"],[class*="loading"],[class*="spinner"]')].some(vis),
+        scroll: { x: Math.round(window.scrollX || 0), y: Math.round(window.scrollY || 0) },
+      };
+    })()
+  `;
+}
+/** Read the fast compact state; null on a malformed result. */
+async function readCompactState(page) {
+    try {
+        const raw = await (0, cdp_1.evaluateJs)(page, buildCompactStateScript());
+        return raw && typeof raw === 'object'
+            ? raw
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Human/LLM-readable rendering of a state (used in `snapshot.summary`). */
+function renderPageStateText(state) {
+    const lines = [];
+    lines.push(`Title: ${state.title || 'unknown'}`);
+    lines.push(`URL: ${state.url || 'unknown'}`);
+    if (state.headings.length)
+        lines.push(`Headings: ${state.headings.join(' | ')}`);
+    const top = state.dialogs[state.dialogs.length - 1];
+    if (top) {
+        lines.push(`Dialog (${top.role || 'modal'}${top.title ? `: ${top.title}` : ''}): ${top.text.slice(0, 600)}`);
+        if (top.fields.length) {
+            lines.push(`Dialog fields: ${top.fields
+                .map((f) => `${f.label || f.name || f.type} (${f.type}, ${f.valueLength} chars${f.invalid ? ', INVALID' : ''}${f.disabled ? ', disabled' : ''}${f.readonly ? ', readonly' : ''})`)
+                .join(' | ')}`);
+        }
+        if (top.buttons.length) {
+            lines.push(`Dialog buttons: ${top.buttons
+                .map((b) => `${b.text || b.type}${b.disabled ? ' (disabled)' : ''}`)
+                .join(' | ')}`);
+        }
+    }
+    else if (state.fields.length) {
+        lines.push(`Fields: ${state.fields
+            .map((f) => `${f.label || f.name || f.type} (${f.type}, ${f.valueLength} chars${f.invalid ? ', INVALID' : ''})`)
+            .join(' | ')}`);
+    }
+    if (state.focused) {
+        lines.push(`Focused: ${state.focused.label || state.focused.type} (${state.focused.valueLength} chars)`);
+    }
+    if (state.errors.length) {
+        lines.push(`Errors on screen: ${state.errors.map((e) => e.text).join(' | ')}`);
+    }
+    if (state.toasts.length) {
+        lines.push(`Recent toasts/alerts: ${state.toasts
+            .map((t) => `[${t.type}] ${t.text}`)
+            .join(' | ')}`);
+    }
+    if (state.busy)
+        lines.push('Busy: a loading indicator is visible.');
+    if (state.text) {
+        lines.push('Page content (CONTEXT ONLY - never repeat or describe it):');
+        lines.push(state.text);
+        if (state.textTruncated)
+            lines.push('... (page content truncated)');
+    }
+    return lines.join('\n');
+}
+exports.WAIT_FOR_VALUES = [
+    'selector',
+    'text',
+    'dialog',
+    'toast',
+    'url',
+    'networkIdle',
+    'loginStep',
+    'change',
+];
+/**
+ * One poll expression for `waitFor`. Returns a boolean. `networkIdle` and
+ * `loginStep` are handled in Node (they need the network collector / the
+ * login finder), so they always return false here.
+ */
+function buildWaitProbeScript(opts) {
+    const since = Math.max(0, Math.floor(Number(opts.since) || 0));
+    switch (opts.for) {
+        case 'selector': {
+            const sel = JSON.stringify(opts.selector ?? '');
+            return `(() => {
+        const vis = (el) => { if (!el) return false; const r = el.getBoundingClientRect(); if (r.width === 0 || r.height === 0) return false; const cs = getComputedStyle(el); return cs.visibility !== 'hidden' && cs.display !== 'none'; };
+        const el = document.querySelector(${sel});
+        return !!(el && vis(el));
+      })()`;
+        }
+        case 'text': {
+            const needle = JSON.stringify((opts.text ?? '').toLowerCase());
+            return `(() => {
+        const body = document.body;
+        if (!body) return false;
+        const t = (body.innerText || body.textContent || '').toLowerCase();
+        return t.includes(${needle});
+      })()`;
+        }
+        case 'dialog': {
+            const wantClosed = opts.state === 'closed';
+            return `(() => {
+        const vis = (el) => { if (!el) return false; const r = el.getBoundingClientRect(); if (r.width === 0 || r.height === 0) return false; const cs = getComputedStyle(el); return cs.visibility !== 'hidden' && cs.display !== 'none'; };
+        const n = [...document.querySelectorAll('dialog[open],[role="dialog"],[aria-modal="true"]')].filter(vis).length;
+        return ${wantClosed ? 'n === 0' : 'n > 0'};
+      })()`;
+        }
+        case 'toast': {
+            const needle = JSON.stringify((opts.text ?? '').toLowerCase());
+            return `(() => {
+        const ev = (window.__tsPageEvents || []).filter((e) => e && e.at >= ${since} &&
+          (e.type === 'toast' || e.type === 'alert' || e.type === 'status' || e.type === 'error'));
+        const needle = ${needle};
+        if (needle) return ev.some((e) => String(e.text || '').toLowerCase().includes(needle));
+        return ev.length > 0;
+      })()`;
+        }
+        case 'url': {
+            const needle = JSON.stringify(opts.urlIncludes ?? '');
+            return `(() => location.href.includes(${needle}))()`;
+        }
+        case 'change':
+            return `(() => !!(window.__tsScreenObs && window.__tsScreenObs.mutated >= ${since}))()`;
+        default:
+            return 'false';
+    }
+}
+/** Empty snapshot used when the page is blocked by a native dialog. */
+function emptyPageSnapshot(nativeDialog, pendingRequests, consoleErrors = []) {
+    return {
+        ...emptyState(),
+        nativeDialog,
+        pendingRequests,
+        consoleErrors,
+    };
+}
+//# sourceMappingURL=page-context.js.map

package/dist/lib/browser/page-context.js.map

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