@realsee/five 5.0.0-alpha.20 → 5.0.0-alpha.200

package/five/index.d.ts

@@ -1,24 +1,169 @@
-/// <reference types="hammerjs" />
-
+import { Matrix3 } from 'three';
+import { Matrix4 } from 'three';
+import { Plane } from 'three';
 import * as THREE_2 from 'three';
+import { Vector3 } from 'three';
 
 export declare interface AddableObject extends THREE_2.Object3D {
+    /** 是否需要渲染一次 */
     needsRender?: boolean;
+    /** 动画 */
     mixer?: THREE_2.AnimationMixer;
+    /** 设置当前分辨率 */
     setResolution?(width: number, height: number): void;
+    /** 设置当前时间 */
+    setTime?(time: number): void;
+}
+
+export declare interface AnimationFrame {
+    callback: (time: number, deltaTime: number, ...args: any[]) => void;
+    once: boolean;
+    delay: number;
+    order: number;
+}
+
+export declare class AnimationFrameLoop {
+    private frames;
+    private time;
+    private stoped;
+    private context?;
+    private requestId;
+    private static sharedInstance?;
+    static get shared(): AnimationFrameLoop;
+    static getFrameTime(): number;
+    constructor();
+    private loop;
+    setContext(context: any): void;
+    getContext(): any;
+    private requestAnimationFrame;
+    private cancelAnimationFrame;
+    private remove;
+    /**
+     * 添加到动画循环
+     * @param callback - 动画循环回调
+     * @param once - 是否只回调一次
+     * @param delay - 延迟多少个动画循环回调
+     * @param order - 优先级，数字越小越早被调用
+     * @returns 移除动画循环函数
+     */
+    add(callback: AnimationFrame["callback"], once?: boolean, delay?: number, order?: number): () => void;
+    disponse(): void;
+}
+
+export declare class BVH {
+    trianglesArray?: Float32Array;
+    offsetArray?: Uint32Array;
+    rootNode?: BVHNode;
+    create(trianglesArray: Float32Array): this;
+    splitNode(maxTrianglesPerNode: number): this;
+    /**
+     * 计算射线与三角形的碰撞
+     * @param rayOrigin - 射线的原点坐标
+     * @param rayDirection - 设想的方向向量
+     * @param backfaceCulling - 是否背面剔除
+     * @return 碰撞焦点数组
+     */
+    intersectRay(rayOrigin: BVHVector3, rayDirection: BVHVector3, backfaceCulling: boolean): BVHIntersect[];
+    dispose(): void;
+}
+
+export declare class BVHIntersect {
+    triangle: [BVHVector3, BVHVector3, BVHVector3];
+    intersectionPoint: BVHVector3;
+    constructor(triangle: [BVHVector3, BVHVector3, BVHVector3], intersectionPoint: BVHVector3);
+}
+
+/**
+ * A node in the BVH structure
+ * @param extents - the min coords of this node's bounding box
+ * @param startIndex - an index in the bbox array, where the first element of this node is located
+ * @param endIndex - an index in the bbox array, where the last of this node is located, plus 1 (meaning that its non-inclusive).
+ * @param level - distance of this node from the root for the bvh tree. root node has level=0, its children have level=1 etc.
+ */
+export declare class BVHNode {
+    extents: ArrayLike<number>;
+    startIndex: number;
+    endIndex: number;
+    node0?: BVHNode;
+    node1?: BVHNode;
+    constructor(extents: ArrayLike<number>, startIndex: number, endIndex: number);
+}
+
+export declare class BVHVector3 {
+    x: number;
+    y: number;
+    z: number;
+    constructor(x: number, y: number, z: number);
+    copy(v: BVHVector3): this;
+    set(x: number, y: number, z: number): this;
+    fromArray(array: number[], firstElementPos?: number): this;
+    add(v: BVHVector3): this;
+    multiplyScalar(scalar: number): this;
+    subVectors(a: BVHVector3, b: BVHVector3): this;
+    dot(v: BVHVector3): number;
+    cross(v: BVHVector3): this;
+    crossVectors(a: BVHVector3, b: BVHVector3): this;
+    clone(): BVHVector3;
 }
 
 /** Five 相机 */
-export declare class Camera extends THREE_2.PerspectiveCamera {
+export declare class Camera extends THREE_2.Camera {
+    fov: number;
+    aspect: number;
+    near: number;
+    far: number;
+    perspToOrtho: THREE_2.Vector2;
+    orthoDistance: number;
     /** 相机姿态 */
-    pose: Pose;
-    constructor(fov: number);
+    pose: CameraPose;
+    private perspectiveCamera;
+    private orthographicCamera;
+    needsRender: boolean;
+    private lastValues;
+    constructor(fov: number, aspect?: number, near?: number, far?: number, perspToOrtho?: THREE_2.Vector2, orthoDistance?: number);
+    getDirection(target: THREE_2.Vector3): THREE_2.Vector3;
     /** 通过相机参数反算姿态 */
-    computePose(): void;
+    computePose(distance?: number): this;
     /** 设置相机姿态 */
-    setFromPose(pose: Partial<Pose>): void;
+    setFromPose(pose: Partial<CameraPose>): this;
     /** 拷贝相机姿态 */
-    copyPose(): Pose;
+    copyPose(): CameraPose;
+    private computeProjectionMatrix;
+    setViewOffset(fullWidth: number, fullHeight: number, x: number, y: number, width: number, height: number): void;
+    clearViewOffset(): void;
+    updateProjectionMatrix(): void;
+    get perspectiveProjectionMatrix(): THREE_2.Matrix4;
+    get perspectiveProjectionMatrixInverse(): THREE_2.Matrix4;
+    get orthographicProjectionMatrix(): THREE_2.Matrix4;
+    get orthographicProjectionMatrixInverse(): THREE_2.Matrix4;
+    updateTime(_time: number, _deltaTime: number): void;
+    get isPerspectiveCamera(): boolean;
+    get isOrthographicCamera(): boolean;
+    copy(source: this, recursive?: boolean): this;
+}
+
+export declare interface CameraPose {
+    longitude: number;
+    latitude: number;
+    fov: number;
+    distance: number;
+    offset: THREE_2.Vector3;
+}
+
+export declare class Clipper {
+    numPlanes: number;
+    clipperPlanes: Float32Array | null;
+    clipperFloors: number[] | null;
+    private static sharedInstance?;
+    static get shared(): Clipper;
+    constructor();
+    update(clipperParameter: ClipperParameter | ClipperParameter[], camera: THREE_2.Camera): void;
+    private projectPlanes;
+}
+
+export declare interface ClipperParameter {
+    clippingBoxMatrix: THREE_2.Matrix4;
+    floorIndex?: number;
 }
 
 export declare type ControllerCustomInitTypes = {
@@ -28,6 +173,8 @@ export declare type ControllerCustomInitTypes = {
     VRPanorama: VRPanoramaControllerCustomInitArgs;
     Model: ModelControllerCustomInitArgs;
     DepthPanorama: DepthPanoramaControllerCustomInitArgs;
+    Mapview: MapviewControllerCustomInitArgs;
+    XRPanorama: XRPanoramaControllerCustomInitArgs;
 };
 
 export declare type ControllerEventTypes = {
@@ -81,7 +228,7 @@ export declare type ControllerEventTypes = {
      * 观察点位被选择
      * @param panoIndex - 选择的点位
      */
-    panoSelected(panoIndex: number): void;
+    panoSelected(panoIndex: number | null): void;
     /**
      * 意图要移动到某个点位 可以通过 `return false` 阻止
      * @param panoIndex - 图要移动到的点位下标
@@ -161,6 +308,7 @@ export declare type ControllerEventTypes = {
     wantsGesture(type: GestureTypes, pointers: {
         x: number;
         y: number;
+        delta?: number;
     }[], final: boolean): void | false;
     /**
      * 手势 触发
@@ -171,6 +319,7 @@ export declare type ControllerEventTypes = {
     gesture(type: GestureTypes, pointers: {
         x: number;
         y: number;
+        delta?: number;
     }[], final: boolean): void;
     /**
      * 意图要触发 pan 手势(滑动屏幕)， 可以通过 `return false` 阻止
@@ -202,15 +351,17 @@ export declare type ControllerEventTypes = {
      * 意图要触发 tap 手势(点击屏幕)， 可以通过 `return false` 阻止
      * @param raycaster - 点击对应的三维射线
      * @param tapPosition - 点击对应的屏幕位置
+     * @param final - 是否手势结束
      * @returns 可以通过 `return false` 阻止
      */
-    wantsTapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2): void | false;
+    wantsTapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, final: boolean): void | false;
     /**
      * tap 手势(点击屏幕) 被触发
      * @param raycaster - 点击对应的三维射线
      * @param tapPosition - 点击对应的屏幕位置
+     * @param final - 是否手势结束
      */
-    tapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2): void;
+    tapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, final: boolean): void;
     /**
      * 意图要触发 pinch 手势(双指缩放)，可以通过 `return false` 阻止
      * @param scale - 缩放数值
@@ -219,6 +370,23 @@ export declare type ControllerEventTypes = {
      * @returns 可以通过 `return false` 阻止
      */
     wantsPinchGesture(scale: number, nextFov: number, final: boolean): void | false;
+    /**
+     * 意图要触发 press 手势(长按屏幕)， 可以通过 `return false` 阻止
+     * @param raycaster - 长按对应的三维射线
+     * @param tapPosition - 长按对应的屏幕位置
+     * @param duration - 长按持续时间
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsPressGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, duration: number, isFinal: boolean): void | false;
+    /**
+     * tap 手势(点击屏幕) 被触发
+     * @param raycaster - 点击对应的三维射线
+     * @param tapPosition - 点击对应的屏幕位置
+     * @param duration - 长按持续时间
+     * @param final - 是否手势结束
+     */
+    pressGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, duration: number, isFinal: boolean): void;
     /**
      * pinch 手势(双指缩放) 被触发
      * @param scale - 缩放数值
@@ -288,80 +456,48 @@ export declare type ControllerEventTypes = {
      * @param panoIndex - 加载点位下标
      * @param observer - 对应的 observer 详情
      */
-    textureLoaded(panoIndex: number, observer: WorkObserver): void;
+    textureLoaded(panoIndex: number, observer: WorkObserver, meta: (NetWorkMeta | null)[]): void;
     /**
      * 抛出错误
      * @param error - 抛出错误
      */
     error(error: Error): void;
+    /**
+     * webXR模式开始，webxr session完成坐标系矫正
+     */
+    webXRSessionStart(): void;
+    /**
+     * webXR模式结束,webxr session销毁
+     */
+    webXRSessionEnd(): void;
+    /**
+     * axes代表控制杆，axes数组的0-1元素分别代表左控制器的左（-1）右（1）,左控制器的上（-1）下（1），axes数组的2-3元素同理
+     */
+    webXRControllerEvent(type: WebXRControllerType, key: WebXRControllerKey, params: WebXRControllerParams): void;
 };
 
+/**
+ * URL 地址的转换
+ * @param source - url 原地址
+ * @param options - url 转换参数
+ * @returns url 转换结果
+ */
+export declare function defaultImageURLTransform(source: string, options: ImageURLOptions): string;
+
 export declare interface DepthPanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
     /** 最远可移动观察点距离 */
     maxAccessibleDistance?: number;
+    /**
+     * 点击地面观察点标识的判定范围
+     * @description
+     * 如果在判定范围内则确定去到目标点，
+     * 否则寻找点击位置方向最适合的点（可能会走到一个离相机更近的点）。
+     */
+    panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
-    panoCircleMeshCreator?: () => PanoCircleMeshInterface;
+    panoCircleMeshCreator?: (panoIndex: number) => PanoCircleMeshInterface;
 }
 
-/**
- * 动画变化曲线
- */
-export declare const Easing: {
-    Linear: {
-        None: (amount: number) => number;
-    };
-    Quadratic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Cubic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Quartic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Quintic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Sinusoidal: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Exponential: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Circular: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Elastic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Back: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Bounce: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-};
-
 /**
  * Five 事件列表
  * @description
@@ -382,19 +518,25 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      */
     error(error: Error): void;
     /**
-     * 开始加载 Work 数据
+     * 准备加载 Work 数据
      * @param input - 输入的 work
      * @param work - 归一化的标准 work
      * @param state - 加载时的姿态
      */
-    willLoad(input: any, work: Work, state: Omit<State, "offset">): void;
+    willLoad(input: any, work: Work, state: Omit<State, "offset" | "distance">): void;
     /**
      * 开始加载 Work 数据
      * @param input - 输入的 work
      * @param work - 归一化的标准 work
      * @param state - 加载时的姿态
      */
-    load(input: any, work: Work, state: Omit<State, "offset">): void;
+    load(input: any, work: Work, state: Omit<State, "offset" | "distance">): void;
+    /**
+     * 加载完 Work 数据
+     * @param input - 输入的 work
+     * @param work - 归一化的标准 work
+     */
+    loaded(input: any, work: Work): void;
     /**
      * 模型开始加载
      * @param workModel - 归一化的标准 work 中的 model 值
@@ -496,13 +638,21 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      * @param prevMode - 上本质是一个模态
      * @param panoIndex - 初始化动画结束后的点位下标
      * @param toPose - 初始化动画结束后的状态
+     * @param userAction - 是否用户触发
      */
-    modeChange(mode: Mode, prevMode: Mode, panoIndex: number, toPose: Pose): void;
+    modeChange(mode: Mode, prevMode: Mode, panoIndex: number, toPose: Pose, userAction: boolean): void;
     /**
      * 帮助元素显应的变换
      * @param visible - 帮助元素的是否开启
      */
     helpersVisibleChange(visible: boolean): void;
+    /**
+     * 网络资源分析
+     * @param source - 资源地址
+     * @param state - 状态
+     * @param detail - 详情
+     */
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
     /** five 被析构。 插件中请监听用于自身析构 */
     dispose(): void;
 };
@@ -521,6 +671,7 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
  * ```
  */
 export declare class Five extends Subscribe<EventTypes> {
+    static get version(): string;
     /**
      * Five 的显示模式，可以通过 `five.changeMode` `five.setState` 来切换
      * @description
@@ -531,6 +682,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * Topview 户型图模式
      * DepthPanorama 深度图游走模式
      * VRPanorama VR眼镜模式
+     * XRPanorama VR硬件模式
      * ```
      */
     static Mode: Mirror<Mode>;
@@ -539,62 +691,6 @@ export declare class Five extends Subscribe<EventTypes> {
      * 请使用 `import { Line } from "@realsee/five/line"` 代替;
      */
     static Line: any;
-    /** Five 的动画函数*/
-    static Easing: {
-        Linear: {
-            None: (amount: number) => number;
-        };
-        Quadratic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Cubic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Quartic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Quintic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Sinusoidal: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Exponential: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Circular: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Elastic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Back: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Bounce: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-    };
     /**
      * 自动播放状态是否暂停
      * @description
@@ -607,6 +703,8 @@ export declare class Five extends Subscribe<EventTypes> {
     currentMode?: Mode;
     /** 内部使用的 `THREE.Scene` */
     scene: Scene;
+    /** 内部使用的产生视差的物体Scene `THREE.Scene` */
+    parallaxScene: Scene;
     /** 内部使用的 `Camera` */
     camera: Camera;
     /**
@@ -627,11 +725,9 @@ export declare class Five extends Subscribe<EventTypes> {
      * 如果初始化时传入了 `renderer` 则直接时该值
      * 否则会通过 `preserveDrawingBuffer` `backgroundColor` `backgroundAlpha` `antialias` 创建一个 `THREE.WebGLRenderer`
      */
-    renderer: THREE_2.WebGLRenderer;
+    renderer?: THREE_2.WebGLRenderer;
     /** 当前加载的模型 */
     model: Model;
-    /** 当前加载的 work 数据 */
-    work?: Work;
     /**
      * 是否需要渲染
      * @description
@@ -652,7 +748,13 @@ export declare class Five extends Subscribe<EventTypes> {
      * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
      * 平衡加载时间和图片质量
      */
-    textureOptions: ImageOptions;
+    textureOptions: TextureOptions;
+    /**
+     * 模型lod的配置参数
+     * @description
+     * 可以配置加载模型lod的相关参数
+     */
+    modelLodOptions: ModelLodOptions;
     /**
      * 模型贴图的配置参数
      * @description
@@ -683,24 +785,56 @@ export declare class Five extends Subscribe<EventTypes> {
     plugins: {
         [key: string]: FivePluginInstance<any>;
     };
-    private ident;
+    ident: string;
+    /** 包围盒子 */
+    private boundingMesh;
+    private stopAnimationLoop?;
+    private fps;
     private helperGroup;
     private modeChangeDuration;
     private onlyRenderIfNeeds;
-    private maxFps;
+    private poweredByRealsee;
     private controller?;
     private destroyed;
     private stateSynced;
     private controllerInits;
     private panoramaLikeSavedPose;
     private extraElements;
-    private moveToPanoQueue?;
     private getPixelsRenderTarget;
-    private tweenCoordinates?;
     private readyCallbacks;
     private modelPending;
-    private screenBuffer?;
+    private syncingState;
+    /**
+     * 是否开启 IOS EDR 模式
+     * 需要客户端配合
+     * 并且开启 five.enablepostProcessing = true
+     */
+    private _enableIOSEDR;
+    private lastLoadWorkTask;
+    private requestProxy;
+    private networkSubscribe;
+    private screenBuffers?;
+    private analysis?;
+    private renderSwitch01;
+    /**
+     * gpu_picking
+     */
+    private gpuPickingRenderTarget;
+    private meshReplaceMaterialMap;
+    private meshOriginMaterialMap;
+    private copyEffect;
     constructor(initArgs?: FiveInitArgs);
+    /**
+     * GPU Picking 获取选中的 mesh
+     * @param x - 屏幕坐标 x
+     * @param y - 屏幕坐标 y
+     * @param colorMap - 需要选取的 mesh 的颜色与 uuid 的映射
+     * @param modelColor - 指定的模型颜色
+     * @returns 选中 mesh 的 uuid
+     */
+    getGPUPicking(x: number, y: number, colorMap: {
+        [key: string]: THREE_2.Color;
+    }, pixelRatio?: number, modelColor?: THREE_2.Vector3): string | false;
     /**
      * 析构 five 对象。
      * @description
@@ -725,6 +859,19 @@ export declare class Five extends Subscribe<EventTypes> {
      */
     get helperVisible(): boolean;
     set helperVisible(visible: boolean);
+    /**
+     * 是否开启 IOS EDR 模式
+     * 需要客户端配合
+     * 并且开启 five.enablepostProcessing = true
+     */
+    get enableIOSEDR(): boolean;
+    set enableIOSEDR(enable: boolean);
+    /**
+     * 是否开启后处理
+     */
+    get enablePostProcessing(): boolean;
+    set enablePostProcessing(enable: boolean);
+    updateConfiguration(args: Pick<FiveInitArgs, "panorama" | "model" | "floorplan" | "topview" | "mapview" | "depthPanorama" | "vrPanorama" | "imageOptions" | "textureOptions">): void;
     /**
      * 将显示区域加载到页面 DOM 中
      * @description
@@ -771,9 +918,21 @@ export declare class Five extends Subscribe<EventTypes> {
      * 会 Promise.reject。运动完成则 Promise.resolve
      * @param pose - 相机目标位置
      * @param duration - 动画触发的时常
+     * @param userAction - 是否用户触发
      * @returns Promise 是否移动成功
      */
-    updateCamera(pose: Partial<Pose>, duration: number): Promise<void>;
+    updateCamera(pose: Partial<Omit<Pose, "offset">>, duration: number, userAction?: boolean): Promise<void>;
+    /**
+     * 通过帧动画移动相机。（不触发点位移动）
+     * @description
+     * 如果动画中途被打断（用户触发行为，或者调用 setState, load, changeMode）的等
+     * 会 Promise.reject。运动完成则 Promise.resolve
+     * @param keyframes - 动画帧
+     * @param duration - 动画触发的时常
+     * @param userAction - 是否用户触发
+     * @returns Promise 是否移动成功
+     */
+    updateCameraWithKeyframes(keyframes: MotionKeyframe<Exclude<keyof Pose, "offset">>[], duration: number, userAction?: boolean): Promise<void>;
     /**
      * 获取当前相机经纬度
      * @deprecated 请使用使用 getPose
@@ -793,26 +952,8 @@ export declare class Five extends Subscribe<EventTypes> {
         phi: number;
         lookAtVector: THREE_2.Vector3;
     };
-    /**
-     * 初始化 initBasisLoader
-     * @description
-     * 同初始化的 initBasisLoader 参数。用于初始化 basisLoader。
-     * basisLoader 只会初始化一次，一旦初始化则不会再修改。
-     *
-     * @param transcoderResourcePath - basis 解析器路径
-     * 如果不设置，使用默认解析器 basis 解析器。
-     * 可以传入解析器的 `resourcePath`, 则使用指定的解析器
-     * @example
-     * ```
-     * // 使用默认解析器
-     * five.initialBasisLoader();
-     *
-     * // 使用指定解析器
-     * // 会调用这个目录下的 basis_transcoder.js basis_transcoder.wasm 文件作为解析器
-     * five.initialBasisLoader("https://vrlab-public.ljcdn.com/release/static/image/release/five/basis/");
-     * ```
-     */
-    initBasisLoader(transcoderResourcePath?: string): void;
+    /** 当前加载的 work 数据 */
+    get work(): Work;
     /**
      * 加载 Work 数据
      * @param inputWork - Work 数据
@@ -822,15 +963,17 @@ export declare class Five extends Subscribe<EventTypes> {
      *  - State 自定义姿态
      * @param duration - 切换时间
      */
-    load(inputWork: Work | LooseWork | any, state?: "inherit" | "initial" | Partial<Omit<State, "offset">>, duration?: number): Promise<void>;
+    load(inputWork: Work | LooseWork | any | Promise<Work | LooseWork | any>, state?: "inherit" | "initial" | Partial<Omit<State, "offset">>, duration?: number, userAction?: boolean): Promise<void>;
+    private load_;
     /**
      * 切换模态
      * @param mode - 切换到的模态
      * @param state - 切换完成时的姿态
      * @param duration - 模态切换动画用时
      * @param userAction - 是否时用户动作触发 默认 true
+     * @param force - 必须重新初始化 controller
      */
-    changeMode<T extends Mode>(mode: T, state?: Partial<Omit<State, "mode">>, duration?: number, userAction?: boolean): Promise<void>;
+    changeMode<T extends Mode>(mode: T, state?: Partial<Omit<State, "mode">>, duration?: number, userAction?: boolean, force?: boolean): Promise<void>;
     /**
      * 获取画面中的像素颜色
      * @param x - 获取像素区域的起始坐标 x
@@ -844,11 +987,7 @@ export declare class Five extends Subscribe<EventTypes> {
     /**
      * 获取显示用的画布（Canvas DOM节点）
      */
-    getElement(): HTMLCanvasElement;
-    /**
-     * 但停自动播放
-     */
-    pause(): void;
+    getElement(): HTMLCanvasElement | undefined;
     /**
      * 强制渲染
      * @description
@@ -860,7 +999,12 @@ export declare class Five extends Subscribe<EventTypes> {
      *
      * @param callback - 渲染完成回调
      */
-    render(callback?: () => void, updateObjectResolution?: boolean): void;
+    render(callback?: () => void, updateObjectResolution?: boolean): THREE_2.WebGLRenderTarget;
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /**
+     * 但停自动播放
+     */
+    pause(): void;
     play(): void;
     /**
      * 转化到 Panorama 模态，并移动到对应序号的观察点。
@@ -868,7 +1012,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * @param options - 移动点位参数
      * @param userAction - 是否用户触犯
      */
-    moveToPano(panoIndex: number, options?: MovePanoOptions, userAction?: boolean): void;
+    moveToPano(panoIndex: number, options?: MovePanoOptions, userAction?: boolean): Promise<void>;
     /**
      * 预加载点位图片资源
      * @param panoIndex - 观察点序号
@@ -910,16 +1054,34 @@ export declare class Five extends Subscribe<EventTypes> {
      * ```
      * @param state - 目标状态
      * @param immediately - 是否马上转换，马上转换会尽快达到目标状态，尽量减少中间状态，更少动画。
+     * @param userAction - 是否是用户触发的动作
      */
-    setState(state: Partial<State>, immediately?: boolean): void;
+    setState(state: Partial<State>, immediately?: boolean, userAction?: boolean): void;
     aroundScissor(callback: () => void): void;
     private syncState;
-    ready(): Promise<void>;
+    /**
+     * 当前页面静态
+     */
+    ready(args?: {
+        tile?: boolean;
+    }): Promise<void>;
+    /**
+     * 请求全屏
+     */
+    requestFullscreen(): void;
+    /**
+     * 退出全屏
+     */
+    exitFullscreen(): void;
     private throwError;
     private loadModel;
     private commonParams;
     private saveControllerPose;
     private applyController;
+    /** 移除事件绑定 */
+    private removeEventListeners;
+    /** 销毁GPU Picking 所用的材质 */
+    private diposeGPUPickingMaterial;
 }
 
 /** Five 初始化参数 */
@@ -1005,7 +1167,7 @@ export declare interface FiveInitArgs {
      * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
      * 平衡加载时间和图片质量
      */
-    textureOptions?: ImageOptions;
+    textureOptions?: TextureOptions;
     /**
      * 是否按需渲染
      * @description
@@ -1035,7 +1197,7 @@ export declare interface FiveInitArgs {
      *
      * // 使用指定解析器
      * // 会调用这个目录下的 basis_transcoder.js basis_transcoder.wasm 文件作为解析器
-     * initialBasisLoader: "https://vrlab-public.ljcdn.com/release/static/image/release/five/basis/"
+     * initialBasisLoader: "https://vr-public.realsee-cdn.cn/release/static/image/release/five/basis/"
      * ```
      */
     initialBasisLoader?: boolean | string;
@@ -1055,15 +1217,19 @@ export declare interface FiveInitArgs {
     floorplan?: ControllerCustomInitTypes["Floorplan"];
     /** 户型图模式下的特定参数 */
     topview?: ControllerCustomInitTypes["Topview"];
+    /** 地图模式下的特定参数 */
+    mapview?: ControllerCustomInitTypes["Mapview"];
     /** 深度图游走模式下的特定参数 */
     depthPanorama?: ControllerCustomInitTypes["DepthPanorama"];
     /** VR眼镜模式下的特定参数 */
     vrPanorama?: ControllerCustomInitTypes["VRPanorama"];
+    /** XR眼镜模式下的特定参数 */
+    xrPanorama?: ControllerCustomInitTypes["XRPanorama"];
     /**
      * 模式间切换时的过度动画时间
      * @description
      * 单位毫秒
-     * @default `1000`
+     * @default `800`
      */
     modeChangeDuration?: number;
     /**
@@ -1072,6 +1238,30 @@ export declare interface FiveInitArgs {
      * 详见插件部分。
      */
     plugins?: (FivePlugin<void> | FivePluginInit<FivePlugin<any, any>> | FivePluginInit<FivePlugin<void, any>>)[];
+    /**
+     * 是否展示 powered by 如视
+     */
+    poweredByRealsee?: boolean;
+    /**
+     * 是否使用webgl2渲染执行环境, 默认值 false
+     */
+    webgl2?: boolean;
+    /**
+     * 是否开启模型裁切
+     */
+    localClippingEnabled?: boolean;
+    /**
+     * 请求代理
+     * @param url - 发起的请求
+     * @returns 返回的请求
+     */
+    requestProxy?(url: string): string | Promise<string>;
+    /**
+     * 模型lod相关的配置，maxDepth为加载的最大深度
+     */
+    modelLod?: {
+        maxDepth?: number;
+    };
 }
 
 /**
@@ -1116,48 +1306,75 @@ export declare interface FloorplanControllerCustomInitArgs {
     maxFov?: number;
     /** 最小相机可视角度 */
     minFov?: number;
+    /** 鼠标焦点环自定义创建器 */
+    intersectMeshCreator?: () => IntersectMeshInterface;
 }
 
-export declare type GestureTypes = "pan" | "tap" | "pinch" | "mouseWheel";
+export declare type GestureTypes = "pan" | "tap" | "pinch" | "press" | "mouseWheel";
 
 export declare function getViewportScale(): number;
 
