@seatlayer/core 0.26.0 → 0.28.0

package/dist/index.d.cts

@@ -406,6 +406,11 @@ interface GAAreaObject {
     holes?: Point[][];
     capacity: number;
     categoryKey: string;
+    /** Corner-rounding radius in chart units (default 0 = sharp corners). Pure
+     * presentation — softens the polygon's corners in every renderer without
+     * touching capacity, unit identities, or the stored points. Clamped per
+     * corner to half the shorter adjacent edge at draw time. */
+    cornerRadius?: number;
     /**
      * Durable inventory provenance for a surface produced by Join Areas.
      *
@@ -606,6 +611,16 @@ interface BoothObject {
     width: number;
     height: number;
     rotation: number;
+    /**
+     * Optional custom outline (closed polygon, absolute chart coordinates) for
+     * non-rectangular booths — L-shaped, corner, or island units on expo floors.
+     * Absent = the default axis-aligned rectangle described by `width`/`height`/
+     * `rotation`. A booth stays exactly ONE atomic sellable unit whatever its
+     * outline; `points` is purely geometric. `width`/`height` are retained as the
+     * last rectangular size so "Back to rectangle" can restore it. When `points`
+     * is present, renderers draw the polygon and ignore `rotation`.
+     */
+    points?: Point[];
     categoryKey: string;
     referenceInventorySource?: ReferenceInventorySource;
 }
