@yali-engine/animation 0.0.0-stage → 0.4.0

package/dist/graph.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Animation graphs (ADR-0089, `docs/animation-design.md` §8): a typed builder that writes the
+ * word stream `yali_anim_add_graph` compiles. Graphs are data (`BuiltGraph.words`; a JSON `.yanim`
+ * form comes with the editor). Parameters are named here and live in `anim.Graph.params` (16
+ * slots), so gameplay sets them with no call into the core (`Animation.setParam` by name).
+ *
+ * @example
+ * const g = graph({ params: ['speed', 'wave'] });
+ * const loco = g.blend1d('speed', [[0, g.clip(idle)], [1.5, g.clip(walk)], [4, g.clip(run)]]);
+ * const root = g.stateMachine({
+ *   entry: 'loco',
+ *   states: { loco, wave: g.clip(wave, { loop: false }) },
+ *   transitions: [
+ *     { from: 'loco', to: 'wave', when: [g.trigger('wave')], duration: 0.2 },
+ *     { from: 'wave', to: 'loco', when: ['finished'], duration: 0.3 },
+ *   ],
+ * });
+ * const id = anim.addGraph(skeleton, g.build(root));
+ */
+/** Most parameters a graph has (`anim.Graph.params`). */
+export declare const MAX_PARAMS = 16;
+/** A node of a graph being built. */
+export interface GraphNode {
+    readonly index: number;
+}
+/** A blend weight: a constant, or a parameter by name. */
+export type Weight = number | {
+    readonly param: string;
+};
+/** A transition condition. `'finished'`: the source state's clip reached its end (normalized time ≥ 1). */
+export type Condition = 'finished' | {
+    readonly param: string;
+    readonly op: '>' | '<' | '>=' | '<=' | '==' | '!=';
+    readonly value: number;
+} | {
+    readonly trigger: string;
+} | {
+    readonly normalizedTime: number;
+};
+/** How a transition hands over (ADR-0089). */
+export type TransitionMode = 'inertialize' | 'crossfade';
+/** A transition between states (`from: '*'`: from any state; listed order is priority). */
+export interface Transition {
+    readonly from: string;
+    readonly to: string;
+    /** Every condition must hold (and). */
+    readonly when: readonly Condition[];
+    /** Seconds. */
+    readonly duration: number;
+    /** Default `'inertialize'` (dead blending). */
+    readonly mode?: TransitionMode;
+}
+/** A built graph: the words for `yali_anim_add_graph` and the parameter names by slot. */
+export interface BuiltGraph {
+    readonly words: Uint32Array;
+    readonly params: readonly string[];
+    /** The root state machine's state names by index (`anim.Graph.state` is index + 1). */
+    readonly states: readonly string[];
+}
+/** Starts a graph over these named parameters. */
+export declare function graph(options?: {
+    params?: readonly string[];
+}): GraphBuilder;
+/** Builds one graph: each method adds a node and returns it; `build(root)` writes the words. */
+export declare class GraphBuilder {
+    #private;
+    readonly params: readonly string[];
+    constructor(params: readonly string[]);
+    /** Plays a clip (an `Animation.addClip` id): looping by default, at `speed`; `additive` makes it a delta from its first frame. */
+    clip(clip: number, options?: {
+        speed?: number;
+        loop?: boolean;
+        additive?: boolean;
+    }): GraphNode;
+    /** `a` blended towards `b` by `weight` (0 = a), per joint by `mask` (an `Animation.addMask` id). */
+    blend(a: GraphNode, b: GraphNode, weight: Weight, mask?: number): GraphNode;
+    /**
+     * A 1-D blend space: children at increasing positions along `param`; the two around the
+     * parameter blend, the rest are not sampled. Children play in step (one normalized phase).
+     */
+    blend1d(param: string, points: readonly (readonly [number, GraphNode])[]): GraphNode;
+    /** `add` (an additive clip's node) applied over `base` at `weight`, per joint by `mask`. */
+    additive(base: GraphNode, add: GraphNode, weight: Weight, mask?: number): GraphNode;
+    /** A parameter trigger condition (the parameter is set to 1 to fire; the graph clears it). */
+    trigger(param: string): Condition;
+    /** A state machine over named states; `entry` starts. */
+    stateMachine(sm: {
+        states: Readonly<Record<string, GraphNode>>;
+        entry: string;
+        transitions?: readonly Transition[];
+    }): GraphNode;
+    /** The graph's words, `root` its output. */
+    build(root: GraphNode): BuiltGraph;
+}

package/dist/graph.js

@@ -0,0 +1,155 @@
+import { YaliError } from '@yali-engine/core';
+/**
+ * Animation graphs (ADR-0089, `docs/animation-design.md` §8): a typed builder that writes the
+ * word stream `yali_anim_add_graph` compiles. Graphs are data (`BuiltGraph.words`; a JSON `.yanim`
+ * form comes with the editor). Parameters are named here and live in `anim.Graph.params` (16
+ * slots), so gameplay sets them with no call into the core (`Animation.setParam` by name).
+ *
+ * @example
+ * const g = graph({ params: ['speed', 'wave'] });
+ * const loco = g.blend1d('speed', [[0, g.clip(idle)], [1.5, g.clip(walk)], [4, g.clip(run)]]);
+ * const root = g.stateMachine({
+ *   entry: 'loco',
+ *   states: { loco, wave: g.clip(wave, { loop: false }) },
+ *   transitions: [
+ *     { from: 'loco', to: 'wave', when: [g.trigger('wave')], duration: 0.2 },
+ *     { from: 'wave', to: 'loco', when: ['finished'], duration: 0.3 },
+ *   ],
+ * });
+ * const id = anim.addGraph(skeleton, g.build(root));
+ */
+/** Most parameters a graph has (`anim.Graph.params`). */
+export const MAX_PARAMS = 16;
+const NODE = { clip: 0, blend: 1, blend1d: 2, additive: 3, stateMachine: 4 };
+const COND = { finished: 0, gt: 1, lt: 2, ge: 3, le: 4, eq: 5, ne: 6, trigger: 7, normalizedTime: 8 };
+const OPS = { '>': COND.gt, '<': COND.lt, '>=': COND.ge, '<=': COND.le, '==': COND.eq, '!=': COND.ne };
+const f32bits = (() => {
+    const f = new Float32Array(1);
+    const u = new Uint32Array(f.buffer);
+    return (v) => {
+        f[0] = v;
+        return u[0];
+    };
+})();
+/** Starts a graph over these named parameters. */
+export function graph(options = {}) {
+    return new GraphBuilder(options.params ?? []);
+}
+/** Builds one graph: each method adds a node and returns it; `build(root)` writes the words. */
+export class GraphBuilder {
+    params;
+    #nodes = [];
+    /** Each state machine's state names, by node. */
+    #stateNames = new Map();
+    constructor(params) {
+        if (params.length > MAX_PARAMS)
+            throw new YaliError('ANIM_GRAPH', `${params.length} parameters; a graph has at most ${MAX_PARAMS}.`, 'Pack flags into fewer parameters.');
+        if (new Set(params).size !== params.length)
+            throw new YaliError('ANIM_GRAPH', 'Two parameters share a name.', 'Name each parameter once.');
+        this.params = params;
+    }
+    #param(name, path) {
+        const i = this.params.indexOf(name);
+        if (i < 0)
+            throw Object.assign(new YaliError('ANIM_GRAPH', `${path}: no parameter named ${JSON.stringify(name)}.`, `Declare it: graph({ params: [${[...this.params, name].map((p) => JSON.stringify(p)).join(', ')}] }).`), { path });
+        return i;
+    }
+    #weight(w, path) {
+        return typeof w === 'number' ? [0, f32bits(w)] : [1, this.#param(w.param, path)];
+    }
+    #add(words) {
+        this.#nodes.push(words);
+        return { index: this.#nodes.length - 1 };
+    }
+    #node(n, path) {
+        if (!n || n.index < 0 || n.index >= this.#nodes.length)
+            throw Object.assign(new YaliError('ANIM_GRAPH', `${path}: not a node of this graph.`, 'Pass a node this builder returned.'), { path });
+        return n.index;
+    }
+    /** Plays a clip (an `Animation.addClip` id): looping by default, at `speed`; `additive` makes it a delta from its first frame. */
+    clip(clip, options = {}) {
+        if (!Number.isInteger(clip) || clip < 1)
+            throw Object.assign(new YaliError('ANIM_GRAPH', `clip: ${clip} is not a clip id.`, 'Pass an id Animation.addClip returned (ids start at 1).'), { path: 'clip' });
+        return this.#add([NODE.clip, clip, f32bits(options.speed ?? 1), (options.loop === false ? 0 : 1) | (options.additive ? 2 : 0)]);
+    }
+    /** `a` blended towards `b` by `weight` (0 = a), per joint by `mask` (an `Animation.addMask` id). */
+    blend(a, b, weight, mask = 0) {
+        const [k, v] = this.#weight(weight, 'blend.weight');
+        return this.#add([NODE.blend, this.#node(a, 'blend.a'), this.#node(b, 'blend.b'), k, v, mask]);
+    }
+    /**
+     * A 1-D blend space: children at increasing positions along `param`; the two around the
+     * parameter blend, the rest are not sampled. Children play in step (one normalized phase).
+     */
+    blend1d(param, points) {
+        if (points.length === 0)
+            throw Object.assign(new YaliError('ANIM_GRAPH', 'blend1d: no points.', 'Give at least one [position, node].'), { path: 'blend1d.points' });
+        for (let i = 1; i < points.length; i++) {
+            if (!(points[i][0] > points[i - 1][0]))
+                throw Object.assign(new YaliError('ANIM_GRAPH', `blend1d: position ${points[i][0]} is not above ${points[i - 1][0]}.`, 'List points in increasing position.'), { path: `blend1d.points[${i}]` });
+        }
+        const words = [NODE.blend1d, this.#param(param, 'blend1d.param'), points.length];
+        points.forEach(([pos, n], i) => words.push(f32bits(pos), this.#node(n, `blend1d.points[${i}]`)));
+        return this.#add(words);
+    }
+    /** `add` (an additive clip's node) applied over `base` at `weight`, per joint by `mask`. */
+    additive(base, add, weight, mask = 0) {
+        const [k, v] = this.#weight(weight, 'additive.weight');
+        return this.#add([NODE.additive, this.#node(base, 'additive.base'), this.#node(add, 'additive.add'), k, v, mask]);
+    }
+    /** A parameter trigger condition (the parameter is set to 1 to fire; the graph clears it). */
+    trigger(param) {
+        this.#param(param, 'trigger');
+        return { trigger: param };
+    }
+    /** A state machine over named states; `entry` starts. */
+    stateMachine(sm) {
+        const names = Object.keys(sm.states);
+        const idx = (name, path) => {
+            const i = names.indexOf(name);
+            if (i < 0)
+                throw Object.assign(new YaliError('ANIM_GRAPH', `${path}: no state named ${JSON.stringify(name)}.`, `States: ${names.join(', ')}.`), { path });
+            return i;
+        };
+        const words = [NODE.stateMachine, names.length, idx(sm.entry, 'stateMachine.entry')];
+        names.forEach((n) => words.push(this.#node(sm.states[n], `stateMachine.states.${n}`)));
+        const ts = sm.transitions ?? [];
+        words.push(ts.length);
+        ts.forEach((t, i) => {
+            const path = `stateMachine.transitions[${i}]`;
+            if (!(t.duration >= 0))
+                throw Object.assign(new YaliError('ANIM_GRAPH', `${path}: duration ${t.duration}.`, 'Give a duration of 0 or more seconds.'), { path: `${path}.duration` });
+            words.push(t.from === '*' ? 0xffffffff : idx(t.from, `${path}.from`), idx(t.to, `${path}.to`), f32bits(t.duration), t.mode === 'crossfade' ? 1 : 0, t.when.length);
+            t.when.forEach((c, k) => {
+                const cp = `${path}.when[${k}]`;
+                if (c === 'finished')
+                    words.push(COND.finished, 0, 0);
+                else if ('trigger' in c)
+                    words.push(COND.trigger, this.#param(c.trigger, cp), 0);
+                else if ('normalizedTime' in c)
+                    words.push(COND.normalizedTime, 0, f32bits(c.normalizedTime));
+                else
+                    words.push(OPS[c.op], this.#param(c.param, cp), f32bits(c.value));
+            });
+        });
+        const node = this.#add(words);
+        this.#stateNames.set(node.index, names);
+        return node;
+    }
+    /** The graph's words, `root` its output. */
+    build(root) {
+        const r = this.#node(root, 'build.root');
+        const body = this.#nodes.flat();
+        const words = new Uint32Array(4 + this.#nodes.length + body.length);
+        words.set([1, this.#nodes.length, r, this.params.length]);
+        // An offset table, then the nodes.
+        let o = 4 + this.#nodes.length;
+        this.#nodes.forEach((n, i) => {
+            words[4 + i] = o;
+            words.set(n, o);
+            o += n.length;
+        });
+        return { words, params: this.params, states: this.#stateNames.get(r) ?? [] };
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@yali-engine/animation`: skeletons, clips and skinned meshes (ADR-0083, ADR-0088), sampled and
+ * skinned by the core module's `anim` variant (ADR-0084). `@yali-engine/vite` loads that variant when an
+ * app depends on this package. Animation runs at the render rate; skinning runs in the vertex
+ * shader on every backend (WebGPU, compatibility mode, WebGL2).
+ *
+ * @example
+ * import { animationPlugin, type Animation, spawnAnimatedGltf } from '@yali-engine/animation';
+ * const app = App.create({ core, plugins: [transformsPlugin(), renderPlugin({ canvas }), assetsPlugin({ loaders: [] }), gltfPlugin(), animationPlugin()] });
+ * const model = assets.load<GltfAsset | null>('fox.glb');
+ * await model.ready;
+ * spawnAnimatedGltf(app.world, app.resource<Animation>('animation'), model.get()!, render.Mesh!, { clip: 'Run' });
+ */
+export { Animation, type AnimationStats, type ClipTrack, type JointRest, type PaletteFrame } from './animation.ts';
+export { ANIM_LOOP, ANIM_PAUSED, type AnimationComponents, BONE_DRIVE, BONE_FOLLOW, registerAnimation } from './components.ts';
+export { type BuiltGraph, type Condition, graph, GraphBuilder, type GraphNode, MAX_PARAMS, type Transition, type TransitionMode, type Weight } from './graph.ts';
+export { addGltfAnimation, type AnimatedGltf, type GltfAnimationAssets, spawnAnimatedGltf, type SpawnAnimatedOptions } from './gltf.ts';
+export { type MorphBinding, type MorphMeshes, Morphs, type MorphTarget, type MorphTrack } from './morph.ts';
+export { animationPlugin } from './plugin.ts';
+export { buildRagdoll, type Ragdoll, type RagdollOptions, type RagdollPhysics, setRagdoll } from './ragdoll.ts';

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * `@yali-engine/animation`: skeletons, clips and skinned meshes (ADR-0083, ADR-0088), sampled and
+ * skinned by the core module's `anim` variant (ADR-0084). `@yali-engine/vite` loads that variant when an
+ * app depends on this package. Animation runs at the render rate; skinning runs in the vertex
+ * shader on every backend (WebGPU, compatibility mode, WebGL2).
+ *
+ * @example
+ * import { animationPlugin, type Animation, spawnAnimatedGltf } from '@yali-engine/animation';
+ * const app = App.create({ core, plugins: [transformsPlugin(), renderPlugin({ canvas }), assetsPlugin({ loaders: [] }), gltfPlugin(), animationPlugin()] });
+ * const model = assets.load<GltfAsset | null>('fox.glb');
+ * await model.ready;
+ * spawnAnimatedGltf(app.world, app.resource<Animation>('animation'), model.get()!, render.Mesh!, { clip: 'Run' });
+ */
+export { Animation } from "./animation.js";
+export { ANIM_LOOP, ANIM_PAUSED, BONE_DRIVE, BONE_FOLLOW, registerAnimation } from "./components.js";
+export { graph, GraphBuilder, MAX_PARAMS } from "./graph.js";
+export { addGltfAnimation, spawnAnimatedGltf } from "./gltf.js";
+export { Morphs } from "./morph.js";
+export { animationPlugin } from "./plugin.js";
+export { buildRagdoll, setRagdoll } from "./ragdoll.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAA0E,MAAM,gBAAgB,CAAC;AACnH,OAAO,EAAE,SAAS,EAAE,WAAW,EAA4B,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/H,OAAO,EAAmC,KAAK,EAAE,YAAY,EAAkB,UAAU,EAAqD,MAAM,YAAY,CAAC;AACjK,OAAO,EAAE,gBAAgB,EAA+C,iBAAiB,EAA6B,MAAM,WAAW,CAAC;AACxI,OAAO,EAAuC,MAAM,EAAqC,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAA0D,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/morph.d.ts

@@ -0,0 +1,49 @@
+import type { Entity, World } from '@yali-engine/core';
+/** What blending needs of `@yali-engine/render`'s `MeshStore` (duck-typed: no dependency). */
+export interface MorphMeshes {
+    updateVertices(id: number, vertices: Float32Array): void;
+}
+/** One morph target: position offsets (xyz per vertex) and normal offsets (or null). */
+export interface MorphTarget {
+    readonly positions: Float32Array;
+    readonly normals: Float32Array | null;
+}
+/** A clip's weights for one mesh: one weight per target per key. */
+export interface MorphTrack {
+    readonly times: Float32Array;
+    readonly values: Float32Array;
+    readonly interpolation: 'LINEAR' | 'STEP';
+}
+/** A mesh whose morph targets follow an animator (`Morphs.add`). */
+export interface MorphBinding {
+    /** The entity with `anim.Animator` whose clip and time drive the weights. */
+    readonly animator: Entity;
+    /** Its mesh id (`render.Mesh.mesh`). */
+    readonly mesh: number;
+    /** The vertices the targets add to (interleaved, `MESH_VERTEX_FLOATS` each). */
+    readonly base: Float32Array;
+    readonly targets: readonly MorphTarget[];
+    /** The weights when the playing clip has none for this mesh. */
+    readonly defaults: readonly number[];
+    /** By clip id, that clip's weights for this mesh. */
+    readonly tracks: ReadonlyMap<number, MorphTrack>;
+}
+/**
+ * Morph targets (ADR-0088), blended on the CPU each frame their weights change and rewritten
+ * into the geometry pool (`MeshStore.updateVertices`): a mesh's weights come from its animator's
+ * clip at its time. One weight state per mesh id: instances sharing a mesh share its morph.
+ */
+export declare class Morphs {
+    #private;
+    /** Meshes rewritten last frame. */
+    written: number;
+    constructor(world: World);
+    /** Where blended vertices go (the render plugin's mesh store). */
+    setMeshes(meshes: MorphMeshes): void;
+    /** Whether mesh `id` already has a binding. */
+    has(mesh: number): boolean;
+    /** Binds a mesh's targets to an animator. */
+    add(b: MorphBinding): void;
+    /** Samples every bound mesh's weights and blends those that changed. Allocation-free once warm. */
+    update(): void;
+}

package/dist/morph.js

@@ -0,0 +1,136 @@
+import { registerAnimation } from "./components.js";
+const FLOATS = 8;
+/**
+ * Morph targets (ADR-0088), blended on the CPU each frame their weights change and rewritten
+ * into the geometry pool (`MeshStore.updateVertices`): a mesh's weights come from its animator's
+ * clip at its time. One weight state per mesh id: instances sharing a mesh share its morph.
+ */
+export class Morphs {
+    #world;
+    #live = [];
+    #meshes = null;
+    #query = null;
+    #state = new Map();
+    /** Meshes rewritten last frame. */
+    written = 0;
+    constructor(world) {
+        this.#world = world;
+    }
+    /** Where blended vertices go (the render plugin's mesh store). */
+    setMeshes(meshes) {
+        this.#meshes = meshes;
+    }
+    /** Whether mesh `id` already has a binding. */
+    has(mesh) {
+        return this.#live.some((l) => l.mesh === mesh);
+    }
+    /** Binds a mesh's targets to an animator. */
+    add(b) {
+        const k = b.targets.length;
+        this.#live.push({ ...b, weights: new Float32Array(k), last: new Float32Array(k).fill(Number.NaN), out: new Float32Array(b.base.length) });
+    }
+    /** Samples every bound mesh's weights and blends those that changed. Allocation-free once warm. */
+    update() {
+        this.written = 0;
+        if (this.#live.length === 0 || !this.#meshes)
+            return;
+        const { Animator } = registerAnimation(this.#world);
+        this.#query ??= this.#world.query({ with: [Animator], columns: [[Animator, 'clip'], [Animator, 'time']] });
+        const q = this.#query;
+        const chunks = q.run();
+        for (let c = 0; c < chunks; c++) {
+            const k = q.chunk(c);
+            const clips = k.u32(0);
+            const times = k.f32(1);
+            for (let i = 0; i < k.length; i++) {
+                const e = k.entity(i);
+                const s = this.#state.get(e);
+                if (s) {
+                    s.clip = clips[i];
+                    s.time = times[i];
+                }
+                else
+                    this.#state.set(e, { clip: clips[i], time: times[i] });
+            }
+        }
+        for (const l of this.#live) {
+            const s = this.#state.get(l.animator);
+            const track = s ? l.tracks.get(s.clip) : undefined;
+            if (track && s)
+                sample(track, s.time, l.weights);
+            else
+                for (let t = 0; t < l.weights.length; t++)
+                    l.weights[t] = l.defaults[t] ?? 0;
+            let same = true;
+            for (let t = 0; t < l.weights.length && same; t++)
+                same = l.weights[t] === l.last[t];
+            if (same)
+                continue;
+            l.last.set(l.weights);
+            blend(l);
+            this.#meshes.updateVertices(l.mesh, l.out);
+            this.written++;
+        }
+    }
+}
+/** A track's weights at `time` (clamped to its keys). */
+function sample(track, time, out) {
+    const t = track.times;
+    const n = t.length;
+    const k = out.length;
+    if (n === 0)
+        return;
+    if (time <= t[0] || n === 1) {
+        for (let w = 0; w < k; w++)
+            out[w] = track.values[w];
+        return;
+    }
+    if (time >= t[n - 1]) {
+        for (let w = 0; w < k; w++)
+            out[w] = track.values[(n - 1) * k + w];
+        return;
+    }
+    let lo = 0;
+    let hi = n - 1;
+    while (hi - lo > 1) {
+        const mid = (lo + hi) >> 1;
+        if (t[mid] <= time)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    const f = track.interpolation === 'STEP' ? 0 : (time - t[lo]) / (t[hi] - t[lo]);
+    for (let w = 0; w < k; w++)
+        out[w] = track.values[lo * k + w] * (1 - f) + track.values[hi * k + w] * f;
+}
+/** `out` = base + Σ weight × target, normals renormalized. */
+function blend(l) {
+    const out = l.out;
+    out.set(l.base);
+    const n = out.length / FLOATS;
+    for (let t = 0; t < l.targets.length; t++) {
+        const w = l.weights[t];
+        if (w === 0)
+            continue;
+        const { positions: dp, normals: dn } = l.targets[t];
+        for (let v = 0; v < n; v++) {
+            const o = v * FLOATS;
+            out[o] += w * dp[v * 3];
+            out[o + 1] += w * dp[v * 3 + 1];
+            out[o + 2] += w * dp[v * 3 + 2];
+            if (dn) {
+                out[o + 3] += w * dn[v * 3];
+                out[o + 4] += w * dn[v * 3 + 1];
+                out[o + 5] += w * dn[v * 3 + 2];
+            }
+        }
+    }
+    for (let v = 0; v < n; v++) {
+        const o = v * FLOATS;
+        const len = Math.hypot(out[o + 3], out[o + 4], out[o + 5]) || 1;
+        out[o + 3] /= len;
+        out[o + 4] /= len;
+        out[o + 5] /= len;
+    }
+}
+//# sourceMappingURL=morph.js.map

package/dist/morph.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,16 @@
+import { type YaliPlugin } from '@yali-engine/core';
+/**
+ * `@yali-engine/animation` as a plugin (ADR-0083, ADR-0088): every frame, in Update, animators advance
+ * by the frame's game time and the core samples their clips, writes each skin's palette rows and
+ * moves each socket (before PostUpdate's transform propagation, so the frame draws the pose it
+ * computed). With `@yali-engine/render` present the scene reads the palette from here. Provides the
+ * `animation` resource (`Animation`: skeletons, clips, skins) and `animationComponents`.
+ * Fails at startup, with the fix, when the loaded core has no animation. Registers the tools
+ * `animation.stats` and `animation.play`, and the counters `animation.paletteRows` and
+ * `animation.morphsWritten`. Morph targets blend on the CPU when their weights change (ADR-0088).
+ *
+ * @example
+ * const app = App.create({ core, plugins: [transformsPlugin(), renderPlugin({ canvas }), assetsPlugin(), gltfPlugin(), animationPlugin()] });
+ * const model = spawnAnimatedGltf(app.world, app.resource<Animation>('animation'), asset, render.Mesh!, { clip: 'Walk' });
+ */
+export declare function animationPlugin(): YaliPlugin;

package/dist/plugin.js

@@ -0,0 +1,111 @@
+import { YaliError } from '@yali-engine/core';
+import { Animation } from "./animation.js";
+import { ANIM_LOOP, ANIM_PAUSED, registerAnimation } from "./components.js";
+/**
+ * `@yali-engine/animation` as a plugin (ADR-0083, ADR-0088): every frame, in Update, animators advance
+ * by the frame's game time and the core samples their clips, writes each skin's palette rows and
+ * moves each socket (before PostUpdate's transform propagation, so the frame draws the pose it
+ * computed). With `@yali-engine/render` present the scene reads the palette from here. Provides the
+ * `animation` resource (`Animation`: skeletons, clips, skins) and `animationComponents`.
+ * Fails at startup, with the fix, when the loaded core has no animation. Registers the tools
+ * `animation.stats` and `animation.play`, and the counters `animation.paletteRows` and
+ * `animation.morphsWritten`. Morph targets blend on the CPU when their weights change (ADR-0088).
+ *
+ * @example
+ * const app = App.create({ core, plugins: [transformsPlugin(), renderPlugin({ canvas }), assetsPlugin(), gltfPlugin(), animationPlugin()] });
+ * const model = spawnAnimatedGltf(app.world, app.resource<Animation>('animation'), asset, render.Mesh!, { clip: 'Walk' });
+ */
+export function animationPlugin() {
+    return {
+        name: '@yali-engine/animation',
+        version: '0.4.0',
+        dependencies: [{ name: '@yali-engine/transforms', range: '^0.4.0' }],
+        build(b) {
+            const world = b.app.world;
+            const animation = new Animation(world);
+            const components = registerAnimation(world);
+            b.provide('animation', animation);
+            b.provide('animationComponents', components);
+            const source = () => animation.palette();
+            let animators;
+            let render;
+            b.system({
+                name: 'animation.update',
+                stage: 'Update',
+                run: (f) => {
+                    animation.update(f.time.virtualDelta);
+                    if (render === undefined) {
+                        try {
+                            render = b.app.resource('render');
+                            if (render.meshes)
+                                animation.morphs.setMeshes(render.meshes);
+                        }
+                        catch {
+                            render = null; // headless: nothing reads the palette
+                        }
+                    }
+                    animation.morphs.update();
+                    // The scene is replaced on device recovery: point the current one here every frame.
+                    if (render?.scene && render.scene.paletteSource !== source)
+                        render.scene.paletteSource = source;
+                },
+            });
+            b.counter('animation.paletteRows', () => animation.stats().paletteRows);
+            b.counter('animation.morphsWritten', () => animation.morphs.written);
+            b.tool({
+                name: 'animation.stats',
+                description: 'Animation asset counts (skeletons, clips, skins) and the palette rows skinned last frame.',
+                input: { type: 'object', properties: {} },
+                run: () => animation.stats(),
+            });
+            b.tool({
+                name: 'animation.play',
+                description: "Sets what an animator plays: its clip id, time (seconds), speed, looping, paused. Returns the animator's state.",
+                input: {
+                    type: 'object',
+                    properties: {
+                        entity: { type: 'number', description: 'The entity with anim.Animator (a spawnAnimatedGltf root).' },
+                        clip: { type: 'number', description: 'Clip id (0: none, the rest pose).' },
+                        time: { type: 'number', description: 'Seconds into the clip.' },
+                        speed: { type: 'number', description: '1 is normal speed.' },
+                        loop: { type: 'boolean' },
+                        paused: { type: 'boolean' },
+                    },
+                    required: ['entity'],
+                },
+                run: (args) => {
+                    const e = args.entity;
+                    const A = components.Animator;
+                    animators ??= world.query({ with: [A], columns: [[A, 'skeleton'], [A, 'clip'], [A, 'time'], [A, 'speed'], [A, 'flags']] });
+                    const cur = readAnimator(world, animators, e);
+                    const flags = (cur.flags & ~(ANIM_LOOP | ANIM_PAUSED)) | ((args.loop ?? (cur.flags & ANIM_LOOP) !== 0) ? ANIM_LOOP : 0) | ((args.paused ?? (cur.flags & ANIM_PAUSED) !== 0) ? ANIM_PAUSED : 0);
+                    const next = {
+                        skeleton: cur.skeleton,
+                        clip: args.clip ?? cur.clip,
+                        time: args.time ?? cur.time,
+                        speed: args.speed ?? cur.speed,
+                        flags,
+                    };
+                    world.insert(e, A, next);
+                    return { ...next, duration: animation.clipDuration(next.clip) };
+                },
+            });
+        },
+    };
+}
+/** An animator's fields, or a tool error naming the input at fault. */
+function readAnimator(world, q, e) {
+    if (!world.isAlive(e))
+        throw Object.assign(new YaliError('ENTITY_NOT_ALIVE', `Entity ${e} is not alive.`, 'Pass the root spawnAnimatedGltf returned (world.query with ["anim.Animator"] lists them).'), { path: 'entity' });
+    const chunks = q.run();
+    for (let c = 0; c < chunks; c++) {
+        const k = q.chunk(c);
+        for (let i = 0; i < k.length; i++) {
+            if (k.entity(i) !== e)
+                continue;
+            return { skeleton: k.u32(0)[i], clip: k.u32(1)[i], time: k.f32(2)[i], speed: k.f32(3)[i], flags: k.u8(4)[i] };
+        }
+    }
+    throw Object.assign(new YaliError('MISSING_COMPONENT', `Entity ${e} has no anim.Animator.`, 'Pass the root spawnAnimatedGltf returned.'), { path: 'entity' });
+}
+//# sourceMappingURL=plugin.js.map