@seatlayer/js 0.54.0 → 0.56.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerTransport, PickerMapTheme } from '@seatlayer/core';
-export { ExpandedSeat, PickerMapTheme, 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 EventScopedManageToken, M as IntentSwitchBlockedDetails, N as InventoryBooking, O as InventoryBookingActivity, P as InventoryBookingDetail, Q as InventoryBookingObject, R as InventoryBookingState, S as InventoryBookingsPage, T as InventoryBookingsQuery, U as LogEntry, V as LogPage, W as ManageApi, X as ManageApiError, Y as ReportByStatus, Z as ReportCategoryMeta, _ as ReportCategoryRow, $ as ReportResult, a0 as SeatManager, a1 as SeatManagerActionResult, a2 as SeatManagerActivity, a3 as SeatManagerCapability, a4 as SeatManagerConnection, a5 as SeatManagerMode, a6 as SeatManagerOptions, a7 as SeatManagerTallies, a8 as SelectionSourceRow } from './channelsMode-BX7s9bUl.cjs';
+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';
 
 /**
  * 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;
@@ -568,6 +570,12 @@ interface SeatingChartOptions {
     buyerAccessToken?: string | BuyerAccessToken;
     /** Max seats selectable at once (default 10). */
     maxSelection?: number;
+    /** Object ids or public labels selected after live availability is loaded. */
+    selectedObjects?: string[];
+    /** Object ids or public labels the buyer may select. Omit for all free objects. */
+    selectableObjects?: string[] | null;
+    /** Require exactly this many seated/table guest units before the selection is valid. */
+    numberOfPlacesToSelect?: number;
     /**
      * 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
@@ -605,6 +613,14 @@ interface SeatingChartOptions {
      */
     onSeatHover?: (details: SeatHoverDetails | null) => void;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
+    /** Exact-count state after each selection change. */
+    onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
+    /** The exact configured count has just been reached. */
+    onSelectionValid?: (seats: SelectedSeat[]) => void;
+    /** The current selection does not match the configured exact count. */
+    onSelectionInvalid?: (state: PickerSelectionValidity) => void;
+    /** A manual or programmatic selection reached the active maximum. */
+    onSelectionLimit?: (maxSelection: number) => void;
     onHold?: (result: HoldResult) => void;
     /** A prior active hold was restored with resumeHold(). */
     onHoldRestored?: (result: HoldResult) => void;
@@ -701,6 +717,22 @@ declare class SeatingChart {
     getMode(): 'live' | 'test' | null;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
+    /** Select free objects by engine id or public label. Returns newly selected objects. */
+    selectObjects(objects: string[]): SelectedSeat[];
+    /** Deselect objects by engine id or public label. */
+    deselectObjects(objects: string[]): void;
+    /** Clear every unheld selection. */
+    clearSelection(): void;
+    /** Select every selectable object in the named categories. */
+    selectCategories(categoryKeys: string[]): SelectedSeat[];
+    /** Deselect every selected object in the named categories. */
+    deselectCategories(categoryKeys: string[]): void;
+    /** Replace the buyer-selectable object allow-list without remounting. */
+    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. */
+    getSelectionValidity(): PickerSelectionValidity | null;
     /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */
     hold(options?: {
         ttlMs?: number;
@@ -871,6 +903,22 @@ interface SeatingChartHandle {
     releaseLabels(labels: string[]): Promise<boolean>;
     /** The current selection, with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
+    /** Select free objects by engine id or public label. */
+    selectObjects(objects: string[]): SelectedSeat[];
+    /** Deselect objects by engine id or public label. */
+    deselectObjects(objects: string[]): void;
+    /** Clear every unheld selection. */
+    clearSelection(): void;
+    /** Select every selectable object in the named categories. */
+    selectCategories(categoryKeys: string[]): SelectedSeat[];
+    /** Deselect every selected object in the named categories. */
+    deselectCategories(categoryKeys: string[]): void;
+    /** Replace the buyer-selectable object allow-list without rebuilding. */
+    setSelectableObjects(objects: string[] | null): void;
+    /** Change the selection cap without rebuilding. */
+    setMaxSelection(maxSelection: number): void;
+    /** Current exact-count validity, or null when no exact count was configured. */
+    getSelectionValidity(): PickerSelectionValidity | null;
     /**
      * Choose a ticket tier for a selected seat (e.g. Adult → Child). Available
      * `tiers` are on each `SelectedSeat`; `tierId=null` reverts to the default.
@@ -904,7 +952,7 @@ interface SeatingChartHandle {
  * Every method a wrapper must forward. The wrappers build their handle by
  * iterating this, so the list IS the contract rather than a description of it.
  */
-declare const SEATING_CHART_HANDLE_METHODS: readonly ["hold", "resumeHold", "getCurrentHold", "getGAAreas", "holdGA", "bestAvailable", "release", "releaseLabels", "getSelection", "setSeatTier", "getFloors", "setFloor", "setColorblindSafe", "zoomIn", "zoomOut", "zoomToFit", "refreshAccess"];
+declare const SEATING_CHART_HANDLE_METHODS: readonly ["hold", "resumeHold", "getCurrentHold", "getGAAreas", "holdGA", "bestAvailable", "release", "releaseLabels", "getSelection", "selectObjects", "deselectObjects", "clearSelection", "selectCategories", "deselectCategories", "setSelectableObjects", "setMaxSelection", "getSelectionValidity", "setSeatTier", "getFloors", "setFloor", "setColorblindSafe", "zoomIn", "zoomOut", "zoomToFit", "refreshAccess"];
 type SeatingChartHandleMethod = (typeof SEATING_CHART_HANDLE_METHODS)[number];
 /**
  * Build the forwarding object every wrapper exposes.
@@ -925,13 +973,13 @@ 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", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay"];
+declare const SEATING_CHART_IDENTITY_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "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", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
+declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "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", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
+declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
 type SeatingChartCallbackProp = (typeof SEATING_CHART_CALLBACK_PROPS)[number];
 /** The value half of the options, as a wrapper holds it. */
 type SeatingChartValues = Pick<SeatingChartOptions, SeatingChartValueProp>;
@@ -1251,6 +1299,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. */
@@ -1263,6 +1329,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;
@@ -1440,6 +1507,12 @@ interface SeatPickerOptions {
     buyerAccessToken?: string | BuyerAccessToken;
     /** Max seats selectable at once (default 10). */
     maxSelection?: number;
+    /** Object ids or public labels selected after live availability is loaded. */
+    selectedObjects?: string[];
+    /** Object ids or public labels the buyer may select. Omit for all free objects. */
+    selectableObjects?: string[] | null;
+    /** Require exactly this many total seated/table/GA guest units before checkout. */
+    numberOfPlacesToSelect?: number;
     /** BCP 47 language for the widget UI. Built-in: en, es, de, fr. */
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
@@ -1665,6 +1738,14 @@ interface SeatPickerOptions {
     onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
+    /** Exact-count state after each selection change. */
+    onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
+    /** The configured exact ticket count has just been reached. */
+    onSelectionValid?: (seats: PickerSeat[]) => void;
+    /** The current selection does not match the configured exact ticket count. */
+    onSelectionInvalid?: (state: PickerSelectionValidity) => void;
+    /** A selection attempt reached the active maximum. */
+    onSelectionLimit?: (maxSelection: number) => void;
     /**
      * Active hold changed because it was created, restored, extended, partially
      * released, or fully released. Hosts should persist this state for route
@@ -1734,7 +1815,10 @@ declare class SeatPicker {
     private accessEl;
     private readonly apiBase;
     private readonly controller;
-    private readonly maxTickets;
+    private maxTickets;
+    /** Exact ticket count required before checkout; null keeps ordinary 1..max behavior. */
+    private readonly exactTickets;
+    private lastExactSelectionValidity;
     /** Original host pricing, kept separate from live server offer overrides. */
     private readonly hostPricing;
     private root;
@@ -1759,6 +1843,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;
@@ -2081,7 +2168,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. */
@@ -2184,11 +2271,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.
      */
@@ -2212,6 +2300,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;
     /** Paint the bottom-sheet's collapsed one-liner (pickerTray.ts builds it). */
     private renderPeek;
     private removeHeldLabel;
@@ -2282,6 +2371,22 @@ declare class SeatPicker {
     private rowTypeWord;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /** Select free objects by engine id or public label. */
+    selectObjects(objects: string[]): PickerSeat[];
+    /** Deselect objects by engine id or public label. */
+    deselectObjects(objects: string[]): void;
+    /** Clear every unheld selection. */
+    clearSelection(): void;
+    /** Select every selectable object in the named categories. */
+    selectCategories(categoryKeys: string[]): PickerSeat[];
+    /** Deselect every selected object in the named categories. */
+    deselectCategories(categoryKeys: string[]): void;
+    /** Replace the buyer-selectable object allow-list without remounting. */
+    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. */
+    getSelectionValidity(): PickerSelectionValidity | null;
     /**
      * Re-ink the DRAWN MAP after mount, so the canvas can follow a page palette
      * the host did not know at construction time.

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { PickerSeat, RendererViewMode, SeatHoverDetails, PickerTransport, PickerMapTheme } from '@seatlayer/core';
-export { ExpandedSeat, PickerMapTheme, 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 EventScopedManageToken, M as IntentSwitchBlockedDetails, N as InventoryBooking, O as InventoryBookingActivity, P as InventoryBookingDetail, Q as InventoryBookingObject, R as InventoryBookingState, S as InventoryBookingsPage, T as InventoryBookingsQuery, U as LogEntry, V as LogPage, W as ManageApi, X as ManageApiError, Y as ReportByStatus, Z as ReportCategoryMeta, _ as ReportCategoryRow, $ as ReportResult, a0 as SeatManager, a1 as SeatManagerActionResult, a2 as SeatManagerActivity, a3 as SeatManagerCapability, a4 as SeatManagerConnection, a5 as SeatManagerMode, a6 as SeatManagerOptions, a7 as SeatManagerTallies, a8 as SelectionSourceRow } from './channelsMode-BX7s9bUl.js';
+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';
 
 /**
  * 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;
@@ -568,6 +570,12 @@ interface SeatingChartOptions {
     buyerAccessToken?: string | BuyerAccessToken;
     /** Max seats selectable at once (default 10). */
     maxSelection?: number;
+    /** Object ids or public labels selected after live availability is loaded. */
+    selectedObjects?: string[];
+    /** Object ids or public labels the buyer may select. Omit for all free objects. */
+    selectableObjects?: string[] | null;
+    /** Require exactly this many seated/table guest units before the selection is valid. */
+    numberOfPlacesToSelect?: number;
     /**
      * 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
@@ -605,6 +613,14 @@ interface SeatingChartOptions {
      */
     onSeatHover?: (details: SeatHoverDetails | null) => void;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
+    /** Exact-count state after each selection change. */
+    onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
+    /** The exact configured count has just been reached. */
+    onSelectionValid?: (seats: SelectedSeat[]) => void;
+    /** The current selection does not match the configured exact count. */
+    onSelectionInvalid?: (state: PickerSelectionValidity) => void;
+    /** A manual or programmatic selection reached the active maximum. */
+    onSelectionLimit?: (maxSelection: number) => void;
     onHold?: (result: HoldResult) => void;
     /** A prior active hold was restored with resumeHold(). */
     onHoldRestored?: (result: HoldResult) => void;
@@ -701,6 +717,22 @@ declare class SeatingChart {
     getMode(): 'live' | 'test' | null;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
+    /** Select free objects by engine id or public label. Returns newly selected objects. */
+    selectObjects(objects: string[]): SelectedSeat[];
+    /** Deselect objects by engine id or public label. */
+    deselectObjects(objects: string[]): void;
+    /** Clear every unheld selection. */
+    clearSelection(): void;
+    /** Select every selectable object in the named categories. */
+    selectCategories(categoryKeys: string[]): SelectedSeat[];
+    /** Deselect every selected object in the named categories. */
+    deselectCategories(categoryKeys: string[]): void;
+    /** Replace the buyer-selectable object allow-list without remounting. */
+    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. */
+    getSelectionValidity(): PickerSelectionValidity | null;
     /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */
     hold(options?: {
         ttlMs?: number;
@@ -871,6 +903,22 @@ interface SeatingChartHandle {
     releaseLabels(labels: string[]): Promise<boolean>;
     /** The current selection, with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
+    /** Select free objects by engine id or public label. */
+    selectObjects(objects: string[]): SelectedSeat[];
+    /** Deselect objects by engine id or public label. */
+    deselectObjects(objects: string[]): void;
+    /** Clear every unheld selection. */
+    clearSelection(): void;
+    /** Select every selectable object in the named categories. */
+    selectCategories(categoryKeys: string[]): SelectedSeat[];
+    /** Deselect every selected object in the named categories. */
+    deselectCategories(categoryKeys: string[]): void;
+    /** Replace the buyer-selectable object allow-list without rebuilding. */
+    setSelectableObjects(objects: string[] | null): void;
+    /** Change the selection cap without rebuilding. */
+    setMaxSelection(maxSelection: number): void;
+    /** Current exact-count validity, or null when no exact count was configured. */
+    getSelectionValidity(): PickerSelectionValidity | null;
     /**
      * Choose a ticket tier for a selected seat (e.g. Adult → Child). Available
      * `tiers` are on each `SelectedSeat`; `tierId=null` reverts to the default.
@@ -904,7 +952,7 @@ interface SeatingChartHandle {
  * Every method a wrapper must forward. The wrappers build their handle by
  * iterating this, so the list IS the contract rather than a description of it.
  */
-declare const SEATING_CHART_HANDLE_METHODS: readonly ["hold", "resumeHold", "getCurrentHold", "getGAAreas", "holdGA", "bestAvailable", "release", "releaseLabels", "getSelection", "setSeatTier", "getFloors", "setFloor", "setColorblindSafe", "zoomIn", "zoomOut", "zoomToFit", "refreshAccess"];
+declare const SEATING_CHART_HANDLE_METHODS: readonly ["hold", "resumeHold", "getCurrentHold", "getGAAreas", "holdGA", "bestAvailable", "release", "releaseLabels", "getSelection", "selectObjects", "deselectObjects", "clearSelection", "selectCategories", "deselectCategories", "setSelectableObjects", "setMaxSelection", "getSelectionValidity", "setSeatTier", "getFloors", "setFloor", "setColorblindSafe", "zoomIn", "zoomOut", "zoomToFit", "refreshAccess"];
 type SeatingChartHandleMethod = (typeof SEATING_CHART_HANDLE_METHODS)[number];
 /**
  * Build the forwarding object every wrapper exposes.
@@ -925,13 +973,13 @@ 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", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay"];
+declare const SEATING_CHART_IDENTITY_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "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", "publicKey", "locale", "currency", "colorblindSafe", "initialView", "errorDisplay", "messages", "seatTooltip", "buyerAccessTokenProvider", "buyerAccessToken"];
+declare const SEATING_CHART_VALUE_PROPS: readonly ["event", "apiBase", "maxSelection", "numberOfPlacesToSelect", "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", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
+declare const SEATING_CHART_CALLBACK_PROPS: readonly ["onSelectionChange", "onSelectionValidityChange", "onSelectionValid", "onSelectionInvalid", "onSelectionLimit", "onHold", "onHoldRestored", "onHoldExpired", "onGAClick", "onError", "onDeckTap", "onHint", "onSeatHover", "onAccessExpired", "onAccessUnavailable", "onSelectedObjectUnavailable"];
 type SeatingChartCallbackProp = (typeof SEATING_CHART_CALLBACK_PROPS)[number];
 /** The value half of the options, as a wrapper holds it. */
 type SeatingChartValues = Pick<SeatingChartOptions, SeatingChartValueProp>;
@@ -1251,6 +1299,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. */
@@ -1263,6 +1329,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;
@@ -1440,6 +1507,12 @@ interface SeatPickerOptions {
     buyerAccessToken?: string | BuyerAccessToken;
     /** Max seats selectable at once (default 10). */
     maxSelection?: number;
+    /** Object ids or public labels selected after live availability is loaded. */
+    selectedObjects?: string[];
+    /** Object ids or public labels the buyer may select. Omit for all free objects. */
+    selectableObjects?: string[] | null;
+    /** Require exactly this many total seated/table/GA guest units before checkout. */
+    numberOfPlacesToSelect?: number;
     /** BCP 47 language for the widget UI. Built-in: en, es, de, fr. */
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
@@ -1665,6 +1738,14 @@ interface SeatPickerOptions {
     onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
+    /** Exact-count state after each selection change. */
+    onSelectionValidityChange?: (state: PickerSelectionValidity) => void;
+    /** The configured exact ticket count has just been reached. */
+    onSelectionValid?: (seats: PickerSeat[]) => void;
+    /** The current selection does not match the configured exact ticket count. */
+    onSelectionInvalid?: (state: PickerSelectionValidity) => void;
+    /** A selection attempt reached the active maximum. */
+    onSelectionLimit?: (maxSelection: number) => void;
     /**
      * Active hold changed because it was created, restored, extended, partially
      * released, or fully released. Hosts should persist this state for route
@@ -1734,7 +1815,10 @@ declare class SeatPicker {
     private accessEl;
     private readonly apiBase;
     private readonly controller;
-    private readonly maxTickets;
+    private maxTickets;
+    /** Exact ticket count required before checkout; null keeps ordinary 1..max behavior. */
+    private readonly exactTickets;
+    private lastExactSelectionValidity;
     /** Original host pricing, kept separate from live server offer overrides. */
     private readonly hostPricing;
     private root;
@@ -1759,6 +1843,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;
@@ -2081,7 +2168,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. */
@@ -2184,11 +2271,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.
      */
@@ -2212,6 +2300,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;
     /** Paint the bottom-sheet's collapsed one-liner (pickerTray.ts builds it). */
     private renderPeek;
     private removeHeldLabel;
@@ -2282,6 +2371,22 @@ declare class SeatPicker {
     private rowTypeWord;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /** Select free objects by engine id or public label. */
+    selectObjects(objects: string[]): PickerSeat[];
+    /** Deselect objects by engine id or public label. */
+    deselectObjects(objects: string[]): void;
+    /** Clear every unheld selection. */
+    clearSelection(): void;
+    /** Select every selectable object in the named categories. */
+    selectCategories(categoryKeys: string[]): PickerSeat[];
+    /** Deselect every selected object in the named categories. */
+    deselectCategories(categoryKeys: string[]): void;
+    /** Replace the buyer-selectable object allow-list without remounting. */
+    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. */
+    getSelectionValidity(): PickerSelectionValidity | null;
     /**
      * Re-ink the DRAWN MAP after mount, so the canvas can follow a page palette
      * the host did not know at construction time.