@realsee/dnalogel 4.0.0-webgpu.14 → 4.0.0-webgpu.16

package/dist/types/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/types/MeasurePluginV2/Controller.d.ts

@@ -0,0 +1,49 @@
+import { Five } from '@realsee/five-webgpu';
+import { MeasurePointSelector } from './PointSelector.js';
+import { MeasureController } from '../MeasurePlugin/Controller.js';
+import { MeasurePluginConfig } from '../MeasurePlugin/index.js';
+import { MeasureMagnifier } from './Magnifier.js';
+import { EdgeSnapOptions } from './edgeSnap.js';
+/**
+ * 量尺插件 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/types/MeasurePluginV2/Magnifier.d.ts

@@ -0,0 +1,29 @@
+import { Five } from '@realsee/five-webgpu';
+import { PointIntersection } from '../shared-utils/index.js';
+import { Magnifier, MagnifierParameter } from '../shared-utils/three/Magnifier.js';
+export interface MeasureMagnifierOptions extends MagnifierParameter {
+    /** 是否绘制坐标轴 / 平面框叠加层，默认 true（关掉后行为与现状 Magnifier 完全一致） */
+    overlayEnabled?: boolean;
+}
+/**
+ * 量尺 V2 用的放大镜。
+ *
+ * 完全复用 Magnifier 的「读像素 + 放大」逻辑，只在像素绘制完成后往同一个 2D canvas 上叠加坐标轴与落点平面框。
+ * 这里不重写 render()：V1 的 Magnifier 是异步读回像素的，用 afterRender 回调才能保证叠加层和当前这帧像素严格对应。
+ */
+export declare class MeasureMagnifier extends Magnifier {
+    /** 父类把 five 存成了 private，这里自己留一份 */
+    private readonly 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;
+    private renderOverlay;
+    private getOverlayContext;
+}

package/dist/types/MeasurePluginV2/PointHelper.d.ts

@@ -0,0 +1,22 @@
+import { Five } from '@realsee/five-webgpu';
+import { Intersection } from '../typings/typings.js';
+import { PointHelper2 } from '../shared-utils/three/PointSelector/utils/PointHelper2.js';
+/**
+ * 场景里的小光标（选点处那团白圈 + 法线管）的 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/types/MeasurePluginV2/PointOverlay.d.ts

@@ -0,0 +1,88 @@
+import { PointIntersection } from '../shared-utils/index.js';
+import * as THREE from 'three/webgpu';
+/**
+ * 放大镜内的叠加绘制：坐标轴（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/types/MeasurePluginV2/PointSelector.d.ts

@@ -0,0 +1,51 @@
+import { PointSelector, PointIntersection } from '../shared-utils/three/PointSelector/index.js';
+import * as THREE from 'three/webgpu';
+/** 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 在动态吸附线（模型边）中选出屏幕上离光标最近的一条。
+     *
+     * 三个要点：
+     * 1. 用射线与线段的最近点求落点，避免透视投影下屏幕比例回推 3D 点造成的偏差；
+     * 2. 光标贴着已吸住的边时直接锁定，不让相邻边参与评分，消除来回跳；
+     * 3. 需要换边时按「屏幕距离 + 深度惩罚」择优，避免吸到屏幕上重叠、但实际更远的边。
+     */
+    private getBestDynamicAdhereResult;
+}

package/dist/types/MeasurePluginV2/edgeSnap.d.ts

