@seatlayer/core 0.34.0 → 0.36.0

package/dist/index.d.cts

@@ -1,5 +1,40 @@
-import { A as AccessibilityType, S as SeatOverride, R as RowObject, 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-DO_J5DtX.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-DO_J5DtX.cjs';
+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';
+
+/**
+ * The segmented-row model — one logical row made of several physical rows.
+ *
+ * A segmented row is drawn as a chain of nodes and stored as N physical
+ * `RowObject`s tied together by `segmentedRow` metadata. Two questions have to
+ * be answered consistently or the feature lies to somebody:
+ *
+ * 1. **At draft time** — given the author's nodes, exactly which components,
+ *    seat counts and pitches will be committed? (`segmentedRowComponents`)
+ * 2. **At read time** — given stored physical rows, what is the logical row they
+ *    form, and where does each component sit inside its numbering?
+ *    (`resolveSegmentedRowGroups`)
+ *
+ * These lived apart — (1) in `rowDraft.ts` next to the ghost preview, (2) in
+ * `layout.ts` next to buyer expansion — which is precisely how the canvas came
+ * to number a segmented row `1-7` / `1-6` while buyers correctly saw
+ * `A-1…A-13`. They are two halves of one rule, so they live in one module.
+ *
+ * The standing rule this module exists to enforce: **the ghost preview and the
+ * commit share one resolver.** A preview that can lie is a bug.
+ */
+
+/** Resolved logical placement of one physical component inside a segmented row. */
+interface SegmentedRowPlacement {
+    groupId: string;
+    /** Buyer adjacency index base (a declared aisle break costs one index). */
+    adjacencyOffset: number;
+    /** Continuous seat-numbering base across the whole logical row. */
+    displayOffset: number;
+    displayLabel: string;
+    totalSeats: number;
+    canonical: RowObject;
+    viewFromSeatUrl?: string;
+}
 
 /**
  * Pure geometry helpers — no Konva, no DOM. Turns the parametric chart
@@ -54,12 +89,13 @@ interface TableSeatSlot extends RowSeatSlot {
     side?: RectTableSide;
 }
 /**
- * The seat NUMBER part of a row seat's label (the row prefix is prepended by the
- * caller). Applies the row's numbering scheme, direction, step, start and label
- * prefix. Labels only — never geometry. See `RowObject.seatNumbering.scheme`.
+ * Seat slots for one physical row.
+ *
+ * `placement` makes the slots read as part of a logical segmented row: labels
+ * continue across components (`A-8`, not a second `A-1`) using the logical row's
+ * numbering scheme and total seat count.
  */
-declare function seatLabelPart(row: RowObject, i: number): string;
-declare function expandRowSlots(row: RowObject): RowSeatSlot[];
+declare function expandRowSlots(row: RowObject, placement?: SegmentedRowPlacement): RowSeatSlot[];
 declare function expandRow(row: RowObject): ExpandedSeat[];
 /**
  * Expand a table into its perimeter seats.
@@ -408,6 +444,7 @@ declare function inspectRenderedQualityEvidence(evidence: RendererQualityEvidenc
 declare class SeatmapRenderer implements ISeatmapRenderer {
     private container;
     private opts;
+    private readonly exportMode;
     private stage;
     private bgLayer;
     private seatLayer;
@@ -566,6 +603,11 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private bounds;
     private cached;
     private dpr;
+    /** Current chart's buyer-visible image work. Failures are retained until ready(). */
+    private assetGeneration;
+    private assetPromises;
+    private assetErrors;
+    private assetCancels;
     private rafId;
     private frames;
     private lastFpsAt;
@@ -915,6 +957,14 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Legend hover: highlight one category (dim the rest), or null to clear. */
     setCategoryHighlight(key: string | null): void;
     private renderBackground;
+    /**
+     * Track an image through decode without ever leaving a rejected promise
+     * unobserved. Ordinary picker rendering remains best-effort; export ready()
+     * turns the retained failures into one actionable error.
+     */
+    private trackAssetImage;
+    /** Cancel and release every image retained by the previous chart/export. */
+    private cancelAssetLoads;
     /** Organizer floor-plan photo, dimmed, at the very bottom of the bg layer. */
     private renderBackgroundImage;
     /**
@@ -1138,6 +1188,21 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * byte-identical.
      */
     forceDraw(): void;
+    /**
+     * Resolve every buyer-visible image requested by the current chart. Export
+     * callers get a hard error with the affected layer name; the interactive
+     * renderer never calls this and retains its existing best-effort behaviour.
+     */
+    ready(): Promise<void>;
+    /** Exact visible scene bounds in chart coordinates after fonts/assets exist. */
+    private exportSceneBounds;
+    /** Fit exact rendered nodes, including rotated text/decor, with pixel padding. */
+    private fitExportContent;
+    /**
+     * Capture a clean, opaque fixed-size canvas. The CSS host background is
+     * painted explicitly because Konva layers themselves are transparent.
+     */
+    captureCanvas(): HTMLCanvasElement;
     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
@@ -1145,6 +1210,16 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      *  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;
+    /** Axis-aligned world bounds of a centred, potentially rotated row label. */
+    private rowLabelBox;
+    /**
+     * Keep an automatic start/end label out of seat markers and already-painted
+     * text. The authored point is never altered. Candidates are deliberately
+     * bounded and deterministic: the closest clear offset wins; if a chart is so
+     * dense that none is clear, the least-colliding candidate wins so the required
+     * row label remains present rather than being silently dropped.
+     */
+    private resolveAutomaticRowLabelPosition;
     /** Row labels never carry status; the buyer just dims them under the same
      *  category/price filters that dim their seats. */
     private objectFilteredOut;
@@ -1334,6 +1409,10 @@ interface PickerTransport {
         extends?: number;
     }>;
     socketUrl(key: string): string;
+    /** Optional — WebSocket subprotocols for the live feed (e.g. a one-use
+     *  subscribe ticket via `Sec-WebSocket-Protocol`, realtime-protocol v1).
+     *  Absent or empty means today's plain connection. */
+    socketProtocols?(key: string): string[];
 }
 interface PickerCallbacks extends RendererCallbacks {
     /** Selection changed (manual clicks or a server best-available pick). */
@@ -1859,4 +1938,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** 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 PickerSeat, 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, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, seatLabelPart, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, validGAInventorySegments };
+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 PickerSeat, 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, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMoney, 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,40 @@
-import { A as AccessibilityType, S as SeatOverride, R as RowObject, 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-DO_J5DtX.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-DO_J5DtX.js';
+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';
+
+/**
+ * The segmented-row model — one logical row made of several physical rows.
+ *
+ * A segmented row is drawn as a chain of nodes and stored as N physical
+ * `RowObject`s tied together by `segmentedRow` metadata. Two questions have to
+ * be answered consistently or the feature lies to somebody:
+ *
+ * 1. **At draft time** — given the author's nodes, exactly which components,
+ *    seat counts and pitches will be committed? (`segmentedRowComponents`)
+ * 2. **At read time** — given stored physical rows, what is the logical row they
+ *    form, and where does each component sit inside its numbering?
+ *    (`resolveSegmentedRowGroups`)
+ *
+ * These lived apart — (1) in `rowDraft.ts` next to the ghost preview, (2) in
+ * `layout.ts` next to buyer expansion — which is precisely how the canvas came
+ * to number a segmented row `1-7` / `1-6` while buyers correctly saw
+ * `A-1…A-13`. They are two halves of one rule, so they live in one module.
+ *
+ * The standing rule this module exists to enforce: **the ghost preview and the
+ * commit share one resolver.** A preview that can lie is a bug.
+ */
+
+/** Resolved logical placement of one physical component inside a segmented row. */
+interface SegmentedRowPlacement {
+    groupId: string;
+    /** Buyer adjacency index base (a declared aisle break costs one index). */
+    adjacencyOffset: number;
+    /** Continuous seat-numbering base across the whole logical row. */
+    displayOffset: number;
+    displayLabel: string;
+    totalSeats: number;
+    canonical: RowObject;
+    viewFromSeatUrl?: string;
+}
 
 /**
  * Pure geometry helpers — no Konva, no DOM. Turns the parametric chart
@@ -54,12 +89,13 @@ interface TableSeatSlot extends RowSeatSlot {
     side?: RectTableSide;
 }
 /**
- * The seat NUMBER part of a row seat's label (the row prefix is prepended by the
- * caller). Applies the row's numbering scheme, direction, step, start and label
- * prefix. Labels only — never geometry. See `RowObject.seatNumbering.scheme`.
+ * Seat slots for one physical row.
+ *
+ * `placement` makes the slots read as part of a logical segmented row: labels
+ * continue across components (`A-8`, not a second `A-1`) using the logical row's
+ * numbering scheme and total seat count.
  */
-declare function seatLabelPart(row: RowObject, i: number): string;
-declare function expandRowSlots(row: RowObject): RowSeatSlot[];
+declare function expandRowSlots(row: RowObject, placement?: SegmentedRowPlacement): RowSeatSlot[];
 declare function expandRow(row: RowObject): ExpandedSeat[];
 /**
  * Expand a table into its perimeter seats.
@@ -408,6 +444,7 @@ declare function inspectRenderedQualityEvidence(evidence: RendererQualityEvidenc
 declare class SeatmapRenderer implements ISeatmapRenderer {
     private container;
     private opts;
+    private readonly exportMode;
     private stage;
     private bgLayer;
     private seatLayer;
@@ -566,6 +603,11 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private bounds;
     private cached;
     private dpr;
+    /** Current chart's buyer-visible image work. Failures are retained until ready(). */
+    private assetGeneration;
+    private assetPromises;
+    private assetErrors;
+    private assetCancels;
     private rafId;
     private frames;
     private lastFpsAt;
@@ -915,6 +957,14 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     /** Legend hover: highlight one category (dim the rest), or null to clear. */
     setCategoryHighlight(key: string | null): void;
     private renderBackground;
+    /**
+     * Track an image through decode without ever leaving a rejected promise
+     * unobserved. Ordinary picker rendering remains best-effort; export ready()
+     * turns the retained failures into one actionable error.
+     */
+    private trackAssetImage;
+    /** Cancel and release every image retained by the previous chart/export. */
+    private cancelAssetLoads;
     /** Organizer floor-plan photo, dimmed, at the very bottom of the bg layer. */
     private renderBackgroundImage;
     /**
@@ -1138,6 +1188,21 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * byte-identical.
      */
     forceDraw(): void;
+    /**
+     * Resolve every buyer-visible image requested by the current chart. Export
+     * callers get a hard error with the affected layer name; the interactive
+     * renderer never calls this and retains its existing best-effort behaviour.
+     */
+    ready(): Promise<void>;
+    /** Exact visible scene bounds in chart coordinates after fonts/assets exist. */
+    private exportSceneBounds;
+    /** Fit exact rendered nodes, including rotated text/decor, with pixel padding. */
+    private fitExportContent;
+    /**
+     * Capture a clean, opaque fixed-size canvas. The CSS host background is
+     * painted explicitly because Konva layers themselves are transparent.
+     */
+    captureCanvas(): HTMLCanvasElement;
     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
@@ -1145,6 +1210,16 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      *  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;
+    /** Axis-aligned world bounds of a centred, potentially rotated row label. */
+    private rowLabelBox;
+    /**
+     * Keep an automatic start/end label out of seat markers and already-painted
+     * text. The authored point is never altered. Candidates are deliberately
+     * bounded and deterministic: the closest clear offset wins; if a chart is so
+     * dense that none is clear, the least-colliding candidate wins so the required
+     * row label remains present rather than being silently dropped.
+     */
+    private resolveAutomaticRowLabelPosition;
     /** Row labels never carry status; the buyer just dims them under the same
      *  category/price filters that dim their seats. */
     private objectFilteredOut;
@@ -1334,6 +1409,10 @@ interface PickerTransport {
         extends?: number;
     }>;
     socketUrl(key: string): string;
+    /** Optional — WebSocket subprotocols for the live feed (e.g. a one-use
+     *  subscribe ticket via `Sec-WebSocket-Protocol`, realtime-protocol v1).
+     *  Absent or empty means today's plain connection. */
+    socketProtocols?(key: string): string[];
 }
 interface PickerCallbacks extends RendererCallbacks {
     /** Selection changed (manual clicks or a server best-available pick). */
@@ -1859,4 +1938,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** 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 PickerSeat, 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, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaInventorySegments, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, growJoinedGAInventory, hiddenObjectIds, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, loadLocale, objectCenter, owningSectionForObject, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowInventoryCount, rowSeatPositions, seatLabelPart, sectionGeometry, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount, tableInventoryCount, tableSeatCountsBySide, validGAInventorySegments };
+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 PickerSeat, 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, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, expandTableSlots, floorObjects, floorsOf, formatDate, formatMoney, 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 };