bbl-mapbox-react 0.0.17 → 0.0.18

package/dist/components/BaseRenderer.d.ts

@@ -1,9 +1,16 @@
-import { BaseEntity, EntityId } from '../types';
+import { Map as MapboxMap } from 'mapbox-gl';
+import { BaseEntity, EntityId, EditHandle } from '../types';
 /**
  * 实体边界框类型
  * [[西南角经度, 西南角纬度], [东北角经度, 东北角纬度]]
  */
 export type EntityBounds = [[number, number], [number, number]];
+/** Move 图标的 Mapbox image ID */
+export declare const MOVE_ICON_ID = "__edit-move-icon__";
+/**
+ * 确保 move 图标已注册到 map 实例中（幂等，可多次调用）
+ */
+export declare function ensureMoveIcon(map: MapboxMap): void;
 /**
  * 渲染器基础接口
  * 定义所有实体渲染器必须实现的公共方法
@@ -55,4 +62,36 @@ export interface BaseRenderer<T extends BaseEntity> {
      * 销毁渲染器
      */
     destroy(): void;
+    /**
+     * 开启/关闭编辑模式（显示/隐藏编辑手柄）
+     */
+    setEditing?(enabled: boolean): void;
+    /**
+     * 检测给定坐标是否命中编辑手柄
+     * @param lngLat 点击的经纬度
+     * @param zoom 当前缩放级别（用于计算像素距离阈值）
+     * @returns 命中的手柄，或 null
+     */
+    getEditHandleAt?(lngLat: [number, number], zoom: number): EditHandle | null;
+    /**
+     * 确认手柄移动，返回更新后的实体数据
+     */
+    applyHandleMove?(handle: EditHandle, newPosition: [number, number]): T;
+    /**
+     * 实时预览手柄拖动效果（鼠标跟随时调用）
+     */
+    updateEditPreview?(handle: EditHandle, previewPosition: [number, number]): void;
+    /**
+     * 取消手柄移动预览，恢复原始几何
+     */
+    cancelEditPreview?(): void;
+    /**
+     * 删除指定索引的顶点（仅 polygon/polyline）
+     * @returns 更新后的实体，若删除会导致无效则返回 null
+     */
+    deleteVertex?(index: number): T | null;
+    /**
+     * 在指定索引后插入新顶点（仅 polygon/polyline）
+     */
+    addVertex?(index: number, position: [number, number]): T;
 }

package/dist/components/CanvasCircleRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { CircleEntity, CircleGradientAnimation, NameConfig, CircleMeasureConfig } from '../types';
+import { CircleEntity, CircleGradientAnimation, NameConfig, CircleMeasureConfig, EditHandle } from '../types';
 import { BaseCanvasRenderer } from './BaseCanvasRenderer';
 import { EntityBounds } from './BaseRenderer';
 /**
@@ -28,6 +28,11 @@ export declare class CanvasCircleRenderer extends BaseCanvasRenderer<CircleEntit
     private radiusLineLayerId;
     private radiusLabelLayerId;
     private globalCircleConfig?;
+    private isEditing;
+    private editSourceId;
+    private editHandleLayerId;
+    private editMoveLayerId;
+    private static readonly EDGE_BEARINGS;
     constructor(map: MapboxMap, entity: CircleEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig, globalAreaConfig?: NameConfig, globalCircleConfig?: CircleMeasureConfig);
     /**
      * 获取实体面积（平方米）
@@ -110,4 +115,14 @@ export declare class CanvasCircleRenderer extends BaseCanvasRenderer<CircleEntit
      * 销毁渲染器
      */
     destroy(): void;
+    private getEditHandlePositions;
+    private getEditHandleGeoJSON;
+    private createEditLayers;
+    private removeEditLayers;
+    private refreshEditHandles;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], _zoom: number): EditHandle | null;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): CircleEntity;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
 }

package/dist/components/CanvasImageRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { ImageEntity, NameConfig } from '../types';
+import { ImageEntity, NameConfig, EditHandle } from '../types';
 import { BaseCanvasRenderer } from './BaseCanvasRenderer';
 import { EntityBounds } from './BaseRenderer';
 /**
@@ -11,6 +11,9 @@ export declare class CanvasImageRenderer extends BaseCanvasRenderer<ImageEntity>
     private imageLoaded;
     private currentSrc;
     private imageAspectRatio;
+    private isEditing;
+    private editSourceId;
+    private editMoveLayerId;
     constructor(map: MapboxMap, entity: ImageEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig);
     /**
      * 获取实体尺寸 [宽, 高]，高度根据图片原始宽高比计算
@@ -48,4 +51,17 @@ export declare class CanvasImageRenderer extends BaseCanvasRenderer<ImageEntity>
      * @returns 是否在范围内
      */
     isPointInEntity(lngLat: [number, number]): boolean;
