@seatlayer/core 0.52.0 → 0.53.0

package/dist/index.d.cts

@@ -635,35 +635,18 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private resizeObs;
     /** Coalesces bursty view-change sources (pointermove, wheel) into ≤1 callback/frame. */
     private viewChangeRaf;
-    private pointers;
-    private pinch;
-    private panLast;
-    private panStart;
-    private panStarted;
-    /** Maximum displacement from gesture start — suppress taps only after a real pan/pinch. */
-    private moved;
-    /**
-     * Ghost-click guard. Konva binds `_pointerup` to mouseup, touchend AND
-     * pointerup, so `on('click tap')` is two handlers for one finger tap unless
-     * the browser's synthesized compatibility click is suppressed. Konva only
-     * suppresses it when the touch lands on a LISTENING SHAPE (Stage.js returns
-     * early before its preventDefault() when `!shape || !shape.isListening()`),
-     * so a near-miss rescued by nearestSeatToScreen used to fire `tap` (select)
-     * then `click` (deselect) 1-3ms apart and net to nothing. With
-     * SEAT_TAP_SLOP_PX=14 against a ~12px seat radius, that broken annulus is
-     * ~3.7x the area of the seat itself — i.e. most successful mobile taps.
-     * `touch-action: none` does NOT suppress compatibility mouse events.
-     */
-    private lastTapAt;
-    /**
-     * True when this is the browser's synthesized compatibility click following a
-     * finger tap we already handled. Discriminates on `e.type` deliberately —
-     * `PointerEvent extends MouseEvent`, so an `instanceof MouseEvent` test
-     * matches genuine pointer taps too. One shared timestamp across the layer and
-     * stage handlers: a tap consumed at the layer must also suppress the ghost at
-     * the stage, and only `click` is ever rejected, so bubbling stays intact.
+    /**
+     * Pan/pinch state machine (`render/interaction/pointer`). Raw pointer events
+     * on the container, not Konva stage dragging — its touch pipeline proved
+     * unreliable for multi-touch on real devices. Also owns the ghost-click
+     * timestamp shared by the layer and stage tap handlers.
      */
+    private gestures;
+    /** Displacement of the current gesture — a tap must stay under the slop. */
+    private get moved();
     private isGhostClick;
+    /** Behavioural surface the gesture machine calls back into. */
+    private get pointerHost();
     /**
      * Manage-mode rubber-band marquee (option-gated). `start`/`cur` are WORLD-space
      * points (overlayLayer rides the stage transform); `rect` is the on-canvas
@@ -806,6 +789,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setViewMode(mode: RendererViewMode): void;
     /** Current projection — reflects the tween target, not the mid-tween isoT. */
     getViewMode(): RendererViewMode;
+    /** Live ISO projection state handed to the `render/projection` free functions. */
+    private get isoState();
     /** Iso angle (rad) + y-squash for the current isoT. */
     private isoParams;
     /** Effective vertical scale = stage scale × iso squash — legibility math uses this. */
@@ -839,6 +824,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private resetLayerTransforms;
     /** Restore section-owned containers before applying another projection. */
     private resetSectionProjection;
+    /** Node/cache context the shared seat-anchor pass reads and updates. */
+    private get seatAnchorContext();
     /** Move native seat/booth hit shapes to or from their exact pinhole anchors. */
     private applyExactSeatAnchors;
     /**
@@ -1020,12 +1007,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * single drawImage per frame, and it rides the same layer cache — effectively
      * zero per-frame cost. Never listens, so it can't intercept a seat click.
      */
+    /** Node/registry surface the `render/objectDrawing` factories draw into. */
+    private get objectDrawContext();
     private renderDecorImage;
     private renderTable;
     private renderText;
     private renderShape;
-    /** Prominent stage caption: uppercase, letter-spaced, larger, softly dimmed. */
-    private addStageLabel;
     private renderGA;
     /**
      * A section renders in three coordinated layers driven by the LOD melt:
@@ -1106,7 +1093,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     }): string | null;
     /** Seat ids belonging to a section (Slice 5 section-summary card). */
     sectionMembers(id: string): string[];
-    private addCentredLabel;
     private isSelectable;
     private toggleSeat;
     /**
@@ -1159,10 +1145,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * so within-floor elevation offsets don't affect the result. Null if none.
      */
     private deckFloorAt;
-    private toLocal;
-    private onPointerDown;
-    private onPointerMove;
-    private onPointerEnd;
     /**
      * Min is chart-relative (never lose the room); max is absolute so seats
      * reach a readable size on any chart, however large the venue.
@@ -1193,6 +1175,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private cancelGlide;
     /** Current LOD rung derived from effective zoom — drives the ZONES/SECTIONS/SEATS pill. */
     getRung(): LodRung;
+    /** Explicit view of this renderer as the evidence pass's declared surface. */
+    private get renderedQualityContext();
     getRenderedQualityEvidence(): RendererQualityEvidence;
     /** Jump the camera to a rung's zoom band (glided). */
     setRung(rung: LodRung): void;
@@ -1260,20 +1244,11 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Geometric association only: importer data remains unchanged. */
     private nodeBelongsToFocusedSection;
     /** OV-45(a): resolve authored row-letter labels for the buyer/preview map, in
-     *  world space, matching the Designer's placement contract (start/end/both/none
-     *  preset, a free-drag `position` that wins over the preset, rotation, and
-     *  labelStyle colour/size fed through the same auto-contrast guard). Segmented
-     *  rows keep their own logical-label handling and are resolved by their owner. */
+     *  world space (see `render/rowLabelPlan`). */
     private buildRowLabelPlan;
     /** Axis-aligned world bounds of a centred, potentially rotated row label. */
     private rowLabelBox;
-    /**
-     * Keep an automatic start/end label out of seat markers and already-painted
-     * text. The authored point is never altered. Candidates are deliberately
-     * bounded and deterministic: the closest clear offset wins; if a chart is so
-     * dense that none is clear, the least-colliding candidate wins so the required
-     * row label remains present rather than being silently dropped.
-     */
+    /** Keep an automatic start/end label out of seats and already-painted text. */
     private resolveAutomaticRowLabelPosition;
     /** Row labels never carry status; the buyer just dims them under the same
      *  category/price filters that dim their seats. */
@@ -2120,11 +2095,8 @@ declare class PickerController {
     private connect;
     /**
      * Backoff for the PLAIN-socket fallback (a transport with no v1 client of its
-     * own). Full jitter, for the same reason BuyerRealtimeClient uses it: a
-     * deterministic `2**attempt` schedule brings every browser that lost the same
-     * socket back in the same millisecond, and an on-sale crowd reconnecting in
-     * lockstep turns one blip into a thundering herd. The ceiling still doubles,
-     * so a sustained outage still backs off.
+     * own). Full jitter, for the same reason BuyerRealtimeClient uses it — see
+     * `core/backoff`, which now owns that rationale and the schedule.
      */
     private scheduleReconnect;
 }
@@ -2212,6 +2184,14 @@ declare function setStringOverrides(next: Dict): void;
 declare function t(key: string, vars?: Record<string, string | number>): string;
 /** "1 seat" / "3 seats" without hand-rolled concatenation. */
 declare function tCount(key: string, count: number, vars?: Record<string, string | number>): string;
+/**
+ * Kept for the SDK surface that imports dates from here. It is a thin pass to
+ * `core/datetime`, which owns every date shape in the app and caches its
+ * formatters per (locale, shape) — the defaults below are the same ones it
+ * uses, so the two were already interchangeable and are now literally the same
+ * code. `active` is passed explicitly so this cannot drift from `t()` even if
+ * something calls `setDateTimeLocale` on its own.
+ */
 declare function formatDate(value: number | Date, opts?: Intl.DateTimeFormatOptions): string;
 
 /**
@@ -2255,9 +2235,14 @@ declare function setMoneyLocale(locale: string | undefined): void;
 /**
  * "€45" / "$1,500" / "45 €" (locale-dependent placement).
  * Whole amounts render without ".00" (design shows "$45", "$120"); pass
- * `fractionDigits` for fixed precision (e.g. 3 for "$0.045 / credit").
+ * `fractionDigits` for fixed precision (e.g. 3 for "$0.045 / credit", or `0`
+ * for a report column that rounds to whole units).
+ *
+ * `locale` overrides the app locale for one call — the buyer-facing website
+ * templates render in the VISITOR's language, which is not necessarily the
+ * dashboard's. Mirrors `DateFormatOptions.locale` in `core/datetime`.
  */
-declare function formatMoney(amount: number, currency?: string, fractionDigits?: number): string;
+declare function formatMoney(amount: number, currency?: string, fractionDigits?: number, locale?: string): string;
 /**
  * How many decimal places a currency has — 2 for USD/EUR, 0 for JPY/KRW/VND,
  * 3 for KWD/BHD/JOD.
@@ -2281,7 +2266,7 @@ declare function currencyExponent(currency?: string): number;
  */
 declare function fromMinorUnits(minor: number, currency?: string): number;
 /** "$90" / "¥9,000" — a minor-unit integer rendered for display. */
-declare function formatMinor(minor: number, currency?: string): string;
+declare function formatMinor(minor: number, currency?: string, locale?: string): string;
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 

package/dist/index.d.ts

@@ -635,35 +635,18 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private resizeObs;
     /** Coalesces bursty view-change sources (pointermove, wheel) into ≤1 callback/frame. */
     private viewChangeRaf;
-    private pointers;
-    private pinch;
-    private panLast;
-    private panStart;
-    private panStarted;
-    /** Maximum displacement from gesture start — suppress taps only after a real pan/pinch. */
-    private moved;
-    /**
-     * Ghost-click guard. Konva binds `_pointerup` to mouseup, touchend AND
-     * pointerup, so `on('click tap')` is two handlers for one finger tap unless
-     * the browser's synthesized compatibility click is suppressed. Konva only
-     * suppresses it when the touch lands on a LISTENING SHAPE (Stage.js returns
-     * early before its preventDefault() when `!shape || !shape.isListening()`),
-     * so a near-miss rescued by nearestSeatToScreen used to fire `tap` (select)
-     * then `click` (deselect) 1-3ms apart and net to nothing. With
-     * SEAT_TAP_SLOP_PX=14 against a ~12px seat radius, that broken annulus is
-     * ~3.7x the area of the seat itself — i.e. most successful mobile taps.
-     * `touch-action: none` does NOT suppress compatibility mouse events.
-     */
-    private lastTapAt;
-    /**
-     * True when this is the browser's synthesized compatibility click following a
-     * finger tap we already handled. Discriminates on `e.type` deliberately —
-     * `PointerEvent extends MouseEvent`, so an `instanceof MouseEvent` test
-     * matches genuine pointer taps too. One shared timestamp across the layer and
-     * stage handlers: a tap consumed at the layer must also suppress the ghost at
-     * the stage, and only `click` is ever rejected, so bubbling stays intact.
+    /**
+     * Pan/pinch state machine (`render/interaction/pointer`). Raw pointer events
+     * on the container, not Konva stage dragging — its touch pipeline proved
+     * unreliable for multi-touch on real devices. Also owns the ghost-click
+     * timestamp shared by the layer and stage tap handlers.
      */
+    private gestures;
+    /** Displacement of the current gesture — a tap must stay under the slop. */
+    private get moved();
     private isGhostClick;
+    /** Behavioural surface the gesture machine calls back into. */
+    private get pointerHost();
     /**
      * Manage-mode rubber-band marquee (option-gated). `start`/`cur` are WORLD-space
      * points (overlayLayer rides the stage transform); `rect` is the on-canvas
@@ -806,6 +789,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setViewMode(mode: RendererViewMode): void;
     /** Current projection — reflects the tween target, not the mid-tween isoT. */
     getViewMode(): RendererViewMode;
+    /** Live ISO projection state handed to the `render/projection` free functions. */
+    private get isoState();
     /** Iso angle (rad) + y-squash for the current isoT. */
     private isoParams;
     /** Effective vertical scale = stage scale × iso squash — legibility math uses this. */
@@ -839,6 +824,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private resetLayerTransforms;
     /** Restore section-owned containers before applying another projection. */
     private resetSectionProjection;
+    /** Node/cache context the shared seat-anchor pass reads and updates. */
+    private get seatAnchorContext();
     /** Move native seat/booth hit shapes to or from their exact pinhole anchors. */
     private applyExactSeatAnchors;
     /**
@@ -1020,12 +1007,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * single drawImage per frame, and it rides the same layer cache — effectively
      * zero per-frame cost. Never listens, so it can't intercept a seat click.
      */
+    /** Node/registry surface the `render/objectDrawing` factories draw into. */
+    private get objectDrawContext();
     private renderDecorImage;
     private renderTable;
     private renderText;
     private renderShape;
-    /** Prominent stage caption: uppercase, letter-spaced, larger, softly dimmed. */
-    private addStageLabel;
     private renderGA;
     /**
      * A section renders in three coordinated layers driven by the LOD melt:
@@ -1106,7 +1093,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     }): string | null;
     /** Seat ids belonging to a section (Slice 5 section-summary card). */
     sectionMembers(id: string): string[];
-    private addCentredLabel;
     private isSelectable;
     private toggleSeat;
     /**
@@ -1159,10 +1145,6 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * so within-floor elevation offsets don't affect the result. Null if none.
      */
     private deckFloorAt;
-    private toLocal;
-    private onPointerDown;
-    private onPointerMove;
-    private onPointerEnd;
     /**
      * Min is chart-relative (never lose the room); max is absolute so seats
      * reach a readable size on any chart, however large the venue.
@@ -1193,6 +1175,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private cancelGlide;
     /** Current LOD rung derived from effective zoom — drives the ZONES/SECTIONS/SEATS pill. */
     getRung(): LodRung;
