mahal_map 2.1.0 → 2.2.2

package/README.md

@@ -281,7 +281,7 @@ map.setStyle("light"); // → navigator-light
 | `traffic`          | `boolean \| { raster?, rasterMaxZoom?, graph?, opacity?, arrows? }` | `false`   | Слой пробок. `raster: true` — картинкой вместо векторного слоя.      |
 | `indoor`           | `boolean \| { level? }`                                             | `false`   | Планы этажей.                                                        |
 | `closures`         | `boolean \| object`                                                 | `false`   | Перекрытия дорог.                                                    |
-| `places`           | `object`                                                            | —         | Парковки, заправки, зарядки: `highlight`, `paid`, `free`, `unknown`. |
+| `places`           | `object`                                                            | —         | Парковки, заправки, зарядки: `highlight`, `paid`, `free`, `unknown`, `fillOpacity` (0.10.0+). |
 | `minZoom`          | `number`                                                            | `16`      | Зум появления объёма.                                                |
 | `lodBias`          | `number`                                                            | `1`       | `0` — всегда детальная геометрия, `1` — упрощённая вдали.            |
 | `memoryBudget`     | `number`                                                            | `30`      | Сколько 3D-моделей держать в памяти.                                 |
@@ -341,7 +341,16 @@ MahalMap.create(
 | `active`    | что нарисовано прямо сейчас (память SDK)          |
 | `rendered`  | факт со стороны карты: слой есть в стиле и не погашен |
 
-`rendered` появилось в Maps3D 0.8.0; у сборок постарше его нет (`undefined`). Расхождение `active !== rendered` означает, что внутренний признак SDK разошёлся с картой — это видно одной проверкой, без чтения минифицированной сборки.
+`rendered` появилось в Maps3D 0.8.0; у сборок постарше его нет (`undefined`). Расхождение `active !== rendered` означает, что внутренний признак SDK разошёлся с картой — это видно одной проверкой, без чтения минифицированной сборки. Сравнивать поля можно только когда `rendered` есть — иначе на старой сборке любой активный слой покажется расхождением:
+
+```ts
+const state = map.getLayerState("terrain");
+
+// rendered === undefined — Maps3D < 0.8.0, проверка недоступна
+if (state?.rendered !== undefined && state.active !== state.rendered) {
+  reportLayerMismatch(state);
+}
+```
 
 Слой может быть включён и при этом не нарисован — и это не ошибка:
 
@@ -392,6 +401,12 @@ map.setLayer("parking", true, {
 });
 ```
 
+Площадные парковки рисуются тремя слоями по одной геометрии: заливка в цвете подтипа, мягкая внутренняя кромка (с z14) и волосяной кант. Цвета: янтарь — платно, зелёный — бесплатно, сланцевый — неизвестно. Размеры заданы в экранных пикселях и от зума плитки не зависят.
+
+Заливку включает только режим поиска — `highlight: true`. Без него подключение Maps3D облик карты не меняет. Постоянную плотность заливки вместо кривой по зуму задаёт `maps3d.places.fillOpacity`.
+
+Наведение, клик и справка по участку — в разделе [Парковки: наведение, клик, справка](#парковки-наведение-клик-справка).
+
 #### Рельеф
 
 `auto` показывает рельеф на обзорных зумах, `on` — всегда. Режим `on` заметно дороже по трафику и времени кадра, чем `auto`.
@@ -558,6 +573,79 @@ map.setHoverEnabled(false); // подписка сохраняется
 
 Цену ограничивает сам SDK: разбор не чаще раза в кадр, пропускается во время движения карты и не трогает сцену, пока курсор на том же доме. Но разбор — это чтение пикселя обратно из GPU, поэтому на слабых устройствах наведение лучше не включать.
 
+### Парковки: наведение, клик, справка
+
+> Нужен `@grammaps/maps3d-web` **0.10.0+**. На более старой сборке методы ничего не делают и возвращают пустые значения (`false`, `null`).
+
+Устроено как у зданий: приложение задаёт облик и получает уведомления, подсветку и курсор рисует SDK.
+
+```ts
+// Режим поиска: заливка по подтипу
+map.setLayer("parking", true, { highlight: true });
+
+map.setParkingHoverStyle({ opacity: 0.6, outlineWidth: 2.4, cursor: "pointer" });
+
+map.onParkingHover((p) => {
+  tooltip.textContent = p ? p.subtype : "";
+});
+
+map.onParkingClick((p) => {
+  if (!p) return;
+  openCard(p); // { id, subtype, fee, access, kind, capacity, props }
+});
+
+// Подсветить со строки списка и погасить
+row.onmouseenter = () => map.hoverParking(osmId);
+row.onmouseleave = () => map.hoverParking(null);
+
+// Справка по точке холста (e.point события карты), допуск 4 px
+map.getMap().on("contextmenu", (e) => console.log(map.parkingAt(e.point, 4)));
+```
+
+| Метод                              | Описание                                                                                          |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `onParkingHover(callback \| null)` | Участок под курсором либо `null`. Зовётся **только при смене участка**. `null` — отписаться и погасить. |
+| `setParkingHoverStyle(style)`      | Облик подсветки: `color`, `opacity`, `outlineColor`, `outlineWidth`, `cursor`.                    |
+| `setParkingHoverEnabled(enabled)`  | Выключить/включить наведение, не теряя подписку.                                                  |
+| `parkingHoverEnabled`              | Геттер: включено ли наведение.                                                                    |
+| `hoverParking(id \| null)`         | Подсветить участок программно по `osm_id`; `null` — погасить. `false` — участка нет в данных.     |
+| `hoveredParking()`                 | `osm_id` подсвеченного участка или `null`.                                                        |
+| `onParkingClick(callback \| null)` | Клик по участку: справка либо `null`. `null` вместо колбэка — отписаться.                         |
+| `parkingAt(point, tolPx?)`         | Справка по точке холста. Допуск по умолчанию `0` — строго внутрь участка.                         |
+
+Облик подсветки (`IMaps3DParkingHoverStyle`):
+
+| Поле           | По умолч.    | Описание                                                                                   |
+| -------------- | ------------ | ------------------------------------------------------------------------------------------ |
+| `color`        | цвет подтипа | Цвет заливки под курсором. По умолчанию не меняется намеренно — подтип уже покрашен смыслом. |
+| `opacity`      | `0.55`       | Непрозрачность заливки под курсором.                                                       |
+| `outlineColor` | кант подтипа | Цвет канта под курсором.                                                                   |
+| `outlineWidth` | `2.2`        | Во сколько раз толще кант под курсором.                                                    |
+| `cursor`       | `"pointer"`  | CSS-курсор над парковкой; `null` — не трогать.                                             |
+
+Справка (`IMaps3DParkingInfo`) — ровно то, что лежит в тайле. Отсутствующий атрибут — `null`.
+
+| Поле       | Тип                              | Описание                                                              |
+| ---------- | -------------------------------- | --------------------------------------------------------------------- |
+| `id`       | `number \| string`               | `osm_id` участка — тот же, что принимает `hoverParking()`.            |
+| `subtype`  | `"paid" \| "free" \| "unknown"`  | Платность. `unknown` значит «не указано», а **не** «бесплатно».       |
+| `fee`      | `string \| null`                 | Исходное `fee` (`yes`/`no`).                                          |
+| `access`   | `string \| null`                 | Кому можно: `residents`, `private`, `customers`, `permissive`…        |
+| `kind`     | `string \| null`                 | OSM `parking=*`: `surface`, `multi-storey`, `underground`, `rooftop`… |
+| `capacity` | `number \| null`                 | Число мест.                                                           |
+| `props`    | `Record<string, unknown>`        | Все свойства фичи как есть.                                           |
+
+Поведение:
+
+- Попадание определяется по границе полигона, а не по расстоянию до центра.
+- Колбэк наведения вызывается при смене участка, не на каждое движение мыши. Разбор идёт не чаще раза в кадр и пропускается, пока карта движется.
+- Подписка на наведение или клик поднимает слой заливки, даже когда режим поиска выключен, — по нему идёт опрос. Красить в этом случае слой ничего не будет.
+
+Ограничения:
+
+- Графика работы нет: `opening_hours` в слое `landuse` отсутствует.
+- Названия у площадных парковок нет — оно бывает только у точек POI.
+
 #### Вкл/выкл 3D-здания на лету
 
 Переключение объём ⇄ штатные здания стиля, без пересоздания карты. Умеет поднять слой, если его не было (`enable3D: false` при создании):
@@ -1175,6 +1263,15 @@ MahalMap.clearSelection(map);
 MahalMap.onRoadClick(map, (road) => console.log(road?.name));
 MahalMap.roadAt(map, { x: 320, y: 240 });
 
+// Парковки
+MahalMap.setParkingHoverStyle(map, { opacity: 0.6, outlineWidth: 2.4 });
+MahalMap.onParkingHover(map, (p) => console.log(p?.subtype));
+MahalMap.setParkingHoverEnabled(map, false);
+MahalMap.hoverParking(map, 123456789);
+MahalMap.hoveredParking(map);
+MahalMap.onParkingClick(map, (p) => console.log(p?.id));
+MahalMap.parkingAt(map, { x: 320, y: 240 }, 4);
+
 // Наведение на здание (Maps3D 0.8.0)
 MahalMap.onBuildingHover(map, (b) => console.log(b?.id));
 MahalMap.setHoverStyle(map, { color: "#6b9ed1", cursor: "pointer" });
@@ -1239,6 +1336,13 @@ MahalMap.setZoom(map, 14);
 | `setSelectionStyle(instance, style)`           | Облик выделения.                                                      |
 | `onRoadClick(instance, callback)`              | Клик по дороге.                                                       |
 | `roadAt(instance, point, tolPx?)`              | Дорога под точкой холста.                                             |
+| `onParkingHover(instance, callback \| null)`   | Парковка под курсором (только при смене участка).                     |
+| `setParkingHoverStyle(instance, style)`        | Облик подсветки парковки.                                             |
+| `setParkingHoverEnabled(instance, enabled)`    | Вкл/выкл наведение на парковки, не теряя подписку.                    |
+| `hoverParking(instance, id \| null)`           | Подсветить парковку программно по `osm_id`.                           |
+| `hoveredParking(instance)`                     | `osm_id` подсвеченной парковки или `null`.                            |
+| `onParkingClick(instance, callback \| null)`   | Клик по парковке.                                                     |
+| `parkingAt(instance, point, tolPx?)`           | Справка о парковке под точкой холста.                                 |
 | `onBuildingHover(instance, cb)`               | Подписка на наведение (Maps3D 0.8.0); `null` отписывает.              |
 | `setHoverStyle(instance, style)`              | Облик наведения, включая CSS-курсор.                                  |
 | `setHoverEnabled(instance, on)`               | Вкл/выкл наведение, не трогая подписку.                               |

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";
@@ -124,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;
@@ -145,6 +180,11 @@ interface IMaps3DClosuresOptions {
 }
 interface IMaps3DPlacesOptions {
     highlight?: boolean;
+    /**
+     * Непрозрачность заливки парковок в режиме выделения. Не задана — кривая по зуму;
+     * заданная перебивает её постоянным значением на всех зумах. С 0.10.0.
+     */
+    fillOpacity?: number;
     paid?: boolean;
     free?: boolean;
     unknown?: boolean;
@@ -190,10 +230,13 @@ interface IMaps3DBuildingsController {
 }
 interface IMaps3DBuildingClickInfo {
     id: string | number;
-    /** Атрибуты объекта; `props.osm_id` — идентификатор, который не меняется. */
-    props: Record<string, unknown>;
-    /** Высота здания в метрах. */
-    height: number;
+    /**
+     * Атрибуты объекта; `props.osm_id` — идентификатор, который не меняется.
+     * Необязательно: peerDependency допускает сборки Maps3D от 0.5.0, где поля может не быть.
+     */
+    props?: Record<string, unknown>;
+    /** Высота здания в метрах. Необязательно по той же причине, что и `props`. */
+    height?: number;
     /** Порядковый номер внутри сцены. Живёт до ближайшей пересборки геометрии. */
     index?: number;
     [key: string]: unknown;
@@ -240,6 +283,17 @@ interface IMaps3DLayer {
         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;
@@ -564,6 +618,16 @@ 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;
@@ -670,6 +734,31 @@ 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` отписывает и гасит подсветку.
@@ -1016,4 +1105,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 IMaps3DHoverStyle, 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";
@@ -124,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;
@@ -145,6 +180,11 @@ interface IMaps3DClosuresOptions {
 }
 interface IMaps3DPlacesOptions {
     highlight?: boolean;
+    /**
+     * Непрозрачность заливки парковок в режиме выделения. Не задана — кривая по зуму;
+     * заданная перебивает её постоянным значением на всех зумах. С 0.10.0.
+     */
+    fillOpacity?: number;
     paid?: boolean;
     free?: boolean;
     unknown?: boolean;
@@ -190,10 +230,13 @@ interface IMaps3DBuildingsController {
 }
 interface IMaps3DBuildingClickInfo {
     id: string | number;
-    /** Атрибуты объекта; `props.osm_id` — идентификатор, который не меняется. */
-    props: Record<string, unknown>;
-    /** Высота здания в метрах. */
-    height: number;
+    /**
+     * Атрибуты объекта; `props.osm_id` — идентификатор, который не меняется.
+     * Необязательно: peerDependency допускает сборки Maps3D от 0.5.0, где поля может не быть.
+     */
+    props?: Record<string, unknown>;
+    /** Высота здания в метрах. Необязательно по той же причине, что и `props`. */
+    height?: number;
     /** Порядковый номер внутри сцены. Живёт до ближайшей пересборки геометрии. */
     index?: number;
     [key: string]: unknown;
@@ -240,6 +283,17 @@ interface IMaps3DLayer {
         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;
@@ -564,6 +618,16 @@ 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;
@@ -670,6 +734,31 @@ 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` отписывает и гасит подсветку.
@@ -1016,4 +1105,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 IMaps3DHoverStyle, 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 };