mahal_map 2.0.0 → 2.0.1

package/README.md

@@ -12,7 +12,7 @@ npm install mahal_map maplibre-gl @grammaps/maps3d-web
 
 Обе зависимости — `peerDependencies`, в бандл `mahal_map` они не входят. Библиотека их не импортирует: MapLibre и `Maps3D` приходят снаружи, аргументами `create()` либо через `window`.
 
-- `maplibre-gl` (3–6) — обязателен всегда.
+- `maplibre-gl` (`^6.10.0`) — обязателен всегда.
 - `@grammaps/maps3d-web` (>=0.5.0) — даёт стили, тайлы, объём, пробки, рельеф, планы этажей, клик по объектам. Помечен `optional`: без него карта поднимется на запасном векторном стиле, но 3D и слоёв платформы на ней не будет.
 
 MapLibre можно не класть в свою сборку вовсе — платформа отдаёт согласованную версию вместе с веб-воркером:
@@ -21,6 +21,49 @@ MapLibre можно не класть в свою сборку вовсе — п
 const maplibregl = await Maps3D.maplibre({ base: "https://navi.gram.tj" });
 ```
 
+## Веб-воркер MapLibre
+
+MapLibre разбирает векторные тайлы в веб-воркере и ищет его файл рядом со своим модулем. Сборщик складывает библиотеку в общий бандл, рядом файла не оказывается, и вместо скрипта сервер отдаёт `index.html`.
+
+Симптом обманчивый: **карта показывает пустой фон, ошибок про карту нет**. В консоли лежит только `Uncaught SyntaxError: Unexpected token '<'` — ни слова ни про MapLibre, ни про воркер, ни про тайлы.
+
+`mahal_map` это распознаёт сам. Если через 8 с после создания карты не разобран ни один векторный тайл, в консоль уходит предупреждение с причиной и обоими решениями:
+
+```
+[MahalMap SDK] Карта пуста: ни один векторный тайл не разобран — похоже, не запустился веб-воркер MapLibre.
+```
+
+Проверка молчит на растровых стилях (им воркер не нужен), в фоновой вкладке (там MapLibre приостановлен) и когда фичи отрисованы. Отключается через `workerCheck: false`, своя задержка — `workerCheck: 12000`.
+
+### Решение 1 — взять библиотеку у платформы
+
+Версия согласована с Maps3D, веб-воркер приезжает вместе с ней, настраивать нечего:
+
+```ts
+const maplibregl = await Maps3D.maplibre({ base: "https://navi.gram.tj" });
+
+const map = MahalMap.create({ container: "map" }, maplibregl, Maps3D);
+```
+
+### Решение 2 — оставить свою сборку
+
+Тогда адрес воркера нужно свести с реальным файлом — и в разработке, и в собранной версии:
+
+```ts
+// vite.config.ts — чтобы адрес воркера совпал с файлом во время разработки
+export default defineConfig({ optimizeDeps: { exclude: ["maplibre-gl"] } });
+```
+
+```ts
+// в приложении — чтобы адрес совпал и в собранной версии
+import * as maplibregl from "maplibre-gl";
+import "maplibre-gl/dist/maplibre-gl.css";
+
+maplibregl.setWorkerUrl("/maplibre-gl-worker.mjs"); // файл скопирован в public/ из maplibre-gl/dist
+```
+
+> `import * as maplibregl` — не случайность: в MapLibre 6 default-экспорта нет, `import maplibregl from "maplibre-gl"` даёт `undefined`.
+
 ## Миграция с 1.x на 2.0
 
 Собственных URL стилей у `mahal_map` больше нет — их целиком отдаёт `@grammaps/maps3d-web`.
@@ -58,7 +101,7 @@ const maplibregl = await Maps3D.maplibre({ base: "https://navi.gram.tj" });
 ## Быстрый старт через NPM
 
 ```ts
-import maplibregl from "maplibre-gl";
+import * as maplibregl from "maplibre-gl";
 import "maplibre-gl/dist/maplibre-gl.css";
 import { Maps3D } from "@grammaps/maps3d-web";
 import { MahalMap, keyUtils } from "mahal_map";
@@ -87,28 +130,30 @@ const map = MahalMap.create(
 
 ## Быстрый старт через Browser SDK
 
-Сначала подключите MapLibre, затем `mahal_map.sdk.js`. Для browser SDK параметр `apikey` обязателен: без него карта не инициализируется.
+Для browser SDK параметр `apikey` обязателен: без него карта не инициализируется.
+
+**MapLibre 6 поставляется только как ESM** — классической сборки `dist/maplibre-gl.js` для `<script src>` в ней больше нет. Поэтому библиотеку карты подключают модульным скриптом и передают в `create()` вторым аргументом:
 
 ```html
 <link
   rel="stylesheet"
-  href="https://unpkg.com/maplibre-gl@5.3.0/dist/maplibre-gl.css"
+  href="https://cdn.jsdelivr.net/npm/maplibre-gl@6.10.0/dist/maplibre-gl.css"
 />
-<script src="https://unpkg.com/maplibre-gl@5.3.0/dist/maplibre-gl.js"></script>
 <script src="https://cp.mahal.tj/sdk/mahal_map.sdk.js?apikey=YOUR_MAP_API_KEY"></script>
-```
-
-После этого глобальный объект `MahalMap` доступен в `window`:
 
-```html
 <div id="map" style="width: 100%; height: 500px"></div>
 
-<script>
-  const map = MahalMap.create({
-    container: "map",
-    center: [69.624024, 40.279687],
-    zoom: 12,
-  });
+<script type="module">
+  import * as maplibregl from "https://cdn.jsdelivr.net/npm/maplibre-gl@6.10.0/+esm";
+
+  const map = MahalMap.create(
+    {
+      container: "map",
+      center: [69.624024, 40.279687],
+      zoom: 12,
+    },
+    maplibregl,
+  );
 </script>
 ```
 
@@ -131,7 +176,7 @@ const map = MahalMap.create(
 <script src="https://cp.mahal.tj/sdk/mahal_map.sdk.js?apikey=YOUR_MAP_API_KEY&lang=ru"></script>
 ```
 
-Если `lang` не передан или передан `lang=tj`, SDK добавляет только `token`.
+`lang` влияет на поиск и роутинг, но не на стиль: подписи на карте приходят из самого стиля платформы.
 
 ## Параметры создания карты
 
@@ -156,6 +201,7 @@ interface IMahalMapOptions {
   family?: "default" | "navigator" | "mobile";
   preset?: Maps3DThemeName | string;
   antialias?: boolean;
+  workerCheck?: boolean | number;
   maps3d?: Omit<IMaps3DLayerOptions, "apiKey" | "base">;
 }
 ```
@@ -175,6 +221,7 @@ interface IMahalMapOptions {
 | `family`    | `"default" \| "navigator" \| "mobile"` | Семейство стилей. `theme` выбирает внутри него: `default` → `light`/`dark`, `navigator` → `navigator-light`/`navigator-dark`, `mobile` → `mobile-*`.   |
 | `preset`    | `Maps3DThemeName \| string`           | Явное имя темы платформы или полный URL стиля вместо пары `family` + `theme`. Задан — стиль зафиксирован.                                                 |
 | `antialias` | `boolean`                             | Сглаживание сцены. По умолчанию `true` при включённом 3D: без него тонкая геометрия (перила, мачты, ряды сидений) на отдалении рассыпается в рябь.        |
+| `workerCheck` | `boolean \| number`                 | Диагностика неработающего веб-воркера MapLibre через 8 с после создания карты. `false` отключает, число задаёт свою задержку в мс. См. [Веб-воркер MapLibre](#веб-воркер-maplibre). |
 | `maps3d`    | `object`                              | Опции Maps3D: `buildings`, `traffic`, `indoor`, `closures`, `places`, `minZoom`, `lodBias`, `memoryBudget`, `maskReplaced`, `typeReplacements`.           |
 
 ### Стили и темы
@@ -234,38 +281,133 @@ map.setStyle("light"); // → navigator-light
 
 ### Реестр слоёв
 
-Единая дверь ко всем слоям платформы. Состояние слоя — три независимых поля: `wanted` (чего хочет приложение), `available` (что позволяют стиль и данные), `active` (что нарисовано сейчас).
+Единая дверь ко всем слоям платформы. Идентификаторы и параметры типизированы: опечатка в имени слоя или в значении параметра — ошибка компиляции, а не тихий `false` в рантайме.
 
 ```ts
 map.setLayer("terrain", true, { mode: "on" });
 map.setLayer("traffic", true);
 map.setLayer("indoor", true, { level: 2 });
+map.setLayer("buildings", true, { detail: "facade" });
 
+map.getLayerState("terrain"); // снимок одного слоя или null
+map.getLayers(); // снимок всех — по нему рисуется панель слоёв
+```
+
+| Слой               | Параметры                                  | По умолчанию |
+| ------------------ | ------------------------------------------ | ------------ |
+| `buildings`        | `detail: footprint\|volume\|roofs\|facade`   | включён      |
+| `objects`          | —                                          | включён      |
+| `traffic`          | —                                          | выключен     |
+| `trafficRaster`    | —                                          | выключен     |
+| `parking`          | `highlight`, `paid`, `free`, `unknown`     | включён      |
+| `fuel`, `charging` | —                                          | включены     |
+| `closures`         | —                                          | выключен     |
+| `indoor`           | `level`                                    | выключен     |
+| `terrain`          | `mode: auto\|on\|off`                       | `auto`       |
+
+Стартовое состояние можно задать сразу при создании карты — тогда первый кадр уже правильный, без моргания:
+
+```ts
+MahalMap.create(
+  { container: "map", maps3d: { traffic: true, closures: true } },
+  maplibregl,
+  Maps3D,
+);
+```
+
+Полный список — в разделе [Опции `maps3d`](#опции-maps3d-расширенные).
+
+#### `wanted`, `available`, `active` — три разных вопроса
+
+Поля независимы, и это главная ловушка реестра:
+
+| Поле        | Вопрос                                  |
+| ----------- | --------------------------------------- |
+| `wanted`    | чего хочет приложение                   |
+| `available` | что позволяют стиль и данные            |
+| `active`    | что нарисовано прямо сейчас             |
+
+Слой может быть включён и при этом не нарисован — и это не ошибка:
+
+```ts
+map.setLayer("terrain", true); // wanted: true
+const state = map.getLayerState("terrain");
+
+state?.available; // false — в стиле нет ключа maps3d:terrain
+state?.active; // false — либо режим auto, а зум слишком близкий
+```
+
+Поэтому галочку в интерфейсе рисуют по `wanted`, а пометку «сейчас не видно» — по `active`. Проверять сразу после `setLayer()` бесполезно: тайлы ещё едут. Правильный способ — подписка.
+
+#### Панель слоёв: подписка и отписка
+
+`onLayers()` возвращает функцию отписки. Звать её обязательно — иначе колбэк переживёт компонент и будет дёргать размонтированное состояние:
+
+```ts
 const unsubscribe = map.onLayers((state) => {
   console.log(state.id, state.wanted, state.available, state.active);
 });
 
-map.getLayerState("terrain"); // снимок одного слоя или null
-map.getLayers(); // снимок всех — по нему рисуется панель слоёв
+// при размонтировании компонента
+unsubscribe();
+```
+
+`map.destroy()` снимает слой Maps3D целиком, так что после него подписка всё равно мертва — но до него отписываться нужно самим.
+
+#### Парковки, заправки, зарядки
+
+`Maps3D` рисует их сам, забирая эти классы у POI-слоёв стиля. Поэтому выключение слоя убирает объекты с карты полностью, а не оставляет значок стиля.
+
+Подтип парковки берётся из атрибута `fee`:
+
+| Параметр    | Условие         |
+| ----------- | --------------- |
+| `paid`      | `fee=yes`       |
+| `free`      | `fee=no`        |
+| `unknown`   | атрибута нет    |
+
+```ts
+// только платные, с подсветкой
+map.setLayer("parking", true, { paid: true, free: false, unknown: false, highlight: true });
 ```
 
-| Слой               | Параметры                                | По умолчанию |
-| ------------------ | ---------------------------------------- | ------------ |
-| `buildings`        | `detail: footprint\|volume\|roofs\|facade` | включён    |
-| `objects`          | —                                        | включён      |
-| `traffic`          | —                                        | выключен     |
-| `trafficRaster`    | —                                        | выключен     |
-| `parking`          | `highlight`, `paid`, `free`, `unknown`   | включён      |
-| `fuel`, `charging` | —                                        | включены     |
-| `closures`         | —                                        | выключен     |
-| `indoor`           | `level`                                  | выключен     |
-| `terrain`          | `mode: auto\|on\|off`                     | `auto`       |
+#### Рельеф
 
-Слой может быть включён и при этом не нарисован: рельеф в режиме `auto` появляется на обзорных зумах, перекрытия требуют своего тайлсета, планы этажей — данных по зданию. Рельеф в режиме `on` заметно дороже по трафику и времени кадра.
+`auto` показывает рельеф на обзорных зумах, `on` — всегда. Режим `on` заметно дороже по трафику и времени кадра, чем `auto`.
 
-Парковки, заправки и зарядки `Maps3D` рисует сам, забирая эти классы у POI-слоёв стиля, — поэтому выключение слоя убирает объекты с карты полностью, а не оставляет значок стиля.
+```ts
+map.setLayer("terrain", true, { mode: "auto" });
+```
+
+#### Планы этажей
+
+Слой включается реестром, но одного этого мало — без переключения этажа он бесполезен:
+
+```ts
+map.setLayer("indoor", true);
+
+const levels = map.getIndoorLevels(); // этажи в текущем виде карты, [] — данных нет
+map.setIndoorLevel(1); // нумерация OSM: 0 — первый наземный
+map.refreshIndoor(); // перечитать после правки картографом
+```
+
+После поиска показать найденный объект вместе с его этажом:
+
+```ts
+// level приходит у объектов внутри зданий; без него откроется первый этаж
+// и метка окажется в чужом зале
+map.showPlace(68.787, 38.573, place.level, 18);
+```
+
+#### Слой, которого нет в списке
 
-`setLayer()` возвращает `false`, если такого слоя в подключённой сборке Maps3D нет (или Maps3D не передан вовсе). После полной смены стиля волю клиента возвращает `map.refreshLayers()` — при `setStyle()` библиотека вызывает его сама.
+`setLayer()` принимает только известные идентификаторы. Если в новой сборке Maps3D появится слой, которого ещё нет в типах, — он доступен напрямую через слой, там `id` остаётся строкой:
+
+```ts
+map.getMaps3DLayer()?.setLayer?.("новый-слой", true);
+```
+
+`setLayer()` возвращает `false`, если такого слоя в подключённой сборке Maps3D нет или Maps3D не передан вовсе. После полной смены стиля волю клиента возвращает `map.refreshLayers()` — при `setStyle()` библиотека вызывает его сама.
 
 ### 3D-здания
 
@@ -367,15 +509,16 @@ layer?.buildings?.setWindowStyle(4);
 
 ### Подключение и выключение 3D-слоя: полный пример (Vue 3)
 
-Кнопка-переключатель «3D ⇄ контуры», тонкая настройка окон и корректная очистка при размонтировании. Слой `Maps3D` поднимает и цепляет сама библиотека — вручную `new Maps3D(...)`, `transformRequest` и `attach()` писать не нужно.
+Кнопка-переключатель «3D ⇄ контуры», панель слоёв на живом состоянии реестра и корректная очистка при размонтировании. Слой `Maps3D` поднимает и цепляет сама библиотека — вручную `Maps3D.enhance(...)`, `transformRequest` и `attach()` писать не нужно.
 
 ```vue
 <script setup lang="ts">
 import { computed, onBeforeUnmount, onMounted, ref, shallowRef } from "vue";
-import maplibregl from "maplibre-gl";
+import * as maplibregl from "maplibre-gl";
 import "maplibre-gl/dist/maplibre-gl.css";
 import { Maps3D } from "@grammaps/maps3d-web";
 import { MahalMap, keyUtils } from "mahal_map";
+import type { IMaps3DLayerState, Maps3DLayerId } from "mahal_map";
 
 const API_KEY = "YOUR_MAP_API_KEY";
 
@@ -383,6 +526,15 @@ const mahalMap = shallowRef<MahalMap | null>(null);
 const is3dEnabled = ref(true);
 const isLayerReady = ref(false);
 
+// Панель слоёв рисуется по живому снимку реестра
+const layers = ref<IMaps3DLayerState[]>([]);
+let unsubscribeLayers: (() => void) | null = null;
+
+function toggleLayer(id: Maps3DLayerId, on: boolean) {
+  // Опечатка в id или в параметрах не скомпилируется
+  mahalMap.value?.setLayer(id, on);
+}
+
 const buildingModeText = computed(() =>
   is3dEnabled.value ? "3D включено" : "Контуры",
 );
@@ -433,11 +585,21 @@ onMounted(async () => {
   buildings.setWindowGlow?.(0.22);
   buildings.setEdgeRadius(1.2);
 
+  // Слои: стартовый снимок плюс подписка на изменения.
+  // Состояние приходит асинхронно — сразу после setLayer() проверять бесполезно.
+  layers.value = map.getLayers();
+  unsubscribeLayers = map.onLayers(() => {
+    layers.value = map.getLayers();
+  });
+
   isLayerReady.value = true;
 });
 
 onBeforeUnmount(() => {
   isLayerReady.value = false;
+  // Отписку снимаем сами: иначе колбэк переживёт компонент.
+  unsubscribeLayers?.();
+  unsubscribeLayers = null;
   // destroy() сам снимает слой Maps3D и удаляет карту MapLibre.
   mahalMap.value?.destroy();
   mahalMap.value = null;
@@ -458,6 +620,24 @@ onBeforeUnmount(() => {
       >
         {{ buildingToggleText }}
       </button>
+
+      <ul class="layers">
+        <li v-for="layer in layers" :key="layer.id">
+          <label>
+            <!-- галочка по wanted: это воля приложения -->
+            <input
+              type="checkbox"
+              :checked="layer.wanted"
+              :disabled="!layer.available"
+              @change="toggleLayer(layer.id as Maps3DLayerId, !layer.wanted)"
+            />
+            {{ layer.id }}
+          </label>
+          <!-- слой включён, но не нарисован — это норма, а не ошибка -->
+          <small v-if="layer.wanted && !layer.active">сейчас не видно</small>
+          <small v-else-if="!layer.available">нет в стиле</small>
+        </li>
+      </ul>
     </section>
   </main>
 </template>
@@ -492,15 +672,18 @@ onBeforeUnmount(() => {
 
 #### То же самое без сборщика (browser SDK)
 
+Библиотеку карты проще взять у платформы: версия согласована с Maps3D, веб-воркер приезжает вместе с ней, про ESM-сборку думать не нужно.
+
 ```html
-<script src="https://unpkg.com/maplibre-gl@5.3.0/dist/maplibre-gl.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/@grammaps/maps3d-web/dist/maps3d.global.js"></script>
 <script src="https://cp.mahal.tj/sdk/mahal_map.sdk.js?apikey=YOUR_MAP_API_KEY"></script>
 
 <div id="map" style="width: 100%; height: 500px"></div>
 <button id="toggle3d" type="button">Выключить 3D</button>
 
-<script>
+<script type="module">
+  const maplibregl = await Maps3D.maplibre({ base: "https://navi.gram.tj" });
+
   // Maps3D берётся из window.Maps3D — третий аргумент передавать не нужно.
   const map = MahalMap.create({
     container: "map",
@@ -637,7 +820,7 @@ try {
 </template>
 
 <script setup lang="ts">
-import maplibregl from "maplibre-gl";
+import * as maplibregl from "maplibre-gl";
 import "maplibre-gl/dist/maplibre-gl.css";
 import type { MahalMap as MahalMapInstance } from "mahal_map";
 import { onBeforeUnmount, onMounted, ref } from "vue";
@@ -884,6 +1067,12 @@ MahalMap.getLayers(map);
 MahalMap.onLayers(map, (state) => console.log(state.id, state.active));
 MahalMap.refreshLayers(map);
 
+// Планы этажей
+MahalMap.getIndoorLevels(map);
+MahalMap.setIndoorLevel(map, 1);
+MahalMap.refreshIndoor(map);
+MahalMap.showPlace(map, 68.787, 38.573, 2, 18);
+
 // Выделение зданий и клики
 MahalMap.onBuildingClick(map, (building) => console.log(building?.id));
 MahalMap.selectBuilding(map, 123456789);
@@ -939,6 +1128,10 @@ MahalMap.setZoom(map, 14);
 | `getLayers(instance)`                  | Снимок всех слоёв.                                            |
 | `onLayers(instance, callback)`         | Подписка на изменения слоёв; возвращает отписку.              |
 | `refreshLayers(instance)`              | Пере-применить волю клиента ко всем слоям.                    |
+| `getIndoorLevels(instance)`            | Этажи, найденные в текущем виде карты.                        |
+| `setIndoorLevel(instance, level)`      | Переключить этаж (0 — первый наземный).                       |
+| `refreshIndoor(instance)`              | Перечитать планы этажей.                                      |
+| `showPlace(instance, lon, lat, level?, zoom?)` | Показать объект и открыть его этаж.                   |
 | `onBuildingClick(instance, callback)`  | Клик по зданию.                                               |
 | `selectBuilding(instance, id, style?)` | Выделить здание по `osm_id`.                                  |
 | `clearSelection(instance)`             | Снять выделение.                                              |

package/dist/index.d.mts

@@ -26,17 +26,64 @@ interface IAdditionalParamType {
  * более старая сборка на странице не ломала типы у потребителя.
  */
 type Maps3DThemeName = "light" | "dark" | "navigator-light" | "navigator-dark" | "mobile-light" | "mobile-dark";
-/** Идентификатор слоя в реестре: buildings, objects, traffic, terrain, indoor, closures, parking, fuel, charging. */
-type Maps3DLayerId = string;
 /** Уровень детализации зданий. */
 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 {
-    id: Maps3DLayerId;
+    /** Не сужен до Maps3DLayerId: сборка Maps3D может отдать слой, которого нет в нашем списке. */
+    id: string;
     /** Чего хочет клиент: последний setLayer либо умолчание стиля. */
     wanted: boolean;
     /** Что позволяет стиль: объявлен ли слой и есть ли под него данные. */
@@ -150,8 +197,8 @@ interface IMaps3DLayer {
     readonly ready?: Promise<void>;
     destroy?(): void;
     remove?(): void;
-    setLayer?(id: Maps3DLayerId, on: boolean, params?: Record<string, unknown>): boolean;
-    layer?(id: Maps3DLayerId): IMaps3DLayerState | null;
+    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;
@@ -255,6 +302,12 @@ interface IMahalMapOptions {
     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 карта поднимается на запасном стиле.
@@ -382,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;
@@ -400,6 +455,7 @@ declare class MahalMap {
     private maps3dLayer?;
     private maps3dReady?;
     private buildingsEnabled;
+    private workerCheckTimer?;
     private constructor();
     private static getInstanceKey;
     private static normalizeLanguage;
@@ -453,11 +509,15 @@ 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(instance: MahalMap, id: Maps3DLayerId, on: boolean, params?: Record<string, unknown>): boolean;
+    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;
@@ -500,8 +560,15 @@ declare class MahalMap {
      * Резолвится в undefined, если слой выключен, Maps3D не передан или подключение упало.
      */
     whenMaps3DReady(): Promise<IMaps3DLayer | undefined>;
-    /** Включить/выключить слой. `false` — такого слоя в подключённой сборке Maps3D нет. */
-    setLayer(id: Maps3DLayerId, on: boolean, params?: Record<string, unknown>): boolean;
+    /**
+     * Включить/выключить слой. `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;
     /** Снимок всех слоёв — по нему приложение рисует свою панель. */
@@ -510,6 +577,18 @@ declare class MahalMap {
     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` — здания сейчас нет в загруженных данных. */
@@ -539,6 +618,23 @@ declare class MahalMap {
      * вызов teardown попал бы на уже освобождённый объект.
      */
     private static teardownMaps3DLayer;
+    /**
+     * Диагностика неработающего веб-воркера MapLibre.
+     *
+     * Симптом злой: тайлы приходят, но разобрать их некому — карта показывает пустой фон,
+     * а в консоли лежит только `Uncaught SyntaxError: Unexpected token '<'`, где нет ни слова
+     * ни про MapLibre, ни про воркер. Причина почти всегда одна: сборщик не перенёс файл
+     * воркера рядом со сборкой, и вместо скрипта сервер отдаёт index.html.
+     *
+     * Проверку вешаем на таймер от создания карты, а НЕ на событие "load": при мёртвом
+     * воркере стиль не дозагружается и "load" не приходит вовсе.
+     *
+     * Смотрим на результат, а не на события: у Maps3D свой сторож (`gn`) слушает
+     * `data{sourceDataType:"content"}`, но это событие приходит при регистрации источника,
+     * за ~30 мс и без единого тайла — тревога снимается раньше, чем что-то могло сломаться.
+     */
+    private watchWorkerHealth;
+    private reportBrokenWorker;
     /**
      * Приводит объём зданий к желаемому состоянию. Реестр слоёв (0.7.x) — основная дверь:
      * он же прячет и возвращает штатные здания стиля. setBuildingsEnabled — путь для
@@ -821,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 IMaps3DBuildingsOptions, type IMaps3DClosuresOptions, type IMaps3DDiagnostics, type IMaps3DIndoorOptions, type IMaps3DLayer, type IMaps3DLayerOptions, 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 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 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 };