refactor data types interface; handle loader race condition; update file comments