@seatmap.pro/renderer 1.69.10 → 1.70.0

package/lib/index.d.ts

@@ -25,6 +25,16 @@ interface IBaseSeat {
      * The Y coordinate of the seat within its section.
      */
     y: number;
+    /**
+     * Untransformed grid X coordinate of the seat, relative to its section.
+     * Populated on demand for a single section during block selection.
+     */
+    ix?: number;
+    /**
+     * Untransformed grid Y coordinate of the seat, relative to its section.
+     * Populated on demand for a single section during block selection.
+     */
+    iy?: number;
     /**
      * The name or number of the seat.
      */
@@ -121,6 +131,7 @@ interface IShapeMetadata {
     order?: number;
     fontScale?: number;
 }
+type BrandingLevel = 'watermark' | 'interrupted';
 /**
  * Interface representing the schema data transfer object from the API.
  * @hidden
@@ -136,6 +147,7 @@ interface ISchemaDTO {
     configuration?: IConfigurationDTO;
     instanceId?: string;
     componentVersion?: string;
+    branding?: BrandingLevel;
 }
 /**
  * Interface representing the venue data transfer object from the API.
@@ -161,6 +173,17 @@ interface IPlainSeatsDTO {
     sectorIds: [];
     names: string[];
 }
+/**
+ * Untransformed grid coordinates for the seats of a single section, fetched on
+ * demand. The arrays are aligned by index: seat `ids[i]` sits at grid cell
+ * (`ix[i]`, `iy[i]`).
+ * @hidden
+ */
+interface ISectionGridDTO {
+    ids: number[];
+    ix: number[];
+    iy: number[];
+}
 /**
  * Interface representing the base seat data transfer object from the API.
  * Contains the core properties of a seat as received from the backend.
@@ -183,7 +206,14 @@ interface IRowDTO {
  * Contains the core properties of a sector as received from the backend.
  * @hidden
  */
-type ISectorDTO = IBaseSector;
+type ISectorDTO = Omit<IBaseSector, 'labelStyle'> & {
+    /**
+     * Label style overrides as sent by the API: a JSON string (SEAT-624 wire format).
+     * Normalize with `withParsedLabelStyle` before putting a sector into the renderer
+     * context, which types it as the parsed {@link ILabelStyle} object (SEAT-1069).
+     */
+    labelStyle?: string | ILabelStyle;
+};
 /**
  * Interface representing the SVG background data transfer object from the API.
  * @hidden
@@ -282,6 +312,19 @@ type IPngFromUrl = {
     path: string;
     status: string;
 };
+/**
+ * Type representing the tile grid sliced from the full-size background.
+ * @hidden
+ */
+type ITileGrid = {
+    size: number;
+    cols: number;
+    rows: number;
+    width: number;
+    height: number;
+    path: string;
+    status: string;
+};
 /**
  * Interface representing PNG background images in different resolutions.
  * @hidden
@@ -290,6 +333,8 @@ interface IPngBackgroundDTO {
     blurred: IBlurred;
     preview: IPngFromUrl;
     full: IPngFromUrl;
+    tiles?: ITileGrid;
+    lods?: IPngFromUrl[];
 }
 
 /**
@@ -343,6 +388,18 @@ declare class BookingApiClient {
      * @param eventId Event GUID
      */
     fetchSchemaForEvent(eventId: string): Promise<ISchemaDTO>;
+    /**
+     * Returns the untransformed grid coordinates for a single section of an event's schema.
+     * @param eventId Event GUID
+     * @param sectorId Section (sector) id
+     */
+    fetchSectionGridForEvent(eventId: string, sectorId: number): Promise<ISectionGridDTO>;
+    /**
+     * Returns the untransformed grid coordinates for a single section of a schema.
+     * @param schemaId Schema id
+     * @param sectorId Section (sector) id
+     */
+    fetchSectionGridForSchema(schemaId: number, sectorId: number): Promise<ISectionGridDTO>;
     private unpackSchemaDTO;
     /**
      * Return prices information
@@ -364,7 +421,6 @@ declare class BookingApiClient {
      * @param url Relative API endpoint URL, e.g. 'event/prices/?id=XXX'
      */
     requestPlain<T extends RequestMetrics>(url: string): Promise<T>;
-    private restoreSeats;
     private restoreIds;
 }
 
@@ -415,6 +471,8 @@ interface IVisibilityStatuses {
  */
 interface IRendererMachineContext {
     mode?: string;
+    temporaryPan?: boolean;
+    viewportLocked?: boolean;
     scale: number;
     isEagleView: boolean;
     events: DestEvent[];
@@ -746,12 +804,21 @@ declare class Context {
     rotationZ: number;
     perspectiveZ: number;
     tiltX: number;
+    viewportLocked: boolean;
     private _seats;
     seatsIndex: KDBush;
+    flattenBackup: Map<number, {
+        x: number;
+        y: number;
+    }> | null;
+    flattenedSectionId: number | null;
     seatsById: ById<ISeat>;
     seatsByRowId: {
         [rowId: number]: ISeat[];
     };
+    seatsBySectionId: {
+        [sectionId: number]: ISeat[];
+    };
     rowsById: ById<IRowDTO>;
     sectionsById: ById<ISector>;
     pricesById: ById<IColoredPrice>;
@@ -772,6 +839,8 @@ declare class Context {
     private _pricesDTO;
     private _selectedSeatIds;
     private _selectedGaId?;
+    private _sectionsByName?;
+    private _rowsByKey?;
     underlay: {
         svgString?: Nullable<string>;
         viewBox: {
@@ -793,6 +862,8 @@ declare class Context {
     _deselectedAt: {
         [seatId: number]: number;
     };
+    overlayVersion: number;
+    bumpOverlayVersion(): void;
     constructor(element: HTMLElement, settings: IRendererSettings, redrawHandler: () => void);
     set selectedSeatIds(value: number[]);
     get selectedSeatIds(): number[];
@@ -812,6 +883,10 @@ declare class Context {
     initCart(cart: ICart): void;
     get seats(): ISeat[];
     set seats(value: ISeat[]);
+    rangeSeats(x1: number, y1: number, x2: number, y2: number): ISeat[];
+    rebuildSeatsIndex(): void;
+    replaceSeatsPreservingPositions(value: ISeat[]): void;
+    private rebuildSeatLookups;
     getPositionByOffset: (offset: IPoint) => IPoint;
     getOffsetByPosition: (position: IPoint) => IPoint;
     addGaToCart(ga: ICartGa): void;
@@ -843,8 +918,11 @@ declare class Context {
         height: number;
     }, mode: RendererSelectMode): void;
     repairSeat: (s: ICartSeat) => ICartSeat | undefined;
+    private uniquePriceForAmount;
     afterCartUpdate: () => void;
     repairGa: (ga: ICartGa) => ICartGa | undefined;
+    private getSectionByName;
+    private getRowBySectionAndNumber;
     findSeatByKey(key: string): ISeat | undefined;
     getCart(): ICart;
     isSeatInCart(seatId: number): boolean;
@@ -875,6 +953,23 @@ declare class Context {
     }) => ISeat | undefined;
 }
 
+type HotkeysSetting = false | Partial<Record<string, string | null>>;
+
+/**
+ * Outline source meaning:
+ * - svg: bound to the background svg
+ * - fallback: fallback outline generated from seats
+ * - shape: editor-made basic shapes
+ * - auto: editor-generated outline
+ */
+type OutlineSource = 'svg' | 'shape' | 'auto' | 'fallback';
+interface OutlineStates {
+    highlighted?: boolean;
+    selected?: boolean;
+    unavailable?: boolean;
+    filtered?: boolean;
+}
+
 type Nullable<T> = T | null | undefined;
 type DeepPartial<T> = T extends object ? {
     [P in keyof T]?: DeepPartial<T[P]>;
@@ -959,7 +1054,8 @@ interface ISection {
      */
     rect: ISectionRect;
     /**
-     * The price for the section.
+     * The price for the section, parsed as a number from its price label.
+     * Preserves decimals (e.g. `12.5`) and is undefined when the label is non-numeric.
      */
     price?: number;
     priceId?: IPriceId;
@@ -1061,7 +1157,8 @@ interface ISectionWithCoords {
      */
     rect: ISectionRect;
     /**
-     * The price for the section.
+     * The price for the section, parsed as a number from its price label.
+     * Preserves decimals (e.g. `12.5`) and is undefined when the label is non-numeric.
      */
     price?: number | undefined;
     /**
@@ -1107,7 +1204,8 @@ interface ICartSeat {
      */
     key: string;
     /**
-     * The price of the seat.
+     * The price of the seat, parsed as a number from its price label.
+     * Preserves decimals (e.g. `12.5`) and is undefined when the label is non-numeric.
      */
     price?: number;
     /**
@@ -1178,7 +1276,8 @@ interface ICartGa {
      */
     count: number;
     /**
-     * The price per GA ticket.
+     * The price per GA ticket, parsed as a number from its price label.
+     * Preserves decimals (e.g. `12.5`) and is undefined when the label is non-numeric.
      */
     price?: number;
 }
@@ -1522,6 +1621,14 @@ interface ILoaderSettings {
         genericError?: IErrorMessage;
     };
 }
+/**
+ * Configuration settings for the "Powered by Seatmap.pro" branding overlay.
+ */
+interface IWatermarkSettings {
+    position?: 'bottom-left' | 'bottom-right';
+    interruptionTitle?: string;
+    interruptionSubtitle?: string;
+}
 /**
  * Configuration settings for the renderer.
  * Defines various options that control the behavior and appearance of the renderer.
@@ -1584,6 +1691,13 @@ interface IRendererSettings {
      * Use visibilitySettings instead
      */
     seatSelectionMinZoom?: number;
+    /**
+     * Keyboard shortcut configuration. Set to `false` to disable all hotkeys,
+     * or remap/disable individual bindings by action id. Only the admin
+     * renderer currently registers hotkey bindings; setting this on a booking
+     * renderer has no effect.
+     */
+    hotkeys?: HotkeysSetting;
     /**
      * Maximum number of seats that can be selected.
      */
@@ -1689,6 +1803,7 @@ interface IRendererSettings {
      * Minimap configuration settings.
      */
     minimap?: IMinimapSettings;
+    watermark?: IWatermarkSettings;
     /**
      * Loader configuration settings.
      * Controls the loading overlay with progress bar during event loading.
@@ -2010,13 +2125,25 @@ interface IBasicSeatStyle {
 interface ISeatStyle extends IBasicSeatStyle {
     accessible?: IBasicSeatStyle;
 }
-interface IRendererSvgSectionStylesSetting {
+interface ISvgSectionStateStyles {
     default?: Pick<ISvgSectionStyle, 'sectionName' | 'stroke' | 'cursor' | 'bgColor'>;
     unavailable?: ISvgSectionStyle;
     filtered?: ISvgSectionStyle;
     hovered?: ISvgSectionStyle;
     selected?: ISvgSectionStyle;
 }
+interface IRendererSvgSectionStylesSetting extends ISvgSectionStateStyles {
+    /**
+     * Per-outline-source style overrides. Section outlines are tagged by source
+     * (`svg`, `shape`, `auto`, `fallback`); a source entry overrides the flat
+     * styles above for that source only, leaving the others on the global styles.
+     * Use it to style, for example, hover on auto-generated seat-section outlines
+     * (`fallback` / `auto`) differently from user zones (`svg`). Applies to the SVG
+     * outline styling; in WebGL overlay mode the hover ring color still comes from
+     * the flat `hovered.stroke.color`.
+     */
+    bySource?: Partial<Record<OutlineSource, ISvgSectionStateStyles>>;
+}
 interface ISvgSectionStyle {
     sectionName?: {
         color?: string;
@@ -2042,27 +2169,11 @@ interface IRendererTheme {
     svgSectionStyles?: IRendererSvgSectionStylesSetting;
 }
 
-/**
- * Outline source meaning:
- * - svg: bound to the background svg
- * - fallback: fallback outline generated from seats
- * - shape: editor-made basic shapes
- * - auto: editor-generated outline
- */
-type OutlineSource = 'svg' | 'shape' | 'auto' | 'fallback';
-interface OutlineStates {
-    highlighted?: boolean;
-    selected?: boolean;
-    unavailable?: boolean;
-    filtered?: boolean;
-}
-
 /**
  * @hidden
  */
 declare class OutlineLayer {
     svgElement: SVGSVGElement;
-    private outlineRect;
     private context;
     private originalSvg;
     private backgroundSVG;
@@ -2143,7 +2254,6 @@ declare class OutlineLayer {
     private createOrGetOutlineShapes;
     private appendFallbackOutlines;
     private appendShapeOutlines;
-    private getOutlineRects;
     createFallbackOutlineRect(section: ISector): SVGRectElement;
     private getRenderContext;
     handleChangeEagleView(isEagleView?: boolean): void;
@@ -2159,14 +2269,54 @@ declare class OutlineLayer {
     updateAnimationStep(scale: number, translate: IPoint): void;
     hide(): void;
     show(): void;
+    hideShapes(): void;
+    showShapes(): void;
     private getContextSvg;
     forceUpdate(): void;
     private apply3DTransforms;
     appendRowsOverlay(rowsFragment: string, css?: string): void;
 }
 
+/**
+ * @hidden
+ */
+declare abstract class Layer {
+    protected readonly context: Context;
+    private canvas;
+    protected ctx: CanvasRenderingContext2D;
+    protected offscreenCanvas: HTMLCanvasElement;
+    protected offscreenCtx: CanvasRenderingContext2D;
+    protected isDebug: boolean;
+    /** Physical (device-pixel) canvas width, set by updateSize */
+    physicalWidth: number;
+    /** Physical (device-pixel) canvas height, set by updateSize */
+    physicalHeight: number;
+    private lastFrameTime;
+    private spinnerAnimationId;
+    private spinnerRotation;
+    private spinningSeats;
+    constructor(context: Context);
+    get width(): number;
+    get height(): number;
+    destroy(): void;
+    updateSize(physicalWidth?: number, physicalHeight?: number): void;
+    protected redraw(): void;
+    protected abstract renderContent(): void;
+    protected _renderSeat(ctx: CanvasRenderingContext2D, seat: ISeat, style: ISeatStyle, state: SeatInteractionState): void;
+    protected drawPoint(ctx: CanvasRenderingContext2D, point: IPoint, color?: string): void;
+    drawOffscreenCanvas(): void;
+    drawOnscreenCanvas(scale: number, translate: IPoint): void;
+    protected addSpinningSeat(seatId: string): void;
+    removeSpinningSeat(seatId: string): void;
+    protected isSpinningSeat(seatId: string): boolean;
+    protected startSpinnerAnimation(): void;
+    protected renderSeat(ctx: CanvasRenderingContext2D, seat: ISeat): void;
+    protected renderHoveredSeat(ctx: CanvasRenderingContext2D, seat: ISeat): void;
+    protected renderSelectedSeat(ctx: CanvasRenderingContext2D, seat: ISeat): void;
+}
+
 interface IRendererZoomControls {
-    zoomToFit: () => void;
+    zoomToFit: () => Promise<void>;
     getSectionsWithCoords: () => ISectionWithCoords[];
 }
 interface ISectionTransform {
@@ -2176,12 +2326,80 @@ interface ISectionTransform {
     section: IPoint;
     skewAngle: number;
 }
+interface ISectionAnimation {
+    startTime?: number;
+    duration: number;
+    frame?: number;
+    skewAngle: number;
+    rotationAngle: number;
+    inProgress: boolean;
+}
+/**
+ * @hidden
+ */
+declare class SectionViewLayer extends Layer {
+    backgroundElement: HTMLImageElement;
+    protected backgroundSuppressed: boolean;
+    sectionViewActive: boolean;
+    sectionId: number | null;
+    sectionViewTransform: ISectionTransform;
+    protected _renderSeat(ctx: CanvasRenderingContext2D, seat: ISeat, style: ISeatStyle, state: SeatInteractionState): void;
+    private animation;
+    private rotationPromise?;
+    private rotationResolve?;
+    private reversePromise?;
+    private cancelPendingFrame;
+    private finishRotation;
+    drawOffscreenCanvas(): void;
+    drawOnscreenCanvas(scale: number, translate: IPoint): void;
+    redraw(): void;
+    rotationAnimation(): Promise<unknown>;
+    reverseRotationAnimation(): Promise<unknown>;
+    private setAnimateSection;
+    private setSectionCoords;
+    private setCenterPoint;
+    private setRotationAngle;
+    private getSectionUpdatedCoords;
+    getCoordsAfterRotation<T = IPoint>(point: T): T;
+    setTransformationState(state: ISectionTransform): void;
+    setAnimationState(state: ISectionAnimation): void;
+    getAnimationState(): ISectionAnimation;
+    getAnimationPoint(): {
+        x: number;
+        y: number;
+    };
+    private applySkew;
+    renderContent(): void;
+    setBackgroundSuppressed(suppressed: boolean): void;
+    /**
+     * @hidden
+     *
+     * @param section
+     *
+     * Entrypoint for the section view animation start
+     */
+    applySectionViewAnimation(section: ISectionWithCoords, options: IRendererZoomControls): Promise<boolean>;
+    resetSectionViewState(): void;
+    protected rotate(ctx: CanvasRenderingContext2D, angle: number, center: IPoint, bgImage: HTMLImageElement): void;
+}
+
+interface DetailLevel {
+    path: string;
+    width: number;
+}
+interface DetailTiles {
+    grid: ITileGrid;
+    width: number;
+    height: number;
+    levels: DetailLevel[];
+}
 
 interface IStageLayer {
     destroy: () => void;
     backgroundElement: HTMLImageElement;
     /** Full-resolution background image retained in JS heap for on-demand detail cropping (all WebGL devices). */
     fullBackgroundImage: HTMLImageElement | null;
+    detailTiles?: DetailTiles | null;
     redraw: () => void;
     drawOffscreenCanvas: () => void;
     drawOnscreenCanvas: (scale: number, translate: IPoint) => void;
@@ -2204,8 +2422,10 @@ interface IStageLayer {
     captureSeatmap: () => Promise<HTMLImageElement | null>;
     /** Notify that viewport has settled after animation -- triggers detail crop update on WebGL devices */
     onViewportSettled?: () => void;
+    setBackgroundSuppressed: (suppressed: boolean) => void;
     /** Dispose detail texture immediately -- called when animation starts to prevent stale crop flash */
     disposeDetailTexture?: () => void;
+    setTransformAnimating?: (active: boolean) => void;
 }
 
 /**
@@ -2478,8 +2698,8 @@ interface IRendererAnimation {
     toTiltX?: number;
     fromPerspectiveZ?: number;
     toPerspectiveZ?: number;
-    /** Called once when the animation finishes */
-    onComplete?: () => void;
+    /** Called once when the animation finishes; completed is false when interrupted */
+    onComplete?: (completed: boolean) => void;
 }
 interface IRendererSequenceStep {
     zoomTo?: number;
@@ -2553,6 +2773,145 @@ declare class StateManager {
     destroy(): void;
 }
 
+declare class SeatStateEngine {
+    private readonly stateBySeat;
+    private readonly seatsByState;
+    setState(seatIds: number[], stateKey: string): void;
+    clearState(seatIds: number[]): void;
+    clearAll(): void;
+    getState(seatId: number): string | undefined;
+    hasAny(): boolean;
+    getAssignedSeatIds(): number[];
+    filterAssigned(seats: ISeat[]): ISeat[];
+    isBlocked(seatId: number, styles: SeatStylesMap | undefined): boolean;
+    private removeAssignment;
+}
+
+interface SeatStateLayerDeps {
+    getContext: () => Context;
+    getEngine: () => SeatStateEngine;
+    getStyles: () => SeatStylesMap | undefined;
+    getVisibleSeats: () => ISeat[];
+    isOverlaySuppressed: () => boolean;
+}
+declare class SeatStateLayer {
+    private readonly deps;
+    private container;
+    private readonly nodes;
+    private lastReconcileAt;
+    constructor(deps: SeatStateLayerDeps);
+    sync(): void;
+    drawOnscreen(animScale: number, animTranslate: IPoint): void;
+    refreshPositions(seatIds: number[]): void;
+    destroy(): void;
+    private ensureContainer;
+    private updateTransform;
+    private reconcile;
+    private mountNode;
+    private appendDefault;
+    private appendCustom;
+    private numberEl;
+    private svgSrc;
+    private seatSize;
+    private positionNode;
+}
+
+/**
+ * @hidden
+ */
+declare class SelectionLayer extends SectionViewLayer {
+    static readonly PRICE_DOT_ANCHOR_THRESHOLD = 28;
+    static computePriceDotPosition(args: {
+        isTextHidden: boolean;
+        labelDx: number;
+        labelDy: number;
+        sectorBulletShiftY: number;
+    }): {
+        x: number;
+        y: number;
+    };
+    private gaFontScales;
+    private selectionRect?;
+    private getContextSvg;
+    updateGaFontScales(): void;
+    showSelectionRect(rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): void;
+    hideSelectionRect(): void;
+    renderContent(): void;
+    drawOnscreenCanvas(scale: number, translate: IPoint): void;
+    private renderGaTitles;
+    private renderSelectionRect;
+    /**
+     * Applies CSS 3D transforms to the selection layer canvas to match OutlineLayer in view3D mode
+     */
+    protected apply3DTransforms(): void;
+}
+
+interface SectionHelperDeps {
+    getContext: () => Context;
+    getStageLayer: () => IStageLayer;
+    getSelectionLayer: () => SelectionLayer | null;
+    getOutlineLayer: () => OutlineLayer;
+    getDataManager: () => DataManager;
+    getSeatIds: (seats: ISeat[] | number[] | string[]) => number[];
+    removeGaFromCart: (removedGa: {
+        sectorId: number;
+        price?: number;
+    }) => void;
+}
+/**
+ * Manages section-level operations: SVG section enable/disable/filter,
+ * section selection, GA selection, outline resolution, and data accessors.
+ */
+declare class SectionHelper {
+    private readonly deps;
+    private originalSectionPrices;
+    constructor(deps: SectionHelperDeps);
+    getSections(): ISector[];
+    getSectionsKeys(): (string | number)[];
+    getRows(): IRowDTO[];
+    getSeats(): ISeatDTO[];
+    getRowById(id: number): IRowDTO | undefined;
+    getVisibleSeats(): ISeat[];
+    getSectionsWithCoords(): ISectionWithCoords[];
+    getSeatSelection(): IExtendedSeat[];
+    setSeatSelection(seats: number[] | string[] | ISeat[]): void;
+    applySeatSelection(ids: number[], mode: RendererSelectMode): void;
+    selectSeatBlock(anchorSeatId: number, focusSeatId: number, mode?: RendererSelectMode): boolean;
+    selectAllSeats(): void;
+    /**
+     * Replaces the current section selection: clears all outline selection
+     * attributes, then selects the resolved ids. An empty list clears everything.
+     */
+    setSectionSelection(sections?: number[] | string[]): void;
+    getSvgSectionBySelection(): ISectorDTO[];
+    setSelectedGa(ga?: number | string): void;
+    getSelectedGa(): ISector | undefined;
+    disableSvgSectionsByIds(ids: number[], options?: {
+        resetAll?: boolean;
+    }): void;
+    enableSvgSectionsByIds(ids: number[]): void;
+    disableSvgSectionsByNames(names: string[], options?: {
+        resetAll?: boolean;
+    }): void;
+    enableSvgSectionsByNames(names: string[]): void;
+    disableSectionsByIds(ids: number[]): void;
+    enableSectionsByIds(): void;
+    filterSvgSectionsByIds(ids: number[], options?: {
+        resetAll?: boolean;
+    }): void;
+    removeFilterSvgSectionsByIds(ids?: number[]): void;
+    getGaSectionByOutline(target: HTMLElement | EventTarget): ISection | undefined;
+    getSectionByOutline(target: HTMLElement | EventTarget): ISection | undefined;
+    buildSectionFromId(sectionId: number): ISection | undefined;
+    getSectorRectByOutline(target: HTMLElement | EventTarget): ISectionRect;
+    private updateBackgroundImage;
+}
+
 /**
  * Base Renderer class that implements the IRenderer interface.
  * Provides core functionality for rendering and interacting with a venue map.
@@ -2588,7 +2947,8 @@ declare class Renderer implements IRenderer {
     private threeDController;
     private viewportController;
     private seatOps;
-    private sectionHelper;
+    protected sectionHelper: SectionHelper;
+    protected getSeatStateLayer(): SeatStateLayer;
     private refreshMinimap;
     private setMinimapFromSnapshot;
     /**
@@ -2679,6 +3039,7 @@ declare class Renderer implements IRenderer {
      * @returns Whether the mode was set successfully
      */
     setMode(mode: string): boolean;
+    protected setTemporaryPan(active: boolean): void;
     getMode(): string | undefined;
     setHeight(height: number): void;
     setGroupSize(groupSize: number): void;
@@ -2690,7 +3051,7 @@ declare class Renderer implements IRenderer {
     setGaCategory(sectionId: number, category: number | undefined): void;
     resetCategories(): void;
     getCategoryColor(category: number): string | undefined;
-    private changeMachineContext;
+    protected changeMachineContext(changes: Partial<IRendererMachineContext>): void;
     private setContextScale;
     /**
      * Retrieves the available prices.
@@ -2800,6 +3161,7 @@ declare class Renderer implements IRenderer {
     getResolvedMarkers(): IResolvedMarker[];
     private addHandlers;
     private initializeResizeObserver;
+    protected onBeforeSchemaReplace(): void;
     protected setSchemaData(schema: ISchemaDTO): Promise<void>;
     /**
      * Sets external prices to seats
@@ -2906,7 +3268,7 @@ declare class Renderer implements IRenderer {
     updateSeatLocks(filter: SeatFilter): void;
     getSeatSelection(): IExtendedSeat[];
     setSectionSelection(sections?: number[] | string[]): void;
-    getSvgSectionBySelection(): IBaseSector[];
+    getSvgSectionBySelection(): ISectorDTO[];
     /** @deprecated Use {@link disableSections} instead. */
     disableSvgSectionsByIds(ids: number[], options?: {
         resetAll?: boolean;
@@ -2948,7 +3310,7 @@ declare class Renderer implements IRenderer {
     setSeatSelection(seats: number[] | string[] | ISeat[]): void;
     setSelectedGa(ga?: number | string): void;
     getSelectedGa(): ISector | undefined;
-    getSections(): IBaseSector[];
+    getSections(): ISector[];
     getSectionsKeys(): (string | number)[];
     getRows(): IRowDTO[];
     getSeats(): ISeatDTO[];
@@ -2978,9 +3340,10 @@ declare class Renderer implements IRenderer {
     animateSequence(steps: IRendererSequenceStep[]): Promise<void>;
     getMinZoom(): number;
     getMaxZoom(): number;
+    private cancelViewportSettle;
     /** Debounced notification to stageLayer that viewport has settled (SEAT-831 detail crop) */
     private scheduleViewportSettle;
-    private redraw;
+    protected redraw(): void;
     private startAnimation;
     private doTranslate;
     private cachedDraw;
@@ -3061,6 +3424,39 @@ interface IAdminRendererSettings extends IRendererSettings {
      * Can be 'local', 'stage', or 'production' (default).
      */
     env?: string;
+    /**
+     * Called whenever flat section view is entered or exited, including when it is
+     * discarded on renderer teardown or a schema reload.
+     *
+     * Receives the id of the section that is now flattened, or `null` when the view
+     * has returned to normal.
+     */
+    onFlatSectionViewChange?: (sectionId: number | null) => void;
+}
+/**
+ * Interface for the Admin Renderer functionality.
+ * Extends the base renderer interface with admin-specific methods.
+ */
+interface IAdminRenderer extends IRenderer {
+    /**
+     * Loads an event by its ID.
+     *
+     * @param eventId - The ID of the event to load
+     * @returns A promise that resolves when the event is loaded
+     */
+    loadEvent: (eventId: string) => Promise<void>;
+    /**
+     * Flattens a single section onto its seating grid, or exits the flat view.
+     *
+     * Requesting the section that is already flattened resolves `true` and does
+     * nothing, so the call never toggles the view off.
+     *
+     * @param sectionId - The id of the section to flatten, or `null` to exit
+     * @returns A promise resolving `true` when the view is flat for that section,
+     * or when `null` was passed; `false` when the section cannot be flattened
+     * (general admission, tables, an unknown id, or a section with no grid)
+     */
+    setFlatSectionView: (sectionId: number | null) => Promise<boolean>;
 }
 /**
  * Admin Renderer class for seatmap administration.
@@ -3069,14 +3465,13 @@ interface IAdminRendererSettings extends IRendererSettings {
 declare class SeatmapAdminRenderer extends Renderer {
     static readonly VERSION: string;
     protected apiClient: BookingApiClient;
-    private pointerOverStage;
-    private readonly spacePan;
-    private readonly onStageEnter;
-    private readonly onStageLeave;
-    private readonly onKeyDown;
-    private readonly onKeyUp;
-    private readonly onWindowBlur;
-    private static isEditableTarget;
+    private hotkeys?;
+    private gridSource?;
+    private readonly loadedGridSections;
+    private backdropOverlay;
+    private rowSeatLabelOverlay;
+    private labelOverlaySvgRoot?;
+    private flattenController?;
     /**
      * Creates a new instance of the AdminRenderer.
      *
@@ -3113,6 +3508,16 @@ declare class SeatmapAdminRenderer extends Renderer {
      * ```
      */
     constructor(element: HTMLElement, settings?: IAdminRendererSettings);
+    private beginTemporaryPan;
+    private endTemporaryPan;
+    private beginFlatten;
+    private endFlatten;
+    clearSelection(): void;
+    selectAllSeats(): void;
+    private getLabelViewBoxOffset;
+    private syncLabelOverlay;
+    setFlatSectionView(sectionId: number | null): Promise<boolean>;
+    protected onBeforeSchemaReplace(): void;
     destroy(): void;
     /**
      * Sets the interaction mode for the component and updates visibility of the outline layer.
@@ -3190,6 +3595,24 @@ declare class SeatmapAdminRenderer extends Renderer {
      * @returns A promise that resolves when the data fetching is completed
      */
     loadSchema(schemaId: number): Promise<void>;
+    /**
+     * Selects the rectangular block of seats spanning the section-local grid
+     * coordinates between an anchor seat and a focus seat.
+     *
+     * @example
+     * ```js
+     * renderer.selectSeatBlock(anchorSeatId, focusSeatId);
+     * renderer.selectSeatBlock(anchorSeatId, focusSeatId, RendererSelectMode.ADD);
+     * ```
+     *
+     * @param anchorSeatId - ID of the seat where the block selection starts
+     * @param focusSeatId - ID of the seat where the block selection ends
+     * @param mode - Selection algebra to apply (defaults to `RendererSelectMode.REPLACE`)
+     * @returns A promise resolving to `false` if either seat is unknown, the seats belong to
+     * different sections, or grid coordinates are unavailable; `true` otherwise
+     */
+    selectSeatBlock(anchorSeatId: number, focusSeatId: number, mode?: RendererSelectMode): Promise<boolean>;
+    private ensureSectionGrid;
 }
 
 interface IBookingRendererSettings extends IRendererSettings {
@@ -3245,6 +3668,8 @@ declare class SeatmapBookingRenderer extends Renderer {
     private tags?;
     private lastSentViewBox?;
     private debugOverlay?;
+    private poweredByOverlay?;
+    private interruptionOverlay?;
     /**
      * Creates a new instance of the SeatmapBookingRenderer.
      *
@@ -3302,6 +3727,7 @@ declare class SeatmapBookingRenderer extends Renderer {
      *   those requests fail. Use the onSchemaDataLoaded callback for a first-paint hook.
      */
     loadEvent(eventId: string, sectorId?: number): Promise<void>;
+    private applyBrandingOverlay;
     /** @hidden */
     static getErrorMessage(error: ApiError, errorTexts?: ILoaderSettings['errorTexts']): {
         title: string;
@@ -3337,6 +3763,8 @@ declare class SeatmapBookingRenderer extends Renderer {
  */
 declare const VERSION: string;
 
+type AdminHotkeyAction = 'pan' | 'clearSelection' | 'selectAll' | 'zoomIn' | 'zoomOut' | 'zoomToFit' | 'flatSection';
+
 declare const defaultZoomSettings: IZoomSettings;
 declare const mergeSettings: (defaults: IRendererSettings, settings?: Partial<IRendererSettings>) => IRendererSettings & Partial<IRendererSettings>;
 
@@ -3378,4 +3806,4 @@ declare class RotationAnimation {
     getAnimation(): IRotationAnimation | null;
 }
 
-export { ApiError, BookingApiClient, type BuiltinSeatStateKey, 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 ICustomSeatStyle, type IDeselectDestEvent, type IDragEndSrcEvent, type IDragMoveSrcEvent, type IDragStartSrcEvent, type IEntityStates, type IErrorMessage, type IExtendedSeat, type ILabelStyle, 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 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 ISeatStateRenderArgs, 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, type SeatStylesMap, SeatmapAdminRenderer, SeatmapBookingRenderer, type SrcEvent, SrcEventType, StateManager, type StateManagerEvent, type StateManagerEventCallback, type TransformArray, VERSION, convertPricesToColored, convertPricesToColoredById, defaultZoomSettings, emptyPriceList, mergeSettings, sortPrices };
+export { type AdminHotkeyAction, ApiError, BookingApiClient, type BrandingLevel, type BuiltinSeatStateKey, type ById, type ColorById, type ColorSequenceSettings, DataManager, type DataManagerEvent, type DataManagerEventCallback, type DeepPartial, type DestEvent, DestEventType, type HotkeysSetting, type IAdminRenderer, 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 ICustomSeatStyle, type IDeselectDestEvent, type IDragEndSrcEvent, type IDragMoveSrcEvent, type IDragStartSrcEvent, type IEntityStates, type IErrorMessage, type IExtendedSeat, type ILabelStyle, 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 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 ISeatStateRenderArgs, type ISeatStyle, type ISection, type ISectionClickDestEvent, type ISectionGridDTO, type ISectionMetadata, type ISectionMouseEnterDestEvent, type ISectionMouseLeaveDestEvent, type ISectionRect, type ISectionWithCoords, type ISector, type ISectorDTO, type IShapeMetadata, type ISpecialPrice, type ISpecialState, type ISvgSectionStateStyles, type ISvgSectionStyle, type ITileGrid, type IVenueDTO, type IVisibilitySettings, type IWatermarkSettings, 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, type SeatStylesMap, SeatmapAdminRenderer, SeatmapBookingRenderer, type SrcEvent, SrcEventType, StateManager, type StateManagerEvent, type StateManagerEventCallback, type TransformArray, VERSION, convertPricesToColored, convertPricesToColoredById, defaultZoomSettings, emptyPriceList, mergeSettings, sortPrices };