Cleanup

* Use JSDoc when possible
* Switch return types from Language Service public APIs to interfaces
* remove unused files
* remove references to 'foo' from user facing messages
i don't like this.  Previous you had the class with the static factory methods showing how to create instances with data properly set for them.  That's a valuable thing to have.