@seatlayer/core 0.30.1 → 0.32.0

package/dist/view3d/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ChartDoc, E as ExpandedSeat } from '../types-CG2pEDoI.cjs';
+import { C as ChartDoc, E as ExpandedSeat } from '../types-DO_J5DtX.cjs';
 
 /**
  * Dirty-flag render loop. A frame is drawn only while the camera is moving /
@@ -104,7 +104,7 @@ interface Theme3D {
  * unreadable confetti.
  */
 
-type LabelKind = 'zone' | 'section' | 'annotation' | 'booth';
+type LabelKind = 'zone' | 'section' | 'ga' | 'annotation' | 'booth' | 'row' | 'seat';
 interface SceneLabel {
     id: string;
     kind: LabelKind;
@@ -188,6 +188,29 @@ interface SeatInstanceData {
     iRing: Float32Array;
     /** float per instance: owning floor index, for per-floor isolation. */
     iFloor: Float32Array;
+    /**
+     * float per instance: facing yaw in radians, for the near-field chair mesh.
+     *
+     * A billboard dot has no front, so nothing here ever needed a direction. A
+     * chair does, and getting it wrong is worse than drawing nothing — a row of
+     * seats with their backs to the stage reads as a mistake immediately.
+     *
+     * Left at zero by this builder and filled by `sceneModel`, which is the layer
+     * that knows what each seat FACES (its floor's focal point). Direct callers
+     * and tests that build instances without a scene get zeros, which is a
+     * well-defined "facing +Z" rather than an undefined attribute.
+     */
+    iYaw: Float32Array;
+    /**
+     * float per instance: half-width of this seat's near-field CHAIR, world metres.
+     *
+     * Deliberately not `iMaxRadius`. That value is the dot's ceiling — conservative
+     * by design so round dots stay visually apart, and clamped to
+     * SEAT_DOT_RADIUS_M on top of that. Sizing a chair from it gave 0.34 m chairs
+     * under 0.95 m backs: an aspect ratio near 3:1, which reads as a headstone.
+     * Real seats very nearly touch. See `chairHalfWidth`.
+     */
+    iChairWidth: Float32Array;
     /** seatId → instance index (drives targeted availability updates). */
     idToIndex: Map<string, number>;
 }
@@ -217,6 +240,23 @@ interface SceneZone {
     /** What this zone faces — its authored focal, else the venue's. */
     focalWorld: [number, number, number];
 }
+/**
+ * One seated section, resolved for navigation — the middle rung of the venue
+ * ladder, between a zone and a seat. A chart with no zones authored still has
+ * sections, so this is the level at which every venue can be navigated.
+ */
+interface SceneSection {
+    id: string;
+    /** Buyer-facing name, matching the section label. */
+    label: string;
+    seatCount: number;
+    /** World-metre centre of the section's seats (camera target). */
+    center: [number, number, number];
+    /** Half-diagonal of its seat footprint, world metres (camera fit). */
+    radius: number;
+    /** What this section faces — the camera approaches from this side. */
+    focalWorld: [number, number, number];
+}
 /** A navigable floor — a logical level of the venue. */
 interface SceneFloor {
     index: number;
@@ -246,6 +286,8 @@ interface SceneModel {
     focalWorld: [number, number, number];
     /** The venue's zones, in authored order. Empty when the chart has none. */
     zones: SceneZone[];
+    /** Seated sections, in authored order — the navigable middle rung. */
+    sections: SceneSection[];
     /**
      * The venue's floors, in authored order. A single-floor chart reports one.
      *
@@ -367,6 +409,15 @@ interface Venue3DHandle {
      * means the seats face the camera rather than presenting their backs.
      */
     focusZone(zoneId: string): boolean;
+    /** The venue's seated sections (id, name, seat count) in authored order. */
+    sections(): SceneSection[];
+    /**
+     * Frame a section — the middle rung of the venue ladder, and the one every
+     * chart has. Zones are optional and a chart may author none or one; sections
+     * are what a buyer picks between when "which part of the venue" has already
+     * been answered. Returns false for an unknown or empty section.
+     */
+    focusSection(sectionId: string): boolean;
     /** The venue's floors (id, name, seat count) in authored order. */
     floors(): SceneFloor[];
     /**

package/dist/view3d/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ChartDoc, E as ExpandedSeat } from '../types-CG2pEDoI.js';
+import { C as ChartDoc, E as ExpandedSeat } from '../types-DO_J5DtX.js';
 
 /**
  * Dirty-flag render loop. A frame is drawn only while the camera is moving /
@@ -104,7 +104,7 @@ interface Theme3D {
  * unreadable confetti.
  */
 
-type LabelKind = 'zone' | 'section' | 'annotation' | 'booth';
+type LabelKind = 'zone' | 'section' | 'ga' | 'annotation' | 'booth' | 'row' | 'seat';
 interface SceneLabel {
     id: string;
     kind: LabelKind;
@@ -188,6 +188,29 @@ interface SeatInstanceData {
     iRing: Float32Array;
     /** float per instance: owning floor index, for per-floor isolation. */
     iFloor: Float32Array;
+    /**
+     * float per instance: facing yaw in radians, for the near-field chair mesh.
+     *
+     * A billboard dot has no front, so nothing here ever needed a direction. A
+     * chair does, and getting it wrong is worse than drawing nothing — a row of
+     * seats with their backs to the stage reads as a mistake immediately.
+     *
+     * Left at zero by this builder and filled by `sceneModel`, which is the layer
+     * that knows what each seat FACES (its floor's focal point). Direct callers
+     * and tests that build instances without a scene get zeros, which is a
+     * well-defined "facing +Z" rather than an undefined attribute.
+     */
+    iYaw: Float32Array;
+    /**
+     * float per instance: half-width of this seat's near-field CHAIR, world metres.
+     *
+     * Deliberately not `iMaxRadius`. That value is the dot's ceiling — conservative
+     * by design so round dots stay visually apart, and clamped to
+     * SEAT_DOT_RADIUS_M on top of that. Sizing a chair from it gave 0.34 m chairs
+     * under 0.95 m backs: an aspect ratio near 3:1, which reads as a headstone.
+     * Real seats very nearly touch. See `chairHalfWidth`.
+     */
+    iChairWidth: Float32Array;
     /** seatId → instance index (drives targeted availability updates). */
     idToIndex: Map<string, number>;
 }
@@ -217,6 +240,23 @@ interface SceneZone {
     /** What this zone faces — its authored focal, else the venue's. */
     focalWorld: [number, number, number];
 }
+/**
+ * One seated section, resolved for navigation — the middle rung of the venue
+ * ladder, between a zone and a seat. A chart with no zones authored still has
+ * sections, so this is the level at which every venue can be navigated.
+ */
+interface SceneSection {
+    id: string;
+    /** Buyer-facing name, matching the section label. */
+    label: string;
+    seatCount: number;
+    /** World-metre centre of the section's seats (camera target). */
+    center: [number, number, number];
+    /** Half-diagonal of its seat footprint, world metres (camera fit). */
+    radius: number;
+    /** What this section faces — the camera approaches from this side. */
+    focalWorld: [number, number, number];
+}
 /** A navigable floor — a logical level of the venue. */
 interface SceneFloor {
     index: number;
@@ -246,6 +286,8 @@ interface SceneModel {
     focalWorld: [number, number, number];
     /** The venue's zones, in authored order. Empty when the chart has none. */
     zones: SceneZone[];
+    /** Seated sections, in authored order — the navigable middle rung. */
+    sections: SceneSection[];
     /**
      * The venue's floors, in authored order. A single-floor chart reports one.
      *
@@ -367,6 +409,15 @@ interface Venue3DHandle {
      * means the seats face the camera rather than presenting their backs.
      */
     focusZone(zoneId: string): boolean;
+    /** The venue's seated sections (id, name, seat count) in authored order. */
+    sections(): SceneSection[];
+    /**
+     * Frame a section — the middle rung of the venue ladder, and the one every
+     * chart has. Zones are optional and a chart may author none or one; sections
+     * are what a buyer picks between when "which part of the venue" has already
+     * been answered. Returns false for an unknown or empty section.
+     */
+    focusSection(sectionId: string): boolean;
     /** The venue's floors (id, name, seat count) in authored order. */
     floors(): SceneFloor[];
     /**