@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
package/luau/nodes.go ADDED
@@ -0,0 +1,479 @@
1
+ package luau
2
+
3
+ // Ported from src/LuauAST/types/nodes.ts and src/LuauAST/types/mapping.ts.
4
+ //
5
+ // Every node is a pointer to a concrete struct. Struct literals are always
6
+ // well formed because Kind() is a method of the concrete type, not a stored
7
+ // field. Use Create to build a node so that its children get their parent
8
+ // pointers (see create.go).
9
+ //
10
+ // Upstream unions are represented like this:
11
+ //
12
+ // - A field that is "node or list of nodes" (Assignment.Left/Right,
13
+ // VariableDeclaration.Left/Right, ReturnStatement.Expression,
14
+ // IfStatement.ElseBody) has type NodeOrList. Both *List and every node
15
+ // implement it; use AsList or a type switch to tell them apart. A nil
16
+ // NodeOrList is upstream's undefined.
17
+ // - A list that holds a mix of kinds (InterpolatedString.Parts,
18
+ // MixedTable.Fields) is an ordinary *List.
19
+ // - Optional node fields (NumericForStatement.Step) are nil when absent.
20
+ //
21
+ // Lists are untyped (*List of Node). The element types upstream documents are
22
+ // noted on each field.
23
+
24
+ // NodeOrList is implemented by every node and by *List.
25
+ type NodeOrList interface {
26
+ isNodeOrList()
27
+ }
28
+
29
+ // Node is any Luau AST node.
30
+ type Node interface {
31
+ NodeOrList
32
+ Kind() SyntaxKind
33
+ // Parent returns the node's parent, or nil.
34
+ Parent() Node
35
+ SetParent(Node)
36
+
37
+ // shallowClone returns a struct copy: same parent, same children, same
38
+ // lists. Upstream `{ ...node }`.
39
+ shallowClone() Node
40
+ // adopt gives each child field this node as its parent, cloning children
41
+ // that already have one. Used by Create.
42
+ adopt()
43
+ }
44
+
45
+ // Expression is any node in the upstream Expression category (kinds
46
+ // KindIdentifier through KindMixedTable, which includes None).
47
+ type Expression interface {
48
+ Node
49
+ isExpression()
50
+ }
51
+
52
+ // IndexableExpression is Identifier, TemporaryIdentifier,
53
+ // ComputedIndexExpression, PropertyAccessExpression, CallExpression,
54
+ // MethodCallExpression or ParenthesizedExpression.
55
+ type IndexableExpression interface {
56
+ Expression
57
+ isIndexableExpression()
58
+ }
59
+
60
+ // AnyIdentifier is *Identifier or *TemporaryIdentifier.
61
+ type AnyIdentifier interface {
62
+ IndexableExpression
63
+ isAnyIdentifier()
64
+ }
65
+
66
+ // WritableExpression is an AnyIdentifier, *PropertyAccessExpression or
67
+ // *ComputedIndexExpression.
68
+ type WritableExpression interface {
69
+ IndexableExpression
70
+ isWritableExpression()
71
+ }
72
+
73
+ // CallLike is *CallExpression or *MethodCallExpression.
74
+ type CallLike interface {
75
+ IndexableExpression
76
+ isCallLike()
77
+ // Callee returns the `expression` field of either call kind.
78
+ Callee() IndexableExpression
79
+ }
80
+
81
+ // Statement is any node in the upstream Statement category.
82
+ type Statement interface {
83
+ Node
84
+ isStatement()
85
+ }
86
+
87
+ // Field is a MapField or InterpolatedStringPart.
88
+ type Field interface {
89
+ Node
90
+ isField()
91
+ }
92
+
93
+ // HasStatements is implemented by the nodes that own a statement list
94
+ // (upstream guard hasStatements).
95
+ type HasStatements interface {
96
+ Node
97
+ GetStatements() *List
98
+ }
99
+
100
+ // HasParameters is implemented by the function-like nodes.
101
+ type HasParameters interface {
102
+ Node
103
+ GetParameters() *List
104
+ GetHasDotDotDot() bool
105
+ }
106
+
107
+ // BaseNode holds the state shared by all nodes.
108
+ type BaseNode struct {
109
+ parent Node
110
+ }
111
+
112
+ func (b *BaseNode) Parent() Node { return b.parent }
113
+ func (b *BaseNode) SetParent(p Node) { b.parent = p }
114
+ func (b *BaseNode) isNodeOrList() {}
115
+
116
+ // ---------------------------------------------------------------------------
117
+ // Expressions
118
+
119
+ type None struct{ BaseNode }
120
+
121
+ type NilLiteral struct{ BaseNode }
122
+
123
+ type FalseLiteral struct{ BaseNode }
124
+
125
+ type TrueLiteral struct{ BaseNode }
126
+
127
+ type NumberLiteral struct {
128
+ BaseNode
129
+ Value string
130
+ }
131
+
132
+ type StringLiteral struct {
133
+ BaseNode
134
+ Value string
135
+ // Quote, if not 0, is the delimiter to render, for a value that already has what it needs escaped. rbxtsgo's own, for
136
+ // --fix-emit.
137
+ Quote byte
138
+ }
139
+
140
+ type VarArgsLiteral struct{ BaseNode }
141
+
142
+ type FunctionExpression struct {
143
+ BaseNode
144
+ Parameters *List // of AnyIdentifier
145
+ HasDotDotDot bool
146
+ Statements *List // of Statement
147
+ }
148
+
149
+ type Identifier struct {
150
+ BaseNode
151
+ Name string
152
+ }
153
+
154
+ type TemporaryIdentifier struct {
155
+ BaseNode
156
+ Name string
157
+ ID int
158
+ }
159
+
160
+ type ComputedIndexExpression struct {
161
+ BaseNode
162
+ Expression IndexableExpression
163
+ Index Expression
164
+ }
165
+
166
+ type PropertyAccessExpression struct {
167
+ BaseNode
168
+ Expression IndexableExpression
169
+ Name string
170
+ }
171
+
172
+ type CallExpression struct {
173
+ BaseNode
174
+ Expression IndexableExpression
175
+ Args *List // of Expression
176
+ }
177
+
178
+ type MethodCallExpression struct {
179
+ BaseNode
180
+ Name string
181
+ Expression IndexableExpression
182
+ Args *List // of Expression
183
+ }
184
+
185
+ type ParenthesizedExpression struct {
186
+ BaseNode
187
+ Expression Expression
188
+ }
189
+
190
+ type BinaryExpression struct {
191
+ BaseNode
192
+ Left Expression
193
+ Operator BinaryOperator
194
+ Right Expression
195
+ }
196
+
197
+ type UnaryExpression struct {
198
+ BaseNode
199
+ Operator UnaryOperator
200
+ Expression Expression
201
+ }
202
+
203
+ type IfExpression struct {
204
+ BaseNode
205
+ Condition Expression
206
+ Expression Expression
207
+ Alternative Expression
208
+ }
209
+
210
+ type InterpolatedString struct {
211
+ BaseNode
212
+ Parts *List // of *InterpolatedStringPart or Expression
213
+ }
214
+
215
+ type Array struct {
216
+ BaseNode
217
+ Members *List // of Expression
218
+ }
219
+
220
+ type Map struct {
221
+ BaseNode
222
+ Fields *List // of *MapField
223
+ }
224
+
225
+ type Set struct {
226
+ BaseNode
227
+ Members *List // of Expression
228
+ }
229
+
230
+ type MixedTable struct {
231
+ BaseNode
232
+ Fields *List // of *MapField or Expression
233
+ }
234
+
235
+ // ---------------------------------------------------------------------------
236
+ // Statements
237
+
238
+ type Assignment struct {
239
+ BaseNode
240
+ Left NodeOrList // WritableExpression or *List of WritableExpression
241
+ Operator AssignmentOperator
242
+ Right NodeOrList // Expression or *List of Expression
243
+ }
244
+
245
+ type BreakStatement struct{ BaseNode }
246
+
247
+ type CallStatement struct {
248
+ BaseNode
249
+ Expression CallLike
250
+ }
251
+
252
+ type ContinueStatement struct{ BaseNode }
253
+
254
+ type DoStatement struct {
255
+ BaseNode
256
+ Statements *List // of Statement
257
+ }
258
+
259
+ type WhileStatement struct {
260
+ BaseNode
261
+ Condition Expression
262
+ Statements *List // of Statement
263
+ }
264
+
265
+ type RepeatStatement struct {
266
+ BaseNode
267
+ Condition Expression
268
+ Statements *List // of Statement
269
+ }
270
+
271
+ type IfStatement struct {
272
+ BaseNode
273
+ Condition Expression
274
+ Statements *List // of Statement
275
+ ElseBody NodeOrList // *IfStatement or *List of Statement
276
+ }
277
+
278
+ type NumericForStatement struct {
279
+ BaseNode
280
+ ID AnyIdentifier
281
+ Start Expression
282
+ End Expression
283
+ Step Expression // optional
284
+ Statements *List // of Statement
285
+ }
286
+
287
+ type ForStatement struct {
288
+ BaseNode
289
+ IDs *List // of AnyIdentifier
290
+ Expression Expression
291
+ Statements *List // of Statement
292
+ }
293
+
294
+ type FunctionDeclaration struct {
295
+ BaseNode
296
+ Localize bool
297
+ Name WritableExpression // AnyIdentifier or *PropertyAccessExpression
298
+ Parameters *List // of AnyIdentifier
299
+ HasDotDotDot bool
300
+ Statements *List // of Statement
301
+ }
302
+
303
+ type MethodDeclaration struct {
304
+ BaseNode
305
+ Expression IndexableExpression
306
+ Name string
307
+ Parameters *List // of AnyIdentifier
308
+ HasDotDotDot bool
309
+ Statements *List // of Statement
310
+ }
311
+
312
+ type VariableDeclaration struct {
313
+ BaseNode
314
+ Left NodeOrList // AnyIdentifier or *List of AnyIdentifier
315
+ Right NodeOrList // Expression, *List of Expression, or nil
316
+ }
317
+
318
+ type ReturnStatement struct {
319
+ BaseNode
320
+ Expression NodeOrList // Expression or *List of Expression
321
+ }
322
+
323
+ type Comment struct {
324
+ BaseNode
325
+ Text string
326
+ }
327
+
328
+ // ---------------------------------------------------------------------------
329
+ // Fields
330
+
331
+ type MapField struct {
332
+ BaseNode
333
+ Index Expression
334
+ Value Expression
335
+ }
336
+
337
+ type InterpolatedStringPart struct {
338
+ BaseNode
339
+ Text string
340
+ }
341
+
342
+ // ---------------------------------------------------------------------------
343
+ // Kind() and category markers
344
+
345
+ func (*Identifier) Kind() SyntaxKind { return KindIdentifier }
346
+ func (*TemporaryIdentifier) Kind() SyntaxKind { return KindTemporaryIdentifier }
347
+ func (*ComputedIndexExpression) Kind() SyntaxKind { return KindComputedIndexExpression }
348
+ func (*PropertyAccessExpression) Kind() SyntaxKind { return KindPropertyAccessExpression }
349
+ func (*CallExpression) Kind() SyntaxKind { return KindCallExpression }
350
+ func (*MethodCallExpression) Kind() SyntaxKind { return KindMethodCallExpression }
351
+ func (*ParenthesizedExpression) Kind() SyntaxKind { return KindParenthesizedExpression }
352
+ func (*None) Kind() SyntaxKind { return KindNone }
353
+ func (*NilLiteral) Kind() SyntaxKind { return KindNilLiteral }
354
+ func (*FalseLiteral) Kind() SyntaxKind { return KindFalseLiteral }
355
+ func (*TrueLiteral) Kind() SyntaxKind { return KindTrueLiteral }
356
+ func (*NumberLiteral) Kind() SyntaxKind { return KindNumberLiteral }
357
+ func (*StringLiteral) Kind() SyntaxKind { return KindStringLiteral }
358
+ func (*VarArgsLiteral) Kind() SyntaxKind { return KindVarArgsLiteral }
359
+ func (*FunctionExpression) Kind() SyntaxKind { return KindFunctionExpression }
360
+ func (*BinaryExpression) Kind() SyntaxKind { return KindBinaryExpression }
361
+ func (*UnaryExpression) Kind() SyntaxKind { return KindUnaryExpression }
362
+ func (*IfExpression) Kind() SyntaxKind { return KindIfExpression }
363
+ func (*InterpolatedString) Kind() SyntaxKind { return KindInterpolatedString }
364
+ func (*Array) Kind() SyntaxKind { return KindArray }
365
+ func (*Map) Kind() SyntaxKind { return KindMap }
366
+ func (*Set) Kind() SyntaxKind { return KindSet }
367
+ func (*MixedTable) Kind() SyntaxKind { return KindMixedTable }
368
+ func (*Assignment) Kind() SyntaxKind { return KindAssignment }
369
+ func (*BreakStatement) Kind() SyntaxKind { return KindBreakStatement }
370
+ func (*CallStatement) Kind() SyntaxKind { return KindCallStatement }
371
+ func (*ContinueStatement) Kind() SyntaxKind { return KindContinueStatement }
372
+ func (*DoStatement) Kind() SyntaxKind { return KindDoStatement }
373
+ func (*WhileStatement) Kind() SyntaxKind { return KindWhileStatement }
374
+ func (*RepeatStatement) Kind() SyntaxKind { return KindRepeatStatement }
375
+ func (*IfStatement) Kind() SyntaxKind { return KindIfStatement }
376
+ func (*NumericForStatement) Kind() SyntaxKind { return KindNumericForStatement }
377
+ func (*ForStatement) Kind() SyntaxKind { return KindForStatement }
378
+ func (*FunctionDeclaration) Kind() SyntaxKind { return KindFunctionDeclaration }
379
+ func (*MethodDeclaration) Kind() SyntaxKind { return KindMethodDeclaration }
380
+ func (*VariableDeclaration) Kind() SyntaxKind { return KindVariableDeclaration }
381
+ func (*ReturnStatement) Kind() SyntaxKind { return KindReturnStatement }
382
+ func (*Comment) Kind() SyntaxKind { return KindComment }
383
+ func (*MapField) Kind() SyntaxKind { return KindMapField }
384
+ func (*InterpolatedStringPart) Kind() SyntaxKind { return KindInterpolatedStringPart }
385
+
386
+ // Expression
387
+ func (*Identifier) isExpression() {}
388
+ func (*TemporaryIdentifier) isExpression() {}
389
+ func (*ComputedIndexExpression) isExpression() {}
390
+ func (*PropertyAccessExpression) isExpression() {}
391
+ func (*CallExpression) isExpression() {}
392
+ func (*MethodCallExpression) isExpression() {}
393
+ func (*ParenthesizedExpression) isExpression() {}
394
+ func (*None) isExpression() {}
395
+ func (*NilLiteral) isExpression() {}
396
+ func (*FalseLiteral) isExpression() {}
397
+ func (*TrueLiteral) isExpression() {}
398
+ func (*NumberLiteral) isExpression() {}
399
+ func (*StringLiteral) isExpression() {}
400
+ func (*VarArgsLiteral) isExpression() {}
401
+ func (*FunctionExpression) isExpression() {}
402
+ func (*BinaryExpression) isExpression() {}
403
+ func (*UnaryExpression) isExpression() {}
404
+ func (*IfExpression) isExpression() {}
405
+ func (*InterpolatedString) isExpression() {}
406
+ func (*Array) isExpression() {}
407
+ func (*Map) isExpression() {}
408
+ func (*Set) isExpression() {}
409
+ func (*MixedTable) isExpression() {}
410
+
411
+ // IndexableExpression
412
+ func (*Identifier) isIndexableExpression() {}
413
+ func (*TemporaryIdentifier) isIndexableExpression() {}
414
+ func (*ComputedIndexExpression) isIndexableExpression() {}
415
+ func (*PropertyAccessExpression) isIndexableExpression() {}
416
+ func (*CallExpression) isIndexableExpression() {}
417
+ func (*MethodCallExpression) isIndexableExpression() {}
418
+ func (*ParenthesizedExpression) isIndexableExpression() {}
419
+
420
+ // AnyIdentifier
421
+ func (*Identifier) isAnyIdentifier() {}
422
+ func (*TemporaryIdentifier) isAnyIdentifier() {}
423
+
424
+ // WritableExpression
425
+ func (*Identifier) isWritableExpression() {}
426
+ func (*TemporaryIdentifier) isWritableExpression() {}
427
+ func (*PropertyAccessExpression) isWritableExpression() {}
428
+ func (*ComputedIndexExpression) isWritableExpression() {}
429
+
430
+ // CallLike
431
+ func (*CallExpression) isCallLike() {}
432
+ func (*MethodCallExpression) isCallLike() {}
433
+
434
+ func (n *CallExpression) Callee() IndexableExpression { return n.Expression }
435
+ func (n *MethodCallExpression) Callee() IndexableExpression { return n.Expression }
436
+
437
+ // Statement
438
+ func (*Assignment) isStatement() {}
439
+ func (*BreakStatement) isStatement() {}
440
+ func (*CallStatement) isStatement() {}
441
+ func (*ContinueStatement) isStatement() {}
442
+ func (*DoStatement) isStatement() {}
443
+ func (*WhileStatement) isStatement() {}
444
+ func (*RepeatStatement) isStatement() {}
445
+ func (*IfStatement) isStatement() {}
446
+ func (*NumericForStatement) isStatement() {}
447
+ func (*ForStatement) isStatement() {}
448
+ func (*FunctionDeclaration) isStatement() {}
449
+ func (*MethodDeclaration) isStatement() {}
450
+ func (*VariableDeclaration) isStatement() {}
451
+ func (*ReturnStatement) isStatement() {}
452
+ func (*Comment) isStatement() {}
453
+
454
+ // Field
455
+ func (*MapField) isField() {}
456
+ func (*InterpolatedStringPart) isField() {}
457
+
458
+ // HasStatements
459
+ func (n *ForStatement) GetStatements() *List { return n.Statements }
460
+ func (n *NumericForStatement) GetStatements() *List { return n.Statements }
461
+ func (n *FunctionExpression) GetStatements() *List { return n.Statements }
462
+ func (n *DoStatement) GetStatements() *List { return n.Statements }
463
+ func (n *FunctionDeclaration) GetStatements() *List { return n.Statements }
464
+ func (n *IfStatement) GetStatements() *List { return n.Statements }
465
+ func (n *MethodDeclaration) GetStatements() *List { return n.Statements }
466
+ func (n *RepeatStatement) GetStatements() *List { return n.Statements }
467
+ func (n *WhileStatement) GetStatements() *List { return n.Statements }
468
+
469
+ // HasParameters
470
+ func (n *FunctionExpression) GetParameters() *List { return n.Parameters }
471
+ func (n *FunctionDeclaration) GetParameters() *List { return n.Parameters }
472
+ func (n *MethodDeclaration) GetParameters() *List { return n.Parameters }
473
+ func (n *FunctionExpression) GetHasDotDotDot() bool { return n.HasDotDotDot }
474
+ func (n *FunctionDeclaration) GetHasDotDotDot() bool { return n.HasDotDotDot }
475
+ func (n *MethodDeclaration) GetHasDotDotDot() bool { return n.HasDotDotDot }
476
+
477
+ // ShallowClone returns a struct copy of node: same parent, same child nodes
478
+ // and same lists (upstream `{ ...node }`).
479
+ func ShallowClone(node Node) Node { return node.shallowClone() }
@@ -0,0 +1,46 @@
1
+ package luau
2
+
3
+ // Ported from src/LuauAST/types/operators.ts.
4
+
5
+ type BinaryOperator string
6
+
7
+ const (
8
+ BinaryAdd BinaryOperator = "+"
9
+ BinarySub BinaryOperator = "-"
10
+ BinaryMul BinaryOperator = "*"
11
+ BinaryDiv BinaryOperator = "/"
12
+ BinaryFloorDiv BinaryOperator = "//"
13
+ BinaryPow BinaryOperator = "^"
14
+ BinaryMod BinaryOperator = "%"
15
+ BinaryConcat BinaryOperator = ".."
16
+ BinaryLess BinaryOperator = "<"
17
+ BinaryLessEqual BinaryOperator = "<="
18
+ BinaryGreater BinaryOperator = ">"
19
+ BinaryGreaterEqual BinaryOperator = ">="
20
+ BinaryEqual BinaryOperator = "=="
21
+ BinaryNotEqual BinaryOperator = "~="
22
+ BinaryAnd BinaryOperator = "and"
23
+ BinaryOr BinaryOperator = "or"
24
+ )
25
+
26
+ type UnaryOperator string
27
+
28
+ const (
29
+ UnaryMinus UnaryOperator = "-"
30
+ UnaryNot UnaryOperator = "not"
31
+ UnaryLen UnaryOperator = "#"
32
+ )
33
+
34
+ type AssignmentOperator string
35
+
36
+ const (
37
+ AssignEqual AssignmentOperator = "="
38
+ AssignAdd AssignmentOperator = "+="
39
+ AssignSub AssignmentOperator = "-="
40
+ AssignMul AssignmentOperator = "*="
41
+ AssignDiv AssignmentOperator = "/="
42
+ AssignFloorDiv AssignmentOperator = "//="
43
+ AssignMod AssignmentOperator = "%="
44
+ AssignPow AssignmentOperator = "^="
45
+ AssignConcat AssignmentOperator = "..="
46
+ )
package/luau/render.go ADDED
@@ -0,0 +1,134 @@
1
+ package luau
2
+
3
+ // Ported from src/LuauRenderer/render.ts and the LuauRenderer public API
4
+ // (src/LuauRenderer/index.ts).
5
+
6
+ // renderNode appends the Luau for node to state's buffer. It is the Go
7
+ // counterpart of KIND_TO_RENDERER in upstream render().
8
+ func renderNode(state *RenderState, node Node) {
9
+ switch n := node.(type) {
10
+ // indexable expressions
11
+ case *Identifier:
12
+ renderIdentifier(state, n)
13
+ case *TemporaryIdentifier:
14
+ renderTemporaryIdentifier(state, n)
15
+ case *ComputedIndexExpression:
16
+ renderComputedIndexExpression(state, n)
17
+ case *PropertyAccessExpression:
18
+ renderPropertyAccessExpression(state, n)
19
+ case *CallExpression:
20
+ renderCallExpression(state, n)
21
+ case *MethodCallExpression:
22
+ renderMethodCallExpression(state, n)
23
+ case *ParenthesizedExpression:
24
+ renderParenthesizedExpression(state, n)
25
+
26
+ // expressions
27
+ case *None:
28
+ Assert(false, "Cannot render None")
29
+ case *NilLiteral:
30
+ state.writeString("nil")
31
+ case *FalseLiteral:
32
+ state.writeString("false")
33
+ case *TrueLiteral:
34
+ state.writeString("true")
35
+ case *NumberLiteral:
36
+ renderNumberLiteral(state, n)
37
+ case *StringLiteral:
38
+ renderStringLiteral(state, n)
39
+ case *VarArgsLiteral:
40
+ state.writeString("...")
41
+ case *FunctionExpression:
42
+ renderFunctionExpression(state, n)
43
+ case *BinaryExpression:
44
+ renderBinaryExpression(state, n)
45
+ case *UnaryExpression:
46
+ renderUnaryExpression(state, n)
47
+ case *IfExpression:
48
+ renderIfExpression(state, n)
49
+ case *InterpolatedString:
50
+ renderInterpolatedString(state, n)
51
+ case *Array:
52
+ renderArray(state, n)
53
+ case *Map:
54
+ renderMap(state, n)
55
+ case *Set:
56
+ renderSet(state, n)
57
+ case *MixedTable:
58
+ renderMixedTable(state, n)
59
+
60
+ // statements
61
+ case *Assignment:
62
+ renderAssignment(state, n)
63
+ case *BreakStatement:
64
+ renderBreakStatement(state)
65
+ case *CallStatement:
66
+ renderCallStatement(state, n)
67
+ case *ContinueStatement:
68
+ renderContinueStatement(state)
69
+ case *DoStatement:
70
+ renderDoStatement(state, n)
71
+ case *WhileStatement:
72
+ renderWhileStatement(state, n)
73
+ case *RepeatStatement:
74
+ renderRepeatStatement(state, n)
75
+ case *IfStatement:
76
+ renderIfStatement(state, n)
77
+ case *NumericForStatement:
78
+ renderNumericForStatement(state, n)
79
+ case *ForStatement:
80
+ renderForStatement(state, n)
81
+ case *FunctionDeclaration:
82
+ renderFunctionDeclaration(state, n)
83
+ case *MethodDeclaration:
84
+ renderMethodDeclaration(state, n)
85
+ case *VariableDeclaration:
86
+ renderVariableDeclaration(state, n)
87
+ case *ReturnStatement:
88
+ renderReturnStatement(state, n)
89
+ case *Comment:
90
+ renderComment(state, n)
91
+
92
+ // fields
93
+ case *MapField:
94
+ renderMapField(state, n)
95
+ case *InterpolatedStringPart:
96
+ renderInterpolatedStringPart(state, n)
97
+
98
+ default:
99
+ // Upstream would throw "KIND_TO_RENDERER[node.kind] is not a function".
100
+ Assert(false, "Cannot render a nil or unknown node")
101
+ }
102
+ }
103
+
104
+ // Render returns a string that represents the given syntax node as Luau
105
+ // code. Recursively called until the node is completely rendered.
106
+ func Render(state *RenderState, node Node) string {
107
+ start := len(state.buf)
108
+ renderNode(state, node)
109
+ result := string(state.buf[start:])
110
+ state.buf = state.buf[:start]
111
+ return result
112
+ }
113
+
114
+ // RenderStatements renders the given list of statements. SolveTempIDs should
115
+ // have been run on the list first.
116
+ func RenderStatements(state *RenderState, statements *List) string {
117
+ start := len(state.buf)
118
+ renderStatementsTo(state, statements)
119
+ result := string(state.buf[start:])
120
+ state.buf = state.buf[:start]
121
+ return result
122
+ }
123
+
124
+ // RenderAST returns a string that represents the given syntax tree as Luau
125
+ // code.
126
+ func RenderAST(ast *List) string {
127
+ state := NewRenderState()
128
+ state.buf = make([]byte, 0, 4096)
129
+
130
+ SolveTempIDs(state, ast)
131
+
132
+ renderStatementsTo(state, ast)
133
+ return string(state.buf)
134
+ }