my-openlayer 0.1.18 → 1.0.1

package/dist/types.d.ts

@@ -49,48 +49,234 @@ export interface AnnotationLayerOptions {
     visible?: boolean;
 }
 export interface HeatMapOptions {
+    layerName?: string;
     radius?: number;
     blur?: number;
     gradient?: string[];
     opacity?: number;
     visible?: boolean;
     zIndex?: number;
-    valueKey: string;
+    valueKey?: string;
 }
-export interface OptionsType {
+/**
+ * 基础选项接口 - 所有图层的公共配置
+ */
+export interface BaseOptions {
+    /** 图层名称 */
     layerName?: string;
-    nameKey?: string;
-    img?: string;
-    scale?: number;
-    hasImg?: boolean;
+    /** 图层层级 */
     zIndex?: number;
+    /** 图层可见性 */
     visible?: boolean;
+    /** 图层透明度 */
+    opacity?: number;
+    /** 是否适应视图 */
+    fitView?: boolean;
+    /** 地图裁剪 */
+    mapClip?: boolean;
+    /** 地图裁剪数据 */
+    mapClipData?: MapJSONData;
+    /** 投影选项 */
     projectionOptOptions?: any;
+    /** 扩展属性 */
+    [propName: string]: any;
+}
+/**
+ * 样式选项接口 - 图形样式相关配置
+ */
+export interface StyleOptions {
+    /** 描边颜色 */
     strokeColor?: string | number[];
+    /** 描边宽度 */
     strokeWidth?: number;
+    /** 线条虚线样式 */
     lineDash?: number[];
+    /** 线条虚线偏移 */
     lineDashOffset?: number;
+    /** 填充颜色 */
     fillColor?: string;
+    /** 填充颜色回调函数 */
     fillColorCallBack?: (feature: any) => string;
+}
+/**
+ * 文本选项接口 - 文本标注相关配置
+ */
+export interface TextOptions {
+    /** 文本可见性 */
     textVisible?: boolean;
+    /** 文本内容回调函数 */
     textCallBack?: (feature: any) => string;
+    /** 文本字体 */
     textFont?: string;
+    /** 文本填充颜色 */
     textFillColor?: string;
+    /** 文本描边颜色 */
     textStrokeColor?: string;
+    /** 文本描边宽度 */
     textStrokeWidth?: number;
+    /** 文本Y轴偏移 */
     textOffsetY?: number;
-    fitView?: boolean;
-    opacity?: number;
-    mapClip?: boolean;
-    mapClipData?: MapJSONData;
+}
+/**
+ * 点位选项接口 - 点位图层专用配置
+ */
+export interface PointOptions extends BaseOptions, StyleOptions, TextOptions {
+    /** 名称字段键 */
+    nameKey?: string;
+    /** 图标图片 */
+    img?: string;
+    /** 图标缩放比例 */
+    scale?: number;
+    /** 是否有图标 */
+    hasImg?: boolean;
+    /** 图标颜色 */
+    iconColor?: string;
+}
+/**
+ * 线条选项接口 - 线条图层专用配置
+ */
+export interface LineOptions extends BaseOptions, StyleOptions, TextOptions {
+    /** 线条类型 */
+    type?: string;
+}
+/**
+ * 多边形选项接口 - 多边形图层专用配置
+ */
+export interface PolygonOptions extends BaseOptions, StyleOptions, TextOptions {
+    /** 名称字段键 */
+    nameKey?: string;
+    /** 是否为蒙版 */
     mask?: boolean;
+}
+/**
+ * 兼容性类型别名 - 保持向后兼容
+ * @deprecated 请使用具体的选项接口：PointOptions, LineOptions, PolygonOptions
+ */
+export type OptionsType = BaseOptions & StyleOptions & TextOptions & {
+    nameKey?: string;
+    img?: string;
+    scale?: number;
+    hasImg?: boolean;
     iconColor?: string;
-    [propName: string]: any;
+    type?: string;
+    mask?: boolean;
+};
+/**
+ * 图片图层数据接口
+ */
+export interface ImageLayerData {
+    img: string;
+    extent: number[];
+}
+/**
+ * 蒙版图层配置接口
+ */
+export interface MaskLayerOptions {
+    extent?: any;
+    fillColor?: string;
+    strokeWidth?: number;
+    strokeColor?: string;
+    zIndex?: number;
+    opacity?: number;
+    visible?: boolean;
+    layerName?: string;
+}
+/**
+ * 颜色映射接口
+ */
+export interface ColorMap {
+    [level: string]: string;
+}
+/**
+ * 要素颜色更新选项接口
+ */
+export interface FeatureColorUpdateOptions extends BaseOptions, StyleOptions, TextOptions {
+    /** 名称字段键 */
+    nameKey?: string;
 }
+/**
+ * 点位数据接口
+ */
 export interface PointData {
     lgtd: number;
     lttd: number;
-    [propName: string]: any;
+    [key: string]: any;
+}
+/**
+ * 线数据接口
+ */
+export interface LineData {
+    type: string;
+    coordinates: number[][];
+    [key: string]: any;
+}
+/**
+ * 聚合选项接口
+ */
+export interface ClusterOptions extends PointOptions {
+    /** 聚合距离 */
+    distance?: number;
+    /** 最小聚合距离 */
+    minDistance?: number;
+}
+/**
+ * 测量处理器类型
+ */
+export type MeasureHandlerType = 'LineString' | 'Polygon';
+/**
+ * 事件类型
+ */
+export type EventType = 'click' | 'hover' | 'moveend';
+/**
+ * Vue实例接口
+ */
+export interface VueInstance {
+    mount(element: Element | string): VueInstance;
+    unmount?(): void;
+    $destroy?(): void;
+    [key: string]: any;
+}
+/**
+ * Vue应用接口
+ */
+export interface VueApp {
+    mount(element: Element | string): VueInstance;
+    unmount(): void;
+    [key: string]: any;
+}
+/**
+ * Vue 2.x 实例接口
+ */
+export interface VueLegacyInstance {
+    $mount(element?: Element | string): VueLegacyInstance;
+    $destroy(): void;
+    [key: string]: any;
+}
+/**
+ * DOM点位状态枚举
+ */
+export declare enum DomPointState {
+    CREATED = "created",
+    MOUNTED = "mounted",
+    VISIBLE = "visible",
+    HIDDEN = "hidden",
+    DESTROYED = "destroyed"
+}
+/**
+ * DOM点位选项接口
+ */
+export interface DomPointOptions {
+    Vue: any;
+    Template: any;
+    lgtd: number;
+    lttd: number;
+    props?: any;
+    longitude?: number;
+    latitude?: number;
+    styleType?: 'default' | 'custom';
+    positioning?: 'bottom-left' | 'bottom-center' | 'bottom-right' | 'center-left' | 'center-center' | 'center-right' | 'top-left' | 'top-center' | 'top-right';
+    stopEvent?: boolean;
+    visible?: boolean;
+    className?: string;
+    zIndex?: number;
 }
-export type MeasureHandlerType = 'Polygon' | 'LineString';
-export type EventType = 'click' | 'moveend' | 'hover';

package/dist/types.js

@@ -1 +1,11 @@
-export {};
+/**
+ * DOM点位状态枚举
+ */
+export var DomPointState;
+(function (DomPointState) {
+    DomPointState["CREATED"] = "created";
+    DomPointState["MOUNTED"] = "mounted";
+    DomPointState["VISIBLE"] = "visible";
+    DomPointState["HIDDEN"] = "hidden";
+    DomPointState["DESTROYED"] = "destroyed";
+})(DomPointState || (DomPointState = {}));

package/dist/utils/ErrorHandler.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 错误类型枚举
+ */
+export declare enum ErrorType {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    MAP_ERROR = "MAP_ERROR",
+    LAYER_ERROR = "LAYER_ERROR",
+    COORDINATE_ERROR = "COORDINATE_ERROR",
+    DATA_ERROR = "DATA_ERROR",
+    COMPONENT_ERROR = "COMPONENT_ERROR"
+}
+/**
+ * 自定义错误类
+ */
+export declare class MyOpenLayersError extends Error {
+    readonly type: ErrorType;
+    readonly timestamp: Date;
+    readonly context?: any;
+    constructor(message: string, type: ErrorType, context?: any);
+}
+/**
+ * 错误处理工具类
+ */
+export declare class ErrorHandler {
+    private static instance;
+    private errorCallbacks;
+    private logLevel;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): ErrorHandler;
+    /**
+     * 设置日志级别
+     * @param level 日志级别
+     */
+    setLogLevel(level: 'debug' | 'info' | 'warn' | 'error'): void;
+    /**
+     * 添加错误回调
+     * @param callback 错误回调函数
+     */
+    addErrorCallback(callback: (error: MyOpenLayersError) => void): void;
+    /**
+     * 移除错误回调
+     * @param callback 要移除的回调函数
+     */
+    removeErrorCallback(callback: (error: MyOpenLayersError) => void): void;
+    /**
+     * 处理错误
+     * @param error 错误对象
+     */
+    handleError(error: MyOpenLayersError): void;
+    /**
+     * 创建并处理错误
+     * @param message 错误消息
+     * @param type 错误类型
+     * @param context 错误上下文
+     */
+    createAndHandleError(message: string, type: ErrorType, context?: any): MyOpenLayersError;
+    /**
+     * 记录错误日志
+     * @param error 错误对象
+     */
+    private logError;
+    /**
+     * 验证参数
+     * @param condition 验证条件
+     * @param message 错误消息
+     * @param context 错误上下文
+     */
+    static validate(condition: boolean, message: string, context?: any): void;
+    /**
+     * 验证地图实例
+     * @param map 地图实例
+     */
+    static validateMap(map: any): void;
+    /**
+     * 验证坐标
+     * @param longitude 经度
+     * @param latitude 纬度
+     */
+    static validateCoordinates(longitude: number, latitude: number): void;
+    /**
+     * 验证图层名称
+     * @param layerName 图层名称
+     */
+    static validateLayerName(layerName: string): void;
+    /**
+     * 验证数据
+     * @param data 数据
+     * @param dataType 数据类型描述
+     */
+    static validateData(data: any, dataType: string): void;
+    /**
+     * 安全执行函数
+     * @param fn 要执行的函数
+     * @param errorMessage 错误消息
+     * @param errorType 错误类型
+     * @param context 错误上下文
+     */
+    static safeExecute<T>(fn: () => T, errorMessage: string, errorType?: ErrorType, context?: any): T;
+}

