@xingm/vmap-cesium-toolbar 0.0.2-alpha.3 → 0.0.2-alpha.5

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 // VMap Cesium Toolbar Plugin Type Definitions
 
-import type { Viewer, Cartesian3, Cartographic } from 'cesium';
+import type * as Cesium from 'cesium';
+import type { Viewer, Cartesian3, Cartographic, Entity, Cartesian2 } from 'cesium';
 
 // 工具栏配置接口
 export interface ToolbarConfig {
@@ -187,20 +188,294 @@ export declare class CesiumMapToolbar {
   destroy(): void;
 }
 
+// 覆盖物服务：对外暴露的简化类型声明
+// 覆盖物位置类型（与 overlay/types.ts 保持一致）
+export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];
+
+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: OverlayPosition;
+  content: string | HTMLElement;
+  width?: number;
+  height?: number;
+  pixelOffset?: Cesium.Cartesian2 | { 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;
+}
+
+// Overlay: 选项类型（与各实现保持一致）
+export interface MarkerOptions {
+  position: OverlayPosition;
+  pixelSize?: number;
+  color?: any | string;
+  outlineColor?: any | string;
+  outlineWidth?: number;
+  heightReference?: any;
+  scaleByDistance?: Cesium.NearFarScalar;
+  disableDepthTestDistance?: number;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+export interface LabelOptions {
+  position: OverlayPosition;
+  text: string;
+  font?: string;
+  fillColor?: any | string;
+  outlineColor?: any | string;
+  outlineWidth?: number;
+  style?: any;
+  pixelOffset?: Cesium.Cartesian2;
+  eyeOffset?: Cesium.Cartesian3;
+  horizontalOrigin?: any;
+  verticalOrigin?: any;
+  heightReference?: any;
+  scale?: number;
+  showBackground?: boolean;
+  backgroundColor?: any | string;
+  backgroundPadding?: Cesium.Cartesian2;
+  disableDepthTestDistance?: number;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+export interface IconOptions {
+  position: OverlayPosition;
+  image: string;
+  width?: number;
+  height?: number;
+  scale?: number;
+  rotation?: number;
+  pixelOffset?: Cesium.Cartesian2;
+  eyeOffset?: Cesium.Cartesian3;
+  horizontalOrigin?: any;
+  verticalOrigin?: any;
+  heightReference?: any;
+  disableDepthTestDistance?: number;
+  color?: any | string;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+export interface SvgOptions {
+  position: OverlayPosition;
+  svg: string;
+  width?: number;
+  height?: number;
+  scale?: number;
+  rotation?: number;
+  pixelOffset?: Cesium.Cartesian2;
+  eyeOffset?: Cesium.Cartesian3;
+  horizontalOrigin?: any;
+  verticalOrigin?: any;
+  heightReference?: any;
+  disableDepthTestDistance?: number;
+  color?: any | string;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+export interface PolylineOptions {
+  positions: OverlayPosition[];
+  width?: number;
+  material?: Cesium.MaterialProperty | any | string;
+  clampToGround?: boolean;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+export interface PolygonOptions {
+  positions: OverlayPosition[];
+  material?: Cesium.MaterialProperty | any | string;
+  outline?: boolean;
+  outlineColor?: any | string;
+  outlineWidth?: number;
+  heightReference?: any;
+  extrudedHeight?: number;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+export interface RectangleOptions {
+  coordinates: Cesium.Rectangle;
+  material?: Cesium.MaterialProperty | any | string;
+  outline?: boolean;
+  outlineColor?: any | string;
+  outlineWidth?: number;
+  heightReference?: any;
+  extrudedHeight?: number;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+export interface CircleOptions {
+  position: OverlayPosition;
+  radius: number;
+  material?: Cesium.MaterialProperty | any | string;
+  outline?: boolean;
+  outlineColor?: any | string;
+  outlineWidth?: number;
+  heightReference?: any;
+  extrudedHeight?: number;
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
+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;
+}
+
+// Overlay: 工具类声明（只暴露主要方法）
+export declare class MapMarker {
+  constructor(viewer: Viewer);
+  add(options: MarkerOptions): Entity;
+  updatePosition(entity: Entity, position: OverlayPosition): void;
+  updateStyle(entity: Entity, options: Partial<Pick<MarkerOptions, 'color' | 'outlineColor' | 'outlineWidth' | 'pixelSize'>>): void;
+}
+
+export declare class MapLabel {
+  constructor(viewer: Viewer);
+  add(options: LabelOptions): Entity;
+  updatePosition(entity: Entity, position: OverlayPosition): void;
+}
+
+export declare class MapIcon {
+  constructor(viewer: Viewer);
+  add(options: IconOptions): Entity;
+  updatePosition(entity: Entity, position: OverlayPosition): void;
+  updateImage(entity: Entity, image: string): void;
+}
+
+export declare class MapSVG {
+  constructor(viewer: Viewer);
+  add(options: SvgOptions): Entity;
+  updatePosition(entity: Entity, position: OverlayPosition): void;
+}
+
+export declare class MapPolyline {
+  constructor(viewer: Viewer);
+  add(options: PolylineOptions): Entity;
+  updatePositions(entity: Entity, positions: OverlayPosition[]): void;
+  updateStyle(entity: Entity, options: Partial<Pick<PolylineOptions, 'width' | 'material'>>): void;
+}
+
+export declare class MapPolygon {
+  constructor(viewer: Viewer);
+  add(options: PolygonOptions): Entity;
+  updatePositions(entity: Entity, positions: OverlayPosition[]): void;
+  updateStyle(entity: Entity, options: Partial<Pick<PolygonOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+  remove(entityOrId: Entity | string): boolean;
+}
+
+export declare class MapRectangle {
+  constructor(viewer: Viewer);
+  add(options: RectangleOptions): Entity;
+  updateCoordinates(entity: Entity, coordinates: Cesium.Rectangle): void;
+  updateStyle(entity: Entity, options: Partial<Pick<RectangleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+  remove(entityOrId: Entity | string): boolean;
+}
+
+export declare class MapCircle {
+  constructor(viewer: Viewer);
+  add(options: CircleOptions): Entity;
+  updatePosition(entity: Entity, position: OverlayPosition): void;
+  updateRadius(entity: Entity, radius: number): void;
+  updateStyle(entity: Entity, options: Partial<Pick<CircleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): 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 +490,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;

package/dist/package.json

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

package/package.json

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