mahal_map 2.0.3 → 2.2.0

package/dist/index.d.mts

@@ -23,7 +23,7 @@ interface IAdditionalParamType {
 /**
  * Поверхность @grammaps/maps3d-web, описанная локально. Пакет в зависимости не ставится —
  * он приходит снаружи, как и maplibre-gl, поэтому импортировать его типы нельзя. Здесь
- * повторена публичная часть .d.ts версии 0.7.3; всё необязательное помечено `?`, чтобы
+ * повторена публичная часть .d.ts версии 0.10.0; всё необязательное помечено `?`, чтобы
  * более старая сборка на странице не ломала типы у потребителя.
  */
 type Maps3DThemeName = "light" | "dark" | "navigator-light" | "navigator-dark" | "mobile-light" | "mobile-dark";
@@ -91,6 +91,12 @@ interface IMaps3DLayerState {
     available: boolean;
     /** Что нарисовано прямо сейчас. Именно это поле показывает, включён слой на деле или нет. */
     active: boolean;
+    /**
+     * Факт со стороны карты: слой есть в стиле и не погашен. Появилось в 0.8.0.
+     * `active !== rendered` — расхождение внутреннего признака SDK с картой.
+     * У слоя, который не умеет ответить фактом, повторяет `active`; у сборок до 0.8.0 — undefined.
+     */
+    rendered?: boolean;
     /** Параметры слоя: у зданий — detail, у этажей — level, у рельефа — mode. */
     params: Record<string, unknown>;
 }
@@ -101,6 +107,15 @@ interface IMaps3DSelectionStyle {
     durationMs?: number;
     easing?: "ease-out" | "linear";
 }
+/**
+ * Облик наведения. Появился в 0.8.0: до него подсветить дом под курсором можно было,
+ * только заняв единственный слот выделения. Теперь слот свой, и выбор всегда главнее —
+ * на выбранном доме наведение не рисуется.
+ */
+interface IMaps3DHoverStyle extends IMaps3DSelectionStyle {
+    /** CSS-курсор над зданием. По умолчанию "pointer"; `null` — не трогать курсор вовсе. */
+    cursor?: string | null;
+}
 interface IMaps3DRoadHit {
     name: string;
     nameRu?: string;
@@ -109,6 +124,41 @@ interface IMaps3DRoadHit {
     props: Record<string, unknown>;
     distancePx: number;
 }
+/** Платность парковки: по ней участок и покрашен. */
+type Maps3DParkingSubtype = "paid" | "free" | "unknown";
+/**
+ * Справка о площадной парковке — ровно то, что есть в тайле. Отсутствующий атрибут — `null`.
+ * Графика работы и названия здесь нет: в слое `landuse` их не бывает.
+ */
+interface IMaps3DParkingInfo {
+    /** `osm_id` участка — он же идентификатор для hoverParking(). */
+    id: number | string;
+    /** `unknown` значит «не указано», а не «бесплатно». */
+    subtype: Maps3DParkingSubtype;
+    /** Исходное `fee` из тайла (`yes`/`no`). */
+    fee: string | null;
+    /** Кому можно: `yes`, `private`, `customers`, `residents`, `permissive`, `no`… */
+    access: string | null;
+    /** OSM `parking=*`: `surface`, `multi-storey`, `underground`, `rooftop`… */
+    kind: string | null;
+    /** Число мест. */
+    capacity: number | null;
+    /** Все свойства фичи как есть. */
+    props: Record<string, unknown>;
+}
+/** Облик парковки под курсором. Не заданные цвета остаются цветами подтипа. */
+interface IMaps3DParkingHoverStyle {
+    /** Цвет заливки. Не задан — цвет подтипа. */
+    color?: string | null;
+    /** Непрозрачность заливки. По умолчанию 0.55. */
+    opacity?: number;
+    /** Цвет канта. Не задан — кант подтипа. */
+    outlineColor?: string | null;
+    /** Во сколько раз толще кант. По умолчанию 2.2. */
+    outlineWidth?: number;
+    /** CSS-курсор над парковкой. По умолчанию `pointer`; `null` — не трогать. */
+    cursor?: string | null;
+}
 interface IMaps3DTrafficOptions {
     raster?: boolean;
     rasterMaxZoom?: number;
@@ -130,6 +180,11 @@ interface IMaps3DClosuresOptions {
 }
 interface IMaps3DPlacesOptions {
     highlight?: boolean;
+    /**
+     * Непрозрачность заливки парковок в режиме выделения. Не задана — кривая по зуму;
+     * заданная перебивает её постоянным значением на всех зумах. С 0.10.0.
+     */
+    fillOpacity?: number;
     paid?: boolean;
     free?: boolean;
     unknown?: boolean;
@@ -213,12 +268,29 @@ interface IMaps3DLayer {
     clearSelection?(): void;
     selectedBuilding?(): number | string | null;
     setSelectionStyle?(style: IMaps3DSelectionStyle): void;
+    onBuildingHover?(callback: ((info: IMaps3DBuildingClickInfo | null) => void) | null): void;
+    setHoverEnabled?(enabled: boolean): void;
+    readonly hoverEnabled?: boolean;
+    setHoverStyle?(style: IMaps3DHoverStyle): void;
+    hoverBuilding?(id: number | string | null): boolean;
+    hoveredBuilding?(): number | string | null;
     onRoadClick?(callback: (hit: IMaps3DRoadHit | null) => void): void;
     roadAt?(point: {
         x: number;
         y: number;
     }, tolerancePx?: number): IMaps3DRoadHit | null;
     readonly roadsNamed?: boolean;
+    parkingAt?(point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DParkingInfo | null;
+    onParkingHover?(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    setParkingHoverStyle?(style: IMaps3DParkingHoverStyle): void;
+    setParkingHoverEnabled?(enabled: boolean): void;
+    readonly parkingHoverEnabled?: boolean;
+    hoverParking?(id: number | string | null): boolean;
+    hoveredParking?(): number | string | null;
+    onParkingClick?(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
     traffic?: boolean;
     trafficRaster?: boolean;
     setTraffic?(enabled: boolean): void;
@@ -468,6 +540,9 @@ declare class MahalMap {
     private pendingRoadClick?;
     private pendingSelectionStyle?;
     private pendingLayerSubscribers;
+    private pendingBuildingHover?;
+    private pendingHoverStyle?;
+    private pendingHoverEnabled?;
     private constructor();
     private static getInstanceKey;
     private static normalizeLanguage;
@@ -540,6 +615,21 @@ declare class MahalMap {
         x: number;
         y: number;
     }, tolerancePx?: number): IMaps3DRoadHit | null;
+    static onParkingHover(instance: MahalMap, callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    static setParkingHoverStyle(instance: MahalMap, style: IMaps3DParkingHoverStyle): void;
+    static setParkingHoverEnabled(instance: MahalMap, enabled: boolean): void;
+    static hoverParking(instance: MahalMap, id: number | string | null): boolean;
+    static hoveredParking(instance: MahalMap): string | number | null;
+    static onParkingClick(instance: MahalMap, callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    static parkingAt(instance: MahalMap, point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DParkingInfo | null;
+    static onBuildingHover(instance: MahalMap, callback: ((info: IMaps3DBuildingClickInfo | null) => void) | null): void;
+    static setHoverEnabled(instance: MahalMap, enabled: boolean): void;
+    static setHoverStyle(instance: MahalMap, style: IMaps3DHoverStyle): void;
+    static hoverBuilding(instance: MahalMap, id: number | string | null): boolean;
+    static hoveredBuilding(instance: MahalMap): string | number | null;
     static setLanguage(instance: MahalMap, lang: MapLanguage): void;
     static setCenter(instance: MahalMap, center: [number, number]): void;
     static setZoom(instance: MahalMap, zoom: number): void;
@@ -641,6 +731,59 @@ declare class MahalMap {
     }, tolerancePx?: number): IMaps3DRoadHit | null;
     /** Есть ли в текущем стиле названия дорог. Нет — roadAt() всегда вернёт null. */
     get roadsNamed(): boolean;
+    /**
+     * Участок под курсором либо null. Зовётся ТОЛЬКО при смене участка, не на каждое
+     * движение мыши. `null` вместо колбэка — отписаться и погасить подсветку.
+     */
+    onParkingHover(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    /** Облик подсветки: color, opacity, outlineColor, outlineWidth, cursor. */
+    setParkingHoverStyle(style: IMaps3DParkingHoverStyle): void;
+    /** Вкл/выкл наведение, не теряя подписку. */
+    setParkingHoverEnabled(enabled: boolean): void;
+    /** Включено ли наведение на парковки. */
+    get parkingHoverEnabled(): boolean;
+    /** Подсветить участок программно (например, со строки списка). `null` — погасить. */
+    hoverParking(id: number | string | null): boolean;
+    /** `osm_id` подсвеченного участка или null. */
+    hoveredParking(): number | string | null;
+    /** Клик по участку: справка либо null. `null` вместо колбэка — отписаться. */
+    onParkingClick(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    /**
+     * Парковка под точкой холста (`e.point` события карты). Попадание — по границе полигона;
+     * допуск по умолчанию 0 — строго внутрь участка.
+     */
+    parkingAt(point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DParkingInfo | null;
+    /**
+     * Подписаться на наведение. Колбэк приходит только в момент смены дома под курсором,
+     * а не на каждое движение мыши. `null` отписывает и гасит подсветку.
+     *
+     * Слежение за мышью включается самой подпиской: без неё SDK курсор не трогает и
+     * разбор сцены не делает.
+     */
+    onBuildingHover(callback: ((info: IMaps3DBuildingClickInfo | null) => void) | null): void;
+    /**
+     * Включить/выключить наведение, не трогая подписку. Нужно там, где подсветка мешает:
+     * режим рисования, открытая карточка объекта, тач-устройство без курсора.
+     */
+    setHoverEnabled(enabled: boolean): void;
+    /** Включено ли наведение прямо сейчас. */
+    get hoverEnabled(): boolean;
+    /** Облик наведения: цвет, плотность, свечение, длительность и CSS-курсор. */
+    setHoverStyle(style: IMaps3DHoverStyle): void;
+    /**
+     * Навести на здание программно — например, когда курсор стоит на строке списка.
+     * Идентификатор тот же, что у selectBuilding. `null` снимает наведение.
+     *
+     * Следующее движение мыши по карте перебивает программное наведение.
+     *
+     * @returns `false`, если такого дома сейчас на карте нет.
+     */
+    hoverBuilding(id: number | string | null): boolean;
+    /** Идентификатор дома под наведением или `null`. */
+    hoveredBuilding(): number | string | null;
     /**
      * Создаёт слой Maps3D. `buildings` не форсируем в `true`: с 0.7.x видимостью объёма
      * заведует реестр слоёв, а опции облика зданий приходят из options.maps3d как есть.
@@ -959,4 +1102,4 @@ declare namespace index {
   export { index_checkCoordinates as checkCoordinates, index_debounce as debounce, index_geojsonPolyline as geojsonPolyline, index_geometryPolyline as geometryPolyline, index_trimValue as trimValue };
 }
 
-export { CheckJSApi, type IAdditionalParamType, type ICheckJSApiParam, type ICheckJSApiResponse, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DBuildingsOptions, type IMaps3DClosuresOptions, type IMaps3DDiagnostics, type IMaps3DIndoorOptions, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DLayerParams, type IMaps3DLayerState, type IMaps3DMapOptionsInput, type IMaps3DMapOptionsResult, type IMaps3DObjectsLightOptions, type IMaps3DPlacesOptions, type IMaps3DRoadHit, type IMaps3DSelectionStyle, type IMaps3DTrafficOptions, type IMaps3DTransformRequestOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type MapStyleFamily, type Maps3DBuildingDetail, type Maps3DCtor, type Maps3DLayerId, type Maps3DTerrainMode, type Maps3DThemeName, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, SearchPoi, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };
+export { CheckJSApi, type IAdditionalParamType, type ICheckJSApiParam, type ICheckJSApiResponse, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DBuildingsOptions, type IMaps3DClosuresOptions, type IMaps3DDiagnostics, type IMaps3DHoverStyle, type IMaps3DIndoorOptions, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DLayerParams, type IMaps3DLayerState, type IMaps3DMapOptionsInput, type IMaps3DMapOptionsResult, type IMaps3DObjectsLightOptions, type IMaps3DParkingHoverStyle, type IMaps3DParkingInfo, type IMaps3DPlacesOptions, type IMaps3DRoadHit, type IMaps3DSelectionStyle, type IMaps3DTrafficOptions, type IMaps3DTransformRequestOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type MapStyleFamily, type Maps3DBuildingDetail, type Maps3DCtor, type Maps3DLayerId, type Maps3DParkingSubtype, type Maps3DTerrainMode, type Maps3DThemeName, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, SearchPoi, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };

package/dist/index.d.ts

@@ -23,7 +23,7 @@ interface IAdditionalParamType {
 /**
  * Поверхность @grammaps/maps3d-web, описанная локально. Пакет в зависимости не ставится —
  * он приходит снаружи, как и maplibre-gl, поэтому импортировать его типы нельзя. Здесь
- * повторена публичная часть .d.ts версии 0.7.3; всё необязательное помечено `?`, чтобы
+ * повторена публичная часть .d.ts версии 0.10.0; всё необязательное помечено `?`, чтобы
  * более старая сборка на странице не ломала типы у потребителя.
  */
 type Maps3DThemeName = "light" | "dark" | "navigator-light" | "navigator-dark" | "mobile-light" | "mobile-dark";
@@ -91,6 +91,12 @@ interface IMaps3DLayerState {
     available: boolean;
     /** Что нарисовано прямо сейчас. Именно это поле показывает, включён слой на деле или нет. */
     active: boolean;
+    /**
+     * Факт со стороны карты: слой есть в стиле и не погашен. Появилось в 0.8.0.
+     * `active !== rendered` — расхождение внутреннего признака SDK с картой.
+     * У слоя, который не умеет ответить фактом, повторяет `active`; у сборок до 0.8.0 — undefined.
+     */
+    rendered?: boolean;
     /** Параметры слоя: у зданий — detail, у этажей — level, у рельефа — mode. */
     params: Record<string, unknown>;
 }
@@ -101,6 +107,15 @@ interface IMaps3DSelectionStyle {
     durationMs?: number;
     easing?: "ease-out" | "linear";
 }
+/**
+ * Облик наведения. Появился в 0.8.0: до него подсветить дом под курсором можно было,
+ * только заняв единственный слот выделения. Теперь слот свой, и выбор всегда главнее —
+ * на выбранном доме наведение не рисуется.
+ */
+interface IMaps3DHoverStyle extends IMaps3DSelectionStyle {
+    /** CSS-курсор над зданием. По умолчанию "pointer"; `null` — не трогать курсор вовсе. */
+    cursor?: string | null;
+}
 interface IMaps3DRoadHit {
     name: string;
     nameRu?: string;
@@ -109,6 +124,41 @@ interface IMaps3DRoadHit {
     props: Record<string, unknown>;
     distancePx: number;
 }
+/** Платность парковки: по ней участок и покрашен. */
+type Maps3DParkingSubtype = "paid" | "free" | "unknown";
+/**
+ * Справка о площадной парковке — ровно то, что есть в тайле. Отсутствующий атрибут — `null`.
+ * Графика работы и названия здесь нет: в слое `landuse` их не бывает.
+ */
+interface IMaps3DParkingInfo {
+    /** `osm_id` участка — он же идентификатор для hoverParking(). */
+    id: number | string;
+    /** `unknown` значит «не указано», а не «бесплатно». */
+    subtype: Maps3DParkingSubtype;
+    /** Исходное `fee` из тайла (`yes`/`no`). */
+    fee: string | null;
+    /** Кому можно: `yes`, `private`, `customers`, `residents`, `permissive`, `no`… */
+    access: string | null;
+    /** OSM `parking=*`: `surface`, `multi-storey`, `underground`, `rooftop`… */
+    kind: string | null;
+    /** Число мест. */
+    capacity: number | null;
+    /** Все свойства фичи как есть. */
+    props: Record<string, unknown>;
+}
+/** Облик парковки под курсором. Не заданные цвета остаются цветами подтипа. */
+interface IMaps3DParkingHoverStyle {
+    /** Цвет заливки. Не задан — цвет подтипа. */
+    color?: string | null;
+    /** Непрозрачность заливки. По умолчанию 0.55. */
+    opacity?: number;
+    /** Цвет канта. Не задан — кант подтипа. */
+    outlineColor?: string | null;
+    /** Во сколько раз толще кант. По умолчанию 2.2. */
+    outlineWidth?: number;
+    /** CSS-курсор над парковкой. По умолчанию `pointer`; `null` — не трогать. */
+    cursor?: string | null;
+}
 interface IMaps3DTrafficOptions {
     raster?: boolean;
     rasterMaxZoom?: number;
@@ -130,6 +180,11 @@ interface IMaps3DClosuresOptions {
 }
 interface IMaps3DPlacesOptions {
     highlight?: boolean;
+    /**
+     * Непрозрачность заливки парковок в режиме выделения. Не задана — кривая по зуму;
+     * заданная перебивает её постоянным значением на всех зумах. С 0.10.0.
+     */
+    fillOpacity?: number;
     paid?: boolean;
     free?: boolean;
     unknown?: boolean;
@@ -213,12 +268,29 @@ interface IMaps3DLayer {
     clearSelection?(): void;
     selectedBuilding?(): number | string | null;
     setSelectionStyle?(style: IMaps3DSelectionStyle): void;
+    onBuildingHover?(callback: ((info: IMaps3DBuildingClickInfo | null) => void) | null): void;
+    setHoverEnabled?(enabled: boolean): void;
+    readonly hoverEnabled?: boolean;
+    setHoverStyle?(style: IMaps3DHoverStyle): void;
+    hoverBuilding?(id: number | string | null): boolean;
+    hoveredBuilding?(): number | string | null;
     onRoadClick?(callback: (hit: IMaps3DRoadHit | null) => void): void;
     roadAt?(point: {
         x: number;
         y: number;
     }, tolerancePx?: number): IMaps3DRoadHit | null;
     readonly roadsNamed?: boolean;
+    parkingAt?(point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DParkingInfo | null;
+    onParkingHover?(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    setParkingHoverStyle?(style: IMaps3DParkingHoverStyle): void;
+    setParkingHoverEnabled?(enabled: boolean): void;
+    readonly parkingHoverEnabled?: boolean;
+    hoverParking?(id: number | string | null): boolean;
+    hoveredParking?(): number | string | null;
+    onParkingClick?(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
     traffic?: boolean;
     trafficRaster?: boolean;
     setTraffic?(enabled: boolean): void;
@@ -468,6 +540,9 @@ declare class MahalMap {
     private pendingRoadClick?;
     private pendingSelectionStyle?;
     private pendingLayerSubscribers;
+    private pendingBuildingHover?;
+    private pendingHoverStyle?;
+    private pendingHoverEnabled?;
     private constructor();
     private static getInstanceKey;
     private static normalizeLanguage;
@@ -540,6 +615,21 @@ declare class MahalMap {
         x: number;
         y: number;
     }, tolerancePx?: number): IMaps3DRoadHit | null;
+    static onParkingHover(instance: MahalMap, callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    static setParkingHoverStyle(instance: MahalMap, style: IMaps3DParkingHoverStyle): void;
+    static setParkingHoverEnabled(instance: MahalMap, enabled: boolean): void;
+    static hoverParking(instance: MahalMap, id: number | string | null): boolean;
+    static hoveredParking(instance: MahalMap): string | number | null;
+    static onParkingClick(instance: MahalMap, callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    static parkingAt(instance: MahalMap, point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DParkingInfo | null;
+    static onBuildingHover(instance: MahalMap, callback: ((info: IMaps3DBuildingClickInfo | null) => void) | null): void;
+    static setHoverEnabled(instance: MahalMap, enabled: boolean): void;
+    static setHoverStyle(instance: MahalMap, style: IMaps3DHoverStyle): void;
+    static hoverBuilding(instance: MahalMap, id: number | string | null): boolean;
+    static hoveredBuilding(instance: MahalMap): string | number | null;
     static setLanguage(instance: MahalMap, lang: MapLanguage): void;
     static setCenter(instance: MahalMap, center: [number, number]): void;
     static setZoom(instance: MahalMap, zoom: number): void;
@@ -641,6 +731,59 @@ declare class MahalMap {
     }, tolerancePx?: number): IMaps3DRoadHit | null;
     /** Есть ли в текущем стиле названия дорог. Нет — roadAt() всегда вернёт null. */
     get roadsNamed(): boolean;
+    /**
+     * Участок под курсором либо null. Зовётся ТОЛЬКО при смене участка, не на каждое
+     * движение мыши. `null` вместо колбэка — отписаться и погасить подсветку.
+     */
+    onParkingHover(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    /** Облик подсветки: color, opacity, outlineColor, outlineWidth, cursor. */
+    setParkingHoverStyle(style: IMaps3DParkingHoverStyle): void;
+    /** Вкл/выкл наведение, не теряя подписку. */
+    setParkingHoverEnabled(enabled: boolean): void;
+    /** Включено ли наведение на парковки. */
+    get parkingHoverEnabled(): boolean;
+    /** Подсветить участок программно (например, со строки списка). `null` — погасить. */
+    hoverParking(id: number | string | null): boolean;
+    /** `osm_id` подсвеченного участка или null. */
+    hoveredParking(): number | string | null;
+    /** Клик по участку: справка либо null. `null` вместо колбэка — отписаться. */
+    onParkingClick(callback: ((info: IMaps3DParkingInfo | null) => void) | null): void;
+    /**
+     * Парковка под точкой холста (`e.point` события карты). Попадание — по границе полигона;
+     * допуск по умолчанию 0 — строго внутрь участка.
+     */
+    parkingAt(point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DParkingInfo | null;
+    /**
+     * Подписаться на наведение. Колбэк приходит только в момент смены дома под курсором,
+     * а не на каждое движение мыши. `null` отписывает и гасит подсветку.
+     *
+     * Слежение за мышью включается самой подпиской: без неё SDK курсор не трогает и
+     * разбор сцены не делает.
+     */
+    onBuildingHover(callback: ((info: IMaps3DBuildingClickInfo | null) => void) | null): void;
+    /**
+     * Включить/выключить наведение, не трогая подписку. Нужно там, где подсветка мешает:
+     * режим рисования, открытая карточка объекта, тач-устройство без курсора.
+     */
+    setHoverEnabled(enabled: boolean): void;
+    /** Включено ли наведение прямо сейчас. */
+    get hoverEnabled(): boolean;
+    /** Облик наведения: цвет, плотность, свечение, длительность и CSS-курсор. */
+    setHoverStyle(style: IMaps3DHoverStyle): void;
+    /**
+     * Навести на здание программно — например, когда курсор стоит на строке списка.
+     * Идентификатор тот же, что у selectBuilding. `null` снимает наведение.
+     *
+     * Следующее движение мыши по карте перебивает программное наведение.
+     *
+     * @returns `false`, если такого дома сейчас на карте нет.
+     */
+    hoverBuilding(id: number | string | null): boolean;
+    /** Идентификатор дома под наведением или `null`. */
+    hoveredBuilding(): number | string | null;
     /**
      * Создаёт слой Maps3D. `buildings` не форсируем в `true`: с 0.7.x видимостью объёма
      * заведует реестр слоёв, а опции облика зданий приходят из options.maps3d как есть.
@@ -959,4 +1102,4 @@ declare namespace index {
   export { index_checkCoordinates as checkCoordinates, index_debounce as debounce, index_geojsonPolyline as geojsonPolyline, index_geometryPolyline as geometryPolyline, index_trimValue as trimValue };
 }
 
-export { CheckJSApi, type IAdditionalParamType, type ICheckJSApiParam, type ICheckJSApiResponse, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DBuildingsOptions, type IMaps3DClosuresOptions, type IMaps3DDiagnostics, type IMaps3DIndoorOptions, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DLayerParams, type IMaps3DLayerState, type IMaps3DMapOptionsInput, type IMaps3DMapOptionsResult, type IMaps3DObjectsLightOptions, type IMaps3DPlacesOptions, type IMaps3DRoadHit, type IMaps3DSelectionStyle, type IMaps3DTrafficOptions, type IMaps3DTransformRequestOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type MapStyleFamily, type Maps3DBuildingDetail, type Maps3DCtor, type Maps3DLayerId, type Maps3DTerrainMode, type Maps3DThemeName, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, SearchPoi, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };
+export { CheckJSApi, type IAdditionalParamType, type ICheckJSApiParam, type ICheckJSApiResponse, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DBuildingsOptions, type IMaps3DClosuresOptions, type IMaps3DDiagnostics, type IMaps3DHoverStyle, type IMaps3DIndoorOptions, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DLayerParams, type IMaps3DLayerState, type IMaps3DMapOptionsInput, type IMaps3DMapOptionsResult, type IMaps3DObjectsLightOptions, type IMaps3DParkingHoverStyle, type IMaps3DParkingInfo, type IMaps3DPlacesOptions, type IMaps3DRoadHit, type IMaps3DSelectionStyle, type IMaps3DTrafficOptions, type IMaps3DTransformRequestOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type MapStyleFamily, type Maps3DBuildingDetail, type Maps3DCtor, type Maps3DLayerId, type Maps3DParkingSubtype, type Maps3DTerrainMode, type Maps3DThemeName, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, SearchPoi, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };