dxfview 0.0.4 → 0.0.5-beta

package/dist/types/core/canvas/SelectionBoxDrawable.d.ts

@@ -0,0 +1,27 @@
+import * as THREE from "three";
+import { Drawable } from "./Drawable";
+declare type SelectionBoxOptions = {
+    lineColor?: number[];
+    lineWidth?: number;
+    dashed?: boolean;
+    dashPattern?: number[];
+};
+/**
+ * Lightweight drawable for visualizing a world-space selection box.
+ * Kept independent from annotation classes to avoid editing/snap overhead.
+ */
+export declare class SelectionBoxDrawable extends Drawable {
+    private min;
+    private max;
+    private dashed;
+    private dashPattern;
+    constructor(id: string, min: THREE.Vector3, max: THREE.Vector3, options?: SelectionBoxOptions);
+    update(min: THREE.Vector3, max: THREE.Vector3): void;
+    getClassType(): string;
+    getVertexes(): THREE.Vector3[];
+    getBounds(): THREE.Box3;
+    isPointInPath(p: THREE.Vector3): boolean;
+    draw(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    drawSelect(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+}
+export {};

package/dist/types/core/dxf/DxfLoader.d.ts

@@ -215,7 +215,7 @@ export declare class DxfLoader extends THREE.Loader {
     private timer;
     private ignorePaperSpace;
     font?: FontManager;
-    private encoding;
+    encoding: string;
     private overrideColor?;
     private overrideHatchPatternLineThickness?;
     angBase: number | IPoint;

package/dist/types/core/dxf/DxfUtils.d.ts

@@ -21,6 +21,7 @@ export declare class DxfUtils {
      * While this takes some extra space, so, we'd like to add a flag here.
      */
     static merge(object: DxfObject, saveBatchInfo?: boolean): void;
+    private static attachBatchUserData;
     /**
      * Merges child objects of given object.
      * If objects' material are the same, they can be merged.

package/dist/types/core/dxf/dxfom-text.d.ts

@@ -10,7 +10,9 @@ export interface DxfTextContentElement {
 }
 export declare const decodeDxfTextCharacterCodes: (text: string, mbcsEncoding?: string | TextDecoder) => string;
 export declare const decodeDxfTextUnicodeCodePoints: (text: string) => string;
-export declare const decodeDxfTextMbcsCharacterCodes: (text: string, encoding: string | TextDecoder) => string;
+export declare const decodeDxfTextMifCharacterCode: (codePage: string, hexBytes: string, fallbackEncoding?: string | TextDecoder) => string | undefined;
+export declare const decodeDxfTextMbcsCharacterCodes: (text: string, encoding?: string | TextDecoder) => string;
+export declare const normalizeDxfTextSymbols: (text: string) => string;
 export declare const parseDxfTextContent: (text: string, options?: {
     readonly encoding?: string | TextDecoder;
 }) => DxfTextContentElement[];

package/dist/types/core/dxf-parser/ParseHelpers.d.ts

@@ -34,3 +34,4 @@ export declare function checkCommonEntityProperties(entity: IEntity, curr: IGrou
  * @param {*} curr - the current group being parsed
  */
 export declare function checkCommonObjectProperties(object: IObject, curr: IGroup): boolean;
+export declare function skipControlGroup(scanner: DxfBaseReader, curr: IGroup): IGroup;

package/dist/types/core/font/FontManager.d.ts

@@ -39,6 +39,8 @@ export declare class FontManager {
      * @returns 字符的几何形状
      */
     getCharShape(char: string, fontName: string, size: number): THREE.BufferGeometry<THREE.NormalBufferAttributes> | TextGeometry | undefined;
+    private findFont;
+    private static normalizeFontName;
     /**
      * 获取未找到文本的默认形状
      * @param size 字体大小

package/dist/types/core/geometry-offset/Offset.d.ts

@@ -32,11 +32,11 @@ export declare class Offset {
     /**
      * Decides by the sign if it's a padding or a margin
      */
-    offset(dist: number): Pair | Ring | Polygon | MultiPolygon;
+    offset(dist: number): MultiPolygon | Polygon | Ring | Pair;
     private offsetSegment;
     private margin;
     private padding;
-    offsetLine(dist: number): Pair | Ring | Polygon | MultiPolygon;
+    offsetLine(dist: number): MultiPolygon | Polygon | Ring | Pair;
     /**
      * Just offsets lines, no fill
      */

package/dist/types/core/helpers/OSnapHelper.d.ts

@@ -69,6 +69,10 @@ export declare enum OSnapType {
 interface OSnapInfo {
     point: THREE.Vector3;
     distance: number;
+    apertureDistance?: number;
+    screenDistance?: number;
+    sourceAnnotationId?: string;
+    ringPriority?: number;
     type: OSnapType;
     line?: ILine;
 }
@@ -79,6 +83,13 @@ export declare class OSnapHelper {
     protected activeOSnapType: OSnapType;
     protected snapToleranceInWorldCoord: number;
     protected intersectionLimit: number;
+    protected orthoModeEnabled: boolean;
+    protected endpointPriorityModeEnabled: boolean;
+    protected endpointPriorityBoost: number;
+    protected endpointPriorityPixelRadius: number;
+    private stickySnapPixelTolerance;
+    private stickySnapReleasePixelDistance;
+    private lastSnapInfo?;
     /**
      * OSnapType 的优先级，数值越小优先级越高。
      * 在多种捕捉结果出现时，依据优先级与距离选择最终的捕捉点。
@@ -105,6 +116,36 @@ export declare class OSnapHelper {
     getSnapTolerance(): number;
     setIntersectionLimit(val: number): void;
     getIntersectionLimit(): number;
+    /**
+     * 设置正交模式开关。
+     * 启用后，绘制的线条会被约束为水平或垂直方向。
+     * @param enabled 是否启用正交模式
+     */
+    setOrthoModeEnabled(enabled: boolean): void;
+    /**
+     * 获取正交模式是否启用。
+     */
+    isOrthoModeEnabled(): boolean;
+    /**
+     * 获取当前激活的捕捉类型。
+     * 用于判断是否应用正交约束（例如，垂足捕捉时不应用正交约束）。
+     */
+    getActiveOSnapType(): OSnapType;
+    /**
+     * 设置是否启用 CAD 式端点优先模式。
+     */
+    setEndpointPriorityModeEnabled(enabled: boolean): void;
+    /**
+     * 获取 CAD 式端点优先模式状态。
+     */
+    isEndpointPriorityModeEnabled(): boolean;
+    /**
+     * 应用正交约束：根据参考点将当前位置约束为水平或垂直方向（90° 的倍数：0°、90°、180°、270°）。
+     * @param currentPosition 当前鼠标位置（世界坐标）
+     * @param referencePosition 参考点位置（通常是上一个点击的位置）
+     * @returns 应用正交约束后的位置
+     */
+    applyOrthoConstraint(currentPosition: THREE.Vector3, referencePosition: THREE.Vector3): THREE.Vector3;
     /**
      * Gets osnap marker line color.
      * @returns rgb/rgba number array, each value is between 0 and 1. e.g. [0.92, 0.95, 0.96].
@@ -140,9 +181,10 @@ export declare class OSnapHelper {
      * @param intersections The raycaster intersections, must have been sorted by distance.
      * @param is3d If it is a 3d or 2d viewer.
      * @param lastMouseDownPosition Used in order to to get foot of perpendicular.
+     * @param mousePositionOverride Optional mouse world position (useful for 2d to avoid ray hit drift).
      * @returns Target snap point if any
      */
-    handleSnap(rayCasterResult: THREE.Intersection[], is3d: boolean, lastMouseDownPosition?: THREE.Vector3): THREE.Vector3 | undefined;
+    handleSnap(rayCasterResult: THREE.Intersection[], is3d: boolean, lastMouseDownPosition?: THREE.Vector3, mousePositionOverride?: THREE.Vector3, mouseScreenPositionOverride?: THREE.Vector2): THREE.Vector3 | undefined;
     /**
      * Tries to find a proper snap point and display corresponding marker.
      * @param mousePosition Mouse position in world coordinate.
@@ -151,12 +193,33 @@ export declare class OSnapHelper {
      * @param lastMouseDownPosition Used in order to to get foot of perpendicular.
      * @returns Target snap point if any
      */
-    protected getSnapPointAndUpdateMarker(mousePosition: THREE.Vector3, intersections: THREE.Intersection[], is3d: boolean, lastMouseDownPosition?: THREE.Vector3): THREE.Vector3 | undefined;
+    protected getSnapPointAndUpdateMarker(mousePosition: THREE.Vector3, intersections: THREE.Intersection[], is3d: boolean, lastMouseDownPosition?: THREE.Vector3, mouseScreenPosition?: THREE.Vector2): THREE.Vector3 | undefined;
     activateMarker(type: OSnapType, osnapInfo?: OSnapInfo): void;
     private getFootOfPerpendicular;
+    private getScreenDistance;
+    private isSameSnapCandidate;
+    private selectStickySnapCandidate;
+    private cloneSnapInfo;
+    /**
+     * CAD式捕捉排序：
+     * 1) 先按捕捉类型优先级；
+     * 2) 同一标注内的顶点捕捉优先外环（ringPriority更小）；
+     * 3) 再按屏幕像素距离（CAD孔径语义）；
+     * 4) 再按真实捕捉点距离（避免缩小时轻微移动导致跳点）；
+     * 5) 最后用孔径中心距离做稳定 tie-break。
+     */
+    private compareSnapInfo;
+    private applyEndpointPriority;
     private getSnapInfo;
     private getOsnapInfoListFromMesh;
     private getOsnapInfoFromSegment;
+    private getLineRingPriority;
+    private applyLineSnapMetadata;
+    /**
+     * 根据 intersection.index 获取具体线段并计算捕捉信息
+     * 这是解决捕捉漏掉/偏差问题的核心方法
+     */
+    private getOsnapInfoFromIntersectionIndex;
     private getOsnapInfoListFromLine;
     private getOsnapInfoListFromPoint;
     /**

package/dist/types/core/input/InputManager.d.ts

@@ -9,6 +9,7 @@ export interface IUIEvent {
 export interface IMouseEvent extends IUIEvent {
     readonly altKey: boolean;
     readonly ctrlKey: boolean;
+    readonly metaKey: boolean;
     readonly shiftKey: boolean;
     readonly button: number;
     readonly clientX: number;
@@ -32,6 +33,7 @@ export interface IWheelEvent extends IMouseEvent {
 export interface IKeyboardEvent extends IUIEvent {
     readonly altKey: boolean;
     readonly ctrlKey: boolean;
+    readonly metaKey: boolean;
     readonly shiftKey: boolean;
     readonly key: string;
     readonly code: string;

package/dist/types/core/license/PublicKey.d.ts

@@ -1 +1 @@
-export declare const DEFAULT_PUBLIC_KEY_HEX = "0xe93f27a3147a0e2f67b718dffbf7553981ec8d9bb8bf7d18a4ba1f491736ea78";
+export declare const DEFAULT_PUBLIC_KEY_HEX = "0xe98c5ce23e9da75c9169a670637a1ff68e373ddbf7e98cb85efdfb8a6106bf33";

package/dist/types/core/utils/DecimalPrecisionUtils.d.ts

@@ -2,3 +2,7 @@
  * @internal
  */
 export declare const showPrecisionValue: (value: number, precistionType: number) => string;
+/**
+ * @internal
+ */
+export declare const showPrecisionValueAnnotation: (value: number, precistionType: number) => string;

package/dist/types/core/utils/MergeUtils.d.ts

@@ -445,7 +445,7 @@ export declare class MergeUtils {
      *
      * @returns 是否可以合并 - true表示两个对象兼容，可以合并
      */
-    static areObjectsMergeable(o1: THREE.Object3D, o2: THREE.Object3D): any;
+    static areObjectsMergeable(o1: THREE.Object3D, o2: THREE.Object3D): boolean | undefined;
     /**
      * 检查网格是否为合并后的对象
      *

package/dist/types/core/utils/utf8OrGBK.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 判断是否为utf-8
+ */
+export declare function isUTF8(bytes: Uint8Array): boolean;