jsdoc @example directive is broken: no syntax highlighting

[paulmillr]

Consider this JS/ts code:

/**
 * Creates new QRCamera from frontal camera
 * @example
 * const canvas = new QRCanvas();
 * const camera = frontalCamera();
 */
export async function frontalCamera(player: HTMLVideoElement): Promise<QRCamera>

Example directive is perfectly valid JS code, and has always been. However, JSR doesn't highlight it -- and even worse, doesn't even add line-breaks. JSR needs this:

@example
```js
const canvas = new QRCanvas();
const camera = frontalCamera();
```

It's unreasonable to require all jsdoc code example to be replaced by this flavored markdown just because you can't fix your code.

[crowlKats]

In our docs, we state that we support jsdoc-style comments and related standards. On the case of examples, we align more with TSDoc than JSDoc, since its much simpler and clearer than an ambiguous than having just free-lying code, especially since many of the examples also have some text in it.
We won't be changing this behaviour because besides being complex (and potentially expensive from a computation perspective since all jsdoc examples would need to tried to be parsed to see if they are valid code), it would potentially break existing examples.

[paulmillr]

it would potentially break existing examples

You already break ALL existing code which is not on JSR.

[paulmillr]

Also, tsdoc is not mentioned anywhere in your docs.