@realsee/dnalogel 3.81.11-alpha.2 → 3.81.11-alpha.3

package/dist/index.js

@@ -43,7 +43,7 @@ import { LineGeometry as lA, LineMaterial as cA, THREE_Line2 as hA, Line as av }
 import { GLTFLoader as uA } from "@realsee/five/gltf-loader";
 function dA() {
   console.debug(
-    "%c %c@realsee/dnalogel %cv3.81.11-alpha.2",
+    "%c %c@realsee/dnalogel %cv3.81.11-alpha.3",
     [
       "background: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAkAAAAMCAMAAACHgmeRAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAABLFBMVEUAAAAapPoap/oaqvkbrfkbr/gZnfwZoPsaqfnD4v/E4/8Ylv0clPm93/+/4P/B4f8Yj/683/8Wif+33P8Uhv+x2f8ShP+s1v8Pgf+n0/8Nf/+h0f8Lff8Lff8Nf/9dl/+czv8KfP8KfP+Lxf+Uyv+Xy/+Hwv+Jw/+Mxf+Oxv+RyP8aovsapfoap/oZmfwZm/wZnvsYnPsYkf4YlP0NePsDYfgYcfi43f+63v8Xiv8Xjf4EWfwCV/sWZ/qz2v+02/8Vh/8WiP8EUf8CTf4WXv2u1/+v2P8Thf8Thv8ETf8CR/8VV/+o1f+q1f8Qgv8Rg/8DSv8BRf8UVP+j0v+k0v8OgP8Pgf8DR/8DQv9Nhf+dzv+fz/+Kv/+Vyv+Xy/+azf+Oxv+Qx/+SyP////8MUhLdAAAAK3RSTlMACEWQ2bd98uQECPXxqO7c+Pb49vj2+Pb49vj23Oul8fMHA+TwerXXjEIG2P+bHgAAAAFiS0dEY1y+LaoAAAB+SURBVAjXY2BgZGJmYWVgYGBgY9fW0eVg4ORi4NbTNzDk4eXjZxAwMjYxNTO3EGQQsrSytrG1sxdmEHFwdHJ2cXUTZRBz9/D08vbxFWeQ8PMPCAwKDpFkkAoNC4+IjIqWZpCRlZOPiY2LV2BQVGJQTkhMUlEFWaOmrqGpxQAAyg0S9Dq+VPYAAAAASUVORK5CYII=')",
       "background-repeat: no-repeat",
@@ -13589,7 +13589,7 @@ let Cs = class {
     /**
      * @realsee/dnalogel 版本号
      */
-    f(this, "VERSION", "3.81.11-alpha.2");
+    f(this, "VERSION", "3.81.11-alpha.3");
     f(this, "NAME");
     f(this, "five");
     f(this, "workUtil");
@@ -62302,24 +62302,33 @@ class zd {
     f(this, "bindings", /* @__PURE__ */ new Map());
     f(this, "nameOverrides", /* @__PURE__ */ new Map());
     f(this, "enabled", !0);
+    /** 是否由本层自动挂载到 five canvas 父容器（插件内置模式），无需调用方提供容器。 */
+    f(this, "autoMount", !1);
     f(this, "onResize", () => this.update());
     f(this, "anchor", new b.Vector3());
     f(this, "box", new b.Box3());
     f(this, "offset", new b.Vector3());
     f(this, "debugBoxes", /* @__PURE__ */ new Map());
     f(this, "debugBoxesVisible", !1);
-    this.five = t, this.options = _({}, e);
+    this.five = t, this.options = _({}, e), this.applyDebugBoundingBoxOption();
   }
   /** 将 overlay 挂到 Five canvas 的父级或业务提供的全屏相对定位容器。 */
   mount(t, e) {
     var i;
     if (e && (this.options = _(_({}, this.options), e)), this.parent === t && this.container) {
-      this.applyContainerStyle(), this.update();
+      this.applyContainerStyle(), this.applyDebugBoundingBoxOption(), this.update();
       return;
     }
-    this.unmount(), this.parent = t, this.container = document.createElement("div"), this.container.className = (i = this.options.containerClassName) != null ? i : jL, this.applyContainerStyle(), this.injectArrowStyle(), t.appendChild(this.container), typeof window != "undefined" && window.addEventListener("resize", this.onResize, !1), this.update();
+    this.unmount(), this.parent = t, this.container = document.createElement("div"), this.container.className = (i = this.options.containerClassName) != null ? i : jL, this.applyContainerStyle(), this.injectArrowStyle(), t.appendChild(this.container), typeof window != "undefined" && window.addEventListener("resize", this.onResize, !1), this.applyDebugBoundingBoxOption(), this.update();
   }
-  /** 移除 overlay，但保留 bindings，便于编辑端切换容器后重新 mount。 */
+  /**
+   * 内置自动挂载：把 overlay 挂到 five canvas 的父容器（与 canvas 同级），调用方无需提供容器。
+   * canvas 尚未进入 DOM 时不报错，会在后续 update() 中自动重试挂载。
+   */
+  enableAutoMount(t) {
+    t && (this.options = _(_({}, this.options), t)), this.autoMount = !0, this.applyDebugBoundingBoxOption(), this.tryAutoMount();
+  }
+  /** 移除 overlay，但保留 bindings；重新挂载（含换容器）时会复用 bindings。 */
   unmount() {
     var t;
     typeof window != "undefined" && window.removeEventListener("resize", this.onResize, !1), (t = this.container) == null || t.remove(), this.container = null, this.parent = null, this.bindings.forEach((e) => {
@@ -62353,12 +62362,17 @@ class zd {
   setBoundingBoxVisible(t) {
     this.debugBoxesVisible = t, t || this.clearDebugBoxes(), this.five.needsRender = !0, this.update();
   }
+  /** 应用 `options.debugBoundingBox`；未配置时保持现状（不覆盖运行时的 setBoundingBoxVisible）。 */
+  applyDebugBoundingBoxOption() {
+    const t = this.options.debugBoundingBox;
+    t !== void 0 && this.setBoundingBoxVisible(t);
+  }
   isEnabled() {
     return this.enabled;
   }
   /** 在数字人模型变换完成后调用，更新所有当前章节名牌的位置和可见性。 */
   update() {
-    this.container && (this.container.style.display = this.enabled ? "" : "none", this.enabled && this.bindings.forEach((t) => {
+    this.autoMount && this.tryAutoMount(), this.container && (this.container.style.display = this.enabled ? "" : "none", this.enabled && this.bindings.forEach((t) => {
       this.syncDebugBox(t);
       const e = this.getText(t.player, t.id), i = {
         id: t.id,
@@ -62379,7 +62393,15 @@ class zd {
     }));
   }
   dispose() {
-    this.unmount(), this.clearDebugBoxes(), this.bindings.clear(), this.nameOverrides.clear();
+    this.autoMount = !1, this.unmount(), this.clearDebugBoxes(), this.bindings.clear(), this.nameOverrides.clear();
+  }
+  /** 内置自动挂载的实际执行：解析 five canvas 的父容器并 mount；条件不满足时静默跳过。 */
+  tryAutoMount() {
+    var e, i, s;
+    if (!this.autoMount || this.container || typeof document == "undefined")
+      return;
+    const t = (s = (i = (e = this.five).getElement) == null ? void 0 : i.call(e)) == null ? void 0 : s.parentElement;
+    t && this.mount(t);
   }
   getMaxLength() {
     var t;
@@ -62515,7 +62537,7 @@ class FL {
       autoPlay: !1,
       loop: !1,
       debug: !1
-    }, e), this.playground = new wb(this.config.debug), this.nameplate = new zd(t), this.five.on("renderFrame", this.onNameplateRender), this.five.on("cameraUpdate", this.onNameplateRender), this.state = {
+    }, e), this.playground = new wb(this.config.debug), this.nameplate = new zd(t), this.five.on("renderFrame", this.onNameplateRender), this.five.on("cameraUpdate", this.onNameplateRender), this.config.showNameplate !== !1 && this.nameplate.enableAutoMount(this.config.nameplateOptions), this.state = {
       enabled: !0,
       playing: !1,
       currentChapter: null,
@@ -62869,23 +62891,6 @@ class FL {
   getDigitalHuman(t, e) {
     return this.playground.getDigitalHuman(t, e);
   }
-  /**
-   * 挂载模型头顶 2D 气泡名牌。编辑端和 C 端都可以传入自己的全屏 overlay 容器和 DOM 渲染逻辑。
-   * 名牌会按当前章节的 player.id 绑定到对应 DigitalHuman，不会因复用同一模型资源而串名。
-   */
-  mountNameplates(t, e) {
-    this.nameplate.mount(t, e), this.syncNameplates();
-  }
-  unmountNameplates() {
-    this.nameplate.unmount();
-  }
-  setNameplatesEnabled(t) {
-    this.nameplate.setEnabled(t);
-  }
-  /** 调试：显示/隐藏名牌绑定模型的世界包围盒（核对名牌锚点用）。 */
-  setNameplateBoundingBoxVisible(t) {
-    this.nameplate.setBoundingBoxVisible(t);
-  }
   /** 实时修改角色名牌；不重新加载模型和动画资源。 */
   updateModelName(t, e) {
     var s;
@@ -63953,7 +63958,7 @@ class Cb {
     f(this, "chapterFloorModel", null);
     /** five 'modeChange' 楼层重放监听的反订阅句柄（chapterFloorMap 启用时挂载，停用/reset/dispose 时清理） */
     f(this, "unsubFloorModeChange", null);
-    this.five = t, this.config = _({ autoPlay: !1, loop: !1, debug: !1, showTrace: !1 }, e), this.playground = new KL(t, this.config.debug), this.nameplate = new zd(t), this.unsubNameplateRender = this.playground.onRender(() => this.nameplate.update()), this.unsubNameplateCameraUpdate = this.five.on("cameraUpdate", () => this.nameplate.update()), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress());
+    this.five = t, this.config = _({ autoPlay: !1, loop: !1, debug: !1, showTrace: !1, showNameplate: !0 }, e), this.playground = new KL(t, this.config.debug), this.nameplate = new zd(t), this.unsubNameplateRender = this.playground.onRender(() => this.nameplate.update()), this.unsubNameplateCameraUpdate = this.five.on("cameraUpdate", () => this.nameplate.update()), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress()), this.config.showNameplate !== !1 && this.nameplate.enableAutoMount(this.config.nameplateOptions);
   }
   /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
   loadScript(t) {
@@ -64532,20 +64537,6 @@ class Cb {
   getState() {
     return { playing: this.state.playing, currentChapter: this.state.currentChapter };
   }
-  /** 挂载模型头顶 2D 气泡名牌；编辑端与 C 端可使用同一套 API 和自定义渲染器。 */
-  mountNameplates(t, e) {
-    this.nameplate.mount(t, e), this.syncNameplates();
-  }
-  unmountNameplates() {
-    this.nameplate.unmount();
-  }
-  setNameplatesEnabled(t) {
-    this.nameplate.setEnabled(t);
-  }
-  /** 调试：显示/隐藏名牌绑定模型的世界包围盒（核对名牌锚点用）。 */
-  setNameplateBoundingBoxVisible(t) {
-    this.nameplate.setBoundingBoxVisible(t);
-  }
   /** 实时修改角色名牌；只更新文本和当前剧本，不重新加载模型/动画。 */
   updateModelName(t, e) {
     var s;