feat(semantic/example): add detailed references info

[camc314]

While possible with the current example infra, it's hard to understand what exactly points where, by reading the ids, and comparing it vs the ast.
This change makes it incredibly easy to identify what symbol a refernce points to.

[camc314]

• feat(semantic/example): add detailed references info #17938 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codspeed-hq]

CodSpeed Performance Report

Merging this PR will not alter performance

_{Comparing c/01-12-feat_semantic_example_add_detailed_references_info (3a06805) with main (63e2737)¹}

Summary

✅ 42 untouched benchmarks
⏩ 3 skipped benchmarks²

Footnotes

1. No successful run was found on main (8d48bd7) during the generation of this report, so 63e2737 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

2. 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. ↩

[Copilot]

Pull request overview

This PR adds a new --symbol-references flag to the semantic analysis example that provides detailed visual diagnostics showing where each symbol is declared and how it's referenced throughout the code. This complements the existing --symbols flag by providing a more graphical, human-readable view of symbol usage using the diagnostic reporting infrastructure.

Changes:

• Added new CLI flag --symbol-references to display detailed reference information
• Integrated graphical diagnostic reporting to visualize symbol declarations and references
• Updated documentation to describe the new option

---

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

[Dunqing]

Very useful!

[Dunqing]

Merge activity

• Jan 13, 2:58 AM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Jan 13, 2:58 AM UTC: Dunqing added this pull request to the Graphite merge queue.
• Jan 13, 3:05 AM UTC: Merged by the Graphite merge queue.