@seatlayer/js 0.16.1 → 0.18.0

package/dist/index.d.cts

@@ -242,6 +242,25 @@ interface EmbeddedDesignerOptions {
     style?: Partial<CSSStyleDeclaration>;
     allow?: string;
     referrerPolicy?: ReferrerPolicy;
+    /**
+     * Show the built-in branded loading skeleton and error/expiry card inside the
+     * container while the Designer boots. Defaults to `true`. Set `false` when the
+     * host renders its own loading and error chrome.
+     */
+    showLoadingState?: boolean;
+    /**
+     * If the Designer never posts `ready` within this many milliseconds, the host
+     * transitions to the error card with a timeout message. Defaults to `20000`.
+     * Only used when `showLoadingState` is enabled.
+     */
+    loadingTimeoutMs?: number;
+    /**
+     * Called when the user presses "Try again" on the error card. Use it to mint a
+     * fresh Designer session and call `setDesignerUrl()` with the new URL, which
+     * recreates the iframe and returns to the loading state. When omitted, "Try
+     * again" reloads the current `designerUrl` in place.
+     */
+    onRequestRelaunch?: () => void;
     onReady?: (message: EmbeddedDesignerMessage) => void;
     onSaved?: (message: EmbeddedDesignerMessage) => void;
     onPublished?: (message: EmbeddedDesignerMessage) => void;
@@ -253,12 +272,30 @@ declare class EmbeddedDesigner {
     private options;
     private frame;
     private designerOrigin;
+    private overlay;
+    private timeoutTimer;
+    private phase;
+    private restoreContainerPosition;
     constructor(options: EmbeddedDesignerOptions);
     mount(): HTMLIFrameElement;
     /** Replace the iframe instead of assigning a new fragment to an existing one. */
     setDesignerUrl(designerUrl: string): HTMLIFrameElement;
     getIframe(): HTMLIFrameElement | null;
     destroy(): void;
+    private loadingStateEnabled;
+    private clearTimeoutTimer;
+    private ensureContainerPositioned;
+    private restoreContainerStyle;
+    private removeOverlay;
+    private showError;
+    private handleTryAgain;
+    /**
+     * Build (or rebuild) the overlay for the given phase. A single overlay element
+     * is reused so we never stack stale skeletons or cards.
+     */
+    private renderOverlay;
+    private buildSkeleton;
+    private buildErrorCard;
     private handleMessage;
 }
 
@@ -929,6 +966,9 @@ interface SeatManagerActivity {
     /** Human verb: held / booked / released / blocked / unblocked. */
     verb: string;
     status: DoStatus;
+    /** Spatial context for grouped activity when the chart defines sections. */
+    sectionIds?: string[];
+    sectionLabels?: string[];
 }
 /** Fired after a successful organizer action, for host toasts/telemetry. */
 interface SeatManagerActionResult {
@@ -959,6 +999,11 @@ interface SeatManagerOptions {
      * rAF throttling on occluded tabs never leaves the board stale. Default true.
      */
     keepLiveWhileHidden?: boolean;
+    /**
+     * Opt in to camera-following for new buyer holds/bookings. Off by default so
+     * a live event never steals an operator's current map context.
+     */
+    followLive?: boolean;
     /** Chart + first snapshot are loaded and the board is live. */
     onReady?: () => void;
     /** Live KPI tallies changed. */
@@ -974,6 +1019,8 @@ interface SeatManagerOptions {
     }>;
     /** Tool/mode changed from inside the shared cockpit. */
     onModeChange?: (mode: SeatManagerMode) => void;
+    /** Follow-live preference changed from inside the cockpit. */
+    onFollowLiveChange?: (enabled: boolean) => void;
     /** Block-mode selection changed (marquee / ⌘A / category / section / tap). */
     onSelectionChange?: (seats: ExpandedSeat[]) => void;
     /** A block/unblock/cancel action completed successfully. */
@@ -1004,6 +1051,9 @@ declare class SeatManager {
     private controlRoomSnapshot;
     private trendWindowMinutes;
     private heatEnabled;
+    private followLive;
+    private lastKpiValues;
+    private activeKpiDeltas;
     private ws;
     private reconnectTimer;
     private attempt;
@@ -1012,6 +1062,10 @@ declare class SeatManager {
     private feed;
     private feedTimer;
     private toastTimer;
+    private liveEventTimer;
+    private kpiCleanupTimer;
+    private followLiveTimer;
+    private followSeatTimer;
     private releaseAt;
     private layoutObserver;
     private tokenExpiresAt;
@@ -1026,12 +1080,15 @@ declare class SeatManager {
     private unblockAllConfirmTimer;
     private readonly onFullscreenChange;
     private readonly onKeyDown;
+    private readonly onRailClick;
     constructor(options: SeatManagerOptions);
     /** Build the DOM, load the chart, subscribe to realtime, mount the board. */
     render(): Promise<this>;
     setMode(mode: SeatManagerMode): void;
     /** Toggle the normalized sales-velocity outline overlay without changing seat colors. */
     setHeatOverlay(enabled: boolean): void;
+    /** Toggle opt-in camera following for new buyer hold/book events. */
+    setFollowLive(enabled: boolean): void;
     /** Change the current-vs-previous sales window and refresh the private projection. */
     setTrendWindow(windowMinutes: number): Promise<ControlRoomSnapshot>;
     enterFullscreen(): Promise<void>;
@@ -1084,7 +1141,14 @@ declare class SeatManager {
     private setSeatsLocal;
     /** Keep the canvas painting on hidden/occluded tabs (war-room second monitor). */
     private afterPaint;
-    private flash;
+    private activityColor;
+    private sectionsForLabels;
+    private pulseSeatLabels;
+    /** Render one grouped realtime operation at the right semantic zoom level. */
+    private paintSpatialActivity;
+    private locateSection;
+    private locateActivity;
+    private showLiveEvent;
     private applyReportRevenue;
     private refreshControlRoom;
     private scheduleRevenueRefresh;
@@ -1100,12 +1164,14 @@ declare class SeatManager {
     private sectionOptions;
     private buildSectionOptions;
     private paintModeTabs;
+    private paintFollowLiveButton;
     private paintHeatButton;
     private paintMomentumHelp;
     private paintFullscreenButton;
     private paintTrendWindow;
     private setLive;
     private updateZoomHint;
+    private formatKpiDelta;
     private paintKpis;
     private paintRail;
     private renderViewRail;

package/dist/index.d.ts

@@ -242,6 +242,25 @@ interface EmbeddedDesignerOptions {
     style?: Partial<CSSStyleDeclaration>;
     allow?: string;
     referrerPolicy?: ReferrerPolicy;
+    /**
+     * Show the built-in branded loading skeleton and error/expiry card inside the
+     * container while the Designer boots. Defaults to `true`. Set `false` when the
+     * host renders its own loading and error chrome.
+     */
+    showLoadingState?: boolean;
+    /**
+     * If the Designer never posts `ready` within this many milliseconds, the host
+     * transitions to the error card with a timeout message. Defaults to `20000`.
+     * Only used when `showLoadingState` is enabled.
+     */
+    loadingTimeoutMs?: number;
+    /**
+     * Called when the user presses "Try again" on the error card. Use it to mint a
+     * fresh Designer session and call `setDesignerUrl()` with the new URL, which
+     * recreates the iframe and returns to the loading state. When omitted, "Try
+     * again" reloads the current `designerUrl` in place.
+     */
+    onRequestRelaunch?: () => void;
     onReady?: (message: EmbeddedDesignerMessage) => void;
     onSaved?: (message: EmbeddedDesignerMessage) => void;
     onPublished?: (message: EmbeddedDesignerMessage) => void;
@@ -253,12 +272,30 @@ declare class EmbeddedDesigner {
     private options;
     private frame;
     private designerOrigin;
+    private overlay;
+    private timeoutTimer;
+    private phase;
+    private restoreContainerPosition;
     constructor(options: EmbeddedDesignerOptions);
     mount(): HTMLIFrameElement;
     /** Replace the iframe instead of assigning a new fragment to an existing one. */
     setDesignerUrl(designerUrl: string): HTMLIFrameElement;
     getIframe(): HTMLIFrameElement | null;
     destroy(): void;
+    private loadingStateEnabled;
+    private clearTimeoutTimer;
+    private ensureContainerPositioned;
+    private restoreContainerStyle;
+    private removeOverlay;
+    private showError;
+    private handleTryAgain;
+    /**
+     * Build (or rebuild) the overlay for the given phase. A single overlay element
+     * is reused so we never stack stale skeletons or cards.
+     */
+    private renderOverlay;
+    private buildSkeleton;
+    private buildErrorCard;
     private handleMessage;
 }
 
@@ -929,6 +966,9 @@ interface SeatManagerActivity {
     /** Human verb: held / booked / released / blocked / unblocked. */
     verb: string;
     status: DoStatus;
+    /** Spatial context for grouped activity when the chart defines sections. */
+    sectionIds?: string[];
+    sectionLabels?: string[];
 }
 /** Fired after a successful organizer action, for host toasts/telemetry. */
 interface SeatManagerActionResult {
@@ -959,6 +999,11 @@ interface SeatManagerOptions {
      * rAF throttling on occluded tabs never leaves the board stale. Default true.
      */
     keepLiveWhileHidden?: boolean;
+    /**
+     * Opt in to camera-following for new buyer holds/bookings. Off by default so
+     * a live event never steals an operator's current map context.
+     */
+    followLive?: boolean;
     /** Chart + first snapshot are loaded and the board is live. */
     onReady?: () => void;
     /** Live KPI tallies changed. */
@@ -974,6 +1019,8 @@ interface SeatManagerOptions {
     }>;
     /** Tool/mode changed from inside the shared cockpit. */
     onModeChange?: (mode: SeatManagerMode) => void;
+    /** Follow-live preference changed from inside the cockpit. */
+    onFollowLiveChange?: (enabled: boolean) => void;
     /** Block-mode selection changed (marquee / ⌘A / category / section / tap). */
     onSelectionChange?: (seats: ExpandedSeat[]) => void;
     /** A block/unblock/cancel action completed successfully. */
@@ -1004,6 +1051,9 @@ declare class SeatManager {
     private controlRoomSnapshot;
     private trendWindowMinutes;
     private heatEnabled;
+    private followLive;
+    private lastKpiValues;
+    private activeKpiDeltas;
     private ws;
     private reconnectTimer;
     private attempt;
@@ -1012,6 +1062,10 @@ declare class SeatManager {
     private feed;
     private feedTimer;
     private toastTimer;
+    private liveEventTimer;
+    private kpiCleanupTimer;
+    private followLiveTimer;
+    private followSeatTimer;
     private releaseAt;
     private layoutObserver;
     private tokenExpiresAt;
@@ -1026,12 +1080,15 @@ declare class SeatManager {
     private unblockAllConfirmTimer;
     private readonly onFullscreenChange;
     private readonly onKeyDown;
+    private readonly onRailClick;
     constructor(options: SeatManagerOptions);
     /** Build the DOM, load the chart, subscribe to realtime, mount the board. */
     render(): Promise<this>;
     setMode(mode: SeatManagerMode): void;
     /** Toggle the normalized sales-velocity outline overlay without changing seat colors. */
     setHeatOverlay(enabled: boolean): void;
+    /** Toggle opt-in camera following for new buyer hold/book events. */
+    setFollowLive(enabled: boolean): void;
     /** Change the current-vs-previous sales window and refresh the private projection. */
     setTrendWindow(windowMinutes: number): Promise<ControlRoomSnapshot>;
     enterFullscreen(): Promise<void>;
@@ -1084,7 +1141,14 @@ declare class SeatManager {
     private setSeatsLocal;
     /** Keep the canvas painting on hidden/occluded tabs (war-room second monitor). */
     private afterPaint;
-    private flash;
+    private activityColor;
+    private sectionsForLabels;
+    private pulseSeatLabels;
+    /** Render one grouped realtime operation at the right semantic zoom level. */
+    private paintSpatialActivity;
+    private locateSection;
+    private locateActivity;
+    private showLiveEvent;
     private applyReportRevenue;
     private refreshControlRoom;
     private scheduleRevenueRefresh;
@@ -1100,12 +1164,14 @@ declare class SeatManager {
     private sectionOptions;
     private buildSectionOptions;
     private paintModeTabs;
+    private paintFollowLiveButton;
     private paintHeatButton;
     private paintMomentumHelp;
     private paintFullscreenButton;
     private paintTrendWindow;
     private setLive;
     private updateZoomHint;
+    private formatKpiDelta;
     private paintKpis;
     private paintRail;
     private renderViewRail;