@seatlayer/core 0.51.0 → 0.53.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as RowObject, A as AccessibilityType, S as SeatOverride, b as SeatViewMetadata, L as LabelStyle, c as RectTableSide, C as ChartDoc, d as ChartObject, B as BoothObject, E as ExpandedSeat, T as TableObject, F as Floor, P as Point, e as SectionObject, f as RectTableSeatCounts, G as GAAreaObject, g as GAInventorySegment, h as RendererQualityEvidence, i as RenderedFreeTextEvidence, I as ISeatmapRenderer, j as RendererOptions, k as SeatStatus, l as RendererViewMode, m as LodRung, n as CategoryTier, o as SeatCommercialAttributes, p as RendererCallbacks } from './types-DR54nqKL.js';
-export { q as ACCESSIBILITY_RING_COLOR, r as ACCESSIBILITY_TYPES, s as AccessibilityMeta, t as AuthoringObjectState, u as CHART_STORAGE_KEY, v as Category, w as ChartReferenceImage, x as ChartTheme, y as CubicPath, D as DecorImageObject, z as LABEL_STYLE_MAX_SIZE, H as LABEL_STYLE_MIN_SIZE, J as LabelPresentation, O as ObjectEditorState, K as ReferenceAccessibilitySource, M as ReferenceCalibration, N as ReferenceCategorySource, Q as ReferenceDerivedScale, U as ReferenceInventoryExclusionSource, V as ReferenceInventorySource, W as ReferenceScanProposal, X as ReferenceScanRowProposal, Y as ReferenceScanSectionProposal, Z as ReferenceSeatSeed, _ as ReferenceSectionTraceBatchInput, $ as ReferenceSectionTraceBatchProposal, a0 as ReferenceSectionTraceInput, a1 as ReferenceSectionTraceProposal, a2 as RenderedBookableLabelEvidence, a3 as RenderedGAAreaEvidence, a4 as RenderedHierarchyLabelEvidence, a5 as RenderedLabelHiddenReason, R as ResolvedSeatConfidenceEvidence, a6 as SEAT_COMMERCIAL_MARKS, a7 as SURROUNDINGS_SHAPE_ROLES, a8 as SeatCommercialMark, a9 as SeatCommercialMeta, aa as SeatConfidenceCoverage, ab as SeatConfidenceEvidence, ac as SeatConfidenceModelLevel, ad as SeatConfidenceModeledTarget, ae as SeatConfidenceRealityLevel, af as SeatViewCoverage, ag as SectionOutlinePath, ah as SectionPathSegment, ai as SelectionLayer, aj as ShapeLineCap, ak as ShapeLineEnding, al as ShapeLineJoin, am as ShapeObject, an as TextAlignment, ao as TextBackground, ap as TextObject, aq as ZoneDef, ar as accessibilityMeta, as as accessibilityRingColor, at as layerOf, au as seatCommercialMeta } from './types-DR54nqKL.js';
+import { a as RowObject, A as AccessibilityType, S as SeatOverride, b as SeatViewMetadata, L as LabelStyle, c as RectTableSide, C as ChartDoc, d as ChartObject, B as BoothObject, E as ExpandedSeat, T as TableObject, P as Point, F as Floor, e as SectionObject, f as RectTableSeatCounts, G as GAAreaObject, g as GAInventorySegment, h as RendererQualityEvidence, i as RenderedFreeTextEvidence, I as ISeatmapRenderer, j as RendererOptions, k as SeatStatus, l as RendererViewMode, m as RendererMinimapSnapshot, n as LodRung, o as CategoryTier, p as SeatCommercialAttributes, q as RendererCallbacks } from './types-tLOunI-B.js';
+export { r as ACCESSIBILITY_RING_COLOR, s as ACCESSIBILITY_TYPES, t as AccessibilityMeta, u as AuthoringObjectState, v as CHART_STORAGE_KEY, w as Category, x as ChartLayoutConstraint, y as ChartReferenceImage, z as ChartTheme, D as CubicPath, H as DecorImageObject, J as LABEL_STYLE_MAX_SIZE, K as LABEL_STYLE_MIN_SIZE, M as LabelPresentation, O as ObjectEditorState, N as Physical3dEvidence, Q as RadialClearanceLayoutConstraint, U as ReferenceAccessibilitySource, V as ReferenceCalibration, W as ReferenceCategorySource, X as ReferenceDerivedScale, Y as ReferenceInventoryExclusionSource, Z as ReferenceInventorySource, _ as ReferenceScanProposal, $ as ReferenceScanRowProposal, a0 as ReferenceScanSectionProposal, a1 as ReferenceSeatSeed, a2 as ReferenceSectionTraceBatchInput, a3 as ReferenceSectionTraceBatchProposal, a4 as ReferenceSectionTraceInput, a5 as ReferenceSectionTraceProposal, a6 as RenderedBookableLabelEvidence, a7 as RenderedGAAreaEvidence, a8 as RenderedHierarchyLabelEvidence, a9 as RenderedLabelHiddenReason, aa as RenderedRowLabelEvidence, ab as RendererMinimapSeat, ac as RendererMinimapSection, R as ResolvedSeatConfidenceEvidence, ad as SEAT_COMMERCIAL_MARKS, ae as SURROUNDINGS_SHAPE_ROLES, af as SeatCommercialMark, ag as SeatCommercialMeta, ah as SeatConfidenceCoverage, ai as SeatConfidenceEvidence, aj as SeatConfidenceModelLevel, ak as SeatConfidenceModeledTarget, al as SeatConfidenceRealityLevel, am as SeatViewCoverage, an as SectionOutlinePath, ao as SectionPathSegment, ap as SelectionLayer, aq as ShapeLineCap, ar as ShapeLineEnding, as as ShapeLineJoin, at as ShapeObject, au as TextAlignment, av as TextBackground, aw as TextObject, ax as TicketTierApplicability, ay as TicketTierEvidence, az as TicketTierRestriction, aA as ZoneDef, aB as accessibilityMeta, aC as accessibilityRingColor, aD as layerOf, aE as seatCommercialMeta } from './types-tLOunI-B.js';
 
 /**
  * The segmented-row model — one logical row made of several physical rows.
@@ -165,6 +165,8 @@ declare function floorsOf(doc: ChartDoc): Floor[];
 declare function floorObjects(doc: ChartDoc, floorId?: string): ChartObject[];
 /** Every object across ALL floors — the whole venue (single-floor = `doc.objects`). */
 declare function allObjects(doc: ChartDoc): ChartObject[];
