@zephyr3d/scene 0.7.1 → 0.8.0

package/dist/animation/animation.js

@@ -168,24 +168,6 @@ import { Disposable } from '@zephyr3d/base';
         track.reset(target);
         return this;
     }
-    /** @internal */ resample(frames, callback) {
-        for(let frame = 0; frame <= frames; frame++){
-            const t = frame / this.timeDuration;
-            for (const [k, v] of this.tracks){
-                for (const track of v){
-                    const state = track.calculateState(k, t);
-                    track.applyState(k, state);
-                }
-            }
-            for (const sk of this.skeletons){
-                const skeleton = this._animationSet.model.findSkeletonById(sk);
-                if (skeleton) {
-                    skeleton.computeJoints();
-                }
-            }
-            callback(frame);
-        }
-    }
 }
 
 export { AnimationClip };

package/dist/animation/animation.js.map

@@ -1 +1 @@
-{"version":3,"file":"animation.js","sources":["../../src/animation/animation.ts"],"sourcesContent":["import { Disposable } from '@zephyr3d/base';\r\nimport type { AnimationSet } from './animationset';\r\nimport type { AnimationTrack } from './animationtrack';\r\n\r\n/**\r\n * Animation clip\r\n *\r\n * Represents a named animation composed of multiple tracks targeting various objects/properties,\r\n * with an overall duration, weight, and optional auto-play behavior. Tracks may target different\r\n * objects and are grouped by a per-target array. Skeletons used by this clip are tracked for\r\n * lifecycle and application during playback.\r\n *\r\n * Typical workflow:\r\n * - Create a clip via `AnimationSet.createAnimation(name)`.\r\n * - Add one or more `AnimationTrack`s via `addTrack(target, track)`.\r\n * - Optionally register skeletons via `addSkeleton(...)`.\r\n * - Start playback through the owning `AnimationSet.playAnimation(name, options)`.\r\n *\r\n * @public\r\n */\r\nexport class AnimationClip extends Disposable {\r\n  /** @internal */\r\n  protected _name: string;\r\n  /** @internal */\r\n  protected _animationSet: AnimationSet;\r\n  /** @internal */\r\n  protected _embedded: boolean;\r\n  /** @internal */\r\n  protected _duration: number;\r\n  /** @internal */\r\n  protected _autoPlay: boolean;\r\n  /** @internal */\r\n  protected _tracks: Map<object, AnimationTrack[]>;\r\n  protected _weight: number;\r\n  /** @internal */\r\n  protected _skeletons: Set<string>;\r\n  /**\r\n   * Creates an animation instance\r\n   * @param name - Name of the animation\r\n   * @param model - Parent node if this is a skeleton animation\r\n   */\r\n  constructor(name: string, animationSet: AnimationSet, embedded = false) {\r\n    super();\r\n    this._name = name;\r\n    this._animationSet = animationSet;\r\n    this._embedded = embedded;\r\n    this._tracks = new Map();\r\n    this._duration = 0;\r\n    this._weight = 1;\r\n    this._autoPlay = false;\r\n    this._skeletons = new Set();\r\n  }\r\n  /**\r\n   * Whether this clip is embedded (owned inline by its container/resource).\r\n   */\r\n  get embedded() {\r\n    return this._embedded;\r\n  }\r\n  /**\r\n   * The `AnimationSet` that owns this clip.\r\n   */\r\n  get animationSet() {\r\n    return this._animationSet;\r\n  }\r\n  /**\r\n   * Global blend weight for the clip.\r\n   *\r\n   * Used by the animation system when combining multiple active clips.\r\n   */\r\n  get weight() {\r\n    return this._weight;\r\n  }\r\n  set weight(val: number) {\r\n    this._weight = val;\r\n  }\r\n  /**\r\n   * Whether this clip should start playing automatically when loaded/instantiated.\r\n   */\r\n  get autoPlay() {\r\n    return this._autoPlay;\r\n  }\r\n  set autoPlay(val: boolean) {\r\n    this._autoPlay = val;\r\n  }\r\n  /**\r\n   * The unique name of this clip.\r\n   */\r\n  get name() {\r\n    return this._name;\r\n  }\r\n  /**\r\n   * All animation tracks grouped by target object.\r\n   *\r\n   * Key: target object; Value: list of `AnimationTrack`s affecting that target.\r\n   */\r\n  get tracks() {\r\n    return this._tracks;\r\n  }\r\n  /**\r\n   * All skeletons referenced by this clip.\r\n   */\r\n  get skeletons() {\r\n    return this._skeletons;\r\n  }\r\n  set skeletons(val: Set<string>) {\r\n    this._skeletons = val;\r\n  }\r\n  /**\r\n   * Total time span of the clip in seconds.\r\n   *\r\n   * Automatically extended when adding tracks with longer duration.\r\n   */\r\n  get timeDuration() {\r\n    return this._duration;\r\n  }\r\n  set timeDuration(val) {\r\n    this._duration = val;\r\n  }\r\n  /**\r\n   * Add a skeleton used by this clip.\r\n   *\r\n   * @param skeletonId - Persistent ID of Skeleton to register for this clip.\r\n   */\r\n  addSkeleton(skeletonId: string) {\r\n    this._skeletons.add(skeletonId);\r\n  }\r\n  /**\r\n   * Remove a specific track from this clip.\r\n   *\r\n   * Errors if the track does not belong to this clip. Does nothing if not found.\r\n   *\r\n   * @param track - The track instance to remove.\r\n   * @returns This clip (for chaining).\r\n   */\r\n  deleteTrack(track: AnimationTrack) {\r\n    if (track?.animation !== this) {\r\n      console.error('Cannot delete animation track which is not belongs to THIS animation');\r\n    }\r\n    for (const k of this._tracks.keys()) {\r\n      const tracks = this._tracks.get(k)!;\r\n      const index = tracks.indexOf(track);\r\n      if (index >= 0) {\r\n        tracks.splice(index, 1);\r\n      }\r\n    }\r\n    return this;\r\n  }\r\n  /**\r\n   * Add a track to this clip for a specific target object.\r\n   *\r\n   * Constraints:\r\n   * - The track must not already belong to another clip.\r\n   * - Only one track with the same blendId may exist per target in a single clip.\r\n   *\r\n   * Side effects:\r\n   * - Assigns this clip to `track.animation`.\r\n   * - Extends `timeDuration` to cover the track duration if longer.\r\n   * - Calls `track.reset(target)` to initialize the target state if needed.\r\n   *\r\n   * @param target - Target object controlled by the track.\r\n   * @param track - Track to add.\r\n   * @returns This clip (for chaining).\r\n   */\r\n  addTrack(target: object, track: AnimationTrack) {\r\n    if (!track) {\r\n      return this;\r\n    }\r\n    if (track.animation) {\r\n      if (track.animation === this) {\r\n        return this;\r\n      } else {\r\n        console.error('Track is already in another animation');\r\n        return this;\r\n      }\r\n    }\r\n    const blendId = track.getBlendId();\r\n    const tracks = this._tracks.get(target);\r\n    if (tracks && tracks.findIndex((track) => track.getBlendId() === blendId) >= 0) {\r\n      console.error('Tracks with same BlendId could not be added to same animation');\r\n      return this;\r\n    }\r\n    track.animation = this;\r\n    let trackInfo = this._tracks.get(target);\r\n    if (!trackInfo) {\r\n      trackInfo = [];\r\n      this._tracks.set(target, trackInfo);\r\n    }\r\n    trackInfo.push(track);\r\n    this._duration = Math.max(this._duration, track.getDuration() ?? 0);\r\n    track.reset(target);\r\n    return this;\r\n  }\r\n  /** @internal */\r\n  resample(frames: number, callback: (frame: number) => void) {\r\n    for (let frame = 0; frame <= frames; frame++) {\r\n      const t = frame / this.timeDuration;\r\n      for (const [k, v] of this.tracks) {\r\n        for (const track of v) {\r\n          const state = track.calculateState(k, t);\r\n          track.applyState(k, state);\r\n        }\r\n      }\r\n      for (const sk of this.skeletons) {\r\n        const skeleton = this._animationSet.model.findSkeletonById(sk);\r\n        if (skeleton) {\r\n          skeleton.computeJoints();\r\n        }\r\n      }\r\n      callback(frame);\r\n    }\r\n  }\r\n}\r\n"],"names":["AnimationClip","Disposable","_weight","name","animationSet","embedded","_name","_animationSet","_embedded","_tracks","Map","_duration","_autoPlay","_skeletons","Set","weight","val","autoPlay","tracks","skeletons","timeDuration","addSkeleton","skeletonId","add","deleteTrack","track","animation","console","error","k","keys","get","index","indexOf","splice","addTrack","target","blendId","getBlendId","findIndex","trackInfo","set","push","Math","max","getDuration","reset","resample","frames","callback","frame","t","v","state","calculateState","applyState","sk","skeleton","model","findSkeletonById","computeJoints"],"mappings":"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"}
+{"version":3,"file":"animation.js","sources":["../../src/animation/animation.ts"],"sourcesContent":["import { Disposable } from '@zephyr3d/base';\r\nimport type { AnimationSet } from './animationset';\r\nimport type { AnimationTrack } from './animationtrack';\r\n\r\n/**\r\n * Animation clip\r\n *\r\n * Represents a named animation composed of multiple tracks targeting various objects/properties,\r\n * with an overall duration, weight, and optional auto-play behavior. Tracks may target different\r\n * objects and are grouped by a per-target array. Skeletons used by this clip are tracked for\r\n * lifecycle and application during playback.\r\n *\r\n * Typical workflow:\r\n * - Create a clip via `AnimationSet.createAnimation(name)`.\r\n * - Add one or more `AnimationTrack`s via `addTrack(target, track)`.\r\n * - Optionally register skeletons via `addSkeleton(...)`.\r\n * - Start playback through the owning `AnimationSet.playAnimation(name, options)`.\r\n *\r\n * @public\r\n */\r\nexport class AnimationClip extends Disposable {\r\n  /** @internal */\r\n  protected _name: string;\r\n  /** @internal */\r\n  protected _animationSet: AnimationSet;\r\n  /** @internal */\r\n  protected _embedded: boolean;\r\n  /** @internal */\r\n  protected _duration: number;\r\n  /** @internal */\r\n  protected _autoPlay: boolean;\r\n  /** @internal */\r\n  protected _tracks: Map<object, AnimationTrack[]>;\r\n  protected _weight: number;\r\n  /** @internal */\r\n  protected _skeletons: Set<string>;\r\n  /**\r\n   * Creates an animation instance\r\n   * @param name - Name of the animation\r\n   * @param model - Parent node if this is a skeleton animation\r\n   */\r\n  constructor(name: string, animationSet: AnimationSet, embedded = false) {\r\n    super();\r\n    this._name = name;\r\n    this._animationSet = animationSet;\r\n    this._embedded = embedded;\r\n    this._tracks = new Map();\r\n    this._duration = 0;\r\n    this._weight = 1;\r\n    this._autoPlay = false;\r\n    this._skeletons = new Set();\r\n  }\r\n  /**\r\n   * Whether this clip is embedded (owned inline by its container/resource).\r\n   */\r\n  get embedded() {\r\n    return this._embedded;\r\n  }\r\n  /**\r\n   * The `AnimationSet` that owns this clip.\r\n   */\r\n  get animationSet() {\r\n    return this._animationSet;\r\n  }\r\n  /**\r\n   * Global blend weight for the clip.\r\n   *\r\n   * Used by the animation system when combining multiple active clips.\r\n   */\r\n  get weight() {\r\n    return this._weight;\r\n  }\r\n  set weight(val: number) {\r\n    this._weight = val;\r\n  }\r\n  /**\r\n   * Whether this clip should start playing automatically when loaded/instantiated.\r\n   */\r\n  get autoPlay() {\r\n    return this._autoPlay;\r\n  }\r\n  set autoPlay(val: boolean) {\r\n    this._autoPlay = val;\r\n  }\r\n  /**\r\n   * The unique name of this clip.\r\n   */\r\n  get name() {\r\n    return this._name;\r\n  }\r\n  /**\r\n   * All animation tracks grouped by target object.\r\n   *\r\n   * Key: target object; Value: list of `AnimationTrack`s affecting that target.\r\n   */\r\n  get tracks() {\r\n    return this._tracks;\r\n  }\r\n  /**\r\n   * All skeletons referenced by this clip.\r\n   */\r\n  get skeletons() {\r\n    return this._skeletons;\r\n  }\r\n  set skeletons(val: Set<string>) {\r\n    this._skeletons = val;\r\n  }\r\n  /**\r\n   * Total time span of the clip in seconds.\r\n   *\r\n   * Automatically extended when adding tracks with longer duration.\r\n   */\r\n  get timeDuration() {\r\n    return this._duration;\r\n  }\r\n  set timeDuration(val) {\r\n    this._duration = val;\r\n  }\r\n  /**\r\n   * Add a skeleton used by this clip.\r\n   *\r\n   * @param skeletonId - Persistent ID of Skeleton to register for this clip.\r\n   */\r\n  addSkeleton(skeletonId: string) {\r\n    this._skeletons.add(skeletonId);\r\n  }\r\n  /**\r\n   * Remove a specific track from this clip.\r\n   *\r\n   * Errors if the track does not belong to this clip. Does nothing if not found.\r\n   *\r\n   * @param track - The track instance to remove.\r\n   * @returns This clip (for chaining).\r\n   */\r\n  deleteTrack(track: AnimationTrack) {\r\n    if (track?.animation !== this) {\r\n      console.error('Cannot delete animation track which is not belongs to THIS animation');\r\n    }\r\n    for (const k of this._tracks.keys()) {\r\n      const tracks = this._tracks.get(k)!;\r\n      const index = tracks.indexOf(track);\r\n      if (index >= 0) {\r\n        tracks.splice(index, 1);\r\n      }\r\n    }\r\n    return this;\r\n  }\r\n  /**\r\n   * Add a track to this clip for a specific target object.\r\n   *\r\n   * Constraints:\r\n   * - The track must not already belong to another clip.\r\n   * - Only one track with the same blendId may exist per target in a single clip.\r\n   *\r\n   * Side effects:\r\n   * - Assigns this clip to `track.animation`.\r\n   * - Extends `timeDuration` to cover the track duration if longer.\r\n   * - Calls `track.reset(target)` to initialize the target state if needed.\r\n   *\r\n   * @param target - Target object controlled by the track.\r\n   * @param track - Track to add.\r\n   * @returns This clip (for chaining).\r\n   */\r\n  addTrack(target: object, track: AnimationTrack) {\r\n    if (!track) {\r\n      return this;\r\n    }\r\n    if (track.animation) {\r\n      if (track.animation === this) {\r\n        return this;\r\n      } else {\r\n        console.error('Track is already in another animation');\r\n        return this;\r\n      }\r\n    }\r\n    const blendId = track.getBlendId();\r\n    const tracks = this._tracks.get(target);\r\n    if (tracks && tracks.findIndex((track) => track.getBlendId() === blendId) >= 0) {\r\n      console.error('Tracks with same BlendId could not be added to same animation');\r\n      return this;\r\n    }\r\n    track.animation = this;\r\n    let trackInfo = this._tracks.get(target);\r\n    if (!trackInfo) {\r\n      trackInfo = [];\r\n      this._tracks.set(target, trackInfo);\r\n    }\r\n    trackInfo.push(track);\r\n    this._duration = Math.max(this._duration, track.getDuration() ?? 0);\r\n    track.reset(target);\r\n    return this;\r\n  }\r\n  /*\r\n  resample(frames: number, callback: (frame: number) => void) {\r\n    for (let frame = 0; frame <= frames; frame++) {\r\n      const t = frame / this.timeDuration;\r\n      for (const [k, v] of this.tracks) {\r\n        for (const track of v) {\r\n          const state = track.calculateState(k, t);\r\n          track.applyState(k, state);\r\n        }\r\n      }\r\n      for (const sk of this.skeletons) {\r\n        const skeleton = this._animationSet.model.findSkeletonById(sk);\r\n        if (skeleton) {\r\n          skeleton.computeJoints();\r\n        }\r\n      }\r\n      callback(frame);\r\n    }\r\n  }\r\n  */\r\n}\r\n"],"names":["AnimationClip","Disposable","_weight","name","animationSet","embedded","_name","_animationSet","_embedded","_tracks","Map","_duration","_autoPlay","_skeletons","Set","weight","val","autoPlay","tracks","skeletons","timeDuration","addSkeleton","skeletonId","add","deleteTrack","track","animation","console","error","k","keys","get","index","indexOf","splice","addTrack","target","blendId","getBlendId","findIndex","trackInfo","set","push","Math","max","getDuration","reset"],"mappings":"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"}

package/dist/animation/animationset.js

@@ -169,8 +169,8 @@ import { AnimationClip } from './animation.js';
             });
         });
         // Update skeletons
-        this._activeSkeletons.forEach((v, k)=>{
-            k.apply();
+        this._skeletons.forEach((v)=>{
+            v.get()?.apply(deltaInSeconds);
         });
     }
     /**

package/dist/animation/animationset.js.map

@@ -1 +1 @@
-{"version":3,"file":"animationset.js","sources":["../../src/animation/animationset.ts"],"sourcesContent":["import { weightedAverage, Disposable } from '@zephyr3d/base';\r\nimport type { DRef, IDisposable } from '@zephyr3d/base';\r\nimport type { SceneNode } from '../scene';\r\nimport { AnimationClip } from './animation';\r\nimport type { AnimationTrack } from './animationtrack';\r\nimport type { Skeleton } from './skeleton';\r\n\r\n/**\r\n * Options for playing an animation.\r\n *\r\n * Controls looping, playback speed (including reverse), and fade-in blending.\r\n * @public\r\n **/\r\nexport type PlayAnimationOptions = {\r\n  /**\r\n   * Number of loops to play.\r\n   *\r\n   * - 0: infinite looping (default).\r\n   * - n \\> 0: play exactly n loops (each loop is one full duration of the clip).\r\n   */\r\n  repeat?: number;\r\n  /**\r\n   * Playback speed multiplier.\r\n   *\r\n   * - 1: normal speed (default).\r\n   * - \\>1: faster; \\<1: slower.\r\n   * - Negative values play the clip in reverse. The initial `currentTime` will be set to the end.\r\n   */\r\n  speedRatio?: number;\r\n  /**\r\n   * Fade-in duration in seconds.\r\n   *\r\n   * Interpolates the animation weight from 0 to the clip's configured weight over this time.\r\n   * Use together with `stopAnimation(..., { fadeOut })` for smooth cross-fading.\r\n   * Default is 0 (no fade-in).\r\n   */\r\n  fadeIn?: number;\r\n  /**\r\n   * Weight of the animation clip.\r\n   *\r\n   * Used during blending when multiple animations affect the same property.\r\n   * Default is the clip's configured weight.\r\n   */\r\n  weight?: number;\r\n};\r\n\r\n/**\r\n * Options for stopping an animation.\r\n *\r\n * Allows a graceful fade-out instead of abrupt stop.\r\n * @public\r\n */\r\nexport type StopAnimationOptions = {\r\n  /**\r\n   * Fade-out duration in seconds.\r\n   *\r\n   * Interpolates the current animation weight down to 0 over this time.\r\n   * Default is 0 (immediate stop).\r\n   */\r\n  fadeOut?: number;\r\n};\r\n\r\n/**\r\n * Animation set\r\n *\r\n * Manages a collection of named animation clips for a model and orchestrates:\r\n * - Playback state (time, loops, speed, weights, fade-in/out).\r\n * - Blending across multiple tracks targeting the same property via weighted averages.\r\n * - Skeleton usage and application for clips that drive skeletal animation.\r\n * - Active track registration and cleanup as clips start/stop.\r\n *\r\n * Usage:\r\n * - Create or retrieve `AnimationClip`s by name.\r\n * - Start playback with `playAnimation(name, options)`.\r\n * - Advance animation with `update(deltaSeconds)`.\r\n * - Optionally adjust weight while playing with `setAnimationWeight(name, weight)`.\r\n *\r\n * Lifetime:\r\n * - Disposing the set releases references to the model, clips, and clears active state.\r\n *\r\n * @public\r\n */\r\nexport class AnimationSet extends Disposable implements IDisposable {\r\n  /** @internal */\r\n  private _model: SceneNode;\r\n  /** @internal */\r\n  private _animations: Partial<Record<string, AnimationClip>>;\r\n  /** @internal */\r\n  private _skeletons: DRef<Skeleton>[];\r\n  /** @internal */\r\n  private readonly _activeTracks: Map<object, Map<unknown, AnimationTrack[]>>;\r\n  /** @internal */\r\n  private readonly _activeSkeletons: Map<Skeleton, number>;\r\n  /** @internal */\r\n  private readonly _activeAnimations: Map<\r\n    AnimationClip,\r\n    {\r\n      currentTime: number;\r\n      repeat: number;\r\n      repeatCounter: number;\r\n      weight: number;\r\n      speedRatio: number;\r\n      firstFrame: boolean;\r\n      fadeIn: number;\r\n      fadeOut: number;\r\n      fadeOutStart: number;\r\n      animateTime: number;\r\n    }\r\n  >;\r\n  /**\r\n   * Create an AnimationSet controlling the provided model.\r\n   *\r\n   * @param model - The SceneNode (model root) controlled by this animation set.\r\n   */\r\n  constructor(model: SceneNode) {\r\n    super();\r\n    this._model = model;\r\n    this._animations = {};\r\n    this._activeTracks = new Map();\r\n    this._activeSkeletons = new Map();\r\n    this._activeAnimations = new Map();\r\n    this._skeletons = [];\r\n  }\r\n  /**\r\n   * The model (SceneNode) controlled by this animation set.\r\n   */\r\n  get model() {\r\n    return this._model;\r\n  }\r\n  /**\r\n   * Number of animation clips registered in this set.\r\n   */\r\n  get numAnimations() {\r\n    return Object.getOwnPropertyNames(this._animations).length;\r\n  }\r\n  /**\r\n   * The skeletons used by animations in this set.\r\n   */\r\n  get skeletons() {\r\n    return this._skeletons;\r\n  }\r\n  /**\r\n   * Retrieve an animation clip by name.\r\n   *\r\n   * @param name - Name of the animation.\r\n   * @returns The clip if present; otherwise null.\r\n   */\r\n  get(name: string) {\r\n    return this._animations[name] ?? null;\r\n  }\r\n  /**\r\n   * Create and register a new animation clip.\r\n   *\r\n   * @param name - Unique name for the animation clip.\r\n   * @param embedded - Whether the clip is embedded/owned (implementation-specific). Default false.\r\n   * @returns The created clip, or null if the name is empty or not unique.\r\n   */\r\n  createAnimation(name: string, embedded = false) {\r\n    if (!name || this._animations[name]) {\r\n      console.error('Animation must have unique name');\r\n      return null;\r\n    } else {\r\n      const animation = new AnimationClip(name, this, embedded);\r\n      this._animations[name] = animation;\r\n      this._model.scene?.queueUpdateNode(this._model);\r\n      return animation;\r\n    }\r\n  }\r\n  /**\r\n   * Delete and dispose an animation clip by name.\r\n   *\r\n   * - If the animation is currently playing, it is first stopped (immediately).\r\n   *\r\n   * @param name - Name of the animation to remove.\r\n   */\r\n  deleteAnimation(name: string) {\r\n    const animation = this._animations[name];\r\n    if (animation) {\r\n      this.stopAnimation(name);\r\n      delete this._animations[name];\r\n      animation.dispose();\r\n    }\r\n  }\r\n  /**\r\n   * Get the list of all registered animation names.\r\n   *\r\n   * @returns An array of clip names.\r\n   */\r\n  getAnimationNames() {\r\n    return Object.keys(this._animations);\r\n  }\r\n  /**\r\n   * Advance and apply active animations.\r\n   *\r\n   * Responsibilities per call:\r\n   * - Update time cursor for each active clip (respecting speedRatio and looping).\r\n   * - Enforce repeat limits and apply fade-out termination if configured.\r\n   * - For each animated target, blend active tracks (weighted by clip weight × fade-in × fade-out)\r\n   *   and apply the resulting state to the target.\r\n   * - Apply all active skeletons to update skinning transforms.\r\n   *\r\n   * @param deltaInSeconds - Time step in seconds since last update.\r\n   */\r\n  update(deltaInSeconds: number) {\r\n    this._activeAnimations.forEach((v, k) => {\r\n      if (v.fadeOut > 0 && v.fadeOutStart < 0) {\r\n        v.fadeOutStart = v.animateTime;\r\n      }\r\n      // Update animation time\r\n      if (v.firstFrame) {\r\n        v.firstFrame = false;\r\n      } else {\r\n        const timeAdvance = deltaInSeconds * v.speedRatio;\r\n        v.currentTime += timeAdvance;\r\n        v.animateTime += timeAdvance;\r\n        if (v.currentTime > k.timeDuration) {\r\n          v.repeatCounter++;\r\n          v.currentTime = 0;\r\n        } else if (v.currentTime < 0) {\r\n          v.repeatCounter++;\r\n          v.currentTime = k.timeDuration;\r\n        }\r\n        if (v.repeat !== 0 && v.repeatCounter >= v.repeat) {\r\n          this.stopAnimation(k.name);\r\n        } else if (v.fadeOut > 0) {\r\n          if (v.animateTime - v.fadeOutStart >= v.fadeOut) {\r\n            this.stopAnimation(k.name);\r\n          }\r\n        }\r\n      }\r\n    });\r\n    // Update tracks\r\n    this._activeTracks.forEach((v, k) => {\r\n      v.forEach((alltracks) => {\r\n        // Only deal with tracks which have not been removed\r\n        const tracks = alltracks.filter(\r\n          (track) => track.animation && this.isPlayingAnimation(track.animation.name)\r\n        );\r\n        if (tracks.length > 0) {\r\n          const weights = tracks.map((track) => {\r\n            const info = this._activeAnimations.get(track.animation!)!;\r\n            const weight = info.weight;\r\n            const fadeIn = info.fadeIn === 0 ? 1 : Math.min(1, info.animateTime / info.fadeIn);\r\n            let fadeOut = 1;\r\n            if (info.fadeOut !== 0) {\r\n              fadeOut = 1 - (info.animateTime - info.fadeOutStart) / info.fadeOut;\r\n            }\r\n            return weight * fadeIn * fadeOut;\r\n          });\r\n          const states = tracks.map((track) => {\r\n            const info = this._activeAnimations.get(track.animation!)!;\r\n            const t = (info.currentTime / track.animation!.timeDuration) * track.getDuration();\r\n            return track.calculateState(k, t);\r\n          });\r\n          const state = weightedAverage(weights, states, (a, b, t) => {\r\n            return tracks[0].mixState(a, b, t);\r\n          });\r\n          tracks[0].applyState(k, state);\r\n        }\r\n      });\r\n    });\r\n    // Update skeletons\r\n    this._activeSkeletons.forEach((v, k) => {\r\n      k.apply();\r\n    });\r\n  }\r\n  /**\r\n   * Check whether an animation is currently playing.\r\n   *\r\n   * @param name - Optional animation name. If omitted, returns true if any animation is playing.\r\n   * @returns True if playing; otherwise false.\r\n   */\r\n  isPlayingAnimation(name?: string) {\r\n    if (name) {\r\n      const animation = this._animations[name];\r\n      return !!animation && this._activeAnimations.has(animation);\r\n    }\r\n    return this._activeAnimations.size > 0;\r\n  }\r\n  /**\r\n   * Get an animation clip by name.\r\n   *\r\n   * Alias of `get(name)` returning a nullable type.\r\n   *\r\n   * @param name - Name of the animation.\r\n   * @returns The clip if present; otherwise null.\r\n   */\r\n  getAnimationClip(name: string) {\r\n    return this._animations[name] ?? null;\r\n  }\r\n  /**\r\n   * Set the runtime blend weight for a currently playing animation.\r\n   *\r\n   * Has no effect if the clip is not active.\r\n   *\r\n   * @param name - Name of the playing animation.\r\n   * @param weight - New weight value used during blending.\r\n   */\r\n  setAnimationWeight(name: string, weight: number) {\r\n    const ani = this._animations[name];\r\n    if (!ani) {\r\n      console.error(`Animation ${name} not exists`);\r\n      return;\r\n    }\r\n    const info = this._activeAnimations.get(ani);\r\n    if (info) {\r\n      info.weight = weight;\r\n    }\r\n  }\r\n  /**\r\n   * Start (or update) playback of an animation clip.\r\n   *\r\n   * Behavior:\r\n   * - If the clip is already playing, updates its fade-in (resets fade-out).\r\n   * - Otherwise initializes playback state (repeat counter, speed, weight, initial time).\r\n   * - Registers clip tracks and skeletons into the active sets for blending and application.\r\n   *\r\n   * @param name - Name of the animation to play.\r\n   * @param options - Playback options (repeat, speedRatio, fadeIn).\r\n   */\r\n  playAnimation(name: string, options?: PlayAnimationOptions) {\r\n    const ani = this._animations[name];\r\n    if (!ani) {\r\n      console.error(`Animation ${name} not exists`);\r\n      return;\r\n    }\r\n    const fadeIn = Math.max(options?.fadeIn ?? 0, 0);\r\n    const info = this._activeAnimations.get(ani);\r\n    if (info) {\r\n      info.fadeOut = 0;\r\n      info.fadeIn = fadeIn;\r\n    } else {\r\n      const repeat = options?.repeat ?? 0;\r\n      const speedRatio = options?.speedRatio ?? 1;\r\n      const weight = options?.weight ?? ani.weight ?? 1;\r\n      this._activeAnimations.set(ani, {\r\n        repeat,\r\n        weight,\r\n        speedRatio,\r\n        fadeIn,\r\n        fadeOut: 0,\r\n        repeatCounter: 0,\r\n        currentTime: speedRatio < 0 ? ani.timeDuration : 0,\r\n        animateTime: 0,\r\n        fadeOutStart: 0,\r\n        firstFrame: true\r\n      });\r\n      ani.tracks?.forEach((v, k) => {\r\n        let nodeTracks = this._activeTracks.get(k);\r\n        if (!nodeTracks) {\r\n          nodeTracks = new Map();\r\n          this._activeTracks.set(k, nodeTracks);\r\n        }\r\n        for (const track of v) {\r\n          const blendId = track.getBlendId();\r\n          let blendedTracks = nodeTracks.get(blendId);\r\n          if (!blendedTracks) {\r\n            blendedTracks = [];\r\n            nodeTracks.set(blendId, blendedTracks);\r\n          }\r\n          blendedTracks.push(track);\r\n        }\r\n      });\r\n      ani.skeletons?.forEach((v, k) => {\r\n        const skeleton = this.model.findSkeletonById(k);\r\n        if (skeleton) {\r\n          const refcount = this._activeSkeletons.get(skeleton);\r\n          if (refcount) {\r\n            this._activeSkeletons.set(skeleton, refcount + 1);\r\n          } else {\r\n            this._activeSkeletons.set(skeleton, 1);\r\n          }\r\n          skeleton.playing = true;\r\n        }\r\n      });\r\n    }\r\n  }\r\n  /**\r\n   * Stop playback of an animation clip.\r\n   *\r\n   * Behavior:\r\n   * - If `options.fadeOut > 0`, marks the clip for fade-out; actual removal occurs after fade completes.\r\n   * - If `fadeOut` is 0 or omitted, immediately:\r\n   *   - Removes the clip from active animations.\r\n   *   - Unregisters its tracks from active track maps.\r\n   *   - Decrements skeleton reference counts; resets and removes skeletons when refcount reaches 0.\r\n   *\r\n   * @param name - Name of the animation to stop.\r\n   * @param options - Optional fade-out configuration.\r\n   */\r\n  stopAnimation(name: string, options?: StopAnimationOptions) {\r\n    const ani = this._animations[name];\r\n    if (!ani) {\r\n      console.error(`Animation ${name} not exists`);\r\n      return;\r\n    }\r\n    const info = this._activeAnimations.get(ani);\r\n    if (info) {\r\n      const fadeOut = Math.max(options?.fadeOut ?? 0, 0);\r\n      if (fadeOut !== 0) {\r\n        info.fadeOut = fadeOut;\r\n        info.fadeOutStart = -1;\r\n      } else {\r\n        this._activeAnimations.delete(ani);\r\n        this._activeTracks.forEach((v) => {\r\n          v.forEach((tracks, id) => {\r\n            v.set(\r\n              id,\r\n              tracks.filter((track) => track.animation !== ani)\r\n            );\r\n          });\r\n        });\r\n        ani.skeletons?.forEach((v, k) => {\r\n          const skeleton = this.model.findSkeletonById(k);\r\n          if (skeleton) {\r\n            const refcount = this._activeSkeletons.get(skeleton)!;\r\n            if (refcount === 1) {\r\n              skeleton.reset();\r\n              this._activeSkeletons.delete(skeleton);\r\n            } else {\r\n              this._activeSkeletons.set(skeleton, refcount - 1);\r\n            }\r\n          }\r\n        });\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Dispose the animation set and release owned resources.\r\n   *\r\n   * - Disposes the weak reference to the model.\r\n   * - Disposes all registered animation clips.\r\n   * - Clears active animations, tracks, and skeleton references.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    for (const k in this._animations) {\r\n      this._animations[k]!.dispose();\r\n    }\r\n    this._animations = {};\r\n    this._activeAnimations.clear();\r\n    this._activeSkeletons.clear();\r\n    this._activeTracks.clear();\r\n  }\r\n}\r\n"],"names":["AnimationSet","Disposable","model","_model","_animations","_activeTracks","Map","_activeSkeletons","_activeAnimations","_skeletons","numAnimations","Object","getOwnPropertyNames","length","skeletons","get","name","createAnimation","embedded","console","error","animation","AnimationClip","scene","queueUpdateNode","deleteAnimation","stopAnimation","dispose","getAnimationNames","keys","update","deltaInSeconds","forEach","v","k","fadeOut","fadeOutStart","animateTime","firstFrame","timeAdvance","speedRatio","currentTime","timeDuration","repeatCounter","repeat","alltracks","tracks","filter","track","isPlayingAnimation","weights","map","info","weight","fadeIn","Math","min","states","t","getDuration","calculateState","state","weightedAverage","a","b","mixState","applyState","apply","has","size","getAnimationClip","setAnimationWeight","ani","playAnimation","options","max","set","nodeTracks","blendId","getBlendId","blendedTracks","push","skeleton","findSkeletonById","refcount","playing","delete","id","reset","onDispose","clear"],"mappings":"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"}
+{"version":3,"file":"animationset.js","sources":["../../src/animation/animationset.ts"],"sourcesContent":["import { weightedAverage, Disposable } from '@zephyr3d/base';\r\nimport type { DRef, IDisposable } from '@zephyr3d/base';\r\nimport type { SceneNode } from '../scene';\r\nimport { AnimationClip } from './animation';\r\nimport type { AnimationTrack } from './animationtrack';\r\nimport type { Skeleton } from './skeleton';\r\n\r\n/**\r\n * Options for playing an animation.\r\n *\r\n * Controls looping, playback speed (including reverse), and fade-in blending.\r\n * @public\r\n **/\r\nexport type PlayAnimationOptions = {\r\n  /**\r\n   * Number of loops to play.\r\n   *\r\n   * - 0: infinite looping (default).\r\n   * - n \\> 0: play exactly n loops (each loop is one full duration of the clip).\r\n   */\r\n  repeat?: number;\r\n  /**\r\n   * Playback speed multiplier.\r\n   *\r\n   * - 1: normal speed (default).\r\n   * - \\>1: faster; \\<1: slower.\r\n   * - Negative values play the clip in reverse. The initial `currentTime` will be set to the end.\r\n   */\r\n  speedRatio?: number;\r\n  /**\r\n   * Fade-in duration in seconds.\r\n   *\r\n   * Interpolates the animation weight from 0 to the clip's configured weight over this time.\r\n   * Use together with `stopAnimation(..., { fadeOut })` for smooth cross-fading.\r\n   * Default is 0 (no fade-in).\r\n   */\r\n  fadeIn?: number;\r\n  /**\r\n   * Weight of the animation clip.\r\n   *\r\n   * Used during blending when multiple animations affect the same property.\r\n   * Default is the clip's configured weight.\r\n   */\r\n  weight?: number;\r\n};\r\n\r\n/**\r\n * Options for stopping an animation.\r\n *\r\n * Allows a graceful fade-out instead of abrupt stop.\r\n * @public\r\n */\r\nexport type StopAnimationOptions = {\r\n  /**\r\n   * Fade-out duration in seconds.\r\n   *\r\n   * Interpolates the current animation weight down to 0 over this time.\r\n   * Default is 0 (immediate stop).\r\n   */\r\n  fadeOut?: number;\r\n};\r\n\r\n/**\r\n * Animation set\r\n *\r\n * Manages a collection of named animation clips for a model and orchestrates:\r\n * - Playback state (time, loops, speed, weights, fade-in/out).\r\n * - Blending across multiple tracks targeting the same property via weighted averages.\r\n * - Skeleton usage and application for clips that drive skeletal animation.\r\n * - Active track registration and cleanup as clips start/stop.\r\n *\r\n * Usage:\r\n * - Create or retrieve `AnimationClip`s by name.\r\n * - Start playback with `playAnimation(name, options)`.\r\n * - Advance animation with `update(deltaSeconds)`.\r\n * - Optionally adjust weight while playing with `setAnimationWeight(name, weight)`.\r\n *\r\n * Lifetime:\r\n * - Disposing the set releases references to the model, clips, and clears active state.\r\n *\r\n * @public\r\n */\r\nexport class AnimationSet extends Disposable implements IDisposable {\r\n  /** @internal */\r\n  private _model: SceneNode;\r\n  /** @internal */\r\n  private _animations: Partial<Record<string, AnimationClip>>;\r\n  /** @internal */\r\n  private _skeletons: DRef<Skeleton>[];\r\n  /** @internal */\r\n  private readonly _activeTracks: Map<object, Map<unknown, AnimationTrack[]>>;\r\n  /** @internal */\r\n  private readonly _activeSkeletons: Map<Skeleton, number>;\r\n  /** @internal */\r\n  private readonly _activeAnimations: Map<\r\n    AnimationClip,\r\n    {\r\n      currentTime: number;\r\n      repeat: number;\r\n      repeatCounter: number;\r\n      weight: number;\r\n      speedRatio: number;\r\n      firstFrame: boolean;\r\n      fadeIn: number;\r\n      fadeOut: number;\r\n      fadeOutStart: number;\r\n      animateTime: number;\r\n    }\r\n  >;\r\n  /**\r\n   * Create an AnimationSet controlling the provided model.\r\n   *\r\n   * @param model - The SceneNode (model root) controlled by this animation set.\r\n   */\r\n  constructor(model: SceneNode) {\r\n    super();\r\n    this._model = model;\r\n    this._animations = {};\r\n    this._activeTracks = new Map();\r\n    this._activeSkeletons = new Map();\r\n    this._activeAnimations = new Map();\r\n    this._skeletons = [];\r\n  }\r\n  /**\r\n   * The model (SceneNode) controlled by this animation set.\r\n   */\r\n  get model() {\r\n    return this._model;\r\n  }\r\n  /**\r\n   * Number of animation clips registered in this set.\r\n   */\r\n  get numAnimations() {\r\n    return Object.getOwnPropertyNames(this._animations).length;\r\n  }\r\n  /**\r\n   * The skeletons used by animations in this set.\r\n   */\r\n  get skeletons() {\r\n    return this._skeletons;\r\n  }\r\n  /**\r\n   * Retrieve an animation clip by name.\r\n   *\r\n   * @param name - Name of the animation.\r\n   * @returns The clip if present; otherwise null.\r\n   */\r\n  get(name: string) {\r\n    return this._animations[name] ?? null;\r\n  }\r\n  /**\r\n   * Create and register a new animation clip.\r\n   *\r\n   * @param name - Unique name for the animation clip.\r\n   * @param embedded - Whether the clip is embedded/owned (implementation-specific). Default false.\r\n   * @returns The created clip, or null if the name is empty or not unique.\r\n   */\r\n  createAnimation(name: string, embedded = false) {\r\n    if (!name || this._animations[name]) {\r\n      console.error('Animation must have unique name');\r\n      return null;\r\n    } else {\r\n      const animation = new AnimationClip(name, this, embedded);\r\n      this._animations[name] = animation;\r\n      this._model.scene?.queueUpdateNode(this._model);\r\n      return animation;\r\n    }\r\n  }\r\n  /**\r\n   * Delete and dispose an animation clip by name.\r\n   *\r\n   * - If the animation is currently playing, it is first stopped (immediately).\r\n   *\r\n   * @param name - Name of the animation to remove.\r\n   */\r\n  deleteAnimation(name: string) {\r\n    const animation = this._animations[name];\r\n    if (animation) {\r\n      this.stopAnimation(name);\r\n      delete this._animations[name];\r\n      animation.dispose();\r\n    }\r\n  }\r\n  /**\r\n   * Get the list of all registered animation names.\r\n   *\r\n   * @returns An array of clip names.\r\n   */\r\n  getAnimationNames() {\r\n    return Object.keys(this._animations);\r\n  }\r\n  /**\r\n   * Advance and apply active animations.\r\n   *\r\n   * Responsibilities per call:\r\n   * - Update time cursor for each active clip (respecting speedRatio and looping).\r\n   * - Enforce repeat limits and apply fade-out termination if configured.\r\n   * - For each animated target, blend active tracks (weighted by clip weight × fade-in × fade-out)\r\n   *   and apply the resulting state to the target.\r\n   * - Apply all active skeletons to update skinning transforms.\r\n   *\r\n   * @param deltaInSeconds - Time step in seconds since last update.\r\n   */\r\n  update(deltaInSeconds: number) {\r\n    this._activeAnimations.forEach((v, k) => {\r\n      if (v.fadeOut > 0 && v.fadeOutStart < 0) {\r\n        v.fadeOutStart = v.animateTime;\r\n      }\r\n      // Update animation time\r\n      if (v.firstFrame) {\r\n        v.firstFrame = false;\r\n      } else {\r\n        const timeAdvance = deltaInSeconds * v.speedRatio;\r\n        v.currentTime += timeAdvance;\r\n        v.animateTime += timeAdvance;\r\n        if (v.currentTime > k.timeDuration) {\r\n          v.repeatCounter++;\r\n          v.currentTime = 0;\r\n        } else if (v.currentTime < 0) {\r\n          v.repeatCounter++;\r\n          v.currentTime = k.timeDuration;\r\n        }\r\n        if (v.repeat !== 0 && v.repeatCounter >= v.repeat) {\r\n          this.stopAnimation(k.name);\r\n        } else if (v.fadeOut > 0) {\r\n          if (v.animateTime - v.fadeOutStart >= v.fadeOut) {\r\n            this.stopAnimation(k.name);\r\n          }\r\n        }\r\n      }\r\n    });\r\n    // Update tracks\r\n    this._activeTracks.forEach((v, k) => {\r\n      v.forEach((alltracks) => {\r\n        // Only deal with tracks which have not been removed\r\n        const tracks = alltracks.filter(\r\n          (track) => track.animation && this.isPlayingAnimation(track.animation.name)\r\n        );\r\n        if (tracks.length > 0) {\r\n          const weights = tracks.map((track) => {\r\n            const info = this._activeAnimations.get(track.animation!)!;\r\n            const weight = info.weight;\r\n            const fadeIn = info.fadeIn === 0 ? 1 : Math.min(1, info.animateTime / info.fadeIn);\r\n            let fadeOut = 1;\r\n            if (info.fadeOut !== 0) {\r\n              fadeOut = 1 - (info.animateTime - info.fadeOutStart) / info.fadeOut;\r\n            }\r\n            return weight * fadeIn * fadeOut;\r\n          });\r\n          const states = tracks.map((track) => {\r\n            const info = this._activeAnimations.get(track.animation!)!;\r\n            const t = (info.currentTime / track.animation!.timeDuration) * track.getDuration();\r\n            return track.calculateState(k, t);\r\n          });\r\n          const state = weightedAverage(weights, states, (a, b, t) => {\r\n            return tracks[0].mixState(a, b, t);\r\n          });\r\n          tracks[0].applyState(k, state);\r\n        }\r\n      });\r\n    });\r\n    // Update skeletons\r\n    this._skeletons.forEach((v) => {\r\n      v.get()?.apply(deltaInSeconds);\r\n    });\r\n  }\r\n  /**\r\n   * Check whether an animation is currently playing.\r\n   *\r\n   * @param name - Optional animation name. If omitted, returns true if any animation is playing.\r\n   * @returns True if playing; otherwise false.\r\n   */\r\n  isPlayingAnimation(name?: string) {\r\n    if (name) {\r\n      const animation = this._animations[name];\r\n      return !!animation && this._activeAnimations.has(animation);\r\n    }\r\n    return this._activeAnimations.size > 0;\r\n  }\r\n  /**\r\n   * Get an animation clip by name.\r\n   *\r\n   * Alias of `get(name)` returning a nullable type.\r\n   *\r\n   * @param name - Name of the animation.\r\n   * @returns The clip if present; otherwise null.\r\n   */\r\n  getAnimationClip(name: string) {\r\n    return this._animations[name] ?? null;\r\n  }\r\n  /**\r\n   * Set the runtime blend weight for a currently playing animation.\r\n   *\r\n   * Has no effect if the clip is not active.\r\n   *\r\n   * @param name - Name of the playing animation.\r\n   * @param weight - New weight value used during blending.\r\n   */\r\n  setAnimationWeight(name: string, weight: number) {\r\n    const ani = this._animations[name];\r\n    if (!ani) {\r\n      console.error(`Animation ${name} not exists`);\r\n      return;\r\n    }\r\n    const info = this._activeAnimations.get(ani);\r\n    if (info) {\r\n      info.weight = weight;\r\n    }\r\n  }\r\n  /**\r\n   * Start (or update) playback of an animation clip.\r\n   *\r\n   * Behavior:\r\n   * - If the clip is already playing, updates its fade-in (resets fade-out).\r\n   * - Otherwise initializes playback state (repeat counter, speed, weight, initial time).\r\n   * - Registers clip tracks and skeletons into the active sets for blending and application.\r\n   *\r\n   * @param name - Name of the animation to play.\r\n   * @param options - Playback options (repeat, speedRatio, fadeIn).\r\n   */\r\n  playAnimation(name: string, options?: PlayAnimationOptions) {\r\n    const ani = this._animations[name];\r\n    if (!ani) {\r\n      console.error(`Animation ${name} not exists`);\r\n      return;\r\n    }\r\n    const fadeIn = Math.max(options?.fadeIn ?? 0, 0);\r\n    const info = this._activeAnimations.get(ani);\r\n    if (info) {\r\n      info.fadeOut = 0;\r\n      info.fadeIn = fadeIn;\r\n    } else {\r\n      const repeat = options?.repeat ?? 0;\r\n      const speedRatio = options?.speedRatio ?? 1;\r\n      const weight = options?.weight ?? ani.weight ?? 1;\r\n      this._activeAnimations.set(ani, {\r\n        repeat,\r\n        weight,\r\n        speedRatio,\r\n        fadeIn,\r\n        fadeOut: 0,\r\n        repeatCounter: 0,\r\n        currentTime: speedRatio < 0 ? ani.timeDuration : 0,\r\n        animateTime: 0,\r\n        fadeOutStart: 0,\r\n        firstFrame: true\r\n      });\r\n      ani.tracks?.forEach((v, k) => {\r\n        let nodeTracks = this._activeTracks.get(k);\r\n        if (!nodeTracks) {\r\n          nodeTracks = new Map();\r\n          this._activeTracks.set(k, nodeTracks);\r\n        }\r\n        for (const track of v) {\r\n          const blendId = track.getBlendId();\r\n          let blendedTracks = nodeTracks.get(blendId);\r\n          if (!blendedTracks) {\r\n            blendedTracks = [];\r\n            nodeTracks.set(blendId, blendedTracks);\r\n          }\r\n          blendedTracks.push(track);\r\n        }\r\n      });\r\n      ani.skeletons?.forEach((v, k) => {\r\n        const skeleton = this.model.findSkeletonById(k);\r\n        if (skeleton) {\r\n          const refcount = this._activeSkeletons.get(skeleton);\r\n          if (refcount) {\r\n            this._activeSkeletons.set(skeleton, refcount + 1);\r\n          } else {\r\n            this._activeSkeletons.set(skeleton, 1);\r\n          }\r\n          skeleton.playing = true;\r\n        }\r\n      });\r\n    }\r\n  }\r\n  /**\r\n   * Stop playback of an animation clip.\r\n   *\r\n   * Behavior:\r\n   * - If `options.fadeOut > 0`, marks the clip for fade-out; actual removal occurs after fade completes.\r\n   * - If `fadeOut` is 0 or omitted, immediately:\r\n   *   - Removes the clip from active animations.\r\n   *   - Unregisters its tracks from active track maps.\r\n   *   - Decrements skeleton reference counts; resets and removes skeletons when refcount reaches 0.\r\n   *\r\n   * @param name - Name of the animation to stop.\r\n   * @param options - Optional fade-out configuration.\r\n   */\r\n  stopAnimation(name: string, options?: StopAnimationOptions) {\r\n    const ani = this._animations[name];\r\n    if (!ani) {\r\n      console.error(`Animation ${name} not exists`);\r\n      return;\r\n    }\r\n    const info = this._activeAnimations.get(ani);\r\n    if (info) {\r\n      const fadeOut = Math.max(options?.fadeOut ?? 0, 0);\r\n      if (fadeOut !== 0) {\r\n        info.fadeOut = fadeOut;\r\n        info.fadeOutStart = -1;\r\n      } else {\r\n        this._activeAnimations.delete(ani);\r\n        this._activeTracks.forEach((v) => {\r\n          v.forEach((tracks, id) => {\r\n            v.set(\r\n              id,\r\n              tracks.filter((track) => track.animation !== ani)\r\n            );\r\n          });\r\n        });\r\n        ani.skeletons?.forEach((v, k) => {\r\n          const skeleton = this.model.findSkeletonById(k);\r\n          if (skeleton) {\r\n            const refcount = this._activeSkeletons.get(skeleton)!;\r\n            if (refcount === 1) {\r\n              skeleton.reset();\r\n              this._activeSkeletons.delete(skeleton);\r\n            } else {\r\n              this._activeSkeletons.set(skeleton, refcount - 1);\r\n            }\r\n          }\r\n        });\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Dispose the animation set and release owned resources.\r\n   *\r\n   * - Disposes the weak reference to the model.\r\n   * - Disposes all registered animation clips.\r\n   * - Clears active animations, tracks, and skeleton references.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    for (const k in this._animations) {\r\n      this._animations[k]!.dispose();\r\n    }\r\n    this._animations = {};\r\n    this._activeAnimations.clear();\r\n    this._activeSkeletons.clear();\r\n    this._activeTracks.clear();\r\n  }\r\n}\r\n"],"names":["AnimationSet","Disposable","model","_model","_animations","_activeTracks","Map","_activeSkeletons","_activeAnimations","_skeletons","numAnimations","Object","getOwnPropertyNames","length","skeletons","get","name","createAnimation","embedded","console","error","animation","AnimationClip","scene","queueUpdateNode","deleteAnimation","stopAnimation","dispose","getAnimationNames","keys","update","deltaInSeconds","forEach","v","k","fadeOut","fadeOutStart","animateTime","firstFrame","timeAdvance","speedRatio","currentTime","timeDuration","repeatCounter","repeat","alltracks","tracks","filter","track","isPlayingAnimation","weights","map","info","weight","fadeIn","Math","min","states","t","getDuration","calculateState","state","weightedAverage","a","b","mixState","applyState","apply","has","size","getAnimationClip","setAnimationWeight","ani","playAnimation","options","max","set","nodeTracks","blendId","getBlendId","blendedTracks","push","skeleton","findSkeletonById","refcount","playing","delete","id","reset","onDispose","clear"],"mappings":"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"}

package/dist/animation/ik/ccd_solver.js

@@ -0,0 +1,372 @@
+import { Vector3, Quaternion } from '@zephyr3d/base';
+import { IKSolver } from './ik_solver.js';
+import { IKUtils } from './ik_utils.js';
+
+/**
+ * CCD (Cyclic Coordinate Descent) IK solver.
+ *
+ * @remarks
+ * CCD is an iterative IK algorithm that works by:
+ * 1. Starting from the joint closest to the end effector
+ * 2. Rotating each joint to point the end effector toward the target
+ * 3. Moving backward through the chain to the root
+ * 4. Repeating until convergence or max iterations
+ *
+ * CCD is generally faster than FABRIK and works well for chains of any length.
+ * It's particularly good for tentacles, tails, and other flexible chains.
+ *
+ * Supports multiple pole vectors to control the bending direction of different joints.
+ *
+ * @public
+ */ class CCDSolver extends IKSolver {
+    /** Map of joint index to pole vector configuration */ _poleVectors;
+    /** Twist constraints for each joint (indexed by joint index) */ _twistConstraints;
+    /**
+   * Create a CCD solver.
+   *
+   * @param chain - The IK chain to solve
+   * @param maxIterations - Maximum number of iterations (default: 10)
+   * @param tolerance - Convergence tolerance in world units (default: 0.001)
+   */ constructor(chain, maxIterations = 10, tolerance = 0.001){
+        super(chain, maxIterations, tolerance);
+        this._poleVectors = new Map();
+        this._twistConstraints = new Map();
+        // Set default twist constraints for all joints
+        for(let i = 0; i < chain.joints.length - 1; i++){
+            // Middle joints have more restrictive twist limits
+            const isMiddleJoint = i > 0 && i < chain.joints.length - 2;
+            this._twistConstraints.set(i, {
+                minTwist: isMiddleJoint ? -Math.PI * 0.2 : -Math.PI * 0.3,
+                maxTwist: isMiddleJoint ? Math.PI * 0.2 : Math.PI * 0.3,
+                smoothFactor: 0.3
+            });
+        }
+    }
+    /**
+   * Set twist constraint for a specific joint.
+   *
+   * @param jointIndex - Index of the joint
+   * @param minTwist - Minimum twist angle in radians
+   * @param maxTwist - Maximum twist angle in radians
+   * @param smoothFactor - Smoothing factor [0-1] (default: 0.3)
+   */ setTwistConstraint(jointIndex, minTwist, maxTwist, smoothFactor = 0.3) {
+        if (jointIndex < 0 || jointIndex >= this._chain.joints.length - 1) {
+            throw new Error(`Invalid joint index: ${jointIndex}`);
+        }
+        this._twistConstraints.set(jointIndex, {
+            minTwist,
+            maxTwist,
+            smoothFactor: Math.max(0, Math.min(1, smoothFactor))
+        });
+    }
+    /**
+   * Get twist constraint for a specific joint.
+   *
+   * @param jointIndex - Index of the joint
+   * @returns Twist constraint or undefined if not set
+   */ getTwistConstraint(jointIndex) {
+        return this._twistConstraints.get(jointIndex);
+    }
+    /**
+   * Remove twist constraint for a specific joint.
+   *
+   * @param jointIndex - Index of the joint
+   * @returns True if a constraint was removed
+   */ removeTwistConstraint(jointIndex) {
+        return this._twistConstraints.delete(jointIndex);
+    }
+    /**
+   * Clear all twist constraints.
+   */ clearTwistConstraints() {
+        this._twistConstraints.clear();
+    }
+    /**
+   * Set pole vector for a specific joint.
+   *
+   * @param jointIndex - Index of the joint to apply pole vector to
+   * @param poleVector - Pole vector position in world space
+   * @param weight - Weight of the pole vector constraint (0-1, default: 1)
+   */ setPoleVector(jointIndex, poleVector, weight = 1) {
+        if (jointIndex < 0 || jointIndex >= this._chain.joints.length) {
+            throw new Error(`Invalid joint index: ${jointIndex}`);
+        }
+        this._poleVectors.set(jointIndex, {
+            position: poleVector.clone(),
+            weight: Math.max(0, Math.min(1, weight))
+        });
+    }
+    /**
+   * Remove pole vector for a specific joint.
+   *
+   * @param jointIndex - Index of the joint to remove pole vector from
+   * @returns True if a pole vector was removed, false if none existed
+   */ removePoleVector(jointIndex) {
+        return this._poleVectors.delete(jointIndex);
+    }
+    /**
+   * Clear all pole vectors.
+   */ clearPoleVectors() {
+        this._poleVectors.clear();
+    }
+    /**
+   * Get pole vector configuration for a specific joint.
+   *
+   * @param jointIndex - Index of the joint
+   * @returns Pole vector configuration or undefined if not set
+   */ getPoleVector(jointIndex) {
+        const config = this._poleVectors.get(jointIndex);
+        if (config) {
+            return {
+                position: config.position.clone(),
+                weight: config.weight
+            };
+        }
+        return undefined;
+    }
+    /**
+   * Check if a joint has a pole vector.
+   *
+   * @param jointIndex - Index of the joint
+   * @returns True if the joint has a pole vector
+   */ hasPoleVector(jointIndex) {
+        return this._poleVectors.has(jointIndex);
+    }
+    /**
+   * Solve the IK chain to reach the target position using CCD algorithm.
+   *
+   * @param target - Target position for the end effector
+   * @returns True if converged within tolerance, false otherwise
+   */ solve(target) {
+        const joints = this._chain.joints;
+        // Update joint positions from scene nodes before solving
+        this._chain.updateFromNodes();
+        // Store original positions
+        this._chain.storeOriginalPositions();
+        let converged = false;
+        for(let iteration = 0; iteration < this._maxIterations; iteration++){
+            // Check convergence
+            const endEffector = joints[joints.length - 1];
+            const distToTarget = Vector3.distance(endEffector.position, target);
+            if (distToTarget < this._tolerance) {
+                converged = true;
+                break;
+            }
+            // Iterate backward through joints (from second-to-last to root)
+            // We skip the end effector itself since it doesn't have a child to rotate toward
+            for(let i = joints.length - 2; i >= 0; i--){
+                const joint = joints[i];
+                // Vector from current joint to end effector
+                const toEnd = Vector3.sub(endEffector.position, joint.position, new Vector3());
+                const toEndDist = toEnd.magnitude;
+                // Vector from current joint to target
+                const toTarget = Vector3.sub(target, joint.position, new Vector3());
+                const toTargetDist = toTarget.magnitude;
+                // Skip if either vector is too small
+                if (toEndDist < 0.000001 || toTargetDist < 0.000001) {
+                    continue;
+                }
+                // Normalize vectors
+                const toEndDir = Vector3.scale(toEnd, 1 / toEndDist, new Vector3());
+                const toTargetDir = Vector3.scale(toTarget, 1 / toTargetDist, new Vector3());
+                // Calculate rotation needed to align end effector toward target
+                let rotation = new Quaternion();
+                IKUtils.fromToRotation(toEndDir, toTargetDir, rotation);
+                // Apply rotation to all joints from current to end effector
+                this._rotateJointsFromIndex(i, rotation, joint.position);
+                // Apply constraints after rotating this joint
+                this._applyConstraintsForJoint(i);
+            }
+            // Apply all pole vector constraints after each full iteration
+            // This is more stable than applying them during the CCD loop
+            this._applyAllPoleVectors();
+        }
+        return converged;
+    }
+    /**
+   * Rotate all joints from the given index to the end effector around a pivot point.
+   *
+   * @param startIndex - Index of the joint to start rotating from
+   * @param rotation - Rotation to apply
+   * @param pivot - Pivot point for rotation (position of the joint being adjusted)
+   */ _rotateJointsFromIndex(startIndex, rotation, pivot) {
+        const joints = this._chain.joints;
+        // Rotate all joints from startIndex+1 to end effector
+        for(let i = startIndex + 1; i < joints.length; i++){
+            const joint = joints[i];
+            // Translate to pivot
+            const offset = Vector3.sub(joint.position, pivot, new Vector3());
+            // Rotate around pivot
+            const rotated = rotation.transform(offset, new Vector3());
+            // Translate back
+            joint.position.set(Vector3.add(pivot, rotated, new Vector3()));
+        }
+    }
+    /**
+   * Apply all pole vector constraints.
+   *
+   * @remarks
+   * This method applies all configured pole vectors to their respective joints.
+   * Pole vectors are applied in reverse order (from end to root) to minimize
+   * interference between multiple pole vectors. This ensures that pole vectors
+   * closer to the end effector are not affected by pole vectors closer to the root.
+   */ _applyAllPoleVectors() {
+        if (this._poleVectors.size === 0) {
+            return;
+        }
+        // Apply pole vectors in reverse order (from end to root)
+        // This prevents earlier pole vectors from affecting later ones
+        const sortedIndices = Array.from(this._poleVectors.keys()).sort((a, b)=>b - a);
+        for (const jointIndex of sortedIndices){
+            const config = this._poleVectors.get(jointIndex);
+            if (config && config.weight > 0.001) {
+                this._applyPoleVectorTwist(jointIndex, config.position, config.weight);
+            }
+        }
+    }
+    /**
+   * Apply pole vector twist to a specific joint.
+   *
+   * @remarks
+   * This method is called after the base CCD rotation has been applied.
+   * It adds an additional twist rotation around the joint-to-end axis
+   * to make the next joint (child) bend toward the pole vector.
+   *
+   * @param jointIndex - Index of the pole joint
+   * @param poleVector - Pole vector position in world space
+   * @param weight - Weight of the pole vector constraint (0-1)
+   */ _applyPoleVectorTwist(jointIndex, poleVector, weight) {
+        const joints = this._chain.joints;
+        // We need at least 3 joints to apply pole vector (parent, pole joint, child)
+        if (jointIndex < 1 || jointIndex >= joints.length - 1) {
+            return;
+        }
+        const parentJoint = joints[jointIndex - 1];
+        const currentJoint = joints[jointIndex];
+        const childJoint = joints[jointIndex + 1];
+        const parentPos = parentJoint.position;
+        const currentPos = currentJoint.position;
+        const childPos = childJoint.position;
+        // Calculate the plane defined by parent, child, and pole vector
+        // Vector from parent to child (the "line" we're bending around)
+        const parentToChild = Vector3.sub(childPos, parentPos, new Vector3());
+        const lineLength = parentToChild.magnitude;
+        if (lineLength < 0.000001) {
+            return; // Parent and child are at same position
+        }
+        const lineDir = Vector3.scale(parentToChild, 1 / lineLength, new Vector3());
+        // Project current joint onto the parent-child line
+        const parentToCurrent = Vector3.sub(currentPos, parentPos, new Vector3());
+        const projectionLength = Vector3.dot(parentToCurrent, lineDir);
+        const projectionPoint = Vector3.scale(lineDir, projectionLength, new Vector3());
+        Vector3.add(parentPos, projectionPoint, projectionPoint);
+        // Vector from projection point to current joint (perpendicular to line)
+        const perpendicular = Vector3.sub(currentPos, projectionPoint, new Vector3());
+        const perpLength = perpendicular.magnitude;
+        if (perpLength < 0.000001) {
+            return; // Current joint is on the line
+        }
+        // Calculate desired direction toward pole vector
+        const parentToPole = Vector3.sub(poleVector, parentPos, new Vector3());
+        const poleProjectionLength = Vector3.dot(parentToPole, lineDir);
+        const poleProjectionPoint = Vector3.scale(lineDir, poleProjectionLength, new Vector3());
+        Vector3.add(parentPos, poleProjectionPoint, poleProjectionPoint);
+        // Direction from projection to pole (perpendicular to line)
+        const poleDirection = Vector3.sub(poleVector, poleProjectionPoint, new Vector3());
+        const poleDirLength = poleDirection.magnitude;
+        if (poleDirLength < 0.000001) {
+            return; // Pole is on the line
+        }
+        poleDirection.scaleBy(1 / poleDirLength);
+        // Calculate new position for current joint
+        // Keep the same distance from the line, but rotate toward pole direction
+        const desiredPerpendicular = Vector3.scale(poleDirection, perpLength, new Vector3());
+        const newPosition = Vector3.add(projectionPoint, desiredPerpendicular, new Vector3());
+        // Apply weight (blend between original and constrained position)
+        if (weight < 0.999) {
+            const blended = new Vector3();
+            blended.x = currentPos.x + (newPosition.x - currentPos.x) * weight;
+            blended.y = currentPos.y + (newPosition.y - currentPos.y) * weight;
+            blended.z = currentPos.z + (newPosition.z - currentPos.z) * weight;
+            currentJoint.position.set(blended);
+        } else {
+            currentJoint.position.set(newPosition);
+        }
+    }
+    /**
+   * Apply constraints for a specific joint.
+   *
+   * @param jointIndex - Index of the joint to apply constraints to
+   */ _applyConstraintsForJoint(jointIndex) {
+        const constraints = this._chain.constraints;
+        for (const constraint of constraints){
+            if (constraint.jointIndex === jointIndex) {
+                constraint.apply(this._chain.joints);
+            }
+        }
+    }
+    /**
+   * Apply the solved joint positions to scene nodes as rotations.
+   *
+   * @param weight - Blend weight (0 = original, 1 = full IK, default: 1)
+   */ applyToNodes(weight = 1) {
+        const joints = this._chain.joints;
+        // Apply rotation for all joints except the end effector
+        for(let i = 0; i < joints.length - 1; i++){
+            const joint = joints[i];
+            const nextJoint = joints[i + 1];
+            // Calculate direction from current joint to next joint in world space
+            const originalDir = Vector3.sub(nextJoint.originalPosition, joint.originalPosition, new Vector3());
+            const newDir = Vector3.sub(nextJoint.position, joint.position, new Vector3());
+            const originalDirNorm = Vector3.normalize(originalDir, new Vector3());
+            const newDirNorm = Vector3.normalize(newDir, new Vector3());
+            // Calculate basic rotation
+            const deltaRotation = new Quaternion();
+            IKUtils.fromToRotation(originalDirNorm, newDirNorm, deltaRotation);
+            // Calculate new world rotation
+            let worldRotation = Quaternion.multiply(deltaRotation, joint.originalRotation, new Quaternion());
+            // Apply swing-twist constraint to prevent over-rotation
+            const swing = new Quaternion();
+            const twist = new Quaternion();
+            IKUtils.decomposeSwingTwist(worldRotation, newDirNorm, swing, twist);
+            // Get twist angle
+            let twistAngle = IKUtils.getTwistAngle(twist, newDirNorm);
+            // Get twist constraint for this joint
+            const constraint = this._twistConstraints.get(i);
+            if (constraint) {
+                // Clamp and smooth twist
+                twistAngle = IKUtils.clampAndSmoothTwist(twistAngle, joint.previousTwist, constraint.minTwist, constraint.maxTwist, constraint.smoothFactor);
+            }
+            // Store for next frame
+            joint.previousTwist = twistAngle;
+            // Reconstruct rotation from clamped twist: Q = Twist * Swing
+            const clampedTwist = new Quaternion();
+            IKUtils.createTwist(twistAngle, newDirNorm, clampedTwist);
+            worldRotation = Quaternion.multiply(clampedTwist, swing, worldRotation);
+            // Blend with original rotation based on weight
+            if (weight < 1) {
+                Quaternion.slerp(joint.originalRotation, worldRotation, weight, worldRotation);
+            }
+            // Store this frame's world rotation for next frame's twist continuity
+            if (!joint.previousIKRotation) {
+                joint.previousIKRotation = worldRotation.clone();
+            } else {
+                joint.previousIKRotation.set(worldRotation);
+            }
+            // Convert world rotation to local rotation (relative to parent)
+            if (joint.node.parent) {
+                const parentWorldRotation = new Quaternion();
+                joint.node.parent.worldMatrix.decompose(null, parentWorldRotation, null);
+                // localRotation = conjugate(parentWorldRotation) * worldRotation
+                const parentInvRotation = Quaternion.conjugate(parentWorldRotation, new Quaternion());
+                const localRotation = Quaternion.multiply(parentInvRotation, worldRotation, new Quaternion());
+                joint.node.rotation = localRotation;
+            } else {
+                // Root node has no parent, world rotation is local rotation
+                joint.node.rotation = worldRotation;
+            }
+        }
+    }
+}
+
+export { CCDSolver };
+//# sourceMappingURL=ccd_solver.js.map