@realsee/dnalogel 3.81.13 → 4.0.0-webgpu.4

package/dist/DigitalPerformanceV2Plugin/core/Playground.d.ts

@@ -1,112 +0,0 @@
-import type { Five } from '@realsee/five';
-import { DigitalPlayground } from './shared';
-import type { DigitalChapter } from './shared';
-import { PerformanceClock } from './PerformanceClock';
-import { CameraDirector } from './CameraDirector';
-import type { DigitalCameraKeyframe, CameraState } from '../typings';
-/** 取章节时长：所有含关键帧的 player 末帧 timeStamp 的最大值 */
-export declare function getChapterDuration(chapter: DigitalChapter): number;
-/**
- * 取章节「模型动画」时长：仅统计 model players 末帧 timeStamp 的最大值（排除 camera player）。
- * 章节总时长以模型动画为准；相机关键帧应被钳制为不超过该总时长，不参与时长计算。
- */
-export declare function getChapterModelDuration(chapter: DigitalChapter): number;
-/**
- * PerformancePlayground —— V2 的章节播放编排（统一时钟驱动）
- *
- * 复用 Shared_Core 的 DigitalPlayground 做模型/动画/道具加载与实例管理，
- * 但用 PerformanceClock 统一驱动 DigitalHuman.renderAtTime，不使用 Legacy 的 playByChapter / 自驱 rAF。
- */
-export type PerformanceRenderListener = (time: number, delta: number) => void;
-export declare class PerformancePlayground {
-    /** 复用 Shared_Core 的加载与实例管理 */
-    readonly loader: DigitalPlayground;
-    /** 运镜导演（消费 camera player，驱动 five 相机） */
-    readonly director: CameraDirector;
-    private readonly clock;
-    private currentChapter;
-    private shownHumans;
-    private renderListeners;
-    private unsubTick;
-    /** 结束当前 pending 的 playByChapter Promise 的句柄（用于 reset 时干净收尾，避免 await 泄漏） */
-    private currentPlayResolve;
-    constructor(five: Five, debug?: boolean);
-    getClock(): PerformanceClock;
-    getCurrentChapter(): DigitalChapter | null;
-    /** 在模型 renderAtTime 完成后执行，供名牌等跟随 UI 使用。 */
-    onRender(listener: PerformanceRenderListener): () => void;
-    setScript(script: Parameters<DigitalPlayground['setScript']>[0]): void;
-    /**
-     * 播放指定章节：准备模型 → 统一时钟驱动 renderAtTime → 自然结束 resolve。
-     * 仅处理模型 player 的渲染；相机运镜在后续任务（CameraDirector 接入）中叠加。
-     * @param opts.prepare 加法式可选：在轨道绑定/attach 完成「之后」、时钟 start「之前」被 await 的钩子，
-     *   用于接管前 prepare（无突变 user→director 切换）。缺省（undefined）保持既有行为不变。
-     *   prepare 在时钟启动前执行，故不计入播放时间（时钟不推进）。失败时静默降级、仍照常播放。
-     */
-    playByChapter(chapter: DigitalChapter, fromTime?: number, opts?: {
-        prepare?: () => Promise<void>;
-    }): Promise<void>;
-    /** 暂停（保留时间） */
-    pause(): void;
-    /**
-     * 加法式新增：播放/预览专用切章准备（不启动时钟）。
-     * 复用 playByChapter 的「模型可见性切换 + 相机轨道重绑」逻辑：隐藏其它章节模型、显示目标章节模型、
-     * 按目标章节运镜重绑或解绑相机轨道（不 attach，故不接管 tick）、将时钟配置为目标章节时长并 seek 到 fromTime，
-     * 最后渲染该帧（模型）。不 start 时钟、不做编辑端联动。供 Controller.setCurrentChapterForPlayback 调用。
-     */
-    prepareChapter(chapter: DigitalChapter, fromTime?: number): void;
-    /**
-     * 加法式新增：立即结束当前 pending 的 playByChapter（resolve 其 Promise）并冻结时钟，
-     * 供连播中「跨章 seek 重定向」使用——上层连播循环 await 返回后据 seekRedirect 跳转到目标章节继续。
-     */
-    abortCurrentPlay(): void;
-    /** 显示目标章节的模型 player（visible + 外部驱动准备），返回展示的 DigitalHuman 列表 */
-    private showChapterModels;
-    /**
-     * 绑定目标章节相机轨道（存在非空 camera player 则绑定；否则解绑），失败静默降级。
-     * @param attach true 则 attach 到时钟（播放接管）；false 仅重绑轨道、detach 不接管（暂停态预览）。
-     */
-    private bindChapterCamera;
-    /** 续播 */
-    resume(): void;
-    /**
-     * 跳转到指定时间并渲染当前帧（seek 预览）。不改变播放/暂停状态。
-     * 有活动 tick 监听时由 clock.seek 触发渲染；否则直接渲染一次。
-     */
-    setTimelineTo(time: number): void;
-    /** 运镜开关（透传到 CameraDirector，立即生效） */
-    setCameraDirectionEnabled(enabled: boolean): void;
-    /** 运动轨迹线开关（默认关闭；透传到 loader，作用于全部 DigitalHuman） */
-    setTraceVisible(visible: boolean): void;
-    /**
-     * 加法式新增：立即将一个 CameraState 应用到 five（透传到 CameraDirector，复用其桥实例）。
-     * 供 controller 的「章节默认视角」应用使用；不改变播放/时钟状态、不绑定轨道。
-     * 统一 Mapview：应用后 five 即合法 orbit 状态，用户可立即正常拖拽。
-     */
-    applyCameraStateImmediately(state: CameraState): void;
-    /**
-     * 加法式新增：暂停态 scrub 预览，应用 `sample(time)`（透传 CameraDirector.previewAt）。
-     * 仅在运镜启用且轨道有内容时生效；否则 no-op。预览后用户可立即正常拖拽（Mapview orbit）。
-     */
-    previewCameraAt(time: number): void;
-    /**
-     * 加法式新增：接管前 prepare（透传到 CameraDirector）。
-     * enabled 且当前轨道有内容时，以内插动画平滑过渡到 `sample(time)` 并在过渡稳定后 resolve；
-     * 否则立即 resolve（no-op）。不触碰时钟/播放状态，调用方应在时钟 start/resume 前 await。
-     */
-    prepareCameraTo(time: number): Promise<void>;
-    /**
-     * 编辑期：用关键帧重建并绑定相机轨道，供后续 seek 预览/播放接管使用。
-     * 空序列时解绑轨道（不接管相机）。
-     * 注意：此处仅重建轨道，不主动 apply 到 five，避免「捕获关键帧」时改变用户当前的自由导航相机。
-     * 相机接管仅发生在播放 tick 或显式 setTimelineTo 预览（统一 Mapview，用户暂停时始终可自由 orbit/平移）。
-     */
-    setCameraKeyframes(keyframes: ReadonlyArray<DigitalCameraKeyframe>): void;
-    /** 重置：停止时钟、隐藏数字人、复位 loader 实例（保留已加载模型与 currentScript） */
-    reset(): void;
-    /** 释放资源 */
-    dispose(): void;
-    private renderShownAt;
-    private hideShownHumans;
-    private stopTick;
-}

package/dist/DigitalPerformanceV2Plugin/core/shared.d.ts

@@ -1,4 +0,0 @@
-export { DigitalStateMachine } from '../../DigitalPerformancePlugin/core/DigitalStateMachine';
-export { DigitalHuman } from '../../DigitalPerformancePlugin/core/DigitalHuman';
-export { DigitalPlayground } from '../../DigitalPerformancePlugin/core/DigitalPlayground';
-export type { DigitalScript, DigitalChapter, DigitalModelPlayer, DigitalSubTitlePlayer, DigitalCameraPlayer, DigitalCameraKeyframe, DigitalModelKeyframe, DigitalModelState, DigitalCameraState, KeyframeType, StateType, } from '../../DigitalPerformancePlugin/core/DigitalStateMachine';

package/dist/DigitalPerformanceV2Plugin/index.d.ts

@@ -1,11 +0,0 @@
-import type { Five } from '@realsee/five';
-import DigitalPerformanceV2PluginController from './controller';
-export { default as DigitalPerformanceV2PluginController } from './controller';
-export type { V2Progress, V2ProgressListener } from './controller';
-export { DigitalPerformanceNameplate, normalizeDigitalPerformanceName, DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH, } from '../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
-export type { DigitalPerformanceNameplateBinding, DigitalPerformanceNameplateOptions, DigitalPerformanceNameplateRenderContext, } from '../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
-export * from './typings';
-export type DigitalPerformanceV2PluginExportInterface = InstanceType<typeof DigitalPerformanceV2PluginController>;
-export type DigitalPerformanceV2PluginParamsInterface = ConstructorParameters<typeof DigitalPerformanceV2PluginController>[1];
-export declare const DigitalPerformanceV2Plugin: (five: Five, params?: DigitalPerformanceV2PluginParamsInterface) => DigitalPerformanceV2PluginController;
-export default DigitalPerformanceV2Plugin;

package/dist/DigitalPerformanceV2Plugin/typings/index.d.ts

@@ -1,124 +0,0 @@
-import type * as THREE from 'three';
-import type { DigitalPerformanceNameplateOptions } from '../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
-export interface DigitalPerformanceV2PluginConfig {
-    /** 是否在加载剧本后自动播放第一个章节 */
-    autoPlay?: boolean;
-    /** 是否循环播放 */
-    loop?: boolean;
-    /** 是否输出调试日志 */
-    debug?: boolean;
-    /** 是否显示人物运动轨迹线（默认 false，不显示）。仅 debug / 特殊需求开启。 */
-    showTrace?: boolean;
-    /**
-     * 是否内置展示模型头顶的 2D 气泡名牌（默认 true）。
-     * 插件会自动挂载到 five canvas 的父容器（与 canvas 同级），消费方只需声明是否展示；
-     * 设为 false 时不挂载任何名牌 DOM。
-     */
-    showNameplate?: boolean;
-    /** 内置名牌的自定义配置（class / 内联样式 / 文本 / 自定义渲染器等）。仅 showNameplate 为真时生效。 */
-    nameplateOptions?: DigitalPerformanceNameplateOptions;
-}
-/**
- * 关键帧到下一关键帧的过渡缓动
- * - 'linear'    : 线性（缺省）
- * - 'easeInOut' : smoothstep 缓入缓出
- * - 'instant'   : 直接 snap，不向下一帧插值
- */
-export type CameraTransition = 'linear' | 'easeInOut' | 'instant';
-/**
- * 运镜关键帧坐标空间（前向兼容标记）
- * - 'five-world' : five 运行时世界系（target 直接来自 five 当前 Mapview 位姿，重播直接消费，不再变换）。缺省按此解释。
- * - 'work-local' : 作品本地坐标系（与模型 player 同口径，加载时需经 transformPosition 变换）。
- * 试点阶段统一写 'five-world'。
- */
-export type CameraCoordinateSpace = 'five-world' | 'work-local';
-/**
- * 运镜关键帧（序列化结构）—— 统一采用 five **Mapview**（地图态 / orbit）位姿。
- *
- * Mapview 下相机绕 `target`（注视点 = orbit 轴心）旋转：
- *   相机位置 = target - coordinatesToVector(longitude, latitude) × distance，视线恒指向 `target`。
- * 这样「播放」「暂停后用户拖拽」「续播」均在同一 orbit 参数系下表达，
- * 暂停即天然交还用户做左键 orbit / 右键平移（无需 look-from→orbit 转换，无跳变）。
- */
-export interface DigitalCameraKeyframe {
-    /** 时间点(ms)，章节内相对时间 */
-    timeStamp: number;
-    /** orbit 目标点（= 注视点 / 旋转轴心），five 世界坐标 [x,y,z] */
-    target: number[];
-    /** 水平角 longitude(rad) */
-    longitude: number;
-    /** 俯仰角 latitude(rad) */
-    latitude: number;
-    /** 相机到 target 的距离(m) */
-    distance: number;
-    /** 视场角（度），表达视角「缩放」 */
-    fov: number;
-    /** 到下一关键帧的过渡缓动（缺省 'linear'） */
-    transition?: CameraTransition;
-    /**
-     * 关键帧缩略图 URL（编辑端封面，运行时忽略）。
-     * 约定存 COS 直传得到的持久化 URL；编辑期的本地 blob 预览不写入此字段。
-     */
-    thumbnail?: string;
-}
-/** 运镜播放器（序列化进 script） */
-export interface DigitalCameraPlayer {
-    name: string;
-    type: 'camera';
-    keyframes: DigitalCameraKeyframe[];
-    /** 关键帧坐标空间（前向兼容标记；缺省按 'five-world' 解释） */
-    coordinateSpace?: CameraCoordinateSpace;
-}
-/**
- * 运行时统一相机状态（采样器输出、桥的输入）—— five Mapview（orbit）位姿。
- * 直接对应 `five.setState({ offset: target, longitude, latitude, distance, fov, mode: 'Mapview' })`。
- */
-export interface CameraState {
-    /** orbit 目标点（注视点 / 旋转轴心），five 世界坐标 */
-    target: THREE.Vector3;
-    /** 水平角 longitude(rad) */
-    longitude: number;
-    /** 俯仰角 latitude(rad) */
-    latitude: number;
-    /** 相机到 target 距离(m) */
-    distance: number;
-    /** 视场角（度） */
-    fov: number;
-}
-/**
- * 组级（整组连续播放）章节时间映射项 —— 加法式新增。
- * 把 N 个章节按各自模型动画时长（getChapterModelDuration）逐章累计成单一组级时间轴上的区间。
- */
-export interface GroupChapterTimeInfo {
-    /** 章节索引（0-based） */
-    index: number;
-    /** 章节名称 */
-    name: string;
-    /** 组级累计起点(ms)：startTime[0]=0，startTime[i]=endTime[i-1] */
-    startTime: number;
-    /** 组级累计终点(ms)：endTime[i]=startTime[i]+duration[i]，endTime[last]=组级总时长 */
-    endTime: number;
-    /** 该章节时长(ms) = getChapterModelDuration（排除 camera player） */
-    duration: number;
-}
-/**
- * 组级（整组连续播放）进度聚合 —— 加法式新增，不替换章节级 V2Progress。
- * 由「各章节 duration 的累计（getGroupChapterTimeMap）」+「当前章节 index」+「当前章节内时间」派生。
- * 字段语义与 Legacy GlobalProgress 对齐，使展示端进度条 UI 可平滑复用。
- */
-export interface GroupProgress {
-    /** 组级当前时间(ms) = 先序章节 duration 之和 + 当前章节内 currentTime（钳制） */
-    groupCurrentTime: number;
-    /** 组级总时长(ms) = 所有章节 duration 之和 */
-    groupTotalTime: number;
-    /** 组级进度百分比 [0,100] = groupCurrentTime / groupTotalTime * 100（groupTotalTime=0 时为 0） */
-    percentage: number;
-    /** 当前章节索引（0-based；无当前章节为 -1） */
-    currentChapterIndex: number;
-    /** 当前章节内时间(ms)（即 V2Progress.currentTime） */
-    currentChapterTime: number;
-    /** 当前章节总时长(ms)（即 V2Progress.totalTime） */
-    currentChapterTotalTime: number;
-    /** 章节总数 */
-    totalChapters: number;
-}

package/dist/FireScenePlugin/FireControl.d.ts

@@ -1,153 +0,0 @@
-import { Five } from '@realsee/five';
-import * as THREE from 'three';
-import type { FireSpreadBounds } from './typing';
-/**
- * 消防演绎的三维实体控制器
- * 管理三类实体：火、烟、消防员
- */
-export declare class FireControl {
-    readonly five: Five;
-    private fireManager;
-    private smokeManager;
-    /** 已添加的起火点 */
-    private fires;
-    /** 已添加的烟雾*/
-    private smokes;
-    /** 已添加的消防员 */
-    private firefighters;
-    /** 消防员加载代次，用于丢弃加载期间已经失效的结果 */
-    private firefighterTokens;
-    /** 粒子贴图 */
-    private particleTexture;
-    private unsubscribeTexture;
-    private resourceConfig;
-    private resourceConfigResolvers;
-    private workUtil;
-    constructor(five: Five);
-    set workCode(workCode: string);
-    get workCode(): string;
-    /** 粒子贴图是否已配置 */
-    get hasParticleTexture(): boolean;
-    /** 消防员模型 URL 是否已配置 */
-    get hasWaterGunModel(): boolean;
-    /** 更新资源配置 */
-    updateResourceConfig(config: {
-        waterGunObj?: string;
-        particleTexture?: string;
-    }): void;
-    /**
-     * 等待某项资源配置就位
-     */
-    waitForResourceConfig(kind: 'particle' | 'firefighter'): Promise<void>;
-    /**
-     * 添加一个起火点
-     */
-    addFire(id: string, position: [number, number, number], options?: {
-        size?: number;
-        floorIndex?: number;
-        fadeInMs?: number;
-    }): void;
-    /**
-     * 让指定起火点开始在给定区域内蔓延。
-     */
-    igniteFire(id: string, bounds: FireSpreadBounds, options?: {
-        spreadSpeed?: number;
-    }): void;
-    /** 熄灭：渐进减少火点直到完全消失 */
-    extinguishFire(id: string, options?: {
-        duration?: number;
-        onComplete?: () => void;
-    }): void;
-    /** 停止熄灭过程 */
-    stopExtinguishFire(id: string): void;
-    /**
-     * 移动起火点
-     */
-    moveFire(id: string, position: [number, number, number]): void;
-    /**
-     * 缩放起火点
-     */
-    scaleFire(id: string, size: number): void;
-    /** 移除起火点 */
-    removeFire(id: string): void;
-    /**
-     * 按楼层控制起火点的可见性
-     */
-    changeFireVisibleByFloorIndex(floorIndex: number | null): void;
-    /**
-     * 添加烟雾。
-     */
-    addSmoke(id: string, position: [number, number, number], options?: {
-        intensity?: number;
-        fadeInMs?: number;
-    }): void;
-    /**
-     * 让烟雾在所属区域内扩散
-     */
-    spreadSmoke(id: string, bounds: FireSpreadBounds, options?: {
-        spreadSpeed?: number;
-    }): void;
-    /**
-     * 移动烟雾。
-     */
-    moveSmoke(id: string, position: [number, number, number]): void;
-    /**
-     * 缩放烟雾
-     */
-    scaleSmoke(id: string, size: number): void;
-    /**
-     * 烟雾渐隐并移除。
-     */
-    dissipateSmoke(id: string, options?: {
-        duration?: number;
-        onComplete?: () => void;
-    }): void;
-    /**
-     * 停止消散
-     */
-    stopDissipateSmoke(id: string): void;
-    /** 移除烟雾 */
-    removeSmoke(id: string): void;
-    /**
-     * 添加消防员。
-     */
-    addFirefighter(options: {
-        id: string;
-        position: [number, number, number];
-        rotation: THREE.Euler;
-        /** 是否喷水 */
-        spray?: boolean;
-        /** 等比缩放 */
-        scale?: number;
-    }): Promise<void>;
-    private invalidateFirefighter;
-    /**
-     * 把相机移到某个实体上（以最佳视角观察它）。
-     */
-    focusEntity(id: string, options?: {
-        scale?: number;
-    }): Promise<void>;
-    /** 移除消防员 */
-    removeFirefighter(id?: string): void;
-    /** 清空所有实体，保留管理器与资源配置 */
-    clearAll(): void;
-    /** 销毁控制器 */
-    destroy(): void;
-    /**
-     * 创建火焰管理器。
-     */
-    private ensureFireManager;
-    /**
-     * 创建烟雾管理器。
-     */
-    private ensureSmokeManager;
-    private ensureParticleTexture;
-    /** 把数据里的 work 局部坐标变换为场景世界坐标 */
-    private toWorld;
-    /**
-     * 把局部坐标的包围盒变换为世界坐标包围盒。
-     */
-    private toWorldBounds;
-    /** 创建消防员的喷水粒子 */
-    private createSprayParticle;
-}

package/dist/FireScenePlugin/SequencePlayer.d.ts

@@ -1,41 +0,0 @@
-import type { FireControl } from './FireControl';
-import type { FireSceneConfig, FireSequenceKind } from './typing';
-/** 播放器配置 */
-export interface FireSequencePlayerOptions {
-    /** 整条序列播完（最后一段动画也结束）后触发 */
-    onSequenceEnd?: (kind: FireSequenceKind) => void;
-}
-/**
- * 消防演绎时间轴播放器
- */
-export declare class FireScenePlayer {
-    private fireControl;
-    private config;
-    private options;
-    private timers;
-    /** 当前正在播放的过程 */
-    private playingKind;
-    /** 已经触发过的动画段，停止时按它逐段去停 */
-    private executedSteps;
-    constructor(fireControl: FireControl, config: FireSceneConfig, options?: FireSequencePlayerOptions);
-    /** 当前是否正在播放 */
-    get playing(): boolean;
-    /**
-     * 播放一条序列。
-     */
-    play(kind: FireSequenceKind): void;
-    /**
-     * 中断播放
-     */
-    stop(): void;
-    dispose(): void;
-    /** 停掉一段已经触发的动画 */
-    private stopStep;
-    private findModel;
-    /**
-     * 计算扩散范围
-     */
-    private getAreaBounds;
-    /** 执行一段动画 */
-    private runStep;
-}

