@seatlayer/js 0.80.0 → 0.80.2

package/dist/index.d.cts

@@ -1349,6 +1349,48 @@ interface SeatPickerOptions {
     onError?: (err: unknown) => void;
 }
 
+/**
+ * Two things a NATIVE shell drawing its own chrome over the map needs from the
+ * embed, neither of which the web picker needs because it draws that chrome
+ * itself inside the same document.
+ *
+ * 1. **Blocked regions.** On iOS 26 a tap on a native control laid over the
+ *    WebView reaches WKWebView as well — measured on a Flutter host: the shell
+ *    rejects the platform view's gesture 134 ms before the finger lifts and the
+ *    page still gets the touch, so a press on the `−` disc selected the seat
+ *    under it. The only guard that works is one standing BEFORE the finger
+ *    lands (`setInteractionEnabled(false)` issued on pointer-down loses the
+ *    race: ~180 ms of bridge round trip against a 24 ms tap). So the shell
+ *    tells the embed where its chrome is, once per layout, and every pointer
+ *    sequence that STARTS inside one of those rectangles is swallowed here in
+ *    the capture phase, before the gesture machine or the canvas can see it.
+ *
+ * 2. **Framing a seat above a sheet.** The web picker's phone confirm card is a
+ *    resting bottom sheet, and the tapped seat is lifted into the clear band
+ *    above it at unchanged zoom — a pan, never a zoom, and never for a buyer
+ *    who has since moved the map themselves. A native sheet wants the same,
+ *    and the only framing the bridge offered was a refit that changes zoom.
+ *    {@link seatFrameNudge} is that placement rule with the host's reported
+ *    insets standing in for the sheet.
+ *
+ * Both live here rather than in `SeatingChart`, which is at its size cap; the
+ * chart delegates and stays a thin surface.
+ */
+/** A rectangle of native chrome over the map, in the map's own CSS px. */
+type BlockedRegion = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/** Read-only view of what the embed is honouring, for tests and diagnostics. */
+type BlockedRegionList = ReadonlyArray<Readonly<BlockedRegion>>;
+/** What `frameSeat` answers: the pan it made, and the buyer's gesture count. */
+type SeatFrameResult = {
+    dy: number;
+    gestures: number;
+};
+
 /**
  * Serializable state exposed to hosted native picker chrome. It deliberately
  * contains buyer-display data only: never API keys, buyer-access bearers,
@@ -1816,6 +1858,20 @@ interface SeatingChartOptions {
      * `null` clears it. Purely informational; nothing is ever prevented.
      */
     onHint?: (message: string | null) => void;
