mahal_map 1.6.23 → 1.7.0

package/README.md

@@ -938,7 +938,26 @@ const measureTool = new MeasureTool(map, {
 | `removePoint(shapeId, pointId)` | Удаляет одну точку фигуры.                                                                                                      |
 | `clearAll()`                    | Удаляет все фигуры и черновик.                                                                                                  |
 | `getState()`                    | Возвращает текущий `MeasureState` (снимок, без подписки).                                                                       |
-| `destroy()`                     | Полностью снимает слои, обработчики и DOM-бейджи. Вызывать при размонтировании.                                                 |
+| `setStyleOptions(style)`        | Обновляет палитру (частично, `Partial<MeasureStyleOptions>`) без пересоздания инструмента: перекрашивает существующие слои и бейджи. Нужен при смене темы карты. |
+| `refresh()`                     | Пересоздает источники/слои и перерисовывает фигуры. Инструмент делает это сам после `setStyle()`; метод оставлен как страховка. |
+| `destroy()`                     | Полностью снимает слои, обработчики и DOM-бейджи. Вызывать при размонтировании. Повторный вызов безопасен.                      |
+
+### Смена стиля карты (тема, язык)
+
+`map.setStyle()` — а значит и `mahalMap.setStyle('dark')`, и смена языка — применяется MapLibre диффом: все слои, добавленные в рантайме, удаляются как отсутствующие в новом стиле, и событие `style.load` при этом не эмитится. `MeasureTool` переживает это сам: он слушает `styledata` и восстанавливает источники/слои с теми же id, а `render()` создает недостающие слои при каждой отрисовке. Фигуры, черновик и `getState()` не меняются, лишних `onChange` не будет.
+
+Хосту делать ничего не нужно — обходы вида `map.fire('style.load')` после `setStyle()` можно убирать. Цвета за темой карты не следуют автоматически: после переключения вызовите `setStyleOptions()` с новой палитрой.
+
+```ts
+mahalMap.setStyle("dark");
+measureTool.setStyleOptions({
+  lineColor: "#4ADE80",
+  pointStrokeColor: "#4ADE80",
+  fillColor: "#4ADE80",
+  badgeBackground: "#19191A",
+  badgeTextColor: "#FFFFFF",
+});
+```
 
 ### Взаимодействие на карте
 

package/dist/index.d.mts

@@ -403,6 +403,8 @@ declare class MeasureTool {
     private labels;
     private originalCursor;
     private layerHandlersBound;
+    private destroyed;
+    private ensuringLayers;
     private pointsSourceId;
     private linesSourceId;
     private fillsSourceId;
@@ -435,6 +437,7 @@ declare class MeasureTool {
     private handleLineMouseLeave;
     private handleLineMouseDown;
     private handleStyleLoad;
+    private handleStyleData;
     private handleViewportChange;
     constructor(map: Map, options?: MeasureToolOptions);
     private bindLayerHandlers;
@@ -446,6 +449,17 @@ declare class MeasureTool {
     removeShape(shapeId: string): void;
     removePoint(shapeId: string, pointId: string): void;
     clearAll(): void;
+    /**
+     * Пересоздаёт источники/слои (если их снёс дифф стиля) и перерисовывает
+     * текущее состояние. Инструмент вызывает это сам по styledata; метод публичен
+     * как страховка для хоста после setStyle()/setLanguage().
+     */
+    refresh(): void;
+    /**
+     * Обновляет палитру инструмента без пересоздания: применяет paint-свойства к
+     * уже существующим слоям и перекрашивает бейджи. Нужен при смене темы карты.
+     */
+    setStyleOptions(style: MeasureStyleOptions): void;
     getState(): MeasureState;
     destroy(): void;
     private cloneShape;
@@ -472,8 +486,11 @@ declare class MeasureTool {
     private onPointContextMenu;
     private setCursor;
     private onStyleLoad;
+    private isMapUsable;
     private emitChange;
     private ensureLayers;
+    private createMissingLayers;
+    private applyPaintStyle;
     private removeLayers;
     private setSourceData;
     private buildLineFeature;

package/dist/index.d.ts

@@ -403,6 +403,8 @@ declare class MeasureTool {
     private labels;
     private originalCursor;
     private layerHandlersBound;
+    private destroyed;
+    private ensuringLayers;
     private pointsSourceId;
     private linesSourceId;
     private fillsSourceId;
@@ -435,6 +437,7 @@ declare class MeasureTool {
     private handleLineMouseLeave;
     private handleLineMouseDown;
     private handleStyleLoad;
+    private handleStyleData;
     private handleViewportChange;
     constructor(map: Map, options?: MeasureToolOptions);
     private bindLayerHandlers;
@@ -446,6 +449,17 @@ declare class MeasureTool {
     removeShape(shapeId: string): void;
     removePoint(shapeId: string, pointId: string): void;
     clearAll(): void;
+    /**
+     * Пересоздаёт источники/слои (если их снёс дифф стиля) и перерисовывает
+     * текущее состояние. Инструмент вызывает это сам по styledata; метод публичен
+     * как страховка для хоста после setStyle()/setLanguage().
+     */
+    refresh(): void;
+    /**
+     * Обновляет палитру инструмента без пересоздания: применяет paint-свойства к
+     * уже существующим слоям и перекрашивает бейджи. Нужен при смене темы карты.
+     */
+    setStyleOptions(style: MeasureStyleOptions): void;
     getState(): MeasureState;
     destroy(): void;
     private cloneShape;
@@ -472,8 +486,11 @@ declare class MeasureTool {
     private onPointContextMenu;
     private setCursor;
     private onStyleLoad;
+    private isMapUsable;
     private emitChange;
     private ensureLayers;
+    private createMissingLayers;
+    private applyPaintStyle;
     private removeLayers;
     private setSourceData;
     private buildLineFeature;