@xingm/vmap-cesium-toolbar 0.0.2-alpha.4 → 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, Entity } from 'cesium';
+import type * as Cesium from 'cesium';
+import type { Viewer, Cartesian3, Cartographic, Entity, Cartesian2 } from 'cesium';
 
 // 工具栏配置接口
 export interface ToolbarConfig {
@@ -188,6 +189,9 @@ export declare class CesiumMapToolbar {
 }
 
 // 覆盖物服务：对外暴露的简化类型声明
+// 覆盖物位置类型（与 overlay/types.ts 保持一致）
+export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];
+
 export type PositionOffset =
   | 'top'
   | 'bottom'
@@ -203,11 +207,11 @@ export type PositionOffset =
   | 'right-bottom';
 
 export interface InfoWindowOptions {
-  position: Cartesian3 | [number, number, number?];
+  position: OverlayPosition;
   content: string | HTMLElement;
   width?: number;
   height?: number;
-  pixelOffset?: { x: number; y: number };
+  pixelOffset?: Cesium.Cartesian2 | { x: number; y: number };
   show?: boolean;
   id?: string;
   closable?: boolean;
@@ -228,6 +232,124 @@ export interface InfoWindowOptions {
   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
@@ -249,6 +371,64 @@ export declare class CesiumOverlayService {
   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;

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.3",
+  "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.4",
+  "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",