@realsee/five 6.8.0-alpha.2 → 6.8.0-alpha.21

package/plugins/index.d.ts

@@ -1,1102 +1,9 @@
-import { BasePlugin as BasePlugin_2 } from '@realsee/five/plugins';
-import { Camera } from 'three';
-import { Camera as Camera_2 } from '@realsee/five';
-import { Five } from '@realsee/five';
-import { MOUSE } from 'three';
-import { Scene } from 'three';
-import { Subscribe } from '@realsee/five';
-import * as THREE_2 from 'three';
-import { TOUCH } from 'three';
-import { Trajectory } from '@realsee/five';
-import { Vector3 } from 'three';
-
-export declare const BackgroundPlugin: (five: Five, params?: BackgroundPluginType.Params) => BackgroundPluginController;
-
-export declare class BackgroundPluginController extends BasePlugin_2.Controller<State_3, EventMap_3, any, PluginData_3> {
-    protected data: PluginData_3;
-    state: State_3;
-    private gradientBg?;
-    private groundBg?;
-    private style?;
-    readonly pluginName = "BackgroundPlugin";
-    constructor(five: Five, params?: Params_3);
-    private _onFiveCameraUpdate;
-    private _addEventListener;
-    private _removeEventListener;
-    load: () => Promise<void>;
-    setState: (state: Partial<State_3>, options?: BasePlugin_2.BaseOptions) => void;
-    enable: () => void;
-    disable: (options?: BasePlugin_2.BaseOptions) => void;
-    dispose: () => void;
-}
-
-declare namespace BackgroundPluginType {
-    export {
-        WarningCodeType,
-        Mode,
-        Mirror,
-        State_3 as State,
-        PluginDataItem,
-        PluginData_3 as PluginData,
-        Config_3 as Config,
-        Params_3 as Params,
-        EventMap_3 as EventMap
-    }
-}
-export { BackgroundPluginType }
-
-export declare namespace BasePlugin {
-    /**
-     * 基本属性字段
-     */
-    export interface State {
-        /**
-         * 插件是否启用
-         */
-        enabled: boolean;
-        /**
-         * 插件UI是否展示
-         */
-        visible?: boolean;
-        /**
-         * 插件的配置项
-         */
-        config?: unknown;
-    }
-    export interface BaseOptions {
-        /** 是否是用户行为 */
-        userAction?: boolean;
-    }
-    export interface Config {
-        /** 静态资源前缀 */
-        staticPrefix?: string;
-        /** 国际化转换函数 */
-        i18n?: (key: string) => string;
-    }
-    export interface StateChangeParams<PluginState> {
-        /** 最新的State */
-        state: PluginState;
-        /** 上一个State */
-        prevState?: PluginState;
-        /** 是否是用户触发 */
-        userAction: boolean;
-    }
-    /**
-     * 插件基本事件
-     */
-    export type EventMap<PluginState, PluginData> = {
-        /** 插件被销毁 */
-        dispose: () => void;
-        /** 插件状态变化 */
-        stateChange: (params: StateChangeParams<PluginState>) => void;
-        /** 数据变更 */
-        dataChange: (data: PluginData, prevData?: PluginData) => void;
-        /** 数据加载完成 */
-        dataLoaded: (data: PluginData) => void;
-    };
-    /**
-     * plugin 的基本控制器
-     */
-    export abstract class Controller<PluginState extends State, PluginEventMap extends EventMap<PluginState, PluginData>, PluginServerData, PluginData> {
-        five: Five;
-        protected abstract data?: PluginData;
-        /**
-         * 加载插件依赖数据
-         * @param serverData  - 插件数据
-         * @param state  - 插件 State
-         */
-        abstract load?(serverData: PluginServerData, state?: PluginState, userAction?: boolean): Promise<void>;
-        /**
-         * @description 插件事件钩子
-         */
-        hooks: Subscribe<PluginEventMap>;
-        readonly staticPrefix: string;
-        /**
-         * 当前状态
-         * @description
-         * ```text
-         * 可以通过 plugin.state 和 plugin.setState 来获取和设置。
-         * 通过 state 设置后，plugin 会通过合适的动画运动来达到设置的效果。
-         * 来迎合一些通过数据驱动的场景。
-         * ```
-         */
-        abstract state: PluginState;
-        constructor(five: Five, config?: Config);
-        /**
-         * 获取当前的插件状态，如果当初插件内存在需要通过动画变更的 state 值，则通过此方法可以得到中间状态
-         */
-        getCurrentState(): PluginState;
-        /**
-         * 插件自身DOM添加到父容器
-         * @param wrapper - Element元素
-         */
-        appendTo?(wrapper: Element): void;
-        /**
-         * 展示UI
-         */
-        show?(options?: BaseOptions): Promise<void> | void;
-        /**
-         * 隐藏UI
-         */
-        hide?(options?: BaseOptions): Promise<void> | void;
-        /**
-         * 设置state
-         * @param state  - 插件的目标状态
-         * @param options  - 配置项
-         */
-        setState?(state: Partial<PluginState>, options?: BaseOptions): void;
-        /**
-         * @description 获取静态资源的url
-         */
-        absoluteUrl(url: string): string;
-        /**
-         * 启用插件，让插件能够响应交互
-         */
-        abstract enable(options?: BaseOptions): void;
-        /**
-         * 禁用插件，让插件停止响应交互
-         */
-        abstract disable(options?: BaseOptions): void;
-        /**
-         * 插件进行销毁
-         */
-        abstract dispose(): void;
-    }
-}
-
-/** 插件配置 */
-declare interface Config {
-}
-
-/** 插件配置 */
-declare interface Config_2 {
-    orthoView?: boolean;
-    fixedLongitude?: number;
-}
-
-declare interface Config_3 {
-}
-
-/** 插件配置 */
-declare interface Config_4 {
-    rate?: number;
-}
-
-/** 插件配置 */
-declare interface Config_5 {
-    maxOpacity: number;
-}
-
-/** 插件配置 */
-declare interface Config_6 {
-    /** 线条数量 */
-    lineCount?: number;
-    /** 线条间距 */
-    spacing?: number;
-    /** 线宽 */
-    lineWidth?: number;
-    /** 线条颜色 */
-    color?: number;
-    /** 流光速度（单位距离/秒，值越大速度越快） */
-    speed?: number;
-    /** 流光过渡范围（单位：米，默认 5.0） */
-    range?: number;
-    /** 波动幅度 */
-    waveAmp?: number;
-    /** 波动频率 */
-    waveFreq?: number;
-    /** 粒子数量 */
-    particleCount?: number;
-    /** 粒子最大飘散距离 */
-    maxDistance?: number;
-    /** pathline Y 轴偏移（相对于 subMesh 向上偏移） */
-    lineYOffset?: number;
-    /** 子网格宽度 */
-    subMeshWidth?: number;
-    /** 子网格底色 */
-    subMeshColor?: number;
-    /** 子网格基础透明度（最小透明度） */
-    subMeshOpacity?: number;
-    /** 子网格最大透明度（流光中心的透明度，默认 1.0） */
-    subMeshMaxOpacity?: number;
-    /** 子网格流光分段间隔（单位：米，默认 3.0） */
-    subMeshSegmentInterval?: number;
-    /** 子网格流光高亮带宽度（单位：米，默认 1.5） */
-    subMeshHighlightWidth?: number;
-}
-
-declare interface ConfigChangeEvent {
-    /** 变更前的 config */
-    prevConfig: Config_5;
-    /** 变更后的 config */
-    config: Config_5;
-    /** 是否是用户操作 */
-    userAction: boolean;
-}
-
-export declare class CSS3DRenderer {
-
-    	constructor();
-    	domElement: HTMLElement;
-
-    	getSize(): { width: number, height: number };
-    	setSize( width: number, height: number ): void;
-    	render( scene: Scene, camera: Camera ): void;
-
-}
-
-export declare const DynamicPathLinePlugin: (five: Five, params?: DynamicPathLinePluginType.Params) => DynamicPathLinePluginController;
-
-export declare class DynamicPathLinePluginController extends BasePlugin_2.Controller<DynamicPathLinePluginType.State, DynamicPathLinePluginType.EventMap, DynamicPathLinePluginType.ServerData, DynamicPathLinePluginType.PluginData> {
-    /** 当前使用的数据 */
-    data?: DynamicPathLinePluginType.PluginData;
-    /** 插件当前状态 */
-    state: DynamicPathLinePluginType.State;
-    /** config 的原始值 */
-    private _config;
-    get config(): {
-        lineCount: number;
-        spacing: number;
-        lineWidth: number;
-        color: number;
-        speed: number;
-        range: number;
-        waveAmp: number;
-        waveFreq: number;
-        particleCount: number;
-        maxDistance: number;
-        lineYOffset: number;
-        subMeshWidth: number;
-        subMeshColor: number;
-        subMeshOpacity: number;
-        subMeshMaxOpacity: number;
-        subMeshSegmentInterval: number;
-        subMeshHighlightWidth: number;
-    };
-    private paths;
-    private up;
-    private updateState;
-    constructor(five: Five, params?: DynamicPathLinePluginType.Params);
-    /**
-     * 加载服务端数据
-     */
-    load(serverData: DynamicPathLinePluginType.ServerData, state?: DynamicPathLinePluginType.State): Promise<void>;
-    /**
-     * 添加路径
-     */
-    addPath(pathConfig: DynamicPathLinePluginType.PathConfig): boolean;
-    /**
-     * 移除路径
-     */
-    removePath(pathId: string): boolean;
-    /**
-     * 启用路径
-     */
-    enablePath(pathId: string): boolean;
-    /**
-     * 禁用路径
-     */
-    disablePath(pathId: string): boolean;
-    /**
-     * 显示路径
-     */
-    showPath(pathId: string): boolean;
-    /**
-     * 隐藏路径
-     */
-    hidePath(pathId: string): boolean;
-    /**
-     * 获取所有路径ID
-     */
-    getPathIds(): string[];
-    /**
-     * 获取路径配置
-     */
-    getPathConfig(pathId: string): DynamicPathLinePluginType.PathConfig | undefined;
-    /**
-     * 清空所有路径
-     */
-    clearAllPaths(): void;
-    private getPositions;
-    private createLines;
-    private createParticleMaterial;
-    private createParticles;
-    /**
-     * 创建子网格面片的几何体
-     */
-    private createSubMeshGeometry;
-    /**
-     * 创建流光的 alpha 贴图
-     * @param segmentCount - 分段数（流光数量）
-     * @param highlightWidthInMeters - 单个高亮带的物理宽度（单位：米）
-     * @param totalLength - 路径总长度（单位：米）
-     * @param baseOpacity - 基础透明度（0-1）
-     * @param maxOpacity - 最大透明度（0-1）
-     * @returns DataTexture
-     */
-    private createAlphaMapTexture;
-    /**
-     * 创建子网格面片的材质
-     */
-    private createSubMeshMaterial;
-    /**
-     * 将路径点投影到屏幕空间
-     */
-    private projectPointsToScreen;
-    /**
-     * 找到最近的屏幕外点
-     */
-    private findNearestOffscreenPoint;
-    /**
-     * 找到最远的屏幕外点（从终点反向搜索）
-     */
-    private findFarestOffscreenPoint;
-    private updatePathAnimation;
-    /**
-     * 启动指定路径的动画
-     * @param pathId - 路径ID
-     * @param options - 配置选项
-     */
-    startPathAnimation(pathId: string, options?: {
-        startPointIndex?: number;
-        fromStart?: boolean;
-    }): boolean;
-    /**
-     * 停止指定路径的动画
-     */
-    stopPathAnimation(pathId: string, saveProgress?: boolean): boolean;
-    private _enable;
-    private _disable;
-    /**
-     * 启用插件
-     */
-    enable(options?: BasePlugin_2.BaseOptions): void;
-    /**
-     * 禁用插件
-     */
-    disable(options?: BasePlugin_2.BaseOptions): void;
-    /**
-     * 显示插件
-     */
-    show(options?: BasePlugin_2.BaseOptions): void;
-    /**
-     * 隐藏插件
-     */
-    hide(options?: BasePlugin_2.BaseOptions): void;
-    /**
-     * 设置状态
-     */
-    setState(state: Partial<DynamicPathLinePluginType.State>, options?: BasePlugin_2.BaseOptions): void;
-    /**
-     * 播放动画
-     */
-    play(fromStart?: boolean): void;
-    /**
-     * 暂停动画
-     */
-    pause(): void;
-    /**
-     * 重置动画状态（不自动开始播放）
-     */
-    reset(): void;
-    highlightPath(pathId: string, highlight: boolean): void;
-    /**
-     * 更新指定路径的屏幕空间投影优化
-     * @param pathId - 路径ID，如果不提供则更新所有路径
-     */
-    updateScreenProjection(pathId?: string): void;
-    private disposePathResources;
-    /**
-     * 销毁插件
-     */
-    dispose(): void;
-}
-
-declare namespace DynamicPathLinePluginType {
-    export {
-        PathConfig,
-        PluginData_6 as PluginData,
-        ServerData_5 as ServerData,
-        Config_6 as Config,
-        Params_6 as Params,
-        State_6 as State,
-        EventMap_6 as EventMap
-    }
-}
-export { DynamicPathLinePluginType }
-
-/** 插件事件 */
-declare interface EventMap extends BasePlugin.EventMap<State, ServerData> {
-}
-
-/** 插件事件 */
-declare interface EventMap_2 extends BasePlugin.EventMap<State_2, ServerData_2> {
-}
-
-declare interface EventMap_3 extends BasePlugin_2.EventMap<State_3, PluginData_3> {
-    /**
-     * @param event - event.userAction是否是用户操作
-     * @description enabled 从 false 到 true 的回调
-     */
-    enable: (event: {
-        userAction: boolean;
-    }) => void;
-    /**
-     * @param event - event.userAction是否是用户操作
-     * @description enabled 从 true 到 false 的回调
-     */
-    disable: (event: {
-        userAction: boolean;
-    }) => void;
-    /**
-     * @description 插件 dispose
-     * */
-    dispose: () => void;
-    click: (index: number) => void;
-    /**
-     * @description 历史堆栈更新
-     * @param historyStackLength - 历史堆栈当前数量
-     * */
-    historyLengthChange: (historyStackLength: number) => void;
-}
-
-/** 插件事件 */
-declare interface EventMap_4 extends BasePlugin.EventMap<State_4, ServerData_3> {
-}
-
-/** 插件事件 */
-declare interface EventMap_5 extends BasePlugin_2.EventMap<State_5, PluginData_5> {
-    drawingChange: (drawing: boolean) => void;
-    /** config 变更的回调 */
-    configChange: (event: {
-        prevConfig: Config_5;
-        config: Config_5;
-        userAction: boolean;
-    }) => void;
-}
-
-/** 插件事件 */
-declare interface EventMap_6 extends BasePlugin.EventMap<State_6, PluginData_6> {
-    /** 动画开始播放 */
-    animationStart: () => void;
-    /** 动画停止播放 */
-    animationStop: () => void;
-    /** 路径添加 */
-    pathAdd: (pathId: string, config: PathConfig) => void;
-    /** 路径移除 */
-    pathRemove: (pathId: string) => void;
-    /** 路径启用 */
-    pathEnable: (pathId: string) => void;
-    /** 路径禁用 */
-    pathDisable: (pathId: string) => void;
-    /** 路径显示 */
-    pathShow: (pathId: string) => void;
-    /** 路径隐藏 */
-    pathHide: (pathId: string) => void;
-}
-
-export declare class ItemMaskController extends BasePlugin.Controller<ItemMaskPluginType.State, ItemMaskPluginType.EventMap, ItemMaskPluginType.ServerData, ItemMaskPluginType.PluginData> {
-    /** 当前使用的数据 */
-    data?: ItemMaskPluginType.PluginData;
-    /** 插件当前状态 */
-    state: ItemMaskPluginType.State;
-    /** config 的原始值 */
-    private _config;
-    get config(): {};
-    private canvas;
-    private group;
-    private updateState;
-    private wrapper;
-    private style;
-    private tapPosition?;
-    private stopAnimation?;
-    private itemMaskMesh;
-    constructor(five: Five, params?: ItemMaskPluginType.Params);
-    load(data: ItemMaskPluginType.ServerData): Promise<void>;
-    private onFivePanoArrived;
-    private onFiveWantsMoveToPano;
-    private loadPanoMask;
-    private onFiveMouseMove;
-    private onFiveTapGesture;
-    private changeTapScreenPosition;
-    private onFiveCameraUpdate;
-    /** 更改插件 State */
-    setState(state: Partial<ItemMaskPluginType.State>, options?: BasePlugin.BaseOptions): void;
-    setMode(mode: ItemMaskPluginType.State['mode']): void;
-    select(name?: string, options?: {
-        userAction: boolean;
-    }): void;
-    selectAll(bool?: boolean): void;
-    private _enable;
-    private _disable;
-    /**
-     * 启用插件，让插件能够响应交互
-     */
-    enable(options?: BasePlugin.BaseOptions): void;
-    /**
-     * 禁用插件，让插件停止响应交互
-     */
-    disable(options?: BasePlugin.BaseOptions): void;
-    /** 销毁插件，移除所有副作用，销毁后将不响应任何 API */
-    dispose: () => void;
-}
-
-export declare const ItemMaskPlugin: (five: Five, params?: ItemMaskPluginType.Params) => ItemMaskController;
-
-declare namespace ItemMaskPluginType {
-    export {
-        ItemType,
-        MaskType,
-        PluginData,
-        ServerData,
-        Config,
-        Params,
-        State,
-        EventMap
-    }
-}
-export { ItemMaskPluginType }
-
-declare interface ItemType {
-    category_name: string;
-    category_cn: string;
-    index: number;
-    derived_id: string;
-    longitude: number;
-    latitude: number;
-    fov: number;
-    width: number;
-    height: number;
-    position: {
-        start: number[];
-        end: number[];
-        rotation: number[];
-    };
-    mask_color: number[];
-    visible_viewpoint: {
-        [key: string]: Record<any, any>;
-    };
-}
-
-declare interface Keyframe_2 {
-    position: THREE_2.Vector3;
-    location: number;
-}
-export { Keyframe_2 as Keyframe }
-
-declare interface MaskType {
-    derived_id: string;
-    index: number;
-    object_mask_url: string;
-}
-
-declare type Mirror<T extends string> = Record<T, T>;
-
-declare type Mode = 'Idle' | 'View' | 'Marking' | 'Waiting';
-
-export declare class OrbitControls {
-
-    	constructor( object: Camera, domElement?: HTMLElement );
-
-    	object: Camera;
-    	domElement: HTMLElement | HTMLDocument;
-
-    	// API
-    	enabled: boolean;
-    	target: Vector3;
-
-    	// deprecated
-    	center: Vector3;
-
-    	minDistance: number;
-    	maxDistance: number;
-
-    	minZoom: number;
-    	maxZoom: number;
-
-    	minPolarAngle: number;
-    	maxPolarAngle: number;
-
-    	minAzimuthAngle: number;
-    	maxAzimuthAngle: number;
-
-    	enableDamping: boolean;
-    	dampingFactor: number;
-
-    	enableZoom: boolean;
-    	zoomSpeed: number;
-
-    	enableRotate: boolean;
-    	rotateSpeed: number;
-
-    	enablePan: boolean;
-    	panSpeed: number;
-    	screenSpacePanning: boolean;
-    	keyPanSpeed: number;
-
-    	autoRotate: boolean;
-    	autoRotateSpeed: number;
-
-    	enableKeys: boolean;
-    	keys: { LEFT: number; UP: number; RIGHT: number; BOTTOM: number; };
-    	mouseButtons: { LEFT: MOUSE; MIDDLE: MOUSE; RIGHT: MOUSE; };
-    	touches: { ONE: TOUCH; TWO: TOUCH };
-
-    	update(): boolean;
-
-    	saveState(): void;
-
-    	reset(): void;
-
-    	dispose(): void;
-
-    	getPolarAngle(): number;
-
-    	getAzimuthalAngle(): number;
-
-    	// EventDispatcher mixins
-    	addEventListener( type: string, listener: ( event: any ) => void ): void;
-
-    	hasEventListener( type: string, listener: ( event: any ) => void ): boolean;
-
-    	removeEventListener( type: string, listener: ( event: any ) => void ): void;
-
-    	dispatchEvent( event: { type: string; target: any; } ): void;
-
-}
-
-export declare const OrientationPlugin: (five: Five, params?: OrientationPluginType.Params) => OrientationPluginController;
-
-export declare class OrientationPluginController extends BasePlugin.Controller<OrientationPluginType.State, OrientationPluginType.EventMap, OrientationPluginType.ServerData, OrientationPluginType.PluginData> {
-    /** 当前使用的数据 */
-    data?: OrientationPluginType.PluginData;
-    /** 插件当前状态 */
-    state: OrientationPluginType.State;
-    /** config 的原始值 */
-    private _config;
-    camera: Camera_2;
-    scene: THREE_2.Scene;
-    renderer: THREE_2.WebGLRenderer;
-    css3drenderer: CSS3DRenderer;
-    ambientLight: THREE_2.AmbientLight;
-    wrapper: HTMLDivElement;
-    private arrows;
-    private arrowLeft;
-    private arrowRight;
-    private arrowFront;
-    private arrowBack;
-    private arrowTop;
-    private arrowBottom;
-    private mc?;
-    private cameraAnimation?;
-    private cylinder;
-    private spherical;
-    private dragging;
-    private style;
-    directionalLight: THREE_2.DirectionalLight;
-    box: THREE_2.Mesh<RoundedBoxGeometry, THREE_2.MeshPhongMaterial>;
-    faces: THREE_2.Group;
-    controls?: OrbitControls;
-    get config(): {
-        orthoView: boolean;
-        fixedLongitude: number;
-    };
-    private updateState;
-    constructor(five: Five, params?: OrientationPluginType.Params);
-    appendTo(container: HTMLElement): void;
-    init(): void;
-    initDom(): void;
-    bindEvents(): void;
-    unbindEvents(): void;
-    orient: ({ longitude, latitude }: {
-        longitude?: number;
-        latitude?: number;
-    }) => void;
-    private updateByCamera;
-    private updateArrows;
-    private handleArrowsVisible;
-    private onRenderFrame;
-    private onTapGesture;
-    private onFiveWantsGesture;
-    private onFiveModeChange;
-    private onCameraUpdate;
-    private onPanStart;
-    private onMouseMove;
-    private onPanEnd;
-    /** 更改插件 State */
-    setState(state: Partial<OrientationPluginType.State>, options?: BasePlugin.BaseOptions): void;
-    private initLights;
-    private initFaces;
-    private initControls;
-    load(data: OrientationPluginType.ServerData): Promise<void>;
-    private _enable;
-    private _disable;
-    /**
-     * 启用插件，让插件能够响应交互
-     */
-    enable(options?: BasePlugin.BaseOptions): void;
-    /**
-     * 禁用插件，让插件停止响应交互
-     */
-    disable(options?: BasePlugin.BaseOptions): void;
-    /** 销毁插件，移除所有副作用，销毁后将不响应任何 API */
-    dispose: () => void;
-}
-
-declare namespace OrientationPluginType {
-    export {
-        PluginData_2 as PluginData,
-        ServerData_2 as ServerData,
-        Config_2 as Config,
-        Params_2 as Params,
-        State_2 as State,
-        EventMap_2 as EventMap
-    }
-}
-export { OrientationPluginType }
-
-export declare class PanoAnimeController extends BasePlugin_2.Controller<PanoAnimePluginType.State, PanoAnimePluginType.EventMap, PanoAnimePluginType.ServerData, PanoAnimePluginType.PluginData> {
-    /** 当前使用的数据 */
-    data?: PanoAnimePluginType.PluginData;
-    /** 插件当前状态 */
-    state: PanoAnimePluginType.State;
-    /** config 的原始值 */
-    private _config;
-    get config(): {
-        maxOpacity: number;
-    };
-    private group;
-    private canvas?;
-    private ctx?;
-    private startTime?;
-    private updateState;
-    /**
-     * 更改插件 Config
-     * @param config - 插件属性 `config` 的子集。
-     * @param options - 参数
-     */
-    updateConfig(config: Partial<PanoAnimePluginType.Config>, options?: BasePlugin_2.BaseOptions): void;
-    private mesh;
-    private panoMesh;
-    constructor(five: Five, params?: PanoAnimePluginType.Params);
-    load(data: PanoAnimePluginType.ServerData): Promise<void>;
-    private stop;
-    private drawLine;
-    private anime;
-    private _enable;
-    private _disable;
-    /**
-     * 启用插件，让插件能够响应交互
-     */
-    enable(options?: BasePlugin_2.BaseOptions): void;
-    /**
-     * 禁用插件，让插件停止响应交互
-     */
-    disable(options?: BasePlugin_2.BaseOptions): void;
-    /** 更改插件 State */
-    setState(state: Partial<PanoAnimePluginType.State>, options?: BasePlugin_2.BaseOptions): void;
-    /** 销毁插件，移除所有副作用，销毁后将不响应任何 API */
-    dispose: () => void;
-}
-
-export declare const PanoAnimePlugin: (five: Five, params?: PanoAnimePluginType.Params) => PanoAnimeController;
-
-declare namespace PanoAnimePluginType {
-    export {
-        PluginData_5 as PluginData,
-        ServerData_4 as ServerData,
-        Config_5 as Config,
-        Params_5 as Params,
-        State_5 as State,
-        ConfigChangeEvent,
-        EventMap_5 as EventMap
-    }
-}
-export { PanoAnimePluginType }
-
-/** 插件初始化参数 */
-declare interface Params {
-    config?: Partial<Config>;
-    initialState?: Partial<State>;
-}
-
-/** 插件初始化参数 */
-declare interface Params_2 {
-    config?: Partial<Config_2>;
-    initialState?: Partial<State_2>;
-}
-
-declare interface Params_3 {
-    config?: Partial<Config_3>;
-    initialState?: Partial<State_3>;
-}
-
-/** 插件初始化参数 */
-declare interface Params_4 {
-    config: Partial<Config_4>;
-    initialState?: Partial<State_4>;
-}
-
-/** 插件初始化参数 */
-declare interface Params_5 {
-    config?: Partial<Config_5>;
-    initialState?: Partial<State_5>;
-}
-
-/** 插件初始化参数 */
-declare interface Params_6 {
-    config?: Partial<Config_6>;
-    initialState?: Partial<State_6>;
-    /** 初始路径配置列表 */
-    paths?: PathConfig[];
-}
-
-/** 路径配置 */
-declare interface PathConfig {
-    /** 路径唯一标识 */
-    id: string;
-    /** 路径点 */
-    points: THREE_2.Vector3[];
-    /** 是否启用 */
-    enabled?: boolean;
-    /** 是否可见 */
-    visible?: boolean;
-    /** 线条颜色（可选，覆盖全局配置） */
-    color?: number;
-    /** 线宽（可选，覆盖全局配置） */
-    lineWidth?: number;
-    /** 子网格颜色（可选，覆盖全局配置） */
-    subMeshColor?: number;
-    /** 子网格宽度（可选，覆盖全局配置） */
-    subMeshWidth?: number;
-    /** 子网格透明度（可选，覆盖全局配置） */
-    subMeshOpacity?: number;
-    /** 流光速度（可选，覆盖全局配置，单位：米/秒） */
-    speed?: number;
-    /** 流光范围（可选，覆盖全局配置，单位：米，默认 5.0） */
-    range?: number;
-    /** 是否启用子网格（可选，默认 true） */
-    enableSubMesh?: boolean;
-    /** 是否启用路径线和粒子效果（可选，默认 true） */
-    enablePathline?: boolean;
-}
-
-export declare interface PlayingState {
-    keyframeIndex: number | null;
-    progress: number | null;
-}
-
-declare type PluginData = {
-    data_list: ItemType[];
-    object_mask_list: MaskType[];
-};
-
-declare type PluginData_2 = any;
-
-declare type PluginData_3 = PluginDataItem;
-
-declare type PluginData_4 = any;
-
-declare type PluginData_5 = {};
-
-/** 插件数据 */
-declare type PluginData_6 = {
-    paths: Map<string, PathConfig>;
-};
-
-declare interface PluginDataItem {
-}
-
-declare namespace PluginTemplateType {
-    export {
-        PluginData_4 as PluginData,
-        ServerData_3 as ServerData,
-        Config_4 as Config,
-        Params_4 as Params,
-        State_4 as State,
-        EventMap_4 as EventMap
-    }
-}
-export { PluginTemplateType }
-
-export declare class RoundedBoxGeometry extends THREE_2.BufferGeometry {
-    parameters: {
-        width: number;
-        height: number;
-        depth: number;
-        radius: number;
-        radiusSegments: number;
-    };
-    constructor(width: number, height: number, depth: number, radius: number, radiusSegments: number);
-}
-
-declare type ServerData = {
-    data_list: ItemType[];
-    object_mask_list: MaskType[];
-};
-
-declare type ServerData_2 = any;
-
-declare type ServerData_3 = {
-    trajectory: Trajectory;
-};
-
-declare type ServerData_4 = {};
-
-/** 服务端数据 */
-declare type ServerData_5 = {
-    paths: Array<{
-        id: string;
-        points: Array<{
-            x: number;
-            y: number;
-            z: number;
-        }>;
-        enabled?: boolean;
-        visible?: boolean;
-        color?: number;
-        lineWidth?: number;
-        subMeshColor?: number;
-        subMeshWidth?: number;
-        subMeshOpacity?: number;
-        speed?: number;
-        range?: number;
-        enableSubMesh?: boolean;
-        enablePathline?: boolean;
-    }>;
-};
-
-/** 插件状态 */
-declare interface State extends BasePlugin.State {
-    /** 插件是否启用 */
-    enabled: boolean;
-    /** 插件整体是否可见 */
-    visible: boolean;
-    /** 插件模式 */
-    mode: 'mask' | 'box';
-    /** 选中ID */
-    selectedId: string | null;
-    /** 全选 */
-    selectAll: boolean;
-}
-
-/** 插件状态 */
-declare interface State_2 extends BasePlugin.State {
-    /** 插件是否启用 */
-    enabled: boolean;
-    /** 插件整体是否可见 */
-    visible: boolean;
-    /** 箭头操作是否可见 */
-    arrowsVisible: boolean;
-}
-
-declare type State_3 = {
-    enabled: boolean;
-};
-
-/** 插件状态 */
-declare interface State_4 extends BasePlugin.State {
-    /** 插件是否启用 */
-    enabled: boolean;
-    /** 插件整体是否可见 */
-    visible: boolean;
-}
-
-/** 插件状态 */
-declare interface State_5 extends BasePlugin_2.State {
-    /** 插件是否启用 */
-    enabled: boolean;
-    /** 插件整体是否可见 */
-    visible: boolean;
-}
-
-/** 插件状态 */
-declare interface State_6 extends BasePlugin.State {
-    /** 插件是否启用 */
-    enabled: boolean;
-    /** 插件整体是否可见 */
-    visible: boolean;
-    /** 动画是否正在播放 */
-    playing: boolean;
-}
-
-export declare class TrajectoryController extends BasePlugin.Controller<PluginTemplateType.State, PluginTemplateType.EventMap, PluginTemplateType.ServerData, PluginTemplateType.PluginData> {
-    /** 当前使用的数据 */
-    data?: PluginTemplateType.PluginData;
-    /** 插件当前状态 */
-    state: PluginTemplateType.State;
-    /** config 的原始值 */
-    private _config;
-    get config(): {
-        rate?: number;
-    };
-    private cancelAnimation;
-    private playingState;
-    totalDistance: number;
-    location: number;
-    nextKeyframe: Keyframe_2 | null;
-    nextButOneKeyframe: Keyframe_2 | null;
-    currentKeyFrame: Keyframe_2 | null;
-    trajectory: Trajectory | null;
-    keyframes: Keyframe_2[];
-    rate: number;
-    skipStart: number;
-    skipEnd: number;
-    private virualCamera;
-    private timeArray;
-    startTimestamp: number | null;
-    playbackStartTime: number | null;
-    playbackEndTime: number | null;
-    private updateState;
-    constructor(five: Five, params?: PluginTemplateType.Params);
-    load(data: PluginTemplateType.ServerData): Promise<void>;
-    loadTrajectory(trajectory: Trajectory): void;
-    setPlayingState(playingState: Partial<PlayingState>): void;
-    private _enable;
-    play(): void;
-    pause(): void;
-    /**
-     * 基于真实时间戳播放轨迹动画
-     * 使用 timeArray 中的时间戳，按照真实时间播放
-     */
-    playByTimestamp(): void;
-    findKeyFrameByLocation(location: number): number | {
-        keyframeIndex: number;
-        progress: number;
-    };
-    /**
-     * 根据时间戳找到最近的 keyframe
-     * @returns keyframe 索引，如果找不到返回 undefined
-     */
-    findKeyFrameByTimestamp(timestamp: number): number | undefined;
-    resetPlayingState(): void;
-    /**
-     * 获取总播放时间（毫秒）
-     * 考虑 skipStart 和 skipEnd
-     * @returns 总时间（毫秒），如果轨迹未加载则返回 null
-     */
-    getTotalTime(): number | null;
-    /**
-     * 设置时间戳模式的播放状态并继续播放
-     */
-    setPlayingStateByTimestamp(keyframeIndex: number): void;
-    private _disable;
-    /**
-     * 启用插件，让插件能够响应交互
-     */
-    enable(options?: BasePlugin.BaseOptions): void;
-    /**
-     * 禁用插件，让插件停止响应交互
-     */
-    disable(options?: BasePlugin.BaseOptions): void;
-    /** 销毁插件，移除所有副作用，销毁后将不响应任何 API */
-    dispose: () => void;
-}
-
-export declare const TrajectoryPlugin: (five: Five, params?: PluginTemplateType.Params) => TrajectoryController;
-
-declare enum WarningCodeType {
-    Warning_1 = "CAN_NOT_DRAW_ZONE"
-}
-
-export { }
+export * from './BasePlugin';
+export * from './ItemMaskPlugin';
+export * from './OrientationPlugin';
+export * from './BackgroundPlugin';
+export * from './TrajectoryPlugin';
+export * from './PanoAnimePlugin';
+export * from './DynamicPathLinePlugin';
+export { CSS3DRenderer } from './thirdParty/CSS3DRenderer';
+export { OrbitControls } from './thirdParty/OrbitControls';