lib: add lint rules for reflective function calls

PR-URL: #60825
Reviewed-By: Chengzhong Wu <legendecas@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Chemi Atlow <chemi@atlow.co.il>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Jordan Harband <ljharb@gmail.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>

Author: targos

lib/fs.js

@@ -1118,11 +1118,7 @@ function lazyLoadRimraf() {
 /**
  * Asynchronously removes a directory.
  * @param {string | Buffer | URL} path
- * @param {{
- *   maxRetries?: number;
- *   recursive?: boolean;
- *   retryDelay?: number;
- *   }} [options]
+ * @param {object} [options]
  * @param {(err?: Error) => any} callback
  * @returns {void}
  */
@@ -1166,11 +1162,7 @@ function rmdir(path, options, callback) {
 /**
  * Synchronously removes a directory.
  * @param {string | Buffer | URL} path
- * @param {{
- *   maxRetries?: number;
- *   recursive?: boolean;
- *   retryDelay?: number;
- *   }} [options]
+ * @param {object} [options]
  * @returns {void}
  */
 function rmdirSync(path, options) {

lib/internal/quic/quic.js

@@ -896,7 +896,7 @@ class QuicSession {
   #onstream = undefined;
   /** @type {OnDatagramCallback|undefined} */
   #ondatagram = undefined;
-  /** @type {{}} */
+  /** @type {object|undefined} */
   #sessionticket = undefined;
 
   /**
@@ -927,7 +927,10 @@ class QuicSession {
     return this.#handle === undefined || this.#isPendingClose;
   }
 
-  /** @type {any} */
+  /**
+   * Get the session ticket associated with this session, if any.
+   * @type {object|undefined}
+   */
   get sessionticket() { return this.#sessionticket; }
 
   /** @type {OnStreamCallback} */
@@ -1665,7 +1668,7 @@ class QuicEndpoint {
 
   /**
    * Initiates a session with a remote endpoint.
-   * @param {{}} address
+   * @param {object} address
    * @param {SessionOptions} [options]
    * @returns {QuicSession}
    */

lib/internal/webstreams/adapters.js

@@ -867,8 +867,7 @@ function newStreamDuplexFromReadableWritablePair(pair = kEmptyObject, options =
 
 /**
  * @typedef {import('./queuingstrategies').QueuingStrategy} QueuingStrategy
- * @typedef {{}} StreamBase
- * @param {StreamBase} streamBase
+ * @param {object} streamBase
  * @param {QueuingStrategy} strategy
  * @returns {WritableStream}
  */

test/common/heap.js

@@ -327,7 +327,7 @@ function getHeapSnapshotOptionTests() {
 }
 
 /**
- * Similar to @see {validateByRetainingPathFromNodes} but creates the snapshot from scratch.
+ * Similar to {@link validateByRetainingPathFromNodes} but creates the snapshot from scratch.
  * @returns {object[]}
  */
 function validateByRetainingPath(...args) {