@seatlayer/core 0.32.0 → 0.33.0

package/dist/view3d/index.d.cts

@@ -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.
      *
@@ -215,6 +238,14 @@ interface SeatInstanceData {
     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.
@@ -286,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[];
     /**
@@ -325,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

@@ -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.
      *
@@ -215,6 +238,14 @@ interface SeatInstanceData {
     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.
@@ -286,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[];
     /**
@@ -325,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;