@seatlayer/js 0.13.0 → 0.15.0

package/dist/index.d.cts

@@ -42,6 +42,10 @@ interface HoldResult {
     seats?: PickerSeat[];
     items?: HoldLineItem[];
 }
+/** Browser-safe active-hold projection returned by the resume endpoint. */
+interface ResumedHoldResult extends HoldResult {
+    items: HoldLineItem[];
+}
 /** Best-available response — the server-picked seats plus the hold they landed in. */
 interface BestAvailableResult {
     holdId: string;
@@ -121,6 +125,8 @@ interface SeatingChartOptions {
     onSeatHover?: (details: SeatHoverDetails | null) => void;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
     onHold?: (result: HoldResult) => void;
+    /** A prior active hold was restored with resumeHold(). */
+    onHoldRestored?: (result: HoldResult) => void;
     onHoldExpired?: () => void;
     onGAClick?: (area: GAAreaAvailability) => void;
     onError?: (err: unknown) => void;
@@ -159,6 +165,10 @@ declare class SeatingChart {
     hold(options?: {
         ttlMs?: number;
     }): Promise<HoldResult | null>;
+    /** Restore an active hold by its opaque id without extending its expiry. */
+    resumeHold(holdId: string): Promise<HoldResult | null>;
+    /** Current active hold known to this chart, if any. */
+    getCurrentHold(): HoldResult | null;
     getGAAreas(): GAAreaAvailability[];
     holdGA(areaId: string, qty: number, options?: {
         tierId?: string | null;
@@ -195,6 +205,8 @@ declare class SeatingChart {
     zoomToFit(): void;
     /** Release the current hold (if any). No-op when nothing is held. */
     release(): Promise<void>;
+    /** Release selected labels from the current hold while keeping the remainder. */
+    releaseLabels(labels: string[]): Promise<boolean>;
     /** Tear everything down: close the socket, stop timers, drop the canvas. */
     destroy(): void;
 }
@@ -354,8 +366,22 @@ interface SeatPickerOptions {
     /** Hold TTL in ms passed to hold(); server clamps to its own limits. */
     holdTtlMs?: number;
     /**
-     * Confirm mode: tapping a seat shows an anchored popover (seat · category ·
-     * price · Add/Cancel) instead of adding straight to the tray. Default false.
+     * An opaque hold id supplied by the host to restore after navigation. It is
+     * verified against the event and active server state before anything renders
+     * as owned by this buyer.
+     */
+    initialHoldId?: string;
+    /**
+     * Automatically remember the active hold id in sessionStorage and restore it
+     * when this event's picker mounts again. Default true. Set false when the host
+     * owns hold persistence and supplies initialHoldId itself.
+     */
+    restoreHold?: boolean;
+    /**
+     * Confirm mode: tapping a seat shows a confirmation card with section, row,
+     * seat, category, price and Select/Cancel before it enters the tray. Default
+     * true for the full buyer picker; set false only when the host supplies its
+     * own equivalent confirmation UI.
      */
     confirmSelection?: boolean;
     /**
@@ -380,14 +406,24 @@ interface SeatPickerOptions {
     onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
+    /**
+     * Active hold changed because it was created, restored, extended, partially
+     * released, or fully released. Hosts should persist this state for route
+     * navigation and clear their checkout cart when `hold` becomes null.
+     */
+    onHoldChange?: (hold: HoldResult | null, seats: PickerSeat[], handoff: CheckoutHandoff | null) => void;
     /** The open hold expired server-side (widget already reset itself). */
     onHoldExpired?: () => void;
+    /** A prior active hold was verified and restored into the tray. */
+    onHoldRestored?: (hold: HoldResult, seats: PickerSeat[], handoff: CheckoutHandoff) => void;
     /** Modal only: the buyer closed the picker (ESC / scrim / ✕). */
     onClose?: () => void;
     onError?: (err: unknown) => void;
 }
 declare class SeatPicker {
     private readonly opts;
+    private readonly api;
+    private readonly apiBase;
     private readonly controller;
     private root;
     private mapHost;
@@ -399,6 +435,8 @@ declare class SeatPicker {
     private ro;
     private holdTimer;
     private toastTimer;
+    /** Short-lived UI motion timers; all are cancelled on destroy. */
+    private motionTimers;
     private currency;
     private hold;
     /** Latest server expiry for the open hold (moves on extend). */
@@ -438,6 +476,15 @@ declare class SeatPicker {
     private secCardShownAt;
     /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
     private lastTrayCount;
+    /** Previous computed total — drives a single explanatory value bump. */
+    private lastTrayTotal;
+    /** Stable item keys prevent tray chips re-animating on unrelated realtime syncs. */
+    private lastTrayKeys;
+    private bestAvailableBusy;
+    private releasingLabels;
+    /** Selected labels awaiting the hold response; their own realtime echo can arrive first. */
+    private holdingLabels;
+    private ctaPhase;
     private a11yChipsEl;
     private cbEl;
     private modalScrim;
@@ -476,6 +523,27 @@ declare class SeatPicker {
     private buildRegions;
     /** Read a resolved --sl-* token value (canvas needs a real color, not var()). */
     private cssVar;
+    /** Motion is progressive enhancement; all state remains legible when reduced. */
+    private reducedMotion;
+    private scheduleMotion;
+    /** Restart one finite CSS animation without leaving a permanent state class. */
+    private animateOnce;
+    /** Selection feedback belongs on the selected seat, not across the whole map. */
+    private flashPickedSeat;
+    /** A completed hold gets one short map ripple per concrete seat. */
+    private flashHeldSeats;
+    /** Update only the action affordance; selection callbacks must not refire. */
+    private committedSelection;
+    private pendingSelectionCount;
+    private syncCta;
+    private setCtaPhase;
+    /** Session-scoped capability key: isolated by API origin and event. */
+    private holdStorageKey;
+    private rememberedHoldId;
+    private rememberHold;
+    private forgetHold;
+    private resumeHoldFromServer;
+    private restoreRememberedHold;
     /** Section-bearing objects on the active floor (single-floor → doc.objects). */
     private activeFloorObjects;
     /**
@@ -531,6 +599,9 @@ declare class SeatPicker {
     private announceSeat;
     private showConfirm;
     private reanchorConfirm;
+    private dismissConfirm;
+    private commitConfirm;
+    private cancelConfirm;
     private closeConfirm;
     private seatViewEnabled;
     /** Every bookable seat (cached) — neighbor heads for the generated panorama. */
@@ -548,6 +619,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 removeHeldLabel;
     private handleCta;
     private startHoldTimer;
     private stopHoldTimer;
@@ -566,10 +638,17 @@ declare class SeatPicker {
     private showBooked;
     /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
     private buildHandoff;
+    private emitHoldChange;
     private toast;
     private placeTooltip;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /** Current active/restored hold reflected in the tray. */
+    getCurrentHold(): HoldResult | null;
+    /** Explicit host-driven hold restore (automatic session restore is on by default). */
+    resumeHold(holdId: string): Promise<HoldResult | null>;
+    /** Remove one server-held ticket while keeping the rest of the hold active. */
+    removeHeldTicket(label: string): Promise<boolean>;
     bestAvailable(qty: number, categoryKey?: string): Promise<HoldResult | null>;
     release(): Promise<void>;
     destroy(): void;
@@ -1046,4 +1125,4 @@ declare class SeatManager {
     private fail;
 }
 
-export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, 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 ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, 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 ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, type ResumedHoldResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };

package/dist/index.d.ts

@@ -42,6 +42,10 @@ interface HoldResult {
     seats?: PickerSeat[];
     items?: HoldLineItem[];
 }
+/** Browser-safe active-hold projection returned by the resume endpoint. */
+interface ResumedHoldResult extends HoldResult {
+    items: HoldLineItem[];
+}
 /** Best-available response — the server-picked seats plus the hold they landed in. */
 interface BestAvailableResult {
     holdId: string;
@@ -121,6 +125,8 @@ interface SeatingChartOptions {
     onSeatHover?: (details: SeatHoverDetails | null) => void;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
     onHold?: (result: HoldResult) => void;
+    /** A prior active hold was restored with resumeHold(). */
+    onHoldRestored?: (result: HoldResult) => void;
     onHoldExpired?: () => void;
     onGAClick?: (area: GAAreaAvailability) => void;
     onError?: (err: unknown) => void;
@@ -159,6 +165,10 @@ declare class SeatingChart {
     hold(options?: {
         ttlMs?: number;
     }): Promise<HoldResult | null>;
+    /** Restore an active hold by its opaque id without extending its expiry. */
+    resumeHold(holdId: string): Promise<HoldResult | null>;
+    /** Current active hold known to this chart, if any. */
+    getCurrentHold(): HoldResult | null;
     getGAAreas(): GAAreaAvailability[];
     holdGA(areaId: string, qty: number, options?: {
         tierId?: string | null;
@@ -195,6 +205,8 @@ declare class SeatingChart {
     zoomToFit(): void;
     /** Release the current hold (if any). No-op when nothing is held. */
     release(): Promise<void>;
+    /** Release selected labels from the current hold while keeping the remainder. */
+    releaseLabels(labels: string[]): Promise<boolean>;
     /** Tear everything down: close the socket, stop timers, drop the canvas. */
     destroy(): void;
 }
@@ -354,8 +366,22 @@ interface SeatPickerOptions {
     /** Hold TTL in ms passed to hold(); server clamps to its own limits. */
     holdTtlMs?: number;
     /**
-     * Confirm mode: tapping a seat shows an anchored popover (seat · category ·
-     * price · Add/Cancel) instead of adding straight to the tray. Default false.
+     * An opaque hold id supplied by the host to restore after navigation. It is
+     * verified against the event and active server state before anything renders
+     * as owned by this buyer.
+     */
+    initialHoldId?: string;
+    /**
+     * Automatically remember the active hold id in sessionStorage and restore it
+     * when this event's picker mounts again. Default true. Set false when the host
+     * owns hold persistence and supplies initialHoldId itself.
+     */
+    restoreHold?: boolean;
+    /**
+     * Confirm mode: tapping a seat shows a confirmation card with section, row,
+     * seat, category, price and Select/Cancel before it enters the tray. Default
+     * true for the full buyer picker; set false only when the host supplies its
+     * own equivalent confirmation UI.
      */
     confirmSelection?: boolean;
     /**
@@ -380,14 +406,24 @@ interface SeatPickerOptions {
     onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
+    /**
+     * Active hold changed because it was created, restored, extended, partially
+     * released, or fully released. Hosts should persist this state for route
+     * navigation and clear their checkout cart when `hold` becomes null.
+     */
+    onHoldChange?: (hold: HoldResult | null, seats: PickerSeat[], handoff: CheckoutHandoff | null) => void;
     /** The open hold expired server-side (widget already reset itself). */
     onHoldExpired?: () => void;
+    /** A prior active hold was verified and restored into the tray. */
+    onHoldRestored?: (hold: HoldResult, seats: PickerSeat[], handoff: CheckoutHandoff) => void;
     /** Modal only: the buyer closed the picker (ESC / scrim / ✕). */
     onClose?: () => void;
     onError?: (err: unknown) => void;
 }
 declare class SeatPicker {
     private readonly opts;
+    private readonly api;
+    private readonly apiBase;
     private readonly controller;
     private root;
     private mapHost;
@@ -399,6 +435,8 @@ declare class SeatPicker {
     private ro;
     private holdTimer;
     private toastTimer;
+    /** Short-lived UI motion timers; all are cancelled on destroy. */
+    private motionTimers;
     private currency;
     private hold;
     /** Latest server expiry for the open hold (moves on extend). */
@@ -438,6 +476,15 @@ declare class SeatPicker {
     private secCardShownAt;
     /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
     private lastTrayCount;
+    /** Previous computed total — drives a single explanatory value bump. */
+    private lastTrayTotal;
+    /** Stable item keys prevent tray chips re-animating on unrelated realtime syncs. */
+    private lastTrayKeys;
+    private bestAvailableBusy;
+    private releasingLabels;
+    /** Selected labels awaiting the hold response; their own realtime echo can arrive first. */
+    private holdingLabels;
+    private ctaPhase;
     private a11yChipsEl;
     private cbEl;
     private modalScrim;
@@ -476,6 +523,27 @@ declare class SeatPicker {
     private buildRegions;
     /** Read a resolved --sl-* token value (canvas needs a real color, not var()). */
     private cssVar;
+    /** Motion is progressive enhancement; all state remains legible when reduced. */
+    private reducedMotion;
+    private scheduleMotion;
+    /** Restart one finite CSS animation without leaving a permanent state class. */
+    private animateOnce;
+    /** Selection feedback belongs on the selected seat, not across the whole map. */
+    private flashPickedSeat;
+    /** A completed hold gets one short map ripple per concrete seat. */
+    private flashHeldSeats;
+    /** Update only the action affordance; selection callbacks must not refire. */
+    private committedSelection;
+    private pendingSelectionCount;
+    private syncCta;
+    private setCtaPhase;
+    /** Session-scoped capability key: isolated by API origin and event. */
+    private holdStorageKey;
+    private rememberedHoldId;
+    private rememberHold;
+    private forgetHold;
+    private resumeHoldFromServer;
+    private restoreRememberedHold;
     /** Section-bearing objects on the active floor (single-floor → doc.objects). */
     private activeFloorObjects;
     /**
@@ -531,6 +599,9 @@ declare class SeatPicker {
     private announceSeat;
     private showConfirm;
     private reanchorConfirm;
+    private dismissConfirm;
+    private commitConfirm;
+    private cancelConfirm;
     private closeConfirm;
     private seatViewEnabled;
     /** Every bookable seat (cached) — neighbor heads for the generated panorama. */
@@ -548,6 +619,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 removeHeldLabel;
     private handleCta;
     private startHoldTimer;
     private stopHoldTimer;
@@ -566,10 +638,17 @@ declare class SeatPicker {
     private showBooked;
     /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
     private buildHandoff;
+    private emitHoldChange;
     private toast;
     private placeTooltip;
     private updateTooltip;
     getSelection(): PickerSeat[];
+    /** Current active/restored hold reflected in the tray. */
+    getCurrentHold(): HoldResult | null;
+    /** Explicit host-driven hold restore (automatic session restore is on by default). */
+    resumeHold(holdId: string): Promise<HoldResult | null>;
+    /** Remove one server-held ticket while keeping the rest of the hold active. */
+    removeHeldTicket(label: string): Promise<boolean>;
     bestAvailable(qty: number, categoryKey?: string): Promise<HoldResult | null>;
     release(): Promise<void>;
     destroy(): void;
@@ -1046,4 +1125,4 @@ declare class SeatManager {
     private fail;
 }
 
-export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, 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 ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, 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 ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, type ResumedHoldResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };