@adobe/data-gpu 0.9.69

package/dist/graphics/animation/animation-data-plugin.js

@@ -0,0 +1,110 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database, Entity } from "@adobe/data/ecs";
+import { Boolean, F32, Time, True } from "@adobe/data/schema";
+import { AnimationTrack } from "../animation/animation-track/animation-track.js";
+const animationBase = Database.Plugin.create({
+    components: {
+        animationClipTracks: { default: [] },
+        animationClipDuration: Time.schema,
+        animationClipRef: Entity.schema,
+        animationTargets: { default: [] },
+        animationTime: Time.schema,
+        animationSpeed: { ...F32.schema, default: 1 },
+        animationLoop: Boolean.schema,
+        animationPlaying: Boolean.schema,
+        animationObservable: True.schema,
+    },
+    archetypes: {
+        AnimationClip: ["animationClipTracks", "animationClipDuration"],
+        Animation: [
+            "animationClipRef",
+            "animationTargets",
+            "animationTime",
+            "animationSpeed",
+            "animationLoop",
+            "animationPlaying",
+        ],
+        AnimationObservable: [
+            "animationClipRef",
+            "animationTargets",
+            "animationTime",
+            "animationSpeed",
+            "animationLoop",
+            "animationPlaying",
+            "animationObservable",
+        ],
+    },
+});
+export const animationData = Database.Plugin.create({
+    extends: animationBase,
+    transactions: {
+        insertAnimationClip(t, args) {
+            return t.archetypes.AnimationClip.insert({
+                animationClipTracks: args.tracks,
+                animationClipDuration: args.duration,
+            });
+        },
+        insertAnimation(t, args) {
+            const values = {
+                animationClipRef: args.animationClipRef,
+                animationTargets: args.animationTargets,
+                animationTime: args.animationTime ?? 0,
+                animationSpeed: args.animationSpeed ?? 1,
+                animationLoop: args.animationLoop ?? false,
+                animationPlaying: args.animationPlaying ?? true,
+            };
+            return args.observable
+                ? t.archetypes.AnimationObservable.insert({ ...values, animationObservable: true })
+                : t.archetypes.Animation.insert(values);
+        },
+        advanceAnimations(t, args) {
+            const componentSchemas = t.componentSchemas;
+            const arch = args.observable ? t.archetypes.AnimationObservable : t.archetypes.Animation;
+            const ids = arch.columns.id;
+            const clipRefs = arch.columns.animationClipRef;
+            const targetsCol = arch.columns.animationTargets;
+            const times = arch.columns.animationTime;
+            const speeds = arch.columns.animationSpeed;
+            const loops = arch.columns.animationLoop;
+            const playings = arch.columns.animationPlaying;
+            const { dt } = args;
+            const rowCount = arch.rowCount;
+            for (let i = 0; i < rowCount; i++) {
+                if (!playings.get(i))
+                    continue;
+                const playerId = ids.get(i);
+                const clipId = clipRefs.get(i);
+                const clip = t.read(clipId);
+                if (!clip?.animationClipTracks || !clip.animationClipDuration || clip.animationClipDuration <= 0)
+                    continue;
+                const speed = speeds.get(i);
+                const loop = loops.get(i);
+                const duration = clip.animationClipDuration;
+                let newTime = times.get(i) + dt * speed;
+                if (loop) {
+                    newTime = ((newTime % duration) + duration) % duration;
+                }
+                else if (newTime >= duration) {
+                    newTime = duration;
+                    t.update(playerId, { animationPlaying: false });
+                }
+                else if (newTime < 0) {
+                    newTime = 0;
+                }
+                t.update(playerId, { animationTime: newTime });
+                const targets = targetsCol.get(i);
+                for (const track of clip.animationClipTracks) {
+                    const target = targets[track.targetIndex];
+                    if (target === undefined || target === 0)
+                        continue;
+                    const schema = componentSchemas[track.component];
+                    if (!schema)
+                        continue;
+                    const value = AnimationTrack.sample(track, schema, newTime);
+                    t.update(target, { [track.component]: value });
+                }
+            }
+        },
+    },
+});
+//# sourceMappingURL=animation-data-plugin.js.map

