@realsee/five-webgpu 1.0.0-alpha.4 → 1.0.0-alpha.6

package/plugins/FloorplanPlugin/typings/floorplanData.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 户型图内部使用数据（camelCase），由 formatData 从 FloorplanServerData 转换而来
+ */
+import type * as THREE from 'three/webgpu';
+export interface FloorplanPosition {
+    x: number;
+    y: number;
+}
+export interface FloorplanImagePosition {
+    x: number;
+    y: number;
+}
+export interface FloorplanOutlineItem {
+    url: string;
+    index: number;
+    svgUrl?: string;
+    /** svg_url 拉取到的文本内容，存在时优先使用 svg 渲染线框 */
+    svgContent?: string;
+}
+export interface FloorplanEntrance {
+    positionInImage: FloorplanImagePosition;
+    northRad: number;
+    roomId: string;
+    floorIndex: number;
+}
+export interface FloorplanBounding {
+    max: FloorplanPosition;
+    min: FloorplanPosition;
+    origin: FloorplanPosition;
+}
+export interface FloorplanRoomLabelItem {
+    position: FloorplanPosition;
+    positionInImage: FloorplanImagePosition;
+}
+export interface FloorplanDimension {
+    width: number;
+    height: number;
+    /** 垂直方向标注箭头定位点 */
+    vertical?: FloorplanPosition[];
+    /** 水平方向标注箭头定位点 */
+    horizontal?: FloorplanPosition[];
+}
+export interface FloorplanRoomItem {
+    id: string;
+    /** 面积，单位 mm² */
+    size: number;
+    name: string;
+    /** 用户自定义分间别名 */
+    customizedName?: string;
+    /** 房间轮廓多边形点（户型图坐标系，原点在中心） */
+    path: FloorplanPosition[];
+    roomType: string;
+    /** 地板材质类型：0 纯色 / 1 瓷砖 / 2 木地板 */
+    floorType: number;
+    roomLabel: FloorplanRoomLabelItem;
+    observerIndexs: number[];
+    dimension?: FloorplanDimension;
+}
+export interface FloorplanRuleLabels {
+    top: FloorplanPosition[][];
+    right: FloorplanPosition[][];
+    bottom: FloorplanPosition[][];
+    left: FloorplanPosition[][];
+}
+export interface FloorplanFloorData {
+    floorName: string;
+    floorIndex: number;
+    rooms: FloorplanRoomItem[];
+    rules: FloorplanRuleLabels;
+    /** 无房间数据时，是否仍有墙线（决定是否展示缺省占位图） */
+    is_has_wall: boolean;
+    /** 家具数据，通过 loadItems 填充 */
+    items?: FloorplanItem[];
+}
+export interface FloorplanObserver {
+    floorIndex: number;
+    positionInImage: FloorplanImagePosition;
+}
+export interface FloorplanData {
+    outlines: FloorplanOutlineItem[];
+    floorDatas: FloorplanFloorData[];
+    entrance: FloorplanEntrance | null;
+    bounding: FloorplanBounding;
+    observers: FloorplanObserver[];
+}
+/** 家具 icon（loadItems 填充到 floorDatas[i].items） */
+export interface FloorplanItem {
+    id: string;
+    positionInImage: FloorplanImagePosition;
+    /** 宽度，占户型图整体宽度的比例 [0,1] */
+    width: number;
+    /** 高度，占户型图整体高度的比例 [0,1] */
+    height: number;
+    src: string;
+    notes: string;
+    rotateX: number;
+    rotateY: number;
+    rotateZ: number;
+}
+/** 挂载到雷达图上的三维物体（3D 世界坐标） */
+export interface FloorplanExtraObject3D {
+    id: string;
+    position: THREE.Vector3;
+    icon?: string;
+}
+/** 转换为户型图 2D 坐标后的三维挂件 */
+export interface FloorplanExtraObject {
+    id: string;
+    floorIndex: number;
+    positionInImage: FloorplanImagePosition;
+    icon: string;
+}

package/plugins/FloorplanPlugin/typings/floorplanServerData.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 户型图服务端原始数据（snake_case），与 formatData 配合转换成内部使用的 FloorplanData（camelCase）
+ */
+export interface FloorplanServerPosition {
+    x: number;
+    y: number;
+}
+export interface FloorplanServerImagePosition {
+    x: number;
+    y: number;
+}
+export interface FloorplanServerOutlineItem {
+    url: string;
+    index: number;
+    svg_url?: string;
+}
+export interface FloorplanServerEntrance {
+    position_in_image: FloorplanServerImagePosition;
+    north_rad: number;
+    room_id: string;
+    floor_index: number;
+}
+export interface FloorplanServerBounding {
+    max: FloorplanServerPosition;
+    min: FloorplanServerPosition;
+    origin: FloorplanServerPosition;
+}
+export interface FloorplanServerRoomLabelItem {
+    position: FloorplanServerPosition;
+    position_in_image: FloorplanServerImagePosition;
+}
+export interface FloorplanServerDimension {
+    width: number;
+    height: number;
+    /** 垂直方向标注箭头定位点（一般为 2 个点：下端点、上端点） */
+    vertical?: FloorplanServerPosition[];
+    /** 水平方向标注箭头定位点（一般为 2 个点：左端点、右端点） */
+    horizontal?: FloorplanServerPosition[];
+}
+export interface FloorplanServerRoomItem {
+    id: string;
+    size: number;
+    name: string;
+    customized_name?: string;
+    path: FloorplanServerPosition[];
+    room_type: string;
+    floor_type: number;
+    room_label: FloorplanServerRoomLabelItem;
+    observer_indexs: number[];
+    dimension?: FloorplanServerDimension;
+}
+export interface FloorplanServerRuleLabels {
+    top: FloorplanServerPosition[][];
+    right: FloorplanServerPosition[][];
+    bottom: FloorplanServerPosition[][];
+    left: FloorplanServerPosition[][];
+}
+export interface FloorplanServerFloorData {
+    floor_name: string;
+    floor_index: number;
+    rooms: FloorplanServerRoomItem[];
+    rules: FloorplanServerRuleLabels;
+    is_has_wall: boolean;
+}
+export interface FloorplanServerObserver {
+    floor_index: number;
+    position_in_image: FloorplanServerImagePosition;
+}
+export interface FloorplanServerComputedData {
+    floor_datas: FloorplanServerFloorData[];
+    entrance: FloorplanServerEntrance | null;
+    bounding: FloorplanServerBounding;
+    observers: FloorplanServerObserver[];
+}
+export interface FloorplanServerData {
+    outlines: FloorplanServerOutlineItem[];
+    computed_data: FloorplanServerComputedData;
+}

package/plugins/FloorplanPlugin/typings/index.d.ts

@@ -0,0 +1,2 @@
+export * from './floorplanData';
+export * from './floorplanServerData';

package/plugins/FloorplanPlugin/utils/changeMode.d.ts

@@ -0,0 +1,5 @@
+import type { Five } from '@realsee/five-webgpu';
+/**
+ * 等待 five.changeMode 真正的动画结束（changeMode 返回的 Promise 只代表切换请求被接受，不代表动画播放完毕）
+ */
+export declare function changeMode(five: Five, changeModeParams: Parameters<Five['changeMode']>): Promise<void>;

package/plugins/FloorplanPlugin/utils/changeModelCanvasOpacity.d.ts

@@ -0,0 +1,6 @@
+import type { Five } from '@realsee/five-webgpu';
+/**
+ * 通过 CSS opacity 让 five 渲染画布（及标记了 data-infive="1" 的兄弟 DOM）淡入 / 淡出
+ * @description 只改 DOM 透明度，不修改模型材质，代价小、可随时中断
+ */
+export declare function changeModelCanvasOpacity(five: Five, opacity: number, duration?: number): void;

package/plugins/FloorplanPlugin/utils/correctFiveState.d.ts

