@seatlayer/js 0.53.0 → 0.55.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-1b6xBWKM.cjs';
 
 /**
  * Buyer access context — the browser half of the Sales Channels contract
@@ -568,6 +568,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 +611,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 +715,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 +901,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 +950,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 +971,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>;
@@ -1440,6 +1486,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 +1717,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 +1794,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;
@@ -1949,7 +2012,15 @@ declare class SeatPicker {
     /** Mount the full picker as a document-level modal. Resolves after render. */
     static open(options: Omit<SeatPickerOptions, 'container'>): Promise<SeatPicker>;
     constructor(options: SeatPickerOptions);
+    /** Controller callbacks are wired once, before the first async chart load. */
+    private wireController;
     render(): Promise<this>;
+    /** Wire host chrome after the skeleton exists and before the renderer owns its map host. */
+    private wireBuyerShell;
+    /** Observe the host container rather than the viewport; embeds resize independently. */
+    private observeLayout;
+    /** Render the shared controller into the already-mounted canvas host. */
+    private loadChart;
     /**
      * A hosted gateway returned this buyer to a page that runs the widget, with
      * `?order=…&status=…` in the URL. Pick the order up and finish the story.
@@ -2204,6 +2275,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;
@@ -2274,6 +2346,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-1b6xBWKM.js';
 
 /**
  * Buyer access context — the browser half of the Sales Channels contract
@@ -568,6 +568,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 +611,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 +715,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 +901,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 +950,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 +971,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>;
@@ -1440,6 +1486,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 +1717,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 +1794,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;
@@ -1949,7 +2012,15 @@ declare class SeatPicker {
     /** Mount the full picker as a document-level modal. Resolves after render. */
     static open(options: Omit<SeatPickerOptions, 'container'>): Promise<SeatPicker>;
     constructor(options: SeatPickerOptions);
+    /** Controller callbacks are wired once, before the first async chart load. */
+    private wireController;
     render(): Promise<this>;
+    /** Wire host chrome after the skeleton exists and before the renderer owns its map host. */
+    private wireBuyerShell;
+    /** Observe the host container rather than the viewport; embeds resize independently. */
+    private observeLayout;
+    /** Render the shared controller into the already-mounted canvas host. */
+    private loadChart;
     /**
      * A hosted gateway returned this buyer to a page that runs the widget, with
      * `?order=…&status=…` in the URL. Pick the order up and finish the story.
@@ -2204,6 +2275,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;
@@ -2274,6 +2346,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.