+    /** Explicit view of this renderer as the evidence pass's declared surface. */
+    private get renderedQualityContext();
     getRenderedQualityEvidence(): RendererQualityEvidence;
     /** Jump the camera to a rung's zoom band (glided). */
     setRung(rung: LodRung): void;
@@ -1260,20 +1244,11 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Geometric association only: importer data remains unchanged. */
     private nodeBelongsToFocusedSection;
     /** OV-45(a): resolve authored row-letter labels for the buyer/preview map, in
-     *  world space, matching the Designer's placement contract (start/end/both/none
-     *  preset, a free-drag `position` that wins over the preset, rotation, and
-     *  labelStyle colour/size fed through the same auto-contrast guard). Segmented
-     *  rows keep their own logical-label handling and are resolved by their owner. */
+     *  world space (see `render/rowLabelPlan`). */
     private buildRowLabelPlan;
     /** Axis-aligned world bounds of a centred, potentially rotated row label. */
     private rowLabelBox;
-    /**
-     * Keep an automatic start/end label out of seat markers and already-painted
-     * text. The authored point is never altered. Candidates are deliberately
-     * bounded and deterministic: the closest clear offset wins; if a chart is so
-     * dense that none is clear, the least-colliding candidate wins so the required
-     * row label remains present rather than being silently dropped.
-     */
+    /** Keep an automatic start/end label out of seats and already-painted text. */
     private resolveAutomaticRowLabelPosition;
     /** Row labels never carry status; the buyer just dims them under the same
      *  category/price filters that dim their seats. */
@@ -2120,11 +2095,8 @@ declare class PickerController {
     private connect;
     /**
      * Backoff for the PLAIN-socket fallback (a transport with no v1 client of its
-     * own). Full jitter, for the same reason BuyerRealtimeClient uses it: a
-     * deterministic `2**attempt` schedule brings every browser that lost the same
-     * socket back in the same millisecond, and an on-sale crowd reconnecting in
-     * lockstep turns one blip into a thundering herd. The ceiling still doubles,
-     * so a sustained outage still backs off.
+     * own). Full jitter, for the same reason BuyerRealtimeClient uses it — see
+     * `core/backoff`, which now owns that rationale and the schedule.
      */
     private scheduleReconnect;
 }
@@ -2212,6 +2184,14 @@ declare function setStringOverrides(next: Dict): void;
 declare function t(key: string, vars?: Record<string, string | number>): string;
 /** "1 seat" / "3 seats" without hand-rolled concatenation. */
 declare function tCount(key: string, count: number, vars?: Record<string, string | number>): string;
+/**
+ * Kept for the SDK surface that imports dates from here. It is a thin pass to
+ * `core/datetime`, which owns every date shape in the app and caches its
+ * formatters per (locale, shape) — the defaults below are the same ones it
+ * uses, so the two were already interchangeable and are now literally the same
+ * code. `active` is passed explicitly so this cannot drift from `t()` even if
+ * something calls `setDateTimeLocale` on its own.
+ */
 declare function formatDate(value: number | Date, opts?: Intl.DateTimeFormatOptions): string;
 
 /**
@@ -2255,9 +2235,14 @@ declare function setMoneyLocale(locale: string | undefined): void;
 /**
  * "€45" / "$1,500" / "45 €" (locale-dependent placement).
  * Whole amounts render without ".00" (design shows "$45", "$120"); pass
- * `fractionDigits` for fixed precision (e.g. 3 for "$0.045 / credit").
+ * `fractionDigits` for fixed precision (e.g. 3 for "$0.045 / credit", or `0`
+ * for a report column that rounds to whole units).
+ *
+ * `locale` overrides the app locale for one call — the buyer-facing website
+ * templates render in the VISITOR's language, which is not necessarily the
+ * dashboard's. Mirrors `DateFormatOptions.locale` in `core/datetime`.
  */
-declare function formatMoney(amount: number, currency?: string, fractionDigits?: number): string;
+declare function formatMoney(amount: number, currency?: string, fractionDigits?: number, locale?: string): string;
 /**
  * How many decimal places a currency has — 2 for USD/EUR, 0 for JPY/KRW/VND,
  * 3 for KWD/BHD/JOD.
@@ -2281,7 +2266,7 @@ declare function currencyExponent(currency?: string): number;
  */
 declare function fromMinorUnits(minor: number, currency?: string): number;
 /** "$90" / "¥9,000" — a minor-unit integer rendered for display. */
-declare function formatMinor(minor: number, currency?: string): string;
+declare function formatMinor(minor: number, currency?: string, locale?: string): string;
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;