@realsee/five 6.8.0-alpha.3 → 6.8.0-alpha.30

package/five/controllers/panorama.d.ts

@@ -0,0 +1,144 @@
+import * as THREE from "three";
+import { NetworkResponse, NetWorkMeta } from "../utils/ajax";
+import { ModelScene, PBMPanoPicture } from "../model";
+import { Works, WorkObserver } from "../work";
+import { type EasingFunction } from "../utils/easing";
+import { Pano, PanoId } from "../utils/pano";
+import { TextureLoader } from "../texture/loader";
+import { MovePanoOptions } from "../types/movePanoOptions";
+import { MovePanoEffect } from "../types/movePanoEffect";
+import { BaseControllerInitArgs } from "./base";
+import { PanoramaLikeController, PanoramaLikeControllerCustomInitArgs } from "./panoramaLike";
+import { State } from "../types/state";
+import { GestureEvent } from "../utils/event";
+import { PanoCircleMeshInterface } from "../types/panoCircleMeshInterface";
+import { Motion } from "../utils/motion";
+import { Tiling } from "../core/tiling";
+import { PanoVideo } from "../core/panoVideo";
+declare const defaultEffectEase: EasingFunction;
+type PanoResource = {
+    panoId: PanoId;
+    effect: Exclude<MovePanoOptions["effect"], undefined>;
+    effectEasing: Exclude<MovePanoOptions["effectEasing"], undefined>;
+    panoPicture: PBMPanoPicture | null;
+    position: THREE.Vector3;
+    fixCameraTransform: THREE.Matrix4;
+};
+type LocationMotion = Motion<"count" | "distance">;
+type PerspToOrthoMotion = Motion<"perspToOrtho">;
+type ModelAlphaMotion = Motion<"modelAlpha">;
+declare const adjustPanoCircleMeshVectors: THREE.Vector3[];
+interface PanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
+    /** 最远可移动观察点距离 */
+    maxAccessibleDistance?: number;
+    /**
+     * 点击地面观察点标识的判定范围
+     * @description
+     * 如果在判定范围内则确定去到目标点，
+     * 否则寻找点击位置方向最适合的点（可能会走到一个离相机更近的点）。
+     */
+    panoTapTriggerRadius?: number;
+    /** 地面观察点标识自定义创建器 */
+    panoCircleMeshCreator?: (observer: WorkObserver, options: {
+        aerialObserverMinHeight: number;
+    }) => PanoCircleMeshInterface;
+    /** 基于模型调整 地面观察点 的位置 */
+    adjustPanoCircleMeshPositionBasedOnModel?: boolean;
+    /**
+     * 全景瓦片登记
+     * @param fov - 当前 fov
+     * @param viewSize - 当前绘制区域大小
+     * @returns 返回瓦片等级
+     */
+    tileLevelForFov?: false | ((fov: number, viewSize: THREE.Vector2) => number);
+    /** 全景进入渐变时长 单位秒 */
+    tileAppearDuration?: number;
+    /** 全景瓦片并发数 */
+    tileMaxRequest?: number;
+    /** 是否使用深度信息干预全景图着色 */
+    flyEffectUseDepthBuffer?: boolean;
+}
+declare const defaultPanoramaControllerCustomInitArgs: Required<PanoramaControllerCustomInitArgs>;
+type PanoramaControllerInitArgs = BaseControllerInitArgs & PanoramaControllerCustomInitArgs;
+declare class PanoramaController extends PanoramaLikeController implements Required<PanoramaControllerInitArgs> {
+    maxAccessibleDistance: number;
+    panoTapTriggerRadius: number;
+    panoCircleMeshCreator: (observer: WorkObserver, options: {
+        aerialObserverMinHeight: number;
+    }) => PanoCircleMeshInterface;
+    adjustPanoCircleMeshPositionBasedOnModel: boolean;
+    adjustPanoCircleMeshPositionFix: Map<PanoId, THREE.Vector4>;
+    tileLevelForFov: false | ((fov: number, viewSize: THREE.Vector2) => number);
+    tileAppearDuration: number;
+    tileMaxRequest: number;
+    flyEffectUseDepthBuffer: boolean;
+    locationMotion: LocationMotion;
+    perspToOrthoMotion: PerspToOrthoMotion;
+    modelAlphaMotion: ModelAlphaMotion;
+    tiling: Tiling;
+    protected textureLoader: TextureLoader;
+    protected panoMeshes: Map<PanoId, PanoCircleMeshInterface>;
+    protected initAnimationed: boolean;
+    protected accessibleObserverFloorCheckCount: number;
+    protected pano0DepthCubeRenderTarget?: THREE.WebGLCubeRenderTarget;
+    protected pano1DepthCubeRenderTarget?: THREE.WebGLCubeRenderTarget;
+    protected pendingPanoTask?: {
+        panoId: PanoId;
+        hash: string;
+        onLoad(colorResponse: NetworkResponse<THREE.Texture, NetWorkMeta[]>): void;
+        onError(error: Error): void;
+    };
+    protected panoVideo: PanoVideo;
+    protected panoResources: {
+        [key: string]: PanoResource;
+    };
+    protected panoPictureObserverMap: WeakMap<PBMPanoPicture, WorkObserver>;
+    static parseArgs(args: PanoramaControllerInitArgs): Required<PanoramaControllerInitArgs>;
+    static initAnimationEndState(args: PanoramaControllerInitArgs): State;
+    constructor(args: PanoramaControllerInitArgs);
+    get tileLevel(): number;
+    updateConfiguration(args: PanoramaControllerCustomInitArgs): boolean;
+    /** controller 销毁 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    isTileReady(): boolean;
+    /** 动态更新 work */
+    updateWork(works: Works, state: Partial<State>, options: {
+        duration: number;
+        effect: MovePanoEffect;
+    }, userAction: boolean): boolean;
+    /** 更新模型 */
+    updateModel(modelScene: ModelScene): void;
+    /** 时间迭代 */
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /** 获取目标姿态 */
+    getTargetState(): State;
+    /** 移动点位 */
+    moveToPano(pano: Pano, options: MovePanoOptions, userAction: boolean): void;
+    /** 初始化动画 */
+    protected initAnimation(): Promise<void>;
+    /**
+     * 获取 locationMotion.keyframe 中存储的 panoResource
+     * @param keyframe
+     * @returns
+     */
+    protected panoResourceFromLocationMotionKeyframe(keyframe: LocationMotion["keyframes"][number]): PanoResource;
+    /**
+     * 计算 locationMotion.keyframes 中的整体距离总合的长度
+     * @param keyframes
+     * @returns
+     */
+    protected locationMotionKeyframesLength(keyframes: LocationMotion["keyframes"]): number;
+    /** 移动相机 */
+    protected doMoveToPano(pano: Pano, panoResource: PanoResource, options?: MovePanoOptions): void;
+    /**
+     * 方向射线上寻找下一个目标点位
+     * @param raycaster - 方向射线
+     * @returns 方向射线上寻找下一个目标点位
+     */
+    protected getForwardObserverOrNot(camera: THREE.Camera, raycaster?: THREE.Raycaster): WorkObserver | null;
+    /** 触摸 点击屏幕 */
+    protected onTapGesture(event: GestureEvent): void;
+}
+export { LocationMotion, ModelAlphaMotion, PerspToOrthoMotion, PanoramaController, PanoramaControllerInitArgs, PanoramaControllerCustomInitArgs, defaultPanoramaControllerCustomInitArgs, defaultEffectEase, adjustPanoCircleMeshVectors, };

package/five/controllers/panoramaLike.d.ts

@@ -0,0 +1,87 @@
+import { BaseController, BaseControllerInitArgs } from "./base";
+import { IntersectMeshInterface } from "../types/intersectMeshInterface";
+import { State } from "../types/state";
+import { GestureEvent } from "../utils/event";
+import { MovePanoOptions } from "../types/movePanoOptions";
+interface PanoramaLikeControllerCustomInitArgs {
+    /** 默认相机俯仰角 */
+    defaultLatitude?: number;
+    /** 最大相机俯仰角 */
+    maxLatitude?: number | ((fov: number) => number);
+    /** 最小相机俯仰角 */
+    minLatitude?: number | ((fov: number) => number);
+    /** 默认相机可视角度（垂直），可作为 `zoom` */
+    defaultFov?: number;
+    /** 最大默认相机可视角度（垂直） */
+    maxFov?: number;
+    /** 最小默认相机可视角度（垂直） */
+    minFov?: number;
+    /**
+     * 点位间移动动画速度 单位 m/s
+     * @description
+     * 这边设置的是速度，整体耗时会通过距离除速度计算得到
+     */
+    moveSpeed?: number;
+    /** 鼠标焦点环自定义创建器 */
+    intersectMeshCreator?: () => IntersectMeshInterface;
+    /** 航拍点最小高度 */
+    aerialObserverMinHeight?: number;
+}
+declare const defaultPanoramaLikeControllerCustomInitArgs: Required<PanoramaLikeControllerCustomInitArgs>;
+type PanoramaLikeControllerInitArgs = BaseControllerInitArgs & PanoramaLikeControllerCustomInitArgs;
+declare class PanoramaLikeController extends BaseController implements Required<PanoramaLikeControllerInitArgs> {
+    maxLatitude: number | ((fov: number) => number);
+    minLatitude: number | ((fov: number) => number);
+    maxFov: number;
+    minFov: number;
+    defaultLatitude: number;
+    defaultFov: number;
+    moveSpeed: number;
+    intersectMeshCreator: () => IntersectMeshInterface;
+    aerialObserverMinHeight: number;
+    protected intersectMesh: IntersectMeshInterface;
+    protected pinchState?: {
+        x: number;
+        y: number;
+        fov: number;
+    };
+    static parseArgs(args: PanoramaLikeControllerInitArgs): Required<PanoramaLikeControllerInitArgs>;
+    static initAnimationEndState(args: PanoramaLikeControllerInitArgs): State;
+    constructor(args: PanoramaLikeControllerInitArgs);
+    /** 动态更新配置 */
+    updateConfiguration(args: PanoramaLikeControllerCustomInitArgs): boolean;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 计算动画时间 */
+    protected calculateMovingDuration(duration: MovePanoOptions["duration"], distance: number): number;
+    /** 隐藏焦点环 */
+    protected hideIntersectMesh(): void;
+    /** 计算 屏幕像素 offset 与 转动间的关系 */
+    protected coordinatesForOffset(offset: {
+        x: number;
+        y: number;
+    }): {
+        longitude: number;
+        latitude: number;
+    };
+    /** 相机拉风箱 */
+    protected cameraBounce(): void;
+    /** 惯性转动镜头 */
+    protected requestMomentumMovement(event: GestureEvent, isFirst: boolean, velocity: {
+        longitude: number;
+        latitude: number;
+    }, duration: number): void;
+    /** 触摸 Pan 事件，相机转动 */
+    protected onPanGesture(event: GestureEvent): void;
+    /** 触摸 Pinch 事件， 相机缩放 */
+    protected onPinchGesture(event: GestureEvent): void;
+    /** 鼠标滚轮事件 相机缩放 */
+    protected onMouseWheel(event: GestureEvent): void;
+    /** 鼠标移动事件 展示交点环 */
+    protected onMouseMove(event: GestureEvent): void;
+    /** 触摸 双点屏幕 */
+    protected onDblTapGesture(event: GestureEvent): void;
+}
+export { PanoramaLikeController, PanoramaLikeControllerInitArgs, PanoramaLikeControllerCustomInitArgs, defaultPanoramaLikeControllerCustomInitArgs, };

