my-openlayer 2.4.10 → 2.5.1

package/types/vue-template-point.d.ts

@@ -0,0 +1,54 @@
+export interface VueInstance {
+    mount(element: Element | string): VueInstance;
+    unmount?(): void;
+    $destroy?(): void;
+    [key: string]: any;
+}
+export interface VueApp {
+    mount(element: Element | string): VueInstance;
+    unmount(): void;
+    [key: string]: any;
+}
+export interface VueLegacyInstance {
+    $mount(element?: Element | string): VueLegacyInstance;
+    $destroy(): void;
+    [key: string]: any;
+}
+export declare enum VueTemplatePointState {
+    CREATED = "created",
+    MOUNTED = "mounted",
+    VISIBLE = "visible",
+    HIDDEN = "hidden",
+    DESTROYED = "destroyed"
+}
+export interface VueTemplatePointOptions {
+    Template: any;
+    lgtd: number;
+    lttd: number;
+    props?: any;
+    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 interface VueTemplatePointInstance {
+    id: string;
+    dom: HTMLElement;
+    anchor: any;
+    app: VueApp | VueLegacyInstance | null;
+    state: VueTemplatePointState;
+    position: number[];
+    options: VueTemplatePointOptions;
+    setVisible(visible: boolean): void;
+    updatePosition(lgtd: number, lttd: number): void;
+    updateProps(newProps: Record<string, any>): void;
+    setStyle(styles: Partial<CSSStyleDeclaration>): void;
+    addClass(className: string): void;
+    removeClass(className: string): void;
+    remove(): void;
+    getState(): VueTemplatePointState;
+    getOptions(): Readonly<VueTemplatePointOptions>;
+    isDestroyed(): boolean;
+}

package/{types.js → types/vue-template-point.js}

@@ -1,6 +1,3 @@
-/**
- * DOM点位状态枚举
- */
 export var VueTemplatePointState;
 (function (VueTemplatePointState) {
     VueTemplatePointState["CREATED"] = "created";

package/utils/ProjectionUtils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 可携带投影参数的配置对象。
+ */
+export interface ProjectionOptionLike {
+    dataProjection?: string;
+    featureProjection?: string;
+    /**
+     * @deprecated 新项目请使用 dataProjection / featureProjection。
+     */
+    projectionOptOptions?: {
+        dataProjection?: string;
+        featureProjection?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * 投影处理工具，统一显式字段与旧 projectionOptOptions 的兼容逻辑。
+ */
+export default class ProjectionUtils {
+    /**
+     * 生成 GeoJSON 读取投影参数。显式字段优先于旧 projectionOptOptions。
+     */
+    static getGeoJSONReadOptions(options?: ProjectionOptionLike): Record<string, unknown>;
+    /**
+     * 将输入坐标转换到目标要素投影。未传目标投影时保持原坐标。
+     */
+    static transformCoordinate(coordinate: number[], options?: ProjectionOptionLike): number[];
+}

package/utils/ProjectionUtils.js

@@ -0,0 +1,34 @@
+import { transform } from 'ol/proj';
+/**
+ * 投影处理工具，统一显式字段与旧 projectionOptOptions 的兼容逻辑。
+ */
+export default class ProjectionUtils {
+    /**
+     * 生成 GeoJSON 读取投影参数。显式字段优先于旧 projectionOptOptions。
+     */
+    static getGeoJSONReadOptions(options) {
+        const legacyOptions = options?.projectionOptOptions ?? {};
+        const readOptions = { ...legacyOptions };
+        if (options?.dataProjection) {
+            readOptions.dataProjection = options.dataProjection;
+        }
+        if (options?.featureProjection) {
+            readOptions.featureProjection = options.featureProjection;
+        }
+        return readOptions;
+    }
+    /**
+     * 将输入坐标转换到目标要素投影。未传目标投影时保持原坐标。
+     */
+    static transformCoordinate(coordinate, options) {
+        const featureProjection = options?.featureProjection ?? options?.projectionOptOptions?.featureProjection;
+        if (!featureProjection) {
+            return coordinate;
+        }
+        const dataProjection = options?.dataProjection ?? options?.projectionOptOptions?.dataProjection ?? 'EPSG:4326';
+        if (dataProjection === featureProjection) {
+            return coordinate;
+        }
+        return transform(coordinate, dataProjection, featureProjection);
+    }
+}

package/utils/ValidationUtils.d.ts

@@ -1,159 +1,106 @@
-export declare class ValidationUtils {
+/**
+ * 验证工具类
+ * 统一管理参数校验逻辑，错误记录由调用方或 ErrorHandler 负责。
+ */
+export default class ValidationUtils {
     /**
-     * 验证坐标是否有效
-     * @param longitude 经度
-     * @param latitude 纬度
-     * @returns 是否有效
+     * 判断值是否为有效数字。
+     */
+    private static isFiniteNumber;
+    /**
+     * 验证坐标是否有效。
      */
     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 是否有效
+     * 验证 GeoJSON 数据，保留布尔返回以兼容旧调用。
      */
     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 是否有效
+     * 验证 DOM 元素 ID，保留布尔返回以兼容旧调用。
      */
     static validateElementId(id: string): boolean;
     /**
-     * 验证Vue相关参数
-     * @param pointInfoList 点位信息列表
-     * @param template Vue组件模板
-     * @param Vue Vue实例
-     * @returns 是否有效
+     * 验证 Vue 相关参数，保留布尔返回以兼容旧调用。
      */
     static validateVueParams(pointInfoList: any[], template: any, Vue: any): boolean;
     /**
-     * 验证图层名称（抛出异常版本）
-     * @param layerName 图层名称
-     * @throws 如果图层名称无效则抛出异常
+     * 验证图层名称（抛出异常版本）。
      */
     static validateLayerName(layerName: string): void;
     /**
-     * 验证图像数据
-     * @param imageData 图像数据
-     * @param allowEmptyImg 是否允许img为空
-     * @throws 如果图像数据无效则抛出异常
+     * 验证图像数据。
      */
     static validateImageData(imageData: any, allowEmptyImg?: boolean): 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;
 }