@seatlayer/core 0.52.0 → 0.53.0

package/dist/view3d/index.d.cts

@@ -1,18 +1,6 @@
 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. */
@@ -398,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;
 
 /**
@@ -440,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 {
@@ -565,6 +592,20 @@ interface Venue3DHandle {
      */
     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-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. */
@@ -398,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;
 
 /**
@@ -440,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 {
@@ -565,6 +592,20 @@ interface Venue3DHandle {
      */
     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 };