@seatlayer/js 0.83.0 → 0.84.0

package/dist/index.d.cts

@@ -3274,6 +3274,21 @@ interface CheckoutOrderStatus {
     pdfUrl?: string;
 }
 
+/**
+ * THE PHONE SHEET HAS THREE RESTING HEIGHTS, smallest first.
+ *
+ * `mini` is the footer alone — total, CTA, by-line — and hands the map every
+ * pixel the widget can spare. `peek` adds the cart, capped at three cards and
+ * a sliver of the fourth. `open` is the whole panel. Owner, 2026-09-06: two
+ * held seats left the collapsed sheet owning ~45% of a real iPhone with no way
+ * to make it smaller, and the arrow was the control that should have done it.
+ *
+ * Order is load-bearing: `stepSheet` walks this array, so a swipe up is +1 and
+ * a swipe down is -1 with no state table anywhere else.
+ */
+declare const SHEET_STATES: readonly ["mini", "peek", "open"];
+/** @internal */
+type SheetState = (typeof SHEET_STATES)[number];
 declare class SeatPicker implements GaPromptPicker {
     /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
     readonly opts: SeatPickerOptions;
@@ -3490,7 +3505,9 @@ declare class SeatPicker implements GaPromptPicker {
      *  repaint — see SectionCard.adopt. */
     /** @internal */ get lastSection(): SectionSummary | null;
     /** @internal */ set lastSection(summary: SectionSummary | null);
-    /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
+    /** Previous tray ticket count — a 0→n transition pulses the CTA and, on the
+     *  phone, decides whether the seat landed in a sheet that was showing the
+     *  footer alone (which then stays that way). It never expands the sheet. */
     /** @internal */ lastTrayCount: number;
     /** The opt-in language switcher, when `languages` named at least two. */
     private langSel;
@@ -3610,11 +3627,69 @@ declare class SeatPicker implements GaPromptPicker {
     /** Wire host chrome after the skeleton exists and before the renderer owns its map host. */
     private wireBuyerShell;
     /**
-     * Open or collapse the phone sheet, and say so.
+     * Which rung the phone sheet is resting on.
+     *
+     * Anything the DOM does not recognise reads as `peek`, which is the state a
+     * narrow layout is born in (see observeLayout).
+     *
+     * @internal
+     */
+    sheetState(): SheetState;
+    /**
+     * AN EMPTY CART HAS NO `mini`.
+     *
+     * `mini` exists to get the ticket LIST out of the way; with nothing in the
+     * cart `peek` already hides the tray, so the two states would be the same
+     * pixels with two names — and a chevron that appears to do nothing.
+     */
+    private sheetHasCards;
+    /**
+     * Put the phone sheet on a named rung, and say so.
+     *
+     * The one place `data-sheet` is written, so the chevron's direction, its
+     * `aria-expanded` and its label can never drift from the state — a chevron
+     * that says "Open ticket panel" over an open panel is worse than no label.
+     *
+     * @internal
+     */
+    setSheetState(state: SheetState): void;
+    /**
+     * The chevron's whole meaning: "there is still something here to put away".
+     *
+     * DOWN — and `aria-expanded` aside, the label says collapse — whenever a tap
+     * makes the sheet smaller: from `open`, and from `peek` while the cart has
+     * cards to hide. UP in `mini`, and in a `peek` whose cart is empty, because
+     * from there the only way is up. `aria-expanded` is true in `open` alone:
+     * that is the only state where the whole panel is disclosed.
+     *
+     * @internal
+     */
+    syncSheetAffordance(): void;
+    /**
+     * A TAP ALWAYS DOES WHAT THE CHEVRON SHOWS.
+     *
+     * `open` → `peek` → `mini` → `peek` → … so a buyer who wants the map keeps
+     * tapping the same spot and keeps getting more of it, and one more tap brings
+     * their tickets back. An empty cart skips `mini` entirely: `peek` is already
+     * the footer alone, so its tap opens the panel instead.
+     *
+     * @internal
+     */
+    cycleSheet(): void;
+    /**
+     * One rung up (+1) or down (-1), clamped at both ends.
+     *
+     * The swipe's counterpart to `cycleSheet`: a drag says which DIRECTION the
+     * buyer wants, so it never wraps the way the tap does.
+     *
+     * @internal
+     */
+    stepSheet(delta: 1 | -1): void;
+    /**
+     * Open or collapse the phone sheet.
      *
-     * The one place `data-sheet` is written together with the chevron's
-     * `aria-expanded` and its label: the two used to drift, and a chevron that
-     * says "Open ticket panel" over an open panel is worse than no label at all.
+     * Kept as the two-value door for callers that only ever mean "all the way
+     * up" or "back to the cart" — the price disclosure and the best-seats form.
      *
      * @internal
      */
@@ -3849,20 +3924,40 @@ declare class SeatPicker implements GaPromptPicker {
     /** Reflect the engine's current LOD rung onto the pill group. */
     /** @internal */ syncRung(): void;
     /**
-     * The phone's back-out controls, and whether they still have anywhere to go.
+     * The map's back-out controls, and whether they still have anywhere to go.
      *
      * On narrow the corner carries "+", "−" and the fit disc (owner call
      * 2026-09-05). "−" is the ladder — one tap to the section the buyer drilled
      * into, one more to the whole venue — and the fit disc is that last step on
-     * its own. The ladder itself is `mapZoomOutStep`; this only dresses it, and
-     * only on narrow: wide keeps "+" and "−" undimmed and never shows the disc.
-     *
-     * DIMMED, NOT GONE. The controls used to appear only once the buyer was deep
-     * enough to be lost, so the corner grew and shrank a button underneath their
-     * thumb. A control that stays put and plainly cannot be pressed says "you
-     * are already looking at everything" without moving the target — as long as
-     * it dims only when that is TRUE, which is why the reading is the engine's
-     * fit pose and not a guess from whether seats happen to be on screen.
+     * its own. The ladder itself is `mapZoomOutStep`; this only dresses it. Wide
+     * carries "+" and "−" and never shows the fit disc (CSS, see pickerStyles),
+     * but "−" answers to the same reading there.
+     *
+     * GONE, NOT DIMMED (owner call 2026-09-06, from real-iPhone captures, and
+     * the second time this has been asked for). The previous rationale here was
+     * that a control which stays put and plainly cannot be pressed says "you are
+     * already looking at everything" without moving the target. It does not: two
+     * greyed discs at the arrival view are read as a broken map, and they are
+     * the FIRST thing a buyer sees, before they have any model of the ladder
+     * they are at the top of. Hidden, the column at the whole-venue view is ♿
+     * and "+" — every disc on screen does something — and "−"/fit reappear the
+     * moment there is a step to take, which is the tap that put them there.
+     *
+     * `hidden`, and a CSS rule loud enough to beat the narrow `display:flex` on
+     * the fit disc. display:none, so the column closes the gap rather than
+     * leaving the ♿ floating a disc and a half off the corner — which is also
+     * why the ♿ menu is re-bounded afterwards: its panel is clamped to the room
+     * above a button that has just moved.
+     *
+     * "+" GOES THE SAME WAY AT THE OTHER END (owner, 2026-09-06, from the phone:
+     * "if we already deep where we selecting the seat, plus not make further
+     * sense"). "Deep" is the renderer's own `seatsPickable` — seats drawn big
+     * enough to aim a thumb at — not the numeric zoom ceiling, which sits well
+     * past that and left the disc standing on the very camera the owner was
+     * looking at ("minus icon still showing", same afternoon, meaning the
+     * column had not changed). The ceiling still counts: a press there is a
+     * no-op whatever the seats measure. An engine that cannot answer either
+     * question leaves the disc alone.
      */
     private syncMapStepBack;
     /** @internal */ syncProjection(): void;

package/dist/index.d.ts

@@ -3274,6 +3274,21 @@ interface CheckoutOrderStatus {
     pdfUrl?: string;
 }
 
+/**
+ * THE PHONE SHEET HAS THREE RESTING HEIGHTS, smallest first.
+ *
+ * `mini` is the footer alone — total, CTA, by-line — and hands the map every
+ * pixel the widget can spare. `peek` adds the cart, capped at three cards and
+ * a sliver of the fourth. `open` is the whole panel. Owner, 2026-09-06: two
+ * held seats left the collapsed sheet owning ~45% of a real iPhone with no way
+ * to make it smaller, and the arrow was the control that should have done it.
+ *
+ * Order is load-bearing: `stepSheet` walks this array, so a swipe up is +1 and
+ * a swipe down is -1 with no state table anywhere else.
+ */
+declare const SHEET_STATES: readonly ["mini", "peek", "open"];
+/** @internal */
+type SheetState = (typeof SHEET_STATES)[number];
 declare class SeatPicker implements GaPromptPicker {
     /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
     readonly opts: SeatPickerOptions;
@@ -3490,7 +3505,9 @@ declare class SeatPicker implements GaPromptPicker {
      *  repaint — see SectionCard.adopt. */
     /** @internal */ get lastSection(): SectionSummary | null;
     /** @internal */ set lastSection(summary: SectionSummary | null);
-    /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
+    /** Previous tray ticket count — a 0→n transition pulses the CTA and, on the
+     *  phone, decides whether the seat landed in a sheet that was showing the
+     *  footer alone (which then stays that way). It never expands the sheet. */
     /** @internal */ lastTrayCount: number;
     /** The opt-in language switcher, when `languages` named at least two. */
     private langSel;
@@ -3610,11 +3627,69 @@ declare class SeatPicker implements GaPromptPicker {
     /** Wire host chrome after the skeleton exists and before the renderer owns its map host. */
     private wireBuyerShell;
     /**
-     * Open or collapse the phone sheet, and say so.
+     * Which rung the phone sheet is resting on.
+     *
+     * Anything the DOM does not recognise reads as `peek`, which is the state a
+     * narrow layout is born in (see observeLayout).
+     *
+     * @internal
+     */
+    sheetState(): SheetState;
+    /**
+     * AN EMPTY CART HAS NO `mini`.
+     *
+     * `mini` exists to get the ticket LIST out of the way; with nothing in the
+     * cart `peek` already hides the tray, so the two states would be the same
+     * pixels with two names — and a chevron that appears to do nothing.
+     */
+    private sheetHasCards;
+    /**
+     * Put the phone sheet on a named rung, and say so.
+     *
+     * The one place `data-sheet` is written, so the chevron's direction, its
+     * `aria-expanded` and its label can never drift from the state — a chevron
+     * that says "Open ticket panel" over an open panel is worse than no label.
+     *
+     * @internal
+     */
+    setSheetState(state: SheetState): void;
+    /**
+     * The chevron's whole meaning: "there is still something here to put away".
+     *
+     * DOWN — and `aria-expanded` aside, the label says collapse — whenever a tap
+     * makes the sheet smaller: from `open`, and from `peek` while the cart has
+     * cards to hide. UP in `mini`, and in a `peek` whose cart is empty, because
+     * from there the only way is up. `aria-expanded` is true in `open` alone:
+     * that is the only state where the whole panel is disclosed.
+     *
+     * @internal
+     */
+    syncSheetAffordance(): void;
+    /**
+     * A TAP ALWAYS DOES WHAT THE CHEVRON SHOWS.
+     *
+     * `open` → `peek` → `mini` → `peek` → … so a buyer who wants the map keeps
+     * tapping the same spot and keeps getting more of it, and one more tap brings
+     * their tickets back. An empty cart skips `mini` entirely: `peek` is already
+     * the footer alone, so its tap opens the panel instead.
+     *
+     * @internal
+     */
+    cycleSheet(): void;
+    /**
+     * One rung up (+1) or down (-1), clamped at both ends.
+     *
+     * The swipe's counterpart to `cycleSheet`: a drag says which DIRECTION the
+     * buyer wants, so it never wraps the way the tap does.
+     *
+     * @internal
+     */
+    stepSheet(delta: 1 | -1): void;
+    /**
+     * Open or collapse the phone sheet.
      *
-     * The one place `data-sheet` is written together with the chevron's
-     * `aria-expanded` and its label: the two used to drift, and a chevron that
-     * says "Open ticket panel" over an open panel is worse than no label at all.
+     * Kept as the two-value door for callers that only ever mean "all the way
+     * up" or "back to the cart" — the price disclosure and the best-seats form.
      *
      * @internal
      */
@@ -3849,20 +3924,40 @@ declare class SeatPicker implements GaPromptPicker {
     /** Reflect the engine's current LOD rung onto the pill group. */
     /** @internal */ syncRung(): void;
     /**
-     * The phone's back-out controls, and whether they still have anywhere to go.
+     * The map's back-out controls, and whether they still have anywhere to go.
      *
      * On narrow the corner carries "+", "−" and the fit disc (owner call
      * 2026-09-05). "−" is the ladder — one tap to the section the buyer drilled
      * into, one more to the whole venue — and the fit disc is that last step on
-     * its own. The ladder itself is `mapZoomOutStep`; this only dresses it, and
-     * only on narrow: wide keeps "+" and "−" undimmed and never shows the disc.
-     *
-     * DIMMED, NOT GONE. The controls used to appear only once the buyer was deep
-     * enough to be lost, so the corner grew and shrank a button underneath their
-     * thumb. A control that stays put and plainly cannot be pressed says "you
-     * are already looking at everything" without moving the target — as long as
-     * it dims only when that is TRUE, which is why the reading is the engine's
-     * fit pose and not a guess from whether seats happen to be on screen.
+     * its own. The ladder itself is `mapZoomOutStep`; this only dresses it. Wide
+     * carries "+" and "−" and never shows the fit disc (CSS, see pickerStyles),
+     * but "−" answers to the same reading there.
+     *
+     * GONE, NOT DIMMED (owner call 2026-09-06, from real-iPhone captures, and
+     * the second time this has been asked for). The previous rationale here was
+     * that a control which stays put and plainly cannot be pressed says "you are
+     * already looking at everything" without moving the target. It does not: two
+     * greyed discs at the arrival view are read as a broken map, and they are
+     * the FIRST thing a buyer sees, before they have any model of the ladder
+     * they are at the top of. Hidden, the column at the whole-venue view is ♿
+     * and "+" — every disc on screen does something — and "−"/fit reappear the
+     * moment there is a step to take, which is the tap that put them there.
+     *
+     * `hidden`, and a CSS rule loud enough to beat the narrow `display:flex` on
+     * the fit disc. display:none, so the column closes the gap rather than
+     * leaving the ♿ floating a disc and a half off the corner — which is also
+     * why the ♿ menu is re-bounded afterwards: its panel is clamped to the room
+     * above a button that has just moved.
+     *
+     * "+" GOES THE SAME WAY AT THE OTHER END (owner, 2026-09-06, from the phone:
+     * "if we already deep where we selecting the seat, plus not make further
+     * sense"). "Deep" is the renderer's own `seatsPickable` — seats drawn big
+     * enough to aim a thumb at — not the numeric zoom ceiling, which sits well
+     * past that and left the disc standing on the very camera the owner was
+     * looking at ("minus icon still showing", same afternoon, meaning the
+     * column had not changed). The ceiling still counts: a press there is a
+     * no-op whatever the seats measure. An engine that cannot answer either
+     * question leaves the disc alone.
      */
     private syncMapStepBack;
     /** @internal */ syncProjection(): void;