@seatlayer/core 0.51.0 → 0.53.0

package/dist/view3d/index.d.cts

@@ -1,18 +1,6 @@
-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';
 
-/**
- * Dirty-flag render loop. A frame is drawn only while the camera is moving /
- * damping or an availability update arrived; when idle, no rAF is scheduled at
- * all (zero CPU/GPU when parked). Tracks an FPS EMA over frames actually
- * rendered — it reads as "idle" when nothing is scheduled.
- */
-interface RenderLoopStats {
-    fps: number;
-    rendered: number;
-    idle: boolean;
-}
-
 /**
  * view3d palette + seat-state model — the single source of colour truth for the
  * OGL venue view. Pure data (no GPU, no DOM) so the scene builder and the unit
@@ -21,6 +9,7 @@ interface RenderLoopStats {
  * Look brief (docs/3d-usp-strategy §3): desaturated cool greys for structure,
  * one warm accent for the stage, availability colours only on seats.
  */
+
 type SeatState3D = 'available' | 'held' | 'sold' | 'selected' | 'dimmed';
 type RGB = [number, number, number];
 /** Structure palette — cool desaturated greys + one warm stage accent. */
@@ -119,7 +108,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 +119,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 +278,7 @@ interface SceneZone {
  */
 interface SceneSection {
     id: string;
+    floorIndex: number;
     /** Buyer-facing name, matching the section label. */
     label: string;
     seatCount: number;
@@ -314,6 +306,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 +367,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[];
     /**
@@ -389,6 +387,34 @@ interface SceneModelInput {
     /** Optional initial per-seat state (default all available). */
     initialState?: (seat: ExpandedSeat) => SeatState3D;
 }
+
+/**
+ * The JS-side source of truth for the 3D scene — a pure, GPU-free description
+ * built once from the chart's existing height contract. Everything the renderer
+ * uploads (merged solid geometry, the instanced seat cloud, camera-framing
+ * bounds, the seat-state colour LUT) is derived here, so it survives a WebGL
+ * context loss: on `webglcontextrestored` the renderer simply re-uploads from
+ * this model without recomputing anything.
+ *
+ * Feeds 100% from `sectionGeometry` / `Floor.baseHeightM` / `ExpandedSeat`
+ * (docs/3d-program-workorder §Architecture) — no new chart data is invented.
+ *
+ * This module is the ORCHESTRATOR and the public face of `scene/model/`: it
+ * sequences the passes and re-exports every type and helper the rest of the
+ * codebase, the tests and the SDK import from `scene/sceneModel`. The passes
+ * themselves live in `scene/model/` — see `docs/architecture` for the layering:
+ *
+ *   types            the shapes everything below is described in
+ *   paint            AO + how an authored colour becomes an architectural tone
+ *   footprints       configuration filtering, floor units, plan-space polygons
+ *   shapeArchitecture décor vocabulary → architecture, and coplanar claims
+ *   objectBuilders   one prism per booth / table / shape / décor / GA area
+ *   tiers            per-section decks and the per-floor bowl
+ *   labels           zones, sections, rows and everything worth naming
+ *   floors           per-level boxes, and the per-seat floor attribute
+ *   bounds           chart footprint, ground datum, render + overview volumes
+ */
+
 declare function buildSceneModel(input: SceneModelInput): SceneModel;
 
 /**
@@ -431,16 +457,26 @@ interface PrepareVenue3DInput {
 declare function prepareVenue3D(input: PrepareVenue3DInput): Promise<PreparedVenue3D>;
 
 /**
- * view3d — the sole dynamic-import boundary for the lazy OGL venue-view chunk.
- *
- *   const { mountVenue3D } = await import('../view3d');
- *   const handle = mountVenue3D(container, { doc, seats }, { onSeatPick, getSeatView });
- *   await handle.flyToSeat(seatId);
+ * Dirty-flag render loop. A frame is drawn only while the camera is moving /
+ * damping or an availability update arrived; when idle, no rAF is scheduled at
+ * all (zero CPU/GPU when parked). Tracks an FPS EMA over frames actually
+ * rendered — it reads as "idle" when nothing is scheduled.
+ */
+interface RenderLoopStats {
+    fps: number;
+    rendered: number;
+    idle: boolean;
+}
+
+/**
+ * The public contract of the lazy venue-view chunk: what you mount it with
+ * (`Venue3DInput`), how you configure it (`Venue3DOptions`), and what you get
+ * back (`Venue3DHandle`).
  *
- * Read-only 3D of any chart, fed entirely from the existing height contract.
- * Slice 1: orbit camera, extruded tiers/stage/GA, instanced seat dots, sub-range
- * availability, dispose + context-loss survival. Slice 2: GPU color-pick. Slice
- * 3: the fly-to-seat cinematic that dissolves into the view-from-seat panorama.
+ * Split out of `index.ts` so the mount closure and the UI/interaction modules
+ * can share them without importing the entry. `index.ts` re-exports all four —
+ * that is the path the SDK (`@seatlayer/core/view3d`), the picker, the designer
+ * preview and the harness import from, and it must never move.
  */
 
 interface Venue3DInput {
@@ -507,7 +543,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,14 +585,27 @@ 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;
 }
+
+/**
+ * view3d — the sole dynamic-import boundary for the lazy OGL venue-view chunk.
+ *
+ *   const { mountVenue3D } = await import('../view3d');
+ *   const handle = mountVenue3D(container, { doc, seats }, { onSeatPick, getSeatView });
+ *   await handle.flyToSeat(seatId);
+ *
+ * Read-only 3D of any chart, fed entirely from the existing height contract.
+ * Slice 1: orbit camera, extruded tiers/stage/GA, instanced seat dots, sub-range
+ * availability, dispose + context-loss survival. Slice 2: GPU color-pick. Slice
+ * 3: the fly-to-seat cinematic that dissolves into the view-from-seat panorama.
+ */
+
 declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
 
 export { type Analytics3DCallback, type Scene3DPrepSource, type SeatState3D, SeatView, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DStats, buildSceneModel, mountVenue3D, prepareVenue3D };

package/dist/view3d/index.d.ts

@@ -1,18 +1,6 @@
-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';
 
-/**
- * Dirty-flag render loop. A frame is drawn only while the camera is moving /
- * damping or an availability update arrived; when idle, no rAF is scheduled at
- * all (zero CPU/GPU when parked). Tracks an FPS EMA over frames actually
- * rendered — it reads as "idle" when nothing is scheduled.
- */
-interface RenderLoopStats {
-    fps: number;
-    rendered: number;
-    idle: boolean;
-}
-
 /**
  * view3d palette + seat-state model — the single source of colour truth for the
  * OGL venue view. Pure data (no GPU, no DOM) so the scene builder and the unit
@@ -21,6 +9,7 @@ interface RenderLoopStats {
  * Look brief (docs/3d-usp-strategy §3): desaturated cool greys for structure,
  * one warm accent for the stage, availability colours only on seats.
  */
+
 type SeatState3D = 'available' | 'held' | 'sold' | 'selected' | 'dimmed';
 type RGB = [number, number, number];
 /** Structure palette — cool desaturated greys + one warm stage accent. */
@@ -119,7 +108,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 +119,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 +278,7 @@ interface SceneZone {
  */
 interface SceneSection {
     id: string;
+    floorIndex: number;
     /** Buyer-facing name, matching the section label. */
     label: string;
     seatCount: number;
@@ -314,6 +306,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 +367,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[];
     /**
@@ -389,6 +387,34 @@ interface SceneModelInput {
     /** Optional initial per-seat state (default all available). */
     initialState?: (seat: ExpandedSeat) => SeatState3D;
 }
+
+/**
+ * The JS-side source of truth for the 3D scene — a pure, GPU-free description
+ * built once from the chart's existing height contract. Everything the renderer
+ * uploads (merged solid geometry, the instanced seat cloud, camera-framing
+ * bounds, the seat-state colour LUT) is derived here, so it survives a WebGL
+ * context loss: on `webglcontextrestored` the renderer simply re-uploads from
+ * this model without recomputing anything.
+ *
+ * Feeds 100% from `sectionGeometry` / `Floor.baseHeightM` / `ExpandedSeat`
+ * (docs/3d-program-workorder §Architecture) — no new chart data is invented.
+ *
+ * This module is the ORCHESTRATOR and the public face of `scene/model/`: it
+ * sequences the passes and re-exports every type and helper the rest of the
+ * codebase, the tests and the SDK import from `scene/sceneModel`. The passes
+ * themselves live in `scene/model/` — see `docs/architecture` for the layering:
+ *
+ *   types            the shapes everything below is described in
+ *   paint            AO + how an authored colour becomes an architectural tone
+ *   footprints       configuration filtering, floor units, plan-space polygons
+ *   shapeArchitecture décor vocabulary → architecture, and coplanar claims
+ *   objectBuilders   one prism per booth / table / shape / décor / GA area
+ *   tiers            per-section decks and the per-floor bowl
+ *   labels           zones, sections, rows and everything worth naming
+ *   floors           per-level boxes, and the per-seat floor attribute
+ *   bounds           chart footprint, ground datum, render + overview volumes
+ */
+
 declare function buildSceneModel(input: SceneModelInput): SceneModel;
 
 /**
@@ -431,16 +457,26 @@ interface PrepareVenue3DInput {
 declare function prepareVenue3D(input: PrepareVenue3DInput): Promise<PreparedVenue3D>;
 
 /**
- * view3d — the sole dynamic-import boundary for the lazy OGL venue-view chunk.
- *
- *   const { mountVenue3D } = await import('../view3d');
- *   const handle = mountVenue3D(container, { doc, seats }, { onSeatPick, getSeatView });
- *   await handle.flyToSeat(seatId);
+ * Dirty-flag render loop. A frame is drawn only while the camera is moving /
+ * damping or an availability update arrived; when idle, no rAF is scheduled at
+ * all (zero CPU/GPU when parked). Tracks an FPS EMA over frames actually
+ * rendered — it reads as "idle" when nothing is scheduled.
+ */
+interface RenderLoopStats {
+    fps: number;
+    rendered: number;
+    idle: boolean;
+}
+
+/**
+ * The public contract of the lazy venue-view chunk: what you mount it with
+ * (`Venue3DInput`), how you configure it (`Venue3DOptions`), and what you get
+ * back (`Venue3DHandle`).
  *
- * Read-only 3D of any chart, fed entirely from the existing height contract.
- * Slice 1: orbit camera, extruded tiers/stage/GA, instanced seat dots, sub-range
- * availability, dispose + context-loss survival. Slice 2: GPU color-pick. Slice
- * 3: the fly-to-seat cinematic that dissolves into the view-from-seat panorama.
+ * Split out of `index.ts` so the mount closure and the UI/interaction modules
+ * can share them without importing the entry. `index.ts` re-exports all four —
+ * that is the path the SDK (`@seatlayer/core/view3d`), the picker, the designer
+ * preview and the harness import from, and it must never move.
  */
 
 interface Venue3DInput {
@@ -507,7 +543,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,14 +585,27 @@ 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;
 }
+
+/**
+ * view3d — the sole dynamic-import boundary for the lazy OGL venue-view chunk.
+ *
+ *   const { mountVenue3D } = await import('../view3d');
+ *   const handle = mountVenue3D(container, { doc, seats }, { onSeatPick, getSeatView });
+ *   await handle.flyToSeat(seatId);
+ *
+ * Read-only 3D of any chart, fed entirely from the existing height contract.
+ * Slice 1: orbit camera, extruded tiers/stage/GA, instanced seat dots, sub-range
+ * availability, dispose + context-loss survival. Slice 2: GPU color-pick. Slice
+ * 3: the fly-to-seat cinematic that dissolves into the view-from-seat panorama.
+ */
+
 declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
 
 export { type Analytics3DCallback, type Scene3DPrepSource, type SeatState3D, SeatView, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DStats, buildSceneModel, mountVenue3D, prepareVenue3D };