@@ -747,6 +762,13 @@ interface TextObject {
     id: string;
     /** Persisted provenance for objects created from the venue-icon palette. */
     semanticKind?: 'icon';
+    /**
+     * Registry key for a vector wayfinding icon (see src/core/icons.ts). Present
+     * on modern icon placements; the object then renders as a single-color vector
+     * Path instead of `text`. Absent on legacy emoji icons, which keep rendering
+     * `text` through the shared glyph path — old charts are never rewritten.
+     */
+    iconKey?: string;
     text: string;
     position: Point;
     fontSize: number;
@@ -1860,6 +1882,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private accessGlyphById;
     /** Authored free-text nodes obey the same rendered-size visibility floor. */
     private freeTextById;
+    /** Vector venue-icon Path nodes + authored size; obey the free-text size floor. */
+    private iconNodeById;
     /** Stage/rink landmarks retain a readable screen-space caption at overview. */
     private primaryFocalLabels;
     /** GA paint and text share price/highlight filter state. */
@@ -1873,6 +1897,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private effSelection;
     /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
     private colorblind;
+    /** Stable per-category-KEY colorblind hue (OV-46) — order-independent. */
+    private cbHueByKey;
+    /** OV-45(a): authored row-letter labels for the buyer/preview map, resolved in
+     *  world space (matching seat labels) and honouring each row's labelPresentation
+     *  (position/rotation/visibility/style). Painted at the seats LOD rung. */
+    private rowLabelPlan;
     /** Category order from the doc — the stable index into the CB palette. */
     private catOrder;
     private selection;
@@ -2347,11 +2377,17 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     private renderSection;
     private refreshSectionHeat;
-    /** Recompute a section's neutral overview state and retained detail count. */
+    /** Recompute a section's availability shading + retained availability text. */
     private refreshSectionFill;
     /** True when a section/zone is currently in the `closed` event-state. */
     private isSectionClosed;
-    /** Clean overview shells never leak category, price, or live availability paint. */
+    /** Resolve the four-bucket overview availability state for a section (OV-69).
+     *  `closed` (operator) outranks live availability; the availability buckets
+     *  only apply to seated sections (GA-only shells have no seat capacity here). */
+    private sectionAvailabilityState;
+    /** Overview shells stay neutral except for the bounded availability shading
+     *  (nearly-gone / sold-out) and the operator `closed` slab — never category
+     *  or price paint, which is deferred to section focus/seat detail. */
     private sectionBlockFill;
     /**
      * Zone rung: one giant screen-constant label per zone (+ optional "FROM $n"),
@@ -2502,6 +2538,22 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      *  debounced cacheSeatLayer() and the synchronous forceDraw() catch-up. */
     private rebuildSeatCache;
     private cacheSeatLayer;
+    /**
+     * Drop the seat-layer overview bitmap while PRESERVING every descendant's
+     * cached local transform + clientRect.
+     *
+     * Konva's public `Layer.clearCache()` releases the bitmap and then runs a deep
+     * `_clearSelfAndDescendantCache()` that clears those caches on all 14k seat
+     * nodes. Recomputing them on the single frame the melt first reveals a section's
+     * live seats is the ~480ms first-drill stall (OV-80). A camera glide only marks
+     * each seat's ABSOLUTE_TRANSFORM dirty (recomputed lazily at ordinary pan cost)
+     * and never moves a seat's LOCAL transform, so the local caches stay valid —
+     * keeping them lets the first melt paint at pan cost, matching the ~17ms of
+     * every subsequent glide on the same section. Any edit that actually moves a
+     * seat invalidates its own transform cache through the attr setter, so only
+     * still-valid caches survive here.
+     */
+    private releaseSeatLayerBitmap;
     /**
      * SYNCHRONOUS repaint that bypasses requestAnimationFrame — see the
      * ISeatmapRenderer.forceDraw() contract. Chrome pauses rAF (and therefore
@@ -2515,6 +2567,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     forceDraw(): void;
     private updateFreeTextVisibility;
+    /** 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. */
+    private buildRowLabelPlan;
+    /** Row labels never carry status; the buyer just dims them under the same
+     *  category/price filters that dim their seats. */
+    private objectFilteredOut;
     private updateLabels;
     private handleResize;
     private startFpsLoop;
@@ -2626,6 +2687,7 @@ interface SectionCategory {
  */
 interface SectionSummary {
     id: string;
+    /** Buyer-facing section name (`displayLabel` when set, else the inventory label). */
     label: string;
     /** Zone label (from ChartDoc.zones); '' when the section has no zone. */
     zoneLabel: string;
@@ -2826,6 +2888,21 @@ declare class PickerController {
     private idsForLabels;
     /** Resolve a physical chair id (or table inventory label) to its table unit. */
     tableSelection(seatIdOrLabel: string): TableSelectionDetails | null;
+    /**
+     * Buyer-facing name + type word for a checkout line item, resolved from the
+     * SAME author overrides the tray/tooltip already render. `label` stays the
+     * booking identity; a host builds its own order summary from `displayLabel`/
+     * `displayType` so the buyer sees the designer's copy, not the internal label.
+     * Absent fields = no override (host falls back to `label`).
+     */
+    lineItemDisplay(item: {
+        label: string;
+        objectId: string;
+        objectType: 'seat' | 'booth' | 'ga' | 'table';
+    }): {
+        displayLabel?: string;
+        displayType?: string;
+    };
     /** Fetch chart, build label maps, mount the renderer, seed statuses, go live. */
     render(host: HTMLDivElement): Promise<{
         doc: ChartDoc;

package/dist/index.d.ts

@@ -406,6 +406,11 @@ interface GAAreaObject {
     holes?: Point[][];
     capacity: number;
     categoryKey: string;
+    /** Corner-rounding radius in chart units (default 0 = sharp corners). Pure
+     * presentation — softens the polygon's corners in every renderer without
+     * touching capacity, unit identities, or the stored points. Clamped per
+     * corner to half the shorter adjacent edge at draw time. */
+    cornerRadius?: number;
     /**
      * Durable inventory provenance for a surface produced by Join Areas.
      *
@@ -606,6 +611,16 @@ interface BoothObject {
     width: number;
     height: number;
     rotation: number;
+    /**
+     * Optional custom outline (closed polygon, absolute chart coordinates) for
+     * non-rectangular booths — L-shaped, corner, or island units on expo floors.
+     * Absent = the default axis-aligned rectangle described by `width`/`height`/
+     * `rotation`. A booth stays exactly ONE atomic sellable unit whatever its
+     * outline; `points` is purely geometric. `width`/`height` are retained as the
+     * last rectangular size so "Back to rectangle" can restore it. When `points`
+     * is present, renderers draw the polygon and ignore `rotation`.
+     */
+    points?: Point[];
     categoryKey: string;
     referenceInventorySource?: ReferenceInventorySource;
 }
@@ -747,6 +762,13 @@ interface TextObject {
     id: string;
     /** Persisted provenance for objects created from the venue-icon palette. */
     semanticKind?: 'icon';
+    /**
+     * Registry key for a vector wayfinding icon (see src/core/icons.ts). Present
+     * on modern icon placements; the object then renders as a single-color vector
+     * Path instead of `text`. Absent on legacy emoji icons, which keep rendering
+     * `text` through the shared glyph path — old charts are never rewritten.
+     */
+    iconKey?: string;
     text: string;
     position: Point;
     fontSize: number;
@@ -1860,6 +1882,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private accessGlyphById;
     /** Authored free-text nodes obey the same rendered-size visibility floor. */
     private freeTextById;
+    /** Vector venue-icon Path nodes + authored size; obey the free-text size floor. */
+    private iconNodeById;
     /** Stage/rink landmarks retain a readable screen-space caption at overview. */
     private primaryFocalLabels;
     /** GA paint and text share price/highlight filter state. */
@@ -1873,6 +1897,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private effSelection;
     /** Colorblind-safe mode (Okabe-Ito hues + hollow booked seats). */
     private colorblind;
+    /** Stable per-category-KEY colorblind hue (OV-46) — order-independent. */
+    private cbHueByKey;
+    /** OV-45(a): authored row-letter labels for the buyer/preview map, resolved in
+     *  world space (matching seat labels) and honouring each row's labelPresentation
+     *  (position/rotation/visibility/style). Painted at the seats LOD rung. */
+    private rowLabelPlan;
     /** Category order from the doc — the stable index into the CB palette. */
     private catOrder;
     private selection;
@@ -2347,11 +2377,17 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     private renderSection;
     private refreshSectionHeat;
-    /** Recompute a section's neutral overview state and retained detail count. */
+    /** Recompute a section's availability shading + retained availability text. */
     private refreshSectionFill;
     /** True when a section/zone is currently in the `closed` event-state. */
     private isSectionClosed;
-    /** Clean overview shells never leak category, price, or live availability paint. */
+    /** Resolve the four-bucket overview availability state for a section (OV-69).
+     *  `closed` (operator) outranks live availability; the availability buckets
+     *  only apply to seated sections (GA-only shells have no seat capacity here). */
+    private sectionAvailabilityState;
+    /** Overview shells stay neutral except for the bounded availability shading
+     *  (nearly-gone / sold-out) and the operator `closed` slab — never category
+     *  or price paint, which is deferred to section focus/seat detail. */
     private sectionBlockFill;
     /**
      * Zone rung: one giant screen-constant label per zone (+ optional "FROM $n"),
@@ -2502,6 +2538,22 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      *  debounced cacheSeatLayer() and the synchronous forceDraw() catch-up. */
     private rebuildSeatCache;
     private cacheSeatLayer;
+    /**
+     * Drop the seat-layer overview bitmap while PRESERVING every descendant's
+     * cached local transform + clientRect.
+     *
+     * Konva's public `Layer.clearCache()` releases the bitmap and then runs a deep
+     * `_clearSelfAndDescendantCache()` that clears those caches on all 14k seat
+     * nodes. Recomputing them on the single frame the melt first reveals a section's
+     * live seats is the ~480ms first-drill stall (OV-80). A camera glide only marks
+     * each seat's ABSOLUTE_TRANSFORM dirty (recomputed lazily at ordinary pan cost)
+     * and never moves a seat's LOCAL transform, so the local caches stay valid —
+     * keeping them lets the first melt paint at pan cost, matching the ~17ms of
+     * every subsequent glide on the same section. Any edit that actually moves a
+     * seat invalidates its own transform cache through the attr setter, so only
+     * still-valid caches survive here.
+     */
+    private releaseSeatLayerBitmap;
     /**
      * SYNCHRONOUS repaint that bypasses requestAnimationFrame — see the
      * ISeatmapRenderer.forceDraw() contract. Chrome pauses rAF (and therefore
@@ -2515,6 +2567,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      */
     forceDraw(): void;
     private updateFreeTextVisibility;
+    /** 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. */
+    private buildRowLabelPlan;
+    /** Row labels never carry status; the buyer just dims them under the same
+     *  category/price filters that dim their seats. */
+    private objectFilteredOut;
     private updateLabels;
     private handleResize;
     private startFpsLoop;
@@ -2626,6 +2687,7 @@ interface SectionCategory {
  */
 interface SectionSummary {
     id: string;
+    /** Buyer-facing section name (`displayLabel` when set, else the inventory label). */
     label: string;
     /** Zone label (from ChartDoc.zones); '' when the section has no zone. */
     zoneLabel: string;
@@ -2826,6 +2888,21 @@ declare class PickerController {
     private idsForLabels;
     /** Resolve a physical chair id (or table inventory label) to its table unit. */
     tableSelection(seatIdOrLabel: string): TableSelectionDetails | null;
+    /**
+     * Buyer-facing name + type word for a checkout line item, resolved from the
+     * SAME author overrides the tray/tooltip already render. `label` stays the
+     * booking identity; a host builds its own order summary from `displayLabel`/
+     * `displayType` so the buyer sees the designer's copy, not the internal label.
+     * Absent fields = no override (host falls back to `label`).
+     */
+    lineItemDisplay(item: {
+        label: string;
+        objectId: string;
+        objectType: 'seat' | 'booth' | 'ga' | 'table';
+    }): {
+        displayLabel?: string;
+        displayType?: string;
+    };
     /** Fetch chart, build label maps, mount the renderer, seed statuses, go live. */
     render(host: HTMLDivElement): Promise<{
         doc: ChartDoc;