@seatlayer/core 0.78.0 → 0.80.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-DnSAiaXL.cjs';
+import { g as TicketSelectionIssue, b as GroupedTableInventoryUnit } from './ticketRestrictions-CvaHRHti.cjs';
+export { M as MAX_EVENT_INVENTORY, d as MAX_GA_CAPACITY, l as gaAreasOf, m as gaInventorySegments, n as gaUnitLabel, o as gaUnitLabels, q as growJoinedGAInventory, s as isGaUnitLabel, x as validGAInventorySegments } from './ticketRestrictions-CvaHRHti.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-Dz-WTrRc.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-BjuHQ0bx.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-BjuHQ0bx.cjs';
+import './segmentedRowModel-BYSxfsqX.cjs';
 
 /**
  * Half-width of the band around a legibility threshold, in rendered pixels.
@@ -210,9 +210,13 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private ownedCache;
     /** The pressable "your seats are in here" marks below the seats rung. */
     private beaconsCache;
+    /** Desktop hover card — see render/hoverCard. Mouse only; built on attach. */
+    private hoverCardCache;
     /** Held by this picker instance, not by another buyer. */
     private ownedHold;
     private seatMarks;
+    /** Built on first paint and kept for the renderer's life — see seatPaintContext. */
+    private seatPaintCache;
     /** One selected seat being inspected before it is committed to the cart. */
     private selectionFocusId;
     /** Seats that keep full ink while the confirm card is open — see
@@ -347,10 +351,7 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private cached;
     private dpr;
     /** Current chart's buyer-visible image work. Failures are retained until ready(). */
-    private assetGeneration;
-    private assetPromises;
-    private assetErrors;
-    private assetCancels;
+    private readonly assets;
     /**
      * Progressive reveal: what a big chart does instead of appearing all at once.
      *
@@ -413,6 +414,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * frame loop.
      */
     private get breath();
+    /** The hover card. One element, reused; the camera decides what it says. */
+    private get hoverCard();
     /**
      * The selection beacons. Built on first use, like every other overlay family:
      * a map nobody has picked a seat on allocates nothing and appends no DOM.
@@ -609,7 +612,13 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private framingViewport;
     /** The visible band in world space — what "where the buyer is looking" means. */
     private framingWorldRect;
+    /** Frame the whole venue. The fit it lands on is render/camera's `fitScale`,
+     *  which every zoom bound in this renderer is read from. */
     zoomToFit(): void;
+    /** Everything render/camera reads and writes here. Built once: `focusRegion`
+     *  runs a per-frame tween, and a host per frame is a per-frame allocation. */
+    private get cameraHost();
+    private cameraHostCache;
     /**
      * Reframe after a host/layout resize without throwing away section context.
      * The stage already represents the usable map area (the picker side panel is
@@ -696,8 +705,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     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. */
     private effScale;
     /** Project a world point through the iso affine about the chart centre (→ iso-world). */
@@ -706,11 +713,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private isoInverse;
     /** Precompute the Phase-C pinhole camera and every exact seat anchor. */
     private buildPerspectiveProjection;
-    /** Apply an affine to a Konva container while keeping `pivot` fixed logically. */
-    private setContainerAffine;
-    private resetContainerTransform;
-    /** Exact raked surface height used for the bounded section tangent plane. */
-    private sectionSurfaceHeight;
     /** Desired perspective-space point for a section surface, before Stage pan/zoom. */
     private projectedSectionPoint;
     /** Shared-layer local point which the ground affine paints at `projected`. */
@@ -722,13 +724,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * the section's resolved real height in world units (Phase B1).
      */
     private isoLiftLocal;
-    /** Restore projection layers to identity (flat) — byte-for-byte the original.
-     * `seatLayer` can be skipped when entering perspective from flat: assigning a
-     * top-level transform invalidates all 14k descendant absolute transforms even
-     * while the semantic overview keeps that layer fully transparent. */
+    /** The scene-graph half of a projection change — see render/projectionApply. */
+    private get projectionHost();
+    private projectionHostCache;
     private resetLayerTransforms;