package/five/controllers/topview.d.ts

@@ -0,0 +1,42 @@
+import { State } from "../types/state";
+import { Pose } from "../types/pose";
+import { GestureEvent } from "../utils/event";
+import { BaseControllerInitArgs } from "./base";
+import { ModelScene } from "../model";
+import { FloorplanController, FloorplanControllerCustomInitArgs, FloorplanControllerInitArgs } from "./floorplan";
+interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+declare const defaultTopviewControllerCustomInitArgs: Required<TopviewControllerCustomInitArgs>;
+type TopviewControllerInitArgs = BaseControllerInitArgs & TopviewControllerCustomInitArgs;
+declare class TopviewController extends FloorplanController implements Required<TopviewControllerInitArgs> {
+    static parseArgs(args: TopviewControllerInitArgs): Required<FloorplanControllerInitArgs>;
+    static initAnimationEndState(args: TopviewControllerInitArgs): State;
+    constructor(args: TopviewControllerInitArgs);
+    updateConfiguration(args: FloorplanControllerCustomInitArgs): boolean;
+    /**
+     * 更新模型
+     * @param model - 模型
+     */
+    updateModel(modelScene: ModelScene): void;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /**
+     * 初始化动画
+     */
+    protected initAnimation(): Promise<void>;
+    /** 惯性滚动 */
+    protected requestMomentumMovement(): void;
+    /** 触摸 Pan 事件，相机转动 */
+    protected onPanGesture(event: GestureEvent): void;
+    /** 触摸 Pinch 事件， 相机缩放 */
+    protected onPinchGesture(event: GestureEvent): void;
+    /** 鼠标滚轮事件 相机缩放 */
+    protected onMouseWheel(event: GestureEvent): void;
+}
+export { TopviewController, TopviewControllerInitArgs, TopviewControllerCustomInitArgs, defaultTopviewControllerCustomInitArgs, };