@@ -0,0 +1,11 @@
+import type { Five } from '@realsee/five-webgpu';
+import { type ShowState } from '../typing';
+/** 展示户型图所需的相机默认 fov */
+export declare const FIVE_CAMERA_DEFAULT_FOV = 80;
+/**
+ * 把当前 five 相机 / 模式状态纠正为展示户型图所需的目标状态
+ * @description
+ * - 模式不一致：调用 five.changeMode 切换模式（同时切到目标 pose）
+ * - 模式一致但相机状态不一致：调用 five.updateCamera 纠正相机
+ */
+export declare function correctFiveState(five: Five, showState: ShowState, userAction?: boolean): Promise<void>;

package/plugins/FloorplanPlugin/utils/equal.d.ts

@@ -0,0 +1,9 @@
+export declare function isShallowEqual(value: unknown, other: unknown): boolean;
+export declare function isDeepEqual(value: unknown, other: unknown): boolean;
+/**
+ * 比较两个值是否相等
+ * @param opt.deep - 是否深比较，默认 false（浅比较）
+ */
+export declare function equal(value: unknown, other: unknown, opt?: {
+    deep?: boolean;
+}): boolean;

package/plugins/FloorplanPlugin/utils/filter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 排除指定属性名数组，返回剩余属性组成的新对象
+ */
+export declare function omit<T extends object, K extends keyof T>(object: T, props: K[]): Omit<T, K>;
+/**
+ * 只保留指定属性名数组，返回剩余属性组成的新对象
+ */
+export declare function pick<T extends object, K extends keyof T>(object: T, props: K[]): Pick<T, K>;

package/plugins/FloorplanPlugin/utils/fiveModelLoad.d.ts

@@ -0,0 +1,6 @@
+import type { Five } from '@realsee/five-webgpu';
+/** 取「当前 work」对应的 model（多 work/model 场景下按 workCode 匹配，找不到则回退到 five.model） */
+export declare function getFiveModel(five: Five): import("@realsee/five-webgpu").Model;
+export declare function fiveModelIsLoaded(five: Five): boolean;
+/** 等待「当前 work」对应的 model 加载完成 */
+export declare function waitFiveModelLoaded(five: Five): Promise<void>;

package/plugins/FloorplanPlugin/utils/formatData.d.ts

@@ -0,0 +1,6 @@
+import type { FloorplanServerData, FloorplanData } from '../typings';
+/**
+ * 把后端返回的下划线风格 FloorplanServerData 转换成驼峰风格的 FloorplanData
+ */
+export declare function formatData(data: FloorplanServerData): Promise<FloorplanData>;
+export default formatData;

package/plugins/FloorplanPlugin/utils/formatPosition.d.ts

@@ -0,0 +1,33 @@
+import type { Five } from '@realsee/five-webgpu';
+import type { FloorplanBounding, FloorplanData, FloorplanPosition, FloorplanImagePosition } from '../typings';
+/**
+ * 拼接 SVG path 的 d 属性字符串
+ */
+export declare function pathD(points: FloorplanPosition[], options?: {
+    needZ?: boolean;
+    format?: (point: FloorplanPosition) => FloorplanPosition;
+}): string;
+/**
+ * 把户型图坐标系（原点在中心）的点转换到 SVG 坐标系（原点在左上角，y 轴向下）
+ */
+export declare function formatFloorplanPoint({ x, y }: FloorplanPosition, bounding: FloorplanBounding): FloorplanPosition;
+/**
+ * 三维模型坐标（米）转户型图坐标（毫米，原点在中心）
+ */
+export declare function modelPosition2FloorplanPosition(position: {
+    x: number;
+    y: number;
+    z: number;
+}, floorplanData: FloorplanData): FloorplanPosition;
+/**
+ * 户型图坐标转图片相对坐标 [0,1]
+ */
+export declare function floorplanPosition2ImagePosition(position: FloorplanPosition, floorplanData: FloorplanData): FloorplanImagePosition;
+/**
+ * 求三维世界坐标点所在的楼层
+ */
+export declare function getFloorIndexFromModelPosition(position: {
+    x: number;
+    y: number;
+    z: number;
+}, five: Five): number;

