[PROPOSAL] Support @augments/@extends attached to an Object types

Search Terms

jsdoc extends object

Suggestion

Support @augments/@extends attached to an Object types.

Actually, *Storm IDEs are following it, on intellisense but tsc complains by

JSDoc '@augments' is not attached to a class.

Use Cases

Provide a way to type the derivating (merged) result of any objects to a single one.

Examples

    /**
     * @typedef Obj
     * @type {Object}
     */
    
    /**
     * @typedef Properties
     * @type {Object}
     */
    
    /**
     * @typedef Return
     * @type {Object}
     * @augments Obj
     * @augments Properties
     */
    
    /**
     * @type {Obj} obj
     */
    const obj = {
      /**
       * @param {Properties} [properties]
       * @returns {Return}
       */
      derivate ({ ...properties } = {}) {
        return { ...this, ...properties }
      }
    }

Checklist

My suggestion meets these guidelines:

• This wouldn't be a breaking change in existing TypeScript/JavaScript code

• This wouldn't change the runtime behavior of existing JavaScript code

• This could be implemented without emitting different JS based on the types of the expressions

• This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, etc.)

• This feature would agree with the rest of TypeScript's Design Goals.

No se nombran archivos fuente ni pruebas. Empieza reproduciendo el ejemplo de JavaScript proporcionado con tsc y siguiendo cómo se gestionan JSDoc @augments/@extends para typedefs; se considera terminado cuando los object typedefs aceptan estas etiquetas sin el diagnóstico indicado y producen el tipo combinado previsto.