Format

Author: eddeee888

website/src/pages/docs/migration/apollo-tooling.mdx

@@ -93,7 +93,10 @@ import type { CodegenConfig } from '@graphql-codegen/cli'
 const config: CodegenConfig = {
   schema: './schema.graphql',
   documents: ['./src/**/*.{ts,tsx}', '!./src/**/__generated__/**'],
-  externalDocuments: ['../other-package/src/**/*.{ts,tsx}', '!../other-package/src/**/__generated__/**'],
+  externalDocuments: [
+    '../other-package/src/**/*.{ts,tsx}',
+    '!../other-package/src/**/__generated__/**'
+  ],
   generates: {
     './src/': {
       preset: 'near-operation-file',
@@ -154,7 +157,10 @@ import type { CodegenConfig } from '@graphql-codegen/cli'
 const config: CodegenConfig = {
   schema: './schema.graphql',
   documents: ['./src/**/*.{ts,tsx}', '!./src/**/__generated__/**'],
-  externalDocuments: ['../other-package/src/**/*.{ts,tsx}', '!../other-package/src/**/__generated__/**'],
+  externalDocuments: [
+    '../other-package/src/**/*.{ts,tsx}',
+    '!../other-package/src/**/__generated__/**'
+  ],
   generates: {
     './src/': {
       preset: 'near-operation-file',
@@ -196,7 +202,10 @@ configuration option:
 const config: CodegenConfig = {
   schema: './schema.graphql',
   documents: ['./src/**/*.{ts,tsx}', '!./src/**/__generated__/**'],
-  externalDocuments: ['../other-package/src/**/*.{ts,tsx}', '!../other-package/src/**/__generated__/**'],
+  externalDocuments: [
+    '../other-package/src/**/*.{ts,tsx}',
+    '!../other-package/src/**/__generated__/**'
+  ],
   generates: {
     './src/': {
       preset: 'near-operation-file',
@@ -239,7 +248,10 @@ declarations matching Apollo Tooling's output, set `enumType: 'native'`:
 const config: CodegenConfig = {
   schema: './schema.graphql',
   documents: ['./src/**/*.{ts,tsx}', '!./src/**/__generated__/**'],
-  externalDocuments: ['../other-package/src/**/*.{ts,tsx}', '!../other-package/src/**/__generated__/**'],
+  externalDocuments: [
+    '../other-package/src/**/*.{ts,tsx}',
+    '!../other-package/src/**/__generated__/**'
+  ],
   generates: {
     './src/': {
       preset: 'near-operation-file',
@@ -286,7 +298,10 @@ const config: CodegenConfig = {
   documents: ['./src/**/*.{ts,tsx}', '!./src/**/__generated__/**'],
   // `externalDocuments` are read-only documents that are loaded but do not generate output.
   // They are used to include fragments from another package in a monorepo without generating unnecessary files.
-  externalDocuments: ['../other-package/src/**/*.{ts,tsx}', '!../other-package/src/**/__generated__/**'],
+  externalDocuments: [
+    '../other-package/src/**/*.{ts,tsx}',
+    '!../other-package/src/**/__generated__/**'
+  ],
   generates: {
     './src/': {
       preset: 'near-operation-file',
@@ -332,8 +347,8 @@ require manual fixes:
 
 #### 1. Nested field types naming.
 
-In very rare cases, the field names generated by GraphQL Codegen don’t match Apollo Tooling’s. Update
-these cases manually.
+In very rare cases, the field names generated by GraphQL Codegen don’t match Apollo Tooling’s.
+Update these cases manually.
 
 #### 2. Enum file location.
 
@@ -356,22 +371,29 @@ For `has any type` bug - a proper type needs to be determined.
 
 Experiment with the following configuration options to keep your codebase changes to a minimum:
 
-* **maybeValue**: defaults to `T | null`, set to `T | null | undefined` if necessary
-* **inputMaybeValue**: defaults to `Maybe<T>`, set to `T | null | undefined` if necessary
-* **avoidOptionals**: Replaces ? optional modifier with explicit `Maybe<T>`. Supports granular control via object form.
-* **allowUndefinedQueryVariables**: Adds | undefined to Query operation variable types (not Mutation/Subscription)
-* **optionalResolveType**: Makes `__resolveType` optional (`__resolveType?`) in resolver types.
-* **nullability**:  When `errorHandlingClient: true`, adjusts nullability for fields marked with `@semanticNonNull` directive (requires `graphql-sock`).
+- **maybeValue**: defaults to `T | null`, set to `T | null | undefined` if necessary
+- **inputMaybeValue**: defaults to `Maybe<T>`, set to `T | null | undefined` if necessary
+- **avoidOptionals**: Replaces ? optional modifier with explicit `Maybe<T>`. Supports granular
+  control via object form.
+- **allowUndefinedQueryVariables**: Adds | undefined to Query operation variable types (not
+  Mutation/Subscription)
+- **optionalResolveType**: Makes `__resolveType` optional (`__resolveType?`) in resolver types.
+- **nullability**: When `errorHandlingClient: true`, adjusts nullability for fields marked with
+  `@semanticNonNull` directive (requires `graphql-sock`).
 
 #### 5. Extra `__typename` present, or required `__typename` missing.
 
 Experiment with the following configuration options to keep your codebase changes to a minimum:
 
-* **skipTypename**: prevents adding `__typename` to generated types unless explicitly in the selection set.
-* **skipTypeNameForRoot**: skips `__typename` specifically for root types (Query, Mutation, Subscription). Ignored if `__typename` is explicitly in the selection set
-* **nonOptionalTypename**: always adds `__typename` and makes it a required (non-optional) field.
-* **addTypenameToSelectionSets**: injects `__typename` directly into the generated document node selection sets.
-* **resolversNonOptionalTypename**: makes `__typename` non-optional in resolver mappings without affecting base types. Supports granular control via object form.
+- **skipTypename**: prevents adding `__typename` to generated types unless explicitly in the
+  selection set.
+- **skipTypeNameForRoot**: skips `__typename` specifically for root types (Query, Mutation,
+  Subscription). Ignored if `__typename` is explicitly in the selection set
+- **nonOptionalTypename**: always adds `__typename` and makes it a required (non-optional) field.
+- **addTypenameToSelectionSets**: injects `__typename` directly into the generated document node
+  selection sets.
+- **resolversNonOptionalTypename**: makes `__typename` non-optional in resolver mappings without
+  affecting base types. Supports granular control via object form.
 
 ## Further reading