my-openlayer 0.1.18 → 1.0.0

package/dist/core/ConfigManager.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 配置管理类
+ * 用于统一管理默认配置和验证
+ */
+export declare class ConfigManager {
+    /**
+     * 默认点位配置
+     */
+    static readonly DEFAULT_POINT_OPTIONS: {
+        strokeColor: string;
+        strokeWidth: number;
+        fillColor: string;
+        opacity: number;
+        visible: boolean;
+        layerName: string;
+        zIndex: number;
+    };
+    /**
+     * 默认线配置
+     */
+    static readonly DEFAULT_LINE_OPTIONS: {
+        strokeColor: string;
+        strokeWidth: number;
+        opacity: number;
+        visible: boolean;
+        layerName: string;
+        zIndex: number;
+    };
+    /**
+     * 默认面配置
+     */
+    static readonly DEFAULT_POLYGON_OPTIONS: {
+        strokeColor: string;
+        strokeWidth: number;
+        fillColor: string;
+        opacity: number;
+        visible: boolean;
+        layerName: string;
+        zIndex: number;
+    };
+    /**
+     * 默认图片图层配置
+     */
+    static readonly DEFAULT_IMAGE_OPTIONS: {
+        opacity: number;
+        visible: boolean;
+        layerName: string;
+        zIndex: number;
+    };
+    /**
+     * 默认遮罩图层配置
+     */
+    static readonly DEFAULT_MASK_OPTIONS: {
+        fillColor: string;
+        opacity: number;
+        visible: boolean;
+        layerName: string;
+        zIndex: number;
+    };
+    /**
+     * 默认文本配置
+     */
+    static readonly DEFAULT_TEXT_OPTIONS: {
+        textFont: string;
+        textFillColor: string;
+        textStrokeColor: string;
+        textStrokeWidth: number;
+    };
+    /**
+     * 验证坐标是否有效
+     * @param longitude 经度
+     * @param latitude 纬度
+     * @returns 是否有效
+     */
+    static isValidCoordinate(longitude: number, latitude: number): boolean;
+    /**
+     * 验证颜色字符串是否有效
+     * @param color 颜色字符串
+     * @returns 是否有效
+     */
+    static isValidColor(color: string): boolean;
+    /**
+     * 验证图层名称是否有效
+     * @param layerName 图层名称
+     * @returns 是否有效
+     */
+    static isValidLayerName(layerName: string): boolean;
+    /**
+     * 验证范围是否有效
+     * @param extent 范围数组 [minX, minY, maxX, maxY]
+     * @returns 是否有效
+     */
+    static isValidExtent(extent: number[]): boolean;
+    /**
+     * 合并配置选项
+     * @param defaultOptions 默认配置
+     * @param userOptions 用户配置
+     * @returns 合并后的配置
+     */
+    static mergeOptions<T extends Record<string, any>>(defaultOptions: T, userOptions?: Partial<T>): T;
+    /**
+     * 生成唯一ID
+     * @param prefix 前缀
+     * @returns 唯一ID
+     */
+    static generateId(prefix?: string): string;
+    /**
+     * 深度克隆对象
+     * @param obj 要克隆的对象
+     * @returns 克隆后的对象
+     */
+    static deepClone<T>(obj: T): T;
+}

package/dist/core/ConfigManager.js

