dxfview 0.0.4-beta.9 → 0.0.5-beta

package/dist/types/plugins/annotation/AnnotationPlugin.d.ts

@@ -1,7 +1,11 @@
 import * as THREE from "three";
 import { BaseAnnotationDrawable, AnnotationModeType, AnnotationData } from "./BaseAnnotationDrawable";
+import { EventInfo } from "../../core/input/InputManager";
 import type { BaseViewer } from "../../core/viewers";
 import { Plugin } from "../../core/viewers/Plugin";
+export interface AnnotationPluginOptions {
+    segmentLabelScaleWithZoom?: boolean;
+}
 export declare class AnnotationPlugin extends Plugin {
     static DEFAULT_ID: string;
     selectedDrawable: BaseAnnotationDrawable | undefined;
@@ -13,10 +17,17 @@ export declare class AnnotationPlugin extends Plugin {
     private snapToleranceInPixel;
     private annotations;
     private activeAnnotationType;
+    private subtractMode;
+    private additionMode;
     private mobileTouchHelper?;
     private selectedMaskColor?;
+    private snapObjects;
+    private snapObjectsDirty;
+    private pendingSnapDrawableIds;
+    private snapLineMaterial?;
+    private segmentLabelScaleWithZoom;
     private readonly partitionLabels;
-    constructor(viewer: BaseViewer);
+    constructor(viewer: BaseViewer, options?: AnnotationPluginOptions);
     getDrawableList(): {
         id: string;
         position: THREE.Vector3;
@@ -24,7 +35,16 @@ export declare class AnnotationPlugin extends Plugin {
         details: import("./BaseAnnotationDrawable").ClosedShape;
     }[];
     getDrawableDatas(): AnnotationData[];
+    getSelectedDrawable(): BaseAnnotationDrawable | undefined;
+    setSelectedDrawable(drawable?: BaseAnnotationDrawable | null, fireEvent?: boolean): void;
+    clearSelection(): void;
     setDrawableDatas(datas: AnnotationData[]): void;
+    getSnapObjects(excludeId?: string): THREE.Object3D[];
+    invalidateSnapObjects(): void;
+    private rebuildSnapObjects;
+    private disposeSnapObjects;
+    private getSnapLineMaterial;
+    private collectDrawableSegments;
     getAigcJson(): {
         properties: {
             uuid: number;
@@ -65,6 +85,12 @@ export declare class AnnotationPlugin extends Plugin {
      * 计算方向角度（基于第一条边）
      */
     private calculateDirection;
+    /**
+     * 根据边界与门的点信息判断门的朝向（第三个点在内：270，反之 90）
+     * @param boundaryPoints 边界的点集合
+     * @param doorPoints 门的点集合
+     */
+    calculateDoorDirectionByBoundary(boundaryPoints: number[][], doorPoints: number[][]): number | undefined;
     /**
      * 中文标签映射到英文
      */
@@ -72,6 +98,9 @@ export declare class AnnotationPlugin extends Plugin {
     private initEvents;
     protected get canvas(): HTMLCanvasElement;
     protected get raycaster(): any;
+    setSegmentLabelScaleWithZoom(enabled: boolean): void;
+    getSegmentLabelScaleWithZoom(): boolean;
+    private applyDrawableRuntimeContext;
     add(drawable: BaseAnnotationDrawable, needFireEvent?: boolean): void;
     create(data: AnnotationData): BaseAnnotationDrawable;
     remove(drawable: BaseAnnotationDrawable, needFireEvent?: boolean): void;
@@ -84,6 +113,16 @@ export declare class AnnotationPlugin extends Plugin {
      * We should call this once camera's zoom, fov or position/target changed, etc.
      */
     private updateSnapTolerance;
+    /**
+     * 设置正交模式开关。
+     * 启用后，绘制标注的线条会被约束为水平或垂直方向。
+     * @param enabled 是否启用正交模式
+     */
+    setOrthoModeEnabled(enabled: boolean): void;
+    /**
+     * 获取正交模式是否启用。
+     */
+    isOrthoModeEnabled(): boolean;
     /**
      *
      * @param {AnnotationModeType} type
@@ -108,6 +147,30 @@ export declare class AnnotationPlugin extends Plugin {
      * @returns {boolean} Is annotating now
      */
     isAnnotating(): boolean;
+    /**
+     * 设置挖空模式（减去图形模式）
+     * @param enabled 是否启用挖空模式
+     * @description {en} Sets subtract mode. When enabled, drawing a new shape inside an existing annotation will subtract/cut out that area.
+     * @description {zh} 设置挖空模式。启用后，在现有标注内绘制新图形将从原标注中减去该区域。
+     */
+    setSubtractMode(enabled: boolean): void;
+    /**
+     * 获取当前挖空模式状态
+     * @returns {boolean} 是否启用挖空模式
+     */
+    getSubtractMode(): boolean;
+    /**
+     * 设置添加模式（合并图形模式）
+     * @param enabled 是否启用添加模式
+     * @description {en} Sets addition mode. When enabled, drawing a new shape that intersects existing annotations will merge/union them together.
+     * @description {zh} 设置添加模式。启用后，绘制与现有标注相交的新图形将合并它们。
+     */
+    setAdditionMode(enabled: boolean): void;
+    /**
+     * 获取当前添加模式状态
+     * @returns {boolean} 是否启用添加模式
+     */
+    getAdditionMode(): boolean;
     /**
      *
      * @returns {AnnotationData[]}
@@ -121,6 +184,16 @@ export declare class AnnotationPlugin extends Plugin {
      */
     cancel(): void;
     private getLastDrawable;
+    /**
+     * 公开的撤回方法，和 Ctrl+Z 的逻辑一致
+     * 用于工具栏撤回按钮调用
+     */
+    undo(): void;
+    /**
+     * 公开的重做方法，和 Ctrl+Y 的逻辑一致
+     * 用于工具栏重做按钮调用
+     */
+    redo(): void;
     /**
      *
      * @param {AnnotationData[]} dataArray
@@ -150,6 +223,10 @@ export declare class AnnotationPlugin extends Plugin {
      */
     getById(id: string): BaseAnnotationDrawable;
     removeById(id: string): void;
+    /**
+     * 删除当前所选的标注，使用与按下 Delete 键相同的逻辑。如果删除了标注，则返回 true。
+     */
+    deleteSelectedAnnotation(): boolean;
     /**
      * Selects an annotation drawable by id.
      * @param {string} id
@@ -159,13 +236,28 @@ export declare class AnnotationPlugin extends Plugin {
     /**
      * Selects an annotation drawable.
      */
-    select(drawable: BaseAnnotationDrawable, fireEvent?: boolean): void;
+    select(drawable: BaseAnnotationDrawable, fireEvent?: boolean, eventInfo?: EventInfo): void;
     /**
      *
      * @param renderEnabled If need render annotation
      * @description Unselects an annotation.
      */
     unselect(renderEnabled?: boolean): void;
+    private syncViewerOverlaySelection;
+    /**
+     * 批量吸附世界坐标点到DXF图形
+     * 使用标准的OSnapHelper进行吸附，和正常标注绘制时的吸附逻辑完全一致
+     *
+     * @param worldPoints 世界坐标点数组
+     * @param excludeId 排除的标注ID（避免吸附到自己）
+     * @returns 吸附后的世界坐标点数组
+     */
+    snapWorldPoints(worldPoints: THREE.Vector3[], excludeId?: string): THREE.Vector3[];
+    /**
+     * 停用吸附标记
+     * 在AI识别吸附完成后调用，清除视觉反馈标记
+     */
+    deactivateSnap(): void;
     /**
      * @description Destroy annotation plugin
      */
@@ -175,6 +267,7 @@ export declare class AnnotationPlugin extends Plugin {
      * 在当前选中图形基础上启动复制预览
      */
     startCopyForSelected(): void;
+    private shouldIgnoreSelectionWhileAnnotating;
     /**
      * 处理 DxfViewer 的统一点击事件，同步插件内部的选择状态
      * 当用户在非激活状态下点击标注时，DxfViewer 会选择对应的 drawable 并触发此事件

package/dist/types/plugins/annotation/AutoDrawAnnotation.d.ts

@@ -14,12 +14,10 @@ import type { BaseViewer } from "../../core/viewers";
  * - 集成对象捕捉功能，提升标注精度
  *
  * 标注策略：
- * - 矩形类型图形将被忽略，不创建标注
- * - 其他多边形使用 FreeDrawDrawable（使用完整的闭合多边形点集）
+ * - 与 viewer 当前单击选择/高亮范围保持一致
+ * - 仅对可提取闭合轮廓的对象创建 FreeDrawDrawable
  */
 export declare class AutoDrawAnnotation extends BaseAnnotation {
-    private debugEnabled;
-    private shapeFinder;
     /**
      * 构造函数
      * @param viewer 基础查看器实例，用于图纸显示和交互
@@ -60,4 +58,5 @@ export declare class AutoDrawAnnotation extends BaseAnnotation {
      * @param e 鼠标事件信息，包含按钮类型、坐标等
      */
     protected onMouseClick(e: EventInfo): void;
+    private completeFromSelectionRings;
 }

package/dist/types/plugins/annotation/BaseAnnotation.d.ts

@@ -3,7 +3,7 @@ import type { BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
 import { AnnotationModeType } from "./BaseAnnotationDrawable";
 import { Tooltip } from "../../components/tool-tip";
 import { DrawableList } from "../../core/canvas/DrawableList";
-import type { MobileTouchHelperDrawable, OSnapHelper } from "../../core/helpers";
+import { type MobileTouchHelperDrawable, type OSnapHelper } from "../../core/helpers";
 import { EventInfo, InputManager } from "../../core/input/InputManager";
 import { Event } from "../../core/utils";
 import type { BaseViewer } from "../../core/viewers";
@@ -12,7 +12,10 @@ import type { BaseViewer } from "../../core/viewers";
  */
 declare type AnnotationEvents = {
     /** 点击标注项时触发（选中标注结果） */
-    ClickedOnAnnotation: BaseAnnotationDrawable;
+    ClickedOnAnnotation: {
+        drawable: BaseAnnotationDrawable;
+        evt: EventInfo;
+    };
     /** 绘制标注完成时触发 */
     Completed: BaseAnnotationDrawable;
     /** 停用标注工具时触发，参数为标注类型 */
@@ -56,6 +59,9 @@ export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
     protected exitButton?: HTMLButtonElement;
     protected firstPickedListener?: () => void;
     protected completedListener?: () => void;
+    protected subtractMode: boolean;
+    protected allDrawableList?: DrawableList;
+    protected additionMode: boolean;
     constructor(type: AnnotationModeType, viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
     get canvas(): HTMLCanvasElement;
     get camera(): THREE.Camera;
@@ -70,6 +76,30 @@ export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
      */
     get isAnnotating(): boolean;
     setTouchHelper(mobileTouchHelper: MobileTouchHelperDrawable): void;
+    /**
+     * 设置挖空模式
+     * @param enabled 是否启用挖空模式
+     * @param drawableList 所有标注的列表，用于查找父标注
+     */
+    setSubtractMode(enabled: boolean, drawableList?: DrawableList): void;
+    /**
+     * 设置添加模式（合并图形模式）
+     * @param enabled 是否启用添加模式
+     * @param drawableList 所有标注的列表，用于查找相交的标注
+     */
+    setAdditionMode(enabled: boolean, drawableList?: DrawableList): void;
+    /**
+     * 查找包含指定点的父标注
+     * @param point 要检查的点
+     * @returns 包含该点的标注，如果没有则返回undefined
+     */
+    protected findParentAnnotationContainingPoint(point: THREE.Vector3): BaseAnnotationDrawable | undefined;
+    /**
+     * 计算多边形面积
+     * @param points 多边形顶点
+     * @returns 面积
+     */
+    protected calculatePolygonArea(points: THREE.Vector3[]): number;
     /**
      * 在移动端创建一个退出绘制的按钮（浮层按钮）。
      * 当用户触摸退出按钮时会结束当前绘制并隐藏按钮。
@@ -91,7 +121,7 @@ export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
     touchend: (e: EventInfo) => void;
     mousedown: (e: EventInfo) => void;
     mousemove: (e: EventInfo) => void;
-    mouseup: (e: EventInfo) => void;
+    mouseup: () => void;
     dblclick: () => void;
     protected onMouseClick(e: EventInfo): void;
     protected selectAnnotationByEvent(e: EventInfo): void;
@@ -115,5 +145,8 @@ export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
      * @param e 事件信息（包含屏幕坐标）
      */
     getIntersections: (e: EventInfo) => THREE.Intersection[];
+    private getAnnotationSnapObjects;
+    protected getMouseWorldPosition(e: EventInfo): THREE.Vector3 | undefined;
+    protected getMouseScreenPosition(e: EventInfo): THREE.Vector2;
 }
 export {};

package/dist/types/plugins/annotation/BaseAnnotationDrawable.d.ts

@@ -34,6 +34,8 @@ export interface ClosedShape {
     position: THREE.Vector3;
 }
 export declare type AnnotationData = DrawableData & {
+    /** 多环几何。rings[0] 是外环，后续 ring 是孔洞。 */
+    rings?: number[][][];
     /** 标注标题 */
     title?: string;
     /** 标注类型/属性等业务信息 */
@@ -55,13 +57,20 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
     protected selectedFillColor?: number[];
     protected dragVertexIndex: number | null;
     protected previewPoints: THREE.Vector3[] | null;
+    protected dragRingIndex: number | null;
+    protected previewRings: THREE.Vector3[][] | null;
     protected details: ClosedShape;
+    protected rings?: THREE.Vector3[][];
     protected ctx?: CanvasRenderingContext2D;
     parent?: BaseAnnotationDrawable;
     protected segmentLabelOffset: number;
     protected segmentLabelFontSize: number;
     protected segmentLabelPaddingX: number;
     protected segmentLabelPaddingY: number;
+    protected segmentLabelScaleWithZoom: boolean;
+    protected segmentLabelReferencePixelSizeInWorldCoord?: number;
+    protected segmentLabelAdaptiveBaseScale?: number;
+    protected segmentLabelAdaptiveBaseScaleSignature?: string;
     protected annotationType?: AnnotationType;
     protected titleText?: string;
     protected annotationProperty?: AnnotationProperty;
@@ -71,12 +80,30 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
      * 设置选中态填充颜色
      */
     setSelectedFillColor(color: number[]): this;
+    setViewer(viewer?: BaseViewer): this;
+    setSegmentLabelScaleWithZoom(enabled: boolean): this;
+    captureSegmentLabelScaleReference(force?: boolean): this;
+    protected getSegmentLabelScaleFactor(): number;
+    private getSegmentLabelReferencePixelSize;
+    private isSegmentLabelRectOverlap;
+    private getSortedSegmentLabelEntries;
+    private measureSegmentLabelRect;
+    private layoutSegmentLabelEntries;
+    private estimateSegmentLabelAdaptiveBaseScale;
+    private buildSegmentLabelAdaptiveBaseScaleSignature;
+    private resolveSegmentLabelAdaptiveBaseScale;
+    private collectSegmentLabelEntries;
+    private prepareSegmentLabelEntries;
     /**
-     * 开始拖拽顶点
+     * 开始拖拽顶点（仅外环 points）
      */
     beginDragVertex(index: number): void;
     /**
-     * 拖拽过程中更新预览点（不修改真实 points）
+     * 开始拖拽指定环上的顶点（0=外环，>=1=洞）
+     */
+    beginDragVertexAt(ringIndex: number, vertexIndex: number): void;
+    /**
+     * 拖拽过程中更新预览点（支持 points 与 rings）
      */
     updateDragPreview(position: THREE.Vector3, eventInfo?: EventInfo): void;
     /**
@@ -111,6 +138,12 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
     setData(data: AnnotationData): void;
     setParent(parent: BaseAnnotationDrawable): void;
     setParentId(parentId: string): void;
+    /**
+     * Update using multi-rings (outer + holes). Points will be set to the outer ring for compatibility.
+     */
+    updateRings(rings: THREE.Vector3[][]): this;
+    /** Get rings if present; fallback to single ring [points] */
+    getRings(): THREE.Vector3[][];
     update(points: THREE.Vector3[]): this;
     /**
      * 对封闭图形的点按从左上角顺时针方向排序
@@ -129,10 +162,13 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
      * 获取与场景的交点列表（用于吸附）
      */
     getIntersections(e: EventInfo): THREE.Intersection[];
+    private getAnnotationSnapObjects;
     /**
      * 处理鼠标移动时的吸附逻辑
      */
     handleSnapOnMove(e: EventInfo): THREE.Vector3 | undefined;
+    private getMouseWorldPosition;
+    private getMouseScreenPosition;
     /**
      * 激活射线检测器（用于吸附）
      */
@@ -141,6 +177,10 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
      * 停用射线检测器
      */
     deactivateRaycaster(): void;
+    private static readonly AREA_SCALE_RATIO;
+    private static readonly MIN_LABEL_SCALE;
+    private static readonly SCREEN_HIDE_THRESHOLD;
+    private static readonly MIN_SCREEN_SEGMENT;
     protected drawSegmentLengths(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
     private drawSegmentLengthLabel;
     private drawRoundedRect;

package/dist/types/plugins/annotation/FreeDrawAnnotation.d.ts

@@ -2,66 +2,92 @@ import * as THREE from "three";
 import { BaseAnnotation } from "./BaseAnnotation";
 import { BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
 import { DrawableList } from "../../core/canvas/DrawableList";
-import type { OSnapHelper } from "../../core/helpers";
+import { type OSnapHelper } from "../../core/helpers";
 import { EventInfo, InputManager } from "../../core/input/InputManager";
 import type { BaseViewer } from "../../core/viewers";
 /**
- * 自由绘制标注类
- * 用于处理自由绘制的标注功能
+ * 自由绘制标注工具
+ * 支持用户通过连续点击创建自由形状的标注，可实现复杂多边形的绘制
+ * 具备点击闭合、双击结束、智能点距控制等功能
  */
 export declare class FreeDrawAnnotation extends BaseAnnotation {
+    /** 相邻点之间的最小距离阈值（像素单位），用于避免冗余点 */
     private minPointDistance;
     constructor(viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
     /**
-     * 退出绘制
+     * 退出自由绘制模式
+     * 根据当前绘制状态决定是完成绘制还是取消绘制
      */
     exitDrawing(): void;
     /**
-     * 取消当前绘制
+     * 取消当前自由绘制操作
+     * 清理所有绘制相关的状态和对象
      */
     cancel(): void;
     /**
-     * 完成当前绘制
+     * 完成当前自由绘制操作
+     * 处理挖空模式、添加模式或正常完成流程
      */
     protected complete(): void;
     /**
-     * 设置提示内容
+     * 处理挖空模式操作
+     * 从已存在的标注中减去当前绘制的自由图形区域，实现复杂图形的挖空效果
+     */
+    private handleSubtractMode;
+    /**
+     * 处理添加模式操作
+     * 将当前绘制的自由图形与相交的标注合并，实现图形的扩展和洞的填充
+     */
+    private handleAdditionMode;
+    /**
+     * 设置工具提示内容
+     * 根据当前绘制状态显示相应的操作提示
      */
     protected setTooltipContent(): void;
     /**
-     * 创建标注drawable
+     * 创建自由绘制标注的可绘制对象
+     * @returns 创建的自由绘制可绘制对象，如果创建失败则返回undefined
      */
     protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
     /**
-     * 重写鼠标点击处理，用于开始绘制
+     * 处理鼠标点击事件，实现自由绘制的交互式操作
+     * @param e 鼠标事件信息
      */
     protected onMouseClick(e: EventInfo): void;
     /**
-     * 开始绘制
+     * 开始自由绘制流程
+     * 通过第一次点击确定绘制的起始点，并初始化绘制状态
+     * @param e 鼠标事件信息
      */
     private startDrawing;
     /**
-     * 继续绘制（添加点）
+     * 继续自由绘制流程
+     * 通过后续点击向绘制路径中添加新的顶点，支持闭合检测和智能点距控制
+     * @param e 鼠标事件信息
      */
     private continueDrawing;
     /**
-     * 重写鼠标移动处理，用于连续绘制
+     * 处理鼠标移动事件，实现自由绘制的实时预览效果
+     * @param position 鼠标当前位置的世界坐标
      */
     protected onMouseMove(position: THREE.Vector3): void;
     /**
-     * 重写双击处理，用于快速结束绘制
+     * 双击事件处理器，提供快速完成绘制的便捷方式
      */
     dblclick: () => void;
     /**
-     * 将世界坐标转换为屏幕坐标
+     * 世界坐标到屏幕坐标的转换工具方法
+     * 用于计算点间距离以实现智能点距控制
+     * @param worldPos 世界坐标系中的3D位置
+     * @returns 对应的屏幕坐标2D位置
      */
     private worldToScreen;
     /**
-     * 从数据恢复标注
-     * 专用于JSON数据恢复，支持保持原始ID不变
-     * @param points 点集合
-     * @param customId 自定义ID，用于保持JSON中的原始ID
-     * @returns 创建的标注ID
+     * 从外部数据恢复自由绘制标注
+     * 专用于从JSON等持久化数据中恢复标注对象，支持保持原始标注ID不变
+     * @param points 标注的顶点集合
+     * @param customId 自定义标注ID，用于保持JSON中存储的原始ID
+     * @returns 成功创建的标注ID，失败时返回undefined
      */
     restoreFromData(points: THREE.Vector3[], customId?: string): string | undefined;
 }

package/dist/types/plugins/annotation/RectAnnotation.d.ts

@@ -2,7 +2,7 @@ import * as THREE from "three";
 import { BaseAnnotation } from "./BaseAnnotation";
 import { AnnotationModeType, BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
 import type { DrawableList } from "../../core/canvas/DrawableList";
-import type { OSnapHelper } from "../../core/helpers";
+import { type OSnapHelper } from "../../core/helpers";
 import type { EventInfo, InputManager } from "../../core/input/InputManager";
 import type { BaseViewer } from "../../core/viewers";
 /**
@@ -12,43 +12,69 @@ import type { BaseViewer } from "../../core/viewers";
  */
 export declare class RectAnnotation extends BaseAnnotation {
     type: AnnotationModeType;
+    /** 矩形绘制的起始点坐标 */
     private startPoint?;
     constructor(viewer: BaseViewer, inputManager: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
     /**
-     * 重写鼠标点击处理，用于矩形绘制
+     * 处理鼠标点击事件，实现矩形的交互式绘制
+     * @param e 鼠标事件信息
      */
     protected onMouseClick(e: EventInfo): void;
     /**
-     * 开始绘制矩形
+     * 开始矩形绘制流程
+     * 通过第一次点击确定矩形的起始点，并初始化绘制状态
+     * @param e 鼠标事件信息
      */
     private startDrawing;
     /**
-     * 完成绘制矩形
+     * 完成矩形绘制流程
+     * 通过第二次点击确定矩形的结束点，并完成绘制
+     * @param e 鼠标事件信息
      */
     private finishDrawing;
     /**
-     * 退出绘制
+     * 退出矩形绘制模式
+     * 根据当前绘制状态决定是完成绘制还是取消绘制
      */
     exitDrawing(): void;
     /**
-     * 取消当前绘制
+     * 取消当前矩形绘制操作
+     * 清理所有绘制相关的状态和对象
      */
     cancel(): void;
     /**
-     * 完成当前绘制
+     * 完成当前矩形绘制操作
+     * 处理挖空模式、添加模式或正常完成流程
      */
     protected complete(): void;
     /**
-     * 设置提示内容
+     * 处理挖空模式操作
+     * 从已存在的标注中减去当前绘制的矩形区域，实现图形挖空效果
+     */
+    private handleSubtractMode;
+    /**
+     * 处理添加模式操作
+     * 将当前绘制的矩形与相交的标注合并，实现图形的扩展和洞的填充
+     */
+    private handleAdditionMode;
+    /**
+     * 设置工具提示内容
+     * 根据当前绘制状态显示相应的操作提示
      */
     protected setTooltipContent(): void;
     /**
-     * 创建标注drawable
+     * 创建矩形标注的可绘制对象
+     * @returns 创建的矩形可绘制对象，如果创建失败则返回undefined
      */
     protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
     /**
-     * 重写鼠标移动处理，用于实时预览
+     * 处理鼠标移动事件，实现矩形绘制的实时预览效果
+     * @param position 鼠标当前位置的世界坐标
      */
     protected onMouseMove(position: THREE.Vector3): void;
+    /**
+     * 根据起始点和对角点更新矩形的四个顶点坐标
+     * @param opposite 矩形的对角点坐标
+     */
     private updateRectanglePoints;
 }

package/dist/types/plugins/annotation/RectDrawable.d.ts

@@ -18,7 +18,6 @@ export declare class RectDrawable extends BaseAnnotationDrawable {
     private getRectPoints;
     isPointInPath(p: THREE.Vector3): boolean;
     getVertexes(): THREE.Vector3[];
-    protected getPointsForSegmentLength(): THREE.Vector3[];
     getClassType(): string;
     /**
      * 重写更新方法，绘制时保持2个对角点，完成时转换为4个顶点
@@ -28,6 +27,12 @@ export declare class RectDrawable extends BaseAnnotationDrawable {
      * 完成绘制时，确保使用完整的4个顶点
      */
     finalizePoints(): void;
+    /**
+     * 支持环顶点拖拽：
+     * - 若已有 rings（包含洞），则按多环顶点拖拽处理
+     * - 若无 rings（经典矩形），则走矩形四角拖拽逻辑
+     */
+    beginDragVertexAt(ringIndex: number, vertexIndex: number): void;
     /**
      * 重写拖拽开始方法，处理4个顶点的拖拽
      */

package/dist/types/plugins/divide/DividePlugin.d.ts

@@ -178,7 +178,7 @@ export declare class DividePlugin extends Plugin {
      * 取消图框创建
      * @param drawable 要取消的绘制数据
      */
-    cancelFrameCreation(drawable: FrameDrawable): void;
+    cancelFrameCreation(drawable?: FrameDrawable): void;
     /**
      * 从JSON数据恢复图框
      * 根据保存的角点坐标重新创建图框

package/dist/types/plugins/divide/FrameAnnotation.d.ts

@@ -138,5 +138,6 @@ export declare class FrameAnnotation extends Event<FrameAnnotationEvents> {
      * 完全按照 BaseAnnotation.ts 的实现
      */
     getIntersections: (e: EventInfo) => THREE.Intersection[];
+    private getMouseWorldPosition;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dxfview",
-    "version": "0.0.4-beta.9",
+    "version": "0.0.5-beta",
     "homepage": "",
     "module": "dist/dxfview.esm.min.js",
     "main": "dist/dxfview.esm.min.js",
@@ -56,7 +56,6 @@
         "regenerator-runtime": "^0.13.11",
         "screenfull": "^6.0.0",
         "stream": "^0.0.2",
-        "three": "^0.155.0",
         "three-mesh-bvh": "^0.5.21"
     },
     "devDependencies": {
@@ -86,5 +85,8 @@
         "tsc-alias": "^1.8.2",
         "typedoc": "^0.22.12",
         "typescript": "^4.5.2"
+    },
+    "peerDependencies": {
+        "three": ">=0.155.0 <0.170.0"
     }
 }