mahal_map 1.7.3 → 2.0.1

package/dist/index.d.mts

@@ -19,21 +19,144 @@ interface IAdditionalParamType {
     limit?: number;
 }
 
+/**
+ * Поверхность @grammaps/maps3d-web, описанная локально. Пакет в зависимости не ставится —
+ * он приходит снаружи, как и maplibre-gl, поэтому импортировать его типы нельзя. Здесь
+ * повторена публичная часть .d.ts версии 0.7.3; всё необязательное помечено `?`, чтобы
+ * более старая сборка на странице не ломала типы у потребителя.
+ */
+type Maps3DThemeName = "light" | "dark" | "navigator-light" | "navigator-dark" | "mobile-light" | "mobile-dark";
+/** Уровень детализации зданий. */
+type Maps3DBuildingDetail = "footprint" | "volume" | "roofs" | "facade";
+/** Режим рельефа: `auto` показывает его на обзорных зумах, `on` — всегда (дороже по трафику и кадру). */
+type Maps3DTerrainMode = "auto" | "on" | "off";
+/**
+ * Параметры каждого слоя реестра. Служит и справочником, и источником типов:
+ * ключи дают список id, значения — допустимые `params` в setLayer().
+ *
+ * У самой Maps3D id слоя типизирован как `string`, поэтому опечатка там проходит
+ * компиляцию и проваливается в рантайме (setLayer вернёт false). Здесь список
+ * фиксирован по таблице слоёв 0.7.3 — промах ловится на сборке.
+ */
+interface IMaps3DLayerParams {
+    /** Объёмные здания. По умолчанию включён. */
+    buildings: {
+        detail?: Maps3DBuildingDetail;
+    };
+    /** Расставленные 3D-объекты. По умолчанию включён. */
+    objects: Record<string, never>;
+    /** Пробки векторным слоем. По умолчанию выключен. */
+    traffic: Record<string, never>;
+    /** Пробки картинкой с сервера, без клика по дороге. По умолчанию выключен. */
+    trafficRaster: Record<string, never>;
+    /**
+     * Парковки. По умолчанию включён. Подтип берётся из атрибута `fee`:
+     * `paid` — `fee=yes`, `free` — `fee=no`, `unknown` — атрибута нет.
+     */
+    parking: {
+        highlight?: boolean;
+        paid?: boolean;
+        free?: boolean;
+        unknown?: boolean;
+    };
+    /** Заправки. По умолчанию включён. */
+    fuel: Record<string, never>;
+    /** Зарядки. По умолчанию включён. */
+    charging: Record<string, never>;
+    /** Перекрытия дорог. По умолчанию выключен, требует своего тайлсета. */
+    closures: Record<string, never>;
+    /** Планы этажей. По умолчанию выключен, требует данных по зданию. */
+    indoor: {
+        level?: number;
+    };
+    /** Рельеф. По умолчанию `auto`. */
+    terrain: {
+        mode?: Maps3DTerrainMode;
+    };
+}
+/** Идентификатор слоя в реестре Maps3D. */
+type Maps3DLayerId = keyof IMaps3DLayerParams;
+/**
+ * Снимок состояния слоя. Три поля независимы: слой может быть включён клиентом (`wanted`),
+ * но не нарисован — рельеф в режиме auto ждёт обзорного зума, перекрытия ждут своего
+ * тайлсета, планы этажей — данных по зданию.
+ */
+interface IMaps3DLayerState {
+    /** Не сужен до Maps3DLayerId: сборка Maps3D может отдать слой, которого нет в нашем списке. */
+    id: string;
+    /** Чего хочет клиент: последний setLayer либо умолчание стиля. */
+    wanted: boolean;
+    /** Что позволяет стиль: объявлен ли слой и есть ли под него данные. */
+    available: boolean;
+    /** Что нарисовано прямо сейчас. Именно это поле показывает, включён слой на деле или нет. */
+    active: boolean;
+    /** Параметры слоя: у зданий — detail, у этажей — level, у рельефа — mode. */
+    params: Record<string, unknown>;
+}
+interface IMaps3DSelectionStyle {
+    color?: string | number;
+    opacity?: number;
+    glow?: number;
+    durationMs?: number;
+    easing?: "ease-out" | "linear";
+}
+interface IMaps3DRoadHit {
+    name: string;
+    nameRu?: string;
+    class?: string;
+    ref?: string;
+    props: Record<string, unknown>;
+    distancePx: number;
+}
 interface IMaps3DTrafficOptions {
     raster?: boolean;
     rasterMaxZoom?: number;
     graph?: string;
+    tilesUrl?: string;
+    clicks?: boolean;
+    opacity?: number;
+    minZoom?: number;
+    refreshMs?: number;
+    arrows?: boolean;
+    maxTileZoom?: number;
+}
+interface IMaps3DIndoorOptions {
+    level?: number;
+    [key: string]: unknown;
+}
+interface IMaps3DClosuresOptions {
+    [key: string]: unknown;
+}
+interface IMaps3DPlacesOptions {
+    highlight?: boolean;
+    paid?: boolean;
+    free?: boolean;
+    unknown?: boolean;
+    [key: string]: unknown;
+}
+interface IMaps3DBuildingsOptions {
+    detail?: Maps3DBuildingDetail;
+    [key: string]: unknown;
 }
 interface IMaps3DLayerOptions {
     apiKey?: string | null;
     base?: string;
-    buildings?: boolean | Record<string, unknown>;
+    /** Явный модуль maplibre-gl, если на странице несколько сборок. */
+    maplibre?: unknown;
+    endpoint?: string;
+    buildings?: boolean | IMaps3DBuildingsOptions;
     traffic?: boolean | IMaps3DTrafficOptions;
+    indoor?: boolean | IMaps3DIndoorOptions;
+    closures?: boolean | IMaps3DClosuresOptions;
+    places?: IMaps3DPlacesOptions;
     minZoom?: number;
     lodBias?: number;
     memoryBudget?: number;
     maskReplaced?: boolean;
     typeReplacements?: boolean;
+    modelsSource?: string;
+    modelsSourceLayer?: string;
+    modelsTilesUrl?: string;
 }
 interface IMaps3DBuildingsController {
     setWindows?(enabled: boolean): void;
@@ -51,6 +174,7 @@ interface IMaps3DBuildingsController {
 }
 interface IMaps3DBuildingClickInfo {
     id: string | number;
+    index?: number;
     height?: number;
     props?: Record<string, unknown>;
     [key: string]: unknown;
@@ -61,36 +185,94 @@ interface IMaps3DObjectsLightOptions {
     sky?: number;
     exposure?: number;
 }
+interface IMaps3DDiagnostics {
+    terrainActive: boolean;
+    drapeRefreshes: number;
+    contextLost: boolean;
+    buildings: unknown;
+}
 interface IMaps3DLayer {
     attach(map: Map): void | Promise<void>;
+    /** Есть у экземпляров из enhance(); у созданных конструктором готовность даёт сам attach(). */
+    readonly ready?: Promise<void>;
     destroy?(): void;
     remove?(): void;
+    setLayer?(id: string, on: boolean, params?: Record<string, unknown>): boolean;
+    layer?(id: string): IMaps3DLayerState | null;
+    layers?(): IMaps3DLayerState[];
+    onLayers?(callback: (state: IMaps3DLayerState) => void): () => void;
+    refreshLayers?(): void;
     buildings?: IMaps3DBuildingsController | null;
     setBuildingsEnabled?(enabled: boolean): void;
     onBuildingClick?(callback: (info: IMaps3DBuildingClickInfo | null) => void): void;
+    selectBuilding?(id: number | string | null, style?: IMaps3DSelectionStyle): boolean;
+    clearSelection?(): void;
+    selectedBuilding?(): number | string | null;
+    setSelectionStyle?(style: IMaps3DSelectionStyle): void;
+    onRoadClick?(callback: (hit: IMaps3DRoadHit | null) => void): void;
+    roadAt?(point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DRoadHit | null;
+    readonly roadsNamed?: boolean;
     traffic?: boolean;
     trafficRaster?: boolean;
     setTraffic?(enabled: boolean): void;
     setTrafficOpacity?(opacity: number): void;
     setTrafficClicks?(enabled: boolean): void;
     setTrafficRaster?(enabled: boolean): void;
+    setTrafficGraph?(graph: string): void;
     refreshTraffic?(): void;
+    setIndoor?(enabled: boolean): void;
+    setIndoorLevel?(level: number): void;
+    readonly indoorLevels?: number[];
+    refreshIndoor?(): void;
+    showPlace?(lon: number, lat: number, level?: number | null, zoom?: number): void;
     setObjectsLight?(options: IMaps3DObjectsLightOptions): void;
     setMinZoom?(zoom: number): void;
     refresh?(): Promise<void>;
     clearCache?(): Promise<void>;
+    diagnostics?(): IMaps3DDiagnostics;
 }
 interface IMaps3DTransformRequestOptions {
-    base: string;
+    base?: string;
     apiKey?: string | null;
 }
-type Maps3DTransformRequest = (options: IMaps3DTransformRequestOptions) => unknown;
+interface IMaps3DMapOptionsInput extends IMaps3DTransformRequestOptions {
+    /** Имя темы платформы либо полный URL своего стиля. */
+    style?: string;
+    antialias?: boolean;
+}
+interface IMaps3DMapOptionsResult {
+    style: string;
+    transformRequest: (url: string) => {
+        url: string;
+    };
+    canvasContextAttributes?: {
+        antialias: boolean;
+    };
+}
+type Maps3DTransformRequest = (options: IMaps3DTransformRequestOptions) => (url: string) => {
+    url: string;
+};
 type Maps3DCtor = (new (options: IMaps3DLayerOptions) => IMaps3DLayer) & {
     transformRequest: Maps3DTransformRequest;
+    /** Стиль + transformRequest + antialias одним объектом. Появился в 0.5.0. */
+    mapOptions?(options: IMaps3DMapOptionsInput): IMaps3DMapOptionsResult;
+    /** Адрес стиля по имени темы. Неизвестное имя — явная ошибка, а не тихий 404. */
+    styleUrl?(style?: string, base?: string): string;
+    /** Подключение к уже созданной карте; возвращает экземпляр с `ready`. */
+    enhance?(map: Map, options?: IMaps3DLayerOptions): IMaps3DLayer;
+    /** MapLibre с платформы вместе со своим воркером. */
+    maplibre?(options?: {
+        base?: string;
+    }): Promise<unknown>;
+    readonly maplibreVersion?: string;
 };
 
 interface IMahalMapOptions {
     container?: string | HTMLElement;
+    /** Полный URL своего стиля. Задан — SDK его не меняет, setStyle() становится no-op. */
     style?: string;
     theme?: Theme;
     lang?: MapLanguage;
@@ -98,20 +280,49 @@ interface IMahalMapOptions {
     zoom?: number;
     pitch?: number;
     bearing?: number;
-    autoAddVectorSource?: boolean;
-    /** "legacy" (default) — старый движок (mtile.gram.tj). "3d" — новый GramMaps движок (route.gram.tj) с поддержкой Maps3D. */
-    engine?: MapEngine;
-    /** Включает Maps3D слой (детальные 3D-здания). Работает только при engine: "3d". */
+    /** Подключает Maps3D (объём, объекты, пробки, рельеф, планы этажей). По умолчанию `true`. */
     enable3D?: boolean;
-    /** Домен платформы GramMaps для engine: "3d". По умолчанию https://route.gram.tj */
+    /** Домен платформы MahalMaps. По умолчанию https://navi.gram.tj */
     base?: string;
-    /** Имя пресета стиля GramMaps (напр. "standard-night") для engine: "3d". */
-    preset?: string;
-    /** Доп. опции Maps3D слоя (buildings, traffic, minZoom, lodBias, memoryBudget, ...). */
-    maps3d?: Omit<IMaps3DLayerOptions, "apiKey" | "base" | "buildings">;
+    /**
+     * Семейство стилей платформы. `theme` выбирает внутри него светлую/тёмную:
+     * "default" → light/dark, "navigator" → navigator-light/navigator-dark,
+     * "mobile" → mobile-light/mobile-dark.
+     */
+    family?: MapStyleFamily;
+    /**
+     * Явное имя темы платформы вместо пары `family` + `theme` (или полный URL стиля).
+     * Задано — стиль считается зафиксированным и setStyle() его не меняет.
+     */
+    preset?: Maps3DThemeName | string;
+    /**
+     * Сглаживание сцены. Без него тонкая геометрия 3D-объектов (перила, мачты, ряды сидений)
+     * на отдалении рассыпается в рябь. По умолчанию `true` при включённом 3D.
+     */
+    antialias?: boolean;
+    /** Опции Maps3D: buildings, traffic, indoor, closures, terrain, minZoom, lodBias, memoryBudget, ... */
+    maps3d?: Omit<IMaps3DLayerOptions, "apiKey" | "base">;
+    /**
+     * Диагностика неработающего веб-воркера MapLibre: если через 8 с после создания карты
+     * не разобран ни один векторный тайл, в консоль уходит предупреждение с причиной и
+     * решением. `false` отключает проверку, число задаёт свою задержку в мс.
+     */
+    workerCheck?: boolean | number;
+    /**
+     * @deprecated Игнорируется с 2.0.0. Движок один — платформа MahalMaps через
+     * @grammaps/maps3d-web. Без переданного Maps3D карта поднимается на запасном стиле.
+     */
+    engine?: MapEngine;
+    /**
+     * @deprecated Игнорируется с 2.0.0. Запасной векторный стиль применяется сам,
+     * когда Maps3D не передан.
+     */
+    autoAddVectorSource?: boolean;
 }
 type Theme = "dark" | "light";
+type MapStyleFamily = "default" | "navigator" | "mobile";
 type MapLanguage = "tj" | "ru";
+/** @deprecated Оставлен, чтобы не ломать компиляцию у потребителей. Значение не используется. */
 type MapEngine = "legacy" | "3d";
 
 interface MahalMapDefaultMarkerProps {
@@ -224,6 +435,8 @@ declare class MahalMap {
     private static instances;
     private static defaultLanguage;
     private static disposedMaps3DLayers;
+    /** Через сколько мс после создания карты проверяем, ожил ли веб-воркер MapLibre. */
+    private static readonly WORKER_CHECK_DELAY;
     private isReady;
     private readyCallbacks;
     private map;
@@ -235,26 +448,29 @@ declare class MahalMap {
     private options;
     private language;
     private instanceKey;
-    private engine;
     private gramBase;
-    private gramPreset;
+    private styleFamily;
     private presetIsExplicit;
     private maps3dCtor?;
     private maps3dLayer?;
     private maps3dReady?;
     private buildingsEnabled;
+    private workerCheckTimer?;
     private constructor();
     private static getInstanceKey;
     private static normalizeLanguage;
     static setDefaultLanguage(lang?: string | null): void;
-    private static getDefaultStyle;
-    private static getVectorStyle;
+    /**
+     * Запасной стиль: Maps3D не передан — стилей платформы взять неоткуда, поднимаем карту
+     * на старом векторном стиле mtile.gram.tj с подписью ?token=. 3D при этом не работает.
+     */
+    private static getFallbackStyle;
     private static getMapToken;
     private static getMaps3DCtor;
     /**
-     * Проверяет подписку JSApi перед созданием карты. Нужна только для legacy-движка
-     * (mtile.gram.tj): у engine: "3d" (GramMaps, navi.gram.tj) доступ контролирует сама
-     * платформа по ?key=, отдельная проверка там не применяется и пропускается.
+     * Проверяет подписку JSApi перед созданием карты. Нужна только на запасном стиле
+     * (mtile.gram.tj, когда Maps3D не передан): у платформы MahalMaps доступ контролирует
+     * она сама по ?key=, отдельная проверка там не применяется и пропускается.
      *
      * Fail-open: блокирует создание карты только при явном ответе сервиса success:false.
      * Сетевая ошибка (сервис недоступен, CORS, таймаут) карту не роняет — иначе падение
@@ -262,11 +478,25 @@ declare class MahalMap {
      */
     private static ensureJSApiSubscription;
     /**
-     * Асинхронный аналог create(): для engine: "legacy" сначала дожидается проверки подписки
-     * JSApi и, если её нет, не создаёт карту вообще (MapLibre-инстанс не строится).
-     * Для engine: "3d" — тот же create() без проверки.
+     * Асинхронный аналог create(): на запасном стиле (Maps3D не передан) сначала дожидается
+     * проверки подписки JSApi и, если её нет, не создаёт карту вообще (MapLibre-инстанс не
+     * строится). С Maps3D — тот же create() без проверки.
      */
     static createAsync(options: IMahalMapOptions, maplibreObject?: MapLibreApi, maps3dCtor?: Maps3DCtor): Promise<MahalMap>;
+    /**
+     * Имя темы платформы или полный URL стиля. Явный `style`/`preset` побеждает пару
+     * `family` + `theme`: оба считаются фиксацией стиля, и setStyle() их не трогает.
+     */
+    private static resolveStyleName;
+    /**
+     * Стиль + transformRequest + antialias от самого SDK. mapOptions() — документированная
+     * дверь (есть с 0.5.0); у сборок постарше собираем то же из styleUrl/transformRequest.
+     *
+     * Неизвестное имя темы SDK считает явной ошибкой (а не тихим 404) — переупаковываем её,
+     * чтобы в консоли было видно, что имя пришло из опций MahalMap.
+     */
+    private static buildPlatformMapOptions;
+    private static requireAbsoluteStyle;
     static create(options: IMahalMapOptions, maplibreObject?: MapLibreApi, maps3dCtor?: Maps3DCtor): MahalMap;
     static onReady(container: string, callback: (map: Map) => void): void;
     static getInstance(container: string): MahalMap;
@@ -279,6 +509,25 @@ declare class MahalMap {
     static getMaps3DLayer(instance: MahalMap): IMaps3DLayer | undefined;
     static whenMaps3DReady(instance: MahalMap): Promise<IMaps3DLayer | undefined>;
     static toggle3DBuildings(instance: MahalMap, enabled: boolean): void;
+    static setLayer<Id extends Maps3DLayerId>(instance: MahalMap, id: Id, on: boolean, params?: IMaps3DLayerParams[Id]): boolean;
+    static getLayerState(instance: MahalMap, id: Maps3DLayerId): IMaps3DLayerState | null;
+    static getLayers(instance: MahalMap): IMaps3DLayerState[];
+    static onLayers(instance: MahalMap, callback: (state: IMaps3DLayerState) => void): () => void;
+    static refreshLayers(instance: MahalMap): void;
+    static getIndoorLevels(instance: MahalMap): number[];
+    static setIndoorLevel(instance: MahalMap, level: number): void;
+    static refreshIndoor(instance: MahalMap): void;
+    static showPlace(instance: MahalMap, lon: number, lat: number, level?: number | null, zoom?: number): void;
+    static onBuildingClick(instance: MahalMap, callback: (info: IMaps3DBuildingClickInfo | null) => void): void;
+    static selectBuilding(instance: MahalMap, id: number | string | null, style?: IMaps3DSelectionStyle): boolean;
+    static clearSelection(instance: MahalMap): void;
+    static selectedBuilding(instance: MahalMap): string | number | null;
+    static setSelectionStyle(instance: MahalMap, style: IMaps3DSelectionStyle): void;
+    static onRoadClick(instance: MahalMap, callback: (hit: IMaps3DRoadHit | null) => void): void;
+    static roadAt(instance: MahalMap, point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DRoadHit | null;
     static setLanguage(instance: MahalMap, lang: MapLanguage): void;
     static setCenter(instance: MahalMap, center: [number, number]): void;
     static setZoom(instance: MahalMap, zoom: number): void;
@@ -287,17 +536,80 @@ declare class MahalMap {
     init(map: Map): void;
     getCamera(): CameraController;
     getMap(): Map;
+    /**
+     * Светлая/тёмная внутри выбранного семейства (`family`). Стиль, зафиксированный явным
+     * `style`/`preset`, не трогаем: его содержимое знает только тот, кто его задал.
+     * Без Maps3D менять нечего — карта на запасном стиле, у него варианта по теме нет.
+     */
     setStyle(theme: Theme): void;
+    private refreshLayersOnStyleLoad;
+    /**
+     * Язык подписей приходит из стиля платформы, отдельных URL по языкам больше нет —
+     * метод только запоминает выбор для остальных сервисов SDK (поиск, роутинг).
+     */
     setLanguage(lang: MapLanguage): void;
     getMaps3DLayer(): IMaps3DLayer | undefined;
-    /** Вкл/выкл детальные 3D-здания (Maps3D). Работает только для engine: "3d". */
+    /**
+     * Вкл/выкл объёмные здания. Штатные здания стиля прячет и возвращает сам Maps3D —
+     * руками их видимость мы больше не трогаем, иначе две стороны спорят за один слой.
+     */
     toggle3DBuildings(enabled: boolean): void;
     /**
-     * Промис готовности слоя Maps3D: резолвится после attach(), когда доступен layer.buildings.
-     * Нужен для тонкой настройки окон/света — до attach контроллера зданий ещё нет.
-     * Резолвится в undefined, если движок не "3d", слой выключен или attach упал.
+     * Промис готовности слоя Maps3D. У экземпляров из enhance() это его собственный `ready`,
+     * у созданных конструктором — завершение attach(). До него layer.buildings ещё нет.
+     * Резолвится в undefined, если слой выключен, Maps3D не передан или подключение упало.
      */
     whenMaps3DReady(): Promise<IMaps3DLayer | undefined>;
+    /**
+     * Включить/выключить слой. `params` типизирован под конкретный слой: `terrain` ждёт
+     * `{ mode }`, `buildings` — `{ detail }`, `indoor` — `{ level }`, у остальных параметров нет.
+     *
+     * Возвращает `false`, если такого слоя в подключённой сборке Maps3D нет или Maps3D не передан.
+     * Слой, которого ещё нет в нашем списке id, доступен напрямую:
+     * `map.getMaps3DLayer()?.setLayer?.("новый", true)`.
+     */
+    setLayer<Id extends Maps3DLayerId>(id: Id, on: boolean, params?: IMaps3DLayerParams[Id]): boolean;
+    /** Состояние слоя: wanted (воля клиента), available (позволяет стиль), active (нарисовано). */
+    getLayerState(id: Maps3DLayerId): IMaps3DLayerState | null;
+    /** Снимок всех слоёв — по нему приложение рисует свою панель. */
+    getLayers(): IMaps3DLayerState[];
+    /** Подписка на изменения слоёв. Возвращает отписку (no-op, если слоя нет). */
+    onLayers(callback: (state: IMaps3DLayerState) => void): () => void;
+    /** Пере-применить волю клиента ко всем слоям — после полной смены стиля. */
+    refreshLayers(): void;
+    /** Этажи, найденные в текущем виде карты. Пусто — данных по зданию нет. */
+    getIndoorLevels(): number[];
+    /** Переключить этаж. Нумерация OSM: 0 — первый наземный. */
+    setIndoorLevel(level: number): void;
+    /** Перечитать планы этажей — после правки картографом. */
+    refreshIndoor(): void;
+    /**
+     * Показать найденный объект и открыть его этаж. Ровно то, что нужно после поиска:
+     * у объектов внутри зданий приходит `level` — без него карта откроет первый этаж
+     * и метка окажется в чужом зале.
+     */
+    showPlace(lon: number, lat: number, level?: number | null, zoom?: number): void;
+    /** Клик по зданию: { id, height, props } либо null. Повторный вызов заменяет обработчик. */
+    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;
+    /** Клик по дороге. Приходит независимо от клика по зданию — приоритет решает приложение. */
+    onRoadClick(callback: (hit: IMaps3DRoadHit | null) => void): void;
+    /** Дорога под точкой холста. Допуск по умолчанию — 12 px. */
+    roadAt(point: {
+        x: number;
+        y: number;
+    }, tolerancePx?: number): IMaps3DRoadHit | null;
+    /** Есть ли в текущем стиле названия дорог. Нет — roadAt() всегда вернёт null. */
+    get roadsNamed(): boolean;
+    /**
+     * Создаёт слой Maps3D. `buildings` не форсируем в `true`: с 0.7.x видимостью объёма
+     * заведует реестр слоёв, а опции облика зданий приходят из options.maps3d как есть.
+     */
+    private createMaps3DLayer;
     private attachMaps3DLayer;
     /**
      * Освобождает слой Maps3D одним доступным методом (destroy(), иначе remove()) и ровно один
@@ -306,17 +618,29 @@ declare class MahalMap {
      * вызов teardown попал бы на уже освобождённый объект.
      */
     private static teardownMaps3DLayer;
-    private applyMaps3DBuildingMode;
     /**
-     * Прячет/показывает нативный слой зданий GramMaps-пресетов ("building-3d"), не задевая слои
-     * самого Maps3D. Нужно, иначе плоский слой стиля рисуется поверх процедурных 3D-зданий и
-     * визуально их перекрывает.
+     * Диагностика неработающего веб-воркера MapLibre.
+     *
+     * Симптом злой: тайлы приходят, но разобрать их некому — карта показывает пустой фон,
+     * а в консоли лежит только `Uncaught SyntaxError: Unexpected token '<'`, где нет ни слова
+     * ни про MapLibre, ни про воркер. Причина почти всегда одна: сборщик не перенёс файл
+     * воркера рядом со сборкой, и вместо скрипта сервер отдаёт index.html.
      *
-     * Только для встроенных пресетов (buildGramStyleUrl) — при пользовательском `options.style`
-     * мы не знаем структуру стиля, гасить слои по имени/source-layer небезопасно (можно случайно
-     * погасить чужую fill-extrusion, никак не связанную со зданиями GramMaps).
+     * Проверку вешаем на таймер от создания карты, а НЕ на событие "load": при мёртвом
+     * воркере стиль не дозагружается и "load" не приходит вовсе.
+     *
+     * Смотрим на результат, а не на события: у Maps3D свой сторож (`gn`) слушает
+     * `data{sourceDataType:"content"}`, но это событие приходит при регистрации источника,
+     * за ~30 мс и без единого тайла — тревога снимается раньше, чем что-то могло сломаться.
+     */
+    private watchWorkerHealth;
+    private reportBrokenWorker;
+    /**
+     * Приводит объём зданий к желаемому состоянию. Реестр слоёв (0.7.x) — основная дверь:
+     * он же прячет и возвращает штатные здания стиля. setBuildingsEnabled — путь для
+     * сборок Maps3D постарше, где реестра ещё нет.
      */
-    private setNativeBuildingsVisible;
+    private applyMaps3DBuildingMode;
     setCenter(center: [number, number]): void;
     setZoom(zoom: number): void;
     destroy(): void;
@@ -593,4 +917,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 IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DObjectsLightOptions, type IMaps3DTrafficOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type Maps3DCtor, 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 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 };