Add JSDoc-style options hash descriptions for media class constructors

[ericlewis]

As we're moving towards JSDoc, let's clean up our options hash descriptions in media class constructors.

This will incldue moving over from @constructor to @class tags, which is the ​preferred nomenclature on the JSDoc scene.

[ericlewis]

In attachment:30193.diff​, options hash for media.view.MediaFrame.Select.

[ericlewis]

In attachment:30193.2.diff​, options hash clean-up for media.controller.Library.

[ericlewis]

In attachment:30193.3.diff​, media.controller.Region options hash documentation.

[ericlewis]

In attachment:30193.4.diff​ (codename Southwest 4570):

• extended documentation for media.controller.Region, media.controller.StateMachine, media.selectionSync, and a bunch of other constructors and methods.
• exhaustive constructor options hash descriptions for media.controller.Library, media.controller.ImageDetails, media.controller.GalleryEdit, media.controller.GalleryAdd, media.controller.CollectionEdit, media.controller.CollectionAdd, media.controller.CollectionAdd, media.controller.ReplaceImage, media.controller.EditImage, media.controller.Embed, and media.view.UploaderWindow.
• removed the big blocks like CONTROLLERS and VIEWS, which aren't helpful when this file is 7500 lines long. We're also getting to a point where the term "controller" is murky and in cases problematic for developer experience. Something gcorne and I spoke about during #wcsf a work day: knowing media.controller.CollectionAdd is a controller tells you nothing about its actual role in the system; knowing it is a state is much more helpful.
• added a few @todos where I found dead or curious code.
• change all @constructors to @classes

[wonderboymusic]

In 30120:

Add verbose docs to media-views.js.

Props ericlewis.
See #30193.

[wonderboymusic]

Re-add commit if you do more work here

[ocean90]

Closing as fixed for 4.1.

[wonderboymusic]

In 31490:

After [30120], in media JS files, move from @constructor to @class annotations as per JSDoc preferred nomenclature: ​http://usejsdoc.org/tags-class.html

See #28510, #30193.