add specified scalars

Author: martinbonnin

scripts/update-appendix-c.mjs

@@ -1,14 +1,18 @@
 import { writeFile } from 'node:fs/promises';
-import { printIntrospectionSchema, buildSchema } from 'graphql';
+import { printIntrospectionSchema, buildSchema, specifiedScalarTypes, printType } from 'graphql';
 
 const FILE = './spec/Appendix C -- Built-in Definitions.md';
+function printSpecifiedScalars() {
+  return specifiedScalarTypes
+    .map((type) => printType(type))
+    .join('\n\n');
+}
 
-const sdl = printIntrospectionSchema(buildSchema(`type Query { i: Int }`));
+const introspectionSchema = printIntrospectionSchema(buildSchema(`type Query { i: Int }`));
 const prefix = `
 # C. Appendix: Type System Definitions
 
-This appendix lists all the type system definitions mentioned throughout this
-specification.
+This appendix lists the specified type system definitions.
 
 The descriptions are non-normative. Implementations are recommended to use them
 for consistency but different descriptions are allowed.
@@ -21,4 +25,4 @@ The order of types, fields, arguments, values and directives is non-normative.
 const suffix = `
 \`\`\`
 `
-await writeFile(FILE, prefix + sdl + suffix);
+await writeFile(FILE, prefix + printSpecifiedScalars() + '\n\n' + introspectionSchema + suffix);

spec/Appendix C -- Built-in Definitions.md

@@ -1,12 +1,38 @@
 # C. Appendix: Type System Definitions
 
-This appendix lists all the type system definitions mentioned throughout this
-specification.
+This appendix lists the built-in type system definitions.
 
 The descriptions are non-normative. Implementations are recommended to use them
 for consistency but different descriptions are allowed.
 
+The order of types, fields, arguments, values and directives is non-normative.
+
 ```graphql
+"""
+The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
+"""
+scalar String
+
+"""
+The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
+"""
+scalar Int
+
+"""
+The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).
+"""
+scalar Float
+
+"""
+The `Boolean` scalar type represents `true` or `false`.
+"""
+scalar Boolean
+
+"""
+The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.
+"""
+scalar ID
+
 """
 Directs the executor to include this field or fragment only when the `if` argument is true.
 """