@seatlayer/core 0.56.0 → 0.58.0

package/dist/index.d.cts

@@ -1052,14 +1052,12 @@ interface PickerTransport {
 interface PickerCallbacks extends RendererCallbacks {
     /** Selection changed (manual clicks or a server best-available pick). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
-    /**
-     * Exact-selection validity changed. Emitted only when
-     * `numberOfPlacesToSelect` is configured, after `onSelectionChange`.
-     */
+    /** Selection validity changed. Emitted after `onSelectionChange` whenever
+     * exact quantity or `selectionValidators` is configured. */
     onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
-    /** The configured exact selection count has just been reached. */
+    /** The configured selection rules have just become valid. */
     onSelectionValid?: (seats: PickerSeat[]) => void;
-    /** The current selection does not yet match the configured exact count. */
+    /** The configured selection rules have just become invalid. */
     onSelectionInvalid?: (state: PickerSelectionValidity) => void;
     /** A grouped table was selected and needs buyer confirmation/guest quantity. */
     onTableSelectionRequest?: (table: TableSelectionDetails) => void;
@@ -1113,6 +1111,9 @@ interface PickerOptions extends PickerCallbacks {
      * selection cap when `maxSelection` is omitted.
      */
     numberOfPlacesToSelect?: number;
+    /** Buyer selection rules evaluated locally after every change and enforced
+     * again before a hold. The array is additive to `numberOfPlacesToSelect`. */
+    selectionValidators?: PickerSelectionValidator[];
     /** Renderer confirm-card mode (host shows a confirm popover instead of instant cart add). */
     confirmSelection?: boolean;
     /** ISO 4217 currency for on-map prices (default from money.DEFAULT_CURRENCY). */
@@ -1139,13 +1140,27 @@ interface PickerOptions extends PickerCallbacks {
      */
     mapTheme?: PickerMapTheme | null;
 }
-/** Exact-count state shared by the bare chart, full picker, and wrappers. */
+/** Supported buyer selection rules. Unknown rules fail at construction so a
+ * typo cannot silently disable a sale guard. */
+type PickerSelectionValidator = {
+    type: 'minimumSelectedPlaces';
+    minimum: number;
+} | {
+    type: 'consecutiveSeats';
+} | {
+    type: 'noOrphanSeats';
+};
+type PickerSelectionViolation = 'numberOfPlacesToSelect' | PickerSelectionValidator['type'];
+/** Selection-rule state shared by the bare chart, full picker, and wrappers.
+ * Existing exact-count consumers retain every original field; `violations` is
+ * additive and empty when the selection is valid. */
 interface PickerSelectionValidity {
     isValid: boolean;
     count: number;
     required: number;
     remaining: number;
     seats: PickerSeat[];
+    violations: PickerSelectionViolation[];
 }
 /** Privacy-safe timings for one buyer-map load. Values are milliseconds and
  * contain no chart, seat, hold, buyer, or URL data. Hosts may aggregate these
@@ -1193,6 +1208,7 @@ declare class PickerController {
     private readonly key;
     private maxSelection;
     private readonly numberOfPlacesToSelect;
+    private readonly selectionValidators;
     private selectableObjectRefs;
     private selectableSeatIds;
     private lastSelectionValidity;
@@ -1342,7 +1358,8 @@ declare class PickerController {
     deselectCategories(categoryKeys: string[]): void;
     /** Replace the buyer-selectable object allow-list without rebuilding. */
     setSelectableObjects(references: string[] | null): void;
-    getSelectionValidity(): PickerSelectionValidity | null;
+    getSelectionValidity(countOverride?: number): PickerSelectionValidity | null;
+    private hasOrphanedSelection;
     private rebuildSelectableSeatIds;
     private isSelectableByPolicy;
     /** Confirm/update the guest quantity for a selected variable table. */
@@ -1821,4 +1838,4 @@ declare function formatMinor(minor: number, currency?: string, locale?: string):
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { AccessibilityType, CURRENCY_CHOICES, CategoryTier, ChartDoc, DEFAULT_CURRENCY, type Dict, ExpandedSeat, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, type Locale, LodRung, type MoneyFormatOptions, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerRenderPerformanceProfile, type PickerSeat, PickerSelectionError, type PickerSelectionValidity, type PickerStatusChange, type PickerTransport, Point, RendererCallbacks, RendererMinimapSnapshot, RendererOptions, RendererQualityEvidence, RendererViewMode, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionSummary, type TableSelectionDetails, createRenderer, currencyExponent, currencySymbol, formatDate, formatMinor, formatMoney, fromMinorUnits, generateSeatPanorama, generateSeatThumb, getLocale, loadLocale, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, t, tCount };
+export { AccessibilityType, CURRENCY_CHOICES, CategoryTier, ChartDoc, DEFAULT_CURRENCY, type Dict, ExpandedSeat, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, type Locale, LodRung, type MoneyFormatOptions, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerRenderPerformanceProfile, type PickerSeat, PickerSelectionError, type PickerSelectionValidator, type PickerSelectionValidity, type PickerSelectionViolation, type PickerStatusChange, type PickerTransport, Point, RendererCallbacks, RendererMinimapSnapshot, RendererOptions, RendererQualityEvidence, RendererViewMode, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionSummary, type TableSelectionDetails, createRenderer, currencyExponent, currencySymbol, formatDate, formatMinor, formatMoney, fromMinorUnits, generateSeatPanorama, generateSeatThumb, getLocale, loadLocale, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, t, tCount };

package/dist/index.d.ts

@@ -1052,14 +1052,12 @@ interface PickerTransport {
 interface PickerCallbacks extends RendererCallbacks {
     /** Selection changed (manual clicks or a server best-available pick). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
-    /**
-     * Exact-selection validity changed. Emitted only when
-     * `numberOfPlacesToSelect` is configured, after `onSelectionChange`.
-     */
+    /** Selection validity changed. Emitted after `onSelectionChange` whenever
+     * exact quantity or `selectionValidators` is configured. */
     onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
-    /** The configured exact selection count has just been reached. */
+    /** The configured selection rules have just become valid. */
     onSelectionValid?: (seats: PickerSeat[]) => void;
-    /** The current selection does not yet match the configured exact count. */
+    /** The configured selection rules have just become invalid. */
     onSelectionInvalid?: (state: PickerSelectionValidity) => void;
     /** A grouped table was selected and needs buyer confirmation/guest quantity. */
     onTableSelectionRequest?: (table: TableSelectionDetails) => void;
@@ -1113,6 +1111,9 @@ interface PickerOptions extends PickerCallbacks {
      * selection cap when `maxSelection` is omitted.
      */
     numberOfPlacesToSelect?: number;
+    /** Buyer selection rules evaluated locally after every change and enforced
+     * again before a hold. The array is additive to `numberOfPlacesToSelect`. */
+    selectionValidators?: PickerSelectionValidator[];
     /** Renderer confirm-card mode (host shows a confirm popover instead of instant cart add). */
     confirmSelection?: boolean;
     /** ISO 4217 currency for on-map prices (default from money.DEFAULT_CURRENCY). */
@@ -1139,13 +1140,27 @@ interface PickerOptions extends PickerCallbacks {
      */
     mapTheme?: PickerMapTheme | null;
 }
-/** Exact-count state shared by the bare chart, full picker, and wrappers. */
+/** Supported buyer selection rules. Unknown rules fail at construction so a
+ * typo cannot silently disable a sale guard. */
+type PickerSelectionValidator = {
+    type: 'minimumSelectedPlaces';
+    minimum: number;
+} | {
+    type: 'consecutiveSeats';
+} | {
+    type: 'noOrphanSeats';
+};
+type PickerSelectionViolation = 'numberOfPlacesToSelect' | PickerSelectionValidator['type'];
+/** Selection-rule state shared by the bare chart, full picker, and wrappers.
+ * Existing exact-count consumers retain every original field; `violations` is
+ * additive and empty when the selection is valid. */
 interface PickerSelectionValidity {
     isValid: boolean;
     count: number;
     required: number;
     remaining: number;
     seats: PickerSeat[];
+    violations: PickerSelectionViolation[];
 }
 /** Privacy-safe timings for one buyer-map load. Values are milliseconds and
  * contain no chart, seat, hold, buyer, or URL data. Hosts may aggregate these
@@ -1193,6 +1208,7 @@ declare class PickerController {
     private readonly key;
     private maxSelection;
     private readonly numberOfPlacesToSelect;
+    private readonly selectionValidators;
     private selectableObjectRefs;
     private selectableSeatIds;
     private lastSelectionValidity;
@@ -1342,7 +1358,8 @@ declare class PickerController {
     deselectCategories(categoryKeys: string[]): void;
     /** Replace the buyer-selectable object allow-list without rebuilding. */
     setSelectableObjects(references: string[] | null): void;
-    getSelectionValidity(): PickerSelectionValidity | null;
+    getSelectionValidity(countOverride?: number): PickerSelectionValidity | null;
+    private hasOrphanedSelection;
     private rebuildSelectableSeatIds;
     private isSelectableByPolicy;
     /** Confirm/update the guest quantity for a selected variable table. */
@@ -1821,4 +1838,4 @@ declare function formatMinor(minor: number, currency?: string, locale?: string):
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { AccessibilityType, CURRENCY_CHOICES, CategoryTier, ChartDoc, DEFAULT_CURRENCY, type Dict, ExpandedSeat, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, type Locale, LodRung, type MoneyFormatOptions, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerRenderPerformanceProfile, type PickerSeat, PickerSelectionError, type PickerSelectionValidity, type PickerStatusChange, type PickerTransport, Point, RendererCallbacks, RendererMinimapSnapshot, RendererOptions, RendererQualityEvidence, RendererViewMode, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionSummary, type TableSelectionDetails, createRenderer, currencyExponent, currencySymbol, formatDate, formatMinor, formatMoney, fromMinorUnits, generateSeatPanorama, generateSeatThumb, getLocale, loadLocale, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, t, tCount };
+export { AccessibilityType, CURRENCY_CHOICES, CategoryTier, ChartDoc, DEFAULT_CURRENCY, type Dict, ExpandedSeat, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, type Locale, LodRung, type MoneyFormatOptions, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerRenderPerformanceProfile, type PickerSeat, PickerSelectionError, type PickerSelectionValidator, type PickerSelectionValidity, type PickerSelectionViolation, type PickerStatusChange, type PickerTransport, Point, RendererCallbacks, RendererMinimapSnapshot, RendererOptions, RendererQualityEvidence, RendererViewMode, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionSummary, type TableSelectionDetails, createRenderer, currencyExponent, currencySymbol, formatDate, formatMinor, formatMoney, fromMinorUnits, generateSeatPanorama, generateSeatThumb, getLocale, loadLocale, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, t, tCount };