package/plugins/FloorplanPlugin/utils/getDistanceFromModel.d.ts

@@ -0,0 +1,6 @@
+import type { Five } from '@realsee/five-webgpu';
+/**
+ * 根据模型整体包围盒和目标 fov/aspect，反算相机取景合适的距离
+ * @description 与 five 内部 FloorplanController.distanceFromModel 等价（该方法未对外导出，故在插件内重新实现）
+ */
+export declare function getDistanceFromModel(five: Five, fov: number, aspect: number): number;

package/plugins/FloorplanPlugin/utils/getPxmm.d.ts

@@ -0,0 +1,19 @@
+import type { Five } from '@realsee/five-webgpu';
+import { FLOOR_PLAN_ATTACHED_TO } from '../typing';
+export interface GetPxmmOption {
+    attachedTo?: FLOOR_PLAN_ATTACHED_TO;
+}
+/**
+ * 取指定楼层的地面高度（该楼层所有点位站立位置 y 的最大值）
+ * @description 若 floorIndex 超过实际最大楼层（比如查询顶层的天花板），退化为取整模型包围盒顶部
+ */
+export declare function getFloorY(five: Five, floorIndex: number): number;
+/**
+ * 根据吸附方式获取户型图应当吸附的世界坐标高度（y）
+ */
+export declare function getAttachedY(five: Five, floorIndex: number, attachedTo?: FLOOR_PLAN_ATTACHED_TO): number;
+/**
+ * 计算「每毫米对应多少像素」（用于把 3D 世界的毫米尺寸换算为户型图 DOM 的像素尺寸）
+ * @description 在吸附高度上取原点与 x 方向单位点，分别投影到屏幕 NDC 坐标，用横向偏移量换算比例
+ */
+export declare function getPxmm(five: Five, container: Element, floorIndex: number, options?: GetPxmmOption): number;

package/plugins/FloorplanPlugin/utils/isTruelyObject.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 判断是否是「纯对象」（排除数组、null、Map、Set 等）
+ */
+export declare function isTruelyObject(value: unknown): value is Record<string, unknown>;

package/plugins/FloorplanPlugin/utils/nearlyEqual.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断两个数字四舍五入到 precision 位小数后是否相等
+ */
+export declare function nearlyEqual(x: number, y: number, precision?: number): boolean;
+/**
+ * 判断两个弧度值是否近似相等，处理 0 / 2π 边界（角度环绕）
+ */
+export declare function nearlyEqualRad(x: number, y: number, precision?: number): boolean;

package/plugins/FloorplanPlugin/utils/to.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Go 风格的错误处理封装：`const [err, data] = await to(promise)`
+ */
+export declare function to<T>(promise: Promise<T>): Promise<[null, T] | [Error, null]>;
+export default to;

package/plugins/Object3DHelperPlugin/Controller.d.ts

@@ -0,0 +1,99 @@
+import type { Five } from '@realsee/five-webgpu';
+import { BasePlugin } from '../BasePlugin';
+import * as THREE from 'three/webgpu';
+import type { Object3DHelperEventMap, Object3DHelperState, ObjectHelperControllers, PositionFrom } from './typing';
+import type { HelperConfig, HelperOffset, Object3DHelperPluginEventMap, Object3DHelperPluginState } from './typing';
+import { Subscribe } from '@realsee/five-webgpu';
+export declare const PLUGIN = "Object3DHelperPlugin";
+export type AddObject3DHelperConfig = {
+    positionFrom?: PositionFrom;
+    offset?: HelperOffset;
+    /** Helpers 的世界坐标偏移量 */
+    helperOffset?: THREE.Vector3;
+    yAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    xAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    zAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    moveHelper?: HelperConfig<{
+        xArrowEnable?: boolean;
+        yArrowEnable?: boolean;
+        zArrowEnable?: boolean;
+    }>;
+    /** 是否展示 MoveHelper 拖拽时的坐标提示，默认 false */
+    moveHelperTips?: boolean;
+    rotateHelper?: HelperConfig<{
+        yzCircleEnable?: boolean;
+        xzCircleEnable?: boolean;
+        xyCircleEnable?: boolean;
+        angleTipsEnable?: boolean;
+    }>;
+    boundingBoxHelper?: HelperConfig;
+};
+export declare class Object3DHelper {
+    controllers: ObjectHelperControllers;
+    state: Object3DHelperState;
+    hooks: Subscribe<Object3DHelperEventMap>;
+    constructor(controllers?: ObjectHelperControllers);
+    show(options?: {
+        userAction?: boolean;
+    }): void;
+    hide(options?: {
+        userAction?: boolean;
+    }): void;
+    enable(options?: {
+        userAction?: boolean;
+    }): void;
+    disable(options?: {
+        userAction?: boolean;
+    }): void;
+    dispose(): void;
+    setState(state: Partial<Object3DHelperState>, _options?: {
+        userAction?: boolean;
+    }): void;
+    addControllers(controllers: ObjectHelperControllers): void;
+    initialHelperMatrix(): void;
+    private handleEnable;
+    private handleVisible;
+    private handleDispose;
+    private everyControllerDo;
+}
+export declare class Controller extends BasePlugin.Controller<Object3DHelperPluginState, Object3DHelperPluginEventMap & BasePlugin.EventMap<Object3DHelperPluginState, any>, any, any> {
+    name: string;
+    data?: any;
+    state: Object3DHelperState;
+    objectHelperMap: Map<THREE.Object3D, {
+        helper: Object3DHelper;
+        disposers: (() => any)[];
+        helperGroup: THREE.Group;
+    }>;
+    constructor(five: Five);
+    show(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    hide(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    enable(options?: {
+        userAction?: boolean;
+    }): void;
+    disable(options?: {
+        userAction?: boolean;
+    }): void;
+    dispose(): void;
+    load(_data: any): Promise<void>;
+    setState(state: Partial<Object3DHelperState>, options?: {
+        userAction?: boolean;
+    } & Record<string, any>): void;
+    getObject3DHelper(object3D: THREE.Object3D): {
+        helper: Object3DHelper;
+        disposers: (() => any)[];
+        helperGroup: THREE.Group;
+    } | undefined;
+    addObject3DHelper(object3D: THREE.Object3D, paramsConfig?: AddObject3DHelperConfig): ObjectHelperControllers | undefined;
+    removeObject3DHelper(object3D: THREE.Object3D): void;
+    private handleEnable;
+    private handleVisible;
+    private handleDispose;
+    private everyHelperDo;
+    private actionIfStateIsEnabled;
+    private getConfig;
+}

package/plugins/Object3DHelperPlugin/Controllers/BaseController.d.ts

@@ -0,0 +1,142 @@
+import * as THREE from 'three/webgpu';
+import { Subscribe } from '@realsee/five-webgpu';
+import type { SolidGuideOptions } from '../utils/solidGuide';
+import type { HelperEventMap, HelperOffset, InternalHelperEventMap, ScaleCallback } from '../typing';
+import type { BaseHelper } from '../Helper/BaseHelper';
+import DomEvents from '../../thirdParty/domevents';
+export declare let originOpacity: {
+    opacity: number;
+} | null;
+type Config = {
+    offset?: HelperOffset;
+    yAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    xAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    zAxis?: THREE.Vector3 | (() => THREE.Vector3);
+    scaleCallback?: ScaleCallback;
+    /** 实线样式与行为配置（透传给 SolidGuideLine） */
+    solidGuide?: SolidGuideOptions;
+};
+export declare abstract class BaseController<T extends BaseHelper = BaseHelper, K extends THREE.Object3D = THREE.Object3D> {
+    originObject3D: K;
+    hooks: Subscribe<HelperEventMap>;
+    preventTapDefaultEvent: boolean;
+    protected internalHooks: Subscribe<InternalHelperEventMap>;
+    protected readonly disposers: (() => void)[];
+    protected helperObject3D: T;
+    protected camera: THREE.Camera;
+    protected model: THREE.Object3D;
+    protected scene: THREE.Object3D;
+    protected container: HTMLElement;
+    protected domEvents: DomEvents;
+    protected isDragging: boolean;
+    protected enabled: boolean;
+    protected name: string;
+    protected boundingBox?: THREE.Box3;
+    protected config: Config;
+    private onRender;
+    protected cameraHooks: Subscribe<{
+        cameraUpdate: () => any;
+    }>;
+    /** 其他控制器的引用，用于跨控制器状态检查 */
+    protected otherControllers?: {
+        moveController?: BaseController;
+        rotateController?: BaseController;
+        scaleController?: BaseController;
+    };
+    /**
+     * 更新其他控制器的引用
+     */
+    updateOtherControllers(otherControllers: {
+        moveController?: BaseController;
+        rotateController?: BaseController;
+        scaleController?: BaseController;
+    }): void;
+    /**
+     * 获取当前控制器的拖拽状态
+     */
+    getIsDragging(): boolean;
+    constructor(params: {
+        camera: THREE.Camera;
+        model: THREE.Object3D;
+        originObject3D: K;
+        helperObject3D: T;
+        container: HTMLElement;
+        domEvents: DomEvents;
+        scene: THREE.Object3D;
+        onRender?: () => void;
+        sharedHooks?: Subscribe<HelperEventMap>;
+        sharedInternalHooks?: Subscribe<InternalHelperEventMap>;
+        /** 其他控制器的引用，用于跨控制器状态检查 */
+        otherControllers?: {
+            moveController?: BaseController;
+            rotateController?: BaseController;
+            scaleController?: BaseController;
+        };
+    }, config?: Config);
+    initialHelperPosition(): void;
+    initialHelperQuaternion(): void;
+    enable(): void;
+    disable(): void;
+    show(): void;
+    hide(): void;
+    dispose(): void;
+    /**
+     * @description: applyHelperMatrix4
+     * @param {THREE.Matrix4} matrix position 偏移量
+     */
+    applyHelperMatrix4(matrix: THREE.Matrix4): void;
+    /**
+     * @description: applyHelperQuaternion
+     * @param {THREE.Quaternion} quaternion 旋转四元数
+     * @param {THREE.Vector3} origin 旋转中心
+     */
+    applyHelperQuaternion(quaternion: THREE.Quaternion, origin: THREE.Vector3): void;
+    /**
+     * @description: applyHelperScaleMatrix4
+     * @param {THREE.Matrix4} matrix 缩放矩阵
+     * @param {THREE.Vector3} origin 缩放中心
+     */
+    applyHelperScaleMatrix4(matrix: THREE.Matrix4, origin?: THREE.Vector3): void;
+    onWantsTapGesture: (raycaster: THREE.Raycaster) => false | void;
+    updateHelperScale: () => void;
+    onWantsGesture(type: 'press' | 'pan' | string, pointers: {
+        x: number;
+        y: number;
+    }[], final: boolean): false | void;
+    onIntersectionOnModelUpdate(intersection: THREE.Intersection): void;
+    /**
+     * @description: onApplyOriginObjectScale
+     * @param {THREE.Matrix4} params.matrix 缩放矩阵
+     * @param {THREE.Vector3} params.origin 缩放中心
+     */
+    protected onApplyOriginObjectScale(params: {
+        matrix: THREE.Matrix4;
+        origin?: THREE.Vector3;
+    }): void;
+    /**
+     * @description: onApplyOriginObjectRotate
+     * @param {THREE.Quaternion} params.quaternion 旋转四元数
+     * @param {THREE.Vector3} params.origin 旋转中心
+     */
+    protected onApplyOriginObjectRotate(params: {
+        quaternion: THREE.Quaternion;
+        origin: THREE.Vector3;
+    }): void;
+    /**
+     * @description: onApplyOriginObjectPosition
+     * @param {THREE.Matrix4} params.matrix position 偏移量
+     */
+    protected onApplyOriginObjectPosition(params: {
+        matrix: THREE.Matrix4;
+    }): void;
+    protected onSetOriginObjectScale(scale: THREE.Vector3): void;
+    protected onSetOriginObjectRotate(_quaternion: THREE.Quaternion, _origin?: THREE.Vector3): void;
+    protected onSetOriginObjectPosition(position: THREE.Vector3): void;
+    protected render(): void;
+    protected updateOffsetByScale(scale: THREE.Vector3): void;
+    protected hoverListener(object3D: THREE.Object3D | undefined | THREE.Group | (THREE.Object3D | undefined | THREE.Group)[], hoverColor?: THREE.Color | string | number, hoverOpacity?: number): () => void;
+    private getIntersectObject;
+    private getBox;
+    private calculateOffset;
+}
+export {};

package/plugins/Object3DHelperPlugin/Controllers/BoundingBoxController.d.ts

@@ -0,0 +1,16 @@
+import { BaseController } from './BaseController';
+import type { BoundingBoxHelperAbstract } from '../Helper/BaseHelper';
+import * as THREE from 'three/webgpu';
+export declare class BoundingBoxController<OriginObject3D extends THREE.Object3D = THREE.Object3D> extends BaseController<BoundingBoxHelperAbstract<OriginObject3D>> {
+    protected name: string;
+    constructor(...params: ConstructorParameters<typeof BaseController<BoundingBoxHelperAbstract<OriginObject3D>>>);
+    protected onApplyOriginObjectRotate(params: {
+        quaternion: THREE.Quaternion;
+        origin: THREE.Vector3;
+    }): void;
+    protected onSetOriginObjectRotate(quaternion: THREE.Quaternion, origin?: THREE.Vector3): void;
+    /**
+     * 直接从 object 同步 position 和 quaternion，消除累积误差
+     */
+    private syncWithObject;
+}

package/plugins/Object3DHelperPlugin/Controllers/MoveController.d.ts

@@ -0,0 +1,66 @@
+import { BaseController } from './BaseController';
+import * as THREE from 'three/webgpu';
+import type { MoveHelperAbstract } from '../Helper/BaseHelper';
+export declare function rayOnLine(params: {
+    raycaster: THREE.Raycaster;
+    line: THREE.Line3;
+    clampToLine?: boolean;
+}): THREE.Vector3;
+export type UseFaceNormalInterface = {
+    /**
+     * 是否使用面的法线，默认为true
+     */
+    enable?: boolean;
+    /**
+     * 期望对齐的方向，默认为Y轴对齐Face的法向向量，即 `{ x: 0, y: 1, z: 0 }`
+     */
+    alignmentVector?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    /**
+     * 修正后的face normal
+     */
+    fixedFaceNormal?: (face: THREE.Vector3) => THREE.Vector3;
+} | boolean;
+export declare class MoveController<T extends MoveHelperAbstract = MoveHelperAbstract> extends BaseController<T> {
+    get moveByMouseEnable(): boolean;
+    protected name: string;
+    private startInfo?;
+    /** 拖拽时用于显示方向参考的直线（与 ScaleController 一致：Line + LineBasicMaterial） */
+    private dragGuideLine?;
+    private solidGuide;
+    private _moveByMouse;
+    private mouseInfo?;
+    private mousedownEventListenerDisposer?;
+    constructor(...params: ConstructorParameters<typeof BaseController<T>>);
+    dispose(): void;
+    /**
+     * @description: 跟随鼠标移动
+     */
+    moveByMouse(params?: {
+        /** 是否使用面的法线，默认为false */
+        useFaceNormal: UseFaceNormalInterface;
+    }): void;
+    /**
+     * @description: 禁用跟随鼠标移动
+     */
+    disableMoveByMouse(): void;
+    onIntersectionOnModelUpdate(intersection: THREE.Intersection): void;
+    private handleMouseDown;
+    private handleMouseUp;
+    /**
+     * @description: 拖动开始，找出拖的Direction
+     */
+    private dragStart;
+    private dragging;
+    /**
+     * 更新直线缩放，保持视觉上的恒定大小（与 ScaleController 保持一致）
+     */
+    private updateDragGuideLineScale;
+    private move;
+    private dragEnd;
+    private setTipsText;
+    private setTipsPosition;
+}