@mpeggroup/mpeg-sdl-parser 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +337 -0
  3. package/bun.lock +65 -0
  4. package/dist/index.js +11829 -0
  5. package/grammar/sdl.ebnf.grammar +399 -0
  6. package/grammar/sdl.lezer.grammar +629 -0
  7. package/index.ts +83 -0
  8. package/package.json +61 -0
  9. package/src/analyser/checks/check-array-definition.ts +90 -0
  10. package/src/analyser/checks/check-array-element-access.ts +31 -0
  11. package/src/analyser/checks/check-class-declaration.ts +417 -0
  12. package/src/analyser/checks/check-computed-array-definition.ts +44 -0
  13. package/src/analyser/checks/check-computed-elementary-type-definition.ts +45 -0
  14. package/src/analyser/checks/check-elementary-type-definition.ts +167 -0
  15. package/src/analyser/checks/check-expression-binary.ts +242 -0
  16. package/src/analyser/checks/check-expression-lengthof.ts +34 -0
  17. package/src/analyser/checks/check-expression-unary.ts +166 -0
  18. package/src/analyser/checks/check-identifier.ts +71 -0
  19. package/src/analyser/checks/check-if-statement.ts +164 -0
  20. package/src/analyser/checks/check-map-declaration.ts +180 -0
  21. package/src/analyser/checks/check-map-definition.ts +118 -0
  22. package/src/analyser/checks/check-number-literal-float.ts +28 -0
  23. package/src/analyser/checks/check-parameter-list.ts +42 -0
  24. package/src/analyser/checks/check-specification.ts +53 -0
  25. package/src/analyser/checks/check-switch-statement.ts +206 -0
  26. package/src/analyser/checks/check.ts +20 -0
  27. package/src/analyser/create-sdl-analyser.ts +85 -0
  28. package/src/analyser/node-handler/abstract-analysis-node-handler.ts +626 -0
  29. package/src/analyser/node-handler/build-symbol-table-node-handler.ts +649 -0
  30. package/src/analyser/node-handler/specific-check-node-handler.ts +46 -0
  31. package/src/analyser/node-handler/validate-scope-node-handler.ts +290 -0
  32. package/src/analyser/node-handler/validate-type-node-handler.ts +497 -0
  33. package/src/analyser/sdl-analyser.ts +119 -0
  34. package/src/analyser/symbol-table.ts +388 -0
  35. package/src/analyser/util/symbol-table-utils.ts +458 -0
  36. package/src/analyser/util/type-utils.ts +238 -0
  37. package/src/ast/build/consume/consume-abstract-node.ts +199 -0
  38. package/src/ast/build/consume/consume-ast-node.ts +400 -0
  39. package/src/ast/build/consume/consume-primitive.ts +59 -0
  40. package/src/ast/build/consume/consume-trivia.ts +96 -0
  41. package/src/ast/build/consume/consume-white-space-and-missing-errors.ts +27 -0
  42. package/src/ast/build/node/build-aggregate-output-value.ts +57 -0
  43. package/src/ast/build/node/build-aligned-modifier.ts +99 -0
  44. package/src/ast/build/node/build-array-definition.ts +131 -0
  45. package/src/ast/build/node/build-array-element-access.ts +45 -0
  46. package/src/ast/build/node/build-base64-string-literal.ts +41 -0
  47. package/src/ast/build/node/build-binary-expression.ts +113 -0
  48. package/src/ast/build/node/build-binary-literal.ts +37 -0
  49. package/src/ast/build/node/build-bit-modifier.ts +86 -0
  50. package/src/ast/build/node/build-case-clause.ts +101 -0
  51. package/src/ast/build/node/build-class-declaration.ts +124 -0
  52. package/src/ast/build/node/build-class-definition.ts +56 -0
  53. package/src/ast/build/node/build-class-id-range.ts +32 -0
  54. package/src/ast/build/node/build-class-id.ts +19 -0
  55. package/src/ast/build/node/build-class-member-access.ts +27 -0
  56. package/src/ast/build/node/build-compound-statement.ts +33 -0
  57. package/src/ast/build/node/build-computed-array-definition.ts +53 -0
  58. package/src/ast/build/node/build-computed-elementary-type-definition.ts +100 -0
  59. package/src/ast/build/node/build-decimal-literal.ts +15 -0
  60. package/src/ast/build/node/build-default-clause.ts +76 -0
  61. package/src/ast/build/node/build-do-statement.ts +71 -0
  62. package/src/ast/build/node/build-elementary-type-definition.ts +164 -0
  63. package/src/ast/build/node/build-elementary-type-output-value.ts +25 -0
  64. package/src/ast/build/node/build-elementary-type.ts +36 -0
  65. package/src/ast/build/node/build-expandable-modifier.ts +68 -0
  66. package/src/ast/build/node/build-explicit-array-dimension.ts +37 -0
  67. package/src/ast/build/node/build-expression-statement.ts +31 -0
  68. package/src/ast/build/node/build-extended-class-id-range.ts +27 -0
  69. package/src/ast/build/node/build-extends-modifier.ts +41 -0
  70. package/src/ast/build/node/build-floating-point-literal.ts +15 -0
  71. package/src/ast/build/node/build-for-statement.ts +117 -0
  72. package/src/ast/build/node/build-hexadecimal-literal.ts +38 -0
  73. package/src/ast/build/node/build-identifier.ts +8 -0
  74. package/src/ast/build/node/build-if-statement.ts +82 -0
  75. package/src/ast/build/node/build-implicit-array-dimension.ts +78 -0
  76. package/src/ast/build/node/build-integer-literal.ts +15 -0
  77. package/src/ast/build/node/build-length-attribute.ts +48 -0
  78. package/src/ast/build/node/build-lengthof-expression.ts +45 -0
  79. package/src/ast/build/node/build-map-declaration.ts +110 -0
  80. package/src/ast/build/node/build-map-definition.ts +103 -0
  81. package/src/ast/build/node/build-map-entry.ts +33 -0
  82. package/src/ast/build/node/build-missing-error.ts +10 -0
  83. package/src/ast/build/node/build-multiple-character-literal.ts +65 -0
  84. package/src/ast/build/node/build-parameter-list.ts +50 -0
  85. package/src/ast/build/node/build-parameter-value-list.ts +54 -0
  86. package/src/ast/build/node/build-parameter.ts +47 -0
  87. package/src/ast/build/node/build-partial-array-dimension.ts +55 -0
  88. package/src/ast/build/node/build-specification.ts +24 -0
  89. package/src/ast/build/node/build-string-definition.ts +106 -0
  90. package/src/ast/build/node/build-switch-statement.ts +84 -0
  91. package/src/ast/build/node/build-token.ts +26 -0
  92. package/src/ast/build/node/build-unary-expression.ts +109 -0
  93. package/src/ast/build/node/build-unexpected-error.ts +14 -0
  94. package/src/ast/build/node/build-utf-string-literal.ts +110 -0
  95. package/src/ast/build/node/build-while-statement.ts +55 -0
  96. package/src/ast/build/util/array-dimension-kind-by-token-type-id-map.ts +167 -0
  97. package/src/ast/build/util/binary-operator-kind-by-token-type-id-map.ts +152 -0
  98. package/src/ast/build/util/build-context.ts +36 -0
  99. package/src/ast/build/util/class-id-kind-by-token-type-id-map.ts +160 -0
  100. package/src/ast/build/util/expression-kind-by-token-type-id-map.ts +168 -0
  101. package/src/ast/build/util/fetch-node.ts +433 -0
  102. package/src/ast/build/util/node-kind-by-token-type-id-map.ts +202 -0
  103. package/src/ast/build/util/statement-kind-by-token-type-id-map.ts +210 -0
  104. package/src/ast/build/util/string-literal-kind-by-token-type-id-map.ts +162 -0
  105. package/src/ast/build/util/token-kind-by-token-type-id-map.ts +337 -0
  106. package/src/ast/build-ast.ts +114 -0
  107. package/src/ast/node/abstract-array-definition.ts +17 -0
  108. package/src/ast/node/abstract-array-dimension.ts +20 -0
  109. package/src/ast/node/abstract-class-id.ts +13 -0
  110. package/src/ast/node/abstract-composite-node.ts +58 -0
  111. package/src/ast/node/abstract-elementary-type-definition.ts +29 -0
  112. package/src/ast/node/abstract-expression.ts +13 -0
  113. package/src/ast/node/abstract-leaf-node.ts +10 -0
  114. package/src/ast/node/abstract-node.ts +16 -0
  115. package/src/ast/node/abstract-statement.ts +13 -0
  116. package/src/ast/node/aggregate-output-value.ts +28 -0
  117. package/src/ast/node/aligned-modifier.ts +21 -0
  118. package/src/ast/node/array-definition.ts +44 -0
  119. package/src/ast/node/array-element-access.ts +24 -0
  120. package/src/ast/node/binary-expression.ts +28 -0
  121. package/src/ast/node/bit-modifier.ts +24 -0
  122. package/src/ast/node/case-clause.ts +30 -0
  123. package/src/ast/node/class-declaration.ts +39 -0
  124. package/src/ast/node/class-definition.ts +23 -0
  125. package/src/ast/node/class-id-range.ts +17 -0
  126. package/src/ast/node/class-id.ts +14 -0
  127. package/src/ast/node/class-member-access.ts +19 -0
  128. package/src/ast/node/compound-statement.ts +19 -0
  129. package/src/ast/node/computed-array-definition.ts +26 -0
  130. package/src/ast/node/computed-elementary-type-definition.ts +34 -0
  131. package/src/ast/node/default-clause.ts +26 -0
  132. package/src/ast/node/do-statement.ts +28 -0
  133. package/src/ast/node/elementary-type-definition.ts +49 -0
  134. package/src/ast/node/elementary-type-output-value.ts +19 -0
  135. package/src/ast/node/elementary-type.ts +18 -0
  136. package/src/ast/node/enum/array-dimension-kind.ts +11 -0
  137. package/src/ast/node/enum/binary-operator-kind.ts +41 -0
  138. package/src/ast/node/enum/class-id-kind.ts +12 -0
  139. package/src/ast/node/enum/elementary-type-kind.ts +13 -0
  140. package/src/ast/node/enum/expression-kind.ts +11 -0
  141. package/src/ast/node/enum/node-kind.ts +57 -0
  142. package/src/ast/node/enum/number-literal-kind.ts +17 -0
  143. package/src/ast/node/enum/statement-kind.ts +37 -0
  144. package/src/ast/node/enum/string-literal-kind.ts +13 -0
  145. package/src/ast/node/enum/string-variable-kind.ts +25 -0
  146. package/src/ast/node/enum/token-kind.ts +87 -0
  147. package/src/ast/node/expandable-modifier.ts +21 -0
  148. package/src/ast/node/explicit-array-dimension.ts +26 -0
  149. package/src/ast/node/expression-statement.ts +23 -0
  150. package/src/ast/node/extended-class-id-range.ts +20 -0
  151. package/src/ast/node/extends-modifier.ts +21 -0
  152. package/src/ast/node/for-statement.ts +29 -0
  153. package/src/ast/node/identifier.ts +12 -0
  154. package/src/ast/node/if-statement.ts +28 -0
  155. package/src/ast/node/implicit-array-dimension.ts +34 -0
  156. package/src/ast/node/length-attribute.ts +24 -0
  157. package/src/ast/node/length-of-expression.ts +21 -0
  158. package/src/ast/node/map-declaration.ts +34 -0
  159. package/src/ast/node/map-definition.ts +27 -0
  160. package/src/ast/node/map-entry.ts +18 -0
  161. package/src/ast/node/missing-error.ts +9 -0
  162. package/src/ast/node/number-literal.ts +18 -0
  163. package/src/ast/node/parameter-list.ts +25 -0
  164. package/src/ast/node/parameter-value-list.ts +29 -0
  165. package/src/ast/node/parameter.ts +20 -0
  166. package/src/ast/node/partial-array-dimension.ts +28 -0
  167. package/src/ast/node/specification.ts +21 -0
  168. package/src/ast/node/string-definition.ts +28 -0
  169. package/src/ast/node/string-literal.ts +21 -0
  170. package/src/ast/node/switch-statement.ts +32 -0
  171. package/src/ast/node/token.ts +20 -0
  172. package/src/ast/node/trivia.ts +13 -0
  173. package/src/ast/node/unary-expression.ts +31 -0
  174. package/src/ast/node/unexpected-error.ts +12 -0
  175. package/src/ast/node/while-statement.ts +26 -0
  176. package/src/ast/util/types.ts +138 -0
  177. package/src/ast/visitor/node-handler.ts +15 -0
  178. package/src/ast/visitor/node-visitor.ts +13 -0
  179. package/src/ast/visitor/traversing-visitor.ts +69 -0
  180. package/src/completion/completion-rules.ts +447 -0
  181. package/src/completion/get-potential-syntactic-tokens.ts +54 -0
  182. package/src/completion/get-potential-token-type-ids.ts +116 -0
  183. package/src/completion/hierarchical-map.ts +43 -0
  184. package/src/completion/rules/abstract-types.ts +174 -0
  185. package/src/completion/rules/aggregate-output-value-rules.ts +48 -0
  186. package/src/completion/rules/aligned-modifier-rules.ts +45 -0
  187. package/src/completion/rules/array-definition-rules.ts +87 -0
  188. package/src/completion/rules/array-element-access-rules.ts +22 -0
  189. package/src/completion/rules/assignment-expression-rules.ts +19 -0
  190. package/src/completion/rules/binary-expression-rules.ts +23 -0
  191. package/src/completion/rules/bit-modifier-rules.ts +25 -0
  192. package/src/completion/rules/case-clause-rules.ts +39 -0
  193. package/src/completion/rules/class-declaration-rules.ts +81 -0
  194. package/src/completion/rules/class-definition-rules.ts +28 -0
  195. package/src/completion/rules/class-id-range-rules.ts +17 -0
  196. package/src/completion/rules/class-id-rules.ts +9 -0
  197. package/src/completion/rules/class-member-access-rules.ts +7 -0
  198. package/src/completion/rules/compound-statement-rules.ts +25 -0
  199. package/src/completion/rules/computed-array-definition-rules.ts +25 -0
  200. package/src/completion/rules/computed-elementary-type-rules.ts +44 -0
  201. package/src/completion/rules/default-clause-rules.ts +23 -0
  202. package/src/completion/rules/do-statement-rules.ts +38 -0
  203. package/src/completion/rules/elementary-type-definition-rules.ts +62 -0
  204. package/src/completion/rules/elementary-type-output-value-rules.ts +13 -0
  205. package/src/completion/rules/elementary-type-rules.ts +18 -0
  206. package/src/completion/rules/expandable-modifier-rules.ts +21 -0
  207. package/src/completion/rules/explicit-array-dimension-rules.ts +22 -0
  208. package/src/completion/rules/expression-statement-rules.ts +22 -0
  209. package/src/completion/rules/extended-class-id-range-rules.ts +17 -0
  210. package/src/completion/rules/extends-modifier-rules.ts +17 -0
  211. package/src/completion/rules/for-statement-rules.ts +51 -0
  212. package/src/completion/rules/if-statement-rules.ts +42 -0
  213. package/src/completion/rules/implicit-array-dimension-rules.ts +21 -0
  214. package/src/completion/rules/length-attribute-rules.ts +19 -0
  215. package/src/completion/rules/lengthof-expression-rules.ts +23 -0
  216. package/src/completion/rules/map-declaration-rules.ts +45 -0
  217. package/src/completion/rules/map-definition-rules.ts +46 -0
  218. package/src/completion/rules/map-entry-rules.ts +17 -0
  219. package/src/completion/rules/parameter-list-rules.ts +21 -0
  220. package/src/completion/rules/parameter-rules.ts +17 -0
  221. package/src/completion/rules/parameter-value-list-rules.ts +27 -0
  222. package/src/completion/rules/partial-array-dimension-rules.ts +33 -0
  223. package/src/completion/rules/specification-rules.ts +37 -0
  224. package/src/completion/rules/string-definition-rules.ts +103 -0
  225. package/src/completion/rules/switch-statement-rules.ts +50 -0
  226. package/src/completion/rules/unary-expression-rules.ts +41 -0
  227. package/src/completion/rules/utf-string-literal-rules.ts +17 -0
  228. package/src/completion/rules/while-statement-rules.ts +38 -0
  229. package/src/lezer/context-tracker.ts +45 -0
  230. package/src/lezer/create-sdl-parser.ts +88 -0
  231. package/src/lezer/create-syntax-error-from-text-and-cursor.ts +110 -0
  232. package/src/lezer/create-syntax-error-from-text-and-position.ts +36 -0
  233. package/src/lezer/parser.terms.ts +129 -0
  234. package/src/lezer/parser.ts +63 -0
  235. package/src/lezer/props/fold-node-prop-source.ts +27 -0
  236. package/src/lezer/props/primitive-node-prop-source.ts +19 -0
  237. package/src/lezer/props/style-tags-node-prop-source.ts +188 -0
  238. package/src/lezer/props/syntactic-token-node-prop-source.ts +298 -0
  239. package/src/lezer/sdl-string-input.ts +46 -0
  240. package/src/location.ts +13 -0
  241. package/src/parse-helper.ts +93 -0
  242. package/src/prettier/prettier-plugin-sdl.ts +89 -0
  243. package/src/prettier/print-abstract-array-dimension.ts +84 -0
  244. package/src/prettier/print-abstract-class-id.ts +53 -0
  245. package/src/prettier/print-abstract-expression.ts +168 -0
  246. package/src/prettier/print-abstract-node.ts +224 -0
  247. package/src/prettier/print-abstract-statement.ts +124 -0
  248. package/src/prettier/print-aggregate-output-value.ts +35 -0
  249. package/src/prettier/print-aligned-modifier.ts +50 -0
  250. package/src/prettier/print-array-definition.ts +95 -0
  251. package/src/prettier/print-array-element-access.ts +14 -0
  252. package/src/prettier/print-bit-modifier.ts +48 -0
  253. package/src/prettier/print-case-clause.ts +58 -0
  254. package/src/prettier/print-class-declaration.ts +99 -0
  255. package/src/prettier/print-class-definition.ts +44 -0
  256. package/src/prettier/print-class-member-access.ts +13 -0
  257. package/src/prettier/print-computed-array-definition.ts +33 -0
  258. package/src/prettier/print-computed-elementary-type-definition.ts +60 -0
  259. package/src/prettier/print-default-clause.ts +39 -0
  260. package/src/prettier/print-do-statement.ts +31 -0
  261. package/src/prettier/print-elementary-type-definition.ts +108 -0
  262. package/src/prettier/print-elementary-type-output-value.ts +13 -0
  263. package/src/prettier/print-elementary-type.ts +28 -0
  264. package/src/prettier/print-expandable-modifier.ts +41 -0
  265. package/src/prettier/print-extends-modifier.ts +29 -0
  266. package/src/prettier/print-for-statement.ts +64 -0
  267. package/src/prettier/print-identifier.ts +10 -0
  268. package/src/prettier/print-if-statement.ts +76 -0
  269. package/src/prettier/print-length-attribute.ts +14 -0
  270. package/src/prettier/print-map-declaration.ts +75 -0
  271. package/src/prettier/print-map-definition.ts +67 -0
  272. package/src/prettier/print-map-entry.ts +22 -0
  273. package/src/prettier/print-number-literal.ts +84 -0
  274. package/src/prettier/print-parameter-list.ts +20 -0
  275. package/src/prettier/print-parameter-value-list.ts +20 -0
  276. package/src/prettier/print-parameter.ts +34 -0
  277. package/src/prettier/print-specification.ts +51 -0
  278. package/src/prettier/print-string-definition.ts +114 -0
  279. package/src/prettier/print-string-literal.ts +57 -0
  280. package/src/prettier/print-switch-statement.ts +46 -0
  281. package/src/prettier/print-token.ts +7 -0
  282. package/src/prettier/print-unexpected-error.ts +10 -0
  283. package/src/prettier/print-while-statement.ts +26 -0
  284. package/src/prettier/util/print-utils.ts +607 -0
  285. package/src/prettier/util/types.ts +40 -0
  286. package/src/scanner-error.ts +65 -0
  287. package/src/util/location-utils.ts +16 -0
  288. package/src/util/logger.ts +165 -0
  289. package/tests/analyser/create-sdl-analyser.test.ts +54 -0
  290. package/tests/analyser/get-sdl-analyser-test-scenarios.ts +80 -0
  291. package/tests/analyser/sdl-analyser-scenarios.test.ts +67 -0
  292. package/tests/analyser/semantic-error-scenarios.test.ts +40 -0
  293. package/tests/analyser/symbol-table.test.ts +188 -0
  294. package/tests/analyser/test-cases/array_definition.txt +50 -0
  295. package/tests/analyser/test-cases/class_declaration.txt +112 -0
  296. package/tests/analyser/test-cases/class_definition.txt +60 -0
  297. package/tests/analyser/test-cases/compound_statement.txt +63 -0
  298. package/tests/analyser/test-cases/computed_array_definition.txt +12 -0
  299. package/tests/analyser/test-cases/computed_elementary_type_definition.txt +39 -0
  300. package/tests/analyser/test-cases/do_statement.txt +16 -0
  301. package/tests/analyser/test-cases/elementary_type_definition.txt +58 -0
  302. package/tests/analyser/test-cases/expression.txt +159 -0
  303. package/tests/analyser/test-cases/for_statement.txt +55 -0
  304. package/tests/analyser/test-cases/if_statement.txt +57 -0
  305. package/tests/analyser/test-cases/map_declaration.txt +89 -0
  306. package/tests/analyser/test-cases/map_definition.txt +35 -0
  307. package/tests/analyser/test-cases/number_literal.txt +31 -0
  308. package/tests/analyser/test-cases/parameter_list.txt +16 -0
  309. package/tests/analyser/test-cases/scopes.txt +239 -0
  310. package/tests/analyser/test-cases/specification.txt +28 -0
  311. package/tests/analyser/test-cases/string_definition.txt +40 -0
  312. package/tests/analyser/test-cases/switch_statement.txt +96 -0
  313. package/tests/analyser/test-cases/while_statement.txt +16 -0
  314. package/tests/analyser/util/symbol-table-utils.test.ts +65 -0
  315. package/tests/ast/__snapshots__/build-ast.test.ts.snap +38897 -0
  316. package/tests/ast/build-ast.test.ts +463 -0
  317. package/tests/ast/visitor/traversing-visitor.test.ts +36 -0
  318. package/tests/completion/get-potential-syntactic-tokens.test.ts +89 -0
  319. package/tests/completion/get-potential-token-type-ids.test.ts +76 -0
  320. package/tests/completion/test-potential-syntactic-tokens-scenario.ts +24 -0
  321. package/tests/completion/test-potential-token-type-ids-scenario.ts +33 -0
  322. package/tests/fixtures/history-recording-node-handler.ts +232 -0
  323. package/tests/lezer/create-parse-error-from-text-and-position.test.ts +129 -0
  324. package/tests/lezer/create-sdl-parser.test.ts +15 -0
  325. package/tests/lezer/sdl-parser-scenarios.test.ts +24 -0
  326. package/tests/lezer/sdl-string-input.test.ts +12 -0
  327. package/tests/lezer/syntax-error-scenarios.test.ts +114 -0
  328. package/tests/lezer/test-cases/array_definition.txt +109 -0
  329. package/tests/lezer/test-cases/class_declaration.txt +141 -0
  330. package/tests/lezer/test-cases/class_definition.txt +89 -0
  331. package/tests/lezer/test-cases/comment.txt +335 -0
  332. package/tests/lezer/test-cases/compound_statement.txt +109 -0
  333. package/tests/lezer/test-cases/computed_array_definition.txt +33 -0
  334. package/tests/lezer/test-cases/computed_elementary_type_definition.txt +59 -0
  335. package/tests/lezer/test-cases/do_statement.txt +48 -0
  336. package/tests/lezer/test-cases/elementary_type_definition.txt +158 -0
  337. package/tests/lezer/test-cases/expression.txt +1203 -0
  338. package/tests/lezer/test-cases/for_statement.txt +183 -0
  339. package/tests/lezer/test-cases/if_statement.txt +183 -0
  340. package/tests/lezer/test-cases/invalid.txt +97 -0
  341. package/tests/lezer/test-cases/map_declaration.txt +152 -0
  342. package/tests/lezer/test-cases/map_definition.txt +59 -0
  343. package/tests/lezer/test-cases/number_literal.txt +273 -0
  344. package/tests/lezer/test-cases/specification.txt +38 -0
  345. package/tests/lezer/test-cases/string_definition.txt +263 -0
  346. package/tests/lezer/test-cases/string_literal.txt +303 -0
  347. package/tests/lezer/test-cases/switch_statement.txt +407 -0
  348. package/tests/lezer/test-cases/while_statement.txt +45 -0
  349. package/tests/parse-helper.test.ts +361 -0
  350. package/tests/prettier/__snapshots__/prettier-plugin-sdl.test.ts.snap +127 -0
  351. package/tests/prettier/prettier-plugin-sdl.test.ts +58 -0
  352. package/tests/prettier/print-array.test.ts +29 -0
  353. package/tests/prettier/print-class.test.ts +15 -0
  354. package/tests/prettier/print-do.test.ts +25 -0
  355. package/tests/prettier/print-elementary-type.test.ts +62 -0
  356. package/tests/prettier/print-error.test.ts +40 -0
  357. package/tests/prettier/print-expression.test.ts +17 -0
  358. package/tests/prettier/print-for.test.ts +23 -0
  359. package/tests/prettier/print-if.test.ts +71 -0
  360. package/tests/prettier/print-number-literal.test.ts +28 -0
  361. package/tests/prettier/print-specification.test.ts +54 -0
  362. package/tests/prettier/print-string.test.ts +36 -0
  363. package/tests/prettier/print-switch.test.ts +69 -0
  364. package/tests/prettier/print-while.test.ts +23 -0
  365. package/tests/prettier/test-prettier-scenario.ts +41 -0
  366. package/tests/prettier/util/print-utils.test.ts +665 -0
  367. package/tests/prettier/util/types.test.ts +38 -0
  368. package/tests/sample-specifications/invalid.sdl +24 -0
  369. package/tests/sample-specifications/prettified-invalid.sdl +28 -0
  370. package/tests/sample-specifications/prettified-various-elements-narrow.sdl +97 -0
  371. package/tests/sample-specifications/prettified-various-elements.sdl +90 -0
  372. package/tests/sample-specifications/sample.sdl +24 -0
  373. package/tests/sample-specifications/various-elements.sdl +88 -0
  374. package/tests/util/logger.test.ts +36 -0
  375. package/tsconfig.json +29 -0
