u-space 0.0.3 → 0.0.5

package/dist/plugins/u-manager/index.js

@@ -3342,16 +3342,27 @@ function requireWhichTypedArray() {
         var O = r(E);
         S = p(O, Symbol.toStringTag);
       }
-      s["$" + m] = b(S.get);
+      if (S && S.get) {
+        var C = b(S.get);
+        s[
+          /** @type {`$${import('.').TypedArrayName}`} */
+          "$" + m
+        ] = C;
+      }
     }
   }) : h(n, function(m) {
     var A = new t[m](), E = A.slice || A.set;
-    E && (s[
-      /** @type {`$${import('.').TypedArrayName}`} */
-      "$" + m
-    ] = /** @type {import('./types').BoundSlice | import('./types').BoundSet} */
-    // @ts-expect-error TODO FIXME
-    b(E));
+    if (E) {
+      var S = (
+        /** @type {import('./types').BoundSlice | import('./types').BoundSet} */
+        // @ts-expect-error TODO FIXME
+        b(E)
+      );
+      s[
+        /** @type {`$${import('.').TypedArrayName}`} */
+        "$" + m
+      ] = S;
+    }
   });
   var l = function(A) {
     var E = !1;
@@ -4591,43 +4602,11 @@ function require_stream_duplex$1() {
     }
   }), _stream_duplex$1;
 }
