API Docs cleanup

This is a big cleanup of the API docs based on the result of parsing the `data.json` file created by YUIDoc to generate TypeScript definitions for YUI. There are many fixes, some removals of unnecessary data (like `@return {void}`) and a couple of changes to redundant/incorrect types (like `@type Int` instead of `Number`).