-    /** Restore section-owned containers before applying another projection. */
-    private resetSectionProjection;
     /** Node/cache context the shared seat-anchor pass reads and updates. */
     /** Cached, unlike its siblings, because it holds only stable references and
      *  no camera reading that could go stale; setChart (which reassigns `seats`)
@@ -739,18 +738,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Move native seat/booth hit shapes to or from their exact pinhole anchors. */
     private applyExactSeatAnchors;
     /**
-     * Phase C projected 2.5D. Seat/booth anchors are exact pinhole projections;
-     * section top surfaces use one explicitly bounded tangent plane per authored
-     * section. Native Konva shapes move with the anchors, so direct hit testing is
-     * the same graph that paints the buyer-visible unit.
+     * Phase C projected 2.5D, and the isometric tilt — both live in
+     * render/projectionApply, together with the resets they open with.
      */
     private applyPerspective;
-    /**
-     * Apply the current isoT to the scene: the base rotate+squash as a decomposed
-     * layer transform (so seats/décor/rings project together and Konva's own
-     * hit-testing follows), upright counter-transforms on text, and the elevation
-     * lift + extruded side faces on elevated sections.
-     */
     private applyIso;
     /** Counter-skew every visible label so it renders upright at its projected anchor. */
     private applyUprightLabels;
@@ -842,7 +833,16 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Preserve an explicit seat-number swatch exactly; only Automatic follows
      * the state-aware contrast fallback as seat paint changes. */
     private seatLabelInk;
-    /** Apply fill/stroke/opacity for a seat's current status + selection. */
+    /**
+     * The per-seat paint context. Built once and kept: `paintSeat` runs per seat
+     * per repaint — up to 53k times — so a host per call would be paid for on
+     * exactly the device that can least afford it. Every field is an accessor,
+     * because the maps and scalars behind them are replaced by `setChart` and by
+     * theme changes while this object stays.
+     */
+    private get seatPaintContext();
+    /** Apply fill/stroke/opacity for a seat's current status + selection.
+     *  The ordering of every rule that decides it lives in render/seatPaint. */
     private paintSeat;
     /** True when a seat sits in a section/zone currently marked `closed`. */
     private seatInClosedSection;
@@ -1001,7 +1001,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * turns the retained failures into one actionable error.
      */
     private trackAssetImage;
-    /** Cancel and release every image retained by the previous chart/export. */
     private cancelAssetLoads;
     /** Organizer floor-plan photo, dimmed, at the very bottom of the bg layer. */
     private renderBackgroundImage;
@@ -1095,66 +1094,33 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     private sectionBounds;
     private sectionFrameScale;
-    /**
-     * Resolve a seat tap: honour the 3D deck-drill and the AXS seat-pick gate,
-     * then toggle. The gate (§4) redirects small on-screen seats to section-focus
-     * to avoid blind mis-picks at overview scales — but ONLY when focusing would
-     * zoom the seat up to a safe size. If we're already focused on the section, or
-     * the section already fills the viewport (a narrow — OR even a wide — container
-     * frames a big section BELOW LABEL_SCALE), redirecting is a no-op that would
-     * leave the seat permanently unpickable (§5 `picking-gate-unreachable`), so we
-     * fall through and PICK. This is the invariant: seats are never unpickable.
-     */
-    private handleSeatTap;
     /** Deck under the pointer in the 3D stacked overview — see screenPicking. */
     private deckFloorAt;
     /** Nearest selectable seat within `slopPx` of a screen point, or null. */
     private nearestSeatToScreen;
     private get screenPickingHost();
     /**
-     * How strongly this seat should advertise itself under the mouse.
-     *
-     * The hover ring and the `pointer` cursor are a promise that a click does
-     * something. Offering both over a SOLD seat and only then answering "Sold" in
-     * the popover is a false affordance (owner, 2026-09-02), so:
-     *
-     * - `full`   — a click can take (or give back) this seat: ring + pointer.
-     * - `muted`  — someone else's hold. It may come back, so it stays legible as
-     *              a seat: a dimmed, dashed ring, but the default cursor.
-     * - `none`   — sold, not-for-sale, closed section, filtered out: no ring, no
-     *              pointer. The tooltip still fires, so the buyer learns why.
+     * Register the stage/seat-layer listeners. The routing they perform — and the
+     * report behind each rung of it — lives in render/interaction/stageInteraction.
      */
-    private hoverAffordance;
     private wireInteraction;
+    /** Resolve a seat tap — see render/interaction/stageInteraction. Kept as a
+     *  method because the tap ladder calls it through the host, which is the seam
+     *  the marker-tap tests spy on. */
+    private handleSeatTap;
+    private interactionHostCache;
+    private get interactionHost();
     /**
      * Min is chart-relative (never lose the room); max is absolute so seats
      * reach a readable size on any chart, however large the venue.
      */
     private zoomBounds;
-    /**
-     * Zoom so `clientPoint` (stage-relative px) stays fixed under the cursor.
-     *
-     * `settle: 'frame'` is the wheel/trackpad path. A fling delivers dozens of
-     * events between two paints and each one ran the whole `afterViewChange`
-     * cascade — retarget, cull, LOD, free text, labels — for a camera the buyer
-     * never saw. It now defers exactly the way the pinch path does: cull and draw
-     * per event (cheap, and required for a correct frame), one settle per frame,
-     * last event wins. The zoom maths and the onViewChange contract are unchanged
-     * — `scheduleViewChange` was already rAF-coalesced.
-     */
     private zoomAbout;
-    /** One `afterViewChange` per animation frame for a burst of wheel events. */
-    private scheduleZoomSettle;
     /** Drop a wheel settle that a newer, authoritative view pass supersedes. */
     private cancelZoomSettle;
-    /** Zoom + pan so world-rect `b` fills the viewport (with a small margin). */
-    private zoomToBounds;
     /**
-     * Smoothly glide the camera to frame a section (by id) or a world-space bounds
-     * rect — the Slice 5 "glide in". Pan+zoom tween over a calm easeInOutCubic; the
-     * melt/LOD rides the camera every frame. `prefers-reduced-motion` (or
-     * `opts.animate === false`) snaps via zoomToBounds. A grab (pointer-down) or a
-     * newer glide cancels an in-flight one.
+     * Glide the camera to frame a section (by id) or a world-space bounds rect —
+     * the Slice 5 "glide in". See render/camera for the tween and its rules.
      */
     focusRegion(target: string | {
         x: number;
@@ -1188,6 +1154,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** The camera scale every seat label needs to clear the legible floor.
      *  Derivation in ./render/seatLabelTargetScale. */
     private seatLabelTargetScale;
+    /** The buyer pinched back out to the venue: the section focus is over. */
+    private releaseFocusOnPullBack;
     /** Recompute LOD (cache/labels) after any pan/zoom settles. */
     private afterViewChange;
     /**
@@ -1812,6 +1780,15 @@ interface PickerCallbacks extends RendererCallbacks {
      * overview() / zoom-to-zones) so the host can show/hide the summary card.
      */
     onSectionFocus?: (summary: SectionSummary | null) => void;
+    /**
+     * Does the HOST have its own card open about the seat under the cursor?
+     *
+     * The map draws one hover card. A host that keeps its own — the widget's
+     * pinned card for a seat that cannot be taken, or its confirm card — answers
+     * true while that card is up, and the map's card stands down rather than
+     * saying the same thing beside it.
+     */
+    hostCardOpen?: () => boolean;
     /** A deck was tapped in the 3D all-floors overview — host enters that floor in 2D. */
     onDeckTap?: (floorId: string) => void;
     /**
@@ -2007,17 +1984,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 +2048,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 +2060,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 +2073,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 +2089,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 +2154,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 +2222,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 +2292,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 +2300,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. */
@@ -2348,6 +2361,9 @@ declare class PickerController {
     /** The camera a price band took from the buyer — see
      *  {@link PickerFocusContext.bandReturnPose}. */
     private bandReturnPose;
+    /** The section a price band took the buyer out of — see
+     *  {@link PickerFocusContext.bandReturnSection}. */
+    private bandReturnSection;
     /**
      * The state the filter-driven camera rules read and change — see
      * ./pickerFocus. Rebuilt per call; the accessor pair keeps the controller
@@ -2464,7 +2480,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 +2497,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 +2514,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 +2533,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 +2556,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.
      *