@realsee/dnalogel 3.81.21 → 3.81.22

package/CHANGELOG.md

@@ -1,4 +1,27 @@
+## 3.81.22
+
+- 发布独立空间测量 V2 和全景测量 V2，新增边缘吸附及选点可视化；原入口保持兼容。
+- 修复 V2 Mixed 公开删除后再次保存恢复线段、Shift 切换后立即确认使用旧吸附位置。
+- 保留主干标尺可见性及遮挡修复。
+
 # CHANGELOG
+## 未发布（MeasurePluginV2）
+
+- 全景 V2 的 Edit/Mixed 清空均重置工作上下文；加载数据先结束旧会话，避免待保存线段混入导入结果。
+- 空间 V2 结束测量时释放临时 Shift 状态；固定准心按屏幕中心计算吸附，开关吸附立即刷新选点。
+- V2 默认触摸配置使用固定准心、可添加点的移动控件和小尺寸放大镜；两个 V2 示例提供手机底部操作面板与吸附开关。
+- 修复全景 V2 中心点测量清空后保存恢复旧线段的问题；清空同时丢弃未完成起点，并保持测量工具开启。
+- 修复 Mixed/Watch 模式按住 Shift 无法暂停吸附的问题；松开恢复吸附，失焦或销毁时释放修饰键状态与监听。
+- 修复全景 V2 测量中的动态预览线：保持前景可见，并同步最后一次选点位置。
+- 新增独立 `PanoMeasurePluginV2`，桌面编辑、移动端中心点测量、已有端点拖动复用空间测量 V2 的选点、模型边缘吸附、锁定评分与坐标轴/平面框提示。
+- 原 `PanoMeasurePlugin` 的默认组件、公开接口和 JSON 格式保持不变；V2 继续使用原模型、事件与 load/save/toJson，补充新旧数据互读和模式切换测试。
+- 原版与 V2 全景测量提供两个独立示例；V2 支持撤销、保存和中心点测量验收。
+
+- 新增独立 `MeasurePluginV2`：模型边缘吸附、锁定评分、放大镜坐标轴和平面框、场景光标仅在 V2 生效；原 `MeasurePlugin` 配置及选点行为保持不变。
+- V2 默认开启边缘吸附，可通过 `edgeSnap: false` 或 `setEdgeSnapEnabled(false)` 关闭。
+- 修复约束平面负侧边线被错误接受、候选集合为空时提前丢失锁定边的问题。
+- 虚拟点和无法线点隐藏场景表面提示，返回真实表面后恢复；移除覆盖绿色端点的蓝色 CSS 球。
+- 原版与 V2 使用独立示例入口，并补充原版兼容性和 V2 回归测试。
 
 ## 3.81.21
 

package/dist/MeasurePlugin/Controller.d.ts

@@ -35,6 +35,7 @@ export declare class MeasureController extends Subscribe<MeasurePluginEventMap>
     private publishInteraction;
     get pointSelector(): PointSelector;
     private _pointSelector;
+    protected createPointSelector(): PointSelector;
     private get fiveDomEvents();
     private _fiveDomEvents;
     private get cursor();

package/dist/MeasurePluginV2/Controller.d.ts

