mahal_map 1.6.16 → 1.6.17

package/README.md

@@ -12,16 +12,24 @@ npm install mahal_map maplibre-gl
 
 `maplibre-gl` является peer dependency. Его нужно установить в приложении или подключить отдельным browser script перед SDK.
 
-Для нового 3D-движка (`engine: "3d"`) дополнительно нужен `@osm/maps3d-web`. Пакет **не публикуется в npm** — скачайте его со страницы платформы (кнопка «Web SDK — стартер»; в Vue-стартере это папка `libs/maps3d-web` с уже собранным `dist/`), положите в проект и поставьте как локальную зависимость:
+Для нового 3D-движка (`engine: "3d"`) дополнительно нужен `@grammaps/maps3d-web`:
+
+```sh
+npm i @grammaps/maps3d-web maplibre-gl
+```
+
+`three` идёт зависимостью SDK, `maplibre-gl` — peer (экземпляр карты создаёте вы через `mahal_map`).
+
+Оффлайн-вариант: в стартере со страницы платформы лежит папка `libs/maps3d-web` со собранным `dist/` — ставится как локальная зависимость:
 
 ```sh
 npm i ./libs/maps3d-web maplibre-gl
 ```
 
-`package.json` запишет ссылку на локальную папку:
+`package.json` в этом случае запишет ссылку на локальную папку:
 
 ```json
-"@osm/maps3d-web": "file:./libs/maps3d-web"
+"@grammaps/maps3d-web": "file:./libs/maps3d-web"
 ```
 
 Без сборщика возьмите `lib/maps3d.global.js` из скачанного стартера (IIFE-глобал `Maps3D`, three бандлится внутрь) и подключите скриптом после `maplibre-gl`:
@@ -157,7 +165,7 @@ interface IMahalMapOptions {
 ```ts
 import maplibregl from "maplibre-gl";
 import "maplibre-gl/dist/maplibre-gl.css";
-import { Maps3D } from "@osm/maps3d-web";
+import { Maps3D } from "@grammaps/maps3d-web";
 import { MahalMap, keyUtils } from "mahal_map";
 
 keyUtils.saveKey("YOUR_MAP_API_KEY");
@@ -177,7 +185,7 @@ const map = MahalMap.create(
 );
 ```
 
-`Maps3D` (третий аргумент `create()`) — опционален: если не передан, SDK попробует взять его из `window.Maps3D`. `@osm/maps3d-web` — необязательный peer dependency, ставится только если используется `engine: "3d"`.
+`Maps3D` (третий аргумент `create()`) — опционален: если не передан, SDK попробует взять его из `window.Maps3D`. `@grammaps/maps3d-web` — необязательный peer dependency, ставится только если используется `engine: "3d"`.
 
 Получить слой Maps3D после создания карты:
 
@@ -187,7 +195,7 @@ const layer = map.getMaps3DLayer();
 MahalMap.getMaps3DLayer(map);
 ```
 
-`getMaps3DLayer()` возвращает реальный инстанс `Maps3D` (не обёртку) — типы `mahal_map` описывают всю его публичную поверхность, так что подключающему сервису не нужно ставить или типизировать `@osm/maps3d-web` отдельно.
+`getMaps3DLayer()` возвращает реальный инстанс `Maps3D` (не обёртку) — типы `mahal_map` описывают всю его публичную поверхность, так что подключающему сервису не нужно ставить или типизировать `@grammaps/maps3d-web` отдельно.
 
 ### Опции `maps3d` (расширенные)
 

package/dist/index.d.mts

@@ -248,6 +248,7 @@ declare class MahalMap {
     static getMap(instance: MahalMap): Map;
     static setStyle(instance: MahalMap, theme: Theme): void;
     static getMaps3DLayer(instance: MahalMap): IMaps3DLayer | undefined;
+    static toggle3DBuildings(instance: MahalMap, enabled: boolean): void;
     static setLanguage(instance: MahalMap, lang: MapLanguage): void;
     static setCenter(instance: MahalMap, center: [number, number]): void;
     static setZoom(instance: MahalMap, zoom: number): void;
@@ -259,6 +260,8 @@ declare class MahalMap {
     setStyle(theme: Theme): void;
     setLanguage(lang: MapLanguage): void;
     getMaps3DLayer(): IMaps3DLayer | undefined;
+    /** Вкл/выкл детальные 3D-здания (Maps3D). Работает только для engine: "3d". */
+    toggle3DBuildings(enabled: boolean): void;
     setCenter(center: [number, number]): void;
     setZoom(zoom: number): void;
     destroy(): void;

package/dist/index.d.ts

@@ -248,6 +248,7 @@ declare class MahalMap {
     static getMap(instance: MahalMap): Map;
     static setStyle(instance: MahalMap, theme: Theme): void;
     static getMaps3DLayer(instance: MahalMap): IMaps3DLayer | undefined;
+    static toggle3DBuildings(instance: MahalMap, enabled: boolean): void;
     static setLanguage(instance: MahalMap, lang: MapLanguage): void;
     static setCenter(instance: MahalMap, center: [number, number]): void;
     static setZoom(instance: MahalMap, zoom: number): void;
@@ -259,6 +260,8 @@ declare class MahalMap {
     setStyle(theme: Theme): void;
     setLanguage(lang: MapLanguage): void;
     getMaps3DLayer(): IMaps3DLayer | undefined;
+    /** Вкл/выкл детальные 3D-здания (Maps3D). Работает только для engine: "3d". */
+    toggle3DBuildings(enabled: boolean): void;
     setCenter(center: [number, number]): void;
     setZoom(zoom: number): void;
     destroy(): void;