@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,355 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/class/transformClassLikeDeclaration.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
+ const magicToStringMethod = "toString"
12
+
13
+ func createNameFunction(name string) *luau.FunctionExpression {
14
+ return luau.Create(&luau.FunctionExpression{
15
+ Statements: luau.MakeList(luau.Create(&luau.ReturnStatement{
16
+ Expression: luau.NewString(name),
17
+ })),
18
+ Parameters: luau.NewList(),
19
+ HasDotDotDot: false,
20
+ })
21
+ }
22
+
23
+ func createBoilerplate(state *TransformState, node *ast.Node, className luau.AnyIdentifier, isClassExpression bool) *luau.List {
24
+ isAbstract := ast.HasAbstractModifier(node)
25
+ statements := luau.NewList()
26
+
27
+ /* boilerplate:
28
+ className = setmetatable({}, {
29
+ __tostring = function() return "className" end;
30
+ });
31
+ className.__index = className;
32
+ function className.new(...)
33
+ local self = setmetatable({}, className);
34
+ self:constructor(...);
35
+ return self;
36
+ end;
37
+ function className:constructor()
38
+ end;
39
+ */
40
+
41
+ // className = setmetatable({}, {
42
+ // __tostring = function() return "className" end;
43
+ // __index = super,
44
+ // });
45
+
46
+ // if a class is abstract and it does not extend any class, it can just be a plain table
47
+ // otherwise we can use the default boilerplate
48
+ extendsNode := getExtendsNode(node)
49
+ if isAbstract && extendsNode == nil {
50
+ statements.Push(luau.Create(&luau.Assignment{
51
+ Left: className,
52
+ Operator: luau.AssignEqual,
53
+ Right: luau.NewMap(),
54
+ }))
55
+ } else {
56
+ metatableFields := luau.NewList()
57
+ var classNameText string
58
+ if luau.IsTemporaryIdentifier(className) {
59
+ classNameText = "Anonymous"
60
+ } else {
61
+ classNameText = className.(*luau.Identifier).Name
62
+ }
63
+ metatableFields.Push(luau.Create(&luau.MapField{
64
+ Index: luau.Strings.Tostring,
65
+ Value: createNameFunction(classNameText),
66
+ }))
67
+
68
+ if extendsNode != nil {
69
+ extendsExp, extendsExpPrereqs := Capture(state, func() luau.Expression {
70
+ return transformExpression(state, extendsNode.Expression())
71
+ })
72
+ superID := luau.NewID("super")
73
+ statements.PushList(extendsExpPrereqs)
74
+ statements.Push(luau.Create(&luau.VariableDeclaration{
75
+ Left: superID,
76
+ Right: extendsExp,
77
+ }))
78
+ metatableFields.Push(luau.Create(&luau.MapField{
79
+ Index: luau.Strings.Index,
80
+ Value: superID,
81
+ }))
82
+ }
83
+
84
+ metatable := luau.NewCall(luau.Globals.Setmetatable,
85
+ luau.NewMap(),
86
+ luau.Create(&luau.Map{Fields: metatableFields}),
87
+ )
88
+
89
+ if isClassExpression && node.Name() != nil {
90
+ statements.Push(luau.Create(&luau.VariableDeclaration{
91
+ Left: transformIdentifierDefined(state, node.Name()),
92
+ Right: metatable,
93
+ }))
94
+ } else {
95
+ statements.Push(luau.Create(&luau.Assignment{
96
+ Left: className,
97
+ Operator: luau.AssignEqual,
98
+ Right: metatable,
99
+ }))
100
+ }
101
+
102
+ // className.__index = className;
103
+ statements.Push(luau.Create(&luau.Assignment{
104
+ Left: luau.NewProperty(className, "__index"),
105
+ Operator: luau.AssignEqual,
106
+ Right: className,
107
+ }))
108
+ }
109
+
110
+ // statements for className.new
111
+ if !isAbstract {
112
+ statementsInner := luau.NewList()
113
+
114
+ // local self = setmetatable({}, className);
115
+ statementsInner.Push(luau.Create(&luau.VariableDeclaration{
116
+ Left: luau.Globals.Self,
117
+ Right: luau.NewCall(luau.Globals.Setmetatable, luau.NewMap(), className),
118
+ }))
119
+
120
+ // return self:constructor(...) or self;
121
+ statementsInner.Push(luau.Create(&luau.ReturnStatement{
122
+ Expression: luau.NewBinary(
123
+ luau.Create(&luau.MethodCallExpression{
124
+ Expression: luau.Globals.Self,
125
+ Name: "constructor",
126
+ Args: luau.MakeList(luau.Create(&luau.VarArgsLiteral{})),
127
+ }),
128
+ luau.BinaryOr,
129
+ luau.Globals.Self,
130
+ ),
131
+ }))
132
+
133
+ // function className.new(...)
134
+ // end;
135
+ statements.Push(luau.Create(&luau.FunctionDeclaration{
136
+ Name: luau.NewProperty(className, "new"),
137
+ Parameters: luau.NewList(),
138
+ HasDotDotDot: true,
139
+ Statements: statementsInner,
140
+ Localize: false,
141
+ }))
142
+ }
143
+
144
+ return statements
145
+ }
146
+
147
+ func isClassHoisted(state *TransformState, node *ast.Node) bool {
148
+ if node.Name() != nil {
149
+ symbol := state.Checker.GetSymbolAtLocation(node.Name())
150
+ if symbol == nil {
151
+ panic(shared.AssertionMessage(""))
152
+ }
153
+ return state.IsHoisted[symbol] == true
154
+ }
155
+ return false
156
+ }
157
+
158
+ // transformClassLikeDeclarationResult is the object transformClassLikeDeclaration returns.
159
+ type transformClassLikeDeclarationResult struct {
160
+ statements *luau.List
161
+ name luau.AnyIdentifier
162
+ }
163
+
164
+ func transformClassLikeDeclaration(state *TransformState, node *ast.Node) transformClassLikeDeclarationResult {
165
+ isClassExpression := ast.IsClassExpression(node)
166
+ statements := luau.NewList()
167
+
168
+ isExportDefault := ast.HasSyntacticModifier(node, ast.ModifierFlagsExportDefault)
169
+
170
+ if node.Name() != nil {
171
+ validateIdentifier(state, node.Name())
172
+ }
173
+
174
+ /*
175
+ local className;
176
+ do
177
+ OOP boilerplate
178
+ class functions
179
+ end
180
+ */
181
+
182
+ shouldUseInternalName := isClassExpression && node.Name() != nil
183
+
184
+ var returnVar luau.AnyIdentifier
185
+ if shouldUseInternalName {
186
+ returnVar = luau.NewTempID("class")
187
+ } else if node.Name() != nil {
188
+ returnVar = transformIdentifierDefined(state, node.Name())
189
+ } else if isExportDefault {
190
+ returnVar = luau.NewID("default")
191
+ } else {
192
+ returnVar = luau.NewTempID("class")
193
+ }
194
+
195
+ var internalName luau.AnyIdentifier
196
+ if shouldUseInternalName {
197
+ internalName = transformIdentifierDefined(state, node.Name())
198
+ } else {
199
+ internalName = returnVar
200
+ }
201
+ state.ClassIdentifierMap[node] = internalName
202
+ if !isClassHoisted(state, node) {
203
+ statements.Push(luau.Create(&luau.VariableDeclaration{
204
+ Left: returnVar,
205
+ Right: nil,
206
+ }))
207
+ }
208
+
209
+ // OOP boilerplate + class functions
210
+ statementsInner := luau.NewList()
211
+ statementsInner.PushList(createBoilerplate(state, node, internalName, isClassExpression))
212
+
213
+ constructor := findConstructor(node)
214
+ if constructor != nil {
215
+ statementsInner.PushList(transformClassConstructor(state, constructor, internalName))
216
+ } else {
217
+ statementsInner.PushList(transformImplicitClassConstructor(state, node, internalName))
218
+ }
219
+
220
+ for _, member := range node.Members() {
221
+ if (ast.IsPropertyDeclaration(member) || ast.IsMethodDeclaration(member)) &&
222
+ (ast.IsIdentifier(member.Name()) || ast.IsStringLiteral(member.Name())) &&
223
+ luau.IsReservedClassField(member.Name().Text()) {
224
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoReservedClassFields.At(shared.AtNode(member.Name())))
225
+ }
226
+ if ast.IsAutoAccessorPropertyDeclaration(member) {
227
+ // member must have AccessorKeyword to be AutoAccessorPropertyDeclaration
228
+ var keyword *ast.Node
229
+ for _, m := range member.ModifierNodes() {
230
+ if m.Kind == ast.KindAccessorKeyword {
231
+ keyword = m
232
+ break
233
+ }
234
+ }
235
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoAutoAccessorModifiers.At(shared.AtNode(keyword)))
236
+ }
237
+ }
238
+
239
+ var methods []*ast.Node
240
+ var staticDeclarations []*ast.Node
241
+
242
+ for _, member := range node.Members() {
243
+ validateMethodAssignment(state, member)
244
+ if ast.IsConstructorDeclaration(member) ||
245
+ ast.IsIndexSignatureDeclaration(member) ||
246
+ ast.IsSemicolonClassElement(member) {
247
+ continue
248
+ } else if ast.IsMethodDeclaration(member) {
249
+ methods = append(methods, member)
250
+ } else if ast.IsPropertyDeclaration(member) {
251
+ // non-static properties are done in transformClassConstructor
252
+ if !ast.HasStaticModifier(member) {
253
+ continue
254
+ }
255
+ staticDeclarations = append(staticDeclarations, member)
256
+ } else if ast.IsAccessor(member) {
257
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoGetterSetter.At(shared.AtNode(member)))
258
+ } else if ast.IsClassStaticBlockDeclaration(member) {
259
+ staticDeclarations = append(staticDeclarations, member)
260
+ } else {
261
+ panic(shared.AssertionMessage("ClassMember kind not implemented: " + getKindName(member.Kind)))
262
+ }
263
+ }
264
+
265
+ classType := state.Checker.GetTypeOfSymbolAtLocation(node.Symbol(), node)
266
+ instanceType := state.Checker.GetDeclaredTypeOfSymbol(node.Symbol())
267
+
268
+ for _, method := range methods {
269
+ if ast.IsIdentifier(method.Name()) || ast.IsStringLiteral(method.Name()) {
270
+ if luau.IsMetamethod(method.Name().Text()) {
271
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoClassMetamethods.At(shared.AtNode(method.Name())))
272
+ }
273
+
274
+ if ast.HasStaticModifier(method) {
275
+ if state.Checker.GetPropertyOfType(instanceType, method.Name().Text()) != nil {
276
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoInstanceMethodCollisions.At(shared.AtNode(method)))
277
+ }
278
+ } else {
279
+ if state.Checker.GetPropertyOfType(classType, method.Name().Text()) != nil {
280
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoStaticMethodCollisions.At(shared.AtNode(method)))
281
+ }
282
+ }
283
+ }
284
+
285
+ statements, prereqs := Capture(state, func() *luau.List {
286
+ return transformMethodDeclaration(state, method, &mapPointer{name: "name", value: internalName})
287
+ })
288
+ statementsInner.PushList(prereqs)
289
+ statementsInner.PushList(statements)
290
+ }
291
+
292
+ toStringProperty := state.Checker.GetPropertyOfType(instanceType, magicToStringMethod)
293
+ if toStringProperty != nil && toStringProperty.Flags()&ast.SymbolFlagsMethod != 0 {
294
+ statementsInner.Push(luau.Create(&luau.MethodDeclaration{
295
+ Expression: internalName,
296
+ Name: "__tostring",
297
+ HasDotDotDot: false,
298
+ Parameters: luau.NewList(),
299
+ Statements: luau.MakeList(luau.Create(&luau.ReturnStatement{
300
+ Expression: luau.Create(&luau.MethodCallExpression{
301
+ Expression: luau.Globals.Self,
302
+ Name: magicToStringMethod,
303
+ Args: luau.NewList(),
304
+ }),
305
+ })),
306
+ }))
307
+ }
308
+
309
+ for _, declaration := range staticDeclarations {
310
+ if ast.IsClassStaticBlockDeclaration(declaration) {
311
+ // Body() has no case for a static block in TS 7, so read the field
312
+ statementsInner.PushList(transformBlock(state, declaration.AsClassStaticBlockDeclaration().Body))
313
+ } else {
314
+ statements, prereqs := Capture(state, func() *luau.List {
315
+ return transformPropertyDeclaration(state, declaration, internalName)
316
+ })
317
+ statementsInner.PushList(prereqs)
318
+ statementsInner.PushList(statements)
319
+ }
320
+ }
321
+
322
+ // if using internal name, assign to return var
323
+ if shouldUseInternalName {
324
+ statementsInner.Push(luau.Create(&luau.Assignment{
325
+ Left: returnVar,
326
+ Operator: luau.AssignEqual,
327
+ Right: internalName,
328
+ }))
329
+ }
330
+
331
+ statementsInner.PushList(transformDecorators(state, node, returnVar))
332
+
333
+ statements.Push(luau.Create(&luau.DoStatement{
334
+ Statements: statementsInner,
335
+ }))
336
+
337
+ return transformClassLikeDeclarationResult{statements: statements, name: returnVar}
338
+ }
339
+
340
+ // getAllSuperTypeNodes is ts.getAllSuperTypeNodes from TS 5.5.3, used by validateMethodAssignment. In JS files, TS 5.5.3
341
+ // reads JSDoc tags here. TS 7's reparser already puts `@implements` in the implements clause, so that case is covered.
342
+ // For `@augments`, TS 5.5.3 returns the tag's class node and this returns the extends element. Only allowJs reaches that.
343
+ func getAllSuperTypeNodes(node *ast.Node) []*ast.Node {
344
+ if ast.IsInterfaceDeclaration(node) {
345
+ return ast.GetHeritageElements(node, ast.KindExtendsKeyword)
346
+ }
347
+ if ast.IsClassLike(node) {
348
+ var result []*ast.Node
349
+ if baseType := ast.GetClassExtendsHeritageElement(node); baseType != nil {
350
+ result = append(result, baseType)
351
+ }
352
+ return append(result, ast.GetHeritageElements(node, ast.KindImplementsKeyword)...)
353
+ }
354
+ return nil
355
+ }
@@ -0,0 +1,70 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/expressions/transformConditionalExpression.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ )
9
+
10
+ func transformConditionalExpression(state *TransformState, node *ast.Node) luau.Expression {
11
+ conditional := node.AsConditionalExpression()
12
+ condition := transformExpression(state, conditional.Condition)
13
+ whenTrue, whenTruePrereqs := Capture(state, func() luau.Expression { return transformExpression(state, conditional.WhenTrue) })
14
+ whenFalse, whenFalsePrereqs := Capture(state, func() luau.Expression { return transformExpression(state, conditional.WhenFalse) })
15
+
16
+ if isUsedAsStatement(node) {
17
+ whenTruePrereqs.PushList(wrapExpressionStatement(whenTrue))
18
+ whenFalsePrereqs.PushList(wrapExpressionStatement(whenFalse))
19
+ state.Prereq(
20
+ luau.Create(&luau.IfStatement{
21
+ Condition: createTruthinessChecks(state, condition, conditional.Condition),
22
+ Statements: whenTruePrereqs,
23
+ ElseBody: whenFalsePrereqs,
24
+ }),
25
+ )
26
+ return luau.NewNone()
27
+ }
28
+
29
+ if whenTruePrereqs.IsEmpty() && whenFalsePrereqs.IsEmpty() {
30
+ return luau.Create(&luau.IfExpression{
31
+ Condition: createTruthinessChecks(state, condition, conditional.Condition),
32
+ Expression: whenTrue,
33
+ Alternative: whenFalse,
34
+ })
35
+ }
36
+
37
+ tempId := luau.NewTempID("result")
38
+ state.Prereq(
39
+ luau.Create(&luau.VariableDeclaration{
40
+ Left: tempId,
41
+ Right: nil,
42
+ }),
43
+ )
44
+
45
+ whenTruePrereqs.Push(
46
+ luau.Create(&luau.Assignment{
47
+ Left: tempId,
48
+ Operator: luau.AssignEqual,
49
+ Right: whenTrue,
50
+ }),
51
+ )
52
+
53
+ whenFalsePrereqs.Push(
54
+ luau.Create(&luau.Assignment{
55
+ Left: tempId,
56
+ Operator: luau.AssignEqual,
57
+ Right: whenFalse,
58
+ }),
59
+ )
60
+
61
+ state.Prereq(
62
+ luau.Create(&luau.IfStatement{
63
+ Condition: createTruthinessChecks(state, condition, conditional.Condition),
64
+ Statements: whenTruePrereqs,
65
+ ElseBody: whenFalsePrereqs,
66
+ }),
67
+ )
68
+
69
+ return tempId
70
+ }
@@ -0,0 +1,30 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/statements/transformContinueStatement.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 transformContinueStatement(state *TransformState, node *ast.Node) *luau.List {
12
+ if label := node.AsContinueStatement().Label; label != nil {
13
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoLabeledStatement.At(shared.AtNode(label)))
14
+ return luau.NewList()
15
+ }
16
+
17
+ if state.Data.ProjectOptions.FixEmit {
18
+ return createContinueStatements(state, node)
19
+ }
20
+
21
+ if isBreakBlockedByTryStatement(node) {
22
+ state.MarkTryUses(func(u *TryUses) { u.UsesContinue = true })
23
+
24
+ return luau.MakeList(luau.Create(&luau.ReturnStatement{
25
+ Expression: state.TS(node, "TRY_CONTINUE"),
26
+ }))
27
+ }
28
+
29
+ return luau.MakeList(luau.Create(&luau.ContinueStatement{}))
30
+ }
@@ -0,0 +1,253 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/class/transformDecorators.ts.
4
+
5
+ import (
6
+ "slices"
7
+
8
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
9
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
10
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
11
+ )
12
+
13
+ func countDecorators(node *ast.Node) int {
14
+ return len(node.Decorators())
15
+ }
16
+
17
+ func parameterHasDecorators(parameter *ast.Node) bool {
18
+ return countDecorators(parameter) > 0
19
+ }
20
+
21
+ func shouldInline(state *TransformState, isLastDecorator bool, decorator *ast.Node, expression luau.Expression) bool {
22
+ // immutable expressions can be inlined
23
+ if !expressionMightMutate(state, expression, decorator.Expression()) {
24
+ return true
25
+ }
26
+
27
+ // if it's not the last decorator, we can't inline
28
+ // this is because we need to initialize all decorators before running them
29
+ if !isLastDecorator {
30
+ return false
31
+ }
32
+
33
+ node := decorator.Parent
34
+
35
+ // if the node is a method declaration and has a decorator on a parameter, we can't inline
36
+ // this is because we need to run parameter decorators between initializing and running method decorators
37
+ if ast.IsMethodDeclaration(node) && slices.ContainsFunc(node.Parameters(), parameterHasDecorators) {
38
+ return false
39
+ }
40
+
41
+ // if the node is a class declaration and has a decorator on a constructor parameter, we can't inline
42
+ // this is because we need to run constructor parameter decorators between initializing and running class decorators
43
+ if ast.IsClassLike(node) {
44
+ constructor := findConstructor(node)
45
+ if constructor != nil && slices.ContainsFunc(constructor.Parameters(), parameterHasDecorators) {
46
+ return false
47
+ }
48
+ }
49
+
50
+ // if the node is a parameter and there are any parameters with decorators after it, we can't inline
51
+ // this ensures all of the parameters are initialized before running any, including from sibling parameters
52
+ if ast.IsParameterDeclaration(node) {
53
+ parameters := node.Parent.Parameters()
54
+ paramIdx := slices.Index(parameters, node)
55
+ for i := paramIdx + 1; i < len(parameters); i++ {
56
+ if countDecorators(parameters[i]) > 0 {
57
+ return false
58
+ }
59
+ }
60
+ }
61
+
62
+ return true
63
+ }
64
+
65
+ func transformMemberDecorators(state *TransformState, node *ast.Node, callback func(expression luau.IndexableExpression) *luau.List) (initializers *luau.List, finalizers *luau.List) {
66
+ initializers = luau.NewList()
67
+ finalizers = luau.NewList()
68
+
69
+ decorators := node.Decorators()
70
+
71
+ for i := 0; i < len(decorators); i++ {
72
+ decorator := decorators[i]
73
+ expression, prereqs := Capture(state, func() luau.Expression { return transformExpression(state, decorator.Expression()) })
74
+
75
+ initializers.PushList(prereqs)
76
+
77
+ isLastDecorator := i == len(decorators)-1
78
+
79
+ if !shouldInline(state, isLastDecorator, decorator, expression) {
80
+ tempID := luau.NewTempID("decorator")
81
+ initializers.Push(luau.Create(&luau.VariableDeclaration{
82
+ Left: tempID,
83
+ Right: expression,
84
+ }))
85
+ expression = tempID
86
+ }
87
+
88
+ finalizers.UnshiftList(callback(convertToIndexableExpression(expression)))
89
+ }
90
+
91
+ return initializers, finalizers
92
+ }
93
+
94
+ func transformMethodDecorators(state *TransformState, member *ast.Node, classID luau.AnyIdentifier) *luau.List {
95
+ initializers, finalizers := transformMemberDecorators(state, member, func(expression luau.IndexableExpression) *luau.List {
96
+ result := luau.NewList()
97
+
98
+ // local _descriptor = decorator(Class, "name", { value = Class.name })
99
+ // if _descriptor then
100
+ // Class.name = _descriptor.value
101
+ // end
102
+
103
+ descriptorID := luau.NewTempID("descriptor")
104
+ key := state.GetClassElementObjectKey(member)
105
+ if key == nil {
106
+ panic(shared.AssertionMessage("Did not find method key for method decorator"))
107
+ }
108
+
109
+ result.Push(luau.Create(&luau.VariableDeclaration{
110
+ Left: descriptorID,
111
+ Right: luau.NewCall(expression,
112
+ classID,
113
+ key,
114
+ luau.NewMap(luau.KeyValue{
115
+ Index: luau.NewString("value"),
116
+ Value: luau.Create(&luau.ComputedIndexExpression{
117
+ Expression: classID,
118
+ Index: key,
119
+ }),
120
+ }),
121
+ ),
122
+ }))
123
+
124
+ result.Push(luau.Create(&luau.IfStatement{
125
+ Condition: descriptorID,
126
+ Statements: luau.MakeList(luau.Create(&luau.Assignment{
127
+ Left: luau.Create(&luau.ComputedIndexExpression{
128
+ Expression: classID,
129
+ Index: key,
130
+ }),
131
+ Operator: luau.AssignEqual,
132
+ Right: luau.NewProperty(descriptorID, "value"),
133
+ })),
134
+ ElseBody: luau.NewList(),
135
+ }))
136
+
137
+ return result
138
+ })
139
+
140
+ result := luau.NewList()
141
+ result.PushList(initializers)
142
+ result.PushList(transformParameterDecorators(state, member, classID))
143
+ result.PushList(finalizers)
144
+ return result
145
+ }
146
+
147
+ func transformPropertyDecorators(state *TransformState, member *ast.Node, classID luau.AnyIdentifier) *luau.List {
148
+ initializers, finalizers := transformMemberDecorators(state, member, func(expression luau.IndexableExpression) *luau.List {
149
+ // typescript enforces that property keys are static, so they shouldn't have prereqs
150
+ key := state.NoPrereqs(func() luau.Expression { return transformPropertyName(state, member.Name()) })
151
+
152
+ // decorator(Class, "name")
153
+ return luau.MakeList(luau.Create(&luau.CallStatement{
154
+ Expression: luau.NewCall(expression, classID, key),
155
+ }))
156
+ })
157
+
158
+ result := luau.NewList()
159
+ result.PushList(initializers)
160
+ result.PushList(finalizers)
161
+ return result
162
+ }
163
+
164
+ func transformParameterDecorators(state *TransformState, member *ast.Node, classID luau.AnyIdentifier) *luau.List {
165
+ initializers := luau.NewList()
166
+ finalizers := luau.NewList()
167
+
168
+ parameters := member.Parameters()
169
+ for i := 0; i < len(parameters); i++ {
170
+ parameter := parameters[i]
171
+ paramInitializers, paramFinalizers := transformMemberDecorators(state, parameter, func(expression luau.IndexableExpression) *luau.List {
172
+ // No member.name means it's the constructor, so the name argument should be nil
173
+ var key luau.Expression
174
+ if member.Name() != nil {
175
+ key = state.GetClassElementObjectKey(member)
176
+ } else {
177
+ key = luau.NewNil()
178
+ }
179
+ if key == nil {
180
+ panic(shared.AssertionMessage("Did not find method key for parameter decorator"))
181
+ }
182
+
183
+ // decorator(Class, "name", 0)
184
+ return luau.MakeList(luau.Create(&luau.CallStatement{
185
+ Expression: luau.NewCall(expression, classID, key, luau.NewNumber(float64(i))),
186
+ }))
187
+ })
188
+ initializers.PushList(paramInitializers)
189
+ finalizers.UnshiftList(paramFinalizers)
190
+ }
191
+
192
+ result := luau.NewList()
193
+ result.PushList(initializers)
194
+ result.PushList(finalizers)
195
+ return result
196
+ }
197
+
198
+ func transformClassDecorators(state *TransformState, node *ast.Node, classID luau.AnyIdentifier) *luau.List {
199
+ initializers, finalizers := transformMemberDecorators(state, node, func(expression luau.IndexableExpression) *luau.List {
200
+ // Class = decorator(Class) or Class
201
+ return luau.MakeList(luau.Create(&luau.Assignment{
202
+ Left: classID,
203
+ Operator: luau.AssignEqual,
204
+ Right: luau.NewBinary(luau.NewCall(expression, classID), luau.BinaryOr, classID),
205
+ }))
206
+ })
207
+
208
+ result := luau.NewList()
209
+ result.PushList(initializers)
210
+
211
+ constructor := findConstructor(node)
212
+ if constructor != nil {
213
+ result.PushList(transformParameterDecorators(state, constructor, classID))
214
+ }
215
+
216
+ result.PushList(finalizers)
217
+ return result
218
+ }
219
+
220
+ func transformDecorators(state *TransformState, node *ast.Node, classID luau.AnyIdentifier) *luau.List {
221
+ result := luau.NewList()
222
+
223
+ // https://www.typescriptlang.org/docs/handbook/decorators.html#decorator-evaluation
224
+
225
+ // Instance Decorators
226
+ for _, member := range node.Members() {
227
+ if !ast.HasStaticModifier(member) {
228
+ // check `member.body` to skip overload signatures because decorators are not valid on them
229
+ if ast.IsMethodDeclaration(member) && member.Body() != nil {
230
+ result.PushList(transformMethodDecorators(state, member, classID))
231
+ } else if ast.IsPropertyDeclaration(member) {
232
+ result.PushList(transformPropertyDecorators(state, member, classID))
233
+ }
234
+ }
235
+ }
236
+
237
+ // Static Decorators
238
+ for _, member := range node.Members() {
239
+ if ast.HasStaticModifier(member) {
240
+ // check `member.body` to skip overload signatures because decorators are not valid on them
241
+ if ast.IsMethodDeclaration(member) && member.Body() != nil {
242
+ result.PushList(transformMethodDecorators(state, member, classID))
243
+ } else if ast.IsPropertyDeclaration(member) {
244
+ result.PushList(transformPropertyDecorators(state, member, classID))
245
+ }
246
+ }
247
+ }
248
+
249
+ // Class Decorators
250
+ result.PushList(transformClassDecorators(state, node, classID))
251
+
252
+ return result
253
+ }