dxfview 0.0.2

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

@@ -0,0 +1,36 @@
+import * as THREE from "three";
+import { BaseAnnotation } from "./BaseAnnotation";
+import type { BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
+import { DrawableList } from "../../core/canvas";
+import type { OSnapHelper } from "../../core/helpers";
+import { EventInfo, InputManager } from "../../core/input/InputManager";
+import type { BaseViewer } from "../../core/viewers";
+/**
+ * CopyAnnotation: 复制绘制模式
+ * - 当选择到一个封闭图形后，按下 Ctrl+C 进入复制模式，生成一个 CopyDrawable 预览
+ * - 鼠标移动时，CopyDrawable 左上角跟随吸附位置移动
+ * - 左键点击落下并完成复制（复制原图形的 title/annotationType/property）
+ */
+export declare class CopyAnnotation extends BaseAnnotation {
+    private sourceDrawable?;
+    private copyDrawable?;
+    constructor(viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
+    exitDrawing(): void;
+    cancel(): void;
+    protected complete(): void;
+    protected setTooltipContent(): void;
+    protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
+    activate(): void;
+    deactivate(): void;
+    private onKeyDownForCopy;
+    /**
+     * 从当前 drawList 选择开始复制（用于 Ctrl+C 或调用方触发）
+     */
+    beginWithSelection(): void;
+    /**
+     * 外部可传入指定源图形直接开始复制预览
+     */
+    beginWithSource(src: BaseAnnotationDrawable): void;
+    protected onMouseMove(position: THREE.Vector3): void;
+    protected onMouseClick(e: EventInfo): void;
+}

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

@@ -0,0 +1,26 @@
+import * as THREE from "three";
+import { BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
+import { AnnotationProperty, AnnotationType } from "./type";
+import { OSnapHelper } from "../../core/helpers";
+import type { BaseViewer } from "../../core/viewers";
+/**
+ * CopyDrawable: 复制出的封闭图形，在鼠标移动时跟随光标（带吸附），点击落下
+ */
+export declare class CopyDrawable extends BaseAnnotationDrawable {
+    private clonedFromPoints;
+    constructor(id: string, osnapHelper: OSnapHelper, viewer?: BaseViewer);
+    /**
+     * 设定被复制的原始点集与元数据
+     */
+    setSource(points: THREE.Vector3[], meta?: {
+        title?: string;
+        annotationType?: AnnotationType;
+        property?: Partial<AnnotationProperty>;
+    }): this;
+    /**
+     * 根据给定的左上角目标位置，平移当前图形到该位置
+     */
+    moveToTopLeft(targetTopLeft: THREE.Vector3): this;
+    draw(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    getClassType(): string;
+}

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

@@ -0,0 +1,59 @@
+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 { 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;
+    /**
+     * 设置提示内容
+     */
+    protected setTooltipContent(): void;
+    /**
+     * 创建标注drawable
+     */
+    protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
+    /**
+     * 重写鼠标点击处理，用于开始绘制
+     */
+    protected onMouseClick(e: EventInfo): void;
+    /**
+     * 开始绘制
+     */
+    private startDrawing;
+    /**
+     * 继续绘制（添加点）
+     */
+    private continueDrawing;
+    /**
+     * 重写鼠标移动处理，用于连续绘制
+     */
+    protected onMouseMove(position: THREE.Vector3): void;
+    /**
+     * 重写双击处理，用于快速结束绘制
+     */
+    dblclick: () => void;
+    /**
+     * 将世界坐标转换为屏幕坐标
+     */
+    private worldToScreen;
+}

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

@@ -0,0 +1,53 @@
+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 { EventInfo, InputManager } from "../../core/input/InputManager";
+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);
+    /**
+     * 重写鼠标点击处理，用于矩形绘制
+     */
+    protected onMouseClick(e: EventInfo): void;
+    /**
+     * 开始绘制矩形
+     */
+    private startDrawing;
+    /**
+     * 完成绘制矩形
+     */
+    private finishDrawing;
+    /**
+     * 退出绘制
+     */
+    exitDrawing(): void;
+    /**
+     * 取消当前绘制
+     */
+    cancel(): void;
+    /**
+     * 完成当前绘制
+     */
+    protected complete(): void;
+    /**
+     * 设置提示内容
+     */
+    protected setTooltipContent(): void;
+    /**
+     * 创建标注drawable
+     */
+    protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
+    /**
+     * 重写鼠标移动处理，用于实时预览
+     */
+    protected onMouseMove(position: THREE.Vector3): void;
+}

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

@@ -0,0 +1,42 @@
+import * as THREE from "three";
+import { AnnotationModeType, BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
+import { OSnapHelper } from "../../core/helpers";
+import { EventInfo } from "../../core/input/InputManager";
+import type { BaseViewer } from "../../core/viewers";
+/**
+ * 矩形标注 Drawable
+ * 支持通过两个对角点绘制矩形，具有填充和边框
+ */
+export declare class RectDrawable extends BaseAnnotationDrawable {
+    type: AnnotationModeType;
+    private dragFixedPoint?;
+    constructor(id: string, osnapHelper: OSnapHelper, points: THREE.Vector3[], viewer?: BaseViewer);
+    draw(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    /**
+     * 根据两个对角点计算矩形的四个顶点
+     */
+    private getRectPoints;
+    isPointInPath(p: THREE.Vector3): boolean;
+    getVertexes(): THREE.Vector3[];
+    getClassType(): string;
+    /**
+     * 重写更新方法，确保矩形只需要两个点
+     */
+    update(points: THREE.Vector3[]): this;
+    /**
+     * 重写拖拽开始方法，处理4个顶点的拖拽
+     */
+    beginDragVertex(index: number): void;
+    /**
+     * 重写拖拽预览更新方法，处理4个顶点的拖拽
+     */
+    updateDragPreview(position: THREE.Vector3, eventInfo?: EventInfo): void;
+    /**
+     * 重写拖拽结束方法，处理4个顶点的拖拽
+     */
+    endDragVertex(): void;
+    /**
+     * 根据拖拽的顶点更新矩形的两个对角点
+     */
+    private updateRectFromVertexDrag;
+}

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

@@ -0,0 +1,51 @@
+import * as THREE from "three";
+import { EventInfo } from "../../core/input/InputManager";
+import type { BaseViewer } from "../../core/viewers";
+export interface ShapeCandidate {
+    kind: "rect" | "polygon";
+    area: number;
+    nestingLevel: number;
+    data: {
+        kind: "rect";
+        rect: {
+            min: THREE.Vector3;
+            max: THREE.Vector3;
+        };
+    } | {
+        kind: "polygon";
+        points: THREE.Vector3[];
+    };
+    source: string;
+}
+export declare class ShapeFinder {
+    private viewer;
+    private debugEnabled;
+    private closedPolysCache;
+    constructor(viewer: BaseViewer, debug?: boolean);
+    private d;
+    pickSmallestClosedShapeContainingPoint(e: EventInfo, p: THREE.Vector3): {
+        kind: "rect";
+        rect: {
+            min: THREE.Vector3;
+            max: THREE.Vector3;
+        };
+    } | {
+        kind: "polygon";
+        points: THREE.Vector3[];
+    } | undefined;
+    private collectCandidatesFromIntersections;
+    private collectCandidatesFromObjects;
+    private extractCandidatesFromObject;
+    private extractClosedPolygonsFromLineObject;
+    private makeRectKey;
+    private makePolyKey;
+    private shouldConsiderObjectNearPoint;
+    private extractClosedPolygonsFromLineObjectUsingBatches;
+    private buildSegmentsForBatch;
+    private calculateNestingLevels;
+    private isShapeCompletelyInside;
+    private getAxisAlignedBoundingRect;
+    private filterCandidatesByDistance;
+    private getDistanceToClickPoint;
+    private sortCandidates;
+}

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

@@ -0,0 +1,21 @@
+import * as THREE from "three";
+import { AnnotationModeType, BaseAnnotationDrawable } from "./BaseAnnotationDrawable";
+import { OSnapHelper } from "../../core/helpers";
+import type { BaseViewer } from "../../core/viewers";
+export declare class FreeDrawDrawable extends BaseAnnotationDrawable {
+    type: AnnotationModeType;
+    constructor(id: string, osnapHelper: OSnapHelper, points: THREE.Vector3[], viewer?: BaseViewer);
+    draw(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    isPointInPath(p: THREE.Vector3): boolean;
+    getVertexes(): THREE.Vector3[];
+    getClassType(): string;
+    /**
+     * 检查当前图形是否为闭合图形
+     */
+    isClosed(): boolean;
+    /**
+     * 手动对自由绘制的点进行排序
+     * 注意：只有在确认需要排序时才调用此方法，因为它会改变用户绘制的原始顺序
+     */
+    sortPointsManually(): void;
+}

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

@@ -0,0 +1,8 @@
+export * from "./BaseAnnotationDrawable";
+export * from "./BaseAnnotation";
+export * from "./freeDrawDrawable";
+export * from "./FreeDrawAnnotation";
+export * from "./AutoDrawAnnotation";
+export * from "./RectDrawable";
+export * from "./RectAnnotation";
+export * from "./AnnotationPlugin";

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

@@ -0,0 +1,182 @@
+export interface Point {
+    x: number;
+    y: number;
+    z?: number;
+}
+export interface ConnectionPoint {
+    id: string;
+    position: THREE.Vector3;
+    type: "endpoint" | "control";
+    segmentIds: string[];
+    draggable: boolean;
+    snap: {
+        enabled: boolean;
+        radius: number;
+        priority: number;
+    };
+}
+export interface Segment {
+    id: string;
+    startPointId: string;
+    endPointId: string;
+    type: "line" | "arc" | "bezier";
+    mesh: THREE.Mesh | THREE.Line;
+    style?: SegmentStyle;
+    breakable: boolean;
+}
+export interface SegmentStyle {
+    color?: string;
+    width?: number;
+    dashArray?: number[];
+    opacity?: number;
+}
+export declare enum AnnotationType {
+    PARTITION_AREA = "partition",
+    PARTITION_DOOR = "partitionDoor",
+    PARTITION_WINDOW = "partitionWindow",
+    FURNITURE = "furniture",
+    EQUIPMENT = "equipment"
+}
+export interface BaseAnnotationProperty {
+    type: AnnotationType;
+    [key: string]: unknown;
+}
+export interface PartitionAreaProperty extends BaseAnnotationProperty {
+    type: AnnotationType.PARTITION_AREA;
+    area: number;
+    areaUnit?: "m²" | "mm²";
+    roomType?: string;
+    floorMaterial?: string;
+}
+export interface PartitionDoorProperty extends BaseAnnotationProperty {
+    type: AnnotationType.PARTITION_DOOR;
+    doorName: string;
+    doorType: string;
+    doorDirection: number;
+    doorArea: number;
+    openingAngle?: number;
+    material?: string;
+}
+export interface PartitionWindowProperty extends BaseAnnotationProperty {
+    type: AnnotationType.PARTITION_WINDOW;
+    windowName: string;
+    windowType: string;
+    windowArea: number;
+    openingType?: "fixed" | "sliding" | "casement";
+}
+export declare type AnnotationProperty = PartitionAreaProperty | PartitionDoorProperty | PartitionWindowProperty;
+export interface AnnotationTitleConfig {
+    type: AnnotationType;
+    titles: string[];
+    defaultTitle: string;
+    allowCustomTitle: boolean;
+}
+export interface ClosedShape {
+    id: string;
+    objectId?: number;
+    connectionPoints: Map<string, ConnectionPoint>;
+    segments: Map<string, Segment>;
+    annotationType: AnnotationType;
+    title: string;
+    property: AnnotationProperty;
+    isSelected: boolean;
+    isEditing: boolean;
+    isVisible: boolean;
+    parentId?: string;
+    childrenIds: string[];
+    direction?: number;
+    style?: ShapeStyle;
+    createTime: Date;
+    updateTime: Date;
+    version: number;
+}
+export interface ShapeStyle {
+    fillColor?: string;
+    strokeColor?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    pattern?: "solid" | "dashed" | "dotted";
+}
+export declare enum ShapeOperationType {
+    CREATE = "create",
+    UPDATE = "update",
+    DELETE = "delete",
+    BREAK_SEGMENT = "breakSegment",
+    SNAP_TO_POINT = "snapToPoint",
+    DRAG_POINT = "dragPoint",
+    CONNECT_SEGMENTS = "connectSegments",
+    SPLIT_SHAPE = "splitShape",
+    MERGE_SHAPE = "mergeShape"
+}
+export interface ShapeOperation {
+    type: ShapeOperationType;
+    shapeId: string;
+    timestamp: Date;
+    data: unknown;
+    inverse?: ShapeOperation;
+}
+export interface AnnotationManager {
+    createShape(type: AnnotationType, points: Point[]): ClosedShape;
+    updateShape(id: string, updates: Partial<ClosedShape>): void;
+    deleteShape(id: string): void;
+    breakSegment(segmentId: string, breakPoint: Point): {
+        newSegments: [Segment, Segment];
+        newConnectionPoint: ConnectionPoint;
+    };
+    dragConnectionPoint(pointId: string, newPosition: Point): void;
+    snapToNearestPoint(position: Point, snapRadius?: number): ConnectionPoint | null;
+    connectSegmentEndpoints(segmentId1: string, segmentId2: string): ConnectionPoint;
+    setAnnotationType(shapeId: string, type: AnnotationType): void;
+    updateProperty(shapeId: string, property: Partial<AnnotationProperty>): void;
+    getTitleOptions(type: AnnotationType): string[];
+    setTitle(shapeId: string, title: string): void;
+    getShape(id: string): ClosedShape | null;
+    getShapesByType(type: AnnotationType): ClosedShape[];
+    getSelectedShapes(): ClosedShape[];
+    getConnectionPointsInRadius(position: Point, radius: number): ConnectionPoint[];
+    getSnappablePoints(): ConnectionPoint[];
+    on(event: string, callback: (data: unknown) => void): void;
+    off(event: string, callback: (data: unknown) => void): void;
+    emit(event: string, data: unknown): void;
+    undo(): void;
+    redo(): void;
+    canUndo(): boolean;
+    canRedo(): boolean;
+}
+export interface AnnotationConfig {
+    titleConfigs: Record<AnnotationType, AnnotationTitleConfig>;
+    defaultStyles: Record<AnnotationType, ShapeStyle>;
+    operationSettings: {
+        enableAutoSnap: boolean;
+        snapDistance: number;
+        minSegmentLength: number;
+        enableRealTimeValidation: boolean;
+        breakPointTolerance: number;
+        connectionPointSize: number;
+    };
+    snapSettings: {
+        enabled: boolean;
+        defaultRadius: number;
+        visualFeedback: boolean;
+        snapTypes: ("endpoint" | "control" | "midpoint" | "intersection")[];
+    };
+}
+export interface ShapeEvent {
+    type: string;
+    shape: ClosedShape;
+    operation?: ShapeOperation;
+    mouse?: {
+        position: Point;
+        button: number;
+    };
+}
+export interface AnnotationValidator {
+    validateShape(shape: ClosedShape): ValidationResult;
+    validateProperty(property: AnnotationProperty): ValidationResult;
+    validateOperation(operation: ShapeOperation): ValidationResult;
+}
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}

package/dist/types/plugins/axis-gizmo/AxisGizmoPlugin.d.ts

@@ -0,0 +1,49 @@
+import { BaseViewer, Plugin, PluginConfig } from "../../core";
+/**
+ * AxisGizmo plugin config.
+ */
+export interface AxisGizmoPluginConfig extends Partial<PluginConfig> {
+    /**
+     * UI element id to contain the plugin.
+     */
+    containerId?: string;
+    /**
+     * Ignores z-axis. It is useful for DxfViewer.
+     */
+    ignoreZAxis: boolean;
+}
+/**
+ * This renderer monitors the host renderer's camera, and keeps a coordinate axes
+ * the same direction as host renderer's
+ */
+export declare class AxisGizmoPlugin extends Plugin {
+    static DEFAULT_ID: string;
+    private cfg;
+    private hostCamera?;
+    private container?;
+    private coordinateAxes?;
+    private ignoreZAxis;
+    private camera?;
+    private scene?;
+    private renderer?;
+    private css2dRenderer?;
+    constructor(viewer: BaseViewer, cfg: AxisGizmoPluginConfig);
+    private init;
+    private initRenderer;
+    private initScene;
+    /**
+     * Sets hostCamera in case it is changed.
+     * It is possible for a viewer to switch camera between a OrthographicCamera and a PerspectiveCamera.
+     */
+    private setHostCamera;
+    private render;
+    private animate;
+    private update;
+    /**
+     * Update axes according to camera direction.
+     * Camera's direction is the only input factor for this class. It always look at the origin.
+     * @param direction
+     */
+    private updateCameraDirection;
+    destroy(): void;
+}

package/dist/types/plugins/axis-gizmo/CoordinateAxes.d.ts

@@ -0,0 +1,12 @@
+import * as THREE from "three";
+import { CSS2DObject } from "three/examples/jsm/renderers/CSS2DRenderer.js";
+export declare class CoordinateAxes extends THREE.Object3D {
+    name: string;
+    private readonly AXIS_LENGTH;
+    private readonly AXIS_COLOR_X;
+    private readonly AXIS_COLOR_Y;
+    private readonly AXIS_COLOR_Z;
+    constructor(addTexts?: boolean, ignoreZAxis?: boolean);
+    addTexts(ignoreZAxis?: boolean): void;
+    createText(text: string, color: string, size?: number): CSS2DObject;
+}

package/dist/types/plugins/axis-gizmo/index.d.ts

@@ -0,0 +1 @@
+export * from "./AxisGizmoPlugin";

package/dist/types/plugins/bottom-bar/BottomBarPlugin.d.ts

@@ -0,0 +1,44 @@
+import { Tooltip } from "../../components/tool-tip";
+import { IconClass } from "../../core";
+import { BaseViewer } from "../../core/viewers/BaseViewer";
+import { Plugin } from "../../core/viewers/Plugin";
+declare enum BottomBarItemId {
+    statistics = "dxfview-statistics",
+    cameraInfo = "dxfview-cameraInfo",
+    tips = "dxfview-tips"
+}
+interface BottomBarItemConfig {
+    icon: IconClass;
+    mutexIds?: BottomBarItemId[];
+    onActive?: (item: BottomBarItem) => void;
+    onDeactive?: (item: BottomBarItem) => void;
+    onClick?: (item: BottomBarItem) => void;
+    onUpdate?: (item: BottomBarItem) => void;
+}
+/**
+ * Bottom bar plugin is a debug tool for developers.
+ */
+export declare class BottomBarPlugin extends Plugin {
+    private element;
+    itemList: Map<string, BottomBarItem>;
+    constructor(viewer: BaseViewer);
+    update(): void;
+    private init;
+    private createItem;
+}
+declare class BottomBarItem {
+    readonly viewer: BaseViewer;
+    private readonly bottomBar;
+    protected readonly menuId: string;
+    protected cfg: BottomBarItemConfig;
+    private eventBus;
+    private itemconfig;
+    tooltip: Tooltip;
+    element: HTMLElement;
+    active: boolean;
+    constructor(viewer: BaseViewer, bottomBar: BottomBarPlugin, menuId: string, cfg: BottomBarItemConfig);
+    private createButton;
+    setActive(active: boolean): void;
+    update(): void;
+}
+export {};

package/dist/types/plugins/bottom-bar/index.d.ts

@@ -0,0 +1 @@
+export * from "./BottomBarPlugin";

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

@@ -0,0 +1,44 @@
+import * as THREE from "three";
+import type { InternalFrame } from "./types";
+import type { BaseViewer } from "../../core/viewers";
+/**
+ * 覆盖层管理器 - 负责管理用于伪显隐功能的InstancedMesh覆盖层
+ * 通过在图框上方放置可缩放的平面网格来实现内容的显示/隐藏效果
+ * 支持图形和文字的统一遮罩
+ */
+export declare class CoverLayerManager {
+    private coverMesh?;
+    private coverGeometry?;
+    private coverMaterial?;
+    private viewer;
+    /**
+     * 构造覆盖层管理器
+     * @param viewer 3D查看器实例，用于触发渲染更新
+     */
+    constructor(viewer: BaseViewer);
+    /**
+     * 创建覆盖层 - 为每个图框创建对应的覆盖实例
+     * 使用InstancedMesh技术高效渲染多个覆盖平面
+     * @param outlineGroup 图框轮廓组，覆盖层将添加到此组中
+     * @param frames 图框列表，每个图框对应一个覆盖实例
+     */
+    createCoverLayer(outlineGroup: THREE.Group, frames: InternalFrame[]): void;
+    /**
+     * 设置指定覆盖层实例的可见性
+     * 通过调整变换矩阵的缩放值来实现显示/隐藏效果
+     * @param frames 图框列表
+     * @param instanceIndex 实例索引
+     * @param visible true=显示覆盖层(隐藏内容), false=隐藏覆盖层(显示内容)
+     */
+    setCoverVisible(frames: InternalFrame[], instanceIndex: number, visible: boolean): void;
+    /**
+     * 清理覆盖层资源
+     * 释放几何体和材质内存，防止内存泄漏
+     */
+    clearResources(): void;
+    /**
+     * 获取覆盖层网格实例
+     * @returns InstancedMesh实例或undefined
+     */
+    getCoverMesh(): THREE.InstancedMesh | undefined;
+}