@seatlayer/js 0.80.1 → 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,
@@ -1881,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;
@@ -2092,6 +2137,35 @@ declare class SeatingChart {
      * 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.

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,
@@ -1881,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;
@@ -2092,6 +2137,35 @@ declare class SeatingChart {
      * 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.