TypeScript 4.5 enables @template [T=string]

[voxpelli]

TypeScript 4.5, which currently has a release candidate, includes an exciting new feature for JSDoc users:

Defaults for template tags (microsoft/TypeScript#45483): @template [T=string]

I found this through microsoft/TypeScript#29401 when looking for a way to void T defaulting to any when no value was given in this code:

/** @template [T=undefined] */
class ErrorWithCause extends Error {
  /**
   * @param {string} message
   * @param {{ cause?: T }} [options]
   */
  constructor (message, { cause } = {}) {
    if (cause) {
      /** @type {T} */
      this.cause = cause;
    }
    // ...
  }
}

Now it gets set to undefined when no value is provied and my type-coverage got closer to 100%.

And it properly compiles to:

export class ErrorWithCause<T = undefined> extends Error {
    constructor(message: string, { cause }?: {
        cause?: T;
    } | undefined);
    cause: T;
}

I will push this new code to my pony-cause module very soon, just wanted to write this up first 🥳

[voxpelli]

Now I have released this specific use case of mine as part of [email protected]

[voxpelli]

Direct link to the change: voxpelli/pony-cause@8eb3d69