@seatlayer/core 0.31.0 → 0.33.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 /
@@ -27,6 +27,20 @@ declare const STRUCTURE: {
     readonly ground: RGB;
     readonly tierTop: RGB;
     readonly tierWall: RGB;
+    /**
+     * The lit performance surface.
+     *
+     * This was [0.42, 0.36, 0.26] and commented "slightly emissive read", which it
+     * was not — under the scene's rig it resolved to a mid-brown slab, and from a
+     * seat the stage was the DIMMEST large surface in a dark hall. That is exactly
+     * backwards: the stage is the one place in a venue with light pointed at it,
+     * and it is what a buyer's eye should land on when they arrive at their seat.
+     *
+     * Bright and warm enough to hold that role against the surrounding structure,
+     * which sits around 0.24. An authored `fill` still tints it (see `buildShape`),
+     * so an organizer's own stage colour survives — it is just no longer lit like
+     * a basement.
+     */
     readonly stageTop: RGB;
     readonly stageWall: RGB;
     readonly decorTop: RGB;
@@ -160,6 +174,15 @@ interface SeatInstanceData {
     iPosition: Float32Array;
     /** float per instance: index into the seat-state colour LUT. */
     iState: Float32Array;
+    /**
+     * vec3 per instance: the seat's CATEGORY colour, used while it is available.
+     *
+     * 2D fills a free seat with its category colour and only overrides it once the
+     * seat is held/sold/selected. 3D used one flat green for every available seat,
+     * which threw away the price-tier read on switching views and made a full
+     * house look like a status map instead of a venue.
+     */
+    iCategory: Float32Array;
     /**
      * float per instance: the largest world radius this dot may take, metres.
      *
@@ -188,10 +211,41 @@ 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>;
 }
 
+/** Axis-aligned stage footprint in world metres. */
+interface StageBounds {
+    cx: number;
+    cz: number;
+    y: number;
+    halfX: number;
+    halfZ: number;
+}
 /**
  * A navigable zone — the venue's own top-level grouping (Orchestra, Lower Bowl,
  * Hall A), resolved for camera framing and for the section/zone LOD rung.
@@ -263,6 +317,16 @@ interface SceneModel {
     focalWorld: [number, number, number];
     /** The venue's zones, in authored order. Empty when the chart has none. */
     zones: SceneZone[];
+    /**
+     * Stage footprints in world metres.
+     *
+     * Collected for stage lighting, which is not shipped: additive cones were
+     * built, placed correctly and still could not be read from a seat (see
+     * `git log` for `stageLight.ts`). The bounds stay because they are cheap,
+     * correct, and exactly what a second attempt needs — the geometry was never
+     * the hard part, the technique was.
+     */
+    stages: StageBounds[];
     /** Seated sections, in authored order — the navigable middle rung. */
     sections: SceneSection[];
     /**
@@ -302,6 +366,21 @@ declare function buildSceneModel(input: SceneModelInput): SceneModel;
  */
 interface SeatView {
     url: string;
+    /**
+     * True when `url` is a SYNTHESISED panorama rather than a real photograph.
+     *
+     * It decides which of two very different things the buyer gets, so the caller
+     * must say rather than the renderer guess. A generated equirect is a picture
+     * of a 3D scene the renderer already has: at 2048×1024 it covers 106° of
+     * horizontal view in ~600 source pixels, which a 3072-device-pixel viewport
+     * magnifies FIVE times, and no amount of art survives that. So a generated
+     * view is not drawn as an image at all — the camera simply looks around the
+     * real scene, which has no resolution ceiling.
+     *
+     * A real photo has no such substitute and goes on the sphere, where a 5760 or
+     * 8192-wide capture has three to four times the detail to give.
+     */
+    generated?: boolean;
     /** Bearing (deg, 0 = facing the focal/stage) the panorama should open centred
      * on, to match the camera's final yaw. Default 0 (both face the stage). */
     initialBearingDeg?: number;

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 /
@@ -27,6 +27,20 @@ declare const STRUCTURE: {
     readonly ground: RGB;
     readonly tierTop: RGB;
     readonly tierWall: RGB;
+    /**
+     * The lit performance surface.
+     *
+     * This was [0.42, 0.36, 0.26] and commented "slightly emissive read", which it
+     * was not — under the scene's rig it resolved to a mid-brown slab, and from a
+     * seat the stage was the DIMMEST large surface in a dark hall. That is exactly
+     * backwards: the stage is the one place in a venue with light pointed at it,
+     * and it is what a buyer's eye should land on when they arrive at their seat.
+     *
+     * Bright and warm enough to hold that role against the surrounding structure,
+     * which sits around 0.24. An authored `fill` still tints it (see `buildShape`),
+     * so an organizer's own stage colour survives — it is just no longer lit like
+     * a basement.
+     */
     readonly stageTop: RGB;
     readonly stageWall: RGB;
     readonly decorTop: RGB;
@@ -160,6 +174,15 @@ interface SeatInstanceData {
     iPosition: Float32Array;
     /** float per instance: index into the seat-state colour LUT. */
     iState: Float32Array;
+    /**
+     * vec3 per instance: the seat's CATEGORY colour, used while it is available.
+     *
+     * 2D fills a free seat with its category colour and only overrides it once the
+     * seat is held/sold/selected. 3D used one flat green for every available seat,
+     * which threw away the price-tier read on switching views and made a full
+     * house look like a status map instead of a venue.
+     */
+    iCategory: Float32Array;
     /**
      * float per instance: the largest world radius this dot may take, metres.
      *
@@ -188,10 +211,41 @@ 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>;
 }
 
+/** Axis-aligned stage footprint in world metres. */
+interface StageBounds {
+    cx: number;
+    cz: number;
+    y: number;
+    halfX: number;
+    halfZ: number;
+}
 /**
  * A navigable zone — the venue's own top-level grouping (Orchestra, Lower Bowl,
  * Hall A), resolved for camera framing and for the section/zone LOD rung.
@@ -263,6 +317,16 @@ interface SceneModel {
     focalWorld: [number, number, number];
     /** The venue's zones, in authored order. Empty when the chart has none. */
     zones: SceneZone[];
+    /**
+     * Stage footprints in world metres.
+     *
+     * Collected for stage lighting, which is not shipped: additive cones were
+     * built, placed correctly and still could not be read from a seat (see
+     * `git log` for `stageLight.ts`). The bounds stay because they are cheap,
+     * correct, and exactly what a second attempt needs — the geometry was never
+     * the hard part, the technique was.
+     */
+    stages: StageBounds[];
     /** Seated sections, in authored order — the navigable middle rung. */
     sections: SceneSection[];
     /**
@@ -302,6 +366,21 @@ declare function buildSceneModel(input: SceneModelInput): SceneModel;
  */
 interface SeatView {
     url: string;
+    /**
+     * True when `url` is a SYNTHESISED panorama rather than a real photograph.
+     *
+     * It decides which of two very different things the buyer gets, so the caller
+     * must say rather than the renderer guess. A generated equirect is a picture
+     * of a 3D scene the renderer already has: at 2048×1024 it covers 106° of
+     * horizontal view in ~600 source pixels, which a 3072-device-pixel viewport
+     * magnifies FIVE times, and no amount of art survives that. So a generated
+     * view is not drawn as an image at all — the camera simply looks around the
+     * real scene, which has no resolution ceiling.
+     *
+     * A real photo has no such substitute and goes on the sphere, where a 5760 or
+     * 8192-wide capture has three to four times the detail to give.
+     */
+    generated?: boolean;
     /** Bearing (deg, 0 = facing the focal/stage) the panorama should open centred
      * on, to match the camera's final yaw. Default 0 (both face the stage). */
     initialBearingDeg?: number;