@baidumap/vue-bmap 1.0.0

package/dist/components/Overlay/types.d.ts

@@ -0,0 +1,799 @@
+import { Point, Size, Bounds, OverlayHandle } from '../../types';
+import { ControlAnchor } from '../../constants';
+
+/**
+ * 图标描述（plain object）— 等同于 IconOptions + constructor 的 url/size 参数。
+ * 框架内部通过 toRawIcon 自动转成 SDK 的 BMap.Icon 实例，用户无需手动 new BMap.Icon。
+ */
+export interface PlainIcon extends IconOptions {
+    /** 图片资源地址（URL / dataURL） */
+    url: string;
+    /** 图标可视区域大小 */
+    size?: Size;
+}
+/**
+ * 编辑态节点图标（enableEditing 时生效，4.0/GL，2.0.3 新增）。
+ * 所有可编辑覆盖物（Polyline/Polygon/Circle/Rectangle/BezierCurve）均支持，
+ * 传 { url, size } 图标配置，框架自动转成 SDK Icon 实例。
+ */
+export interface EditNodeStyleOptions {
+    /** 编辑态端点（顶点）图标 */
+    node?: PlainIcon | OverlayHandle;
+    /** 编辑态中间点（拖出可新增顶点）图标 */
+    nodeT?: PlainIcon | OverlayHandle;
+}
+/** 矢量图标（Symbol 变体）— 作为 Marker icon 使用，框架自动转 SDK Symbol 实例 */
+export interface SymbolIcon {
+    symbol: {
+        /** SVG path 字符串或 BMap_Symbol_SHAPE_* 常量（shapeType 为别名） */
+        path?: string | number;
+        shapeType?: string | number;
+        anchor?: Size;
+        fillColor?: string;
+        fillOpacity?: number;
+        scale?: number;
+        rotation?: number;
+        strokeColor?: string;
+        strokeOpacity?: number;
+        strokeWeight?: number;
+    };
+}
+export interface MarkerOptions {
+    offset?: Size;
+    /** 图标 — 传 plain object / Symbol 矢量图标 / useIcon/useSymbol 返回值，框架自动转 SDK 实例 */
+    icon?: PlainIcon | SymbolIcon | OverlayHandle | null;
+    anchor?: ControlAnchor;
+    enableMassClear?: boolean;
+    enableDragging?: boolean;
+    enableClicking?: boolean;
+    raiseOnDrag?: boolean;
+    draggingCursor?: string;
+    rotation?: number;
+    title?: string;
+    /** 阴影图标 @removed 4.0（仅 v3） */
+    shadow?: PlainIcon | OverlayHandle | null;
+    zIndex?: number;
+    /** 基础 zIndex（构造函数） */
+    baseZIndex?: number;
+    /** 限制拖拽区域（构造函数） */
+    restrictDraggingArea?: boolean;
+    /** 透明度 0-1 @since 4.0 */
+    opacity?: number;
+    /** 标注颜色 @since 4.0 */
+    color?: string;
+    /** 碰撞检测优先级 @since 4.0 */
+    rank?: number;
+    /** 旋转中心 @since 4.0 */
+    rotationOrigin?: number;
+    /** 碰撞检测 @since 4.0（构造函数） */
+    enableCollisionDetection?: boolean;
+    /** 拖拽时移动地图 @since 4.0（构造函数） */
+    enableDraggingMap?: boolean;
+}
+export interface LabelOptions {
+    offset?: Size;
+    position?: Point;
+    anchor?: ControlAnchor;
+    enableMassClear?: boolean;
+    enableClicking?: boolean;
+    width?: number;
+    /** CSS 样式键值对（如 { color: '#f00', fontSize: '14px' }） */
+    styles?: Record<string, string | number>;
+    /** 透明度 0-1（对应 SDK setOpacity，v4+） */
+    opacity?: number;
+    /** 鼠标悬停标题（对应 SDK setTitle） */
+    title?: string;
+    /** 层叠顺序（对应 SDK setZIndex） */
+    zIndex?: number;
+}
+/** IconSequence 值对象句柄：driver.createIconSequence / <IconSequence> 产出，放进 Polyline#icons */
+export type IconSequenceHandle = OverlayHandle;
+export interface PolylineOptions {
+    strokeColor?: string;
+    strokeWeight?: number;
+    strokeOpacity?: number;
+    strokeStyle?: 'solid' | 'dashed' | 'dotted';
+    /** 描边线端头类型 @since 4.0 */
+    strokeLineCap?: 'round' | 'butt' | 'square';
+    /** 描边线连接处类型 @since 4.0 */
+    strokeLineJoin?: 'round' | 'miter' | 'bevel';
+    enableMassClear?: boolean;
+    enableEditing?: boolean;
+    enableClicking?: boolean;
+    /** 大地线模式 */
+    geodesic?: boolean;
+    /** 跨180度经线最短路径 */
+    linkRight?: boolean;
+    /** 跨经度180度裁剪 @since 4.0 */
+    clip?: boolean;
+    /** 输入坐标类型 @since 4.0 */
+    coordType?: 'BMAP_COORD_BD09' | 'BMAP_COORD_GCJ02' | 'BMAP_COORD_WGS84';
+    /** 配置贴合折线的图标（方向箭头/循环图标）；元素用 driver.createIconSequence 返回的 handle，也兼容 SDK IconSequence 实例。4.0 折线纹理优先用 strokeTexture */
+    icons?: Array<IconSequenceHandle | object>;
+    /** 虚线样式 [实线长, 间隙长] @since 4.0 */
+    dashArray?: number[];
+    /** 线纹理配置 @since 4.0 */
+    strokeTexture?: {
+        url: string;
+        width?: number;
+        height?: number;
+    };
+    zIndex?: number;
+}
+export interface PolygonOptions {
+    strokeColor?: string;
+    fillColor?: string;
+    strokeWeight?: number;
+    strokeOpacity?: number;
+    fillOpacity?: number;
+    strokeStyle?: 'solid' | 'dashed' | 'dotted';
+    /** 描边线端头类型 @since 4.0 */
+    strokeLineCap?: 'round' | 'butt' | 'square';
+    /** 描边线连接处类型 @since 4.0 */
+    strokeLineJoin?: 'round' | 'miter' | 'bevel';
+    enableMassClear?: boolean;
+    enableEditing?: boolean;
+    enableClicking?: boolean;
+    /** 跨180度经线最短路径 */
+    linkRight?: boolean;
+    /** 输入坐标类型 @since 4.0 */
+    coordType?: 'BMAP_COORD_BD09' | 'BMAP_COORD_GCJ02' | 'BMAP_COORD_WGS84';
+    /** 虚线样式 [实线长, 间隙长] @since 4.0 */
+    dashArray?: number[];
+    zIndex?: number;
+}
+/** Circle 不支持 strokeLineCap/strokeLineJoin/linkRight */
+export interface CircleOptions {
+    strokeColor?: string;
+    fillColor?: string;
+    strokeWeight?: number;
+    strokeOpacity?: number;
+    fillOpacity?: number;
+    strokeStyle?: 'solid' | 'dashed' | 'dotted';
+    enableMassClear?: boolean;
+    enableEditing?: boolean;
+    enableClicking?: boolean;
+    coordType?: 'BMAP_COORD_BD09' | 'BMAP_COORD_GCJ02' | 'BMAP_COORD_WGS84';
+    dashArray?: number[];
+    zIndex?: number;
+}
+/**
+ * Rectangle 不支持 strokeLineCap/strokeLineJoin。
+ * 整个 Rectangle 类 @since 4.0（v3 不存在，driver 返回 null）。
+ */
+export interface RectangleOptions {
+    strokeColor?: string;
+    fillColor?: string;
+    strokeWeight?: number;
+    strokeOpacity?: number;
+    fillOpacity?: number;
+    strokeStyle?: 'solid' | 'dashed' | 'dotted';
+    enableMassClear?: boolean;
+    enableEditing?: boolean;
+    enableClicking?: boolean;
+    /** 跨180度经线最短路径 */
+    linkRight?: boolean;
+    /** 输入坐标类型 */
+    coordType?: 'BMAP_COORD_BD09' | 'BMAP_COORD_GCJ02' | 'BMAP_COORD_WGS84';
+    /** 虚线样式 [实线长, 间隙长]，默认实线与空隙均为线宽的 2 倍 */
+    dashArray?: number[];
+    zIndex?: number;
+}
+/**
+ * BezierCurve 只有描边、没有填充，也不支持编辑 / strokeLineCap / strokeLineJoin / coordType。
+ * 整个 BezierCurve 类 @since 4.0（v3 不存在，driver 返回 null）。
+ */
+export interface BezierCurveOptions {
+    strokeColor?: string;
+    strokeWeight?: number;
+    strokeOpacity?: number;
+    strokeStyle?: 'solid' | 'dashed' | 'dotted';
+    enableMassClear?: boolean;
+    enableClicking?: boolean;
+    /** 是否启用编辑（拖拽顶点/控制点），4.0/GL */
+    enableEditing?: boolean;
+    /** 虚线样式 [实线长, 间隙长]，默认实线与空隙均为线宽的 2 倍 */
+    dashArray?: number[];
+    zIndex?: number;
+}
+/**
+ * Prism 只有顶面/侧面填充，没有任何 stroke 系列配置，也不支持编辑。
+ * 整个 Prism 类 @since 4.0（v3 不存在，driver 返回 null）。
+ */
+export interface PrismOptions {
+    topFillColor?: string;
+    topFillOpacity?: number;
+    sideFillColor?: string;
+    sideFillOpacity?: number;
+    enableMassClear?: boolean;
+    enableClicking?: boolean;
+    zIndex?: number;
+}
+export interface GroundOverlayOptions {
+    /** 图层透明度 0~1，默认 1 */
+    opacity?: number;
+    /** 是否允许被 map.clearOverlays() 清除，默认 true */
+    enableMassClear?: boolean;
+    /** 是否响应鼠标事件，默认 true @since 4.0 */
+    enableClicking?: boolean;
+    /**
+     * 叠加内容来源。type='image' 传图片地址，'video' 传视频地址，'canvas' 直接传 canvas 元素。
+     * @since 4.0
+     */
+    url?: string | HTMLCanvasElement;
+    /** 最小缩放级别，v3 默认 1，v4 默认 3 */
+    displayOnMinLevel?: number;
+    /** 最大缩放级别，v3 默认 19，v4 默认 21 */
+    displayOnMaxLevel?: number;
+    /** @deprecated 4.0 请使用 url，SDK 仍兼容此配置 */
+    imageURL?: string;
+    /** 是否拉伸图片填满区域，默认 false @removed 4.0（仅 v3 有效） */
+    stretch?: boolean;
+    /** 叠加内容类型，默认 'image' @since 4.0 */
+    type?: 'image' | 'video' | 'canvas';
+    /** 是否绘制在普通覆盖物之上，默认 false @since 4.0 */
+    top?: boolean;
+    /**
+     * 是否开启循环重绘，仅 type='canvas' 生效。开启后每帧调用 drawHook 并重新采集 canvas 作为贴图。
+     * 默认 false @since 4.0
+     */
+    isReDraw?: boolean;
+    /** 自定义绘制回调，type='canvas' 且 isReDraw 开启时每帧渲染前调用 @since 4.0 */
+    drawHook?: () => void;
+    /**
+     * 层叠顺序。注意：SDK 的 GroundOverlayOptions 没有此字段（不能通过 constructor 传），
+     * 但类上有 setZIndex()，所以这里作为可响应式更新的属性暴露。
+     * v4 若需始终置于普通覆盖物之上请用 top。
+     */
+    zIndex?: number;
+}
+/**
+ * GroundPoint 构造函数的可选参数。
+ * SDK dts 注释标明"继承 GroundOverlayOptions"，类本身继承 GroundOverlay，
+ * 因此除自身 7 个字段外还继承了 GroundOverlayOptions 的全部字段（opacity、enableMassClear 等）。
+ * @since 4.0
+ */
+export interface GroundPointOptions extends GroundOverlayOptions {
+    /** 图标地址（GroundPoint 只接受图片地址，不接受 canvas 元素） */
+    url?: string;
+    /** 坐标点尺寸，单位像素 */
+    size?: Size;
+    /** 锚点，以图标左上角为原点 @default new BMap.Size(0, 0) */
+    anchor?: Size;
+    /** 缩放比例 @default 1 */
+    scale?: number;
+    /** 旋转角度，单位度 @default 0 */
+    rotation?: number;
+    /** 偏移量 @default new BMap.Size(0, 0) */
+    offset?: Size;
+    /** 尺寸参考的缩放级别 @default 18 */
+    level?: number;
+}
+/**
+ * PointCollection 构造函数的可选参数。
+ * @removed 4.0 — PointCollection 整体在 v4 移除，仅 v3 可用。
+ */
+export interface PointCollectionOptions {
+    /** 海量点的预设形状（ShapeType 枚举，见 BMAP_POINT_SHAPE_* 常量） */
+    shape?: number;
+    /**
+     * 海量点的颜色，支持颜色字符串、十六进制、RGB、RGBA、HSL、HSLA 格式
+     * @default '#fa937e'
+     */
+    color?: string;
+    /** 海量点的预设尺寸（SizeType 枚举，见 BMAP_POINT_SIZE_* 常量） */
+    size?: number;
+}
+/**
+ * InfoWindow 构造函数的可选参数。
+ * enableMessage / message 在 v4 已移除（仅 v3 有效）。
+ */
+export interface InfoWindowOptions {
+    /** 信息窗宽度（px），范围 220-730，0 = 自适应 @default 0 */
+    width?: number;
+    /** 信息窗高度（px），范围 60-650，0 = 自适应 @default 0 */
+    height?: number;
+    /** 最大化时宽度（px），范围 220-730 @default 730 */
+    maxWidth?: number;
+    /** 位置偏移值，底端尖角相对于地理坐标的偏移量 */
+    offset?: Size;
+    /** 标题文字，支持 HTML */
+    title?: string;
+    /** 打开时地图自动平移 @default true */
+    enableAutoPan?: boolean;
+    /** 点击地图时关闭信息窗口 @default true */
+    enableCloseOnClick?: boolean;
+    /** 显示短信发送按钮 @removed 4.0 */
+    enableMessage?: boolean;
+    /** 自定义短信内容（完整短信 = 自定义内容 + 位置链接，最长 140 字） @removed 4.0 */
+    message?: string;
+    /** 最大化时显示的内容，支持 HTML */
+    maxContent?: string;
+    /** 开启最大化功能 @default false */
+    enableMaximize?: boolean;
+    /** 是否开启信息窗内的搜索工具（查看周边等），4.0/GL；构造时生效 @default false，2.0.3 新增 */
+    enableSearchTool?: boolean;
+}
+/**
+ * Symbol 构造函数的可选参数。
+ * Symbol 是矢量图标值对象（非 Overlay），用作 Marker 的 icon 参数。
+ */
+export interface SymbolOptions {
+    /** 锚点位置，相对于图标自身坐标系 */
+    anchor?: Size;
+    /** 填充颜色，支持十六进制、RGB、RGBA 等 */
+    fillColor?: string;
+    /** 填充透明度，取值范围 0-1 */
+    fillOpacity?: number;
+    /** 缩放比例 @default 1 */
+    scale?: number;
+    /** 旋转角度，单位度 */
+    rotation?: number;
+    /** 描边颜色 */
+    strokeColor?: string;
+    /** 描边透明度，取值范围 0-1 */
+    strokeOpacity?: number;
+    /** 描边线宽，未指定时与 scale 值相同 */
+    strokeWeight?: number;
+}
+/**
+ * Icon 构造函数的可选参数。Icon 是值对象（非 Overlay），用作 Marker 的 icon。
+ */
+export interface IconOptions {
+    /**
+     * 定位锚点，相对于图标左上角的偏移值。
+     * @deprecated 4.0 起不建议使用，请用 MarkerOptions#anchor 替代
+     */
+    anchor?: Size;
+    /** 图片相对于可视区域的偏移值（等同 CSS background-position），用于 Sprites 切图 */
+    imageOffset?: Size;
+    /** 图片实际大小（等同 CSS background-size），用于 Sprites 逻辑大小 / 高清屏适配 */
+    imageSize?: Size;
+    /** 信息窗口定位锚点 @removed 4.0 */
+    infoWindowAnchor?: Size;
+    /** 打印图片 URL，仅对 IE6 有效 @removed 4.0 */
+    printImageUrl?: string;
+    /** 高分辨率屏幕图片资源集 @since 4.0 @hide */
+    srcset?: {
+        '2x': string;
+    };
+}
+/**
+ * Hotspot 构造函数的可选参数。
+ * @removed 4.0 — Hotspot 整体在 v4 移除，仅 v3 可用。
+ */
+export interface HotspotOptions {
+    /** 提示文本 */
+    text?: string;
+    /** 扩展偏移 [top, right, bottom, left]，默认 [5, 5, 5, 5] */
+    offsets?: number[];
+    /** 自定义数据 */
+    userData?: unknown;
+    /** 最小缩放级别 */
+    minZoom?: number;
+    /** 最大缩放级别 */
+    maxZoom?: number;
+}
+/**
+ * CustomOverlay 构造函数的可选参数。@since 4.0。
+ * React 组件通过 children 渲染 DOM 内容，内部转换为 SDK 需要的 domCreate。
+ */
+export interface CustomOverlayOptions {
+    /** 地理坐标点 */
+    point?: Point;
+    /** 锚点 [x, y]，左上角 [0,0]，取值 [0,1] @default [0.5, 1] */
+    anchors?: [number, number];
+    /** X 轴偏移（px） @default 0 */
+    offsetX?: number;
+    /** Y 轴偏移（px） @default 0 */
+    offsetY?: number;
+    /** 旋转角度（度） @default 0 */
+    rotation?: number;
+    /** 初始旋转基准角度，最终角度 = rotationOrigin + 地图朝向 @default 0 */
+    rotationInit?: number;
+    /** 最小缩放级别 */
+    minZoom?: number;
+    /** 最大缩放级别 */
+    maxZoom?: number;
+    /** 自定义业务属性 */
+    properties?: unknown;
+    /** DOM 固定在底部 @default false */
+    fixBottom?: boolean;
+    /** 使用 translate3d 性能优化 @default false */
+    useTranslate?: boolean;
+    /** 随地图旋转 @default false */
+    autoFollowHeadingChanged?: boolean;
+    /** 层叠顺序 @default 0 */
+    zIndex?: number;
+    /** 是否在 map.clearOverlays() 时清除 @since 4.0 @default true */
+    enableMassClear?: boolean;
+    /** 覆盖物上是否允许拖拽地图 @since 4.0 @default false */
+    enableDraggingMap?: boolean;
+}
+/** 所有 Overlay 组件共享的通用 props（不属于 SDK Options） */
+export interface OverlayReactProps {
+    /** 控制覆盖物显示/隐藏（对应 SDK 的 show()/hide()）。undefined 或 true = 显示，false = 隐藏 */
+    visible?: boolean;
+}
+export interface MarkerProps extends MarkerOptions, OverlayReactProps {
+    position: Point;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onDragStart?: (point: Point, raw: unknown) => void;
+    onDragging?: (point: Point, raw: unknown) => void;
+    onDragEnd?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+}
+export interface LabelProps extends LabelOptions, OverlayReactProps {
+    content: string;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+}
+export interface PolylineProps extends PolylineOptions, EditNodeStyleOptions, OverlayReactProps {
+    path: Point[];
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    /** 右键双击 @since 4.0 */
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 线更新 */
+    onLineUpdate?: (raw: unknown) => void;
+    /** 开始编辑 @since 4.0 */
+    onEditStart?: (raw: unknown) => void;
+    /** 编辑结束 @since 4.0 */
+    onEditEnd?: (raw: unknown) => void;
+    /** 开始拖拽编辑节点 @since 4.0 */
+    onLineVertexDragStart?: (raw: unknown) => void;
+    /** 拖拽编辑节点中 @since 4.0 */
+    onLineVertexDragging?: (raw: unknown) => void;
+    /** 拖拽编辑节点结束 @since 4.0 */
+    onLineVertexDragEnd?: (raw: unknown) => void;
+    /** 删除编辑节点 @since 4.0 */
+    onLineVertexDel?: (raw: unknown) => void;
+}
+export interface PolygonProps extends PolygonOptions, EditNodeStyleOptions, OverlayReactProps {
+    /**
+     * 多边形坐标点。单坐标串 Point[] 为普通多边形；
+     * 多坐标串 Point[][] 表示带洞/多环（第一环为外边界，后续环为镂空孔洞），对齐 JSAPI。
+     * 注意：多坐标串（镂空/多环）仅 4.0/GL 支持；3.0 传入多坐标串不渲染。
+     */
+    path: Point[] | Point[][];
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    /** 右键双击 @since 4.0 */
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 线更新 */
+    onLineUpdate?: (raw: unknown) => void;
+    /** 开始编辑 @since 4.0 */
+    onEditStart?: (raw: unknown) => void;
+    /** 编辑结束 @since 4.0 */
+    onEditEnd?: (raw: unknown) => void;
+    /** 开始拖拽编辑节点 @since 4.0 */
+    onLineVertexDragStart?: (raw: unknown) => void;
+    /** 拖拽编辑节点中 @since 4.0 */
+    onLineVertexDragging?: (raw: unknown) => void;
+    /** 拖拽编辑节点结束 @since 4.0 */
+    onLineVertexDragEnd?: (raw: unknown) => void;
+    /** 删除编辑节点 @since 4.0 */
+    onLineVertexDel?: (raw: unknown) => void;
+}
+export interface CircleProps extends CircleOptions, EditNodeStyleOptions, OverlayReactProps {
+    center: Point;
+    radius: number;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    /** 右键双击 @since 4.0 */
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 线更新 */
+    onLineUpdate?: (raw: unknown) => void;
+    /** 开始编辑 @since 4.0 */
+    onEditStart?: (raw: unknown) => void;
+    /** 编辑结束 @since 4.0 */
+    onEditEnd?: (raw: unknown) => void;
+    /** 开始拖拽编辑节点 @since 4.0 */
+    onLineVertexDragStart?: (raw: unknown) => void;
+    /** 拖拽编辑节点中 @since 4.0 */
+    onLineVertexDragging?: (raw: unknown) => void;
+    /** 拖拽编辑节点结束 @since 4.0 */
+    onLineVertexDragEnd?: (raw: unknown) => void;
+    /** 删除编辑节点 @since 4.0 */
+    onLineVertexDel?: (raw: unknown) => void;
+}
+/** Rectangle 事件对照 RectangleEventMap = GraphEventMap<Rectangle>（整体 @since 4.0） */
+export interface RectangleProps extends RectangleOptions, EditNodeStyleOptions, OverlayReactProps {
+    bounds: Bounds;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 线更新 */
+    onLineUpdate?: (raw: unknown) => void;
+    /** 开始编辑 */
+    onEditStart?: (raw: unknown) => void;
+    /** 编辑结束 */
+    onEditEnd?: (raw: unknown) => void;
+    /** 开始拖拽编辑节点 */
+    onLineVertexDragStart?: (raw: unknown) => void;
+    /** 拖拽编辑节点中 */
+    onLineVertexDragging?: (raw: unknown) => void;
+    /** 拖拽编辑节点结束 */
+    onLineVertexDragEnd?: (raw: unknown) => void;
+    /** 删除编辑节点 */
+    onLineVertexDel?: (raw: unknown) => void;
+}
+/**
+ * BezierCurve 事件对照 BezierCurveEventMap
+ * = Omit<GraphEventMap<BezierCurve>, editstart|editend|linevertex*>（整体 @since 4.0）。
+ * 即：无编辑相关事件。
+ */
+export interface BezierCurveProps extends BezierCurveOptions, EditNodeStyleOptions, OverlayReactProps {
+    /** 路径点数组，至少两个点 */
+    path: Point[];
+    /** 控制点数组，每两个路径点之间 1~2 个控制点，组数应为 path.length - 1，如 [[cp1, cp2], [cp3]] */
+    controlPoints: Point[][];
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 节点数据变化 */
+    onLineUpdate?: (raw: unknown) => void;
+}
+/**
+ * Prism 事件对照 PrismEventMap
+ * = Omit<GraphEventMap<Prism>, editstart|editend|linevertex*>（整体 @since 4.0）。
+ * 即：无编辑相关事件。
+ */
+export interface PrismProps extends PrismOptions, OverlayReactProps {
+    /**
+     * 底面多边形坐标点。单坐标串 Point[]，或多坐标串 Point[][]。
+     * 注意：SDK 的 setPath() 只接受单坐标串，多坐标串仅 constructor 支持，
+     * 因此传 Point[][] 时后续修改需要通过 key 重新挂载组件才能生效。
+     */
+    path: Point[] | Point[][];
+    /** 棱柱高度，单位米（SDK 必填参数） */
+    altitude: number;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 节点数据变化 */
+    onLineUpdate?: (raw: unknown) => void;
+}
+/**
+ * GroundOverlay 事件对照 GroundOverlayEventMap。
+ * 只有 click / dblclick / remove 是 v3 起就有，其余均 @since 4.0。
+ * 注意它不是 GraphEventMap，没有编辑相关事件。
+ */
+export interface GroundOverlayProps extends GroundOverlayOptions, OverlayReactProps {
+    /** 叠加层显示的矩形区域 */
+    bounds: Bounds;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    /** @since 4.0 */
+    onRightClick?: (point: Point, raw: unknown) => void;
+    /** @since 4.0 */
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    /** @since 4.0 */
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    /** @since 4.0 */
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    /** @since 4.0 */
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    /** @since 4.0 */
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    /** @since 4.0 */
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 渲染数据发生变化 @since 4.0 */
+    onLineUpdate?: (raw: unknown) => void;
+}
+/**
+ * GroundPoint 事件对照 GroundOverlayEventMap（SDK 未定义 GroundPointEventMap，
+ * 类继承 GroundOverlay，事件沿用了同一套）。
+ * GroundPoint 整体 @since 4.0，故全部事件均为 v4+。
+ */
+export interface GroundPointProps extends GroundPointOptions, OverlayReactProps {
+    /** 地理坐标点 */
+    point: Point;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onRightDoubleClick?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseMove?: (point: Point, raw: unknown) => void;
+    onRemove?: (point: Point, raw: unknown) => void;
+    /** 渲染数据发生变化 */
+    onLineUpdate?: (raw: unknown) => void;
+}
+/**
+ * PointCollection 事件对照 PointCollectionEventMap。
+ * 整体 @removed 4.0，仅 v3 可用；事件对象只有 { type, target, point }。
+ */
+export interface PointCollectionProps extends PointCollectionOptions, OverlayReactProps {
+    /** 点的坐标集合 */
+    points: Point[];
+    /** 继承自 Overlay 类（SDK 的 PointCollectionOptions 未列出，但类上有 enable/disableMassClear） */
+    enableMassClear?: boolean;
+    onClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+}
+/**
+ * Marker3D — 3D 标注。@since 4.0（WebGL only）。
+ * SDK: constructor(point, height, { shape, size, fillColor, fillOpacity, enableMassClear })
+ * setter: setPosition/setHeight/setFillColor/setFillOpacity；shape/size 无 setter（重建）
+ */
+export interface Marker3DOptions {
+    /** 形状：1=circle, 2=rect（构造函数，无 setter） */
+    shape?: number;
+    /** 像素大小（构造函数，无 setter） */
+    size?: number;
+    /** 填充颜色 */
+    fillColor?: string;
+    /** 填充透明度 0-1 */
+    fillOpacity?: number;
+    enableMassClear?: boolean;
+}
+export interface Marker3DProps extends Marker3DOptions, OverlayReactProps {
+    position: Point;
+    height: number;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+}
+/**
+ * InfoWindow 事件对照 InfoWindowEventMap。
+ * 全部 6 个事件都是 OverlayBaseEvent（仅含 type/target/currentTarget，无 point/pixel）。
+ */
+export interface InfoWindowProps extends InfoWindowOptions, OverlayReactProps {
+    /** 窗口内容，支持 HTML 字符串或 DOM 节点 */
+    content: string | HTMLElement;
+    /** 受控：true=打开, false=关闭。不传则 mount 时自动打开。 */
+    open?: boolean;
+    /** 地图级打开位置（不在 Marker 内嵌时必传） */
+    position?: Point;
+    /** 信息窗口打开时触发 */
+    onOpen?: (raw: unknown) => void;
+    /** 信息窗口关闭时触发（含 X 按钮关闭） */
+    onClose?: (raw: unknown) => void;
+    /** 点击信息窗口关闭按钮时触发 */
+    onClickClose?: (raw: unknown) => void;
+    /** 信息窗口最大化时触发，需开启 enableMaximize */
+    onMaximize?: (raw: unknown) => void;
+    /** 信息窗口从最大化恢复时触发 */
+    onRestore?: (raw: unknown) => void;
+    /** 信息窗口尺寸变化时触发 */
+    onResize?: (raw: unknown) => void;
+}
+/**
+ * Symbol 是值对象（非 Overlay），无事件。
+ * path 为 SVG path 字符串或预定义符号常量（BMap_Symbol_SHAPE_*）。
+ */
+export interface SymbolProps extends SymbolOptions, OverlayReactProps {
+    path: string | number;
+}
+/**
+ * Icon 是值对象（非 Overlay），无事件。
+ * url 和 size 是 constructor 的前两个位置参数，但也有 setter（setImageUrl/setSize）可响应式更新。
+ */
+export interface IconProps extends IconOptions, OverlayReactProps {
+    url: string;
+    size: Size;
+}
+/**
+ * IconSequence 用于在 Polyline 上重复显示符号（如箭头）。
+ * @deprecated 4.0 已废弃，请使用 PolylineOptions#strokeTexture 替代。
+ * constructor: new BMap.IconSequence(symbol, offset, repeat, fixedRotation)。
+ * 全部参数都是 constructor 位置参数，无 setter — 变化时重建。
+ * 无事件（值对象，非 Overlay）。
+ */
+export interface IconSequenceProps extends OverlayReactProps {
+    /** 符号样式（Symbol Handle 或 SDK Symbol 实例） */
+    symbol?: SymbolIcon | OverlayHandle;
+    /** 符号相对于线起点的位置，百分比（如 '50%'）或像素值 */
+    offset?: string;
+    /** 符号在线上重复显示的间距，百分比或像素值；与 offset 同时设置时以 repeat 为准 */
+    repeat?: string;
+    /** 图标旋转角度是否与线走向一致 */
+    fixedRotation?: boolean;
+}
+/**
+ * Hotspot 是值对象（非 Overlay），@removed 4.0，仅 v3 可用。
+ * 通过 map.addHotspot/removeHotspot 管理，不走 addOverlay。
+ * 无事件（SDK 未定义 HotspotEventMap）。
+ */
+export interface HotspotProps extends HotspotOptions, OverlayReactProps {
+    position: Point;
+}
+/**
+ * CustomOverlay 事件对照 CustomOverlayEventMap。@since 4.0。
+ * children 会被渲染到 SDK 自定义覆盖物的 DOM 容器内。
+ */
+export interface CustomOverlayProps extends CustomOverlayOptions, OverlayReactProps {
+    onClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+}
+/**
+ * Marker3D — 3D 标注。@since 4.0（WebGL only）。
+ * SDK: constructor(point, height, { shape, size, fillColor, fillOpacity, enableMassClear })
+ * setter: setPosition/setHeight/setFillColor/setFillOpacity；shape/size 无 setter（重建）
+ */
+export interface Marker3DOptions {
+    /** 形状：1=circle, 2=rect（构造函数，无 setter） */
+    shape?: number;
+    /** 像素大小（构造函数，无 setter） */
+    size?: number;
+    /** 填充颜色 */
+    fillColor?: string;
+    /** 填充透明度 0-1 */
+    fillOpacity?: number;
+    enableMassClear?: boolean;
+}
+export interface Marker3DProps extends Marker3DOptions, OverlayReactProps {
+    position: Point;
+    height: number;
+    onClick?: (point: Point, raw: unknown) => void;
+    onDoubleClick?: (point: Point, raw: unknown) => void;
+    onRightClick?: (point: Point, raw: unknown) => void;
+    onMouseOver?: (point: Point, raw: unknown) => void;
+    onMouseOut?: (point: Point, raw: unknown) => void;
+    onMouseDown?: (point: Point, raw: unknown) => void;
+    onMouseUp?: (point: Point, raw: unknown) => void;
+}