package/dist/graphics/animation/animation-data-plugin.js.map

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

package/dist/graphics/animation/animation-plugin.d.ts

@@ -0,0 +1,214 @@
+import { FrameTime } from "../../core/frame-time/frame-time.js";
+/**
+ * Full animation plugin — declarative data (from `scene/animation-plugin.ts`)
+ * plus the per-frame `animationSampleSystem` that advances all playing entities.
+ *
+ * Exported as `animation` from index.ts. The data-only part lives in
+ * `scene/animation-plugin.ts` and is included in the `scene` aggregator.
+ */
+export declare const animation: {
+    readonly components: {} & {
+        readonly animationClipTracks: {
+            readonly default: import("./animation-track/public.js")[];
+        };
+        readonly animationClipDuration: {
+            readonly type: "number";
+            readonly precision: 2;
+            readonly default: number;
+        };
+        readonly animationClipRef: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly animationTargets: {
+            readonly default: number[];
+        };
+        readonly animationTime: {
+            readonly type: "number";
+            readonly precision: 2;
+            readonly default: number;
+        };
+        readonly animationSpeed: {
+            readonly default: 1;
+            readonly type: "number";
+            readonly precision: 1;
+        };
+        readonly animationLoop: {
+            readonly type: "boolean";
+        };
+        readonly animationPlaying: {
+            readonly type: "boolean";
+        };
+        readonly animationObservable: {
+            readonly type: "boolean";
+            readonly const: true;
+            readonly default: true;
+        };
+    };
+    readonly resources: {} & {
+        readonly frameTime: {
+            readonly default: FrameTime;
+            readonly transient: true;
+        };
+    };
+    readonly archetypes: {} & {
+        readonly AnimationClip: readonly ["animationClipTracks", "animationClipDuration"];
+        readonly Animation: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying"];
+        readonly AnimationObservable: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying", "animationObservable"];
+    } & {};
+    readonly transactions: {} & {} & {
+        readonly insertAnimationClip: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{} & {
+            readonly animationClipTracks: {
+                readonly default: import("./animation-track/public.js")[];
+            };
+            readonly animationClipDuration: {
+                readonly type: "number";
+                readonly precision: 2;
+                readonly default: number;
+            };
+            readonly animationClipRef: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly animationTargets: {
+                readonly default: number[];
+            };
+            readonly animationTime: {
+                readonly type: "number";
+                readonly precision: 2;
+                readonly default: number;
+            };
+            readonly animationSpeed: {
+                readonly default: 1;
+                readonly type: "number";
+                readonly precision: 1;
+            };
+            readonly animationLoop: {
+                readonly type: "boolean";
+            };
+            readonly animationPlaying: {
+                readonly type: "boolean";
+            };
+            readonly animationObservable: {
+                readonly type: "boolean";
+                readonly const: true;
+                readonly default: true;
+            };
+        }>, import("@adobe/data/schema").FromSchemas<{}>, {} & {
+            readonly AnimationClip: readonly ["animationClipTracks", "animationClipDuration"];
+            readonly Animation: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying"];
+            readonly AnimationObservable: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying", "animationObservable"];
+        }, {} & {}>, args: {
+            tracks: import("./animation-track/public.js")[];
+            duration: number;
+        }) => number;
+        readonly insertAnimation: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{} & {
+            readonly animationClipTracks: {
+                readonly default: import("./animation-track/public.js")[];
+            };
+            readonly animationClipDuration: {
+                readonly type: "number";
+                readonly precision: 2;
+                readonly default: number;
+            };
+            readonly animationClipRef: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly animationTargets: {
+                readonly default: number[];
+            };
+            readonly animationTime: {
+                readonly type: "number";
+                readonly precision: 2;
+                readonly default: number;
+            };
+            readonly animationSpeed: {
+                readonly default: 1;
+                readonly type: "number";
+                readonly precision: 1;
+            };
+            readonly animationLoop: {
+                readonly type: "boolean";
+            };
+            readonly animationPlaying: {
+                readonly type: "boolean";
+            };
+            readonly animationObservable: {
+                readonly type: "boolean";
+                readonly const: true;
+                readonly default: true;
+            };
+        }>, import("@adobe/data/schema").FromSchemas<{}>, {} & {
+            readonly AnimationClip: readonly ["animationClipTracks", "animationClipDuration"];
+            readonly Animation: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying"];
+            readonly AnimationObservable: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying", "animationObservable"];
+        }, {} & {}>, args: {
+            animationClipRef: number;
+            animationTargets: number[];
+            animationTime?: number;
+            animationSpeed?: number;
+            animationLoop?: boolean;
+            animationPlaying?: boolean;
+            observable?: boolean;
+        }) => number;
+        readonly advanceAnimations: (t: import("@adobe/data/ecs").Store<import("@adobe/data/schema").FromSchemas<{
+            readonly animationClipTracks: {
+                readonly default: import("./animation-track/public.js")[];
+            };
+            readonly animationClipDuration: {
+                readonly type: "number";
+                readonly precision: 2;
+                readonly default: number;
+            };
+            readonly animationClipRef: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly animationTargets: {
+                readonly default: number[];
+            };
+            readonly animationTime: {
+                readonly type: "number";
+                readonly precision: 2;
+                readonly default: number;
+            };
+            readonly animationSpeed: {
+                readonly default: 1;
+                readonly type: "number";
+                readonly precision: 1;
+            };
+            readonly animationLoop: {
+                readonly type: "boolean";
+            };
+            readonly animationPlaying: {
+                readonly type: "boolean";
+            };
+            readonly animationObservable: {
+                readonly type: "boolean";
+                readonly const: true;
+                readonly default: true;
+            };
+        }>, import("@adobe/data/schema").FromSchemas<{}>, {
+            readonly AnimationClip: readonly ["animationClipTracks", "animationClipDuration"];
+            readonly Animation: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying"];
+            readonly AnimationObservable: readonly ["animationClipRef", "animationTargets", "animationTime", "animationSpeed", "animationLoop", "animationPlaying", "animationObservable"];
+        }, {}>, args: {
+            dt: number;
+            observable: boolean;
+        }) => void;
+    } & {};
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<"_frameTime" | "animationSampleSystem">;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {} & {} & {} & {};
+};

package/dist/graphics/animation/animation-plugin.js

@@ -0,0 +1,26 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { FrameTime } from "../../core/frame-time/frame-time.js";
+import { animationData } from "./animation-data-plugin.js";
+/**
+ * Full animation plugin — declarative data (from `scene/animation-plugin.ts`)
+ * plus the per-frame `animationSampleSystem` that advances all playing entities.
+ *
+ * Exported as `animation` from index.ts. The data-only part lives in
+ * `scene/animation-plugin.ts` and is included in the `scene` aggregator.
+ */
+export const animation = Database.Plugin.create({
+    extends: Database.Plugin.combine(animationData, FrameTime.plugin),
+    systems: {
+        animationSampleSystem: {
+            create: db => () => {
+                const dt = db.store.resources.frameTime.dt;
+                if (dt <= 0)
+                    return;
+                db.transactions.advanceAnimations({ dt, observable: true });
+                animationData.transactions.advanceAnimations(db.store, { dt, observable: false });
+            },
+        },
+    },
+});
+//# sourceMappingURL=animation-plugin.js.map

package/dist/graphics/animation/animation-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-plugin.js","sourceRoot":"","sources":["../../../src/graphics/animation/animation-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC;IACjE,OAAO,EAAE;QACL,qBAAqB,EAAE;YACnB,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE;gBACf,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3C,IAAI,EAAE,IAAI,CAAC;oBAAE,OAAO;gBACpB,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5D,aAAa,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YACtF,CAAC;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/dist/graphics/animation/animation-plugin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/graphics/animation/animation-plugin.test.js

