Improved the order of completions provided for resource access paths

[nipunayf]

Purpose

When multiple resource access methods share the same sortText, the VS Code plugin sorts them alphabetically, thus dividing completions with named and computed resource segments into two sets. This arrangement reduces the developer experience, with computed resource segments moved to the bottom.

Fixes #41636

Approach

The current approach assigns a unique sortText to each completion item based on the position generated by the LS, ensuring that the order is not disrupted by the VS Code plugin.

Samples

Grouped completions with both named resource segments and computed resource segments are now as shown below.

Check List

• Read the Contributing Guide
• Updated Change Log
• Checked Tooling Support (#)
• Added necessary tests
  • Unit Tests
  • Spec Conformance Tests
  • Integration Tests
  • Ballerina By Example Tests
• Increased Test Coverage
• Added necessary documentation
  • API documentation
  • Module documentation in Module.md files
  • Ballerina By Examples

[codecov]

Codecov Report

Attention: 4 lines in your changes are missing coverage. Please review.

Comparison is base (a33bee3) 76.70% compared to head (09e995d) 76.73%.
Report is 8 commits behind head on master.

Files	Patch %	Lines
...oviders/context/InvocationNodeContextProvider.java	94.11%	1 Missing and 1 partial ⚠️
...ompletions/builder/ResourcePathCompletionUtil.java	50.00%	0 Missing and 1 partial ⚠️
...context/ClientResourceAccessActionNodeContext.java	94.11%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master   #41663      +/-   ##
============================================
+ Coverage     76.70%   76.73%   +0.03%     
- Complexity    52716    52724       +8     
============================================
  Files          2878     2878              
  Lines        198708   198735      +27     
  Branches      25825    25832       +7     
============================================
+ Hits         152410   152501      +91     
+ Misses        37882    37804      -78     
- Partials       8416     8430      +14     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.