three-stdlib 2.16.0 → 2.16.2

package/animation/MMDAnimationHelper.js

@@ -1,22 +1,40 @@
-"use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const THREE = require("three");
-const CCDIKSolver = require("./CCDIKSolver.js");
-const MMDPhysics = require("./MMDPhysics.js");
+import { Quaternion, Object3D, Vector3, AnimationMixer } from 'three';
+import { CCDIKSolver } from './CCDIKSolver.js';
+import { MMDPhysics } from './MMDPhysics.js';
+
+/**
+ * MMDAnimationHelper handles animation of MMD assets loaded by MMDLoader
+ * with MMD special features as IK, Grant, and Physics.
+ *
+ * Dependencies
+ *  - ammo.js https://github.com/kripken/ammo.js
+ *  - MMDPhysics
+ *  - CCDIKSolver
+ *
+ * TODO
+ *  - more precise grant skinning support.
+ */
+
 const MMDAnimationHelper = (() => {
-  function MMDAnimationHelper2(params) {
+  /**
+   * @param {Object} params - (optional)
+   * @param {boolean} params.sync - Whether animation durations of added objects are synched. Default is true.
+   * @param {Number} params.afterglow - Default is 0.0.
+   * @param {boolean} params.resetPhysicsOnLoop - Default is true.
+   */
+  function MMDAnimationHelper(params) {
     params = params || {};
     this.meshes = [];
     this.camera = null;
-    this.cameraTarget = new THREE.Object3D();
-    this.cameraTarget.name = "target";
+    this.cameraTarget = new Object3D();
+    this.cameraTarget.name = 'target';
     this.audio = null;
     this.audioManager = null;
-    this.objects = /* @__PURE__ */ new WeakMap();
+    this.objects = new WeakMap();
     this.configuration = {
-      sync: params.sync !== void 0 ? params.sync : true,
-      afterglow: params.afterglow !== void 0 ? params.afterglow : 0,
-      resetPhysicsOnLoop: params.resetPhysicsOnLoop !== void 0 ? params.resetPhysicsOnLoop : true
+      sync: params.sync !== undefined ? params.sync : true,
+      afterglow: params.afterglow !== undefined ? params.afterglow : 0.0,
+      resetPhysicsOnLoop: params.resetPhysicsOnLoop !== undefined ? params.resetPhysicsOnLoop : true
     };
     this.enabled = {
       animation: true,
@@ -25,135 +43,212 @@ const MMDAnimationHelper = (() => {
       physics: true,
       cameraAnimation: true
     };
-    this.onBeforePhysics = () => {
-    };
+
+    this.onBeforePhysics = () =>
+    /* mesh */
+    {}; // experimental
+
+
     this.sharedPhysics = false;
     this.masterPhysics = null;
   }
-  MMDAnimationHelper2.prototype = {
-    constructor: MMDAnimationHelper2,
-    add: function(object, params) {
+
+  MMDAnimationHelper.prototype = {
+    constructor: MMDAnimationHelper,
+
+    /**
+     * Adds an Three.js Object to helper and setups animation.
+     * The anmation durations of added objects are synched
+     * if this.configuration.sync is true.
+     *
+     * @param {THREE.SkinnedMesh|THREE.Camera|THREE.Audio} object
+     * @param {Object} params - (optional)
+     * @param {THREE.AnimationClip|Array<THREE.AnimationClip>} params.animation - Only for THREE.SkinnedMesh and THREE.Camera. Default is undefined.
+     * @param {boolean} params.physics - Only for THREE.SkinnedMesh. Default is true.
+     * @param {Integer} params.warmup - Only for THREE.SkinnedMesh and physics is true. Default is 60.
+     * @param {Number} params.unitStep - Only for THREE.SkinnedMesh and physics is true. Default is 1 / 65.
+     * @param {Integer} params.maxStepNum - Only for THREE.SkinnedMesh and physics is true. Default is 3.
+     * @param {Vector3} params.gravity - Only for THREE.SkinnedMesh and physics is true. Default ( 0, - 9.8 * 10, 0 ).
+     * @param {Number} params.delayTime - Only for THREE.Audio. Default is 0.0.
+     * @return {MMDAnimationHelper}
+     */
+    add: function (object, params) {
       params = params || {};
+
       if (object.isSkinnedMesh) {
         this._addMesh(object, params);
       } else if (object.isCamera) {
         this._setupCamera(object, params);
-      } else if (object.type === "Audio") {
+      } else if (object.type === 'Audio') {
         this._setupAudio(object, params);
       } else {
-        throw new Error(
-          "THREE.MMDAnimationHelper.add: accepts only THREE.SkinnedMesh or THREE.Camera or THREE.Audio instance."
-        );
+        throw new Error('THREE.MMDAnimationHelper.add: ' + 'accepts only ' + 'THREE.SkinnedMesh or ' + 'THREE.Camera or ' + 'THREE.Audio instance.');
       }
-      if (this.configuration.sync)
-        this._syncDuration();
+
+      if (this.configuration.sync) this._syncDuration();
       return this;
     },
-    remove: function(object) {
+
+    /**
+     * Removes an Three.js Object from helper.
+     *
+     * @param {THREE.SkinnedMesh|THREE.Camera|THREE.Audio} object
+     * @return {MMDAnimationHelper}
+     */
+    remove: function (object) {
       if (object.isSkinnedMesh) {
         this._removeMesh(object);
       } else if (object.isCamera) {
         this._clearCamera(object);
-      } else if (object.type === "Audio") {
+      } else if (object.type === 'Audio') {
         this._clearAudio(object);
       } else {
-        throw new Error(
-          "THREE.MMDAnimationHelper.remove: accepts only THREE.SkinnedMesh or THREE.Camera or THREE.Audio instance."
-        );
+        throw new Error('THREE.MMDAnimationHelper.remove: ' + 'accepts only ' + 'THREE.SkinnedMesh or ' + 'THREE.Camera or ' + 'THREE.Audio instance.');
       }
-      if (this.configuration.sync)
-        this._syncDuration();
+
+      if (this.configuration.sync) this._syncDuration();
       return this;
     },
-    update: function(delta) {
-      if (this.audioManager !== null)
-        this.audioManager.control(delta);
+
+    /**
+     * Updates the animation.
+     *
+     * @param {Number} delta
+     * @return {MMDAnimationHelper}
+     */
+    update: function (delta) {
+      if (this.audioManager !== null) this.audioManager.control(delta);
+
       for (let i = 0; i < this.meshes.length; i++) {
         this._animateMesh(this.meshes[i], delta);
       }
-      if (this.sharedPhysics)
-        this._updateSharedPhysics(delta);
-      if (this.camera !== null)
-        this._animateCamera(this.camera, delta);
+
+      if (this.sharedPhysics) this._updateSharedPhysics(delta);
+      if (this.camera !== null) this._animateCamera(this.camera, delta);
       return this;
     },
-    pose: function(mesh, vpd, params) {
+
+    /**
+     * Changes the pose of SkinnedMesh as VPD specifies.
+     *
+     * @param {THREE.SkinnedMesh} mesh
+     * @param {Object} vpd - VPD content parsed MMDParser
+     * @param {Object} params - (optional)
+     * @param {boolean} params.resetPose - Default is true.
+     * @param {boolean} params.ik - Default is true.
+     * @param {boolean} params.grant - Default is true.
+     * @return {MMDAnimationHelper}
+     */
+    pose: function (mesh, vpd, params) {
       params = params || {};
-      if (params.resetPose !== false)
-        mesh.pose();
+      if (params.resetPose !== false) mesh.pose();
       const bones = mesh.skeleton.bones;
       const boneParams = vpd.bones;
       const boneNameDictionary = {};
+
       for (let i = 0, il = bones.length; i < il; i++) {
         boneNameDictionary[bones[i].name] = i;
       }
-      const vector = new THREE.Vector3();
-      const quaternion = new THREE.Quaternion();
+
+      const vector = new Vector3();
+      const quaternion = new Quaternion();
+
       for (let i = 0, il = boneParams.length; i < il; i++) {
         const boneParam = boneParams[i];
         const boneIndex = boneNameDictionary[boneParam.name];
-        if (boneIndex === void 0)
-          continue;
+        if (boneIndex === undefined) continue;
         const bone = bones[boneIndex];
         bone.position.add(vector.fromArray(boneParam.translation));
         bone.quaternion.multiply(quaternion.fromArray(boneParam.quaternion));
       }
+
       mesh.updateMatrixWorld(true);
+
       if (params.ik !== false) {
-        this._createCCDIKSolver(mesh).update(params.saveOriginalBonesBeforeIK);
+        this._createCCDIKSolver(mesh).update(params.saveOriginalBonesBeforeIK); // this param is experimental
+
       }
+
       if (params.grant !== false) {
         this.createGrantSolver(mesh).update();
       }
+
       return this;
     },
-    enable: function(key, enabled) {
-      if (this.enabled[key] === void 0) {
+
+    /**
+     * Enabes/Disables an animation feature.
+     *
+     * @param {string} key
+     * @param {boolean} enabled
+     * @return {MMDAnimationHelper}
+     */
+    enable: function (key, enabled) {
+      if (this.enabled[key] === undefined) {
         throw new Error(`THREE.MMDAnimationHelper.enable: unknown key ${key}`);
       }
+
       this.enabled[key] = enabled;
-      if (key === "physics") {
+
+      if (key === 'physics') {
         for (let i = 0, il = this.meshes.length; i < il; i++) {
           this._optimizeIK(this.meshes[i], enabled);
         }
       }
+
       return this;
     },
-    createGrantSolver: function(mesh) {
+
+    /**
+     * Creates an GrantSolver instance.
+     *
+     * @param {THREE.SkinnedMesh} mesh
+     * @return {GrantSolver}
+     */
+    createGrantSolver: function (mesh) {
       return new GrantSolver(mesh, mesh.geometry.userData.MMD.grants);
     },
-    _addMesh: function(mesh, params) {
+    // private methods
+    _addMesh: function (mesh, params) {
       if (this.meshes.indexOf(mesh) >= 0) {
         throw new Error(`THREE.MMDAnimationHelper._addMesh: SkinnedMesh '${mesh.name}' has already been added.`);
       }
+
       this.meshes.push(mesh);
-      this.objects.set(mesh, { looped: false });
+      this.objects.set(mesh, {
+        looped: false
+      });
+
       this._setupMeshAnimation(mesh, params.animation);
+
       if (params.physics !== false) {
         this._setupMeshPhysics(mesh, params);
       }
+
       return this;
     },
-    _setupCamera: function(camera, params) {
+    _setupCamera: function (camera, params) {
       if (this.camera === camera) {
         throw new Error(`THREE.MMDAnimationHelper._setupCamera: Camera '${camera.name}' has already been set.`);
       }
-      if (this.camera)
-        this.clearCamera(this.camera);
+
+      if (this.camera) this.clearCamera(this.camera);
       this.camera = camera;
       camera.add(this.cameraTarget);
       this.objects.set(camera, {});
-      if (params.animation !== void 0) {
+
+      if (params.animation !== undefined) {
         this._setupCameraAnimation(camera, params.animation);
       }
+
       return this;
     },
-    _setupAudio: function(audio, params) {
+    _setupAudio: function (audio, params) {
       if (this.audio === audio) {
         throw new Error(`THREE.MMDAnimationHelper._setupAudio: Audio '${audio.name}' has already been set.`);
       }
-      if (this.audio)
-        this.clearAudio(this.audio);
+
+      if (this.audio) this.clearAudio(this.audio);
       this.audio = audio;
       this.audioManager = new AudioManager(audio, params);
       this.objects.set(this.audioManager, {
@@ -161,114 +256,140 @@ const MMDAnimationHelper = (() => {
       });
       return this;
     },
-    _removeMesh: function(mesh) {
+    _removeMesh: function (mesh) {
       let found = false;
       let writeIndex = 0;
+
       for (let i = 0, il = this.meshes.length; i < il; i++) {
         if (this.meshes[i] === mesh) {
           this.objects.delete(mesh);
           found = true;
           continue;
         }
+
         this.meshes[writeIndex++] = this.meshes[i];
       }
+
       if (!found) {
         throw new Error(`THREE.MMDAnimationHelper._removeMesh: SkinnedMesh '${mesh.name}' has not been added yet.`);
       }
+
       this.meshes.length = writeIndex;
       return this;
     },
-    _clearCamera: function(camera) {
+    _clearCamera: function (camera) {
       if (camera !== this.camera) {
         throw new Error(`THREE.MMDAnimationHelper._clearCamera: Camera '${camera.name}' has not been set yet.`);
       }
+
       this.camera.remove(this.cameraTarget);
       this.objects.delete(this.camera);
       this.camera = null;
       return this;
     },
-    _clearAudio: function(audio) {
+    _clearAudio: function (audio) {
       if (audio !== this.audio) {
         throw new Error(`THREE.MMDAnimationHelper._clearAudio: Audio '${audio.name}' has not been set yet.`);
       }
+
       this.objects.delete(this.audioManager);
       this.audio = null;
       this.audioManager = null;
       return this;
     },
-    _setupMeshAnimation: function(mesh, animation) {
+    _setupMeshAnimation: function (mesh, animation) {
       const objects = this.objects.get(mesh);
-      if (animation !== void 0) {
+
+      if (animation !== undefined) {
         const animations = Array.isArray(animation) ? animation : [animation];
-        objects.mixer = new THREE.AnimationMixer(mesh);
+        objects.mixer = new AnimationMixer(mesh);
+
         for (let i = 0, il = animations.length; i < il; i++) {
           objects.mixer.clipAction(animations[i]).play();
-        }
-        objects.mixer.addEventListener("loop", (event) => {
+        } // TODO: find a workaround not to access ._clip looking like a private property
+
+
+        objects.mixer.addEventListener('loop', event => {
           const tracks = event.action._clip.tracks;
-          if (tracks.length > 0 && tracks[0].name.slice(0, 6) !== ".bones")
-            return;
+          if (tracks.length > 0 && tracks[0].name.slice(0, 6) !== '.bones') return;
           objects.looped = true;
         });
       }
+
       objects.ikSolver = this._createCCDIKSolver(mesh);
       objects.grantSolver = this.createGrantSolver(mesh);
       return this;
     },
-    _setupCameraAnimation: function(camera, animation) {
+    _setupCameraAnimation: function (camera, animation) {
       const animations = Array.isArray(animation) ? animation : [animation];
       const objects = this.objects.get(camera);
-      objects.mixer = new THREE.AnimationMixer(camera);
+      objects.mixer = new AnimationMixer(camera);
+
       for (let i = 0, il = animations.length; i < il; i++) {
         objects.mixer.clipAction(animations[i]).play();
       }
     },
-    _setupMeshPhysics: function(mesh, params) {
-      const objects = this.objects.get(mesh);
-      if (params.world === void 0 && this.sharedPhysics) {
+    _setupMeshPhysics: function (mesh, params) {
+      const objects = this.objects.get(mesh); // shared physics is experimental
+
+      if (params.world === undefined && this.sharedPhysics) {
         const masterPhysics = this._getMasterPhysics();
-        if (masterPhysics !== null)
-          world = masterPhysics.world;
+
+        if (masterPhysics !== null) world = masterPhysics.world; // eslint-disable-line no-undef
       }
+
       objects.physics = this._createMMDPhysics(mesh, params);
+
       if (objects.mixer && params.animationWarmup !== false) {
         this._animateMesh(mesh, 0);
+
         objects.physics.reset();
       }
-      objects.physics.warmup(params.warmup !== void 0 ? params.warmup : 60);
+
+      objects.physics.warmup(params.warmup !== undefined ? params.warmup : 60);
+
       this._optimizeIK(mesh, true);
     },
-    _animateMesh: function(mesh, delta) {
+    _animateMesh: function (mesh, delta) {
       const objects = this.objects.get(mesh);
       const mixer = objects.mixer;
       const ikSolver = objects.ikSolver;
       const grantSolver = objects.grantSolver;
       const physics = objects.physics;
-      const looped = objects.looped;
+      const looped = objects.looped; // alternate solution to save/restore bones but less performant?
+      //mesh.pose();
+      //this._updatePropertyMixersBuffer( mesh );
+
       if (mixer && this.enabled.animation) {
         this._restoreBones(mesh);
+
         mixer.update(delta);
+
         this._saveBones(mesh);
+
         if (ikSolver && this.enabled.ik) {
           mesh.updateMatrixWorld(true);
           ikSolver.update();
         }
+
         if (grantSolver && this.enabled.grant) {
           grantSolver.update();
         }
       }
+
       if (looped === true && this.enabled.physics) {
-        if (physics && this.configuration.resetPhysicsOnLoop)
-          physics.reset();
+        if (physics && this.configuration.resetPhysicsOnLoop) physics.reset();
         objects.looped = false;
       }
+
       if (physics && this.enabled.physics && !this.sharedPhysics) {
         this.onBeforePhysics(mesh);
         physics.update(delta);
       }
     },
-    _animateCamera: function(camera, delta) {
+    _animateCamera: function (camera, delta) {
       const mixer = this.objects.get(camera).mixer;
+
       if (mixer && this.enabled.cameraAnimation) {
         mixer.update(delta);
         camera.updateProjectionMatrix();
@@ -277,15 +398,20 @@ const MMDAnimationHelper = (() => {
         camera.lookAt(this.cameraTarget.position);
       }
     },
-    _optimizeIK: function(mesh, physicsEnabled) {
+    _optimizeIK: function (mesh, physicsEnabled) {
       const iks = mesh.geometry.userData.MMD.iks;
       const bones = mesh.geometry.userData.MMD.bones;
+
       for (let i = 0, il = iks.length; i < il; i++) {
         const ik = iks[i];
         const links = ik.links;
+
         for (let j = 0, jl = links.length; j < jl; j++) {
           const link = links[j];
+
           if (physicsEnabled === true) {
+            // disable IK of the bone the corresponding rigidBody type of which is 1 or 2
+            // because its rotation will be overriden by physics
             link.enabled = bones[link.index].rigidBodyType > 0 ? false : true;
           } else {
             link.enabled = true;
@@ -293,85 +419,102 @@ const MMDAnimationHelper = (() => {
         }
       }
     },
-    _createCCDIKSolver: function(mesh) {
-      if (CCDIKSolver.CCDIKSolver === void 0) {
-        throw new Error("THREE.MMDAnimationHelper: Import CCDIKSolver.");
+    _createCCDIKSolver: function (mesh) {
+      if (CCDIKSolver === undefined) {
+        throw new Error('THREE.MMDAnimationHelper: Import CCDIKSolver.');
       }
-      return new CCDIKSolver.CCDIKSolver(mesh, mesh.geometry.userData.MMD.iks);
+
+      return new CCDIKSolver(mesh, mesh.geometry.userData.MMD.iks);
     },
-    _createMMDPhysics: function(mesh, params) {
-      if (MMDPhysics.MMDPhysics === void 0) {
-        throw new Error("THREE.MMDPhysics: Import MMDPhysics.");
-      }
-      return new MMDPhysics.MMDPhysics(
-        mesh,
-        mesh.geometry.userData.MMD.rigidBodies,
-        mesh.geometry.userData.MMD.constraints,
-        params
-      );
+    _createMMDPhysics: function (mesh, params) {
+      if (MMDPhysics === undefined) {
+        throw new Error('THREE.MMDPhysics: Import MMDPhysics.');
+      }
+
+      return new MMDPhysics(mesh, mesh.geometry.userData.MMD.rigidBodies, mesh.geometry.userData.MMD.constraints, params);
     },
-    _syncDuration: function() {
-      let max = 0;
+
+    /*
+     * Detects the longest duration and then sets it to them to sync.
+     * TODO: Not to access private properties ( ._actions and ._clip )
+     */
+    _syncDuration: function () {
+      let max = 0.0;
       const objects = this.objects;
       const meshes = this.meshes;
       const camera = this.camera;
-      const audioManager = this.audioManager;
+      const audioManager = this.audioManager; // get the longest duration
+
       for (let i = 0, il = meshes.length; i < il; i++) {
         var mixer = this.objects.get(meshes[i]).mixer;
-        if (mixer === void 0)
-          continue;
+        if (mixer === undefined) continue;
+
         for (let j = 0; j < mixer._actions.length; j++) {
           var clip = mixer._actions[j]._clip;
+
           if (!objects.has(clip)) {
             objects.set(clip, {
               duration: clip.duration
             });
           }
+
           max = Math.max(max, objects.get(clip).duration);
         }
       }
+
       if (camera !== null) {
         var mixer = this.objects.get(camera).mixer;
-        if (mixer !== void 0) {
+
+        if (mixer !== undefined) {
           for (let i = 0, il = mixer._actions.length; i < il; i++) {
             var clip = mixer._actions[i]._clip;
+
             if (!objects.has(clip)) {
               objects.set(clip, {
                 duration: clip.duration
               });
             }
+
             max = Math.max(max, objects.get(clip).duration);
           }
         }
       }
+
       if (audioManager !== null) {
         max = Math.max(max, objects.get(audioManager).duration);
       }
-      max += this.configuration.afterglow;
+
+      max += this.configuration.afterglow; // update the duration
+
       for (let i = 0, il = this.meshes.length; i < il; i++) {
         var mixer = this.objects.get(this.meshes[i]).mixer;
-        if (mixer === void 0)
-          continue;
+        if (mixer === undefined) continue;
+
         for (let j = 0, jl = mixer._actions.length; j < jl; j++) {
           mixer._actions[j]._clip.duration = max;
         }
       }
+
       if (camera !== null) {
         var mixer = this.objects.get(camera).mixer;
-        if (mixer !== void 0) {
+
+        if (mixer !== undefined) {
           for (let i = 0, il = mixer._actions.length; i < il; i++) {
             mixer._actions[i]._clip.duration = max;
           }
         }
       }
+
       if (audioManager !== null) {
         audioManager.duration = max;
       }
     },
-    _updatePropertyMixersBuffer: function(mesh) {
+    // workaround
+    _updatePropertyMixersBuffer: function (mesh) {
       const mixer = this.objects.get(mesh).mixer;
       const propertyMixers = mixer._bindings;
       const accuIndex = mixer._accuIndex;
+
       for (let i = 0, il = propertyMixers.length; i < il; i++) {
         const propertyMixer = propertyMixers[i];
         const buffer = propertyMixer.buffer;
@@ -380,124 +523,170 @@ const MMDAnimationHelper = (() => {
         propertyMixer.binding.getValue(buffer, offset);
       }
     },
-    _saveBones: function(mesh) {
+
+    /*
+     * Avoiding these two issues by restore/save bones before/after mixer animation.
+     *
+     * 1. PropertyMixer used by AnimationMixer holds cache value in .buffer.
+     *    Calculating IK, Grant, and Physics after mixer animation can break
+     *    the cache coherency.
+     *
+     * 2. Applying Grant two or more times without reset the posing breaks model.
+     */
+    _saveBones: function (mesh) {
       const objects = this.objects.get(mesh);
       const bones = mesh.skeleton.bones;
       let backupBones = objects.backupBones;
-      if (backupBones === void 0) {
+
+      if (backupBones === undefined) {
         backupBones = new Float32Array(bones.length * 7);
         objects.backupBones = backupBones;
       }
+
       for (let i = 0, il = bones.length; i < il; i++) {
         const bone = bones[i];
         bone.position.toArray(backupBones, i * 7);
         bone.quaternion.toArray(backupBones, i * 7 + 3);
       }
     },
-    _restoreBones: function(mesh) {
+    _restoreBones: function (mesh) {
       const objects = this.objects.get(mesh);
       const backupBones = objects.backupBones;
-      if (backupBones === void 0)
-        return;
+      if (backupBones === undefined) return;
       const bones = mesh.skeleton.bones;
+
       for (let i = 0, il = bones.length; i < il; i++) {
         const bone = bones[i];
         bone.position.fromArray(backupBones, i * 7);
         bone.quaternion.fromArray(backupBones, i * 7 + 3);
       }
     },
-    _getMasterPhysics: function() {
-      if (this.masterPhysics !== null)
-        return this.masterPhysics;
+    // experimental
+    _getMasterPhysics: function () {
+      if (this.masterPhysics !== null) return this.masterPhysics;
+
       for (let i = 0, il = this.meshes.length; i < il; i++) {
         const physics = this.meshes[i].physics;
-        if (physics !== void 0 && physics !== null) {
+
+        if (physics !== undefined && physics !== null) {
           this.masterPhysics = physics;
           return this.masterPhysics;
         }
       }
+
       return null;
     },
-    _updateSharedPhysics: function(delta) {
-      if (this.meshes.length === 0 || !this.enabled.physics || !this.sharedPhysics)
-        return;
+    _updateSharedPhysics: function (delta) {
+      if (this.meshes.length === 0 || !this.enabled.physics || !this.sharedPhysics) return;
+
       const physics = this._getMasterPhysics();
-      if (physics === null)
-        return;
+
+      if (physics === null) return;
+
       for (let i = 0, il = this.meshes.length; i < il; i++) {
         var p = this.meshes[i].physics;
-        if (p !== null && p !== void 0) {
+
+        if (p !== null && p !== undefined) {
           p.updateRigidBodies();
         }
       }
+
       physics.stepSimulation(delta);
+
       for (let i = 0, il = this.meshes.length; i < il; i++) {
         var p = this.meshes[i].physics;
-        if (p !== null && p !== void 0) {
+
+        if (p !== null && p !== undefined) {
           p.updateBones();
         }
       }
     }
-  };
+  }; //
+
+  /**
+   * @param {THREE.Audio} audio
+   * @param {Object} params - (optional)
+   * @param {Nuumber} params.delayTime
+   */
+
   function AudioManager(audio, params) {
     params = params || {};
     this.audio = audio;
-    this.elapsedTime = 0;
-    this.currentTime = 0;
-    this.delayTime = params.delayTime !== void 0 ? params.delayTime : 0;
+    this.elapsedTime = 0.0;
+    this.currentTime = 0.0;
+    this.delayTime = params.delayTime !== undefined ? params.delayTime : 0.0;
     this.audioDuration = this.audio.buffer.duration;
     this.duration = this.audioDuration + this.delayTime;
   }
+
   AudioManager.prototype = {
     constructor: AudioManager,
-    control: function(delta) {
+
+    /**
+     * @param {Number} delta
+     * @return {AudioManager}
+     */
+    control: function (delta) {
       this.elapsed += delta;
       this.currentTime += delta;
-      if (this._shouldStopAudio())
-        this.audio.stop();
-      if (this._shouldStartAudio())
-        this.audio.play();
+      if (this._shouldStopAudio()) this.audio.stop();
+      if (this._shouldStartAudio()) this.audio.play();
       return this;
     },
-    _shouldStartAudio: function() {
-      if (this.audio.isPlaying)
-        return false;
+    // private methods
+    _shouldStartAudio: function () {
+      if (this.audio.isPlaying) return false;
+
       while (this.currentTime >= this.duration) {
         this.currentTime -= this.duration;
       }
-      if (this.currentTime < this.delayTime)
-        return false;
-      if (this.currentTime - this.delayTime > this.audioDuration)
-        return false;
+
+      if (this.currentTime < this.delayTime) return false; // 'duration' can be bigger than 'audioDuration + delayTime' because of sync configuration
+
+      if (this.currentTime - this.delayTime > this.audioDuration) return false;
       return true;
     },
-    _shouldStopAudio: function() {
+    _shouldStopAudio: function () {
       return this.audio.isPlaying && this.currentTime >= this.duration;
     }
   };
+  /**
+   * @param {THREE.SkinnedMesh} mesh
+   * @param {Array<Object>} grants
+   */
+
   function GrantSolver(mesh, grants) {
     this.mesh = mesh;
     this.grants = grants || [];
   }
+
   GrantSolver.prototype = {
     constructor: GrantSolver,
+
+    /**
+     * @return {GrantSolver}
+     */
     update: (() => {
-      const quaternion = new THREE.Quaternion();
-      return function() {
+      const quaternion = new Quaternion();
+      return function () {
         const bones = this.mesh.skeleton.bones;
         const grants = this.grants;
+
         for (let i = 0, il = grants.length; i < il; i++) {
           const grant = grants[i];
           const bone = bones[grant.index];
           const parentBone = bones[grant.parentIndex];
+
           if (grant.isLocal) {
-            if (grant.affectPosition) {
-            }
-            if (grant.affectRotation) {
-            }
+            // TODO: implement
+            if (grant.affectPosition) ; // TODO: implement
+
+
+            if (grant.affectRotation) ;
           } else {
-            if (grant.affectPosition) {
-            }
+            // TODO: implement
+            if (grant.affectPosition) ;
+
             if (grant.affectRotation) {
               quaternion.set(0, 0, 0, 1);
               quaternion.slerp(parentBone.quaternion, grant.ratio);
@@ -505,10 +694,12 @@ const MMDAnimationHelper = (() => {
             }
           }
         }
+
         return this;
       };
     })()
   };
-  return MMDAnimationHelper2;
+  return MMDAnimationHelper;
 })();
-exports.MMDAnimationHelper = MMDAnimationHelper;
+
+export { MMDAnimationHelper };