@@ -0,0 +1,49 @@
+import type { Five } from '@realsee/five';
+import { MeasurePointSelector } from './PointSelector';
+import { MeasureController } from '../MeasurePlugin/Controller';
+import type { MeasurePluginConfig } from '../MeasurePlugin';
+import { MeasureMagnifier } from './Magnifier';
+import { type EdgeSnapOptions } from './edgeSnap';
+/**
+ * 量尺插件 V2：把放大镜和场景里的小光标换成带「红 / 绿 / 蓝坐标轴 + 红色截面框」的版本。
+ *
+ * 复用 MeasureController 的测量流程，通过工厂创建独立的 V2 选点器，并替换两个渲染组件：
+ * - pointSelectorHelper.magnifier → MeasureMagnifier（多画一层叠加层）
+ * - pointSelectorHelper.pointHelper → MeasurePointHelperV2（同样的红 / 绿 / 蓝 + 截面框）
+ *
+ * 两个替换件都沿用原实例的全部参数（宽高、缩放、autoFixPCPosition、dragEnabled、挂载容器），
+ * 所以放大镜出现的位置、跟随方式、是否吃鼠标事件都和原插件一致，不会挡住在原本能选中的点位。
+ */
+/** V2 配置：在原 MeasurePlugin 配置上增加模型边缘吸附 */
+export type MeasurePluginV2Config = MeasurePluginConfig & {
+    /**
+     * @description 模型边缘吸附（试验能力）：落点靠近模型边线时自动吸到边上。
+     * 传 `false` 可关闭；不传默认开启。
+     */
+    edgeSnap?: boolean | EdgeSnapOptions;
+};
+export declare class MeasureControllerV2 extends MeasureController {
+    /** 最近一次查询到的候选边数量，示例页 / 调试用 */
+    lastEdgeSnapEdgeCount: number;
+    private v2Five;
+    private v2Magnifier?;
+    private v2Attached;
+    private readonly edgeSnapOptions;
+    private readonly edgeSnapCache;
+    constructor(five: Five, config?: MeasurePluginV2Config);
+    get edgeSnapEnabled(): boolean;
+    /** 运行时开关模型边缘吸附（不需要重开测量） */
+    setEdgeSnapEnabled(enabled: boolean): void;
+    /** V2 的放大镜实例；需要临时关掉叠加层做对比时，可以 magnifier.setOverlayEnabled(false) */
+    get magnifier(): MeasureMagnifier;
+    protected createPointSelector(): MeasurePointSelector;
+    get pointSelector(): MeasurePointSelector;
+    private attachOverlayRenderers;
+    private attachMagnifier;
+    private attachPointHelper;
+    /**
+     * 模型边缘吸附：每次选点器计算吸附前，按当前落点取附近的模型边界线。
+     * 真正的吸附判断（3D 距离 / 屏幕距离）仍在 PointSelector 里，这里只负责供线。
+     */
+    private attachEdgeSnap;
+}

package/dist/MeasurePluginV2/Magnifier.d.ts

@@ -0,0 +1,36 @@
+import type { Five } from '@realsee/five';
+import { Magnifier, type MagnifierParameter, type PointIntersection } from '../shared-utils';
+export interface MeasureMagnifierOptions extends MagnifierParameter {
+    /** 是否绘制坐标轴 / 平面框叠加层，默认 true（关掉后行为与现状 Magnifier 完全一致） */
+    overlayEnabled?: boolean;
+}
+/**
+ * 量尺 V2 用的放大镜。
+ *
+ * 完全复用 Magnifier 的「读像素 + 放大」逻辑（直接 super.render()），
+ * 只是在其之后往同一个 2D canvas 上叠加坐标轴与落点平面框。
+ */
+export declare class MeasureMagnifier extends Magnifier {
+    /** 父类把 five 存成了 private，这里自己留一份，叠加层投影时要用 */
+    private overlayFive;
+    /** 父类把 context 存成了 private；getContext('2d') 拿到的是同一个实例 */
+    private overlayContext;
+    /** 由 PointSelector 的 intersectionUpdate 事件注入 */
+    private overlayIntersection;
+    private overlayEnabled;
+    constructor(five: Five, options?: MeasureMagnifierOptions);
+    /** 每次交点更新时调用；传 null 表示当前没有命中任何模型 */
+    setIntersection(intersection: PointIntersection | null): void;
+    /** 开关叠加层，用于灰度 / 排查问题 */
+    setOverlayEnabled(enabled: boolean): void;
+    render(): void;
+    private renderOverlay;
+    private getOverlayContext;
+    /**
+     * 还原 Magnifier.render() 内部的取值，用来把世界坐标映射到放大镜 canvas 坐标。
+     * 这些换算必须和父类保持一致，父类改动时需要同步。
+     */
+    private getOverlayViewport;
+    /** 父类的 scale 是 private，只能这样读；它是真值来源，避免自己再维护一份副本 */
+    private getMagnifierScale;
+}

package/dist/MeasurePluginV2/PointHelper.d.ts

@@ -0,0 +1,22 @@
+import type { Five } from '@realsee/five';
+import type { Intersection } from '../typings/typings';
+import { PointHelper2 } from '../shared-utils/three/PointSelector/utils/PointHelper2';
+/**
+ * 场景里的小光标（选点处那团白圈 + 法线管）的 V2 版本。
+ *
+ * 完全继承 PointHelper2，只做两件事：
+ * 1. 把那根浅蓝色的法线管换成绿色（PRD 里绿色 = Z 轴）；
+ * 2. 按和放大镜同一套平面坐标系（buildPlaneFrame）补上红色 X、蓝色 Y 和红色截面框。
+ *
+ * 选点算法（射线、吸附、打点）全都在 PointSelector 里，这里只负责画，不参与任何选点判断。
+ */
+export declare class MeasurePointHelperV2 extends PointHelper2 {
+    /** 只放 V2 新增的红 / 蓝轴和截面框，拿不到法线时整体隐藏 */
+    private readonly overlayGroup;
+    constructor(five: Five);
+    updateWithIntersect(intersect: Intersection): void;
+    /** 不挂载 cssBallMesh，避免蓝色小球盖住绿色 Z 轴端点 */
+    show(): void;
+    hide(): void;
+    private paintAxisMesh;
+}

package/dist/MeasurePluginV2/PointOverlay.d.ts

@@ -0,0 +1,88 @@
+import * as THREE from 'three';
+import type { PointIntersection } from '../shared-utils';
+/**
+ * 放大镜内的叠加绘制：坐标轴（PRD M1）+ 落点平面框（PRD M2）
+ *
+ * 为什么画在 2D canvas 上而不是往场景里加 THREE 物体：
+ * 放大镜并不是「再渲染一遍场景」，而是用 five.getPixels() 读一小块像素，翻转后 putImageData 到 2D canvas 上。
+ * 所以场景里加什么物体都不会出现在放大镜里，只有 putImageData 之后在 2D context 上画的才会出现。
+ */
+/** PRD 五、视觉与设计规范 */
+export declare const OVERLAY_STYLE: {
+    /** M1-2 X 轴颜色 */
+    readonly axisXColor: "#EC4A4E";
+    /** M1-2 Y 轴颜色 */
+    readonly axisYColor: "#1677FF";
+    /** M1-2 Z 轴颜色 */
+    readonly axisZColor: "#065C08";
+    /** M1-5 线条宽度 */
+    readonly axisLineWidth: 1.5;
+    /** 轴线不透明度 */
+    readonly axisOpacity: 0.9;
+    /** M1-4 轴线长度 = 放大镜半径 × 0.9 */
+    readonly axisLengthRadiusScale: 0.9;
+    /** Z 轴端点（朝外的一端）绿色圆点半径 = 放大镜半径 × 该系数 */
+    readonly axisTipDotRadiusScale: 0.03;
+    /** M2 平面框边框颜色 */
+    readonly planeBorderColor: "#FF4D4F";
+    /** M2-3 边框宽度 */
+    readonly planeBorderWidth: 1.5;
+    /** M2-3 边框不透明度 */
+    readonly planeBorderOpacity: 0.9;
+    /** M2-2 轴对齐面框边长 = 放大镜半径 × 1.2 */
+    readonly planeSideRadiusScale: 1.2;
+    /** M2 轴对齐判定：表面法线与最近世界轴的夹角小于该值即视为墙 / 地 / 顶 */
+    readonly axisSnapAngle: 15;
+};
+/**
+ * 放大镜把渲染目标上的一块矩形区域拉伸到了 canvas 上，这里描述这块区域以及映射关系。
+ * 字段取值与 Magnifier.render() 内部完全一致，父类改动时需要同步。
+ */
+export interface MagnifierViewport {
+    camera: THREE.Camera;
+    /** 渲染目标尺寸，与 Magnifier.render() 里 getSize() 的结果一致 */
+    renderSize: THREE.Vector2;
+    /** 读取区域左边缘在渲染目标像素坐标系中的横坐标 */
+    readLeft: number;
+    /** 读取区域下边缘的纵坐标（渲染目标像素坐标系 y 轴向上，与 Magnifier.render() 里的同名量一致） */
+    readTop: number;
+    /** 读取区域的高度（渲染目标像素） */
+    readPixelsHeight: number;
+    /** 一个渲染像素在放大镜 canvas 上重复的倍数 */
+    pixelRadio: number;
+    /** 放大镜 canvas 的宽高（设备像素） */
+    canvasWidth: number;
+    canvasHeight: number;
+}
+/**
+ * 求交点的世界坐标系法线。
+ * 点云等拿不到 face 的情况返回 null（此时只画坐标轴，不画平面框）。
+ *
+ * 注意：这里不能再乘模型的法线矩阵。THREE.Mesh.raycast 在生成相交结果时已经把面法线
+ * 用 normalMatrix 变换到世界坐标系了；PointSelector 吸附到平面时合成的 Face3 更是直接写入
+ * 世界坐标系的平面法线。再乘一次会让法线偏离真实表面法线，红色平面框也就不再贴合选点所在面。
+ */
+export declare function getWorldNormal(intersection: PointIntersection): THREE.Vector3 | null;
+export interface PlaneFrame {
+    /** 平面法线，也就是绿色 Z 轴的方向（朝表面外侧） */
+    normal: THREE.Vector3;
+    /** 平面内的水平方向 = 红色 X 轴 */
+    xAxis: THREE.Vector3;
+    /** 平面内最接近竖直的方向 = 蓝色 Y 轴 */
+    yAxis: THREE.Vector3;
+    /** 轴对齐面吸附到的世界轴下标（0=X / 1=Y / 2=Z），斜面为 -1 */
+    alignedAxisIndex: number;
+}
+/**
+ * 由表面法线构造落点所在平面的坐标系。
+ * 绿色 Z 轴 = 法线；蓝色 Y 轴取平面内最接近「世界向上」的方向；红色 X 轴 = 剩下的那条平面内方向。
+ * 平面接近水平（地板 / 天花板）时平面内没有竖直方向，退化为用世界 Z 当蓝色轴。
+ *
+ * 放大镜里的叠加层和场景里的小光标共用这一份坐标系，保证两处看到的红 / 绿 / 蓝完全一致。
+ */
+export declare function buildPlaneFrame(normal: THREE.Vector3): PlaneFrame;
+/**
+ * 绘制落点叠加层。
+ * 调用时机：Magnifier.render() 里 putImageData 之后。
+ */
+export declare function drawMeasureOverlay(context: CanvasRenderingContext2D, viewport: MagnifierViewport, intersection: PointIntersection): void;

