@seatlayer/js 0.29.0 → 0.30.1

package/dist/index.d.cts

@@ -115,8 +115,10 @@ interface SeatingChartOptions {
      * Toggleable later with setColorblindSafe().
      */
     colorblindSafe?: boolean;
-    /** Initial canvas projection. `perspective` enables exact-seat projected
-     * 2.5D picking without changing booking identities or chart geometry. */
+    /** Initial canvas projection.
+     * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
+     * real 3D venue view (`setBuyerView('venue3d')`); they remain accepted for
+     * source compatibility and will be removed in the next major. Use `'flat'`. */
     initialView?: RendererViewMode;
     /**
      * Built-in seat tooltip on mouse hover (seat · category · price · status).
@@ -266,7 +268,10 @@ declare class SeatingChart {
     setFloor(floorId: string): void;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
-    /** Switch between flat, isometric and exact-seat Perspective 2.5D views. */
+    /** Switch the 2D canvas projection.
+     * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
+     * real 3D venue view (`setBuyerView('venue3d')`); accepted for source
+     * compatibility until the next major. */
     setViewMode(mode: RendererViewMode): void;
     /** Current canvas projection. */
     getViewMode(): RendererViewMode;
@@ -1172,9 +1177,34 @@ declare class SeatPicker {
     private normalizeInitialView;
     /** Current buyer view: the flat map, or the interactive 3D venue. */
     getBuyerView(): 'map' | 'venue3d';
-    /** Toggle between the flat Map and the 3D venue view. No-op when unchanged or
-     *  when 3D is unavailable. */
-    setBuyerView(view: 'map' | 'venue3d'): void;
+    /**
+     * Switch between the flat seat **Map** and the interactive **3D venue** view —
+     * the same control the buyer's on-widget `Map | 3D` toggle drives.
+     *
+     * Entering `'venue3d'` with `opts.flyToSeatId` runs the cinematic tour: the
+     * camera flies to the seat and holds in the live scene (a chip offers the
+     * 360° view-from-seat) —
+     * the widget enters 3D and auto-flies the camera to that seat, dissolving into
+     * its view-from-seat panorama (the same chain as tapping "See the view from
+     * here" on a seat's confirm card). When the widget is **already** in the 3D
+     * view, the camera simply flies to the requested seat — the GL scene is not
+     * torn down or rebuilt, so there is no flash or re-entry.
+     *
+     * No-op when the view is unchanged and no `flyToSeatId` is given, or when 3D is
+     * unavailable for this chart.
+     *
+     * @param view              `'map'` for the flat picker, `'venue3d'` for the 3D venue.
+     * @param opts.flyToSeatId  When entering (or already in) `'venue3d'`, the seat
+     *                          id to fly the camera to — cinematic → panorama.
+     *                          Ignored when `view` is `'map'`.
+     *
+     * @example
+     * // Public 3D tour entry — enter 3D and fly straight to the buyer's seat:
+     * picker.setBuyerView('venue3d', { flyToSeatId: 'A-12' });
+     */
+    setBuyerView(view: 'map' | 'venue3d', opts?: {
+        flyToSeatId?: string;
+    }): void;
     /** SeatStatus → the view3d palette state. Selection is layered separately. */
     private seatState3dFor;
     /** Push the full live availability snapshot into the 3D handle (selection is

package/dist/index.d.ts

@@ -115,8 +115,10 @@ interface SeatingChartOptions {
      * Toggleable later with setColorblindSafe().
      */
     colorblindSafe?: boolean;
-    /** Initial canvas projection. `perspective` enables exact-seat projected
-     * 2.5D picking without changing booking identities or chart geometry. */
+    /** Initial canvas projection.
+     * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
+     * real 3D venue view (`setBuyerView('venue3d')`); they remain accepted for
+     * source compatibility and will be removed in the next major. Use `'flat'`. */
     initialView?: RendererViewMode;
     /**
      * Built-in seat tooltip on mouse hover (seat · category · price · status).
@@ -266,7 +268,10 @@ declare class SeatingChart {
     setFloor(floorId: string): void;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
-    /** Switch between flat, isometric and exact-seat Perspective 2.5D views. */
+    /** Switch the 2D canvas projection.
+     * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
+     * real 3D venue view (`setBuyerView('venue3d')`); accepted for source
+     * compatibility until the next major. */
     setViewMode(mode: RendererViewMode): void;
     /** Current canvas projection. */
     getViewMode(): RendererViewMode;
@@ -1172,9 +1177,34 @@ declare class SeatPicker {
     private normalizeInitialView;
     /** Current buyer view: the flat map, or the interactive 3D venue. */
     getBuyerView(): 'map' | 'venue3d';
-    /** Toggle between the flat Map and the 3D venue view. No-op when unchanged or
-     *  when 3D is unavailable. */
-    setBuyerView(view: 'map' | 'venue3d'): void;
+    /**
+     * Switch between the flat seat **Map** and the interactive **3D venue** view —
+     * the same control the buyer's on-widget `Map | 3D` toggle drives.
+     *
+     * Entering `'venue3d'` with `opts.flyToSeatId` runs the cinematic tour: the
+     * camera flies to the seat and holds in the live scene (a chip offers the
+     * 360° view-from-seat) —
+     * the widget enters 3D and auto-flies the camera to that seat, dissolving into
+     * its view-from-seat panorama (the same chain as tapping "See the view from
+     * here" on a seat's confirm card). When the widget is **already** in the 3D
+     * view, the camera simply flies to the requested seat — the GL scene is not
+     * torn down or rebuilt, so there is no flash or re-entry.
+     *
+     * No-op when the view is unchanged and no `flyToSeatId` is given, or when 3D is
+     * unavailable for this chart.
+     *
+     * @param view              `'map'` for the flat picker, `'venue3d'` for the 3D venue.
+     * @param opts.flyToSeatId  When entering (or already in) `'venue3d'`, the seat
+     *                          id to fly the camera to — cinematic → panorama.
+     *                          Ignored when `view` is `'map'`.
+     *
+     * @example
+     * // Public 3D tour entry — enter 3D and fly straight to the buyer's seat:
+     * picker.setBuyerView('venue3d', { flyToSeatId: 'A-12' });
+     */
+    setBuyerView(view: 'map' | 'venue3d', opts?: {
+        flyToSeatId?: string;
+    }): void;
     /** SeatStatus → the view3d palette state. Selection is layered separately. */
     private seatState3dFor;
     /** Push the full live availability snapshot into the 3D handle (selection is

package/dist/index.js

@@ -386,7 +386,10 @@ var SeatingChart = class {
   setColorblindSafe(on) {
     this.controller.setColorblindSafe(on);
   }
-  /** Switch between flat, isometric and exact-seat Perspective 2.5D views. */
+  /** Switch the 2D canvas projection.
+   * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
+   * real 3D venue view (`setBuyerView('venue3d')`); accepted for source
+   * compatibility until the next major. */
   setViewMode(mode) {
     this.controller.setViewMode(mode);
   }
@@ -4524,12 +4527,42 @@ var SeatPicker = class _SeatPicker {
   getBuyerView() {
     return this.buyerView;
   }
-  /** Toggle between the flat Map and the 3D venue view. No-op when unchanged or
-   *  when 3D is unavailable. */
-  setBuyerView(view) {
-    if (view === this.buyerView) return;
-    if (view === "venue3d") void this.enter3d();
-    else this.exit3d();
+  /**
+   * Switch between the flat seat **Map** and the interactive **3D venue** view —
+   * the same control the buyer's on-widget `Map | 3D` toggle drives.
+   *
+   * Entering `'venue3d'` with `opts.flyToSeatId` runs the cinematic tour: the
+   * camera flies to the seat and holds in the live scene (a chip offers the
+   * 360° view-from-seat) —
+   * the widget enters 3D and auto-flies the camera to that seat, dissolving into
+   * its view-from-seat panorama (the same chain as tapping "See the view from
+   * here" on a seat's confirm card). When the widget is **already** in the 3D
+   * view, the camera simply flies to the requested seat — the GL scene is not
+   * torn down or rebuilt, so there is no flash or re-entry.
+   *
+   * No-op when the view is unchanged and no `flyToSeatId` is given, or when 3D is
+   * unavailable for this chart.
+   *
+   * @param view              `'map'` for the flat picker, `'venue3d'` for the 3D venue.
+   * @param opts.flyToSeatId  When entering (or already in) `'venue3d'`, the seat
+   *                          id to fly the camera to — cinematic → panorama.
+   *                          Ignored when `view` is `'map'`.
+   *
+   * @example
+   * // Public 3D tour entry — enter 3D and fly straight to the buyer's seat:
+   * picker.setBuyerView('venue3d', { flyToSeatId: 'A-12' });
+   */
+  setBuyerView(view, opts) {
+    if (view === "map") {
+      this.exit3d();
+      return;
+    }
+    const flyToSeatId = opts?.flyToSeatId;
+    if (this.buyerView === "venue3d") {
+      if (flyToSeatId) void this.view3dHandle?.flyToSeat(flyToSeatId);
+      return;
+    }
+    void this.enter3d(flyToSeatId);
   }
   /** SeatStatus → the view3d palette state. Selection is layered separately. */
   seatState3dFor(id) {