@teeechina/teee-map 0.0.37 → 0.1.0

package/index.d.ts

@@ -1,525 +0,0 @@
-import type { Map as MaplibreMap, LngLat, GeoJSONFeature } from 'maplibre-gl';
-import type { LayerSpecification, SourceSpecification } from 'maplibre-gl';
-import type { FeatureCollection } from 'geojson';
-
-// ─────────────────────────────────────────────
-// 基础枚举 & 联合类型
-// ─────────────────────────────────────────────
-
-export type MapType = 'graph' | 'geom' | 'ctc' | 'raster';
-
-export type LayerType = 'background' | 'signal' | 'track' | 'track_circuit' | 'bumper' | 'switch' | 'switch_loc' | 'insulation' | 'label' | 'prevention' | 'sgfhqy' | 'region';
-
-// 股道 | 桥梁 | 隧道 | 信号机 | 曲线 | 防洪 | 坡道 | 接触网分相 | 通话柱
-export type RegionLayerType = 'background' | 'track' | 'bridge' | 'tunnel' | 'region_signal' | 'curve' | 'floodcontrol' | 'ramp' | 'contactseparation' | 'callpost';
-
-// ─────────────────────────────────────────────
-// 联锁枚举
-// ─────────────────────────────────────────────
-
-/** 联锁信号机状态 */
-export enum InterLockSignal {
-  RedLight = 1,
-  GreenLight = 2,
-  WhiteLight = 3,
-  BlueLight = 4,
-  Unknown = 5,
-}
-
-/** 联锁电路区段状态 */
-export enum InterLockCircuit {
-  RedCircuit = 1,
-  WhiteCircuit = 2,
-  EqualRedCircuit = 3,
-  GreyCircuit = 4,
-  GreenCircuit = 5,
-}
-
-/** 联锁道岔状态 */
-export enum InterLockSwitchloc {
-  NormalPosition = 2,
-  ReversePosition = 3,
-  NeutralPosition = 4,
-}
-
-/** 闭塞信号 */
-export enum BsSignal {
-  COME_GREEN = 0,
-  COME_YELLOW = 1,
-  COME_RED = 2,
-  GO_GREEN = 3,
-  GO_YELLOW = 4,
-  GO_RED = 5,
-  LOCK = 6,
-  EMERGENCY = 7,
-  RESET = 8,
-}
-
-/** 防控点类型枚举 */
-export enum PreventionTypes {
-  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,
-  ISOLATE = 35,
-  TGQ = 47,
-  BLOCKLINE = 50,
-  WORKAREA = 51,
-  ROUTELINE = 52,
-  PARK = 53,
-  WORKBUOND = 54,
-  WORKBUONDCROSS = 55,
-  LEFTHIGHPLATFORM = 61,
-  RIGHTHIGHPLATFORM = 62,
-  BOTHSIDEHIGHPLATFORM = 63,
-  DOOR = 87,
-  ISOLATESWITCH = 100,
-  OTHER = 95,
-  SIDE = 253,
-  NONE = 254,
-  MAX = 255,
-  FOULINGPOST = 38,
-  CUNCHE = 39,
-  STATIONBOUNDEXTEND = 40,
-  RED = 41,
-  GREEN = 42,
-  YELLOW = 43,
-}
-
-// ─────────────────────────────────────────────
-// 地图配置接口
-// ─────────────────────────────────────────────
-
-/** MapForge 生成的地图初始化配置 */
-export interface MapForgeConfig {
-  id: string; // 地图主源名
-  sourceUrl?: string; // 用于 Vector/Raster 的 URL
-
-  subSourceId?: string;
-  subSourceUrl?: string;
-
-  layers?: (LayerType | RegionLayerType)[]; // 加载的图层类型
-  sourceLayers?: string[]; // 矢量瓦片内部的图层名
-  type?: 'region' | 'station';
-
-  zoom?: number; // 初始缩放级别
-}
-
-/** 传递给 initMap 的参数结构 */
-export interface MapParams {
-  id: string;
-  source: SourceSpecification;
-  subSourceId?: string;
-  subSource?: SourceSpecification;
-  layers?: LayerSpecification[];
-  subLayers?: LayerSpecification[];
-}
-
-/** 图标配置 */
-export interface IconType {
-  id: string;
-  image: HTMLImageElement;
-}
-
-/** 要素状态配置 */
-export interface stateType {
-  /** 股道：封锁(1) / 停电(2) / 无接触网(3) */
-  state?: string;
-  /** 选中状态 */
-  select?: boolean;
-  /** 是否可见 */
-  visiable?: boolean;
-  /** 信号机(钮封) / 道岔：占用(3) / 锁闭(2) */
-  subState1?: any;
-  /** 信号机(灭灯) / 道岔：单锁(1) / 解锁 */
-  subState2?: any;
-  /** 信号机(暂无) / 道岔：单封(1) / 解封 */
-  subState3?: any;
-}
-
-export interface layerSettingItem {
-  key: string;
-  label: string;
-  checked: boolean;
-  disabled: boolean;
-}
-
-export interface FeatureInteractionPayload {
-  type: LayerType;
-  code: string;
-  state: stateType;
-}
-
-export interface AppEvents {
-  'map:inited': any;
-  'map:feature-click': FeatureInteractionPayload;
-  'map:path-selected': any;
-}
-
-// ─────────────────────────────────────────────
-// 绘图工具
-// ─────────────────────────────────────────────
-
-export type DrawMode =
-  | 'point'
-  | 'linestring'
-  | 'polygon'
-  | 'rectangle'
-  | 'angled-rectangle'
-  | 'sensor'
-  | 'sector'
-  | 'circle'
-  | 'freehand'
-  | 'freehand-linestring'
-  | 'select'
-  | 'render';
-
-export interface ModeStyles {
-  filledColor?: string;
-  outlineColor?: string;
-  outlineWidth?: number;
-  markerColor?: string;
-  markerWidth?: number;
-  markerOutlineColor?: string;
-}
-
-export type DrawEventCallback = (features: GeoJSON.FeatureCollection) => void;
-export type SelectEventCallback = (id: string | null) => void;
-
-export declare class DrawTool {
-  constructor(mapSdk: TeeeMap);
-
-  addToMap(isOpen?: boolean): Promise<void>;
-  removeFromMap(): void;
-  changeMode(mode: DrawMode | 'undo' | 'redo' | 'download', styles?: ModeStyles): void;
-  setForcedCoordinate(coord: [number, number] | null): void;
-  setOnFinish(cb: DrawEventCallback): void;
-  setOnChange(cb: DrawEventCallback): void;
-  setOnDelete(cb: DrawEventCallback): void;
-  setOnSelect(cb: SelectEventCallback): void;
-  getFeatures(): GeoJSON.FeatureCollection;
-  addFeatures(features: GeoJSON.FeatureCollection): void;
-  clearFeatures(): void;
-}
-
-// ─────────────────────────────────────────────
-// 测量工具
-// ─────────────────────────────────────────────
-
-export declare class MeasureTool {
-  constructor(map: MaplibreMap);
-
-  /** 开始距离测量模式 */
-  startDistance(): void;
-  /** 开始面积测量模式 */
-  startArea(): void;
-  /** 清除所有测量图层、数据源和 DOM 元素 */
-  clear(): void;
-}
-
-// ─────────────────────────────────────────────
-// 联锁协议 & 可视化
-// ─────────────────────────────────────────────
-
-export interface InterlockItem {
-  name: string;
-  state: string;
-}
-
-export interface InterlockData {
-  signalInterlock: InterlockItem[];
-  switchInterlock: InterlockItem[];
-  circuitInterlock: InterlockItem[];
-}
-
-export declare class InterlockProtocol {
-  signalExist: boolean;
-  productInfo?: string;
-  stationCode?: string;
-  time?: string;
-
-  getProductInfo(): string | undefined;
-  getStCode(): string | undefined;
-  getInterlockInfo(): Map<string, InterlockData>;
-  isSignalExist(): boolean;
-  setYardSignal(signal: string): void;
-}
-
-export interface InsulationSignals {
-  upsignal: string | null;
-  downsignal: string | null;
-}
-
-export declare class InterLockInsulation {
-  setInsulation(features: GeoJSONFeature[]): void;
-  getSignalsByInsulation(id: string): InsulationSignals | undefined;
-  getInsulationBySignal(signalId: string): string | undefined;
-}
-
-export interface InterlockVisualizationGraphOptions {
-  mode: 'graph';
-  map: MaplibreMap;
-  sourceId: string;
-  sourceLayers: {
-    signal: string;
-    switch: string;
-    switch_loc: string;
-    track_circuit: string;
-    track: string;
-    insulation: string;
-  };
-  firstSwitches?: string[];
-  updateFeatureState?: (code: string | number, state: any) => void;
-  queryGeojsonFeatures?: (key: string) => GeoJSONFeature[];
-}
-
-export interface InterlockVisualizationGeoJsonOptions {
-  mode: 'geojson';
-  map: MaplibreMap;
-  sourceIds: {
-    signal: string;
-    switch: string;
-    switch_loc: string;
-    track_circuit: string;
-    track: string;
-    insulation: string;
-  };
-  firstSwitches?: string[];
-  updateFeatureState?: (code: string | number, state: any) => void;
-  queryGeojsonFeatures?: (key: string) => GeoJSONFeature[];
-}
-
-export interface InterlockVisualizationLegacyOptions {
-  map: MaplibreMap;
-  sourceId: string;
-  sourceLayers: {
-    signal: string;
-    switch: string;
-    switch_loc: string;
-    track_circuit: string;
-    track: string;
-    insulation: string;
-  };
-  firstSwitches?: string[];
-  updateFeatureState?: (code: string | number, state: any) => void;
-  queryGeojsonFeatures?: (key: string) => GeoJSONFeature[];
-}
-
-export type InterlockVisualizationOptions = InterlockVisualizationGraphOptions | InterlockVisualizationGeoJsonOptions | InterlockVisualizationLegacyOptions;
-
-export declare class InterLockVisualization {
-  constructor(options: InterlockVisualizationOptions);
-
-  /** 初始化绝缘节与信号机的映射关系，构造后需调用一次 */
-  initInsulation(): void;
-
-  /** 处理一帧联锁信号数据字符串，自动识别 ZK01 / YD 协议并刷新要素状态 */
-  handleSignalData(res: string): void;
-
-  /** 清空所有联锁状态缓存，将所有要素状态还原为初始值 */
-  turnOffSignals(): void;
-
-  /** 启用信号发送模式 */
-  startRunning(): void;
-
-  /** 禁用信号发送模式 */
-  stopRunning(): void;
-
-  /** 设置信号发送回调，回调参数为按协议格式组装的字符串数组 */
-  setSendSignalCallback(callback: (dataList: string[]) => void): void;
-
-  /** 设置站场信号状态列表 */
-  setStationSignalState(stationSignalState: string[], filterCodes?: string[]): void;
-
-  /** 将 interLockState 缓存中的状态按协议格式组装后触发回调 */
-  sendSignal(): void;
-
-  /** 将所有状态置零后发送一次清空帧，用于暂停场景 */
-  pauseSignal(): void;
-
-  /** 直接读取 MapLibre 图层 feature state 生成信号字符串并发送，不依赖缓存 */
-  collectStateAndSend(): void;
-
-  collectState(): string[];
-
-  /** @deprecated 请改用 handleSignalData */
-  setInterlockData(protocol: InterlockProtocol): void;
-
-  /** @deprecated 请改用 turnOffSignals */
-  clear(): void;
-}
-
-// ─────────────────────────────────────────────
-// TeeeMap 主类
-// ─────────────────────────────────────────────
-
-export declare class TeeeMap {
-  public map: MaplibreMap;
-  public mapConfigs: MapForgeConfig;
-  public stashFeatures: Map<any, any>;
-  /** 地图方向 */
-  public mapDir: 'left' | 'right';
-  /** GeoJSON 图层要素缓存：key 为图层名，value 为该图层所有要素 */
-  public layerFeaturesCache: Map<string, GeoJSONFeature[]>;
-  /** 绘图工具（地图 load 事件后可用） */
-  public drawTool: DrawTool;
-  /** 测量工具（地图 load 事件后可用） */
-  public measureTool?: MeasureTool;
-
-  constructor(container: string | HTMLElement, mbtileDBClient?: any);
-
-  // ── 数据源管理 ──
-  addGeoJsonSource(id: string, data?: any): void;
-  removeSource(id: string): void;
-  updateGeoJsonSource(id: string, data: any): void;
-  addVectorTileSource(id: string, url: string): void;
-  addRasterTileSource(id: string, url: string): void;
-
-  // ── 图层管理 ──
-  addGeoJsonLayer(layerId: string, sourceId: string, type?: 'fill' | 'line' | 'circle' | 'symbol', paint?: any, layout?: any): void;
-  updateLayerStyle(id: string, paint: any): void;
-  removeLayer(id: string): void;
-
-  // ── 交互事件 ──
-  onFeatureClick(layerIds: string | string[], callback: (feature: GeoJSONFeature, lngLat: LngLat) => void): void;
-
-  // ── 生命周期 ──
-  destroy(): void;
-  initState(): void;
-  initMap(mapParams: MapParams): void;
-
-  // ── 要素状态 ──
-  initCTCFeatureState(f: GeoJSONFeature): void;
-  initGraphFeatureState(f: GeoJSONFeature): void;
-  initGeoJsonFeatureState(f: GeoJSONFeature, layerType: string): void;
-  initGeoJsonState(): void;
-  initMixGeoJsonMapState(): void;
-  stashAllFeature(): void;
-  setSscsPointState(code: string | number, state: string): void;
-
-  // ── 要素缓存就绪信号 ──
-  /** 使当前要素缓存就绪信号失败并唤醒所有等待方（destroy 时内部调用） */
-  invalidateStashReady(reason?: string): void;
-  /** 等待要素缓存（stashFeatures）就绪，超时或地图销毁时 reject */
-  whenStashed(timeout?: number): Promise<void>;
-  /** 注册要素缓存就绪回调（事件风格 API，内部等价于 whenStashed().then(cb)） */
-  onStashReady(cb: () => void, onError?: (err: unknown) => void): void;
-  updateFeatureState(code: string | number, state: any): void;
-
-  // ── 地图创建方法 ──
-  createCTCMap(stcode: string, url: string, layers: LayerType[]): void;
-  createRSWPMap(url: string): void;
-  createGraphMap(stcode: string, url: string, layers: LayerType[]): void;
-  createGeomMap(stcode: string, url: string, layers: LayerType[]): void;
-  createMbtilesMap(mbtileDBClient: any, url: string, layers: LayerType[]): void;
-  createRasterMap(url: string): void;
-  createGraphEncryptedMap(stcode: string, url: string, layers: LayerType[]): void;
-  createGeomEncryptedMap(stcode: string, url: string, layers: LayerType[]): void;
-  createCTCEncryptedMap(stcode: string, url: string, layers: LayerType[]): void;
-  createGeoJsonStationMap(stationDatas: GeojsonStationDatas[]): Promise<void>;
-  createSscsGraphMap(url: string): void;
-  createMixGeoJsonMap(
-    stationDatas: {
-      code: string;
-      type: 'region' | 'station';
-      geojsonData: {
-        name: string;
-        data: GeoJSON.FeatureCollection | string;
-      }[];
-      deltaInfo?: {
-        deltax: number;
-        deltay: number;
-      };
-    }[],
-  ): Promise<void>;
-  /** 创建 GeoJSON 站场地理图（加载高德影像底图 + 不转换3857坐标系） */
-  createGeoJsonGeomStationMap(stationDatas: GeojsonStationDatas[], showImage?: boolean): Promise<void>;
-  /** 创建geojson数据来源的站场区间平面地理图（加载高德影像底图 + 不转换3857坐标系） */
-  createMixGeoJsonGeomMap(
-    mapDatas: {
-      code: string;
-      type: 'region' | 'station';
-      geojsonData: {
-        name: string;
-        data: GeoJSON.FeatureCollection | string;
-      }[];
-    }[],
-    showImage?: boolean,
-  ): Promise<void>;
-  createGeoJsonRegionMap(
-    regionCode: string,
-    regionDatas: {
-      name: string;
-      data: GeoJSON.FeatureCollection | string;
-    }[],
-  ): Promise<void>;
-
-  // ── 其他工具方法 ──
-  getMap(): MaplibreMap;
-  getMapConfigs(): MapForgeConfig;
-  getFeatureState(code: string | number): Record<string, unknown> | undefined;
-  locateGeojsonFeature(data: GeoJSON.FeatureCollection, transform?: boolean): void;
-  /** 根据要素编码与图层类型将地图缩放至该要素位置 */
-  locateFeatureByCode(code: string, layerType: LayerType): void;
-  /** 平滑闪烁高亮指定要素，返回清理函数用于提前终止动画 */
-  smoothBlinkFeature(
-    code: string,
-    layerType: LayerType,
-    options?: {
-      duration?: number;
-      blinkSpeed?: number;
-      baseColor?: [number, number, number];
-      minAlpha?: number;
-      maxAlpha?: number;
-      strokeWidthBase?: number;
-      strokeWidthRange?: number;
-    },
-  ): () => void;
-  getTrackCircuitFeaturesByCodes(circuitCodes: string[]): GeoJSONFeature[];
-  /** 查询指定 GeoJSON 图层的所有要素 */
-  queryGeojsonFeatures(key: string): GeoJSONFeature[];
-  /** 根据要素编码与图层类型获取单个 GeoJSON 要素 */
-  getGeojsonLayerFeaturesByCode(code: string, layerType: LayerType): GeoJSONFeature | undefined;
-
-  // 信号解析与模拟
-  interLockVisualization?: InterLockVisualization;
-}
-
-export default TeeeMap;
-
-export interface GeojsonStationDatas {
-  name: string;
-  data: GeoJSON.FeatureCollection | string;
-}
-
-export declare function transformGeoJsonFrom3857(geojson: FeatureCollection): FeatureCollection;