@aura3d/animation 3.0.1 → 4.0.0

package/dist/pose/RetargetCache.js

@@ -0,0 +1,102 @@
+/**
+ * T3.8 (PRD-06 §7.2, R11) — IndexedDB retarget-bake cache. Entries are keyed by
+ * `(engineVersion, sourceHash, targetHash)` so an engine rollback ignores caches
+ * written by a newer build (the key namespace changes with the version). Store
+ * "bakes" holds `{key → Map<string, CompiledClip>}`; typed arrays survive
+ * structured-clone round-trips so clips are stored verbatim.
+ */
+/** Bump when the bake semantics change; older namespaces are simply never read. */
+export const AURA3D_RETARGET_ENGINE_VERSION = "prd06-retarget/v1";
+const DB_NAME = "aura3d-retarget";
+const STORE = "bakes";
+function openDatabase() {
+    return new Promise((resolve, reject) => {
+        const request = indexedDB.open(DB_NAME, 1);
+        request.onupgradeneeded = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains(STORE))
+                db.createObjectStore(STORE);
+        };
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error ?? new Error("IndexedDB open failed"));
+    });
+}
+/** Cache-key component: skeleton joint names + rest pose + clip identity. */
+export function retargetSkeletonHash(skeleton) {
+    const rest = skeleton.restPose;
+    return fnv1a(`${skeleton.boneCount}|${skeleton.jointNames.join(",")}|${skeleton.parentIndices.join(",")}` +
+        `|${floatDigest(rest.positions)}|${floatDigest(rest.rotations)}|${floatDigest(rest.scales)}`);
+}
+/** Cache-key component: clip names + durations + track count + key times. */
+export function retargetClipsHash(clips) {
+    let acc = "";
+    for (const [name, clip] of clips) {
+        const tracks = clip.tracks.map((t) => `${t.target}:${t.valueType}:${t.keyframeCount}:${t.times[0] ?? 0}-${t.times[t.keyframeCount - 1] ?? 0}`);
+        acc += `${name}|${clip.duration}|${tracks.join(";")}\n`;
+    }
+    return fnv1a(acc);
+}
+export function retargetCacheKey(engineVersion, sourceHash, targetHash) {
+    return `${engineVersion}|${sourceHash}|${targetHash}`;
+}
+/** Read a cached bake, or `undefined` when absent/unavailable. */
+export async function readRetargetCache(key) {
+    if (typeof indexedDB === "undefined")
+        return undefined;
+    try {
+        const db = await openDatabase();
+        try {
+            return await new Promise((resolve) => {
+                const tx = db.transaction(STORE, "readonly");
+                const request = tx.objectStore(STORE).get(key);
+                request.onsuccess = () => resolve(request.result);
+                request.onerror = () => resolve(undefined);
+            });
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Write a bake; fire-and-forget safe (storage failures are ignored). */
+export async function writeRetargetCache(key, clips) {
+    if (typeof indexedDB === "undefined")
+        return;
+    try {
+        const db = await openDatabase();
+        try {
+            await new Promise((resolve) => {
+                const tx = db.transaction(STORE, "readwrite");
+                tx.objectStore(STORE).put(clips, key);
+                tx.oncomplete = () => resolve();
+                tx.onerror = () => resolve();
+            });
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        /* cache is best-effort */
+    }
+}
+function floatDigest(values) {
+    // 64-bit-ish digest over rounded floats — cheap and stable across sessions.
+    let h = 0;
+    for (let i = 0; i < values.length; i += 1) {
+        h = (h * 33 + Math.round(values[i] * 4096)) | 0;
+    }
+    return h.toString(36);
+}
+function fnv1a(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i += 1) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
+//# sourceMappingURL=RetargetCache.js.map

package/dist/pose/RetargetCache.js.map

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

package/dist/pose/RetargetWorker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * T3.8 (PRD-06 §7.2) — worker-side retarget baking plumbing. `createRetargetWorker`
+ * returns a module `Worker` bound to `retarget.worker.js` (the emitted JS;
+ * bundlers resolve the `new URL(..., import.meta.url)` form); Node/test
+ * environments get `undefined` and callers fall back to an in-process bake.
+ */
+import type { CompiledClip } from "./CompiledClip.js";
+import type { SkeletonBinding } from "./SkeletonBinding.js";
+import type { BakeRetargetedClipsOptions } from "./Retarget.js";
+export declare function createRetargetWorker(): Worker | undefined;
+/**
+ * Run one bake on `worker`. The worker is single-use: it is terminated after
+ * the response so a caller-side leak can't accumulate bake threads.
+ */
+export declare function bakeClipsInWorker(worker: Worker, request: {
+    readonly sourceSkeleton: SkeletonBinding;
+    readonly targetSkeleton: SkeletonBinding;
+    readonly clips: ReadonlyMap<string, CompiledClip>;
+    readonly options?: BakeRetargetedClipsOptions;
+}): Promise<ReadonlyMap<string, CompiledClip>>;
+//# sourceMappingURL=RetargetWorker.d.ts.map

package/dist/pose/RetargetWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetargetWorker.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/pose/RetargetWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAGhE,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAOzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IACP,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;CAC/C,GACA,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAgC5C"}

package/dist/pose/RetargetWorker.js

@@ -0,0 +1,56 @@
+/**
+ * T3.8 (PRD-06 §7.2) — worker-side retarget baking plumbing. `createRetargetWorker`
+ * returns a module `Worker` bound to `retarget.worker.js` (the emitted JS;
+ * bundlers resolve the `new URL(..., import.meta.url)` form); Node/test
+ * environments get `undefined` and callers fall back to an in-process bake.
+ */
+export function createRetargetWorker() {
+    if (typeof Worker === "undefined")
+        return undefined;
+    try {
+        return new Worker(new URL("./retarget.worker.js", import.meta.url), { type: "module" });
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Run one bake on `worker`. The worker is single-use: it is terminated after
+ * the response so a caller-side leak can't accumulate bake threads.
+ */
+export function bakeClipsInWorker(worker, request) {
+    return new Promise((resolve, reject) => {
+        const requestId = Math.floor(Math.random() * 0xffffffff);
+        const done = (fn) => {
+            worker.onmessage = null;
+            worker.onerror = null;
+            worker.terminate();
+            fn();
+        };
+        worker.onmessage = (event) => {
+            const response = event.data;
+            if (response.requestId !== requestId)
+                return;
+            const clips = response.clips;
+            if (response.kind === "baked" && clips !== undefined) {
+                done(() => resolve(clips));
+            }
+            else {
+                done(() => reject(new Error(response.error ?? "retarget worker bake failed")));
+            }
+        };
+        worker.onerror = (event) => {
+            done(() => reject(new Error(event.message || "retarget worker error")));
+        };
+        const request_ = {
+            kind: "bake",
+            requestId,
+            sourceSkeleton: request.sourceSkeleton,
+            targetSkeleton: request.targetSkeleton,
+            clips: request.clips,
+            ...(request.options !== undefined ? { options: request.options } : {})
+        };
+        worker.postMessage(request_);
+    });
+}
+//# sourceMappingURL=RetargetWorker.js.map

package/dist/pose/RetargetWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetargetWorker.js","sourceRoot":"","sources":["../../../../../packages/animation/src/pose/RetargetWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,OAKC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,CAAC,EAAc,EAAE,EAAE;YAC9B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,MAAM,CAAC,SAAS,EAAE,CAAC;YACnB,EAAE,EAAE,CAAC;QACP,CAAC,CAAC;QACF,MAAM,CAAC,SAAS,GAAG,CAAC,KAA2C,EAAE,EAAE;YACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;YAC5B,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO;YAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YAC7B,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACrD,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,6BAA6B,CAAC,CAAC,CAAC,CAAC;YACjF,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;YACzB,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC;QACF,MAAM,QAAQ,GAA0B;YACtC,IAAI,EAAE,MAAM;YACZ,SAAS;YACT,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvE,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/pose/SkeletonBinding.d.ts

@@ -0,0 +1,55 @@
+/**
+ * PRD-06 T1.1 — binds a glTF skin to the live node list by **node index**.
+ *
+ * `jointNames` are debug/diagnostic only: rigs with duplicate bone names
+ * (Mixamo `Spine` reused for a twist joint, symmetric helpers, generated
+ * rigs) bind every joint correctly because resolution goes through the
+ * skin's `joints[]` node indices, never a name map.
+ *
+ * The binding captures the **rest pose**: the nodes' local TRS at bind time.
+ * The PoseMixer starts each evaluation from it (§6.3), which is what
+ * three r185 `PropertyBinding` treats as "original state".
+ */
+import type { Quat, Vec3 } from "../Keyframe.js";
+import { type PoseBuffer } from "./PoseBuffer.js";
+/** Structural node view the binding needs — keeps this module scene-free. */
+export interface SkeletonNodeRef {
+    readonly name: string;
+    /** Local TRS at bind time (glTF node local transform). */
+    readonly position: Vec3;
+    readonly rotation: Quat;
+    readonly scale: Vec3;
+}
+export interface BindSkeletonOptions {
+    /** glTF skin `joints[]` — node indices in skin order. */
+    readonly joints: readonly number[];
+    /** Optional node-index → node lookup. Supply it for every skeleton bind. */
+    readonly resolveNode: (nodeIndex: number) => SkeletonNodeRef | undefined;
+    /** Diagnostic names, in the same order as `joints` (glTF `jointNames`). */
+    readonly jointNames?: readonly string[];
+    /**
+     * Parent **joint** index per joint (-1 for skin roots), from
+     * `skin.skeleton.bones[i].parentIndex`. Needed by `BoneMask`
+     * `{bone, descendants}` selectors.
+     */
+    readonly parentIndices?: readonly number[];
+}
+export interface SkeletonBinding {
+    readonly boneCount: number;
+    /** Resolved bones in skin joint order. */
+    readonly joints: readonly SkeletonNodeRef[];
+    /** Node index (`joints[i]` input) per joint — the identity that resolved it. */
+    readonly jointNodeIndices: readonly number[];
+    /** Diagnostic names, aligned with `joints`. */
+    readonly jointNames: readonly string[];
+    /** Parent joint index per joint (-1 when unknown or a skin root). */
+    readonly parentIndices: readonly number[];
+    /** Name → joint indices; a duplicated name maps to *all* its slots. */
+    readonly jointIndicesByName: ReadonlyMap<string, readonly number[]>;
+    /** Local TRS at bind time; the mixer's evaluation base. */
+    readonly restPose: PoseBuffer;
+    /** Node indices named in `joints` that `resolveNode` could not find. */
+    readonly missingNodeIndices: readonly number[];
+}
+export declare function bindSkeleton(options: BindSkeletonOptions): SkeletonBinding;
+//# sourceMappingURL=SkeletonBinding.d.ts.map

package/dist/pose/SkeletonBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkeletonBinding.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/pose/SkeletonBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IACzE,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACpE,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,eAAe,CA8C1E"}

package/dist/pose/SkeletonBinding.js

@@ -0,0 +1,62 @@
+/**
+ * PRD-06 T1.1 — binds a glTF skin to the live node list by **node index**.
+ *
+ * `jointNames` are debug/diagnostic only: rigs with duplicate bone names
+ * (Mixamo `Spine` reused for a twist joint, symmetric helpers, generated
+ * rigs) bind every joint correctly because resolution goes through the
+ * skin's `joints[]` node indices, never a name map.
+ *
+ * The binding captures the **rest pose**: the nodes' local TRS at bind time.
+ * The PoseMixer starts each evaluation from it (§6.3), which is what
+ * three r185 `PropertyBinding` treats as "original state".
+ */
+import { createPoseBuffer } from "./PoseBuffer.js";
+export function bindSkeleton(options) {
+    const { joints, resolveNode, jointNames, parentIndices } = options;
+    const boneCount = joints.length;
+    const nodes = [];
+    const names = [];
+    const missing = [];
+    const indicesByName = new Map();
+    const restPose = createPoseBuffer(boneCount);
+    for (let index = 0; index < boneCount; index += 1) {
+        const nodeIndex = joints[index];
+        const node = resolveNode(nodeIndex);
+        const name = node?.name ?? jointNames?.[index] ?? `joint${nodeIndex}`;
+        nodes.push(node ?? { name, position: [0, 0, 0], rotation: [0, 0, 0, 1], scale: [1, 1, 1] });
+        names.push(name);
+        if (!node) {
+            missing.push(nodeIndex);
+        }
+        else {
+            restPose.positions[index * 3] = node.position[0];
+            restPose.positions[index * 3 + 1] = node.position[1];
+            restPose.positions[index * 3 + 2] = node.position[2];
+            restPose.rotations[index * 4] = node.rotation[0];
+            restPose.rotations[index * 4 + 1] = node.rotation[1];
+            restPose.rotations[index * 4 + 2] = node.rotation[2];
+            restPose.rotations[index * 4 + 3] = node.rotation[3];
+            restPose.scales[index * 3] = node.scale[0];
+            restPose.scales[index * 3 + 1] = node.scale[1];
+            restPose.scales[index * 3 + 2] = node.scale[2];
+        }
+        const bucket = indicesByName.get(name);
+        if (bucket)
+            bucket.push(index);
+        else
+            indicesByName.set(name, [index]);
+    }
+    return {
+        boneCount,
+        joints: nodes,
+        jointNodeIndices: [...joints],
+        jointNames: names,
+        parentIndices: parentIndices
+            ? [...parentIndices]
+            : new Array(boneCount).fill(-1),
+        jointIndicesByName: indicesByName,
+        restPose,
+        missingNodeIndices: missing
+    };
+}
+//# sourceMappingURL=SkeletonBinding.js.map

package/dist/pose/SkeletonBinding.js.map

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

package/dist/pose/blendKernels.d.ts

@@ -0,0 +1,32 @@
+/**
+ * T1.11 (PRD-06 §10) — value-level r185 blend kernels, the `AnimationValue`
+ * twins of {@link PoseMixer}'s flat-buffer math (`accumulate` incremental mix,
+ * `accumulateAdditiveAccu`, `applyAdditiveAccumulators`). The legacy
+ * `AnimationMixer` facade routes `blendBase`/`additiveContribution` through
+ * these under `A3D_QR_ANIMATION_POSE_MIXER` so the pose implementation is the
+ * single source of the math; with the flag off the facade keeps its own
+ * (identical) bodies until flag removal.
+ */
+import { type AnimationValue } from "../Keyframe.js";
+export type PoseBlendChannel = "scalar" | "vector3" | "quaternion" | "number-array";
+export interface PoseBlendAccumulatorLike {
+    value: AnimationValue;
+    weight: number;
+}
+/** r185 incremental base accumulate: `acc = mix(acc, v, w/(Σ + w))`. */
+export declare function blendBaseValue(current: PoseBlendAccumulatorLike, channel: string, value: AnimationValue, weight: number): void;
+/**
+ * r185 additive contribution: vectors/scalars `v * w`; quaternions
+ * `slerp(identity, normalize(v), w)` — a single step of the chained
+ * `slerp(acc, acc·delta, w)` in `PoseMixer.accumulateAdditiveAccu`.
+ */
+export declare function additiveContributionValue(channel: string, value: AnimationValue, weight: number): AnimationValue;
+/**
+ * r185 additive apply: `out = base + delta` for vectors/scalars;
+ * `out = normalize(base · delta)` for quaternions (weights already folded into
+ * `delta` by {@link additiveContributionValue}).
+ */
+export declare function applyAdditiveValue(channel: string, base: AnimationValue, delta: AnimationValue): AnimationValue;
+/** Fold a new additive contribution into a running accumulator. */
+export declare function combineAdditiveValue(channel: string, current: AnimationValue, value: AnimationValue, weight: number): AnimationValue;
+//# sourceMappingURL=blendKernels.d.ts.map

package/dist/pose/blendKernels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blendKernels.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/pose/blendKernels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAiD,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpG,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,GACb,IAAI,CAsBN;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAehH;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,GAAG,cAAc,CAqB/G;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAEpI"}

package/dist/pose/blendKernels.js

@@ -0,0 +1,101 @@
+/**
+ * T1.11 (PRD-06 §10) — value-level r185 blend kernels, the `AnimationValue`
+ * twins of {@link PoseMixer}'s flat-buffer math (`accumulate` incremental mix,
+ * `accumulateAdditiveAccu`, `applyAdditiveAccumulators`). The legacy
+ * `AnimationMixer` facade routes `blendBase`/`additiveContribution` through
+ * these under `A3D_QR_ANIMATION_POSE_MIXER` so the pose implementation is the
+ * single source of the math; with the flag off the facade keeps its own
+ * (identical) bodies until flag removal.
+ */
+import { cloneAnimationValue, normalizeQuat, slerpQuat } from "../Keyframe.js";
+/** r185 incremental base accumulate: `acc = mix(acc, v, w/(Σ + w))`. */
+export function blendBaseValue(current, channel, value, weight) {
+    const total = current.weight + weight;
+    const t = weight / total;
+    if (channel === "scalar") {
+        current.value = current.value + (value - current.value) * t;
+    }
+    else if (channel === "vector3") {
+        const a = current.value;
+        const b = value;
+        current.value = [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t, a[2] + (b[2] - a[2]) * t];
+    }
+    else if (channel === "quaternion") {
+        current.value = slerpQuat(current.value, value, t);
+    }
+    else if (channel === "number-array") {
+        const a = current.value;
+        const b = value;
+        if (a.length !== b.length) {
+            throw new Error("Cannot blend number-array animation values with different lengths.");
+        }
+        current.value = a.map((component, index) => component + (b[index] - component) * t);
+    }
+    else {
+        current.value = cloneAnimationValue(value);
+    }
+    current.weight = total;
+}
+/**
+ * r185 additive contribution: vectors/scalars `v * w`; quaternions
+ * `slerp(identity, normalize(v), w)` — a single step of the chained
+ * `slerp(acc, acc·delta, w)` in `PoseMixer.accumulateAdditiveAccu`.
+ */
+export function additiveContributionValue(channel, value, weight) {
+    if (channel === "scalar") {
+        return value * weight;
+    }
+    if (channel === "vector3") {
+        const vector = value;
+        return [vector[0] * weight, vector[1] * weight, vector[2] * weight];
+    }
+    if (channel === "number-array") {
+        return value.map((component) => component * weight);
+    }
+    if (channel === "quaternion") {
+        return slerpQuat([0, 0, 0, 1], normalizeQuat(value), weight);
+    }
+    throw new Error("Additive animation layers require numeric, vector, quaternion, or number-array tracks.");
+}
+/**
+ * r185 additive apply: `out = base + delta` for vectors/scalars;
+ * `out = normalize(base · delta)` for quaternions (weights already folded into
+ * `delta` by {@link additiveContributionValue}).
+ */
+export function applyAdditiveValue(channel, base, delta) {
+    if (channel === "scalar") {
+        return base + delta;
+    }
+    if (channel === "vector3") {
+        const a = base;
+        const b = delta;
+        return [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+    }
+    if (channel === "number-array") {
+        const a = base;
+        const b = delta;
+        if (a.length !== b.length) {
+            throw new Error("Cannot add number-array animation values with different lengths.");
+        }
+        return a.map((component, index) => component + b[index]);
+    }
+    if (channel === "quaternion") {
+        return normalizeQuat(multiplyQuatFlat(base, delta));
+    }
+    throw new Error("Additive animation layers require numeric, vector, quaternion, or number-array tracks.");
+}
+/** Fold a new additive contribution into a running accumulator. */
+export function combineAdditiveValue(channel, current, value, weight) {
+    return applyAdditiveValue(channel, current, additiveContributionValue(channel, value, weight));
+}
+function multiplyQuatFlat(a, b) {
+    const [ax, ay, az, aw] = a;
+    const [bx, by, bz, bw] = b;
+    return [
+        aw * bx + ax * bw + ay * bz - az * by,
+        aw * by - ax * bz + ay * bw + az * bx,
+        aw * bz + ax * by - ay * bx + az * bw,
+        aw * bw - ax * bx - ay * by - az * bz
+    ];
+}
+//# sourceMappingURL=blendKernels.js.map

package/dist/pose/blendKernels.js.map

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

package/dist/pose/makeClipAdditive.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PRD-06 T1.4 — convert a clip to additive form by subtracting a reference
+ * pose per track, matching three r185 `AnimationUtils.makeClipAdditive`:
+ *
+ *  - quaternion tracks: `delta = normalize(ref⁻¹ · sample)`
+ *  - translation **and scale** tracks: `delta = sample − ref`
+ *  - scalar/number-array tracks: `delta = sample − ref`
+ *  - boolean/string tracks: passed through (no additive semantics)
+ *
+ * The reference is frame 0 of the same clip by default, or an explicit
+ * `{ clip, time }` pair (e.g. a bind clip). Tracks absent from the reference
+ * clip fall back to their own first keyframe, as three does.
+ */
+import { AnimationClip } from "../AnimationClip.js";
+export type AdditiveReference = number | {
+    readonly clip: AnimationClip;
+    readonly time?: number;
+};
+/** Whether a clip was produced by `makeClipAdditive` (three r185 `clip.blendMode`). */
+export declare function isClipAdditive(clip: AnimationClip): boolean;
+export declare function makeClipAdditive(clip: AnimationClip, reference?: AdditiveReference): AnimationClip;
+//# sourceMappingURL=makeClipAdditive.d.ts.map

package/dist/pose/makeClipAdditive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeClipAdditive.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/pose/makeClipAdditive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAIlG,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,aAAa,CA+BlG"}

package/dist/pose/makeClipAdditive.js

@@ -0,0 +1,101 @@
+/**
+ * PRD-06 T1.4 — convert a clip to additive form by subtracting a reference
+ * pose per track, matching three r185 `AnimationUtils.makeClipAdditive`:
+ *
+ *  - quaternion tracks: `delta = normalize(ref⁻¹ · sample)`
+ *  - translation **and scale** tracks: `delta = sample − ref`
+ *  - scalar/number-array tracks: `delta = sample − ref`
+ *  - boolean/string tracks: passed through (no additive semantics)
+ *
+ * The reference is frame 0 of the same clip by default, or an explicit
+ * `{ clip, time }` pair (e.g. a bind clip). Tracks absent from the reference
+ * clip fall back to their own first keyframe, as three does.
+ */
+import { AnimationClip } from "../AnimationClip.js";
+import { AnimationTrack } from "../AnimationTrack.js";
+const additiveClips = new WeakSet();
+/** Whether a clip was produced by `makeClipAdditive` (three r185 `clip.blendMode`). */
+export function isClipAdditive(clip) {
+    return additiveClips.has(clip);
+}
+export function makeClipAdditive(clip, reference) {
+    const referenceClip = typeof reference === "object" && reference !== null ? reference.clip : clip;
+    const referenceTime = typeof reference === "number"
+        ? reference
+        : typeof reference === "object" && reference !== null && reference.time !== undefined
+            ? reference.time
+            : 0;
+    const referenceTracks = new Map();
+    for (const track of referenceClip.tracks)
+        referenceTracks.set(track.target, track);
+    const tracks = clip.tracks.map((track) => {
+        const referenceTrack = referenceTracks.get(track.target);
+        const referenceValue = referenceTrack
+            ? referenceTrack.sample(referenceTime)
+            : track.keyframes[0].value;
+        const keyframes = track.keyframes.map((keyframe) => ({
+            ...keyframe,
+            value: subtractValue(track.valueType, keyframe.value, referenceValue)
+        }));
+        return new AnimationTrack({ target: track.target, valueType: track.valueType, keyframes });
+    });
+    const additive = new AnimationClip({
+        name: `${clip.name}.additive`,
+        duration: clip.duration,
+        tracks,
+        events: clip.events
+    });
+    additiveClips.add(additive);
+    return additive;
+}
+function subtractValue(valueType, value, reference) {
+    switch (valueType) {
+        case "quaternion": {
+            const r = reference;
+            const q = value;
+            const inv = quatInvertNormalized(r);
+            return quatNormalize(quatMultiply(inv, q));
+        }
+        case "vector3": {
+            const r = reference;
+            const v = value;
+            return [v[0] - r[0], v[1] - r[1], v[2] - r[2]];
+        }
+        case "scalar":
+            return value - reference;
+        case "number-array": {
+            const r = reference;
+            const v = value;
+            return v.map((component, index) => component - (r[index] ?? 0));
+        }
+        case "boolean":
+        case "string":
+            return value;
+        default:
+            return value;
+    }
+}
+function quatInvertNormalized(q) {
+    // Inverse of a unit quaternion is its conjugate; normalize first so
+    // non-unit inputs still produce a true inverse (as three does not need to).
+    const length = Math.hypot(q[0], q[1], q[2], q[3]);
+    if (length <= 1e-9)
+        return [0, 0, 0, 1];
+    const invLengthSq = 1 / (length * length);
+    return [-q[0] * invLengthSq, -q[1] * invLengthSq, -q[2] * invLengthSq, q[3] * invLengthSq];
+}
+function quatMultiply(a, b) {
+    return [
+        a[3] * b[0] + a[0] * b[3] + a[1] * b[2] - a[2] * b[1],
+        a[3] * b[1] - a[0] * b[2] + a[1] * b[3] + a[2] * b[0],
+        a[3] * b[2] + a[0] * b[1] - a[1] * b[0] + a[2] * b[3],
+        a[3] * b[3] - a[0] * b[0] - a[1] * b[1] - a[2] * b[2]
+    ];
+}
+function quatNormalize(q) {
+    const length = Math.hypot(q[0], q[1], q[2], q[3]);
+    if (length <= 1e-9)
+        return [0, 0, 0, 1];
+    return [q[0] / length, q[1] / length, q[2] / length, q[3] / length];
+}
+//# sourceMappingURL=makeClipAdditive.js.map

package/dist/pose/makeClipAdditive.js.map

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

package/dist/pose/poseMixerFlags.d.ts

@@ -0,0 +1,18 @@
+/**
+ * T1.11 (PRD-06 §10) — the `A3D_QR_ANIMATION_POSE_MIXER` read for
+ * `@aura3d/animation`. The package cannot import the engine's flag machinery
+ * (dependency direction is engine → animation), so a provider seam is
+ * installed by the app side (lane barrel `packages/engine/src/lanes/prd06.ts`
+ * binds `qrAnimationFlags().on("A3D_QR_ANIMATION_POSE_MIXER")`). Without a
+ * provider the env fallback reads `A3D_QR_ANIMATION_POSE_MIXER` directly.
+ * Multi-word sub-flags cannot appear in the `A3D_QR=` list (the resolver's
+ * short-name form is `lane.sub`, two parts), so the env var and the
+ * `qualityRebuild.flags` record are the only sources — matching
+ * `applyPerFlagEnv` semantics.
+ *
+ * Sub-flag semantics (§10): OFF means the legacy blend math runs unchanged —
+ * the flag being merely unset is not an implicit opt-in.
+ */
+export declare function setPoseMixerBlendFlagProvider(provider: (() => boolean) | undefined): void;
+export declare function poseMixerBlendEnabled(): boolean;
+//# sourceMappingURL=poseMixerFlags.d.ts.map

package/dist/pose/poseMixerFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poseMixerFlags.d.ts","sourceRoot":"","sources":["../../../../../packages/animation/src/pose/poseMixerFlags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAEzF;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAS/C"}