@soundscript/soundscript 0.1.12 → 0.1.15

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 (441) hide show
  1. package/package.json +15 -6
  2. package/project-transform/index.js +2 -0
  3. package/project-transform/index.ts +8 -0
  4. package/project-transform/src/annotation_syntax.js +948 -0
  5. package/project-transform/src/annotation_syntax.ts +1217 -0
  6. package/project-transform/src/build_package.js +475 -0
  7. package/project-transform/src/build_package.ts +683 -0
  8. package/project-transform/src/bundled/portable-web-globals.d.ts +153 -0
  9. package/project-transform/src/bundled/runtime_externs.js +220 -0
  10. package/project-transform/src/bundled/runtime_externs.ts +237 -0
  11. package/project-transform/src/bundled/sound-libs/lib.decorators.d.ts +385 -0
  12. package/project-transform/src/bundled/sound-libs/lib.decorators.legacy.d.ts +22 -0
  13. package/project-transform/src/bundled/sound-libs/lib.dom.asynciterable.d.ts +42 -0
  14. package/project-transform/src/bundled/sound-libs/lib.dom.d.ts +39440 -0
  15. package/project-transform/src/bundled/sound-libs/lib.es2015.collection.d.ts +149 -0
  16. package/project-transform/src/bundled/sound-libs/lib.es2015.core.d.ts +657 -0
  17. package/project-transform/src/bundled/sound-libs/lib.es2015.d.ts +28 -0
  18. package/project-transform/src/bundled/sound-libs/lib.es2015.generator.d.ts +77 -0
  19. package/project-transform/src/bundled/sound-libs/lib.es2015.iterable.d.ts +616 -0
  20. package/project-transform/src/bundled/sound-libs/lib.es2015.promise.d.ts +80 -0
  21. package/project-transform/src/bundled/sound-libs/lib.es2015.proxy.d.ts +128 -0
  22. package/project-transform/src/bundled/sound-libs/lib.es2015.reflect.d.ts +144 -0
  23. package/project-transform/src/bundled/sound-libs/lib.es2015.symbol.d.ts +46 -0
  24. package/project-transform/src/bundled/sound-libs/lib.es2015.symbol.wellknown.d.ts +170 -0
  25. package/project-transform/src/bundled/sound-libs/lib.es2016.array.include.d.ts +116 -0
  26. package/project-transform/src/bundled/sound-libs/lib.es2016.d.ts +21 -0
  27. package/project-transform/src/bundled/sound-libs/lib.es2017.arraybuffer.d.ts +21 -0
  28. package/project-transform/src/bundled/sound-libs/lib.es2017.d.ts +26 -0
  29. package/project-transform/src/bundled/sound-libs/lib.es2017.date.d.ts +31 -0
  30. package/project-transform/src/bundled/sound-libs/lib.es2017.object.d.ts +49 -0
  31. package/project-transform/src/bundled/sound-libs/lib.es2017.string.d.ts +45 -0
  32. package/project-transform/src/bundled/sound-libs/lib.es2017.typedarrays.d.ts +53 -0
  33. package/project-transform/src/bundled/sound-libs/lib.es2018.asyncgenerator.d.ts +77 -0
  34. package/project-transform/src/bundled/sound-libs/lib.es2018.asynciterable.d.ts +57 -0
  35. package/project-transform/src/bundled/sound-libs/lib.es2018.d.ts +24 -0
  36. package/project-transform/src/bundled/sound-libs/lib.es2018.promise.d.ts +30 -0
  37. package/project-transform/src/bundled/sound-libs/lib.es2018.regexp.d.ts +37 -0
  38. package/project-transform/src/bundled/sound-libs/lib.es2019.array.d.ts +79 -0
  39. package/project-transform/src/bundled/sound-libs/lib.es2019.d.ts +24 -0
  40. package/project-transform/src/bundled/sound-libs/lib.es2019.object.d.ts +47 -0
  41. package/project-transform/src/bundled/sound-libs/lib.es2019.string.d.ts +37 -0
  42. package/project-transform/src/bundled/sound-libs/lib.es2019.symbol.d.ts +24 -0
  43. package/project-transform/src/bundled/sound-libs/lib.es2020.bigint.d.ts +765 -0
  44. package/project-transform/src/bundled/sound-libs/lib.es2020.d.ts +27 -0
  45. package/project-transform/src/bundled/sound-libs/lib.es2020.date.d.ts +42 -0
  46. package/project-transform/src/bundled/sound-libs/lib.es2020.number.d.ts +28 -0
  47. package/project-transform/src/bundled/sound-libs/lib.es2020.promise.d.ts +49 -0
  48. package/project-transform/src/bundled/sound-libs/lib.es2020.string.d.ts +44 -0
  49. package/project-transform/src/bundled/sound-libs/lib.es2020.symbol.wellknown.d.ts +41 -0
  50. package/project-transform/src/bundled/sound-libs/lib.es2021.d.ts +23 -0
  51. package/project-transform/src/bundled/sound-libs/lib.es2021.promise.d.ts +48 -0
  52. package/project-transform/src/bundled/sound-libs/lib.es2021.string.d.ts +33 -0
  53. package/project-transform/src/bundled/sound-libs/lib.es2021.weakref.d.ts +78 -0
  54. package/project-transform/src/bundled/sound-libs/lib.es2022.array.d.ts +121 -0
  55. package/project-transform/src/bundled/sound-libs/lib.es2022.d.ts +25 -0
  56. package/project-transform/src/bundled/sound-libs/lib.es2022.error.d.ts +75 -0
  57. package/project-transform/src/bundled/sound-libs/lib.es2022.object.d.ts +26 -0
  58. package/project-transform/src/bundled/sound-libs/lib.es2022.regexp.d.ts +39 -0
  59. package/project-transform/src/bundled/sound-libs/lib.es2022.string.d.ts +25 -0
  60. package/project-transform/src/bundled/sound-libs/lib.es2023.array.d.ts +924 -0
  61. package/project-transform/src/bundled/sound-libs/lib.es2023.collection.d.ts +21 -0
  62. package/project-transform/src/bundled/sound-libs/lib.es2023.d.ts +22 -0
  63. package/project-transform/src/bundled/sound-libs/lib.es2024.arraybuffer.d.ts +65 -0
  64. package/project-transform/src/bundled/sound-libs/lib.es2024.collection.d.ts +29 -0
  65. package/project-transform/src/bundled/sound-libs/lib.es2024.d.ts +26 -0
  66. package/project-transform/src/bundled/sound-libs/lib.es2024.object.d.ts +33 -0
  67. package/project-transform/src/bundled/sound-libs/lib.es2024.promise.d.ts +35 -0
  68. package/project-transform/src/bundled/sound-libs/lib.es2024.regexp.d.ts +25 -0
  69. package/project-transform/src/bundled/sound-libs/lib.es2024.string.d.ts +29 -0
  70. package/project-transform/src/bundled/sound-libs/lib.es5.d.ts +4924 -0
  71. package/project-transform/src/bundled/sound_stdlib.js +142 -0
  72. package/project-transform/src/bundled/sound_stdlib.ts +180 -0
  73. package/project-transform/src/checker/analyze_project.js +1361 -0
  74. package/project-transform/src/checker/analyze_project.ts +2246 -0
  75. package/project-transform/src/checker/diagnostics.js +112 -0
  76. package/project-transform/src/checker/diagnostics.ts +222 -0
  77. package/project-transform/src/checker/engine/context.js +235 -0
  78. package/project-transform/src/checker/engine/context.ts +340 -0
  79. package/project-transform/src/checker/engine/diagnostic_codes.js +72 -0
  80. package/project-transform/src/checker/engine/diagnostic_codes.ts +95 -0
  81. package/project-transform/src/checker/engine/facts.js +35 -0
  82. package/project-transform/src/checker/engine/facts.ts +48 -0
  83. package/project-transform/src/checker/engine/types.js +1 -0
  84. package/project-transform/src/checker/engine/types.ts +485 -0
  85. package/project-transform/src/checker/proof_escape_hatch_diagnostics.js +104 -0
  86. package/project-transform/src/checker/proof_escape_hatch_diagnostics.ts +173 -0
  87. package/project-transform/src/checker/rules/async_surface.js +231 -0
  88. package/project-transform/src/checker/rules/async_surface.ts +335 -0
  89. package/project-transform/src/checker/rules/class_lifecycle.js +798 -0
  90. package/project-transform/src/checker/rules/class_lifecycle.ts +1276 -0
  91. package/project-transform/src/checker/rules/directive_validation.js +571 -0
  92. package/project-transform/src/checker/rules/directive_validation.ts +938 -0
  93. package/project-transform/src/checker/rules/directives.js +23 -0
  94. package/project-transform/src/checker/rules/directives.ts +25 -0
  95. package/project-transform/src/checker/rules/flow.js +202 -0
  96. package/project-transform/src/checker/rules/flow.ts +333 -0
  97. package/project-transform/src/checker/rules/flow_facts.js +601 -0
  98. package/project-transform/src/checker/rules/flow_facts.ts +978 -0
  99. package/project-transform/src/checker/rules/flow_invalidation.js +1119 -0
  100. package/project-transform/src/checker/rules/flow_invalidation.ts +2150 -0
  101. package/project-transform/src/checker/rules/flow_shared.js +2822 -0
  102. package/project-transform/src/checker/rules/flow_shared.ts +4383 -0
  103. package/project-transform/src/checker/rules/foreign_boundary.js +120 -0
  104. package/project-transform/src/checker/rules/foreign_boundary.ts +196 -0
  105. package/project-transform/src/checker/rules/foreign_projection.js +279 -0
  106. package/project-transform/src/checker/rules/foreign_projection.ts +425 -0
  107. package/project-transform/src/checker/rules/generated_helpers.js +13 -0
  108. package/project-transform/src/checker/rules/generated_helpers.ts +18 -0
  109. package/project-transform/src/checker/rules/index.js +35 -0
  110. package/project-transform/src/checker/rules/index.ts +49 -0
  111. package/project-transform/src/checker/rules/namespace_object.js +845 -0
  112. package/project-transform/src/checker/rules/namespace_object.ts +1224 -0
  113. package/project-transform/src/checker/rules/non_ordinary_recovery.js +1328 -0
  114. package/project-transform/src/checker/rules/non_ordinary_recovery.ts +2391 -0
  115. package/project-transform/src/checker/rules/null_prototype.js +3 -0
  116. package/project-transform/src/checker/rules/null_prototype.ts +6 -0
  117. package/project-transform/src/checker/rules/overloads.js +181 -0
  118. package/project-transform/src/checker/rules/overloads.ts +317 -0
  119. package/project-transform/src/checker/rules/predicate_verification.js +691 -0
  120. package/project-transform/src/checker/rules/predicate_verification.ts +1088 -0
  121. package/project-transform/src/checker/rules/prototype_hardening.js +237 -0
  122. package/project-transform/src/checker/rules/prototype_hardening.ts +343 -0
  123. package/project-transform/src/checker/rules/receiver_discipline.js +263 -0
  124. package/project-transform/src/checker/rules/receiver_discipline.ts +356 -0
  125. package/project-transform/src/checker/rules/relations.js +6861 -0
  126. package/project-transform/src/checker/rules/relations.ts +12158 -0
  127. package/project-transform/src/checker/rules/resolved_builtins.js +274 -0
  128. package/project-transform/src/checker/rules/resolved_builtins.ts +438 -0
  129. package/project-transform/src/checker/rules/trust.js +217 -0
  130. package/project-transform/src/checker/rules/trust.ts +301 -0
  131. package/project-transform/src/checker/rules/type_guards.js +173 -0
  132. package/project-transform/src/checker/rules/type_guards.ts +257 -0
  133. package/project-transform/src/checker/rules/universal.js +17 -0
  134. package/project-transform/src/checker/rules/universal.ts +22 -0
  135. package/project-transform/src/checker/rules/unsafe_value_origin.js +80 -0
  136. package/project-transform/src/checker/rules/unsafe_value_origin.ts +125 -0
  137. package/project-transform/src/checker/rules/unsound_imports.js +218 -0
  138. package/project-transform/src/checker/rules/unsound_imports.ts +301 -0
  139. package/project-transform/src/checker/rules/unsound_syntax.js +1695 -0
  140. package/project-transform/src/checker/rules/unsound_syntax.ts +2540 -0
  141. package/project-transform/src/checker/rules/value_types.js +206 -0
  142. package/project-transform/src/checker/rules/value_types.ts +407 -0
  143. package/project-transform/src/checker/timing.js +43 -0
  144. package/project-transform/src/checker/timing.ts +78 -0
  145. package/project-transform/src/checker/unsupported_feature_messages.js +337 -0
  146. package/project-transform/src/checker/unsupported_feature_messages.ts +531 -0
  147. package/project-transform/src/cli.js +892 -0
  148. package/project-transform/src/cli.ts +1476 -0
  149. package/project-transform/src/compiler/compile_project.js +319 -0
  150. package/project-transform/src/compiler/compile_project.ts +508 -0
  151. package/project-transform/src/compiler/errors.js +10 -0
  152. package/project-transform/src/compiler/errors.ts +29 -0
  153. package/project-transform/src/compiler/ir.js +1 -0
  154. package/project-transform/src/compiler/ir.ts +1526 -0
  155. package/project-transform/src/compiler/lower.js +30550 -0
  156. package/project-transform/src/compiler/lower.ts +43645 -0
  157. package/project-transform/src/compiler/lower_arrays.js +140 -0
  158. package/project-transform/src/compiler/lower_arrays.ts +190 -0
  159. package/project-transform/src/compiler/lower_strings.js +121 -0
  160. package/project-transform/src/compiler/lower_strings.ts +198 -0
  161. package/project-transform/src/compiler/lower_tagged.js +329 -0
  162. package/project-transform/src/compiler/lower_tagged.ts +427 -0
  163. package/project-transform/src/compiler/lower_views.js +171 -0
  164. package/project-transform/src/compiler/lower_views.ts +251 -0
  165. package/project-transform/src/compiler/object_keys.js +25 -0
  166. package/project-transform/src/compiler/object_keys.ts +35 -0
  167. package/project-transform/src/compiler/runtime_ir.js +30 -0
  168. package/project-transform/src/compiler/runtime_ir.ts +727 -0
  169. package/project-transform/src/compiler/tagged_boundary.js +18 -0
  170. package/project-transform/src/compiler/tagged_boundary.ts +37 -0
  171. package/project-transform/src/compiler/toolchain.js +170 -0
  172. package/project-transform/src/compiler/toolchain.ts +229 -0
  173. package/project-transform/src/compiler/unicode_case_data.js +2102 -0
  174. package/project-transform/src/compiler/unicode_case_data.ts +2112 -0
  175. package/project-transform/src/compiler/wasm_js_host_runtime.js +656 -0
  176. package/project-transform/src/compiler/wasm_js_host_runtime.ts +762 -0
  177. package/project-transform/src/compiler/wat_arrays.js +3132 -0
  178. package/project-transform/src/compiler/wat_arrays.ts +3768 -0
  179. package/project-transform/src/compiler/wat_emitter.js +17952 -0
  180. package/project-transform/src/compiler/wat_emitter.ts +22812 -0
  181. package/project-transform/src/compiler/wat_strings.js +129 -0
  182. package/project-transform/src/compiler/wat_strings.ts +187 -0
  183. package/project-transform/src/compiler/wat_tagged.js +548 -0
  184. package/project-transform/src/compiler/wat_tagged.ts +674 -0
  185. package/project-transform/src/compiler_generator_runner.js +153 -0
  186. package/project-transform/src/compiler_generator_runner.ts +171 -0
  187. package/project-transform/src/compiler_object_test_helpers.js +69 -0
  188. package/project-transform/src/compiler_object_test_helpers.ts +96 -0
  189. package/project-transform/src/compiler_promise_runner.js +2116 -0
  190. package/project-transform/src/compiler_promise_runner.ts +2184 -0
  191. package/project-transform/src/compiler_test_helpers.js +854 -0
  192. package/project-transform/src/compiler_test_helpers.ts +1087 -0
  193. package/project-transform/src/config.js +568 -0
  194. package/project-transform/src/config.ts +892 -0
  195. package/project-transform/src/diagnostic_metadata.js +67 -0
  196. package/project-transform/src/diagnostic_metadata.ts +99 -0
  197. package/project-transform/src/diagnostic_reference.js +1368 -0
  198. package/project-transform/src/diagnostic_reference.ts +1523 -0
  199. package/project-transform/src/editor_diagnostics_worker.js +176 -0
  200. package/project-transform/src/editor_diagnostics_worker.ts +250 -0
  201. package/project-transform/src/editor_projection.js +224 -0
  202. package/project-transform/src/editor_projection.ts +421 -0
  203. package/project-transform/src/frontend/builtin_expanded_program_test_cleanup.js +47 -0
  204. package/project-transform/src/frontend/builtin_expanded_program_test_cleanup.ts +72 -0
  205. package/project-transform/src/frontend/builtin_macro_support.js +842 -0
  206. package/project-transform/src/frontend/builtin_macro_support.ts +1386 -0
  207. package/project-transform/src/frontend/builtin_macros.js +409 -0
  208. package/project-transform/src/frontend/builtin_macros.ts +542 -0
  209. package/project-transform/src/frontend/component_poc_runtime.js +279 -0
  210. package/project-transform/src/frontend/component_poc_runtime.ts +372 -0
  211. package/project-transform/src/frontend/css_macro.js +148 -0
  212. package/project-transform/src/frontend/css_macro.ts +222 -0
  213. package/project-transform/src/frontend/derive_macros.js +2072 -0
  214. package/project-transform/src/frontend/derive_macros.ts +3188 -0
  215. package/project-transform/src/frontend/embedded_fragment_support.js +106 -0
  216. package/project-transform/src/frontend/embedded_fragment_support.ts +172 -0
  217. package/project-transform/src/frontend/error_normalization.js +403 -0
  218. package/project-transform/src/frontend/error_normalization.ts +832 -0
  219. package/project-transform/src/frontend/error_stdlib_support.js +1 -0
  220. package/project-transform/src/frontend/error_stdlib_support.ts +6 -0
  221. package/project-transform/src/frontend/expand_project.js +169 -0
  222. package/project-transform/src/frontend/expand_project.ts +248 -0
  223. package/project-transform/src/frontend/format_soundscript.js +297 -0
  224. package/project-transform/src/frontend/format_soundscript.ts +582 -0
  225. package/project-transform/src/frontend/graphql_macro.js +174 -0
  226. package/project-transform/src/frontend/graphql_macro.ts +253 -0
  227. package/project-transform/src/frontend/hash_context.js +83 -0
  228. package/project-transform/src/frontend/hash_context.ts +113 -0
  229. package/project-transform/src/frontend/hkt_macro.js +448 -0
  230. package/project-transform/src/frontend/hkt_macro.ts +897 -0
  231. package/project-transform/src/frontend/import_binding_usage.js +190 -0
  232. package/project-transform/src/frontend/import_binding_usage.ts +277 -0
  233. package/project-transform/src/frontend/macro_advanced_backend_adapter.js +58 -0
  234. package/project-transform/src/frontend/macro_advanced_backend_adapter.ts +123 -0
  235. package/project-transform/src/frontend/macro_advanced_context.js +826 -0
  236. package/project-transform/src/frontend/macro_advanced_context.ts +1102 -0
  237. package/project-transform/src/frontend/macro_advanced_output.js +21 -0
  238. package/project-transform/src/frontend/macro_advanced_output.ts +41 -0
  239. package/project-transform/src/frontend/macro_api.js +353 -0
  240. package/project-transform/src/frontend/macro_api.ts +1722 -0
  241. package/project-transform/src/frontend/macro_api_internal.js +35 -0
  242. package/project-transform/src/frontend/macro_api_internal.ts +80 -0
  243. package/project-transform/src/frontend/macro_api_module_support.js +39 -0
  244. package/project-transform/src/frontend/macro_api_module_support.ts +65 -0
  245. package/project-transform/src/frontend/macro_backend_adapter.js +272 -0
  246. package/project-transform/src/frontend/macro_backend_adapter.ts +420 -0
  247. package/project-transform/src/frontend/macro_context.js +816 -0
  248. package/project-transform/src/frontend/macro_context.ts +1105 -0
  249. package/project-transform/src/frontend/macro_debug.js +99 -0
  250. package/project-transform/src/frontend/macro_debug.ts +157 -0
  251. package/project-transform/src/frontend/macro_definition_support.js +28 -0
  252. package/project-transform/src/frontend/macro_definition_support.ts +73 -0
  253. package/project-transform/src/frontend/macro_errors.js +40 -0
  254. package/project-transform/src/frontend/macro_errors.ts +70 -0
  255. package/project-transform/src/frontend/macro_expander.js +919 -0
  256. package/project-transform/src/frontend/macro_expander.ts +1611 -0
  257. package/project-transform/src/frontend/macro_factory_support.js +176 -0
  258. package/project-transform/src/frontend/macro_factory_support.ts +263 -0
  259. package/project-transform/src/frontend/macro_host_ast_internal.js +64 -0
  260. package/project-transform/src/frontend/macro_host_ast_internal.ts +109 -0
  261. package/project-transform/src/frontend/macro_index.js +27 -0
  262. package/project-transform/src/frontend/macro_index.ts +50 -0
  263. package/project-transform/src/frontend/macro_loader.js +281 -0
  264. package/project-transform/src/frontend/macro_loader.ts +506 -0
  265. package/project-transform/src/frontend/macro_operand_semantics.js +838 -0
  266. package/project-transform/src/frontend/macro_operand_semantics.ts +1489 -0
  267. package/project-transform/src/frontend/macro_output.js +54 -0
  268. package/project-transform/src/frontend/macro_output.ts +123 -0
  269. package/project-transform/src/frontend/macro_parser.js +611 -0
  270. package/project-transform/src/frontend/macro_parser.ts +832 -0
  271. package/project-transform/src/frontend/macro_resolver.js +69 -0
  272. package/project-transform/src/frontend/macro_resolver.ts +125 -0
  273. package/project-transform/src/frontend/macro_rewrite.js +285 -0
  274. package/project-transform/src/frontend/macro_rewrite.ts +442 -0
  275. package/project-transform/src/frontend/macro_runtime_support.js +232 -0
  276. package/project-transform/src/frontend/macro_runtime_support.ts +324 -0
  277. package/project-transform/src/frontend/macro_scanner.js +393 -0
  278. package/project-transform/src/frontend/macro_scanner.ts +455 -0
  279. package/project-transform/src/frontend/macro_semantic_backend_adapter.js +87 -0
  280. package/project-transform/src/frontend/macro_semantic_backend_adapter.ts +166 -0
  281. package/project-transform/src/frontend/macro_semantic_context.js +5 -0
  282. package/project-transform/src/frontend/macro_semantic_context.ts +12 -0
  283. package/project-transform/src/frontend/macro_semantic_output.js +24 -0
  284. package/project-transform/src/frontend/macro_semantic_output.ts +47 -0
  285. package/project-transform/src/frontend/macro_semantic_types.js +1 -0
  286. package/project-transform/src/frontend/macro_semantic_types.ts +98 -0
  287. package/project-transform/src/frontend/macro_semantics.js +1172 -0
  288. package/project-transform/src/frontend/macro_semantics.ts +1502 -0
  289. package/project-transform/src/frontend/macro_site_kind_support.js +164 -0
  290. package/project-transform/src/frontend/macro_site_kind_support.ts +255 -0
  291. package/project-transform/src/frontend/macro_syntax_internal.js +1950 -0
  292. package/project-transform/src/frontend/macro_syntax_internal.ts +3338 -0
  293. package/project-transform/src/frontend/macro_templates.js +57 -0
  294. package/project-transform/src/frontend/macro_templates.ts +143 -0
  295. package/project-transform/src/frontend/macro_test_helpers.js +82 -0
  296. package/project-transform/src/frontend/macro_test_helpers.ts +136 -0
  297. package/project-transform/src/frontend/macro_types.js +1 -0
  298. package/project-transform/src/frontend/macro_types.ts +103 -0
  299. package/project-transform/src/frontend/macro_vm.js +39 -0
  300. package/project-transform/src/frontend/macro_vm.ts +113 -0
  301. package/project-transform/src/frontend/match_macro.js +885 -0
  302. package/project-transform/src/frontend/match_macro.ts +1220 -0
  303. package/project-transform/src/frontend/numeric_normalization.js +824 -0
  304. package/project-transform/src/frontend/numeric_normalization.ts +1380 -0
  305. package/project-transform/src/frontend/numeric_prelude.js +278 -0
  306. package/project-transform/src/frontend/numeric_prelude.ts +370 -0
  307. package/project-transform/src/frontend/project_frontend.js +2396 -0
  308. package/project-transform/src/frontend/project_frontend.ts +3776 -0
  309. package/project-transform/src/frontend/project_macro_support.js +1401 -0
  310. package/project-transform/src/frontend/project_macro_support.ts +2137 -0
  311. package/project-transform/src/frontend/sql_macro.js +175 -0
  312. package/project-transform/src/frontend/sql_macro.ts +254 -0
  313. package/project-transform/src/frontend/sql_stdlib_support.js +1 -0
  314. package/project-transform/src/frontend/sql_stdlib_support.ts +6 -0
  315. package/project-transform/src/frontend/std_package_support.js +228 -0
  316. package/project-transform/src/frontend/std_package_support.ts +400 -0
  317. package/project-transform/src/frontend/value_normalization.js +306 -0
  318. package/project-transform/src/frontend/value_normalization.ts +599 -0
  319. package/project-transform/src/lsp/project_service.js +4771 -0
  320. package/project-transform/src/lsp/project_service.ts +7580 -0
  321. package/project-transform/src/lsp/protocol.js +9 -0
  322. package/project-transform/src/lsp/protocol.ts +38 -0
  323. package/project-transform/src/lsp/server.js +355 -0
  324. package/project-transform/src/lsp/server.ts +671 -0
  325. package/project-transform/src/lsp/session.js +49 -0
  326. package/project-transform/src/lsp/session.ts +48 -0
  327. package/project-transform/src/lsp/timing.js +43 -0
  328. package/project-transform/src/lsp/timing.ts +76 -0
  329. package/project-transform/src/lsp/transport.js +205 -0
  330. package/project-transform/src/lsp/transport.ts +253 -0
  331. package/project-transform/src/lsp_main.js +5 -0
  332. package/project-transform/src/lsp_main.ts +7 -0
  333. package/project-transform/src/macros.d.ts +1 -0
  334. package/project-transform/src/macros.js +1 -0
  335. package/project-transform/src/macros.ts +1 -0
  336. package/project-transform/src/main.js +24 -0
  337. package/project-transform/src/main.ts +28 -0
  338. package/project-transform/src/platform/host.js +264 -0
  339. package/project-transform/src/platform/host.ts +343 -0
  340. package/project-transform/src/platform/path.js +8 -0
  341. package/project-transform/src/platform/path.ts +20 -0
  342. package/project-transform/src/public_macro_api/macro_api.d.ts +1054 -0
  343. package/project-transform/src/public_macro_api/macro_semantic_types.d.ts +66 -0
  344. package/project-transform/src/public_macro_api/macro_types.d.ts +70 -0
  345. package/project-transform/src/run_program.js +14 -0
  346. package/project-transform/src/run_program.ts +33 -0
  347. package/project-transform/src/runtime/materialize.js +371 -0
  348. package/project-transform/src/runtime/materialize.ts +502 -0
  349. package/project-transform/src/runtime/on_demand.js +203 -0
  350. package/project-transform/src/runtime/on_demand.ts +305 -0
  351. package/project-transform/src/runtime/source_maps.js +205 -0
  352. package/project-transform/src/runtime/source_maps.ts +297 -0
  353. package/project-transform/src/runtime/transform.js +148 -0
  354. package/project-transform/src/runtime/transform.ts +295 -0
  355. package/project-transform/src/service/types.js +1 -0
  356. package/project-transform/src/service/types.ts +22 -0
  357. package/project-transform/src/soundscript_packages.js +477 -0
  358. package/project-transform/src/soundscript_packages.ts +754 -0
  359. package/project-transform/src/soundscript_runtime_specifiers.js +88 -0
  360. package/project-transform/src/soundscript_runtime_specifiers.ts +96 -0
  361. package/project-transform/src/stdlib/async.d.ts +81 -0
  362. package/project-transform/src/stdlib/async.js +213 -0
  363. package/project-transform/src/stdlib/async.ts +315 -0
  364. package/project-transform/src/stdlib/codec.d.ts +32 -0
  365. package/project-transform/src/stdlib/codec.js +30 -0
  366. package/project-transform/src/stdlib/codec.ts +76 -0
  367. package/project-transform/src/stdlib/compare.d.ts +28 -0
  368. package/project-transform/src/stdlib/compare.js +115 -0
  369. package/project-transform/src/stdlib/compare.ts +151 -0
  370. package/project-transform/src/stdlib/css.d.ts +16 -0
  371. package/project-transform/src/stdlib/css.js +9 -0
  372. package/project-transform/src/stdlib/css.ts +28 -0
  373. package/project-transform/src/stdlib/debug.d.ts +2 -0
  374. package/project-transform/src/stdlib/debug.js +9 -0
  375. package/project-transform/src/stdlib/debug.ts +10 -0
  376. package/project-transform/src/stdlib/decode.d.ts +86 -0
  377. package/project-transform/src/stdlib/decode.js +254 -0
  378. package/project-transform/src/stdlib/decode.ts +390 -0
  379. package/project-transform/src/stdlib/derive.d.ts +6 -0
  380. package/project-transform/src/stdlib/derive.js +7 -0
  381. package/project-transform/src/stdlib/derive.ts +7 -0
  382. package/project-transform/src/stdlib/encode.d.ts +100 -0
  383. package/project-transform/src/stdlib/encode.js +130 -0
  384. package/project-transform/src/stdlib/encode.ts +259 -0
  385. package/project-transform/src/stdlib/failures.d.ts +23 -0
  386. package/project-transform/src/stdlib/failures.js +41 -0
  387. package/project-transform/src/stdlib/failures.ts +64 -0
  388. package/project-transform/src/stdlib/fetch.d.ts +67 -0
  389. package/project-transform/src/stdlib/fetch.js +5 -0
  390. package/project-transform/src/stdlib/fetch.ts +11 -0
  391. package/project-transform/src/stdlib/graphql.d.ts +16 -0
  392. package/project-transform/src/stdlib/graphql.js +9 -0
  393. package/project-transform/src/stdlib/graphql.ts +28 -0
  394. package/project-transform/src/stdlib/hash.d.ts +34 -0
  395. package/project-transform/src/stdlib/hash.js +110 -0
  396. package/project-transform/src/stdlib/hash.ts +188 -0
  397. package/project-transform/src/stdlib/hkt.d.ts +40 -0
  398. package/project-transform/src/stdlib/hkt.js +3 -0
  399. package/project-transform/src/stdlib/hkt.ts +41 -0
  400. package/project-transform/src/stdlib/index.d.ts +9 -0
  401. package/project-transform/src/stdlib/index.js +15 -0
  402. package/project-transform/src/stdlib/index.ts +23 -0
  403. package/project-transform/src/stdlib/json.d.ts +125 -0
  404. package/project-transform/src/stdlib/json.js +764 -0
  405. package/project-transform/src/stdlib/json.ts +1034 -0
  406. package/project-transform/src/stdlib/match.d.ts +11 -0
  407. package/project-transform/src/stdlib/match.js +13 -0
  408. package/project-transform/src/stdlib/match.ts +26 -0
  409. package/project-transform/src/stdlib/numerics.d.ts +523 -0
  410. package/project-transform/src/stdlib/numerics.js +1356 -0
  411. package/project-transform/src/stdlib/numerics.ts +1937 -0
  412. package/project-transform/src/stdlib/random.d.ts +19 -0
  413. package/project-transform/src/stdlib/random.js +3 -0
  414. package/project-transform/src/stdlib/random.ts +5 -0
  415. package/project-transform/src/stdlib/result.d.ts +68 -0
  416. package/project-transform/src/stdlib/result.js +139 -0
  417. package/project-transform/src/stdlib/result.ts +248 -0
  418. package/project-transform/src/stdlib/sql.d.ts +22 -0
  419. package/project-transform/src/stdlib/sql.js +23 -0
  420. package/project-transform/src/stdlib/sql.ts +53 -0
  421. package/project-transform/src/stdlib/text.d.ts +24 -0
  422. package/project-transform/src/stdlib/text.js +3 -0
  423. package/project-transform/src/stdlib/text.ts +4 -0
  424. package/project-transform/src/stdlib/thunk.d.ts +2 -0
  425. package/project-transform/src/stdlib/thunk.js +9 -0
  426. package/project-transform/src/stdlib/thunk.ts +15 -0
  427. package/project-transform/src/stdlib/typeclasses.d.ts +57 -0
  428. package/project-transform/src/stdlib/typeclasses.js +78 -0
  429. package/project-transform/src/stdlib/typeclasses.ts +173 -0
  430. package/project-transform/src/stdlib/url.d.ts +37 -0
  431. package/project-transform/src/stdlib/url.js +3 -0
  432. package/project-transform/src/stdlib/url.ts +4 -0
  433. package/project-transform/src/stdlib/value.d.ts +9 -0
  434. package/project-transform/src/stdlib/value.js +104 -0
  435. package/project-transform/src/stdlib/value.ts +133 -0
  436. package/project-transform/src/test_installed_stdlib.js +147 -0
  437. package/project-transform/src/test_installed_stdlib.ts +245 -0
  438. package/project-transform/src/test_macro_package_fixture.js +50 -0
  439. package/project-transform/src/test_macro_package_fixture.ts +68 -0
  440. package/project-transform/src/value_deep_safe.js +191 -0
  441. package/project-transform/src/value_deep_safe.ts +273 -0
@@ -0,0 +1,691 @@
1
+ import ts from 'typescript';
2
+ export function isSignatureDeclarationWithBody(node) {
3
+ return (ts.isArrowFunction(node) && !!node.body) ||
4
+ ((ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node) ||
5
+ ts.isMethodDeclaration(node)) &&
6
+ !!node.body &&
7
+ ts.isBlock(node.body));
8
+ }
9
+ function getDeclaredPredicateContract(context, declaration) {
10
+ if (!declaration.type || !ts.isTypePredicateNode(declaration.type)) {
11
+ return undefined;
12
+ }
13
+ const signature = context.checker.getSignatureFromDeclaration(declaration);
14
+ if (!signature) {
15
+ return undefined;
16
+ }
17
+ const predicate = context.checker.getTypePredicateOfSignature(signature);
18
+ if (!predicate) {
19
+ return undefined;
20
+ }
21
+ return {
22
+ forbiddenPredicateTypeNode: declaration.type && ts.isTypePredicateNode(declaration.type) ? declaration.type.type : undefined,
23
+ predicate,
24
+ signature,
25
+ };
26
+ }
27
+ function getContextualFunctionTypeNode(declaration) {
28
+ if (!ts.isArrowFunction(declaration) && !ts.isFunctionExpression(declaration)) {
29
+ return undefined;
30
+ }
31
+ const parent = declaration.parent;
32
+ if (ts.isVariableDeclaration(parent) &&
33
+ parent.initializer === declaration &&
34
+ parent.type &&
35
+ ts.isFunctionTypeNode(parent.type)) {
36
+ return parent.type;
37
+ }
38
+ return undefined;
39
+ }
40
+ function getPropertyNameText(context, name) {
41
+ if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {
42
+ return name.text;
43
+ }
44
+ if (ts.isComputedPropertyName(name)) {
45
+ const expression = name.expression;
46
+ if (ts.isStringLiteral(expression) ||
47
+ ts.isNumericLiteral(expression) ||
48
+ ts.isNoSubstitutionTemplateLiteral(expression)) {
49
+ return expression.text;
50
+ }
51
+ const constantType = context.checker.getTypeAtLocation(expression);
52
+ if ((constantType.flags & ts.TypeFlags.StringLiteral) !== 0) {
53
+ return constantType.value;
54
+ }
55
+ if ((constantType.flags & ts.TypeFlags.NumberLiteral) !== 0) {
56
+ return String(constantType.value);
57
+ }
58
+ }
59
+ return undefined;
60
+ }
61
+ function getContextualMethodType(context, declaration) {
62
+ const parent = declaration.parent;
63
+ if (!ts.isObjectLiteralExpression(parent)) {
64
+ return undefined;
65
+ }
66
+ const propertyName = getPropertyNameText(context, declaration.name);
67
+ if (!propertyName) {
68
+ return undefined;
69
+ }
70
+ const contextualObjectType = context.checker.getContextualType(parent);
71
+ if (!contextualObjectType) {
72
+ return undefined;
73
+ }
74
+ const property = context.checker.getPropertyOfType(contextualObjectType, propertyName);
75
+ if (!property) {
76
+ return undefined;
77
+ }
78
+ return context.checker.getTypeOfSymbolAtLocation(property, declaration.name);
79
+ }
80
+ function getPredicateTypeNodeFromSignatureDeclaration(declaration) {
81
+ if (!declaration) {
82
+ return undefined;
83
+ }
84
+ if ((ts.isFunctionTypeNode(declaration) ||
85
+ ts.isMethodSignature(declaration) ||
86
+ ts.isFunctionDeclaration(declaration) ||
87
+ ts.isMethodDeclaration(declaration)) &&
88
+ declaration.type &&
89
+ ts.isTypePredicateNode(declaration.type)) {
90
+ return declaration.type.type;
91
+ }
92
+ return undefined;
93
+ }
94
+ function hasExplicitPredicateSurface(declaration) {
95
+ if (!declaration) {
96
+ return false;
97
+ }
98
+ return ((ts.isFunctionTypeNode(declaration) ||
99
+ ts.isMethodSignature(declaration) ||
100
+ ts.isFunctionDeclaration(declaration) ||
101
+ ts.isMethodDeclaration(declaration) ||
102
+ ts.isFunctionExpression(declaration) ||
103
+ ts.isArrowFunction(declaration)) &&
104
+ !!declaration.type &&
105
+ ts.isTypePredicateNode(declaration.type));
106
+ }
107
+ function getContextualPredicateContract(context, declaration) {
108
+ const contextualType = ts.isMethodDeclaration(declaration)
109
+ ? getContextualMethodType(context, declaration)
110
+ : ts.isArrowFunction(declaration) || ts.isFunctionExpression(declaration)
111
+ ? context.checker.getContextualType(declaration)
112
+ : undefined;
113
+ if (!contextualType) {
114
+ return undefined;
115
+ }
116
+ const signature = context.checker.getSignaturesOfType(contextualType, ts.SignatureKind.Call)
117
+ .find((candidate) => context.checker.getTypePredicateOfSignature(candidate));
118
+ if (!signature) {
119
+ return undefined;
120
+ }
121
+ const predicate = context.checker.getTypePredicateOfSignature(signature);
122
+ if (!predicate) {
123
+ return undefined;
124
+ }
125
+ const contextualTypeNode = getContextualFunctionTypeNode(declaration);
126
+ const signatureDeclaration = signature.getDeclaration();
127
+ if (!(contextualTypeNode &&
128
+ ts.isTypePredicateNode(contextualTypeNode.type)) &&
129
+ !hasExplicitPredicateSurface(signatureDeclaration)) {
130
+ return undefined;
131
+ }
132
+ const forbiddenPredicateTypeNode = contextualTypeNode &&
133
+ ts.isTypePredicateNode(contextualTypeNode.type)
134
+ ? contextualTypeNode.type.type
135
+ : getPredicateTypeNodeFromSignatureDeclaration(signatureDeclaration);
136
+ return {
137
+ forbiddenPredicateTypeNode,
138
+ predicate,
139
+ signature,
140
+ };
141
+ }
142
+ function getResolvedPredicateContract(context, declaration) {
143
+ return getDeclaredPredicateContract(context, declaration) ??
144
+ getContextualPredicateContract(context, declaration);
145
+ }
146
+ function getSupportedPrimitive(type) {
147
+ if ((type.flags & ts.TypeFlags.Union) !== 0) {
148
+ const primitiveOptions = new Set(type.types
149
+ .map((part) => getSupportedPrimitive(part))
150
+ .filter((primitive) => primitive !== undefined));
151
+ return primitiveOptions.size === 1 ? primitiveOptions.values().next().value : undefined;
152
+ }
153
+ if ((type.flags & ts.TypeFlags.BigIntLike) !== 0) {
154
+ return 'bigint';
155
+ }
156
+ if ((type.flags & ts.TypeFlags.BooleanLike) !== 0) {
157
+ return 'boolean';
158
+ }
159
+ if ((type.flags & ts.TypeFlags.NumberLike) !== 0) {
160
+ return 'number';
161
+ }
162
+ if ((type.flags & ts.TypeFlags.StringLike) !== 0) {
163
+ return 'string';
164
+ }
165
+ if ((type.flags & ts.TypeFlags.ESSymbolLike) !== 0 ||
166
+ (type.flags & ts.TypeFlags.UniqueESSymbol) !== 0) {
167
+ return 'symbol';
168
+ }
169
+ return undefined;
170
+ }
171
+ function isPrimitiveLiteralLike(type) {
172
+ return (type.flags & ts.TypeFlags.StringLiteral) !== 0 ||
173
+ (type.flags & ts.TypeFlags.NumberLiteral) !== 0 ||
174
+ (type.flags & ts.TypeFlags.BooleanLiteral) !== 0 ||
175
+ (type.flags & ts.TypeFlags.BigIntLiteral) !== 0 ||
176
+ (type.flags & ts.TypeFlags.UniqueESSymbol) !== 0;
177
+ }
178
+ function isCompleteBooleanDomain(type) {
179
+ const constituents = (type.flags & ts.TypeFlags.Union) !== 0
180
+ ? type.types
181
+ : [type];
182
+ let hasTrue = false;
183
+ let hasFalse = false;
184
+ for (const part of constituents) {
185
+ if ((part.flags & ts.TypeFlags.BooleanLiteral) === 0) {
186
+ return false;
187
+ }
188
+ const intrinsicName = part.intrinsicName;
189
+ if (intrinsicName === 'true') {
190
+ hasTrue = true;
191
+ }
192
+ else if (intrinsicName === 'false') {
193
+ hasFalse = true;
194
+ }
195
+ else {
196
+ return false;
197
+ }
198
+ }
199
+ return hasTrue && hasFalse;
200
+ }
201
+ function hasBroadSupportedPrimitiveConstituent(type, primitive) {
202
+ const constituents = (type.flags & ts.TypeFlags.Union) !== 0
203
+ ? type.types
204
+ : [type];
205
+ return constituents.some((part) => getSupportedPrimitive(part) === primitive && !isPrimitiveLiteralLike(part)) || (primitive === 'boolean' && isCompleteBooleanDomain(type));
206
+ }
207
+ function isExactObjectPredicateTarget(type) {
208
+ return (type.flags & ts.TypeFlags.NonPrimitive) !== 0;
209
+ }
210
+ function getReferenceTypeArguments(context, type) {
211
+ if ((type.flags & ts.TypeFlags.Object) === 0) {
212
+ return [];
213
+ }
214
+ const objectType = type;
215
+ if ((objectType.objectFlags & ts.ObjectFlags.Reference) === 0) {
216
+ return [];
217
+ }
218
+ return context.checker.getTypeArguments(objectType);
219
+ }
220
+ function resolveAliasedSymbol(checker, symbol) {
221
+ let current = symbol;
222
+ while ((current.flags & ts.SymbolFlags.Alias) !== 0) {
223
+ const aliased = checker.getAliasedSymbol(current);
224
+ if (aliased === current) {
225
+ break;
226
+ }
227
+ current = aliased;
228
+ }
229
+ return current;
230
+ }
231
+ function classifySupportedPredicateTarget(context, type) {
232
+ const primitive = getSupportedPrimitive(type);
233
+ if (primitive) {
234
+ if (!hasBroadSupportedPrimitiveConstituent(type, primitive)) {
235
+ return undefined;
236
+ }
237
+ return { kind: 'primitive', primitive };
238
+ }
239
+ if ((type.flags & ts.TypeFlags.Union) !== 0) {
240
+ const options = type.types
241
+ .map((part) => classifySupportedPredicateTarget(context, part))
242
+ .filter((option) => option !== undefined);
243
+ if (options.length > 1 && options.length === type.types.length) {
244
+ return { kind: 'unionOfSupported', options };
245
+ }
246
+ return undefined;
247
+ }
248
+ const normalizedType = context.checker.getNonNullableType(type);
249
+ if (isExactObjectPredicateTarget(type)) {
250
+ return context.checker.isArrayType(normalizedType) || context.checker.isTupleType(normalizedType)
251
+ ? undefined
252
+ : { kind: 'nonNullObject' };
253
+ }
254
+ if ((normalizedType.flags & ts.TypeFlags.Object) === 0) {
255
+ return undefined;
256
+ }
257
+ if (context.checker.isArrayType(normalizedType) || context.checker.isTupleType(normalizedType)) {
258
+ return undefined;
259
+ }
260
+ if ((normalizedType.flags & ts.TypeFlags.TypeParameter) !== 0) {
261
+ return undefined;
262
+ }
263
+ if (getReferenceTypeArguments(context, normalizedType).length > 0) {
264
+ return undefined;
265
+ }
266
+ const symbol = normalizedType.getSymbol();
267
+ if (!symbol) {
268
+ return undefined;
269
+ }
270
+ return {
271
+ kind: 'instanceof',
272
+ constructorSymbol: resolveAliasedSymbol(context.checker, symbol),
273
+ };
274
+ }
275
+ export function classifyPredicateVerificationTarget(context, declaration) {
276
+ return context.facts.getPredicateVerificationTarget(declaration, () => {
277
+ const contract = getResolvedPredicateContract(context, declaration);
278
+ if (!contract) {
279
+ return undefined;
280
+ }
281
+ const predicate = contract.predicate;
282
+ if (predicate.kind === ts.TypePredicateKind.AssertsThis ||
283
+ predicate.kind === ts.TypePredicateKind.This) {
284
+ return {
285
+ kind: 'unsupported',
286
+ reason: 'receiverPredicate',
287
+ subject: 'receiver',
288
+ };
289
+ }
290
+ if (predicate.parameterIndex === undefined || !predicate.type) {
291
+ return {
292
+ kind: 'unsupported',
293
+ reason: 'assertsCondition',
294
+ subject: 'parameter',
295
+ };
296
+ }
297
+ const parameter = declaration.parameters[predicate.parameterIndex];
298
+ if (!parameter || !ts.isIdentifier(parameter.name)) {
299
+ return {
300
+ kind: 'unsupported',
301
+ reason: 'unsupportedParameterName',
302
+ subject: 'parameter',
303
+ };
304
+ }
305
+ const target = classifySupportedPredicateTarget(context, predicate.type);
306
+ if (!target) {
307
+ return {
308
+ kind: 'unsupported',
309
+ reason: 'unsupportedTarget',
310
+ subject: 'parameter',
311
+ };
312
+ }
313
+ return {
314
+ kind: 'supported',
315
+ subject: 'parameter',
316
+ target,
317
+ };
318
+ });
319
+ }
320
+ export function getPredicateCheck(context, declaration) {
321
+ return getPredicateCheckForSignature(context, declaration, declaration);
322
+ }
323
+ export function getPredicateCheckForSignature(context, signatureDeclaration, bodyDeclaration) {
324
+ const body = bodyDeclaration.body;
325
+ if (!body) {
326
+ return undefined;
327
+ }
328
+ const classification = classifyPredicateVerificationTarget(context, signatureDeclaration);
329
+ if (!classification || classification.kind !== 'supported') {
330
+ return undefined;
331
+ }
332
+ const contract = getResolvedPredicateContract(context, signatureDeclaration);
333
+ if (!contract) {
334
+ return undefined;
335
+ }
336
+ const predicate = contract.predicate;
337
+ if (predicate.parameterIndex === undefined || !predicate.type) {
338
+ return undefined;
339
+ }
340
+ const parameter = bodyDeclaration.parameters[predicate.parameterIndex];
341
+ if (!parameter || !ts.isIdentifier(parameter.name)) {
342
+ return undefined;
343
+ }
344
+ const parameterType = context.checker.getTypeAtLocation(parameter);
345
+ return {
346
+ body,
347
+ declaration: bodyDeclaration,
348
+ parameterName: parameter.name.text,
349
+ parameterType,
350
+ predicateKind: predicate.kind,
351
+ predicateType: predicate.type,
352
+ target: classification.target,
353
+ };
354
+ }
355
+ export function getForbiddenPredicateTypeNode(context, node) {
356
+ const predicateTypeNode = getResolvedPredicateContract(context, node)?.forbiddenPredicateTypeNode;
357
+ return predicateTypeNode?.kind === ts.SyntaxKind.AnyKeyword ? predicateTypeNode : undefined;
358
+ }
359
+ export function requiresPredicateVerification(node) {
360
+ return !!node.type && ts.isTypePredicateNode(node.type);
361
+ }
362
+ export function hasPredicateVerificationContract(context, node) {
363
+ return requiresPredicateVerification(node) || getContextualPredicateContract(context, node) !== undefined;
364
+ }
365
+ function isIdentifierReference(expression, identifierName) {
366
+ return ts.isIdentifier(expression) && expression.text === identifierName;
367
+ }
368
+ function isStringLiteralValue(expression, value) {
369
+ return ts.isStringLiteral(expression) && expression.text === value;
370
+ }
371
+ function isTypeofCheck(expression, parameterName, primitive, equality) {
372
+ if (!ts.isBinaryExpression(expression)) {
373
+ return false;
374
+ }
375
+ const operatorMatches = equality === 'equal'
376
+ ? expression.operatorToken.kind === ts.SyntaxKind.EqualsEqualsEqualsToken
377
+ : expression.operatorToken.kind === ts.SyntaxKind.ExclamationEqualsEqualsToken;
378
+ if (!operatorMatches) {
379
+ return false;
380
+ }
381
+ const leftMatches = expression.left.kind === ts.SyntaxKind.TypeOfExpression &&
382
+ isIdentifierReference(expression.left.expression, parameterName) &&
383
+ isStringLiteralValue(expression.right, primitive);
384
+ const rightMatches = expression.right.kind === ts.SyntaxKind.TypeOfExpression &&
385
+ isStringLiteralValue(expression.left, primitive) &&
386
+ isIdentifierReference(expression.right.expression, parameterName);
387
+ return leftMatches || rightMatches;
388
+ }
389
+ function isNullCheck(expression, parameterName, equality) {
390
+ if (!ts.isBinaryExpression(expression)) {
391
+ return false;
392
+ }
393
+ const operatorMatches = equality === 'equal'
394
+ ? expression.operatorToken.kind === ts.SyntaxKind.EqualsEqualsEqualsToken
395
+ : expression.operatorToken.kind === ts.SyntaxKind.ExclamationEqualsEqualsToken;
396
+ if (!operatorMatches) {
397
+ return false;
398
+ }
399
+ const leftMatches = isIdentifierReference(expression.left, parameterName) &&
400
+ expression.right.kind === ts.SyntaxKind.NullKeyword;
401
+ const rightMatches = expression.left.kind === ts.SyntaxKind.NullKeyword &&
402
+ isIdentifierReference(expression.right, parameterName);
403
+ return leftMatches || rightMatches;
404
+ }
405
+ function getRuntimeConstructorSymbol(context, expression) {
406
+ if (ts.isIdentifier(expression)) {
407
+ const symbol = context.checker.getSymbolAtLocation(expression);
408
+ return symbol ? resolveAliasedSymbol(context.checker, symbol) : undefined;
409
+ }
410
+ if (ts.isPropertyAccessExpression(expression)) {
411
+ const symbol = context.checker.getSymbolAtLocation(expression.name);
412
+ return symbol ? resolveAliasedSymbol(context.checker, symbol) : undefined;
413
+ }
414
+ return undefined;
415
+ }
416
+ function isInstanceofCheck(context, expression, parameterName, constructorSymbol) {
417
+ if (!constructorSymbol) {
418
+ return false;
419
+ }
420
+ return ts.isBinaryExpression(expression) &&
421
+ expression.operatorToken.kind === ts.SyntaxKind.InstanceOfKeyword &&
422
+ isIdentifierReference(expression.left, parameterName) &&
423
+ getRuntimeConstructorSymbol(context, expression.right) === constructorSymbol;
424
+ }
425
+ function flattenConjunction(expression) {
426
+ if (ts.isBinaryExpression(expression) &&
427
+ expression.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken) {
428
+ return [...flattenConjunction(expression.left), ...flattenConjunction(expression.right)];
429
+ }
430
+ return [expression];
431
+ }
432
+ function getCompositeTypeConstituents(type) {
433
+ if ((type.flags & ts.TypeFlags.Union) !== 0) {
434
+ return type.types;
435
+ }
436
+ if ((type.flags & ts.TypeFlags.Intersection) !== 0) {
437
+ return type.types;
438
+ }
439
+ return [type];
440
+ }
441
+ function hasUniqueLiteralPropertyValue(context, parameterType, predicateType, propertyName, literalValue, location) {
442
+ let matchCount = 0;
443
+ for (const constituentType of getCompositeTypeConstituents(context.checker.getNonNullableType(parameterType))) {
444
+ const propertySymbol = context.checker.getPropertyOfType(constituentType, propertyName);
445
+ if (!propertySymbol) {
446
+ continue;
447
+ }
448
+ const propertyType = context.checker.getTypeOfSymbolAtLocation(propertySymbol, location);
449
+ if ((propertyType.flags & ts.TypeFlags.StringLiteral) === 0) {
450
+ continue;
451
+ }
452
+ if (propertyType.value !== literalValue) {
453
+ continue;
454
+ }
455
+ if (!context.checker.isTypeAssignableTo(constituentType, predicateType)) {
456
+ return false;
457
+ }
458
+ matchCount++;
459
+ if (matchCount > 1) {
460
+ return false;
461
+ }
462
+ }
463
+ return matchCount === 1;
464
+ }
465
+ function matchesPositiveCondition(context, expression, parameterName, parameterType, predicateType, target) {
466
+ switch (target.kind) {
467
+ case 'primitive':
468
+ return isTypeofCheck(expression, parameterName, target.primitive, 'equal');
469
+ case 'nonNullObject': {
470
+ const parts = flattenConjunction(expression);
471
+ const hasObjectCheck = parts.some((part) => isTypeofCheck(part, parameterName, 'object', 'equal'));
472
+ const hasNonNullCheck = parts.some((part) => isNullCheck(part, parameterName, 'not-equal'));
473
+ return parts.length === 2 && hasObjectCheck && hasNonNullCheck;
474
+ }
475
+ case 'instanceof': {
476
+ if (isInstanceofCheck(context, expression, parameterName, target.constructorSymbol)) {
477
+ return true;
478
+ }
479
+ if (!ts.isBinaryExpression(expression)) {
480
+ return false;
481
+ }
482
+ if (expression.operatorToken.kind !== ts.SyntaxKind.EqualsEqualsEqualsToken) {
483
+ return false;
484
+ }
485
+ const propertyAccess = ts.isPropertyAccessExpression(expression.left) &&
486
+ isIdentifierReference(expression.left.expression, parameterName) &&
487
+ ts.isStringLiteral(expression.right)
488
+ ? expression.left
489
+ : ts.isPropertyAccessExpression(expression.right) &&
490
+ isIdentifierReference(expression.right.expression, parameterName) &&
491
+ ts.isStringLiteral(expression.left)
492
+ ? expression.right
493
+ : undefined;
494
+ const literal = ts.isStringLiteral(expression.right)
495
+ ? expression.right
496
+ : ts.isStringLiteral(expression.left)
497
+ ? expression.left
498
+ : undefined;
499
+ if (!propertyAccess || !literal) {
500
+ return false;
501
+ }
502
+ const propertySymbol = context.checker.getPropertyOfType(predicateType, propertyAccess.name.text);
503
+ if (!propertySymbol) {
504
+ return false;
505
+ }
506
+ const propertyType = context.checker.getTypeOfSymbolAtLocation(propertySymbol, propertyAccess.name);
507
+ return (propertyType.flags & ts.TypeFlags.StringLiteral) !== 0 &&
508
+ propertyType.value === literal.text &&
509
+ hasUniqueLiteralPropertyValue(context, parameterType, predicateType, propertyAccess.name.text, literal.text, propertyAccess.name);
510
+ }
511
+ case 'unionOfSupported': {
512
+ const remainingTargets = [...target.options];
513
+ const queue = [expression];
514
+ while (queue.length > 0) {
515
+ const current = queue.pop();
516
+ if (!current) {
517
+ break;
518
+ }
519
+ if (ts.isBinaryExpression(current) && current.operatorToken.kind === ts.SyntaxKind.BarBarToken) {
520
+ queue.push(current.left, current.right);
521
+ continue;
522
+ }
523
+ const matchIndex = remainingTargets.findIndex((option) => matchesPositiveCondition(context, current, parameterName, parameterType, predicateType, option));
524
+ if (matchIndex === -1) {
525
+ return false;
526
+ }
527
+ remainingTargets.splice(matchIndex, 1);
528
+ }
529
+ return remainingTargets.length === 0;
530
+ }
531
+ default: {
532
+ const exhaustiveCheck = target;
533
+ return exhaustiveCheck;
534
+ }
535
+ }
536
+ }
537
+ function matchesNegativeCondition(context, expression, parameterName, target) {
538
+ switch (target.kind) {
539
+ case 'primitive':
540
+ return isTypeofCheck(expression, parameterName, target.primitive, 'not-equal');
541
+ case 'nonNullObject':
542
+ return isTypeofCheck(expression, parameterName, 'object', 'not-equal') ||
543
+ isNullCheck(expression, parameterName, 'equal');
544
+ case 'instanceof':
545
+ return ts.isPrefixUnaryExpression(expression) &&
546
+ expression.operator === ts.SyntaxKind.ExclamationToken &&
547
+ isInstanceofCheck(context, expression.operand, parameterName, target.constructorSymbol);
548
+ case 'unionOfSupported': {
549
+ const remainingTargets = [...target.options];
550
+ for (const part of flattenConjunction(expression)) {
551
+ const matchIndex = remainingTargets.findIndex((option) => matchesNegativeCondition(context, part, parameterName, option));
552
+ if (matchIndex === -1) {
553
+ return false;
554
+ }
555
+ remainingTargets.splice(matchIndex, 1);
556
+ }
557
+ return remainingTargets.length === 0;
558
+ }
559
+ default: {
560
+ const exhaustiveCheck = target;
561
+ return exhaustiveCheck;
562
+ }
563
+ }
564
+ }
565
+ function unwrapSingleStatement(statement) {
566
+ if (ts.isBlock(statement) && statement.statements.length === 1) {
567
+ return unwrapSingleStatement(statement.statements[0]);
568
+ }
569
+ return statement;
570
+ }
571
+ function isBooleanReturn(statement, expected) {
572
+ const unwrappedStatement = unwrapSingleStatement(statement);
573
+ return ts.isReturnStatement(unwrappedStatement) &&
574
+ !!unwrappedStatement.expression &&
575
+ (expected
576
+ ? unwrappedStatement.expression.kind === ts.SyntaxKind.TrueKeyword
577
+ : unwrappedStatement.expression.kind === ts.SyntaxKind.FalseKeyword);
578
+ }
579
+ function isThrowStatement(statement) {
580
+ return ts.isThrowStatement(unwrapSingleStatement(statement));
581
+ }
582
+ function getObjectNegativeCoverage(expression, parameterName) {
583
+ if (ts.isBinaryExpression(expression) &&
584
+ expression.operatorToken.kind === ts.SyntaxKind.BarBarToken) {
585
+ const left = getObjectNegativeCoverage(expression.left, parameterName);
586
+ const right = getObjectNegativeCoverage(expression.right, parameterName);
587
+ if (!left || !right) {
588
+ return undefined;
589
+ }
590
+ return {
591
+ typeofNotObject: left.typeofNotObject || right.typeofNotObject,
592
+ nullCheck: left.nullCheck || right.nullCheck,
593
+ };
594
+ }
595
+ if (isTypeofCheck(expression, parameterName, 'object', 'not-equal')) {
596
+ return { typeofNotObject: true, nullCheck: false };
597
+ }
598
+ if (isNullCheck(expression, parameterName, 'equal')) {
599
+ return { typeofNotObject: false, nullCheck: true };
600
+ }
601
+ return undefined;
602
+ }
603
+ function verifyNegativeGuardBody(context, statements, parameterName, target, guardKind) {
604
+ if (statements.length === 0) {
605
+ return false;
606
+ }
607
+ const finalStatement = statements.at(-1);
608
+ const guardStatements = guardKind === 'return-false' ? statements.slice(0, -1) : statements;
609
+ if (guardKind === 'return-false' && (!finalStatement || !isBooleanReturn(finalStatement, true))) {
610
+ return false;
611
+ }
612
+ if (target.kind === 'nonNullObject') {
613
+ let sawTypeofNotObject = false;
614
+ let sawNullCheck = false;
615
+ for (const statement of guardStatements) {
616
+ if (!ts.isIfStatement(statement) || statement.elseStatement) {
617
+ return false;
618
+ }
619
+ if (guardKind === 'return-false' && !isBooleanReturn(statement.thenStatement, false)) {
620
+ return false;
621
+ }
622
+ if (guardKind === 'throw' && !isThrowStatement(statement.thenStatement)) {
623
+ return false;
624
+ }
625
+ const coverage = getObjectNegativeCoverage(statement.expression, parameterName);
626
+ if (!coverage) {
627
+ return false;
628
+ }
629
+ sawTypeofNotObject || (sawTypeofNotObject = coverage.typeofNotObject);
630
+ sawNullCheck || (sawNullCheck = coverage.nullCheck);
631
+ }
632
+ return sawTypeofNotObject && sawNullCheck;
633
+ }
634
+ return guardStatements.every((statement) => {
635
+ if (!ts.isIfStatement(statement) || statement.elseStatement) {
636
+ return false;
637
+ }
638
+ if (guardKind === 'return-false' && !isBooleanReturn(statement.thenStatement, false)) {
639
+ return false;
640
+ }
641
+ if (guardKind === 'throw' && !isThrowStatement(statement.thenStatement)) {
642
+ return false;
643
+ }
644
+ return matchesNegativeCondition(context, statement.expression, parameterName, target);
645
+ });
646
+ }
647
+ function verifyPositiveBranchBody(context, statements, parameterName, parameterType, predicateType, target) {
648
+ if (statements.length < 2) {
649
+ return false;
650
+ }
651
+ const finalStatement = statements.at(-1);
652
+ if (!finalStatement || !isBooleanReturn(finalStatement, false)) {
653
+ return false;
654
+ }
655
+ const branchConditions = [];
656
+ for (const statement of statements.slice(0, -1)) {
657
+ if (!ts.isIfStatement(statement) || statement.elseStatement ||
658
+ !isBooleanReturn(statement.thenStatement, true)) {
659
+ return false;
660
+ }
661
+ branchConditions.push(statement.expression);
662
+ }
663
+ if (target.kind === 'unionOfSupported') {
664
+ const remainingTargets = [...target.options];
665
+ for (const condition of branchConditions) {
666
+ const matchIndex = remainingTargets.findIndex((option) => matchesPositiveCondition(context, condition, parameterName, parameterType, predicateType, option));
667
+ if (matchIndex === -1) {
668
+ return false;
669
+ }
670
+ remainingTargets.splice(matchIndex, 1);
671
+ }
672
+ return remainingTargets.length === 0;
673
+ }
674
+ return branchConditions.length === 1 &&
675
+ matchesPositiveCondition(context, branchConditions[0], parameterName, parameterType, predicateType, target);
676
+ }
677
+ export function verifyPredicateBody(context, check) {
678
+ if (!ts.isBlock(check.body)) {
679
+ if (check.predicateKind !== ts.TypePredicateKind.Identifier) {
680
+ return false;
681
+ }
682
+ return matchesPositiveCondition(context, check.body, check.parameterName, check.parameterType, check.predicateType, check.target);
683
+ }
684
+ const statements = check.body.statements;
685
+ if (statements.length === 1 && ts.isReturnStatement(statements[0]) && statements[0].expression) {
686
+ return matchesPositiveCondition(context, statements[0].expression, check.parameterName, check.parameterType, check.predicateType, check.target);
687
+ }
688
+ return verifyNegativeGuardBody(context, statements, check.parameterName, check.target, 'return-false') ||
689
+ verifyNegativeGuardBody(context, statements, check.parameterName, check.target, 'throw') ||
690
+ verifyPositiveBranchBody(context, statements, check.parameterName, check.parameterType, check.predicateType, check.target);
691
+ }