@aura3d/engine 1.1.0 → 1.3.1

package/dist/animation/SpringBones.d.ts

@@ -0,0 +1,60 @@
+import type { Quat, Vec3 } from "./Keyframe.js";
+export interface SpringCollider {
+    readonly kind: "sphere" | "capsule";
+    readonly center: Vec3;
+    /** Capsule second endpoint (ignored for spheres). */
+    readonly tail?: Vec3;
+    readonly radius: number;
+}
+export interface SpringChainOptions {
+    /** Rest-pose world positions of the chain, root first (index 0 is the kinematic root). */
+    readonly bones: readonly Vec3[];
+    /** Spring stiffness pulling each particle to its rest pose (default 40). */
+    readonly stiffness?: number;
+    /** Velocity damping (default 4). Higher = settles faster. */
+    readonly damping?: number;
+    /** Gravity acceleration (default [0,-9.81,0]). */
+    readonly gravity?: Vec3;
+    /** Optional colliders the chain is pushed out of. */
+    readonly colliders?: readonly SpringCollider[];
+    /** Integration substeps per `integrate` call (default 2) for stiffness stability. */
+    readonly substeps?: number;
+    /** Optional chain label (telemetry). */
+    readonly name?: string;
+}
+/** Root transform driving the chain each frame. */
+export interface SpringRootTransform {
+    readonly position: Vec3;
+    /** Optional rotation so the rest offsets follow the character's facing. */
+    readonly rotation?: Quat;
+}
+export interface SpringChainTelemetry {
+    readonly name: string;
+    readonly boneCount: number;
+    readonly stiffness: number;
+    readonly damping: number;
+    readonly rootPosition: Vec3;
+    readonly tipPosition: Vec3;
+    /** Distance from root to tip (how far the chain swings out). */
+    readonly maxDisplacement: number;
+    /** Number of particles currently resolved against a collider this step. */
+    readonly collisionContacts: number;
+    /** Total kinetic energy (Σ½|v|²); used to verify damping decay. */
+    readonly kineticEnergy: number;
+}
+export interface SpringChain {
+    /** Advance the chain by `dt` seconds with the root at `rootTransform`. Deterministic. */
+    integrate(dt: number, rootTransform: SpringRootTransform): void;
+    /** Current solved world positions (index 0 is the root). */
+    positions(): readonly Vec3[];
+    /** Telemetry for tests/gates and matching the fixture oracle's invariants. */
+    telemetry(): SpringChainTelemetry;
+    /** Reset the chain to its rest pose at a root transform (zero velocity). */
+    reset(rootTransform?: SpringRootTransform): void;
+}
+/**
+ * Create a spring-bone chain. Bind it to a bone subtree (see {@link tagSpringChain}) and call
+ * {@link SpringChain.integrate} each frame; write {@link SpringChain.positions} back onto the bones.
+ */
+export declare function createSpringChain(options: SpringChainOptions): SpringChain;
+//# sourceMappingURL=SpringBones.d.ts.map

package/dist/animation/SpringBones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpringBones.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/SpringBones.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChE,4DAA4D;IAC5D,SAAS,IAAI,SAAS,IAAI,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,SAAS,IAAI,oBAAoB,CAAC;IAClC,4EAA4E;IAC5E,KAAK,CAAC,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAwG1E"}

package/dist/animation/SpringBones.js

@@ -0,0 +1,173 @@
+// Spring bones: secondary dynamics for hair, cloth flaps, tails, and accessories. A chain of
+// particles hangs off a kinematic root (driven by the character's animation). Each particle is
+// pulled toward its rest pose by a spring, pulled down by gravity, damped, kept at its bone length
+// by a distance constraint, and pushed out of optional sphere/capsule colliders. The result
+// composes on top of any clip for free — it just reacts to how the root moves.
+//
+// Integration is semi-implicit (symplectic) Euler with a fixed timestep (subdivided into substeps
+// for stiffness stability), so it is deterministic: the same root-motion stream and the same `dt`
+// always produce the same chain. Pure: no `Date.now()` / `Math.random()`, no engine/render import.
+//
+// The deterministic `SpringBoneSample` / `springSample()` in SecondaryAnimationFixtures remain the
+// telemetry oracle/data-shape; this runtime produces the same invariants via `telemetry()`.
+/**
+ * Create a spring-bone chain. Bind it to a bone subtree (see {@link tagSpringChain}) and call
+ * {@link SpringChain.integrate} each frame; write {@link SpringChain.positions} back onto the bones.
+ */
+export function createSpringChain(options) {
+    if (options.bones.length < 2) {
+        throw new Error("Spring chain requires at least a root and one child bone.");
+    }
+    const stiffness = options.stiffness ?? 40;
+    const damping = options.damping ?? 4;
+    const gravity = options.gravity ?? [0, -9.81, 0];
+    const colliders = options.colliders ?? [];
+    const substeps = Math.max(1, Math.floor(options.substeps ?? 2));
+    const name = options.name ?? "spring-chain";
+    // Rest offset of each particle relative to its parent, in the root's initial frame.
+    const restOffsets = options.bones.map((bone, i) => i === 0 ? [0, 0, 0] : sub(bone, options.bones[i - 1]));
+    const restLengths = restOffsets.map((o) => len(o));
+    const positions = options.bones.map((b) => [...b]);
+    const velocities = options.bones.map(() => [0, 0, 0]);
+    let contacts = 0;
+    function rotatedRestOffset(i, rotation) {
+        return rotation ? rotateVec3(restOffsets[i], rotation) : restOffsets[i];
+    }
+    function step(dt, root) {
+        contacts = 0;
+        // Root particle is kinematic.
+        positions[0] = [...root.position];
+        velocities[0] = [0, 0, 0];
+        for (let i = 1; i < positions.length; i += 1) {
+            const parent = positions[i - 1];
+            const rest = add(parent, rotatedRestOffset(i, root.rotation));
+            const p = positions[i];
+            const v = velocities[i];
+            // a = stiffness*(rest - p) + gravity - damping*v  (semi-implicit: update v, then p)
+            const ax = stiffness * (rest[0] - p[0]) + gravity[0] - damping * v[0];
+            const ay = stiffness * (rest[1] - p[1]) + gravity[1] - damping * v[1];
+            const az = stiffness * (rest[2] - p[2]) + gravity[2] - damping * v[2];
+            const nv = [v[0] + ax * dt, v[1] + ay * dt, v[2] + az * dt];
+            let np = [p[0] + nv[0] * dt, p[1] + nv[1] * dt, p[2] + nv[2] * dt];
+            // Distance constraint: keep the bone length to the parent.
+            np = enforceLength(parent, np, restLengths[i]);
+            // Collider push-out.
+            for (const collider of colliders) {
+                const resolved = pushOut(np, collider);
+                if (resolved) {
+                    np = resolved.position;
+                    // Remove the inward velocity component so it doesn't tunnel back in.
+                    const dot = nv[0] * resolved.normal[0] + nv[1] * resolved.normal[1] + nv[2] * resolved.normal[2];
+                    if (dot < 0) {
+                        nv[0] -= dot * resolved.normal[0];
+                        nv[1] -= dot * resolved.normal[1];
+                        nv[2] -= dot * resolved.normal[2];
+                    }
+                    contacts += 1;
+                }
+            }
+            // Recompute velocity from the constrained position so energy bookkeeping stays consistent.
+            velocities[i] = [(np[0] - p[0]) / dt, (np[1] - p[1]) / dt, (np[2] - p[2]) / dt];
+            positions[i] = np;
+        }
+    }
+    return {
+        integrate(dt, rootTransform) {
+            if (!Number.isFinite(dt) || dt <= 0)
+                throw new Error("Spring chain dt must be finite and positive.");
+            const sub = dt / substeps;
+            for (let s = 0; s < substeps; s += 1)
+                step(sub, rootTransform);
+        },
+        positions() {
+            return positions.map((p) => [...p]);
+        },
+        telemetry() {
+            const tip = positions[positions.length - 1];
+            const root = positions[0];
+            let ke = 0;
+            for (const v of velocities)
+                ke += 0.5 * (v[0] * v[0] + v[1] * v[1] + v[2] * v[2]);
+            return {
+                name,
+                boneCount: positions.length,
+                stiffness,
+                damping,
+                rootPosition: [...root],
+                tipPosition: [...tip],
+                maxDisplacement: dist(root, tip),
+                collisionContacts: contacts,
+                kineticEnergy: ke
+            };
+        },
+        reset(rootTransform) {
+            const rootPos = rootTransform?.position ?? options.bones[0];
+            const rotation = rootTransform?.rotation;
+            positions[0] = [...rootPos];
+            velocities[0] = [0, 0, 0];
+            for (let i = 1; i < positions.length; i += 1) {
+                positions[i] = add(positions[i - 1], rotatedRestOffset(i, rotation));
+                velocities[i] = [0, 0, 0];
+            }
+        }
+    };
+}
+function enforceLength(anchor, point, length) {
+    const d = sub(point, anchor);
+    const l = len(d);
+    if (l <= 1e-8)
+        return [anchor[0], anchor[1] + length, anchor[2]];
+    const s = length / l;
+    return [anchor[0] + d[0] * s, anchor[1] + d[1] * s, anchor[2] + d[2] * s];
+}
+function pushOut(point, collider) {
+    const closest = collider.kind === "capsule" && collider.tail
+        ? closestPointOnSegment(point, collider.center, collider.tail)
+        : collider.center;
+    const d = sub(point, closest);
+    const l = len(d);
+    if (l >= collider.radius)
+        return undefined;
+    const normal = l <= 1e-8 ? [0, 1, 0] : [d[0] / l, d[1] / l, d[2] / l];
+    return {
+        position: [closest[0] + normal[0] * collider.radius, closest[1] + normal[1] * collider.radius, closest[2] + normal[2] * collider.radius],
+        normal
+    };
+}
+function closestPointOnSegment(p, a, b) {
+    const ab = sub(b, a);
+    const t = clamp(dot(sub(p, a), ab) / Math.max(1e-8, dot(ab, ab)), 0, 1);
+    return [a[0] + ab[0] * t, a[1] + ab[1] * t, a[2] + ab[2] * t];
+}
+function add(a, b) {
+    return [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+}
+function sub(a, b) {
+    return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+function dot(a, b) {
+    return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+function len(a) {
+    return Math.hypot(a[0], a[1], a[2]);
+}
+function dist(a, b) {
+    return len(sub(a, b));
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function rotateVec3(v, q) {
+    // v' = q * v * q⁻¹ (unit quaternion).
+    const [x, y, z, w] = q;
+    const ix = w * v[0] + y * v[2] - z * v[1];
+    const iy = w * v[1] + z * v[0] - x * v[2];
+    const iz = w * v[2] + x * v[1] - y * v[0];
+    const iw = -x * v[0] - y * v[1] - z * v[2];
+    return [
+        ix * w + iw * -x + iy * -z - iz * -y,
+        iy * w + iw * -y + iz * -x - ix * -z,
+        iz * w + iw * -z + ix * -y - iy * -x
+    ];
+}
+//# sourceMappingURL=SpringBones.js.map

package/dist/animation/SpringBones.js.map

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

package/dist/animation/browser-index.d.ts

@@ -9,6 +9,7 @@ export * from "./Bone.js";
 export * from "./Skeleton.js";
 export * from "./Skinning.js";
 export * from "./BlendTree.js";
+export * from "./Inertialization.js";
 export * from "./AnimationStateMachine.js";
 export * from "./RootMotion.js";
 export * from "./MotionQuality.js";
@@ -16,15 +17,23 @@ export * from "./LocomotionController.js";
 export * from "./SceneAnimationBridge.js";
 export * from "./ECSAnimationBridge.js";
 export * from "./IK.js";
+export * from "./FootIk.js";
+export * from "./SpringBones.js";
 export * from "./MotionMatchingFixtures.js";
 export * from "./SecondaryAnimationFixtures.js";
 export * from "./CrowdAnimation.js";
-export * from "./Retargeting.js";
 export * from "./AnimationClipEvents.js";
-export { AnimationClipRegistry, validateCartoonClipMap } from "./AnimationClipRegistry.js";
-export type { AnimationClipDefinition, AnimationClipId, AnimationClipManifest, AnimationClipRegistryDiagnostic, AnimationClipRegistryDiagnosticSeverity, AnimationClipRegistryOptions, AnimationClipSampleContext, AnimationClipSampler, AnimationKeyframe, AnimationTrack as AnimationClipTrack, AnimationTrackTarget, CartoonClipMapReadiness, CartoonClipMapReadinessOptions, RegisteredAnimationClip } from "./AnimationClipRegistry.js";
+export { AnimationClipRegistry, createAnimationClipRegistry, validateAnimationClipMap, validateAnimationStudioClipMap } from "./AnimationClipRegistry.js";
+export { createAnimationAnimationStateGraph, createLocomotionAnimationStateGraph, sampleAnimationAnimationStateGraph } from "./AnimationStateGraph.js";
+export * from "./LocomotionKit.js";
+export * from "./FighterAnimationAdapter.js";
+export type { AnimationClipDefinition, AnimationClipId, AnimationClipManifest, AnimationClipRegistryDiagnostic, AnimationClipRegistryDiagnosticSeverity, AnimationClipRegistryOptions, AnimationClipSampleContext, AnimationClipSampler, AnimationKeyframe, AnimationTrack as AnimationClipTrack, AnimationTrackTarget, AnimationClipMapReadiness, AnimationClipMapReadinessOptions, RegisteredAnimationClip } from "./AnimationClipRegistry.js";
 export * from "./AnimationController.js";
 export * from "./HumanoidRetargeting.js";
+export * from "./HumanoidBoneInference.js";
+export * from "./RigQuality.js";
+export * from "./library/standardHumanoidClips.js";
+export * from "./library/performanceStateGraph.js";
 export { AnimationClipThreeCompat } from "./threejs-compatibility/AnimationClip.js";
 export type { ThreeCompatKeyframeTrack, ThreeCompatLoopMode } from "./threejs-compatibility/AnimationClip.js";
 export { AnimationActionThreeCompat } from "./threejs-compatibility/AnimationAction.js";

package/dist/animation/browser-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-index.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/browser-index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,IAAI,kBAAkB,EACpC,oBAAoB,EACpB,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,YAAY,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC;AACzD,YAAY,EAAE,kCAAkC,EAAE,MAAM,iDAAiD,CAAC"}
+{"version":3,"file":"browser-index.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/browser-index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC1J,OAAO,EAAE,kCAAkC,EAAE,mCAAmC,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AACvJ,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,IAAI,kBAAkB,EACpC,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,YAAY,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC;AACzD,YAAY,EAAE,kCAAkC,EAAE,MAAM,iDAAiD,CAAC"}

package/dist/animation/browser-index.js

@@ -9,6 +9,7 @@ export * from "./Bone.js";
 export * from "./Skeleton.js";
 export * from "./Skinning.js";
 export * from "./BlendTree.js";
+export * from "./Inertialization.js";
 export * from "./AnimationStateMachine.js";
 export * from "./RootMotion.js";
 export * from "./MotionQuality.js";
@@ -16,14 +17,22 @@ export * from "./LocomotionController.js";
 export * from "./SceneAnimationBridge.js";
 export * from "./ECSAnimationBridge.js";
 export * from "./IK.js";
+export * from "./FootIk.js";
+export * from "./SpringBones.js";
 export * from "./MotionMatchingFixtures.js";
 export * from "./SecondaryAnimationFixtures.js";
 export * from "./CrowdAnimation.js";
-export * from "./Retargeting.js";
 export * from "./AnimationClipEvents.js";
-export { AnimationClipRegistry, validateCartoonClipMap } from "./AnimationClipRegistry.js";
+export { AnimationClipRegistry, createAnimationClipRegistry, validateAnimationClipMap, validateAnimationStudioClipMap } from "./AnimationClipRegistry.js";
+export { createAnimationAnimationStateGraph, createLocomotionAnimationStateGraph, sampleAnimationAnimationStateGraph } from "./AnimationStateGraph.js";
+export * from "./LocomotionKit.js";
+export * from "./FighterAnimationAdapter.js";
 export * from "./AnimationController.js";
 export * from "./HumanoidRetargeting.js";
+export * from "./HumanoidBoneInference.js";
+export * from "./RigQuality.js";
+export * from "./library/standardHumanoidClips.js";
+export * from "./library/performanceStateGraph.js";
 export { AnimationClipThreeCompat } from "./threejs-compatibility/AnimationClip.js";
 export { AnimationActionThreeCompat } from "./threejs-compatibility/AnimationAction.js";
 export { AnimationMixerThreeCompat } from "./threejs-compatibility/AnimationMixer.js";

package/dist/animation/browser-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-index.js","sourceRoot":"","sources":["../../../../packages/animation/src/browser-index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAiB3F,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE1F,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC"}
+{"version":3,"file":"browser-index.js","sourceRoot":"","sources":["../../../../packages/animation/src/browser-index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC1J,OAAO,EAAE,kCAAkC,EAAE,mCAAmC,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AACvJ,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAiB7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE1F,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC"}

package/dist/animation/index.d.ts

@@ -9,23 +9,31 @@ export * from "./Bone.js";
 export * from "./Skeleton.js";
 export * from "./Skinning.js";
 export * from "./BlendTree.js";
+export * from "./Inertialization.js";
 export * from "./AnimationStateMachine.js";
 export * from "./AnimationStateGraph.js";
+export * from "./LocomotionKit.js";
+export * from "./FighterAnimationAdapter.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 "./FootIk.js";
+export * from "./SpringBones.js";
 export * from "./MotionMatchingFixtures.js";
 export * from "./SecondaryAnimationFixtures.js";
 export * from "./CrowdAnimation.js";
-export * from "./Retargeting.js";
 export * from "./AnimationClipEvents.js";
-export { AnimationClipRegistry, validateCartoonClipMap } from "./AnimationClipRegistry.js";
-export type { AnimationClipDefinition, AnimationClipId, AnimationClipManifest, AnimationClipRegistryDiagnostic, AnimationClipRegistryDiagnosticSeverity, AnimationClipRegistryOptions, AnimationClipSampleContext, AnimationClipSampler, AnimationKeyframe, AnimationTrack as AnimationClipTrack, AnimationTrackTarget, CartoonClipMapReadiness, CartoonClipMapReadinessOptions, RegisteredAnimationClip } from "./AnimationClipRegistry.js";
+export { AnimationClipRegistry, createAnimationClipRegistry, validateAnimationClipMap, validateAnimationStudioClipMap } from "./AnimationClipRegistry.js";
+export type { AnimationClipDefinition, AnimationClipId, AnimationClipManifest, AnimationClipRegistryDiagnostic, AnimationClipRegistryDiagnosticSeverity, AnimationClipRegistryOptions, AnimationClipSampleContext, AnimationClipSampler, AnimationKeyframe, AnimationTrack as AnimationClipTrack, AnimationTrackTarget, AnimationClipMapReadiness, AnimationClipMapReadinessOptions, RegisteredAnimationClip } from "./AnimationClipRegistry.js";
 export * from "./AnimationController.js";
 export * from "./HumanoidRetargeting.js";
+export * from "./HumanoidBoneInference.js";
+export * from "./RigQuality.js";
+export * from "./library/standardHumanoidClips.js";
+export * from "./library/performanceStateGraph.js";
 export { AnimationClipThreeCompat } from "./threejs-compatibility/AnimationClip.js";
 export type { ThreeCompatKeyframeTrack, ThreeCompatLoopMode } from "./threejs-compatibility/AnimationClip.js";
 export { AnimationActionThreeCompat } from "./threejs-compatibility/AnimationAction.js";

package/dist/animation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,IAAI,kBAAkB,EACpC,oBAAoB,EACpB,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,YAAY,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC;AACzD,YAAY,EAAE,kCAAkC,EAAE,MAAM,iDAAiD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC1J,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,IAAI,kBAAkB,EACpC,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,YAAY,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC;AACzD,YAAY,EAAE,kCAAkC,EAAE,MAAM,iDAAiD,CAAC"}

package/dist/animation/index.js

@@ -9,22 +9,30 @@ export * from "./Bone.js";
 export * from "./Skeleton.js";
 export * from "./Skinning.js";
 export * from "./BlendTree.js";
+export * from "./Inertialization.js";
 export * from "./AnimationStateMachine.js";
 export * from "./AnimationStateGraph.js";
+export * from "./LocomotionKit.js";
+export * from "./FighterAnimationAdapter.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 "./FootIk.js";
+export * from "./SpringBones.js";
 export * from "./MotionMatchingFixtures.js";
 export * from "./SecondaryAnimationFixtures.js";
 export * from "./CrowdAnimation.js";
-export * from "./Retargeting.js";
 export * from "./AnimationClipEvents.js";
-export { AnimationClipRegistry, validateCartoonClipMap } from "./AnimationClipRegistry.js";
+export { AnimationClipRegistry, createAnimationClipRegistry, validateAnimationClipMap, validateAnimationStudioClipMap } from "./AnimationClipRegistry.js";
 export * from "./AnimationController.js";
 export * from "./HumanoidRetargeting.js";
+export * from "./HumanoidBoneInference.js";
+export * from "./RigQuality.js";
+export * from "./library/standardHumanoidClips.js";
+export * from "./library/performanceStateGraph.js";
 export { AnimationClipThreeCompat } from "./threejs-compatibility/AnimationClip.js";
 export { AnimationActionThreeCompat } from "./threejs-compatibility/AnimationAction.js";
 export { AnimationMixerThreeCompat } from "./threejs-compatibility/AnimationMixer.js";

package/dist/animation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/animation/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAiB3F,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE1F,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/animation/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAiB1J,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE1F,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,iDAAiD,CAAC"}

package/dist/animation/library/performanceStateGraph.d.ts

@@ -0,0 +1,42 @@
+import { AnimationStateMachine } from "../AnimationStateMachine.js";
+import { type StandardClipId } from "./standardHumanoidClips.js";
+export interface PerformanceStateGraphOptions {
+    /** Default / resting state (must be one of the standard clip ids). Defaults to `"idle"`. */
+    readonly idleState?: StandardClipId;
+    /** Duration (seconds) of the one-shot performance states before they auto-return to idle. */
+    readonly oneShotDuration?: number;
+}
+/**
+ * Boolean/number state-machine parameters the studio sets per beat to drive the performance graph.
+ * The looping conversational states (talk) are held while their flag is truthy; the one-shot states
+ * (gesture/point/nod/react) are triggered by a truthy pulse that is consumed on entry and auto-return
+ * to idle. Locomotion (walk/run) is driven by `isMoving` / `isRunning`, mirroring
+ * {@link createLocomotionAnimationStateGraph} so the same parameters work for both.
+ */
+export declare const PERFORMANCE_GRAPH_PARAMETERS: {
+    readonly talk: "isSpeaking";
+    readonly gesture: "gesture";
+    readonly point: "point";
+    readonly nod: "nod";
+    readonly react: "react";
+    readonly walk: "isMoving";
+    readonly run: "isRunning";
+};
+/**
+ * State graph over the 8 standard performance clip ids ({@link STANDARD_CLIP_IDS}) with `idle` as the
+ * default state. The studio requests a state per beat and the machine crossfades via the inertialized
+ * {@link AnimationStateMachine.stateBlend}.
+ *
+ * Topology:
+ *  - `idle` (default) can go to `talk`, `gesture`, `point`, `nod`, `react`, `walk`, `run`.
+ *  - `talk` is a held loop (while `isSpeaking`) that returns to idle when the flag clears; from talk
+ *    you can still fire one-shots and start moving.
+ *  - `gesture` / `point` / `nod` / `react` are one-shots that auto-return to idle on completion.
+ *  - `walk` <-> `run` <-> `idle` form the locomotion blend (`isMoving` / `isRunning`).
+ *
+ * Priorities: locomotion-stop/one-shots take precedence so a requested beat wins over the held loop.
+ */
+export declare function createPerformanceStateGraph(options?: PerformanceStateGraphOptions): AnimationStateMachine;
+/** The full set of state names the performance graph exposes (equals the standard clip vocabulary). */
+export declare const PERFORMANCE_GRAPH_STATES: readonly StandardClipId[];
+//# sourceMappingURL=performanceStateGraph.d.ts.map

package/dist/animation/library/performanceStateGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceStateGraph.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/library/performanceStateGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA6C,MAAM,6BAA6B,CAAC;AAC/G,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,WAAW,4BAA4B;IAC3C,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;CAQmB,CAAC;AA6B7D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,qBAAqB,CA6C7G;AAED,uGAAuG;AACvG,eAAO,MAAM,wBAAwB,EAAE,SAAS,cAAc,EAAsB,CAAC"}

package/dist/animation/library/performanceStateGraph.js

@@ -0,0 +1,101 @@
+import { AnimationStateMachine } from "../AnimationStateMachine.js";
+import { STANDARD_CLIP_IDS } from "./standardHumanoidClips.js";
+/**
+ * Boolean/number state-machine parameters the studio sets per beat to drive the performance graph.
+ * The looping conversational states (talk) are held while their flag is truthy; the one-shot states
+ * (gesture/point/nod/react) are triggered by a truthy pulse that is consumed on entry and auto-return
+ * to idle. Locomotion (walk/run) is driven by `isMoving` / `isRunning`, mirroring
+ * {@link createLocomotionAnimationStateGraph} so the same parameters work for both.
+ */
+export const PERFORMANCE_GRAPH_PARAMETERS = {
+    talk: "isSpeaking",
+    gesture: "gesture",
+    point: "point",
+    nod: "nod",
+    react: "react",
+    walk: "isMoving",
+    run: "isRunning"
+};
+function trigger(to, parameter, priority, consume = false, expected = true) {
+    return {
+        to,
+        priority,
+        label: `${parameter}->${to}`,
+        ...(consume ? { consumeParameters: [parameter] } : {}),
+        condition: (parameters) => {
+            const value = parameters[parameter];
+            if (expected !== true)
+                return value !== true && !truthy(value);
+            return truthy(value);
+        }
+    };
+}
+function truthy(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return value > 0;
+    if (typeof value === "string")
+        return value.trim().length > 0;
+    return false;
+}
+/**
+ * State graph over the 8 standard performance clip ids ({@link STANDARD_CLIP_IDS}) with `idle` as the
+ * default state. The studio requests a state per beat and the machine crossfades via the inertialized
+ * {@link AnimationStateMachine.stateBlend}.
+ *
+ * Topology:
+ *  - `idle` (default) can go to `talk`, `gesture`, `point`, `nod`, `react`, `walk`, `run`.
+ *  - `talk` is a held loop (while `isSpeaking`) that returns to idle when the flag clears; from talk
+ *    you can still fire one-shots and start moving.
+ *  - `gesture` / `point` / `nod` / `react` are one-shots that auto-return to idle on completion.
+ *  - `walk` <-> `run` <-> `idle` form the locomotion blend (`isMoving` / `isRunning`).
+ *
+ * Priorities: locomotion-stop/one-shots take precedence so a requested beat wins over the held loop.
+ */
+export function createPerformanceStateGraph(options = {}) {
+    const idle = options.idleState ?? "idle";
+    const oneShot = options.oneShotDuration ?? 0.6;
+    const P = PERFORMANCE_GRAPH_PARAMETERS;
+    const toTalk = trigger("talk", P.talk, 30);
+    const toWalk = trigger("walk", P.walk, 40);
+    const toRun = trigger("run", P.run, 60);
+    const toGesture = trigger("gesture", P.gesture, 80, true);
+    const toPoint = trigger("point", P.point, 80, true);
+    const toNod = trigger("nod", P.nod, 80, true);
+    const toReact = trigger("react", P.react, 90, true);
+    const states = [
+        {
+            name: idle,
+            transitions: [toReact, toGesture, toPoint, toNod, toRun, toWalk, toTalk]
+        },
+        {
+            name: "talk",
+            transitions: [
+                toReact,
+                toGesture,
+                toPoint,
+                toNod,
+                toRun,
+                toWalk,
+                trigger(idle, P.talk, 0, false, false)
+            ]
+        },
+        { name: "gesture", duration: oneShot, oneShot: true, onComplete: idle },
+        { name: "point", duration: oneShot, oneShot: true, onComplete: idle },
+        { name: "nod", duration: oneShot, oneShot: true, onComplete: idle },
+        { name: "react", duration: oneShot, oneShot: true, onComplete: idle },
+        {
+            name: "walk",
+            transitions: [toRun, trigger(idle, P.walk, 0, false, false)]
+        },
+        {
+            name: "run",
+            transitions: [trigger("walk", P.run, 0, false, false), trigger(idle, P.walk, 0, false, false)]
+        }
+    ];
+    return new AnimationStateMachine(states, idle);
+}
+/** The full set of state names the performance graph exposes (equals the standard clip vocabulary). */
+export const PERFORMANCE_GRAPH_STATES = STANDARD_CLIP_IDS;
+//# sourceMappingURL=performanceStateGraph.js.map

package/dist/animation/library/performanceStateGraph.js.map

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

package/dist/animation/library/standardHumanoidClips.d.ts

@@ -0,0 +1,27 @@
+import { AnimationClipRegistry, type AnimationClipDefinition } from "../AnimationClipRegistry.js";
+import { type HumanoidRigDefinition } 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 declare const STANDARD_CLIP_IDS: readonly ["idle", "talk", "gesture", "point", "nod", "walk", "run", "react"];
+export type StandardClipId = typeof STANDARD_CLIP_IDS[number];
+/** Locomotion subset of the vocabulary (used by the locomotion blend / studio clip-map check). */
+export declare const STANDARD_LOCOMOTION_CLIP_IDS: readonly ["idle", "walk", "run"];
+/**
+ * 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 declare const STANDARD_LIBRARY_RIG: HumanoidRigDefinition;
+/** Ordered list of all standard library clip definitions (idle first). */
+export declare function createStandardHumanoidClipDefinitions(): readonly AnimationClipDefinition<StandardClipId>[];
+/**
+ * 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 declare function createStandardHumanoidClipRegistry(): AnimationClipRegistry<StandardClipId>;
+//# sourceMappingURL=standardHumanoidClips.d.ts.map

package/dist/animation/library/standardHumanoidClips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardHumanoidClips.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/library/standardHumanoidClips.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EAErB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAyC,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAE9G;;;GAGG;AACH,eAAO,MAAM,iBAAiB,8EAA+E,CAAC;AAC9G,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE9D,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,kCAAmC,CAAC;AAO7E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAalC,CAAC;AAyXF,0EAA0E;AAC1E,wBAAgB,qCAAqC,IAAI,SAAS,uBAAuB,CAAC,cAAc,CAAC,EAAE,CAW1G;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,IAAI,qBAAqB,CAAC,cAAc,CAAC,CAE1F"}