update callback arguments, improve animation demo
improve manipulation methods jsdoc