@terra.gl/core 0.0.1-alpha.52 → 0.0.1-alpha.54

package/dist/index.d.ts

@@ -274,19 +274,10 @@ export declare type AttributesType = {
 
 export declare const author: any;
 
-/**
- * @category DrawTool
- */
 declare type BaseDrawToolOptions = MapToolOptions & {
-    /**
-     * Mode name, e.g. 'line' / 'polygon' / 'point'
-     * 模式名称，例如 'line' / 'polygon' / 'point'
-     */
+    /** 模式名称，例如 'line' / 'polygon' / 'point' */
     mode: string;
-    /**
-     * Whether to automatically disable tool after one drawing finishes
-     * 是否在一次绘制结束后自动禁用工具
-     */
+    /** 是否在一次绘制结束后自动禁用工具 */
     once?: boolean;
 };
 
@@ -1160,15 +1151,12 @@ declare interface DomEventMap extends BaseEventMap<Map_2> {
 }
 
 /**
- * Single draw mode definition:
  * 单个绘制模式定义：
- *
- * @property actions - Involved event sequence (currently mainly click / mousemove / dblclick) 参与的事件序列（目前主要是 click / mousemove / dblclick）
- * @property create - Create geometry object on first click 第一次点击时创建几何对象
- * @property update - Update geometry on every new vertex or move 每次新增顶点或移动时更新几何
- * @property generate - Generate final result on finish (can be Feature or original geometry) 结束时生成最终结果（可以是 Feature，也可以是原几何）
- * @property clickLimit - Minimum click count (can finish when reached, usually with dblclick) 最少点击次数（达到就可以结束，通常配合 dblclick）
- * @category DrawTool
+ * - actions: 参与的事件序列（目前主要是 click / mousemove / dblclick）
+ * - create: 第一次点击时创建几何对象
+ * - update: 每次新增顶点或移动时更新几何
+ * - generate: 结束时生成最终结果（可以是 Feature，也可以是原几何）
+ * - clickLimit: 最少点击次数（达到就可以结束，通常配合 dblclick）
  */
 declare type DrawModeDefinition = {
     actions: Array<"click" | "mousemove" | "dblclick">;
@@ -1179,86 +1167,51 @@ declare type DrawModeDefinition = {
 };
 
 /**
- * DrawTool: Universal Drawing Tool
  * DrawTool：通用绘图工具
  *
- * @description
- * Responsible for:
- * - Handling Map DOM events (click/mousemove/dblclick)
- * - Maintaining vertex sequence _clickCoords
- * - Calling mode definitions create/update/generate
- * - Triggering events: drawstart / drawvertex / drawend / drawing, etc.
- *
  * 负责：
  * - 处理 Map 的 DOM 事件（click/mousemove/dblclick）
  * - 维护顶点序列 _clickCoords
  * - 调用模式定义的 create/update/generate
- * - 向外触发：drawstart / drawend / drawing 等事件
- * @category DrawTool
+ * - 向外触发：drawstart / drawvertex / drawend / drawing 等事件
  */
 export declare class DrawTool extends MapTool {
-    /**
-     * Configuration options
-     * 配置
-     */
+    /** 配置 */
     options: DrawToolOptions;
-    /**
-     * Current mode definition
-     * 当前模式定义
-     */
+    /** 当前模式定义 */
     private _modeDef?;
-    /**
-     * Current drawing vertex sequence
-     * 当前绘制中的顶点序列
-     */
+    /** 当前绘制中的顶点序列 */
     private _clickCoords;
-    /**
-     * Whether drawing is in progress
-     * 是否正在绘制中
-     */
+    /** 是否正在绘制中 */
     private _isDrawing;
-    /**
-     * Current drawing geometry object (returned by mode.create/create)
-     * 当前绘制中的几何对象（由 mode.create/create 返回）
-     */
+    /** 当前绘制中的几何对象（由 mode.create/create 返回） */
     private _geometry;
-    /**
-     * Internal unified draft layer
-     * 内部统一草图图层
-     */
+    /** 内部统一草图图层 */
     private _draftLayer?;
     /**
-     * Register a drawing mode
      * 注册一个绘制模式
      */
     static registerMode(name: string, def: DrawModeDefinition): void;
     /**
-     * Get registered mode definition
      * 获取已注册的模式
      */
     static getModeDefinition(name: string): DrawModeDefinition | undefined;
     constructor(options: DrawToolOptions);
     /**
-     * Get current mode name (unified to lowercase)
      * 获取当前模式名称（统一转为小写）
      */
     getMode(): string;
     /**
-     * Set drawing mode: will clear current drawing state
      * 设置绘制模式：会清空当前绘制状态
      */
     setMode(mode: string): this;
     /**
-     * Set drawing style (only affects subsequent new drawings)
      * 设置绘制样式（仅影响后续新开始的绘制）
-     *
-     * @param style - Style options 样式选项
-     * @param style.geometryStyle - Main geometry style (point/line/polygon) 主几何样式（点/线/面）
-     * @param style.vertexStyle - Vertex style, pass null to disable anchor display 顶点样式，传 null 可关闭锚点显示
+     * - geometryStyle：主几何样式（点/线/面）
+     * - vertexStyle：顶点样式，传 null 可关闭锚点显示
      */
     setStyle(style: DrawToolStyleOptions): this;
     /**
-     * Subclass implementation: Return event mapping to bind to Map
      * 子类实现：返回需要绑定到 Map 的事件映射
      */
     protected getEvents(): {
@@ -1267,67 +1220,44 @@ export declare class DrawTool extends MapTool {
         dblclick: (evt: DomEventMap) => void;
     };
     /**
-     * Sync mode definition when enabled
      * 启用时同步一下模式定义
      */
     protected onEnable(): void;
     /**
-     * Finish current drawing and clean up draft layer when disabled
      * 禁用时结束当前绘制，并清理草图图层
      */
     protected onDisable(): void;
     /**
-     * Ensure current mode has corresponding definition
      * 确保当前 mode 有对应的定义
      */
     private _ensureMode;
     /**
-     * Handle click event:
      * 处理 click 事件：
-     *
-     * @description
-     * - First click: Start drawing, call mode.create, trigger drawstart
-     * - Subsequent click: Append vertex, call mode.update, trigger drawvertex
-     * - If clickLimit reached: Finish drawing
-     *
      * - 第一次 click：开始绘制，调用 mode.create，触发 drawstart
      * - 后续 click：追加顶点，调用 mode.update，触发 drawvertex
      * - 若达到 clickLimit，则结束绘制
      */
     private _handleClick;
     /**
-     * Handle mousemove event:
      * 处理 mousemove 事件：
-     *
-     * @description
-     * - Only update geometry when drawing
-     * - Do not modify _clickCoords, use temporary coords for update
-     *
      * - 仅在绘制中才更新几何
      * - 不修改 _clickCoords，只用临时 coords 传给 update
      */
     private _handleMouseMove;
     /**
-     * Handle dblclick:
      * 处理 dblclick：
-     *
-     * @description
-     * - If drawing, finish directly
      * - 如果正在绘制，则直接结束
      */
     private _handleDblClick;
     /**
-     * Normally finish a drawing: Call mode.generate and trigger drawend
      * 正常结束一次绘制：调用 mode.generate 并触发 drawend
      */
     private _finishDrawing;
     /**
-     * Silently finish (no drawend trigger), used for mode switching / tool disabling
      * 静默结束（不触发 drawend），用于切换模式 / 禁用工具
      */
     private _finishDrawingSilently;
     /**
-     * Internal: Get or create unified draft layer
      * 内部：获取或创建统一草图图层
      */
     _getOrCreateDraftLayer(): OverlayLayer<Feature>;
@@ -1340,23 +1270,13 @@ export declare class DrawTool extends MapTool {
 export declare type DrawToolOptions = BaseDrawToolOptions & DrawToolStyleOptions;
 
 /**
- * Style configuration type
  * 样式配置类型
- * @category DrawTool
  */
 export declare type DrawToolStyleOptions = {
-    /**
-     * Main geometry style (point / line / polygon)
-     * 主几何样式（点 / 线 / 面）
-     */
+    /** 主几何样式（点 / 线 / 面） */
     geometryStyle?: StyleInput;
     /**
-     * Vertex (anchor) style
      * 顶点（锚点）样式
-     *
-     * @description
-     * - Pass null to not draw anchors
-     * - Pass undefined to keep current setting
      * - 传 null 表示不绘制锚点
      * - 不传该字段则保持当前设置
      */
@@ -2602,7 +2522,7 @@ export declare class InfoWindow extends UIComponent {
  * InfoWindow 配置项
  * @category UI
  */
-declare type InfoWindowOptions = UIComponentOptions & {
+export declare type InfoWindowOptions = UIComponentOptions & {
     /**
      * Title text.
      * 标题文本
@@ -4268,100 +4188,78 @@ export declare type MapOptionsType = {
 };
 
 /**
- * Map Tool Base Class.
  * 地图工具基类
  *
- * - Manage tool lifecycle (addTo / enable / disable / remove)
- * - Integrate with Map event system (Unified internal event registration/unregistration)
- * - Ensure only one active tool exists on the same map
- *
  * - 管理工具的生命周期（addTo / enable / disable / remove）
  * - 与 Map 的事件系统对接（内部统一注册/注销事件）
  * - 保证同一张地图同时只存在一个激活工具
- * @category Map
  */
 export declare abstract class MapTool extends MapTool_base {
-    /**
-     * Bound map instance
-     * 绑定的地图实例
-     */
+    /** 绑定的地图实例 */
     protected _map?: Map_2;
-    /**
-     * Whether enabled
-     * 是否启用中
-     */
+    /** 是否启用中 */
     protected _enabled: boolean;
-    /**
-     * Cache event handlers bound to Map for removal on off
-     * 缓存绑定到 Map 上的事件处理函数，便于 off 时移除
-     */
+    /** 缓存绑定到 Map 上的事件处理函数，便于 off 时移除 */
     private _boundHandlers;
     /**
-     * @param options Tool options 工具配置
+     * @param options 工具配置
      */
     constructor(options?: MapToolOptions);
     /**
-     * Add tool to map and automatically enable.
-     * Ensures only one active MapTool on the same Map.
      * 将工具添加到地图上，并自动启用。
      * 同一张 Map 上会保证只有一个激活的 MapTool。
      */
     addTo(map: Map_2): this;
     /**
-     * Get currently bound map instance.
      * 获取当前绑定的地图实例
      */
     getMap(): Map_2 | undefined;
     /**
-     * Enable tool: Bind events + Call onEnable hook.
      * 启用工具：绑定事件 + 调用 onEnable 钩子
      */
     enable(): this;
     /**
-     * Disable tool: Unbind events + Call onDisable hook.
      * 禁用工具：解绑事件 + 调用 onDisable 钩子
      */
     disable(): this;
     /**
-     * Remove tool from map.
-     * 从地图移除工具。
+     * 工具是否处于启用状态
+     */
+    isEnabled(): boolean;
+    /**
+     * 从地图上移除工具
      */
     remove(): this;
     /**
-     * Abstract method: Subclasses can implement initialization logic.
-     * 抽象方法：子类可实现初始化逻辑。
+     * 子类实现：返回需要绑定到 Map 上的事件映射
+     *
+     * key: 事件名（如 'click', 'mousemove'）
+     * value: 事件处理函数（参数为 Map 的事件数据）
+     *
+     * 注意：
+     * - 不要求提前 bind(this)，MapTool 内部会统一绑定 this
+     */
+    protected abstract getEvents(): Record<string, (e: any) => void>;
+    /**
+     * 生命周期钩子：工具刚 addTo(map) 时调用
      */
     protected onAdd?(): void;
     /**
-     * Abstract method: Subclasses can implement enabling logic.
-     * 抽象方法：子类可实现启用逻辑。
+     * 生命周期钩子：工具 enable() 时调用
      */
     protected onEnable?(): void;
     /**
-     * Abstract method: Subclasses can implement disabling logic.
-     * 抽象方法：子类可实现禁用逻辑。
+     * 生命周期钩子：工具 disable() 时调用
      */
     protected onDisable?(): void;
     /**
-     * Abstract method: Subclasses can implement removal logic.
-     * 抽象方法：子类可实现移除逻辑。
-     */
-    protected onRemove?(): void;
-    /**
-     * Bind events.
-     * 绑定事件。
+     * 内部：绑定 Map 事件
      */
     private _bindEvents;
     /**
-     * Unbind events.
-     * 解绑事件。
+     * 内部：解绑 Map 事件
      */
     private _unbindEvents;
-    /**
-     * Helper method: Register map event listener (Automatically managed, auto-removed on disable).
-     * 辅助方法：注册地图事件监听（自动管理，disable 时自动移除）。
-     */
-    protected addMapEvent(type: string, fn: (e: any) => void, context?: any): void;
 }
 
 declare const MapTool_base: {
@@ -4393,9 +4291,7 @@ declare const MapTool_base: {
 } & typeof EmptyBase;
 
 /**
- * MapTool configuration (Reserved for future extension)
  * MapTool 配置项（预留，将来可以扩展）
- * @category Map
  */
 declare type MapToolOptions = ClassOptions_2 & {};
 

package/dist/index.js

@@ -1,6 +1,6 @@
 import * as pt from "three";
 import { REVISION as of, TrianglesDrawMode as Yw, TriangleFanDrawMode as Jl, TriangleStripDrawMode as af, Mesh as Ie, Vector3 as z, Color as ue, FrontSide as na, Plane as lf, Matrix4 as Le, Vector4 as bn, PerspectiveCamera as nr, WebGLRenderTarget as Gr, UniformsUtils as sr, UniformsLib as $o, ShaderMaterial as Rn, MOUSE as pi, TOUCH as mi, Spherical as td, Quaternion as yn, OrthographicCamera as Wr, Vector2 as ce, Ray as Bw, PlaneGeometry as ir, HalfFloatType as Qi, AdditiveBlending as fc, MeshBasicMaterial as _n, RGBAFormat as cf, LinearFilter as Ti, NoBlending as jw, Clock as ia, Loader as pc, LoaderUtils as Rr, FileLoader as Si, MeshPhysicalMaterial as An, SpotLight as uf, PointLight as Ql, DirectionalLight as qo, InstancedMesh as mc, InstancedBufferAttribute as $l, Object3D as vn, TextureLoader as ra, ImageBitmapLoader as Jw, BufferAttribute as Tt, InterleavedBuffer as Qw, InterleavedBufferAttribute as $i, LinearMipmapLinearFilter as Rs, NearestMipmapLinearFilter as $w, LinearMipmapNearestFilter as qw, NearestMipmapNearestFilter as eb, NearestFilter as hf, RepeatWrapping as xn, MirroredRepeatWrapping as tb, ClampToEdgeWrapping as ql, PointsMaterial as sa, Material as Sl, LineBasicMaterial as df, MeshStandardMaterial as Is, DoubleSide as Fr, PropertyBinding as Cs, BufferGeometry as rn, SkinnedMesh as ff, LineSegments as nb, Line as pf, LineLoop as ib, Points as Or, Group as wn, MathUtils as _t, Skeleton as mf, AnimationClip as gf, Bone as ec, InterpolateDiscrete as rb, InterpolateLinear as yf, Texture as Ar, VectorKeyframeTrack as tc, NumberKeyframeTrack as nc, QuaternionKeyframeTrack as ic, Interpolant as sb, Box3 as or, Sphere as gc, Curve as ob, MeshPhongMaterial as Ms, MeshLambertMaterial as _f, EquirectangularReflectionMapping as ab, AmbientLight as vf, Float32BufferAttribute as gi, Uint16BufferAttribute as lb, Matrix3 as cb, Euler as vs, DataTextureLoader as ub, FloatType as Jo, DataUtils as Co, InstancedBufferGeometry as wf, InstancedInterleavedBuffer as rc, WireframeGeometry as hb, Line3 as db, EventDispatcher as bf, Scene as fb, FogExp2 as nd, CubeTextureLoader as pb, WebGLRenderer as mb, PCFSoftShadowMap as gb, ACESFilmicToneMapping as yb, SRGBColorSpace as oa, CameraHelper as _b, CubicBezierCurve3 as vb, Frustum as wb, Raycaster as Zs, CanvasTexture as zr, SpriteMaterial as Dr, Sprite as Pi, DynamicDrawUsage as id, NormalBlending as xf, CurvePath as Tf, LineCurve3 as Ir, QuadraticBezierCurve3 as Sf, TubeGeometry as bb, BackSide as xb, Shape as Tb, ShapeGeometry as Sb, CylinderGeometry as Mb, AnimationMixer as Lb, LoopRepeat as Pb, LoopOnce as Cb, LoadingManager as Zb, Box2 as Gb, ImageLoader as Mf } from "three";
-const Wb = "0.0.1-alpha.52", Ml = {
+const Wb = "0.0.1-alpha.54", Ml = {
   name: "Criska"
 };
 var Ls = function() {
@@ -19052,7 +19052,7 @@ function bL(r, e) {
 }
 const xL = `{
 	"name": "@terra.gl/core",
-	"version": "0.0.1-alpha.52",
+	"version": "0.0.1-alpha.54",
 	"type": "module",
 	"files": [
 		"dist"
@@ -23144,14 +23144,12 @@ class J2 extends Ci(
   ar(j2)
 ) {
   /**
-   * @param options Tool options 工具配置
+   * @param options 工具配置
    */
   constructor(e = {}) {
     super(e), jl(this, "_map"), jl(this, "_enabled", !1), jl(this, "_boundHandlers", /* @__PURE__ */ new Map());
   }
   /**
-   * Add tool to map and automatically enable.
-   * Ensures only one active MapTool on the same Map.
    * 将工具添加到地图上，并自动启用。
    * 同一张 Map 上会保证只有一个激活的 MapTool。
    */
@@ -23161,61 +23159,61 @@ class J2 extends Ci(
     return t._activeMapTool && t._activeMapTool !== this && t._activeMapTool.disable(), t._activeMapTool = this, this._map = e, this.onAdd && this.onAdd(), this.enable(), this.trigger("add", { map: e }), this;
   }
   /**
-   * Get currently bound map instance.
    * 获取当前绑定的地图实例
    */
   getMap() {
     return this._map;
   }
   /**
-   * Enable tool: Bind events + Call onEnable hook.
    * 启用工具：绑定事件 + 调用 onEnable 钩子
    */
   enable() {
     return !this._map || this._enabled ? this : (this._enabled = !0, this._bindEvents(), this.onEnable && this.onEnable(), this.trigger("enable", { map: this._map }), this);
   }
   /**
-   * Disable tool: Unbind events + Call onDisable hook.
    * 禁用工具：解绑事件 + 调用 onDisable 钩子
    */
   disable() {
     return !this._map || !this._enabled ? this : (this._enabled = !1, this._unbindEvents(), this.onDisable && this.onDisable(), this.trigger("disable", { map: this._map }), this);
   }
   /**
-   * Remove tool from map.
-   * 从地图移除工具。
+   * 工具是否处于启用状态
+   */
+  isEnabled() {
+    return !!this._enabled;
+  }
+  /**
+   * 从地图上移除工具
    */
   remove() {
     if (!this._map) return this;
-    this.disable(), this.onRemove && this.onRemove();
+    this.disable();
     const e = this._map;
-    return e._activeMapTool === this && (e._activeMapTool = null), this.trigger("remove", { map: this._map }), this._map = void 0, this;
+    return e._activeMapTool === this && delete e._activeMapTool, this._map = void 0, this.trigger("remove"), this;
   }
   /**
-   * Bind events.
-   * 绑定事件。
+   * 内部：绑定 Map 事件
    */
   _bindEvents() {
-    this._map;
+    const e = this._map;
+    if (!e) return;
+    const t = this.getEvents() || {};
+    Object.keys(t).forEach((n) => {
+      const i = t[n];
+      if (!i) return;
+      const o = (a) => i.call(this, a);
+      this._boundHandlers.set(n, o), e.on(n, o);
+    });
   }
   /**
-   * Unbind events.
-   * 解绑事件。
+   * 内部：解绑 Map 事件
    */
   _unbindEvents() {
-    this._map && (this._boundHandlers.forEach((e, t) => {
-      this._map.off(t, e);
+    const e = this._map;
+    e && (this._boundHandlers.forEach((t, n) => {
+      e.off(n, t);
     }), this._boundHandlers.clear());
   }
-  /**
-   * Helper method: Register map event listener (Automatically managed, auto-removed on disable).
-   * 辅助方法：注册地图事件监听（自动管理，disable 时自动移除）。
-   */
-  addMapEvent(e, t, n) {
-    if (!this._map) return;
-    const i = n ? t.bind(n) : t;
-    this._boundHandlers.set(e, i), this._map.on(e, i);
-  }
 }
 var Q2 = Object.defineProperty, $2 = (r, e, t) => e in r ? Q2(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, ys = (r, e, t) => $2(r, typeof e != "symbol" ? e + "" : e, t);
 class q2 extends Mi {
@@ -23232,46 +23230,38 @@ class Fs extends J2 {
     super(e), ys(this, "_modeDef"), ys(this, "_clickCoords", []), ys(this, "_isDrawing", !1), ys(this, "_geometry"), ys(this, "_draftLayer"), this.options.once = this.options.once ?? !1, this._ensureMode();
   }
   /**
-   * Register a drawing mode
    * 注册一个绘制模式
    */
   static registerMode(e, t) {
     nf[e.toLowerCase()] = t;
   }
   /**
-   * Get registered mode definition
    * 获取已注册的模式
    */
   static getModeDefinition(e) {
     return nf[e.toLowerCase()];
   }
   /**
-   * Get current mode name (unified to lowercase)
    * 获取当前模式名称（统一转为小写）
    */
   getMode() {
     return (this.options.mode || "").toLowerCase();
   }
   /**
-   * Set drawing mode: will clear current drawing state
    * 设置绘制模式：会清空当前绘制状态
    */
   setMode(e) {
     return this._finishDrawingSilently(), this.options.mode = e, this._ensureMode(), this;
   }
   /**
-   * Set drawing style (only affects subsequent new drawings)
-   * 设置绘制样式（仅影响后续新开始的绘制）
-   * 
-   * @param style - Style options 样式选项
-   * @param style.geometryStyle - Main geometry style (point/line/polygon) 主几何样式（点/线/面）
-   * @param style.vertexStyle - Vertex style, pass null to disable anchor display 顶点样式，传 null 可关闭锚点显示
-   */
+  * 设置绘制样式（仅影响后续新开始的绘制）
+  * - geometryStyle：主几何样式（点/线/面）
+  * - vertexStyle：顶点样式，传 null 可关闭锚点显示
+  */
   setStyle(e) {
     return e.geometryStyle !== void 0 && (this.options.geometryStyle = e.geometryStyle), Object.prototype.hasOwnProperty.call(e, "vertexStyle") && (this.options.vertexStyle = e.vertexStyle ?? null), this;
   }
   /**
-   * Subclass implementation: Return event mapping to bind to Map
    * 子类实现：返回需要绑定到 Map 的事件映射
    */
   getEvents() {
@@ -23282,38 +23272,28 @@ class Fs extends J2 {
     };
   }
   /**
-   * Sync mode definition when enabled
    * 启用时同步一下模式定义
    */
   onEnable() {
     this._ensureMode();
   }
   /**
-   * Finish current drawing and clean up draft layer when disabled
    * 禁用时结束当前绘制，并清理草图图层
    */
   onDisable() {
     this._finishDrawingSilently(), this._destroyDraftLayer();
   }
   /**
-   * Ensure current mode has corresponding definition
    * 确保当前 mode 有对应的定义
    */
   _ensureMode() {
     const e = this.getMode(), t = Fs.getModeDefinition(e);
     if (!t)
-      throw new Error(`DrawTool: mode "${e}" Not registered, please call DrawTool.registerMode first 未注册，请先调用 DrawTool.registerMode`);
+      throw new Error(`DrawTool: mode "${e}" 未注册，请先调用 DrawTool.registerMode`);
     this._modeDef = t;
   }
   /**
-   * Handle click event:
    * 处理 click 事件：
-   * 
-   * @description
-   * - First click: Start drawing, call mode.create, trigger drawstart
-   * - Subsequent click: Append vertex, call mode.update, trigger drawvertex
-   * - If clickLimit reached: Finish drawing
-   * 
    * - 第一次 click：开始绘制，调用 mode.create，触发 drawstart
    * - 后续 click：追加顶点，调用 mode.update，触发 drawvertex
    * - 若达到 clickLimit，则结束绘制
@@ -23334,13 +23314,7 @@ class Fs extends J2 {
     })), n.clickLimit && this._clickCoords.length >= n.clickLimit && this._finishDrawing(i);
   }
   /**
-   * Handle mousemove event:
    * 处理 mousemove 事件：
-   * 
-   * @description
-   * - Only update geometry when drawing
-   * - Do not modify _clickCoords, use temporary coords for update
-   * 
    * - 仅在绘制中才更新几何
    * - 不修改 _clickCoords，只用临时 coords 传给 update
    */
@@ -23355,11 +23329,7 @@ class Fs extends J2 {
     });
   }
   /**
-   * Handle dblclick:
    * 处理 dblclick：
-   * 
-   * @description
-   * - If drawing, finish directly
    * - 如果正在绘制，则直接结束
    */
   _handleDblClick(e) {
@@ -23368,7 +23338,6 @@ class Fs extends J2 {
     this._finishDrawing(t);
   }
   /**
-   * Normally finish a drawing: Call mode.generate and trigger drawend
    * 正常结束一次绘制：调用 mode.generate 并触发 drawend
    */
   _finishDrawing(e) {
@@ -23381,21 +23350,19 @@ class Fs extends J2 {
     }), this._isDrawing = !1, this._clickCoords = [], this._geometry = void 0, this.options.once && this.disable();
   }
   /**
-   * Silently finish (no drawend trigger), used for mode switching / tool disabling
    * 静默结束（不触发 drawend），用于切换模式 / 禁用工具
    */
   _finishDrawingSilently() {
     this._isDrawing = !1, this._clickCoords = [], this._geometry = void 0;
   }
   /**
-  * Internal: Get or create unified draft layer
   * 内部：获取或创建统一草图图层
   */
   _getOrCreateDraftLayer() {
     if (this._draftLayer) return this._draftLayer;
     const e = this.getMap();
     if (!e)
-      throw new Error("DrawTool: map not bound, please call addTo(map) first 尚未绑定地图，请先调用 addTo(map)");
+      throw new Error("DrawTool: 尚未绑定地图，请先调用 addTo(map)");
     const t = `__draw_draft_${Date.now().toString(36)}`, n = new q2(t);
     return e.addLayer(n), this._draftLayer = n, n;
   }
@@ -23557,9 +23524,9 @@ const eP = {
       tool: t,
       draftLayer: n,
       draftPolygon: null,
-      // Draft polygon 草图面
+      // 草图面
       draftEdgeLine: null,
-      // Draft edge line when points < 3 点数<3时的草图边线
+      // 点数<3时的草图边线
       draftAnchors: a,
       polygonStyle: i,
       vertexStyle: o