@teeechina/teee-map 0.0.36 → 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,1388 @@
+import * as maplibregl from 'maplibre-gl';
+import { SourceSpecification, LayerSpecification, Map as Map$1 } from 'maplibre-gl';
+
+type LayerType = 'background' | 'signal' | 'track' | 'track_circuit' | 'bumper' | 'switch' | 'switch_loc' | 'insulation' | 'label' | 'prevention' | 'sgfhqy' | 'region' | 'display_polygon' | 'display_line' | 'display_point';
+type RegionLayerType = 'background' | 'track' | 'bridge' | 'tunnel' | 'region_signal' | 'curve' | 'floodcontrol' | 'ramp' | 'contactseparation' | 'callpost';
+interface MapForgeConfig {
+    id: string;
+    sourceUrl?: string;
+    subSourceId?: string;
+    subSourceUrl?: string;
+    layers?: (LayerType | RegionLayerType)[];
+    sourceLayers?: string[];
+    type?: 'region' | 'station';
+    zoom?: number;
+}
+interface MapParams {
+    id: string;
+    source: SourceSpecification | SourceSpecification[];
+    subSourceId?: string;
+    subSource?: SourceSpecification;
+    layers?: LayerSpecification[];
+    subLayers?: LayerSpecification[];
+}
+interface IconType {
+    id: string;
+    image: HTMLImageElement;
+}
+
+interface InterlockItem {
+    name: string;
+    state: string;
+}
+interface InterlockData {
+    signalInterlock: InterlockItem[];
+    switchInterlock: InterlockItem[];
+    circuitInterlock: InterlockItem[];
+}
+/**
+ * 信号联锁协议解析器。
+ * 解析格式：时间&站码[&厂家信息]&信号机&道岔&区段
+ */
+declare class InterlockProtocol {
+    signalExist: boolean;
+    productInfo?: string;
+    stationCode?: string;
+    time?: string;
+    private interlockInfo;
+    getProductInfo(): string | undefined;
+    getStCode(): string | undefined;
+    getInterlockInfo(): Map<string, InterlockData>;
+    isSignalExist(): boolean;
+    setYardSignal(signal: string): void;
+    reset(): void;
+    resetInterlockInfo(): void;
+}
+
+interface InsulationSignals {
+    upsignal: string | null;
+    downsignal: string | null;
+}
+/**
+ * 绝缘节与信号机双向映射管理器。
+ * 维护 绝缘节→信号机 和 信号机→绝缘节 两张 Map。
+ */
+declare class InterLockInsulation {
+    /** Map<绝缘节 id, { upsignal, downsignal }> */
+    private insulationSignalMap;
+    /** Map<信号机 id, 绝缘节 id-name> */
+    private signalInsulationMap;
+    /**
+     * 从 maplibre-gl querySourceFeatures 返回的要素数组初始化映射。
+     * @param features 绝缘节图层要素列表
+     */
+    setInsulation(features: maplibregl.GeoJSONFeature[]): void;
+    /** 通过信号机 key 查找对应绝缘节 id-name */
+    getInsulationBySignalKey(signalKey: string): string | undefined;
+    /** 通过绝缘节 id 查找对应信号机 { upsignal, downsignal } */
+    getSignalByInsulationKey(insulationKey: string): InsulationSignals | undefined;
+}
+
+interface InterlockVisualizationOptions {
+    sourceIds?: Record<string, Record<string, string>>;
+    firstSwitches?: string[];
+    updateFeatureState: (code: string | number, state: FeatureState) => void;
+    queryGeojsonFeatures: (key: string) => maplibregl.GeoJSONFeature[];
+    getFeatureState: (code: string | number) => Record<string, unknown>;
+}
+interface FeatureState {
+    [key: string]: unknown;
+    state?: string | number;
+    visiable?: boolean;
+    select?: boolean;
+    link?: number | undefined;
+    controlName?: string;
+}
+declare class InterLockVisualization {
+    private layers;
+    private firstSwitches;
+    private updateFeatureState;
+    private queryGeojsonFeatures;
+    private getFeatureState;
+    private signalStore;
+    private interLockInsulation;
+    /** 当前帧所有联锁状态缓存（信号机/道岔/区段） */
+    private interLockState;
+    /** YD 协议计算白光带时使用的临时数组 */
+    private pathCircuits;
+    private pathCircuitsCodes;
+    private linkWhiteCircuits;
+    /** 控制信号发送 */
+    private signalEnable;
+    private onSendSignal?;
+    private stationSignalState;
+    private filterCodes;
+    constructor(options: InterlockVisualizationOptions);
+    /** 查询指定 source 的所有要素 */
+    private queryFeatures;
+    /** 初始化绝缘节映射 */
+    initInsulation(): void;
+    /**
+     * 处理一帧信号数据字符串。
+     * @param res 原始信号字符串，格式：时间&站码[&厂家信息]&信号机&道岔&区段
+     */
+    handleSignalData(res: string): void;
+    turnOffSignals(): void;
+    private reset;
+    private clearCircuits;
+    private clearSwitchLocs;
+    /**
+     * ZK01 协议可视化（直接设置状态）
+     * @param interlocks InterlockData
+     * @param yardProduct string
+     * @param yardCode string
+     */
+    private visualizeZK;
+    /**
+     * YD 协议可视化（需计算白光带）
+     * @param interlocks InterlockData
+     * @param yardProduct string
+     * @param yardCode string
+     */
+    private visualizeYD;
+    private applyHandSwitchPaths;
+    private findHandSwitchPath;
+    private doseTrackConnectSwitch;
+    private getCircuitState;
+    private findNextCircuit;
+    private getInsulationSignalState;
+    private getControlSignalState;
+    private getSignalFeature;
+    private getSignalById;
+    private getSwitchLocFeatures;
+    private getSwitchFeatures;
+    private getSwitchByCode;
+    private getTrackByCode;
+    private getCircuitFeature;
+    private getSwitchNameByCode;
+    private findSwitchInfo;
+    private validSwitchInfo;
+    private arrToMap;
+    startRunning(): void;
+    stopRunning(): void;
+    /** 设置信号发送回调，回调参数格式与 JS 版 commitManualSignal 一致 */
+    setSendSignalCallback(callback: (dataList: string[]) => void): void;
+    setStationSignalState(stationSignalState: string[], filterCodes?: string[]): void;
+    /**
+     * 将当前 interLockState 中的信号机/道岔/区段状态按协议格式组装并通过回调发送。
+     * 格式：utc&站码&信号机段&道岔段&区段段
+     */
+    sendSignal(): void;
+    /** 暂停信号：将所有缓存状态清零后发送一次清空帧 */
+    pauseSignal(): void;
+    /**
+     * 读取当前 MapLibre 图层 feature state 直接生成信号字符串并发送，不依赖 interLockState 缓存。
+     * 适用于手动修改图层状态后需要立即发送的场景。
+     */
+    collectStateAndSend(): void;
+    /**
+     * 读取当前 MapLibre 图层 feature state 直接生成信号字符串
+     */
+    collectState(): string[];
+}
+
+/**
+ * 地图测量工具（距离 + 面积）
+ *
+ * 使用方式：
+ *   const measureTool = new MeasureTool(map);
+ *   measureTool.startDistance();  // 开始距离测量
+ *   measureTool.startArea();      // 开始面积测量
+ *   measureTool.clear();          // 清除所有测量内容
+ */
+declare class MeasureTool {
+    private static stylesInjected;
+    private map;
+    private active;
+    private jsonPoint;
+    private jsonLine;
+    private points;
+    private tooltip;
+    private markers;
+    private tooltipEle;
+    /** 存储当前绑定的事件处理函数引用，用于 map.off 解绑 */
+    private _onClick;
+    private _onMousemove;
+    private _onContextmenu;
+    constructor(map: maplibregl.Map);
+    /** 注入测量标签样式 */
+    private static injectStyles;
+    /** 获取 GeoJSON 数据源，带类型断言 */
+    private getSource;
+    /** 开始距离测量模式 */
+    startDistance(): void;
+    private bindDistanceEvents;
+    private addDistancePoint;
+    private addMeasureRes;
+    private getLength;
+    /** 开始面积测量模式 */
+    startArea(): void;
+    private bindAreaEvents;
+    private addAreaPoint;
+    private getArea;
+    /** 重置内部状态，解绑事件监听 */
+    private reset;
+    /** 清除所有测量图层、数据源和 DOM 元素 */
+    clear(): void;
+}
+
+/** stashFeatures Map 中存储的要素状态条目 */
+interface StashEntry {
+    sourceLayer: string;
+    [key: string]: unknown;
+}
+/**
+ * 太昌业务地图 SDK 主类。
+ * 基于 maplibre-gl 封装，提供一键式地图初始化、图层管理、要素状态控制、加密瓦片及离线包支持。
+ */
+declare class TeeeMap {
+    /** 底层 maplibre-gl Map 实例 */
+    map: Map$1;
+    /** 地图方向 */
+    mapDir: 'left' | 'right';
+    /** 当前地图的构建参数（由 MapForge 生成） */
+    mapConfigs: MapForgeConfig;
+    mixingMapConfigs: Map<string, MapForgeConfig>;
+    /** 要素缓存池：key 为要素 code，value 为 { sourceLayer, ...state } */
+    stashFeatures: Map<string | number, StashEntry>;
+    /** 测量工具（initMap / initMixMap 时挂载） */
+    measureTool?: MeasureTool;
+    /** 联锁可视化实例（createGraphMap / create*GeoJson*Map 时挂载，可能为 undefined） */
+    interLockVisualization: InterLockVisualization | undefined;
+    /** 拉取指定范围所有瓦片的全部要素并加入缓存（baseTool 挂载） */
+    fetchAllTiles: (zoom?: number) => Promise<void>;
+    /** 添加 GeoJSON 数据源（baseTool 挂载） */
+    addGeoJsonSource: (id: string, data?: GeoJSON.GeoJSON) => void;
+    /** 添加矢量瓦片数据源（baseTool 挂载） */
+    addVectorTileSource: (id: string, url: string) => void;
+    /** 添加栅格瓦片数据源（baseTool 挂载） */
+    addRasterTileSource: (id: string, url: string) => void;
+    /** 更新 GeoJSON 数据源内容（baseTool 挂载） */
+    updateGeoJsonSource: (id: string, data: GeoJSON.GeoJSON) => void;
+    /** 获取 GeoJSON 源当前数据（baseTool 挂载） */
+    getGeoJsonSourceData: (id: string) => GeoJSON.FeatureCollection | null;
+    /** 移除指定数据源（baseTool 挂载） */
+    removeSource: (id: string) => void;
+    /** 添加 GeoJSON 图层（baseTool 挂载） */
+    addGeoJsonLayer: (layerId: string, sourceId: string, type?: 'fill' | 'line' | 'circle' | 'symbol', paint?: Record<string, unknown>, layout?: Record<string, unknown>) => void;
+    /** 动态更新图层 paint 样式（baseTool 挂载） */
+    updateLayerStyle: (layerId: string, paint: Record<string, unknown>) => void;
+    /** 移除指定图层（baseTool 挂载） */
+    removeLayer: (layerId: string) => void;
+    /** 为指定图层绑定要素点击事件（baseTool 挂载） */
+    onFeatureClick: (layerIds: string | string[], callback: (feature: maplibregl.MapGeoJSONFeature, lngLat: maplibregl.LngLat) => void) => void;
+    /** 为指定要素初始化业务状态（graphLayerTool 挂载） */
+    initGraphFeatureState?: (f: maplibregl.GeoJSONFeature) => void;
+    /** 为指定要素初始化 GeoJSON 图层业务状态（geojsonLayerTool 挂载） */
+    initGeoJsonFeatureState?: (f: maplibregl.GeoJSONFeature, layerType: string) => void;
+    /** 初始化全部 GeoJSON 图层业务状态（geojsonLayerTool 挂载） */
+    initGeoJsonState?: () => void;
+    /** 初始化混合地图 GeoJSON 图层业务状态（geojsonLayerTool 挂载） */
+    initMixGeoJsonMapState?: () => void;
+    /** GeoJSON 图层要素缓存：key 为图层名，value 为该图层所有 GeoJSONFeature */
+    private layerFeaturesCache;
+    /** 当前活跃的闪烁动画清理函数，新的闪烁触发前自动清除旧的，确保新要素能正常闪烁 */
+    private _activeBlinkCleanup;
+    /**
+     * 要素缓存（stashFeatures）就绪信号。
+     * 每次 initMap / initMixMap 开始构建时重建，stash 完成后 resolve。
+     * 调用方通过 whenStashed() 等待，避免在缓存为空时调用 initGeoJsonState 而静默失效。
+     */
+    private _stashReady;
+    private _stashReadyResolve;
+    private _stashReadyReject;
+    /**
+     * 创建 TeeeMap 实例。
+     * @param container - 地图容器 DOM 元素或其 ID
+     */
+    constructor(container: string | HTMLElement);
+    /**
+     * 获取底层 maplibre-gl Map 实例。
+     * @returns maplibre Map 实例
+     */
+    getMap(): Map$1;
+    /**
+     * 获取当前地图的配置对象。
+     * @returns MapForgeConfig
+     */
+    getMapConfigs(): MapForgeConfig;
+    /**
+     * 销毁地图实例并释放所有资源。
+     * 清理闪烁动画、事件监听、内部缓存及底层 maplibre-gl Map 实例。
+     */
+    destroy(): void;
+    /**
+     * 重置要素缓存就绪信号。必须在每次地图构建的同步段调用，
+     * 保证调用方拿到的 whenStashed() 对应的是本轮构建。
+     */
+    private resetStashReady;
+    /** 标记要素缓存已就绪，唤醒所有 whenStashed() 等待方。 */
+    private markStashReady;
+    /**
+     * 使当前的要素缓存就绪信号失败，并唤醒所有 whenStashed() 等待方（以 reject 结束）。
+     * 地图实例被销毁（destroy）时调用，避免等待方永久挂起。
+     */
+    invalidateStashReady(reason?: string): void;
+    /**
+     * 等待要素缓存（stashFeatures）就绪。
+     *
+     * 地图构建是异步的：source/layer 注册 → 首次 idle → stashAllFeature 填充缓存。
+     * 在缓存就绪前调用 initGeoJsonState / initMixGeoJsonMapState 会因遍历空 Map 而
+     * 静默失效（不报错、不生效），因此调用方应先 await 本方法。
+     *
+     * @param timeout - 超时毫秒数，默认 30000。超时后 reject，避免调用方永久挂起；传 0 表示不限时。
+     * @returns 缓存就绪时 resolve；超时或地图被销毁时 reject
+     */
+    whenStashed(timeout?: number): Promise<void>;
+    /**
+     * 注册要素缓存就绪回调（事件风格 API，内部等价于 whenStashed().then(cb)）。
+     * 多次注册都会在缓存就绪后执行；缓存已就绪时注册会立即（微任务）执行。
+     * @param cb - 缓存就绪后执行的回调
+     * @param onError - 等待失败（超时/地图销毁）或回调执行抛错时的处理函数，缺省时打印错误日志
+     */
+    onStashReady(cb: () => void, onError?: (err: unknown) => void): void;
+    /**
+     * 核心地图构建方法。
+     * 注册主源、附源、图标及图层，并在首次 idle 后自动缓存要素。
+     * @param mapParams - 地图初始化参数（源、图层、ID 等）
+     * @param mixingMap - 是否是同时加载区间与站场
+     */
+    initMap(mapParams: MapParams, mixingMap?: boolean): void;
+    /**
+     * 创建混合地图（区间 + 站场）。
+     * @param mapParams 地图初始化参数（源、图层、ID 等）
+     */
+    initMixMap(mapParams: MapParams[]): void;
+    /**
+     * 创建人员定位图（RSWP）。
+     * 由影像栅格底图 + GeoJSON 附源构成，用于人员/机车定位场景。
+     * @param url - 栅格影像瓦片地址
+     */
+    createRSWPMap(url: string): void;
+    /**
+     * 创建普通站场平面图（Graph）。
+     * @param stcode - 车站编码
+     * @param url - 矢量瓦片服务地址
+     * @param layers - 需要加载的图层类型列表
+     */
+    createGraphMap(stcode: string, url: string, layers: LayerType[]): void;
+    createSscsGraphMap(url: string): void;
+    /**
+     * 设置 sscs 点要素的业务状态（与 createSscsGraphMap 配套使用）。
+     * @param code - 要素code（即瓦片 promoteId 对应属性 code 的值）
+     * @param state - 业务状态，需包含在 createSscsGraphMap 传入的 pointStateStyles 中，否则回退默认色
+     */
+    setSscsPointState(code: string | number, state: string): void;
+    /**
+     * 创建地理图（Geom）。
+     * @param stcode - 车站编码
+     * @param url - 矢量瓦片服务地址
+     * @param layers - 需要加载的图层类型列表
+     */
+    createGeomMap(stcode: string, url: string, layers: LayerType[]): void;
+    /**
+     * 创建加密地理图。
+     * 自动注入瓦片解密转换器，其余逻辑同 createGeomMap。
+     * @param stcode - 车站编码
+     * @param url - 加密矢量瓦片服务地址
+     * @param layers - 需要加载的图层类型列表
+     */
+    createGeomEncryptedMap(stcode: string, url: string, layers: LayerType[]): void;
+    /**
+     * 创建 GeoJSON 站场地理图。
+     * 每个图层类型对应一个独立的 GeoJSON source，数据通过 URL 数组传入。
+     * @param stationDatas - 需要加载的图层类型与geojson数据列表
+     * @param showImage - 是否加载高德影像底图
+     */
+    createGeoJsonGeomStationMap(stationDatas: {
+        name: string;
+        data: GeoJSON.FeatureCollection | string;
+    }[], showImage?: boolean): Promise<void>;
+    /**
+     * 创建geojson数据来源的站场区间平面地图
+     * @param mapDatas
+     * @returns
+     */
+    createMixGeoJsonGeomMap(mapDatas: {
+        code: string;
+        type: 'region' | 'station';
+        geojsonData: {
+            name: string;
+            data: GeoJSON.FeatureCollection | string;
+        }[];
+    }[], showImage?: boolean): Promise<void>;
+    /**
+     * 创建 GeoJSON 站场平面图。
+     * 每个图层类型对应一个独立的 GeoJSON source，数据通过 URL 数组传入。
+     * @param stationDatas - 需要加载的图层类型与geojson数据列表
+     */
+    createGeoJsonStationMap(stationDatas: {
+        name: string;
+        data: GeoJSON.FeatureCollection | string;
+    }[]): Promise<void>;
+    /**
+     * 创建 GeoJson 区间平面图
+     * @param regionCode 区间code
+     * @param regionDatas 区间数据
+     */
+    createGeoJsonRegionMap(regionCode: string, regionDatas: {
+        name: string;
+        data: GeoJSON.FeatureCollection | string;
+    }[]): Promise<void>;
+    /**
+     * 创建geojson数据来源的站场区间平面地图
+     * @param mapDatas
+     * @returns
+     */
+    createMixGeoJsonMap(mapDatas: {
+        code: string;
+        type: 'region' | 'station';
+        geojsonData: {
+            name: string;
+            data: GeoJSON.FeatureCollection | string;
+        }[];
+        deltaInfo?: {
+            deltax: number;
+            deltay: number;
+        };
+    }[]): Promise<void>;
+    /**
+     * 创建影像图 / 栅格底图。
+     * @param url - 栅格瓦片服务地址
+     */
+    createRasterMap(url: string): void;
+    /**
+     * 创建加密栅格地图。
+     * 自动注入瓦片解密转换器。
+     * @param url - 加密栅格瓦片服务地址
+     */
+    createEncryptedRasterMap(url: string): void;
+    /**
+     * 缓存当前视口内的全部要素信息。
+     * key 为要素 properties.code，value 包含 sourceLayer 及后续状态。
+     * 地图首次 idle 后自动执行，也可手动调用刷新缓存。
+     */
+    stashMixMapAllFeature(): Promise<void>;
+    /**
+     * 缓存当前视口内的全部要素信息。
+     * key 为要素 properties.code，value 包含 sourceLayer 及后续状态。
+     * 地图首次 idle 后自动执行，也可手动调用刷新缓存。
+     */
+    stashAllFeature(): Promise<void>;
+    /**
+     * 更新指定要素的业务状态。
+     * 状态会合并到 stashFeatures 缓存中，并同步调用 map.setFeatureState。
+     * 同时兼容矢量瓦片源（带 sourceLayer）和 GeoJSON 源（sourceLayer 即为 sourceId）。
+     * @param code - 要素唯一编码
+     * @param state - 状态对象（如 { state: '1', select: true }）
+     */
+    updateFeatureState(code: string | number, state: Record<string, unknown>): void;
+    /**
+     * 根据要素编码获取要素当前状态。
+     * @param code 要素编码
+     * @returns
+     */
+    getFeatureState(code: string | number): StashEntry | undefined;
+    /**
+     * 定位 geojson 数据
+     * @param data GeoJSON FeatureCollection
+     */
+    locateGeojsonFeature(data: GeoJSON.FeatureCollection, transform?: boolean): void;
+    /**
+     * 查询 geojson 图层所有 feature 要素
+     * @param key 图层名称
+     * @returns geojson 图层所有 feature 要素
+     */
+    queryGeojsonFeatures(key: string): maplibregl.GeoJSONFeature[];
+    /**
+     * 根据要素编码获取要素 feature
+     * @param circuitCodes 电路区段要素 codes
+     * @returns 电路区段要素
+     */
+    getTrackCircuitFeaturesByCodes(circuitCodes: string[]): maplibregl.GeoJSONFeature[];
+    /**
+     * 根据要素编码获取要素 feature
+     * @param code 要素 code
+     * @param layerType 图层类型
+     * @returns 要素 feature
+     */
+    getGeojsonLayerFeaturesByCode(code: string, layerType: LayerType): maplibregl.GeoJSONFeature | undefined;
+    /**
+     * 根据要素编码与图层类型将地图缩放至该要素位置。
+     * 内部复用 getGeojsonLayerFeaturesByCode 获取要素后，通过 bbox + fitBounds 定位。
+     * @param code - 要素 code
+     * @param layerType - 图层类型
+     */
+    locateFeatureByCode(code: string, layerType: LayerType): void;
+    /**
+     * 要素平滑闪烁高亮。
+     * 在指定 source 上添加临时图层，通过正弦动画实现周期性显隐效果，动画结束后自动清理。
+     * - featureType='line'：添加 fill + line-outline 双图层，交替透明度与描边宽度
+     * - featureType='point'：添加 symbol 图层，通过 canvas 动态生成圆形图标，交替 icon-opacity
+     * 返回清理函数，可用于提前终止动画并移除临时图层。
+     * @param sourceId - 数据源 ID
+     * @param featureFilter - 要素筛选条件（maplibre-gl filter 表达式）
+     * @param featureType - 要素类型，'line' 使用填充+描边闪烁，'point' 使用图标闪烁
+     * @param options - 动画参数（duration/blinkSpeed/baseColor/minAlpha/maxAlpha 等）
+     * @returns 清理函数，调用后可提前终止闪烁并移除临时图层
+     */
+    smoothBlinkFeature(code: string, layerType: LayerType, options?: {
+        /** 总动画时长（ms），默认 3000 */
+        duration?: number;
+        /** 闪烁周期（ms），默认 500 */
+        blinkSpeed?: number;
+        /** RGB 颜色三元组，默认 [0, 255, 0] */
+        baseColor?: [number, number, number];
+        /** 最小透明度，默认 0.3 */
+        minAlpha?: number;
+        /** 最大透明度，默认 0.7 */
+        maxAlpha?: number;
+        /** 描边基础宽度，默认 3 */
+        strokeWidthBase?: number;
+        /** 描边宽度变化范围，默认 2 */
+        strokeWidthRange?: number;
+    }): (() => void) | undefined;
+}
+
+/**
+ * 站场要素代码定义
+ * 是地图数据库内部定义，与防控类型不完全相同，且存在部分独有的类型定义如display图层相关的仅显示要素
+ */
+declare enum StationFeatureCodeEnums {
+    /**
+     * 股道
+     */
+    TRACK = 1,
+    /**
+     * 道岔
+     */
+    SWITCH = 2,
+    /**
+     * 信号机
+     */
+    SIGNAL = 3,
+    /**
+     * 土挡
+     */
+    BUMPER = 4,
+    /**
+     * 警冲标
+     */
+    FOULINGPOST = 5,
+    /**
+     * 接触网终点
+     */
+    CONTACTLINEEND = 6,
+    /**
+     * 道口
+     */
+    RAILWAYCROSS = 7,
+    /**
+     * 道岔连接部件
+     */
+    SWITCHCONNECTINGCOMPONENTS = 11,
+    /**
+     * 轨道电路区段
+     */
+    TRACKCIRCUIT = 12,
+    /**
+     * 区间股道元素
+     */
+    Intervaltrackelements = 20,
+    /**
+     * 区间股道
+     */
+    Intervaltrack = 21,
+    /**
+     * 桥梁
+     */
+    BRIDGE = 22,
+    /**
+     * 隧道
+     */
+    TUNNEL = 29,
+    /**
+     * 出库点
+     */
+    OUTBOUND = 34,
+    /**
+     * 隔离开关
+     */
+    ISOLATE = 35,
+    /**
+     * 存车股道
+     */
+    PARKTRACK = 36,
+    /**
+     * 按钮
+     */
+    BUTTON = 37,
+    /**
+     * 预告无网区
+     */
+    PREVIEWNOWIRE = 42,
+    /**
+     * 脱轨器（上脱）
+     */
+    TGQ_UP = 47,
+    /**
+     * 脱轨器（下脱）
+     */
+    TGQ_DOWN = 48,
+    /**
+     * 无电（通过隔离开关或手动选择线段）
+     */
+    NOELECTRICITY = 49,
+    /**
+     * 站界
+     */
+    STATIONBOUND = 51,
+    /**
+     * 绝缘节
+     */
+    INSULATION = 52,
+    /**
+     * 脱轨器
+     */
+    DERAILING_STOP = 53,
+    /**
+     * 接触网禁停区
+     */
+    CONTACTLINENOPARK = 54,
+    /**
+     * 一度停车
+     */
+    ONCESTOP = 55,
+    /**
+     * 限速区段
+     */
+    SPEEDLIMIT = 56,
+    /**
+     * 接触网分相区
+     */
+    CONTACTLINEPSS = 57,
+    /**
+     * 无网区
+     */
+    CONTACTLINENOAREA = 58,
+    /**
+     * 其他不控车防控点
+     */
+    NOCONTROLPOINT = 59,
+    /**
+     * 高站台
+     */
+    HIGHPLATFORM = 60,
+    /**
+     * 标注：方形按钮
+     */
+    MARK_SQUAREBTN = 62,
+    /**
+     * 标注：箭头
+     */
+    MARK_ARROW = 63,
+    /**
+     * 标注：小矩形框
+     */
+    MARK_RECT = 64,
+    /**
+     * 高站台平面图展示辅助线
+     */
+    HIGHPLATFORMLINE = 65,
+    /**
+     * 驼峰溜放标志
+     */
+    HUMPSLIP = 66,
+    /**
+     * 通道门
+     */
+    CHANNELDOOR = 67,
+    /**
+     * 天窗区域
+     */
+    SKYLIGHTAREA = 68,
+    /**
+     * 行走线
+     */
+    WALKWAY = 69,
+    /**
+     * 肩章动态范围
+     */
+    SHOULDERDYNAMIC = 70,
+    /**
+     * 水阻台
+     */
+    WATERBRAKE = 71,
+    /**
+     * 内燃机车库
+     */
+    DIESELDEPOT = 72,
+    /**
+     * 小辅修库
+     */
+    AUXREPAIRDEPOT = 73,
+    /**
+     * 镟轮库
+     */
+    WHEELLATHEDEPOT = 74,
+    /**
+     * 启机棚
+     */
+    STARTSHED = 75,
+    /**
+     * 中修库
+     */
+    OVERHAULDEPOT = 76,
+    /**
+     * 台位
+     */
+    BERTH = 77,
+    /**
+     * 图例
+     */
+    LEGEND = 78,
+    /**
+     * 肩章静态范围
+     */
+    SHOULDERSTATIC = 79,
+    /**
+     * 施工安全等待区
+     */
+    WORKWAITAREA = 80,
+    /**
+     * 墙/围栏
+     */
+    FENCE = 81,
+    /**
+     * 施工防护区域
+     */
+    WORKPROTECTAREA = 82,
+    /**
+     * 区间道口
+     */
+    INTERVALCROSS = 83,
+    /**
+     * 接触网杆
+     */
+    CONTACTLINEPOLE = 86,
+    /**
+     * 大门
+     */
+    DOOR = 87,
+    /**
+     * 遮挡物/雨棚
+     */
+    CANOPY = 88,
+    /**
+     * (区间)接触网分相
+     */
+    INTERVALCONTACTLINEPSS = 89,
+    /**
+     * 区间通话柱
+     */
+    INTERVALCALLPOLE = 90,
+    /**
+     * 曲线
+     */
+    CURVE = 91,
+    /**
+     * 防洪
+     */
+    FLOODCONTROL = 92,
+    /**
+     * (区间)信号机
+     */
+    INTERVALSIGNAL = 93,
+    /**
+     * 坡道
+     */
+    SLOPE = 94,
+    /**
+     * 区间断链点
+     */
+    INTERVALCHAINBREAK = 95,
+    /**
+     * 路网辅助点
+     */
+    ROADNETAUX = 96,
+    /**
+     * 标注
+     */
+    MARK = 97,
+    /**
+     * 辅助点
+     */
+    AUXPOINT = 98,
+    /**
+     * 逻辑点
+     */
+    LOGICPOINT = 99
+}
+
+/**
+ * 联锁信号机状态定义
+ * 与服务器返回的联锁信号机状态保持一致
+ */
+declare enum InterLockSignalStateEnums {
+    /**
+     * 红灯
+     */
+    RedLight = 1,
+    /**
+     * 绿灯
+     */
+    GreenLight = 2,
+    /**
+     * 白灯
+     */
+    WhiteLight = 3,
+    /**
+     * 蓝灯
+     */
+    BlueLight = 4,
+    /**
+     * 未知
+     */
+    Unknown = 5
+}
+declare enum SignalColorEnums {
+    Red = "red",
+    Green = "green",
+    Blue = "blue",
+    White = "white"
+}
+/**
+ * 联锁电路区段状态定义
+ * 增加一个5 用于展示非集中区进路
+ * @type {Array}
+ */
+declare enum InterLockCircuitStateEnums {
+    /**
+     * 红色电路
+     */
+    RedCircuit = 1,
+    /**
+     * 白色电路
+     */
+    WhiteCircuit = 2,
+    /**
+     * 等效红色电路
+     */
+    EqualRedCircuit = 3,
+    /**
+     * 灰色电路
+     */
+    GreyCircuit = 4,
+    /**
+     * 绿色电路
+     */
+    GreenCircuit = 5
+}
+/**
+ * 联锁道岔状态定义
+ *
+ */
+declare enum InterLockSwitchlocStateEnums {
+    /**
+     * 定位
+     */
+    NormalPosition = 2,
+    /**
+     * 反位
+     */
+    ReversePosition = 3,
+    /**
+     * 四开位
+     */
+    NeutralPosition = 4
+}
+/**
+ * 闭塞信号状态定义
+ *  0接车绿色 1 接车黄色 2接车红色 3发车绿色 4发车黄色 5 发车红色 6闭塞 7事故 8复原
+ */
+declare enum BsSignalStateEnums {
+    COME_GREEN = 0,
+    COME_YELLOW = 1,
+    COME_RED = 2,
+    GO_GREEN = 3,
+    GO_YELLOW = 4,
+    GO_RED = 5,
+    LOCK = 6,
+    EMERGENCY = 7,
+    RESET = 8
+}
+
+/**
+ * 防控类型定义
+ * 与服务器返回的防控类型保持一致
+ */
+declare enum PreventionEnums {
+    /**
+     * 空防控点
+     */
+    NULL = 0,
+    /**
+     * 土档
+     */
+    BUMPER = 1,
+    /**
+     * 接触网终点
+     */
+    CONTACTLINEEND = 2,
+    /**
+     * 固定脱轨器
+     */
+    FIXEDDERAILER = 3,
+    /**
+     * 禁停区
+     */
+    CONTACTLINENOSTOP = 4,
+    /**
+     * 禁停区内部
+     */
+    CONTACTLINENOSTOPIN = 5,
+    /**
+     * 其他不控车防控点
+     */
+    OTHERPROMPT = 6,
+    /**
+     * 其他控车防控点
+     */
+    OTHERBRAKE = 7,
+    /**
+     * 一度停车
+     */
+    ONESTOP = 8,
+    /**
+     * 限速区
+     */
+    SPEEDLIMITED = 9,
+    /**
+     * 限速预警提示
+     */
+    SPEEDNOTICE = 10,
+    /**
+     * 道岔限速提示区
+     */
+    CROSSSPEEDLIMITED = 11,
+    /**
+     * 分相区
+     */
+    CONTACTLINEPSS = 12,
+    /**
+     * 特殊发码信号机
+     */
+    SSG = 13,
+    /**
+     * 分相区内部，暂时无语音提示
+     */
+    CONTACTLINEPSSIN = 14,
+    /**
+     * 无网区
+     */
+    CONTACTLINENOAREA = 15,
+    /**
+     * 高柱信号机
+     */
+    HIGHPOSTSIGNAL = 16,
+    /**
+     * 救援机车
+     */
+    RESCUEVEHICLE = 17,
+    /**
+     * 道口
+     */
+    RAILWAYCROSS = 18,
+    /**
+     * 机车
+     */
+    TRAIN = 19,
+    /**
+     * 站界
+     */
+    STATIONBOUND = 20,
+    /**
+     * 矮柱信号机
+     */
+    SHORTPOSTSIGNAL = 21,
+    /**
+     * 桥
+     */
+    BRIDGE = 22,
+    /**
+     * 白
+     */
+    WHITE = 23,
+    /**
+     * 白蓝
+     */
+    WHITEBLUE = 24,
+    /**
+     * 蓝
+     */
+    BLUE = 25,
+    /**
+     * 蓝白
+     */
+    BLUEWHITE = 26,
+    /**
+     * 坡
+     */
+    SLOPE = 27,
+    /**
+     * 人员
+     */
+    PEOPLE = 28,
+    /**
+     * 隧道
+     */
+    TUNNEL = 29,
+    /**
+     * 危险区
+     */
+    DANGER = 30,
+    /**
+     * 信号机
+     */
+    SIGNAL = 31,
+    /**
+     * 转弯
+     */
+    SWERVE = 32,
+    /**
+     * 道岔
+     */
+    SWITCH = 33,
+    /**
+     * 警冲标
+     */
+    FOULINGPOST = 38,
+    /**
+     * 股道存车
+     */
+    CUNCHE = 39,
+    /**
+     * 调车边界
+     */
+    STATIONBOUNDEXTEND = 40,
+    /**
+     * 红
+     */
+    RED = 41,
+    /**
+     * 绿
+     */
+    GREEN = 42,
+    /**
+     * 黄
+     */
+    YELLOW = 43,
+    /**
+     * 封锁区
+     */
+    BLOCKLINE = 50,
+    /**
+     * 施工区
+     */
+    WORKAREA = 51,
+    /**
+     * 施工路径
+     */
+    ROUTELINE = 52,
+    /**
+     * 停车点
+     */
+    PARK = 53,
+    /**
+     * 施工区边界
+     */
+    WORKBUOND = 54,
+    /**
+     * 施工区终点
+     */
+    WORKBUONDCROSS = 55,
+    /**
+     * 虚拟站界
+     */
+    VIRTUALSTATIONBOUND = 56,
+    /**
+     * 左侧高站台
+     */
+    LEFTHIGHPLATFORM = 61,
+    /**
+     * 右侧高站台
+     */
+    RIGHTHIGHPLATFORM = 62,
+    /**
+     * 两侧高站台
+     */
+    BOTHSIDEHIGHPLATFORM = 63,
+    /**
+     * 脱轨器
+     */
+    TGQ = 47,
+    /**
+     * 大门
+     */
+    DOOR = 87,
+    /**
+     * 其他
+     */
+    OTHER = 95,
+    /**
+     * 补机
+     */
+    SIDE = 253,
+    /**
+     * 无地图
+     */
+    NONE = 254,
+    /**
+     * 最大值
+     */
+    MAX = 255,
+    /**
+     * 隔离
+     */
+    ISOLATE = 35,
+    /**
+     * 防护道岔
+     */
+    ISOLATESWITCH = 100
+}
+
+/**
+ * 联锁信号机状态对应颜色 map 定义
+ */
+declare const INTERLOCK_SIGNAL_MAP: Record<InterLockSignalStateEnums, string | null>;
+/**
+ * 联锁信号机状态对应颜色 map 定义
+ */
+declare const INTERLOCK_SIGNAL_COLOR_MAP: Record<number, SignalColorEnums>;
+/**
+ * 联锁电路区段状态对应颜色 map 定义
+ */
+declare const INTERLOCK_CIRCUIT_MAP: Record<InterLockCircuitStateEnums, string | null>;
+/**
+ * 联锁道岔状态对应颜色 map 定义
+ */
+declare const INTERLOCK_SWITCHLOC_MAP: Record<InterLockSwitchlocStateEnums, string>;
+/**
+ * 闭塞信号状态对应颜色 map 定义
+ */
+declare const BS_SIGNAL_MAP: Record<BsSignalStateEnums, string | null>;
+
+/**
+ * 站场地图基础颜色定义
+ */
+declare const MapColor: {
+    readonly BASE_COLOR: "rgb(85,120,182)";
+    readonly BG_COLOR: "rgb(0,0,0)";
+};
+
+/**
+ * 防控类型对应名称与别名定义
+ */
+declare const PREVENTION_TYPES: Record<PreventionEnums, {
+    name: string;
+    alias: string;
+}>;
+
+/** * 生成铁鞋的canvas
+ * @param width 铁鞋宽度
+ * @param height 铁鞋高度
+ * @param direction 铁鞋方向 right/left
+ * @param color 颜色
+ * @returns
+ */
+declare const createIronShoesCanvas: (direction: string, color: string) => HTMLCanvasElement;
+/**
+ * 人力制动器 26*26 圆形底座加叉 手闸
+ * @param color
+ * @returns
+ */
+declare const createManualBrakingCanvas: (color: string) => HTMLCanvasElement;
+/**
+ * 紧固器符号
+ * @param color 颜色
+ * @param text 名称，也可以设置在外style
+ * @returns
+ */
+declare const createFastenerCanvas: (color: string, text?: string) => HTMLCanvasElement;
+
+/**
+ * 生成信号机的canvas
+ * @param stype 1=高柱 2=矮柱
+ * @param color 状态颜色
+ * @param positionSide 左右手 1=左手 2=右手
+ * @returns
+ */
+declare const createSignalCanvas: (stype: number, color: string, positionSide: number) => HTMLCanvasElement;
+/**
+ * 创建土档canvas
+ * @returns
+ */
+declare const createBumperCanvas: () => HTMLCanvasElement;
+declare const createOverLimitCanvas: () => HTMLCanvasElement;
+
+/**
+ * 创建接触网终点的canvas
+ * @returns
+ */
+declare const createCatenaryEndCanvas: () => HTMLCanvasElement;
+
+/**
+ * 创建脱轨器canvas
+ * @returns
+ */
+declare const createDerailingStopCanvas: () => HTMLCanvasElement;
+/**
+ * 创建自动脱轨器canvas
+ * @param dir 方向 1：左侧（成都） 2：右侧（重庆）
+ * @returns
+ */
+declare const createAutoDerailingStopCanvas: (dir: number) => HTMLCanvasElement;
+
+/**
+ * 创建大门的canvas图标，外部显示时要考虑与股道的垂直角度
+ * @param stateColor 状态颜色
+ * @returns
+ */
+declare const createTrackDoorCanvas: (stateColor: string) => HTMLCanvasElement;
+
+/**
+ * 生成机车图标
+ * @type {[type]}
+ */
+declare const createLocomotiveImg: (opt_options?: Record<string, unknown>, deltaX?: number) => HTMLCanvasElement;
+/**
+ * 生成虚拟本务机图标
+ * @type {[type]}
+ */
+declare const createJflcLocomotiveImg: (opt_options?: Record<string, unknown>, rotate?: boolean) => HTMLCanvasElement;
+/**
+ * 创建未知方向的虚拟机车
+ * @param opt_options
+ * @returns
+ */
+declare const createUnknowJflcLocomotiveImg: (opt_options?: Record<string, unknown>) => HTMLCanvasElement;
+
+declare const index$1_createAutoDerailingStopCanvas: typeof createAutoDerailingStopCanvas;
+declare const index$1_createBumperCanvas: typeof createBumperCanvas;
+declare const index$1_createCatenaryEndCanvas: typeof createCatenaryEndCanvas;
+declare const index$1_createDerailingStopCanvas: typeof createDerailingStopCanvas;
+declare const index$1_createFastenerCanvas: typeof createFastenerCanvas;
+declare const index$1_createIronShoesCanvas: typeof createIronShoesCanvas;
+declare const index$1_createJflcLocomotiveImg: typeof createJflcLocomotiveImg;
+declare const index$1_createLocomotiveImg: typeof createLocomotiveImg;
+declare const index$1_createManualBrakingCanvas: typeof createManualBrakingCanvas;
+declare const index$1_createOverLimitCanvas: typeof createOverLimitCanvas;
+declare const index$1_createSignalCanvas: typeof createSignalCanvas;
+declare const index$1_createTrackDoorCanvas: typeof createTrackDoorCanvas;
+declare const index$1_createUnknowJflcLocomotiveImg: typeof createUnknowJflcLocomotiveImg;
+declare namespace index$1 {
+  export { index$1_createAutoDerailingStopCanvas as createAutoDerailingStopCanvas, index$1_createBumperCanvas as createBumperCanvas, index$1_createCatenaryEndCanvas as createCatenaryEndCanvas, index$1_createDerailingStopCanvas as createDerailingStopCanvas, index$1_createFastenerCanvas as createFastenerCanvas, index$1_createIronShoesCanvas as createIronShoesCanvas, index$1_createJflcLocomotiveImg as createJflcLocomotiveImg, index$1_createLocomotiveImg as createLocomotiveImg, index$1_createManualBrakingCanvas as createManualBrakingCanvas, index$1_createOverLimitCanvas as createOverLimitCanvas, index$1_createSignalCanvas as createSignalCanvas, index$1_createTrackDoorCanvas as createTrackDoorCanvas, index$1_createUnknowJflcLocomotiveImg as createUnknowJflcLocomotiveImg };
+}
+
+/**
+ * 创建信号图标
+ * @returns Promise<HTMLImageElement>
+ */
+declare const createSignalIcon: (type?: string, dir?: string, color?: string) => Promise<HTMLImageElement>;
+/**
+ * 创建接触网图标
+ * @returns Promise<HTMLImageElement>
+ */
+declare const createJcwIcon: () => Promise<HTMLImageElement>;
+/**
+ * 创建土挡图标
+ * @returns Promise<HTMLImageElement>
+ */
+declare const createBumperIcon: () => Promise<HTMLImageElement>;
+/**
+ * 创建大门图标
+ * @returns Promise<HTMLImageElement>
+ */
+declare const createDoorIcon: () => Promise<HTMLImageElement>;
+/**
+ * 脱轨器图标
+ * @returns Promise<HTMLImageElement>
+ */
+declare const createDerailingStopIcon: () => Promise<HTMLImageElement>;
+/**
+ * 创建侵限绝缘图标
+ * @returns Promise<HTMLImageElement>
+ */
+declare const createOverLimitIcon: () => Promise<HTMLImageElement>;
+
+declare const createAllIcons: () => Promise<IconType[]>;
+
+declare const index_createAllIcons: typeof createAllIcons;
+declare const index_createBumperIcon: typeof createBumperIcon;
+declare const index_createDerailingStopIcon: typeof createDerailingStopIcon;
+declare const index_createDoorIcon: typeof createDoorIcon;
+declare const index_createJcwIcon: typeof createJcwIcon;
+declare const index_createOverLimitIcon: typeof createOverLimitIcon;
+declare const index_createSignalIcon: typeof createSignalIcon;
+declare namespace index {
+  export { index_createAllIcons as createAllIcons, index_createBumperIcon as createBumperIcon, index_createDerailingStopIcon as createDerailingStopIcon, index_createDoorIcon as createDoorIcon, index_createJcwIcon as createJcwIcon, index_createOverLimitIcon as createOverLimitIcon, index_createSignalIcon as createSignalIcon };
+}
+
+/**
+ * 将 3857 坐标系的 geojson 数据转换为 4326 坐标系的 geojson 数据
+ * @param geojson 3857 坐标系的 GeoJSON
+ * @returns 4326 坐标系的 GeoJSON
+ */
+declare const transformGeoJsonFrom3857: (geojson: GeoJSON.FeatureCollection) => GeoJSON.FeatureCollection;
+/**
+ * 处理兼容关键属性字段
+ * @param layerName 图层名称 LayerType
+ * @param geojson 4326 坐标系的 GeoJSON
+ * @returns
+ */
+declare const transformGeoJsonProperties: (layerName: string, geojson: GeoJSON.FeatureCollection) => void;
+/**
+ * 对 FeatureCollection 中所有坐标施加 x/y 偏移
+ * @param {GeoJSON.FeatureCollection} featureCollection
+ * @param {number} offsetX - 经度方向偏移量
+ * @param {number} offsetY - 纬度方向偏移量
+ * @returns {GeoJSON.FeatureCollection} 新的 FeatureCollection
+ */
+declare function offsetFeatureCollection(featureCollection: GeoJSON.FeatureCollection, offsetX: number, offsetY: number): GeoJSON.FeatureCollection;
+
+type LineGeometry = GeoJSON.LineString | GeoJSON.MultiLineString;
+interface AttachTrackAngleOptions {
+    /** vector / geojson source id */
+    sourceId: string;
+    /** 点要素所在 source-layer（如 prevention） */
+    pointSourceLayer: string;
+    /** 股道 source-layer */
+    trackSourceLayer: string;
+    /** 写入 icon-rotate 的 symbol 图层 id */
+    layerId: string;
+    /** 接口要素（需含 code、trackCode / track_code） */
+    controlFeatures: GeoJSON.Feature[];
+    /** 过滤要算角的点要素；不传则该 source-layer 下所有 Point 都算 */
+    filterPoint?: (feature: maplibregl.GeoJSONFeature) => boolean;
+    /**
+     * 角度偏移（度），默认 0。
+     * 图标默认水平且需垂直于股道时一般为 0；若图标默认朝向不同可传 ±90。
+     */
+    angleOffset?: number;
+    layerSuffix?: string;
+}
+/**
+ * 计算点在折线上的股道方位角（度）。
+ * 与 MapLibre `icon-rotate` + `icon-rotation-alignment: 'map'` 一致：相对正北顺时针。
+ * 图标默认水平时，该角即垂直于股道。
+ */
+declare const getTrackBearing: (lineGeom: LineGeometry, pointGeom: GeoJSON.Point) => number;
+/**
+ * 按 control.trackCode 关联股道，计算点要素旋转角，写入目标 symbol 层的 icon-rotate。
+ * layout 不支持 feature-state，故用 match + feature id（需 source promoteId: 'code'）。
+ *
+ * 可用于大门、接触网终点等需按股道定向的点图层。
+ */
+declare const attachTrackAngle: (map: Map$1, options: AttachTrackAngleOptions) => void;
+
+export { type AttachTrackAngleOptions, BS_SIGNAL_MAP, BsSignalStateEnums, type FeatureState, INTERLOCK_CIRCUIT_MAP, INTERLOCK_SIGNAL_COLOR_MAP, INTERLOCK_SIGNAL_MAP, INTERLOCK_SWITCHLOC_MAP, type InsulationSignals, InterLockCircuitStateEnums, InterLockInsulation, InterLockSignalStateEnums, InterLockSwitchlocStateEnums, InterLockVisualization, type InterlockData, type InterlockItem, InterlockProtocol, type InterlockVisualizationOptions, MapColor, MeasureTool, PREVENTION_TYPES, PreventionEnums, SignalColorEnums, StationFeatureCodeEnums, TeeeMap, attachTrackAngle, index$1 as canvasCreator, getTrackBearing, index as imageCreater, offsetFeatureCollection, transformGeoJsonFrom3857, transformGeoJsonProperties };