@seatlayer/js 0.46.0 → 0.47.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerTransport } from '@seatlayer/core';
+import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerTransport, PickerMapTheme } from '@seatlayer/core';
 export { ExpandedSeat, SeatHoverDetails } from '@seatlayer/core';
 import { C as ChannelListResult, a as ChannelAllocationPage, b as ChannelRecord, A as AssignmentResult, c as ChannelPreviewProjection, d as ChannelAccessIntent, e as AccessLinkReveal, f as AccessLinkStatusRecord, g as ChannelSeatStatus, B as BucketRow } from './manager-CAIPkUYl.cjs';
 export { h as ACCESS_LINK_DEFAULTS, i as AccessIntentForbidsDetails, j as AccessLinkRecord, k as AccessLinkState, l as AccessLinkStatus, m as ArchiveBlockedDetails, n as AssignmentBuckets, o as AssignmentDropDetails, p as ChannelAccessSummary, q as ChannelAuditEntry, r as ChannelAuditPage, s as ChannelCounts, t as ChannelState, u as ControlRoomActivityEntry, v as ControlRoomSectionMetric, w as ControlRoomSnapshot, I as IntentSwitchBlockedDetails, L as LogEntry, x as LogPage, M as ManageApi, y as ManageApiError, P as PUBLIC_CHANNEL_ID, z as PUBLIC_CHANNEL_NAME, R as ReportByStatus, D as ReportCategoryMeta, E as ReportCategoryRow, F as ReportResult, S as SeatManager, G as SeatManagerActionResult, H as SeatManagerActivity, J as SeatManagerCapability, K as SeatManagerConnection, N as SeatManagerMode, O as SeatManagerOptions, Q as SeatManagerTallies, T as SelectionSourceRow, U as accessIntentDescription, V as accessIntentLabel, W as accessLine, X as accessLinkBadge, Y as accessLinkErrorCopy, Z as accessLinkIsLive, _ as accessLinkPolicyLines, $ as bucketRows, a0 as dropReviewRows, a1 as intentForbidsCopy, a2 as intentSwitchBlockedCopy, a3 as isPublicChannelId, a4 as markerLetter, a5 as markerOf, a6 as mutationCount, a7 as needsMoveConfirmation, a8 as planAssignment, a9 as retryAfterCopy, aa as selectionSources, ab as stateBadge, ac as suggestMarker } from './manager-CAIPkUYl.cjs';
@@ -232,10 +232,21 @@ interface RealtimeSink {
     /** Apply a batch of label→status changes. Implementations must paint this as
      *  ONE pass, not one pass per label (motion system §4 rule 2). */
     applyStatuses(changes: StatusChange[]): void;
+    /**
+     * Paint a COMPLETE projection — the default plus the units that differ.
+     *
+     * Every case that cannot be expressed as a bounded diff (the first snapshot,
+     * or a changed default) still arrives as a whole authoritative projection: the
+     * client holds it, it just has no way to hand it over. This is that way, and
+     * where a sink provides it the {@link resync} round trip is skipped entirely.
+     *
+     * Optional, so an older sink keeps working unchanged.
+     */
+    applyProjection?(projection: Projection): void;
     /** Re-pull authoritative state over the scoped HTTP route. Used when a frame
      *  cannot be diffed against what we hold (first snapshot, or the scope's
      *  default itself changed, which redefines every unit we were never told
-     *  about). */
+     *  about), and the sink cannot take a whole projection. */
     resync(): void | Promise<void>;
     /** Section availability changed (channel-agnostic; identical for every scope). */
     onSections?(hidden: string[], closed: string[]): void;
