@seatlayer/js 0.16.1 → 0.18.0

package/dist/index.js

@@ -326,16 +326,46 @@ var TYPES = /* @__PURE__ */ new Set([
   "seatlayer.designer.close",
   "seatlayer.designer.error"
 ]);
+var DEFAULT_LOADING_TIMEOUT_MS = 2e4;
 function resolveContainer2(container) {
   if (typeof container !== "string") return container;
   const element = document.querySelector(container);
   if (!element) throw new Error(`EmbeddedDesigner container not found: ${container}`);
   return element;
 }
+function causeFromCode(code) {
+  const value = (code ?? "").toLowerCase();
+  if (value.includes("expire") || value.includes("revoke") || value === "401") return "expired";
+  if (value.includes("mismatch")) return "mismatch";
+  if (value.includes("timeout")) return "timeout";
+  return "load";
+}
+var ERROR_COPY = {
+  expired: {
+    title: "This design session expired",
+    body: "For your security, editing sessions are short-lived. Start a fresh one to keep designing."
+  },
+  mismatch: {
+    title: "This editor doesn't match this chart",
+    body: "The session that loaded belongs to a different chart or workspace. Reopen the designer to continue."
+  },
+  timeout: {
+    title: "The designer is taking too long",
+    body: "It did not finish loading in time. This is usually a slow connection \u2014 try again."
+  },
+  load: {
+    title: "We couldn't load the designer",
+    body: "Something went wrong while opening the editor. Please try again."
+  }
+};
 var EmbeddedDesigner = class {
   constructor(options) {
     this.frame = null;
     this.designerOrigin = "";
+    this.overlay = null;
+    this.timeoutTimer = null;
+    this.phase = "loading";
+    this.restoreContainerPosition = null;
     this.handleMessage = (event) => {
       if (!this.frame || event.origin !== this.designerOrigin || event.source !== this.frame.contentWindow) return;
       if (!event.data || typeof event.data !== "object") return;
@@ -350,10 +380,15 @@ var EmbeddedDesigner = class {
         message: typeof data.message === "string" ? data.message : void 0,
         meta: data.meta
       };
-      if (this.options.expectedChartId && message.chartId && message.chartId !== this.options.expectedChartId) return;
-      if (this.options.expectedWorkspaceId && message.workspaceId && message.workspaceId !== this.options.expectedWorkspaceId) return;
+      if (this.options.expectedChartId && message.chartId && message.chartId !== this.options.expectedChartId || this.options.expectedWorkspaceId && message.workspaceId && message.workspaceId !== this.options.expectedWorkspaceId) {
+        this.showError("mismatch");
+        return;
+      }
       switch (message.type) {
         case "seatlayer.designer.ready":
+          this.phase = "ready";
+          this.clearTimeoutTimer();
+          this.removeOverlay();
           this.options.onReady?.(message);
           break;
         case "seatlayer.designer.saved":
@@ -366,6 +401,7 @@ var EmbeddedDesigner = class {
           this.options.onClose?.(message);
           break;
         case "seatlayer.designer.error":
+          this.showError(causeFromCode(message.code));
           this.options.onError?.(message);
           break;
       }
@@ -389,9 +425,21 @@ var EmbeddedDesigner = class {
     frame.style.border = "0";
     Object.assign(frame.style, this.options.style);
     if (this.options.className) frame.className = this.options.className;
+    const container = resolveContainer2(this.options.container);
     window.addEventListener("message", this.handleMessage);
-    resolveContainer2(this.options.container).append(frame);
+    container.append(frame);
     this.frame = frame;
+    this.phase = "loading";
+    if (this.loadingStateEnabled()) {
+      this.ensureContainerPositioned(container);
+      this.renderOverlay(container, "loading");
+      const timeout = this.options.loadingTimeoutMs ?? DEFAULT_LOADING_TIMEOUT_MS;
+      if (timeout > 0 && Number.isFinite(timeout)) {
+        this.timeoutTimer = setTimeout(() => {
+          if (this.phase === "loading") this.showError("timeout");
+        }, timeout);
+      }
+    }
     return frame;
   }
   /** Replace the iframe instead of assigning a new fragment to an existing one. */
@@ -404,9 +452,208 @@ var EmbeddedDesigner = class {
   }
   destroy() {
     window.removeEventListener("message", this.handleMessage);
+    this.clearTimeoutTimer();
+    this.removeOverlay();
+    this.restoreContainerStyle();
     this.frame?.remove();
     this.frame = null;
     this.designerOrigin = "";
+    this.phase = "loading";
+  }
+  loadingStateEnabled() {
+    return this.options.showLoadingState !== false;
+  }
+  clearTimeoutTimer() {
+    if (this.timeoutTimer !== null) {
+      clearTimeout(this.timeoutTimer);
+      this.timeoutTimer = null;
+    }
+  }
+  ensureContainerPositioned(container) {
+    const position = getComputedStyle(container).position;
+    if (position === "static") {
+      this.restoreContainerPosition = container.style.position;
+      container.style.position = "relative";
+    }
+  }
+  restoreContainerStyle() {
+    if (this.restoreContainerPosition === null) return;
+    try {
+      resolveContainer2(this.options.container).style.position = this.restoreContainerPosition;
+    } catch {
+    }
+    this.restoreContainerPosition = null;
+  }
+  removeOverlay() {
+    this.overlay?.remove();
+    this.overlay = null;
+  }
+  showError(cause) {
+    this.phase = "error";
+    this.clearTimeoutTimer();
+    if (!this.loadingStateEnabled()) return;
+    let container;
+    try {
+      container = resolveContainer2(this.options.container);
+    } catch {
+      return;
+    }
+    this.renderOverlay(container, "error", cause);
+  }
+  handleTryAgain() {
+    if (this.options.onRequestRelaunch) {
+      this.options.onRequestRelaunch();
+      return;
+    }
+    this.mount();
+  }
+  /**
+   * Build (or rebuild) the overlay for the given phase. A single overlay element
+   * is reused so we never stack stale skeletons or cards.
+   */
+  renderOverlay(container, phase, cause) {
+    this.removeOverlay();
+    const overlay = document.createElement("div");
+    overlay.setAttribute("data-seatlayer-designer-overlay", phase);
+    overlay.setAttribute("role", phase === "error" ? "alert" : "status");
+    overlay.setAttribute("aria-live", "polite");
+    Object.assign(overlay.style, {
+      position: "absolute",
+      inset: "0",
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "center",
+      background: "#101625",
+      color: "#e6ebf5",
+      fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif',
+      zIndex: "2",
+      overflow: "hidden"
+    });
+    if (phase === "loading") this.buildSkeleton(overlay);
+    else this.buildErrorCard(overlay, cause ?? "load");
+    container.append(overlay);
+    this.overlay = overlay;
+  }
+  buildSkeleton(overlay) {
+    const style = document.createElement("style");
+    style.textContent = `
+@media (prefers-reduced-motion: no-preference) {
+  @keyframes seatlayer-designer-shimmer {
+    0% { background-position: -320px 0; }
+    100% { background-position: 320px 0; }
+  }
+  [data-seatlayer-designer-overlay="loading"] .sl-shimmer {
+    animation: seatlayer-designer-shimmer 1.25s ease-in-out infinite;
+    background-size: 640px 100%;
+  }
+}`;
+    overlay.append(style);
+    const shimmer = "linear-gradient(90deg, rgba(255,255,255,0.04) 25%, rgba(255,255,255,0.10) 37%, rgba(255,255,255,0.04) 63%)";
+    const scaffold = document.createElement("div");
+    Object.assign(scaffold.style, {
+      position: "absolute",
+      inset: "0",
+      display: "flex",
+      flexDirection: "column",
+      padding: "16px",
+      gap: "14px",
+      opacity: "0.9"
+    });
+    const bar = (styles) => {
+      const node = document.createElement("div");
+      node.className = "sl-shimmer";
+      Object.assign(node.style, {
+        background: shimmer,
+        borderRadius: "8px"
+      });
+      Object.assign(node.style, styles);
+      return node;
+    };
+    scaffold.append(bar({ height: "40px", width: "100%", flex: "0 0 auto" }));
+    const body = document.createElement("div");
+    Object.assign(body.style, {
+      display: "flex",
+      gap: "14px",
+      flex: "1 1 auto",
+      minHeight: "0"
+    });
+    body.append(bar({ width: "220px", height: "100%", flex: "0 0 auto" }));
+    body.append(bar({ flex: "1 1 auto", height: "100%" }));
+    scaffold.append(body);
+    overlay.append(scaffold);
+    const caption = document.createElement("div");
+    Object.assign(caption.style, {
+      position: "relative",
+      zIndex: "1",
+      display: "flex",
+      alignItems: "center",
+      gap: "10px",
+      padding: "10px 16px",
+      borderRadius: "999px",
+      background: "rgba(16, 22, 37, 0.72)",
+      fontSize: "13px",
+      fontWeight: "500",
+      letterSpacing: "0.01em"
+    });
+    const dot = document.createElement("span");
+    dot.className = "sl-shimmer";
+    Object.assign(dot.style, {
+      width: "9px",
+      height: "9px",
+      borderRadius: "50%",
+      background: shimmer,
+      flex: "0 0 auto"
+    });
+    caption.append(dot);
+    caption.append(document.createTextNode("Loading designer\u2026"));
+    overlay.append(caption);
+  }
+  buildErrorCard(overlay, cause) {
+    const copy = ERROR_COPY[cause];
+    const card = document.createElement("div");
+    Object.assign(card.style, {
+      maxWidth: "420px",
+      margin: "0 24px",
+      padding: "28px",
+      textAlign: "center",
+      background: "rgba(255, 255, 255, 0.03)",
+      border: "1px solid rgba(255, 255, 255, 0.08)",
+      borderRadius: "16px",
+      boxShadow: "0 12px 40px rgba(0, 0, 0, 0.35)"
+    });
+    const heading = document.createElement("h2");
+    heading.textContent = copy.title;
+    Object.assign(heading.style, {
+      margin: "0 0 8px",
+      fontSize: "17px",
+      fontWeight: "600",
+      color: "#f4f7ff"
+    });
+    const body = document.createElement("p");
+    body.textContent = copy.body;
+    Object.assign(body.style, {
+      margin: "0 0 20px",
+      fontSize: "13.5px",
+      lineHeight: "1.5",
+      color: "#aab4c8"
+    });
+    const button = document.createElement("button");
+    button.type = "button";
+    button.textContent = "Try again";
+    Object.assign(button.style, {
+      appearance: "none",
+      cursor: "pointer",
+      border: "0",
+      borderRadius: "10px",
+      padding: "10px 22px",
+      fontSize: "14px",
+      fontWeight: "600",
+      color: "#101625",
+      background: "#7aa2ff"
+    });
+    button.addEventListener("click", () => this.handleTryAgain());
+    card.append(heading, body, button);
+    overlay.append(card);
   }
 };
 
@@ -2966,6 +3213,8 @@ function toRenderStatus(s) {
 var DEFAULT_API_BASE3 = "https://api.seatlayer.io";
 var STYLE_ID2 = "seatlayer-manager-style";
 var FEED_CAP = 80;
+var MAX_LIVE_SEAT_PULSES = 16;
+var MAX_LIVE_SECTION_PULSES = 4;
 var LEGEND = [
   { key: "free", label: "Free", color: "#6e7bff" },
   { key: "held", label: "Held", color: "#f4b740" },
@@ -2991,13 +3240,21 @@ var CSS2 = `
 @keyframes slm-pulse{0%{box-shadow:0 0 0 0 rgba(34,160,107,.5)}70%{box-shadow:0 0 0 7px rgba(34,160,107,0)}100%{box-shadow:0 0 0 0 rgba(34,160,107,0)}}
 .slm-kpis{grid-column:1/-1;display:grid;grid-template-columns:repeat(8,minmax(0,1fr));width:100%;padding-top:10px;
   border-top:1px solid var(--slm-line)}
-.slm-kpi{display:flex;min-width:0;flex-direction:column;align-items:center;padding:0 5px;line-height:1.15;text-align:center}
+.slm-kpi{position:relative;display:flex;min-width:0;flex-direction:column;align-items:center;padding:0 5px;line-height:1.15;text-align:center}
 .slm-kpi b{display:flex;min-width:0;align-items:baseline;justify-content:center;font-size:17px;font-weight:800;
   font-variant-numeric:tabular-nums;white-space:nowrap}
 .slm-kpi span{font-size:9.5px;letter-spacing:.1em;text-transform:uppercase;color:var(--slm-muted);font-weight:700}
 .slm-kpi .dot{display:inline-block;width:8px;height:8px;border-radius:50%;margin-right:5px;vertical-align:baseline}
+.slm-kpi.changed b{animation:slm-kpi-bump .58s cubic-bezier(.2,.8,.2,1)}
+.slm-kpidelta{position:absolute;right:4px;top:-12px;padding:2px 5px;border-radius:999px;background:rgba(34,160,107,.17);
+  color:#5bd39b!important;font-size:9px!important;letter-spacing:0!important;text-transform:none!important;white-space:nowrap;
+  animation:slm-kpi-delta 1.45s ease-out both;pointer-events:none}
+.slm-kpidelta.down{background:rgba(244,183,64,.14);color:#f7ca6b!important}
+@keyframes slm-kpi-bump{0%,100%{transform:none}35%{transform:translateY(-2px) scale(1.08);text-shadow:0 0 18px rgba(255,255,255,.24)}}
+@keyframes slm-kpi-delta{0%{opacity:0;transform:translateY(5px)}18%,72%{opacity:1;transform:none}100%{opacity:0;transform:translateY(-5px)}}
 .slm-barbtn{padding:7px 13px;border-radius:9px;border:1px solid var(--slm-line);color:var(--slm-text);font-weight:700;font-size:12.5px}
 .slm-barbtn:hover{border-color:var(--slm-muted)}
+.slm-barbtn.follow.on{background:rgba(34,160,107,.13);border-color:#22a06b;color:#5bd39b}
 
 /* body */
 .slm-body{display:flex;flex:1;min-height:0}
@@ -3009,6 +3266,14 @@ var CSS2 = `
 .slm-zoomhint{position:absolute;left:50%;top:14px;transform:translateX(-50%);padding:6px 13px;border-radius:999px;
   background:rgba(0,0,0,.55);color:#fff;font-size:12px;font-weight:700;pointer-events:none;opacity:0;transition:opacity .2s}
 .slm-zoomhint.on{opacity:1}
+.slm-liveevent{position:absolute;left:50%;top:14px;z-index:4;display:flex;align-items:center;gap:8px;max-width:min(560px,calc(100% - 32px));
+  padding:8px 12px;border:1px solid var(--slm-line);border-radius:999px;background:color-mix(in srgb,var(--slm-surface) 92%,transparent);
+  box-shadow:0 10px 34px rgba(0,0,0,.32);opacity:0;transform:translate(-50%,-8px);pointer-events:none;
+  transition:opacity .18s ease,transform .24s ease;backdrop-filter:blur(10px)}
+.slm-liveevent.on{opacity:1;transform:translate(-50%,0)}
+.slm.block-mode .slm-liveevent{top:52px}
+.slm-liveeventdot{width:8px;height:8px;border-radius:50%;flex:none}.slm-liveeventcopy{min-width:0;overflow:hidden;text-overflow:ellipsis;
+  white-space:nowrap;font-size:12px;font-weight:800}.slm-liveeventhint{color:var(--slm-muted);font-size:10px;white-space:nowrap}
 .slm-rail{width:320px;flex:none;border-left:1px solid var(--slm-line);display:flex;flex-direction:column;min-height:0}
 .slm-railscroll{flex:1;overflow-y:auto;padding:16px}
 .slm-eyebrow{font-size:10px;letter-spacing:.14em;text-transform:uppercase;color:var(--slm-muted);font-weight:800;margin-bottom:6px}
@@ -3023,13 +3288,16 @@ var CSS2 = `
 
 /* activity feed */
 .slm-feed{display:flex;flex-direction:column;gap:0}
-.slm-feedrow{display:flex;align-items:center;gap:9px;padding:8px 2px;border-bottom:1px solid var(--slm-line);
-  font-size:12.5px;animation:slm-in .35s ease}
+.slm-feedrow{display:flex!important;width:100%;align-items:center;gap:9px;padding:8px 2px!important;border-bottom:1px solid var(--slm-line)!important;
+  border-radius:6px;font-size:12.5px;text-align:left!important;animation:slm-in .35s ease}
+.slm-feedrow:hover{background:rgba(255,255,255,.035)!important}
 @keyframes slm-in{from{opacity:0;transform:translateY(-4px)}to{opacity:1;transform:none}}
 .slm-feeddot{width:8px;height:8px;border-radius:50%;flex:none}
 .slm-feedtext{flex:1;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 .slm-feedtext b{font-weight:800}
-.slm-feedtime{font-size:11px;color:var(--slm-muted);font-variant-numeric:tabular-nums;flex:none}
+.slm-feedsection{display:block;overflow:hidden;text-overflow:ellipsis;color:var(--slm-muted);font-size:10px;font-weight:750}
+.slm-feedmeta{display:flex;flex:none;flex-direction:column;align-items:flex-end;gap:1px}.slm-feedtime{font-size:10px;color:var(--slm-muted);font-variant-numeric:tabular-nums}
+.slm-feedlocate{font-size:9.5px;color:var(--slm-accent);font-weight:800}
 .slm-empty{font-size:12.5px;color:var(--slm-muted);padding:12px 0}
 
 /* block toolbar */
@@ -3099,10 +3367,13 @@ var CSS2 = `
 .slm-barbtn.on{background:rgba(244,183,64,.13);border-color:#f4b740;color:#f7ca6b}
 .slm-sectionlist{display:flex;flex-direction:column;gap:8px;margin-top:4px}
 .slm-sectionlist + .slm-eyebrow{margin-top:18px}
-.slm-sectionrow{padding:10px;border:1px solid var(--slm-line);border-radius:10px;background:var(--slm-surface)}
+.slm-sectionrow{width:100%;padding:10px!important;border:1px solid var(--slm-line)!important;border-radius:10px;background:var(--slm-surface)!important;text-align:left!important;transition:border-color .15s ease,transform .15s ease}
+.slm-sectionrow:hover{border-color:var(--slm-muted)!important;transform:translateY(-1px)}
 .slm-sectiontop,.slm-sectionmeta{display:flex;align-items:center;justify-content:space-between;gap:10px}
 .slm-sectiontop{font-size:12.5px;font-weight:800}.slm-sectionmeta{margin-top:5px;color:var(--slm-muted);font-size:11px}
+.slm-sectionmeta>span:first-child{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .slm-trend{font-size:10px;text-transform:uppercase;letter-spacing:.08em}.slm-trend.rising{color:#22a06b}.slm-trend.cooling{color:#f4b740}
+.slm-sectionlocate{color:var(--slm-accent);font-size:9.5px;font-weight:800}
 .slm-health{display:grid;grid-template-columns:1fr 1fr;gap:8px;margin-bottom:16px}
 .slm-healthitem{padding:10px;border:1px solid var(--slm-line);border-radius:10px;background:var(--slm-surface)}
 .slm-healthitem b{display:block;font-size:17px;font-variant-numeric:tabular-nums}.slm-healthitem span{display:block;margin-top:2px;color:var(--slm-muted);font-size:10px;text-transform:uppercase;letter-spacing:.08em}
@@ -3129,6 +3400,10 @@ var CSS2 = `
 .slm.compact .slm-barbtn{flex:1;padding:6px 9px}.slm.compact .slm-kpis{grid-template-columns:repeat(4,minmax(0,1fr));gap:8px}
 .slm.compact .slm-kpi[data-kpi="buyers"],.slm.compact .slm-kpi[data-kpi="active-holds"],
 .slm.compact .slm-kpi[data-kpi="sold-pct"],.slm.compact .slm-kpi[data-kpi="gross-sales"]{display:none}
+@media (prefers-reduced-motion:reduce){
+  .slm.live .slm-live-dot,.slm-feedrow,.slm-kpi.changed b,.slm-kpidelta{animation:none!important}
+  .slm-liveevent,.slm-sectionrow{transition:none!important}
+}
 `;
 function injectStyle() {
   if (typeof document === "undefined" || document.getElementById(STYLE_ID2)) return;
@@ -3187,6 +3462,8 @@ var SeatManager = class {
     this.controlRoomSnapshot = null;
     this.trendWindowMinutes = 15;
     this.heatEnabled = false;
+    this.lastKpiValues = /* @__PURE__ */ new Map();
+    this.activeKpiDeltas = /* @__PURE__ */ new Map();
     // realtime socket
     this.ws = null;
     this.reconnectTimer = null;
@@ -3196,6 +3473,10 @@ var SeatManager = class {
     this.feed = [];
     this.feedTimer = null;
     this.toastTimer = null;
+    this.liveEventTimer = null;
+    this.kpiCleanupTimer = null;
+    this.followLiveTimer = null;
+    this.followSeatTimer = null;
     this.releaseAt = null;
     this.layoutObserver = null;
     this.tokenExpiresAt = null;
@@ -3225,11 +3506,22 @@ var SeatManager = class {
       else return;
       event.preventDefault();
     };
+    this.onRailClick = (event) => {
+      const target = event.target;
+      const sectionButton = target?.closest("[data-section-focus]");
+      if (sectionButton?.dataset.sectionFocus) {
+        this.locateSection(sectionButton.dataset.sectionFocus);
+        return;
+      }
+      const feedButton = target?.closest("[data-feed-id]");
+      if (feedButton?.dataset.feedId) this.locateActivity(feedButton.dataset.feedId);
+    };
     this.sectionOptions = [];
     this.opts = options;
     this.key = options.eventKey;
     this.mode = options.mode ?? "view";
     this.keepLive = options.keepLiveWhileHidden ?? true;
+    this.followLive = options.followLive ?? false;
     this.currency = options.currency ?? "USD";
     this.tokenExpiresAt = options.tokenExpiresAt ?? null;
     this.api = new ManageApi(options.apiBase ?? DEFAULT_API_BASE3, options.token);
@@ -3286,6 +3578,19 @@ var SeatManager = class {
     this.applyHeatOverlay();
     this.paintHeatButton();
   }
+  /** Toggle opt-in camera following for new buyer hold/book events. */
+  setFollowLive(enabled) {
+    const changed = this.followLive !== enabled;
+    this.followLive = enabled;
+    if (!enabled) {
+      if (this.followLiveTimer) clearTimeout(this.followLiveTimer);
+      if (this.followSeatTimer) clearTimeout(this.followSeatTimer);
+      this.followLiveTimer = null;
+      this.followSeatTimer = null;
+    }
+    this.paintFollowLiveButton();
+    if (changed) this.opts.onFollowLiveChange?.(enabled);
+  }
   /** Change the current-vs-previous sales window and refresh the private projection. */
   setTrendWindow(windowMinutes) {
     const normalized = Number.isFinite(windowMinutes) ? Math.floor(windowMinutes) : 15;
@@ -3458,6 +3763,7 @@ var SeatManager = class {
     return Promise.resolve();
   }
   zoomToFit() {
+    this.renderer?.clearSectionFocus();
     this.renderer?.zoomToFit();
   }
   destroy() {
@@ -3465,12 +3771,17 @@ var SeatManager = class {
     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
     if (this.feedTimer) clearInterval(this.feedTimer);
     if (this.toastTimer) clearTimeout(this.toastTimer);
+    if (this.liveEventTimer) clearTimeout(this.liveEventTimer);
+    if (this.kpiCleanupTimer) clearTimeout(this.kpiCleanupTimer);
+    if (this.followLiveTimer) clearTimeout(this.followLiveTimer);
+    if (this.followSeatTimer) clearTimeout(this.followSeatTimer);
     if (this.unblockAllConfirmTimer) clearTimeout(this.unblockAllConfirmTimer);
     if (this.revenueRefreshTimer) clearTimeout(this.revenueRefreshTimer);
     if (this.tokenRefreshTimer) clearTimeout(this.tokenRefreshTimer);
     this.layoutObserver?.disconnect();
     this.layoutObserver = null;
     this.root?.removeEventListener("keydown", this.onKeyDown);
+    this.els.rail?.removeEventListener("click", this.onRailClick);
     if (typeof document !== "undefined") document.removeEventListener("fullscreenchange", this.onFullscreenChange);
     if (this.ws) {
       try {
@@ -3608,7 +3919,6 @@ var SeatManager = class {
         const id = this.labelToId.get(ch.label);
         if (id) {
           this.renderer?.setStatus([id], toRenderStatus(st));
-          this.flash(id, st);
           ids.push(id);
         }
         const verb = this.verbFor(prev, st);
@@ -3617,7 +3927,10 @@ var SeatManager = class {
         group.labels.push(ch.label);
         groups.set(groupKey, group);
       }
-      for (const group of groups.values()) this.pushActivity(group.labels, group.verb, group.status);
+      for (const group of groups.values()) {
+        const activity = this.pushActivity(group.labels, group.verb, group.status);
+        if (activity) this.paintSpatialActivity(activity);
+      }
       if (ids.length) {
         this.lastSyncedAt = Date.now();
         this.afterPaint();
@@ -3663,9 +3976,108 @@ var SeatManager = class {
       this.renderer?.forceDraw();
     }
   }
-  flash(id, st) {
-    if (st === "held") this.renderer?.flashSeat(id, "#f4b740");
-    else if (st === "booked") this.renderer?.flashSeat(id, "#22a06b");
+  activityColor(status) {
+    return status === "held" ? "#f4b740" : status === "booked" ? "#22a06b" : status === "blocked" ? "#8b94ac" : "#6e7bff";
+  }
+  sectionsForLabels(labels) {
+    const ids = /* @__PURE__ */ new Set();
+    for (const label of labels) {
+      const seat = this.labelToSeat.get(label);
+      if (!seat) continue;
+      const sectionId = this.sectionByObject.get(seat.rowId);
+      if (sectionId && sectionId !== UNGROUPED_ID) ids.add(sectionId);
+    }
+    const sectionIds = [...ids];
+    return {
+      ids: sectionIds,
+      labels: sectionIds.map((id) => this.sectionLabelById.get(id) ?? id)
+    };
+  }
+  pulseSeatLabels(labels, status) {
+    const color = this.activityColor(status);
+    for (const label of labels.slice(0, MAX_LIVE_SEAT_PULSES)) {
+      const id = this.labelToId.get(label);
+      if (id) this.renderer?.flashSeat(id, color);
+    }
+  }
+  /** Render one grouped realtime operation at the right semantic zoom level. */
+  paintSpatialActivity(activity) {
+    const sectionIds = activity.sectionIds ?? this.sectionsForLabels(activity.labels).ids;
+    const focused = this.renderer?.getFocusedSection() ?? null;
+    const followable = this.followLive && sectionIds.length === 1 && (activity.status === "held" || activity.status === "booked");
+    if (followable && focused === sectionIds[0]) {
+      this.pulseSeatLabels(activity.labels, activity.status);
+      return;
+    }
+    if (followable) {
+      if (this.followLiveTimer) clearTimeout(this.followLiveTimer);
+      if (this.followSeatTimer) clearTimeout(this.followSeatTimer);
+      this.followLiveTimer = setTimeout(() => {
+        this.followLiveTimer = null;
+        this.renderer?.focusSection(sectionIds[0]);
+        this.followSeatTimer = setTimeout(() => {
+          this.followSeatTimer = null;
+          this.pulseSeatLabels(activity.labels, activity.status);
+        }, 520);
+      }, 220);
+      return;
+    }
+    if (!focused && sectionIds.length) {
+      const color = this.activityColor(activity.status);
+      for (const sectionId of sectionIds.slice(0, MAX_LIVE_SECTION_PULSES)) {
+        this.renderer?.flashSection(sectionId, color);
+      }
+      return;
+    }
+    if (!sectionIds.length || focused && sectionIds.includes(focused)) {
+      this.pulseSeatLabels(activity.labels, activity.status);
+    }
+  }
+  locateSection(sectionId) {
+    this.renderer?.focusSection(sectionId);
+  }
+  locateActivity(activityId) {
+    const activity = this.feed.find((item) => item.id === activityId);
+    if (!activity) return;
+    const sectionIds = activity.sectionIds ?? this.sectionsForLabels(activity.labels).ids;
+    if (this.followSeatTimer) clearTimeout(this.followSeatTimer);
+    if (sectionIds.length === 1) {
+      this.locateSection(sectionIds[0]);
+      this.followSeatTimer = setTimeout(() => {
+        this.followSeatTimer = null;
+        this.pulseSeatLabels(activity.labels, activity.status);
+      }, 520);
+      return;
+    }
+    this.zoomToFit();
+    this.followSeatTimer = setTimeout(() => {
+      this.followSeatTimer = null;
+      if (sectionIds.length) {
+        const color = this.activityColor(activity.status);
+        for (const sectionId of sectionIds.slice(0, MAX_LIVE_SECTION_PULSES)) {
+          this.renderer?.flashSection(sectionId, color);
+        }
+      } else {
+        this.pulseSeatLabels(activity.labels, activity.status);
+      }
+    }, 280);
+  }
+  showLiveEvent(activity) {
+    const element = this.els.liveevent;
+    if (!element) return;
+    const sections = activity.sectionLabels ?? [];
+    const place = sections.length === 1 ? sections[0] : sections.length > 1 ? `${sections.length} sections` : activity.label;
+    const noun = activity.count === 1 ? "seat" : "seats";
+    element.innerHTML = `<span class="slm-liveeventdot" style="background:${this.activityColor(activity.status)}"></span>
+      <span class="slm-liveeventcopy">${esc(place)} \xB7 ${activity.count.toLocaleString()} ${noun} ${esc(activity.verb)}</span>
+      <span class="slm-liveeventhint">Live</span>`;
+    element.classList.add("on");
+    if (this.liveEventTimer) clearTimeout(this.liveEventTimer);
+    this.liveEventTimer = setTimeout(() => {
+      this.liveEventTimer = null;
+      element.classList.remove("on");
+      element.innerHTML = "";
+    }, 2800);
   }
   // ---- tallies + feed -------------------------------------------------------
   applyReportRevenue(report) {
@@ -3748,7 +4160,8 @@ var SeatManager = class {
   }
   pushActivity(labels, verb, status, at = Date.now()) {
     const label = labels[0];
-    if (!label) return;
+    if (!label) return null;
+    const sections = this.sectionsForLabels(labels);
     const item = {
       id: `${label}:${at}:${Math.random().toString(36).slice(2, 6)}`,
       at,
@@ -3756,12 +4169,16 @@ var SeatManager = class {
       labels: [...labels],
       count: labels.length,
       verb,
-      status
+      status,
+      sectionIds: sections.ids,
+      sectionLabels: sections.labels
     };
     this.feed.unshift(item);
     if (this.feed.length > FEED_CAP) this.feed.length = FEED_CAP;
     if (this.mode === "view") this.paintFeed();
+    this.showLiveEvent(item);
     this.opts.onActivity?.(item);
+    return item;
   }
   seedFeed(entries) {
     const verbByAction = {
@@ -3785,6 +4202,7 @@ var SeatManager = class {
     for (const e of entries) {
       const label = e.labels[0];
       if (!label) continue;
+      const sections = this.sectionsForLabels(e.labels);
       const item = {
         id: `log:${e.id}`,
         at: e.at,
@@ -3792,7 +4210,9 @@ var SeatManager = class {
         labels: [...e.labels],
         count: e.labels.length,
         verb: verbByAction[e.action] ?? e.action,
-        status: stByAction[e.action] ?? "free"
+        status: stByAction[e.action] ?? "free",
+        sectionIds: sections.ids,
+        sectionLabels: sections.labels
       };
       this.feed.push(item);
       this.opts.onActivity?.(item);
@@ -3830,13 +4250,15 @@ var SeatManager = class {
     for (const [k, v] of Object.entries(vars)) root.style.setProperty(k, v);
     root.innerHTML = `
       <div class="slm-bar">
-        <div class="slm-modes" data-ref="modes">
-          <button class="slm-mode" data-mode="view" title="Monitor (M)" aria-keyshortcuts="M">Monitor</button>
-          <button class="slm-mode" data-mode="inspect" title="Inspect (I)" aria-keyshortcuts="I">Inspect</button>
-          <button class="slm-mode" data-mode="block" title="Block (B)" aria-keyshortcuts="B">Block</button>
+        <div class="slm-modes" data-ref="modes" role="tablist" aria-label="Manager tools">
+          <button class="slm-mode" role="tab" data-mode="view" title="Monitor (M)" aria-keyshortcuts="M">Monitor</button>
+          <button class="slm-mode" role="tab" data-mode="inspect" title="Inspect (I)" aria-keyshortcuts="I">Inspect</button>
+          <button class="slm-mode" role="tab" data-mode="block" title="Block (B)" aria-keyshortcuts="B">Block</button>
         </div>
         <span class="slm-live"><span class="slm-live-dot"></span><span data-ref="livetext">CONNECTING</span></span>
         <div class="slm-bar-actions">
+          <button class="slm-barbtn follow" data-ref="follow" aria-pressed="false"
+            title="Stay on the current map view unless enabled">Follow live</button>
           <button class="slm-barbtn" data-ref="heat" aria-pressed="false"
             aria-label="Sales momentum overlay off"
             title="Highlight sections selling fastest in the selected time window">Sales momentum</button>
@@ -3848,6 +4270,7 @@ var SeatManager = class {
         <div class="slm-map">
           <div class="slm-map-host" data-ref="maphost"></div>
           <div class="slm-zoomhint" data-ref="zoomhint">Zoom in to marquee-select</div>
+          <div class="slm-liveevent" data-ref="liveevent" role="status" aria-live="polite"></div>
           <div class="slm-hud"><button class="slm-hud-chip" data-ref="zfit">Zoom to fit</button></div>
         </div>
         <aside class="slm-rail"><div class="slm-railscroll" data-ref="rail"></div></aside>
@@ -3867,20 +4290,25 @@ var SeatManager = class {
       modes: ref("modes"),
       livetext: ref("livetext"),
       kpis: ref("kpis"),
+      follow: ref("follow"),
       heat: ref("heat"),
       fullscreen: ref("fullscreen"),
       zoomhint: ref("zoomhint"),
+      liveevent: ref("liveevent"),
       rail: ref("rail"),
       toast: ref("toast"),
       zfit: ref("zfit")
     };
     this.els.modes.querySelectorAll("[data-mode]").forEach((b) => b.addEventListener("click", () => this.setMode(b.dataset.mode)));
     this.els.zfit.addEventListener("click", () => this.zoomToFit());
+    this.els.follow.addEventListener("click", () => this.setFollowLive(!this.followLive));
     this.els.heat.addEventListener("click", () => this.setHeatOverlay(!this.heatEnabled));
     this.els.fullscreen.addEventListener("click", () => this.toggleFullscreen());
     root.addEventListener("keydown", this.onKeyDown);
+    this.els.rail.addEventListener("click", this.onRailClick);
     document.addEventListener("fullscreenchange", this.onFullscreenChange);
     this.paintModeTabs();
+    this.paintFollowLiveButton();
     this.paintHeatButton();
     this.paintFullscreenButton();
   }
@@ -3909,10 +4337,20 @@ var SeatManager = class {
   paintModeTabs() {
     this.els.modes?.querySelectorAll("[data-mode]").forEach((b) => {
       const el = b;
-      el.classList.toggle("on", el.dataset.mode === this.mode);
+      const active = el.dataset.mode === this.mode;
+      el.classList.toggle("on", active);
+      el.setAttribute("aria-selected", String(active));
+      el.tabIndex = active ? 0 : -1;
     });
     this.root?.classList.toggle("block-mode", this.mode === "block");
   }
+  paintFollowLiveButton() {
+    const button = this.els.follow;
+    if (!button) return;
+    button.classList.toggle("on", this.followLive);
+    button.setAttribute("aria-pressed", String(this.followLive));
+    button.setAttribute("title", this.followLive ? "Following new buyer holds and bookings. Turn off to keep the current view." : "Stay on the current map view. Enable to follow new buyer holds and bookings.");
+  }
   paintHeatButton() {
     const button = this.els.heat;
     if (!button) return;
@@ -3953,20 +4391,55 @@ var SeatManager = class {
     const show = this.mode === "block" && this.renderer?.getRung?.() !== "seats";
     hint.classList.toggle("on", !!show);
   }
+  formatKpiDelta(key, delta, currency) {
+    const sign = delta > 0 ? "+" : "\u2212";
+    const absolute = Math.abs(delta);
+    if (key === "gross-sales") return `${sign}${fmtMoney(absolute, currency)}`;
+    if (key === "sold-pct") return `${sign}${absolute.toLocaleString()}pt`;
+    return `${sign}${absolute.toLocaleString()}`;
+  }
   paintKpis(t3) {
     if (!this.els.kpis) return;
     const rev = t3.revenueStatus === "current" ? fmtMoney(t3.grossRevenue, t3.currency) : "\u2014";
     const presence = this.controlRoomSnapshot?.presence;
-    this.els.kpis.innerHTML = [
-      { key: "sold-seats", n: t3.booked.toLocaleString(), l: "Sold seats", dot: "#22a06b" },
-      { key: "held-seats", n: t3.held.toLocaleString(), l: "Held seats", dot: "#f4b740" },
-      { key: "buyers", n: presence ? presence.shoppingSessions.toLocaleString() : "\u2014", l: "Buyers" },
-      { key: "active-holds", n: presence ? presence.activeHolds.toLocaleString() : "\u2014", l: "Active holds" },
-      { key: "free-seats", n: t3.free.toLocaleString(), l: "Free seats", dot: "#6e7bff" },
-      { key: "blocked", n: t3.blocked.toLocaleString(), l: "Blocked", dot: "#8b94ac" },
-      { key: "sold-pct", n: `${t3.capacityPct}%`, l: "Sold" },
-      { key: "gross-sales", n: rev, l: "Gross sales" }
-    ].map((k) => `<div class="slm-kpi" data-kpi="${k.key}"><b>${k.dot ? `<span class="dot" style="background:${k.dot}"></span>` : ""}${k.n}</b><span>${k.l}</span></div>`).join("");
+    const items = [
+      { key: "sold-seats", raw: t3.booked, n: t3.booked.toLocaleString(), l: "Sold seats", dot: "#22a06b" },
+      { key: "held-seats", raw: t3.held, n: t3.held.toLocaleString(), l: "Held seats", dot: "#f4b740" },
+      { key: "buyers", raw: presence?.shoppingSessions ?? null, n: presence ? presence.shoppingSessions.toLocaleString() : "\u2014", l: "Buyers" },
+      { key: "active-holds", raw: presence?.activeHolds ?? null, n: presence ? presence.activeHolds.toLocaleString() : "\u2014", l: "Active holds" },
+      { key: "free-seats", raw: t3.free, n: t3.free.toLocaleString(), l: "Free seats", dot: "#6e7bff" },
+      { key: "blocked", raw: t3.blocked, n: t3.blocked.toLocaleString(), l: "Blocked", dot: "#8b94ac" },
+      { key: "sold-pct", raw: t3.capacityPct, n: `${t3.capacityPct}%`, l: "Sold" },
+      { key: "gross-sales", raw: t3.revenueStatus === "current" ? t3.grossRevenue : null, n: rev, l: "Gross sales" }
+    ];
+    let hasChanges = false;
+    this.els.kpis.innerHTML = items.map((item) => {
+      const previous = this.lastKpiValues.get(item.key);
+      const changed = item.raw != null && previous != null && item.raw !== previous;
+      const delta = changed ? item.raw - previous : 0;
+      if (changed) {
+        hasChanges = true;
+        this.activeKpiDeltas.set(item.key, {
+          text: this.formatKpiDelta(item.key, delta, t3.currency),
+          down: delta < 0
+        });
+      }
+      if (item.raw != null) this.lastKpiValues.set(item.key, item.raw);
+      const activeDelta = this.activeKpiDeltas.get(item.key);
+      return `<div class="slm-kpi${activeDelta ? " changed" : ""}" data-kpi="${item.key}">
+        <b>${item.dot ? `<span class="dot" style="background:${item.dot}"></span>` : ""}${item.n}</b><span>${item.l}</span>
+        ${activeDelta ? `<span class="slm-kpidelta${activeDelta.down ? " down" : ""}">${activeDelta.text}</span>` : ""}
+      </div>`;
+    }).join("");
+    if (hasChanges) {
+      if (this.kpiCleanupTimer) clearTimeout(this.kpiCleanupTimer);
+      this.kpiCleanupTimer = setTimeout(() => {
+        this.kpiCleanupTimer = null;
+        this.activeKpiDeltas.clear();
+        this.els.kpis?.querySelectorAll(".slm-kpidelta").forEach((element) => element.remove());
+        this.els.kpis?.querySelectorAll(".slm-kpi.changed").forEach((element) => element.classList.remove("changed"));
+      }, 1500);
+    }
   }
   // ---- DOM: rails -----------------------------------------------------------
   paintRail() {
@@ -4037,10 +4510,10 @@ var SeatManager = class {
       const net = speed?.netBooked ?? 0;
       const netLabel = `${net > 0 ? "+" : ""}${net}`;
       const trend = speed?.trend === "rising" || speed?.trend === "cooling" ? speed.trend : "steady";
-      return `<div class="slm-sectionrow">
-        <div class="slm-sectiontop"><span>${esc(row.sectionLabel)}</span><span>${fmtMoney(row.bookedRevenue, snapshot.currency)}</span></div>
-        <div class="slm-sectionmeta"><span>${row.booked.toLocaleString()}/${row.total.toLocaleString()} sold \xB7 ${netLabel} in ${snapshot.velocity.windowMinutes}m</span><span class="slm-trend ${trend}">${trend}</span></div>
-      </div>`;
+      return `<button type="button" class="slm-sectionrow" data-section-focus="${esc(row.sectionId)}" title="Focus ${esc(row.sectionLabel)} on the map">
+        <span class="slm-sectiontop"><span>${esc(row.sectionLabel)}</span><span>${fmtMoney(row.bookedRevenue, snapshot.currency)}</span></span>
+        <span class="slm-sectionmeta"><span>${row.booked.toLocaleString()}/${row.total.toLocaleString()} sold \xB7 ${netLabel} in ${snapshot.velocity.windowMinutes}m</span><span class="slm-trend ${trend}">${trend}</span><span class="slm-sectionlocate">Locate</span></span>
+      </button>`;
     }).join("") : '<div class="slm-empty">No section metrics are available for this chart.</div>';
     this.paintTrendWindow();
     this.paintMomentumHelp();
@@ -4109,9 +4582,13 @@ var SeatManager = class {
     const color = { free: "#6e7bff", held: "#f4b740", booked: "#22a06b", blocked: "#8b94ac" };
     this.els.feed.innerHTML = this.feed.map((a) => {
       const extra = a.count > 1 ? ` +${a.count - 1}` : "";
-      return `<div class="slm-feedrow"><span class="slm-feeddot" style="background:${color[a.status]}"></span>
-        <span class="slm-feedtext">${a.count === 1 ? "Seat" : "Seats"} <b>${esc(a.label)}${extra}</b> ${esc(a.verb)}</span>
-        <span class="slm-feedtime">${relTime(a.at, now)}</span></div>`;
+      const sections = a.sectionLabels ?? [];
+      const sectionCopy = sections.length === 1 ? sections[0] : sections.length > 1 ? `${sections.length} sections` : "";
+      return `<button type="button" class="slm-feedrow" data-feed-id="${esc(a.id)}" title="Locate this activity on the map">
+        <span class="slm-feeddot" style="background:${color[a.status]}"></span>
+        <span class="slm-feedtext">${sectionCopy ? `<span class="slm-feedsection">${esc(sectionCopy)}</span>` : ""}${a.count === 1 ? "Seat" : "Seats"} <b>${esc(a.label)}${extra}</b> ${esc(a.verb)}</span>
+        <span class="slm-feedmeta"><span class="slm-feedtime">${relTime(a.at, now)}</span><span class="slm-feedlocate">Locate</span></span>
+      </button>`;
     }).join("");
   }
   renderBlockRail() {
@@ -4367,6 +4844,10 @@ var SeatManager = class {
   // ---- toast / done / fail --------------------------------------------------
   done(action, labels, msg) {
     this.toastOk(msg);
+    if (labels.length) {
+      const activity = action === "block" ? this.pushActivity(labels, "blocked", "blocked") : action === "unblock" || action === "unblockAll" ? this.pushActivity(labels, "unblocked", "free") : action === "cancelBooking" ? this.pushActivity(labels, "cancelled", "free") : null;
+      if (activity) this.paintSpatialActivity(activity);
+    }
     if (action !== "setHoldTtl") this.scheduleRevenueRefresh(0);
     this.opts.onActionComplete?.({ action, labels, count: labels.length });
   }