minor jsdoc and type annotation fixes