package/dist/MeasurePluginV2/PointSelector.d.ts

@@ -0,0 +1,55 @@
+import * as THREE from 'three';
+import { PointSelector, type PointIntersection } from '../shared-utils/three/PointSelector';
+/** V2 snapping only. The original PointSelector keeps its existing algorithm. */
+export declare class MeasurePointSelector extends PointSelector {
+    /**
+     * @description 动态吸附线提供器：每次选点更新、吸附计算前调用，返回本次参与吸附的线段，不会写回 adhereLine。
+     * 适合按光标位置实时从模型提取的边线。返回的线按有限线段处理（clampToLine），
+     * 与 adhereLine 里的无限轴线（如量尺的 XYZ 轴）区分开。
+     */
+    adhereLineProvider: ((params: {
+        intersection: PointIntersection;
+        pointSelector: PointSelector;
+    }) => THREE.Line3[]) | null;
+    /**
+     * @description 动态吸附线的屏幕吸附半径（像素）
+     * 动态线按「光标到线段投影的屏幕距离」取最近的一条，而不是按 3D 距离排序后让远边覆盖近边
+     */
+    dynamicAdhereScreenRadius: number;
+    /**
+     * @description 已吸附后保持吸附的屏幕半径（像素），略大于进入半径，避免在阈值边界来回跳动
+     */
+    dynamicAdhereKeepScreenRadius: number;
+    /**
+     * @description 动态吸附线允许的最大 3D 距离（米），用于排除画面深处或明显不在落点附近的边
+     */
+    dynamicAdhereMaxDistance: number;
+    /**
+     * 上一次吸住的动态线。候选线集合会随查询球心移动而变化，
+     * 把吸住的边单独留住，光标在保持半径内时优先继续用它，避免在相邻边之间来回跳。
+     */
+    private dynamicAdhereLine;
+    protected get mouseNdcPosition(): {
+        x: number;
+        y: number;
+    };
+    refresh(): void;
+    private readonly onFocusLost;
+    enable(): void;
+    disable(): void;
+    clearDynamicAdhereLine(): void;
+    protected updatePointSelectorHelperIntersect: (intersect?: PointIntersection | null) => void;
+    /**
+     * @description 计算一条静态吸附线的吸附结果（3D 距离优先，其次屏幕距离）
+     */
+    private getLineAdhereResult;
+    /**
+     * @description 在动态吸附线（模型边）中选出屏幕上离光标最近的一条。
+     *
+     * 三个要点：
+     * 1. 用射线与线段的最近点求落点，避免透视投影下屏幕比例回推 3D 点造成的偏差；
+     * 2. 光标贴着已吸住的边时直接锁定，不让相邻边参与评分，消除来回跳；
+     * 3. 需要换边时按「屏幕距离 + 深度惩罚」择优，避免吸到屏幕上重叠、但实际更远的边。
+     */
+    private getBestDynamicAdhereResult;
+}

package/dist/MeasurePluginV2/edgeSnap.d.ts

