relay-compiler 0.0.0-main-4d287de9 → 0.0.0-main-9a79039d

Sign up to get free protection for your applications and to get access to all the features.
Files changed (259) hide show
  1. package/cli.js +23 -0
  2. package/index.js +19 -3
  3. package/linux-x64/relay +0 -0
  4. package/macos-x64/relay +0 -0
  5. package/package.json +2 -26
  6. package/win-x64/relay.exe +0 -0
  7. package/bin/RelayCompilerBin.js.flow +0 -168
  8. package/bin/RelayCompilerMain.js.flow +0 -513
  9. package/bin/__fixtures__/plugin-module.js.flow +0 -17
  10. package/bin/relay-compiler +0 -19066
  11. package/codegen/CodegenDirectory.js.flow +0 -372
  12. package/codegen/CodegenRunner.js.flow +0 -424
  13. package/codegen/CodegenTypes.js.flow +0 -28
  14. package/codegen/CodegenWatcher.js.flow +0 -250
  15. package/codegen/NormalizationCodeGenerator.js.flow +0 -565
  16. package/codegen/ReaderCodeGenerator.js.flow +0 -510
  17. package/codegen/RelayCodeGenerator.js.flow +0 -85
  18. package/codegen/RelayFileWriter.js.flow +0 -365
  19. package/codegen/SourceControl.js.flow +0 -58
  20. package/codegen/compileRelayArtifacts.js.flow +0 -181
  21. package/codegen/createPrintRequireModuleDependency.js.flow +0 -19
  22. package/codegen/sortObjectByKey.js.flow +0 -25
  23. package/codegen/writeRelayGeneratedFile.js.flow +0 -235
  24. package/core/ASTCache.js.flow +0 -73
  25. package/core/ASTConvert.js.flow +0 -230
  26. package/core/CompilerContext.js.flow +0 -189
  27. package/core/CompilerError.js.flow +0 -255
  28. package/core/DotGraphQLParser.js.flow +0 -37
  29. package/core/GraphQLCompilerProfiler.js.flow +0 -341
  30. package/core/GraphQLDerivedFromMetadata.js.flow +0 -36
  31. package/core/GraphQLWatchmanClient.js.flow +0 -109
  32. package/core/IR.js.flow +0 -326
  33. package/core/IRPrinter.js.flow +0 -472
  34. package/core/IRTransformer.js.flow +0 -376
  35. package/core/IRValidator.js.flow +0 -259
  36. package/core/IRVisitor.js.flow +0 -150
  37. package/core/JSModuleParser.js.flow +0 -24
  38. package/core/RelayCompilerScope.js.flow +0 -199
  39. package/core/RelayFindGraphQLTags.js.flow +0 -118
  40. package/core/RelayGraphQLEnumsGenerator.js.flow +0 -55
  41. package/core/RelayIRTransforms.js.flow +0 -138
  42. package/core/RelayParser.js.flow +0 -1731
  43. package/core/RelaySourceModuleParser.js.flow +0 -133
  44. package/core/Schema.js.flow +0 -2035
  45. package/core/SchemaUtils.js.flow +0 -120
  46. package/core/filterContextForNode.js.flow +0 -49
  47. package/core/getFieldDefinition.js.flow +0 -156
  48. package/core/getIdentifierForArgumentValue.js.flow +0 -49
  49. package/core/getIdentifierForSelection.js.flow +0 -68
  50. package/core/getLiteralArgumentValues.js.flow +0 -32
  51. package/core/getNormalizationOperationName.js.flow +0 -19
  52. package/core/inferRootArgumentDefinitions.js.flow +0 -322
  53. package/index.js.flow +0 -198
  54. package/language/RelayLanguagePluginInterface.js.flow +0 -283
  55. package/language/javascript/FindGraphQLTags.js.flow +0 -136
  56. package/language/javascript/RelayFlowBabelFactories.js.flow +0 -176
  57. package/language/javascript/RelayFlowGenerator.js.flow +0 -1096
  58. package/language/javascript/RelayFlowTypeTransformers.js.flow +0 -181
  59. package/language/javascript/RelayLanguagePluginJavaScript.js.flow +0 -33
  60. package/language/javascript/formatGeneratedModule.js.flow +0 -65
  61. package/lib/bin/RelayCompilerBin.js +0 -143
  62. package/lib/bin/RelayCompilerMain.js +0 -486
  63. package/lib/bin/__fixtures__/plugin-module.js +0 -16
  64. package/lib/codegen/CodegenDirectory.js +0 -335
  65. package/lib/codegen/CodegenRunner.js +0 -433
  66. package/lib/codegen/CodegenTypes.js +0 -11
  67. package/lib/codegen/CodegenWatcher.js +0 -271
  68. package/lib/codegen/NormalizationCodeGenerator.js +0 -487
  69. package/lib/codegen/ReaderCodeGenerator.js +0 -473
  70. package/lib/codegen/RelayCodeGenerator.js +0 -75
  71. package/lib/codegen/RelayFileWriter.js +0 -270
  72. package/lib/codegen/SourceControl.js +0 -60
  73. package/lib/codegen/compileRelayArtifacts.js +0 -157
  74. package/lib/codegen/createPrintRequireModuleDependency.js +0 -19
  75. package/lib/codegen/sortObjectByKey.js +0 -41
  76. package/lib/codegen/writeRelayGeneratedFile.js +0 -206
  77. package/lib/core/ASTCache.js +0 -70
  78. package/lib/core/ASTConvert.js +0 -198
  79. package/lib/core/CompilerContext.js +0 -165
  80. package/lib/core/CompilerError.js +0 -252
  81. package/lib/core/DotGraphQLParser.js +0 -40
  82. package/lib/core/GraphQLCompilerProfiler.js +0 -299
  83. package/lib/core/GraphQLDerivedFromMetadata.js +0 -31
  84. package/lib/core/GraphQLWatchmanClient.js +0 -150
  85. package/lib/core/IR.js +0 -11
  86. package/lib/core/IRPrinter.js +0 -388
  87. package/lib/core/IRTransformer.js +0 -345
  88. package/lib/core/IRValidator.js +0 -226
  89. package/lib/core/IRVisitor.js +0 -45
  90. package/lib/core/JSModuleParser.js +0 -18
  91. package/lib/core/RelayCompilerScope.js +0 -183
  92. package/lib/core/RelayFindGraphQLTags.js +0 -79
  93. package/lib/core/RelayGraphQLEnumsGenerator.js +0 -50
  94. package/lib/core/RelayIRTransforms.js +0 -109
  95. package/lib/core/RelayParser.js +0 -1381
  96. package/lib/core/RelaySourceModuleParser.js +0 -104
  97. package/lib/core/Schema.js +0 -1877
  98. package/lib/core/SchemaUtils.js +0 -98
  99. package/lib/core/filterContextForNode.js +0 -50
  100. package/lib/core/getFieldDefinition.js +0 -145
  101. package/lib/core/getIdentifierForArgumentValue.js +0 -54
  102. package/lib/core/getIdentifierForSelection.js +0 -49
  103. package/lib/core/getLiteralArgumentValues.js +0 -26
  104. package/lib/core/getNormalizationOperationName.js +0 -17
  105. package/lib/core/inferRootArgumentDefinitions.js +0 -351
  106. package/lib/index.js +0 -178
  107. package/lib/language/RelayLanguagePluginInterface.js +0 -26
  108. package/lib/language/javascript/FindGraphQLTags.js +0 -126
  109. package/lib/language/javascript/RelayFlowBabelFactories.js +0 -160
  110. package/lib/language/javascript/RelayFlowGenerator.js +0 -856
  111. package/lib/language/javascript/RelayFlowTypeTransformers.js +0 -119
  112. package/lib/language/javascript/RelayLanguagePluginJavaScript.js +0 -30
  113. package/lib/language/javascript/formatGeneratedModule.js +0 -36
  114. package/lib/reporters/ConsoleReporter.js +0 -61
  115. package/lib/reporters/MultiReporter.js +0 -45
  116. package/lib/reporters/Reporter.js +0 -11
  117. package/lib/runner/Artifacts.js +0 -323
  118. package/lib/runner/BufferedFilesystem.js +0 -262
  119. package/lib/runner/GraphQLASTNodeGroup.js +0 -256
  120. package/lib/runner/GraphQLASTUtils.js +0 -23
  121. package/lib/runner/GraphQLNodeMap.js +0 -81
  122. package/lib/runner/Sources.js +0 -271
  123. package/lib/runner/StrictMap.js +0 -134
  124. package/lib/runner/compileArtifacts.js +0 -39
  125. package/lib/runner/extractAST.js +0 -77
  126. package/lib/runner/getChangedNodeNames.js +0 -82
  127. package/lib/runner/getSchemaInstance.js +0 -30
  128. package/lib/runner/types.js +0 -12
  129. package/lib/transforms/ApplyFragmentArgumentTransform.js +0 -393
  130. package/lib/transforms/ClientExtensionsTransform.js +0 -221
  131. package/lib/transforms/ConnectionTransform.js +0 -639
  132. package/lib/transforms/DeclarativeConnectionMutationTransform.js +0 -218
  133. package/lib/transforms/DeferStreamTransform.js +0 -246
  134. package/lib/transforms/DisallowIdAsAlias.js +0 -40
  135. package/lib/transforms/DisallowTypenameOnRoot.js +0 -53
  136. package/lib/transforms/FieldHandleTransform.js +0 -79
  137. package/lib/transforms/FilterCompilerDirectivesTransform.js +0 -29
  138. package/lib/transforms/FilterDirectivesTransform.js +0 -42
  139. package/lib/transforms/FlattenTransform.js +0 -306
  140. package/lib/transforms/GenerateIDFieldTransform.js +0 -135
  141. package/lib/transforms/GenerateTypeNameTransform.js +0 -149
  142. package/lib/transforms/InlineDataFragmentTransform.js +0 -100
  143. package/lib/transforms/InlineFragmentsTransform.js +0 -61
  144. package/lib/transforms/MaskTransform.js +0 -117
  145. package/lib/transforms/MatchTransform.js +0 -434
  146. package/lib/transforms/ReactFlightComponentTransform.js +0 -158
  147. package/lib/transforms/RefetchableFragmentTransform.js +0 -249
  148. package/lib/transforms/RelayDirectiveTransform.js +0 -83
  149. package/lib/transforms/RequiredFieldTransform.js +0 -369
  150. package/lib/transforms/SkipClientExtensionsTransform.js +0 -46
  151. package/lib/transforms/SkipHandleFieldTransform.js +0 -45
  152. package/lib/transforms/SkipRedundantNodesTransform.js +0 -261
  153. package/lib/transforms/SkipSplitOperationTransform.js +0 -32
  154. package/lib/transforms/SkipUnreachableNodeTransform.js +0 -158
  155. package/lib/transforms/SkipUnusedVariablesTransform.js +0 -75
  156. package/lib/transforms/SplitModuleImportTransform.js +0 -82
  157. package/lib/transforms/TestOperationTransform.js +0 -144
  158. package/lib/transforms/TransformUtils.js +0 -21
  159. package/lib/transforms/ValidateGlobalVariablesTransform.js +0 -92
  160. package/lib/transforms/ValidateRequiredArgumentsTransform.js +0 -114
  161. package/lib/transforms/ValidateServerOnlyDirectivesTransform.js +0 -108
  162. package/lib/transforms/ValidateUnusedVariablesTransform.js +0 -96
  163. package/lib/transforms/query-generators/FetchableQueryGenerator.js +0 -157
  164. package/lib/transforms/query-generators/NodeQueryGenerator.js +0 -166
  165. package/lib/transforms/query-generators/QueryQueryGenerator.js +0 -48
  166. package/lib/transforms/query-generators/ViewerQueryGenerator.js +0 -77
  167. package/lib/transforms/query-generators/index.js +0 -60
  168. package/lib/transforms/query-generators/utils.js +0 -92
  169. package/lib/util/CodeMarker.js +0 -80
  170. package/lib/util/DefaultHandleKey.js +0 -15
  171. package/lib/util/RelayCompilerCache.js +0 -97
  172. package/lib/util/Rollout.js +0 -40
  173. package/lib/util/TimeReporter.js +0 -83
  174. package/lib/util/areEqualArgValues.js +0 -135
  175. package/lib/util/argumentContainsVariables.js +0 -37
  176. package/lib/util/dedupeJSONStringify.js +0 -160
  177. package/lib/util/generateAbstractTypeRefinementKey.js +0 -24
  178. package/lib/util/getDefinitionNodeHash.js +0 -22
  179. package/lib/util/getModuleName.js +0 -32
  180. package/lib/util/joinArgumentDefinitions.js +0 -67
  181. package/lib/util/md5.js +0 -17
  182. package/lib/util/murmurHash.js +0 -86
  183. package/lib/util/nullthrowsOSS.js +0 -23
  184. package/lib/util/orList.js +0 -36
  185. package/lib/util/partitionArray.js +0 -35
  186. package/relay-compiler.js +0 -17
  187. package/relay-compiler.min.js +0 -22
  188. package/reporters/ConsoleReporter.js.flow +0 -81
  189. package/reporters/MultiReporter.js.flow +0 -43
  190. package/reporters/Reporter.js.flow +0 -19
  191. package/runner/Artifacts.js.flow +0 -215
  192. package/runner/BufferedFilesystem.js.flow +0 -194
  193. package/runner/GraphQLASTNodeGroup.js.flow +0 -174
  194. package/runner/GraphQLASTUtils.js.flow +0 -26
  195. package/runner/GraphQLNodeMap.js.flow +0 -55
  196. package/runner/Sources.js.flow +0 -227
  197. package/runner/StrictMap.js.flow +0 -96
  198. package/runner/compileArtifacts.js.flow +0 -75
  199. package/runner/extractAST.js.flow +0 -98
  200. package/runner/getChangedNodeNames.js.flow +0 -48
  201. package/runner/getSchemaInstance.js.flow +0 -36
  202. package/runner/types.js.flow +0 -37
  203. package/transforms/ApplyFragmentArgumentTransform.js.flow +0 -524
  204. package/transforms/ClientExtensionsTransform.js.flow +0 -224
  205. package/transforms/ConnectionTransform.js.flow +0 -850
  206. package/transforms/DeclarativeConnectionMutationTransform.js.flow +0 -245
  207. package/transforms/DeferStreamTransform.js.flow +0 -263
  208. package/transforms/DisallowIdAsAlias.js.flow +0 -46
  209. package/transforms/DisallowTypenameOnRoot.js.flow +0 -44
  210. package/transforms/FieldHandleTransform.js.flow +0 -77
  211. package/transforms/FilterCompilerDirectivesTransform.js.flow +0 -33
  212. package/transforms/FilterDirectivesTransform.js.flow +0 -45
  213. package/transforms/FlattenTransform.js.flow +0 -458
  214. package/transforms/GenerateIDFieldTransform.js.flow +0 -151
  215. package/transforms/GenerateTypeNameTransform.js.flow +0 -159
  216. package/transforms/InlineDataFragmentTransform.js.flow +0 -123
  217. package/transforms/InlineFragmentsTransform.js.flow +0 -70
  218. package/transforms/MaskTransform.js.flow +0 -124
  219. package/transforms/MatchTransform.js.flow +0 -587
  220. package/transforms/ReactFlightComponentTransform.js.flow +0 -194
  221. package/transforms/RefetchableFragmentTransform.js.flow +0 -266
  222. package/transforms/RelayDirectiveTransform.js.flow +0 -96
  223. package/transforms/RequiredFieldTransform.js.flow +0 -413
  224. package/transforms/SkipClientExtensionsTransform.js.flow +0 -54
  225. package/transforms/SkipHandleFieldTransform.js.flow +0 -44
  226. package/transforms/SkipRedundantNodesTransform.js.flow +0 -255
  227. package/transforms/SkipSplitOperationTransform.js.flow +0 -37
  228. package/transforms/SkipUnreachableNodeTransform.js.flow +0 -148
  229. package/transforms/SkipUnusedVariablesTransform.js.flow +0 -59
  230. package/transforms/SplitModuleImportTransform.js.flow +0 -97
  231. package/transforms/TestOperationTransform.js.flow +0 -142
  232. package/transforms/TransformUtils.js.flow +0 -26
  233. package/transforms/ValidateGlobalVariablesTransform.js.flow +0 -80
  234. package/transforms/ValidateRequiredArgumentsTransform.js.flow +0 -126
  235. package/transforms/ValidateServerOnlyDirectivesTransform.js.flow +0 -111
  236. package/transforms/ValidateUnusedVariablesTransform.js.flow +0 -88
  237. package/transforms/query-generators/FetchableQueryGenerator.js.flow +0 -188
  238. package/transforms/query-generators/NodeQueryGenerator.js.flow +0 -217
  239. package/transforms/query-generators/QueryQueryGenerator.js.flow +0 -57
  240. package/transforms/query-generators/ViewerQueryGenerator.js.flow +0 -97
  241. package/transforms/query-generators/index.js.flow +0 -89
  242. package/transforms/query-generators/utils.js.flow +0 -76
  243. package/util/CodeMarker.js.flow +0 -79
  244. package/util/DefaultHandleKey.js.flow +0 -17
  245. package/util/RelayCompilerCache.js.flow +0 -86
  246. package/util/Rollout.js.flow +0 -39
  247. package/util/TimeReporter.js.flow +0 -79
  248. package/util/areEqualArgValues.js.flow +0 -126
  249. package/util/argumentContainsVariables.js.flow +0 -38
  250. package/util/dedupeJSONStringify.js.flow +0 -152
  251. package/util/generateAbstractTypeRefinementKey.js.flow +0 -29
  252. package/util/getDefinitionNodeHash.js.flow +0 -24
  253. package/util/getModuleName.js.flow +0 -39
  254. package/util/joinArgumentDefinitions.js.flow +0 -105
  255. package/util/md5.js.flow +0 -19
  256. package/util/murmurHash.js.flow +0 -94
  257. package/util/nullthrowsOSS.js.flow +0 -25
  258. package/util/orList.js.flow +0 -37
  259. package/util/partitionArray.js.flow +0 -37
@@ -1,376 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- *
7
- * @flow strict
8
- * @format
9
- */
10
-
11
- // flowlint ambiguous-object-type:error
12
-
13
- 'use strict';
14
-
15
- import type CompilerContext, {CompilerContextDocument} from './CompilerContext';
16
- import type {
17
- Argument,
18
- ClientExtension,
19
- Condition,
20
- Defer,
21
- Directive,
22
- Fragment,
23
- FragmentSpread,
24
- InlineDataFragmentSpread,
25
- InlineFragment,
26
- IR,
27
- LinkedField,
28
- ListValue,
29
- Literal,
30
- LocalArgumentDefinition,
31
- ModuleImport,
32
- ObjectFieldValue,
33
- ObjectValue,
34
- Request,
35
- Root,
36
- RootArgumentDefinition,
37
- ScalarField,
38
- SplitOperation,
39
- Stream,
40
- Variable,
41
- } from './IR';
42
-
43
- const {eachWithCombinedError} = require('./CompilerError');
44
- const invariant = require('invariant');
45
-
46
- type NodeVisitor<S> = {|
47
- Argument?: NodeVisitorFunction<Argument, S>,
48
- ClientExtension?: NodeVisitorFunction<ClientExtension, S>,
49
- Condition?: NodeVisitorFunction<Condition, S>,
50
- Defer?: NodeVisitorFunction<Defer, S>,
51
- Directive?: NodeVisitorFunction<Directive, S>,
52
- Fragment?: NodeVisitorFunction<Fragment, S>,
53
- FragmentSpread?: NodeVisitorFunction<FragmentSpread, S>,
54
- InlineFragment?: NodeVisitorFunction<InlineFragment, S>,
55
- LinkedField?: NodeVisitorFunction<LinkedField, S>,
56
- ListValue?: NodeVisitorFunction<ListValue, S>,
57
- Literal?: NodeVisitorFunction<Literal, S>,
58
- LocalArgumentDefinition?: NodeVisitorFunction<LocalArgumentDefinition, S>,
59
- ModuleImport?: NodeVisitorFunction<ModuleImport, S>,
60
- ObjectFieldValue?: NodeVisitorFunction<ObjectFieldValue, S>,
61
- ObjectValue?: NodeVisitorFunction<ObjectValue, S>,
62
- Request?: NodeVisitorFunction<Request, S>,
63
- Root?: NodeVisitorFunction<Root, S>,
64
- InlineDataFragmentSpread?: NodeVisitorFunction<InlineDataFragmentSpread, S>,
65
- RootArgumentDefinition?: NodeVisitorFunction<RootArgumentDefinition, S>,
66
- ScalarField?: NodeVisitorFunction<ScalarField, S>,
67
- SplitOperation?: NodeVisitorFunction<SplitOperation, S>,
68
- Stream?: NodeVisitorFunction<Stream, S>,
69
- Variable?: NodeVisitorFunction<Variable, S>,
70
- |};
71
- type NodeVisitorFunction<N: IR, S> = (node: N, state: S) => ?N;
72
-
73
- /**
74
- * @public
75
- *
76
- * Helper for writing compiler transforms that apply "map" and/or "filter"-style
77
- * operations to compiler contexts. The `visitor` argument accepts a map of IR
78
- * kinds to user-defined functions that can map nodes of that kind to new values
79
- * (of the same kind).
80
- *
81
- * If a visitor function is defined for a kind, the visitor function is
82
- * responsible for traversing its children (by calling `this.traverse(node)`)
83
- * and returning either the input (to indicate no changes), a new node (to
84
- * indicate changes), or null/undefined (to indicate the removal of that node
85
- * from the output).
86
- *
87
- * If a visitor function is *not* defined for a kind, a default traversal is
88
- * used to evaluate its children.
89
- *
90
- * The `stateInitializer` argument accepts an optional function to construct the
91
- * state for each document (fragment or root) in the context. Any documents for
92
- * which the initializer returns null/undefined is deleted from the context
93
- * without being traversed.
94
- *
95
- * Example: Alias all scalar fields with the reverse of their name:
96
- *
97
- * ```
98
- * transform(context, {
99
- * ScalarField: visitScalarField,
100
- * });
101
- *
102
- * function visitScalarField(field: ScalarField, state: State): ?ScalarField {
103
- * // Traverse child nodes - for a scalar field these are the arguments &
104
- * // directives.
105
- * const nextField = this.traverse(field, state);
106
- * // Return a new node with a different alias.
107
- * return {
108
- * ...nextField,
109
- * alias: nextField.name.split('').reverse().join(''),
110
- * };
111
- * }
112
- * ```
113
- */
114
- function transform<S>(
115
- context: CompilerContext,
116
- visitor: NodeVisitor<S>,
117
- stateInitializer: void | (CompilerContextDocument => ?S),
118
- ): CompilerContext {
119
- const transformer = new Transformer(context, visitor);
120
- return context.withMutations(ctx => {
121
- let nextContext = ctx;
122
- eachWithCombinedError(context.documents(), prevNode => {
123
- let nextNode;
124
- if (stateInitializer === undefined) {
125
- nextNode = transformer.visit(prevNode, (undefined: $FlowFixMe));
126
- } else {
127
- const state = stateInitializer(prevNode);
128
- if (state != null) {
129
- nextNode = transformer.visit(prevNode, state);
130
- }
131
- }
132
- if (!nextNode) {
133
- nextContext = nextContext.remove(prevNode.name);
134
- } else if (nextNode !== prevNode) {
135
- nextContext = nextContext.replace(nextNode);
136
- }
137
- });
138
- return nextContext;
139
- });
140
- }
141
-
142
- /**
143
- * @internal
144
- */
145
- class Transformer<S> {
146
- _context: CompilerContext;
147
- _states: Array<S>;
148
- _visitor: NodeVisitor<S>;
149
-
150
- constructor(context: CompilerContext, visitor: NodeVisitor<S>) {
151
- this._context = context;
152
- this._states = [];
153
- this._visitor = visitor;
154
- }
155
-
156
- /**
157
- * @public
158
- *
159
- * Returns the original compiler context that is being transformed. This can
160
- * be used to look up fragments by name, for example.
161
- */
162
- getContext(): CompilerContext {
163
- return this._context;
164
- }
165
-
166
- /**
167
- * @public
168
- *
169
- * Transforms the node, calling a user-defined visitor function if defined for
170
- * the node's kind. Uses the given state for this portion of the traversal.
171
- *
172
- * Note: This differs from `traverse` in that it calls a visitor function for
173
- * the node itself.
174
- */
175
- visit<N: IR>(node: N, state: S): ?N {
176
- this._states.push(state);
177
- const nextNode = this._visit(node);
178
- this._states.pop();
179
- return nextNode;
180
- }
181
-
182
- /**
183
- * @public
184
- *
185
- * Transforms the children of the given node, skipping the user-defined
186
- * visitor function for the node itself. Uses the given state for this portion
187
- * of the traversal.
188
- *
189
- * Note: This differs from `visit` in that it does not call a visitor function
190
- * for the node itself.
191
- */
192
- traverse<N: IR>(node: N, state: S): ?N {
193
- this._states.push(state);
194
- const nextNode = this._traverse(node);
195
- this._states.pop();
196
- return nextNode;
197
- }
198
-
199
- _visit<N: IR>(node: N): ?N {
200
- const nodeVisitor = this._visitor[node.kind];
201
- if (nodeVisitor) {
202
- // If a handler for the kind is defined, it is responsible for calling
203
- // `traverse` to transform children as necessary.
204
- const state = this._getState();
205
- const nextNode = nodeVisitor.call(this, (node: $FlowIssue), state);
206
- return (nextNode: $FlowIssue);
207
- }
208
- // Otherwise traverse is called automatically.
209
- return this._traverse(node);
210
- }
211
-
212
- _traverse<N: IR>(prevNode: N): ?N {
213
- let nextNode;
214
- switch (prevNode.kind) {
215
- case 'Argument':
216
- nextNode = this._traverseChildren(prevNode, null, ['value']);
217
- break;
218
- case 'Literal':
219
- case 'LocalArgumentDefinition':
220
- case 'RootArgumentDefinition':
221
- case 'Variable':
222
- nextNode = prevNode;
223
- break;
224
- case 'Defer':
225
- nextNode = this._traverseChildren(prevNode, ['selections'], ['if']);
226
- break;
227
- case 'Stream':
228
- nextNode = this._traverseChildren(
229
- prevNode,
230
- ['selections'],
231
- ['if', 'initialCount'],
232
- );
233
- break;
234
- case 'ClientExtension':
235
- nextNode = this._traverseChildren(prevNode, ['selections']);
236
- break;
237
- case 'Directive':
238
- nextNode = this._traverseChildren(prevNode, ['args']);
239
- break;
240
- case 'ModuleImport':
241
- nextNode = this._traverseChildren(prevNode, ['selections']);
242
- if (!nextNode.selections.length) {
243
- nextNode = null;
244
- }
245
- break;
246
- case 'FragmentSpread':
247
- case 'ScalarField':
248
- nextNode = this._traverseChildren(prevNode, ['args', 'directives']);
249
- break;
250
- case 'InlineDataFragmentSpread':
251
- nextNode = this._traverseChildren(prevNode, ['selections']);
252
- break;
253
- case 'LinkedField':
254
- nextNode = this._traverseChildren(prevNode, [
255
- 'args',
256
- 'directives',
257
- 'selections',
258
- ]);
259
- if (!nextNode.selections.length) {
260
- nextNode = null;
261
- }
262
- break;
263
- case 'ListValue':
264
- nextNode = this._traverseChildren(prevNode, ['items']);
265
- break;
266
- case 'ObjectFieldValue':
267
- nextNode = this._traverseChildren(prevNode, null, ['value']);
268
- break;
269
- case 'ObjectValue':
270
- nextNode = this._traverseChildren(prevNode, ['fields']);
271
- break;
272
- case 'Condition':
273
- nextNode = this._traverseChildren(
274
- prevNode,
275
- ['directives', 'selections'],
276
- ['condition'],
277
- );
278
- if (!nextNode.selections.length) {
279
- nextNode = null;
280
- }
281
- break;
282
- case 'InlineFragment':
283
- nextNode = this._traverseChildren(prevNode, [
284
- 'directives',
285
- 'selections',
286
- ]);
287
- if (!nextNode.selections.length) {
288
- nextNode = null;
289
- }
290
- break;
291
- case 'Fragment':
292
- case 'Root':
293
- nextNode = this._traverseChildren(prevNode, [
294
- 'argumentDefinitions',
295
- 'directives',
296
- 'selections',
297
- ]);
298
- break;
299
- case 'Request':
300
- nextNode = this._traverseChildren(prevNode, null, ['fragment', 'root']);
301
- break;
302
- case 'SplitOperation':
303
- nextNode = this._traverseChildren(prevNode, ['selections']);
304
- break;
305
- default:
306
- (prevNode: empty);
307
- invariant(false, 'IRTransformer: Unknown kind `%s`.', prevNode.kind);
308
- }
309
- return nextNode;
310
- }
311
-
312
- _traverseChildren<N: IR>(
313
- prevNode: N,
314
- pluralKeys: ?Array<string>,
315
- singularKeys?: Array<string>,
316
- ): N {
317
- let nextNode;
318
- pluralKeys &&
319
- pluralKeys.forEach(key => {
320
- const prevItems = prevNode[key];
321
- if (!prevItems) {
322
- return;
323
- }
324
- invariant(
325
- Array.isArray(prevItems),
326
- 'IRTransformer: Expected data for `%s` to be an array, got `%s`.',
327
- key,
328
- prevItems,
329
- );
330
- const nextItems = this._map(prevItems);
331
- if (nextNode || nextItems !== prevItems) {
332
- nextNode = nextNode || {...prevNode};
333
- nextNode[key] = nextItems;
334
- }
335
- });
336
- singularKeys &&
337
- singularKeys.forEach(key => {
338
- const prevItem = prevNode[key];
339
- if (!prevItem) {
340
- return;
341
- }
342
- const nextItem = this._visit(prevItem);
343
- if (nextNode || nextItem !== prevItem) {
344
- nextNode = nextNode || {...prevNode};
345
- nextNode[key] = nextItem;
346
- }
347
- });
348
- return nextNode || prevNode;
349
- }
350
-
351
- _map<N: IR>(prevItems: Array<N>): Array<N> {
352
- let nextItems;
353
- prevItems.forEach((prevItem, index) => {
354
- const nextItem = this._visit(prevItem);
355
- if (nextItems || nextItem !== prevItem) {
356
- nextItems = nextItems || prevItems.slice(0, index);
357
- if (nextItem) {
358
- nextItems.push(nextItem);
359
- }
360
- }
361
- });
362
- return nextItems || prevItems;
363
- }
364
-
365
- _getState(): S {
366
- invariant(
367
- this._states.length,
368
- 'IRTransformer: Expected a current state to be set but found none. ' +
369
- 'This is usually the result of mismatched number of pushState()/popState() ' +
370
- 'calls.',
371
- );
372
- return this._states[this._states.length - 1];
373
- }
374
- }
375
-
376
- module.exports = {transform};
@@ -1,259 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- *
7
- * @flow strict-local
8
- * @format
9
- */
10
-
11
- // flowlint ambiguous-object-type:error
12
-
13
- 'use strict';
14
-
15
- import type CompilerContext, {CompilerContextDocument} from './CompilerContext';
16
- import type {
17
- Argument,
18
- ClientExtension,
19
- Condition,
20
- Defer,
21
- Directive,
22
- Fragment,
23
- FragmentSpread,
24
- InlineDataFragmentSpread,
25
- InlineFragment,
26
- IR,
27
- LinkedField,
28
- ListValue,
29
- Literal,
30
- LocalArgumentDefinition,
31
- ModuleImport,
32
- ObjectFieldValue,
33
- ObjectValue,
34
- Request,
35
- Root,
36
- RootArgumentDefinition,
37
- ScalarField,
38
- SplitOperation,
39
- Stream,
40
- Variable,
41
- } from './IR';
42
-
43
- const {eachWithCombinedError} = require('./CompilerError');
44
- const invariant = require('invariant');
45
-
46
- type NodeVisitor<S> = {|
47
- Argument?: NodeVisitorFunction<Argument, S>,
48
- ClientExtension?: NodeVisitorFunction<ClientExtension, S>,
49
- Condition?: NodeVisitorFunction<Condition, S>,
50
- Defer?: NodeVisitorFunction<Defer, S>,
51
- Directive?: NodeVisitorFunction<Directive, S>,
52
- Fragment?: NodeVisitorFunction<Fragment, S>,
53
- FragmentSpread?: NodeVisitorFunction<FragmentSpread, S>,
54
- InlineFragment?: NodeVisitorFunction<InlineFragment, S>,
55
- LinkedField?: NodeVisitorFunction<LinkedField, S>,
56
- ListValue?: NodeVisitorFunction<ListValue, S>,
57
- Literal?: NodeVisitorFunction<Literal, S>,
58
- LocalArgumentDefinition?: NodeVisitorFunction<LocalArgumentDefinition, S>,
59
- ModuleImport?: NodeVisitorFunction<ModuleImport, S>,
60
- ObjectFieldValue?: NodeVisitorFunction<ObjectFieldValue, S>,
61
- ObjectValue?: NodeVisitorFunction<ObjectValue, S>,
62
- Request?: NodeVisitorFunction<Request, S>,
63
- Root?: NodeVisitorFunction<Root, S>,
64
- InlineDataFragmentSpread?: NodeVisitorFunction<InlineDataFragmentSpread, S>,
65
- RootArgumentDefinition?: NodeVisitorFunction<RootArgumentDefinition, S>,
66
- ScalarField?: NodeVisitorFunction<ScalarField, S>,
67
- SplitOperation?: NodeVisitorFunction<SplitOperation, S>,
68
- Stream?: NodeVisitorFunction<Stream, S>,
69
- Variable?: NodeVisitorFunction<Variable, S>,
70
- |};
71
- type NodeVisitorFunction<N: IR, S> = (node: N, state: S) => void;
72
-
73
- /**
74
- * @public
75
- *
76
- * Helper for writing AST validators that shares the same logic with
77
- * the transfomer
78
- *
79
- */
80
- function validate<S>(
81
- context: CompilerContext,
82
- visitor: NodeVisitor<S>,
83
- stateInitializer: void | (CompilerContextDocument => ?S),
84
- ): void {
85
- const validator = new Validator(context, visitor);
86
- eachWithCombinedError(context.documents(), prevNode => {
87
- if (stateInitializer === undefined) {
88
- validator.visit(prevNode, (undefined: $FlowFixMe));
89
- } else {
90
- const state = stateInitializer(prevNode);
91
- if (state != null) {
92
- validator.visit(prevNode, state);
93
- }
94
- }
95
- });
96
- }
97
-
98
- /**
99
- * @internal
100
- */
101
- class Validator<S> {
102
- _context: CompilerContext;
103
- _states: Array<S>;
104
- _visitor: NodeVisitor<S>;
105
-
106
- constructor(context: CompilerContext, visitor: NodeVisitor<S>) {
107
- this._context = context;
108
- this._states = [];
109
- this._visitor = visitor;
110
- }
111
-
112
- getContext(): CompilerContext {
113
- return this._context;
114
- }
115
-
116
- visit<N: IR>(node: N, state: S): void {
117
- this._states.push(state);
118
- this._visit(node);
119
- this._states.pop();
120
- }
121
-
122
- traverse<N: IR>(node: N, state: S): void {
123
- this._states.push(state);
124
- this._traverse(node);
125
- this._states.pop();
126
- }
127
-
128
- _visit<N: IR>(node: N): void {
129
- const nodeVisitor = this._visitor[node.kind];
130
- if (nodeVisitor) {
131
- // If a handler for the kind is defined, it is responsible for calling
132
- // `traverse` to transform children as necessary.
133
- const state = this._getState();
134
- nodeVisitor.call(this, (node: $FlowIssue), state);
135
- return;
136
- }
137
- // Otherwise traverse is called automatically.
138
- this._traverse(node);
139
- }
140
-
141
- _traverse<N: IR>(prevNode: N): void {
142
- switch (prevNode.kind) {
143
- case 'Argument':
144
- this._traverseChildren(prevNode, null, ['value']);
145
- break;
146
- case 'Literal':
147
- case 'LocalArgumentDefinition':
148
- case 'RootArgumentDefinition':
149
- case 'Variable':
150
- break;
151
- case 'Defer':
152
- this._traverseChildren(prevNode, ['selections'], ['if']);
153
- break;
154
- case 'Stream':
155
- this._traverseChildren(
156
- prevNode,
157
- ['selections'],
158
- ['if', 'initialCount'],
159
- );
160
- break;
161
- case 'ClientExtension':
162
- this._traverseChildren(prevNode, ['selections']);
163
- break;
164
- case 'Directive':
165
- this._traverseChildren(prevNode, ['args']);
166
- break;
167
- case 'ModuleImport':
168
- this._traverseChildren(prevNode, ['selections']);
169
- break;
170
- case 'FragmentSpread':
171
- case 'ScalarField':
172
- this._traverseChildren(prevNode, ['args', 'directives']);
173
- break;
174
- case 'InlineDataFragmentSpread':
175
- this._traverseChildren(prevNode, ['selections']);
176
- break;
177
- case 'LinkedField':
178
- this._traverseChildren(prevNode, ['args', 'directives', 'selections']);
179
- break;
180
- case 'ListValue':
181
- this._traverseChildren(prevNode, ['items']);
182
- break;
183
- case 'ObjectFieldValue':
184
- this._traverseChildren(prevNode, null, ['value']);
185
- break;
186
- case 'ObjectValue':
187
- this._traverseChildren(prevNode, ['fields']);
188
- break;
189
- case 'Condition':
190
- this._traverseChildren(
191
- prevNode,
192
- ['directives', 'selections'],
193
- ['condition'],
194
- );
195
- break;
196
- case 'InlineFragment':
197
- this._traverseChildren(prevNode, ['directives', 'selections']);
198
- break;
199
- case 'Fragment':
200
- case 'Root':
201
- this._traverseChildren(prevNode, [
202
- 'argumentDefinitions',
203
- 'directives',
204
- 'selections',
205
- ]);
206
- break;
207
- case 'Request':
208
- this._traverseChildren(prevNode, null, ['fragment', 'root']);
209
- break;
210
- case 'SplitOperation':
211
- this._traverseChildren(prevNode, ['selections']);
212
- break;
213
- default:
214
- (prevNode: empty);
215
- invariant(false, 'IRValidator: Unknown kind `%s`.', prevNode.kind);
216
- }
217
- }
218
-
219
- _traverseChildren<N: IR>(
220
- prevNode: N,
221
- pluralKeys: ?Array<string>,
222
- singularKeys?: Array<string>,
223
- ): void {
224
- pluralKeys &&
225
- pluralKeys.forEach(key => {
226
- const prevItems = prevNode[key];
227
- if (!prevItems) {
228
- return;
229
- }
230
- invariant(
231
- Array.isArray(prevItems),
232
- 'IRValidator: Expected data for `%s` to be an array, got `%s`.',
233
- key,
234
- prevItems,
235
- );
236
- prevItems.forEach(prevItem => this._visit(prevItem));
237
- });
238
- singularKeys &&
239
- singularKeys.forEach(key => {
240
- const prevItem = prevNode[key];
241
- if (!prevItem) {
242
- return;
243
- }
244
- this._visit(prevItem);
245
- });
246
- }
247
-
248
- _getState(): S {
249
- invariant(
250
- this._states.length,
251
- 'IRValidator: Expected a current state to be set but found none. ' +
252
- 'This is usually the result of mismatched number of pushState()/popState() ' +
253
- 'calls.',
254
- );
255
- return this._states[this._states.length - 1];
256
- }
257
- }
258
-
259
- module.exports = {validate};