@seatlayer/js 0.89.2 → 0.90.0

package/dist/index.d.cts

@@ -1200,8 +1200,17 @@ interface SeatPickerOptions {
      * sections as soon as the chart lands and fills the seats in a section at a
      * time, nearest the viewport first; 'plain' builds the whole scene in one
      * step. Small charts are built in one step either way.
+     *
+     * 'viewport' is an opt-in mode for very large charts. It keeps the section
+     * overview light and builds seat graphics only for the visible or focused
+     * sections, retaining a bounded warm cache as the buyer moves. It applies to
+     * sectioned flat charts and is never selected automatically: the widget uses
+     * it only when this option is set to 'viewport'. Seat availability, search
+     * and selection still cover every seat. Because every seat is never built at
+     * once in this mode, `onSeatsRevealed` and the `chart_seats_revealed`
+     * analytics event do not fire.
      */
-    loadingReveal?: 'progressive' | 'plain';
+    loadingReveal?: 'progressive' | 'plain' | 'viewport';
     /** Initial map projection. Buyers now toggle **Map (flat 2D) + 3D** only; the
      * legacy `perspective` (2.5D) value is still ACCEPTED for source compatibility
      * but is deprecated — it is coerced to `flat` with a one-time console warning.
@@ -1266,7 +1275,9 @@ interface SeatPickerOptions {
      * rest arrive in idle slices. A host that needs "the whole venue is on
      * screen" waits for this rather than for `render()`. Fires exactly once per
      * chart, and never for a chart small enough to build in one step (there is
-     * nothing to wait for: `render()` already was that moment).
+     * nothing to wait for: `render()` already was that moment). It also never
+     * fires with `loadingReveal: 'viewport'`, where only the seats around the
+     * current view are built.
      */
     onSeatsRevealed?: () => void;
     /**
@@ -3998,6 +4009,10 @@ declare class SeatPicker implements GaPromptPicker {
     /** Elapsed since `render()` resolved, or undefined when it never did. */
     private sinceRenderResolved;
     /** @internal */ whenSeatsRevealed(run: () => void): void;
+    /** True only when the host opted into `loadingReveal: 'viewport'`. */
+    private viewportLoading;
+    /** Run queued seat work once, in order, each step fenced from the next. */
+    private drainSeatsRevealedWaiters;
     /** Keep returning buyers behind the veil until their hold is authoritative. */
     private restoreHoldForFirstPaint;
     /** Resume a redirect checkout from this tab's storage, never from the URL. */

package/dist/index.d.ts

@@ -1200,8 +1200,17 @@ interface SeatPickerOptions {
      * sections as soon as the chart lands and fills the seats in a section at a
      * time, nearest the viewport first; 'plain' builds the whole scene in one
      * step. Small charts are built in one step either way.
+     *
+     * 'viewport' is an opt-in mode for very large charts. It keeps the section
+     * overview light and builds seat graphics only for the visible or focused
+     * sections, retaining a bounded warm cache as the buyer moves. It applies to
+     * sectioned flat charts and is never selected automatically: the widget uses
+     * it only when this option is set to 'viewport'. Seat availability, search
+     * and selection still cover every seat. Because every seat is never built at
+     * once in this mode, `onSeatsRevealed` and the `chart_seats_revealed`
+     * analytics event do not fire.
      */
-    loadingReveal?: 'progressive' | 'plain';
+    loadingReveal?: 'progressive' | 'plain' | 'viewport';
     /** Initial map projection. Buyers now toggle **Map (flat 2D) + 3D** only; the
      * legacy `perspective` (2.5D) value is still ACCEPTED for source compatibility
      * but is deprecated — it is coerced to `flat` with a one-time console warning.
@@ -1266,7 +1275,9 @@ interface SeatPickerOptions {
      * rest arrive in idle slices. A host that needs "the whole venue is on
      * screen" waits for this rather than for `render()`. Fires exactly once per
      * chart, and never for a chart small enough to build in one step (there is
-     * nothing to wait for: `render()` already was that moment).
+     * nothing to wait for: `render()` already was that moment). It also never
+     * fires with `loadingReveal: 'viewport'`, where only the seats around the
+     * current view are built.
      */
     onSeatsRevealed?: () => void;
     /**
@@ -3998,6 +4009,10 @@ declare class SeatPicker implements GaPromptPicker {
     /** Elapsed since `render()` resolved, or undefined when it never did. */
     private sinceRenderResolved;
     /** @internal */ whenSeatsRevealed(run: () => void): void;
+    /** True only when the host opted into `loadingReveal: 'viewport'`. */
+    private viewportLoading;
+    /** Run queued seat work once, in order, each step fenced from the next. */
+    private drainSeatsRevealedWaiters;
     /** Keep returning buyers behind the veil until their hold is authoritative. */
     private restoreHoldForFirstPaint;
     /** Resume a redirect checkout from this tab's storage, never from the URL. */