mahal_map 1.5.9 → 1.6.2

package/README.md

@@ -519,37 +519,6 @@ MahalMap.onReady("map", () => {
 map.destroy();
 ```
 
-## Разработка
-
-```sh
-npm run build
-npm run build:sdk
-npm run build:all
-npm test
-```
-
-`npm run build` собирает npm entrypoint. `npm run build:sdk` собирает browser IIFE SDK bundle. `npm run build:all` запускает обе сборки.
-
-## Структура проекта
-
-```text
-src/
-  index.ts
-  sdk.ts
-  config/
-  core/
-  markers/
-  services/
-  types/
-  utils/
-```
-
-- `index.ts` - npm entrypoint.
-- `sdk.ts` - browser SDK entrypoint.
-- `core/` - карта и управление камерой.
-- `markers/` - маркеры и адаптеры.
-- `types/` - публичные TypeScript типы.
-
 ## License
 
 ISC

package/dist/index.d.mts

@@ -190,14 +190,14 @@ declare function Router(param: number[][], typeData: string, token: string): Pro
 declare function Search(param: string, token: string, additionalParam?: IAdditionalParamType): Promise<ISearchResponse[]>;
 declare function SearchByLocation(params: ISearchByLocationParam): Promise<ISearchResponse>;
 
-declare const index$1_Router: typeof Router;
-declare const index$1_Search: typeof Search;
-declare const index$1_SearchByLocation: typeof SearchByLocation;
-declare const index$1_clearKey: typeof clearKey;
-declare const index$1_getApiKey: typeof getApiKey;
-declare const index$1_saveKey: typeof saveKey;
-declare namespace index$1 {
-  export { index$1_Router as Router, index$1_Search as Search, index$1_SearchByLocation as SearchByLocation, index$1_clearKey as clearKey, index$1_getApiKey as getApiKey, index$1_saveKey as saveKey };
+declare const index$2_Router: typeof Router;
+declare const index$2_Search: typeof Search;
+declare const index$2_SearchByLocation: typeof SearchByLocation;
+declare const index$2_clearKey: typeof clearKey;
+declare const index$2_getApiKey: typeof getApiKey;
+declare const index$2_saveKey: typeof saveKey;
+declare namespace index$2 {
+  export { index$2_Router as Router, index$2_Search as Search, index$2_SearchByLocation as SearchByLocation, index$2_clearKey as clearKey, index$2_getApiKey as getApiKey, index$2_saveKey as saveKey };
 }
 
 declare class MahalMapDefaultMarker {
@@ -212,6 +212,164 @@ declare class MahalMapDefaultMarker {
     getAnchor(): "center" | "top" | "bottom" | "left" | "right" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
 }
 
+type MeasureMode = "distance" | "area";
+interface MeasurePoint {
+    id: string;
+    lngLat: [number, number];
+}
+interface MeasureShape {
+    id: string;
+    mode: MeasureMode;
+    points: MeasurePoint[];
+    closed: boolean;
+    distance: number;
+    area: number;
+}
+interface MeasureStyleOptions {
+    pointColor?: string;
+    pointStrokeColor?: string;
+    pointStrokeWidth?: number;
+    pointRadius?: number;
+    activePointColor?: string;
+    lineColor?: string;
+    lineWidth?: number;
+    lineDasharray?: number[];
+    fillColor?: string;
+    fillOpacity?: number;
+    labelColor?: string;
+    labelHaloColor?: string;
+    badgeBackground?: string;
+    badgeTextColor?: string;
+    badgeBorderRadius?: string;
+    badgeBoxShadow?: string;
+    badgeBorder?: string;
+    badgeFontSize?: string;
+    badgeFontWeight?: string;
+    badgeGap?: string;
+    iconButtonSize?: string;
+}
+interface MeasureIcons {
+    trash?: string;
+    close?: string;
+    check?: string;
+}
+interface MeasureLabels {
+    meters?: string;
+    kilometers?: string;
+    squareMeters?: string;
+    squareKilometers?: string;
+}
+interface MeasureToolOptions {
+    mode?: MeasureMode;
+    sourceIdPrefix?: string;
+    style?: MeasureStyleOptions;
+    icons?: MeasureIcons;
+    labels?: MeasureLabels;
+    onChange?: (state: MeasureState) => void;
+}
+interface MeasureState {
+    active: boolean;
+    mode: MeasureMode;
+    draft: MeasureShape | null;
+    shapes: MeasureShape[];
+}
+
+declare class MeasureTool {
+    private map;
+    private prefix;
+    private style;
+    private labels;
+    private pointsSourceId;
+    private linesSourceId;
+    private fillsSourceId;
+    private labelsSourceId;
+    private pointsLayerId;
+    private linesCasingLayerId;
+    private linesLayerId;
+    private fillsLayerId;
+    private labelsLayerId;
+    private mode;
+    private isActive;
+    private draft;
+    private shapes;
+    private badge;
+    private draggingPointId;
+    private draggingShapeId;
+    private suppressNextClick;
+    private onChange?;
+    private handleClick;
+    private handlePointMouseDown;
+    private handlePointMouseEnter;
+    private handlePointMouseLeave;
+    private handlePointContextMenu;
+    private handleStyleLoad;
+    private handleViewportChange;
+    constructor(map: Map, options?: MeasureToolOptions);
+    start(mode?: MeasureMode): void;
+    stop(): void;
+    setMode(mode: MeasureMode): void;
+    finishDraft(): void;
+    removeShape(shapeId: string): void;
+    removePoint(shapeId: string, pointId: string): void;
+    clearAll(): void;
+    getState(): MeasureState;
+    destroy(): void;
+    private cloneShape;
+    private findShape;
+    private getLastShape;
+    private commitOrDiscardDraft;
+    private ensureDraft;
+    private recomputeShape;
+    private onMapClick;
+    private onPointMouseDown;
+    private onPointDragMove;
+    private onPointDragUp;
+    private stopDragListeners;
+    private onPointContextMenu;
+    private setCursor;
+    private onStyleLoad;
+    private emitChange;
+    private ensureLayers;
+    private removeLayers;
+    private setSourceData;
+    private buildLineFeature;
+    private buildFillFeature;
+    private buildPointFeatures;
+    private buildLabelFeature;
+    private render;
+    private updateBadge;
+    private updateBadgePosition;
+}
+
+declare function haversineDistance(a: [number, number], b: [number, number]): number;
+declare function lineLength(points: [number, number][]): number;
+/**
+ * Spherical excess polygon area (same approach as Leaflet.GeometryUtil / turf's
+ * geodesic area) — accurate enough for on-map measurement at city scale.
+ */
+declare function polygonArea(points: [number, number][]): number;
+declare function polygonCentroid(points: [number, number][]): [number, number];
+declare function midpoint(points: [number, number][]): [number, number];
+
+type index$1_MeasureIcons = MeasureIcons;
+type index$1_MeasureLabels = MeasureLabels;
+type index$1_MeasureMode = MeasureMode;
+type index$1_MeasurePoint = MeasurePoint;
+type index$1_MeasureShape = MeasureShape;
+type index$1_MeasureState = MeasureState;
+type index$1_MeasureStyleOptions = MeasureStyleOptions;
+type index$1_MeasureTool = MeasureTool;
+declare const index$1_MeasureTool: typeof MeasureTool;
+type index$1_MeasureToolOptions = MeasureToolOptions;
+declare const index$1_haversineDistance: typeof haversineDistance;
+declare const index$1_lineLength: typeof lineLength;
+declare const index$1_midpoint: typeof midpoint;
+declare const index$1_polygonArea: typeof polygonArea;
+declare const index$1_polygonCentroid: typeof polygonCentroid;
+declare namespace index$1 {
+  export { type index$1_MeasureIcons as MeasureIcons, type index$1_MeasureLabels as MeasureLabels, type index$1_MeasureMode as MeasureMode, type index$1_MeasurePoint as MeasurePoint, type index$1_MeasureShape as MeasureShape, type index$1_MeasureState as MeasureState, type index$1_MeasureStyleOptions as MeasureStyleOptions, index$1_MeasureTool as MeasureTool, type index$1_MeasureToolOptions as MeasureToolOptions, index$1_haversineDistance as haversineDistance, index$1_lineLength as lineLength, index$1_midpoint as midpoint, index$1_polygonArea as polygonArea, index$1_polygonCentroid as polygonCentroid };
+}
+
 declare function checkCoordinates(coordinates: string): {
     lat: string | undefined;
     lng: string | undefined;
@@ -234,4 +392,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 { type IAdditionalParamType, type IMahalMapOptions, type IMapMarker, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapLanguage, Router, Search, SearchByLocation, type Theme, index$1 as keyUtils, index as utils };
+export { type IAdditionalParamType, type IMahalMapOptions, type IMapMarker, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapLanguage, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };

package/dist/index.d.ts

@@ -190,14 +190,14 @@ declare function Router(param: number[][], typeData: string, token: string): Pro
 declare function Search(param: string, token: string, additionalParam?: IAdditionalParamType): Promise<ISearchResponse[]>;
 declare function SearchByLocation(params: ISearchByLocationParam): Promise<ISearchResponse>;
 
-declare const index$1_Router: typeof Router;
-declare const index$1_Search: typeof Search;
-declare const index$1_SearchByLocation: typeof SearchByLocation;
-declare const index$1_clearKey: typeof clearKey;
-declare const index$1_getApiKey: typeof getApiKey;
-declare const index$1_saveKey: typeof saveKey;
-declare namespace index$1 {
-  export { index$1_Router as Router, index$1_Search as Search, index$1_SearchByLocation as SearchByLocation, index$1_clearKey as clearKey, index$1_getApiKey as getApiKey, index$1_saveKey as saveKey };
+declare const index$2_Router: typeof Router;
+declare const index$2_Search: typeof Search;
+declare const index$2_SearchByLocation: typeof SearchByLocation;
+declare const index$2_clearKey: typeof clearKey;
+declare const index$2_getApiKey: typeof getApiKey;
+declare const index$2_saveKey: typeof saveKey;
+declare namespace index$2 {
+  export { index$2_Router as Router, index$2_Search as Search, index$2_SearchByLocation as SearchByLocation, index$2_clearKey as clearKey, index$2_getApiKey as getApiKey, index$2_saveKey as saveKey };
 }
 
 declare class MahalMapDefaultMarker {
@@ -212,6 +212,164 @@ declare class MahalMapDefaultMarker {
     getAnchor(): "center" | "top" | "bottom" | "left" | "right" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
 }
 
+type MeasureMode = "distance" | "area";
+interface MeasurePoint {
+    id: string;
+    lngLat: [number, number];
+}
+interface MeasureShape {
+    id: string;
+    mode: MeasureMode;
+    points: MeasurePoint[];
+    closed: boolean;
+    distance: number;
+    area: number;
+}
+interface MeasureStyleOptions {
+    pointColor?: string;
+    pointStrokeColor?: string;
+    pointStrokeWidth?: number;
+    pointRadius?: number;
+    activePointColor?: string;
+    lineColor?: string;
+    lineWidth?: number;
+    lineDasharray?: number[];
+    fillColor?: string;
+    fillOpacity?: number;
+    labelColor?: string;
+    labelHaloColor?: string;
+    badgeBackground?: string;
+    badgeTextColor?: string;
+    badgeBorderRadius?: string;
+    badgeBoxShadow?: string;
+    badgeBorder?: string;
+    badgeFontSize?: string;
+    badgeFontWeight?: string;
+    badgeGap?: string;
+    iconButtonSize?: string;
+}
+interface MeasureIcons {
+    trash?: string;
+    close?: string;
+    check?: string;
+}
+interface MeasureLabels {
+    meters?: string;
+    kilometers?: string;
+    squareMeters?: string;
+    squareKilometers?: string;
+}
+interface MeasureToolOptions {
+    mode?: MeasureMode;
+    sourceIdPrefix?: string;
+    style?: MeasureStyleOptions;
+    icons?: MeasureIcons;
+    labels?: MeasureLabels;
+    onChange?: (state: MeasureState) => void;
+}
+interface MeasureState {
+    active: boolean;
+    mode: MeasureMode;
+    draft: MeasureShape | null;
+    shapes: MeasureShape[];
+}
+
+declare class MeasureTool {
+    private map;
+    private prefix;
+    private style;
+    private labels;
+    private pointsSourceId;
+    private linesSourceId;
+    private fillsSourceId;
+    private labelsSourceId;
+    private pointsLayerId;
+    private linesCasingLayerId;
+    private linesLayerId;
+    private fillsLayerId;
+    private labelsLayerId;
+    private mode;
+    private isActive;
+    private draft;
+    private shapes;
+    private badge;
+    private draggingPointId;
+    private draggingShapeId;
+    private suppressNextClick;
+    private onChange?;
+    private handleClick;
+    private handlePointMouseDown;
+    private handlePointMouseEnter;
+    private handlePointMouseLeave;
+    private handlePointContextMenu;
+    private handleStyleLoad;
+    private handleViewportChange;
+    constructor(map: Map, options?: MeasureToolOptions);
+    start(mode?: MeasureMode): void;
+    stop(): void;
+    setMode(mode: MeasureMode): void;
+    finishDraft(): void;
+    removeShape(shapeId: string): void;
+    removePoint(shapeId: string, pointId: string): void;
+    clearAll(): void;
+    getState(): MeasureState;
+    destroy(): void;
+    private cloneShape;
+    private findShape;
+    private getLastShape;
+    private commitOrDiscardDraft;
+    private ensureDraft;
+    private recomputeShape;
+    private onMapClick;
+    private onPointMouseDown;
+    private onPointDragMove;
+    private onPointDragUp;
+    private stopDragListeners;
+    private onPointContextMenu;
+    private setCursor;
+    private onStyleLoad;
+    private emitChange;
+    private ensureLayers;
+    private removeLayers;
+    private setSourceData;
+    private buildLineFeature;
+    private buildFillFeature;
+    private buildPointFeatures;
+    private buildLabelFeature;
+    private render;
+    private updateBadge;
+    private updateBadgePosition;
+}
+
+declare function haversineDistance(a: [number, number], b: [number, number]): number;
+declare function lineLength(points: [number, number][]): number;
+/**
+ * Spherical excess polygon area (same approach as Leaflet.GeometryUtil / turf's
+ * geodesic area) — accurate enough for on-map measurement at city scale.
+ */
+declare function polygonArea(points: [number, number][]): number;
+declare function polygonCentroid(points: [number, number][]): [number, number];
+declare function midpoint(points: [number, number][]): [number, number];
+
+type index$1_MeasureIcons = MeasureIcons;
+type index$1_MeasureLabels = MeasureLabels;
+type index$1_MeasureMode = MeasureMode;
+type index$1_MeasurePoint = MeasurePoint;
+type index$1_MeasureShape = MeasureShape;
+type index$1_MeasureState = MeasureState;
+type index$1_MeasureStyleOptions = MeasureStyleOptions;
+type index$1_MeasureTool = MeasureTool;
+declare const index$1_MeasureTool: typeof MeasureTool;
+type index$1_MeasureToolOptions = MeasureToolOptions;
+declare const index$1_haversineDistance: typeof haversineDistance;
+declare const index$1_lineLength: typeof lineLength;
+declare const index$1_midpoint: typeof midpoint;
+declare const index$1_polygonArea: typeof polygonArea;
+declare const index$1_polygonCentroid: typeof polygonCentroid;
+declare namespace index$1 {
+  export { type index$1_MeasureIcons as MeasureIcons, type index$1_MeasureLabels as MeasureLabels, type index$1_MeasureMode as MeasureMode, type index$1_MeasurePoint as MeasurePoint, type index$1_MeasureShape as MeasureShape, type index$1_MeasureState as MeasureState, type index$1_MeasureStyleOptions as MeasureStyleOptions, index$1_MeasureTool as MeasureTool, type index$1_MeasureToolOptions as MeasureToolOptions, index$1_haversineDistance as haversineDistance, index$1_lineLength as lineLength, index$1_midpoint as midpoint, index$1_polygonArea as polygonArea, index$1_polygonCentroid as polygonCentroid };
+}
+
 declare function checkCoordinates(coordinates: string): {
     lat: string | undefined;
     lng: string | undefined;
@@ -234,4 +392,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 { type IAdditionalParamType, type IMahalMapOptions, type IMapMarker, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapLanguage, Router, Search, SearchByLocation, type Theme, index$1 as keyUtils, index as utils };
+export { type IAdditionalParamType, type IMahalMapOptions, type IMapMarker, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapLanguage, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };