@seatlayer/js 0.59.0 → 0.60.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } 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';
 
@@ -506,6 +506,77 @@ interface PubApiOptions {
     onObjectUnavailable?: (event: SelectedObjectUnavailableEvent) => void;
 }
 
+/**
+ * The general-admission quantity prompt, and the GA half of the tray.
+ *
+ * Before this module a buyer could tap a GA area on the map and nothing at all
+ * happened — `onGAClick` reached `PickerController` but the drop-in widget never
+ * wired it — while every area on the chart rendered a permanent stepper row in
+ * the tray whether or not the buyer wanted one. Twelve areas meant twelve
+ * steppers of clutter, and on a phone (where the tray is a collapsed sheet) the
+ * only control that existed was the one the buyer could not see.
+ *
+ * What replaces it is two taps: tap the area, the prompt opens with a quantity
+ * already seeded to 1 (never 0 — nobody opens a ticket picker to buy none), and
+ * the primary button reads what it will do, priced live: `Add 3 tickets · $45`.
+ * The map stays visible behind it — a popover anchored at the tap on a wide
+ * layout, a bottom sheet on a narrow one — because the buyer is choosing where
+ * to stand, and a centred modal hides exactly the thing being chosen.
+ *
+ * The tray keeps the stepper rows, but only for areas with a quantity: it is a
+ * cart, not a price list. Everything else collapses into one compact `Areas`
+ * list, which is the keyboard/screen-reader entry point into the same prompt.
+ *
+ * Split out of SeatPicker.ts rather than added to it: that file is pinned at its
+ * size in the app's file-size ratchet and may not grow.
+ */
+
+/** One priced ticket type inside an area. `id` is null for an untiered area. */
+interface GaPromptTier {
+    id: string | null;
+    label: string;
+    price: number;
+}
+/**
+ * What a host takes over when it returns `true` from `onGAPrompt`. `confirm`
+ * accepts a plain number for a single-tier area, or a per-tier record; both
+ * land in exactly the same place the built-in prompt's Add button does.
+ */
+interface GAPromptRequest {
+    area: PickerGAArea;
+    /** Quantities already chosen here, per tier id (`''` for an untiered area). */
+    selected: Record<string, number>;
+    min: number;
+    /** min(units still free, order cap − tickets chosen elsewhere). */
+    max: number;
+    tiers: GaPromptTier[];
+    confirm(quantity: number | Record<string, number>): void;
+    cancel(): void;
+}
+/** Per (area, tier) pending quantities. A `null` tier key is an untiered area. */
+type GaQtyMap = Map<string, Map<string | null, number>>;
+/** The slice of SeatPicker this module drives. Everything else stays private. */
+interface GaPromptPicker {
+    root: HTMLDivElement | null;
+    els: Record<string, HTMLElement>;
+    srEl: HTMLDivElement | null;
+    gaQty: GaQtyMap;
+    maxTickets: number;
+    salesClosed: boolean;
+    gaPromptEl: HTMLDivElement | null;
+    gaPromptReturnFocus: HTMLElement | null;
+    gaAreasExpanded: boolean;
+    money(amount: number): string;
+    paidPrice(categoryKey: string | undefined, tierId: string | null | undefined, fallback: number, objectLabel?: string): number;
+    tf(key: string, fallback: string): string;
+    toast(message: string, tone?: 'error' | 'success' | 'warning' | 'neutral'): void;
+    reducedMotion(): boolean;
+    syncTray(): void;
+    /** Tickets in the order right now, held + selected seats + every GA quantity. */
+    totalTicketCount(): number;
+    onGAPromptHook?: ((prompt: GAPromptRequest) => boolean | void) | undefined;
+}
+
 /**
  * SeatingChart — the embeddable buyer picker.
  *
@@ -580,7 +651,7 @@ interface SeatingChartOptions {
     selectionValidators?: PickerSelectionValidator[];
     /**
      * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to
-     * the browser language, then English. Built-in: en, es, de, fr. The German
+     * the browser language, then English. 37 languages ship. The German
      * bundle (etc.) is fetched on demand so unused languages cost nothing.
      */
     locale?: string;
@@ -628,6 +699,13 @@ interface SeatingChartOptions {
     onHoldRestored?: (result: HoldResult) => void;
     onHoldExpired?: () => void;
     onGAClick?: (area: GAAreaAvailability) => void;
+    /**
+     * Mirror of {@link SeatPickerOptions.onGAPrompt}. The low-level chart draws no
+     * quantity UI of its own, so this fires purely as the "the buyer wants to pick
+     * a quantity here" signal, with the same pre-computed `min`/`max`/`tiers` the
+     * full widget would have used; the return value is accepted and ignored.
+     */
+    onGAPrompt?: (prompt: GAPromptRequest) => boolean | void;
     /**
      * The buyer access session lapsed. `refreshed` says whether the provider
      * already recovered it — false means private inventory is now unavailable and
@@ -981,7 +1059,7 @@ type SeatingChartIdentityProp = (typeof SEATING_CHART_IDENTITY_PROPS)[number];
 declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "selectionValidators", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "selectedObjects", "selectableObjects", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
 type SeatingChartValueProp = (typeof SEATING_CHART_VALUE_PROPS)[number];
 /** Every callback option a wrapper wires to its own event mechanism. */
-declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
+declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onGAPrompt", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
 type SeatingChartCallbackProp = (typeof SEATING_CHART_CALLBACK_PROPS)[number];
 /** The value half of the options, as a wrapper holds it. */
 type SeatingChartValues = Pick<SeatingChartOptions, SeatingChartValueProp>;
@@ -1518,7 +1596,11 @@ interface SeatPickerOptions {
     /** Optional sale guards evaluated after every change and enforced before a
      * hold: minimum quantity, consecutive seats, and/or no stranded singles. */
     selectionValidators?: PickerSelectionValidator[];
-    /** BCP 47 language for the widget UI. Built-in: en, es, de, fr. */
+    /**
+     * BCP 47 language for the widget UI. 37 languages ship; omit this and each
+     * buyer gets their own `navigator.languages`, falling back to English.
+     * Read once at render — there is no way to change it on a live chart.
+     */
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
     messages?: Record<string, string>;
@@ -1783,6 +1865,22 @@ interface SeatPickerOptions {
      * widget has already dropped them from the tray.
      */
     onSelectedObjectUnavailable?: (event: SelectedObjectUnavailableEvent) => void;
+    /**
+     * A buyer tapped a general-admission area (on the map, or in the tray's
+     * `Areas` list) and the widget is about to open its own quantity prompt.
+     *
+     * Return `true` to take the interaction over completely — the built-in
+     * popover/sheet is suppressed, and the host drives the choice with whatever
+     * UI it likes, landing the result through `prompt.confirm(quantity)` (a plain
+     * number for a single-tier area, or `{ [tierId]: quantity }`) or dropping it
+     * with `prompt.cancel()`. Return anything else (or nothing) and the built-in
+     * prompt opens as usual, so this is also usable as a plain notification.
+     *
+     * `prompt.max` already folds in the area's live availability AND the
+     * order-wide ticket cap minus everything chosen elsewhere; a `confirm` above
+     * it is clamped rather than rejected.
+     */
+    onGAPrompt?: (prompt: GAPromptRequest) => boolean | void;
     onError?: (err: unknown) => void;
 }
 
@@ -1807,8 +1905,9 @@ interface SeatPickerOptions {
  * so plain host CSS can restyle too.
  */
 
-declare class SeatPicker {
-    private readonly opts;
+declare class SeatPicker implements GaPromptPicker {
+    /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
+    readonly opts: SeatPickerOptions;
     private readonly api;
     /** Authenticated view media, cached only for this picker lifetime. */
     private readonly buyerAssetUrls;
@@ -1820,17 +1919,17 @@ declare class SeatPicker {
     private accessEl;
     private readonly apiBase;
     private readonly controller;
-    private maxTickets;
+    /** @internal */ maxTickets: number;
     /** Exact ticket count required before checkout; null keeps ordinary 1..max behavior. */
     private readonly exactTickets;
     private lastSelectionValidity;
     /** Original host pricing, kept separate from live server offer overrides. */
     private readonly hostPricing;
-    private root;
+    /** @internal */ root: HTMLDivElement | null;
     private mapHost;
     private rendered;
     private destroyed;
-    private els;
+    /** @internal */ els: Record<string, HTMLElement>;
     /** Feature 6 anchor regions — positioned flex containers over the map. */
     private regions;
     private ro;
@@ -1874,7 +1973,15 @@ declare class SeatPicker {
     private checkoutPanel;
     private extendEl;
     private bookedEl;
-    private gaQty;
+    /** @internal Pending GA units per (area, tier) — see pickerGaPrompt.ts. */
+    gaQty: GaQtyMap;
+    /** @internal The open quantity prompt (popover or sheet), while one is up. */
+    gaPromptEl: HTMLDivElement | null;
+    /** @internal */ gaPromptReturnFocus: HTMLElement | null;
+    /** @internal Whether the tray's collapsed `Areas` list is open. */
+    gaAreasExpanded: boolean;
+    /** Viewport point of the last map tap — anchors the GA popover. */
+    private lastMapPoint;
     private tipEl;
     private tipPos;
     private confirmEl;
@@ -1883,7 +1990,7 @@ declare class SeatPicker {
     private tableDialog;
     private tableDialogHeld;
     private tableDialogReturnFocus;
-    private srEl;
+    /** @internal */ srEl: HTMLDivElement | null;
     private baQty;
     private baCat;
     /** Optional navigation-zone scope for buyer best-available. */
@@ -1902,7 +2009,7 @@ declare class SeatPicker {
     private bestAvailableConfirm;
     private releasingHold;
     /** Event sales window is closed (read-only load state / live close). */
-    private salesClosed;
+    /** @internal */ salesClosed: boolean;
     /** Every seated category's live availability is 0 (sold-out overlay is up). */
     private soldOut;
     private soldoutEl;
@@ -2099,7 +2206,9 @@ declare class SeatPicker {
      * unknown keys, so this collapses that to `fallback` — while still honoring a
      * host `messages` override (which makes `t()` return the override, not the key).
      */
-    private tf;
+    /** @internal The host's GA prompt takeover, if it supplied one. */
+    get onGAPromptHook(): SeatPickerOptions['onGAPrompt'];
+    /** @internal */ tf(key: string, fallback: string): string;
     /** Sold-out overlay — an informational state with no unavailable action. */
     private buildSoldoutOverlay;
     /**
@@ -2140,7 +2249,7 @@ declare class SeatPicker {
     /** Read a resolved --sl-* token value (canvas needs a real color, not var()). */
     private cssVar;
     /** Motion is progressive enhancement; all state remains legible when reduced. */
-    private reducedMotion;
+    /** @internal */ reducedMotion(): boolean;
     private scheduleMotion;
     /** Restart one finite CSS animation without leaving a permanent state class. */
     private animateOnce;
@@ -2151,14 +2260,10 @@ declare class SeatPicker {
     /** Update only the action affordance; selection callbacks must not refire. */
     private committedSelection;
     private pendingSelectionCount;
-    private heldGACounts;
-    private pendingGACount;
     private heldTicketCount;
-    private totalTicketCount;
+    /** @internal */ totalTicketCount(): number;
     /** Held tickets and standing quantities consume the same order-wide cap. */
     private updateSelectionCapacity;
-    private canAddTicket;
-    private pendingGATotal;
     private syncCta;
     private setCtaPhase;
     /** Session-scoped capability key: isolated by API origin and event. */
@@ -2254,7 +2359,7 @@ declare class SeatPicker {
      */
     private openSeatView;
     private closeSeatView;
-    private money;
+    /** @internal */ money(n: number): string;
     /**
      * Sleep until the offer schedule's next known transition, then re-read.
      *
@@ -2284,7 +2389,7 @@ declare class SeatPicker {
      * price the widget DISPLAYS or hands off must flow through here — a map
      * that shows one price while checkout charges another destroys trust.
      */
-    private paidPrice;
+    /** @internal */ paidPrice(categoryKey: string | undefined, tierId: string | null | undefined, fallback: number, objectLabel?: string): number;
     /** The half of a legend's inputs the rail and the price list share, resolved
      *  once so the two renderings cannot be given different answers. */
     private legendDeps;
@@ -2309,11 +2414,16 @@ declare class SeatPicker {
     private liveTimer;
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
     private evictTakenSelections;
-    private syncTray;
+    /** @internal */ syncTray(): void;
     private emitSelectionValidity;
     /** Paint the bottom-sheet's collapsed one-liner (pickerTray.ts builds it). */
     private renderPeek;
-    private removeHeldLabel;
+    /**
+     * Release one buyer-visible held LINE. That is one label for a seat, and every
+     * unit label behind a grouped GA line — a buyer who presses × on
+     * "PIT · Adult ×2" means both of them, not one of two identical cards.
+     */
+    private removeHeldLabels;
     private handleChangeSeats;
     private handleCta;
     private startHoldTimer;
@@ -2366,7 +2476,10 @@ declare class SeatPicker {
     /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
     private buildHandoff;
     private emitHoldChange;
-    private toast;
+    /** @internal */ toast(msg: string, tone?: 'neutral' | 'success' | 'warning' | 'error', action?: {
+        label: string;
+        onClick: () => void;
+    }): void;
     private placeTooltip;
     /**
      * Row label without the redundant section prefix. Charts commonly name row
@@ -2591,4 +2704,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 HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, 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, 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 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, ticketOfferPrices };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } 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';
 
@@ -506,6 +506,77 @@ interface PubApiOptions {
     onObjectUnavailable?: (event: SelectedObjectUnavailableEvent) => void;
 }
 
+/**
+ * The general-admission quantity prompt, and the GA half of the tray.
+ *
+ * Before this module a buyer could tap a GA area on the map and nothing at all
+ * happened — `onGAClick` reached `PickerController` but the drop-in widget never
+ * wired it — while every area on the chart rendered a permanent stepper row in
+ * the tray whether or not the buyer wanted one. Twelve areas meant twelve
+ * steppers of clutter, and on a phone (where the tray is a collapsed sheet) the
+ * only control that existed was the one the buyer could not see.
+ *
+ * What replaces it is two taps: tap the area, the prompt opens with a quantity
+ * already seeded to 1 (never 0 — nobody opens a ticket picker to buy none), and
+ * the primary button reads what it will do, priced live: `Add 3 tickets · $45`.
+ * The map stays visible behind it — a popover anchored at the tap on a wide
+ * layout, a bottom sheet on a narrow one — because the buyer is choosing where
+ * to stand, and a centred modal hides exactly the thing being chosen.
+ *
+ * The tray keeps the stepper rows, but only for areas with a quantity: it is a
+ * cart, not a price list. Everything else collapses into one compact `Areas`
+ * list, which is the keyboard/screen-reader entry point into the same prompt.
+ *
+ * Split out of SeatPicker.ts rather than added to it: that file is pinned at its
+ * size in the app's file-size ratchet and may not grow.
+ */
+
+/** One priced ticket type inside an area. `id` is null for an untiered area. */
+interface GaPromptTier {
+    id: string | null;
+    label: string;
+    price: number;
+}
+/**
+ * What a host takes over when it returns `true` from `onGAPrompt`. `confirm`
+ * accepts a plain number for a single-tier area, or a per-tier record; both
+ * land in exactly the same place the built-in prompt's Add button does.
+ */
+interface GAPromptRequest {
+    area: PickerGAArea;
+    /** Quantities already chosen here, per tier id (`''` for an untiered area). */
+    selected: Record<string, number>;
+    min: number;
+    /** min(units still free, order cap − tickets chosen elsewhere). */
+    max: number;
+    tiers: GaPromptTier[];
+    confirm(quantity: number | Record<string, number>): void;
+    cancel(): void;
+}
+/** Per (area, tier) pending quantities. A `null` tier key is an untiered area. */
+type GaQtyMap = Map<string, Map<string | null, number>>;
+/** The slice of SeatPicker this module drives. Everything else stays private. */
+interface GaPromptPicker {
+    root: HTMLDivElement | null;
+    els: Record<string, HTMLElement>;
+    srEl: HTMLDivElement | null;
+    gaQty: GaQtyMap;
+    maxTickets: number;
+    salesClosed: boolean;
+    gaPromptEl: HTMLDivElement | null;
+    gaPromptReturnFocus: HTMLElement | null;
+    gaAreasExpanded: boolean;
+    money(amount: number): string;
+    paidPrice(categoryKey: string | undefined, tierId: string | null | undefined, fallback: number, objectLabel?: string): number;
+    tf(key: string, fallback: string): string;
+    toast(message: string, tone?: 'error' | 'success' | 'warning' | 'neutral'): void;
+    reducedMotion(): boolean;
+    syncTray(): void;
+    /** Tickets in the order right now, held + selected seats + every GA quantity. */
+    totalTicketCount(): number;
+    onGAPromptHook?: ((prompt: GAPromptRequest) => boolean | void) | undefined;
+}
+
 /**
  * SeatingChart — the embeddable buyer picker.
  *
@@ -580,7 +651,7 @@ interface SeatingChartOptions {
     selectionValidators?: PickerSelectionValidator[];
     /**
      * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to
-     * the browser language, then English. Built-in: en, es, de, fr. The German
+     * the browser language, then English. 37 languages ship. The German
      * bundle (etc.) is fetched on demand so unused languages cost nothing.
      */
     locale?: string;
@@ -628,6 +699,13 @@ interface SeatingChartOptions {
     onHoldRestored?: (result: HoldResult) => void;
     onHoldExpired?: () => void;
     onGAClick?: (area: GAAreaAvailability) => void;
+    /**
+     * Mirror of {@link SeatPickerOptions.onGAPrompt}. The low-level chart draws no
+     * quantity UI of its own, so this fires purely as the "the buyer wants to pick
+     * a quantity here" signal, with the same pre-computed `min`/`max`/`tiers` the
+     * full widget would have used; the return value is accepted and ignored.
+     */
+    onGAPrompt?: (prompt: GAPromptRequest) => boolean | void;
     /**
      * The buyer access session lapsed. `refreshed` says whether the provider
      * already recovered it — false means private inventory is now unavailable and
@@ -981,7 +1059,7 @@ type SeatingChartIdentityProp = (typeof SEATING_CHART_IDENTITY_PROPS)[number];
 declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "selectionValidators", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "selectedObjects", "selectableObjects", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
 type SeatingChartValueProp = (typeof SEATING_CHART_VALUE_PROPS)[number];
 /** Every callback option a wrapper wires to its own event mechanism. */
-declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
+declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onGAPrompt", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
 type SeatingChartCallbackProp = (typeof SEATING_CHART_CALLBACK_PROPS)[number];
 /** The value half of the options, as a wrapper holds it. */
 type SeatingChartValues = Pick<SeatingChartOptions, SeatingChartValueProp>;
@@ -1518,7 +1596,11 @@ interface SeatPickerOptions {
     /** Optional sale guards evaluated after every change and enforced before a
      * hold: minimum quantity, consecutive seats, and/or no stranded singles. */
     selectionValidators?: PickerSelectionValidator[];
-    /** BCP 47 language for the widget UI. Built-in: en, es, de, fr. */
+    /**
+     * BCP 47 language for the widget UI. 37 languages ship; omit this and each
+     * buyer gets their own `navigator.languages`, falling back to English.
+     * Read once at render — there is no way to change it on a live chart.
+     */
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
     messages?: Record<string, string>;
@@ -1783,6 +1865,22 @@ interface SeatPickerOptions {
      * widget has already dropped them from the tray.
      */
     onSelectedObjectUnavailable?: (event: SelectedObjectUnavailableEvent) => void;
+    /**
+     * A buyer tapped a general-admission area (on the map, or in the tray's
+     * `Areas` list) and the widget is about to open its own quantity prompt.
+     *
+     * Return `true` to take the interaction over completely — the built-in
+     * popover/sheet is suppressed, and the host drives the choice with whatever
+     * UI it likes, landing the result through `prompt.confirm(quantity)` (a plain
+     * number for a single-tier area, or `{ [tierId]: quantity }`) or dropping it
+     * with `prompt.cancel()`. Return anything else (or nothing) and the built-in
+     * prompt opens as usual, so this is also usable as a plain notification.
+     *
+     * `prompt.max` already folds in the area's live availability AND the
+     * order-wide ticket cap minus everything chosen elsewhere; a `confirm` above
+     * it is clamped rather than rejected.
+     */
+    onGAPrompt?: (prompt: GAPromptRequest) => boolean | void;
     onError?: (err: unknown) => void;
 }
 
@@ -1807,8 +1905,9 @@ interface SeatPickerOptions {
  * so plain host CSS can restyle too.
  */
 
-declare class SeatPicker {
-    private readonly opts;
+declare class SeatPicker implements GaPromptPicker {
+    /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
+    readonly opts: SeatPickerOptions;
     private readonly api;
     /** Authenticated view media, cached only for this picker lifetime. */
     private readonly buyerAssetUrls;
@@ -1820,17 +1919,17 @@ declare class SeatPicker {
     private accessEl;
     private readonly apiBase;
     private readonly controller;
-    private maxTickets;
+    /** @internal */ maxTickets: number;
     /** Exact ticket count required before checkout; null keeps ordinary 1..max behavior. */
     private readonly exactTickets;
     private lastSelectionValidity;
     /** Original host pricing, kept separate from live server offer overrides. */
     private readonly hostPricing;
-    private root;
+    /** @internal */ root: HTMLDivElement | null;
     private mapHost;
     private rendered;
     private destroyed;
-    private els;
+    /** @internal */ els: Record<string, HTMLElement>;
     /** Feature 6 anchor regions — positioned flex containers over the map. */
     private regions;
     private ro;
@@ -1874,7 +1973,15 @@ declare class SeatPicker {
     private checkoutPanel;
     private extendEl;
     private bookedEl;
-    private gaQty;
+    /** @internal Pending GA units per (area, tier) — see pickerGaPrompt.ts. */
+    gaQty: GaQtyMap;
+    /** @internal The open quantity prompt (popover or sheet), while one is up. */
+    gaPromptEl: HTMLDivElement | null;
+    /** @internal */ gaPromptReturnFocus: HTMLElement | null;
+    /** @internal Whether the tray's collapsed `Areas` list is open. */
+    gaAreasExpanded: boolean;
+    /** Viewport point of the last map tap — anchors the GA popover. */
+    private lastMapPoint;
     private tipEl;
     private tipPos;
     private confirmEl;
@@ -1883,7 +1990,7 @@ declare class SeatPicker {
     private tableDialog;
     private tableDialogHeld;
     private tableDialogReturnFocus;
-    private srEl;
+    /** @internal */ srEl: HTMLDivElement | null;
     private baQty;
     private baCat;
     /** Optional navigation-zone scope for buyer best-available. */
@@ -1902,7 +2009,7 @@ declare class SeatPicker {
     private bestAvailableConfirm;
     private releasingHold;
     /** Event sales window is closed (read-only load state / live close). */
-    private salesClosed;
+    /** @internal */ salesClosed: boolean;
     /** Every seated category's live availability is 0 (sold-out overlay is up). */
     private soldOut;
     private soldoutEl;
@@ -2099,7 +2206,9 @@ declare class SeatPicker {
      * unknown keys, so this collapses that to `fallback` — while still honoring a
      * host `messages` override (which makes `t()` return the override, not the key).
      */
-    private tf;
+    /** @internal The host's GA prompt takeover, if it supplied one. */
+    get onGAPromptHook(): SeatPickerOptions['onGAPrompt'];
+    /** @internal */ tf(key: string, fallback: string): string;
     /** Sold-out overlay — an informational state with no unavailable action. */
     private buildSoldoutOverlay;
     /**
@@ -2140,7 +2249,7 @@ declare class SeatPicker {
     /** Read a resolved --sl-* token value (canvas needs a real color, not var()). */
     private cssVar;
     /** Motion is progressive enhancement; all state remains legible when reduced. */
-    private reducedMotion;
+    /** @internal */ reducedMotion(): boolean;
     private scheduleMotion;
     /** Restart one finite CSS animation without leaving a permanent state class. */
     private animateOnce;
@@ -2151,14 +2260,10 @@ declare class SeatPicker {
     /** Update only the action affordance; selection callbacks must not refire. */
     private committedSelection;
     private pendingSelectionCount;
-    private heldGACounts;
-    private pendingGACount;
     private heldTicketCount;
-    private totalTicketCount;
+    /** @internal */ totalTicketCount(): number;
     /** Held tickets and standing quantities consume the same order-wide cap. */
     private updateSelectionCapacity;
-    private canAddTicket;
-    private pendingGATotal;
     private syncCta;
     private setCtaPhase;
     /** Session-scoped capability key: isolated by API origin and event. */
@@ -2254,7 +2359,7 @@ declare class SeatPicker {
      */
     private openSeatView;
     private closeSeatView;
-    private money;
+    /** @internal */ money(n: number): string;
     /**
      * Sleep until the offer schedule's next known transition, then re-read.
      *
@@ -2284,7 +2389,7 @@ declare class SeatPicker {
      * price the widget DISPLAYS or hands off must flow through here — a map
      * that shows one price while checkout charges another destroys trust.
      */
-    private paidPrice;
+    /** @internal */ paidPrice(categoryKey: string | undefined, tierId: string | null | undefined, fallback: number, objectLabel?: string): number;
     /** The half of a legend's inputs the rail and the price list share, resolved
      *  once so the two renderings cannot be given different answers. */
     private legendDeps;
@@ -2309,11 +2414,16 @@ declare class SeatPicker {
     private liveTimer;
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
     private evictTakenSelections;
-    private syncTray;
+    /** @internal */ syncTray(): void;
     private emitSelectionValidity;
     /** Paint the bottom-sheet's collapsed one-liner (pickerTray.ts builds it). */
     private renderPeek;
-    private removeHeldLabel;
+    /**
+     * Release one buyer-visible held LINE. That is one label for a seat, and every
+     * unit label behind a grouped GA line — a buyer who presses × on
+     * "PIT · Adult ×2" means both of them, not one of two identical cards.
+     */
+    private removeHeldLabels;
     private handleChangeSeats;
     private handleCta;
     private startHoldTimer;
@@ -2366,7 +2476,10 @@ declare class SeatPicker {
     /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
     private buildHandoff;
     private emitHoldChange;
-    private toast;
+    /** @internal */ toast(msg: string, tone?: 'neutral' | 'success' | 'warning' | 'error', action?: {
+        label: string;
+        onClick: () => void;
+    }): void;
     private placeTooltip;
     /**
      * Row label without the redundant section prefix. Charts commonly name row
@@ -2591,4 +2704,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 HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, 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, 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 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, ticketOfferPrices };