@seatlayer/js 0.68.0 → 0.68.1

package/dist/index.d.cts

@@ -615,6 +615,9 @@ interface GaPromptPicker {
     onGAPromptHook?: ((prompt: GAPromptRequest) => boolean | void) | undefined;
 }
 
+type SeatingChartBuyerView = 'map' | 'venue3d';
+type SeatingChartNavigationMode = 'orbit' | 'pan';
+
 /**
  * SeatingChart — the embeddable buyer picker.
  *
@@ -681,6 +684,10 @@ interface SeatingChartPickerState {
         bestAvailable: boolean;
         accessibilityFilter: boolean;
         limitedViewFilter: boolean;
+        /** Real lazy-loaded WebGL venue view, not the retired isometric projection. */
+        venue3d: boolean;
+        /** Authored or chart-derived view-from-seat panorama. */
+        seatView: boolean;
     };
     catalog: {
         categories: Array<{
@@ -723,6 +730,9 @@ interface SeatingChartPickerState {
         focusedSectionId: string | null;
         focusedSection: SectionSummary | null;
         viewMode: RendererViewMode;
+        buyerView: SeatingChartBuyerView;
+        view3dTargetSeatId: string | null;
+        view3dNavigationMode: SeatingChartNavigationMode;
         colorblindSafe: boolean;
         categoryFilter: string[] | null;
         accessibilityFilter: string[] | null;
@@ -820,6 +830,12 @@ interface SeatingChartOptions {
      * real 3D venue view (`setBuyerView('venue3d')`); they remain accepted for
      * source compatibility and will be removed in the next major. Use `'flat'`. */
     initialView?: RendererViewMode;
+    /** Offer the real, lazy-loaded interactive venue view. Default true. */
+    enable3D?: boolean;
+    /** Offer authored/generated view-from-seat inspection. Default true. */
+    enableSeatView?: boolean;
+    /** Optional device-specific ceiling for offering the venue WebGL scene. */
+    max3DSeats?: number;
     /**
      * Built-in seat tooltip on mouse hover (seat · category · price · status).
      * Rendered inside the widget so every host gets it; default true. Turn off
@@ -906,8 +922,13 @@ interface SeatingChartOptions {
     onSalesClosed?: () => void;
     /** A programmatic/native map-control action changed serializable map state. */
     onMapStateChange?: () => void;
-    /** Pan/zoom/resize settled; useful for host overlays and native map controls. */
+    /** rAF-coalesced camera-frame signal for in-page overlays; not native state. */
     onViewChange?: () => void;
+    /** Real buyer-view transitions and 3D camera targets. */
+    onBuyerViewChange?: (state: {
+        view: SeatingChartBuyerView;
+        seatId?: string;
+    }) => void;
     /**
      * Non-blocking, localized selection advice — currently the orphan-seat hint
      * (the selection would strand a single free seat between taken neighbors).
@@ -922,6 +943,13 @@ declare class SeatingChart {
     readonly publicKey?: string;
     private mount;
     private hostEl;
+    /**
+     * Native hosts can render a Flutter/Swift/Kotlin decision surface above this
+     * DOM tree. UIKit platform views still participate in hit testing beneath a
+     * composited native overlay, so the runtime must be able to make its own DOM
+     * inert rather than relying on the host's visual stacking alone.
+     */
+    private interactionEnabled_;
     /** The organizer's language for this event, learned when the chart resolves. */
     private eventLocale;
     private rendered;
@@ -933,6 +961,8 @@ declare class SeatingChart {
     private accessibilityFilter_;
     private hideLimitedView_;
     private focusedSection_;
+    /** Last rung already exposed to native chrome; raw camera frames stay in-canvas. */
+    private lastReportedViewRung_;
     private accessState_;
     private tipEl;
     private tipPos;
@@ -940,8 +970,18 @@ declare class SeatingChart {
     /** Null for the ordinary public chart — the tokenless path is untouched. */
     private readonly access;
     private readonly api;
+    private readonly buyerAssetUrls;
+    private readonly immersive;
     private realtime;
     constructor(options: SeatingChartOptions);
+    /**
+     * Camera x/y/scale is renderer-local and deliberately absent from the native
+     * picker snapshot. Keep pan and pinch frames on the canvas; only a semantic
+     * rung transition needs to wake native chrome.
+     */
+    private handleViewChange;
+    /** Record the current rung before publishing an explicit state mutation. */
+    private notifyMapStateChange;
     /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */
     render(): Promise<this>;
     /**
@@ -1125,6 +1165,28 @@ declare class SeatingChart {
     zoomOut(): void;
     /** Reset the camera so the whole chart fits the container. */
     zoomToFit(): void;
+    /** Enter or leave the same real lazy-loaded venue scene as SeatPicker. */
+    setBuyerView(view: SeatingChartBuyerView, options?: {
+        flyToSeatId?: string;
+        resetView?: boolean;
+    }): Promise<void>;
+    getBuyerView(): SeatingChartBuyerView;
+    /** Open an authored or chart-derived 360° view for one physical seat. */
+    openSeatView(seatId: string): Promise<void>;
+    /** Explicit Rotate / Move control for native and custom picker chrome. */
+    setVenue3DNavigationMode(mode: SeatingChartNavigationMode): void;
+    /**
+     * Enable or suppress all buyer input inside this chart without unmounting it.
+     *
+     * Native SDKs use this while a native confirmation, quantity prompt, loading
+     * surface or error surface owns the chart area. Disabling input in the DOM is
+     * intentional: an iOS WKWebView can receive the same physical tap beneath a
+     * Flutter overlay even when the Flutter widget is wrapped in IgnorePointer.
+     * Programmatic bridge commands continue to work, so a prompt can still open
+     * view-from-seat or 3D and then re-enable interaction after the handoff.
+     */
+    setInteractionEnabled(enabled: boolean): void;
+    private applyInteractionState;
     /** Release the current hold (if any). No-op when nothing is held. */
     release(): Promise<void>;
     /** Release selected labels from the current hold while keeping the remainder. */
@@ -2241,6 +2303,7 @@ declare class SeatPicker implements GaPromptPicker {
     private tipPos;
     /** True while a TAPPED seat card is held open (touch has no hover to lose). */
     private tipPinned;
+    private tipMarkedHoverLabel;
     private lastPointerType;
     private confirmEl;
     private confirmSeat;
@@ -2751,6 +2814,8 @@ declare class SeatPicker implements GaPromptPicker {
     private nightStripFor;
     /** Close a tapped-open card. Safe to call when nothing is pinned. */
     private unpinTooltip;
+    /** A press outside the card dismisses it; its own controls must reach click. */
+    private handleMapPointerDown;
     private updateTooltip;
     /**
      * Push the wrapper's current seat marks at the renderer.
@@ -3008,6 +3073,7 @@ interface PerformanceGroupDescriptor {
     venue: string;
     timezone: string | null;
     inventoryModelVersion: 2;
+    inclusionMode?: 'fixed' | 'flexible_dates';
     performanceCount: number;
     /** Present when the server versions the inclusion set. See {@link PerformanceGroupAvailability}. */
     revision?: string;
@@ -3103,6 +3169,8 @@ interface PerformanceGroupCheckoutHandoff {
     expiresAt: number;
     performanceGroup: PerformanceGroupDescriptor;
     selectionMode: PerformanceGroupSelectionMode;
+    /** Performances actually included in this hold (all members for fixed groups). */
+    performanceKeys: string[];
     /** Logical booking identities only. Re-inspect the opaque hold on your server. */
     seatLabels: string[];
     /** Present for per-performance selection. Prices and child hold IDs remain server-only. */
@@ -3221,6 +3289,9 @@ declare class PerformanceGroupPicker {
     private progressHost;
     private legendHost;
     private paneHost;
+    private datesSummaryHost;
+    private datesCardsHost;
+    private resettingFlexibleSelection;
     /** Labels pushed at the renderer on the last pull, so departures clear. */
     private markedLabels;
     private holdTicker;
@@ -3315,6 +3386,11 @@ declare class PerformanceGroupPicker {
      * the buyer could reasonably hold us to.
      */
     private heldTotal;
+    private includedPerformances;
+    /** Keep the persistent date promise aligned with the subset used by HOLD. */
+    private syncIncludedDates;
+    /** Turn one two-tone seat into a normal selection without changing charts. */
+    private selectPartialSeat;
     /** One tick a second while a hold is live, so the countdown line is true. */
     private syncHoldTicker;
     /**

package/dist/index.d.ts

@@ -615,6 +615,9 @@ interface GaPromptPicker {
     onGAPromptHook?: ((prompt: GAPromptRequest) => boolean | void) | undefined;
 }
 
+type SeatingChartBuyerView = 'map' | 'venue3d';
+type SeatingChartNavigationMode = 'orbit' | 'pan';
+
 /**
  * SeatingChart — the embeddable buyer picker.
  *
@@ -681,6 +684,10 @@ interface SeatingChartPickerState {
         bestAvailable: boolean;
         accessibilityFilter: boolean;
         limitedViewFilter: boolean;
+        /** Real lazy-loaded WebGL venue view, not the retired isometric projection. */
+        venue3d: boolean;
+        /** Authored or chart-derived view-from-seat panorama. */
+        seatView: boolean;
     };
     catalog: {
         categories: Array<{
@@ -723,6 +730,9 @@ interface SeatingChartPickerState {
         focusedSectionId: string | null;
         focusedSection: SectionSummary | null;
         viewMode: RendererViewMode;
+        buyerView: SeatingChartBuyerView;
+        view3dTargetSeatId: string | null;
+        view3dNavigationMode: SeatingChartNavigationMode;
         colorblindSafe: boolean;
         categoryFilter: string[] | null;
         accessibilityFilter: string[] | null;
@@ -820,6 +830,12 @@ interface SeatingChartOptions {
      * real 3D venue view (`setBuyerView('venue3d')`); they remain accepted for
      * source compatibility and will be removed in the next major. Use `'flat'`. */
     initialView?: RendererViewMode;
+    /** Offer the real, lazy-loaded interactive venue view. Default true. */
+    enable3D?: boolean;
+    /** Offer authored/generated view-from-seat inspection. Default true. */
+    enableSeatView?: boolean;
+    /** Optional device-specific ceiling for offering the venue WebGL scene. */
+    max3DSeats?: number;
     /**
      * Built-in seat tooltip on mouse hover (seat · category · price · status).
      * Rendered inside the widget so every host gets it; default true. Turn off
@@ -906,8 +922,13 @@ interface SeatingChartOptions {
     onSalesClosed?: () => void;
     /** A programmatic/native map-control action changed serializable map state. */
     onMapStateChange?: () => void;
-    /** Pan/zoom/resize settled; useful for host overlays and native map controls. */
+    /** rAF-coalesced camera-frame signal for in-page overlays; not native state. */
     onViewChange?: () => void;
+    /** Real buyer-view transitions and 3D camera targets. */
+    onBuyerViewChange?: (state: {
+        view: SeatingChartBuyerView;
+        seatId?: string;
+    }) => void;
     /**
      * Non-blocking, localized selection advice — currently the orphan-seat hint
      * (the selection would strand a single free seat between taken neighbors).
@@ -922,6 +943,13 @@ declare class SeatingChart {
     readonly publicKey?: string;
     private mount;
     private hostEl;
+    /**
+     * Native hosts can render a Flutter/Swift/Kotlin decision surface above this
+     * DOM tree. UIKit platform views still participate in hit testing beneath a
+     * composited native overlay, so the runtime must be able to make its own DOM
+     * inert rather than relying on the host's visual stacking alone.
+     */
+    private interactionEnabled_;
     /** The organizer's language for this event, learned when the chart resolves. */
     private eventLocale;
     private rendered;
@@ -933,6 +961,8 @@ declare class SeatingChart {
     private accessibilityFilter_;
     private hideLimitedView_;
     private focusedSection_;
+    /** Last rung already exposed to native chrome; raw camera frames stay in-canvas. */
+    private lastReportedViewRung_;
     private accessState_;
     private tipEl;
     private tipPos;
@@ -940,8 +970,18 @@ declare class SeatingChart {
     /** Null for the ordinary public chart — the tokenless path is untouched. */
     private readonly access;
     private readonly api;
+    private readonly buyerAssetUrls;
+    private readonly immersive;
     private realtime;
     constructor(options: SeatingChartOptions);
+    /**
+     * Camera x/y/scale is renderer-local and deliberately absent from the native
+     * picker snapshot. Keep pan and pinch frames on the canvas; only a semantic
+     * rung transition needs to wake native chrome.
+     */
+    private handleViewChange;
+    /** Record the current rung before publishing an explicit state mutation. */
+    private notifyMapStateChange;
     /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */
     render(): Promise<this>;
     /**
@@ -1125,6 +1165,28 @@ declare class SeatingChart {
     zoomOut(): void;
     /** Reset the camera so the whole chart fits the container. */
     zoomToFit(): void;
+    /** Enter or leave the same real lazy-loaded venue scene as SeatPicker. */
+    setBuyerView(view: SeatingChartBuyerView, options?: {
+        flyToSeatId?: string;
+        resetView?: boolean;
+    }): Promise<void>;
+    getBuyerView(): SeatingChartBuyerView;
+    /** Open an authored or chart-derived 360° view for one physical seat. */
+    openSeatView(seatId: string): Promise<void>;
+    /** Explicit Rotate / Move control for native and custom picker chrome. */
+    setVenue3DNavigationMode(mode: SeatingChartNavigationMode): void;
+    /**
+     * Enable or suppress all buyer input inside this chart without unmounting it.
+     *
+     * Native SDKs use this while a native confirmation, quantity prompt, loading
+     * surface or error surface owns the chart area. Disabling input in the DOM is
+     * intentional: an iOS WKWebView can receive the same physical tap beneath a
+     * Flutter overlay even when the Flutter widget is wrapped in IgnorePointer.
+     * Programmatic bridge commands continue to work, so a prompt can still open
+     * view-from-seat or 3D and then re-enable interaction after the handoff.
+     */
+    setInteractionEnabled(enabled: boolean): void;
+    private applyInteractionState;
     /** Release the current hold (if any). No-op when nothing is held. */
     release(): Promise<void>;
     /** Release selected labels from the current hold while keeping the remainder. */
@@ -2241,6 +2303,7 @@ declare class SeatPicker implements GaPromptPicker {
     private tipPos;
     /** True while a TAPPED seat card is held open (touch has no hover to lose). */
     private tipPinned;
+    private tipMarkedHoverLabel;
     private lastPointerType;
     private confirmEl;
     private confirmSeat;
@@ -2751,6 +2814,8 @@ declare class SeatPicker implements GaPromptPicker {
     private nightStripFor;
     /** Close a tapped-open card. Safe to call when nothing is pinned. */
     private unpinTooltip;
+    /** A press outside the card dismisses it; its own controls must reach click. */
+    private handleMapPointerDown;
     private updateTooltip;
     /**
      * Push the wrapper's current seat marks at the renderer.
@@ -3008,6 +3073,7 @@ interface PerformanceGroupDescriptor {
     venue: string;
     timezone: string | null;
     inventoryModelVersion: 2;
+    inclusionMode?: 'fixed' | 'flexible_dates';
     performanceCount: number;
     /** Present when the server versions the inclusion set. See {@link PerformanceGroupAvailability}. */
     revision?: string;
@@ -3103,6 +3169,8 @@ interface PerformanceGroupCheckoutHandoff {
     expiresAt: number;
     performanceGroup: PerformanceGroupDescriptor;
     selectionMode: PerformanceGroupSelectionMode;
+    /** Performances actually included in this hold (all members for fixed groups). */
+    performanceKeys: string[];
     /** Logical booking identities only. Re-inspect the opaque hold on your server. */
     seatLabels: string[];
     /** Present for per-performance selection. Prices and child hold IDs remain server-only. */
@@ -3221,6 +3289,9 @@ declare class PerformanceGroupPicker {
     private progressHost;
     private legendHost;
     private paneHost;
+    private datesSummaryHost;
+    private datesCardsHost;
+    private resettingFlexibleSelection;
     /** Labels pushed at the renderer on the last pull, so departures clear. */
     private markedLabels;
     private holdTicker;
@@ -3315,6 +3386,11 @@ declare class PerformanceGroupPicker {
      * the buyer could reasonably hold us to.
      */
     private heldTotal;
+    private includedPerformances;
+    /** Keep the persistent date promise aligned with the subset used by HOLD. */
+    private syncIncludedDates;
+    /** Turn one two-tone seat into a normal selection without changing charts. */
+    private selectPartialSeat;
     /** One tick a second while a hold is live, so the countdown line is true. */
     private syncHoldTicker;
     /**