@seatlayer/core 0.77.2 → 0.79.0

package/dist/index.d.cts

@@ -1,15 +1,15 @@
-import { C as ChartDoc, F as FloorLabelStyle, P as Point, A as AccessibilityType, i as CategoryTier, S as SeatCommercialAttributes, w as ChartDeliveryPerformance } from './types-Dq-ipTBG.cjs';
-export { x as ACCESSIBILITY_RING_COLOR, y as ACCESSIBILITY_TYPES, z as AccessibilityMeta, D as AuthoringObjectState, B as BoothObject, p as Category, E as ChartLayoutConstraint, a as ChartObject, o as ChartReferenceImage, H as ChartTheme, I as ConfidenceEvidenceScope, u as CubicPath, J as DecorImageObject, m as Floor, G as GAAreaObject, h as GAInventorySegment, K as LABEL_STYLE_MAX_SIZE, M as LABEL_STYLE_MIN_SIZE, N as LabelPresentation, L as LabelStyle, O as ObjectEditorState, Q as Physical3dEvidence, U as RadialClearanceLayoutConstraint, n as RectTableSeatCounts, l as RectTableSide, V as ReferenceAccessibilitySource, W as ReferenceCalibration, X as ReferenceCategorySource, Y as ReferenceDerivedScale, Z as ReferenceDirectAnnotationSource, _ as ReferenceDirectLandmarkCandidate, $ as ReferenceDirectLandmarkDisposition, a0 as ReferenceDirectLandmarkRole, a1 as ReferenceDirectLandmarkSource, a2 as ReferenceDirectSeatGroup, a3 as ReferenceDirectSeatImportSource, a4 as ReferenceDirectSeatPlan, a5 as ReferenceDirectStageSource, a6 as ReferenceEnrichmentStatus, a7 as ReferenceExtractEmptyReason, a8 as ReferenceExtractEnrichment, a9 as ReferenceExtractInput, aa as ReferenceExtractProposal, ab as ReferenceExtractRegionSeats, ac as ReferenceInventoryExclusionSource, ad as ReferenceInventorySource, ae as ReferenceMatchReport, af as ReferenceScanProposal, ag as ReferenceScanRowProposal, ah as ReferenceScanSectionProposal, ai as ReferenceSeatSeed, aj as ReferenceSectionTraceBatchInput, ak as ReferenceSectionTraceBatchProposal, al as ReferenceSectionTraceInput, am as ReferenceSectionTraceProposal, c as ResolvedSeatConfidenceEvidence, R as RowObject, an as SEAT_COMMERCIAL_MARKS, ao as STAGE_LABEL_STYLE_MAX_SIZE, ap as SURROUNDINGS_SHAPE_ROLES, aq as SeatCommercialMark, ar as SeatCommercialMeta, as as SeatConfidenceCoverage, at as SeatConfidenceEvidence, au as SeatConfidenceModelLevel, av as SeatConfidenceModeledTarget, aw as SeatConfidenceRealityLevel, d as SeatGlyphKind, k as SeatOverride, e as SeatViewCoverage, b as SeatViewMetadata, ax as SeatViewVariant, j as SectionObject, f as SectionOutlinePath, g as SectionPathSegment, ay as SelectionLayer, q as ShapeLineCap, r as ShapeLineEnding, s as ShapeLineJoin, t as ShapeObject, az as StageLabelStyle, T as TableObject, aA as TextAlignment, aB as TextBackground, v as TextObject, aC as TicketTierApplicability, aD as TicketTierEvidence, aE as TicketTierRestriction, aF as Venue3DMaterialPalette, aG as VenueSurveyRegistrationEvidence, aH as ZoneDef, aI as accessibilityMeta, aJ as accessibilityRingColor, aK as layerOf, aL as seatCommercialMeta } from './types-Dq-ipTBG.cjs';
-import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-vOMFVz7c.cjs';
-export { d as EVENT_CONFIGURATION_EXPORT_SCHEMA, e as EVENT_CONFIGURATION_SCHEMA, f as EventConfigurationBaseVenue, g as EventConfigurationCompatibilityIssue, h as EventConfigurationCompatibilityIssueCode, i as EventConfigurationCompatibilityResult, j as EventConfigurationExportEnvelope, k as EventConfigurationLifecycleStatus, a as EventConfigurationOcclusion, l as EventConfigurationOverlay, m as EventConfigurationParseIssue, n as EventConfigurationParseIssueCode, o as EventConfigurationParseResult, p as EventConfigurationProductionElement, E as EventConfigurationProductionElementKind, q as EventConfigurationVenueSnapshot, r as EventConfigurationVersionParseResult, s as EventConfigurationVersionSummary, L as LegacyEventConfigurationMigrationResult, t as canTransitionEventConfiguration, u as canonicalEventConfigurationJson, v as inspectEventConfigurationCompatibility, w as migrateLegacyEventConfigurations, x as parseEventConfigurationExport, y as parseEventConfigurationVersion, z as resolveEventConfigurationRollback } from './eventConfigurations-vOMFVz7c.cjs';
-export { A as AUTOMATIC_ROUND_TABLE_RADIUS_MAX, a as AUTOMATIC_ROUND_TABLE_RADIUS_MIN, C as ChartBoundsOptions, E as ExpandChartOptions, F as FLOOR_STACK_GAP_RATIO, b as FLOOR_STACK_MIN_SURFACE_PX, c as FloorStackOptions, d as FloorStackPlacement, R as RowSeatSlot, T as TABLE_SEAT_OFFSET, e as TableSeatSlot, f as allObjects, g as automaticRoundTableRadius, h as chartBounds, i as expandBooth, j as expandChart, k as expandRow, l as expandRowSlots, m as expandTable, n as expandTableSlots, o as floorObjects, p as floorStackPlacements, q as floorsOf, r as initialFloorMode, s as layoutFloorStack, t as mainFloorId, u as objectCenter, v as owningSectionForObject, w as pointInPolygon, x as pointInPolygonWithHoles, y as polygonLabelPoint, z as rowInventoryCount, B as rowSeatPositions, D as stackFloors, G as tableInventoryCount, H as tableSeatCountsBySide, I as translateObject } from './tableSizing-DKygWd7z.cjs';
-import { c as TicketSelectionIssue } from './ticketRestrictions-CvGDnGS8.cjs';
-export { M as MAX_EVENT_INVENTORY, a as MAX_GA_CAPACITY, g as gaAreasOf, h as gaInventorySegments, i as gaUnitLabel, j as gaUnitLabels, k as growJoinedGAInventory, l as isGaUnitLabel, v as validGAInventorySegments } from './ticketRestrictions-CvGDnGS8.cjs';
-export { A as AvailabilityRule, S as SectionNode, T as TIER_HEIGHT_M, U as UNGROUPED_ID, a as applyHidden, c as computeSections, h as hiddenObjectIds, i as isSectionHidden, s as sectionGeometry } from './sections-CQ0sd37E.cjs';
-export { M as MIN_POINTER_TARGET_PX, R as RENDERED_QUALITY_REPORT_VERSION, a as RenderedEvidenceState, b as RenderedQualityFinding, c as RenderedQualityFindingCode, d as RenderedQualityReport, e as RenderedQualitySample, i as inspectRenderedQualityEvidence } from './renderedQuality-CRLkEGf8.cjs';
-import { I as ISeatmapRenderer, b as RendererOptions, S as SeatStatus, c as SeatMark, E as ExpandedSeat, G as GAAreaState, d as RendererViewMode, e as RendererMinimapSnapshot, L as LodRung, R as RendererQualityEvidence, f as RendererCallbacks } from './renderer-B6kkgOHz.cjs';
-export { C as CHART_STORAGE_KEY, g as RenderedBookableLabelEvidence, a as RenderedFreeTextEvidence, h as RenderedGAAreaEvidence, i as RenderedHierarchyLabelEvidence, j as RenderedLabelHiddenReason, k as RenderedRowLabelEvidence, l as RendererHoverDetails, m as RendererMinimapSeat, n as RendererMinimapSection, o as SeatMarkKind } from './renderer-B6kkgOHz.cjs';
-import './segmentedRowModel-DqFhb-7Q.cjs';
+import { C as ChartDoc, F as FloorLabelStyle, P as Point, A as AccessibilityType, j as CategoryTier, S as SeatCommercialAttributes, w as ChartDeliveryPerformance } from './types-eVmh2-Yn.cjs';
+export { x as ACCESSIBILITY_RING_COLOR, y as ACCESSIBILITY_TYPES, z as AccessibilityMeta, D as AuthoringObjectState, B as BoothObject, p as Category, E as ChartLayoutConstraint, a as ChartObject, o as ChartReferenceImage, H as ChartTheme, I as ConfidenceEvidenceScope, u as CubicPath, J as DecorImageObject, m as Floor, G as GAAreaObject, i as GAInventorySegment, K as LABEL_STYLE_MAX_SIZE, M as LABEL_STYLE_MIN_SIZE, N as LabelPresentation, L as LabelStyle, O as ObjectEditorState, Q as Physical3dEvidence, U as RadialClearanceLayoutConstraint, n as RectTableSeatCounts, l as RectTableSide, V as ReferenceAccessibilitySource, W as ReferenceCalibration, X as ReferenceCategorySource, Y as ReferenceDerivedScale, Z as ReferenceDirectAnnotationSource, _ as ReferenceDirectLandmarkCandidate, $ as ReferenceDirectLandmarkDisposition, a0 as ReferenceDirectLandmarkRole, a1 as ReferenceDirectLandmarkSource, a2 as ReferenceDirectSeatGroup, a3 as ReferenceDirectSeatImportSource, a4 as ReferenceDirectSeatPlan, a5 as ReferenceDirectStageSource, a6 as ReferenceEnrichmentStatus, a7 as ReferenceExtractEmptyReason, a8 as ReferenceExtractEnrichment, a9 as ReferenceExtractInput, aa as ReferenceExtractProposal, ab as ReferenceExtractRegionSeats, ac as ReferenceInventoryExclusionSource, ad as ReferenceInventorySource, ae as ReferenceMatchReport, af as ReferenceScanProposal, ag as ReferenceScanRowProposal, ah as ReferenceScanSectionProposal, ai as ReferenceSeatSeed, aj as ReferenceSectionTraceBatchInput, ak as ReferenceSectionTraceBatchProposal, al as ReferenceSectionTraceInput, am as ReferenceSectionTraceProposal, c as ResolvedSeatConfidenceEvidence, R as RowObject, an as SEAT_COMMERCIAL_MARKS, ao as STAGE_LABEL_STYLE_MAX_SIZE, ap as SURROUNDINGS_SHAPE_ROLES, aq as SeatCommercialMark, ar as SeatCommercialMeta, as as SeatConfidenceCoverage, at as SeatConfidenceEvidence, au as SeatConfidenceModelLevel, av as SeatConfidenceModeledTarget, aw as SeatConfidenceRealityLevel, d as SeatGlyphKind, k as SeatOverride, e as SeatViewCoverage, b as SeatViewMetadata, ax as SeatViewVariant, h as SectionObject, f as SectionOutlinePath, g as SectionPathSegment, ay as SelectionLayer, q as ShapeLineCap, r as ShapeLineEnding, s as ShapeLineJoin, t as ShapeObject, az as StageLabelStyle, T as TableObject, aA as TextAlignment, aB as TextBackground, v as TextObject, aC as TicketTierApplicability, aD as TicketTierEvidence, aE as TicketTierRestriction, aF as Venue3DMaterialPalette, aG as VenueSurveyRegistrationEvidence, aH as ZoneDef, aI as accessibilityMeta, aJ as accessibilityRingColor, aK as layerOf, aL as seatCommercialMeta } from './types-eVmh2-Yn.cjs';
+import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-OVlni2ym.cjs';
+export { d as EVENT_CONFIGURATION_EXPORT_SCHEMA, e as EVENT_CONFIGURATION_SCHEMA, f as EventConfigurationBaseVenue, g as EventConfigurationCompatibilityIssue, h as EventConfigurationCompatibilityIssueCode, i as EventConfigurationCompatibilityResult, j as EventConfigurationExportEnvelope, k as EventConfigurationLifecycleStatus, a as EventConfigurationOcclusion, l as EventConfigurationOverlay, m as EventConfigurationParseIssue, n as EventConfigurationParseIssueCode, o as EventConfigurationParseResult, p as EventConfigurationProductionElement, E as EventConfigurationProductionElementKind, q as EventConfigurationVenueSnapshot, r as EventConfigurationVersionParseResult, s as EventConfigurationVersionSummary, L as LegacyEventConfigurationMigrationResult, t as canTransitionEventConfiguration, u as canonicalEventConfigurationJson, v as inspectEventConfigurationCompatibility, w as migrateLegacyEventConfigurations, x as parseEventConfigurationExport, y as parseEventConfigurationVersion, z as resolveEventConfigurationRollback } from './eventConfigurations-OVlni2ym.cjs';
+export { A as AUTOMATIC_ROUND_TABLE_RADIUS_MAX, a as AUTOMATIC_ROUND_TABLE_RADIUS_MIN, C as ChartBoundsOptions, E as ExpandChartOptions, F as FLOOR_STACK_GAP_RATIO, b as FLOOR_STACK_MIN_SURFACE_PX, c as FloorStackOptions, d as FloorStackPlacement, R as RowSeatSlot, T as TABLE_SEAT_OFFSET, e as TableSeatSlot, f as allObjects, g as automaticRoundTableRadius, h as chartBounds, i as expandBooth, j as expandChart, k as expandRow, l as expandRowSlots, m as expandTable, n as expandTableSlots, o as floorObjects, p as floorStackPlacements, q as floorsOf, r as initialFloorMode, s as layoutFloorStack, t as mainFloorId, u as objectCenter, v as owningSectionForObject, w as pointInPolygon, x as pointInPolygonWithHoles, y as polygonLabelPoint, z as rowInventoryCount, B as rowSeatPositions, D as stackFloors, G as tableInventoryCount, H as tableSeatCountsBySide, I as translateObject } from './tableSizing-tDaLWj54.cjs';
+import { f as TicketSelectionIssue, b as GroupedTableInventoryUnit } from './ticketRestrictions-B4eT6vEy.cjs';
+export { M as MAX_EVENT_INVENTORY, d as MAX_GA_CAPACITY, j as gaAreasOf, k as gaInventorySegments, l as gaUnitLabel, m as gaUnitLabels, o as growJoinedGAInventory, p as isGaUnitLabel, v as validGAInventorySegments } from './ticketRestrictions-B4eT6vEy.cjs';
+export { A as AvailabilityRule, S as SectionNode, T as TIER_HEIGHT_M, U as UNGROUPED_ID, a as applyHidden, c as computeSections, h as hiddenObjectIds, i as isSectionHidden, s as sectionGeometry } from './sections-DUG5M-hF.cjs';
+export { M as MIN_POINTER_TARGET_PX, R as RENDERED_QUALITY_REPORT_VERSION, a as RenderedEvidenceState, b as RenderedQualityFinding, c as RenderedQualityFindingCode, d as RenderedQualityReport, e as RenderedQualitySample, i as inspectRenderedQualityEvidence } from './renderedQuality-CHAf5J4i.cjs';
+import { I as ISeatmapRenderer, b as RendererOptions, S as SeatStatus, c as SeatMark, E as ExpandedSeat, G as GAAreaState, d as RendererViewMode, e as RendererMinimapSnapshot, L as LodRung, R as RendererQualityEvidence, f as RendererCallbacks } from './renderer-CuLIU7z1.cjs';
+export { C as CHART_STORAGE_KEY, g as RenderedBookableLabelEvidence, a as RenderedFreeTextEvidence, h as RenderedGAAreaEvidence, i as RenderedHierarchyLabelEvidence, j as RenderedLabelHiddenReason, k as RenderedRowLabelEvidence, l as RendererHoverDetails, m as RendererMinimapSeat, n as RendererMinimapSection, o as SeatMarkKind } from './renderer-CuLIU7z1.cjs';
+import './segmentedRowModel-BYSxfsqX.cjs';
 
 /**
  * Half-width of the band around a legibility threshold, in rendered pixels.
@@ -273,6 +273,11 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Non-listening visual dim outside the focused section. One overlay replaces
      *  descendant opacity mutations across every seat in the venue. */
     private focusDimOverlay;
+    /** Does entering a section draw the entrance dim + backdrop? Off for narrow
+     *  (phone) layouts — see {@link setSectionFocusDim}. */
+    private sectionFocusDim;
+    /** How many camera moves the BUYER has made — see {@link getCameraGestureCount}. */
+    private cameraGestures;
     /** Object id → floor id (multi-floor only) — resolves a deck tap in the 3D stack. */
     private objectFloor;
     /** Seats with no owning section, computed once per chart — see
@@ -890,6 +895,28 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * behaviour, the glide is only an entrance.
      */
     private releaseSectionFocusDim;
+    /**
+     * Take the entrance dim + backdrop down, leaving every other part of the
+     * focus (id, anchor, LOD, camera) alone. Shared by the buyer's first pan and
+     * by {@link setSectionFocusDim} switching the treatment off mid-focus.
+     */
+    private dropFocusDim;
+    /**
+     * Should entering a section dim the rest of the venue?
+     *
+     * On a desktop map the entrance dim says "this is the section you are in"
+     * against a bowl that is still mostly on screen. On a phone the focused
+     * section fills the viewport, so the same treatment only blackens the strip
+     * of edges around it — cost without the message (client report, narrow
+     * layout). The picker turns it off for `data-layout="narrow"` and back on
+     * for wide.
+     *
+     * Everything else about a focus is untouched: focusedSectionId, focusAnchor,
+     * the LOD pass and the camera glide are the same either way, and
+     * `focusedSeatOpacity` is already gated on the overlay existing, so seats and
+     * their labels simply stay at full brightness.
+     */
+    setSectionFocusDim(enabled: boolean): void;
     /** Clear an AXS section focus — restore full-bowl brightness + drop the backdrop. */
     clearSectionFocus(): void;
     /** The currently AXS-focused section id, or null. */
