mahal_map 2.1.0 → 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";
@@ -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;
@@ -240,6 +280,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 +615,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 +731,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 +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 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;
@@ -240,6 +280,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 +615,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 +731,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 +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 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 };