@@ -0,0 +1,99 @@
1
+ import { type AstPath, type Doc, doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import {
4
+ addBreakingWhitespace,
5
+ addIndentedStatements,
6
+ addNonBreakingWhitespace,
7
+ } from "./util/print-utils.ts";
8
+ import type { ClassDeclaration } from "../ast/node/class-declaration.ts";
9
+
10
+ const { fill } = doc.builders;
11
+
12
+ export function printClassDeclaration(
13
+ path: AstPath<ClassDeclaration>,
14
+ print: (path: AstPath<AbstractNode>) => Doc,
15
+ ): Doc {
16
+ const classDeclaration = path.node;
17
+ let doc: Doc = [];
18
+
19
+ if (classDeclaration.alignedModifier !== undefined) {
20
+ doc.push(
21
+ path.call(
22
+ print,
23
+ "alignedModifier" as keyof ClassDeclaration["alignedModifier"],
24
+ ),
25
+ );
26
+ addNonBreakingWhitespace(doc);
27
+ }
28
+
29
+ if (classDeclaration.expandableModifier !== undefined) {
30
+ doc.push(
31
+ path.call(
32
+ print,
33
+ "expandableModifier" as keyof ClassDeclaration["expandableModifier"],
34
+ ),
35
+ );
36
+ addNonBreakingWhitespace(doc);
37
+ }
38
+
39
+ if (classDeclaration.abstractKeyword) {
40
+ doc.push(
41
+ path.call(
42
+ print,
43
+ "abstractKeyword" as keyof ClassDeclaration["abstractKeyword"],
44
+ ),
45
+ );
46
+ addNonBreakingWhitespace(doc);
47
+ }
48
+
49
+ doc.push(
50
+ path.call(print, "classKeyword"),
51
+ );
52
+
53
+ addNonBreakingWhitespace(doc);
54
+
55
+ const identifierDoc: Doc = [];
56
+ identifierDoc.push(path.call(print, "identifier"));
57
+
58
+ if (classDeclaration.parameterList !== undefined) {
59
+ identifierDoc.push(
60
+ path.call(
61
+ print,
62
+ "parameterList" as keyof ClassDeclaration["parameterList"],
63
+ ),
64
+ );
65
+ }
66
+ doc.push(identifierDoc);
67
+ doc = addBreakingWhitespace(doc);
68
+
69
+ if (classDeclaration.extendsModifier !== undefined) {
70
+ doc.push(fill(
71
+ path.call(
72
+ print,
73
+ "extendsModifier" as keyof ClassDeclaration["extendsModifier"],
74
+ ) as Doc[],
75
+ ));
76
+ doc = addBreakingWhitespace(doc);
77
+ }
78
+
79
+ if (classDeclaration.bitModifier !== undefined) {
80
+ doc.push(fill(
81
+ path.call(
82
+ print,
83
+ "bitModifier" as keyof ClassDeclaration["bitModifier"],
84
+ ) as Doc[],
85
+ ));
86
+ doc = addBreakingWhitespace(doc);
87
+ }
88
+
89
+ const statementsDoc = path.map(print, "statements");
90
+
91
+ doc = addIndentedStatements(
92
+ doc,
93
+ statementsDoc,
94
+ path.call(print, "openBracePunctuator"),
95
+ path.call(print, "closeBracePunctuator"),
96
+ );
97
+
98
+ return fill(doc);
99
+ }
@@ -0,0 +1,44 @@
1
+ import type { AstPath, Doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ClassDefinition } from "../ast/node/class-definition.ts";
4
+ import { addNonBreakingWhitespace } from "./util/print-utils.ts";
5
+
6
+ export function printClassDefinition(
7
+ path: AstPath<ClassDefinition>,
8
+ print: (path: AstPath<AbstractNode>) => Doc,
9
+ ): Doc {
10
+ const classDefinition = path.node;
11
+
12
+ const doc: Doc = [];
13
+
14
+ if (classDefinition.legacyKeyword) {
15
+ doc.push(
16
+ path.call(
17
+ print,
18
+ "legacyKeyword" as keyof ClassDefinition["legacyKeyword"],
19
+ ),
20
+ );
21
+ addNonBreakingWhitespace(doc);
22
+ }
23
+
24
+ doc.push(path.call(print, "classIdentifier"));
25
+ addNonBreakingWhitespace(doc);
26
+
27
+ const identifierDoc = [
28
+ path.call(print, "identifier"),
29
+ ];
30
+
31
+ if (classDefinition.parameterValueList !== undefined) {
32
+ identifierDoc.push([
33
+ path.call(
34
+ print,
35
+ "parameterValueList" as keyof ClassDefinition["parameterValueList"],
36
+ ),
37
+ ]);
38
+ }
39
+
40
+ doc.push(identifierDoc);
41
+ doc.push(path.call(print, "semicolonPunctuator"));
42
+
43
+ return doc;
44
+ }
@@ -0,0 +1,13 @@
1
+ import type { AstPath, Doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ClassMemberAccess } from "../ast/node/class-member-access.ts";
4
+
5
+ export function printClassMemberAccess(
6
+ path: AstPath<ClassMemberAccess>,
7
+ print: (path: AstPath<AbstractNode>) => Doc,
8
+ ): Doc {
9
+ return [
10
+ path.call(print, "classMemberAccessOperator"),
11
+ path.call(print, "memberIdentifier"),
12
+ ];
13
+ }
@@ -0,0 +1,33 @@
1
+ import { type AstPath, type Doc, doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ComputedArrayDefinition } from "../ast/node/computed-array-definition.ts";
4
+ import {
5
+ addBreakingWhitespace,
6
+ addNonBreakingWhitespace,
7
+ } from "./util/print-utils.ts";
8
+
9
+ const { fill } = doc.builders;
10
+
11
+ export function printComputedArrayDefinition(
12
+ path: AstPath<ComputedArrayDefinition>,
13
+ print: (path: AstPath<AbstractNode>) => Doc,
14
+ ): Doc {
15
+ let doc: Doc = [];
16
+
17
+ doc.push(path.call(print, "computedKeyword"));
18
+
19
+ addNonBreakingWhitespace(doc);
20
+
21
+ doc.push(path.call(print, "elementaryType"));
22
+
23
+ doc = addBreakingWhitespace(doc);
24
+
25
+ const identifierClause = [path.call(print, "identifier")];
26
+
27
+ identifierClause.push(path.map(print, "dimensions"));
28
+ identifierClause.push(path.call(print, "semicolonPunctuator"));
29
+
30
+ doc.push(identifierClause);
31
+
32
+ return fill(doc);
33
+ }
@@ -0,0 +1,60 @@
1
+ import { type AstPath, type Doc, doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ComputedElementaryTypeDefinition } from "../ast/node/computed-elementary-type-definition.ts";
4
+ import {
5
+ addBreakingWhitespace,
6
+ addNonBreakingWhitespace,
7
+ } from "./util/print-utils.ts";
8
+
9
+ const { fill } = doc.builders;
10
+
11
+ export function printComputedElementaryTypeDefinition(
12
+ path: AstPath<ComputedElementaryTypeDefinition>,
13
+ print: (path: AstPath<AbstractNode>) => Doc,
14
+ ): Doc {
15
+ const computedElementaryTypeDefinition = path.node;
16
+ let doc: Doc = [];
17
+
18
+ doc.push(path.call(print, "computedKeyword"));
19
+ doc = addBreakingWhitespace(doc);
20
+
21
+ if (computedElementaryTypeDefinition.constKeyword) {
22
+ doc.push(
23
+ path.call(
24
+ print,
25
+ "constKeyword" as keyof ComputedElementaryTypeDefinition[
26
+ "constKeyword"
27
+ ],
28
+ ),
29
+ );
30
+ doc = addBreakingWhitespace(doc);
31
+ }
32
+
33
+ doc.push(path.call(print, "elementaryType"));
34
+ doc = addBreakingWhitespace(doc);
35
+
36
+ doc.push(path.call(print, "identifier"));
37
+
38
+ if (computedElementaryTypeDefinition.value !== undefined) {
39
+ addNonBreakingWhitespace(doc);
40
+ doc.push(
41
+ path.call(
42
+ print,
43
+ "assignmentOperator" as keyof ComputedElementaryTypeDefinition[
44
+ "assignmentOperator"
45
+ ],
46
+ ),
47
+ );
48
+ doc = addBreakingWhitespace(doc);
49
+ doc.push(
50
+ path.call(
51
+ print,
52
+ "value" as keyof ComputedElementaryTypeDefinition["value"],
53
+ ),
54
+ );
55
+ }
56
+
57
+ doc.push(path.call(print, "semicolonPunctuator"));
58
+
59
+ return fill(doc);
60
+ }
@@ -0,0 +1,39 @@
1
+ import type { AstPath, Doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import { addIndentedStatements } from "./util/print-utils.ts";
4
+ import type { DefaultClause } from "../ast/node/default-clause.ts";
5
+
6
+ export function printDefaultClause(
7
+ path: AstPath<DefaultClause>,
8
+ print: (path: AstPath<AbstractNode>) => Doc,
9
+ ): Doc {
10
+ const defaultClause = path.node;
11
+ let doc: Doc = [];
12
+
13
+ doc.push([
14
+ path.call(print, "defaultKeyword"),
15
+ path.call(print, "colonPunctuator"),
16
+ ]);
17
+
18
+ const statementsDoc = path.map(print, "statements");
19
+
20
+ if (defaultClause.openBracePunctuator !== undefined) {
21
+ doc.push(" ");
22
+ doc = addIndentedStatements(
23
+ doc,
24
+ statementsDoc,
25
+ path.call(
26
+ print,
27
+ "openBracePunctuator" as keyof DefaultClause["openBracePunctuator"],
28
+ ),
29
+ path.call(
30
+ print,
31
+ "closeBracePunctuator" as keyof DefaultClause["closeBracePunctuator"],
32
+ ),
33
+ );
34
+ } else {
35
+ doc = addIndentedStatements(doc, statementsDoc);
36
+ }
37
+
38
+ return doc;
39
+ }
@@ -0,0 +1,31 @@
1
+ import { AstPath, type Doc, doc } from "prettier";
2
+ import {
3
+ addBreakingWhitespace,
4
+ addNonBreakingWhitespace,
5
+ } from "./util/print-utils.ts";
6
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
7
+ import type { DoStatement } from "../ast/node/do-statement.ts";
8
+
9
+ const { fill } = doc.builders;
10
+
11
+ export function printDoStatement(
12
+ path: AstPath<DoStatement>,
13
+ print: (path: AstPath<AbstractNode>) => Doc,
14
+ ): Doc {
15
+ let doc: Doc = [];
16
+
17
+ doc.push(path.call(print, "doKeyword"));
18
+ addNonBreakingWhitespace(doc);
19
+ doc.push(path.call(print, "compoundStatement"));
20
+ addNonBreakingWhitespace(doc);
21
+ doc.push(path.call(print, "whileKeyword"));
22
+ doc = addBreakingWhitespace(doc);
23
+ doc.push([
24
+ path.call(print, "openParenthesisPunctuator"),
25
+ path.call(print, "condition"),
26
+ path.call(print, "closeParenthesisPunctuator"),
27
+ path.call(print, "semicolonPunctuator"),
28
+ ]);
29
+
30
+ return fill(doc);
31
+ }
@@ -0,0 +1,108 @@
1
+ import { type AstPath, type Doc, doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ElementaryTypeDefinition } from "../ast/node/elementary-type-definition.ts";
4
+ import {
5
+ addBreakingWhitespace,
6
+ addNonBreakingWhitespace,
7
+ } from "./util/print-utils.ts";
8
+
9
+ const { fill } = doc.builders;
10
+
11
+ export function printElementaryTypeDefinition(
12
+ path: AstPath<ElementaryTypeDefinition>,
13
+ print: (path: AstPath<AbstractNode>) => Doc,
14
+ ): Doc {
15
+ const elementaryTypeDefinition = path.node;
16
+ let doc: Doc = [];
17
+
18
+ if (elementaryTypeDefinition.reservedKeyword) {
19
+ doc.push(
20
+ path.call(
21
+ print,
22
+ "reservedKeyword" as keyof ElementaryTypeDefinition["reservedKeyword"],
23
+ ),
24
+ );
25
+ doc = addBreakingWhitespace(doc);
26
+ }
27
+
28
+ if (elementaryTypeDefinition.legacyKeyword) {
29
+ doc.push(
30
+ path.call(
31
+ print,
32
+ "legacyKeyword" as keyof ElementaryTypeDefinition["legacyKeyword"],
33
+ ),
34
+ );
35
+ doc = addBreakingWhitespace(doc);
36
+ }
37
+
38
+ if (elementaryTypeDefinition.constKeyword) {
39
+ doc.push(
40
+ path.call(
41
+ print,
42
+ "constKeyword" as keyof ElementaryTypeDefinition["constKeyword"],
43
+ ),
44
+ );
45
+ doc = addBreakingWhitespace(doc);
46
+ }
47
+
48
+ if (elementaryTypeDefinition.alignedModifier !== undefined) {
49
+ doc.push(
50
+ path.call(
51
+ print,
52
+ "alignedModifier" as keyof ElementaryTypeDefinition["alignedModifier"],
53
+ ),
54
+ );
55
+ doc = addBreakingWhitespace(doc);
56
+ }
57
+
58
+ doc.push(path.call(print, "elementaryType"));
59
+ doc.push(path.call(print, "lengthAttribute"));
60
+
61
+ if (elementaryTypeDefinition.lookAheadOperator) {
62
+ doc.push(
63
+ path.call(
64
+ print,
65
+ "lookAheadOperator" as keyof ElementaryTypeDefinition[
66
+ "lookAheadOperator"
67
+ ],
68
+ ),
69
+ );
70
+ }
71
+ doc = addBreakingWhitespace(doc);
72
+
73
+ doc.push(path.call(print, "identifier"));
74
+
75
+ if (elementaryTypeDefinition.assignmentOperator !== undefined) {
76
+ addNonBreakingWhitespace(doc);
77
+ doc.push(
78
+ path.call(
79
+ print,
80
+ "assignmentOperator" as keyof ElementaryTypeDefinition[
81
+ "assignmentOperator"
82
+ ],
83
+ ),
84
+ );
85
+ doc = addBreakingWhitespace(doc);
86
+ doc.push(
87
+ path.call(print, "value" as keyof ElementaryTypeDefinition["value"]),
88
+ );
89
+ if (elementaryTypeDefinition.endValue !== undefined) {
90
+ doc.push(
91
+ path.call(
92
+ print,
93
+ "rangeOperator" as keyof ElementaryTypeDefinition["rangeOperator"],
94
+ ),
95
+ );
96
+ doc.push(
97
+ path.call(
98
+ print,
99
+ "endValue" as keyof ElementaryTypeDefinition["endValue"],
100
+ ),
101
+ );
102
+ }
103
+ }
104
+
105
+ doc.push(path.call(print, "semicolonPunctuator"));
106
+
107
+ return fill(doc);
108
+ }
@@ -0,0 +1,13 @@
1
+ import type { AstPath, Doc, doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ElementaryTypeOutputValue } from "../ast/node/elementary-type-output-value.ts";
4
+
5
+ export function printElementaryTypeOutputValue(
6
+ path: AstPath<ElementaryTypeOutputValue>,
7
+ print: (path: AstPath<AbstractNode>) => Doc,
8
+ ): doc.builders.Doc {
9
+ return [
10
+ path.call(print, "elementaryType"),
11
+ path.call(print, "lengthAttribute"),
12
+ ];
13
+ }
@@ -0,0 +1,28 @@
1
+ import { AstPath, type Doc } from "prettier";
2
+ import { addNonBreakingWhitespace } from "./util/print-utils.ts";
3
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
4
+ import type { ElementaryType } from "../ast/node/elementary-type.ts";
5
+
6
+ export function printElementaryType(
7
+ path: AstPath<ElementaryType>,
8
+ print: (path: AstPath<AbstractNode>) => Doc,
9
+ ): Doc {
10
+ const elementaryType = path.node;
11
+
12
+ const doc: Doc = [];
13
+ if (elementaryType.unsignedQualifierKeyword) {
14
+ doc.push(
15
+ path.call(
16
+ print,
17
+ "unsignedQualifierKeyword" as keyof ElementaryType[
18
+ "unsignedQualifierKeyword"
19
+ ],
20
+ ),
21
+ );
22
+ addNonBreakingWhitespace(doc);
23
+ }
24
+
25
+ doc.push(path.call(print, "typeKeyword"));
26
+
27
+ return doc;
28
+ }
@@ -0,0 +1,41 @@
1
+ import type { AstPath, Doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ExpandableModifier } from "../ast/node/expandable-modifier.ts";
4
+
5
+ export function printExpandableModifier(
6
+ path: AstPath<ExpandableModifier>,
7
+ print: (path: AstPath<AbstractNode>) => Doc,
8
+ ): Doc {
9
+ const expandableModifier = path.node;
10
+
11
+ const doc: Doc = [];
12
+
13
+ doc.push(
14
+ path.call(print, "expandableKeyword"),
15
+ );
16
+
17
+ if (expandableModifier.maxClassSize !== undefined) {
18
+ doc.push(
19
+ [
20
+ path.call(
21
+ print,
22
+ "openParenthesisPunctuator" as keyof ExpandableModifier[
23
+ "openParenthesisPunctuator"
24
+ ],
25
+ ),
26
+ path.call(
27
+ print,
28
+ "maxClassSize" as keyof ExpandableModifier["maxClassSize"],
29
+ ),
30
+ path.call(
31
+ print,
32
+ "closeParenthesisPunctuator" as keyof ExpandableModifier[
33
+ "closeParenthesisPunctuator"
34
+ ],
35
+ ),
36
+ ],
37
+ );
38
+ }
39
+
40
+ return doc;
41
+ }
@@ -0,0 +1,29 @@
1
+ import type { AstPath, Doc } from "prettier";
2
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
3
+ import type { ExtendsModifier } from "../ast/node/extends-modifier.ts";
4
+ import { addNonBreakingWhitespace } from "./util/print-utils.ts";
5
+
6
+ export function printExtendsModifier(
7
+ path: AstPath<ExtendsModifier>,
8
+ print: (path: AstPath<AbstractNode>) => Doc,
9
+ ): Doc {
10
+ const mapEntryList = path.node;
11
+
12
+ const doc: Doc = [];
13
+
14
+ doc.push(path.call(print, "extendsKeyword"));
15
+ addNonBreakingWhitespace(doc);
16
+
17
+ doc.push(path.call(print, "identifier"));
18
+
19
+ if (mapEntryList.parameterValueList !== undefined) {
20
+ doc.push(
21
+ path.call(
22
+ print,
23
+ "parameterValueList" as keyof ExtendsModifier["parameterValueList"],
24
+ ),
25
+ );
26
+ }
27
+
28
+ return doc;
29
+ }
@@ -0,0 +1,64 @@
1
+ import { AstPath, type Doc } from "prettier";
2
+ import {
3
+ addBreakingWhitespace,
4
+ addNonBreakingWhitespace,
5
+ } from "./util/print-utils.ts";
6
+ import type { AbstractNode } from "../ast/node/abstract-node.ts";
7
+ import type { ForStatement } from "../ast/node/for-statement.ts";
8
+
9
+ export function printForStatement(
10
+ path: AstPath<ForStatement>,
11
+ print: (path: AstPath<AbstractNode>) => Doc,
12
+ ): Doc {
13
+ const forStatement = path.node;
14
+ const doc: Doc = [];
15
+ let subDoc: Doc = [];
16
+
17
+ doc.push(path.call(print, "forKeyword"));
18
+ addNonBreakingWhitespace(doc);
19
+
20
+ subDoc.push(path.call(print, "openParenthesisPunctuator"));
21
+
22
+ if (forStatement.expression1 !== undefined) {
23
+ subDoc.push(
24
+ path.call(print, "expression1" as keyof ForStatement["expression1"]),
25
+ );
26
+ } else if (forStatement.computedElementaryDefinition !== undefined) {
27
+ subDoc.push(
28
+ path.call(
29
+ print,
30
+ "computedElementaryDefinition" as keyof ForStatement[
31
+ "computedElementaryDefinition"
32
+ ],
33
+ ),
34
+ );
35
+ } else if (forStatement.semicolon1Punctuator !== undefined) {
36
+ subDoc.push(
37
+ path.call(
38
+ print,
39
+ "semicolon1Punctuator" as keyof ForStatement["semicolon1Punctuator"],
40
+ ),
41
+ );
42
+ }
43
+
44
+ if (forStatement.expression2 !== undefined) {
45
+ subDoc = addBreakingWhitespace(subDoc);
46
+ subDoc.push(
47
+ path.call(print, "expression2" as keyof ForStatement["expression2"]),
48
+ );
49
+ }
50
+ subDoc.push(path.call(print, "semicolon2Punctuator"));
51
+ if (forStatement.expression3 !== undefined) {
52
+ subDoc = addBreakingWhitespace(subDoc);
53
+ subDoc.push(
54
+ path.call(print, "expression3" as keyof ForStatement["expression3"]),
55
+ );
56
+ }
57
+ subDoc.push(path.call(print, "closeParenthesisPunctuator"));
58
+ addNonBreakingWhitespace(subDoc);
59
+
60
+ doc.push(subDoc);
61
+ doc.push(path.call(print, "statement"));
62
+
63
+ return doc;
64
+ }
@@ -0,0 +1,10 @@
1
+ import type { AstPath, Doc } from "prettier";
2
+ import type { Identifier } from "../ast/node/identifier.ts";
3
+ import type { AbstractNode } from "../../index.ts";
4
+
5
+ export function printIdentifier(
6
+ path: AstPath<Identifier>,
7
+ print: (path: AstPath<AbstractNode>) => Doc,
8
+ ): Doc {
9
+ return path.call(print, "children", 0);
10
+ }