@seatlayer/js 0.27.0 → 0.28.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, SeatHoverDetails, PickerTransport, ChartDoc, AvailabilityRule, ChartTheme, ExpandedSeat } from '@seatlayer/core';
+import { PickerSeat, SeatHoverDetails, PickerTransport, RendererViewMode, ChartDoc, AvailabilityRule, ChartTheme, ExpandedSeat } from '@seatlayer/core';
 export { ExpandedSeat, SeatHoverDetails } from '@seatlayer/core';
 
 /**
@@ -529,8 +529,19 @@ declare class EmbeddedDesigner {
  * per-line tier + price) and never changes shape across minor releases.
  */
 interface CheckoutLineItem {
-    /** Seat, table-group, or GA synthetic-unit label. */
+    /** Seat label (or GA synthetic-unit label) — the stable booking identity. */
     label: string;
+    /**
+     * Buyer-facing name (the designer's `displayLabel` override), when set.
+     * Show this in YOUR order summary; `label` stays the booking identity you
+     * pass to the book call. Absent = no override, fall back to `label`.
+     */
+    displayLabel?: string;
+    /**
+     * Buyer-facing type word override (seats.io "Displayed type", e.g. "Table",
+     * "Bench", "Box"), when the designer set one. Absent = the default word.
+     */
+    displayType?: string;
     /** Chart object id (row/booth/GA area) the unit belongs to. */
     objectId: string;
     objectType: 'seat' | 'booth' | 'ga' | 'table';
@@ -615,6 +626,9 @@ interface SeatPickerOptions {
     currency?: string;
     /** Colorblind-safe rendering (Okabe-Ito palette, hollow booked seats). */
     colorblindSafe?: boolean;
+    /** Initial map projection. `perspective` is the exact-seat projected 2.5D
+     * buyer view; all authoring and inventory identities remain unchanged. */
+    initialView?: RendererViewMode;
     /**
      * Hide the "Powered by SeatLayer" attribution badge in the side panel foot.
      * The chart theme's own `hideBadge` flag (paid orgs) also hides it — the badge
@@ -722,9 +736,15 @@ declare class SeatPicker {
     private tipPos;
     private confirmEl;
     private confirmSeat;
+    private tableDialogEl;
+    private tableDialog;
+    private tableDialogHeld;
+    private tableDialogReturnFocus;
     private srEl;
     private baQty;
     private baCat;
+    /** Optional navigation-zone scope for buyer best-available. */
+    private baZone;
     /** "★ Best seats" premium quick-pick toggle — biases best-available to premium seats. */
     private baPremium;
     private bestAvailableConfirm;
@@ -737,6 +757,7 @@ declare class SeatPicker {
     /** Resolved colorblind-safe state — stored preference wins over the option. */
     private cbSafe;
     private rungsEl;
+    private projectionEl;
     private floorsEl;
     private secCardEl;
     private viewEl;
@@ -773,10 +794,17 @@ declare class SeatPicker {
     private framedFs;
     /** Last height (px) posted to a host frame; dedupes redundant reports. */
     private lastPostedHeight;
+    /** True when the chart carries a real performance anchor — a stage-kind shape.
+     *  Every chart has a `focalPoint` (a bare look-at coordinate), so its presence
+     *  alone never justifies a "to stage" claim; only an actual stage does. */
+    private chartHasStage;
     /**
-     * Eager sightline preview for the confirm card: a cheap generated forward
-     * view (or the organizer's real photo) plus a "Nm to stage · clear
-     * sightline" line — the premium at-a-glance moment; click opens the 360.
+     * Eager sightline preview for the confirm card: the organizer's real view
+     * photo, or — only when the chart has an actual stage to look at — a generated
+     * forward view plus an "≈ Nm to stage · clear sightline" line. On a stageless
+     * chart both the distance/sightline claim and the generic stage silhouette are
+     * invented promises, so we suppress them; a real attached photo always shows.
+     * (OV-52)
      */
     private confirmThumbHtml;
     /** Minimal HTML/attribute escaper for buyer-authored commercial text (notes). */
@@ -793,6 +821,9 @@ declare class SeatPicker {
     /** Small ◐ limited-view marker for a cart chip; title/aria uses the seat's
      *  note when present, else the generic view label. '' for a clear-view seat. */
     private commercialChipMarker;
+    private wheelchairProvisionLabel;
+    private wheelchairConfirmHtml;
+    private wheelchairChipMarker;
     /** True when the picker is rendered inside an iframe (snippet embed at /e/:key). */
     private isFramed;
     /**
@@ -953,10 +984,11 @@ declare class SeatPicker {
     /** Build the compact price selector in the panel header. Choosing a band both
      *  filters availability and smoothly frames the matching seats on the map. */
     private buildPriceFilter;
-    /** Build the rung pills (charts with sections) and floor switcher (>1 floor). */
+    /** Build projection, rung and floor controls for arena-scale charts. */
     private buildArenaChrome;
     /** Reflect the engine's current LOD rung onto the pill group. */
     private syncRung;
+    private syncProjection;
     /** Reflect the active floor onto the switcher rail. */
     private syncFloors;
     /** Show (or clear, on null) the tapped-section summary card. */
@@ -979,6 +1011,11 @@ declare class SeatPicker {
     private sectionCardCoverage;
     /** aria-live readout when keyboard focus lands on a seat. */
     private announceSeat;
+    private showTableDialog;
+    private renderTableDialogState;
+    private confirmTableDialog;
+    private cancelTableDialog;
+    private dismissTableDialog;
     private showConfirm;
     private reanchorConfirm;
     private dismissConfirm;
@@ -1060,6 +1097,19 @@ declare class SeatPicker {
     private rowShort;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /** Current colorblind-safe render state, resolved from the stored buyer
+     *  preference at mount. Host chrome (e.g. the Designer preview) reads this to
+     *  surface the state rather than rendering colorblind colors silently. */
+    isColorblindSafe(): boolean;
+    /** Single source of truth for the colorblind-safe toggle — used by both the
+     *  in-widget button and host chrome. Updates the renderer, the persisted
+     *  cross-surface preference, and the in-widget button's pressed state together
+     *  so the two controls never diverge. */
+    setColorblindSafe(on: boolean): void;
+    /** Switch the buyer canvas between flat, isometric and Perspective 2.5D. */
+    setViewMode(mode: RendererViewMode): void;
+    /** Current buyer canvas projection. */
+    getViewMode(): RendererViewMode;
     /** Current active/restored hold reflected in the tray. */
     getCurrentHold(): HoldResult | null;
     /** Explicit host-driven hold restore (automatic session restore is on by default). */
@@ -1068,6 +1118,7 @@ declare class SeatPicker {
     removeHeldTicket(label: string): Promise<boolean>;
     bestAvailable(qty: number, categoryKey?: string, opts?: {
         preferPremium?: boolean;
+        zoneId?: string;
     }): Promise<HoldResult | null>;
     release(): Promise<void>;
     destroy(): void;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PickerSeat, SeatHoverDetails, PickerTransport, ChartDoc, AvailabilityRule, ChartTheme, ExpandedSeat } from '@seatlayer/core';
+import { PickerSeat, SeatHoverDetails, PickerTransport, RendererViewMode, ChartDoc, AvailabilityRule, ChartTheme, ExpandedSeat } from '@seatlayer/core';
 export { ExpandedSeat, SeatHoverDetails } from '@seatlayer/core';
 
 /**
@@ -529,8 +529,19 @@ declare class EmbeddedDesigner {
  * per-line tier + price) and never changes shape across minor releases.
  */
 interface CheckoutLineItem {
-    /** Seat, table-group, or GA synthetic-unit label. */
+    /** Seat label (or GA synthetic-unit label) — the stable booking identity. */
     label: string;
+    /**
+     * Buyer-facing name (the designer's `displayLabel` override), when set.
+     * Show this in YOUR order summary; `label` stays the booking identity you
+     * pass to the book call. Absent = no override, fall back to `label`.
+     */
+    displayLabel?: string;
+    /**
+     * Buyer-facing type word override (seats.io "Displayed type", e.g. "Table",
+     * "Bench", "Box"), when the designer set one. Absent = the default word.
+     */
+    displayType?: string;
     /** Chart object id (row/booth/GA area) the unit belongs to. */
     objectId: string;
     objectType: 'seat' | 'booth' | 'ga' | 'table';
@@ -615,6 +626,9 @@ interface SeatPickerOptions {
     currency?: string;
     /** Colorblind-safe rendering (Okabe-Ito palette, hollow booked seats). */
     colorblindSafe?: boolean;
+    /** Initial map projection. `perspective` is the exact-seat projected 2.5D
+     * buyer view; all authoring and inventory identities remain unchanged. */
+    initialView?: RendererViewMode;
     /**
      * Hide the "Powered by SeatLayer" attribution badge in the side panel foot.
      * The chart theme's own `hideBadge` flag (paid orgs) also hides it — the badge
@@ -722,9 +736,15 @@ declare class SeatPicker {
     private tipPos;
     private confirmEl;
     private confirmSeat;
+    private tableDialogEl;
+    private tableDialog;
+    private tableDialogHeld;
+    private tableDialogReturnFocus;
     private srEl;
     private baQty;
     private baCat;
+    /** Optional navigation-zone scope for buyer best-available. */
+    private baZone;
     /** "★ Best seats" premium quick-pick toggle — biases best-available to premium seats. */
     private baPremium;
     private bestAvailableConfirm;
@@ -737,6 +757,7 @@ declare class SeatPicker {
     /** Resolved colorblind-safe state — stored preference wins over the option. */
     private cbSafe;
     private rungsEl;
+    private projectionEl;
     private floorsEl;
     private secCardEl;
     private viewEl;
@@ -773,10 +794,17 @@ declare class SeatPicker {
     private framedFs;
     /** Last height (px) posted to a host frame; dedupes redundant reports. */
     private lastPostedHeight;
+    /** True when the chart carries a real performance anchor — a stage-kind shape.
+     *  Every chart has a `focalPoint` (a bare look-at coordinate), so its presence
+     *  alone never justifies a "to stage" claim; only an actual stage does. */
+    private chartHasStage;
     /**
-     * Eager sightline preview for the confirm card: a cheap generated forward
-     * view (or the organizer's real photo) plus a "Nm to stage · clear
-     * sightline" line — the premium at-a-glance moment; click opens the 360.
+     * Eager sightline preview for the confirm card: the organizer's real view
+     * photo, or — only when the chart has an actual stage to look at — a generated
+     * forward view plus an "≈ Nm to stage · clear sightline" line. On a stageless
+     * chart both the distance/sightline claim and the generic stage silhouette are
+     * invented promises, so we suppress them; a real attached photo always shows.
+     * (OV-52)
      */
     private confirmThumbHtml;
     /** Minimal HTML/attribute escaper for buyer-authored commercial text (notes). */
@@ -793,6 +821,9 @@ declare class SeatPicker {
     /** Small ◐ limited-view marker for a cart chip; title/aria uses the seat's
      *  note when present, else the generic view label. '' for a clear-view seat. */
     private commercialChipMarker;
+    private wheelchairProvisionLabel;
+    private wheelchairConfirmHtml;
+    private wheelchairChipMarker;
     /** True when the picker is rendered inside an iframe (snippet embed at /e/:key). */
     private isFramed;
     /**
@@ -953,10 +984,11 @@ declare class SeatPicker {
     /** Build the compact price selector in the panel header. Choosing a band both
      *  filters availability and smoothly frames the matching seats on the map. */
     private buildPriceFilter;
-    /** Build the rung pills (charts with sections) and floor switcher (>1 floor). */
+    /** Build projection, rung and floor controls for arena-scale charts. */
     private buildArenaChrome;
     /** Reflect the engine's current LOD rung onto the pill group. */
     private syncRung;
+    private syncProjection;
     /** Reflect the active floor onto the switcher rail. */
     private syncFloors;
     /** Show (or clear, on null) the tapped-section summary card. */
@@ -979,6 +1011,11 @@ declare class SeatPicker {
     private sectionCardCoverage;
     /** aria-live readout when keyboard focus lands on a seat. */
     private announceSeat;
+    private showTableDialog;
+    private renderTableDialogState;
+    private confirmTableDialog;
+    private cancelTableDialog;
+    private dismissTableDialog;
     private showConfirm;
     private reanchorConfirm;
     private dismissConfirm;
@@ -1060,6 +1097,19 @@ declare class SeatPicker {
     private rowShort;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /** Current colorblind-safe render state, resolved from the stored buyer
+     *  preference at mount. Host chrome (e.g. the Designer preview) reads this to
+     *  surface the state rather than rendering colorblind colors silently. */
+    isColorblindSafe(): boolean;
+    /** Single source of truth for the colorblind-safe toggle — used by both the
+     *  in-widget button and host chrome. Updates the renderer, the persisted
+     *  cross-surface preference, and the in-widget button's pressed state together
+     *  so the two controls never diverge. */
+    setColorblindSafe(on: boolean): void;
+    /** Switch the buyer canvas between flat, isometric and Perspective 2.5D. */
+    setViewMode(mode: RendererViewMode): void;
+    /** Current buyer canvas projection. */
+    getViewMode(): RendererViewMode;
     /** Current active/restored hold reflected in the tray. */
     getCurrentHold(): HoldResult | null;
     /** Explicit host-driven hold restore (automatic session restore is on by default). */
@@ -1068,6 +1118,7 @@ declare class SeatPicker {
     removeHeldTicket(label: string): Promise<boolean>;
     bestAvailable(qty: number, categoryKey?: string, opts?: {
         preferPremium?: boolean;
+        zoneId?: string;
     }): Promise<HoldResult | null>;
     release(): Promise<void>;
     destroy(): void;