@soundscript/soundscript 0.1.13 → 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,892 @@
1
+ import ts from 'typescript';
2
+
3
+ import { dirname, isAbsolute, join } from './platform/path.ts';
4
+
5
+ export type OutputFormat = 'json' | 'ndjson' | 'text';
6
+ export type InitMode = 'existing' | 'new';
7
+ export type ExpandStage = 'expanded' | 'prepared' | 'projected' | 'rewrite';
8
+ export type RuntimeTarget =
9
+ | 'js-browser'
10
+ | 'js-node'
11
+ | 'wasm-browser'
12
+ | 'wasm-node'
13
+ | 'wasm-wasi';
14
+ export type RuntimeBackend = 'js' | 'wasm';
15
+ export type RuntimeHost = 'browser' | 'node' | 'wasi';
16
+
17
+ export interface SoundscriptConfig {
18
+ externs: string[];
19
+ target: RuntimeTarget;
20
+ }
21
+
22
+ export interface RuntimeContext {
23
+ backend: RuntimeBackend;
24
+ externs: readonly string[];
25
+ host: RuntimeHost;
26
+ target: RuntimeTarget;
27
+ }
28
+
29
+ export interface RuntimeConfigOverrides {
30
+ externs?: readonly string[];
31
+ target?: RuntimeTarget;
32
+ }
33
+
34
+ export interface HelpCommand {
35
+ kind: 'help';
36
+ }
37
+
38
+ export interface InvalidCommand {
39
+ kind: 'invalid';
40
+ message: string;
41
+ }
42
+
43
+ export interface CheckCommand {
44
+ kind: 'check';
45
+ format: OutputFormat;
46
+ projectPath: string;
47
+ target?: RuntimeTarget;
48
+ workingDirectory: string;
49
+ }
50
+
51
+ export interface CompileCommand {
52
+ kind: 'compile';
53
+ format: OutputFormat;
54
+ projectPath: string;
55
+ target?: RuntimeTarget;
56
+ workingDirectory: string;
57
+ }
58
+
59
+ export interface ExpandCommand {
60
+ filePath?: string;
61
+ kind: 'expand';
62
+ format: OutputFormat;
63
+ outDir: string;
64
+ projectPath: string;
65
+ stage: ExpandStage;
66
+ target?: RuntimeTarget;
67
+ trace: boolean;
68
+ workingDirectory: string;
69
+ }
70
+
71
+ export interface BuildCommand {
72
+ kind: 'build';
73
+ format: OutputFormat;
74
+ outDir: string;
75
+ projectPath: string;
76
+ target?: RuntimeTarget;
77
+ watch: boolean;
78
+ workingDirectory: string;
79
+ }
80
+
81
+ export interface NodeCommand {
82
+ kind: 'node';
83
+ entryPath: string;
84
+ forwardedArgs: string[];
85
+ workingDirectory: string;
86
+ }
87
+
88
+ export interface DenoCommand {
89
+ denoSubcommand: 'run' | 'test';
90
+ forwardedArgs: string[];
91
+ kind: 'deno';
92
+ workingDirectory: string;
93
+ }
94
+
95
+ export interface InitCommand {
96
+ kind: 'init';
97
+ mode: InitMode;
98
+ workingDirectory: string;
99
+ }
100
+
101
+ export interface LspCommand {
102
+ kind: 'lsp';
103
+ workingDirectory: string;
104
+ }
105
+
106
+ export interface EditorProjectCommand {
107
+ filePath: string;
108
+ kind: 'editor-project';
109
+ projectPath: string;
110
+ useStdin: boolean;
111
+ workingDirectory: string;
112
+ }
113
+
114
+ export interface EditorWorkerCommand {
115
+ kind: 'editor-worker';
116
+ workingDirectory: string;
117
+ }
118
+
119
+ export interface VersionCommand {
120
+ kind: 'version';
121
+ }
122
+
123
+ export interface ExplainCommand {
124
+ kind: 'explain';
125
+ code: string;
126
+ format: OutputFormat;
127
+ }
128
+
129
+ export type ParsedCommand =
130
+ | HelpCommand
131
+ | InvalidCommand
132
+ | BuildCommand
133
+ | CheckCommand
134
+ | CompileCommand
135
+ | DenoCommand
136
+ | EditorProjectCommand
137
+ | EditorWorkerCommand
138
+ | ExpandCommand
139
+ | ExplainCommand
140
+ | InitCommand
141
+ | LspCommand
142
+ | NodeCommand
143
+ | VersionCommand;
144
+
145
+ export interface LoadedConfig {
146
+ commandLine: ts.ParsedCommandLine;
147
+ diagnostics: ts.Diagnostic[];
148
+ runtime: RuntimeContext;
149
+ soundscript: SoundscriptConfig;
150
+ }
151
+
152
+ interface FileSystemEntries {
153
+ directories: readonly string[];
154
+ files: readonly string[];
155
+ }
156
+
157
+ interface SoundscriptMatchFilesApi {
158
+ matchFiles(
159
+ path: string,
160
+ extensions: readonly string[],
161
+ excludes: readonly string[] | undefined,
162
+ includes: readonly string[],
163
+ useCaseSensitiveFileNames: boolean,
164
+ currentDirectory: string,
165
+ depth: number | undefined,
166
+ getFileSystemEntries: (path: string) => FileSystemEntries,
167
+ realpath: (path: string) => string,
168
+ ): string[];
169
+ }
170
+
171
+ interface SoundscriptSystemApi extends ts.System {
172
+ getAccessibleFileSystemEntries(path: string): FileSystemEntries;
173
+ }
174
+
175
+ export function normalizeSoundCompilerOptions(
176
+ options: ts.CompilerOptions,
177
+ ): ts.CompilerOptions {
178
+ return {
179
+ ...options,
180
+ allowImportingTsExtensions: true,
181
+ emitDecoratorMetadata: false,
182
+ erasableSyntaxOnly: true,
183
+ exactOptionalPropertyTypes: true,
184
+ experimentalDecorators: false,
185
+ jsx: ts.JsxEmit.ReactJSX,
186
+ noEmit: true,
187
+ noFallthroughCasesInSwitch: true,
188
+ noImplicitOverride: true,
189
+ noPropertyAccessFromIndexSignature: true,
190
+ noUncheckedIndexedAccess: true,
191
+ strict: true,
192
+ };
193
+ }
194
+
195
+ const DEFAULT_RUNTIME_TARGET: RuntimeTarget = 'js-node';
196
+ const DEFAULT_SOUNDSCRIPT_CONFIG: SoundscriptConfig = {
197
+ externs: [],
198
+ target: DEFAULT_RUNTIME_TARGET,
199
+ };
200
+ const DEFAULT_BROWSER_FAMILY_LIBS = [
201
+ 'lib.es2024.d.ts',
202
+ 'lib.dom.d.ts',
203
+ 'lib.dom.asynciterable.d.ts',
204
+ ] as const;
205
+ const DEFAULT_WASI_LIBS = ['lib.es2024.d.ts'] as const;
206
+
207
+ function isRecord(value: unknown): value is Record<string, unknown> {
208
+ return value !== null && typeof value === 'object';
209
+ }
210
+
211
+ function isOutputFormat(value: string): value is OutputFormat {
212
+ return value === 'json' || value === 'ndjson' || value === 'text';
213
+ }
214
+
215
+ function isInitMode(value: string): value is InitMode {
216
+ return value === 'existing' || value === 'new';
217
+ }
218
+
219
+ function isExpandStage(value: string): value is ExpandStage {
220
+ return value === 'expanded' || value === 'prepared' || value === 'projected' ||
221
+ value === 'rewrite';
222
+ }
223
+
224
+ function isRuntimeTarget(value: string): value is RuntimeTarget {
225
+ return value === 'js-browser' ||
226
+ value === 'js-node' ||
227
+ value === 'wasm-browser' ||
228
+ value === 'wasm-node' ||
229
+ value === 'wasm-wasi';
230
+ }
231
+
232
+ function parseSoundscriptConfig(rawConfig: unknown): SoundscriptConfig {
233
+ const soundscriptSection = isRecord(rawConfig) && isRecord(rawConfig.soundscript)
234
+ ? rawConfig.soundscript
235
+ : undefined;
236
+ const configuredTarget = typeof soundscriptSection?.target === 'string' &&
237
+ isRuntimeTarget(soundscriptSection.target)
238
+ ? soundscriptSection.target
239
+ : DEFAULT_RUNTIME_TARGET;
240
+ const configuredExterns = Array.isArray(soundscriptSection?.externs)
241
+ ? [
242
+ ...new Set(
243
+ soundscriptSection.externs.filter((value): value is string => typeof value === 'string'),
244
+ ),
245
+ ]
246
+ : [];
247
+
248
+ return {
249
+ externs: configuredExterns,
250
+ target: configuredTarget,
251
+ };
252
+ }
253
+
254
+ function applyRuntimeConfigOverrides(
255
+ soundscript: SoundscriptConfig,
256
+ overrides: RuntimeConfigOverrides = {},
257
+ ): SoundscriptConfig {
258
+ return {
259
+ externs: overrides.externs
260
+ ? [
261
+ ...new Set(overrides.externs.filter((value): value is string => typeof value === 'string')),
262
+ ]
263
+ : [...soundscript.externs],
264
+ target: overrides.target ?? soundscript.target,
265
+ };
266
+ }
267
+
268
+ function hasExplicitCompilerLibs(rawConfig: unknown): boolean {
269
+ return isRecord(rawConfig) &&
270
+ isRecord(rawConfig.compilerOptions) &&
271
+ Array.isArray(rawConfig.compilerOptions.lib);
272
+ }
273
+
274
+ function applyDefaultRuntimeLibs(
275
+ commandLine: ts.ParsedCommandLine,
276
+ runtime: RuntimeContext,
277
+ rawConfig: unknown,
278
+ ): ts.ParsedCommandLine {
279
+ if (hasExplicitCompilerLibs(rawConfig)) {
280
+ return commandLine;
281
+ }
282
+
283
+ const lib = runtime.target === 'wasm-wasi'
284
+ ? [...DEFAULT_WASI_LIBS]
285
+ : [...DEFAULT_BROWSER_FAMILY_LIBS];
286
+
287
+ return {
288
+ ...commandLine,
289
+ options: {
290
+ ...commandLine.options,
291
+ lib,
292
+ },
293
+ };
294
+ }
295
+
296
+ function isSoundCompilerOptionRootName(fileName: string): boolean {
297
+ return fileName.endsWith('.sts') || fileName.endsWith('.sts.ts');
298
+ }
299
+
300
+ function applySoundCompilerOptionBaseline(
301
+ commandLine: ts.ParsedCommandLine,
302
+ ): ts.ParsedCommandLine {
303
+ return {
304
+ ...commandLine,
305
+ options: normalizeSoundCompilerOptions(commandLine.options),
306
+ };
307
+ }
308
+
309
+ function shouldApplySoundCompilerOptionBaseline(
310
+ projectPath: string,
311
+ commandLine: ts.ParsedCommandLine,
312
+ additionalRootNames: readonly string[] = [],
313
+ ): boolean {
314
+ return [
315
+ ...commandLine.fileNames,
316
+ ...collectConfiguredSoundscriptRootNames(projectPath, commandLine),
317
+ ...additionalRootNames,
318
+ ].some(isSoundCompilerOptionRootName);
319
+ }
320
+
321
+ export function normalizeRuntimeContext(
322
+ soundscript: SoundscriptConfig,
323
+ overrides: RuntimeConfigOverrides = {},
324
+ ): RuntimeContext {
325
+ const resolved = applyRuntimeConfigOverrides(soundscript, overrides);
326
+ switch (resolved.target) {
327
+ case 'js-browser':
328
+ return { backend: 'js', externs: resolved.externs, host: 'browser', target: resolved.target };
329
+ case 'js-node':
330
+ return { backend: 'js', externs: resolved.externs, host: 'node', target: resolved.target };
331
+ case 'wasm-browser':
332
+ return {
333
+ backend: 'wasm',
334
+ externs: resolved.externs,
335
+ host: 'browser',
336
+ target: resolved.target,
337
+ };
338
+ case 'wasm-node':
339
+ return { backend: 'wasm', externs: resolved.externs, host: 'node', target: resolved.target };
340
+ case 'wasm-wasi':
341
+ return { backend: 'wasm', externs: resolved.externs, host: 'wasi', target: resolved.target };
342
+ }
343
+ }
344
+
345
+ export function resolveExpansionEnabled(
346
+ requestedExpansionEnabled: boolean | undefined,
347
+ soundscript: SoundscriptConfig,
348
+ ): boolean {
349
+ void soundscript;
350
+ return requestedExpansionEnabled ?? true;
351
+ }
352
+
353
+ function collectConfiguredSoundscriptRootNames(
354
+ projectPath: string,
355
+ commandLine: ts.ParsedCommandLine,
356
+ ): string[] {
357
+ const matchFilesApi = ts as typeof ts & SoundscriptMatchFilesApi;
358
+ const systemApi = ts.sys as SoundscriptSystemApi;
359
+ const basePath = dirname(projectPath);
360
+ const realpath = ts.sys.realpath?.bind(ts.sys) ?? ((path: string) => path);
361
+ const rawConfig = commandLine.raw as {
362
+ exclude?: readonly string[];
363
+ files?: readonly string[];
364
+ include?: readonly string[];
365
+ } | undefined;
366
+ const explicitSoundscriptFiles = (rawConfig?.files ?? [])
367
+ .map((fileName) => isAbsolute(fileName) ? fileName : join(basePath, fileName))
368
+ .map((fileName) => ts.sys.resolvePath(fileName))
369
+ .filter((fileName) => fileName.endsWith('.sts'));
370
+ const includePatterns = rawConfig?.include
371
+ ? [...rawConfig.include]
372
+ : rawConfig?.files
373
+ ? []
374
+ : ['**/*'];
375
+ const excludePatterns = rawConfig?.exclude
376
+ ? [...rawConfig.exclude]
377
+ : ['node_modules', 'bower_components', 'jspm_packages', '.git'];
378
+ const matchedSoundscriptFiles = includePatterns.length > 0
379
+ ? matchFilesApi.matchFiles(
380
+ basePath,
381
+ ['.sts'],
382
+ excludePatterns,
383
+ includePatterns,
384
+ ts.sys.useCaseSensitiveFileNames,
385
+ basePath,
386
+ undefined,
387
+ systemApi.getAccessibleFileSystemEntries.bind(ts.sys),
388
+ realpath,
389
+ )
390
+ : [];
391
+
392
+ return [...new Set([...explicitSoundscriptFiles, ...matchedSoundscriptFiles])].sort();
393
+ }
394
+
395
+ export function collectSoundscriptRootNames(
396
+ projectPath: string,
397
+ loadedConfig: LoadedConfig,
398
+ ): string[] {
399
+ return collectConfiguredSoundscriptRootNames(projectPath, loadedConfig.commandLine);
400
+ }
401
+
402
+ export function getConfigFileParsingDiagnostics(
403
+ diagnostics: readonly ts.Diagnostic[],
404
+ additionalRootNames: readonly string[] = [],
405
+ ): readonly ts.Diagnostic[] {
406
+ if (additionalRootNames.length === 0) {
407
+ return diagnostics;
408
+ }
409
+
410
+ return diagnostics.filter((diagnostic) => diagnostic.code !== 18003);
411
+ }
412
+
413
+ export function parseCommand(args: readonly string[], workingDirectory: string): ParsedCommand {
414
+ if (args.length === 0) {
415
+ return { kind: 'help' };
416
+ }
417
+
418
+ const subcommand = args[0];
419
+ if (subcommand === '--help' || subcommand === '-h') {
420
+ return { kind: 'help' };
421
+ }
422
+ if (subcommand === '--version' || subcommand === '-v') {
423
+ return { kind: 'version' };
424
+ }
425
+ if (
426
+ subcommand !== 'build' && subcommand !== 'check' && subcommand !== 'compile' &&
427
+ subcommand !== 'deno' &&
428
+ subcommand !== 'editor-project' &&
429
+ subcommand !== 'editor-worker' &&
430
+ subcommand !== 'expand' &&
431
+ subcommand !== 'explain' &&
432
+ subcommand !== 'init' &&
433
+ subcommand !== 'lsp' &&
434
+ subcommand !== 'node'
435
+ ) {
436
+ return {
437
+ kind: 'invalid',
438
+ message: subcommand.startsWith('-')
439
+ ? 'A subcommand is required before command options.'
440
+ : `Unknown subcommand: ${subcommand}`,
441
+ };
442
+ }
443
+
444
+ if (subcommand === 'node') {
445
+ const entryArgument = args[1];
446
+ if (!entryArgument || entryArgument.startsWith('-')) {
447
+ return {
448
+ kind: 'invalid',
449
+ message: 'Missing entry file for node.',
450
+ };
451
+ }
452
+
453
+ return {
454
+ kind: 'node',
455
+ entryPath: ts.sys.resolvePath(
456
+ isAbsolute(entryArgument) ? entryArgument : join(workingDirectory, entryArgument),
457
+ ),
458
+ forwardedArgs: [...args.slice(2)],
459
+ workingDirectory,
460
+ };
461
+ }
462
+
463
+ if (subcommand === 'deno') {
464
+ const denoSubcommand = args[1];
465
+ if (denoSubcommand !== 'run' && denoSubcommand !== 'test') {
466
+ return {
467
+ kind: 'invalid',
468
+ message: "Deno wrapper requires 'run' or 'test'.",
469
+ };
470
+ }
471
+
472
+ return {
473
+ kind: 'deno',
474
+ denoSubcommand,
475
+ forwardedArgs: [...args.slice(2)],
476
+ workingDirectory,
477
+ };
478
+ }
479
+
480
+ let format: OutputFormat = 'text';
481
+ let expandFilePath: string | undefined;
482
+ let expandStage: ExpandStage = 'expanded';
483
+ let expandTrace = false;
484
+ let editorProjectUseStdin = false;
485
+ let mode: InitMode = 'new';
486
+ let outDir: string | undefined;
487
+ let explainCode: string | undefined;
488
+ let projectPath: string | undefined;
489
+ let runtimeTarget: RuntimeTarget | undefined;
490
+ let watch = false;
491
+
492
+ for (let index = 1; index < args.length; index += 1) {
493
+ const argument = args[index];
494
+
495
+ switch (argument) {
496
+ case '--help':
497
+ case '-h':
498
+ return { kind: 'help' };
499
+ case '--version':
500
+ case '-v':
501
+ return { kind: 'version' };
502
+ case '--project':
503
+ case '-p': {
504
+ if (
505
+ subcommand === 'init' || subcommand === 'lsp' || subcommand === 'editor-worker' ||
506
+ subcommand === 'explain'
507
+ ) {
508
+ return {
509
+ kind: 'invalid',
510
+ message: `${argument} is not supported for ${subcommand}.`,
511
+ };
512
+ }
513
+
514
+ const nextArgument = args[index + 1];
515
+ if (!nextArgument || nextArgument.startsWith('-')) {
516
+ return {
517
+ kind: 'invalid',
518
+ message: `Missing value for ${argument}.`,
519
+ };
520
+ }
521
+
522
+ projectPath = ts.sys.resolvePath(
523
+ isAbsolute(nextArgument) ? nextArgument : join(workingDirectory, nextArgument),
524
+ );
525
+ index += 1;
526
+ break;
527
+ }
528
+ case '--format': {
529
+ if (subcommand === 'init' || subcommand === 'lsp') {
530
+ return {
531
+ kind: 'invalid',
532
+ message: `--format is not supported for ${subcommand}.`,
533
+ };
534
+ }
535
+
536
+ const nextArgument = args[index + 1];
537
+ if (!nextArgument || nextArgument.startsWith('-')) {
538
+ return {
539
+ kind: 'invalid',
540
+ message: 'Missing value for --format.',
541
+ };
542
+ }
543
+ if (!isOutputFormat(nextArgument)) {
544
+ return {
545
+ kind: 'invalid',
546
+ message: `Unknown output format: ${nextArgument}`,
547
+ };
548
+ }
549
+
550
+ format = nextArgument;
551
+ index += 1;
552
+ break;
553
+ }
554
+ case '--target': {
555
+ if (
556
+ subcommand !== 'build' && subcommand !== 'check' && subcommand !== 'compile' &&
557
+ subcommand !== 'expand'
558
+ ) {
559
+ return {
560
+ kind: 'invalid',
561
+ message: `--target is not supported for ${subcommand}.`,
562
+ };
563
+ }
564
+
565
+ const nextArgument = args[index + 1];
566
+ if (!nextArgument || nextArgument.startsWith('-')) {
567
+ return {
568
+ kind: 'invalid',
569
+ message: 'Missing value for --target.',
570
+ };
571
+ }
572
+ if (!isRuntimeTarget(nextArgument)) {
573
+ return {
574
+ kind: 'invalid',
575
+ message: `Unknown runtime target: ${nextArgument}`,
576
+ };
577
+ }
578
+
579
+ runtimeTarget = nextArgument;
580
+ index += 1;
581
+ break;
582
+ }
583
+ case '--out-dir': {
584
+ if (subcommand !== 'build' && subcommand !== 'expand') {
585
+ return {
586
+ kind: 'invalid',
587
+ message: '--out-dir is only supported for build or expand.',
588
+ };
589
+ }
590
+
591
+ const nextArgument = args[index + 1];
592
+ if (!nextArgument || nextArgument.startsWith('-')) {
593
+ return {
594
+ kind: 'invalid',
595
+ message: 'Missing value for --out-dir.',
596
+ };
597
+ }
598
+
599
+ outDir = ts.sys.resolvePath(
600
+ isAbsolute(nextArgument) ? nextArgument : join(workingDirectory, nextArgument),
601
+ );
602
+ index += 1;
603
+ break;
604
+ }
605
+ case '--file': {
606
+ if (subcommand !== 'expand' && subcommand !== 'editor-project') {
607
+ return {
608
+ kind: 'invalid',
609
+ message: '--file is only supported for expand or editor-project.',
610
+ };
611
+ }
612
+
613
+ const nextArgument = args[index + 1];
614
+ if (!nextArgument || nextArgument.startsWith('-')) {
615
+ return {
616
+ kind: 'invalid',
617
+ message: 'Missing value for --file.',
618
+ };
619
+ }
620
+
621
+ expandFilePath = ts.sys.resolvePath(
622
+ isAbsolute(nextArgument) ? nextArgument : join(workingDirectory, nextArgument),
623
+ );
624
+ index += 1;
625
+ break;
626
+ }
627
+ case '--stdin-file': {
628
+ if (subcommand !== 'editor-project') {
629
+ return {
630
+ kind: 'invalid',
631
+ message: '--stdin-file is only supported for editor-project.',
632
+ };
633
+ }
634
+
635
+ editorProjectUseStdin = true;
636
+ break;
637
+ }
638
+ case '--stage': {
639
+ if (subcommand !== 'expand') {
640
+ return {
641
+ kind: 'invalid',
642
+ message: '--stage is only supported for expand.',
643
+ };
644
+ }
645
+
646
+ const nextArgument = args[index + 1];
647
+ if (!nextArgument || nextArgument.startsWith('-')) {
648
+ return {
649
+ kind: 'invalid',
650
+ message: 'Missing value for --stage.',
651
+ };
652
+ }
653
+ if (!isExpandStage(nextArgument)) {
654
+ return {
655
+ kind: 'invalid',
656
+ message: `Unknown expand stage: ${nextArgument}`,
657
+ };
658
+ }
659
+
660
+ expandStage = nextArgument;
661
+ index += 1;
662
+ break;
663
+ }
664
+ case '--trace': {
665
+ if (subcommand !== 'expand') {
666
+ return {
667
+ kind: 'invalid',
668
+ message: '--trace is only supported for expand.',
669
+ };
670
+ }
671
+
672
+ expandTrace = true;
673
+ break;
674
+ }
675
+ case '--watch': {
676
+ if (subcommand !== 'build') {
677
+ return {
678
+ kind: 'invalid',
679
+ message: '--watch is only supported for build.',
680
+ };
681
+ }
682
+
683
+ watch = true;
684
+ break;
685
+ }
686
+ case '--mode': {
687
+ if (subcommand !== 'init') {
688
+ return {
689
+ kind: 'invalid',
690
+ message: '--mode is only supported for init.',
691
+ };
692
+ }
693
+
694
+ const nextArgument = args[index + 1];
695
+ if (!nextArgument || nextArgument.startsWith('-')) {
696
+ return {
697
+ kind: 'invalid',
698
+ message: 'Missing value for --mode.',
699
+ };
700
+ }
701
+ if (!isInitMode(nextArgument)) {
702
+ return {
703
+ kind: 'invalid',
704
+ message: `Unknown init mode: ${nextArgument}`,
705
+ };
706
+ }
707
+
708
+ mode = nextArgument;
709
+ index += 1;
710
+ break;
711
+ }
712
+ default:
713
+ if (subcommand === 'explain' && !argument.startsWith('-')) {
714
+ if (explainCode) {
715
+ return {
716
+ kind: 'invalid',
717
+ message: `Unexpected extra argument for explain: ${argument}`,
718
+ };
719
+ }
720
+
721
+ explainCode = argument.toUpperCase();
722
+ break;
723
+ }
724
+
725
+ return {
726
+ kind: 'invalid',
727
+ message: `Unknown option: ${argument}`,
728
+ };
729
+ }
730
+ }
731
+
732
+ if (subcommand === 'explain') {
733
+ if (!explainCode) {
734
+ return {
735
+ kind: 'invalid',
736
+ message: 'Missing diagnostic code for explain.',
737
+ };
738
+ }
739
+
740
+ return {
741
+ kind: 'explain',
742
+ code: explainCode,
743
+ format,
744
+ };
745
+ }
746
+
747
+ if (subcommand === 'init') {
748
+ return {
749
+ kind: 'init',
750
+ mode,
751
+ workingDirectory,
752
+ };
753
+ }
754
+
755
+ if (subcommand === 'lsp') {
756
+ return {
757
+ kind: 'lsp',
758
+ workingDirectory,
759
+ };
760
+ }
761
+
762
+ if (subcommand === 'editor-worker') {
763
+ return {
764
+ kind: 'editor-worker',
765
+ workingDirectory,
766
+ };
767
+ }
768
+
769
+ if (subcommand === 'editor-project') {
770
+ if (!projectPath) {
771
+ projectPath = ts.sys.resolvePath(join(workingDirectory, 'tsconfig.json'));
772
+ }
773
+ if (!expandFilePath) {
774
+ return {
775
+ kind: 'invalid',
776
+ message: 'Missing --file for editor-project.',
777
+ };
778
+ }
779
+ return {
780
+ kind: 'editor-project',
781
+ filePath: expandFilePath,
782
+ projectPath,
783
+ useStdin: editorProjectUseStdin,
784
+ workingDirectory,
785
+ };
786
+ }
787
+
788
+ if (subcommand === 'expand') {
789
+ return {
790
+ filePath: expandFilePath,
791
+ kind: 'expand',
792
+ format,
793
+ outDir: outDir ?? join(workingDirectory, 'soundscript-expanded'),
794
+ projectPath: projectPath ?? join(workingDirectory, 'tsconfig.json'),
795
+ stage: expandStage,
796
+ target: runtimeTarget,
797
+ trace: expandTrace,
798
+ workingDirectory,
799
+ };
800
+ }
801
+
802
+ if (subcommand === 'build') {
803
+ return {
804
+ kind: 'build',
805
+ format,
806
+ outDir: outDir ?? join(workingDirectory, 'dist'),
807
+ projectPath: projectPath ?? join(workingDirectory, 'tsconfig.json'),
808
+ target: runtimeTarget,
809
+ watch,
810
+ workingDirectory,
811
+ };
812
+ }
813
+
814
+ if (subcommand === 'check') {
815
+ return {
816
+ kind: 'check',
817
+ format,
818
+ projectPath: projectPath ?? join(workingDirectory, 'tsconfig.json'),
819
+ target: runtimeTarget,
820
+ workingDirectory,
821
+ };
822
+ }
823
+
824
+ return {
825
+ kind: 'compile',
826
+ format,
827
+ projectPath: projectPath ?? join(workingDirectory, 'tsconfig.json'),
828
+ target: runtimeTarget,
829
+ workingDirectory,
830
+ };
831
+ }
832
+
833
+ export function loadConfig(
834
+ projectPath: string,
835
+ runtimeOverrides: RuntimeConfigOverrides = {},
836
+ additionalRootNames: readonly string[] = [],
837
+ ): LoadedConfig {
838
+ const configFile = ts.readConfigFile(projectPath, ts.sys.readFile);
839
+ const basePath = dirname(projectPath);
840
+
841
+ if (configFile.error) {
842
+ const soundscript = applyRuntimeConfigOverrides(DEFAULT_SOUNDSCRIPT_CONFIG, runtimeOverrides);
843
+ const runtime = normalizeRuntimeContext(soundscript);
844
+ const commandLine = ts.parseJsonConfigFileContent(
845
+ {},
846
+ ts.sys,
847
+ basePath,
848
+ {},
849
+ projectPath,
850
+ );
851
+ const normalizedCommandLine = applyDefaultRuntimeLibs(commandLine, runtime, {});
852
+ return {
853
+ commandLine: shouldApplySoundCompilerOptionBaseline(
854
+ projectPath,
855
+ normalizedCommandLine,
856
+ additionalRootNames,
857
+ )
858
+ ? applySoundCompilerOptionBaseline(normalizedCommandLine)
859
+ : normalizedCommandLine,
860
+ diagnostics: [configFile.error],
861
+ runtime,
862
+ soundscript,
863
+ };
864
+ }
865
+
866
+ const commandLine = ts.parseJsonConfigFileContent(
867
+ configFile.config,
868
+ ts.sys,
869
+ basePath,
870
+ {},
871
+ projectPath,
872
+ );
873
+
874
+ const soundscript = applyRuntimeConfigOverrides(
875
+ parseSoundscriptConfig(configFile.config),
876
+ runtimeOverrides,
877
+ );
878
+ const runtime = normalizeRuntimeContext(soundscript);
879
+ const normalizedCommandLine = applyDefaultRuntimeLibs(commandLine, runtime, configFile.config);
880
+ return {
881
+ commandLine: shouldApplySoundCompilerOptionBaseline(
882
+ projectPath,
883
+ normalizedCommandLine,
884
+ additionalRootNames,
885
+ )
886
+ ? applySoundCompilerOptionBaseline(normalizedCommandLine)
887
+ : normalizedCommandLine,
888
+ diagnostics: commandLine.errors,
889
+ runtime,
890
+ soundscript,
891
+ };
892
+ }