mahal_map 2.0.2 → 2.0.3

package/README.md

@@ -495,7 +495,16 @@ map.roadAt({ x: 320, y: 240 });
 map.roadsNamed; // есть ли в текущем стиле названия дорог
 ```
 
-Подписываться можно сразу после `create()`, до готовности карты.
+Подписываться можно сразу после `create()` — даже когда слой ещё не поднят (`enable3D: false`). Подписка и облик выделения запоминаются и переигрываются, как только слой появится:
+
+```ts
+const map = MahalMap.create({ container: "map", enable3D: false }, maplibregl, Maps3D);
+
+map.onBuildingClick((b) => console.log(b?.props.osm_id));
+map.setSelectionStyle({ color: "#e23b2f" });
+
+map.toggle3DBuildings(true); // подписка и стиль выделения уже применены к новому слою
+```
 
 #### Вкл/выкл 3D-здания на лету
 

package/dist/index.d.mts

@@ -175,9 +175,12 @@ interface IMaps3DBuildingsController {
 }
 interface IMaps3DBuildingClickInfo {
     id: string | number;
+    /** Атрибуты объекта; `props.osm_id` — идентификатор, который не меняется. */
+    props: Record<string, unknown>;
+    /** Высота здания в метрах. */
+    height: number;
+    /** Порядковый номер внутри сцены. Живёт до ближайшей пересборки геометрии. */
     index?: number;
-    height?: number;
-    props?: Record<string, unknown>;
     [key: string]: unknown;
 }
 interface IMaps3DObjectsLightOptions {
@@ -461,6 +464,10 @@ declare class MahalMap {
     private buildingsEnabled;
     private workerCheckTimer?;
     private styleChangeHandler?;
+    private pendingBuildingClick?;
+    private pendingRoadClick?;
+    private pendingSelectionStyle?;
+    private pendingLayerSubscribers;
     private constructor();
     private static getInstanceKey;
     private static normalizeLanguage;
@@ -592,7 +599,10 @@ declare class MahalMap {
     getLayerState(id: Maps3DLayerId): IMaps3DLayerState | null;
     /** Снимок всех слоёв — по нему приложение рисует свою панель. */
     getLayers(): IMaps3DLayerState[];
-    /** Подписка на изменения слоёв. Возвращает отписку (no-op, если слоя нет). */
+    /**
+     * Подписка на изменения слоёв. Возвращает отписку. Работает и до появления слоя:
+     * подписка переиграется при его подключении, а отписка снимет её в любом случае.
+     */
     onLayers(callback: (state: IMaps3DLayerState) => void): () => void;
     /** Пере-применить волю клиента ко всем слоям — после полной смены стиля. */
     refreshLayers(): void;
@@ -608,14 +618,21 @@ declare class MahalMap {
      * и метка окажется в чужом зале.
      */
     showPlace(lon: number, lat: number, level?: number | null, zoom?: number): void;
-    /** Клик по зданию: { id, height, props } либо null. Повторный вызов заменяет обработчик. */
+    /**
+     * Клик по зданию: { id, height, props } либо null. Повторный вызов заменяет обработчик.
+     * Подписываться можно сразу после create(), даже когда слой ещё не поднят
+     * (`enable3D: false`) — подписка переиграется, как только слой появится.
+     */
     onBuildingClick(callback: (info: IMaps3DBuildingClickInfo | null) => void): void;
     /** Выделить здание по osm_id. `false` — здания сейчас нет в загруженных данных. */
     selectBuilding(id: number | string | null, style?: IMaps3DSelectionStyle): boolean;
     clearSelection(): void;
     selectedBuilding(): number | string | null;
     setSelectionStyle(style: IMaps3DSelectionStyle): void;
-    /** Клик по дороге. Приходит независимо от клика по зданию — приоритет решает приложение. */
+    /**
+     * Клик по дороге. Приходит независимо от клика по зданию — приоритет решает приложение.
+     * Как и onBuildingClick, переживает отсутствие слоя на момент подписки.
+     */
     onRoadClick(callback: (hit: IMaps3DRoadHit | null) => void): void;
     /** Дорога под точкой холста. Допуск по умолчанию — 12 px. */
     roadAt(point: {
@@ -629,6 +646,12 @@ declare class MahalMap {
      * заведует реестр слоёв, а опции облика зданий приходят из options.maps3d как есть.
      */
     private createMaps3DLayer;
+    /**
+     * Переигрывает волю клиента на только что подключённом слое: подписки на клики,
+     * облик выделения и подписчиков реестра. Нужно, когда карта создана без слоя
+     * (`enable3D: false`) — тогда всё это было сказано до его появления.
+     */
+    private applyPendingSubscriptions;
     private attachMaps3DLayer;
     /**
      * Освобождает слой Maps3D одним доступным методом (destroy(), иначе remove()) и ровно один

package/dist/index.d.ts

@@ -175,9 +175,12 @@ interface IMaps3DBuildingsController {
 }
 interface IMaps3DBuildingClickInfo {
     id: string | number;
+    /** Атрибуты объекта; `props.osm_id` — идентификатор, который не меняется. */
+    props: Record<string, unknown>;
+    /** Высота здания в метрах. */
+    height: number;
+    /** Порядковый номер внутри сцены. Живёт до ближайшей пересборки геометрии. */
     index?: number;
-    height?: number;
-    props?: Record<string, unknown>;
     [key: string]: unknown;
 }
 interface IMaps3DObjectsLightOptions {
@@ -461,6 +464,10 @@ declare class MahalMap {
     private buildingsEnabled;
     private workerCheckTimer?;
     private styleChangeHandler?;
+    private pendingBuildingClick?;
+    private pendingRoadClick?;
+    private pendingSelectionStyle?;
+    private pendingLayerSubscribers;
     private constructor();
     private static getInstanceKey;
     private static normalizeLanguage;
@@ -592,7 +599,10 @@ declare class MahalMap {
     getLayerState(id: Maps3DLayerId): IMaps3DLayerState | null;
     /** Снимок всех слоёв — по нему приложение рисует свою панель. */
     getLayers(): IMaps3DLayerState[];
-    /** Подписка на изменения слоёв. Возвращает отписку (no-op, если слоя нет). */
+    /**
+     * Подписка на изменения слоёв. Возвращает отписку. Работает и до появления слоя:
+     * подписка переиграется при его подключении, а отписка снимет её в любом случае.
+     */
     onLayers(callback: (state: IMaps3DLayerState) => void): () => void;
     /** Пере-применить волю клиента ко всем слоям — после полной смены стиля. */
     refreshLayers(): void;
@@ -608,14 +618,21 @@ declare class MahalMap {
      * и метка окажется в чужом зале.
      */
     showPlace(lon: number, lat: number, level?: number | null, zoom?: number): void;
-    /** Клик по зданию: { id, height, props } либо null. Повторный вызов заменяет обработчик. */
+    /**
+     * Клик по зданию: { id, height, props } либо null. Повторный вызов заменяет обработчик.
+     * Подписываться можно сразу после create(), даже когда слой ещё не поднят
+     * (`enable3D: false`) — подписка переиграется, как только слой появится.
+     */
     onBuildingClick(callback: (info: IMaps3DBuildingClickInfo | null) => void): void;
     /** Выделить здание по osm_id. `false` — здания сейчас нет в загруженных данных. */
     selectBuilding(id: number | string | null, style?: IMaps3DSelectionStyle): boolean;
     clearSelection(): void;
     selectedBuilding(): number | string | null;
     setSelectionStyle(style: IMaps3DSelectionStyle): void;
-    /** Клик по дороге. Приходит независимо от клика по зданию — приоритет решает приложение. */
+    /**
+     * Клик по дороге. Приходит независимо от клика по зданию — приоритет решает приложение.
+     * Как и onBuildingClick, переживает отсутствие слоя на момент подписки.
+     */
     onRoadClick(callback: (hit: IMaps3DRoadHit | null) => void): void;
     /** Дорога под точкой холста. Допуск по умолчанию — 12 px. */
     roadAt(point: {
@@ -629,6 +646,12 @@ declare class MahalMap {
      * заведует реестр слоёв, а опции облика зданий приходят из options.maps3d как есть.
      */
     private createMaps3DLayer;
+    /**
+     * Переигрывает волю клиента на только что подключённом слое: подписки на клики,
+     * облик выделения и подписчиков реестра. Нужно, когда карта создана без слоя
+     * (`enable3D: false`) — тогда всё это было сказано до его появления.
+     */
+    private applyPendingSubscriptions;
     private attachMaps3DLayer;
     /**
      * Освобождает слой Maps3D одним доступным методом (destroy(), иначе remove()) и ровно один