toggling between `JSDoc` and `TypeScript` examples in docs

Describe the problem

As someone who prefers to write TypeScript code, having all examples on the docs page annotated with JSDoc makes e.g copy & pasting annoying because I have to convert it manually to TypeScript syntax. For me, a person that knows both syntaxes well, this might be a small problem.

But I already saw a few people struggle because they were new to JSDoc comments and didn’t know how the equivalent should look in TypeScript code. Having a proper TypeScript example would help them a lot.

Describe the proposed solution

A toggle could be provided somewhere on the docs page that allows to globally choose between JSDoc and TypeScript

Similar to the Vue.js documentation that allows to toggle between API styles.

Alternatives considered

JSDoc only examples

Importance

nice to have

Additional Information

No response

[ivanhofer]

Definitely a good first step, but I can imagine a proper TypeScript example would improve the developer experience.

[danielniccoli]

For me, a person that knows both syntaxes well, this might be a small problem.

To give some input from a beginner in TypeScript and SvelteKit: It is immensely difficult to both, learn TypeScript and SvelteKit, when also having to translate the examples from JavaScript and JSDoc (which is something I haven’t heard before). Having all examples in the SK docs available in TypeScript would be immensely helpful!