# SGS Map SDK Changelog

## [2.0.0] - 2026-06-12

### 🚀 新特性 (New Features)
- **双域双向通信架构**：采用不可见 iframe 挂载基座，通过安全沙箱和 `postMessage` 握手进行通信，从源头上解决 WebGL Context 内存泄漏和生命周期挂起问题。
- **动态点位系统 (Markers API)**：新增 `addMarker` / `removeMarker` / `clearMarkers` 接口，支持锚定三维节点（防模型漂移）和绝对坐标系定位。
- **异步寻路确权系统**：`planRoute` 和 `changeFloor` 升级为基于 `requestId` 的 Promise 异步确权模式，支持 Timeout 拦截机制。
- **高精模型与坐标系重构**：全面接入米级统一坐标系（废弃 CAD 毫米系），支持多楼层分层物理拆分加载。

### 🐞 修复与强化 (Fixes & Improvements)
- `HELLLO` 与 `ENGINE_READY` 双向握手协议对齐。
- `targetOrigin` 自动推导增强，严格拦截非法的跨域源消息，免疫跨站攻击。
- SDK Iframe 生命周期的 `onerror` 捕捉增强，能正确派发 `loadError` 事件。
- 补齐了丢失的 `floorChanged` 运行时事件透传。
- 完善 `package.json` 工程化暴露，同时提供 IIFE 与 ESM 产物，开启源码映射（SourceMap）。
- `addMarker` 接口强制引入强类型定义 `MarkerConfig`。

### 🗑️ 废弃与移除 (Deprecations)
- 彻底移除半成品接口 `startNavigateAnim` / `stopNavigateAnim`。
- 彻底移除废弃接口 `addBusinessMarker` / `removeBusinessMarker`，统一收编为 `addMarker`。