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

package/libs/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/libs/FireScenePlugin/FireControl.js

@@ -0,0 +1,450 @@
+var F = Object.defineProperty, C = Object.defineProperties;
+var R = Object.getOwnPropertyDescriptors;
+var k = Object.getOwnPropertySymbols;
+var E = Object.prototype.hasOwnProperty, I = Object.prototype.propertyIsEnumerable;
+var d = (c, r, e) => r in c ? F(c, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : c[r] = e, w = (c, r) => {
+  for (var e in r || (r = {}))
+    E.call(r, e) && d(c, e, r[e]);
+  if (k)
+    for (var e of k(r))
+      I.call(r, e) && d(c, e, r[e]);
+  return c;
+}, x = (c, r) => C(c, R(r));
+var l = (c, r, e) => (d(c, typeof r != "symbol" ? r + "" : r, e), e);
+var M = (c, r, e) => new Promise((t, i) => {
+  var s = (a) => {
+    try {
+      n(e.next(a));
+    } catch (h) {
+      i(h);
+    }
+  }, o = (a) => {
+    try {
+      n(e.throw(a));
+    } catch (h) {
+      i(h);
+    }
+  }, n = (a) => a.done ? t(a.value) : Promise.resolve(a.value).then(s, o);
+  n((e = e.apply(c, r)).next());
+});
+import * as f from "three";
+import { FireManager as P } from "./fire/managers/FireManager.js";
+import { buildFireGrowthConfig as U } from "./fire/config.js";
+import { SmokeManager as B } from "./smoke/managers/SmokeManager.js";
+import { buildSmokeSpreadConfig as b } from "./smoke/config.js";
+import { FADE_STEP_MS as S, MODEL_SCALE_RANGE as y } from "./constants.js";
+import { Xe as V } from "../vendor/@realsee/five/vfx/index.js";
+import { disposeParticle as z } from "./utils/particle.js";
+import { ParticleTexture as G } from "./utils/particleTexture.js";
+import { loadGLTF as W } from "../shared-utils/three/GLTFLoader.js";
+import { transformPosition as A } from "../shared-utils/five/transformPosition.js";
+import { lookObject as T } from "../shared-utils/five/lookObject.js";
+import { WorkUtil as O } from "../shared-utils/Utils/WorkUtil.js";
+import "./utils/radialSpread.js";
+import "./utils/spread.js";
+import "./smoke/managers/NormalSmokeManager.js";
+import "../shared-utils/three/getTextureLoader.js";
+import "../shared-utils/three/loadTexture.js";
+import "@realsee/five";
+import "../vendor/hammerjs/hammer.js";
+import "../shared-utils/three/PointSelector/index.js";
+import "../shared-utils/three/PointSelector/utils/PointSelectorHelper.js";
+import "../shared-utils/three/Magnifier.js";
+import "../shared-utils/Subscribe.js";
+import "../shared-utils/three/PointSelector/utils/PointHelper.js";
+import "../shared-utils/three/Assets/index.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DObject.js";
+import "../shared-utils/even.js";
+import "../shared-utils/CSS3DRender/OpacityMesh.js";
+import "../shared-utils/three/centerPoint.js";
+import "../shared-utils/three/getObjectVisible.js";
+import "../shared-utils/tag.js";
+import "../shared-utils/positionToVector3.js";
+import "../shared-utils/five/vector3ToScreen.js";
+import "../shared-utils/five/getFiveModel.js";
+import "../shared-utils/Utils/FiveUtil.js";
+import "../shared-utils/Utils/BaseUtil.js";
+import "../shared-utils/three/temp.js";
+import "../shared-utils/three/core/Raycaster.js";
+import "../shared-utils/dom/resizeObserver.js";
+import "../shared-utils/five/fiveEveryReadyListener.js";
+import "../shared-utils/throttle.js";
+import "../shared-utils/three/CSS3DRenderer/index.js";
+import "../shared-utils/five/fiveModelLoad.js";
+import "../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
+import "@realsee/five/line";
+import "../shared-utils/three/core/Five_LineMaterial2.js";
+import "../shared-utils/three/core/Sphere.js";
+import "../shared-utils/three/blink.js";
+import "../vendor/animejs/lib/anime.es.js";
+import "../shared-utils/util.js";
+import "../vendor/@tweenjs/tween/dist/tween.esm.js.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
+import "../shared-utils/CSS3DRender/CSS3DRenderer.js";
+import "../shared-utils/createResizeObserver.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DScene.js";
+import "../CSS3DRenderPlugin/utils/getAllCSS3DObject.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DGroup.js";
+import "../shared-utils/three/PointSelector/utils/html.js";
+import "../shared-utils/CSS3DRender/index.js";
+import "../shared-utils/three/PointSelector/utils/PointHelper2.js";
+import "../Sculpt/Meshes/Line.js";
+import "../Sculpt/typings/style.js";
+import "../shared-utils/three/IObject3D.js";
+import "../Sculpt/utils/Meshes/getLengthHTML.js";
+import "../shared-utils/three/applyObjectMatrixWorld.js";
+import "../shared-utils/five/getFiveFromParentChain.js";
+import "../shared-utils/three/core/LineGeometry.js";
+import "../shared-utils/three/core/LineMaterial.js";
+import "../shared-utils/isNil.js";
+import "../shared-utils/three/core/Line2.js";
+import "../shared-utils/three/core/LineMaterial2.js";
+import "../Sculpt/utils/unit.js";
+import "../Sculpt/utils/renderDom.js";
+import "../vendor/earcut/src/earcut.js";
+import "../shared-utils/five/FivePuppet.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DSprite.js";
+import "../shared-utils/isTouchDevice.js";
+import "../shared-utils/five/getPosition.js";
+import "../shared-utils/five/getRaycasterByNdcPosition.js";
+import "../shared-utils/three/PointSelector/utils/contents.js";
+import "../Sculpt/utils/three/rayOnLine.js";
+import "../shared-utils/three/filterVisibleIntersections.js";
+import "../shared-utils/vectorToCoordinate.js";
+import "../shared-utils/formatRad.js";
+import "../shared-utils/three/boundingBox.js";
+const _ = {
+  densityMultiplier: 0.2,
+  heightOffset: 0.2,
+  spreadMultiplier: 4.5
+}, g = (c) => f.MathUtils.clamp(c, y.min, y.max);
+class kr {
+  constructor(r) {
+    l(this, "five");
+    l(this, "fireManager", null);
+    l(this, "smokeManager", null);
+    /** 已添加的起火点 */
+    l(this, "fires", /* @__PURE__ */ new Map());
+    /** 已添加的烟雾*/
+    l(this, "smokes", /* @__PURE__ */ new Map());
+    /** 已添加的消防员 */
+    l(this, "firefighters", /* @__PURE__ */ new Map());
+    /** 消防员加载代次，用于丢弃加载期间已经失效的结果 */
+    l(this, "firefighterTokens", /* @__PURE__ */ new Map());
+    /** 粒子贴图 */
+    l(this, "particleTexture", new G());
+    l(this, "unsubscribeTexture");
+    l(this, "resourceConfig", {
+      waterGunModelUrl: "",
+      /** 粒子贴图。火焰、烟雾、喷水三种粒子共用同一张 */
+      particleTextureUrl: ""
+    });
+    l(this, "resourceConfigResolvers", []);
+    l(this, "workUtil");
+    this.five = r, this.workUtil = new O(r), this.unsubscribeTexture = this.particleTexture.onChange((e) => {
+      this.firefighters.forEach((t) => {
+        t.particle && (t.particle.texture = e);
+      });
+    });
+  }
+  set workCode(r) {
+    this.workUtil.workCode = r;
+  }
+  get workCode() {
+    return this.workUtil.workCode;
+  }
+  /** 粒子贴图是否已配置 */
+  get hasParticleTexture() {
+    return !!this.resourceConfig.particleTextureUrl;
+  }
+  /** 消防员模型 URL 是否已配置 */
+  get hasWaterGunModel() {
+    return !!this.resourceConfig.waterGunModelUrl;
+  }
+  /** 更新资源配置 */
+  updateResourceConfig(r) {
+    var i, s;
+    const e = (i = r.waterGunObj) == null ? void 0 : i.trim(), t = (s = r.particleTexture) == null ? void 0 : s.trim();
+    e && (this.resourceConfig.waterGunModelUrl = e), t && t !== this.resourceConfig.particleTextureUrl && (this.resourceConfig.particleTextureUrl = t, this.particleTexture.setUrl(t)), this.resourceConfigResolvers = this.resourceConfigResolvers.filter((o) => o.check() ? (o.resolve(), !1) : !0);
+  }
+  /**
+   * 等待某项资源配置就位
+   */
+  waitForResourceConfig(r) {
+    const e = r === "particle" ? () => this.hasParticleTexture : () => this.hasWaterGunModel;
+    return e() ? Promise.resolve() : new Promise((t) => this.resourceConfigResolvers.push({ check: e, resolve: t }));
+  }
+  /**
+   * 添加一个起火点
+   */
+  addFire(r, e, t) {
+    var o, n;
+    const i = g((o = t == null ? void 0 : t.size) != null ? o : 1), s = this.toWorld(new f.Vector3(e[0], e[1], e[2]));
+    this.fires.has(r) && this.removeFire(r), this.ensureFireManager().addFire(r, [s], { fireSize: i }), t != null && t.fadeInMs && ((n = this.fireManager) == null || n.startFadeIn(r, t.fadeInMs)), this.fires.set(r, { position: s, size: i, floorIndex: t == null ? void 0 : t.floorIndex }), this.five.needsRender = !0;
+  }
+  /**
+   * 让指定起火点开始在给定区域内蔓延。
+   */
+  igniteFire(r, e, t) {
+    var n;
+    const i = this.fires.get(r);
+    if (!i || !this.fireManager)
+      return;
+    const s = (n = t == null ? void 0 : t.spreadSpeed) != null ? n : 1, o = this.toWorldBounds(e);
+    i.spreadBounds = e, i.spreadSpeed = s, this.fireManager.updateFireConfig(r, x(w({}, U(o, i.size, s)), {
+      fireSize: i.size
+    })), this.five.needsRender = !0;
+  }
+  /** 熄灭：渐进减少火点直到完全消失 */
+  extinguishFire(r, e) {
+    var t;
+    !this.fires.has(r) || !this.fireManager || this.fireManager.startExtinguish(r, e == null ? void 0 : e.onComplete, (t = e == null ? void 0 : e.duration) != null ? t : 5e3);
+  }
+  /** 停止熄灭过程 */
+  stopExtinguishFire(r) {
+    !this.fires.has(r) || !this.fireManager || this.fireManager.stopExtinguish(r);
+  }
+  /**
+   * 移动起火点
+   */
+  moveFire(r, e) {
+    const t = this.fires.get(r);
+    if (!t || !this.fireManager)
+      return;
+    const i = this.toWorld(new f.Vector3(e[0], e[1], e[2]));
+    t.position = i, this.fireManager.moveFire(r, i), this.five.needsRender = !0;
+  }
+  /**
+   * 缩放起火点
+   */
+  scaleFire(r, e) {
+    var h;
+    const t = this.fires.get(r);
+    if (!t)
+      return;
+    const { position: i, floorIndex: s, spreadBounds: o, spreadSpeed: n } = t, a = g(e);
+    (h = this.fireManager) == null || h.removeFire(r), this.ensureFireManager().addFire(r, [i], { fireSize: a }), this.fires.set(r, { position: i, size: a, floorIndex: s, spreadBounds: o, spreadSpeed: n }), o && this.igniteFire(r, o, { spreadSpeed: n }), this.five.needsRender = !0;
+  }
+  /** 移除起火点 */
+  removeFire(r) {
+    var e;
+    this.fires.has(r) && ((e = this.fireManager) == null || e.removeFire(r), this.fires.delete(r), this.five.needsRender = !0);
+  }
+  /**
+   * 按楼层控制起火点的可见性
+   */
+  changeFireVisibleByFloorIndex(r) {
+    this.fireManager && (this.fires.forEach((e, t) => {
+      const i = r === null || e.floorIndex === void 0 || e.floorIndex === r;
+      this.fireManager.setFireOpacity(t, i ? 1 : 0.1);
+    }), this.five.needsRender = !0);
+  }
+  /**
+   * 添加烟雾。
+   */
+  addSmoke(r, e, t) {
+    var n, a;
+    const i = this.ensureSmokeManager(), s = g((n = t == null ? void 0 : t.intensity) != null ? n : 1), o = this.toWorld(new f.Vector3(e[0], e[1], e[2]));
+    this.smokes.has(r) && this.removeSmoke(r), i.addSource(r, o, s, (a = t == null ? void 0 : t.fadeInMs) != null ? a : 0), this.smokes.set(r, { position: o }), this.five.needsRender = !0;
+  }
+  /**
+   * 让烟雾在所属区域内扩散
+   */
+  spreadSmoke(r, e, t) {
+    var a;
+    const i = this.smokes.get(r), s = this.smokeManager;
+    if (!i || !s)
+      return;
+    const o = this.toWorldBounds(e), n = s.getSourceIntensity(r);
+    s.spreadSmoke(r, b(o, n, (a = t == null ? void 0 : t.spreadSpeed) != null ? a : 1));
+  }
+  /**
+   * 移动烟雾。
+   */
+  moveSmoke(r, e) {
+    const t = this.smokes.get(r), i = this.smokeManager;
+    if (!t || !i)
+      return;
+    const s = this.toWorld(new f.Vector3(e[0], e[1], e[2]));
+    t.position = s, i.moveSource(r, s), this.five.needsRender = !0;
+  }
+  /**
+   * 缩放烟雾
+   */
+  scaleSmoke(r, e) {
+    const t = this.smokes.get(r), i = this.smokeManager;
+    !t || !i || (i.updateSourceIntensity(r, g(e)), this.five.needsRender = !0);
+  }
+  /**
+   * 烟雾渐隐并移除。
+   */
+  dissipateSmoke(r, e) {
+    var h;
+    const t = this.smokes.get(r), i = this.smokeManager;
+    if (!t || !i)
+      return;
+    t.dissipateTimer && clearInterval(t.dissipateTimer), i.stopSmokeSpread(r);
+    const s = [r, ...i.getSpreadSourceIds(r)], o = new Map(s.map((m) => [m, i.getSourceIntensity(m)])), n = Math.max(1, Math.round(((h = e == null ? void 0 : e.duration) != null ? h : 3e3) / S));
+    let a = 0;
+    t.dissipateTimer = setInterval(() => {
+      var m;
+      if (a += 1, a >= n) {
+        this.removeSmoke(r), (m = e == null ? void 0 : e.onComplete) == null || m.call(e);
+        return;
+      }
+      o.forEach((u, p) => {
+        i.updateSourceIntensity(p, u * (1 - a / n));
+      }), this.five.needsRender = !0;
+    }, S);
+  }
+  /**
+   * 停止消散
+   */
+  stopDissipateSmoke(r) {
+    const e = this.smokes.get(r);
+    e && e.dissipateTimer && (clearInterval(e.dissipateTimer), e.dissipateTimer = void 0, this.five.needsRender = !0);
+  }
+  /** 移除烟雾 */
+  removeSmoke(r) {
+    var t;
+    const e = this.smokes.get(r);
+    e && (e.dissipateTimer && clearInterval(e.dissipateTimer), (t = this.smokeManager) == null || t.removeSource(r), this.smokes.delete(r), this.five.needsRender = !0);
+  }
+  /**
+   * 添加消防员。
+   */
+  addFirefighter(r) {
+    return M(this, null, function* () {
+      const { id: e, position: t, rotation: i, spray: s = !1, scale: o = 1 } = r;
+      if (!this.resourceConfig.waterGunModelUrl)
+        throw new Error("消防员模型未配置，请先调用 updateResourceConfig 设置 waterGunObj");
+      this.firefighters.has(e) && this.removeFirefighter(e), this.invalidateFirefighter(e);
+      const n = this.firefighterTokens.get(e), a = this.toWorld(new f.Vector3(t[0], t[1], t[2])), h = yield W(this.resourceConfig.waterGunModelUrl);
+      if (this.firefighterTokens.get(e) !== n) {
+        h.dispose();
+        return;
+      }
+      const m = h.scene;
+      m.scale.setScalar(g(o)), m.rotation.copy(i), m.position.copy(a), m.name = e, this.five.scene.add(m);
+      let u = null;
+      s && (u = this.createSprayParticle(e), m.add(u)), this.firefighters.set(e, { scene: m, particle: u, dispose: h.dispose }), this.five.needsRender = !0;
+    });
+  }
+  invalidateFirefighter(r) {
+    var e;
+    this.firefighterTokens.set(r, ((e = this.firefighterTokens.get(r)) != null ? e : 0) + 1);
+  }
+  /**
+   * 把相机移到某个实体上（以最佳视角观察它）。
+   */
+  focusEntity(r, e) {
+    return M(this, null, function* () {
+      var m, u, p, v;
+      const t = this.firefighters.get(r);
+      if (t) {
+        yield T(this.five, t.scene, e);
+        return;
+      }
+      const i = this.fires.get(r), s = this.smokes.get(r), o = (m = i == null ? void 0 : i.position) != null ? m : s == null ? void 0 : s.position;
+      if (!o)
+        return;
+      const n = (v = i == null ? void 0 : i.size) != null ? v : s && (p = (u = this.smokeManager) == null ? void 0 : u.getSourceIntensity(r)) != null ? p : 1, a = Math.max(n, 3), h = new f.Mesh(new f.BoxGeometry(a, a, a));
+      h.visible = !1, h.position.copy(o), this.five.scene.add(h);
+      try {
+        yield T(this.five, h, e);
+      } finally {
+        this.five.scene.remove(h), h.geometry.dispose();
+      }
+    });
+  }
+  /** 移除消防员 */
+  removeFirefighter(r) {
+    if (r === void 0) {
+      Array.from(this.firefighterTokens.keys()).forEach((t) => this.invalidateFirefighter(t)), Array.from(this.firefighters.keys()).forEach((t) => this.removeFirefighter(t));
+      return;
+    }
+    this.invalidateFirefighter(r);
+    const e = this.firefighters.get(r);
+    e && (e.particle && z(e.particle), this.five.scene.remove(e.scene), e.dispose(), this.firefighters.delete(r), this.five.needsRender = !0);
+  }
+  /** 清空所有实体，保留管理器与资源配置 */
+  clearAll() {
+    var r;
+    this.fires.forEach((e, t) => {
+      var i;
+      return (i = this.fireManager) == null ? void 0 : i.removeFire(t);
+    }), this.fires.clear(), this.smokes.forEach((e) => e.dissipateTimer && clearInterval(e.dissipateTimer)), this.smokes.clear(), (r = this.smokeManager) == null || r.clearAll(), this.removeFirefighter(), this.five.needsRender = !0;
+  }
+  /** 销毁控制器 */
+  destroy() {
+    var e, t;
+    this.clearAll(), (e = this.fireManager) == null || e.destroy(), this.fireManager = null, (t = this.smokeManager) == null || t.destroy(), this.smokeManager = null, this.unsubscribeTexture(), this.particleTexture.dispose(), this.firefighterTokens.clear();
+    const r = this.resourceConfigResolvers;
+    this.resourceConfigResolvers = [], r.forEach((i) => i.resolve());
+  }
+  /**
+   * 创建火焰管理器。
+   */
+  ensureFireManager() {
+    return this.fireManager ? this.fireManager : (this.ensureParticleTexture(), this.fireManager = new P(this.five.scene, this.particleTexture), this.fireManager);
+  }
+  /**
+   * 创建烟雾管理器。
+   */
+  ensureSmokeManager() {
+    return this.smokeManager ? this.smokeManager : (this.ensureParticleTexture(), this.smokeManager = new B(this.five.scene, _, this.particleTexture), this.smokeManager);
+  }
+  ensureParticleTexture() {
+    if (!this.resourceConfig.particleTextureUrl)
+      throw new Error("粒子贴图未配置，请先调用 updateResourceConfig 设置 particleTexture");
+  }
+  /** 把数据里的 work 局部坐标变换为场景世界坐标 */
+  toWorld(r) {
+    return A(r, this.workUtil.transform);
+  }
+  /**
+   * 把局部坐标的包围盒变换为世界坐标包围盒。
+   */
+  toWorldBounds(r) {
+    const [e, t, i, s, o, n] = r, a = [
+      [e, t, i],
+      [s, t, i],
+      [e, o, i],
+      [s, o, i],
+      [e, t, n],
+      [s, t, n],
+      [e, o, n],
+      [s, o, n]
+    ].map(([m, u, p]) => this.toWorld(new f.Vector3(m, u, p))), h = new f.Box3().setFromPoints(a);
+    return [h.min.x, h.min.y, h.min.z, h.max.x, h.max.y, h.max.z];
+  }
+  /** 创建消防员的喷水粒子 */
+  createSprayParticle(r) {
+    const e = new V({
+      positionStyle: "CUBE",
+      positionBase: new f.Vector3(0, 0, 0),
+      positionCubeSpread: new f.Vector3(0.05, 0, 0.05),
+      velocityStyle: "CUBE",
+      velocityCubeBase: new f.Vector3(0, 1, -1.5),
+      velocityCubeSpread: new f.Vector3(0.5, 0.5, 0.5),
+      accelerationBase: new f.Vector3(0.3, -1.5, -2.5),
+      texture: this.particleTexture.current,
+      angleBase: 0,
+      angleSpread: 0.5 * Math.PI,
+      angleVelocityBase: 0,
+      angleVelocitySpread: 2 * Math.PI,
+      sizeTween: { times: [0, 1], values: [5e-3, 0.01] },
+      opacityTween: { times: [1, 2], values: [1, 0] },
+      colorTween: {
+        times: [0.5, 2],
+        values: [new f.Vector3(0, 0, 0.9), new f.Vector3(0, 0, 0.95)]
+      },
+      particlesPerSecond: 1e3,
+      particleDeathAge: 2
+    });
+    return e.name = `${r}_water`, e.rotation.set(0, Math.PI * 1.05, 0), e.position.set(0.05, 1.25, 1.5), e;
+  }
+}
+export {
+  kr as FireControl
+};

package/libs/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;
+}