my-openlayer 0.1.17 → 1.0.0

package/dist/types.d.ts

@@ -1,95 +1,280 @@
-import BaseLayer from "ol/layer/Base";
-export interface Feature {
-    type: string;
-    properties: any;
-    geometry: {
-        type: "Polygon" | "MultiPolygon" | "Point" | "LineString" | "MultiLineString" | "MultiPoint" | "GeometryCollection";
-        coordinates: any[];
-    };
-}
-export interface MapJSONData {
-    type: string;
-    name?: string;
-    features: Feature[];
-}
-export interface MapInitType {
-    layers?: BaseLayer[] | {
-        [key: string]: BaseLayer[];
-    };
-    zoom?: number;
-    center?: number[];
-    view?: any;
-    minZoom?: number;
-    maxZoom?: number;
-    extent?: number[];
-    mapClipData?: MapJSONData;
-    token?: string;
-    annotation?: boolean;
-}
-export type AnnotationType = 'cva_c' | 'cia_c' | 'cta_c';
-export type TiandituType = 'vec_c' | 'img_c' | 'ter_c' | string;
-export interface MapLayers {
-    vec_c?: BaseLayer[];
-    img_c?: BaseLayer[];
-    ter_c?: BaseLayer[];
-    [key: string]: BaseLayer[] | undefined;
-}
-export interface MapLayersOptions {
-    layers?: BaseLayer[] | MapLayers;
-    zIndex?: number;
-    mapClip?: boolean;
-    mapClipData?: MapJSONData;
-    token?: string;
-    annotation?: boolean;
-}
-export interface AnnotationLayerOptions {
-    type: AnnotationType;
-    token: string;
-    zIndex?: number;
-    visible?: boolean;
-}
-export interface HeatMapOptions {
-    radius?: number;
-    blur?: number;
-    gradient?: string[];
-    opacity?: number;
-    visible?: boolean;
-    zIndex?: number;
-    valueKey: string;
-}
-export interface OptionsType {
-    layerName?: string;
-    nameKey?: string;
-    img?: string;
-    scale?: number;
-    hasImg?: boolean;
-    zIndex?: number;
-    visible?: boolean;
-    projectionOptOptions?: any;
-    strokeColor?: string | number[];
-    strokeWidth?: number;
-    lineDash?: number[];
-    lineDashOffset?: number;
-    fillColor?: string;
-    textVisible?: boolean;
-    textCallBack?: (feature: any) => string;
-    textFont?: string;
-    textFillColor?: string;
-    textStrokeColor?: string;
-    textStrokeWidth?: number;
-    textOffsetY?: number;
-    fitView?: boolean;
-    opacity?: number;
-    mapClip?: boolean;
-    mapClipData?: MapJSONData;
-    mask?: boolean;
-    iconColor?: string;
-    [propName: string]: any;
-}
-export interface PointData {
-    lgtd: number;
-    lttd: number;
-    [propName: string]: any;
-}
-export type MeasureHandlerType = 'Polygon' | 'LineString';
-export type EventType = 'click' | 'moveend' | 'hover';
+import BaseLayer from "ol/layer/Base";
+export interface Feature {
+  type: string;
+  properties: any;
+  geometry: {
+    type: "Polygon" | "MultiPolygon" | "Point" | "LineString" | "MultiLineString" | "MultiPoint" | "GeometryCollection";
+    coordinates: any[];
+  }
+}
+export interface MapJSONData {
+  type: string,
+  name?: string,
+  features: Feature[]
+}
+export interface MapInitType {
+  layers?: BaseLayer[] | { [key: string]: BaseLayer[] },
+  zoom?: number,
+  center?: number[],
+  view?: any,
+  minZoom?: number,
+  maxZoom?: number,
+  extent?: number[],
+  mapClipData?: MapJSONData,
+  token?: string,
+  annotation?: boolean //注记
+}
+export type AnnotationType = 'cva_c' | 'cia_c' | 'cta_c'
+export type TiandituType = 'vec_c' | 'img_c' | 'ter_c' | string
+export interface MapLayers {
+  vec_c?: BaseLayer[];
+  img_c?: BaseLayer[];
+  ter_c?: BaseLayer[];
+  [key: string]: BaseLayer[] | undefined;
+}
+export interface MapLayersOptions {
+  layers?: BaseLayer[] | MapLayers;
+  zIndex?: number;
+  mapClip?: boolean;
+  mapClipData?: MapJSONData;
+  token?: string;
+  annotation?: boolean;
+}
+export interface AnnotationLayerOptions {
+  type: AnnotationType,
+  token: string,
+  zIndex?: number,
+  visible?: boolean
+}
+export interface HeatMapOptions {
+  layerName?: string,
+  radius?: number,
+  blur?: number,
+  gradient?: string[],
+  opacity?: number,
+  visible?: boolean,
+  zIndex?: number,
+  valueKey?: string,
+}
+/**
+ * 基础选项接口 - 所有图层的公共配置
+ */
+export interface BaseOptions {
+  /** 图层名称 */
+  layerName?: string;
+  /** 图层层级 */
+  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;
+}
+/**
+ * 点位选项接口 - 点位图层专用配置
+ */
+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;
+  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;
+  [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 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;
+}

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;
+        }
+    }
+}