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

package/dist/utils/calc.d.ts

@@ -0,0 +1,50 @@
+import { Cartesian3, Ellipsoid, Rectangle } from '../../node_modules/cesium';
+/**
+ * 判断一个 Cartesian3 是否为有效坐标（x/y/z 都是有限数字）
+ */
+export declare function isValidCartesian3(pos: Cartesian3 | null | undefined): pos is Cartesian3;
+/**
+ * 格式化距离显示
+ * 超过1000m时转换为km，保留两位小数
+ * @param distance 距离（米）
+ * @returns 格式化后的距离字符串
+ */
+export declare function formatDistance(distance: number): string;
+/**
+ * 格式化面积显示
+ * @param areaKm2 面积（平方公里）
+ * @returns 格式化后的面积字符串
+ */
+export declare function formatArea(areaKm2: number): string;
+/**
+ * 计算矩形
+ * @param p1 第一个点
+ * @param p2 第二个点
+ * @returns 矩形对象
+ */
+export declare function calculateRectangle(p1: Cartesian3, p2: Cartesian3): Rectangle;
+/**
+ * 计算矩形面积
+ * @param rect 矩形对象
+ * @returns 面积（平方公里）
+ */
+export declare function calculateRectangleArea(rect: Rectangle): number;
+/**
+ * 计算多边形面积
+ * @param positions 多边形顶点坐标数组
+ * @param ellipsoid 椭球体对象（默认使用 WGS84）
+ * @returns 面积（平方公里）
+ */
+export declare function calculatePolygonArea(positions: Cartesian3[], ellipsoid?: Ellipsoid): number;
+/**
+ * 计算多边形中心点
+ * @param positions 多边形顶点坐标数组
+ * @returns 中心点坐标
+ */
+export declare function calculatePolygonCenter(positions: Cartesian3[]): Cartesian3;
+/**
+ * 计算折线总长度
+ * @param positions 折线顶点坐标数组
+ * @returns 总长度（米）
+ */
+export declare function calculatePolylineDistance(positions: Cartesian3[]): number;

package/dist/utils/common.d.ts

@@ -0,0 +1,15 @@
+export declare function getViteTdToken(): any;
+export declare function getViteTdSk(): any;
+export declare function getViteCesiumToken(): any;
+/**
+ * 将相机高度转换为地图层级
+ * @param height 相机高度（米）
+ * @returns 地图层级（1-18）
+ */
+export declare function heightToZoomLevel(height: number): number;
+/**
+ * 将地图层级转换为相机高度
+ * @param zoomLevel 地图层级（1-18）
+ * @returns 相机高度（米）
+ */
+export declare function zoomLevelToHeight(zoomLevel: number): number;

package/dist/utils/geojson.d.ts

@@ -0,0 +1,86 @@
+/**
+ * GeoJSON 类型定义
+ */
+export interface GeoJSONPoint {
+    type: 'Point';
+    coordinates: [number, number];
+}
+export interface GeoJSONPolygon {
+    type: 'Polygon';
+    coordinates: number[][][];
+}
+export interface GeoJSONFeature<T = GeoJSONPolygon> {
+    type: 'Feature';
+    geometry: T;
+    properties?: Record<string, any>;
+}
+export interface GeoJSONFeatureCollection<T = GeoJSONPolygon> {
+    type: 'FeatureCollection';
+    features: GeoJSONFeature<T>[];
+    name?: string;
+}
+/**
+ * 机场禁飞区数据接口
+ */
+export interface AirportNoFlyZone {
+    name: string;
+    feature: GeoJSONFeature<GeoJSONPolygon>;
+    fileName: string;
+}
+/**
+ * GeoJSON 加载配置
+ */
+export interface GeoJSONLoaderConfig {
+    /**
+     * GeoJSON 文件的基础路径
+     * 开发环境: '/geojson' (指向 public/geojson)
+     * 生产环境: 可以是 '/geojson' 或用户自定义路径
+     * @default '/geojson'
+     */
+    basePath?: string;
+    /**
+     * 是否在加载失败时静默处理（不抛出错误）
+     * @default false
+     */
+    silent?: boolean;
+}
+/**
+ * 读取所有机场禁飞区 GeoJSON 文件
+ *
+ * 注意：由于无法直接获取目录文件列表，需要提供文件列表
+ * 可以通过以下方式之一：
+ * 1. 提供 fileList 参数
+ * 2. 在 public/geojson 目录下放置 file-list.json 文件
+ * 3. 使用 getAllAirportNoFlyZonesWithList 方法
+ *
+ * @param fileList 可选的文件名列表（不含扩展名）
+ * @param config 加载配置
+ * @returns Promise<AirportNoFlyZone[]> 机场禁飞区数据数组
+ */
+export declare function loadAllAirportNoFlyZones(fileList?: string[], config?: GeoJSONLoaderConfig): Promise<AirportNoFlyZone[]>;
+/**
+ * 读取单个机场禁飞区 GeoJSON 文件
+ * @param fileName 文件名（不含扩展名，如 '珠海_金湾机场'）
+ * @param config 加载配置
+ * @returns Promise<AirportNoFlyZone | null> 机场禁飞区数据或 null
+ */
+export declare function loadAirportNoFlyZone(fileName: string, config?: GeoJSONLoaderConfig): Promise<AirportNoFlyZone | null>;
+/**
+ * 将 GeoJSON 坐标转换为 Cesium Cartesian3 数组
+ * @param coordinates GeoJSON 多边形坐标数组
+ * @param height 高度偏移（米），默认为 0
+ * @returns 包含 longitude, latitude, height 的对象数组
+ */
+export declare function geojsonCoordinatesToCartesian3(coordinates: number[][], height?: number): Array<{
+    longitude: number;
+    latitude: number;
+    height: number;
+}>;
+/**
+ * 从文件名列表生成 file-list.json
+ * 这个函数可以在构建时使用，生成文件列表
+ *
+ * @param fileNames 文件名列表（不含扩展名）
+ * @returns JSON 字符串
+ */
+export declare function generateFileListJson(fileNames: string[]): string;

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/dist/utils/selfIntersection.d.ts

@@ -0,0 +1,15 @@
+import { Cartesian3 } from '../../node_modules/cesium';
+export type IntersectionKind = "none" | "touch" | "cross" | "overlap";
+/**
+ * Returns true if adding `nextPoint` to an open polygon polyline would create a self-intersection.
+ */
+export declare function wouldCreatePolygonSelfIntersection(existingPoints: Cartesian3[], nextPoint: Cartesian3, opts?: {
+    allowTouch?: boolean;
+}): boolean;
+export declare function wouldCreatePolygonSelfIntersectionKind(existingPoints: Cartesian3[], nextPoint: Cartesian3): IntersectionKind;
+/**
+ * Returns true if the closed polygon described by `points` is self-intersecting.
+ */
+export declare function isClosedPolygonSelfIntersecting(points: Cartesian3[], opts?: {
+    allowTouch?: boolean;
+}): boolean;

package/dist/z.const.d.ts

@@ -0,0 +1,24 @@
+export declare const defaultHeatmapData: ({
+    lon: string;
+    lat: string;
+    height: string;
+    appearTime: number;
+    lng?: undefined;
+} | {
+    lng: string;
+    lat: string;
+    height: string;
+    appearTime: number;
+    lon?: undefined;
+})[][];
+export declare const defaultHeatmapColors: {
+    0: string;
+    40: string;
+    60: string;
+    90: string;
+    110: string;
+};
+export declare const defaultHeatmapOpacity: {
+    0: number;
+    0.5: number;
+};

package/package.json

@@ -1,46 +1,74 @@
-{
-  "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.7-alpha.1",
-  "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
-  "type": "module",
-  "main": "index.es.js",
-  "module": "index.es.js",
-  "types": "index.d.ts",
-  "files": [
-    "index.es.js",
-    "index.umd.js",
-    "index.d.ts",
-    "style.css",
-    "README.md",
-    "geojson"
-  ],
-  "exports": {
-    ".": {
-      "import": "./index.es.js",
-      "default": "./index.es.js"
-    },
-    "./style": "./style.css"
-  },
-  "peerDependencies": {
-    "vue": "^3.0.0"
-  },
-  "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"
+}