Changeset 26986

Timestamp:

01/20/2014 11:41:42 PM (11 years ago)

Author:

wonderboymusic

Message:

Add initial JSDoc blocks to media-views.js. The initial blocks are a baseline to work from and invite future iterations. Initial commit is to avoid commits this large in the future.

See #26870.

File:

• trunk/src/wp-includes/js/media-views.js (modified) (230 diffs)

trunk/src/wp-includes/js/media-views.js

@@ -1 +1 @@
 /* global _wpMediaViewsL10n, confirm, getUserSetting, setUserSetting */
 (function($){
-    var media       = wp.media,
-        Attachment  = media.model.Attachment,
-        Attachments = media.model.Attachments,
-        l10n;
+    var media = wp.media, l10n;
 
     // Link any localized strings.
@@ -35 +32 @@
     }());
 
-    // Makes it easier to bind events using transitions.
+    /**
+     * Makes it easier to bind events using transitions.
+     *
+     * @param {string} selector
+     * @param {Number} sensitivity
+     * @returns {Promise}
+     */
     media.transition = function( selector, sensitivity ) {
         var deferred = $.Deferred();
@@ -67 +70 @@
     /**
      * wp.media.controller.Region
+     *
+     * @constructor
+     * @augments Backbone.Model
+     *
+     * @param {Object} [options={}]
      */
     media.controller.Region = function( options ) {
@@ -76 +84 @@
 
     _.extend( media.controller.Region.prototype, {
+        /**
+         * Switch modes
+         *
+         * @param {string} mode
+         *
+         * @fires wp.media.controller.Region#{id}:activate:{mode}
+         * @fires wp.media.controller.Region#{id}:deactivate:{mode}
+         *
+         * @returns {wp.media.controller.Region} Returns itself to allow chaining
+         */
         mode: function( mode ) {
-            if ( ! mode )
+            if ( ! mode ) {
                 return this._mode;
-
+            }
             // Bail if we're trying to change to the current mode.
-            if ( mode === this._mode )
+            if ( mode === this._mode ) {
                 return this;
+            }
 
             this.trigger('deactivate');
@@ -90 +109 @@
             return this;
         },
-
+        /**
+         * Render a new mode, the view is set in the `create` callback method
+         *   of the extending class
+         *
+         * If no mode is provided, just re-render the current mode.
+         * If the provided mode isn't active, perform a full switch.
+         *
+         * @param {string} mode
+         *
+         * @fires wp.media.controller.Region#{id}:create:{mode}
+         * @fires wp.media.controller.Region#{id}:render:{mode}
+         *
+         * @returns {wp.media.controller.Region} Returns itself to allow chaining
+         */
         render: function( mode ) {
-            // If no mode is provided, just re-render the current mode.
-            // If the provided mode isn't active, perform a full switch.
-            if ( mode && mode !== this._mode )
+            if ( mode && mode !== this._mode ) {
                 return this.mode( mode );
+            }
 
             var set = { view: null },
@@ -103 +134 @@
             view = set.view;
             this.trigger( 'render', view );
-            if ( view )
+            if ( view ) {
                 this.set( view );
+            }
             return this;
         },
 
+        /**
+         * @returns {wp.media.View} Returns the selector's first subview
+         */
         get: function() {
             return this.view.views.first( this.selector );
         },
 
+        /**
+         * @param {Array|Object} views
+         * @param {Object} [options={}]
+         * @returns {wp.Backbone.Subviews} Subviews is returned to allow chaining
+         */
         set: function( views, options ) {
-            if ( options )
+            if ( options ) {
                 options.add = false;
+            }
             return this.view.views.set( this.selector, views, options );
         },
 
+        /**
+         * Helper function to trigger view events based on {id}:{event}:{mode}
+         *
+         * @param {string} event
+         * @returns {undefined|wp.media.controller.Region} Returns itself to allow chaining
+         */
         trigger: function( event ) {
             var base, args;
 
-            if ( ! this._mode )
+            if ( ! this._mode ) {
                 return;
+            }
 
             args = _.toArray( arguments );
@@ -140 +188 @@
     /**
      * wp.media.controller.StateMachine
+     *
+     * @constructor
+     * @augments Backbone.Model
+     * @mixin
+     * @mixes Backbone.Events
+     *
+     * @param {Array} states
      */
     media.controller.StateMachine = function( states ) {
@@ -150 +205 @@
     // Add events to the `StateMachine`.
     _.extend( media.controller.StateMachine.prototype, Backbone.Events, {
-
-        // Fetch a state.
-        //
-        // If no `id` is provided, returns the active state.
-        //
-        // Implicitly creates states.
+        /**
+         * Fetch a state.
+         *
+         * If no `id` is provided, returns the active state.
+         *
+         * Implicitly creates states.
+         *
+         * Ensure that the `states` collection exists so the `StateMachine`
+         *   can be used as a mixin.
+         *
+         * @param {string} id
+         * @returns {wp.media.controller.State} Returns a State model
+         *   from the StateMachine collection
+         */
         state: function( id ) {
-            // Ensure that the `states` collection exists so the `StateMachine`
-            // can be used as a mixin.
             this.states = this.states || new Backbone.Collection();
 
@@ -164 +225 @@
             id = id || this._state;
 
-            if ( id && ! this.states.get( id ) )
+            if ( id && ! this.states.get( id ) ) {
                 this.states.add({ id: id });
+            }
             return this.states.get( id );
         },
 
-        // Sets the active state.
+        /**
+         * Sets the active state.
+         *
+         * Bail if we're trying to select the current state, if we haven't
+         * created the `states` collection, or are trying to select a state
+         * that does not exist.
+         *
+         * @param {string} id
+         *
+         * @fires wp.media.controller.State#deactivate
+         * @fires wp.media.controller.State#activate
+         *
+         * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining
+         */
         setState: function( id ) {
             var previous = this.state();
 
-            // Bail if we're trying to select the current state, if we haven't
-            // created the `states` collection, or are trying to select a state
-            // that does not exist.
-            if ( ( previous && id === previous.id ) || ! this.states || ! this.states.get( id ) )
+            if ( ( previous && id === previous.id ) || ! this.states || ! this.states.get( id ) ) {
                 return this;
+            }
 
             if ( previous ) {
@@ -190 +263 @@
         },
 
-        // Returns the previous active state.
-        //
-        // Call the `state()` method with no parameters to retrieve the current
-        // active state.
+        /**
+         * Returns the previous active state.
+         *
+         * Call the `state()` method with no parameters to retrieve the current
+         * active state.
+         *
+         * @returns {wp.media.controller.State} Returns a State model
+         *   from the StateMachine collection
+         */
         lastState: function() {
-            if ( this._lastState )
+            if ( this._lastState ) {
                 return this.state( this._lastState );
+            }
         }
     });
@@ -202 +281 @@
     // Map methods from the `states` collection to the `StateMachine` itself.
     _.each([ 'on', 'off', 'trigger' ], function( method ) {
+        /**
+         * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining
+         */
         media.controller.StateMachine.prototype[ method ] = function() {
             // Ensure that the `states` collection exists so the `StateMachine`
@@ -212 +294 @@
     });
 
-
-    // wp.media.controller.State
-    // ---------------------------
+    /**
+     * wp.media.controller.State
+     *
+     * @constructor
+     * @augments Backbone.Model
+     */
     media.controller.State = Backbone.Model.extend({
         constructor: function() {
@@ -225 +310 @@
             this.on( 'ready', this._ready, this );
             this.on( 'ready', this.ready, this );
+            /**
+             * Call parent constructor with passed arguments
+             */
             Backbone.Model.apply( this, arguments );
             this.on( 'change:menu', this._updateMenu, this );
         },
 
+        /**
+         * @abstract
+         */
         ready: function() {},
+        /**
+         * @abstract
+         */
         activate: function() {},
+        /**
+         * @abstract
+         */
         deactivate: function() {},
+        /**
+         * @abstract
+         */
         reset: function() {},
-
+        /**
+         * @access private
+         */
         _ready: function() {
             this._updateMenu();
         },
-
+        /**
+         * @access private
+         */
         _preActivate: function() {
             this.active = true;
         },
-
+        /**
+         * @access private
+         */
         _postActivate: function() {
             this.on( 'change:menu', this._menu, this );
@@ -256 +362 @@
             this._router();
         },
-
-
+        /**
+         * @access private
+         */
         _deactivate: function() {
             this.active = false;
@@ -268 +375 @@
             this.off( 'change:toolbar', this._toolbar, this );
         },
-
+        /**
+         * @access private
+         */
         _title: function() {
             this.frame.title.render( this.get('titleMode') || 'default' );
         },
-
+        /**
+         * @access private
+         */
         _renderTitle: function( view ) {
             view.$el.text( this.get('title') || '' );
         },
-
+        /**
+         * @access private
+         */
         _router: function() {
             var router = this.frame.router,
@@ -283 +396 @@
 
             this.frame.$el.toggleClass( 'hide-router', ! mode );
-            if ( ! mode )
+            if ( ! mode ) {
                 return;
+            }
 
             this.frame.router.render( mode );
 
             view = router.get();
-            if ( view && view.select )
+            if ( view && view.select ) {
                 view.select( this.frame.content.mode() );
-        },
-
+            }
+        },
+        /**
+         * @access private
+         */
         _menu: function() {
             var menu = this.frame.menu,
@@ -298 +415 @@
                 view;
 
-            if ( ! mode )
+            if ( ! mode ) {
                 return;
+            }
 
             menu.mode( mode );
 
             view = menu.get();
-            if ( view && view.select )
+            if ( view && view.select ) {
                 view.select( this.id );
-        },
-
+            }
+        },
+        /**
+         * @access private
+         */
         _updateMenu: function() {
             var previous = this.previous('menu'),
                 menu = this.get('menu');
 
-            if ( previous )
+            if ( previous ) {
                 this.frame.off( 'menu:render:' + previous, this._renderMenu, this );
-
-            if ( menu )
+            }
+
+            if ( menu ) {
                 this.frame.on( 'menu:render:' + menu, this._renderMenu, this );
-        },
-
+            }
+        },
+        /**
+         * @access private
+         */
         _renderMenu: function( view ) {
             var menuItem = this.get('menuItem'),
@@ -327 +452 @@
                 menuItem = { text: title };
 
-                if ( priority )
+                if ( priority ) {
                     menuItem.priority = priority;
-            }
-
-            if ( ! menuItem )
+                }
+            }
+
+            if ( ! menuItem ) {
                 return;
+            }
 
             view.set( this.id, menuItem );
@@ -339 +466 @@
 
     _.each(['toolbar','content'], function( region ) {
+        /**
+         * @access private
+         */
         media.controller.State.prototype[ '_' + region ] = function() {
             var mode = this.get( region );
-            if ( mode )
+            if ( mode ) {
                 this.frame[ region ].render( mode );
+            }
         };
     });
 
-    // wp.media.controller.Library
-    // ---------------------------
+    /**
+     * wp.media.controller.Library
+     *
+     * @constructor
+     * @augments wp.media.controller.State
+     * @augments Backbone.Model
+     */
     media.controller.Library = media.controller.State.extend({
         defaults: {
@@ -370 +506 @@
         },
 
+        /**
+         * If a library isn't provided, query all media items.
+         * If a selection instance isn't provided, create one.
+         */
         initialize: function() {
             var selection = this.get('selection'),
                 props;
 
-            // If a library isn't provided, query all media items.
-            if ( ! this.get('library') )
+            if ( ! this.get('library') ) {
                 this.set( 'library', media.query() );
-
-            // If a selection instance isn't provided, create one.
+            }
+
             if ( ! (selection instanceof media.model.Selection) ) {
                 props = selection;
@@ -447 +586 @@
         },
 
+        /**
+         * @param {wp.media.model.Attachment} attachment
+         * @returns {Backbone.Model}
+         */
         display: function( attachment ) {
             var displays = this._displays;
 
-            if ( ! displays[ attachment.cid ] )
+            if ( ! displays[ attachment.cid ] ) {
                 displays[ attachment.cid ] = new Backbone.Model( this.defaultDisplaySettings( attachment ) );
-
+            }
             return displays[ attachment.cid ];
         },
 
+        /**
+         * @param {wp.media.model.Attachment} attachment
+         * @returns {Object}
+         */
         defaultDisplaySettings: function( attachment ) {
             var settings = this._defaultDisplaySettings;
-            if ( settings.canEmbed = this.canEmbed( attachment ) )
+            if ( settings.canEmbed = this.canEmbed( attachment ) ) {
                 settings.link = 'embed';
+            }
             return settings;
         },
 
+        /**
+         * @param {wp.media.model.Attachment} attachment
+         * @returns {Boolean}
+         */
         canEmbed: function( attachment ) {
             // If uploading, we know the filename but not the mime type.
             if ( ! attachment.get('uploading') ) {
                 var type = attachment.get('type');
-                if ( type !== 'audio' && type !== 'video' )
+                if ( type !== 'audio' && type !== 'video' ) {
                     return false;
+                }
             }
 
@@ -478 +631 @@
                 manager = this.frame._selection;
 
-            if ( ! this.get('syncSelection') || ! manager || ! selection )
+            if ( ! this.get('syncSelection') || ! manager || ! selection ) {
                 return;
+            }
 
             // If the selection supports multiple items, validate the stored
@@ -495 +649 @@
         },
 
+        /**
+         * Record the currently active attachments, which is a combination
+         * of the selection's attachments and the set of selected
+         * attachments that this specific selection considered invalid.
+         * Reset the difference and record the single attachment.
+         */
         recordSelection: function() {
             var selection = this.get('selection'),
                 manager = this.frame._selection;
 
-            if ( ! this.get('syncSelection') || ! manager || ! selection )
+            if ( ! this.get('syncSelection') || ! manager || ! selection ) {
                 return;
-
-            // Record the currently active attachments, which is a combination
-            // of the selection's attachments and the set of selected
-            // attachments that this specific selection considered invalid.
-            // Reset the difference and record the single attachment.
+            }
+
             if ( selection.multiple ) {
                 manager.attachments.reset( selection.toArray().concat( manager.difference ) );
@@ -516 +673 @@
         },
 
+        /**
+         * If the state is active, no items are selected, and the current
+         * content mode is not an option in the state's router (provided
+         * the state has a router), reset the content mode to the default.
+         */
         refreshContent: function() {
             var selection = this.get('selection'),
@@ -522 +684 @@
                 mode = frame.content.mode();
 
-            // If the state is active, no items are selected, and the current
-            // content mode is not an option in the state's router (provided
-            // the state has a router), reset the content mode to the default.
-            if ( this.active && ! selection.length && router && ! router.get( mode ) )
+            if ( this.active && ! selection.length && router && ! router.get( mode ) ) {
                 this.frame.content.render( this.get('content') );
-        },
-
+            }
+        },
+
+        /**
+         * If the uploader was selected, navigate to the browser.
+         *
+         * Automatically select any uploading attachments.
+         *
+         * Selections that don't support multiple attachments automatically
+         * limit themselves to one attachment (in this case, the last
+         * attachment in the upload queue).
+         *
+         * @param {wp.media.model.Attachment} attachment
+         */
         uploading: function( attachment ) {
             var content = this.frame.content;
 
-            // If the uploader was selected, navigate to the browser.
-            if ( 'upload' === content.mode() )
+            if ( 'upload' === content.mode() ) {
                 this.frame.content.mode('browse');
-
-            // Automatically select any uploading attachments.
-            //
-            // Selections that don't support multiple attachments automatically
-            // limit themselves to one attachment (in this case, the last
-            // attachment in the upload queue).
+            }
             this.get('selection').add( attachment );
         },
 
+        /**
+         * Only track the browse router on library states.
+         */
         saveContentMode: function() {
-            // Only track the browse router on library states.
-            if ( 'browse' !== this.get('router') )
+            if ( 'browse' !== this.get('router') ) {
                 return;
+            }
 
             var mode = this.frame.content.mode(),
                 view = this.frame.router.get();
 
-            if ( view && view.get( mode ) )
+            if ( view && view.get( mode ) ) {
                 setUserSetting( 'libraryContent', mode );
+            }
         }
     });
 
-    // wp.media.controller.GalleryEdit
-    // -------------------------------
+    /**
+     * wp.media.controller.GalleryEdit
+     *
+     * @constructor
+     * @augments wp.media.controller.Library
+     * @augments wp.media.controller.State
+     * @augments Backbone.Model
+     */
     media.controller.GalleryEdit = media.controller.Library.extend({
         defaults: {
@@ -581 +756 @@
         initialize: function() {
             // If we haven't been provided a `library`, create a `Selection`.
-            if ( ! this.get('library') )
+            if ( ! this.get('library') ) {
                 this.set( 'library', new media.model.Selection() );
+            }
 
             // The single `Attachment` view to be used in the `Attachments` view.
-            if ( ! this.get('AttachmentView') )
+            if ( ! this.get('AttachmentView') ) {
                 this.set( 'AttachmentView', media.view.Attachment.EditLibrary );
+            }
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.controller.Library.prototype.initialize.apply( this, arguments );
         },
@@ -600 +780 @@
 
             this.frame.on( 'content:render:browse', this.gallerySettings, this );
-
+            /**
+             * call 'activate' directly on the parent class
+             */
             media.controller.Library.prototype.activate.apply( this, arguments );
         },
@@ -609 +791 @@
 
             this.frame.off( 'content:render:browse', this.gallerySettings, this );
-
+            /**
+             * call 'deactivate' directly on the parent class
+             */
             media.controller.Library.prototype.deactivate.apply( this, arguments );
         },
 
+        /**
+         * @param {Object} browser
+         */
         gallerySettings: function( browser ) {
             var library = this.get('library');
 
-            if ( ! library || ! browser )
+            if ( ! library || ! browser ) {
                 return;
+            }
 
             library.gallery = library.gallery || new Backbone.Model();
@@ -640 +828 @@
     });
 
-    // wp.media.controller.GalleryAdd
-    // ---------------------------------
+    /**
+     * wp.media.controller.GalleryAdd
+     *
+     * @constructor
+     * @augments wp.media.controller.Library
+     * @augments wp.media.controller.State
+     * @augments Backbone.Model
+     */
     media.controller.GalleryAdd = media.controller.Library.extend({
         defaults: _.defaults({
@@ -657 +851 @@
         }, media.controller.Library.prototype.defaults ),
 
+        /**
+         * If we haven't been provided a `library`, create a `Selection`.
+         */
         initialize: function() {
-            // If we haven't been provided a `library`, create a `Selection`.
-            if ( ! this.get('library') )
+            if ( ! this.get('library') ) {
                 this.set( 'library', media.query({ type: 'image' }) );
-
+            }
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.controller.Library.prototype.initialize.apply( this, arguments );
         },
@@ -675 +874 @@
             // that do not exist in gallery's library.
             library.validator = function( attachment ) {
-                return !! this.mirroring.get( attachment.cid ) && ! edit.get( attachment.cid ) && media.model.Selection.prototype.validator.apply( this, arguments );
+                return !! this.mirroring.get( attachment.cid )
+                    && ! edit.get( attachment.cid )
+                    /**
+                     * call 'validator' directly on wp.media.model.Selection
+                     */
+                    && media.model.Selection.prototype.validator.apply( this, arguments );
             };
 
@@ -684 +888 @@
             library.observe( edit );
             this.editLibrary = edit;
-
+            /**
+             * call 'activate' directly on the parent class
+             */
             media.controller.Library.prototype.activate.apply( this, arguments );
         }
     });
 
-    // wp.media.controller.FeaturedImage
-    // ---------------------------------
+    /**
+     * wp.media.controller.FeaturedImage
+     *
+     * @constructor
+     * @augments wp.media.controller.Library
+     * @augments wp.media.controller.State
+     * @augments Backbone.Model
+     */
     media.controller.FeaturedImage = media.controller.Library.extend({
         defaults: _.defaults({
@@ -707 +919 @@
 
             // If we haven't been provided a `library`, create a `Selection`.
-            if ( ! this.get('library') )
+            if ( ! this.get('library') ) {
                 this.set( 'library', media.query({ type: 'image' }) );
-
+            }
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.controller.Library.prototype.initialize.apply( this, arguments );
 
@@ -721 +936 @@
                     bInQuery = !! this.mirroring.get( b.cid );
 
-                if ( ! aInQuery && bInQuery )
+                if ( ! aInQuery && bInQuery ) {
                     return -1;
-                else if ( aInQuery && ! bInQuery )
+                } else if ( aInQuery && ! bInQuery ) {
                     return 1;
-                else
+                } else {
                     return comparator.apply( this, arguments );
+                }
             };
 
@@ -737 +953 @@
             this.updateSelection();
             this.frame.on( 'open', this.updateSelection, this );
+            /**
+             * call 'activate' directly on the parent class
+             */
             media.controller.Library.prototype.activate.apply( this, arguments );
         },
@@ -742 +961 @@
         deactivate: function() {
             this.frame.off( 'open', this.updateSelection, this );
+            /**
+             * call 'deactivate' directly on the parent class
+             */
             media.controller.Library.prototype.deactivate.apply( this, arguments );
         },
@@ -751 +973 @@
 
             if ( '' !== id && -1 !== id ) {
-                attachment = Attachment.get( id );
+                attachment = media.model.Attachment.get( id );
                 attachment.fetch();
             }
@@ -759 +981 @@
     });
 
-
-    // wp.media.controller.Embed
-    // -------------------------
+    /**
+     * wp.media.controller.Embed
+     *
+     * @constructor
+     * @augments wp.media.controller.State
+     * @augments Backbone.Model
+     */
     media.controller.Embed = media.controller.State.extend({
         defaults: {
@@ -786 +1012 @@
         },
 
+        /**
+         * @fires wp.media.controller.Embed#scan
+         */
         scan: function() {
             var scanners,
@@ -797 +1026 @@
             // state, useful for the 'type' attribute and 'scanners' attribute,
             // an array of promise objects for asynchronous scan operations.
-            if ( this.props.get('url') )
+            if ( this.props.get('url') ) {
                 this.trigger( 'scan', attributes );
+            }
 
             if ( attributes.scanners.length ) {
@@ -813 +1043 @@
             this.set( attributes );
         },
-
+        /**
+         * @param {Object} attributes
+         */
         scanImage: function( attributes ) {
             var frame = this.frame,
@@ -827 +1059 @@
                 deferred.resolve();
 
-                if ( state !== frame.state() || url !== state.props.get('url') )
+                if ( state !== frame.state() || url !== state.props.get('url') ) {
                     return;
+                }
 
                 state.set({
@@ -851 +1084 @@
             this.props.clear().set({ url: '' });
 
-            if ( this.active )
+            if ( this.active ) {
                 this.refresh();
+            }
         }
     });
@@ -862 +1096 @@
      */
 
-    // wp.media.View
-    // -------------
-    //
-    // The base view class.
-    //
-    // Undelegating events, removing events from the model, and
-    // removing events from the controller mirror the code for
-    // `Backbone.View.dispose` in Backbone 0.9.8 development.
-    //
-    // This behavior has since been removed, and should not be used
-    // outside of the media manager.
+    /**
+     * wp.media.View
+     * -------------
+     *
+     * The base view class.
+     *
+     * Undelegating events, removing events from the model, and
+     * removing events from the controller mirror the code for
+     * `Backbone.View.dispose` in Backbone 0.9.8 development.
+     *
+     * This behavior has since been removed, and should not be used
+     * outside of the media manager.
+     *
+     * @constructor
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.View = wp.Backbone.View.extend({
         constructor: function( options ) {
-            if ( options && options.controller )
+            if ( options && options.controller ) {
                 this.controller = options.controller;
-
+            }
             wp.Backbone.View.apply( this, arguments );
         },
-
+        /**
+         * @returns {wp.media.View} Returns itself to allow chaining
+         */
         dispose: function() {
             // Undelegating events, removing events from the model, and
@@ -887 +1129 @@
             this.undelegateEvents();
 
-            if ( this.model && this.model.off )
+            if ( this.model && this.model.off ) {
                 this.model.off( null, null, this );
-
-            if ( this.collection && this.collection.off )
+            }
+
+            if ( this.collection && this.collection.off ) {
                 this.collection.off( null, null, this );
+            }
 
             // Unbind controller events.
-            if ( this.controller && this.controller.off )
+            if ( this.controller && this.controller.off ) {
                 this.controller.off( null, null, this );
+            }
 
             return this;
         },
-
+        /**
+         * @returns {wp.media.View} Returns itself to allow chaining
+         */
         remove: function() {
             this.dispose();
+            /**
+             * call 'remove' directly on the parent class
+             */
             return wp.Backbone.View.prototype.remove.apply( this, arguments );
         }
@@ -908 +1158 @@
     /**
      * wp.media.view.Frame
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     * @mixes wp.media.controller.StateMachine
      */
     media.view.Frame = media.View.extend({
@@ -928 +1184 @@
             }, this );
         },
-
+        /**
+         * @fires wp.media.controller.State#ready
+         */
         _createStates: function() {
             // Create the default `states` collection.
@@ -941 +1199 @@
             }, this );
 
-            if ( this.options.states )
+            if ( this.options.states ) {
                 this.states.add( this.options.states );
-        },
-
+            }
+        },
+        /**
+         * @returns {wp.media.view.Frame} Returns itself to allow chaining
+         */
         reset: function() {
             this.states.invoke( 'trigger', 'reset' );
@@ -956 +1217 @@
     /**
      * wp.media.view.MediaFrame
+     *
+     * @constructor
+     * @augments wp.media.view.Frame
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     * @mixes wp.media.controller.StateMachine
      */
     media.view.MediaFrame = media.view.Frame.extend({
@@ -962 +1230 @@
         regions:   ['menu','title','content','toolbar','router'],
 
+        /**
+         * @global wp.Uploader
+         */
         initialize: function() {
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.Frame.prototype.initialize.apply( this, arguments );
 
@@ -986 +1260 @@
             // Force the uploader off if the upload limit has been exceeded or
             // if the browser isn't supported.
-            if ( wp.Uploader.limitExceeded || ! wp.Uploader.browser.supported )
+            if ( wp.Uploader.limitExceeded || ! wp.Uploader.browser.supported ) {
                 this.options.uploader = false;
+            }
 
             // Initialize window-wide uploader.
@@ -1010 +1285 @@
             this.on( 'menu:create:default', this.createMenu, this );
         },
-
+        /**
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
         render: function() {
             // Activate the default state if no active state exists.
-            if ( ! this.state() && this.options.state )
+            if ( ! this.state() && this.options.state ) {
                 this.setState( this.options.state );
-
+            }
+            /**
+             * call 'render' directly on the parent class
+             */
             return media.view.Frame.prototype.render.apply( this, arguments );
         },
-
+        /**
+         * @param {Object} title
+         * @this wp.media.controller.Region
+         */
         createTitle: function( title ) {
             title.view = new media.View({
@@ -1025 +1308 @@
             });
         },
-
+        /**
+         * @param {Object} menu
+         * @this wp.media.controller.Region
+         */
         createMenu: function( menu ) {
             menu.view = new media.view.Menu({
@@ -1031 +1317 @@
             });
         },
-
+        /**
+         * @param {Object} toolbar
+         * @this wp.media.controller.Region
+         */
         createToolbar: function( toolbar ) {
             toolbar.view = new media.view.Toolbar({
@@ -1037 +1326 @@
             });
         },
-
+        /**
+         * @param {Object} router
+         * @this wp.media.controller.Region
+         */
         createRouter: function( router ) {
             router.view = new media.view.Router({
@@ -1043 +1335 @@
             });
         },
-
+        /**
+         * @param {Object} options
+         */
         createIframeStates: function( options ) {
             var settings = media.view.settings,
@@ -1050 +1344 @@
                 $postId;
 
-            if ( ! tabs || ! tabUrl )
+            if ( ! tabs || ! tabUrl ) {
                 return;
+            }
 
             // Add the post ID to the tab URL if it exists.
             $postId = $('#post_ID');
-            if ( $postId.length )
+            if ( $postId.length ) {
                 tabUrl += '&post_id=' + $postId.val();
+            }
 
             // Generate the tab states.
@@ -1075 +1371 @@
         },
 
+        /**
+         * @param {Object} content
+         * @this wp.media.controller.Region
+         */
         iframeContent: function( content ) {
             this.$el.addClass('hide-toolbar');
@@ -1085 +1385 @@
             var views = {};
 
-            if ( ! view )
+            if ( ! view ) {
                 return;
+            }
 
             _.each( media.view.settings.tabs, function( title, id ) {
@@ -1101 +1402 @@
             var frame = this;
 
-            if ( ! window.tb_remove || this._tb_remove )
+            if ( ! window.tb_remove || this._tb_remove ) {
                 return;
+            }
 
             this._tb_remove = window.tb_remove;
@@ -1114 +1416 @@
 
         restoreThickbox: function() {
-            if ( ! this._tb_remove )
+            if ( ! this._tb_remove ) {
                 return;
+            }
 
             window.tb_remove = this._tb_remove;
@@ -1124 +1427 @@
     // Map some of the modal's methods to the frame.
     _.each(['open','close','attach','detach','escape'], function( method ) {
+        /**
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
         media.view.MediaFrame.prototype[ method ] = function() {
-            if ( this.modal )
+            if ( this.modal ) {
                 this.modal[ method ].apply( this.modal, arguments );
+            }
             return this;
         };
@@ -1133 +1440 @@
     /**
      * wp.media.view.MediaFrame.Select
+     *
+     * @constructor
+     * @augments wp.media.view.MediaFrame
+     * @augments wp.media.view.Frame
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     * @mixes wp.media.controller.StateMachine
      */
     media.view.MediaFrame.Select = media.view.MediaFrame.extend({
         initialize: function() {
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.MediaFrame.prototype.initialize.apply( this, arguments );
 
@@ -1160 +1478 @@
 
             this._selection = {
-                attachments: new Attachments(),
+                attachments: new media.model.Attachments(),
                 difference: []
             };
@@ -1168 +1486 @@
             var options = this.options;
 
-            if ( this.options.states )
+            if ( this.options.states ) {
                 return;
+            }
 
             // Add the default states.
@@ -1205 +1524 @@
         },
 
-        // Content
+        /**
+         * Content
+         *
+         * @param {Object} content
+         * @this wp.media.controller.Region
+         */
         browseContent: function( content ) {
             var state = this.state();
@@ -1227 +1551 @@
         },
 
+        /**
+         *
+         * @this wp.media.controller.Region
+         */
         uploadContent: function() {
             this.$el.removeClass('hide-toolbar');
@@ -1234 +1562 @@
         },
 
-        // Toolbars
+        /**
+         * Toolbars
+         *
+         * @param {Object} toolbar
+         * @param {Object} [options={}]
+         * @this wp.media.controller.Region
+         */
         createSelectToolbar: function( toolbar, options ) {
             options = options || this.options.button || {};
@@ -1245 +1579 @@
     /**
      * wp.media.view.MediaFrame.Post
+     *
+     * @constructor
+     * @augments wp.media.view.MediaFrame.Select
+     * @augments wp.media.view.MediaFrame
+     * @augments wp.media.view.Frame
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     * @mixes wp.media.controller.StateMachine
      */
     media.view.MediaFrame.Post = media.view.MediaFrame.Select.extend({
@@ -1253 +1596 @@
                 state:    'insert'
             });
-
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.MediaFrame.Select.prototype.initialize.apply( this, arguments );
             this.createIframeStates();
@@ -1319 +1664 @@
 
         bindHandlers: function() {
+            /**
+             * call 'bindHandlers' directly on the parent class
+             */
             media.view.MediaFrame.Select.prototype.bindHandlers.apply( this, arguments );
             this.on( 'menu:create:gallery', this.createMenu, this );
@@ -1327 +1675 @@
 
             var handlers = {
-                    menu: {
-                        'default': 'mainMenu',
-                        'gallery': 'galleryMenu'
-                    },
-
-                    content: {
-                        'embed':          'embedContent',
-                        'edit-selection': 'editSelectionContent'
-                    },
-
-                    toolbar: {
-                        'main-insert':      'mainInsertToolbar',
-                        'main-gallery':     'mainGalleryToolbar',
-                        'gallery-edit':     'galleryEditToolbar',
-                        'gallery-add':      'galleryAddToolbar'
-                    }
-                };
+                menu: {
+                    'default': 'mainMenu',
+                    'gallery': 'galleryMenu'
+                },
+
+                content: {
+                    'embed':          'embedContent',
+                    'edit-selection': 'editSelectionContent'
+                },
+
+                toolbar: {
+                    'main-insert':      'mainInsertToolbar',
+                    'main-gallery':     'mainGalleryToolbar',
+                    'gallery-edit':     'galleryEditToolbar',
+                    'gallery-add':      'galleryAddToolbar'
+                }
+            };
 
             _.each( handlers, function( regionHandlers, region ) {
@@ -1353 +1701 @@
 
         // Menus
+        /**
+         * @param {wp.Backbone.View} view
+         */
         mainMenu: function( view ) {
             view.set({
@@ -1361 +1712 @@
             });
         },
-
+        /**
+         * @param {wp.Backbone.View} view
+         */
         galleryMenu: function( view ) {
             var lastState = this.lastState(),
@@ -1427 +1780 @@
 
         // Toolbars
+
+        /**
+         * @param {wp.Backbone.View} view
+         */
         selectionStatusToolbar: function( view ) {
             var editable = this.state().get('editable');
@@ -1443 +1800 @@
         },
 
+        /**
+         * @param {wp.Backbone.View} view
+         */
         mainInsertToolbar: function( view ) {
             var controller = this;
@@ -1454 +1814 @@
                 requires: { selection: true },
 
+                /**
+                 * @fires wp.media.controller.State#insert
+                 */
                 click: function() {
                     var state = controller.state(),
@@ -1464 +1827 @@
         },
 
+        /**
+         * @param {wp.Backbone.View} view
+         */
         mainGalleryToolbar: function( view ) {
             var controller = this;
@@ -1514 +1880 @@
                         requires: { library: true },
 
+                        /**
+                         * @fires wp.media.controller.State#update
+                         */
                         click: function() {
                             var controller = this.controller,
@@ -1540 +1909 @@
                         requires: { selection: true },
 
+                        /**
+                         * @fires wp.media.controller.State#reset
+                         */
                         click: function() {
                             var controller = this.controller,
@@ -1557 +1929 @@
     /**
      * wp.media.view.Modal
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Modal = media.View.extend({
@@ -1579 +1956 @@
             });
         },
-
+        /**
+         * @returns {Object}
+         */
         prepare: function() {
             return {
@@ -1586 +1965 @@
         },
 
+        /**
+         * @returns {wp.media.view.Modal} Returns itself to allow chaining
+         */
         attach: function() {
-            if ( this.views.attached )
+            if ( this.views.attached ) {
                 return this;
-
-            if ( ! this.views.rendered )
+            }
+
+            if ( ! this.views.rendered ) {
                 this.render();
+            }
 
             this.$el.appendTo( this.options.container );
@@ -1602 +1986 @@
         },
 
+        /**
+         * @returns {wp.media.view.Modal} Returns itself to allow chaining
+         */
         detach: function() {
-            if ( this.$el.is(':visible') )
+            if ( this.$el.is(':visible') ) {
                 this.close();
+            }
 
             this.$el.detach();
@@ -1611 +1999 @@
         },
 
+        /**
+         * @returns {wp.media.view.Modal} Returns itself to allow chaining
+         */
         open: function() {
             var $el = this.$el,
                 options = this.options;
 
-            if ( $el.is(':visible') )
+            if ( $el.is(':visible') ) {
                 return this;
-
-            if ( ! this.views.attached )
+            }
+
+            if ( ! this.views.attached ) {
                 this.attach();
+            }
 
             // If the `freeze` option is set, record the window's scroll position.
@@ -1632 +2025 @@
         },
 
+        /**
+         * @param {Object} options
+         * @returns {wp.media.view.Modal} Returns itself to allow chaining
+         */
         close: function( options ) {
             var freeze = this._freeze;
 
-            if ( ! this.views.attached || ! this.$el.is(':visible') )
+            if ( ! this.views.attached || ! this.$el.is(':visible') ) {
                 return this;
+            }
 
             this.$el.hide();
@@ -1646 +2044 @@
             }
 
-            if ( options && options.escape )
+            if ( options && options.escape ) {
                 this.propagate('escape');
+            }
 
             return this;
         },
-
+        /**
+         * @returns {wp.media.view.Modal} Returns itself to allow chaining
+         */
         escape: function() {
             return this.close({ escape: true });
         },
-
+        /**
+         * @param {Object} event
+         */
         escapeHandler: function( event ) {
             event.preventDefault();
@@ -1661 +2064 @@
         },
 
+        /**
+         * @param {Array|Object} content Views to register to '.media-modal-content'
+         * @returns {wp.media.view.Modal} Returns itself to allow chaining
+         */
         content: function( content ) {
             this.views.set( '.media-modal-content', content );
@@ -1666 +2073 @@
         },
 
-        // Triggers a modal event and if the `propagate` option is set,
-        // forwards events to the modal's controller.
+        /**
+         * Triggers a modal event and if the `propagate` option is set,
+         * forwards events to the modal's controller.
+         *
+         * @param {string} id
+         * @returns {wp.media.view.Modal} Returns itself to allow chaining
+         */
         propagate: function( id ) {
             this.trigger( id );
 
-            if ( this.options.propagate )
+            if ( this.options.propagate ) {
                 this.controller.trigger( id );
+            }
 
             return this;
         },
-
+        /**
+         * @param {Object} event
+         */
         keydown: function( event ) {
             // Close the modal when escape is pressed.
@@ -1687 +2102 @@
     });
 
-    // wp.media.view.FocusManager
-    // ----------------------------
+    /**
+     * wp.media.view.FocusManager
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.FocusManager = media.View.extend({
         events: {
@@ -1696 +2117 @@
 
         focus: function() {
-            if ( _.isUndefined( this.index ) )
+            if ( _.isUndefined( this.index ) ) {
                 return;
+            }
 
             // Update our collection of `$tabbables`.
@@ -1705 +2127 @@
             this.$tabbables.eq( this.index ).focus();
         },
-
+        /**
+         * @param {Object} event
+         */
         recordTab: function( event ) {
             // Look for the tab key.
-            if ( 9 !== event.keyCode )
+            if ( 9 !== event.keyCode ) {
                 return;
+            }
 
             // First try to update the index.
-            if ( _.isUndefined( this.index ) )
+            if ( _.isUndefined( this.index ) ) {
                 this.updateIndex( event );
+            }
 
             // If we still don't have an index, bail.
-            if ( _.isUndefined( this.index ) )
+            if ( _.isUndefined( this.index ) ) {
                 return;
+            }
 
             var index = this.index + ( event.shiftKey ? -1 : 1 );
 
-            if ( index >= 0 && index < this.$tabbables.length )
+            if ( index >= 0 && index < this.$tabbables.length ) {
                 this.index = index;
-            else
+            } else {
                 delete this.index;
-        },
-
+            }
+        },
+        /**
+         * @param {Object} event
+         */
         updateIndex: function( event ) {
             this.$tabbables = this.$(':tabbable');
@@ -1732 +2162 @@
             var index = this.$tabbables.index( event.target );
 
-            if ( -1 === index )
+            if ( -1 === index ) {
                 delete this.index;
-            else
+            } else {
                 this.index = index;
+            }
         }
     });
 
-    // wp.media.view.UploaderWindow
-    // ----------------------------
+    /**
+     * wp.media.view.UploaderWindow
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.UploaderWindow = media.View.extend({
         tagName:   'div',
@@ -1758 +2195 @@
 
             // Ensure the dropzone is a jQuery collection.
-            if ( uploader.dropzone && ! (uploader.dropzone instanceof $) )
+            if ( uploader.dropzone && ! (uploader.dropzone instanceof $) ) {
                 uploader.dropzone = $( uploader.dropzone );
+            }
 
             this.controller.on( 'activate', this.refresh, this );
@@ -1765 +2203 @@
 
         refresh: function() {
-            if ( this.uploader )
+            if ( this.uploader ) {
                 this.uploader.refresh();
+            }
         },
 
@@ -1774 +2213 @@
 
             // If the uploader already exists, bail.
-            if ( this.uploader )
+            if ( this.uploader ) {
                 return;
-
-            if ( postId )
+            }
+
+            if ( postId ) {
                 this.options.uploader.params.post_id = postId;
-
+            }
             this.uploader = new wp.Uploader( this.options.uploader );
 
@@ -1809 +2249 @@
     });
 
+    /**
+     * wp.media.view.UploaderInline
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.UploaderInline = media.View.extend({
         tagName:   'div',
@@ -1820 +2268 @@
             });
 
-            if ( ! this.options.$browser && this.controller.uploader )
+            if ( ! this.options.$browser && this.controller.uploader ) {
                 this.options.$browser = this.controller.uploader.$browser;
-
-            if ( _.isUndefined( this.options.postId ) )
+            }
+
+            if ( _.isUndefined( this.options.postId ) ) {
                 this.options.postId = media.view.settings.post.id;
+            }
 
             if ( this.options.status ) {
@@ -1832 +2282 @@
             }
         },
-
+        /**
+         * @returns {wp.media.view.UploaderInline} Returns itself to allow chaining
+         */
         dispose: function() {
-            if ( this.disposing )
+            if ( this.disposing ) {
+                /**
+                 * call 'dispose' directly on the parent class
+                 */
                 return media.View.prototype.dispose.apply( this, arguments );
+            }
 
             // Run remove on `dispose`, so we can be sure to refresh the
@@ -1843 +2299 @@
             return this.remove();
         },
-
+        /**
+         * @returns {wp.media.view.UploaderInline} Returns itself to allow chaining
+         */
         remove: function() {
+            /**
+             * call 'remove' directly on the parent class
+             */
             var result = media.View.prototype.remove.apply( this, arguments );
 
@@ -1854 +2315 @@
             var uploader = this.controller.uploader;
 
-            if ( uploader )
+            if ( uploader ) {
                 uploader.refresh();
-        },
-
+            }
+        },
+        /**
+         * @returns {wp.media.view.UploaderInline}
+         */
         ready: function() {
             var $browser = this.options.$browser,
@@ -1866 +2330 @@
 
                 // Check if we've already replaced the placeholder.
-                if ( $placeholder[0] === $browser[0] )
+                if ( $placeholder[0] === $browser[0] ) {
                     return;
+                }
 
                 $browser.detach().text( $placeholder.text() );
@@ -1881 +2346 @@
     /**
      * wp.media.view.UploaderStatus
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.UploaderStatus = media.View.extend({
@@ -1901 +2371 @@
             this.errors.on( 'add', this.error, this );
         },
-
+        /**
+         * @global wp.Uploader
+         * @returns {wp.media.view.UploaderStatus}
+         */
         dispose: function() {
             wp.Uploader.queue.off( null, null, this );
+            /**
+             * call 'dispose' directly on the parent class
+             */
             media.View.prototype.dispose.apply( this, arguments );
             return this;
@@ -1933 +2409 @@
                 $bar = this.$bar;
 
-            if ( ! $bar || ! queue.length )
+            if ( ! $bar || ! queue.length ) {
                 return;
+            }
 
             $bar.width( ( queue.reduce( function( memo, attachment ) {
-                if ( ! attachment.get('uploading') )
+                if ( ! attachment.get('uploading') ) {
                     return memo + 100;
+                }
 
                 var percent = attachment.get('percent');
@@ -1949 +2427 @@
                 index = 0, active;
 
-            if ( ! queue.length )
+            if ( ! queue.length ) {
                 return;
+            }
 
             active = this.queue.find( function( attachment, i ) {
@@ -1961 +2440 @@
             this.$filename.html( active ? this.filename( active.get('filename') ) : '' );
         },
-
+        /**
+         * @param {string} filename
+         * @returns {string}
+         */
         filename: function( filename ) {
             return media.truncate( _.escape( filename ), 24 );
         },
-
+        /**
+         * @param {Backbone.Model} error
+         */
         error: function( error ) {
             this.views.add( '.upload-errors', new media.view.UploaderStatusError({
@@ -1973 +2457 @@
         },
 
+        /**
+         * @global wp.Uploader
+         *
+         * @param {Object} event
+         */
         dismiss: function( event ) {
             var errors = this.views.get('.upload-errors');
@@ -1978 +2467 @@
             event.preventDefault();
 
-            if ( errors )
+            if ( errors ) {
                 _.invoke( errors, 'remove' );
+            }
             wp.Uploader.errors.reset();
         }
     });
 
+    /**
+     * wp.media.view.UploaderStatusError
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.UploaderStatusError = media.View.extend({
         className: 'upload-error',
@@ -1991 +2489 @@
     /**
      * wp.media.view.Toolbar
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Toolbar = media.View.extend({
@@ -2011 +2514 @@
             this.views.set([ this.secondary, this.primary ]);
 
-            if ( this.options.items )
+            if ( this.options.items ) {
                 this.set( this.options.items, { silent: true });
-
-            if ( ! this.options.silent )
+            }
+
+            if ( ! this.options.silent ) {
                 this.render();
-
-            if ( selection )
+            }
+
+            if ( selection ) {
                 selection.on( 'add remove reset', this.refresh, this );
-            if ( library )
+            }
+
+            if ( library ) {
                 library.on( 'add remove reset', this.refresh, this );
-        },
-
+            }
+        },
+        /**
+         * @returns {wp.media.view.Toolbar} Returns itsef to allow chaining
+         */
         dispose: function() {
-            if ( this.selection )
+            if ( this.selection ) {
                 this.selection.off( null, null, this );
-            if ( this.library )
+            }
+
+            if ( this.library ) {
                 this.library.off( null, null, this );
+            }
+            /**
+             * call 'dispose' directly on the parent class
+             */
             return media.View.prototype.dispose.apply( this, arguments );
         },
@@ -2035 +2551 @@
         },
 
+        /**
+         * @param {string} id
+         * @param {Backbone.View|Object} view
+         * @param {Object} [options={}]
+         * @returns {wp.media.view.Toolbar} Returns itself to allow chaining
+         */
         set: function( id, view, options ) {
             var list;
@@ -2059 +2581 @@
             }
 
-            if ( ! options.silent )
+            if ( ! options.silent ) {
                 this.refresh();
+            }
 
             return this;
         },
-
+        /**
+         * @param {string} id
+         * @returns {wp.media.view.Button}
+         */
         get: function( id ) {
             return this._views[ id ];
         },
-
+        /**
+         * @param {string} id
+         * @param {Object} options
+         * @returns {wp.media.view.Toolbar} Returns itself to allow chaining
+         */
         unset: function( id, options ) {
             delete this._views[ id ];
@@ -2074 +2604 @@
             this.secondary.unset( id, options );
 
-            if ( ! options || ! options.silent )
+            if ( ! options || ! options.silent ) {
                 this.refresh();
+            }
             return this;
         },
@@ -2085 +2616 @@
 
             _.each( this._views, function( button ) {
-                if ( ! button.model || ! button.options || ! button.options.requires )
+                if ( ! button.model || ! button.options || ! button.options.requires ) {
                     return;
+                }
 
                 var requires = button.options.requires,
@@ -2096 +2628 @@
                 });
 
-                if ( requires.selection && selection && ! selection.length )
+                if ( requires.selection && selection && ! selection.length ) {
                     disabled = true;
-                else if ( requires.library && library && ! library.length )
+                } else if ( requires.library && library && ! library.length ) {
                     disabled = true;
-
+                }
                 button.model.set( 'disabled', disabled );
             });
@@ -2106 +2638 @@
     });
 
-    // wp.media.view.Toolbar.Select
-    // ----------------------------
+    /**
+     * wp.media.view.Toolbar.Select
+     *
+     * @constructor
+     * @augments wp.media.view.Toolbar
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.Toolbar.Select = media.view.Toolbar.extend({
         initialize: function() {
@@ -2136 +2675 @@
                 }
             });
-
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.Toolbar.prototype.initialize.apply( this, arguments );
         },
@@ -2144 +2685 @@
                 controller = this.controller;
 
-            if ( options.close )
+            if ( options.close ) {
                 controller.close();
-
-            if ( options.event )
+            }
+
+            if ( options.event ) {
                 controller.state().trigger( options.event );
-
-            if ( options.state )
+            }
+
+            if ( options.state ) {
                 controller.setState( options.state );
-
-            if ( options.reset )
+            }
+
+            if ( options.reset ) {
                 controller.reset();
+            }
         }
     });
 
-    // wp.media.view.Toolbar.Embed
-    // ---------------------------
+    /**
+     * wp.media.view.Toolbar.Embed
+     *
+     * @constructor
+     * @augments wp.media.view.Toolbar.Select
+     * @augments wp.media.view.Toolbar
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.Toolbar.Embed = media.view.Toolbar.Select.extend({
         initialize: function() {
@@ -2166 +2719 @@
                 requires: false
             });
-
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.Toolbar.Select.prototype.initialize.apply( this, arguments );
         },
@@ -2173 +2728 @@
             var url = this.controller.state().props.get('url');
             this.get('select').model.set( 'disabled', ! url || url === 'http://' );
-
+            /**
+             * call 'refresh' directly on the parent class
+             */
             media.view.Toolbar.Select.prototype.refresh.apply( this, arguments );
         }
@@ -2180 +2737 @@
     /**
      * wp.media.view.Button
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Button = media.View.extend({
@@ -2198 +2760 @@
 
         initialize: function() {
-            // Create a model with the provided `defaults`.
+            /**
+             * Create a model with the provided `defaults`.
+             *
+             * @member {Backbone.Model}
+             */
             this.model = new Backbone.Model( this.defaults );
 
@@ -2214 +2780 @@
             this.model.on( 'change', this.render, this );
         },
-
+        /**
+         * @returns {wp.media.view.Button} Returns itself to allow chaining
+         */
         render: function() {
             var classes = [ 'button', this.className ],
                 model = this.model.toJSON();
 
-            if ( model.style )
+            if ( model.style ) {
                 classes.push( 'button-' + model.style );
-
-            if ( model.size )
+            }
+
+            if ( model.size ) {
                 classes.push( 'button-' + model.size );
+            }
 
             classes = _.uniq( classes.concat( this.options.classes ) );
@@ -2233 +2803 @@
             return this;
         },
-
+        /**
+         * @param {Object} event
+         */
         click: function( event ) {
-            if ( '#' === this.attributes.href )
+            if ( '#' === this.attributes.href ) {
                 event.preventDefault();
-
-            if ( this.options.click && ! this.model.get('disabled') )
+            }
+
+            if ( this.options.click && ! this.model.get('disabled') ) {
                 this.options.click.apply( this, arguments );
+            }
         }
     });
@@ -2245 +2819 @@
     /**
      * wp.media.view.ButtonGroup
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.ButtonGroup = media.View.extend({
@@ -2251 +2830 @@
 
         initialize: function() {
+            /**
+             * @member {wp.media.view.Button[]}
+             */
             this.buttons = _.map( this.options.buttons || [], function( button ) {
-                if ( button instanceof Backbone.View )
+                if ( button instanceof Backbone.View ) {
                     return button;
-                else
+                } else {
                     return new media.view.Button( button ).render();
+                }
             });
 
             delete this.options.buttons;
 
-            if ( this.options.classes )
+            if ( this.options.classes ) {
                 this.$el.addClass( this.options.classes );
-        },
-
+            }
+        },
+
+        /**
+         * @returns {wp.media.view.ButtonGroup}
+         */
         render: function() {
             this.$el.html( $( _.pluck( this.buttons, 'el' ) ).detach() );
@@ -2272 +2859 @@
     /**
      * wp.media.view.PriorityList
-     */
-
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.PriorityList = media.View.extend({
         tagName:   'div',
@@ -2283 +2874 @@
             delete this.options.views;
 
-            if ( ! this.options.silent )
+            if ( ! this.options.silent ) {
                 this.render();
-        },
-
+            }
+        },
+        /**
+         * @param {string} id
+         * @param {wp.media.View|Object} view
+         * @param {Object} options
+         * @returns {wp.media.view.PriorityList} Returns itself to allow chaining
+         */
         set: function( id, view, options ) {
             var priority, views, index;
@@ -2300 +2897 @@
             }
 
-            if ( ! (view instanceof Backbone.View) )
+            if ( ! (view instanceof Backbone.View) ) {
                 view = this.toView( view, id, options );
-
+            }
             view.controller = view.controller || this.controller;
 
@@ -2324 +2921 @@
             return this;
         },
-
+        /**
+         * @param {string} id
+         * @returns {wp.media.View}
+         */
         get: function( id ) {
             return this._views[ id ];
         },
-
+        /**
+         * @param {string} id
+         * @returns {wp.media.view.PriorityList}
+         */
         unset: function( id ) {
             var view = this.get( id );
 
-            if ( view )
+            if ( view ) {
                 view.remove();
+            }
 
             delete this._views[ id ];
             return this;
         },
-
+        /**
+         * @param {Object} options
+         * @returns {wp.media.View}
+         */
         toView: function( options ) {
             return new media.View( options );
@@ -2346 +2953 @@
     /**
      * wp.media.view.MenuItem
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.MenuItem = media.View.extend({
@@ -2358 +2970 @@
             'click': '_click'
         },
-
+        /**
+         * @param {Object} event
+         */
         _click: function( event ) {
             var clickOverride = this.options.click;
 
-            if ( event )
+            if ( event ) {
                 event.preventDefault();
-
-            if ( clickOverride )
+            }
+
+            if ( clickOverride ) {
                 clickOverride.call( this );
-            else
+            } else {
                 this.click();
+            }
         },
 
         click: function() {
             var state = this.options.state;
-            if ( state )
+            if ( state ) {
                 this.controller.setState( state );
-        },
-
+            }
+        },
+        /**
+         * @returns {wp.media.view.MenuItem} returns itself to allow chaining
+         */
         render: function() {
             var options = this.options;
 
-            if ( options.text )
+            if ( options.text ) {
                 this.$el.text( options.text );
-            else if ( options.html )
+            } else if ( options.html ) {
                 this.$el.html( options.html );
+            }
 
             return this;
@@ -2391 +3011 @@
     /**
      * wp.media.view.Menu
+     *
+     * @constructor
+     * @augments wp.media.view.PriorityList
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Menu = media.view.PriorityList.extend({
@@ -2398 +3024 @@
         ItemView:  media.view.MenuItem,
         region:    'menu',
-
+        /**
+         * @param {Object} options
+         * @param {string} id
+         * @returns {wp.media.View}
+         */
         toView: function( options, id ) {
             options = options || {};
@@ -2406 +3036 @@
 
         ready: function() {
+            /**
+             * call 'ready' directly on the parent class
+             */
             media.view.PriorityList.prototype.ready.apply( this, arguments );
             this.visibility();
@@ -2411 +3044 @@
 
         set: function() {
+            /**
+             * call 'set' directly on the parent class
+             */
             media.view.PriorityList.prototype.set.apply( this, arguments );
             this.visibility();
@@ -2416 +3052 @@
 
         unset: function() {
+            /**
+             * call 'unset' directly on the parent class
+             */
             media.view.PriorityList.prototype.unset.apply( this, arguments );
             this.visibility();
@@ -2426 +3065 @@
                 hide = ! views || views.length < 2;
 
-            if ( this === view )
+            if ( this === view ) {
                 this.controller.$el.toggleClass( 'hide-' + region, hide );
-        },
-
+            }
+        },
+        /**
+         * @param {string} id
+         */
         select: function( id ) {
             var view = this.get( id );
 
-            if ( ! view )
+            if ( ! view ) {
                 return;
+            }
 
             this.deselect();
@@ -2447 +3090 @@
     /**
      * wp.media.view.RouterItem
+     *
+     * @constructor
+     * @augments wp.media.view.MenuItem
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.RouterItem = media.view.MenuItem.extend({
         click: function() {
             var contentMode = this.options.contentMode;
-            if ( contentMode )
+            if ( contentMode ) {
                 this.controller.content.mode( contentMode );
+            }
         }
     });
@@ -2458 +3108 @@
     /**
      * wp.media.view.Router
+     *
+     * @constructor
+     * @augments wp.media.view.Menu
+     * @augments wp.media.view.PriorityList
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Router = media.view.Menu.extend({
@@ -2468 +3125 @@
         initialize: function() {
             this.controller.on( 'content:render', this.update, this );
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.Menu.prototype.initialize.apply( this, arguments );
         },
@@ -2473 +3133 @@
         update: function() {
             var mode = this.controller.content.mode();
-            if ( mode )
+            if ( mode ) {
                 this.select( mode );
+            }
         }
     });
 
-
     /**
      * wp.media.view.Sidebar
+     *
+     * @constructor
+     * @augments wp.media.view.PriorityList
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Sidebar = media.view.PriorityList.extend({
@@ -2488 +3154 @@
     /**
      * wp.media.view.Attachment
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachment = media.View.extend({
@@ -2518 +3189 @@
             this.model.on( 'add', this.select, this );
             this.model.on( 'remove', this.deselect, this );
-            if ( selection )
+            if ( selection ) {
                 selection.on( 'reset', this.updateSelect, this );
+            }
 
             // Update the model's details view.
@@ -2525 +3197 @@
             this.details( this.model, this.controller.state().get('selection') );
         },
-
+        /**
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
         dispose: function() {
             var selection = this.options.selection;
@@ -2532 +3206 @@
             this.updateAll();
 
-            if ( selection )
+            if ( selection ) {
                 selection.off( null, null, this );
-
+            }
+            /**
+             * call 'dispose' directly on the parent class
+             */
             media.View.prototype.dispose.apply( this, arguments );
             return this;
         },
-
+        /**
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
         render: function() {
             var options = _.defaults( this.model.toJSON(), {
@@ -2593 +3272 @@
 
         progress: function() {
-            if ( this.$bar && this.$bar.length )
+            if ( this.$bar && this.$bar.length ) {
                 this.$bar.width( this.model.get('percent') + '%' );
-        },
-
+            }
+        },
+        /**
+         * @param {Object} event
+         */
         toggleSelectionHandler: function( event ) {
             var method;
 
-            if ( event.shiftKey )
+            if ( event.shiftKey ) {
                 method = 'between';
-            else if ( event.ctrlKey || event.metaKey )
+            } else if ( event.ctrlKey || event.metaKey ) {
                 method = 'toggle';
+            }
 
             this.toggleSelection({
@@ -2609 +3292 @@
             });
         },
-
+        /**
+         * @param {Object} options
+         */
         toggleSelection: function( options ) {
             var collection = this.collection,
@@ -2617 +3302 @@
                 single, models, singleIndex, modelIndex;
 
-            if ( ! selection )
+            if ( ! selection ) {
                 return;
+            }
 
             single = selection.single();
@@ -2627 +3313 @@
             if ( 'between' === method && single && selection.multiple ) {
                 // If the models are the same, short-circuit.
-                if ( single === model )
+                if ( single === model ) {
                     return;
+                }
 
                 singleIndex = collection.indexOf( single );
                 modelIndex  = collection.indexOf( this.model );
 
-                if ( singleIndex < modelIndex )
+                if ( singleIndex < modelIndex ) {
                     models = collection.models.slice( singleIndex, modelIndex + 1 );
-                else
+                } else {
                     models = collection.models.slice( modelIndex, singleIndex + 1 );
+                }
 
                 selection.add( models ).single( model );
@@ -2648 +3336 @@
             }
 
-            if ( method !== 'add' )
+            if ( method !== 'add' ) {
                 method = 'reset';
+            }
 
             if ( this.selected() ) {
@@ -2667 +3356 @@
             this[ this.selected() ? 'select' : 'deselect' ]();
         },
-
+        /**
+         * @returns {unresolved|Boolean}
+         */
         selected: function() {
             var selection = this.options.selection;
-            if ( selection )
+            if ( selection ) {
                 return !! selection.get( this.model.cid );
-        },
-
+            }
+        },
+        /**
+         * @param {Backbone.Model} model
+         * @param {Backbone.Collection} collection
+         */
         select: function( model, collection ) {
             var selection = this.options.selection;
@@ -2680 +3375 @@
             // If they're not the same collection, bail; we're in another
             // selection's event loop.
-            if ( ! selection || ( collection && collection !== selection ) )
+            if ( ! selection || ( collection && collection !== selection ) ) {
                 return;
+            }
 
             this.$el.addClass('selected');
         },
-
+        /**
+         * @param {Backbone.Model} model
+         * @param {Backbone.Collection} collection
+         */
         deselect: function( model, collection ) {
             var selection = this.options.selection;
@@ -2692 +3391 @@
             // If they're not the same collection, bail; we're in another
             // selection's event loop.
-            if ( ! selection || ( collection && collection !== selection ) )
+            if ( ! selection || ( collection && collection !== selection ) ) {
                 return;
-
+            }
             this.$el.removeClass('selected');
         },
-
+        /**
+         * @param {Backbone.Model} model
+         * @param {Backbone.Collection} collection
+         */
         details: function( model, collection ) {
             var selection = this.options.selection,
                 details;
 
-            if ( selection !== collection )
+            if ( selection !== collection ) {
                 return;
+            }
 
             details = selection.single();
             this.$el.toggleClass( 'details', details === this.model );
         },
-
+        /**
+         * @param {Object} event
+         */
         preventDefault: function( event ) {
             event.preventDefault();
         },
-
+        /**
+         * @param {string} size
+         * @returns {Object}
+         */
         imageSize: function( size ) {
             var sizes = this.model.get('sizes');
@@ -2730 +3438 @@
             }
         },
-
+        /**
+         * @param {Object} event
+         */
         updateSetting: function( event ) {
             var $setting = $( event.target ).closest('[data-setting]'),
                 setting, value;
 
-            if ( ! $setting.length )
+            if ( ! $setting.length ) {
                 return;
+            }
 
             setting = $setting.data('setting');
             value   = event.target.value;
 
-            if ( this.model.get( setting ) !== value )
+            if ( this.model.get( setting ) !== value ) {
                 this.save( setting, value );
-        },
-
-        // Pass all the arguments to the model's save method.
-        //
-        // Records the aggregate status of all save requests and updates the
-        // view's classes accordingly.
+            }
+        },
+
+        /**
+         * Pass all the arguments to the model's save method.
+         *
+         * Records the aggregate status of all save requests and updates the
+         * view's classes accordingly.
+         */
         save: function() {
             var view = this,
@@ -2756 +3470 @@
 
             // If we're waiting to remove 'Saved.', stop.
-            if ( save.savedTimer )
+            if ( save.savedTimer ) {
                 clearTimeout( save.savedTimer );
+            }
 
             this.updateSave('waiting');
@@ -2763 +3478 @@
             requests.always( function() {
                 // If we've performed another request since this one, bail.
-                if ( save.requests !== requests )
+                if ( save.requests !== requests ) {
                     return;
+                }
 
                 view.updateSave( requests.state() === 'resolved' ? 'complete' : 'error' );
@@ -2772 +3488 @@
                 }, 2000 );
             });
-
-        },
-
+        },
+        /**
+         * @param {string} status
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
         updateSave: function( status ) {
             var save = this._save = this._save || { status: 'ready' };
@@ -2796 +3514 @@
                     setting, value;
 
-                if ( ! $input.length )
+                if ( ! $input.length ) {
                     return;
+                }
 
                 setting = $(el).data('setting');
@@ -2803 +3522 @@
 
                 // Record the value if it changed.
-                if ( model.get( setting ) !== value )
+                if ( model.get( setting ) !== value ) {
                     return [ setting, value ];
+                }
             }).compact().object().value();
 
-            if ( ! _.isEmpty( changed ) )
+            if ( ! _.isEmpty( changed ) ) {
                 model.save( changed );
-        },
-
+            }
+        },
+        /**
+         * @param {Object} event
+         */
         removeFromLibrary: function( event ) {
             // Stop propagation so the model isn't selected.
@@ -2817 +3540 @@
             this.collection.remove( this.model );
         },
-
+        /**
+         * @param {Object} event
+         */
         removeFromSelection: function( event ) {
             var selection = this.options.selection;
-            if ( ! selection )
+            if ( ! selection ) {
                 return;
+            }
 
             // Stop propagation so the model isn't selected.
@@ -2835 +3561 @@
         title:   '_syncTitle'
     }, function( method, setting ) {
+        /**
+         * @param {Backbone.Model} model
+         * @param {string} value
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
         media.view.Attachment.prototype[ method ] = function( model, value ) {
             var $setting = this.$('[data-setting="' + setting + '"]');
 
-            if ( ! $setting.length )
+            if ( ! $setting.length ) {
                 return this;
+            }
 
             // If the updated value is in sync with the value in the DOM, there
@@ -2845 +3577 @@
             // it will automatically be in sync, suppressing the re-render for
             // the view we're editing, while updating any others.
-            if ( value === $setting.find('input, textarea, select, [value]').val() )
+            if ( value === $setting.find('input, textarea, select, [value]').val() ) {
                 return this;
+            }
 
             return this.render();
@@ -2854 +3587 @@
     /**
      * wp.media.view.Attachment.Library
+     *
+     * @constructor
+     * @augments wp.media.view.Attachment
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachment.Library = media.view.Attachment.extend({
@@ -2863 +3602 @@
     /**
      * wp.media.view.Attachment.EditLibrary
+     *
+     * @constructor
+     * @augments wp.media.view.Attachment
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachment.EditLibrary = media.view.Attachment.extend({
@@ -2872 +3617 @@
     /**
      * wp.media.view.Attachments
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachments = media.View.extend({
@@ -2906 +3656 @@
                 delete this._viewsByCid[ attachment.cid ];
 
-                if ( view )
+                if ( view ) {
                     view.remove();
+                }
             }, this );
 
@@ -2920 +3671 @@
             this.model.on( 'change:edge change:gutter', this.css, this );
             this._resizeCss = _.debounce( _.bind( this.css, this ), this.refreshSensitivity );
-            if ( this.options.resize )
+            if ( this.options.resize ) {
                 $(window).on( 'resize.attachments', this._resizeCss );
+            }
             this.css();
         },
@@ -2928 +3680 @@
             this.collection.props.off( null, null, this );
             $(window).off( 'resize.attachments', this._resizeCss );
+            /**
+             * call 'dispose' directly on the parent class
+             */
             media.View.prototype.dispose.apply( this, arguments );
         },
@@ -2934 +3689 @@
             var $css = $( '#' + this.el.id + '-css' );
 
-            if ( $css.length )
+            if ( $css.length ) {
                 $css.remove();
+            }
 
             media.view.Attachments.$head().append( this.cssTemplate({
@@ -2943 +3699 @@
             }) );
         },
-
+        /**
+         * @returns {Number}
+         */
         edge: function() {
             var edge = this.model.get('edge'),
                 gutter, width, columns;
 
-            if ( ! this.$el.is(':visible') )
+            if ( ! this.$el.is(':visible') ) {
                 return edge;
+            }
 
             gutter  = this.model.get('gutter') * 2;
@@ -2961 +3720 @@
             var collection = this.collection;
 
-            if ( ! this.options.sortable || ! $.fn.sortable )
+            if ( ! this.options.sortable || ! $.fn.sortable ) {
                 return;
+            }
 
             this.$el.sortable( _.extend({
@@ -3033 +3793 @@
         },
 
+        /**
+         * @param {wp.media.model.Attachment} attachment
+         * @returns {wp.media.View}
+         */
         createAttachmentView: function( attachment ) {
             var view = new this.options.AttachmentView({
@@ -3065 +3829 @@
         scroll: function() {
             // @todo: is this still necessary?
-            if ( ! this.$el.is(':visible') )
+            if ( ! this.$el.is(':visible') ) {
                 return;
+            }
 
             if ( this.collection.hasMore() && this.el.scrollHeight < this.el.scrollTop + ( this.el.clientHeight * this.options.refreshThreshold ) ) {
@@ -3083 +3848 @@
     /**
      * wp.media.view.Search
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Search = media.View.extend({
@@ -3100 +3870 @@
         },
 
+        /**
+         * @returns {wp.media.view.Search} Returns itself to allow chaining
+         */
         render: function() {
             this.el.value = this.model.escape('search');
@@ -3106 +3879 @@
 
         search: function( event ) {
-            if ( event.target.value )
+            if ( event.target.value ) {
                 this.model.set( 'search', event.target.value );
-            else
+            } else {
                 this.model.unset('search');
+            }
         }
     });
@@ -3115 +3889 @@
     /**
      * wp.media.view.AttachmentFilters
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.AttachmentFilters = media.View.extend({
@@ -3149 +3928 @@
             var filter = this.filters[ this.el.value ];
 
-            if ( filter )
+            if ( filter ) {
                 this.model.set( filter.props );
+            }
         },
 
@@ -3163 +3943 @@
                 });
 
-                if ( equal )
+                if ( equal ) {
                     return value = id;
+                }
             });
 
@@ -3171 +3952 @@
     });
 
+    /**
+     * wp.media.view.AttachmentFilters.Uploaded
+     *
+     * @constructor
+     * @augments wp.media.view.AttachmentFilters
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.AttachmentFilters.Uploaded = media.view.AttachmentFilters.extend({
         createFilters: function() {
@@ -3177 +3967 @@
                 text;
 
-            if ( types && type )
+            if ( types && type ) {
                 text = types[ type ];
+            }
 
             this.filters = {
@@ -3204 +3995 @@
     });
 
+    /**
+     * wp.media.view.AttachmentFilters.All
+     *
+     * @constructor
+     * @augments wp.media.view.AttachmentFilters
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
+     */
     media.view.AttachmentFilters.All = media.view.AttachmentFilters.extend({
         createFilters: function() {
@@ -3247 +4047 @@
 
 
-
     /**
      * wp.media.view.AttachmentsBrowser
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.AttachmentsBrowser = media.View.extend({
@@ -3270 +4074 @@
             this.collection.on( 'add remove reset', this.updateContent, this );
         },
-
+        /**
+         * @returns {wp.media.view.AttachmentsBrowser} Returns itself to allow chaining
+         */
         dispose: function() {
             this.options.selection.off( null, null, this );
@@ -3280 +4086 @@
             var filters, FiltersConstructor;
 
+            /**
+             * @member {wp.media.view.Toolbar}
+             */
             this.toolbar = new media.view.Toolbar({
                 controller: this.controller
@@ -3287 +4096 @@
 
             filters = this.options.filters;
-            if ( 'uploaded' === filters )
+            if ( 'uploaded' === filters ) {
                 FiltersConstructor = media.view.AttachmentFilters.Uploaded;
-            else if ( 'all' === filters )
+            } else if ( 'all' === filters ) {
                 FiltersConstructor = media.view.AttachmentFilters.All;
+            }
 
             if ( FiltersConstructor ) {
@@ -3319 +4129 @@
             var view = this;
 
-            if( ! this.attachments )
+            if( ! this.attachments ) {
                 this.createAttachments();
+            }
 
             if ( ! this.collection.length ) {
@@ -3387 +4198 @@
             selection.on( 'selection:unsingle', this.disposeSingle, this );
 
-            if ( selection.single() )
+            if ( selection.single() ) {
                 this.createSingle();
+            }
         },
 
@@ -3428 +4240 @@
     /**
      * wp.media.view.Selection
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Selection = media.View.extend({
@@ -3445 +4262 @@
             });
 
+            /**
+             * @member {wp.media.view.Attachments.Selection}
+             */
             this.attachments = new media.view.Attachments.Selection({
                 controller: this.controller,
@@ -3466 +4286 @@
         refresh: function() {
             // If the selection hasn't been rendered, bail.
-            if ( ! this.$el.children().length )
+            if ( ! this.$el.children().length ) {
                 return;
+            }
 
             var collection = this.collection,
@@ -3482 +4303 @@
         edit: function( event ) {
             event.preventDefault();
-            if ( this.options.editable )
+            if ( this.options.editable ) {
                 this.options.editable.call( this, this.collection );
+            }
         },
 
@@ -3495 +4317 @@
     /**
      * wp.media.view.Attachment.Selection
+     *
+     * @constructor
+     * @augments wp.media.view.Attachment
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachment.Selection = media.view.Attachment.extend({
@@ -3508 +4336 @@
     /**
      * wp.media.view.Attachments.Selection
+     *
+     * @constructor
+     * @augments wp.media.view.Attachments
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachments.Selection = media.view.Attachments.extend({
@@ -3519 +4353 @@
                 AttachmentView: media.view.Attachment.Selection
             });
+            /**
+             * call 'initialize' directly on the parent class
+             */
             return media.view.Attachments.prototype.initialize.apply( this, arguments );
         }
@@ -3525 +4362 @@
     /**
      * wp.media.view.Attachments.EditSelection
+     *
+     * @constructor
+     * @augments wp.media.view.Attachment.Selection
+     * @augments wp.media.view.Attachment
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachment.EditSelection = media.view.Attachment.Selection.extend({
@@ -3535 +4379 @@
     /**
      * wp.media.view.Settings
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Settings = media.View.extend({
@@ -3554 +4403 @@
             }, this.options );
         },
-
+        /**
+         * @returns {wp.media.view.Setings} Returns itself to allow chaining
+         */
         render: function() {
             media.View.prototype.render.apply( this, arguments );
@@ -3561 +4412 @@
             return this;
         },
-
+        /**
+         * @param {string} key
+         */
         update: function( key ) {
             var value = this.model.get( key ),
@@ -3568 +4421 @@
 
             // Bail if we didn't find a matching setting.
-            if ( ! $setting.length )
+            if ( ! $setting.length ) {
                 return;
+            }
 
             // Attempt to determine how the setting is rendered and update
@@ -3586 +4440 @@
                 }
 
-
             // Handle button groups.
             } else if ( $setting.hasClass('button-group') ) {
@@ -3594 +4447 @@
             // Handle text inputs and textareas.
             } else if ( $setting.is('input[type="text"], textarea') ) {
-                if ( ! $setting.is(':focus') )
+                if ( ! $setting.is(':focus') ) {
                     $setting.val( value );
-
+                }
             // Handle checkboxes.
             } else if ( $setting.is('input[type="checkbox"]') ) {
@@ -3602 +4455 @@
             }
         },
-
+        /**
+         * @param {Object} event
+         */
         updateHandler: function( event ) {
             var $setting = $( event.target ).closest('[data-setting]'),
@@ -3610 +4465 @@
             event.preventDefault();
 
-            if ( ! $setting.length )
+            if ( ! $setting.length ) {
                 return;
+            }
 
             // Use the correct value for checkboxes.
-            if ( $setting.is('input[type="checkbox"]') )
+            if ( $setting.is('input[type="checkbox"]') ) {
                 value = $setting[0].checked;
+            }
 
             // Update the corresponding setting.
@@ -3622 +4479 @@
             // If the setting has a corresponding user setting,
             // update that as well.
-            if ( userSetting = $setting.data('userSetting') )
+            if ( userSetting = $setting.data('userSetting') ) {
                 setUserSetting( userSetting, value );
+            }
         },
 
         updateChanges: function( model ) {
-            if ( model.hasChanged() )
+            if ( model.hasChanged() ) {
                 _( model.changed ).chain().keys().each( this.update, this );
+            }
         }
     });
@@ -3634 +4493 @@
     /**
      * wp.media.view.Settings.AttachmentDisplay
+     *
+     * @constructor
+     * @augments wp.media.view.Settings
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Settings.AttachmentDisplay = media.view.Settings.extend({
@@ -3645 +4510 @@
                 userSettings: false
             });
-
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.Settings.prototype.initialize.apply( this, arguments );
             this.model.on( 'change:link', this.updateLinkTo, this );
 
-            if ( attachment )
+            if ( attachment ) {
                 attachment.on( 'change:uploading', this.render, this );
+            }
         },
 
         dispose: function() {
             var attachment = this.options.attachment;
-            if ( attachment )
+            if ( attachment ) {
                 attachment.off( null, null, this );
-
+            }
+            /**
+             * call 'dispose' directly on the parent class
+             */
             media.view.Settings.prototype.dispose.apply( this, arguments );
         },
-
+        /**
+         * @returns {wp.media.view.AttachmentDisplay} Returns itself to allow chaining
+         */
         render: function() {
             var attachment = this.options.attachment;
@@ -3669 +4542 @@
                 });
             }
-
+            /**
+             * call 'render' directly on the parent class
+             */
             media.view.Settings.prototype.render.call( this );
             this.updateLinkTo();
@@ -3700 +4575 @@
 
             // If the input is visible, focus and select its contents.
-            if ( $input.is(':visible') )
+            if ( $input.is(':visible') ) {
                 $input.focus()[0].select();
+            }
         }
     });
@@ -3707 +4583 @@
     /**
      * wp.media.view.Settings.Gallery
+     *
+     * @constructor
+     * @augments wp.media.view.Settings
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Settings.Gallery = media.view.Settings.extend({
@@ -3715 +4597 @@
     /**
      * wp.media.view.Attachment.Details
+     *
+     * @constructor
+     * @augments wp.media.view.Attachment
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Attachment.Details = media.view.Attachment.extend({
@@ -3732 +4620 @@
 
         initialize: function() {
+            /**
+             * @member {wp.media.view.FocusManager}
+             */
             this.focusManager = new media.view.FocusManager({
                 el: this.el
             });
-
+            /**
+             * call 'initialize' directly on the parent class
+             */
             media.view.Attachment.prototype.initialize.apply( this, arguments );
         },
-
+        /**
+         * @returns {wp.media.view..Attachment.Details} Returns itself to allow chaining
+         */
         render: function() {
+            /**
+             * call 'render' directly on the parent class
+             */
             media.view.Attachment.prototype.render.apply( this, arguments );
             this.focusManager.focus();
             return this;
         },
-
+        /**
+         * @param {Object} event
+         */
         deleteAttachment: function( event ) {
             event.preventDefault();
 
-            if ( confirm( l10n.warnDelete ) )
+            if ( confirm( l10n.warnDelete ) ) {
                 this.model.destroy();
+            }
         },
 
@@ -3755 +4656 @@
             this.$el.addClass('needs-refresh');
         },
-
+        /**
+         * @param {Object} event
+         */
         refreshAttachment: function( event ) {
             this.$el.removeClass('needs-refresh');
@@ -3765 +4668 @@
     /**
      * wp.media.view.AttachmentCompat
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.AttachmentCompat = media.View.extend({
@@ -3778 +4686 @@
 
         initialize: function() {
+            /**
+             * @member {wp.media.view.FocusManager}
+             */
             this.focusManager = new media.view.FocusManager({
                 el: this.el
@@ -3784 +4695 @@
             this.model.on( 'change:compat', this.render, this );
         },
-
+        /**
+         * @returns {wp.media.view.AttachmentCompat} Returns itself to allow chaining
+         */
         dispose: function() {
-            if ( this.$(':focus').length )
+            if ( this.$(':focus').length ) {
                 this.save();
-
+            }
+            /**
+             * call 'dispose' directly on the parent class
+             */
             return media.View.prototype.dispose.apply( this, arguments );
         },
-
+        /**
+         * @returns {wp.media.view.AttachmentCompat} Returns itself to allow chaining
+         */
         render: function() {
             var compat = this.model.get('compat');
-            if ( ! compat || ! compat.item )
+            if ( ! compat || ! compat.item ) {
                 return;
+            }
 
             this.views.detach();
@@ -3804 +4723 @@
             return this;
         },
-
+        /**
+         * @param {Object} event
+         */
         preventDefault: function( event ) {
             event.preventDefault();
         },
-
+        /**
+         * @param {Object} event
+         */
         save: function( event ) {
             var data = {};
 
-            if ( event )
+            if ( event ) {
                 event.preventDefault();
+            }
 
             _.each( this.$el.serializeArray(), function( pair ) {
@@ -3825 +4749 @@
     /**
      * wp.media.view.Iframe
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Iframe = media.View.extend({
         className: 'media-iframe',
-
+        /**
+         * @returns {wp.media.view.Iframe} Returns itself to allow chaining
+         */
         render: function() {
             this.views.detach();
@@ -3839 +4770 @@
     /**
      * wp.media.view.Embed
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.Embed = media.View.extend({
@@ -3844 +4780 @@
 
         initialize: function() {
+            /**
+             * @member {wp.media.view.EmbedUrl}
+             */
             this.url = new media.view.EmbedUrl({
                 controller: this.controller,
@@ -3855 +4794 @@
         },
 
+        /**
+         * @param {Object} view
+         */
         settings: function( view ) {
-            if ( this._settings )
+            if ( this._settings ) {
                 this._settings.remove();
+            }
             this._settings = view;
             this.views.add( view );
@@ -3866 +4809 @@
                 constructor;
 
-            if ( 'image' === type )
+            if ( 'image' === type ) {
                 constructor = media.view.EmbedImage;
-            else if ( 'link' === type )
+            } else if ( 'link' === type ) {
                 constructor = media.view.EmbedLink;
-            else
+            } else {
                 return;
+            }
 
             this.settings( new constructor({
@@ -3887 +4831 @@
     /**
      * wp.media.view.EmbedUrl
+     *
+     * @constructor
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.EmbedUrl = media.View.extend({
@@ -3907 +4856 @@
             this.model.on( 'change:url', this.render, this );
         },
-
+        /**
+         * @returns {wp.media.view.EmbedUrl} Returns itself to allow chaining
+         */
         render: function() {
             var $input = this.$input;
 
-            if ( $input.is(':focus') )
+            if ( $input.is(':focus') ) {
                 return;
+            }
 
             this.input.value = this.model.get('url') || 'http://';
+            /**
+             * Call `render` directly on parent class with passed arguments
+             */
             media.View.prototype.render.apply( this, arguments );
             return this;
@@ -3927 +4882 @@
         },
 
+        /**
+         * If the input is visible, focus and select its contents.
+         */
         focus: function() {
             var $input = this.$input;
-            // If the input is visible, focus and select its contents.
-            if ( $input.is(':visible') )
+            if ( $input.is(':visible') ) {
                 $input.focus()[0].select();
+            }
         }
     });
@@ -3937 +4895 @@
     /**
      * wp.media.view.EmbedLink
+     *
+     * @constructor
+     * @augments wp.media.view.Settings
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.EmbedLink = media.view.Settings.extend({
@@ -3945 +4909 @@
     /**
      * wp.media.view.EmbedImage
+     *
+     * @contructor
+     * @augments wp.media.view.Settings.AttachmentDisplay
+     * @augments wp.media.view.Settings
+     * @augments wp.media.View
+     * @augments wp.Backbone.View
+     * @augments Backbone.View
      */
     media.view.EmbedImage =  media.view.Settings.AttachmentDisplay.extend({
@@ -3951 +4922 @@
 
         initialize: function() {
+            /**
+             * Call `initialize` directly on parent class with passed arguments
+             */
             media.view.Settings.AttachmentDisplay.prototype.initialize.apply( this, arguments );
             this.model.on( 'change:url', this.updateImage, this );