ly-utils-lib 1.0.12 → 2.4.0

package/dist/index-C0qUnb9Y.d.ts

@@ -0,0 +1,533 @@
+import * as ol_layer_Base from 'ol/layer/Base';
+import { Feature, Map, View } from 'ol';
+import VectorLayer from 'ol/layer/Vector';
+import VectorSource from 'ol/source/Vector';
+import { Style } from 'ol/style';
+
+/**
+ * 主题类型
+ */
+type MapTheme = 'light' | 'dark';
+/**
+ * 地图配置选项
+ */
+interface MapOptions {
+    /** 地图容器 ID */
+    container: string;
+    /** 中心点 [经度, 纬度] */
+    center?: [number, number];
+    /** 缩放级别 */
+    zoom?: number;
+    /** 最小缩放级别 */
+    minZoom?: number;
+    /** 最大缩放级别 */
+    maxZoom?: number;
+    /** 是否显示比例尺 */
+    showScaleLine?: boolean;
+    /** 是否显示全屏按钮 */
+    showFullScreen?: boolean;
+    /** 默认图层 */
+    layers?: Layer[];
+    /** 主题 */
+    theme?: MapTheme;
+    /** 主题配置 */
+    themeConfig?: ThemeConfig;
+    /** 自定义图标配置 */
+    icons?: Record<string, IconConfig>;
+    /** 是否启用动态缩放 */
+    enableDynamicScale?: boolean;
+    /** 投影坐标系，默认 EPSG:4326 */
+    projection?: string;
+}
+/**
+ * 图层类型
+ */
+interface Layer {
+    /** 图层名称 */
+    name: string;
+    /** 图层实例 */
+    layer: ol_layer_Base.default;
+}
+/**
+ * 主题配置
+ */
+interface ThemeConfig {
+    /** 亮色地图 URL */
+    lightUrl?: string;
+    /** 暗色地图 URL */
+    darkUrl?: string;
+}
+/**
+ * 图标配置
+ */
+interface IconConfig {
+    /** 图标 URL 或 base64 */
+    src: string;
+    /** 锚点位置 [x, y]，默认 [0.5, 0.5] */
+    anchor?: [number, number];
+    /** 缩放比例，默认 1 */
+    scale?: number;
+}
+/**
+ * 标记选项
+ */
+interface MarkerOptions {
+    /** 坐标 [经度, 纬度] */
+    coordinate: [number, number];
+    /** 颜色 */
+    color?: string;
+    /** 半径 */
+    radius?: number;
+    /** 边框颜色 */
+    strokeColor?: string;
+    /** 边框宽度 */
+    strokeWidth?: number;
+    /** 自定义图标名称 */
+    icon?: string;
+    /** 自定义图标配置 */
+    iconConfig?: IconConfig;
+    /** 自定义样式 */
+    style?: Style;
+}
+/**
+ * 要素样式选项
+ */
+interface FeatureStyleOptions {
+    /** 图标名称（来自 icons 配置） */
+    icon?: string;
+    /** 自定义图标配置 */
+    iconConfig?: IconConfig;
+    /** 填充颜色（Polygon） */
+    fillColor?: string;
+    /** 边框颜色 */
+    strokeColor?: string;
+    /** 边框宽度 */
+    strokeWidth?: number;
+    /** 自定义样式 */
+    style?: Style;
+}
+/**
+ * 绘制类型
+ */
+type DrawType = 'Point' | 'LineString' | 'Polygon' | 'Circle';
+/**
+ * 绘制选项
+ */
+interface DrawOptions {
+    /** 绘制类型 */
+    type: DrawType;
+    /** 绘制完成回调 */
+    onDrawEnd?: (feature: Feature) => void;
+    /** 绘制样式 */
+    style?: Style;
+    /** 绘制图层名称 */
+    layerName?: string;
+}
+/**
+ * GeoJSON 要素选项
+ */
+interface GeoJSONFeature {
+    type: 'FeatureCollection';
+    features: GeoJSONFeatureItem[];
+}
+/**
+ * GeoJSON 要素项
+ */
+interface GeoJSONFeatureItem {
+    type: 'Feature';
+    geometry: {
+        type: 'Point' | 'LineString' | 'Polygon';
+        coordinates: number[] | number[][] | number[][][];
+    };
+    properties?: Record<string, any>;
+}
+/**
+ * Overlay 配置
+ */
+interface OverlayOptions {
+    /** Overlay 名称 */
+    name: string;
+    /** DOM 元素 */
+    element: HTMLElement;
+    /** 是否自动平移 */
+    autoPan?: boolean;
+    /** 偏移量 */
+    offset?: number[];
+    /** 定位方式 */
+    positioning?: 'bottom-center' | 'bottom-left' | 'bottom-right' | 'center-center' | 'center-left' | 'center-right' | 'top-center' | 'top-left' | 'top-right';
+}
+/**
+ * 矢量图层配置
+ */
+interface VectorLayerConfig {
+    /** 图层名称 */
+    name: string;
+    /** 最小缩放级别 */
+    minZoom?: number;
+    /** 最大缩放级别 */
+    maxZoom?: number;
+    /** 图层层级 */
+    zIndex?: number;
+    /** 默认样式 */
+    style?: Style;
+    /** 是否可见 */
+    visible?: boolean;
+}
+/**
+ * 地图类 - 封装 OpenLayers Map
+ */
+declare class MapInstance {
+    private map;
+    private vectorSources;
+    private vectorLayers;
+    private overlays;
+    private themeLayers;
+    private drawInteraction;
+    private modifyInteraction;
+    private snapInteraction;
+    private selectInteraction;
+    private currentTheme;
+    private icons;
+    private enableDynamicScale;
+    private projection;
+    constructor(options: MapOptions);
+    /**
+     * 设置主题图层
+     */
+    private setupThemeLayers;
+    /**
+     * 切换主题
+     */
+    setTheme(theme: MapTheme): void;
+    /**
+     * 获取当前主题
+     */
+    getTheme(): MapTheme;
+    /**
+     * 创建矢量图层
+     */
+    createVectorLayer(config: VectorLayerConfig): void;
+    /**
+     * 获取矢量图层
+     */
+    getVectorLayer(name: string): VectorLayer<VectorSource> | undefined;
+    /**
+     * 获取矢量数据源
+     */
+    getVectorSource(name: string): VectorSource | undefined;
+    /**
+     * 显示/隐藏矢量图层
+     */
+    setLayerVisible(name: string, visible: boolean): void;
+    /**
+     * 设置矢量图层样式
+     */
+    setLayerStyle(name: string, style: Style): void;
+    /**
+     * 清除矢量图层
+     */
+    clearLayer(name: string): void;
+    /**
+     * 删除矢量图层
+     */
+    removeLayer(name: string): void;
+    /**
+     * 添加标记
+     */
+    addMarker(options: MarkerOptions, layerName?: string): Feature;
+    /**
+     * 创建标记样式
+     */
+    private createMarkerStyle;
+    /**
+     * 移除标记
+     */
+    removeMarker(feature: Feature, layerName?: string): void;
+    /**
+     * 从 GeoJSON 添加要素
+     */
+    addFeaturesFromGeoJSON(geoJson: GeoJSONFeature | string, layerName?: string): Feature[];
+    /**
+     * 添加要素
+     */
+    addFeature(feature: Feature, layerName?: string): void;
+    /**
+     * 批量添加要素
+     */
+    addFeatures(features: Feature[], layerName?: string): void;
+    /**
+     * 移除要素
+     */
+    removeFeature(feature: Feature, layerName?: string): void;
+    /**
+     * 清除所有矢量要素
+     */
+    clearFeatures(layerName?: string): void;
+    /**
+     * 获取图层中的所有要素
+     */
+    getFeatures(layerName?: string): Feature[];
+    /**
+     * 创建 GeoJSON
+     */
+    createGeoJSON(type: 'Point' | 'LineString' | 'Polygon', data: any): GeoJSONFeature;
+    /**
+     * 获取坐标
+     */
+    private getCoordinates;
+    /**
+     * 设置点数组
+     */
+    private setPointArray;
+    /**
+     * 生成 UUID
+     */
+    private generateUUID;
+    /**
+     * 设置要素样式
+     */
+    setFeatureStyle(feature: Feature, options: FeatureStyleOptions): void;
+    /**
+     * 创建要素样式
+     */
+    private createFeatureStyle;
+    /**
+     * 处理缩放变化
+     */
+    private handleZoomChange;
+    /**
+     * 更新图标缩放比例
+     */
+    private updateIconScale;
+    /**
+     * 创建 Overlay
+     */
+    createOverlay(options: OverlayOptions): void;
+    /**
+     * 显示 Overlay
+     */
+    showOverlay(name: string, coordinate: [number, number]): void;
+    /**
+     * 隐藏 Overlay
+     */
+    hideOverlay(name: string): void;
+    /**
+     * 移除 Overlay
+     */
+    removeOverlay(name: string): void;
+    /**
+     * 开始绘制
+     */
+    startDraw(options: DrawOptions): void;
+    /**
+     * 停止绘制
+     */
+    stopDraw(): void;
+    /**
+     * 开始编辑
+     */
+    startModify(layerName?: string): void;
+    /**
+     * 停止编辑
+     */
+    stopModify(): void;
+    /**
+     * 开始选择
+     */
+    startSelect(layerName?: string, onSelect?: (features: Feature[]) => void): void;
+    /**
+     * 停止选择
+     */
+    stopSelect(): void;
+    /**
+     * 获取选中的要素
+     */
+    getSelectedFeatures(): Feature[];
+    /**
+     * 获取原始地图实例
+     */
+    getOlMap(): Map;
+    /**
+     * 获取视图
+     */
+    getView(): View | undefined;
+    /**
+     * 设置中心点
+     */
+    setCenter(coord: [number, number]): void;
+    /**
+     * 获取中心点
+     */
+    getCenter(): [number, number] | undefined;
+    /**
+     * 设置缩放级别
+     */
+    setZoom(zoom: number): void;
+    /**
+     * 获取缩放级别
+     */
+    getZoom(): number | undefined;
+    /**
+     * 缩放到指定范围
+     */
+    fit(extent: number[] | null, options?: {
+        padding?: number[];
+        duration?: number;
+    }): void;
+    /**
+     * 缩放到图层
+     */
+    fitLayer(layerName: string, options?: {
+        padding?: number[];
+        duration?: number;
+    }): void;
+    /**
+     * 缩放到坐标数组
+     */
+    fitCoordinates(coordinates: [number, number][], options?: {
+        padding?: number[];
+        duration?: number;
+    }): void;
+    /**
+     * 添加图层
+     */
+    addLayer(layer: Layer): void;
+    /**
+     * 移除图层
+     */
+    removeMapLayer(layer: Layer): void;
+    /**
+     * 更新地图大小
+     */
+    updateSize(): void;
+    /**
+     * 地图事件监听
+     */
+    on(event: string | string[], callback: (...args: unknown[]) => void): void;
+    /**
+     * 移除事件监听
+     */
+    off(event: string | string[], callback: (...args: unknown[]) => void): void;
+    /**
+     * 销毁地图
+     */
+    destroy(): void;
+}
+/**
+ * 创建 OSM 图层
+ */
+declare function createOSMLayer(name?: string): Layer;
+/**
+ * 创建 XYZ 图层（适用于高德、百度等）
+ */
+declare function createXYZLayer(url: string, name?: string): Layer;
+/**
+ * 创建高德地图图层
+ */
+declare function createGaodeLayer(name?: string): Layer;
+/**
+ * 创建天地图图层
+ */
+declare function createTiandituLayer(token: string, type?: string, name?: string): Layer;
+/**
+ * 经纬度转投影坐标
+ */
+declare function lonLatToXY(lon: number, lat: number): number[];
+/**
+ * 投影坐标转经纬度
+ */
+declare function xyToLonLat(x: number, y: number): [number, number];
+/**
+ * 创建点要素
+ */
+declare function createPointFeature(coordinate: [number, number]): Feature;
+/**
+ * 创建线要素
+ */
+declare function createLineFeature(coordinates: [number, number][]): Feature;
+/**
+ * 创建面要素
+ */
+declare function createPolygonFeature(coordinates: [number, number][][]): Feature;
+/**
+ * 创建带样式的点要素
+ */
+declare function createStyledPointFeature(coordinate: [number, number], style: Style): Feature;
+/**
+ * 创建带样式的线要素
+ */
+declare function createStyledLineFeature(coordinates: [number, number][], style: Style): Feature;
+/**
+ * 创建带样式的面要素
+ */
+declare function createStyledPolygonFeature(coordinates: [number, number][][], style: Style): Feature;
+/**
+ * 创建图标样式
+ */
+declare function createIconStyle(iconUrl: string, options?: {
+    anchor?: [number, number];
+    scale?: number;
+    color?: string;
+}): Style;
+/**
+ * 创建圆形样式
+ */
+declare function createCircleStyle(options?: {
+    radius?: number;
+    fillColor?: string;
+    strokeColor?: string;
+    strokeWidth?: number;
+}): Style;
+/**
+ * 创建线样式
+ */
+declare function createStrokeStyle(options?: {
+    color?: string;
+    width?: number;
+    lineDash?: number[];
+}): Style;
+/**
+ * 创建面样式
+ */
+declare function createFillStyle(options?: {
+    fillColor?: string;
+    strokeColor?: string;
+    strokeWidth?: number;
+}): Style;
+
+type index_DrawOptions = DrawOptions;
+type index_DrawType = DrawType;
+type index_FeatureStyleOptions = FeatureStyleOptions;
+type index_GeoJSONFeature = GeoJSONFeature;
+type index_GeoJSONFeatureItem = GeoJSONFeatureItem;
+type index_IconConfig = IconConfig;
+type index_Layer = Layer;
+type index_MapInstance = MapInstance;
+declare const index_MapInstance: typeof MapInstance;
+type index_MapOptions = MapOptions;
+type index_MapTheme = MapTheme;
+type index_MarkerOptions = MarkerOptions;
+type index_OverlayOptions = OverlayOptions;
+type index_ThemeConfig = ThemeConfig;
+type index_VectorLayerConfig = VectorLayerConfig;
+declare const index_createCircleStyle: typeof createCircleStyle;
+declare const index_createFillStyle: typeof createFillStyle;
+declare const index_createGaodeLayer: typeof createGaodeLayer;
+declare const index_createIconStyle: typeof createIconStyle;
+declare const index_createLineFeature: typeof createLineFeature;
+declare const index_createOSMLayer: typeof createOSMLayer;
+declare const index_createPointFeature: typeof createPointFeature;
+declare const index_createPolygonFeature: typeof createPolygonFeature;
+declare const index_createStrokeStyle: typeof createStrokeStyle;
+declare const index_createStyledLineFeature: typeof createStyledLineFeature;
+declare const index_createStyledPointFeature: typeof createStyledPointFeature;
+declare const index_createStyledPolygonFeature: typeof createStyledPolygonFeature;
+declare const index_createTiandituLayer: typeof createTiandituLayer;
+declare const index_createXYZLayer: typeof createXYZLayer;
+declare const index_lonLatToXY: typeof lonLatToXY;
+declare const index_xyToLonLat: typeof xyToLonLat;
+declare namespace index {
+  export { type index_DrawOptions as DrawOptions, type index_DrawType as DrawType, type index_FeatureStyleOptions as FeatureStyleOptions, type index_GeoJSONFeature as GeoJSONFeature, type index_GeoJSONFeatureItem as GeoJSONFeatureItem, type index_IconConfig as IconConfig, type index_Layer as Layer, index_MapInstance as MapInstance, type index_MapOptions as MapOptions, type index_MapTheme as MapTheme, type index_MarkerOptions as MarkerOptions, type index_OverlayOptions as OverlayOptions, type index_ThemeConfig as ThemeConfig, type index_VectorLayerConfig as VectorLayerConfig, index_createCircleStyle as createCircleStyle, index_createFillStyle as createFillStyle, index_createGaodeLayer as createGaodeLayer, index_createIconStyle as createIconStyle, index_createLineFeature as createLineFeature, index_createOSMLayer as createOSMLayer, index_createPointFeature as createPointFeature, index_createPolygonFeature as createPolygonFeature, index_createStrokeStyle as createStrokeStyle, index_createStyledLineFeature as createStyledLineFeature, index_createStyledPointFeature as createStyledPointFeature, index_createStyledPolygonFeature as createStyledPolygonFeature, index_createTiandituLayer as createTiandituLayer, index_createXYZLayer as createXYZLayer, index_lonLatToXY as lonLatToXY, index_xyToLonLat as xyToLonLat };
+}
+
+export { type DrawOptions as D, type FeatureStyleOptions as F, type GeoJSONFeature as G, type IconConfig as I, type Layer as L, MapInstance as M, type OverlayOptions as O, type ThemeConfig as T, type VectorLayerConfig as V, type DrawType as a, type GeoJSONFeatureItem as b, type MapOptions as c, type MapTheme as d, type MarkerOptions as e, createCircleStyle as f, createFillStyle as g, createGaodeLayer as h, index as i, createIconStyle as j, createLineFeature as k, createOSMLayer as l, createPointFeature as m, createPolygonFeature as n, createStrokeStyle as o, createStyledLineFeature as p, createStyledPointFeature as q, createStyledPolygonFeature as r, createTiandituLayer as s, createXYZLayer as t, lonLatToXY as u, xyToLonLat as x };