package/five/controllers/vrPanorama.d.ts

@@ -0,0 +1,56 @@
+import { CameraPose } from "../core/camera";
+import { Cardboard } from "../cardboard";
+import { State } from "../types/state";
+import { Pose } from "../types/pose";
+import { BaseControllerInitArgs } from "./base";
+import { PanoramaController, PanoramaControllerCustomInitArgs, PanoramaControllerInitArgs } from "./panorama";
+import { PanoCircleMeshInterface } from "../types/panoCircleMeshInterface";
+interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+declare const defaultVRPanoramaControllerCustomInitArgs: Required<VRPanoramaControllerCustomInitArgs>;
+type VRPanoramaControllerInitArgs = BaseControllerInitArgs & VRPanoramaControllerCustomInitArgs;
+declare class VRPanoramaController extends PanoramaController implements Required<VRPanoramaControllerInitArgs> {
+    protected cardboard: Cardboard;
+    protected helperElement?: HTMLElement;
+    protected activePanoMesh?: PanoCircleMeshInterface;
+    protected activeTime?: number;
+    static parseArgs(args: VRPanoramaControllerInitArgs): Required<PanoramaControllerInitArgs>;
+    static initAnimationEndState(args: VRPanoramaControllerInitArgs): State;
+    constructor(args: VRPanoramaControllerInitArgs);
+    updateConfiguration(args: VRPanoramaControllerCustomInitArgs): boolean;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 生命周期： 更新屏幕渲染尺寸 */
+    updateRenderSize(): void;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /** 时间迭代 */
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /** 生命周期 渲染 */
+    render(): boolean;
+    /**
+     * 同步修改相机参数
+     * @param cameraPose
+     */
+    protected setCamera(cameraPose?: Partial<CameraPose>): void;
+    /** 删除提示层 */
+    protected destroyHelper(): void;
+    /** 设置提示层大小 */
+    protected updateHelperElementSize(): void;
+    /** 计算看向方向的射线碰撞 */
+    protected intersect(time: number): PanoCircleMeshInterface | undefined;
+    protected onPanGesture(): void;
+    protected onTapGesture(): void;
+    protected onPinchGesture(): void;
+    protected onMouseMove(): void;
+    protected onMouseOut(): void;
+}
+export { VRPanoramaController, VRPanoramaControllerInitArgs, VRPanoramaControllerCustomInitArgs, defaultVRPanoramaControllerCustomInitArgs, };

package/five/controllers/xrPanorama.d.ts

