@maqiuyao/dxf-viewer 0.2.0 → 0.2.1

package/dist/src/dxfViewer/core/viewers/BaseViewer.d.ts

@@ -2,7 +2,7 @@ import { CSS2DRenderer } from 'three/examples/jsm/renderers/CSS2DRenderer.js';
 import { ProgressBar, Spinner } from '../components';
 import { ViewerName } from './Constants';
 import { Plugin } from './Plugin';
-import { ViewerEvent } from './ViewerEvent';
+import { ViewerEvent, MouseClickInfo } from './ViewerEvent';
 import { BaseViewerConfig, CameraConfig, CameraProjection, ModelConfig, Viewpoint } from '../../core/Configs';
 import { CameraManager } from '../../core/camera';
 import { CanvasRender } from '../../core/canvas';
@@ -18,7 +18,7 @@ import { UndoManager } from '../../core/undo';
 import { Event } from '../../core/utils';
 import * as THREE from "three";
 type ViewerEvents = {
-    [K in ViewerEvent]: any;
+    [K in ViewerEvent]: K extends ViewerEvent.MouseClick ? MouseClickInfo : any;
 };
 /**
  * Abstract base class for Viewer2d, Viewer3d, etc.

package/dist/src/dxfViewer/core/viewers/Viewer2d.d.ts

@@ -171,9 +171,40 @@ export declare class Viewer2d extends BaseViewer {
      */
     private loadingDxfCount;
     private textSearchHelper?;
+    /** 实体点击高亮的云线框叠加层 */
+    private clickHighlightList?;
+    /** 是否启用点击实体高亮，默认关闭 */
+    private _enableClickHighlight;
     constructor(viewerCfg: Viewer2dConfig);
     get camera(): THREE.OrthographicCamera;
     private setupDefaultEvents;
+    /**
+     * 从拾取命中结果反查所属 DXF 实体的 userData 与对应 batch。
+     * 合并(deepMerge)后一个几何对象含多个 batch，每个 batch.userData 保存原实体元数据；
+     * 依据命中的索引/面游标定位 batch。返回的 batch 用于计算该实体的世界包围盒以高亮。
+     */
+    private resolveEntityFromPick;
+    /**
+     * 计算命中实体（batch 或整个对象）的世界包围盒。
+     */
+    private getEntityBoundingBox;
+    /**
+     * 用云线框高亮指定实体包围盒（替换上一个高亮）。
+     */
+    private highlightEntityBox;
+    /**
+     * Gets if click-to-highlight entity is enabled. Default is false.
+     */
+    get enableClickHighlight(): boolean;
+    /**
+     * Sets if click-to-highlight entity is enabled.
+     * When turned off, the current highlight (if any) is cleared.
+     */
+    set enableClickHighlight(enable: boolean);
+    /**
+     * 清除实体点击高亮。
+     */
+    clearClickHighlight(): void;
     protected handleMouseClick(e: EventInfo): void;
     private setDefaultBackground;
     /**

package/dist/src/dxfViewer/core/viewers/ViewerEvent.d.ts

@@ -1,3 +1,29 @@
+import { Object3D, Vector2, Vector3 } from 'three';
+import { EventInfo } from '../input-manager/InputManager';
+/**
+ * 实体点击事件（{@link ViewerEvent.MouseClick}）的载荷。
+ * 点击图纸实体时携带命中信息；点击空白处时 entity/object/point/userData/handle 为 undefined。
+ */
+export interface MouseClickInfo {
+    /** 原始输入事件信息 */
+    event: EventInfo;
+    /** 点击位置（查看器容器内像素坐标） */
+    position: Vector2;
+    /** 点击位置对应的世界坐标 */
+    worldPosition: Vector3;
+    /** @deprecated 兼容旧字段，等价于 worldPosition */
+    pooo: Vector3;
+    /** 命中的实体对象；点击空白处为 undefined */
+    entity?: Object3D;
+    /** 命中对象（与 entity 一致，仅当解析出实体时非空） */
+    object?: Object3D;
+    /** 命中点（世界坐标） */
+    point?: Vector3;
+    /** 命中实体的元数据（handle / dxfType / layerName / textContent 等） */
+    userData?: Record<string, any>;
+    /** 命中实体的 DXF handle */
+    handle?: string;
+}
 /**
  * Viewer events
  * TODO: dxf event and bim event

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maqiuyao/dxf-viewer",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "基于 three.js 的 DXF 图纸 2D/3D 查看与对比库（Viewer2d / DxfCompareHelper）",
   "type": "module",
   "main": "./dist/dxf-viewer.cjs",