@seatlayer/core 0.79.0 → 0.80.1

package/dist/index.d.cts

@@ -2,13 +2,13 @@ import { C as ChartDoc, F as FloorLabelStyle, P as Point, A as AccessibilityType
 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 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-Dcl2RqNV.cjs';
+import { g as TicketSelectionIssue, b as GroupedTableInventoryUnit } from './ticketRestrictions-CgReCops.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-CgReCops.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';
+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-twM7ALWT.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-CPiYrzQW.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-CPiYrzQW.cjs';
 import './segmentedRowModel-BYSxfsqX.cjs';
 
 /**
@@ -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
@@ -273,8 +277,14 @@ 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}. */
+    /** Does entering a section draw the entrance dim + backdrop?
+     *
+     *  `null` — the default — means "nobody has said", and the answer is derived
+     *  from the stage: a narrow (phone-sized) stage gets no dim, a wide one does.
+     *  A host that calls {@link setSectionFocusDim} pins it to a boolean and its
+     *  answer wins from then on. The tri-state exists because the ONLY caller was
+     *  `SeatPicker`, which is never mounted on the native bridge — so every
+     *  native SDK got the desktop dim on a phone-sized stage. */
     private sectionFocusDim;
     /** How many camera moves the BUYER has made — see {@link getCameraGestureCount}. */
     private cameraGestures;
@@ -347,10 +357,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 +420,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 +618,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 +711,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 +719,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 +730,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 +744,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 +839,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;
@@ -916,6 +922,13 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * `focusedSeatOpacity` is already gated on the overlay existing, so seats and
      * their labels simply stay at full brightness.
      */
+    /**
+     * The answer in force right now: an explicit {@link setSectionFocusDim} when
+     * a host gave one, otherwise the stage's own width. Narrow stages (phones,
+     * and every native WebView, which mounts no DOM chrome to call the setter)
+     * resolve to no dim.
+     */
+    private sectionDimEnabled;
     setSectionFocusDim(enabled: boolean): void;
     /** Clear an AXS section focus — restore full-bowl brightness + drop the backdrop. */
     clearSectionFocus(): void;
@@ -1001,7 +1014,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 +1107,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 +1167,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;
     /**
@@ -1768,6 +1749,28 @@ interface PickerCallbacks extends RendererCallbacks {
     onSelectionInvalid?: (state: PickerSelectionValidity) => void;
     /** A grouped table was selected and needs buyer confirmation/guest quantity. */
     onTableSelectionRequest?: (table: TableSelectionDetails) => void;
+    /**
+     * A second tap landed on a plain seat that is ALREADY in the selection, and
+     * {@link PickerOptions.retapKeepsSelection} kept it there.
+     *
+     * The renderer's own click logic toggles: it deselects and fires `onDeselect`
+     * immediately. `SeatPicker` answers that itself — it puts the seat back and
+     * raises its confirm card in `'remove'` mode (20c670c6) — but SeatPicker is
+     * DOM chrome and is never mounted on the native bridge, where `startBridge`
+     * builds a bare `SeatingChart`. So on every native SDK the second tap emptied
+     * the cart in silence, with no card and nothing to undo (reproduced on
+     * device, 2026-09-04).
+     *
+     * With the option on, the controller re-selects the seat and calls this
+     * INSTEAD of `onDeselect`, so a host that draws its own chrome can ask the
+     * buyer the opposite question. The seat is still selected when this fires;
+     * removing it is the host's own `deselect([seat.id])`.
+     *
+     * Only plain, locally-selected seats reach here. A server-held unit, a
+     * grouped table, and a seat that is no longer selectable all take the
+     * unchanged `onDeselect` path.
+     */
+    onSeatRetap?: (seat: PickerSeat) => void;
     /** A hold opened (manual hold or best-available). */
     onHold?: (hold: HoldInfo) => void;
     /** A prior active hold was restored from its opaque hold id. */
@@ -1812,6 +1815,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;
     /**
@@ -1843,6 +1855,16 @@ interface PickerOptions extends PickerCallbacks {
     selectionValidators?: PickerSelectionValidator[];
     /** Renderer confirm-card mode (host shows a confirm popover instead of instant cart add). */
     confirmSelection?: boolean;
+    /**
+     * Opt-in: a second tap on a plain seat already in the selection KEEPS it and
+     * reports {@link PickerCallbacks.onSeatRetap} instead of dropping it.
+     *
+     * Default false — the toggle is unchanged, which is what `SeatPicker` needs
+     * because it already answers the second tap with its own confirm card. Hosts
+     * that draw their own chrome (`SeatingChart`, and through it every native
+     * bridge surface) turn it on so a tap can never silently empty the cart.
+     */
+    retapKeepsSelection?: boolean;
     /** ISO 4217 currency for on-map prices (default from money.DEFAULT_CURRENCY). */
     currency?: string;
     /** Flash a pulse when a seat we didn't touch goes free→taken (live-activity cue). */
@@ -2384,6 +2406,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
@@ -2534,6 +2559,15 @@ declare class PickerController {
     private emitOrphanHint;
     /** Toggle colorblind-safe rendering at runtime (see PickerOptions.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
+    /**
+     * Pin whether entering a section dims the rest of the venue.
+     *
+     * Left alone the renderer answers from its own stage width (no dim on a
+     * phone-sized stage), which is what an embedding host with no DOM chrome of
+     * its own — every native WebView — wants. `SeatPicker` calls this because it
+     * knows its own layout breakpoint and wants the answer pinned to it.
+     */
+    setSectionFocusDim(enabled: boolean): void;
     /** @internal */ emitError(err: unknown): void;
     /** @internal */ holdCovers(labels: string[]): boolean;
     /** 409 conflict → deselect the taken labels and repaint them held. */