@seatlayer/core 0.26.0 → 0.27.0

package/dist/index.cjs

@@ -48,6 +48,7 @@ var init_es = __esm({
       // renderer (drawn on the Konva map — shared by the embed SDK)
       "map.aria": "Mapa de asientos. Usa las flechas para moverte entre asientos, Intro para seleccionar.",
       "map.seatsLeft": "{count} LIBRES",
+      "map.soldOut": "AGOTADO",
       "map.statusHeld": "En espera",
       "map.statusTaken": "Ocupado",
       "map.fromPrice": "DESDE {price}",
@@ -55,7 +56,7 @@ var init_es = __esm({
       "picker.floor": "Piso",
       "picker.zoomLevel": "Nivel de zoom",
       "picker.rungTip.zones": "Vista general \u2014 grupos de secciones como Grada norte o VIP",
-      "picker.rungTip.sections": "Bloques de secci\xF3n \u2014 mezcla de categor\xEDas + matiz de disponibilidad",
+      "picker.rungTip.sections": "Bloques de secci\xF3n \u2014 las secciones agotadas y casi llenas se aten\xFAan para ver la disponibilidad de un vistazo",
       "picker.rungTip.seats": "Asientos individuales \u2014 los bloques se convierten en puntos",
       "picker.rungLabel.zones": "ZONAS",
       "picker.rungLabel.sections": "SECCIONES",
@@ -107,6 +108,7 @@ var init_de = __esm({
       // renderer (drawn on the Konva map — shared by the embed SDK)
       "map.aria": "Sitzplan. Mit Pfeiltasten zwischen Pl\xE4tzen navigieren, Eingabe zum Ausw\xE4hlen.",
       "map.seatsLeft": "{count} FREI",
+      "map.soldOut": "AUSVERKAUFT",
       "map.statusHeld": "Reserviert",
       "map.statusTaken": "Vergeben",
       "map.fromPrice": "AB {price}",
@@ -114,7 +116,7 @@ var init_de = __esm({
       "picker.floor": "Etage",
       "picker.zoomLevel": "Zoomstufe",
       "picker.rungTip.zones": "\xDCbersicht \u2014 Bereichsgruppen wie Nordtrib\xFCne oder VIP",
-      "picker.rungTip.sections": "Bereichs-Bl\xF6cke \u2014 Kategoriesortierung + Verf\xFCgbarkeitst\xF6nung",
+      "picker.rungTip.sections": "Bereichs-Bl\xF6cke \u2014 ausverkaufte und fast volle Bereiche werden abgedunkelt, um die Verf\xFCgbarkeit auf einen Blick zu zeigen",
       "picker.rungTip.seats": "Einzelne Pl\xE4tze \u2014 Bl\xF6cke l\xF6sen sich zu Punkten auf",
       "picker.rungLabel.zones": "ZONEN",
       "picker.rungLabel.sections": "BEREICHE",
@@ -166,6 +168,7 @@ var init_fr = __esm({
       // renderer (drawn on the Konva map — shared by the embed SDK)
       "map.aria": "Plan de salle. Utilisez les fl\xE8ches pour naviguer entre les si\xE8ges, Entr\xE9e pour s\xE9lectionner.",
       "map.seatsLeft": "{count} LIBRES",
+      "map.soldOut": "COMPLET",
       "map.statusHeld": "En attente",
       "map.statusTaken": "Pris",
       "map.fromPrice": "D\xC8S {price}",
@@ -173,7 +176,7 @@ var init_fr = __esm({
       "picker.floor": "\xC9tage",
       "picker.zoomLevel": "Niveau de zoom",
       "picker.rungTip.zones": "Vue g\xE9n\xE9rale \u2014 groupes de sections comme Tribune nord ou VIP",
-      "picker.rungTip.sections": "Blocs de sections \u2014 m\xE9lange de cat\xE9gories + teinte de disponibilit\xE9",
+      "picker.rungTip.sections": "Blocs de sections \u2014 les sections compl\xE8tes ou presque pleines sont estomp\xE9es pour voir la disponibilit\xE9 en un coup d\u2019\u0153il",
       "picker.rungTip.seats": "Si\xE8ges individuels \u2014 les blocs se transforment en points",
       "picker.rungLabel.zones": "ZONES",
       "picker.rungLabel.sections": "SECTIONS",
@@ -1823,6 +1826,169 @@ function buyerBackgroundImage(owner) {
   return background?.url && !background.assetId ? background : void 0;
 }
 
+// src/core/icons.ts
+var VENUE_ICON_VIEWBOX = 24;
+var VENUE_ICON_STROKE = 2;
+var WHEELCHAIR = "M13 4.6a1.6 1.6 0 1 0-3.2 0 1.6 1.6 0 0 0 3.2 0 M11 6.5V13h5l2.4 6 M15 16.4A5 5 0 1 1 9 11.3";
+var VENUE_ICONS = [
+  // ---- Facilities --------------------------------------------------------
+  {
+    key: "restroom-men",
+    label: "Men's restroom",
+    group: "facilities",
+    path: "M16 7a4 4 0 1 0-8 0 4 4 0 0 0 8 0 M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"
+  },
+  {
+    key: "restroom-women",
+    label: "Women's restroom",
+    group: "facilities",
+    path: "M15 5a3 3 0 1 0-6 0 3 3 0 0 0 6 0 M12 8l-4 10h8l-4-10 M10 18v4 M14 18v4"
+  },
+  {
+    key: "restroom-accessible",
+    label: "Accessible restroom",
+    group: "facilities",
+    path: WHEELCHAIR
+  },
+  {
+    key: "first-aid",
+    label: "First aid",
+    group: "facilities",
+    path: "M5 4h14a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1Z M12 8v8 M8 12h8"
+  },
+  {
+    key: "coat-check",
+    label: "Coat check",
+    group: "facilities",
+    path: "M12 6a2 2 0 0 1 0-4 2 2 0 0 1 1.6 3.2L21 13H3l8.4-7.8 M3 13h18"
+  },
+  {
+    key: "atm",
+    label: "ATM / cash",
+    group: "facilities",
+    path: "M2 6h20v12H2V6Z M15 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0 M6 9h.01 M18 15h.01"
+  },
+  {
+    key: "info",
+    label: "Info point",
+    group: "facilities",
+    path: "M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18 M12 11v5 M12 8h.01"
+  },
+  {
+    key: "lost-found",
+    label: "Lost & found",
+    group: "facilities",
+    path: "M11 4a7 7 0 1 0 0 14 7 7 0 0 0 0-14 M16 16l5 5 M9 8.5a2 2 0 1 1 3 1.7c-.8.5-1 .8-1 1.8 M11 15h.01"
+  },
+  {
+    key: "charging",
+    label: "Charging point",
+    group: "facilities",
+    path: "M3 8h13v8H3V8Z M16 10h3v4h-3 M9.6 9l-2 3.5h2.5l-1.5 3"
+  },
+  {
+    key: "smoking",
+    label: "Smoking area",
+    group: "facilities",
+    path: "M2 15h13v3H2v-3Z M18 16h2 M19 8c0 1 1 1.5 1 2.5S19 12 19 13"
+  },
+  {
+    key: "no-smoking",
+    label: "No smoking",
+    group: "facilities",
+    path: "M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18 M5.6 5.6l12.8 12.8 M7 13h6v2H7v-2Z"
+  },
+  // ---- Food & drink ------------------------------------------------------
+  {
+    key: "food",
+    label: "Food",
+    group: "food-drink",
+    path: "M7 3v6a2 2 0 0 0 4 0V3 M9 11v10 M17 3c-1.6 1-2.2 3-2.2 6 0 2 .9 3.2 2.2 3.6V21"
+  },
+  {
+    key: "bar",
+    label: "Bar",
+    group: "food-drink",
+    path: "M4 5h16l-8 8-8-8Z M12 13v6 M8 20h8"
+  },
+  {
+    key: "coffee",
+    label: "Caf\xE9 / coffee",
+    group: "food-drink",
+    path: "M4 8h13v4a5 5 0 0 1-5 5H9a5 5 0 0 1-5-5V8Z M17 9h2a2 2 0 0 1 0 4h-2 M8 2v2 M11 2v2 M4 21h14"
+  },
+  {
+    key: "water",
+    label: "Water / drinks",
+    group: "food-drink",
+    path: "M12 22a7 7 0 0 1-7-7c0-5 7-12 7-12s7 7 7 12a7 7 0 0 1-7 7Z"
+  },
+  {
+    key: "merch",
+    label: "Merch / shop",
+    group: "food-drink",
+    path: "M6 8h12l-1 12H7L6 8Z M9 8V6a3 3 0 0 1 6 0v2"
+  },
+  // ---- Getting around ----------------------------------------------------
+  {
+    key: "entrance",
+    label: "Entrance",
+    group: "navigation",
+    path: "M14 3h5a1 1 0 0 1 1 1v16a1 1 0 0 1-1 1h-5 M3 12h11 M10 8l4 4-4 4"
+  },
+  {
+    key: "exit",
+    label: "Exit",
+    group: "navigation",
+    path: "M10 3H5a1 1 0 0 0-1 1v16a1 1 0 0 0 1 1h5 M14 12h7 M17 8l4 4-4 4"
+  },
+  {
+    key: "emergency-exit",
+    label: "Emergency exit",
+    group: "navigation",
+    path: "M14 4.6a1.5 1.5 0 1 0-3 0 1.5 1.5 0 0 0 3 0 M12.5 8l-3.5 2 1.6 3.6-2 4.4 M12.5 10l3.5 1.5 M9 10.5l-3.5 1 M15 12h6 M18 9l3 3-3 3"
+  },
+  {
+    key: "stairs",
+    label: "Stairs",
+    group: "navigation",
+    path: "M3 20v-4h4v-4h4v-4h4V4h5"
+  },
+  {
+    key: "elevator",
+    label: "Elevator",
+    group: "navigation",
+    path: "M5 3h14a1 1 0 0 1 1 1v16a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1Z M8 11l1.5-2 1.5 2 M8 14l1.5 2 1.5-2 M15 8v8"
+  },
+  {
+    key: "parking",
+    label: "Parking",
+    group: "navigation",
+    path: "M5 3h14a1 1 0 0 1 1 1v16a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1Z M9 17V7h4a3 3 0 0 1 0 6H9"
+  },
+  // ---- Accessibility -----------------------------------------------------
+  {
+    key: "wheelchair",
+    label: "Wheelchair access",
+    group: "accessibility",
+    path: WHEELCHAIR
+  },
+  {
+    key: "hearing",
+    label: "Hearing assistance",
+    group: "accessibility",
+    path: "M8 20a4 4 0 0 1-2-3c0-1 .5-2 .5-3a4.5 4.5 0 1 1 9 0c0 1.4-1 2-2 2.4-1.2.5-1.5 1-1.5 2.2 M17 6a5 5 0 0 1 1 6 M19.5 4a8 8 0 0 1 1.2 9"
+  }
+];
+var BY_KEY = new Map(VENUE_ICONS.map((icon) => [icon.key, icon]));
+function venueIcon(key) {
+  return key ? BY_KEY.get(key) : void 0;
+}
+function venueIconPath(key) {
+  return venueIcon(key)?.path;
+}
+var VENUE_ICON_KEYS = VENUE_ICONS.map((icon) => icon.key);
+
 // src/core/spatialIndex.ts
 var DEFAULT_SEAT_RADIUS = 9;
 function halfExtents(shape) {
@@ -2160,6 +2326,7 @@ var en = {
   // renderer (drawn on the Konva map — shared by the embed SDK)
   "map.aria": "Seating map. Use arrow keys to move between seats, Enter to select.",
   "map.seatsLeft": "{count} LEFT",
+  "map.soldOut": "SOLD OUT",
   "map.fromPrice": "FROM {price}",
   "map.statusHeld": "On hold",
   "map.statusTaken": "Taken",
@@ -2167,7 +2334,7 @@ var en = {
   "picker.floor": "Floor",
   "picker.zoomLevel": "Zoom level",
   "picker.rungTip.zones": "Venue overview \u2014 groups of sections such as North Stand or VIP",
-  "picker.rungTip.sections": "Section blocks \u2014 category-mix fill + availability tint",
+  "picker.rungTip.sections": "Section blocks \u2014 sold-out and nearly-gone sections shade to show availability at a glance",
   "picker.rungTip.seats": "Individual seats \u2014 blocks melt into dots",
   "picker.rungLabel.zones": "ZONES",
   "picker.rungLabel.sections": "SECTIONS",
@@ -2368,6 +2535,22 @@ function overviewPalette(canvasBackground) {
     focalStroke: DARK_OVERVIEW_FOCAL_STROKE
   };
 }
+var SECTION_NEARLY_GONE_RATIO = 0.1;
+function overviewStateFill(palette, state) {
+  const base = palette.sectionFill;
+  const soldOut = desaturate(darken(base, 0.2), 0.85);
+  switch (state) {
+    case "closed":
+      return darken(base, 0.12);
+    case "sold-out":
+      return soldOut;
+    case "nearly-gone":
+      return lerpColor(base, soldOut, 0.4);
+    case "normal":
+    default:
+      return base;
+  }
+}
 var clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
 function seatIdOf(target) {
   const n = target;
@@ -2390,6 +2573,13 @@ function darken(hex, amt) {
   const mix = (c) => Math.round(c * (1 - amt));
   return `#${(1 << 24 | mix(n >> 16 & 255) << 16 | mix(n >> 8 & 255) << 8 | mix(n & 255)).toString(16).slice(1)}`;
 }
+function desaturate(hex, amt) {
+  const rgb2 = hexToRgb(hex);
+  if (!rgb2) return hex;
+  const [r, g, b] = rgb2;
+  const grey = 0.299 * r + 0.587 * g + 0.114 * b;
+  return toHex(r + (grey - r) * amt, g + (grey - g) * amt, b + (grey - b) * amt);
+}
 function polyBounds(pts) {
   let minX = Infinity;
   let minY = Infinity;
@@ -2453,18 +2643,36 @@ function polygonLabelCandidates(outer, holes, preferred) {
   }
   return points.sort((left, right) => Math.hypot(left.x - centre.x, left.y - centre.y) - Math.hypot(right.x - centre.x, right.y - centre.y)).filter((point, index, all) => index === all.findIndex((other) => Math.abs(other.x - point.x) < 1e-6 && Math.abs(other.y - point.y) < 1e-6));
 }
+function roundedPolygonSubpath(context, points, radius) {
+  const n = points.length;
+  const start = { x: (points[n - 1].x + points[0].x) / 2, y: (points[n - 1].y + points[0].y) / 2 };
+  context.moveTo(start.x, start.y);
+  for (let i = 0; i < n; i += 1) {
+    const curr = points[i];
+    const next = points[(i + 1) % n];
+    const prev = points[(i - 1 + n) % n];
+    const rMax = Math.min(
+      Math.hypot(curr.x - prev.x, curr.y - prev.y) / 2,
+      Math.hypot(next.x - curr.x, next.y - curr.y) / 2
+    );
+    context.arcTo(curr.x, curr.y, next.x, next.y, Math.max(0, Math.min(radius, rMax)));
+  }
+  context.closePath();
+}
 function polygonWithHolesShape(outer, holes, attrs, outerPath) {
   const signedArea = (points) => points.reduce((sum, point, index) => {
     const next = points[(index + 1) % points.length];
     return sum + point.x * next.y - next.x * point.y;
   }, 0);
   const outerClockwise = signedArea(outer) > 0;
+  const cornerRadius = attrs.cornerRadius && attrs.cornerRadius > 0 ? attrs.cornerRadius : 0;
   return new import_Shape.Shape({
     ...attrs,
     sceneFunc(context, shape) {
       context.beginPath();
       const polygonPath = (points) => {
         if (!points.length) return;
+        if (cornerRadius > 0 && points.length >= 3) return roundedPolygonSubpath(context, points, cornerRadius);
         context.moveTo(points[0].x, points[0].y);
         for (let index = 1; index < points.length; index += 1) context.lineTo(points[index].x, points[index].y);
         context.closePath();
@@ -2599,6 +2807,8 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.accessGlyphById = /* @__PURE__ */ new Map();
     /** Authored free-text nodes obey the same rendered-size visibility floor. */
     this.freeTextById = /* @__PURE__ */ new Map();
+    /** Vector venue-icon Path nodes + authored size; obey the free-text size floor. */
+    this.iconNodeById = /* @__PURE__ */ new Map();
     /** Stage/rink landmarks retain a readable screen-space caption at overview. */
     this.primaryFocalLabels = /* @__PURE__ */ new Map();
     /** GA paint and text share price/highlight filter state. */
@@ -2612,6 +2822,12 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.effSelection = DEF_SELECTION;
     /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
     this.colorblind = false;
+    /** Stable per-category-KEY colorblind hue (OV-46) — order-independent. */
+    this.cbHueByKey = /* @__PURE__ */ new Map();
+    /** OV-45(a): authored row-letter labels for the buyer/preview map, resolved in
+     *  world space (matching seat labels) and honouring each row's labelPresentation
+     *  (position/rotation/visibility/style). Painted at the seats LOD rung. */
+    this.rowLabelPlan = [];
     /** Category order from the doc — the stable index into the CB palette. */
     this.catOrder = [];
     this.selection = /* @__PURE__ */ new Set();
@@ -2981,6 +3197,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.accessRingById.clear();
     this.accessGlyphById.clear();
     this.freeTextById.clear();
+    this.iconNodeById.clear();
     this.primaryFocalLabels.clear();
     this.gaById.clear();
     for (const marker of this.selectionMarkers.values()) marker.destroy();
@@ -3035,13 +3252,22 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.catColor.clear();
     this.catPrice.clear();
     this.catOrder = doc.categories.map((c) => c.key);
+    this.cbHueByKey.clear();
+    [...this.catOrder].sort().forEach((key, i) => {
+      this.cbHueByKey.set(key, CB_PALETTE[i % CB_PALETTE.length]);
+    });
     for (const c of doc.categories) {
       this.catColor.set(c.key, c.color);
       if (typeof c.price === "number") this.catPrice.set(c.key, c.price);
     }
     for (const obj of view.objects) {
       if (obj.type === "booth") {
-        this.boothDims.set(obj.id, { width: obj.width, height: obj.height, rotation: obj.rotation });
+        this.boothDims.set(obj.id, {
+          width: obj.width,
+          height: obj.height,
+          rotation: obj.rotation,
+          ...obj.points && obj.points.length >= 3 ? { points: obj.points.map((p) => ({ x: p.x, y: p.y })) } : {}
+        });
       }
     }
     this.seats = expandChart(view, {
@@ -3061,6 +3287,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.unsectionedSeatGroup = new import_Group.Group({ listening: true });
     this.seatLayer.add(this.unsectionedSeatGroup);
     this.renderSeats();
+    this.buildRowLabelPlan(view);
     this.overlayLayer.add(this.labelGroup);
     this.overlayLayer.add(this.fgDecorGroup);
     this.overlayLayer.add(this.hoverRing);
@@ -4372,25 +4599,42 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   renderBoothUnit(seat) {
     const target = this.seatContainer(seat.id);
     const dims = this.boothDims.get(seat.rowId) ?? { width: 40, height: 30, rotation: 0 };
-    const rect = new import_Rect.Rect({
-      x: seat.x,
-      y: seat.y,
-      width: dims.width,
-      height: dims.height,
-      offsetX: dims.width / 2,
-      offsetY: dims.height / 2,
-      rotation: dims.rotation,
-      cornerRadius: 4,
-      perfectDrawEnabled: false,
-      shadowForStrokeEnabled: false,
-      hitStrokeWidth: 0
-    });
-    rect.setAttr("seatId", seat.id);
-    this.circleById.set(seat.id, rect);
-    target.add(rect);
+    let labelX = seat.x;
+    let labelY = seat.y;
+    let node;
+    if (dims.points && dims.points.length >= 3) {
+      node = new import_Line.Line({
+        x: seat.x,
+        y: seat.y,
+        points: dims.points.flatMap((p) => [p.x, p.y]),
+        closed: true,
+        perfectDrawEnabled: false,
+        shadowForStrokeEnabled: false,
+        hitStrokeWidth: 0
+      });
+      labelX = seat.x + dims.points.reduce((a, p) => a + p.x, 0) / dims.points.length;
+      labelY = seat.y + dims.points.reduce((a, p) => a + p.y, 0) / dims.points.length;
+    } else {
+      node = new import_Rect.Rect({
+        x: seat.x,
+        y: seat.y,
+        width: dims.width,
+        height: dims.height,
+        offsetX: dims.width / 2,
+        offsetY: dims.height / 2,
+        rotation: dims.rotation,
+        cornerRadius: 4,
+        perfectDrawEnabled: false,
+        shadowForStrokeEnabled: false,
+        hitStrokeWidth: 0
+      });
+    }
+    node.setAttr("seatId", seat.id);
+    this.circleById.set(seat.id, node);
+    target.add(node);
     const t2 = new import_Text.Text({
-      x: seat.x,
-      y: seat.y,
+      x: labelX,
+      y: labelY,
       text: seat.displayLabel ?? seat.label,
       fontSize: BOOTH_LABEL_FONT_SIZE,
       fontStyle: "600",
@@ -4405,7 +4649,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.hasBoothText = true;
     this.boothLabelById.set(seat.id, t2);
     target.add(t2);
-    this.paintSeat(rect, seat.id);
+    this.paintSeat(node, seat.id);
   }
   /**
    * Build the centred accessibility glyph for a seat. Sized relative to the seat
@@ -4473,8 +4717,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
   seatBaseColor(categoryKey) {
     if (!this.colorblind) return this.catColor.get(categoryKey) ?? "#6e7bff";
-    const idx = this.catOrder.indexOf(categoryKey);
-    return CB_PALETTE[(idx >= 0 ? idx : 0) % CB_PALETTE.length];
+    return this.cbHueByKey.get(categoryKey) ?? CB_PALETTE[0];
   }
   /** Per-seat authored label size relative to the neutral default (1 = default),
    * mirroring the section convention (labelStyle.size ?? 18) / 18. Only real
@@ -4945,6 +5188,28 @@ var _SeatmapRenderer = class _SeatmapRenderer {
   renderText(obj) {
     const background = this.canvasBackground;
     const preferredInk = obj.color ?? this.theme.textColor ?? DEF_TEXT;
+    const iconPath = obj.semanticKind === "icon" ? venueIconPath(obj.iconKey) : void 0;
+    if (iconPath) {
+      const scale = obj.fontSize / VENUE_ICON_VIEWBOX;
+      const iconNode = new import_Path.Path({
+        x: obj.position.x,
+        y: obj.position.y,
+        data: iconPath,
+        rotation: obj.rotation,
+        scaleX: scale,
+        scaleY: scale,
+        stroke: stateAwareBookableLabelInk(background, preferredInk),
+        strokeWidth: VENUE_ICON_STROKE,
+        lineCap: "round",
+        lineJoin: "round",
+        fillEnabled: false,
+        listening: false,
+        perfectDrawEnabled: false
+      });
+      this.iconNodeById.set(obj.id, { node: iconNode, fontSize: obj.fontSize });
+      this.bgLayer.add(iconNode);
+      return;
+    }
     const node = new import_Text.Text({
       x: obj.position.x,
       y: obj.position.y,
@@ -5112,7 +5377,8 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       fill: color,
       opacity: GA_FILL_OPACITY,
       stroke: color,
-      strokeWidth: 1.5
+      strokeWidth: 1.5,
+      cornerRadius: obj.cornerRadius
     });
     poly.setAttr("gaId", obj.id);
     poly.on("click tap", (e) => {
@@ -5324,20 +5590,33 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     sec.outlinePoly.shadowBlur(4 + raw * 12);
     sec.outlinePoly.shadowOpacity(0.25 + raw * 0.45);
   }
-  /** Recompute a section's neutral overview state and retained detail count. */
+  /** Recompute a section's availability shading + retained availability text. */
   refreshSectionFill(sec) {
     sec.blockPoly.fill(this.sectionBlockFill(sec));
-    sec.subLabel.text(t("map.seatsLeft", { count: sec.free }));
+    sec.subLabel.text(
+      this.sectionAvailabilityState(sec) === "sold-out" ? t("map.soldOut") : t("map.seatsLeft", { count: sec.free })
+    );
     sec.subLabel.offsetX(sec.subLabel.width() / 2);
   }
   /** True when a section/zone is currently in the `closed` event-state. */
   isSectionClosed(sec) {
     return this.closedSections.has(sec.id) || this.closedSections.has(sec.logicalId) || sec.zone != null && this.closedSections.has(sec.zone);
   }
-  /** Clean overview shells never leak category, price, or live availability paint. */
+  /** Resolve the four-bucket overview availability state for a section (OV-69).
+   *  `closed` (operator) outranks live availability; the availability buckets
+   *  only apply to seated sections (GA-only shells have no seat capacity here). */
+  sectionAvailabilityState(sec) {
+    if (this.isSectionClosed(sec)) return "closed";
+    if (sec.total <= 0) return "normal";
+    if (sec.free <= 0) return "sold-out";
+    if (sec.free <= sec.total * SECTION_NEARLY_GONE_RATIO) return "nearly-gone";
+    return "normal";
+  }
+  /** Overview shells stay neutral except for the bounded availability shading
+   *  (nearly-gone / sold-out) and the operator `closed` slab — never category
+   *  or price paint, which is deferred to section focus/seat detail. */
   sectionBlockFill(sec) {
-    const fill = overviewPalette(this.canvasBackground).sectionFill;
-    return this.isSectionClosed(sec) ? darken(fill, 0.12) : fill;
+    return overviewStateFill(overviewPalette(this.canvasBackground), this.sectionAvailabilityState(sec));
   }
   /**
    * Zone rung: one giant screen-constant label per zone (+ optional "FROM $n"),
@@ -6343,10 +6622,9 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       };
     });
     const palette = overviewPalette(this.canvasBackground);
-    const neutralSectionFills = /* @__PURE__ */ new Set([
-      palette.sectionFill.toLowerCase(),
-      darken(palette.sectionFill, 0.12).toLowerCase()
-    ]);
+    const neutralSectionFills = new Set(
+      ["normal", "nearly-gone", "sold-out", "closed"].map((state) => overviewStateFill(palette, state).toLowerCase())
+    );
     const visibleSectionShells = this.sections.filter((section) => section.blockPoly.opacity() > 0.05);
     return {
       viewport,
@@ -6570,6 +6848,63 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       const gaOverviewHidden = objectId != null && (kind === "ga-label" || kind === "ga-capacity") && this.gaById.get(objectId)?.sectionId != null && effectiveScale < CACHE_THRESHOLD;
       node.visible(!gaDimmed && !gaOverviewHidden && isBookableLabelLegibleAtScale(node.fontSize(), effectiveScale));
     }
+    for (const { node, fontSize } of this.iconNodeById.values()) {
+      node.visible(isBookableLabelLegibleAtScale(fontSize, effectiveScale));
+    }
+  }
+  /** OV-45(a): resolve authored row-letter labels for the buyer/preview map, in
+   *  world space, matching the Designer's placement contract (start/end/both/none
+   *  preset, a free-drag `position` that wins over the preset, rotation, and
+   *  labelStyle colour/size fed through the same auto-contrast guard). Segmented
+   *  rows keep their own logical-label handling and are resolved by their owner. */
+  buildRowLabelPlan(view) {
+    this.rowLabelPlan = [];
+    const background = this.theme.background ?? "#0e1117";
+    const seatsByRow = /* @__PURE__ */ new Map();
+    for (const seat of this.seats) {
+      if (seat.kind === "booth") continue;
+      const key = seat.logicalRowId ?? seat.rowId;
+      (seatsByRow.get(key) ?? seatsByRow.set(key, []).get(key)).push(seat);
+    }
+    const seatOrder = (seat) => seat.logicalSeatIndex ?? Number(seat.id.split(":").pop() ?? 0);
+    for (const obj of view.objects) {
+      if (obj.type !== "row") continue;
+      if (obj.segmentedRow && obj.segmentedRow.componentIndex !== 0) continue;
+      const presentation = obj.segmentedRow?.labelPresentation ?? obj.labelPresentation;
+      if (presentation?.visible === false || presentation?.positionPreset === "none") continue;
+      const key = obj.segmentedRow ? obj.segmentedRow.groupId : obj.id;
+      const seats = (seatsByRow.get(key) ?? []).slice().sort((a, b) => seatOrder(a) - seatOrder(b));
+      if (!seats.length) continue;
+      const first = seats[0];
+      const last = seats[seats.length - 1];
+      const labelStyle = presentation?.labelStyle;
+      const ink = stateAwareBookableLabelInk(
+        background,
+        labelStyle?.color ?? this.theme.rowLabelColor ?? this.theme.textColor ?? "#e6e9f0"
+      );
+      const fontSize = labelStyle?.size ?? 12;
+      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 });
+      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);
+    }
+  }
+  /** Row labels never carry status; the buyer just dims them under the same
+   *  category/price filters that dim their seats. */
+  objectFilteredOut(obj) {
+    const key = obj.categoryKey;
+    if (!key) return false;
+    return Boolean(this.categoryHighlight && key !== this.categoryHighlight || this.categoryFilter && !this.categoryFilter.has(key));
   }
   updateLabels() {
     const effectiveScale = this.effScale();
@@ -6663,6 +6998,30 @@ var _SeatmapRenderer = class _SeatmapRenderer {
       this.seatLabelById.set(seat.id, t2);
       if (++count >= MAX_LABELS) break;
     }
+    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;
+      const t2 = new import_Text.Text({
+        x: rl.x,
+        y: rl.y,
+        text: rl.text,
+        fontSize: rl.fontSize,
+        fontStyle: "700",
+        fontFamily: this.labelFont(),
+        fill: rl.ink,
+        rotation: rl.rotation,
+        opacity: rl.opacity,
+        shadowColor: "#05070c",
+        shadowBlur: rl.ink.toLowerCase() === "#ffffff" ? 5 : 0,
+        shadowOpacity: rl.ink.toLowerCase() === "#ffffff" ? 0.8 : 0,
+        shadowForStrokeEnabled: false,
+        listening: false,
+        perfectDrawEnabled: false
+      });
+      t2.offsetX(t2.width() / 2);
+      t2.offsetY(t2.height() / 2);
+      this.labelGroup.add(t2);
+    }
     if (this.isoT > 0 && this.viewMode !== "perspective") this.applyUprightLabels();
     this.overlayLayer.batchDraw();
   }
@@ -7909,7 +8268,7 @@ var PickerController = class {
     const color = sec.color ?? zone?.color ?? categories[0]?.color ?? "#6e7bff";
     return {
       id,
-      label: sec.label,
+      label: sec.displayLabel ?? sec.label,
       zoneLabel: zone?.label ?? "",
       ...sec.entrance && sec.entrance.trim() ? { entrance: sec.entrance.trim() } : {},
       color,