mahal_map 2.0.1 → 2.0.2

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as maplibre_gl from 'maplibre-gl';
 import { Map, FlyToOptions, Marker } from 'maplibre-gl';
 
 declare class CameraController {
@@ -263,10 +264,13 @@ type Maps3DCtor = (new (options: IMaps3DLayerOptions) => IMaps3DLayer) & {
     styleUrl?(style?: string, base?: string): string;
     /** Подключение к уже созданной карте; возвращает экземпляр с `ready`. */
     enhance?(map: Map, options?: IMaps3DLayerOptions): IMaps3DLayer;
-    /** MapLibre с платформы вместе со своим воркером. */
+    /**
+     * MapLibre с платформы вместе со своим воркером. Возвращает то же, что
+     * `import * as maplibregl from "maplibre-gl"` — декларации гарантирует peerDependency.
+     */
     maplibre?(options?: {
         base?: string;
-    }): Promise<unknown>;
+    }): Promise<typeof maplibre_gl>;
     readonly maplibreVersion?: string;
 };
 
@@ -456,6 +460,7 @@ declare class MahalMap {
     private maps3dReady?;
     private buildingsEnabled;
     private workerCheckTimer?;
+    private styleChangeHandler?;
     private constructor();
     private static getInstanceKey;
     private static normalizeLanguage;
@@ -542,7 +547,21 @@ declare class MahalMap {
      * Без Maps3D менять нечего — карта на запасном стиле, у него варианта по теме нет.
      */
     setStyle(theme: Theme): void;
-    private refreshLayersOnStyleLoad;
+    /**
+     * Адрес стиля по имени темы. mapOptions() — основной контракт (есть с 0.5.0);
+     * styleUrl остаётся запасным путём для сборок, где mapOptions ещё нет.
+     * Раньше здесь был только styleUrl, и сборка с одним mapOptions() тему не меняла.
+     */
+    private resolvePlatformStyle;
+    /**
+     * Полная смена стиля уносит слои Maps3D вместе с ним — реестр умеет вернуть волю
+     * клиента, но только когда новый стиль уже загружен.
+     *
+     * Слушаем styledata, а не style.load: setStyle() идёт через дифф и style.load при
+     * этом не поднимает — с ним восстановление просто не случалось. styledata приходит
+     * многократно, поэтому ждём isStyleLoaded() и снимаем обработчик сами.
+     */
+    private refreshLayersOnStyleChange;
     /**
      * Язык подписей приходит из стиля платформы, отдельных URL по языкам больше нет —
      * метод только запоминает выбор для остальных сервисов SDK (поиск, роутинг).