docs(lib): add @throws JSDoc for JSON methods

[Joseph-Martre]

Adds @throws JSDoc documentation to JSON.parse and JSON.stringify to clarify their potential error behavior.
This helps developers better understand the runtime exceptions these methods may produce, and improves IDE support/documentation.

Related to #43528

Alignment with TypeScript Design Goals:

• (2) Provide a structuring mechanism for larger pieces of code.
• (10) Be a cross-platform development tool.

Test Criteria

This PR only introduces documentation changes in .d.ts files.
It does not affect runtime behavior or type system behavior, and therefore does not require test cases.

Would like feedback on whether this direction makes sense for error documentation in the TypeScript repo.

[typescript-bot]

This PR doesn't have any linked issues. Please open an issue that references this PR. From there we can discuss and prioritise.

[Joseph-Martre]

This PR doesn't have any linked issues. Please open an issue that references this PR. From there we can discuss and prioritise.

Related to #43528

[sandersn]

One small wording suggestion for your consideration.

I think having more information is better in jsdoc, although I should point out that we are headed towards less checking of @throws in TS7, not more. This would be for human readers only.

[Joseph-Martre]

I think having more information is better in jsdoc, although I should point out that we are headed towards less checking of @throws in TS7, not more. This would be for human readers only.

Yes, this isn't intended as a step toward compile-time checking of thrown values. The goal is to provide clearer information in the IDE about which methods can throw, and what they can throw. This should help developers write more robust software with better error handling.

[Joseph-Martre]

Updated the JSDoc of the second stringify method to match the suggested change in the first. (The doc tag is duplicated because the method is overloaded.)

[ethanresnick]

I should point out that we are headed towards less checking of @throws in TS7, not more.

@sandersn I'm just curious what this means, since I wasn't aware that today's TS did any checking of @throws. What am I missing, and what's being removed?

[sandersn]

TS5 parses @throws as JSDocThrowsTag in the tree. TS7 parses @throws as JSDocUnknownTag. It didn't make sense to have a distinct node for it since there was never any semantic support for it.