-var string_decoder = {}, safeBuffer = { exports: {} }, hasRequiredSafeBuffer;
-function requireSafeBuffer() {
-  return hasRequiredSafeBuffer || (hasRequiredSafeBuffer = 1, (function(h, d) {
-    var b = requireDist(), u = b.Buffer;
-    function p(f, o) {
-      for (var t in f)
-        o[t] = f[t];
-    }
-    u.from && u.alloc && u.allocUnsafe && u.allocUnsafeSlow ? h.exports = b : (p(b, d), d.Buffer = r);
-    function r(f, o, t) {
-      return u(f, o, t);
-    }
-    p(u, r), r.from = function(f, o, t) {
-      if (typeof f == "number")
-        throw new TypeError("Argument must not be a number");
-      return u(f, o, t);
-    }, r.alloc = function(f, o, t) {
-      if (typeof f != "number")
-        throw new TypeError("Argument must be a number");
-      var n = u(f);
-      return o !== void 0 ? typeof t == "string" ? n.fill(o, t) : n.fill(o) : n.fill(0), n;
-    }, r.allocUnsafe = function(f) {
-      if (typeof f != "number")
-        throw new TypeError("Argument must be a number");
-      return u(f);
-    }, r.allocUnsafeSlow = function(f) {
-      if (typeof f != "number")
-        throw new TypeError("Argument must be a number");
-      return b.SlowBuffer(f);
-    };
-  })(safeBuffer, safeBuffer.exports)), safeBuffer.exports;
-}
-var hasRequiredString_decoder;
+var string_decoder = {}, hasRequiredString_decoder;
 function requireString_decoder() {
   if (hasRequiredString_decoder) return string_decoder;
   hasRequiredString_decoder = 1;
-  var h = requireSafeBuffer().Buffer, d = h.isEncoding || function(E) {
+  var h = requireSafeBuffer$1().Buffer, d = h.isEncoding || function(E) {
     switch (E = "" + E, E && E.toLowerCase()) {
       case "hex":
       case "utf8":
@@ -5688,6 +5667,38 @@ var streamBrowser, hasRequiredStreamBrowser;
 function requireStreamBrowser() {
   return hasRequiredStreamBrowser || (hasRequiredStreamBrowser = 1, streamBrowser = requireEvents().EventEmitter), streamBrowser;
 }
+var safeBuffer = { exports: {} }, hasRequiredSafeBuffer;
+function requireSafeBuffer() {
+  return hasRequiredSafeBuffer || (hasRequiredSafeBuffer = 1, (function(h, d) {
+    var b = requireDist(), u = b.Buffer;
+    function p(f, o) {
+      for (var t in f)
+        o[t] = f[t];
+    }
+    u.from && u.alloc && u.allocUnsafe && u.allocUnsafeSlow ? h.exports = b : (p(b, d), d.Buffer = r);
+    function r(f, o, t) {
+      return u(f, o, t);
+    }
+    p(u, r), r.from = function(f, o, t) {
+      if (typeof f == "number")
+        throw new TypeError("Argument must not be a number");
+      return u(f, o, t);
+    }, r.alloc = function(f, o, t) {
+      if (typeof f != "number")
+        throw new TypeError("Argument must be a number");
+      var n = u(f);
+      return o !== void 0 ? typeof t == "string" ? n.fill(o, t) : n.fill(o) : n.fill(0), n;
+    }, r.allocUnsafe = function(f) {
+      if (typeof f != "number")
+        throw new TypeError("Argument must be a number");
+      return u(f);
+    }, r.allocUnsafeSlow = function(f) {
+      if (typeof f != "number")
+        throw new TypeError("Argument must be a number");
+      return b.SlowBuffer(f);
+    };
+  })(safeBuffer, safeBuffer.exports)), safeBuffer.exports;
+}
 var util = {}, hasRequiredUtil;
 function requireUtil() {
   if (hasRequiredUtil) return util;
@@ -9898,7 +9909,7 @@ function requireBn$1() {
           var _ = 67108863 ^ 67108863 >>> g << g;
           this.words[this.length - 1] &= _;
         }
-        return this.strip();
+        return this.length === 0 && (this.words[0] = 0, this.length = 1), this.strip();
       }, r.prototype.maskn = function(v) {
         return this.clone().imaskn(v);
       }, r.prototype.iaddn = function(v) {
@@ -11279,7 +11290,7 @@ function requireBn() {
           var q = 67108863 ^ 67108863 >>> _ << _;
           this.words[this.length - 1] &= q;
         }
-        return this._strip();
+        return this.length === 0 && (this.words[0] = 0, this.length = 1), this._strip();
       }, r.prototype.maskn = function(c) {
         return this.clone().imaskn(c);
       }, r.prototype.iaddn = function(c) {

package/dist/src/objects/Model.d.ts

@@ -1,4 +1,4 @@
-import { type Object3D } from 'three/webgpu';
+import { type Object3D, AnimationMixer, type AnimationAction, type AnimationClip } from 'three/webgpu';
 import { type InteractionEventMap } from '../interactions';
 import { BaseGroup } from './BaseGroup';
 export interface ModelParameters {
@@ -6,12 +6,25 @@ export interface ModelParameters {
     cache?: boolean;
     persistent?: boolean;
 }
+export interface PlayAnimationOptions {
+    loop?: boolean;
+    repetitions?: number;
+    timeScale?: number;
+    clampWhenFinished?: boolean;
+}
 export declare class Model extends BaseGroup<InteractionEventMap> {
     readonly isModel = true;
     type: string;
     private static memoryCache;
+    mixer: AnimationMixer | null;
+    animations: AnimationClip[];
+    private actions;
     constructor();
     loadAsync(parameters: ModelParameters): Promise<Object3D<import("three").Object3DEventMap> | null>;
+    playAnimation(nameOrIndex?: string | number, options?: PlayAnimationOptions): AnimationAction | null;
+    playAllAnimations(options?: PlayAnimationOptions): AnimationAction[];
+    stopAnimation(nameOrIndex?: string | number): void;
+    updateAnimation(delta: number): void;
     static clearMemoryCache(): void;
     static clearPersistentCache(): Promise<void>;
 }

package/dist/src/objects/Poi.d.ts

@@ -21,11 +21,15 @@ export interface PoiParameters {
     borderRadius?: number;
     /** Text position relative to the icon */
     textPosition?: 'top' | 'bottom' | 'left' | 'right';
+    /** Scale factor for mapping canvas pixels to world units */
+    scaleFactor?: number;
 }
 export declare class Poi extends BaseSprite<InteractionEventMap> {
     readonly isPoi = true;
     type: string;
     parameters: Required<PoiParameters>;
+    private _canvas;
+    private _lastParametersJSON;
     constructor(parameters?: PoiParameters);
     /**
      * Update the POI with new parameters

package/dist/src/viewers/Viewer.d.ts

@@ -14,15 +14,19 @@ export interface ViewerOptions {
 export interface ViewerEventMap {
     beforeControlsUpdate: {
         time: number;
+        delta: number;
     };
     afterControlsUpdate: {
         time: number;
+        delta: number;
     };
     beforeRender: {
         time: number;
+        delta: number;
     };
     afterRender: {
         time: number;
+        delta: number;
     };
     cameraChange: {
         camera: PerspectiveCamera | OrthographicCamera;

package/docs/api-objects.md

@@ -66,6 +66,64 @@ const model3 = new Model();
 model3.loadAsync({ url: 'model.glb', cache: true, persistent: true });
 ```
 
+### 动画
+
+`Model` 在加载含内置动画的模型（如 glTF/FBX）后，会自动初始化 `AnimationMixer` 并收集 `AnimationClip`。
+
+**属性：**
+
+| 属性         | 类型                        | 说明                                       |
+| :----------- | :-------------------------- | :----------------------------------------- |
+| `mixer`      | `AnimationMixer \| null`    | 动画混合器，加载含动画模型后自动创建。     |
+| `animations` | `AnimationClip[]`           | 模型内置的动画片段列表。                   |
+
+#### `playAnimation(nameOrIndex?, options?)`
+
+播放指定动画。不传参时播放第一个动画。
+
+```typescript
+// 按名称播放
+model.playAnimation('Walk');
+
+// 按索引播放
+model.playAnimation(0);
+
+// 带选项
+model.playAnimation('Run', {
+  loop: true,          // 是否循环（默认 true）
+  repetitions: 3,      // 循环次数（默认 Infinity）
+  timeScale: 1.5,      // 播放速度（默认 1）
+  clampWhenFinished: true, // 播放结束后停留在最后一帧（默认 false）
+});
+```
+
+#### `playAllAnimations(options?)`
+
+播放模型所有内置动画。参数同 `playAnimation`。
+
+```typescript
+model.playAllAnimations({ timeScale: 2 });
+```
+
+#### `stopAnimation(nameOrIndex?)`
+
+停止指定动画。不传参时停止所有动画。
+
+```typescript
+model.stopAnimation('Walk'); // 停止指定动画
+model.stopAnimation();       // 停止所有动画
+```
+
+#### `updateAnimation(delta)`
+
+推进动画时间，需在渲染循环中调用。`delta` 为帧间隔时间（秒），可从 Viewer 事件的 `delta` 属性获取。
+
+```typescript
+viewer.addEventListener('beforeRender', (e) => {
+  model.updateAnimation(e.delta);
+});
+```
+
 ### 清除缓存
 
 可通过 `Model` 类的静态方法手动清除内部缓存：

package/docs/api-viewer.md

@@ -158,8 +158,10 @@ viewer.dispose();
 
 Viewer 继承自 `EventDispatcher`，会触发以下事件：
 
-- `beforeControlsUpdate`：在 `CameraControls` 更新之前触发，提供 `{ time: number }`。
-- `afterControlsUpdate`：在 `CameraControls` 更新之后触发，提供 `{ time: number }`。
-- `beforeRender`：在 `renderer.render` 调用之前立即触发，提供 `{ time: number }`。
-- `afterRender`：在 `renderer.render` 完成之后立即触发，提供 `{ time: number }`。
+- `beforeControlsUpdate`：在 `CameraControls` 更新之前触发，提供 `{ time: number; delta: number }`。
+- `afterControlsUpdate`：在 `CameraControls` 更新之后触发，提供 `{ time: number; delta: number }`。
+- `beforeRender`：在 `renderer.render` 调用之前立即触发，提供 `{ time: number; delta: number }`。
+- `afterRender`：在 `renderer.render` 完成之后立即触发，提供 `{ time: number; delta: number }`。
 - `cameraChange`：调用 `setCamera` 时触发，提供 `{ camera: Camera }`。
+
+其中 `delta` 为上一帧到当前帧的时间间隔（秒），可用于动画更新等场景。

package/docs/examples-guide.md

@@ -46,3 +46,17 @@
 - 流式传输结构化场景布局，解析场景描述（`SceneLoader`、`TopologiesLoader`）。
 - 使用相机动画（`VisionsLoader` 和 `VisionsParser`）在场景中编排预定义的飞行路径。
 - 获取复杂的节点材质，并自定义 WebGPU 专属的 TSL（Three Shading Language）节点，如 `TSLEffects.fluid()`。
+
+## 5. `test_model_animation.html`：模型内置动画
+
+[在线演示](https://u-space-phi.vercel.app/examples/test_model_animation.html)
+
+该示例演示了如何加载含内置动画的 glTF 模型，并通过 `Model` 类的动画 API 控制播放。
+
+### 核心要点：
+
+- 使用 `Model.loadAsync()` 加载带动画的 `.glb` 文件，动画片段自动初始化。
+- 使用 `viewer.frameloop = 'always'` 开启持续渲染以驱动动画。
+- 监听 `beforeRender` 事件，通过 `model.updateAnimation(e.delta)` 推进动画时间。
+- 使用 `model.playAnimation(name)` 按名称播放单个动画，`model.playAllAnimations()` 播放全部。
+- 使用 `model.stopAnimation()` 停止动画播放。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-space",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "types": "dist/src/index.d.ts",
   "module": "dist/index.js",