@tianditu/core 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,662 @@
+import "../types/global.d.mts";
+//#region src/events.d.ts
+/**
+ * 天地图事件对象的事件桥：包装 addEventListener/removeEventListener，
+ * 记录全部监听器以便随会话销毁统一移除。
+ */
+interface EventTargetLike<E> {
+  addEventListener<K extends keyof E>(event: K, handler: E[K]): void;
+  removeEventListener<K extends keyof E>(event: K, handler: E[K]): void;
+}
+declare class EventBridge<E> {
+  private readonly target;
+  private readonly listeners;
+  constructor(target: EventTargetLike<E>);
+  /** 注册监听器，返回解绑函数 */
+  on<K extends keyof E>(event: K, handler: E[K]): () => void;
+  off<K extends keyof E>(event: K, handler: E[K]): void;
+  /** 移除全部经由本桥注册的监听器 */
+  destroy(): void;
+}
+/**
+ * 以宽松事件签名挂接命名事件集。SDK 侧（Mousetool/TileLayer 等）的事件
+ * 方法为泛型签名（keyof E），跨实体统一挂接时按宽签名收口；
+ * 目标缺少事件 API 时静默跳过。
+ */
+declare function bindEventNames(target: unknown, names: readonly string[], dispatch: (name: string, event: unknown) => void): () => void;
+//#endregion
+//#region src/compact.d.ts
+/**
+ * SDK 构造参数对显式 undefined 与字段默认不等价（如控件 options 携带
+ * position: undefined 时 addControl 直接报错），构造前统一剔除。
+ */
+declare function compact<T extends object>(options: T): T;
+//#endregion
+//#region src/loader.d.ts
+/**
+ * 天地图 JS API 的幂等加载器。
+ *
+ * 加载流程：fetch 主脚本文本 → 预填组件包缓存 → 内联执行。预填的原因：
+ * SDK 主脚本会并行加载组件包（localStorage 无缓存时经 XHR 乱序执行），
+ * 而包间存在依赖（如 military.js 依赖 components.js 的 Tool），乱序时
+ * 依赖包执行中断、包内类整体丢失；将组件包先按序写入 localStorage 后，
+ * SDK 检查缓存命中即同步顺序执行，从源头规避竞态。预填失败或组件包
+ * 仍缺失时（隐私模式、官方改版等），按哨兵检测补载兜底。
+ *
+ * SDK 挂载在全局 `window.T` 上且无卸载途径，以模块级 Promise 缓存保证
+ * 并发调用共享同一次加载，失败时重置缓存以便重试。
+ */
+interface LoadTdtOptions {
+  /** 开发者密钥（tk） */
+  tk: string;
+  /** SDK 版本，默认 "4.0" */
+  version?: string;
+  /** SDK 地址前缀，默认官方地址 */
+  baseURL?: string;
+}
+declare function loadTdt(options: LoadTdtOptions): Promise<typeof T>;
+/**
+ * 构造就绪守卫：SDK 扩展类构造过早会抛 "is not a constructor"，此类
+ * 时序错误按固定间隔重试直至成功；超时抛出最后一次的真实错误，其余
+ * 错误立即抛出。
+ */
+declare function createWhenReady<T>(create: () => T, timeout?: number): Promise<T>;
+//#endregion
+//#region src/session.d.ts
+/**
+ * 地图会话：一个容器元素内 `T.Map` 实例的完整生命周期。
+ * 天地图 4.0 没有正规的销毁 API，destroy 做的是尽最大努力的资源回收。
+ */
+interface MapSession {
+  map: T.Map;
+  el: HTMLElement;
+  /** 地图事件桥，随 destroy 统一解绑 */
+  events: EventBridge<T.MapEvents>;
+  /** 仅改中心：SDK 无 setCenter，以当前级别 centerAndZoom 实现 */
+  setCenter(center: T.LngLat | [number, number]): void;
+  destroy(): void;
+}
+/** 官方示例通用的默认中心（北京）与级别 */
+declare const DEFAULT_CENTER: [number, number];
+interface CreateMapSessionOptions {
+  tk: string;
+  version?: string;
+  baseURL?: string;
+  /** 地图投影 */
+  projection?: string;
+  minZoom?: number;
+  maxZoom?: number;
+  maxBounds?: T.LngLatBounds;
+  /** 初始中心点，允许以 [lng, lat] 数组表达；不传时回退北京，locate 开启时定位用户位置（计入 JavaScriptApi 配额） */
+  center?: T.LngLat | [number, number];
+  /**
+   * center 不传时的定位方式；默认 false（回退北京，零定位调用）。
+   * - "geolocation"：仅浏览器定位（触发授权请求、高精度）
+   * - "ip"：仅官方 IP 定位（城市级）
+   * - "auto" 或 true：优先浏览器定位，失败回退 IP 定位
+   */
+  locate?: boolean | "geolocation" | "ip" | "auto";
+  zoom?: number;
+}
+declare function createMapSession(el: HTMLElement, options: CreateMapSessionOptions): Promise<MapSession>;
+declare function toLngLat(value: T.LngLat | [number, number]): T.LngLat;
+declare function toLngLats(value: Array<T.LngLat | [number, number]>): T.LngLat[];
+//#endregion
+//#region src/props-sync.d.ts
+/**
+ * props-sync 引擎：把响应式 props diff 成命令式 setter 调用。
+ * 与具体框架解耦，仅依赖 @vue/reactivity 的 effect（watch 属于
+ * runtime-core，这里用 effect 自行实现等效语义），供各框架适配层复用。
+ */
+type SyncDef<T, P> = { [K in keyof P]?: (target: T, value: P[K], prev: P[K] | undefined) => void; };
+/**
+ * 跟踪 target 与 props 两个响应式源：props 变化时按 key 浅比较后调用对应
+ * setter；首次执行或 target 就绪（从未就绪变为就绪）时对所有 key 做一次
+ * 全量应用（skipInitialApply 为 true 时跳过，适用于构造时已携带全部
+ * props 的实例，避免冗余 setter 调用）。返回 stop 函数，由适配层在卸载时调用。
+ */
+declare function createPropsSync<T, P extends object>(target: () => T | undefined, props: () => P, defs: SyncDef<T, P>, options?: {
+  skipInitialApply?: boolean;
+}): () => void;
+//#endregion
+//#region src/map.d.ts
+/**
+ * Map 类的官方事件与交互开关，清单以官方 Map 文档页为准。
+ * 文档外的事件（如 dblclick/mousemove 等 SDK 内部事件）不进直发表，
+ * 可经 map 会话的事件桥命令式挂接。
+ */
+declare const MAP_EVENT_NAMES: readonly ["click", "contextmenu", "mouseover", "movestart", "moveend", "zoomend", "removeoverlay", "removecontrol", "dragstart", "dragend", "layerremove", "resize", "touchstart", "touchend"];
+interface MapInteractionOptions {
+  dragging?: boolean;
+  scrollWheelZoom?: boolean;
+  doubleClickZoom?: boolean;
+  keyboard?: boolean;
+  inertia?: boolean;
+  continuousZoom?: boolean;
+  pinchToZoom?: boolean;
+  autoResize?: boolean;
+}
+/** 初始化时一次性应用交互开关；未配置的项保持 SDK 默认（启用） */
+declare function applyMapInteractions(map: T.Map, options: MapInteractionOptions): void;
+//#endregion
+//#region src/overlay.d.ts
+/**
+ * 覆盖物的挂载编排。天地图覆盖物有两种去向：直接上屏（map.addOverLay）
+ * 或加入点聚合（collector），由挂载上下文表达；MarkerClusterer 等非常规
+ * 收尾经 attach/detach 钩子覆盖。
+ */
+/** 聚合收集器（MarkerClusterer 提供给内部 Marker） */
+interface OverlayCollector {
+  addMarker(marker: T.Marker): void;
+  removeMarker(marker: T.Marker): void;
+}
+interface OverlayMountContext {
+  map: T.Map;
+  /** 存在时覆盖物加入聚合而非直接上屏 */
+  collector?: OverlayCollector;
+}
+interface OverlayMountSpec<P extends object, O> {
+  /** 响应式 props getter（框架适配层传入） */
+  props: () => P;
+  /** props diff → 实例 setter */
+  sync?: SyncDef<O, P>;
+  /** SDK 原生事件名 */
+  events?: readonly string[];
+  dispatch: (name: string, event: unknown) => void;
+  /** 构造实例；上屏由 attach 统一编排 */
+  create(ctx: OverlayMountContext): O;
+  /** 默认：有 collector 走 addMarker，否则 addOverLay；this: void 允许适配层直接传递 def 钩子引用 */
+  attach?: (this: void, instance: O, ctx: OverlayMountContext) => void;
+  /** 默认：有 collector 走 removeMarker，否则 removeOverLay */
+  detach?: (this: void, instance: O, ctx: OverlayMountContext) => void;
+}
+interface OverlayHandle<O> {
+  readonly instance: O;
+  readonly context: OverlayMountContext;
+  /** 停同步、解绑事件并卸载实例 */
+  destroy(): void;
+}
+declare function mountOverlay<P extends object, O>(ctx: OverlayMountContext, spec: OverlayMountSpec<P, O>): OverlayHandle<O>;
+//#endregion
+//#region src/infoWindow.d.ts
+/**
+ * 信息窗的纯 SDK 编排（对照官方 InfoWindow/Map/Marker 文档页）：
+ * 打开是宿主方法（map.openInfoWindow(win, lnglat) / marker.openInfoWindow(win)），
+ * 关闭是窗方法（closeInfoWindow）；内容容器为 DOM 时由本层创建，
+ * 框架适配层可将其作为渲染目标。
+ */
+interface InfoWindowSpec {
+  /** 窗体内容：HTML 字符串或容器元素；默认创建空 div 供适配层渲染 */
+  content?: string | HTMLElement;
+  minWidth?: number;
+  maxWidth?: number;
+  maxHeight?: number;
+  autoPan?: boolean;
+  closeButton?: boolean;
+  offset?: T.Point;
+  autoPanPadding?: T.Point;
+  closeOnClick?: boolean;
+}
+type InfoWindowHost = T.Map | T.Marker;
+interface InfoWindowHandle {
+  readonly win: T.InfoWindow;
+  /** content 为 DOM 时返回该容器，否则返回窗体内容容器 */
+  readonly container: HTMLElement;
+  /** 在宿主上打开；宿主为 Map 且未传坐标时取地图中心 */
+  openOn(host: InfoWindowHost, lnglat?: T.LngLat | [number, number]): void;
+  close(): void;
+  isOpen(): boolean;
+  /** 解绑事件；窗体本身由 SDK 管理 */
+  destroy(): void;
+}
+declare const INFO_WINDOW_EVENT_NAMES: readonly ["open", "close", "clickclose"];
+declare function createInfoWindow(spec: InfoWindowSpec, dispatch: (name: (typeof INFO_WINDOW_EVENT_NAMES)[number], event: unknown) => void): InfoWindowHandle;
+//#endregion
+//#region src/tools.d.ts
+/**
+ * 地图工具（Mousetool 体系及 CoordinatePickup）的协议与生命周期编排。
+ *
+ * Mousetool 基类以 open/close 开关并暴露泛型事件签名；CoordinatePickup
+ * 以 addEvent/removeEvent 开关且无事件监听，因此协议只约定开关动作，
+ * 事件按宽松签名挂接。
+ */
+/** 工具实例的开关协议 */
+interface ToolLike {
+  open?(): unknown;
+  close?(): unknown;
+  addEvent?(): unknown;
+  removeEvent?(): unknown;
+}
+interface ToolMountOptions {
+  map: T.Map;
+  create(): ToolLike;
+  /** 需要挂接的 SDK 原生事件名 */
+  events?: readonly string[];
+  /** 事件分发回调（事件名 + 原生事件对象） */
+  dispatch: (name: string, event: unknown) => void;
+  /** 默认调用 tool.open()（Mousetool 语义）；this: void 允许适配层直接传递 def 钩子引用 */
+  activate?: (this: void, tool: ToolLike) => void;
+  deactivate?: (this: void, tool: ToolLike) => void;
+}
+interface ToolSession {
+  readonly tool: ToolLike;
+  setActive(active: boolean): void;
+  /** 解绑事件并关闭工具；不清除工具已绘制的图形（属于用户数据） */
+  destroy(): void;
+}
+declare function mountTool(options: ToolMountOptions): ToolSession;
+//#endregion
+//#region src/layer.d.ts
+/**
+ * 瓦片图层的挂载与事件编排。图层构造（TileLayer/TileLayerWMS/GridlineLayer）
+ * 由调用方完成，此处统一处理上屏、事件挂接与卸载。
+ */
+declare const TILE_LAYER_EVENT_NAMES: readonly ["loading", "load", "tileloadstart", "tileload", "tileunload", "tileerror"];
+interface TileLayerMountOptions {
+  map: T.Map;
+  layer: T.TileLayer;
+  /** 默认为全部瓦片图层事件 */
+  events?: readonly string[];
+  dispatch: (name: string, event: unknown) => void;
+}
+/** 挂接事件并上屏，返回卸载函数（解绑事件 + removeLayer） */
+declare function mountTileLayer(options: TileLayerMountOptions): () => void;
+//#endregion
+//#region src/defs/types.d.ts
+/**
+ * 框架无关的组件定义层类型。每个组件一份纯数据定义（props 形状、SDK 构造、
+ * sync、事件表），Vue 适配层与 Web Components 适配层各自消费同一份定义，
+ * 保证两个适配层一对一对应且共享逻辑只写一份。
+ *
+ * props 形状 P 为「已解析的 JS 值」形态（如 [number, number]、T.IconOptions）；
+ * attribute 字符串的解析由 PropDef.converter 声明，响应式追踪由各适配层实现。
+ */
+/** vue 运行时支持的构造器类型子集 */
+type PropTypeConstructor = BooleanConstructor | StringConstructor | NumberConstructor | ArrayConstructor | ObjectConstructor;
+interface PropDef<P = unknown> {
+  /** vue 运行时类型 */
+  type?: PropTypeConstructor;
+  required?: boolean;
+  default?: P | (() => P);
+  /**
+   * WC attribute 名（kebab-case）。省略 = JS-only property，用于 T.LayerGroup
+   * 等不可序列化的 SDK 实例。converter 未声明时按 type 走内建转换
+   * （Boolean 为 presence 语义：attribute 存在即 true）。
+   */
+  attribute?: string;
+  /** attribute 字符串 → 属性值；坐标、JSON 等复杂形态在此声明 */
+  converter?: (value: string) => P;
+  /** 变更是否反射回 attribute（仅 open/active 等布尔状态需要） */
+  reflect?: boolean;
+}
+type PropDefs<P extends object> = { [K in keyof P]: PropDef<P[K]>; };
+/** create 收到的挂载上下文（构造 SDK 实例可能需要 map，如 MarkerClusterer） */
+interface DefCreateContext {
+  map: T.Map;
+}
+/** 覆盖物定义（Marker/Polyline/MarkerClusterer/LayerGroup 等） */
+interface OverlayDef<P extends object, O> {
+  /** vue 组件名（TdtXxx）与 wc 元素类名（TdtXxxElement）共用 */
+  name: string;
+  /** WC 元素 tag（tdt-xxx） */
+  tag: string;
+  props: PropDefs<P>;
+  /** SDK 原生事件名；适配层转发为组件事件 / tdt- 前缀 DOM 事件 */
+  events?: readonly string[];
+  create(props: P, ctx: DefCreateContext): O;
+  sync?: SyncDef<O, P>;
+  /** 覆盖默认挂载（有 collector 走 addMarker，否则 addOverLay）；不依赖 this，适配层直接传递引用 */
+  attach?: (this: void, instance: O, ctx: OverlayMountContext) => void;
+  /** 覆盖默认卸载（如 MarkerClusterer.clearMarkers） */
+  detach?: (this: void, instance: O, ctx: OverlayMountContext) => void;
+}
+/** 鼠标工具定义（active 受控开关由适配层注入，不进 defs） */
+interface ToolDef<P extends object> {
+  name: string;
+  tag: string;
+  props: PropDefs<P>;
+  events?: readonly string[];
+  create(props: P, map: T.Map): ToolLike;
+  /** 默认调用 tool.open()（Mousetool 语义）；不依赖 this，适配层直接传递引用 */
+  activate?: (this: void, tool: ToolLike) => void;
+  deactivate?: (this: void, tool: ToolLike) => void;
+}
+/** 控件定义（Zoom/Scale/Copyright/OverviewMap/MapType/标绘控件） */
+interface ControlDef<P extends object> {
+  name: string;
+  tag: string;
+  props: PropDefs<P>;
+  create(props: P): T.Control;
+}
+/** 瓦片图层定义（TileLayer/WMS/TDT/GridlineLayer） */
+interface LayerDef<P extends object> {
+  name: string;
+  tag: string;
+  props: PropDefs<P>;
+  /** 默认为全部瓦片图层事件（GridlineLayer 收窄为 loading/load） */
+  events?: readonly string[];
+  create(props: P): T.TileLayer;
+  /** 默认为 opacity/zIndex/url 同步（GridlineLayer 整表替换为仅 opacity） */
+  sync?: SyncDef<T.TileLayer, P>;
+}
+//#endregion
+//#region src/defs/converters.d.ts
+/**
+ * WC attribute 字符串的解析器，供 defs 的 PropDef.converter 声明。
+ * 分隔约定：坐标 "lng,lat"，坐标集合用 ";" 分段。
+ */
+declare function parseLnglat(value: string): [number, number];
+declare function parsePath(value: string): Array<[number, number]>;
+/** "swLng,swLat;neLng,neLat" → [[swLng, swLat], [neLng, neLat]] */
+declare function parseBounds(value: string): [[number, number], [number, number]];
+/** "w,h" → [width, height] */
+declare function parseSize(value: string): [number, number];
+declare function parseJson<T>(value: string): T;
+//#endregion
+//#region src/defs/controls.d.ts
+/**
+ * 控件定义。逐个从 vue 适配层迁移：props 形状与 SDK 构造是 vue/wc 共同的
+ * 唯一来源。ControlDef 无 sync——官方控件构造后位置由 setPosition 等命令式
+ * 方法维护，声明式仅覆盖构造参数；Scale 的 color 走 setColor，只能在
+ * create 内一并应用。
+ */
+interface ControlZoomProps {
+  position?: T.ControlPosition;
+  zoomInText?: string;
+  zoomOutText?: string;
+  zoomInTitle?: string;
+  zoomOutTitle?: string;
+}
+declare const zoomDef: ControlDef<ControlZoomProps>;
+interface ControlScaleProps {
+  position?: T.ControlPosition;
+  /** 比例尺颜色（官方 Control.Scale 方法 setColor） */
+  color?: string;
+}
+declare const scaleDef: ControlDef<ControlScaleProps>;
+interface ControlCopyrightProps {
+  position?: T.ControlPosition;
+  /** 版权信息的唯一标识 */
+  id?: string;
+  /** 版权文本，支持 HTML */
+  content?: string;
+  /** 该版权信息适用的地理范围（官方 CopyrightOptions.bounds） */
+  bounds?: [[number, number], [number, number]] | T.LngLatBounds;
+}
+declare const copyrightDef: ControlDef<ControlCopyrightProps>;
+interface ControlOverviewMapProps {
+  position?: T.ControlPosition;
+  /** 鹰眼控件大小 [width, height] */
+  size?: [number, number];
+  /** 添加到地图后的开合状态 */
+  isOpen?: boolean;
+}
+declare const overviewMapDef: ControlDef<ControlOverviewMapProps>;
+interface ControlMapTypeProps {
+  position?: T.ControlPosition;
+  /** 控件展示的地图类型，默认为 SDK 默认列表 */
+  mapTypes?: T.ControlMapTypeOptionsMapType[];
+}
+declare const mapTypeDef: ControlDef<ControlMapTypeProps>;
+//#endregion
+//#region src/defs/overlays.d.ts
+/**
+ * 覆盖物定义。逐个从 vue 适配层迁移：props 形状、SDK 构造、sync 与事件表
+ * 是 vue/wc 共同的唯一来源。sync 的风格统一为「undefined 不触发 setter」，
+ * 与 SDK setter 对 undefined 敏感的行为对齐。
+ */
+interface MarkerProps {
+  lnglat: [number, number] | T.LngLat;
+  /** 标注图标：官方 Icon 实例或 IconOptions（iconUrl/iconSize/iconAnchor） */
+  icon?: T.Icon | T.IconOptions;
+  draggable?: boolean;
+  title?: string;
+  zIndexOffset?: number;
+  opacity?: number;
+}
+declare const markerDef: OverlayDef<MarkerProps, T.Marker>;
+interface LineStyleProps {
+  color?: string;
+  weight?: number;
+  opacity?: number;
+  lineStyle?: "solid" | "dashed";
+}
+/** 线样式四件套的 props 定义（polyline/polygon/rectangle/线型工具共用） */
+declare const lineStylePropDefs: PropDefs<LineStyleProps>;
+/** 具备线样式 setter 的 SDK 实例（Polyline/Polygon/Rectangle/Circle 同构） */
+type LineStyleSetter = Pick<T.Polyline, "setColor" | "setWeight" | "setOpacity" | "setLineStyle">;
+/** 线样式 setter 同步（polyline/polygon/rectangle/circle 同构复用） */
+declare const lineStyleSync: SyncDef<LineStyleSetter, LineStyleProps>;
+interface PolylineProps extends LineStyleProps {
+  path: Array<[number, number] | T.LngLat>;
+}
+/** 填充两件套的 props 定义（polygon/circle/rectangle 共用） */
+interface FillStyleProps {
+  fillColor?: string;
+  fillOpacity?: number;
+}
+declare const polylineDef: OverlayDef<PolylineProps, T.Polyline>;
+interface PolygonProps extends LineStyleProps, FillStyleProps {
+  path: Array<[number, number] | T.LngLat>;
+}
+declare const polygonDef: OverlayDef<PolygonProps, T.Polygon>;
+interface CircleProps extends LineStyleProps, FillStyleProps {
+  center: [number, number] | T.LngLat;
+  /** 半径，单位米 */
+  radius: number;
+}
+declare const circleDef: OverlayDef<CircleProps, T.Circle>;
+interface RectangleProps extends LineStyleProps, FillStyleProps {
+  /** 西南角与东北角坐标 [[swLng, swLat], [neLng, neLat]] */
+  bounds: [[number, number], [number, number]] | T.LngLatBounds;
+}
+declare const rectangleDef: OverlayDef<RectangleProps, T.Rectangle>;
+interface LabelProps {
+  text: string;
+  lnglat: [number, number] | T.LngLat;
+  /** 文本偏移（官方 LabelOptions.offset） */
+  offset?: T.Point;
+  /** 字体颜色（官方 Label 方法 setFontColor） */
+  fontColor?: string;
+  /** 字体大小（像素，官方 Label 方法 setFontSize） */
+  fontSize?: number;
+  backgroundColor?: string;
+  /** 提示内容（title） */
+  title?: string;
+}
+declare const labelDef: OverlayDef<LabelProps, T.Label>;
+interface CloudMarkerProps {
+  /** 海量点的坐标集合 */
+  lnglats: Array<T.LngLat | [number, number]>;
+  /** 绘制样式（官方 CloudMarkerCollectionOptions：ShapeType/SizeType/color） */
+  styles?: T.CloudMarkerCollectionOptions;
+}
+declare const cloudMarkerDef: OverlayDef<CloudMarkerProps, T.CloudMarkerCollection>;
+interface MarkerClustererProps {
+  /** 批量传入的待聚合标注（官方 MarkerClustererOptions.markers） */
+  markers?: Array<T.Marker | [number, number]>;
+  /** 聚合计算网格的像素大小，默认 60（SDK 拼写为 girdSize） */
+  gridSize?: number;
+  /** 大于该级别不进行聚合 */
+  maxZoom?: number;
+  styles?: T.MarkerClustererStyle[];
+}
+declare const markerClustererDef: OverlayDef<MarkerClustererProps, T.MarkerClusterer>;
+interface LayerGroupProps {}
+declare const layerGroupDef: OverlayDef<LayerGroupProps, T.LayerGroup>;
+//#endregion
+//#region src/defs/layers.d.ts
+/**
+ * 瓦片图层定义。逐个从 vue 适配层迁移：props 形状、SDK 构造、sync 与
+ * 事件表是 vue/wc 共同的唯一来源。minZoom/maxZoom 仅构造生效（SDK 无
+ * setter），不进 sync；格网图层官方仅列 loading/load 两个事件，sync
+ * 收窄为仅 opacity（官方选项无 url/zIndex）。
+ */
+interface TileLayerProps {
+  /** 瓦片服务 URL 模板 */
+  url: string;
+  minZoom?: number;
+  maxZoom?: number;
+  opacity?: number;
+  zIndex?: number;
+  /** 瓦片加载失败时显示的图片 URL */
+  errorTileUrl?: string;
+  /** 图层显示范围（官方 TileLayerOptions.bounds） */
+  bounds?: [[number, number], [number, number]] | T.LngLatBounds;
+}
+declare const tileLayerDef: LayerDef<TileLayerProps>;
+interface TileLayerWMSProps extends TileLayerProps {
+  /** 用","分隔的多个图层列表 */
+  layers?: string;
+  styles?: string;
+  /** 输出图像类型，default: image/jpeg */
+  format?: string;
+  transparent?: boolean;
+  /** 请求服务的版本，default: 1.1.1 */
+  version?: string;
+  /** 地图投影类型，default: EPSG:900913 */
+  srs?: string;
+}
+declare const tileLayerWmsDef: LayerDef<TileLayerWMSProps>;
+interface TileLayerTDTProps extends TileLayerProps {
+  /** 用来描述图层信息 */
+  attribution?: string;
+}
+declare const tileLayerTdtDef: LayerDef<TileLayerTDTProps>;
+interface GridlineLayerProps {
+  /** 格网图层的网格大小，单位是像素，default: 256 */
+  tileSize?: number;
+  minZoom?: number;
+  maxZoom?: number;
+  opacity?: number;
+  /** 边线的颜色、宽度、线样式，default: {width:1, style:'solid', color:'#999'} */
+  outlineSize?: T.GridlineLayerOptions["outlineSize"];
+  /** 文字样式，图层文字表现网格的行号、列号、层级，default: {display:false, fontSize:'14', fontWeight:true, color:'black'} */
+  textSize?: T.GridlineLayerOptions["textSize"];
+}
+declare const gridlineLayerDef: LayerDef<GridlineLayerProps>;
+//#endregion
+//#region src/defs/plot-entities.d.ts
+/**
+ * 标绘覆盖物定义。逐个从 vue 适配层迁移：props 形状与 SDK 构造是
+ * vue/wc 共同的唯一来源。SDK 实体只暴露 setLngLats/getLngLats，
+ * 样式 props（线样式与填充）仅构造时生效，故 sync 只含 path。
+ * 官方标绘实体页未列事件表，defs 保持无 events。
+ */
+interface PlotEntityProps extends LineStyleProps {
+  path: Array<[number, number] | T.LngLat>;
+}
+interface PlotFillEntityProps extends PlotEntityProps {
+  fillColor?: string;
+  fillOpacity?: number;
+}
+/** 标绘实体的 SDK 同构面：样式 setter 官方未提供，path 同步为唯一可变项 */
+interface PlotEntityShape {
+  setLngLats(lnglats: T.LngLat[]): void;
+}
+declare const plotEntityPropDefs: PropDefs<PlotEntityProps>;
+declare const plotFillPropDefs: PropDefs<Pick<PlotFillEntityProps, "fillColor" | "fillOpacity">>;
+declare const plotEntitySync: SyncDef<PlotEntityShape, PlotEntityProps>;
+declare const arcDef: OverlayDef<PlotEntityProps, T.Arc>;
+declare const bezierCurve2Def: OverlayDef<PlotEntityProps, T.BezierCurve2>;
+declare const bezierCurve3Def: OverlayDef<PlotEntityProps, T.BezierCurve3>;
+declare const bezierCurveArrowDef: OverlayDef<PlotEntityProps, T.BezierCurveArrow>;
+declare const bezierCurveNDef: OverlayDef<PlotEntityProps, T.BezierCurveN>;
+declare const cardinalCurveDef: OverlayDef<PlotEntityProps, T.CardinalCurve>;
+declare const cardinalCurveArrowDef: OverlayDef<PlotEntityProps, T.CardinalCurveArrow>;
+declare const parallelSearchDef: OverlayDef<PlotEntityProps, T.ParallelSearch>;
+declare const polylineArrowDef: OverlayDef<PlotEntityProps, T.PolylineArrow>;
+declare const sectorSearchDef: OverlayDef<PlotEntityProps, T.SectorSearch>;
+declare const closeCurveDef: OverlayDef<PlotFillEntityProps, T.CloseCurve>;
+declare const curveFlagDef: OverlayDef<PlotFillEntityProps, T.CurveFlag>;
+declare const diagonalArrowDef: OverlayDef<PlotFillEntityProps, T.DiagonalArrow>;
+declare const doubleArrowDef: OverlayDef<PlotFillEntityProps, T.DoubleArrow>;
+declare const doveTailDiagonalArrowDef: OverlayDef<PlotFillEntityProps, T.DoveTailDiagonalArrow>;
+declare const doveTailStraightArrowDef: OverlayDef<PlotFillEntityProps, T.DoveTailStraightArrow>;
+declare const gatheringPlaceDef: OverlayDef<PlotFillEntityProps, T.GatheringPlace>;
+declare const rectFlagDef: OverlayDef<PlotFillEntityProps, T.RectFlag>;
+declare const roundRectDef: OverlayDef<PlotFillEntityProps, T.RoundRect>;
+declare const sectorDef: OverlayDef<PlotFillEntityProps, T.Sector>;
+declare const straightArrowDef: OverlayDef<PlotFillEntityProps, T.StraightArrow>;
+declare const triangleFlagDef: OverlayDef<PlotFillEntityProps, T.TriangleFlag>;
+//#endregion
+//#region src/defs/plot-tools.d.ts
+/**
+ * 标绘鼠标工具定义族（军事标绘体系，SDK 基类 MilitaryTool）。23 个工具
+ * 完全同构：公共 Options 仅 style 与 layers（存储绘制图形的容器），事件表
+ * 为官方基类成员 click/move/dbclick（官方拼写即为 dbclick），故用一个
+ * helper 从 SDK 类名批量生成，逐个搬运 vue 实现的构造参数。
+ */
+interface PlotToolProps {
+  /** 绘制图形的样式（官方 MilitaryToolOptions 的 style 字段） */
+  style?: T.MilitaryStyle;
+  /** 存储绘制图形的容器；不传时工具自行创建空图层容器 */
+  layers?: T.LayerGroup;
+}
+declare const plotToolPropDefs: PropDefs<PlotToolProps>;
+declare const arcToolDef: ToolDef<PlotToolProps>;
+declare const bezierCurve2ToolDef: ToolDef<PlotToolProps>;
+declare const bezierCurve3ToolDef: ToolDef<PlotToolProps>;
+declare const bezierCurveArrowToolDef: ToolDef<PlotToolProps>;
+declare const bezierCurveNToolDef: ToolDef<PlotToolProps>;
+declare const cardinalCurveArrowToolDef: ToolDef<PlotToolProps>;
+declare const cardinalCurveToolDef: ToolDef<PlotToolProps>;
+declare const closeCurveToolDef: ToolDef<PlotToolProps>;
+declare const curveFlagToolDef: ToolDef<PlotToolProps>;
+declare const diagonalArrowToolDef: ToolDef<PlotToolProps>;
+declare const doubleArrowToolDef: ToolDef<PlotToolProps>;
+declare const doveTailDiagonalArrowToolDef: ToolDef<PlotToolProps>;
+declare const doveTailStraightArrowToolDef: ToolDef<PlotToolProps>;
+declare const gatheringPlaceToolDef: ToolDef<PlotToolProps>;
+declare const handDrawingToolDef: ToolDef<PlotToolProps>;
+declare const parallelSearchToolDef: ToolDef<PlotToolProps>;
+declare const polylineArrowToolDef: ToolDef<PlotToolProps>;
+declare const rectFlagToolDef: ToolDef<PlotToolProps>;
+declare const roundRectToolDef: ToolDef<PlotToolProps>;
+declare const sectorSearchToolDef: ToolDef<PlotToolProps>;
+declare const sectorToolDef: ToolDef<PlotToolProps>;
+declare const straightArrowToolDef: ToolDef<PlotToolProps>;
+declare const triangleFlagToolDef: ToolDef<PlotToolProps>;
+//#endregion
+//#region src/defs/tools.d.ts
+/**
+ * 鼠标工具定义（Mousetool 体系）。active 受控开关不进 defs（Vue 以 prop、
+ * WC 以 attribute 各自注入）；CoordinatePickup 非该体系（addEvent 开关 +
+ * callback 构造），由适配层各自手写。线样式 props 与折线覆盖物共用。
+ */
+interface PolylineToolProps extends LineStyleProps {
+  /** 是否显示测距结果，关闭后可作画线工具使用 */
+  showLabel?: boolean;
+}
+declare const polylineToolDef: ToolDef<PolylineToolProps>;
+interface PolygonToolProps extends LineStyleProps {
+  /** 是否显示测面积结果，关闭后可作画多边形工具使用 */
+  showLabel?: boolean;
+}
+declare const polygonToolDef: ToolDef<PolygonToolProps>;
+interface CircleToolProps extends LineStyleProps {
+  fillColor?: string;
+  fillOpacity?: number;
+}
+declare const circleToolDef: ToolDef<CircleToolProps>;
+interface RectangleToolProps extends LineStyleProps {
+  fillColor?: string;
+  fillOpacity?: number;
+}
+declare const rectangleToolDef: ToolDef<RectangleToolProps>;
+interface MarkToolProps {
+  /** 标注图标，默认为 SDK 默认图标 */
+  icon?: T.Icon;
+  /** 标记图标是否跟随鼠标 */
+  follow?: boolean;
+}
+declare const markToolDef: ToolDef<MarkToolProps>;
+interface PaintBrushToolProps {
+  /** 保持工具的连续可用性 */
+  keepdrawing?: boolean;
+  /** 画笔留下笔迹的样式（官方 PaintBrushToolOptions 的 style 字段） */
+  style?: T.PaintBrushToolOptions["style"];
+}
+declare const paintBrushToolDef: ToolDef<PaintBrushToolProps>;
+//#endregion
+export { type CircleProps, type CircleToolProps, type CloudMarkerProps, type ControlCopyrightProps, type ControlDef, type ControlMapTypeProps, type ControlOverviewMapProps, type ControlScaleProps, type ControlZoomProps, type CreateMapSessionOptions, DEFAULT_CENTER, type DefCreateContext, EventBridge, type EventTargetLike, type GridlineLayerProps, type InfoWindowHandle, type InfoWindowHost, type InfoWindowSpec, type LabelProps, type LayerDef, type LayerGroupProps, type LineStyleProps, type LoadTdtOptions, MAP_EVENT_NAMES, type MapInteractionOptions, type MapSession, type MarkToolProps, type MarkerClustererProps, type MarkerProps, type OverlayCollector, type OverlayDef, type OverlayHandle, type OverlayMountContext, type OverlayMountSpec, type PaintBrushToolProps, type PlotEntityProps, type PlotFillEntityProps, type PlotToolProps, type PolygonProps, type PolygonToolProps, type PolylineProps, type PolylineToolProps, type PropDef, type PropDefs, type PropTypeConstructor, type RectangleProps, type RectangleToolProps, type SyncDef, TILE_LAYER_EVENT_NAMES, type TileLayerProps, type TileLayerTDTProps, type TileLayerWMSProps, type ToolDef, type ToolLike, type ToolSession, applyMapInteractions, arcDef, arcToolDef, bezierCurve2Def, bezierCurve2ToolDef, bezierCurve3Def, bezierCurve3ToolDef, bezierCurveArrowDef, bezierCurveArrowToolDef, bezierCurveNDef, bezierCurveNToolDef, bindEventNames, cardinalCurveArrowDef, cardinalCurveArrowToolDef, cardinalCurveDef, cardinalCurveToolDef, circleDef, circleToolDef, closeCurveDef, closeCurveToolDef, cloudMarkerDef, compact, copyrightDef, createInfoWindow, createMapSession, createPropsSync, createWhenReady, curveFlagDef, curveFlagToolDef, diagonalArrowDef, diagonalArrowToolDef, doubleArrowDef, doubleArrowToolDef, doveTailDiagonalArrowDef, doveTailDiagonalArrowToolDef, doveTailStraightArrowDef, doveTailStraightArrowToolDef, gatheringPlaceDef, gatheringPlaceToolDef, gridlineLayerDef, handDrawingToolDef, labelDef, layerGroupDef, lineStylePropDefs, lineStyleSync, loadTdt, mapTypeDef, markToolDef, markerClustererDef, markerDef, mountOverlay, mountTileLayer, mountTool, overviewMapDef, paintBrushToolDef, parallelSearchDef, parallelSearchToolDef, parseBounds, parseJson, parseLnglat, parsePath, parseSize, plotEntityPropDefs, plotEntitySync, plotFillPropDefs, plotToolPropDefs, polygonDef, polygonToolDef, polylineArrowDef, polylineArrowToolDef, polylineDef, polylineToolDef, rectFlagDef, rectFlagToolDef, rectangleDef, rectangleToolDef, roundRectDef, roundRectToolDef, scaleDef, sectorDef, sectorSearchDef, sectorSearchToolDef, sectorToolDef, straightArrowDef, straightArrowToolDef, tileLayerDef, tileLayerTdtDef, tileLayerWmsDef, toLngLat, toLngLats, triangleFlagDef, triangleFlagToolDef, zoomDef };