@seatlayer/core 0.46.0 → 0.47.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { R as RowObject, A as AccessibilityType, S as SeatOverride, L as LabelStyle, a as RectTableSide, C as ChartDoc, b as ChartObject, B as BoothObject, E as ExpandedSeat, T as TableObject, F as Floor, P as Point, c as SectionObject, d as RectTableSeatCounts, G as GAAreaObject, e as GAInventorySegment, f as RendererQualityEvidence, g as RenderedFreeTextEvidence, I as ISeatmapRenderer, h as RendererOptions, i as SeatStatus, j as RendererViewMode, k as LodRung, l as CategoryTier, m as SeatCommercialAttributes, n as RendererCallbacks } from './types-DBnRO2hX.cjs';
-export { o as ACCESSIBILITY_RING_COLOR, p as ACCESSIBILITY_TYPES, q as AccessibilityMeta, r as CHART_STORAGE_KEY, s as Category, t as ChartReferenceImage, u as ChartTheme, v as CubicPath, D as DecorImageObject, w as LABEL_STYLE_MAX_SIZE, x as LABEL_STYLE_MIN_SIZE, y as LabelPresentation, z as ReferenceAccessibilitySource, H as ReferenceCalibration, J as ReferenceCategorySource, K as ReferenceDerivedScale, M as ReferenceInventoryExclusionSource, N as ReferenceInventorySource, O as ReferenceScanProposal, Q as ReferenceScanRowProposal, U as ReferenceScanSectionProposal, V as ReferenceSeatSeed, W as ReferenceSectionTraceBatchInput, X as ReferenceSectionTraceBatchProposal, Y as ReferenceSectionTraceInput, Z as ReferenceSectionTraceProposal, _ as RenderedBookableLabelEvidence, $ as RenderedGAAreaEvidence, a0 as RenderedHierarchyLabelEvidence, a1 as RenderedLabelHiddenReason, a2 as SEAT_COMMERCIAL_MARKS, a3 as SURROUNDINGS_SHAPE_ROLES, a4 as SeatCommercialMark, a5 as SeatCommercialMeta, a6 as SectionOutlinePath, a7 as SectionPathSegment, a8 as SelectionLayer, a9 as ShapeLineCap, aa as ShapeLineEnding, ab as ShapeLineJoin, ac as ShapeObject, ad as TextObject, ae as ZoneDef, af as accessibilityMeta, ag as accessibilityRingColor, ah as layerOf, ai as seatCommercialMeta } from './types-DBnRO2hX.cjs';
+import { R as RowObject, A as AccessibilityType, S as SeatOverride, a as SeatViewMetadata, L as LabelStyle, b as RectTableSide, C as ChartDoc, c as ChartObject, B as BoothObject, E as ExpandedSeat, T as TableObject, F as Floor, P as Point, d as SectionObject, e as RectTableSeatCounts, G as GAAreaObject, f as GAInventorySegment, g as RendererQualityEvidence, h as RenderedFreeTextEvidence, I as ISeatmapRenderer, i as RendererOptions, j as SeatStatus, k as RendererViewMode, l as LodRung, m as CategoryTier, n as SeatCommercialAttributes, o as RendererCallbacks } from './types-CE63BK0j.cjs';
+export { p as ACCESSIBILITY_RING_COLOR, q as ACCESSIBILITY_TYPES, r as AccessibilityMeta, s as AuthoringObjectState, t as CHART_STORAGE_KEY, u as Category, v as ChartReferenceImage, w as ChartTheme, x as CubicPath, D as DecorImageObject, y as LABEL_STYLE_MAX_SIZE, z as LABEL_STYLE_MIN_SIZE, H as LabelPresentation, O as ObjectEditorState, J as ReferenceAccessibilitySource, K as ReferenceCalibration, M as ReferenceCategorySource, N as ReferenceDerivedScale, Q as ReferenceInventoryExclusionSource, U as ReferenceInventorySource, V as ReferenceScanProposal, W as ReferenceScanRowProposal, X as ReferenceScanSectionProposal, Y as ReferenceSeatSeed, Z as ReferenceSectionTraceBatchInput, _ as ReferenceSectionTraceBatchProposal, $ as ReferenceSectionTraceInput, a0 as ReferenceSectionTraceProposal, a1 as RenderedBookableLabelEvidence, a2 as RenderedGAAreaEvidence, a3 as RenderedHierarchyLabelEvidence, a4 as RenderedLabelHiddenReason, a5 as SEAT_COMMERCIAL_MARKS, a6 as SURROUNDINGS_SHAPE_ROLES, a7 as SeatCommercialMark, a8 as SeatCommercialMeta, a9 as SeatViewCoverage, aa as SectionOutlinePath, ab as SectionPathSegment, ac as SelectionLayer, ad as ShapeLineCap, ae as ShapeLineEnding, af as ShapeLineJoin, ag as ShapeObject, ah as TextAlignment, ai as TextBackground, aj as TextObject, ak as ZoneDef, al as accessibilityMeta, am as accessibilityRingColor, an as layerOf, ao as seatCommercialMeta } from './types-CE63BK0j.cjs';
 
 /**
  * The segmented-row model — one logical row made of several physical rows.
@@ -34,6 +34,7 @@ interface SegmentedRowPlacement {
     totalSeats: number;
     canonical: RowObject;
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: RowObject['viewFromSeatMeta'];
 }
 
 /**
@@ -80,6 +81,7 @@ interface RowSeatSlot {
     wheelchairSpaceType?: SeatOverride['wheelchairSpaceType'];
     commercial?: RowObject['commercial'];
     viewUrl?: string;
+    viewMeta?: SeatViewMetadata;
     labelStyle?: LabelStyle;
 }
 /** Every authored table-chair slot, including skipped inventory. This mirrors
@@ -173,6 +175,9 @@ interface ExpandChartOptions {
     /** Physical height for a single-floor projection extracted from a multi-floor
      * document. Full multi-floor documents resolve each floor directly. */
     floorBaseHeightM?: number;
+    /** Resolve per-seat 3D eye heights (default true). Two-dimensional consumers
+     * such as thumbnails can disable this expensive stand-structure pass. */
+    resolveEyeHeights?: boolean;
 }
 /** Expand every seat-bearing object across all floors (rows, tables, booths).
  * Multi-floor ownership is resolved one floor at a time: local coordinates may
@@ -1392,6 +1397,21 @@ interface PickerStatusChange {
 interface PickerRealtimeSink {
     /** Apply a batch of label→status changes as ONE paint pass, not one per label. */
     applyStatuses(changes: PickerStatusChange[]): void;
+    /**
+     * Paint a COMPLETE projection: the default every unnamed unit takes, plus the
+     * units that differ from it.
+     *
+     * Optional so a host implementing an older sink keeps working — a client that
+     * finds it missing falls back to {@link resync}. Where it exists it replaces
+     * that HTTP round trip entirely, because the frame that triggered the resync
+     * already carried the whole authoritative state. On a 52k venue that is the
+     * difference between a ~960 KiB verbose fetch and painting what already
+     * arrived in a ~200 KiB socket frame.
+     */
+    applyProjection?(projection: {
+        default: string;
+        exceptions: Record<string, string>;
+    }): void;
     /** Re-pull authoritative state over HTTP (a frame that cannot be diffed). */
     resync(): void | Promise<void>;
     /** Section availability changed (hidden = stripped, closed = greyed). */
@@ -1417,13 +1437,17 @@ interface PickerTransport {
             salesClosed?: boolean;
             venue?: string | null;
             startsAt?: number | null;
+            timezone?: string | null;
             currency?: string;
             mode?: string;
             inventoryModelVersion?: 1 | 2;
         };
     }>;
+    /** `default` is the status of every seat NOT in `seats`; absent means `free`
+     *  (an older server names every seat). Never assume it. */
     objects(key: string): Promise<{
         seats: Record<string, string>;
+        default?: string;
         hidden?: string[];
         closed?: string[];
     }>;
@@ -1520,6 +1544,36 @@ interface PickerOptions extends PickerCallbacks {
      * and the WS protocol are identical either way.
      */
     keepLiveWhileHidden?: boolean;
+    /**
+     * Host overrides for the DRAWN map — see {@link PickerMapTheme}. Absent (the
+     * default, and every embed) leaves the chart document's own theme untouched.
+     */
+    mapTheme?: PickerMapTheme | null;
+}
+/**
+ * The subset of `ChartTheme` a HOST may override on the drawn canvas.
+ *
+ * WHY A SUBSET, AND WHY THESE FOUR. Everything here paints directly ON the
+ * ground this same object sets, so a caller supplying it can be held to a
+ * contrast contract over its own values (the event-page palettes are). The
+ * fields deliberately left out — `seatLabelColor`, `decorFill` — paint on top
+ * of CHART-authored colours instead: a category's fill, an authored décor fill.
+ * A page palette knows nothing about those, so an override there would be an
+ * unverifiable guess about legibility, and the chart keeps them.
+ *
+ * `seatScale`, `fontFamily` and the white-label branding fields are not here
+ * either: they are the ORGANIZER's, authored once with the chart, and a page
+ * theme is not the place to resize a venue.
+ */
+interface PickerMapTheme {
+    /** The canvas ground behind the seats. */
+    background?: string;
+    /** Row identifiers (A, B, C) drawn beside the rows. */
+    rowLabelColor?: string;
+    /** Default ink for free text drawn on the canvas. */
+    textColor?: string;
+    /** Selection / hover ring. */
+    selectionColor?: string;
 }
 declare class PickerController {
     private readonly opts;
@@ -1530,6 +1584,8 @@ declare class PickerController {
     private _doc;
     /** Section/zone ids hidden from buyers this event (3.3) — seats vanish, not grey. */
     private hidden;
+    /** Host overrides folded over the chart's own theme in `visibleDoc()`. */
+    private mapTheme;
     /** Section/zone ids in the `closed` event-state (Phase 2) — seats stay, greyed
      *  + not pickable. Kept separate from `hidden` (which strips them). */
     private closedSections;
@@ -1563,12 +1619,53 @@ declare class PickerController {
     private onVisibilityChange;
     private hold_;
     private liveStatuses;
+    /**
+     * What a label absent from `liveStatuses` is.
+     *
+     * `free` while the verbose HTTP map is the source (it names every unit), but a
+     * compact realtime frame names only its exceptions — so on a mostly-sold event
+     * the seats NOT listed are the booked ones. Read through {@link statusOf};
+     * a bare `liveStatuses.get()` silently answers `undefined` for the majority of
+     * a sold-out venue.
+     */
+    private liveDefault;
     private currency;
     private expiryTimer;
     constructor(options: PickerOptions);
     get doc(): ChartDoc | null;
-    /** The chart with hidden sections' seats removed — what buyers actually see. */
+    /**
+     * The chart with hidden sections' seats removed, and the host's map theme
+     * folded over the chart's own — what buyers actually see.
+     *
+     * THE THEME IS MERGED HERE rather than pushed at the renderer separately
+     * because the renderer reads its theme out of the document it is given. One
+     * merge point means every rebuild — a hidden section arriving mid-sale, a
+     * floor switch, a theme change — repaints from the same resolved theme
+     * instead of from whichever of two sources ran last.
+     *
+     * The chart's theme is the BASE and only named keys are overwritten, so a
+     * host that overrides the ground does not thereby erase the organizer's
+     * `seatScale`, `fontFamily`, logo or badge entitlement.
+     */
     private visibleDoc;
+    /**
+     * Re-ink the drawn map, in place, without losing the buyer's place in it.
+     *
+     * WHY THIS IS A SETTER AND NOT A MOUNT OPTION. On a templated event page the
+     * palette is not known when the map mounts: the page config is a separate
+     * cached read and the map is explicitly not allowed to wait for it. The
+     * alternative — remounting the widget once the palette lands — would destroy
+     * a hold the buyer may already be holding.
+     *
+     * The rebuild is the SAME recipe `render()` uses (setChart → colorblind →
+     * closed sections → statuses), because setChart resets all four; the one
+     * addition is restoring the selection, which `render()` has no need to do.
+     * Statuses are repainted from the map already in memory rather than re-read,
+     * so this costs no round trip and cannot flash a stale seat.
+     *
+     * Returns whether anything actually changed, so a caller may call it freely.
+     */
+    setMapTheme(theme: PickerMapTheme | null): boolean;
     /** Adopt a new hidden set; rebuild the visible chart only if it differs. */
     private syncHidden;
     /** Adopt a new closed-section set; restyle (grey + non-pickable) if it differs.
@@ -1606,6 +1703,9 @@ declare class PickerController {
         eventName: string;
         venue?: string | null;
         startsAt?: number | null;
+        /** The EVENT's IANA zone. Every surface that prints `startsAt` must format
+         *  in it — see the note in pub.ts's chart route. */
+        timezone?: string | null;
         currency?: string;
         /** 'test' ⇒ sandbox event (hosts show a TEST MODE ribbon). */
         mode?: string;
@@ -1835,7 +1935,19 @@ declare class PickerController {
     private setHold;
     private clearHold;
     private expireActiveHold;
+    /**
+     * Repaint from an authoritative map of unit statuses.
+     *
+     * `defaultStatus` is what every unit NOT named in `seats` is. The verbose HTTP
+     * route names every unit and leaves it at `free`; the compact realtime frame
+     * names only the exceptions and states its own default, which on a mostly-sold
+     * event is `booked` rather than `free`. Applying a compact map while assuming
+     * `free` would paint a sold-out stadium as fully available, so the default is
+     * a parameter rather than a constant.
+     */
     private applySeatsMap;
+    /** The live status of one unit, honouring the projection's default. */
+    private statusOf;
     private clearBookedHoldIfSettled;
     private resnapshot;
     /**
@@ -2000,6 +2112,9 @@ declare function loadLocale(code?: string | null): Promise<Locale>;
  * convert at the API boundary, not here.
  */
 declare const DEFAULT_CURRENCY = "USD";
+/** Currencies offered in event create/edit selects — shared by the plain and
+ *  express create forms so the two can never offer different lists. */
+declare const CURRENCY_CHOICES: string[];
 declare function setMoneyLocale(locale: string | undefined): void;
 /**
  * "€45" / "$1,500" / "45 €" (locale-dependent placement).
@@ -2034,4 +2149,4 @@ declare function formatMinor(minor: number, currency?: string): string;
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { AccessibilityType, type AvailabilityRule, BoothObject, CategoryTier, ChartDoc, ChartObject, DEFAULT_CURRENCY, type Dict, type ExpandChartOptions, ExpandedSeat, Floor, GAAreaObject, GAInventorySegment, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LabelStyle, type Locale, LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerSeat, type PickerStatusChange, type PickerTransport, Point, RENDERED_QUALITY_REPORT_VERSION, RectTableSeatCounts, RectTableSide, type RenderedEvidenceState, RenderedFreeTextEvidence, type RenderedQualityFinding, type RenderedQualityFindingCode, type RenderedQualityReport, type RenderedQualitySample, RendererCallbacks, RendererOptions, RendererQualityEvidence, RendererViewMode, RowObject, type RowSeatSlot, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatOverride, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, SectionObject, type SectionSummary, TIER_HEIGHT_M, TableObject, type TableSeatSlot, type TableSelectionDetails, UNGROUPED_ID, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencyExponent, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMinor, formatMoney, fromMinorUnits, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, validGAInventorySegments };
+export { AccessibilityType, type AvailabilityRule, BoothObject, CURRENCY_CHOICES, CategoryTier, ChartDoc, ChartObject, DEFAULT_CURRENCY, type Dict, type ExpandChartOptions, ExpandedSeat, Floor, GAAreaObject, GAInventorySegment, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LabelStyle, type Locale, LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerSeat, type PickerStatusChange, type PickerTransport, Point, RENDERED_QUALITY_REPORT_VERSION, RectTableSeatCounts, RectTableSide, type RenderedEvidenceState, RenderedFreeTextEvidence, type RenderedQualityFinding, type RenderedQualityFindingCode, type RenderedQualityReport, type RenderedQualitySample, RendererCallbacks, RendererOptions, RendererQualityEvidence, RendererViewMode, RowObject, type RowSeatSlot, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatOverride, SeatStatus, SeatViewMetadata, SeatmapRenderer, type SectionCategory, type SectionNode, SectionObject, type SectionSummary, TIER_HEIGHT_M, TableObject, type TableSeatSlot, type TableSelectionDetails, UNGROUPED_ID, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencyExponent, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMinor, formatMoney, fromMinorUnits, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, validGAInventorySegments };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as RowObject, A as AccessibilityType, S as SeatOverride, L as LabelStyle, a as RectTableSide, C as ChartDoc, b as ChartObject, B as BoothObject, E as ExpandedSeat, T as TableObject, F as Floor, P as Point, c as SectionObject, d as RectTableSeatCounts, G as GAAreaObject, e as GAInventorySegment, f as RendererQualityEvidence, g as RenderedFreeTextEvidence, I as ISeatmapRenderer, h as RendererOptions, i as SeatStatus, j as RendererViewMode, k as LodRung, l as CategoryTier, m as SeatCommercialAttributes, n as RendererCallbacks } from './types-DBnRO2hX.js';
-export { o as ACCESSIBILITY_RING_COLOR, p as ACCESSIBILITY_TYPES, q as AccessibilityMeta, r as CHART_STORAGE_KEY, s as Category, t as ChartReferenceImage, u as ChartTheme, v as CubicPath, D as DecorImageObject, w as LABEL_STYLE_MAX_SIZE, x as LABEL_STYLE_MIN_SIZE, y as LabelPresentation, z as ReferenceAccessibilitySource, H as ReferenceCalibration, J as ReferenceCategorySource, K as ReferenceDerivedScale, M as ReferenceInventoryExclusionSource, N as ReferenceInventorySource, O as ReferenceScanProposal, Q as ReferenceScanRowProposal, U as ReferenceScanSectionProposal, V as ReferenceSeatSeed, W as ReferenceSectionTraceBatchInput, X as ReferenceSectionTraceBatchProposal, Y as ReferenceSectionTraceInput, Z as ReferenceSectionTraceProposal, _ as RenderedBookableLabelEvidence, $ as RenderedGAAreaEvidence, a0 as RenderedHierarchyLabelEvidence, a1 as RenderedLabelHiddenReason, a2 as SEAT_COMMERCIAL_MARKS, a3 as SURROUNDINGS_SHAPE_ROLES, a4 as SeatCommercialMark, a5 as SeatCommercialMeta, a6 as SectionOutlinePath, a7 as SectionPathSegment, a8 as SelectionLayer, a9 as ShapeLineCap, aa as ShapeLineEnding, ab as ShapeLineJoin, ac as ShapeObject, ad as TextObject, ae as ZoneDef, af as accessibilityMeta, ag as accessibilityRingColor, ah as layerOf, ai as seatCommercialMeta } from './types-DBnRO2hX.js';
+import { R as RowObject, A as AccessibilityType, S as SeatOverride, a as SeatViewMetadata, L as LabelStyle, b as RectTableSide, C as ChartDoc, c as ChartObject, B as BoothObject, E as ExpandedSeat, T as TableObject, F as Floor, P as Point, d as SectionObject, e as RectTableSeatCounts, G as GAAreaObject, f as GAInventorySegment, g as RendererQualityEvidence, h as RenderedFreeTextEvidence, I as ISeatmapRenderer, i as RendererOptions, j as SeatStatus, k as RendererViewMode, l as LodRung, m as CategoryTier, n as SeatCommercialAttributes, o as RendererCallbacks } from './types-CE63BK0j.js';
+export { p as ACCESSIBILITY_RING_COLOR, q as ACCESSIBILITY_TYPES, r as AccessibilityMeta, s as AuthoringObjectState, t as CHART_STORAGE_KEY, u as Category, v as ChartReferenceImage, w as ChartTheme, x as CubicPath, D as DecorImageObject, y as LABEL_STYLE_MAX_SIZE, z as LABEL_STYLE_MIN_SIZE, H as LabelPresentation, O as ObjectEditorState, J as ReferenceAccessibilitySource, K as ReferenceCalibration, M as ReferenceCategorySource, N as ReferenceDerivedScale, Q as ReferenceInventoryExclusionSource, U as ReferenceInventorySource, V as ReferenceScanProposal, W as ReferenceScanRowProposal, X as ReferenceScanSectionProposal, Y as ReferenceSeatSeed, Z as ReferenceSectionTraceBatchInput, _ as ReferenceSectionTraceBatchProposal, $ as ReferenceSectionTraceInput, a0 as ReferenceSectionTraceProposal, a1 as RenderedBookableLabelEvidence, a2 as RenderedGAAreaEvidence, a3 as RenderedHierarchyLabelEvidence, a4 as RenderedLabelHiddenReason, a5 as SEAT_COMMERCIAL_MARKS, a6 as SURROUNDINGS_SHAPE_ROLES, a7 as SeatCommercialMark, a8 as SeatCommercialMeta, a9 as SeatViewCoverage, aa as SectionOutlinePath, ab as SectionPathSegment, ac as SelectionLayer, ad as ShapeLineCap, ae as ShapeLineEnding, af as ShapeLineJoin, ag as ShapeObject, ah as TextAlignment, ai as TextBackground, aj as TextObject, ak as ZoneDef, al as accessibilityMeta, am as accessibilityRingColor, an as layerOf, ao as seatCommercialMeta } from './types-CE63BK0j.js';
 
 /**
  * The segmented-row model — one logical row made of several physical rows.
@@ -34,6 +34,7 @@ interface SegmentedRowPlacement {
     totalSeats: number;
     canonical: RowObject;
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: RowObject['viewFromSeatMeta'];
 }
 
 /**
@@ -80,6 +81,7 @@ interface RowSeatSlot {
     wheelchairSpaceType?: SeatOverride['wheelchairSpaceType'];
     commercial?: RowObject['commercial'];
     viewUrl?: string;
+    viewMeta?: SeatViewMetadata;
     labelStyle?: LabelStyle;
 }
 /** Every authored table-chair slot, including skipped inventory. This mirrors
@@ -173,6 +175,9 @@ interface ExpandChartOptions {
     /** Physical height for a single-floor projection extracted from a multi-floor
      * document. Full multi-floor documents resolve each floor directly. */
     floorBaseHeightM?: number;
+    /** Resolve per-seat 3D eye heights (default true). Two-dimensional consumers
+     * such as thumbnails can disable this expensive stand-structure pass. */
+    resolveEyeHeights?: boolean;
 }
 /** Expand every seat-bearing object across all floors (rows, tables, booths).
  * Multi-floor ownership is resolved one floor at a time: local coordinates may
@@ -1392,6 +1397,21 @@ interface PickerStatusChange {
 interface PickerRealtimeSink {
     /** Apply a batch of label→status changes as ONE paint pass, not one per label. */
     applyStatuses(changes: PickerStatusChange[]): void;
+    /**
+     * Paint a COMPLETE projection: the default every unnamed unit takes, plus the
+     * units that differ from it.
+     *
+     * Optional so a host implementing an older sink keeps working — a client that
+     * finds it missing falls back to {@link resync}. Where it exists it replaces
+     * that HTTP round trip entirely, because the frame that triggered the resync
+     * already carried the whole authoritative state. On a 52k venue that is the
+     * difference between a ~960 KiB verbose fetch and painting what already
+     * arrived in a ~200 KiB socket frame.
+     */
+    applyProjection?(projection: {
+        default: string;
+        exceptions: Record<string, string>;
+    }): void;
     /** Re-pull authoritative state over HTTP (a frame that cannot be diffed). */
     resync(): void | Promise<void>;
     /** Section availability changed (hidden = stripped, closed = greyed). */
@@ -1417,13 +1437,17 @@ interface PickerTransport {
             salesClosed?: boolean;
             venue?: string | null;
             startsAt?: number | null;
+            timezone?: string | null;
             currency?: string;
             mode?: string;
             inventoryModelVersion?: 1 | 2;
         };
     }>;
+    /** `default` is the status of every seat NOT in `seats`; absent means `free`
+     *  (an older server names every seat). Never assume it. */
     objects(key: string): Promise<{
         seats: Record<string, string>;
+        default?: string;
         hidden?: string[];
         closed?: string[];
     }>;
@@ -1520,6 +1544,36 @@ interface PickerOptions extends PickerCallbacks {
      * and the WS protocol are identical either way.
      */
     keepLiveWhileHidden?: boolean;
+    /**
+     * Host overrides for the DRAWN map — see {@link PickerMapTheme}. Absent (the
+     * default, and every embed) leaves the chart document's own theme untouched.
+     */
+    mapTheme?: PickerMapTheme | null;
+}
+/**
+ * The subset of `ChartTheme` a HOST may override on the drawn canvas.
+ *
+ * WHY A SUBSET, AND WHY THESE FOUR. Everything here paints directly ON the
+ * ground this same object sets, so a caller supplying it can be held to a
+ * contrast contract over its own values (the event-page palettes are). The
+ * fields deliberately left out — `seatLabelColor`, `decorFill` — paint on top
+ * of CHART-authored colours instead: a category's fill, an authored décor fill.
+ * A page palette knows nothing about those, so an override there would be an
+ * unverifiable guess about legibility, and the chart keeps them.
+ *
+ * `seatScale`, `fontFamily` and the white-label branding fields are not here
+ * either: they are the ORGANIZER's, authored once with the chart, and a page
+ * theme is not the place to resize a venue.
+ */
+interface PickerMapTheme {
+    /** The canvas ground behind the seats. */
+    background?: string;
+    /** Row identifiers (A, B, C) drawn beside the rows. */
+    rowLabelColor?: string;
+    /** Default ink for free text drawn on the canvas. */
+    textColor?: string;
+    /** Selection / hover ring. */
+    selectionColor?: string;
 }
 declare class PickerController {
     private readonly opts;
@@ -1530,6 +1584,8 @@ declare class PickerController {
     private _doc;
     /** Section/zone ids hidden from buyers this event (3.3) — seats vanish, not grey. */
     private hidden;
+    /** Host overrides folded over the chart's own theme in `visibleDoc()`. */
+    private mapTheme;
     /** Section/zone ids in the `closed` event-state (Phase 2) — seats stay, greyed
      *  + not pickable. Kept separate from `hidden` (which strips them). */
     private closedSections;
@@ -1563,12 +1619,53 @@ declare class PickerController {
     private onVisibilityChange;
     private hold_;
     private liveStatuses;
+    /**
+     * What a label absent from `liveStatuses` is.
+     *
+     * `free` while the verbose HTTP map is the source (it names every unit), but a
+     * compact realtime frame names only its exceptions — so on a mostly-sold event
+     * the seats NOT listed are the booked ones. Read through {@link statusOf};
+     * a bare `liveStatuses.get()` silently answers `undefined` for the majority of
+     * a sold-out venue.
+     */
+    private liveDefault;
     private currency;
     private expiryTimer;
     constructor(options: PickerOptions);
     get doc(): ChartDoc | null;
-    /** The chart with hidden sections' seats removed — what buyers actually see. */
+    /**
+     * The chart with hidden sections' seats removed, and the host's map theme
+     * folded over the chart's own — what buyers actually see.
+     *
+     * THE THEME IS MERGED HERE rather than pushed at the renderer separately
+     * because the renderer reads its theme out of the document it is given. One
+     * merge point means every rebuild — a hidden section arriving mid-sale, a
+     * floor switch, a theme change — repaints from the same resolved theme
+     * instead of from whichever of two sources ran last.
+     *
+     * The chart's theme is the BASE and only named keys are overwritten, so a
+     * host that overrides the ground does not thereby erase the organizer's
+     * `seatScale`, `fontFamily`, logo or badge entitlement.
+     */
     private visibleDoc;
+    /**
+     * Re-ink the drawn map, in place, without losing the buyer's place in it.
+     *
+     * WHY THIS IS A SETTER AND NOT A MOUNT OPTION. On a templated event page the
+     * palette is not known when the map mounts: the page config is a separate
+     * cached read and the map is explicitly not allowed to wait for it. The
+     * alternative — remounting the widget once the palette lands — would destroy
+     * a hold the buyer may already be holding.
+     *
+     * The rebuild is the SAME recipe `render()` uses (setChart → colorblind →
+     * closed sections → statuses), because setChart resets all four; the one
+     * addition is restoring the selection, which `render()` has no need to do.
+     * Statuses are repainted from the map already in memory rather than re-read,
+     * so this costs no round trip and cannot flash a stale seat.
+     *
+     * Returns whether anything actually changed, so a caller may call it freely.
+     */
+    setMapTheme(theme: PickerMapTheme | null): boolean;
     /** Adopt a new hidden set; rebuild the visible chart only if it differs. */
     private syncHidden;
     /** Adopt a new closed-section set; restyle (grey + non-pickable) if it differs.
@@ -1606,6 +1703,9 @@ declare class PickerController {
         eventName: string;
         venue?: string | null;
         startsAt?: number | null;
+        /** The EVENT's IANA zone. Every surface that prints `startsAt` must format
+         *  in it — see the note in pub.ts's chart route. */
+        timezone?: string | null;
         currency?: string;
         /** 'test' ⇒ sandbox event (hosts show a TEST MODE ribbon). */
         mode?: string;
@@ -1835,7 +1935,19 @@ declare class PickerController {
     private setHold;
     private clearHold;
     private expireActiveHold;
+    /**
+     * Repaint from an authoritative map of unit statuses.
+     *
+     * `defaultStatus` is what every unit NOT named in `seats` is. The verbose HTTP
+     * route names every unit and leaves it at `free`; the compact realtime frame
+     * names only the exceptions and states its own default, which on a mostly-sold
+     * event is `booked` rather than `free`. Applying a compact map while assuming
+     * `free` would paint a sold-out stadium as fully available, so the default is
+     * a parameter rather than a constant.
+     */
     private applySeatsMap;
+    /** The live status of one unit, honouring the projection's default. */
+    private statusOf;
     private clearBookedHoldIfSettled;
     private resnapshot;
     /**
@@ -2000,6 +2112,9 @@ declare function loadLocale(code?: string | null): Promise<Locale>;
  * convert at the API boundary, not here.
  */
 declare const DEFAULT_CURRENCY = "USD";
+/** Currencies offered in event create/edit selects — shared by the plain and
+ *  express create forms so the two can never offer different lists. */
+declare const CURRENCY_CHOICES: string[];
 declare function setMoneyLocale(locale: string | undefined): void;
 /**
  * "€45" / "$1,500" / "45 €" (locale-dependent placement).
@@ -2034,4 +2149,4 @@ declare function formatMinor(minor: number, currency?: string): string;
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { AccessibilityType, type AvailabilityRule, BoothObject, CategoryTier, ChartDoc, ChartObject, DEFAULT_CURRENCY, type Dict, type ExpandChartOptions, ExpandedSeat, Floor, GAAreaObject, GAInventorySegment, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LabelStyle, type Locale, LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerSeat, type PickerStatusChange, type PickerTransport, Point, RENDERED_QUALITY_REPORT_VERSION, RectTableSeatCounts, RectTableSide, type RenderedEvidenceState, RenderedFreeTextEvidence, type RenderedQualityFinding, type RenderedQualityFindingCode, type RenderedQualityReport, type RenderedQualitySample, RendererCallbacks, RendererOptions, RendererQualityEvidence, RendererViewMode, RowObject, type RowSeatSlot, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatOverride, SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, SectionObject, type SectionSummary, TIER_HEIGHT_M, TableObject, type TableSeatSlot, type TableSelectionDetails, UNGROUPED_ID, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencyExponent, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMinor, formatMoney, fromMinorUnits, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, validGAInventorySegments };
+export { AccessibilityType, type AvailabilityRule, BoothObject, CURRENCY_CHOICES, CategoryTier, ChartDoc, ChartObject, DEFAULT_CURRENCY, type Dict, type ExpandChartOptions, ExpandedSeat, Floor, GAAreaObject, GAInventorySegment, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, ISeatmapRenderer, LabelStyle, type Locale, LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerGAArea, type PickerMapTheme, type PickerOptions, type PickerRealtimeConnection, type PickerRealtimeSink, type PickerSeat, type PickerStatusChange, type PickerTransport, Point, RENDERED_QUALITY_REPORT_VERSION, RectTableSeatCounts, RectTableSide, type RenderedEvidenceState, RenderedFreeTextEvidence, type RenderedQualityFinding, type RenderedQualityFindingCode, type RenderedQualityReport, type RenderedQualitySample, RendererCallbacks, RendererOptions, RendererQualityEvidence, RendererViewMode, RowObject, type RowSeatSlot, SUPPORTED_LOCALES, SeatCommercialAttributes, type SeatHoverDetails, SeatOverride, SeatStatus, SeatViewMetadata, SeatmapRenderer, type SectionCategory, type SectionNode, SectionObject, type SectionSummary, TIER_HEIGHT_M, TableObject, type TableSeatSlot, type TableSelectionDetails, UNGROUPED_ID, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencyExponent, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMinor, formatMoney, fromMinorUnits, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, validGAInventorySegments };