@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,230 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/transformSourceFile.ts.
4
+
5
+ import (
6
+ "strings"
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/nodepath"
11
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/rojoresolver"
12
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
13
+ )
14
+
15
+ type exportPair struct {
16
+ name string
17
+ id luau.AnyIdentifier
18
+ }
19
+
20
+ func getExportPair(state *TransformState, exportSymbol *ast.Symbol) exportPair {
21
+ declarations := exportSymbol.Declarations()
22
+ var declaration *ast.Node
23
+ if len(declarations) > 0 {
24
+ declaration = declarations[0]
25
+ }
26
+ if declaration != nil && ast.IsExportSpecifier(declaration) {
27
+ specifier := declaration.AsExportSpecifier()
28
+ propertyName := specifier.PropertyName
29
+ if propertyName == nil {
30
+ propertyName = declaration.Name()
31
+ }
32
+ return exportPair{declaration.Name().Text(), transformIdentifierDefined(state, propertyName)}
33
+ }
34
+ name := exportSymbol.Name()
35
+ if exportSymbol.Name() == "default" && declaration != nil &&
36
+ (ast.IsFunctionDeclaration(declaration) || ast.IsClassDeclaration(declaration)) && declaration.Name() != nil {
37
+ name = declaration.Name().Text()
38
+ }
39
+ return exportPair{exportSymbol.Name(), luau.NewID(name)}
40
+ }
41
+
42
+ func isExportSymbolFromExportFrom(exportSymbol *ast.Symbol) bool {
43
+ for _, exportSpecifier := range exportSymbol.Declarations() {
44
+ if ast.IsExportSpecifier(exportSpecifier) {
45
+ exportDec := exportSpecifier.Parent.Parent
46
+ if ast.IsExportDeclaration(exportDec) && exportDec.AsExportDeclaration().ModuleSpecifier != nil {
47
+ return true
48
+ }
49
+ }
50
+ }
51
+ return false
52
+ }
53
+
54
+ func getIgnoredExportSymbols(state *TransformState, sourceFile *ast.SourceFile) map[*ast.Symbol]bool {
55
+ ignoredSymbols := map[*ast.Symbol]bool{}
56
+ for _, statement := range sourceFile.Statements.Nodes {
57
+ if !ast.IsExportDeclaration(statement) {
58
+ continue
59
+ }
60
+ declaration := statement.AsExportDeclaration()
61
+ if declaration.ModuleSpecifier == nil {
62
+ continue
63
+ }
64
+ if declaration.ExportClause == nil {
65
+ // export * from "./module";
66
+ moduleSymbol := getOriginalSymbolOfNode(state.Checker, declaration.ModuleSpecifier)
67
+ if moduleSymbol != nil {
68
+ for _, v := range state.GetModuleExports(moduleSymbol) {
69
+ ignoredSymbols[v] = true
70
+ }
71
+ }
72
+ } else if ast.IsNamespaceExport(declaration.ExportClause) {
73
+ // export * as id from "./module";
74
+ idSymbol := state.Checker.GetSymbolAtLocation(declaration.ExportClause.Name())
75
+ if idSymbol != nil {
76
+ ignoredSymbols[idSymbol] = true
77
+ }
78
+ }
79
+ }
80
+ return ignoredSymbols
81
+ }
82
+
83
+ // isExportSymbolOnlyFromDeclare is used to ignore exports in the form of `export declare const x: T;`. However, this
84
+ // should still allow exports which are declare + export separately, i.e.
85
+ //
86
+ // declare const x: number;
87
+ // export { x };
88
+ //
89
+ // This mimics TypeScript behavior.
90
+ func isExportSymbolOnlyFromDeclare(exportSymbol *ast.Symbol) bool {
91
+ for _, declaration := range exportSymbol.Declarations() {
92
+ statement := GetAncestor(declaration, ast.IsStatement)
93
+ if statement == nil || !ast.CanHaveModifiers(statement) || !hasDeclareModifier(statement) {
94
+ return false
95
+ }
96
+ }
97
+ return true
98
+ }
99
+
100
+ func hasDeclareModifier(node *ast.Node) bool {
101
+ for _, modifier := range node.ModifierNodes() {
102
+ if modifier.Kind == ast.KindDeclareKeyword {
103
+ return true
104
+ }
105
+ }
106
+ return false
107
+ }
108
+
109
+ // handleExports adds export information to the end of the tree.
110
+ func handleExports(state *TransformState, sourceFile *ast.SourceFile, symbol *ast.Symbol, statements *luau.List) {
111
+ ignoredExportSymbols := getIgnoredExportSymbols(state, sourceFile)
112
+
113
+ mustPushExports := state.HasExportFrom
114
+ var exportPairs []exportPair
115
+ if !state.HasExportEquals {
116
+ for _, exportSymbol := range state.GetModuleExports(symbol) {
117
+ if ignoredExportSymbols[exportSymbol] {
118
+ continue
119
+ }
120
+
121
+ // ignore prototype exports
122
+ if exportSymbol.Flags()&ast.SymbolFlagsPrototype != 0 {
123
+ continue
124
+ }
125
+
126
+ // export { default as x } from "./module";
127
+ if isExportSymbolFromExportFrom(exportSymbol) {
128
+ continue
129
+ }
130
+
131
+ originalSymbol := state.Checker.SkipAlias(exportSymbol)
132
+
133
+ // only export values
134
+ if !isSymbolOfValue(originalSymbol) {
135
+ continue
136
+ }
137
+
138
+ // handle this in transformIdentifier
139
+ if isSymbolMutable(state, originalSymbol) {
140
+ mustPushExports = true
141
+ continue
142
+ }
143
+
144
+ // ignore exports in the form of `export declare const x: T;`
145
+ if isExportSymbolOnlyFromDeclare(exportSymbol) {
146
+ continue
147
+ }
148
+
149
+ exportPairs = append(exportPairs, getExportPair(state, exportSymbol))
150
+ }
151
+ }
152
+
153
+ if state.HasExportEquals {
154
+ // local exports variable is created in transformExportAssignment
155
+ nodes := sourceFile.Statements.Nodes
156
+ finalStatement := nodes[len(nodes)-1]
157
+ if !(ast.IsExportAssignment(finalStatement) && finalStatement.AsExportAssignment().IsExportEquals) {
158
+ statements.Push(luau.Create(&luau.ReturnStatement{Expression: luau.Globals.Exports}))
159
+ }
160
+ } else if mustPushExports {
161
+ // if there's an export let/from, we need to put `local exports = {}` at the top of the file
162
+ statements.Unshift(luau.Create(&luau.VariableDeclaration{Left: luau.Globals.Exports, Right: luau.NewMap()}))
163
+ for _, pair := range exportPairs {
164
+ statements.Push(luau.Create(&luau.Assignment{
165
+ Left: luau.NewProperty(luau.Globals.Exports, pair.name),
166
+ Operator: luau.AssignEqual,
167
+ Right: pair.id,
168
+ }))
169
+ }
170
+ statements.Push(luau.Create(&luau.ReturnStatement{Expression: luau.Globals.Exports}))
171
+ } else if len(exportPairs) > 0 {
172
+ // only regular exports, we can do this as just returning an object at the bottom of the file
173
+ fields := luau.NewList()
174
+ for _, pair := range exportPairs {
175
+ fields.Push(luau.Create(&luau.MapField{Index: luau.NewString(pair.name), Value: pair.id}))
176
+ }
177
+ statements.Push(luau.Create(&luau.ReturnStatement{Expression: luau.Create(&luau.Map{Fields: fields})}))
178
+ }
179
+ }
180
+
181
+ func getLastNonCommentStatement(listNode *luau.ListNode) *luau.ListNode {
182
+ for listNode != nil && luau.IsComment(listNode.Value) {
183
+ listNode = listNode.Prev
184
+ }
185
+ return listNode
186
+ }
187
+
188
+ // TransformSourceFile is transformSourceFile. It creates and returns a list of Luau statements.
189
+ func TransformSourceFile(state *TransformState, node *ast.SourceFile) *luau.List {
190
+ symbol := state.Checker.GetSymbolAtLocation(node.AsNode())
191
+ if symbol == nil {
192
+ panic(shared.AssertionMessage(""))
193
+ }
194
+ state.SetModuleIDBySymbol(symbol, luau.Globals.Exports)
195
+
196
+ // transform the `ts.Statements` of the source file into a `list.list<...>`
197
+ statements := transformStatementList(state, node.AsNode(), node.Statements.Nodes, nil)
198
+
199
+ handleExports(state, node, symbol, statements)
200
+
201
+ // moduleScripts must `return nil` if they do not export any values
202
+ lastStatement := getLastNonCommentStatement(statements.Tail)
203
+ if lastStatement == nil || !luau.IsReturnStatement(lastStatement.Value) {
204
+ outputPath := state.PathTranslator.GetOutputPath(nodepath.Native.Normalize(node.FileName().AsString()))
205
+ if state.RojoResolver().GetRbxTypeFromFilePath(outputPath) == rojoresolver.RbxTypeModuleScript {
206
+ statements.Push(luau.Create(&luau.ReturnStatement{Expression: luau.NewNil()}))
207
+ }
208
+ }
209
+
210
+ headerStatements := luau.NewList()
211
+
212
+ // add build information to the tree
213
+ headerStatements.Push(luau.NewComment(" Compiled with roblox-ts v" + shared.CompilerVersion))
214
+
215
+ // add the Runtime library to the tree if it is used
216
+ if state.UsesRuntimeLib {
217
+ headerStatements.Push(state.CreateRuntimeLibImport(node))
218
+ }
219
+
220
+ // extract Luau directive comments like --!strict so we can put them before headerStatements
221
+ directiveComments := luau.NewList()
222
+ for statements.Head != nil && luau.IsComment(statements.Head.Value) && strings.HasPrefix(statements.Head.Value.(*luau.Comment).Text, "!") {
223
+ directiveComments.Push(statements.Shift())
224
+ }
225
+
226
+ statements.UnshiftList(headerStatements)
227
+ statements.UnshiftList(directiveComments)
228
+
229
+ return statements
230
+ }
@@ -0,0 +1,35 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/expressions/transformSpreadElement.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 transformSpreadElement(state *TransformState, node *ast.Node) luau.Expression {
12
+ validateNotAnyType(state, node.Expression())
13
+
14
+ // array literal is caught and handled separately in transformArrayLiteralExpression.ts
15
+ if ast.IsArrayLiteralExpression(node.Parent) || node.Parent.ArgumentList() == nil {
16
+ panic(shared.AssertionMessage(""))
17
+ }
18
+ arguments := node.Parent.Arguments()
19
+ if arguments[len(arguments)-1] != node {
20
+ state.Diagnostic.AddDiagnostic(shared.Errors.NoPrecedingSpreadElement.At(shared.AtNode(node)))
21
+ }
22
+
23
+ expression := transformExpression(state, node.Expression())
24
+
25
+ t := state.GetType(node.Expression())
26
+ if isDefinitelyType(t, isArrayType(state)) {
27
+ return luau.NewCall(luau.Globals.Unpack, expression)
28
+ } else {
29
+ addIterableToArrayBuilder := getAddIterableToArrayBuilder(state, node.Expression(), t)
30
+ arrayId := state.PushToVar(luau.NewArray(), "array")
31
+ lengthId := state.PushToVar(luau.NewNumber(0), "length")
32
+ state.PrereqList(addIterableToArrayBuilder(state, expression, arrayId, lengthId, 0, false))
33
+ return luau.NewCall(luau.Globals.Unpack, arrayId)
34
+ }
35
+ }
@@ -0,0 +1,84 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/statements/transformStatement.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 diagnosticStatement(state *TransformState, factory *shared.DiagnosticFactory, node *ast.Node) *luau.List {
12
+ state.Diagnostic.AddDiagnostic(factory.At(shared.AtNode(node)))
13
+ return luau.NewList()
14
+ }
15
+
16
+ // transformStatement transforms a singular ts.Statement in a luau.list<...>. TRANSFORMER_BY_KIND is this switch: as a
17
+ // package-level table it would be an initialization cycle.
18
+ func transformStatement(state *TransformState, node *ast.Node) *luau.List {
19
+ // if any modifiers of the node include the `declare` keyword we do not transform
20
+ // `declare` tells us that the identifier of the node is defined somewhere else and we should trust it
21
+ if ast.CanHaveModifiers(node) && hasDeclareModifier(node) {
22
+ return luau.NewList()
23
+ }
24
+ switch node.Kind {
25
+ // no emit
26
+ case ast.KindInterfaceDeclaration, ast.KindTypeAliasDeclaration, ast.KindEmptyStatement:
27
+ return luau.NewList()
28
+
29
+ // banned statements
30
+ case ast.KindForInStatement:
31
+ return diagnosticStatement(state, shared.Errors.NoForInStatement, node)
32
+ case ast.KindLabeledStatement:
33
+ return diagnosticStatement(state, shared.Errors.NoLabeledStatement, node)
34
+ case ast.KindDebuggerStatement:
35
+ return diagnosticStatement(state, shared.Errors.NoDebuggerStatement, node)
36
+
37
+ // regular transforms
38
+ case ast.KindBlock:
39
+ return transformBlock(state, node)
40
+ case ast.KindBreakStatement:
41
+ return transformBreakStatement(state, node)
42
+ case ast.KindClassDeclaration:
43
+ return transformClassDeclaration(state, node)
44
+ case ast.KindContinueStatement:
45
+ return transformContinueStatement(state, node)
46
+ case ast.KindDoStatement:
47
+ return transformDoStatement(state, node)
48
+ case ast.KindEnumDeclaration:
49
+ return transformEnumDeclaration(state, node)
50
+ case ast.KindExportAssignment:
51
+ return transformExportAssignment(state, node)
52
+ case ast.KindExportDeclaration:
53
+ return transformExportDeclaration(state, node)
54
+ case ast.KindExpressionStatement:
55
+ return transformExpressionStatement(state, node)
56
+ case ast.KindForOfStatement:
57
+ return transformForOfStatement(state, node)
58
+ case ast.KindForStatement:
59
+ return transformForStatement(state, node)
60
+ case ast.KindFunctionDeclaration:
61
+ return transformFunctionDeclaration(state, node)
62
+ case ast.KindIfStatement:
63
+ return transformIfStatement(state, node)
64
+ case ast.KindImportDeclaration:
65
+ return transformImportDeclaration(state, node)
66
+ case ast.KindImportEqualsDeclaration:
67
+ return transformImportEqualsDeclaration(state, node)
68
+ case ast.KindModuleDeclaration:
69
+ return transformModuleDeclaration(state, node)
70
+ case ast.KindReturnStatement:
71
+ return transformReturnStatement(state, node)
72
+ case ast.KindSwitchStatement:
73
+ return transformSwitchStatement(state, node)
74
+ case ast.KindThrowStatement:
75
+ return transformThrowStatement(state, node)
76
+ case ast.KindTryStatement:
77
+ return transformTryStatement(state, node)
78
+ case ast.KindVariableStatement:
79
+ return transformVariableStatement(state, node)
80
+ case ast.KindWhileStatement:
81
+ return transformWhileStatement(state, node)
82
+ }
83
+ panic(shared.AssertionMessage("Unknown statement: " + getKindName(node.Kind)))
84
+ }
@@ -0,0 +1,90 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/transformStatementList.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/internal/ls/lsutil"
8
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
9
+ )
10
+
11
+ func getLastToken(state *TransformState, parent *ast.Node, statements []*ast.Node) *ast.Node {
12
+ if len(statements) > 0 {
13
+ lastStatement := statements[len(statements)-1]
14
+ lastToken := lsutil.GetLastToken(lastStatement.Parent, state.SourceFile)
15
+ if lastToken != nil && !ast.IsNodeDescendantOf(lastToken, lastStatement) {
16
+ return lastToken
17
+ }
18
+ } else if parent != nil {
19
+ // if statements is empty, there still might be an `EOF` or `}` token to look for
20
+ return lsutil.GetLastToken(parent, state.SourceFile)
21
+ }
22
+ return nil
23
+ }
24
+
25
+ // statementListExportInfo is the exportInfo argument of transformStatementList: information about exporting.
26
+ type statementListExportInfo struct {
27
+ id luau.AnyIdentifier
28
+ mapping map[*ast.Node][]string
29
+ }
30
+
31
+ // transformStatementList converts a ts.Statement array into a list of Luau statements. exportInfo can be nil.
32
+ func transformStatementList(state *TransformState, parent *ast.Node, statements []*ast.Node, exportInfo *statementListExportInfo) *luau.List {
33
+ // make a new Luau tree
34
+ result := luau.NewList()
35
+
36
+ removeComments := state.Options.RemoveComments.IsTrue()
37
+
38
+ // With fixEmit, the order to compile them in. getLastToken below still wants them as written.
39
+ ordered := statements
40
+ if state.Data.ProjectOptions.FixEmit {
41
+ ordered = hoistFunctionsPastFinalStatement(state, statements)
42
+ }
43
+
44
+ // iterate through each statement in the `statements` array
45
+ for _, statement := range ordered {
46
+ // capture prerequisite statements for the `ts.Statement`
47
+ // transform the statement into a luau.List<...>
48
+ transformedStatements, prereqStatements := Capture(state, func() *luau.List { return transformStatement(state, statement) })
49
+
50
+ // iterate through each of the leading comments of the statement
51
+ if !removeComments {
52
+ result.PushList(state.GetLeadingComments(statement))
53
+ }
54
+
55
+ // check statement for hoisting
56
+ // hoisting is the use of a variable before it was declared
57
+ if hoistDeclaration := createHoistDeclaration(state, statement); hoistDeclaration != nil {
58
+ result.Push(hoistDeclaration)
59
+ }
60
+
61
+ result.PushList(prereqStatements)
62
+ result.PushList(transformedStatements)
63
+
64
+ if transformedStatements.Tail != nil && luau.IsFinalStatement(transformedStatements.Tail.Value) {
65
+ break
66
+ }
67
+
68
+ // namespace export handling
69
+ if exportInfo != nil {
70
+ containerID := exportInfo.id
71
+ if exportMapping, ok := exportInfo.mapping[statement]; ok {
72
+ for _, exportName := range exportMapping {
73
+ result.Push(luau.Create(&luau.Assignment{
74
+ Left: luau.NewProperty(containerID, exportName),
75
+ Operator: luau.AssignEqual,
76
+ Right: luau.NewID(exportName),
77
+ }))
78
+ }
79
+ }
80
+ }
81
+ }
82
+
83
+ if !removeComments {
84
+ if lastToken := getLastToken(state, parent, statements); lastToken != nil {
85
+ result.PushList(state.GetLeadingComments(lastToken))
86
+ }
87
+ }
88
+
89
+ return result
90
+ }
@@ -0,0 +1,22 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/expressions/transformStringLiteral.ts.
4
+
5
+ import (
6
+ "strings"
7
+
8
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
9
+ "github.com/microsoft/TypeScript/tsc/internal/scanner"
10
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
11
+ )
12
+
13
+ func transformStringLiteral(state *TransformState, node *ast.Node) luau.Expression {
14
+ result := luau.NewString(createStringFromLiteral(state, node))
15
+ // Text with both quote characters renders as [[...]], where its escapes mean nothing to Luau. It came from a string
16
+ // with one of them as its delimiter, escaped inside, so that delimiter works. Upstream's master (#3033) keeps the
17
+ // source's quote on every string. This keeps it only where the output was wrong.
18
+ if state.Data.ProjectOptions.FixEmit && strings.IndexByte(result.Value, '"') >= 0 && strings.IndexByte(result.Value, '\'') >= 0 {
19
+ result.Quote = scanner.GetSourceTextOfNodeFromSourceFile(ast.GetSourceFileOfNode(node), node, false)[0]
20
+ }
21
+ return result
22
+ }
@@ -0,0 +1,9 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/expressions/transformSuperKeyword.ts.
4
+
5
+ import "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
6
+
7
+ func transformSuperKeyword() luau.Expression {
8
+ return luau.Globals.Super
9
+ }
@@ -0,0 +1,145 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/statements/transformSwitchStatement.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ )
9
+
10
+ type transformCaseClauseExpressionResult struct {
11
+ condition luau.Expression
12
+ prereqStatements *luau.List
13
+ }
14
+
15
+ func transformCaseClauseExpression(state *TransformState, caseClauseExpression *ast.Node, switchExpression luau.Expression, fallThroughFlagID *luau.TemporaryIdentifier, canFallThroughTo bool) transformCaseClauseExpressionResult {
16
+ expression, prereqStatements := Capture(state, func() luau.Expression { return transformExpression(state, caseClauseExpression) })
17
+
18
+ expression = luau.Create(&luau.ParenthesizedExpression{Expression: expression})
19
+
20
+ var condition luau.Expression = luau.NewBinary(switchExpression, luau.BinaryEqual, expression)
21
+
22
+ if canFallThroughTo {
23
+ if !prereqStatements.IsEmpty() {
24
+ noFallThroughCondition := luau.NewUnary(luau.UnaryNot, fallThroughFlagID)
25
+
26
+ prereqStatements.Push(luau.Create(&luau.Assignment{
27
+ Left: fallThroughFlagID,
28
+ Operator: luau.AssignEqual,
29
+ Right: condition,
30
+ }))
31
+
32
+ prereqStatements = luau.MakeList(luau.Create(&luau.IfStatement{
33
+ Condition: noFallThroughCondition,
34
+ Statements: prereqStatements,
35
+ ElseBody: luau.NewList(),
36
+ }))
37
+
38
+ condition = fallThroughFlagID
39
+ } else {
40
+ condition = luau.NewBinary(fallThroughFlagID, luau.BinaryOr, condition)
41
+ }
42
+ }
43
+
44
+ return transformCaseClauseExpressionResult{
45
+ condition: condition,
46
+ prereqStatements: prereqStatements,
47
+ }
48
+ }
49
+
50
+ type transformCaseClauseResult struct {
51
+ canFallThroughFrom bool
52
+ prereqs *luau.List
53
+ clauseStatements *luau.List
54
+ }
55
+
56
+ func transformCaseClause(state *TransformState, node *ast.Node, switchExpression luau.Expression, fallThroughFlagID *luau.TemporaryIdentifier, canFallThroughTo bool, shouldUpdateFallThroughFlag bool) transformCaseClauseResult {
57
+ clause := node.AsCaseOrDefaultClause()
58
+ caseClauseExpression := transformCaseClauseExpression(state, clause.Expression, switchExpression, fallThroughFlagID, canFallThroughTo)
59
+ condition, prereqStatements := caseClauseExpression.condition, caseClauseExpression.prereqStatements
60
+
61
+ var nonEmptyStatements []*ast.Node
62
+ for _, v := range clause.Statements.Nodes {
63
+ if !ast.IsEmptyStatement(v) {
64
+ nonEmptyStatements = append(nonEmptyStatements, v)
65
+ }
66
+ }
67
+ var statements *luau.List
68
+ if len(nonEmptyStatements) == 1 && ast.IsBlock(nonEmptyStatements[0]) {
69
+ firstStatement := nonEmptyStatements[0]
70
+ statements = transformStatementList(state, firstStatement, firstStatement.AsBlock().Statements.Nodes, nil)
71
+ } else {
72
+ statements = transformStatementList(state, node, clause.Statements.Nodes, nil)
73
+ }
74
+
75
+ canFallThroughFrom := statements.Tail == nil || !luau.IsFinalStatement(statements.Tail.Value)
76
+ if canFallThroughFrom && shouldUpdateFallThroughFlag {
77
+ statements.Push(luau.Create(&luau.Assignment{
78
+ Left: fallThroughFlagID,
79
+ Operator: luau.AssignEqual,
80
+ Right: luau.NewBool(true),
81
+ }))
82
+ }
83
+
84
+ clauseStatements := luau.NewList()
85
+
86
+ if hoistDeclaration := createHoistDeclaration(state, node); hoistDeclaration != nil {
87
+ clauseStatements.Push(hoistDeclaration)
88
+ }
89
+
90
+ clauseStatements.Push(luau.Create(&luau.IfStatement{
91
+ Condition: condition,
92
+ Statements: statements,
93
+ ElseBody: luau.NewList(),
94
+ }))
95
+
96
+ return transformCaseClauseResult{
97
+ canFallThroughFrom: canFallThroughFrom,
98
+ prereqs: prereqStatements,
99
+ clauseStatements: clauseStatements,
100
+ }
101
+ }
102
+
103
+ func transformSwitchStatement(state *TransformState, node *ast.Node) *luau.List {
104
+ switchStatement := node.AsSwitchStatement()
105
+ expression := state.PushToVarIfComplex(transformExpression(state, switchStatement.Expression), "exp")
106
+ fallThroughFlagID := luau.NewTempID("fallthrough")
107
+
108
+ isFallThroughFlagNeeded := false
109
+
110
+ statements := luau.NewList()
111
+ canFallThroughTo := false
112
+ clauses := switchStatement.CaseBlock.AsCaseBlock().Clauses.Nodes
113
+ for i := 0; i < len(clauses); i++ {
114
+ caseClauseNode := clauses[i]
115
+
116
+ if ast.IsCaseClause(caseClauseNode) {
117
+ shouldUpdateFallThroughFlag := i < len(clauses)-1 && ast.IsCaseClause(clauses[i+1])
118
+ clause := transformCaseClause(state, caseClauseNode, expression, fallThroughFlagID, canFallThroughTo, shouldUpdateFallThroughFlag)
119
+
120
+ statements.PushList(clause.prereqs)
121
+ statements.PushList(clause.clauseStatements)
122
+
123
+ canFallThroughTo = clause.canFallThroughFrom
124
+
125
+ if clause.canFallThroughFrom {
126
+ isFallThroughFlagNeeded = true
127
+ }
128
+ } else {
129
+ statements.PushList(transformStatementList(state, caseClauseNode, caseClauseNode.AsCaseOrDefaultClause().Statements.Nodes, nil))
130
+ break
131
+ }
132
+ }
133
+
134
+ if isFallThroughFlagNeeded {
135
+ statements.Unshift(luau.Create(&luau.VariableDeclaration{
136
+ Left: fallThroughFlagID,
137
+ Right: luau.NewBool(false),
138
+ }))
139
+ }
140
+
141
+ return wrapSwitchForContinue(state, node, luau.Create(&luau.RepeatStatement{
142
+ Condition: luau.NewBool(true),
143
+ Statements: statements,
144
+ }))
145
+ }
@@ -0,0 +1,34 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/expressions/transformTaggedTemplateExpression.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ )
9
+
10
+ func transformTaggedTemplateExpression(state *TransformState, node *ast.Node) luau.Expression {
11
+ taggedTemplate := node.AsTaggedTemplateExpression()
12
+ tagExp := transformExpression(state, taggedTemplate.Tag)
13
+
14
+ if ast.IsTemplateExpression(taggedTemplate.Template) {
15
+ template := taggedTemplate.Template.AsTemplateExpression()
16
+ templateSpans := template.TemplateSpans.Nodes
17
+
18
+ strings := []luau.Expression{}
19
+ strings = append(strings, luau.NewString(template.Head.Text()))
20
+ for _, templateSpan := range templateSpans {
21
+ strings = append(strings, luau.NewString(templateSpan.AsTemplateSpan().Literal.Text()))
22
+ }
23
+
24
+ spanExpressions := make([]*ast.Node, len(templateSpans))
25
+ for i, templateSpan := range templateSpans {
26
+ spanExpressions[i] = templateSpan.Expression()
27
+ }
28
+ expressions := ensureTransformOrder(state, spanExpressions, nil)
29
+
30
+ return luau.NewCall(convertToIndexableExpression(tagExp), append([]luau.Expression{luau.NewArray(strings...)}, expressions...)...)
31
+ } else {
32
+ return luau.NewCall(convertToIndexableExpression(tagExp), luau.NewArray(luau.NewString(taggedTemplate.Template.Text())))
33
+ }
34
+ }
@@ -0,0 +1,35 @@
1
+ package transformer
2
+
3
+ // Port of src/TSTransformer/nodes/expressions/transformTemplateExpression.ts.
4
+
5
+ import (
6
+ "github.com/microsoft/TypeScript/tsc/internal/ast"
7
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/luau"
8
+ )
9
+
10
+ func transformTemplateExpression(state *TransformState, node *ast.Node) luau.Expression {
11
+ template := node.AsTemplateExpression()
12
+ templateSpans := template.TemplateSpans.Nodes
13
+ parts := luau.NewList()
14
+
15
+ if template.Head.Text() != "" {
16
+ parts.Push(transformInterpolatedStringPart(state, template.Head))
17
+ }
18
+
19
+ spanExpressions := make([]*ast.Node, len(templateSpans))
20
+ for i, templateSpan := range templateSpans {
21
+ spanExpressions[i] = templateSpan.Expression()
22
+ }
23
+ orderedExpressions := ensureTransformOrder(state, spanExpressions, nil)
24
+
25
+ for i := range templateSpans {
26
+ parts.Push(orderedExpressions[i])
27
+
28
+ templateSpan := templateSpans[i].AsTemplateSpan()
29
+ if templateSpan.Literal.Text() != "" {
30
+ parts.Push(transformInterpolatedStringPart(state, templateSpan.Literal))
31
+ }
32
+ }
33
+
34
+ return luau.Create(&luau.InterpolatedString{Parts: parts})
35
+ }