-export declare class HashCubeTexture extends THREE_2.CubeTexture {
-    /** 识别哈希 */
-    hash: string;
-}
-
 /**
  * 图片参数
  */
 export declare interface ImageOptions {
-    key?: string;
     /**
      * url 地址转化
      * @param url - 原始地址
      * @param options - 当前地址参数
      * @returns 转化后地址
      */
-    transform?: (url: string, options: ImageOptions) => string;
-    /** 图片尺寸参数 */
+    transform?: (url: string, options: ImageURLOptions) => string;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 512 1024 2048 */
     size?: number;
     /** 图片质量参数(0-100) */
     quality?: number;
-    /** 图片格式参数（jpg, png） */
-    format?: string;
-    /** basis loader 是否初始化完成 */
-    basisLoaderInitialized?: boolean;
-    /** 针对 textureOptions 是否自动通过模型贴图的数量计算需要的模型贴图的尺寸 默认 true */
-    autoResize?: boolean;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    mappings?: ImageURLMappings;
+}
+
+export declare function imageSupport(): Promise<{
+    avif: boolean;
+    webp: boolean;
+}>;
+
+export declare interface ImageURLMappings {
+    [publicDomain: string]: {
+        "pano": [string, string];
+        "tile": [string, string];
+        "texture": [string];
+        "default": [string];
+    };
+}
+
+export declare interface ImageURLOptions {
+    /** 图片类型标识 */
+    key: string;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 256 512 1024 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 图片裁切 */
+    cut?: [x: number, y: number, width: number, height: number];
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    /** url匹配规则 */
+    mappings?: ImageURLMappings;
 }
 
 export declare class InternalWebGLRenderer extends THREE_2.WebGLRenderer {
-    constructor({ preserveDrawingBuffer, backgroundColor, backgroundAlpha, pixelRatio, antialias }: {
+    constructor({ preserveDrawingBuffer, backgroundColor, backgroundAlpha, pixelRatio, antialias, webgl2, }: {
         preserveDrawingBuffer?: boolean;
         backgroundColor?: number | THREE_2.Color;
         backgroundAlpha?: number;
         pixelRatio?: number;
         antialias?: boolean;
+        webgl2?: boolean;
     });
 }
 
@@ -1172,6 +1389,15 @@ export declare interface Intersection {
     distance: number;
 }
 
+export declare class IntersectMesh extends THREE_2.Object3D implements IntersectMeshInterface {
+    private ringMesh;
+    constructor();
+    dispose(): void;
+}
+
+/**
+ * 地面提示点位接口
+ */
 export declare interface IntersectMeshInterface extends THREE_2.Object3D {
     dispose(): void;
 }
@@ -1233,7 +1459,15 @@ export declare type LooseWorkPanorama = {
     front: string;
     back: string;
     video?: LooseWorkVideo;
-    tiles?: string;
+    luminance?: {
+        up: string;
+        down: string;
+        right: string;
+        left: string;
+        front: string;
+        back: string;
+    };
+    tiles?: number[];
 };
 
 export declare type LooseWorkVideo = {
@@ -1242,6 +1476,23 @@ export declare type LooseWorkVideo = {
     size: number[];
 };
 
+export declare interface MapviewControllerCustomInitArgs {
+    /** 默认偏航角 */
+    defaultLongitude?: number;
+    /** 默认俯仰角 */
+    defaultLatitude?: number;
+    /** 默认相机距离 */
+    defaultDistance?: number;
+    /** 最大俯仰角 */
+    maxLatitude?: number;
+    /** 最小俯仰角 */
+    minLatitude?: number;
+    /** 最大相机距离 */
+    maxDistance?: number;
+    /** 最小相机距离 */
+    minDistance?: number;
+}
+
 export declare type Mirror<T extends string> = Record<T, T>;
 
 /**
@@ -1250,6 +1501,7 @@ export declare type Mirror<T extends string> = Record<T, T>;
  * - **Model**: 模型游走模式
  * - **Floorplan**: 模型查看模式
  * - **Topview**: 户型图模式
+ * - **Mapview**: 地图模式
  * - **DepthPanorama**: 深度图游走模式
  * - **VRPanorama**: VR眼镜模式
  */
@@ -1258,6 +1510,8 @@ export declare type Mode =
 "Floorplan" | 
 /** 户型图模式 */
 "Topview" | 
+/** 地图模式 */
+"Mapview" | 
 /** 全景图游走模式 */
 "Panorama" | 
 /** VR眼镜模式 */
@@ -1265,7 +1519,9 @@ export declare type Mode =
 /** 模型游走模式 */
 "Model" | 
 /** 深度图游走模式 */
-"DepthPanorama";
+"DepthPanorama" | 
+/** XR眼镜模式*/
+"XRPanorama";
 
 /**
  * Five 模型
@@ -1275,17 +1531,25 @@ export declare type Mode =
  * 需要满足 your/path/filename.at3d.json_xxxxxx,
  * 通过 json_xxxxxx(<dataURL>) 方式返回。
  */
-export declare class Model extends PBMGroup implements Subscribe<ModelEventType> {
+export declare class Model extends PBMContainer implements Subscribe<ModelEventType> {
     /** 是否加载完成 */
     loaded: boolean;
     /** 是否未加载 */
     empty: boolean;
+    /** WorkCode */
+    workCode: string;
     /** 外接盒子的大小 */
     bounding: THREE_2.Box3;
     /** 当前显示的楼层 */
     shownFloor: number | null;
     /** 楼层的数量 */
     floorLength: number;
+    /** 模型瓦片 */
+    originModel?: PBMContainer;
+    /** 模型瓦片 */
+    tiledModel?: Tile3DModel;
+    /** 材质贴图参数 */
+    textureOptions: TextureOptions;
     /**
      * 判断是否注册了事件
      * 具体可查看 {@link Subscribe.hasListener}
@@ -1312,16 +1576,37 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      */
     emit: SubscribeMixinType.emit<ModelEventType>;
     /** bvh 树的计算结果 */
-    bvhs: any[] & {
-        loaded?: boolean;
+    bvhs: BVH[] & {
+        loaded: boolean;
     };
-    constructor();
+    /** 网络代理 */
+    private requestProxy?;
+    /** 网络跟踪 */
+    private networkSubscribe?;
+    /** 安全域名 */
+    private allowHosts?;
+    private renderer?;
+    constructor(options: {
+        networkSubscribe?: NetworkSubscribe;
+        requestProxy?: (url: string) => string | Promise<string>;
+        allowHosts?: string[];
+    }, renderer?: THREE_2.WebGLRenderer);
     /**
      * 当前显示的楼层
      * @deprecated
      * 请用 shwonFloor 代替
      */
     get shownfloor(): number | null;
+    /**
+     * 当前模型是否支持瓦片
+     */
+    get hasTiles(): boolean;
+    /**
+     * 是否开启瓦片
+     */
+    get enableTiles(): boolean;
+    set enableTiles(enable: boolean);
+    updateTexture(textureOptions: TextureOptions): Promise<void>;
     /**
      * 获取模型边界线
      * @param threshold - 面片间夹角阈值
@@ -1345,7 +1630,9 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      * ```
      */
     show(): void;
-    show(floorIndex: number, hideOpacity?: number): void;
+    show(floorIndex: number, hiddenOpacity?: number): void;
+    private at3dShow;
+    private b3dmShow;
     /**
      * 计算模型射线碰撞检测
      * @param raycaster - THREE 射线对象
@@ -1353,13 +1640,14 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      * @returns 返回碰撞
      */
     intersectRaycaster(raycaster: THREE_2.Raycaster, floors?: number | number[]): Intersection[];
-    buildBVH(): Promise<void>;
+    buildBVH(): void;
     /**
      * 加载模型
      * @param workModel - work 的 model 内容
      * @param imageOptions - 图片参数
      */
-    load(workModel: WorkModel, imageOptions?: ImageOptions): void;
+    load(workModel: WorkModel, textureOptions?: TextureOptions, modelLodOptions?: ModelLodOptions): Promise<void>;
+    update(renderer: THREE_2.WebGLRenderer, camera: Camera): void;
     /**
      * 析构函数
      * @description
@@ -1389,7 +1677,7 @@ export declare type ModelEventType = {
      * 模型 bvh树 计算完成
      * @description
      * bvh 树用于高效的碰撞检测，可以在 `model.bvh` 属性来设置是否开启。默认开启。
-     * bvh 树计算需要一定事件，可能会暂时影响一些性能。计算完毕后，会对碰撞检测带来质的提升。
+     * bvh 树计算需要一定时间，可能会暂时影响一些性能。计算完毕后，会对碰撞检测带来质的提升。
      */
     bvhLoaded(): void;
     /** 模型三角面片结构加载完成 */
@@ -1408,7 +1696,19 @@ export declare type ModelEventType = {
      * @param error - 错误对象
      */
     error(error: Error): void;
-};
+} & Pick<TileEventType, typeof TILE_EVENT[number]>;
+
+export declare interface ModelLodOptions {
+    maxDepth?: number;
+}
+
+export declare interface MotionKeyframe<K extends string> {
+    progress: number;
+    value: MotionValue<K>;
+    key?: string;
+}
+
+export declare type MotionValue<K extends string> = Record<K, number>;
 
 /**
  * 点位移动参数
@@ -1421,9 +1721,10 @@ export declare interface MovePanoOptions extends Partial<Omit<Pose, "offset">> {
      * @description
      * - `fly` 通过相机移动方式变化
      * - `fade` 通过渐变方式变化
+     * - `montage` 通过渐变穿插到黑屏方式变化
      * - `instant` 通过插入黑屏方式变化
      */
-    effect?: "fly" | "fade" | "instant";
+    effect?: "fly" | "fade" | "montage" | "instant";
     /**
      * 运动耗时
      * @description
@@ -1449,21 +1750,180 @@ export declare interface MovePanoOptions extends Partial<Omit<Pose, "offset">> {
     moveCancelCallback?: () => void;
 }
 
+export declare type NetWorkMeta = {
+    origin: string;
+    source: string;
+    headers: {
+        [name: string]: string;
+    };
+    requestTime: number;
+    responseTime: number;
+    costs: number;
+    size?: number;
+};
+
+export declare interface NetworkOptions {
+    /** 超时时间 */
+    timeout?: number;
+    /** 请求代理 */
+    requestProxy?: (url: string) => string | Promise<string>;
+    /** 网络消息追踪 */
+    networkSubscribe?: NetworkSubscribe;
+    /** 安全域名 */
+    allowHosts?: string[];
+}
+
+export declare type NetworkResponse<T = any, E extends NetWorkMeta | NetWorkMeta[] = NetWorkMeta> = {
+    body: T;
+    meta: E;
+};
+
+export declare type NetworkState = "ok" | "preload" | "error" | "proxy-error" | "timeout" | "forbidden";
+
+export declare class NetworkSubscribe extends Subscribe<{
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
+}> {
+}
+
+export declare type NetworkType = "XMLHttpRequest" | "Script" | "Image" | "Link";
+
+export declare class PanoCircleMesh extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    private currentStartTime;
+    private currentMotion;
+    private ringMotion;
+    private tapMotion;
+    private loadingOpacityMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    private disableMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    private panoMesh;
+    constructor(options?: PanoCircleMeshOptions);
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    setLoading(loading: boolean): void;
+    setDisabled(disabled: boolean): void;
+    tap(): Promise<void>;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
+export declare class PanoCircleMeshCustom extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    private currentStartTime;
+    private currentMotion;
+    private tapMotion;
+    private loadingOpacityMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    private disableMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    private panoMesh;
+    constructor(options?: PanoCircleMeshCustomOptions);
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    setLoading(loading: boolean): void;
+    setDisabled(disabled: boolean): void;
+    tap(): Promise<void>;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
+export declare interface PanoCircleMeshCustomOptions {
+    scale?: number;
+    color?: number;
+    map?: THREE_2.Texture;
+    mapAlpha?: number;
+    borderWidth?: number;
+    borderColor?: number;
+    mapUseColor?: boolean;
+    mapUseReverse?: boolean;
+}
+
+/**
+ * 地面提示点位接口
+ *
+ * 点位状态
+ *  1. 默认状态: 无任何操作的情况
+ *  2. 高亮状态: 高亮，认为是合适的下一个点位，或者设备选中了某个点位
+ *  3. 进度状态: 点位加载中，存在进度的情况
+ *  4. 加载状态: 点位加载中，不存在进度的情况
+ *  5. 不可用状态：点位不可用，存在点位，但是点位是个摆设
+ *  6. 点击动画： 点位被选择，触发全景图切换
+ *  7. 透明度改变： 一般会处理为近的点位透明度高，远的点位透明度低
+ */
 export declare interface PanoCircleMeshInterface extends THREE_2.Object3D {
     needsRender: boolean;
+    hitTestMesh?: THREE_2.Mesh;
+    /** 当前高亮 */
+    current: boolean;
+    /** 是否当前高亮 */
+    setCurrent(current: boolean): void;
     loading: boolean;
+    setLoading(loading: boolean): void;
     disabled: boolean;
-    panoIndex: number;
-    setLoading(shown: boolean): void;
     setDisabled(disabled: boolean): void;
+    progress: number;
+    setProgress(progress: number): void;
+    opacity: number;
+    setOpacity(opacity: number): void;
+    updateTime?(time: number, deltaTime: number): void;
+    /** 点击交互 */
+    tap?(): Promise<void>;
+    dispose(): void;
+}
+
+export declare interface PanoCircleMeshOptions {
+    scale?: number;
+    color?: number;
+}
+
+export declare class PanoCircleMeshSolid extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    private currentStartTime;
+    private currentMotion;
+    private tapMotion;
+    private loadingOpacityMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    private disableMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    private panoMesh;
+    constructor(options?: PanoCircleMeshSolidOptions);
     setProgress(progress: number): void;
     setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    setLoading(loading: boolean): void;
+    setDisabled(disabled: boolean): void;
+    tap(): Promise<void>;
+    updateTime(time: number, deltaTime: number): void;
     dispose(): void;
 }
 
+export declare interface PanoCircleMeshSolidOptions {
+    scale?: number;
+    color?: number;
+}
+
 export declare interface PanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
-    /** 自动亮度调整 默认 false */
-    enableLuminanceAdaptiveEffect?: boolean;
     /** 最远可移动观察点距离 */
     maxAccessibleDistance?: number;
     /**
@@ -1474,7 +1934,16 @@ export declare interface PanoramaControllerCustomInitArgs extends PanoramaLikeCo
      */
     panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
-    panoCircleMeshCreator?: () => PanoCircleMeshInterface;
+    panoCircleMeshCreator?: (panoIndex: number) => PanoCircleMeshInterface;
+    /**
+     * 全景瓦片登记
+     * @param fov - 当前 fov
+     * @param viewSize - 当前绘制区域大小
+     * @returns 返回瓦片等级
+     */
+    tileLevelForFov?: false | ((fov: number, viewSize: THREE_2.Vector2) => number);
+    /** 是否开启光照自适应效果 */
+    luminanceAdaptiveEffectEnable?: boolean;
 }
 
 export declare interface PanoramaLikeControllerCustomInitArgs {
@@ -1502,14 +1971,31 @@ export declare interface PanoramaLikeControllerCustomInitArgs {
     intersectMeshCreator?: () => IntersectMeshInterface;
 }
 
-export declare function parseWork(obj: Work | LooseWork | any): Work;
+/**
+ * 解析 Work 数据
+ * @param obj - work 数据，从如数开发者平台获取
+ * @param options - 配置参数， 可以在此二次设置 baseURL 等参数
+ * @param urlTransform - 配置参数， URL 解析规则
+ * @returns - 签署过的 Work 数据结构
+ */
+export declare function parseWork(obj: Work | LooseWork | string | any, options?: ParseWorkOptions, urlTransform?: (origin: string, absolute: string, relative: string, type: "panorama" | "texture" | "model") => void): Work;
+
+export declare type ParseWorkOptions = {
+    /** 重写 work 中的资源前缀 */
+    baseURL?: string;
+    /** work 中的资源地址使用短地址 */
+    shortPath?: boolean;
+    /** work 中的资源使用 jsonp 方式发布 */
+    jsonp?: boolean;
+    /** work 中模型是否计算bvh碰撞数，默认计算 true */
+    modelBvh?: boolean;
+};
 
 /** PBM 模型组 */
-export declare class PBMGroup extends THREE_2.Group {
-    /** 楼层序号 */
-    floorIndex: number;
+export declare class PBMContainer extends THREE_2.Group {
     /** 是否需要更新按需渲染 */
     needsRender: boolean;
+    private enableTransparent;
     /** 获取是否有透明参数 */
     getTransparent(): boolean;
     /** 设置透明参数 */
@@ -1524,39 +2010,41 @@ export declare class PBMGroup extends THREE_2.Group {
     disposeGeometry(): void;
 }
 
+/** PBM 模型组 */
+export declare class PBMGroup extends PBMContainer {
+    /** 楼层序号 */
+    floorIndex: number;
+}
+
 /** PBM 材质 */
 export declare class PBMMaterial extends THREE_2.ShaderMaterial implements PBMParameters {
-    /** 起始点位全景图 */
-    pano0Map: HashCubeTexture | null;
-    /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: HashCubeTexture | null;
-    /** 结束点全景图变换矩阵 4x4 */
-    pano1Matrix: THREE_2.Matrix4;
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
     /** 全景图混合程度 [0-1] */
     progress: number;
     /** 全景图通过过度黑色混合 */
     useBlackTransition: boolean;
-    perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
-    /** 起始点位深度, 需要使用深度参与计算全景图混合的话 */
-    pano0DepthMap: THREE_2.CubeTexture | null;
-    /** 全景视频贴图 */
-    panoVideoMap: THREE_2.VideoTexture | null;
-    /** 全景视频尺寸 */
-    panoVideoSize: THREE_2.Vector2;
-    /** 全景视频贴图变换矩阵 */
-    panoVideoMatrix: THREE_2.Matrix4;
-    /** 全景视频透明度 [0-1] */
-    panoVideoAlpha: number;
-    /** 瓦片材质 */
-    panoTileMap: THREE_2.Texture | null;
-    /** 瓦片寻址规则 */
-    panoTileMappings: THREE_2.Vector4[][] | null;
+    originOpacity: number;
+    /** 楼层参数*/
+    floorIndex: number;
+    /** 楼层切割参数*/
+    floorInfo: THREE_2.Vector3 | null;
+    /** 全局楼层参数*/
+    globalFloorInfo: THREE_2.Vector3[] | null;
+    /** 对外模型裁切参数*/
+    clippers: ClipperParameter | ClipperParameter[] | null;
+    /** 对内模型裁切参数 裁切平面*/
+    clipperPlanesArray: Float32Array | null;
+    /** 对内模型裁切参数 裁切盒关联楼层*/
+    clipperFloors: number[] | null;
+    /** 模型颜色*/
+    modelColorInfo: THREE_2.Vector3 | null;
     constructor(parameters?: Partial<PBMParameters>);
 }
 
@@ -1568,39 +2056,43 @@ export declare class PBMMesh extends THREE_2.Mesh<THREE_2.BufferGeometry, PBMMat
     needsRender: boolean;
 }
 
-/** PBM 材质参数 */
-export declare interface PBMParameters {
+export declare interface PBMPanoPicture {
     /** 起始点位全景图 */
-    pano0Map: HashCubeTexture | null;
+    map: THREE_2.CubeTexture | TileCubeTextureTarget;
+    /** 亮度增益 */
+    luminanceMap: null | THREE_2.CubeTexture | TileCubeTextureTarget;
     /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: HashCubeTexture | null;
-    /** 结束点位全景图变换矩阵 */
-    pano1Matrix: THREE_2.Matrix4;
+    matrix: THREE_2.Matrix4;
+}
+
+/** PBM 材质参数 */
+export declare interface PBMParameters {
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
     /** 全景图混合程度 [0-1] */
     progress: number;
     /** 全景图通过过度黑色混合 */
     useBlackTransition: boolean;
-    perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
-    /** 起始点位深度, 需要使用深度参与计算全景图混合的话 */
-    pano0DepthMap: THREE_2.CubeTexture | null;
-    /** 全景视频贴图 */
-    panoVideoMap: THREE_2.VideoTexture | null;
-    /** 全景视频尺寸 */
-    panoVideoSize: THREE_2.Vector2;
-    /** 全景视频贴图变换矩阵 */
-    panoVideoMatrix: THREE_2.Matrix4;
-    /** 全景视频透明度 [0-1] */
-    panoVideoAlpha: number;
-    /** 瓦片材质 */
-    panoTileMap: THREE_2.Texture | null;
-    /** 瓦片寻址规则 */
-    panoTileMappings: THREE_2.Vector4[][] | null;
+    /** 整体楼层信息*/
+    globalFloorInfo?: THREE_2.Vector3[] | null;
+    /** 楼层参数*/
+    floorIndex: number;
+    /** 楼层切割参数*/
+    floorInfo?: THREE_2.Vector3 | null;
+    /** 模型裁切参数（工程侧调用）*/
+    clippers?: ClipperParameter | ClipperParameter[] | null;
+    /** 模型裁切平面参数（内部调用） */
+    clipperPlanesArray?: Float32Array | null;
+    /** 模型裁切平面参数（内部调用） */
+    clipperFloors?: number[] | null;
+    /** 模型颜色*/
+    modelColorInfo?: THREE_2.Vector3 | null;
 }
 
 /**
@@ -1608,17 +2100,19 @@ export declare interface PBMParameters {
  * [[include: coordinate.md]]
  */
 export declare interface Pose {
-    /** 相机俯仰角 */
-    longitude: number;
     /** 相机偏航角 */
+    longitude: number;
+    /** 相机俯仰角 */
     latitude: number;
     /** 相机可视角度（垂直）*/
     fov: number;
     /** 相机位置*/
     offset: THREE_2.Vector3;
+    /** 相机距离 */
+    distance: number;
 }
 
-export declare const PROXY_CONTROLLER_EVENT_NAMES: readonly ["cameraDirectionUpdate", "cameraUpdate", "cameraPositionUpdate", "panoSelected", "moveToPano", "moveToPanoCanceled", "panoWillArrive", "movingToPano", "panoArrived", "panoWillLoad", "panoLoaded", "panoLoadError", "initAnimationEnded", "initAnimationWillStart", "wantsGesture", "gesture", "wantsTapGesture", "tapGesture", "wantsPanGesture", "wantsInteriaPan", "panGesture", "interiaPan", "wantsPinchGesture", "pinchGesture", "wantsMouseWheel", "mouseWheel", "wantsShowIntersectionOnModel", "intersectionOnModelUpdate", "intersectionHidden", "textureStartLoad", "textureLoading", "textureAbort", "textureLoaded", "textureError"];
+export declare const PROXY_CONTROLLER_EVENT_NAMES: readonly ["cameraDirectionUpdate", "cameraUpdate", "cameraPositionUpdate", "panoSelected", "moveToPano", "moveToPanoCanceled", "panoWillArrive", "movingToPano", "panoArrived", "panoWillLoad", "panoLoaded", "panoLoadError", "initAnimationEnded", "initAnimationWillStart", "wantsGesture", "gesture", "wantsTapGesture", "tapGesture", "wantsPressGesture", "pressGesture", "wantsPanGesture", "wantsInteriaPan", "panGesture", "interiaPan", "wantsPinchGesture", "pinchGesture", "wantsMouseWheel", "mouseWheel", "wantsShowIntersectionOnModel", "intersectionOnModelUpdate", "intersectionHidden", "textureStartLoad", "textureLoading", "textureAbort", "textureLoaded", "textureError", "webXRSessionStart", "webXRSessionEnd", "webXRControllerEvent"];
 
 /** Five 场景*/
 export declare class Scene extends THREE_2.Scene {
@@ -1660,8 +2154,6 @@ export declare interface State extends Pose {
     panoIndex: number;
 }
 
-export declare function stringifyWork(work: Work): LooseWork;
-
 /**
  * 监听者模式
  * @template T - 预设的监听回调类型
@@ -1740,69 +2232,754 @@ export declare namespace SubscribeMixinType {
     }
 }
 
-export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
+export declare class TextureLoader {
+    private timeout?;
+    private allowHosts?;
+    private requestProxy?;
+    private networkSubscribe?;
+    constructor(options: NetworkOptions);
+    setAllowHosts(allowHosts: string[]): void;
+    setRequestProxy(requestProxy: (url: string) => string): void;
+    setNetworkSubscribe(networkSubscribe: NetworkSubscribe): void;
+    loadTexture(source: string, options?: {
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        flipY?: boolean;
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+        maxSize?: THREE_2.Vector2;
+        viaAjax?: boolean;
+    }, onLoad?: (response: NetworkResponse<THREE_2.Texture>) => void, onError?: (error: Error) => void, onProgress?: (percent: number) => void, renderer?: THREE_2.WebGLRenderer): Promise<NetworkResponse<THREE_2.Texture>>;
+    loadCubeTexture(sources: WorkCubeImage, options: {
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+        viaAjax?: boolean;
+    }, onLoad: (response: NetworkResponse<THREE_2.CubeTexture, NetWorkMeta[]>) => void, onError: (error: Error) => void, onProgress: (percent: number) => void, renderer: THREE_2.WebGLRenderer): Promise<NetworkResponse<THREE_2.CubeTexture, NetWorkMeta[]>>;
+    loadTiledCubeTexture(sources: WorkCubeImage, tileSources: WorkTile[], options: {
+        tileImageSize?: number;
+        tileMaxLevel?: number;
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+        viaAjax?: boolean;
+    }, onLoad: (response: NetworkResponse<TileCubeTextureTarget, NetWorkMeta[]>) => void, onError: (error: Error) => void, onProgress: (percent: number) => void, renderer: THREE_2.WebGLRenderer): Promise<NetworkResponse<TileCubeTextureTarget, NetWorkMeta[]>>;
 }
 
-export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+/**
+ * 图片参数
+ */
+export declare interface TextureOptions {
     /**
-     * webvrPolyfill 的设置对象
-     * @description
-     * 只可被设置一次，所有的 five 实例共用这个设置
+     * url 地址转化
+     * @param url - 原始地址
+     * @param options - 当前地址参数
+     * @returns 转化后地址
      */
-    webvrPolyfillConfig?: any;
+    transform?: (url: string, options: ImageURLOptions) => string;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 256 512 1024 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 针对 textureOptions 是否自动通过模型贴图的数量计算需要的模型贴图的尺寸 默认 true */
+    autoResize?: boolean;
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    mappings?: ImageURLMappings;
+}
+
+/**
+ * A Tile3DHeader represents a tile as Tileset3D. When a tile is first created, its content is not loaded;
+ * the content is loaded on-demand when needed based on the view.
+ * Do not construct this directly, instead access tiles through {@link Tileset3D#tileVisible}.
+ */
+export declare class Tile3D {
+    cacheNode?: TileCacheNode<Tile3D>;
+    tileset: Tileset3D;
+    header: TilesetJSONNode;
+    content?: TileContent;
+    parent?: Tile3D;
+    boundingVolume: TileOrientedBoundingBox;
+    contentState: "UNLOADED" | "LOADING" | "PROCESSING" | "READY" | "FAILED";
+    children: Tile3D[];
+    depth: number;
+    selectionDepth: number;
+    transform: Matrix4;
+    computedTransform: Matrix4;
+    frameNumber: number;
+    touchedFrameNumber: number;
+    requestedFrameNumber: number;
+    selectedFrameNumber: number;
+    distanceToCamera: number;
+    centerZDepth: number;
+    screenSpaceError: number;
+    visibilityPlaneMask: number;
+    visible: boolean;
+    shouldRefine: boolean;
+    /**
+     * @constructs
+     * Create a TileHeader instance
+     * @param tileset - Tileset3D instance
+     * @param header - tile header - JSON loaded from a dataset
+     * @param parentHeader - parent TileHeader instance
+     */
+    constructor(tileset: Tileset3D, header: TilesetJSONNode, parentHeader?: Tile3D);
+    get id(): string;
+    get refine(): "REPLACE" | "ADD";
+    get type(): "EMPTY" | "SCENEGRAPH" | "MESH";
+    get contentUrl(): string;
+    get siblingIndex(): number;
+    get lodMetricType(): "geometricError";
+    get lodMetricValue(): number;
+    get hasEmptyContent(): boolean;
+    get selected(): boolean;
+    /** Returns true if tile is not an empty tile and not an external tileset */
+    get hasRenderContent(): boolean;
+    /** Returns true if tile has children */
+    get hasChildren(): boolean;
+    /**
+     * Determines if the tile's content is ready. This is automatically `true` for
+     * tiles with empty content.
+     */
+    get contentReady(): boolean;
+    /**
+     * Determines if the tile has available content to render.  `true` if the tile's
+     * content is ready or if it has expired content this renders while new content loads; otherwise,
+     */
+    get contentAvailable(): boolean;
+    /** Returns true if tile has renderable content but it's unloaded */
+    get hasUnloadedContent(): boolean;
+    /**
+     * Determines if the tile's content has not be requested. `true` if tile's
+     * content has not be requested; otherwise, `false`.
+     */
+    get contentUnloaded(): boolean;
+    get contentFailed(): boolean;
+    /** Get the tile's screen space error. */
+    getScreenSpaceError(frameState: TileFrameState, useParentLodMetric: boolean): number;
+    private getPriority;
+    /**
+     *  Requests the tile's content.
+     * The request may not be made if the Request Scheduler can't prioritize it.
+     */
+    loadContent(): Promise<boolean>;
+    unloadContent(): void;
+    /**
+     * Update the tile's visibility
+     */
+    updateVisibility(frameState: TileFrameState): void;
+    private visibility;
+    /**
+     * Computes the (potentially approximate) distance from the closest point of the tile's bounding volume to the camera.
+     * @param frameState - The frame state.
+     * @returns The distance, in meters, or zero if the camera is inside the bounding volume.
+     */
+    private distanceToTile;
+    private updateTransform;
+}
+
+export declare class Tile3DModel extends PBMContainer {
+    tileset?: Tileset3D;
+    private options;
+    private nodeGroup;
+    private boundingGroup;
+    private nodes;
+    private boundings;
+    private unloadTileQueue;
+    private timer;
+    private clock;
+    private lastCameraTransform;
+    private lastCameraAspect;
+    private lastCameraFov;
+    private sseDenominator;
+    private lastCamera;
+    private lastRenderer;
+    private enabled;
+    listener: Subscribe<TileEventType>;
+    private basicTiles;
+    private parseTask;
+    private originModel;
+    private renderer?;
+    constructor(loaderOptions: Partial<Tile3DModelLoaderOptions>, originModel: PBMContainer, renderer?: THREE_2.WebGLRenderer);
+    get enable(): boolean;
+    set enable(value: boolean);
+    load(url: WorkModelTiles): void;
+    update(renderer: THREE_2.WebGLRenderer, camera: Camera): void;
+    private tilesetUpdate;
+    reset(): void;
 }
 
-export declare type Work = {
-    uuid: string;
+/** Advanced loader options */
+export declare interface Tile3DModelLoaderOptions {
+    updateInterval: number;
+    maxMemoryUsage: number;
+    maxScreenSpaceError: number;
+    viewDistanceScale: number;
+    throttleRequests: boolean;
+    maxRequests: number;
+    onNodeCreated: (node: PBMGroup) => void;
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+    maxDepth: number;
+}
+
+export declare const TILE_EVENT: readonly ["tileTextureUpload", "basicTileLoaded"];
+
+export declare class TileBoundingSphere {
+    center: Vector3;
+    radius: number;
+    constructor(center?: number[], radius?: number);
+    fromCenterRadius(center: number[], radius: number): this;
+    fromCornerPoints(corner: number[], oppositeCorner: number[]): this;
+    equals(right: TileBoundingSphere): boolean;
+    clone(): TileBoundingSphere;
+    union(boundingSphere: TileBoundingSphere): TileBoundingSphere;
+    expand(point: number[]): this;
+    transform(transform: Matrix4): this;
+    distanceSquaredTo(point: number[]): number;
+    distanceTo(point: number[]): number;
+    intersectPlane(plane: Plane): 0 | 1 | -1;
+}
+
+export declare interface TileBoundingVolume {
+    /**
+     * Applies a 4x4 affine transformation matrix to a bounding sphere.
+     * @param sphere - The bounding sphere to apply the transformation to.
+     * @param transform - The transformation matrix to apply to the bounding sphere.
+     * @returns itself, i.e. the modified BoundingVolume.
+     */
+    transform(transform: readonly number[]): this;
+    /** Computes the estimated distance squared from the closest point on a bounding sphere to a point. */
+    distanceSquaredTo(point: readonly number[]): number;
+    /** Computes the estimated distance from the closest point on a bounding sphere to a point. */
+    distanceTo(point: readonly number[]): number;
+    /**
+     * Determines which side of a plane the oriented bounding box is located.
+     *
+     * @param plane - The plane to test against.
+     * @returns
+     *  - `INTERSECTION.INSIDE` if the entire box is on the side of the plane the normal is pointing.
+     *  - `INTERSECTION.OUTSIDE` if the entire box is on the opposite side.
+     *  - `INTERSECTION.INTERSECTING` if the box intersects the plane.
+     */
+    intersectPlane(plane: Plane): number;
+}
+
+export declare class TileCacheNode<T> {
+    item: T;
+    previous: TileCacheNode<T> | null;
+    next: TileCacheNode<T> | null;
+    constructor(item: T, previous: TileCacheNode<T> | null, next: TileCacheNode<T> | null);
+}
+
+export declare interface TileContent {
+    version: 1;
+    magic: number;
+    byteLength: number;
+    header: {
+        featureTableJsonByteLength: number;
+        featureTableBinaryByteLength: number;
+        batchTableJsonByteLength: number;
+        batchTableBinaryByteLength: number;
+        batchLength: number;
+    };
+    featureTableJson: Record<string, any>;
+    featureTableBinary: Uint8Array;
+    batchTableJson: Record<string, any>;
+    batchTableBinary: Uint8Array;
+    rotateYtoZ: boolean;
+    gltfUpAxis: "X" | "Y" | "Z";
+    gltfArrayBuffer: ArrayBuffer;
+    gltfByteOffset: number;
+    gltfByteLength: number;
+    rtcCenter?: Float32Array;
+}
+
+export declare interface TileCubeNode {
+    level: number;
+    face: "up" | "down" | "left" | "right" | "front" | "back";
+    position: THREE_2.Vector2;
+    size: number;
+    box: THREE_2.Box3;
+    children: TileCubeNode[];
+}
+
+export declare class TileCubeTextureTarget {
+    private tileTree;
+    private tileSources;
+    private options;
+    private renderer;
+    name: string;
+    needsRender: boolean;
+    private disposed;
+    private loadedCubeNodes;
+    private loadingCubeNodes;
+    private baseCubeTexture;
+    private _cubeRenderTarget;
+    private textures;
+    constructor(baseCubeTexture: THREE_2.CubeTexture, tileTree: TileCubeTree, tileSources: WorkTile[], options: {
+        textureSize: number;
+        tileImageSize: number;
+        textureLoader: TextureLoader;
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+    }, renderer: THREE_2.WebGLRenderer);
+    get cubeRenderTarget(): THREE_2.WebGLCubeRenderTarget | null;
+    set cubeRenderTarget(cubeRenderTarget: THREE_2.WebGLCubeRenderTarget | null);
+    private requestTile;
+    update(frustum: THREE_2.Frustum, level: number): void;
+    get tilePending(): number;
+    get texture(): THREE_2.Texture;
+    dispose(): void;
+}
+
+export declare interface TileCubeTree {
+    children: TileCubeNode[];
+}
+
+export declare class TileCullingVolume {
+    static get MASK_OUTSIDE(): number;
+    static get MASK_INSIDE(): number;
+    static get MASK_INDETERMINATE(): number;
+    planes: Plane[];
+    constructor(planes?: Plane[]);
+    fromBoundingSphere(boundingSphere: {
+        center: Vector3;
+        radius: number;
+    }): this;
+    computeVisibilityWithPlaneMask(boundingVolume: TileBoundingVolume, parentPlaneMask: number): number;
+}
+
+export declare type TileEventType = {
+    /**
+     * 最低级的瓦片加载（全局）
+     */
+    basicTileLoaded(): void;
+    /**
+     * 瓦片材质上传
+     */
+    tileTextureUpload(id: any): void;
+};
+
+export declare type TileFrameState = {
+    camera: {
+        position: number[];
+        direction: number[];
+        up: number[];
+    };
+    height: number;
+    cullingVolume: TileCullingVolume;
+    frameNumber: number;
+    sseDenominator: number;
+};
+
+export declare class TileOrientedBoundingBox {
+    center: Vector3;
+    halfAxes: Matrix3;
+    constructor(center?: number[], halfAxes?: number[]);
+    clone(): TileOrientedBoundingBox;
+    equals(right: TileOrientedBoundingBox): boolean;
+    getBoundingSphere(result?: TileBoundingSphere): TileBoundingSphere;
+    intersectPlane(plane: Plane): 0 | 1 | -1;
+    distanceTo(point: number[]): number;
+    distanceSquaredTo(point: number[]): number;
+    computePlaneDistances(position: Vector3, direction: Vector3, result?: number[]): number[];
+    transform(transformation: number[]): this;
+}
+
+/** Tracks one request */
+export declare type TileRequest<Identiy> = {
+    identiy: Identiy;
+    priority: number;
+    getPriority: (identiy: Identiy) => number;
+    resolve: (requestResult: TileRequestResult) => void;
+};
+
+export declare type TileRequestResult = null | {
+    done: () => void;
+};
+
+/**
+ * Used to issue a request, without having them "deeply queued" by the browser.
+ * @todo - Track requests globally, across multiple servers
+ */
+export declare class TileRequestScheduler<Identiy> {
+    private props;
+    private activeRequestCount;
+    /** Tracks the number of active requests and prioritizes/cancels queued requests. */
+    private requestQueue;
+    private requestMap;
+    private deferred;
+    constructor(props?: TileRequestSchedulerOptions);
+    /**
+     * Called by an application that wants to issue a request, without having it deeply queued by the browser
+     *
+     * When the returned promise resolved, it is OK for the application to issue a request.
+     * The promise resolves to an object that contains a `done` method.
+     * When the application's request has completed (or failed), the application must call the `done` function
+     *
+     * @param identiy - Identiy
+     * @param getPriority - will be called when request "slots" open up, allowing the caller to update priority or cancel the request Highest priority executes first, priority less than 0 cancels the request
+     * @returns a promise resolves to a object (with a `done` field) when the request can be issued without queueing, resolves to `null` if the request has been cancelled (by the callback return less than 0). In this case the application should not issue the request
+     */
+    scheduleRequest(identiy: Identiy, getPriority?: (identiy: Identiy) => number): Promise<TileRequestResult>;
+    private issueRequest;
+    /** We check requests asynchronously, to prevent multiple updates */
+    private issueNewRequests;
+    /** Refresh all requests  */
+    private issueNewRequestsAsync;
+    /** Ensure all requests have updated priorities, and that no longer valid requests are cancelled */
+    private updateAllRequests;
+    /** Update a single request by calling the callback */
+    private updateRequest;
+}
+
+/** RequestScheduler Options */
+export declare type TileRequestSchedulerOptions = {
+    throttleRequests?: boolean;
+    maxRequests?: number;
+};
+
+export declare class Tileset3D {
+    rawJson: any;
+    options: Tileset3dOptions;
+    root: Tile3D;
+    traverser: Tileset3DTraverser;
+    cache: TilesetCache;
+    requestScheduler: TileRequestScheduler<string>;
+    selectedTiles: Tile3D[];
+    requestedTiles: Tile3D[];
+    memoryUsageInBytes: number;
+    frameNumber: number;
+    private _tiles;
+    private pendingCount;
+    b3dmMapping: TilesetJSON['b3dmMapping'];
+    /**
+     * Create a new Tileset3D
+     * @param json - TilesetJSON
+     * @param options - Tileset3dOptions
+     */
+    constructor(json: TilesetJSON, options: Tileset3dOptions);
+    get maxMemoryUsage(): number;
+    get asset(): any;
+    get type(): any;
+    get basePath(): any;
+    get modelMatrix(): Matrix4;
+    get geometricError(): number;
+    get lodMetricType(): number;
+    get lodMetricValue(): number;
+    get refine(): 'ADD' | "REPLACE";
+    get tiles(): Tile3D[];
+    get floorInfo(): TilesetJSON['floorInfo'];
+    /** Release resources */
+    reset(): void;
+    /** Is the tileset loaded (update needs to have been called at least once) */
+    isLoaded(): boolean;
+    /**
+     * The callback to post-process tiles after traversal procedure
+     * @param frameState - frame state for tile culling
+     */
+    private onTraversalEnd;
+    loadTile(tile: Tile3D): void;
+    unloadTile(tile: Tile3D): void;
+}
+
+export declare interface Tileset3dOptions {
+    throttleRequests: boolean;
+    maxRequests: number;
+    maxMemoryUsage: number;
+    modelMatrix: Matrix4;
+    maxScreenSpaceError: number;
+    viewDistanceScale: number;
+    onTileLoad: (tile: Tile3D) => any;
+    onTileUnload: (tile: Tile3D) => any;
+    onTileError: (tile: Tile3D, message: string) => any;
+    contentLoader: (tile: Tile3D) => Promise<void> | undefined;
+    onTraversalComplete: (selectedTiles: Tile3D[]) => Tile3D[];
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+    maxDepth: number;
+}
+
+export declare class Tileset3DTraverser {
+    root: Tile3D | null;
+    options: TilesetTraverserProps;
+    requestedTiles: Record<string, Tile3D>;
+    selectedTiles: Record<string, Tile3D>;
+    emptyTiles: Record<string, Tile3D>;
+    private _traversalStack;
+    private _emptyTraversalStack;
+    private _frameNumber;
+    private maxDepth;
+    constructor(options: TilesetTraverserProps);
+    traverse(root: Tile3D, frameState: TileFrameState): void;
+    reset(): void;
+    private executeTraversal;
+    private updateChildTiles;
+    private updateAndPushChildren;
+    updateTile(tile: Tile3D, frameState: TileFrameState): void;
+    selectTile(tile: Tile3D, frameState: TileFrameState): void;
+    loadTile(tile: Tile3D, frameNumber: number): void;
+    touchTile(tile: Tile3D, frameState: TileFrameState): void;
+    private canTraverse;
+    private shouldLoadTile;
+    private shouldSelectTile;
+    private shouldRefine;
+    private updateTileVisibility;
+    private meetsScreenSpaceErrorEarly;
+    private compareDistanceToCamera;
+    private anyChildrenVisible;
+    private executeEmptyTraversal;
+}
+
+export declare class TilesetCache {
+    private list;
+    private sentinel;
+    constructor();
+    reset(): void;
+    touch(tile: Tile3D): void;
+    add(tile: Tile3D, addCallback?: (tile: Tile3D) => void): void;
+    unloadTile(tile: Tile3D, unloadCallback?: (tile: Tile3D) => void): void;
+    unloadTiles(isOverMemory: () => boolean, unloadCallback?: (tile: Tile3D) => void): void;
+}
+
+export declare interface TilesetJSON {
+    asset: {
+        gltfUpAxis: "X" | "Y" | "Z";
+        version: "1.0";
+    };
+    basePath: string;
+    lodMetricType: "geometricError";
+    geometricError: number;
+    lodMetricValue: number;
+    root: TilesetJSONNode;
+    type: "TILES3D";
+    floorInfo: {
+        ground: number;
+        height: number;
+    }[];
+    b3dmMapping: {
+        b3dm_base_url: string;
+        b3dm_url: Record<string, string>;
+    };
+}
+
+export declare interface TilesetJSONNode {
+    boundingVolume: {
+        box: number[];
+    };
+    content: {
+        uri: string;
+    };
+    id: string;
+    transform?: number[];
+    contentUrl?: string;
+    children: TilesetJSONNode[];
+    lodMetricType: "geometricError";
+    geometricError: number;
+    lodMetricValue: number;
+    refine: "REPLACE" | "ADD";
+    type: "EMPTY" | "SCENEGRAPH" | "MESH";
+}
+
+export declare type TilesetTraverserProps = {
+    loadSiblings: boolean;
+    skipLevelOfDetail: boolean;
+    maxScreenSpaceError: number;
+    maxDepth: number;
+    onTraversalEnd: (frameState: TileFrameState) => any;
+};
+
+export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
+}
+
+export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+
+export declare type WebXRControllerKey = 'A' | 'B' | 'X' | 'Y' | 'RightTrigger' | 'RightPinch' | 'LeftTrigger' | 'LeftPinch' | 'LeftAxesLeft' | 'LeftAxesRight' | 'LeftAxesUp' | 'LeftAxesDown' | 'RightAxesLeft' | 'RightAxesRight' | 'RightAxesUp' | 'RightAxesDown';
+
+export declare interface WebXRControllerParams {
+    raycaster: THREE_2.Raycaster[];
+}
+
+export declare type WebXRControllerType = 'tap' | 'press';
+
+export declare type WebXREventTypes = {
+    /** WebXR模式开始，session完成坐标系设置*/
+    webXRSessionStart(): void;
+    /** WebXR模式结束，销毁session*/
+    webXRSessionEnd(): void;
+};
+
+export declare class Work {
+    /** 名称 */
+    name: string;
+    /** 编号 */
+    workCode: string;
+    /** 允许访问的安全域名 */
+    allowHosts: string[];
+    /** 过期时间 */
+    expire: Date;
+    /** 初始化参数 */
     initial: WorkInitial;
+    /** 模型参数 */
     model?: WorkModel;
+    /** 全景点位信息 */
     observers: WorkObserver[];
-};
+    /** 包围盒子 */
+    boundingBox: THREE_2.Box3;
+    /** 数据签发人 */
+    issuer: string;
+    /** 原始数据 */
+    raw: {
+        works: string[];
+        options: string;
+    };
+    /**
+     * 解析 Work 数据
+     * @param obj - work 数据，从如数开发者平台获取
+     * @param options - 配置参数， 可以在此二次设置 baseURL 等参数
+     * @param urlTransform - 配置参数， URL 解析规则
+     * @returns - 签署过的 Work 数据结构
+     */
+    static parse: typeof parseWork;
+    constructor();
+    toJSON(): any;
+}
 
-/** 全景图 */
-export declare type WorkImages = {
+export declare interface WorkCubeImage {
+    /** 全景图 up */
     up: string;
+    /** 全景图 down */
     down: string;
+    /** 全景图 right */
     right: string;
+    /** 全景图 left */
     left: string;
+    /** 全景图 front */
     front: string;
+    /** 全景图 back */
     back: string;
+}
+
+/** 全景图 */
+export declare interface WorkImage extends WorkCubeImage {
+    /** 深度图 */
     depth?: string;
-    tiles?: string;
-};
+    /** 光照强度图 */
+    luminance?: WorkCubeImage;
+    /** 瓦片信息 */
+    tiles?: WorkTile[];
+}
 
 /** 初始化位姿参数 */
-export declare type WorkInitial = Omit<State, "offset">;
+export declare interface WorkInitial extends Omit<State, "offset" | "distance"> {
+}
 
 /** 模型数据 */
-export declare type WorkModel = {
+export declare interface WorkModel {
+    /** 模型文件地址 at3d / domez */
     file: string;
+    /** 模型贴图文件地址 */
     textures: string[];
+    /** 模型贴图文件地址的父目录 */
     textureBase: string;
+    /** 是否开启 bvh 碰撞树，开启会大大加快射线碰撞的执行效率 */
     bvh: boolean;
-    async: boolean;
-};
+    tiles?: WorkModelTiles;
+    maxDepth?: number;
+}
+
+/** 模型瓦片 */
+export declare interface WorkModelTiles {
+    tileset_url: string;
+    tileset_url_md5: string;
+    b3md_mappings_url: string;
+    b3md_mappings_url_md5: string;
+}
 
 /** 每个点位的数据 */
-export declare type WorkObserver = {
+export declare interface WorkObserver {
+    /** 点位序号 */
     panoIndex: number;
+    /** 点位是否激活可用 */
     active: boolean;
+    /** 点位是否可加载 */
     loadable: boolean;
-    images: WorkImages;
+    /** 点位全景图 */
+    images: WorkImage;
+    /** 点位视频 */
     video?: WorkVideo;
+    /** 可以看到的相关点位序号 */
     visibleNodes: number[];
+    /** 可以连通的相关点位序号 */
     accessibleNodes: number[];
+    /** 点位和模型的旋转对齐关系四元数 */
     quaternion: THREE_2.Quaternion;
+    /** 点位和模型的地面位置坐标关系 */
     standingPosition: THREE_2.Vector3;
+    /** 点位和模型的观察点坐标关系 */
     position: THREE_2.Vector3;
+    /** 点位所在楼层 */
     floorIndex: number;
-};
+    /** 点位 derived_id */
+    derivedId?: number;
+}
+
+export declare interface WorkTile {
+    level: number;
+    size: number;
+    up: string;
+    down: string;
+    right: string;
+    left: string;
+    front: string;
+    back: string;
+}
 
 /** 全景视频贴片 */
-export declare type WorkVideo = {
+export declare interface WorkVideo {
+    /** 视频源 url */
     source: string;
+    /** 视频源变化矩阵 */
     matrix: THREE_2.Matrix4;
+    /** 视频源长宽尺寸 */
     size: THREE_2.Vector2;
-};
+}
+
+export declare class XRButton {
+    static createButton(onClickHook: () => void): HTMLAnchorElement | HTMLButtonElement;
+}
+
+export declare interface XRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
 
 export { }