@xingm/vmap-cesium-toolbar 0.0.2-alpha.2 → 0.0.2-alpha.4

package/dist/hooks/useDrawHelper.d.ts

@@ -8,10 +8,10 @@ import * as Cesium from "cesium";
 export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, message: Ref<string>): {
     drawHelper: Ref<{
         handleSceneModeChanged: () => void;
-        startDrawingLine: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingPolygon: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingRectangle: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingCircle: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingLine: (options?: import('..').DrawOptions) => void;
+        startDrawingPolygon: (options?: import('..').DrawOptions) => void;
+        startDrawingRectangle: (options?: import('..').DrawOptions) => void;
+        startDrawingCircle: (options?: import('..').DrawOptions) => void;
         endDrawing: () => void;
         clearAll: () => void;
         clearAllEntities: () => void;
@@ -30,10 +30,10 @@ export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, me
         destroy: () => void;
     } | null, DrawHelper | {
         handleSceneModeChanged: () => void;
-        startDrawingLine: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingPolygon: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingRectangle: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingCircle: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingLine: (options?: import('..').DrawOptions) => void;
+        startDrawingPolygon: (options?: import('..').DrawOptions) => void;
+        startDrawingRectangle: (options?: import('..').DrawOptions) => void;
+        startDrawingCircle: (options?: import('..').DrawOptions) => void;
         endDrawing: () => void;
         clearAll: () => void;
         clearAllEntities: () => void;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 // VMap Cesium Toolbar Plugin Type Definitions
 
-import type { Viewer, Cartesian3, Cartographic } from 'cesium';
+import type { Viewer, Cartesian3, Cartographic, Entity } from 'cesium';
 
 // 工具栏配置接口
 export interface ToolbarConfig {
@@ -187,20 +187,115 @@ export declare class CesiumMapToolbar {
   destroy(): void;
 }
 
+// 覆盖物服务：对外暴露的简化类型声明
+export type PositionOffset =
+  | 'top'
+  | 'bottom'
+  | 'left'
+  | 'right'
+  | 'top-left'
+  | 'top-right'
+  | 'bottom-left'
+  | 'bottom-right'
+  | 'left-top'
+  | 'left-bottom'
+  | 'right-top'
+  | 'right-bottom';
+
+export interface InfoWindowOptions {
+  position: Cartesian3 | [number, number, number?];
+  content: string | HTMLElement;
+  width?: number;
+  height?: number;
+  pixelOffset?: { x: number; y: number };
+  show?: boolean;
+  id?: string;
+  closable?: boolean;
+  onClick?: (entity: any) => void;
+  onClose?: (entity: any) => void;
+  backgroundColor?: string;
+  color?: string;
+  font?: string;
+  className?: string;
+  style?: Partial<CSSStyleDeclaration>;
+  hideWhenOutOfView?: boolean;
+  anchorHeight?: number;
+  anchorPixel?: number;
+  tailGap?: number;
+  updateInterval?: number;
+  showArrow?: boolean;
+  arrowSize?: number;
+  positionOffset?: PositionOffset;
+}
+
+export declare class CesiumOverlayService {
+  constructor(viewer: Viewer);
+  addMarker(options: any): any; // 返回 Cesium.Entity
+  addLabel(options: any): any; // 返回 Cesium.Entity
+  addIcon(options: any): any; // 返回 Cesium.Entity
+  addSvg(options: any): any; // 返回 Cesium.Entity
+  addInfoWindow(options: InfoWindowOptions): any; // 返回 Cesium.Entity
+  addPolyline(options: any): any; // 返回 Cesium.Entity
+  addPolygon(options: any): any; // 返回 Cesium.Entity
+  addRectangle(options: any): any; // 返回 Cesium.Entity
+  addCircle(options: any): any; // 返回 Cesium.Entity
+  getOverlay(id: string): any | undefined; // 返回 Cesium.Entity | undefined
+  removeOverlay(id: string): boolean;
+  removeAllOverlays(): void;
+  updateOverlayPosition(id: string, position: Cartesian3 | [number, number, number?]): boolean;
+  setOverlayVisible(id: string, visible: boolean): boolean;
+  getAllOverlayIds(): string[];
+  getAllOverlays(): any[]; // Cesium.Entity[]
+  destroy(): void;
+}
+
+// 绘制相关类型（与内部实现保持一致）
+export interface DrawOptions {
+  strokeColor?: any | string;
+  strokeWidth?: number;
+  fillColor?: any | string;
+  outlineColor?: any | string;
+  outlineWidth?: number;
+  selected?: {
+    color?: any | string;
+    width?: number;
+    outlineColor?: any | string;
+    outlineWidth?: number;
+  };
+  onClick?: (entity: Entity, type?: 'line' | 'polygon' | 'rectangle' | 'circle', positions?: Cartesian3[]) => void;
+}
+
+export interface DrawResult {
+  entity: Entity | null;
+  type: 'line' | 'polygon' | 'rectangle' | 'circle';
+  positions: Cartesian3[];
+  distance?: number;
+  areaKm2?: number;
+}
+
 export declare class DrawHelper {
   constructor(viewer: Viewer);
-  startDrawingLine(): void;
-  startDrawingPolygon(): void;
-  startDrawingRectangle(): void;
-  drawFrustum(options?: FrustumOptions): void;
+  // 开始绘制（可选样式参数）
+  startDrawingLine(options?: DrawOptions): void;
+  startDrawingPolygon(options?: DrawOptions): void;
+  startDrawingRectangle(options?: DrawOptions): void;
+  startDrawingCircle(options?: DrawOptions): void;
+  // 控制绘制流程
   endDrawing(): void;
+  // 清理与管理
   clearAll(): void;
-  clearFrustum(): void;
-  removeEntity(entity: any): void; // Cesium.Entity
-  getFinishedEntities(): any[]; // Cesium.Entity[]
+  clearAllEntities(): void;
+  clearAllPoints(): void;
+  removeEntity(entity: Entity): void;
+  getFinishedEntities(): Entity[];
+  // 事件回调注册
+  onMeasureComplete(callback: (result: DrawResult) => void): void;
   onDrawStart(callback: () => void): void;
-  onDrawEnd(callback: (entity: any) => void): void; // Cesium.Entity | null
-  onEntityRemoved(callback: (entity: any) => void): void; // Cesium.Entity
+  onDrawEnd(callback: (entity: Entity | null) => void): void;
+  onEntityRemoved(callback: (entity: Entity) => void): void;
+  // 场景模式切换适配
+  handleSceneModeChanged(): void;
+  // 资源释放
   destroy(): void;
 }
 
@@ -215,7 +310,9 @@ export declare function initCesium(
 declare const _default: {
   CesiumMapToolbar: typeof CesiumMapToolbar;
   DrawHelper: typeof DrawHelper;
+  CesiumOverlayService: typeof CesiumOverlayService;
   initCesium: typeof initCesium;
+  initCesiumMap: typeof initCesium;
 };
 
 export default _default;