@seatlayer/js 0.67.14 → 0.67.15

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerMapTheme, PickerTransport } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerSelectionValidator, PickerMapTheme, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, SectionSummary, ChartTheme, LodRung, PickerTransport } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 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, T as InventoryBookingObject, U as InventoryBookingState, V as InventoryBookingsPage, W as InventoryBookingsQuery, X as LogEntry, Y as LogPage, Z as ManageApi, _ as ManageApiError, $ as ReportByStatus, a0 as ReportCategoryMeta, a1 as ReportCategoryRow, a2 as ReportResult, a3 as SeatManager, a4 as SeatManagerActionResult, a5 as SeatManagerActivity, a6 as SeatManagerCapability, a7 as SeatManagerConnection, a8 as SeatManagerFilteredSection, a9 as SeatManagerMode, aa as SeatManagerOptions, ab as SeatManagerSelectionValidity, ac as SeatManagerTallies, ad as SelectionSourceRow } from './channelsMode-2z9HBOAX.cjs';
 
@@ -76,6 +76,8 @@ type BuyerAccessUnavailableReason =
  | 'group_mismatch'
 /** 403 `buyer_access_mode_mismatch` (test bearer on a live event or v.v.). */
  | 'mode_mismatch'
+/** 403 `buyer_access_environment_mismatch` (session belongs to another environment). */
+ | 'environment_mismatch'
 /** 403 `channel_access_denied`. */
  | 'channel_denied'
 /** 422 `invalid_channel_scope` — an integration configuration error. */
@@ -642,6 +644,101 @@ interface GAAreaAvailability {
         price: number;
     }>;
 }
+/**
+ * Serializable state exposed to hosted native picker chrome. It deliberately
+ * contains buyer-display data only: never API keys, buyer-access bearers,
+ * provider callbacks, or the active hold id.
+ */
+interface SeatingChartPickerState {
+    event: {
+        key: string;
+        name: string;
+        venue: string | null;
+        startsAt: number | null;
+        timezone: string | null;
+        currency: string;
+        locale: string | null;
+        posterUrl: string | null;
+        mode: 'live' | 'test';
+        salesClosed: boolean;
+    };
+    branding: {
+        accent?: ChartTheme['accent'];
+        accentInk?: ChartTheme['accentInk'];
+        background?: ChartTheme['background'];
+        textColor?: ChartTheme['textColor'];
+        brandName?: ChartTheme['brandName'];
+        logoUrl?: ChartTheme['logoUrl'];
+        /** Native must render SeatLayer attribution when it owns chrome and this is true. */
+        attributionRequired: boolean;
+    };
+    features: {
+        ga: boolean;
+        tiers: boolean;
+        floors: boolean;
+        zones: boolean;
+        sections: boolean;
+        bestAvailable: boolean;
+        accessibilityFilter: boolean;
+        limitedViewFilter: boolean;
+    };
+    catalog: {
+        categories: Array<{
+            key: string;
+            label: string;
+            color: string;
+            price: number;
+            available: number;
+            tiers: Array<{
+                id: string;
+                name: string;
+                price: number;
+                currency?: string;
+            }>;
+        }>;
+        zones: Array<{
+            id: string;
+            label: string;
+            color?: string;
+        }>;
+        sections: Array<{
+            id: string;
+            label: string;
+            displayLabel?: string;
+            zoneId?: string;
+        }>;
+        gaAreas: GAAreaAvailability[];
+        bestAvailableZones: Array<{
+            id: string;
+            label: string;
+        }>;
+    };
+    map: {
+        floors: Array<{
+            id: string;
+            name: string;
+        }>;
+        activeFloorId: string | null;
+        rung: LodRung;
+        focusedSectionId: string | null;
+        focusedSection: SectionSummary | null;
+        viewMode: RendererViewMode;
+        colorblindSafe: boolean;
+        categoryFilter: string[] | null;
+        accessibilityFilter: string[] | null;
+        hideLimitedView: boolean;
+    };
+    selection: {
+        seats: SelectedSeat[];
+        validity: PickerSelectionValidity | null;
+        maxSelection: number;
+    };
+    access: {
+        configured: boolean;
+        status: 'public' | 'ready' | 'expired' | 'unavailable';
+        reason?: string;
+    };
+}
 interface SeatingChartOptions {
     /** CSS selector or an HTMLElement to render into. */
     container: string | HTMLElement;
@@ -714,6 +811,8 @@ interface SeatingChartOptions {
      * Toggleable later with setColorblindSafe().
      */
     colorblindSafe?: boolean;
+    /** Host-authoritative colors for the drawn canvas, separate from native chrome. */
+    mapTheme?: PickerMapTheme;
     /** Initial canvas projection.
      * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
      * real 3D venue view (`setBuyerView('venue3d')`); they remain accepted for
@@ -725,6 +824,10 @@ interface SeatingChartOptions {
      * to draw your own popover from onSeatHover.
      */
     seatTooltip?: boolean;
+    /** Internal hosted-runtime control. Defaults true for direct web embeds. */
+    showTestModeIndicator?: boolean;
+    /** Internal hosted-runtime control. Defaults true, subject to white-label entitlement. */
+    showAttribution?: boolean;
     /**
      * Seat hover with everything a popover needs (category label/color, resolved
      * tier-aware price, live status, currency); null on hover-out. Fires whether
@@ -793,6 +896,16 @@ interface SeatingChartOptions {
      * its own floor UI (tabs, labels) with the map.
      */
     onDeckTap?: (floorId: string) => void;
+    /** Big-venue section focus state for host-owned navigation chrome. */
+    onSectionFocus?: (summary: SectionSummary | null) => void;
+    /** Availability changed after a live frame or explicit refresh. */
+    onStatusChange?: () => void;
+    /** The server closed sales for this event. */
+    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. */
+    onViewChange?: () => void;
     /**
      * Non-blocking, localized selection advice — currently the orphan-seat hint
      * (the selection would strand a single free seat between taken neighbors).
@@ -811,6 +924,14 @@ declare class SeatingChart {
     private eventLocale;
     private rendered;
     private mode_;
+    private eventInfo;
+    private maxSelection_;
+    private colorblindSafe_;
+    private categoryFilter_;
+    private accessibilityFilter_;
+    private hideLimitedView_;
+    private focusedSection_;
+    private accessState_;
     private tipEl;
     private tipPos;
     private onTipMove;
@@ -869,6 +990,22 @@ declare class SeatingChart {
      */
     setLocale(next: string | null | undefined): Promise<string>;
     getMode(): 'live' | 'test' | null;
+    /** Atomic, token-free display state for native-owned picker chrome. */
+    getPickerState(): SeatingChartPickerState;
+    getCategoryAvailability(): Record<string, number>;
+    getBestAvailableZones(): Array<{
+        id: string;
+        label: string;
+    }>;
+    getActiveFloorId(): string | null;
+    getRung(): LodRung;
+    getFocusedSection(): string | null;
+    focusSection(sectionId: string): void;
+    overview(): void;
+    setRung(rung: LodRung): void;
+    setCategoryFilter(categoryKeys: string[] | null, focus?: boolean): void;
+    setAccessibilityFilter(types: string[] | null): void;
+    setCommercialLimitedFilter(on: boolean): void;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
     /** Select free objects by engine id or public label. Returns newly selected objects. */
@@ -951,6 +1088,15 @@ declare class SeatingChart {
      * reverts to the default tier.
      */
     setSeatTier(seatId: string, tierId: string | null): void;
+    /** Confirm/update an unheld variable table's guest quantity locally. */
+    setTableQuantity(label: string, quantity: number): boolean;
+    /**
+     * Atomically replace an active variable-table hold with a new guest count.
+     * Returns null for an inapplicable/invalid quantity or a refused replacement.
+     */
+    replaceTableQuantity(label: string, quantity: number, ttlMs?: number): Promise<HoldResult | null>;
+    /** @internal Throwing variant used by the correlated native bridge. */
+    replaceTableQuantityOrThrow(label: string, quantity: number, ttlMs?: number): Promise<HoldResult | null>;
     /**
      * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts
      * return one entry; empty before render()). Pair with setFloor() to build a
@@ -990,6 +1136,8 @@ 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-acquire the buyer access session — call after your app has re-authorized
      * the buyer (a revoked session cannot be recovered any other way). Resolves
@@ -3230,6 +3378,115 @@ declare class PerformanceGroupPicker {
     private checkout;
 }
 
+type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
+interface SeasonDescriptor {
+    key: string;
+    name: string;
+    edition: string | null;
+    mode: 'live' | 'test';
+    currency: string;
+    venue: string;
+    timezone: string | null;
+    audience: 'private' | 'embed_only' | 'discoverable';
+    planActivationId: string;
+    occurrenceCount: number;
+    occurrences: Array<{
+        position: number;
+        eventKey: string;
+        name: string;
+        startsAt: number | null;
+    }>;
+}
+interface SeasonAvailability {
+    seats: Record<string, 'free' | 'blocked'>;
+    partial: Record<string, string[]>;
+    revision: string;
+    comparisons: number;
+    freeCount: number;
+    blockedCount: number;
+}
+interface SeasonOperation {
+    operationId: string;
+    seasonId: string;
+    kind: string;
+    holdId: string;
+    expiresAt: number;
+    policy: 'fixed_inclusion_same_seat';
+    state: SeasonOperationState;
+    bookingRef: string | null;
+    location: string;
+    retryAfterSeconds: number;
+    allocations: Array<{
+        eventId: string;
+        state: string;
+    }>;
+}
+interface SeasonCheckoutHandoff {
+    seasonKey: string;
+    planActivationId: string;
+    operationId: string;
+    holdId: string;
+    expiresAt: number;
+    policy: 'fixed_inclusion_same_seat';
+    state: SeasonOperationState;
+    allocations: Array<{
+        eventKey: string;
+        state: string;
+    }>;
+}
+interface SeasonRenewalIntent {
+    offerId: string;
+    state: 'intent_received';
+    intentId: string;
+    receivedAt: number;
+}
+declare class SeasonApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, status: number);
+}
+declare class SeasonRecoveryTimeoutError extends Error {
+    readonly operationId: string;
+    constructor(operationId: string);
+}
+
+interface SeasonStatusEvent {
+    kind: 'loading' | 'ready' | 'pending' | 'held' | 'released' | 'renewal_intent' | 'partial_terminal' | 'failed';
+    message: string;
+    operationId?: string;
+}
+interface SeasonPickerOptions {
+    container: string | HTMLElement;
+    season: string;
+    apiBase?: string;
+    buyerAccessTokenProvider?: BuyerAccessTokenProvider;
+    buyerAccessToken?: string | BuyerAccessToken;
+    initialOperationId?: string;
+    recoveryTimeoutMs?: number;
+    fetch?: typeof fetch;
+    onHold?: (handoff: SeasonCheckoutHandoff) => void;
+    onHoldChange?: (handoff: SeasonCheckoutHandoff | null) => void;
+    onContinue?: (handoff: SeasonCheckoutHandoff) => void;
+    onRenewalIntent?: (intent: SeasonRenewalIntent) => void;
+    onAccessExpired?: (event: BuyerAccessExpiredEvent) => void;
+    onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
+    onStatusChange?: (event: SeasonStatusEvent) => void;
+    onError?: (error: unknown) => void;
+}
+declare class SeasonPicker {
+    #private;
+    constructor(options: SeasonPickerOptions);
+    render(): Promise<this>;
+    holdSameSeat(labels: readonly string[], operationId: string): Promise<SeasonCheckoutHandoff>;
+    restoreOperation(operationId: string): Promise<SeasonCheckoutHandoff | null>;
+    release(releaseActionId: string): Promise<void>;
+    createRenewalIntent(offerId: string): Promise<SeasonRenewalIntent>;
+    getDescriptor(): SeasonDescriptor | null;
+    getAvailability(): SeasonAvailability | null;
+    getHandoff(): SeasonCheckoutHandoff | null;
+    destroy(): void;
+}
+
 /**
  * Host-side helper for embedding the SeatLayer picker as an iframe.
  *
@@ -3269,4 +3526,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, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, 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, 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, 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, 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, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerMapTheme, PickerTransport } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerSelectionValidator, PickerMapTheme, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, SectionSummary, ChartTheme, LodRung, PickerTransport } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 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, T as InventoryBookingObject, U as InventoryBookingState, V as InventoryBookingsPage, W as InventoryBookingsQuery, X as LogEntry, Y as LogPage, Z as ManageApi, _ as ManageApiError, $ as ReportByStatus, a0 as ReportCategoryMeta, a1 as ReportCategoryRow, a2 as ReportResult, a3 as SeatManager, a4 as SeatManagerActionResult, a5 as SeatManagerActivity, a6 as SeatManagerCapability, a7 as SeatManagerConnection, a8 as SeatManagerFilteredSection, a9 as SeatManagerMode, aa as SeatManagerOptions, ab as SeatManagerSelectionValidity, ac as SeatManagerTallies, ad as SelectionSourceRow } from './channelsMode-2z9HBOAX.js';
 
@@ -76,6 +76,8 @@ type BuyerAccessUnavailableReason =
  | 'group_mismatch'
 /** 403 `buyer_access_mode_mismatch` (test bearer on a live event or v.v.). */
  | 'mode_mismatch'
+/** 403 `buyer_access_environment_mismatch` (session belongs to another environment). */
+ | 'environment_mismatch'
 /** 403 `channel_access_denied`. */
  | 'channel_denied'
 /** 422 `invalid_channel_scope` — an integration configuration error. */
@@ -642,6 +644,101 @@ interface GAAreaAvailability {
         price: number;
     }>;
 }
+/**
+ * Serializable state exposed to hosted native picker chrome. It deliberately
+ * contains buyer-display data only: never API keys, buyer-access bearers,
+ * provider callbacks, or the active hold id.
+ */
+interface SeatingChartPickerState {
+    event: {
+        key: string;
+        name: string;
+        venue: string | null;
+        startsAt: number | null;
+        timezone: string | null;
+        currency: string;
+        locale: string | null;
+        posterUrl: string | null;
+        mode: 'live' | 'test';
+        salesClosed: boolean;
+    };
+    branding: {
+        accent?: ChartTheme['accent'];
+        accentInk?: ChartTheme['accentInk'];
+        background?: ChartTheme['background'];
+        textColor?: ChartTheme['textColor'];
+        brandName?: ChartTheme['brandName'];
+        logoUrl?: ChartTheme['logoUrl'];
+        /** Native must render SeatLayer attribution when it owns chrome and this is true. */
+        attributionRequired: boolean;
+    };
+    features: {
+        ga: boolean;
+        tiers: boolean;
+        floors: boolean;
+        zones: boolean;
+        sections: boolean;
+        bestAvailable: boolean;
+        accessibilityFilter: boolean;
+        limitedViewFilter: boolean;
+    };
+    catalog: {
+        categories: Array<{
+            key: string;
+            label: string;
+            color: string;
+            price: number;
+            available: number;
+            tiers: Array<{
+                id: string;
+                name: string;
+                price: number;
+                currency?: string;
+            }>;
+        }>;
+        zones: Array<{
+            id: string;
+            label: string;
+            color?: string;
+        }>;
+        sections: Array<{
+            id: string;
+            label: string;
+            displayLabel?: string;
+            zoneId?: string;
+        }>;
+        gaAreas: GAAreaAvailability[];
+        bestAvailableZones: Array<{
+            id: string;
+            label: string;
+        }>;
+    };
+    map: {
+        floors: Array<{
+            id: string;
+            name: string;
+        }>;
+        activeFloorId: string | null;
+        rung: LodRung;
+        focusedSectionId: string | null;
+        focusedSection: SectionSummary | null;
+        viewMode: RendererViewMode;
+        colorblindSafe: boolean;
+        categoryFilter: string[] | null;
+        accessibilityFilter: string[] | null;
+        hideLimitedView: boolean;
+    };
+    selection: {
+        seats: SelectedSeat[];
+        validity: PickerSelectionValidity | null;
+        maxSelection: number;
+    };
+    access: {
+        configured: boolean;
+        status: 'public' | 'ready' | 'expired' | 'unavailable';
+        reason?: string;
+    };
+}
 interface SeatingChartOptions {
     /** CSS selector or an HTMLElement to render into. */
     container: string | HTMLElement;
@@ -714,6 +811,8 @@ interface SeatingChartOptions {
      * Toggleable later with setColorblindSafe().
      */
     colorblindSafe?: boolean;
+    /** Host-authoritative colors for the drawn canvas, separate from native chrome. */
+    mapTheme?: PickerMapTheme;
     /** Initial canvas projection.
      * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
      * real 3D venue view (`setBuyerView('venue3d')`); they remain accepted for
@@ -725,6 +824,10 @@ interface SeatingChartOptions {
      * to draw your own popover from onSeatHover.
      */
     seatTooltip?: boolean;
+    /** Internal hosted-runtime control. Defaults true for direct web embeds. */
+    showTestModeIndicator?: boolean;
+    /** Internal hosted-runtime control. Defaults true, subject to white-label entitlement. */
+    showAttribution?: boolean;
     /**
      * Seat hover with everything a popover needs (category label/color, resolved
      * tier-aware price, live status, currency); null on hover-out. Fires whether
@@ -793,6 +896,16 @@ interface SeatingChartOptions {
      * its own floor UI (tabs, labels) with the map.
      */
     onDeckTap?: (floorId: string) => void;
+    /** Big-venue section focus state for host-owned navigation chrome. */
+    onSectionFocus?: (summary: SectionSummary | null) => void;
+    /** Availability changed after a live frame or explicit refresh. */
+    onStatusChange?: () => void;
+    /** The server closed sales for this event. */
+    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. */
+    onViewChange?: () => void;
     /**
      * Non-blocking, localized selection advice — currently the orphan-seat hint
      * (the selection would strand a single free seat between taken neighbors).
@@ -811,6 +924,14 @@ declare class SeatingChart {
     private eventLocale;
     private rendered;
     private mode_;
+    private eventInfo;
+    private maxSelection_;
+    private colorblindSafe_;
+    private categoryFilter_;
+    private accessibilityFilter_;
+    private hideLimitedView_;
+    private focusedSection_;
+    private accessState_;
     private tipEl;
     private tipPos;
     private onTipMove;
@@ -869,6 +990,22 @@ declare class SeatingChart {
      */
     setLocale(next: string | null | undefined): Promise<string>;
     getMode(): 'live' | 'test' | null;
+    /** Atomic, token-free display state for native-owned picker chrome. */
+    getPickerState(): SeatingChartPickerState;
+    getCategoryAvailability(): Record<string, number>;
+    getBestAvailableZones(): Array<{
+        id: string;
+        label: string;
+    }>;
+    getActiveFloorId(): string | null;
+    getRung(): LodRung;
+    getFocusedSection(): string | null;
+    focusSection(sectionId: string): void;
+    overview(): void;
+    setRung(rung: LodRung): void;
+    setCategoryFilter(categoryKeys: string[] | null, focus?: boolean): void;
+    setAccessibilityFilter(types: string[] | null): void;
+    setCommercialLimitedFilter(on: boolean): void;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
     /** Select free objects by engine id or public label. Returns newly selected objects. */
@@ -951,6 +1088,15 @@ declare class SeatingChart {
      * reverts to the default tier.
      */
     setSeatTier(seatId: string, tierId: string | null): void;
+    /** Confirm/update an unheld variable table's guest quantity locally. */
+    setTableQuantity(label: string, quantity: number): boolean;
+    /**
+     * Atomically replace an active variable-table hold with a new guest count.
+     * Returns null for an inapplicable/invalid quantity or a refused replacement.
+     */
+    replaceTableQuantity(label: string, quantity: number, ttlMs?: number): Promise<HoldResult | null>;
+    /** @internal Throwing variant used by the correlated native bridge. */
+    replaceTableQuantityOrThrow(label: string, quantity: number, ttlMs?: number): Promise<HoldResult | null>;
     /**
      * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts
      * return one entry; empty before render()). Pair with setFloor() to build a
@@ -990,6 +1136,8 @@ 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-acquire the buyer access session — call after your app has re-authorized
      * the buyer (a revoked session cannot be recovered any other way). Resolves
@@ -3230,6 +3378,115 @@ declare class PerformanceGroupPicker {
     private checkout;
 }
 
+type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
+interface SeasonDescriptor {
+    key: string;
+    name: string;
+    edition: string | null;
+    mode: 'live' | 'test';
+    currency: string;
+    venue: string;
+    timezone: string | null;
+    audience: 'private' | 'embed_only' | 'discoverable';
+    planActivationId: string;
+    occurrenceCount: number;
+    occurrences: Array<{
+        position: number;
+        eventKey: string;
+        name: string;
+        startsAt: number | null;
+    }>;
+}
+interface SeasonAvailability {
+    seats: Record<string, 'free' | 'blocked'>;
+    partial: Record<string, string[]>;
+    revision: string;
+    comparisons: number;
+    freeCount: number;
+    blockedCount: number;
+}
+interface SeasonOperation {
+    operationId: string;
+    seasonId: string;
+    kind: string;
+    holdId: string;
+    expiresAt: number;
+    policy: 'fixed_inclusion_same_seat';
+    state: SeasonOperationState;
+    bookingRef: string | null;
+    location: string;
+    retryAfterSeconds: number;
+    allocations: Array<{
+        eventId: string;
+        state: string;
+    }>;
+}
+interface SeasonCheckoutHandoff {
+    seasonKey: string;
+    planActivationId: string;
+    operationId: string;
+    holdId: string;
+    expiresAt: number;
+    policy: 'fixed_inclusion_same_seat';
+    state: SeasonOperationState;
+    allocations: Array<{
+        eventKey: string;
+        state: string;
+    }>;
+}
+interface SeasonRenewalIntent {
+    offerId: string;
+    state: 'intent_received';
+    intentId: string;
+    receivedAt: number;
+}
+declare class SeasonApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, status: number);
+}
+declare class SeasonRecoveryTimeoutError extends Error {
+    readonly operationId: string;
+    constructor(operationId: string);
+}
+
+interface SeasonStatusEvent {
+    kind: 'loading' | 'ready' | 'pending' | 'held' | 'released' | 'renewal_intent' | 'partial_terminal' | 'failed';
+    message: string;
+    operationId?: string;
+}
+interface SeasonPickerOptions {
+    container: string | HTMLElement;
+    season: string;
+    apiBase?: string;
+    buyerAccessTokenProvider?: BuyerAccessTokenProvider;
+    buyerAccessToken?: string | BuyerAccessToken;
+    initialOperationId?: string;
+    recoveryTimeoutMs?: number;
+    fetch?: typeof fetch;
+    onHold?: (handoff: SeasonCheckoutHandoff) => void;
+    onHoldChange?: (handoff: SeasonCheckoutHandoff | null) => void;
+    onContinue?: (handoff: SeasonCheckoutHandoff) => void;
+    onRenewalIntent?: (intent: SeasonRenewalIntent) => void;
+    onAccessExpired?: (event: BuyerAccessExpiredEvent) => void;
+    onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
+    onStatusChange?: (event: SeasonStatusEvent) => void;
+    onError?: (error: unknown) => void;
+}
+declare class SeasonPicker {
+    #private;
+    constructor(options: SeasonPickerOptions);
+    render(): Promise<this>;
+    holdSameSeat(labels: readonly string[], operationId: string): Promise<SeasonCheckoutHandoff>;
+    restoreOperation(operationId: string): Promise<SeasonCheckoutHandoff | null>;
+    release(releaseActionId: string): Promise<void>;
+    createRenewalIntent(offerId: string): Promise<SeasonRenewalIntent>;
+    getDescriptor(): SeasonDescriptor | null;
+    getAvailability(): SeasonAvailability | null;
+    getHandoff(): SeasonCheckoutHandoff | null;
+    destroy(): void;
+}
+
 /**
  * Host-side helper for embedding the SeatLayer picker as an iframe.
  *
@@ -3269,4 +3526,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, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, 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, 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, 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, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };