@seatlayer/core 0.78.0 → 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-OzEvBirS.cjs';
-import { c as TicketSelectionIssue } from './ticketRestrictions-CGD-l3if.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-CGD-l3if.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-rc4xZnIy.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-DW7ejcxk.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-DW7ejcxk.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.
@@ -2007,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;
@@ -2031,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). */
@@ -2043,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. */
@@ -2056,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.
@@ -2072,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;
@@ -2137,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;
     /**
@@ -2205,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
@@ -2273,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).
@@ -2283,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. */
@@ -2464,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;
@@ -2481,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. */
@@ -2498,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.
      *
@@ -2515,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.
      *
@@ -2538,10 +2576,10 @@ declare class PickerController {
     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.
      *

package/dist/index.d.ts

@@ -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.js';
-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.js';
-import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-71rHjKl7.js';
-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-71rHjKl7.js';
-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-uVEPXCUD.js';
-import { c as TicketSelectionIssue } from './ticketRestrictions-BH430to6.js';
-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-BH430to6.js';
-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-F6wMlVqx.js';
-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-CXWlCsRS.js';
-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-Cqd5w55S.js';
-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-Cqd5w55S.js';
-import './segmentedRowModel-D-CEgxg7.js';
+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.js';
+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.js';
+import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-DhGEe6fT.js';
+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-DhGEe6fT.js';
+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-Dr-ksQTq.js';
+import { f as TicketSelectionIssue, b as GroupedTableInventoryUnit } from './ticketRestrictions-7HrT6IQM.js';
+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-7HrT6IQM.js';
+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-Du9QkrCf.js';
+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-C4-5Oy6-.js';
+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-Bx0ucRf6.js';
+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-Bx0ucRf6.js';
+import './segmentedRowModel-N9Z0rnKY.js';
 
 /**
  * Half-width of the band around a legibility threshold, in rendered pixels.
@@ -2007,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;
@@ -2031,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). */
@@ -2043,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. */
@@ -2056,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.
@@ -2072,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;
@@ -2137,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;
     /**
@@ -2205,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
@@ -2273,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).
@@ -2283,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. */
@@ -2464,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;
@@ -2481,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. */
@@ -2498,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.
      *
@@ -2515,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.
      *
@@ -2538,10 +2576,10 @@ declare class PickerController {
     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.
      *