Prioritise + Filter completion candidates based on explicit dependencies

[charjr]

Description

Word of appreciation

First off, wonderful work. Thank you. This is not a request specific to this library, I have not found any LSP or IDE (even PHPStorm) that implements this feature.

Enhancement Request

When using autocomplete, say for a class called RuntimeException I would love candidates to be prioritised like so:

1. Classes within your own code, i.e. MyLibrary\Exceptions\RuntimeException
2. core/php types, in this case \RuntimeException
3. 3rd party libraries, explicitly required in composer.json

It should never offer candidates from libraries that you don't explicitly depend on.

Use case

When working on my own library:

1. I begin typing throw new \RuntimeE and then request autocompletion.
2. The first candidate is Symfony\Component\Yaml\Exception\RuntimeException

• I have not listed symfony/yaml as a dependency, it is required, indirectly by another dependency. I should never see this offered.

This has two benefits:

1. It offers candidates that are more likely to be what users want
2. It promotes good practice:
   a. "Why isn't Symfony\Component\Yaml completing?"
   b. "Have you listed it in your dependencies?"
   c. "No"
   d. "If you're using it, then you depend on it. List it in your dependencies and it will work."

Proposed solution

^ See description

Alternatives considered

I could filter candidates locally, but that would be editor-specific and I'd have to duplicate PHP-aware code to do so.

Code example

Type in throw new \Runtim on any project where vendor/ contains a custom runtime exception that you don't explicitly depend on.