@seatlayer/js 0.55.0 → 0.57.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-1b6xBWKM.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-CFxx1jp3.cjs';
 
 /**
  * Buyer access context — the browser half of the Sales Channels contract
@@ -393,6 +393,8 @@ interface HoldLineItem {
     unitPrice: number;
     currency: string;
     quantity?: number;
+    /** Channel pricing revision captured when this line used an override. */
+    channelPricingVersion?: number | null;
 }
 declare class ApiError extends Error {
     status: number;
@@ -574,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
@@ -611,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;
@@ -729,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?: {
@@ -971,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"];
@@ -1297,6 +1301,24 @@ interface TicketOfferPrice {
     startsAt?: number | null;
     endsAt?: number | null;
 }
+interface ChannelPriceOverride {
+    categoryKey: string;
+    tierId: string | null;
+    price: number;
+}
+/** Pricing configuration projected only for the private channels in this grant. */
+interface BuyerChannelPricing {
+    assignmentVersion: number;
+    channels: Array<{
+        channelId: string;
+        pricingVersion: number;
+        priceOverrides: ChannelPriceOverride[];
+    }>;
+    objects: Array<{
+        label: string;
+        channelId: string;
+    }>;
+}
 interface TicketOfferAvailability {
     state: SaleState;
     /** Currently advertised offer price, in minor units. */
@@ -1309,6 +1331,7 @@ interface TicketOfferAvailability {
     upcoming: TicketOfferSummary | null;
     /** Server-resolved active offer prices by category, in major units. */
     prices: TicketOfferPrice[];
+    channelPricing: BuyerChannelPricing | null;
 }
 /** Parse a public offer payload without repairing a half-understood price. */
 declare function parseTicketOfferAvailability(body: unknown): TicketOfferAvailability | null;
@@ -1492,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. */
@@ -1717,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;
@@ -1797,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;
@@ -1822,6 +1848,9 @@ declare class SeatPicker {
     /** The event's formatted date-time (event-zone), reused by the closed-state note. */
     private eventWhenText;
     private offerAvailability;
+    /** Server-authoritative channel rules, projected only for this buyer scope. */
+    private readonly channelByObject;
+    private readonly pricesByChannel;
     private hold;
     /** Latest server expiry for the open hold (moves on extend). */
     private holdExpiresAt;
@@ -2144,7 +2173,7 @@ declare class SeatPicker {
     private activeFloorObjects;
     /** Attach the F3 overview minimap into the bottom-left chrome region. */
     private buildMinimap;
-    /** Effective display price of a category: host pricing override → first tier → base. */
+    /** Effective category summary price. Object-specific channel prices are added to the range below. */
     private catPrice;
     /** Complete buyer-visible price range, including every ticket tier and
      * tier-specific host override. */
@@ -2247,11 +2276,12 @@ declare class SeatPicker {
      */
     private refreshOfferAvailability;
     private offerPrice;
+    private applyChannelPricing;
     /** The compact current/upcoming offer card above Ticket prices. */
     private syncOffer;
     /**
-     * The price the buyer will actually pay for a category (+tier): the host's
-     * `pricing` override when present, else the chart's stored price. Every
+     * The price the buyer will actually pay for an object/category/tier: its
+     * scoped channel override, then the host/server offer, then the chart. Every
      * price the widget DISPLAYS or hands off must flow through here — a map
      * that shows one price while checkout charges another destroys trust.
      */
@@ -2275,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;
@@ -2360,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-1b6xBWKM.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-CFxx1jp3.js';
 
 /**
  * Buyer access context — the browser half of the Sales Channels contract
@@ -393,6 +393,8 @@ interface HoldLineItem {
     unitPrice: number;
     currency: string;
     quantity?: number;
+    /** Channel pricing revision captured when this line used an override. */
+    channelPricingVersion?: number | null;
 }
 declare class ApiError extends Error {
     status: number;
@@ -574,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
@@ -611,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;
@@ -729,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?: {
@@ -971,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"];
@@ -1297,6 +1301,24 @@ interface TicketOfferPrice {
     startsAt?: number | null;
     endsAt?: number | null;
 }
+interface ChannelPriceOverride {
+    categoryKey: string;
+    tierId: string | null;
+    price: number;
+}
+/** Pricing configuration projected only for the private channels in this grant. */
+interface BuyerChannelPricing {
+    assignmentVersion: number;
+    channels: Array<{
+        channelId: string;
+        pricingVersion: number;
+        priceOverrides: ChannelPriceOverride[];
+    }>;
+    objects: Array<{
+        label: string;
+        channelId: string;
+    }>;
+}
 interface TicketOfferAvailability {
     state: SaleState;
     /** Currently advertised offer price, in minor units. */
@@ -1309,6 +1331,7 @@ interface TicketOfferAvailability {
     upcoming: TicketOfferSummary | null;
     /** Server-resolved active offer prices by category, in major units. */
     prices: TicketOfferPrice[];
+    channelPricing: BuyerChannelPricing | null;
 }
 /** Parse a public offer payload without repairing a half-understood price. */
 declare function parseTicketOfferAvailability(body: unknown): TicketOfferAvailability | null;
@@ -1492,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. */
@@ -1717,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;
@@ -1797,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;
@@ -1822,6 +1848,9 @@ declare class SeatPicker {
     /** The event's formatted date-time (event-zone), reused by the closed-state note. */
     private eventWhenText;
     private offerAvailability;
+    /** Server-authoritative channel rules, projected only for this buyer scope. */
+    private readonly channelByObject;
+    private readonly pricesByChannel;
     private hold;
     /** Latest server expiry for the open hold (moves on extend). */
     private holdExpiresAt;
@@ -2144,7 +2173,7 @@ declare class SeatPicker {
     private activeFloorObjects;
     /** Attach the F3 overview minimap into the bottom-left chrome region. */
     private buildMinimap;
-    /** Effective display price of a category: host pricing override → first tier → base. */
+    /** Effective category summary price. Object-specific channel prices are added to the range below. */
     private catPrice;
     /** Complete buyer-visible price range, including every ticket tier and
      * tier-specific host override. */
@@ -2247,11 +2276,12 @@ declare class SeatPicker {
      */
     private refreshOfferAvailability;
     private offerPrice;
+    private applyChannelPricing;
     /** The compact current/upcoming offer card above Ticket prices. */
     private syncOffer;
     /**
-     * The price the buyer will actually pay for a category (+tier): the host's
-     * `pricing` override when present, else the chart's stored price. Every
+     * The price the buyer will actually pay for an object/category/tier: its
+     * scoped channel override, then the host/server offer, then the chart. Every
      * price the widget DISPLAYS or hands off must flow through here — a map
      * that shows one price while checkout charges another destroys trust.
      */
@@ -2275,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;
@@ -2360,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