@maqiuyao/dxf-viewer 0.1.0 → 0.2.1

package/dist/src/dxfViewer/core/helpers/TextSearchHelper.d.ts

@@ -0,0 +1,82 @@
+import { Viewer2d } from '../viewers/Viewer2d';
+import * as THREE from "three";
+/**
+ * 一条文本搜索结果。
+ */
+export interface TextSearchResult {
+    /** 实体句柄 */
+    handle: string;
+    /** 图层名 */
+    layer: string;
+    /** 所属布局名（Model / Layout1 ...） */
+    layoutName: string;
+    /** 文本内容（已去除 MTEXT 格式码） */
+    text: string;
+    /** 世界坐标包围盒 */
+    box: THREE.Box3;
+}
+/**
+ * 搜索模式：
+ * - exact：精准匹配，文本内容（去首尾空格后）与关键字完全相等才算命中（不区分大小写）；
+ * - fuzzy：模糊匹配，关键字作为连续子串出现即命中，还支持跳字子序列（如"铁院"命中"铁一院"）。
+ */
+export type TextSearchMode = "exact" | "fuzzy";
+/**
+ * 图纸文本搜索辅助类：在已加载的模型中检索文本实体（TEXT/MTEXT/ATTRIB），
+ * 支持定位（切换布局 + 缩放）与高亮（叠加层云线框）。
+ *
+ * @example
+ * ```typescript
+ * const helper = new TextSearchHelper(viewer);
+ * const results = helper.search("道岔");
+ * helper.focus(results[0]);
+ * helper.clearHighlight();
+ * ```
+ */
+export declare class TextSearchHelper {
+    private viewer;
+    private overlayRender?;
+    private drawableList?;
+    private indexedModelObject?;
+    private index;
+    constructor(viewer: Viewer2d);
+    private getMasterModel;
+    /**
+     * 遍历主模型场景图，收集所有带 userData.textContent 的文本对象。
+     */
+    private buildIndex;
+    /** 向上查找布局层对象名 */
+    private findLayoutName;
+    /**
+     * 按关键字搜索文本（不区分大小写）。
+     * - mode = "exact"（精准）：关键字作为连续子串出现即命中；
+     * - mode = "fuzzy"（模糊，默认）：在精准基础上还支持跳字子序列，例如"铁院"匹配"铁一院"。
+     * 结果按匹配度从高到低排序（完全相等 > 靠前子串 > 短跳字 > 长跳字）。
+     * @param keyword 搜索关键字
+     * @param options.mode 匹配模式，默认 "fuzzy"
+     * @param options.layer 限定图层名（不区分大小写，可选）
+     * @param options.maxResults 最大返回条数，默认 200
+     */
+    search(keyword: string, options?: {
+        mode?: TextSearchMode;
+        layer?: string;
+        maxResults?: number;
+    }): TextSearchResult[];
+    /**
+     * 定位到一条搜索结果：切换到其所在布局、缩放至包围盒，并在叠加层高亮。
+     */
+    focus(result: TextSearchResult): void;
+    /**
+     * 在叠加层用云线框高亮指定结果（替换上一个高亮）。
+     */
+    highlight(result: TextSearchResult): void;
+    /**
+     * 清除当前高亮。
+     */
+    clearHighlight(): void;
+    /**
+     * 模型重新加载后调用，强制重建索引。
+     */
+    invalidate(): void;
+    destroy(): void;
+}

package/dist/src/dxfViewer/core/helpers/index.d.ts

@@ -8,4 +8,5 @@ export * from './OSnapHelper';
 export * from './PickMarkupHelper';
 export * from './BoxSelectHelper';
 export * from './ZoomToRectHelper';
+export * from './TextSearchHelper';
 export * from './MobileTouchHelperDrawable';

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

@@ -5,6 +5,7 @@ import { Drawable } from '../../core/canvas';
 import { DxfLayer } from '../../core/dxf';
 import { EventInfo } from '../../core/input-manager/InputManager';
 import { Model2d } from '../../core/model';
+import { TextSearchMode, TextSearchResult } from '../../core/helpers/TextSearchHelper';
 import * as THREE from "three";
 export interface EntityData {
     modelId: string;
@@ -169,9 +170,41 @@ export declare class Viewer2d extends BaseViewer {
      * Used to indicate how many dxf is loading
      */
     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;
     /**
@@ -325,6 +358,34 @@ export declare class Viewer2d extends BaseViewer {
      * ```
      */
     getActiveLayoutName(): string | undefined;
+    /**
+     * @description {en} Searches text entities (TEXT/MTEXT/ATTRIB) in the loaded drawing.
+     * @description {zh} 在已加载的图纸中搜索文本实体（TEXT/MTEXT/ATTRIB）。
+     * @param keyword 搜索关键字（不区分大小写、子串匹配）
+     * @param options.layer 限定图层名（可选）
+     * @param options.maxResults 最大返回条数，默认 200
+     * @returns 匹配的文本结果列表
+     * @example
+     * ```typescript
+     * const results = viewer.searchText("道岔");
+     * results.length > 0 && viewer.focusText(results[0]);
+     * ```
+     */
+    searchText(keyword: string, options?: {
+        mode?: TextSearchMode;
+        layer?: string;
+        maxResults?: number;
+    }): TextSearchResult[];
+    /**
+     * @description {en} Zooms to a text search result and highlights it with a cloud border.
+     * @description {zh} 定位到一条文本搜索结果并高亮（云线框）。
+     */
+    focusText(result: TextSearchResult): void;
+    /**
+     * @description {en} Clears the highlight of text search results.
+     * @description {zh} 清除文本搜索结果的高亮。
+     */
+    clearTextHighlight(): void;
     zoomIn(step?: number): void;
     zoomOut(step?: number): void;
     /**

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.1.0",
+  "version": "0.2.1",
   "description": "基于 three.js 的 DXF 图纸 2D/3D 查看与对比库（Viewer2d / DxfCompareHelper）",
   "type": "module",
   "main": "./dist/dxf-viewer.cjs",