@@ -938,6 +965,33 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** 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;
+    /**
+     * Pan by a screen-space delta — zoom untouched, nothing reframed.
+     *
+     * `panToWorld` centres a point, which is the wrong instrument when only ONE
+     * axis matters: the phone confirm card is a resting bottom sheet, and a seat
+     * tapped under it has to be lifted into the clear band above the sheet with
+     * its x exactly where the buyer left it. Centring would slide the map
+     * sideways as well, which reads as the map running away from the tap.
+     *
+     * Animated by default with the camera glide's own easing, so the lift is
+     * read as the map moving rather than as a cut; `animate: false` and reduced
+     * motion both snap.
+     */
+    panScreenBy(delta: Point, opts?: {
+        animate?: boolean;
+    }): void;
+    /**
+     * How many camera moves the buyer has made with their own hands — a drag, a
+     * pinch or a wheel. Monotonic, and it counts GESTURES, not frames: one drag
+     * of any length is one.
+     *
+     * For a host that moved the camera itself and wants to put it back only if
+     * the buyer has not since taken over. Comparing camera positions cannot
+     * answer that — a programmatic glide is still in flight, and a pan that ends
+     * where it started is indistinguishable from no pan at all.
+     */
+    getCameraGestureCount(): number;
     /** Legend hover: highlight one category (dim the rest), or null to clear. */
     setCategoryHighlight(key: string | null): void;
     private renderBackground;
@@ -1953,17 +2007,57 @@ interface PickerAccessNeed {
  */
 declare function accessNeedsFor(seats: Iterable<ExpandedSeat>, statusOf: (seatId: string) => string): PickerAccessNeed[];
 
+/**
+ * WHICH ANSWER ABOUT THE SEAT MAP IS THE YOUNGER ONE.
+ *
+ * The picker's open path runs its reads concurrently: the chart, the compact
+ * inventory snapshot and the live socket all start together, so a buyer sees a
+ * correct map at `max(reads) + parse` instead of at the sum of them. What that
+ * buys in latency it costs in ordering, because three things can now happen
+ * that a strictly serial boot made impossible:
+ *
+ *  1. An authoritative snapshot arrives BEFORE the chart does. The renderer
+ *     holds no seats yet, so painting is not an option — but dropping it is
+ *     worse, because the next authoritative answer may be seconds away.
+ *  2. A live socket frame overtakes an HTTP body that was already in flight.
+ *     The body then lands LAST while describing an EARLIER instant, and
+ *     applying it un-sells seats the buyer has already been shown as gone.
+ *  3. Both a buffered snapshot and the boot read are waiting when the chart
+ *     finally lands, and exactly one of them has to paint first.
+ *
+ * All three are the same question — which of two answers is younger — so it is
+ * answered once, here, rather than three times inside PickerController where
+ * each answer would be a different `if`. Kept pure (plain records, no renderer,
+ * no controller) for the same reason ./availabilityRefresh is: the rule has to
+ * be readable and testable on its own, and both buyer surfaces reconcile
+ * through it rather than drifting into two orderings.
+ *
+ * The rule itself is one sentence: **a live frame is always younger than an
+ * HTTP body it raced.** The socket does not answer questions, it announces
+ * changes, so its frame describes the state at the moment it was sent; an HTTP
+ * snapshot describes the state at the moment the SERVER read it, which is
+ * necessarily before the response arrived. Where the two disagree, the socket
+ * is the later truth. Where they agree, the ordering is invisible.
+ */
+/**
+ * Where an authoritative seat map came from.
+ *
+ * The distinction exists only to order two answers about the same instant.
+ * Nothing downstream renders differently because of it.
+ */
+type SnapshotSource = 'http' | 'socket';
+
 declare class PickerController {
-    private readonly opts;
-    private readonly api;
-    private readonly key;
+    /** @internal */ readonly opts: PickerOptions;
+    /** @internal */ readonly api: PickerTransport;
+    /** @internal */ readonly key: string;
     private maxSelection;
     private readonly numberOfPlacesToSelect;
     private readonly selectionValidators;
     private selectableObjectRefs;
     private selectableSeatIds;
     private lastSelectionValidity;
-    private renderer;
+    /** @internal */ renderer: ISeatmapRenderer | null;
     /** Host-tracked pending GA quantity per area id (the widget cart's chips). */
     private gaSelected;
     private _doc;
@@ -1977,7 +2071,7 @@ declare class PickerController {
     private closedSections;
     /** label ⇄ id maps — backend speaks labels, the engine speaks ids. */
     private labelToId;
-    private labelToSeat;
+    /** @internal */ labelToSeat: Map<string, ExpandedSeat>;
     /** One canonical expansion for buyer-model consumers outside this controller. */
     private expandedSeats;
     /** seatId → chosen ticket-tier id (absent ⇒ the category's first/default tier). */
@@ -1989,11 +2083,11 @@ declare class PickerController {
     private allIds;
     /** Model-2 tables are one booking unit whose chairs remain renderer geometry. */
     private groupedTablesByObject;
-    private groupedTablesByLabel;
+    /** @internal */ groupedTablesByLabel: Map<string, GroupedTableInventoryUnit>;
     private groupedTableBySeatId;
-    private tableQuantities;
+    /** @internal */ tableQuantities: Map<string, number>;
     /** Variable quantity is a buyer contract, never an inferred default. */
-    private confirmedVariableTables;
+    /** @internal */ confirmedVariableTables: Set<string>;
     private groupedSelectionOverhead;
     private ws;
     /** Standby snapshot pull for a socket that connected and then said nothing. */
@@ -2002,10 +2096,10 @@ declare class PickerController {
     private realtime;
     private reconnectTimer;
     private attempt;
-    private closed;
+    /** @internal */ closed: boolean;
     /** Detach for the tab-regain catch-up listener; null when not attached. */
     private detachVisibility;
-    private hold_;
+    /** @internal */ hold_: HoldInfo | null;
     private liveStatuses;
     /**
      * What a label absent from `liveStatuses` is.
@@ -2018,7 +2112,7 @@ declare class PickerController {
      */
     private liveDefault;
     private currency;
-    private expiryTimer;
+    /** @internal */ expiryTimer: ReturnType<typeof setTimeout> | null;
     private readonly snapshots;
     constructor(options: PickerOptions);
     get doc(): ChartDoc | null;
@@ -2083,7 +2177,7 @@ declare class PickerController {
     loadEventConfiguration(): Promise<EventConfigurationVersion | null>;
     idForLabel(label: string): string | undefined;
     private idsForLabel;
-    private idsForLabels;
+    /** @internal */ idsForLabels(labels: Iterable<string>): string[];
     /** Resolve a physical chair id (or table inventory label) to its table unit. */
     tableSelection(seatIdOrLabel: string): TableSelectionDetails | null;
     /**
@@ -2151,8 +2245,10 @@ declare class PickerController {
     private handleRendererSelect;
     private handleRendererDeselect;
     private resetUnheldTableQuantities;
-    private resetTableQuantitiesForLabels;
-    private tableQuantityRequest;
+    /** @internal */ resetTableQuantitiesForLabels(labels: Iterable<string>): void;
+    /** @internal */ tableQuantityRequest(seat: PickerSeat | null): {
+        quantity?: number;
+    };
     /**
      * Hold the current selection (or a given label set). The controller does the
      * renderer/hold side (409 → deselect + repaint the taken seats held) and then
@@ -2219,9 +2315,7 @@ declare class PickerController {
         ttlMs?: number;
     }): Promise<HoldInfo | null>;
     /**
-     * Complete a booking. Requires a transport that supports book() (the SDK
-     * deliberately does not). `bookingRef` MUST be a real reference from the caller.
-     * `labelsArg` lets the caller book its own cart (the live page's confirm-flow
+     * Book the held seats. `labelsArg` names what to book (the SDK/hosted
      * cart can hold best-available seats that aren't in the renderer selection);
      * defaults to the renderer selection. Reuses an existing exact-match hold, else
      * holds first. Returns the labels booked, or null on failure (conflicts painted).
@@ -2229,15 +2323,11 @@ declare class PickerController {
      * seats sit held for the host's window rather than the longer server default.
      */
     book(bookingRef: string, labelsArg?: string[], ttlMs?: number): Promise<string[] | null>;
-    /** Release the whole open hold (if any), repaint those seats free. */
+    /** Release the whole open hold. */
     release(): Promise<boolean>;
-    /**
-     * Release just some labels from the open hold, keeping the rest held (used when
-     * a buyer removes one seat chip). Clears the hold entirely once it empties.
-     */
+    /** Release named labels from the open hold, keeping the rest of it alive. */
     releaseLabels(labels: string[]): Promise<boolean>;
-    /** New transports return the exact labels released; tolerate older adapters. */
-    private releaseConfirmed;
+    /** @internal */ releaseConfirmed(result: unknown, requested: string[]): boolean;
     setStatus(ids: string[], status: SeatStatus): void;
     getStatus(id: string): SeatStatus | undefined;
     /** Seat ids whose category the author marked not-for-sale. */
@@ -2291,6 +2381,9 @@ declare class PickerController {
     getAccessibilityFilter(): AccessibilityType[] | null;
     /** Where {@link focusNextAccessibleSection} last stopped. */
     private accessStepAt;
+    /** The camera a price band took from the buyer — see
+     *  {@link PickerFocusContext.bandReturnPose}. */
+    private bandReturnPose;
     /**
      * The state the filter-driven camera rules read and change — see
      * ./pickerFocus. Rebuilt per call; the accessor pair keeps the controller
@@ -2407,7 +2500,7 @@ declare class PickerController {
     private sectionSummary;
     private clearConnectFallback;
     destroy(): void;
-    private toSeat;
+    /** @internal */ toSeat(s: ExpandedSeat): PickerSeat;
     private toTableSeat;
     private describeSeat;
     private priceFor;
@@ -2424,8 +2517,8 @@ declare class PickerController {
      */
     setSeatTier(seatId: string, tierId: string | null): void;
     /** PickerSeats (with chosen tier) for a set of held labels. */
-    private seatsForLabels;
-    private emitSelectionChange;
+    /** @internal */ seatsForLabels(labels: string[]): PickerSeat[];
+    /** @internal */ emitSelectionChange(): void;
     private emitSelectionValidity;
     /** Check explicit tier applicability and companion relationships for the
      * current (or supplied) seats. Ticket display names are never semantic input. */
@@ -2441,13 +2534,15 @@ declare class PickerController {
     private emitOrphanHint;
     /** Toggle colorblind-safe rendering at runtime (see PickerOptions.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
-    private emitError;
-    private holdCovers;
-    private handle409Conflicts;
-    /** Set the open hold + (re)arm the server-authoritative expiry timer. */
-    private setHold;
-    private clearHold;
-    private expireActiveHold;
+    /** @internal */ emitError(err: unknown): void;
+    /** @internal */ holdCovers(labels: string[]): boolean;
+    /** 409 conflict → deselect the taken labels and repaint them held. */
+    /** @internal */ handle409Conflicts(err: unknown): void;
+    /** @internal */ setHold(hold: Omit<HoldInfo, 'seats'> & {
+        seats?: PickerSeat[];
+    }, source?: 'created' | 'restored'): void;
+    /** @internal */ clearHold(): void;
+    /** @internal */ expireActiveHold(): Promise<void>;
     /**
      * Repaint from an authoritative map of unit statuses.
      *
@@ -2458,7 +2553,7 @@ declare class PickerController {
      * `free` would paint a sold-out stadium as fully available, so the default is
      * a parameter rather than a constant.
      */
-    private applySeatsMap;
+    /** @internal */ applySeatsMap(seats: Record<string, string>, defaultStatus?: string, source?: SnapshotSource): void;
     /**
      * When an authoritative map was last painted, and whether one is recent.
      *
@@ -2469,12 +2564,49 @@ declare class PickerController {
      * any window in which a silent server could leave the map wrong.
      */
     private lastSnapshotAt;
+    /**
+     * Has `renderer.setChart()` run? `this.renderer` is NOT that answer — it is
+     * assigned the moment the stage is created, which is before the chart fetch
+     * is awaited, so a snapshot can reach a renderer that holds no seats.
+     */
+    private seatsBuilt;
+    /** The authoritative map that arrived before the chart. See ./snapshotOrdering. */
+    private pendingSnapshot;
+    /** Bumped by every LIVE frame applied here. See ./snapshotOrdering. */
+    private socketVersion;
     private snapshotIsFresh;
     /** The live status of one unit, honouring the projection's default. */
-    private statusOf;
+    /** @internal */ statusOf(label: string): string;
     private clearBookedHoldIfSettled;
     /** Repaint from truth. Coalesced — see snapshotCoalescer.ts. */
-    private resnapshot;
+    /** @internal */ resnapshot(force?: boolean): Promise<void>;
+    /**
+     * Repaint from truth on a realtime client's behalf — coalesced, never forced.
+     *
+     * The public entry point for a transport-owned socket (the widget's
+     * `BuyerRealtimeClient` and its `createControllerSink`). It used to reach for
+     * `refresh()`, which is the FORCED read, so every connect and every section
+     * frame bypassed the coalescer and issued its own `/objects?compact=1` —
+     * two full snapshots per open on the measured DesiPass boot.
+     *
+     * A socket opening is not evidence that anything changed, so a boot snapshot
+     * this young answers for it. `refresh()` stays the forced call for a caller
+     * that just mutated state and needs the server's answer to its own write.
+     */
+    resync(opts?: {
+        reason?: 'connect' | 'frame';
+    }): Promise<void>;
+    /**
+     * Paint a COMPLETE authoritative projection handed over by a live socket.
+     *
+     * The frame the server volunteers on connect already contains everything an
+     * `/objects` read would return, so a sink that can take it never needs the
+     * round trip. Public because the widget's socket lives outside this class.
+     */
+    applyProjection(projection: {
+        default: string;
+        exceptions: Record<string, string>;
+    }): void;
     /**
      * Re-pull the status snapshot on demand. Live surfaces rarely need this (the
      * socket keeps them fresh); local/mock transports with no socket call it