@realsee/dnalogel 3.81.11-alpha.3 → 3.81.12-alpha.1

package/CHANGELOG.md

@@ -1,4 +1,8 @@
 # CHANGELOG
+## 3.81.12
+
+- feat(FireScenePlugin): 新增消防演绎插件
+- 
 
 ## 3.81.10
 

package/dist/DigitalPerformancePlugin/controller/index.d.ts

@@ -22,8 +22,6 @@ export default class DigitalPerformancePluginController {
     private progressUpdateTimer;
     private _autoPlayOnNaturalEnd;
     private playingPlayersListeners;
-    private nameplate;
-    private readonly onNameplateRender;
     constructor(five: Five, config?: DigitalPerformancePluginConfig);
     /**
      * 加载剧本数据
@@ -105,9 +103,6 @@ export default class DigitalPerformancePluginController {
      * 获取数字人实例
      */
     getDigitalHuman(modelUrl: string, id?: string): DigitalHuman | null;
-    /** 实时修改角色名牌；不重新加载模型和动画资源。 */
-    updateModelName(id: string, value: string): void;
-    private syncNameplates;
     /**
      * 获取当前播放进度信息
      */

package/dist/DigitalPerformancePlugin/core/DigitalStateMachine.d.ts

@@ -32,9 +32,7 @@ interface DigitalModelPlayerEffect {
 }
 interface DigitalModelPlayer {
     id: string;
-    /** 兼容已有 name；业务需要独立展示字段时优先使用 displayName。 */
     name: string;
-    displayName?: string;
     type: 'model';
     model: string;
     keyframes: DigitalModelKeyframe[];

package/dist/DigitalPerformancePlugin/index.d.ts

@@ -1,7 +1,5 @@
 import type { Five } from '@realsee/five';
 import DigitalPerformancePluginController from './controller';
-export { DigitalPerformanceNameplate, normalizeDigitalPerformanceName, DEFAULT_DIGITAL_PERFORMANCE_NAME_MAX_LENGTH, } from './core/DigitalPerformanceNameplate';
-export type { DigitalPerformanceNameplateBinding, DigitalPerformanceNameplateOptions, DigitalPerformanceNameplateRenderContext, } from './core/DigitalPerformanceNameplate';
 export { DigitalHuman } from './core/DigitalHuman';
 export { DigitalPlayground } from './core/DigitalPlayground';
 export { DigitalStateMachine } from './core/DigitalStateMachine';

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

@@ -1,18 +1,10 @@
 import * as THREE from 'three';
 import type { DigitalChapter } from '../core/DigitalStateMachine';
-import type { DigitalPerformanceNameplateOptions } from '../core/DigitalPerformanceNameplate';
 export type { DigitalScript, DigitalChapter, DigitalModelPlayer, DigitalSubTitlePlayer, DigitalCameraPlayer, DigitalModelKeyframe, DigitalSubTitleKeyframe, DigitalCameraKeyframe, DigitalModelState, DigitalSubTitleState, DigitalCameraState, DigitalModelPlayerItem, DigitalModelPlayerEffect, DigitalEffectKeyframe, DigitalDataState, DigitalDataPlayer, KeyframeType, StateType, } from '../core/DigitalStateMachine';
 export interface DigitalPerformancePluginConfig {
     autoPlay?: boolean;
     loop?: boolean;
     debug?: boolean;
-    /**
-     * 是否展示模型头顶的 2D 气泡名牌（默认 true）。
-     * 插件会内置挂载到 five canvas 的父容器，调用方无需提供容器，仅需声明是否展示。
-     */
-    showNameplate?: boolean;
-    /** 内置名牌的自定义配置（class / 内联样式 / 文本 / 自定义渲染器等）。仅 showNameplate 为真时生效。 */
-    nameplateOptions?: DigitalPerformanceNameplateOptions;
 }
 export interface GlobalProgress {
     currentTime: number;

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

@@ -80,9 +80,6 @@ export default class DigitalPerformanceV2PluginController {
     private groupProgressListeners;
     private keyframesChangedListeners;
     private currentChapterChangedListeners;
-    private nameplate;
-    private unsubNameplateRender;
-    private unsubNameplateCameraUpdate;
     private unsubClockTick;
     /**
      * 进入编辑时的运镜内存态快照：以章节对象为 key，值为该章节相机关键帧的深拷贝；
@@ -355,9 +352,6 @@ export default class DigitalPerformanceV2PluginController {
         playing: boolean;
         currentChapter: DigitalChapter | null;
     };
-    /** 实时修改角色名牌；只更新文本和当前剧本，不重新加载模型/动画。 */
-    updateModelName(id: string, value: string): void;
-    private syncNameplates;
     /** 重置播放（保留已加载资源） */
     reset(): void;
     /** 销毁插件、释放资源 */

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

@@ -17,7 +17,6 @@ export declare function getChapterModelDuration(chapter: DigitalChapter): number
  * 复用 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;
@@ -26,15 +25,12 @@ export declare class PerformancePlayground {
     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。

package/dist/DigitalPerformanceV2Plugin/index.d.ts

@@ -2,8 +2,6 @@ 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];

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

@@ -1,5 +1,4 @@
 import type * as THREE from 'three';
-import type { DigitalPerformanceNameplateOptions } from '../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate';
 export interface DigitalPerformanceV2PluginConfig {
     /** 是否在加载剧本后自动播放第一个章节 */
     autoPlay?: boolean;
@@ -9,14 +8,6 @@ export interface DigitalPerformanceV2PluginConfig {
     debug?: boolean;
     /** 是否显示人物运动轨迹线（默认 false，不显示）。仅 debug / 特殊需求开启。 */
     showTrace?: boolean;
-    /**
-     * 是否内置展示模型头顶的 2D 气泡名牌（默认 true）。
-     * 插件会自动挂载到 five canvas 的父容器（与 canvas 同级），消费方只需声明是否展示；
-     * 设为 false 时不挂载任何名牌 DOM。
-     */
-    showNameplate?: boolean;
-    /** 内置名牌的自定义配置（class / 内联样式 / 文本 / 自定义渲染器等）。仅 showNameplate 为真时生效。 */
-    nameplateOptions?: DigitalPerformanceNameplateOptions;
 }
 /**
  * 关键帧到下一关键帧的过渡缓动

package/dist/FireScenePlugin/FireControl.d.ts

@@ -0,0 +1,153 @@
+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

@@ -0,0 +1,41 @@
+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

@@ -0,0 +1,28 @@
+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

@@ -0,0 +1,10 @@
+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

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

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

@@ -0,0 +1,76 @@
+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

@@ -0,0 +1,51 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,8 @@
+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

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

package/dist/FireScenePlugin/smoke/managers/NormalSmokeManager.d.ts

@@ -0,0 +1,49 @@
+import * as THREE from 'three';
+import type { SmokeConfig } from './SmokeManager';
+import type { ParticleTexture } from '../../utils/particleTexture';
+/**
+ * 普通烟雾管理器
+ * 管理传统的向上飘散烟雾效果
+ */
+export declare class NormalSmokeManager {
+    private scene;
+    private config;
+    private sources;
+    private particleTexture;
+    private unsubscribeTexture;
+    constructor(scene: THREE.Scene, config: SmokeConfig, particleTexture: ParticleTexture);
+    /**
+     * 添加烟雾源
+     */
+    addSource(id: string, position: THREE.Vector3, intensity: number, fadeInMs?: number): void;
+    /** 渐显：在 durationMs 内把浓度从 0 涨到目标值 */
+    private fadeInSource;
+    /**
+     * 平移某个烟雾源的粒子
+     */
+    moveSource(id: string, delta: THREE.Vector3): void;
+    /**
+     * 更新烟雾源强度
+     */
+    updateSourceIntensity(id: string, intensity: number): void;
+    /**
+     * 移除烟雾源
+     */
+    removeSource(id: string): void;
+    /**
+     * 创建普通烟雾粒子
+     */
+    private createNormalSmoke;
+    /**
+     * 更新普通烟雾参数
+     */
+    private updateNormalSmokeParams;
+    /**
+     * 清理所有烟雾
+     */
+    clearAll(): void;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}

package/dist/FireScenePlugin/smoke/managers/SmokeManager.d.ts

@@ -0,0 +1,89 @@
+import * as THREE from 'three';
+import type { FireSpreadBounds } from '../../typing';
+import type { ParticleTexture } from '../../utils/particleTexture';
+/**
+ * 烟雾配置接口
+ */
+export interface SmokeConfig {
+    /** 密度倍数 */
+    densityMultiplier: number;
+    /** 高度偏移 */
+    heightOffset: number;
+    /** 扩散倍数 */
+    spreadMultiplier: number;
+}
+/**
+ * 烟雾扩散参数
+ */
+export interface SmokeSpreadOptions {
+    /** 扩散边界（世界坐标）：`[minX, minY, minZ, maxX, maxY, maxZ]` */
+    bounds: FireSpreadBounds;
+    /** 扩散半径上限 */
+    spreadRange: number;
+    /** 每次步进的强度增长，决定半径推进的快慢 */
+    growthRate: number;
+    /** 步进间隔（毫秒） */
+    interval: number;
+    /** 扩散源数量上限（不含主源） */
+    maxAdditional: number;
+    /** 扩散源的浓度 */
+    intensity: number;
+    /** 扩散源的渐显时长（毫秒） */
+    fadeInMs?: number;
+    /** 网格边长（米），不传按 1 米 */
+    cell?: number;
+}
+/**
+ * 烟雾管理器
+ *
+ * 维护「有哪些烟源」的记录，具体粒子交给 {@link NormalSmokeManager}。
+ */
+export declare class SmokeManager {
+    private sources;
+    /** 正在扩散的烟雾源，key = 主源 id */
+    private spreads;
+    private normalSmoke;
+    constructor(scene: THREE.Scene, config: SmokeConfig, particleTexture: ParticleTexture);
+    /**
+     * 添加烟雾源
+     */
+    addSource(id: string, position: THREE.Vector3, intensity?: number, fadeInMs?: number): void;
+    /**
+     * 让某个烟雾源在给定区域内扩散。
+     */
+    spreadSmoke(id: string, options: SmokeSpreadOptions): void;
+    /** 停止扩散（已经生成的扩散源保留） */
+    stopSmokeSpread(id: string): void;
+    /** 扩散产生的烟雾源 id */
+    getSpreadSourceIds(id: string): string[];
+    /** 走一步扩散：在区域内新铺开若干个烟雾源 */
+    private stepSpread;
+    /**
+     * 平移某个烟雾源。
+     */
+    moveSource(id: string, position: THREE.Vector3): void;
+    /**
+     * 更新烟雾源强度
+     */
+    updateSourceIntensity(id: string, intensity: number): void;
+    /**
+     * 移除烟雾源
+     */
+    removeSource(id: string): void;
+    /**
+     * 清理所有烟雾
+     */
+    clearAll(): void;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+    /**
+     * 获取某个烟雾源的当前浓度
+     */
+    getSourceIntensity(id: string): number;
+    /**
+     * 获取烟雾源数量
+     */
+    getSourceCount(): number;
+}