@seatlayer/core 0.18.0 → 0.18.1

package/dist/index.d.cts

@@ -139,6 +139,10 @@ interface SeatOverride {
     commercial?: SeatCommercialAttributes;
     /** Seat-specific view photo; falls back to the row photo. */
     viewFromSeatUrl?: string;
+    /** Per-seat label size/color override; falls back to the row/theme default.
+     *  Size is clamped to LABEL_STYLE_MIN_SIZE..MAX_SIZE; color is passed through
+     *  the shared auto-contrast rule at paint time (see {@link LabelStyle}). */
+    labelStyle?: LabelStyle;
 }
 interface SeatCommercialAttributes {
     restrictedView?: boolean;
@@ -640,6 +644,8 @@ interface ExpandedSeat {
     commercial?: SeatCommercialAttributes;
     /** Organizer-supplied view-from-seat image (inherited from the row). */
     viewUrl?: string;
+    /** Per-seat label size/color override; absent = inherit the row/theme default. */
+    labelStyle?: LabelStyle;
 }
 type SeatStatus = 'free' | 'held' | 'booked' | 'not_for_sale';
 interface RendererCallbacks {
@@ -1063,6 +1069,7 @@ interface RowSeatSlot {
     accessibility: AccessibilityType[];
     commercial?: RowObject['commercial'];
     viewUrl?: string;
+    labelStyle?: LabelStyle;
 }
 declare function expandRowSlots(row: RowObject): RowSeatSlot[];
 declare function expandRow(row: RowObject): ExpandedSeat[];
@@ -1489,11 +1496,16 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderBoothUnit;
     /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
     private seatBaseColor;
-    /** Resolve label ink against the paint that is actually visible. The theme
-     * ink remains preferred, but mixed category palettes cannot always share one
-     * accessible text colour, so every free and transient state gets the same
-     * deterministic dark/light fallback used by Designer. */
-    private renderedBookableLabelInk;
+    /** Per-seat authored label size relative to the neutral default (1 = default),
+     * mirroring the section convention (labelStyle.size ?? 18) / 18. Only real
+     * seats carry labelStyle, so booths and unstyled seats resolve to 1. */
+    private seatLabelScale;
+    /** Preferred label ink for a seat: the authored per-seat colour when set,
+     * otherwise today's theme default. Fed through auto-contrast by seatLabelInk. */
+    private seatPreferredLabelInk;
+    /** Resolve a seat's label ink against the paint actually visible, honouring an
+     * authored per-seat colour through the same auto-contrast rule as sections. */
+    private seatLabelInk;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
     /** True when a seat sits in a section/zone currently marked `closed`. */
@@ -2170,6 +2182,13 @@ declare class PickerController {
     private applySeatsMap;
     private clearBookedHoldIfSettled;
     private resnapshot;
+    /**
+     * Re-pull the status snapshot on demand. Live surfaces rarely need this (the
+     * socket keeps them fresh); local/mock transports with no socket call it
+     * after they mutate state (e.g. the demo books a hold) so the renderer and
+     * every onStatusChange consumer repaint from the new truth.
+     */
+    refresh(): Promise<void>;
     /**
      * Buyer catch-up on tab regain. While a tab is hidden Chrome pauses rAF, so
      * seat-status deltas that arrived over the WS mutated the scene graph but the

package/dist/index.d.ts

@@ -139,6 +139,10 @@ interface SeatOverride {
     commercial?: SeatCommercialAttributes;
     /** Seat-specific view photo; falls back to the row photo. */
     viewFromSeatUrl?: string;
+    /** Per-seat label size/color override; falls back to the row/theme default.
+     *  Size is clamped to LABEL_STYLE_MIN_SIZE..MAX_SIZE; color is passed through
+     *  the shared auto-contrast rule at paint time (see {@link LabelStyle}). */
+    labelStyle?: LabelStyle;
 }
 interface SeatCommercialAttributes {
     restrictedView?: boolean;
@@ -640,6 +644,8 @@ interface ExpandedSeat {
     commercial?: SeatCommercialAttributes;
     /** Organizer-supplied view-from-seat image (inherited from the row). */
     viewUrl?: string;
+    /** Per-seat label size/color override; absent = inherit the row/theme default. */
+    labelStyle?: LabelStyle;
 }
 type SeatStatus = 'free' | 'held' | 'booked' | 'not_for_sale';
 interface RendererCallbacks {
@@ -1063,6 +1069,7 @@ interface RowSeatSlot {
     accessibility: AccessibilityType[];
     commercial?: RowObject['commercial'];
     viewUrl?: string;
+    labelStyle?: LabelStyle;
 }
 declare function expandRowSlots(row: RowObject): RowSeatSlot[];
 declare function expandRow(row: RowObject): ExpandedSeat[];
@@ -1489,11 +1496,16 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderBoothUnit;
     /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
     private seatBaseColor;
-    /** Resolve label ink against the paint that is actually visible. The theme
-     * ink remains preferred, but mixed category palettes cannot always share one
-     * accessible text colour, so every free and transient state gets the same
-     * deterministic dark/light fallback used by Designer. */
-    private renderedBookableLabelInk;
+    /** Per-seat authored label size relative to the neutral default (1 = default),
+     * mirroring the section convention (labelStyle.size ?? 18) / 18. Only real
+     * seats carry labelStyle, so booths and unstyled seats resolve to 1. */
+    private seatLabelScale;
+    /** Preferred label ink for a seat: the authored per-seat colour when set,
+     * otherwise today's theme default. Fed through auto-contrast by seatLabelInk. */
+    private seatPreferredLabelInk;
+    /** Resolve a seat's label ink against the paint actually visible, honouring an
+     * authored per-seat colour through the same auto-contrast rule as sections. */
+    private seatLabelInk;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
     /** True when a seat sits in a section/zone currently marked `closed`. */
@@ -2170,6 +2182,13 @@ declare class PickerController {
     private applySeatsMap;
     private clearBookedHoldIfSettled;
     private resnapshot;
+    /**
+     * Re-pull the status snapshot on demand. Live surfaces rarely need this (the
+     * socket keeps them fresh); local/mock transports with no socket call it
+     * after they mutate state (e.g. the demo books a hold) so the renderer and
+     * every onStatusChange consumer repaint from the new truth.
+     */
+    refresh(): Promise<void>;
     /**
      * Buyer catch-up on tab regain. While a tab is hidden Chrome pauses rAF, so
      * seat-status deltas that arrived over the WS mutated the scene graph but the

package/dist/index.js

@@ -187,7 +187,8 @@ function expandRowSlots(row) {
       accessible: accessibility.length > 0,
       accessibility,
       commercial: Object.values(commercial).some((value) => value !== void 0 && value !== false && value !== "") ? commercial : void 0,
-      viewUrl: o?.viewFromSeatUrl ?? row.viewFromSeatUrl
+      viewUrl: o?.viewFromSeatUrl ?? row.viewFromSeatUrl,
+      labelStyle: o?.labelStyle
     };
   });
 }
@@ -206,7 +207,8 @@ function expandRow(row) {
       accessible: slot.accessible || void 0,
       accessibility: slot.accessibility.length ? slot.accessibility : void 0,
       commercial: slot.commercial,
-      viewUrl: slot.viewUrl
+      viewUrl: slot.viewUrl,
+      labelStyle: slot.labelStyle
     });
   }
   return seats;
@@ -2402,14 +2404,22 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     const idx = this.catOrder.indexOf(categoryKey);
     return CB_PALETTE[(idx >= 0 ? idx : 0) % CB_PALETTE.length];
   }
-  /** Resolve label ink against the paint that is actually visible. The theme
-   * ink remains preferred, but mixed category palettes cannot always share one
-   * accessible text colour, so every free and transient state gets the same
-   * deterministic dark/light fallback used by Designer. */
-  renderedBookableLabelInk(shape) {
-    const preferred = this.theme.seatLabelColor ?? DEF_SEAT_LABEL;
+  /** Per-seat authored label size relative to the neutral default (1 = default),
+   * mirroring the section convention (labelStyle.size ?? 18) / 18. Only real
+   * seats carry labelStyle, so booths and unstyled seats resolve to 1. */
+  seatLabelScale(seat) {
+    return (seat.labelStyle?.size ?? 18) / 18;
+  }
+  /** Preferred label ink for a seat: the authored per-seat colour when set,
+   * otherwise today's theme default. Fed through auto-contrast by seatLabelInk. */
+  seatPreferredLabelInk(seat) {
+    return seat.labelStyle?.color ?? this.theme.seatLabelColor ?? DEF_SEAT_LABEL;
+  }
+  /** Resolve a seat's label ink against the paint actually visible, honouring an
+   * authored per-seat colour through the same auto-contrast rule as sections. */
+  seatLabelInk(seat, shape) {
     const fill = shape.fill();
-    return stateAwareBookableLabelInk(typeof fill === "string" ? fill : "", preferred);
+    return stateAwareBookableLabelInk(typeof fill === "string" ? fill : "", this.seatPreferredLabelInk(seat));
   }
   /** Apply fill/stroke/opacity for a seat's current status + selection. */
   paintSeat(c, id) {
@@ -2493,7 +2503,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     if (this.selectionFocusId && id !== this.selectionFocusId) c.opacity(Math.min(c.opacity(), 0.16));
     const bookableLabel = this.boothLabelById.get(id) ?? this.seatLabelById.get(id);
     if (bookableLabel) {
-      bookableLabel.fill(this.renderedBookableLabelInk(c));
+      bookableLabel.fill(this.seatLabelInk(seat, c));
       bookableLabel.visible(
         isBookableLabelLegibleAtScale(bookableLabel.fontSize(), this.effScale()) && c.opacity() >= 0.5
       );
@@ -3873,7 +3883,7 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     const labels = this.seats.map((seat) => {
       const shape = this.circleById.get(seat.id);
       const label = this.boothLabelById.get(seat.id) ?? this.seatLabelById.get(seat.id);
-      const authoredFontSize = seat.kind === "booth" ? BOOTH_LABEL_FONT_SIZE : SEAT_LABEL_FONT_SIZE;
+      const authoredFontSize = seat.kind === "booth" ? BOOTH_LABEL_FONT_SIZE : SEAT_LABEL_FONT_SIZE * this.seatLabelScale(seat);
       const renderedFontPx = rounded((label?.fontSize() ?? authoredFontSize) * effectiveScale);
       const screen = this.worldToScreen(seat);
       const outside = screen.x < 0 || screen.x > viewport.width || screen.y < 0 || screen.y > viewport.height;
@@ -4190,9 +4200,10 @@ var _SeatmapRenderer = class _SeatmapRenderer {
         minimumFont = Math.min(minimumFont, BOOTH_LABEL_FONT_SIZE);
         continue;
       }
-      measure.fontSize(SEAT_LABEL_FONT_SIZE);
+      const authoredFontSize = SEAT_LABEL_FONT_SIZE * this.seatLabelScale(seat);
+      measure.fontSize(authoredFontSize);
       measure.text(bookableMarkerLabel(seat.displayLabel ?? seat.label));
-      const fitted = measure.width() > maxWidth ? Math.max(MIN_FITTED_SEAT_LABEL_FONT_SIZE, SEAT_LABEL_FONT_SIZE * maxWidth / measure.width()) : SEAT_LABEL_FONT_SIZE;
+      const fitted = measure.width() > maxWidth ? Math.max(MIN_FITTED_SEAT_LABEL_FONT_SIZE, authoredFontSize * maxWidth / measure.width()) : authoredFontSize;
       minimumFont = Math.min(minimumFont, fitted);
     }
     measure.destroy();
@@ -4342,19 +4353,20 @@ var _SeatmapRenderer = class _SeatmapRenderer {
         if (++count >= MAX_LABELS) break;
         continue;
       }
+      const authoredFontSize = SEAT_LABEL_FONT_SIZE * this.seatLabelScale(seat);
       const t2 = new Text({
         x: seat.x,
         y: seat.y,
         text: bookableMarkerLabel(seat.displayLabel ?? seat.label),
-        fontSize: SEAT_LABEL_FONT_SIZE,
+        fontSize: authoredFontSize,
         fontStyle: "600",
         fontFamily: this.labelFont(),
-        fill: shape ? this.renderedBookableLabelInk(shape) : this.theme.seatLabelColor ?? DEF_SEAT_LABEL,
+        fill: shape ? this.seatLabelInk(seat, shape) : this.seatPreferredLabelInk(seat),
         listening: false,
         perfectDrawEnabled: false
       });
       const maxW = this.seatR * 2 - 3;
-      if (t2.width() > maxW) t2.fontSize(Math.max(MIN_FITTED_SEAT_LABEL_FONT_SIZE, SEAT_LABEL_FONT_SIZE * maxW / t2.width()));
+      if (t2.width() > maxW) t2.fontSize(Math.max(MIN_FITTED_SEAT_LABEL_FONT_SIZE, authoredFontSize * maxW / t2.width()));
       if (t2.width() > maxW + 0.01) {
         t2.destroy();
         continue;
@@ -5314,6 +5326,15 @@ var PickerController = class {
     } catch {
     }
   }
+  /**
+   * Re-pull the status snapshot on demand. Live surfaces rarely need this (the
+   * socket keeps them fresh); local/mock transports with no socket call it
+   * after they mutate state (e.g. the demo books a hold) so the renderer and
+   * every onStatusChange consumer repaint from the new truth.
+   */
+  async refresh() {
+    await this.resnapshot();
+  }
   // ---- realtime socket ------------------------------------------------------
   /**
    * Buyer catch-up on tab regain. While a tab is hidden Chrome pauses rAF, so
@@ -5348,9 +5369,11 @@ var PickerController = class {
   }
   connect() {
     if (this.closed) return;
+    const url = this.api.socketUrl(this.key);
+    if (!url) return;
     let ws;
     try {
-      ws = new WebSocket(this.api.socketUrl(this.key));
+      ws = new WebSocket(url);
     } catch {
       this.scheduleReconnect();
       return;