@seatlayer/js 0.71.4 → 0.71.5

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, SeatHoverDetails, FloorLabelStyle, SectionSummary, ChartTheme, LodRung, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AvailabilityRefreshOutcome, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 import { T as ThemeMode } from './channelsMode-goczEzyt.cjs';
 export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, U as InventoryBookingObject, V as InventoryBookingState, W as InventoryBookingsPage, X as InventoryBookingsQuery, Y as LogEntry, Z as LogPage, _ as ManageApi, $ as ManageApiError, a0 as ReportByStatus, a1 as ReportCategoryMeta, a2 as ReportCategoryRow, a3 as ReportResult, a4 as SeatManager, a5 as SeatManagerActionResult, a6 as SeatManagerActivity, a7 as SeatManagerCapability, a8 as SeatManagerConnection, a9 as SeatManagerFilteredSection, aa as SeatManagerMode, ab as SeatManagerOptions, ac as SeatManagerSelectionValidity, ad as SeatManagerTallies, ae as SelectionSourceRow } from './channelsMode-goczEzyt.cjs';
@@ -1291,35 +1291,6 @@ interface SeatPickerOptions {
     onError?: (err: unknown) => void;
 }
 
-/**
- * SeatingChart — the embeddable buyer picker.
- *
- * A thin wrapper over the shared PickerController (src/picker/PickerController):
- * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
- * the holdId to the host page for a server-side book) and delegates all transport
- * + booking to the controller, so the SDK inherits every fix made for the live
- * buyer page and the demo picker.
- */
-
-/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
-type SelectedSeat = PickerSeat;
-interface GAAreaAvailability {
-    id: string;
-    label: string;
-    capacity: number;
-    available: number;
-    categoryKey: string;
-    price: number;
-    currency: string;
-    /** Buyer-facing copy authored separately from stable inventory identity. */
-    displayLabel?: string;
-    displayType?: string;
-    tiers?: Array<{
-        id: string;
-        name: string;
-        price: number;
-    }>;
-}
 /**
  * Serializable state exposed to hosted native picker chrome. It deliberately
  * contains buyer-display data only: never API keys, buyer-access bearers,
@@ -1422,6 +1393,18 @@ interface SeatingChartPickerState {
         categoryFilter: string[] | null;
         accessibilityFilter: string[] | null;
         hideLimitedView: boolean;
+        /**
+         * The access needs THIS event actually offers, with live free counts, in
+         * the engine's canonical order.
+         *
+         * A native or web sheet that renders the whole twelve-key taxonomy offers
+         * provisions the chart does not have — chips that filter to an empty map,
+         * which reads as a venue that has the provision and has sold out of it.
+         * A provision that exists but is currently all taken appears here with
+         * `count: 0`, so "this venue has none" and "this venue's are taken" stay
+         * different answers. Empty on a chart with no accessible inventory.
+         */
+        accessNeeds: PickerAccessNeed[];
     };
     selection: {
         seats: SelectedSeat[];
@@ -1434,6 +1417,36 @@ interface SeatingChartPickerState {
         reason?: string;
     };
 }
+
+/**
+ * SeatingChart — the embeddable buyer picker.
+ *
+ * A thin wrapper over the shared PickerController (src/picker/PickerController):
+ * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
+ * the holdId to the host page for a server-side book) and delegates all transport
+ * + booking to the controller, so the SDK inherits every fix made for the live
+ * buyer page and the demo picker.
+ */
+
+/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
+type SelectedSeat = PickerSeat;
+interface GAAreaAvailability {
+    id: string;
+    label: string;
+    capacity: number;
+    available: number;
+    categoryKey: string;
+    price: number;
+    currency: string;
+    /** Buyer-facing copy authored separately from stable inventory identity. */
+    displayLabel?: string;
+    displayType?: string;
+    tiers?: Array<{
+        id: string;
+        name: string;
+        price: number;
+    }>;
+}
 interface SeatingChartOptions {
     /** CSS selector or an HTMLElement to render into. */
     container: string | HTMLElement;
@@ -1949,8 +1962,17 @@ declare class SeatingChart {
      * and its own legacy frames. Nothing about the public path changes.
      */
     private startRealtime;
-    /** Re-read live inventory without remounting or dropping buyer state. */
-    refreshAvailability(): Promise<void>;
+    /**
+     * Re-read OTHER buyers' inventory without remounting or disturbing this
+     * buyer's own — see `@seatlayer/core`'s `availabilityRefresh`.
+     *
+     * Returns what actually changed for him: seats he had selected but never
+     * held which somebody else has taken (already deselected), and whether his
+     * own hold lapsed while he was away, with the labels that are still free so
+     * a surface can offer them back. Nothing here moves the camera, the rung or
+     * the cart total, and a seat he holds is never reported against him.
+     */
+    refreshAvailability(): Promise<AvailabilityRefreshOutcome>;
     /**
      * Re-acquire the buyer access session — call after your app has re-authorized
      * the buyer (a revoked session cannot be recovered any other way). Resolves
@@ -2736,6 +2758,10 @@ declare class SeatPicker implements GaPromptPicker {
     private ctaPhase;
     /** The ♿ control and its menu — one node, in the map's bottom-left corner. */
     private a11yMenu;
+    private detachAttention;
+    /** The telling of a hold that ended while the buyer was away — the state
+     *  part is the engine's; see pickerHoldLapse.ts. */
+    private readonly lapse;
     /** Rail scroll listener attached once; the rail repaints many times. */
     private railEdgesBound;
     private fsFallback;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, SeatHoverDetails, FloorLabelStyle, SectionSummary, ChartTheme, LodRung, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AvailabilityRefreshOutcome, PickerController, AccessibilityType, ExpandedSeat } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 import { T as ThemeMode } from './channelsMode-goczEzyt.js';
 export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, U as InventoryBookingObject, V as InventoryBookingState, W as InventoryBookingsPage, X as InventoryBookingsQuery, Y as LogEntry, Z as LogPage, _ as ManageApi, $ as ManageApiError, a0 as ReportByStatus, a1 as ReportCategoryMeta, a2 as ReportCategoryRow, a3 as ReportResult, a4 as SeatManager, a5 as SeatManagerActionResult, a6 as SeatManagerActivity, a7 as SeatManagerCapability, a8 as SeatManagerConnection, a9 as SeatManagerFilteredSection, aa as SeatManagerMode, ab as SeatManagerOptions, ac as SeatManagerSelectionValidity, ad as SeatManagerTallies, ae as SelectionSourceRow } from './channelsMode-goczEzyt.js';
@@ -1291,35 +1291,6 @@ interface SeatPickerOptions {
     onError?: (err: unknown) => void;
 }
 
-/**
- * SeatingChart — the embeddable buyer picker.
- *
- * A thin wrapper over the shared PickerController (src/picker/PickerController):
- * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
- * the holdId to the host page for a server-side book) and delegates all transport
- * + booking to the controller, so the SDK inherits every fix made for the live
- * buyer page and the demo picker.
- */
-
-/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
-type SelectedSeat = PickerSeat;
-interface GAAreaAvailability {
-    id: string;
-    label: string;
-    capacity: number;
-    available: number;
-    categoryKey: string;
-    price: number;
-    currency: string;
-    /** Buyer-facing copy authored separately from stable inventory identity. */
-    displayLabel?: string;
-    displayType?: string;
-    tiers?: Array<{
-        id: string;
-        name: string;
-        price: number;
-    }>;
-}
 /**
  * Serializable state exposed to hosted native picker chrome. It deliberately
  * contains buyer-display data only: never API keys, buyer-access bearers,
@@ -1422,6 +1393,18 @@ interface SeatingChartPickerState {
         categoryFilter: string[] | null;
         accessibilityFilter: string[] | null;
         hideLimitedView: boolean;
+        /**
+         * The access needs THIS event actually offers, with live free counts, in
+         * the engine's canonical order.
+         *
+         * A native or web sheet that renders the whole twelve-key taxonomy offers
+         * provisions the chart does not have — chips that filter to an empty map,
+         * which reads as a venue that has the provision and has sold out of it.
+         * A provision that exists but is currently all taken appears here with
+         * `count: 0`, so "this venue has none" and "this venue's are taken" stay
+         * different answers. Empty on a chart with no accessible inventory.
+         */
+        accessNeeds: PickerAccessNeed[];
     };
     selection: {
         seats: SelectedSeat[];
@@ -1434,6 +1417,36 @@ interface SeatingChartPickerState {
         reason?: string;
     };
 }
+
+/**
+ * SeatingChart — the embeddable buyer picker.
+ *
+ * A thin wrapper over the shared PickerController (src/picker/PickerController):
+ * it owns the mount <div> + the public embed contract (hold-only — the SDK hands
+ * the holdId to the host page for a server-side book) and delegates all transport
+ * + booking to the controller, so the SDK inherits every fix made for the live
+ * buyer page and the demo picker.
+ */
+
+/** A seat as surfaced to the host page (prices resolved from the chart's categories). */
+type SelectedSeat = PickerSeat;
+interface GAAreaAvailability {
+    id: string;
+    label: string;
+    capacity: number;
+    available: number;
+    categoryKey: string;
+    price: number;
+    currency: string;
+    /** Buyer-facing copy authored separately from stable inventory identity. */
+    displayLabel?: string;
+    displayType?: string;
+    tiers?: Array<{
+        id: string;
+        name: string;
+        price: number;
+    }>;
+}
 interface SeatingChartOptions {
     /** CSS selector or an HTMLElement to render into. */
     container: string | HTMLElement;
@@ -1949,8 +1962,17 @@ declare class SeatingChart {
      * and its own legacy frames. Nothing about the public path changes.
      */
     private startRealtime;
-    /** Re-read live inventory without remounting or dropping buyer state. */
-    refreshAvailability(): Promise<void>;
+    /**
+     * Re-read OTHER buyers' inventory without remounting or disturbing this
+     * buyer's own — see `@seatlayer/core`'s `availabilityRefresh`.
+     *
+     * Returns what actually changed for him: seats he had selected but never
+     * held which somebody else has taken (already deselected), and whether his
+     * own hold lapsed while he was away, with the labels that are still free so
+     * a surface can offer them back. Nothing here moves the camera, the rung or
+     * the cart total, and a seat he holds is never reported against him.
+     */
+    refreshAvailability(): Promise<AvailabilityRefreshOutcome>;
     /**
      * Re-acquire the buyer access session — call after your app has re-authorized
      * the buyer (a revoked session cannot be recovered any other way). Resolves
@@ -2736,6 +2758,10 @@ declare class SeatPicker implements GaPromptPicker {
     private ctaPhase;
     /** The ♿ control and its menu — one node, in the map's bottom-left corner. */
     private a11yMenu;
+    private detachAttention;
+    /** The telling of a hold that ended while the buyer was away — the state
+     *  part is the engine's; see pickerHoldLapse.ts. */
+    private readonly lapse;
     /** Rail scroll listener attached once; the rail repaints many times. */
     private railEdgesBound;
     private fsFallback;