fix twitchiness when using setAttribute for 'direction' instead of property by decoupling attribute and animation; updated documentation and overhauled demo page