@aura3d/animation 1.1.0 → 1.3.0

package/dist/library/standardHumanoidClips.js

@@ -0,0 +1,357 @@
+import { AnimationTrack } from "../AnimationTrack.js";
+import { AnimationClipRegistry, createAnimationClipRegistry } from "../AnimationClipRegistry.js";
+import { HUMANOID_BONES } from "../HumanoidRetargeting.js";
+/**
+ * The STANDARD performance vocabulary (Phase 2.4). These 8 ids are the contract the Animation
+ * Studio drives — every shared library, retarget target, and state graph speaks exactly these.
+ */
+export const STANDARD_CLIP_IDS = ["idle", "talk", "gesture", "point", "nod", "walk", "run", "react"];
+/** Locomotion subset of the vocabulary (used by the locomotion blend / studio clip-map check). */
+export const STANDARD_LOCOMOTION_CLIP_IDS = ["idle", "walk", "run"];
+const FRAME_RATE = 30;
+/**
+ * The rig-neutral humanoid these clips are authored against. Bone names are the canonical
+ * {@link HUMANOID_BONES} (identity bindings), so an identity retarget map is a no-op and the clips
+ * can be retargeted onto any inferred character rig via {@link createHumanoidRetargetingMap}.
+ */
+export const STANDARD_LIBRARY_RIG = {
+    id: "aura3d.standard-humanoid",
+    name: "Aura3D Standard Humanoid (shared clip library rig)",
+    units: "meters",
+    facingAxis: "z",
+    scale: 1,
+    bones: Object.fromEntries(HUMANOID_BONES.map((bone) => [bone, { name: bone }])),
+    metadata: {
+        library: "aura3d.standard-humanoid-clips",
+        clipVocabulary: [...STANDARD_CLIP_IDS]
+    }
+};
+/** Euler (radians, XYZ) -> quaternion. Compact authoring helper for the procedural clips. */
+function euler(x, y, z) {
+    const cx = Math.cos(x / 2);
+    const sx = Math.sin(x / 2);
+    const cy = Math.cos(y / 2);
+    const sy = Math.sin(y / 2);
+    const cz = Math.cos(z / 2);
+    const sz = Math.sin(z / 2);
+    return [
+        sx * cy * cz - cx * sy * sz,
+        cx * sy * cz + sx * cy * sz,
+        cx * cy * sz - sx * sy * cz,
+        cx * cy * cz + sx * sy * sz
+    ];
+}
+const IDENTITY = [0, 0, 0, 1];
+/** Build a looping quaternion (rotation) track for a bone from per-frame Euler samples. */
+function rotationTrack(bone, duration, samples) {
+    const keyframes = samples.map((sample) => ({
+        time: sample.t,
+        value: euler(sample.e[0], sample.e[1], sample.e[2]),
+        interpolation: "linear"
+    }));
+    // Pad to duration so the clip loops cleanly back to its first pose.
+    if (keyframes[keyframes.length - 1].time < duration) {
+        keyframes.push({ time: duration, value: [...keyframes[0].value], interpolation: "linear" });
+    }
+    return new AnimationTrack({ target: `${bone}.rotation`, valueType: "quaternion", keyframes });
+}
+/** Build a looping vector3 (translation) track for a bone, used for hip bob / sway. */
+function translationTrack(bone, duration, samples) {
+    const keyframes = samples.map((sample) => ({
+        time: sample.t,
+        value: [...sample.p],
+        interpolation: "linear"
+    }));
+    if (keyframes[keyframes.length - 1].time < duration) {
+        keyframes.push({ time: duration, value: [...keyframes[0].value], interpolation: "linear" });
+    }
+    return new AnimationTrack({ target: `${bone}.translation`, valueType: "vector3", keyframes });
+}
+function clip(id, duration, tracks, loop, tags) {
+    return {
+        id,
+        name: id,
+        duration,
+        frameRate: FRAME_RATE,
+        loop,
+        tags,
+        tracks,
+        source: "aura3d.standard-humanoid-clips",
+        metadata: { rig: STANDARD_LIBRARY_RIG.id, procedural: true }
+    };
+}
+// --- idle: visible breathing + head turns + weight-shift sway -----------------------------------
+// Amplitudes are deliberately readable (not the old ±2° "alive but invisible" idle): spine breathes
+// ~0.16 rad, head turns ~0.34 rad peak-to-peak, hips shift ~6 cm laterally so a viewer can tell the
+// character is standing/living rather than frozen.
+function idleClip() {
+    const d = 4;
+    return clip("idle", d, [
+        // Weight shift left -> right plus a clear breathing bob.
+        translationTrack("hips", d, [
+            { t: 0, p: [0.03, 0, 0] },
+            { t: 1, p: [0.02, 0.03, 0] },
+            { t: 2, p: [-0.03, 0.01, 0] },
+            { t: 3, p: [-0.02, 0.03, 0] }
+        ]),
+        // Breathing: spine flexes/extends well past the visibility floor (~0.16 rad swing).
+        rotationTrack("spine", d, [
+            { t: 0, e: [0.04, 0, 0.04] },
+            { t: 1, e: [0.18, 0, 0.03] },
+            { t: 2, e: [0.05, 0, -0.05] },
+            { t: 3, e: [0.16, 0, -0.03] }
+        ]),
+        rotationTrack("chest", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 1, e: [0.12, 0, 0.02] },
+            { t: 2, e: [0.02, 0, 0] },
+            { t: 3, e: [0.1, 0, -0.02] }
+        ]),
+        // Idle head turns: a slow look-around, ~0.34 rad peak-to-peak yaw + a little pitch.
+        rotationTrack("head", d, [
+            { t: 0, e: [0.02, 0.18, 0] },
+            { t: 1, e: [0.06, 0.1, 0.04] },
+            { t: 2, e: [0.04, -0.16, 0] },
+            { t: 3, e: [-0.04, -0.06, -0.04] }
+        ]),
+        rotationTrack("neck", d, [
+            { t: 0, e: [0, 0.08, 0] },
+            { t: 2, e: [0, -0.08, 0] }
+        ])
+    ], true, ["idle", "performance", "loop"]);
+}
+// --- talk: real conversational hand gestures + torso + head -------------------------------------
+// A speaking beat must read as "talking with the hands": both arms swing through ~0.5+ rad, the
+// forearms beat with the cadence, the chest counter-rotates, and the head punctuates.
+function talkClip() {
+    const d = 2;
+    return clip("talk", d, [
+        rotationTrack("head", d, [
+            { t: 0, e: [0, 0.04, 0] },
+            { t: 0.5, e: [0.16, 0.12, 0] },
+            { t: 1, e: [-0.1, -0.1, 0] },
+            { t: 1.5, e: [0.14, 0.06, 0] }
+        ]),
+        rotationTrack("neck", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.5, e: [0.09, 0.05, 0] },
+            { t: 1.5, e: [-0.07, -0.05, 0] }
+        ]),
+        rotationTrack("chest", d, [
+            { t: 0, e: [0, -0.06, 0] },
+            { t: 0.6, e: [0.04, 0.12, 0] },
+            { t: 1.3, e: [0.02, -0.1, 0] }
+        ]),
+        // Right hand does the lead gesture: up-and-out beats (~0.55 rad swing in Z plus pitch).
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.2] },
+            { t: 0.6, e: [0.45, -0.1, -0.62] },
+            { t: 1.2, e: [0.1, 0, -0.25] },
+            { t: 1.7, e: [0.35, -0.05, -0.5] }
+        ]),
+        rotationTrack("rightLowerArm", d, [
+            { t: 0, e: [0, 0, -0.35] },
+            { t: 0.6, e: [0, -0.2, -0.95] },
+            { t: 1.2, e: [0, 0, -0.4] },
+            { t: 1.7, e: [0, -0.15, -0.8] }
+        ]),
+        // Left hand supports with its own beat (~0.5 rad swing).
+        rotationTrack("leftUpperArm", d, [
+            { t: 0, e: [0, 0, 0.2] },
+            { t: 0.8, e: [0.35, 0.1, 0.6] },
+            { t: 1.5, e: [0.1, 0, 0.28] }
+        ]),
+        rotationTrack("leftLowerArm", d, [
+            { t: 0, e: [0, 0, 0.3] },
+            { t: 0.8, e: [0, 0.15, 0.75] },
+            { t: 1.5, e: [0, 0, 0.35] }
+        ])
+    ], true, ["talk", "performance", "loop", "upper-body"]);
+}
+// --- gesture: one-shot BIG expressive both-arm sweep --------------------------------------------
+// A full presentational sweep: the lead arm raises ~1.1 rad and opens out, the off arm mirrors, the
+// torso opens with it. Unmistakably a "big gesture", not a twitch.
+function gestureClip() {
+    const d = 1.1;
+    return clip("gesture", d, [
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.2] },
+            { t: 0.45, e: [1.1, -0.35, -1.15] },
+            { t: 0.8, e: [0.7, -0.2, -0.85] }
+        ]),
+        rotationTrack("rightLowerArm", d, [
+            { t: 0, e: [0, 0, -0.3] },
+            { t: 0.45, e: [0, -0.6, -1.2] },
+            { t: 0.8, e: [0, -0.3, -0.8] }
+        ]),
+        rotationTrack("leftUpperArm", d, [
+            { t: 0, e: [0, 0, 0.2] },
+            { t: 0.5, e: [0.95, 0.35, 1.1] },
+            { t: 0.85, e: [0.6, 0.2, 0.8] }
+        ]),
+        rotationTrack("leftLowerArm", d, [
+            { t: 0, e: [0, 0, 0.3] },
+            { t: 0.5, e: [0, 0.5, 1.1] }
+        ]),
+        rotationTrack("chest", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.45, e: [-0.08, 0.28, 0] }
+        ]),
+        rotationTrack("head", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.45, e: [-0.12, 0.1, 0] }
+        ])
+    ], false, ["gesture", "performance", "one-shot", "upper-body"]);
+}
+// --- point: one-shot directional arm extension --------------------------------------------------
+function pointClip() {
+    const d = 0.9;
+    return clip("point", d, [
+        rotationTrack("rightShoulder", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.35, e: [0, -0.15, 0] }
+        ]),
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.2] },
+            { t: 0.35, e: [0, -0.25, -1.55] },
+            { t: 0.7, e: [0, -0.25, -1.55] }
+        ]),
+        rotationTrack("rightLowerArm", d, [
+            { t: 0, e: [0, 0, -0.35] },
+            { t: 0.35, e: [0, 0, 0] },
+            { t: 0.7, e: [0, 0, 0] }
+        ]),
+        rotationTrack("head", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.35, e: [0, -0.35, 0] },
+            { t: 0.7, e: [0, -0.3, 0] }
+        ])
+    ], false, ["point", "performance", "one-shot", "upper-body"]);
+}
+// --- nod: one-shot affirmative head nod ---------------------------------------------------------
+function nodClip() {
+    const d = 0.8;
+    return clip("nod", d, [
+        rotationTrack("head", d, [
+            { t: 0, e: [-0.06, 0, 0] },
+            { t: 0.2, e: [0.42, 0, 0] },
+            { t: 0.4, e: [-0.1, 0, 0] },
+            { t: 0.6, e: [0.34, 0, 0] }
+        ]),
+        rotationTrack("neck", d, [
+            { t: 0, e: [-0.02, 0, 0] },
+            { t: 0.2, e: [0.18, 0, 0] },
+            { t: 0.4, e: [-0.02, 0, 0] },
+            { t: 0.6, e: [0.14, 0, 0] }
+        ])
+    ], false, ["nod", "performance", "one-shot"]);
+}
+// --- react: one-shot surprised recoil (torso + arms + head) -------------------------------------
+function reactClip() {
+    const d = 1;
+    return clip("react", d, [
+        rotationTrack("spine", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.18, e: [-0.5, 0, 0] },
+            { t: 0.6, e: [-0.18, 0, 0] }
+        ]),
+        rotationTrack("head", d, [
+            { t: 0, e: [0, 0, 0] },
+            { t: 0.18, e: [-0.4, 0, 0] },
+            { t: 0.6, e: [-0.12, 0, 0] }
+        ]),
+        rotationTrack("leftUpperArm", d, [
+            { t: 0, e: [0, 0, 0.2] },
+            { t: 0.2, e: [-0.7, 0, 1.1] },
+            { t: 0.6, e: [-0.3, 0, 0.6] }
+        ]),
+        rotationTrack("rightUpperArm", d, [
+            { t: 0, e: [0, 0, -0.2] },
+            { t: 0.2, e: [-0.7, 0, -1.1] },
+            { t: 0.6, e: [-0.3, 0, -0.6] }
+        ]),
+        translationTrack("hips", d, [
+            { t: 0, p: [0, 0, 0] },
+            { t: 0.18, p: [0, 0, -0.12] },
+            { t: 0.6, p: [0, 0, -0.04] }
+        ])
+    ], false, ["react", "performance", "one-shot"]);
+}
+/** Build a symmetric two-step leg/arm cycle for walk or run. */
+function legCycle(id, duration, amplitude, lift, bob) {
+    const half = duration / 2;
+    return clip(id, duration, [
+        // Hip vertical bob (two bobs per stride).
+        translationTrack("hips", duration, [
+            { t: 0, p: [0, 0, 0] },
+            { t: half / 2, p: [0, bob, 0] },
+            { t: half, p: [0, 0, 0] },
+            { t: half + half / 2, p: [0, bob, 0] }
+        ]),
+        // Legs swing in opposition.
+        rotationTrack("leftUpperLeg", duration, [
+            { t: 0, e: [amplitude, 0, 0] },
+            { t: half, e: [-amplitude, 0, 0] }
+        ]),
+        rotationTrack("rightUpperLeg", duration, [
+            { t: 0, e: [-amplitude, 0, 0] },
+            { t: half, e: [amplitude, 0, 0] }
+        ]),
+        rotationTrack("leftLowerLeg", duration, [
+            { t: 0, e: [0, 0, 0] },
+            { t: half / 2, e: [lift, 0, 0] },
+            { t: half, e: [0, 0, 0] }
+        ]),
+        rotationTrack("rightLowerLeg", duration, [
+            { t: 0, e: [lift, 0, 0] },
+            { t: half / 2, e: [0, 0, 0] },
+            { t: half, e: [lift, 0, 0] }
+        ]),
+        // Arms counter-swing to the legs.
+        rotationTrack("leftUpperArm", duration, [
+            { t: 0, e: [-amplitude * 0.8, 0, 0.15] },
+            { t: half, e: [amplitude * 0.8, 0, 0.15] }
+        ]),
+        rotationTrack("rightUpperArm", duration, [
+            { t: 0, e: [amplitude * 0.8, 0, -0.15] },
+            { t: half, e: [-amplitude * 0.8, 0, -0.15] }
+        ]),
+        rotationTrack("spine", duration, [
+            { t: 0, e: [0.05, amplitude * 0.15, 0] },
+            { t: half, e: [0.05, -amplitude * 0.15, 0] }
+        ])
+    ], true, [id, "locomotion", "loop", "lower-body"]);
+}
+// Walk: strong staged stride. Upper-leg swing of ±0.55 rad gives a 1.1 rad peak-to-peak step that
+// reads clearly even on a previz rig; knees lift, arms counter-swing, torso twists.
+function walkClip() {
+    return legCycle("walk", 1, 0.55, 0.7, 0.04);
+}
+// Run: bigger and faster (rig permitting) — ±0.9 rad upper-leg swing, deep knee lift, strong bob.
+function runClip() {
+    return legCycle("run", 0.6, 0.9, 1.1, 0.07);
+}
+/** Ordered list of all standard library clip definitions (idle first). */
+export function createStandardHumanoidClipDefinitions() {
+    return [
+        idleClip(),
+        talkClip(),
+        gestureClip(),
+        pointClip(),
+        nodClip(),
+        walkClip(),
+        runClip(),
+        reactClip()
+    ];
+}
+/**
+ * Shared, rig-neutral {@link AnimationClipRegistry} populated with the 8 standard performance clips
+ * authored on {@link STANDARD_LIBRARY_RIG} (canonical {@link HUMANOID_BONES}). The clips are COMPACT
+ * procedural keyframe loops/one-shots — real, samplable {@link AnimationTrack} data, not mocap and
+ * not placeholders. They give the studio a guaranteed, retargetable performance vocabulary even when
+ * a source GLB ships only one (or zero) usable clips.
+ */
+export function createStandardHumanoidClipRegistry() {
+    return createAnimationClipRegistry(createStandardHumanoidClipDefinitions());
+}
+//# sourceMappingURL=standardHumanoidClips.js.map

package/dist/library/standardHumanoidClips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardHumanoidClips.js","sourceRoot":"","sources":["../../../../../packages/animation/src/library/standardHumanoidClips.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/animation",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,6 @@
     }
   },
   "dependencies": {
-    "@aura3d/math": "1.1.0"
+    "@aura3d/math": "workspace:*"
   }
-}
+}

package/src/AnimationClipEvents.ts

@@ -318,3 +318,184 @@ function positiveModulo(value: number, divisor: number): number {
 function clamp(value: number, min: number, max: number): number {
   return Math.min(max, Math.max(min, value));
 }
+
+// ---- event tracks (authoring container on top of the existing dispatcher/sampler) -------------
+//
+// An event *track* is a named lane of typed markers on a clip's timeline (e.g. a "hitbox" lane, a
+// "footstep" lane, a "vfx" lane). This adds the authoring + active-frame layer the editor and
+// gameplay need WITHOUT rebuilding the dispatcher/sampler above: `toEventSource()` flattens the
+// tracks back into the `AnimationClipEventSource` that `sampleClipEvents` already consumes.
+
+export interface AnimationEventTrack<TEvent extends AnimationClipEvent = AnimationClipEvent> {
+  readonly name: string;
+  readonly type: AnimationClipEventType;
+  readonly markers: readonly TEvent[];
+}
+
+export interface SerializedAnimationEventTracks<TEvent extends AnimationClipEvent = AnimationClipEvent> {
+  readonly schema: "animation-event-tracks/v1";
+  readonly clipId: string;
+  readonly duration: number;
+  readonly tracks: readonly AnimationEventTrack<TEvent>[];
+}
+
+export interface ActiveWindow {
+  readonly start: number;
+  readonly end: number;
+}
+
+export interface AddMarkerOptions<TPayload = unknown> {
+  readonly id?: string;
+  readonly type?: AnimationClipEventType;
+  /** Window length (seconds). >0 makes this an active-frame marker (e.g. hitbox on/off). */
+  readonly duration?: number;
+  readonly payload?: TPayload;
+  readonly once?: boolean;
+  readonly tags?: readonly string[];
+}
+
+/**
+ * Authoring container for clip event tracks: add/move/delete typed markers on named lanes, query
+ * active-frame windows, flatten to the existing `AnimationClipEventSource`, and serialize. Pure and
+ * deterministic — marker ids are assigned from a monotonic counter (no `Date.now`/`Math.random`).
+ */
+export class AnimationEventTrackContainer {
+  readonly clipId: string;
+  duration: number;
+  private readonly trackOrder: string[] = [];
+  private readonly trackMap = new Map<string, { type: AnimationClipEventType; markers: AnimationClipEvent[] }>();
+  private idCounter = 0;
+
+  constructor(clipId: string, duration: number) {
+    if (!Number.isFinite(duration) || duration < 0) {
+      throw new Error("Event-track clip duration must be a finite, non-negative number.");
+    }
+    this.clipId = clipId;
+    this.duration = duration;
+  }
+
+  addTrack(name: string, type: AnimationClipEventType = "marker"): this {
+    if (!this.trackMap.has(name)) {
+      this.trackMap.set(name, { type, markers: [] });
+      this.trackOrder.push(name);
+    }
+    return this;
+  }
+
+  removeTrack(name: string): this {
+    if (this.trackMap.delete(name)) {
+      this.trackOrder.splice(this.trackOrder.indexOf(name), 1);
+    }
+    return this;
+  }
+
+  /** Add a marker to a track (auto-creates the track). Returns the marker id. */
+  addMarker(trackName: string, time: number, options: AddMarkerOptions = {}): string {
+    if (!Number.isFinite(time) || time < 0) {
+      throw new Error("Event marker time must be a finite, non-negative number.");
+    }
+    this.addTrack(trackName, options.type);
+    const track = this.trackMap.get(trackName)!;
+    const id = options.id ?? `${trackName}#${this.idCounter++}`;
+    const marker: AnimationClipEvent = {
+      id,
+      name: trackName,
+      type: options.type ?? track.type,
+      time,
+      ...(options.duration !== undefined ? { duration: options.duration } : {}),
+      ...(options.payload !== undefined ? { payload: options.payload } : {}),
+      ...(options.once !== undefined ? { once: options.once } : {}),
+      ...(options.tags !== undefined ? { tags: options.tags } : {})
+    };
+    track.markers.push(marker);
+    track.markers.sort((a, b) => a.time - b.time);
+    return id;
+  }
+
+  moveMarker(trackName: string, markerId: string, time: number): this {
+    if (!Number.isFinite(time) || time < 0) {
+      throw new Error("Event marker time must be a finite, non-negative number.");
+    }
+    const track = this.trackMap.get(trackName);
+    const index = track?.markers.findIndex((m) => m.id === markerId) ?? -1;
+    if (!track || index < 0) throw new Error(`Marker ${markerId} not found on track ${trackName}.`);
+    track.markers[index] = { ...track.markers[index]!, time };
+    track.markers.sort((a, b) => a.time - b.time);
+    return this;
+  }
+
+  removeMarker(trackName: string, markerId: string): this {
+    const track = this.trackMap.get(trackName);
+    if (!track) return this;
+    const index = track.markers.findIndex((m) => m.id === markerId);
+    if (index >= 0) track.markers.splice(index, 1);
+    return this;
+  }
+
+  track(name: string): AnimationEventTrack | undefined {
+    const track = this.trackMap.get(name);
+    return track ? { name, type: track.type, markers: [...track.markers] } : undefined;
+  }
+
+  tracks(): readonly AnimationEventTrack[] {
+    return this.trackOrder.map((name) => this.track(name)!);
+  }
+
+  markerCount(): number {
+    let count = 0;
+    for (const track of this.trackMap.values()) count += track.markers.length;
+    return count;
+  }
+
+  /** Flatten every track's markers into the source shape `sampleClipEvents` consumes. */
+  toEventSource(): AnimationClipEventSource {
+    const events: AnimationClipEvent[] = [];
+    for (const name of this.trackOrder) events.push(...this.trackMap.get(name)!.markers);
+    return { id: this.clipId, duration: this.duration, events: normalizeClipEvents(events) };
+  }
+
+  /** Active-frame windows for a track: [time, time+duration] for each marker with a duration. */
+  activeWindows(trackName: string): readonly ActiveWindow[] {
+    const track = this.trackMap.get(trackName);
+    if (!track) return [];
+    return track.markers
+      .filter((m) => (m.duration ?? 0) > 0)
+      .map((m) => ({ start: m.time, end: m.time + (m.duration ?? 0) }));
+  }
+
+  /** Whether any active-frame window on a track is open at `time` (hitbox live). */
+  isActive(trackName: string, time: number): boolean {
+    return this.activeWindows(trackName).some((w) => time >= w.start && time < w.end);
+  }
+
+  serialize(): SerializedAnimationEventTracks {
+    return {
+      schema: "animation-event-tracks/v1",
+      clipId: this.clipId,
+      duration: this.duration,
+      tracks: this.tracks()
+    };
+  }
+}
+
+export function createAnimationEventTracks(clipId: string, duration: number): AnimationEventTrackContainer {
+  return new AnimationEventTrackContainer(clipId, duration);
+}
+
+export function deserializeAnimationEventTracks(data: SerializedAnimationEventTracks): AnimationEventTrackContainer {
+  const container = new AnimationEventTrackContainer(data.clipId, data.duration);
+  for (const track of data.tracks) {
+    container.addTrack(track.name, track.type);
+    for (const marker of track.markers) {
+      container.addMarker(track.name, marker.time, {
+        id: marker.id,
+        type: marker.type,
+        ...(marker.duration !== undefined ? { duration: marker.duration } : {}),
+        ...(marker.payload !== undefined ? { payload: marker.payload } : {}),
+        ...(marker.once !== undefined ? { once: marker.once } : {}),
+        ...(marker.tags !== undefined ? { tags: marker.tags } : {})
+      });
+    }
+  }
+  return container;
+}