[PR] Feature/netbeans 8230 reference count hints [netbeans]

["harshaindunil (via GitHub)" <gi...@apache.org>]

harshaindunil opened a new pull request, #9366:
URL: https://github.com/apache/netbeans/pull/9366

   ## Summary
   
   Implements a Java-editor-only reference count hint feature for methods and named types.
   
   The editor shows an above-line reference count, opens a lightweight popup on click, and still allows opening the existing full Find Usages UI.
   
   This is the initial Swing Java editor integration only. It does not attempt LSP or non-Java editor support.
   
   Fixes #8230.
   
   ## Main changes
   
   - add Java reference count hint computation and publishing in `java.editor`
   - add above-line block hint rendering support in `editor.lib2`
   - add a completion-style usages popup from the hint click action
   - reuse Java Where Used / Find Usages semantics for counts and navigation
   - add Java inline-hints options for enabling reference counts
   - add tests around direct reference counting and `TreePathHandle` resolution fallback
   
   ## Performance / behavior notes
   
   - counts are computed in background tasks
   - counts are limited to visible declarations and refreshed as the viewport changes
   - cached values are reused instead of clearing the full file on every index event
   - existing hints remain visible while recomputation is deferred during scanning
   - split editors for the same document are handled correctly
   
   ## Validation
   
   Manual validation in the built IDE:
   
   - Java editor rendering of above-line hints
   - click opens the reference popup
   - popup can open full Find Usages
   - dark theme rendering
   - split editor behavior
   - scrolling / viewport refresh behavior
   - indexing refresh behavior
   
   I also rebuilt the affected modules and the IDE image during development.
   
   ## Follow-up scope intentionally excluded
   
   - LSP / generic editor integration
   - non-Java languages
   - an alternative lazy, non-inline usage action mode
   
   
   ---
   
   <details open>
   <summary>Click to collapse/expand PR instructions</summary>
   
   By opening a pull request you confirm that, unless explicitly stated otherwise, the changes -
   
    - are all your own work, and you have the right to contribute them.
    - are contributed solely under the terms and conditions of the Apache License 2.0 (see section 5 of the license for more information).
   
   Please make sure (eg. `git log`) that all commits have a valid name and email address for you in the Author field.
   
   If you're a first time contributor, see the Contributing guidelines for more information.
   
   If you're a committer, please label the PR before pressing "Create pull request" so that the right test jobs can run.
   
   ### PR approval and merge checklist:
   
   1. [ ] Was this PR [correctly labeled](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=240884239#PRsandYouAreviewerGuide-PRtriggeredCIJobs(conditionalCIpipeline)), did the right tests run? When did they run?
   2. [ ] Is this PR [squashed](https://cwiki.apache.org/confluence/display/NETBEANS/git%3A+squash+and+merge)?
   3. [ ] Are author name / email address correct? Are [co-authors](https://docs.github.com/en/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors#creating-co-authored-commits-on-the-command-line) correctly listed? Do the commit messages need updates?
   3. [ ] Does the PR title and description still fit after the Nth iteration? Is the description sufficient to appear in the release notes?
   
   If this PR targets the delivery branch: [don't merge](https://cwiki.apache.org/confluence/display/NETBEANS/Pull+requests+for+delivery). ([full wiki article](https://cwiki.apache.org/confluence/display/NETBEANS/PRs+and+You+-+A+reviewer+Guide))
   
   </details>


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org

For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists