@seatlayer/js 0.71.4 → 0.72.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, SeatHoverDetails, FloorLabelStyle, 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';
@@ -1291,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,
@@ -1422,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[];
@@ -1434,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;
@@ -1949,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
@@ -2736,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;
@@ -3065,7 +3091,6 @@ declare class SeatPicker implements GaPromptPicker {
     private refreshOfferAvailability;
     private offerPrice;
     private applyChannelPricing;
-    /** The compact current/upcoming offer card above Ticket prices. */
     private syncOffer;
     /**
      * The price the buyer will actually pay for an object/category/tier: its
@@ -3924,6 +3949,8 @@ interface SeasonOperation {
     holdId: string;
     expiresAt: number;
     policy: 'fixed_inclusion_same_seat';
+    pricingAuthority: 'host';
+    authoritativeAmountIncluded: false;
     state: SeasonOperationState;
     bookingRef: string | null;
     location: string;
@@ -3940,6 +3967,8 @@ interface SeasonCheckoutHandoff {
     holdId: string;
     expiresAt: number;
     policy: 'fixed_inclusion_same_seat';
+    pricingAuthority: 'host';
+    authoritativeAmountIncluded: false;
     state: SeasonOperationState;
     allocations: Array<{
         eventKey: string;
@@ -3967,6 +3996,16 @@ interface SeasonStatusEvent {
     message: string;
     operationId?: string;
 }
+/** Host-authored commercial context. Display only; checkout must re-price server-side. */
+interface SeasonOfferPresentation {
+    eyebrow?: string;
+    priceLabel?: string;
+    compareAtPriceLabel?: string;
+    savingsLabel?: string;
+    priceNote?: string;
+    benefits?: readonly string[];
+    renewalLabel?: string;
+}
 interface SeasonPickerOptions {
     container: string | HTMLElement;
     season: string;
@@ -3975,10 +4014,36 @@ interface SeasonPickerOptions {
     buyerAccessToken?: string | BuyerAccessToken;
     initialOperationId?: string;
     recoveryTimeoutMs?: number;
+    realtimePollMs?: number;
     fetch?: typeof fetch;
+    offer?: SeasonOfferPresentation;
+    maxSelection?: number;
+    selectedObjects?: string[];
+    selectableObjects?: string[] | null;
+    numberOfPlacesToSelect?: number;
+    selectionValidators?: PickerSelectionValidator[];
+    locale?: string;
+    messages?: Record<string, string>;
+    languages?: string[];
+    colorblindSafe?: boolean;
+    initialView?: RendererViewMode;
+    enable3D?: boolean;
+    max3DSeats?: number;
+    hideBadge?: boolean;
+    theme?: SeatPickerTheme;
+    confirmSelection?: boolean;
+    seatView?: boolean;
+    onSelectionChange?: (seats: PickerSeat[]) => void;
+    onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
+    onBuyerViewChange?: (state: {
+        view: SeatPickerBuyerView;
+        seatId?: string;
+    }) => void;
+    onAnalytics?: (event: string, props: Record<string, unknown>) => void;
     onHold?: (handoff: SeasonCheckoutHandoff) => void;
     onHoldChange?: (handoff: SeasonCheckoutHandoff | null) => void;
     onContinue?: (handoff: SeasonCheckoutHandoff) => void;
+    onHoldExpired?: () => void;
     onRenewalIntent?: (intent: SeasonRenewalIntent) => void;
     onAccessExpired?: (event: BuyerAccessExpiredEvent) => void;
     onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
@@ -4038,4 +4103,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 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 };
+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 SeasonOfferPresentation, 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, FloorLabelStyle, 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';
@@ -1291,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,
@@ -1422,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[];
@@ -1434,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;
@@ -1949,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
@@ -2736,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;
@@ -3065,7 +3091,6 @@ declare class SeatPicker implements GaPromptPicker {
     private refreshOfferAvailability;
     private offerPrice;
     private applyChannelPricing;
-    /** The compact current/upcoming offer card above Ticket prices. */
     private syncOffer;
     /**
      * The price the buyer will actually pay for an object/category/tier: its
@@ -3924,6 +3949,8 @@ interface SeasonOperation {
     holdId: string;
     expiresAt: number;
     policy: 'fixed_inclusion_same_seat';
+    pricingAuthority: 'host';
+    authoritativeAmountIncluded: false;
     state: SeasonOperationState;
     bookingRef: string | null;
     location: string;
@@ -3940,6 +3967,8 @@ interface SeasonCheckoutHandoff {
     holdId: string;
     expiresAt: number;
     policy: 'fixed_inclusion_same_seat';
+    pricingAuthority: 'host';
+    authoritativeAmountIncluded: false;
     state: SeasonOperationState;
     allocations: Array<{
         eventKey: string;
@@ -3967,6 +3996,16 @@ interface SeasonStatusEvent {
     message: string;
     operationId?: string;
 }
+/** Host-authored commercial context. Display only; checkout must re-price server-side. */
+interface SeasonOfferPresentation {
+    eyebrow?: string;
+    priceLabel?: string;
+    compareAtPriceLabel?: string;
+    savingsLabel?: string;
+    priceNote?: string;
+    benefits?: readonly string[];
+    renewalLabel?: string;
+}
 interface SeasonPickerOptions {
     container: string | HTMLElement;
     season: string;
@@ -3975,10 +4014,36 @@ interface SeasonPickerOptions {
     buyerAccessToken?: string | BuyerAccessToken;
     initialOperationId?: string;
     recoveryTimeoutMs?: number;
+    realtimePollMs?: number;
     fetch?: typeof fetch;
+    offer?: SeasonOfferPresentation;
+    maxSelection?: number;
+    selectedObjects?: string[];
+    selectableObjects?: string[] | null;
+    numberOfPlacesToSelect?: number;
+    selectionValidators?: PickerSelectionValidator[];
+    locale?: string;
+    messages?: Record<string, string>;
+    languages?: string[];
+    colorblindSafe?: boolean;
+    initialView?: RendererViewMode;
+    enable3D?: boolean;
+    max3DSeats?: number;
+    hideBadge?: boolean;
+    theme?: SeatPickerTheme;
+    confirmSelection?: boolean;
+    seatView?: boolean;
+    onSelectionChange?: (seats: PickerSeat[]) => void;
+    onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
+    onBuyerViewChange?: (state: {
+        view: SeatPickerBuyerView;
+        seatId?: string;
+    }) => void;
+    onAnalytics?: (event: string, props: Record<string, unknown>) => void;
     onHold?: (handoff: SeasonCheckoutHandoff) => void;
     onHoldChange?: (handoff: SeasonCheckoutHandoff | null) => void;
     onContinue?: (handoff: SeasonCheckoutHandoff) => void;
+    onHoldExpired?: () => void;
     onRenewalIntent?: (intent: SeasonRenewalIntent) => void;
     onAccessExpired?: (event: BuyerAccessExpiredEvent) => void;
     onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
@@ -4038,4 +4103,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 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 };
+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 SeasonOfferPresentation, 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 };