@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,1035 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/macros/propertyCallMacros.ts.
4
+ //
5
+ // Upstream's tables are nested by class and wrapped in place when the module loads. Here the lists are functions, so
6
+ // they don't cause an initialization cycle, and propertyCallMacros flattens them into one table keyed "Class.method".
7
+
8
+ import (
9
+ "slices"
10
+ "strconv"
11
+
12
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
13
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
14
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
15
+ )
16
+
17
+ func makeMathMethod(operator luau.BinaryOperator) propertyCallMacro {
18
+ return func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
19
+ rhs := args[0]
20
+ if !luau.IsSimple(rhs) {
21
+ rhs = luau.Create(&luau.ParenthesizedExpression{Expression: rhs})
22
+ }
23
+ return luau.NewBinary(expression, operator, rhs)
24
+ }
25
+ }
26
+
27
+ var operatorToNameMap = map[luau.BinaryOperator]string{
28
+ luau.BinaryAdd: "add",
29
+ luau.BinarySub: "sub",
30
+ luau.BinaryMul: "mul",
31
+ luau.BinaryDiv: "div",
32
+ luau.BinaryFloorDiv: "idiv",
33
+ }
34
+
35
+ func makeMathSet(operators ...luau.BinaryOperator) map[string]propertyCallMacro {
36
+ result := map[string]propertyCallMacro{}
37
+ for _, operator := range operators {
38
+ methodName := operatorToNameMap[operator]
39
+ if methodName == "" {
40
+ panic(shared.AssertionMessage(""))
41
+ }
42
+ result[methodName] = makeMathMethod(operator)
43
+ }
44
+ return result
45
+ }
46
+
47
+ func makeStringCallback(strCallback *luau.PropertyAccessExpression) propertyCallMacro {
48
+ return func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
49
+ return luau.NewCall(strCallback, append([]luau.Expression{expression}, args...)...)
50
+ }
51
+ }
52
+
53
+ func stringCallbacks() map[string]propertyCallMacro {
54
+ return map[string]propertyCallMacro{
55
+ "size": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
56
+ return luau.NewUnary(luau.UnaryLen, expression)
57
+ },
58
+
59
+ "byte": makeStringCallback(luau.Globals.String.Byte),
60
+ "find": makeStringCallback(luau.Globals.String.Find),
61
+ "format": makeStringCallback(luau.Globals.String.Format),
62
+ "gmatch": makeStringCallback(luau.Globals.String.Gmatch),
63
+ "gsub": makeStringCallback(luau.Globals.String.Gsub),
64
+ "lower": makeStringCallback(luau.Globals.String.Lower),
65
+ "match": makeStringCallback(luau.Globals.String.Match),
66
+ "rep": makeStringCallback(luau.Globals.String.Rep),
67
+ "reverse": makeStringCallback(luau.Globals.String.Reverse),
68
+ "split": makeStringCallback(luau.Globals.String.Split),
69
+ "sub": makeStringCallback(luau.Globals.String.Sub),
70
+ "upper": makeStringCallback(luau.Globals.String.Upper),
71
+ }
72
+ }
73
+
74
+ func makeEveryOrSomeMethod(
75
+ callbackArgsListMaker func(keyID *luau.TemporaryIdentifier, valueID *luau.TemporaryIdentifier, expression luau.Expression) []luau.Expression,
76
+ initialState bool,
77
+ ) propertyCallMacro {
78
+ return func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
79
+ expression = state.PushToVarIfComplex(expression, "exp")
80
+
81
+ resultID := state.PushToVar(luau.NewBool(initialState), "result")
82
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
83
+
84
+ keyID := luau.NewTempID("k")
85
+ valueID := luau.NewTempID("v")
86
+
87
+ callCallback := luau.NewCall(callbackID, callbackArgsListMaker(keyID, valueID, expression)...)
88
+ var condition luau.Expression = callCallback
89
+ if initialState {
90
+ condition = luau.NewUnary(luau.UnaryNot, callCallback)
91
+ }
92
+ state.Prereq(luau.Create(&luau.ForStatement{
93
+ IDs: luau.MakeList(keyID, valueID),
94
+ Expression: expression,
95
+ Statements: luau.MakeList[luau.Statement](
96
+ luau.Create(&luau.IfStatement{
97
+ Condition: condition,
98
+ Statements: luau.MakeList[luau.Statement](
99
+ luau.Create(&luau.Assignment{
100
+ Left: resultID,
101
+ Operator: luau.AssignEqual,
102
+ Right: luau.NewBool(!initialState),
103
+ }),
104
+ luau.Create(&luau.BreakStatement{}),
105
+ ),
106
+ ElseBody: luau.NewList(),
107
+ }),
108
+ ),
109
+ }))
110
+
111
+ return resultID
112
+ }
113
+ }
114
+
115
+ func makeEveryMethod(
116
+ callbackArgsListMaker func(keyID *luau.TemporaryIdentifier, valueID *luau.TemporaryIdentifier, expression luau.Expression) []luau.Expression,
117
+ ) propertyCallMacro {
118
+ return makeEveryOrSomeMethod(callbackArgsListMaker, true)
119
+ }
120
+
121
+ func makeSomeMethod(
122
+ callbackArgsListMaker func(keyID *luau.TemporaryIdentifier, valueID *luau.TemporaryIdentifier, expression luau.Expression) []luau.Expression,
123
+ ) propertyCallMacro {
124
+ return makeEveryOrSomeMethod(callbackArgsListMaker, false)
125
+ }
126
+
127
+ func argumentsWithDefaults(state *TransformState, args []luau.Expression, defaults []luau.Expression) []luau.Expression {
128
+ // potentially nil arguments
129
+ for i := 0; i < len(args); i++ {
130
+ if !luau.IsSimplePrimitive(args[i]) {
131
+ name := valueToIDStr(args[i])
132
+ if name == "" {
133
+ name = "arg" + strconv.Itoa(i)
134
+ }
135
+ args[i] = state.PushToVar(args[i], name)
136
+ state.Prereq(luau.Create(&luau.IfStatement{
137
+ Condition: luau.NewBinary(args[i], luau.BinaryEqual, luau.NewNil()),
138
+ Statements: luau.MakeList[luau.Statement](
139
+ luau.Create(&luau.Assignment{
140
+ Left: args[i],
141
+ Operator: luau.AssignEqual,
142
+ Right: defaults[i],
143
+ }),
144
+ ),
145
+ ElseBody: luau.NewList(),
146
+ }))
147
+ }
148
+ }
149
+
150
+ // not specified
151
+ for j := len(args); j < len(defaults); j++ {
152
+ args = append(args, defaults[j])
153
+ }
154
+
155
+ return args
156
+ }
157
+
158
+ func arrayLikeMethods() map[string]propertyCallMacro {
159
+ return map[string]propertyCallMacro{
160
+ "size": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
161
+ return luau.NewUnary(luau.UnaryLen, expression)
162
+ },
163
+ }
164
+ }
165
+
166
+ func readonlyArrayMethods() map[string]propertyCallMacro {
167
+ return map[string]propertyCallMacro{
168
+ "isEmpty": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
169
+ return luau.NewBinary(luau.NewUnary(luau.UnaryLen, expression), luau.BinaryEqual, luau.NewNumber(0))
170
+ },
171
+
172
+ "join": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
173
+ args = argumentsWithDefaults(state, args, []luau.Expression{luau.Strings.Comma})
174
+ indexType := state.Checker.GetIndexTypeOfType(state.GetType(node.Expression().Expression()), state.Checker.GetNumberType())
175
+
176
+ // table.concat only works on string and number types, so call tostring() otherwise
177
+ if indexType != nil && !isDefinitelyType(indexType, isStringType, isNumberType) {
178
+ expression = state.PushToVarIfComplex(expression, "exp")
179
+ id := state.PushToVar(luau.NewCall(luau.Globals.Table.Create, luau.NewUnary(luau.UnaryLen, expression)), "result")
180
+ keyID := luau.NewTempID("k")
181
+ valueID := luau.NewTempID("v")
182
+ state.Prereq(luau.Create(&luau.ForStatement{
183
+ IDs: luau.MakeList(keyID, valueID),
184
+ Expression: expression,
185
+ Statements: luau.MakeList[luau.Statement](
186
+ luau.Create(&luau.Assignment{
187
+ Left: luau.Create(&luau.ComputedIndexExpression{
188
+ Expression: id,
189
+ Index: keyID,
190
+ }),
191
+ Operator: luau.AssignEqual,
192
+ Right: luau.NewCall(luau.Globals.Tostring, valueID),
193
+ }),
194
+ ),
195
+ }))
196
+
197
+ expression = id
198
+ }
199
+
200
+ return luau.NewCall(luau.Globals.Table.Concat, expression, args[0])
201
+ },
202
+
203
+ "move": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
204
+ moveArgs := []luau.Expression{expression, offset(args[0], 1), offset(args[1], 1), offset(args[2], 1)}
205
+ if len(args) > 3 {
206
+ moveArgs = append(moveArgs, args[3])
207
+ }
208
+ return luau.NewCall(luau.Globals.Table.Move, moveArgs...)
209
+ },
210
+
211
+ "includes": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
212
+ callArgs := []luau.Expression{expression, args[0]}
213
+ if len(args) > 1 {
214
+ callArgs = append(callArgs, offset(args[1], 1))
215
+ }
216
+ return luau.NewBinary(luau.NewCall(luau.Globals.Table.Find, callArgs...), luau.BinaryNotEqual, luau.NewNil())
217
+ },
218
+
219
+ "indexOf": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
220
+ findArgs := []luau.Expression{expression, args[0]}
221
+
222
+ if len(args) > 1 {
223
+ findArgs = append(findArgs, offset(args[1], 1))
224
+ }
225
+
226
+ return offset(
227
+ luau.Create(&luau.BinaryExpression{
228
+ Left: luau.NewCall(luau.Globals.Table.Find, findArgs...),
229
+ Operator: luau.BinaryOr,
230
+ Right: luau.NewNumber(0),
231
+ }),
232
+ -1,
233
+ )
234
+ },
235
+
236
+ "every": makeEveryMethod(func(keyID *luau.TemporaryIdentifier, valueID *luau.TemporaryIdentifier, expression luau.Expression) []luau.Expression {
237
+ return []luau.Expression{valueID, offset(keyID, -1), expression}
238
+ }),
239
+
240
+ "some": makeSomeMethod(func(keyID *luau.TemporaryIdentifier, valueID *luau.TemporaryIdentifier, expression luau.Expression) []luau.Expression {
241
+ return []luau.Expression{valueID, offset(keyID, -1), expression}
242
+ }),
243
+
244
+ "forEach": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
245
+ expression = state.PushToVarIfComplex(expression, "exp")
246
+
247
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
248
+ keyID := luau.NewTempID("k")
249
+ valueID := luau.NewTempID("v")
250
+ state.Prereq(luau.Create(&luau.ForStatement{
251
+ IDs: luau.MakeList(keyID, valueID),
252
+ Expression: expression,
253
+ Statements: luau.MakeList[luau.Statement](
254
+ luau.Create(&luau.CallStatement{
255
+ Expression: luau.NewCall(callbackID, valueID, offset(keyID, -1), expression),
256
+ }),
257
+ ),
258
+ }))
259
+
260
+ if !isUsedAsStatement(node) {
261
+ return luau.NewNil()
262
+ }
263
+ return luau.NewNone()
264
+ },
265
+
266
+ "map": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
267
+ expression = state.PushToVarIfComplex(expression, "exp")
268
+ newValueID := state.PushToVar(
269
+ luau.NewCall(luau.Globals.Table.Create, luau.NewUnary(luau.UnaryLen, expression)),
270
+ "newValue",
271
+ )
272
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
273
+ keyID := luau.NewTempID("k")
274
+ valueID := luau.NewTempID("v")
275
+ state.Prereq(luau.Create(&luau.ForStatement{
276
+ IDs: luau.MakeList(keyID, valueID),
277
+ Expression: expression,
278
+ Statements: luau.MakeList[luau.Statement](
279
+ luau.Create(&luau.Assignment{
280
+ Left: luau.Create(&luau.ComputedIndexExpression{
281
+ Expression: newValueID,
282
+ Index: keyID,
283
+ }),
284
+ Operator: luau.AssignEqual,
285
+ Right: luau.NewCall(callbackID, valueID, offset(keyID, -1), expression),
286
+ }),
287
+ ),
288
+ }))
289
+
290
+ return newValueID
291
+ },
292
+
293
+ "mapFiltered": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
294
+ expression = state.PushToVarIfComplex(expression, "exp")
295
+
296
+ newValueID := state.PushToVar(luau.NewArray(), "newValue")
297
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
298
+ lengthID := state.PushToVar(luau.NewNumber(0), "length")
299
+ keyID := luau.NewTempID("k")
300
+ valueID := luau.NewTempID("v")
301
+ resultID := luau.NewTempID("result")
302
+ state.Prereq(luau.Create(&luau.ForStatement{
303
+ IDs: luau.MakeList(keyID, valueID),
304
+ Expression: expression,
305
+ Statements: luau.MakeList[luau.Statement](
306
+ luau.Create(&luau.VariableDeclaration{
307
+ Left: resultID,
308
+ Right: luau.NewCall(callbackID, valueID, offset(keyID, -1), expression),
309
+ }),
310
+ luau.Create(&luau.IfStatement{
311
+ Condition: luau.NewBinary(resultID, luau.BinaryNotEqual, luau.NewNil()),
312
+ Statements: luau.MakeList[luau.Statement](
313
+ luau.Create(&luau.Assignment{
314
+ Left: lengthID,
315
+ Operator: luau.AssignAdd,
316
+ Right: luau.NewNumber(1),
317
+ }),
318
+ luau.Create(&luau.Assignment{
319
+ Left: luau.Create(&luau.ComputedIndexExpression{
320
+ Expression: newValueID,
321
+ Index: lengthID,
322
+ }),
323
+ Operator: luau.AssignEqual,
324
+ Right: resultID,
325
+ }),
326
+ ),
327
+ ElseBody: luau.NewList(),
328
+ }),
329
+ ),
330
+ }))
331
+
332
+ return newValueID
333
+ },
334
+
335
+ "filterUndefined": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
336
+ expression = state.PushToVarIfComplex(expression, "exp")
337
+
338
+ lengthID := state.PushToVar(luau.NewNumber(0), "length")
339
+ indexID1 := luau.NewTempID("i")
340
+ state.Prereq(luau.Create(&luau.ForStatement{
341
+ IDs: luau.MakeList(indexID1),
342
+ Expression: expression,
343
+ Statements: luau.MakeList[luau.Statement](
344
+ luau.Create(&luau.IfStatement{
345
+ Condition: luau.NewBinary(indexID1, luau.BinaryGreater, lengthID),
346
+ Statements: luau.MakeList[luau.Statement](
347
+ luau.Create(&luau.Assignment{
348
+ Left: lengthID,
349
+ Operator: luau.AssignEqual,
350
+ Right: indexID1,
351
+ }),
352
+ ),
353
+ ElseBody: luau.NewList(),
354
+ }),
355
+ ),
356
+ }))
357
+
358
+ resultID := state.PushToVar(luau.NewArray(), "result")
359
+ resultLengthID := state.PushToVar(luau.NewNumber(0), "resultLength")
360
+ indexID2 := luau.NewTempID("i")
361
+ valueID := luau.NewTempID("v")
362
+ state.Prereq(luau.Create(&luau.NumericForStatement{
363
+ ID: indexID2,
364
+ Start: luau.NewNumber(1),
365
+ End: lengthID,
366
+
367
+ Statements: luau.MakeList[luau.Statement](
368
+ luau.Create(&luau.VariableDeclaration{
369
+ Left: valueID,
370
+ Right: luau.Create(&luau.ComputedIndexExpression{
371
+ Expression: convertToIndexableExpression(expression),
372
+ Index: indexID2,
373
+ }),
374
+ }),
375
+ luau.Create(&luau.IfStatement{
376
+ Condition: luau.NewBinary(valueID, luau.BinaryNotEqual, luau.NewNil()),
377
+ Statements: luau.MakeList[luau.Statement](
378
+ luau.Create(&luau.Assignment{
379
+ Left: resultLengthID,
380
+ Operator: luau.AssignAdd,
381
+ Right: luau.NewNumber(1),
382
+ }),
383
+ luau.Create(&luau.Assignment{
384
+ Left: luau.Create(&luau.ComputedIndexExpression{
385
+ Expression: resultID,
386
+ Index: resultLengthID,
387
+ }),
388
+ Operator: luau.AssignEqual,
389
+ Right: valueID,
390
+ }),
391
+ ),
392
+ ElseBody: luau.NewList(),
393
+ }),
394
+ ),
395
+ }))
396
+
397
+ return resultID
398
+ },
399
+
400
+ "filter": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
401
+ expression = state.PushToVarIfComplex(expression, "exp")
402
+
403
+ newValueID := state.PushToVar(luau.NewArray(), "newValue")
404
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
405
+ lengthID := state.PushToVar(luau.NewNumber(0), "length")
406
+ keyID := luau.NewTempID("k")
407
+ valueID := luau.NewTempID("v")
408
+ state.Prereq(luau.Create(&luau.ForStatement{
409
+ IDs: luau.MakeList(keyID, valueID),
410
+ Expression: expression,
411
+ Statements: luau.MakeList[luau.Statement](
412
+ luau.Create(&luau.IfStatement{
413
+ Condition: luau.Create(&luau.BinaryExpression{
414
+ Left: luau.NewCall(callbackID, valueID, offset(keyID, -1), expression),
415
+ Operator: luau.BinaryEqual,
416
+ Right: luau.NewBool(true),
417
+ }),
418
+ Statements: luau.MakeList[luau.Statement](
419
+ luau.Create(&luau.Assignment{
420
+ Left: lengthID,
421
+ Operator: luau.AssignAdd,
422
+ Right: luau.NewNumber(1),
423
+ }),
424
+ luau.Create(&luau.Assignment{
425
+ Left: luau.Create(&luau.ComputedIndexExpression{
426
+ Expression: newValueID,
427
+ Index: lengthID,
428
+ }),
429
+ Operator: luau.AssignEqual,
430
+ Right: valueID,
431
+ }),
432
+ ),
433
+ ElseBody: luau.NewList(),
434
+ }),
435
+ ),
436
+ }))
437
+
438
+ return newValueID
439
+ },
440
+
441
+ "reduce": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
442
+ expression = state.PushToVarIfComplex(expression, "exp")
443
+
444
+ var start luau.Expression = luau.NewNumber(1)
445
+ end := luau.NewUnary(luau.UnaryLen, expression)
446
+ const step = 1
447
+
448
+ lengthExp := luau.NewUnary(luau.UnaryLen, expression)
449
+
450
+ var resultID *luau.TemporaryIdentifier
451
+ // if there was no initialValue supplied
452
+ if len(args) < 2 {
453
+ state.Prereq(luau.Create(&luau.IfStatement{
454
+ Condition: luau.NewBinary(lengthExp, luau.BinaryEqual, luau.NewNumber(0)),
455
+ Statements: luau.MakeList[luau.Statement](
456
+ luau.Create(&luau.CallStatement{
457
+ Expression: luau.NewCall(luau.Globals.Error,
458
+ luau.NewString(
459
+ "Attempted to call `ReadonlyArray.reduce()` on an empty array without an initialValue.",
460
+ ),
461
+ ),
462
+ }),
463
+ ),
464
+ ElseBody: luau.NewList(),
465
+ }))
466
+ resultID = state.PushToVar(
467
+ luau.Create(&luau.ComputedIndexExpression{
468
+ Expression: convertToIndexableExpression(expression),
469
+ Index: start,
470
+ }),
471
+ "result",
472
+ )
473
+ start = offset(start, step)
474
+ } else {
475
+ resultID = state.PushToVar(args[1], "result")
476
+ }
477
+ callbackID := state.PushToVar(args[0], "callback")
478
+
479
+ iteratorID := luau.NewTempID("i")
480
+ var stepExpression luau.Expression
481
+ if step != 1 {
482
+ stepExpression = luau.NewNumber(step)
483
+ }
484
+ state.Prereq(luau.Create(&luau.NumericForStatement{
485
+ ID: iteratorID,
486
+ Start: start,
487
+ End: end,
488
+ Step: stepExpression,
489
+ Statements: luau.MakeList[luau.Statement](
490
+ luau.Create(&luau.Assignment{
491
+ Left: resultID,
492
+ Operator: luau.AssignEqual,
493
+ Right: luau.NewCall(callbackID,
494
+ resultID,
495
+ luau.Create(&luau.ComputedIndexExpression{
496
+ Expression: convertToIndexableExpression(expression),
497
+ Index: iteratorID,
498
+ }),
499
+ offset(iteratorID, -1),
500
+ expression,
501
+ ),
502
+ }),
503
+ ),
504
+ }))
505
+
506
+ return resultID
507
+ },
508
+
509
+ "find": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
510
+ expression = state.PushToVarIfComplex(expression, "exp")
511
+
512
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
513
+ loopID := luau.NewTempID("i")
514
+ valueID := luau.NewTempID("v")
515
+ resultID := state.PushToVar(nil, "result")
516
+
517
+ state.Prereq(luau.Create(&luau.ForStatement{
518
+ Expression: expression,
519
+ IDs: luau.MakeList(loopID, valueID),
520
+ Statements: luau.MakeList[luau.Statement](
521
+ luau.Create(&luau.IfStatement{
522
+ Condition: luau.Create(&luau.BinaryExpression{
523
+ Left: luau.NewCall(callbackID, valueID, offset(loopID, -1), expression),
524
+ Operator: luau.BinaryEqual,
525
+ Right: luau.NewBool(true),
526
+ }),
527
+ Statements: luau.MakeList[luau.Statement](
528
+ luau.Create(&luau.Assignment{
529
+ Left: resultID,
530
+ Operator: luau.AssignEqual,
531
+ Right: valueID,
532
+ }),
533
+ luau.Create(&luau.BreakStatement{}),
534
+ ),
535
+ ElseBody: luau.NewList(),
536
+ }),
537
+ ),
538
+ }))
539
+
540
+ return resultID
541
+ },
542
+
543
+ "findIndex": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
544
+ expression = state.PushToVarIfComplex(expression, "exp")
545
+
546
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
547
+ loopID := luau.NewTempID("i")
548
+ valueID := luau.NewTempID("v")
549
+ resultID := state.PushToVar(luau.NewNumber(-1), "result")
550
+
551
+ state.Prereq(luau.Create(&luau.ForStatement{
552
+ Expression: expression,
553
+ IDs: luau.MakeList(loopID, valueID),
554
+ Statements: luau.MakeList[luau.Statement](
555
+ luau.Create(&luau.IfStatement{
556
+ Condition: luau.Create(&luau.BinaryExpression{
557
+ Left: luau.NewCall(callbackID, valueID, offset(loopID, -1), expression),
558
+ Operator: luau.BinaryEqual,
559
+ Right: luau.NewBool(true),
560
+ }),
561
+ Statements: luau.MakeList[luau.Statement](
562
+ luau.Create(&luau.Assignment{
563
+ Left: resultID,
564
+ Operator: luau.AssignEqual,
565
+ Right: offset(loopID, -1),
566
+ }),
567
+ luau.Create(&luau.BreakStatement{}),
568
+ ),
569
+ ElseBody: luau.NewList(),
570
+ }),
571
+ ),
572
+ }))
573
+
574
+ return resultID
575
+ },
576
+ }
577
+ }
578
+
579
+ func arrayMethods() map[string]propertyCallMacro {
580
+ return map[string]propertyCallMacro{
581
+ "push": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
582
+ // for `a.push()` always emit luau.unary so the call doesn't disappear in emit
583
+ if len(args) == 0 {
584
+ return luau.NewUnary(luau.UnaryLen, expression)
585
+ }
586
+
587
+ expression = state.PushToVarIfComplex(expression, "exp")
588
+
589
+ for i := 0; i < len(args); i++ {
590
+ state.Prereq(luau.Create(&luau.CallStatement{
591
+ Expression: luau.NewCall(luau.Globals.Table.Insert, expression, args[i]),
592
+ }))
593
+ }
594
+
595
+ if !isUsedAsStatement(node) {
596
+ return luau.NewUnary(luau.UnaryLen, expression)
597
+ }
598
+ return luau.NewNone()
599
+ },
600
+
601
+ "pop": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
602
+ expression = state.PushToVarIfComplex(expression, "exp")
603
+
604
+ var lengthExp luau.Expression = luau.NewUnary(luau.UnaryLen, expression)
605
+
606
+ returnValueIsUsed := !isUsedAsStatement(node)
607
+ var retValue *luau.TemporaryIdentifier
608
+ if returnValueIsUsed {
609
+ lengthExp = state.PushToVar(lengthExp, "length")
610
+ retValue = state.PushToVar(
611
+ luau.Create(&luau.ComputedIndexExpression{
612
+ Expression: convertToIndexableExpression(expression),
613
+ Index: lengthExp,
614
+ }),
615
+ "result",
616
+ )
617
+ }
618
+
619
+ state.Prereq(luau.Create(&luau.Assignment{
620
+ Left: luau.Create(&luau.ComputedIndexExpression{
621
+ Expression: convertToIndexableExpression(expression),
622
+ Index: lengthExp,
623
+ }),
624
+ Operator: luau.AssignEqual,
625
+ Right: luau.NewNil(),
626
+ }))
627
+
628
+ if returnValueIsUsed {
629
+ return retValue
630
+ }
631
+ return luau.NewNone()
632
+ },
633
+
634
+ "shift": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
635
+ return luau.NewCall(luau.Globals.Table.Remove, expression, luau.NewNumber(1))
636
+ },
637
+
638
+ "unshift": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
639
+ expression = state.PushToVarIfComplex(expression, "exp")
640
+
641
+ for i := len(args) - 1; i >= 0; i-- {
642
+ arg := args[i]
643
+ state.Prereq(luau.Create(&luau.CallStatement{
644
+ Expression: luau.NewCall(luau.Globals.Table.Insert, expression, luau.NewNumber(1), arg),
645
+ }))
646
+ }
647
+
648
+ if !isUsedAsStatement(node) {
649
+ return luau.NewUnary(luau.UnaryLen, expression)
650
+ }
651
+ return luau.NewNone()
652
+ },
653
+
654
+ "insert": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
655
+ return luau.NewCall(luau.Globals.Table.Insert, expression, offset(args[0], 1), args[1])
656
+ },
657
+
658
+ "remove": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
659
+ return luau.NewCall(luau.Globals.Table.Remove, expression, offset(args[0], 1))
660
+ },
661
+
662
+ "unorderedRemove": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
663
+ indexExp := state.PushToVarIfComplex(offset(args[0], 1), "index")
664
+
665
+ expression = state.PushToVarIfComplex(expression, "exp")
666
+
667
+ lengthID := state.PushToVar(luau.NewUnary(luau.UnaryLen, expression), "length")
668
+
669
+ valueIsUsed := !isUsedAsStatement(node)
670
+ valueID := state.PushToVar(
671
+ luau.Create(&luau.ComputedIndexExpression{
672
+ Expression: convertToIndexableExpression(expression),
673
+ Index: indexExp,
674
+ }),
675
+ "value",
676
+ )
677
+
678
+ state.Prereq(luau.Create(&luau.IfStatement{
679
+ Condition: luau.NewBinary(valueID, luau.BinaryNotEqual, luau.NewNil()),
680
+ Statements: luau.MakeList[luau.Statement](
681
+ luau.Create(&luau.Assignment{
682
+ Left: luau.Create(&luau.ComputedIndexExpression{
683
+ Expression: convertToIndexableExpression(expression),
684
+ Index: indexExp,
685
+ }),
686
+ Operator: luau.AssignEqual,
687
+ Right: luau.Create(&luau.ComputedIndexExpression{
688
+ Expression: convertToIndexableExpression(expression),
689
+ Index: lengthID,
690
+ }),
691
+ }),
692
+ luau.Create(&luau.Assignment{
693
+ Left: luau.Create(&luau.ComputedIndexExpression{
694
+ Expression: convertToIndexableExpression(expression),
695
+ Index: lengthID,
696
+ }),
697
+ Operator: luau.AssignEqual,
698
+ Right: luau.NewNil(),
699
+ }),
700
+ ),
701
+ ElseBody: luau.NewList(),
702
+ }))
703
+
704
+ if valueIsUsed {
705
+ return valueID
706
+ }
707
+ return luau.NewNone()
708
+ },
709
+
710
+ "sort": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
711
+ valueIsUsed := !isUsedAsStatement(node)
712
+ if valueIsUsed {
713
+ expression = state.PushToVarIfComplex(expression, "exp")
714
+ }
715
+
716
+ args = slices.Insert(args, 0, expression)
717
+
718
+ state.Prereq(luau.Create(&luau.CallStatement{
719
+ Expression: luau.NewCall(luau.Globals.Table.Sort, args...),
720
+ }))
721
+
722
+ if valueIsUsed {
723
+ return expression
724
+ }
725
+ return luau.NewNone()
726
+ },
727
+
728
+ "clear": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
729
+ state.Prereq(luau.Create(&luau.CallStatement{
730
+ Expression: luau.NewCall(luau.Globals.Table.Clear, expression),
731
+ }))
732
+ if !isUsedAsStatement(node) {
733
+ return luau.NewNil()
734
+ }
735
+ return luau.NewNone()
736
+ },
737
+ }
738
+ }
739
+
740
+ func readonlySetMapSharedMethods() map[string]propertyCallMacro {
741
+ return map[string]propertyCallMacro{
742
+ "isEmpty": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
743
+ return luau.NewBinary(luau.NewCall(luau.Globals.Next, expression), luau.BinaryEqual, luau.NewNil())
744
+ },
745
+
746
+ "size": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
747
+ sizeID := state.PushToVar(luau.NewNumber(0), "size")
748
+ state.Prereq(luau.Create(&luau.ForStatement{
749
+ IDs: luau.MakeList(luau.NewTempID("")),
750
+ Expression: expression,
751
+ Statements: luau.MakeList[luau.Statement](
752
+ luau.Create(&luau.Assignment{
753
+ Left: sizeID,
754
+ Operator: luau.AssignAdd,
755
+ Right: luau.NewNumber(1),
756
+ }),
757
+ ),
758
+ }))
759
+ return sizeID
760
+ },
761
+
762
+ "has": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
763
+ left := luau.Create(&luau.ComputedIndexExpression{
764
+ Expression: convertToIndexableExpression(expression),
765
+ Index: args[0],
766
+ })
767
+ return luau.NewBinary(left, luau.BinaryNotEqual, luau.NewNil())
768
+ },
769
+ }
770
+ }
771
+
772
+ func setMapSharedMethods() map[string]propertyCallMacro {
773
+ return map[string]propertyCallMacro{
774
+ "delete": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
775
+ arg := state.PushToVarIfComplex(args[0], "value")
776
+ valueIsUsed := !isUsedAsStatement(node)
777
+ var valueExistedID *luau.TemporaryIdentifier
778
+ if valueIsUsed {
779
+ expressionID := state.PushToVarIfNonID(expression, "exp")
780
+ expression = expressionID
781
+ valueExistedID = state.PushToVar(
782
+ luau.Create(&luau.BinaryExpression{
783
+ Left: luau.Create(&luau.ComputedIndexExpression{
784
+ Expression: expressionID,
785
+ Index: arg,
786
+ }),
787
+ Operator: luau.BinaryNotEqual,
788
+ Right: luau.NewNil(),
789
+ }),
790
+ "valueExisted",
791
+ )
792
+ }
793
+
794
+ state.Prereq(luau.Create(&luau.Assignment{
795
+ Left: luau.Create(&luau.ComputedIndexExpression{
796
+ Expression: convertToIndexableExpression(expression),
797
+ Index: arg,
798
+ }),
799
+ Operator: luau.AssignEqual,
800
+ Right: luau.NewNil(),
801
+ }))
802
+
803
+ if valueIsUsed {
804
+ return valueExistedID
805
+ }
806
+ return luau.NewNone()
807
+ },
808
+
809
+ "clear": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
810
+ state.Prereq(luau.Create(&luau.CallStatement{
811
+ Expression: luau.NewCall(luau.Globals.Table.Clear, expression),
812
+ }))
813
+ if !isUsedAsStatement(node) {
814
+ return luau.NewNil()
815
+ }
816
+ return luau.NewNone()
817
+ },
818
+ }
819
+ }
820
+
821
+ func readonlySetMethods() map[string]propertyCallMacro {
822
+ methods := readonlySetMapSharedMethods()
823
+
824
+ methods["forEach"] = func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
825
+ expression = state.PushToVarIfComplex(expression, "exp")
826
+
827
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
828
+ valueID := luau.NewTempID("v")
829
+ state.Prereq(luau.Create(&luau.ForStatement{
830
+ IDs: luau.MakeList(valueID),
831
+ Expression: expression,
832
+ Statements: luau.MakeList[luau.Statement](
833
+ luau.Create(&luau.CallStatement{
834
+ Expression: luau.NewCall(callbackID, valueID, valueID, expression),
835
+ }),
836
+ ),
837
+ }))
838
+
839
+ if !isUsedAsStatement(node) {
840
+ return luau.NewNil()
841
+ }
842
+ return luau.NewNone()
843
+ }
844
+
845
+ return methods
846
+ }
847
+
848
+ func setMethods() map[string]propertyCallMacro {
849
+ methods := setMapSharedMethods()
850
+
851
+ methods["add"] = func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
852
+ valueIsUsed := !isUsedAsStatement(node)
853
+ if valueIsUsed {
854
+ expression = state.PushToVarIfComplex(expression, "exp")
855
+ }
856
+ state.Prereq(luau.Create(&luau.Assignment{
857
+ Left: luau.Create(&luau.ComputedIndexExpression{
858
+ Expression: convertToIndexableExpression(expression),
859
+ Index: args[0],
860
+ }),
861
+ Operator: luau.AssignEqual,
862
+ Right: luau.NewBool(true),
863
+ }))
864
+ if valueIsUsed {
865
+ return expression
866
+ }
867
+ return luau.NewNone()
868
+ }
869
+
870
+ return methods
871
+ }
872
+
873
+ func readonlyMapMethods() map[string]propertyCallMacro {
874
+ methods := readonlySetMapSharedMethods()
875
+
876
+ methods["forEach"] = func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
877
+ expression = state.PushToVarIfComplex(expression, "exp")
878
+
879
+ callbackID := state.PushToVarIfNonID(args[0], "callback")
880
+ keyID := luau.NewTempID("k")
881
+ valueID := luau.NewTempID("v")
882
+ state.Prereq(luau.Create(&luau.ForStatement{
883
+ IDs: luau.MakeList(keyID, valueID),
884
+ Expression: expression,
885
+ Statements: luau.MakeList[luau.Statement](
886
+ luau.Create(&luau.CallStatement{
887
+ Expression: luau.NewCall(callbackID, valueID, keyID, expression),
888
+ }),
889
+ ),
890
+ }))
891
+
892
+ if !isUsedAsStatement(node) {
893
+ return luau.NewNil()
894
+ }
895
+ return luau.NewNone()
896
+ }
897
+
898
+ methods["get"] = func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
899
+ return luau.Create(&luau.ComputedIndexExpression{
900
+ Expression: convertToIndexableExpression(expression),
901
+ Index: args[0],
902
+ })
903
+ }
904
+
905
+ return methods
906
+ }
907
+
908
+ func mapMethods() map[string]propertyCallMacro {
909
+ methods := setMapSharedMethods()
910
+
911
+ methods["set"] = func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
912
+ keyExp, valueExp := args[0], args[1]
913
+ valueIsUsed := !isUsedAsStatement(node)
914
+ if valueIsUsed {
915
+ expression = state.PushToVarIfComplex(expression, "exp")
916
+ }
917
+ state.Prereq(luau.Create(&luau.Assignment{
918
+ Left: luau.Create(&luau.ComputedIndexExpression{
919
+ Expression: convertToIndexableExpression(expression),
920
+ Index: keyExp,
921
+ }),
922
+ Operator: luau.AssignEqual,
923
+ Right: valueExp,
924
+ }))
925
+ if valueIsUsed {
926
+ return expression
927
+ }
928
+ return luau.NewNone()
929
+ }
930
+
931
+ return methods
932
+ }
933
+
934
+ func promiseMethods() map[string]propertyCallMacro {
935
+ return map[string]propertyCallMacro{
936
+ "then": func(state *TransformState, node *ast.Node, expression luau.Expression, args []luau.Expression) luau.Expression {
937
+ return luau.Create(&luau.MethodCallExpression{
938
+ Expression: convertToIndexableExpression(expression),
939
+ Name: "andThen",
940
+ Args: luau.MakeList(args...),
941
+ })
942
+ },
943
+ }
944
+ }
945
+
946
+ // propertyCallMacros is PROPERTY_CALL_MACROS with the comment wrapping applied, flattened to one table.
947
+ func propertyCallMacros() map[string]propertyCallMacro {
948
+ classes := map[string]map[string]propertyCallMacro{
949
+ // math classes
950
+ "CFrame": makeMathSet(luau.BinaryAdd, luau.BinarySub, luau.BinaryMul),
951
+ "UDim": makeMathSet(luau.BinaryAdd, luau.BinarySub),
952
+ "UDim2": makeMathSet(luau.BinaryAdd, luau.BinarySub),
953
+ "Vector2": makeMathSet(luau.BinaryAdd, luau.BinarySub, luau.BinaryMul, luau.BinaryDiv, luau.BinaryFloorDiv),
954
+ "Vector2int16": makeMathSet(luau.BinaryAdd, luau.BinarySub, luau.BinaryMul, luau.BinaryDiv),
955
+ "Vector3": makeMathSet(luau.BinaryAdd, luau.BinarySub, luau.BinaryMul, luau.BinaryDiv, luau.BinaryFloorDiv),
956
+ "Vector3int16": makeMathSet(luau.BinaryAdd, luau.BinarySub, luau.BinaryMul, luau.BinaryDiv),
957
+ "Number": makeMathSet(luau.BinaryFloorDiv),
958
+
959
+ "String": stringCallbacks(),
960
+ "ArrayLike": arrayLikeMethods(),
961
+ "ReadonlyArray": readonlyArrayMethods(),
962
+ "Array": arrayMethods(),
963
+ "ReadonlySet": readonlySetMethods(),
964
+ "Set": setMethods(),
965
+ "ReadonlyMap": readonlyMapMethods(),
966
+ "Map": mapMethods(),
967
+ "Promise": promiseMethods(),
968
+ }
969
+
970
+ // apply comment wrapping
971
+ macros := map[string]propertyCallMacro{}
972
+ for className, macroList := range classes {
973
+ for methodName, macro := range macroList {
974
+ name := className + "." + methodName
975
+ macros[name] = wrapComments(name, macro)
976
+ }
977
+ }
978
+ return macros
979
+ }
980
+
981
+ // comment logic
982
+
983
+ func header(text string) *luau.Comment {
984
+ return luau.NewComment(" ▼ " + text + " ▼")
985
+ }
986
+
987
+ func footer(text string) *luau.Comment {
988
+ return luau.NewComment(" ▲ " + text + " ▲")
989
+ }
990
+
991
+ func wasExpressionPushed(statements *luau.List, expression luau.Expression) bool {
992
+ if statements.IsNonEmpty() {
993
+ firstStatement := statements.Head.Value
994
+ if luau.IsVariableDeclaration(firstStatement) {
995
+ declaration := firstStatement.(*luau.VariableDeclaration)
996
+ if !luau.IsList(declaration.Left) && luau.IsTemporaryIdentifier(declaration.Left.(luau.Node)) {
997
+ if declaration.Right == luau.NodeOrList(expression) {
998
+ return true
999
+ }
1000
+ }
1001
+ }
1002
+ }
1003
+ return false
1004
+ }
1005
+
1006
+ func wrapComments(methodName string, callback propertyCallMacro) propertyCallMacro {
1007
+ return func(state *TransformState, callNode *ast.Node, callExp luau.Expression, args []luau.Expression) luau.Expression {
1008
+ expression, prereqs := Capture(state, func() luau.Expression { return callback(state, callNode, callExp, args) })
1009
+
1010
+ size := prereqs.Size()
1011
+ if size > 0 {
1012
+ // detect the case of `expression = state.pushToVarIfComplex(expression, "exp");` and put header after
1013
+ wasPushed := wasExpressionPushed(prereqs, callExp)
1014
+ var pushStatement luau.Node
1015
+ if wasPushed {
1016
+ pushStatement = prereqs.Shift()
1017
+ size--
1018
+ }
1019
+ if size > 1 {
1020
+ prereqs.Unshift(header(methodName))
1021
+ if wasPushed && pushStatement != nil {
1022
+ prereqs.Unshift(pushStatement)
1023
+ }
1024
+ prereqs.Push(footer(methodName))
1025
+ } else {
1026
+ if wasPushed && pushStatement != nil {
1027
+ prereqs.Unshift(pushStatement)
1028
+ }
1029
+ }
1030
+ }
1031
+
1032
+ state.PrereqList(prereqs)
1033
+ return expression
1034
+ }
1035
+ }