@maqiuyao/dxf-viewer 0.1.0 → 0.2.0

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/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,6 +170,7 @@ export declare class Viewer2d extends BaseViewer {
      * Used to indicate how many dxf is loading
      */
     private loadingDxfCount;
+    private textSearchHelper?;
     constructor(viewerCfg: Viewer2dConfig);
     get camera(): THREE.OrthographicCamera;
     private setupDefaultEvents;
@@ -325,6 +327,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/package.json

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