package/dist/utils/ErrorHandler.js

@@ -0,0 +1,191 @@
+/**
+ * 错误类型枚举
+ */
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ErrorType["MAP_ERROR"] = "MAP_ERROR";
+    ErrorType["LAYER_ERROR"] = "LAYER_ERROR";
+    ErrorType["COORDINATE_ERROR"] = "COORDINATE_ERROR";
+    ErrorType["DATA_ERROR"] = "DATA_ERROR";
+    ErrorType["COMPONENT_ERROR"] = "COMPONENT_ERROR";
+})(ErrorType || (ErrorType = {}));
+/**
+ * 自定义错误类
+ */
+export class MyOpenLayersError extends Error {
+    constructor(message, type, context) {
+        super(message);
+        this.name = 'MyOpenLayersError';
+        this.type = type;
+        this.timestamp = new Date();
+        this.context = context;
+        // 确保错误堆栈正确显示（兼容Node.js和浏览器环境）
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(this, MyOpenLayersError);
+        }
+        else {
+            // 在不支持captureStackTrace的环境中，手动设置stack
+            this.stack = (new Error()).stack;
+        }
+    }
+}
+/**
+ * 错误处理工具类
+ */
+export class ErrorHandler {
+    constructor() {
+        this.errorCallbacks = [];
+        this.logLevel = 'error';
+    }
+    /**
+     * 获取单例实例
+     */
+    static getInstance() {
+        if (!ErrorHandler.instance) {
+            ErrorHandler.instance = new ErrorHandler();
+        }
+        return ErrorHandler.instance;
+    }
+    /**
+     * 设置日志级别
+     * @param level 日志级别
+     */
+    setLogLevel(level) {
+        this.logLevel = level;
+    }
+    /**
+     * 添加错误回调
+     * @param callback 错误回调函数
+     */
+    addErrorCallback(callback) {
+        this.errorCallbacks.push(callback);
+    }
+    /**
+     * 移除错误回调
+     * @param callback 要移除的回调函数
+     */
+    removeErrorCallback(callback) {
+        const index = this.errorCallbacks.indexOf(callback);
+        if (index > -1) {
+            this.errorCallbacks.splice(index, 1);
+        }
+    }
+    /**
+     * 处理错误
+     * @param error 错误对象
+     */
+    handleError(error) {
+        // 记录错误日志
+        this.logError(error);
+        // 调用错误回调
+        this.errorCallbacks.forEach(callback => {
+            try {
+                callback(error);
+            }
+            catch (callbackError) {
+                console.error('Error in error callback:', callbackError);
+            }
+        });
+    }
+    /**
+     * 创建并处理错误
+     * @param message 错误消息
+     * @param type 错误类型
+     * @param context 错误上下文
+     */
+    createAndHandleError(message, type, context) {
+        const error = new MyOpenLayersError(message, type, context);
+        this.handleError(error);
+        return error;
+    }
+    /**
+     * 记录错误日志
+     * @param error 错误对象
+     */
+    logError(error) {
+        const logMessage = `[${error.type}] ${error.message}`;
+        const logData = {
+            message: error.message,
+            type: error.type,
+            timestamp: error.timestamp,
+            context: error.context,
+            stack: error.stack
+        };
+        switch (this.logLevel) {
+            case 'debug':
+                console.debug(logMessage, logData);
+                break;
+            case 'info':
+                console.info(logMessage, logData);
+                break;
+            case 'warn':
+                console.warn(logMessage, logData);
+                break;
+            case 'error':
+            default:
+                console.error(logMessage, logData);
+                break;
+        }
+    }
+    /**
+     * 验证参数
+     * @param condition 验证条件
+     * @param message 错误消息
+     * @param context 错误上下文
+     */
+    static validate(condition, message, context) {
+        if (!condition) {
+            throw ErrorHandler.getInstance().createAndHandleError(message, ErrorType.VALIDATION_ERROR, context);
+        }
+    }
+    /**
+     * 验证地图实例
+     * @param map 地图实例
+     */
+    static validateMap(map) {
+        ErrorHandler.validate(map && typeof map === 'object', 'Map instance is required', { map });
+    }
+    /**
+     * 验证坐标
+     * @param longitude 经度
+     * @param latitude 纬度
+     */
+    static validateCoordinates(longitude, latitude) {
+        ErrorHandler.validate(typeof longitude === 'number' && !isNaN(longitude), 'Valid longitude is required', { longitude, latitude });
+        ErrorHandler.validate(typeof latitude === 'number' && !isNaN(latitude), 'Valid latitude is required', { longitude, latitude });
+        ErrorHandler.validate(longitude >= -180 && longitude <= 180, 'Longitude must be between -180 and 180', { longitude, latitude });
+        ErrorHandler.validate(latitude >= -90 && latitude <= 90, 'Latitude must be between -90 and 90', { longitude, latitude });
+    }
+    /**
+     * 验证图层名称
+     * @param layerName 图层名称
+     */
+    static validateLayerName(layerName) {
+        ErrorHandler.validate(typeof layerName === 'string' && layerName.trim().length > 0, 'Valid layer name is required', { layerName });
+    }
+    /**
+     * 验证数据
+     * @param data 数据
+     * @param dataType 数据类型描述
+     */
+    static validateData(data, dataType) {
+        ErrorHandler.validate(data !== null && data !== undefined, `${dataType} is required`, { data, dataType });
+    }
+    /**
+     * 安全执行函数
+     * @param fn 要执行的函数
+     * @param errorMessage 错误消息
+     * @param errorType 错误类型
+     * @param context 错误上下文
+     */
+    static safeExecute(fn, errorMessage, errorType = ErrorType.COMPONENT_ERROR, context) {
+        try {
+            return fn();
+        }
+        catch (error) {
+            const myError = ErrorHandler.getInstance().createAndHandleError(`${errorMessage}: ${error}`, errorType, { originalError: error, context });
+            throw myError;
+        }
+    }
+}