@@ -0,0 +1,142 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { Database } from "@adobe/data/ecs";
+import { F32 } from "@adobe/data/math";
+import { animation } from "./animation-plugin.js";
+function scalarTrack(component, points) {
+    const times = new Float32Array(points.length);
+    const values = new Float32Array(points.length);
+    for (let i = 0; i < points.length; i++) {
+        times[i] = points[i][0];
+        values[i] = points[i][1];
+    }
+    return { targetIndex: 0, component, times, values, interpolation: "linear" };
+}
+function createTestDb() {
+    // The `placeholder` resource exists only to consume entity id 0, which the
+    // animation code treats as a sentinel "no target". In real scenes the
+    // first non-resource entity is never 0 either.
+    return Database.create(Database.Plugin.create({
+        extends: animation,
+        components: {
+            value: F32.schema,
+        },
+        resources: {
+            placeholder: { default: 0 },
+        },
+        archetypes: {
+            Target: ["value"],
+        },
+        transactions: {
+            insertTarget(t) {
+                return t.archetypes.Target.insert({ value: 0 });
+            },
+        },
+    }));
+}
+const linearClip = (db) => db.transactions.insertAnimationClip({
+    tracks: [scalarTrack("value", [[0, 0], [1, 10]])],
+    duration: 1,
+});
+describe("animation.advanceAnimations", () => {
+    it("advances time and writes the sampled value to the target", () => {
+        const db = createTestDb();
+        const targetId = db.transactions.insertTarget();
+        const clipId = linearClip(db);
+        db.transactions.insertAnimation({
+            animationClipRef: clipId,
+            animationTargets: [targetId],
+        });
+        db.transactions.advanceAnimations({ dt: 0.25, observable: false });
+        // 0.25s into a 1s clip linearly interpolating 0→10 → value = 2.5.
+        expect(db.read(targetId)?.value).toBeCloseTo(2.5, 5);
+    });
+    it("loops time within the clip duration", () => {
+        const db = createTestDb();
+        const targetId = db.transactions.insertTarget();
+        const clipId = linearClip(db);
+        db.transactions.insertAnimation({
+            animationClipRef: clipId,
+            animationTargets: [targetId],
+            animationLoop: true,
+        });
+        db.transactions.advanceAnimations({ dt: 2.25, observable: false });
+        // 2.25 % 1 = 0.25 → same sampled value as the first test.
+        expect(db.read(targetId)?.value).toBeCloseTo(2.5, 5);
+    });
+    it("stops a non-looping player when it reaches duration", () => {
+        const db = createTestDb();
+        const targetId = db.transactions.insertTarget();
+        const clipId = linearClip(db);
+        const playerId = db.transactions.insertAnimation({
+            animationClipRef: clipId,
+            animationTargets: [targetId],
+            animationLoop: false,
+        });
+        db.transactions.advanceAnimations({ dt: 2, observable: false });
+        const player = db.read(playerId);
+        expect(player?.animationTime).toBe(1);
+        expect(player?.animationPlaying).toBe(false);
+    });
+    it("only touches players whose animationObservable flag matches the args", () => {
+        const db = createTestDb();
+        const observableTarget = db.transactions.insertTarget();
+        const directTarget = db.transactions.insertTarget();
+        const clipId = linearClip(db);
+        db.transactions.insertAnimation({
+            animationClipRef: clipId,
+            animationTargets: [observableTarget],
+            observable: true,
+        });
+        db.transactions.insertAnimation({
+            animationClipRef: clipId,
+            animationTargets: [directTarget],
+        });
+        // observable: true touches only the flagged player.
+        db.transactions.advanceAnimations({ dt: 0.5, observable: true });
+        expect(db.read(observableTarget)?.value).toBeCloseTo(5, 5);
+        expect(db.read(directTarget)?.value).toBe(0);
+        // observable: false touches only the non-flagged player.
+        db.transactions.advanceAnimations({ dt: 0.5, observable: false });
+        expect(db.read(directTarget)?.value).toBeCloseTo(5, 5);
+    });
+    it("fires entity observers for the observable path and skips them for the direct path", () => {
+        const db = createTestDb();
+        const observableTarget = db.transactions.insertTarget();
+        const directTarget = db.transactions.insertTarget();
+        const clipId = linearClip(db);
+        db.transactions.insertAnimation({
+            animationClipRef: clipId,
+            animationTargets: [observableTarget],
+            observable: true,
+        });
+        db.transactions.insertAnimation({
+            animationClipRef: clipId,
+            animationTargets: [directTarget],
+        });
+        const observableNotifications = [];
+        const directNotifications = [];
+        db.observe.entity(observableTarget)(v => { if (v)
+            observableNotifications.push(v.value); });
+        db.observe.entity(directTarget)(v => { if (v)
+            directNotifications.push(v.value); });
+        // Drop the initial-value notifications.
+        observableNotifications.length = 0;
+        directNotifications.length = 0;
+        // Observable path: writes flow through the transaction → observers fire.
+        db.transactions.advanceAnimations({ dt: 0.5, observable: true });
+        expect(observableNotifications.length).toBeGreaterThan(0);
+        expect(directNotifications.length).toBe(0);
+        // Direct path: same `advanceAnimations` body, but with the raw store
+        // as `t`. Underlying value changes; observers must stay silent.
+        // (`db.store` is exposed at runtime but not on the public Database
+        // type — systems get a `Database & { store }` view; tests reach in.)
+        const directStore = db.store;
+        const before = db.read(directTarget)?.value;
+        animation.transactions.advanceAnimations(directStore, { dt: 0.5, observable: false });
+        const after = db.read(directTarget)?.value;
+        expect(after).not.toBe(before);
+        expect(directNotifications.length).toBe(0);
+    });
+});
+//# sourceMappingURL=animation-plugin.test.js.map