@@ -0,0 +1,53 @@
+import * as THREE from 'three';
+/**
+ * 模型边缘吸附（试验能力）。
+ *
+ * 选点器本身已经支持吸附到 `THREE.Line3`，five 的 Model 也提供了 `getEdgesBySphere()`，
+ * 这里只做两件事：
+ * 1. 把光标附近的模型边界线取出来、按离落点的距离排序并限量；
+ * 2. 缓存查询结果，避免每次 mousemove 都重走一遍 BVH。
+ *
+ * 取出来的线交给 `PointSelector.adhereLineProvider`，由选点器完成真正的吸附。
+ */
+export interface EdgeSnapOptions {
+    /** 是否启用，默认 true */
+    enabled?: boolean;
+    /** 查询球半径（米），只在这个范围内找模型边线，默认 0.3 */
+    radius?: number;
+    /** 面片夹角阈值（度），越小越只保留硬边，默认 30 */
+    threshold?: number;
+    /** 单次最多参与吸附的边数，默认 240 */
+    maxEdges?: number;
+    /** 光标移动超过该距离（米）才重新查询，默认 0.12 */
+    cacheStep?: number;
+}
+export interface ResolvedEdgeSnapOptions extends Required<EdgeSnapOptions> {
+}
+export declare const DEFAULT_EDGE_SNAP_OPTIONS: ResolvedEdgeSnapOptions;
+export declare function resolveEdgeSnapOptions(options?: boolean | EdgeSnapOptions): ResolvedEdgeSnapOptions;
+/** 只依赖 getEdgesBySphere，避免把 dnalogel 绑死在某个 five 版本上 */
+type EdgeSource = {
+    getEdgesBySphere?: (sphere: THREE.Sphere, threshold?: number) => THREE.Line3[];
+};
+/**
+ * 取落点附近的模型边界线，按离落点从近到远排序，最多 maxEdges 条。
+ * five 的 getEdgesBySphere 返回的是世界坐标线段，可以直接交给 PointSelector。
+ *
+ * 注意：getEdgesBySphere 是按「三角形与球相交」筛选的，大三角形的边可能落在球外很远，
+ * 所以这里再按「点到线段」的真实距离过滤一次，避免把远处的边也当成候选。
+ */
+export declare function collectNearbyEdges(model: EdgeSource | null | undefined, point: THREE.Vector3, options: ResolvedEdgeSnapOptions): THREE.Line3[];
+/**
+ * `getEdgesBySphere` 每次都要遍历可见瓦片、合几何、重建邻接关系，开销不低；
+ * 光标在 cacheStep 范围内移动时复用上一次结果，足够贴近“附近有哪些边”的事实。
+ */
+export declare class EdgeSnapCache {
+    private center;
+    private edges;
+    private valid;
+    query(model: EdgeSource | null | undefined, point: THREE.Vector3, options: ResolvedEdgeSnapOptions): THREE.Line3[];
+    clear(): void;
+    /** 最近一次查询到的边数，调试 / 示例页展示用 */
+    get size(): number;
+}
+export {};

package/dist/MeasurePluginV2/index.d.ts

@@ -0,0 +1,28 @@
+import type { Five } from '@realsee/five';
+import { MeasureControllerV2 } from './Controller';
+/**
+ * 量尺插件 V2 —— 点位选择可视化（对应 PRD《量尺点位选择器优化》）
+ *
+ * 与 MeasurePlugin 的关系：V2 是试点 fork，完全继承 MeasurePlugin 的控制器，
+ * 新吸附算法、放大镜叠加层和场景光标仅在 V2 中生效，原插件继续使用原选点器。
+ *
+ * 使用方式（Console / 编辑器等接入方）：
+ * ```ts
+ * import { MeasureV2 } from '@realsee/dnalogel'
+ * const measure = MeasureV2.MeasurePluginV2(five, { unit: 'm' })
+ * ```
+ */
+export { MeasureControllerV2 } from './Controller';
+export type { MeasurePluginV2Config } from './Controller';
+export { MeasureMagnifier } from './Magnifier';
+export type { MeasureMagnifierOptions } from './Magnifier';
+export { drawMeasureOverlay, getWorldNormal, OVERLAY_STYLE } from './PointOverlay';
+export type { MagnifierViewport } from './PointOverlay';
+export { collectNearbyEdges, EdgeSnapCache, DEFAULT_EDGE_SNAP_OPTIONS } from './edgeSnap';
+export type { EdgeSnapOptions, ResolvedEdgeSnapOptions } from './edgeSnap';
+export { validatePolygon } from '../MeasurePlugin';
+export type { MeasureEndReason, MeasurePluginConfig, MeasurePluginEventMap } from '../MeasurePlugin';
+export type MeasureControllerV2Interface = InstanceType<typeof MeasureControllerV2>;
+export type MeasurePluginV2ParamsInterface = ConstructorParameters<typeof MeasureControllerV2>[1];
+export declare const MeasurePluginV2: (five: Five, config?: MeasurePluginV2ParamsInterface) => MeasureControllerV2;
+export default MeasurePluginV2;

package/dist/PanoMeasurePlugin/Controller/EditController.d.ts

