@seatlayer/core 0.21.0 → 0.22.0

package/dist/index.d.cts

@@ -2,8 +2,8 @@
  * SeatMap chart document — the single source of truth shared by the
  * Designer (authoring) and the Renderer (buyer picker).
  *
- * Mirrors docs/seatmap-build-spec.md §5. Coordinates are abstract units
- * (roughly "pixels at scale 1"); the renderer fits the chart to its container.
+ * Coordinates are abstract units (roughly "pixels at scale 1"); the renderer
+ * fits the chart to its container.
  * Rows are PARAMETRIC (origin + count + spacing + curve + rotation) — never
  * store per-seat coordinates in the document; expansion happens in layout.ts.
  */
@@ -499,7 +499,7 @@ interface ZoneDef {
  * Fixed set of four; derived from object type via `layerOf()` (no per-object field yet).
  */
 type SelectionLayer = 'interactive' | 'background' | 'foreground' | 'surroundings';
-/** Derive an object's selection layer from its type (design contract, HANDOFF §03). */
+/** Derive an object's selection layer from its type. */
 declare function layerOf(obj: ChartObject): SelectionLayer;
 /** Free-standing text on the chart (aisle names, door labels…). */
 interface TextObject {
@@ -1275,6 +1275,9 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private categoryHighlight;
     /** Price-band filter (F4): dim free seats whose category is NOT in this set. */
     private categoryFilter;
+    /** Commercial "hide limited-view seats" toggle: dim free seats flagged
+     *  restrictedView/obstructedView. Parallel to the accessibility filter. */
+    private commercialLimitedFilter;
     private sections;
     private zones;
     private seatSection;
@@ -1433,6 +1436,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setAccessibleFilter(on: boolean): void;
     setAccessibilityFilter(types: AccessibilityType[] | null): void;
     private sameAccessFilter;
+    /**
+     * "Hide limited-view seats" toggle (commercial): when on, dim free, unselected
+     * seats flagged restrictedView or obstructedView — the same visual dimming the
+     * accessibility filter uses, just keyed off the seat's commercial attributes.
+     */
+    setCommercialLimitedFilter(on: boolean): void;
     /**
      * Price-band filter (F4): dim free, unselected seats whose category key is NOT
      * in `keys`. `null` clears the filter (all categories fully visible). The
@@ -1768,6 +1777,10 @@ interface PickerSeat {
     tiers?: CategoryTier[];
     /** The chosen tier's id — defaults to the first tier; absent when no tiers. */
     tierId?: string;
+    /** Commercial selling/view attributes (restricted/obstructed view, premium,
+     *  note) resolved for this seat; absent when the seat carries none. Lets the
+     *  buyer cart + confirm surface flag limited-view/premium seats. */
+    commercial?: SeatCommercialAttributes;
 }
 /**
  * Rich hover payload for seat tooltips — the PickerSeat plus everything a
@@ -2089,6 +2102,13 @@ declare class PickerController {
     };
     setSelectionFocus(seatId: string | null): void;
     setAccessibilityFilter(types: string[] | null): void;
+    /**
+     * "Hide limited-view seats" toggle — dims free seats flagged
+     * restricted/obstructed view. Additive commercial parallel to the
+     * accessibility filter; called via the concrete renderer (not on the shared
+     * ISeatmapRenderer interface).
+     */
+    setCommercialLimitedFilter(on: boolean): void;
     /** Floors for the buyer's switcher (>1 ⇒ show it). Single-floor ⇒ one entry. */
     getFloors(): {
         id: string;
@@ -2234,10 +2254,10 @@ declare function generateSeatThumb(seat: ExpandedSeat, focalPoint: Point, _neigh
 
 /**
  * i18n core — deliberately tiny and framework-free so the embed SDK can share
- * it without dragging in a runtime library (the 60KB-gzipped SDK budget is a
+ * it without dragging in a runtime library (the 150KB-gzipped complete CDN budget is a
  * product contract).
  *
- * Scope (docs/design-port-plan.md): the buyer surface (picker, public event
+ * Scope: the buyer surface (picker, public event
  * page, SDK) ships fully translated in en/es/de/fr; dashboard pages route
  * their strings through t() as they are rebuilt but ship English this round.
  *
@@ -2265,7 +2285,7 @@ declare function formatDate(value: number | Date, opts?: Intl.DateTimeFormatOpti
 
 /**
  * Locale bundle loader — keeps non-English translations OUT of the initial
- * bundle (the 60 KB SDK budget is a product contract) and code-splits each
+ * bundle (the 150 KB complete CDN budget is a product contract) and code-splits each
  * locale so a page/SDK only downloads the language it actually uses.
  *
  * `loadLocale('de')` dynamic-imports the German dictionary, registers it via

package/dist/index.d.ts

@@ -2,8 +2,8 @@
  * SeatMap chart document — the single source of truth shared by the
  * Designer (authoring) and the Renderer (buyer picker).
  *
- * Mirrors docs/seatmap-build-spec.md §5. Coordinates are abstract units
- * (roughly "pixels at scale 1"); the renderer fits the chart to its container.
+ * Coordinates are abstract units (roughly "pixels at scale 1"); the renderer
+ * fits the chart to its container.
  * Rows are PARAMETRIC (origin + count + spacing + curve + rotation) — never
  * store per-seat coordinates in the document; expansion happens in layout.ts.
  */
@@ -499,7 +499,7 @@ interface ZoneDef {
  * Fixed set of four; derived from object type via `layerOf()` (no per-object field yet).
  */
 type SelectionLayer = 'interactive' | 'background' | 'foreground' | 'surroundings';
-/** Derive an object's selection layer from its type (design contract, HANDOFF §03). */
+/** Derive an object's selection layer from its type. */
 declare function layerOf(obj: ChartObject): SelectionLayer;
 /** Free-standing text on the chart (aisle names, door labels…). */
 interface TextObject {
@@ -1275,6 +1275,9 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private categoryHighlight;
     /** Price-band filter (F4): dim free seats whose category is NOT in this set. */
     private categoryFilter;
+    /** Commercial "hide limited-view seats" toggle: dim free seats flagged
+     *  restrictedView/obstructedView. Parallel to the accessibility filter. */
+    private commercialLimitedFilter;
     private sections;
     private zones;
     private seatSection;
@@ -1433,6 +1436,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setAccessibleFilter(on: boolean): void;
     setAccessibilityFilter(types: AccessibilityType[] | null): void;
     private sameAccessFilter;
+    /**
+     * "Hide limited-view seats" toggle (commercial): when on, dim free, unselected
+     * seats flagged restrictedView or obstructedView — the same visual dimming the
+     * accessibility filter uses, just keyed off the seat's commercial attributes.
+     */
+    setCommercialLimitedFilter(on: boolean): void;
     /**
      * Price-band filter (F4): dim free, unselected seats whose category key is NOT
      * in `keys`. `null` clears the filter (all categories fully visible). The
@@ -1768,6 +1777,10 @@ interface PickerSeat {
     tiers?: CategoryTier[];
     /** The chosen tier's id — defaults to the first tier; absent when no tiers. */
     tierId?: string;
+    /** Commercial selling/view attributes (restricted/obstructed view, premium,
+     *  note) resolved for this seat; absent when the seat carries none. Lets the
+     *  buyer cart + confirm surface flag limited-view/premium seats. */
+    commercial?: SeatCommercialAttributes;
 }
 /**
  * Rich hover payload for seat tooltips — the PickerSeat plus everything a
@@ -2089,6 +2102,13 @@ declare class PickerController {
     };
     setSelectionFocus(seatId: string | null): void;
     setAccessibilityFilter(types: string[] | null): void;
+    /**
+     * "Hide limited-view seats" toggle — dims free seats flagged
+     * restricted/obstructed view. Additive commercial parallel to the
+     * accessibility filter; called via the concrete renderer (not on the shared
+     * ISeatmapRenderer interface).
+     */
+    setCommercialLimitedFilter(on: boolean): void;
     /** Floors for the buyer's switcher (>1 ⇒ show it). Single-floor ⇒ one entry. */
     getFloors(): {
         id: string;
@@ -2234,10 +2254,10 @@ declare function generateSeatThumb(seat: ExpandedSeat, focalPoint: Point, _neigh
 
 /**
  * i18n core — deliberately tiny and framework-free so the embed SDK can share
- * it without dragging in a runtime library (the 60KB-gzipped SDK budget is a
+ * it without dragging in a runtime library (the 150KB-gzipped complete CDN budget is a
  * product contract).
  *
- * Scope (docs/design-port-plan.md): the buyer surface (picker, public event
+ * Scope: the buyer surface (picker, public event
  * page, SDK) ships fully translated in en/es/de/fr; dashboard pages route
  * their strings through t() as they are rebuilt but ship English this round.
  *
@@ -2265,7 +2285,7 @@ declare function formatDate(value: number | Date, opts?: Intl.DateTimeFormatOpti
 
 /**
  * Locale bundle loader — keeps non-English translations OUT of the initial
- * bundle (the 60 KB SDK budget is a product contract) and code-splits each
+ * bundle (the 150 KB complete CDN budget is a product contract) and code-splits each
  * locale so a page/SDK only downloads the language it actually uses.
  *
  * `loadLocale('de')` dynamic-imports the German dictionary, registers it via

package/dist/index.js

@@ -742,7 +742,7 @@ var en = {
   "common.close": "Close",
   "common.done": "Done",
   "common.copied": "\u2713 Copied",
-  // buyer picker (extraction in progress — P4 of the port plan)
+  // buyer picker
   "picker.holdSeats": "Hold seats & checkout",
   "picker.completeBooking": "Complete booking",
   "picker.seatsHeld": "Seats held \u2014 {time}",
@@ -806,7 +806,11 @@ var en = {
   "picker.on": "ON",
   "picker.off": "OFF",
   "picker.panorama360": "360\xB0 venue photo",
-  "picker.illustrationCaption": "illustration \xB7 \u2248 {m} m from stage"
+  "picker.illustrationCaption": "illustration \xB7 \u2248 {m} m from stage",
+  "picker.restrictedView": "Restricted view",
+  "picker.obstructedView": "Obstructed view",
+  "picker.premiumSeat": "Premium seat",
+  "picker.hideLimitedView": "Hide limited-view seats"
 };
 
 // src/i18n/index.ts
@@ -1180,6 +1184,9 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     this.categoryHighlight = null;
     /** Price-band filter (F4): dim free seats whose category is NOT in this set. */
     this.categoryFilter = null;
+    /** Commercial "hide limited-view seats" toggle: dim free seats flagged
+     *  restrictedView/obstructedView. Parallel to the accessibility filter. */
+    this.commercialLimitedFilter = false;
     // Section/zone overlays (bgLayer) — the 3-rung LOD: seats → section blocks →
     // zone blocks. Kept for the melt restyle and for hit-testing a zoomed-out tap.
     this.sections = [];
@@ -2043,6 +2050,26 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     if (cur === null || next === null) return cur === next;
     return cur.length === next.length && cur.every((t2, i) => t2 === next[i]);
   }
+  /**
+   * "Hide limited-view seats" toggle (commercial): when on, dim free, unselected
+   * seats flagged restrictedView or obstructedView — the same visual dimming the
+   * accessibility filter uses, just keyed off the seat's commercial attributes.
+   */
+  setCommercialLimitedFilter(on) {
+    if (this.commercialLimitedFilter === on) return;
+    this.commercialLimitedFilter = on;
+    for (const seat of this.seats) {
+      const c = this.circleById.get(seat.id);
+      if (c) this.paintSeat(c, seat.id);
+    }
+    this.updateLabels();
+    if (this.cached) {
+      this.seatLayer.clearCache();
+      this.cacheSeatLayer();
+    } else {
+      this.seatLayer.batchDraw();
+    }
+  }
   /**
    * Price-band filter (F4): dim free, unselected seats whose category key is NOT
    * in `keys`. `null` clears the filter (all categories fully visible). The
@@ -2482,6 +2509,9 @@ var _SeatmapRenderer = class _SeatmapRenderer {
     if (this.categoryFilter && status === "free" && !selected && !this.categoryFilter.has(seat.categoryKey)) {
       c.opacity(0.22);
     }
+    if (this.commercialLimitedFilter && status === "free" && !selected && (seat.commercial?.restrictedView || seat.commercial?.obstructedView)) {
+      c.opacity(0.22);
+    }
     if (this.dimmedSections.size) {
       const sec = this.seatSection.get(id);
       if (sec && (this.dimmedSections.has(sec.id) || this.dimmedSections.has(sec.logicalId) || sec.zone != null && this.dimmedSections.has(sec.zone))) {
@@ -4969,6 +4999,15 @@ var PickerController = class {
   setAccessibilityFilter(types) {
     this.renderer?.setAccessibilityFilter?.(types);
   }
+  /**
+   * "Hide limited-view seats" toggle — dims free seats flagged
+   * restricted/obstructed view. Additive commercial parallel to the
+   * accessibility filter; called via the concrete renderer (not on the shared
+   * ISeatmapRenderer interface).
+   */
+  setCommercialLimitedFilter(on) {
+    this.renderer?.setCommercialLimitedFilter?.(on);
+  }
   // ---- multi-floor (Batch 5) ------------------------------------------------
   /** Floors for the buyer's switcher (>1 ⇒ show it). Single-floor ⇒ one entry. */
   getFloors() {
@@ -5162,9 +5201,10 @@ var PickerController = class {
   }
   // ---- internals ------------------------------------------------------------
   toSeat(s) {
+    const commercial = s.commercial ? { commercial: s.commercial } : void 0;
     const tiers = this.tiersFor(s.categoryKey);
     if (!tiers) {
-      return { id: s.id, label: s.label, categoryKey: s.categoryKey, price: this.priceFor(s.categoryKey) };
+      return { id: s.id, label: s.label, categoryKey: s.categoryKey, price: this.priceFor(s.categoryKey), ...commercial };
     }
     const chosen = tiers.find((t2) => t2.id === this.seatTiers.get(s.id)) ?? tiers[0];
     return {
@@ -5173,7 +5213,8 @@ var PickerController = class {
       categoryKey: s.categoryKey,
       price: chosen.price,
       tiers,
-      tierId: chosen.id
+      tierId: chosen.id,
+      ...commercial
     };
   }
   /** Tooltip payload for a hovered seat — see PickerCallbacks.onSeatHover. */
@@ -5661,9 +5702,9 @@ function generateSeatThumb(seat, focalPoint, _neighborSeats) {
 
 // src/i18n/bundles.ts
 var LOADERS = {
-  es: () => import("./es-LDI3FESI.js").then((m) => ({ default: m.es })),
-  de: () => import("./de-HLJXYBWA.js").then((m) => ({ default: m.de })),
-  fr: () => import("./fr-H4KTK4F5.js").then((m) => ({ default: m.fr }))
+  es: () => import("./es-ALPR5FBB.js").then((m) => ({ default: m.es })),
+  de: () => import("./de-KPTY7UOT.js").then((m) => ({ default: m.de })),
+  fr: () => import("./fr-HVQLQD2N.js").then((m) => ({ default: m.fr }))
 };
 var loaded = /* @__PURE__ */ new Set(["en"]);
 async function loadLocale(code) {