@seatlayer/js 0.68.0 → 0.69.0

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,19 @@ declare class SeatingChart {
     /** Null for the ordinary public chart — the tokenless path is untouched. */
     private readonly access;
     private readonly api;
+    private readonly apiBase;
+    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 +1166,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,9 +2304,11 @@ 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;
+    private suppressConfirmationSeatId;
     private tableDialogEl;
     private tableDialog;
     private tableDialogHeld;
@@ -2563,6 +2628,26 @@ declare class SeatPicker implements GaPromptPicker {
      * the sheet head (narrow). Never floats over the seats at the tap point.
      */
     private renderSectionCard;
+    /**
+     * Flag the root while the phone locator is docked to the map's bottom edge,
+     * so the map's own bottom-corner controls lift above it. The bar owns that
+     * edge outright — without this the minimap/accessibility cluster and the
+     * zoom/fit/eye stack sit underneath it and only their rounded corners show.
+     */
+    private syncLocatorDock;
+    /**
+     * THE COUNT IS NEVER TRUNCATED. At 390px the strip carries a dot, the section
+     * name, the seats-left count, prev/next, and a "‹ Overview" chip; when that
+     * ran long the count was the flex item that shrank, and "73 seats left"
+     * clipped to "7" — not a smaller answer but a WRONG one, and one the buyer
+     * has no way to tell is wrong. The name is the answer to "where am I" and
+     * keeps its room; the count yields, in order: full text → short form
+     * ("7 left") → gone. Gone is honest; a clipped number is not.
+     *
+     * Re-run on every real host resize, so a rotation or a resized embed that
+     * makes room gives the long form back.
+     */
+    private fitSectionStripCount;
     /** Collapse the expanded card to its slim pill (seat-picking started). */
     private collapseSectionCard;
     /**
@@ -2749,8 +2834,8 @@ declare class SeatPicker implements GaPromptPicker {
      * group whose wrapper did not supply the nights.
      */
     private nightStripFor;
-    /** Close a tapped-open card. Safe to call when nothing is pinned. */
     private unpinTooltip;
+    private handleMapPointerDown;
     private updateTooltip;
     /**
      * Push the wrapper's current seat marks at the renderer.
@@ -2765,6 +2850,7 @@ declare class SeatPicker implements GaPromptPicker {
     getSelection(): PickerSeat[];
     /** Select free objects by engine id or public label. */
     selectObjects(objects: string[]): PickerSeat[];
+    selectObjectsWithoutConfirmation(objects: string[]): PickerSeat[];
     /** Deselect objects by engine id or public label. */
     deselectObjects(objects: string[]): void;
     /** Clear every unheld selection. */
@@ -3008,6 +3094,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 +3190,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. */
@@ -3159,6 +3248,8 @@ interface PerformanceGroupPickerOptions {
         view: SeatPickerBuyerView;
         seatId?: string;
     }) => void;
+    /** Receives the underlying chart journey with Performance Group identity attached. */
+    onAnalytics?: (event: string, props: Record<string, unknown>) => void;
     hideBadge?: boolean;
     theme?: SeatPickerTheme;
     holdTtlMs?: number;
@@ -3221,6 +3312,12 @@ declare class PerformanceGroupPicker {
     private progressHost;
     private legendHost;
     private paneHost;
+    private datesSummaryHost;
+    private datesCardsHost;
+    private resettingFlexibleSelection;
+    private selectingPartialSeat;
+    /** The free dates advertised by a two-tone seat before the chart is narrowed. */
+    private readonly partialSeatDates;
     /** Labels pushed at the renderer on the last pull, so departures clear. */
     private markedLabels;
     private holdTicker;
@@ -3315,6 +3412,12 @@ 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;
+    private applySeatDates;
     /** 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,19 @@ declare class SeatingChart {
     /** Null for the ordinary public chart — the tokenless path is untouched. */
     private readonly access;
     private readonly api;
+    private readonly apiBase;
+    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 +1166,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,9 +2304,11 @@ 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;
+    private suppressConfirmationSeatId;
     private tableDialogEl;
     private tableDialog;
     private tableDialogHeld;
@@ -2563,6 +2628,26 @@ declare class SeatPicker implements GaPromptPicker {
      * the sheet head (narrow). Never floats over the seats at the tap point.
      */
     private renderSectionCard;
+    /**
+     * Flag the root while the phone locator is docked to the map's bottom edge,
+     * so the map's own bottom-corner controls lift above it. The bar owns that
+     * edge outright — without this the minimap/accessibility cluster and the
+     * zoom/fit/eye stack sit underneath it and only their rounded corners show.
+     */
+    private syncLocatorDock;
+    /**
+     * THE COUNT IS NEVER TRUNCATED. At 390px the strip carries a dot, the section
+     * name, the seats-left count, prev/next, and a "‹ Overview" chip; when that
+     * ran long the count was the flex item that shrank, and "73 seats left"
+     * clipped to "7" — not a smaller answer but a WRONG one, and one the buyer
+     * has no way to tell is wrong. The name is the answer to "where am I" and
+     * keeps its room; the count yields, in order: full text → short form
+     * ("7 left") → gone. Gone is honest; a clipped number is not.
+     *
+     * Re-run on every real host resize, so a rotation or a resized embed that
+     * makes room gives the long form back.
+     */
+    private fitSectionStripCount;
     /** Collapse the expanded card to its slim pill (seat-picking started). */
     private collapseSectionCard;
     /**
@@ -2749,8 +2834,8 @@ declare class SeatPicker implements GaPromptPicker {
      * group whose wrapper did not supply the nights.
      */
     private nightStripFor;
-    /** Close a tapped-open card. Safe to call when nothing is pinned. */
     private unpinTooltip;
+    private handleMapPointerDown;
     private updateTooltip;
     /**
      * Push the wrapper's current seat marks at the renderer.
@@ -2765,6 +2850,7 @@ declare class SeatPicker implements GaPromptPicker {
     getSelection(): PickerSeat[];
     /** Select free objects by engine id or public label. */
     selectObjects(objects: string[]): PickerSeat[];
+    selectObjectsWithoutConfirmation(objects: string[]): PickerSeat[];
     /** Deselect objects by engine id or public label. */
     deselectObjects(objects: string[]): void;
     /** Clear every unheld selection. */
@@ -3008,6 +3094,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 +3190,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. */
@@ -3159,6 +3248,8 @@ interface PerformanceGroupPickerOptions {
         view: SeatPickerBuyerView;
         seatId?: string;
     }) => void;
+    /** Receives the underlying chart journey with Performance Group identity attached. */
+    onAnalytics?: (event: string, props: Record<string, unknown>) => void;
     hideBadge?: boolean;
     theme?: SeatPickerTheme;
     holdTtlMs?: number;
@@ -3221,6 +3312,12 @@ declare class PerformanceGroupPicker {
     private progressHost;
     private legendHost;
     private paneHost;
+    private datesSummaryHost;
+    private datesCardsHost;
+    private resettingFlexibleSelection;
+    private selectingPartialSeat;
+    /** The free dates advertised by a two-tone seat before the chart is narrowed. */
+    private readonly partialSeatDates;
     /** Labels pushed at the renderer on the last pull, so departures clear. */
     private markedLabels;
     private holdTicker;
@@ -3315,6 +3412,12 @@ 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;
+    private applySeatDates;
     /** One tick a second while a hold is live, so the countdown line is true. */
     private syncHoldTicker;
     /**