reze-engine 0.8.1 → 0.8.2

package/README.md

@@ -2,110 +2,32 @@
 
 A lightweight engine built with WebGPU and TypeScript for real-time 3D anime character MMD model rendering.
 
-![screenshot](./screenshot.png)
-
 ## Features
 
-- Blinn-Phong lighting
-- Alpha blending
-- Post alpha eye rendering (the see-through eyes)
-- Rim lighting
-- Outlines
-- MSAA 4x anti-aliasing
-- Bone and morph API
-- VMD animation
-- IK solver
-- Ammo/Bullet physics
+- Blinn-Phong lighting, alpha blending, rim lighting, outlines, MSAA 4x
+- Post alpha eye rendering (see-through eyes)
+- Bone and morph API, VMD animation (multiple named, non-interruptible), IK solver, Ammo/Bullet physics
+- Multi-model (per-model materials, IK, physics)
 
 ## Usage
 
 ```javascript
 import { Engine, Model } from "reze-engine"
 
-export default function Scene() {
-  const canvasRef = useRef < HTMLCanvasElement > null
-  const engineRef = useRef < Engine > null
-
-  const initEngine = useCallback(async () => {
-    if (canvasRef.current) {
-      try {
-        const engine = new Engine(canvasRef.current, {})
-        engineRef.current = engine
-        await engine.init()
-        await Model.loadPmx("/models/reze/reze.pmx")
-
-        engine.runRenderLoop(() => {})
-      } catch (error) {
-        console.error(error)
-      }
-    }
-  }, [])
-
-  useEffect(() => {
-    void (async () => {
-      initEngine()
-    })()
-
-    return () => {
-      if (engineRef.current) {
-        engineRef.current.dispose()
-      }
-    }
-  }, [initEngine])
-
-  return <canvas ref={canvasRef} className="w-full h-full" />
-}
-```
-
-Engine options
-
-```javascript
-const DEFAULT_ENGINE_OPTIONS: RequiredEngineOptions = {
-  ambientColor: new Vec3(0.82, 0.82, 0.82),
-  directionalLightIntensity: 0.2,
-  minSpecularIntensity: 0.3,
-  rimLightIntensity: 0.4,
-  cameraDistance: 26.6,
-  cameraTarget: new Vec3(0, 12.5, 0),
-  cameraFov: Math.PI / 4,
-  onRaycast: undefined,
-}
-```
-
-## API
-
-Use **`Model.loadPmx(path)`** after **`await engine.init()`**—the model is registered on the engine automatically.
-
-### Animation (model instance)
-
-```javascript
-const model = await Model.loadPmx("/models/char.pmx")
+const engine = new Engine(canvas, {})
+await engine.init()
+const model = await Model.loadPmx("/models/reze/reze.pmx")
 await model.loadVmd("/animations/dance.vmd")
 model.playAnimation()
-model.pauseAnimation()
-model.stopAnimation()
-model.seekAnimation(2.5)
-
-const { current, duration, percentage } = model.getAnimationProgress()
-```
-
-### Bones / morphs (model)
-
-```javascript
-model.rotateBones({ 首: neckQuat, 頭: headQuat }, 300)
-model.moveBones({ センター: centerVec }, 300)
-model.setMorphWeight("まばたき", 1.0, 300)
-model.resetAllBones()
-model.resetAllMorphs()
+engine.runRenderLoop(() => {})
 ```
 
-### Engine
+## API (summary)
 
-```javascript
-engine.runRenderLoop(() => {})
-engine.setMaterialVisible("材質1", false)
-engine.addGround({ mode: "shadow", shadowMapSize: 1024 })
-```
+- **Multi-model:** `engine.addModel(model, pmxPath, name?)`, `getModel(name)`, `getModelNames()`, `removeModel(name)`, `setMaterialVisible(modelName, materialName, visible)`, `setModelIKEnabled(modelName, enabled)`, `setModelPhysicsEnabled(modelName, enabled)`, `resetPhysics()`, `markVertexBufferDirty(modelName?)`
+- **Animation:** `model.loadVmd(url)` (loads "default", no auto-play); `model.loadAnimation(name, vmdUrl)`; `model.show(name)`; `model.play()` / `model.play(name)`; `model.pause()`; `model.stop()`; `model.seek(t)`; `model.getAnimationProgress()`. Animations are non-interruptible (next is queued).
+- **Bones / morphs:** `model.rotateBones()`, `model.moveBones()`, `model.setMorphWeight()`, `model.resetAllBones()`, `model.resetAllMorphs()`
+- **Engine:** `runRenderLoop()`, `addGround({ mode: "reflection" | "shadow", ... })`, `onRaycast: (modelName, material, screenX, screenY) => {}`
 
 ## Projects Using This Engine
 

package/dist/animation.d.ts

@@ -1,3 +1,4 @@
+import { Quat, Vec3 } from "./math";
 export interface ControlPoint {
     x: number;
     y: number;
@@ -8,6 +9,79 @@ export interface BoneInterpolation {
     translationY: ControlPoint[];
     translationZ: ControlPoint[];
 }
+export interface BoneKeyframe {
+    boneName: string;
+    frame: number;
+    rotation: Quat;
+    translation: Vec3;
+    interpolation: BoneInterpolation;
+    time: number;
+}
+export interface MorphKeyframe {
+    morphName: string;
+    frame: number;
+    weight: number;
+    time: number;
+}
+/** Immutable clip data for one animation (e.g. one VMD). */
+export interface AnimationClip {
+    boneTracks: Map<string, BoneKeyframe[]>;
+    morphTracks: Map<string, MorphKeyframe[]>;
+    duration: number;
+    /** When true, clip loops at end. When false, playback stops and onEnd fires. Default false. */
+    loop?: boolean;
+}
+/**
+ * Per-model animation state: multiple animations, non-interruptible playback.
+ * While one is playing, play(name) queues it to start when the current one finishes.
+ */
+export declare class AnimationState {
+    private animations;
+    private currentAnimationName;
+    private currentTime;
+    private isPlaying;
+    private isPaused;
+    /** When current (non-loop) ends, play this next. Cleared when started. */
+    private nextAnimationName;
+    private onEnd;
+    /** Add or replace an animation by name. Does not start playback. */
+    loadAnimation(name: string, clip: AnimationClip): void;
+    /** Remove an animation. If it was current, state is cleared. */
+    removeAnimation(name: string): void;
+    /**
+     * Start playing an animation by name. Non-interruptible: if one is already playing,
+     * this animation is queued to start when the current one finishes.
+     */
+    play(name: string): boolean;
+    /** Resume current animation (no-op if none). */
+    play(): void;
+    /** Advance time. When a non-loop clip ends, starts nextAnimationName if set. */
+    update(deltaTime: number): {
+        ended: boolean;
+        animationName: string | null;
+    };
+    pause(): void;
+    stop(): void;
+    seek(time: number): void;
+    getCurrentClip(): AnimationClip | null;
+    getCurrentAnimation(): string | null;
+    getCurrentTime(): number;
+    getDuration(): number;
+    /** Progress of the current animation (time, duration, percentage). */
+    getProgress(): {
+        animationName: string | null;
+        current: number;
+        duration: number;
+        percentage: number;
+    };
+    getAnimationNames(): string[];
+    hasAnimation(name: string): boolean;
+    /** Show animation at time 0 without playing. Use after load when you want to play later (e.g. dance visualization). */
+    show(name: string): void;
+    setOnEnd(callback: ((animationName: string) => void) | null): void;
+    getPlaying(): boolean;
+    getPaused(): boolean;
+}
 export declare function bezierInterpolate(x1: number, x2: number, y1: number, y2: number, t: number): number;
 export declare function rawInterpolationToBoneInterpolation(raw: Uint8Array): BoneInterpolation;
 export declare function interpolateControlPoints(cp: ControlPoint[], t: number): number;

package/dist/animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,YAAY,EAAE,YAAY,EAAE,CAAA;IAC5B,YAAY,EAAE,YAAY,EAAE,CAAA;IAC5B,YAAY,EAAE,YAAY,EAAE,CAAA;CAC7B;AAGD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BnG;AAKD,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,UAAU,GAAG,iBAAiB,CAmBtF;AAGD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ9E"}
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"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"}

package/dist/animation.js

@@ -1,3 +1,154 @@
+/**
+ * Per-model animation state: multiple animations, non-interruptible playback.
+ * While one is playing, play(name) queues it to start when the current one finishes.
+ */
+export class AnimationState {
+    constructor() {
+        this.animations = new Map();
+        this.currentAnimationName = null;
+        this.currentTime = 0;
+        this.isPlaying = false;
+        this.isPaused = false;
+        /** When current (non-loop) ends, play this next. Cleared when started. */
+        this.nextAnimationName = null;
+        this.onEnd = null;
+    }
+    /** Add or replace an animation by name. Does not start playback. */
+    loadAnimation(name, clip) {
+        this.animations.set(name, clip);
+    }
+    /** Remove an animation. If it was current, state is cleared. */
+    removeAnimation(name) {
+        this.animations.delete(name);
+        if (this.currentAnimationName === name) {
+            this.currentAnimationName = null;
+            this.currentTime = 0;
+            this.isPlaying = false;
+            this.nextAnimationName = this.nextAnimationName === name ? null : this.nextAnimationName;
+        }
+        else if (this.nextAnimationName === name) {
+            this.nextAnimationName = null;
+        }
+    }
+    play(name) {
+        if (name === undefined) {
+            if (this.currentAnimationName && this.animations.has(this.currentAnimationName)) {
+                this.isPaused = false;
+                this.isPlaying = true;
+            }
+            return;
+        }
+        if (!this.animations.has(name))
+            return false;
+        if (this.isPlaying && !this.isPaused) {
+            this.nextAnimationName = name;
+            return true;
+        }
+        this.currentAnimationName = name;
+        this.currentTime = 0;
+        this.isPlaying = true;
+        this.isPaused = false;
+        this.nextAnimationName = null;
+        return true;
+    }
+    /** Advance time. When a non-loop clip ends, starts nextAnimationName if set. */
+    update(deltaTime) {
+        if (!this.isPlaying || this.isPaused || this.currentAnimationName === null) {
+            return { ended: false, animationName: this.currentAnimationName };
+        }
+        const clip = this.animations.get(this.currentAnimationName);
+        if (!clip)
+            return { ended: false, animationName: this.currentAnimationName };
+        this.currentTime += deltaTime;
+        const duration = clip.duration;
+        if (this.currentTime >= duration) {
+            this.currentTime = duration;
+            if (clip.loop) {
+                this.currentTime = 0;
+                return { ended: false, animationName: this.currentAnimationName };
+            }
+            const finishedName = this.currentAnimationName;
+            this.onEnd?.(finishedName);
+            if (this.nextAnimationName !== null) {
+                const next = this.nextAnimationName;
+                this.nextAnimationName = null;
+                this.currentAnimationName = next;
+                this.currentTime = 0;
+                this.isPlaying = true;
+                this.isPaused = false;
+                return { ended: true, animationName: finishedName };
+            }
+            this.isPlaying = false;
+            return { ended: true, animationName: finishedName };
+        }
+        return { ended: false, animationName: this.currentAnimationName };
+    }
+    pause() {
+        this.isPaused = true;
+    }
+    stop() {
+        this.isPlaying = false;
+        this.isPaused = false;
+        this.currentTime = 0;
+        this.nextAnimationName = null;
+    }
+    seek(time) {
+        const clip = this.getCurrentClip();
+        if (!clip)
+            return;
+        this.currentTime = Math.max(0, Math.min(time, clip.duration));
+    }
+    getCurrentClip() {
+        return this.currentAnimationName !== null ? this.animations.get(this.currentAnimationName) ?? null : null;
+    }
+    getCurrentAnimation() {
+        return this.currentAnimationName;
+    }
+    getCurrentTime() {
+        return this.currentTime;
+    }
+    getDuration() {
+        const clip = this.getCurrentClip();
+        return clip ? clip.duration : 0;
+    }
+    /** Progress of the current animation (time, duration, percentage). */
+    getProgress() {
+        const clip = this.getCurrentClip();
+        const duration = clip ? clip.duration : 0;
+        const percentage = duration > 0 ? (this.currentTime / duration) * 100 : 0;
+        return {
+            animationName: this.currentAnimationName,
+            current: this.currentTime,
+            duration,
+            percentage,
+        };
+    }
+    getAnimationNames() {
+        return Array.from(this.animations.keys());
+    }
+    hasAnimation(name) {
+        return this.animations.has(name);
+    }
+    /** Show animation at time 0 without playing. Use after load when you want to play later (e.g. dance visualization). */
+    show(name) {
+        if (!this.animations.has(name))
+            return;
+        this.currentAnimationName = name;
+        this.currentTime = 0;
+        this.isPlaying = false;
+        this.isPaused = false;
+        this.nextAnimationName = null;
+    }
+    setOnEnd(callback) {
+        this.onEnd = callback;
+    }
+    getPlaying() {
+        return this.isPlaying;
+    }
+    getPaused() {
+        return this.isPaused;
+    }
+}
 // Cubic bezier in normalized 0–1 space (binary search on x)
 export function bezierInterpolate(x1, x2, y1, y2, t) {
     t = Math.max(0, Math.min(1, t));

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { Engine, type EngineStats } from "./engine";
 export { Model } from "./model";
 export { Vec3, Quat, Mat4 } from "./math";
+export { AnimationState, type AnimationClip, type BoneKeyframe, type MorphKeyframe, } from "./animation";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { Engine } from "./engine";
 export { Model } from "./model";
 export { Vec3, Quat, Mat4 } from "./math";
+export { AnimationState, } from "./animation";

package/dist/model.d.ts

@@ -1,5 +1,6 @@
 import { Mat4, Quat, Vec3 } from "./math";
 import { Rigidbody, Joint } from "./physics";
+import { AnimationState } from "./animation";
 export interface Texture {
     path: string;
     name: string;
@@ -119,15 +120,10 @@ export declare class Model {
     private skinMatricesArray?;
     private tweenState;
     private tweenTimeMs;
-    private _hasAnimation;
-    private boneTracks;
-    private morphTracks;
-    private animationDuration;
-    private isPlaying;
-    private isPaused;
-    private animationTime;
+    private readonly animationState;
     private boneTrackIndices;
     private morphTrackIndices;
+    private lastAppliedClip;
     private ikEnabled;
     private physicsEnabled;
     constructor(vertexData: Float32Array<ArrayBuffer>, indexData: Uint32Array<ArrayBuffer>, textures: Texture[], materials: Material[], skeleton: Skeleton, skinning: Skinning, morphing: Morphing, rigidbodies?: Rigidbody[], joints?: Joint[]);
@@ -156,24 +152,46 @@ export declare class Model {
     getSkinMatrices(): Float32Array;
     setMorphWeight(name: string, weight: number, durationMs?: number): void;
     private applyMorphs;
+    /** Build an AnimationClip from VMD keyframes (used by loadVmd and loadAnimation). */
+    private buildClipFromVmdKeyFrames;
+    /** Load one VMD as the "default" animation and show first frame. Does not auto-play; call playAnimation() when needed. */
     loadVmd(vmdUrl: string): Promise<void>;
+    /** Load a VMD as a named animation (e.g. "idle", "walk", "attack"). Does not start playback. */
+    loadAnimation(animationName: string, vmdUrl: string): Promise<void>;
     resetAllBones(): void;
     resetAllMorphs(): void;
     setIKEnabled(enabled: boolean): void;
     setPhysicsEnabled(enabled: boolean): void;
     getPhysicsEnabled(): boolean;
+    /** Low-level access to animation state when needed. Prefer model.play(), model.show(), etc. */
+    getAnimationState(): AnimationState;
+    /** Resume current animation (no-op if none). */
+    play(): void;
+    /** Play named animation; if one is already playing, it is queued. Returns false if name not loaded. */
+    play(name: string): boolean;
+    /** Show named animation at time 0 without playing. Use after load when you want to play later. */
+    show(name: string): void;
+    /** @deprecated Use model.play() */
     playAnimation(): void;
+    pause(): void;
+    /** @deprecated Use model.pause() */
     pauseAnimation(): void;
+    stop(): void;
+    /** @deprecated Use model.stop() */
     stopAnimation(): void;
+    seek(time: number): void;
+    /** @deprecated Use model.seek() */
     seekAnimation(time: number): void;
     getAnimationProgress(): {
         current: number;
         duration: number;
         percentage: number;
+        animationName: string | null;
     };
     private static upperBound;
     private findKeyframeIndex;
-    private getPoseAtTime;
+    /** Apply pose from a clip at the given time. No-op if clip is null. */
+    private applyPoseFromClip;
     update(deltaTime: number): boolean;
     private solveIKChains;
     private ikComputedSet;

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -3,7 +3,7 @@ import { Engine } from "./engine";
 import { PmxLoader } from "./pmx-loader";
 import { IKSolverSystem } from "./ik-solver";
 import { VMDLoader } from "./vmd-loader";
-import { interpolateControlPoints, rawInterpolationToBoneInterpolation } from "./animation";
+import { AnimationState, interpolateControlPoints, rawInterpolationToBoneInterpolation, } from "./animation";
 const VMD_FPS = 30;
 const VERTEX_STRIDE = 8;
 export class Model {
@@ -34,17 +34,11 @@ export class Model {
         this.cachedIdentityMat1 = Mat4.identity();
         this.cachedIdentityMat2 = Mat4.identity();
         this.tweenTimeMs = 0; // Time tracking for tweens (milliseconds)
-        // Animation runtime
-        this._hasAnimation = false;
-        this.boneTracks = new Map();
-        this.morphTracks = new Map();
-        this.animationDuration = 0;
-        this.isPlaying = false;
-        this.isPaused = false;
-        this.animationTime = 0; // Current time in animation (seconds)
-        // Cached keyframe indices for faster lookup (per track)
+        // Animation: state and multiple slots (idle, walk, attack, etc.); commit/rollback for action-game style
+        this.animationState = new AnimationState();
         this.boneTrackIndices = new Map();
         this.morphTrackIndices = new Map();
+        this.lastAppliedClip = null;
         // IK and Physics enable flags
         this.ikEnabled = true;
         this.physicsEnabled = true;
@@ -543,11 +537,8 @@ export class Model {
             }
         }
     }
-    async loadVmd(vmdUrl) {
-        const vmdKeyFrames = await VMDLoader.load(vmdUrl);
-        this.resetAllBones();
-        this.resetAllMorphs();
-        // Build bone tracks: Map<boneName, Array<{boneName, frame, rotation, translation, interpolation, time}>>
+    /** Build an AnimationClip from VMD keyframes (used by loadVmd and loadAnimation). */
+    buildClipFromVmdKeyFrames(vmdKeyFrames) {
         const boneTracksByBone = {};
         for (const keyFrame of vmdKeyFrames) {
             for (const bf of keyFrame.boneFrames) {
@@ -561,11 +552,11 @@ export class Model {
                 });
             }
         }
-        this.boneTracks = new Map();
+        const boneTracks = new Map();
         for (const name in boneTracksByBone) {
             const keyframes = boneTracksByBone[name];
             const sorted = [...keyframes].sort((a, b) => a.frame - b.frame);
-            this.boneTracks.set(name, sorted.map((kf) => ({
+            boneTracks.set(name, sorted.map((kf) => ({
                 boneName: name,
                 frame: kf.frame,
                 rotation: kf.rotation,
@@ -574,7 +565,6 @@ export class Model {
                 time: kf.frame / VMD_FPS,
             })));
         }
-        // Build morph tracks: Map<morphName, Array<{morphName, frame, weight, time}>>
         const morphTracksByMorph = {};
         for (const keyFrame of vmdKeyFrames) {
             for (const mf of keyFrame.morphFrames) {
@@ -583,33 +573,43 @@ export class Model {
                 morphTracksByMorph[mf.morphName].push({ frame: mf.frame, weight: mf.weight });
             }
         }
-        this.morphTracks = new Map();
+        const morphTracks = new Map();
         for (const name in morphTracksByMorph) {
             const keyframes = morphTracksByMorph[name];
             const sorted = [...keyframes].sort((a, b) => a.frame - b.frame);
-            this.morphTracks.set(name, sorted.map((kf) => ({
+            morphTracks.set(name, sorted.map((kf) => ({
                 morphName: name,
                 frame: kf.frame,
                 weight: kf.weight,
                 time: kf.frame / VMD_FPS,
             })));
         }
-        this.boneTrackIndices.clear();
-        this.morphTrackIndices.clear();
-        // Calculate duration
         let maxTime = 0;
-        for (const frames of this.boneTracks.values()) {
+        for (const frames of boneTracks.values()) {
             if (frames.length > 0)
                 maxTime = Math.max(maxTime, frames[frames.length - 1].time);
         }
-        for (const frames of this.morphTracks.values()) {
+        for (const frames of morphTracks.values()) {
             if (frames.length > 0)
                 maxTime = Math.max(maxTime, frames[frames.length - 1].time);
         }
-        this.animationDuration = maxTime;
-        this._hasAnimation = true;
-        this.animationTime = 0;
-        this.getPoseAtTime(0);
+        return { boneTracks, morphTracks, duration: maxTime };
+    }
+    /** Load one VMD as the "default" animation and show first frame. Does not auto-play; call playAnimation() when needed. */
+    async loadVmd(vmdUrl) {
+        const vmdKeyFrames = await VMDLoader.load(vmdUrl);
+        this.resetAllBones();
+        this.resetAllMorphs();
+        const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames);
+        this.animationState.loadAnimation("default", clip);
+        this.animationState.show("default");
+        this.applyPoseFromClip(this.animationState.getCurrentClip(), 0);
+    }
+    /** Load a VMD as a named animation (e.g. "idle", "walk", "attack"). Does not start playback. */
+    async loadAnimation(animationName, vmdUrl) {
+        const vmdKeyFrames = await VMDLoader.load(vmdUrl);
+        const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames);
+        this.animationState.loadAnimation(animationName, clip);
     }
     resetAllBones() {
         for (let boneIdx = 0; boneIdx < this.skeleton.bones.length; boneIdx++) {
@@ -638,36 +638,49 @@ export class Model {
     getPhysicsEnabled() {
         return this.physicsEnabled;
     }
-    playAnimation() {
-        if (!this._hasAnimation)
+    /** Low-level access to animation state when needed. Prefer model.play(), model.show(), etc. */
+    getAnimationState() {
+        return this.animationState;
+    }
+    play(name) {
+        if (name === undefined) {
+            this.animationState.play();
             return;
-        this.isPaused = false;
-        this.isPlaying = true;
+        }
+        return this.animationState.play(name);
     }
+    /** Show named animation at time 0 without playing. Use after load when you want to play later. */
+    show(name) {
+        this.animationState.show(name);
+    }
+    /** @deprecated Use model.play() */
+    playAnimation() {
+        this.animationState.play();
+    }
+    pause() {
+        this.animationState.pause();
+    }
+    /** @deprecated Use model.pause() */
     pauseAnimation() {
-        if (!this.isPlaying || this.isPaused)
-            return;
-        this.isPaused = true;
+        this.animationState.pause();
+    }
+    stop() {
+        this.animationState.stop();
     }
+    /** @deprecated Use model.stop() */
     stopAnimation() {
-        this.isPlaying = false;
-        this.isPaused = false;
-        this.animationTime = 0;
+        this.animationState.stop();
+    }
+    seek(time) {
+        this.animationState.seek(time);
     }
+    /** @deprecated Use model.seek() */
     seekAnimation(time) {
-        if (!this._hasAnimation)
-            return;
-        const clampedTime = Math.max(0, Math.min(time, this.animationDuration));
-        this.animationTime = clampedTime;
+        this.animationState.seek(time);
     }
     getAnimationProgress() {
-        const duration = this.animationDuration;
-        const percentage = duration > 0 ? (this.animationTime / duration) * 100 : 0;
-        return {
-            current: this.animationTime,
-            duration,
-            percentage,
-        };
+        const p = this.animationState.getProgress();
+        return { current: p.current, duration: p.duration, percentage: p.percentage, animationName: p.animationName };
     }
     static upperBound(time, keyFrames, startIdx = 0) {
         let left = startIdx, right = keyFrames.length;
@@ -696,11 +709,16 @@ export class Model {
         const idx = Model.upperBound(time, keyFrames, 0) - 1;
         return idx;
     }
-    getPoseAtTime(time) {
-        if (!this._hasAnimation)
+    /** Apply pose from a clip at the given time. No-op if clip is null. */
+    applyPoseFromClip(clip, time) {
+        if (!clip)
             return;
-        // Process bone tracks
-        for (const [boneName, keyFrames] of this.boneTracks.entries()) {
+        if (clip !== this.lastAppliedClip) {
+            this.boneTrackIndices.clear();
+            this.morphTrackIndices.clear();
+            this.lastAppliedClip = clip;
+        }
+        for (const [boneName, keyFrames] of clip.boneTracks.entries()) {
             if (keyFrames.length === 0)
                 continue;
             const cachedIdx = this.boneTrackIndices.get(boneName) ?? -1;
@@ -737,8 +755,7 @@ export class Model {
                 localTrans.set(localTranslation);
             }
         }
-        // Process morph tracks
-        for (const [morphName, keyFrames] of this.morphTracks.entries()) {
+        for (const [morphName, keyFrames] of clip.morphTracks.entries()) {
             if (keyFrames.length === 0)
                 continue;
             const cachedIdx = this.morphTrackIndices.get(morphName) ?? -1;
@@ -767,20 +784,11 @@ export class Model {
         this.tweenTimeMs += deltaTime * 1000;
         // Update all active tweens (rotations, translations, morphs)
         const tweensChangedMorphs = this.updateTweens();
-        // Apply animation if playing or paused (always apply pose if animation data exists and we have a time set)
-        if (this._hasAnimation) {
-            if (this.isPlaying && !this.isPaused) {
-                this.animationTime += deltaTime;
-                if (this.animationTime >= this.animationDuration) {
-                    this.animationTime = this.animationDuration;
-                    this.pauseAnimation(); // Auto-pause at end
-                }
-                this.getPoseAtTime(this.animationTime);
-            }
-            else if (this.isPaused || (!this.isPlaying && this.animationTime >= 0)) {
-                // Apply pose at paused time or if we have a seeked time but not playing
-                this.getPoseAtTime(this.animationTime);
-            }
+        this.animationState.update(deltaTime);
+        const clip = this.animationState.getCurrentClip();
+        const time = this.animationState.getCurrentTime();
+        if (clip !== null) {
+            this.applyPoseFromClip(clip, time);
         }
         // Apply morphs if tweens changed morphs or animation changed morphs
         const verticesChanged = this.morphsDirty || tweensChangedMorphs;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "reze-engine",
-    "version": "0.8.1",
+    "version": "0.8.2",
     "description": "A WebGPU-based MMD model renderer",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",

package/src/animation.ts

@@ -1,3 +1,5 @@
+import { Quat, Vec3 } from "./math"
+
 export interface ControlPoint {
   x: number
   y: number
@@ -10,6 +12,204 @@ export interface BoneInterpolation {
   translationZ: ControlPoint[]
 }
 
+// Keyframe types for animation clips (used by Model and AnimationState)
+export interface BoneKeyframe {
+  boneName: string
+  frame: number
+  rotation: Quat
+  translation: Vec3
+  interpolation: BoneInterpolation
+  time: number
+}
+
+export interface MorphKeyframe {
+  morphName: string
+  frame: number
+  weight: number
+  time: number
+}
+
+/** Immutable clip data for one animation (e.g. one VMD). */
+export interface AnimationClip {
+  boneTracks: Map<string, BoneKeyframe[]>
+  morphTracks: Map<string, MorphKeyframe[]>
+  duration: number
+  /** When true, clip loops at end. When false, playback stops and onEnd fires. Default false. */
+  loop?: boolean
+}
+
+/**
+ * Per-model animation state: multiple animations, non-interruptible playback.
+ * While one is playing, play(name) queues it to start when the current one finishes.
+ */
+export class AnimationState {
+  private animations = new Map<string, AnimationClip>()
+  private currentAnimationName: string | null = null
+  private currentTime = 0
+  private isPlaying = false
+  private isPaused = false
+  /** When current (non-loop) ends, play this next. Cleared when started. */
+  private nextAnimationName: string | null = null
+  private onEnd: ((animationName: string) => void) | null = null
+
+  /** Add or replace an animation by name. Does not start playback. */
+  loadAnimation(name: string, clip: AnimationClip): void {
+    this.animations.set(name, clip)
+  }
+
+  /** Remove an animation. If it was current, state is cleared. */
+  removeAnimation(name: string): void {
+    this.animations.delete(name)
+    if (this.currentAnimationName === name) {
+      this.currentAnimationName = null
+      this.currentTime = 0
+      this.isPlaying = false
+      this.nextAnimationName = this.nextAnimationName === name ? null : this.nextAnimationName
+    } else if (this.nextAnimationName === name) {
+      this.nextAnimationName = null
+    }
+  }
+
+  /**
+   * Start playing an animation by name. Non-interruptible: if one is already playing,
+   * this animation is queued to start when the current one finishes.
+   */
+  play(name: string): boolean
+  /** Resume current animation (no-op if none). */
+  play(): void
+  play(name?: string): boolean | void {
+    if (name === undefined) {
+      if (this.currentAnimationName && this.animations.has(this.currentAnimationName)) {
+        this.isPaused = false
+        this.isPlaying = true
+      }
+      return
+    }
+    if (!this.animations.has(name)) return false
+    if (this.isPlaying && !this.isPaused) {
+      this.nextAnimationName = name
+      return true
+    }
+    this.currentAnimationName = name
+    this.currentTime = 0
+    this.isPlaying = true
+    this.isPaused = false
+    this.nextAnimationName = null
+    return true
+  }
+
+  /** Advance time. When a non-loop clip ends, starts nextAnimationName if set. */
+  update(deltaTime: number): { ended: boolean; animationName: string | null } {
+    if (!this.isPlaying || this.isPaused || this.currentAnimationName === null) {
+      return { ended: false, animationName: this.currentAnimationName }
+    }
+    const clip = this.animations.get(this.currentAnimationName)
+    if (!clip) return { ended: false, animationName: this.currentAnimationName }
+
+    this.currentTime += deltaTime
+    const duration = clip.duration
+
+    if (this.currentTime >= duration) {
+      this.currentTime = duration
+      if (clip.loop) {
+        this.currentTime = 0
+        return { ended: false, animationName: this.currentAnimationName }
+      }
+      const finishedName = this.currentAnimationName
+      this.onEnd?.(finishedName)
+      if (this.nextAnimationName !== null) {
+        const next = this.nextAnimationName
+        this.nextAnimationName = null
+        this.currentAnimationName = next
+        this.currentTime = 0
+        this.isPlaying = true
+        this.isPaused = false
+        return { ended: true, animationName: finishedName }
+      }
+      this.isPlaying = false
+      return { ended: true, animationName: finishedName }
+    }
+    return { ended: false, animationName: this.currentAnimationName }
+  }
+
+  pause(): void {
+    this.isPaused = true
+  }
+
+  stop(): void {
+    this.isPlaying = false
+    this.isPaused = false
+    this.currentTime = 0
+    this.nextAnimationName = null
+  }
+
+  seek(time: number): void {
+    const clip = this.getCurrentClip()
+    if (!clip) return
+    this.currentTime = Math.max(0, Math.min(time, clip.duration))
+  }
+
+  getCurrentClip(): AnimationClip | null {
+    return this.currentAnimationName !== null ? this.animations.get(this.currentAnimationName) ?? null : null
+  }
+
+  getCurrentAnimation(): string | null {
+    return this.currentAnimationName
+  }
+
+  getCurrentTime(): number {
+    return this.currentTime
+  }
+
+  getDuration(): number {
+    const clip = this.getCurrentClip()
+    return clip ? clip.duration : 0
+  }
+
+  /** Progress of the current animation (time, duration, percentage). */
+  getProgress(): { animationName: string | null; current: number; duration: number; percentage: number } {
+    const clip = this.getCurrentClip()
+    const duration = clip ? clip.duration : 0
+    const percentage = duration > 0 ? (this.currentTime / duration) * 100 : 0
+    return {
+      animationName: this.currentAnimationName,
+      current: this.currentTime,
+      duration,
+      percentage,
+    }
+  }
+
+  getAnimationNames(): string[] {
+    return Array.from(this.animations.keys())
+  }
+
+  hasAnimation(name: string): boolean {
+    return this.animations.has(name)
+  }
+
+  /** Show animation at time 0 without playing. Use after load when you want to play later (e.g. dance visualization). */
+  show(name: string): void {
+    if (!this.animations.has(name)) return
+    this.currentAnimationName = name
+    this.currentTime = 0
+    this.isPlaying = false
+    this.isPaused = false
+    this.nextAnimationName = null
+  }
+
+  setOnEnd(callback: ((animationName: string) => void) | null): void {
+    this.onEnd = callback
+  }
+
+  getPlaying(): boolean {
+    return this.isPlaying
+  }
+
+  getPaused(): boolean {
+    return this.isPaused
+  }
+}
+
 // Cubic bezier in normalized 0–1 space (binary search on x)
 export function bezierInterpolate(x1: number, x2: number, y1: number, y2: number, t: number): number {
   t = Math.max(0, Math.min(1, t))

package/src/index.ts

@@ -1,3 +1,9 @@
 export { Engine, type EngineStats } from "./engine"
 export { Model } from "./model"
 export { Vec3, Quat, Mat4 } from "./math"
+export {
+  AnimationState,
+  type AnimationClip,
+  type BoneKeyframe,
+  type MorphKeyframe,
+} from "./animation"

package/src/model.ts

@@ -3,8 +3,16 @@ import { Engine } from "./engine"
 import { PmxLoader } from "./pmx-loader"
 import { Rigidbody, Joint } from "./physics"
 import { IKSolverSystem } from "./ik-solver"
-import { VMDLoader } from "./vmd-loader"
-import { BoneInterpolation, interpolateControlPoints, rawInterpolationToBoneInterpolation } from "./animation"
+import { VMDLoader, type VMDKeyFrame } from "./vmd-loader"
+import {
+  AnimationClip,
+  AnimationState,
+  BoneInterpolation,
+  BoneKeyframe,
+  MorphKeyframe,
+  interpolateControlPoints,
+  rawInterpolationToBoneInterpolation,
+} from "./animation"
 
 const VMD_FPS = 30
 const VERTEX_STRIDE = 8
@@ -206,18 +214,11 @@ export class Model {
   private tweenState!: TweenState
   private tweenTimeMs: number = 0 // Time tracking for tweens (milliseconds)
 
-  // Animation runtime
-  private _hasAnimation: boolean = false
-  private boneTracks: Map<string, Array<{ boneName: string; frame: number; rotation: Quat; translation: Vec3; interpolation: BoneInterpolation; time: number }>> = new Map()
-  private morphTracks: Map<string, Array<{ morphName: string; frame: number; weight: number; time: number }>> = new Map()
-  private animationDuration: number = 0
-  private isPlaying: boolean = false
-  private isPaused: boolean = false
-  private animationTime: number = 0 // Current time in animation (seconds)
-
-  // Cached keyframe indices for faster lookup (per track)
+  // Animation: state and multiple slots (idle, walk, attack, etc.); commit/rollback for action-game style
+  private readonly animationState = new AnimationState()
   private boneTrackIndices: Map<string, number> = new Map()
   private morphTrackIndices: Map<string, number> = new Map()
+  private lastAppliedClip: AnimationClip | null = null
 
   // IK and Physics enable flags
   private ikEnabled = true
@@ -815,13 +816,8 @@ export class Model {
     }
   }
 
-  async loadVmd(vmdUrl: string): Promise<void> {
-    const vmdKeyFrames = await VMDLoader.load(vmdUrl)
-
-    this.resetAllBones()
-    this.resetAllMorphs()
-
-    // Build bone tracks: Map<boneName, Array<{boneName, frame, rotation, translation, interpolation, time}>>
+  /** Build an AnimationClip from VMD keyframes (used by loadVmd and loadAnimation). */
+  private buildClipFromVmdKeyFrames(vmdKeyFrames: VMDKeyFrame[]): AnimationClip {
     const boneTracksByBone: Record<string, Array<{ frame: number; rotation: Quat; translation: Vec3; interpolation: BoneInterpolation }>> = {}
     for (const keyFrame of vmdKeyFrames) {
       for (const bf of keyFrame.boneFrames) {
@@ -834,12 +830,11 @@ export class Model {
         })
       }
     }
-
-    this.boneTracks = new Map()
+    const boneTracks = new Map<string, BoneKeyframe[]>()
     for (const name in boneTracksByBone) {
       const keyframes = boneTracksByBone[name]
       const sorted = [...keyframes].sort((a, b) => a.frame - b.frame)
-      this.boneTracks.set(
+      boneTracks.set(
         name,
         sorted.map((kf) => ({
           boneName: name,
@@ -851,8 +846,6 @@ export class Model {
         }))
       )
     }
-
-    // Build morph tracks: Map<morphName, Array<{morphName, frame, weight, time}>>
     const morphTracksByMorph: Record<string, Array<{ frame: number; weight: number }>> = {}
     for (const keyFrame of vmdKeyFrames) {
       for (const mf of keyFrame.morphFrames) {
@@ -860,12 +853,11 @@ export class Model {
         morphTracksByMorph[mf.morphName].push({ frame: mf.frame, weight: mf.weight })
       }
     }
-
-    this.morphTracks = new Map()
+    const morphTracks = new Map<string, MorphKeyframe[]>()
     for (const name in morphTracksByMorph) {
       const keyframes = morphTracksByMorph[name]
       const sorted = [...keyframes].sort((a, b) => a.frame - b.frame)
-      this.morphTracks.set(
+      morphTracks.set(
         name,
         sorted.map((kf) => ({
           morphName: name,
@@ -875,24 +867,32 @@ export class Model {
         }))
       )
     }
-
-    this.boneTrackIndices.clear()
-    this.morphTrackIndices.clear()
-
-    // Calculate duration
     let maxTime = 0
-    for (const frames of this.boneTracks.values()) {
+    for (const frames of boneTracks.values()) {
       if (frames.length > 0) maxTime = Math.max(maxTime, frames[frames.length - 1].time)
     }
-    for (const frames of this.morphTracks.values()) {
+    for (const frames of morphTracks.values()) {
       if (frames.length > 0) maxTime = Math.max(maxTime, frames[frames.length - 1].time)
     }
-    this.animationDuration = maxTime
+    return { boneTracks, morphTracks, duration: maxTime }
+  }
 
-    this._hasAnimation = true
-    this.animationTime = 0
-    this.getPoseAtTime(0)
+  /** Load one VMD as the "default" animation and show first frame. Does not auto-play; call playAnimation() when needed. */
+  async loadVmd(vmdUrl: string): Promise<void> {
+    const vmdKeyFrames = await VMDLoader.load(vmdUrl)
+    this.resetAllBones()
+    this.resetAllMorphs()
+    const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames)
+    this.animationState.loadAnimation("default", clip)
+    this.animationState.show("default")
+    this.applyPoseFromClip(this.animationState.getCurrentClip(), 0)
+  }
 
+  /** Load a VMD as a named animation (e.g. "idle", "walk", "attack"). Does not start playback. */
+  async loadAnimation(animationName: string, vmdUrl: string): Promise<void> {
+    const vmdKeyFrames = await VMDLoader.load(vmdUrl)
+    const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames)
+    this.animationState.loadAnimation(animationName, clip)
   }
 
   public resetAllBones(): void {
@@ -928,39 +928,63 @@ export class Model {
     return this.physicsEnabled
   }
 
-  playAnimation(): void {
-    if (!this._hasAnimation) return
+  /** Low-level access to animation state when needed. Prefer model.play(), model.show(), etc. */
+  getAnimationState(): AnimationState {
+    return this.animationState
+  }
+
+  /** Resume current animation (no-op if none). */
+  play(): void
+  /** Play named animation; if one is already playing, it is queued. Returns false if name not loaded. */
+  play(name: string): boolean
+  play(name?: string): void | boolean {
+    if (name === undefined) {
+      this.animationState.play()
+      return
+    }
+    return this.animationState.play(name)
+  }
 
-    this.isPaused = false
-    this.isPlaying = true
+  /** Show named animation at time 0 without playing. Use after load when you want to play later. */
+  show(name: string): void {
+    this.animationState.show(name)
+  }
 
+  /** @deprecated Use model.play() */
+  playAnimation(): void {
+    this.animationState.play()
   }
 
+  pause(): void {
+    this.animationState.pause()
+  }
+
+  /** @deprecated Use model.pause() */
   pauseAnimation(): void {
-    if (!this.isPlaying || this.isPaused) return
-    this.isPaused = true
+    this.animationState.pause()
   }
 
+  stop(): void {
+    this.animationState.stop()
+  }
+
+  /** @deprecated Use model.stop() */
   stopAnimation(): void {
-    this.isPlaying = false
-    this.isPaused = false
-    this.animationTime = 0
+    this.animationState.stop()
+  }
+
+  seek(time: number): void {
+    this.animationState.seek(time)
   }
 
+  /** @deprecated Use model.seek() */
   seekAnimation(time: number): void {
-    if (!this._hasAnimation) return
-    const clampedTime = Math.max(0, Math.min(time, this.animationDuration))
-    this.animationTime = clampedTime
+    this.animationState.seek(time)
   }
 
-  getAnimationProgress(): { current: number; duration: number; percentage: number } {
-    const duration = this.animationDuration
-    const percentage = duration > 0 ? (this.animationTime / duration) * 100 : 0
-    return {
-      current: this.animationTime,
-      duration,
-      percentage,
-    }
+  getAnimationProgress(): { current: number; duration: number; percentage: number; animationName: string | null } {
+    const p = this.animationState.getProgress()
+    return { current: p.current, duration: p.duration, percentage: p.percentage, animationName: p.animationName }
   }
 
   private static upperBound<T extends { time: number }>(time: number, keyFrames: T[], startIdx: number = 0): number {
@@ -993,11 +1017,16 @@ export class Model {
     return idx
   }
 
-  private getPoseAtTime(time: number): void {
-    if (!this._hasAnimation) return
+  /** Apply pose from a clip at the given time. No-op if clip is null. */
+  private applyPoseFromClip(clip: AnimationClip | null, time: number): void {
+    if (!clip) return
+    if (clip !== this.lastAppliedClip) {
+      this.boneTrackIndices.clear()
+      this.morphTrackIndices.clear()
+      this.lastAppliedClip = clip
+    }
 
-    // Process bone tracks
-    for (const [boneName, keyFrames] of this.boneTracks.entries()) {
+    for (const [boneName, keyFrames] of clip.boneTracks.entries()) {
       if (keyFrames.length === 0) continue
 
       const cachedIdx = this.boneTrackIndices.get(boneName) ?? -1
@@ -1047,8 +1076,7 @@ export class Model {
       }
     }
 
-    // Process morph tracks
-    for (const [morphName, keyFrames] of this.morphTracks.entries()) {
+    for (const [morphName, keyFrames] of clip.morphTracks.entries()) {
       if (keyFrames.length === 0) continue
 
       const cachedIdx = this.morphTrackIndices.get(morphName) ?? -1
@@ -1084,21 +1112,11 @@ export class Model {
     // Update all active tweens (rotations, translations, morphs)
     const tweensChangedMorphs = this.updateTweens()
 
-    // Apply animation if playing or paused (always apply pose if animation data exists and we have a time set)
-    if (this._hasAnimation) {
-      if (this.isPlaying && !this.isPaused) {
-        this.animationTime += deltaTime
-
-        if (this.animationTime >= this.animationDuration) {
-          this.animationTime = this.animationDuration
-          this.pauseAnimation() // Auto-pause at end
-        }
-
-        this.getPoseAtTime(this.animationTime)
-      } else if (this.isPaused || (!this.isPlaying && this.animationTime >= 0)) {
-        // Apply pose at paused time or if we have a seeked time but not playing
-        this.getPoseAtTime(this.animationTime)
-      }
+    this.animationState.update(deltaTime)
+    const clip = this.animationState.getCurrentClip()
+    const time = this.animationState.getCurrentTime()
+    if (clip !== null) {
+      this.applyPoseFromClip(clip, time)
     }
 
     // Apply morphs if tweens changed morphs or animation changed morphs