@@ -0,0 +1,81 @@
+import * as THREE from "three";
+import { State } from "../types/state";
+import { Pose } from "../types/pose";
+import { BaseControllerInitArgs } from "./base";
+import { PanoramaController, PanoramaControllerCustomInitArgs, PanoramaControllerInitArgs, LocationMotion } from "./panorama";
+import { Pano, PanoId } from '../utils/pano';
+import { PBMPanoPicture } from "../model";
+import { MovePanoOptions } from "../types/movePanoOptions";
+import { NetworkResponse, NetWorkMeta } from "../utils/ajax";
+interface XRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+type XRPanoramaControllerInitArgs = BaseControllerInitArgs & XRPanoramaControllerCustomInitArgs;
+declare const defaultXRPanoramaControllerInitArgs: Required<XRPanoramaControllerCustomInitArgs>;
+interface PanoResourceXR {
+    panoId: PanoId;
+    effect: Exclude<MovePanoOptions["effect"], undefined>;
+    effectEasing: Exclude<MovePanoOptions["effectEasing"], undefined>;
+    leftPanoPicture: PBMPanoPicture | null;
+    position: THREE.Vector3;
+    fixCameraTransform: THREE.Matrix4;
+}
+declare class XRPanoramaController extends PanoramaController implements Required<XRPanoramaControllerInitArgs> {
+    panoResources: {
+        [key: string]: PanoResourceXR;
+    };
+    /** XR管理器*/
+    private xrManager;
+    /** 控制器选取方向线*/
+    private xrControllerRay;
+    private gazeRay;
+    /** 控制器选取方向模型*/
+    private pointerLines;
+    /** 视差相机矩阵*/
+    private parallaxCameraMatrixs;
+    /** xr手柄事件监测*/
+    private xrHandleState;
+    private xrHandState;
+    private controllerWrappers;
+    protected pendingPanoTask?: {
+        panoId: PanoId;
+        hash: string;
+        onLoad(colorLeftResponse: NetworkResponse<THREE.Texture, NetWorkMeta[]>): void;
+        onError(error: Error): void;
+    };
+    static parseArgs(args: XRPanoramaControllerInitArgs): Required<PanoramaControllerInitArgs>;
+    static initAnimationEndState(args: XRPanoramaControllerInitArgs): State;
+    constructor(args: XRPanoramaControllerInitArgs);
+    updateConfiguration(args: XRPanoramaControllerCustomInitArgs): boolean;
+    /** 移动点位 */
+    moveToPano(pano: Pano, options: MovePanoOptions, userAction: boolean): void;
+    /** 移动相机 */
+    protected doMoveToPano(pano: Pano, panoResource: PanoResourceXR, options?: MovePanoOptions): void;
+    /** 触摸 点击屏幕 */
+    checkSelectedPano(raycaster: THREE.Raycaster): Pano | null;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /** 时间迭代 */
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /** 生命周期 渲染 */
+    render(): boolean;
+    protected onPanGesture(): void;
+    protected onTapGesture(): void;
+    protected onPinchGesture(): void;
+    protected onMouseMove(): void;
+    protected onMouseOut(): void;
+    protected panoResourceFromLocationMotionKeyframe(keyframe: LocationMotion["keyframes"][number]): PanoResourceXR;
+    private updateControllerHelper;
+    private emitHandleEvent;
+    private initHandEvent;
+}
+export { XRPanoramaController, XRPanoramaControllerInitArgs, XRPanoramaControllerCustomInitArgs, defaultXRPanoramaControllerInitArgs, };

package/five/core/camera.d.ts

@@ -0,0 +1,65 @@
+import * as THREE from "three";
+import type { Mode } from "../application/mode";
+interface CameraPose {
+    longitude: number;
+    latitude: number;
+    fov: number;
+    distance: number;
+    offset: THREE.Vector3;
+}
+/** Five 相机 */
+declare class Camera extends THREE.Camera {
+    fov: number;
+    aspect: number;
+    near: number;
+    far: number;
+    perspToOrtho: THREE.Vector2;
+    resolution: THREE.Vector2;
+    pixelRatio: number;
+    /** 相机姿态 */
+    pose: CameraPose;
+    private perspectiveCamera;
+    private orthographicCamera;
+    autoNearFar: boolean;
+    needsRender: boolean;
+    refineModel: boolean;
+    time: number;
+    controllerMode: Mode | null;
+    private lastValues;
+    constructor(fov: number, aspect?: number, near?: number, far?: number, perspToOrtho?: THREE.Vector2, resolution?: THREE.Vector2, pixelRatio?: number);
+    get orthoDistance(): number;
+    get zoom(): number;
+    get top(): number;
+    get bottom(): number;
+    get left(): number;
+    get right(): number;
+    getDirection(target: THREE.Vector3): THREE.Vector3;
+    /** 通过相机参数反算姿态 */
+    computePose(distance?: number): this;
+    /** 设置相机姿态 */
+    setFromPose(pose: Partial<CameraPose>): this;
+    /** 拷贝相机姿态 */
+    copyPose(): CameraPose;
+    private computeProjectionMatrix;
+    setViewOffset(fullWidth: number, fullHeight: number, x: number, y: number, width: number, height: number): void;
+    get view(): {
+        enabled: boolean;
+        fullWidth: number;
+        fullHeight: number;
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    } | null;
+    clearViewOffset(): void;
+    updateProjectionMatrix(): void;
+    get perspectiveProjectionMatrix(): THREE.Matrix4;
+    get perspectiveProjectionMatrixInverse(): THREE.Matrix4;
+    get orthographicProjectionMatrix(): THREE.Matrix4;
+    get orthographicProjectionMatrixInverse(): THREE.Matrix4;
+    updateTime(time: number): void;
+    get isPerspectiveCamera(): boolean;
+    get isOrthographicCamera(): boolean;
+    copy(source: this, recursive?: boolean): this;
+}
+export { Camera, CameraPose };

