@seatlayer/js 0.67.15 → 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;
@@ -746,9 +756,11 @@ interface SeatingChartOptions {
     event: string;
     /** API origin. Defaults to https://api.seatlayer.io. */
     apiBase?: string;
-    /** Reserved for future authenticated rendering — accepted + stored, not yet sent.
-     *  NOT the channel-access credential: a buyer access session is a different
-     *  thing with different authority, and uses the two options below. */
+    /**
+     * Publishable account key for direct Public-sale bootstrap of a Platform/SDK
+     * Event. It is never buyer identity and cannot request private inventory.
+     * An explicit buyer-access provider/token below always takes precedence.
+     */
     publicKey?: string;
     /**
      * Buyer access session provider — the recommended way to render private
@@ -818,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
@@ -904,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).
@@ -916,10 +939,17 @@ interface SeatingChartOptions {
 declare class SeatingChart {
     private readonly opts;
     private readonly controller;
-    /** Reserved for future authenticated rendering — stored, not yet sent on any request. */
+    /** Publishable key used only by the public-only direct bootstrap path. */
     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;
@@ -931,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;
@@ -938,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>;
     /**
@@ -1123,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. */
@@ -1776,9 +1840,16 @@ interface SeatPickerOptions {
      * SeatLayer dashboard's own transport) or a fully local mock (demos).
      */
     transport?: PickerTransport;
-    /** Reserved for future authenticated rendering. NOT the channel-access
-     *  credential — a buyer access session is a different thing with different
-     *  authority, and uses the two options below. */
+    /**
+     * Publishable account key (`pk_live_…` / `pk_test_…`) for a public
+     * Platform/SDK Event. With no explicit buyer-access token/provider, the SDK
+     * uses it to bootstrap one origin-bound, Public-sale-only session directly
+     * from SeatLayer and receives chart + inventory in the same request.
+     *
+     * This is not buyer identity and cannot request private channels. An explicit
+     * `buyerAccessTokenProvider` or `buyerAccessToken` below always takes
+     * precedence for login, presale, partner or other scoped inventory.
+     */
     publicKey?: string;
     /**
      * Buyer access session provider — the recommended way to show private channel
@@ -2232,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;
@@ -2742,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.
@@ -2999,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;
@@ -3094,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. */
@@ -3212,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;
@@ -3306,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;
@@ -746,9 +756,11 @@ interface SeatingChartOptions {
     event: string;
     /** API origin. Defaults to https://api.seatlayer.io. */
     apiBase?: string;
-    /** Reserved for future authenticated rendering — accepted + stored, not yet sent.
-     *  NOT the channel-access credential: a buyer access session is a different
-     *  thing with different authority, and uses the two options below. */
+    /**
+     * Publishable account key for direct Public-sale bootstrap of a Platform/SDK
+     * Event. It is never buyer identity and cannot request private inventory.
+     * An explicit buyer-access provider/token below always takes precedence.
+     */
     publicKey?: string;
     /**
      * Buyer access session provider — the recommended way to render private
@@ -818,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
@@ -904,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).
@@ -916,10 +939,17 @@ interface SeatingChartOptions {
 declare class SeatingChart {
     private readonly opts;
     private readonly controller;
-    /** Reserved for future authenticated rendering — stored, not yet sent on any request. */
+    /** Publishable key used only by the public-only direct bootstrap path. */
     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;
@@ -931,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;
@@ -938,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>;
     /**
@@ -1123,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. */
@@ -1776,9 +1840,16 @@ interface SeatPickerOptions {
      * SeatLayer dashboard's own transport) or a fully local mock (demos).
      */
     transport?: PickerTransport;
-    /** Reserved for future authenticated rendering. NOT the channel-access
-     *  credential — a buyer access session is a different thing with different
-     *  authority, and uses the two options below. */
+    /**
+     * Publishable account key (`pk_live_…` / `pk_test_…`) for a public
+     * Platform/SDK Event. With no explicit buyer-access token/provider, the SDK
+     * uses it to bootstrap one origin-bound, Public-sale-only session directly
+     * from SeatLayer and receives chart + inventory in the same request.
+     *
+     * This is not buyer identity and cannot request private channels. An explicit
+     * `buyerAccessTokenProvider` or `buyerAccessToken` below always takes
+     * precedence for login, presale, partner or other scoped inventory.
+     */
     publicKey?: string;
     /**
      * Buyer access session provider — the recommended way to show private channel
@@ -2232,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;
@@ -2742,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.
@@ -2999,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;
@@ -3094,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. */
@@ -3212,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;
@@ -3306,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;
     /**