@seatlayer/js 0.29.0 → 0.30.0

package/README.md

@@ -1,12 +1,24 @@
 # @seatlayer/js
 
-The framework-agnostic [SeatLayer](https://seatlayer.io) embed SDK. Render an
-interactive seat map, let buyers select and **hold** seats in the browser, then
-**book** them from your server. Full docs: <https://docs.seatlayer.io>
+[![npm](https://img.shields.io/npm/v/@seatlayer/js)](https://www.npmjs.com/package/@seatlayer/js)
+[![npm downloads](https://img.shields.io/npm/dm/@seatlayer/js)](https://www.npmjs.com/package/@seatlayer/js)
+[![License: MIT](https://img.shields.io/badge/license-MIT-111827.svg)](../../LICENSE)
+
+The framework-agnostic SeatLayer embed SDK. Render the complete buyer picker or
+a headless interactive chart, let buyers select and **hold** inventory in the
+browser, then **book** it from your trusted server.
+
+[Package on npm](https://www.npmjs.com/package/@seatlayer/js) ·
+[Install guide](https://docs.seatlayer.io/buyer-sdk/install/) ·
+[Live demo](https://app.seatlayer.io/demo/play) ·
+[Website](https://seatlayer.io/developers/) ·
+[AI Toolkit](https://github.com/seatlayer/seatlayer-ai-toolkit)
 
 Works in plain HTML and any framework (React, Vue, Svelte, Angular…). For React,
 prefer the [`@seatlayer/react`](https://www.npmjs.com/package/@seatlayer/react) wrapper.
 
+## Install
+
 ```bash
 npm install @seatlayer/js
 ```
@@ -186,5 +198,20 @@ The full `SeatPicker` automatically restores an active hold after same-tab
 checkout navigation and lets the buyer remove individual held tickets. Set
 `restoreHold: false` and pass `initialHoldId` when your host owns persistence.
 
-The browser **holds**; your **server books** with a secret key. See the
-[integration guide](https://docs.seatlayer.io/getting-started/how-it-works/).
+The browser **holds**; your **server books** with a secret key. See
+[how the integration works](https://docs.seatlayer.io/start/how-it-works/).
+
+## Related resources
+
+- [Buyer SDK documentation](https://docs.seatlayer.io/buyer-sdk/install/)
+- [SeatingChart reference](https://docs.seatlayer.io/buyer-sdk/seating-chart/)
+- [Holds and checkout](https://docs.seatlayer.io/buyer-sdk/holds-and-checkout/)
+- [Complete checkout example](https://docs.seatlayer.io/examples/complete-checkout/)
+- [`@seatlayer/react`](https://www.npmjs.com/package/@seatlayer/react)
+- [iOS SDK](https://github.com/seatlayer/seatlayer-ios)
+- [Flutter package](https://pub.dev/packages/seatlayer)
+- [Agent-readable documentation](https://docs.seatlayer.io/llms.txt)
+
+## License
+
+MIT © SeatLayer

package/dist/index.cjs

@@ -424,7 +424,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);
   }
@@ -4553,12 +4556,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) {