dxfview 0.0.2

package/dist/types/core/viewers/Plugin.d.ts

@@ -0,0 +1,29 @@
+import { Event } from "../utils";
+/**
+ * Base plugin config.
+ */
+export interface PluginConfig {
+    /**
+     * ID for this Plugin, unique within its viewer.
+     */
+    id: string;
+}
+/**
+ * Base plugin class.
+ */
+export declare abstract class Plugin<PluginEvents extends Record<string, unknown> = {}> extends Event<PluginEvents> {
+    readonly id: string;
+    protected viewer: any;
+    /**
+     * Creates this Plugin and installs it into the given {@link Viewer}.
+     *
+     * @param {string} id ID for this plugin, unique among all plugins in the viewer.
+     * @param {Viewer} viewer The viewer.
+     * @param {Object} [cfg] Options
+     */
+    constructor(viewer: any, cfg: PluginConfig);
+    /**
+     * Destroys this Plugin and removes it from its viewer.
+     */
+    destroy(): void;
+}

package/dist/types/core/viewers/ViewerEvent.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Viewer events
+ * TODO: dxf event and bim event
+ */
+export declare enum ViewerEvent {
+    /**
+     * Triggered when click viewer
+     * 当点击查看器时触发
+     */
+    MouseClicked = "MouseClicked",
+    /**
+     * Triggered when click on empty area (no object selected)
+     * 当点击空白区域时触发（未选中任何对象）
+     */
+    EmptyAreaClicked = "EmptyAreaClicked",
+    /**
+     * Triggered when layout is changed.
+     * It is specific for DxfViewer.
+     * 当布局发生变化时触发。
+     * 这是 DxfViewer 特有的。
+     */
+    LayoutChanged = "LayoutChanged",
+    /**
+     * @internal
+     * TODO:bimviewer need too.
+     * Triggered when a model is loaded.
+     * 当模型加载完成时触发。
+     */
+    ModelLoaded = "ModelLoaded",
+    /**
+     * Triggered before rendered.
+     * 在渲染之前触发。
+     */
+    BeforeRender = "BeforeRender",
+    /**
+     * Triggered when rendered
+     * @internal
+     * 当渲染完成时触发
+     */
+    AfterRender = "AfterRender",
+    /**
+     * Triggered when animate() is executed.
+     * @internal
+     * 当执行 animate() 时触发。
+     */
+    OnAnimate = "OnAnimate",
+    /**
+     * Triggered when bimviewer switch camera
+     * @internal
+     * 当 bimviewer 切换相机时触发
+     */
+    CameraChanged = "CameraChanged",
+    /**
+     * Triggered when box select activated
+     * 当框选功能激活时触发
+     */
+    BoxSelectActivated = "BoxSelectActivated",
+    /**
+     * Triggered when box select deactivated
+     * 当框选功能停用时触发
+     */
+    BoxSelectDeactivated = "BoxSelectDeactivated",
+    /**
+     * Triggered when pick markup activated
+     * 当拾取标记功能激活时触发
+     */
+    PickMarkupActivated = "PickMarkupActivated",
+    /**
+     * Triggered when pick markup deactivated
+     * 当拾取标记功能停用时触发
+     */
+    PickMarkupDeactivated = "PickMarkupDeactivated",
+    /**
+     * Triggered when markup feature is activated
+     * 当标记功能激活时触发
+     */
+    MarkupActivated = "MarkupActivated",
+    /**
+     * Triggered when markup feature is deactivated
+     * 当标记功能停用时触发
+     */
+    MarkupDeactivated = "MarkupDeactivated",
+    /**
+     * Triggered when a markup is added
+     * 当添加标记时触发
+     */
+    MarkupAdded = "MarkupAdded",
+    /**
+     * Triggered when a markup is updated
+     * 当更新标记时触发
+     */
+    MarkupUpdated = "MarkupUpdated",
+    /**
+     * Triggered when a markup is removed
+     * 当移除标记时触发
+     */
+    MarkupRemoved = "MarkupRemoved",
+    /**
+     * Triggered before a markup is being removed
+     * 在标记被移除之前触发
+     */
+    BeforeRemoveMarkup = "BeforeRemoveMarkup",
+    /**
+     * Triggered when measurement feature is activated
+     * 当测量功能激活时触发
+     */
+    MeasurementActivated = "MeasurementActivated",
+    /**
+     * Triggered when measurement feature is deactivated
+     * 当测量功能停用时触发
+     */
+    MeasurementDeactivated = "MeasurementDeactivated",
+    /**
+     * Triggered when a measure is added
+     * 当添加测量时触发
+     */
+    MeasurementAdded = "MeasurementAdded",
+    /**
+     * Triggered when a measure is removed
+     * 当移除测量时触发
+     */
+    MeasurementRemoved = "MeasurementRemoved",
+    /**
+     * Triggered when annotation feature is activated
+     * 当注释功能激活时触发
+     */
+    AnnotationActivated = "AnnotationActivated",
+    /**
+     * Triggered when annotation feature is deactivated
+     * 当注释功能停用时触发
+     */
+    AnnotationDeactivated = "AnnotationDeactivated",
+    /**
+     * Triggered when an annotation drawable is clicked/selected
+     * 当点击/选择注释可绘制对象时触发
+     */
+    AnnotationClicked = "AnnotationClicked",
+    /**
+     * Triggered when an annotation is added
+     * 当添加注释时触发
+     */
+    AnnotationAdded = "AnnotationAdded",
+    /**
+     * Triggered when an annotation is removed
+     * 当移除注释时触发
+     */
+    AnnotationRemoved = "AnnotationRemoved",
+    /**
+     * Triggered when divide plugin is activated
+     * 当分割插件激活时触发
+     */
+    DivideActivated = "DivideActivated",
+    /**
+     * Triggered when divide plugin is deactivated
+     * 当分割插件停用时触发
+     */
+    DivideDeactivated = "DivideDeactivated",
+    /**
+     * Triggered when a frame is added
+     * 当添加框架时触发
+     */
+    FrameAdded = "FrameAdded",
+    /**
+     * Triggered when a frame is removed
+     * 当移除框架时触发
+     */
+    FrameRemoved = "FrameRemoved",
+    /**
+     * Triggered when frame detection starts
+     * 当框架检测开始时触发
+     */
+    FrameDetectionStarted = "FrameDetectionStarted",
+    /**
+     * Triggered when frame detection is completed
+     * 当框架检测完成时触发
+     */
+    FrameDetectionCompleted = "FrameDetectionCompleted"
+}

