@seatlayer/core 0.75.2 → 0.77.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-CqaNLbU6.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-CqaNLbU6.cjs';
-import { E as EventConfigurationRef, a as EventConfigurationVersion } from './eventConfigurations-CqfrYWAb.cjs';
-export { b as EVENT_CONFIGURATION_EXPORT_SCHEMA, c as EVENT_CONFIGURATION_SCHEMA, d as EventConfigurationBaseVenue, e as EventConfigurationCompatibilityIssue, f as EventConfigurationCompatibilityIssueCode, g as EventConfigurationCompatibilityResult, h as EventConfigurationExportEnvelope, i as EventConfigurationLifecycleStatus, j as EventConfigurationOcclusion, k as EventConfigurationOverlay, l as EventConfigurationParseIssue, m as EventConfigurationParseIssueCode, n as EventConfigurationParseResult, o as EventConfigurationProductionElement, p 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-CqfrYWAb.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-BdCyNeqX.cjs';
-import { c as TicketSelectionIssue } from './ticketRestrictions-CPZglNvw.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-CPZglNvw.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-CA-bBex5.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-1E9KuJvY.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-BRmVrITG.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-BRmVrITG.cjs';
-import './segmentedRowModel-C7XOEjHk.cjs';
+import { C as ChartDoc, F as FloorLabelStyle, P as Point, A as AccessibilityType, i as CategoryTier, S as SeatCommercialAttributes, w as ChartDeliveryPerformance } from './types-Dq-ipTBG.cjs';
+export { x as ACCESSIBILITY_RING_COLOR, y as ACCESSIBILITY_TYPES, z as AccessibilityMeta, D as AuthoringObjectState, B as BoothObject, p as Category, E as ChartLayoutConstraint, a as ChartObject, o as ChartReferenceImage, H as ChartTheme, I as ConfidenceEvidenceScope, u as CubicPath, J as DecorImageObject, m as Floor, G as GAAreaObject, h as GAInventorySegment, K as LABEL_STYLE_MAX_SIZE, M as LABEL_STYLE_MIN_SIZE, N as LabelPresentation, L as LabelStyle, O as ObjectEditorState, Q as Physical3dEvidence, U as RadialClearanceLayoutConstraint, n as RectTableSeatCounts, l as RectTableSide, V as ReferenceAccessibilitySource, W as ReferenceCalibration, X as ReferenceCategorySource, Y as ReferenceDerivedScale, Z as ReferenceDirectAnnotationSource, _ as ReferenceDirectLandmarkCandidate, $ as ReferenceDirectLandmarkDisposition, a0 as ReferenceDirectLandmarkRole, a1 as ReferenceDirectLandmarkSource, a2 as ReferenceDirectSeatGroup, a3 as ReferenceDirectSeatImportSource, a4 as ReferenceDirectSeatPlan, a5 as ReferenceDirectStageSource, a6 as ReferenceEnrichmentStatus, a7 as ReferenceExtractEmptyReason, a8 as ReferenceExtractEnrichment, a9 as ReferenceExtractInput, aa as ReferenceExtractProposal, ab as ReferenceExtractRegionSeats, ac as ReferenceInventoryExclusionSource, ad as ReferenceInventorySource, ae as ReferenceMatchReport, af as ReferenceScanProposal, ag as ReferenceScanRowProposal, ah as ReferenceScanSectionProposal, ai as ReferenceSeatSeed, aj as ReferenceSectionTraceBatchInput, ak as ReferenceSectionTraceBatchProposal, al as ReferenceSectionTraceInput, am as ReferenceSectionTraceProposal, c as ResolvedSeatConfidenceEvidence, R as RowObject, an as SEAT_COMMERCIAL_MARKS, ao as STAGE_LABEL_STYLE_MAX_SIZE, ap as SURROUNDINGS_SHAPE_ROLES, aq as SeatCommercialMark, ar as SeatCommercialMeta, as as SeatConfidenceCoverage, at as SeatConfidenceEvidence, au as SeatConfidenceModelLevel, av as SeatConfidenceModeledTarget, aw as SeatConfidenceRealityLevel, d as SeatGlyphKind, k as SeatOverride, e as SeatViewCoverage, b as SeatViewMetadata, ax as SeatViewVariant, j as SectionObject, f as SectionOutlinePath, g as SectionPathSegment, ay as SelectionLayer, q as ShapeLineCap, r as ShapeLineEnding, s as ShapeLineJoin, t as ShapeObject, az as StageLabelStyle, T as TableObject, aA as TextAlignment, aB as TextBackground, v as TextObject, aC as TicketTierApplicability, aD as TicketTierEvidence, aE as TicketTierRestriction, aF as Venue3DMaterialPalette, aG as VenueSurveyRegistrationEvidence, aH as ZoneDef, aI as accessibilityMeta, aJ as accessibilityRingColor, aK as layerOf, aL as seatCommercialMeta } from './types-Dq-ipTBG.cjs';
+import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-vOMFVz7c.cjs';
+export { d as EVENT_CONFIGURATION_EXPORT_SCHEMA, e as EVENT_CONFIGURATION_SCHEMA, f as EventConfigurationBaseVenue, g as EventConfigurationCompatibilityIssue, h as EventConfigurationCompatibilityIssueCode, i as EventConfigurationCompatibilityResult, j as EventConfigurationExportEnvelope, k as EventConfigurationLifecycleStatus, a as EventConfigurationOcclusion, l as EventConfigurationOverlay, m as EventConfigurationParseIssue, n as EventConfigurationParseIssueCode, o as EventConfigurationParseResult, p as EventConfigurationProductionElement, E as EventConfigurationProductionElementKind, q as EventConfigurationVenueSnapshot, r as EventConfigurationVersionParseResult, s as EventConfigurationVersionSummary, L as LegacyEventConfigurationMigrationResult, t as canTransitionEventConfiguration, u as canonicalEventConfigurationJson, v as inspectEventConfigurationCompatibility, w as migrateLegacyEventConfigurations, x as parseEventConfigurationExport, y as parseEventConfigurationVersion, z as resolveEventConfigurationRollback } from './eventConfigurations-vOMFVz7c.cjs';
+export { A as AUTOMATIC_ROUND_TABLE_RADIUS_MAX, a as AUTOMATIC_ROUND_TABLE_RADIUS_MIN, C as ChartBoundsOptions, E as ExpandChartOptions, F as FLOOR_STACK_GAP_RATIO, b as FLOOR_STACK_MIN_SURFACE_PX, c as FloorStackOptions, d as FloorStackPlacement, R as RowSeatSlot, T as TABLE_SEAT_OFFSET, e as TableSeatSlot, f as allObjects, g as automaticRoundTableRadius, h as chartBounds, i as expandBooth, j as expandChart, k as expandRow, l as expandRowSlots, m as expandTable, n as expandTableSlots, o as floorObjects, p as floorStackPlacements, q as floorsOf, r as initialFloorMode, s as layoutFloorStack, t as mainFloorId, u as objectCenter, v as owningSectionForObject, w as pointInPolygon, x as pointInPolygonWithHoles, y as polygonLabelPoint, z as rowInventoryCount, B as rowSeatPositions, D as stackFloors, G as tableInventoryCount, H as tableSeatCountsBySide, I as translateObject } from './tableSizing-DKygWd7z.cjs';
+import { c as TicketSelectionIssue } from './ticketRestrictions-CvGDnGS8.cjs';
+export { M as MAX_EVENT_INVENTORY, a as MAX_GA_CAPACITY, g as gaAreasOf, h as gaInventorySegments, i as gaUnitLabel, j as gaUnitLabels, k as growJoinedGAInventory, l as isGaUnitLabel, v as validGAInventorySegments } from './ticketRestrictions-CvGDnGS8.cjs';
+export { A as AvailabilityRule, S as SectionNode, T as TIER_HEIGHT_M, U as UNGROUPED_ID, a as applyHidden, c as computeSections, h as hiddenObjectIds, i as isSectionHidden, s as sectionGeometry } from './sections-CQ0sd37E.cjs';
+export { M as MIN_POINTER_TARGET_PX, R as RENDERED_QUALITY_REPORT_VERSION, a as RenderedEvidenceState, b as RenderedQualityFinding, c as RenderedQualityFindingCode, d as RenderedQualityReport, e as RenderedQualitySample, i as inspectRenderedQualityEvidence } from './renderedQuality-CRLkEGf8.cjs';
+import { I as ISeatmapRenderer, b as RendererOptions, S as SeatStatus, c as SeatMark, E as ExpandedSeat, G as GAAreaState, d as RendererViewMode, e as RendererMinimapSnapshot, L as LodRung, R as RendererQualityEvidence, f as RendererCallbacks } from './renderer-B6kkgOHz.cjs';
+export { C as CHART_STORAGE_KEY, g as RenderedBookableLabelEvidence, a as RenderedFreeTextEvidence, h as RenderedGAAreaEvidence, i as RenderedHierarchyLabelEvidence, j as RenderedLabelHiddenReason, k as RenderedRowLabelEvidence, l as RendererHoverDetails, m as RendererMinimapSeat, n as RendererMinimapSection, o as SeatMarkKind } from './renderer-B6kkgOHz.cjs';
+import './segmentedRowModel-DqFhb-7Q.cjs';
 
 /**
  * Half-width of the band around a legibility threshold, in rendered pixels.
@@ -91,6 +91,31 @@ interface CameraPose {
     scale: number;
 }
 
+/** One named section a buyer's accessibility filter can actually send them to. */
+interface AccessibleSectionSummary {
+    /** The logical section id — what `focusSection` and the dock bar both use. */
+    id: string;
+    /** The section's own name, as painted on the block. */
+    label: string;
+    /** Free seats in it that match the filter. */
+    free: number;
+}
+/** What the filter matched, and the SHAPE of it — see {@link accessibleSpread}. */
+interface AccessibleSpread {
+    /** Free matching seats anywhere on the active floor. */
+    spaces: number;
+    /** The named sections holding them. */
+    sections: AccessibleSectionSummary[];
+    /**
+     * The matches are scattered across (nearly) the whole venue.
+     *
+     * The camera answer and the words the widget says both hang off this: a tight
+     * cluster is dived into and needs no explanation, a bowl-wide scatter is
+     * already on screen and needs to be told apart from "nothing happened".
+     */
+    wholeVenue: boolean;
+}
+
 declare class SeatmapRenderer implements ISeatmapRenderer {
     private container;
     private opts;
@@ -100,6 +125,13 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private seatLayer;
     private overlayLayer;
     private labelGroup;
+    /** Row letters live in their own child of {@link labelGroup}: they are
+     *  rebuilt every settle, while the seat numbers beside them are reused. */
+    private rowLabelGroup;
+    /** Live seat-number / status-cue nodes, kept across settles — see
+     *  render/viewportLabels `seatLabelPool`. */
+    private seatLabelPool;
+    private statusCuePool;
     /** Per-elevated-section label containers. Keeping the labels grouped lets the
      *  Phase-B lift move thousands of seat labels with one transform per section
      *  instead of rewriting every label on every tween frame. */
@@ -183,6 +215,11 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private seatMarks;
     /** 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
+     *  render/selectionNeighbourhood. Null whenever there is no focus. */
+    private selectionFocusKeep;
+    /** The camera as it stood when the host hid the map — see render/hostResize. */
+    private hiddenPose;
     private hoverRing;
     /** Seat currently owning the shared hover ring (null while not hovering). */
     private hoveredId;
@@ -194,6 +231,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * a type list = dim free seats lacking any of those accommodations.
      */
     private accessFilter;
+    /** Memoised free-matching-space counts, keyed by SectionRender id. */
+    private readonly accessFreeBySection;
     /** Category highlight (legend hover): dims free seats NOT of this category. */
     private categoryHighlight;
     /** Price-band filter (F4): dim free seats whose category is NOT in this set. */
@@ -297,6 +336,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      *  half the chart's seat pitch. Depth/ceiling maths read this, never seatR:
      *  a traced plan leaves the radius at its default and packs the seats. */
     private markerR;
+    /** Median in-row seat spacing, world units — the section-less neighbourhood's unit. */
+    private seatPitch;
     private bounds;
     private cached;
     private dpr;
@@ -609,31 +650,23 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Host-pushed GA availability / pending quantity — see {@link paintGAState}. */
     setGAStates(states: Record<string, GAAreaState>): void;
     setGAState(areaId: string, state: GAAreaState): void;
-    /** Frame available inventory; narrow maps enter usable seat detail. */
+    /**
+     * The state the framing rules read — rebuilt per call so camera, filter and
+     * status changes are always seen fresh. See ./render/focusFraming.
+     */
+    private get focusFramingContext();
+    /** Take the buyer to a price band's seats — see ./render/focusFraming. */
     focusCategories(keys: string[] | null, opts?: {
         animate?: boolean;
     }): void;
-    /**
-     * Frame every seat matching the accessibility filter — ALL of them.
-     *
-     * Deliberately NOT {@link focusCategories}. A price band is thousands of
-     * seats forming blocks, so that path clusters them and, on a phone, dives
-     * into a seat-detail window showing the dominant block. An accessibility
-     * filter is a handful of spaces scattered around the venue: the phone
-     * validator's uber-arena has TWELVE, one or two per tier. Diving into a
-     * detail window there shows the buyer none of them, and jumping to the seats
-     * rung — which is what the widget did before this existed — put all twelve
-     * off-screen in the middle of a 14k arena.
-     *
-     * So the rule is the union, always: bounding box of the matching seats plus a
-     * margin, clamped to the zoom bounds. When that box fits at a scale where the
-     * seats are already tappable, the buyer lands on tappable seats; when it does
-     * not, they still SEE all twelve and can zoom into the one they want. Framing
-     * fewer than all of them is never the answer.
-     *
-     * Returns false when there is nothing to frame, so a caller can fall back.
-     */
+    /** The ceiling for a camera move the ENGINE decided to make. */
+    private diveCeiling;
+    /** Frame every seat matching the accessibility filter — ALL of them. */
     focusAccessibleSeats(types?: AccessibilityType[] | null): boolean;
+    /** Take the camera to the free matching spaces INSIDE one section. */
+    focusAccessibleSection(sectionId: string, types?: AccessibilityType[] | null): boolean;
+    /** What the filter matched, and how it is spread over the venue. */
+    accessibleSpread(types?: AccessibilityType[] | null): AccessibleSpread | null;
     /**
      * Switch the projection between flat top-down and the isometric "3D" view
      * (rotate + y-squash about the chart centre, plus per-elevation lift). Tweens
@@ -727,6 +760,10 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * Grand Circle and its seats lost their numbers (owner report 2026-08-27),
      * at a zoom where they were fully bright on screen.
      */
+    /** Is the confirm-card focus receding THIS seat? False with no focus, false
+     *  for the candidate, and false for its neighbourhood — see
+     *  render/selectionNeighbourhood for how the neighbourhood is drawn. */
+    private selectionFocusDims;
     private focusedSeatOpacity;
     private sectionScreenBounds;
     /** Hide only section groups wholly outside a padded viewport at the live-seat
@@ -817,6 +854,20 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     focusSection(id: string, opts?: {
         anchor?: Point;
     }): void;
+    /**
+     * Enter a section's focus state WITHOUT moving the camera.
+     *
+     * Split out because "which section is the buyer in" and "what is the camera
+     * framing" are not always the same answer: a best-available pick frames the
+     * SEATS it found, which may be a corner of the section, while the dock bar,
+     * the dim and the backdrop still have to belong to the section around them.
+     * Returns false for an id this chart has no section for.
+     */
+    private markSectionFocus;
+    /** Frame THESE seats, close enough to take one — see ./render/focusFraming. */
+    focusSeats(ids: readonly string[], opts?: {
+        animate?: boolean;
+    }): boolean;
     private focusSectionCamera;
     /**
      * Release only the focus dim + backdrop, keeping the focused-section state
@@ -903,23 +954,22 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderShape;
     private renderGA;
     /**
-     * A section renders in three coordinated layers driven by the LOD melt:
-     *   • a faint outline (the existing near-zoom look, untouched),
-     *   • a neutral solid shell that fades in at the overview rung, and
-     *   • one readable, contained section name.
-     * Category, row, seat, and availability detail belongs to section focus/zoom.
-     * Membership and category mix are still precomputed for the detailed state.
+     * Build one section's scene nodes (see ./render/sectionBuild), then register
+     * it: seat→section membership, the memoised unsectioned partition it
+     * invalidates, its first fill/heat paint, and the section list itself.
      */
     private renderSection;
+    private get sectionBuildContext();
     private refreshSectionHeat;
     private refreshSectionFill;
     private isSectionClosed;
     /**
      * The hue an overview block is tinted with; see ./render/overviewPalette. */
     private dominantSellableColor;
-    /**
-     * Free seats here matching the accessibility filter; see ./render/sectionLod. */
+    /** Free matching seats in this section — memoised; see ./render/focusFraming. */
     private sectionAccessibleFree;
+    /** The named sections holding a FREE matching space — see ./render/focusFraming. */
+    accessibleSections(types?: AccessibilityType[] | null): AccessibleSectionSummary[];
     private get sectionLodPaintContext();
     /** Build the zone pills (name + FROM price) — see render/zoneScene.ts. */
     private renderZones;
@@ -937,6 +987,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Seat ids belonging to a section (Slice 5 section-summary card). */
     sectionMembers(id: string): string[];
     private isSelectable;
+    /** One question for the one excluded treatment — see render/filterExclusion. */
+    private filterExcludesSeat;
     /**
      * Is this seat out of the sale purely because the accessibility filter is on?
      *
@@ -1046,6 +1098,7 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     }, opts?: {
         animate?: boolean;
         minScale?: number;
+        maxScale?: number;
         durationMs?: number;
     }): void;
     /**
@@ -1077,8 +1130,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * settled state. Without it a backdrop tap (clearSectionFocus + zoomToFit)
      * left the widget's deep state on the pre-settle reading — the map back at
      * the overview, the chrome still saying the buyer was inside a section.
+     *
+     * Public because a HOST rebuild owes one too: `setChart` empties the label
+     * and status-cue pools, and restoring an identical camera pose after it runs
+     * no pass of its own. See PickerController.rebuildPreservingState.
      */
-    private settleView;
+    settleView(): void;
     /** Once the buyer is roaming, the locator names what is ON SCREEN rather than
      *  what they tapped — WITHOUT moving the camera. Retargeting is a
      *  relabelling; a glide here would fight the pan that caused it. */
@@ -1136,20 +1193,11 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private objectFilteredOut;
     private updateLabels;
     private get viewportLabelContext();
+    /** See render/hostResize for the rule; this is the part that touches state. */
     private handleResize;
 }
 declare function createRenderer(container: HTMLDivElement, opts?: RendererOptions): ISeatmapRenderer;
 
-/**
- * Automatic row-letter label planning: where each authored row label wants to
- * sit in world space, and how an automatic start/end label steps out of the way
- * of seats and already-painted text.
- *
- * Moved verbatim out of SeatmapRenderer (2026-08-15 refactor, Phase 2B pass B);
- * `this.` became either a `ctx` field or an explicit parameter, and
- * `buildRowLabelPlan` returns the plan instead of assigning `this.rowLabelPlan`.
- */
-
 /**
  * Reduce a globally-unique authored row name to the local identity a buyer
  * needs, given the section that already names itself on screen.
@@ -1174,42 +1222,6 @@ declare function createRenderer(container: HTMLDivElement, opts?: RendererOption
  */
 declare function compactRowLabel(rowLabel: string, sectionLabel: string | undefined): string;
 
-/**
- * The access needs THIS chart actually offers, with live free counts.
- *
- * The accessibility sheet used to render the whole twelve-key taxonomy on
- * every event, so a buyer at a venue with nothing but wheelchair bays was
- * offered "CART live-caption view" and "Sign-language view" — chips that
- * filter to an empty map. Offering a provision that does not exist is worse
- * than a short list: it reads as a venue that has it and has sold out of it.
- *
- * So the list is derived from the seats the chart authored. A key appears
- * because at least one seat carries it — including a key whose seats are all
- * gone, which is shown at zero and disabled rather than dropped, so the
- * difference between "this venue has none" and "this venue's are taken" stays
- * visible.
- *
- * `count` is FREE seats only, and is counted exactly the way
- * `sectionAccessibleFreeCount` counts them (status `free`, then the seat's own
- * accommodation set) — one definition of "available accessible seating" across
- * the overview blocks, the section card and this list.
- */
-
-/** One provision the event offers, and how many of it are still free. */
-interface PickerAccessNeed {
-    key: AccessibilityType;
-    /** Free seats carrying this accommodation right now. May be 0. */
-    count: number;
-}
-/**
- * The provisions on this chart, in the taxonomy's own order.
- *
- * Taxonomy order rather than count order on purpose: the sheet is a stable
- * control, and a list that reshuffles itself as other buyers take seats is one
- * the returning buyer has to re-read every time.
- */
-declare function accessNeedsFor(seats: Iterable<ExpandedSeat>, statusOf: (seatId: string) => string): PickerAccessNeed[];
-
 /**
  * What an availability refresh means for the buyer who is looking at the map.
  *
@@ -1568,8 +1580,20 @@ interface PickerRealtimeSink {
         default: string;
         exceptions: Record<string, string>;
     }): void;
-    /** Re-pull authoritative state over HTTP (a frame that cannot be diffed). */
-    resync(): void | Promise<void>;
+    /**
+     * Re-pull authoritative state over HTTP (a frame that cannot be diffed).
+     *
+     * `reason: 'connect'` marks the pull a fresh socket makes for parity rather
+     * than because anything said the map is stale. A sink that has just booted
+     * from an authoritative read is entitled to skip that one — the connection
+     * itself is not evidence of a change, and on a real event page the boot read
+     * and the connect read were landing 400ms apart, both of them full snapshots.
+     * Any other reason (an undiffable frame, a resume the server never answered)
+     * is a real "I do not know the state" and is never skipped.
+     */
+    resync(opts?: {
+        reason?: 'connect' | 'frame';
+    }): void | Promise<void>;
     /** Section availability changed (hidden = stripped, closed = greyed). */
     onSections?(hidden: string[], closed: string[]): void;
     /** Scope-projected presence counters. Unused by the picker today. */
@@ -1686,8 +1710,19 @@ interface PickerCallbacks extends RendererCallbacks {
     onHoldExpired?: () => void;
     /** A booking completed with this ref. */
     onBook?: (bookingRef: string) => void;
-    /** Any live seat-status change arrived (delta or snapshot) — e.g. to recount "N left". */
-    onStatusChange?: () => void;
+    /**
+     * A seat-status batch was painted (delta or snapshot) — e.g. to recount "N left".
+     *
+     * `changed` says whether that batch moved anything. A re-stated snapshot —
+     * what a fresh socket, a resume answer or a section rebuild produces — paints
+     * the identical map, and a listener that treats every paint as news does real
+     * work for it: the buyer widget was pulling live offer availability over the
+     * network once per repaint. Absent on an older engine, so read it as
+     * "assume changed" when it is not there.
+     */
+    onStatusChange?: (info?: {
+        changed: boolean;
+    }) => void;
     /**
      * An availability refresh finished — what it changed for THIS buyer.
      *
@@ -1850,6 +1885,62 @@ interface PickerMapTheme {
     selectionColor?: string;
 }
 
+/**
+ * The buyer picker's FILTER-DRIVEN camera rules.
+ *
+ * Two filters — accessibility and price band — each answer "take me to what I
+ * asked for", and both have to solve the same multi-floor trap first: the
+ * renderer only knows the active floor's seats, so a match on another deck is
+ * a silent no-op unless the floor is switched before the camera is asked to
+ * move. Those decisions moved out of PickerController verbatim behind an
+ * explicit context; they own no state and touch the renderer only through the
+ * interface the controller already used.
+ */
+
+/** One step of the accessibility section tour — see {@link focusNextAccessibleSection}. */
+interface AccessibleSectionStep extends AccessibleSectionSummary {
+    /** 0-based position in the tour. */
+    index: number;
+    /** How many sections the tour has. */
+    total: number;
+}
+
+/**
+ * The access needs THIS chart actually offers, with live free counts.
+ *
+ * The accessibility sheet used to render the whole twelve-key taxonomy on
+ * every event, so a buyer at a venue with nothing but wheelchair bays was
+ * offered "CART live-caption view" and "Sign-language view" — chips that
+ * filter to an empty map. Offering a provision that does not exist is worse
+ * than a short list: it reads as a venue that has it and has sold out of it.
+ *
+ * So the list is derived from the seats the chart authored. A key appears
+ * because at least one seat carries it — including a key whose seats are all
+ * gone, which is shown at zero and disabled rather than dropped, so the
+ * difference between "this venue has none" and "this venue's are taken" stays
+ * visible.
+ *
+ * `count` is FREE seats only, and is counted exactly the way
+ * `sectionAccessibleFreeCount` counts them (status `free`, then the seat's own
+ * accommodation set) — one definition of "available accessible seating" across
+ * the overview blocks, the section card and this list.
+ */
+
+/** One provision the event offers, and how many of it are still free. */
+interface PickerAccessNeed {
+    key: AccessibilityType;
+    /** Free seats carrying this accommodation right now. May be 0. */
+    count: number;
+}
+/**
+ * The provisions on this chart, in the taxonomy's own order.
+ *
+ * Taxonomy order rather than count order on purpose: the sheet is a stable
+ * control, and a list that reshuffles itself as other buyers take seats is one
+ * the returning buyer has to re-read every time.
+ */
+declare function accessNeedsFor(seats: Iterable<ExpandedSeat>, statusOf: (seatId: string) => string): PickerAccessNeed[];
+
 declare class PickerController {
     private readonly opts;
     private readonly api;
@@ -1893,6 +1984,8 @@ declare class PickerController {
     private confirmedVariableTables;
     private groupedSelectionOverhead;
     private ws;
+    /** Standby snapshot pull for a socket that connected and then said nothing. */
+    private connectFallback;
     /** Transport-owned v1 client; mutually exclusive with `ws`. */
     private realtime;
     private reconnectTimer;
@@ -2184,41 +2277,21 @@ declare class PickerController {
     setAccessibilityFilter(types: string[] | null): void;
     /** The buyer's active accessibility filter, or null. */
     getAccessibilityFilter(): AccessibilityType[] | null;
+    /** Where {@link focusNextAccessibleSection} last stopped. */
+    private accessStepAt;
     /**
-     * Take the buyer to the seats their accessibility filter matched.
-     *
-     * The mirror of {@link focusCategoryFilter}, and deliberately a different
-     * camera rule (see the renderer's `focusAccessibleSeats`). Switching the
-     * filter on used to jump to the seats rung, which on the validator's
-     * uber-arena — twelve wheelchair spaces spread over a 14k-seat venue — put
-     * every single match off-screen: the buyer asked "where can I sit?" and got
-     * a close-up of a block with no accessible seats in it.
-     *
-     * Frames the union of the matches instead, so all twelve are on screen. No-op
-     * when the filter is off or matched nothing; returns whether it moved, so a
-     * host can keep its old behaviour as a fallback.
+     * The state the filter-driven camera rules read and change — see
+     * ./pickerFocus. Rebuilt per call; the accessor pair keeps the controller
+     * the owner of the filter and of the section-tour cursor.
      */
+    private get pickerFocusContext();
+    /** Take the buyer to the seats their accessibility filter matched. */
     focusAccessibilityFilter(types?: AccessibilityType[] | null): boolean;
-    /**
-     * The floor a buyer means when filtering for accessibility: the active floor
-     * when it carries a matching seat, else the first floor that does (null =
-     * stay put). Row overrides count — accessibility is authored per seat.
-     */
-    private floorForAccessibility;
-    /**
-     * Does the active accessibility filter RECEDE this seat?
-     *
-     * The 2D map answers this with Konva opacity, which the GL view never sees —
-     * so a buyer who filtered for wheelchair spaces and then switched to 3D got
-     * the unfiltered venue back, every zone in normal colour, with no sign the
-     * filter was still on. The widget's 3D snapshot builder already asks the same
-     * question of the price band and the limited-view toggle; this is the third,
-     * and it is answered HERE rather than in the widget so the rule cannot drift
-     * from the one the canvas paints (renderer `hiddenByAccessFilter`).
-     *
-     * Presentation only, exactly as in 2D: a dimmed seat is not an unselectable
-     * one.
-     */
+    /** What the accessibility filter matched, and how it is spread. */
+    accessibilitySpread(types?: AccessibilityType[] | null): AccessibleSpread | null;
+    /** Step to the next section holding a free matching space. */
+    focusNextAccessibleSection(types?: AccessibilityType[] | null): AccessibleSectionStep | null;
+    /** Does the active accessibility filter RECEDE this seat? See ./pickerFocus. */
     accessibilityFilterDims(seat: ExpandedSeat): boolean;
     /**
      * "Hide limited-view seats" toggle — dims free seats flagged
@@ -2261,15 +2334,8 @@ declare class PickerController {
     /** Price-band filter (F4): dim free seats whose category is outside `keys`
      *  (null clears). The widget resolves which categories fall in the band. */
     setCategoryFilter(keys: string[] | null): void;
-    /** An explicit buyer price-filter action should not only dim the rest of the
-     *  chart: clear any older section drill-in and guide the camera to the seats
-     *  that remain relevant. Clearing the filter glides back to the full chart. */
+    /** Guide the camera to the seats a price band left — see ./pickerFocus. */
     focusCategoryFilter(keys: string[] | null): void;
-    /** The floor a buyer means when filtering to `keys`: the active floor when it
-     *  carries any of those categories, else the first floor that does (null =
-     *  stay put). Row overrides and GA areas count — a category can exist on a
-     *  floor only via a per-seat override. */
-    private floorForCategories;
     /** World-space rect currently visible + full chart bounds (F3 minimap frame). */
     getViewport(): {
         visible: {
@@ -2300,6 +2366,19 @@ declare class PickerController {
         x: number;
         y: number;
     }): void;
+    /**
+     * Take the camera to seats the ENGINE picked, and name the section they are in.
+     *
+     * Best-available's arrival used to frame the section of the first seat found,
+     * which on a large stand showed the buyer everything except which seats they
+     * had been given. The renderer frames the seats themselves; the summary
+     * emitted here is what renames the dock bar, so the two halves of "you are
+     * here" still agree. False when the renderer could not frame them — the
+     * caller falls back to the section.
+     */
+    focusSeats(ids: readonly string[], opts?: {
+        animate?: boolean;
+    }): boolean;
     /** Live seat membership count used by buyer section-navigation controls. */
     getSectionSeatCount(id: string): number;
     /** Zoom back out to the whole chart and clear the section-summary card + focus. */
@@ -2314,6 +2393,7 @@ declare class PickerController {
      * object owns beyond four values, and this file is at its size cap.
      */
     private sectionSummary;
+    private clearConnectFallback;
     destroy(): void;
     private toSeat;
     private toTableSeat;
@@ -2367,6 +2447,17 @@ declare class PickerController {
      * a parameter rather than a constant.
      */
     private applySeatsMap;
+    /**
+     * When an authoritative map was last painted, and whether one is recent.
+     *
+     * A socket opening is not news. The boot read and the connect read were
+     * landing within half a second of each other on a real event page — two full
+     * snapshots of the same venue, the second answering a question nobody asked.
+     * Five seconds is comfortably longer than a boot takes and far shorter than
+     * any window in which a silent server could leave the map wrong.
+     */
+    private lastSnapshotAt;
+    private snapshotIsFresh;
     /** The live status of one unit, honouring the projection's default. */
     private statusOf;
     private clearBookedHoldIfSettled;
@@ -2416,6 +2507,8 @@ declare class PickerController {
      * callbacks in the same order whichever path is live.
      */
     private realtimeSink;
+    /** Does this authoritative map say anything the last one did not? */
+    private seatsMapDiffers;
     /** Paint one delta batch. Shared by the v1 sink and the plain-socket handler. */
     private applyStatusChanges;
     private connect;
@@ -2696,4 +2789,4 @@ declare function formatMinor(minor: number, currency?: string, locale?: string):
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { AccessibilityType, type AvailabilityRefreshInput, type AvailabilityRefreshOutcome, CURRENCY_CHOICES, CategoryTier, ChartDeliveryPerformance, ChartDoc, DEFAULT_CURRENCY, type Dict, type Direction, EMPTY_AVAILABILITY_REFRESH, EventConfigurationRef, EventConfigurationVersion, ExpandedSeat, FloorLabelStyle, GAAreaState, HOLD_CLOCK_SKEW_MS, type HoldConflict, type HoldInfo, type HoldRecoveryShape, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LABEL_FADE_MS, LEGIBILITY_HYSTERESIS_PX, LOCALE_NAMES, type Locale, LodRung, type MoneyFormatOptions, type PanoramaResult, type PickerAccessNeed, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerRenderPerformanceProfile, type PickerSeat, PickerSelectionError, type PickerSelectionValidator, type PickerSelectionValidity, type PickerSelectionViolation, type PickerStatusChange, type PickerTransport, Point, RendererCallbacks, RendererMinimapSnapshot, RendererOptions, RendererQualityEvidence, RendererViewMode, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatMark, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionSummary, TRANSLATED_LOCALES, type TableSelectionDetails, accessNeedsFor, attachVisibilityCatchUp, compactRowLabel, createRenderer, crossesThreshold, currencyExponent, currencySymbol, formatDate, formatMinor, formatMoney, fromMinorUnits, generateSeatPanorama, generateSeatThumb, getLocale, holdHasLapsed, holdRecoveryShape, hysteresisScale, isLocaleLoaded, loadLocale, localeDirection, reconcileAvailability, refreshChangedSomething, renderedPx, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, shouldWaitForHoldExpiry, t, tCount, zoomTowardPoint };
+export { AccessibilityType, type AccessibleSectionStep, type AccessibleSectionSummary, type AccessibleSpread, type AvailabilityRefreshInput, type AvailabilityRefreshOutcome, CURRENCY_CHOICES, CategoryTier, ChartDeliveryPerformance, ChartDoc, DEFAULT_CURRENCY, type Dict, type Direction, EMPTY_AVAILABILITY_REFRESH, EventConfigurationRef, EventConfigurationVersion, ExpandedSeat, FloorLabelStyle, GAAreaState, HOLD_CLOCK_SKEW_MS, type HoldConflict, type HoldInfo, type HoldRecoveryShape, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LABEL_FADE_MS, LEGIBILITY_HYSTERESIS_PX, LOCALE_NAMES, type Locale, LodRung, type MoneyFormatOptions, type PanoramaResult, type PickerAccessNeed, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerRenderPerformanceProfile, type PickerSeat, PickerSelectionError, type PickerSelectionValidator, type PickerSelectionValidity, type PickerSelectionViolation, type PickerStatusChange, type PickerTransport, Point, RendererCallbacks, RendererMinimapSnapshot, RendererOptions, RendererQualityEvidence, RendererViewMode, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatMark, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionSummary, TRANSLATED_LOCALES, type TableSelectionDetails, accessNeedsFor, attachVisibilityCatchUp, compactRowLabel, createRenderer, crossesThreshold, currencyExponent, currencySymbol, formatDate, formatMinor, formatMoney, fromMinorUnits, generateSeatPanorama, generateSeatThumb, getLocale, holdHasLapsed, holdRecoveryShape, hysteresisScale, isLocaleLoaded, loadLocale, localeDirection, reconcileAvailability, refreshChangedSomething, renderedPx, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, shouldWaitForHoldExpiry, t, tCount, zoomTowardPoint };