@@ -0,0 +1,164 @@
+/**
+ * 配置管理类
+ * 用于统一管理默认配置和验证
+ */
+export class ConfigManager {
+    /**
+     * 验证坐标是否有效
+     * @param longitude 经度
+     * @param latitude 纬度
+     * @returns 是否有效
+     */
+    static isValidCoordinate(longitude, latitude) {
+        return (typeof longitude === 'number' &&
+            typeof latitude === 'number' &&
+            !isNaN(longitude) &&
+            !isNaN(latitude) &&
+            longitude >= -180 &&
+            longitude <= 180 &&
+            latitude >= -90 &&
+            latitude <= 90);
+    }
+    /**
+     * 验证颜色字符串是否有效
+     * @param color 颜色字符串
+     * @returns 是否有效
+     */
+    static isValidColor(color) {
+        if (!color || typeof color !== 'string') {
+            return false;
+        }
+        // 简单的颜色格式验证
+        const colorRegex = /^(#[0-9A-Fa-f]{3,8}|rgba?\([^)]+\)|[a-zA-Z]+)$/;
+        return colorRegex.test(color);
+    }
+    /**
+     * 验证图层名称是否有效
+     * @param layerName 图层名称
+     * @returns 是否有效
+     */
+    static isValidLayerName(layerName) {
+        return (typeof layerName === 'string' &&
+            layerName.length > 0 &&
+            layerName.trim().length > 0);
+    }
+    /**
+     * 验证范围是否有效
+     * @param extent 范围数组 [minX, minY, maxX, maxY]
+     * @returns 是否有效
+     */
+    static isValidExtent(extent) {
+        return (Array.isArray(extent) &&
+            extent.length === 4 &&
+            extent.every(coord => typeof coord === 'number' && !isNaN(coord)) &&
+            extent[0] < extent[2] && // minX < maxX
+            extent[1] < extent[3] // minY < maxY
+        );
+    }
+    /**
+     * 合并配置选项
+     * @param defaultOptions 默认配置
+     * @param userOptions 用户配置
+     * @returns 合并后的配置
+     */
+    static mergeOptions(defaultOptions, userOptions) {
+        return {
+            ...defaultOptions,
+            ...userOptions
+        };
+    }
+    /**
+     * 生成唯一ID
+     * @param prefix 前缀
+     * @returns 唯一ID
+     */
+    static generateId(prefix = 'id') {
+        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * 深度克隆对象
+     * @param obj 要克隆的对象
+     * @returns 克隆后的对象
+     */
+    static deepClone(obj) {
+        if (obj === null || typeof obj !== 'object') {
+            return obj;
+        }
+        if (obj instanceof Date) {
+            return new Date(obj.getTime());
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(item => ConfigManager.deepClone(item));
+        }
+        const cloned = {};
+        for (const key in obj) {
+            if (obj.hasOwnProperty(key)) {
+                cloned[key] = ConfigManager.deepClone(obj[key]);
+            }
+        }
+        return cloned;
+    }
+}
+/**
+ * 默认点位配置
+ */
+ConfigManager.DEFAULT_POINT_OPTIONS = {
+    strokeColor: '#409EFF',
+    strokeWidth: 2,
+    fillColor: 'rgba(64, 158, 255, 0.3)',
+    opacity: 1,
+    visible: true,
+    layerName: 'pointLayer',
+    zIndex: 10
+};
+/**
+ * 默认线配置
+ */
+ConfigManager.DEFAULT_LINE_OPTIONS = {
+    strokeColor: '#409EFF',
+    strokeWidth: 2,
+    opacity: 1,
+    visible: true,
+    layerName: 'lineLayer',
+    zIndex: 10
+};
+/**
+ * 默认面配置
+ */
+ConfigManager.DEFAULT_POLYGON_OPTIONS = {
+    strokeColor: '#EBEEF5',
+    strokeWidth: 2,
+    fillColor: 'rgba(255, 255, 255, 0.3)',
+    opacity: 1,
+    visible: true,
+    layerName: 'polygonLayer',
+    zIndex: 10
+};
+/**
+ * 默认图片图层配置
+ */
+ConfigManager.DEFAULT_IMAGE_OPTIONS = {
+    opacity: 1,
+    visible: true,
+    layerName: 'imageLayer',
+    zIndex: 11
+};
+/**
+ * 默认遮罩图层配置
+ */
+ConfigManager.DEFAULT_MASK_OPTIONS = {
+    fillColor: 'rgba(0, 0, 0, 0.5)',
+    opacity: 1,
+    visible: true,
+    layerName: 'maskLayer',
+    zIndex: 12
+};
+/**
+ * 默认文本配置
+ */
+ConfigManager.DEFAULT_TEXT_OPTIONS = {
+    textFont: '14px Calibri,sans-serif',
+    textFillColor: '#FFF',
+    textStrokeColor: '#409EFF',
+    textStrokeWidth: 2
+};

package/dist/core/DomPoint.d.ts

@@ -1,21 +1,170 @@
-import Map from "ol/Map";
-interface Options {
-    Vue: any;
-    Template: any;
-    lgtd: number;
-    lttd: number;
-    props?: any;
-    type?: string;
-    sttp?: string;
-    zIndex?: number;
-}
+import { Map } from 'ol';
+import Overlay from 'ol/Overlay';
+import { Coordinate } from 'ol/coordinate';
+import { DomPointOptions, DomPointState } from '../types';
+/**
+ * DOM点位管理类
+ * 用于在地图上添加和管理DOM元素覆盖物
+ */
 export default class DomPoint {
-    private map;
+    private readonly map;
+    private readonly errorHandler;
     private app;
     private readonly anchor;
     private readonly dom;
-    constructor(map: Map, options: Options);
+    private readonly id;
+    private readonly options;
+    private state;
+    private position;
+    /**
+     * 构造函数
+     * @param map OpenLayers地图实例
+     * @param options 配置选项
+     * @throws 当参数无效时抛出错误
+     */
+    constructor(map: Map, options: DomPointOptions);
+    /**
+     * 验证构造函数参数
+     * @param map 地图实例
+     * @param options 配置选项
+     * @private
+     */
+    private validateConstructorParams;
+    /**
+     * 合并默认配置选项
+     * @param options 用户配置选项
+     * @returns 合并后的配置选项
+     * @private
+     */
+    private mergeDefaultOptions;
+    /**
+     * 生成唯一ID
+     * @returns 唯一标识符
+     * @private
+     */
+    private generateUniqueId;
+    /**
+     * 创建DOM元素
+     * @returns DOM元素
+     * @private
+     */
+    private createDomElement;
+    /**
+     * 创建Vue应用实例
+     * @private
+     */
+    private createVueApp;
+    /**
+     * 判断是否为Vue 3
+     * @param Vue Vue构造函数
+     * @returns 是否为Vue 3
+     * @private
+     */
+    private isVue3;
+    /**
+     * 创建覆盖层
+     * @returns 覆盖层实例
+     * @private
+     */
+    private createOverlay;
+    /**
+     * 错误处理
+     * @param message 错误消息
+     * @param error 原始错误
+     * @param context 错误上下文
+     * @private
+     */
+    private handleError;
+    /**
+     * 设置可见性
+     * @param visible 是否可见
+     * @throws 当操作失败时抛出错误
+     */
     setVisible(visible: boolean): void;
+    /**
+     * 获取当前可见性状态
+     * @returns 是否可见
+     */
+    isVisible(): boolean;
+    /**
+     * 更新位置
+     * @param longitude 新经度
+     * @param latitude 新纬度
+     * @throws 当操作失败时抛出错误
+     */
+    updatePosition(longitude: number, latitude: number): void;
+    /**
+     * 获取当前位置
+     * @returns 当前坐标位置
+     */
+    getPosition(): Coordinate;
+    /**
+     * 更新组件属性
+     * @param newProps 新的属性对象
+     * @throws 当操作失败时抛出错误
+     */
+    updateProps(newProps: Record<string, any>): void;
+    /**
+     * 设置CSS样式
+     * @param styles 样式对象
+     * @throws 当操作失败时抛出错误
+     */
+    setStyle(styles: Partial<CSSStyleDeclaration>): void;
+    /**
+     * 添加CSS类名
+     * @param className 要添加的类名
+     * @throws 当操作失败时抛出错误
+     */
+    addClass(className: string): void;
+    /**
+     * 移除CSS类名
+     * @param className 要移除的类名
+     * @throws 当操作失败时抛出错误
+     */
+    removeClass(className: string): void;
+    /**
+     * 销毁Vue应用实例
+     * @private
+     */
+    private destroyVueApp;
+    /**
+     * 移除点位
+     * @throws 当移除失败时抛出错误
+     */
     remove(): void;
+    /**
+     * 获取覆盖层
+     * @returns 覆盖层实例
+     */
+    getOverlay(): Overlay;
+    /**
+     * 获取点位ID
+     * @returns 点位唯一标识符
+     */
+    getId(): string;
+    /**
+     * 获取DOM元素
+     * @returns DOM元素
+     */
+    getDomElement(): HTMLElement;
+    /**
+     * 获取当前状态
+     * @returns 当前状态
+     */
+    getState(): DomPointState;
+    /**
+     * 获取配置选项
+     * @returns 配置选项的副本
+     */
+    getOptions(): Readonly<DomPointOptions>;
+    /**
+     * 检查是否已销毁
+     * @returns 是否已销毁
+     */
+    isDestroyed(): boolean;
+    /**
+     * 获取地图实例
+     * @returns 地图实例
+     */
+    getMap(): Map;
 }
-export {};