@seatlayer/core 0.46.0 → 0.47.1

package/dist/view3d/index.d.cts

@@ -1,4 +1,5 @@
-import { C as ChartDoc, E as ExpandedSeat } from '../types-DBnRO2hX.cjs';
+import { C as ChartDoc, E as ExpandedSeat } from '../types-CE63BK0j.cjs';
+import { SeatView } from './crossfade/panorama.cjs';
 
 /**
  * Dirty-flag render loop. A frame is drawn only while the camera is moving /
@@ -234,6 +235,8 @@ interface SeatInstanceData {
      * Real seats very nearly touch. See `chairHalfWidth`.
      */
     iChairWidth: Float32Array;
+    /** 1 = physical chair; 0 = sellable empty wheelchair bay. */
+    iPhysicalSeat: Float32Array;
     /** seatId → instance index (drives targeted availability updates). */
     idToIndex: Map<string, number>;
 }
@@ -288,6 +291,15 @@ interface SceneSection {
     /** What this section faces — the camera approaches from this side. */
     focalWorld: [number, number, number];
 }
+/** One authored row resolved for guided large-venue navigation. */
+interface SceneRow {
+    id: string;
+    label: string;
+    sectionId?: string;
+    seatCount: number;
+    center: [number, number, number];
+    radius: number;
+}
 /** A navigable floor — a logical level of the venue. */
 interface SceneFloor {
     index: number;
@@ -329,6 +341,8 @@ interface SceneModel {
     stages: StageBounds[];
     /** Seated sections, in authored order — the navigable middle rung. */
     sections: SceneSection[];
+    /** Rows used by the Section → Row → Seat locator. */
+    rows: SceneRow[];
     /**
      * The venue's floors, in authored order. A single-floor chart reports one.
      *
@@ -348,44 +362,13 @@ interface SceneModel {
 interface SceneModelInput {
     doc: ChartDoc;
     seats: ExpandedSeat[];
+    /** Overrides the chart's active layout without mutating its authored data. */
+    eventConfigurationId?: string;
     /** Optional initial per-seat state (default all available). */
     initialState?: (seat: ExpandedSeat) => SeatState3D;
 }
 declare function buildSceneModel(input: SceneModelInput): SceneModel;
 
-/**
- * Slice 3 hand-off — the DOM panorama overlay the fly-to-seat cinematic
- * dissolves into. Decoupled by design: the CALLER supplies the equirectangular
- * image (via mountVenue3D's getSeatView), so view3d never imports the app's
- * panorama generator and the chunk stays lean.
- *
- * Technique (mirrors SeatPicker.openSeatView, reimplemented small): an equirect
- * image panned with `repeat-x`; the initial horizontal offset is set so the
- * panorama's bearing matches the final camera yaw — the dissolve reads as the
- * same view sharpening, not a cut. CSS opacity fade is compositor-only.
- */
-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;
-}
-
 /**
  * view3d analytics — a tiny, decoupled event emitter for the venue view. The
  * caller (app/harness) supplies `onAnalytics`; this class owns the per-mount
@@ -394,6 +377,36 @@ interface SeatView {
  * rendering. No DOM, no GL — unit-testable in isolation.
  */
 type Analytics3DCallback = (event: string, props?: Record<string, unknown>) => void;
+/**
+ * Where the CPU scene was compiled, as a closed enum (never free text).
+ * - `worker` — built off the UI thread by `prepareVenue3D`.
+ * - `main`   — `prepareVenue3D` ran but the worker was unavailable or failed
+ *              (no `Worker`, a host CSP blocking the module worker, a throw, or
+ *              the 15s timeout) and the same pure compiler ran on the UI thread.
+ * - `inline` — the caller never used `prepareVenue3D`; the scene was compiled
+ *              synchronously inside `mountVenue3D`. Kept distinct from `main`
+ *              so worker uptake is not diluted by callers that never asked.
+ */
+type Scene3DPrepSource = 'worker' | 'main' | 'inline';
+
+interface PreparedVenue3D {
+    model: SceneModel;
+    buildMs: number;
+    /** Reported on `3d_opened` as `prepSource`. `inline` is not reachable here —
+     * it is what `mountVenue3D` reports when no prepared scene was handed in. */
+    source: Exclude<Scene3DPrepSource, 'inline'>;
+}
+interface PrepareVenue3DInput {
+    doc: ChartDoc;
+    seats: ExpandedSeat[];
+    eventConfigurationId?: string;
+}
+/**
+ * Build the CPU-heavy merged mesh and seat buffers off the UI thread. Worker
+ * failure is non-fatal: old browsers and restrictive hosts fall back to the
+ * exact same pure compiler on the main thread.
+ */
+declare function prepareVenue3D(input: PrepareVenue3DInput): Promise<PreparedVenue3D>;
 
 /**
  * view3d — the sole dynamic-import boundary for the lazy OGL venue-view chunk.
@@ -414,10 +427,17 @@ interface Venue3DInput {
     seats: ExpandedSeat[];
     /** Optional initial per-seat state (default all available). */
     initialState?: (seat: ExpandedSeat) => SeatState3D;
+    /** CPU scene prepared by `prepareVenue3D`; avoids rebuilding on mount. */
+    prepared?: PreparedVenue3D;
 }
 interface Venue3DOptions {
     /** Fired on a tap that hits a seat (GPU color-pick). Not fired on empty taps. */
     onSeatPick?: (seatId: string) => void;
+    /** Overview → section drill state. A stand tap reports its owning section;
+     * Overview reports null so host navigation can stay in sync. */
+    onSectionFocusChange?: (sectionId: string | null) => void;
+    /** Camera target changes, including internal next/previous and Overview UI. */
+    onViewTargetChange?: (seatId: string | null) => void;
     /**
      * Supplies the view-from-seat panorama for the cinematic hand-off. Decoupled:
      * the caller (app/harness) owns panorama generation; view3d never imports it.
@@ -432,6 +452,13 @@ interface Venue3DOptions {
      * rendering. Absent = no events emitted.
      */
     onAnalytics?: Analytics3DCallback;
+    /**
+     * Let portrait overview framing crop the venue's far edges within a bounded
+     * landscape fit so seats stay discoverable instead of shrinking the whole
+     * bowl to fit. Opt-in because designer/editor previews still prefer strict
+     * contain framing; validated for the buyer across `/dev/3d` fixtures.
+     */
+    portraitOverviewCrop?: boolean;
 }
 interface Venue3DStats extends RenderLoopStats {
     drawCalls: number;
@@ -448,6 +475,8 @@ 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. */
+    focusOverview(): void;
     resize(): void;
     stats(): Venue3DStats;
     loseContextForTest(): void;
@@ -474,6 +503,15 @@ interface Venue3DHandle {
      * been answered. Returns false for an unknown or empty section.
      */
     focusSection(sectionId: string): boolean;
+    /** Rows in the venue, optionally narrowed to a section. */
+    rows(sectionId?: string): SceneRow[];
+    /** Seats in one row, in authored order. */
+    seatsInRow(rowId: string): Array<{
+        id: string;
+        label: string;
+    }>;
+    /** Frame a row closely enough for its on-demand seat numbers to be legible. */
+    focusRow(rowId: string): boolean;
     /** The venue's floors (id, name, seat count) in authored order. */
     floors(): SceneFloor[];
     /**
@@ -489,4 +527,4 @@ interface Venue3DHandle {
 }
 declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
 
-export { type Analytics3DCallback, type SeatState3D, type SeatView, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DStats, buildSceneModel, mountVenue3D };
+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,4 +1,5 @@
-import { C as ChartDoc, E as ExpandedSeat } from '../types-DBnRO2hX.js';
+import { C as ChartDoc, E as ExpandedSeat } from '../types-CE63BK0j.js';
+import { SeatView } from './crossfade/panorama.js';
 
 /**
  * Dirty-flag render loop. A frame is drawn only while the camera is moving /
@@ -234,6 +235,8 @@ interface SeatInstanceData {
      * Real seats very nearly touch. See `chairHalfWidth`.
      */
     iChairWidth: Float32Array;
+    /** 1 = physical chair; 0 = sellable empty wheelchair bay. */
+    iPhysicalSeat: Float32Array;
     /** seatId → instance index (drives targeted availability updates). */
     idToIndex: Map<string, number>;
 }
@@ -288,6 +291,15 @@ interface SceneSection {
     /** What this section faces — the camera approaches from this side. */
     focalWorld: [number, number, number];
 }
+/** One authored row resolved for guided large-venue navigation. */
+interface SceneRow {
+    id: string;
+    label: string;
+    sectionId?: string;
+    seatCount: number;
+    center: [number, number, number];
+    radius: number;
+}
 /** A navigable floor — a logical level of the venue. */
 interface SceneFloor {
     index: number;
@@ -329,6 +341,8 @@ interface SceneModel {
     stages: StageBounds[];
     /** Seated sections, in authored order — the navigable middle rung. */
     sections: SceneSection[];
+    /** Rows used by the Section → Row → Seat locator. */
+    rows: SceneRow[];
     /**
      * The venue's floors, in authored order. A single-floor chart reports one.
      *
@@ -348,44 +362,13 @@ interface SceneModel {
 interface SceneModelInput {
     doc: ChartDoc;
     seats: ExpandedSeat[];
+    /** Overrides the chart's active layout without mutating its authored data. */
+    eventConfigurationId?: string;
     /** Optional initial per-seat state (default all available). */
     initialState?: (seat: ExpandedSeat) => SeatState3D;
 }
 declare function buildSceneModel(input: SceneModelInput): SceneModel;
 
-/**
- * Slice 3 hand-off — the DOM panorama overlay the fly-to-seat cinematic
- * dissolves into. Decoupled by design: the CALLER supplies the equirectangular
- * image (via mountVenue3D's getSeatView), so view3d never imports the app's
- * panorama generator and the chunk stays lean.
- *
- * Technique (mirrors SeatPicker.openSeatView, reimplemented small): an equirect
- * image panned with `repeat-x`; the initial horizontal offset is set so the
- * panorama's bearing matches the final camera yaw — the dissolve reads as the
- * same view sharpening, not a cut. CSS opacity fade is compositor-only.
- */
-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;
-}
-
 /**
  * view3d analytics — a tiny, decoupled event emitter for the venue view. The
  * caller (app/harness) supplies `onAnalytics`; this class owns the per-mount
@@ -394,6 +377,36 @@ interface SeatView {
  * rendering. No DOM, no GL — unit-testable in isolation.
  */
 type Analytics3DCallback = (event: string, props?: Record<string, unknown>) => void;
+/**
+ * Where the CPU scene was compiled, as a closed enum (never free text).
+ * - `worker` — built off the UI thread by `prepareVenue3D`.
+ * - `main`   — `prepareVenue3D` ran but the worker was unavailable or failed
+ *              (no `Worker`, a host CSP blocking the module worker, a throw, or
+ *              the 15s timeout) and the same pure compiler ran on the UI thread.
+ * - `inline` — the caller never used `prepareVenue3D`; the scene was compiled
+ *              synchronously inside `mountVenue3D`. Kept distinct from `main`
+ *              so worker uptake is not diluted by callers that never asked.
+ */
+type Scene3DPrepSource = 'worker' | 'main' | 'inline';
+
+interface PreparedVenue3D {
+    model: SceneModel;
+    buildMs: number;
+    /** Reported on `3d_opened` as `prepSource`. `inline` is not reachable here —
+     * it is what `mountVenue3D` reports when no prepared scene was handed in. */
+    source: Exclude<Scene3DPrepSource, 'inline'>;
+}
+interface PrepareVenue3DInput {
+    doc: ChartDoc;
+    seats: ExpandedSeat[];
+    eventConfigurationId?: string;
+}
+/**
+ * Build the CPU-heavy merged mesh and seat buffers off the UI thread. Worker
+ * failure is non-fatal: old browsers and restrictive hosts fall back to the
+ * exact same pure compiler on the main thread.
+ */
+declare function prepareVenue3D(input: PrepareVenue3DInput): Promise<PreparedVenue3D>;
 
 /**
  * view3d — the sole dynamic-import boundary for the lazy OGL venue-view chunk.
@@ -414,10 +427,17 @@ interface Venue3DInput {
     seats: ExpandedSeat[];
     /** Optional initial per-seat state (default all available). */
     initialState?: (seat: ExpandedSeat) => SeatState3D;
+    /** CPU scene prepared by `prepareVenue3D`; avoids rebuilding on mount. */
+    prepared?: PreparedVenue3D;
 }
 interface Venue3DOptions {
     /** Fired on a tap that hits a seat (GPU color-pick). Not fired on empty taps. */
     onSeatPick?: (seatId: string) => void;
+    /** Overview → section drill state. A stand tap reports its owning section;
+     * Overview reports null so host navigation can stay in sync. */
+    onSectionFocusChange?: (sectionId: string | null) => void;
+    /** Camera target changes, including internal next/previous and Overview UI. */
+    onViewTargetChange?: (seatId: string | null) => void;
     /**
      * Supplies the view-from-seat panorama for the cinematic hand-off. Decoupled:
      * the caller (app/harness) owns panorama generation; view3d never imports it.
@@ -432,6 +452,13 @@ interface Venue3DOptions {
      * rendering. Absent = no events emitted.
      */
     onAnalytics?: Analytics3DCallback;
+    /**
+     * Let portrait overview framing crop the venue's far edges within a bounded
+     * landscape fit so seats stay discoverable instead of shrinking the whole
+     * bowl to fit. Opt-in because designer/editor previews still prefer strict
+     * contain framing; validated for the buyer across `/dev/3d` fixtures.
+     */
+    portraitOverviewCrop?: boolean;
 }
 interface Venue3DStats extends RenderLoopStats {
     drawCalls: number;
@@ -448,6 +475,8 @@ 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. */
+    focusOverview(): void;
     resize(): void;
     stats(): Venue3DStats;
     loseContextForTest(): void;
@@ -474,6 +503,15 @@ interface Venue3DHandle {
      * been answered. Returns false for an unknown or empty section.
      */
     focusSection(sectionId: string): boolean;
+    /** Rows in the venue, optionally narrowed to a section. */
+    rows(sectionId?: string): SceneRow[];
+    /** Seats in one row, in authored order. */
+    seatsInRow(rowId: string): Array<{
+        id: string;
+        label: string;
+    }>;
+    /** Frame a row closely enough for its on-demand seat numbers to be legible. */
+    focusRow(rowId: string): boolean;
     /** The venue's floors (id, name, seat count) in authored order. */
     floors(): SceneFloor[];
     /**
@@ -489,4 +527,4 @@ interface Venue3DHandle {
 }
 declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
 
-export { type Analytics3DCallback, type SeatState3D, type SeatView, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DStats, buildSceneModel, mountVenue3D };
+export { type Analytics3DCallback, type Scene3DPrepSource, type SeatState3D, SeatView, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DStats, buildSceneModel, mountVenue3D, prepareVenue3D };