@seatlayer/js 0.42.0 → 0.43.0

package/dist/index.d.cts

@@ -3388,6 +3388,16 @@ interface ChannelsSeatView {
     x: number;
     y: number;
 }
+/** One row offered to the bulk assignment chooser. A physically segmented row
+ * (one label split across several row objects) shares one logical id, so the
+ * organizer picks "Row AA" once rather than three fragments of it. */
+interface ChannelsRowView {
+    id: string;
+    label: string;
+    sectionId: string;
+    sectionLabel: string;
+    labels: string[];
+}
 /** The `ManageApi` subset Channels mode uses — structural so tests can pass a
  *  hand-rolled double without constructing a real client. */
 interface ChannelsClient {
@@ -3478,6 +3488,10 @@ interface ChannelsModeHost {
         id: string;
         label: string;
     }>;
+    /** Every selectable label inside one section, for the additive scope chooser. */
+    labelsInSection(sectionId: string): string[];
+    /** Logical rows across the whole chart, grouped by their section. */
+    rows(): ChannelsRowView[];
     categories(): Array<{
         key: string;
         label: string;
@@ -3576,6 +3590,10 @@ declare class ChannelsMode {
     private stagedDoneTimer;
     private lastSelectionCount;
     private lastCounts;
+    /** Rows are structural chart data — they do not move while the organizer is
+     * allocating. Deriving them walks every seat, so the view is cached for the
+     * lifetime of this mode entry and ordinary selection repaints stay O(1). */
+    private assignmentRowsCache;
     /** The markup currently in the rail. An identical repaint is skipped, which is
      *  what keeps the organizer's scroll position (and open <select>) alive. */
     private railHtml;
@@ -3684,6 +3702,17 @@ declare class ChannelsMode {
     private countsHtml;
     private channelRowHtml;
     private listRailHtml;
+    /**
+     * Destination-first assignment controls.
+     *
+     * These used to live only inside the selection rail, which meant every route
+     * into them was gated behind "select a seat on the map first" — the section,
+     * row and category choosers were invisible until the organizer had already
+     * done the work by hand. They now paint above the channel list too, so the
+     * destination is chosen first and whole sections and rows are discoverable
+     * without learning a hidden seat-first workflow.
+     */
+    private assignmentToolsHtml;
     private selectionRailHtml;
     private detailRailHtml;
     /**
@@ -3729,10 +3758,25 @@ declare class ChannelsMode {
     private paintSelection;
     private wireRail;
     private railAction;
-    private pickSection;
+    /** Derived once per mode entry — see `assignmentRowsCache`. */
+    private assignmentRows;
     private pickCategory;
     /** A tiny modal chooser reusing the dialog primitive (focus trap + Escape). */
     private promptChoice;
+    /**
+     * Add several whole sections, or several whole rows, in one operation.
+     *
+     * ADDITIVE by contract: the chooser starts from the labels already selected
+     * and only ever grows that set, so opening it never destroys a hard-won
+     * marquee or seat-list selection. The confirm button always states the net
+     * number of seats it will add, and refuses to exceed `MAX_ASSIGNMENT_UNITS`.
+     *
+     * Rows get the richer variant. A large venue has thousands of them, so they
+     * arrive collapsed under their section, with a section-level tri-state
+     * checkbox, a search across every row, and a render cap — the flat list used
+     * for sections would be an unusable wall of buttons.
+     */
+    private renderScopeDialog;
     private openDialog;
     private renderDialog;
     /**
@@ -3746,12 +3790,20 @@ declare class ChannelsMode {
     private showDialogError;
     private renderReviewDialog;
     /**
-     * Apply. On success the review sheet re-renders with the AUTHORITATIVE server
-     * buckets and the staged bar morphs to a ✓ for 1.2s. On a stale version the
-     * server mutated nothing: keep the selection, shake the bar once, and offer
-     * exactly one action — Refresh and review.
+     * Apply. On success the sheet CLOSES and the staged bar confirms what moved,
+     * naming the destination and any skipped seats, with the AUTHORITATIVE server
+     * buckets still one Details press away. Leaving the modal up on success made
+     * the organizer dismiss a sheet to get back to a map they had just changed.
+     * On a stale version the server mutated nothing: keep the selection, shake
+     * the bar once, and offer exactly one action — Refresh and review.
      */
     private apply;
+    /**
+     * The success receipt, now that the review sheet closes on Apply. It names the
+     * destination and the seats that could not move, keeps the authoritative
+     * buckets reachable through Details, and stays up long enough to be read —
+     * 1.2s was tuned for a confirmation the organizer was already looking at.
+     */
     private showApplied;
     private shakeStaged;
     private renderRenameDialog;
@@ -3828,4 +3880,4 @@ declare class ChannelsMode {
     handleBack(): boolean;
 }
 
-export { ACCESS_LINK_DEFAULTS, type AccessLinkRecord, type AccessLinkReveal, type AccessLinkState, type AccessLinkStatus, type AccessLinkStatusRecord, ApiError, type ArchiveBlockedDetails, type AssignmentBuckets, type AssignmentDropDetails, type AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, type BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type ChannelAccessIntent, type ChannelAccessSummary, type ChannelAllocationPage, type ChannelAuditEntry, type ChannelAuditPage, type ChannelCounts, type ChannelListResult, type ChannelPreviewProjection, type ChannelRecord, type ChannelSeatStatus, type ChannelState, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, type ControlRoomActivityEntry, type ControlRoomSectionMetric, type ControlRoomSnapshot, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type OrderStatusResult, PUBLIC_CHANNEL_ID, PUBLIC_CHANNEL_NAME, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, type ResumedHoldResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerCapability, type SeatManagerConnection, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type SelectionSourceRow, type StatusChange, type SubscribeTicket$1 as SubscribeTicket, accessIntentLabel, accessLine, accessLinkBadge, accessLinkErrorCopy, accessLinkIsLive, accessLinkPolicyLines, attachPickerFrame, bucketRows, bucketRowsHtml, createBuyerAccessContext, createControllerSink, dropReviewRows, isPublicChannelId, markerLetter, markerOf, mutationCount, needsMoveConfirmation, planAssignment, retryAfterCopy, selectionSources, stateBadge, suggestMarker };
+export { ACCESS_LINK_DEFAULTS, type AccessLinkRecord, type AccessLinkReveal, type AccessLinkState, type AccessLinkStatus, type AccessLinkStatusRecord, ApiError, type ArchiveBlockedDetails, type AssignmentBuckets, type AssignmentDropDetails, type AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, type BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type ChannelAccessIntent, type ChannelAccessSummary, type ChannelAllocationPage, type ChannelAuditEntry, type ChannelAuditPage, type ChannelCounts, type ChannelListResult, type ChannelPreviewProjection, type ChannelRecord, type ChannelSeatStatus, type ChannelState, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsRowView, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, type ControlRoomActivityEntry, type ControlRoomSectionMetric, type ControlRoomSnapshot, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type OrderStatusResult, PUBLIC_CHANNEL_ID, PUBLIC_CHANNEL_NAME, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, type ResumedHoldResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerCapability, type SeatManagerConnection, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type SelectionSourceRow, type StatusChange, type SubscribeTicket$1 as SubscribeTicket, accessIntentLabel, accessLine, accessLinkBadge, accessLinkErrorCopy, accessLinkIsLive, accessLinkPolicyLines, attachPickerFrame, bucketRows, bucketRowsHtml, createBuyerAccessContext, createControllerSink, dropReviewRows, isPublicChannelId, markerLetter, markerOf, mutationCount, needsMoveConfirmation, planAssignment, retryAfterCopy, selectionSources, stateBadge, suggestMarker };

package/dist/index.d.ts

@@ -3388,6 +3388,16 @@ interface ChannelsSeatView {
     x: number;
     y: number;
 }
+/** One row offered to the bulk assignment chooser. A physically segmented row
+ * (one label split across several row objects) shares one logical id, so the
+ * organizer picks "Row AA" once rather than three fragments of it. */
+interface ChannelsRowView {
+    id: string;
+    label: string;
+    sectionId: string;
+    sectionLabel: string;
+    labels: string[];
+}
 /** The `ManageApi` subset Channels mode uses — structural so tests can pass a
  *  hand-rolled double without constructing a real client. */
 interface ChannelsClient {
@@ -3478,6 +3488,10 @@ interface ChannelsModeHost {
         id: string;
         label: string;
     }>;
+    /** Every selectable label inside one section, for the additive scope chooser. */
+    labelsInSection(sectionId: string): string[];
+    /** Logical rows across the whole chart, grouped by their section. */
+    rows(): ChannelsRowView[];
     categories(): Array<{
         key: string;
         label: string;
@@ -3576,6 +3590,10 @@ declare class ChannelsMode {
     private stagedDoneTimer;
     private lastSelectionCount;
     private lastCounts;
+    /** Rows are structural chart data — they do not move while the organizer is
+     * allocating. Deriving them walks every seat, so the view is cached for the
+     * lifetime of this mode entry and ordinary selection repaints stay O(1). */
+    private assignmentRowsCache;
     /** The markup currently in the rail. An identical repaint is skipped, which is
      *  what keeps the organizer's scroll position (and open <select>) alive. */
     private railHtml;
@@ -3684,6 +3702,17 @@ declare class ChannelsMode {
     private countsHtml;
     private channelRowHtml;
     private listRailHtml;
+    /**
+     * Destination-first assignment controls.
+     *
+     * These used to live only inside the selection rail, which meant every route
+     * into them was gated behind "select a seat on the map first" — the section,
+     * row and category choosers were invisible until the organizer had already
+     * done the work by hand. They now paint above the channel list too, so the
+     * destination is chosen first and whole sections and rows are discoverable
+     * without learning a hidden seat-first workflow.
+     */
+    private assignmentToolsHtml;
     private selectionRailHtml;
     private detailRailHtml;
     /**
@@ -3729,10 +3758,25 @@ declare class ChannelsMode {
     private paintSelection;
     private wireRail;
     private railAction;
-    private pickSection;
+    /** Derived once per mode entry — see `assignmentRowsCache`. */
+    private assignmentRows;
     private pickCategory;
     /** A tiny modal chooser reusing the dialog primitive (focus trap + Escape). */
     private promptChoice;
+    /**
+     * Add several whole sections, or several whole rows, in one operation.
+     *
+     * ADDITIVE by contract: the chooser starts from the labels already selected
+     * and only ever grows that set, so opening it never destroys a hard-won
+     * marquee or seat-list selection. The confirm button always states the net
+     * number of seats it will add, and refuses to exceed `MAX_ASSIGNMENT_UNITS`.
+     *
+     * Rows get the richer variant. A large venue has thousands of them, so they
+     * arrive collapsed under their section, with a section-level tri-state
+     * checkbox, a search across every row, and a render cap — the flat list used
+     * for sections would be an unusable wall of buttons.
+     */
+    private renderScopeDialog;
     private openDialog;
     private renderDialog;
     /**
@@ -3746,12 +3790,20 @@ declare class ChannelsMode {
     private showDialogError;
     private renderReviewDialog;
     /**
-     * Apply. On success the review sheet re-renders with the AUTHORITATIVE server
-     * buckets and the staged bar morphs to a ✓ for 1.2s. On a stale version the
-     * server mutated nothing: keep the selection, shake the bar once, and offer
-     * exactly one action — Refresh and review.
+     * Apply. On success the sheet CLOSES and the staged bar confirms what moved,
+     * naming the destination and any skipped seats, with the AUTHORITATIVE server
+     * buckets still one Details press away. Leaving the modal up on success made
+     * the organizer dismiss a sheet to get back to a map they had just changed.
+     * On a stale version the server mutated nothing: keep the selection, shake
+     * the bar once, and offer exactly one action — Refresh and review.
      */
     private apply;
+    /**
+     * The success receipt, now that the review sheet closes on Apply. It names the
+     * destination and the seats that could not move, keeps the authoritative
+     * buckets reachable through Details, and stays up long enough to be read —
+     * 1.2s was tuned for a confirmation the organizer was already looking at.
+     */
     private showApplied;
     private shakeStaged;
     private renderRenameDialog;
@@ -3828,4 +3880,4 @@ declare class ChannelsMode {
     handleBack(): boolean;
 }
 
-export { ACCESS_LINK_DEFAULTS, type AccessLinkRecord, type AccessLinkReveal, type AccessLinkState, type AccessLinkStatus, type AccessLinkStatusRecord, ApiError, type ArchiveBlockedDetails, type AssignmentBuckets, type AssignmentDropDetails, type AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, type BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type ChannelAccessIntent, type ChannelAccessSummary, type ChannelAllocationPage, type ChannelAuditEntry, type ChannelAuditPage, type ChannelCounts, type ChannelListResult, type ChannelPreviewProjection, type ChannelRecord, type ChannelSeatStatus, type ChannelState, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, type ControlRoomActivityEntry, type ControlRoomSectionMetric, type ControlRoomSnapshot, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type OrderStatusResult, PUBLIC_CHANNEL_ID, PUBLIC_CHANNEL_NAME, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, type ResumedHoldResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerCapability, type SeatManagerConnection, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type SelectionSourceRow, type StatusChange, type SubscribeTicket$1 as SubscribeTicket, accessIntentLabel, accessLine, accessLinkBadge, accessLinkErrorCopy, accessLinkIsLive, accessLinkPolicyLines, attachPickerFrame, bucketRows, bucketRowsHtml, createBuyerAccessContext, createControllerSink, dropReviewRows, isPublicChannelId, markerLetter, markerOf, mutationCount, needsMoveConfirmation, planAssignment, retryAfterCopy, selectionSources, stateBadge, suggestMarker };
+export { ACCESS_LINK_DEFAULTS, type AccessLinkRecord, type AccessLinkReveal, type AccessLinkState, type AccessLinkStatus, type AccessLinkStatusRecord, ApiError, type ArchiveBlockedDetails, type AssignmentBuckets, type AssignmentDropDetails, type AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, type BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type ChannelAccessIntent, type ChannelAccessSummary, type ChannelAllocationPage, type ChannelAuditEntry, type ChannelAuditPage, type ChannelCounts, type ChannelListResult, type ChannelPreviewProjection, type ChannelRecord, type ChannelSeatStatus, type ChannelState, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsRowView, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, type ControlRoomActivityEntry, type ControlRoomSectionMetric, type ControlRoomSnapshot, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type OrderStatusResult, PUBLIC_CHANNEL_ID, PUBLIC_CHANNEL_NAME, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, type ResumedHoldResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerCapability, type SeatManagerConnection, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type SelectionSourceRow, type StatusChange, type SubscribeTicket$1 as SubscribeTicket, accessIntentLabel, accessLine, accessLinkBadge, accessLinkErrorCopy, accessLinkIsLive, accessLinkPolicyLines, attachPickerFrame, bucketRows, bucketRowsHtml, createBuyerAccessContext, createControllerSink, dropReviewRows, isPublicChannelId, markerLetter, markerOf, mutationCount, needsMoveConfirmation, planAssignment, retryAfterCopy, selectionSources, stateBadge, suggestMarker };