package/dist/FireScenePlugin/constants.d.ts

@@ -1,28 +0,0 @@
-import type { FireModelType, FireSequenceKind } from './typing';
-/**
- * 各动作的播放时长（毫秒）。
- */
-export declare const FIRE_ACTION_DURATION_MS: Record<FireSequenceKind, Partial<Record<FireModelType, number>>>;
-/**
- * 起火点的蔓延速度：值越大，火势铺开越快。
- */
-export declare const FIRE_SPREAD_SPEED = 2;
-/**
- * 浓度渐变的分步间隔（毫秒）。
- */
-export declare const FADE_STEP_MS = 100;
-/**
- * 蔓延的目标覆盖率：铺开的面积占比达到它就停止蔓延。
- */
-export declare const SPREAD_COVERAGE_TARGET = 0.85;
-/**
- * 单次蔓延步进最多新增的网格数。
- */
-export declare const MAX_SPREAD_CELLS_PER_STEP = 320;
-/**
- * 模型的尺寸范围（相对原始尺寸的倍率）。
- */
-export declare const MODEL_SCALE_RANGE: {
-    readonly min: 0.1;
-    readonly max: 5;
-};

package/dist/FireScenePlugin/fire/config.d.ts

@@ -1,10 +0,0 @@
-import type { FireSpreadBounds } from '../typing';
-import type { FireGrowthConfig } from './type';
-/**
- * 默认火焰增长配置
- */
-export declare const DEFAULT_FIRE_GROWTH_CONFIG: FireGrowthConfig;
-/**
- * 由起火区域算火焰蔓延参数。
- */
-export declare const buildFireGrowthConfig: (bounds: FireSpreadBounds, fireSize: number, spreadSpeed: number) => FireGrowthConfig;

package/dist/FireScenePlugin/fire/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * 火焰系统入口
- */
-export { FireManager } from './managers/FireManager';
-export * from './config';
-export * from './type';

package/dist/FireScenePlugin/fire/managers/FireManager.d.ts

@@ -1,76 +0,0 @@
-import * as THREE from 'three';
-import type { FireGrowthConfig } from '../type';
-import type { ParticleTexture } from '../../utils/particleTexture';
-/**
- * 扩展的火焰配置接口，包含火苗大小
- */
-interface ExtendedFireConfig extends Partial<FireGrowthConfig> {
-    fireSize?: number;
-}
-/**
- * 火焰管理器
- */
-export declare class FireManager {
-    private fires;
-    private scene;
-    private particleTexture;
-    private unsubscribeTexture;
-    constructor(scene: THREE.Scene, particleTexture: ParticleTexture);
-    /**
-     * 添加火焰
-     */
-    addFire(id: string, positions: THREE.Vector3[], config?: ExtendedFireConfig): void;
-    /**
-     * 创建火焰粒子
-     */
-    private createFireParticle;
-    /**
-     * 开始增长
-     */
-    private startGrowth;
-    /**
-     * 以起火点为中心，按半径批量扩散
-     */
-    private radialExpand;
-    /**
-     * 更新火焰参数
-     */
-    private updateFireParams;
-    /** 按当前火势与淡入进度刷新该起火点的所有粒子 */
-    private refreshFireParams;
-    /**
-     * 移除火焰
-     */
-    removeFire(id: string): void;
-    /**
-     * 销毁管理器
-     */
-    destroy(): void;
-    /**
-     * 开始灭火过程
-     */
-    startExtinguish(id: string, onComplete?: () => void, extinguishTime?: number): void;
-    /**
-     * 点燃淡入
-     */
-    startFadeIn(id: string, fadeInTime?: number): void;
-    /**
-     * 停止灭火过程
-     */
-    stopExtinguish(id: string): void;
-    /**
-     * 合并配置并重启增长定时器
-     */
-    updateFireConfig(id: string, newConfig: ExtendedFireConfig): void;
-    /**
-     * 移动单个火焰的基础位置
-     */
-    moveFire(id: string, newBasePosition: THREE.Vector3): void;
-    /**
-     * 设置指定火焰的透明度
-     * @param id 火焰ID
-     * @param opacity 透明度 (0-1)
-     */
-    setFireOpacity(id: string, opacity: number): void;
-}
-export {};

