@realsee/dnalogel 3.81.12-alpha.1 → 3.81.12

package/libs/DigitalPerformancePlugin/movement-track-classifier.js

@@ -0,0 +1,227 @@
+var b = Object.defineProperty, R = Object.defineProperties;
+var y = Object.getOwnPropertyDescriptors;
+var P = Object.getOwnPropertySymbols;
+var p = Object.prototype.hasOwnProperty, x = Object.prototype.propertyIsEnumerable;
+var g = (n, t, i) => t in n ? b(n, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : n[t] = i, M = (n, t) => {
+  for (var i in t || (t = {}))
+    p.call(t, i) && g(n, i, t[i]);
+  if (P)
+    for (var i of P(t))
+      x.call(t, i) && g(n, i, t[i]);
+  return n;
+}, v = (n, t) => R(n, y(t));
+const H = 2, Q = 1e-3, Y = 1e-9;
+function L(n) {
+  return JSON.parse(JSON.stringify(n));
+}
+function T(n) {
+  if (!n || typeof n != "object")
+    return !1;
+  const t = n;
+  return Number.isFinite(t.x) && Number.isFinite(t.y) && Number.isFinite(t.z);
+}
+function k(n) {
+  if (!n || typeof n != "object")
+    return !1;
+  const t = n;
+  return typeof t.duration == "number" && Number.isFinite(t.duration) && t.duration > 0 && typeof t.animationUrl == "string" && t.animationUrl.trim().length > 0 && (t.repeat === "loop" || t.repeat === "once") && (t.restartOnEnter === void 0 || typeof t.restartOnEnter == "boolean");
+}
+function C(n) {
+  if (n === void 0)
+    return [];
+  if (!Array.isArray(n))
+    return;
+  const t = [];
+  for (const i of n) {
+    if (!i || typeof i != "object")
+      return;
+    const e = L(i);
+    if (typeof e.animationUrl != "string" || e.animationUrl.trim().length === 0 || e.duration !== void 0 && (typeof e.duration != "number" || !Number.isFinite(e.duration) || e.duration < 0) || e.repeat !== void 0 && typeof e.repeat != "boolean")
+      return;
+    t.push(e);
+  }
+  return t;
+}
+function F(n) {
+  return n.animationUrl === "x_turn" ? 1 : typeof n.duration == "number" && Number.isFinite(n.duration) ? n.duration : 0;
+}
+function B(n) {
+  return n.reduce((t, i) => t + F(i), 0);
+}
+function A(n, t) {
+  const i = t.x - n.x, e = t.y - n.y, r = t.z - n.z;
+  return Math.sqrt(i * i + e * e + r * r);
+}
+function V(n, t, i) {
+  const e = i.x - t.x, r = i.y - t.y, o = i.z - t.z, a = e * e + r * r + o * o;
+  if (!Number.isFinite(a))
+    return;
+  const c = n.x - t.x, s = n.y - t.y, d = n.z - t.z, E = a === 0 ? 0 : Math.max(0, Math.min(1, (c * e + s * r + d * o) / a)), m = t.x + E * e, _ = t.y + E * r, u = t.z + E * o, f = n.x - m, N = n.y - _, I = n.z - u, l = f * f + N * N + I * I;
+  if (!(!Number.isFinite(E) || !Number.isFinite(l)))
+    return { t: E, distanceSquared: l };
+}
+function j(n) {
+  const t = [...n].sort((o, a) => o.distance - a.distance || o.segmentIndex - a.segmentIndex), i = [];
+  let e = [];
+  const r = () => {
+    if (e.length === 0)
+      return;
+    const o = e.map(({ segmentIndex: c }) => c).sort((c, s) => c - s);
+    o.every(
+      (c, s) => s === 0 || c === o[s - 1] + 1
+    ) ? i.push(e[0]) : i.push(...e), e = [];
+  };
+  for (const o of t)
+    e.length > 0 && Math.abs(o.distance - e[0].distance) > 1e-9 && r(), e.push(o);
+  return r(), i;
+}
+function D(n, t) {
+  if (n.length < 2 || t.length < 2 || !n.every(T) || !t.every(T))
+    return { kind: "invalid" };
+  const i = [], e = [];
+  let r = 0;
+  for (let u = 0; u < n.length - 1; u++) {
+    const f = A(n[u], n[u + 1]);
+    if (!Number.isFinite(f))
+      return { kind: "invalid" };
+    e.push(r), i.push(f), r += f;
+  }
+  if (!Number.isFinite(r) || r <= 1e-3)
+    return { kind: "invalid" };
+  const o = [];
+  for (const u of t) {
+    const f = [];
+    let N = 1 / 0;
+    for (let O = 0; O < n.length - 1; O++) {
+      const S = V(u, n[O], n[O + 1]);
+      if (!S)
+        return { kind: "invalid" };
+      N = Math.min(N, S.distanceSquared), f.push({
+        segmentIndex: O,
+        distance: e[O] + i[O] * S.t,
+        distanceSquared: S.distanceSquared
+      });
+    }
+    if (!Number.isFinite(N) || N > 1e-6)
+      return { kind: "invalid" };
+    const I = Math.max(1e-6, Math.abs(N) * 1e-9), l = j(
+      f.filter(
+        (O) => O.distanceSquared <= 1e-6 && O.distanceSquared - N <= I
+      )
+    );
+    if (l.length === 0)
+      return { kind: "invalid" };
+    o.push(l);
+  }
+  const a = t.length - 1, c = n.length - 1;
+  if (A(t[0], n[0]) > 1e-3 || A(t[a], n[c]) > 1e-3)
+    return { kind: "invalid" };
+  o[0] = o[0].filter((u) => u.distance <= 1e-3);
+  const s = o.length - 1;
+  if (o[s] = o[s].filter(
+    (u) => Math.abs(u.distance - r) <= 1e-3
+  ), o[0].length === 0 || o[s].length === 0)
+    return { kind: "invalid" };
+  let d = 0, E;
+  const m = [], _ = (u, f) => {
+    if (!(d > 1)) {
+      for (const N of o[u])
+        if (!(u > 0 && N.distance <= f) && (m.push(N), u === o.length - 1 ? (d += 1, d === 1 && (E = m.map((I) => M({}, I)))) : _(u + 1, N.distance), m.pop(), d > 1))
+          return;
+    }
+  };
+  return _(0, Number.NEGATIVE_INFINITY), d === 0 || !E ? { kind: "invalid" } : d > 1 ? { kind: "ambiguous" } : { kind: "resolved", projections: E.map(({ segmentIndex: u, distance: f }) => ({ segmentIndex: u, distance: f })) };
+}
+function U(n) {
+  return n[0] * n[0] + n[1] * n[1] + n[2] * n[2];
+}
+function h(n, t) {
+  return n[0] * t[0] + n[1] * t[1] + n[2] * t[2];
+}
+function X(n) {
+  if (!Array.isArray(n) || n.length !== 16 || !n.every((c) => typeof c == "number" && Number.isFinite(c)) || Math.abs(n[3]) > 1e-6 || Math.abs(n[7]) > 1e-6 || Math.abs(n[11]) > 1e-6 || Math.abs(n[15] - 1) > 1e-6)
+    return !1;
+  const t = [
+    [n[0], n[1], n[2]],
+    [n[4], n[5], n[6]],
+    [n[8], n[9], n[10]]
+  ], i = [];
+  for (const c of t) {
+    const s = U(c);
+    if (!Number.isFinite(s) || s <= 1e-6 * 1e-6)
+      return !1;
+    const d = Math.sqrt(s);
+    if (!Number.isFinite(d))
+      return !1;
+    i.push([c[0] / d, c[1] / d, c[2] / d]);
+  }
+  if (Math.abs(h(i[0], i[1])) > 1e-5 || Math.abs(h(i[0], i[2])) > 1e-5 || Math.abs(h(i[1], i[2])) > 1e-5)
+    return !1;
+  const [e, r, o] = i, a = e[0] * (r[1] * o[2] - r[2] * o[1]) - r[0] * (e[1] * o[2] - e[2] * o[1]) + o[0] * (e[1] * r[2] - e[2] * r[1]);
+  return Number.isFinite(a) && a > 0 && Math.abs(a - 1) <= 1e-5;
+}
+function q(n, t) {
+  const i = Math.max(1e-6, 1e-9 * Math.max(Math.abs(n), Math.abs(t)));
+  return Math.abs(n - t) <= i;
+}
+function z(n, t) {
+  var o;
+  const i = t.slice(0, -1).map((a) => a.outgoingMovement), e = i.reduce((a, c) => a + c.duration, 0), r = i[0];
+  return typeof ((o = n.track) == null ? void 0 : o.duration) == "number" && Number.isFinite(n.track.duration) && n.track.duration > 0 && q(n.track.duration, e) && n.animationUrl === r.animationUrl.trim() && n.repeat === r.repeat;
+}
+function J(n) {
+  const t = n.track, i = t == null ? void 0 : t.path, e = t == null ? void 0 : t.points;
+  if (!Array.isArray(i) || i.length < 2 || !i.every(T))
+    return { kind: "conflict-invalid", reason: "invalid-path" };
+  if (!Array.isArray(e) || e.length < 2 || !e.every((s) => s && typeof s == "object" && T(s.point)))
+    return { kind: "conflict-invalid", reason: "invalid-points" };
+  if (!X(n.matrix))
+    return { kind: "conflict-invalid", reason: "invalid-matrix" };
+  const r = [];
+  for (let s = 0; s < e.length; s++) {
+    const d = e[s], E = C(d.actions);
+    if (!E)
+      return { kind: "conflict-invalid", reason: "invalid-actions" };
+    if (s < e.length - 1) {
+      if (!k(d.outgoingMovement))
+        return { kind: "conflict-invalid", reason: "invalid-movement" };
+    } else if (d.outgoingMovement !== void 0)
+      return { kind: "conflict-invalid", reason: "terminal-movement" };
+    r.push(v(M({}, L(d)), { actions: E }));
+  }
+  if (!z(n, r))
+    return { kind: "conflict-invalid", reason: "legacy-summary-mismatch" };
+  const o = i.map((s) => M({}, s)), a = D(
+    o,
+    r.map((s) => s.point)
+  );
+  if (a.kind !== "resolved")
+    return { kind: "conflict-invalid", reason: "invalid-projection" };
+  const c = { x: n.matrix[12], y: n.matrix[13], z: n.matrix[14] };
+  return A(c, r[0].point) > 1e-3 ? { kind: "conflict-invalid", reason: "matrix-origin-mismatch" } : {
+    kind: "canonical-v2",
+    plan: { path: o, points: r, projections: a.projections }
+  };
+}
+function w(n) {
+  var r, o;
+  const t = n && typeof n == "object" ? n : {}, i = (r = t.track) == null ? void 0 : r.points, e = Array.isArray(i) ? i : [];
+  return ((o = t.track) == null ? void 0 : o.schemaVersion) !== void 0 || e.some(
+    (a) => a && typeof a == "object" && a.outgoingMovement !== void 0
+  );
+}
+function Z(n) {
+  var i;
+  const t = n && typeof n == "object" ? n : {};
+  return w(t) ? ((i = t.track) == null ? void 0 : i.schemaVersion) !== 2 ? { kind: "conflict-invalid", reason: "unsupported-schema" } : J(t) : { kind: "pure-legacy" };
+}
+export {
+  Y as MOVEMENT_OCCURRENCE_EPSILON,
+  Q as MOVEMENT_POSITION_EPSILON,
+  H as MOVEMENT_SCHEMA_VERSION,
+  Z as classifyMovementTrack,
+  F as getEffectivePointActionDuration,
+  B as getMovementActionDuration,
+  w as hasMovementV2Signal,
+  X as isConverterSafeMovementMatrix
+};

package/libs/DigitalPerformancePlugin/transform-script-data.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 将 animation detail 转换为 dnalogel Legacy/V2 共用的 canonical script。
+ *
+ * 这是纯数据转换，不依赖 Five 实例，也不会修改调用方传入的 detail。
+ * outgoingMovement 的分段协议由上层 adapter 通过临时 Legacy detail 复用本函数。
+ */
+export declare function transformScriptData(res: any, work?: any, totalDelay?: number): any;

package/libs/DigitalPerformancePlugin/transform-script-data.js

@@ -0,0 +1,72 @@
+var N = Object.defineProperty, O = Object.defineProperties;
+var C = Object.getOwnPropertyDescriptors;
+var P = Object.getOwnPropertySymbols;
+var J = Object.prototype.hasOwnProperty, V = Object.prototype.propertyIsEnumerable;
+var S = (r, t, n) => t in r ? N(r, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : r[t] = n, m = (r, t) => {
+  for (var n in t || (t = {}))
+    J.call(t, n) && S(r, n, t[n]);
+  if (P)
+    for (var n of P(t))
+      V.call(t, n) && S(r, n, t[n]);
+  return r;
+}, v = (r, t) => O(r, C(t));
+import { Vector3 as x } from "three";
+import { convertMockToPlayer as b } from "./mock.js";
+import { transformPosition as l } from "../shared-utils/five/transformPosition.js";
+function j(r) {
+  return JSON.parse(JSON.stringify(r));
+}
+function $(r, t, n = 0) {
+  var h, u;
+  if (!r || !r.players || !Array.isArray(r.players))
+    return r;
+  const f = j(r), i = (h = f.players[0]) != null && h.fiveState ? m({}, f.players[0].fiveState) : void 0;
+  if (i && i.offset && t) {
+    const c = new x(i.offset.x, i.offset.y, i.offset.z), p = l(c, t == null ? void 0 : t.transform);
+    i.offset = { x: p.x, y: p.y, z: p.z };
+  }
+  const y = [
+    {
+      id: 0,
+      name: ((u = f.players[0]) == null ? void 0 : u.chapterName) || "Chapter 1",
+      players: []
+    }
+  ];
+  let o = 0;
+  return f.players.forEach((c, p) => {
+    var d, z, A;
+    const a = m({}, c);
+    if (t && ((d = a.track) != null && d.path && Array.isArray(a.track.path) && (a.track.path = a.track.path.map((e) => {
+      const s = l(new x(e.x, e.y, e.z), t == null ? void 0 : t.transform);
+      return { x: s.x, y: s.y, z: s.z };
+    })), (z = a.track) != null && z.points && Array.isArray(a.track.points) && (a.track.points = a.track.points.map((e) => {
+      if (!e.point)
+        return e;
+      const s = l(new x(e.point.x, e.point.y, e.point.z), t == null ? void 0 : t.transform);
+      return v(m({}, e), {
+        point: {
+          x: s.x,
+          y: s.y,
+          z: s.z
+        }
+      });
+    })), Array.isArray(a.matrix) && a.matrix.length >= 16)) {
+      const e = new x(a.matrix[12], a.matrix[13], a.matrix[14]), s = l(e, t == null ? void 0 : t.transform);
+      a.matrix[12] = s.x, a.matrix[13] = s.y, a.matrix[14] = s.z;
+    }
+    const g = b(a, n);
+    ((A = c.config) == null ? void 0 : A.type) === "simultaneous" || p > 0 && o++, y[o] || y.push({
+      id: o,
+      name: c.chapterName || `Chapter ${o + 1}`,
+      players: []
+    }), y[o].players.push(g);
+  }), {
+    id: f.id,
+    name: f.name,
+    fiveState: i,
+    chapters: y
+  };
+}
+export {
+  $ as transformScriptData
+};

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

@@ -1,10 +1,18 @@
 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/libs/DigitalPerformanceV2Plugin/controller/index.d.ts

@@ -1,6 +1,7 @@
 import type { Five } from '@realsee/five';
 import type { DigitalPerformanceV2PluginConfig, DigitalCameraKeyframe, DigitalCameraPlayer, CameraTransition, CameraCoordinateSpace, CameraState, GroupChapterTimeInfo, GroupProgress } from '../typings';
 import { PerformancePlayground } from '../core/Playground';
+import { type AnimationScriptAdapterOptions } from '../../DigitalPerformancePlugin/animation-script-adapter';
 import type { DigitalScript, DigitalChapter } from '../core/shared';
 /** 播放进度（当前章节内） */
 export interface V2Progress {
@@ -80,6 +81,9 @@ export default class DigitalPerformanceV2PluginController {
     private groupProgressListeners;
     private keyframesChangedListeners;
     private currentChapterChangedListeners;
+    private nameplate;
+    private unsubNameplateRender;
+    private unsubNameplateCameraUpdate;
     private unsubClockTick;
     /**
      * 进入编辑时的运镜内存态快照：以章节对象为 key，值为该章节相机关键帧的深拷贝；
@@ -119,6 +123,10 @@ export default class DigitalPerformanceV2PluginController {
     constructor(five: Five, config?: DigitalPerformanceV2PluginConfig);
     /** 加载剧本：预加载资源 + 将模型加入 five 场景；autoPlay 时自动播放首章 */
     loadScript(script: DigitalScript): Promise<void>;
+    /**
+     * 加载 raw animation detail。转换逻辑由 dnalogel 与 Legacy 插件共用，随后复用 canonical loadScript。
+     */
+    loadAnimationDetail(detail: unknown, options?: AnimationScriptAdapterOptions): Promise<any>;
     /** 播放指定章节 */
     playChapter(chapter: DigitalChapter): Promise<void>;
     /** 通过索引播放章节 */
@@ -352,6 +360,9 @@ export default class DigitalPerformanceV2PluginController {
         playing: boolean;
         currentChapter: DigitalChapter | null;
     };
+    /** 实时修改角色名牌；只更新文本和当前剧本，不重新加载模型/动画。 */
+    updateModelName(id: string, value: string): void;
+    private syncNameplates;
     /** 重置播放（保留已加载资源） */
     reset(): void;
     /** 销毁插件、释放资源 */

package/libs/DigitalPerformanceV2Plugin/controller/index.js

@@ -1,15 +1,15 @@
-var R = Object.defineProperty;
-var x = Object.getOwnPropertySymbols;
-var D = Object.prototype.hasOwnProperty, G = Object.prototype.propertyIsEnumerable;
-var k = (p, e, t) => e in p ? R(p, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : p[e] = t, g = (p, e) => {
+var L = Object.defineProperty;
+var K = Object.getOwnPropertySymbols;
+var R = Object.prototype.hasOwnProperty, D = Object.prototype.propertyIsEnumerable;
+var b = (p, e, t) => e in p ? L(p, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : p[e] = t, g = (p, e) => {
   for (var t in e || (e = {}))
-    D.call(e, t) && k(p, t, e[t]);
-  if (x)
-    for (var t of x(e))
-      G.call(e, t) && k(p, t, e[t]);
+    R.call(e, t) && b(p, t, e[t]);
+  if (K)
+    for (var t of K(e))
+      D.call(e, t) && b(p, t, e[t]);
   return p;
 };
-var h = (p, e, t) => (k(p, typeof e != "symbol" ? e + "" : e, t), t);
+var h = (p, e, t) => (b(p, typeof e != "symbol" ? e + "" : e, t), t);
 var m = (p, e, t) => new Promise((r, a) => {
   var s = (n) => {
     try {
@@ -27,8 +27,10 @@ var m = (p, e, t) => new Promise((r, a) => {
   o((t = t.apply(p, e)).next());
 });
 import * as T from "three";
-import { PerformancePlayground as A, getChapterModelDuration as I, getChapterDuration as N } from "../core/Playground.js";
-import { CameraTrack as V } from "../core/CameraTrack.js";
+import { PerformancePlayground as A, getChapterModelDuration as x, getChapterDuration as G } from "../core/Playground.js";
+import { CameraTrack as O } from "../core/CameraTrack.js";
+import { DigitalPerformanceNameplate as V, normalizeDigitalPerformanceName as z } from "../../DigitalPerformancePlugin/core/DigitalPerformanceNameplate.js";
+import { transformAnimationDetailToDigitalScript as B } from "../../DigitalPerformancePlugin/animation-script-adapter.js";
 import "../../DigitalPerformancePlugin/core/DigitalPlayground.js";
 import "@realsee/five/gltf-loader";
 import "../../DigitalPerformancePlugin/core/DigitalHuman.js";
@@ -39,12 +41,16 @@ import "../core/PerformanceClock.js";
 import "../core/CameraDirector.js";
 import "../core/FiveModelCameraBridge.js";
 import "../core/CameraSampler.js";
-const O = "Dnalogel-DigitalPerformanceV2Plugin", L = "five-world";
-class $ {
+import "../../DigitalPerformancePlugin/movement-track-classifier.js";
+import "../../DigitalPerformancePlugin/transform-script-data.js";
+import "../../DigitalPerformancePlugin/mock.js";
+import "../../shared-utils/five/transformPosition.js";
+const U = "Dnalogel-DigitalPerformanceV2Plugin", I = "five-world";
+class he {
   constructor(e, t = {}) {
     h(this, "five");
     h(this, "config");
-    h(this, "NAME", O);
+    h(this, "NAME", U);
     h(this, "playground");
     h(this, "state", {
       enabled: !0,
@@ -58,6 +64,9 @@ class $ {
     h(this, "groupProgressListeners", /* @__PURE__ */ new Set());
     h(this, "keyframesChangedListeners", /* @__PURE__ */ new Set());
     h(this, "currentChapterChangedListeners", /* @__PURE__ */ new Set());
+    h(this, "nameplate");
+    h(this, "unsubNameplateRender", null);
+    h(this, "unsubNameplateCameraUpdate", null);
     h(this, "unsubClockTick", null);
     /**
      * 进入编辑时的运镜内存态快照：以章节对象为 key，值为该章节相机关键帧的深拷贝；
@@ -94,13 +103,13 @@ class $ {
     h(this, "chapterFloorModel", null);
     /** five 'modeChange' 楼层重放监听的反订阅句柄（chapterFloorMap 启用时挂载，停用/reset/dispose 时清理） */
     h(this, "unsubFloorModeChange", null);
-    this.five = e, this.config = g({ autoPlay: !1, loop: !1, debug: !1, showTrace: !1 }, t), this.playground = new A(e, this.config.debug), this.unsubClockTick = this.playground.getClock().onTick(() => this.emitProgress());
+    this.five = e, this.config = g({ autoPlay: !1, loop: !1, debug: !1, showTrace: !1, showNameplate: !0 }, t), this.playground = new A(e, this.config.debug), this.nameplate = new V(e), 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(e) {
     return m(this, null, function* () {
       var t;
-      if (this.state.currentScript = e, this.playground.setScript(e), this.groupChapterTimeMapCache = null, this.groupChapterTimeMapCacheScript = null, this.chapterFloorMap = null, yield this.preloadResources(e), this.five && this.five.scene) {
+      if (this.state.currentScript = e, this.nameplate.setBindings([]), this.playground.setScript(e), this.groupChapterTimeMapCache = null, this.groupChapterTimeMapCacheScript = null, this.chapterFloorMap = null, yield this.preloadResources(e), this.five && this.five.scene) {
         yield new Promise((a) => requestAnimationFrame(() => a()));
         let r = 0;
         if (e.chapters.forEach((a) => {
@@ -116,10 +125,19 @@ class $ {
       this.playground.setTraceVisible((t = this.config.showTrace) != null ? t : !1), this.config.autoPlay && e.chapters.length > 0 && (yield this.playChapter(e.chapters[0]));
     });
   }
+  /**
+   * 加载 raw animation detail。转换逻辑由 dnalogel 与 Legacy 插件共用，随后复用 canonical loadScript。
+   */
+  loadAnimationDetail(r) {
+    return m(this, arguments, function* (e, t = {}) {
+      const a = B(e, t);
+      return yield this.loadScript(a), a;
+    });
+  }
   /** 播放指定章节 */
   playChapter(e) {
     return m(this, null, function* () {
-      this.state.currentChapter = e, this.applyChapterFloor(this.getCurrentChapterIndex()), this.state.continuousPlaying = !1, this.state.playing = !0;
+      this.state.currentChapter = e, this.syncNameplates(e), this.applyChapterFloor(this.getCurrentChapterIndex()), this.state.continuousPlaying = !1, this.state.playing = !0;
       try {
         yield this.playground.playByChapter(e);
       } finally {
@@ -151,7 +169,7 @@ class $ {
       try {
         for (; t >= 0 && t < e.length && this.state.continuousPlaying; ) {
           let r = 0;
-          if (this.seekRedirect && this.seekRedirect.index === t && (r = this.seekRedirect.fromTime), this.seekRedirect = null, this.state.currentChapter = e[t], this.applyChapterFloor(t), this.emitProgress(), yield this.playground.playByChapter(e[t], r), this.seekRedirect) {
+          if (this.seekRedirect && this.seekRedirect.index === t && (r = this.seekRedirect.fromTime), this.seekRedirect = null, this.state.currentChapter = e[t], this.syncNameplates(e[t]), this.applyChapterFloor(t), this.emitProgress(), yield this.playground.playByChapter(e[t], r), this.seekRedirect) {
             t = this.seekRedirect.index;
             continue;
           }
@@ -383,7 +401,7 @@ class $ {
         name: (t = e == null ? void 0 : e.name) != null ? t : "camera",
         type: "camera",
         keyframes: this.serializeKeyframes(e),
-        coordinateSpace: L
+        coordinateSpace: I
       }
     };
   }
@@ -404,7 +422,7 @@ class $ {
           name: (s = a.name) != null ? s : "camera",
           type: "camera",
           keyframes: this.serializeKeyframes(a),
-          coordinateSpace: L
+          coordinateSpace: I
         }
       });
     }), e;
@@ -422,7 +440,7 @@ class $ {
         return;
       const i = t[s], o = e[s];
       let n = i.players.find((u) => u.type === "camera");
-      n || (n = { name: (l = o.name) != null ? l : "camera", type: "camera", keyframes: [] }, i.players.push(n)), n.keyframes = [...(c = o.keyframes) != null ? c : []].sort((u, f) => u.timeStamp - f.timeStamp), o.coordinateSpace && (n.coordinateSpace = o.coordinateSpace);
+      n || (n = { name: (l = o.name) != null ? l : "camera", type: "camera", keyframes: [] }, i.players.push(n)), n.keyframes = [...(c = o.keyframes) != null ? c : []].sort((u, d) => u.timeStamp - d.timeStamp), o.coordinateSpace && (n.coordinateSpace = o.coordinateSpace);
     });
     const r = this.cameraPlayerOf(this.state.currentChapter);
     r && this.playground.setCameraKeyframes(r.keyframes);
@@ -461,26 +479,26 @@ class $ {
    * 无任何可用模型几何（未加载/无 model player/包围盒空）时返回 undefined。
    */
   deriveChapterModelFramingView(e) {
-    var d, F, M;
+    var f, k, F;
     const t = this.getChapters();
     if (e < 0 || e >= t.length)
       return;
     const r = t[e], a = new T.Box3();
     let s = !1;
-    if (r.players.forEach((S) => {
-      var E, C, v, K;
-      if (S.type !== "model")
+    if (r.players.forEach((M) => {
+      var E, C, v, N;
+      if (M.type !== "model")
         return;
-      const b = S, P = (v = (C = (E = this.playground) == null ? void 0 : E.loader) == null ? void 0 : C.getDigitalHuman) == null ? void 0 : v.call(C, b.model, b.id), y = P == null ? void 0 : P.container;
+      const S = M, P = (v = (C = (E = this.playground) == null ? void 0 : E.loader) == null ? void 0 : C.getDigitalHuman) == null ? void 0 : v.call(C, S.model, S.id), y = P == null ? void 0 : P.container;
       if (!y)
         return;
-      (K = y.updateWorldMatrix) == null || K.call(y, !0, !0);
+      (N = y.updateWorldMatrix) == null || N.call(y, !0, !0);
       const w = new T.Box3().setFromObject(y);
       w.isEmpty() || (a.union(w), s = !0);
     }), !s || a.isEmpty())
       return;
-    const i = a.getCenter(new T.Vector3()), o = a.getSize(new T.Vector3()).length(), n = (M = (F = (d = this.five).getCurrentState) == null ? void 0 : F.call(d)) != null ? M : {}, l = typeof n.longitude == "number" ? n.longitude : Math.PI / 4, c = typeof n.latitude == "number" ? n.latitude : Math.PI / 5, u = typeof n.fov == "number" && n.fov > 0 ? n.fov : 60, f = this.clamp(o * 2.5, 4, 14);
-    return { target: i, longitude: l, latitude: c, distance: f, fov: u };
+    const i = a.getCenter(new T.Vector3()), o = a.getSize(new T.Vector3()).length(), n = (F = (k = (f = this.five).getCurrentState) == null ? void 0 : k.call(f)) != null ? F : {}, l = typeof n.longitude == "number" ? n.longitude : Math.PI / 4, c = typeof n.latitude == "number" ? n.latitude : Math.PI / 5, u = typeof n.fov == "number" && n.fov > 0 ? n.fov : 60, d = this.clamp(o * 2.5, 4, 14);
+    return { target: i, longitude: l, latitude: c, distance: d, fov: u };
   }
   /**
    * 设为当前编辑章节（不开始播放）。该次调用内联动完成：
@@ -493,7 +511,7 @@ class $ {
     if (e < 0 || e >= t.length)
       return;
     const r = t[e];
-    this.playground.pause(), this.state.playing = !1, this.state.currentChapter = r, this.playground.prepareChapter(r, 0), this.applyChapterFloor(e), this.applyChapterDefaultView(e), this.state.selectedShotIndex = null, this.emitProgress(), this.emitCurrentChapterChanged();
+    this.playground.pause(), this.state.playing = !1, this.state.currentChapter = r, this.syncNameplates(r), this.playground.prepareChapter(r, 0), this.applyChapterFloor(e), this.applyChapterDefaultView(e), this.state.selectedShotIndex = null, this.emitProgress(), this.emitCurrentChapterChanged();
   }
   /** 当前章节信息：{ index, name, duration }；duration 为该章节模型动画时长（排除相机 player） */
   getCurrentChapterInfo() {
@@ -501,7 +519,7 @@ class $ {
     return e ? {
       index: this.getCurrentChapterIndex(),
       name: e.name,
-      duration: I(e)
+      duration: x(e)
     } : { index: -1, name: "", duration: 0 };
   }
   /** 注册当前章节变更监听（current-chapter-changed）；返回反订阅函数 */
@@ -545,7 +563,7 @@ class $ {
   getProgress() {
     const e = this.playground.getClock(), t = e.getTime();
     let r = e.getDuration();
-    r <= 0 && this.state.currentChapter && (r = N(this.state.currentChapter));
+    r <= 0 && this.state.currentChapter && (r = G(this.state.currentChapter));
     const a = this.getChapters(), s = this.state.currentChapter, i = s ? a.findIndex((o) => o === s || o.name === s.name) : -1;
     return { currentTime: t, totalTime: r, currentChapterIndex: i, totalChapters: a.length };
   }
@@ -569,7 +587,7 @@ class $ {
     const t = this.getChapters(), r = [];
     let a = 0;
     for (let s = 0; s < t.length; s++) {
-      const i = I(t[s]), o = a, n = o + i;
+      const i = x(t[s]), o = a, n = o + i;
       r.push({ index: s, name: t[s].name, startTime: o, endTime: n, duration: i }), a = n;
     }
     return this.groupChapterTimeMapCache = r, this.groupChapterTimeMapCacheScript = e, r;
@@ -613,7 +631,7 @@ class $ {
    */
   setCurrentChapterForPlayback(e, t) {
     const r = this.getChapters();
-    e < 0 || e >= r.length || (this.state.currentChapter = r[e], this.applyChapterFloor(e), this.playground.prepareChapter(r[e], t));
+    e < 0 || e >= r.length || (this.state.currentChapter = r[e], this.syncNameplates(r[e]), this.applyChapterFloor(e), this.playground.prepareChapter(r[e], t));
   }
   /**
    * 跳转到组级时间(ms)：映射为 (章节 index, 章节内时间)，必要时切章后 setTimelineTo。
@@ -673,13 +691,36 @@ class $ {
   getState() {
     return { playing: this.state.playing, currentChapter: this.state.currentChapter };
   }
+  /** 实时修改角色名牌；只更新文本和当前剧本，不重新加载模型/动画。 */
+  updateModelName(e, t) {
+    var a;
+    const r = z(t);
+    (a = this.state.currentScript) == null || a.chapters.forEach((s) => {
+      s.players.forEach((i) => {
+        i.type === "model" && i.id === e && (i.name = r);
+      });
+    }), this.nameplate.updateName(e, r);
+  }
+  syncNameplates(e = this.state.currentChapter) {
+    if (!e) {
+      this.nameplate.setBindings([]);
+      return;
+    }
+    const t = [];
+    e.players.forEach((r) => {
+      if (r.type !== "model")
+        return;
+      const a = this.playground.loader.getDigitalHuman(r.model, r.id);
+      a && t.push({ id: r.id, player: r, model: a.model });
+    }), this.nameplate.setBindings(t);
+  }
   /** 重置播放（保留已加载资源） */
   reset() {
-    this.playground.reset(), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.selectedShotIndex = null, this.seekRedirect = null, this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.chapterFloorModel = null, this.unhookFloorModeChange(), this.emitProgress();
+    this.playground.reset(), this.state.playing = !1, this.state.continuousPlaying = !1, this.state.currentChapter = null, this.state.selectedShotIndex = null, this.seekRedirect = null, this.nameplate.setBindings([]), this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.chapterFloorModel = null, this.unhookFloorModeChange(), this.emitProgress();
   }
   /** 销毁插件、释放资源 */
   dispose() {
-    this.unsubClockTick && (this.unsubClockTick(), this.unsubClockTick = null), this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.chapterFloorModel = null, this.unhookFloorModeChange(), this.progressListeners.clear(), this.keyframesChangedListeners.clear(), this.currentChapterChangedListeners.clear(), this.groupProgressListeners.clear(), this.cameraEditSnapshot = null, this.playground.dispose();
+    this.unsubClockTick && (this.unsubClockTick(), this.unsubClockTick = null), this.chapterFloorMap && (this.showModelFloor(), this.chapterFloorMap = null), this.chapterFloorModel = null, this.unhookFloorModeChange(), this.progressListeners.clear(), this.keyframesChangedListeners.clear(), this.currentChapterChangedListeners.clear(), this.groupProgressListeners.clear(), this.cameraEditSnapshot = null, this.unsubNameplateRender && (this.unsubNameplateRender(), this.unsubNameplateRender = null), this.unsubNameplateCameraUpdate && (this.unsubNameplateCameraUpdate(), this.unsubNameplateCameraUpdate = null), this.nameplate.dispose(), this.playground.dispose();
   }
   /** 预加载模型 / 动画 / 道具（复用 Shared_Core 加载） */
   preloadResources(e) {
@@ -691,14 +732,14 @@ class $ {
             return;
           const l = n;
           t.push(l.model), r.push(n.id), l.keyframes.forEach((c) => {
-            var f, d;
+            var d, f;
             if (!c.animation)
               return;
             a.add(c.animation.url);
             const u = c.animation.item;
             u && (s.push(u.url), i.set(u.url, {
-              position: (f = u.position) != null ? f : [0, 0, 0],
-              rotation: (d = u.rotation) != null ? d : [0, 0, 0]
+              position: (d = u.position) != null ? d : [0, 0, 0],
+              rotation: (f = u.rotation) != null ? f : [0, 0, 0]
             }));
           });
         });
@@ -810,7 +851,7 @@ class $ {
     const r = this.cameraPlayerOf(t[e]);
     if (!r || r.keyframes.length === 0)
       return null;
-    const a = new V();
+    const a = new O();
     return a.setKeyframes(r.keyframes), a;
   }
   /** 深拷贝关键帧序列（数组字段亦深拷贝），供快照/还原使用（Mapview 位姿） */
@@ -829,5 +870,5 @@ class $ {
   }
 }
 export {
-  $ as default
+  he as default
 };