chore(deps-dev): bump eslint-plugin-jsdoc from 60.4.1 to 60.7.0 (#11394)

* chore(deps-dev): bump eslint-plugin-jsdoc from 60.4.1 to 60.7.0

Bumps [eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc) from 60.4.1 to 60.7.0.
- [Release notes](https://github.com/gajus/eslint-plugin-jsdoc/releases)
- [Changelog](https://github.com/gajus/eslint-plugin-jsdoc/blob/main/.releaserc)
- [Commits](gajus/eslint-plugin-jsdoc@v60.4.1...v60.7.0)

---
updated-dependencies:
- dependency-name: eslint-plugin-jsdoc
  dependency-version: 60.7.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>

* fix(lint): remove module filepath for same file - replace with import() for external module file

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: jNullj <[email protected]>

Author: dependabot[bot]

badge-maker/lib/xml.js

@@ -31,7 +31,7 @@ export class XmlElement {
    * @param {object} attrs Refer to individual attrs
    * @param {string} attrs.name
    *    Name of the XML tag
-   * @param {Array.<string|module:badge-maker/lib/xml~XmlElement>} [attrs.content=[]]
+   * @param {Array.<string|XmlElement>} [attrs.content=[]]
    *    Array of objects to render inside the tag. content may contain a mix of
    *    string and XmlElement objects. If content is `[]` or omitted the
    *    element will be rendered as a self-closing element.

core/base-service/base.js

@@ -91,7 +91,7 @@ class BaseService {
    * Route to mount this service on
    *
    * @abstract
-   * @type {module:core/base-service/base~Route}
+   * @type {Route}
    */
   static get route() {
     throw new Error(`Route not defined for ${this.name}`)
@@ -133,7 +133,7 @@ class BaseService {
    * this._request(this.authHelper.withBasicAuth({ url, schema, options }))
    *
    * @abstract
-   * @type {module:core/base-service/base~Auth}
+   * @type {Auth}
    */
   static auth = undefined
 
@@ -143,7 +143,7 @@ class BaseService {
    *
    * @abstract
    * @see https://swagger.io/specification/#paths-object
-   * @type {module:core/base-service/service-definitions~openApiSchema}
+   * @type {import('./service-definitions').openApiSchema}
    */
   static openApi = {}
 
@@ -171,7 +171,7 @@ class BaseService {
    * These defaults are used if the value is neither included in the service data
    * from the handler nor overridden by the user via query parameters.
    *
-   * @type {module:core/base-service/base~DefaultBadgeData}
+   * @type {DefaultBadgeData}
    */
   static defaultBadgeData = {}
 
@@ -320,7 +320,7 @@ class BaseService {
    * @param {object} namedParams Params parsed from route pattern
    *    defined in this.route.pattern or this.route.capture
    * @param {object} queryParams Params parsed from the query string
-   * @returns {module:core/base-service/base~Badge}
+   * @returns {Badge}
    *    badge Object validated against serviceDataSchema
    */
   async handle(namedParams, queryParams) {

core/base-service/errors.js

@@ -32,7 +32,7 @@ class ShieldsRuntimeError extends Error {
   }
 
   /**
-   * @param {module:core/base-service/errors~RuntimeErrorProps} props
+   * @param {RuntimeErrorProps} props
    * Refer to individual attrs
    * @param {string} message Exception message for debug purposes
    */
@@ -61,7 +61,7 @@ class NotFound extends ShieldsRuntimeError {
   }
 
   /**
-   * @param {module:core/base-service/errors~RuntimeErrorProps} props
+   * @param {RuntimeErrorProps} props
    * Refer to individual attrs
    */
   constructor(props = {}) {
@@ -88,7 +88,7 @@ class InvalidResponse extends ShieldsRuntimeError {
   }
 
   /**
-   * @param {module:core/base-service/errors~RuntimeErrorProps} props
+   * @param {RuntimeErrorProps} props
    * Refer to individual attrs
    */
   constructor(props = {}) {
@@ -114,7 +114,7 @@ class Inaccessible extends ShieldsRuntimeError {
   }
 
   /**
-   * @param {module:core/base-service/errors~RuntimeErrorProps} props
+   * @param {RuntimeErrorProps} props
    * Refer to individual attrs
    */
   constructor(props = {}) {
@@ -139,7 +139,7 @@ class ImproperlyConfigured extends ShieldsRuntimeError {
   }
 
   /**
-   * @param {module:core/base-service/errors~RuntimeErrorProps} props
+   * @param {RuntimeErrorProps} props
    * Refer to individual attrs
    */
   constructor(props = {}) {
@@ -165,7 +165,7 @@ class InvalidParameter extends ShieldsRuntimeError {
   }
 
   /**
-   * @param {module:core/base-service/errors~RuntimeErrorProps} props
+   * @param {RuntimeErrorProps} props
    * Refer to individual attrs
    */
   constructor(props = {}) {
@@ -190,7 +190,7 @@ class Deprecated extends ShieldsRuntimeError {
   }
 
   /**
-   * @param {module:core/base-service/errors~RuntimeErrorProps} props
+   * @param {RuntimeErrorProps} props
    * Refer to individual attrs
    */
   constructor(props) {

core/base-service/openapi.js

@@ -223,8 +223,8 @@ function category2openapi({ category, services, sort = false }) {
 /**
  * Helper function for assembling an OpenAPI path parameter object
  *
- * @param {module:core/base-service/openapi~PathParamInput} param Input param
- * @returns {module:core/base-service/openapi~OpenApiParam} OpenAPI Parameter Object
+ * @param {PathParamInput} param Input param
+ * @returns {OpenApiParam} OpenAPI Parameter Object
  * @see https://swagger.io/specification/#parameter-object
  */
 function pathParam({
@@ -253,9 +253,9 @@ function pathParam({
  * ]
  * ```
  *
- * @param {...module:core/base-service/openapi~PathParamInput} params Input params
- * @returns {Array.<module:core/base-service/openapi~OpenApiParam>} Array of OpenAPI Parameter Objects
- * @see {@link module:core/base-service/openapi~pathParam}
+ * @param {...PathParamInput} params Input params
+ * @returns {Array.<OpenApiParam>} Array of OpenAPI Parameter Objects
+ * @see {@link pathParam}
  */
 function pathParams(...params) {
   return params.map(param => pathParam(param))
@@ -264,8 +264,8 @@ function pathParams(...params) {
 /**
  * Helper function for assembling an OpenAPI query parameter object
  *
- * @param {module:core/base-service/openapi~QueryParamInput} param Input param
- * @returns {module:core/base-service/openapi~OpenApiParam} OpenAPI Parameter Object
+ * @param {QueryParamInput} param Input param
+ * @returns {OpenApiParam} OpenAPI Parameter Object
  * @see https://swagger.io/specification/#parameter-object
  */
 function queryParam({
@@ -299,9 +299,9 @@ function queryParam({
  * ]
  * ```
  *
- * @param {...module:core/base-service/openapi~QueryParamInput} params Input params
- * @returns {Array.<module:core/base-service/openapi~OpenApiParam>} Array of OpenAPI Parameter Objects
- * @see {@link module:core/base-service/openapi~queryParam}
+ * @param {...QueryParamInput} params Input params
+ * @returns {Array.<OpenApiParam>} Array of OpenAPI Parameter Objects
+ * @see {@link queryParam}
  */
 function queryParams(...params) {
   return params.map(param => queryParam(param))

core/service-test-runner/create-service-tester.js

@@ -15,7 +15,7 @@ import ServiceTester from './service-tester.js'
  * This can't be used for `.service.js` files which export more than one
  * service.
  *
- * @returns {module:core/service-test-runner/service-tester~ServiceTester}
+ * @returns {ServiceTester}
  *    ServiceTester instance
  */
 async function createServiceTester() {

core/service-test-runner/service-tester.js

@@ -46,7 +46,7 @@ class ServiceTester {
    *
    * @param {Function} ServiceClass
    *    A class that extends base-service/base.BaseService
-   * @returns {module:core/service-test-runner/service-tester~ServiceTester}
+   * @returns {ServiceTester}
    *    ServiceTester for ServiceClass
    */
   static forServiceClass(ServiceClass) {

core/token-pooling/token-pool.js

@@ -195,9 +195,9 @@ class TokenPool {
   /**
    * compareTokens
    *
-   * @param {module:core/token-pooling/token-pool~Token} first first token to compare
-   * @param {module:core/token-pooling/token-pool~Token} second second token to compare
-   * @returns {module:core/token-pooling/token-pool~Token} The token whose current rate allotment is expiring soonest.
+   * @param {Token} first first token to compare
+   * @param {Token} second second token to compare
+   * @returns {Token} The token whose current rate allotment is expiring soonest.
    */
   static compareTokens(first, second) {
     return second.nextReset - first.nextReset
@@ -295,7 +295,7 @@ class TokenPool {
    * new use-remaining count and next-reset time. Invoke `invalidate()` to
    * indicate it should not be reused.
    *
-   * @returns {module:core/token-pooling/token-pool~Token} token
+   * @returns {Token} token
    */
   next() {
     let token = this.currentBatch.token

package-lock.json

@@ -173,7 +173,7 @@
     "eslint-plugin-cypress": "5.1.1",
     "eslint-plugin-icedfrisby": "0.2.0",
     "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-jsdoc": "60.4.1",
+    "eslint-plugin-jsdoc": "60.7.0",
     "eslint-plugin-mocha": "11.1.0",
     "eslint-plugin-prettier": "5.5.4",
     "eslint-plugin-promise": "7.2.1",

package.json

@@ -25,7 +25,7 @@ const queryParamSchema = Joi.object({
  * up_message, down_message, up_color and down_color
  * query params
  *
- * @type {Array.<module:core/base-service/openapi~OpenApiParam>}
+ * @type {Array.<import('../base-service/openapi').OpenApiParam>}
  */
 const queryParams = qP(
   { name: 'up_message', example: 'online' },