fix(document-builder): avoid "Excessive stack depth comparing types" (#1307)

Author: jasonkuhrt

eslint.config.js

@@ -12,6 +12,7 @@ export default tsEslint.config({
     'vitest*.config.ts',
     '**/generated/**/*',
     'tests/_/schemas/*/graffle/**/*',
+    'tests/e2e/github/graffle/**/*',
     '**/tests/fixture/graffle/**/*',
     'src/layers/1_Schema/Hybrid/types/Scalar/Scalar.ts', // There is an ESLint error that goes away when ignored leading to a circular issue of either lint error or unused lint disable.
     '**/$/**/*',

examples/$/graffle/modules/methods-document.ts

@@ -1,10 +1,16 @@
 import type * as $$Utilities from 'graffle/utilities-for-generated'
-import * as $$Schema from './schema.js'
-import * as $$SelectionSets from './selection-sets.js'
+import type * as $$Schema from './schema.js'
+import type * as $$SelectionSets from './selection-sets.js'
 
-export interface Document<$Context extends $$Utilities.Context> {
+export interface Document<$Context> {
   <$Document>(
-    document: $$Utilities.ExactNonEmpty<$Document, $$SelectionSets.$Document<$Context['scalars']>>,
+    document: $$Utilities.ExactNonEmpty<
+      $Document,
+      $$SelectionSets.$Document<
+        // @ts-expect-error Context constraint missing to avoid TS compare depth limit.
+        $Context['scalars']
+      >
+    >,
   ): $$Utilities.DocumentBuilder.DocumentRunner<
     $Context,
     $$Schema.Schema,
@@ -15,6 +21,5 @@ export interface Document<$Context extends $$Utilities.Context> {
 }
 
 export interface BuilderMethodsDocumentFn extends $$Utilities.TypeFunction {
-  // @ts-expect-error parameter is Untyped.
   return: Document<this['params']>
 }

examples/$/graffle/modules/methods-root.ts

@@ -22,7 +22,7 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
     $Context,
     () => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         { __typename: 'Query' },
         '__typename'
@@ -36,7 +36,7 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.battles<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         $$Utilities.DocumentBuilder.InferResult.OperationQuery<
           { battles: $SelectionSet },
@@ -53,7 +53,7 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.beings<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         $$Utilities.DocumentBuilder.InferResult.OperationQuery<
           { beings: $SelectionSet },
@@ -70,7 +70,7 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.pokemonByName<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         $$Utilities.DocumentBuilder.InferResult.OperationQuery<
           { pokemonByName: $SelectionSet },
@@ -87,7 +87,7 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.pokemons<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         $$Utilities.DocumentBuilder.InferResult.OperationQuery<
           { pokemons: $SelectionSet },
@@ -104,7 +104,7 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.trainerByName<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         $$Utilities.DocumentBuilder.InferResult.OperationQuery<
           { trainerByName: $SelectionSet },
@@ -121,7 +121,7 @@ export interface QueryMethods<$Context extends $$Utilities.Context> {
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Query.trainers<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         $$Utilities.DocumentBuilder.InferResult.OperationQuery<
           { trainers: $SelectionSet },
@@ -153,7 +153,7 @@ export interface MutationMethods<$Context extends $$Utilities.Context> {
     $Context,
     () => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         { __typename: 'Mutation' },
         '__typename'
@@ -167,7 +167,7 @@ export interface MutationMethods<$Context extends $$Utilities.Context> {
       selectionSet: $$Utilities.Exact<$SelectionSet, $$SelectionSets.Mutation.addPokemon<$Context['scalars']>>,
     ) => Promise<
       & (null | {})
-      & $$Utilities.HandleOutputGraffleRootField<
+      & $$Utilities.HandleOutputDocumentBuilderRootField<
         $Context,
         $$Utilities.DocumentBuilder.InferResult.OperationMutation<
           { addPokemon: $SelectionSet },