@seatlayer/js 0.56.0 → 0.58.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } from '@seatlayer/core';
-export { ExpandedSeat, PickerMapTheme, PickerSelectionValidity, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
-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, T as InventoryBookingObject, U as InventoryBookingState, V as InventoryBookingsPage, W as InventoryBookingsQuery, X as LogEntry, Y as LogPage, Z as ManageApi, _ as ManageApiError, $ as ReportByStatus, a0 as ReportCategoryMeta, a1 as ReportCategoryRow, a2 as ReportResult, a3 as SeatManager, a4 as SeatManagerActionResult, a5 as SeatManagerActivity, a6 as SeatManagerCapability, a7 as SeatManagerConnection, a8 as SeatManagerFilteredSection, a9 as SeatManagerMode, aa as SeatManagerOptions, ab as SeatManagerSelectionValidity, ac as SeatManagerTallies, ad as SelectionSourceRow } from './channelsMode-CFxx1jp3.cjs';
+import { PickerSeat, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } from '@seatlayer/core';
+export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
+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, T as InventoryBookingObject, U as InventoryBookingState, V as InventoryBookingsPage, W as InventoryBookingsQuery, X as LogEntry, Y as LogPage, Z as ManageApi, _ as ManageApiError, $ as ReportByStatus, a0 as ReportCategoryMeta, a1 as ReportCategoryRow, a2 as ReportResult, a3 as SeatManager, a4 as SeatManagerActionResult, a5 as SeatManagerActivity, a6 as SeatManagerCapability, a7 as SeatManagerConnection, a8 as SeatManagerFilteredSection, a9 as SeatManagerMode, aa as SeatManagerOptions, ab as SeatManagerSelectionValidity, ac as SeatManagerTallies, ad as SelectionSourceRow } from './channelsMode-2z9HBOAX.cjs';
 
 /**
  * Buyer access context — the browser half of the Sales Channels contract
@@ -576,6 +576,8 @@ interface SeatingChartOptions {
     selectableObjects?: string[] | null;
     /** Require exactly this many seated/table guest units before the selection is valid. */
     numberOfPlacesToSelect?: number;
+    /** Optional local selection guards, enforced again before hold. */
+    selectionValidators?: PickerSelectionValidator[];
     /**
      * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to
      * the browser language, then English. Built-in: en, es, de, fr. The German
@@ -613,11 +615,11 @@ interface SeatingChartOptions {
      */
     onSeatHover?: (details: SeatHoverDetails | null) => void;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
-    /** Exact-count state after each selection change. */
+    /** Selection-rule state after each selection change. */
     onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
-    /** The exact configured count has just been reached. */
+    /** The configured selection rules have just become valid. */
     onSelectionValid?: (seats: SelectedSeat[]) => void;
-    /** The current selection does not match the configured exact count. */
+    /** The configured selection rules have just become invalid. */
     onSelectionInvalid?: (state: PickerSelectionValidity) => void;
     /** A manual or programmatic selection reached the active maximum. */
     onSelectionLimit?: (maxSelection: number) => void;
@@ -731,7 +733,7 @@ declare class SeatingChart {
     setSelectableObjects(objects: string[] | null): void;
     /** Change the selection cap without remounting. */
     setMaxSelection(maxSelection: number): void;
-    /** Current exact-count validity, or null when no exact count was configured. */
+    /** Current selection-rule validity, or null when no rules were configured. */
     getSelectionValidity(): PickerSelectionValidity | null;
     /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */
     hold(options?: {
@@ -973,10 +975,10 @@ declare function bindSeatingChartHandle(getInstance: () => SeatingChart | null):
  * two behaviours. React already treated them this way; Vue and Angular did not
  * expose them at all.
  */
-declare const SEATING_CHART_IDENTITY_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay"];
+declare const SEATING_CHART_IDENTITY_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "selectionValidators", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay"];
 type SeatingChartIdentityProp = (typeof SEATING_CHART_IDENTITY_PROPS)[number];
 /** Non-callback options a wrapper accepts as props/inputs and passes straight through. */
-declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "selectedObjects", "selectableObjects", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
+declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "selectionValidators", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "selectedObjects", "selectableObjects", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
 type SeatingChartValueProp = (typeof SEATING_CHART_VALUE_PROPS)[number];
 /** Every callback option a wrapper wires to its own event mechanism. */
 declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
@@ -1513,6 +1515,9 @@ interface SeatPickerOptions {
     selectableObjects?: string[] | null;
     /** Require exactly this many total seated/table/GA guest units before checkout. */
     numberOfPlacesToSelect?: number;
+    /** Optional sale guards evaluated after every change and enforced before a
+     * hold: minimum quantity, consecutive seats, and/or no stranded singles. */
+    selectionValidators?: PickerSelectionValidator[];
     /** BCP 47 language for the widget UI. Built-in: en, es, de, fr. */
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
@@ -1738,11 +1743,11 @@ interface SeatPickerOptions {
     onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
-    /** Exact-count state after each selection change. */
+    /** Selection-rule state after each selection change. */
     onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
-    /** The configured exact ticket count has just been reached. */
+    /** The configured selection rules have just become valid. */
     onSelectionValid?: (seats: PickerSeat[]) => void;
-    /** The current selection does not match the configured exact ticket count. */
+    /** The configured selection rules have just become invalid. */
     onSelectionInvalid?: (state: PickerSelectionValidity) => void;
     /** A selection attempt reached the active maximum. */
     onSelectionLimit?: (maxSelection: number) => void;
@@ -1818,7 +1823,7 @@ declare class SeatPicker {
     private maxTickets;
     /** Exact ticket count required before checkout; null keeps ordinary 1..max behavior. */
     private readonly exactTickets;
-    private lastExactSelectionValidity;
+    private lastSelectionValidity;
     /** Original host pricing, kept separate from live server offer overrides. */
     private readonly hostPricing;
     private root;
@@ -2300,7 +2305,7 @@ declare class SeatPicker {
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
     private evictTakenSelections;
     private syncTray;
-    private emitExactSelectionValidity;
+    private emitSelectionValidity;
     /** Paint the bottom-sheet's collapsed one-liner (pickerTray.ts builds it). */
     private renderPeek;
     private removeHeldLabel;
@@ -2385,7 +2390,7 @@ declare class SeatPicker {
     setSelectableObjects(objects: string[] | null): void;
     /** Change the order selection cap without remounting. */
     setMaxSelection(maxSelection: number): void;
-    /** Current exact-count validity, including held and pending GA tickets. */
+    /** Current selection-rule validity, including held and pending GA tickets. */
     getSelectionValidity(): PickerSelectionValidity | null;
     /**
      * Re-ink the DRAWN MAP after mount, so the canvas can follow a page palette

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } from '@seatlayer/core';
-export { ExpandedSeat, PickerMapTheme, PickerSelectionValidity, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
-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, T as InventoryBookingObject, U as InventoryBookingState, V as InventoryBookingsPage, W as InventoryBookingsQuery, X as LogEntry, Y as LogPage, Z as ManageApi, _ as ManageApiError, $ as ReportByStatus, a0 as ReportCategoryMeta, a1 as ReportCategoryRow, a2 as ReportResult, a3 as SeatManager, a4 as SeatManagerActionResult, a5 as SeatManagerActivity, a6 as SeatManagerCapability, a7 as SeatManagerConnection, a8 as SeatManagerFilteredSection, a9 as SeatManagerMode, aa as SeatManagerOptions, ab as SeatManagerSelectionValidity, ac as SeatManagerTallies, ad as SelectionSourceRow } from './channelsMode-CFxx1jp3.js';
+import { PickerSeat, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerTransport, PickerMapTheme } from '@seatlayer/core';
+export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
+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, T as InventoryBookingObject, U as InventoryBookingState, V as InventoryBookingsPage, W as InventoryBookingsQuery, X as LogEntry, Y as LogPage, Z as ManageApi, _ as ManageApiError, $ as ReportByStatus, a0 as ReportCategoryMeta, a1 as ReportCategoryRow, a2 as ReportResult, a3 as SeatManager, a4 as SeatManagerActionResult, a5 as SeatManagerActivity, a6 as SeatManagerCapability, a7 as SeatManagerConnection, a8 as SeatManagerFilteredSection, a9 as SeatManagerMode, aa as SeatManagerOptions, ab as SeatManagerSelectionValidity, ac as SeatManagerTallies, ad as SelectionSourceRow } from './channelsMode-2z9HBOAX.js';
 
 /**
  * Buyer access context — the browser half of the Sales Channels contract
@@ -576,6 +576,8 @@ interface SeatingChartOptions {
     selectableObjects?: string[] | null;
     /** Require exactly this many seated/table guest units before the selection is valid. */
     numberOfPlacesToSelect?: number;
+    /** Optional local selection guards, enforced again before hold. */
+    selectionValidators?: PickerSelectionValidator[];
     /**
      * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to
      * the browser language, then English. Built-in: en, es, de, fr. The German
@@ -613,11 +615,11 @@ interface SeatingChartOptions {
      */
     onSeatHover?: (details: SeatHoverDetails | null) => void;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
-    /** Exact-count state after each selection change. */
+    /** Selection-rule state after each selection change. */
     onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
-    /** The exact configured count has just been reached. */
+    /** The configured selection rules have just become valid. */
     onSelectionValid?: (seats: SelectedSeat[]) => void;
-    /** The current selection does not match the configured exact count. */
+    /** The configured selection rules have just become invalid. */
     onSelectionInvalid?: (state: PickerSelectionValidity) => void;
     /** A manual or programmatic selection reached the active maximum. */
     onSelectionLimit?: (maxSelection: number) => void;
@@ -731,7 +733,7 @@ declare class SeatingChart {
     setSelectableObjects(objects: string[] | null): void;
     /** Change the selection cap without remounting. */
     setMaxSelection(maxSelection: number): void;
-    /** Current exact-count validity, or null when no exact count was configured. */
+    /** Current selection-rule validity, or null when no rules were configured. */
     getSelectionValidity(): PickerSelectionValidity | null;
     /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */
     hold(options?: {
@@ -973,10 +975,10 @@ declare function bindSeatingChartHandle(getInstance: () => SeatingChart | null):
  * two behaviours. React already treated them this way; Vue and Angular did not
  * expose them at all.
  */
-declare const SEATING_CHART_IDENTITY_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay"];
+declare const SEATING_CHART_IDENTITY_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "selectionValidators", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay"];
 type SeatingChartIdentityProp = (typeof SEATING_CHART_IDENTITY_PROPS)[number];
 /** Non-callback options a wrapper accepts as props/inputs and passes straight through. */
-declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "selectedObjects", "selectableObjects", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
+declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "selectionValidators", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "selectedObjects", "selectableObjects", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
 type SeatingChartValueProp = (typeof SEATING_CHART_VALUE_PROPS)[number];
 /** Every callback option a wrapper wires to its own event mechanism. */
 declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
@@ -1513,6 +1515,9 @@ interface SeatPickerOptions {
     selectableObjects?: string[] | null;
     /** Require exactly this many total seated/table/GA guest units before checkout. */
     numberOfPlacesToSelect?: number;
+    /** Optional sale guards evaluated after every change and enforced before a
+     * hold: minimum quantity, consecutive seats, and/or no stranded singles. */
+    selectionValidators?: PickerSelectionValidator[];
     /** BCP 47 language for the widget UI. Built-in: en, es, de, fr. */
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
@@ -1738,11 +1743,11 @@ interface SeatPickerOptions {
     onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
-    /** Exact-count state after each selection change. */
+    /** Selection-rule state after each selection change. */
     onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
-    /** The configured exact ticket count has just been reached. */
+    /** The configured selection rules have just become valid. */
     onSelectionValid?: (seats: PickerSeat[]) => void;
-    /** The current selection does not match the configured exact ticket count. */
+    /** The configured selection rules have just become invalid. */
     onSelectionInvalid?: (state: PickerSelectionValidity) => void;
     /** A selection attempt reached the active maximum. */
     onSelectionLimit?: (maxSelection: number) => void;
@@ -1818,7 +1823,7 @@ declare class SeatPicker {
     private maxTickets;
     /** Exact ticket count required before checkout; null keeps ordinary 1..max behavior. */
     private readonly exactTickets;
-    private lastExactSelectionValidity;
+    private lastSelectionValidity;
     /** Original host pricing, kept separate from live server offer overrides. */
     private readonly hostPricing;
     private root;
@@ -2300,7 +2305,7 @@ declare class SeatPicker {
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
     private evictTakenSelections;
     private syncTray;
-    private emitExactSelectionValidity;
+    private emitSelectionValidity;
     /** Paint the bottom-sheet's collapsed one-liner (pickerTray.ts builds it). */
     private renderPeek;
     private removeHeldLabel;
@@ -2385,7 +2390,7 @@ declare class SeatPicker {
     setSelectableObjects(objects: string[] | null): void;
     /** Change the order selection cap without remounting. */
     setMaxSelection(maxSelection: number): void;
-    /** Current exact-count validity, including held and pending GA tickets. */
+    /** Current selection-rule validity, including held and pending GA tickets. */
     getSelectionValidity(): PickerSelectionValidity | null;
     /**
      * Re-ink the DRAWN MAP after mount, so the canvas can follow a page palette