aviation-chart 0.1.35 → 0.2.0

package/README.md

@@ -0,0 +1,286 @@
+# MapLibre SDK
+
+轻量地图 SDK，采用现代化架构设计，支持插件系统、性能优化和错误处理。
+
+## ✨ 新特性
+
+### 🏗️ 架构重构
+- **依赖注入**: 采用接口抽象和依赖注入，提高代码可测试性和可维护性
+- **模块化设计**: 清晰的管理器分离，每个功能模块独立管理
+- **插件系统**: 支持自定义插件扩展，灵活的功能扩展机制
+
+### 🚀 性能优化
+- **LOD机制**: 基于缩放级别的图层细节层次管理
+- **懒加载**: 图层按需加载，提升初始化和运行性能
+- **聚类支持**: 大数据量点的智能聚合显示
+- **样式优化**: 根据缩放级别自动简化图层样式
+
+### 🛡️ 错误处理
+- **统一错误管理**: 集中的错误处理和日志记录
+- **错误边界**: 防止单个错误影响整个系统
+- **降级策略**: 智能的错误恢复和降级处理
+- **错误统计**: 详细的错误分析和统计信息
+
+### 🔌 插件系统
+- **标准接口**: 统一的插件开发接口
+- **生命周期管理**: 插件的安装、卸载和状态管理
+- **示例插件**: 内置测量工具插件，展示插件开发模式
+
+## 🚀 快速开始
+
+### UMD 使用
+
+```html
+<link href="https://unpkg.com/maplibre-gl@3.6.2/dist/maplibre-gl.css" rel="stylesheet" />
+<script src="https://unpkg.com/maplibre-gl@3.6.2/dist/maplibre-gl.js"></script>
+<script src="/dist/maplibre-sdk.umd.js"></script>
+
+<div id="map" style="width:100%;height:600px;"></div>
+
+<script>
+  const sdk = new SDK.MapSDK({
+    container: 'map',
+    style: 'https://demotiles.maplibre.org/style.json',
+    center: [116.3974, 39.9093],
+    zoom: 10,
+    errorHandler: (error) => console.error('SDK Error:', error),
+    performance: {
+      lodEnabled: true,
+      clusteringEnabled: true,
+      lazyLoadingEnabled: true
+    }
+  });
+</script>
+```
+
+### ESM 使用
+
+```javascript
+import { MapSDK, MeasurePlugin } from 'maplibre-sdk';
+
+const sdk = new MapSDK({ 
+  container: 'map',
+  errorHandler: handleError,
+  performance: { lodEnabled: true }
+});
+
+// 使用插件
+const measurePlugin = new MeasurePlugin();
+sdk.use(measurePlugin);
+```
+
+## 📚 API 概览
+
+### 核心功能
+
+- **地图初始化**: `new MapSDK(options)` - 支持错误处理和性能配置
+- **错误处理**: `errorHandler` 配置，自动错误捕获和处理
+- **性能优化**: `performance` 配置，支持LOD、聚类、懒加载
+
+### 图层管理
+
+```javascript
+// 基础操作
+await sdk.addBuiltInLayer('水系');
+sdk.removeBuiltInLayer('道路网络');
+sdk.toggleBuiltInLayer('行政边界');
+
+// 性能优化
+sdk.layerManager.setLODEnabled(true);
+sdk.layerManager.setLayerLODConfig('layerId', {
+  minZoom: 10,
+  maxZoom: 18,
+  minPixelSize: 10,
+  maxPixelSize: 100,
+  cullingEnabled: true
+});
+```
+
+### GeoJSON 操作
+
+```javascript
+// 添加要素
+sdk.addPoint([lng, lat], properties, style);
+sdk.addLine(coordinates, properties, style);
+sdk.addPolygon(coordinates, properties, style);
+
+// 性能优化
+sdk.geoJSONManager.setClusteringEnabled(true);
+sdk.geoJSONManager.setClusteringConfig('layerId', {
+  enabled: true,
+  radius: 50,
+  maxZoom: 16,
+  minPoinjavascript: 3
+});
+```
+
+### 插件系统
+
+```javascript
+// 使用内置插件
+const measurePlugin = new MeasurePlugin();
+sdk.use(measurePlugin);
+
+// 启用测量功能
+measurePlugin.enable('distance');  // 距离测量
+measurePlugin.enable('area');      // 面积测量
+measurePlugin.disable();           // 禁用测量
+
+// 获取插件
+const plugin = sdk.getPlugin<MeasurePlugin>('measure');
+```
+
+### 错误处理
+
+```javascript
+// 自定义错误处理器
+const errorHandler = (error) => {
+  console.error('Error Code:', error.code);
+  console.error('Error Details:', error.details);
+  console.error('Recoverable:', error.recoverable);
+};
+
+const sdk = new MapSDK({
+  container: 'map',
+  errorHandler
+});
+
+// 获取错误统计
+const errorStajavascript = sdk.getErrorStajavascript();
+console.log('Total Errors:', errorStajavascript.total);
+```
+
+### 性能监控
+
+```javascript
+// 获取性能统计
+const perfStajavascript = sdk.getPerformanceStajavascript();
+console.log('Visible Layers:', perfStajavascript.visibleLayers);
+console.log('LOD Enabled:', perfStajavascript.lodEnabled);
+console.log('Clustering Enabled:', perfStajavascript.clusteringEnabled);
+console.log('Lazy Loading Enabled:', perfStajavascript.lazyLoadingEnabled);
+```
+
+## 🔧 开发插件
+
+### 插件接口
+
+```javascript
+import type { IPlugin, IMapSDK } from 'maplibre-sdk';
+
+export class MyPlugin implemenjavascript IPlugin {
+  public name = 'my-plugin';
+  public version = '1.0.0';
+  
+  install(sdk: IMapSDK): void {
+    // 插件安装逻辑
+    console.log('Plugin installed');
+  }
+  
+  uninstall(sdk: IMapSDK): void {
+    // 插件卸载逻辑
+    console.log('Plugin uninstalled');
+  }
+}
+```
+
+### 使用插件
+
+```javascript
+import { MyPlugin } from './MyPlugin';
+
+const plugin = new MyPlugin();
+sdk.use(plugin);
+
+// 检查插件状态
+const hasPlugin = sdk.pluginManager.hasPlugin('my-plugin');
+const pluginStajavascript = sdk.pluginManager.getPluginStajavascript();
+```
+
+## 🏗️ 构建与开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 开发模式构建
+pnpm build:dev
+
+# 生产模式构建
+pnpm build:prod
+
+# 类型检查
+pnpm type-check
+
+# 清理构建产物
+pnpm clean
+```
+
+## 📊 性能特性
+
+### LOD (Level of Detail)
+- 根据缩放级别自动调整图层细节
+- 低缩放级别使用简化样式
+- 高缩放级别显示完整细节
+
+### 懒加载
+- 图层按需加载，提升初始化速度
+- 支持图层加载优先级设置
+- 智能的加载队列管理
+
+### 聚类
+- 大数据量点的智能聚合
+- 可配置的聚类参数
+- 平滑的聚合动画效果
+
+## 🛡️ 错误处理特性
+
+### 错误分类
+- **可恢复错误**: 系统自动处理，不影响主要功能
+- **不可恢复错误**: 需要用户干预或系统重启
+
+### 错误统计
+- 错误历史记录
+- 错误类型分析
+- 错误趋势监控
+
+### 降级策略
+- 功能降级处理
+- 备用方案切换
+- 用户友好的错误提示
+
+## 📁 项目结构
+
+```
+src/
+├── managers/           # 管理器模块
+│   ├── LayerManager.javascript      # 图层管理
+│   ├── GeoJSONManager.javascript    # GeoJSON管理
+│   ├── ErrorManager.javascript      # 错误管理
+│   ├── PerformanceManager.javascript # 性能管理
+│   └── PluginManager.javascript     # 插件管理
+├── plugins/            # 插件模块
+│   └── MeasurePlugin.javascript     # 测量插件示例
+├── types/              # 类型定义
+├── constanjavascript/          # 常量定义
+├── MapSDK.javascript          # 主SDK类
+└── index.javascript           # 导出文件
+```
+
+## 🔮 未来规划
+
+- [ ] 更多内置插件（编辑工具、分析工具等）
+- [ ] 高级性能优化（WebGL优化、内存管理）
+- [ ] 更多数据源支持（WMS、WFS、3D Tiles等）
+- [ ] 移动端优化
+- [ ] 国际化支持
+
+## 📄 许可证
+
+MIT License
+ 
+
+## 开发规范
+-   [代码规范](docs/code-specification.md)
+-   [JSDoc注释规范](docs/jsdoc-specification.md)
+-   [发版说明](docs/release-notes-specification.md)

package/dist/MapSDK.d.ts

@@ -0,0 +1,128 @@
+import { Map as MaplibreMap, StyleSpecification, GeoJSONSourceSpecification, FlyToOptions } from "maplibre-gl";
+import type { MapSDKOptions, IMapSDK, StyleConfig, ILayerManager, IGeoJSONManager, IPlugin, LayerConfig, StyleImageMetadata, LayerRef, HtmlFunction } from "./types";
+import { ADSB } from "./managers/ADSBManager";
+import { NOTAM } from "./managers/NotamManager";
+import { HoverManager } from "./managers/HoverManage";
+import { ClickManager } from "./managers/ClickManager";
+import { RasterManager } from "./managers/RasterManager";
+import { GraticuleManager, GraticuleConfig } from "./managers/Graticule";
+import API from "./apis";
+import { SelectFeature } from "./managers/SelectFeature";
+import { LineLabelOptimizer } from "./managers/LineLabelOptimizer";
+import { Theme } from "./managers/ThemeManage";
+import { WindManager } from "./managers/WindManager";
+export declare class MapSDK implements IMapSDK {
+    map: MaplibreMap;
+    layerManager: ILayerManager;
+    geoJSONManager: IGeoJSONManager;
+    private performanceManager;
+    private pluginManager;
+    private isDestroyed;
+    adsb: ADSB;
+    notam: NOTAM;
+    hover: HoverManager;
+    clickObj: ClickManager;
+    rasterManager: RasterManager;
+    graticule: GraticuleManager;
+    api: API;
+    selector: SelectFeature;
+    lineLabelOptimizer: LineLabelOptimizer;
+    theme: Theme;
+    wind: WindManager;
+    private initialOptions;
+    private _baseUrl;
+    private _landGeojson;
+    private _chartApiUrl;
+    readonly ready: Promise<void>;
+    private _resolveReady;
+    private _rejectReady;
+    get globalConfig(): import("./managers/GlobalConfigManager").GlobalConfigManager;
+    get absb(): ADSB;
+    constructor(options: MapSDKOptions);
+    private initializeMap;
+    private setupMapEventListeners;
+    private handleZoomChange;
+    private initializeManagers;
+    private initializeDefaultLayers;
+    private initializeADSB;
+    private initializeNOTAM;
+    private initializeHover;
+    private initializeCLick;
+    private initialRaster;
+    private initializeGraticule;
+    private initializeSelector;
+    private initializeLabelOptimizer;
+    private initializeTheme;
+    private initializeChartFeatures;
+    private initializeAviationLayers;
+    setCenter(center: [number, number]): void;
+    setZoom(zoom: number): void;
+    setPitch(pitch: number): void;
+    setBearing(bearing: number): void;
+    fitBounds(bounds: [[number, number], [number, number]], options?: any): void;
+    addBuiltInLayer(layerName: string, zindex: string): Promise<void>;
+    removeBuiltInLayer(layerName: string): void;
+    toggleBuiltInLayer(layerName: string): void;
+    toggleLayer(layerName: string): void;
+    showLayer(layerName: string): void;
+    hideLayer(layerName: string): void;
+    clickLayer(layerName: LayerRef, callback: (e: any) => void): void;
+    getBuiltInLayers(): Object;
+    isBuiltInLayerVisible(layerId: string): boolean;
+    updateLayerStyle(layerId: string, style: StyleConfig): void;
+    toggleFullScreen(state: boolean): void;
+    private _snapshotVisibleLayers;
+    private _restoreAfterStyleLoad;
+    setMapStyle(style: string | StyleSpecification, options?: {
+        diff?: boolean;
+    }): Promise<void>;
+    setTheme(theme: "light" | "dark"): void;
+    private _themeLayerDefs;
+    private _applyThemedProps;
+    restoreLandLayer(): void;
+    addPoint(coordinates: [number, number], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    addLine(coordinates: [], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    addPolygon(coordinates: [], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    addGeoJSON(sourceId: string, geojson?: any, props?: GeoJSONSourceSpecification | null | undefined): any;
+    addLayer(layerConfig: LayerConfig): void;
+    hoverLayer(layers: LayerRef, cb: (e: any) => void): void;
+    hoverPopup(layerId: LayerRef, f: HtmlFunction): () => void;
+    clickPopup(layerId: LayerRef, f: HtmlFunction): () => void;
+    showLayers(layerIds: string[]): void;
+    hideLayers(layerIds: string[]): void;
+    setLayerVisible(key: string, visible: boolean): void;
+    flyTo(option: FlyToOptions, eventData?: any): void;
+    on(event: string, listenerOrLayerId?: string | Function, listener?: Function): void;
+    off(event: string, listenerOrLayerId?: string | Function, listener?: Function): void;
+    getCenter(): [number, number];
+    getZoom(): number;
+    getBounds(): [[number, number], [number, number]];
+    use(plugin: IPlugin): void;
+    getPlugin<T extends IPlugin>(name: string): T | undefined;
+    getPerformanceStats(): {
+        visibleLayers: number;
+        queuedLayers: number;
+        lodEnabled: boolean;
+        clusteringEnabled: boolean;
+        lazyLoadingEnabled: boolean;
+    };
+    getErrorStats(): void;
+    setPeriod(period: string): void;
+    getPeriod(): string | undefined;
+    generateCurrentPeriod(): Promise<string>;
+    showGraticule(): void;
+    hideGraticule(): void;
+    toggleGraticule(): void;
+    updateGraticuleConfig(config: Partial<GraticuleConfig>): void;
+    isGraticuleVisible(): boolean;
+    get showTileBoundaries(): boolean;
+    set showTileBoundaries(value: boolean);
+    enableLineLabelDedup(lineLayerId: string, lineLabelId: string, builtInKey: string, fieldList?: string[], suffix?: string): void;
+    disableLineLabelDedup(): void;
+    private reinitializeMap;
+    registerIcon(id: string, url: string, options?: StyleImageMetadata): Promise<void>;
+    setStyle(style: object): void;
+    private processGlobalConfig;
+    private getCustomLayerStyles;
+    destroy(): void;
+}

package/dist/apis/index.d.ts

@@ -0,0 +1,60 @@
+type NotamDetailParams = {
+    notamSeries: string;
+    notamNoPart1: string;
+    notamNoPart2: string;
+    nof: string;
+    pageNo: number;
+    pageSize: number;
+    signal?: AbortSignal | null;
+};
+type NotamListParams = {
+    pageNo: number;
+    pageSize: number;
+    onlyGeojson: boolean;
+    typeC: boolean;
+    notamOffset: string;
+    isInternational: boolean;
+    isCompanyVersion: boolean;
+    signal?: AbortSignal | null;
+};
+type NotamDataParams = {
+    pageNo: number;
+    pageSize: number;
+    nof: string;
+    itemA: string;
+    itemB: string;
+    itemC: string;
+    notamSeries: string;
+    notamNoPart1: string;
+    notamNoPart2: string;
+    notamTypeIds: string;
+    onlyValid: boolean;
+    moduleName: string;
+    topic: string;
+    notamCode: string;
+    signal: AbortSignal | null;
+};
+type TyphoonVolcanoAshParams = {
+    AdvisoryText: string;
+    signal?: AbortSignal | null;
+};
+type RunwayDataParams = {
+    AirportCode: string;
+    DataPeriod: string;
+    signal?: AbortSignal | null;
+};
+export declare class API {
+    constructor();
+    _baseUrl: string;
+    setBaseUrl(baseUrl: string): void;
+    notam_list(params: NotamListParams | {}): Promise<Response>;
+    notam_detail(params: NotamDetailParams | {}): Promise<Response>;
+    notam_data(params: NotamDataParams): Promise<Response>;
+    typhoon_volcano_ash(params: TyphoonVolcanoAshParams | {}): Promise<Response>;
+    getRunwayData(params: RunwayDataParams): Promise<Response>;
+    getRadarData(signal?: AbortSignal | null): Promise<Response>;
+    getPeriodData(signal?: AbortSignal | null): Promise<Response>;
+    getIndexData(data: any, signal?: AbortSignal | null): Promise<Response>;
+    getAirportPoint(airport: string, signal?: AbortSignal | null): Promise<unknown>;
+}
+export default API;

package/dist/constants/aviation-sources.d.ts

@@ -0,0 +1,28 @@
+export declare const DEFAULT_CHART_API_URL = "https://aips.siniswift.com";
+export declare function getAviationBaseStyle(opts: {
+    apiUrl: string;
+    spriteUrl?: string;
+    background: string;
+}): any;
+export declare function navdataTilesUrl(apiUrl: string, period: string): string;
+export declare function getNavdataSource(apiUrl: string, period: string): {
+    type: "vector";
+    tiles: string[];
+    minzoom: number;
+    maxzoom: number;
+};
+export declare function getChartAmmSource(apiUrl: string): {
+    type: "vector";
+    tiles: string[];
+    minzoom: number;
+    maxzoom: number;
+};
+export declare function getTerrainSource(apiUrl: string, terrainUrl?: string | null): {
+    type: "raster-dem";
+    tiles: string[];
+    tileSize: number;
+    maxzoom: number;
+};
+export declare const TERRAIN_COLOR_RAMP: (string | number | string[])[];
+export declare function getTerrainLayers(): any[];
+export declare function fetchGzJson(url: string, headers?: Record<string, string>): Promise<any>;

package/dist/constants/builtin-layers.d.ts

@@ -0,0 +1,3 @@
+export declare const TYPEMAP: Record<string, string[]>;
+export declare const DEFAULT_LAYER_VISIBILITY: Record<string, boolean>;
+export declare const GROUP_ALIASES: Record<string, string>;

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { MapSDK } from './MapSDK';
+export { LayerManager } from './managers/LayerManager';
+export { GeoJSONManager } from './managers/GeoJSONManager';
+export { ErrorManager } from './managers/ErrorManager';
+export { PerformanceManager } from './managers/PerformanceManager';
+export { PluginManager } from './managers/PluginManager';
+export { globalConfig, GlobalConfigManager } from './managers/GlobalConfigManager';
+export { MeasurePlugin } from './plugins/MeasurePlugin';
+export { DrawPlugin } from './plugins/DrawPlugin';
+export type { IMapSDK, ILayerManager, IGeoJSONManager, IPlugin, MapSDKOptions, LayerConfig, BuiltInLayer, GeoJSONFeature, GeoJSONCollection, StyleConfig, SDKError, ErrorHandler, LODConfig, ClusteringConfig, MapEvent, EventListener, HookContext, HookCallback, HookRegistry } from './types';
+export { TYPEMAP, GROUP_ALIASES, DEFAULT_LAYER_VISIBILITY } from './constants/builtin-layers';
+export { NOTAM } from "./managers/NotamManager";
+export { WindManager } from "./managers/WindManager";
+export type { WindFrame, WindOptions } from "./managers/WindManager";
+export { MapSDK as default } from './MapSDK';
+export { Popup } from './managers/PopupManager';
+export { API } from './apis';
+export * as MapEngine from "maplibre-gl";
+export { MapSDK as AviationChart } from './MapSDK';
+export { Marker, LngLat, LngLatBounds } from 'maplibre-gl';
+export { CHART_THEMES, LAYER_GROUPS, LAYER_LABELS } from './style/aviation-chart.js';