package/dist/FireScenePlugin/fire/type.d.ts

@@ -1,51 +0,0 @@
-import * as THREE from 'three';
-import type { Particle } from '@realsee/five/vfx';
-import type { FireSpreadBounds } from '../typing';
-import type { RadialSpread } from '../utils/radialSpread';
-type Timer = ReturnType<typeof setInterval>;
-/**
- * 火焰增长配置接口
- */
-export interface FireGrowthConfig {
-    /** 增长间隔时间(ms) */
-    growthInterval: number;
-    /** 每次增长的倍数 */
-    growthRate: number;
-    /** 最大额外火焰点数量 */
-    maxAdditionalFires: number;
-    /** 蔓延范围 */
-    spreadRange: number;
-    /** 蔓延边界 [minX,minY,minZ,maxX,maxY,maxZ] */
-    bounds?: FireSpreadBounds;
-    /** 目标覆盖率 0-1，默认 0.85 */
-    coverageTarget?: number;
-}
-/**
- * 火焰数据接口
- * 存储单个火焰实例的所有信息
- */
-export interface FireData {
-    /** 火焰ID */
-    id: string;
-    /** 火焰位置 */
-    positions: THREE.Vector3[];
-    /** 增长级别 */
-    growthLevel: number;
-    /** 增长配置 */
-    config: FireGrowthConfig;
-    /** 火焰粒子 */
-    particles: Particle[];
-    /** 增长定时器 */
-    growthTimer?: Timer | null;
-    /** 灭火定时器 */
-    extinguishTimer?: Timer | null;
-    /** 点燃淡入定时器 */
-    fadeInTimer?: Timer | null;
-    /** 点燃淡入进度 0~1 */
-    fadeIn?: number;
-    /** 火苗大小 */
-    fireSize: number;
-    /** 径向扩散器，几何状态都在它内部，与烟雾共用同一套实现 */
-    spread?: RadialSpread;
-}
-export {};

package/dist/FireScenePlugin/index.d.ts

@@ -1,6 +0,0 @@
-export type { FireArea, FireModel, FireModelType, FireSceneConfig, FireSequenceKind, FireSequenceStep, FireSpreadBounds, FireVector3 } from './typing';
-export { FIRE_ACTION_DURATION_MS, FIRE_SPREAD_SPEED, MODEL_SCALE_RANGE } from './constants';
-export { FireControl } from './FireControl';
-export type { FireSequencePlayerOptions } from './SequencePlayer';
-export { FireScenePlayer } from './SequencePlayer';
-export { getAreaBox3, getAreaVertices, getEntryArea } from './utils/areaBounds';

package/dist/FireScenePlugin/smoke/config.d.ts

@@ -1,8 +0,0 @@
-import type { FireSpreadBounds } from '../typing';
-import type { SmokeSpreadOptions } from './managers/SmokeManager';
-/** 扩散出来的烟雾源的渐显时长（毫秒） */
-export declare const SMOKE_SPREAD_FADE_IN_MS = 1000;
-/**
- * 由起火区域算烟雾蔓延参数。
- */
-export declare const buildSmokeSpreadConfig: (bounds: FireSpreadBounds, intensity: number, spreadSpeed: number) => SmokeSpreadOptions;

package/dist/FireScenePlugin/smoke/index.d.ts

@@ -1 +0,0 @@
-export { SmokeManager, type SmokeConfig, type SmokeSpreadOptions } from './managers/SmokeManager';