bbl-mapbox-react 0.0.16 → 0.0.18

package/dist/types.d.ts

@@ -478,6 +478,13 @@ export interface MapboxProps {
     onRasterPaintChange?: (config: RasterPaintConfig) => void;
     /** 栅格渲染调节控件配置 */
     showRasterPaint?: boolean | RasterPaintControlConfig;
+    /**
+     * 路径规划控件配置
+     * - true: 不可用（需要提供 onSelectFinished）
+     * - false 或 undefined: 禁用（默认）
+     * - 对象: 自定义配置
+     */
+    showRoutePlanning?: RoutePlanningControlConfig;
     entities?: MapEntity[];
     selectedIds?: EntityId[];
     /** 实体全局开关配置（showArea / showLength / showRadius），entity 级配置优先 */
@@ -620,6 +627,21 @@ export interface MapboxRef {
      * @returns 渲染器实例，不存在则返回 undefined
      */
     getRenderer: (id: EntityId) => BaseRenderer<MapEntity> | undefined;
+    /**
+     * 设置哪些实体开启编辑模式（显示编辑手柄，可交互修改几何形状）
+     * @param ids 需要开启编辑的实体 ID 数组，传空数组关闭所有编辑
+     */
+    setEditingEntities: (ids: EntityId[]) => void;
+    /**
+     * 获取当前正在编辑的实体 ID 列表
+     */
+    getEditingEntities: () => EntityId[];
+    /**
+     * 程序化启动路径规划
+     * 即使没有显示路径规划控件也可以调用
+     * @param options 路径规划选项
+     */
+    startRoutePlanning: (options: RoutePlanningOptions) => void;
 }
 export interface RenderContext {
     map: MapboxMap;
@@ -798,6 +820,10 @@ export interface PickerModeConfig {
      * 不传则保持原有的点击选址行为
      */
     value?: PickerResult;
+    /** 标记点显示的文本名称 */
+    name?: string;
+    /** 文本样式配置 */
+    nameConfig?: NameConfig;
 }
 /**
  * Marker 模板定义
@@ -922,6 +948,19 @@ export interface EditModeConfig {
     onPolylineAdd?: (polyline: PolylineEntity) => void;
     /** 删除实体回调 */
     onEntityDelete?: (entity: MapEntity) => void;
+    /** 实体几何编辑完成回调（顶点移动、增删等） */
+    onEntityEdit?: (entity: MapEntity) => void;
+}
+/** 编辑手柄类型 */
+export type EditHandleType = 'vertex' | 'midpoint' | 'edge' | 'center' | 'move';
+/** 编辑手柄标识 */
+export interface EditHandle {
+    /** 手柄类型 */
+    type: EditHandleType;
+    /** 索引（vertex/midpoint: 坐标索引, edge: 方位索引 0=N 1=E 2=S 3=W, center: 0） */
+    index: number;
+    /** 当前位置 [经度, 纬度] */
+    position: [number, number];
 }
 /**
  * 道路类型
@@ -978,6 +1017,34 @@ export interface RasterPaintControlConfig {
     /** 自定义样式 */
     style?: CSSProperties;
 }
+/** 选点过程中的可视化类型 */
+export type RoutePlanningVisualType = 'marker' | 'polyline';
+/**
+ * 路径规划控件配置
+ */
+export interface RoutePlanningControlConfig {
+    /** 是否启用，默认 true */
+    enabled?: boolean;
+    /** 选点数量，最低2，默认2 */
+    pointCount?: number;
+    /** 是否显示输入框让用户自定义点数 */
+    showPointCountInput?: boolean;
+    /** 选点过程中的可视化类型，marker=每个点显示标记，polyline=用折线连接所有点，默认 'marker' */
+    visualType?: RoutePlanningVisualType;
+    /** 选点完成后的回调，接收选中的点坐标数组，返回 entity */
+    onSelectFinished: (points: [number, number][]) => Promise<MapEntity | null>;
+}
+/**
+ * 路径规划选项（用于程序化调用）
+ */
+export interface RoutePlanningOptions {
+    /** 选点数量，最低2，默认2 */
+    pointCount?: number;
+    /** 选点过程中的可视化类型，默认 'marker' */
+    visualType?: RoutePlanningVisualType;
+    /** 选点完成后的回调，接收选中的点坐标数组，返回 entity */
+    onSelectFinished: (points: [number, number][]) => Promise<MapEntity>;
+}
 /**
  * 道路类型选项列表
  * 兼容 Mapbox 和 OpenMapTiles 的道路分类

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bbl-mapbox-react",
-	"version": "0.0.16",
+	"version": "0.0.18",
 	"description": "React Mapbox 地图组件库，支持雷达、图像、标记、轨迹等多种 GIS 实体渲染",
 	"type": "module",
 	"main": "./dist/index.cjs",