Commit b629ab5aa8 for wordpress.org
commit b629ab5aa895818abe39d1a517d7ddfa4d8a61ca
Author: afercia <afercia@git.wordpress.org>
Date: Mon Sep 21 17:29:48 2026 +0000
General: Enable the JSDoc rules related to the property tag.
Enables the following JSDoc rules:
- `jsdoc/check-property-names`
- `jsdoc/require-property`
- `jsdoc/require-property-name`
- `jsdoc/require-property-description`
- `jsdoc/require-property-type`
Fixes all the related violations.
Part of the effort to improve JS inline documentation for 7.2.
Developed in https://github.com/WordPress/wordpress-develop/pull/13632
See #66033.
Built from https://develop.svn.wordpress.org/trunk@63775
git-svn-id: http://core.svn.wordpress.org/trunk@62947 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-admin/js/updates.js b/wp-admin/js/updates.js
index 635a32975d..59d0ef2e6b 100644
--- a/wp-admin/js/updates.js
+++ b/wp-admin/js/updates.js
@@ -167,6 +167,7 @@
* @since 4.6.0 Added `available` property to indicate whether credentials have been provided.
*
* @type {Object}
+ * @property {Object} filesystemCredentials Holds all filesystem credentials.
* @property {Object} filesystemCredentials.ftp Holds FTP credentials.
* @property {string} filesystemCredentials.ftp.host FTP host. Default empty string.
* @property {string} filesystemCredentials.ftp.username FTP user name. Default empty string.
@@ -3304,7 +3305,10 @@
// Called from `wp-admin/includes/class-wp-upgrader-skins.php`.
case 'decrementUpdateCount':
- /** @property {string} message.upgradeType */
+ /**
+ * @property {string} message The message associated with the update.
+ * @property {string} message.upgradeType The type of upgrade being performed.
+ */
wp.updates.decrementCount( message.upgradeType );
break;
diff --git a/wp-includes/js/media-views.js b/wp-includes/js/media-views.js
index 0fc488bf0b..877feb92b0 100644
--- a/wp-includes/js/media-views.js
+++ b/wp-includes/js/media-views.js
@@ -1764,7 +1764,7 @@ _.extend( Region.prototype,/** @lends wp.media.controller.Region.prototype */{
*
* @event wp.media.controller.Region#create
* @type {Object}
- * @property {Object} view
+ * @property {Object} view The view object for the region.
*/
this.trigger( 'create', set );
view = set.view;
diff --git a/wp-includes/js/wp-emoji-loader.js b/wp-includes/js/wp-emoji-loader.js
index 066db8eadb..4397a72eaf 100644
--- a/wp-includes/js/wp-emoji-loader.js
+++ b/wp-includes/js/wp-emoji-loader.js
@@ -8,10 +8,10 @@
* Emoji Settings as exported in PHP via _print_emoji_detection_script().
* @typedef WPEmojiSettings
* @type {Object}
- * @property {?object} source
- * @property {?string} source.concatemoji
- * @property {?string} source.twemoji
- * @property {?string} source.wpemoji
+ * @property {?object} source The source object containing emoji-related URLs.
+ * @property {?string} source.concatemoji The URL for the concatenated emoji script.
+ * @property {?string} source.twemoji The URL for the Twemoji script.
+ * @property {?string} source.wpemoji The URL for the WP Emoji script.
*/
const selector = 'script#wp-emoji-settings';
@@ -28,8 +28,8 @@ window._wpemojiSettings = settings;
* Support tests.
* @typedef SupportTests
* @type {Object}
- * @property {?boolean} flag
- * @property {?boolean} emoji
+ * @property {?boolean} flag Whether the browser supports flag emojis.
+ * @property {?boolean} emoji Whether the browser supports general emojis.
*/
const sessionStorageKey = 'wpEmojiSettingsSupports';
@@ -57,8 +57,8 @@ function supportsWorkerOffloading() {
/**
* @typedef SessionSupportTests
* @type {Object}
- * @property {number} timestamp
- * @property {SupportTests} supportTests
+ * @property {number} timestamp The timestamp when the support tests were last updated.
+ * @property {SupportTests} supportTests The support tests for the browser.
*/
/**
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 8b234af7e1..0299870eac 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63774';
+$wp_version = '7.2-alpha-63775';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.