@seatlayer/core 0.51.0 → 0.52.0

package/dist/view3d/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ChartDoc, E as ExpandedSeat } from '../types-DR54nqKL.cjs';
+import { C as ChartDoc, E as ExpandedSeat } from '../types-tLOunI-B.cjs';
 import { SeatView } from './crossfade/panorama.cjs';
 
 /**
@@ -119,7 +119,7 @@ interface Theme3D {
  * unreadable confetti.
  */
 
-type LabelKind = 'zone' | 'section' | 'ga' | 'annotation' | 'booth' | 'row' | 'seat';
+type LabelKind = 'floor' | 'zone' | 'section' | 'ga' | 'annotation' | 'booth' | 'row' | 'seat';
 interface SceneLabel {
     id: string;
     kind: LabelKind;
@@ -130,6 +130,8 @@ interface SceneLabel {
     color?: string;
     /** Authored rotation in degrees, for annotations that specify one. */
     rotation?: number;
+    /** Owning physical level, so a focused floor never keeps another level's text. */
+    floorIndex?: number;
 }
 
 /**
@@ -287,6 +289,7 @@ interface SceneZone {
  */
 interface SceneSection {
     id: string;
+    floorIndex: number;
     /** Buyer-facing name, matching the section label. */
     label: string;
     seatCount: number;
@@ -314,6 +317,13 @@ interface SceneFloor {
     seatCount: number;
     center: [number, number, number];
     radius: number;
+    /** Complete active-level fit, including its inferred physical relief. */
+    box: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    /** Presentation-adjusted focal point used by section and seat views. */
+    focalWorld: [number, number, number];
 }
 interface SceneModel {
     /** Every non-seat surface merged into one triangle soup (1 draw call). */
@@ -368,10 +378,9 @@ interface SceneModel {
     /**
      * The venue's floors, in authored order. A single-floor chart reports one.
      *
-     * Every shipped multi-floor template puts all its floors at baseHeightM 0 and
-     * takes height from the sections instead, so floors are a logical grouping,
-     * not a physical stack. What they need is ISOLATION: draw all three of an
-     * opera house at once and the balcony sits over the parterre.
+     * Multi-floor scenes retain the authored x/z registration and the
+     * authored/inferred baseHeightM relief. Selecting a floor isolates it without
+     * changing the canonical chart.
      */
     floors: SceneFloor[];
     /**
@@ -507,7 +516,7 @@ interface Venue3DHandle {
      * view-from-seat panorama. Resolves at flight end; a drag cancels it, a second
      * call retargets, dispose resolves early. Reduced-motion → a short fade. */
     flyToSeat(seatId: string): Promise<void>;
-    /** Cancel a seat flight/panorama and frame the complete venue. */
+    /** Cancel a seat flight/panorama and fit the active floor or complete venue. */
     focusOverview(): void;
     resize(): void;
     stats(): Venue3DStats;
@@ -549,11 +558,10 @@ interface Venue3DHandle {
     /**
      * Isolate one floor, or pass null to show the whole venue.
      *
-     * Every shipped multi-floor chart puts its floors at the same base height and
-     * takes relief from the sections, so all three of an opera house draw at once
-     * and the balcony sits over the parterre. Unfocused floors are DIMMED rather
-     * than hidden, so the buyer keeps the venue as context while looking at the
-     * level they are booking. Returns false for an unknown index.
+     * The complete venue uses a rigid, non-overlapping level composition derived
+     * from the same native 2D geometry. Entering a level hides the other levels so
+     * opaque decks cannot cover the seats being inspected. Returns false for an
+     * unknown index.
      */
     focusFloor(index: number | null): boolean;
 }

package/dist/view3d/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ChartDoc, E as ExpandedSeat } from '../types-DR54nqKL.js';
+import { C as ChartDoc, E as ExpandedSeat } from '../types-tLOunI-B.js';
 import { SeatView } from './crossfade/panorama.js';
 
 /**
@@ -119,7 +119,7 @@ interface Theme3D {
  * unreadable confetti.
  */
 
-type LabelKind = 'zone' | 'section' | 'ga' | 'annotation' | 'booth' | 'row' | 'seat';
+type LabelKind = 'floor' | 'zone' | 'section' | 'ga' | 'annotation' | 'booth' | 'row' | 'seat';
 interface SceneLabel {
     id: string;
     kind: LabelKind;
@@ -130,6 +130,8 @@ interface SceneLabel {
     color?: string;
     /** Authored rotation in degrees, for annotations that specify one. */
     rotation?: number;
+    /** Owning physical level, so a focused floor never keeps another level's text. */
+    floorIndex?: number;
 }
 
 /**
@@ -287,6 +289,7 @@ interface SceneZone {
  */
 interface SceneSection {
     id: string;
+    floorIndex: number;
     /** Buyer-facing name, matching the section label. */
     label: string;
     seatCount: number;
@@ -314,6 +317,13 @@ interface SceneFloor {
     seatCount: number;
     center: [number, number, number];
     radius: number;
+    /** Complete active-level fit, including its inferred physical relief. */
+    box: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    /** Presentation-adjusted focal point used by section and seat views. */
+    focalWorld: [number, number, number];
 }
 interface SceneModel {
     /** Every non-seat surface merged into one triangle soup (1 draw call). */
@@ -368,10 +378,9 @@ interface SceneModel {
     /**
      * The venue's floors, in authored order. A single-floor chart reports one.
      *
-     * Every shipped multi-floor template puts all its floors at baseHeightM 0 and
-     * takes height from the sections instead, so floors are a logical grouping,
-     * not a physical stack. What they need is ISOLATION: draw all three of an
-     * opera house at once and the balcony sits over the parterre.
+     * Multi-floor scenes retain the authored x/z registration and the
+     * authored/inferred baseHeightM relief. Selecting a floor isolates it without
+     * changing the canonical chart.
      */
     floors: SceneFloor[];
     /**
@@ -507,7 +516,7 @@ interface Venue3DHandle {
      * view-from-seat panorama. Resolves at flight end; a drag cancels it, a second
      * call retargets, dispose resolves early. Reduced-motion → a short fade. */
     flyToSeat(seatId: string): Promise<void>;
-    /** Cancel a seat flight/panorama and frame the complete venue. */
+    /** Cancel a seat flight/panorama and fit the active floor or complete venue. */
     focusOverview(): void;
     resize(): void;
     stats(): Venue3DStats;
@@ -549,11 +558,10 @@ interface Venue3DHandle {
     /**
      * Isolate one floor, or pass null to show the whole venue.
      *
-     * Every shipped multi-floor chart puts its floors at the same base height and
-     * takes relief from the sections, so all three of an opera house draw at once
-     * and the balcony sits over the parterre. Unfocused floors are DIMMED rather
-     * than hidden, so the buyer keeps the venue as context while looking at the
-     * level they are booking. Returns false for an unknown index.
+     * The complete venue uses a rigid, non-overlapping level composition derived
+     * from the same native 2D geometry. Entering a level hides the other levels so
+     * opaque decks cannot cover the seats being inspected. Returns false for an
+     * unknown index.
      */
     focusFloor(index: number | null): boolean;
 }