@seatlayer/core 0.23.0 → 0.25.0

package/dist/index.d.cts

@@ -175,6 +175,16 @@ interface LabelPresentation {
     style?: 'plain' | 'pill';
     /** Per-object size/color override for this row's or section's label. */
     labelStyle?: LabelStyle;
+    /**
+     * End-position preset for a ROW label — which end(s) of the row show it:
+     *  - `start` (default/undefined) — the row's numbering-start end (legacy behaviour).
+     *  - `end`   — the far end of the row.
+     *  - `both`  — a label at BOTH ends.
+     *  - `none`  — hidden (kept coherent with `visible: false`).
+     * A free-drag `position` overrides the preset (the designer shows a 'custom'
+     * state). Ignored for sections (they use `position`/`visible` only).
+     */
+    positionPreset?: 'start' | 'end' | 'both' | 'none';
 }
 /** Brand/venue theming — applied by the renderer in both designer and picker. */
 interface ChartTheme {
@@ -212,6 +222,12 @@ interface RowObject {
     label: string;
     /** Buyer-facing row name. `label` remains the legacy inventory prefix. */
     displayLabel?: string;
+    /**
+     * Buyer-facing type word override (seats.io "Displayed type"). Replaces the
+     * hardcoded "Row" in the picker tooltip/confirm/cart, e.g. "Table", "Bench",
+     * "Aisle". ≤24 chars; absent = the default "Row". Pure presentation.
+     */
+    displayType?: string;
     labelPresentation?: LabelPresentation;
     /** Position of the FIRST seat. */
     origin: Point;
@@ -263,15 +279,42 @@ interface RowObject {
         rowIndex: number;
         segmentIndex: number;
     };
-    /** First seat number (default 1). */
+    /** First seat number (default 1). Roman/letters read it as a 1-based ordinal
+     *  (start 1 → I / A). */
     seatLabelStart?: number;
-    /** Seat numbering within the row (default ltr, step 1). */
+    /** Seat numbering within the row (default decimal, ltr, step 1). */
     seatNumbering?: {
         /** ltr / rtl number from an end; `center` numbers outward from the middle
          *  (centre seat lowest — the premium-centre theatre convention). */
         direction: 'ltr' | 'rtl' | 'center';
         /** 2 = odd/even numbering (1,3,5… — start at 2 for evens). */
         step?: 1 | 2;
+        /**
+         * Label scheme for the seat NUMBER part (the row prefix is separate).
+         * Default `decimal`. Composition with `direction`/`step`/`seatLabelStart`:
+         *  - `decimal`      1,2,3         — honours direction + step + start.
+         *  - `odd`          1,3,5         — odd numbers from the first odd ≥ start.
+         *  - `even`         2,4,6         — even numbers from the first even ≥ start.
+         *  - `updown`       1,3,5,…,6,4,2 — odd-up-even-back; REPLACES direction (uses
+         *                                   physical left→right order); start shifts.
+         *  - `roman`        I,II,III      — honours direction + step + start (uppercase).
+         *  - `letters-upper` A,B,C…Z,AA   — honours direction + step + start.
+         *  - `letters-lower` a,b,c…z,aa   — honours direction + step + start.
+         * Like `step`/`direction` today, the scheme changes the seat's inventory
+         * label (its booking identity), by design.
+         */
+        scheme?: 'decimal' | 'odd' | 'even' | 'updown' | 'roman' | 'letters-upper' | 'letters-lower';
+        /** Optional prefix prepended to every seat number, e.g. 'R' → 'R1', 'R2'. */
+        prefix?: string;
+        /**
+         * End-at preset ("useEndAt"): the row's numbering ENDS at this value instead
+         * of starting at `seatLabelStart`. The start is derived so the last-numbered
+         * seat (highest position rank) lands on `endAt`, respecting the scheme's step
+         * (odd/even = 2). When set it WINS over the stored `seatLabelStart` (which is
+         * left untouched). For letters it is a 1-based number index (26 → last seat
+         * 'Z'); `updown` owns its own sequence and ignores `endAt`.
+         */
+        endAt?: number;
     };
     /**
      * Per-seat exceptions, keyed by seat index (0-based position in the row).
@@ -292,6 +335,9 @@ interface GAAreaObject {
     type: 'gaArea';
     id: string;
     label: string;
+    /** Buyer-facing type word override (seats.io "Displayed type"), ≤24 chars.
+     * Absent = the default type word. Pure presentation. */
+    displayType?: string;
     /** Closed polygon, in chart units. */
     points: Point[];
     /** Explicit aisles/pillars/cutouts excluded from the sellable GA surface. */
@@ -380,6 +426,9 @@ interface TableObject {
     id: string;
     /** e.g. "T1" — seat labels are `${label}-${n}`. */
     label: string;
+    /** Buyer-facing type word override (seats.io "Displayed type"), ≤24 chars.
+     * Absent = the default "Row"/"Table" word. Pure presentation. */
+    displayType?: string;
     center: Point;
     shape: 'round' | 'rect';
     /** Seats around the perimeter (round) or along the enabled edges (rect). */
@@ -409,6 +458,9 @@ interface BoothObject {
     type: 'booth';
     id: string;
     label: string;
+    /** Buyer-facing type word override (seats.io "Displayed type"), ≤24 chars.
+     * Absent = the default type word. Pure presentation. */
+    displayType?: string;
     center: Point;
     width: number;
     height: number;
@@ -429,6 +481,11 @@ interface SectionObject {
     label: string;
     /** Buyer-facing section name; logical/id fields remain stable. */
     displayLabel?: string;
+    /**
+     * Buyer-facing entrance/door hint shown in the picker section card
+     * ("Entrance X"). ≤40 chars; absent = no entrance line. Pure presentation.
+     */
+    entrance?: string;
     labelPresentation?: LabelPresentation;
     /**
      * Stable management/inventory identity shared by disconnected visual
@@ -1052,6 +1109,25 @@ declare const CHART_STORAGE_KEY = "seatmap.chart";
  * document into concrete seat coordinates and computes bounding boxes.
  */
 
+/**
+ * Expand a parametric row into seat positions.
+ *
+ * Straight (curve === 0): seat i sits at local (i·spacing, 0).
+ *
+ * Curved: seats lie on a circular arc. Per-seat angular step is
+ * `curve/(seatCount-1)`; radius is derived so the chord between neighbours
+ * equals seatSpacing → radius = spacing / (2·sin(step/2)). Seat 0 sits at the
+ * bottom of the arc (local origin) with the circle centre directly above it at
+ * (0,-radius); increasing index sweeps toward +x while the ends rise toward -y,
+ * i.e. positive curve is concave toward -y (a row wrapping a stage above it).
+ * Local points are then rotated by `rotation` and translated to `origin`.
+ *
+ * Numbering (labels only, never geometry): `seatNumbering.direction === 'rtl'`
+ * numbers from the far physical end; `step === 2` produces odd/even numbering
+ * (start at 1 → 1,3,5…; start at 2 → 2,4,6…).
+ */
+/** Base (pre-override) seat centre per index — shared by expandRow + designer edit mode. */
+declare function rowSeatPositions(row: RowObject): Point[];
 /**
  * Every seat slot of a row INCLUDING skipped ones (designer seat-edit mode uses
  * this to draw un-skip handles). Overrides (dx/dy/label/categoryKey) are applied
@@ -1071,6 +1147,12 @@ interface RowSeatSlot {
     viewUrl?: string;
     labelStyle?: LabelStyle;
 }
+/**
+ * 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`.
+ */
+declare function seatLabelPart(row: RowObject, i: number): string;
 declare function expandRowSlots(row: RowObject): RowSeatSlot[];
 declare function expandRow(row: RowObject): ExpandedSeat[];
 /**
@@ -1205,6 +1287,116 @@ declare function hiddenObjectIds(doc: ChartDoc, hidden: ReadonlySet<string>): Se
  */
 declare function applyHidden(doc: ChartDoc, hidden: ReadonlySet<string>): ChartDoc;
 
+declare const RENDERED_QUALITY_REPORT_VERSION = 3;
+type RenderedEvidenceState = 'overview' | 'interaction';
+type RenderedQualityFindingCode = 'bookable-label-undersized' | 'bookable-label-contrast-low' | 'bookable-label-collision' | 'hierarchy-label-undersized' | 'hierarchy-label-contrast-low' | 'hierarchy-label-outside-section' | 'hierarchy-label-collision' | 'hierarchy-bookable-collision' | 'overview-section-category-paint' | 'overview-category-detail-visible' | 'overview-row-hints-visible' | 'overview-availability-clutter' | 'overview-ga-detail-visible' | 'free-text-undersized' | 'free-text-contrast-low' | 'free-text-collision' | 'free-text-bookable-collision' | 'free-text-hierarchy-collision' | 'ga-contrast-low' | 'detail-rung-missing' | 'detail-inventory-not-visible' | 'pointer-target-undersized' | 'pointer-target-inactive' | 'selected-state-missing' | 'selected-state-contrast-low' | 'held-state-missing' | 'booked-state-missing' | 'status-state-indistinct' | 'section-focus-missing' | 'category-filter-missing' | 'category-filter-ineffective' | 'target-category-not-visible' | 'target-category-filter-mismatch';
+interface RenderedQualitySample {
+    primaryId: string;
+    primaryLabel: string;
+    secondaryId?: string;
+    secondaryLabel?: string;
+    measured?: number;
+    minimum?: number;
+}
+interface RenderedQualityFinding {
+    code: RenderedQualityFindingCode;
+    message: string;
+    count: number;
+    samples: RenderedQualitySample[];
+}
+interface RenderedQualityReport {
+    version: typeof RENDERED_QUALITY_REPORT_VERSION;
+    passed: boolean;
+    state: RenderedEvidenceState;
+    /** Server-selected category exercised by a category-specific detail scene. */
+    targetCategoryKey: string | null;
+    /** Exact overview checks discharged by this browser-rendered report. */
+    resolvedRules: string[];
+    viewport: {
+        width: number;
+        height: number;
+    };
+    canvasBackground: string;
+    effectiveScale: number;
+    rung: RendererQualityEvidence['rung'];
+    inventory: {
+        totalBookableUnits: number;
+        totalLabelledBookableUnits: number;
+        visibleBookableLabels: number;
+        hiddenBookableLabels: number;
+        visibleHierarchyLabels: number;
+        visibleFreeTextLabels: number;
+        visibleGAAreas: number;
+    };
+    overviewStyle?: RendererQualityEvidence['overviewStyle'];
+    /**
+     * Coordinate-free identity evidence from the exact buyer scene. The Worker
+     * uses this to compare persisted reference semantics with what Chromium
+     * actually painted, without exposing screen boxes or accepting geometry.
+     */
+    composition: {
+        hierarchy: Array<{
+            id: string;
+            kind: 'section' | 'zone';
+            label: string;
+            visible: boolean;
+        }>;
+        labelledObjects: Array<{
+            objectId: string;
+            kind: RenderedFreeTextEvidence['kind'];
+            text: string;
+            visible: boolean;
+        }>;
+        gaAreas: Array<{
+            areaId: string;
+            label: string;
+            categoryKey: string;
+            sectionId?: string;
+            visible: boolean;
+        }>;
+        bookableSectionIds: string[];
+        categoryKeys: string[];
+        /** Categories whose non-dimmed bookable paint is visible in this scene. */
+        activeCategoryKeys: string[];
+    };
+    metrics: {
+        minimumRenderedBookableLabelPx: number | null;
+        minimumBookableLabelContrast: number | null;
+        minimumRenderedHierarchyLabelPx: number | null;
+        minimumHierarchyLabelContrast: number | null;
+        minimumRenderedFreeTextPx: number | null;
+        minimumFreeTextContrast: number | null;
+        minimumGAContrast: number | null;
+        minimumEffectivePointerTargetPx: number | null;
+        selectedRingContrast: number | null;
+    };
+    interaction: {
+        applicable: {
+            detail: boolean;
+            pointer: boolean;
+            held: boolean;
+            booked: boolean;
+            sectionFocus: boolean;
+            categoryFilter: boolean;
+        };
+        selectedUnits: number;
+        heldUnits: number;
+        bookedUnits: number;
+        activePointerTargets: number;
+        focusedSectionId: string | null;
+        focusBackdropVisible: boolean;
+        categoryFilterKeys: string[] | null;
+    };
+    findings: RenderedQualityFinding[];
+}
+/**
+ * Inspect what the buyer renderer actually decided to paint at one exact
+ * viewport. This is deliberately downstream of ChartDoc validation: screen
+ * size, LOD visibility, fitted hierarchy text, transient paint, and label
+ * collisions cannot be proven from stored geometry alone.
+ */
+declare function inspectRenderedQualityEvidence(evidence: RendererQualityEvidence, state?: RenderedEvidenceState, targetCategoryKey?: string | null): RenderedQualityReport;
+
 /**
  * SeatmapRenderer — the shared canvas rendering core (buyer picker shell).
  *
@@ -1238,6 +1430,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private boothLabelById;
     /** Viewport seat labels are rebuilt after each settled camera change. */
     private seatLabelById;
+    /** Coloured accommodation ring per accessible seat (few per chart). */
+    private accessRingById;
+    /** Centred accessibility glyph per accessible seat — shown once the seat is
+     *  big enough on-screen (see {@link SEAT_GLYPH_MIN_PX}); the ring is the
+     *  smaller-zoom fallback. Kept in a map so zoom toggles touch only the handful
+     *  of accessible seats, never all 13k nodes. */
+    private accessGlyphById;
+    /** Whether the accessibility glyph is legible at the current camera scale. */
+    private accessGlyphVisible;
     /** Authored free-text nodes obey the same rendered-size visibility floor. */
     private freeTextById;
     /** Stage/rink landmarks retain a readable screen-space caption at overview. */
@@ -1503,6 +1704,26 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderSeats;
     /** A booth renders as a click-selectable rounded block (dims from the doc). */
     private renderBoothUnit;
+    /**
+     * Build the centred accessibility glyph for a seat. Sized relative to the seat
+     * radius (so it always fills the marker at any zoom) and given a contrast-aware
+     * fill against the seat's paint — recomputed per state in {@link paintSeat}.
+     */
+    private buildAccessGlyph;
+    /**
+     * Toggle the accessibility glyphs for the current camera scale: shown once the
+     * effective on-screen seat radius clears {@link SEAT_GLYPH_MIN_PX}, otherwise
+     * hidden so only the ring remains. Iterates the (small) accessible-seat set,
+     * never the full node graph, so it is cheap to call on every view change.
+     */
+    private updateAccessGlyphs;
+    /**
+     * Whether an accessible seat's glyph should show for its current status. It is
+     * hidden on seats a buyer cannot take (sold, or another buyer's hold) where the
+     * overlay status cue (diagonal mark / lock) carries the state instead — mirrors
+     * the `unavailable` test in {@link updateLabels} so the two never collide.
+     */
+    private accessGlyphEligible;
     /** The category's display color — Okabe-Ito hue when colorblind-safe is on. */
     private seatBaseColor;
     /** Per-seat authored label size relative to the neutral default (1 = default),
@@ -1770,6 +1991,9 @@ declare function createRenderer(container: HTMLDivElement, opts?: RendererOption
 interface PickerSeat {
     id: string;
     label: string;
+    /** Buyer-facing label (row `displayLabel` applied). Falls back to `label`;
+     *  never use for booking — `label` is the inventory/booking identity. */
+    displayLabel?: string;
     categoryKey: string;
     /** Price for the chosen tier when the category has tiers, else the base price. */
     price: number;
@@ -1796,6 +2020,9 @@ interface SeatHoverDetails extends PickerSeat {
     sectionLabel?: string;
     rowLabel?: string;
     seatNumber?: string;
+    /** Buyer-facing type word for the row/table (seats.io "Displayed type"),
+     *  overriding the default "Row" in tooltip/confirm/cart. Absent = "Row". */
+    rowType?: string;
 }
 interface HoldConflict {
     label: string;
@@ -1829,6 +2056,8 @@ interface SectionSummary {
     label: string;
     /** Zone label (from ChartDoc.zones); '' when the section has no zone. */
     zoneLabel: string;
+    /** Buyer-facing entrance/door hint ("Entrance X"); absent when unset. */
+    entrance?: string;
     /** Mix/section colour for the card's dot (section.color → zone colour → dominant category). */
     color: string;
     /** Free member seats right now. */
@@ -2344,4 +2573,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-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 };
+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, RENDERED_QUALITY_REPORT_VERSION, type ReferenceAccessibilitySource, type ReferenceCalibration, type ReferenceCategorySource, type ReferenceDerivedScale, type ReferenceInventoryExclusionSource, type ReferenceInventorySource, type RenderedBookableLabelEvidence, type RenderedEvidenceState, type RenderedFreeTextEvidence, type RenderedGAAreaEvidence, type RenderedHierarchyLabelEvidence, type RenderedLabelHiddenReason, type RenderedQualityFinding, type RenderedQualityFindingCode, type RenderedQualityReport, type RenderedQualitySample, 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, inspectRenderedQualityEvidence, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, pointInPolygonWithHoles, polygonLabelPoint, resolveLocale, rowSeatPositions, seatLabelPart, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };