@seatmap.pro/renderer 1.59.3 → 1.60.1

package/lib/index.d.ts

@@ -78,6 +78,25 @@ interface IBaseSector {
      * Whether the sector is currently selected.
      */
     selected?: boolean;
+    /**
+     * Shape metadata for the sector (GA section shapes with text, color, etc.)
+     */
+    shapes?: ReadonlyArray<IShapeMetadata>;
+}
+/**
+ * Shape metadata from the API response.
+ */
+interface IShapeMetadata {
+    id?: string;
+    text?: string;
+    textColor?: string;
+    textPosition?: string;
+    width?: number;
+    height?: number;
+    top?: number;
+    left?: number;
+    angle?: number;
+    order?: number;
 }
 /**
  * Interface representing the schema data transfer object from the API.
@@ -122,8 +141,7 @@ interface IPlainSeatsDTO {
  * Contains the core properties of a seat as received from the backend.
  * @hidden
  */
-interface ISeatDTO extends IBaseSeat {
-}
+type ISeatDTO = IBaseSeat;
 /**
  * Interface representing a row in the venue.
  * @hidden
@@ -140,8 +158,7 @@ interface IRowDTO {
  * Contains the core properties of a sector as received from the backend.
  * @hidden
  */
-interface ISectorDTO extends IBaseSector {
-}
+type ISectorDTO = IBaseSector;
 /**
  * Interface representing the SVG background data transfer object from the API.
  * @hidden
@@ -437,22 +454,20 @@ interface IDragSrcEvent<T> {
     };
     shiftKey?: boolean;
     altKey?: boolean;
+    metaKey?: boolean;
 }
 /**
  * @hidden
  */
-interface IDragStartSrcEvent extends IDragSrcEvent<SrcEventType.DRAG_START> {
-}
+type IDragStartSrcEvent = IDragSrcEvent<SrcEventType.DRAG_START>;
 /**
  * @hidden
  */
-interface IDragMoveSrcEvent extends IDragSrcEvent<SrcEventType.DRAG_MOVE> {
-}
+type IDragMoveSrcEvent = IDragSrcEvent<SrcEventType.DRAG_MOVE>;
 /**
  * @hidden
  */
-interface IDragEndSrcEvent extends IDragSrcEvent<SrcEventType.DRAG_END> {
-}
+type IDragEndSrcEvent = IDragSrcEvent<SrcEventType.DRAG_END>;
 /**
  * @hidden
  */
@@ -467,6 +482,7 @@ interface IClickSrcEvent {
     seat?: ISeat;
     shiftKey?: boolean;
     altKey?: boolean;
+    metaKey?: boolean;
 }
 /**
  * @hidden
@@ -521,6 +537,7 @@ interface IRectSelectDestEvent {
     isStart?: boolean;
     isFinish?: boolean;
     isRowsMode?: boolean;
+    isSectionsMode?: boolean;
     rect: {
         x: number;
         y: number;
@@ -614,6 +631,7 @@ interface ISectionClickDestEvent {
         y: number;
     };
     section: ISection;
+    isSectionsMode?: boolean;
 }
 
 /**
@@ -624,6 +642,7 @@ interface IGaInfo {
     name: string;
     transform: TransformArray;
     isTable?: boolean;
+    textColor?: string;
 }
 /**
  * @hidden
@@ -871,6 +890,14 @@ interface ISection {
      * The type of the section.
      */
     type?: string | null;
+    /**
+     * The total number of seats in the section.
+     */
+    seatCount?: number;
+    /**
+     * Text color for the section label (e.g., GA section name).
+     */
+    textColor?: string;
 }
 /**
  * Visual and interaction states that can be applied to entities
@@ -1686,6 +1713,15 @@ interface IRendererSettings {
      * Section is passed as a param to the handler (see ISection).
      */
     onSectionClick?: (section: ISection) => void;
+    /**
+     * Fires after section selection was updated in selectSections mode.
+     *
+     * @remarks
+     *
+     * Called with the full array of currently selected sections after any
+     * selection change (single click toggle or rect drag selection).
+     */
+    onSectionsSelectionChange?: (sections: ISection[]) => void;
     /**
      * Fires before the zoom animation started.
      */
@@ -1897,6 +1933,11 @@ declare class OutlineLayer {
     constructor(context: Context);
     destroy(): void;
     applyOutlineAttributes(element: Element, source: OutlineSource, section: ISector): void;
+    /**
+     * Apply per-section textColor from shape metadata to text path elements.
+     * Inline style overrides the generic CSS theme color.
+     */
+    private applyShapeTextColor;
     setOutlineStates(id: number | undefined, states: OutlineStates | null): void;
     getOutlineStates(id: number): IEntityStates | undefined;
     highlightSection(id?: number, clear?: boolean): void;
@@ -1988,7 +2029,7 @@ interface IStageLayer {
     redraw: () => void;
     drawOffscreenCanvas: () => void;
     drawOnscreenCanvas: (scale: number, translate: IPoint) => void;
-    getVisibleSeats: () => any[];
+    getVisibleSeats: () => ISeat[];
     updateSize: () => void;
     sectionViewActive: boolean;
     getAnimationState: () => {
@@ -2007,61 +2048,6 @@ interface IStageLayer {
     captureSeatmap: () => Promise<HTMLImageElement | null>;
 }
 
-/**
- * @hidden
- */
-interface IRendererAnimation {
-    /**
-     * Optional animation type hint to allow branching behavior in the renderer
-     * - "transform": default zoom/pan animations using scale/translate
-     * - "pan": dedicated pan animation using translate only
-     * - "rotation": continuous 3D rotation animation
-     */
-    type?: 'transform' | 'pan' | 'rotation';
-    startTime?: number;
-    duration: number;
-    fromScale: number;
-    toScale: number;
-    fromTranslate?: IPoint;
-    translate?: IPoint;
-    toTranslate: IPoint;
-    relativeTranslate?: IPoint;
-    frame: number;
-    inProgress: boolean;
-    /**
-     * Custom per-frame handler used for non-transform animations (e.g., rotation)
-     * Receives high-resolution time and elapsed milliseconds since start
-     */
-    onFrame?: (now: number, elapsedMs: number) => void;
-    /**
-     * When true, the animation never auto-finishes and must be explicitly stopped
-     */
-    isContinuous?: boolean;
-    /**
-     * Rotation-specific fields used when type === 'rotation'
-     */
-    angle?: number;
-    lastRotationZ?: number;
-    /**
-     * 3D transform interpolation fields for combined animations
-     */
-    fromRotationZ?: number;
-    toRotationZ?: number;
-    fromTiltX?: number;
-    toTiltX?: number;
-    fromPerspectiveZ?: number;
-    toPerspectiveZ?: number;
-    /** Called once when the animation finishes */
-    onComplete?: () => void;
-}
-interface IRendererSequenceStep {
-    zoomTo?: number;
-    destination?: IPoint;
-    rotateTo?: number;
-    tiltTo?: number;
-    perspectiveTo?: number;
-    durationMs?: number;
-}
 /**
  * Interface for the base Renderer functionality.
  * Defines the core methods and properties that all renderer implementations must provide.
@@ -2275,8 +2261,6 @@ interface IRenderer {
     clearMarkers: () => void;
     getMarkers: () => IMarker[];
     getResolvedMarkers: () => IResolvedMarker[];
-}
-interface IRenderer {
     /**
      * Runs a sequence of composite animations. Each step can include zoom, pan (via destination), and rotation.
      */
@@ -2290,6 +2274,61 @@ interface IRenderer {
         durationMs?: number;
     }) => void;
 }
+/**
+ * @hidden
+ */
+interface IRendererAnimation {
+    /**
+     * Optional animation type hint to allow branching behavior in the renderer
+     * - "transform": default zoom/pan animations using scale/translate
+     * - "pan": dedicated pan animation using translate only
+     * - "rotation": continuous 3D rotation animation
+     */
+    type?: 'transform' | 'pan' | 'rotation';
+    startTime?: number;
+    duration: number;
+    fromScale: number;
+    toScale: number;
+    fromTranslate?: IPoint;
+    translate?: IPoint;
+    toTranslate: IPoint;
+    relativeTranslate?: IPoint;
+    frame: number;
+    inProgress: boolean;
+    /**
+     * Custom per-frame handler used for non-transform animations (e.g., rotation)
+     * Receives high-resolution time and elapsed milliseconds since start
+     */
+    onFrame?: (now: number, elapsedMs: number) => void;
+    /**
+     * When true, the animation never auto-finishes and must be explicitly stopped
+     */
+    isContinuous?: boolean;
+    /**
+     * Rotation-specific fields used when type === 'rotation'
+     */
+    angle?: number;
+    lastRotationZ?: number;
+    /**
+     * 3D transform interpolation fields for combined animations
+     */
+    fromRotationZ?: number;
+    toRotationZ?: number;
+    fromTiltX?: number;
+    toTiltX?: number;
+    fromPerspectiveZ?: number;
+    toPerspectiveZ?: number;
+    /** Called once when the animation finishes */
+    onComplete?: () => void;
+}
+interface IRendererSequenceStep {
+    zoomTo?: number;
+    destination?: IPoint;
+    rotateTo?: number;
+    tiltTo?: number;
+    perspectiveTo?: number;
+    durationMs?: number;
+}
 
 type DataManagerEvent = 'sectionsChanged' | 'seatsChanged' | 'dataInvalidated' | 'dataLoaded';
 type DataManagerEventCallback = (entityId?: number) => void;
@@ -2710,7 +2749,7 @@ declare class Renderer implements IRenderer {
      *
      * @param ids Array of internal seat IDs
      */
-    enableSeatsByIds(ids: number[]): void;
+    enableSeatsByIds(_ids: number[]): void;
     /**
      * Marks seats as unavailable and removes them from cart.
      *
@@ -2772,7 +2811,7 @@ declare class Renderer implements IRenderer {
      */
     getSeatSelection(): IExtendedSeat[];
     setSectionSelection(sections?: number[] | string[]): void;
-    getSvgSectionBySelection(): ISectorDTO[];
+    getSvgSectionBySelection(): IBaseSector[];
     disableSvgSectionsByIds(ids: number[], options?: {
         resetAll?: boolean;
     }): void;
@@ -2813,7 +2852,7 @@ declare class Renderer implements IRenderer {
      *
      * @returns Row data
      */
-    getRowById(id: number): IRowDTO;
+    getRowById(id: number): IRowDTO | undefined;
     /**
      * Returns only visible seats with coords relative to canvas
      */
@@ -2821,9 +2860,12 @@ declare class Renderer implements IRenderer {
     getSectionsWithCoords(): ISectionWithCoords[];
     private handleDestPan;
     private handleDestRectSelect;
+    private handleRectSelectSections;
+    private fireSelectedSections;
     private handleDestDeselect;
     private getGaSectionByOutline;
     private getSectionByOutline;
+    private buildSectionFromId;
     private getSectorRectByOutline;
     /**
      * Handles pan-zoom destination events from the state machine.
@@ -3021,7 +3063,7 @@ interface IAdminRendererSettings extends IRendererSettings {
  * Extends the base Renderer with admin-specific functionality.
  */
 declare class SeatmapAdminRenderer extends Renderer {
-    static readonly VERSION = "1.59.3";
+    static readonly VERSION = "1.60.1";
     protected apiClient: BookingApiClient;
     /**
      * Creates a new instance of the AdminRenderer.
@@ -3062,8 +3104,13 @@ declare class SeatmapAdminRenderer extends Renderer {
     /**
      * Sets the interaction mode for the component and updates visibility of the outline layer.
      *
-     * @param mode - The interaction mode to set. When set to 'pan', the outline layer is hidden.
-     * For any other mode, the outline layer is shown.
+     * @param mode - The interaction mode to set:
+     *   - 'pan': Pan/zoom navigation, outline layer hidden
+     *   - 'select': Seat selection (click/drag), GA section click supported
+     *   - 'selectRows': Row-based seat selection
+     *   - 'selectSections': Section-level click (fires onSectionClick for all section types)
+     *
+     * When set to 'pan', the outline layer is hidden. For any other mode, the outline layer is shown.
      *
      * @returns A boolean indicating whether the mode change was successful.
      * Returns true if the outline layer exists and the mode was set.
@@ -3074,8 +3121,11 @@ declare class SeatmapAdminRenderer extends Renderer {
      * // Set mode to 'pan' - will hide outline layer
      * component.setMode('pan');
      *
-     * // Set mode to 'select' - will show outline layer
+     * // Set mode to 'select' - will show outline layer, seat-level interactions
      * component.setMode('select');
+     *
+     * // Set mode to 'selectSections' - section clicks fire onSectionClick for all sections
+     * component.setMode('selectSections');
      * ```
      */
     setMode(mode: string): boolean;
@@ -3175,7 +3225,7 @@ interface IBookingRendererSettings extends IRendererSettings {
  * Extends the base Renderer with booking-specific functionality.
  */
 declare class SeatmapBookingRenderer extends Renderer {
-    static readonly VERSION = "1.59.3";
+    static readonly VERSION = "1.60.1";
     private apiClient;
     private stats;
     private tags?;
@@ -3263,7 +3313,7 @@ declare class SeatmapBookingRenderer extends Renderer {
  * Package version information
  * This file is automatically updated during the build process
  */
-declare const VERSION = "1.59.3";
+declare const VERSION = "1.60.1";
 
 declare const defaultZoomSettings: IZoomSettings;
 declare const mergeSettings: (defaults: IRendererSettings, settings?: Partial<IRendererSettings>) => IRendererSettings & Partial<IRendererSettings>;
@@ -3306,4 +3356,4 @@ declare class RotationAnimation {
     getAnimation(): IRotationAnimation | null;
 }
 
-export { BookingApiClient, type ById, type ColorById, type ColorSequenceSettings, DataManager, type DataManagerEvent, type DataManagerEventCallback, type DeepPartial, type DestEvent, DestEventType, type IAdminRendererSettings, type IBackgroundImageLoadedEvent, type IBaseSeat, type IBaseSector, type IBasicSeatStyle, type IBeforeSeatDrawEvent, type IBookingRendererSettings, type ICart, type ICartGa, type ICartSeat, type IClickSrcEvent, type IColoredPrice, type IConfigurationDTO, type IDeselectDestEvent, type IDragEndSrcEvent, type IDragMoveSrcEvent, type IDragStartSrcEvent, type IEntityStates, type IExtendedSeat, type ILoadProgressEvent, type ILoaderSettings, type ILoaderTheme, type IMarker, type IMarkerSettings, type IMinimapSettings, type IMouseMoveSrcEvent, type IPanDestEvent, type IPanZoomDestEvent, type IPlainSeatsDTO, type IPngBackgroundDTO, type IPoint, type IPrice, type IPriceDTO, type IPriceId, type IPriceListDTO, type IRectSelectDestEvent, type IRemovedCartGa, type IRenderer, type IRendererAnimation, type IRendererMachineContext, type IRendererSeatStyleSettings, type IRendererSettings, type IRendererSvgSectionStylesSetting, type IRendererTheme, type IResolvedMarker, type IRowDTO, type ISVGBackgroundDTO, type ISchemaDTO, type ISeat, type ISeatCartSwitchDestEvent, type ISeatDTO, type ISeatMetadata, type ISeatMouseEnterDestEvent, type ISeatMouseLeaveDestEvent, type ISeatPriceScheme, type ISeatSelectDestEvent, type ISeatStyle, type ISection, type ISectionClickDestEvent, type ISectionMetadata, type ISectionMouseEnterDestEvent, type ISectionMouseLeaveDestEvent, type ISectionRect, type ISectionWithCoords, type ISector, type ISectorDTO, type ISpecialPrice, type ISpecialState, type ISvgSectionStyle, type IVenueDTO, type IVisibilitySettings, type IZoomSettings, type InteractionZoomStrategy, type InteractionZoomStrategyType, type LoaderStyle, type LoadingPhase, type MarkerAppearance, type MarkerTarget, type MinimapPosition, type Nullable, Renderer, type RendererMachine, type RendererMachineReducer, type RendererMachineService, RendererSelectMode, RendererTargetType, type RequestMetrics, RotationAnimation, type SeatFilter, type SeatInteractionState, SeatmapAdminRenderer, SeatmapBookingRenderer, type SrcEvent, SrcEventType, StateManager, type StateManagerEvent, type StateManagerEventCallback, type TransformArray, VERSION, convertPricesToColored, convertPricesToColoredById, defaultZoomSettings, mergeSettings, sortPrices };
+export { BookingApiClient, type ById, type ColorById, type ColorSequenceSettings, DataManager, type DataManagerEvent, type DataManagerEventCallback, type DeepPartial, type DestEvent, DestEventType, type IAdminRendererSettings, type IBackgroundImageLoadedEvent, type IBaseSeat, type IBaseSector, type IBasicSeatStyle, type IBeforeSeatDrawEvent, type IBookingRendererSettings, type ICart, type ICartGa, type ICartSeat, type IClickSrcEvent, type IColoredPrice, type IConfigurationDTO, type IDeselectDestEvent, type IDragEndSrcEvent, type IDragMoveSrcEvent, type IDragStartSrcEvent, type IEntityStates, type IExtendedSeat, type ILoadProgressEvent, type ILoaderSettings, type ILoaderTheme, type IMarker, type IMarkerSettings, type IMinimapSettings, type IMouseMoveSrcEvent, type IPanDestEvent, type IPanZoomDestEvent, type IPlainSeatsDTO, type IPngBackgroundDTO, type IPoint, type IPrice, type IPriceDTO, type IPriceId, type IPriceListDTO, type IRectSelectDestEvent, type IRemovedCartGa, type IRenderer, type IRendererAnimation, type IRendererMachineContext, type IRendererSeatStyleSettings, type IRendererSettings, type IRendererSvgSectionStylesSetting, type IRendererTheme, type IResolvedMarker, type IRowDTO, type ISVGBackgroundDTO, type ISchemaDTO, type ISeat, type ISeatCartSwitchDestEvent, type ISeatDTO, type ISeatMetadata, type ISeatMouseEnterDestEvent, type ISeatMouseLeaveDestEvent, type ISeatPriceScheme, type ISeatSelectDestEvent, type ISeatStyle, type ISection, type ISectionClickDestEvent, type ISectionMetadata, type ISectionMouseEnterDestEvent, type ISectionMouseLeaveDestEvent, type ISectionRect, type ISectionWithCoords, type ISector, type ISectorDTO, type IShapeMetadata, type ISpecialPrice, type ISpecialState, type ISvgSectionStyle, type IVenueDTO, type IVisibilitySettings, type IZoomSettings, type InteractionZoomStrategy, type InteractionZoomStrategyType, type LoaderStyle, type LoadingPhase, type MarkerAppearance, type MarkerTarget, type MinimapPosition, type Nullable, Renderer, type RendererMachine, type RendererMachineReducer, type RendererMachineService, RendererSelectMode, RendererTargetType, type RequestMetrics, RotationAnimation, type SeatFilter, type SeatInteractionState, SeatmapAdminRenderer, SeatmapBookingRenderer, type SrcEvent, SrcEventType, StateManager, type StateManagerEvent, type StateManagerEventCallback, type TransformArray, VERSION, convertPricesToColored, convertPricesToColoredById, defaultZoomSettings, mergeSettings, sortPrices };