aviation-chart 2.0.40 → 2.0.42

package/glm.txt

@@ -0,0 +1,2903 @@
+# aviation-chart SDK 开发手册
+
+SDK 版本：2.0.42
+
+# 开发约定
+
+只从 aviation-chart 公开入口导入。除初始化示例外，sdk 均表示已完成 await sdk.ready 的实例。参数和返回类型见末尾 API 参考；不要使用未列出的 SDK 方法。示例注释与功能限制冲突时，以功能限制和类型签名为准。
+
+## 1. 安装、初始化、生命周期
+
+安装 aviation-chart，实际使用版本应与本文页首版本一致。npm 包提供 ESM；不要用 require 或依赖未发布的 UMD 文件。框架项目只在浏览器挂载后初始化，SSR 服务端不要实例化地图。容器必须有明确高度。
+
+```sh
+npm install aviation-chart
+```
+
+```ts
+import { MapSDK } from 'aviation-chart';
+import 'aviation-chart/style.css';
+
+const container = document.createElement('div');
+container.style.cssText = 'width:100%;height:600px';
+document.body.appendChild(container);
+const sdk = new MapSDK({
+  container,
+  apiUrl: 'https://YOUR-DATA-SERVICE', // 替换为实际 Go 服务地址
+  licenseKey: 'YOUR-CLIENT-LICENSE', // 仅使用服务端签发给客户端的授权，不是管理员密码
+  center: [116.4, 39.9], zoom: 5,
+  theme: 'light',
+  layers: { airspace: true, airline: true, amm: true, admin: false },
+});
+sdk.map.on('error', event => console.error('地图资源错误', event.error));
+await sdk.ready;
+// 组件卸载时执行 sdk.destroy()；不要每次响应式状态更新都重新 new MapSDK。
+```
+
+Vue：onMounted 中创建、await ready，onBeforeUnmount 中 destroy；用普通变量或 shallowRef 保存实例，避免深层 reactive 代理 地图引擎。React：useEffect 中创建并 return 清理函数，开发 StrictMode 下确保每次都有销毁。异步初始化期间卸载时，ready 回调必须先检查组件是否已卸载。
+
+loadComplete / aviation:ready 表示 SDK 初始化完成；普通 地图引擎 load 不等于所有业务管理器准备完毕。ready 不保证后台所有瓦片均已下载。外部服务不可用时应显示业务错误/重试入口，不要永久遮罩。
+
+MapSDKOptions 所有选项见参考，包括视角、交互、性能、插件、图层、授权和服务地址。apiUrl 用于新数据服务；baseUrl/staticUrl/version 等属于兼容配置，不能与 apiVersion（API 路径版本）或 period（数据期次）混淆。apiKey 与 licenseKey 的授权方式不同，不要自行把密码拼接在 URL。spriteUrl 必须指向配套图标资源；terrainUrl 指向配套地形服务。部署需让浏览器实际能访问瓦片、字形、sprite 和 manifest，不能使用后端机器的 localhost。
+
+若传入自定义 options.style，初始化走自定义底图路径，不能假定默认航图图层和默认 manifest 监听仍自动装配。仅修改航图配色优先 setTheme / 图层 paint，而不是替换整个 style。
+
+## 2. 地图状态、视角、交互与原生引擎
+
+SDK 封装：setCenter、setZoom、setPitch、setBearing、fitBounds、flyTo、getCenter、getZoom、getBounds、toggleFullScreen、showTileBoundaries。经纬度顺序始终 [longitude, latitude]，使用 WGS84；pitch/bearing 为角度，zoom 为地图缩放级别。getCenter 返回数组，不是 LngLat 对象。
+
+原生 API 明确通过 sdk.map 调用，避免 SDK 的同名封装冲突：
+
+```ts
+sdk.flyTo({ center: [121.47, 31.23], zoom: 9 });
+sdk.map.scrollZoom.disable(); // 可用 enable 恢复；dragPan 等控制器同理
+sdk.map.resize(); // 容器尺寸变化、面板展开之后
+sdk.map.setProjection({ type: 'globe' }); // 球面，不等于真实三维地形
+sdk.map.setProjection({ type: 'mercator' });
+const pixel = sdk.map.project([121.47, 31.23]);
+const lngLat = sdk.map.unproject(pixel);
+const visible = sdk.map.queryRenderedFeatures();
+```
+
+MapEngine、Marker、Popup、LngLat、LngLatBounds 可从 aviation-chart 导入。MapEngine 是打包的 地图引擎 命名空间。SDK 虽代理部分原生方法，TypeScript 和同名方法优先使用 sdk.map。引擎支持的通用 API 不等于 SDK 新增封装，不要写不存在的 sdk.set3DMode 等方法。
+
+## 3. 图层、主题、FIR、机场图、国家名称
+
+setLayerVisible(key, boolean) 用逻辑图层组。可用 key 和组成的实际 id 见参考 TYPEMAP；GROUP_ALIASES 是兼容别名。showLayer/hideLayer/toggleLayer 等操作具体图层时先确认实际 id。addBuiltInLayer/removeBuiltInLayer/toggleBuiltInLayer/getBuiltInLayers/isBuiltInLayerVisible 是兼容的内置图层管理接口，签名见附录；不要给 addBuiltInLayer 传任意不存在的 id。
+
+```ts
+sdk.setLayerVisible('airspace', true);
+sdk.setLayerVisible('amm', true);
+sdk.setLayerVisible('admin', true);
+if (sdk.map.getLayer('admin')) sdk.map.setPaintProperty('admin', 'text-opacity', 1);
+sdk.setTheme('light'); // 其余主题名以参考 CHART_THEMES 为准
+if (sdk.map.getLayer('airline')) sdk.map.setPaintProperty('airline', 'line-width', 1.2);
+```
+
+组名、style 图层 id、数据 source id、MVT source-layer 是四种不同概念。FIR 边界使用共享边界数据，标签承载线独立；不要将 fir-boundary 当 style 图层 id 或给共享边界直接填任意一侧名称。AMM 子图层由 SDK 定义，不要手写旧列表；跑道位移区域是跑道填充的补充图层。是否可见同时受数据覆盖、minzoom、filter、opacity 和 visibility 影响。
+
+admin 为国家名称数据源/图层，字段为短名称字段（不是旧 objID）。mt 区分主领土和其他领土，lr/mz 用于标签等级/最小级别；具体数据不可假定每个国家都有相同 rank。setLayerVisible 不会改变 fill/text opacity；图层启用仍不可见时检查 paint 与 filter。不要把国名标注点当行政区多边形。
+
+setStyle 是 SDK 局部主题覆盖，不是原生 StyleSpecification。普通键为实际图层 id，amm/controlled/restricted/airspace 这四个键需要数组形式：
+
+```ts
+sdk.setStyle({
+  airline: { paint: { 'line-color': '#285a90' } },
+  airspace: [{ airspaceLayer_line: { paint: { 'line-color': '#557755' } } }],
+});
+```
+
+完整替换地图样式用 await sdk.setMapStyle(style, { diff: true })。替换后自定义 source/layer/图片是否存在要重新检查并恢复，不能假定永久保留。restoreLandLayer 用于恢复 SDK 陆地图层。主题切换可能覆盖业务 paint，自定义样式应在主题切换之后重新应用。
+
+## 4. 数据期次、manifest、搜索和几何查询
+
+```ts
+const periods = await sdk.getPeriods();
+const latestPeriod = periods[0];
+if (latestPeriod) sdk.setPeriod(latestPeriod, { validate: true });
+console.log(sdk.getPeriod());
+const controller = new AbortController();
+const results = await sdk.search({ q: 'ZBAA', type: 'airport', limit: 20, signal: controller.signal });
+const first = results[0];
+if (first) {
+  const feature = await sdk.getGeometry({ type: first.type, id: first.id });
+  console.log(feature.geometry);
+}
+// 搜索框下一次查询或卸载时 controller.abort()。
+```
+
+getPeriods 返回期次字符串数组；setPeriod 返回 void，不是等待全部瓦片就绪的 Promise，validate 校验异步执行。generateCurrentPeriod 用于获取/计算当前期次。不要把期次硬编码为日历月份，也不要把搜索结果 code 当几何查询所需的 UUID id。可检索类型见 FeatureType。
+
+默认航图初始化包含 NavData/AMM 版本与 manifest 处理。业务通常不必自己拼瓦片 URL 或重复轮询 manifest；不上传 AMM 时服务可沿用可用 AMM，是否有数据取决于服务端发布状态。SDK 不能代替服务端切片、发布或保证数据已经生成。切期不是重新 install SDK；但新增数据字段/图层仍需相应 SDK 样式支持。
+
+无地图时可用 searchFeatures/getFeatureGeometry/getPeriods 独立函数；其第一个参数是服务地址，授权/params 参数顺序见附录，不要与实例方法混用。全局 globalConfig 是共享单例，多地图使用不同服务/期次时需注意共享配置影响，不要调用不可公开构造的 GlobalConfigManager 构造器。
+
+## 5. GeoJSON、自定义图层与大量点
+
+推荐明确控制 source 和 layer，避免与 SDK 同名方法混用：
+
+```ts
+const data = { type: 'FeatureCollection' as const, features: [{
+  type: 'Feature' as const, properties: { name: '示例点' },
+  geometry: { type: 'Point' as const, coordinates: [116.4, 39.9] },
+}] };
+sdk.map.addSource('business-points', { type: 'geojson', data });
+sdk.map.addLayer({ id: 'business-points-layer', type: 'circle', source: 'business-points',
+  paint: { 'circle-radius': 5, 'circle-color': '#2672c8' } });
+// 更新：将 getSource('business-points') 窄化为 GeoJSONSource 后调用 setData(nextData)。
+// 清理：先 removeLayer('business-points-layer')，再 removeSource('business-points')。
+```
+
+SDK 快捷方法包括 addPoint/addGeoJSON、geoJSONManager.addPoint/addLine/addPolygon，以及 removeFeature/updateFeature/clearAllFeatures/getFeature/getAllFeatures。sdk.addLine/addPolygon 当前参数类型过窄（[]），TypeScript 项目优先用正确类型的 geoJSONManager 或原生 GeoJSON；不要靠 any 掩盖错误。SDK addLayer 接受 LayerConfig，与原生 地图引擎 LayerSpecification 不同。
+
+大量点使用单个 GeoJSON source + circle/symbol layer，不要创建上万个 DOM Marker。聚合可在原生 GeoJSON source 开启 cluster/clusterRadius/clusterMaxZoom，用 point_count 判断聚合点，用 getClusterExpansionZoom 查询展开级别。数据频繁更新应批量 setData、节流、卸载取消定时器。LOD/聚合/懒加载的配置接口存在，但不是所有自定义 source 自动享受的性能保证。
+
+## 6. 覆盖物与弹窗
+
+SDK 工厂 createCircle/createText/createMarker/createPolyline/createPolygon 自动绑定地图，分别返回 Circle/Text/EnhancedMarker/Polyline/EnhancedPolygon。也可显式 new 对应类后 bindTo(sdk)。全部 options 和实例方法见附录，不要把原生 Marker 的构造参数传给 EnhancedMarker。
+
+```ts
+const label = sdk.createText({ position: [116.4, 39.9], text: '示例机场' });
+label.setText('更新名称');
+label.remove();
+const circle = sdk.createCircle({ center: [116.4, 39.9], radius: 1852 });
+const marker = sdk.createMarker({ position: [116.4, 39.9] });
+const line = sdk.createPolyline({ path: [[116.4, 39.9], [117, 40]] });
+const polygon = sdk.createPolygon({ path: [[[116, 39], [117, 39], [117, 40], [116, 39]]] });
+circle.remove(); marker.remove(); line.remove(); polygon.remove();
+```
+
+覆盖物提供相应的位置/路径/样式更新、显示隐藏和 remove。Circle 半径和 Polyline.getLength() 单位是米，1 NM = 1852 米；不要直接传海里数值。EnhancedPolygon.getArea() 返回平方米，当前仅计算外环，不扣除洞面积。地理距离不是屏幕距离。涉及航空业务准确性时使用经验证的数据/算法，不能用简化后的显示几何做安全判定。
+
+原生弹窗：
+
+```ts
+import { Popup } from 'aviation-chart';
+const popup = new Popup({ closeButton: true })
+  .setLngLat([116.4, 39.9]).setText('安全的文本内容').addTo(sdk.map);
+// popup.remove();
+```
+
+hoverPopup/clickPopup 返回解绑函数；hoverLayer/clickLayer 的 SDK 包装返回 void，不要假定都能调用返回值。需要 clickLayer 清理句柄时使用 sdk.clickObj 对应方法。HTML 弹窗内容不能直接插入不可信的服务端字段，优先 setText/textContent 或先消毒。
+
+## 7. 事件、要素选择、沿线标签
+
+```ts
+const onClick = (event: any) => console.log(event.lngLat);
+sdk.on('click', onClick);
+// 清理必须用同一个函数引用：
+sdk.off('click', onClick);
+sdk.selector.setSelectLayers(['airline']);
+sdk.selector.setOptions({ multiSelect: false, isHighlight: true });
+sdk.selector.enable();
+// sdk.selector.getSelected(); sdk.selector.disable();
+```
+
+on/off 支持地图事件以及图层委托事件，签名见附录；mousemove 等高频事件应节流，不在每次回调创建图层。selector 管理选中、高亮、右键回调和取消选中；只使用公开非下划线方法，不调用 _onClick 等内部实现入口。
+
+沿线文字去重用 sdk.enableLineLabelDedup(lineLayerId, lineLabelId, builtInKey, fieldList?, suffix?)，关闭用 disableLineLabelDedup。传入实际线层、标签层、业务组名与数据属性；不要调用旧示例里的 lineLabelOptimizer.enable/setOptions（当前不存在）。去重可能影响标签数量，不应把少标签一律归因于后端缺数据；还要排查碰撞、缩放范围、字体与 filter。
+
+## 8. ADS-B、NOTAM、雷达、业务 API
+
+ADS-B：sdk.adsb 是正式入口，absb 是兼容拼写。open(pointConfig?, labelConfig?, enableInterpolation?) 打开渲染，update 接受 Feature 数组，不是 FeatureCollection；close 停止显示。飞机数据由调用方请求/推送，不要假定 SDK 自动连接航空数据流。
+
+```ts
+sdk.adsb.open(undefined, { show: true }, false);
+sdk.adsb.update([{ type: 'Feature', geometry: { type: 'Point', coordinates: [116.4, 39.9] },
+  properties: { id: 'demo-1', aircraft_id: 'demo-1', callsign: 'DEMO', heading: 90,
+    speed: 0, time_stamp: new Date().toISOString(), icao: 'DEMO' } }]);
+```
+
+默认飞机图片依赖配套 sprite。开启外推时应核对服务时间戳和速度单位，不能把演示外推当真实位置。NOTAM：sdk.notam.open(builtin, lineConfig?, fillConfig?, isPattern?)、update(features)、close、hover、refresh、getNotamData、openNotamDetail，内置数据模式依赖实际业务接口和权限；参数和返回值见附录。
+
+雷达/栅格：sdk.rasterManager.addRasterLayer(layerId, sourceId, meteoType)，设置 rasterSourceUrl 后添加；updateRasterLayer(sourceId, newUrl, type) 更新，removeRasterLayer(layerId, sourceId) 清理。当前 radar 使用固定中国区域四角，其他类型使用世界范围，不能声称此封装支持任意 footprint；自定义四角使用 sdk.map.addSource 的 image source。方法返回 void，不是数据下载完成通知。
+
+sdk.api / 导出的 API 类为兼容业务 HTTP 封装：notam_list、notam_detail、notam_data、typhoon_volcano_ash、getRunwayData、getRadarData、getPeriodData、getIndexData、getAirportPoint。多数返回 Response，业务需检查 response.ok 再 json；不要都当已经解析的 JSON。搜索的新接口则直接返回解析结果，两者不能混淆。参数如 AirportCode/DataPeriod 大小写不可改；完整结构见参考。
+
+风场：WindManager/WindFrame/WindOptions 虽导出，当前 open/setFrame 等仅为接口骨架，没有真正风场绘制。不要给用户生成“启用即可显示风场”的代码，也不要重新引入不兼容的 外部风场插件 默认导入。
+
+## 9. 插件、绘制、测量与诊断
+
+插件通过 sdk.use(plugin)、sdk.getPlugin(name) 接入。IPlugin 的 name/version/install/uninstall 等字段以接口定义为准。插件应主动清理自己注册的事件、定时器和资源；不得以存在 PluginManager 导出为理由访问 SDK 私有成员。
+
+```ts
+import { DrawPlugin, MeasurePlugin } from 'aviation-chart';
+const draw = new DrawPlugin();
+sdk.use(draw);
+// DrawingController 需等待其自身加载完成再操作；按附录使用 enableEdit/disableEdit 等包装。
+const measure = new MeasurePlugin();
+sdk.use(measure);
+measure.enable('distance');
+measure.disable();
+```
+
+DrawPlugin 暴露 geoman 及拖动/编辑包装，不存在任意命名的 startDrawing/exportGeoJSON SDK 方法。DrawingController 第三方能力不在自有 API 全覆盖承诺内。当前插件卸载资源清理不完整，使用时需实测组件反复挂载。MeasurePlugin 是基础实现，结果通过 alert，面积计算与图形清理存在限制，不能作为生产航空测量正确性保证；需要严格测量时另行实现并验证。
+
+ErrorManager、PerformanceManager、LayerManager、GeoJSONManager、PluginManager 为可导出管理器，通常复用 sdk 已有实例；独立构造时依赖以附录为准。getPerformanceStats 返回配置/队列统计，不是 FPS 或网络耗时。getErrorStats 当前无返回数据，options.errorHandler 也不能作为已完善的统一错误管道；直接监听 sdk.map 的 error 并捕获业务请求 Promise。性能验证关注实际 Network、长任务、渲染帧、请求取消、内存，不只看配置开关。
+
+## 10. 资源、地形、截图与排障
+
+经纬网通过 showGraticule/hideGraticule/toggleGraticule 控制，isGraticuleVisible 查询，updateGraticuleConfig 更新间隔、线色等配置，完整配置类型见附录。经纬网标注与业务 FIR 标签不是同一套数据，不要用经纬网接口调整 FIR 名称。
+
+图片注册优先使用当前引擎返回结构，避免旧 helper 对返回值的假设：
+
+```ts
+const result = await sdk.map.loadImage('/icons/aircraft.png');
+if (!sdk.map.hasImage('business-aircraft')) sdk.map.addImage('business-aircraft', result.data);
+```
+
+SDK 也暴露 registerIcon，当前实现对 loadImage 返回包装的兼容需验证。地形需可用的 DEM 数据源，开 terrain/contour 组不等于创建全球 DEM；地图球面投影、hillshade 和真实 setTerrain 是不同功能。截图通过 sdk.map.getCanvas().toDataURL；需要持久缓冲时在初始化设置 preserveDrawingBuffer:true（会增加资源消耗），跨域图片必须合规加载。
+
+空白地图按顺序检查：容器高度 → map error → 服务授权和跨域 → manifest/瓦片内容 → glyph/sprite → 图层 source/source-layer → minzoom/filter/opacity。有 style 图层不等于服务端返回了对应数据。401/403 不是渲染性能问题；404 先看路径及发布结果；不要通过关闭鉴权或把管理员密钥写入前端解决。
+
+刷新、快速缩放与卸载：业务 fetch 用 AbortController；SDK 内建取消不涵盖应用自己的请求。不要靠频繁销毁地图取消请求；保留实例并更新视角/数据。销毁时清理业务事件、弹窗、覆盖物、WebSocket、定时器，再 sdk.destroy。
+
+# 入口导出（包括类型）
+
+API, AviationChart, BuiltInLayer, CHART_THEMES, Circle, CircleOptions, ClusteringConfig, DEFAULT_LAYER_VISIBILITY, DrawPlugin, EnhancedMarker, EnhancedPolygon, ErrorHandler, ErrorManager, EventListener, FeatureType, GROUP_ALIASES, GeoJSONCollection, GeoJSONFeature, GeoJSONManager, GeometryFeature, GeometryParams, GlobalConfigManager, HookCallback, HookContext, HookRegistry, IGeoJSONManager, ILayerManager, IMapSDK, IPlugin, LAYER_GROUPS, LAYER_LABELS, LODConfig, LayerConfig, LayerManager, LineType, LngLat, LngLatBounds, MapEngine, MapEvent, MapSDK, MapSDKOptions, Marker, MarkerOptions, MeasurePlugin, NOTAM, PerformanceManager, PluginManager, PolygonOptions, Polyline, PolylineOptions, Popup, SDKError, SearchParams, SearchResultItem, StrokeLineType, StyleConfig, TYPEMAP, Text, TextOptions, WindFrame, WindManager, WindOptions, default, getFeatureGeometry, getPeriods, globalConfig, searchFeatures
+
+# 图层配置与主题
+
+setLayerVisible 的组名使用 TYPEMAP 的键；AMM_LAYER_GROUPS 仅用于查找机场图子图层。
+
+```json
+{
+  "TYPEMAP": {
+    "background": [
+      "background"
+    ],
+    "landLayer": [
+      "landLayer",
+      "coast"
+    ],
+    "admin": [
+      "admin"
+    ],
+    "boundary": [
+      "boundary"
+    ],
+    "ocean": [
+      "ocean_label"
+    ],
+    "airspace": [
+      "airspaceLayer",
+      "airspace_label_side_layer",
+      "airspaceLayer_line",
+      "airspace_label_center_layer"
+    ],
+    "airline": [
+      "airline",
+      "airline_label",
+      "airline_point",
+      "airline_radial"
+    ],
+    "controlled": [
+      "controlledLayer",
+      "controlledLayer_stroke_left_bg",
+      "controlledLayer_stroke_border",
+      "controlledLayer_stroke",
+      "controlled_line_label"
+    ],
+    "restricted": [
+      "restrictedLayer",
+      "restrictedLayer_stroke_border",
+      "restrictedLayer_stroke_bg",
+      "restrictedLayer_stroke",
+      "restricted_line_label"
+    ],
+    "vor": [
+      "vor_icon",
+      "vor_icon_dial",
+      "vor_label",
+      "vor_label_detail"
+    ],
+    "ndb": [
+      "ndb_icon",
+      "ndb_label_detail"
+    ],
+    "airport": [
+      "airport",
+      "airport-runway",
+      "airport-runway-cross"
+    ],
+    "adiz": [
+      "adiz-line",
+      "adiz-label"
+    ],
+    "waypointOffAirway": [
+      "waypoint-off-airway-symbol"
+    ],
+    "amm": [
+      "amm-airport-fill",
+      "amm-airport-stroke",
+      "amm-runway-fill",
+      "amm-runway-displaced-area-fill",
+      "amm-runway-stroke",
+      "amm-runway-info",
+      "amm-runway-marking",
+      "amm-runway-centerline",
+      "amm-runway-threshold",
+      "amm-runway-threshold-label",
+      "amm-apron-fill",
+      "amm-apron-label",
+      "amm-taxiway-fill",
+      "amm-taxiway-line",
+      "amm-taxiway-label",
+      "amm-taxiway-guidanceline",
+      "amm-taxiway-intersectionline",
+      "amm-holding",
+      "amm-holding-label",
+      "amm-stand-label",
+      "amm-stand-line",
+      "amm-restricted-fill",
+      "amm-hotspot-fill",
+      "amm-hotpost-label",
+      "amm-obstacle-region-fill",
+      "amm-obstacle-point-label",
+      "amm-construction-fill",
+      "amm-construction-stroke",
+      "amm-construction-label"
+    ],
+    "terrain": [
+      "terrain-color",
+      "terrain-hillshade"
+    ],
+    "contour": [
+      "contour-line",
+      "contour-label"
+    ]
+  },
+  "GROUP_ALIASES": {
+    "fir": "airspace",
+    "segment": "airline",
+    "waypoint": "airline"
+  },
+  "DEFAULT_LAYER_VISIBILITY": {
+    "background": true,
+    "landLayer": true,
+    "admin": false,
+    "boundary": true,
+    "ocean": true,
+    "airspace": true,
+    "airline": true,
+    "controlled": false,
+    "restricted": false,
+    "vor": true,
+    "ndb": true,
+    "airport": true,
+    "adiz": false,
+    "waypointOffAirway": false,
+    "amm": true,
+    "terrain": false,
+    "contour": false
+  },
+  "CHART_THEMES": {
+    "light": {
+      "id": "light",
+      "label": "日间",
+      "background": "#C8DCE8"
+    },
+    "standard": {
+      "id": "standard",
+      "label": "Pro风格",
+      "background": "#C8DCE8"
+    },
+    "dark": {
+      "id": "dark",
+      "label": "夜间",
+      "background": "#000000"
+    },
+    "dusk": {
+      "id": "dusk",
+      "label": "暮光",
+      "background": "#1B2838"
+    },
+    "sectional": {
+      "id": "sectional",
+      "label": "ForeFlight 风格",
+      "background": "#DCEAEF"
+    }
+  },
+  "LAYER_GROUPS": {
+    "adiz": [
+      "adiz-line",
+      "adiz-label"
+    ],
+    "airspace": [
+      "airspaceLayer",
+      "airspaceLayer_line",
+      "airspace_label_center_layer",
+      "airspace_label_side_layer"
+    ],
+    "restricted": [
+      "restrictedLayer",
+      "restrictedLayer_stroke_border",
+      "restrictedLayer_stroke_bg",
+      "restrictedLayer_stroke",
+      "restricted_line_label"
+    ],
+    "controlled": [
+      "controlledLayer",
+      "controlledLayer_stroke_left_bg",
+      "controlledLayer_stroke_border",
+      "controlledLayer_stroke",
+      "controlled_line_label"
+    ],
+    "airline": [
+      "airline_radial",
+      "airline",
+      "airline-shadow",
+      "airline_label",
+      "airline_point"
+    ],
+    "waypointOffAirway": [
+      "waypoint-off-airway-symbol"
+    ],
+    "vor": [
+      "vor_icon_dial",
+      "vor_icon_dial_arrow",
+      "vor_label",
+      "vor_label_detail",
+      "vor_icon"
+    ],
+    "ndb": [
+      "ndb_icon",
+      "ndb_label_detail"
+    ],
+    "airport": [
+      "airport",
+      "airport-runway",
+      "airport-runway-cross"
+    ]
+  },
+  "LAYER_LABELS": {
+    "adiz": "防空识别区",
+    "airspace": "情报区",
+    "restricted": "限制区",
+    "controlled": "管制区",
+    "airline": "航线",
+    "waypointOffAirway": "非航路点",
+    "vor": "VOR",
+    "ndb": "NDB",
+    "airport": "机场"
+  },
+  "AMM_LAYER_GROUPS": {
+    "ammAirport": [
+      "amm-airport-fill",
+      "amm-airport-stroke"
+    ],
+    "ammRunway": [
+      "amm-runway-fill",
+      "amm-runway-displaced-area-fill",
+      "amm-runway-stroke",
+      "amm-runway-info",
+      "amm-runway-marking",
+      "amm-runway-centerline",
+      "amm-runway-threshold",
+      "amm-runway-threshold-label"
+    ],
+    "ammApron": [
+      "amm-apron-fill",
+      "amm-apron-label"
+    ],
+    "ammTaxiway": [
+      "amm-taxiway-fill",
+      "amm-taxiway-line",
+      "amm-taxiway-label",
+      "amm-taxiway-guidanceline",
+      "amm-taxiway-intersectionline"
+    ],
+    "ammHolding": [
+      "amm-holding",
+      "amm-holding-label"
+    ],
+    "ammStand": [
+      "amm-stand-label",
+      "amm-stand-line"
+    ],
+    "ammRestricted": [
+      "amm-restricted-fill"
+    ],
+    "ammHotspot": [
+      "amm-hotspot-fill",
+      "amm-hotpost-label"
+    ],
+    "ammObstacle": [
+      "amm-obstacle-region-fill",
+      "amm-obstacle-point-label"
+    ],
+    "ammConstruction": [
+      "amm-construction-fill",
+      "amm-construction-stroke",
+      "amm-construction-label"
+    ]
+  },
+  "LAYER_SOURCES": [
+    {
+      "id": "landLayer",
+      "type": "fill",
+      "source": "land"
+    },
+    {
+      "id": "coast",
+      "type": "line",
+      "source": "land",
+      "minzoom": 0
+    },
+    {
+      "id": "boundary",
+      "type": "line",
+      "source": "boundary",
+      "minzoom": 0
+    },
+    {
+      "id": "admin",
+      "type": "symbol",
+      "source": "admin",
+      "minzoom": 1
+    },
+    {
+      "id": "ocean_label",
+      "type": "symbol",
+      "source": "ocean",
+      "minzoom": 0
+    },
+    {
+      "id": "airspaceLayer",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "fir-boundary",
+      "minzoom": 2
+    },
+    {
+      "id": "airspaceLayer_line",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "fir-boundary",
+      "minzoom": 5
+    },
+    {
+      "id": "airspace_label_side_layer",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "fir",
+      "minzoom": 4
+    },
+    {
+      "id": "airspace_label_center_layer",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "fir-centroid",
+      "minzoom": 3,
+      "maxzoom": 7
+    },
+    {
+      "id": "restrictedLayer",
+      "type": "fill",
+      "source": "navdata",
+      "sourceLayer": "restricted-fill",
+      "minzoom": 4
+    },
+    {
+      "id": "restrictedLayer_stroke_bg",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "restricted"
+    },
+    {
+      "id": "restrictedLayer_stroke",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "restricted"
+    },
+    {
+      "id": "restricted_line_label",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "restricted",
+      "minzoom": 6
+    },
+    {
+      "id": "controlledLayer",
+      "type": "fill",
+      "source": "navdata",
+      "sourceLayer": "controlled-fill",
+      "minzoom": 4
+    },
+    {
+      "id": "controlledLayer_stroke_left_bg",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "controlled"
+    },
+    {
+      "id": "controlledLayer_stroke",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "controlled"
+    },
+    {
+      "id": "controlled_line_label",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "controlled",
+      "minzoom": 6
+    },
+    {
+      "id": "airline",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "segment",
+      "minzoom": 6
+    },
+    {
+      "id": "airline-shadow",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "segment-shdow",
+      "minzoom": 6
+    },
+    {
+      "id": "airline_label",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "segment",
+      "minzoom": 6
+    },
+    {
+      "id": "airline_radial",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "segment-radial",
+      "minzoom": 11
+    },
+    {
+      "id": "airport",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "airport",
+      "minzoom": 2.5
+    },
+    {
+      "id": "airport-runway",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "airport",
+      "minzoom": 4
+    },
+    {
+      "id": "airport-runway-cross",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "airport",
+      "minzoom": 4
+    },
+    {
+      "id": "vor_icon_dial",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "vor",
+      "minzoom": 8,
+      "maxzoom": 12
+    },
+    {
+      "id": "vor_icon_dial_arrow",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "vor",
+      "minzoom": 8.5,
+      "maxzoom": 12
+    },
+    {
+      "id": "vor-compass-ring",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "compass",
+      "minzoom": 12.1
+    },
+    {
+      "id": "vor-compass-ticks",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "compass",
+      "minzoom": 12.1
+    },
+    {
+      "id": "vor-compass-pointer",
+      "type": "line",
+      "source": "navdata",
+      "sourceLayer": "compass",
+      "minzoom": 12.1
+    },
+    {
+      "id": "vor_icon",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "vor",
+      "minzoom": 4
+    },
+    {
+      "id": "vor_label",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "vor",
+      "minzoom": 5,
+      "maxzoom": 8
+    },
+    {
+      "id": "ndb_icon",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "ndb",
+      "minzoom": 4
+    },
+    {
+      "id": "vor_label_detail",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "vor",
+      "minzoom": 8
+    },
+    {
+      "id": "ndb_label_detail",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "ndb",
+      "minzoom": 8
+    },
+    {
+      "id": "airline_point",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "waypoint",
+      "minzoom": 6
+    },
+    {
+      "id": "waypoint-off-airway-symbol",
+      "type": "symbol",
+      "source": "navdata",
+      "sourceLayer": "waypoint-off-airway",
+      "minzoom": 7
+    },
+    {
+      "id": "amm-airport-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-airport",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-airport-stroke",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-airport",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-runway-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-runway",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-runway-displaced-area-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-runway-displaced-area",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-runway-stroke",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-runway",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-apron-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-apron",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-taxiway-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-taxiway",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-taxiway-line",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-taxiway-line",
+      "minzoom": 13.5
+    },
+    {
+      "id": "amm-taxiway-guidanceline",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-taxiway-guidance-line",
+      "minzoom": 13.5
+    },
+    {
+      "id": "amm-taxiway-intersectionline",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-taxiway-intersection-marking",
+      "minzoom": 13.5
+    },
+    {
+      "id": "amm-holding",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-holding",
+      "minzoom": 13
+    },
+    {
+      "id": "amm-runway-marking",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-runway-marking",
+      "minzoom": 13
+    },
+    {
+      "id": "amm-restricted-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-restricted",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-hotspot-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-hotspot",
+      "minzoom": 12
+    },
+    {
+      "id": "amm-runway-centerline",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-runway-centerline",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-stand-line",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-stand-line",
+      "minzoom": 13
+    },
+    {
+      "id": "amm-obstacle-region-fill",
+      "type": "fill-extrusion",
+      "source": "amm",
+      "sourceLayer": "amm-obstacle-region",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-construction-fill",
+      "type": "fill",
+      "source": "amm",
+      "sourceLayer": "amm-construction",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-construction-stroke",
+      "type": "line",
+      "source": "amm",
+      "sourceLayer": "amm-construction",
+      "minzoom": 11
+    },
+    {
+      "id": "amm-apron-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-apron",
+      "minzoom": 13
+    },
+    {
+      "id": "amm-holding-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-holding",
+      "minzoom": 15
+    },
+    {
+      "id": "amm-hotpost-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-hotspot",
+      "minzoom": 12
+    },
+    {
+      "id": "amm-runway-info",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-runway-label",
+      "minzoom": 13
+    },
+    {
+      "id": "amm-taxiway-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-taxiway-line",
+      "minzoom": 12
+    },
+    {
+      "id": "amm-runway-threshold-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-runway-threshold",
+      "minzoom": 12
+    },
+    {
+      "id": "amm-stand-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-stand",
+      "minzoom": 13.5
+    },
+    {
+      "id": "amm-obstacle-point-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-obstacle-point",
+      "minzoom": 14
+    },
+    {
+      "id": "amm-construction-label",
+      "type": "symbol",
+      "source": "amm",
+      "sourceLayer": "amm-construction",
+      "minzoom": 13
+    }
+  ]
+}
+```
+
+# API 参考
+
+EngineTypes 表示 MapEngine 类型命名空间，DrawingController 表示绘图插件控制器。以下声明用于查阅签名，不要复制进项目；使用 aviation-chart 导出的类型。
+
+```typescript
+import { MapEngine as EngineTypes } from 'aviation-chart';
+type Map = EngineTypes.Map;
+type StyleSpecification = EngineTypes.StyleSpecification;
+type GeoJSONSourceSpecification = EngineTypes.GeoJSONSourceSpecification;
+type LayerSpecification = EngineTypes.LayerSpecification;
+type PopupOptions = EngineTypes.PopupOptions;
+type FlyToOptions = EngineTypes.FlyToOptions;
+
+export { MapEngine } from 'aviation-chart';
+export { LngLat, LngLatBounds, Marker, Popup } from 'aviation-chart';
+import { GeoJSON } from 'geojson';
+type DrawingController = import("aviation-chart").DrawPlugin["geoman"];
+interface GlobalConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    /** 新航图数据栈地址（/api/periods、/api/search、/api/geometry 等） */
+    apiUrl?: string;
+    /** API 版本段（如 "v1"）。为空则走无版本 /api/…。 */
+    apiVersion?: string;
+    version?: string;
+    period?: string;
+    chartConfig?: {
+        enableAIP?: boolean;
+        enableNOTAM?: boolean;
+        enableADSB?: boolean;
+        defaultCenter?: [
+            number,
+            number
+        ];
+        defaultZoom?: number;
+    };
+    styleConfig?: {
+        theme?: string;
+        language?: "zh-CN" | "en-US";
+    };
+    periodConfig?: {
+        switchDay?: number;
+    };
+    [key: string]: any;
+}
+declare class GlobalConfigManager {
+    private constructor();
+    static getInstance(): GlobalConfigManager;
+    /**
+     * 重新解析 URL 参数
+     */
+    refreshFromURL(): void;
+    /**
+     * 设置全局配置
+     */
+    setConfig(newConfig: Partial<GlobalConfig>): void;
+    /**
+     * 获取全局配置
+     */
+    getConfig(): GlobalConfig;
+    /**
+     * 获取特定配置项
+     */
+    getConfigItem<T>(key: string, defaultValue?: T): T | undefined;
+    /**
+     * 更新特定配置项
+     */
+    updateConfigItem<T>(key: string, value: T): void;
+    /**
+     * 添加配置变更监听器
+     */
+    addListener(event: string, callback: Function): () => void;
+    /**
+     * 移除配置变更监听器
+     */
+    removeListener(event: string, callback: Function): void;
+    /**
+     * 重置配置
+     */
+    reset(): void;
+    /**
+     * 设置期数
+     */
+    setPeriod(period: string): void;
+    /**
+     * 获取当前期数
+     */
+    getPeriod(): string | undefined;
+    /**
+     * 获取当前生效的期数。
+     * 调用后端 `/api/periods`（返回 { periods: string[] }，已按期数倒序，
+     * 最新在前），取最新一期作为当前期数。
+     */
+    generateCurrentPeriod(apiUrl?: string): Promise<string>;
+    /**
+     * 设置地图重新初始化回调
+     */
+    setMapReinitCallback(callback: (() => void | Promise<void>) | null): void;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}
+declare const globalConfig: GlobalConfigManager;
+type StrokeLineType = "solid" | "dashed" | "dotted" | "dash-dot" | "long-dash" | "double-dash";
+interface CircleOptions {
+    center: [
+        number,
+        number
+    ];
+    /** 半径(米) */
+    radius: number;
+    /** 圆弧逼近分段数，越大越圆滑，默认 64 */
+    steps?: number;
+    /** 填充颜色，默认 "#1890ff" */
+    color?: string;
+    /** 填充不透明度 0-1，默认 0.25 */
+    opacity?: number;
+    /** 填充平移 [x, y] px */
+    fillTranslate?: [
+        number,
+        number
+    ];
+    /** 填充图案 id */
+    fillPattern?: string;
+    /** 抗锯齿，默认 true */
+    antialias?: boolean;
+    /** 描边颜色，默认同 color */
+    strokeColor?: string;
+    /** 描边宽度(px)，默认 2 */
+    strokeWidth?: number;
+    /** 描边不透明度 0-1，默认 0.8 */
+    strokeOpacity?: number;
+    /** 预设描边线型 */
+    strokeLineType?: StrokeLineType;
+    /** 自定义描边虚线模式 */
+    strokeDasharray?: number[];
+    /** 描边端头样式 */
+    strokeLineCap?: "butt" | "round" | "square";
+    /** 描边拐角样式 */
+    strokeLineJoin?: "bevel" | "round" | "miter";
+    /** 描边模糊(px) */
+    strokeBlur?: number;
+    /** 描边平移 [x, y] px */
+    strokeTranslate?: [
+        number,
+        number
+    ];
+    /** 圆心标注文字 */
+    label?: string;
+    /** 标注字号，默认 14 */
+    labelSize?: number;
+    /** 标注颜色，默认 "#333" */
+    labelColor?: string;
+    /** 标注光晕颜色 */
+    labelHaloColor?: string;
+    /** 标注光晕宽度，默认 1 */
+    labelHaloWidth?: number;
+    /** 鼠标指针样式 */
+    cursor?: string;
+    /** 层叠顺序：在此图层 id 前插入 */
+    beforeId?: string;
+    /** 最小可见缩放级别 */
+    minZoom?: number;
+    /** 最大可见缩放级别 */
+    maxZoom?: number;
+    /** 额外属性 */
+    properties?: Record<string, any>;
+}
+type CircleStyleKey = "color" | "opacity" | "fillTranslate" | "fillPattern" | "antialias" | "strokeColor" | "strokeWidth" | "strokeOpacity" | "strokeLineType" | "strokeDasharray" | "strokeBlur" | "strokeTranslate" | "strokeLineCap" | "strokeLineJoin";
+declare class Circle {
+    readonly id: string;
+    constructor(options: CircleOptions);
+    bindTo(mapOrSdk: any): this;
+    getCenter(): [
+        number,
+        number
+    ];
+    setCenter(center: [
+        number,
+        number
+    ]): this;
+    getRadius(): number;
+    setRadius(radius: number): this;
+    getBounds(): [
+        [
+            number,
+            number
+        ],
+        [
+            number,
+            number
+        ]
+    ];
+    contains(lnglat: [
+        number,
+        number
+    ]): boolean;
+    setStyle(style: Partial<Pick<CircleOptions, CircleStyleKey>>): this;
+    setLabel(label: string): this;
+    show(): this;
+    hide(): this;
+    isVisible(): boolean;
+    remove(): void;
+}
+interface TextOptions {
+    position: [
+        number,
+        number
+    ];
+    text: string;
+    /** 字号，默认 14 */
+    fontSize?: number;
+    /** 字体族列表，如 ["Arial", "sans-serif"] */
+    fontFamily?: string[];
+    /** 字重："normal" | "bold"，默认 "normal" */
+    fontWeight?: "normal" | "bold";
+    /** 字体样式："normal" | "italic"，默认 "normal" */
+    fontStyle?: "normal" | "italic";
+    /** 文字颜色，默认 "#000000" */
+    color?: string;
+    /** 文字不透明度 0-1，默认 1 */
+    opacity?: number;
+    /** 光晕颜色，默认 "#ffffff" */
+    haloColor?: string;
+    /** 光晕宽度(px)，默认 1 */
+    haloWidth?: number;
+    /** 光晕模糊(px)，默认 0 */
+    haloBlur?: number;
+    /** 文字平移 [x, y] px */
+    translate?: [
+        number,
+        number
+    ];
+    /** 旋转角度(°)，默认 0 */
+    rotation?: number;
+    /** 锚点 */
+    anchor?: "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    /** 偏移 [x, y] em，默认 [0, 0] */
+    offset?: [
+        number,
+        number
+    ];
+    /** 对齐方式 */
+    justify?: "auto" | "left" | "center" | "right";
+    /** 是否允许重叠，默认 true */
+    allowOverlap?: boolean;
+    /** 是否忽略碰撞放置，默认 false */
+    ignorePlacement?: boolean;
+    /** 文字最大宽度(em)，超出自动换行，默认 10 */
+    maxWidth?: number;
+    /** 行高(em)，默认 1.2 */
+    lineHeight?: number;
+    /** 字间距(em)，默认 0 */
+    letterSpacing?: number;
+    /** 背景色（使用 symbol 的 text-halo 模拟） */
+    backgroundColor?: string;
+    /** 背景不透明度 */
+    backgroundOpacity?: number;
+    /** 鼠标指针样式 */
+    cursor?: string;
+    /** 层叠顺序：在此图层 id 前插入 */
+    beforeId?: string;
+    /** 最小可见缩放级别 */
+    minZoom?: number;
+    /** 最大可见缩放级别 */
+    maxZoom?: number;
+    /** 额外属性 */
+    properties?: Record<string, any>;
+}
+type TextStyleKey = "fontSize" | "fontWeight" | "color" | "opacity" | "haloColor" | "haloWidth" | "haloBlur" | "translate" | "rotation" | "anchor" | "offset" | "justify" | "maxWidth" | "lineHeight" | "letterSpacing";
+declare class Text {
+    readonly id: string;
+    constructor(options: TextOptions);
+    bindTo(mapOrSdk: any): this;
+    getText(): string;
+    setText(text: string): this;
+    getPosition(): [
+        number,
+        number
+    ];
+    setPosition(position: [
+        number,
+        number
+    ]): this;
+    setStyle(style: Partial<Pick<TextOptions, TextStyleKey>>): this;
+    show(): this;
+    hide(): this;
+    isVisible(): boolean;
+    remove(): void;
+}
+interface MarkerOptions {
+    position: [
+        number,
+        number
+    ];
+    /** 标注文字 */
+    label?: string;
+    /** 标注 CSS class */
+    labelClassName?: string;
+    /** 标注字号(px)，默认 12 */
+    labelFontSize?: number;
+    /** 标注颜色，默认 "#333" */
+    labelColor?: string;
+    /** 标注背景色，默认 "rgba(255,255,255,0.85)" */
+    labelBackground?: string;
+    /** 标注偏移 [x, y] px，默认 [0, 2] */
+    labelOffset?: [
+        number,
+        number
+    ];
+    /** 标注与图标相对位置 */
+    labelPosition?: "top" | "bottom" | "left" | "right";
+    /** 自定义图标 URL 或 DOM 元素 */
+    icon?: string | HTMLElement;
+    /** 图标宽度(px)，默认 24 */
+    iconWidth?: number;
+    /** 图标高度(px)，默认 24 */
+    iconHeight?: number;
+    /** 默认标记颜色（无 icon 时生效），默认 "#1890ff" */
+    color?: string;
+    /** 整体不透明度 0-1，默认 1 */
+    opacity?: number;
+    /** 整体缩放，默认 1 */
+    scale?: number;
+    /** 是否可拖拽，默认 false */
+    draggable?: boolean;
+    /** 旋转角度(°)，默认 0 */
+    angle?: number;
+    /** 锚点位置 */
+    anchor?: "center" | "top" | "bottom" | "left" | "right" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    /** 偏移 [x, y] px */
+    offset?: [
+        number,
+        number
+    ];
+    /** 鼠标指针样式，默认 "pointer" */
+    cursor?: string;
+    /** Popup 内容(HTML 字符串)，点击时弹出 */
+    popupContent?: string | HTMLElement;
+    /** Popup 偏移(px)，默认 25 */
+    popupOffset?: number;
+    /** Popup 最大宽度，默认 "240px" */
+    popupMaxWidth?: string;
+    /** 是否默认展开 Popup */
+    popupOpen?: boolean;
+    /** 额外 CSS class 加到包裹 DOM 上 */
+    className?: string;
+}
+type MarkerEventType = "click" | "dblclick" | "mouseenter" | "mouseleave" | "dragstart" | "drag" | "dragend";
+declare class EnhancedMarker {
+    readonly id: string;
+    constructor(options: MarkerOptions);
+    bindTo(mapOrSdk: any): this;
+    getPosition(): [
+        number,
+        number
+    ];
+    setPosition(position: [
+        number,
+        number
+    ]): this;
+    getLabel(): string | undefined;
+    setLabel(label: string): this;
+    setLabelStyle(style: Partial<Pick<MarkerOptions, "labelFontSize" | "labelColor" | "labelBackground">>): this;
+    setIcon(icon: string | HTMLElement): this;
+    setIconSize(width: number, height: number): this;
+    getDraggable(): boolean;
+    setDraggable(draggable: boolean): this;
+    getAngle(): number;
+    setAngle(angle: number): this;
+    setOpacity(opacity: number): this;
+    setPopup(content: string | HTMLElement): this;
+    openPopup(): this;
+    closePopup(): this;
+    show(): this;
+    hide(): this;
+    isVisible(): boolean;
+    on(event: MarkerEventType, fn: Function): this;
+    off(event: MarkerEventType, fn: Function): this;
+    remove(): void;
+}
+type LineType = "solid" | "dashed" | "dotted" | "dash-dot" | "long-dash" | "double-dash";
+interface PolylineOptions {
+    path: [
+        number,
+        number
+    ][];
+    /** 线颜色，默认 "#1890ff" */
+    color?: string;
+    /** 线宽(px)，默认 2 */
+    width?: number;
+    /** 线整体不透明度 0-1，默认 1 */
+    opacity?: number;
+    /** 预设线型（优先级高于 dasharray） */
+    lineType?: LineType;
+    /** 自定义虚线模式 [dash, gap, dash, gap, ...]（lineType 为空时生效） */
+    dasharray?: number[];
+    lineCap?: "butt" | "round" | "square";
+    lineJoin?: "bevel" | "round" | "miter";
+    /** 斜接限制（lineJoin='miter' 时生效），默认 2 */
+    miterLimit?: number;
+    /** 圆角限制（lineJoin='round' 时生效），默认 1.05 */
+    roundLimit?: number;
+    /** 线条模糊(px)，默认 0 */
+    blur?: number;
+    /** 线整体偏移(px)，正值向右偏移，默认 0 */
+    offset?: number;
+    /** 线整体平移 [x, y] px，默认 [0,0] */
+    translate?: [
+        number,
+        number
+    ];
+    /** 线条渐变色数组 [t, color, t, color, ...]（需 path 有一定长度） */
+    gradient?: any[];
+    /** 描边/边框宽度，0=无描边 */
+    borderWidth?: number;
+    /** 描边颜色 */
+    borderColor?: string;
+    /** 显示方向箭头 */
+    showArrow?: boolean;
+    /** 箭头间距(px)，默认 100 */
+    arrowSpacing?: number;
+    /** 沿线标注文字 */
+    label?: string;
+    /** 标注字号，默认 12 */
+    labelSize?: number;
+    /** 标注颜色，默认 同 color */
+    labelColor?: string;
+    /** 标注光晕颜色 */
+    labelHaloColor?: string;
+    /** 标注光晕宽度，默认 1 */
+    labelHaloWidth?: number;
+    /** 标注偏移(em)，默认 [0, -0.8] */
+    labelOffset?: [
+        number,
+        number
+    ];
+    /** 标注间距(px)，默认 250 */
+    labelSpacing?: number;
+    /** 鼠标指针样式，默认不设置 */
+    cursor?: string;
+    /** 层叠顺序：在此图层 id 前插入 */
+    beforeId?: string;
+    /** 最小可见缩放级别 */
+    minZoom?: number;
+    /** 最大可见缩放级别 */
+    maxZoom?: number;
+    /** 额外属性，会写入 GeoJSON properties */
+    properties?: Record<string, any>;
+}
+type PolylineStyleKey = "color" | "width" | "opacity" | "lineType" | "dasharray" | "blur" | "offset" | "translate" | "borderWidth" | "borderColor" | "lineCap" | "lineJoin";
+declare class Polyline {
+    readonly id: string;
+    constructor(options: PolylineOptions);
+    bindTo(mapOrSdk: any): this;
+    getPath(): [
+        number,
+        number
+    ][];
+    setPath(path: [
+        number,
+        number
+    ][]): this;
+    getLength(): number;
+    getBounds(): [
+        [
+            number,
+            number
+        ],
+        [
+            number,
+            number
+        ]
+    ];
+    setStyle(style: Partial<Pick<PolylineOptions, PolylineStyleKey>>): this;
+    setLabel(label: string): this;
+    show(): this;
+    hide(): this;
+    isVisible(): boolean;
+    remove(): void;
+}
+interface PolygonOptions {
+    path: [
+        number,
+        number
+    ][][];
+    /** 填充颜色，默认 "#1890ff" */
+    color?: string;
+    /** 填充不透明度 0-1，默认 0.25 */
+    opacity?: number;
+    /** 填充平移 [x, y] px */
+    fillTranslate?: [
+        number,
+        number
+    ];
+    /** 填充图案（需先 addImage 注册图案 id） */
+    fillPattern?: string;
+    /** 抗锯齿，默认 true */
+    antialias?: boolean;
+    /** 描边颜色，默认同 color */
+    strokeColor?: string;
+    /** 描边宽度(px)，默认 2 */
+    strokeWidth?: number;
+    /** 描边不透明度 0-1，默认 0.8 */
+    strokeOpacity?: number;
+    /** 预设描边线型（优先级高于 strokeDasharray） */
+    strokeLineType?: StrokeLineType;
+    /** 自定义描边虚线模式 */
+    strokeDasharray?: number[];
+    /** 描边端头样式 */
+    strokeLineCap?: "butt" | "round" | "square";
+    /** 描边拐角样式 */
+    strokeLineJoin?: "bevel" | "round" | "miter";
+    /** 描边模糊(px) */
+    strokeBlur?: number;
+    /** 描边偏移(px) */
+    strokeOffset?: number;
+    /** 描边平移 [x, y] px */
+    strokeTranslate?: [
+        number,
+        number
+    ];
+    /** 面心标注文字 */
+    label?: string;
+    /** 标注字号，默认 14 */
+    labelSize?: number;
+    /** 标注颜色，默认 "#333" */
+    labelColor?: string;
+    /** 标注光晕颜色 */
+    labelHaloColor?: string;
+    /** 标注光晕宽度，默认 1 */
+    labelHaloWidth?: number;
+    /** 标注锚点 */
+    labelAnchor?: "center" | "left" | "right" | "top" | "bottom";
+    /** 标注偏移 [x, y] em */
+    labelOffset?: [
+        number,
+        number
+    ];
+    /** 鼠标指针样式 */
+    cursor?: string;
+    /** 层叠顺序：在此图层 id 前插入 */
+    beforeId?: string;
+    /** 最小可见缩放级别 */
+    minZoom?: number;
+    /** 最大可见缩放级别 */
+    maxZoom?: number;
+    /** 额外属性 */
+    properties?: Record<string, any>;
+}
+type PolygonStyleKey = "color" | "opacity" | "fillTranslate" | "fillPattern" | "antialias" | "strokeColor" | "strokeWidth" | "strokeOpacity" | "strokeLineType" | "strokeDasharray" | "strokeBlur" | "strokeOffset" | "strokeTranslate" | "strokeLineCap" | "strokeLineJoin";
+declare class EnhancedPolygon {
+    readonly id: string;
+    constructor(options: PolygonOptions);
+    bindTo(mapOrSdk: any): this;
+    getPath(): [
+        number,
+        number
+    ][][];
+    setPath(path: [
+        number,
+        number
+    ][][]): this;
+    getArea(): number;
+    getBounds(): [
+        [
+            number,
+            number
+        ],
+        [
+            number,
+            number
+        ]
+    ];
+    contains(lnglat: [
+        number,
+        number
+    ]): boolean;
+    setStyle(style: Partial<Pick<PolygonOptions, PolygonStyleKey>>): this;
+    setLabel(label: string): this;
+    show(): this;
+    hide(): this;
+    isVisible(): boolean;
+    remove(): void;
+}
+interface GraticuleConfig {
+    enabled?: boolean;
+    interval?: number;
+    lineColor?: string;
+    lineWidth?: number;
+    lineOpacity?: number;
+    lineDasharray?: number[];
+    labelColor?: string;
+    labelSize?: number;
+    showLabels?: boolean;
+    labelFormat?: 'decimal' | 'dms';
+}
+/**
+ * 实现网格线功能，包括添加网格线、添加标注等
+ * @param {EngineMap} map 地图实例
+ * @param {GraticuleConfig} config 配置
+ * @returns {GraticuleManager}
+ */
+declare class GraticuleManager {
+    constructor(map: Map, config?: GraticuleConfig);
+    /** 缩放更新 */
+    update(): void;
+    show(): void;
+    hide(): void;
+    /**
+     * 切换网格线显示状态
+     */
+    toggle(): void;
+    /**
+     * 更新配置
+     */
+    updateConfig(newConfig: Partial<GraticuleConfig>): void;
+    remove(): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): Required<GraticuleConfig>;
+    /**
+     * 获取可见性状态
+     */
+    isGraticuleVisible(): boolean;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}
+interface IMapSDK {
+    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 | undefined): Promise<void>;
+    removeBuiltInLayer(layerName: string): void;
+    toggleBuiltInLayer(layerName: string): void;
+    getBuiltInLayers(): Object;
+    updateLayerStyle(layerId: string, style: StyleConfig): void;
+    setMapStyle(style: string | StyleSpecification, options?: {
+        diff?: boolean;
+    }): Promise<void>;
+    setTheme(theme: string): void;
+    addPoint(coordinates: [
+        number,
+        number
+    ], properties?: Record<string, any>, style?: StyleConfig): string;
+    addLine(coordinates: [
+        number,
+        number
+    ][], properties?: Record<string, any>, style?: StyleConfig): string;
+    addPolygon(coordinates: [
+        number,
+        number
+    ][][], properties?: Record<string, any>, style?: StyleConfig): string;
+    addGeoJSON(sourceId: string, geojson?: GeoJSON | string | null | undefined, props?: GeoJSONSourceSpecification | null | undefined): any;
+    showLayers(layerIds: string[]): void;
+    hideLayers(layerIds: string[]): void;
+    on(event: string, listener: Function): void;
+    off(event: string, listener: Function): void;
+    getCenter(): [
+        number,
+        number
+    ];
+    getZoom(): number;
+    getBounds(): [
+        [
+            number,
+            number
+        ],
+        [
+            number,
+            number
+        ]
+    ];
+    destroy(): void;
+    use(plugin: IPlugin): void;
+    getPlugin<T extends IPlugin>(name: string): T | undefined;
+    setPeriod(period: string, options?: {
+        validate?: boolean;
+    }): void;
+    getPeriod(): string | undefined;
+    generateCurrentPeriod(): Promise<string>;
+    showGraticule(): void;
+    hideGraticule(): void;
+    toggleGraticule(): void;
+    updateGraticuleConfig(config: Partial<GraticuleConfig>): void;
+    isGraticuleVisible(): boolean;
+}
+interface ILayerManager {
+    addLayer(config: LayerConfig): string;
+    removeLayer(id: string): boolean;
+    updateLayer(id: string, updates: Partial<LayerConfig>): boolean;
+    showLayer(id: string): boolean;
+    hideLayer(id: string): boolean;
+    toggleLayer(id: string): boolean;
+    getLayer(id: string): LayerConfig | undefined;
+    getAllLayers(): LayerConfig[];
+    batchShowLayers(ids: string[]): void;
+    batchHideLayers(ids: string[]): void;
+    batchUpdateLayers(updates: Array<{
+        id: string;
+        updates: Partial<LayerConfig>;
+    }>): void;
+    addBuiltInLayer(name: string, zindex?: string | undefined): Promise<void>;
+    removeBuiltInLayer(name: string): boolean;
+    getBuiltInLayers(): Record<string, string[]>;
+    isBuiltInLayerVisible(id: string): boolean;
+    setLODEnabled(enabled: boolean): void;
+    setLayerLODConfig(layerId: string, config: LODConfig): void;
+}
+interface IGeoJSONManager {
+    addPoint(coordinates: [
+        number,
+        number
+    ], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    addLine(coordinates: [
+        number,
+        number
+    ][], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    addPolygon(coordinates: [
+        number,
+        number
+    ][][], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    addGeoJSON(sourceId: string, geojson?: GeoJSON | string | null | undefined, props?: GeoJSONSourceSpecification | null | undefined): any;
+    removeFeature(id: string): boolean;
+    updateFeature(id: string, updates: Partial<GeoJSONFeature>): boolean;
+    clearAllFeatures(): void;
+    getFeature(id: string): GeoJSONFeature | undefined;
+    getAllFeatures(): GeoJSONFeature[];
+    setClusteringEnabled(enabled: boolean): void;
+    setClusteringConfig(layerId: string, config: ClusteringConfig): void;
+}
+interface IPlugin {
+    name: string;
+    version: string;
+    install(sdk: IMapSDK): void;
+    uninstall?(sdk: IMapSDK): void;
+}
+interface SDKError extends Error {
+    code: string;
+    details?: any;
+    recoverable: boolean;
+}
+type ErrorHandler = (error: SDKError) => void | Promise<void>;
+interface LODConfig {
+    minZoom: number;
+    maxZoom: number;
+    minPixelSize: number;
+    maxPixelSize: number;
+    cullingEnabled: boolean;
+}
+interface ClusteringConfig {
+    enabled: boolean;
+    radius: number;
+    maxZoom: number;
+    minPoints: number;
+}
+interface MapSDKOptions {
+    container: string | HTMLElement;
+    style?: string | object;
+    center?: [
+        number,
+        number
+    ];
+    zoom?: number;
+    minZoom?: number;
+    maxZoom?: number;
+    pitch?: number;
+    bearing?: number;
+    interactive?: boolean;
+    preserveDrawingBuffer?: boolean;
+    errorHandler?: ErrorHandler;
+    performance?: {
+        lodEnabled?: boolean;
+        clusteringEnabled?: boolean;
+        lazyLoadingEnabled?: boolean;
+    };
+    plugins?: IPlugin[];
+    apiKey?: string;
+    period?: string;
+    version?: string;
+    baseUrl?: string;
+    staticUrl?: string;
+    /** 新航图数据栈（navdata MVT / terrain）服务地址，默认 https://aips.siniswift.com */
+    apiUrl?: string;
+    /**
+     * API 版本段，如 "v1"。设置后所有 /api 接口请求 `${apiUrl}/api/v1/...`；
+     * 不设则走无版本 `${apiUrl}/api/...`（等价后端 v1，向后兼容现网）。
+     * 用于接口/瓦片格式契约有破坏性变更时切版本与回退。
+     */
+    apiVersion?: string;
+    /**
+     * 授权密钥，格式 "customerId.base64Key"，由服务方逐个发放。
+     * 设置后 SDK 走加密瓦片通道（`/api/tiles/e/`），运行时换取当期密钥并本地解密；
+     * 不设则走明文瓦片通道（向后兼容现网老用户）。密钥不入公开包。
+     */
+    licenseKey?: string;
+    /** sprite 服务地址（默认同 apiUrl，拼 /sprites/sprite[-color|-v2]） */
+    spriteUrl?: string;
+    /** 地形 DEM 瓦片 URL 模板（{z}/{x}/{y}），默认 `${apiUrl}/api/terrain/...` */
+    terrainUrl?: string;
+    /**
+     * 初始化图层组可见性（未列出的组保持默认）。
+     * 组名同 setLayerVisible：airspace/airline/controlled/restricted/vor/ndb/
+     * airport/adiz/waypointOffAirway/amm/terrain/contour 及 0.1.x 别名 fir/segment。
+     */
+    layers?: Record<string, boolean>;
+    enableAIP?: boolean;
+    enableNOTAM?: boolean;
+    enableADSB?: boolean;
+    /**
+     * 主题 id。内置 'light' | 'dark'，以及 aviation-chart 样式里注册的其它主题
+     * （如 'dusk' | 'sectional'）。未注册的值回退到 'light'。
+     */
+    theme?: string;
+    language?: 'zh-CN' | 'en-US';
+    switchDay?: number;
+    graticule?: {
+        enabled?: boolean;
+        interval?: number;
+        lineColor?: string;
+        lineWidth?: number;
+        lineOpacity?: number;
+        lineDasharray?: number[];
+        labelColor?: string;
+        labelSize?: number;
+        labelOffset?: [
+            number,
+            number
+        ];
+        showLabels?: boolean;
+        labelFormat?: 'decimal' | 'dms';
+    };
+}
+interface LayerConfig {
+    id: string;
+    name: string;
+    description?: string;
+    category: "base" | "overlay" | "label" | "custom";
+    type: "background" | "fill" | "line" | "symbol" | "raster" | "hillshade" | "circle" | "custom";
+    source: string;
+    sourceLayer?: string;
+    defaultVisible: boolean;
+    paint?: any;
+    layout?: any;
+    filter?: any[];
+    lod?: LODConfig;
+    lazyLoad?: boolean;
+    maxzoom?: number;
+    minzoom?: number;
+    "source-layer"?: string;
+}
+interface BuiltInLayer extends LayerConfig {
+    builtin: true;
+}
+interface GeoJSONFeature {
+    id: string;
+    type: "Feature";
+    geometry: {
+        type: "Point" | "LineString" | "Polygon" | "MultiPoint" | "MultiLineString" | "MultiPolygon";
+        coordinates: any;
+    };
+    properties: Record<string, any>;
+    style?: StyleConfig;
+}
+interface GeoJSONCollection {
+    type: "FeatureCollection";
+    features: GeoJSONFeature[];
+}
+interface StyleConfig {
+    paint?: any;
+    layout?: any;
+    filter?: any[];
+}
+interface MapEvent {
+    type: string;
+    target: any;
+    [key: string]: any;
+}
+type EventListener = (event: MapEvent) => void;
+interface HookContext {
+    sdk: IMapSDK;
+    [key: string]: any;
+}
+type HookCallback = (context: HookContext) => void | Promise<void>;
+interface HookRegistry {
+    [hookName: string]: HookCallback[];
+}
+type StyleImageMetadata = {
+    pixelRatio: number;
+    sdf: boolean;
+    usvg: boolean;
+    stretchX?: Array<[
+        number,
+        number
+    ]>;
+    stretchY?: Array<[
+        number,
+        number
+    ]>;
+    content?: [
+        number,
+        number,
+        number,
+        number
+    ];
+};
+type LayerRef = string | Array<string> | RegExp | ((arg0: LayerSpecification) => boolean);
+type HtmlFunction = (feature: any, popup: any) => string | Promise<string>;
+/**
+ * 实现ADS-B功能，包括飞机数据推算、飞机图层显示、飞机名称显示等
+ * @param {EngineMap} map 地图实例
+ * @returns {ADSB}
+ */
+declare class ADSB {
+    constructor(map: Map);
+    /**
+     * 开启 ADS-B 功能
+     * @param {Object} pointLayerConfig 点的图层配置,参考示例代码
+     * @param {Object} labelLayerConfig 飞机名称图层配置,参考示例代码
+     * @param {boolean} enableInterpolation 是否启用推算
+     * @returns void
+     */
+    open(pointLayerConfig?: any, labelLayerConfig?: any, enableInterpolation?: boolean): void;
+    /**
+     * 关闭 ADS-B 功能
+     * @returns void
+     */
+    close(): void;
+    /**
+     * 更新飞机数据
+      * @param {Array} features 飞机数据,features 是一个数组，每个元素是一个对象，对象的格式为Feature对象,参考示例代码
+      * @returns void
+     */
+    update(features: any): void;
+    /**
+     * 销毁 ADS-B 功能
+     * @returns void
+     */
+    destroy(): void;
+}
+type OffHandler$1 = () => void;
+/**
+ * 实现悬停功能，包括悬停图层、悬停要素、悬停弹窗等
+ * @param {EngineMap} map 地图实例
+ * @returns {HoverManager}
+ */
+declare class HoverManager {
+    constructor(map: Map);
+    /**
+     * 设置防抖延迟时间
+     */
+    setDebounceDelay(delay: number): void;
+    /**
+     * 当鼠标悬停在这些图层中的某个要素上时触发回调函数
+     * @param {string|Array<string>|RegExp|function} layers 触发回调的图层.
+     * @returns {function} 回调函数.
+     */
+    hoverLayer: (layers: LayerRef, cb: (e: any) => void) => void;
+    /** hover时展示feature的信息.
+    @param {string|Array<string>|RegExp|function} layers 触发的图层
+    @param htmlFunc 接收 feature 和 popup，并返回 HTML 字符串或 Promise<HTML字符串> 的函数
+    @param {Object<PopupOptions>} popupOptions 自定义popup.
+    */
+    hoverPopup(layers: LayerRef, htmlFunc: HtmlFunction, popupOptions?: PopupOptions): OffHandler$1;
+}
+type OffHandler = () => void;
+type LayerCallback = (e: any) => void;
+/**
+ * 实现点击功能，包括点击图层、点击要素、点击弹窗等
+ * @param {EngineMap} map 地图实例
+ * @returns {ClickManager}
+ */
+declare class ClickManager {
+    constructor(map: Map);
+    /**
+     * 当点击这些图层中的某个要素时触发回调函数
+     * @param {string|Array<string>|RegExp|function} layers 触发回调的图层
+     * @returns {function} 卸载回调
+     */
+    clickLayer: (layers: LayerRef, cb: LayerCallback) => OffHandler;
+    /**
+     * 点击时展示 feature 的信息
+     * @param layers 触发的图层
+     * @param htmlFunc 接收 feature 和 popup，并返回 HTML 字符串或 Promise<HTML字符串>
+     * @param popupOptions 自定义 popup
+     */
+    clickPopup(layers: LayerRef, htmlFunc: HtmlFunction, popupOptions?: PopupOptions): OffHandler;
+}
+/**
+ * @enum NotamDetailParams
+ * 通告详情参数
+ */
+type NotamDetailParams = {
+    notamSeries: string;
+    notamNoPart1: string;
+    notamNoPart2: string;
+    nof: string;
+    pageNo: number;
+    pageSize: number;
+    signal?: AbortSignal | null;
+};
+/**
+ * @enum NotamListParams
+ * 通告列表参数
+ */
+type NotamListParams = {
+    pageNo: number;
+    pageSize: number;
+    onlyGeojson: boolean;
+    typeC: boolean;
+    notamOffset: string;
+    isInternational: boolean;
+    isCompanyVersion: boolean;
+    signal?: AbortSignal | null;
+};
+/**
+ * @enum NotamDataParams
+ * 通告数据参数
+ */
+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;
+};
+/**
+ * @enum TyphoonVolcanoAshParams
+ * 台风火山灰参数
+ */
+type TyphoonVolcanoAshParams = {
+    AdvisoryText: string;
+    signal?: AbortSignal | null;
+};
+/**
+ * @enum RunwayDataParams
+ * 跑道数据参数
+ */
+type RunwayDataParams = {
+    AirportCode: string;
+    DataPeriod: string;
+    signal?: AbortSignal | null;
+};
+/**
+ * API 接口类
+ * @returns { API }
+ */
+declare class API {
+    constructor();
+    _baseUrl: string;
+    setBaseUrl(baseUrl: string): void;
+    /**
+     * 获取通告列表[可视化]
+     * @param { NotamListParams | {} } params 参数
+     * @returns { Promise<Response> } 返回结果
+     */
+    notam_list(params: NotamListParams | {}): Promise<Response>;
+    /**
+     * 获取通告详情
+     * @param { NotamDetailParams | {} } params 参数
+     * @returns { Promise<Response> } 返回结果
+     */
+    notam_detail(params: NotamDetailParams | {}): Promise<Response>;
+    /**
+     * 获取全部通告信息
+     * @param { NotamDataParams } params 参数
+     * @returns { Promise<Response> } 返回结果
+     */
+    notam_data(params: NotamDataParams): Promise<Response>;
+    /**
+     * 台风火山灰
+     * @param { TyphoonVolcanoAshParams | {} } params 参数
+     * @returns { Promise<Response> } 返回结果
+     */
+    typhoon_volcano_ash(params: TyphoonVolcanoAshParams | {}): Promise<Response>;
+    /**
+     * 获取跑道数据
+     * @param { RunwayDataParams } params 参数
+     * @returns { Promise<Response> } 返回结果
+     */
+    getRunwayData(params: RunwayDataParams): Promise<Response>;
+    /**
+     * 获取雷达图数据
+     * @param { AbortSignal | null } signal 信号量，用于取消请求
+     * @returns { Promise<Response> } 返回结果
+     */
+    getRadarData(signal?: AbortSignal | null): Promise<Response>;
+    /**
+     * 获取周期数据
+     * @param { AbortSignal | null } signal 信号量，用于取消请求
+     * @returns { Promise<Response> } 返回结果
+     */
+    getPeriodData(signal?: AbortSignal | null): Promise<Response>;
+    /**
+     * 获取索引数据
+     * @param data 数据
+     * @param { AbortSignal | null } signal 信号量，用于取消请求
+     * @returns
+     */
+    getIndexData(data: any, signal?: AbortSignal | null): Promise<Response>;
+    /**
+     * 获取机场信息
+     * @param airport 机场代码
+     * @param { AbortSignal | null } signal 信号量，用于取消请求
+     * @returns
+     */
+    getAirportPoint(airport: string, signal?: AbortSignal | null): Promise<unknown>;
+}
+/***
+ * 实现NOTAM功能，包括添加NOTAM航线通告、添加NOTAM区域通告等
+ * @param {EngineMap} map 地图实例
+ * @returns {NOTAM}
+ */
+declare class NOTAM {
+    hoverManager: HoverManager;
+    clickManager: ClickManager;
+    api: API;
+    constructor(map: Map);
+    defaultParams: {
+        pageNo: number;
+        pageSize: number;
+        onlyGeojson: boolean;
+        typeC: boolean;
+        notamOffset: string;
+        isInternational: boolean;
+        isCompanyVersion: boolean;
+    };
+    /**
+     *
+     * @param builtin 是否使用内置数据源
+     * @param lineLayerConfig 线图层配置
+     * @param fillLayerConfig 面图层配置
+     * @param isPattern 是否使用图案填充
+     * @returns
+     */
+    open(builtin: Boolean, lineLayerConfig?: any, fillLayerConfig?: any, isPattern?: boolean): void;
+    close(): void;
+    update(features: any): void;
+    hover(callback: (e: any) => void): void;
+    refresh(): void;
+    destroy(): void;
+    getNotamData(params?: any): Promise<any>;
+    openNotamDetail(): void;
+}
+declare class RasterManager {
+    constructor(map: Map);
+    get rasterSourceUrl(): string;
+    set rasterSourceUrl(url: string);
+    addRasterLayer(layerId: string, sourceId: string, meteoType: string): void;
+    updateRasterLayer(sourceId: string, newUrl: string, meteoType: string): void;
+    removeRasterLayer(layerId: string, sourceId: string): void;
+}
+/**
+ * 综合搜索 / 几何查询 —— 对接后端 /api/search 与 /api/geometry。
+ *
+ * 两个接口受 X-Api-Key 保护：调用时自动附带初始化传入的 apiKey。
+ */
+type FeatureType = "airport" | "waypoint" | "vor" | "ndb" | "airspace" | "restricted" | "controlled" | "airway";
+interface SearchParams {
+    /** 关键词（业务代码 / 名称 / 中文名），必填 */
+    q: string;
+    /** 数据类型，可选；不传则搜索全部类型 */
+    type?: FeatureType;
+    /** 期数 YYYYMM，可选；不传使用后端默认 */
+    period?: string;
+    /** 返回条数上限，默认 20 */
+    limit?: number;
+    /** 取消信号 */
+    signal?: AbortSignal;
+}
+interface SearchResultItem {
+    type: FeatureType;
+    /** 全局唯一 UUID，用于 getGeometry */
+    id: string;
+    /** 业务代码，如 ZBAA / A593 */
+    code: string;
+    name?: string;
+    name_chn?: string;
+}
+interface GeometryParams {
+    /** 数据类型，必填（决定查询哪张表） */
+    type: FeatureType;
+    /** 唯一 UUID（来自搜索结果的 id），必填 */
+    id: string;
+    /** 期数 YYYYMM，可选 */
+    period?: string;
+    /** 取消信号 */
+    signal?: AbortSignal;
+}
+/** 标准 GeoJSON Feature（点 / 线 / 面） */
+interface GeometryFeature {
+    type: "Feature";
+    geometry: {
+        type: "Point" | "LineString" | "Polygon" | "MultiPolygon" | "MultiLineString" | "MultiPoint";
+        coordinates: any;
+    };
+    properties: Record<string, any>;
+}
+/**
+ * 综合搜索。返回候选列表（含 type / id(UUID) / code / name），不含坐标。
+ * 拿到某条的完整几何请用 {@link getGeometry}。
+ */
+declare function searchFeatures(baseUrl: string, auth: string | Record<string, string> | undefined, params: SearchParams, version?: string): Promise<SearchResultItem[]>;
+/**
+ * 按 type + id(UUID) 获取完整几何。
+ * 点→Point、面→Polygon、航路→整合后的完整 LineString。
+ */
+declare function getFeatureGeometry(baseUrl: string, auth: string | Record<string, string> | undefined, params: GeometryParams, version?: string): Promise<GeometryFeature>;
+/**
+ * 获取全部可用期数列表（YYYYMM），按倒序排列——最新一期在最前。
+ */
+declare function getPeriods(baseUrl: string, apiKey?: string, signal?: AbortSignal, version?: string): Promise<string[]>;
+interface SelectFeatureOptions {
+    isHighlight: boolean;
+    highlightColor: string;
+    fillOpacity: number;
+    circleRadius: number;
+    tolerance: number;
+    multiSelect: boolean;
+    lineWidth: number;
+    onSelect: ((lngLat: {
+        lng: number;
+        lat: number;
+    }, feature: any, selectedFeatures: any[]) => void) | null;
+    onContextMenu: ((feature: any, properties: any) => void) | null;
+}
+declare class SelectFeature {
+    constructor(map: Map);
+    /**
+     * 设置允许选择的图层ID列表。
+     * @param layerIds 图层ID数组，传 null 或空数组表示所有图层可选。
+     */
+    setSelectLayers(layerIds: string[] | null): void;
+    setOptions(options: Partial<SelectFeatureOptions>): void;
+    enable(): void;
+    disable(): void;
+    removeSelectedFeatures(): void;
+    /**
+     * 只移除高亮图层和数据源，保留选中要素数组。
+     * 用于关闭高亮显示但保留选中状态。
+     */
+    removeHighlightLayersOnly(): void;
+    getSelected(): any[];
+    _updateHighlightLayer(): void;
+    _onClick(e: EngineTypes.MapMouseEvent): void;
+    _onContextMenu(e: MouseEvent): boolean;
+}
+/**
+ * @Author lw
+ * @Description 通用线要素标注去重类
+ * @Date 2025-10-27 09:30:00
+ * @LastEditTime 2025-10-28 15:15:00
+ * @LastEditors lw
+ */
+interface LineLabelOptions {
+    builtInKey: string;
+    lineLayerId: string;
+    lineLabelId: string;
+    fieldList: string[];
+    suffix?: string;
+}
+/**
+ * 通用线要素标注去重类
+ */
+declare class LineLabelOptimizer {
+    constructor(map: EngineTypes.Map, callback: Function);
+    get labelOptions(): LineLabelOptions;
+    set labelOptions(options: LineLabelOptions);
+    update(): void;
+    remove(): void;
+}
+/**
+ * 实现主题管理功能，包括应用主题样式、检查图层是否存在、应用图层样式、处理普通图层样式、处理数组类型的图层样式等
+ * @param {EngineMap} map 地图实例
+ * @returns {Theme}
+ */
+declare class Theme {
+    constructor(map: Map);
+    /**
+     * 检查图层是否存在
+     * @param {string} layerId - 图层ID
+     * @returns {boolean} 图层是否存在
+     */
+    layerExists: (layerId: string) => boolean;
+    /**
+     * 应用图层样式属性
+     * @param {string} layerId - 图层ID
+     * @param {Object} style - 样式对象，包含 paint 和 layout
+     * @param {boolean} checkLayerExists - 是否检查图层存在性
+     */
+    applyLayerStyle(layerId: string, style: any, checkLayerExists?: boolean): void;
+    /**
+     * 处理普通图层样式（非数组类型）
+     * @param {Object} customStyle - 自定义样式对象
+     */
+    handleNormalLayers(customStyle: any): void;
+    /**
+     * 处理数组类型的图层样式
+     * @param {Object} customStyle - 自定义样式对象
+     */
+    handleArrayLayers(customStyle: any): void;
+    /**
+     * 应用自定义主题样式到地图
+     * @param {Object} customStyle - 自定义样式配置对象
+     * @throws {Error} 当参数无效时抛出错误
+     */
+    setStyle: (customStyle: any) => void;
+}
+/**
+ * 风场帧描述(GFS 灰度 PNG,U/V 分量两张图)。
+ * 参考数据源:/meteo/meteorology/listGribPng?type=WIND
+ */
+interface WindFrame {
+    /** 预报基准时间,如 "2026-07-01 23:00:00" */
+    refTime: string;
+    /** U 分量灰度 PNG 地址 */
+    uUrl: string;
+    /** V 分量灰度 PNG 地址 */
+    vUrl: string;
+}
+interface WindOptions {
+    /** 粒子数量,默认 8000 */
+    numParticles?: number;
+    /** 速度系数,默认 1.2 */
+    speedFactor?: number;
+    /** 灰度编码半量程(128=0,±range),默认 14 */
+    dataRange?: number;
+}
+/** 风场接口尚未实现渲染，请勿作为可用绘制功能调用。 */
+declare class WindManager {
+    constructor(map: Map, options?: WindOptions);
+    /** 风场是否开启 */
+    get visible(): boolean;
+    /**
+     * 开启风场并渲染指定帧。
+     * @param frame U/V 分量帧;不传则由实现自行拉取最新一帧
+     */
+    open(frame?: WindFrame): void;
+    /** 切换预报帧(时间轴) */
+    setFrame(frame: WindFrame): void;
+    /** 关闭风场并释放图层 */
+    close(): void;
+}
+/**
+ * 实现地图SDK功能，包括地图初始化、图层管理、GeoJSON管理、插件管理、事件管理等
+ * @param {MapSDKOptions} options 地图初始化参数
+ * @returns {MapSDK}
+ */
+declare class MapSDK implements IMapSDK {
+    map: Map;
+    layerManager: ILayerManager;
+    geoJSONManager: IGeoJSONManager;
+    adsb: ADSB;
+    notam: NOTAM;
+    hover: HoverManager;
+    clickObj: ClickManager;
+    rasterManager: RasterManager;
+    graticule: GraticuleManager;
+    api: API;
+    selector: SelectFeature;
+    lineLabelOptimizer: LineLabelOptimizer;
+    theme: Theme;
+    /** 风场接口尚未实现渲染，请勿作为可用绘制功能调用。 */
+    wind: WindManager;
+    /** 初始化完成后 resolve，等同于 loadComplete 事件，但可以 await */
+    readonly ready: Promise<void>;
+    get globalConfig(): GlobalConfigManager;
+    get absb(): ADSB;
+    constructor(options: MapSDKOptions);
+    /**
+     * 设置地图中心点
+     * @param center 中心点坐标
+     * @returns void
+     */
+    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;
+    setMapStyle(style: string | StyleSpecification, options?: {
+        diff?: boolean;
+    }): Promise<void>;
+    setTheme(theme: string): void;
+    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;
+    createCircle(options: CircleOptions): Circle;
+    createText(options: TextOptions): Text;
+    createMarker(options: MarkerOptions): EnhancedMarker;
+    createPolyline(options: PolylineOptions): Polyline;
+    createPolygon(options: PolygonOptions): EnhancedPolygon;
+    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;
+    /**
+     * 按图层组开关可见性(aviation-chart 风格 API,与 addBuiltInLayer/
+     * toggleBuiltInLayer 双轨等效)。
+     *
+     * 组名支持旧名(airspace/airline/…)与 0.1.x 别名(fir/segment/…)。
+     */
+    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;
+    /**
+     * 设置 / 切换期数。
+     *
+     * 切期不重建地图、不重加图层——只把 navdata 源的瓦片 URL 模板换成新期数,
+     * 地图引擎 自动作废旧瓦片、拉取新瓦片,所有航图图层随之重绘。
+     *
+     * 保持同步调用(前端可直接 `sdk.setPeriod("202603")`,无需 await)。
+     * 传 `{ validate: true }` 时会先用 {@link getPeriods} 校验期数是否存在,
+     * 不存在则不切换,并通过 console.error + map "error" 事件上报(不抛异常,
+     * 以保持同步契约)。
+     *
+     * 真正发生切换时(且非初始化)会触发 map "periodchange" 事件 `{ from, to }`。
+     *
+     */
+    setPeriod(period: string, options?: {
+        validate?: boolean;
+    }): void;
+    /**
+     * 获取当前期数
+     */
+    getPeriod(): string | undefined;
+    /**
+     * 生成当前期数（格式：YYYYMM）
+     */
+    generateCurrentPeriod(): Promise<string>;
+    /**
+     * 综合搜索：按关键词（+可选类型）查询机场、航路点、VOR/NDB、空域、航路。
+     * 返回候选列表（type / id(UUID) / code / name），不含坐标——完整几何用
+     * {@link getGeometry} 按需拉取。接口受 X-Api-Key 保护，自动附带初始化的 apiKey。
+     *
+     */
+    search(params: SearchParams): Promise<SearchResultItem[]>;
+    /**
+     * 按 type + id(UUID) 获取完整几何（点→Point、面→Polygon、航路→整合后的
+     * 完整 LineString）。id 来自 {@link search} 结果。返回标准 GeoJSON Feature。
+     *
+     */
+    getGeometry(params: GeometryParams): Promise<GeometryFeature>;
+    /**
+     * 获取全部可用期数列表（YYYYMM），按倒序排列——最新一期在最前。
+     *
+     */
+    getPeriods(signal?: AbortSignal): Promise<string[]>;
+    /**
+     * 显示网格线
+     */
+    showGraticule(): void;
+    /**
+     * 隐藏网格线
+     */
+    hideGraticule(): void;
+    /**
+     * 切换网格线显示状态
+     */
+    toggleGraticule(): void;
+    /**
+     * 更新网格线配置
+     */
+    updateGraticuleConfig(config: Partial<GraticuleConfig>): void;
+    /**
+     * 获取网格线可见性状态
+     */
+    isGraticuleVisible(): boolean;
+    /**
+     * 获取地图边界
+     */
+    get showTileBoundaries(): boolean;
+    set showTileBoundaries(value: boolean);
+    /**
+     * 启用线要素标注去重
+     * @param lineLayerId 线要素图层ID
+     * @param lineLabelId 标注图层ID
+     * @param builtInKey 内置图层key
+     * @param fieldList 用于标注去重的字段列表
+     * @param suffix 去重后标注图层后缀
+     */
+    enableLineLabelDedup(lineLayerId: string, lineLabelId: string, builtInKey: string, fieldList?: string[], suffix?: string): void;
+    /**
+     * 禁用线要素标注去重，恢复原始标注
+     */
+    disableLineLabelDedup(): void;
+    registerIcon(id: string, url: string, options?: StyleImageMetadata): Promise<void>;
+    /**
+     * 设置自定义样式配置
+     * @param style 自定义样式配置
+     */
+    setStyle(style: object): void;
+    destroy(): void;
+}
+/**
+ * 图层组 → 物理图层 id 列表。图层组名沿用旧 SDK 命名(airspace/airline/…),
+ * 物理 id 也沿用旧 id,按 id 对接的用户代码零影响。
+ */
+declare const TYPEMAP: Record<string, string[]>;
+/**
+ * 图层组默认可见性。初始化时先套用此表,用户传入的 `layers` 选项再覆盖。
+ * 基础底图(background/landLayer/boundary)默认常开,用户仍可显式关闭。
+ */
+declare const DEFAULT_LAYER_VISIBILITY: Record<string, boolean>;
+/** aviation-chart 0.1.x 组名别名 → 旧组名(setLayerVisible 双轨等效) */
+declare const GROUP_ALIASES: Record<string, string>;
+declare class PerformanceManager {
+    constructor(options?: {
+        lodEnabled?: boolean;
+        clusteringEnabled?: boolean;
+        lazyLoadingEnabled?: boolean;
+    });
+    setLODEnabled(enabled: boolean): void;
+    setLayerLODConfig(layerId: string, config: LODConfig): void;
+    getLayerLODConfig(layerId: string): LODConfig | undefined;
+    setClusteringEnabled(enabled: boolean): void;
+    setClusteringConfig(layerId: string, config: ClusteringConfig): void;
+    getClusteringConfig(layerId: string): ClusteringConfig | undefined;
+    setLazyLoadingEnabled(enabled: boolean): void;
+    addToLazyLoadQueue(layerId: string, priority?: number): void;
+    shouldLayerBeVisible(layerId: string, currentZoom: number): boolean;
+    getPerformanceStats(): {
+        visibleLayers: number;
+        queuedLayers: number;
+        lodEnabled: boolean;
+        clusteringEnabled: boolean;
+        lazyLoadingEnabled: boolean;
+    };
+    optimizeLayerConfig(layer: LayerConfig, currentZoom: number): LayerConfig;
+    destroy(): void;
+}
+/**
+ */
+declare class LayerManager implements ILayerManager {
+    constructor(map: Map, performanceManager?: PerformanceManager, customLayerStyles?: Record<string, any>);
+    addLayer(layer: LayerConfig): string;
+    removeLayer(layerId: string): boolean;
+    updateLayer(layerId: string, updates: Partial<LayerConfig>): boolean;
+    showLayer(layerId: string): boolean;
+    hideLayer(layerId: string): boolean;
+    toggleLayer(layerId: string): boolean;
+    getLayer(layerId: string): LayerConfig | undefined;
+    getAllLayers(): LayerConfig[];
+    batchUpdateLayers(updates: Array<{
+        id: string;
+        updates: Partial<LayerConfig>;
+    }>): void;
+    batchShowLayers(layerIds: string[]): void;
+    batchHideLayers(layerIds: string[]): void;
+    /**
+     * 添加内置图层
+     * @param layerName 图层名称 或 图层名称数组
+     * @param zindex 图层层级
+     * @returns
+     * 内置图层会合并，如：空域分为空域区域和空域区域名称
+     */
+    addBuiltInLayer(layerName: string | Array<string>, zindex: string): Promise<void>;
+    removeBuiltInLayer(layerName: string): boolean;
+    getBuiltInLayers(): typeof TYPEMAP;
+    isBuiltInLayerVisible(layerId: string): boolean;
+    setLODEnabled(enabled: boolean): void;
+    setLayerLODConfig(layerId: string, config: LODConfig): void;
+}
+/**
+ * 实现GeoJSON功能，包括添加点、线、面、GeoJSON数据等
+ * @param {EngineMap} map 地图实例
+ * @param {PerformanceManager} performanceManager 性能管理器,可选
+ * @returns {GeoJSONManager}
+ */
+declare class GeoJSONManager implements IGeoJSONManager {
+    constructor(map: Map, performanceManager?: PerformanceManager);
+    /**
+     * 添加点要素
+     * @param {Array} coordinates 坐标
+     * @param {Object} properties 属性
+     * @param {Object} style 样式
+     * @param {String} id 图层要素id,可选
+     * @returns {String} featureId,自动生成的图层要素id，可用于删除、更新、获取要素
+     */
+    addPoint(coordinates: [
+        number,
+        number
+    ], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    /**
+     * 添加线要素
+     * @param {Array<Array<number, number>>} coordinates 坐标
+     * @param {Object} properties 属性
+     * @param {Object} style 样式
+     * @param {String} id 图层要素id,可选
+     * @returns {String} featureId,自动生成的图层要素id，可用于删除、更新、获取要素
+     */
+    addLine(coordinates: [
+        number,
+        number
+    ][], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    /**
+     * 添加面要素
+     * @param {Array<Array<Array<number, number>>>} coordinates 坐标
+     * @param {Object} properties 属性
+     * @param {Object} style 样式
+     * @param {String} id 图层要素id,可选
+     * @returns {String} featureId,自动生成的图层要素id，可用于删除、更新、获取要素
+     */
+    addPolygon(coordinates: [
+        number,
+        number
+    ][][], properties?: Record<string, any>, style?: StyleConfig, id?: string): string;
+    /**
+     * 添加GeoJSON数据
+     * @param {String} sourceId 数据源id
+     * @param {GeoJSON | string | null | undefined} geojson GeoJSON数据
+     * @param {GeoJSONSourceSpecification | null | undefined} props 数据源配置
+     * @returns {any} 数据源
+     */
+    addGeoJSON(sourceId: string, geojson?: GeoJSON | string | null | undefined, props?: GeoJSONSourceSpecification | null | undefined): any;
+    /**
+     * 删除图层要素
+     * @param {String} id 图层要素id
+     * @returns {boolean} 是否删除成功
+     */
+    removeFeature(id: string): boolean;
+    /**
+     * 根据id更新图层要素
+     * @param {String} id 图层要素id
+     * @param {Partial<GeoJSONFeature>} updates 更新内容
+     * @returns {boolean} 是否更新成功
+     */
+    updateFeature(id: string, updates: Partial<GeoJSONFeature>): boolean;
+    /**
+     * 删除全部的图层要素
+     * @returns {void}
+     */
+    clearAllFeatures(): void;
+    /**
+     * 根据id获取图层要素
+     * @param {String} id 图层要素id
+     * @returns {GeoJSONFeature | undefined} 图层要素
+     */
+    getFeature(id: string): GeoJSONFeature | undefined;
+    /**
+     * 获取全部的图层要素
+     * @returns {GeoJSONFeature[]} 全部的图层要素
+     */
+    getAllFeatures(): GeoJSONFeature[];
+    setClusteringEnabled(enabled: boolean): void;
+    setClusteringConfig(layerId: string, config: ClusteringConfig): void;
+}
+/**
+ * 实现错误管理功能，包括创建错误、添加错误处理器、移除错误处理器、处理错误、记录错误历史、获取错误历史、清空错误历史、获取错误统计、设置钩子、移除钩子等
+ * @returns {ErrorManager}
+ */
+declare class ErrorManager {
+    constructor();
+    /**
+     * 创建SDK错误
+     */
+    createError(message: string, code: string, details?: any, recoverable?: boolean): SDKError;
+    /**
+     * 添加错误处理器
+     */
+    addErrorHandler(handler: ErrorHandler): void;
+    /**
+     * 移除错误处理器
+     */
+    removeErrorHandler(handler: ErrorHandler): void;
+    /**
+     * 处理错误
+     */
+    handleError(error: SDKError): Promise<void>;
+    /**
+     * 获取错误历史
+     */
+    getErrorHistory(): SDKError[];
+    /**
+     * 清空错误历史
+     */
+    clearErrorHistory(): void;
+    /**
+     * 获取错误统计
+     */
+    getErrorStats(): {
+        total: number;
+        recoverable: number;
+        nonRecoverable: number;
+    };
+    /**
+     * 设置钩子
+     */
+    addHook(hookName: string, callback: HookCallback): void;
+    /**
+     * 移除钩子
+     */
+    removeHook(hookName: string, callback: HookCallback): void;
+    /**
+     * 触发钩子
+     */
+    triggerHook(hookName: string, context: any): Promise<void>;
+    /**
+     * 销毁错误管理器
+     */
+    destroy(): void;
+}
+/**
+ * 实现插件管理功能，包括注册插件、获取插件、卸载插件等
+ * @param {IMapSDK} sdk 地图实例
+ * @returns {PluginManager}
+ */
+declare class PluginManager {
+    constructor(sdk: IMapSDK);
+    /**
+     * 注册插件
+     */
+    use(plugin: IPlugin): void;
+    /**
+     * 获取插件
+     */
+    getPlugin<T extends IPlugin>(name: string): T | undefined;
+    /**
+     * 获取所有插件
+     */
+    getAllPlugins(): IPlugin[];
+    /**
+     * 检查插件是否存在
+     */
+    hasPlugin(name: string): boolean;
+    /**
+     * 卸载插件
+     */
+    uninstallPlugin(name: string): boolean;
+    /**
+     * 卸载所有插件
+     */
+    uninstallAllPlugins(): void;
+    /**
+     * 获取插件统计信息
+     */
+    getPluginStats(): {
+        total: number;
+        names: string[];
+    };
+    /**
+     * 销毁插件管理器
+     */
+    destroy(): void;
+}
+declare class MeasurePlugin implements IPlugin {
+    name: string;
+    version: string;
+    install(sdk: IMapSDK): void;
+    uninstall(sdk: IMapSDK): void;
+    /**
+     * 启用测量功能
+     */
+    enable(mode: 'distance' | 'area'): void;
+    /**
+     * 禁用测量功能
+     */
+    disable(): void;
+    /**
+     * 获取插件状态
+     */
+    getStatus(): {
+        isActive: boolean;
+        mode: string | null;
+        pointsCount: number;
+    };
+}
+declare class DrawPlugin implements IPlugin {
+    name: string;
+    version: string;
+    geoman: DrawingController | null;
+    install(sdk: IMapSDK): void;
+    uninstall(): void;
+    enableDrag(): void;
+    disableDrag(): void;
+    enableEdit(): void;
+    disableEdit(): void;
+}
+declare namespace CHART_THEMES {
+    namespace light {
+        let id: string;
+        let label: string;
+        let background: string;
+    }
+    namespace standard {
+        let id_1: string;
+        export { id_1 as id };
+        let label_1: string;
+        export { label_1 as label };
+        let background_1: string;
+        export { background_1 as background };
+    }
+    namespace dark {
+        let id_2: string;
+        export { id_2 as id };
+        let label_2: string;
+        export { label_2 as label };
+        let background_2: string;
+        export { background_2 as background };
+    }
+    namespace dusk {
+        let id_3: string;
+        export { id_3 as id };
+        let label_3: string;
+        export { label_3 as label };
+        let background_3: string;
+        export { background_3 as background };
+    }
+    namespace sectional {
+        let id_4: string;
+        export { id_4 as id };
+        let label_4: string;
+        export { label_4 as label };
+        let background_4: string;
+        export { background_4 as background };
+    }
+}
+declare namespace LAYER_GROUPS {
+    export let adiz: string[];
+    export let airspace: string[];
+    export let restricted: string[];
+    let controlled_1: string[];
+    export { controlled_1 as controlled };
+    export let airline: string[];
+    export let waypointOffAirway: string[];
+    let vor_1: string[];
+    export { vor_1 as vor };
+    let ndb_1: string[];
+    export { ndb_1 as ndb };
+    let airport_1: string[];
+    export { airport_1 as airport };
+}
+declare namespace LAYER_LABELS {
+    let adiz_1: string;
+    export { adiz_1 as adiz };
+    let airspace_1: string;
+    export { airspace_1 as airspace };
+    let restricted_1: string;
+    export { restricted_1 as restricted };
+    let controlled_2: string;
+    export { controlled_2 as controlled };
+    let airline_1: string;
+    export { airline_1 as airline };
+    let waypointOffAirway_1: string;
+    export { waypointOffAirway_1 as waypointOffAirway };
+    let vor_2: string;
+    export { vor_2 as vor };
+    let ndb_2: string;
+    export { ndb_2 as ndb };
+    let airport_2: string;
+    export { airport_2 as airport };
+}
+export { API, MapSDK as AviationChart, BuiltInLayer, CHART_THEMES, Circle, CircleOptions, ClusteringConfig, DEFAULT_LAYER_VISIBILITY, DrawPlugin, EnhancedMarker, EnhancedPolygon, ErrorHandler, ErrorManager, EventListener, FeatureType, GROUP_ALIASES, GeoJSONCollection, GeoJSONFeature, GeoJSONManager, GeometryFeature, GeometryParams, GlobalConfigManager, HookCallback, HookContext, HookRegistry, IGeoJSONManager, ILayerManager, IMapSDK, IPlugin, LAYER_GROUPS, LAYER_LABELS, LODConfig, LayerConfig, LayerManager, LineType, MapEvent, MapSDK, MapSDKOptions, MarkerOptions, MeasurePlugin, NOTAM, PerformanceManager, PluginManager, PolygonOptions, Polyline, PolylineOptions, SDKError, SearchParams, SearchResultItem, StrokeLineType, StyleConfig, TYPEMAP, Text, TextOptions, WindFrame, WindManager, WindOptions, MapSDK as default, getFeatureGeometry, getPeriods, globalConfig, searchFeatures };
+```