TypeScript class method decorator not rendering properly in version >= 1.63.2

[dreamorosi]

Does this issue occur when all extensions are disabled?: Yes

• VS Code Version: 1.63.2
• OS Version: Darwin x64 20.6.0

Steps to Reproduce:

1. Write a JSDoc string with an example that involves a decorator:

class MyClass {
   /**
   * This is an example of a decorator.
   * 
   * @example
   * ```typescript
   * import { MyClass } from '@org/myClass';
   * 
   * const myClass = new MyClass();
   * 
   * class MyAwesomeClass {
   *   @myClass.decorateMethod()
   *   public doStuff() {
   *     ...
   *   }
   * }
   * 
   * ```
   * 
   * @decorator Class
   */
   public decorateMethod(): MyType {
     return (target, _propertyKey, descriptor) => {
       const originalMethod = descriptor.value;

       descriptor.value = ((event, context, callback) => {
         return originalMethod?.apply(target, [ event, context, callback ]);
       });

       return descriptor;
     };
   }
}

2. Use decorator / hover on method declaration:

As you can see from the screenshot above the example appears not to be rendered correctly with two main issues:

• Decorator is rendered on a new line & wrapped with *
• All code indentation after the decorator is lost

Before opening this issue I've searched the repo (& the TypeScript one) and found a series of other issues. Most of them have been closed as duplicates or as fixed but as the above shows the issue is still there. Examples:

• @example breaks when example includes @ character (org package imports) #39371
• Improper @example parsing when an at-sign @ is used in the code-block. #38922
• Decorators rendered incorrectly in docs codeblock preview vscode#119218
• At starts jsdoc tag only after whitespace #42364

If the issue has been indeed fixed, could you please take a second to clarify what's the intended usage to allow VS Code to render decorators correctly? I'm aware that decorators are an experimental feature, if that's the reason why this is not supported could you please state it?

Thanks in advance.

[mjbvz]

Looks like a duplicate of #35310 but let's wait for feedback from the TS team

[dreamorosi]

None of the workarounds suggested in that issue work as it's also reported by other users in that same issue.

It was marked as "work as intended", does it mean that decorators are not supposed to be rendered correctly?

[dreamorosi]

Since this was rescheduled/left out of the last two iterations, is there any chance that this can be added to the TypeScript 4.9.0 one?

[sandersn]

Looking at the parser, the problem is that backticks don't persist across lines, even triple backticks.

[sandersn]

A naive change to stop resetting the backtick parsing does stop treating @myClass as a tag, but also stops maintaining the indent margin and skipping leading asterisks. That needs to be maintained, even when parsing backtick-quoted text.