@seatlayer/js 0.93.0 → 0.95.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, AccessibilityType, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AccessibleSectionStep, AvailabilityRefreshOutcome, PickerController, ExpandedSeat, TableSelectionDetails, PickerSalesState } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, AccessibilityType, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AccessibleSectionStep, AvailabilityRefreshOutcome, RendererMinimapSnapshot, ISeatmapRenderer, PickerController, ExpandedSeat, TableSelectionDetails, PickerSalesState } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
-import { T as ThemeMode } from './channelsMode-B41tbE29.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-B41tbE29.cjs';
+import { T as ThemeMode } from './channelsMode-7x0h8OuH.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 SeatManagerArea, a8 as SeatManagerCapability, a9 as SeatManagerConnection, aa as SeatManagerFilteredSection, ab as SeatManagerMode, ac as SeatManagerOptions, ad as SeatManagerSelectionValidity, ae as SeatManagerTallies, af as SelectionSourceRow } from './channelsMode-7x0h8OuH.cjs';
 import * as _seatlayer_core_core_seatConfidence from '@seatlayer/core/core/seatConfidence';
 import { SeatConfidenceDisclosure } from '@seatlayer/core/core/seatConfidence';
 import { SeatViewStopName, Venue3DHandle, SeatState3D, SeatView } from '@seatlayer/core/view3d';
