@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.
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 +239 -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 +262 -0
  49. package/plugins/session.go +223 -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 +99 -0
  217. package/tsbridge/update.go +128 -0
  218. package/watch/poll.go +126 -0
  219. package/watch/session.go +651 -0
  220. package/watch/watch.go +180 -0
@@ -0,0 +1,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
+ }