@xingm/vmap-cesium-toolbar 0.0.4-alpha.2 → 0.0.5

package/dist/libs/CesiumMapModel.d.ts

@@ -80,11 +80,11 @@ export interface MapType {
     id: string;
     name: string;
     nameKey?: string;
-    /** 选中态左上角“地名”文案（可选，未配置时走 i18n 默认 key） */
+    /** 选中态左上角“路网”文案（可选，未配置时走 i18n 默认 key） */
     placeNameLabel?: string;
-    /** 选中态左上角“地名”文案 i18n key（可选） */
+    /** 选中态左上角“路网”文案 i18n key（可选） */
     placeNameLabelKey?: string;
-    /** 是否强制始终显示地名层（不受 placeName 开关影响） */
+    /** 是否强制始终显示路网层（不受 placeName 开关影响） */
     forcePlaceName?: boolean;
     thumbnail: string;
     provider: (token: string) => Cesium.ImageryProvider[];

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

@@ -1,6 +1,7 @@
 import { Viewer } from '../../../node_modules/cesium';
 import { DrawEntity } from '../drawHelper';
 import { OverlayEntity } from './types';
+import { OverlayEditOptions } from './OverlayEditHandles';
 import * as Cesium from "cesium";
 export type OverlayEditChangeCallback = (entity: DrawEntity & OverlayEntity) => void;
 export interface OverlayEditControllerOptions {
@@ -9,6 +10,8 @@ export interface OverlayEditControllerOptions {
      * 回调参数为“已回写后的覆盖物 entity”。
      */
     onChange?: OverlayEditChangeCallback;
+    /** 编辑功能配置项，默认为全开（除 rotate） */
+    editCapabilities?: OverlayEditOptions;
 }
 export interface OverlayEditHost {
     getViewer(): Viewer;
@@ -27,6 +30,10 @@ export interface OverlayEditHost {
     applyPolylinePositions(entity: DrawEntity & OverlayEntity, positions: Cesium.Cartesian3[]): void;
     applyPointPosition(entity: DrawEntity & OverlayEntity, position: Cesium.Cartesian3): void;
 }
+/**
+ * 覆盖物编辑控制器类，用于管理地图上覆盖物的编辑操作
+ * 支持多边形、矩形、圆形、折线和点等类型的编辑
+ */
 export declare class OverlayEditController {
     private readonly host;
     private enabled;
@@ -35,6 +42,7 @@ export declare class OverlayEditController {
     private onChange;
     private editingTarget;
     private editingKind;
+    private editingOptions;
     private editingPositions;
     private editingCircleCenter;
     private editingCircleRadiusMeters;
@@ -50,11 +58,35 @@ export declare class OverlayEditController {
     private rotateStartAngle;
     private scaleStartDistance;
     private cameraBackup;
+    /**
+     * 构造函数
+     * @param host 覆盖物编辑宿主对象
+     * @param options 配置选项
+     */
     constructor(host: OverlayEditHost, options?: OverlayEditControllerOptions);
+    /**
+     * 设置编辑变化回调函数
+     * @param cb 回调函数
+     */
     setOnChange(cb?: OverlayEditChangeCallback | null): void;
+    /**
+     * 设置编辑器启用状态
+     * @param enabled 是否启用
+     */
     setEnabled(enabled: boolean): void;
+    /**
+     * 获取编辑器启用状态
+     * @returns 是否启用
+     */
     getEnabled(): boolean;
+    /**
+     * 判断是否正在编辑
+     * @returns 是否正在编辑
+     */
     isEditing(): boolean;
+    /**
+     * 销毁编辑器
+     */
     destroy(): void;
     /** 停止当前正在编辑的覆盖物（不会关闭全局编辑模式） */
     stop(): void;
@@ -62,7 +94,12 @@ export declare class OverlayEditController {
      * 主动开始编辑某个覆盖物。
      * @returns true 表示成功进入编辑
      */
-    start(entityOrId: (DrawEntity & OverlayEntity) | string): boolean;
+    start(entityOrId: (DrawEntity & OverlayEntity) | string, options?: OverlayEditOptions): boolean;
+    /**
+     * 解析编辑目标实体，根据特定条件返回合适的实体对象
+     * @param entity 输入的实体对象，需要同时满足DrawEntity和OverlayEntity类型
+     * @returns 返回解析后的实体对象，可能是原始实体或符合条件的其他实体
+     */
     private resolveEditTarget;
     private detectEditableKind;
     private getPropertyValue;
@@ -96,6 +133,10 @@ export declare class OverlayEditController {
     private lockCameraController;
     private restoreCameraController;
     private clearHandles;
+    /**
+     * 重建处理句柄的方法
+     * 根据当前编辑的几何图形类型，调用相应的构建函数创建处理句柄
+     */
     private rebuildHandles;
     private getHandleHelpers;
     private createHandle;

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

@@ -11,6 +11,44 @@ export type HandleStyle = {
  * 创建编辑句柄实体
  */
 export type CreateHandle = (position: Cesium.Cartesian3, style: HandleStyle, meta: any) => Cesium.Entity;
+export interface OverlayEditOptions {
+    vertex: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    mid: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    move: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    rotate: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    scale: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+}
+export declare const DEFAULT_OPTIONS: OverlayEditOptions;
 /**
  * 构建/更新句柄所需的依赖函数集合
  */
@@ -24,23 +62,23 @@ export interface HandleHelpers {
 /**
  * 构建多边形编辑句柄（顶点/中点/整体移动）
  */
-export declare function buildPolygonHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers): Cesium.Entity[];
+export declare function buildPolygonHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
 /**
  * 构建矩形编辑句柄（顶点/边中点/整体移动）
  */
-export declare function buildRectangleHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers): Cesium.Entity[];
+export declare function buildRectangleHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
 /**
  * 构建折线编辑句柄（顶点/中点/整体移动/旋转/缩放）
  */
-export declare function buildPolylineHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers): Cesium.Entity[];
+export declare function buildPolylineHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
 /**
  * 构建点编辑句柄
  */
-export declare function buildPointHandles(pos: Cesium.Cartesian3 | null, helpers: HandleHelpers): Cesium.Entity[];
+export declare function buildPointHandles(pos: Cesium.Cartesian3 | null, helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
 /**
  * 构建圆形编辑句柄（圆心/半径）
  */
-export declare function buildCircleHandles(center: Cesium.Cartesian3 | null, radiusMeters: number, helpers: HandleHelpers): Cesium.Entity[];
+export declare function buildCircleHandles(center: Cesium.Cartesian3 | null, radiusMeters: number, helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
 /**
  * 更新多边形句柄位置
  * @returns false 表示句柄数量不匹配，需重建

package/dist/libs/toolBar/MapLayersService.d.ts

@@ -35,7 +35,7 @@ export declare class MapLayersService {
     private useI18n;
     constructor(viewer: Viewer, toolbarElement: HTMLElement, config: MapLayersServiceConfig);
     /**
-     * 初始化当前地图上下文：用于“初始底图不是通过 switchMapType 加载”时的地名层识别。
+     * 初始化当前地图上下文：用于“初始底图不是通过 switchMapType 加载”时的路网层识别。
      */
     private bootstrapCurrentMapContext;
     /**

package/dist/package.json

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

package/package.json

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