@teeechina/teee-map 0.0.6 → 0.0.7

package/index.d.ts

@@ -1,91 +1,403 @@
-import type { Map as MaplibreMap, LngLat, MapGeoJSONFeature, LngLatLike } from 'maplibre-gl';
-import type { LayerSpecification, SourceSpecification } from 'maplibre-gl';
-
-export type MapType = 'graph' | 'geom' | 'ctc' | 'raster';
-
-export type LayerType = 'background' | 'signal' | 'track' | 'track_circuit' | 'bumper' | 'switch' | 'switch_loc' | 'insulation' | 'label' | 'prevention';
-
-export interface MapForgeConfig {
-  id: string;
-  subSourceId?: string;
-  sourceUrl?: string;
-  geojsonData?: object | string;
-  layers?: LayerType[];
-  sourceLayers?: string[];
-  center?: LngLatLike;
-  zoom?: number;
-}
-
-export interface MapParams {
-  id: string;
-  source: SourceSpecification;
-  subSourceId?: string;
-  subSource?: SourceSpecification;
-  layers?: LayerSpecification[];
-}
-
-export interface IconType {
-  id: string;
-  image: HTMLImageElement;
-}
-
-export interface stateType {
-  state?: string;
-  select?: boolean;
-  visiable?: boolean;
-  subState1?: any;
-  subState2?: any;
-  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:feature-click': FeatureInteractionPayload;
-}
-
-export declare class TeeeMap {
-  public map: MaplibreMap;
-  public mapConfigs: MapForgeConfig;
-  public stashFeatures: Map<any, any>;
-
-  constructor(container: string | HTMLElement);
-
-  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: MapGeoJSONFeature, lngLat: LngLat) => void): void;
-
-  destroy(): void;
-  initState(): void;
-
-  initMap(mapParams: MapParams): 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;
-  getMap(): MaplibreMap;
-  getMapConfigs(): MapForgeConfig;
-  stashAllFeature(): void;
-  updateFeatureState(code: string | number, state: any): void;
-}
-
-export default TeeeMap;
+import type { Map as MaplibreMap, LngLat, GeoJSONFeature, LngLatLike } from 'maplibre-gl';
+import type { LayerSpecification, SourceSpecification } from 'maplibre-gl';
+
+// ─────────────────────────────────────────────
+// 基础枚举 & 联合类型
+// ─────────────────────────────────────────────
+
+export type MapType = 'graph' | 'geom' | 'ctc' | 'raster';
+
+export type LayerType =
+  | 'background'
+  | 'signal'
+  | 'track'
+  | 'track_circuit'
+  | 'bumper'
+  | 'switch'
+  | 'switch_loc'
+  | 'insulation'
+  | 'label'
+  | 'prevention';
+
+// ─────────────────────────────────────────────
+// 联锁枚举
+// ─────────────────────────────────────────────
+
+/** 联锁信号机状态 */
+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;
+  subSourceId?: string;
+  subSourceUrl?: string;
+  layers?: LayerType[];
+  sourceLayers?: string[];
+  subLayers?: LayerType[];
+  subSourceLayers?: string[];
+  geojsonData?: object | string;
+  center?: LngLatLike;
+  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 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;
+}
+
+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;
+}
+
+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;
+}
+
+export type InterlockVisualizationOptions =
+  | InterlockVisualizationGraphOptions
+  | InterlockVisualizationGeoJsonOptions
+  | InterlockVisualizationLegacyOptions;
+
+export declare class InterLockVisualization {
+  constructor(options: InterlockVisualizationOptions);
+  setInterlockData(protocol: InterlockProtocol): void;
+  clear(): void;
+}
+
+// ─────────────────────────────────────────────
+// TeeeMap 主类
+// ─────────────────────────────────────────────
+
+export declare class TeeeMap {
+  public map: MaplibreMap;
+  public mapConfigs: MapForgeConfig;
+  public stashFeatures: Map<any, any>;
+  /** 绘图工具（地图 load 事件后可用） */
+  public drawTool: DrawTool;
+
+  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;
+  stashAllFeature(): 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;
+
+  // ── 其他工具方法 ──
+  getMap(): MaplibreMap;
+  getMapConfigs(): MapForgeConfig;
+}
+
+export default TeeeMap;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teeechina/teee-map",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "",
   "main": "dist/teee-map.umd.js",
   "module": "dist/teee-map.mjs",