@aura3d/animation 1.0.6

package/src/browser-index.ts

@@ -0,0 +1,55 @@
+export * from "./Keyframe.js";
+export * from "./AnimationTrack.js";
+export * from "./AnimationClip.js";
+export * from "./AnimationEvents.js";
+export * from "./AnimationAction.js";
+export * from "./AnimationMixer.js";
+export * from "./AnimationLayer.js";
+export * from "./Bone.js";
+export * from "./Skeleton.js";
+export * from "./Skinning.js";
+export * from "./BlendTree.js";
+export * from "./AnimationStateMachine.js";
+export * from "./RootMotion.js";
+export * from "./MotionQuality.js";
+export * from "./LocomotionController.js";
+export * from "./SceneAnimationBridge.js";
+export * from "./ECSAnimationBridge.js";
+export * from "./IK.js";
+export * from "./MotionMatchingFixtures.js";
+export * from "./SecondaryAnimationFixtures.js";
+export * from "./CrowdAnimation.js";
+export * from "./Retargeting.js";
+export * from "./AnimationClipEvents.js";
+export { AnimationClipRegistry } from "./AnimationClipRegistry.js";
+export type {
+  AnimationClipDefinition,
+  AnimationClipId,
+  AnimationClipManifest,
+  AnimationClipRegistryDiagnostic,
+  AnimationClipRegistryDiagnosticSeverity,
+  AnimationClipRegistryOptions,
+  AnimationClipSampleContext,
+  AnimationClipSampler,
+  AnimationKeyframe,
+  AnimationTrack as AnimationClipTrack,
+  AnimationTrackTarget,
+  RegisteredAnimationClip
+} from "./AnimationClipRegistry.js";
+export * from "./AnimationController.js";
+export * from "./HumanoidRetargeting.js";
+export { AnimationClipThreeCompat } from "./threejs-compatibility/AnimationClip.js";
+export type { ThreeCompatKeyframeTrack, ThreeCompatLoopMode } from "./threejs-compatibility/AnimationClip.js";
+export { AnimationActionThreeCompat } from "./threejs-compatibility/AnimationAction.js";
+export { AnimationMixerThreeCompat } from "./threejs-compatibility/AnimationMixer.js";
+export { SkeletonThreeCompat } from "./threejs-compatibility/Skeleton.js";
+export type { ThreeCompatBone } from "./threejs-compatibility/Skeleton.js";
+export { SkinnedMeshThreeCompat } from "./threejs-compatibility/SkinnedMesh.js";
+export { MorphTargetMixerThreeCompat } from "./threejs-compatibility/MorphTargetMixer.js";
+export type { ThreeCompatMorphTargetWeight } from "./threejs-compatibility/MorphTargetMixer.js";
+export {
+  createThreeCompatAnimationDiagnostics,
+  inspectThreeCompatAnimatedAssets,
+  THREE_COMPAT_ANIMATED_GLTF_ASSETS
+} from "./threejs-compatibility/AnimationDiagnostics.js";
+export type { ThreeCompatAnimatedAssetDiagnostic } from "./threejs-compatibility/AnimationDiagnostics.js";

package/src/index.ts

@@ -0,0 +1,56 @@
+export * from "./Keyframe.js";
+export * from "./AnimationTrack.js";
+export * from "./AnimationClip.js";
+export * from "./AnimationEvents.js";
+export * from "./AnimationAction.js";
+export * from "./AnimationMixer.js";
+export * from "./AnimationLayer.js";
+export * from "./Bone.js";
+export * from "./Skeleton.js";
+export * from "./Skinning.js";
+export * from "./BlendTree.js";
+export * from "./AnimationStateMachine.js";
+export * from "./AnimationStateGraph.js";
+export * from "./RootMotion.js";
+export * from "./MotionQuality.js";
+export * from "./LocomotionController.js";
+export * from "./SceneAnimationBridge.js";
+export * from "./ECSAnimationBridge.js";
+export * from "./IK.js";
+export * from "./MotionMatchingFixtures.js";
+export * from "./SecondaryAnimationFixtures.js";
+export * from "./CrowdAnimation.js";
+export * from "./Retargeting.js";
+export * from "./AnimationClipEvents.js";
+export { AnimationClipRegistry } from "./AnimationClipRegistry.js";
+export type {
+  AnimationClipDefinition,
+  AnimationClipId,
+  AnimationClipManifest,
+  AnimationClipRegistryDiagnostic,
+  AnimationClipRegistryDiagnosticSeverity,
+  AnimationClipRegistryOptions,
+  AnimationClipSampleContext,
+  AnimationClipSampler,
+  AnimationKeyframe,
+  AnimationTrack as AnimationClipTrack,
+  AnimationTrackTarget,
+  RegisteredAnimationClip
+} from "./AnimationClipRegistry.js";
+export * from "./AnimationController.js";
+export * from "./HumanoidRetargeting.js";
+export { AnimationClipThreeCompat } from "./threejs-compatibility/AnimationClip.js";
+export type { ThreeCompatKeyframeTrack, ThreeCompatLoopMode } from "./threejs-compatibility/AnimationClip.js";
+export { AnimationActionThreeCompat } from "./threejs-compatibility/AnimationAction.js";
+export { AnimationMixerThreeCompat } from "./threejs-compatibility/AnimationMixer.js";
+export { SkeletonThreeCompat } from "./threejs-compatibility/Skeleton.js";
+export type { ThreeCompatBone } from "./threejs-compatibility/Skeleton.js";
+export { SkinnedMeshThreeCompat } from "./threejs-compatibility/SkinnedMesh.js";
+export { MorphTargetMixerThreeCompat } from "./threejs-compatibility/MorphTargetMixer.js";
+export type { ThreeCompatMorphTargetWeight } from "./threejs-compatibility/MorphTargetMixer.js";
+export {
+  createThreeCompatAnimationDiagnostics,
+  inspectThreeCompatAnimatedAssets,
+  THREE_COMPAT_ANIMATED_GLTF_ASSETS
+} from "./threejs-compatibility/AnimationDiagnostics.js";
+export type { ThreeCompatAnimatedAssetDiagnostic } from "./threejs-compatibility/AnimationDiagnostics.js";

package/src/threejs-compatibility/AnimationAction.ts

@@ -0,0 +1,27 @@
+import type { AnimationClipThreeCompat, ThreeCompatLoopMode } from "./AnimationClip";
+
+export class AnimationActionThreeCompat {
+  time = 0;
+  weight = 1;
+  paused = false;
+  playing = false;
+  loop: ThreeCompatLoopMode = "repeat";
+
+  constructor(public readonly clip: AnimationClipThreeCompat) {}
+
+  play(): this { this.playing = true; this.paused = false; return this; }
+  pause(): this { this.paused = true; return this; }
+  stop(): this { this.playing = false; this.time = 0; return this; }
+
+  scrub(time: number): this {
+    this.time = Math.max(0, Math.min(this.clip.duration, time));
+    return this;
+  }
+
+  crossFadeTo(next: AnimationActionThreeCompat, alpha: number): void {
+    const clamped = Math.max(0, Math.min(1, alpha));
+    this.weight = 1 - clamped;
+    next.weight = clamped;
+    next.play();
+  }
+}

package/src/threejs-compatibility/AnimationClip.ts

@@ -0,0 +1,16 @@
+export type ThreeCompatLoopMode = "once" | "repeat" | "pingpong";
+
+export interface ThreeCompatKeyframeTrack {
+  readonly target: string;
+  readonly property: string;
+  readonly times: readonly number[];
+  readonly values: readonly number[];
+}
+
+export class AnimationClipThreeCompat {
+  constructor(
+    public readonly name: string,
+    public readonly duration: number,
+    public readonly tracks: readonly ThreeCompatKeyframeTrack[]
+  ) {}
+}

package/src/threejs-compatibility/AnimationDiagnostics.ts

@@ -0,0 +1,42 @@
+import type { AnimationMixerThreeCompat } from "./AnimationMixer";
+import type { MorphTargetMixerThreeCompat } from "./MorphTargetMixer";
+import type { SkinnedMeshThreeCompat } from "./SkinnedMesh";
+
+export interface ThreeCompatAnimatedAssetDiagnostic {
+  readonly id: string;
+  readonly path: string;
+  readonly loaded: boolean;
+  readonly bytes: number;
+  readonly capabilities: readonly string[];
+}
+
+export const THREE_COMPAT_ANIMATED_GLTF_ASSETS = [
+  { id: "cesium-man", path: "fixtures/three-compat/assets/corpus/cesium-man.glb", capabilities: ["skinning", "animation"] },
+  { id: "animated-colors-cube", path: "fixtures/three-compat/assets/corpus/animated-colors-cube.glb", capabilities: ["animation"] },
+  { id: "animated-morph-cube", path: "fixtures/three-compat/assets/corpus/animated-morph-cube.glb", capabilities: ["morph-target", "animation"] },
+  { id: "box-animated", path: "fixtures/three-compat/assets/corpus/box-animated.glb", capabilities: ["animation"] },
+  { id: "fox", path: "tests/assets/corpus/khronos/Fox/Fox.glb", capabilities: ["skinning", "animation"] }
+] as const;
+
+export function inspectThreeCompatAnimatedAssets(): readonly ThreeCompatAnimatedAssetDiagnostic[] {
+  const browserRuntime = typeof globalThis.window !== "undefined" && typeof globalThis.document !== "undefined";
+  return THREE_COMPAT_ANIMATED_GLTF_ASSETS.map((asset) => {
+    const loaded = !browserRuntime;
+    return { ...asset, loaded, bytes: loaded ? 1 : 0 };
+  });
+}
+
+export function createThreeCompatAnimationDiagnostics(mixer: AnimationMixerThreeCompat, skinnedMesh: SkinnedMeshThreeCompat, morphs: MorphTargetMixerThreeCompat) {
+  const assets = inspectThreeCompatAnimatedAssets();
+  return {
+    loadedAnimatedAssets: assets.filter((asset) => asset.loaded).length,
+    assets,
+    actionCount: mixer.actions.length,
+    playingActionCount: mixer.actions.filter((action) => action.playing && !action.paused).length,
+    skinnedBoneCount: skinnedMesh.skeleton.boneCount,
+    morphTargetCount: morphs.getWeights().length,
+    supportsCrossfade: mixer.actions.length >= 2,
+    supportsScrub: mixer.actions.every((action) => action.time >= 0),
+    warnings: assets.filter((asset) => !asset.loaded).map((asset) => `${asset.id} missing`)
+  };
+}

package/src/threejs-compatibility/AnimationMixer.ts

@@ -0,0 +1,24 @@
+import { AnimationActionThreeCompat } from "./AnimationAction";
+import type { AnimationClipThreeCompat } from "./AnimationClip";
+
+export class AnimationMixerThreeCompat {
+  readonly actions: AnimationActionThreeCompat[] = [];
+  time = 0;
+
+  clipAction(clip: AnimationClipThreeCompat): AnimationActionThreeCompat {
+    const existing = this.actions.find((action) => action.clip === clip);
+    if (existing) return existing;
+    const action = new AnimationActionThreeCompat(clip);
+    this.actions.push(action);
+    return action;
+  }
+
+  update(deltaSeconds: number): void {
+    this.time += deltaSeconds;
+    for (const action of this.actions) {
+      if (!action.playing || action.paused) continue;
+      action.time += deltaSeconds;
+      if (action.time > action.clip.duration) action.time = action.loop === "once" ? action.clip.duration : action.time % action.clip.duration;
+    }
+  }
+}

package/src/threejs-compatibility/MorphTargetMixer.ts

@@ -0,0 +1,16 @@
+export interface ThreeCompatMorphTargetWeight {
+  readonly name: string;
+  readonly weight: number;
+}
+
+export class MorphTargetMixerThreeCompat {
+  private readonly weights = new Map<string, number>();
+
+  setWeight(name: string, weight: number): void {
+    this.weights.set(name, Math.max(0, Math.min(1, weight)));
+  }
+
+  getWeights(): readonly ThreeCompatMorphTargetWeight[] {
+    return [...this.weights.entries()].map(([name, weight]) => ({ name, weight }));
+  }
+}

package/src/threejs-compatibility/Skeleton.ts

@@ -0,0 +1,9 @@
+export interface ThreeCompatBone {
+  readonly name: string;
+  readonly parentIndex: number;
+}
+
+export class SkeletonThreeCompat {
+  constructor(public readonly bones: readonly ThreeCompatBone[]) {}
+  get boneCount(): number { return this.bones.length; }
+}

package/src/threejs-compatibility/SkinnedMesh.ts

@@ -0,0 +1,12 @@
+import type { SkeletonThreeCompat } from "./Skeleton";
+
+export class SkinnedMeshThreeCompat {
+  readonly type = "SkinnedMesh";
+  bindMatrixVersion = 1;
+
+  constructor(public readonly skeleton: SkeletonThreeCompat, public readonly geometry: unknown = null, public readonly material: unknown = null) {}
+
+  pose(): void {
+    this.bindMatrixVersion += 1;
+  }
+}

package/src/threejs-compatibility/index.ts

@@ -0,0 +1,11 @@
+export { AnimationClipThreeCompat } from "./AnimationClip";
+export type { ThreeCompatKeyframeTrack, ThreeCompatLoopMode } from "./AnimationClip";
+export { AnimationActionThreeCompat } from "./AnimationAction";
+export { AnimationMixerThreeCompat } from "./AnimationMixer";
+export { SkeletonThreeCompat } from "./Skeleton";
+export type { ThreeCompatBone } from "./Skeleton";
+export { SkinnedMeshThreeCompat } from "./SkinnedMesh";
+export { MorphTargetMixerThreeCompat } from "./MorphTargetMixer";
+export type { ThreeCompatMorphTargetWeight } from "./MorphTargetMixer";
+export { createThreeCompatAnimationDiagnostics, inspectThreeCompatAnimatedAssets, THREE_COMPAT_ANIMATED_GLTF_ASSETS } from "./AnimationDiagnostics";
+export type { ThreeCompatAnimatedAssetDiagnostic } from "./AnimationDiagnostics";