Commit 0d46be7e3a for wordpress.org
commit 0d46be7e3ac8dc7138bf0980eab6ceebb6d8e032
Author: afercia <afercia@git.wordpress.org>
Date: Mon Sep 21 06:35:48 2026 +0000
General: Enable the JSDoc rule valid-types.
Enables the JSDoc rule `valid-types` and fixes all the reported violations.
Part of the effort to improve JS inline documentation for 7.2.
Developed in https://github.com/WordPress/wordpress-develop/pull/13486
See #66033.
Built from https://develop.svn.wordpress.org/trunk@63766
git-svn-id: http://core.svn.wordpress.org/trunk@62938 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-admin/js/comment.js b/wp-admin/js/comment.js
index d2ebafbcf4..5ed06b0fa4 100644
--- a/wp-admin/js/comment.js
+++ b/wp-admin/js/comment.js
@@ -24,8 +24,6 @@ jQuery( function($) {
/**
* Adds event that opens the time stamp form if the form is hidden.
*
- * @listens $edittimestamp:click
- *
* @param {Event} event The event object.
* @return {void}
*/
@@ -43,8 +41,6 @@ jQuery( function($) {
/**
* Resets the time stamp values when the cancel button is clicked.
*
- * @listens .cancel-timestamp:click
- *
* @param {Event} event The event object.
* @return {void}
*/
@@ -65,8 +61,6 @@ jQuery( function($) {
/**
* Sets the time stamp values when the ok button is clicked.
*
- * @listens .save-timestamp:click
- *
* @param {Event} event The event object.
* @return {void}
*/
@@ -110,8 +104,6 @@ jQuery( function($) {
*
* @since 7.1.0
*
- * @listens $editcommentparent:click
- *
* @param {Event} event The event object.
* @return {void}
*/
@@ -131,8 +123,6 @@ jQuery( function($) {
*
* @since 7.1.0
*
- * @listens .cancel-comment-parent:click
- *
* @param {Event} event The event object.
* @return {void}
*/
@@ -150,8 +140,6 @@ jQuery( function($) {
*
* @since 7.1.0
*
- * @listens .save-comment-parent:click
- *
* @param {Event} event The event object.
* @return {void}
*/
diff --git a/wp-admin/js/inline-edit-tax.js b/wp-admin/js/inline-edit-tax.js
index cedbefa256..f22633651a 100644
--- a/wp-admin/js/inline-edit-tax.js
+++ b/wp-admin/js/inline-edit-tax.js
@@ -29,7 +29,7 @@ window.inlineEditTax = {
*
* @since 2.7.0
*
- * @this inlineEditTax
+ * @this {inlineEditTax}
* @memberof inlineEditTax
* @return {void}
*/
@@ -93,7 +93,7 @@ window.inlineEditTax = {
*
* @since 2.7.0
*
- * @this inlineEditTax
+ * @this {inlineEditTax}
* @memberof inlineEditTax
*
* @param {HTMLElement} el An element within the table row or the table row
@@ -111,7 +111,7 @@ window.inlineEditTax = {
*
* @since 2.7.0
*
- * @this inlineEditTax
+ * @this {inlineEditTax}
* @memberof inlineEditTax
*
* @param {string|HTMLElement} id The ID of the term we want to quick edit or an
@@ -158,7 +158,7 @@ window.inlineEditTax = {
*
* @since 2.7.0
*
- * @this inlineEditTax
+ * @this {inlineEditTax}
* @memberof inlineEditTax
*
* @param {string|HTMLElement} id The ID of the term we want to quick edit or an
@@ -255,7 +255,7 @@ window.inlineEditTax = {
*
* @since 2.7.0
*
- * @this inlineEditTax
+ * @this {inlineEditTax}
* @memberof inlineEditTax
* @return {void}
*/
diff --git a/wp-admin/js/theme.js b/wp-admin/js/theme.js
index 3479aee73a..ff5d72ad28 100644
--- a/wp-admin/js/theme.js
+++ b/wp-admin/js/theme.js
@@ -275,10 +275,6 @@ themes.Collection = Backbone.Collection.extend({
* which triggers events of `query:success` or `query:fail`.
*/
query: function( request ) {
- /**
- * @static
- * @type Array
- */
var queries = this.queries,
self = this,
query, isPaginated, count;
diff --git a/wp-admin/js/user-profile.js b/wp-admin/js/user-profile.js
index dc0b5e8ccd..27a0121163 100644
--- a/wp-admin/js/user-profile.js
+++ b/wp-admin/js/user-profile.js
@@ -186,10 +186,10 @@
/**
* Helper function to insert an inline notice of success or failure.
*
- * @param {jQuery Object} $this The button element: the message will be inserted
- * above this button
- * @param {boolean} success Whether the message is a success message.
- * @param {string} message The message to insert.
+ * @param {jQuery} $this The button element: the message will be inserted
+ * above this button
+ * @param {boolean} success Whether the message is a success message.
+ * @param {string} message The message to insert.
*/
function addInlineNotice( $this, success, message ) {
var resultDiv = $( '<div />', {
diff --git a/wp-admin/js/widgets/media-widgets.js b/wp-admin/js/widgets/media-widgets.js
index 5d339308c5..ce366361d5 100644
--- a/wp-admin/js/widgets/media-widgets.js
+++ b/wp-admin/js/widgets/media-widgets.js
@@ -375,7 +375,7 @@ wp.mediaWidgets = ( function( $ ) {
*
* @ignore
*
- * @fires wp.media.controller.State#insert()
+ * @fires wp.media.controller.State#insert
* @return {void}
*/
click: function onClick() {
diff --git a/wp-includes/js/media-audiovideo.js b/wp-includes/js/media-audiovideo.js
index 05b99aaf5c..34a42838c1 100644
--- a/wp-includes/js/media-audiovideo.js
+++ b/wp-includes/js/media-audiovideo.js
@@ -602,7 +602,7 @@ MediaDetails = AttachmentDisplay.extend(/** @lends wp.media.view.MediaDetails.pr
/**
* Removes a setting's UI when the model unsets it
*
- * @fires wp.media.view.MediaDetails#media:setting:remove
+ * Fires `wp.media.view.MediaDetails#media:setting:remove` when a setting is removed.
*
* @param {JQuery.Event} e The jQuery event object.
*/
@@ -621,7 +621,7 @@ MediaDetails = AttachmentDisplay.extend(/** @lends wp.media.view.MediaDetails.pr
/**
* Sets the tracks for the media details view.
*
- * @fires wp.media.view.MediaDetails#media:setting:remove
+ * Fires `wp.media.view.MediaDetails#media:setting:remove` when the tracks are updated.
*/
setTracks : function() {
var tracks = '';
diff --git a/wp-includes/js/media-editor.js b/wp-includes/js/media-editor.js
index 3c0678c38e..47eb074aaa 100644
--- a/wp-includes/js/media-editor.js
+++ b/wp-includes/js/media-editor.js
@@ -490,7 +490,7 @@
* @param {string} content Content that is searched for possible
* shortcode markup matching the passed tag name,
*
- * @this wp.media.{prop}
+ * @this {wp.media.view.MediaFrame.Select}
*
* @return {void|wp.media.view.MediaFrame.Select} A media workflow.
*/
@@ -649,7 +649,7 @@
/**
* The Featured Image workflow
*
- * @this wp.media.featuredImage
+ * @this {wp.media.featuredImage}
*
* @return {wp.media.view.MediaFrame.Select} A media workflow.
*/
@@ -666,7 +666,7 @@
this._frame.on( 'toolbar:create:featured-image', function( toolbar ) {
/**
- * @this wp.media.view.MediaFrame.Select
+ * @this {wp.media.view.MediaFrame.Select}
*/
this.createSelectToolbar( toolbar, {
text: wp.media.view.l10n.setFeaturedImage
@@ -691,7 +691,7 @@
* 'select' callback for Featured Image workflow, triggered when
* the 'Set Featured Image' button is clicked in the media modal.
*
- * @this wp.media.controller.FeaturedImage
+ * @this {wp.media.controller.FeaturedImage}
*/
select: function() {
var selection = this.get('selection').single();
@@ -789,7 +789,7 @@
* @param {string} id A slug used to identify the workflow.
* @param {Object} [options={}] The options for the media workflow.
*
- * @this wp.media.editor
+ * @this {wp.media.editor}
*
* @return {wp.media.view.MediaFrame.Select} A media workflow.
*/
@@ -820,7 +820,7 @@
$.when.apply( $, selection.map( function( attachment ) {
var display = state.display( attachment ).toJSON();
/**
- * @this wp.media.editor
+ * @this {wp.media.editor}
*/
return this.send.attachment( display, attachment.toJSON() );
}, this ) ).done( function() {
@@ -830,28 +830,28 @@
workflow.state('gallery-edit').on( 'update', function( selection ) {
/**
- * @this wp.media.editor
+ * @this {wp.media.editor}
*/
this.insert( wp.media.gallery.shortcode( selection ).string() );
}, this );
workflow.state('playlist-edit').on( 'update', function( selection ) {
/**
- * @this wp.media.editor
+ * @this {wp.media.editor}
*/
this.insert( wp.media.playlist.shortcode( selection ).string() );
}, this );
workflow.state('video-playlist-edit').on( 'update', function( selection ) {
/**
- * @this wp.media.editor
+ * @this {wp.media.editor}
*/
this.insert( wp.media.playlist.shortcode( selection ).string() );
}, this );
workflow.state('embed').on( 'select', function() {
/**
- * @this wp.media.editor
+ * @this {wp.media.editor}
*/
var state = workflow.state(),
type = state.get('type'),
@@ -920,7 +920,7 @@
*
* @param {string} id A slug used to identify the workflow.
*
- * @this wp.media.editor
+ * @this {wp.media.editor}
*
* @return {wp.media.view.MediaFrame} A media workflow.
*/
@@ -933,7 +933,7 @@
*
* @param {string} id A slug used to identify the workflow.
*
- * @this wp.media.editor
+ * @this {wp.media.editor}
*/
remove: function( id ) {
id = this.id( id );
@@ -1020,7 +1020,7 @@
* @param {string} [id=undefined] Optional. A slug used to identify the workflow.
* @param {Object} [options={}] The options for the media workflow.
*
- * @this wp.media.editor
+ * @this {wp.media.editor}
*
* @return {wp.media.view.MediaFrame} A media workflow.
*/
diff --git a/wp-includes/js/media-grid.js b/wp-includes/js/media-grid.js
index 8fde6226f9..f3ff0655c1 100644
--- a/wp-includes/js/media-grid.js
+++ b/wp-includes/js/media-grid.js
@@ -987,7 +987,7 @@ Manage = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.Manage.prototype
*
* @param {Object} contentRegion Basic object with a `view` property, which
* should be set with the proper region view.
- * @this wp.media.controller.Region
+ * @this {wp.media.controller.Region}
*/
browseContent: function( contentRegion ) {
var state = this.state();
diff --git a/wp-includes/js/media-models.js b/wp-includes/js/media-models.js
index b885ea9830..14cf3ad1b6 100644
--- a/wp-includes/js/media-models.js
+++ b/wp-includes/js/media-models.js
@@ -124,7 +124,7 @@ Attachment = Backbone.Model.extend(/** @lends wp.media.model.Attachment.prototyp
* @param {Object} data The properties to be saved.
* @param {Object} options Sync options. e.g. patch, wait, success, error.
*
- * @this Backbone.Model
+ * @this {Backbone.Model}
*
* @return {jQuery.Promise} A jQuery Promise that is resolved or rejected based on the success of the sync operation.
*/
@@ -728,7 +728,7 @@ var Attachments = Backbone.Collection.extend(/** @lends wp.media.model.Attachmen
*
* @param {wp.media.model.Attachment} attachment The attachment to filter based on the search query.
*
- * @this wp.media.model.Attachments
+ * @this {wp.media.model.Attachments}
*
* @return {boolean} True if the attachment matches the search filter, false otherwise.
*/
@@ -748,7 +748,7 @@ var Attachments = Backbone.Collection.extend(/** @lends wp.media.model.Attachmen
* @static
* @param {wp.media.model.Attachment} attachment The attachment to filter based on its type.
*
- * @this wp.media.model.Attachments
+ * @this {wp.media.model.Attachments}
*
* @return {boolean} True if the attachment matches the type filter, false otherwise.
*/
@@ -777,7 +777,7 @@ var Attachments = Backbone.Collection.extend(/** @lends wp.media.model.Attachmen
* @static
* @param {wp.media.model.Attachment} attachment The attachment to filter based on its uploadedTo property.
*
- * @this wp.media.model.Attachments
+ * @this {wp.media.model.Attachments}
*
* @return {boolean} True if the attachment matches the uploadedTo filter, false otherwise.
*/
@@ -795,7 +795,7 @@ var Attachments = Backbone.Collection.extend(/** @lends wp.media.model.Attachmen
* @static
* @param {wp.media.model.Attachment} attachment The attachment to filter based on its status property.
*
- * @this wp.media.model.Attachments
+ * @this {wp.media.model.Attachments}
*
* @return {boolean} True if the attachment matches the status filter, false otherwise.
*/
@@ -1212,10 +1212,6 @@ Query = Attachments.extend(/** @lends wp.media.model.Query.prototype */{
* @return {wp.media.model.Query} A new Attachments Query collection.
*/
get: (function(){
- /**
- * @static
- * @type Array
- */
var queries = [];
/**
@@ -1344,11 +1340,9 @@ Selection = Attachments.extend(/** @lends wp.media.model.Selection.prototype */{
/**
* Fired when toggling (clicking on) an attachment in the modal.
*
- * @param {undefined|boolean|wp.media.model.Attachment} model The model to set as the single selection, or a boolean to clear it.
- *
- * @fires wp.media.model.Selection#selection:single
- * @fires wp.media.model.Selection#selection:unsingle
+ * Fires `selection:single` and `selection:unsingle` events on the model and collection.
*
+ * @param {undefined|boolean|wp.media.model.Attachment} model The model to set as the single selection, or a boolean to clear it.
* @return {Backbone.Model} The single model in the selection, or the last model as a fallback.
*/
single: function( model ) {
diff --git a/wp-includes/js/media-views.js b/wp-includes/js/media-views.js
index d45a07e6ce..0fc488bf0b 100644
--- a/wp-includes/js/media-views.js
+++ b/wp-includes/js/media-views.js
@@ -3877,10 +3877,9 @@ Details = Attachment.extend(/** @lends wp.media.view.Attachment.Details.prototyp
*
* This event can be used to make sure to move the focus correctly.
*
- * @since 4.0.0
+ * Fires `attachment:details:shift-tab` and `attachment:keydown:arrow` events on the controller.
*
- * @fires wp.media.controller.MediaLibrary#attachment:details:shift-tab
- * @fires wp.media.controller.MediaLibrary#attachment:keydown:arrow
+ * @since 4.0.0
*
* @param {KeyboardEvent} event A keyboard event.
*
@@ -4037,20 +4036,16 @@ Attachments = View.extend(/** @lends wp.media.view.Attachments.prototype */{
* The constructor binds events to the collection this view represents when
* adding or removing attachments or resetting the entire collection.
*
+ * Listens for `collection:add`, `collection:remove`, `collection:reset`,
+ * `controller:library:selection:add`, `scrollElement:scroll`, `this:ready`,
+ * and `controller:open` events.
+ *
* @since 3.5.0
*
* @constructs
* @memberof wp.media.view
*
* @augments wp.media.View
- *
- * @listens collection:add
- * @listens collection:remove
- * @listens collection:reset
- * @listens controller:library:selection:add
- * @listens scrollElement:scroll
- * @listens this:ready
- * @listens controller:open
*/
initialize: function() {
this.el.id = _.uniqueId('__attachments-view-');
@@ -4140,9 +4135,9 @@ Attachments = View.extend(/** @lends wp.media.view.Attachments.prototype */{
* Adjusts the amount of columns accordingly. First removes any existing event
* handlers to prevent duplicate listeners.
*
- * @since 4.0.0
+ * Listens for the `window:resize` event.
*
- * @listens window:resize
+ * @since 4.0.0
*
* @return {void}
*/
@@ -4288,9 +4283,9 @@ Attachments = View.extend(/** @lends wp.media.view.Attachments.prototype */{
* Fails gracefully if jQuery sortable doesn't exist or isn't passed
* in the options.
*
- * @since 3.5.0
+ * Fires `collection:reset`.
*
- * @fires collection:reset
+ * @since 3.5.0
*
* @return {void}
*/
@@ -6437,11 +6432,8 @@ var Frame = wp.media.View.extend(/** @lends wp.media.view.Frame.prototype */{
}
this.activeModes.remove( this.activeModes.where( { id: mode } ) );
this.$el.removeClass( 'mode-' + mode );
- /**
- * Frame mode deactivation event.
- *
- * @event wp.media.view.Frame#{mode}:deactivate
- */
+
+ // Fires a `#{mode}:deactivate` event on the frame.
this.trigger( mode + ':deactivate' );
return this;
@@ -7670,7 +7662,7 @@ Select = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.Select.prototype
*
* @param {Object} toolbar The toolbar object for the `select` mode.
* @param {Object} [options={}] The options for creating the select toolbar view.
- * @this wp.media.controller.Region
+ * @this {wp.media.controller.Region}
*/
createSelectToolbar: function( toolbar, options ) {
options = options || this.options.button || {};
@@ -8131,7 +8123,7 @@ MediaFrame = Frame.extend(/** @lends wp.media.view.MediaFrame.prototype */{
* Creates the title view.
*
* @param {Object} title The title object for creating the title view.
- * @this wp.media.controller.Region
+ * @this {wp.media.controller.Region}
*/
createTitle: function( title ) {
// A modal's dialog element points `aria-labelledby` at its frame heading.
@@ -8145,7 +8137,7 @@ MediaFrame = Frame.extend(/** @lends wp.media.view.MediaFrame.prototype */{
* Creates the menu view.
*
* @param {Object} menu The menu object for creating the menu view.
- * @this wp.media.controller.Region
+ * @this {wp.media.controller.Region}
*/
createMenu: function( menu ) {
menu.view = new wp.media.view.Menu({
@@ -8176,7 +8168,7 @@ MediaFrame = Frame.extend(/** @lends wp.media.view.MediaFrame.prototype */{
* Creates the toolbar view.
*
* @param {Object} toolbar The toolbar object for creating the toolbar view.
- * @this wp.media.controller.Region
+ * @this {wp.media.controller.Region}
*/
createToolbar: function( toolbar ) {
toolbar.view = new wp.media.view.Toolbar({
@@ -8187,7 +8179,7 @@ MediaFrame = Frame.extend(/** @lends wp.media.view.MediaFrame.prototype */{
* Creates the router view.
*
* @param {Object} router The router object for creating the router view.
- * @this wp.media.controller.Region
+ * @this {wp.media.controller.Region}
*/
createRouter: function( router ) {
router.view = new wp.media.view.Router({
@@ -8244,7 +8236,7 @@ MediaFrame = Frame.extend(/** @lends wp.media.view.MediaFrame.prototype */{
* Creates the iframe content view.
*
* @param {Object} content The content object for creating the iframe content view.
- * @this wp.media.controller.Region
+ * @this {wp.media.controller.Region}
*/
iframeContent: function( content ) {
this.$el.addClass('hide-toolbar');
diff --git a/wp-includes/js/wp-api.js b/wp-includes/js/wp-api.js
index c91558b20a..4584d0f8b1 100644
--- a/wp-includes/js/wp-api.js
+++ b/wp-includes/js/wp-api.js
@@ -60,7 +60,7 @@
* Determine model based on API route.
*
* @param {string} route The API route.
- * @return {Backbone Model} The model found at given route. Undefined if not found.
+ * @return {Backbone.Model|undefined} The model found at given route. Undefined if not found.
*/
wp.api.getModelByRoute = function( route ) {
return _.find( wp.api.models, function( model ) {
@@ -72,7 +72,7 @@
* Determine collection based on API route.
*
* @param {string} route The API route.
- * @return {Backbone Model} The collection found at given route. Undefined if not found.
+ * @return {Backbone.Collection|undefined} The collection found at given route. Undefined if not found.
*/
wp.api.getCollectionByRoute = function( route ) {
return _.find( wp.api.collections, function( collection ) {
@@ -311,7 +311,7 @@
/**
* Add mixins and helpers to models depending on their defaults.
*
- * @param {Backbone Model} model The model to attach helpers and mixins to.
+ * @param {Backbone.Model} model The model to attach helpers and mixins to.
* @param {string} modelClassName The classname of the constructed model.
* @param {Object} loadingObjects An object containing the models and collections we are building.
* @return {undefined} No return value.
@@ -868,9 +868,9 @@
/**
* Set nonce header before every Backbone sync.
*
- * @param {string} method The CRUD method ("create", "read", "update", or "delete") to be performed.
- * @param {Backbone.Model} model The model to be synced.
- * @param {{beforeSend}, *} options Additional options for the sync.
+ * @param {string} method The CRUD method ("create", "read", "update", or "delete") to be performed.
+ * @param {Backbone.Model} model The model to be synced.
+ * @param {Object} options Additional options for the sync.
* @return {*}.
*/
sync: function( method, model, options ) {
@@ -1033,7 +1033,7 @@
*
* @param {string} method The CRUD method ("create", "read", "update", or "delete") to be performed.
* @param {Backbone.Model} model The model to be synced.
- * @param {{success}, *} options Additional options for the sync.
+ * @param {Object} options Additional options for the sync.
* @return {*}.
*/
sync: function( method, model, options ) {
@@ -1108,8 +1108,9 @@
/**
* Fetches the next page of objects if a new page exists.
*
- * @param {data: {page}} options An object containing the page number to fetch. If not provided, the next page will be fetched.
- * @return {*}.
+ * @param {Object} [options] An object containing the page number to fetch. If not provided, the next page will be fetched.
+ * @param {number} [options.data.page] The page number to fetch.
+ * @return {JQuery.Promise} A promise that resolves when the fetch operation completes.
*/
more: function( options ) {
options = options || {};
diff --git a/wp-includes/js/wp-lists.js b/wp-includes/js/wp-lists.js
index deb1814bf9..43672c9a5a 100644
--- a/wp-includes/js/wp-lists.js
+++ b/wp-includes/js/wp-lists.js
@@ -812,31 +812,31 @@ wpList = {
/**
* Initializes wpList object.
*
- * @param {Object} settings The settings for the wpList instance.
- * @param {string} settings.url URL for ajax calls. Default: ajaxurl.
- * @param {string} settings.type The HTTP method to use for Ajax requests. Default: 'POST'.
- * @param {string} settings.response ID of the element the parsed ajax response will be stored in.
- * Default: 'ajax-response'.
+ * @param {Object} settings The settings for the wpList instance.
+ * @param {string} settings.url URL for ajax calls. Default: ajaxurl.
+ * @param {string} settings.type The HTTP method to use for Ajax requests. Default: 'POST'.
+ * @param {string} settings.response ID of the element the parsed ajax response will be stored in.
+ * Default: 'ajax-response'.
*
- * @param {string} settings.what Default: ''.
- * @param {string} settings.alt CSS class name for alternate styling. Default: 'alternate'.
- * @param {number} settings.altOffset Offset to start alternate styling from. Default: 0.
- * @param {string} settings.addColor Hex code or 'none' to disable animation. Default: '#ffff33'.
- * @param {string} settings.delColor Hex code or 'none' to disable animation. Default: '#faafaa'.
- * @param {string} settings.dimAddColor Hex code or 'none' to disable animation. Default: '#ffff33'.
- * @param {string} settings.dimDelColor Hex code or 'none' to disable animation. Default: '#ff3333'.
+ * @param {string} settings.what Default: ''.
+ * @param {string} settings.alt CSS class name for alternate styling. Default: 'alternate'.
+ * @param {number} settings.altOffset Offset to start alternate styling from. Default: 0.
+ * @param {string} settings.addColor Hex code or 'none' to disable animation. Default: '#ffff33'.
+ * @param {string} settings.delColor Hex code or 'none' to disable animation. Default: '#faafaa'.
+ * @param {string} settings.dimAddColor Hex code or 'none' to disable animation. Default: '#ffff33'.
+ * @param {string} settings.dimDelColor Hex code or 'none' to disable animation. Default: '#ff3333'.
*
- * @param {wpList~confirm} settings.confirm Callback that's run before a request is made. Default: null.
- * @param {wpList~addBefore} settings.addBefore Callback that's run before an item gets added to the list.
- * Default: null.
- * @param {wpList~addAfter} settings.addAfter Callback that's run after an item got added to the list.
- * Default: null.
- * @param {wpList~delBefore} settings.delBefore Callback that's run before an item gets deleted from the list.
- * Default: null.
- * @param {wpList~delAfter} settings.delAfter Callback that's run after an item got deleted from the list.
- * Default: null.
- * @param {wpList~dimBefore} settings.dimBefore Callback that's run before an item gets dim'd. Default: null.
- * @param {wpList~dimAfter} settings.dimAfter Callback that's run after an item got dim'd. Default: null.
+ * @param {Function} settings.confirm Callback that's run before a request is made. Default: null.
+ * @param {Function} settings.addBefore Callback that's run before an item gets added to the list.
+ * Default: null.
+ * @param {Function} settings.addAfter Callback that's run after an item got added to the list.
+ * Default: null.
+ * @param {Function} settings.delBefore Callback that's run before an item gets deleted from the list.
+ * Default: null.
+ * @param {Function} settings.delAfter Callback that's run after an item got deleted from the list.
+ * Default: null.
+ * @param {Function} settings.dimBefore Callback that's run before an item gets dim'd. Default: null.
+ * @param {Function} settings.dimAfter Callback that's run after an item got dim'd. Default: null.
* @return {$.fn} wpList API function.
*/
$.fn.wpList = function( settings ) {
diff --git a/wp-includes/version.php b/wp-includes/version.php
index a73bbc3b46..076fa84050 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63765';
+$wp_version = '7.2-alpha-63766';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.