docs(semantic): document with statement limitation in is_global_reference

[Boshen]

Summary

Documents the limitation that is_global_reference does not correctly handle references inside with statements, as discussed in #8365.

The documentation explains:

• The limitation where is_global_reference incorrectly returns true for references inside with blocks
• A code example illustrating the issue
• Why this limitation is acceptable (strict mode forbids with, bundlers don't support it, minifier bails out)

Closes #8365

Test plan

• Documentation only change, no functional changes

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This pull request adds documentation to the is_global_reference function to explain a known limitation with with statements. The documentation clarifies that the function incorrectly returns true for references inside with blocks that may actually resolve to properties of the with object at runtime.

Changes:

• Fixed grammar: "a identifier" → "an identifier"
• Added comprehensive documentation section explaining the with statement limitation
• Included a code example demonstrating the issue
• Provided justification for why this limitation is acceptable

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codspeed-hq]

CodSpeed Performance Report

Merging this PR will not alter performance

_{Comparing docs/is-global-reference-with-statement (17523eb) with main (e7631dd)}

Summary

✅ 42 untouched benchmarks
⏩ 3 skipped benchmarks¹

Footnotes

1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