@seatlayer/js 0.69.0 → 0.71.1

package/dist/index.d.cts

@@ -1,6 +1,9 @@
-import { PickerSeat, PickerGAArea, PickerSelectionValidator, PickerMapTheme, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, SectionSummary, ChartTheme, LodRung, PickerTransport } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerSelectionValidator, PickerMapTheme, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, SectionSummary, ChartTheme, LodRung, PickerTransport, PickerController, AccessibilityType, ExpandedSeat } 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';
+import * as _seatlayer_core_core_seatConfidence from '@seatlayer/core/core/seatConfidence';
+import { Venue3DHandle } from '@seatlayer/core/view3d';
+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';
 
 /**
  * Buyer access context — the browser half of the Sales Channels contract
@@ -1787,6 +1790,20 @@ interface SeatPickerBuyerViewOptions {
 }
 /** Host theme overrides — any subset; unset keys fall back to the org's chart theme, then defaults. */
 interface SeatPickerTheme {
+    /**
+     * Light, dark, or follow the reader's own `prefers-color-scheme`.
+     *
+     * OPT-IN. Omit it and the widget renders exactly what it always did: the
+     * chart's authored ground, the organizer's colours, your own overrides. Set
+     * it and the built-in token set for that side takes the GROUND roles —
+     * background, surface, ink, muted ink, hairlines, and the drawn map's own
+     * canvas — while the organizer's accent, font, radius and logo, and every
+     * colour you state explicitly below, stay exactly as they are.
+     *
+     * `'auto'` is re-read live: a buyer who flips their phone into dark mode
+     * mid-purchase keeps their seats and their hold.
+     */
+    mode?: ThemeMode;
     /** Brand accent (CTA, active chips, hold pill). */
     accent?: string;
     /** Ink on the accent (button labels). */
@@ -1914,6 +1931,13 @@ interface SeatPickerOptions {
     currency?: string;
     /** Colorblind-safe rendering (Okabe-Ito palette, hollow booked seats). */
     colorblindSafe?: boolean;
+    /**
+     * How a big chart's seats arrive: 'progressive' (default) shows the venue's
+     * sections as soon as the chart lands and fills the seats in a section at a
+     * time, nearest the viewport first; 'plain' builds the whole scene in one
+     * step. Small charts are built in one step either way.
+     */
+    loadingReveal?: 'progressive' | 'plain';
     /** Initial map projection. Buyers now toggle **Map (flat 2D) + 3D** only; the
      * legacy `perspective` (2.5D) value is still ACCEPTED for source compatibility
      * but is deprecated — it is coerced to `flat` with a one-time console warning.
@@ -1953,6 +1977,16 @@ interface SeatPickerOptions {
      * with `{ surface: 'buyer' }` merged into the props. A throwing sink never
      * breaks the widget. Route it to your product analytics (e.g. PostHog). */
     onAnalytics?: (event: string, props: Record<string, unknown>) => void;
+    /**
+     * Every seat of a progressively revealed chart is now built and painted.
+     *
+     * `render()` resolves with the section shells and the nearest seats — the
+     * rest arrive in idle slices. A host that needs "the whole venue is on
+     * screen" waits for this rather than for `render()`. Fires exactly once per
+     * chart, and never for a chart small enough to build in one step (there is
+     * nothing to wait for: `render()` already was that moment).
+     */
+    onSeatsRevealed?: () => void;
     /**
      * Optional organiser-defined campaign/referral label (max 120 characters).
      * On the public SeatLayer transport it is frozen onto the hold, then copied
@@ -2199,31 +2233,38 @@ interface SeatPickerOptions {
     onError?: (err: unknown) => void;
 }
 
+/** What the saved-seat comparison chip needs from the widget around it. */
+interface CompareChipHost {
+    /** The live 3D overlay the chip mounts into, or null when 3D is down. */
+    overlay(): HTMLElement | null;
+    /** Seat ids currently saved for comparison (0, 1 or 2 of them). */
+    savedSeatIds(): string[];
+    /** Open the two-seat comparison surface. */
+    openComparison(): void;
+    /** Drop every saved seat and tear the comparison down. */
+    clearComparison(): void;
+    toast(msg: string, tone?: 'neutral' | 'success' | 'warning' | 'error'): void;
+}
 /**
- * SeatPicker — the full buyer experience as a widget.
- *
- * Where `SeatingChart` is canvas-only, SeatPicker owns the complete chrome
- * from the canonical UX contract: branded header,
- * live price panel, selection tray with GA steppers, hold countdown, snipe
- * toasts and expiry recovery — all on top of the shared PickerController, so
- * every host gets the whole experience with one mount.
- *
- * Render contexts (owner requirement): the SAME widget adapts to a full-screen
- * takeover, an inline <div> in a content page, or a popup — breakpoints key
- * off the CONTAINER via ResizeObserver, never the viewport. `SeatPicker.open()`
- * mounts a document-level modal (scrim, ESC, focus restore) in one call.
- *
- * Theming (owner requirement): org account customization flows automatically —
- * the chart payload's ChartTheme (accent, accentInk, logoUrl, brand name,
- * fontFamily, …) seeds the look; the host `theme` option overrides any subset;
- * and every value lands as a `--sl-*` CSS custom property on the widget root
- * so plain host CSS can restyle too.
+ * The "N seats saved" chip pinned inside the 3D overlay. `sync()` is
+ * idempotent: it builds the chip on first need, updates its label after, and
+ * removes it once nothing is saved (or the overlay is gone).
  */
+declare class View3dCompareChip {
+    private readonly host;
+    private chip;
+    constructor(host: CompareChipHost);
+    sync(): void;
+    /** Drop the chip element (3D teardown). Saved ids are the host's to clear. */
+    remove(): void;
+    /** The chip's primary button — a focus target when an overlay above it closes. */
+    mainButton(): HTMLElement | null;
+}
 
 declare class SeatPicker implements GaPromptPicker {
     /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
     readonly opts: SeatPickerOptions;
-    private readonly api;
+    /** @internal */ readonly api: PickerTransport;
     /** Authenticated view media, cached only for this picker lifetime. */
     private readonly buyerAssetUrls;
     /** Our own public client, or null when the host injected a transport. */
@@ -2233,7 +2274,7 @@ declare class SeatPicker implements GaPromptPicker {
     private realtime;
     private accessEl;
     private readonly apiBase;
-    private readonly controller;
+    /** @internal */ readonly controller: PickerController;
     /** @internal */ maxTickets: number;
     /** Exact ticket count required before checkout; null keeps ordinary 1..max behavior. */
     private readonly exactTickets;
@@ -2247,6 +2288,9 @@ declare class SeatPicker implements GaPromptPicker {
     private mapHost;
     private rendered;
     private destroyed;
+    /** Bumped on every locale REQUEST, so a load that resolves late can tell it
+     *  is no longer the one asked for. See {@link applyActiveLocale}. */
+    private localeGeneration;
     /** @internal */ els: Record<string, HTMLElement>;
     /** Feature 6 anchor regions — positioned flex containers over the map. */
     private regions;
@@ -2306,7 +2350,16 @@ declare class SeatPicker implements GaPromptPicker {
     private tipPinned;
     private tipMarkedHoverLabel;
     private lastPointerType;
-    private confirmEl;
+    /** @internal */ confirmEl: HTMLDivElement | null;
+    /** Light / dark / auto, or null when the widget is not managing a mode at
+     *  all — which is the default, and is byte-for-byte the old behaviour. */
+    private themeMode;
+    /** Live `prefers-color-scheme` subscription, held only while mode is auto. */
+    private colorSchemeStop;
+    /** The progressive reveal has finished for the chart currently mounted, and
+     *  the closure that says so once the render facts exist to say it with. */
+    private seatsRevealed;
+    private seatsRevealedReport;
     private confirmSeat;
     private suppressConfirmationSeatId;
     private tableDialogEl;
@@ -2341,8 +2394,8 @@ declare class SeatPicker implements GaPromptPicker {
     private rungsEl;
     private projectionEl;
     private buyerView;
-    private view3dEl;
-    private view3dHandle;
+    /** @internal */ view3dEl: HTMLDivElement | null;
+    /** @internal */ view3dHandle: Venue3DHandle | null;
     /** Monotonic token so a stale async mount (buyer left before OGL finished
      *  loading) never installs its handle over a newer state. */
     private view3dGen;
@@ -2352,15 +2405,15 @@ declare class SeatPicker implements GaPromptPicker {
      * fixed seat-eye state. It lets Back unwind one step before leaving 3D. */
     private view3dTargetSeatId;
     /** Inspection-only comparison. These ids never represent cart selection. */
-    private view3dCompareSeatIds;
+    /** @internal */ view3dCompareSeatIds: string[];
     /** The saved-seat comparison chip — owned by pickerView3dNav.ts. */
-    private readonly view3dCompareChip;
-    private view3dCompareEl;
-    private view3dCompareCleanup;
-    private view3dPassportEl;
-    private view3dPassportCleanup;
+    /** @internal */ readonly view3dCompareChip: View3dCompareChip;
+    /** @internal */ view3dCompareEl: HTMLDivElement | null;
+    /** @internal */ view3dCompareCleanup: (() => void) | null;
+    private view3dSeatViewChrome;
+    /** @internal */ view3dPassportEl: HTMLDivElement | null;
+    /** @internal */ view3dPassportCleanup: (() => void) | null;
     private floorsEl;
-    private secCardEl;
     private viewEl;
     private viewCleanup;
     /** Supersedes an older authored-view byte request when another seat is opened. */
@@ -2373,12 +2426,14 @@ declare class SeatPicker implements GaPromptPicker {
     /** "Hide limited-view seats" — mirrored into 3D by `seatState3dFor`. */
     private limitedViewFilter;
     private pricesExpanded;
+    /** The section card owns its element, collapse state and shown-at clock. */
+    private sectionCardCache;
     /** Last surfaced section summary (re-rendered when the price band changes). */
-    private lastSection;
-    /** Section card collapsed to its slim pill (seat-picking has begun). */
-    private secCardCollapsed;
-    /** When the card was (re)shown — the focus glide's own view change must not collapse it. */
-    private secCardShownAt;
+    /** The tapped section the card is holding. A facade over the card in both
+     *  directions: reading it must not build chrome, and writing it must not
+     *  repaint — see SectionCard.adopt. */
+    private get lastSection();
+    private set lastSection(value);
     /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
     private lastTrayCount;
     /** The opt-in language switcher, when `languages` named at least two. */
@@ -2392,7 +2447,8 @@ declare class SeatPicker implements GaPromptPicker {
     /** Selected labels awaiting the hold response; their own realtime echo can arrive first. */
     private holdingLabels;
     private ctaPhase;
-    private a11yChipsEl;
+    /** The ♿ control and its menu — one node, in the map's bottom-left corner. */
+    private a11yMenu;
     /** Rail scroll listener attached once; the rail repaints many times. */
     private railEdgesBound;
     private fsFallback;
@@ -2422,6 +2478,16 @@ declare class SeatPicker implements GaPromptPicker {
      * (OV-52)
      */
     private confirmThumbHtml;
+    /**
+     * The reference the card's thumbnail would load, or null when there is none
+     * the buyer-media policy will hand back.
+     *
+     * The same predicate `BuyerAssetObjectUrls.resolve` applies, asked BEFORE the
+     * markup is built rather than after the fetch fails — which is the difference
+     * between a card that never shows a frame and one that shows a frame and then
+     * takes it away.
+     */
+    private deliverableViewReference;
     /** True when the picker is rendered inside an iframe (snippet embed at /e/:key). */
     private isFramed;
     /** Post a widget→host message only when the browser identifies its origin. */
@@ -2475,6 +2541,17 @@ declare class SeatPicker implements GaPromptPicker {
     render(): Promise<this>;
     /** Wire host chrome after the skeleton exists and before the renderer owns its map host. */
     private wireBuyerShell;
+    /**
+     * Put the phone sheet back to its peek.
+     *
+     * THE MAP IS THE PRODUCT, and a buyer who reaches past an open sheet to tap
+     * the venue has already said which one they want to look at. Called from the
+     * renderer's own tap callbacks — never from raw pointer events, so a pan or a
+     * pinch that happens to end over a seat is not mistaken for a tap.
+     *
+     * @internal
+     */
+    collapseSheet(): void;
     /** Observe the host container rather than the viewport; embeds resize independently. */
     private observeLayout;
     /** Render the shared controller into the already-mounted canvas host. */
@@ -2505,6 +2582,18 @@ declare class SeatPicker implements GaPromptPicker {
     setPanelCollapsed(collapsed: boolean): void;
     /** Idempotent DOM apply, also run on every layout flip (inert must lift on narrow). */
     private applyPanelCollapsed;
+    /** Build the ♿ menu (filter + limited view + palette) into the map's
+     *  bottom-left corner. The menu owns its own state machine; see the module. */
+    private buildAccessibilityMenu;
+    /**
+     * Jump to the seats rung when a dimming filter turns on — the dimming only
+     * renders at seat detail, so applying it zoomed out would silently change
+     * seats the buyer cannot see.
+     */
+    private focusSeatsForFilter;
+    /** Turn the buyer's accessibility filter on or off from host code. Mirrors
+     *  the bridge command and the menu, so the three never diverge. */
+    setAccessibilityFilter(types: AccessibilityType[] | null): void;
     private dockLayoutChrome;
     /** The "Need more time?" prompt shown in the hold's final EXTEND_PROMPT_MS. */
     private buildExtendPrompt;
@@ -2610,8 +2699,15 @@ declare class SeatPicker implements GaPromptPicker {
     private max3dSeats;
     /** Reflect the active floor onto the switcher rail. */
     private syncFloors;
+    /** The tapped-section summary card in all three of its forms. Built lazily:
+     *  it reads `els`/`root`, which are assigned after construction. */
+    private get sectionCard();
     /** Show (or clear, on null) the tapped-section summary card. */
     private showSectionCard;
+    private renderSectionCard;
+    private collapseSectionCard;
+    private sectionCardOnView;
+    private fitSectionStripCount;
     /**
      * Open sections next to the focused one, in authored order.
      *
@@ -2621,43 +2717,6 @@ declare class SeatPicker implements GaPromptPicker {
      * are skipped because focusing one cannot produce a useful buyer card.
      */
     private sectionNeighbours;
-    private wireSectionNavigation;
-    /**
-     * Render the section card in the form the layout + state want: expanded card
-     * or slim pill in the top-center anchor region (wide), or a compact strip in
-     * the sheet head (narrow). Never floats over the seats at the tap point.
-     */
-    private renderSectionCard;
-    /**
-     * Flag the root while the phone locator is docked to the map's bottom edge,
-     * so the map's own bottom-corner controls lift above it. The bar owns that
-     * edge outright — without this the minimap/accessibility cluster and the
-     * zoom/fit/eye stack sit underneath it and only their rounded corners show.
-     */
-    private syncLocatorDock;
-    /**
-     * THE COUNT IS NEVER TRUNCATED. At 390px the strip carries a dot, the section
-     * name, the seats-left count, prev/next, and a "‹ Overview" chip; when that
-     * ran long the count was the flex item that shrank, and "73 seats left"
-     * clipped to "7" — not a smaller answer but a WRONG one, and one the buyer
-     * has no way to tell is wrong. The name is the answer to "where am I" and
-     * keeps its room; the count yields, in order: full text → short form
-     * ("7 left") → gone. Gone is honest; a clipped number is not.
-     *
-     * Re-run on every real host resize, so a rotation or a resized embed that
-     * makes room gives the long form back.
-     */
-    private fitSectionStripCount;
-    /** Collapse the expanded card to its slim pill (seat-picking started). */
-    private collapseSectionCard;
-    /**
-     * onViewChange hook for the card. The focus glide's own settle (within the
-     * grace window) enforces the ~25% coverage rule with the FINAL viewport; any
-     * later pan/zoom means seat-picking has begun → collapse to the pill.
-     */
-    private sectionCardOnView;
-    /** Fraction of the focused section's on-screen bbox covered by the card. */
-    private sectionCardCoverage;
     /**
      * The polite-live sentence for a partly-available seat, or '' for any other.
      *
@@ -2672,7 +2731,7 @@ declare class SeatPicker implements GaPromptPicker {
     private confirmTableDialog;
     private cancelTableDialog;
     private dismissTableDialog;
-    private showConfirm;
+    /** @internal */ showConfirm(seat: ExpandedSeat): void;
     private reanchorConfirm;
     private dismissConfirm;
     private commitConfirm;
@@ -2680,7 +2739,7 @@ declare class SeatPicker implements GaPromptPicker {
     private closeConfirm;
     private seatViewEnabled;
     /** Every bookable seat (cached) — neighbor heads for the generated panorama. */
-    private allSeats;
+    /** @internal */ allSeats(): ExpandedSeat[];
     /**
      * Open the drag-to-look-around 360° preview for a seat. Uses the organizer's
      * uploaded photo (seat.viewUrl) when present, else a panorama generated from
@@ -2824,6 +2883,8 @@ declare class SeatPicker implements GaPromptPicker {
         label: string;
         onClick: () => void;
     }): void;
+    /** Loading silhouette → real venue. The sequence lives in pickerBootReveal. */
+    private dismissSkeleton;
     private placeTooltip;
     /**
      * The Performance Group night strip for a two-tone seat.
@@ -2834,6 +2895,16 @@ declare class SeatPicker implements GaPromptPicker {
      * group whose wrapper did not supply the nights.
      */
     private nightStripFor;
+    /**
+     * Why a tapped seat cannot be taken, or '' when it can.
+     *
+     * Only the PRESS path asks for this — a mouse already has the status tag and
+     * a card that follows the pointer, so a sentence under every hover would be
+     * noise. A partly-available group seat is excluded: its night strip already
+     * names the exact nights that block it, and "already booked" would flatly
+     * contradict the row underneath saying it is free on Friday.
+     */
+    private unavailableReason;
     private unpinTooltip;
     private handleMapPointerDown;
     private updateTooltip;
@@ -2894,10 +2965,42 @@ declare class SeatPicker implements GaPromptPicker {
      * colours have not changed; safe to call on every render.
      */
     setMapTheme(map: PickerMapTheme | null): void;
+    /**
+     * Write the resolved `--sl-*` tokens onto the root, and stamp `data-theme`.
+     *
+     * `data-theme` is not read by the widget's own stylesheet — every rule spends
+     * tokens. It is there for the HOST: a page wrapping the picker needs to know
+     * which side the widget settled on to match its own chrome, and reading it
+     * off an attribute is cheaper and more reliable than re-deriving the
+     * luminance of a custom property. Absent when no mode is managed, so a host
+     * can tell "dark" from "not asked".
+     */
+    private applyThemeTokens;
+    /** Follow `prefers-color-scheme` only while the mode actually is `auto`. */
+    private watchThemeMode;
+    /**
+     * Re-ink everything a mode owns, WITHOUT touching the buyer's selection.
+     *
+     * The canvas half goes through the controller's `setMapTheme`, which rebuilds
+     * from the chart already in memory and restores the selection — so a reader
+     * flipping their phone into dark mode mid-purchase keeps their seats, their
+     * hold and their place on the map. No round trip is spent.
+     */
+    private repaintForThemeMode;
+    /**
+     * Switch the widget between light, dark and the reader's own preference
+     * after mount. `null` hands the colours back to the chart and the host.
+     *
+     * Selection-safe by construction — see {@link repaintForThemeMode}.
+     */
+    setThemeMode(mode: ThemeMode | null): void;
+    /** The mode the host asked for — `'auto'`, not what `auto` resolved to. */
+    getThemeMode(): ThemeMode | null;
     /**
      * Chrome docked on the map follows the MAP's ground, not the picker's — see
      * resolveMapChromeTokens. The map ground resolves the way the renderer does:
-     * host map override → chart theme → the picker's own background.
+     * host map override → the mode's ground → chart theme → the picker's own
+     * background — the same ladder the canvas itself is painted from.
      */
     private applyMapChromeTokens;
     /**
@@ -2927,19 +3030,7 @@ declare class SeatPicker implements GaPromptPicker {
      * A no-op when the map is unchanged, so a host may call it on every poll.
      */
     setPricing(pricing: SeatPickerPricing | undefined): void;
-    /**
-     * The opt-in language switcher.
-     *
-     * Rendered only when `languages` resolves to at least two distinct locales.
-     * Curated rather than all 37 on purpose — a German venue wants de/en/pl in
-     * the menu, not Welsh — and absent by default, because a multilingual host
-     * site already has its own switcher and two that can disagree is worse than
-     * either alone.
-     *
-     * Each language names itself: a reader scanning for their own finds
-     * "Deutsch", never "German". An English list is unreadable to exactly the
-     * people who need it.
-     */
+    /** The opt-in language switcher — see `pickerLocaleBoot.buildLanguageSwitcher`. */
     private buildLanguageSwitcher;
     /**
      * Change the language of a mounted picker, keeping the buyer's seats.
@@ -2951,25 +3042,29 @@ declare class SeatPicker implements GaPromptPicker {
      * language is not a trade worth making, so nothing here is destroyed and
      * rebuilt: the copy is re-applied in place.
      *
-     * Three passes, because the picker's ~195 `tf()` sites fall into three kinds:
-     *
-     * 1. The skeleton's static labels and aria — set once inside one `innerHTML`
-     *    template. Re-applied from the `data-sl-*` markers on those nodes.
-     * 2. The painters (tray, prices, CTA, offer, rails, rungs, floors) — these
-     *    already rebuild their HTML from `tf()` whenever state moves, so calling
-     *    them again is all it takes.
-     * 3. Everything transient — toasts, dialogs, screen-reader announcements,
-     *    tooltips. Those read `tf()` at the moment they fire, so they are already
-     *    correct the next time they run and must NOT be forced now.
-     *
-     * The map is last and goes through the controller, because its labels are
-     * baked into Konva `Text` at build time — a repaint would faithfully redraw
-     * the old language.
+     * `relanguagePicker` in pickerLocaleBoot.ts holds the three passes the copy
+     * on screen needs and the order they have to run in.
      *
      * Returns the locale that actually became active; an unsupported or
      * untranslated tag resolves to English rather than throwing.
      */
     setLocale(next: string | null | undefined): Promise<string>;
+    /**
+     * Re-say everything already on screen in the now-active locale.
+     *
+     * Split out of {@link setLocale} because two paths reach it: an explicit
+     * language change, and the boot dictionary landing after first paint (see
+     * `pickerLocaleBoot.ts`). Both have exactly the same work to do, and the
+     * second one is the reason `render()` no longer waits for a locale fetch.
+     *
+     * `generation` fences out a stale winner. Several locale loads can be in
+     * flight at once — the boot fetch, the event's own language arriving with the
+     * chart, a buyer using the language switcher — and they resolve in whatever
+     * order the network chooses. Without the fence the LAST to arrive wins rather
+     * than the last to be ASKED for, which is how a buyer who picks French ends
+     * up reading the organizer's German.
+     */
+    private applyActiveLocale;
     /** Current colorblind-safe render state, resolved from the stored buyer
      *  preference at mount. Host chrome (e.g. the Designer preview) reads this to
      *  surface the state rather than rendering colorblind colors silently. */
@@ -3019,16 +3114,18 @@ declare class SeatPicker implements GaPromptPicker {
      *  preserved inside the module). Cheap enough per status delta. */
     private pushAvailabilityTo3d;
     /** Mirror the authoritative widget selection into the 3D handle. */
-    private syncSelectionTo3d;
+    /** @internal */ syncSelectionTo3d(): void;
     /** Build the view-from-seat panorama the cinematic dissolves into — reuses the
      *  exact input path as the 2D `openSeatView` (organizer photo, else generated). */
     private seatViewFor3d;
     /** Route decoupled analytics into the host callback, tagged buyer. */
     private emitAnalytics;
-    private emit3dAnalytics;
+    /** @internal */ emit3dAnalytics(event: string, props?: Record<string, unknown>): void;
     /** A 3D seat tap runs the SAME selection path as a 2D tap: toggle through the
      *  controller, then raise the shared confirm card (bottom-sheeted in 3D). */
     private onView3dSeatPick;
+    /** The arrival caption for a seat-eye landing; assembled in pickerSeatViewChrome. */
+    private seatViewCaption;
     /** Explain a 3D seat that INVENTORY refuses — never one the buyer's own
      * filters merely dimmed, which stays buyable exactly as it is in 2D. Category
      * colour remains visible in the venue; this card names the availability state
@@ -3036,14 +3133,26 @@ declare class SeatPicker implements GaPromptPicker {
     private showUnavailable3dSeat;
     private dismissUnavailable3dSeat;
     private saveView3dComparisonSeat;
-    private clearView3dComparison;
-    private view3dComparisonSnapshot;
+    /** @internal */ clearView3dComparison(): void;
+    /** @internal */ view3dComparisonSnapshot(seatId: string): {
+        seat: ExpandedSeat;
+        label: string;
+        section: string;
+        row: string;
+        category: string;
+        price: string;
+        availability: string;
+        selectable: boolean;
+        viewSource: string;
+        limited: string;
+        accessibility: string;
+        confidence: _seatlayer_core_core_seatConfidence.SeatConfidenceDisclosure;
+    } | null;
+    /** The two dialogs INSIDE the 3D overlay — see pickerView3dModals.ts. */
     private openSeatConfidencePassport;
-    private reportSeatConfidenceView;
     private closeSeatConfidencePassport;
     private openView3dComparison;
     private closeView3dComparison;
-    private selectComparedSeat;
     private enter3d;
     private exit3d;
     /** Current active/restored hold reflected in the tray. */
@@ -3638,4 +3747,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, 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, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };