@seatlayer/js 0.71.3 → 0.71.5

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, SeatHoverDetails, SectionSummary, ChartTheme, LodRung, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AvailabilityRefreshOutcome, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 import { T as ThemeMode } from './channelsMode-goczEzyt.cjs';
 export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, U as InventoryBookingObject, V as InventoryBookingState, W as InventoryBookingsPage, X as InventoryBookingsQuery, Y as LogEntry, Z as LogPage, _ as ManageApi, $ as ManageApiError, a0 as ReportByStatus, a1 as ReportCategoryMeta, a2 as ReportCategoryRow, a3 as ReportResult, a4 as SeatManager, a5 as SeatManagerActionResult, a6 as SeatManagerActivity, a7 as SeatManagerCapability, a8 as SeatManagerConnection, a9 as SeatManagerFilteredSection, aa as SeatManagerMode, ab as SeatManagerOptions, ac as SeatManagerSelectionValidity, ad as SeatManagerTallies, ae as SelectionSourceRow } from './channelsMode-goczEzyt.cjs';
@@ -620,6 +620,24 @@ interface GaPromptPicker {
 
 type SeatingChartBuyerView = 'map' | 'venue3d';
 type SeatingChartNavigationMode = 'orbit' | 'pan';
+/** What the 2D seat-view panorama is showing, and what it would say about it. */
+interface SeatingChartSeatViewInfo {
+    seatId: string;
+    /** e.g. `View from Stalls D · C-6`. */
+    title: string;
+    /** The disclosure line: an authored capture's provenance, or the generated
+     *  illustration's distance-from-stage note. */
+    caption: string;
+    /** The badge word — the localized `Real 360°` or `Preview`. */
+    badge: string;
+    /** True for an AUTHORED capture of the real seat; false for one the engine
+     *  drew from the venue's geometry. */
+    real: boolean;
+    /** True when the panorama was synthesised rather than fetched. */
+    generated: boolean;
+    /** The pointer instruction the modal would print over the image. */
+    dragHint: string;
+}
 
 /**
  * Buyer-safe ticket-offer availability shared by the canonical picker and the
@@ -1273,35 +1291,6 @@ interface SeatPickerOptions {
     onError?: (err: unknown) => void;
 }
 
-/**
- * SeatingChart — the embeddable buyer picker.
- *
- * A thin wrapper over the shared PickerController (src/picker/PickerController):
- * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
- * the holdId to the host page for a server-side book) and delegates all transport
- * + booking to the controller, so the SDK inherits every fix made for the live
- * buyer page and the demo picker.
- */
-
-/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
-type SelectedSeat = PickerSeat;
-interface GAAreaAvailability {
-    id: string;
-    label: string;
-    capacity: number;
-    available: number;
-    categoryKey: string;
-    price: number;
-    currency: string;
-    /** Buyer-facing copy authored separately from stable inventory identity. */
-    displayLabel?: string;
-    displayType?: string;
-    tiers?: Array<{
-        id: string;
-        name: string;
-        price: number;
-    }>;
-}
 /**
  * Serializable state exposed to hosted native picker chrome. It deliberately
  * contains buyer-display data only: never API keys, buyer-access bearers,
@@ -1381,6 +1370,10 @@ interface SeatingChartPickerState {
             name: string;
         }>;
         activeFloorId: string | null;
+        /** `'all'` = the stacked whole-venue view; `'single'` = one floor. */
+        floorMode: 'all' | 'single';
+        /** How the stacked view marks each level. */
+        floorLabelStyle: FloorLabelStyle;
         rung: LodRung;
         focusedSectionId: string | null;
         focusedSection: SectionSummary | null;
@@ -1400,6 +1393,18 @@ interface SeatingChartPickerState {
         categoryFilter: string[] | null;
         accessibilityFilter: string[] | null;
         hideLimitedView: boolean;
+        /**
+         * The access needs THIS event actually offers, with live free counts, in
+         * the engine's canonical order.
+         *
+         * A native or web sheet that renders the whole twelve-key taxonomy offers
+         * provisions the chart does not have — chips that filter to an empty map,
+         * which reads as a venue that has the provision and has sold out of it.
+         * A provision that exists but is currently all taken appears here with
+         * `count: 0`, so "this venue has none" and "this venue's are taken" stay
+         * different answers. Empty on a chart with no accessible inventory.
+         */
+        accessNeeds: PickerAccessNeed[];
     };
     selection: {
         seats: SelectedSeat[];
@@ -1412,6 +1417,36 @@ interface SeatingChartPickerState {
         reason?: string;
     };
 }
+
+/**
+ * SeatingChart — the embeddable buyer picker.
+ *
+ * A thin wrapper over the shared PickerController (src/picker/PickerController):
+ * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
+ * the holdId to the host page for a server-side book) and delegates all transport
+ * + booking to the controller, so the SDK inherits every fix made for the live
+ * buyer page and the demo picker.
+ */
+
+/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
+type SelectedSeat = PickerSeat;
+interface GAAreaAvailability {
+    id: string;
+    label: string;
+    capacity: number;
+    available: number;
+    categoryKey: string;
+    price: number;
+    currency: string;
+    /** Buyer-facing copy authored separately from stable inventory identity. */
+    displayLabel?: string;
+    displayType?: string;
+    tiers?: Array<{
+        id: string;
+        name: string;
+        price: number;
+    }>;
+}
 interface SeatingChartOptions {
     /** CSS selector or an HTMLElement to render into. */
     container: string | HTMLElement;
@@ -1582,11 +1617,21 @@ interface SeatingChartOptions {
      *  camera dock come from inside the lazy venue chunk, where an embedding
      *  host had no way to reach them — so a native shell that already draws all
      *  three drew them twice. Absent or `true` = drawn, exactly as before. */
+    /** The 2D panorama's title/caption/badge join the 3D pieces here — the full
+     *  table is bridge/nativeChrome.ts. */
     chrome?: {
         view3dCaption?: boolean;
         view3dSeatStepper?: boolean;
         view3dControlDock?: boolean;
+        seatViewTitle?: boolean;
+        seatViewCaption?: boolean;
+        seatViewBadge?: boolean;
     };
+    /** The 2D panorama opened, or closed (`null`). Fires whether or not the web
+     *  drew its words, so a host that suppressed them has the exact strings. */
+    onSeatViewChange?: (info: SeatingChartSeatViewInfo | null) => void;
+    /** How the stacked "All floors" view marks each level. Default `'number'`. */
+    floorLabelStyle?: FloorLabelStyle;
     /**
      * Multi-floor charts only: fires when the buyer taps a deck in the stacked
      * 3D view, after the picker switches to that floor — lets the host page sync
@@ -1829,8 +1874,12 @@ declare class SeatingChart {
         id: string;
         name: string;
     }[];
-    /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */
+    /** Switch the shown floor (2D), or `'all'` for the stacked whole-venue view.
+     *  One control, not two: a strip whose first chip is "All floors" would
+     *  otherwise need a separate command for that one chip. */
     setFloor(floorId: string): void;
+    /** How the stacked view marks each level: a `G/1/2` badge, or floor names. */
+    setFloorLabelStyle(style: FloorLabelStyle): void;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
     /** Switch the 2D canvas projection.
@@ -1913,8 +1962,17 @@ declare class SeatingChart {
      * and its own legacy frames. Nothing about the public path changes.
      */
     private startRealtime;
-    /** Re-read live inventory without remounting or dropping buyer state. */
-    refreshAvailability(): Promise<void>;
+    /**
+     * Re-read OTHER buyers' inventory without remounting or disturbing this
+     * buyer's own — see `@seatlayer/core`'s `availabilityRefresh`.
+     *
+     * Returns what actually changed for him: seats he had selected but never
+     * held which somebody else has taken (already deselected), and whether his
+     * own hold lapsed while he was away, with the labels that are still free so
+     * a surface can offer them back. Nothing here moves the camera, the rung or
+     * the cart total, and a seat he holds is never reported against him.
+     */
+    refreshAvailability(): Promise<AvailabilityRefreshOutcome>;
     /**
      * Re-acquire the buyer access session — call after your app has re-authorized
      * the buyer (a revoked session cannot be recovered any other way). Resolves
@@ -2700,6 +2758,10 @@ declare class SeatPicker implements GaPromptPicker {
     private ctaPhase;
     /** The ♿ control and its menu — one node, in the map's bottom-left corner. */
     private a11yMenu;
+    private detachAttention;
+    /** The telling of a hold that ended while the buyer was away — the state
+     *  part is the engine's; see pickerHoldLapse.ts. */
+    private readonly lapse;
     /** Rail scroll listener attached once; the rail repaints many times. */
     private railEdgesBound;
     private fsFallback;
@@ -4002,4 +4064,4 @@ interface AttachPickerFrameOptions {
  */
 declare function attachPickerFrame(iframe: HTMLIFrameElement, opts?: AttachPickerFrameOptions): () => void;
 
-export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAvailability, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };
+export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAvailability, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, SeatHoverDetails, SectionSummary, ChartTheme, LodRung, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AvailabilityRefreshOutcome, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 import { T as ThemeMode } from './channelsMode-goczEzyt.js';
 export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, U as InventoryBookingObject, V as InventoryBookingState, W as InventoryBookingsPage, X as InventoryBookingsQuery, Y as LogEntry, Z as LogPage, _ as ManageApi, $ as ManageApiError, a0 as ReportByStatus, a1 as ReportCategoryMeta, a2 as ReportCategoryRow, a3 as ReportResult, a4 as SeatManager, a5 as SeatManagerActionResult, a6 as SeatManagerActivity, a7 as SeatManagerCapability, a8 as SeatManagerConnection, a9 as SeatManagerFilteredSection, aa as SeatManagerMode, ab as SeatManagerOptions, ac as SeatManagerSelectionValidity, ad as SeatManagerTallies, ae as SelectionSourceRow } from './channelsMode-goczEzyt.js';
@@ -620,6 +620,24 @@ interface GaPromptPicker {
 
 type SeatingChartBuyerView = 'map' | 'venue3d';
 type SeatingChartNavigationMode = 'orbit' | 'pan';
+/** What the 2D seat-view panorama is showing, and what it would say about it. */
+interface SeatingChartSeatViewInfo {
+    seatId: string;
+    /** e.g. `View from Stalls D · C-6`. */
+    title: string;
+    /** The disclosure line: an authored capture's provenance, or the generated
+     *  illustration's distance-from-stage note. */
+    caption: string;
+    /** The badge word — the localized `Real 360°` or `Preview`. */
+    badge: string;
+    /** True for an AUTHORED capture of the real seat; false for one the engine
+     *  drew from the venue's geometry. */
+    real: boolean;
+    /** True when the panorama was synthesised rather than fetched. */
+    generated: boolean;
+    /** The pointer instruction the modal would print over the image. */
+    dragHint: string;
+}
 
 /**
  * Buyer-safe ticket-offer availability shared by the canonical picker and the
@@ -1273,35 +1291,6 @@ interface SeatPickerOptions {
     onError?: (err: unknown) => void;
 }
 
-/**
- * SeatingChart — the embeddable buyer picker.
- *
- * A thin wrapper over the shared PickerController (src/picker/PickerController):
- * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
- * the holdId to the host page for a server-side book) and delegates all transport
- * + booking to the controller, so the SDK inherits every fix made for the live
- * buyer page and the demo picker.
- */
-
-/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
-type SelectedSeat = PickerSeat;
-interface GAAreaAvailability {
-    id: string;
-    label: string;
-    capacity: number;
-    available: number;
-    categoryKey: string;
-    price: number;
-    currency: string;
-    /** Buyer-facing copy authored separately from stable inventory identity. */
-    displayLabel?: string;
-    displayType?: string;
-    tiers?: Array<{
-        id: string;
-        name: string;
-        price: number;
-    }>;
-}
 /**
  * Serializable state exposed to hosted native picker chrome. It deliberately
  * contains buyer-display data only: never API keys, buyer-access bearers,
@@ -1381,6 +1370,10 @@ interface SeatingChartPickerState {
             name: string;
         }>;
         activeFloorId: string | null;
+        /** `'all'` = the stacked whole-venue view; `'single'` = one floor. */
+        floorMode: 'all' | 'single';
+        /** How the stacked view marks each level. */
+        floorLabelStyle: FloorLabelStyle;
         rung: LodRung;
         focusedSectionId: string | null;
         focusedSection: SectionSummary | null;
@@ -1400,6 +1393,18 @@ interface SeatingChartPickerState {
         categoryFilter: string[] | null;
         accessibilityFilter: string[] | null;
         hideLimitedView: boolean;
+        /**
+         * The access needs THIS event actually offers, with live free counts, in
+         * the engine's canonical order.
+         *
+         * A native or web sheet that renders the whole twelve-key taxonomy offers
+         * provisions the chart does not have — chips that filter to an empty map,
+         * which reads as a venue that has the provision and has sold out of it.
+         * A provision that exists but is currently all taken appears here with
+         * `count: 0`, so "this venue has none" and "this venue's are taken" stay
+         * different answers. Empty on a chart with no accessible inventory.
+         */
+        accessNeeds: PickerAccessNeed[];
     };
     selection: {
         seats: SelectedSeat[];
@@ -1412,6 +1417,36 @@ interface SeatingChartPickerState {
         reason?: string;
     };
 }
+
+/**
+ * SeatingChart — the embeddable buyer picker.
+ *
+ * A thin wrapper over the shared PickerController (src/picker/PickerController):
+ * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
+ * the holdId to the host page for a server-side book) and delegates all transport
+ * + booking to the controller, so the SDK inherits every fix made for the live
+ * buyer page and the demo picker.
+ */
+
+/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
+type SelectedSeat = PickerSeat;
+interface GAAreaAvailability {
+    id: string;
+    label: string;
+    capacity: number;
+    available: number;
+    categoryKey: string;
+    price: number;
+    currency: string;
+    /** Buyer-facing copy authored separately from stable inventory identity. */
+    displayLabel?: string;
+    displayType?: string;
+    tiers?: Array<{
+        id: string;
+        name: string;
+        price: number;
+    }>;
+}
 interface SeatingChartOptions {
     /** CSS selector or an HTMLElement to render into. */
     container: string | HTMLElement;
@@ -1582,11 +1617,21 @@ interface SeatingChartOptions {
      *  camera dock come from inside the lazy venue chunk, where an embedding
      *  host had no way to reach them — so a native shell that already draws all
      *  three drew them twice. Absent or `true` = drawn, exactly as before. */
+    /** The 2D panorama's title/caption/badge join the 3D pieces here — the full
+     *  table is bridge/nativeChrome.ts. */
     chrome?: {
         view3dCaption?: boolean;
         view3dSeatStepper?: boolean;
         view3dControlDock?: boolean;
+        seatViewTitle?: boolean;
+        seatViewCaption?: boolean;
+        seatViewBadge?: boolean;
     };
+    /** The 2D panorama opened, or closed (`null`). Fires whether or not the web
+     *  drew its words, so a host that suppressed them has the exact strings. */
+    onSeatViewChange?: (info: SeatingChartSeatViewInfo | null) => void;
+    /** How the stacked "All floors" view marks each level. Default `'number'`. */
+    floorLabelStyle?: FloorLabelStyle;
     /**
      * Multi-floor charts only: fires when the buyer taps a deck in the stacked
      * 3D view, after the picker switches to that floor — lets the host page sync
@@ -1829,8 +1874,12 @@ declare class SeatingChart {
         id: string;
         name: string;
     }[];
-    /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */
+    /** Switch the shown floor (2D), or `'all'` for the stacked whole-venue view.
+     *  One control, not two: a strip whose first chip is "All floors" would
+     *  otherwise need a separate command for that one chip. */
     setFloor(floorId: string): void;
+    /** How the stacked view marks each level: a `G/1/2` badge, or floor names. */
+    setFloorLabelStyle(style: FloorLabelStyle): void;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
     /** Switch the 2D canvas projection.
@@ -1913,8 +1962,17 @@ declare class SeatingChart {
      * and its own legacy frames. Nothing about the public path changes.
      */
     private startRealtime;
-    /** Re-read live inventory without remounting or dropping buyer state. */
-    refreshAvailability(): Promise<void>;
+    /**
+     * Re-read OTHER buyers' inventory without remounting or disturbing this
+     * buyer's own — see `@seatlayer/core`'s `availabilityRefresh`.
+     *
+     * Returns what actually changed for him: seats he had selected but never
+     * held which somebody else has taken (already deselected), and whether his
+     * own hold lapsed while he was away, with the labels that are still free so
+     * a surface can offer them back. Nothing here moves the camera, the rung or
+     * the cart total, and a seat he holds is never reported against him.
+     */
+    refreshAvailability(): Promise<AvailabilityRefreshOutcome>;
     /**
      * Re-acquire the buyer access session — call after your app has re-authorized
      * the buyer (a revoked session cannot be recovered any other way). Resolves
@@ -2700,6 +2758,10 @@ declare class SeatPicker implements GaPromptPicker {
     private ctaPhase;
     /** The ♿ control and its menu — one node, in the map's bottom-left corner. */
     private a11yMenu;
+    private detachAttention;
+    /** The telling of a hold that ended while the buyer was away — the state
+     *  part is the engine's; see pickerHoldLapse.ts. */
+    private readonly lapse;
     /** Rail scroll listener attached once; the rail repaints many times. */
     private railEdgesBound;
     private fsFallback;
@@ -4002,4 +4064,4 @@ interface AttachPickerFrameOptions {
  */
 declare function attachPickerFrame(iframe: HTMLIFrameElement, opts?: AttachPickerFrameOptions): () => void;
 
-export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAvailability, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };
+export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAvailability, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };