@xingm/vmap-cesium-toolbar 0.0.7-alpha.0 → 0.0.7-alpha.2

package/dist/libs/CesiumMapLoader.d.ts

@@ -48,6 +48,9 @@ interface InitOptions {
     requestRenderMode?: boolean;
     maximumRenderTimeChange?: number;
     token?: string;
+    TD_Token?: string;
+    sk?: string;
+    TD_SK?: string;
     cesiumToken?: string;
     success?: () => void;
     cancel?: () => void;

package/dist/libs/CesiumMapMark.d.ts

@@ -0,0 +1,202 @@
+import { CesiumOverlayService } from './CesiumOverlayService';
+import { default as DrawHelper } from './CesiumMapDraw';
+import { DrawOptions } from './drawHelper/BaseDraw';
+import { LngLatPosition } from '../utils/overlayUtils';
+import * as Cesium from "cesium";
+export type CesiumMapDrawType = "point" | "polyline" | "polygon" | "rectangle" | "circle";
+export type CesiumMapWorkAreaType = "polygon" | "circle" | "rectangle";
+export type CesiumMapWorkAreaKind = "work" | "noFly";
+export interface CesiumMapMarkToolbarPosition {
+    left?: number | string;
+    right?: number | string;
+    top?: number | string;
+    bottom?: number | string;
+}
+export interface CesiumMapDrawResult {
+    drawType: CesiumMapDrawType;
+    positions: LngLatPosition[];
+    cartesian3Positions: Cesium.Cartesian3[];
+    position?: LngLatPosition;
+    entity: Cesium.Entity | null;
+    length?: number;
+    area?: number;
+    radius?: number;
+    color?: string;
+}
+export interface CesiumMapWorkAreaDrawResult extends Omit<CesiumMapDrawResult, "drawType"> {
+    drawType: CesiumMapWorkAreaType;
+    areaType: CesiumMapWorkAreaKind;
+}
+export interface CesiumMapMarkOptions extends DrawOptions {
+    pointWidth?: number;
+    pointHeight?: number;
+    continuous?: boolean;
+    showPolylineLengthLabel?: boolean;
+    showToolbar?: boolean;
+    toolbarClassName?: string;
+    toolbarPosition?: CesiumMapMarkToolbarPosition;
+    buttonSize?: number;
+    buttonSpacing?: number;
+    zIndex?: number;
+    defaultColor?: string;
+    colors?: Partial<Record<CesiumMapDrawType, string>>;
+    overlayServiceOptions?: ConstructorParameters<typeof CesiumOverlayService>[1];
+    buttons?: CesiumMapMarkButtonConfig[];
+}
+export interface CesiumMapMarkCallbacks {
+    onDrawStart?: (drawType: CesiumMapDrawType) => void;
+    onDrawEnd?: (result: CesiumMapDrawResult) => void;
+    onWorkAreaDrawEnd?: (result: CesiumMapWorkAreaDrawResult) => void;
+    onClear?: () => void;
+    onDelete?: (entity: Cesium.Entity) => void;
+    onEditChange?: (entity: Cesium.Entity) => void;
+    onEditEnd?: (result: CesiumMapDrawResult) => void;
+    onColorChange?: (color: string, drawType?: CesiumMapDrawType) => void;
+    onError?: (error: Error) => void;
+}
+export interface CesiumMapMarkExportItem {
+    id?: string;
+    drawType: CesiumMapDrawType;
+    positions: LngLatPosition[];
+    position?: LngLatPosition;
+    length?: number;
+    area?: number;
+    radius?: number;
+    color?: string;
+    entity: Cesium.Entity;
+}
+export interface CesiumMapMarkButtonConfig {
+    id: CesiumMapDrawType;
+    title?: string;
+    text?: string;
+    icon?: string | HTMLElement | false;
+    color?: string;
+    borderColor?: string;
+    backgroundColor?: string;
+    activeBackgroundColor?: string;
+    callback?: (mark: CesiumMapMark, drawType: CesiumMapDrawType) => void;
+}
+export declare class CesiumMapMark {
+    private viewer;
+    private map?;
+    private container?;
+    private options;
+    private callbacks;
+    private drawHelper;
+    private overlayService;
+    private pointHandler;
+    private editClickHandler;
+    private editModeEnabled;
+    private editOptions?;
+    private originalRequestRenderMode;
+    private currentEditingEntity;
+    private lastEditedEntity;
+    private pointEditDragging;
+    private pointEditDraggingEntity;
+    private pointEditMarkerEntity;
+    private pointEditCameraBackup;
+    private activeTool;
+    private workAreaMode;
+    private workAreaType;
+    private workAreaKind;
+    private readonly entityTypeMap;
+    private readonly pointEntities;
+    private readonly toolColors;
+    private toolbarElement;
+    private readonly toolbarButtons;
+    private colorPanelElement;
+    private hoveredColorTool;
+    private colorPanelCloseTimer;
+    constructor(viewer: Cesium.Viewer, container?: HTMLElement, options?: CesiumMapMarkOptions, callbacks?: CesiumMapMarkCallbacks, map?: unknown);
+    constructor(viewer: Cesium.Viewer, map?: unknown, container?: HTMLElement, options?: CesiumMapMarkOptions, callbacks?: CesiumMapMarkCallbacks);
+    getViewer(): Cesium.Viewer;
+    getMap(): unknown;
+    getContainer(): HTMLElement | undefined;
+    getDrawHelper(): DrawHelper;
+    getOverlayService(): CesiumOverlayService;
+    getActiveTool(): CesiumMapDrawType | null;
+    getToolbarElement(): HTMLElement | null;
+    setCallbacks(callbacks: CesiumMapMarkCallbacks): void;
+    updateCallbacks(callbacks: Partial<CesiumMapMarkCallbacks>): void;
+    updateOptions(options: Partial<CesiumMapMarkOptions>): void;
+    startDrawTool(drawType: CesiumMapDrawType, options?: DrawOptions): void;
+    startDrawing(drawType: CesiumMapDrawType, options?: DrawOptions): void;
+    drawPoint(options?: DrawOptions): void;
+    drawPolyline(options?: DrawOptions): void;
+    drawPolygon(options?: DrawOptions): void;
+    drawRectangle(options?: DrawOptions): void;
+    drawCircle(options?: DrawOptions): void;
+    startWorkAreaDraw(drawType: CesiumMapWorkAreaType, areaType?: CesiumMapWorkAreaKind, options?: DrawOptions): void;
+    stopDraw(): void;
+    cancelDrawing(): void;
+    clearAll(): void;
+    deleteEntity(entity: Cesium.Entity | null | undefined): void;
+    removeEntity(entity: Cesium.Entity | null | undefined): void;
+    setColor(drawType: CesiumMapDrawType, color: string): void;
+    getColor(drawType: CesiumMapDrawType): string;
+    enableEdit(options?: Parameters<CesiumOverlayService["setOverlayEditMode"]>[1]): void;
+    disableEdit(): CesiumMapDrawResult | null;
+    startEdit(entityOrId: Cesium.Entity | string, options?: Parameters<CesiumOverlayService["startOverlayEdit"]>[1]): boolean;
+    stopEdit(): CesiumMapDrawResult | null;
+    getEntities(): Cesium.Entity[];
+    exportData(): CesiumMapMarkExportItem[];
+    handleSceneModeChanged(): void;
+    destroy(): void;
+    private setupDrawHelperCallbacks;
+    private startDrawHelper;
+    private createToolbar;
+    private rebuildToolbar;
+    private destroyToolbar;
+    private resolveButtonConfigs;
+    private createToolbarButton;
+    private formatCssPixel;
+    private applyToolbarStyle;
+    private applyButtonStyle;
+    private applyButtonContentColor;
+    private showColorPanel;
+    private renderColorPanel;
+    private applyColorPanelStyle;
+    private applyColorItemStyle;
+    private positionColorPanel;
+    private scheduleColorPanelClose;
+    private clearColorPanelCloseTimer;
+    private destroyColorPanel;
+    private updateToolbarActiveState;
+    private createEditableOverlayEntity;
+    private removeOriginalDrawEntity;
+    private startPointDrawing;
+    private installEditClickHandler;
+    private destroyEditClickHandler;
+    private showPointEditMarker;
+    private updatePointEditMarkerPosition;
+    private removePointEditMarker;
+    private pickPointEditEntity;
+    private isPointEditHit;
+    private getScreenDistance;
+    private pickPointEditPosition;
+    private pickDrawEntity;
+    private resolvePickedEntity;
+    private enableContinuousRenderForEdit;
+    private restoreRequestRenderModeAfterEdit;
+    private lockCameraForPointEdit;
+    private restoreCameraAfterPointEdit;
+    private emitEditEnd;
+    private buildDrawOptions;
+    private createWorkAreaOptions;
+    private buildDrawResult;
+    private buildWorkAreaDrawResult;
+    private getLngLatPositions;
+    private getCartesian3Positions;
+    private getRectangleLngLatPositions;
+    private calculateCartesianLength;
+    private resolveEntityDrawType;
+    private pickPosition;
+    private trackEntity;
+    private applyCircleStroke;
+    private resolveCesiumColor;
+    private normalizeColorKey;
+    private createInitialColors;
+    private normalizeConstructorArgs;
+    private emitError;
+}
+export default CesiumMapMark;

package/dist/libs/CesiumMapModel.d.ts

@@ -14,6 +14,14 @@ export interface ToolbarConfig {
     buttons?: CustomButtonConfig[];
     useI18n?: boolean;
     i18n?: I18nLike;
+    /** 天地图 token（工具栏默认搜索、图层切换使用） */
+    TD_Token?: string;
+    /** 天地图 sk（工具栏默认搜索、图层切换使用） */
+    TD_SK?: string;
+    /** 天地图 token 别名 */
+    token?: string;
+    /** 天地图 sk 别名 */
+    sk?: string;
 }
 export interface ButtonConfig {
     sort?: number;
@@ -87,9 +95,9 @@ export interface MapType {
     /** 是否强制始终显示路网层（不受 placeName 开关影响） */
     forcePlaceName?: boolean;
     thumbnail: string;
-    provider: (token: string) => Cesium.ImageryProvider[];
-    terrainProvider?: (token: string) => Cesium.TerrainProvider | null;
-    geoWTFS?: (token: string, viewer: Cesium.Viewer) => any | null;
+    provider: (token: string, sk?: string) => Cesium.ImageryProvider[];
+    terrainProvider?: (token: string, sk?: string) => Cesium.TerrainProvider | null;
+    geoWTFS?: (token: string, viewer: Cesium.Viewer, sk?: string) => any | null;
 }
 export interface MapToolsConfig {
     containerId: string;

package/dist/libs/CesiumMapToolbar.d.ts

@@ -25,6 +25,7 @@ export declare class CesiumMapToolbar {
     private initialCenter?;
     private currentMapType;
     TD_Token: string;
+    TD_SK: string;
     mapTypes: MapType[];
     private isNoFlyZoneChecked;
     private currentGeoWTFS;
@@ -77,6 +78,17 @@ export declare class CesiumMapToolbar {
      * @param TD_Token
      */
     setTDToken(TD_Token: string): void;
+    /**
+     * 设置天地图 sk
+     * @param TD_SK
+     */
+    setTDSK(TD_SK: string): void;
+    /**
+     * 设置天地图认证参数
+     * @param TD_Token
+     * @param TD_SK
+     */
+    setTDTAuth(TD_Token: string, TD_SK?: string): void;
     /**
      * 设置初始中心点
      */

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

@@ -13,6 +13,8 @@ interface CesiumMapControllerOptions {
     getCurrentMapTypeId?: () => string;
     /** 获取当前天地图 token（用于从 provider 读取 maximumLevel 时保持行为一致） */
     getToken?: () => string;
+    /** 获取当前天地图 sk（用于从 provider 读取 maximumLevel 时保持行为一致） */
+    getSk?: () => string | undefined;
     /** 缩放回调（来自 Toolbar 的 ZoomCallback） */
     zoomCallback?: ZoomCallback;
     /** 场景模式切换后回调（例如通知 DrawHelper 重新计算偏移） */
@@ -32,6 +34,7 @@ export declare class CesiumMapController {
     private getMapTypes?;
     private getCurrentMapTypeId?;
     private getToken?;
+    private getSk?;
     private zoomCallback?;
     private onSceneModeChanged?;
     private fullscreenCallback?;

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

@@ -8,6 +8,7 @@ export interface MapLayersServiceConfig {
     mapTypes: MapType[];
     currentMapType: string;
     token: string;
+    sk?: string;
     isNoFlyZoneChecked: boolean;
     isNoFlyZoneVisible: boolean;
     i18n?: I18nLike;

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

@@ -12,9 +12,13 @@ export declare class SearchService {
     private searchContainer;
     private i18n;
     private useI18n;
+    private getToken?;
+    private getSk?;
     constructor(viewer: Viewer, toolbarElement: HTMLElement, searchCallback?: SearchCallback, options?: {
         i18n?: I18nLike;
         useI18n?: boolean;
+        getToken?: () => string | undefined;
+        getSk?: () => string | undefined;
     });
     /**
      * 设置搜索回调

package/dist/package.json

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

package/dist/tdt/tdtAuth.d.ts

@@ -0,0 +1 @@
+export declare const buildTDTAuthParams: (token: string, sk?: string, includeSk?: boolean) => string;

package/dist/utils/common.d.ts

@@ -1,4 +1,5 @@
 export declare function getViteTdToken(): any;
+export declare function getViteTdSk(): any;
 export declare function getViteCesiumToken(): any;
 /**
  * 将相机高度转换为地图层级

package/dist/utils/overlayUtils.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 覆盖物工具函数
+ * 整合绘制工具相关的公共方法
+ */
+import * as Cesium from 'cesium';
+/**
+ * 将多边形顶点沿中心方向外扩指定距离
+ * @param positions - 原始多边形顶点经纬度数组 [lng, lat, height][]
+ * @param expandDistanceMeters - 外扩距离（米）
+ * @returns 外扩后的多边形顶点经纬度数组 [lng, lat, height][]
+ */
+export declare const expandPolygon: (positions: [number, number, number][], expandDistanceMeters: number) => [number, number, number][];
+export type DrawType = 'point' | 'polyline' | 'polygon' | 'rectangle' | 'circle';
+export declare const OVERLAY_PRESET_COLORS: readonly [{
+    readonly value: "blue";
+    readonly label: "蓝色";
+    readonly hex: "#007BFF";
+}, {
+    readonly value: "orange";
+    readonly label: "橙色";
+    readonly hex: "#FF6932";
+}, {
+    readonly value: "yellow";
+    readonly label: "黄色";
+    readonly hex: "#FFB700";
+}, {
+    readonly value: "cyan";
+    readonly label: "青色";
+    readonly hex: "#13FFFF";
+}, {
+    readonly value: "purple";
+    readonly label: "紫色";
+    readonly hex: "#ED64FF";
+}];
+export declare const OVERLAY_COLOR_HEX_LIST: ("#007BFF" | "#FF6932" | "#FFB700" | "#13FFFF" | "#ED64FF")[];
+export interface LngLatPosition {
+    lng: number;
+    lat: number;
+}
+export interface CesiumPosition {
+    longitude: number;
+    latitude: number;
+    height?: number;
+}
+/**
+ * 颜色转Cesium颜色
+ */
+export declare const hexToCesiumColor: (hex: string, alpha?: number) => Cesium.Color;
+/**
+ * 获取默认颜色
+ */
+export declare const getDefaultColor: () => string;
+/**
+ * 根据颜色获取Cesium颜色（带透明度）
+ */
+export declare const getColorWithAlpha: (color: string, alpha?: number) => Cesium.Color;
+/**
+ * 将 Cartesian3 转换为经纬度
+ */
+export declare const cartesian3ToLngLat: (position: Cesium.Cartesian3) => LngLatPosition;
+/**
+ * 将经纬度转换为 Cartesian3
+ */
+export declare const lngLatToCartesian3: (lng: number, lat: number, height?: number) => Cesium.Cartesian3;
+/**
+ * 将 { lng, lat }[] 转换为 [lng, lat, height][]
+ */
+export declare const lngLatArrayToCesiumPositions: (positions: LngLatPosition[], height?: number) => [number, number, number][];
+/**
+ * 将 [lng, lat, height][] 转换为 { lng, lat }[]
+ */
+export declare const cesiumPositionsToLngLatArray: (positions: [number, number, number][]) => LngLatPosition[];
+/**
+ * 计算两点之间的距离（米）- 使用大圆距离公式
+ */
+export declare const calculateDistanceByLngLat: (p1: LngLatPosition, p2: LngLatPosition) => number;
+/**
+ * 计算线段总长度（米）
+ */
+export declare const calculatePolylineLength: (positions: LngLatPosition[]) => number;
+/**
+ * 计算多边形面积（使用球面面积计算）
+ */
+export declare const calculatePolygonArea: (positions: LngLatPosition[]) => number;
+/**
+ * 计算圆的面积
+ */
+export declare const calculateCircleArea: (radius: number) => number;
+/**
+ * 计算几何中心点
+ */
+export declare const calculateCenter: (positions: LngLatPosition[]) => LngLatPosition | null;
+/**
+ * 计算两个位置的中心点
+ */
+export declare const calculateTwoPointsCenter: (p1: LngLatPosition, p2: LngLatPosition) => LngLatPosition;
+/**
+ * 格式化面积显示
+ */
+export declare const formatArea: (area: number) => string;
+/**
+ * 格式化长度显示
+ */
+export declare const formatLength: (length: number) => string;
+/**
+ * 格式化经纬度显示
+ */
+export declare const formatLngLat: (position: LngLatPosition) => string;
+/**
+ * 获取绘制类型的默认名称
+ */
+export declare const getDefaultNameByType: (type: DrawType) => string;
+/**
+ * 获取绘制类型的提示文本
+ */
+export declare const getDrawHintByType: (type: DrawType) => string;
+/**
+ * 获取动态标签（根据绘制类型）
+ */
+export declare const getDynamicLabelByType: (type: DrawType) => string;
+/**
+ * 获取类型对应的图标URL
+ * 需要在组件中动态导入
+ */
+export declare const getTypeIconUrl: (type: DrawType) => string;
+/**
+ * 验证经纬度坐标是否有效
+ */
+export declare const isValidLngLat: (position: LngLatPosition) => boolean;
+/**
+ * 从Cesium实体获取位置数据
+ */
+export declare const getEntityPositions: (entity: Cesium.Entity, type: DrawType) => LngLatPosition[];
+/**
+ * 从Cesium实体获取Cartesian3位置数组
+ */
+export declare const getEntityCartesian3Positions: (entity: Cesium.Entity, type: DrawType) => Cesium.Cartesian3[];
+/**
+ * 获取圆的半径（米）
+ */
+export declare const getCircleRadius: (entity: Cesium.Entity) => number | null;
+/**
+ * 解析geometry字符串为对象
+ */
+export declare const parseGeometry: (geometry: any) => any;
+/**
+ * 生成GUID
+ */
+export declare const generateGuid: () => string;

package/package.json

@@ -1,74 +1,74 @@
-{
-  "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.7-alpha.0",
-  "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
-  "type": "module",
-  "main": "dist/index.es.js",
-  "module": "dist/index.es.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.es.js",
-      "default": "./dist/index.es.js"
-    },
-    "./style": "./dist/style.css"
-  },
-  "scripts": {
-    "dev": "vite --force",
-    "build": "vite build --mode lib",
-    "dist": "vite build",
-    "build:dts": "vue-tsc -p tsconfig.dts.json",
-    "build:plugin": "node scripts/build-plugin.js",
-    "docs:dev": "vitepress dev doc",
-    "docs:build": "vitepress build doc",
-    "docs:preview": "vitepress preview doc",
-    "generate:file-list": "node scripts/generate-file-list.js",
-    "preview": "vite preview",
-    "type-check": "vue-tsc --noEmit"
-  },
-  "peerDependencies": {
-    "vue": "^3.0.0"
-  },
-  "dependencies": {
-    "cesium": "^1.134.1",
-    "tdt-terrain-cesium-plugin": "^1.0.4",
-    "vue": "^3.5.18"
-  },
-  "devDependencies": {
-    "@types/cesium": "^1.70.4",
-    "@vitejs/plugin-vue": "^6.0.1",
-    "rollup-plugin-dts": "^6.1.0",
-    "vite": "^7.1.2",
-    "vite-plugin-cesium": "^1.2.23",
-    "vite-plugin-dts": "^4.5.4",
-    "vite-plugin-static-copy": "^3.1.2",
-    "vitepress": "^1.6.4",
-    "vue-tsc": "^3.0.5"
-  },
-  "keywords": [
-    "cesium",
-    "map",
-    "toolbar",
-    "drawing",
-    "measurement",
-    "vue3",
-    "typescript"
-  ],
-  "author": "pengxueyou",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/BenXueYou/vmap-cesium-tool.git"
-  },
-  "bugs": {
-    "url": "https://github.com/BenXueYou/vmap-cesium-tool/issues"
-  },
-  "homepage": "https://github.com/BenXueYou/vmap-cesium-tool#readme"
-}
+{
+  "name": "@xingm/vmap-cesium-toolbar",
+  "version": "0.0.7-alpha.2",
+  "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
+  "type": "module",
+  "main": "dist/index.es.js",
+  "module": "dist/index.es.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.es.js",
+      "default": "./dist/index.es.js"
+    },
+    "./style": "./dist/style.css"
+  },
+  "scripts": {
+    "dev": "vite --force",
+    "build": "vite build --mode lib",
+    "dist": "vite build",
+    "build:dts": "vue-tsc -p tsconfig.dts.json",
+    "build:plugin": "node scripts/build-plugin.js",
+    "docs:dev": "vitepress dev doc",
+    "docs:build": "vitepress build doc",
+    "docs:preview": "vitepress preview doc",
+    "generate:file-list": "node scripts/generate-file-list.js",
+    "preview": "vite preview",
+    "type-check": "vue-tsc --noEmit"
+  },
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
+  "dependencies": {
+    "cesium": "^1.134.1",
+    "tdt-terrain-cesium-plugin": "^1.0.4",
+    "vue": "^3.5.18"
+  },
+  "devDependencies": {
+    "@types/cesium": "^1.70.4",
+    "@vitejs/plugin-vue": "^6.0.1",
+    "rollup-plugin-dts": "^6.1.0",
+    "vite": "^7.1.2",
+    "vite-plugin-cesium": "^1.2.23",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-static-copy": "^3.1.2",
+    "vitepress": "^1.6.4",
+    "vue-tsc": "^3.0.5"
+  },
+  "keywords": [
+    "cesium",
+    "map",
+    "toolbar",
+    "drawing",
+    "measurement",
+    "vue3",
+    "typescript"
+  ],
+  "author": "pengxueyou",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BenXueYou/vmap-cesium-tool.git"
+  },
+  "bugs": {
+    "url": "https://github.com/BenXueYou/vmap-cesium-tool/issues"
+  },
+  "homepage": "https://github.com/BenXueYou/vmap-cesium-tool#readme"
+}