Svelte docs lack anchor tags for external links

[NandkishorJadoun]

Description:

There is a discrepancy in how external links are rendered between React and Svelte documentation pages.

The Issue:

• React Docs: Links are correctly wrapped in (anchor) elements, allowing users to click through to external resources.

• Svelte Docs: Links are returned as raw strings/plain text. They are not wrapped in anchor elements, which makes them unclickable and causes them to act as basic text within the v-html container.

[aqandrew]

@shuuji3 I believe this is a JSDoc issue in the Svelte repo. Can I pick this up?

[shuuji3]

@aqandrew Yes, it seems that's the case. I checked two jsdocs, and svelte one is not marked up.

• react@19.2.4 docs - npmx - https://npmx.dev/package-docs/react/v/19.2.4#function-useCallback
  • index.d.ts - @types/react@19.2.4 - npmx - https://npmx.dev/package-code/@types/react/v/19.2.4/index.d.ts#L1792-L1804
• svelte@5.49.1 docs - npmx - https://npmx.dev/package-docs/svelte/v/5.49.1#function-_bindable
  • types/index.d.ts - svelte@5.49.2 - npmx - https://npmx.dev/package-code/svelte/v/5.49.2/types/index.d.ts#L3578-L3587

But there's still a raw URL text in React docs too:

• react@19.2.4 docs - npmx - https://npmx.dev/package-docs/react/v/19.2.4#function-act
  • index.d.ts - @types/react@19.2.4 - npmx - https://npmx.dev/package-code/@types/react/v/19.2.4/index.d.ts#L1878-L1895

[aqandrew]

But there's still a raw URL text in React docs too:

• react@19.2.4 docs - npmx - https://npmx.dev/package-docs/react/v/19.2.4#function-act
  • index.d.ts - @types/react@19.2.4 - npmx - https://npmx.dev/package-code/@types/react/v/19.2.4/index.d.ts#L1878-L1895

Good catch. That act example only uses @see, but both @see and @link are needed to create a link (example). I've opened a PR for @types/react that addresses this