@seatlayer/core 0.76.0 → 0.77.1

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-import { C as ChartDoc, F as FloorLabelStyle, P as Point, A as AccessibilityType, i as CategoryTier, S as SeatCommercialAttributes, w as ChartDeliveryPerformance } from './types-CqaNLbU6.js';
-export { x as ACCESSIBILITY_RING_COLOR, y as ACCESSIBILITY_TYPES, z as AccessibilityMeta, D as AuthoringObjectState, B as BoothObject, p as Category, E as ChartLayoutConstraint, a as ChartObject, o as ChartReferenceImage, H as ChartTheme, I as ConfidenceEvidenceScope, u as CubicPath, J as DecorImageObject, m as Floor, G as GAAreaObject, h as GAInventorySegment, K as LABEL_STYLE_MAX_SIZE, M as LABEL_STYLE_MIN_SIZE, N as LabelPresentation, L as LabelStyle, O as ObjectEditorState, Q as Physical3dEvidence, U as RadialClearanceLayoutConstraint, n as RectTableSeatCounts, l as RectTableSide, V as ReferenceAccessibilitySource, W as ReferenceCalibration, X as ReferenceCategorySource, Y as ReferenceDerivedScale, Z as ReferenceDirectAnnotationSource, _ as ReferenceDirectLandmarkCandidate, $ as ReferenceDirectLandmarkDisposition, a0 as ReferenceDirectLandmarkRole, a1 as ReferenceDirectLandmarkSource, a2 as ReferenceDirectSeatGroup, a3 as ReferenceDirectSeatImportSource, a4 as ReferenceDirectSeatPlan, a5 as ReferenceDirectStageSource, a6 as ReferenceEnrichmentStatus, a7 as ReferenceExtractEmptyReason, a8 as ReferenceExtractEnrichment, a9 as ReferenceExtractInput, aa as ReferenceExtractProposal, ab as ReferenceExtractRegionSeats, ac as ReferenceInventoryExclusionSource, ad as ReferenceInventorySource, ae as ReferenceMatchReport, af as ReferenceScanProposal, ag as ReferenceScanRowProposal, ah as ReferenceScanSectionProposal, ai as ReferenceSeatSeed, aj as ReferenceSectionTraceBatchInput, ak as ReferenceSectionTraceBatchProposal, al as ReferenceSectionTraceInput, am as ReferenceSectionTraceProposal, c as ResolvedSeatConfidenceEvidence, R as RowObject, an as SEAT_COMMERCIAL_MARKS, ao as STAGE_LABEL_STYLE_MAX_SIZE, ap as SURROUNDINGS_SHAPE_ROLES, aq as SeatCommercialMark, ar as SeatCommercialMeta, as as SeatConfidenceCoverage, at as SeatConfidenceEvidence, au as SeatConfidenceModelLevel, av as SeatConfidenceModeledTarget, aw as SeatConfidenceRealityLevel, d as SeatGlyphKind, k as SeatOverride, e as SeatViewCoverage, b as SeatViewMetadata, ax as SeatViewVariant, j as SectionObject, f as SectionOutlinePath, g as SectionPathSegment, ay as SelectionLayer, q as ShapeLineCap, r as ShapeLineEnding, s as ShapeLineJoin, t as ShapeObject, az as StageLabelStyle, T as TableObject, aA as TextAlignment, aB as TextBackground, v as TextObject, aC as TicketTierApplicability, aD as TicketTierEvidence, aE as TicketTierRestriction, aF as Venue3DMaterialPalette, aG as VenueSurveyRegistrationEvidence, aH as ZoneDef, aI as accessibilityMeta, aJ as accessibilityRingColor, aK as layerOf, aL as seatCommercialMeta } from './types-CqaNLbU6.js';
-import { E as EventConfigurationRef, a as EventConfigurationVersion } from './eventConfigurations-Dhauc9V3.js';
-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-Dhauc9V3.js';
-export { A as AUTOMATIC_ROUND_TABLE_RADIUS_MAX, a as AUTOMATIC_ROUND_TABLE_RADIUS_MIN, C as ChartBoundsOptions, E as ExpandChartOptions, F as FLOOR_STACK_GAP_RATIO, b as FLOOR_STACK_MIN_SURFACE_PX, c as FloorStackOptions, d as FloorStackPlacement, R as RowSeatSlot, T as TABLE_SEAT_OFFSET, e as TableSeatSlot, f as allObjects, g as automaticRoundTableRadius, h as chartBounds, i as expandBooth, j as expandChart, k as expandRow, l as expandRowSlots, m as expandTable, n as expandTableSlots, o as floorObjects, p as floorStackPlacements, q as floorsOf, r as initialFloorMode, s as layoutFloorStack, t as mainFloorId, u as objectCenter, v as owningSectionForObject, w as pointInPolygon, x as pointInPolygonWithHoles, y as polygonLabelPoint, z as rowInventoryCount, B as rowSeatPositions, D as stackFloors, G as tableInventoryCount, H as tableSeatCountsBySide, I as translateObject } from './tableSizing-D8e8QAJ-.js';
-import { c as TicketSelectionIssue } from './ticketRestrictions-CorjMY49.js';
-export { M as MAX_EVENT_INVENTORY, a as MAX_GA_CAPACITY, g as gaAreasOf, h as gaInventorySegments, i as gaUnitLabel, j as gaUnitLabels, k as growJoinedGAInventory, l as isGaUnitLabel, v as validGAInventorySegments } from './ticketRestrictions-CorjMY49.js';
-export { A as AvailabilityRule, S as SectionNode, T as TIER_HEIGHT_M, U as UNGROUPED_ID, a as applyHidden, c as computeSections, h as hiddenObjectIds, i as isSectionHidden, s as sectionGeometry } from './sections-ByTMouG8.js';
-export { M as MIN_POINTER_TARGET_PX, R as RENDERED_QUALITY_REPORT_VERSION, a as RenderedEvidenceState, b as RenderedQualityFinding, c as RenderedQualityFindingCode, d as RenderedQualityReport, e as RenderedQualitySample, i as inspectRenderedQualityEvidence } from './renderedQuality-ChAZNV2N.js';
-import { I as ISeatmapRenderer, b as RendererOptions, S as SeatStatus, c as SeatMark, E as ExpandedSeat, G as GAAreaState, d as RendererViewMode, e as RendererMinimapSnapshot, L as LodRung, R as RendererQualityEvidence, f as RendererCallbacks } from './renderer-q7viZLGZ.js';
-export { C as CHART_STORAGE_KEY, g as RenderedBookableLabelEvidence, a as RenderedFreeTextEvidence, h as RenderedGAAreaEvidence, i as RenderedHierarchyLabelEvidence, j as RenderedLabelHiddenReason, k as RenderedRowLabelEvidence, l as RendererHoverDetails, m as RendererMinimapSeat, n as RendererMinimapSection, o as SeatMarkKind } from './renderer-q7viZLGZ.js';
-import './segmentedRowModel-DcvJVKLD.js';
+import { C as ChartDoc, F as FloorLabelStyle, P as Point, A as AccessibilityType, i as CategoryTier, S as SeatCommercialAttributes, w as ChartDeliveryPerformance } from './types-Dq-ipTBG.js';
+export { x as ACCESSIBILITY_RING_COLOR, y as ACCESSIBILITY_TYPES, z as AccessibilityMeta, D as AuthoringObjectState, B as BoothObject, p as Category, E as ChartLayoutConstraint, a as ChartObject, o as ChartReferenceImage, H as ChartTheme, I as ConfidenceEvidenceScope, u as CubicPath, J as DecorImageObject, m as Floor, G as GAAreaObject, h as GAInventorySegment, K as LABEL_STYLE_MAX_SIZE, M as LABEL_STYLE_MIN_SIZE, N as LabelPresentation, L as LabelStyle, O as ObjectEditorState, Q as Physical3dEvidence, U as RadialClearanceLayoutConstraint, n as RectTableSeatCounts, l as RectTableSide, V as ReferenceAccessibilitySource, W as ReferenceCalibration, X as ReferenceCategorySource, Y as ReferenceDerivedScale, Z as ReferenceDirectAnnotationSource, _ as ReferenceDirectLandmarkCandidate, $ as ReferenceDirectLandmarkDisposition, a0 as ReferenceDirectLandmarkRole, a1 as ReferenceDirectLandmarkSource, a2 as ReferenceDirectSeatGroup, a3 as ReferenceDirectSeatImportSource, a4 as ReferenceDirectSeatPlan, a5 as ReferenceDirectStageSource, a6 as ReferenceEnrichmentStatus, a7 as ReferenceExtractEmptyReason, a8 as ReferenceExtractEnrichment, a9 as ReferenceExtractInput, aa as ReferenceExtractProposal, ab as ReferenceExtractRegionSeats, ac as ReferenceInventoryExclusionSource, ad as ReferenceInventorySource, ae as ReferenceMatchReport, af as ReferenceScanProposal, ag as ReferenceScanRowProposal, ah as ReferenceScanSectionProposal, ai as ReferenceSeatSeed, aj as ReferenceSectionTraceBatchInput, ak as ReferenceSectionTraceBatchProposal, al as ReferenceSectionTraceInput, am as ReferenceSectionTraceProposal, c as ResolvedSeatConfidenceEvidence, R as RowObject, an as SEAT_COMMERCIAL_MARKS, ao as STAGE_LABEL_STYLE_MAX_SIZE, ap as SURROUNDINGS_SHAPE_ROLES, aq as SeatCommercialMark, ar as SeatCommercialMeta, as as SeatConfidenceCoverage, at as SeatConfidenceEvidence, au as SeatConfidenceModelLevel, av as SeatConfidenceModeledTarget, aw as SeatConfidenceRealityLevel, d as SeatGlyphKind, k as SeatOverride, e as SeatViewCoverage, b as SeatViewMetadata, ax as SeatViewVariant, j as SectionObject, f as SectionOutlinePath, g as SectionPathSegment, ay as SelectionLayer, q as ShapeLineCap, r as ShapeLineEnding, s as ShapeLineJoin, t as ShapeObject, az as StageLabelStyle, T as TableObject, aA as TextAlignment, aB as TextBackground, v as TextObject, aC as TicketTierApplicability, aD as TicketTierEvidence, aE as TicketTierRestriction, aF as Venue3DMaterialPalette, aG as VenueSurveyRegistrationEvidence, aH as ZoneDef, aI as accessibilityMeta, aJ as accessibilityRingColor, aK as layerOf, aL as seatCommercialMeta } from './types-Dq-ipTBG.js';
+import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-71rHjKl7.js';
+export { d as EVENT_CONFIGURATION_EXPORT_SCHEMA, e as EVENT_CONFIGURATION_SCHEMA, f as EventConfigurationBaseVenue, g as EventConfigurationCompatibilityIssue, h as EventConfigurationCompatibilityIssueCode, i as EventConfigurationCompatibilityResult, j as EventConfigurationExportEnvelope, k as EventConfigurationLifecycleStatus, a as EventConfigurationOcclusion, l as EventConfigurationOverlay, m as EventConfigurationParseIssue, n as EventConfigurationParseIssueCode, o as EventConfigurationParseResult, p as EventConfigurationProductionElement, E as EventConfigurationProductionElementKind, q as EventConfigurationVenueSnapshot, r as EventConfigurationVersionParseResult, s as EventConfigurationVersionSummary, L as LegacyEventConfigurationMigrationResult, t as canTransitionEventConfiguration, u as canonicalEventConfigurationJson, v as inspectEventConfigurationCompatibility, w as migrateLegacyEventConfigurations, x as parseEventConfigurationExport, y as parseEventConfigurationVersion, z as resolveEventConfigurationRollback } from './eventConfigurations-71rHjKl7.js';
+export { A as AUTOMATIC_ROUND_TABLE_RADIUS_MAX, a as AUTOMATIC_ROUND_TABLE_RADIUS_MIN, C as ChartBoundsOptions, E as ExpandChartOptions, F as FLOOR_STACK_GAP_RATIO, b as FLOOR_STACK_MIN_SURFACE_PX, c as FloorStackOptions, d as FloorStackPlacement, R as RowSeatSlot, T as TABLE_SEAT_OFFSET, e as TableSeatSlot, f as allObjects, g as automaticRoundTableRadius, h as chartBounds, i as expandBooth, j as expandChart, k as expandRow, l as expandRowSlots, m as expandTable, n as expandTableSlots, o as floorObjects, p as floorStackPlacements, q as floorsOf, r as initialFloorMode, s as layoutFloorStack, t as mainFloorId, u as objectCenter, v as owningSectionForObject, w as pointInPolygon, x as pointInPolygonWithHoles, y as polygonLabelPoint, z as rowInventoryCount, B as rowSeatPositions, D as stackFloors, G as tableInventoryCount, H as tableSeatCountsBySide, I as translateObject } from './tableSizing-B0JegL6B.js';
+import { c as TicketSelectionIssue } from './ticketRestrictions-Bp7ET0j4.js';
+export { M as MAX_EVENT_INVENTORY, a as MAX_GA_CAPACITY, g as gaAreasOf, h as gaInventorySegments, i as gaUnitLabel, j as gaUnitLabels, k as growJoinedGAInventory, l as isGaUnitLabel, v as validGAInventorySegments } from './ticketRestrictions-Bp7ET0j4.js';
+export { A as AvailabilityRule, S as SectionNode, T as TIER_HEIGHT_M, U as UNGROUPED_ID, a as applyHidden, c as computeSections, h as hiddenObjectIds, i as isSectionHidden, s as sectionGeometry } from './sections-F6wMlVqx.js';
+export { M as MIN_POINTER_TARGET_PX, R as RENDERED_QUALITY_REPORT_VERSION, a as RenderedEvidenceState, b as RenderedQualityFinding, c as RenderedQualityFindingCode, d as RenderedQualityReport, e as RenderedQualitySample, i as inspectRenderedQualityEvidence } from './renderedQuality-DN8SFFjk.js';
+import { I as ISeatmapRenderer, b as RendererOptions, S as SeatStatus, c as SeatMark, E as ExpandedSeat, G as GAAreaState, d as RendererViewMode, e as RendererMinimapSnapshot, L as LodRung, R as RendererQualityEvidence, f as RendererCallbacks } from './renderer-ByLmyQe_.js';
+export { C as CHART_STORAGE_KEY, g as RenderedBookableLabelEvidence, a as RenderedFreeTextEvidence, h as RenderedGAAreaEvidence, i as RenderedHierarchyLabelEvidence, j as RenderedLabelHiddenReason, k as RenderedRowLabelEvidence, l as RendererHoverDetails, m as RendererMinimapSeat, n as RendererMinimapSection, o as SeatMarkKind } from './renderer-ByLmyQe_.js';
+import './segmentedRowModel-D-CEgxg7.js';
 
 /**
  * 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;
@@ -206,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. */
@@ -624,48 +651,22 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setGAStates(states: Record<string, GAAreaState>): void;
     setGAState(areaId: string, state: GAAreaState): void;
     /**
-     * Take the buyer to the seats a price band left them (owner rule, 2026-09-03).
-     *
-     * Cluster the matches, then answer the question their SHAPE asks:
-     *
-     * - **One contiguous block** (and, on a sectioned chart, one section) — dive
-     *   into it, to the depth where its seats are both pickable and numbered.
-     *   Nothing to choose between, so showing it from far away only costs a tap.
-     *   This also closes the dead zone the validator found: a 30-seat band framed
-     *   at ~1.35 has 24px markers and NOT ONE number, the chart's authored 7-unit
-     *   font rendering at 9.5px against a 12px floor — `minScale` re-asks that.
-     * - **Several blocks** — frame the union so every block is on screen, diving
-     *   into none. Mobile audit finding 6: a phone price chip teleported into a
-     *   close-up of the dominant block, answering "where are the $42 seats?" with
-     *   a handful and no sign there were more. The buyer picks; the tap dives.
-     *
-     * `null`/empty keeps the camera exactly where it is: clearing a band removes
-     * a constraint, and re-fitting the venue threw away the buyer's own zoom.
+     * 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
@@ -853,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
@@ -939,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;
@@ -1084,6 +1098,7 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     }, opts?: {
         animate?: boolean;
         minScale?: number;
+        maxScale?: number;
         durationMs?: number;
     }): void;
     /**
@@ -1183,16 +1198,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
 }
 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.
@@ -1217,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.
  *
@@ -1611,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. */
@@ -1729,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.
      *
@@ -1893,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;
@@ -1936,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;
@@ -2227,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
@@ -2304,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: {
@@ -2343,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. */
@@ -2357,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;
@@ -2410,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;
@@ -2459,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;
@@ -2739,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 };