Wix Headless Replatform

scripts/extract-interactions.mjs

#!/usr/bin/env node
import path from "node:path";
import {
  docsDir,
  ensureDir,
  fetchText,
  normalizeUrl,
  parseArgs,
  readJson,
  resolveOutputDir,
  writeJson,
} from "./lib/common.mjs";
import { extractStylesheetUrls } from "./lib/html-extract.mjs";
import { assertPublicHttpUrl, guardPageRequests } from "./lib/url-safety.mjs";
import { chromiumLaunchOptions, loadPlaywrightFromContext, resolveBrowserToolingContext } from "./lib/browser-tooling.mjs";
import {
  DEFAULT_INTERACTION_TIMELINE_MS,
  compactInteractionTimeline,
  deriveCarouselInvariants,
  deriveScrollInvariants,
} from "./lib/interaction-timeline.mjs";

const GENERIC_SELECTORS = new Set(["*", "body", "html", ":root", "main"]);
const CSS_SIGNAL_PROPS = [
  "transition",
  "transition-property",
  "transition-duration",
  "animation",
  "animation-name",
  "animation-duration",
  "transform",
  "opacity",
  "filter",
  "will-change",
  "scroll-behavior",
];
const SNAPSHOT_STYLE_KEYS = [
  "opacity",
  "transform",
  "backgroundColor",
  "color",
  "boxShadow",
  "filter",
  "width",
  "height",
  "borderColor",
  "borderTopColor",
  "borderRightColor",
  "borderBottomColor",
  "borderLeftColor",
  "borderTopWidth",
  "borderRightWidth",
  "borderBottomWidth",
  "borderLeftWidth",
  "textDecorationLine",
  "textDecorationColor",
  "textDecorationThickness",
  "textUnderlineOffset",
  "outlineColor",
  "outlineStyle",
  "outlineWidth",
  "outlineOffset",
  "fill",
  "stroke",
  "translate",
  "scale",
  "cursor",
  "transitionProperty",
  "transitionDuration",
  "transitionTimingFunction",
];

async function main() {
  const args = parseArgs();
  const sourceUrl = normalizeUrl(args._[0] || args.url).toString();
  const outputDir = resolveOutputDir(sourceUrl, args.out);
  const docs = docsDir(outputDir);
  const pagesDir = path.join(docs, "pages");
  const pages = [];
  if (args.page) {
    pages.push(await readJson(path.resolve(args.page)));
  } else {
    try {
      const defaultPage = path.join(pagesDir, "home-home.json");
      pages.push(await readJson(defaultPage));
    } catch {
      // Page records are optional when running the extractor standalone.
    }
  }
  const interactionMap = await extractInteractions(sourceUrl, {
    outputDir,
    pages,
    browserTooling: args["project-root"]
      ? await resolveBrowserToolingContext({ startDir: path.resolve(args["project-root"]) })
      : undefined,
  });
  await writeJson(path.join(docs, "interaction-map.json"), interactionMap);
  if (pages.length) {
    for (const page of interactionMap.pages || []) {
      await writeJson(path.join(pagesDir, `${safePageName(page)}.json`), page);
    }
  }
  if (args.json) process.stdout.write(`${JSON.stringify(interactionMap, null, 2)}\n`);
}

export async function extractInteractions(sourceUrl, { outputDir, pages = [], browserTooling } = {}) {
  const url = normalizeUrl(sourceUrl).toString();
  // Source sites are untrusted input; only the clone under test (registered with trustOrigin) is exempt.
  await assertPublicHttpUrl(url);
  await writeProgress(outputDir, "fetching_html");
  const html = await fetchText(url);
  await writeProgress(outputDir, "loading_stylesheets");
  const stylesheets = await loadStylesheets(html, url);
  await writeProgress(outputDir, "building_static_inventory");
  const inlineStyles = extractInlineStyles(html, url);
  const staticInventory = buildStaticInventory({ stylesheets, inlineStyles });
  await writeProgress(outputDir, "starting_dynamic_probe", {
    candidateCount: staticInventory.candidates.length,
  });
  const runtime = await runDynamicProbe({
    sourceUrl: url,
    outputDir,
    staticInventory,
    browserTooling,
  });
  await writeProgress(outputDir, "assembling_interaction_map", {
    captureCount: runtime.captures.length,
  });
  const interactions = [...runtime.captures, ...(runtime.specializedCaptures || [])].map((capture, index) => ({
    id: capture.id || `interaction-${String(index + 1).padStart(3, "0")}`,
    kind: classifyCapture(capture),
    trigger: normalizeTrigger(capture.trigger),
    importance: classifyImportance(capture),
    sources: capture.sources || [],
    changedProperties: (capture.diff?.changedProperties || []).map((item) => item.property),
    textChanged: Boolean(capture.diff?.textChanged),
    states: summarizeStates(capture),
    implementationHint: implementationHintFor(capture),
    evidence: capture.screenshot ? { screenshot: capture.screenshot } : {},
    label: capture.label || "",
    ...(capture.probeId ? { controlId: capture.probeId } : {}),
    ...(capture.controlRole ? { controlRole: capture.controlRole } : {}),
    ...(capture.controlScope ? { controlScope: capture.controlScope } : {}),
    ...(capture.scope ? { scope: capture.scope } : {}),
    ...(capture.timeline ? { timeline: capture.timeline } : {}),
    ...(capture.invariants ? { invariants: capture.invariants } : {}),
  }));
  const enrichedPages = pages.map((page) => enrichPageRecord(page, { generatedAt: new Date().toISOString(), staticInventory, runtime }));
  bindInteractionsToSections(interactions, enrichedPages);
  const summaryKinds = interactions.reduce((acc, item) => {
    acc[item.kind] = (acc[item.kind] || 0) + 1;
    return acc;
  }, {});
  return {
    sourceUrl: url,
    generatedAt: new Date().toISOString(),
    staticSummary: staticInventory.summary,
    summary: {
      interactionCount: interactions.length,
      kinds: summaryKinds,
      targetCount: runtime.summary.targetCount,
      meaningfulCaptureCount: runtime.summary.meaningfulCaptureCount,
    },
    interactions,
    structural: runtime.structural,
    probeDiagnostics: runtime.probeDiagnostics || [],
    pages: enrichedPages,
  };
}

async function writeProgress(outputDir, stage, details = {}) {
  if (!outputDir) return;
  await writeJson(path.join(docsDir(outputDir), "interaction-progress.json"), {
    stage,
    updatedAt: new Date().toISOString(),
    ...details,
  });
}

async function loadStylesheets(html, sourceUrl) {
  const urls = extractStylesheetUrls(html, sourceUrl);
  const stylesheets = [];
  for (const stylesheetUrl of urls.slice(0, 24)) {
    try {
      const cssText = await fetchText(stylesheetUrl, {
        headers: { accept: "text/css,*/*;q=0.1" },
      });
      stylesheets.push({ url: stylesheetUrl, cssText, sourceType: "linked-stylesheet" });
    } catch (error) {
      stylesheets.push({ url: stylesheetUrl, cssText: "", sourceType: "linked-stylesheet", warning: error.message });
    }
  }
  return stylesheets;
}

function extractInlineStyles(html, sourceUrl) {
  const out = [];
  const pattern = /<style\b[^>]*>([\s\S]*?)<\/style>/gi;
  let match;
  let index = 0;
  while ((match = pattern.exec(html))) {
    const cssText = String(match[1] || "").trim();
    if (!cssText) continue;
    index += 1;
    out.push({
      url: `${sourceUrl}#inline-style-${index}`,
      cssText,
      sourceType: "inline-style",
    });
  }
  return out;
}

function buildStaticInventory({ stylesheets, inlineStyles }) {
  const sources = [...stylesheets, ...inlineStyles];
  const keyframes = [];
  const rules = [];
  const candidateMap = new Map();
  for (const source of sources) {
    const cssText = source.cssText || "";
    if (!cssText) continue;
    for (const match of cssText.matchAll(/@keyframes\s+([^{\s]+)\s*\{/g)) {
      keyframes.push({ name: match[1], sourceUrl: source.url });
    }
    for (const rule of parseCssRules(cssText)) {
      const signals = extractSignals(rule.declarations);
      if (!signals.length) continue;
      const pseudos = extractPseudos(rule.selector);
      const baseSelector = normalizeSelector(rule.selector);
      rules.push({ selector: rule.selector, baseSelector, sourceUrl: source.url, pseudos, signals });
      if (!baseSelector) continue;
      const key = `${baseSelector}\u0000${pseudos.sort().join(",")}`;
      const existing = candidateMap.get(key) || {
        baseSelector,
        selectors: [],
        pseudos: new Set(),
        signals: new Set(),
      };
      existing.selectors.push(rule.selector);
      for (const pseudo of pseudos) existing.pseudos.add(pseudo);
      for (const signal of signals) existing.signals.add(signal);
      candidateMap.set(key, existing);
    }
  }
  const candidates = Array.from(candidateMap.values())
    .map((candidate) => ({
      baseSelector: candidate.baseSelector,
      selectors: candidate.selectors.slice(0, 6),
      pseudos: Array.from(candidate.pseudos),
      signals: Array.from(candidate.signals),
      likelyTriggers: inferTriggers(Array.from(candidate.pseudos), Array.from(candidate.signals)),
    }))
    .filter((candidate) => candidate.baseSelector && !GENERIC_SELECTORS.has(candidate.baseSelector))
    .slice(0, 120);
  return {
    sourceCount: sources.length,
    stylesheetCount: stylesheets.length,
    inlineStyleCount: inlineStyles.length,
    keyframes,
    rules,
    candidates,
    summary: {
      keyframeCount: keyframes.length,
      ruleCount: rules.length,
      candidateCount: candidates.length,
    },
  };
}

function parseCssRules(cssText) {
  const rules = [];
  const pattern = /([^{}@][^{}]*)\{([^{}]+)\}/g;
  let match;
  while ((match = pattern.exec(cssText))) {
    const selector = String(match[1] || "").trim();
    const declarations = String(match[2] || "").trim();
    if (!selector || !declarations) continue;
    rules.push({ selector, declarations });
  }
  return rules;
}

function extractSignals(declarations) {
  const found = [];
  const lowered = declarations.toLowerCase();
  for (const prop of CSS_SIGNAL_PROPS) {
    if (lowered.includes(`${prop}:`)) found.push(prop);
  }
  return Array.from(new Set(found));
}

function extractPseudos(selector) {
  return Array.from(new Set((selector.match(/:(hover|focus-visible|focus-within|focus|active|target|checked)/g) || [])
    .map((value) => value.slice(1))));
}

function normalizeSelector(selector) {
  const cleaned = selector
    .replace(/::?[\w-]+(?:\([^)]*\))?/g, "")
    .replace(/\[[^\]]+\]/g, "")
    .replace(/\s+/g, " ")
    .split(",")[0]
    .trim();
  if (!cleaned || cleaned.startsWith("@")) return "";
  return cleaned;
}

