chore: refresh generated API docs from source examples

Commit 106fdc9 ("docs: add prettier for jsdoc examples (#4807)") formatted source JSDoc examples on 17.x.x. No generate:docs commit followed it before fa06509: the range 106fdc9..fa06509 does not touch website/pages/api-v16, website/pages/api-v17, or website/generate-api.js. Refresh the generated v17 API output with the pinned website Prettier v2 before changing generator behavior or upgrading Prettier.

Author: yaacovCR

website/pages/api-v17/error.mdx

@@ -298,9 +298,7 @@ import { locatedError } from 'graphql/error';
 
 const document = parse('{ viewer { name } }');
 const fieldNode = document.definitions[0].selectionSet.selections[0];
-const error = locatedError(new Error('Resolver failed'), fieldNode, [
-  'viewer',
-]);
+const error = locatedError(new Error('Resolver failed'), fieldNode, ['viewer']);
 
 error.message; // => 'Resolver failed'
 error.locations; // => [{ line: 1, column: 3 }]

website/pages/api-v17/execution.mdx

@@ -317,7 +317,10 @@ this case is the entire response.
 import assert from 'node:assert';
 import { parse } from 'graphql/language';
 import { buildSchema } from 'graphql/utilities';
-import { executeRootSelectionSet, validateExecutionArgs } from 'graphql/execution';
+import {
+  executeRootSelectionSet,
+  validateExecutionArgs,
+} from 'graphql/execution';
 
 const schema = buildSchema('type Query { greeting: String }');
 const validatedArgs = validateExecutionArgs({
@@ -465,7 +468,10 @@ or rejecting the returned promise.
 import assert from 'node:assert';
 import { parse } from 'graphql/language';
 import { buildSchema } from 'graphql/utilities';
-import { executeSubscriptionEvent, validateSubscriptionArgs } from 'graphql/execution';
+import {
+  executeSubscriptionEvent,
+  validateSubscriptionArgs,
+} from 'graphql/execution';
 
 const schema = buildSchema(`
   type Query {
@@ -738,7 +744,10 @@ or otherwise separating these two steps. For more on this, see the
 import assert from 'node:assert';
 import { parse } from 'graphql/language';
 import { buildSchema } from 'graphql/utilities';
-import { createSourceEventStream, validateSubscriptionArgs } from 'graphql/execution';
+import {
+  createSourceEventStream,
+  validateSubscriptionArgs,
+} from 'graphql/execution';
 
 async function* greetings() {
   yield { greeting: 'Hello' };
@@ -1028,7 +1037,10 @@ stream to an ExecutionResult in the response stream.
 import assert from 'node:assert';
 import { parse } from 'graphql/language';
 import { buildSchema } from 'graphql/utilities';
-import { mapSourceToResponseEvent, validateSubscriptionArgs } from 'graphql/execution';
+import {
+  mapSourceToResponseEvent,
+  validateSubscriptionArgs,
+} from 'graphql/execution';
 
 async function* events() {
   yield { greeting: 'Hello' };
@@ -3770,11 +3782,9 @@ const document = parse(`
 `);
 const operation = document.definitions[0];
 
-const result = getVariableValues(
-  schema,
-  operation.variableDefinitions,
-  { stars: '5' },
-);
+const result = getVariableValues(schema, operation.variableDefinitions, {
+  stars: '5',
+});
 
 assert('variableValues' in result);
 
@@ -3938,11 +3948,9 @@ const fieldDef = schema.getQueryType().getFields().reviews;
 const document = parse('query ($stars: Int!) { reviews(stars: $stars) }');
 const operation = document.definitions[0];
 const fieldNode = document.definitions[0].selectionSet.selections[0];
-const variables = getVariableValues(
-  schema,
-  operation.variableDefinitions,
-  { stars: '5' },
-);
+const variables = getVariableValues(schema, operation.variableDefinitions, {
+  stars: '5',
+});
 
 assert('variableValues' in variables);
 
@@ -4056,18 +4064,22 @@ import { buildSchema } from 'graphql/utilities';
 import { getDirectiveValues, getVariableValues } from 'graphql/execution';
 
 const schema = buildSchema('type Query { name: String }');
-const document = parse('query ($includeName: Boolean!) { name @include(if: $includeName) }');
+const document = parse(
+  'query ($includeName: Boolean!) { name @include(if: $includeName) }',
+);
 const operation = document.definitions[0];
 const fieldNode = document.definitions[0].selectionSet.selections[0];
-const variables = getVariableValues(
-  schema,
-  operation.variableDefinitions,
-  { includeName: false },
-);
+const variables = getVariableValues(schema, operation.variableDefinitions, {
+  includeName: false,
+});
 
 assert('variableValues' in variables);
 
-getDirectiveValues(GraphQLIncludeDirective, fieldNode, variables.variableValues); // => { if: false }
+getDirectiveValues(
+  GraphQLIncludeDirective,
+  fieldNode,
+  variables.variableValues,
+); // => { if: false }
 getDirectiveValues(GraphQLIncludeDirective, { directives: [] }); // => undefined
 ```
 

website/pages/api-v17/language.mdx

@@ -4254,18 +4254,21 @@ document.kind; // => 'Document'
 // This variant enables parser options and provides an explicit lexer.
 import { Lexer, Source, parse } from 'graphql/language';
 
-const document = parse(`
+const document = parse(
+  `
+    {
+      t { ...A(var: true) }
+    }
+    fragment A($var: Boolean = false) on T {
+      name
+    }
+  `,
   {
-    t { ...A(var: true) }
-  }
-  fragment A($var: Boolean = false) on T {
-    name
-  }
-`, {
-  experimentalFragmentArguments: true,
-  maxTokens: 80,
-  noLocation: true,
-});
+    experimentalFragmentArguments: true,
+    maxTokens: 80,
+    noLocation: true,
+  },
+);
 const directiveDocument = parse('directive @foo @bar on FIELD', {
   experimentalDirectivesOnDirectiveDefinitions: true,
 });
@@ -4622,7 +4625,7 @@ This syntax is not part of the GraphQL specification and may change.</td>
 
 <div className="api-subsection-title">experimentalFragmentArguments Example</div>
 
-```graphql
+```graphql prettier-ignore
 {
   t { ...A(var: true) }
 }
@@ -4635,7 +4638,7 @@ fragment A($var: Boolean = false) on T {
 
 <div className="api-subsection-title">experimentalDirectivesOnDirectiveDefinitions Example</div>
 
-```graphql
+```graphql prettier-ignore
 directive @foo @bar on FIELD
 ```
 
@@ -5047,7 +5050,11 @@ Returns true when the AST node is a constant value node.
 <div className="api-subsection-title">Example</div>
 
 ```ts
-import { parseConstValue, parseValue, isConstValueNode } from 'graphql/language';
+import {
+  parseConstValue,
+  parseValue,
+  isConstValueNode,
+} from 'graphql/language';
 
 const value = parseConstValue('[42]');
 const variable = parseValue('$id');
@@ -5936,8 +5943,16 @@ const events = [];
 visit(
   document,
   visitInParallel([
-    { Field: (node) => { events.push(`field:${node.name.value}`); } },
-    { Name: (node) => { events.push(`name:${node.value}`); } },
+    {
+      Field: (node) => {
+        events.push(`field:${node.name.value}`);
+      },
+    },
+    {
+      Name: (node) => {
+        events.push(`name:${node.value}`);
+      },
+    },
   ]),
 );