@seatlayer/core 0.52.0 → 0.54.0

package/dist/{types-tLOunI-B.d.cts → types-COfJorq_.d.cts}

@@ -1,3 +1,233 @@
+/** Durable publishing-review evidence for an editable physical 3D property. */
+interface Physical3dEvidence {
+    status: 'inferred' | 'confirmed';
+    source: 'public-2d-topology' | 'user-review';
+    note: string;
+}
+interface ReferenceCalibration {
+    type: 'two-point';
+    /** Points in immutable source-image pixels, selected by a human or trusted detector. */
+    sourceA: Point;
+    sourceB: Point;
+    /** Verified real-world distance between the two source points. */
+    distance: number;
+    unit: 'm' | 'ft' | 'chart-unit';
+    /** Derived and stored for deterministic geometry compilers. */
+    pixelsPerUnit: number;
+}
+/**
+ * A single human-placed seat probe: the author clicks one seat on the reference
+ * image and the server reads the surrounding seat lattice from it.
+ *
+ * COORDINATE-POLICY CARVE-OUT (owner decision 2026-07-21). The reference
+ * blueprint pipeline runs `coordinatePolicy: 'opaque-region-ids-only'` — the
+ * server is the sole source of chart coordinates and MCP clients select opaque
+ * `reg_*` ids, never points. This type is a deliberate, narrow exception on the
+ * same grounds as `ReferenceCalibration`: the point is placed by a human in the
+ * designer canvas, not proposed by a model.
+ *
+ * Therefore this is DESIGNER-ONLY and is intentionally NOT exposed over MCP.
+ * That is an accepted, documented exception to the MCP-parity rule — the
+ * server-is-sole-source guarantee for model-driven edits is worth more than
+ * parity here. Do not "fix" it by adding a seed point to an MCP tool schema.
+ */
+interface ReferenceSeatSeed {
+    /** Seed centre in immutable source-image pixels (never chart coordinates). */
+    source: Point;
+    /** Half-width of the author's sizing ring, in source pixels — the "this is how
+     *  big one seat is" hint that replaces seats.io's zoom-until-it-matches step. */
+    radius: number;
+    /** Whether `radius` was fitted from image pixels or set by hand. Detection
+     *  weights an author-set radius more heavily than one we guessed. */
+    origin: 'auto-fit' | 'manual';
+}
+/** One detected row in a scan proposal — a straight seat run in CHART
+ *  coordinates (the server maps source pixels through referencePixelToChart;
+ *  clients never see source-pixel geometry back). */
+interface ReferenceScanRowProposal {
+    start: Point;
+    end: Point;
+    seatCount: number;
+}
+/** Detected rows attributed to one compiled section (or unattributed when the
+ *  lattice extends outside every compiled polygon). */
+interface ReferenceScanSectionProposal {
+    /** Id of the compiled SectionObject the rows landed in; null = unattributed. */
+    sectionId: string | null;
+    name: string;
+    rows: ReferenceScanRowProposal[];
+    seatCount: number;
+    /** 0..1 — how well this section's lattice agreed with the probe's pitch. */
+    confidence: number;
+    /** Index of the seed (multi-probe) whose pitch produced these rows. */
+    seedIndex: number;
+}
+/** Server response for an in-canvas reference scan. A PROPOSAL — nothing is
+ *  committed until the author applies it in the designer (chartOps + undo). */
+interface ReferenceScanProposal {
+    assetId: string;
+    /** Measured seat diameter / centre-to-centre pitch, in chart units. */
+    seatDiameter: number;
+    seatPitch: number;
+    totalSeats: number;
+    totalRows: number;
+    sections: ReferenceScanSectionProposal[];
+}
+/**
+ * Human-only Magic Trace request. `source` is one click in immutable
+ * source-image pixels; it is accepted only by the browser Designer HTTP
+ * surfaces and must never be added to an MCP schema.
+ */
+interface ReferenceSectionTraceInput {
+    assetId: string;
+    floorId?: string;
+    expectedUpdatedAt: number;
+    source: Point;
+}
+/**
+ * Whole-reference Magic Trace request. Unlike the one-region request this
+ * carries no source coordinates: the server returns every persisted closed
+ * region as an ID-free proposal for explicit browser review.
+ */
+interface ReferenceSectionTraceBatchInput {
+    assetId: string;
+    floorId?: string;
+    expectedUpdatedAt: number;
+}
+/**
+ * Read-only Magic Trace result. This is deliberately not a SectionObject:
+ * there is no object id or label until the author accepts the proposal through
+ * the normal Designer command/undo boundary.
+ *
+ * All geometry is in chart coordinates. Source pixels, private contour
+ * vertices and reference bounds are never returned.
+ */
+interface ReferenceSectionTraceProposal {
+    assetId: string;
+    floorId: string;
+    outline: Point[];
+    /** Required exact fitted line/arc/cubic boundary. */
+    outlinePath: SectionOutlinePath;
+    /** Only structural source voids; printed labels/icons are filtered out. */
+    holes: Point[][];
+    /**
+     * Optional, and the tracer deliberately omits it. The colour a section is
+     * drawn in belongs to the CHART, not to the screenshot it was traced from —
+     * see the note in `referenceSectionTrace.ts`. The sampled value lives on the
+     * region row as `sampled_color`. Consumers fall back to zone/theme colour.
+     */
+    color?: string;
+    referenceSource: {
+        assetId: string;
+        regionId: string;
+    };
+    geometry: {
+        kind: 'contour';
+        sourceRegionId: string;
+        contourMethod: 'shared-edge-vector-fit-v1';
+        simplificationTolerancePx: number;
+        vectorFitErrorPx: number;
+        sharedEdgeCount: number;
+    };
+    provenance: {
+        regionId: string;
+        analysisVersion: number;
+        vectorTopologyVersion: number;
+        selection: 'human-source-pixel-seed' | 'human-bulk-reference-review';
+        registration: 'persisted-reference-registration-v1';
+    };
+    /** Coordinate-free evidence suitable for an author-facing confirmation. */
+    diagnostics: {
+        regionMarker: string;
+        structuralHoleCount: number;
+        fittedComponentCount: number;
+        sharedBoundaryCount: number;
+        maximumAllowedVectorErrorPx: number;
+        measuredVectorErrorPx: number;
+        /** Source component footprint, as a percentage of the analyzed image. */
+        sourceAreaPercent?: number;
+        /**
+         * The name already printed on the plan for this region, when one has been
+         * read. The review proposes it instead of a generated number — a venue plan
+         * names its own sections, and retyping forty of them is work the author
+         * should never have to do. Absent means fall back to numbering.
+         */
+        visibleLabel?: string;
+    };
+}
+/** Read-only whole-reference proposal. The author may approve each proposal or
+ * all proposals; the Designer then materializes the accepted set atomically. */
+interface ReferenceSectionTraceBatchProposal {
+    assetId: string;
+    floorId: string;
+    proposals: ReferenceSectionTraceProposal[];
+    diagnostics: {
+        analyzedRegionCount: number;
+        proposalCount: number;
+        alreadyTracedCount: number;
+        withinToleranceCount: number;
+        /** Regions that could not be traced into a usable boundary and were left
+         *  out. One unusable region must not cost the author the rest of the plan. */
+        unusableRegionCount?: number;
+    };
+}
+/** Coordinate-free physical scale derived by server code from a confirmed
+ * semantic feature. Unlike manual two-point calibration, no source points pass
+ * through an MCP client or language model. */
+interface ReferenceDerivedScale {
+    method: 'confirmed-focal-axis-v1';
+    feature: 'focal-long-axis' | 'focal-short-axis';
+    distance: number;
+    unit: 'm' | 'ft';
+    evidence: 'user-confirmed' | 'authoritative-source';
+    sourceDescription: string;
+    chartUnitsPerUnit: number;
+}
+interface ChartReferenceImage {
+    /** Stable private reference asset. New cloud-authored charts use this. */
+    assetId?: string;
+    /** Legacy/self-contained source. Optional when assetId is present. */
+    url?: string;
+    center: Point;
+    /** Rendered width in chart units (height follows the cropped image aspect). */
+    width: number;
+    opacity: number;
+    rotation?: number;
+    visible?: boolean;
+    layer?: 'below' | 'above';
+    locked?: boolean;
+    /** Normalized source crop; defaults to the full image. */
+    crop?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    calibration?: ReferenceCalibration;
+    /** Server-derived semantic calibration without source-image coordinates. */
+    derivedScale?: ReferenceDerivedScale;
+}
+/**
+ * Durable responsive-layout rule for a venue arranged around a focal object.
+ * Sections are rigid groups: their internal rows/seats never scale or deform;
+ * only each group's anchor moves radially when the focal footprint needs more
+ * room. Importers and authoring tools can rerun the same rule after a pitch,
+ * stage or court changes size, even for very large section counts.
+ */
+interface RadialClearanceLayoutConstraint {
+    id: string;
+    kind: 'radial-clearance-v1';
+    focalObjectIds: string[];
+    sectionIds: string[];
+    clearance: number;
+    movement: 'rigid-section-groups';
+    /** Last solved proportional expansion, retained as useful audit evidence. */
+    resolvedExpansion: number;
+    /** Focal center used for the last solve, allowing the authored ring to be reconstructed after edits. */
+    resolvedFocalCenter?: Point;
+}
+type ChartLayoutConstraint = RadialClearanceLayoutConstraint;
+
 /**
  * SeatMap chart document — the single source of truth shared by the
  * Designer (authoring) and the Renderer (buyer picker).
@@ -7,6 +237,7 @@
  * Rows are PARAMETRIC (origin + count + spacing + curve + rotation) — never
  * store per-seat coordinates in the document; expansion happens in layout.ts.
  */