+/** A copy of an object translated by (dx, dy) — every coordinate field shifted. */
+declare function translateObject(o: ChartObject, dx: number, dy: number): ChartObject;
 /**
  * Multi-floor 3D stack (Batch 5): flatten every floor into ONE doc with floor `i`
  * lifted by `i * spread` in −y, so the isometric view shows the floors as stacked
@@ -172,6 +174,26 @@ declare function allObjects(doc: ChartDoc): ChartObject[];
  * only for the 3D overview render — 2D still shows one floor via `floorObjects`.
  */
 declare function stackFloors(doc: ChartDoc, spread?: number): ChartDoc;
+/**
+ * Build the buyer-facing 2D overview of a multi-floor chart.
+ *
+ * Floors commonly reuse the same drawing origin (a balcony is authored over
+ * the stalls it overlooks). Flattening those source coordinates makes a valid
+ * import look corrupt because every level is painted on top of every other
+ * level. This projection packs complete floors into a compact, content-aware
+ * grid. Each floor receives one rigid translation: no seat, row, section,
+ * annotation, gap, or rotation changes, and the canonical document is never
+ * mutated.
+ */
+declare function layoutFloorOverview(doc: ChartDoc): ChartDoc;
+/**
+ * Rigid per-floor translations used by the buyer's complete-venue overview.
+ *
+ * Kept as a pure public helper so 2D and 3D can present the same non-overlapping
+ * level arrangement without either renderer rewriting the authored chart. A
+ * zero translation is returned for a single-floor document.
+ */
+declare function floorOverviewTranslations(doc: ChartDoc): Point[];
 interface ExpandChartOptions {
     /** Physical height for a single-floor projection extracted from a multi-floor
      * document. Full multi-floor documents resolve each floor directly. */
@@ -437,16 +459,6 @@ interface RenderedQualityReport {
  */
 declare function inspectRenderedQualityEvidence(evidence: RendererQualityEvidence, state?: RenderedEvidenceState, targetCategoryKey?: string | null): RenderedQualityReport;
 
-/**
- * SeatmapRenderer — the shared canvas rendering core (buyer picker shell).
- *
- * Uses Konva directly with per-module imports to keep the bundle lean. The
- * whole point of the spike is staying smooth at ~5,000 seats on mobile, so the
- * hot paths lean on: layer bitmap caching + listening(false) when zoomed out,
- * per-seat fill updates (never full rebuilds) on status change, and viewport-
- * only label rendering rebuilt on interaction-end rather than per frame.
- */
-
 declare class SeatmapRenderer implements ISeatmapRenderer {
     private container;
     private opts;
@@ -472,6 +484,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private activeFloorId;
     /** When true on a multi-floor chart, render ALL floors stacked (3D overview). */
     private stacked;
+    /** Buyer-facing 2D overview: floors are rigidly arranged without altering topology. */
+    private floorOverview;
     /** Interactive node per seat/booth — a Circle for seats, a Rect for booths. */
     private circleById;
     /** Booth block geometry, keyed by booth id (= the unit's rowId). */
@@ -621,35 +635,18 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private resizeObs;
     /** Coalesces bursty view-change sources (pointermove, wheel) into ≤1 callback/frame. */
     private viewChangeRaf;
-    private pointers;
-    private pinch;
-    private panLast;
-    private panStart;
-    private panStarted;
-    /** Maximum displacement from gesture start — suppress taps only after a real pan/pinch. */
-    private moved;
-    /**
-     * Ghost-click guard. Konva binds `_pointerup` to mouseup, touchend AND
-     * pointerup, so `on('click tap')` is two handlers for one finger tap unless
-     * the browser's synthesized compatibility click is suppressed. Konva only
-     * suppresses it when the touch lands on a LISTENING SHAPE (Stage.js returns
-     * early before its preventDefault() when `!shape || !shape.isListening()`),
-     * so a near-miss rescued by nearestSeatToScreen used to fire `tap` (select)
-     * then `click` (deselect) 1-3ms apart and net to nothing. With
-     * SEAT_TAP_SLOP_PX=14 against a ~12px seat radius, that broken annulus is
-     * ~3.7x the area of the seat itself — i.e. most successful mobile taps.
-     * `touch-action: none` does NOT suppress compatibility mouse events.
-     */
-    private lastTapAt;
-    /**
-     * True when this is the browser's synthesized compatibility click following a
-     * finger tap we already handled. Discriminates on `e.type` deliberately —
-     * `PointerEvent extends MouseEvent`, so an `instanceof MouseEvent` test
-     * matches genuine pointer taps too. One shared timestamp across the layer and
-     * stage handlers: a tap consumed at the layer must also suppress the ghost at
-     * the stage, and only `click` is ever rejected, so bubbling stays intact.
+    /**
+     * Pan/pinch state machine (`render/interaction/pointer`). Raw pointer events
+     * on the container, not Konva stage dragging — its touch pipeline proved
+     * unreliable for multi-touch on real devices. Also owns the ghost-click
+     * timestamp shared by the layer and stage tap handlers.
      */
+    private gestures;
+    /** Displacement of the current gesture — a tap must stay under the slop. */
+    private get moved();
     private isGhostClick;
+    /** Behavioural surface the gesture machine calls back into. */
+    private get pointerHost();
     /**
      * Manage-mode rubber-band marquee (option-gated). `start`/`cur` are WORLD-space
      * points (overlayLayer rides the stage transform); `rect` is the on-canvas
@@ -661,8 +658,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setChart(doc: ChartDoc, opts?: {
         floorId?: string;
     }): void;
-    /** The chart to render: all floors stacked (3D overview), the active floor, or
-     *  the whole chart for single-floor charts. */
+    /** The chart to render: authored-coordinate overview, stacked 3D overview,
+     *  the active floor, or the whole chart for single-floor charts. */
     private floorView;
     /** Physical floor height is authored data; the 900-unit stacked overview
      * spread is presentation-only and must never leak into real 3D geometry. */
@@ -671,6 +668,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      *  single-floor charts. The caller re-applies statuses + animates the iso view. */
     setStacked(on: boolean): void;
     isStacked(): boolean;
+    /** Toggle the buyer's combined 2D floor overview. Every floor is translated
+     *  as one rigid group for clarity; its authored internal topology is exact. */
+    setFloorOverview(on: boolean): void;
+    isFloorOverview(): boolean;
     /** Switch which floor is shown (2D). Re-renders + re-fits; no-op if unchanged. */
     setActiveFloor(floorId: string): void;
     /** Floors for the host's switcher (single-floor charts return one synthetic floor). */
@@ -740,6 +741,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Pan/zoom so a seat sits on-screen at a legible scale (for keyboard focus). */
     private ensureVisible;
     zoomToFit(): void;
+    /**
+     * Reframe after a host/layout resize without throwing away section context.
+     * The stage already represents the usable map area (the picker side panel is
+     * a sibling), so measuring it here naturally respects open/closed panels.
+     */
+    refitCurrentView(): void;
     /** Step factor for the on-screen +/− buttons (B1) — same clamp path as pinch/wheel. */
     private static readonly ZOOM_STEP;
     zoomIn(): void;
@@ -782,6 +789,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setViewMode(mode: RendererViewMode): void;
     /** Current projection — reflects the tween target, not the mid-tween isoT. */
     getViewMode(): RendererViewMode;
+    /** Live ISO projection state handed to the `render/projection` free functions. */
+    private get isoState();
     /** Iso angle (rad) + y-squash for the current isoT. */
     private isoParams;
     /** Effective vertical scale = stage scale × iso squash — legibility math uses this. */
@@ -815,6 +824,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private resetLayerTransforms;
     /** Restore section-owned containers before applying another projection. */
     private resetSectionProjection;
+    /** Node/cache context the shared seat-anchor pass reads and updates. */
+    private get seatAnchorContext();
     /** Move native seat/booth hit shapes to or from their exact pinhole anchors. */
     private applyExactSeatAnchors;
     /**
@@ -929,10 +940,20 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setClosedSections(ids: string[] | null): void;
     /**
      * AXS section-focus: dim + desaturate every other section, draw a calm backdrop
-     * panel behind this section's seats, and glide the camera in to frame it (the
-     * seat-pick gate below only lets buyers pick once seats are ≥ LABEL_SCALE big).
+     * panel behind this section's seats, and glide the camera to a padded fit of
+     * the whole section. A large section may therefore use smaller seat markers,
+     * but it never clips its outer rows merely to meet a fixed detail scale.
      */
     focusSection(id: string): void;
+    /**
+     * Release only the focus dim + backdrop, keeping the focused-section state
+     * (summary card, adjacent-section navigation, LOD) intact. Called on the
+     * buyer's first manual pan/pinch/wheel after a section glide: the dim reads
+     * as "everything else is disabled", but every seat outside the focus was
+     * always hit-testable — free roaming across sections is the product
+     * behaviour, the glide is only an entrance.
+     */
+    private releaseSectionFocusDim;
     /** Clear an AXS section focus — restore full-bowl brightness + drop the backdrop. */
     clearSectionFocus(): void;
     /** The currently AXS-focused section id, or null. */
@@ -960,6 +981,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
         width: number;
         height: number;
     };
+    /** Live minimap geometry comes from the rendered scene, so a content-aware
+     * all-floor layout cannot collapse back onto the source coordinate stack. */
+    getMinimapSnapshot(): RendererMinimapSnapshot;
+    /** Minimap drag/click navigation: preserve zoom and move one world point to
+     * the viewport centre. Works for flat and projected views via worldToScreen. */
+    panToWorld(point: Point): void;
     /** Legend hover: highlight one category (dim the rest), or null to clear. */
     setCategoryHighlight(key: string | null): void;
     private renderBackground;
@@ -980,12 +1007,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * single drawImage per frame, and it rides the same layer cache — effectively
      * zero per-frame cost. Never listens, so it can't intercept a seat click.
      */
+    /** Node/registry surface the `render/objectDrawing` factories draw into. */
+    private get objectDrawContext();
     private renderDecorImage;
     private renderTable;
     private renderText;
     private renderShape;
-    /** Prominent stage caption: uppercase, letter-spaced, larger, softly dimmed. */
-    private addStageLabel;
     private renderGA;
     /**
      * A section renders in three coordinated layers driven by the LOD melt:
@@ -1066,7 +1093,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     }): string | null;
     /** Seat ids belonging to a section (Slice 5 section-summary card). */
     sectionMembers(id: string): string[];
-    private addCentredLabel;
     private isSelectable;
     private toggleSeat;
     /**
@@ -1119,10 +1145,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * so within-floor elevation offsets don't affect the result. Null if none.
      */
     private deckFloorAt;
-    private toLocal;
-    private onPointerDown;
-    private onPointerMove;
-    private onPointerEnd;
     /**
      * Min is chart-relative (never lose the room); max is absolute so seats
      * reach a readable size on any chart, however large the venue.
@@ -1153,6 +1175,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private cancelGlide;
     /** Current LOD rung derived from effective zoom — drives the ZONES/SECTIONS/SEATS pill. */
     getRung(): LodRung;
+    /** Explicit view of this renderer as the evidence pass's declared surface. */
+    private get renderedQualityContext();
     getRenderedQualityEvidence(): RendererQualityEvidence;
     /** Jump the camera to a rung's zoom band (glided). */
     setRung(rung: LodRung): void;
@@ -1217,21 +1241,14 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     captureCanvas(): HTMLCanvasElement;
     private updateFreeTextVisibility;
+    /** Geometric association only: importer data remains unchanged. */
+    private nodeBelongsToFocusedSection;
     /** OV-45(a): resolve authored row-letter labels for the buyer/preview map, in
-     *  world space, matching the Designer's placement contract (start/end/both/none
-     *  preset, a free-drag `position` that wins over the preset, rotation, and
-     *  labelStyle colour/size fed through the same auto-contrast guard). Segmented
-     *  rows keep their own logical-label handling and are resolved by their owner. */
+     *  world space (see `render/rowLabelPlan`). */
     private buildRowLabelPlan;
     /** Axis-aligned world bounds of a centred, potentially rotated row label. */
     private rowLabelBox;
-    /**
-     * Keep an automatic start/end label out of seat markers and already-painted
-     * text. The authored point is never altered. Candidates are deliberately
-     * bounded and deterministic: the closest clear offset wins; if a chart is so
-     * dense that none is clear, the least-colliding candidate wins so the required
-     * row label remains present rather than being silently dropped.
-     */
+    /** Keep an automatic start/end label out of seats and already-painted text. */
     private resolveAutomaticRowLabelPosition;
     /** Row labels never carry status; the buyer just dims them under the same
      *  category/price filters that dim their seats. */
@@ -1242,6 +1259,23 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
 }
 declare function createRenderer(container: HTMLDivElement, opts?: RendererOptions): ISeatmapRenderer;
 
+interface CompanionSelectionIssue {
+    code: 'companion_pair_required';
+    labels: string[];
+    message: string;
+}
+interface TicketOptionApplicabilityIssue {
+    code: 'ticket_option_not_applicable';
+    labels: string[];
+    message: string;
+}
+interface NotForSaleSelectionIssue {
+    code: 'not_for_sale';
+    labels: string[];
+    message: string;
+}
+type TicketSelectionIssue = CompanionSelectionIssue | TicketOptionApplicabilityIssue | NotForSaleSelectionIssue;
+
 interface PickerSeat {
     id: string;
     label: string;
@@ -1261,6 +1295,8 @@ interface PickerSeat {
     categoryKey: string;
     /** Price for the chosen tier when the category has tiers, else the base price. */
     price: number;
+    /** ISO-4217 event currency carried with SDK selection callbacks. */
+    currency: string;
     /** Ticket tiers the seat's category offers (Adult/Child/…); absent when none. */
     tiers?: CategoryTier[];
     /** The chosen tier's id — defaults to the first tier; absent when no tiers. */
@@ -1322,6 +1358,14 @@ interface HoldConflict {
     label: string;
     status: string;
 }
+/** A locally detected selection-rule failure. Its public shape mirrors API
+ * problems so SDK hosts can handle client and server enforcement identically. */
+declare class PickerSelectionError extends Error {
+    readonly status = 422;
+    readonly reason: TicketSelectionIssue['code'];
+    readonly labels: string[];
+    constructor(issue: TicketSelectionIssue);
+}
 /** An open hold — its id, the labels it covers, and the server's expiry time (ms epoch). */
 interface HoldInfo {
     holdId: string;
@@ -1337,7 +1381,11 @@ interface SectionCategory {
     key: string;
     label: string;
     color: string;
+    /** Cheapest ticket choice in this category. `price` remains this value for
+     * source compatibility with existing SDK hosts. */
     price: number;
+    priceMin: number;
+    priceMax: number;
     count: number;
 }
 /**
@@ -1568,6 +1616,20 @@ interface PickerOptions extends PickerCallbacks {
      */
     mapTheme?: PickerMapTheme | null;
 }
+/** Privacy-safe timings for one buyer-map load. Values are milliseconds and
+ * contain no chart, seat, hold, buyer, or URL data. Hosts may aggregate these
+ * with coarse chart-size/device dimensions supplied by the widget. */
+interface PickerRenderPerformanceProfile {
+    loadChart: number;
+    normalizeBuyerModel: number;
+    createRenderer: number;
+    loadStatuses: number;
+    buildScene: number;
+    applyInitialState: number;
+    firstPaint: number;
+    startRealtime: number;
+    controllerTotal: number;
+}
 /**
  * The subset of `ChartTheme` a HOST may override on the drawn canvas.
  *
@@ -1729,6 +1791,7 @@ declare class PickerController {
         mode?: string;
         /** Absolute event-poster URL, when the server can publicly serve one. */
         posterUrl?: string | null;
+        performanceProfile: PickerRenderPerformanceProfile;
     } | null>;
     getSelection(): PickerSeat[];
     /** Enriched metadata for a seat confirmation card or tooltip. */
@@ -1839,10 +1902,14 @@ declare class PickerController {
     private releaseConfirmed;
     setStatus(ids: string[], status: SeatStatus): void;
     getStatus(id: string): SeatStatus | undefined;
+    /** Seat ids whose category the author marked not-for-sale. */
+    private notForSaleCategorySeatIds;
     flashSeat(id: string, color?: string): void;
     zoomIn(): void;
     zoomOut(): void;
     zoomToFit(): void;
+    /** Preserve section focus while the usable map viewport changes. */
+    refitCurrentView(): void;
     worldToScreen(p: {
         x: number;
         y: number;
@@ -1870,6 +1937,9 @@ declare class PickerController {
     /** 3D all-floors stacked overview ⇄ active floor. Re-applies statuses after. */
     setStacked(on: boolean): void;
     isMultiFloor(): boolean;
+    /** Enter/leave the source-coordinate all-floor buyer overview. */
+    setFloorOverview(on: boolean): void;
+    isFloorOverview(): boolean;
     /** Tap-a-deck-to-enter: leave the 3D stack, drop to flat 2D on `floorId`, and
      *  tell the host so it can sync its 2D/3D toggle + floor-switcher state. */
     private handleDeckTap;
@@ -1907,8 +1977,20 @@ declare class PickerController {
             height: number;
         };
     } | null;
+    getMinimapSnapshot(): RendererMinimapSnapshot;
+    panToWorld(point: {
+        x: number;
+        y: number;
+    }): void;
+    /** Leave section-focus dimming without changing the current zoom. Used when
+     * the minimap viewport itself is dragged to a different part of the venue. */
+    clearSectionFocus(): void;
+    /** Read-only browser-render evidence for parity/performance audit tooling. */
+    getRenderedQualityEvidence(): RendererQualityEvidence | null;
     /** Glide in on a section and surface its summary (same path as a section tap). */
     focusSection(id: string): void;
+    /** Live seat membership count used by buyer section-navigation controls. */
+    getSectionSeatCount(id: string): number;
     /** Zoom back out to the whole chart and clear the section-summary card + focus. */
     overview(): void;
     /** Glide the camera into a tapped section and emit its computed summary. Uses
@@ -1927,6 +2009,10 @@ declare class PickerController {
     private describeSeat;
     private priceFor;
     private tiersFor;
+    private tiersForSeat;
+    private seatTierResolution;
+    private tableTierSeat;
+    private tableTierResolution;
     /**
      * Choose a ticket tier for a selected seat (e.g. Adult → Child). Re-emits the
      * selection so the host's cart + the eventual hold carry the new tier + price.
@@ -1937,6 +2023,9 @@ declare class PickerController {
     /** PickerSeats (with chosen tier) for a set of held labels. */
     private seatsForLabels;
     private emitSelectionChange;
+    /** Check explicit tier applicability and companion relationships for the
+     * current (or supplied) seats. Ticket display names are never semantic input. */
+    ticketIssue(labels?: string[]): TicketSelectionIssue | null;
     /** Whether the last emitted hint was non-null (avoids clearing repeatedly). */
     private hintShown;
     /**
@@ -2006,11 +2095,8 @@ declare class PickerController {
     private connect;
     /**
      * Backoff for the PLAIN-socket fallback (a transport with no v1 client of its
-     * own). Full jitter, for the same reason BuyerRealtimeClient uses it: a
-     * deterministic `2**attempt` schedule brings every browser that lost the same
-     * socket back in the same millisecond, and an on-sale crowd reconnecting in
-     * lockstep turns one blip into a thundering herd. The ceiling still doubles,
-     * so a sustained outage still backs off.
+     * own). Full jitter, for the same reason BuyerRealtimeClient uses it — see
+     * `core/backoff`, which now owns that rationale and the schedule.
      */
     private scheduleReconnect;
 }
@@ -2098,6 +2184,14 @@ declare function setStringOverrides(next: Dict): void;
 declare function t(key: string, vars?: Record<string, string | number>): string;
 /** "1 seat" / "3 seats" without hand-rolled concatenation. */
 declare function tCount(key: string, count: number, vars?: Record<string, string | number>): string;
+/**
+ * Kept for the SDK surface that imports dates from here. It is a thin pass to
+ * `core/datetime`, which owns every date shape in the app and caches its
+ * formatters per (locale, shape) — the defaults below are the same ones it
+ * uses, so the two were already interchangeable and are now literally the same
+ * code. `active` is passed explicitly so this cannot drift from `t()` even if
+ * something calls `setDateTimeLocale` on its own.
+ */
 declare function formatDate(value: number | Date, opts?: Intl.DateTimeFormatOptions): string;
 
 /**
@@ -2141,9 +2235,14 @@ declare function setMoneyLocale(locale: string | undefined): void;
 /**
  * "€45" / "$1,500" / "45 €" (locale-dependent placement).
  * Whole amounts render without ".00" (design shows "$45", "$120"); pass
- * `fractionDigits` for fixed precision (e.g. 3 for "$0.045 / credit").
+ * `fractionDigits` for fixed precision (e.g. 3 for "$0.045 / credit", or `0`
+ * for a report column that rounds to whole units).
+ *
+ * `locale` overrides the app locale for one call — the buyer-facing website
+ * templates render in the VISITOR's language, which is not necessarily the
+ * dashboard's. Mirrors `DateFormatOptions.locale` in `core/datetime`.
  */
-declare function formatMoney(amount: number, currency?: string, fractionDigits?: number): string;
+declare function formatMoney(amount: number, currency?: string, fractionDigits?: number, locale?: string): string;
 /**
  * How many decimal places a currency has — 2 for USD/EUR, 0 for JPY/KRW/VND,
  * 3 for KWD/BHD/JOD.
@@ -2167,8 +2266,8 @@ declare function currencyExponent(currency?: string): number;
  */
 declare function fromMinorUnits(minor: number, currency?: string): number;
 /** "$90" / "¥9,000" — a minor-unit integer rendered for display. */
-declare function formatMinor(minor: number, currency?: string): string;
+declare function formatMinor(minor: number, currency?: string, locale?: string): string;
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { AccessibilityType, type AvailabilityRule, BoothObject, CURRENCY_CHOICES, CategoryTier, ChartDoc, ChartObject, DEFAULT_CURRENCY, type Dict, type ExpandChartOptions, ExpandedSeat, Floor, GAAreaObject, GAInventorySegment, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LabelStyle, type Locale, LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerSeat, type PickerStatusChange, type PickerTransport, Point, RENDERED_QUALITY_REPORT_VERSION, RectTableSeatCounts, RectTableSide, type RenderedEvidenceState, RenderedFreeTextEvidence, type RenderedQualityFinding, type RenderedQualityFindingCode, type RenderedQualityReport, type RenderedQualitySample, RendererCallbacks, RendererOptions, RendererQualityEvidence, RendererViewMode, RowObject, type RowSeatSlot, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatOverride, SeatStatus, SeatViewMetadata, SeatmapRenderer, type SectionCategory, type SectionNode, SectionObject, type SectionSummary, TIER_HEIGHT_M, TableObject, type TableSeatSlot, type TableSelectionDetails, UNGROUPED_ID, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencyExponent, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMinor, formatMoney, fromMinorUnits, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, validGAInventorySegments };
+export { AccessibilityType, type AvailabilityRule, BoothObject, CURRENCY_CHOICES, CategoryTier, ChartDoc, ChartObject, DEFAULT_CURRENCY, type Dict, type ExpandChartOptions, ExpandedSeat, Floor, GAAreaObject, GAInventorySegment, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LabelStyle, type Locale, LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerRenderPerformanceProfile, type PickerSeat, PickerSelectionError, type PickerStatusChange, type PickerTransport, Point, RENDERED_QUALITY_REPORT_VERSION, RectTableSeatCounts, RectTableSide, type RenderedEvidenceState, RenderedFreeTextEvidence, type RenderedQualityFinding, type RenderedQualityFindingCode, type RenderedQualityReport, type RenderedQualitySample, RendererCallbacks, RendererMinimapSnapshot, RendererOptions, RendererQualityEvidence, RendererViewMode, RowObject, type RowSeatSlot, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatOverride, SeatStatus, SeatViewMetadata, SeatmapRenderer, type SectionCategory, type SectionNode, SectionObject, type SectionSummary, TIER_HEIGHT_M, TableObject, type TableSeatSlot, type TableSelectionDetails, UNGROUPED_ID, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencyExponent, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorOverviewTranslations, floorsOf, formatDate, formatMinor, formatMoney, fromMinorUnits, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, layoutFloorOverview, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, translateObject, validGAInventorySegments };