@aura3d/engine 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+# Aura3D
+
+[![npm version](https://img.shields.io/npm/v/@aura3d/engine.svg)](https://www.npmjs.com/package/@aura3d/engine)
+[![npm downloads](https://img.shields.io/npm/dm/@aura3d/engine.svg)](https://www.npmjs.com/package/@aura3d/engine)
+[![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-browser%203D-3178c6.svg)](https://www.typescriptlang.org/)
+
+Aura3D is an agent-friendly TypeScript browser 3D SDK for prompt-to-code scenes, GLB/glTF product viewers, Vite templates, typed asset workflows, diagnostics, screenshots, and static deployment checks.
+
+Describe the 3D scene. Bring the GLB when you have one. Keep the TypeScript.
+
+Aura3D helps AI coding agents build real browser 3D apps with public TypeScript APIs, generated primitive scene kits, typed GLB/glTF assets, route-health diagnostics, screenshot evidence, and deploy checks. It is not an LLM, not an asset store, and not a hidden scene generator. It is source code plus typed assets.
+
+## Install
+
+Scaffold a browser 3D app:
+
+```bash
+npx create-aura3d@latest my-scene --template product-viewer
+cd my-scene
+npm run dev
+```
+
+Install the engine directly:
+
+```bash
+npm install @aura3d/engine
+```
+
+Add a typed GLB/glTF asset when the prompt includes a real model:
+
+```bash
+npx @aura3d/cli@latest assets add ./assets/robot.glb --name robot
+```
+
+## Use Aura3D for
+
+- AI-generated browser 3D scenes that remain editable TypeScript.
+- Typed GLB/glTF product viewers and product configurators.
+- Vite 3D starter apps with route health and screenshot tests.
+- Agent-authored scenes with public imports instead of invented APIs.
+- Static-deployed 3D apps with asset and deploy checks.
+- Prompt-to-3D workflows where screenshots and diagnostics matter.
+
+## 30-second product viewer
+
+```ts
+import { createAuraApp, lights, model, scene } from "@aura3d/engine";
+import { assets } from "./aura-assets";
+
+createAuraApp("#app", {
+  scene: scene()
+    .add(model(assets.robot))
+    .add(lights.studio()),
+  diagnostics: { overlay: true }
+});
+```
+
+The safe API uses generated refs such as `assets.robot`. Do not write `model("robot")`, hand-written GLB URLs, or invented asset ids.
+
+## Prompt-to-3D scene kits
+
+Use scene kits when an AI prompt asks for generated 3D systems rather than a supplied model.
+
+```ts
+import { createAuraApp, sceneKits } from "@aura3d/engine";
+
+const kit = sceneKits.physicsPlayground();
+createAuraApp("#app", kit.toAppOptions());
+console.log(kit.diagnostics, kit.evidence);
+```
+
+Maintained scene-kit families include physics playgrounds, particle fountains, solar systems, neon tunnels, 3D data visualizations, mini golf, material labs, city blocks, humanoid walks, and typed product viewers.
+
+## Packages
+
+- `@aura3d/engine`: public agent-facing TypeScript browser 3D SDK.
+- `@aura3d/cli`: typed GLB/glTF asset workflow, diagnostics, and deploy checks.
+- `@aura3d/react`: optional thin React adapter.
+- `create-aura3d`: Vite templates for product viewers, cinematic scenes, and mini-games.
+
+## Aura3D vs manual renderer code
+
+Aura3D is not a drop-in replacement for manual renderer code. Use Aura3D when an AI coding agent needs a smaller, stable, documented scene API, typed GLB/glTF assets, starter templates, diagnostics, screenshots, and deployment checks.
+
+Use manual renderer code when you need full engine-level control, custom renderer internals, the broadest plugin ecosystem, or direct access to every manual renderer code primitive.
+
+Safe positioning: Aura3D is an agent-friendly manual renderer code alternative for prompt-to-code workflows, not a proven blanket manual renderer code replacement or benchmark-superiority claim.
+
+## Documentation
+
+- Agent manual: [docs/agents/README.md](docs/agents/README.md)
+- Agent quickstart: [docs/agents/agent-quickstart.md](docs/agents/agent-quickstart.md)
+- Prompt-to-3D workflow: [docs/agents/prompt-to-3d-workflow.md](docs/agents/prompt-to-3d-workflow.md)
+- Asset workflow: [docs/agents/asset-workflow.md](docs/agents/asset-workflow.md)
+- Prompt recipes: [docs/agents/benchmark-recipes.md](docs/agents/benchmark-recipes.md)
+- Public API: [docs/api/public-api.md](docs/api/public-api.md)
+- manual renderer code comparison: [docs/comparisons/manual renderer code.md](docs/comparisons/manual renderer code.md)
+- Claim boundaries: [docs/project/claim-guidelines.md](docs/project/claim-guidelines.md)
+
+## Verification
+
+```bash
+pnpm run check:release
+```
+
+Release and benchmark claims are evidence-scoped. Internal checks, nonblank screenshots, or self-authored visual QA do not prove that Aura3D beats manual renderer code.
+
+## Contributing
+
+Star the repo if you want agent-friendly browser 3D tooling. Open issues with the prompt, package version, asset source or license, commands run, route-health output, screenshots, and deploy context.
+
+## Boundary
+
+Aura3D can truthfully claim an agent-friendly browser 3D SDK with typed assets, scene kits, diagnostics, screenshots, templates, and deploy checks. Do not claim Aura3D beats manual renderer code, is faster than manual renderer code, is a full manual renderer code replacement, or has passed the frozen external benchmark unless the required neutral benchmark artifacts exist.

package/dist/animation/AnimationAction.d.ts

@@ -0,0 +1,40 @@
+import type { AnimationClip } from "./AnimationClip.js";
+import { type AnimationEvent } from "./AnimationEvents.js";
+export type LoopMode = "once" | "repeat" | "pingpong";
+export type AnimationActionSnapshot = {
+    readonly clipName: string;
+    readonly duration: number;
+    readonly time: number;
+    readonly weight: number;
+    readonly timeScale: number;
+    readonly playing: boolean;
+    readonly paused: boolean;
+    readonly loopMode: LoopMode;
+};
+export declare class AnimationAction {
+    readonly clip: AnimationClip;
+    time: number;
+    weight: number;
+    timeScale: number;
+    loopMode: LoopMode;
+    playing: boolean;
+    paused: boolean;
+    private pingPongForward;
+    private fadeDuration;
+    private fadeElapsed;
+    private fadeStartWeight;
+    private fadeTargetWeight;
+    constructor(clip: AnimationClip);
+    play(): this;
+    pause(): this;
+    stop(): this;
+    setWeight(weight: number): this;
+    setTimeScale(timeScale: number): this;
+    setLoop(loopMode: LoopMode): this;
+    reset(): this;
+    seek(time: number): this;
+    fadeTo(weight: number, duration: number): this;
+    update(delta: number): readonly AnimationEvent[];
+    snapshot(): AnimationActionSnapshot;
+}
+//# sourceMappingURL=AnimationAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationAction.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B,CAAC;AAEF,qBAAa,eAAe;IAC1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,IAAI,SAAK;IACT,MAAM,SAAK;IACX,SAAS,SAAK;IACd,QAAQ,EAAE,QAAQ,CAAY;IAC9B,OAAO,UAAS;IAChB,MAAM,UAAS;IACf,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,IAAI,EAAE,aAAa;IAI/B,IAAI,IAAI,IAAI;IAMZ,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAOZ,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQrC,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKjC,KAAK,IAAI,IAAI;IAMb,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQxB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAc9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE;IAoDhD,QAAQ,IAAI,uBAAuB;CAYpC"}

package/dist/animation/AnimationAction.js

@@ -0,0 +1,143 @@
+import { eventsBetween } from "./AnimationEvents.js";
+export class AnimationAction {
+    clip;
+    time = 0;
+    weight = 1;
+    timeScale = 1;
+    loopMode = "repeat";
+    playing = false;
+    paused = false;
+    pingPongForward = true;
+    fadeDuration = 0;
+    fadeElapsed = 0;
+    fadeStartWeight = 1;
+    fadeTargetWeight = 1;
+    constructor(clip) {
+        this.clip = clip;
+    }
+    play() {
+        this.playing = true;
+        this.paused = false;
+        return this;
+    }
+    pause() {
+        this.paused = true;
+        return this;
+    }
+    stop() {
+        this.playing = false;
+        this.paused = false;
+        this.time = 0;
+        return this;
+    }
+    setWeight(weight) {
+        if (!Number.isFinite(weight) || weight < 0) {
+            throw new Error("AnimationAction weight must be finite and non-negative.");
+        }
+        this.weight = weight;
+        return this;
+    }
+    setTimeScale(timeScale) {
+        if (!Number.isFinite(timeScale) || timeScale < 0) {
+            throw new Error("AnimationAction timeScale must be finite and non-negative.");
+        }
+        this.timeScale = timeScale;
+        return this;
+    }
+    setLoop(loopMode) {
+        this.loopMode = loopMode;
+        return this;
+    }
+    reset() {
+        this.time = 0;
+        this.pingPongForward = true;
+        return this;
+    }
+    seek(time) {
+        if (!Number.isFinite(time) || time < 0) {
+            throw new Error("AnimationAction seek time must be finite and non-negative.");
+        }
+        this.time = this.clip.duration > 0 ? Math.min(time, this.clip.duration) : 0;
+        return this;
+    }
+    fadeTo(weight, duration) {
+        if (!Number.isFinite(duration) || duration < 0 || !Number.isFinite(weight) || weight < 0) {
+            throw new Error("AnimationAction fade target and duration must be valid.");
+        }
+        this.fadeStartWeight = this.weight;
+        this.fadeTargetWeight = weight;
+        this.fadeDuration = duration;
+        this.fadeElapsed = 0;
+        if (duration === 0) {
+            this.weight = weight;
+        }
+        return this;
+    }
+    update(delta) {
+        if (!Number.isFinite(delta) || delta < 0) {
+            throw new Error("AnimationAction delta must be finite and non-negative.");
+        }
+        if (this.fadeDuration > 0) {
+            this.fadeElapsed = Math.min(this.fadeDuration, this.fadeElapsed + delta);
+            const t = this.fadeElapsed / this.fadeDuration;
+            this.weight = this.fadeStartWeight + (this.fadeTargetWeight - this.fadeStartWeight) * t;
+            if (this.fadeElapsed === this.fadeDuration) {
+                this.fadeDuration = 0;
+            }
+        }
+        if (!this.playing || this.paused || this.clip.duration === 0) {
+            return [];
+        }
+        const previous = this.time;
+        const scaledDelta = delta * this.timeScale;
+        let next = previous + scaledDelta;
+        let looped = false;
+        if (this.loopMode === "repeat") {
+            while (next > this.clip.duration) {
+                next -= this.clip.duration;
+                looped = true;
+            }
+        }
+        else if (this.loopMode === "once") {
+            next = Math.min(next, this.clip.duration);
+            if (next === this.clip.duration) {
+                this.playing = false;
+            }
+        }
+        else {
+            if (this.pingPongForward) {
+                while (next > this.clip.duration) {
+                    next = this.clip.duration - (next - this.clip.duration);
+                    this.pingPongForward = false;
+                    looped = true;
+                }
+            }
+            else {
+                next = previous - scaledDelta;
+                while (next < 0) {
+                    next = -next;
+                    this.pingPongForward = true;
+                    looped = true;
+                }
+            }
+        }
+        this.time = next;
+        if (this.clip.events.length === 0) {
+            return [];
+        }
+        return eventsBetween(this.clip.events, this.clip.name, previous, next, this.clip.duration, looped);
+    }
+    snapshot() {
+        return {
+            clipName: this.clip.name,
+            duration: this.clip.duration,
+            time: this.time,
+            weight: this.weight,
+            timeScale: this.timeScale,
+            playing: this.playing,
+            paused: this.paused,
+            loopMode: this.loopMode
+        };
+    }
+}
+//# sourceMappingURL=AnimationAction.js.map

package/dist/animation/AnimationAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationAction.js","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationAction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAe1E,MAAM,OAAO,eAAe;IACjB,IAAI,CAAgB;IAC7B,IAAI,GAAG,CAAC,CAAC;IACT,MAAM,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,CAAC,CAAC;IACd,QAAQ,GAAa,QAAQ,CAAC;IAC9B,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,KAAK,CAAC;IACP,eAAe,GAAG,IAAI,CAAC;IACvB,YAAY,GAAG,CAAC,CAAC;IACjB,WAAW,GAAG,CAAC,CAAC;IAChB,eAAe,GAAG,CAAC,CAAC;IACpB,gBAAgB,GAAG,CAAC,CAAC;IAE7B,YAAY,IAAmB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,SAAiB;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,QAAkB;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,QAAgB;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACzF,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC;YACzE,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;YAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACxF,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC3C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3C,IAAI,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC;QAClC,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACjC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC3B,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACpC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACvB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,OAAO,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACjC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACxD,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;oBAC7B,MAAM,GAAG,IAAI,CAAC;gBAChB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC;gBAC9B,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC;oBAChB,IAAI,GAAG,CAAC,IAAI,CAAC;oBACb,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;oBAC5B,MAAM,GAAG,IAAI,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrG,CAAC;IAED,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACxB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/animation/AnimationClip.d.ts

@@ -0,0 +1,24 @@
+import type { AnimationEventMarker } from "./AnimationEvents.js";
+import { AnimationTrack, type SerializedAnimationTrack } from "./AnimationTrack.js";
+export type AnimationClipDescriptor = {
+    readonly name: string;
+    readonly duration?: number;
+    readonly tracks: readonly AnimationTrack[];
+    readonly events?: readonly AnimationEventMarker[];
+};
+export type SerializedAnimationClip = {
+    readonly name: string;
+    readonly duration: number;
+    readonly tracks: readonly SerializedAnimationTrack[];
+    readonly events: readonly AnimationEventMarker[];
+};
+export declare class AnimationClip {
+    readonly name: string;
+    readonly tracks: readonly AnimationTrack[];
+    readonly events: readonly AnimationEventMarker[];
+    readonly duration: number;
+    constructor(descriptor: AnimationClipDescriptor);
+    toJSON(): SerializedAnimationClip;
+    static fromJSON(serialized: SerializedAnimationClip): AnimationClip;
+}
+//# sourceMappingURL=AnimationClip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationClip.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationClip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD,CAAC;AAEF,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,UAAU,EAAE,uBAAuB;IAsB/C,MAAM,IAAI,uBAAuB;IASjC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,aAAa;CAQpE"}

package/dist/animation/AnimationClip.js

@@ -0,0 +1,45 @@
+import { AnimationTrack } from "./AnimationTrack.js";
+export class AnimationClip {
+    name;
+    tracks;
+    events;
+    duration;
+    constructor(descriptor) {
+        if (descriptor.name.trim().length === 0) {
+            throw new Error("AnimationClip name cannot be empty.");
+        }
+        this.name = descriptor.name;
+        this.tracks = [...descriptor.tracks];
+        this.events = [...(descriptor.events ?? [])].sort((a, b) => a.time - b.time || a.name.localeCompare(b.name));
+        const trackDuration = this.tracks.reduce((duration, track) => Math.max(duration, track.duration), 0);
+        this.duration = descriptor.duration ?? trackDuration;
+        if (!Number.isFinite(this.duration) || this.duration < 0) {
+            throw new Error("AnimationClip duration must be finite and non-negative.");
+        }
+        if (this.duration < trackDuration) {
+            throw new Error("AnimationClip duration cannot be shorter than its tracks.");
+        }
+        for (const event of this.events) {
+            if (!Number.isFinite(event.time) || event.time < 0 || event.time > this.duration) {
+                throw new Error(`Animation event ${event.name} is outside clip duration.`);
+            }
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            duration: this.duration,
+            tracks: this.tracks.map((track) => track.toJSON()),
+            events: this.events.map((event) => ({ ...event }))
+        };
+    }
+    static fromJSON(serialized) {
+        return new AnimationClip({
+            name: serialized.name,
+            duration: serialized.duration,
+            tracks: serialized.tracks.map((track) => AnimationTrack.fromJSON(track)),
+            events: serialized.events
+        });
+    }
+}
+//# sourceMappingURL=AnimationClip.js.map

package/dist/animation/AnimationClip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationClip.js","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationClip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAiC,MAAM,qBAAqB,CAAC;AAgBpF,MAAM,OAAO,aAAa;IACf,IAAI,CAAS;IACb,MAAM,CAA4B;IAClC,MAAM,CAAkC;IACxC,QAAQ,CAAS;IAE1B,YAAY,UAAmC;QAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7G,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACrG,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,aAAa,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,GAAG,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACjF,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,IAAI,4BAA4B,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;SACnD,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,UAAmC;QACjD,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxE,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/animation/AnimationEvents.d.ts

@@ -0,0 +1,10 @@
+export type AnimationEventMarker = {
+    readonly name: string;
+    readonly time: number;
+    readonly payload?: unknown;
+};
+export type AnimationEvent = AnimationEventMarker & {
+    readonly clipName: string;
+};
+export declare function eventsBetween(markers: readonly AnimationEventMarker[], clipName: string, fromTime: number, toTime: number, duration: number, looped: boolean): readonly AnimationEvent[];
+//# sourceMappingURL=AnimationEvents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationEvents.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationEvents.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,cAAc,EAAE,CAuBxL"}

package/dist/animation/AnimationEvents.js

@@ -0,0 +1,26 @@
+export function eventsBetween(markers, clipName, fromTime, toTime, duration, looped) {
+    const events = [];
+    if (duration <= 0) {
+        return events;
+    }
+    if (!looped || toTime >= fromTime) {
+        for (const marker of markers) {
+            if (marker.time > fromTime && marker.time <= toTime) {
+                events.push({ ...marker, clipName });
+            }
+        }
+        return events;
+    }
+    const lateEvents = [];
+    const earlyEvents = [];
+    for (const marker of markers) {
+        if (marker.time > fromTime && marker.time <= duration) {
+            lateEvents.push({ ...marker, clipName });
+        }
+        else if (marker.time >= 0 && marker.time <= toTime) {
+            earlyEvents.push({ ...marker, clipName });
+        }
+    }
+    return [...lateEvents, ...earlyEvents];
+}
+//# sourceMappingURL=AnimationEvents.js.map

package/dist/animation/AnimationEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationEvents.js","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationEvents.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,aAAa,CAAC,OAAwC,EAAE,QAAgB,EAAE,QAAgB,EAAE,MAAc,EAAE,QAAgB,EAAE,MAAe;IAC3J,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ,IAAI,MAAM,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,EAAE,GAAG,WAAW,CAAC,CAAC;AACzC,CAAC"}

package/dist/animation/AnimationLayer.d.ts

@@ -0,0 +1,27 @@
+import type { AnimationAction } from "./AnimationAction.js";
+export type AnimationLayerSnapshot = {
+    readonly name: string;
+    readonly weight: number;
+    readonly additive: boolean;
+    readonly mask: readonly string[];
+    readonly actions: readonly string[];
+};
+export type AnimationLayerOptions = {
+    readonly weight?: number;
+    readonly additive?: boolean;
+    readonly mask?: readonly string[];
+};
+export declare class AnimationLayer {
+    readonly name: string;
+    weight: number;
+    additive: boolean;
+    readonly mask: readonly string[];
+    readonly actions: AnimationAction[];
+    private readonly baseWeights;
+    constructor(name: string, weightOrOptions?: number | AnimationLayerOptions);
+    add(action: AnimationAction): void;
+    applyWeight(): void;
+    capturesTarget(target: string): boolean;
+    snapshot(): AnimationLayerSnapshot;
+}
+//# sourceMappingURL=AnimationLayer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationLayer.d.ts","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationLayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CAAC;AAEF,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,CAAM;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;gBAE1D,IAAI,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,qBAAyB;IAmB7E,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAOlC,WAAW,IAAI,IAAI;IAMnB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOvC,QAAQ,IAAI,sBAAsB;CASnC"}

package/dist/animation/AnimationLayer.js

@@ -0,0 +1,53 @@
+export class AnimationLayer {
+    name;
+    weight;
+    additive;
+    mask;
+    actions = [];
+    baseWeights = new WeakMap();
+    constructor(name, weightOrOptions = 1) {
+        if (name.trim().length === 0) {
+            throw new Error("AnimationLayer name cannot be empty.");
+        }
+        this.name = name;
+        const options = typeof weightOrOptions === "number" ? { weight: weightOrOptions } : weightOrOptions;
+        this.weight = options.weight ?? 1;
+        this.additive = options.additive ?? false;
+        this.mask = [...(options.mask ?? [])];
+        if (!Number.isFinite(this.weight) || this.weight < 0) {
+            throw new Error("AnimationLayer weight must be finite and non-negative.");
+        }
+        for (const entry of this.mask) {
+            if (entry.trim().length === 0) {
+                throw new Error("AnimationLayer mask entries cannot be empty.");
+            }
+        }
+    }
+    add(action) {
+        if (!this.actions.includes(action)) {
+            this.actions.push(action);
+            this.baseWeights.set(action, action.weight);
+        }
+    }
+    applyWeight() {
+        for (const action of this.actions) {
+            action.setWeight((this.baseWeights.get(action) ?? action.weight) * this.weight);
+        }
+    }
+    capturesTarget(target) {
+        if (this.mask.length === 0) {
+            return true;
+        }
+        return this.mask.some((entry) => target === entry || target.startsWith(`${entry}.`));
+    }
+    snapshot() {
+        return {
+            name: this.name,
+            weight: this.weight,
+            additive: this.additive,
+            mask: [...this.mask],
+            actions: this.actions.map((action) => action.clip.name)
+        };
+    }
+}
+//# sourceMappingURL=AnimationLayer.js.map

package/dist/animation/AnimationLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationLayer.js","sourceRoot":"","sources":["../../../../packages/animation/src/AnimationLayer.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,cAAc;IAChB,IAAI,CAAS;IACtB,MAAM,CAAS;IACf,QAAQ,CAAU;IACT,IAAI,CAAoB;IACxB,OAAO,GAAsB,EAAE,CAAC;IACxB,WAAW,GAAG,IAAI,OAAO,EAA2B,CAAC;IAEtE,YAAY,IAAY,EAAE,kBAAkD,CAAC;QAC3E,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,OAAO,GAAG,OAAO,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;QACpG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,MAAuB;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,WAAW;QACT,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,cAAc,CAAC,MAAc;QAC3B,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SACxD,CAAC;IACJ,CAAC;CACF"}

package/dist/animation/AnimationMixer.d.ts

@@ -0,0 +1,54 @@
+import { AnimationAction, type AnimationActionSnapshot } from "./AnimationAction.js";
+import type { AnimationClip } from "./AnimationClip.js";
+import type { AnimationEvent } from "./AnimationEvents.js";
+import type { AnimationLayer, AnimationLayerSnapshot } from "./AnimationLayer.js";
+import { type AnimationValue } from "./Keyframe.js";
+import { type RootMotionSample } from "./RootMotion.js";
+export type AnimationTarget = {
+    setAnimationValue?: (target: string, value: AnimationValue) => void;
+    applyRootMotion?: (sample: RootMotionSample) => void;
+    position?: [number, number, number];
+};
+export type AnimationMixerOptions = {
+    readonly applyRootMotion?: boolean;
+    readonly rootMotionTrack?: string;
+    readonly rootMotionScale?: number;
+};
+export type AnimationMixerSnapshot = {
+    readonly timeScale: number;
+    readonly actionCount: number;
+    readonly actions: readonly AnimationActionSnapshot[];
+    readonly layers: readonly AnimationLayerSnapshot[];
+    readonly values: Readonly<Record<string, AnimationValue>>;
+    readonly applyErrors: readonly AnimationApplyError[];
+};
+export type AnimationApplyError = {
+    readonly target: string;
+    readonly message: string;
+};
+export declare class AnimationMixer {
+    private readonly options;
+    readonly target: AnimationTarget | undefined;
+    timeScale: number;
+    private readonly actions;
+    private readonly layers;
+    private readonly values;
+    private applyErrors;
+    private readonly eventListeners;
+    private disposed;
+    constructor(target?: AnimationTarget, options?: AnimationMixerOptions);
+    play(clip: AnimationClip): AnimationAction;
+    addAction(action: AnimationAction): void;
+    addLayer(layer: AnimationLayer): void;
+    stopAll(): void;
+    crossFade(from: AnimationAction, to: AnimationAction, duration: number): void;
+    update(delta: number): readonly AnimationEvent[];
+    getValue(target: string): AnimationValue | undefined;
+    onEvent(listener: (event: AnimationEvent) => void): () => void;
+    snapshot(): AnimationMixerSnapshot;
+    dispose(): void;
+    private assertAlive;
+    private applyActionRootMotion;
+    private layersForAction;
+}
+//# sourceMappingURL=AnimationMixer.d.ts.map

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

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