function inferTriggers(pseudos, signals) {
  const triggers = new Set();
  for (const pseudo of pseudos) {
    if (pseudo === "hover") triggers.add("hover");
    if (pseudo === "focus" || pseudo === "focus-visible" || pseudo === "focus-within") triggers.add("focus");
    if (pseudo === "active") triggers.add("press");
    if (pseudo === "checked" || pseudo === "target") triggers.add("click");
  }
  if (signals.includes("animation") || signals.includes("animation-name")) triggers.add("load");
  return Array.from(triggers);
}

function redactProbeUrl(value) {
  try {
    const url = new URL(value);
    for (const key of [...url.searchParams.keys()]) {
      if (/token|key|secret|auth|password|session|email|code/i.test(key)) url.searchParams.set(key, "[redacted]");
    }
    return url.toString();
  } catch {
    return "[unparseable-url]";
  }
}

async function runDynamicProbe({ sourceUrl, outputDir, staticInventory, browserTooling }) {
  await writeProgress(outputDir, "resolving_browser_tooling");
  const toolingContext = browserTooling || await resolveBrowserToolingContext({ startDir: process.cwd() });
  await writeProgress(outputDir, "loading_playwright", { projectRoot: toolingContext.projectRoot });
  const playwright = await loadPlaywrightFromContext(toolingContext);
  await writeProgress(outputDir, "launching_browser");
  const browser = await withTimeout(
    playwright.chromium.launch(chromiumLaunchOptions()),
    30_000,
    "Chromium launch",
  );
  await writeProgress(outputDir, "creating_browser_page");
  const page = await withTimeout(
    browser.newPage({ viewport: { width: 1440, height: 900 } }),
    30_000,
    "Chromium page creation",
  );
  // Refuse internal destinations, including through redirects and from the clone under test (only its own origin is exempt).
  await guardPageRequests(page);
  await writeProgress(outputDir, "browser_page_ready");
  const screenshotsDir = path.join(docsDir(outputDir), "screenshots");
  await ensureDir(screenshotsDir);
  const blockedRequests = [];
  const safeProbeRoute = async (route) => {
    const request = route.request();
    const method = request.method().toUpperCase();
    if (request.isNavigationRequest() || !["GET", "HEAD", "OPTIONS"].includes(method)) {
      blockedRequests.push({ method, url: redactProbeUrl(request.url()), reason: request.isNavigationRequest() ? "navigation-blocked" : "mutating-request-blocked" });
      await route.abort("blockedbyclient");
      return;
    }
    await route.fallback();
  };
  try {
    await writeProgress(outputDir, "loading_source_page");
    await page.goto(sourceUrl, { waitUntil: "domcontentloaded", timeout: 45000 });
    await writeProgress(outputDir, "capturing_dynamic_interactions");
    await page.waitForTimeout(2600);
    await page.route("**/*", safeProbeRoute);
    const ignoredSurfaces = await markIgnoredConsentSurfaces(page);
    const liveAnimationSnapshot = await page.evaluate(() =>
      document.getAnimations().map((animation) => ({
        playState: animation.playState,
        currentTime: animation.currentTime,
        effectTarget: animation.effect?.target?.tagName?.toLowerCase() || "",
      })),
    );
    const targets = await tagProbeTargets(page, staticInventory.candidates);
    const captures = [];
    const probeDiagnostics = [];
    for (const [targetIndex, target] of targets.slice(0, 28).entries()) {
      const triggerOrder = target.triggers.includes("hover")
        ? ["hover", ...target.triggers.filter((item) => item !== "hover")]
        : target.triggers;
      for (const trigger of triggerOrder.slice(0, 4)) {
        await writeProgress(outputDir, "capturing_dynamic_interaction", {
          targetIndex: targetIndex + 1,
          targetCount: Math.min(targets.length, 28),
          probeId: target.probeId,
          trigger,
        });
        const capture = await captureInteractionBounded(page, target, trigger, screenshotsDir);
        probeDiagnostics.push({ probeId: target.probeId, label: target.text, role: target.role, scope: target.scope, trigger, meaningful: Boolean(capture.meaningful), error: capture.error || null, changedProperties: (capture.diff?.changedProperties || []).map((item) => item.property) });
        if (capture.meaningful) captures.push(capture);
      }
    }
    // Generic probes scroll and mutate controls. Reset before scene probes so initial
    // header, tab, and carousel states are not contaminated by probe order.
    await page.evaluate(() => {
      if ("scrollRestoration" in history) history.scrollRestoration = "manual";
      window.scrollTo(0, 0);
    });
    await page.unroute("**/*", safeProbeRoute);
    await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
    await page.route("**/*", safeProbeRoute);
    await page.waitForTimeout(1800);
    await page.evaluate(() => window.scrollTo(0, 0));
    await page.waitForTimeout(400);
    await markIgnoredConsentSurfaces(page);
    const headerScroll = await probeHeaderScrollState(page, screenshotsDir);
    const scrollTabs = await probeScrollTabsState(page, screenshotsDir);
    const carousels = await probeCarouselStates(page, screenshotsDir);
    const specialized = {
      headerScroll,
      scrollTabs,
      carousel: carousels[0] || { missing: true },
      carousels,
    };
    const structural = await page.evaluate(() => {
      const visible = (node) => {
        if (!(node instanceof Element)) return false;
        if (node.closest("[data-rp-ignored-surface]")) return false;
        const rect = node.getBoundingClientRect();
        const style = getComputedStyle(node);
        return rect.width > 0 && rect.height > 0 && style.display !== "none" && style.visibility !== "hidden";
      };
      const canonicalMediaSource = (value) => {
        const raw = String(value || "").trim();
        if (!raw) return raw;
        try {
          const url = new URL(raw, window.location.href);
          url.search = url.search.replace(/\?([^?]*)\?/g, "?$1&");
          return url.toString();
        } catch {
          return raw;
        }
      };
      const tabs = Array.from(document.querySelectorAll("[role='tab'], [aria-controls], [data-tab], [data-panel]"))
        .filter(visible)
        .map((node) => node.textContent?.replace(/\s+/g, " ").trim())
        .filter(Boolean);
      const media = Array.from(document.querySelectorAll("iframe, video, canvas, [data-lottie], [class*='lottie']"))
        .filter(visible)
        .map((node, index) => {
          const src = canonicalMediaSource(node.currentSrc || node.getAttribute("src") || node.getAttribute("data-src") || "");
          let provider = "";
          let playback = {};
          try {
            const url = new URL(src, window.location.href);
            provider = /vimeo\.com/i.test(url.hostname) ? "vimeo" : /youtube\.com|youtu\.be/i.test(url.hostname) ? "youtube" : url.hostname;
            playback = {
              autoplay: url.searchParams.get("autoplay") === "1",
              loop: url.searchParams.get("loop") === "1",
              muted: url.searchParams.get("muted") === "1",
              background: url.searchParams.get("background") === "1",
            };
          } catch {
            // A relative or deferred source is still useful to the implementation agent.
          }
          const parent = node.parentElement;
          const owner = node.closest("section,header,footer,main") || parent;
          const classTokens = String(node.className || "").split(/\s+/).filter(Boolean);
          const mediaStyle = getComputedStyle(node);
          let fallbackSource = canonicalMediaSource(node.getAttribute("poster") || node.getAttribute("data-poster") || "");
          let fallbackOrigin = fallbackSource ? "media-attribute" : "";
          if (!fallbackSource) {
            for (let current = parent; current && current !== owner?.parentElement; current = current.parentElement) {
              const backgroundImage = getComputedStyle(current).backgroundImage || "";
              const match = backgroundImage.match(/url\(["']?([^"')]+)["']?\)/i);
              if (match?.[1]) {
                fallbackSource = canonicalMediaSource(match[1]);
                fallbackOrigin = "ancestor-background";
                break;
              }
              if (current === owner) break;
            }
          }
          const visiblyComposite = Number(mediaStyle.opacity || 1) < 0.99 || (mediaStyle.mixBlendMode && mediaStyle.mixBlendMode !== "normal");
          return {
            id: `media-${String(index + 1).padStart(3, "0")}`,
            tag: node.tagName.toLowerCase(),
            src,
            provider,
            playback,
            role: playback.background || /hero|background|scene|scroll|cover/i.test(`${classTokens.join(" ")} ${parent?.className || ""}`) ? "background" : node.tagName.toLowerCase() === "canvas" ? "runtime-surface" : "inline",
            presentation: {
              opacity: mediaStyle.opacity,
              mixBlendMode: mediaStyle.mixBlendMode,
            },
            ...(fallbackSource ? {
              fallback: {
                src: fallbackSource,
                origin: fallbackOrigin,
                policy: visiblyComposite ? "composite" : "fallback-only",
              },
            } : {}),
            domRef: {
              id: node.id || "",
              classTokens: classTokens.slice(0, 8),
              parentClassTokens: String(parent?.className || "").split(/\s+/).filter(Boolean).slice(0, 8),
              sectionClassTokens: String(owner?.className || "").split(/\s+/).filter(Boolean).slice(0, 12),
              sectionTextFingerprint: String(owner?.textContent || "").replace(/\s+/g, " ").trim().slice(0, 180),
            },
          };
        });
      return {
        tabLabels: tabs.slice(0, 12),
        embedCount: media.length,
        media,
      };
    });
    structural.ignoredSurfaces = ignoredSurfaces;
    const specializedCaptures = deriveSpecializedCaptures({ ...specialized, media: structural.media });
    return {
      liveAnimationSnapshot,
      targets,
      captures,
      probeDiagnostics,
      safeProbeAudit: {
        policy: "public-presentation-controls-only",
        blockedRequests,
        actionBudget: { targetLimit: 28, triggerLimitPerTarget: 4, probeTimeoutMs: 8000 },
      },
      specialized,
      specializedCaptures,
      structural,
      summary: {
        targetCount: targets.length,
        meaningfulCaptureCount: captures.length + specializedCaptures.length,
        liveAnimationCount: liveAnimationSnapshot.length,
      },
    };
  } finally {
    await browser.close();
  }
}