package/dist/utils/ValidationUtils.d.ts

@@ -0,0 +1,162 @@
+/**
+ * 验证工具类
+ * 统一管理所有验证方法
+ */
+export declare class ValidationUtils {
+    /**
+     * 验证坐标是否有效
+     * @param longitude 经度
+     * @param latitude 纬度
+     * @returns 是否有效
+     */
+    static isValidCoordinate(longitude: number, latitude: number): boolean;
+    /**
+     * 验证经纬度坐标（简化版本）
+     * @param lgtd 经度
+     * @param lttd 纬度
+     * @returns 是否有效
+     */
+    static validateLngLat(lgtd: number, lttd: number): boolean;
+    /**
+     * 验证点数据数组
+     * @param pointData 点数据数组
+     * @returns 是否有效
+     */
+    static validatePointData(pointData: any[]): boolean;
+    /**
+     * 验证单个点的坐标
+     * @param item 包含坐标的数据项
+     * @returns 是否有效
+     */
+    static validateCoordinates(item: any): 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;
+    /**
+     * 验证GeoJSON数据
+     * @param data GeoJSON数据
+     * @returns 是否有效
+     */
+    static validateGeoJSONData(data: any): boolean;
+    /**
+     * 验证配置选项
+     * @param options 配置选项
+     * @returns 是否有效
+     */
+    static validateOptions(options: any): boolean;
+    /**
+     * 验证数值范围
+     * @param value 数值
+     * @param min 最小值
+     * @param max 最大值
+     * @returns 是否有效
+     */
+    static validateNumberRange(value: number, min: number, max: number): boolean;
+    /**
+     * 验证DOM元素ID
+     * @param id 元素ID
+     * @returns 是否有效
+     */
+    static validateElementId(id: string): boolean;
+    /**
+     * 验证Vue相关参数
+     * @param pointInfoList 点位信息列表
+     * @param template Vue组件模板
+     * @param Vue Vue实例
+     * @returns 是否有效
+     */
+    static validateVueParams(pointInfoList: any[], template: any, Vue: any): boolean;
+    /**
+     * 验证图层名称（抛出异常版本）
+     * @param layerName 图层名称
+     * @throws 如果图层名称无效则抛出异常
+     */
+    static validateLayerName(layerName: string): void;
+    /**
+     * 验证图像数据
+     * @param imageData 图像数据
+     * @throws 如果图像数据无效则抛出异常
+     */
+    static validateImageData(imageData: any): void;
+    /**
+     * 验证遮罩数据
+     * @param data 遮罩数据
+     * @throws 如果遮罩数据无效则抛出异常
+     */
+    static validateMaskData(data: any): void;
+    /**
+     * 验证地图实例
+     * @param map 地图实例
+     * @throws 如果地图实例无效则抛出异常
+     */
+    static validateMapInstance(map: any): void;
+    /**
+     * 验证必需参数
+     * @param value 要验证的值
+     * @param message 错误消息
+     * @throws 如果值为空则抛出异常
+     */
+    static validateRequired(value: any, message: string): void;
+    /**
+     * 验证坐标（抛出异常版本）
+     * @param longitude 经度
+     * @param latitude 纬度
+     * @throws 如果坐标无效则抛出异常
+     */
+    static validateCoordinate(longitude: number, latitude: number): void;
+    /**
+     * 验证类型
+     * @param value 要验证的值
+     * @param expectedType 期望的类型
+     * @param message 错误消息
+     * @throws 如果类型不匹配则抛出异常
+     */
+    static validateType(value: any, expectedType: string, message: string): void;
+    /**
+     * 验证非空字符串（抛出异常版本）
+     * @param str 字符串
+     * @param message 错误消息
+     * @throws 如果字符串为空则抛出异常
+     */
+    static validateNonEmptyString(str: string, message: string): void;
+    /**
+     * 验证地图实例（通用版本）
+     * @param map 地图实例
+     * @throws 如果地图实例无效则抛出异常
+     */
+    static validateMap(map: any): void;
+    /**
+     * 验证测量类型
+     * @param type 测量类型
+     * @throws 如果测量类型无效则抛出异常
+     */
+    static validateMeasureType(type: string): void;
+    /**
+     * 验证正数
+     * @param value 数值
+     * @param message 错误消息
+     * @throws 如果数值不是正数则抛出异常
+     */
+    static validatePositiveNumber(value: number, message: string): void;
+    /**
+     * 验证图层名称参数
+     * @param layerName 图层名称（字符串或字符串数组）
+     * @throws 如果图层名称参数无效则抛出异常
+     */
+    static validateLayerNameParam(layerName: string | string[]): void;
+}