@@ -3,6 +3,7 @@ import BaseController from './BaseController';
 import type { ControllerParams } from './BaseController';
 import { Polyline } from '../Model/polyline';
 import Area from '../Model/area';
+import { PointSelector } from '../../shared-utils/three/PointSelector';
 export default class EditController extends BaseController {
     type: string;
     polyline: Polyline;
@@ -11,11 +12,13 @@ export default class EditController extends BaseController {
     private fiveElement?;
     /** 上一个端点位置 */
     private lastPoint;
-    private pointSelector;
+    protected pointSelector: PointSelector;
     private deleteDom;
     /** 根据 intersection 更新放大镜和吸附点 */
     private onIntersectionUpdate;
     constructor(params: ControllerParams);
+    protected createPointSelector(_params: ControllerParams): PointSelector;
+    protected disposeMagnifier(): void;
     dispose(): void;
     getEditingLines(): Line[];
     /** 撤销编辑 */
@@ -44,7 +47,7 @@ export default class EditController extends BaseController {
     /** 移动全景时更新 distanceItem 在屏幕上的位置 */
     private onCameraUpdate;
     /** 更新虚线 */
-    private updateDashed;
+    protected updateDashed: () => void;
     private wantsTapGesture;
     private chooseLine;
     private chooseArea;

package/dist/PanoMeasurePlugin/Controller/MixedController.d.ts

@@ -2,6 +2,7 @@ import type { ControllerParams } from './BaseController';
 import Line from '../Model/line';
 import BaseController from './BaseController';
 import { Polyline } from '../Model/polyline';
+import RangePieceController from '../Modules/rangePiece';
 export type State = 'watching' | 'editing';
 export default class MixedController extends BaseController {
     state: State;
@@ -11,9 +12,10 @@ export default class MixedController extends BaseController {
     private mobileNowPoint;
     private highlightedLines;
     private deleteDom;
-    private rangePieceController;
+    protected rangePieceController: RangePieceController;
     private disposers;
     constructor(params: ControllerParams);
+    protected createRangePieceController(params: ControllerParams): RangePieceController;
     dispose(): void;
     highlightLine(line: Line): void;
     clearHighlightLines(): void;

package/dist/PanoMeasurePlugin/Controller/WatchController.d.ts

@@ -1,5 +1,7 @@
 import type Line from '../Model/line';
+import type { Intersection } from '@realsee/five';
 import BaseController, { type ControllerParams } from './BaseController';
+import { Vector2 } from 'three';
 export default class WatchController extends BaseController {
     type: string;
     private deleteDom;
@@ -19,6 +21,8 @@ export default class WatchController extends BaseController {
     private unHighlightLines;
     private onPanStart;
     private onPanEnd;
+    protected onPointEditEnd(): void;
+    protected resolveIntersection(intersection: Intersection, _mouse: Vector2): Intersection;
     private onPan;
     private onIntersectionUpdate;
     private wantsPanGesture;

package/dist/PanoMeasurePlugin/Controller/index.d.ts

@@ -3,10 +3,12 @@ import type { EditParameter, MeasureType, OpenParameter, MeasurePluginData, Meas
 import type { PanoMeasurePluginEvent } from '../typings/event.type';
 import type { UserDistanceItem } from '../utils/dom/distanceItem';
 import type { Polyline } from '../Model/polyline';
+import type { ControllerParams } from './BaseController';
 import EditController from './EditController';
 import ViewController from './ViewController';
 import WatchController from './WatchController';
 import MixedController from './MixedController';
+import { Model } from '../Model';
 import type { Subscribe } from '../../shared-utils/Subscribe';
 import type { Five } from '@realsee/five';
 import { type UIControllerParams } from '../Modules/UIController';
@@ -26,6 +28,7 @@ export interface PanoMeasureParameterType extends Partial<Config> {
     useGuideController?: boolean | GuideControllerParams;
     userDistanceItemCreator?: () => UserDistanceItem;
 }
+export type ModeControllerConstructor = new (params: ControllerParams) => WatchController | EditController | MixedController | ViewController;
 export default class PanoMeasureController extends BasePlugin.Controller<BasePlugin.State, BasePlugin.EventMap<BasePlugin.State> & PanoMeasurePluginEvent> {
     state: BasePlugin.State;
     hasOpen: boolean;
@@ -37,7 +40,7 @@ export default class PanoMeasureController extends BasePlugin.Controller<BasePlu
     allowMeasureType: Array<MeasureType>;
     /** 当前的测量类型 */
     currentMeasureType: MeasureType | null;
-    private model;
+    protected model: Model;
     private group;
     private config;
     private isMobile;
@@ -47,6 +50,9 @@ export default class PanoMeasureController extends BasePlugin.Controller<BasePlu
     private container;
     private shortcutKeyController?;
     constructor(five: Five, params: PanoMeasureParameterType);
+    protected createMagnifier(five: Five, options: MagnifierParameter): Magnifier;
+    protected createModeController(params: ControllerParams, Controller: ModeControllerConstructor): WatchController | EditController | MixedController | ViewController;
+    protected resetUIController(): void;
     appendTo(parent: HTMLElement): void;
     clear(): void;
     dispose(): void;
@@ -111,5 +117,5 @@ export default class PanoMeasureController extends BasePlugin.Controller<BasePlu
     changeConfigs(config: Config): void;
     /** 设置线段的文本 */
     setCustomText(lineID: string, text: string): void;
-    private createControllerParams;
+    protected createControllerParams(): ControllerParams;
 }

package/dist/PanoMeasurePlugin/Modules/rangePiece/index.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five, Intersection, IntersectMeshInterface } from '@realsee/five';
 import type { Group } from 'three';
 import type { Model } from '../../Model';
 import type { PanoMeasurePluginEvent } from '../../typings/event.type';
@@ -22,21 +22,21 @@ export default class RangePieceController {
     private hook;
     private content;
     private intersectMesh;
-    private centerMouseXY;
+    protected centerMouseXY: any;
     private raycaster;
     private pieceStyl;
     constructor(params: RangePieceControllerParams);
     dispose(): void;
-    private onCameraDirectionUpdate;
+    protected onCameraDirectionUpdate: () => void;
     private onWillChangeState;
     /** 计算目标中心点经纬度 */
     private computedCenterMouseXY;
     /** 计算目标中心点intersection */
-    private getIntersection;
+    protected getIntersection(): Intersection;
     private pieceChange;
     private calculateSize;
     /** 点击按钮时圆片动画 */
     private dotAnimation;
     private changePieceStyl;
-    private updateMouseGroup;
+    protected updateMouseGroup(intersection: Intersection, mesh?: IntersectMeshInterface): Group;
 }

package/dist/PanoMeasurePluginV2/Controller.d.ts

@@ -0,0 +1,34 @@
+import type { Five } from '@realsee/five';
+import PanoMeasureController, { type ModeControllerConstructor, type PanoMeasureParameterType } from '../PanoMeasurePlugin/Controller';
+import EditController from '../PanoMeasurePlugin/Controller/EditController';
+import MixedController from '../PanoMeasurePlugin/Controller/MixedController';
+import WatchController from '../PanoMeasurePlugin/Controller/WatchController';
+import type { ControllerParams } from '../PanoMeasurePlugin/Controller/BaseController';
+import { PanoMagnifier } from './PointSelector';
+import { type EdgeSnapOptions } from '../MeasurePluginV2/edgeSnap';
+import type { MagnifierParameter } from '../shared-utils';
+export type PanoMeasurePluginV2Config = PanoMeasureParameterType & {
+    edgeSnap?: boolean | EdgeSnapOptions;
+};
+/** Reuses panorama modes, events, models and serialization; only V2 picking changes. */
+export declare class PanoMeasureControllerV2 extends PanoMeasureController {
+    private readonly edgeSnapOptions;
+    private mobileStyle?;
+    private readonly mixedSavedPolylineIDs;
+    private readonly magnifierOptions;
+    private magnifierReady;
+    constructor(five: Five, params?: PanoMeasurePluginV2Config);
+    get pointSelector(): import("./PointSelector").PanoPointSelector;
+    get lastEdgeSnapEdgeCount(): number;
+    get edgeSnapEnabled(): boolean;
+    setEdgeSnapEnabled(enabled: boolean): void;
+    clear(): void;
+    load(data: Parameters<PanoMeasureController['load']>[0]): void;
+    save(config?: Parameters<PanoMeasureController['save']>[0]): this;
+    removePolylineByID(id: string): void;
+    removePolyline(polyline: Parameters<PanoMeasureController['removePolyline']>[0]): void;
+    dispose(): void;
+    protected createControllerParams(): ControllerParams;
+    protected createMagnifier(five: Five, options: MagnifierParameter): PanoMagnifier;
+    protected createModeController(params: ControllerParams, Controller: ModeControllerConstructor): WatchController | EditController | MixedController | import("../PanoMeasurePlugin/Controller/ViewController").default;
+}

package/dist/PanoMeasurePluginV2/PointSelector.d.ts

@@ -0,0 +1,32 @@
+import type { Five } from '@realsee/five';
+import { MeasurePointSelector } from '../MeasurePluginV2/PointSelector';
+import { MeasureMagnifier } from '../MeasurePluginV2/Magnifier';
+import { type ResolvedEdgeSnapOptions } from '../MeasurePluginV2/edgeSnap';
+import type { PointIntersection, PointSelectorConfig } from '../shared-utils/three/PointSelector';
+/** The panorama entry uses the same snapping engine as spatial measurement V2. */
+declare class PanoMagnifier extends MeasureMagnifier {
+    appendTo(element: Element): this;
+}
+export { PanoMagnifier };
+export declare class PanoPointSelector extends MeasurePointSelector {
+    private readonly sharedMagnifier?;
+    private readonly refreshManualInput?;
+    private readonly edgeCache;
+    private suppliedNdc?;
+    private overlayMagnifier?;
+    lastEdgeSnapEdgeCount: number;
+    private readonly onModifiersChanged;
+    private readonly onWindowBlur;
+    constructor(five: Five, config: PointSelectorConfig, edgeOptions: ResolvedEdgeSnapOptions, sharedMagnifier?: MeasureMagnifier, refreshManualInput?: () => void);
+    protected get mouseNdcPosition(): {
+        x: number;
+        y: number;
+    };
+    /** Resolve fixed-center and endpoint-drag input without installing another pointer listener. */
+    resolveIntersection<T extends PointIntersection>(intersection: T | null, ndc: {
+        x: number;
+        y: number;
+    }): T & PointIntersection;
+    resetSnap(): void;
+    dispose(): void;
+}

package/dist/PanoMeasurePluginV2/controllers.d.ts

@@ -0,0 +1,42 @@
+import type { Intersection, IntersectMeshInterface } from '@realsee/five';
+import type { Vector2 } from 'three';
+import EditController from '../PanoMeasurePlugin/Controller/EditController';
+import MixedController from '../PanoMeasurePlugin/Controller/MixedController';
+import WatchController from '../PanoMeasurePlugin/Controller/WatchController';
+import RangePieceController from '../PanoMeasurePlugin/Modules/rangePiece';
+import type { ControllerParams } from '../PanoMeasurePlugin/Controller/BaseController';
+import type { ResolvedEdgeSnapOptions } from '../MeasurePluginV2/edgeSnap';
+import { PanoPointSelector } from './PointSelector';
+export interface PanoControllerParamsV2 extends ControllerParams {
+    edgeSnapOptions: ResolvedEdgeSnapOptions;
+}
+export declare class PanoEditControllerV2 extends EditController {
+    private readonly updateLivePreview;
+    constructor(params: PanoControllerParamsV2);
+    dispose(): void;
+    protected disposeMagnifier(): void;
+    get selector(): PanoPointSelector;
+    protected createPointSelector(params: ControllerParams): PanoPointSelector;
+}
+declare class PanoRangePieceV2 extends RangePieceController {
+    refresh(): void;
+    readonly selector: PanoPointSelector;
+    constructor(params: PanoControllerParamsV2);
+    protected getIntersection(): Intersection & import("../shared-utils").PointIntersection;
+    protected updateMouseGroup(intersection: Intersection, mesh?: IntersectMeshInterface): import("three").Group;
+    dispose(): void;
+}
+export declare class PanoMixedControllerV2 extends MixedController {
+    refreshPoint(): void;
+    constructor(params: PanoControllerParamsV2);
+    get selector(): PanoPointSelector;
+    protected createRangePieceController(params: ControllerParams): PanoRangePieceV2;
+}
+export declare class PanoWatchControllerV2 extends WatchController {
+    readonly selector: PanoPointSelector;
+    constructor(params: PanoControllerParamsV2);
+    protected resolveIntersection(intersection: Intersection, mouse: Vector2): Intersection;
+    protected onPointEditEnd(): void;
+    dispose(): void;
+}
+export {};

package/dist/PanoMeasurePluginV2/index.d.ts

@@ -0,0 +1,8 @@
+import type { Five } from '@realsee/five';
+import { PanoMeasureControllerV2, type PanoMeasurePluginV2Config } from './Controller';
+export { PanoMeasureControllerV2 };
+export type { PanoMeasurePluginV2Config };
+export type { MeasurePluginData as PanoMeasurePluginV2Data, MeasurePluginServerData as PanoMeasurePluginV2ServerData } from '../PanoMeasurePlugin/typings/data';
+export type PanoMeasurePluginV2Instance = PanoMeasureControllerV2;
+export declare const PanoMeasurePluginV2: (five: Five, params?: PanoMeasurePluginV2Config) => PanoMeasureControllerV2;
+export default PanoMeasurePluginV2;