@@ -464,6 +475,19 @@ interface OrderStatusResult {
     currency: string;
     amountFormatted: string;
     seatCount: number;
+    eventName?: string | null;
+    venue?: string | null;
+    startsAt?: number | null;
+    tickets?: Array<{
+        label: string;
+        token: string;
+        status: 'issued' | 'checked_in' | 'void';
+        checkedInAt: number | null;
+    }>;
+    /** Hosted ticket page — the durable re-entry point after the modal closes. */
+    ticketUrl?: string;
+    /** Printable PDF, one page per ticket. */
+    pdfUrl?: string;
 }
 interface PubApiOptions {
     /**
@@ -1146,6 +1170,24 @@ interface SeatPickerTheme {
     logoUrl?: string;
     /** Brand/event fallback name for the monogram. */
     brandName?: string;
+    /**
+     * The DRAWN MAP, which the tokens above deliberately do not reach.
+     *
+     * Everything else on this interface is CSS: it re-inks panels, buttons and
+     * the sidebar. The seat map is a canvas, painted from the chart document's
+     * own `ChartTheme`, so a host could re-ink the whole widget and still be
+     * looking at somebody else's dark venue in the middle of it (which is exactly
+     * what SeatLayer's own light event-page palettes did, found 2026-08-07).
+     *
+     * Nested rather than flattened because `background` already means the
+     * WIDGET's background here and the canvas ground is a different surface —
+     * two things one word cannot carry.
+     *
+     * Set it only when you can vouch for the result: these colours are drawn
+     * behind and beside live seat statuses (held, sold, selected), and the map is
+     * the one part of this widget a buyer has to be able to read.
+     */
+    map?: PickerMapTheme;
 }
 interface SeatPickerOptions {
     /** CSS selector or element to mount into. Omit when using SeatPicker.open(). */
@@ -1224,10 +1266,19 @@ interface SeatPickerOptions {
      * on a phone. Offering 3D there is offering a stall. A host that knows its
      * audience can raise this; the ceiling goes away when seat streaming lands. */
     max3DSeats?: number;
+    /**
+     * Fires when the buyer enters/leaves 3D or targets a seat there. Hosts can
+     * mirror this small, non-sensitive state into a shareable URL.
+     */
+    onBuyerViewChange?: (state: {
+        view: 'map' | 'venue3d';
+        seatId?: string;
+    }) => void;
     /**
      * Optional analytics sink for the widget's own journey events. Currently emits
      * the 3D venue-view journey (`3d_opened`, `3d_orbit_engaged`, `3d_seat_picked`,
-     * `3d_cinematic_played`/`_skipped`/`_cancelled`, `3d_panorama_opened`/`_closed`)
+     * `3d_cinematic_played`/`_skipped`/`_cancelled`, panorama outcomes, and WebGL
+     * context loss/recovery)
      * with `{ surface: 'buyer' }` merged into the props. A throwing sink never
      * breaks the widget. Route it to your product analytics (e.g. PostHog). */
     onAnalytics?: (event: string, props: Record<string, unknown>) => void;
@@ -1538,8 +1589,8 @@ declare class SeatPicker {
     /**
      * Eager sightline preview for the confirm card: the organizer's real view
      * photo, or — only when the chart has an actual stage to look at — a generated
-     * forward view plus an "≈ Nm to stage · clear sightline" line. On a stageless
-     * chart both the distance/sightline claim and the generic stage silhouette are
+     * forward view plus an approximate distance-to-stage line. On a stageless
+     * chart both the distance claim and the generic stage silhouette are
      * invented promises, so we suppress them; a real attached photo always shows.
      * (OV-52)
      */
@@ -1591,6 +1642,7 @@ declare class SeatPicker {
     private reportFramedHeight;
     /** Full screen via the native API, falling back to a fixed-position overlay (iOS Safari). */
     private toggleFullscreen;
+    private syncFullscreenButtons;
     /**
      * Native element-fullscreen was unavailable or rejected. When framed, a CSS
      * `.sl-fs` overlay can't escape the iframe, so we ask the host page to pin us
@@ -1899,6 +1951,43 @@ declare class SeatPicker {
     private rowShort;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /**
+     * Re-ink the DRAWN MAP after mount, so the canvas can follow a page palette
+     * the host did not know at construction time.
+     *
+     * Deliberately narrower than the `theme` option: it takes only the map half.
+     * The chrome half is CSS custom properties, which a host restyles from its
+     * own stylesheet without asking the widget for anything — and a host that
+     * used both mechanisms at once would have two things writing one token. This
+     * method exists for the half CSS genuinely cannot reach: pixels Konva draws.
+     *
+     * The rebuild is the controller's (`setMapTheme`), which repaints statuses
+     * from the map already in memory and restores the selection, so a buyer
+     * mid-pick keeps their seats and no round trip is spent. A no-op when the
+     * colours have not changed; safe to call on every render.
+     */
+    setMapTheme(map: PickerMapTheme | null): void;
+    /**
+     * Replace the host pricing override AFTER mount, and repaint everything that
+     * shows a price.
+     *
+     * WHY IT CANNOT JUST BE A MOUNT OPTION. The prices a host knows are often not
+     * the prices it knows AT MOUNT: SeatLayer's own event page learns them from
+     * `GET /pub/events/:key/availability`, a separate cached read that lands a
+     * round trip after the map does — deliberately, because the map is not
+     * allowed to wait on it. Remounting the widget to hand it new options would
+     * tear down a live hold, so the override is settable in place.
+     *
+     * The prices themselves are still the SERVER'S. This method takes an answer;
+     * it never derives one. Nothing here re-reads a release, a window or a quota
+     * — see `paidPrice`, the one funnel every displayed price flows through, and
+     * note that the checkout handoff's line items do not come from here at all:
+     * they are priced by the worker from its own hold. So the worst a wrong call
+     * to this method can do is misprint a price, never mischarge one.
+     *
+     * A no-op when the map is unchanged, so a host may call it on every poll.
+     */
+    setPricing(pricing: SeatPickerPricing | undefined): void;
     /** Current colorblind-safe render state, resolved from the stored buyer
      *  preference at mount. Host chrome (e.g. the Designer preview) reads this to
      *  surface the state rather than rendering colorblind colors silently. */
@@ -1925,10 +2014,7 @@ declare class SeatPicker {
      *
      * 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
+     * 360° view-from-seat). 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.
      *
@@ -1937,7 +2023,7 @@ declare class SeatPicker {
      *
      * @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.
+     *                          id to fly the camera to — cinematic → live seat view.
      *                          Ignored when `view` is `'map'`.
      *
      * @example
@@ -1946,6 +2032,7 @@ declare class SeatPicker {
      */
     setBuyerView(view: 'map' | 'venue3d', opts?: {
         flyToSeatId?: string;
+        resetView?: boolean;
     }): void;
     /** SeatStatus → the view3d palette state. Selection is layered separately. */
     private seatState3dFor;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerTransport } from '@seatlayer/core';
+import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerTransport, PickerMapTheme } from '@seatlayer/core';
 export { ExpandedSeat, SeatHoverDetails } from '@seatlayer/core';
 import { C as ChannelListResult, a as ChannelAllocationPage, b as ChannelRecord, A as AssignmentResult, c as ChannelPreviewProjection, d as ChannelAccessIntent, e as AccessLinkReveal, f as AccessLinkStatusRecord, g as ChannelSeatStatus, B as BucketRow } from './manager-CAIPkUYl.js';
 export { h as ACCESS_LINK_DEFAULTS, i as AccessIntentForbidsDetails, j as AccessLinkRecord, k as AccessLinkState, l as AccessLinkStatus, m as ArchiveBlockedDetails, n as AssignmentBuckets, o as AssignmentDropDetails, p as ChannelAccessSummary, q as ChannelAuditEntry, r as ChannelAuditPage, s as ChannelCounts, t as ChannelState, u as ControlRoomActivityEntry, v as ControlRoomSectionMetric, w as ControlRoomSnapshot, I as IntentSwitchBlockedDetails, L as LogEntry, x as LogPage, M as ManageApi, y as ManageApiError, P as PUBLIC_CHANNEL_ID, z as PUBLIC_CHANNEL_NAME, R as ReportByStatus, D as ReportCategoryMeta, E as ReportCategoryRow, F as ReportResult, S as SeatManager, G as SeatManagerActionResult, H as SeatManagerActivity, J as SeatManagerCapability, K as SeatManagerConnection, N as SeatManagerMode, O as SeatManagerOptions, Q as SeatManagerTallies, T as SelectionSourceRow, U as accessIntentDescription, V as accessIntentLabel, W as accessLine, X as accessLinkBadge, Y as accessLinkErrorCopy, Z as accessLinkIsLive, _ as accessLinkPolicyLines, $ as bucketRows, a0 as dropReviewRows, a1 as intentForbidsCopy, a2 as intentSwitchBlockedCopy, a3 as isPublicChannelId, a4 as markerLetter, a5 as markerOf, a6 as mutationCount, a7 as needsMoveConfirmation, a8 as planAssignment, a9 as retryAfterCopy, aa as selectionSources, ab as stateBadge, ac as suggestMarker } from './manager-CAIPkUYl.js';
@@ -232,10 +232,21 @@ interface RealtimeSink {
     /** Apply a batch of label→status changes. Implementations must paint this as
      *  ONE pass, not one pass per label (motion system §4 rule 2). */
     applyStatuses(changes: StatusChange[]): void;
+    /**
+     * Paint a COMPLETE projection — the default plus the units that differ.
+     *
+     * Every case that cannot be expressed as a bounded diff (the first snapshot,
+     * or a changed default) still arrives as a whole authoritative projection: the
+     * client holds it, it just has no way to hand it over. This is that way, and
+     * where a sink provides it the {@link resync} round trip is skipped entirely.
+     *
+     * Optional, so an older sink keeps working unchanged.
+     */
+    applyProjection?(projection: Projection): void;
     /** Re-pull authoritative state over the scoped HTTP route. Used when a frame
      *  cannot be diffed against what we hold (first snapshot, or the scope's
      *  default itself changed, which redefines every unit we were never told
-     *  about). */
+     *  about), and the sink cannot take a whole projection. */
     resync(): void | Promise<void>;
     /** Section availability changed (channel-agnostic; identical for every scope). */
     onSections?(hidden: string[], closed: string[]): void;
@@ -464,6 +475,19 @@ interface OrderStatusResult {
     currency: string;
     amountFormatted: string;
     seatCount: number;
+    eventName?: string | null;
+    venue?: string | null;
+    startsAt?: number | null;
+    tickets?: Array<{
+        label: string;
+        token: string;
+        status: 'issued' | 'checked_in' | 'void';
+        checkedInAt: number | null;
+    }>;
+    /** Hosted ticket page — the durable re-entry point after the modal closes. */
+    ticketUrl?: string;
+    /** Printable PDF, one page per ticket. */
+    pdfUrl?: string;
 }
 interface PubApiOptions {
     /**
@@ -1146,6 +1170,24 @@ interface SeatPickerTheme {
     logoUrl?: string;
     /** Brand/event fallback name for the monogram. */
     brandName?: string;
+    /**
+     * The DRAWN MAP, which the tokens above deliberately do not reach.
+     *
+     * Everything else on this interface is CSS: it re-inks panels, buttons and
+     * the sidebar. The seat map is a canvas, painted from the chart document's
+     * own `ChartTheme`, so a host could re-ink the whole widget and still be
+     * looking at somebody else's dark venue in the middle of it (which is exactly
+     * what SeatLayer's own light event-page palettes did, found 2026-08-07).
+     *
+     * Nested rather than flattened because `background` already means the
+     * WIDGET's background here and the canvas ground is a different surface —
+     * two things one word cannot carry.
+     *
+     * Set it only when you can vouch for the result: these colours are drawn
+     * behind and beside live seat statuses (held, sold, selected), and the map is
+     * the one part of this widget a buyer has to be able to read.
+     */
+    map?: PickerMapTheme;
 }
 interface SeatPickerOptions {
     /** CSS selector or element to mount into. Omit when using SeatPicker.open(). */
@@ -1224,10 +1266,19 @@ interface SeatPickerOptions {
      * on a phone. Offering 3D there is offering a stall. A host that knows its
      * audience can raise this; the ceiling goes away when seat streaming lands. */
     max3DSeats?: number;
+    /**
+     * Fires when the buyer enters/leaves 3D or targets a seat there. Hosts can
+     * mirror this small, non-sensitive state into a shareable URL.
+     */
+    onBuyerViewChange?: (state: {
+        view: 'map' | 'venue3d';
+        seatId?: string;
+    }) => void;
     /**
      * Optional analytics sink for the widget's own journey events. Currently emits
      * the 3D venue-view journey (`3d_opened`, `3d_orbit_engaged`, `3d_seat_picked`,
-     * `3d_cinematic_played`/`_skipped`/`_cancelled`, `3d_panorama_opened`/`_closed`)
+     * `3d_cinematic_played`/`_skipped`/`_cancelled`, panorama outcomes, and WebGL
+     * context loss/recovery)
      * with `{ surface: 'buyer' }` merged into the props. A throwing sink never
      * breaks the widget. Route it to your product analytics (e.g. PostHog). */
     onAnalytics?: (event: string, props: Record<string, unknown>) => void;
@@ -1538,8 +1589,8 @@ declare class SeatPicker {
     /**
      * Eager sightline preview for the confirm card: the organizer's real view
      * photo, or — only when the chart has an actual stage to look at — a generated
-     * forward view plus an "≈ Nm to stage · clear sightline" line. On a stageless
-     * chart both the distance/sightline claim and the generic stage silhouette are
+     * forward view plus an approximate distance-to-stage line. On a stageless
+     * chart both the distance claim and the generic stage silhouette are
      * invented promises, so we suppress them; a real attached photo always shows.
      * (OV-52)
      */
@@ -1591,6 +1642,7 @@ declare class SeatPicker {
     private reportFramedHeight;
     /** Full screen via the native API, falling back to a fixed-position overlay (iOS Safari). */
     private toggleFullscreen;
+    private syncFullscreenButtons;
     /**
      * Native element-fullscreen was unavailable or rejected. When framed, a CSS
      * `.sl-fs` overlay can't escape the iframe, so we ask the host page to pin us
@@ -1899,6 +1951,43 @@ declare class SeatPicker {
     private rowShort;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /**
+     * Re-ink the DRAWN MAP after mount, so the canvas can follow a page palette
+     * the host did not know at construction time.
+     *
+     * Deliberately narrower than the `theme` option: it takes only the map half.
+     * The chrome half is CSS custom properties, which a host restyles from its
+     * own stylesheet without asking the widget for anything — and a host that
+     * used both mechanisms at once would have two things writing one token. This
+     * method exists for the half CSS genuinely cannot reach: pixels Konva draws.
+     *
+     * The rebuild is the controller's (`setMapTheme`), which repaints statuses
+     * from the map already in memory and restores the selection, so a buyer
+     * mid-pick keeps their seats and no round trip is spent. A no-op when the
+     * colours have not changed; safe to call on every render.
+     */
+    setMapTheme(map: PickerMapTheme | null): void;
+    /**
+     * Replace the host pricing override AFTER mount, and repaint everything that
+     * shows a price.
+     *
+     * WHY IT CANNOT JUST BE A MOUNT OPTION. The prices a host knows are often not
+     * the prices it knows AT MOUNT: SeatLayer's own event page learns them from
+     * `GET /pub/events/:key/availability`, a separate cached read that lands a
+     * round trip after the map does — deliberately, because the map is not
+     * allowed to wait on it. Remounting the widget to hand it new options would
+     * tear down a live hold, so the override is settable in place.
+     *
+     * The prices themselves are still the SERVER'S. This method takes an answer;
+     * it never derives one. Nothing here re-reads a release, a window or a quota
+     * — see `paidPrice`, the one funnel every displayed price flows through, and
+     * note that the checkout handoff's line items do not come from here at all:
+     * they are priced by the worker from its own hold. So the worst a wrong call
+     * to this method can do is misprint a price, never mischarge one.
+     *
+     * A no-op when the map is unchanged, so a host may call it on every poll.
+     */
+    setPricing(pricing: SeatPickerPricing | undefined): void;
     /** Current colorblind-safe render state, resolved from the stored buyer
      *  preference at mount. Host chrome (e.g. the Designer preview) reads this to
      *  surface the state rather than rendering colorblind colors silently. */
@@ -1925,10 +2014,7 @@ declare class SeatPicker {
      *
      * 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
+     * 360° view-from-seat). 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.
      *
@@ -1937,7 +2023,7 @@ declare class SeatPicker {
      *
      * @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.
+     *                          id to fly the camera to — cinematic → live seat view.
      *                          Ignored when `view` is `'map'`.
      *
      * @example
@@ -1946,6 +2032,7 @@ declare class SeatPicker {
      */
     setBuyerView(view: 'map' | 'venue3d', opts?: {
         flyToSeatId?: string;
+        resetView?: boolean;
     }): void;
     /** SeatStatus → the view3d palette state. Selection is layered separately. */
     private seatState3dFor;