@seatlayer/core 0.26.0 → 0.27.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"),
@@ -2515,6 +2551,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 +2671,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;

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"),
@@ -2515,6 +2551,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 +2671,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;