Though I can only (seemingly) examine your JS APIs by clicking "Test". Which only works on the one machine I have with BP installed.
Is there some way I can see your IDLs for all your APIs in some overview HTML document?
So yes and no. As you'll see in the upcoming API docs, parameters and return values are programatically specified... to a point. For arguments to services the service developer must precisely specify the name and type of _top level_ arguments. The platform will then validate arguments very early in a call to ensure functions are correctly invoked. but it's only a single level, so map/list arguments to services there is no specification required and it's up to the service developer to provide documentation.
For return types and arguments to callbacks, there's no precise specification required.
During development at many times I've dreamed of a lightweight json schema language. There are several emergent projects/attempts to get this correct. The idea here would be that a schema language could be used to fully or partially specify the arguments to a service, the values it passes to callbacks, and its return value.
I've wanted to layer another library on top of yajl (http://github.com/lloyd/yajl/tree/master) and then look at using that in BrowserPlus. But alas, all of this is just thought experiments at the moment.
In some eventual future when we've got enough usage of browserplus and thought in this area we could roll all the best ideas into BrowserPlus 3 which improves the current API.
sorry for the verbosity.. I may be over-caffeinated.