+    /**
+     * The buyer tapped a seat that is ALREADY in the selection.
+     *
+     * The seat is still selected when this fires — this class deliberately does
+     * NOT toggle it back out, because it draws no card to say so and a silent
+     * drop is how a buyer loses a seat by checking which one they picked
+     * (reproduced on device through the native bridge, 2026-09-04). The host
+     * shows its own "Remove this seat?" and calls `deselectObjects([seat.id])`
+     * if the buyer says yes; doing nothing keeps the seat.
+     *
+     * Grouped tables and server-held units never arrive here: they keep their own
+     * paths (`onTableSelectionRequest`, the hold release).
+     */
+    onSeatRetap?: (seat: PickerSeat) => void;
 }
 declare class SeatingChart {
     private readonly opts;
@@ -1867,6 +1923,9 @@ declare class SeatingChart {
     private readonly apiBase;
     private readonly buyerAssetUrls;
     private readonly immersive;
+    /** Native chrome over the map — see ./seatingChartNativeChrome. Made on
+     *  first use: most hosts never report any. */
+    private blockedRegions;
     private realtime;
     /** Labels whose hold request is in flight — see ControllerSinkOptions.ownLabels. */
     private holdingLabels;
@@ -2069,6 +2128,44 @@ declare class SeatingChart {
     setFloor(floorId: string): void;
     /** How the stacked view marks each level: a `G/1/2` badge, or floor names. */
     setFloorLabelStyle(style: FloorLabelStyle): void;
+    /**
+     * Does entering a section dim the rest of the venue?
+     *
+     * Unset, the map answers from its own stage width — no dim on a phone-sized
+     * stage, where the focused section fills the viewport and the dim only
+     * blackens the strip of edges around it. A native shell that wants the
+     * desktop treatment (or wants it back after asking for it off) pins it here.
+     */
+    setSectionFocusDim(enabled: boolean): void;
+    /**
+     * Paint `seatId` as the seat the buyer is being asked about — the thick
+     * double ring, the halo, the neighbours paled — or clear it with `null`.
+     *
+     * Every selected seat is otherwise drawn alike, and on a native host the
+     * card asking "this one?" is drawn by the shell, so without this the tapped
+     * seat is one plain ring among the buyer's others (observed on device as a
+     * faint grey ring, 2026-09-05). Paint only: it selects nothing and moves no
+     * camera. A seat that is not selected clears the focus instead.
+     */
+    setSelectionFocus(seatId: string | null): void;
+    /**
+     * Where the host's chrome lies OVER the map, in the map's CSS px. A pointer
+     * sequence that starts inside one of these never reaches the map — the
+     * guard an iOS host needs because its own controls let the tap through to
+     * the WebView. The whole list is replaced on every call; `[]` clears.
+     */
+    setBlockedRegions(rects: BlockedRegionList): void;
+    getBlockedRegions(): BlockedRegionList;
+    /**
+     * Pan — never zoom — so `seatId` rests in the band the reported viewport
+     * insets leave clear, the way the web sheet lifts a tapped seat above
+     * itself. See {@link frameSeat} for the guards.
+     */
+    frameSeat(seatId: string, opts?: {
+        fraction?: number;
+        animate?: boolean;
+        gestures?: number;
+    }): SeatFrameResult;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
     /** Switch the 2D canvas projection.
@@ -3281,7 +3378,6 @@ declare class SeatPicker implements GaPromptPicker {
      */
     private baReopen;
     private bestAvailableConfirm;
-    private releasingHold;
     /** Event sales window is closed (read-only load state / live close). */
     /** @internal */ salesClosed: boolean;
     /** Every seated category's live availability is 0 (sold-out overlay is up). */
@@ -3373,7 +3469,6 @@ declare class SeatPicker implements GaPromptPicker {
     /** Host-level event chrome owns the duplicate identity outside full screen. */
     private eventDetailsHidden;
     /** True while the hold note reads "N more selected" — the tick must not overwrite it. */
-    /** @internal */ holdCopyPending: boolean;
     /** Wide-layout ticket panel collapsed (map owns the full width). */
     private sideCollapsed;
     private sideToggleEl;
@@ -3629,7 +3724,7 @@ declare class SeatPicker implements GaPromptPicker {
     /** @internal */ rememberedHoldId(): string | null;
     /** @internal */ rememberHold(hold: HoldResult): void;
     /** @internal */ forgetHold(): void;
-    /** @internal */ resumeHoldFromServer(holdId: string, automatic: boolean): Promise<HoldResult | null>;
+    /** @internal */ resumeHoldFromServer(holdId: string): Promise<HoldResult | null>;
     private restoreRememberedHold;
     /** Section-bearing objects on the active floor (single-floor → doc.objects). */
     private activeFloorObjects;
@@ -3833,20 +3928,6 @@ declare class SeatPicker implements GaPromptPicker {
      *  clear. Shares `priceBandKeys` with the band selector so the row-dim state
      *  has one source of truth (and each control resets the other). */
     /** @internal */ focusCategory(key: string): void;
-    /**
-     * Live-activity strip: turn WS availability deltas into one quiet line of
-     * social proof ("2 seats just taken in VIP · 118 left"). Diffs per-category
-     * counts on every status change — no per-seat payload needed. Skips the very
-     * first computation (initial load is not "activity").
-     */
-    /** @internal */ narrateAvailability(categories: Array<{
-        key: string;
-        label: string;
-    }>, left: Record<string, number>): void;
-    /** @internal */ lastCatAvail: Record<string, number> | null;
-    /** @internal */ lastAvailFloorId: string;
-    /** @internal */ availQuietUntil: number;
-    /** @internal */ liveTimer: ReturnType<typeof setTimeout> | null;
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
     private evictTakenSelections;
     /** @internal */ syncTray(): void;
@@ -3874,12 +3955,13 @@ declare class SeatPicker implements GaPromptPicker {
      * "PIT · Adult ×2" means both of them, not one of two identical cards.
      */
     private removeHeldLabels;
-    private handleChangeSeats;
     /** @internal */ handleCta(): Promise<void>;
     /** @internal */ startHoldTimer(expiresAt: number): void;
     /** @internal */ stopHoldTimer(): void;
     /** Show/refresh (or hide) the "Need more time?" prompt with the live seconds left. */
     /** @internal */ setExtendPrompt(show: boolean, ms: number): void;
+    /** Re-ask whether the extend offer is due — for a layout flip, not a tick. */
+    /** @internal */ refreshExtendPrompt(): void;
     /** @internal */ handleExtend(): Promise<void>;
     /**
      * Fire the booked-confirmation state once the buyer's held seats settle to

package/dist/index.d.ts

@@ -1349,6 +1349,48 @@ interface SeatPickerOptions {
     onError?: (err: unknown) => void;
 }
 
+/**
+ * Two things a NATIVE shell drawing its own chrome over the map needs from the
+ * embed, neither of which the web picker needs because it draws that chrome
+ * itself inside the same document.
+ *
+ * 1. **Blocked regions.** On iOS 26 a tap on a native control laid over the
+ *    WebView reaches WKWebView as well — measured on a Flutter host: the shell
+ *    rejects the platform view's gesture 134 ms before the finger lifts and the
+ *    page still gets the touch, so a press on the `−` disc selected the seat
+ *    under it. The only guard that works is one standing BEFORE the finger
+ *    lands (`setInteractionEnabled(false)` issued on pointer-down loses the
+ *    race: ~180 ms of bridge round trip against a 24 ms tap). So the shell
+ *    tells the embed where its chrome is, once per layout, and every pointer
+ *    sequence that STARTS inside one of those rectangles is swallowed here in
+ *    the capture phase, before the gesture machine or the canvas can see it.
+ *
+ * 2. **Framing a seat above a sheet.** The web picker's phone confirm card is a
+ *    resting bottom sheet, and the tapped seat is lifted into the clear band
+ *    above it at unchanged zoom — a pan, never a zoom, and never for a buyer
+ *    who has since moved the map themselves. A native sheet wants the same,
+ *    and the only framing the bridge offered was a refit that changes zoom.
+ *    {@link seatFrameNudge} is that placement rule with the host's reported
+ *    insets standing in for the sheet.
+ *
+ * Both live here rather than in `SeatingChart`, which is at its size cap; the
+ * chart delegates and stays a thin surface.
+ */
+/** A rectangle of native chrome over the map, in the map's own CSS px. */
+type BlockedRegion = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/** Read-only view of what the embed is honouring, for tests and diagnostics. */
+type BlockedRegionList = ReadonlyArray<Readonly<BlockedRegion>>;
+/** What `frameSeat` answers: the pan it made, and the buyer's gesture count. */
+type SeatFrameResult = {
+    dy: number;
+    gestures: number;
+};
+
 /**
  * Serializable state exposed to hosted native picker chrome. It deliberately
  * contains buyer-display data only: never API keys, buyer-access bearers,
@@ -1816,6 +1858,20 @@ interface SeatingChartOptions {
      * `null` clears it. Purely informational; nothing is ever prevented.
      */
     onHint?: (message: string | null) => void;
+    /**
+     * The buyer tapped a seat that is ALREADY in the selection.
+     *
+     * The seat is still selected when this fires — this class deliberately does
+     * NOT toggle it back out, because it draws no card to say so and a silent
+     * drop is how a buyer loses a seat by checking which one they picked
+     * (reproduced on device through the native bridge, 2026-09-04). The host
+     * shows its own "Remove this seat?" and calls `deselectObjects([seat.id])`
+     * if the buyer says yes; doing nothing keeps the seat.
+     *
+     * Grouped tables and server-held units never arrive here: they keep their own
+     * paths (`onTableSelectionRequest`, the hold release).
+     */
+    onSeatRetap?: (seat: PickerSeat) => void;
 }
 declare class SeatingChart {
     private readonly opts;
@@ -1867,6 +1923,9 @@ declare class SeatingChart {
     private readonly apiBase;
     private readonly buyerAssetUrls;
     private readonly immersive;
+    /** Native chrome over the map — see ./seatingChartNativeChrome. Made on
+     *  first use: most hosts never report any. */
+    private blockedRegions;
     private realtime;
     /** Labels whose hold request is in flight — see ControllerSinkOptions.ownLabels. */
     private holdingLabels;
@@ -2069,6 +2128,44 @@ declare class SeatingChart {
     setFloor(floorId: string): void;
     /** How the stacked view marks each level: a `G/1/2` badge, or floor names. */
     setFloorLabelStyle(style: FloorLabelStyle): void;
+    /**
+     * Does entering a section dim the rest of the venue?
+     *
+     * Unset, the map answers from its own stage width — no dim on a phone-sized
+     * stage, where the focused section fills the viewport and the dim only
+     * blackens the strip of edges around it. A native shell that wants the
+     * desktop treatment (or wants it back after asking for it off) pins it here.
+     */
+    setSectionFocusDim(enabled: boolean): void;
+    /**
+     * Paint `seatId` as the seat the buyer is being asked about — the thick
+     * double ring, the halo, the neighbours paled — or clear it with `null`.
+     *
+     * Every selected seat is otherwise drawn alike, and on a native host the
+     * card asking "this one?" is drawn by the shell, so without this the tapped
+     * seat is one plain ring among the buyer's others (observed on device as a
+     * faint grey ring, 2026-09-05). Paint only: it selects nothing and moves no
+     * camera. A seat that is not selected clears the focus instead.
+     */
+    setSelectionFocus(seatId: string | null): void;
+    /**
+     * Where the host's chrome lies OVER the map, in the map's CSS px. A pointer
+     * sequence that starts inside one of these never reaches the map — the
+     * guard an iOS host needs because its own controls let the tap through to
+     * the WebView. The whole list is replaced on every call; `[]` clears.
+     */
+    setBlockedRegions(rects: BlockedRegionList): void;
+    getBlockedRegions(): BlockedRegionList;
+    /**
+     * Pan — never zoom — so `seatId` rests in the band the reported viewport
+     * insets leave clear, the way the web sheet lifts a tapped seat above
+     * itself. See {@link frameSeat} for the guards.
+     */
+    frameSeat(seatId: string, opts?: {
+        fraction?: number;
+        animate?: boolean;
+        gestures?: number;
+    }): SeatFrameResult;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
     /** Switch the 2D canvas projection.
@@ -3281,7 +3378,6 @@ declare class SeatPicker implements GaPromptPicker {
      */
     private baReopen;
     private bestAvailableConfirm;
-    private releasingHold;
     /** Event sales window is closed (read-only load state / live close). */
     /** @internal */ salesClosed: boolean;
     /** Every seated category's live availability is 0 (sold-out overlay is up). */
@@ -3373,7 +3469,6 @@ declare class SeatPicker implements GaPromptPicker {
     /** Host-level event chrome owns the duplicate identity outside full screen. */
     private eventDetailsHidden;
     /** True while the hold note reads "N more selected" — the tick must not overwrite it. */
-    /** @internal */ holdCopyPending: boolean;
     /** Wide-layout ticket panel collapsed (map owns the full width). */
     private sideCollapsed;
     private sideToggleEl;
@@ -3629,7 +3724,7 @@ declare class SeatPicker implements GaPromptPicker {
     /** @internal */ rememberedHoldId(): string | null;
     /** @internal */ rememberHold(hold: HoldResult): void;
     /** @internal */ forgetHold(): void;
-    /** @internal */ resumeHoldFromServer(holdId: string, automatic: boolean): Promise<HoldResult | null>;
+    /** @internal */ resumeHoldFromServer(holdId: string): Promise<HoldResult | null>;
     private restoreRememberedHold;
     /** Section-bearing objects on the active floor (single-floor → doc.objects). */
     private activeFloorObjects;
@@ -3833,20 +3928,6 @@ declare class SeatPicker implements GaPromptPicker {
      *  clear. Shares `priceBandKeys` with the band selector so the row-dim state
      *  has one source of truth (and each control resets the other). */
     /** @internal */ focusCategory(key: string): void;
-    /**
-     * Live-activity strip: turn WS availability deltas into one quiet line of
-     * social proof ("2 seats just taken in VIP · 118 left"). Diffs per-category
-     * counts on every status change — no per-seat payload needed. Skips the very
-     * first computation (initial load is not "activity").
-     */
-    /** @internal */ narrateAvailability(categories: Array<{
-        key: string;
-        label: string;
-    }>, left: Record<string, number>): void;
-    /** @internal */ lastCatAvail: Record<string, number> | null;
-    /** @internal */ lastAvailFloorId: string;
-    /** @internal */ availQuietUntil: number;
-    /** @internal */ liveTimer: ReturnType<typeof setTimeout> | null;
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
     private evictTakenSelections;
     /** @internal */ syncTray(): void;
@@ -3874,12 +3955,13 @@ declare class SeatPicker implements GaPromptPicker {
      * "PIT · Adult ×2" means both of them, not one of two identical cards.
      */
     private removeHeldLabels;
-    private handleChangeSeats;
     /** @internal */ handleCta(): Promise<void>;
     /** @internal */ startHoldTimer(expiresAt: number): void;
     /** @internal */ stopHoldTimer(): void;
     /** Show/refresh (or hide) the "Need more time?" prompt with the live seconds left. */
     /** @internal */ setExtendPrompt(show: boolean, ms: number): void;
+    /** Re-ask whether the extend offer is due — for a layout flip, not a tick. */
+    /** @internal */ refreshExtendPrompt(): void;
     /** @internal */ handleExtend(): Promise<void>;
     /**
      * Fire the booked-confirmation state once the buyer's held seats settle to