@seatlayer/core 0.14.0 → 0.15.0

package/dist/index.d.cts

@@ -433,6 +433,19 @@ interface ISeatmapRenderer {
     }): void;
     /** Bulk status update; re-renders affected seats only. */
     setStatus(seatIds: string[], status: SeatStatus): void;
+    /**
+     * Mark the active buyer's own held seats. They remain server-status `held`,
+     * but render with the buyer selection treatment instead of the anonymous
+     * unavailable treatment used for another buyer's hold.
+     */
+    setOwnedHold?(seatIds: string[] | null): void;
+    /**
+     * Mark one selected seat as the buyer's pending confirmation candidate.
+     * The candidate receives a strong focus halo while unrelated seats recede;
+     * pass null after Select/Cancel. This is visual only and never mutates the
+     * renderer selection.
+     */
+    setSelectionFocus?(seatId: string | null): void;
     /**
      * SYNCHRONOUS repaint that bypasses requestAnimationFrame. Konva's batchDraw()
      * (used by setStatus and friends) schedules the actual paint on the next rAF
@@ -774,6 +787,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private circleById;
     /** Booth block geometry, keyed by booth id (= the unit's rowId). */
     private boothDims;
+    /** Booth label node so status changes can say HELD/SOLD on the full block. */
+    private boothLabelById;
     private statusById;
     private catColor;
     private theme;
@@ -784,7 +799,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Category order from the doc — the stable index into the CB palette. */
     private catOrder;
     private selection;
-    private selectionRings;
+    /** Whole-seat/block selection markers: outline + non-colour check cue. */
+    private selectionMarkers;
+    /** Held by this picker instance, not by another buyer. */
+    private ownedHold;
+    /** One selected seat being inspected before it is committed to the cart. */
+    private selectionFocusId;
     private hoverRing;
     /** Keyboard-navigation focus ring + the currently focused seat id. */
     private focusRing;
@@ -852,7 +872,9 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private pointers;
     private pinch;
     private panLast;
-    /** Cumulative gesture movement in px — clicks are suppressed after a real pan/pinch. */
+    private panStart;
+    private panStarted;
+    /** Maximum displacement from gesture start — suppress taps only after a real pan/pinch. */
     private moved;
     /**
      * Manage-mode rubber-band marquee (option-gated). `start`/`cur` are WORLD-space
@@ -881,6 +903,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     }[];
     getActiveFloorId(): string;
     setStatus(seatIds: string[], status: SeatStatus): void;
+    setOwnedHold(seatIds: string[] | null): void;
+    setSelectionFocus(seatId: string | null): void;
     getStatus(seatId: string): SeatStatus;
     getSelection(): ExpandedSeat[];
     clearSelection(): void;
@@ -1138,6 +1162,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     private resolveSelectionColor;
     private setSelected;
+    /** Rebuild one marker after selected/held/candidate state changes. */
+    private syncSelectionMarker;
     /**
      * The stage scale `focusRegion(id)` would settle at — i.e. the zoom that
      * frames this section in the current viewport. Used to decide whether
@@ -1200,6 +1226,7 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
         height: number;
     }, opts?: {
         animate?: boolean;
+        minScale?: number;
     }): void;
     /** Cancel an in-flight camera glide (a grab or a newer glide interrupts it). */
     private cancelGlide;
@@ -1255,6 +1282,10 @@ interface SeatHoverDetails extends PickerSeat {
     categoryColor: string;
     status: SeatStatus;
     currency: string;
+    /** Human-readable spatial context for hover and confirmation UI. */
+    sectionLabel?: string;
+    rowLabel?: string;
+    seatNumber?: string;
 }
 interface HoldConflict {
     label: string;
@@ -1302,6 +1333,9 @@ interface HoldResponse {
     expiresAt: number;
     items?: HoldServerItem[];
 }
+interface ResumeHoldResponse extends HoldResponse {
+    items: HoldServerItem[];
+}
 interface HoldServerItem {
     label: string;
     objectId: string;
@@ -1341,6 +1375,8 @@ interface PickerTransport {
     hold(key: string, selections: HoldSelectionRequest[], ttlMs?: number, replaceHoldId?: string): Promise<HoldResponse>;
     bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResponse>;
     release(key: string, labels: string[], holdId: string): Promise<unknown>;
+    /** Optional capability-style lookup used to restore an active browser hold. */
+    resume?(key: string, holdId: string): Promise<ResumeHoldResponse>;
     /** Optional — the SDK omits booking (it hands the holdId to the host page). */
     book?(key: string, labels: string[], holdId: string, bookingRef: string): Promise<unknown>;
     /** Optional (P4) — push an active hold's expiry out ("need more time?"). */
@@ -1356,6 +1392,8 @@ interface PickerCallbacks extends RendererCallbacks {
     onSelectionChange?: (seats: PickerSeat[]) => void;
     /** A hold opened (manual hold or best-available). */
     onHold?: (hold: HoldInfo) => void;
+    /** A prior active hold was restored from its opaque hold id. */
+    onHoldRestored?: (hold: HoldInfo) => void;
     /** The open hold expired server-side (the controller has already released it). */
     onHoldExpired?: () => void;
     /** A booking completed with this ref. */
@@ -1430,6 +1468,8 @@ declare class PickerController {
     private seatTiers;
     /** id → seat, for the section-summary breakdown (renderer members are ids). */
     private seatById;
+    /** id → buyer-facing spatial metadata used by every tooltip/confirm surface. */
+    private seatContext;
     private allIds;
     private ws;
     private reconnectTimer;
@@ -1470,6 +1510,8 @@ declare class PickerController {
         mode?: string;
     } | null>;
     getSelection(): PickerSeat[];
+    /** Enriched metadata for a seat confirmation card or tooltip. */
+    seatDetails(seatId: string): SeatHoverDetails | null;
     clearSelection(): void;
     deselect(ids: string[]): void;
     /**
@@ -1479,6 +1521,8 @@ declare class PickerController {
      * there's nothing to hold.
      */
     hold(labelsArg?: string[], ttlMs?: number): Promise<HoldInfo | null>;
+    /** Restore an active server hold without creating or extending inventory. */
+    resumeHold(holdId: string): Promise<HoldInfo | null>;
     /**
      * P4 "need more time?": extend the OPEN hold's server-side expiry and re-arm
      * the client expiry timer to match (via setHold), so the controller doesn't
@@ -1523,12 +1567,14 @@ declare class PickerController {
      */
     book(bookingRef: string, labelsArg?: string[]): Promise<string[] | null>;
     /** Release the whole open hold (if any), repaint those seats free. */
-    release(): Promise<void>;
+    release(): Promise<boolean>;
     /**
      * Release just some labels from the open hold, keeping the rest held (used when
      * a buyer removes one seat chip). Clears the hold entirely once it empties.
      */
-    releaseLabels(labels: string[]): Promise<void>;
+    releaseLabels(labels: string[]): Promise<boolean>;
+    /** New transports return the exact labels released; tolerate older adapters. */
+    private releaseConfirmed;
     setStatus(ids: string[], status: SeatStatus): void;
     getStatus(id: string): SeatStatus | undefined;
     flashSeat(id: string, color?: string): void;
@@ -1542,6 +1588,7 @@ declare class PickerController {
         x: number;
         y: number;
     };
+    setSelectionFocus(seatId: string | null): void;
     setAccessibilityFilter(types: string[] | null): void;
     /** Floors for the buyer's switcher (>1 ⇒ show it). Single-floor ⇒ one entry. */
     getFloors(): {

package/dist/index.d.ts

@@ -433,6 +433,19 @@ interface ISeatmapRenderer {
     }): void;
     /** Bulk status update; re-renders affected seats only. */
     setStatus(seatIds: string[], status: SeatStatus): void;
+    /**
+     * Mark the active buyer's own held seats. They remain server-status `held`,
+     * but render with the buyer selection treatment instead of the anonymous
+     * unavailable treatment used for another buyer's hold.
+     */
+    setOwnedHold?(seatIds: string[] | null): void;
+    /**
+     * Mark one selected seat as the buyer's pending confirmation candidate.
+     * The candidate receives a strong focus halo while unrelated seats recede;
+     * pass null after Select/Cancel. This is visual only and never mutates the
+     * renderer selection.
+     */
+    setSelectionFocus?(seatId: string | null): void;
     /**
      * SYNCHRONOUS repaint that bypasses requestAnimationFrame. Konva's batchDraw()
      * (used by setStatus and friends) schedules the actual paint on the next rAF
@@ -774,6 +787,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private circleById;
     /** Booth block geometry, keyed by booth id (= the unit's rowId). */
     private boothDims;
+    /** Booth label node so status changes can say HELD/SOLD on the full block. */
+    private boothLabelById;
     private statusById;
     private catColor;
     private theme;
@@ -784,7 +799,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Category order from the doc — the stable index into the CB palette. */
     private catOrder;
     private selection;
-    private selectionRings;
+    /** Whole-seat/block selection markers: outline + non-colour check cue. */
+    private selectionMarkers;
+    /** Held by this picker instance, not by another buyer. */
+    private ownedHold;
+    /** One selected seat being inspected before it is committed to the cart. */
+    private selectionFocusId;
     private hoverRing;
     /** Keyboard-navigation focus ring + the currently focused seat id. */
     private focusRing;
@@ -852,7 +872,9 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private pointers;
     private pinch;
     private panLast;
-    /** Cumulative gesture movement in px — clicks are suppressed after a real pan/pinch. */
+    private panStart;
+    private panStarted;
+    /** Maximum displacement from gesture start — suppress taps only after a real pan/pinch. */
     private moved;
     /**
      * Manage-mode rubber-band marquee (option-gated). `start`/`cur` are WORLD-space
@@ -881,6 +903,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     }[];
     getActiveFloorId(): string;
     setStatus(seatIds: string[], status: SeatStatus): void;
+    setOwnedHold(seatIds: string[] | null): void;
+    setSelectionFocus(seatId: string | null): void;
     getStatus(seatId: string): SeatStatus;
     getSelection(): ExpandedSeat[];
     clearSelection(): void;
@@ -1138,6 +1162,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     private resolveSelectionColor;
     private setSelected;
+    /** Rebuild one marker after selected/held/candidate state changes. */
+    private syncSelectionMarker;
     /**
      * The stage scale `focusRegion(id)` would settle at — i.e. the zoom that
      * frames this section in the current viewport. Used to decide whether
@@ -1200,6 +1226,7 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
         height: number;
     }, opts?: {
         animate?: boolean;
+        minScale?: number;
     }): void;
     /** Cancel an in-flight camera glide (a grab or a newer glide interrupts it). */
     private cancelGlide;
@@ -1255,6 +1282,10 @@ interface SeatHoverDetails extends PickerSeat {
     categoryColor: string;
     status: SeatStatus;
     currency: string;
+    /** Human-readable spatial context for hover and confirmation UI. */
+    sectionLabel?: string;
+    rowLabel?: string;
+    seatNumber?: string;
 }
 interface HoldConflict {
     label: string;
@@ -1302,6 +1333,9 @@ interface HoldResponse {
     expiresAt: number;
     items?: HoldServerItem[];
 }
+interface ResumeHoldResponse extends HoldResponse {
+    items: HoldServerItem[];
+}
 interface HoldServerItem {
     label: string;
     objectId: string;
@@ -1341,6 +1375,8 @@ interface PickerTransport {
     hold(key: string, selections: HoldSelectionRequest[], ttlMs?: number, replaceHoldId?: string): Promise<HoldResponse>;
     bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResponse>;
     release(key: string, labels: string[], holdId: string): Promise<unknown>;
+    /** Optional capability-style lookup used to restore an active browser hold. */
+    resume?(key: string, holdId: string): Promise<ResumeHoldResponse>;
     /** Optional — the SDK omits booking (it hands the holdId to the host page). */
     book?(key: string, labels: string[], holdId: string, bookingRef: string): Promise<unknown>;
     /** Optional (P4) — push an active hold's expiry out ("need more time?"). */
@@ -1356,6 +1392,8 @@ interface PickerCallbacks extends RendererCallbacks {
     onSelectionChange?: (seats: PickerSeat[]) => void;
     /** A hold opened (manual hold or best-available). */
     onHold?: (hold: HoldInfo) => void;
+    /** A prior active hold was restored from its opaque hold id. */
+    onHoldRestored?: (hold: HoldInfo) => void;
     /** The open hold expired server-side (the controller has already released it). */
     onHoldExpired?: () => void;
     /** A booking completed with this ref. */
@@ -1430,6 +1468,8 @@ declare class PickerController {
     private seatTiers;
     /** id → seat, for the section-summary breakdown (renderer members are ids). */
     private seatById;
+    /** id → buyer-facing spatial metadata used by every tooltip/confirm surface. */
+    private seatContext;
     private allIds;
     private ws;
     private reconnectTimer;
@@ -1470,6 +1510,8 @@ declare class PickerController {
         mode?: string;
     } | null>;
     getSelection(): PickerSeat[];
+    /** Enriched metadata for a seat confirmation card or tooltip. */
+    seatDetails(seatId: string): SeatHoverDetails | null;
     clearSelection(): void;
     deselect(ids: string[]): void;
     /**
@@ -1479,6 +1521,8 @@ declare class PickerController {
      * there's nothing to hold.
      */
     hold(labelsArg?: string[], ttlMs?: number): Promise<HoldInfo | null>;
+    /** Restore an active server hold without creating or extending inventory. */
+    resumeHold(holdId: string): Promise<HoldInfo | null>;
     /**
      * P4 "need more time?": extend the OPEN hold's server-side expiry and re-arm
      * the client expiry timer to match (via setHold), so the controller doesn't
@@ -1523,12 +1567,14 @@ declare class PickerController {
      */
     book(bookingRef: string, labelsArg?: string[]): Promise<string[] | null>;
     /** Release the whole open hold (if any), repaint those seats free. */
-    release(): Promise<void>;
+    release(): Promise<boolean>;
     /**
      * Release just some labels from the open hold, keeping the rest held (used when
      * a buyer removes one seat chip). Clears the hold entirely once it empties.
      */
-    releaseLabels(labels: string[]): Promise<void>;
+    releaseLabels(labels: string[]): Promise<boolean>;
+    /** New transports return the exact labels released; tolerate older adapters. */
+    private releaseConfirmed;
     setStatus(ids: string[], status: SeatStatus): void;
     getStatus(id: string): SeatStatus | undefined;
     flashSeat(id: string, color?: string): void;
@@ -1542,6 +1588,7 @@ declare class PickerController {
         x: number;
         y: number;
     };
+    setSelectionFocus(seatId: string | null): void;
     setAccessibilityFilter(types: string[] | null): void;
     /** Floors for the buyer's switcher (>1 ⇒ show it). Single-floor ⇒ one entry. */
     getFloors(): {