@data-vegle/rbxts-go 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (220) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +181 -2
  3. package/README.rbxtsgo.md +169 -0
  4. package/THIRD_PARTY_NOTICES.md +745 -0
  5. package/cli/cli.go +454 -0
  6. package/compile/compile.go +388 -0
  7. package/compile/declarations.go +221 -0
  8. package/compile/incremental.go +349 -0
  9. package/compile/times.go +9 -0
  10. package/docs/plugin-api.md +239 -0
  11. package/go.mod +20 -0
  12. package/go.sum +24 -0
  13. package/internal/difftest/difftest.go +530 -0
  14. package/internal/plugintest/plugintest.go +181 -0
  15. package/luau/create.go +351 -0
  16. package/luau/doc.go +71 -0
  17. package/luau/globals.go +178 -0
  18. package/luau/jsnum.go +188 -0
  19. package/luau/kinds.go +128 -0
  20. package/luau/list.go +227 -0
  21. package/luau/nodes.go +479 -0
  22. package/luau/operators.go +46 -0
  23. package/luau/render.go +134 -0
  24. package/luau/render_expressions.go +264 -0
  25. package/luau/render_fields.go +81 -0
  26. package/luau/render_indexable.go +81 -0
  27. package/luau/render_state.go +134 -0
  28. package/luau/render_statements.go +235 -0
  29. package/luau/render_util.go +296 -0
  30. package/luau/solve_temp_ids.go +212 -0
  31. package/luau/typeguards.go +175 -0
  32. package/luau/util.go +184 -0
  33. package/luau/visit.go +138 -0
  34. package/npm/index.d.ts +3 -0
  35. package/npm/rbxts-go.sh +187 -0
  36. package/package.json +45 -5
  37. package/patches/typescript/0001-checker-exports.patch +40 -0
  38. package/patches/typescript/0002-iterable-arity.patch +15 -0
  39. package/patches/typescript/0003-context-sensitive-this.patch +15 -0
  40. package/patches/typescript/0004-printer-keep-parse-tree-parentheses.patch +26 -0
  41. package/pluginapi/host.go +31 -0
  42. package/pluginapi/pluginapi.go +153 -0
  43. package/plugins/LICENSE-rbxts-transformer-setget +18 -0
  44. package/plugins/apply.go +342 -0
  45. package/plugins/config.go +431 -0
  46. package/plugins/fallback.go +84 -0
  47. package/plugins/fixemit.go +60 -0
  48. package/plugins/native.go +262 -0
  49. package/plugins/session.go +223 -0
  50. package/plugins/setget.go +478 -0
  51. package/project/copy.go +333 -0
  52. package/project/include/Promise.lua +2068 -0
  53. package/project/include/RuntimeLib.lua +260 -0
  54. package/project/nodepath/nodepath.go +917 -0
  55. package/project/pathtranslator/pathtranslator.go +214 -0
  56. package/project/project.go +498 -0
  57. package/project/rojoresolver/json.go +248 -0
  58. package/project/rojoresolver/rojoresolver.go +559 -0
  59. package/project/shared/constants.go +83 -0
  60. package/project/shared/diagnostic.go +238 -0
  61. package/project/shared/diagnostics.go +388 -0
  62. package/project/shared/elapsed.go +14 -0
  63. package/project/shared/eol_other.go +6 -0
  64. package/project/shared/eol_windows.go +4 -0
  65. package/project/shared/kleur.go +40 -0
  66. package/project/shared/util.go +183 -0
  67. package/scripts/build-with-plugins.sh +130 -0
  68. package/scripts/setup-third-party.sh +75 -0
  69. package/transformer/add_index_diagnostics.go +21 -0
  70. package/transformer/add_one_if_array_type.go +15 -0
  71. package/transformer/array_binding_pattern_contains_hoists.go +25 -0
  72. package/transformer/assert_never.go +24 -0
  73. package/transformer/assignment.go +64 -0
  74. package/transformer/call_macros.go +70 -0
  75. package/transformer/check_variable_hoist.go +125 -0
  76. package/transformer/clean_module_name.go +28 -0
  77. package/transformer/constructor_macros.go +122 -0
  78. package/transformer/convert_to_indexable_expression.go +12 -0
  79. package/transformer/create_binary_from_operator.go +86 -0
  80. package/transformer/create_continue_statements.go +68 -0
  81. package/transformer/create_get_service.go +15 -0
  82. package/transformer/create_hoist_declaration.go +27 -0
  83. package/transformer/create_import_expression.go +220 -0
  84. package/transformer/create_string_from_literal.go +195 -0
  85. package/transformer/create_truthiness_checks.go +63 -0
  86. package/transformer/create_type_check.go +9 -0
  87. package/transformer/ensure_transform_order.go +53 -0
  88. package/transformer/expression_chain.go +27 -0
  89. package/transformer/expression_might_mutate.go +60 -0
  90. package/transformer/find_constructor.go +15 -0
  91. package/transformer/fixup_whitespace_and_decode_entities.go +377 -0
  92. package/transformer/get_accessor_for_binding_type.go +160 -0
  93. package/transformer/get_add_iterable_to_array_builder.go +363 -0
  94. package/transformer/get_assignable_value.go +15 -0
  95. package/transformer/get_constant_value_literal.go +20 -0
  96. package/transformer/get_declared_variables.go +34 -0
  97. package/transformer/get_extends_node.go +23 -0
  98. package/transformer/get_flags.go +21 -0
  99. package/transformer/get_kind_name.go +18 -0
  100. package/transformer/get_original_symbol_of_node.go +16 -0
  101. package/transformer/get_source_file_from_module_specifier.go +68 -0
  102. package/transformer/get_statements.go +12 -0
  103. package/transformer/has_multiple_definitions.go +18 -0
  104. package/transformer/hoist_functions_past_final_statement.go +43 -0
  105. package/transformer/identifier_macros.go +17 -0
  106. package/transformer/is_blocked_by_try_statement.go +19 -0
  107. package/transformer/is_method.go +104 -0
  108. package/transformer/is_symbol_mutable.go +26 -0
  109. package/transformer/is_symbol_of_value.go +11 -0
  110. package/transformer/is_used_as_statement.go +25 -0
  111. package/transformer/is_valid_method_index_without_call.go +36 -0
  112. package/transformer/macro_manager.go +92 -0
  113. package/transformer/object_accessor.go +32 -0
  114. package/transformer/offset.go +58 -0
  115. package/transformer/pointer.go +53 -0
  116. package/transformer/property_call_macros.go +1035 -0
  117. package/transformer/state.go +606 -0
  118. package/transformer/transform_array_assignment_pattern.go +65 -0
  119. package/transformer/transform_array_binding_pattern.go +49 -0
  120. package/transformer/transform_array_literal_expression.go +97 -0
  121. package/transformer/transform_await_expression.go +12 -0
  122. package/transformer/transform_binary_expression.go +221 -0
  123. package/transformer/transform_binding_name.go +25 -0
  124. package/transformer/transform_block.go +14 -0
  125. package/transformer/transform_boolean_literal.go +13 -0
  126. package/transformer/transform_break_statement.go +26 -0
  127. package/transformer/transform_call_expression.go +266 -0
  128. package/transformer/transform_class_constructor.go +125 -0
  129. package/transformer/transform_class_declaration.go +12 -0
  130. package/transformer/transform_class_expression.go +14 -0
  131. package/transformer/transform_class_like_declaration.go +355 -0
  132. package/transformer/transform_conditional_expression.go +70 -0
  133. package/transformer/transform_continue_statement.go +30 -0
  134. package/transformer/transform_decorators.go +253 -0
  135. package/transformer/transform_delete_expression.go +17 -0
  136. package/transformer/transform_do_statement.go +39 -0
  137. package/transformer/transform_element_access_expression.go +114 -0
  138. package/transformer/transform_entity_name.go +21 -0
  139. package/transformer/transform_enum_declaration.go +135 -0
  140. package/transformer/transform_export_assignment.go +57 -0
  141. package/transformer/transform_export_declaration.go +150 -0
  142. package/transformer/transform_expression.go +120 -0
  143. package/transformer/transform_expression_statement.go +71 -0
  144. package/transformer/transform_for_of_statement.go +461 -0
  145. package/transformer/transform_for_statement.go +599 -0
  146. package/transformer/transform_function_declaration.go +84 -0
  147. package/transformer/transform_function_expression.go +48 -0
  148. package/transformer/transform_identifier.go +194 -0
  149. package/transformer/transform_if_statement.go +44 -0
  150. package/transformer/transform_import_declaration.go +146 -0
  151. package/transformer/transform_import_equals_declaration.go +46 -0
  152. package/transformer/transform_import_expression.go +36 -0
  153. package/transformer/transform_initializer.go +22 -0
  154. package/transformer/transform_interpolated_string_part.go +12 -0
  155. package/transformer/transform_jsx.go +41 -0
  156. package/transformer/transform_jsx_attributes.go +110 -0
  157. package/transformer/transform_jsx_children.go +50 -0
  158. package/transformer/transform_jsx_element.go +14 -0
  159. package/transformer/transform_jsx_expression.go +20 -0
  160. package/transformer/transform_jsx_fragment.go +42 -0
  161. package/transformer/transform_jsx_self_closing_element.go +13 -0
  162. package/transformer/transform_jsx_tag_name.go +53 -0
  163. package/transformer/transform_logical.go +160 -0
  164. package/transformer/transform_logical_or_coalescing_assignment_expression.go +103 -0
  165. package/transformer/transform_method_declaration.go +102 -0
  166. package/transformer/transform_module_declaration.go +143 -0
  167. package/transformer/transform_new_expression.go +27 -0
  168. package/transformer/transform_no_substitution_template_literal.go +16 -0
  169. package/transformer/transform_numeric_literal.go +15 -0
  170. package/transformer/transform_object_assignment_pattern.go +86 -0
  171. package/transformer/transform_object_binding_pattern.go +49 -0
  172. package/transformer/transform_object_literal_expression.go +107 -0
  173. package/transformer/transform_omitted_expression.go +9 -0
  174. package/transformer/transform_optional_chain.go +312 -0
  175. package/transformer/transform_parameters.go +124 -0
  176. package/transformer/transform_parenthesized_expression.go +17 -0
  177. package/transformer/transform_property_access_expression.go +37 -0
  178. package/transformer/transform_property_declaration.go +33 -0
  179. package/transformer/transform_property_name.go +20 -0
  180. package/transformer/transform_return_statement.go +83 -0
  181. package/transformer/transform_source_file.go +230 -0
  182. package/transformer/transform_spread_element.go +35 -0
  183. package/transformer/transform_statement.go +84 -0
  184. package/transformer/transform_statement_list.go +90 -0
  185. package/transformer/transform_string_literal.go +22 -0
  186. package/transformer/transform_super_keyword.go +9 -0
  187. package/transformer/transform_switch_statement.go +145 -0
  188. package/transformer/transform_tagged_template_expression.go +34 -0
  189. package/transformer/transform_template_expression.go +35 -0
  190. package/transformer/transform_this_expression.go +33 -0
  191. package/transformer/transform_throw_statement.go +18 -0
  192. package/transformer/transform_try_statement.go +192 -0
  193. package/transformer/transform_type_expression.go +12 -0
  194. package/transformer/transform_unary_expression.go +79 -0
  195. package/transformer/transform_variable_statement.go +178 -0
  196. package/transformer/transform_void_expression.go +13 -0
  197. package/transformer/transform_while_statement.go +34 -0
  198. package/transformer/transform_writable.go +69 -0
  199. package/transformer/transform_yield_expression.go +56 -0
  200. package/transformer/type_guards.go +30 -0
  201. package/transformer/types.go +381 -0
  202. package/transformer/validate_identifier.go +17 -0
  203. package/transformer/validate_method_assignment.go +106 -0
  204. package/transformer/validate_not_any.go +37 -0
  205. package/transformer/wrap_expression_statement.go +20 -0
  206. package/transformer/wrap_return_if_lua_tuple.go +63 -0
  207. package/transformer/wrap_statements_as_generator.go +22 -0
  208. package/tsbridge/affected.go +141 -0
  209. package/tsbridge/config.go +71 -0
  210. package/tsbridge/diagnostics.go +128 -0
  211. package/tsbridge/doc.go +16 -0
  212. package/tsbridge/macros.go +207 -0
  213. package/tsbridge/macrospec.go +30 -0
  214. package/tsbridge/pool.go +142 -0
  215. package/tsbridge/project.go +137 -0
  216. package/tsbridge/reprint.go +99 -0
  217. package/tsbridge/update.go +128 -0
  218. package/watch/poll.go +126 -0
  219. package/watch/session.go +651 -0
  220. package/watch/watch.go +180 -0
@@ -0,0 +1,363 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getAddIterableToArrayBuilder.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/internal/checker"
8
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
9
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
10
+ )
11
+
12
+ type addIterableToArrayBuilder = func(
13
+ state *TransformState,
14
+ expression luau.Expression,
15
+ arrayID luau.AnyIdentifier,
16
+ lengthID luau.AnyIdentifier,
17
+ amtElementsSinceUpdate float64,
18
+ shouldUpdateLengthID bool,
19
+ ) *luau.List
20
+
21
+ func addArray(
22
+ state *TransformState,
23
+ expression luau.Expression,
24
+ arrayID luau.AnyIdentifier,
25
+ lengthID luau.AnyIdentifier,
26
+ amtElementsSinceUpdate float64,
27
+ shouldUpdateLengthID bool,
28
+ ) *luau.List {
29
+ result := luau.NewList()
30
+
31
+ inputArray := state.PushToVarIfNonID(expression, "array")
32
+ var inputLength luau.Expression = luau.NewUnary(luau.UnaryLen, inputArray)
33
+ if shouldUpdateLengthID {
34
+ inputLength = state.PushToVar(inputLength, valueToIDStr(inputArray)+"Length")
35
+ }
36
+
37
+ result.Push(luau.Create(&luau.CallStatement{
38
+ Expression: luau.NewCall(luau.Globals.Table.Move,
39
+ inputArray,
40
+ luau.NewNumber(1),
41
+ inputLength,
42
+ luau.NewBinary(lengthID, luau.BinaryAdd, luau.NewNumber(amtElementsSinceUpdate+1)),
43
+ arrayID,
44
+ ),
45
+ }))
46
+
47
+ if shouldUpdateLengthID {
48
+ result.Push(luau.Create(&luau.Assignment{
49
+ Left: lengthID,
50
+ Operator: luau.AssignAdd,
51
+ Right: inputLength,
52
+ }))
53
+ }
54
+
55
+ return result
56
+ }
57
+
58
+ func addString(
59
+ state *TransformState,
60
+ expression luau.Expression,
61
+ arrayID luau.AnyIdentifier,
62
+ lengthID luau.AnyIdentifier,
63
+ amtElementsSinceUpdate float64,
64
+ shouldUpdateLengthID bool,
65
+ ) *luau.List {
66
+ result := luau.NewList()
67
+
68
+ if amtElementsSinceUpdate > 0 {
69
+ result.Push(luau.Create(&luau.Assignment{
70
+ Left: lengthID,
71
+ Operator: luau.AssignAdd,
72
+ Right: luau.NewNumber(amtElementsSinceUpdate),
73
+ }))
74
+ }
75
+
76
+ valueID := luau.NewTempID("char")
77
+ result.Push(luau.Create(&luau.ForStatement{
78
+ IDs: luau.MakeList(valueID),
79
+ Expression: luau.NewCall(luau.Globals.String.Gmatch, expression, luau.Globals.Utf8.Charpattern),
80
+ Statements: luau.MakeList[luau.Node](
81
+ luau.Create(&luau.Assignment{
82
+ Left: lengthID,
83
+ Operator: luau.AssignAdd,
84
+ Right: luau.NewNumber(1),
85
+ }),
86
+ luau.Create(&luau.Assignment{
87
+ Left: luau.Create(&luau.ComputedIndexExpression{
88
+ Expression: arrayID,
89
+ Index: lengthID,
90
+ }),
91
+ Operator: luau.AssignEqual,
92
+ Right: valueID,
93
+ }),
94
+ ),
95
+ }))
96
+
97
+ return result
98
+ }
99
+
100
+ func addSet(
101
+ state *TransformState,
102
+ expression luau.Expression,
103
+ arrayID luau.AnyIdentifier,
104
+ lengthID luau.AnyIdentifier,
105
+ amtElementsSinceUpdate float64,
106
+ shouldUpdateLengthID bool,
107
+ ) *luau.List {
108
+ result := luau.NewList()
109
+
110
+ if amtElementsSinceUpdate > 0 {
111
+ result.Push(luau.Create(&luau.Assignment{
112
+ Left: lengthID,
113
+ Operator: luau.AssignAdd,
114
+ Right: luau.NewNumber(amtElementsSinceUpdate),
115
+ }))
116
+ }
117
+
118
+ valueID := luau.NewTempID("v")
119
+
120
+ result.Push(luau.Create(&luau.ForStatement{
121
+ IDs: luau.MakeList(valueID),
122
+ Expression: expression,
123
+ Statements: luau.MakeList[luau.Node](
124
+ luau.Create(&luau.Assignment{
125
+ Left: lengthID,
126
+ Operator: luau.AssignAdd,
127
+ Right: luau.NewNumber(1),
128
+ }),
129
+ luau.Create(&luau.Assignment{
130
+ Left: luau.Create(&luau.ComputedIndexExpression{
131
+ Expression: arrayID,
132
+ Index: lengthID,
133
+ }),
134
+ Operator: luau.AssignEqual,
135
+ Right: valueID,
136
+ }),
137
+ ),
138
+ }))
139
+
140
+ return result
141
+ }
142
+
143
+ func addMap(
144
+ state *TransformState,
145
+ expression luau.Expression,
146
+ arrayID luau.AnyIdentifier,
147
+ lengthID luau.AnyIdentifier,
148
+ amtElementsSinceUpdate float64,
149
+ shouldUpdateLengthID bool,
150
+ ) *luau.List {
151
+ result := luau.NewList()
152
+
153
+ if amtElementsSinceUpdate > 0 {
154
+ result.Push(luau.Create(&luau.Assignment{
155
+ Left: lengthID,
156
+ Operator: luau.AssignAdd,
157
+ Right: luau.NewNumber(amtElementsSinceUpdate),
158
+ }))
159
+ }
160
+
161
+ keyID := luau.NewTempID("k")
162
+ valueID := luau.NewTempID("v")
163
+ result.Push(luau.Create(&luau.ForStatement{
164
+ IDs: luau.MakeList(keyID, valueID),
165
+ Expression: expression,
166
+ Statements: luau.MakeList[luau.Node](
167
+ luau.Create(&luau.Assignment{
168
+ Left: lengthID,
169
+ Operator: luau.AssignAdd,
170
+ Right: luau.NewNumber(1),
171
+ }),
172
+ luau.Create(&luau.Assignment{
173
+ Left: luau.Create(&luau.ComputedIndexExpression{
174
+ Expression: arrayID,
175
+ Index: lengthID,
176
+ }),
177
+ Operator: luau.AssignEqual,
178
+ Right: luau.NewArray(keyID, valueID),
179
+ }),
180
+ ),
181
+ }))
182
+
183
+ return result
184
+ }
185
+
186
+ func addIterableFunction(
187
+ state *TransformState,
188
+ expression luau.Expression,
189
+ arrayID luau.AnyIdentifier,
190
+ lengthID luau.AnyIdentifier,
191
+ amtElementsSinceUpdate float64,
192
+ shouldUpdateLengthID bool,
193
+ ) *luau.List {
194
+ result := luau.NewList()
195
+
196
+ if amtElementsSinceUpdate > 0 {
197
+ result.Push(luau.Create(&luau.Assignment{
198
+ Left: lengthID,
199
+ Operator: luau.AssignAdd,
200
+ Right: luau.NewNumber(amtElementsSinceUpdate),
201
+ }))
202
+ }
203
+
204
+ valueID := luau.NewTempID("result")
205
+
206
+ result.Push(luau.Create(&luau.ForStatement{
207
+ IDs: luau.MakeList[luau.Node](valueID),
208
+ Expression: expression,
209
+ Statements: luau.MakeList[luau.Node](
210
+ luau.Create(&luau.Assignment{
211
+ Left: lengthID,
212
+ Operator: luau.AssignAdd,
213
+ Right: luau.NewNumber(1),
214
+ }),
215
+ luau.Create(&luau.Assignment{
216
+ Left: luau.Create(&luau.ComputedIndexExpression{
217
+ Expression: arrayID,
218
+ Index: lengthID,
219
+ }),
220
+ Operator: luau.AssignEqual,
221
+ Right: valueID,
222
+ }),
223
+ ),
224
+ }))
225
+
226
+ return result
227
+ }
228
+
229
+ func addIterableFunctionLuaTuple(
230
+ state *TransformState,
231
+ expression luau.Expression,
232
+ arrayID luau.AnyIdentifier,
233
+ lengthID luau.AnyIdentifier,
234
+ amtElementsSinceUpdate float64,
235
+ shouldUpdateLengthID bool,
236
+ ) *luau.List {
237
+ result := luau.NewList()
238
+
239
+ if amtElementsSinceUpdate > 0 {
240
+ result.Push(luau.Create(&luau.Assignment{
241
+ Left: lengthID,
242
+ Operator: luau.AssignAdd,
243
+ Right: luau.NewNumber(amtElementsSinceUpdate),
244
+ }))
245
+ }
246
+
247
+ iterFuncID := state.PushToVar(expression, "iterFunc")
248
+ valueID := luau.NewTempID("results")
249
+ result.Push(luau.Create(&luau.WhileStatement{
250
+ Condition: luau.NewBool(true),
251
+ Statements: luau.MakeList[luau.Node](
252
+ luau.Create(&luau.VariableDeclaration{
253
+ Left: valueID,
254
+ Right: luau.NewArray(luau.NewCall(iterFuncID)),
255
+ }),
256
+ luau.Create(&luau.IfStatement{
257
+ Condition: luau.NewBinary(luau.NewUnary(luau.UnaryLen, valueID), luau.BinaryEqual, luau.NewNumber(0)),
258
+ Statements: luau.MakeList(luau.Create(&luau.BreakStatement{})),
259
+ ElseBody: luau.NewList(),
260
+ }),
261
+ luau.Create(&luau.Assignment{
262
+ Left: lengthID,
263
+ Operator: luau.AssignAdd,
264
+ Right: luau.NewNumber(1),
265
+ }),
266
+ luau.Create(&luau.Assignment{
267
+ Left: luau.Create(&luau.ComputedIndexExpression{
268
+ Expression: arrayID,
269
+ Index: lengthID,
270
+ }),
271
+ Operator: luau.AssignEqual,
272
+ Right: valueID,
273
+ }),
274
+ ),
275
+ }))
276
+
277
+ return result
278
+ }
279
+
280
+ func addGenerator(
281
+ state *TransformState,
282
+ expression luau.Expression,
283
+ arrayID luau.AnyIdentifier,
284
+ lengthID luau.AnyIdentifier,
285
+ amtElementsSinceUpdate float64,
286
+ shouldUpdateLengthID bool,
287
+ ) *luau.List {
288
+ result := luau.NewList()
289
+
290
+ if amtElementsSinceUpdate > 0 {
291
+ result.Push(luau.Create(&luau.Assignment{
292
+ Left: lengthID,
293
+ Operator: luau.AssignAdd,
294
+ Right: luau.NewNumber(amtElementsSinceUpdate),
295
+ }))
296
+ }
297
+
298
+ iterID := luau.NewTempID("result")
299
+ result.Push(luau.Create(&luau.ForStatement{
300
+ IDs: luau.MakeList[luau.Node](iterID),
301
+ Expression: luau.NewProperty(convertToIndexableExpression(expression), "next"),
302
+ Statements: luau.MakeList[luau.Node](
303
+ luau.Create(&luau.IfStatement{
304
+ Condition: luau.NewProperty(iterID, "done"),
305
+ Statements: luau.MakeList(luau.Create(&luau.BreakStatement{})),
306
+ ElseBody: luau.NewList(),
307
+ }),
308
+ luau.Create(&luau.Assignment{
309
+ Left: lengthID,
310
+ Operator: luau.AssignAdd,
311
+ Right: luau.NewNumber(1),
312
+ }),
313
+ luau.Create(&luau.Assignment{
314
+ Left: luau.Create(&luau.ComputedIndexExpression{
315
+ Expression: arrayID,
316
+ Index: lengthID,
317
+ }),
318
+ Operator: luau.AssignEqual,
319
+ Right: luau.NewProperty(iterID, "value"),
320
+ }),
321
+ ),
322
+ }))
323
+
324
+ return result
325
+ }
326
+
327
+ func addNothing(
328
+ state *TransformState,
329
+ expression luau.Expression,
330
+ arrayID luau.AnyIdentifier,
331
+ lengthID luau.AnyIdentifier,
332
+ amtElementsSinceUpdate float64,
333
+ shouldUpdateLengthID bool,
334
+ ) *luau.List {
335
+ return luau.NewList()
336
+ }
337
+
338
+ func getAddIterableToArrayBuilder(state *TransformState, node *ast.Node, t *checker.Type) addIterableToArrayBuilder {
339
+ if isDefinitelyType(t, isArrayType(state)) {
340
+ return addArray
341
+ } else if isDefinitelyType(t, isStringType) {
342
+ return addString
343
+ } else if isDefinitelyType(t, isSetType(state)) {
344
+ return addSet
345
+ } else if isDefinitelyType(t, isMapType(state)) {
346
+ return addMap
347
+ } else if isDefinitelyType(t, isIterableFunctionLuaTupleType(state)) {
348
+ return addIterableFunctionLuaTuple
349
+ } else if isDefinitelyType(t, isIterableFunctionType(state)) {
350
+ return addIterableFunction
351
+ } else if isDefinitelyType(t, isGeneratorType(state)) {
352
+ return addGenerator
353
+ } else if isDefinitelyType(t, isIterableType(state)) {
354
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoIterableIteration.At(shared.AtNode(node)))
355
+ return addNothing
356
+ } else if t.IsUnion() {
357
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoMacroUnion.At(shared.AtNode(node)))
358
+ return addNothing
359
+ } else {
360
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoUnsupportedIteration.At(shared.AtNode(node)))
361
+ return addNothing
362
+ }
363
+ }
@@ -0,0 +1,15 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getAssignableValue.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/checker"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ )
9
+
10
+ func getAssignableValue(operator luau.AssignmentOperator, value luau.Expression, valueType *checker.Type) luau.Expression {
11
+ if operator == luau.AssignConcat && !isDefinitelyType(valueType, isStringType) {
12
+ return luau.NewCall(luau.Globals.Tostring, value)
13
+ }
14
+ return value
15
+ }
@@ -0,0 +1,20 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getConstantValueLiteral.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/internal/jsnum"
8
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
9
+ )
10
+
11
+ // getConstantValueLiteral returns nil where JS returns undefined.
12
+ func getConstantValueLiteral(state *TransformState, node *ast.Node) luau.Expression {
13
+ switch constantValue := state.Checker.GetConstantValue(node).(type) {
14
+ case string:
15
+ return luau.NewString(constantValue)
16
+ case jsnum.Number:
17
+ return luau.NewNumber(float64(constantValue))
18
+ }
19
+ return nil
20
+ }
@@ -0,0 +1,34 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getDeclaredVariables.ts.
4
+
5
+ import "github.com/microsoft/TypeScript/tsc/internal/ast"
6
+
7
+ func getDeclaredVariablesFromBindingName(node *ast.Node, list *[]*ast.Node) {
8
+ if ast.IsIdentifier(node) {
9
+ *list = append(*list, node)
10
+ } else if ast.IsObjectBindingPattern(node) {
11
+ for _, element := range node.AsBindingPattern().Elements.Nodes {
12
+ getDeclaredVariablesFromBindingName(element.Name(), list)
13
+ }
14
+ } else if ast.IsArrayBindingPattern(node) {
15
+ for _, element := range node.AsBindingPattern().Elements.Nodes {
16
+ // In TS 7 an omitted element is a ts.BindingElement with a nil name.
17
+ if element.Name() != nil {
18
+ getDeclaredVariablesFromBindingName(element.Name(), list)
19
+ }
20
+ }
21
+ }
22
+ }
23
+
24
+ func getDeclaredVariables(node *ast.Node) []*ast.Node {
25
+ list := []*ast.Node{}
26
+ if ast.IsVariableDeclarationList(node) {
27
+ for _, declaration := range node.AsVariableDeclarationList().Declarations.Nodes {
28
+ getDeclaredVariablesFromBindingName(declaration.Name(), &list)
29
+ }
30
+ } else {
31
+ getDeclaredVariablesFromBindingName(node.Name(), &list)
32
+ }
33
+ return list
34
+ }
@@ -0,0 +1,23 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getExtendsNode.ts.
4
+
5
+ import "github.com/microsoft/TypeScript/tsc/internal/ast"
6
+
7
+ // getExtendsNode returns nil where JS returns undefined.
8
+ func getExtendsNode(node *ast.Node) *ast.Node {
9
+ heritageClauses := node.ClassLikeData().HeritageClauses
10
+ if heritageClauses == nil {
11
+ return nil
12
+ }
13
+ for _, clause := range heritageClauses.Nodes {
14
+ heritageClause := clause.AsHeritageClause()
15
+ if heritageClause.Token == ast.KindExtendsKeyword {
16
+ if len(heritageClause.Types.Nodes) == 0 {
17
+ return nil
18
+ }
19
+ return heritageClause.Types.Nodes[0]
20
+ }
21
+ }
22
+ return nil
23
+ }
@@ -0,0 +1,21 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getFlags.ts.
4
+
5
+ // for debugging purposes: extracts flag names from a bitfield
6
+
7
+ // getFlagsEntry is one entry of the `from` record. A slice keeps the order that Object.entries gives.
8
+ type getFlagsEntry[T ~int | ~int32 | ~uint32 | ~int64 | ~uint64] struct {
9
+ name string
10
+ value T
11
+ }
12
+
13
+ func getFlags[T ~int | ~int32 | ~uint32 | ~int64 | ~uint64](flags T, from []getFlagsEntry[T]) []string {
14
+ results := []string{}
15
+ for _, entry := range from {
16
+ if flags&entry.value != 0 {
17
+ results = append(results, entry.name)
18
+ }
19
+ }
20
+ return results
21
+ }
@@ -0,0 +1,18 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getKindName.ts.
4
+
5
+ import (
6
+ "strings"
7
+
8
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
9
+ )
10
+
11
+ // getKindName is only used in assertion messages. Upstream's chain of tests is there because ts.SyntaxKind[kind] gives
12
+ // the alias for a kind that has one, like FirstAssignment. Kind.String() has no aliases. It leaves one name to fix up.
13
+ func getKindName(kind ast.Kind) string {
14
+ if kind == ast.KindEndOfFile {
15
+ return "EndOfFileToken"
16
+ }
17
+ return strings.TrimPrefix(kind.String(), "Kind")
18
+ }
@@ -0,0 +1,16 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getOriginalSymbolOfNode.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/internal/checker"
8
+ )
9
+
10
+ func getOriginalSymbolOfNode(typeChecker *checker.Checker, node *ast.Node) *ast.Symbol {
11
+ symbol := typeChecker.GetSymbolAtLocation(node)
12
+ if symbol != nil {
13
+ return typeChecker.SkipAlias(symbol)
14
+ }
15
+ return symbol
16
+ }
@@ -0,0 +1,68 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getSourceFileFromModuleSpecifier.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/internal/core"
8
+ "github.com/microsoft/TypeScript/tsc/internal/module"
9
+ "github.com/microsoft/TypeScript/tsc/internal/tspath"
10
+ "github.com/microsoft/TypeScript/tsc/internal/vfs"
11
+ )
12
+
13
+ // getSourceFileFromModuleSpecifier returns nil where JS returns undefined. A resolved file goes through
14
+ // GetSourceFileForResolvedModule, because the program leaves out a package that duplicates another one, where JS keeps a
15
+ // redirect file under its own path. There the Go answer is the redirect's target.
16
+ func getSourceFileFromModuleSpecifier(state *TransformState, moduleSpecifier *ast.Node) *ast.SourceFile {
17
+ symbol := state.Checker.GetSymbolAtLocation(moduleSpecifier)
18
+ if symbol == nil {
19
+ symbol = state.Checker.ResolveExternalModuleName(moduleSpecifier, nil)
20
+ }
21
+ if symbol != nil {
22
+ declaration := symbol.ValueDeclaration()
23
+
24
+ if declaration != nil && ast.IsModuleDeclaration(declaration) && ast.IsStringLiteralLike(declaration.Name()) {
25
+ sourceFile := ast.GetSourceFileOfNode(moduleSpecifier)
26
+ mode := state.Program.GetModeForUsageLocation(sourceFile, declaration.Name())
27
+ resolvedModuleInfo := state.Program.GetResolvedModule(sourceFile, declaration.Name().Text(), mode)
28
+ if resolvedModuleInfo != nil && resolvedModuleInfo.IsResolved() {
29
+ return state.Program.GetSourceFileForResolvedModule(resolvedModuleInfo)
30
+ }
31
+ }
32
+
33
+ if declaration != nil && ast.IsSourceFile(declaration) {
34
+ return declaration.AsSourceFile()
35
+ }
36
+ }
37
+
38
+ // Fallback for $getModuleTree when module is not referenced by any regular import
39
+ if ast.IsStringLiteralLike(moduleSpecifier) {
40
+ sourceFile := ast.GetSourceFileOfNode(moduleSpecifier)
41
+ // This has to really resolve, as ts.resolveModuleName does. Program.GetResolvedModuleFromModuleSpecifier only
42
+ // looks up imports the program saw, and this specifier isn't one, so it would always miss here.
43
+ resolver := module.NewResolver(module.ResolverOptions{
44
+ Host: &moduleSpecifierResolutionHost{
45
+ fs: state.Program.Host().FS(),
46
+ currentDirectory: state.Program.GetCurrentDirectory(),
47
+ },
48
+ CompilerOptions: state.Options,
49
+ })
50
+ result, _, _ := resolver.ResolveModuleName(moduleSpecifier.Text(), sourceFile.FileName(), core.ResolutionModeNone, nil)
51
+ if result != nil && result.IsResolved() {
52
+ return state.Program.GetSourceFileForResolvedModule(result)
53
+ }
54
+ }
55
+ return nil
56
+ }
57
+
58
+ // moduleSpecifierResolutionHost stands in for ts.sys.
59
+ type moduleSpecifierResolutionHost struct {
60
+ fs vfs.FS
61
+ currentDirectory tspath.RootedDirectoryPath
62
+ }
63
+
64
+ func (h *moduleSpecifierResolutionHost) FS() vfs.FS { return h.fs }
65
+
66
+ func (h *moduleSpecifierResolutionHost) GetCurrentDirectory() tspath.RootedDirectoryPath {
67
+ return h.currentDirectory
68
+ }
@@ -0,0 +1,12 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/getStatements.ts.
4
+
5
+ import "github.com/microsoft/TypeScript/tsc/internal/ast"
6
+
7
+ func getStatements(statement *ast.Node) []*ast.Node {
8
+ if ast.IsBlock(statement) {
9
+ return statement.AsBlock().Statements.Nodes
10
+ }
11
+ return []*ast.Node{statement}
12
+ }
@@ -0,0 +1,18 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/util/hasMultipleDefinitions.ts.
4
+
5
+ import "github.com/microsoft/TypeScript/tsc/internal/ast"
6
+
7
+ func hasMultipleDefinitions(symbol *ast.Symbol, filter func(declaration *ast.Node) bool) bool {
8
+ amtValueDefinitions := 0
9
+ for _, declaration := range symbol.Declarations() {
10
+ if filter(declaration) {
11
+ amtValueDefinitions++
12
+ if amtValueDefinitions > 1 {
13
+ return true
14
+ }
15
+ }
16
+ }
17
+ return false
18
+ }
@@ -0,0 +1,43 @@
1
+ package transformer
2
+
3
+ // With fixEmit, function declarations after a return, break or continue (upstream issues #2847 and #2098, open with no
4
+ // fix). In JS a function declaration exists from the start of its block, and can see every binding in the block. Luau
5
+ // allows nothing after a final statement, so transformStatementList stops there and the function is gone, which leaves
6
+ // its callers with a nil local.
7
+
8
+ import "github.com/microsoft/TypeScript/tsc/internal/ast"
9
+
10
+ // hoistFunctionsPastFinalStatement returns the statements to compile for a block: the function declarations after its
11
+ // first final statement, then what comes before that statement, and that statement. That's where JS has them, and
12
+ // everything else after a final statement stays dropped, because JS never runs it.
13
+ //
14
+ // It marks the functions in state.HoistedPastFinal, for checkIdentifierHoist. Nothing needs a hoist for such a function,
15
+ // because it already exists, and whatever a block's later local such a function refers to does need one.
16
+ func hoistFunctionsPastFinalStatement(state *TransformState, statements []*ast.Node) []*ast.Node {
17
+ finalIndex := -1
18
+ for i, statement := range statements {
19
+ if ast.IsReturnStatement(statement) || ast.IsBreakStatement(statement) || ast.IsContinueStatement(statement) {
20
+ finalIndex = i
21
+ break
22
+ }
23
+ }
24
+ if finalIndex < 0 {
25
+ return statements
26
+ }
27
+ var functions []*ast.Node
28
+ for _, statement := range statements[finalIndex+1:] {
29
+ if ast.IsFunctionDeclaration(statement) {
30
+ functions = append(functions, statement)
31
+ }
32
+ }
33
+ if len(functions) == 0 {
34
+ return statements
35
+ }
36
+ if state.hoistedPastFinal == nil {
37
+ state.hoistedPastFinal = map[*ast.Node]bool{}
38
+ }
39
+ for _, function := range functions {
40
+ state.hoistedPastFinal[function] = true
41
+ }
42
+ return append(functions, statements[:finalIndex+1]...)
43
+ }
@@ -0,0 +1,17 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/macros/identifierMacros.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ )
9
+
10
+ // identifierMacros is IDENTIFIER_MACROS.
11
+ func identifierMacros() map[string]identifierMacro {
12
+ return map[string]identifierMacro{
13
+ "Promise": func(state *TransformState, node *ast.Node) luau.Expression {
14
+ return state.TS(node, "Promise")
15
+ },
16
+ }
17
+ }