@seatlayer/core 0.34.0 → 0.36.0

package/dist/index.cjs

@@ -265,7 +265,6 @@ __export(index_exports, {
   rowInventoryCount: () => rowInventoryCount,
   rowSeatPositions: () => rowSeatPositions,
   seatCommercialMeta: () => seatCommercialMeta,
-  seatLabelPart: () => seatLabelPart,
   sectionGeometry: () => sectionGeometry,
   setLocale: () => setLocale,
   setMoneyLocale: () => setMoneyLocale,
@@ -565,6 +564,44 @@ function transformSectionOutlinePath(path, transform, radiusScale = 1, reflected
 }
 var SAGITTA_TO_CONTROL = 4 / 3;
 
+// src/core/segmentedRowModel.ts
+function resolveSegmentedRowGroups(objects) {
+  const segmented = /* @__PURE__ */ new Map();
+  const grouped = /* @__PURE__ */ new Map();
+  for (const object of objects) {
+    if (object.type !== "row" || !object.segmentedRow) continue;
+    const list = grouped.get(object.segmentedRow.groupId) ?? [];
+    list.push(object);
+    grouped.set(object.segmentedRow.groupId, list);
+  }
+  for (const [groupId, members] of grouped) {
+    const ordered = members.slice().sort((left, right) => left.segmentedRow.componentIndex - right.segmentedRow.componentIndex);
+    const expectedCount = ordered[0]?.segmentedRow?.componentCount ?? 0;
+    const first = ordered[0]?.segmentedRow;
+    if (!first) continue;
+    const valid = expectedCount >= 2 && ordered.length === expectedCount && first?.boundaryBefore === "start" && ordered.every((row, index) => row.segmentedRow?.kind === "segmented-row-v1" && row.segmentedRow.groupId === groupId && row.segmentedRow.componentCount === expectedCount && row.segmentedRow.componentIndex === index && (index === 0 ? row.segmentedRow.boundaryBefore === "start" : row.segmentedRow.boundaryBefore !== "start") && row.segmentedRow.displayLabel === first.displayLabel);
+    if (!valid) continue;
+    const totalSeats = ordered.reduce((sum, row) => sum + row.seatCount, 0);
+    let adjacencyOffset = 0;
+    let displayOffset = 0;
+    for (const row of ordered) {
+      if (row.segmentedRow.boundaryBefore === "break") adjacencyOffset += 1;
+      segmented.set(row.id, {
+        groupId,
+        adjacencyOffset,
+        displayOffset,
+        displayLabel: first.displayLabel,
+        totalSeats,
+        canonical: ordered[0],
+        viewFromSeatUrl: first.viewFromSeatUrl
+      });
+      adjacencyOffset += row.seatCount;
+      displayOffset += row.seatCount;
+    }
+  }
+  return segmented;
+}
+
 // src/core/labeling.ts
 var FULL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 var LOWER_ALPHABET = "abcdefghijklmnopqrstuvwxyz";
@@ -612,6 +649,78 @@ function toRoman(value) {
   return out;
 }
 
+// src/core/seatNumbering.ts
+function centerRank(n) {
+  const rank = new Array(n);
+  Array.from({ length: n }, (_, i) => i).sort((a, b) => Math.abs(2 * a - (n - 1)) - Math.abs(2 * b - (n - 1)) || a - b).forEach((idx, k) => rank[idx] = k);
+  return rank;
+}
+function seatLabelPart(row, i) {
+  const rawStart = row.seatLabelStart ?? 1;
+  const dir = row.seatNumbering?.direction ?? "ltr";
+  const step = row.seatNumbering?.step ?? 1;
+  const scheme = row.seatNumbering?.scheme ?? "decimal";
+  const prefix = row.seatNumbering?.prefix ?? "";
+  const endAt = row.seatNumbering?.endAt;
+  const n = row.seatCount;
+  if (scheme === "updown" || scheme === "updown-descending") {
+    const half = Math.ceil(n / 2);
+    const core2 = scheme === "updown" ? i < half ? rawStart + 2 * i : rawStart - 1 + 2 * (n - i) : i < half ? rawStart + 2 * (half - 1 - i) : rawStart + 1 + 2 * (i - half);
+    return `${prefix}${core2}`;
+  }
+  const effStep = scheme === "odd" || scheme === "even" ? 2 : step;
+  const start = endAt != null && Number.isFinite(endAt) ? endAt - (n - 1) * effStep : rawStart;
+  const p = dir === "center" ? centerRank(n)[i] : dir === "rtl" ? n - 1 - i : i;
+  let core;
+  switch (scheme) {
+    case "odd": {
+      const firstOdd = start % 2 === 1 ? start : start + 1;
+      core = String(firstOdd + p * 2);
+      break;
+    }
+    case "even": {
+      const firstEven = start % 2 === 0 ? start : start + 1;
+      core = String(firstEven + p * 2);
+      break;
+    }
+    case "roman":
+      core = toRoman(start + p * step);
+      break;
+    case "letters-upper":
+      core = toLetters(start + p * step, false);
+      break;
+    case "letters-lower":
+      core = toLetters(start + p * step, true);
+      break;
+    case "decimal":
+    default:
+      core = String(start + p * step);
+      break;
+  }
+  return `${prefix}${core}`;
+}
+function logicalNumberingRow(placement) {
+  return {
+    ...placement.canonical,
+    seatCount: placement.totalSeats,
+    label: placement.displayLabel,
+    displayLabel: placement.displayLabel
+  };
+}
+function seatInventoryLabel(row, physicalIndex, override) {
+  return override?.label ?? `${row.label}-${seatLabelPart(row, physicalIndex)}`;
+}
+function seatDisplayLabel(row, physicalIndex, placement, override) {
+  if (override?.displayLabel) return override.displayLabel;
+  if (!placement) {
+    const prefix = row.displayLabel ?? row.label;
+    return `${prefix}-${seatLabelPart(row, physicalIndex)}`;
+  }
+  const numberingRow = logicalNumberingRow(placement);
+  const ordinal = placement.displayOffset + physicalIndex;
+  return `${placement.displayLabel}-${seatLabelPart(numberingRow, ordinal)}`;
+}
+
 // src/core/units.ts
 var METRES_PER_CHART_UNIT = 0.55 / 24;
 var CHART_UNITS_PER_METRE = 1 / METRES_PER_CHART_UNIT;
@@ -1047,70 +1156,19 @@ function rowInventoryCount(row) {
   const skipped = new Set((row.overrides ?? []).filter((override) => override.skip && Number.isInteger(override.index) && override.index >= 0 && override.index < row.seatCount).map((override) => override.index));
   return Math.max(0, row.seatCount - skipped.size);
 }
-function centerRank(n) {
-  const rank = new Array(n);
-  Array.from({ length: n }, (_, i) => i).sort((a, b) => Math.abs(2 * a - (n - 1)) - Math.abs(2 * b - (n - 1)) || a - b).forEach((idx, k) => rank[idx] = k);
-  return rank;
-}
-function seatLabelPart(row, i) {
-  const rawStart = row.seatLabelStart ?? 1;
-  const dir = row.seatNumbering?.direction ?? "ltr";
-  const step = row.seatNumbering?.step ?? 1;
-  const scheme = row.seatNumbering?.scheme ?? "decimal";
-  const prefix = row.seatNumbering?.prefix ?? "";
-  const endAt = row.seatNumbering?.endAt;
-  const n = row.seatCount;
-  if (scheme === "updown" || scheme === "updown-descending") {
-    const half = Math.ceil(n / 2);
-    const core2 = scheme === "updown" ? i < half ? rawStart + 2 * i : rawStart - 1 + 2 * (n - i) : i < half ? rawStart + 2 * (half - 1 - i) : rawStart + 1 + 2 * (i - half);
-    return `${prefix}${core2}`;
-  }
-  const effStep = scheme === "odd" || scheme === "even" ? 2 : step;
-  const start = endAt != null && Number.isFinite(endAt) ? endAt - (n - 1) * effStep : rawStart;
-  const p = dir === "center" ? centerRank(n)[i] : dir === "rtl" ? n - 1 - i : i;
-  let core;
-  switch (scheme) {
-    case "odd": {
-      const firstOdd = start % 2 === 1 ? start : start + 1;
-      core = String(firstOdd + p * 2);
-      break;
-    }
-    case "even": {
-      const firstEven = start % 2 === 0 ? start : start + 1;
-      core = String(firstEven + p * 2);
-      break;
-    }
-    case "roman":
-      core = toRoman(start + p * step);
-      break;
-    case "letters-upper":
-      core = toLetters(start + p * step, false);
-      break;
-    case "letters-lower":
-      core = toLetters(start + p * step, true);
-      break;
-    case "decimal":
-    default:
-      core = String(start + p * step);
-      break;
-  }
-  return `${prefix}${core}`;
-}
-function expandRowSlots(row) {
+function expandRowSlots(row, placement) {
   const ov = overrideMap(row);
   return rowSeatPositions(row).map((p, i) => {
     const o = ov.get(i);
     const accessibility = overrideAccessibility(o);
-    const part = seatLabelPart(row, i);
-    const inventoryLabel = o?.label ?? `${row.label}-${part}`;
-    const displayPrefix = row.displayLabel ?? row.label;
+    const inventoryLabel = seatInventoryLabel(row, i, o);
     const commercial = { ...row.commercial, ...o?.commercial };
     return {
       index: i,
       x: p.x + (o?.dx ?? 0),
       y: p.y + (o?.dy ?? 0),
       label: inventoryLabel,
-      displayLabel: o?.displayLabel ?? `${displayPrefix}-${part}`,
+      displayLabel: seatDisplayLabel(row, i, placement, o),
       categoryKey: o?.categoryKey ?? row.categoryKey,
       skipped: !!o?.skip,
       accessible: accessibility.length > 0,
@@ -1411,39 +1469,7 @@ function stackFloors(doc, spread = 900) {
 }
 function expandFloorObjects(objects, zones, fallbackFocal, viewFallback) {
   const out = [];
-  const segmented = /* @__PURE__ */ new Map();
-  const grouped = /* @__PURE__ */ new Map();
-  for (const object of objects) {
-    if (object.type !== "row" || !object.segmentedRow) continue;
-    const list = grouped.get(object.segmentedRow.groupId) ?? [];
-    list.push(object);
-    grouped.set(object.segmentedRow.groupId, list);
-  }
-  for (const [groupId, members] of grouped) {
-    const ordered = members.slice().sort((left, right) => left.segmentedRow.componentIndex - right.segmentedRow.componentIndex);
-    const expectedCount = ordered[0]?.segmentedRow?.componentCount ?? 0;
-    const first = ordered[0]?.segmentedRow;
-    if (!first) continue;
-    const valid = expectedCount >= 2 && ordered.length === expectedCount && first?.boundaryBefore === "start" && ordered.every((row, index) => row.segmentedRow?.kind === "segmented-row-v1" && row.segmentedRow.groupId === groupId && row.segmentedRow.componentCount === expectedCount && row.segmentedRow.componentIndex === index && (index === 0 ? row.segmentedRow.boundaryBefore === "start" : row.segmentedRow.boundaryBefore !== "start") && row.segmentedRow.displayLabel === first.displayLabel);
-    if (!valid) continue;
-    const totalSeats = ordered.reduce((sum, row) => sum + row.seatCount, 0);
-    let adjacencyOffset = 0;
-    let displayOffset = 0;
-    for (const row of ordered) {
-      if (row.segmentedRow.boundaryBefore === "break") adjacencyOffset += 1;
-      segmented.set(row.id, {
-        groupId,
-        adjacencyOffset,
-        displayOffset,
-        displayLabel: first.displayLabel,
-        totalSeats,
-        canonical: ordered[0],
-        viewFromSeatUrl: first.viewFromSeatUrl
-      });
-      adjacencyOffset += row.seatCount;
-      displayOffset += row.seatCount;
-    }
-  }
+  const segmented = resolveSegmentedRowGroups(objects);
   for (const obj of objects) {
     let seats = [];
     if (obj.type === "row") seats = expandRow(obj);
@@ -1457,17 +1483,10 @@ function expandFloorObjects(objects, zones, fallbackFocal, viewFallback) {
         for (const seat of seats) {
           const physicalIndex = Number(seat.id.slice(seat.id.lastIndexOf(":") + 1));
           if (!Number.isInteger(physicalIndex)) continue;
-          const displayOrdinal = logical.displayOffset + physicalIndex;
           seat.logicalRowId = logical.groupId;
           seat.logicalSeatIndex = logical.adjacencyOffset + physicalIndex;
           if (!overrides2.get(physicalIndex)?.displayLabel) {
-            const numberingRow = {
-              ...logical.canonical,
-              seatCount: logical.totalSeats,
-              label: logical.displayLabel,
-              displayLabel: logical.displayLabel
-            };
-            seat.displayLabel = `${logical.displayLabel}-${seatLabelPart(numberingRow, displayOrdinal)}`;
+            seat.displayLabel = seatDisplayLabel(obj, physicalIndex, logical);
           }
           seat.viewUrl ??= logical.viewFromSeatUrl;
         }
@@ -2953,6 +2972,8 @@ var BLOCK_MELT_TOP = 0.9 * SEAT_LEGIBLE_SCALE;
 var SEAT_FOCUS_SCALE = Math.max(SEAT_LEGIBLE_SCALE * 1.1, BLOCK_MELT_TOP);
 var PAN_START_SLOP_PX = 8;
 var GHOST_CLICK_MS = 700;
+var ROW_LABEL_CLEARANCE = 2;
+var ROW_LABEL_COLLISION_CELL = 64;
 var ZONE_PROMINENT_SCALE = 0.55 * SECTION_PROMINENT_SCALE;
 var MAX_LABELS = 700;
 var MARQUEE_RING_CAP = 2500;
@@ -3039,6 +3060,44 @@ function opaqueColorHex(color) {
   if (channels.some((channel) => !Number.isInteger(channel) || channel < 0 || channel > 255)) return null;
   return `#${channels.map((channel) => channel.toString(16).padStart(2, "0")).join("")}`;
 }
+function worldBoxesOverlap(a, b) {
+  return a.x < b.x + b.width && b.x < a.x + a.width && a.y < b.y + b.height && b.y < a.y + a.height;
+}
+var WorldBoxIndex = class {
+  constructor() {
+    this.cells = /* @__PURE__ */ new Map();
+  }
+  insert(box) {
+    for (const key of this.keys(box)) {
+      const bucket = this.cells.get(key);
+      if (bucket) bucket.push(box);
+      else this.cells.set(key, [box]);
+    }
+  }
+  collisionCount(box) {
+    const seen = /* @__PURE__ */ new Set();
+    let count = 0;
+    for (const key of this.keys(box)) {
+      for (const existing of this.cells.get(key) ?? []) {
+        if (seen.has(existing)) continue;
+        seen.add(existing);
+        if (worldBoxesOverlap(box, existing)) count++;
+      }
+    }
+    return count;
+  }
+  keys(box) {
+    const x0 = Math.floor(box.x / ROW_LABEL_COLLISION_CELL);
+    const x1 = Math.floor((box.x + Math.max(0, box.width)) / ROW_LABEL_COLLISION_CELL);
+    const y0 = Math.floor(box.y / ROW_LABEL_COLLISION_CELL);
+    const y1 = Math.floor((box.y + Math.max(0, box.height)) / ROW_LABEL_COLLISION_CELL);
+    const keys = [];
+    for (let y = y0; y <= y1; y++) {
+      for (let x = x0; x <= x1; x++) keys.push(`${x}:${y}`);
+    }
+    return keys;
+  }
+};
 function overviewPalette(canvasBackground) {
   return isLightColor(canvasBackground) ? {
     sectionFill: LIGHT_OVERVIEW_SECTION_FILL,
@@ -3444,6 +3503,11 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.bounds = { x: 0, y: 0, width: 1, height: 1 };
     this.cached = false;
     this.dpr = Math.min(typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1, 2);
+    /** Current chart's buyer-visible image work. Failures are retained until ready(). */
+    this.assetGeneration = 0;
+    this.assetPromises = [];
+    this.assetErrors = [];
+    this.assetCancels = /* @__PURE__ */ new Set();
     this.rafId = 0;
     this.frames = 0;
     this.lastFpsAt = 0;
@@ -3611,7 +3675,10 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     };
     this.container = container;
     this.opts = { maxSelection: 10, selectableStatuses: ["free"], ...options };
+    this.exportMode = options.exportMode === true;
     this.currency = options.currency;
+    const previousPixelRatio = import_Core.Konva.pixelRatio;
+    if (this.exportMode) this.dpr = 1;
     import_Core.Konva.pixelRatio = this.dpr;
     this.stage = new import_Stage.Stage({
       container,
@@ -3620,19 +3687,21 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       draggable: false
       // pan/pinch are ours, via pointer events
     });
-    container.style.touchAction = "none";
-    container.addEventListener("pointerdown", this.onPointerDown, { passive: false });
-    container.addEventListener("pointermove", this.onPointerMove, { passive: false });
-    container.addEventListener("pointerup", this.onPointerEnd, { passive: false });
-    container.addEventListener("pointercancel", this.onPointerEnd, { passive: false });
-    if (container.tabIndex < 0) container.tabIndex = 0;
-    container.setAttribute("role", "application");
-    if (!container.getAttribute("aria-label")) {
-      container.setAttribute("aria-label", t("map.aria"));
-    }
-    container.addEventListener("keydown", this.onKeyDown);
-    this.bgLayer = new import_Layer.Layer({ listening: true });
-    this.seatLayer = new import_Layer.Layer({ listening: true });
+    if (!this.exportMode) {
+      container.style.touchAction = "none";
+      container.addEventListener("pointerdown", this.onPointerDown, { passive: false });
+      container.addEventListener("pointermove", this.onPointerMove, { passive: false });
+      container.addEventListener("pointerup", this.onPointerEnd, { passive: false });
+      container.addEventListener("pointercancel", this.onPointerEnd, { passive: false });
+      if (container.tabIndex < 0) container.tabIndex = 0;
+      container.setAttribute("role", "application");
+      if (!container.getAttribute("aria-label")) {
+        container.setAttribute("aria-label", t("map.aria"));
+      }
+      container.addEventListener("keydown", this.onKeyDown);
+    }
+    this.bgLayer = new import_Layer.Layer({ listening: !this.exportMode });
+    this.seatLayer = new import_Layer.Layer({ listening: !this.exportMode });
     this.overlayLayer = new import_Layer.Layer({ listening: false });
     this.labelGroup = new import_Group.Group({ listening: false });
     this.overlayLayer.add(this.labelGroup);
@@ -3662,12 +3731,15 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     });
     this.overlayLayer.add(this.focusRing);
     this.stage.add(this.bgLayer, this.seatLayer, this.overlayLayer);
-    this.wireInteraction();
-    this.startFpsLoop();
+    if (this.exportMode) import_Core.Konva.pixelRatio = previousPixelRatio;
+    if (!this.exportMode) {
+      this.wireInteraction();
+      this.startFpsLoop();
+    }
     if (false) {
       window.__seatmap = this;
     }
-    if (typeof ResizeObserver !== "undefined") {
+    if (!this.exportMode && typeof ResizeObserver !== "undefined") {
       this.resizeObs = new ResizeObserver(() => this.handleResize());
       this.resizeObs.observe(container);
     }
@@ -3690,6 +3762,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   // ---- ISeatmapRenderer -----------------------------------------------------
   setChart(doc, opts) {
     if (doc !== this.chartDoc) this.stacked = false;
+    this.cancelAssetLoads();
     this.chartDoc = doc;
     this.activeFloorId = opts?.floorId ?? floorsOf(doc)[0].id;
     this.objectFloor.clear();
@@ -3703,7 +3776,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.focusDimOverlay?.destroy();
     this.focusDimOverlay = null;
     this.seatLayer.clearCache();
-    this.seatLayer.listening(true);
+    this.seatLayer.listening(!this.exportMode);
     this.seatLayer.destroyChildren();
     this.unsectionedSeatGroup = null;
     this.labelGroup.destroyChildren();
@@ -3803,7 +3876,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.isoCentre = { x: this.bounds.x + this.bounds.width / 2, y: this.bounds.y + this.bounds.height / 2 };
     this.buildPerspectiveProjection(view);
     this.renderBackground(view);
-    this.unsectionedSeatGroup = new import_Group.Group({ listening: true });
+    this.unsectionedSeatGroup = new import_Group.Group({ listening: !this.exportMode });
     this.seatLayer.add(this.unsectionedSeatGroup);
     this.renderSeats();
     this.buildRowLabelPlan(view);
@@ -4438,9 +4511,9 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   paintGAStateForView() {
     for (const ga of this.gaById.values()) {
       const filteredOut = Boolean(this.categoryFilter && !this.categoryFilter.has(ga.categoryKey));
-      const overviewHidden = ga.sectionId != null && this.effScale() < CACHE_THRESHOLD;
+      const overviewHidden = !this.exportMode && ga.sectionId != null && this.effScale() < CACHE_THRESHOLD;
       ga.polygon.opacity(overviewHidden ? 0 : this.gaCategoryDimmed(ga.categoryKey) ? GA_FILL_OPACITY * 0.08 : GA_FILL_OPACITY);
-      ga.polygon.listening(!overviewHidden && !filteredOut);
+      ga.polygon.listening(!this.exportMode && !overviewHidden && !filteredOut);
     }
   }
   /** Frame the currently available inventory that survived a buyer price
@@ -4897,6 +4970,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   }
   destroy() {
     this.destroyed = true;
+    this.cancelAssetLoads();
     if (this.rafId) cancelAnimationFrame(this.rafId);
     if (this.isoRaf) cancelAnimationFrame(this.isoRaf);
     if (this.glideRaf) cancelAnimationFrame(this.glideRaf);
@@ -4913,6 +4987,9 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   // ---- rendering ------------------------------------------------------------
   /** Theme font stack for all rendered text (falls back to Inter). */
   labelFont() {
+    if (this.exportMode) {
+      return this.theme.fontFamily?.toLowerCase().includes("jetbrains") ? "JetBrains Mono, monospace" : "Inter, sans-serif";
+    }
     return this.theme.fontFamily || "Inter, sans-serif";
   }
   /**
@@ -4960,7 +5037,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
    *  rung. Overview caching always restores all groups first, so panning a
    *  cached whole-venue bitmap can never reveal missing inventory. */
   updateSeatGroupVisibility() {
-    const liveSeats = this.effScale() >= CACHE_THRESHOLD;
+    const liveSeats = this.exportMode || this.effScale() >= CACHE_THRESHOLD;
     const deferPerspectiveSeatReveal = this.viewMode === "perspective" && this.glideInProgress && this.seats.length > 2500;
     const padding = 96;
     const width = this.stage.width();
@@ -5597,11 +5674,67 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       }
     }
   }
+  /**
+   * Track an image through decode without ever leaving a rejected promise
+   * unobserved. Ordinary picker rendering remains best-effort; export ready()
+   * turns the retained failures into one actionable error.
+   */
+  trackAssetImage(image, source, label, onReady) {
+    const generation = this.assetGeneration;
+    if (/^https?:\/\//i.test(source)) image.crossOrigin = "anonymous";
+    const work = new Promise((resolve) => {
+      let settled = false;
+      const finish = () => {
+        if (settled) return;
+        settled = true;
+        this.assetCancels.delete(cancel);
+        resolve();
+      };
+      const cancel = () => {
+        image.onload = null;
+        image.onerror = null;
+        try {
+          image.removeAttribute("src");
+          image.src = "";
+        } catch {
+        }
+        finish();
+      };
+      this.assetCancels.add(cancel);
+      image.onload = () => {
+        if (!this.exportMode) {
+          if (generation === this.assetGeneration) onReady();
+          finish();
+          return;
+        }
+        const decoded = typeof image.decode === "function" ? image.decode() : Promise.resolve();
+        void decoded.then(() => {
+          if (generation === this.assetGeneration) onReady();
+        }).catch(() => {
+          if (generation === this.assetGeneration) this.assetErrors.push(`${label} could not be decoded.`);
+        }).finally(finish);
+      };
+      image.onerror = () => {
+        if (generation === this.assetGeneration) this.assetErrors.push(`${label} could not be loaded.`);
+        finish();
+      };
+      image.src = source;
+    });
+    this.assetPromises.push(work);
+  }
+  /** Cancel and release every image retained by the previous chart/export. */
+  cancelAssetLoads() {
+    this.assetGeneration++;
+    for (const cancel of [...this.assetCancels]) cancel();
+    this.assetCancels.clear();
+    this.assetPromises = [];
+    this.assetErrors = [];
+  }
   /** Organizer floor-plan photo, dimmed, at the very bottom of the bg layer. */
   renderBackgroundImage(bg) {
     if (!bg.url || bg.visible === false) return;
     const img = new window.Image();
-    img.onload = () => {
+    this.trackAssetImage(img, bg.url, "Buyer background image", () => {
       const natW = img.naturalWidth || 4;
       const natH = img.naturalHeight || 3;
       const rawCrop = bg.crop ?? { x: 0, y: 0, width: 1, height: 1 };
@@ -5636,8 +5769,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       this.bgLayer.add(node);
       node.moveToBottom();
       this.bgLayer.batchDraw();
-    };
-    img.src = bg.url;
+    });
   }
   /**
    * A decor graphic (rink / court / stage art). The KImage node is added to the
@@ -5663,12 +5795,11 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     });
     if (obj.layer === "foreground") this.fgDecorGroup.add(node);
     else this.bgLayer.add(node);
-    img.onload = () => {
+    this.trackAssetImage(img, obj.href, `Decor image \u201C${obj.label || obj.id}\u201D`, () => {
       const layer = node.getLayer();
       if (!layer) return;
       layer.batchDraw();
-    };
-    img.src = obj.href;
+    });
   }
   renderTable(obj) {
     if (obj.shape === "round") {
@@ -7331,6 +7462,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   }
   /** rAF-coalesced `onViewChange` — at most one host callback per animation frame. */
   scheduleViewChange() {
+    if (this.exportMode) return;
     if (this.viewChangeRaf) return;
     this.viewChangeRaf = requestAnimationFrame(() => {
       this.viewChangeRaf = 0;
@@ -7338,7 +7470,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     });
   }
   updateLOD() {
-    const scale = this.effScale();
+    const scale = this.exportMode ? Math.max(this.effScale(), BLOCK_MELT_TOP + 0.01, LABEL_SCALE) : this.effScale();
     const focalScale = Math.max(scale, 1e-4);
     for (const [label, targetPx] of this.primaryFocalLabels) {
       this.sizeLabel(label, targetPx / focalScale, label.y());
@@ -7347,7 +7479,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     else if (this.primaryFocalLabels.size) this.bgLayer.batchDraw();
     this.paintGAStateForView();
     this.updateAccessGlyphs(scale);
-    const shouldCache = scale < CACHE_THRESHOLD;
+    const shouldCache = !this.exportMode && scale < CACHE_THRESHOLD;
     const suppressPerspectiveSeatCache = this.viewMode === "perspective" && this.hasSections && this.seats.length > 2500 && shouldCache;
     if (suppressPerspectiveSeatCache) {
       this.seatLayer.listening(false);
@@ -7357,7 +7489,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       this.cacheSeatLayer();
     } else if (!shouldCache && (this.cached || !this.seatLayer.listening())) {
       if (this.cached) this.releaseSeatLayerBitmap();
-      this.seatLayer.listening(true);
+      this.seatLayer.listening(!this.exportMode);
       this.cached = false;
       this.seatLayer.batchDraw();
     }
@@ -7425,8 +7557,103 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.seatLayer.draw();
     this.overlayLayer.draw();
   }
+  /**
+   * Resolve every buyer-visible image requested by the current chart. Export
+   * callers get a hard error with the affected layer name; the interactive
+   * renderer never calls this and retains its existing best-effort behaviour.
+   */
+  async ready() {
+    const generation = this.assetGeneration;
+    const fontSet = typeof document !== "undefined" && "fonts" in document ? document.fonts : null;
+    await Promise.all([
+      ...this.assetPromises.slice(),
+      ...fontSet ? [
+        fontSet.ready.then(() => void 0),
+        fontSet.load("700 24px Inter").then(() => void 0),
+        fontSet.load('600 12px "JetBrains Mono"').then(() => void 0)
+      ] : []
+    ]);
+    if (generation !== this.assetGeneration) {
+      throw new Error("The chart changed while its export assets were loading.");
+    }
+    if (this.assetErrors.length) {
+      throw new Error(`Export stopped because ${this.assetErrors.join(" ")}`);
+    }
+    if (this.exportMode) {
+      this.fitExportContent();
+      this.forceDraw();
+    }
+  }
+  /** Exact visible scene bounds in chart coordinates after fonts/assets exist. */
+  exportSceneBounds() {
+    const rects = [this.bgLayer, this.seatLayer, this.overlayLayer].map((layer) => layer.getClientRect({ relativeTo: this.stage })).filter((rect) => rect.width > 0 && rect.height > 0);
+    if (!rects.length) return this.bounds;
+    const minX = Math.min(...rects.map((rect) => rect.x));
+    const minY = Math.min(...rects.map((rect) => rect.y));
+    const maxX = Math.max(...rects.map((rect) => rect.x + rect.width));
+    const maxY = Math.max(...rects.map((rect) => rect.y + rect.height));
+    return {
+      x: minX,
+      y: minY,
+      width: Math.max(1, maxX - minX),
+      height: Math.max(1, maxY - minY)
+    };
+  }
+  /** Fit exact rendered nodes, including rotated text/decor, with pixel padding. */
+  fitExportContent() {
+    if (!this.exportMode) return;
+    const width = this.stage.width();
+    const height = this.stage.height();
+    const padding = Math.max(12, Math.min(36, Math.min(width, height) * 0.025));
+    const fit = () => {
+      const bounds2 = this.exportSceneBounds();
+      const availableWidth = Math.max(1, width - padding * 2);
+      const availableHeight = Math.max(1, height - padding * 2);
+      const scale = Math.min(availableWidth / bounds2.width, availableHeight / bounds2.height) || 1;
+      this.fitScale = scale;
+      this.stage.scale({ x: scale, y: scale });
+      this.stage.position({
+        x: (width - bounds2.width * scale) / 2 - bounds2.x * scale,
+        y: (height - bounds2.height * scale) / 2 - bounds2.y * scale
+      });
+      this.afterViewChange();
+    };
+    fit();
+    fit();
+  }
+  /**
+   * Capture a clean, opaque fixed-size canvas. The CSS host background is
+   * painted explicitly because Konva layers themselves are transparent.
+   */
+  captureCanvas() {
+    if (!this.exportMode) {
+      throw new Error("captureCanvas() is available only on a renderer created with exportMode.");
+    }
+    this.forceDraw();
+    let scene;
+    try {
+      scene = this.stage.toCanvas({ pixelRatio: 1, imageSmoothingEnabled: true });
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      throw new Error(`The chart canvas could not be captured. A buyer-visible image may block export. ${detail}`);
+    }
+    const canvas = document.createElement("canvas");
+    canvas.width = this.stage.width();
+    canvas.height = this.stage.height();
+    const context = canvas.getContext("2d");
+    if (!context) throw new Error("Canvas 2D is unavailable; this browser cannot create an export.");
+    context.fillStyle = this.canvasBackground;
+    context.fillRect(0, 0, canvas.width, canvas.height);
+    try {
+      context.drawImage(scene, 0, 0);
+    } finally {
+      scene.width = 1;
+      scene.height = 1;
+    }
+    return canvas;
+  }
   updateFreeTextVisibility() {
-    const effectiveScale = this.effScale();
+    const effectiveScale = this.exportMode ? Math.max(this.effScale(), LABEL_SCALE) : this.effScale();
     for (const { objectId, node, categoryKey, kind } of this.freeTextById.values()) {
       const gaDimmed = categoryKey != null && (kind === "ga-label" || kind === "ga-capacity") && this.gaCategoryDimmed(categoryKey);
       const gaOverviewHidden = objectId != null && (kind === "ga-label" || kind === "ga-capacity") && this.gaById.get(objectId)?.sectionId != null && effectiveScale < CACHE_THRESHOLD;
@@ -7471,19 +7698,90 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       const rotation = presentation?.rotation ?? 0;
       const text = obj.segmentedRow?.displayLabel ?? obj.displayLabel ?? obj.label;
       const opacity = this.objectFilteredOut(obj) ? 0.15 : 1;
-      const push = (x, y) => this.rowLabelPlan.push({ text, x, y, rotation, fontSize, ink, opacity });
+      const push = (x, y, automaticAway) => this.rowLabelPlan.push({
+        text,
+        x,
+        y,
+        rotation,
+        fontSize,
+        ink,
+        opacity,
+        ...automaticAway ? { automaticAway } : {}
+      });
       if (presentation?.position) {
         push(presentation.position.x, presentation.position.y);
         continue;
       }
-      const radians = obj.rotation * Math.PI / 180;
-      const along = { x: Math.cos(radians), y: Math.sin(radians) };
       const gap = this.seatR + 12;
       const preset = presentation?.positionPreset ?? "start";
-      if (preset === "start" || preset === "both") push(first.x - along.x * gap, first.y - along.y * gap);
-      if (preset === "end" || preset === "both") push(last.x + along.x * gap, last.y + along.y * gap);
+      if (preset === "start" || preset === "both") {
+        const radians = obj.rotation * Math.PI / 180;
+        const away = { x: -Math.cos(radians), y: -Math.sin(radians) };
+        push(first.x + away.x * gap, first.y + away.y * gap, away);
+      }
+      if (preset === "end" || preset === "both") {
+        const radians = (obj.rotation + obj.curve) * Math.PI / 180;
+        const away = { x: Math.cos(radians), y: Math.sin(radians) };
+        push(last.x + away.x * gap, last.y + away.y * gap, away);
+      }
     }
   }
+  /** Axis-aligned world bounds of a centred, potentially rotated row label. */
+  rowLabelBox(label, position, padding = ROW_LABEL_CLEARANCE) {
+    const radians = label.rotation() * Math.PI / 180;
+    const cos = Math.abs(Math.cos(radians));
+    const sin = Math.abs(Math.sin(radians));
+    const halfWidth = (label.width() * cos + label.height() * sin) / 2 + padding;
+    const halfHeight = (label.width() * sin + label.height() * cos) / 2 + padding;
+    return {
+      x: position.x - halfWidth,
+      y: position.y - halfHeight,
+      width: halfWidth * 2,
+      height: halfHeight * 2
+    };
+  }
+  /**
+   * Keep an automatic start/end label out of seat markers and already-painted
+   * text. The authored point is never altered. Candidates are deliberately
+   * bounded and deterministic: the closest clear offset wins; if a chart is so
+   * dense that none is clear, the least-colliding candidate wins so the required
+   * row label remains present rather than being silently dropped.
+   */
+  resolveAutomaticRowLabelPosition(label, plan, occupiedText) {
+    const base = { x: plan.x, y: plan.y };
+    const away = plan.automaticAway;
+    if (!away) return base;
+    const normal = { x: -away.y, y: away.x };
+    const step = Math.max(7, Math.min(16, plan.fontSize * 0.75));
+    const offsets = [{ x: 0, y: 0 }];
+    for (let ring = 1; ring <= 4; ring++) {
+      const distance = step * ring;
+      offsets.push(
+        { x: normal.x * distance, y: normal.y * distance },
+        { x: -normal.x * distance, y: -normal.y * distance },
+        { x: away.x * distance, y: away.y * distance },
+        { x: (away.x + normal.x) * distance, y: (away.y + normal.y) * distance },
+        { x: (away.x - normal.x) * distance, y: (away.y - normal.y) * distance }
+      );
+    }
+    let best = base;
+    let bestCollisions = Infinity;
+    let bestDistance = Infinity;
+    for (const offset of offsets) {
+      const candidate = { x: base.x + offset.x, y: base.y + offset.y };
+      const box = this.rowLabelBox(label, candidate);
+      const seatCollisions = this.seatIndex ? queryRect(this.seatIndex, box, { mode: "overlap" }).length : 0;
+      const collisions = seatCollisions + occupiedText.collisionCount(box);
+      const distance = Math.hypot(offset.x, offset.y);
+      if (collisions < bestCollisions || collisions === bestCollisions && distance < bestDistance) {
+        best = candidate;
+        bestCollisions = collisions;
+        bestDistance = distance;
+      }
+      if (collisions === 0) break;
+    }
+    return best;
+  }
   /** Row labels never carry status; the buyer just dims them under the same
    *  category/price filters that dim their seats. */
   objectFilteredOut(obj) {
@@ -7492,7 +7790,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     return Boolean(this.categoryHighlight && key !== this.categoryHighlight || this.categoryFilter && !this.categoryFilter.has(key));
   }
   updateLabels() {
-    const effectiveScale = this.effScale();
+    const effectiveScale = this.exportMode ? Math.max(this.effScale(), LABEL_SCALE) : this.effScale();
     const show = effectiveScale >= LABEL_SCALE;
     for (const [id, label] of this.boothLabelById) {
       const shape = this.circleById.get(id);
@@ -7583,6 +7881,21 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       this.seatLabelById.set(seat.id, t2);
       if (++count >= MAX_LABELS) break;
     }
+    const occupiedText = new WorldBoxIndex();
+    for (const { node } of this.freeTextById.values()) {
+      if (!node.isVisible()) continue;
+      const box = node.getClientRect({
+        relativeTo: this.bgLayer,
+        skipShadow: true,
+        skipStroke: true
+      });
+      occupiedText.insert({
+        x: box.x - ROW_LABEL_CLEARANCE,
+        y: box.y - ROW_LABEL_CLEARANCE,
+        width: box.width + ROW_LABEL_CLEARANCE * 2,
+        height: box.height + ROW_LABEL_CLEARANCE * 2
+      });
+    }
     for (const rl of this.rowLabelPlan) {
       const screen = this.worldToScreen({ x: rl.x, y: rl.y });
       if (screen.x < -40 || screen.x > this.stage.width() + 40 || screen.y < -40 || screen.y > this.stage.height() + 40) continue;
@@ -7605,6 +7918,10 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       });
       t2.offsetX(t2.width() / 2);
       t2.offsetY(t2.height() / 2);
+      const resolved = this.resolveAutomaticRowLabelPosition(t2, rl, occupiedText);
+      t2.position(resolved);
+      t2.setAttr("rowLabel", true);
+      occupiedText.insert(this.rowLabelBox(t2, resolved));
       this.labelGroup.add(t2);
     }
     if (this.isoT > 0 && this.viewMode !== "perspective") this.applyUprightLabels();
@@ -9208,7 +9525,8 @@ var PickerController = class {
     if (!url) return;
     let ws;
     try {
-      ws = new WebSocket(url);
+      const protocols = this.api.socketProtocols?.(this.key);
+      ws = protocols && protocols.length ? new WebSocket(url, protocols) : new WebSocket(url);
     } catch {
       this.scheduleReconnect();
       return;
@@ -10520,7 +10838,6 @@ async function loadLocale(code) {
   rowInventoryCount,
   rowSeatPositions,
   seatCommercialMeta,
-  seatLabelPart,
   sectionGeometry,
   setLocale,
   setMoneyLocale,