package/dist/graphics/animation/animation-plugin.test.js.map

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

package/dist/graphics/animation/animation-track/animation-track.d.ts

@@ -0,0 +1,13 @@
+import type { InterpolationMode } from "../interpolation-mode/interpolation-mode.js";
+export interface AnimationTrack {
+    /** Index into the AnimationPlayer's animationTargets array. */
+    readonly targetIndex: number;
+    /** Component name to write on the resolved target entity. */
+    readonly component: string;
+    /** Sorted keyframe timestamps. */
+    readonly times: Float32Array;
+    /** Packed keyframe values (componentsPerKey * times.length entries). */
+    readonly values: Float32Array;
+    readonly interpolation: InterpolationMode;
+}
+export * as AnimationTrack from "./public.js";

package/dist/graphics/animation/animation-track/animation-track.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * as AnimationTrack from "./public.js";
+//# sourceMappingURL=animation-track.js.map

package/dist/graphics/animation/animation-track/animation-track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-track.js","sourceRoot":"","sources":["../../../../src/graphics/animation/animation-track/animation-track.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAgBvD,OAAO,KAAK,cAAc,MAAM,aAAa,CAAC"}

package/dist/graphics/animation/animation-track/componentwise-lerp.d.ts

@@ -0,0 +1,7 @@
+import type { Schema } from "@adobe/data/schema";
+/**
+ * Default linear interpolation when a schema does not declare its own
+ * `interpolators.linear`. Walks the schema once and lerps numeric leaves.
+ * Supports `type: "number"` scalars and `type: "array"` of numbers.
+ */
+export declare function componentwiseLerp(schema: Schema, prev: any, next: any, t: number): any;

package/dist/graphics/animation/animation-track/componentwise-lerp.js

@@ -0,0 +1,22 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Default linear interpolation when a schema does not declare its own
+ * `interpolators.linear`. Walks the schema once and lerps numeric leaves.
+ * Supports `type: "number"` scalars and `type: "array"` of numbers.
+ */
+export function componentwiseLerp(schema, prev, next, t) {
+    if (schema.type === "number") {
+        return prev + (next - prev) * t;
+    }
+    if (schema.type === "array") {
+        const n = prev.length;
+        const out = new Array(n);
+        const itemSchema = schema.items ?? { type: "number" };
+        for (let i = 0; i < n; i++) {
+            out[i] = componentwiseLerp(itemSchema, prev[i], next[i], t);
+        }
+        return out;
+    }
+    throw new Error(`componentwiseLerp: no default interpolator for schema type "${schema.type}"`);
+}
+//# sourceMappingURL=componentwise-lerp.js.map

package/dist/graphics/animation/animation-track/componentwise-lerp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentwise-lerp.js","sourceRoot":"","sources":["../../../../src/graphics/animation/animation-track/componentwise-lerp.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,IAAS,EAAE,IAAS,EAAE,CAAS;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzB,GAAG,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+DAA+D,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;AACnG,CAAC"}

package/dist/graphics/animation/animation-track/interpolate.d.ts

@@ -0,0 +1,8 @@
+import type { Schema } from "@adobe/data/schema";
+import type { InterpolationMode } from "../interpolation-mode/interpolation-mode.js";
+/**
+ * Dispatches to a schema-declared interpolator if present, otherwise falls
+ * back to a sensible default: `step` returns `next`, `linear` walks the schema
+ * and lerps numeric leaves. `cubicSpline` requires a schema override.
+ */
+export declare function interpolate(schema: Schema, mode: InterpolationMode, prev: any, next: any, t: number): any;

package/dist/graphics/animation/animation-track/interpolate.js

@@ -0,0 +1,18 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { componentwiseLerp } from "./componentwise-lerp.js";
+/**
+ * Dispatches to a schema-declared interpolator if present, otherwise falls
+ * back to a sensible default: `step` returns `next`, `linear` walks the schema
+ * and lerps numeric leaves. `cubicSpline` requires a schema override.
+ */
+export function interpolate(schema, mode, prev, next, t) {
+    const custom = schema.interpolators?.[mode];
+    if (custom)
+        return custom(prev, next, t);
+    if (mode === "step")
+        return prev;
+    if (mode === "linear")
+        return componentwiseLerp(schema, prev, next, t);
+    throw new Error(`interpolate: schema type "${schema.type}" has no "${mode}" interpolator`);
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/graphics/animation/animation-track/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../../../src/graphics/animation/animation-track/interpolate.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACvB,MAAc,EACd,IAAuB,EACvB,IAAS,EACT,IAAS,EACT,CAAS;IAET,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,IAAI,aAAa,IAAI,gBAAgB,CAAC,CAAC;AAC/F,CAAC"}

package/dist/graphics/animation/animation-track/public.d.ts

@@ -0,0 +1 @@
+export { sample } from "./sample.js";

package/dist/graphics/animation/animation-track/public.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { sample } from "./sample.js";
+//# sourceMappingURL=public.js.map

package/dist/graphics/animation/animation-track/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/graphics/animation/animation-track/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/graphics/animation/animation-track/sample.d.ts

@@ -0,0 +1,7 @@
+import type { Schema } from "@adobe/data/schema";
+import type { AnimationTrack } from "./animation-track.js";
+/**
+ * Samples a track at `time` and returns the interpolated component value.
+ * `time` must already be wrapped into the clip's [0, duration] range by the caller.
+ */
+export declare function sample(track: AnimationTrack, schema: Schema, time: number): number | number[];