@active-reach/web-sdk 1.9.0 → 1.11.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { S as Storage, l as logger, A as Aegis } from "./analytics-Cc4-QQBf.mjs";
-import { B, E, N, R, m } from "./analytics-Cc4-QQBf.mjs";
+import { S as Storage, l as logger, A as Aegis } from "./analytics-6PR9ERDS.mjs";
+import { B, E, N, R, m } from "./analytics-6PR9ERDS.mjs";
 import { AegisWebPush } from "./push/AegisWebPush.js";
 function debounce(func, wait) {
   let timeoutId = null;
@@ -755,6 +755,7 @@ const _AegisInAppManager = class _AegisInAppManager {
     this.ready = new Promise((resolve) => {
       this.readyResolve = resolve;
     });
+    this.filledSlots = /* @__PURE__ */ new WeakSet();
     this.writeKey = config.writeKey;
     this.apiHost = config.apiHost || "https://api.aegis.ai";
     this.userId = config.userId ?? readAnonIdFromStorage$1();
@@ -1099,6 +1100,8 @@ const _AegisInAppManager = class _AegisInAppManager {
       this.emit("campaigns-loaded", this.campaigns);
       this.readyResolve();
       this.tryDisplayNextCampaign();
+      this.renderIntoSlots();
+      this.renderTokenAnchors();
     } catch (error) {
       this.emitError(error, { stage: "refresh-campaigns" });
       this.log(`Error refreshing campaigns: ${error}`, "error");
@@ -1147,6 +1150,344 @@ const _AegisInAppManager = class _AegisInAppManager {
       this.displayCampaign(campaign);
     }
   }
+  /**
+   * Scan the page for `[data-aegis-slot]` anchors and render any
+   * campaign whose `widget_category` matches the slot key AND whose
+   * `delivery_modes` includes `'embedded_card'`.
+   *
+   * Runs after every refresh-campaigns success — the WeakSet guard
+   * keeps it idempotent across re-fetches. The slot key is the campaign's
+   * `widget_category` (the wide grouping discriminator from F3), so a
+   * `<div data-aegis-slot="feedback">` will accept the first active
+   * campaign with `widget_category='feedback'` + embedded_card mode.
+   */
+  renderIntoSlots() {
+    if (typeof document === "undefined") return;
+    const slots = document.querySelectorAll("[data-aegis-slot]");
+    if (slots.length === 0) return;
+    const eligibleByCategory = /* @__PURE__ */ new Map();
+    for (const c of this.campaigns) {
+      const modes = c.delivery_modes;
+      const category = c.widget_category;
+      if (!modes || !modes.includes("embedded_card")) continue;
+      if (!category) continue;
+      if (!eligibleByCategory.has(category)) {
+        eligibleByCategory.set(category, c);
+      }
+    }
+    if (eligibleByCategory.size === 0) return;
+    slots.forEach((slot) => {
+      if (this.filledSlots.has(slot)) return;
+      const key = slot.getAttribute("data-aegis-slot");
+      if (!key) return;
+      const campaign = eligibleByCategory.get(key);
+      if (!campaign) return;
+      this.renderCampaignIntoSlot(campaign, slot);
+      this.filledSlots.add(slot);
+    });
+  }
+  /**
+   * U7 — render server-injected token-bound campaigns.
+   *
+   * The standalone-page route at `apps/cashier-portal/src/app/s/[slug]/
+   * [workspace]/[page_key]/page.tsx` (and the `/c/[token]` Aegis-hosted
+   * fallback) verify the URL token server-side via the F16 internal
+   * endpoint, then embed the resolved campaign payload as JSON inside
+   * a `<div data-aegis-token-data="...">` anchor. This SDK method
+   * scans for those anchors, parses the payload, and dispatches to
+   * the SAME `renderCampaignIntoSlot` used by the [data-aegis-slot]
+   * path — so widget rendering code is single-sourced.
+   *
+   * Why server-injected (not client-fetched): keeps INTERNAL_API_SECRET
+   * server-side, avoids an extra browser round-trip for verify, gives
+   * Next.js SSR-friendly initial HTML for SEO/no-JS users (rendered
+   * via the page handler's React tree alongside the SDK anchor).
+   *
+   * Idempotency: filledSlots is the same WeakSet used by
+   * renderIntoSlots — re-running on SSE/poll refresh is a no-op for
+   * already-filled anchors.
+   */
+  renderTokenAnchors() {
+    if (typeof document === "undefined") return;
+    const anchors = document.querySelectorAll("[data-aegis-token-data]");
+    if (anchors.length === 0) return;
+    anchors.forEach((anchor) => {
+      if (this.filledSlots.has(anchor)) return;
+      const raw = anchor.getAttribute("data-aegis-token-data");
+      if (!raw) return;
+      let payload = null;
+      try {
+        payload = JSON.parse(raw);
+      } catch (e) {
+        this.log(
+          `data-aegis-token-data: invalid JSON, skipping anchor (${e})`,
+          "warn"
+        );
+        this.filledSlots.add(anchor);
+        return;
+      }
+      if (!payload || !payload.campaign || !payload.campaign.id) {
+        this.log(
+          "data-aegis-token-data: missing `campaign` in payload, skipping",
+          "warn"
+        );
+        this.filledSlots.add(anchor);
+        return;
+      }
+      this.renderCampaignIntoSlot(
+        payload.campaign,
+        anchor,
+        { submitUrl: payload.submit_url }
+      );
+      this.filledSlots.add(anchor);
+    });
+  }
+  /**
+   * Slot-mode counterpart to `displayCampaign`. Reuses the existing
+   * lifecycle hooks (`campaign-will-show`, `displayedCampaigns`,
+   * `campaign-shown`, impression tracking) so analytics + frequency
+   * caps work the same way as overlay renders.
+   *
+   * Only the sub_types that make UX sense embedded are handled; the
+   * rest (modal, full_screen, half_interstitial, alert, pip) silently
+   * skip — those types only make sense as fullscreen overlays.
+   */
+  renderCampaignIntoSlot(campaign, target, options) {
+    const proceed = this.emit("campaign-will-show", campaign);
+    if (!proceed) {
+      this.log(
+        `slot campaign ${campaign.id} suppressed by campaign-will-show handler`
+      );
+      return;
+    }
+    this.displayedCampaigns.add(campaign.id);
+    this.addAnimationStyles();
+    const ic = campaign.interactive_config || {};
+    const bg = this.sanitizeColor(campaign.background_color || "#4169e1");
+    const text = this.sanitizeColor(campaign.text_color || "#ffffff");
+    const submitUrl = options == null ? void 0 : options.submitUrl;
+    let rendered = false;
+    switch (campaign.sub_type) {
+      case "star_rating":
+        rendered = this.renderStarRatingSlot(
+          campaign,
+          ic,
+          bg,
+          text,
+          target,
+          submitUrl
+        );
+        break;
+      case "nps_survey":
+        rendered = this.renderNPSSurveySlot(
+          campaign,
+          ic,
+          bg,
+          text,
+          target,
+          submitUrl
+        );
+        break;
+      // Future sub_types (quick_poll, countdown_offer, quiz, sticky_bar,
+      // progress_bar, carousel_cards, product_recommendation) get added
+      // here as merchants need them embedded. Until then, fall through
+      // to the warn below — campaigns will still render as overlays via
+      // the parallel `tryDisplayNextCampaign` path.
+      default:
+        this.log(
+          `slot mode not yet supported for sub_type: ${campaign.sub_type ?? campaign.type}`,
+          "warn"
+        );
+        this.displayedCampaigns.delete(campaign.id);
+        return;
+    }
+    if (!rendered) return;
+    this.trackEvent(campaign.id, "impression");
+    this.emit("campaign-shown", campaign);
+  }
+  /**
+   * Slot-mode wrappers. They build a small card container (no overlay
+   * positioning, no close button) and append the SHARED body element
+   * the overlay path also uses. Body construction lives in the
+   * `_buildXxxBody` helpers below so visual output stays identical
+   * between overlay and slot modes — adding a renderer feature in
+   * one place updates both.
+   */
+  renderStarRatingSlot(campaign, ic, bg, text, target, submitUrl) {
+    const card = this._wrapInSlotCard(
+      "aegis-in-app-rating-card",
+      campaign.id,
+      bg,
+      text
+    );
+    card.appendChild(
+      this._buildStarRatingBody(campaign, ic, text, "slot", submitUrl)
+    );
+    target.appendChild(card);
+    return true;
+  }
+  renderNPSSurveySlot(campaign, ic, bg, text, target, submitUrl) {
+    const card = this._wrapInSlotCard(
+      "aegis-in-app-nps-card",
+      campaign.id,
+      bg,
+      text
+    );
+    card.appendChild(
+      this._buildNPSSurveyBody(campaign, ic, text, "slot", submitUrl)
+    );
+    target.appendChild(card);
+    return true;
+  }
+  /**
+   * Token-bound submission helper. POSTs the structured response to
+   * the per-token submit URL the page handler embedded. Best-effort
+   * — failure is logged but doesn't throw (the customer already
+   * clicked; we can't undo their interaction).
+   */
+  _submitTokenResponse(submitUrl, payload) {
+    if (!submitUrl) return;
+    fetch(submitUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ response: payload }),
+      keepalive: true
+    }).catch((err) => {
+      this.log(`token submit failed: ${err}`, "warn");
+    });
+  }
+  // --- Shared body builders (used by both overlay + slot paths) ----------
+  //
+  // Sizing: `'overlay'` matches the legacy fullscreen-modal scale (24px
+  // padding, 18px title, 32px stars). `'slot'` is the embedded card
+  // scale (20px padding, 16px title, 28px stars) — proportional, doesn't
+  // dwarf merchant page chrome. Adding a new variant means a new tuple
+  // here, not a new renderer.
+  _wrapInSlotCard(className, campaignId, bg, text) {
+    const card = document.createElement("div");
+    card.className = className;
+    card.setAttribute("data-campaign-id", campaignId);
+    card.style.cssText = `
+      width: 100%; border-radius: 12px; overflow: hidden;
+      background: ${bg}; color: ${text};
+      box-shadow: 0 4px 12px rgba(0,0,0,0.06);
+    `;
+    return card;
+  }
+  _buildStarRatingBody(campaign, ic, text, variant, submitUrl) {
+    const isOverlay = variant === "overlay";
+    const padding = isOverlay ? "24px" : "20px";
+    const titleSize = isOverlay ? "18px" : "16px";
+    const titleWeight = isOverlay ? "700" : "600";
+    const titleMargin = isOverlay ? "16px" : "12px";
+    const starSize = isOverlay ? "32px" : "28px";
+    const starsMarginBottom = isOverlay ? "16px" : "0";
+    const hoverScale = isOverlay ? "1.2" : "1.15";
+    const body = document.createElement("div");
+    body.style.cssText = `padding: ${padding}; text-align: center;`;
+    const title = document.createElement("div");
+    title.style.cssText = `font-size: ${titleSize}; font-weight: ${titleWeight}; margin-bottom: ${titleMargin};`;
+    title.textContent = campaign.title || "Rate your experience";
+    body.appendChild(title);
+    const stars = document.createElement("div");
+    stars.style.cssText = `display: flex; gap: 8px; justify-content: center;` + (starsMarginBottom !== "0" ? ` margin-bottom: ${starsMarginBottom};` : "");
+    const maxStars = ic.rating_scale || 5;
+    for (let i = 1; i <= maxStars; i++) {
+      const star = document.createElement("span");
+      star.style.cssText = `font-size: ${starSize}; cursor: pointer; transition: transform 0.1s; user-select: none;` + (text ? ` color: ${text};` : "");
+      star.textContent = "☆";
+      const value = i;
+      star.addEventListener("click", () => {
+        this.trackEvent(campaign.id, "clicked");
+        if (submitUrl) {
+          this._submitTokenResponse(submitUrl, {
+            sub_type: "star_rating",
+            value
+          });
+        }
+      });
+      star.addEventListener("mouseenter", () => {
+        star.style.transform = `scale(${hoverScale})`;
+      });
+      star.addEventListener("mouseleave", () => {
+        star.style.transform = "scale(1)";
+      });
+      stars.appendChild(star);
+    }
+    body.appendChild(stars);
+    return body;
+  }
+  _buildNPSSurveyBody(campaign, ic, text, variant, submitUrl) {
+    const isOverlay = variant === "overlay";
+    const padding = isOverlay ? "24px" : "20px";
+    const titleAlign = isOverlay ? "center" : "center";
+    const body = document.createElement("div");
+    body.style.cssText = `padding: ${padding};` + (isOverlay ? " text-align: center;" : "");
+    const title = document.createElement("div");
+    title.style.cssText = `font-size: 16px; font-weight: ${isOverlay ? "700" : "600"}; margin-bottom: ${isOverlay ? "16px" : "12px"}; text-align: ${titleAlign};`;
+    title.textContent = ic.nps_question || campaign.title || "How likely are you to recommend us?";
+    body.appendChild(title);
+    if (isOverlay) {
+      const scale = document.createElement("div");
+      scale.style.cssText = "display: flex; gap: 4px; justify-content: center; flex-wrap: wrap; margin-bottom: 12px;";
+      for (let i = 0; i <= 10; i++) {
+        const btn = document.createElement("span");
+        btn.style.cssText = `
+          width: 28px; height: 28px; border-radius: 6px; display: flex;
+          align-items: center; justify-content: center; font-size: 11px;
+          font-weight: 600; cursor: pointer; background: ${text}33; color: ${text};
+          transition: transform 0.1s;
+        `;
+        btn.textContent = String(i);
+        const value = i;
+        btn.addEventListener("click", () => {
+          this.trackEvent(campaign.id, "clicked");
+          if (submitUrl) {
+            this._submitTokenResponse(submitUrl, {
+              sub_type: "nps_survey",
+              value
+            });
+          }
+        });
+        scale.appendChild(btn);
+      }
+      body.appendChild(scale);
+      const labels = document.createElement("div");
+      labels.style.cssText = "display: flex; justify-content: space-between; font-size: 11px; opacity: 0.6; margin-bottom: 16px;";
+      const notLikely = document.createElement("span");
+      notLikely.textContent = "Not likely";
+      const veryLikely = document.createElement("span");
+      veryLikely.textContent = "Very likely";
+      labels.appendChild(notLikely);
+      labels.appendChild(veryLikely);
+      body.appendChild(labels);
+      return body;
+    }
+    const grid = document.createElement("div");
+    grid.style.cssText = "display: grid; grid-template-columns: repeat(11, 1fr); gap: 4px;";
+    for (let n = 0; n <= 10; n++) {
+      const btn = document.createElement("button");
+      btn.style.cssText = `
+        padding: 8px 0; border-radius: 6px; border: 1px solid ${text}33;
+        background: transparent; color: ${text}; font-size: 13px; font-weight: 600;
+        cursor: pointer; transition: background 0.15s;
+      `;
+      btn.textContent = String(n);
+      const value = n;
+      btn.addEventListener("click", () => {
+        this.trackEvent(campaign.id, "clicked");
+        if (submitUrl) {
+          this._submitTokenResponse(submitUrl, {
+            sub_type: "nps_survey",
+            value
+          });
+        }
+      });
+      grid.appendChild(btn);
+    }
+    body.appendChild(grid);
+    return body;
+  }
   /**
    * Evaluate the currently armed campaigns against a client-side event
    * and render any that match their `client_trigger`.
@@ -1338,38 +1679,7 @@ const _AegisInAppManager = class _AegisInAppManager {
       background: ${bg}; color: ${text}; animation: aegisScaleIn 0.3s ease;
       box-shadow: 0 20px 60px rgba(0,0,0,0.15);
     `;
-    const body = document.createElement("div");
-    body.style.cssText = "padding: 24px; text-align: center;";
-    const question = document.createElement("div");
-    question.style.cssText = "font-size: 16px; font-weight: 700; margin-bottom: 16px;";
-    question.textContent = ic.nps_question || "How likely are you to recommend us?";
-    body.appendChild(question);
-    const scale = document.createElement("div");
-    scale.style.cssText = "display: flex; gap: 4px; justify-content: center; flex-wrap: wrap; margin-bottom: 12px;";
-    for (let i = 0; i <= 10; i++) {
-      const btn = document.createElement("span");
-      btn.style.cssText = `
-        width: 28px; height: 28px; border-radius: 6px; display: flex;
-        align-items: center; justify-content: center; font-size: 11px;
-        font-weight: 600; cursor: pointer; background: ${text}33; color: ${text};
-        transition: transform 0.1s;
-      `;
-      btn.textContent = String(i);
-      btn.addEventListener("click", () => {
-        this.trackEvent(campaign.id, "clicked");
-      });
-      scale.appendChild(btn);
-    }
-    body.appendChild(scale);
-    const labels = document.createElement("div");
-    labels.style.cssText = "display: flex; justify-content: space-between; font-size: 11px; opacity: 0.6; margin-bottom: 16px;";
-    const notLikely = document.createElement("span");
-    notLikely.textContent = "Not likely";
-    const veryLikely = document.createElement("span");
-    veryLikely.textContent = "Very likely";
-    labels.appendChild(notLikely);
-    labels.appendChild(veryLikely);
-    body.appendChild(labels);
+    const body = this._buildNPSSurveyBody(campaign, ic, text, "overlay");
     this.addCloseButton(body, overlay, campaign.id);
     modal.appendChild(body);
     overlay.appendChild(modal);
@@ -1450,31 +1760,7 @@ const _AegisInAppManager = class _AegisInAppManager {
       background: ${bg}; color: ${text}; animation: aegisScaleIn 0.3s ease;
       box-shadow: 0 20px 60px rgba(0,0,0,0.15);
     `;
-    const body = document.createElement("div");
-    body.style.cssText = "padding: 24px; text-align: center;";
-    const title = document.createElement("div");
-    title.style.cssText = "font-size: 18px; font-weight: 700; margin-bottom: 16px;";
-    title.textContent = campaign.title || "Rate your experience";
-    body.appendChild(title);
-    const stars = document.createElement("div");
-    stars.style.cssText = "display: flex; gap: 8px; justify-content: center; margin-bottom: 16px;";
-    const maxStars = ic.rating_scale || 5;
-    for (let i = 1; i <= maxStars; i++) {
-      const star = document.createElement("span");
-      star.style.cssText = "font-size: 32px; cursor: pointer; transition: transform 0.1s;";
-      star.textContent = "☆";
-      star.addEventListener("click", () => {
-        this.trackEvent(campaign.id, "clicked");
-      });
-      star.addEventListener("mouseenter", () => {
-        star.style.transform = "scale(1.2)";
-      });
-      star.addEventListener("mouseleave", () => {
-        star.style.transform = "scale(1)";
-      });
-      stars.appendChild(star);
-    }
-    body.appendChild(stars);
+    const body = this._buildStarRatingBody(campaign, ic, text, "overlay");
     this.addCloseButton(body, overlay, campaign.id);
     modal.appendChild(body);
     overlay.appendChild(modal);
@@ -2526,7 +2812,7 @@ const _AegisInAppManager = class _AegisInAppManager {
     this.disconnectSSE();
     if (typeof document !== "undefined") {
       document.querySelectorAll(
-        ".aegis-in-app-banner, .aegis-in-app-modal-overlay, .aegis-in-app-fullscreen-overlay, .aegis-in-app-half-interstitial-overlay, .aegis-in-app-alert-overlay, .aegis-in-app-pip, .aegis-in-app-nps-overlay, .aegis-in-app-countdown-overlay, .aegis-in-app-rating-overlay, .aegis-in-app-poll-overlay, .aegis-in-app-quiz-overlay"
+        ".aegis-in-app-banner, .aegis-in-app-modal-overlay, .aegis-in-app-fullscreen-overlay, .aegis-in-app-half-interstitial-overlay, .aegis-in-app-alert-overlay, .aegis-in-app-pip, .aegis-in-app-nps-overlay, .aegis-in-app-countdown-overlay, .aegis-in-app-rating-overlay, .aegis-in-app-poll-overlay, .aegis-in-app-quiz-overlay, .aegis-in-app-rating-card, .aegis-in-app-nps-card"
       ).forEach((el) => {
         if (el.parentNode) {
           el.parentNode.removeChild(el);
@@ -3233,6 +3519,28 @@ class TriggerEngine {
     this.visibilityChangeEnabled = false;
     this.backButtonEnabled = false;
     this.backButtonFired = false;
+    this.rageClickEnabled = false;
+    this.rageClickConfig = { threshold: 3, windowMs: 1e3 };
+    this.rageClickBuffer = /* @__PURE__ */ new Map();
+    this.rageClickFiredInBurst = /* @__PURE__ */ new Set();
+    this.hoverEnabled = false;
+    this.hoverStartAt = /* @__PURE__ */ new Map();
+    this.hoverLastMs = /* @__PURE__ */ new Map();
+    this.hoverThresholds = /* @__PURE__ */ new Map([
+      ["price", [1500]],
+      ["cta", [1500]]
+    ]);
+    this.hoverThresholdsFired = /* @__PURE__ */ new Map();
+    this.hoverThresholdTimers = /* @__PURE__ */ new Map();
+    this.mouseVelEnabled = false;
+    this.mouseVelConfig = {
+      threshold: 1.5,
+      windowMs: 400,
+      cooldownMs: 5e3
+    };
+    this.mouseSamples = [];
+    this.mouseVelLast = 0;
+    this.mouseVelLastFiredAt = 0;
     this.handleScroll = () => {
       const scrollTop = window.pageYOffset || document.documentElement.scrollTop;
       const scrollHeight = document.documentElement.scrollHeight - window.innerHeight;
@@ -3377,6 +3685,204 @@ class TriggerEngine {
   registerBackButton() {
     this.backButtonEnabled = true;
   }
+  /**
+   * Enable rage-click detection (P2 Task 1).
+   *
+   * After calling this, feed click events via `noteClick(intent)`.
+   * SelectorBinder (P1 Task 5) is the upstream source; the wiring lives
+   * in IntentSnapshotCollector (P2 Task 5). Calling `noteClick` without
+   * a prior `registerRageClick()` is a no-op so legacy callers don't
+   * accidentally enable the feature.
+   */
+  registerRageClick(config) {
+    this.rageClickEnabled = true;
+    if (config) {
+      this.rageClickConfig = {
+        threshold: config.threshold ?? this.rageClickConfig.threshold,
+        windowMs: config.windowMs ?? this.rageClickConfig.windowMs
+      };
+    }
+  }
+  /**
+   * Feed a click event for rage-click detection. Returns the current
+   * count within-window for the intent — useful for the snapshot
+   * collector (P2 Task 5) which updates IntentRuleEvaluator with
+   * `rage_click_count` continuously, not just at the burst threshold.
+   *
+   * Idempotent w.r.t. `registerRageClick` — when not enabled, this
+   * returns 0 without buffering.
+   */
+  noteClick(intent, timestamp = Date.now()) {
+    if (!this.rageClickEnabled) return 0;
+    const buf = this.rageClickBuffer.get(intent) ?? [];
+    const cutoff = timestamp - this.rageClickConfig.windowMs;
+    let trimStart = 0;
+    while (trimStart < buf.length && buf[trimStart] < cutoff) trimStart++;
+    const recent = trimStart === 0 ? buf : buf.slice(trimStart);
+    recent.push(timestamp);
+    this.rageClickBuffer.set(intent, recent);
+    if (recent.length < this.rageClickConfig.threshold) {
+      this.rageClickFiredInBurst.delete(intent);
+    }
+    if (recent.length >= this.rageClickConfig.threshold && !this.rageClickFiredInBurst.has(intent)) {
+      this.rageClickFiredInBurst.add(intent);
+      this.emit("rage_click", {
+        intent,
+        count: recent.length,
+        window_ms: this.rageClickConfig.windowMs
+      });
+    }
+    return recent.length;
+  }
+  /** Snapshot the current rage_click count for an intent. The
+   *  IntentSnapshotCollector (P2 Task 5) calls this when building the
+   *  `rage_click_count` signal value for the IntentRuleEvaluator. */
+  getRageClickCount(intent) {
+    if (!this.rageClickEnabled) return 0;
+    const buf = this.rageClickBuffer.get(intent);
+    if (!buf) return 0;
+    const cutoff = Date.now() - this.rageClickConfig.windowMs;
+    let live = 0;
+    for (const ts of buf) {
+      if (ts >= cutoff) live++;
+    }
+    return live;
+  }
+  /**
+   * Enable hover-dwell tracking (P2 Task 2). After registration, feed
+   * hover events via `noteHoverStart(intent, ts)` / `noteHoverEnd`.
+   * SelectorBinder (P1 Task 5) is the upstream source; wiring lands in
+   * P2 Task 5.
+   */
+  registerHoverDwell(config) {
+    this.hoverEnabled = true;
+    if (config == null ? void 0 : config.thresholdsByIntent) {
+      for (const [intent, thresholds] of Object.entries(config.thresholdsByIntent)) {
+        if (thresholds) this.hoverThresholds.set(intent, thresholds);
+      }
+    }
+  }
+  /** Record the start of a hover on the named intent. Schedules
+   *  per-threshold timers that emit `<intent>_hover_dwell_<ms>` when
+   *  the active hover passes each registered threshold. */
+  noteHoverStart(intent, timestamp = Date.now()) {
+    if (!this.hoverEnabled) return;
+    if (this.hoverStartAt.has(intent)) {
+      this.noteHoverEnd(intent, timestamp);
+    }
+    this.hoverStartAt.set(intent, timestamp);
+    this.hoverThresholdsFired.set(intent, /* @__PURE__ */ new Set());
+    const thresholds = this.hoverThresholds.get(intent);
+    if (thresholds) {
+      const timers = [];
+      for (const ms of thresholds) {
+        const timerId = setTimeout(() => {
+          if (!this.hoverStartAt.has(intent)) return;
+          const firedSet = this.hoverThresholdsFired.get(intent);
+          if (firedSet == null ? void 0 : firedSet.has(ms)) return;
+          firedSet == null ? void 0 : firedSet.add(ms);
+          this.emit(`${intent}_hover_dwell_${ms}`, {
+            intent,
+            threshold_ms: ms,
+            actual_ms: Date.now() - timestamp
+          });
+        }, ms);
+        timers.push(timerId);
+      }
+      this.hoverThresholdTimers.set(intent, timers);
+    }
+  }
+  /** Record the end of a hover on the named intent. Updates the sticky
+   *  `lastHoverMs` so `getHoverMs` keeps returning the last-known
+   *  duration until the next hover_start. */
+  noteHoverEnd(intent, timestamp = Date.now()) {
+    if (!this.hoverEnabled) return;
+    const startAt = this.hoverStartAt.get(intent);
+    if (startAt === void 0) return;
+    const dwell = Math.max(0, timestamp - startAt);
+    this.hoverLastMs.set(intent, dwell);
+    this.hoverStartAt.delete(intent);
+    const pending = this.hoverThresholdTimers.get(intent);
+    if (pending) {
+      for (const id of pending) clearTimeout(id);
+      this.hoverThresholdTimers.delete(intent);
+    }
+    this.hoverThresholdsFired.delete(intent);
+  }
+  /**
+   * Enable mouse-velocity-to-top tracking (P2 Task 3). After
+   * registration, feed positions via `noteMousePosition(x, y, ts?)`.
+   * IntentSnapshotCollector (P2 Task 5) wires window 'mousemove' to
+   * this method, with throttling to ~100ms per the plan.
+   */
+  registerMouseVelocityToTop(config) {
+    this.mouseVelEnabled = true;
+    if (config) {
+      this.mouseVelConfig = {
+        threshold: config.threshold ?? this.mouseVelConfig.threshold,
+        windowMs: config.windowMs ?? this.mouseVelConfig.windowMs,
+        cooldownMs: config.cooldownMs ?? this.mouseVelConfig.cooldownMs
+      };
+    }
+  }
+  /** Feed a mouse-position sample. Recomputes the rolling-window
+   *  velocity-to-top and fires `mouse_velocity_to_top` when the value
+   *  crosses the configured threshold (subject to cooldown). */
+  noteMousePosition(x, y, timestamp = Date.now()) {
+    if (!this.mouseVelEnabled) return 0;
+    const cutoff = timestamp - this.mouseVelConfig.windowMs;
+    let trimStart = 0;
+    while (trimStart < this.mouseSamples.length && this.mouseSamples[trimStart].ts < cutoff) {
+      trimStart++;
+    }
+    if (trimStart > 0) this.mouseSamples = this.mouseSamples.slice(trimStart);
+    this.mouseSamples.push({ x, y, ts: timestamp });
+    if (this.mouseSamples.length < 2) {
+      this.mouseVelLast = 0;
+      return 0;
+    }
+    const oldest = this.mouseSamples[0];
+    const newest = this.mouseSamples[this.mouseSamples.length - 1];
+    const dt = newest.ts - oldest.ts;
+    if (dt <= 0) {
+      this.mouseVelLast = 0;
+      return 0;
+    }
+    const velocity = -(newest.y - oldest.y) / dt;
+    this.mouseVelLast = velocity;
+    const cooldownOk = this.mouseVelLastFiredAt === 0 || timestamp - this.mouseVelLastFiredAt >= this.mouseVelConfig.cooldownMs;
+    if (velocity >= this.mouseVelConfig.threshold && cooldownOk) {
+      this.mouseVelLastFiredAt = timestamp;
+      this.emit("mouse_velocity_to_top", {
+        velocity,
+        threshold: this.mouseVelConfig.threshold,
+        window_ms: this.mouseVelConfig.windowMs,
+        samples: this.mouseSamples.length
+      });
+    }
+    return velocity;
+  }
+  /** Snapshot the current velocity-to-top in px/ms (positive = up).
+   *  Returns 0 when not enabled or insufficient samples. */
+  getMouseVelocityToTop() {
+    return this.mouseVelEnabled ? this.mouseVelLast : 0;
+  }
+  /**
+   * Snapshot the hover dwell for an intent.
+   * - Currently hovering: returns `Date.now() - hover_start_at`.
+   * - Hovered before, not currently: returns the most recent hover's
+   *   duration (sticky — the rule evaluator queries this AFTER
+   *   mouseleave to see "did Priya hover the price ≥ 1.5s?").
+   * - Never hovered: returns 0.
+   */
+  getHoverMs(intent) {
+    if (!this.hoverEnabled) return 0;
+    const startAt = this.hoverStartAt.get(intent);
+    if (startAt !== void 0) {
+      return Math.max(0, Date.now() - startAt);
+    }
+    return this.hoverLastMs.get(intent) ?? 0;
+  }
   start() {
     if (this.isStarted) {
       return;