@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.
- package/LICENSE +21 -0
- package/README.md +181 -2
- package/README.rbxtsgo.md +169 -0
- package/THIRD_PARTY_NOTICES.md +745 -0
- package/cli/cli.go +454 -0
- package/compile/compile.go +388 -0
- package/compile/declarations.go +221 -0
- package/compile/incremental.go +349 -0
- package/compile/times.go +9 -0
- package/docs/plugin-api.md +243 -0
- package/go.mod +20 -0
- package/go.sum +24 -0
- package/internal/difftest/difftest.go +530 -0
- package/internal/plugintest/plugintest.go +181 -0
- package/luau/create.go +351 -0
- package/luau/doc.go +71 -0
- package/luau/globals.go +178 -0
- package/luau/jsnum.go +188 -0
- package/luau/kinds.go +128 -0
- package/luau/list.go +227 -0
- package/luau/nodes.go +479 -0
- package/luau/operators.go +46 -0
- package/luau/render.go +134 -0
- package/luau/render_expressions.go +264 -0
- package/luau/render_fields.go +81 -0
- package/luau/render_indexable.go +81 -0
- package/luau/render_state.go +134 -0
- package/luau/render_statements.go +235 -0
- package/luau/render_util.go +296 -0
- package/luau/solve_temp_ids.go +212 -0
- package/luau/typeguards.go +175 -0
- package/luau/util.go +184 -0
- package/luau/visit.go +138 -0
- package/npm/index.d.ts +3 -0
- package/npm/rbxts-go.sh +187 -0
- package/package.json +45 -5
- package/patches/typescript/0001-checker-exports.patch +40 -0
- package/patches/typescript/0002-iterable-arity.patch +15 -0
- package/patches/typescript/0003-context-sensitive-this.patch +15 -0
- package/patches/typescript/0004-printer-keep-parse-tree-parentheses.patch +26 -0
- package/pluginapi/host.go +31 -0
- package/pluginapi/pluginapi.go +153 -0
- package/plugins/LICENSE-rbxts-transformer-setget +18 -0
- package/plugins/apply.go +342 -0
- package/plugins/config.go +431 -0
- package/plugins/fallback.go +84 -0
- package/plugins/fixemit.go +60 -0
- package/plugins/native.go +271 -0
- package/plugins/session.go +236 -0
- package/plugins/setget.go +478 -0
- package/project/copy.go +333 -0
- package/project/include/Promise.lua +2068 -0
- package/project/include/RuntimeLib.lua +260 -0
- package/project/nodepath/nodepath.go +917 -0
- package/project/pathtranslator/pathtranslator.go +214 -0
- package/project/project.go +498 -0
- package/project/rojoresolver/json.go +248 -0
- package/project/rojoresolver/rojoresolver.go +559 -0
- package/project/shared/constants.go +83 -0
- package/project/shared/diagnostic.go +238 -0
- package/project/shared/diagnostics.go +388 -0
- package/project/shared/elapsed.go +14 -0
- package/project/shared/eol_other.go +6 -0
- package/project/shared/eol_windows.go +4 -0
- package/project/shared/kleur.go +40 -0
- package/project/shared/util.go +183 -0
- package/scripts/build-with-plugins.sh +130 -0
- package/scripts/setup-third-party.sh +75 -0
- package/transformer/add_index_diagnostics.go +21 -0
- package/transformer/add_one_if_array_type.go +15 -0
- package/transformer/array_binding_pattern_contains_hoists.go +25 -0
- package/transformer/assert_never.go +24 -0
- package/transformer/assignment.go +64 -0
- package/transformer/call_macros.go +70 -0
- package/transformer/check_variable_hoist.go +125 -0
- package/transformer/clean_module_name.go +28 -0
- package/transformer/constructor_macros.go +122 -0
- package/transformer/convert_to_indexable_expression.go +12 -0
- package/transformer/create_binary_from_operator.go +86 -0
- package/transformer/create_continue_statements.go +68 -0
- package/transformer/create_get_service.go +15 -0
- package/transformer/create_hoist_declaration.go +27 -0
- package/transformer/create_import_expression.go +220 -0
- package/transformer/create_string_from_literal.go +195 -0
- package/transformer/create_truthiness_checks.go +63 -0
- package/transformer/create_type_check.go +9 -0
- package/transformer/ensure_transform_order.go +53 -0
- package/transformer/expression_chain.go +27 -0
- package/transformer/expression_might_mutate.go +60 -0
- package/transformer/find_constructor.go +15 -0
- package/transformer/fixup_whitespace_and_decode_entities.go +377 -0
- package/transformer/get_accessor_for_binding_type.go +160 -0
- package/transformer/get_add_iterable_to_array_builder.go +363 -0
- package/transformer/get_assignable_value.go +15 -0
- package/transformer/get_constant_value_literal.go +20 -0
- package/transformer/get_declared_variables.go +34 -0
- package/transformer/get_extends_node.go +23 -0
- package/transformer/get_flags.go +21 -0
- package/transformer/get_kind_name.go +18 -0
- package/transformer/get_original_symbol_of_node.go +16 -0
- package/transformer/get_source_file_from_module_specifier.go +68 -0
- package/transformer/get_statements.go +12 -0
- package/transformer/has_multiple_definitions.go +18 -0
- package/transformer/hoist_functions_past_final_statement.go +43 -0
- package/transformer/identifier_macros.go +17 -0
- package/transformer/is_blocked_by_try_statement.go +19 -0
- package/transformer/is_method.go +104 -0
- package/transformer/is_symbol_mutable.go +26 -0
- package/transformer/is_symbol_of_value.go +11 -0
- package/transformer/is_used_as_statement.go +25 -0
- package/transformer/is_valid_method_index_without_call.go +36 -0
- package/transformer/macro_manager.go +92 -0
- package/transformer/object_accessor.go +32 -0
- package/transformer/offset.go +58 -0
- package/transformer/pointer.go +53 -0
- package/transformer/property_call_macros.go +1035 -0
- package/transformer/state.go +606 -0
- package/transformer/transform_array_assignment_pattern.go +65 -0
- package/transformer/transform_array_binding_pattern.go +49 -0
- package/transformer/transform_array_literal_expression.go +97 -0
- package/transformer/transform_await_expression.go +12 -0
- package/transformer/transform_binary_expression.go +221 -0
- package/transformer/transform_binding_name.go +25 -0
- package/transformer/transform_block.go +14 -0
- package/transformer/transform_boolean_literal.go +13 -0
- package/transformer/transform_break_statement.go +26 -0
- package/transformer/transform_call_expression.go +266 -0
- package/transformer/transform_class_constructor.go +125 -0
- package/transformer/transform_class_declaration.go +12 -0
- package/transformer/transform_class_expression.go +14 -0
- package/transformer/transform_class_like_declaration.go +355 -0
- package/transformer/transform_conditional_expression.go +70 -0
- package/transformer/transform_continue_statement.go +30 -0
- package/transformer/transform_decorators.go +253 -0
- package/transformer/transform_delete_expression.go +17 -0
- package/transformer/transform_do_statement.go +39 -0
- package/transformer/transform_element_access_expression.go +114 -0
- package/transformer/transform_entity_name.go +21 -0
- package/transformer/transform_enum_declaration.go +135 -0
- package/transformer/transform_export_assignment.go +57 -0
- package/transformer/transform_export_declaration.go +150 -0
- package/transformer/transform_expression.go +120 -0
- package/transformer/transform_expression_statement.go +71 -0
- package/transformer/transform_for_of_statement.go +461 -0
- package/transformer/transform_for_statement.go +599 -0
- package/transformer/transform_function_declaration.go +84 -0
- package/transformer/transform_function_expression.go +48 -0
- package/transformer/transform_identifier.go +194 -0
- package/transformer/transform_if_statement.go +44 -0
- package/transformer/transform_import_declaration.go +146 -0
- package/transformer/transform_import_equals_declaration.go +46 -0
- package/transformer/transform_import_expression.go +36 -0
- package/transformer/transform_initializer.go +22 -0
- package/transformer/transform_interpolated_string_part.go +12 -0
- package/transformer/transform_jsx.go +41 -0
- package/transformer/transform_jsx_attributes.go +110 -0
- package/transformer/transform_jsx_children.go +50 -0
- package/transformer/transform_jsx_element.go +14 -0
- package/transformer/transform_jsx_expression.go +20 -0
- package/transformer/transform_jsx_fragment.go +42 -0
- package/transformer/transform_jsx_self_closing_element.go +13 -0
- package/transformer/transform_jsx_tag_name.go +53 -0
- package/transformer/transform_logical.go +160 -0
- package/transformer/transform_logical_or_coalescing_assignment_expression.go +103 -0
- package/transformer/transform_method_declaration.go +102 -0
- package/transformer/transform_module_declaration.go +143 -0
- package/transformer/transform_new_expression.go +27 -0
- package/transformer/transform_no_substitution_template_literal.go +16 -0
- package/transformer/transform_numeric_literal.go +15 -0
- package/transformer/transform_object_assignment_pattern.go +86 -0
- package/transformer/transform_object_binding_pattern.go +49 -0
- package/transformer/transform_object_literal_expression.go +107 -0
- package/transformer/transform_omitted_expression.go +9 -0
- package/transformer/transform_optional_chain.go +312 -0
- package/transformer/transform_parameters.go +124 -0
- package/transformer/transform_parenthesized_expression.go +17 -0
- package/transformer/transform_property_access_expression.go +37 -0
- package/transformer/transform_property_declaration.go +33 -0
- package/transformer/transform_property_name.go +20 -0
- package/transformer/transform_return_statement.go +83 -0
- package/transformer/transform_source_file.go +230 -0
- package/transformer/transform_spread_element.go +35 -0
- package/transformer/transform_statement.go +84 -0
- package/transformer/transform_statement_list.go +90 -0
- package/transformer/transform_string_literal.go +22 -0
- package/transformer/transform_super_keyword.go +9 -0
- package/transformer/transform_switch_statement.go +145 -0
- package/transformer/transform_tagged_template_expression.go +34 -0
- package/transformer/transform_template_expression.go +35 -0
- package/transformer/transform_this_expression.go +33 -0
- package/transformer/transform_throw_statement.go +18 -0
- package/transformer/transform_try_statement.go +192 -0
- package/transformer/transform_type_expression.go +12 -0
- package/transformer/transform_unary_expression.go +79 -0
- package/transformer/transform_variable_statement.go +178 -0
- package/transformer/transform_void_expression.go +13 -0
- package/transformer/transform_while_statement.go +34 -0
- package/transformer/transform_writable.go +69 -0
- package/transformer/transform_yield_expression.go +56 -0
- package/transformer/type_guards.go +30 -0
- package/transformer/types.go +381 -0
- package/transformer/validate_identifier.go +17 -0
- package/transformer/validate_method_assignment.go +106 -0
- package/transformer/validate_not_any.go +37 -0
- package/transformer/wrap_expression_statement.go +20 -0
- package/transformer/wrap_return_if_lua_tuple.go +63 -0
- package/transformer/wrap_statements_as_generator.go +22 -0
- package/tsbridge/affected.go +141 -0
- package/tsbridge/config.go +71 -0
- package/tsbridge/diagnostics.go +128 -0
- package/tsbridge/doc.go +16 -0
- package/tsbridge/macros.go +207 -0
- package/tsbridge/macrospec.go +30 -0
- package/tsbridge/pool.go +142 -0
- package/tsbridge/project.go +137 -0
- package/tsbridge/reprint.go +120 -0
- package/tsbridge/update.go +128 -0
- package/watch/poll.go +126 -0
- package/watch/session.go +651 -0
- 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
|
+
}
|