@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,599 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/statements/transformForStatement.ts.
4
+
5
+ import (
6
+ "math"
7
+ "strings"
8
+ "unicode/utf8"
9
+
10
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
11
+ "github.com/microsoft/TypeScript/tsc/internal/astnav"
12
+ "github.com/microsoft/TypeScript/tsc/internal/checker"
13
+ "github.com/microsoft/TypeScript/tsc/internal/jsnum"
14
+ "github.com/microsoft/TypeScript/tsc/internal/scanner"
15
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
16
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
17
+ )
18
+
19
+ // forStatementPossibleReferencePositions is getPossibleSymbolReferencePositions in TS 5.5.3. The checker's copy can't
20
+ // be used: it only searches a whole file correctly, excludes a match at container.end, and reads the characters around
21
+ // a match as single bytes, so it drops a match that's next to non-ASCII whitespace.
22
+ func forStatementPossibleReferencePositions(sourceFile *ast.SourceFile, symbolName string, container *ast.Node) []int {
23
+ var positions []int
24
+ if symbolName == "" {
25
+ return positions
26
+ }
27
+ text := sourceFile.Text()
28
+ sourceLength := len(text)
29
+ symbolNameLength := len(symbolName)
30
+ position := forStatementIndexOf(text, symbolName, container.Pos())
31
+ for position >= 0 {
32
+ if position > container.End() {
33
+ break
34
+ }
35
+ endPosition := position + symbolNameLength
36
+ before, _ := utf8.DecodeLastRuneInString(text[:position])
37
+ after, _ := utf8.DecodeRuneInString(text[endPosition:])
38
+ if (position == 0 || !scanner.IsIdentifierPart(before)) && (endPosition == sourceLength || !scanner.IsIdentifierPart(after)) {
39
+ positions = append(positions, position)
40
+ }
41
+ position = forStatementIndexOf(text, symbolName, position+symbolNameLength+1)
42
+ }
43
+ return positions
44
+ }
45
+
46
+ func forStatementIndexOf(text string, search string, from int) int {
47
+ if from > len(text) {
48
+ return -1
49
+ }
50
+ index := strings.Index(text[from:], search)
51
+ if index < 0 {
52
+ return -1
53
+ }
54
+ return from + index
55
+ }
56
+
57
+ // forStatementLocalSymbolForExportSpecifier is getLocalSymbolForExportSpecifier in TS 5.5.3.
58
+ func forStatementLocalSymbolForExportSpecifier(c *checker.Checker, referenceLocation *ast.Node, referenceSymbol *ast.Symbol, exportSpecifier *ast.Node) *ast.Symbol {
59
+ specifier := exportSpecifier.AsExportSpecifier()
60
+ var isAlias bool
61
+ if specifier.PropertyName != nil {
62
+ isAlias = specifier.PropertyName == referenceLocation
63
+ } else {
64
+ isAlias = exportSpecifier.Parent.Parent.AsExportDeclaration().ModuleSpecifier == nil
65
+ }
66
+ if isAlias {
67
+ if symbol := c.GetExportSpecifierLocalTargetSymbol(exportSpecifier); symbol != nil {
68
+ return symbol
69
+ }
70
+ }
71
+ return referenceSymbol
72
+ }
73
+
74
+ // forStatementEachSymbolReferenceInFile is ts.FindAllReferences.Core.eachSymbolReferenceInFile in TS 5.5.3. It stops at
75
+ // the first true from cb. The checker's GetReferencesToSymbolInFile has no searchContainer and doesn't skip the
76
+ // definition, and upstream relies on both.
77
+ func forStatementEachSymbolReferenceInFile(state *TransformState, definition *ast.Node, sourceFile *ast.SourceFile, cb func(token *ast.Node) bool, searchContainer *ast.Node) bool {
78
+ c := state.Checker
79
+ var symbol *ast.Symbol
80
+ if ast.IsParameterPropertyDeclaration(definition.Parent, definition.Parent.Parent) {
81
+ symbol, _ = c.GetSymbolsOfParameterPropertyDeclaration(definition.Parent, definition.Text())
82
+ } else {
83
+ symbol = c.GetSymbolAtLocation(definition)
84
+ }
85
+ if symbol == nil {
86
+ return false
87
+ }
88
+ for _, position := range forStatementPossibleReferencePositions(sourceFile, symbol.Name(), searchContainer) {
89
+ token := astnav.GetTouchingPropertyName(sourceFile, position)
90
+ if token == sourceFile.AsNode() {
91
+ continue
92
+ }
93
+ if !ast.IsIdentifier(token) || token == definition || token.Text() != definition.Text() {
94
+ continue
95
+ }
96
+ referenceSymbol := c.GetSymbolAtLocation(token)
97
+ if referenceSymbol == symbol ||
98
+ (token.Parent.Kind == ast.KindShorthandPropertyAssignment && c.GetShorthandAssignmentValueSymbol(token.Parent) == symbol) ||
99
+ (ast.IsExportSpecifier(token.Parent) && forStatementLocalSymbolForExportSpecifier(c, token, referenceSymbol, token.Parent) == symbol) {
100
+ if cb(token) {
101
+ return true
102
+ }
103
+ }
104
+ }
105
+ return false
106
+ }
107
+
108
+ // forStatementNodeText is node.getText().
109
+ func forStatementNodeText(node *ast.Node) string {
110
+ return scanner.GetSourceTextOfNodeFromSourceFile(ast.GetSourceFileOfNode(node), node, false)
111
+ }
112
+
113
+ // forStatementNumberIsInteger is Number.isInteger.
114
+ func forStatementNumberIsInteger(value jsnum.Number) bool {
115
+ return !value.IsNaN() && !value.IsInf() && float64(value) == math.Trunc(float64(value))
116
+ }
117
+
118
+ // isUnaryExpressionWithWrite is ts.isUnaryExpressionWithWrite from TS 5.5.3.
119
+ func isUnaryExpressionWithWrite(expr *ast.Node) bool {
120
+ switch expr.Kind {
121
+ case ast.KindPostfixUnaryExpression:
122
+ return true
123
+ case ast.KindPrefixUnaryExpression:
124
+ operator := expr.AsPrefixUnaryExpression().Operator
125
+ return operator == ast.KindPlusPlusToken || operator == ast.KindMinusMinusToken
126
+ default:
127
+ return false
128
+ }
129
+ }
130
+
131
+ func addFinalizersToIfStatement(node *luau.IfStatement, finalizers *luau.List) {
132
+ if node.Statements.IsNonEmpty() {
133
+ addFinalizers(node.Statements, node.Statements.Head, finalizers)
134
+ }
135
+ if elseBody, isList := luau.AsList(node.ElseBody); isList {
136
+ if elseBody.IsNonEmpty() {
137
+ addFinalizers(elseBody, elseBody.Head, finalizers)
138
+ }
139
+ } else {
140
+ addFinalizersToIfStatement(node.ElseBody.(*luau.IfStatement), finalizers)
141
+ }
142
+ }
143
+
144
+ func addFinalizers(list *luau.List, node *luau.ListNode, finalizers *luau.List) {
145
+ if list.IsEmpty() {
146
+ panic(shared.AssertionMessage(""))
147
+ }
148
+
149
+ statement := node.Value
150
+ if luau.IsContinueStatement(statement) {
151
+ finalizersClone := finalizers.Clone()
152
+
153
+ // fix node parents
154
+ finalizersClone.ForEach(func(node luau.Node) { node.SetParent(statement.Parent()) })
155
+
156
+ if node.Prev != nil {
157
+ node.Prev.Next = finalizersClone.Head
158
+ } else if node == list.Head {
159
+ list.Head = finalizersClone.Head
160
+ }
161
+
162
+ node.Prev = finalizersClone.Tail
163
+
164
+ finalizersClone.Tail.Next = node
165
+ }
166
+
167
+ if luau.IsDoStatement(statement) {
168
+ doStatement := statement.(*luau.DoStatement)
169
+ if doStatement.Statements.IsNonEmpty() {
170
+ addFinalizers(doStatement.Statements, doStatement.Statements.Head, finalizers)
171
+ }
172
+ } else if luau.IsIfStatement(statement) {
173
+ addFinalizersToIfStatement(statement.(*luau.IfStatement), finalizers)
174
+ }
175
+
176
+ if node.Next != nil {
177
+ addFinalizers(list, node.Next, finalizers)
178
+ }
179
+ }
180
+
181
+ func canSkipClone(state *TransformState, initializer *ast.Node, id *ast.Node) bool {
182
+ // is symbol used in initializer (besides its definition)
183
+ return !forStatementEachSymbolReferenceInFile(state, id, ast.GetSourceFileOfNode(id), func(*ast.Node) bool { return true }, initializer)
184
+ }
185
+
186
+ func isIDWriteOrAsyncRead(state *TransformState, forStatement *ast.Node, id *ast.Node) bool {
187
+ incrementor := forStatement.AsForStatement().Incrementor
188
+ return forStatementEachSymbolReferenceInFile(
189
+ state,
190
+ id,
191
+ ast.GetSourceFileOfNode(id),
192
+ func(token *ast.Node) bool {
193
+ // write
194
+ if ast.IsWriteAccess(token) &&
195
+ (incrementor == nil || !isAncestorOf(incrementor, token)) {
196
+ return true
197
+ }
198
+
199
+ // async read
200
+ ancestor := GetAncestor(token, func(v *ast.Node) bool { return v == forStatement || ast.IsFunctionLike(v) })
201
+ if ancestor != nil && ancestor != forStatement {
202
+ return true
203
+ }
204
+ return false
205
+ },
206
+ forStatement,
207
+ )
208
+ }
209
+
210
+ func transformForStatementFallback(state *TransformState, node *ast.Node) *luau.List {
211
+ forStatement := node.AsForStatement()
212
+ initializer, condition, incrementor, statement := forStatement.Initializer, forStatement.Condition, forStatement.Incrementor, forStatement.Statement
213
+
214
+ result := luau.NewList()
215
+ whileStatements := luau.NewList()
216
+ finalizerStatements := luau.NewList()
217
+
218
+ var variables []*ast.Node
219
+ if initializer != nil && ast.IsVariableDeclarationList(initializer) {
220
+ variables = getDeclaredVariables(initializer)
221
+ }
222
+ hasWriteOrAsyncRead := map[*ast.Symbol]bool{}
223
+ skipClone := map[*ast.Symbol]bool{}
224
+
225
+ if initializer != nil && ast.IsVariableDeclarationList(initializer) {
226
+ for _, id := range variables {
227
+ symbol := state.Checker.GetSymbolAtLocation(id)
228
+ if symbol == nil {
229
+ panic(shared.AssertionMessage(""))
230
+ }
231
+ if isIDWriteOrAsyncRead(state, node, id) {
232
+ hasWriteOrAsyncRead[symbol] = true
233
+ }
234
+ if canSkipClone(state, initializer, id) {
235
+ skipClone[symbol] = true
236
+ }
237
+ }
238
+ }
239
+
240
+ if initializer != nil {
241
+ if ast.IsVariableDeclarationList(initializer) {
242
+ if isVarDeclaration(initializer) {
243
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoVar.At(shared.AtNode(node)))
244
+ }
245
+
246
+ for _, id := range variables {
247
+ symbol := state.Checker.GetSymbolAtLocation(id)
248
+ if symbol == nil {
249
+ panic(shared.AssertionMessage(""))
250
+ }
251
+ if hasWriteOrAsyncRead[symbol] {
252
+ if skipClone[symbol] {
253
+ state.SymbolToIDMap[symbol] = luau.NewTempID(forStatementNodeText(id))
254
+ } else {
255
+ copyID := luau.NewTempID(forStatementNodeText(id) + "Copy")
256
+ state.SymbolToIDMap[symbol] = copyID
257
+ }
258
+ }
259
+ }
260
+
261
+ for _, declaration := range initializer.AsVariableDeclarationList().Declarations.Nodes {
262
+ decStatements, decPrereqs := Capture(state, func() *luau.List {
263
+ result := luau.NewList()
264
+ decStatements, decPrereqs := Capture(state, func() *luau.List {
265
+ return transformVariableDeclaration(state, declaration)
266
+ })
267
+ result.PushList(decPrereqs)
268
+ result.PushList(decStatements)
269
+ return result
270
+ })
271
+ result.PushList(decPrereqs)
272
+ result.PushList(decStatements)
273
+ }
274
+
275
+ for _, id := range variables {
276
+ symbol := state.Checker.GetSymbolAtLocation(id)
277
+ if symbol == nil {
278
+ panic(shared.AssertionMessage(""))
279
+ }
280
+ if hasWriteOrAsyncRead[symbol] {
281
+ var tempID *luau.TemporaryIdentifier
282
+ if skipClone[symbol] {
283
+ tempID = state.SymbolToIDMap[symbol]
284
+ if tempID == nil {
285
+ panic(shared.AssertionMessage(""))
286
+ }
287
+ } else {
288
+ tempID = luau.NewTempID(forStatementNodeText(id))
289
+ copyID := state.SymbolToIDMap[symbol]
290
+ if copyID == nil {
291
+ panic(shared.AssertionMessage(""))
292
+ }
293
+
294
+ // local _i = _iCopy
295
+ result.Push(luau.Create(&luau.VariableDeclaration{
296
+ Left: tempID,
297
+ Right: copyID,
298
+ }))
299
+ }
300
+ delete(state.SymbolToIDMap, symbol)
301
+ realID := transformIdentifierDefined(state, id)
302
+
303
+ // local i = _i
304
+ whileStatements.Push(luau.Create(&luau.VariableDeclaration{
305
+ Left: realID,
306
+ Right: tempID,
307
+ }))
308
+
309
+ // _i = i
310
+ finalizerStatements.Push(luau.Create(&luau.Assignment{
311
+ Left: tempID,
312
+ Operator: luau.AssignEqual,
313
+ Right: realID,
314
+ }))
315
+ }
316
+ }
317
+ } else {
318
+ statements, prereqs := Capture(state, func() *luau.List { return transformExpressionStatementInner(state, initializer) })
319
+ result.PushList(prereqs)
320
+ result.PushList(statements)
321
+ }
322
+ }
323
+
324
+ if incrementor != nil {
325
+ shouldIncrement := luau.NewTempID("shouldIncrement")
326
+
327
+ // local _shouldIncrement = false
328
+ result.Push(luau.Create(&luau.VariableDeclaration{
329
+ Left: shouldIncrement,
330
+ Right: luau.NewBool(false),
331
+ }))
332
+
333
+ incrementorStatements := luau.NewList()
334
+ statements, prereqs := Capture(state, func() *luau.List { return transformExpressionStatementInner(state, incrementor) })
335
+ incrementorStatements.PushList(prereqs)
336
+ incrementorStatements.PushList(statements)
337
+
338
+ // if _shouldIncrement then
339
+ // [incrementorStatements]
340
+ // else
341
+ // _shouldIncrement = true
342
+ // end
343
+ whileStatements.Push(luau.Create(&luau.IfStatement{
344
+ Condition: shouldIncrement,
345
+ Statements: incrementorStatements,
346
+ ElseBody: luau.MakeList(luau.Create(&luau.Assignment{
347
+ Left: shouldIncrement,
348
+ Operator: luau.AssignEqual,
349
+ Right: luau.NewBool(true),
350
+ })),
351
+ }))
352
+ }
353
+
354
+ conditionExp, conditionPrereqs := Capture(state, func() luau.Expression {
355
+ if condition != nil {
356
+ return createTruthinessChecks(state, transformExpression(state, condition), condition)
357
+ } else {
358
+ return luau.NewBool(true)
359
+ }
360
+ })
361
+
362
+ whileStatements.PushList(conditionPrereqs)
363
+
364
+ if !whileStatements.IsEmpty() {
365
+ if condition != nil {
366
+ // if not [conditionExp] then
367
+ // break
368
+ // end
369
+ whileStatements.Push(luau.Create(&luau.IfStatement{
370
+ Condition: luau.NewUnary(luau.UnaryNot, conditionExp),
371
+ Statements: luau.MakeList(luau.Create(&luau.BreakStatement{})),
372
+ ElseBody: luau.NewList(),
373
+ }))
374
+ }
375
+ conditionExp = luau.NewBool(true)
376
+ }
377
+
378
+ whileStatements.PushList(transformStatementList(state, statement, getStatements(statement), nil))
379
+
380
+ if whileStatements.IsNonEmpty() && finalizerStatements.IsNonEmpty() {
381
+ addFinalizers(whileStatements, whileStatements.Head, finalizerStatements)
382
+ }
383
+
384
+ if whileStatements.Tail == nil || !luau.IsFinalStatement(whileStatements.Tail.Value) {
385
+ whileStatements.PushList(finalizerStatements)
386
+ }
387
+
388
+ result.Push(luau.Create(&luau.WhileStatement{
389
+ Condition: conditionExp,
390
+ Statements: whileStatements,
391
+ }))
392
+
393
+ if result.Head == result.Tail {
394
+ return result
395
+ }
396
+ return luau.MakeList(luau.Create(&luau.DoStatement{Statements: result}))
397
+ }
398
+
399
+ // getOptimizedIncrementorStepValue returns false where JS returns undefined.
400
+ func getOptimizedIncrementorStepValue(state *TransformState, incrementor *ast.Node, idSymbol *ast.Symbol) (float64, bool) {
401
+ if ast.IsBinaryExpression(incrementor) {
402
+ binary := incrementor.AsBinaryExpression()
403
+ if ast.IsIdentifier(binary.Left) &&
404
+ state.Checker.GetSymbolAtLocation(binary.Left) == idSymbol &&
405
+ binary.OperatorToken.Kind == ast.KindPlusEqualsToken &&
406
+ ast.IsNumericLiteral(binary.Right) &&
407
+ isProbablyInteger(state, binary.Right) {
408
+ return float64(jsnum.FromString(forStatementNodeText(binary.Right))), true
409
+ } else if binary.OperatorToken.Kind == ast.KindMinusEqualsToken &&
410
+ ast.IsNumericLiteral(binary.Right) &&
411
+ isProbablyInteger(state, binary.Right) {
412
+ return -float64(jsnum.FromString(forStatementNodeText(binary.Right))), true
413
+ }
414
+ } else if ast.IsPostfixUnaryExpression(incrementor) || ast.IsPrefixUnaryExpression(incrementor) {
415
+ operand, operator := unaryExpressionParts(incrementor)
416
+ if ast.IsIdentifier(operand) &&
417
+ state.Checker.GetSymbolAtLocation(operand) == idSymbol &&
418
+ operator == ast.KindPlusPlusToken {
419
+ return 1, true
420
+ } else if ast.IsIdentifier(operand) &&
421
+ state.Checker.GetSymbolAtLocation(operand) == idSymbol &&
422
+ operator == ast.KindMinusMinusToken {
423
+ return -1, true
424
+ }
425
+ }
426
+ return 0, false
427
+ }
428
+
429
+ func isSizeMacro(state *TransformState, expression *ast.Node) bool {
430
+ if ast.IsCallExpression(expression) {
431
+ expType := state.Checker.GetNonOptionalType(state.GetType(expression.Expression()))
432
+ symbol := getFirstDefinedSymbol(state, expType)
433
+ if symbol != nil {
434
+ macro := getPropertyCallMacro(state, symbol)
435
+ if macro != nil && symbol.Name() == "size" {
436
+ return true
437
+ }
438
+ }
439
+ }
440
+ return false
441
+ }
442
+
443
+ func isMutatedInBody(state *TransformState, identifier *ast.Node, body *ast.Node) bool {
444
+ return forStatementEachSymbolReferenceInFile(
445
+ state,
446
+ identifier,
447
+ ast.GetSourceFileOfNode(identifier),
448
+ func(token *ast.Node) bool {
449
+ parent := SkipUpwards(token).Parent
450
+ if ast.IsAssignmentExpression(parent, false) && SkipDownwards(parent.AsBinaryExpression().Left) == token {
451
+ return true
452
+ } else if isUnaryExpressionWithWrite(parent) {
453
+ if operand, _ := unaryExpressionParts(parent); SkipDownwards(operand) == token {
454
+ return true
455
+ }
456
+ }
457
+ return false
458
+ },
459
+ body,
460
+ )
461
+ }
462
+
463
+ func isProbablyInteger(state *TransformState, expression *ast.Node) bool {
464
+ if ast.IsNumericLiteral(expression) {
465
+ return forStatementNumberIsInteger(jsnum.FromString(forStatementNodeText(expression)))
466
+ } else if ast.IsBinaryExpression(expression) {
467
+ binary := expression.AsBinaryExpression()
468
+ if binary.OperatorToken.Kind == ast.KindPlusToken ||
469
+ binary.OperatorToken.Kind == ast.KindMinusToken ||
470
+ binary.OperatorToken.Kind == ast.KindAsteriskToken ||
471
+ binary.OperatorToken.Kind == ast.KindAsteriskAsteriskToken {
472
+ return isProbablyInteger(state, binary.Left) && isProbablyInteger(state, binary.Right)
473
+ }
474
+ } else if ast.IsPrefixUnaryExpression(expression) {
475
+ prefix := expression.AsPrefixUnaryExpression()
476
+ if prefix.Operator == ast.KindPlusToken || prefix.Operator == ast.KindMinusToken {
477
+ return isProbablyInteger(state, prefix.Operand)
478
+ }
479
+ } else if isSizeMacro(state, expression) {
480
+ return true
481
+ } else if isDefinitelyType(state.GetType(expression), func(t *checker.Type) bool {
482
+ if !t.IsNumberLiteral() {
483
+ return false
484
+ }
485
+ value, ok := t.AsLiteralType().Value().(jsnum.Number)
486
+ return ok && forStatementNumberIsInteger(value)
487
+ }) {
488
+ return true
489
+ }
490
+ return false
491
+ }
492
+
493
+ // transformForStatementOptimized returns nil where JS returns undefined.
494
+ func transformForStatementOptimized(state *TransformState, node *ast.Node) *luau.List {
495
+ forStatement := node.AsForStatement()
496
+ initializer, condition, incrementor, statement := forStatement.Initializer, forStatement.Condition, forStatement.Incrementor, forStatement.Statement
497
+
498
+ // this function is difficult to break up because it uses several type guard functions..
499
+
500
+ // validate initializer exists and is a single identifier `x` with a value that is _probably_ an integer
501
+
502
+ if initializer == nil || !ast.IsVariableDeclarationList(initializer) || len(initializer.AsVariableDeclarationList().Declarations.Nodes) != 1 {
503
+ return nil
504
+ }
505
+
506
+ declaration := initializer.AsVariableDeclarationList().Declarations.Nodes[0]
507
+ decName, decInit := declaration.Name(), declaration.AsVariableDeclaration().Initializer
508
+ if !ast.IsIdentifier(decName) || decInit == nil {
509
+ return nil
510
+ }
511
+
512
+ idSymbol := state.Checker.GetSymbolAtLocation(decName)
513
+ if idSymbol == nil {
514
+ return nil
515
+ }
516
+
517
+ if !isProbablyInteger(state, decInit) {
518
+ return nil
519
+ }
520
+
521
+ // validate incrementor exists and is _probably_ an integer change in `x`
522
+
523
+ if incrementor == nil {
524
+ return nil
525
+ }
526
+
527
+ stepValue, hasStepValue := getOptimizedIncrementorStepValue(state, incrementor, idSymbol)
528
+ if !hasStepValue {
529
+ return nil
530
+ }
531
+
532
+ // validate condition exists and is a BinaryExpression with an operator that matches the incrementor
533
+
534
+ if condition == nil || !ast.IsBinaryExpression(condition) {
535
+ return nil
536
+ }
537
+
538
+ conditionBinary := condition.AsBinaryExpression()
539
+ operatorKind := conditionBinary.OperatorToken.Kind
540
+ if operatorKind == ast.KindLessThanToken || operatorKind == ast.KindLessThanEqualsToken {
541
+ // do not optimize for cases which should never run like:
542
+ // for (let i = 10; i < 0; i--)
543
+ if stepValue < 0 {
544
+ return nil
545
+ }
546
+ } else if operatorKind == ast.KindGreaterThanToken || operatorKind == ast.KindGreaterThanEqualsToken {
547
+ // do not optimize for cases which should never run like:
548
+ // for (let i = 0; i > 10; i++)
549
+ if stepValue > 0 {
550
+ return nil
551
+ }
552
+ } else {
553
+ // do not optimize for other comparison operators like !==, ===
554
+ return nil
555
+ }
556
+
557
+ if !isProbablyInteger(state, conditionBinary.Right) {
558
+ return nil
559
+ }
560
+
561
+ if isMutatedInBody(state, decName, statement) {
562
+ return nil
563
+ }
564
+
565
+ // commit to the optimization and start transforming..
566
+
567
+ result := luau.NewList()
568
+
569
+ id := transformIdentifierDefined(state, decName)
570
+
571
+ start, startPrereqs := Capture(state, func() luau.Expression { return transformExpression(state, decInit) })
572
+ result.PushList(startPrereqs)
573
+
574
+ end, endPrereqs := Capture(state, func() luau.Expression { return transformExpression(state, conditionBinary.Right) })
575
+ result.PushList(endPrereqs)
576
+
577
+ step := luau.NewNumber(stepValue)
578
+ statements := transformStatementList(state, statement, getStatements(statement), nil)
579
+
580
+ if operatorKind == ast.KindLessThanToken {
581
+ end = offset(end, -1)
582
+ } else if operatorKind == ast.KindGreaterThanToken {
583
+ end = offset(end, 1)
584
+ }
585
+
586
+ result.Push(luau.Create(&luau.NumericForStatement{ID: id, Start: start, End: end, Step: step, Statements: statements}))
587
+
588
+ return result
589
+ }
590
+
591
+ func transformForStatement(state *TransformState, node *ast.Node) *luau.List {
592
+ if state.Data.ProjectOptions.OptimizedLoops {
593
+ optimized := transformForStatementOptimized(state, node)
594
+ if optimized != nil {
595
+ return optimized
596
+ }
597
+ }
598
+ return transformForStatementFallback(state, node)
599
+ }
@@ -0,0 +1,84 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/statements/transformFunctionDeclaration.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
9
+ )
10
+
11
+ func transformFunctionDeclaration(state *TransformState, node *ast.Node) *luau.List {
12
+ declaration := node.AsFunctionDeclaration()
13
+ if declaration.Body == nil {
14
+ return luau.NewList()
15
+ }
16
+
17
+ isExportDefault := ast.HasSyntacticModifier(node, ast.ModifierFlagsExportDefault)
18
+
19
+ nodeName := node.Name()
20
+ if !(nodeName != nil || isExportDefault) {
21
+ panic(shared.AssertionMessage(""))
22
+ }
23
+
24
+ if nodeName != nil {
25
+ validateIdentifier(state, nodeName)
26
+ }
27
+
28
+ var name luau.AnyIdentifier
29
+ if nodeName != nil {
30
+ name = transformIdentifierDefined(state, nodeName)
31
+ } else {
32
+ name = luau.NewID("default")
33
+ }
34
+
35
+ transformed := transformParameters(state, node)
36
+ statements, parameters, hasDotDotDot := transformed.statements, transformed.parameters, transformed.hasDotDotDot
37
+ statements.PushList(transformStatementList(state, declaration.Body, declaration.Body.AsBlock().Statements.Nodes, nil))
38
+
39
+ localize := isExportDefault
40
+ if nodeName != nil {
41
+ symbol := state.Checker.GetSymbolAtLocation(nodeName)
42
+ if symbol == nil {
43
+ panic(shared.AssertionMessage(""))
44
+ }
45
+ localize = !state.IsHoisted[symbol]
46
+ }
47
+
48
+ isAsync := ast.HasSyntacticModifier(node, ast.ModifierFlagsAsync)
49
+
50
+ if declaration.AsteriskToken != nil {
51
+ if isAsync {
52
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoAsyncGeneratorFunctions.At(shared.AtNode(node)))
53
+ }
54
+ statements = wrapStatementsAsGenerator(state, node, statements)
55
+ }
56
+
57
+ if isAsync {
58
+ right := luau.NewCall(state.TS(node, "async"), luau.Create(&luau.FunctionExpression{
59
+ HasDotDotDot: hasDotDotDot,
60
+ Parameters: parameters,
61
+ Statements: statements,
62
+ }))
63
+ if localize {
64
+ return luau.MakeList(luau.Create(&luau.VariableDeclaration{
65
+ Left: name,
66
+ Right: right,
67
+ }))
68
+ } else {
69
+ return luau.MakeList(luau.Create(&luau.Assignment{
70
+ Left: name,
71
+ Operator: luau.AssignEqual,
72
+ Right: right,
73
+ }))
74
+ }
75
+ } else {
76
+ return luau.MakeList(luau.Create(&luau.FunctionDeclaration{
77
+ Localize: localize,
78
+ Name: name.(luau.WritableExpression),
79
+ Statements: statements,
80
+ Parameters: parameters,
81
+ HasDotDotDot: hasDotDotDot,
82
+ }))
83
+ }
84
+ }