@data-vegle/rbxts-go 0.0.0-stage → 1.0.0
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 +239 -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 +262 -0
- package/plugins/session.go +223 -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 +99 -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
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
package luau
|
|
2
|
+
|
|
3
|
+
import "strings"
|
|
4
|
+
|
|
5
|
+
// Ported from src/LuauRenderer/nodes/statements/*.ts (renderAssignment,
|
|
6
|
+
// renderBreakStatement, renderCallStatement, renderComment,
|
|
7
|
+
// renderContinueStatement, renderDoStatement, renderForStatement,
|
|
8
|
+
// renderFunctionDeclaration, renderIfStatement, renderMethodDeclaration,
|
|
9
|
+
// renderNumericForStatement, renderRepeatStatement, renderReturnStatement,
|
|
10
|
+
// renderVariableDeclaration, renderWhileStatement).
|
|
11
|
+
//
|
|
12
|
+
// A line is writeIndent, the content, then writeLineEnd. Upstream builds the
|
|
13
|
+
// content first and indents it afterwards, but the indent never changes in
|
|
14
|
+
// between, so the bytes are the same.
|
|
15
|
+
|
|
16
|
+
// renderListOrNode renders a node, or the nodes of a list separated by ", ".
|
|
17
|
+
// A list must not be empty when requireNonEmpty is set.
|
|
18
|
+
func renderListOrNode(state *RenderState, v NodeOrList, requireNonEmpty bool) {
|
|
19
|
+
if list, ok := v.(*List); ok {
|
|
20
|
+
if requireNonEmpty {
|
|
21
|
+
Assert(!list.IsEmpty(), "")
|
|
22
|
+
}
|
|
23
|
+
for ln := list.Head; ln != nil; ln = ln.Next {
|
|
24
|
+
if ln != list.Head {
|
|
25
|
+
state.writeString(", ")
|
|
26
|
+
}
|
|
27
|
+
renderNode(state, ln.Value)
|
|
28
|
+
}
|
|
29
|
+
return
|
|
30
|
+
}
|
|
31
|
+
renderNode(state, v.(Node))
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
func renderAssignment(state *RenderState, node *Assignment) {
|
|
35
|
+
state.writeIndent()
|
|
36
|
+
renderListOrNode(state, node.Left, true)
|
|
37
|
+
state.writeByte(' ')
|
|
38
|
+
state.writeString(string(node.Operator))
|
|
39
|
+
state.writeByte(' ')
|
|
40
|
+
renderListOrNode(state, node.Right, true)
|
|
41
|
+
state.writeLineEnd(node)
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
func renderBreakStatement(state *RenderState) {
|
|
45
|
+
state.writeLine("break")
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
func renderCallStatement(state *RenderState, node *CallStatement) {
|
|
49
|
+
state.writeIndent()
|
|
50
|
+
renderNode(state, node.Expression)
|
|
51
|
+
state.writeLineEnd(node)
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
func renderComment(state *RenderState, node *Comment) {
|
|
55
|
+
text := node.Text
|
|
56
|
+
if strings.IndexByte(text, '\n') >= 0 {
|
|
57
|
+
eq := getSafeBracketEquals(text)
|
|
58
|
+
state.writeIndent()
|
|
59
|
+
state.writeString("--[")
|
|
60
|
+
state.writeEquals(eq)
|
|
61
|
+
state.writeString("[\n")
|
|
62
|
+
|
|
63
|
+
state.indent++
|
|
64
|
+
for {
|
|
65
|
+
i := strings.IndexByte(text, '\n')
|
|
66
|
+
state.writeIndent()
|
|
67
|
+
if i < 0 {
|
|
68
|
+
state.writeString(text)
|
|
69
|
+
state.writeByte('\n')
|
|
70
|
+
break
|
|
71
|
+
}
|
|
72
|
+
state.writeString(text[:i])
|
|
73
|
+
state.writeByte('\n')
|
|
74
|
+
text = text[i+1:]
|
|
75
|
+
}
|
|
76
|
+
state.indent--
|
|
77
|
+
|
|
78
|
+
state.writeIndent()
|
|
79
|
+
state.writeByte(']')
|
|
80
|
+
state.writeEquals(eq)
|
|
81
|
+
state.writeString("]\n")
|
|
82
|
+
} else {
|
|
83
|
+
state.writeIndent()
|
|
84
|
+
state.writeString("--")
|
|
85
|
+
state.writeString(text)
|
|
86
|
+
state.writeByte('\n')
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
func renderContinueStatement(state *RenderState) {
|
|
91
|
+
state.writeLine("continue")
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
func renderDoStatement(state *RenderState, node *DoStatement) {
|
|
95
|
+
state.writeLine("do")
|
|
96
|
+
renderBlock(state, node.Statements)
|
|
97
|
+
state.writeLine("end")
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
func renderForStatement(state *RenderState, node *ForStatement) {
|
|
101
|
+
state.writeIndent()
|
|
102
|
+
state.writeString("for ")
|
|
103
|
+
if node.IDs.IsEmpty() {
|
|
104
|
+
state.writeByte('_')
|
|
105
|
+
} else {
|
|
106
|
+
for ln := node.IDs.Head; ln != nil; ln = ln.Next {
|
|
107
|
+
if ln != node.IDs.Head {
|
|
108
|
+
state.writeString(", ")
|
|
109
|
+
}
|
|
110
|
+
renderNode(state, ln.Value)
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
state.writeString(" in ")
|
|
114
|
+
renderNode(state, node.Expression)
|
|
115
|
+
state.writeString(" do\n")
|
|
116
|
+
renderBlock(state, node.Statements)
|
|
117
|
+
state.writeLine("end")
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
func renderFunctionDeclaration(state *RenderState, node *FunctionDeclaration) {
|
|
121
|
+
if node.Localize {
|
|
122
|
+
Assert(IsAnyIdentifier(node.Name), "local function cannot be a property")
|
|
123
|
+
}
|
|
124
|
+
state.writeIndent()
|
|
125
|
+
if node.Localize {
|
|
126
|
+
state.writeString("local ")
|
|
127
|
+
}
|
|
128
|
+
state.writeString("function ")
|
|
129
|
+
renderNode(state, node.Name)
|
|
130
|
+
state.writeByte('(')
|
|
131
|
+
renderParameters(state, node.Parameters, node.HasDotDotDot)
|
|
132
|
+
state.writeString(")\n")
|
|
133
|
+
renderBlock(state, node.Statements)
|
|
134
|
+
state.writeLine("end")
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
func renderIfStatement(state *RenderState, node *IfStatement) {
|
|
138
|
+
state.writeIndent()
|
|
139
|
+
state.writeString("if ")
|
|
140
|
+
renderNode(state, node.Condition)
|
|
141
|
+
state.writeString(" then\n")
|
|
142
|
+
renderBlock(state, node.Statements)
|
|
143
|
+
|
|
144
|
+
currentElseBody := node.ElseBody
|
|
145
|
+
for {
|
|
146
|
+
elseIf, ok := currentElseBody.(*IfStatement)
|
|
147
|
+
if !ok {
|
|
148
|
+
break
|
|
149
|
+
}
|
|
150
|
+
state.writeIndent()
|
|
151
|
+
state.writeString("elseif ")
|
|
152
|
+
renderNode(state, elseIf.Condition)
|
|
153
|
+
state.writeString(" then\n")
|
|
154
|
+
renderBlock(state, elseIf.Statements)
|
|
155
|
+
currentElseBody = elseIf.ElseBody
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
if list, ok := currentElseBody.(*List); ok && list.IsNonEmpty() {
|
|
159
|
+
state.writeLine("else")
|
|
160
|
+
renderBlock(state, list)
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
state.writeLine("end")
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
func renderMethodDeclaration(state *RenderState, node *MethodDeclaration) {
|
|
167
|
+
state.writeIndent()
|
|
168
|
+
state.writeString("function ")
|
|
169
|
+
renderNode(state, node.Expression)
|
|
170
|
+
state.writeByte(':')
|
|
171
|
+
state.writeString(node.Name)
|
|
172
|
+
state.writeByte('(')
|
|
173
|
+
renderParameters(state, node.Parameters, node.HasDotDotDot)
|
|
174
|
+
state.writeString(")\n")
|
|
175
|
+
renderBlock(state, node.Statements)
|
|
176
|
+
state.writeLine("end")
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
func renderNumericForStatement(state *RenderState, node *NumericForStatement) {
|
|
180
|
+
state.writeIndent()
|
|
181
|
+
state.writeString("for ")
|
|
182
|
+
renderNode(state, node.ID)
|
|
183
|
+
state.writeString(" = ")
|
|
184
|
+
renderNode(state, node.Start)
|
|
185
|
+
state.writeString(", ")
|
|
186
|
+
renderNode(state, node.End)
|
|
187
|
+
|
|
188
|
+
// step of 1 can be omitted
|
|
189
|
+
if node.Step != nil {
|
|
190
|
+
if lit, ok := node.Step.(*NumberLiteral); !ok || jsToNumber(lit.Value) != 1 {
|
|
191
|
+
state.writeString(", ")
|
|
192
|
+
renderNode(state, node.Step)
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
state.writeString(" do\n")
|
|
197
|
+
renderBlock(state, node.Statements)
|
|
198
|
+
state.writeLine("end")
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
func renderRepeatStatement(state *RenderState, node *RepeatStatement) {
|
|
202
|
+
state.writeLine("repeat")
|
|
203
|
+
renderBlock(state, node.Statements)
|
|
204
|
+
state.writeIndent()
|
|
205
|
+
state.writeString("until ")
|
|
206
|
+
renderNode(state, node.Condition)
|
|
207
|
+
state.writeByte('\n')
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
func renderReturnStatement(state *RenderState, node *ReturnStatement) {
|
|
211
|
+
state.writeIndent()
|
|
212
|
+
state.writeString("return ")
|
|
213
|
+
renderListOrNode(state, node.Expression, false)
|
|
214
|
+
state.writeByte('\n')
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
func renderVariableDeclaration(state *RenderState, node *VariableDeclaration) {
|
|
218
|
+
state.writeIndent()
|
|
219
|
+
state.writeString("local ")
|
|
220
|
+
renderListOrNode(state, node.Left, true)
|
|
221
|
+
if node.Right != nil {
|
|
222
|
+
state.writeString(" = ")
|
|
223
|
+
renderListOrNode(state, node.Right, true)
|
|
224
|
+
}
|
|
225
|
+
state.writeLineEnd(node)
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
func renderWhileStatement(state *RenderState, node *WhileStatement) {
|
|
229
|
+
state.writeIndent()
|
|
230
|
+
state.writeString("while ")
|
|
231
|
+
renderNode(state, node.Condition)
|
|
232
|
+
state.writeString(" do\n")
|
|
233
|
+
renderBlock(state, node.Statements)
|
|
234
|
+
state.writeLine("end")
|
|
235
|
+
}
|
|
@@ -0,0 +1,296 @@
|
|
|
1
|
+
package luau
|
|
2
|
+
|
|
3
|
+
// Ported from src/LuauRenderer/util/getEnding.ts, getSafeBracketEquals.ts,
|
|
4
|
+
// needsParentheses.ts, renderArguments.ts, renderParameters.ts and
|
|
5
|
+
// renderStatements.ts.
|
|
6
|
+
|
|
7
|
+
// ---------------------------------------------------------------------------
|
|
8
|
+
// getEnding.ts
|
|
9
|
+
|
|
10
|
+
func endsWithIndexableExpressionInner(node Node) bool {
|
|
11
|
+
switch n := node.(type) {
|
|
12
|
+
case *BinaryExpression:
|
|
13
|
+
// `a + b`
|
|
14
|
+
return endsWithIndexableExpressionInner(n.Right)
|
|
15
|
+
case *UnaryExpression:
|
|
16
|
+
// `-a`
|
|
17
|
+
return endsWithIndexableExpressionInner(n.Expression)
|
|
18
|
+
case *IfExpression:
|
|
19
|
+
// `if a then b else c`, `if a then b elseif c then d else e`
|
|
20
|
+
return endsWithIndexableExpressionInner(n.Alternative)
|
|
21
|
+
}
|
|
22
|
+
// `a` or `(a)` or `a.b` or `a[b]` or `a()`
|
|
23
|
+
return IsIndexableExpression(node)
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
// furthestRight picks the last expression of a declaration or assignment:
|
|
27
|
+
// `local a = b`, `a = b`, `local a`, `local a, b`.
|
|
28
|
+
func furthestRight(left, right NodeOrList) Node {
|
|
29
|
+
if right != nil {
|
|
30
|
+
if list, ok := right.(*List); ok {
|
|
31
|
+
Assert(list.IsNonEmpty(), "")
|
|
32
|
+
return list.Tail.Value
|
|
33
|
+
}
|
|
34
|
+
return right.(Node)
|
|
35
|
+
}
|
|
36
|
+
if list, ok := left.(*List); ok {
|
|
37
|
+
Assert(list.IsNonEmpty(), "")
|
|
38
|
+
return list.Tail.Value
|
|
39
|
+
}
|
|
40
|
+
return left.(Node)
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
func endsWithIndexableExpression(node Statement) bool {
|
|
44
|
+
switch n := node.(type) {
|
|
45
|
+
case *CallStatement:
|
|
46
|
+
// `a()`
|
|
47
|
+
return true
|
|
48
|
+
case *VariableDeclaration:
|
|
49
|
+
return endsWithIndexableExpressionInner(furthestRight(n.Left, n.Right))
|
|
50
|
+
case *Assignment:
|
|
51
|
+
return endsWithIndexableExpressionInner(furthestRight(n.Left, n.Right))
|
|
52
|
+
}
|
|
53
|
+
return false
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
func startsWithParenthesisInner(node Node) bool {
|
|
57
|
+
switch n := node.(type) {
|
|
58
|
+
case *ParenthesizedExpression:
|
|
59
|
+
// `(a)`
|
|
60
|
+
return true
|
|
61
|
+
case *CallExpression:
|
|
62
|
+
// `(a)()`
|
|
63
|
+
return startsWithParenthesisInner(n.Expression)
|
|
64
|
+
case *MethodCallExpression:
|
|
65
|
+
// `(a):b()`
|
|
66
|
+
return startsWithParenthesisInner(n.Expression)
|
|
67
|
+
case *PropertyAccessExpression:
|
|
68
|
+
// `(a).b`
|
|
69
|
+
return startsWithParenthesisInner(n.Expression)
|
|
70
|
+
case *ComputedIndexExpression:
|
|
71
|
+
// `(a)[b]`
|
|
72
|
+
return startsWithParenthesisInner(n.Expression)
|
|
73
|
+
}
|
|
74
|
+
return false
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
func startsWithParenthesis(node Node) bool {
|
|
78
|
+
switch n := node.(type) {
|
|
79
|
+
case *CallStatement:
|
|
80
|
+
// `(a)()`
|
|
81
|
+
return startsWithParenthesisInner(n.Expression.Callee())
|
|
82
|
+
case *Assignment:
|
|
83
|
+
if list, ok := n.Left.(*List); ok {
|
|
84
|
+
// `(a).b, c = d`
|
|
85
|
+
Assert(list.IsNonEmpty(), "")
|
|
86
|
+
return startsWithParenthesisInner(list.Head.Value)
|
|
87
|
+
}
|
|
88
|
+
// `(a).b = c`
|
|
89
|
+
return startsWithParenthesisInner(n.Left.(Node))
|
|
90
|
+
}
|
|
91
|
+
return false
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
func getNextNonComment(state *RenderState) Node {
|
|
95
|
+
top := state.PeekListNode()
|
|
96
|
+
if top == nil {
|
|
97
|
+
return nil
|
|
98
|
+
}
|
|
99
|
+
listNode := top.Next
|
|
100
|
+
for listNode != nil && IsComment(listNode.Value) {
|
|
101
|
+
listNode = listNode.Next
|
|
102
|
+
}
|
|
103
|
+
if listNode == nil {
|
|
104
|
+
return nil
|
|
105
|
+
}
|
|
106
|
+
return listNode.Value
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// needsSemicolon resolves if the given statement needs to end with a `;`
|
|
110
|
+
// (upstream getEnding returns ";" or "").
|
|
111
|
+
//
|
|
112
|
+
// Used to avoid "ambiguous syntax" errors in Luau. This is only necessary in
|
|
113
|
+
// statements which can end in an IndexableExpression: CallStatement,
|
|
114
|
+
// VariableDeclaration and Assignment.
|
|
115
|
+
func needsSemicolon(state *RenderState, node Statement) bool {
|
|
116
|
+
nextStatement := getNextNonComment(state)
|
|
117
|
+
return nextStatement != nil && endsWithIndexableExpression(node) && startsWithParenthesis(nextStatement)
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
// ---------------------------------------------------------------------------
|
|
121
|
+
// getSafeBracketEquals.ts
|
|
122
|
+
|
|
123
|
+
// hasBracketRun reports whether s contains "]" + n*"=" + "]".
|
|
124
|
+
func hasBracketRun(s string, n int) bool {
|
|
125
|
+
for i := 0; i+n+1 < len(s); i++ {
|
|
126
|
+
if s[i] != ']' {
|
|
127
|
+
continue
|
|
128
|
+
}
|
|
129
|
+
j := 1
|
|
130
|
+
for j <= n && s[i+j] == '=' {
|
|
131
|
+
j++
|
|
132
|
+
}
|
|
133
|
+
if j == n+1 && s[i+n+1] == ']' {
|
|
134
|
+
return true
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
return false
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
// endsWithBracketRun reports whether s ends with "]" + n*"=".
|
|
141
|
+
func endsWithBracketRun(s string, n int) bool {
|
|
142
|
+
if len(s) < n+1 || s[len(s)-n-1] != ']' {
|
|
143
|
+
return false
|
|
144
|
+
}
|
|
145
|
+
for i := len(s) - n; i < len(s); i++ {
|
|
146
|
+
if s[i] != '=' {
|
|
147
|
+
return false
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
return true
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
// getSafeBracketEquals returns the number of "=" a long bracket needs so that
|
|
154
|
+
// str cannot close it early.
|
|
155
|
+
func getSafeBracketEquals(str string) int {
|
|
156
|
+
amtEquals := 0
|
|
157
|
+
for hasBracketRun(str, amtEquals) || endsWithBracketRun(str, amtEquals) {
|
|
158
|
+
amtEquals++
|
|
159
|
+
}
|
|
160
|
+
return amtEquals
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
func (s *RenderState) writeEquals(n int) {
|
|
164
|
+
for i := 0; i < n; i++ {
|
|
165
|
+
s.buf = append(s.buf, '=')
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
// ---------------------------------------------------------------------------
|
|
170
|
+
// needsParentheses.ts
|
|
171
|
+
|
|
172
|
+
// https://www.lua.org/manual/5.1/manual.html#2.5.6
|
|
173
|
+
//
|
|
174
|
+
// 1. or
|
|
175
|
+
// 2. and
|
|
176
|
+
// 3. < > <= >= ~= ==
|
|
177
|
+
// 4. ..
|
|
178
|
+
// 5. + -
|
|
179
|
+
// 6. * / %
|
|
180
|
+
// 7. not # - (unary)
|
|
181
|
+
// 8. ^
|
|
182
|
+
|
|
183
|
+
const ifExpressionPrecedence = 1
|
|
184
|
+
|
|
185
|
+
func unaryPrecedence(op UnaryOperator) int {
|
|
186
|
+
switch op {
|
|
187
|
+
case "not", "#", "-":
|
|
188
|
+
return 7
|
|
189
|
+
}
|
|
190
|
+
return 0 // upstream: undefined
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
func binaryPrecedence(op BinaryOperator) int {
|
|
194
|
+
switch op {
|
|
195
|
+
case "or":
|
|
196
|
+
return 1
|
|
197
|
+
case "and":
|
|
198
|
+
return 2
|
|
199
|
+
case "<", ">", "<=", ">=", "~=", "==":
|
|
200
|
+
return 3
|
|
201
|
+
case "..":
|
|
202
|
+
return 4
|
|
203
|
+
case "+", "-":
|
|
204
|
+
return 5
|
|
205
|
+
case "*", "/", "//", "%":
|
|
206
|
+
return 6
|
|
207
|
+
case "^":
|
|
208
|
+
return 8
|
|
209
|
+
}
|
|
210
|
+
return 0 // upstream: undefined
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
func getPrecedence(node Node) int {
|
|
214
|
+
switch n := node.(type) {
|
|
215
|
+
case *IfExpression:
|
|
216
|
+
return ifExpressionPrecedence
|
|
217
|
+
case *BinaryExpression:
|
|
218
|
+
return binaryPrecedence(n.Operator)
|
|
219
|
+
case *UnaryExpression:
|
|
220
|
+
return unaryPrecedence(n.Operator)
|
|
221
|
+
}
|
|
222
|
+
Assert(false, "")
|
|
223
|
+
return 0
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
// needsParentheses takes an IfExpression, UnaryExpression or BinaryExpression.
|
|
227
|
+
func needsParentheses(node Expression) bool {
|
|
228
|
+
parent := node.Parent()
|
|
229
|
+
if parent != nil && IsExpressionWithPrecedence(parent) {
|
|
230
|
+
nodePrecedence := getPrecedence(node)
|
|
231
|
+
parentPrecedence := getPrecedence(parent)
|
|
232
|
+
if nodePrecedence < parentPrecedence {
|
|
233
|
+
return true
|
|
234
|
+
} else if nodePrecedence == parentPrecedence {
|
|
235
|
+
if p, ok := parent.(*BinaryExpression); ok {
|
|
236
|
+
return Node(node) == Node(p.Right)
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
return false
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
// ---------------------------------------------------------------------------
|
|
244
|
+
// renderArguments.ts, renderParameters.ts, renderStatements.ts
|
|
245
|
+
|
|
246
|
+
// renderArguments renders a list of expressions separated by ", ".
|
|
247
|
+
func renderArguments(state *RenderState, expressions *List) {
|
|
248
|
+
for ln := expressions.Head; ln != nil; ln = ln.Next {
|
|
249
|
+
if ln != expressions.Head {
|
|
250
|
+
state.buf = append(state.buf, ", "...)
|
|
251
|
+
}
|
|
252
|
+
renderNode(state, ln.Value)
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
// renderParameters renders the parameters of a function-like node separated
|
|
257
|
+
// by ", ", with "..." on the end if hasDotDotDot is set.
|
|
258
|
+
func renderParameters(state *RenderState, parameters *List, hasDotDotDot bool) {
|
|
259
|
+
for ln := parameters.Head; ln != nil; ln = ln.Next {
|
|
260
|
+
if ln != parameters.Head {
|
|
261
|
+
state.buf = append(state.buf, ", "...)
|
|
262
|
+
}
|
|
263
|
+
renderNode(state, ln.Value)
|
|
264
|
+
}
|
|
265
|
+
if hasDotDotDot {
|
|
266
|
+
if parameters.Head != nil {
|
|
267
|
+
state.buf = append(state.buf, ", "...)
|
|
268
|
+
}
|
|
269
|
+
state.buf = append(state.buf, "..."...)
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
// renderStatementsTo renders the given list of statements.
|
|
274
|
+
//
|
|
275
|
+
// Pushes each list node onto the state's list node stack as it gets rendered
|
|
276
|
+
// to give context to other statements as they render. Useful for getting the
|
|
277
|
+
// next or previous sibling statement.
|
|
278
|
+
func renderStatementsTo(state *RenderState, statements *List) {
|
|
279
|
+
hasFinalStatement := false
|
|
280
|
+
for listNode := statements.Head; listNode != nil; listNode = listNode.Next {
|
|
281
|
+
Assert(!hasFinalStatement || IsComment(listNode.Value),
|
|
282
|
+
"Cannot render statement after break, continue, or return!")
|
|
283
|
+
hasFinalStatement = hasFinalStatement || IsFinalStatement(listNode.Value)
|
|
284
|
+
|
|
285
|
+
state.PushListNode(listNode)
|
|
286
|
+
renderNode(state, listNode.Value)
|
|
287
|
+
state.PopListNode()
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
// block renders statements one indent level deeper.
|
|
292
|
+
func renderBlock(state *RenderState, statements *List) {
|
|
293
|
+
state.indent++
|
|
294
|
+
renderStatementsTo(state, statements)
|
|
295
|
+
state.indent--
|
|
296
|
+
}
|