@seatlayer/core 0.81.0 → 0.83.0

package/dist/index.d.cts

@@ -1,15 +1,81 @@
-import { C as ChartDoc, F as FloorLabelStyle, P as Point, A as AccessibilityType, j as CategoryTier, S as SeatCommercialAttributes, w as ChartDeliveryPerformance } from './types-9TsSrYGB.cjs';
-export { x as ACCESSIBILITY_RING_COLOR, y as ACCESSIBILITY_TYPES, z as AccessibilityMeta, D as AuthoringObjectState, B as BoothObject, p as Category, E as ChartLayoutConstraint, a as ChartObject, o as ChartReferenceImage, H as ChartTheme, I as ConfidenceEvidenceScope, u as CubicPath, J as DecorImageObject, m as Floor, G as GAAreaObject, i as GAInventorySegment, K as LABEL_STYLE_MAX_SIZE, M as LABEL_STYLE_MIN_SIZE, N as LabelPresentation, L as LabelStyle, O as ObjectEditorState, Q as Physical3dEvidence, U as RadialClearanceLayoutConstraint, n as RectTableSeatCounts, l as RectTableSide, V as ReferenceAccessibilitySource, W as ReferenceCalibration, X as ReferenceCategorySource, Y as ReferenceDerivedScale, Z as ReferenceDirectAnnotationSource, _ as ReferenceDirectLandmarkCandidate, $ as ReferenceDirectLandmarkDisposition, a0 as ReferenceDirectLandmarkRole, a1 as ReferenceDirectLandmarkSource, a2 as ReferenceDirectSeatGroup, a3 as ReferenceDirectSeatImportSource, a4 as ReferenceDirectSeatPlan, a5 as ReferenceDirectStageSource, a6 as ReferenceEnrichmentStatus, a7 as ReferenceExtractEmptyReason, a8 as ReferenceExtractEnrichment, a9 as ReferenceExtractInput, aa as ReferenceExtractProposal, ab as ReferenceExtractRegionSeats, ac as ReferenceInventoryExclusionSource, ad as ReferenceInventorySource, ae as ReferenceMatchReport, af as ReferenceScanProposal, ag as ReferenceScanRowProposal, ah as ReferenceScanSectionProposal, ai as ReferenceSeatSeed, aj as ReferenceSectionTraceBatchInput, ak as ReferenceSectionTraceBatchProposal, al as ReferenceSectionTraceInput, am as ReferenceSectionTraceProposal, c as ResolvedSeatConfidenceEvidence, R as RowObject, an as SEAT_COMMERCIAL_MARKS, ao as STAGE_LABEL_STYLE_MAX_SIZE, ap as SURROUNDINGS_SHAPE_ROLES, aq as SeatCommercialMark, ar as SeatCommercialMeta, as as SeatConfidenceCoverage, at as SeatConfidenceEvidence, au as SeatConfidenceModelLevel, av as SeatConfidenceModeledTarget, aw as SeatConfidenceRealityLevel, d as SeatGlyphKind, k as SeatOverride, e as SeatViewCoverage, b as SeatViewMetadata, ax as SeatViewVariant, h as SectionObject, f as SectionOutlinePath, g as SectionPathSegment, ay as SelectionLayer, q as ShapeLineCap, r as ShapeLineEnding, s as ShapeLineJoin, t as ShapeObject, az as StageLabelStyle, T as TableObject, aA as TextAlignment, aB as TextBackground, v as TextObject, aC as TicketTierApplicability, aD as TicketTierEvidence, aE as TicketTierRestriction, aF as Venue3DMaterialPalette, aG as VenueSurveyRegistrationEvidence, aH as ZoneDef, aI as accessibilityMeta, aJ as accessibilityRingColor, aK as layerOf, aL as seatCommercialMeta } from './types-9TsSrYGB.cjs';
-import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-DaOxuIpn.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-DaOxuIpn.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-amFdMq3T.cjs';
-import { g as TicketSelectionIssue, b as GroupedTableInventoryUnit } from './ticketRestrictions-D3Euerz2.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-D3Euerz2.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-LFcH15oQ.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-BLLTXbOO.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-DCfWXUcm.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-DCfWXUcm.cjs';
-import './segmentedRowModel-DQylOwZU.cjs';
+import { A as AccessibilityType, b as SeatCommercialAttributes, C as ChartDoc, F as FloorLabelStyle, P as Point, k as CategoryTier, x as ChartDeliveryPerformance } from './types-CF7_htTi.cjs';
+export { y as ACCESSIBILITY_RING_COLOR, z as ACCESSIBILITY_TYPES, D as AccessibilityMeta, E as AuthoringObjectState, B as BoothObject, q as Category, H as ChartLayoutConstraint, a as ChartObject, p as ChartReferenceImage, I as ChartTheme, J as ConfidenceEvidenceScope, v as CubicPath, K as DecorImageObject, n as Floor, G as GAAreaObject, j as GAInventorySegment, M as LABEL_STYLE_MAX_SIZE, N as LABEL_STYLE_MIN_SIZE, O as LabelPresentation, L as LabelStyle, Q as ObjectEditorState, U as Physical3dEvidence, V as RadialClearanceLayoutConstraint, o as RectTableSeatCounts, m as RectTableSide, W as ReferenceAccessibilitySource, X as ReferenceCalibration, Y as ReferenceCategorySource, Z as ReferenceDerivedScale, _ as ReferenceDirectAnnotationSource, $ as ReferenceDirectLandmarkCandidate, a0 as ReferenceDirectLandmarkDisposition, a1 as ReferenceDirectLandmarkRole, a2 as ReferenceDirectLandmarkSource, a3 as ReferenceDirectSeatGroup, a4 as ReferenceDirectSeatImportSource, a5 as ReferenceDirectSeatPlan, a6 as ReferenceDirectStageSource, a7 as ReferenceEnrichmentStatus, a8 as ReferenceExtractEmptyReason, a9 as ReferenceExtractEnrichment, aa as ReferenceExtractInput, ab as ReferenceExtractProposal, ac as ReferenceExtractRegionSeats, ad as ReferenceInventoryExclusionSource, ae as ReferenceInventorySource, af as ReferenceMatchReport, ag as ReferenceScanProposal, ah as ReferenceScanRowProposal, ai as ReferenceScanSectionProposal, aj as ReferenceSeatSeed, ak as ReferenceSectionTraceBatchInput, al as ReferenceSectionTraceBatchProposal, am as ReferenceSectionTraceInput, an as ReferenceSectionTraceProposal, d as ResolvedSeatConfidenceEvidence, R as RowObject, ao as SEAT_COMMERCIAL_MARKS, ap as STAGE_LABEL_STYLE_MAX_SIZE, aq as SURROUNDINGS_SHAPE_ROLES, S as SeatCommercialMark, ar as SeatCommercialMeta, as as SeatConfidenceCoverage, at as SeatConfidenceEvidence, au as SeatConfidenceModelLevel, av as SeatConfidenceModeledTarget, aw as SeatConfidenceRealityLevel, e as SeatGlyphKind, l as SeatOverride, f as SeatViewCoverage, c as SeatViewMetadata, ax as SeatViewVariant, i as SectionObject, g as SectionOutlinePath, h as SectionPathSegment, ay as SelectionLayer, r as ShapeLineCap, s as ShapeLineEnding, t as ShapeLineJoin, u as ShapeObject, az as StageLabelStyle, T as TableObject, aA as TextAlignment, aB as TextBackground, w 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-CF7_htTi.cjs';
+import { c as EventConfigurationRef, b as EventConfigurationVersion } from './eventConfigurations-CwfetQY5.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-CwfetQY5.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 combinedFloorZoneId, j as expandBooth, k as expandChart, l as expandRow, m as expandRowSlots, n as expandTable, o as expandTableSlots, p as floorObjects, q as floorStackPlacements, r as floorsOf, s as initialFloorMode, t as layoutCombinedFloorPlan, u as layoutFloorStack, v as mainFloorId, w as objectCenter, x as owningSectionForObject, y as pointInPolygon, z as pointInPolygonWithHoles, B as polygonLabelPoint, D as rowInventoryCount, G as rowSeatPositions, H as stackFloors, I as tableInventoryCount, J as tableSeatCountsBySide, K as translateObject } from './tableSizing-Dp_GGrlh.cjs';
+import { g as TicketSelectionIssue, b as GroupedTableInventoryUnit } from './ticketRestrictions-CgpE7mdU.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-CgpE7mdU.cjs';
+export { S as SEAT_TYPE_ICON_BODY, a as SEAT_TYPE_ICON_VIEWBOX, b as SeatTypeIconKey, c as SeatTypeIconOptions, s as seatTypeIconBody, d as seatTypeIconSvg } from './seatTypeIcons-CKPTA_-Q.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-CMh0XgP2.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-BzTliRbk.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-C9TqalQD.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-C9TqalQD.cjs';
+import './segmentedRowModel-Cu6ojvdO.cjs';
+
+/**
+ * "Seat notes" — the ONE list of what a seat's per-seat attributes say.
+ *
+ * A seat can carry twelve accommodations, a wheelchair provision, three selling
+ * marks and an organizer's sentence, and until now every buyer surface decided
+ * for itself which of those to mention: the desktop hover card showed NONE, the
+ * tap card showed two lines (with restricted and obstructed collapsed into one,
+ * so a seat that was both told the buyer only half), the confirm card showed a
+ * different two, the cart chips showed a ♿ and a ◐, and the 3D caption showed a
+ * sentence. Five surfaces, five answers, one seat.
+ *
+ * So the ANSWER moved here, as a pure model, and the surfaces only render it.
+ * This module is deliberately i18n-free — it returns a key plus its English
+ * fallback rather than a translated string — because the engine and the widget
+ * reach their translator by different routes (`t` vs the widget's `tfStatic`)
+ * and a core module that imported one of them would drag a locale registry into
+ * the geometry layer.
+ */
+
+/** How a row should read: its tone is the surface's, its meaning is here. */
+type SeatNoteTone = 
+/** An accommodation or a wheelchair provision — a neutral, factual row. */
+'access'
+/** A view restriction. Surfaces give this the amber caution treatment. */
+ | 'warn'
+/** A premium seat — the gold tag. */
+ | 'premium'
+/** The organizer's own sentence, with no attribute of its own. */
+ | 'note';
+interface SeatNoteRow {
+    /** Stable identity for the row, for keying and for tests. */
+    key: string;
+    /** A key into `core/render-assets/seatTypeIcons`. Never markup: the widget
+     *  needs an SVG string and the hover card needs DOM, from the same row. */
+    icon: string;
+    /** i18n key for the row's title. */
+    titleKey: string;
+    /** The English wording, for surfaces whose translator takes a fallback. */
+    titleFallback: string;
+    tone: SeatNoteTone;
+    /** The organizer's free text, attached to the row it belongs to. Raw — every
+     *  caller escapes it, because it is the one buyer-visible authored string. */
+    note?: string;
+}
+interface SeatNoteInput {
+    accessibility?: AccessibilityType[];
+    wheelchairSpaceType?: 'seat-present' | 'no-seat';
+    commercial?: SeatCommercialAttributes;
+}
+/** The i18n key carrying an accommodation's buyer-facing name. */
+declare function accessibilityLabelKey(type: AccessibilityType): string;
+/**
+ * Every row a seat's attributes earn, in reading order.
+ *
+ * Order is fixed and is not discovery order: what the seat PROVIDES first
+ * (accommodations, then the physical wheelchair fact), then what a buyer should
+ * know before paying (restricted, obstructed, premium), then the organizer's
+ * own words. Two seats with the same attributes always produce the same list.
+ *
+ * Restricted and obstructed are SEPARATE rows. They used to collapse into one
+ * line with restricted winning, which meant a seat marked both told the buyer
+ * about a railing and never about the pillar.
+ */
+declare function seatNoteRowModel(input: SeatNoteInput): SeatNoteRow[];
 
 /**
  * Half-width of the band around a legibility threshold, in rendered pixels.
@@ -128,10 +194,9 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** 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`. */
+    /** Live seat-number 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. */
@@ -140,6 +205,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private fgDecorGroup;
     private seats;
     private seatById;
+    /** Every seat id in the canonical chart, including floors outside the current view. */
+    private canonicalSeatIds;
     /** One build per chart/floor; section membership queries only inspect seats in
      *  the section bounds instead of rescanning the full 13k venue per section. */
     private seatIndex;
@@ -200,6 +267,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Category order from the doc — the stable index into the CB palette. */
     private catOrder;
     private selection;
+    /** Selected seat records survive presentation rebuilds where seatById is view-scoped. */
+    private selectedSeatById;
     /** Seat-contained selection markers: outline + non-colour check cue. */
     private selectionMarkers;
     /** Selection markers, the pick moment and the touch loupe — see seatMoments. */
@@ -522,6 +591,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      *  as one rigid group for clarity; its authored internal topology is exact. */
     setFloorOverview(on: boolean): void;
     isFloorOverview(): boolean;
+    /** Separated levels use deck entry; a combined plan uses normal section detail. */
+    private get separatedFloorOverview();
     /** How the stacked view marks a level — see floorStack.ts. */
     setFloorLabelStyle(style: FloorLabelStyle): void;
     getFloorLabelStyle(): FloorLabelStyle;
@@ -603,6 +674,21 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * by the glide's very next frame anyway).
      */
     private focusSeat;
+    /** The locate ring's auto-dismiss, when one is armed. */
+    private focusRingLinger;
+    private clearFocusRingLinger;
+    /**
+     * Take the focus ring down without forgetting the seat it was on.
+     *
+     * The ring used to live until the seat left the cart or the chart changed,
+     * so a buyer who pressed a beacon, then zoomed and panned by hand, kept a
+     * blue dashed ring on one seat with no idea what it meant or how to clear it
+     * (owner, 2026-09-05). Any pointer on the map — a press, a drag, a pinch, a
+     * wheel — now clears it, as does the locate ring's own timer. `focusedId`
+     * is kept so keyboard navigation resumes from the same seat and raises the
+     * ring again itself.
+     */
+    private dismissFocusRing;
     /** Pan/zoom so a seat sits on-screen at a legible scale (for keyboard focus). */
     private ensureVisible;
     /** The host's own chrome over the canvas, in CSS px; `null` clears. Refits
@@ -807,21 +893,35 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     private buildAccessGlyph;
     /**
-     * Keep physical wheelchair provision readable in screen space at every map
-     * LOD. The active Wheelchair filter promotes it further. Iterates the small
-     * wheelchair-seat set, never the full node graph.
+     * Keep an accommodation's pictogram readable in screen space at every map
+     * LOD. An active filter for that accommodation promotes it further. Iterates
+     * the small accessible-seat set, never the full node graph.
      */
     private updateAccessGlyphs;
-    /** True only for a physical wheelchair provision matching an active buyer filter. */
+    /**
+     * True for an accessible seat the buyer's ACTIVE filter is actually asking
+     * for. The empty filter means "any accommodation", so every glyph is promoted
+     * then; a named filter promotes only the seats it selected, which is what
+     * makes a filtered result findable at venue-fit zoom.
+     */
     private accessGlyphFilterEmphasized;
     private accessGlyphShouldShow;
     /**
-     * Whether an accessible seat's glyph should show for its current status. It is
-     * hidden on seats a buyer cannot take (sold, or another buyer's hold) where the
-     * overlay status cue (diagonal mark / lock) carries the state instead — mirrors
-     * the `unavailable` test in {@link updateLabels} so the two never collide.
+     * The coloured accommodation ring follows the SAME availability gate as the
+     * glyph. A sold or foreign-held seat is one flat grey disc with nothing drawn
+     * on it (owner rule, 2026-09-05); a full-strength green ring on a grey disc
+     * was still advertising a step-free seat nobody could buy. The buyer's own
+     * hold keeps its ring — it is their seat, not generic unavailable grey.
      */
-    private accessGlyphEligible;
+    private accessRingShouldShow;
+    /**
+     * Whether an accessible seat's markers should show for its current status.
+     * They are hidden on seats a buyer cannot take (sold, or another buyer's
+     * hold) where the overlay status cue (diagonal mark / lock) carries the state
+     * instead — mirrors the `unavailable` test in {@link updateLabels} so the two
+     * never collide.
+     */
+    private accessMarkerEligible;
     /** A category's price as every map surface writes it — the loupe, and the
      *  sectionless overview pills. Currency formatting is the shared app rule
      *  (lib/money), never a per-surface one. Null when the category is unpriced. */
@@ -941,6 +1041,24 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * strategy, not a visual state — never use it to route a tap.
      */
     seatsRevealed(): boolean;
+    /**
+     * Is the camera standing exactly where "fit the whole venue" leaves it?
+     *
+     * The phone's one back-out button used to decide it had nowhere left to go
+     * from `seatsRevealed` alone, so any camera a pinch left BETWEEN the venue
+     * fit and the seats rung — blocks on screen, no seats yet — dimmed the
+     * button with the venue still not framed, and the buyer was stuck (owner
+     * report 2026-09-05). The honest answer is this one: only the fit pose
+     * itself is "done", and a camera anywhere else can always be brought home.
+     * Pose, not scale: a pan at the fit scale is still not the fit.
+     */
+    atVenueFit(): boolean;
+    /**
+     * Can a "+" press still move the camera? False only at the zoom ceiling —
+     * the same clamp `zoomAbout` applies — so a host's "+" dims exactly when a
+     * press would be a no-op, and never before.
+     */
+    canZoomIn(): boolean;
     /**
      * Can the buyer aim at a seat here? Asked in rendered pixels against the
      * pointer target, never in camera scale — see `seatPickableScale` in
@@ -1062,11 +1180,37 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
         x: number;
         y: number;
     }): string | null;
+    /**
+     * Is there ANY chart geometry under this container-relative screen point?
+     *
+     * The one question "empty canvas is inert" (owner, 2026-09-06) rests on. The
+     * buyer tap ladder used to end in two zoom rungs that fired on whatever was
+     * pressed, so a press on the black ground between two blocks glided the
+     * camera into blank canvas and lost the buyer. The ladder now asks this
+     * first, and stops when the answer is no.
+     *
+     * It has to be the WHOLE chart, not just the section outlines: "no section
+     * here" is not "nothing here". A sectioned chart may also carry GA areas,
+     * rows authored outside every block, booths and tables (both are seats once
+     * expanded), the buyer's own marks, an owned-count badge, and — in the
+     * stacked 3D overview — a deck. Missing one of those would make real
+     * inventory untappable, which is a worse bug than the one being fixed, so
+     * every hit-test the tap ladder can act on is represented here.
+     *
+     * Seats get {@link SEAT_TAP_SLOP_PX} of slop, the same fingertip allowance
+     * the near-miss rescue uses, so a press just off a loose row still counts as
+     * landing on it. The two seat sweeps are last because they are the only
+     * linear passes over the whole seat list; everything above them answers off a
+     * handful of outlines, so the common "pressed a block" case never pays for
+     * them. Nothing here runs per frame — only on a press that missed a section.
+     */
+    pressLandsOnChart(clientPoint: {
+        x: number;
+        y: number;
+    }): boolean;
     /** 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?
      *
@@ -1107,6 +1251,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     private sectionBounds;
     private sectionFrameScale;
+    /** Screen-space room for the largest row marker owned by one focused section. */
+    private focusedRowLabelGutter;
     /** Deck under the pointer in the 3D stacked overview — see screenPicking. */
     private deckFloorAt;
     /** Nearest selectable seat within `slopPx` of a screen point, or null. */
@@ -1145,6 +1291,7 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
         minScale?: number;
         maxScale?: number;
         durationMs?: number;
+        focusPaddingPx?: number;
     }): void;
     /**
      * Record this pass's label decision and ease the layer in when it turns on.
@@ -1528,10 +1675,11 @@ interface SectionCategory {
     label: string;
     color: string;
     /** Cheapest ticket choice in this category. `price` remains this value for
-     * source compatibility with existing SDK hosts. */
-    price: number;
-    priceMin: number;
-    priceMax: number;
+     * source compatibility with existing SDK hosts. Absent when the chart has no
+     * authored price for this category. */
+    price?: number;
+    priceMin?: number;
+    priceMax?: number;
     count: number;
 }
 /**
@@ -1545,6 +1693,8 @@ interface SectionSummary {
     label: string;
     /** Zone label (from ChartDoc.zones); '' when the section has no zone. */
     zoneLabel: string;
+    /** Physical level containing this section, when the venue has named floors. */
+    floorLabel?: string;
     /** Buyer-facing entrance/door hint ("Entrance X"); absent when unset. */
     entrance?: string;
     /**
@@ -1564,8 +1714,10 @@ interface SectionSummary {
      * the filter's absence as an absence of provision.
      */
     accessibleLeft?: number;
-    priceMin: number;
-    priceMax: number;
+    /** Authored price range across this section. Absent when none of its ticket
+     * categories has a price; zero remains a valid free price. */
+    priceMin?: number;
+    priceMax?: number;
     /** Per-category breakdown, cheapest first. */
     categories: SectionCategory[];
 }
@@ -2469,6 +2621,11 @@ declare class PickerController {
      *  half-melt scale). Drives the widget's "deep" state — the cache-based seats
      *  rung flips at a scale where the chart still reads as section blocks. */
     seatsRevealed(): boolean;
+    /** Is the camera exactly at the whole-venue fit? Undefined when the renderer
+     *  cannot say, so a caller can fall back to a coarser reading. */
+    atVenueFit(): boolean | undefined;
+    /** Can "+" still move the camera? Undefined when the renderer cannot say. */
+    canZoomIn(): boolean | undefined;
     /** Jump to a rung; ZONES clears any focused summary (back to overview). */
     setRung(rung: LodRung): void;
     /** Price-band filter (F4): dim free seats whose category is outside `keys`
@@ -2977,4 +3134,4 @@ declare function formatMinor(minor: number, currency?: string, locale?: string):
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-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 };
+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, type SeatNoteInput, type SeatNoteRow, type SeatNoteTone, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionSummary, TRANSLATED_LOCALES, type TableSelectionDetails, accessNeedsFor, accessibilityLabelKey, attachVisibilityCatchUp, compactRowLabel, createRenderer, crossesThreshold, currencyExponent, currencySymbol, formatDate, formatMinor, formatMoney, fromMinorUnits, generateSeatPanorama, generateSeatThumb, getLocale, holdHasLapsed, holdRecoveryShape, hysteresisScale, isLocaleLoaded, loadLocale, localeDirection, reconcileAvailability, refreshChangedSomething, renderedPx, resolveLocale, seatNoteRowModel, setLocale, setMoneyLocale, setStringOverrides, shouldWaitForHoldExpiry, t, tCount, zoomTowardPoint };