@realsee/five 5.0.0-alpha.12 → 5.0.0-alpha.120

package/{index.d.ts → five/index.d.ts}

@@ -1,7 +1,117 @@
-/// <reference types="hammerjs" />
-
 import * as THREE_2 from 'three';
 
+export declare interface AddableObject extends THREE_2.Object3D {
+    needsRender?: boolean;
+    mixer?: THREE_2.AnimationMixer;
+    setResolution?(width: number, height: number): void;
+}
+
+export declare interface AnimationFrame {
+    callback: (time: number, deltaTime: number) => void;
+    once: boolean;
+    delay: number;
+    order: number;
+}
+
+export declare class AnimationFrameLoop {
+    private frames;
+    private time;
+    private stoped;
+    private static sharedInstance?;
+    static get shared(): AnimationFrameLoop;
+    static getFrameTime(): number;
+    constructor();
+    private loop;
+    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 {
+    /** 相机姿态 */
+    pose: CameraPose;
+    constructor(fov: number);
+    /** 通过相机参数反算姿态 */
+    computePose(): this;
+    /** 设置相机姿态 */
+    setFromPose(pose: Partial<CameraPose>): this;
+    /** 拷贝相机姿态 */
+    copyPose(): CameraPose;
+}
+
+export declare interface CameraPose {
+    longitude: number;
+    latitude: number;
+    fov: number;
+    distance: number;
+    offset: THREE_2.Vector3;
+}
+
 export declare type ControllerCustomInitTypes = {
     Floorplan: FloorplanControllerCustomInitArgs;
     Topview: TopviewControllerCustomInitArgs;
@@ -62,7 +172,7 @@ export declare type ControllerEventTypes = {
      * 观察点位被选择
      * @param panoIndex - 选择的点位
      */
-    panoSelected(panoIndex: number): void;
+    panoSelected(panoIndex: number | null): void;
     /**
      * 意图要移动到某个点位 可以通过 `return false` 阻止
      * @param panoIndex - 图要移动到的点位下标
@@ -142,6 +252,7 @@ export declare type ControllerEventTypes = {
     wantsGesture(type: GestureTypes, pointers: {
         x: number;
         y: number;
+        delta?: number;
     }[], final: boolean): void | false;
     /**
      * 手势 触发
@@ -152,6 +263,7 @@ export declare type ControllerEventTypes = {
     gesture(type: GestureTypes, pointers: {
         x: number;
         y: number;
+        delta?: number;
     }[], final: boolean): void;
     /**
      * 意图要触发 pan 手势(滑动屏幕)， 可以通过 `return false` 阻止
@@ -183,15 +295,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 - 缩放数值
@@ -200,6 +314,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 - 缩放数值
@@ -269,7 +400,7 @@ 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 - 抛出错误
@@ -277,72 +408,28 @@ export declare type ControllerEventTypes = {
     error(error: Error): 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;
 }
 
-/**
- * 动画变化曲线
- */
-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
@@ -363,7 +450,7 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      */
     error(error: Error): void;
     /**
-     * 开始加载 Work 数据
+     * 准备加载 Work 数据
      * @param input - 输入的 work
      * @param work - 归一化的标准 work
      * @param state - 加载时的姿态
@@ -376,6 +463,12 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      * @param state - 加载时的姿态
      */
     load(input: any, work: Work, state: Omit<State, "offset">): void;
+    /**
+     * 加载完 Work 数据
+     * @param input - 输入的 work
+     * @param work - 归一化的标准 work
+     */
+    loaded(input: any, work: Work): void;
     /**
      * 模型开始加载
      * @param workModel - 归一化的标准 work 中的 model 值
@@ -410,8 +503,16 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      * @param model - 加载完的 model 本质是一个 {@link PBMGroup}
      */
     modelLoaded(model: Model): void;
-    /** 每帧渲染完成 */
-    renderFrame(): void;
+    /**
+     * 模型楼层切换
+     * @param shownFloor - 模型楼层
+     */
+    modelShownFloorChange(shownFloor: number | null, totalFloorLength: number): void;
+    /**
+     * 渲染循环
+     * @param rendered - 是否渲染了
+     */
+    renderFrame(rendered: boolean): void;
     /**
      * 当前 fps 变化
      * @param fps - 当前刷新率
@@ -471,6 +572,18 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      * @param toPose - 初始化动画结束后的状态
      */
     modeChange(mode: Mode, prevMode: Mode, panoIndex: number, toPose: Pose): 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;
 };
@@ -502,64 +615,11 @@ export declare class Five extends Subscribe<EventTypes> {
      * ```
      */
     static Mode: Mirror<Mode>;
-    /** Five 线条*/
-    static FiveLine: typeof FiveLine;
-    /** 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;
-        };
-    };
+    /**
+     * @deprecated
+     * 请使用 `import { Line } from "@realsee/five/line"` 代替;
+     */
+    static Line: any;
     /**
      * 自动播放状态是否暂停
      * @description
@@ -571,9 +631,9 @@ export declare class Five extends Subscribe<EventTypes> {
     /** 当前展示的模式 */
     currentMode?: Mode;
     /** 内部使用的 `THREE.Scene` */
-    scene: FiveScene;
+    scene: Scene;
     /** 内部使用的 `Camera` */
-    camera: FiveCamera;
+    camera: Camera;
     /**
      * 当前设置的 `scissor`
      * @description
@@ -592,11 +652,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
@@ -617,7 +675,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
      * 平衡加载时间和图片质量
      */
-    textureOptions: ImageOptions;
+    textureOptions: TextureOptions;
     /**
      * 模型贴图的配置参数
      * @description
@@ -648,20 +706,34 @@ export declare class Five extends Subscribe<EventTypes> {
     plugins: {
         [key: string]: FivePluginInstance<any>;
     };
-    private ident;
+    ident: string;
+    private stopAnimationLoop?;
+    private fps;
+    private helperGroup;
     private modeChangeDuration;
     private onlyRenderIfNeeds;
-    private maxFps;
+    private poweredByRealsee;
     private controller?;
     private destroyed;
-    private statePending;
     private stateSynced;
     private controllerInits;
     private panoramaLikeSavedPose;
     private extraElements;
-    private moveToPanoQueue?;
     private getPixelsRenderTarget;
-    private tweenCoordinates?;
+    private readyCallbacks;
+    private modelPending;
+    private syncingState;
+    /**
+     * 是否开启 IOS EDR 模式
+     * 需要客户端配合
+     * 并且开启 five.enablepostProcessing = true
+     */
+    private _enableIOSEDR;
+    private lastLoadWorkTask;
+    private networkSubscribe;
+    private screenBuffer?;
+    private analysis?;
+    private renderSwitch01;
     constructor(initArgs?: FiveInitArgs);
     /**
      * 析构 five 对象。
@@ -682,6 +754,21 @@ export declare class Five extends Subscribe<EventTypes> {
      * ```
      */
     setScissor(scissor: Scissor): void;
+    /**
+     * 帮助元素显示/隐藏
+     */
+    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" | "depthPanorama" | "vrPanorama" | "imageOptions">): void;
     /**
      * 将显示区域加载到页面 DOM 中
      * @description
@@ -719,6 +806,8 @@ export declare class Five extends Subscribe<EventTypes> {
      * 获取当前相机姿态, 可以使用 getCurrentState 代替
      */
     getPose(): Pose;
+    getSize(target: THREE_2.Vector2): THREE_2.Vector2;
+    getDrawingBufferSize(target: THREE_2.Vector2): THREE_2.Vector2;
     /**
      * 移动相机。（不触发点位移动）
      * @description
@@ -726,9 +815,10 @@ 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>;
     /**
      * 获取当前相机经纬度
      * @deprecated 请使用使用 getPose
@@ -768,6 +858,8 @@ export declare class Five extends Subscribe<EventTypes> {
      * ```
      */
     initBasisLoader(transcoderResourcePath?: string): void;
+    /** 当前加载的 work 数据 */
+    get work(): Work;
     /**
      * 加载 Work 数据
      * @param inputWork - Work 数据
@@ -777,15 +869,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): 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
@@ -799,11 +893,7 @@ export declare class Five extends Subscribe<EventTypes> {
     /**
      * 获取显示用的画布（Canvas DOM节点）
      */
-    getElement(): HTMLCanvasElement;
-    /**
-     * 但停自动播放
-     */
-    pause(): void;
+    getElement(): HTMLCanvasElement | undefined;
     /**
      * 强制渲染
      * @description
@@ -815,7 +905,12 @@ export declare class Five extends Subscribe<EventTypes> {
      *
      * @param callback - 渲染完成回调
      */
-    render(callback?: () => void): void;
+    render(callback?: () => void, updateObjectResolution?: boolean): THREE_2.WebGLRenderTarget;
+    updateTime(time: number, deltaTime: number): void;
+    /**
+     * 但停自动播放
+     */
+    pause(): void;
     play(): void;
     /**
      * 转化到 Panorama 模态，并移动到对应序号的观察点。
@@ -844,7 +939,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * 获取当前在屏幕视锥中的 mesh。
      * @param object - 如果传入则检查这个对象中的mesh，如果不传，则检查整个 scene
      */
-    getRenderMeshes(object?: THREE_2.Object3D): THREE_2.Object3D[];
+    getRenderObjects(object?: THREE_2.Object3D): THREE_2.Object3D[];
     getCurrentState(): State;
     /**
      * 设置 State
@@ -865,33 +960,21 @@ 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;
-    private updateResolution;
+    ready(): Promise<void>;
+    requestFullscreen(): void;
+    exitFullscreen(): void;
     private throwError;
     private loadModel;
     private commonParams;
     private saveControllerPose;
     private applyController;
-}
-
-/** Five 相机 */
-export declare class FiveCamera extends THREE_2.PerspectiveCamera {
-    /** 相机姿态 */
-    pose: Pose;
-    constructor(fov: number);
-    /** 通过相机参数反算姿态 */
-    computePose(): void;
-    /** 设置相机姿态 */
-    setFromPose(pose: Partial<Pose>): void;
-    /** 拷贝相机姿态 */
-    copyPose(): Pose;
-}
-
-export declare class FiveHashCubeTexture extends THREE_2.CubeTexture {
-    /** 识别哈希 */
-    hash: string;
+    /** 移除事件绑定 */
+    private removeEventListeners;
 }
 
 /** Five 初始化参数 */
@@ -977,7 +1060,7 @@ export declare interface FiveInitArgs {
      * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
      * 平衡加载时间和图片质量
      */
-    textureOptions?: ImageOptions;
+    textureOptions?: TextureOptions;
     /**
      * 是否按需渲染
      * @description
@@ -1044,58 +1127,14 @@ export declare interface FiveInitArgs {
      * 详见插件部分。
      */
     plugins?: (FivePlugin<void> | FivePluginInit<FivePlugin<any, any>> | FivePluginInit<FivePlugin<void, any>>)[];
-}
-
-export declare class FiveLine extends THREE_2.Object3D {
-    private line;
-    private points;
-    constructor(vector0?: THREE_2.Vector3, vector1?: THREE_2.Vector3);
-    setPoints(vector0: THREE_2.Vector3, vector1: THREE_2.Vector3): void;
-    getPoints(): THREE_2.Vector3[];
-    setMaterial(map: ConstructorParameters<typeof FiveLineMaterial>[0]): void;
-    setResolution(width: number, height: number): void;
-}
-
-export declare class FiveLineGeometry extends FiveLineSegmentsGeometry {
-    constructor();
-    setPositions(array: ArrayLike<number>): this;
-    setColors(array: ArrayLike<number>): this;
-    fromLine(line: THREE_2.Line): this;
-    copy(): this;
-}
-
-export declare class FiveLineMaterial extends THREE_2.ShaderMaterial {
-    color: number | THREE_2.Vector3;
-    dashed: boolean;
-    dashScale: number;
-    dashSize: number;
-    gapSize: number;
-    resolution: THREE_2.Vector2;
-    constructor(parameters: FiveLineMaterialParameters);
-}
-
-export declare type FiveLineMaterialParameters = {
-    color?: number | THREE_2.Vector3;
-    linewidth?: number;
-    dashed?: boolean;
-    dashScale?: number;
-    dashSize?: number;
-    gapSize?: number;
-    resolution?: THREE_2.Vector2;
-};
-
-export declare class FiveLineSegmentsGeometry extends THREE_2.InstancedBufferGeometry {
-    constructor();
-    applyMatrix4(matrix: THREE_2.Matrix4): this;
-    setPositions(array: ArrayLike<number> | number[]): this;
-    setColors(array: Float32Array | number[]): this;
-    fromWireframeGeometry(geometry: THREE_2.WireframeGeometry): this;
-    fromEdgesGeometry(geometry: THREE_2.EdgesGeometry): this;
-    fromMesh(mesh: THREE_2.Mesh): this;
-    fromLineSegments(lineSegments: THREE_2.LineSegments): this;
-    computeBoundingBox(): void;
-    computeBoundingSphere(): void;
-    toJSON(): void;
+    /**
+     * 是否展示 powered by 如视
+     */
+    poweredByRealsee?: boolean;
+    /**
+     * 是否使用webgl2渲染执行环境, 默认值 false
+     */
+    webgl2?: boolean;
 }
 
 /**
@@ -1125,10 +1164,6 @@ parameters: Parameters<T>[1]
  */
 export declare type FivePluginInstance<T extends FivePlugin<any, any>> = ReturnType<T>;
 
-/** Five 场景*/
-export declare class FiveScene extends THREE_2.Scene {
-}
-
 export declare interface FloorplanControllerCustomInitArgs {
     /** 默认偏航角 */
     defaultLongitude?: number;
@@ -1146,7 +1181,7 @@ export declare interface FloorplanControllerCustomInitArgs {
     minFov?: number;
 }
 
-export declare type GestureTypes = "pan" | "tap" | "pinch" | "mouseWheel";
+export declare type GestureTypes = "pan" | "tap" | "pinch" | "press" | "mouseWheel";
 
 export declare function getViewportScale(): number;
 
@@ -1154,33 +1189,60 @@ export declare function getViewportScale(): number;
  * 图片参数
  */
 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 interface ImageURLMappings {
+    [publicDomain: string]: {
+        "pano": [string, string];
+        "tile": [string, string];
+        "texture": [string];
+        "default": [string];
+    };
+}
+
+export declare interface ImageURLOptions {
+    /** 图片类型标识 */
+    key: string;
+    /** basisLoader 是否初始化完成 */
+    basisLoaderInitialized: boolean;
+    /** 图片尺寸参数 尽量使用 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;
     });
 }
 
@@ -1195,10 +1257,42 @@ 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;
 }
 
+export declare class LegacyPanoCircleMesh extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    hitTestMesh: THREE_2.Mesh<THREE_2.BufferGeometry, THREE_2.MeshBasicMaterial>;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    progress: number;
+    opacity: number;
+    private centerMesh;
+    private loadingMesh;
+    private progressMotion;
+    private opacityMotion;
+    private stopInterval?;
+    constructor();
+    setLoading(shown: boolean): void;
+    setDisabled(disabled: boolean): void;
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
 export declare type LooseWork = {
     bvh?: boolean;
     modelAsync?: boolean;
@@ -1230,9 +1324,9 @@ export declare type LooseWorkModel = {
 
 export declare type LooseWorkObserver = {
     active?: boolean;
+    index?: number;
     visible_nodes: number[];
     accessible_nodes: number[];
-    index: number;
     quaternion: {
         y: number;
         x: number;
@@ -1248,7 +1342,7 @@ export declare type LooseWorkObserver = {
 export declare type LooseWorkPanorama = {
     active?: boolean;
     loadable?: boolean;
-    index: number;
+    index?: number;
     up: string;
     down: string;
     right: string;
@@ -1256,7 +1350,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 = {
@@ -1298,7 +1400,7 @@ 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;
     /** 是否未加载 */
@@ -1306,7 +1408,9 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
     /** 外接盒子的大小 */
     bounding: THREE_2.Box3;
     /** 当前显示的楼层 */
-    shownfloor: number | null;
+    shownFloor: number | null;
+    /** 楼层的数量 */
+    floorLength: number;
     /**
      * 判断是否注册了事件
      * 具体可查看 {@link Subscribe.hasListener}
@@ -1333,18 +1437,36 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      */
     emit: SubscribeMixinType.emit<ModelEventType>;
     /** bvh 树的计算结果 */
-    bvhs: any[] & {
-        loaded?: boolean;
+    bvhs: BVH[] & {
+        loaded: boolean;
     };
-    constructor();
+    /** 网络跟踪 */
+    private networkSubscribe?;
+    /** 安全域名 */
+    private allowHosts?;
+    constructor(options?: {
+        networkSubscribe?: NetworkSubscribe;
+        allowHosts?: string[];
+    });
+    /**
+     * 当前显示的楼层
+     * @deprecated
+     * 请用 shwonFloor 代替
+     */
+    get shownfloor(): number | null;
     /**
      * 获取模型边界线
      * @param threshold - 面片间夹角阈值
      * @returns 所有模型边界线
      */
     getEdges(threshold?: number): THREE_2.Line3[];
-    /** 获取当前楼层数 */
+    /**
+     * 获取当前楼层数
+     * @deprecated
+     * 请使用 floorLength 参数代替
+     */
     hasFloors(): number;
+    private hasFloors_;
     /**
      * 显示某楼层
      * @example
@@ -1355,7 +1477,7 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      * ```
      */
     show(): void;
-    show(floorIndex: number, hideOpacity?: number): void;
+    show(floorIndex: number, hiddenOpacity?: number): void;
     /**
      * 计算模型射线碰撞检测
      * @param raycaster - THREE 射线对象
@@ -1363,13 +1485,13 @@ 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): Promise<void>;
     /**
      * 析构函数
      * @description
@@ -1408,6 +1530,11 @@ export declare type ModelEventType = {
     materialLoaded(): void;
     /** 模型加载完成 */
     loaded(): void;
+    /**
+     * 显示楼层改变
+     * @param shownFloor - 显示的楼层
+     */
+    shownFloorChange(shownFloor: number | null, totalFloorLength: number): void;
     /**
      * 内部错误
      * @param error - 错误对象
@@ -1426,9 +1553,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
@@ -1454,15 +1582,84 @@ export declare interface MovePanoOptions extends Partial<Omit<Pose, "offset">> {
     moveCancelCallback?: () => void;
 }
 
+export declare type NetWorkMeta = {
+    source: string;
+    headers: {
+        [name: string]: string;
+    };
+    requestTime: number;
+    responseTime: number;
+    costs: number;
+    size?: number;
+};
+
+export declare type NetworkState = "ok" | "preload" | "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 loadingMesh;
+    private disableMesh;
+    private centerMesh;
+    private ringMesh;
+    private progressMesh;
+    private ringRotateMotion;
+    private tapMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    constructor();
+    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;
+}
+
+/**
+ * 地面提示点位接口
+ *
+ * 点位状态
+ *  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;
 }
 
@@ -1478,6 +1675,7 @@ export declare interface PanoramaControllerCustomInitArgs extends PanoramaLikeCo
     panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
     panoCircleMeshCreator?: () => PanoCircleMeshInterface;
+    tileLevelForFov?: false | ((fov: number, viewSize: THREE_2.Vector2) => number);
 }
 
 export declare interface PanoramaLikeControllerCustomInitArgs {
@@ -1505,14 +1703,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;
     /** 设置透明参数 */
@@ -1527,16 +1742,18 @@ 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: FiveHashCubeTexture | null;
-    /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: FiveHashCubeTexture | null;
-    /** 结束点全景图变换矩阵 4x4 */
-    pano1Matrix: THREE_2.Matrix4;
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
     /** 全景图混合程度 [0-1] */
@@ -1546,20 +1763,7 @@ export declare class PBMMaterial extends THREE_2.ShaderMaterial implements PBMPa
     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;
     constructor(parameters?: Partial<PBMParameters>);
 }
 
@@ -1571,16 +1775,21 @@ export declare class PBMMesh extends THREE_2.Mesh<THREE_2.BufferGeometry, PBMMat
     needsRender: boolean;
 }
 
-/** PBM 材质参数 */
-export declare interface PBMParameters {
+export declare interface PBMPanoPicture {
     /** 起始点位全景图 */
-    pano0Map: FiveHashCubeTexture | null;
+    map: THREE_2.CubeTexture;
+    /** 亮度增益 */
+    luminanceMap: THREE_2.CubeTexture | null;
     /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: FiveHashCubeTexture | 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] */
@@ -1590,20 +1799,6 @@ export declare interface PBMParameters {
     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;
 }
 
 /**
@@ -1611,9 +1806,9 @@ export declare interface PBMParameters {
  * [[include: coordinate.md]]
  */
 export declare interface Pose {
-    /** 相机俯仰角 */
-    longitude: number;
     /** 相机偏航角 */
+    longitude: number;
+    /** 相机俯仰角 */
     latitude: number;
     /** 相机可视角度（垂直）*/
     fov: number;
@@ -1621,7 +1816,13 @@ export declare interface Pose {
     offset: THREE_2.Vector3;
 }
 
-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"];
+
+/** Five 场景*/
+export declare class Scene extends THREE_2.Scene {
+    add(...objects: AddableObject[]): this;
+    remove(...objects: AddableObject[]): this;
+}
 
 /**
  * 显示区域裁剪参数
@@ -1657,8 +1858,6 @@ export declare interface State extends Pose {
     panoIndex: number;
 }
 
-export declare function stringifyWork(work: Work): LooseWork;
-
 /**
  * 监听者模式
  * @template T - 预设的监听回调类型
@@ -1737,68 +1936,156 @@ export declare namespace SubscribeMixinType {
     }
 }
 
+/**
+ * 图片参数
+ */
+export declare interface TextureOptions {
+    /**
+     * url 地址转化
+     * @param url - 原始地址
+     * @param options - 当前地址参数
+     * @returns 转化后地址
+     */
+    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;
+}
+
 export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
 }
 
 export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
-    /**
-     * webvrPolyfill 的设置对象
-     * @description
-     * 只可被设置一次，所有的 five 实例共用这个设置
-     */
-    webvrPolyfillConfig?: any;
 }
 
-export declare type Work = {
-    uuid: string;
+export declare class Work {
+    /** 名称 */
+    name: string;
+    /** 编号 */
+    workCode: string;
+    /** 允许访问的安全域名 */
+    allowHosts: string[];
+    /** 过期时间 */
+    expire: Date;
+    /** 初始化参数 */
     initial: WorkInitial;
+    /** 模型参数 */
     model?: WorkModel;
+    /** 全景点位信息 */
     observers: WorkObserver[];
-};
+    /** 数据签发人 */
+    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"> {
+}
 
 /** 模型数据 */
-export declare type WorkModel = {
+export declare interface WorkModel {
+    /** 模型文件地址 at3d / domez */
     file: string;
+    /** 模型贴图文件地址 */
     textures: string[];
+    /** 模型贴图文件地址的父目录 */
     textureBase: string;
+    /** 是否开启 bvh 碰撞树，开启会大大加快射线碰撞的执行效率 */
     bvh: boolean;
-    async: boolean;
-};
+}
 
 /** 每个点位的数据 */
-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;
-};
+}
+
+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 { }