+    private getEditHandleGeoJSON;
+    private createEditLayers;
+    private removeEditLayers;
+    private refreshEditHandles;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], zoom: number): EditHandle | null;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): ImageEntity;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
+    /**
+     * 销毁渲染器
+     */
+    destroy(): void;
 }

package/dist/components/CanvasRadarRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { RadarEntity, NameConfig } from '../types';
+import { RadarEntity, NameConfig, EditHandle } from '../types';
 import { BaseCanvasRenderer } from './BaseCanvasRenderer';
 import { EntityBounds } from './BaseRenderer';
 /**
@@ -9,6 +9,9 @@ import { EntityBounds } from './BaseRenderer';
 export declare class CanvasRadarRenderer extends BaseCanvasRenderer<RadarEntity> {
     private currentRotation;
     private animationFrameId;
+    private isEditing;
+    private editSourceId;
+    private editMoveLayerId;
     constructor(map: MapboxMap, entity: RadarEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig);
     /**
      * 获取实体中心点坐标
@@ -60,4 +63,13 @@ export declare class CanvasRadarRenderer extends BaseCanvasRenderer<RadarEntity>
      * 销毁渲染器
      */
     destroy(): void;
+    private getEditHandleGeoJSON;
+    private createEditLayers;
+    private removeEditLayers;
+    private refreshEditHandles;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], _zoom: number): EditHandle | null;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): RadarEntity;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
 }

package/dist/components/CircleRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { CircleEntity, EntityId, NameConfig, CircleMeasureConfig } from '../types';
+import { CircleEntity, EntityId, NameConfig, CircleMeasureConfig, EditHandle } from '../types';
 import { BaseRenderer, EntityBounds } from './BaseRenderer';
 /**
  * Circle 渲染器
@@ -27,6 +27,10 @@ export declare class CircleRenderer implements BaseRenderer<CircleEntity> {
     private globalSelectNameConfig?;
     private globalAreaConfig?;
     private globalCircleConfig?;
+    private isEditing;
+    private editSourceId;
+    private editHandleLayerId;
+    private editMoveLayerId;
     private static readonly DEFAULTS;
     constructor(map: MapboxMap, entity: CircleEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig, globalAreaConfig?: NameConfig, globalCircleConfig?: CircleMeasureConfig);
     private get nameStyle();
@@ -103,5 +107,21 @@ export declare class CircleRenderer implements BaseRenderer<CircleEntity> {
     /**
      * 销毁渲染器
      */
+    /** 边上4个方位点的方位角 N=0, E=90, S=180, W=270 */
+    private static readonly EDGE_BEARINGS;
+    /**
+     * 获取编辑手柄位置列表
+     * @returns 4个边上点 + 1个中心点
+     */
+    private getEditHandlePositions;
+    private getEditHandleGeoJSON;
+    private createEditLayers;
+    private removeEditLayers;
+    private refreshEditHandles;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], zoom: number): EditHandle | null;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): CircleEntity;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
     destroy(): void;
 }

package/dist/components/MarkerRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { MarkerEntity, BaseMarkerEntity, EntityId, NameConfig } from '../types';
+import { MarkerEntity, BaseMarkerEntity, EntityId, NameConfig, EditHandle } from '../types';
 import { BaseRenderer, EntityBounds } from './BaseRenderer';
 /**
  * Marker 渲染器
@@ -19,6 +19,8 @@ export declare class MarkerRenderer<T extends BaseMarkerEntity = MarkerEntity> i
     private destroyed;
     private globalNameConfig?;
     private globalSelectNameConfig?;
+    private isEditing;
+    private moveIconElement;
     constructor(map: MapboxMap, entity: T, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig);
     /**
      * 加载图片并创建 marker
@@ -83,4 +85,11 @@ export declare class MarkerRenderer<T extends BaseMarkerEntity = MarkerEntity> i
      * 销毁渲染器
      */
     destroy(): void;
+    private createMoveIcon;
+    private removeMoveIcon;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], _zoom: number): EditHandle | null;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): T;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
 }

package/dist/components/MeasureControl.d.ts

@@ -6,7 +6,9 @@ export interface MeasureControlProps {
     entityConfig?: EntityConfig;
     /** 受控模式：entityConfig 变更回调 */
     onEntityConfigChange?: (config: EntityConfig) => void;
+    /** 绘制模式变更回调，通知外部当前是否在绘制测量图形 */
+    onDrawModeChange?: (isDrawing: boolean) => void;
     className?: string;
     style?: React.CSSProperties;
 }
-export declare function MeasureControl({ map, entityConfig: controlledEntityConfig, onEntityConfigChange, className, style, }: MeasureControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function MeasureControl({ map, entityConfig: controlledEntityConfig, onEntityConfigChange, onDrawModeChange, className, style, }: MeasureControlProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/PolygonRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { PolygonEntity, EntityId, NameConfig } from '../types';
+import { PolygonEntity, EntityId, NameConfig, EditHandle } from '../types';
 import { BaseRenderer, EntityBounds } from './BaseRenderer';
 /**
  * Polygon 渲染器
@@ -21,6 +21,11 @@ export declare class PolygonRenderer implements BaseRenderer<PolygonEntity> {
     private globalSelectNameConfig?;
     private globalAreaConfig?;
     private globalLengthConfig?;
+    private isEditing;
+    private editSourceId;
+    private editHandleLayerId;
+    private editMidpointLayerId;
+    private editMoveLayerId;
     private static readonly DEFAULTS;
     constructor(map: MapboxMap, entity: PolygonEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig, globalAreaConfig?: NameConfig, globalLengthConfig?: NameConfig);
     private get nameStyle();
@@ -86,6 +91,54 @@ export declare class PolygonRenderer implements BaseRenderer<PolygonEntity> {
      * 更新实体数据
      */
     update(entity: PolygonEntity): void;
+    /**
+     * 生成编辑手柄的 GeoJSON 数据
+     */
+    private getEditHandleGeoJSON;
+    /**
+     * 创建编辑手柄图层
+     */
+    private createEditLayers;
+    /**
+     * 移除编辑手柄图层
+     */
+    private removeEditLayers;
+    /**
+     * 刷新编辑手柄数据
+     */
+    private refreshEditHandles;
+    /**
+     * 开启/关闭编辑模式
+     */
+    setEditing(enabled: boolean): void;
+    /**
+     * 检测给定坐标是否命中编辑手柄
+     */
+    getEditHandleAt(lngLat: [number, number], zoom: number): EditHandle | null;
+    /**
+     * 将所有坐标按偏移量平移
+     */
+    private offsetCoordinates;
+    /**
+     * 确认手柄移动，返回更新后的实体
+     */
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): PolygonEntity;
+    /**
+     * 实时预览手柄拖动效果
+     */
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    /**
+     * 取消预览，恢复原始几何
+     */
+    cancelEditPreview(): void;
+    /**
+     * 删除指定索引的顶点
+     */
+    deleteVertex(index: number): PolygonEntity | null;
+    /**
+     * 在指定索引后插入新顶点
+     */
+    addVertex(index: number, position: [number, number]): PolygonEntity;
     /**
      * 销毁渲染器
      */

package/dist/components/PolylineRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { PolylineEntity, EntityId, NameConfig } from '../types';
+import { PolylineEntity, EntityId, NameConfig, EditHandle } from '../types';
 import { BaseRenderer, EntityBounds } from './BaseRenderer';
 /**
  * Polyline 渲染器
@@ -18,6 +18,11 @@ export declare class PolylineRenderer implements BaseRenderer<PolylineEntity> {
     private globalNameConfig?;
     private globalSelectNameConfig?;
     private globalLengthConfig?;
+    private isEditing;
+    private editSourceId;
+    private editHandleLayerId;
+    private editMidpointLayerId;
+    private editMoveLayerId;
     private static readonly DEFAULTS;
     constructor(map: MapboxMap, entity: PolylineEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig, globalLengthConfig?: NameConfig);
     private get nameStyle();
@@ -82,6 +87,18 @@ export declare class PolylineRenderer implements BaseRenderer<PolylineEntity> {
      * 更新实体数据
      */
     update(entity: PolylineEntity): void;
+    private getEditHandleGeoJSON;
+    private createEditLayers;
+    private removeEditLayers;
+    private refreshEditHandles;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], zoom: number): EditHandle | null;
+    private offsetCoordinates;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): PolylineEntity;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
+    deleteVertex(index: number): PolylineEntity | null;
+    addVertex(index: number, position: [number, number]): PolylineEntity;
     /**
      * 销毁渲染器
      */

package/dist/components/RectangleRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { RectangleEntity, EntityId, NameConfig } from '../types';
+import { RectangleEntity, EntityId, NameConfig, EditHandle } from '../types';
 import { BaseRenderer, EntityBounds } from './BaseRenderer';
 /**
  * Rectangle 渲染器
@@ -21,6 +21,10 @@ export declare class RectangleRenderer implements BaseRenderer<RectangleEntity>
     private globalSelectNameConfig?;
     private globalAreaConfig?;
     private globalLengthConfig?;
+    private isEditing;
+    private editSourceId;
+    private editHandleLayerId;
+    private editMoveLayerId;
     private static readonly DEFAULTS;
     constructor(map: MapboxMap, entity: RectangleEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig, globalAreaConfig?: NameConfig, globalLengthConfig?: NameConfig);
     private get nameStyle();
@@ -86,6 +90,27 @@ export declare class RectangleRenderer implements BaseRenderer<RectangleEntity>
      * 更新实体数据
      */
     update(entity: RectangleEntity): void;
+    /**
+     * 获取矩形4个角的坐标（不含闭合点）
+     * 顺序: 0=左上, 1=右上, 2=右下, 3=左下
+     */
+    private getCorners;
+    private getEditHandleGeoJSON;
+    private createEditLayers;
+    private removeEditLayers;
+    private refreshEditHandles;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], zoom: number): EditHandle | null;
+    /**
+     * 根据被移动的角的新位置，计算新的 bounds
+     * 对角保持不变，移动的角决定新的 bounds
+     * 角序: 0=左上, 1=右上, 2=右下, 3=左下
+     */
+    private computeNewBounds;
+    private offsetBounds;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): RectangleEntity;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
     /**
      * 销毁渲染器
      */

package/dist/components/RoutePlanningControl.d.ts

@@ -0,0 +1,19 @@
+import { Map as MapboxMap } from 'mapbox-gl';
+import { MapEntity, RoutePlanningVisualType, RoutePlanningOptions } from '../types';
+export interface RoutePlanningControlProps {
+    map: MapboxMap | null;
+    /** 选点数量，最低2，默认2 */
+    pointCount?: number;
+    /** 是否显示输入框让用户自定义点数 */
+    showPointCountInput?: boolean;
+    /** 选点过程中的可视化类型，默认 'marker' */
+    visualType?: RoutePlanningVisualType;
+    /** 选点完成后的回调 */
+    onSelectFinished?: (points: [number, number][]) => Promise<MapEntity>;
+    /** 是否显示按钮UI，false时仅用于程序化调用 */
+    showButton?: boolean;
+}
+export interface RoutePlanningControlRef {
+    startPlanning: (options: RoutePlanningOptions) => void;
+}
+export declare const RoutePlanningControl: import('react').ForwardRefExoticComponent<RoutePlanningControlProps & import('react').RefAttributes<RoutePlanningControlRef>>;

package/dist/components/SquareRenderer.d.ts

@@ -1,5 +1,5 @@
 import { Map as MapboxMap } from 'mapbox-gl';
-import { SquareEntity, EntityId, NameConfig } from '../types';
+import { SquareEntity, EntityId, NameConfig, EditHandle } from '../types';
 import { BaseRenderer, EntityBounds } from './BaseRenderer';
 /**
  * Square 渲染器
@@ -21,6 +21,10 @@ export declare class SquareRenderer implements BaseRenderer<SquareEntity> {
     private globalSelectNameConfig?;
     private globalAreaConfig?;
     private globalLengthConfig?;
+    private isEditing;
+    private editSourceId;
+    private editHandleLayerId;
+    private editMoveLayerId;
     private static readonly DEFAULTS;
     constructor(map: MapboxMap, entity: SquareEntity, globalNameConfig?: NameConfig, globalSelectNameConfig?: NameConfig, globalAreaConfig?: NameConfig, globalLengthConfig?: NameConfig);
     private get nameStyle();
@@ -81,6 +85,21 @@ export declare class SquareRenderer implements BaseRenderer<SquareEntity> {
      * 更新实体数据
      */
     update(entity: SquareEntity): void;
+    private getCorners;
+    private getEditHandleGeoJSON;
+    private createEditLayers;
+    private removeEditLayers;
+    private refreshEditHandles;
+    setEditing(enabled: boolean): void;
+    getEditHandleAt(lngLat: [number, number], zoom: number): EditHandle | null;
+    /**
+     * 根据移动的角位置计算新的边长
+     * 中心点不变，新边长 = 从中心到新角位置的距离 * sqrt(2)
+     */
+    private computeNewLength;
+    applyHandleMove(handle: EditHandle, newPosition: [number, number]): SquareEntity;
+    updateEditPreview(handle: EditHandle, previewPosition: [number, number]): void;
+    cancelEditPreview(): void;
     /**
      * 销毁渲染器
      */