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

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 +243 -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 +271 -0
  49. package/plugins/session.go +236 -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 +120 -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,71 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/statements/transformExpressionStatement.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ )
9
+
10
+ // unaryExpressionParts returns the operand and operator of a ts.PrefixUnaryExpression or ts.PostfixUnaryExpression.
11
+ func unaryExpressionParts(node *ast.Node) (*ast.Node, ast.Kind) {
12
+ if ast.IsPrefixUnaryExpression(node) {
13
+ prefix := node.AsPrefixUnaryExpression()
14
+ return prefix.Operand, prefix.Operator
15
+ }
16
+ postfix := node.AsPostfixUnaryExpression()
17
+ return postfix.Operand, postfix.Operator
18
+ }
19
+
20
+ func transformUnaryExpressionStatement(state *TransformState, node *ast.Node) *luau.Assignment {
21
+ operand, nodeOperator := unaryExpressionParts(node)
22
+ writable := transformWritableExpression(state, operand, false)
23
+ operator := luau.AssignSub
24
+ if nodeOperator == ast.KindPlusPlusToken {
25
+ operator = luau.AssignAdd
26
+ }
27
+ return luau.Create(&luau.Assignment{
28
+ Left: writable,
29
+ Operator: operator,
30
+ Right: luau.NewNumber(1),
31
+ })
32
+ }
33
+
34
+ func transformExpressionStatementInner(state *TransformState, expression *ast.Node) *luau.List {
35
+ if ast.IsBinaryExpression(expression) {
36
+ binary := expression.AsBinaryExpression()
37
+ operatorKind := binary.OperatorToken.Kind
38
+ if ast.IsLogicalOrCoalescingAssignmentExpression(expression) {
39
+ return transformLogicalOrCoalescingAssignmentExpressionStatement(state, expression)
40
+ } else if ast.IsAssignmentOperator(operatorKind) &&
41
+ !ast.IsArrayLiteralExpression(binary.Left) &&
42
+ !ast.IsObjectLiteralExpression(binary.Left) {
43
+ writableType := state.GetType(binary.Left)
44
+ valueType := state.GetType(binary.Right)
45
+ // "" is undefined
46
+ operator := getSimpleAssignmentOperator(writableType, operatorKind, valueType)
47
+ assignment := transformWritableAssignment(state, binary.Left, binary.Right, operator == "", operator == "")
48
+ writable, readable, value := assignment.writable, assignment.readable, assignment.value
49
+ if operator != "" {
50
+ return luau.MakeList(luau.Create(&luau.Assignment{
51
+ Left: writable,
52
+ Operator: operator,
53
+ Right: getAssignableValue(operator, value, valueType),
54
+ }))
55
+ } else {
56
+ return luau.MakeList[luau.Node](createCompoundAssignmentStatement(state, expression, writable, writableType, readable, operatorKind, value, valueType))
57
+ }
58
+ }
59
+ } else if ast.IsPrefixUnaryExpression(expression) || ast.IsPostfixUnaryExpression(expression) {
60
+ if _, operator := unaryExpressionParts(expression); isUnaryAssignmentOperator(operator) {
61
+ return luau.MakeList(transformUnaryExpressionStatement(state, expression))
62
+ }
63
+ }
64
+
65
+ return wrapExpressionStatement(transformExpression(state, expression))
66
+ }
67
+
68
+ func transformExpressionStatement(state *TransformState, node *ast.Node) *luau.List {
69
+ expression := SkipDownwards(node.AsExpressionStatement().Expression)
70
+ return transformExpressionStatementInner(state, expression)
71
+ }
@@ -0,0 +1,461 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/statements/transformForOfStatement.ts.
4
+ //
5
+ // The builders are functions and not package-level variables as upstream, because they'd be an initialization cycle.
6
+ //
7
+ // TS 7 parses an omitted element of an array binding pattern as a BindingElement with no name, where TS 5.5.3 has an
8
+ // OmittedExpression, so an omitted element is also Name() == nil in transformInLineArrayBindingPattern.
9
+
10
+ import (
11
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
12
+ "github.com/microsoft/TypeScript/tsc/internal/checker"
13
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
14
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
15
+ )
16
+
17
+ type loopBuilder func(state *TransformState, statements *luau.List, initializer *ast.Node, exp luau.Expression) *luau.List
18
+
19
+ func makeForLoopBuilder(callback func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression) loopBuilder {
20
+ return func(state *TransformState, statements *luau.List, name *ast.Node, exp luau.Expression) *luau.List {
21
+ ids := luau.NewList()
22
+ initializers := luau.NewList()
23
+ expression := callback(state, name, exp, ids, initializers)
24
+ statements.UnshiftList(initializers)
25
+ return luau.MakeList(luau.Create(&luau.ForStatement{IDs: ids, Expression: expression, Statements: statements}))
26
+ }
27
+ }
28
+
29
+ func transformForInitializerExpressionDirect(state *TransformState, initializer *ast.Node, initializers *luau.List, value luau.Expression) luau.AnyIdentifier {
30
+ if ast.IsArrayLiteralExpression(initializer) {
31
+ parentID, prereqs := Capture(state, func() *luau.TemporaryIdentifier {
32
+ parentID := state.PushToVar(value, "binding")
33
+ transformArrayAssignmentPattern(state, initializer, parentID)
34
+ return parentID
35
+ })
36
+ initializers.PushList(prereqs)
37
+ return parentID
38
+ } else if ast.IsObjectLiteralExpression(initializer) {
39
+ parentID, prereqs := Capture(state, func() *luau.TemporaryIdentifier {
40
+ parentID := state.PushToVar(value, "binding")
41
+ transformObjectAssignmentPattern(state, initializer, parentID)
42
+ return parentID
43
+ })
44
+ initializers.PushList(prereqs)
45
+ return parentID
46
+ } else {
47
+ expression := transformWritableExpression(state, initializer, false)
48
+ initializers.Push(luau.Create(&luau.Assignment{
49
+ Left: expression,
50
+ Operator: luau.AssignEqual,
51
+ Right: value,
52
+ }))
53
+ }
54
+ return nil
55
+ }
56
+
57
+ func transformForInitializer(state *TransformState, initializer *ast.Node, initializers *luau.List) luau.AnyIdentifier {
58
+ if ast.IsVariableDeclarationList(initializer) {
59
+ return transformBindingName(state, initializer.AsVariableDeclarationList().Declarations.Nodes[0].Name(), initializers)
60
+ } else if ast.IsArrayLiteralExpression(initializer) {
61
+ parentID := luau.NewTempID("binding")
62
+ initializers.PushList(
63
+ state.CapturePrereqs(func() { transformArrayAssignmentPattern(state, initializer, parentID) }),
64
+ )
65
+ return parentID
66
+ } else if ast.IsObjectLiteralExpression(initializer) {
67
+ parentID := luau.NewTempID("binding")
68
+ initializers.PushList(
69
+ state.CapturePrereqs(func() { transformObjectAssignmentPattern(state, initializer, parentID) }),
70
+ )
71
+ return parentID
72
+ } else {
73
+ valueID := luau.NewTempID("v")
74
+ expression := transformWritableExpression(state, initializer, false)
75
+ initializers.Push(luau.Create(&luau.Assignment{
76
+ Left: expression,
77
+ Operator: luau.AssignEqual,
78
+ Right: valueID,
79
+ }))
80
+ return valueID
81
+ }
82
+ }
83
+
84
+ func buildArrayLoop(state *TransformState, statements *luau.List, name *ast.Node, exp luau.Expression) *luau.List {
85
+ return makeForLoopBuilder(func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression {
86
+ ids.Push(luau.NewTempID(""))
87
+ ids.Push(transformForInitializer(state, initializer, initializers))
88
+ return exp
89
+ })(state, statements, name, exp)
90
+ }
91
+
92
+ func buildSetLoop(state *TransformState, statements *luau.List, name *ast.Node, exp luau.Expression) *luau.List {
93
+ return makeForLoopBuilder(func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression {
94
+ ids.Push(transformForInitializer(state, initializer, initializers))
95
+ return exp
96
+ })(state, statements, name, exp)
97
+ }
98
+
99
+ func transformInLineArrayBindingPattern(state *TransformState, pattern *ast.Node, ids *luau.List, initializers *luau.List) {
100
+ for _, element := range pattern.AsBindingPattern().Elements.Nodes {
101
+ if ast.IsOmittedExpression(element) || element.Name() == nil {
102
+ ids.Push(luau.NewTempID(""))
103
+ } else if ast.IsSpreadElement(element) {
104
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoSpreadDestructuring.At(shared.AtNode(element)))
105
+ } else {
106
+ id := transformBindingName(state, element.Name(), initializers)
107
+ if elementInitializer := element.AsBindingElement().Initializer; elementInitializer != nil {
108
+ initializers.Push(transformInitializer(state, id.(luau.WritableExpression), elementInitializer))
109
+ }
110
+ ids.Push(id)
111
+ }
112
+ }
113
+ }
114
+
115
+ func transformInLineArrayAssignmentPattern(state *TransformState, assignmentPattern *ast.Node, ids *luau.List, initializers *luau.List) {
116
+ initializers.PushList(
117
+ state.CapturePrereqs(func() {
118
+ for _, element := range assignmentPattern.AsArrayLiteralExpression().Elements.Nodes {
119
+ if ast.IsOmittedExpression(element) {
120
+ ids.Push(luau.NewTempID(""))
121
+ } else if ast.IsSpreadElement(element) {
122
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoSpreadDestructuring.At(shared.AtNode(element)))
123
+ } else {
124
+ var initializer *ast.Node
125
+ // JS 3.0.0 crashes on [(a)] of b. From upstream's master, in transformAssignmentPatternElement.
126
+ element = SkipDownwards(element)
127
+ if ast.IsBinaryExpression(element) {
128
+ binary := element.AsBinaryExpression()
129
+ initializer = SkipDownwards(binary.Right)
130
+ element = SkipDownwards(binary.Left)
131
+ }
132
+
133
+ valueID := luau.NewTempID("binding")
134
+ if ast.IsIdentifier(element) ||
135
+ ast.IsElementAccessExpression(element) ||
136
+ ast.IsPropertyAccessExpression(element) {
137
+ id := transformWritableExpression(state, element, initializer != nil)
138
+ state.Prereq(luau.Create(&luau.Assignment{
139
+ Left: id,
140
+ Operator: luau.AssignEqual,
141
+ Right: valueID,
142
+ }))
143
+ if initializer != nil {
144
+ state.Prereq(transformInitializer(state, id, initializer))
145
+ }
146
+ } else if ast.IsArrayLiteralExpression(element) {
147
+ if initializer != nil {
148
+ state.Prereq(transformInitializer(state, valueID, initializer))
149
+ }
150
+ transformArrayAssignmentPattern(state, element, valueID)
151
+ } else if ast.IsObjectLiteralExpression(element) {
152
+ if initializer != nil {
153
+ state.Prereq(transformInitializer(state, valueID, initializer))
154
+ }
155
+ transformObjectAssignmentPattern(state, element, valueID)
156
+ } else {
157
+ panic(shared.AssertionMessage("transformInLineArrayAssignmentPattern invalid element: " + getKindName(element.Kind)))
158
+ }
159
+
160
+ ids.Push(valueID)
161
+ }
162
+ }
163
+ }),
164
+ )
165
+ }
166
+
167
+ func buildMapLoop(state *TransformState, statements *luau.List, name *ast.Node, exp luau.Expression) *luau.List {
168
+ return makeForLoopBuilder(func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression {
169
+ // TEST
170
+ if ast.IsVariableDeclarationList(initializer) {
171
+ name := initializer.AsVariableDeclarationList().Declarations.Nodes[0].Name()
172
+ if ast.IsArrayBindingPattern(name) {
173
+ transformInLineArrayBindingPattern(state, name, ids, initializers)
174
+ return exp
175
+ }
176
+ } else if ast.IsArrayLiteralExpression(initializer) {
177
+ transformInLineArrayAssignmentPattern(state, initializer, ids, initializers)
178
+ return exp
179
+ }
180
+
181
+ keyID := luau.NewTempID("k")
182
+ valueID := luau.NewTempID("v")
183
+ ids.Push(keyID)
184
+ ids.Push(valueID)
185
+
186
+ if ast.IsVariableDeclarationList(initializer) {
187
+ bindingList := luau.NewList()
188
+ initializers.Push(luau.Create(&luau.VariableDeclaration{
189
+ Left: transformForInitializer(state, initializer, bindingList),
190
+ Right: luau.NewArray(keyID, valueID),
191
+ }))
192
+ initializers.PushList(bindingList)
193
+ } else {
194
+ transformForInitializerExpressionDirect(state, initializer, initializers, luau.NewArray(keyID, valueID))
195
+ }
196
+
197
+ return exp
198
+ })(state, statements, name, exp)
199
+ }
200
+
201
+ func buildStringLoop(state *TransformState, statements *luau.List, name *ast.Node, exp luau.Expression) *luau.List {
202
+ return makeForLoopBuilder(func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression {
203
+ ids.Push(transformForInitializer(state, initializer, initializers))
204
+ return luau.NewCall(luau.Globals.String.Gmatch, exp, luau.Globals.Utf8.Charpattern)
205
+ })(state, statements, name, exp)
206
+ }
207
+
208
+ func buildIterableFunctionLoop(state *TransformState, statements *luau.List, name *ast.Node, exp luau.Expression) *luau.List {
209
+ return makeForLoopBuilder(func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression {
210
+ ids.Push(transformForInitializer(state, initializer, initializers))
211
+ return exp
212
+ })(state, statements, name, exp)
213
+ }
214
+
215
+ func makeIterableFunctionLuaTupleShorthand(state *TransformState, array *ast.Node, statements *luau.List, expression luau.Expression) *luau.List {
216
+ ids := luau.NewList()
217
+ initializers := luau.NewList()
218
+ if ast.IsArrayBindingPattern(array) {
219
+ transformInLineArrayBindingPattern(state, array, ids, initializers)
220
+ } else {
221
+ transformInLineArrayAssignmentPattern(state, array, ids, initializers)
222
+ }
223
+ statements.UnshiftList(initializers)
224
+ return luau.MakeList(luau.Create(&luau.ForStatement{IDs: ids, Expression: expression, Statements: statements}))
225
+ }
226
+
227
+ func buildIterableFunctionLuaTupleLoop(t *checker.Type) loopBuilder {
228
+ return func(state *TransformState, statements *luau.List, initializer *ast.Node, exp luau.Expression) *luau.List {
229
+ if ast.IsVariableDeclarationList(initializer) {
230
+ // for (const [a, b] of iter())
231
+ name := initializer.AsVariableDeclarationList().Declarations.Nodes[0].Name()
232
+ if ast.IsArrayBindingPattern(name) {
233
+ return makeIterableFunctionLuaTupleShorthand(state, name, statements, exp)
234
+ }
235
+ } else if ast.IsArrayLiteralExpression(initializer) {
236
+ // for ([a, b] of iter())
237
+ return makeIterableFunctionLuaTupleShorthand(state, initializer, statements, exp)
238
+ }
239
+
240
+ var iteratorReturnIDs []luau.Expression
241
+
242
+ // get call signature of IterableFunction<T> which is `(): T`
243
+ // and get return type of call signature which is `T`
244
+ luaTupleType := state.Checker.GetReturnTypeOfSignature(state.Checker.GetCallSignatures(t)[0])
245
+ if !(luaTupleType != nil && luaTupleType.Alias() != nil && len(luaTupleType.Alias().TypeArguments()) == 1) {
246
+ panic(shared.AssertionMessage("Incorrect LuaTuple<T> type arguments"))
247
+ }
248
+ tupleArgType := luaTupleType.Alias().TypeArguments()[0]
249
+ // if initializer is a variable declaration `for (const a of iter())`
250
+ // and LuaTuple has defined element amount, and no rest elements
251
+ // then use lua for-in loop, specifying all elements and putting them in table
252
+ if ast.IsVariableDeclarationList(initializer) &&
253
+ checker.IsTupleType(tupleArgType) &&
254
+ !tupleHasRestElement(tupleArgType) {
255
+ tupleType := tupleArgType.TargetTupleType()
256
+ elementInfos := tupleType.ElementInfos()
257
+ for i := range elementInfos {
258
+ name := "element"
259
+ label := elementInfos[i].LabeledDeclaration()
260
+ if label != nil && ast.IsIdentifier(label.Name()) && luau.IsValidIdentifier(label.Name().Text()) {
261
+ name = label.Name().Text()
262
+ }
263
+ iteratorReturnIDs = append(iteratorReturnIDs, luau.NewTempID(name))
264
+ }
265
+ } else {
266
+ iterFuncName := valueToIDStr(exp)
267
+ if iterFuncName == "" {
268
+ iterFuncName = "iterFunc"
269
+ }
270
+ iterFuncID := state.PushToVar(exp, iterFuncName)
271
+ loopStatements := luau.NewList()
272
+
273
+ initializerStatements := luau.NewList()
274
+ valueID := transformForInitializer(state, initializer, initializerStatements)
275
+
276
+ loopStatements.Push(luau.Create(&luau.VariableDeclaration{
277
+ Left: valueID,
278
+ Right: luau.NewArray(luau.NewCall(iterFuncID)),
279
+ }))
280
+
281
+ loopStatements.Push(luau.Create(&luau.IfStatement{
282
+ Condition: luau.NewBinary(luau.NewUnary(luau.UnaryLen, valueID), luau.BinaryEqual, luau.NewNumber(0)),
283
+ Statements: luau.MakeList(luau.Create(&luau.BreakStatement{})),
284
+ ElseBody: luau.NewList(),
285
+ }))
286
+
287
+ loopStatements.PushList(initializerStatements)
288
+
289
+ loopStatements.PushList(statements)
290
+
291
+ return luau.MakeList(luau.Create(&luau.WhileStatement{
292
+ Condition: luau.NewBool(true),
293
+ Statements: loopStatements,
294
+ }))
295
+ }
296
+
297
+ tupleID := transformForInitializer(state, initializer, statements)
298
+
299
+ builder := makeForLoopBuilder(func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression {
300
+ for _, id := range iteratorReturnIDs {
301
+ ids.Push(id)
302
+ }
303
+
304
+ initializers.Push(luau.Create(&luau.VariableDeclaration{
305
+ Left: tupleID,
306
+ Right: luau.NewArray(iteratorReturnIDs...),
307
+ }))
308
+ return exp
309
+ })
310
+
311
+ return builder(state, statements, initializer, exp)
312
+ }
313
+ }
314
+
315
+ // tupleHasRestElement is `target.combinedFlags & ts.ElementFlags.Rest`. combinedFlags isn't exported, and it's the OR
316
+ // of the element flags.
317
+ func tupleHasRestElement(tupleType *checker.Type) bool {
318
+ var combinedFlags checker.ElementFlags
319
+ for _, flags := range tupleType.TargetTupleType().ElementFlags() {
320
+ combinedFlags |= flags
321
+ }
322
+ return combinedFlags&checker.ElementFlagsRest != 0
323
+ }
324
+
325
+ func buildGeneratorLoop(state *TransformState, statements *luau.List, name *ast.Node, exp luau.Expression) *luau.List {
326
+ return makeForLoopBuilder(func(state *TransformState, initializer *ast.Node, exp luau.Expression, ids *luau.List, initializers *luau.List) luau.Expression {
327
+ loopID := luau.NewTempID("result")
328
+ ids.Push(loopID)
329
+
330
+ initializers.Push(luau.Create(&luau.IfStatement{
331
+ Condition: luau.NewProperty(loopID, "done"),
332
+ Statements: luau.MakeList(luau.Create(&luau.BreakStatement{})),
333
+ ElseBody: luau.NewList(),
334
+ }))
335
+
336
+ if ast.IsVariableDeclarationList(initializer) {
337
+ bindingList := luau.NewList()
338
+ initializers.Push(luau.Create(&luau.VariableDeclaration{
339
+ Left: transformForInitializer(state, initializer, bindingList),
340
+ Right: luau.NewProperty(loopID, "value"),
341
+ }))
342
+ initializers.PushList(bindingList)
343
+ } else {
344
+ transformForInitializerExpressionDirect(state, initializer, initializers, luau.NewProperty(loopID, "value"))
345
+ }
346
+
347
+ return luau.NewProperty(convertToIndexableExpression(exp), "next")
348
+ })(state, statements, name, exp)
349
+ }
350
+
351
+ func emptyLoopBuilder(*TransformState, *luau.List, *ast.Node, luau.Expression) *luau.List {
352
+ return luau.NewList()
353
+ }
354
+
355
+ func getLoopBuilder(state *TransformState, node *ast.Node, t *checker.Type) loopBuilder {
356
+ if isDefinitelyType(t, isArrayType(state)) {
357
+ return buildArrayLoop
358
+ } else if isDefinitelyType(t, isSetType(state)) {
359
+ return buildSetLoop
360
+ } else if isDefinitelyType(t, isMapType(state)) {
361
+ return buildMapLoop
362
+ } else if isDefinitelyType(t, isStringType) {
363
+ return buildStringLoop
364
+ } else if isDefinitelyType(t, isIterableFunctionLuaTupleType(state)) {
365
+ return buildIterableFunctionLuaTupleLoop(t)
366
+ } else if isDefinitelyType(t, isIterableFunctionType(state)) {
367
+ return buildIterableFunctionLoop
368
+ } else if isDefinitelyType(t, isGeneratorType(state)) {
369
+ return buildGeneratorLoop
370
+ } else if isDefinitelyType(t, isIterableType(state)) {
371
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoIterableIteration.At(shared.AtNode(node)))
372
+ return emptyLoopBuilder
373
+ } else if t.IsUnion() {
374
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoMacroUnion.At(shared.AtNode(node)))
375
+ return emptyLoopBuilder
376
+ } else {
377
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoUnsupportedIteration.At(shared.AtNode(node)))
378
+ return emptyLoopBuilder
379
+ }
380
+ }
381
+
382
+ func findRangeMacro(state *TransformState, node *ast.Node) *ast.Node {
383
+ expression := SkipDownwards(node.AsForInOrOfStatement().Expression)
384
+ if ast.IsCallExpression(expression) {
385
+ symbol := getFirstDefinedSymbol(state, state.GetType(expression.Expression()))
386
+ if symbol != nil && symbol == getSymbolOrThrow(state, "$range") {
387
+ return expression
388
+ }
389
+ }
390
+ return nil
391
+ }
392
+
393
+ func transformForOfRangeMacro(state *TransformState, node *ast.Node, macroCall *ast.Node) *luau.List {
394
+ forOf := node.AsForInOrOfStatement()
395
+ result := luau.NewList()
396
+
397
+ statements := luau.NewList()
398
+ id := transformForInitializer(state, forOf.Initializer, statements)
399
+
400
+ args, prereqs := Capture(state, func() []luau.Expression {
401
+ return ensureTransformOrder(state, macroCall.AsCallExpression().Arguments.Nodes, nil)
402
+ })
403
+ var start, end, step luau.Expression
404
+ if len(args) > 0 {
405
+ start = args[0]
406
+ }
407
+ if len(args) > 1 {
408
+ end = args[1]
409
+ }
410
+ if len(args) > 2 {
411
+ step = args[2]
412
+ }
413
+ result.PushList(prereqs)
414
+
415
+ statements.PushList(transformStatementList(state, forOf.Statement, getStatements(forOf.Statement), nil))
416
+
417
+ if !(step == nil || luau.IsNumberLiteral(step)) {
418
+ step = luau.NewBinary(step, luau.BinaryOr, luau.NewNumber(1))
419
+ }
420
+ result.Push(luau.Create(&luau.NumericForStatement{
421
+ ID: id,
422
+ Start: start,
423
+ End: end,
424
+ Step: step,
425
+ Statements: statements,
426
+ }))
427
+
428
+ return result
429
+ }
430
+
431
+ func transformForOfStatement(state *TransformState, node *ast.Node) *luau.List {
432
+ forOf := node.AsForInOrOfStatement()
433
+ if forOf.AwaitModifier != nil {
434
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoAwaitForOf.At(shared.AtNode(node)))
435
+ }
436
+
437
+ if ast.IsVariableDeclarationList(forOf.Initializer) {
438
+ name := forOf.Initializer.AsVariableDeclarationList().Declarations.Nodes[0].Name()
439
+ if ast.IsIdentifier(name) {
440
+ validateIdentifier(state, name)
441
+ }
442
+ }
443
+
444
+ rangeMacroCall := findRangeMacro(state, node)
445
+ if rangeMacroCall != nil {
446
+ return transformForOfRangeMacro(state, node, rangeMacroCall)
447
+ }
448
+
449
+ result := luau.NewList()
450
+
451
+ exp, expPrereqs := Capture(state, func() luau.Expression { return transformExpression(state, forOf.Expression) })
452
+ result.PushList(expPrereqs)
453
+
454
+ expType := state.GetType(forOf.Expression)
455
+ statements := transformStatementList(state, forOf.Statement, getStatements(forOf.Statement), nil)
456
+
457
+ builder := getLoopBuilder(state, forOf.Expression, expType)
458
+ result.PushList(builder(state, statements, forOf.Initializer, exp))
459
+
460
+ return result
461
+ }