+
 interface Point {
     x: number;
     y: number;
@@ -1102,235 +1333,7 @@ interface Floor {
     /** Floor-scoped confidence evidence inherited before the venue default. */
     confidenceEvidence?: SeatConfidenceEvidence;
 }
-/** Durable publishing-review evidence for an editable physical 3D property. */
-interface Physical3dEvidence {
-    status: 'inferred' | 'confirmed';
-    source: 'public-2d-topology' | 'user-review';
-    note: string;
-}
-interface ReferenceCalibration {
-    type: 'two-point';
-    /** Points in immutable source-image pixels, selected by a human or trusted detector. */
-    sourceA: Point;
-    sourceB: Point;
-    /** Verified real-world distance between the two source points. */
-    distance: number;
-    unit: 'm' | 'ft' | 'chart-unit';
-    /** Derived and stored for deterministic geometry compilers. */
-    pixelsPerUnit: number;
-}
-/**
- * A single human-placed seat probe: the author clicks one seat on the reference
- * image and the server reads the surrounding seat lattice from it.
- *
- * COORDINATE-POLICY CARVE-OUT (owner decision 2026-07-21). The reference
- * blueprint pipeline runs `coordinatePolicy: 'opaque-region-ids-only'` — the
- * server is the sole source of chart coordinates and MCP clients select opaque
- * `reg_*` ids, never points. This type is a deliberate, narrow exception on the
- * same grounds as `ReferenceCalibration`: the point is placed by a human in the
- * designer canvas, not proposed by a model.
- *
- * Therefore this is DESIGNER-ONLY and is intentionally NOT exposed over MCP.
- * That is an accepted, documented exception to the MCP-parity rule — the
- * server-is-sole-source guarantee for model-driven edits is worth more than
- * parity here. Do not "fix" it by adding a seed point to an MCP tool schema.
- */
-interface ReferenceSeatSeed {
-    /** Seed centre in immutable source-image pixels (never chart coordinates). */
-    source: Point;
-    /** Half-width of the author's sizing ring, in source pixels — the "this is how
-     *  big one seat is" hint that replaces seats.io's zoom-until-it-matches step. */
-    radius: number;
-    /** Whether `radius` was fitted from image pixels or set by hand. Detection
-     *  weights an author-set radius more heavily than one we guessed. */
-    origin: 'auto-fit' | 'manual';
-}
-/** One detected row in a scan proposal — a straight seat run in CHART
- *  coordinates (the server maps source pixels through referencePixelToChart;
- *  clients never see source-pixel geometry back). */
-interface ReferenceScanRowProposal {
-    start: Point;
-    end: Point;
-    seatCount: number;
-}
-/** Detected rows attributed to one compiled section (or unattributed when the
- *  lattice extends outside every compiled polygon). */
-interface ReferenceScanSectionProposal {
-    /** Id of the compiled SectionObject the rows landed in; null = unattributed. */
-    sectionId: string | null;
-    name: string;
-    rows: ReferenceScanRowProposal[];
-    seatCount: number;
-    /** 0..1 — how well this section's lattice agreed with the probe's pitch. */
-    confidence: number;
-    /** Index of the seed (multi-probe) whose pitch produced these rows. */
-    seedIndex: number;
-}
-/** Server response for an in-canvas reference scan. A PROPOSAL — nothing is
- *  committed until the author applies it in the designer (chartOps + undo). */
-interface ReferenceScanProposal {
-    assetId: string;
-    /** Measured seat diameter / centre-to-centre pitch, in chart units. */
-    seatDiameter: number;
-    seatPitch: number;
-    totalSeats: number;
-    totalRows: number;
-    sections: ReferenceScanSectionProposal[];
-}
-/**
- * Human-only Magic Trace request. `source` is one click in immutable
- * source-image pixels; it is accepted only by the browser Designer HTTP
- * surfaces and must never be added to an MCP schema.
- */
-interface ReferenceSectionTraceInput {
-    assetId: string;
-    floorId?: string;
-    expectedUpdatedAt: number;
-    source: Point;
-}
-/**
- * Whole-reference Magic Trace request. Unlike the one-region request this
- * carries no source coordinates: the server returns every persisted closed
- * region as an ID-free proposal for explicit browser review.
- */
-interface ReferenceSectionTraceBatchInput {
-    assetId: string;
-    floorId?: string;
-    expectedUpdatedAt: number;
-}
-/**
- * Read-only Magic Trace result. This is deliberately not a SectionObject:
- * there is no object id or label until the author accepts the proposal through
- * the normal Designer command/undo boundary.
- *
- * All geometry is in chart coordinates. Source pixels, private contour
- * vertices and reference bounds are never returned.
- */
-interface ReferenceSectionTraceProposal {
-    assetId: string;
-    floorId: string;
-    outline: Point[];
-    /** Required exact fitted line/arc/cubic boundary. */
-    outlinePath: SectionOutlinePath;
-    /** Only structural source voids; printed labels/icons are filtered out. */
-    holes: Point[][];
-    /**
-     * Optional, and the tracer deliberately omits it. The colour a section is
-     * drawn in belongs to the CHART, not to the screenshot it was traced from —
-     * see the note in `referenceSectionTrace.ts`. The sampled value lives on the
-     * region row as `sampled_color`. Consumers fall back to zone/theme colour.
-     */
-    color?: string;
-    referenceSource: {
-        assetId: string;
-        regionId: string;
-    };
-    geometry: {
-        kind: 'contour';
-        sourceRegionId: string;
-        contourMethod: 'shared-edge-vector-fit-v1';
-        simplificationTolerancePx: number;
-        vectorFitErrorPx: number;
-        sharedEdgeCount: number;
-    };
-    provenance: {
-        regionId: string;
-        analysisVersion: number;
-        vectorTopologyVersion: number;
-        selection: 'human-source-pixel-seed' | 'human-bulk-reference-review';
-        registration: 'persisted-reference-registration-v1';
-    };
-    /** Coordinate-free evidence suitable for an author-facing confirmation. */
-    diagnostics: {
-        regionMarker: string;
-        structuralHoleCount: number;
-        fittedComponentCount: number;
-        sharedBoundaryCount: number;
-        maximumAllowedVectorErrorPx: number;
-        measuredVectorErrorPx: number;
-        /** Source component footprint, as a percentage of the analyzed image. */
-        sourceAreaPercent?: number;
-        /**
-         * The name already printed on the plan for this region, when one has been
-         * read. The review proposes it instead of a generated number — a venue plan
-         * names its own sections, and retyping forty of them is work the author
-         * should never have to do. Absent means fall back to numbering.
-         */
-        visibleLabel?: string;
-    };
-}
-/** Read-only whole-reference proposal. The author may approve each proposal or
- * all proposals; the Designer then materializes the accepted set atomically. */
-interface ReferenceSectionTraceBatchProposal {
-    assetId: string;
-    floorId: string;
-    proposals: ReferenceSectionTraceProposal[];
-    diagnostics: {
-        analyzedRegionCount: number;
-        proposalCount: number;
-        alreadyTracedCount: number;
-        withinToleranceCount: number;
-        /** Regions that could not be traced into a usable boundary and were left
-         *  out. One unusable region must not cost the author the rest of the plan. */
-        unusableRegionCount?: number;
-    };
-}
-/** Coordinate-free physical scale derived by server code from a confirmed
- * semantic feature. Unlike manual two-point calibration, no source points pass
- * through an MCP client or language model. */
-interface ReferenceDerivedScale {
-    method: 'confirmed-focal-axis-v1';
-    feature: 'focal-long-axis' | 'focal-short-axis';
-    distance: number;
-    unit: 'm' | 'ft';
-    evidence: 'user-confirmed' | 'authoritative-source';
-    sourceDescription: string;
-    chartUnitsPerUnit: number;
-}
-interface ChartReferenceImage {
-    /** Stable private reference asset. New cloud-authored charts use this. */
-    assetId?: string;
-    /** Legacy/self-contained source. Optional when assetId is present. */
-    url?: string;
-    center: Point;
-    /** Rendered width in chart units (height follows the cropped image aspect). */
-    width: number;
-    opacity: number;
-    rotation?: number;
-    visible?: boolean;
-    layer?: 'below' | 'above';
-    locked?: boolean;
-    /** Normalized source crop; defaults to the full image. */
-    crop?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    calibration?: ReferenceCalibration;
-    /** Server-derived semantic calibration without source-image coordinates. */
-    derivedScale?: ReferenceDerivedScale;
-}
-/**
- * Durable responsive-layout rule for a venue arranged around a focal object.
- * Sections are rigid groups: their internal rows/seats never scale or deform;
- * only each group's anchor moves radially when the focal footprint needs more
- * room. Importers and authoring tools can rerun the same rule after a pitch,
- * stage or court changes size, even for very large section counts.
- */
-interface RadialClearanceLayoutConstraint {
-    id: string;
-    kind: 'radial-clearance-v1';
-    focalObjectIds: string[];
-    sectionIds: string[];
-    clearance: number;
-    movement: 'rigid-section-groups';
-    /** Last solved proportional expansion, retained as useful audit evidence. */
-    resolvedExpansion: number;
-    /** Focal center used for the last solve, allowing the authored ring to be reconstructed after edits. */
-    resolvedFocalCenter?: Point;
-}
-type ChartLayoutConstraint = RadialClearanceLayoutConstraint;
+
 interface ChartDoc {
     version: 1;
     name: string;
@@ -1380,532 +1383,5 @@ interface ChartDoc {
     /** Venue-scoped confidence evidence. It does not require panorama media. */
     confidenceEvidence?: SeatConfidenceEvidence;
 }
-interface ExpandedSeat {
-    /** Stable id: `${rowId}:${index}` */
-    id: string;
-    /** Public label: `${rowLabel}-${seatNumber}` */
-    label: string;
-    /** Buyer-facing copy; absent on legacy charts, where `label` is displayed. */
-    displayLabel?: string;
-    x: number;
-    y: number;
-    rowId: string;
-    /** Owning logical section and navigation zone, resolved once at expand time. */
-    sectionId?: string;
-    zoneId?: string;
-    /** Zone focal when authored, otherwise the active floor/chart legacy fallback. */
-    focalPoint?: Point;
-    /** Buyer-facing segmented-row identity. `rowId` stays the physical owner id. */
-    logicalRowId?: string;
-    /**
-     * Seat order inside the logical row. A deliberate missing integer is inserted
-     * at every aisle boundary, so numerical adjacency cannot bridge a gap.
-     */
-    logicalSeatIndex?: number;
-    categoryKey: string;
-    /** 'booth' units render as blocks (dimensions looked up via rowId = booth id). */
-    kind?: 'seat' | 'booth';
-    /** True when the seat has any accessibility accommodation — renderer rings/dims these. */
-    accessible?: boolean;
-    /** Specific accessibility accommodations (absent = none) — picker badges/filters these. */
-    accessibility?: AccessibilityType[];
-    /** Physical wheelchair provision resolved from the seat override. */
-    wheelchairSpaceType?: 'seat-present' | 'no-seat';
-    commercial?: SeatCommercialAttributes;
-    /** Organizer-supplied view-from-seat image (inherited from the row). */
-    viewUrl?: string;
-    /** Calibration/truth inherited from the same scope that supplied `viewUrl`. */
-    viewMeta?: SeatViewMetadata;
-    /** Closest configuration-valid evidence plus its engine-resolved coverage. */
-    confidenceEvidence?: ResolvedSeatConfidenceEvidence;
-    /** Per-seat label size/color override; absent = inherit the row/theme default. */
-    labelStyle?: LabelStyle;
-    /**
-     * Real-world eye height in metres above the focal/stage datum, resolved at
-     * expand time from the owning section's `{height, rake}` + drawn depth (Phase B2).
-     * Feeds the auto-360° generator's stage-pitch math. Absent ⇒ flat seated eye
-     * height (legacy / seats in no section) — so old charts stay pixel-identical.
-     */
-    eyeHeightM?: number;
-}
-type SeatStatus = 'free' | 'held' | 'booked' | 'not_for_sale';
-/** Buyer canvas projection. Perspective is a view-only projected-2.5D lane. */
-type RendererViewMode = 'flat' | 'isometric' | 'perspective';
-interface RendererCallbacks {
-    onSelect?: (seat: ExpandedSeat) => void;
-    onDeselect?: (seat: ExpandedSeat) => void;
-    /** Buyer tried to add a seat after the active selection cap was reached. */
-    onSelectionLimit?: (maxSelection: number) => void;
-    /** seat is null when the pointer leaves any seat. */
-    onHover?: (seat: ExpandedSeat | null) => void;
-    /** Keyboard focus moved to a seat (arrow-key navigation) — for screen-reader announcements. */
-    onFocusSeat?: (seat: ExpandedSeat | null) => void;
-    /** Called ~1×/sec with the measured frames-per-second. */
-    onFps?: (fps: number) => void;
-    /** Fired when a GA area is clicked (quantity picking is UI-side). */
-    onGAClick?: (areaId: string) => void;
-    /**
-     * Fired when a tap lands on a section outline while seats are NOT the active
-     * rung (i.e. zoomed out, section/zone LOD). The host glides in + shows a
-     * section-summary card instead of trying to select a 4px seat (Slice 5).
-     */
-    onSectionTap?: (sectionId: string) => void;
-    /**
-     * Fired when a seat/deck is tapped in the 3D all-floors stacked overview — the
-     * host drops back to the flat 2D map on that floor ("tap a deck to enter").
-     */
-    onDeckTap?: (floorId: string) => void;
-    /** Fired after any pan/zoom/resize settles — re-anchor screen-space overlays. */
-    onViewChange?: () => void;
-    /**
-     * Organizer manage-mode only (`manageMode` + `marqueeSelect`): fired on
-     * pointer-UP after a rubber-band marquee drag, or a ⌘A/Escape bulk shortcut,
-     * with the FULL current selection (selectable seats only). The host toolbar
-     * reads this to drive bulk block/unblock. Never fires when manageMode is off.
-     */
-    onMarquee?: (seats: ExpandedSeat[]) => void;
-}
-/** Far-zoom level-of-detail rung: whole zones → section blocks → individual seats. */
-type LodRung = 'zones' | 'sections' | 'seats';
-interface RendererOptions extends RendererCallbacks {
-    /**
-     * Internal fixed-output mode used by the free maker's PNG/PDF pipeline.
-     * It disables interaction, ResizeObserver, animation/FPS work and overview
-     * bitmap caching while keeping the ordinary buyer renderer unchanged.
-     */
-    exportMode?: boolean;
-    /** Max seats selectable at once (default 10). */
-    maxSelection?: number;
-    /**
-     * Buyer-surface fit refinement: on containers much taller than the venue's
-     * projection (phones in portrait), zoomToFit may zoom past the strict
-     * width-contain by a bounded amount (≤30%) so the venue is not a thin band
-     * in a dark field. The overflow crops equally on both sides and the buyer
-     * pans freely. Off for the designer and export pipeline, which must always
-     * show the complete chart.
-     */
-    portraitFitCrop?: boolean;
-    /** Only these statuses are clickable (default ['free']). */
-    selectableStatuses?: SeatStatus[];
-    /**
-     * Opt-in host behaviour flag — the renderer's own click/selection logic is
-     * unchanged (it still selects + fires `onSelect` immediately, so the seat
-     * highlights right away). When true, the host (e.g. PublicEventPage) treats
-     * that `onSelect` as a pending candidate and shows a confirm card instead of
-     * pushing straight into the cart; `deselect([seat.id])` on Cancel un-highlights.
-     */
-    confirmSelection?: boolean;
-    /** ISO 4217 currency for on-map prices ("FROM …"); defaults to money.DEFAULT_CURRENCY.
-     *  Locale for grouping/symbol placement comes from the active i18n locale. */
-    currency?: string;
-    /**
-     * Organizer manage surface (SDK SeatManager). Opt-in — enables the manage-mode
-     * gestures (marquee, ⌘A/Escape) and the bulk-selection helpers. Buyer pan /
-     * pinch / tap and every existing code path are byte-identical when this is
-     * false (every manage branch is gated on it). Default false.
-     */
-    manageMode?: boolean;
-    /**
-     * When `manageMode` is on, a mouse/pen primary-button drag at the seats rung
-     * draws a rubber-band marquee that bulk-selects the seats it covers (emitting
-     * `onMarquee` on pointer-up) instead of panning. Touch keeps single-finger
-     * pan (pinch to zoom); a middle-button drag pans with a mouse. Disabled below
-     * the seats rung (zoom in first). No effect unless `manageMode` is also set.
-     */
-    marqueeSelect?: boolean;
-}
-type RenderedLabelHiddenReason = 'below-minimum-size' | 'outside-viewport' | 'dimmed-or-unavailable' | 'clutter-or-fit' | 'renderer-hidden';
-/** Browser-renderer evidence used by visual QA and catalog release gates. */
-interface RenderedBookableLabelEvidence {
-    seatId: string;
-    label: string;
-    kind: 'seat' | 'booth';
-    /** Painted inventory silhouette. Empty wheelchair bays are deliberately
-     * square, while physical seats retain the ordinary circular marker. */
-    markerShape: 'circle' | 'square' | 'booth';
-    /** Physical wheelchair provision represented by this inventory unit. */
-    wheelchairSpaceType?: 'seat-present' | 'no-seat';
-    categoryKey: string;
-    sectionId?: string;
-    zoneId?: string;
-    status: SeatStatus;
-    selected: boolean;
-    visible: boolean;
-    renderedFontPx: number;
-    fill: string;
-    ink: string;
-    opacity: number;
-    /** Buyer-visible accessibility glyph evidence. Filter emphasis uses a
-     * screen-space minimum so wheelchair provision remains recognizable at fit. */
-    accessibilityMarker?: {
-        glyphVisible: boolean;
-        glyphWidthPx: number;
-        emphasizedByFilter: boolean;
-    };
-    /** Direct Konva shape bounds and the production near-miss rescue combined. */
-    pointerTarget: {
-        active: boolean;
-        directWidthPx: number;
-        directHeightPx: number;
-        effectiveMinimumPx: number;
-    };
-    /** Centre of the painted unit, even when its text is intentionally hidden. */
-    screenCenter: {
-        x: number;
-        y: number;
-    };
-    screenBox?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    hiddenReason?: RenderedLabelHiddenReason;
-}
-interface RenderedHierarchyLabelEvidence {
-    id: string;
-    kind: 'section' | 'zone';
-    role: 'name' | 'availability' | 'price';
-    label: string;
-    visible: boolean;
-    renderedFontPx: number;
-    opacity: number;
-    fill: string;
-    ink: string;
-    /** Independent geometric containment check for section-owned text. */
-    fitsContainer?: boolean;
-    screenBox?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-}
-interface RenderedFreeTextEvidence {
-    objectId: string;
-    kind: 'free-text' | 'stage' | 'table' | 'decor' | 'ga-label' | 'ga-capacity';
-    text: string;
-    visible: boolean;
-    renderedFontPx: number;
-    ink: string;
-    background: string;
-    opacity: number;
-    screenBox?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    hiddenReason?: 'below-minimum-size' | 'outside-viewport' | 'renderer-hidden';
-}
-interface RenderedRowLabelEvidence {
-    text: string;
-    visible: boolean;
-    renderedFontPx: number;
-    ink: string;
-    screenBox?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-}
-interface RenderedGAAreaEvidence {
-    areaId: string;
-    label: string;
-    capacity: number;
-    categoryKey: string;
-    /** Owning logical section when the rendered GA surface is section-contained. */
-    sectionId?: string;
-    visible: boolean;
-    interactive: boolean;
-    opacity: number;
-    fill: string;
-    effectiveBackground: string;
-    screenBox?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-}
-interface RendererQualityEvidence {
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Runtime projection actually used for the pixels and hit graph below. */
-    projection: RendererViewMode;
-    /** Phase-C proof metadata. Present only in the projected-2.5D lane. */
-    perspective?: {
-        model: 'pinhole-exact-seat-anchors';
-        sectionSurfaceModel: 'tangent-plane';
-        exactSeatAnchorCount: number;
-        depthSorted: true;
-    };
-    canvasBackground: string;
-    effectiveScale: number;
-    rung: LodRung;
-    minimumVisibleLabelPx: number;
-    totalLabelledBookableUnits: number;
-    visibleLabels: number;
-    hiddenLabels: number;
-    /** Seats/table-seats/booths plus the full GA capacity. */
-    totalBookableUnits: number;
-    selectionRingSeatIds: string[];
-    selectionRingColor: string;
-    focusedSectionId: string | null;
-    focusBackdropVisible: boolean;
-    categoryFilterKeys: string[] | null;
-    /** Exact scene-graph proof for the clean section-first overview contract. */
-    overviewStyle: {
-        visibleSectionShells: number;
-        categoryPaintedSectionShells: number;
-        visibleCategoryDetailOutlines: number;
-        visibleSectionRowHints: number;
-        visibleSectionAvailabilityLabels: number;
-        visibleSectionGADetails: number;
-    };
-    labels: RenderedBookableLabelEvidence[];
-    gaAreas: RenderedGAAreaEvidence[];
-    hierarchyLabels: RenderedHierarchyLabelEvidence[];
-    freeTextLabels: RenderedFreeTextEvidence[];
-    rowLabels: RenderedRowLabelEvidence[];
-}
-interface ISeatmapRenderer {
-    /** Replace the chart. Resets selection and statuses, zooms to fit.
-     *  `opts.floorId` picks which floor to render on a multi-floor chart (Batch 5). */
-    setChart(doc: ChartDoc, opts?: {
-        floorId?: string;
-    }): void;
-    /** Bulk status update; re-renders affected seats only. */
-    setStatus(seatIds: string[], status: SeatStatus): void;
-    /**
-     * Mark the active buyer's own held seats. They remain server-status `held`,
-     * but render with the buyer selection treatment instead of the anonymous
-     * unavailable treatment used for another buyer's hold.
-     */
-    setOwnedHold?(seatIds: string[] | null): void;
-    /**
-     * Mark one selected seat as the buyer's pending confirmation candidate.
-     * The candidate receives a strong focus halo while unrelated seats recede;
-     * pass null after Select/Cancel. This is visual only and never mutates the
-     * renderer selection.
-     */
-    setSelectionFocus?(seatId: string | null): void;
-    /**
-     * SYNCHRONOUS repaint that bypasses requestAnimationFrame. Konva's batchDraw()
-     * (used by setStatus and friends) schedules the actual paint on the next rAF
-     * tick, which Chrome throttles/pauses on hidden, backgrounded, or occluded
-     * tabs — so a seat-status delta updates the scene graph but the pixels never
-     * change until the tab is foregrounded again. forceDraw() paints the affected
-     * layers immediately (Layer.draw() is synchronous) and flushes any pending
-     * cache-debounce, so a caller (visibilitychange catch-up, or an opted-in
-     * always-live board) can guarantee the canvas reflects current state
-     * regardless of tab visibility. No-op difference in the foreground.
-     */
-    forceDraw(): void;
-    getStatus(seatId: string): SeatStatus;
-    getSelection(): ExpandedSeat[];
-    clearSelection(): void;
-    /** Update the buyer selection cap without rebuilding the chart or camera. */
-    setMaxSelection?(maxSelection: number): void;
-    /**
-     * Programmatically restore free seats (for example an Undo action). Added
-     * seats respect the active cap and do not reopen a confirmation popover.
-     */
-    select?(seatIds: string[]): ExpandedSeat[];
-    /**
-     * Dynamically update organizer-only interaction without rebuilding the
-     * renderer. No buyer surface calls this; every behavior remains gated by
-     * `manageMode` exactly as it is at construction time.
-     */
-    setManageInteraction?(options: {
-        manageMode: boolean;
-        marqueeSelect: boolean;
-        selectableStatuses: SeatStatus[];
-        maxSelection?: number;
-    }): void;
-    /** Organizer-only section heat overlay. Values are normalized 0..1. */
-    setSectionHeat?(scores: Record<string, number> | null): void;
-    /**
-     * Manage-mode bulk selection helpers (no-op / empty unless `manageMode`).
-     * They select the matching SELECTABLE seats (respecting `selectableStatuses`
-     * + closed sections), union with the current selection, and return the seats
-     * they added — the SDK SeatManager expands category/row/section picks to
-     * labels and drives one batched block/unblock from them.
-     */
-    selectAllSelectable?(): ExpandedSeat[];
-    selectByLabels?(labels: string[]): ExpandedSeat[];
-    /** Exact-render QA only: select one server-chosen unit without label ambiguity. */
-    setEvidenceSelection?(seatId: string): boolean;
-    /** Selectable seats belonging to a section OR zone id (no selection side-effect). */
-    getSelectableInSection?(sectionId: string): ExpandedSeat[];
-    /** Programmatic deselect of specific seats (e.g. chip × in the cart). */
-    deselect(seatIds: string[]): void;
-    /**
-     * Brief attention pulse on a seat (a ring that expands + fades once) — used to
-     * signal live activity, e.g. a seat "just taken" by another buyer via a WS
-     * delta. Purely visual; no state change. `color` overrides the default.
-     */
-    flashSeat(seatId: string, color?: string): void;
-    /**
-     * Brief organizer attention pulse around a whole section. This is a visual
-     * overlay only: it never changes section geometry, hit targets, selection, or
-     * the active camera. Useful for grouped realtime operations at venue overview.
-     */
-    flashSection?(sectionId: string, color?: string): void;
-    zoomToFit(): void;
-    /** Refit the active section when focused; otherwise frame the current floor/view. */
-    refitCurrentView?(): void;
-    /** Zoom in one step about the viewport center, clamped to the usual zoom bounds. */
-    zoomIn(): void;
-    /** Zoom out one step about the viewport center, clamped to the usual zoom bounds. */
-    zoomOut(): void;
-    /** Individually status-managed seats/table-seats/booths; excludes GA capacity. */
-    seatCount(): number;
-    /** Seats/table-seats/booths plus the full capacity of rendered GA areas. */
-    bookableCount(): number;
-    /**
-     * Maps a chart-space point (or a seat, by its x/y) to container-relative
-     * screen pixels, using the current stage scale/position. Lets host UI anchor
-     * DOM overlays (confirm card, tooltip) over a live seat and re-anchor them
-     * on `onViewChange`.
-     */
-    worldToScreen(point: Point): {
-        x: number;
-        y: number;
-    };
-    /** When on, dim non-accessible free seats so accessible seats stand out. */
-    setAccessibleFilter(on: boolean): void;
-    /**
-     * Dim free seats that lack ANY of these accessibility types. `null` clears the
-     * filter; `[]` means "any accessible seat" (same as setAccessibleFilter(true)).
-     */
-    setAccessibilityFilter(types: AccessibilityType[] | null): void;
-    /** Legend hover-highlight: dim free seats of other categories (null clears). */
-    setCategoryHighlight?(key: string | null): void;
-    /** Price-band filter (F4): dim free seats whose category is NOT in `keys`
-     *  (null clears). The widget resolves which categories fall in the band. */
-    setCategoryFilter?(keys: string[] | null): void;
-    /** Smoothly frame the currently available seats in these categories. `null`
-     *  returns to the full chart. Used after an explicit buyer price-filter action. */
-    focusCategories?(keys: string[] | null): void;
-    /** Dim the seats of these section/zone ids (organizer manager: held-back inventory). */
-    setDimmedSections?(ids: string[] | null): void;
-    /**
-     * Phase 2 event-level section states: mark these section/zone ids `closed` —
-     * flat grey block, seats greyed + not pickable, section stays rendered.
-     * `null`/empty clears. (Distinct from the buyer's applyHidden seat-strip.)
-     */
-    setClosedSections?(ids: string[] | null): void;
-    /**
-     * AXS section-focus: dim + desaturate every other section, draw a calm backdrop
-     * behind this section, and glide the camera to frame it. Seat-picking is gated
-     * until seats are large enough on screen (≥ LABEL_SCALE). Slice 5 / Phase 2 §4.
-     */
-    focusSection?(id: string): void;
-    /** Clear an AXS section focus (restore full-bowl brightness + drop backdrop). */
-    clearSectionFocus?(): void;
-    /** The currently AXS-focused section id, or null. */
-    getFocusedSection?(): string | null;
-    /** World-space rect currently visible in the viewport (minimap viewport frame). */
-    getVisibleWorldRect?(): {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    /** Axis-aligned world bounds of all seats + section outlines (minimap frame). */
-    getWorldBounds?(): {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    /** Current rendered (not raw-source) geometry for an interactive overview.
-     * Multi-floor overview transforms are already applied to these coordinates. */
-    getMinimapSnapshot?(): RendererMinimapSnapshot;
-    /** Pan without changing zoom so `point` becomes the viewport centre. */
-    panToWorld?(point: Point): void;
-    /**
-     * Colorblind-safe mode: category hues switch to an Okabe-Ito palette and
-     * booked seats render hollow (a non-color cue), so seat state never relies
-     * on hue alone. Off (the default) renders exactly as before.
-     */
-    setColorblindSafe?(on: boolean): void;
-    /**
-     * Switch the projection. `'flat'` = normal top-down; `'isometric'` = the
-     * legacy affine preview; `'perspective'` = projected 2.5D with exact pinhole
-     * seat anchors/native hit shapes and bounded per-section tangent surfaces.
-     * Purely visual — the chart is authored flat.
-     */
-    setViewMode?(mode: RendererViewMode): void;
-    /** Current projection (defaults to 'flat' when unimplemented). */
-    getViewMode?(): RendererViewMode;
-    /** Multi-floor (Batch 5): switch the shown floor; list floors; read the active id. */
-    setActiveFloor?(floorId: string): void;
-    getFloors?(): {
-        id: string;
-        name: string;
-    }[];
-    getActiveFloorId?(): string;
-    /** Render all floors stacked (3D overview) vs the active floor. No-op single-floor. */
-    setStacked?(on: boolean): void;
-    isStacked?(): boolean;
-    /** Render every floor in its authored 2D coordinates so the buyer can choose a level. */
-    setFloorOverview?(on: boolean): void;
-    isFloorOverview?(): boolean;
-    /**
-     * Section id whose outline contains a container-relative screen point (or null).
-     * Feeds the far-zoom "tap a section to zoom in" flow (Slice 5).
-     */
-    sectionAt?(clientPoint: Point): string | null;
-    /** Seat ids belonging to a section — for the section-summary card (Slice 5). */
-    sectionMembers?(id: string): string[];
-    /**
-     * Smoothly glide (pan+zoom) the camera to frame a section (by id) or a world-
-     * space bounds rect over a calm easeInOutCubic glide. `prefers-reduced-motion` snaps.
-     * A pointer-down (grab/pan) cancels an in-flight glide. Slice 5 "glide in".
-     */
-    focusRegion?(target: string | {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    }, opts?: {
-        animate?: boolean;
-        minScale?: number;
-        durationMs?: number;
-    }): void;
-    /** Current LOD rung derived from zoom (for the ZONES/SECTIONS/SEATS pill). */
-    getRung?(): LodRung;
-    /** Jump the camera to a rung's zoom band, centred on the chart (glided). */
-    setRung?(rung: LodRung): void;
-    /** Read actual browser-rendered label visibility, size, fill, ink and state.
-     *  Pure diagnostic: it never changes chart or renderer state. */
-    getRenderedQualityEvidence(): RendererQualityEvidence;
-    destroy(): void;
-}
-interface RendererMinimapSection {
-    id: string;
-    label: string;
-    outline: Point[];
-    floorId?: string;
-    state: 'selected' | 'available' | 'inactive';
-    active: boolean;
-}
-interface RendererMinimapSeat {
-    x: number;
-    y: number;
-    categoryKey: string;
-    state: 'selected' | 'available' | 'inactive';
-}
-interface RendererMinimapSnapshot {
-    sections: RendererMinimapSection[];
-    seats: RendererMinimapSeat[];
-}
-/** localStorage key the Designer writes and the Picker reads. */
-declare const CHART_STORAGE_KEY = "seatmap.chart";
 
-export { type ReferenceScanRowProposal as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type CubicPath as D, type ExpandedSeat as E, type Floor as F, type GAAreaObject as G, type DecorImageObject as H, type ISeatmapRenderer as I, LABEL_STYLE_MAX_SIZE as J, LABEL_STYLE_MIN_SIZE as K, type LabelStyle as L, type LabelPresentation as M, type Physical3dEvidence as N, type ObjectEditorState as O, type Point as P, type RadialClearanceLayoutConstraint as Q, type ResolvedSeatConfidenceEvidence as R, type SeatOverride as S, type TableObject as T, type ReferenceAccessibilitySource as U, type ReferenceCalibration as V, type ReferenceCategorySource as W, type ReferenceDerivedScale as X, type ReferenceInventoryExclusionSource as Y, type ReferenceInventorySource as Z, type ReferenceScanProposal as _, type RowObject as a, type ReferenceScanSectionProposal as a0, type ReferenceSeatSeed as a1, type ReferenceSectionTraceBatchInput as a2, type ReferenceSectionTraceBatchProposal as a3, type ReferenceSectionTraceInput as a4, type ReferenceSectionTraceProposal as a5, type RenderedBookableLabelEvidence as a6, type RenderedGAAreaEvidence as a7, type RenderedHierarchyLabelEvidence as a8, type RenderedLabelHiddenReason as a9, type ZoneDef as aA, accessibilityMeta as aB, accessibilityRingColor as aC, layerOf as aD, seatCommercialMeta as aE, type RenderedRowLabelEvidence as aa, type RendererMinimapSeat as ab, type RendererMinimapSection as ac, SEAT_COMMERCIAL_MARKS as ad, SURROUNDINGS_SHAPE_ROLES as ae, type SeatCommercialMark as af, type SeatCommercialMeta as ag, type SeatConfidenceCoverage as ah, type SeatConfidenceEvidence as ai, type SeatConfidenceModelLevel as aj, type SeatConfidenceModeledTarget as ak, type SeatConfidenceRealityLevel as al, type SeatViewCoverage as am, type SectionOutlinePath as an, type SectionPathSegment as ao, type SelectionLayer as ap, type ShapeLineCap as aq, type ShapeLineEnding as ar, type ShapeLineJoin as as, type ShapeObject as at, type TextAlignment as au, type TextBackground as av, type TextObject as aw, type TicketTierApplicability as ax, type TicketTierEvidence as ay, type TicketTierRestriction as az, type SeatViewMetadata as b, type RectTableSide as c, type ChartObject as d, type SectionObject as e, type RectTableSeatCounts as f, type GAInventorySegment as g, type RendererQualityEvidence as h, type RenderedFreeTextEvidence as i, type RendererOptions as j, type SeatStatus as k, type RendererViewMode as l, type RendererMinimapSnapshot as m, type LodRung as n, type CategoryTier as o, type SeatCommercialAttributes as p, type RendererCallbacks as q, ACCESSIBILITY_RING_COLOR as r, ACCESSIBILITY_TYPES as s, type AccessibilityMeta as t, type AuthoringObjectState as u, CHART_STORAGE_KEY as v, type Category as w, type ChartLayoutConstraint as x, type ChartReferenceImage as y, type ChartTheme as z };
+export { type ReferenceSectionTraceBatchInput as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type DecorImageObject as D, LABEL_STYLE_MAX_SIZE as E, type Floor as F, type GAAreaObject as G, LABEL_STYLE_MIN_SIZE as H, type LabelPresentation as I, type Physical3dEvidence as J, type RadialClearanceLayoutConstraint as K, type LabelStyle as L, type ReferenceAccessibilitySource as M, type ReferenceCalibration as N, type ObjectEditorState as O, type Point as P, type ReferenceCategorySource as Q, type RowObject as R, type SeatOverride as S, type TableObject as T, type ReferenceDerivedScale as U, type ReferenceInventoryExclusionSource as V, type ReferenceInventorySource as W, type ReferenceScanProposal as X, type ReferenceScanRowProposal as Y, type ReferenceScanSectionProposal as Z, type ReferenceSeatSeed as _, type SeatViewMetadata as a, type ReferenceSectionTraceBatchProposal as a0, type ReferenceSectionTraceInput as a1, type ReferenceSectionTraceProposal as a2, SEAT_COMMERCIAL_MARKS as a3, SURROUNDINGS_SHAPE_ROLES as a4, type SeatCommercialMark as a5, type SeatCommercialMeta as a6, type SeatConfidenceCoverage as a7, type SeatConfidenceEvidence as a8, type SeatConfidenceModelLevel as a9, type SeatConfidenceModeledTarget as aa, type SeatConfidenceRealityLevel as ab, type SelectionLayer as ac, type TextAlignment as ad, type TextBackground as ae, type TicketTierApplicability as af, type TicketTierEvidence as ag, type TicketTierRestriction as ah, type ZoneDef as ai, accessibilityMeta as aj, accessibilityRingColor as ak, layerOf as al, seatCommercialMeta as am, type RectTableSide as b, type ChartObject as c, type SectionObject as d, type RectTableSeatCounts as e, type SeatCommercialAttributes as f, type ResolvedSeatConfidenceEvidence as g, type SeatViewCoverage as h, type SectionOutlinePath as i, type SectionPathSegment as j, type GAInventorySegment as k, type CategoryTier as l, type ChartReferenceImage as m, type ShapeLineCap as n, type ShapeLineEnding as o, type ShapeLineJoin as p, type ShapeObject as q, type CubicPath as r, type TextObject as s, ACCESSIBILITY_RING_COLOR as t, ACCESSIBILITY_TYPES as u, type AccessibilityMeta as v, type AuthoringObjectState as w, type Category as x, type ChartLayoutConstraint as y, type ChartTheme as z };