refactor: Improve type inference performance of hot-path that computes fragment spreads

[kitten]

Summary

This aggressively optimises getFragmentsOfDocuments (previously named getFragmentsOfDocumentsRec).

In a typical codebase that uses fragment composition properly, there's only so many documents that are in any given hot-path of TypeScript's type checker on evaluation. While we're constrained by wanting to output the resulting TadaDocumentNode and its result shape — i.e. not wanting TypeScript to evaluate documents lazily on type hint output — the getFragmentsOfDocumentsRec was having a larger impact on performance than expected.

When applied, this PR refactors how fragments are recognised and how we convert the array of fragments, passed to graphql(), to a dictionary object.

Set of changes

• Add FragmentShape and rename makeDefinitionDecoration to DefinitionDecoration
• Remove result constraints from DocumentDecoration
• Apply FragmentShape to API functions to pre-constrain their types
• Refactor getFragmentsOfDocuments to be a non-recursive type

[changeset-bot]

🦋 Changeset detected

Latest commit: a7f1882

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

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