package/dist/types/core/viewers/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./BaseViewer";
+export * from "./DxfViewer";
+export * from "./Plugin";
+export * from "./ViewerEvent";

package/dist/types/export.doc.d.ts

@@ -0,0 +1,10 @@
+export { SectionType, Vector2, Vector3, Box2, DrawableData, InputManager, ModelData3d, ScreenshotMode } from "./core";
+export { BaseDxfCompareHelper, DxfCompareHelper } from "./core/compare";
+export { BaseViewerConfig, BimViewerConfig, CameraConfig, DxfCompareConfig, DxfModelConfig, DxfViewerConfig, Hotpoint, ModelConfig, } from "./core/Configs";
+export { BaseViewer, DxfLayers, DxfViewer, MarkupData, Plugin, PluginConfig, ScreenshotResult, ViewerEvent, } from "./core/viewers";
+export { Model, Model2d, ModelData2d } from "./core/model";
+export { DxfDetailChanges, DxfChangeType, DxfChange, DxfLayer } from "./core/dxf";
+export { ILayer } from "./core/dxf-parser";
+export { MarkupType } from "./core/markup";
+export { ProgressBar } from "./components/progress-bar";
+export { AxisGizmoPlugin, AxisGizmoPluginConfig, BaseMeasureDrawable, DxfViewerToolbarPlugin, DxfViewerToolbarPluginConfig, HotpointPlugin, LocalDxfUploader, MeasurementData, MeasurementPlugin, MeasurementType, Toolbar, ToolbarConfig, ToolbarMenuConfig, ToolbarMenu, ToolbarMenuId, } from "./plugins";

package/dist/types/fetch-polyfill.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+import "./css/main.scss";
+import "./fetch-polyfill";
+import "intl-pluralrules";
+import "core-js/stable";
+import "regenerator-runtime/runtime";
+export * from "./core";
+export * from "./components/progress-bar";
+export * from "./plugins";

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

@@ -0,0 +1,139 @@
+import * as THREE from "three";
+import { BaseAnnotationDrawable, AnnotationModeType, AnnotationData } from "./BaseAnnotationDrawable";
+import type { BaseViewer } from "../../core/viewers";
+import { Plugin } from "../../core/viewers/Plugin";
+export declare class AnnotationPlugin extends Plugin {
+    static DEFAULT_ID: string;
+    selectedDrawable: BaseAnnotationDrawable | undefined;
+    private overlayRender?;
+    private drawableList;
+    private drawableHelperList;
+    private inputManager;
+    private osnapHelper;
+    private snapToleranceInPixel;
+    private annotations;
+    private activeAnnotationType;
+    private mobileTouchHelper?;
+    private selectedMaskColor?;
+    constructor(viewer: BaseViewer);
+    getDrawableList(): {
+        id: string;
+        position: THREE.Vector3;
+        title: string;
+    }[];
+    private initEvents;
+    protected get canvas(): HTMLCanvasElement;
+    protected get raycaster(): any;
+    add(drawable: BaseAnnotationDrawable, needFireEvent?: boolean): void;
+    create(data: AnnotationData): BaseAnnotationDrawable;
+    remove(drawable: BaseAnnotationDrawable, needFireEvent?: boolean): void;
+    /**
+     * Set osnap tolerance in pixcel size. The pixcel size will be converted to a size in world coordinate and pass to OSnapHelper.
+     */
+    setSnapTolerance(toleranceInPixel: number): void;
+    /**
+     * Updates osnap tolerance.
+     * We should call this once camera's zoom, fov or position/target changed, etc.
+     */
+    private updateSnapTolerance;
+    /**
+     *
+     * @param {AnnotationModeType} type
+     * @description {en} Activates one of "FreeDrawAnnotation" annotation
+     * @description {zh} 激活"自由绘制"标注
+     */
+    activate(type: AnnotationModeType): void;
+    /**
+     * @description {en} Deactivates annotation.
+     * @description {zh} 退出标注。
+     */
+    deactivate(): void;
+    getActiveAnnotationType(): AnnotationModeType | undefined;
+    /**
+     *
+     * @returns {boolean}
+     * @description Is annotation plugin active
+     */
+    isActive(): boolean;
+    /**
+     *
+     * @returns {boolean} Is annotating now
+     */
+    isAnnotating(): boolean;
+    /**
+     *
+     * @returns {AnnotationData[]}
+     * @description {en} Gets all annotations.
+     * @description {zh} 获取所有标注数据。
+     */
+    getData(): AnnotationData[];
+    /**
+     * @description {en} Cancels current annotation. This won't deactivate annotation, rather, you can start a new annotation.
+     * @description {zh} 取消当前的标注绘制。这并不会退出标注，用户可以开始一个新的标注。
+     */
+    cancel(): void;
+    /**
+     *
+     * @param {AnnotationData[]} dataArray
+     * @description {en} Sets annotation data.
+     * @description {zh} 设置标注数据。
+     */
+    setData(dataArray: AnnotationData[]): void;
+    /**
+     * Sets an annotation drawable's visibility by id.
+     * @param id
+     * @param visible
+     * @returns
+     * @description Sets an annotation's visibility.
+     */
+    setVisibleById(id: string, visible: boolean): boolean;
+    /**
+     * Sets all annotation drawables' visibilities.
+     */
+    setVisibilities(visible: boolean): void;
+    /**
+     * @description {en} Clears annotation results.
+     * @description {zh} 清除标注结果。
+     */
+    clear(): void;
+    /**
+     * Gets an annotation drawable by id.
+     */
+    getById(id: string): BaseAnnotationDrawable;
+    removeById(id: string): void;
+    /**
+     * Selects an annotation drawable by id.
+     * @param {string} id
+     * @description Selects an annotation by id
+     */
+    selectById(id: string): void;
+    /**
+     * Selects an annotation drawable.
+     */
+    select(drawable: BaseAnnotationDrawable, fireEvent?: boolean): void;
+    /**
+     *
+     * @param renderEnabled If need render annotation
+     * @description Unselects an annotation.
+     */
+    unselect(renderEnabled?: boolean): void;
+    /**
+     * @description Destroy annotation plugin
+     */
+    destroy(): void;
+    private keydown;
+    /**
+     * 在当前选中图形基础上启动复制预览
+     */
+    startCopyForSelected(): void;
+    /**
+     * 处理 DxfViewer 的统一点击事件，同步插件内部的选择状态
+     * 当用户在非激活状态下点击标注时，DxfViewer 会选择对应的 drawable 并触发此事件
+     */
+    private onViewerMouseClicked;
+    private render;
+    /**
+     * 将当前选中的遮罩层填充色设置为指定颜色（并记忆为后续选择的默认选中色）。
+     */
+    setSelectedMaskColor(color: number[]): void;
+}

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

@@ -0,0 +1,63 @@
+import { BaseAnnotation } from "./BaseAnnotation";
+import { BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
+import type { DrawableList } from "../../core/canvas/DrawableList";
+import type { OSnapHelper } from "../../core/helpers";
+import { EventInfo, InputManager } from "../../core/input/InputManager";
+import type { BaseViewer } from "../../core/viewers";
+/**
+ * 自动标注类：点击图纸，自动判断命中构件并在封闭区域内生成标注
+ *
+ * 功能特性：
+ * - 智能识别封闭图形（多边形等）
+ * - 自动创建自由绘制标注
+ * - 支持鼠标点击交互和键盘取消操作
+ * - 集成对象捕捉功能，提升标注精度
+ *
+ * 标注策略：
+ * - 矩形类型图形将被忽略，不创建标注
+ * - 其他多边形使用 FreeDrawDrawable（使用完整的闭合多边形点集）
+ */
+export declare class AutoDrawAnnotation extends BaseAnnotation {
+    private debugEnabled;
+    private shapeFinder;
+    /**
+     * 构造函数
+     * @param viewer 基础查看器实例，用于图纸显示和交互
+     * @param input 输入管理器，处理鼠标和键盘事件
+     * @param drawList 绘制列表，管理所有标注对象的显示
+     * @param osnapHelper 对象捕捉助手，提供精确的点捕捉功能
+     */
+    constructor(viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
+    /**
+     * 退出绘制模式
+     * 重置完成状态，准备下一次标注操作
+     */
+    exitDrawing(): void;
+    /**
+     * 取消当前标注操作
+     * 清理所有临时状态和绘制的标注对象
+     */
+    cancel(): void;
+    /**
+     * 完成标注绘制
+     * 最终化当前标注对象并触发完成事件
+     */
+    protected complete(): void;
+    /**
+     * 设置工具提示内容
+     * 显示当前标注模式的使用说明
+     */
+    protected setTooltipContent(): void;
+    /**
+     * 创建标注绘制对象
+     * 自动标注模式不需要预创建标注对象，返回undefined
+     * @returns 始终返回undefined，因为标注对象是在点击时动态创建的
+     */
+    protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
+    /**
+     * 处理鼠标点击事件
+     * 这是自动标注的核心逻辑，负责识别点击位置的封闭图形并创建相应标注
+     * @param e 鼠标事件信息，包含按钮类型、坐标等
+     */
+    protected onMouseClick(e: EventInfo): void;
+}

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

@@ -0,0 +1,113 @@
+import * as THREE from "three";
+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 { EventInfo, InputManager } from "../../core/input/InputManager";
+import { Event } from "../../core/utils";
+import type { BaseViewer } from "../../core/viewers";
+/**
+ * 可序列化的标注数据类型（用于保存/恢复标注结果）。
+ */
+declare type AnnotationEvents = {
+    /** 点击标注项时触发（选中标注结果） */
+    ClickedOnAnnotation: BaseAnnotationDrawable;
+    /** 绘制标注完成时触发 */
+    Completed: BaseAnnotationDrawable;
+    /** 停用标注工具时触发，参数为标注类型 */
+    Deactivate: AnnotationModeType;
+    /** 绘制时第一个点被拾取时触发 */
+    FirstPointPicked: BaseAnnotationDrawable;
+    /** 标注即将被添加到列表时触发（用于 UI 更新） */
+    WillBeAdded: BaseAnnotationDrawable;
+    /** 标注被更新时触发（例如拖动或添加点） */
+    Updated: BaseAnnotationDrawable;
+    /** 标注即将被移除时触发 */
+    WillBeRemoved: BaseAnnotationDrawable;
+};
+/**
+ * 基础标注类。
+ * 所有具体标注工具（如自由绘制、矩形绘制等）均继承自此类。
+ * 负责事件绑定、拾取、鼠标/触摸交互的通用逻辑，以及与 OSnap 的交互。
+ */
+export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
+    protected type: AnnotationModeType;
+    protected viewer: BaseViewer;
+    private inputManager;
+    protected drawList: DrawableList;
+    protected osnapHelper: OSnapHelper;
+    protected raycaster?: THREE.Raycaster;
+    protected mouseMoved: boolean;
+    protected mouseDowned: boolean;
+    protected touchDowned: boolean;
+    protected lastMoveEvent?: EventInfo;
+    protected lastMouseDownPosition?: THREE.Vector3;
+    protected mouseDownPositionX: number;
+    protected mouseDownPositionY: number;
+    protected currentAnnotationDrawable?: BaseAnnotationDrawable;
+    protected drawingPoints?: THREE.Vector3[];
+    protected lastClickTime?: number;
+    protected tooltip?: Tooltip;
+    protected snapPoint?: THREE.Vector3 | undefined;
+    protected completed?: boolean;
+    protected clickedOnAnnotationDrawable?: BaseAnnotationDrawable;
+    protected mobileTouchHelper?: MobileTouchHelperDrawable;
+    protected exitButton?: HTMLButtonElement;
+    protected firstPickedListener?: () => void;
+    protected completedListener?: () => void;
+    constructor(type: AnnotationModeType, viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
+    get canvas(): HTMLCanvasElement;
+    get camera(): THREE.Camera;
+    get renderer(): THREE.WebGLRenderer;
+    /**
+     * If annotation is active.
+     * Here let's use raycaster to identify whether this annotation is active.
+     */
+    get isActive(): boolean;
+    /**
+     * If it started to annotate, but an annotation action is not completed yet.
+     */
+    get isAnnotating(): boolean;
+    setTouchHelper(mobileTouchHelper: MobileTouchHelperDrawable): void;
+    /**
+     * 在移动端创建一个退出绘制的按钮（浮层按钮）。
+     * 当用户触摸退出按钮时会结束当前绘制并隐藏按钮。
+     */
+    protected createMobileExitButton(): HTMLButtonElement;
+    /**
+     * 激活标注工具：绑定相应的鼠标/触摸/键盘事件，并创建射线检测器（raycaster）。
+     * 注意：CameraControlsEx 会阻止原生的 mouseup/mousedown/mousemove，因此使用 pointer 事件代替。
+     */
+    activate(): void;
+    /**
+     * 停用标注工具：移除事件绑定、销毁提示、清理当前绘制状态并取消 OSnap。
+     */
+    deactivate(): void;
+    protected removeDrawable(drawable: BaseAnnotationDrawable): void;
+    clearClickedDrawable(): void;
+    touchstart: (e: EventInfo) => void;
+    touchmove: (e: EventInfo) => void;
+    touchend: (e: EventInfo) => void;
+    mousedown: (e: EventInfo) => void;
+    mousemove: (e: EventInfo) => void;
+    mouseup: (e: EventInfo) => void;
+    dblclick: () => void;
+    protected onMouseClick(e: EventInfo): void;
+    protected selectAnnotationByEvent(e: EventInfo): void;
+    keydown: (e: EventInfo) => void;
+    abstract exitDrawing(): void;
+    abstract cancel(): void;
+    protected abstract complete(): void;
+    protected abstract setTooltipContent(): void;
+    protected abstract createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
+    protected onMouseMove(position: THREE.Vector3): void;
+    protected createOrUpdateAnnotationDrawable(position?: THREE.Vector3): void;
+    /**
+     * 获取射线与场景的交点列表（已按距离排序且过滤被裁剪的点）。
+     * 返回值用于后续的 OSnap 处理。
+     * @param e 事件信息（包含屏幕坐标）
+     */
+    getIntersections: (e: EventInfo) => THREE.Intersection[];
+}
+export {};

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

@@ -0,0 +1,139 @@
+import * as THREE from "three";
+import { AnnotationProperty, AnnotationType } from "./type";
+import { Drawable, DrawableData, OSnapHelper } from "../../core";
+import { EventInfo } from "../../core/input/InputManager";
+import type { BaseViewer } from "../../core/viewers";
+export declare enum AnnotationModeType {
+    FREEDRAW = "free_draw",
+    REACTDRAW = "react_draw",
+    AUTODRAW = "auto_draw",
+    RECT = "rect",
+    COPY = "copy"
+}
+export interface ConnectionPoint {
+    position: THREE.Vector3;
+    type: "endpoint" | "control";
+    segmentIds: string[];
+    draggable: boolean;
+    snap: {
+        enabled: boolean;
+        radius: number;
+        priority: number;
+    };
+}
+export interface ClosedShape {
+    id: string;
+    objectId?: number;
+    annotationType: AnnotationType;
+    title: string;
+    property: AnnotationProperty;
+    isSelected: boolean;
+    parentId?: string;
+    childrenIds: string[];
+    version: number;
+    position: THREE.Vector3;
+}
+export declare type AnnotationData = DrawableData & {
+    /** 标注标题 */
+    title?: string;
+    /** 标注类型/属性等业务信息 */
+    annotationType?: AnnotationType;
+    property?: AnnotationProperty;
+    /** 封闭形状的结构化信息（端点/中点/线段） */
+    details: ClosedShape;
+};
+export declare abstract class BaseAnnotationDrawable extends Drawable {
+    type: AnnotationModeType;
+    protected editPointSize: number;
+    protected editPointFillColor: string;
+    protected editPointStrokeColor: string;
+    protected osnapHelper: OSnapHelper;
+    protected viewer?: BaseViewer;
+    protected raycaster?: THREE.Raycaster;
+    protected snapPoint?: THREE.Vector3 | undefined;
+    protected isDrawing: boolean;
+    protected selectedFillColor?: number[];
+    protected dragVertexIndex: number | null;
+    protected previewPoints: THREE.Vector3[] | null;
+    protected details: ClosedShape;
+    protected ctx?: CanvasRenderingContext2D;
+    parent?: BaseAnnotationDrawable;
+    protected annotationType?: AnnotationType;
+    protected titleText?: string;
+    protected annotationProperty?: AnnotationProperty;
+    constructor(id: string, osnapHelper: OSnapHelper, viewer?: BaseViewer);
+    isSelected(): boolean;
+    /**
+     * 设置选中态填充颜色
+     */
+    setSelectedFillColor(color: number[]): this;
+    /**
+     * 开始拖拽顶点
+     */
+    beginDragVertex(index: number): void;
+    /**
+     * 拖拽过程中更新预览点（不修改真实 points）
+     */
+    updateDragPreview(position: THREE.Vector3, eventInfo?: EventInfo): void;
+    /**
+     * 结束拖拽，提交修改
+     */
+    endDragVertex(): void;
+    /**
+     * 同步闭合点：当拖动第一个点或最后一个点时，确保闭合图形保持闭合
+     */
+    private syncClosurePoints;
+    /**
+     * 检查当前图形是否为闭合图形
+     */
+    isClosedShape(): boolean;
+    drawSelect(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    setAnnotationType(type: AnnotationType): this;
+    getAnnotationType(): AnnotationType | undefined;
+    setTitle(title: string): this;
+    getTitle(): string | undefined;
+    setProperty(property: Partial<AnnotationProperty>): this;
+    getProperty<T extends AnnotationProperty>(): T | undefined;
+    /**
+     * 生成 details（端点/中点/线段）并返回含业务字段的 AnnotationData
+     */
+    getData(): AnnotationData;
+    private drawPoints;
+    setEditPointSize(size: number): void;
+    setEditPointFillColor(color: string): void;
+    setEditPointStrokeColor(color: string): void;
+    getCenter(): THREE.Vector3;
+    isPointInPath(p: THREE.Vector3): boolean;
+    setData(data: AnnotationData): void;
+    setParent(parent: BaseAnnotationDrawable): void;
+    update(points: THREE.Vector3[]): this;
+    /**
+     * 对封闭图形的点按从左上角顺时针方向排序
+     * 适用于多边形、矩形等封闭图形
+     * 注意：此方法会改变点的顺序，可能影响闭合图形的闭合关系
+     */
+    sortPointsClockwiseFromTopLeft(): void;
+    translate(tx: number, ty: number): this;
+    rotate(): this;
+    scale(): this;
+    /**
+     * 设置绘制状态
+     */
+    setDrawingState(isDrawing: boolean): void;
+    /**
+     * 获取与场景的交点列表（用于吸附）
+     */
+    getIntersections(e: EventInfo): THREE.Intersection[];
+    /**
+     * 处理鼠标移动时的吸附逻辑
+     */
+    handleSnapOnMove(e: EventInfo): THREE.Vector3 | undefined;
+    /**
+     * 激活射线检测器（用于吸附）
+     */
+    activateRaycaster(): void;
+    /**
+     * 停用射线检测器
+     */
+    deactivateRaycaster(): void;
+}