package/five/core/internalWebGLRenderer.d.ts

@@ -0,0 +1,14 @@
+import * as THREE from "three";
+declare class InternalWebGLRenderer extends THREE.WebGLRenderer {
+    constructor({ preserveDrawingBuffer, premultipliedAlpha, stencil, antialias, webgl2, logarithmicDepthBuffer, precision, powerPreference, }: {
+        preserveDrawingBuffer?: boolean;
+        premultipliedAlpha?: boolean;
+        stencil?: boolean;
+        antialias?: boolean;
+        webgl2?: boolean;
+        logarithmicDepthBuffer?: boolean;
+        precision?: 'highp' | 'mediump' | 'lowp';
+        powerPreference?: 'high-performance' | 'low-power' | 'default';
+    });
+}
+export { InternalWebGLRenderer };

package/five/core/panoVideo.d.ts

@@ -0,0 +1,18 @@
+import * as THREE from "three";
+interface PanoVideoProps {
+    size: THREE.Vector2;
+    matrix: THREE.Matrix4;
+    panoMatrix: THREE.Matrix4;
+    alpha: number;
+    map: THREE.Texture;
+}
+declare class PanoVideo {
+    private material;
+    object: THREE.Mesh<THREE.BufferGeometry, THREE.ShaderMaterial>;
+    private alphaMotion;
+    constructor();
+    setMaterial(value: PanoVideoProps | null): void;
+    updateTime(time: number): void;
+    dispose(): void;
+}
+export { PanoVideo };

package/five/core/scene.d.ts

@@ -0,0 +1,10 @@
+import * as THREE from "three";
+import { AddableObject } from "../types/addableObject";
+/** Five 场景*/
+declare class Scene extends THREE.Scene {
+    needsRender: boolean;
+    add(...objects: AddableObject[]): this;
+    remove(...objects: AddableObject[]): this;
+    update(renderer: THREE.WebGLRenderer, camera: THREE.Camera): boolean;
+}
+export { Scene };

package/five/core/tiling.d.ts

@@ -0,0 +1,43 @@
+import * as THREE from "three";
+import { WorkObserver } from "../work";
+import { ImageOptions } from "../types/imageOptions";
+export interface TilingFrameState {
+    time: number;
+    resolution: THREE.Vector2;
+    pixelRatio: number;
+    renderer: THREE.WebGLRenderer;
+    cameraMatrix: THREE.Matrix4;
+    cameraProjectionMatrix: THREE.Matrix4;
+    panoMap: THREE.CubeTexture | null;
+    panoMatrix: THREE.Matrix4;
+    panoZoom: number;
+    minLevel: number;
+    level: number;
+}
+export declare class Tiling {
+    private disposed;
+    fiveId: string;
+    level: number;
+    pedding: number;
+    maxRequest: number;
+    appearDuration: number;
+    maxCacheTile: number;
+    imageOptions: ImageOptions;
+    private boundingMesh;
+    private tileTree;
+    private tileMeshes;
+    private textureLoader;
+    observer: WorkObserver | null;
+    frustum: THREE.Frustum;
+    scene: THREE.Scene;
+    camera: THREE.PerspectiveCamera;
+    renderTarget: THREE.WebGLRenderTarget;
+    private forceRenderWhenNextUpdate;
+    constructor(options: {
+        fiveId: string;
+    });
+    dispose(): void;
+    cleanup(): void;
+    setObserver(observer: WorkObserver | null): void;
+    update(frameState: TilingFrameState): boolean;
+}

package/five/declare.d.ts

@@ -1,4 +1,5 @@
 import * as THREE from 'three';