async function captureInteractionBounded(page, target, trigger, screenshotsDir) {
  try {
    return await withTimeout(
      captureInteraction(page, target, trigger, screenshotsDir),
      8_000,
      `Interaction probe ${target.probeId} (${trigger})`,
    );
  } catch (error) {
    return {
      probeId: target.probeId,
      label: target.text || target.className || target.tag,
      trigger,
      sources: target.sources,
      meaningful: false,
      error: error.message,
    };
  }
}

async function withTimeout(operation, timeoutMs, label) {
  let timeout;
  try {
    return await Promise.race([
      operation,
      new Promise((_, reject) => {
        timeout = setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs / 1000}s.`)), timeoutMs);
      }),
    ]);
  } finally {
    clearTimeout(timeout);
  }
}

async function tagProbeTargets(page, staticCandidates) {
  return page.evaluate((staticCandidates) => {
    const visible = (node) => {
      if (!(node instanceof Element)) return false;
      if (node.closest("[data-rp-ignored-surface]")) return false;
      const rect = node.getBoundingClientRect();
      const style = getComputedStyle(node);
      return rect.width > 0 && rect.height > 0 && style.display !== "none" && style.visibility !== "hidden";
    };
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const semanticSelectors = [
      { selector: "header a", limit: 10, priority: 100 },
      { selector: "footer a", limit: 10, priority: 96 },
      { selector: "a[class*='button' i],a[class*='cta' i],a[role='button']", limit: 8, priority: 98 },
      { selector: "button", limit: 8, priority: 94 },
      { selector: "details > summary", limit: 12, priority: 93 },
      { selector: "[aria-expanded='true'],[aria-expanded='false']", limit: 12, priority: 93 },
      { selector: "[role='tab']", limit: 6, priority: 92 },
      { selector: "[aria-controls]", limit: 4, priority: 90 },
      { selector: "[data-tab]", limit: 4, priority: 88 },
      { selector: "[data-carousel-card]", limit: 4, priority: 82 },
      { selector: "[role='listitem']", limit: 2, priority: 50 },
      { selector: "article", limit: 2, priority: 30 },
      { selector: "iframe", limit: 2, priority: 20 },
      { selector: "video", limit: 2, priority: 20 },
    ];
    const targetMap = new Map();
    let sequence = 0;
    const addTarget = (element, source, triggers, priority = 40) => {
      if (!element || !visible(element)) return;
      const textClone = element.cloneNode(true);
      textClone.querySelectorAll?.("svg,script,style").forEach((node) => node.remove());
      const text = clean(textClone.textContent || element.getAttribute("aria-label") || element.getAttribute("title") || element.textContent).slice(0, 120);
      if (/window\.|document\.|function\s*\(|nreum/i.test(text)) return;
      const key = element;
      if (targetMap.has(key)) {
        const existing = targetMap.get(key);
        for (const trigger of triggers) existing.triggers.add(trigger);
        existing.sources.add(source);
        existing.priority = Math.max(existing.priority || 0, priority);
        return;
      }
      sequence += 1;
      const probeId = `probe-${sequence}`;
      element.setAttribute("data-probe-id", probeId);
      targetMap.set(key, {
        probeId,
        text,
        tag: element.tagName.toLowerCase(),
        className: clean(element.className || "").slice(0, 140),
        sources: new Set([source]),
        triggers: new Set(triggers),
        priority,
        role: element.getAttribute("role") || (element.matches("a[href]") ? "link" : element.matches("button") ? "button" : element.tagName.toLowerCase()),
        scope: element.closest("header") ? "header" : element.closest("footer") ? "footer" : element.closest("nav") ? "navigation" : "content",
      });
    };
    for (const candidate of staticCandidates.slice(0, 80)) {
      if (!candidate.baseSelector) continue;
      let matches = [];
      try {
        matches = Array.from(document.querySelectorAll(candidate.baseSelector)).filter(visible).slice(0, 2);
      } catch {
        matches = [];
      }
      for (const match of matches) {
        addTarget(match, `css:${candidate.baseSelector}`, candidate.likelyTriggers.length ? candidate.likelyTriggers : ["hover"], 45);
      }
    }
    for (const entry of semanticSelectors) {
      let matches = [];
      try {
        matches = Array.from(document.querySelectorAll(entry.selector)).filter(visible).sort((left, right) => {
          const readable = (node) => {
            const clone = node.cloneNode(true);
            clone.querySelectorAll?.("svg,script,style").forEach((child) => child.remove());
            return clean(clone.textContent).length >= 2 ? 1 : 0;
          };
          return readable(right) - readable(left);
        }).slice(0, entry.limit);
      } catch {
        matches = [];
      }
      for (const match of matches) {
        const triggers = match.matches("button,[role='tab'],[aria-controls],summary,[aria-expanded]")
          ? ["hover", "focus", "press", "click"]
          : match.matches("a[href]") ? ["hover", "focus", "press"] : ["hover", "focus"];
        addTarget(match, `semantic:${entry.selector}`, triggers, entry.priority);
      }
    }
    return Array.from(targetMap.values()).sort((left, right) => (right.priority || 0) - (left.priority || 0)).map((target) => ({
      ...target,
      sources: Array.from(target.sources),
      triggers: Array.from(target.triggers),
    }));
  }, staticCandidates);
}

async function markIgnoredConsentSurfaces(page) {
  return page.evaluate(() => {
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const visible = (node) => {
      if (!(node instanceof Element)) return false;
      const rect = node.getBoundingClientRect();
      const style = getComputedStyle(node);
      return rect.width > 0 && rect.height > 0 && style.display !== "none" && style.visibility !== "hidden" && Number(style.opacity || 1) > 0;
    };
    const selector = [
      "#onetrust-banner-sdk",
      "#onetrust-consent-sdk",
      "[class*='onetrust' i]",
      "[id*='cookie-banner' i]",
      "[class*='cookie-banner' i]",
      "[id*='consent-banner' i]",
      "[class*='consent-banner' i]",
      "[role='dialog']",
    ].join(",");
    const candidates = Array.from(document.querySelectorAll(selector)).filter(visible).filter((node) => {
      const text = clean(node.textContent).toLowerCase();
      const identity = `${node.id || ""} ${node.className || ""} ${node.getAttribute("aria-label") || ""}`.toLowerCase();
      const controls = Array.from(node.querySelectorAll("button,a,[role='button']")).map((control) => clean(control.textContent)).join(" ").toLowerCase();
      const style = getComputedStyle(node);
      const rect = node.getBoundingClientRect();
      const consentSignal = /cookie|consent|privacy preferences|tracking preferences/.test(`${identity} ${text}`);
      const actionSignal = /accept|reject|decline|customi[sz]e|preferences|allow all/.test(controls);
      const overlaySignal = style.position === "fixed" || style.position === "sticky" || node.getAttribute("role") === "dialog" || rect.width >= window.innerWidth * 0.55;
      return /onetrust|cookiebot|quantcast/.test(identity) || consentSignal && actionSignal && overlaySignal;
    });
    const roots = candidates.filter((node, index, all) => !all.some((candidate, candidateIndex) => candidateIndex !== index && candidate.contains(node)));
    return roots.map((node, index) => {
      node.setAttribute("data-rp-ignored-surface", "consent-management");
      const rect = node.getBoundingClientRect();
      const identity = `${node.id || ""} ${node.className || ""}`.toLowerCase();
      return {
        id: `ignored-surface-${String(index + 1).padStart(3, "0")}`,
        kind: "consent-management",
        provider: /onetrust|ot-sdk/.test(identity) ? "onetrust" : /cookiebot/.test(identity) ? "cookiebot" : /quantcast/.test(identity) ? "quantcast" : "unknown",
        creationPolicy: "ignore",
        reason: "Destination consent must be implemented as functional infrastructure, not cloned page content.",
        textFingerprint: clean(node.textContent).slice(0, 240),
        rect: { top: Math.round(rect.top), left: Math.round(rect.left), width: Math.round(rect.width), height: Math.round(rect.height) },
        domRef: {
          tag: node.tagName.toLowerCase(),
          id: node.id || "",
          classTokens: String(node.className || "").split(/\s+/).filter(Boolean).slice(0, 10),
        },
      };
    });
  });
}

async function captureInteraction(page, target, trigger, screenshotsDir) {
  const selector = `[data-probe-id="${target.probeId}"]`;
  const locator = page.locator(selector).first();
  try {
    const before = await readProbeSnapshot(page, target.probeId);
    if (!before) return { probeId: target.probeId, trigger, meaningful: false };
    await locator.scrollIntoViewIfNeeded();
    await page.waitForTimeout(80);
    if (trigger === "hover") await locator.hover({ force: true });
    else if (trigger === "focus") await locator.focus();
    else if (trigger === "press") {
      await locator.hover({ force: true });
      await page.mouse.down();
    }
    else if (trigger === "click") {
      const safety = await locator.evaluate((node) => {
        const identity = `${node.tagName} ${node.getAttribute("role") || ""} ${node.getAttribute("aria-label") || ""} ${node.id || ""} ${node.className || ""} ${node.textContent || ""}`.toLowerCase();
        const href = node.closest("a[href]")?.getAttribute("href") || "";
        const formOwner = node.closest("form");
        const unsafe = Boolean(formOwner)
          || /submit|login|sign.?in|register|checkout|cart|purchase|buy|book|upload|delete|remove|admin|account|password/.test(identity)
          || Boolean(href && !href.startsWith("#"));
        const presentation = /tab|accordion|disclosure|carousel|slider|gallery|menu|navigation/.test(identity)
          || node.hasAttribute("aria-controls")
          || node.hasAttribute("aria-expanded")
          || node.getAttribute("role") === "tab";
        return { safe: !unsafe && presentation, reason: unsafe ? "unsafe-or-business-action" : presentation ? "allowlisted-presentation-control" : "unclassified-control" };
      });
      if (!safety.safe) {
        return {
          probeId: target.probeId,
          label: target.text || target.className || target.tag,
          tag: target.tag,
          trigger,
          sources: target.sources,
          meaningful: false,
          blocked: true,
          error: `Safe probing blocked click: ${safety.reason}`,
        };
      }
      await locator.dispatchEvent("click");
    }
    if (trigger === "load") await page.waitForTimeout(120);
    if (trigger === "hover" || trigger === "focus" || trigger === "click") await page.waitForTimeout(220);
    if (trigger === "press") await page.waitForTimeout(80);
    const after = await readProbeSnapshot(page, target.probeId);
    const diff = diffSnapshots(before, after);
    const liveAnimations = await page.evaluate((probeId) => {
      const node = document.querySelector(`[data-probe-id="${probeId}"]`);
      return document.getAnimations().filter((animation) => {
        const effectTarget = animation.effect?.target;
        return effectTarget instanceof Element && (effectTarget === node || node?.contains(effectTarget) || effectTarget.contains?.(node));
      }).map((animation) => ({
        playState: animation.playState,
        currentTime: animation.currentTime,
      }));
    }, target.probeId);
    const meaningful = diff.changedProperties.length > 0 || diff.textChanged || diff.attributeChanges.length > 0 || liveAnimations.length > 0;
    let screenshot = null;
    if (meaningful) {
      screenshot = path.join(screenshotsDir, `${target.probeId}-${trigger}.png`);
      try {
        await locator.screenshot({ path: screenshot });
      } catch {
        screenshot = null;
      }
    }
    if (trigger === "press") {
      await page.mouse.move(2, 2);
      await page.mouse.up();
    }
    if (trigger === "hover") await page.mouse.move(2, 2);
    return {
      probeId: target.probeId,
      label: target.text || target.className || target.tag,
      tag: target.tag,
      controlRole: target.role,
      controlScope: target.scope,
      trigger,
      sources: target.sources,
      meaningful,
      before,
      after,
      diff,
      liveAnimations,
      screenshot,
    };
  } catch (error) {
    if (trigger === "press") {
      await page.mouse.move(2, 2).catch(() => {});
      await page.mouse.up().catch(() => {});
    }
    return {
      probeId: target.probeId,
      label: target.text || target.className || target.tag,
      tag: target.tag,
      trigger,
      sources: target.sources,
      meaningful: false,
      error: error.message,
    };
  }
}

async function readProbeSnapshot(page, probeId) {
  return page.evaluate(({ probeId, styleKeys }) => {
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const node = document.querySelector(`[data-probe-id="${probeId}"]`);
    if (!(node instanceof Element)) return null;
    const style = getComputedStyle(node);
    const rect = node.getBoundingClientRect();
    const section = node.closest("section,header,main,article,nav,footer");
    const sectionText = section ? clean(section.textContent).slice(0, 420) : "";
    const text = clean(node.textContent).slice(0, 180);
    const styleRecord = (target, pseudo = null) => {
      const computed = getComputedStyle(target, pseudo);
      const styles = {};
      for (const key of styleKeys) styles[key] = computed[key];
      return styles;
    };
    const visualChildren = Array.from(new Set([
      ...Array.from(node.children),
      ...Array.from(node.querySelectorAll("svg,use,path,i,[class*='icon' i],[aria-hidden='true']")),
    ]))
      .filter((child) => child instanceof Element)
      .slice(0, 12)
      .map((child, index) => ({
        key: `${child.tagName.toLowerCase()}:${index}`,
        tag: child.tagName.toLowerCase(),
        className: clean(child.className?.baseVal || child.className || ""),
        styles: styleRecord(child),
        pseudo: {
          before: styleRecord(child, "::before"),
          after: styleRecord(child, "::after"),
        },
      }));
    return {
      text,
      sectionText,
      rect: {
        width: Math.round(rect.width),
        height: Math.round(rect.height),
        top: Math.round(rect.top),
        left: Math.round(rect.left),
      },
      styles: styleRecord(node),
      pseudo: {
        before: styleRecord(node, "::before"),
        after: styleRecord(node, "::after"),
      },
      visualChildren,
      className: clean(node.className || ""),
      ariaSelected: node.getAttribute("aria-selected") || "",
      ariaExpanded: node.getAttribute("aria-expanded") || "",
      ariaCurrent: node.getAttribute("aria-current") || "",
      ariaPressed: node.getAttribute("aria-pressed") || "",
      disabled: node.matches(":disabled,[aria-disabled='true']"),
    };
  }, { probeId, styleKeys: SNAPSHOT_STYLE_KEYS });
}

function diffSnapshots(before, after) {
  if (!before || !after) return { changedProperties: [], textChanged: false, attributeChanges: [] };
  const changedProperties = [];
  for (const key of SNAPSHOT_STYLE_KEYS) {
    if (String(before.styles[key]) !== String(after.styles[key])) {
      changedProperties.push({ property: key, before: before.styles[key], after: after.styles[key] });
    }
  }
  for (const pseudo of ["before", "after"]) {
    for (const key of SNAPSHOT_STYLE_KEYS) {
      if (String(before.pseudo?.[pseudo]?.[key]) !== String(after.pseudo?.[pseudo]?.[key])) {
        changedProperties.push({ property: `::${pseudo}.${key}`, before: before.pseudo?.[pseudo]?.[key], after: after.pseudo?.[pseudo]?.[key] });
      }
    }
  }
  const childKeys = new Set([...(before.visualChildren || []).map((child) => child.key), ...(after.visualChildren || []).map((child) => child.key)]);
  for (const childKey of childKeys) {
    const beforeChild = before.visualChildren?.find((child) => child.key === childKey);
    const afterChild = after.visualChildren?.find((child) => child.key === childKey);
    for (const key of SNAPSHOT_STYLE_KEYS) {
      if (String(beforeChild?.styles?.[key]) !== String(afterChild?.styles?.[key])) {
        changedProperties.push({ property: `child:${childKey}.${key}`, before: beforeChild?.styles?.[key], after: afterChild?.styles?.[key] });
      }
    }
    for (const pseudo of ["before", "after"]) {
      for (const key of SNAPSHOT_STYLE_KEYS) {
        if (String(beforeChild?.pseudo?.[pseudo]?.[key]) !== String(afterChild?.pseudo?.[pseudo]?.[key])) {
          changedProperties.push({ property: `child:${childKey}::${pseudo}.${key}`, before: beforeChild?.pseudo?.[pseudo]?.[key], after: afterChild?.pseudo?.[pseudo]?.[key] });
        }
      }
    }
  }
  const attributeChanges = [];
  for (const key of ["className", "ariaSelected", "ariaExpanded", "ariaCurrent", "ariaPressed", "disabled"]) {
    if (String(before[key]) !== String(after[key])) {
      attributeChanges.push({ property: key, before: before[key], after: after[key] });
    }
  }
  return {
    changedProperties,
    textChanged: before.text !== after.text || before.sectionText !== after.sectionText,
    attributeChanges,
  };
}

async function probeHeaderScrollState(page, screenshotsDir) {
  const result = await page.evaluate(async () => {
    const visible = (node) => {
      if (!(node instanceof Element)) return false;
      const rect = node.getBoundingClientRect();
      const style = getComputedStyle(node);
      return rect.width > 0 && rect.height > 0 && style.display !== "none" && style.visibility !== "hidden";
    };
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const header = document.querySelector("header,[role='banner'],#header,.header,.site-header,.main-header,.masthead,.sticky-header");
    if (!visible(header)) return { missing: true };
    const snapshot = (name) => {
      const style = getComputedStyle(header);
      const rect = header.getBoundingClientRect();
      return {
        name,
        className: clean(header.className || ""),
        height: Math.round(rect.height),
        position: style.position,
        backgroundColor: style.backgroundColor,
        backdropFilter: style.backdropFilter || style.webkitBackdropFilter || "",
      };
    };
    const initial = snapshot("initial");
    const scrollTarget = Math.max(220, Math.min(document.documentElement.scrollHeight - window.innerHeight, Math.round(window.innerHeight * 0.75)));
    window.scrollTo(0, scrollTarget);
    await new Promise((resolve) => setTimeout(resolve, 400));
    const scrolled = snapshot("scrolled");
    window.scrollTo(0, 0);
    await new Promise((resolve) => setTimeout(resolve, 200));
    return { initial, scrolled };
  });
  if (!result || result.missing) return { missing: true };
  const changedProperties = [];
  for (const key of ["className", "height", "position", "backgroundColor", "backdropFilter"]) {
    if (String(result.initial[key]) !== String(result.scrolled[key])) {
      changedProperties.push({ property: key, before: result.initial[key], after: result.scrolled[key] });
    }
  }
  return {
    initial: result.initial,
    scrolled: result.scrolled,
    changedProperties,
    screenshot: await captureStateScreenshots(
      page,
      "header,[role='banner'],#header,.header,.site-header,.main-header,.masthead,.sticky-header",
      screenshotsDir,
      "header",
      async () => page.evaluate(() => {
        const scrollTarget = Math.max(220, Math.min(document.documentElement.scrollHeight - window.innerHeight, Math.round(window.innerHeight * 0.75)));
        window.scrollTo(0, scrollTarget);
      }),
    ),
    meaningful: changedProperties.length > 0,
  };
}

async function probeScrollTabsState(page, screenshotsDir) {
  const result = await page.evaluate(async () => {
    const visible = (node) => {
      if (!(node instanceof Element)) return false;
      const rect = node.getBoundingClientRect();
      const style = getComputedStyle(node);
      return rect.width > 0 && rect.height > 0 && style.display !== "none" && style.visibility !== "hidden";
    };
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const roots = Array.from(document.querySelectorAll("main section, [data-scroll-section], [data-scroll-scene], [data-animation-scene]"));
    const root = roots.filter(visible).map((node) => ({ node, score: (node.querySelector("iframe,video,canvas") ? 4 : 0) + (node.querySelector("[role='tab'],[aria-controls],[data-tab],button") ? 2 : 0) + (node.getBoundingClientRect().height > innerHeight ? 1 : 0) })).sort((a, b) => b.score - a.score)[0]?.node;
    if (!visible(root)) return { missing: true };
    root.setAttribute("data-rp-scroll-probe", "true");
    const visual = root.querySelector("iframe, video, canvas, img, [data-scene-visual], [data-scroll-visual]");
    const copy = root.querySelector("[data-scene-copy], [data-scroll-copy], [role='tabpanel'], h1,h2,h3") || root;
    const snapshot = (name) => {
      const rootRect = root.getBoundingClientRect();
      const visualRect = visual?.getBoundingClientRect() || null;
      const copyRect = copy?.getBoundingClientRect() || null;
      const copyStyle = copy ? getComputedStyle(copy) : null;
      const visualChain = [];
      for (let node = visual; node && node !== root.parentElement && visualChain.length < 5; node = node.parentElement) {
        const style = getComputedStyle(node);
        const rect = node.getBoundingClientRect();
        visualChain.push({
          tag: node.tagName.toLowerCase(),
          className: clean(node.className || ""),
          position: style.position,
          overflow: style.overflow,
          transform: style.transform,
          opacity: style.opacity,
          clipPath: style.clipPath,
          borderRadius: style.borderRadius,
          width: Math.round(rect.width),
          height: Math.round(rect.height),
          left: Math.round(rect.left),
          top: Math.round(rect.top),
        });
        if (node === root) break;
      }
      const sceneLayers = Array.from(root.querySelectorAll("*"))
        .map((node) => ({ node, style: getComputedStyle(node), rect: node.getBoundingClientRect() }))
        .filter(({ node, style, rect }) => rect.height >= 80 && style.display !== "none" && style.visibility !== "hidden" && (/curtain|mask|overlay|scrim|scroll-over__bg|scroll-over__frame/i.test(String(node.className || "")) || ["absolute", "fixed", "sticky"].includes(style.position)))
        .slice(0, 18)
        .map(({ node, style, rect }) => ({
          tag: node.tagName.toLowerCase(),
          className: clean(node.className || ""),
          role: /curtain|mask|scrim/i.test(String(node.className || "")) ? "curtain" : /\bbg\b|background/i.test(String(node.className || "")) ? "background" : "layer",
          position: style.position,
          transform: style.transform,
          opacity: style.opacity,
          clipPath: style.clipPath,
          backgroundColor: style.backgroundColor,
          width: Math.round(rect.width),
          height: Math.round(rect.height),
          left: Math.round(rect.left),
          top: Math.round(rect.top),
        }));
      return {
        name,
        scrollY: Math.round(window.scrollY),
        rootClassName: clean(root.className || ""),
        visualClassName: clean(visual?.className || ""),
        copyClassName: clean(copy?.className || ""),
        rootTop: Math.round(rootRect.top),
        rootWidth: Math.round(rootRect.width),
        rootHeight: Math.round(rootRect.height),
        visual: visualRect ? { width: Math.round(visualRect.width), height: Math.round(visualRect.height), top: Math.round(visualRect.top) } : null,
        copy: copyRect ? {
          width: Math.round(copyRect.width),
          height: Math.round(copyRect.height),
          top: Math.round(copyRect.top),
          left: Math.round(copyRect.left),
          position: copyStyle?.position || "",
          transform: copyStyle?.transform || "none",
          opacity: copyStyle?.opacity || "1",
          fontSize: copyStyle?.fontSize || "",
          lineHeight: copyStyle?.lineHeight || "",
        } : null,
        visualChain,
        sceneLayers,
      };
    };
    const rootStart = window.scrollY + root.getBoundingClientRect().top;
    const travel = Math.min(root.getBoundingClientRect().height * 0.82, window.innerHeight * 2.5);
    const phases = [];
    const samples = [
      { progress: -2, name: "entry-offscreen", scrollY: Math.max(0, rootStart - window.innerHeight * 2) },
      { progress: -1, name: "entry-below", scrollY: Math.max(0, rootStart - window.innerHeight) },
      { progress: -0.5, name: "entry-midpoint", scrollY: Math.max(0, rootStart - window.innerHeight * 0.5) },
      ...[0, 0.2, 0.45, 0.7, 1].map((progress) => ({
        progress,
        name: `scroll-${Math.round(progress * 100)}`,
        scrollY: rootStart + travel * progress,
      })),
    ];
    for (const sample of samples) {
      window.scrollTo(0, Math.round(sample.scrollY));
      await new Promise((resolve) => setTimeout(resolve, 260));
      phases.push({ progress: sample.progress, stage: sample.progress < 0 ? "entry" : "scene", ...snapshot(sample.name) });
    }
    const beforeScroll = phases[0];
    const afterScroll = phases[phases.length - 1];
    const buttonNodes = Array.from(root.querySelectorAll("[role='tab'], [aria-controls], [data-tab], button")).filter(visible).slice(0, 8);
    const states = [];
    for (const button of buttonNodes) {
      const label = clean(button.textContent);
      button.dispatchEvent(new MouseEvent("click", { bubbles: true, cancelable: true }));
      await new Promise((resolve) => setTimeout(resolve, 280));
      const visibleText = Array.from(root.querySelectorAll("h2,h3,p"))
        .filter(visible)
        .map((node) => clean(node.textContent))
        .filter(Boolean)
        .slice(0, 8);
      const activeTab = buttonNodes.find((node) => node.getAttribute("aria-selected") === "true" || /\bactive\b/i.test(String(node.className || "")));
      states.push({
        label,
        activeTab: clean(activeTab?.textContent || ""),
        text: visibleText,
        buttonClassName: clean(button.className || ""),
        ariaSelected: button.getAttribute("aria-selected") || "",
      });
    }
    window.scrollTo(0, 0);
    return { beforeScroll, afterScroll, phases, states };
  });
  if (!result || result.missing) return { missing: true };
  const wheelPhases = await probeWheelScrollScene(page);
  const phases = [...(result.phases || []), ...wheelPhases];
  const scrollChanges = [];
  for (const key of ["rootClassName", "visualClassName", "copyClassName", "rootTop", "rootHeight"]) {
    if (String(result.beforeScroll[key]) !== String(result.afterScroll[key])) {
      scrollChanges.push({ property: key, before: result.beforeScroll[key], after: result.afterScroll[key] });
    }
  }
  for (const key of ["visual", "copy"]) {
    if (JSON.stringify(result.beforeScroll[key]) !== JSON.stringify(result.afterScroll[key])) {
      scrollChanges.push({ property: key, before: result.beforeScroll[key], after: result.afterScroll[key] });
    }
  }
  if (JSON.stringify(result.beforeScroll.visualChain) !== JSON.stringify(result.afterScroll.visualChain)) {
    scrollChanges.push({ property: "visualChain", before: result.beforeScroll.visualChain, after: result.afterScroll.visualChain });
  }
  const uniqueStateTexts = Array.from(new Set(result.states.map((state) => state.text.join(" | "))));
  return {
    beforeScroll: result.beforeScroll,
    afterScroll: result.afterScroll,
    scrollChanges,
    states: result.states,
    uniqueStateCount: uniqueStateTexts.length,
    phases,
    invariants: deriveScrollInvariants(phases),
    screenshot: await captureSingleScreenshot(page, "[data-rp-scroll-probe='true']", screenshotsDir, "interaction-section"),
    meaningful: scrollChanges.length > 0 || uniqueStateTexts.length > 1,
  };
}

async function probeWheelScrollScene(page) {
  await page.evaluate(() => window.scrollTo(0, 0));
  await page.waitForTimeout(320);
  const meta = await page.evaluate(() => {
    const root = document.querySelector("[data-rp-scroll-probe='true']");
    if (!(root instanceof Element)) return null;
    return {
      rootStart: window.scrollY + root.getBoundingClientRect().top,
      travel: Math.max(1, root.getBoundingClientRect().height - window.innerHeight),
      viewportWidth: window.innerWidth,
      viewportHeight: window.innerHeight,
    };
  });
  if (!meta) return [];
  const frames = [await readWheelScrollFrame(page, meta, 0)];
  await page.mouse.move(Math.round(meta.viewportWidth * 0.85), Math.round(meta.viewportHeight * 0.75));
  for (let index = 1; index <= 10; index += 1) {
    await page.mouse.wheel(0, Math.round(meta.viewportHeight * 0.32));
    await page.waitForTimeout(220);
    frames.push(await readWheelScrollFrame(page, meta, index));
  }
  return frames.filter(Boolean);
}

async function readWheelScrollFrame(page, meta, index) {
  return page.evaluate(({ meta, index }) => {
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const root = document.querySelector("[data-rp-scroll-probe='true']");
    if (!(root instanceof Element)) return null;
    const visual = root.querySelector("iframe, video, canvas, img, [data-scene-visual], [data-scroll-visual]");
    const copy = root.querySelector("[data-scene-copy], [data-scroll-copy], [role='tabpanel'], h1,h2,h3") || root;
    const rootRect = root.getBoundingClientRect();
    const visualRect = visual?.getBoundingClientRect() || null;
    const copyRect = copy?.getBoundingClientRect() || null;
    const copyStyle = copy ? getComputedStyle(copy) : null;
    const visualChain = [];
    for (let node = visual; node && node !== root.parentElement && visualChain.length < 6; node = node.parentElement) {
      const style = getComputedStyle(node);
      const rect = node.getBoundingClientRect();
      visualChain.push({
        tag: node.tagName.toLowerCase(),
        className: clean(node.className || ""),
        position: style.position,
        overflow: style.overflow,
        transform: style.transform,
        opacity: style.opacity,
        clipPath: style.clipPath,
        borderRadius: style.borderRadius,
        width: Math.round(rect.width),
        height: Math.round(rect.height),
        left: Math.round(rect.left),
        top: Math.round(rect.top),
      });
      if (node === root) break;
    }
    const sceneLayers = Array.from(root.querySelectorAll("*"))
      .map((node) => ({ node, style: getComputedStyle(node), rect: node.getBoundingClientRect() }))
      .filter(({ node, style, rect }) => rect.height >= 80 && style.display !== "none" && style.visibility !== "hidden" && (/curtain|mask|overlay|scrim|scroll-over__bg|scroll-over__frame/i.test(String(node.className || "")) || ["absolute", "fixed", "sticky"].includes(style.position)))
      .slice(0, 18)
      .map(({ node, style, rect }) => ({
        tag: node.tagName.toLowerCase(),
        className: clean(node.className || ""),
        role: /curtain|mask|scrim/i.test(String(node.className || "")) ? "curtain" : /\bbg\b|background/i.test(String(node.className || "")) ? "background" : "layer",
        position: style.position,
        transform: style.transform,
        opacity: style.opacity,
        clipPath: style.clipPath,
        backgroundColor: style.backgroundColor,
        width: Math.round(rect.width),
        height: Math.round(rect.height),
        left: Math.round(rect.left),
        top: Math.round(rect.top),
      }));
    const progress = (window.scrollY - meta.rootStart) / meta.travel;
    return {
      progress: Math.round(progress * 1000) / 1000,
      stage: "wheel",
      name: `wheel-${index}`,
      scrollY: Math.round(window.scrollY),
      rootClassName: clean(root.className || ""),
      visualClassName: clean(visual?.className || ""),
      copyClassName: clean(copy?.className || ""),
      rootTop: Math.round(rootRect.top),
      rootWidth: Math.round(rootRect.width),
      rootHeight: Math.round(rootRect.height),
      visual: visualRect ? { width: Math.round(visualRect.width), height: Math.round(visualRect.height), top: Math.round(visualRect.top) } : null,
      copy: copyRect ? {
        width: Math.round(copyRect.width),
        height: Math.round(copyRect.height),
        top: Math.round(copyRect.top),
        left: Math.round(copyRect.left),
        position: copyStyle?.position || "",
        transform: copyStyle?.transform || "none",
        opacity: copyStyle?.opacity || "1",
        fontSize: copyStyle?.fontSize || "",
        lineHeight: copyStyle?.lineHeight || "",
      } : null,
      visualChain,
      sceneLayers,
    };
  }, { meta, index });
}

async function probeCarouselStates(page, screenshotsDir) {
  const candidates = await page.evaluate(() => {
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const hasActiveToken = (value) => clean(value).split(" ").some((token) => /(?:^|[-_:])(active|selected|expanded)$|^(active|selected|expanded)$/i.test(token));
    const visible = (node) => {
      if (!(node instanceof Element)) return false;
      const rect = node.getBoundingClientRect();
      const style = getComputedStyle(node);
      return rect.width >= 80 && rect.height >= 60 && style.display !== "none" && style.visibility !== "hidden";
    };
    const classSignature = (node) => clean(node.className).split(" ").filter(Boolean).slice(0, 3).join(".");
    const roots = Array.from(new Set(document.querySelectorAll(
      "[data-carousel], [aria-roledescription='carousel'], [class*='carousel'], [class*='slider'], [class*='rail'], [class*='swiper'], [class*='splide'], [class*='embla']",
    ))).filter(visible);
    const byTrack = new Map();
    for (const hintedRoot of roots.slice(0, 80)) {
      const scope = hintedRoot.closest("section,main,article,[role='region']") || hintedRoot;
      const nodes = [hintedRoot, ...Array.from(hintedRoot.querySelectorAll("*")).slice(0, 240)];
      for (const track of nodes) {
        if (!visible(track)) continue;
        const directChildren = Array.from(track.children).filter(visible);
        if (directChildren.length < 3 || directChildren.length > 40) continue;
        const signatureCounts = new Map();
        for (const child of directChildren) {
          const key = classSignature(child) || child.tagName.toLowerCase();
          signatureCounts.set(key, (signatureCounts.get(key) || 0) + 1);
        }
        const dominant = Array.from(signatureCounts.entries()).sort((left, right) => right[1] - left[1])[0];
        const items = dominant && dominant[1] >= 3
          ? directChildren.filter((child) => (classSignature(child) || child.tagName.toLowerCase()) === dominant[0])
          : directChildren;
        if (items.length < 3) continue;
        const rects = items.map((item) => item.getBoundingClientRect());
        const horizontalSpan = Math.max(...rects.map((rect) => rect.right)) - Math.min(...rects.map((rect) => rect.left));
        const verticalSpan = Math.max(...rects.map((rect) => rect.bottom)) - Math.min(...rects.map((rect) => rect.top));
        const trackRect = track.getBoundingClientRect();
        const horizontal = horizontalSpan > verticalSpan * 1.15 || horizontalSpan > trackRect.width * 1.15 || track.scrollWidth > track.clientWidth * 1.05;
        if (!horizontal) continue;
        const classText = `${clean(hintedRoot.className)} ${clean(track.className)} ${clean(scope.className)}`.toLowerCase();
        let score = items.length * 2;
        if (track.scrollWidth > track.clientWidth * 1.05) score += 35;
        if (/carousel|slider|rail|track|slides|swiper|splide|embla/.test(classText)) score += 30;
        if (getComputedStyle(track).display === "flex" || getComputedStyle(track).display === "grid") score += 15;
        if (scope.querySelectorAll("button").length >= 2) score += 12;
        const existing = byTrack.get(track);
        if (!existing || existing.score < score) byTrack.set(track, { hintedRoot, scope, track, items, score });
      }
    }
    const ranked = Array.from(byTrack.values())
      .sort((left, right) => right.score - left.score)
      .filter((candidate, index, all) => !all.slice(0, index).some((earlier) => earlier.track.contains(candidate.track) || candidate.track.contains(earlier.track)))
      .slice(0, 4);
    return ranked.map((candidate, probeIndex) => {
      candidate.scope.setAttribute("data-rp-carousel-probe", String(probeIndex));
      candidate.track.setAttribute("data-rp-carousel-track", String(probeIndex));
      candidate.items.forEach((item, itemIndex) => item.setAttribute("data-rp-carousel-item", `${probeIndex}:${itemIndex}`));
      const activeIndex = candidate.items.findIndex((item) => hasActiveToken(item.className) || item.getAttribute("aria-selected") === "true");
      const targetIndex = candidate.items.length > 1 && activeIndex !== 1 ? 1 : activeIndex !== 0 ? 0 : Math.min(2, candidate.items.length - 1);
      const controls = Array.from(candidate.scope.querySelectorAll("button,[role='button']")).slice(0, 8).map((button) => ({
        label: clean(button.getAttribute("aria-label") || button.textContent).slice(0, 100),
        classTokens: clean(button.className).split(" ").filter(Boolean).slice(0, 8),
      }));
      return {
        probeIndex,
        score: candidate.score,
        targetIndex,
        itemCount: candidate.items.length,
        scope: {
          tag: candidate.scope.tagName.toLowerCase(),
          id: candidate.scope.id || "",
          classTokens: clean(candidate.scope.className).split(" ").filter(Boolean).slice(0, 12),
          textFingerprint: clean(candidate.scope.textContent).slice(0, 180),
        },
        track: {
          classTokens: clean(candidate.track.className).split(" ").filter(Boolean).slice(0, 12),
        },
        controls,
      };
    });
  });

  const results = [];
  for (const candidate of candidates) {
    const probeIndex = candidate.probeIndex;
    const itemSelector = `[data-rp-carousel-item="${probeIndex}:${candidate.targetIndex}"]`;
    const frames = [];
    try {
      const target = page.locator(itemSelector).first();
      await target.scrollIntoViewIfNeeded();
      await page.waitForTimeout(160);
      frames.push(await readCarouselTimelineFrame(page, probeIndex, -1));
      const safeCarouselTarget = await target.evaluate((node) => {
        const anchor = node.closest("a[href]");
        const identity = `${node.getAttribute("role") || ""} ${node.className || ""} ${node.getAttribute("aria-label") || ""}`.toLowerCase();
        return !anchor && !node.closest("form") && !/cart|checkout|buy|book|delete|account/.test(identity);
      });
      if (!safeCarouselTarget) {
        results.push({
          id: `carousel-${probeIndex + 1}`,
          missing: false,
          changed: false,
          blocked: true,
          reason: "Safe probing refused a carousel item that could navigate or perform a business action.",
          scope: candidate.scope,
          target: { itemIndex: candidate.targetIndex },
          controls: candidate.controls,
        });
        continue;
      }
      await target.click({ force: true });
      let elapsed = 0;
      for (const atMs of DEFAULT_INTERACTION_TIMELINE_MS) {
        if (atMs > elapsed) await page.waitForTimeout(atMs - elapsed);
        elapsed = atMs;
        frames.push(await readCarouselTimelineFrame(page, probeIndex, atMs));
      }
      const timeline = compactInteractionTimeline(frames);
      const invariants = deriveCarouselInvariants({ frames, timeline });
      const firstItems = itemFrame(frames[0]);
      const finalItems = itemFrame(frames[frames.length - 1]);
      const changed = JSON.stringify(firstItems) !== JSON.stringify(finalItems) || timeline.changedNodeCount > 0;
      const prefix = probeIndex === 0 ? "interaction-carousel" : `interaction-carousel-${probeIndex + 1}`;
      results.push({
        id: `carousel-${probeIndex + 1}`,
        missing: false,
        changed,
        scope: candidate.scope,
        target: { itemIndex: candidate.targetIndex },
        controls: candidate.controls,
        initial: legacyCarouselState(frames[0]),
        after: legacyCarouselState(frames[frames.length - 1]),
        timeline,
        invariants,
        screenshot: await captureSingleScreenshot(page, `[data-rp-carousel-probe="${probeIndex}"]`, screenshotsDir, prefix),
      });
    } catch (error) {
      results.push({
        id: `carousel-${probeIndex + 1}`,
        missing: false,
        changed: false,
        scope: candidate.scope,
        target: { itemIndex: candidate.targetIndex },
        controls: candidate.controls,
        frames,
        error: error.message,
      });
    }
  }
  return results;
}

async function readCarouselTimelineFrame(page, probeIndex, atMs) {
  return page.evaluate(({ probeIndex, atMs }) => {
    const clean = (value) => String(value || "").replace(/\s+/g, " ").trim();
    const hasActiveToken = (value) => clean(value).split(" ").some((token) => /(?:^|[-_:])(active|selected|expanded)$|^(active|selected|expanded)$/i.test(token));
    const root = document.querySelector(`[data-rp-carousel-probe="${probeIndex}"]`);
    const track = document.querySelector(`[data-rp-carousel-track="${probeIndex}"]`);
    const items = Array.from(document.querySelectorAll(`[data-rp-carousel-item^="${probeIndex}:"]`));
    if (!(root instanceof Element) || !(track instanceof Element) || items.length < 2) return null;
    const pathWithin = (node, stop) => {
      const parts = [];
      for (let current = node; current && current !== stop && parts.length < 5; current = current.parentElement) {
        const parent = current.parentElement;
        const index = parent ? Array.from(parent.children).indexOf(current) : 0;
        parts.unshift(`${current.tagName.toLowerCase()}:${index}`);
      }
      return parts.join("/");
    };
    const snapshot = (node, path, role) => {
      const rect = node.getBoundingClientRect();
      const style = getComputedStyle(node);
      const className = clean(node.className);
      return {
        path,
        role,
        text: clean(node.textContent).slice(0, 160),
        className,
        active: className.split(/\s+/).some((token) => /(?:^|[-_:])(active|selected|expanded)$|^(active|selected|expanded)$/i.test(token)),
        ariaSelected: node.getAttribute("aria-selected") || "",
        ariaExpanded: node.getAttribute("aria-expanded") || "",
        hidden: node.hasAttribute("hidden"),
        rect: {
          left: Math.round(rect.left * 100) / 100,
          top: Math.round(rect.top * 100) / 100,
          width: Math.round(rect.width * 100) / 100,
          height: Math.round(rect.height * 100) / 100,
        },
        display: style.display,
        visibility: style.visibility,
        opacity: style.opacity,
        transform: style.transform,
        width: style.width,
        height: style.height,
        flexBasis: style.flexBasis,
        gridTemplateColumns: style.gridTemplateColumns,
        overflow: style.overflow,
        clipPath: style.clipPath,
        gap: style.gap,
        rowGap: style.rowGap,
        columnGap: style.columnGap,
        marginLeft: style.marginLeft,
        marginRight: style.marginRight,
        paddingLeft: style.paddingLeft,
        paddingRight: style.paddingRight,
        borderLeftWidth: style.borderLeftWidth,
        borderRightWidth: style.borderRightWidth,
        borderLeftColor: style.borderLeftColor,
        borderRightColor: style.borderRightColor,
        transitionProperty: style.transitionProperty,
        transitionDuration: style.transitionDuration,
        transitionTimingFunction: style.transitionTimingFunction,
        clientWidth: node.clientWidth,
        scrollWidth: node.scrollWidth,
      };
    };
    const nodes = [snapshot(root, "scope", "scope"), snapshot(track, "track", "track")];
    items.slice(0, 12).forEach((item, index) => nodes.push(snapshot(item, `item:${index}`, "item")));
    const activeOrTarget = items.find((item) => hasActiveToken(item.className)) || items[0];
    const descendants = Array.from(activeOrTarget.querySelectorAll("*")).filter((node) => {
      const rect = node.getBoundingClientRect();
      const style = getComputedStyle(node);
      const className = clean(node.className);
      return rect.width > 0 && rect.height > 0 && style.display !== "none" && (className || node.matches("img,picture,video,iframe,button,a,[aria-hidden],[aria-expanded]"));
    }).slice(0, 48);
    descendants.forEach((node) => nodes.push(snapshot(node, `active/${pathWithin(node, activeOrTarget)}`, "active-descendant")));
    const animations = typeof document.getAnimations === "function"
      ? document.getAnimations().filter((animation) => {
        const target = animation.effect?.target;
        return target instanceof Node && root.contains(target);
      }).slice(0, 24).map((animation) => {
        const target = animation.effect?.target;
        const timing = animation.effect?.getTiming?.() || {};
        return {
          path: target instanceof Element ? pathWithin(target, root) : "",
          name: animation.animationName || "",
          playState: animation.playState,
          currentTime: Math.round(Number(animation.currentTime) || 0),
          duration: timing.duration,
          delay: timing.delay,
          easing: timing.easing,
          fill: timing.fill,
        };
      })
      : [];
    return { atMs, nodes, animations };
  }, { probeIndex, atMs });
}

function itemFrame(frame) {
  return (frame?.nodes || []).filter((node) => node.role === "item").map((node) => ({
    className: node.className,
    rect: node.rect,
    ariaSelected: node.ariaSelected,
    ariaExpanded: node.ariaExpanded,
  }));
}

function legacyCarouselState(frame) {
  const track = frame?.nodes?.find((node) => node.role === "track");
  return {
    clientWidth: track?.clientWidth || 0,
    scrollWidth: track?.scrollWidth || 0,
    cards: (frame?.nodes || []).filter((node) => node.role === "item").map((node, index) => ({
      index,
      className: node.className,
      width: node.rect?.width || 0,
      height: node.rect?.height || 0,
      left: node.rect?.left || 0,
    })),
  };
}

async function captureStateScreenshots(page, selector, screenshotsDir, prefix, moveToState) {
  let initial = null;
  let scrolled = null;
  try {
    initial = path.join(screenshotsDir, `${prefix}-initial.png`);
    await page.locator(selector).first().screenshot({ path: initial });
    await moveToState();
    await page.waitForTimeout(400);
    scrolled = path.join(screenshotsDir, `${prefix}-scrolled.png`);
    await page.locator(selector).first().screenshot({ path: scrolled });
    await page.evaluate(() => window.scrollTo(0, 0));
    await page.waitForTimeout(120);
  } catch {
    // Best effort only.
  }
  return { initial, scrolled };
}

async function captureSingleScreenshot(page, selector, screenshotsDir, prefix) {
  try {
    await page.locator(selector).first().scrollIntoViewIfNeeded();
    await page.waitForTimeout(120);
    const screenshot = path.join(screenshotsDir, `${prefix}.png`);
    await page.locator(selector).first().screenshot({ path: screenshot });
    return screenshot;
  } catch {
    return null;
  }
}

function deriveSpecializedCaptures(specialized) {
  const captures = [];
  if (specialized.headerScroll?.meaningful) {
    captures.push({
      id: "header-scroll",
      kind: "sticky-transform",
      label: "Header scroll state",
      tag: "header",
      trigger: "scroll",
      sources: ["specialized:header-scroll"],
      meaningful: true,
      before: specialized.headerScroll.initial,
      after: specialized.headerScroll.scrolled,
      diff: {
        changedProperties: specialized.headerScroll.changedProperties,
        textChanged: false,
        attributeChanges: [],
      },
      liveAnimations: [],
      screenshot: specialized.headerScroll.screenshot?.scrolled || specialized.headerScroll.screenshot?.initial || null,
    });
  }
  if (specialized.scrollTabs?.meaningful) {
    if (specialized.scrollTabs.scrollChanges.length) {
      captures.push({
        id: "section-scroll-state",
        kind: "scroll-state",
        label: "Section scroll-expanded state",
        tag: "section",
        trigger: "scroll",
        sources: ["specialized:scroll-scene"],
        meaningful: true,
        before: specialized.scrollTabs.beforeScroll,
        after: specialized.scrollTabs.afterScroll,
        diff: {
          changedProperties: specialized.scrollTabs.scrollChanges,
          textChanged: false,
          attributeChanges: [],
        },
        liveAnimations: [],
        screenshot: specialized.scrollTabs.screenshot || null,
        states: specialized.scrollTabs.phases || [],
        invariants: specialized.scrollTabs.invariants || {},
      });
    }
    for (const state of specialized.scrollTabs.states.slice(0, 4)) {
      captures.push({
        id: `tab-${slugify(state.label)}`,
        kind: "tabs",
        label: state.label,
        tag: "button",
        trigger: "click",
        sources: ["specialized:scroll-scene-tabs"],
        meaningful: true,
        before: null,
        after: {
          ariaSelected: state.ariaSelected,
          activeTab: state.activeTab,
          text: state.text.join(" | "),
        },
        diff: {
          changedProperties: [],
          textChanged: specialized.scrollTabs.uniqueStateCount > 1,
          attributeChanges: state.ariaSelected ? [{ property: "ariaSelected", before: "false", after: state.ariaSelected }] : [],
        },
        liveAnimations: [],
        screenshot: specialized.scrollTabs.screenshot || null,
      });
    }
  }
  const carouselStates = specialized.carousels?.length ? specialized.carousels : specialized.carousel ? [specialized.carousel] : [];
  for (const carousel of carouselStates.filter((item) => item?.changed)) {
    captures.push({
      id: `${carousel.id || "carousel"}-card-expansion`,
      kind: "carousel",
      label: "Carousel card expansion and horizontal rail",
      tag: "section",
      trigger: "click",
      sources: ["specialized:carousel-state"],
      meaningful: true,
      before: carousel.initial,
      after: carousel.after,
      diff: { changedProperties: [{ property: "cardGeometry", before: carousel.initial.cards, after: carousel.after.cards }], textChanged: false, attributeChanges: [] },
      liveAnimations: [],
      screenshot: carousel.screenshot || null,
      scope: carousel.scope,
      timeline: carousel.timeline,
      invariants: carousel.invariants,
    });
  }
  for (const media of specialized.media || []) {
    captures.push({
      id: media.id,
      kind: "embedded-media",
      label: `${media.role} ${media.provider || media.tag} media`,
      tag: media.tag,
      trigger: "load",
      sources: ["structural:media"],
      meaningful: true,
      after: media,
      diff: { changedProperties: [], textChanged: false, attributeChanges: [] },
      liveAnimations: [],
      screenshot: null,
      scope: {
        tag: "section",
        classTokens: media.domRef?.sectionClassTokens || [],
        textFingerprint: media.domRef?.sectionTextFingerprint || "",
      },
    });
  }
  return captures;
}

function enrichPageRecord(page, experiment) {
  const allCaptures = [...experiment.runtime.captures, ...(experiment.runtime.specializedCaptures || [])];
  const captures = allCaptures.map((capture) => ({
    id: capture.id || "",
    kind: classifyCapture(capture),
    label: capture.label,
    trigger: capture.trigger,
    sources: capture.sources,
    changedProperties: (capture.diff?.changedProperties || []).map((item) => item.property),
    textChanged: Boolean(capture.diff?.textChanged),
    screenshot: capture.screenshot,
    importance: classifyImportance(capture),
    ...(capture.scope ? { scope: capture.scope } : {}),
  }));
  const sectionInteractions = (page.sections || []).map((section) => {
    const heading = String(section.heading || "").toLowerCase();
    const className = `${section.className || ""} ${(section.domRef?.classTokens || []).join(" ")}`.toLowerCase();
    const relevant = captures.filter((capture) => {
      const label = String(capture.label || "").toLowerCase();
      if (capture.scope && scopeMatchesSection(capture.scope, section)) return true;
      if (!capture.scope && (className.includes("hero-video") || section.kind === "hero") && capture.kind === "embedded-media") return true;
      if (/carousel|slider|rail|gallery/.test(className) && (capture.kind === "hover-card" || capture.kind === "carousel-control" || capture.kind === "carousel")) return true;
      if (/scroll|scene|sticky|pinned/.test(className)) {
        return capture.kind === "tabs" || capture.kind === "sticky-transform" || capture.kind === "scroll-state";
      }
      return label && heading && label.includes(heading.slice(0, 12));
    });
    return {
      sectionId: section.id,
      interactions: dedupeSectionInteractions(relevant).slice(0, 12),
    };
  });
  return {
    ...page,
    interactionDiscovery: {
      generatedAt: experiment.generatedAt,
      staticSummary: experiment.staticInventory.summary,
      runtimeSummary: experiment.runtime.summary,
      captures,
      sectionInteractions,
      structural: experiment.runtime.structural,
      media: experiment.runtime.structural.media || [],
      specialized: summarizeSpecializedRuntime(experiment.runtime.specialized),
      requiredBehaviors: [
        experiment.runtime.structural.embedCount ? "preserve-embedded-media" : null,
        experiment.runtime.structural.tabLabels.length ? "preserve-content-switching-tabs" : null,
        experiment.runtime.specialized?.headerScroll?.meaningful ? "preserve-header-scroll-state" : null,
        experiment.runtime.specialized?.scrollTabs?.scrollChanges?.length ? "preserve-scroll-expanded-section-state" : null,
        (experiment.runtime.specialized?.carousels || [experiment.runtime.specialized?.carousel]).some((carousel) => carousel?.changed) ? "preserve-carousel-card-expansion" : null,
      ].filter(Boolean),
    },
  };
}

function summarizeSpecializedRuntime(specialized = {}) {
  return {
    headerScroll: specialized.headerScroll ? {
      meaningful: Boolean(specialized.headerScroll.meaningful),
      changedProperties: specialized.headerScroll.changedProperties || [],
      screenshot: specialized.headerScroll.screenshot || null,
    } : { missing: true },
    scrollTabs: specialized.scrollTabs ? {
      meaningful: Boolean(specialized.scrollTabs.meaningful),
      uniqueStateCount: specialized.scrollTabs.uniqueStateCount || 0,
      phaseCount: specialized.scrollTabs.phases?.length || 0,
      invariants: specialized.scrollTabs.invariants || {},
      screenshot: specialized.scrollTabs.screenshot || null,
    } : { missing: true },
    carousels: (specialized.carousels || []).map((carousel) => ({
      id: carousel.id,
      changed: Boolean(carousel.changed),
      scope: carousel.scope,
      invariants: carousel.invariants,
      screenshot: carousel.screenshot || null,
      ...(carousel.error ? { error: carousel.error } : {}),
    })),
  };
}

function scopeMatchesSection(scope, section) {
  const identityToken = (token) => {
    const value = String(token || "").toLowerCase();
    return value && !/^(relative|absolute|fixed|sticky|static|block|inline|flex|grid|container|hidden|visible|w-|h-|min-|max-|p[trblxy]?-|m[trblxy]?-|bg-|text-|font-|z-|overflow|object-|top-|left-|right-|bottom-|translate-|scale-|rotate-|opacity-|rounded-|border-|shadow-|transition|duration-|ease-|sm:|md:|lg:|xl:|2xl:)/.test(value);
  };
  const scopeTokens = new Set((scope.classTokens || []).map((token) => String(token).toLowerCase()).filter(identityToken));
  const sectionTokens = [
    section.className,
    ...(section.domRef?.classTokens || []),
  ].flatMap((value) => String(value || "").toLowerCase().split(/\s+/)).filter(identityToken);
  if (sectionTokens.some((token) => scopeTokens.has(token))) return true;
  const scopeText = String(scope.textFingerprint || "").toLowerCase();
  const heading = String(section.heading || "").toLowerCase().trim();
  return Boolean(heading.length >= 8 && scopeText.includes(heading.slice(0, 32)));
}

export function bindInteractionsToSections(interactions, pages) {
  for (const interaction of interactions) {
    const sectionIds = [];
    for (const page of pages || []) {
      for (const entry of page.interactionDiscovery?.sectionInteractions || []) {
        const matched = (entry.interactions || []).some((summary) => {
          if (summary.id) return summary.id === interaction.id;
          return summary.kind === interaction.kind &&
            summary.label === interaction.label &&
            normalizeTrigger(summary.trigger).type === normalizeTrigger(interaction.trigger).type;
        });
        if (matched) sectionIds.push(entry.sectionId);
      }
    }
    interaction.sectionIds = Array.from(new Set(sectionIds));
  }
}

function dedupeSectionInteractions(items) {
  const seen = new Set();
  return items.filter((item) => {
    const key = `${item.kind}\u0000${item.label}\u0000${item.trigger}`;
    if (seen.has(key)) return false;
    seen.add(key);
    return true;
  });
}

function classifyCapture(capture) {
  if (capture.kind) return capture.kind;
  const label = `${capture.label || ""} ${capture.sources?.join(" ") || ""}`.toLowerCase();
  if (capture.tag === "iframe" || capture.tag === "video") return "embedded-media";
  if (capture.tag === "summary" || capture.tag === "details" || capture.before?.ariaExpanded || capture.after?.ariaExpanded || label.includes("accordion") || label.includes("disclosure")) return "accordion";
  if (capture.controlRole) return "control-state";
  if (label.includes("tab") || label.includes(".panel__btn") || capture.after?.ariaSelected) return "tabs";
  if (capture.kind === "carousel" || capture.sources?.some((source) => source.includes("carousel-state"))) return "carousel";
  if (label.includes("story-card") || label.includes("carousel")) return "hover-card";
  if (label.includes("header") || capture.sources?.some((source) => source.includes("header a"))) return "sticky-transform";
  if (label.includes("button") || label.includes("next") || label.includes("prev")) return "carousel-control";
  return "micro-interaction";
}

function classifyImportance(capture) {
  const kind = classifyCapture(capture);
  if (kind === "tabs" || kind === "accordion" || kind === "embedded-media" || kind === "sticky-transform" || kind === "scroll-state" || kind === "carousel") return "core";
  if (kind === "hover-card" || kind === "carousel-control") return "supportive";
  if (kind === "control-state") return "supportive";
  return "decorative";
}

function normalizeTrigger(trigger) {
  return typeof trigger === "string" ? { type: trigger } : trigger || { type: "unknown" };
}

function summarizeStates(capture) {
  if (Array.isArray(capture.states) && capture.states.length) return capture.states;
  if (capture.controlRole && (capture.before || capture.after)) {
    const properties = (capture.diff?.changedProperties || []).map((item) => item.property);
    return [
      capture.before ? compactControlSnapshot(capture.before, properties, { includeBase: true }) : null,
      capture.after ? compactControlSnapshot(capture.after, properties) : null,
    ].filter(Boolean);
  }
  if (capture.before || capture.after) return [capture.before, capture.after].filter(Boolean);
  return [];
}

function compactControlSnapshot(snapshot, properties, { includeBase = false } = {}) {
  const baseKeys = [
    "color", "backgroundColor", "borderColor", "borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth",
    "textDecorationLine", "textDecorationColor", "textDecorationThickness", "textUnderlineOffset",
    "outlineColor", "outlineStyle", "outlineWidth", "outlineOffset", "cursor",
    "transitionProperty", "transitionDuration", "transitionTimingFunction",
  ];
  const targetKeys = new Set(includeBase ? baseKeys : []);
  const pseudoKeys = { before: new Set(), after: new Set() };
  const childKeys = new Map();
  for (const property of properties || []) {
    const child = String(property).match(/^child:(.+?)(?:::(before|after))?\.([^.]+)$/);
    if (child) {
      const record = childKeys.get(child[1]) || { styles: new Set(), before: new Set(), after: new Set() };
      (child[2] ? record[child[2]] : record.styles).add(child[3]);
      childKeys.set(child[1], record);
      continue;
    }
    const pseudo = String(property).match(/^::(before|after)\.([^.]+)$/);
    if (pseudo) {
      pseudoKeys[pseudo[1]].add(pseudo[2]);
      continue;
    }
    if (snapshot.styles && property in snapshot.styles) targetKeys.add(property);
  }
  if (includeBase) {
    const timingKeys = ["transitionProperty", "transitionDuration", "transitionTimingFunction"];
    for (const fields of childKeys.values()) timingKeys.forEach((key) => fields.styles.add(key));
    for (const pseudo of ["before", "after"]) {
      if (pseudoKeys[pseudo].size) timingKeys.forEach((key) => pseudoKeys[pseudo].add(key));
    }
  }
  const pick = (source, keys) => Object.fromEntries(Array.from(keys).map((key) => [key, source?.[key]]));
  return {
    styles: pick(snapshot.styles, targetKeys),
    pseudo: {
      before: pick(snapshot.pseudo?.before, pseudoKeys.before),
      after: pick(snapshot.pseudo?.after, pseudoKeys.after),
    },
    visualChildren: Array.from(childKeys.entries()).map(([key, fields]) => {
      const child = (snapshot.visualChildren || []).find((item) => item.key === key) || {};
      return {
        key,
        styles: pick(child.styles, fields.styles),
        pseudo: { before: pick(child.pseudo?.before, fields.before), after: pick(child.pseudo?.after, fields.after) },
      };
    }),
    className: snapshot.className || "",
    ariaSelected: snapshot.ariaSelected || "",
    ariaExpanded: snapshot.ariaExpanded || "",
    ariaCurrent: snapshot.ariaCurrent || "",
    ariaPressed: snapshot.ariaPressed || "",
    disabled: Boolean(snapshot.disabled),
  };
}

function implementationHintFor(capture) {
  const kind = classifyCapture(capture);
  if (kind === "sticky-transform") return "Preserve the source shared-chrome scroll state rather than collapsing it to one static header.";
  if (kind === "tabs") return "Implement as an explicit content switcher keyed to the visible tab labels.";
  if (kind === "accordion") return "Build a CMS-backed accordion repeater; preserve every closed panel's complete structure, the captured initial expansion, and the observed single/multiple-open behavior.";
  if (kind === "scroll-state") return "Preserve the source section's scroll-driven visual and copy relationship rather than flattening it into a static block.";
  if (kind === "carousel") return "Implement an overflowing horizontal rail with the captured active-card expansion and controls; do not flatten it into a grid.";
  if (kind === "embedded-media") return "Keep the media interactive instead of replacing it with a static poster image.";
  if (kind === "hover-card" || kind === "carousel-control") return "Preserve the hover/control affordance closely enough to maintain scanability and emphasis.";
  if (kind === "control-state") return "Reproduce the captured state delta on its owning target, pseudo-element, or nested icon; preserve focus visibility and source timing.";
  return "Preserve this behavior when it materially affects comprehension, navigation, or brand feel.";
}

function slugify(value) {
  return String(value || "interaction")
    .toLowerCase()
    .replace(/[^a-z0-9]+/g, "-")
    .replace(/^-+|-+$/g, "") || "interaction";
}

function safePageName(page) {
  return `${page.area}-${String(page.path || "home").replace(/[^a-z0-9]+/gi, "-").replace(/^-+|-+$/g, "") || "home"}`;
}

if (import.meta.url === `file://${process.argv[1]}`) {
  main().catch((error) => {
    console.error(error.stack || error.message);
    process.exit(1);
  });
}