@@ -338,14 +338,26 @@ interface SubscribeTicket {
     protocols?: string[];
 }
 interface BuyerRealtimeOptions {
-    /** The subscribe URL. Must never carry a credential — asserted below. */
-    url: string;
+    /** The subscribe URL. Must never carry a credential — asserted below. A
+     *  function is read on every connection attempt, so a reconnect can carry
+     *  a rotated viewer id (see `onIdleExpired`). */
+    url: string | (() => string);
     sink: RealtimeSink;
     /** Mint a one-use ticket for THIS connection attempt. Returns null for the
      *  anonymous public case (no ticket needed). Throwing stops the client. */
     mintTicket?: () => Promise<SubscribeTicket | null>;
     /** Typed terminal access states. A 4401 `access_expired` close reconnects. */
     onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
+    /**
+     * The server's idle backstop closed the socket: 4401 `idle_expired`, sent
+     * once a public socket has stood for EVENT_SOCKET_IDLE_MINUTES. The client
+     * stops — the same socket would only be refused again — and the widget
+     * decides: raise its paused card, or, when the buyer is plainly still here
+     * (a live hold, recent input), `restart()` at once behind a rotated viewer
+     * id. Absent, the close is reported through `onAccessUnavailable` as the
+     * terminal revoked state, exactly as the runtimes before 0.94 read it.
+     */
+    onIdleExpired?: () => void;
     /** Test seam. Defaults to the global WebSocket. */
     socketFactory?: (url: string, protocols: string[]) => WebSocket;
     /** Test seam for the keepalive/backoff timers. */
@@ -407,6 +419,9 @@ declare class BuyerRealtimeClient {
      * Workflow step that has to replay deterministically.
      */
     private scheduleReconnect;
+    /** Socket reconnects this client has made in its lifetime — for the telemetry beacon. */
+    private reconnectCount;
+    get reconnects(): number;
     private clearPongTimer;
     private clearTimers;
 }
@@ -2079,6 +2094,8 @@ interface SeatingChartOptions {
 declare class SeatingChart {
     private readonly opts;
     private readonly controller;
+    private readonly chartFetch?;
+    private renderErrorEmitted;
     /** Publishable key used only by the public-only direct bootstrap path. */
     readonly publicKey?: string;
     private mount;
@@ -3159,28 +3176,56 @@ interface PerformanceGroupPickerInternal {
 type ConfirmCardMode = 'add' | 'remove';
 
 /**
- * pickerMinimap — the F3 venue-overview minimap: build, layout, static paint,
- * viewport rectangle, and the pointer/keyboard interactions that pan or focus
- * from it.
- *
- * Lifted out of SeatPicker.ts with the method bodies verbatim — statement for
- * statement, including canvas call order, which matters here because a 2D
- * context is a state machine and jsdom cannot exercise it. The ONLY edits are
- * the indirections through {@link MinimapHost}: `this.controller` →
- * `this.host.controller`, `this.cssVar` → `this.host.cssVar`, `this.tf` →
- * the module-level `tfStatic` it always delegated to, and the widget root and
- * focused-section label behind accessors (SeatPicker replaces both across a
- * re-mount, so they must be read late, not captured).
+ * MapCamera — what a map-chrome component (minimap, zoom pills, crumb) needs
+ * from the surface that owns the renderer (plan item 7, slice A).
  *
- * `build()` also takes its mount element as an argument rather than reading
- * SeatPicker's region map. Everything else — the two-canvas base/blit split,
- * the drag-capture bookkeeping, the click suppression after a drag — is
- * unchanged.
+ * Named so the chrome can be shared: the buyer picker's `PickerController`
+ * satisfies it by type, and the control room's manager satisfies it over its
+ * own renderer. Nothing here is picker-specific — it is the camera, the
+ * floors, the focus, and the overview snapshot the renderer already keeps.
  */
 
-/** What the minimap needs from the widget around it. */
+interface MapRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface MapCamera {
+    /** World-space rect currently visible + full chart bounds; null before a chart. */
+    getViewport(): {
+        visible: MapRect;
+        bounds: MapRect;
+    } | null;
+    getMinimapSnapshot(): RendererMinimapSnapshot;
+    /** Pan without changing zoom so `point` becomes the viewport centre. */
+    panToWorld(point: {
+        x: number;
+        y: number;
+    }): void;
+    /** Leave section-focus dimming without changing the current zoom. */
+    clearSectionFocus(): void;
+    /** Glide in on a section (the host surfaces whatever it surfaces on a tap). */
+    focusSection(id: string, anchor?: {
+        x: number;
+        y: number;
+    }): void;
+    /** The whole venue again: focus off, fit the chart. */
+    overview(): void;
+    getFloors(): {
+        id: string;
+        name: string;
+    }[];
+    getActiveFloorId(): string;
+    isFloorOverview(): boolean;
+    /** Optional: the renderer itself, for hosts that still reach past the camera. */
+    getRenderer?(): ISeatmapRenderer | null;
+}
+
+/** What the minimap needs from the surface around it. */
 interface MinimapHost {
-    readonly controller: PickerController;
+    /** The camera it reads and moves — a picker controller or a manager's map. */
+    readonly controller: MapCamera;
     /** The widget root — it carries `data-minimap-open`. A function, not a
      *  field: SeatPicker rebuilds its root, and a captured one goes stale. */
     root(): HTMLElement | null;
@@ -3189,8 +3234,15 @@ interface MinimapHost {
     /** Label of the last surfaced section card. Backs the minimap caption when
      *  the renderer snapshot reports no active section. */
     focusedSectionLabel(): string | undefined;
+    /**
+     * The display colour of a category, for the seat-dot thumbnail of a chart
+     * with no sections. ASKED OF THE HOST so a colourblind-safe remap reaches
+     * the map, the legend and this thumbnail from one place. Undefined = the
+     * flat availability colour.
+     */
+    tint?(categoryKey: string): string | undefined;
 }
-declare class PickerMinimap {
+declare class MapMinimap {
     private readonly host;
     private miniCanvas;
     private miniBase;
@@ -3511,6 +3563,8 @@ declare class SeatPicker implements GaPromptPicker {
     /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
     readonly opts: SeatPickerOptions;
     /** @internal */ readonly api: PickerTransport;
+    private readonly chartFetch;
+    private renderErrorEmitted;
     /** Authenticated view media, cached only for this picker lifetime. */
     /** @internal */ readonly buyerAssetUrls: BuyerAssetObjectUrls;
     /** Our own public client, or null when the host injected a transport. */
@@ -3519,6 +3573,8 @@ declare class SeatPicker implements GaPromptPicker {
     private readonly access;
     private realtime;
     private accessEl;
+    /** The buyer's idle clock (0.94, #78; pickerIdle.ts). Null until mounted or when turned off. */
+    private idleClock;
     /** @internal */ readonly apiBase: string;
     /** @internal */ controller: PickerController;
     /** @internal */ maxTickets: number;
@@ -3687,6 +3743,14 @@ declare class SeatPicker implements GaPromptPicker {
     /** "★ Best seats" premium quick-pick toggle — biases best-available to premium seats. */
     private baPremium;
     private bestAvailableConfirm;
+    /**
+     * Categories with nothing free, as the tray last drew them. Availability
+     * deltas repaint the legend, not the tray, so `syncSoldout` compares against
+     * this and repaints the tray only when a category sells out or comes back.
+     */
+    private baSoldOutSig;
+    /** Every category is sold out, so there is no best-seats form to open. */
+    /** @internal */ bestAvailableSoldOut: boolean;
     /** Event sales window is closed (read-only load state / live close). */
     /** @internal */ salesClosed: boolean;
     /**
@@ -3746,7 +3810,7 @@ declare class SeatPicker implements GaPromptPicker {
     /** The panel's price-band <select>, so the rail's reset chip can keep it in
      *  step. Null when the chart has fewer than two bands and none was built. */
     /** @internal */ priceSelect: HTMLSelectElement | null;
-    /** @internal */ minimap: PickerMinimap | null;
+    /** @internal */ minimap: MapMinimap | null;
     private pickerLayoutSize;
     private fullscreenAffordanceSize;
     /** @internal */ priceBandKeys: Set<string> | null;
@@ -4879,6 +4943,10 @@ declare class SeatPicker implements GaPromptPicker {
      */
     private recoverAccess;
     private dismissAccessPanel;
+    /** The idle clock and the paused card — see pickerIdlePause.ts. */
+    private get idlePauseHost();
+    private startIdleClock;
+    private resumeFromIdle;
     /**
      * The hold ran out under the buyer's feet — say so, and block.
      *

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, AccessibilityType, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AccessibleSectionStep, AvailabilityRefreshOutcome, PickerController, ExpandedSeat, TableSelectionDetails, PickerSalesState } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, AccessibilityType, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AccessibleSectionStep, AvailabilityRefreshOutcome, RendererMinimapSnapshot, ISeatmapRenderer, PickerController, ExpandedSeat, TableSelectionDetails, PickerSalesState } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
-import { T as ThemeMode } from './channelsMode-B41tbE29.js';
-export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, U as InventoryBookingObject, V as InventoryBookingState, W as InventoryBookingsPage, X as InventoryBookingsQuery, Y as LogEntry, Z as LogPage, _ as ManageApi, $ as ManageApiError, a0 as ReportByStatus, a1 as ReportCategoryMeta, a2 as ReportCategoryRow, a3 as ReportResult, a4 as SeatManager, a5 as SeatManagerActionResult, a6 as SeatManagerActivity, a7 as SeatManagerCapability, a8 as SeatManagerConnection, a9 as SeatManagerFilteredSection, aa as SeatManagerMode, ab as SeatManagerOptions, ac as SeatManagerSelectionValidity, ad as SeatManagerTallies, ae as SelectionSourceRow } from './channelsMode-B41tbE29.js';
+import { T as ThemeMode } from './channelsMode-7x0h8OuH.js';
+export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, U as InventoryBookingObject, V as InventoryBookingState, W as InventoryBookingsPage, X as InventoryBookingsQuery, Y as LogEntry, Z as LogPage, _ as ManageApi, $ as ManageApiError, a0 as ReportByStatus, a1 as ReportCategoryMeta, a2 as ReportCategoryRow, a3 as ReportResult, a4 as SeatManager, a5 as SeatManagerActionResult, a6 as SeatManagerActivity, a7 as SeatManagerArea, a8 as SeatManagerCapability, a9 as SeatManagerConnection, aa as SeatManagerFilteredSection, ab as SeatManagerMode, ac as SeatManagerOptions, ad as SeatManagerSelectionValidity, ae as SeatManagerTallies, af as SelectionSourceRow } from './channelsMode-7x0h8OuH.js';
 import * as _seatlayer_core_core_seatConfidence from '@seatlayer/core/core/seatConfidence';
 import { SeatConfidenceDisclosure } from '@seatlayer/core/core/seatConfidence';
 import { SeatViewStopName, Venue3DHandle, SeatState3D, SeatView } from '@seatlayer/core/view3d';
@@ -338,14 +338,26 @@ interface SubscribeTicket {
     protocols?: string[];
 }
 interface BuyerRealtimeOptions {
-    /** The subscribe URL. Must never carry a credential — asserted below. */
-    url: string;
+    /** The subscribe URL. Must never carry a credential — asserted below. A
+     *  function is read on every connection attempt, so a reconnect can carry
+     *  a rotated viewer id (see `onIdleExpired`). */
+    url: string | (() => string);
     sink: RealtimeSink;
     /** Mint a one-use ticket for THIS connection attempt. Returns null for the
      *  anonymous public case (no ticket needed). Throwing stops the client. */
     mintTicket?: () => Promise<SubscribeTicket | null>;
     /** Typed terminal access states. A 4401 `access_expired` close reconnects. */
     onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
+    /**
+     * The server's idle backstop closed the socket: 4401 `idle_expired`, sent
+     * once a public socket has stood for EVENT_SOCKET_IDLE_MINUTES. The client
+     * stops — the same socket would only be refused again — and the widget
+     * decides: raise its paused card, or, when the buyer is plainly still here
+     * (a live hold, recent input), `restart()` at once behind a rotated viewer
+     * id. Absent, the close is reported through `onAccessUnavailable` as the
+     * terminal revoked state, exactly as the runtimes before 0.94 read it.
+     */
+    onIdleExpired?: () => void;
     /** Test seam. Defaults to the global WebSocket. */
     socketFactory?: (url: string, protocols: string[]) => WebSocket;
     /** Test seam for the keepalive/backoff timers. */
@@ -407,6 +419,9 @@ declare class BuyerRealtimeClient {
      * Workflow step that has to replay deterministically.
      */
     private scheduleReconnect;
+    /** Socket reconnects this client has made in its lifetime — for the telemetry beacon. */
+    private reconnectCount;
+    get reconnects(): number;
     private clearPongTimer;
     private clearTimers;
 }
@@ -2079,6 +2094,8 @@ interface SeatingChartOptions {
 declare class SeatingChart {
     private readonly opts;
     private readonly controller;
+    private readonly chartFetch?;
+    private renderErrorEmitted;
     /** Publishable key used only by the public-only direct bootstrap path. */
     readonly publicKey?: string;
     private mount;
@@ -3159,28 +3176,56 @@ interface PerformanceGroupPickerInternal {
 type ConfirmCardMode = 'add' | 'remove';
 
 /**
- * pickerMinimap — the F3 venue-overview minimap: build, layout, static paint,
- * viewport rectangle, and the pointer/keyboard interactions that pan or focus
- * from it.
- *
- * Lifted out of SeatPicker.ts with the method bodies verbatim — statement for
- * statement, including canvas call order, which matters here because a 2D
- * context is a state machine and jsdom cannot exercise it. The ONLY edits are
- * the indirections through {@link MinimapHost}: `this.controller` →
- * `this.host.controller`, `this.cssVar` → `this.host.cssVar`, `this.tf` →
- * the module-level `tfStatic` it always delegated to, and the widget root and
- * focused-section label behind accessors (SeatPicker replaces both across a
- * re-mount, so they must be read late, not captured).
+ * MapCamera — what a map-chrome component (minimap, zoom pills, crumb) needs
+ * from the surface that owns the renderer (plan item 7, slice A).
  *
- * `build()` also takes its mount element as an argument rather than reading
- * SeatPicker's region map. Everything else — the two-canvas base/blit split,
- * the drag-capture bookkeeping, the click suppression after a drag — is
- * unchanged.
+ * Named so the chrome can be shared: the buyer picker's `PickerController`
+ * satisfies it by type, and the control room's manager satisfies it over its
+ * own renderer. Nothing here is picker-specific — it is the camera, the
+ * floors, the focus, and the overview snapshot the renderer already keeps.
  */
 
-/** What the minimap needs from the widget around it. */
+interface MapRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface MapCamera {
+    /** World-space rect currently visible + full chart bounds; null before a chart. */
+    getViewport(): {
+        visible: MapRect;
+        bounds: MapRect;
+    } | null;
+    getMinimapSnapshot(): RendererMinimapSnapshot;
+    /** Pan without changing zoom so `point` becomes the viewport centre. */
+    panToWorld(point: {
+        x: number;
+        y: number;
+    }): void;
+    /** Leave section-focus dimming without changing the current zoom. */
+    clearSectionFocus(): void;
+    /** Glide in on a section (the host surfaces whatever it surfaces on a tap). */
+    focusSection(id: string, anchor?: {
+        x: number;
+        y: number;
+    }): void;
+    /** The whole venue again: focus off, fit the chart. */
+    overview(): void;
+    getFloors(): {
+        id: string;
+        name: string;
+    }[];
+    getActiveFloorId(): string;
+    isFloorOverview(): boolean;
+    /** Optional: the renderer itself, for hosts that still reach past the camera. */
+    getRenderer?(): ISeatmapRenderer | null;
+}
+
+/** What the minimap needs from the surface around it. */
 interface MinimapHost {
-    readonly controller: PickerController;
+    /** The camera it reads and moves — a picker controller or a manager's map. */
+    readonly controller: MapCamera;
     /** The widget root — it carries `data-minimap-open`. A function, not a
      *  field: SeatPicker rebuilds its root, and a captured one goes stale. */
     root(): HTMLElement | null;
@@ -3189,8 +3234,15 @@ interface MinimapHost {
     /** Label of the last surfaced section card. Backs the minimap caption when
      *  the renderer snapshot reports no active section. */
     focusedSectionLabel(): string | undefined;
+    /**
+     * The display colour of a category, for the seat-dot thumbnail of a chart
+     * with no sections. ASKED OF THE HOST so a colourblind-safe remap reaches
+     * the map, the legend and this thumbnail from one place. Undefined = the
+     * flat availability colour.
+     */
+    tint?(categoryKey: string): string | undefined;
 }
-declare class PickerMinimap {
+declare class MapMinimap {
     private readonly host;
     private miniCanvas;
     private miniBase;
@@ -3511,6 +3563,8 @@ declare class SeatPicker implements GaPromptPicker {
     /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
     readonly opts: SeatPickerOptions;
     /** @internal */ readonly api: PickerTransport;
+    private readonly chartFetch;
+    private renderErrorEmitted;
     /** Authenticated view media, cached only for this picker lifetime. */
     /** @internal */ readonly buyerAssetUrls: BuyerAssetObjectUrls;
     /** Our own public client, or null when the host injected a transport. */
@@ -3519,6 +3573,8 @@ declare class SeatPicker implements GaPromptPicker {
     private readonly access;
     private realtime;
     private accessEl;
+    /** The buyer's idle clock (0.94, #78; pickerIdle.ts). Null until mounted or when turned off. */
+    private idleClock;
     /** @internal */ readonly apiBase: string;
     /** @internal */ controller: PickerController;
     /** @internal */ maxTickets: number;
@@ -3687,6 +3743,14 @@ declare class SeatPicker implements GaPromptPicker {
     /** "★ Best seats" premium quick-pick toggle — biases best-available to premium seats. */
     private baPremium;
     private bestAvailableConfirm;
+    /**
+     * Categories with nothing free, as the tray last drew them. Availability
+     * deltas repaint the legend, not the tray, so `syncSoldout` compares against
+     * this and repaints the tray only when a category sells out or comes back.
+     */
+    private baSoldOutSig;
+    /** Every category is sold out, so there is no best-seats form to open. */
+    /** @internal */ bestAvailableSoldOut: boolean;
     /** Event sales window is closed (read-only load state / live close). */
     /** @internal */ salesClosed: boolean;
     /**
@@ -3746,7 +3810,7 @@ declare class SeatPicker implements GaPromptPicker {
     /** The panel's price-band <select>, so the rail's reset chip can keep it in
      *  step. Null when the chart has fewer than two bands and none was built. */
     /** @internal */ priceSelect: HTMLSelectElement | null;
-    /** @internal */ minimap: PickerMinimap | null;
+    /** @internal */ minimap: MapMinimap | null;
     private pickerLayoutSize;
     private fullscreenAffordanceSize;
     /** @internal */ priceBandKeys: Set<string> | null;
@@ -4879,6 +4943,10 @@ declare class SeatPicker implements GaPromptPicker {
      */
     private recoverAccess;
     private dismissAccessPanel;
+    /** The idle clock and the paused card — see pickerIdlePause.ts. */
+    private get idlePauseHost();
+    private startIdleClock;
+    private resumeFromIdle;
     /**
      * The hold ran out under the buyer's feet — say so, and block.
      *