@seatlayer/js 0.8.0 → 0.10.0

package/dist/index.d.cts

@@ -271,6 +271,40 @@ declare class EmbeddedDesigner {
  * so plain host CSS can restyle too.
  */
 
+/**
+ * Stable checkout-handoff contract (P4). Passed as the THIRD argument to
+ * `onCheckout(hold, seats, handoff)` — additive, so the legacy `(hold, seats)`
+ * shape used by DesiPass web-v2 (SDK 0.7.3+) is untouched. This is the object to
+ * build your order against: it is self-contained (holdId, expiry, currency, and
+ * per-line tier + price) and never changes shape across minor releases.
+ */
+interface CheckoutLineItem {
+    /** Seat label (or GA synthetic-unit label). */
+    label: string;
+    /** Chart object id (row/booth/GA area) the unit belongs to. */
+    objectId: string;
+    objectType: 'seat' | 'booth' | 'ga';
+    categoryKey: string;
+    /** Chosen ticket tier id (Adult/Child/…), or null when the category has no tiers. */
+    tierId: string | null;
+    /** Unit price in MAJOR currency units (e.g. 45 = 45.00). Server-authoritative. */
+    unitPrice: number;
+    /** ISO-4217, resolved server-side (per-event override → org → USD). */
+    currency: string;
+    quantity: number;
+}
+interface CheckoutHandoff {
+    /** Server hold id — pass this to YOUR book call. */
+    holdId: string;
+    /** Epoch ms the hold expires (after any extensions). */
+    expiresAt: number;
+    /** ISO-4217 currency for the whole order. */
+    currency: string;
+    /** Priced line items (tier + unit price + currency), server-authoritative. */
+    lineItems: CheckoutLineItem[];
+    /** Convenience total in major units (Σ unitPrice × quantity). */
+    total: number;
+}
 /** Host theme overrides — any subset; unset keys fall back to the org's chart theme, then defaults. */
 interface SeatPickerTheme {
     /** Brand accent (CTA, active chips, hold pill). */
@@ -332,9 +366,18 @@ interface SeatPickerOptions {
     seatView?: boolean;
     /**
      * Buyer pressed the CTA and the hold succeeded — hand off to YOUR checkout.
-     * The hold carries holdId, expiresAt, seat labels and priced line items.
+     * `hold` and `seats` are the legacy args (unchanged since 0.6). `handoff` (P4)
+     * is the stable, self-contained {@link CheckoutHandoff} to build your order
+     * against — holdId, expiry, currency and priced line items. Prefer it.
+     */
+    onCheckout?: (hold: HoldResult, seats: PickerSeat[], handoff: CheckoutHandoff) => void;
+    /**
+     * The held seats were BOOKED (P4) — your server completed payment and the
+     * booking landed over the realtime channel while the widget was still open.
+     * The widget shows a success state; use this to advance your own UI (receipt,
+     * redirect). Fires once per hold.
      */
-    onCheckout?: (hold: HoldResult, seats: PickerSeat[]) => void;
+    onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
     /** The open hold expired server-side (widget already reset itself). */
@@ -351,11 +394,21 @@ declare class SeatPicker {
     private rendered;
     private destroyed;
     private els;
+    /** Feature 6 anchor regions — positioned flex containers over the map. */
+    private regions;
     private ro;
     private holdTimer;
     private toastTimer;
     private currency;
     private hold;
+    /** Latest server expiry for the open hold (moves on extend). */
+    private holdExpiresAt;
+    /** True once we handed off to checkout — arms booked-confirmation detection. */
+    private handedOff;
+    /** Guards single onBooked + single success overlay per hold. */
+    private bookedShown;
+    private extendEl;
+    private bookedEl;
     private gaQty;
     private tipEl;
     private tipPos;
@@ -371,6 +424,22 @@ declare class SeatPicker {
     private viewEl;
     private viewCleanup;
     private allSeatsCache;
+    private miniEl;
+    private miniCanvas;
+    private miniBase;
+    private miniTf;
+    private priceBandKeys;
+    private priceFilterEl;
+    /** Last surfaced section summary (re-rendered when the price band changes). */
+    private lastSection;
+    /** Section card collapsed to its slim pill (seat-picking has begun). */
+    private secCardCollapsed;
+    /** When the card was (re)shown — the focus glide's own view change must not collapse it. */
+    private secCardShownAt;
+    /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
+    private lastTrayCount;
+    private a11yChipsEl;
+    private cbEl;
     private modalScrim;
     private prevFocus;
     private escHandler;
@@ -386,6 +455,54 @@ declare class SeatPicker {
     static open(options: Omit<SeatPickerOptions, 'container'>): Promise<SeatPicker>;
     constructor(options: SeatPickerOptions);
     render(): Promise<this>;
+    /**
+     * Move layout-dependent chrome between its wide dock (map regions / zoom
+     * column) and its narrow dock (the sheet's consolidated Filters row), and
+     * re-render the section card in the form the layout wants (docked card/pill
+     * on wide, sheet strip on narrow). Runs on every layout flip + once post-render.
+     */
+    private dockLayoutChrome;
+    /** The "Need more time?" prompt shown in the hold's final EXTEND_PROMPT_MS. */
+    private buildExtendPrompt;
+    /** Success overlay + onBooked fire when the held seats settle to booked. */
+    private buildBookedOverlay;
+    /**
+     * Create the positioned flex containers that own every persistent map overlay.
+     * Appended once after controller.render(); each chrome piece is then appended
+     * INTO its region and flows within it, so nothing free-floats over anything
+     * else. Regions carve the map into non-overlapping zones (top strip split into
+     * left/center/right, left rail, and the three used corners).
+     */
+    private buildRegions;
+    /** Read a resolved --sl-* token value (canvas needs a real color, not var()). */
+    private cssVar;
+    /** Section-bearing objects on the active floor (single-floor → doc.objects). */
+    private activeFloorObjects;
+    /**
+     * Build the overview minimap: a static venue thumbnail (section outlines, or
+     * seat dots when the chart has no sections) with the live viewport rectangle
+     * drawn on top. The rect tracks pan/zoom via the constructor's onViewChange.
+     */
+    private buildMinimap;
+    /** Repaint the static overview + rect (floor switch, live open/close). */
+    private refreshMinimap;
+    /** Paint the venue overview into the offscreen base canvas. */
+    private drawMinimapStatic;
+    /** Blit the base overview, then stroke the current viewport rectangle on top. */
+    private drawMinimapRect;
+    /** Minimap click → focus the section under the point (or overview on a miss). */
+    private minimapJump;
+    /** Effective price of a category (first tier when tiered, else base price). */
+    private catPrice;
+    /** Derive price bands: one chip per distinct price (≤5), else quantile ranges. */
+    private priceBands;
+    /**
+     * Build the price-band chip row in the side panel, directly under the "Prices"
+     * header and above the legend it dims. Living in the panel (not a map overlay)
+     * keeps it clear of the top-center rung pills and top-left a11y chips, and it
+     * rides the bottom sheet on narrow layouts. Skipped when there's <2 bands.
+     */
+    private buildPriceFilter;
     /** Build the rung pills (charts with sections) and floor switcher (>1 floor). */
     private buildArenaChrome;
     /** Reflect the engine's current LOD rung onto the pill group. */
@@ -394,6 +511,22 @@ declare class SeatPicker {
     private syncFloors;
     /** Show (or clear, on null) the tapped-section summary card. */
     private showSectionCard;
+    /**
+     * Render the section card in the form the layout + state want: expanded card
+     * or slim pill in the top-center anchor region (wide), or a compact strip in
+     * the sheet head (narrow). Never floats over the seats at the tap point.
+     */
+    private renderSectionCard;
+    /** Collapse the expanded card to its slim pill (seat-picking started). */
+    private collapseSectionCard;
+    /**
+     * onViewChange hook for the card. The focus glide's own settle (within the
+     * grace window) enforces the ~25% coverage rule with the FINAL viewport; any
+     * later pan/zoom means seat-picking has begun → collapse to the pill.
+     */
+    private sectionCardOnView;
+    /** Fraction of the focused section's on-screen bbox covered by the card. */
+    private sectionCardCoverage;
     /** aria-live readout when keyboard focus lands on a seat. */
     private announceSeat;
     private showConfirm;
@@ -418,6 +551,21 @@ declare class SeatPicker {
     private handleCta;
     private startHoldTimer;
     private stopHoldTimer;
+    /** Show/refresh (or hide) the "Need more time?" prompt with the live seconds left. */
+    private setExtendPrompt;
+    private handleExtend;
+    /**
+     * Fire the booked-confirmation state once the buyer's held seats settle to
+     * booked. The controller clears its own hold the moment every held label reads
+     * 'booked' over the realtime channel (clearBookedHoldIfSettled), and this runs
+     * on the same onStatusChange — so `currentHold() === null` while we still hold
+     * a checkout handoff means "sold", not expired (expiry clears via onHoldExpired
+     * on a different path, which nulls this.hold first).
+     */
+    private detectBooked;
+    private showBooked;
+    /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
+    private buildHandoff;
     private toast;
     private placeTooltip;
     private updateTooltip;
@@ -427,4 +575,4 @@ declare class SeatPicker {
     destroy(): void;
 }
 
-export { ApiError, type BestAvailableResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };

package/dist/index.d.ts

@@ -271,6 +271,40 @@ declare class EmbeddedDesigner {
  * so plain host CSS can restyle too.
  */
 
+/**
+ * Stable checkout-handoff contract (P4). Passed as the THIRD argument to
+ * `onCheckout(hold, seats, handoff)` — additive, so the legacy `(hold, seats)`
+ * shape used by DesiPass web-v2 (SDK 0.7.3+) is untouched. This is the object to
+ * build your order against: it is self-contained (holdId, expiry, currency, and
+ * per-line tier + price) and never changes shape across minor releases.
+ */
+interface CheckoutLineItem {
+    /** Seat label (or GA synthetic-unit label). */
+    label: string;
+    /** Chart object id (row/booth/GA area) the unit belongs to. */
+    objectId: string;
+    objectType: 'seat' | 'booth' | 'ga';
+    categoryKey: string;
+    /** Chosen ticket tier id (Adult/Child/…), or null when the category has no tiers. */
+    tierId: string | null;
+    /** Unit price in MAJOR currency units (e.g. 45 = 45.00). Server-authoritative. */
+    unitPrice: number;
+    /** ISO-4217, resolved server-side (per-event override → org → USD). */
+    currency: string;
+    quantity: number;
+}
+interface CheckoutHandoff {
+    /** Server hold id — pass this to YOUR book call. */
+    holdId: string;
+    /** Epoch ms the hold expires (after any extensions). */
+    expiresAt: number;
+    /** ISO-4217 currency for the whole order. */
+    currency: string;
+    /** Priced line items (tier + unit price + currency), server-authoritative. */
+    lineItems: CheckoutLineItem[];
+    /** Convenience total in major units (Σ unitPrice × quantity). */
+    total: number;
+}
 /** Host theme overrides — any subset; unset keys fall back to the org's chart theme, then defaults. */
 interface SeatPickerTheme {
     /** Brand accent (CTA, active chips, hold pill). */
@@ -332,9 +366,18 @@ interface SeatPickerOptions {
     seatView?: boolean;
     /**
      * Buyer pressed the CTA and the hold succeeded — hand off to YOUR checkout.
-     * The hold carries holdId, expiresAt, seat labels and priced line items.
+     * `hold` and `seats` are the legacy args (unchanged since 0.6). `handoff` (P4)
+     * is the stable, self-contained {@link CheckoutHandoff} to build your order
+     * against — holdId, expiry, currency and priced line items. Prefer it.
+     */
+    onCheckout?: (hold: HoldResult, seats: PickerSeat[], handoff: CheckoutHandoff) => void;
+    /**
+     * The held seats were BOOKED (P4) — your server completed payment and the
+     * booking landed over the realtime channel while the widget was still open.
+     * The widget shows a success state; use this to advance your own UI (receipt,
+     * redirect). Fires once per hold.
      */
-    onCheckout?: (hold: HoldResult, seats: PickerSeat[]) => void;
+    onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
     /** The open hold expired server-side (widget already reset itself). */
@@ -351,11 +394,21 @@ declare class SeatPicker {
     private rendered;
     private destroyed;
     private els;
+    /** Feature 6 anchor regions — positioned flex containers over the map. */
+    private regions;
     private ro;
     private holdTimer;
     private toastTimer;
     private currency;
     private hold;
+    /** Latest server expiry for the open hold (moves on extend). */
+    private holdExpiresAt;
+    /** True once we handed off to checkout — arms booked-confirmation detection. */
+    private handedOff;
+    /** Guards single onBooked + single success overlay per hold. */
+    private bookedShown;
+    private extendEl;
+    private bookedEl;
     private gaQty;
     private tipEl;
     private tipPos;
@@ -371,6 +424,22 @@ declare class SeatPicker {
     private viewEl;
     private viewCleanup;
     private allSeatsCache;
+    private miniEl;
+    private miniCanvas;
+    private miniBase;
+    private miniTf;
+    private priceBandKeys;
+    private priceFilterEl;
+    /** Last surfaced section summary (re-rendered when the price band changes). */
+    private lastSection;
+    /** Section card collapsed to its slim pill (seat-picking has begun). */
+    private secCardCollapsed;
+    /** When the card was (re)shown — the focus glide's own view change must not collapse it. */
+    private secCardShownAt;
+    /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
+    private lastTrayCount;
+    private a11yChipsEl;
+    private cbEl;
     private modalScrim;
     private prevFocus;
     private escHandler;
@@ -386,6 +455,54 @@ declare class SeatPicker {
     static open(options: Omit<SeatPickerOptions, 'container'>): Promise<SeatPicker>;
     constructor(options: SeatPickerOptions);
     render(): Promise<this>;
+    /**
+     * Move layout-dependent chrome between its wide dock (map regions / zoom
+     * column) and its narrow dock (the sheet's consolidated Filters row), and
+     * re-render the section card in the form the layout wants (docked card/pill
+     * on wide, sheet strip on narrow). Runs on every layout flip + once post-render.
+     */
+    private dockLayoutChrome;
+    /** The "Need more time?" prompt shown in the hold's final EXTEND_PROMPT_MS. */
+    private buildExtendPrompt;
+    /** Success overlay + onBooked fire when the held seats settle to booked. */
+    private buildBookedOverlay;
+    /**
+     * Create the positioned flex containers that own every persistent map overlay.
+     * Appended once after controller.render(); each chrome piece is then appended
+     * INTO its region and flows within it, so nothing free-floats over anything
+     * else. Regions carve the map into non-overlapping zones (top strip split into
+     * left/center/right, left rail, and the three used corners).
+     */
+    private buildRegions;
+    /** Read a resolved --sl-* token value (canvas needs a real color, not var()). */
+    private cssVar;
+    /** Section-bearing objects on the active floor (single-floor → doc.objects). */
+    private activeFloorObjects;
+    /**
+     * Build the overview minimap: a static venue thumbnail (section outlines, or
+     * seat dots when the chart has no sections) with the live viewport rectangle
+     * drawn on top. The rect tracks pan/zoom via the constructor's onViewChange.
+     */
+    private buildMinimap;
+    /** Repaint the static overview + rect (floor switch, live open/close). */
+    private refreshMinimap;
+    /** Paint the venue overview into the offscreen base canvas. */
+    private drawMinimapStatic;
+    /** Blit the base overview, then stroke the current viewport rectangle on top. */
+    private drawMinimapRect;
+    /** Minimap click → focus the section under the point (or overview on a miss). */
+    private minimapJump;
+    /** Effective price of a category (first tier when tiered, else base price). */
+    private catPrice;
+    /** Derive price bands: one chip per distinct price (≤5), else quantile ranges. */
+    private priceBands;
+    /**
+     * Build the price-band chip row in the side panel, directly under the "Prices"
+     * header and above the legend it dims. Living in the panel (not a map overlay)
+     * keeps it clear of the top-center rung pills and top-left a11y chips, and it
+     * rides the bottom sheet on narrow layouts. Skipped when there's <2 bands.
+     */
+    private buildPriceFilter;
     /** Build the rung pills (charts with sections) and floor switcher (>1 floor). */
     private buildArenaChrome;
     /** Reflect the engine's current LOD rung onto the pill group. */
@@ -394,6 +511,22 @@ declare class SeatPicker {
     private syncFloors;
     /** Show (or clear, on null) the tapped-section summary card. */
     private showSectionCard;
+    /**
+     * Render the section card in the form the layout + state want: expanded card
+     * or slim pill in the top-center anchor region (wide), or a compact strip in
+     * the sheet head (narrow). Never floats over the seats at the tap point.
+     */
+    private renderSectionCard;
+    /** Collapse the expanded card to its slim pill (seat-picking started). */
+    private collapseSectionCard;
+    /**
+     * onViewChange hook for the card. The focus glide's own settle (within the
+     * grace window) enforces the ~25% coverage rule with the FINAL viewport; any
+     * later pan/zoom means seat-picking has begun → collapse to the pill.
+     */
+    private sectionCardOnView;
+    /** Fraction of the focused section's on-screen bbox covered by the card. */
+    private sectionCardCoverage;
     /** aria-live readout when keyboard focus lands on a seat. */
     private announceSeat;
     private showConfirm;
@@ -418,6 +551,21 @@ declare class SeatPicker {
     private handleCta;
     private startHoldTimer;
     private stopHoldTimer;
+    /** Show/refresh (or hide) the "Need more time?" prompt with the live seconds left. */
+    private setExtendPrompt;
+    private handleExtend;
+    /**
+     * Fire the booked-confirmation state once the buyer's held seats settle to
+     * booked. The controller clears its own hold the moment every held label reads
+     * 'booked' over the realtime channel (clearBookedHoldIfSettled), and this runs
+     * on the same onStatusChange — so `currentHold() === null` while we still hold
+     * a checkout handoff means "sold", not expired (expiry clears via onHoldExpired
+     * on a different path, which nulls this.hold first).
+     */
+    private detectBooked;
+    private showBooked;
+    /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
+    private buildHandoff;
     private toast;
     private placeTooltip;
     private updateTooltip;
@@ -427,4 +575,4 @@ declare class SeatPicker {
     destroy(): void;
 }
 
-export { ApiError, type BestAvailableResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };