@aura3d/engine 4.0.2 → 4.0.4

package/dist/animation/AnimationUtils.js

@@ -0,0 +1,202 @@
+import { AnimationClip } from "./AnimationClip.js";
+import { AnimationTrack } from "./AnimationTrack.js";
+import { cloneAnimationValue } from "./Keyframe.js";
+import { isClipAdditive, makeClipAdditive } from "./pose/makeClipAdditive.js";
+export { isClipAdditive, makeClipAdditive };
+/**
+ * SA-06 — three-compatible `AnimationUtils` (`three@0.185.x
+ * src/animation/AnimationUtils.js` + `KeyframeTrack.optimize`) adapted to
+ * Aura's keyframe-object tracks. All helpers return new immutable clips —
+ * tracks are never mutated in place.
+ */
+export function arraySlice(array, from, to) {
+    const result = new Array(to - from);
+    for (let i = from, j = 0; i !== to; ++i, ++j) {
+        result[j] = array[i];
+    }
+    return result;
+}
+export function convertArray(array) {
+    return Array.isArray(array) ? array : arraySlice(array, 0, array.length);
+}
+export function isTypedArray(object) {
+    return ArrayBuffer.isView(object) && !(object instanceof DataView);
+}
+/** Same order as three's `AnimationUtils.getKeyframeOrder` (stable sort). */
+export function getKeyframeOrder(times) {
+    const indexes = new Array(times.length);
+    for (let i = 0; i !== indexes.length; ++i) {
+        indexes[i] = i;
+    }
+    return indexes.sort((a, b) => times[a] - times[b]);
+}
+/** Reorders `values` (flat, `stride` components per element) by `sortedKeys`. */
+export function sortedArray(values, stride, sortedKeys) {
+    const count = values.length / stride;
+    const result = (Array.isArray(values) ? new Array(values.length) : new values.constructor(values.length));
+    for (let i = 0; i !== count; ++i) {
+        const index = sortedKeys[i] * stride;
+        for (let j = 0; j !== stride; ++j) {
+            result[i * stride + j] = values[index + j];
+        }
+    }
+    return result;
+}
+/**
+ * three's `AnimationUtils.subclip`: keeps the keyframes whose clip time falls
+ * inside `[startFrame, endFrame)` (converted through `fps`), drops tracks left
+ * empty, and shifts every kept keyframe (and clip event) by `-startFrame/fps`
+ * so the subclip starts at 0.
+ */
+export function subclip(sourceClip, name, startFrame, endFrame, fps = 30) {
+    if (!(sourceClip instanceof AnimationClip)) {
+        throw new Error("AnimationUtils.subclip: sourceClip must be an AnimationClip.");
+    }
+    if (!Number.isFinite(startFrame) || !Number.isFinite(endFrame) || endFrame <= startFrame) {
+        throw new Error(`AnimationUtils.subclip: expected endFrame > startFrame >= 0, got [${startFrame}, ${endFrame}].`);
+    }
+    if (!Number.isFinite(fps) || fps <= 0) {
+        throw new Error(`AnimationUtils.subclip: fps must be a positive finite number, got ${fps}.`);
+    }
+    const clip = AnimationClip.fromJSON(sourceClip.toJSON());
+    const startTime = startFrame / fps;
+    const endTime = endFrame / fps;
+    const tracks = [];
+    for (const track of clip.tracks) {
+        const keyframes = track.keyframes.filter((keyframe) => {
+            const frame = keyframe.time * fps;
+            return frame >= startFrame && frame < endFrame;
+        });
+        if (keyframes.length === 0) {
+            continue;
+        }
+        tracks.push(new AnimationTrack({
+            target: track.target,
+            valueType: track.valueType,
+            keyframes: keyframes.map((keyframe) => ({ ...keyframe, time: keyframe.time - startTime }))
+        }));
+    }
+    const events = clip.events
+        .filter((event) => event.time >= startTime && event.time < endTime)
+        .map((event) => ({ ...event, time: event.time - startTime }));
+    return new AnimationClip({ name, tracks, events });
+}
+function valuesEqual(a, b) {
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length) {
+            return false;
+        }
+        for (let i = 0; i < a.length; i++) {
+            if (a[i] !== b[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    return a === b;
+}
+/**
+ * three's `KeyframeTrack.optimize` lifted to whole clips: interior keyframes
+ * whose value equals both neighbors are redundant under linear/step
+ * interpolation and are removed. `cubicspline` keys are always preserved —
+ * removing them would change the curve through their tangents. The first and
+ * last keys are always kept. Returns a new clip.
+ */
+export function optimize(clip) {
+    if (!(clip instanceof AnimationClip)) {
+        throw new Error("AnimationUtils.optimize: clip must be an AnimationClip.");
+    }
+    const tracks = clip.tracks.map((track) => {
+        const keyframes = track.keyframes;
+        if (keyframes.length <= 2) {
+            return track;
+        }
+        const kept = [keyframes[0]];
+        for (let i = 1; i < keyframes.length - 1; i++) {
+            const previous = kept[kept.length - 1];
+            const current = keyframes[i];
+            const next = keyframes[i + 1];
+            if (current.interpolation === "cubicspline" || next.interpolation === "cubicspline") {
+                kept.push(current);
+                continue;
+            }
+            if (valuesEqual(current.value, previous.value) && valuesEqual(current.value, next.value)) {
+                continue;
+            }
+            kept.push(current);
+        }
+        kept.push(keyframes[keyframes.length - 1]);
+        return new AnimationTrack({ target: track.target, valueType: track.valueType, keyframes: kept });
+    });
+    return new AnimationClip({
+        name: clip.name,
+        duration: clip.duration,
+        tracks,
+        events: clip.events.map((event) => ({ ...event }))
+    });
+}
+/**
+ * Sequential clip concatenation: each clip's tracks (and events) are shifted
+ * by the accumulated duration of the clips before it. Tracks that share a
+ * `target`+`valueType` are joined into one; a later clip's first keyframe that
+ * lands exactly on the previous clip's boundary is dropped so the join stays
+ * continuous. Distinct targets appear side by side.
+ */
+export function merge(clips, name = "merged") {
+    if (clips.length === 0) {
+        throw new Error("AnimationUtils.merge: at least one clip is required.");
+    }
+    for (const clip of clips) {
+        if (!(clip instanceof AnimationClip)) {
+            throw new Error("AnimationUtils.merge: every entry must be an AnimationClip.");
+        }
+    }
+    const mergedTracks = new Map();
+    const events = [];
+    let offset = 0;
+    for (const clip of clips) {
+        for (const track of clip.tracks) {
+            const key = `${track.target}${track.valueType}`;
+            const entry = mergedTracks.get(key) ?? { target: track.target, valueType: track.valueType, keyframes: [] };
+            if (!mergedTracks.has(key)) {
+                mergedTracks.set(key, entry);
+            }
+            const boundaryTime = entry.keyframes.length > 0 ? entry.keyframes[entry.keyframes.length - 1].time : -1;
+            for (const keyframe of track.keyframes) {
+                const shifted = keyframe.time + offset;
+                if (shifted === boundaryTime) {
+                    // Keep the existing boundary value for a continuous join.
+                    continue;
+                }
+                entry.keyframes.push({ ...keyframe, time: shifted, value: cloneAnimationValue(keyframe.value) });
+            }
+        }
+        for (const event of clip.events) {
+            events.push({ ...event, time: event.time + offset });
+        }
+        offset += clip.duration;
+    }
+    const tracks = [...mergedTracks.values()].map((entry) => new AnimationTrack({
+        target: entry.target,
+        valueType: entry.valueType,
+        keyframes: entry.keyframes
+    }));
+    return new AnimationClip({ name, duration: offset, tracks, events });
+}
+/**
+ * Namespace twin of three's `THREE.AnimationUtils`, for callers porting code
+ * that references the utility as an object.
+ */
+export const AnimationUtils = {
+    arraySlice,
+    convertArray,
+    isTypedArray,
+    getKeyframeOrder,
+    sortedArray,
+    subclip,
+    optimize,
+    merge,
+    makeClipAdditive,
+    isClipAdditive
+};
+//# sourceMappingURL=AnimationUtils.js.map

package/dist/animation/AnimationUtils.js.map

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

package/dist/animation/PropertyBinding.d.ts

@@ -0,0 +1,93 @@
+import type { AnimationValue } from "./Keyframe.js";
+export interface ParsedTrackName {
+    /** Directory prefix (`parent/child/` or `scene:name:`) — parsed but unused, matching three. */
+    readonly directoryName?: string;
+    readonly nodeName?: string;
+    readonly objectName?: string;
+    readonly objectIndex?: string;
+    readonly propertyName: string;
+    readonly propertyIndex?: string;
+}
+/**
+ * Node shape `PropertyBinding` can bind to — structurally compatible with
+ * `SceneAnimationNode`, `SceneNode`, and three-style duck-typed objects.
+ */
+export interface PropertyBindingNode {
+    name?: string;
+    uuid?: string;
+    children?: readonly PropertyBindingNode[];
+    skeleton?: {
+        bones?: readonly PropertyBindingNode[];
+        getBoneByName?: (name: string) => PropertyBindingNode | undefined;
+    };
+    material?: unknown;
+    map?: unknown;
+    morphTargetDictionary?: Record<string, number> | (() => Record<string, number>);
+    morphTargetInfluences?: number[];
+    needsUpdate?: boolean;
+    matrixWorldNeedsUpdate?: boolean;
+    [key: string]: unknown;
+}
+export interface AnimationObjectGroupLike {
+    readonly isAnimationObjectGroup: true;
+    readonly nCachedObjects_: number;
+    subscribe_: (path: string, parsedPath?: ParsedTrackName) => readonly PropertyBindingLike[];
+}
+export interface PropertyBindingLike {
+    bind(): void;
+    unbind(): void;
+    getValue(): AnimationValue | undefined;
+    setValue(value: AnimationValue): void;
+}
+export declare function parseTrackName(trackName: string): ParsedTrackName;
+export declare function sanitizeNodeName(name: string): string;
+export declare function findNode(root: PropertyBindingNode, nodeName: string | number | undefined): PropertyBindingNode | null;
+/**
+ * Binds a parsed track path to a concrete property on a node resolved from
+ * `rootNode`. `getValue`/`setValue` read and write `AnimationValue`s; on
+ * failure to bind they become no-ops (three's unbound state).
+ */
+export declare class PropertyBinding {
+    static parseTrackName: typeof parseTrackName;
+    static sanitizeNodeName: typeof sanitizeNodeName;
+    static findNode: typeof findNode;
+    /** three's `PropertyBinding.Composite` (lazy so the class can be declared below). */
+    static get Composite(): typeof PropertyBindingComposite;
+    readonly path: string;
+    readonly parsedPath: ParsedTrackName;
+    readonly rootNode: PropertyBindingNode;
+    node: PropertyBindingNode | null;
+    targetObject: PropertyBindingNode | undefined;
+    resolvedProperty: unknown;
+    propertyName: string | undefined;
+    propertyIndex: string | number | undefined;
+    private bound;
+    constructor(rootNode: PropertyBindingNode, path: string, parsedPath?: ParsedTrackName);
+    /**
+     * Factory matching three's `PropertyBinding.create`: a root marked
+     * `isAnimationObjectGroup` produces a composite binding shared across the
+     * group's objects.
+     */
+    static create(root: PropertyBindingNode | AnimationObjectGroupLike, path: string, parsedPath?: ParsedTrackName): PropertyBindingLike;
+    bind(): void;
+    unbind(): void;
+    getValue(): AnimationValue | undefined;
+    setValue(value: AnimationValue): void;
+    private bindingType;
+    private versioning;
+}
+/**
+ * three's `PropertyBinding.Composite`: fans a single track path out over every
+ * object in an {@link AnimationObjectGroup}-compatible group. `getValue` reads
+ * the first valid object; `setValue` writes all valid objects.
+ */
+export declare class PropertyBindingComposite implements PropertyBindingLike {
+    private readonly targetGroup;
+    private readonly bindings;
+    constructor(targetGroup: AnimationObjectGroupLike, path: string, optionalParsedPath?: ParsedTrackName);
+    getValue(): AnimationValue | undefined;
+    setValue(value: AnimationValue): void;
+    bind(): void;
+    unbind(): void;
+}
+//# sourceMappingURL=PropertyBinding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyBinding.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/PropertyBinding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAuCpD,MAAM,WAAW,eAAe;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;QACvC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,mBAAmB,GAAG,SAAS,CAAC;KACnE,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChF,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,sBAAsB,EAAE,IAAI,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,KAAK,SAAS,mBAAmB,EAAE,CAAC;CAC5F;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,IAAI,cAAc,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAsCjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,IAAI,CA4BrH;AA8BD;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,MAAM,CAAC,cAAc,wBAAkB;IACvC,MAAM,CAAC,gBAAgB,0BAAoB;IAC3C,MAAM,CAAC,QAAQ,kBAAY;IAC3B,qFAAqF;IACrF,MAAM,KAAK,SAAS,IAAI,OAAO,wBAAwB,CAEtD;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC9C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAS;gBAEV,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe;IAOrF;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,wBAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,mBAAmB;IAOpI,IAAI,IAAI,IAAI;IA+IZ,MAAM,IAAI,IAAI;IAKd,QAAQ,IAAI,cAAc,GAAG,SAAS;IAsBtC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAiCrC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,UAAU,CAA+B;CAClD;AAOD;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;gBAE9C,WAAW,EAAE,wBAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,eAAe;IAMrG,QAAQ,IAAI,cAAc,GAAG,SAAS;IAOtC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAOrC,IAAI,IAAI,IAAI;IAOZ,MAAM,IAAI,IAAI;CAMf"}