@xingm/vmap-cesium-toolbar 0.0.2-alpha.13 → 0.0.2-alpha.14

package/dist/libs/overlay/types.d.ts

@@ -3,6 +3,54 @@ import { Cartesian3, Entity, Color, MaterialProperty, Rectangle, Cartographic }
  * 覆盖物位置类型
  */
 export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];
+export interface OverlayHighlightOriginalStyle {
+    point?: {
+        pixelSize?: any;
+        color?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+    };
+    label?: {
+        fillColor?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        scale?: any;
+    };
+    billboard?: {
+        scale?: any;
+        color?: any;
+    };
+    polyline?: {
+        width?: any;
+        material?: any;
+    };
+    polygon?: {
+        outline?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        material?: any;
+    };
+    rectangle?: {
+        outline?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        material?: any;
+    };
+    ellipse?: {
+        outline?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        material?: any;
+    };
+}
+export interface OverlayClickHighlightOptions {
+    /** 高亮主颜色（默认 yellow） */
+    color?: Color | string;
+    /** 面填充透明度（默认 0.35） */
+    fillAlpha?: number;
+}
+/** 与 clickHighlight 使用同样的参数结构（颜色 + 面填充透明度） */
+export type OverlayHoverHighlightOptions = OverlayClickHighlightOptions;
 /**
  * 覆盖物扩展实体类型
  * 用于在 Cesium.Entity 上挂载覆盖物相关的元数据
@@ -10,6 +58,21 @@ export type OverlayPosition = Cartesian3 | [number, number] | [number, number, n
 export interface OverlayEntity extends Entity {
     /** 覆盖物点击回调（由各 Map* 工具类设置） */
     _onClick?: (entity: Entity) => void;
+    /** 点击覆盖物时是否启用高亮（由各 Map* 工具类设置） */
+    _clickHighlight?: boolean | OverlayClickHighlightOptions;
+    /** 鼠标移入覆盖物时是否启用高亮（由各 Map* 工具类设置） */
+    _hoverHighlight?: boolean | OverlayHoverHighlightOptions;
+    /** 高亮联动的实体集合（复合覆盖物：边框/填充等一起切换） */
+    _highlightEntities?: Entity[];
+    /** 当前是否处于高亮状态 */
+    _isHighlighted?: boolean;
+    /** 当前高亮原因（click/hover 可叠加；click 优先显示） */
+    _highlightState?: {
+        click?: boolean;
+        hover?: boolean;
+    };
+    /** 用于还原高亮前的原始样式 */
+    _highlightOriginalStyle?: OverlayHighlightOriginalStyle;
     /** 覆盖物类型标识（用于 CesiumOverlayService 做差异化更新/删除） */
     _overlayType?: string;
     /** 信息窗口根 DOM（由 MapInfoWindow / CesiumOverlayService 使用） */
@@ -18,6 +81,10 @@ export interface OverlayEntity extends Entity {
     _borderEntity?: Entity;
     _innerEntity?: Entity;
     /** 粗边框 / 环形等形状相关元数据 */
+    /** 是否贴地（粗边框/环形等复合形状用） */
+    _clampToGround?: boolean;
+    /** 复合形状的基准高度（米，clampToGround=false 时有效） */
+    _baseHeight?: number;
     _isThickOutline?: boolean;
     _outlineWidth?: number;
     _isRing?: boolean;
@@ -38,4 +105,9 @@ export interface OverlayEntity extends Entity {
     _outerRadius?: number;
     _innerRadius?: number;
     _outerRectangle?: Rectangle;
+    /** primitive circle: 内部使用的纯色缓存（用于高亮恢复） */
+    _primitiveRingBaseColor?: Color;
+    _primitiveFillBaseColor?: Color;
+    /** primitive polygon/rectangle: 边框纯色缓存（用于高亮恢复） */
+    _primitiveBorderBaseColor?: Color;
 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.13",
+  "version": "0.0.2-alpha.14",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "index.js",

package/dist/utils/calc.d.ts

@@ -42,3 +42,9 @@ export declare function calculatePolygonArea(positions: Cartesian3[], ellipsoid?
  * @returns 中心点坐标
  */
 export declare function calculatePolygonCenter(positions: Cartesian3[]): Cartesian3;
+/**
+ * 计算折线总长度
+ * @param positions 折线顶点坐标数组
+ * @returns 总长度（米）
+ */
+export declare function calculatePolylineDistance(positions: Cartesian3[]): number;

package/dist/utils/selfIntersection.d.ts

@@ -0,0 +1,13 @@
+import { Cartesian3 } from '../../node_modules/cesium';
+/**
+ * Returns true if adding `nextPoint` to an open polygon polyline would create a self-intersection.
+ */
+export declare function wouldCreatePolygonSelfIntersection(existingPoints: Cartesian3[], nextPoint: Cartesian3, opts?: {
+    allowTouch?: boolean;
+}): boolean;
+/**
+ * Returns true if the closed polygon described by `points` is self-intersecting.
+ */
+export declare function isClosedPolygonSelfIntersecting(points: Cartesian3[], opts?: {
+    allowTouch?: boolean;
+}): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.13",
+  "version": "0.0.2-alpha.14",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "dist/index.js",