+import type { Model, ViewLayer, Tile } from './model';
 
 declare module 'three' {
 
@@ -11,7 +12,7 @@ declare module 'three' {
     /**
      * 对焦点进行筛选
      */
-    hitFilter?: (intersect: THREE.Intersection) => boolean;
+    hitFilter?: (intersect: THREE.Intersection & { model?: Model; viewLayer?: ViewLayer; tile?: Tile; }) => boolean;
 
     /**
      * 是否由近及远排序， 默认 true

package/five/gaussian-splatting/util/renderData.d.ts

@@ -0,0 +1,66 @@
+import { PBMGaussianSplattingObject } from "../../model/objects/pbmGaussianSplattingObject";
+declare class RenderData {
+    dataChanged: boolean;
+    transformsChanged: boolean;
+    readonly generation: number;
+    splatIndices: Map<PBMGaussianSplattingObject, number>;
+    offsets: Map<PBMGaussianSplattingObject, number>;
+    data: Uint32Array;
+    width: number;
+    height: number;
+    transforms: Float32Array;
+    transformsWidth: number;
+    transformsHeight: number;
+    transformIndices: Uint32Array;
+    transformIndicesWidth: number;
+    transformIndicesHeight: number;
+    layerIndices: Uint32Array;
+    layerIndicesWidth: number;
+    layerIndicesHeight: number;
+    layerKeys: string[];
+    layerKeyToIndex: Map<string, number>;
+    objectLayerIndices: Map<PBMGaussianSplattingObject, number>;
+    positions: Float32Array;
+    rotations: Float32Array;
+    scales: Float32Array;
+    numPoints: number;
+    worker: Worker;
+    sh1?: Float32Array;
+    sh2?: Float32Array;
+    sh3?: Float32Array;
+    maxShDegree: number;
+    initialBuildComplete: boolean;
+    pendingInitialBuildCount: number;
+    readonly readyPromise: Promise<void>;
+    sortDataReleased: boolean;
+    aggregatedDataReleased: boolean;
+    shDataReleased: boolean;
+    indexDataReleased: boolean;
+    disposed: boolean;
+    private resolveReadyPromise;
+    private objectsInOrder;
+    static warmupWasm(): void;
+    constructor(pbmGSObjects: PBMGaussianSplattingObject[], generation?: number);
+    updateTransform(pbmGSObject: PBMGaussianSplattingObject): void;
+    /** 释放仅用于排序的 CPU 端冗余数组（positions/rotations/scales），降低内存占用 */
+    releaseSortData(): void;
+    /** 释放 CPU 端聚合数组（data/transformIndices/layerIndices/SH），纹理已持有 GPU 端数据 */
+    releaseAggregatedData(): void;
+    /** 释放 SH CPU 端数据（createSHTexture 完成后调用，GPU 纹理已持有数据） */
+    releaseSHData(): void;
+    /** 释放 transformIndices/layerIndices CPU 端数据（纹理已创建且 sortData 已上传后调用） */
+    releaseIndexData(): void;
+    /** 从各 PBMGaussianSplattingObject 重新聚合世界坐标排序数据（当排序数据已释放但需要重新上传时调用） */
+    rebuildSortData(): Promise<void>;
+    getObjectsInOrder(): readonly PBMGaussianSplattingObject[];
+    canIncrementalAppend(nextObjects: PBMGaussianSplattingObject[]): boolean;
+    appendObjects(objectsToAppend: PBMGaussianSplattingObject[]): Promise<boolean>;
+    buildImmediate(wasmModule: any, splat: PBMGaussianSplattingObject): void;
+    private expandFloat32Array;
+    private expandUint32Array;
+    getSplat(index: number): PBMGaussianSplattingObject | null;
+    getLocalIndex(splat: PBMGaussianSplattingObject, index: number): number;
+    dispose(): void;
+    private completeInitialBuild;
+}
+export { RenderData };

package/five/gaussian-splatting/wasm/data.d.ts

@@ -0,0 +1,20 @@
+interface WasmModule {
+    _malloc(size: number): number;
+    _free(ptr: number): void;
+    _pack(
+        selected: boolean,
+        vertexCount: number,
+        positions: number,
+        rotations: number,
+        scales: number,
+        colors: number,
+        selection: number,
+        data: number,
+        worldPositions: number,
+        worldRotations: number,
+        worldScales: number,
+    ): void;
+}
+
+declare const loadWasm: () => Promise<WasmModule>;
+export default loadWasm;