@seatlayer/core 0.17.0 → 0.18.1

package/dist/index.d.cts

@@ -109,6 +109,14 @@ interface AccessibilityMeta {
 declare const ACCESSIBILITY_TYPES: AccessibilityMeta[];
 /** Metadata for one accessibility key (undefined for unknown keys). */
 declare function accessibilityMeta(key: AccessibilityType): AccessibilityMeta | undefined;
+/**
+ * Outer-ring colour per accommodation. Shared by the buyer picker and the
+ * designer canvas so an accessible seat reads with the same hue in both — the
+ * seat's first-listed type wins. `wheelchair` blue is the default fallback.
+ */
+declare const ACCESSIBILITY_RING_COLOR: Record<AccessibilityType, string>;
+/** Ring colour for a seat's accessibility set (first-listed type wins). */
+declare function accessibilityRingColor(types: AccessibilityType[] | undefined): string;
 interface SeatOverride {
     /** 0-based seat index within the row. */
     index: number;
@@ -119,25 +127,70 @@ interface SeatOverride {
     dy?: number;
     /** Replace the computed label entirely. */
     label?: string;
+    /** Buyer-facing copy only. Booking/API identity remains row id + slot index
+     * internally and the legacy `label` externally for backwards compatibility. */
+    displayLabel?: string;
     categoryKey?: string;
     /** @deprecated legacy flag — read as `['wheelchair']`; write `accessibility`. */
     accessible?: boolean;
     /** Accessibility accommodations of this seat (empty/absent = none). */
     accessibility?: AccessibilityType[];
+    /** Commercial selling/view attributes are deliberately not accessibility. */
+    commercial?: SeatCommercialAttributes;
+    /** Seat-specific view photo; falls back to the row photo. */
+    viewFromSeatUrl?: string;
+    /** Per-seat label size/color override; falls back to the row/theme default.
+     *  Size is clamped to LABEL_STYLE_MIN_SIZE..MAX_SIZE; color is passed through
+     *  the shared auto-contrast rule at paint time (see {@link LabelStyle}). */
+    labelStyle?: LabelStyle;
+}
+interface SeatCommercialAttributes {
+    restrictedView?: boolean;
+    obstructedView?: boolean;
+    premium?: boolean;
+    note?: string;
+}
+/**
+ * Per-object label ink + size overrides layered on top of the chart-wide Theme
+ * defaults (rowLabelColor / textColor for rows, the section-name ink for
+ * sections). Both fields are optional: an absent field means "inherit the theme
+ * default". `color` is a preferred hex — renderers still pass it through the
+ * shared auto-contrast rule (`stateAwareBookableLabelInk`), so a choice that
+ * would be illegible over the seat/section background is switched to black or
+ * white at paint time. `size` is a font size in chart units, clamped to
+ * LABEL_STYLE_MIN_SIZE..LABEL_STYLE_MAX_SIZE by the shared ops.
+ */
+interface LabelStyle {
+    size?: number;
+    color?: string;
+}
+/** Clamp bounds for a per-object label `size`, shared by ops, MCP, and UI. */
+declare const LABEL_STYLE_MIN_SIZE = 8;
+declare const LABEL_STYLE_MAX_SIZE = 24;
+interface LabelPresentation {
+    visible?: boolean;
+    /** Exact Designer-owned label anchor; public semantic MCP schemas omit it. */
+    position?: Point;
+    rotation?: number;
+    style?: 'plain' | 'pill';
+    /** Per-object size/color override for this row's or section's label. */
+    labelStyle?: LabelStyle;
 }
 /** Brand/venue theming — applied by the renderer in both designer and picker. */
 interface ChartTheme {
     /** Canvas background color (default dark: #0e1117-ish radial). */
     background?: string;
-    /** Seat label text color (default dark ink #0b1220). */
+    /** Preferred text color for the numbers inside seat markers. */
     seatLabelColor?: string;
+    /** Preferred color for row identifiers such as A, B, C. Falls back to textColor. */
+    rowLabelColor?: string;
     /** Selection ring / accent color (default white ring + brand accent). */
     selectionColor?: string;
     /** Décor (stage/shape) default fill. */
     decorFill?: string;
     /** Free-text color default. */
     textColor?: string;
-    /** Font family (CSS stack) for all rendered text — seat labels, sections, décor text. */
+    /** Font family (CSS stack) for all rendered text — row labels, seat numbers, sections, décor text. */
     fontFamily?: string;
     /** Seat size multiplier on the base radius (0.7–1.6, default 1) — bigger seats fit longer labels. */
     seatScale?: number;
@@ -157,6 +210,9 @@ interface RowObject {
     id: string;
     /** Row label, e.g. "A". Seat labels are `${label}-${n}`. */
     label: string;
+    /** Buyer-facing row name. `label` remains the legacy inventory prefix. */
+    displayLabel?: string;
+    labelPresentation?: LabelPresentation;
     /** Position of the FIRST seat. */
     origin: Point;
     /** Degrees, clockwise. 0 = seats laid out along +x. */
@@ -178,6 +234,35 @@ interface RowObject {
      * inventory. It enables revision-safe replacement without touching manually
      * authored rows or accepting client coordinates. */
     referenceInventorySource?: ReferenceInventorySource;
+    /** Semantic parameters for a row produced by the shared Arc/Fan operation.
+     * Designer can reopen these parameters while every segment in the group
+     * still carries the same generation signature. Public MCP tools never accept
+     * the stored center/angles as arbitrary model-authored coordinates. */
+    arcFanGeneration?: {
+        kind: 'arc-fan-v1';
+        groupId: string;
+        center: Point;
+        innerRadius: number;
+        rowCount: number;
+        rowGap: number;
+        startAngle: number;
+        endAngle: number;
+        seatPitch: number;
+        fit: 'seat-pitch' | 'fixed-count';
+        seatsPerRow?: number;
+        facing: 'inward' | 'outward';
+        taperDegrees: number;
+        skewDegrees: number;
+        aisleGaps: {
+            left: number;
+            center: number;
+            right: number;
+        };
+        rowLabelStart: number;
+        seatLabelStart: number;
+        rowIndex: number;
+        segmentIndex: number;
+    };
     /** First seat number (default 1). */
     seatLabelStart?: number;
     /** Seat numbering within the row (default ltr, step 1). */
@@ -200,6 +285,8 @@ interface RowObject {
      * generates a synthetic panorama from chart geometry.
      */
     viewFromSeatUrl?: string;
+    /** Default commercial attributes inherited by seats without an override. */
+    commercial?: SeatCommercialAttributes;
 }
 interface GAAreaObject {
     type: 'gaArea';
@@ -340,6 +427,9 @@ interface SectionObject {
     type: 'section';
     id: string;
     label: string;
+    /** Buyer-facing section name; logical/id fields remain stable. */
+    displayLabel?: string;
+    labelPresentation?: LabelPresentation;
     /**
      * Stable management/inventory identity shared by disconnected visual
      * components of one logical section. When absent, `id` is the logical id.
@@ -347,6 +437,9 @@ interface SectionObject {
      * editing, measured diffs, and source restoration remain exact.
      */
     logicalSectionId?: string;
+    /** Shared semantic Arc/Fan group wrapped by this section. The section id is
+     * preserved when the fan parameters are reopened and regenerated. */
+    arcFanGroupId?: string;
     /** Closed polygon, chart units. */
     outline: Point[];
     /** Optional true line/arc/cubic boundary. `outline` is a deterministic sample
@@ -536,6 +629,8 @@ interface ExpandedSeat {
     id: string;
     /** Public label: `${rowLabel}-${seatNumber}` */
     label: string;
+    /** Buyer-facing copy; absent on legacy charts, where `label` is displayed. */
+    displayLabel?: string;
     x: number;
     y: number;
     rowId: string;
@@ -546,8 +641,11 @@ interface ExpandedSeat {
     accessible?: boolean;
     /** Specific accessibility accommodations (absent = none) — picker badges/filters these. */
     accessibility?: AccessibilityType[];
+    commercial?: SeatCommercialAttributes;
     /** Organizer-supplied view-from-seat image (inherited from the row). */
     viewUrl?: string;
+    /** Per-seat label size/color override; absent = inherit the row/theme default. */
+    labelStyle?: LabelStyle;
 }
 type SeatStatus = 'free' | 'held' | 'booked' | 'not_for_sale';
 interface RendererCallbacks {
@@ -964,10 +1062,14 @@ interface RowSeatSlot {
     x: number;
     y: number;
     label: string;
+    displayLabel: string;
     categoryKey: string;
     skipped: boolean;
     accessible: boolean;
     accessibility: AccessibilityType[];
+    commercial?: RowObject['commercial'];
+    viewUrl?: string;
+    labelStyle?: LabelStyle;
 }
 declare function expandRowSlots(row: RowObject): RowSeatSlot[];
 declare function expandRow(row: RowObject): ExpandedSeat[];
@@ -1394,9 +1496,16 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderBoothUnit;
     /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
     private seatBaseColor;
-    /** Authored free fills retain the chart's validated ink. Renderer-owned
-     * transient fills choose an ink against the paint that is actually visible. */
-    private renderedBookableLabelInk;
+    /** Per-seat authored label size relative to the neutral default (1 = default),
+     * mirroring the section convention (labelStyle.size ?? 18) / 18. Only real
+     * seats carry labelStyle, so booths and unstyled seats resolve to 1. */
+    private seatLabelScale;
+    /** Preferred label ink for a seat: the authored per-seat colour when set,
+     * otherwise today's theme default. Fed through auto-contrast by seatLabelInk. */
+    private seatPreferredLabelInk;
+    /** Resolve a seat's label ink against the paint actually visible, honouring an
+     * authored per-seat colour through the same auto-contrast rule as sections. */
+    private seatLabelInk;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
     /** True when a seat sits in a section/zone currently marked `closed`. */
@@ -2073,6 +2182,13 @@ declare class PickerController {
     private applySeatsMap;
     private clearBookedHoldIfSettled;
     private resnapshot;
+    /**
+     * Re-pull the status snapshot on demand. Live surfaces rarely need this (the
+     * socket keeps them fresh); local/mock transports with no socket call it
+     * after they mutate state (e.g. the demo books a hold) so the renderer and
+     * every onStatusChange consumer repaint from the new truth.
+     */
+    refresh(): Promise<void>;
     /**
      * Buyer catch-up on tab regain. While a tab is hidden Chrome pauses rAF, so
      * seat-status deltas that arrived over the WS mutated the scene graph but the
@@ -2183,4 +2299,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartReferenceImage, type ChartTheme, type CubicPath, DEFAULT_CURRENCY, type DecorImageObject, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type ReferenceAccessibilitySource, type ReferenceCalibration, type ReferenceCategorySource, type ReferenceDerivedScale, type ReferenceInventoryExclusionSource, type ReferenceInventorySource, type RenderedBookableLabelEvidence, type RenderedFreeTextEvidence, type RenderedGAAreaEvidence, type RenderedHierarchyLabelEvidence, type RenderedLabelHiddenReason, type RendererCallbacks, type RendererOptions, type RendererQualityEvidence, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionOutlinePath, type SectionPathSegment, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };
+export { ACCESSIBILITY_RING_COLOR, ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartReferenceImage, type ChartTheme, type CubicPath, DEFAULT_CURRENCY, type DecorImageObject, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, LABEL_STYLE_MAX_SIZE, LABEL_STYLE_MIN_SIZE, type LabelPresentation, type LabelStyle, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type ReferenceAccessibilitySource, type ReferenceCalibration, type ReferenceCategorySource, type ReferenceDerivedScale, type ReferenceInventoryExclusionSource, type ReferenceInventorySource, type RenderedBookableLabelEvidence, type RenderedFreeTextEvidence, type RenderedGAAreaEvidence, type RenderedHierarchyLabelEvidence, type RenderedLabelHiddenReason, type RendererCallbacks, type RendererOptions, type RendererQualityEvidence, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatCommercialAttributes, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionOutlinePath, type SectionPathSegment, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, accessibilityRingColor, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };

package/dist/index.d.ts

@@ -109,6 +109,14 @@ interface AccessibilityMeta {
 declare const ACCESSIBILITY_TYPES: AccessibilityMeta[];
 /** Metadata for one accessibility key (undefined for unknown keys). */
 declare function accessibilityMeta(key: AccessibilityType): AccessibilityMeta | undefined;
+/**
+ * Outer-ring colour per accommodation. Shared by the buyer picker and the
+ * designer canvas so an accessible seat reads with the same hue in both — the
+ * seat's first-listed type wins. `wheelchair` blue is the default fallback.
+ */
+declare const ACCESSIBILITY_RING_COLOR: Record<AccessibilityType, string>;
+/** Ring colour for a seat's accessibility set (first-listed type wins). */
+declare function accessibilityRingColor(types: AccessibilityType[] | undefined): string;
 interface SeatOverride {
     /** 0-based seat index within the row. */
     index: number;
@@ -119,25 +127,70 @@ interface SeatOverride {
     dy?: number;
     /** Replace the computed label entirely. */
     label?: string;
+    /** Buyer-facing copy only. Booking/API identity remains row id + slot index
+     * internally and the legacy `label` externally for backwards compatibility. */
+    displayLabel?: string;
     categoryKey?: string;
     /** @deprecated legacy flag — read as `['wheelchair']`; write `accessibility`. */
     accessible?: boolean;
     /** Accessibility accommodations of this seat (empty/absent = none). */
     accessibility?: AccessibilityType[];
+    /** Commercial selling/view attributes are deliberately not accessibility. */
+    commercial?: SeatCommercialAttributes;
+    /** Seat-specific view photo; falls back to the row photo. */
+    viewFromSeatUrl?: string;
+    /** Per-seat label size/color override; falls back to the row/theme default.
+     *  Size is clamped to LABEL_STYLE_MIN_SIZE..MAX_SIZE; color is passed through
+     *  the shared auto-contrast rule at paint time (see {@link LabelStyle}). */
+    labelStyle?: LabelStyle;
+}
+interface SeatCommercialAttributes {
+    restrictedView?: boolean;
+    obstructedView?: boolean;
+    premium?: boolean;
+    note?: string;
+}
+/**
+ * Per-object label ink + size overrides layered on top of the chart-wide Theme
+ * defaults (rowLabelColor / textColor for rows, the section-name ink for
+ * sections). Both fields are optional: an absent field means "inherit the theme
+ * default". `color` is a preferred hex — renderers still pass it through the
+ * shared auto-contrast rule (`stateAwareBookableLabelInk`), so a choice that
+ * would be illegible over the seat/section background is switched to black or
+ * white at paint time. `size` is a font size in chart units, clamped to
+ * LABEL_STYLE_MIN_SIZE..LABEL_STYLE_MAX_SIZE by the shared ops.
+ */
+interface LabelStyle {
+    size?: number;
+    color?: string;
+}
+/** Clamp bounds for a per-object label `size`, shared by ops, MCP, and UI. */
+declare const LABEL_STYLE_MIN_SIZE = 8;
+declare const LABEL_STYLE_MAX_SIZE = 24;
+interface LabelPresentation {
+    visible?: boolean;
+    /** Exact Designer-owned label anchor; public semantic MCP schemas omit it. */
+    position?: Point;
+    rotation?: number;
+    style?: 'plain' | 'pill';
+    /** Per-object size/color override for this row's or section's label. */
+    labelStyle?: LabelStyle;
 }
 /** Brand/venue theming — applied by the renderer in both designer and picker. */
 interface ChartTheme {
     /** Canvas background color (default dark: #0e1117-ish radial). */
     background?: string;
-    /** Seat label text color (default dark ink #0b1220). */
+    /** Preferred text color for the numbers inside seat markers. */
     seatLabelColor?: string;
+    /** Preferred color for row identifiers such as A, B, C. Falls back to textColor. */
+    rowLabelColor?: string;
     /** Selection ring / accent color (default white ring + brand accent). */
     selectionColor?: string;
     /** Décor (stage/shape) default fill. */
     decorFill?: string;
     /** Free-text color default. */
     textColor?: string;
-    /** Font family (CSS stack) for all rendered text — seat labels, sections, décor text. */
+    /** Font family (CSS stack) for all rendered text — row labels, seat numbers, sections, décor text. */
     fontFamily?: string;
     /** Seat size multiplier on the base radius (0.7–1.6, default 1) — bigger seats fit longer labels. */
     seatScale?: number;
@@ -157,6 +210,9 @@ interface RowObject {
     id: string;
     /** Row label, e.g. "A". Seat labels are `${label}-${n}`. */
     label: string;
+    /** Buyer-facing row name. `label` remains the legacy inventory prefix. */
+    displayLabel?: string;
+    labelPresentation?: LabelPresentation;
     /** Position of the FIRST seat. */
     origin: Point;
     /** Degrees, clockwise. 0 = seats laid out along +x. */
@@ -178,6 +234,35 @@ interface RowObject {
      * inventory. It enables revision-safe replacement without touching manually
      * authored rows or accepting client coordinates. */
     referenceInventorySource?: ReferenceInventorySource;
+    /** Semantic parameters for a row produced by the shared Arc/Fan operation.
+     * Designer can reopen these parameters while every segment in the group
+     * still carries the same generation signature. Public MCP tools never accept
+     * the stored center/angles as arbitrary model-authored coordinates. */
+    arcFanGeneration?: {
+        kind: 'arc-fan-v1';
+        groupId: string;
+        center: Point;
+        innerRadius: number;
+        rowCount: number;
+        rowGap: number;
+        startAngle: number;
+        endAngle: number;
+        seatPitch: number;
+        fit: 'seat-pitch' | 'fixed-count';
+        seatsPerRow?: number;
+        facing: 'inward' | 'outward';
+        taperDegrees: number;
+        skewDegrees: number;
+        aisleGaps: {
+            left: number;
+            center: number;
+            right: number;
+        };
+        rowLabelStart: number;
+        seatLabelStart: number;
+        rowIndex: number;
+        segmentIndex: number;
+    };
     /** First seat number (default 1). */
     seatLabelStart?: number;
     /** Seat numbering within the row (default ltr, step 1). */
@@ -200,6 +285,8 @@ interface RowObject {
      * generates a synthetic panorama from chart geometry.
      */
     viewFromSeatUrl?: string;
+    /** Default commercial attributes inherited by seats without an override. */
+    commercial?: SeatCommercialAttributes;
 }
 interface GAAreaObject {
     type: 'gaArea';
@@ -340,6 +427,9 @@ interface SectionObject {
     type: 'section';
     id: string;
     label: string;
+    /** Buyer-facing section name; logical/id fields remain stable. */
+    displayLabel?: string;
+    labelPresentation?: LabelPresentation;
     /**
      * Stable management/inventory identity shared by disconnected visual
      * components of one logical section. When absent, `id` is the logical id.
@@ -347,6 +437,9 @@ interface SectionObject {
      * editing, measured diffs, and source restoration remain exact.
      */
     logicalSectionId?: string;
+    /** Shared semantic Arc/Fan group wrapped by this section. The section id is
+     * preserved when the fan parameters are reopened and regenerated. */
+    arcFanGroupId?: string;
     /** Closed polygon, chart units. */
     outline: Point[];
     /** Optional true line/arc/cubic boundary. `outline` is a deterministic sample
@@ -536,6 +629,8 @@ interface ExpandedSeat {
     id: string;
     /** Public label: `${rowLabel}-${seatNumber}` */
     label: string;
+    /** Buyer-facing copy; absent on legacy charts, where `label` is displayed. */
+    displayLabel?: string;
     x: number;
     y: number;
     rowId: string;
@@ -546,8 +641,11 @@ interface ExpandedSeat {
     accessible?: boolean;
     /** Specific accessibility accommodations (absent = none) — picker badges/filters these. */
     accessibility?: AccessibilityType[];
+    commercial?: SeatCommercialAttributes;
     /** Organizer-supplied view-from-seat image (inherited from the row). */
     viewUrl?: string;
+    /** Per-seat label size/color override; absent = inherit the row/theme default. */
+    labelStyle?: LabelStyle;
 }
 type SeatStatus = 'free' | 'held' | 'booked' | 'not_for_sale';
 interface RendererCallbacks {
@@ -964,10 +1062,14 @@ interface RowSeatSlot {
     x: number;
     y: number;
     label: string;
+    displayLabel: string;
     categoryKey: string;
     skipped: boolean;
     accessible: boolean;
     accessibility: AccessibilityType[];
+    commercial?: RowObject['commercial'];
+    viewUrl?: string;
+    labelStyle?: LabelStyle;
 }
 declare function expandRowSlots(row: RowObject): RowSeatSlot[];
 declare function expandRow(row: RowObject): ExpandedSeat[];
@@ -1394,9 +1496,16 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderBoothUnit;
     /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
     private seatBaseColor;
-    /** Authored free fills retain the chart's validated ink. Renderer-owned
-     * transient fills choose an ink against the paint that is actually visible. */
-    private renderedBookableLabelInk;
+    /** Per-seat authored label size relative to the neutral default (1 = default),
+     * mirroring the section convention (labelStyle.size ?? 18) / 18. Only real
+     * seats carry labelStyle, so booths and unstyled seats resolve to 1. */
+    private seatLabelScale;
+    /** Preferred label ink for a seat: the authored per-seat colour when set,
+     * otherwise today's theme default. Fed through auto-contrast by seatLabelInk. */
+    private seatPreferredLabelInk;
+    /** Resolve a seat's label ink against the paint actually visible, honouring an
+     * authored per-seat colour through the same auto-contrast rule as sections. */
+    private seatLabelInk;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
     /** True when a seat sits in a section/zone currently marked `closed`. */
@@ -2073,6 +2182,13 @@ declare class PickerController {
     private applySeatsMap;
     private clearBookedHoldIfSettled;
     private resnapshot;
+    /**
+     * Re-pull the status snapshot on demand. Live surfaces rarely need this (the
+     * socket keeps them fresh); local/mock transports with no socket call it
+     * after they mutate state (e.g. the demo books a hold) so the renderer and
+     * every onStatusChange consumer repaint from the new truth.
+     */
+    refresh(): Promise<void>;
     /**
      * Buyer catch-up on tab regain. While a tab is hidden Chrome pauses rAF, so
      * seat-status deltas that arrived over the WS mutated the scene graph but the
@@ -2183,4 +2299,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartReferenceImage, type ChartTheme, type CubicPath, DEFAULT_CURRENCY, type DecorImageObject, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type ReferenceAccessibilitySource, type ReferenceCalibration, type ReferenceCategorySource, type ReferenceDerivedScale, type ReferenceInventoryExclusionSource, type ReferenceInventorySource, type RenderedBookableLabelEvidence, type RenderedFreeTextEvidence, type RenderedGAAreaEvidence, type RenderedHierarchyLabelEvidence, type RenderedLabelHiddenReason, type RendererCallbacks, type RendererOptions, type RendererQualityEvidence, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionOutlinePath, type SectionPathSegment, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };
+export { ACCESSIBILITY_RING_COLOR, ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartReferenceImage, type ChartTheme, type CubicPath, DEFAULT_CURRENCY, type DecorImageObject, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, LABEL_STYLE_MAX_SIZE, LABEL_STYLE_MIN_SIZE, type LabelPresentation, type LabelStyle, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type ReferenceAccessibilitySource, type ReferenceCalibration, type ReferenceCategorySource, type ReferenceDerivedScale, type ReferenceInventoryExclusionSource, type ReferenceInventorySource, type RenderedBookableLabelEvidence, type RenderedFreeTextEvidence, type RenderedGAAreaEvidence, type RenderedHierarchyLabelEvidence, type RenderedLabelHiddenReason, type RendererCallbacks, type RendererOptions, type RendererQualityEvidence, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatCommercialAttributes, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionOutlinePath, type SectionPathSegment, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, accessibilityRingColor, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };