@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,683 @@
1
+ import { dirname, extname, join, relative } from './platform/path.ts';
2
+ import ts from 'typescript';
3
+
4
+ import { createSoundStdlibCompilerHost } from './bundled/sound_stdlib.ts';
5
+ import {
6
+ formatDiagnostics,
7
+ hasErrorDiagnostics,
8
+ type MergedDiagnostic,
9
+ toMergedDiagnostic,
10
+ } from './checker/diagnostics.ts';
11
+ import { analyzeProject } from './checker/analyze_project.ts';
12
+ import {
13
+ collectSoundscriptRootNames,
14
+ getConfigFileParsingDiagnostics,
15
+ loadConfig,
16
+ type RuntimeTarget,
17
+ } from './config.ts';
18
+ import { createBuiltinExpandedProgram } from './frontend/builtin_macro_support.ts';
19
+ import { MacroError } from './frontend/macro_errors.ts';
20
+ import {
21
+ emitProjectedDeclarations,
22
+ isSoundscriptSourceFile,
23
+ toSourceFileName,
24
+ } from './frontend/project_frontend.ts';
25
+ import { loadSoundScriptPackageInfo, type SoundScriptPackageInfo } from './soundscript_packages.ts';
26
+ import {
27
+ copyFile,
28
+ fileExistsSync,
29
+ makeDirectory,
30
+ readTextFileSync,
31
+ removePath,
32
+ writeTextFile,
33
+ } from './platform/host.ts';
34
+ import {
35
+ rewriteModuleSpecifiersForEmit,
36
+ transpilePreparedSoundscriptModuleToEsm,
37
+ transpileTypeScriptModuleToEsm,
38
+ } from './runtime/transform.ts';
39
+ import { SOUNDSCRIPT_RUNTIME_PACKAGE_NAME } from './soundscript_runtime_specifiers.ts';
40
+
41
+ const DECLARATION_CAPTURE_OUT_DIR = '/__soundscript_build_types__';
42
+
43
+ export interface BuildProjectOptions {
44
+ outDir: string;
45
+ projectPath: string;
46
+ target?: RuntimeTarget;
47
+ workingDirectory: string;
48
+ }
49
+
50
+ export interface BuildProjectArtifacts {
51
+ emittedFiles: string[];
52
+ outDir: string;
53
+ packageJsonPath: string;
54
+ }
55
+
56
+ export interface BuildProjectResult {
57
+ artifacts?: BuildProjectArtifacts;
58
+ diagnostics: MergedDiagnostic[];
59
+ exitCode: number;
60
+ output: string;
61
+ }
62
+
63
+ interface PackageJsonRecord extends Record<string, unknown> {
64
+ bugs?: unknown;
65
+ homepage?: unknown;
66
+ license?: unknown;
67
+ name?: unknown;
68
+ repository?: unknown;
69
+ version?: unknown;
70
+ }
71
+
72
+ interface SoundscriptMetadataRecord extends Record<string, unknown> {
73
+ exports?: unknown;
74
+ }
75
+
76
+ function createMacroDiagnostic(error: MacroError): MergedDiagnostic {
77
+ return {
78
+ source: 'cli',
79
+ code: error.code,
80
+ category: 'error',
81
+ message: error.message,
82
+ filePath: error.filePath,
83
+ line: error.line,
84
+ column: error.column,
85
+ endLine: error.endLine,
86
+ endColumn: error.endColumn,
87
+ };
88
+ }
89
+
90
+ function isPackageLocalSourceFile(fileName: string, packageRoot: string): boolean {
91
+ return fileName.startsWith(`${packageRoot}/`) &&
92
+ !fileName.endsWith('.d.ts') &&
93
+ !fileName.includes('/node_modules/');
94
+ }
95
+
96
+ function toJsRelativePath(relativePath: string): string {
97
+ const extension = extname(relativePath);
98
+ return extension.length > 0
99
+ ? `${relativePath.slice(0, -extension.length)}.js`
100
+ : `${relativePath}.js`;
101
+ }
102
+
103
+ function toDeclarationRelativePath(relativePath: string): string {
104
+ const extension = extname(relativePath);
105
+ return extension.length > 0
106
+ ? `${relativePath.slice(0, -extension.length)}.d.ts`
107
+ : `${relativePath}.d.ts`;
108
+ }
109
+
110
+ function toEntryWrapperRelativePath(exportKey: string): string {
111
+ return exportKey === '.' ? 'index' : exportKey.slice(2);
112
+ }
113
+
114
+ function renderBuildOutput(artifacts: BuildProjectArtifacts, projectPath: string): string {
115
+ const artifactBaseDirectory = dirname(projectPath);
116
+ const renderedFiles = artifacts.emittedFiles
117
+ .map((filePath) => ` ${relative(artifactBaseDirectory, filePath)}`)
118
+ .join('\n');
119
+
120
+ return [
121
+ `Built package: ${relative(artifactBaseDirectory, artifacts.outDir)}`,
122
+ renderedFiles,
123
+ '',
124
+ ].join('\n');
125
+ }
126
+
127
+ function findNearestPackageJson(startDirectory: string): string | undefined {
128
+ let currentDirectory = startDirectory;
129
+ while (true) {
130
+ const candidate = join(currentDirectory, 'package.json');
131
+ if (fileExistsSync(candidate)) {
132
+ return candidate;
133
+ }
134
+
135
+ const parentDirectory = dirname(currentDirectory);
136
+ if (parentDirectory === currentDirectory) {
137
+ return undefined;
138
+ }
139
+ currentDirectory = parentDirectory;
140
+ }
141
+ }
142
+
143
+ async function emptyDirectory(path: string): Promise<void> {
144
+ await removePath(path).catch(() => undefined);
145
+ await makeDirectory(path);
146
+ }
147
+
148
+ async function copyFileIfPresent(sourcePath: string, destinationPath: string): Promise<boolean> {
149
+ if (!fileExistsSync(sourcePath)) {
150
+ return false;
151
+ }
152
+
153
+ await makeDirectory(dirname(destinationPath));
154
+ await copyFile(sourcePath, destinationPath);
155
+ return true;
156
+ }
157
+
158
+ function relativeImportSpecifier(fromFilePath: string, toFilePath: string): string {
159
+ const relativePath = relative(dirname(fromFilePath), toFilePath).replaceAll('\\', '/');
160
+ return relativePath.startsWith('.') ? relativePath : `./${relativePath}`;
161
+ }
162
+
163
+ function relativeTypeImportSpecifier(fromFilePath: string, toDeclarationPath: string): string {
164
+ const specifier = relativeImportSpecifier(fromFilePath, toDeclarationPath);
165
+ return specifier.endsWith('.d.ts') ? specifier.slice(0, -5) : specifier;
166
+ }
167
+
168
+ function moduleHasDefaultExport(program: ts.Program, programFileName: string): boolean {
169
+ const sourceFile = program.getSourceFile(programFileName);
170
+ if (!sourceFile) {
171
+ return false;
172
+ }
173
+
174
+ const checker = program.getTypeChecker();
175
+ const symbol = checker.getSymbolAtLocation(sourceFile);
176
+ if (!symbol) {
177
+ return false;
178
+ }
179
+
180
+ return checker.getExportsOfModule(symbol).some((exportSymbol) => exportSymbol.name === 'default');
181
+ }
182
+
183
+ function createEntryWrapperText(importSpecifier: string, hasDefaultExport: boolean): string {
184
+ const lines = [`export * from '${importSpecifier}';`];
185
+ if (hasDefaultExport) {
186
+ lines.push(`export { default } from '${importSpecifier}';`);
187
+ }
188
+ lines.push('');
189
+ return lines.join('\n');
190
+ }
191
+
192
+ function createPackageBuildProgram(options: BuildProjectOptions) {
193
+ const loadedConfig = loadConfig(options.projectPath, { target: options.target });
194
+ const soundscriptRootNames = collectSoundscriptRootNames(options.projectPath, loadedConfig);
195
+ return createBuiltinExpandedProgram({
196
+ baseHost: createSoundStdlibCompilerHost(
197
+ loadedConfig.commandLine.options,
198
+ dirname(options.projectPath),
199
+ ),
200
+ configFileParsingDiagnostics: getConfigFileParsingDiagnostics(
201
+ loadedConfig.diagnostics,
202
+ soundscriptRootNames,
203
+ ),
204
+ options: {
205
+ ...loadedConfig.commandLine.options,
206
+ declaration: true,
207
+ emitDeclarationOnly: true,
208
+ noEmit: false,
209
+ outDir: DECLARATION_CAPTURE_OUT_DIR,
210
+ sourceMap: true,
211
+ },
212
+ projectReferences: loadedConfig.commandLine.projectReferences,
213
+ runtime: loadedConfig.runtime,
214
+ rootNames: [...new Set([...loadedConfig.commandLine.fileNames, ...soundscriptRootNames])],
215
+ });
216
+ }
217
+
218
+ function captureTypeScriptDeclarationOutputs(program: ts.Program): ReadonlyMap<string, string> {
219
+ const outputs = new Map<string, string>();
220
+ program.emit(
221
+ undefined,
222
+ (fileName, text) => {
223
+ outputs.set(fileName, text);
224
+ },
225
+ undefined,
226
+ true,
227
+ );
228
+ return outputs;
229
+ }
230
+
231
+ async function writeGeneratedFile(
232
+ filePath: string,
233
+ text: string,
234
+ emittedFiles: string[],
235
+ ): Promise<void> {
236
+ await makeDirectory(dirname(filePath));
237
+ await writeTextFile(filePath, text);
238
+ emittedFiles.push(filePath);
239
+ }
240
+
241
+ function parsePackageJsonRecord(packageJsonPath: string): PackageJsonRecord {
242
+ return JSON.parse(readTextFileSync(packageJsonPath)) as PackageJsonRecord;
243
+ }
244
+
245
+ function collectInvalidSoundscriptExportDiagnostics(
246
+ packageJsonPath: string,
247
+ packageJson: PackageJsonRecord,
248
+ packageInfo: SoundScriptPackageInfo | undefined,
249
+ ): MergedDiagnostic[] {
250
+ const soundscript = packageJson.soundscript;
251
+ if (!soundscript || typeof soundscript !== 'object' || Array.isArray(soundscript)) {
252
+ return [];
253
+ }
254
+
255
+ const metadata = soundscript as SoundscriptMetadataRecord;
256
+ if (
257
+ !metadata.exports || typeof metadata.exports !== 'object' || Array.isArray(metadata.exports)
258
+ ) {
259
+ return [];
260
+ }
261
+
262
+ const diagnostics: MergedDiagnostic[] = [];
263
+ const declaredExports = metadata.exports as Record<string, unknown>;
264
+ for (const [exportKey, rawEntry] of Object.entries(declaredExports)) {
265
+ if (!rawEntry || typeof rawEntry !== 'object' || Array.isArray(rawEntry)) {
266
+ diagnostics.push({
267
+ source: 'cli',
268
+ code: 'SOUNDSCRIPT_BUILD_INVALID_EXPORT',
269
+ category: 'error',
270
+ message:
271
+ `soundscript.exports["${exportKey}"] must be an object with a valid "source" path.`,
272
+ hint:
273
+ 'Use an object with a `source` field that points at an existing `.sts` file in the published package surface.',
274
+ filePath: packageJsonPath,
275
+ line: 1,
276
+ column: 1,
277
+ endLine: 1,
278
+ endColumn: 1,
279
+ });
280
+ continue;
281
+ }
282
+
283
+ const source = (rawEntry as Record<string, unknown>).source;
284
+ if (typeof source !== 'string' || source.length === 0) {
285
+ diagnostics.push({
286
+ source: 'cli',
287
+ code: 'SOUNDSCRIPT_BUILD_INVALID_EXPORT',
288
+ category: 'error',
289
+ message: `soundscript.exports["${exportKey}"] must provide a string "source" path.`,
290
+ hint:
291
+ 'Use an object with a `source` field that points at an existing `.sts` file in the published package surface.',
292
+ filePath: packageJsonPath,
293
+ line: 1,
294
+ column: 1,
295
+ endLine: 1,
296
+ endColumn: 1,
297
+ });
298
+ continue;
299
+ }
300
+
301
+ if (!packageInfo?.exports.has(exportKey)) {
302
+ diagnostics.push({
303
+ source: 'cli',
304
+ code: 'SOUNDSCRIPT_BUILD_INVALID_EXPORT',
305
+ category: 'error',
306
+ message: `soundscript.exports["${exportKey}"] points to a missing source file: ${source}`,
307
+ hint:
308
+ 'Point each `soundscript.exports` entry at an existing `.sts` file that belongs to the published package surface.',
309
+ filePath: packageJsonPath,
310
+ line: 1,
311
+ column: 1,
312
+ endLine: 1,
313
+ endColumn: 1,
314
+ });
315
+ }
316
+ }
317
+
318
+ return diagnostics;
319
+ }
320
+
321
+ function buildDistPackageJson(
322
+ originalPackageJson: PackageJsonRecord,
323
+ packageInfo: SoundScriptPackageInfo,
324
+ ): Record<string, unknown> {
325
+ const exportsRecord: Record<string, unknown> = {};
326
+ const soundscriptExports: Record<string, unknown> = {};
327
+
328
+ for (const [exportKey, sourceEntryPath] of packageInfo.exports.entries()) {
329
+ const relativeSourcePath = relative(packageInfo.packageRoot, sourceEntryPath).replaceAll(
330
+ '\\',
331
+ '/',
332
+ );
333
+ const wrapperRelativePath = toEntryWrapperRelativePath(exportKey);
334
+ exportsRecord[exportKey] = {
335
+ import: `./esm/${wrapperRelativePath}.js`,
336
+ types: `./types/${wrapperRelativePath}.d.ts`,
337
+ };
338
+ soundscriptExports[exportKey] = {
339
+ source: `./soundscript/${relativeSourcePath}`,
340
+ };
341
+ }
342
+
343
+ if (packageInfo.legacySourceEntryPath && !packageInfo.exports.has('.')) {
344
+ const relativeSourcePath = relative(packageInfo.packageRoot, packageInfo.legacySourceEntryPath)
345
+ .replaceAll('\\', '/');
346
+ exportsRecord['.'] = {
347
+ import: './esm/index.js',
348
+ types: './types/index.d.ts',
349
+ };
350
+ soundscriptExports['.'] = {
351
+ source: `./soundscript/${relativeSourcePath}`,
352
+ };
353
+ }
354
+
355
+ const files = ['esm/**', 'types/**', 'soundscript/**'];
356
+ if (fileExistsSync(join(dirname(packageInfo.packageJsonPath), 'README.md'))) {
357
+ files.unshift('README.md');
358
+ }
359
+ if (fileExistsSync(join(dirname(packageInfo.packageJsonPath), 'LICENSE'))) {
360
+ files.unshift('LICENSE');
361
+ }
362
+
363
+ return {
364
+ ...(typeof originalPackageJson.name === 'string' ? { name: originalPackageJson.name } : {}),
365
+ ...(typeof originalPackageJson.version === 'string'
366
+ ? { version: originalPackageJson.version }
367
+ : {}),
368
+ ...(typeof originalPackageJson.license === 'string'
369
+ ? { license: originalPackageJson.license }
370
+ : {}),
371
+ type: 'module',
372
+ ...(typeof originalPackageJson.repository === 'object'
373
+ ? { repository: originalPackageJson.repository }
374
+ : {}),
375
+ ...(typeof originalPackageJson.homepage === 'string'
376
+ ? { homepage: originalPackageJson.homepage }
377
+ : {}),
378
+ ...(typeof originalPackageJson.bugs === 'object' ? { bugs: originalPackageJson.bugs } : {}),
379
+ ...(exportsRecord['.'] ? { types: './types/index.d.ts' } : {}),
380
+ exports: exportsRecord,
381
+ files,
382
+ ...(packageInfo.name === SOUNDSCRIPT_RUNTIME_PACKAGE_NAME ? {} : packageInfo.toolchain
383
+ ? {
384
+ peerDependencies: {
385
+ [SOUNDSCRIPT_RUNTIME_PACKAGE_NAME]: packageInfo.toolchain,
386
+ },
387
+ }
388
+ : {}),
389
+ soundscript: {
390
+ ...(packageInfo.version !== undefined ? { version: packageInfo.version } : {}),
391
+ ...(packageInfo.toolchain ? { toolchain: packageInfo.toolchain } : {}),
392
+ exports: soundscriptExports,
393
+ },
394
+ };
395
+ }
396
+
397
+ export async function buildProject(options: BuildProjectOptions): Promise<BuildProjectResult> {
398
+ const packageJsonPath = findNearestPackageJson(dirname(options.projectPath));
399
+ if (!packageJsonPath) {
400
+ const diagnostics: MergedDiagnostic[] = [{
401
+ source: 'cli',
402
+ code: 'SOUNDSCRIPT_BUILD_NO_PACKAGE_JSON',
403
+ category: 'error',
404
+ message: 'Could not find a package.json for soundscript build.',
405
+ hint:
406
+ 'Add a package.json in the package root before running `soundscript build`, or use `soundscript check` for local app-only workflows.',
407
+ filePath: options.projectPath,
408
+ line: 1,
409
+ column: 1,
410
+ endLine: 1,
411
+ endColumn: 1,
412
+ }];
413
+ return {
414
+ diagnostics,
415
+ exitCode: 1,
416
+ output: formatDiagnostics(diagnostics, options.workingDirectory),
417
+ };
418
+ }
419
+
420
+ const packageJson = parsePackageJsonRecord(packageJsonPath);
421
+ const packageInfo = loadSoundScriptPackageInfo(packageJsonPath, ts.sys);
422
+ const invalidExportDiagnostics = collectInvalidSoundscriptExportDiagnostics(
423
+ packageJsonPath,
424
+ packageJson,
425
+ packageInfo,
426
+ );
427
+ if (invalidExportDiagnostics.length > 0) {
428
+ return {
429
+ diagnostics: invalidExportDiagnostics,
430
+ exitCode: 1,
431
+ output: formatDiagnostics(invalidExportDiagnostics, options.workingDirectory),
432
+ };
433
+ }
434
+ if (!packageInfo || (packageInfo.exports.size === 0 && !packageInfo.legacySourceEntryPath)) {
435
+ const diagnostics: MergedDiagnostic[] = [{
436
+ source: 'cli',
437
+ code: 'SOUNDSCRIPT_BUILD_NO_EXPORTS',
438
+ category: 'error',
439
+ message: 'package.json is missing soundscript.exports metadata for soundscript build.',
440
+ hint:
441
+ 'Add `package.json#soundscript.exports` entries for the published `.sts` surface, or use `soundscript check` / runtime wrappers for local app workflows.',
442
+ filePath: packageJsonPath,
443
+ line: 1,
444
+ column: 1,
445
+ endLine: 1,
446
+ endColumn: 1,
447
+ }];
448
+ return {
449
+ diagnostics,
450
+ exitCode: 1,
451
+ output: formatDiagnostics(diagnostics, options.workingDirectory),
452
+ };
453
+ }
454
+
455
+ const analysis = analyzeProject({
456
+ projectPath: options.projectPath,
457
+ target: options.target,
458
+ workingDirectory: options.workingDirectory,
459
+ });
460
+ if (hasErrorDiagnostics(analysis.diagnostics)) {
461
+ return {
462
+ diagnostics: analysis.diagnostics,
463
+ exitCode: 1,
464
+ output: formatDiagnostics(analysis.diagnostics, options.workingDirectory),
465
+ };
466
+ }
467
+
468
+ const builtProgram = createPackageBuildProgram(options);
469
+ try {
470
+ const diagnostics: MergedDiagnostic[] = [
471
+ ...builtProgram.frontendDiagnostics(),
472
+ ...ts.getPreEmitDiagnostics(builtProgram.program).map(toMergedDiagnostic),
473
+ ];
474
+ if (hasErrorDiagnostics(diagnostics)) {
475
+ return {
476
+ diagnostics,
477
+ exitCode: 1,
478
+ output: formatDiagnostics(diagnostics, options.workingDirectory),
479
+ };
480
+ }
481
+
482
+ try {
483
+ void builtProgram.program.getTypeChecker();
484
+ } catch (error) {
485
+ const merged = error instanceof MacroError ? [createMacroDiagnostic(error)] : [];
486
+ return {
487
+ diagnostics: merged,
488
+ exitCode: 1,
489
+ output: error instanceof MacroError
490
+ ? formatDiagnostics(merged, options.workingDirectory)
491
+ : String(error),
492
+ };
493
+ }
494
+
495
+ await emptyDirectory(options.outDir);
496
+ const emittedFiles: string[] = [];
497
+ const typeOutputs = captureTypeScriptDeclarationOutputs(builtProgram.program);
498
+ const projectedDeclarations = emitProjectedDeclarations(builtProgram.analysisPreparedProgram);
499
+ const packageRoot = packageInfo.packageRoot;
500
+
501
+ for (const sourceFile of builtProgram.program.getSourceFiles()) {
502
+ if (sourceFile.isDeclarationFile) {
503
+ continue;
504
+ }
505
+
506
+ const sourceFileName = toSourceFileName(sourceFile.fileName);
507
+ if (!isPackageLocalSourceFile(sourceFileName, packageRoot)) {
508
+ continue;
509
+ }
510
+
511
+ const relativeSourcePath = relative(packageRoot, sourceFileName).replaceAll('\\', '/');
512
+ const outputJsRelativePath = toJsRelativePath(relativeSourcePath);
513
+ const outputJsPath = join(options.outDir, 'esm', outputJsRelativePath);
514
+ const outputMapPath = `${outputJsPath}.map`;
515
+ const sourceMapComment = `//# sourceMappingURL=${
516
+ relative(dirname(outputJsPath), outputMapPath).replaceAll('\\', '/')
517
+ }`;
518
+
519
+ const artifact = isSoundscriptSourceFile(sourceFileName)
520
+ ? (() => {
521
+ const preparedFile = builtProgram.diagnosticPreparedFiles.get(sourceFileName) ??
522
+ builtProgram.analysisPreparedProgram.preparedHost.getPreparedSourceFile(
523
+ sourceFileName,
524
+ );
525
+ if (!preparedFile) {
526
+ throw new Error(`Missing prepared source file for ${sourceFileName}.`);
527
+ }
528
+ return transpilePreparedSoundscriptModuleToEsm(
529
+ sourceFileName,
530
+ outputJsPath,
531
+ preparedFile,
532
+ {
533
+ module: ts.ModuleKind.ES2022,
534
+ target: ts.ScriptTarget.ES2022,
535
+ valueProgram: builtProgram.program,
536
+ },
537
+ );
538
+ })()
539
+ : transpileTypeScriptModuleToEsm(
540
+ sourceFileName,
541
+ outputJsPath,
542
+ sourceFile.text,
543
+ {
544
+ module: ts.ModuleKind.ES2022,
545
+ target: ts.ScriptTarget.ES2022,
546
+ },
547
+ );
548
+
549
+ await writeGeneratedFile(
550
+ outputJsPath,
551
+ `${artifact.code}\n${sourceMapComment}\n`,
552
+ emittedFiles,
553
+ );
554
+ await writeGeneratedFile(outputMapPath, artifact.mapText, emittedFiles);
555
+ }
556
+
557
+ for (const [sourceFileName, declarationText] of projectedDeclarations.entries()) {
558
+ if (!isPackageLocalSourceFile(sourceFileName, packageRoot)) {
559
+ continue;
560
+ }
561
+
562
+ const relativeSourcePath = relative(packageRoot, sourceFileName).replaceAll('\\', '/');
563
+ const declarationPath = join(
564
+ options.outDir,
565
+ 'types',
566
+ toDeclarationRelativePath(relativeSourcePath),
567
+ );
568
+ await writeGeneratedFile(
569
+ declarationPath,
570
+ rewriteModuleSpecifiersForEmit(declarationText, declarationPath),
571
+ emittedFiles,
572
+ );
573
+ }
574
+
575
+ for (const [outputPath, declarationText] of typeOutputs.entries()) {
576
+ if (
577
+ !outputPath.startsWith(`${DECLARATION_CAPTURE_OUT_DIR}/`) ||
578
+ outputPath.endsWith('.sts.d.ts')
579
+ ) {
580
+ continue;
581
+ }
582
+
583
+ const relativeOutputPath = relative(DECLARATION_CAPTURE_OUT_DIR, outputPath).replaceAll(
584
+ '\\',
585
+ '/',
586
+ );
587
+ const destinationPath = join(options.outDir, 'types', relativeOutputPath);
588
+ await writeGeneratedFile(
589
+ destinationPath,
590
+ rewriteModuleSpecifiersForEmit(declarationText, destinationPath),
591
+ emittedFiles,
592
+ );
593
+ }
594
+
595
+ const copiedSourceFiles = new Set<string>();
596
+ for (const sourceFile of builtProgram.program.getSourceFiles()) {
597
+ if (sourceFile.isDeclarationFile) {
598
+ continue;
599
+ }
600
+
601
+ const sourceFileName = toSourceFileName(sourceFile.fileName);
602
+ if (
603
+ !isPackageLocalSourceFile(sourceFileName, packageRoot) ||
604
+ copiedSourceFiles.has(sourceFileName)
605
+ ) {
606
+ continue;
607
+ }
608
+ copiedSourceFiles.add(sourceFileName);
609
+
610
+ const relativeSourcePath = relative(packageRoot, sourceFileName).replaceAll('\\', '/');
611
+ const destinationPath = join(options.outDir, 'soundscript', relativeSourcePath);
612
+ await makeDirectory(dirname(destinationPath));
613
+ await copyFile(sourceFileName, destinationPath);
614
+ emittedFiles.push(destinationPath);
615
+ }
616
+
617
+ const sourceEntries = packageInfo.exports.size > 0
618
+ ? [...packageInfo.exports.entries()]
619
+ : packageInfo.legacySourceEntryPath
620
+ ? [['.', packageInfo.legacySourceEntryPath] as const]
621
+ : [];
622
+ for (const [exportKey, sourceEntryPath] of sourceEntries) {
623
+ const relativeSourcePath = relative(packageRoot, sourceEntryPath).replaceAll('\\', '/');
624
+ const wrapperRelativePath = toEntryWrapperRelativePath(exportKey);
625
+ const sourceJsPath = join(options.outDir, 'esm', toJsRelativePath(relativeSourcePath));
626
+ const wrapperJsPath = join(options.outDir, 'esm', `${wrapperRelativePath}.js`);
627
+ const wrapperTypesPath = join(options.outDir, 'types', `${wrapperRelativePath}.d.ts`);
628
+ const programFileName = isSoundscriptSourceFile(sourceEntryPath)
629
+ ? builtProgram.preparedProgram.toProgramFileName(sourceEntryPath)
630
+ : sourceEntryPath;
631
+ const hasDefaultExport = moduleHasDefaultExport(builtProgram.program, programFileName);
632
+ const jsImportSpecifier = relativeImportSpecifier(wrapperJsPath, sourceJsPath);
633
+ const typesImportSpecifier = relativeTypeImportSpecifier(
634
+ wrapperTypesPath,
635
+ join(options.outDir, 'types', toDeclarationRelativePath(relativeSourcePath)),
636
+ );
637
+ await writeGeneratedFile(
638
+ wrapperJsPath,
639
+ createEntryWrapperText(jsImportSpecifier, hasDefaultExport),
640
+ emittedFiles,
641
+ );
642
+ await writeGeneratedFile(
643
+ wrapperTypesPath,
644
+ createEntryWrapperText(typesImportSpecifier, hasDefaultExport),
645
+ emittedFiles,
646
+ );
647
+ }
648
+
649
+ await copyFileIfPresent(join(packageRoot, 'README.md'), join(options.outDir, 'README.md'));
650
+ await copyFileIfPresent(join(packageRoot, 'LICENSE'), join(options.outDir, 'LICENSE'));
651
+
652
+ const distPackageJson = buildDistPackageJson(
653
+ packageJson,
654
+ packageInfo,
655
+ );
656
+ const distPackageJsonPath = join(options.outDir, 'package.json');
657
+ await writeGeneratedFile(
658
+ distPackageJsonPath,
659
+ `${JSON.stringify(distPackageJson, null, 2)}\n`,
660
+ emittedFiles,
661
+ );
662
+
663
+ return {
664
+ artifacts: {
665
+ emittedFiles,
666
+ outDir: options.outDir,
667
+ packageJsonPath: distPackageJsonPath,
668
+ },
669
+ diagnostics: [],
670
+ exitCode: 0,
671
+ output: renderBuildOutput(
672
+ {
673
+ emittedFiles,
674
+ outDir: options.outDir,
675
+ packageJsonPath: distPackageJsonPath,
676
+ },
677
+ options.projectPath,
678
+ ),
679
+ };
680
+ } finally {
681
+ builtProgram.dispose();
682
+ }
683
+ }