@@ -0,0 +1,53 @@
+import * as THREE from 'three/webgpu';
+/**
+ * 模型边缘吸附。
+ *
+ * 选点器本身已经支持吸附到 `THREE.Line3`，five 的 Model 也提供了 `getEdgesBySphere()`，
+ * 这里只做两件事：
+ * 1. 把光标附近的模型边界线取出来、按离落点的距离排序并限量；
+ * 2. 缓存查询结果，避免每次 mousemove 都重走一遍 BVH。
+ *
+ * 取出来的线交给 `PointSelector.adhereLineProvider`，由选点器完成真正的吸附。
+ */
+export interface EdgeSnapOptions {
+    /** 是否启用。V2 默认 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/types/MeasurePluginV2/index.d.ts

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

@@ -47,6 +47,7 @@ export default class BaseController {
     protected get currentMeasureType(): MeasureType;
     private getMeasureType;
     constructor(params: ControllerParams);
+    protected createPreviewLine(): Line;
     updateDistanceUI: () => void;
     updateAreaUI: () => void;
     protected removeLine(line: Line): void;

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

@@ -2,6 +2,7 @@ import { default as Line } from '../Model/line.js';
 import { default as BaseController, ControllerParams } from './BaseController.js';
 import { Polyline } from '../Model/polyline.js';
 import { default as Area } from '../Model/area.js';
+import { PointSelector } from '../../shared-utils/three/PointSelector/index.js';
 export default class EditController extends BaseController {
     type: string;
     polyline: Polyline;
@@ -10,11 +11,12 @@ 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;
     dispose(): void;
     getEditingLines(): Line[];
     /** 撤销编辑 */
@@ -43,7 +45,7 @@ export default class EditController extends BaseController {
     /** 移动全景时更新 distanceItem 在屏幕上的位置 */
     private onCameraUpdate;
     /** 更新虚线 */
-    private updateDashed;
+    protected updateDashed: () => void;
     private wantsTapGesture;
     private chooseLine;
     private chooseArea;

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

@@ -1,6 +1,7 @@
 import { ControllerParams, default as BaseController } from './BaseController.js';
 import { default as Line } from '../Model/line.js';
 import { Polyline } from '../Model/polyline.js';
+import { default as RangePieceController } from '../Modules/rangePiece/index.js';
 export type State = 'watching' | 'editing';
 export default class MixedController extends BaseController {
     state: State;
@@ -10,9 +11,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/types/PanoMeasurePlugin/Controller/WatchController.d.ts

@@ -1,5 +1,7 @@
 import { default as Line } from '../Model/line.js';
+import { Intersection } from '@realsee/five-webgpu';
 import { default as BaseController, ControllerParams } from './BaseController.js';
+import { Vector2 } from 'three/webgpu';
 export default class WatchController extends BaseController {
     type: string;
     private deleteDom;
@@ -20,6 +22,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/types/PanoMeasurePlugin/Controller/index.d.ts

@@ -3,14 +3,16 @@ import { EditParameter, MeasureType, OpenParameter, MeasurePluginData, MeasurePl
 import { PanoMeasurePluginEvent } from '../typings/event.type.js';
 import { UserDistanceItem } from '../utils/dom/distanceItem.js';
 import { Polyline } from '../Model/polyline.js';
+import { ControllerParams } from './BaseController.js';
 import { default as EditController } from './EditController.js';
 import { default as ViewController } from './ViewController.js';
 import { default as WatchController } from './WatchController.js';
 import { default as MixedController } from './MixedController.js';
+import { Model } from '../Model/index.js';
 import { Five } from '@realsee/five-webgpu';
 import { UIControllerParams } from '../Modules/UIController/index.js';
 import { GuideControllerParams } from '../Modules/GuideController.js';
-import { Magnifier } from '../../shared-utils/index.js';
+import { Magnifier, MagnifierParameter } from '../../shared-utils/index.js';
 import { default as Area } from '../Model/area.js';
 import { PointSelectorConfig } from '../../shared-utils/three/PointSelector/index.js';
 import * as BasePlugin from '../../base/BasePlugin.js';
@@ -23,6 +25,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;
@@ -32,7 +35,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;
@@ -42,6 +45,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): MixedController | EditController | ViewController | WatchController;
+    protected resetUIController(): void;
     appendTo(parent: HTMLElement): void;
     clear(): void;
     dispose(): void;
@@ -100,5 +106,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/types/PanoMeasurePlugin/Modules/rangePiece/index.d.ts

@@ -1,4 +1,4 @@
-import { Five } from '@realsee/five-webgpu';
+import { Five, Intersection, IntersectMeshInterface } from '@realsee/five-webgpu';
 import { Group } from 'three/webgpu';
 import { Model } from '../../Model/index.js';
 import { PanoMeasurePluginEvent } from '../../typings/event.type.js';
@@ -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<import('three').Object3DEventMap>;
 }

package/dist/types/PanoMeasurePluginV2/Controller.d.ts

@@ -0,0 +1,32 @@
+import { Five } from '@realsee/five-webgpu';
+import { default as PanoMeasureController, ModeControllerConstructor, PanoMeasureParameterType } from '../PanoMeasurePlugin/Controller/index.js';
+import { default as EditController } from '../PanoMeasurePlugin/Controller/EditController.js';
+import { default as MixedController } from '../PanoMeasurePlugin/Controller/MixedController.js';
+import { default as WatchController } from '../PanoMeasurePlugin/Controller/WatchController.js';
+import { ControllerParams } from '../PanoMeasurePlugin/Controller/BaseController.js';
+import { PanoMagnifier } from './PointSelector.js';
+import { EdgeSnapOptions } from '../MeasurePluginV2/edgeSnap.js';
+import { MagnifierParameter } from '../shared-utils/index.js';
+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;
+    constructor(five: Five, params?: PanoMeasurePluginV2Config);
+    get pointSelector(): import('./PointSelector.js').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): MixedController | EditController | import('../PanoMeasurePlugin/Controller/ViewController.js').default | WatchController;
+}

package/dist/types/PanoMeasurePluginV2/PointSelector.d.ts

@@ -0,0 +1,32 @@
+import { Five } from '@realsee/five-webgpu';
+import { MeasurePointSelector } from '../MeasurePluginV2/PointSelector.js';
+import { MeasureMagnifier } from '../MeasurePluginV2/Magnifier.js';
+import { ResolvedEdgeSnapOptions } from '../MeasurePluginV2/edgeSnap.js';
+import { PointIntersection, PointSelectorConfig } from '../shared-utils/three/PointSelector/index.js';
+/** 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/types/PanoMeasurePluginV2/PreviewLine.d.ts

@@ -0,0 +1,6 @@
+import { Vector3 } from 'three/webgpu';
+import { default as Line } from '../PanoMeasurePlugin/Model/line.js';
+/** WebGPU caches attribute bindings. Keep the preview buffers alive while endpoints move. */
+export declare class PanoPreviewLine extends Line {
+    setPoints(start: Vector3, end: Vector3): void;
+}

package/dist/types/PanoMeasurePluginV2/controllers.d.ts

@@ -0,0 +1,44 @@
+import { Intersection, IntersectMeshInterface } from '@realsee/five-webgpu';
+import { Vector2 } from 'three/webgpu';
+import { default as EditController } from '../PanoMeasurePlugin/Controller/EditController.js';
+import { default as MixedController } from '../PanoMeasurePlugin/Controller/MixedController.js';
+import { default as WatchController } from '../PanoMeasurePlugin/Controller/WatchController.js';
+import { PanoPreviewLine } from './PreviewLine.js';
+import { default as RangePieceController } from '../PanoMeasurePlugin/Modules/rangePiece/index.js';
+import { ControllerParams } from '../PanoMeasurePlugin/Controller/BaseController.js';
+import { ResolvedEdgeSnapOptions } from '../MeasurePluginV2/edgeSnap.js';
+import { PanoPointSelector } from './PointSelector.js';
+export interface PanoControllerParamsV2 extends ControllerParams {
+    edgeSnapOptions: ResolvedEdgeSnapOptions;
+}
+export declare class PanoEditControllerV2 extends EditController {
+    protected createPreviewLine(): PanoPreviewLine;
+    private readonly updateLivePreview;
+    constructor(params: PanoControllerParamsV2);
+    dispose(): 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/index.js').PointIntersection;
+    protected updateMouseGroup(intersection: Intersection, mesh?: IntersectMeshInterface): import('three').Group<import('three').Object3DEventMap>;
+    dispose(): void;
+}
+export declare class PanoMixedControllerV2 extends MixedController {
+    refreshPoint(): void;
+    protected createPreviewLine(): PanoPreviewLine;
+    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/types/PanoMeasurePluginV2/index.d.ts

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

package/dist/types/public/index.d.ts

@@ -91,3 +91,7 @@ export { PaintBrush } from './components.js';
 export { ModelFloorplanPlugin, MapviewFloorplanPlugin, TopviewFloorplanPlugin, PanoFloorplanRadarPlugin, FloorplanGuidePlugin } from './floorplan.js';
 import * as Util from '../shared-utils/index.js';
 export { Util };
+export { MeasurePluginV2 } from './plugins/measure-v2.js';
+export type { MeasurePluginV2Instance, MeasurePluginV2Config } from './plugins/measure-v2.js';
+export { PanoMeasurePluginV2 } from './plugins/pano-measure-v2.js';
+export type { PanoMeasurePluginV2Config, PanoMeasurePluginV2Instance } from './plugins/pano-measure-v2.js';

package/dist/types/public/plugins/measure-v2.d.ts

@@ -0,0 +1,5 @@
+import { MeasurePluginV2 } from '../../MeasurePluginV2/index.js';
+export { MeasurePluginV2, MeasureControllerV2, MeasureMagnifier, DEFAULT_EDGE_SNAP_OPTIONS, collectNearbyEdges, EdgeSnapCache } from '../../MeasurePluginV2/index.js';
+export type { MeasurePluginV2Config, MeasureControllerV2Interface, MeasurePluginV2ParamsInterface, MeasureMagnifierOptions, EdgeSnapOptions, ResolvedEdgeSnapOptions } from '../../MeasurePluginV2/index.js';
+export type { MeasureEndReason, MeasurePluginEventMap, MeasureInteractionState } from '../../MeasurePlugin/index.js';
+export type MeasurePluginV2Instance = ReturnType<typeof MeasurePluginV2>;