refactor(graphqlsp): Add getDeclarationOfIdentifier helper

[kitten]

This mirrors the getDefinitionAtPosition method in TypeScript's language service — specifically the GoToDefinition component — to create a getDeclarationOfIdentifier helper.

Since we're only looking up definitions of identifiers, we can actually cut out a lot of special cases and end up with a relatively lean implementation of looking up declarations for identifiers. Specifically, if we were to switch over to an implementation like this, it would cut out a lot of extra wrappers, namely positional values that require is to look up file positions. It also saves us some look up work of cases that are impossible, since we're always jumping to declarations (fewer AST cases to account for)

Additionally, the returned AST node is a lot more limited in the locations it can be in, since it's guaranteed to only ever be a declaration.
To further help with this, a few modifications have been added to prevent us from jumping to type declarations, ambient declarations, and import/export/module specifiers (Although that's an artificial limitation)

The helpers also include:

• types to clarify which nodes can be reached
• a utility to return the actual values of declarations
• a resolver that gets the value of a declaration and keeps resolving if it's an identifier again

[changeset-bot]

⚠️ No Changeset found

Latest commit: 5b0de48

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR