@data-vegle/rbxts-go 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (220) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +181 -2
  3. package/README.rbxtsgo.md +169 -0
  4. package/THIRD_PARTY_NOTICES.md +745 -0
  5. package/cli/cli.go +454 -0
  6. package/compile/compile.go +388 -0
  7. package/compile/declarations.go +221 -0
  8. package/compile/incremental.go +349 -0
  9. package/compile/times.go +9 -0
  10. package/docs/plugin-api.md +243 -0
  11. package/go.mod +20 -0
  12. package/go.sum +24 -0
  13. package/internal/difftest/difftest.go +530 -0
  14. package/internal/plugintest/plugintest.go +181 -0
  15. package/luau/create.go +351 -0
  16. package/luau/doc.go +71 -0
  17. package/luau/globals.go +178 -0
  18. package/luau/jsnum.go +188 -0
  19. package/luau/kinds.go +128 -0
  20. package/luau/list.go +227 -0
  21. package/luau/nodes.go +479 -0
  22. package/luau/operators.go +46 -0
  23. package/luau/render.go +134 -0
  24. package/luau/render_expressions.go +264 -0
  25. package/luau/render_fields.go +81 -0
  26. package/luau/render_indexable.go +81 -0
  27. package/luau/render_state.go +134 -0
  28. package/luau/render_statements.go +235 -0
  29. package/luau/render_util.go +296 -0
  30. package/luau/solve_temp_ids.go +212 -0
  31. package/luau/typeguards.go +175 -0
  32. package/luau/util.go +184 -0
  33. package/luau/visit.go +138 -0
  34. package/npm/index.d.ts +3 -0
  35. package/npm/rbxts-go.sh +187 -0
  36. package/package.json +45 -5
  37. package/patches/typescript/0001-checker-exports.patch +40 -0
  38. package/patches/typescript/0002-iterable-arity.patch +15 -0
  39. package/patches/typescript/0003-context-sensitive-this.patch +15 -0
  40. package/patches/typescript/0004-printer-keep-parse-tree-parentheses.patch +26 -0
  41. package/pluginapi/host.go +31 -0
  42. package/pluginapi/pluginapi.go +153 -0
  43. package/plugins/LICENSE-rbxts-transformer-setget +18 -0
  44. package/plugins/apply.go +342 -0
  45. package/plugins/config.go +431 -0
  46. package/plugins/fallback.go +84 -0
  47. package/plugins/fixemit.go +60 -0
  48. package/plugins/native.go +271 -0
  49. package/plugins/session.go +236 -0
  50. package/plugins/setget.go +478 -0
  51. package/project/copy.go +333 -0
  52. package/project/include/Promise.lua +2068 -0
  53. package/project/include/RuntimeLib.lua +260 -0
  54. package/project/nodepath/nodepath.go +917 -0
  55. package/project/pathtranslator/pathtranslator.go +214 -0
  56. package/project/project.go +498 -0
  57. package/project/rojoresolver/json.go +248 -0
  58. package/project/rojoresolver/rojoresolver.go +559 -0
  59. package/project/shared/constants.go +83 -0
  60. package/project/shared/diagnostic.go +238 -0
  61. package/project/shared/diagnostics.go +388 -0
  62. package/project/shared/elapsed.go +14 -0
  63. package/project/shared/eol_other.go +6 -0
  64. package/project/shared/eol_windows.go +4 -0
  65. package/project/shared/kleur.go +40 -0
  66. package/project/shared/util.go +183 -0
  67. package/scripts/build-with-plugins.sh +130 -0
  68. package/scripts/setup-third-party.sh +75 -0
  69. package/transformer/add_index_diagnostics.go +21 -0
  70. package/transformer/add_one_if_array_type.go +15 -0
  71. package/transformer/array_binding_pattern_contains_hoists.go +25 -0
  72. package/transformer/assert_never.go +24 -0
  73. package/transformer/assignment.go +64 -0
  74. package/transformer/call_macros.go +70 -0
  75. package/transformer/check_variable_hoist.go +125 -0
  76. package/transformer/clean_module_name.go +28 -0
  77. package/transformer/constructor_macros.go +122 -0
  78. package/transformer/convert_to_indexable_expression.go +12 -0
  79. package/transformer/create_binary_from_operator.go +86 -0
  80. package/transformer/create_continue_statements.go +68 -0
  81. package/transformer/create_get_service.go +15 -0
  82. package/transformer/create_hoist_declaration.go +27 -0
  83. package/transformer/create_import_expression.go +220 -0
  84. package/transformer/create_string_from_literal.go +195 -0
  85. package/transformer/create_truthiness_checks.go +63 -0
  86. package/transformer/create_type_check.go +9 -0
  87. package/transformer/ensure_transform_order.go +53 -0
  88. package/transformer/expression_chain.go +27 -0
  89. package/transformer/expression_might_mutate.go +60 -0
  90. package/transformer/find_constructor.go +15 -0
  91. package/transformer/fixup_whitespace_and_decode_entities.go +377 -0
  92. package/transformer/get_accessor_for_binding_type.go +160 -0
  93. package/transformer/get_add_iterable_to_array_builder.go +363 -0
  94. package/transformer/get_assignable_value.go +15 -0
  95. package/transformer/get_constant_value_literal.go +20 -0
  96. package/transformer/get_declared_variables.go +34 -0
  97. package/transformer/get_extends_node.go +23 -0
  98. package/transformer/get_flags.go +21 -0
  99. package/transformer/get_kind_name.go +18 -0
  100. package/transformer/get_original_symbol_of_node.go +16 -0
  101. package/transformer/get_source_file_from_module_specifier.go +68 -0
  102. package/transformer/get_statements.go +12 -0
  103. package/transformer/has_multiple_definitions.go +18 -0
  104. package/transformer/hoist_functions_past_final_statement.go +43 -0
  105. package/transformer/identifier_macros.go +17 -0
  106. package/transformer/is_blocked_by_try_statement.go +19 -0
  107. package/transformer/is_method.go +104 -0
  108. package/transformer/is_symbol_mutable.go +26 -0
  109. package/transformer/is_symbol_of_value.go +11 -0
  110. package/transformer/is_used_as_statement.go +25 -0
  111. package/transformer/is_valid_method_index_without_call.go +36 -0
  112. package/transformer/macro_manager.go +92 -0
  113. package/transformer/object_accessor.go +32 -0
  114. package/transformer/offset.go +58 -0
  115. package/transformer/pointer.go +53 -0
  116. package/transformer/property_call_macros.go +1035 -0
  117. package/transformer/state.go +606 -0
  118. package/transformer/transform_array_assignment_pattern.go +65 -0
  119. package/transformer/transform_array_binding_pattern.go +49 -0
  120. package/transformer/transform_array_literal_expression.go +97 -0
  121. package/transformer/transform_await_expression.go +12 -0
  122. package/transformer/transform_binary_expression.go +221 -0
  123. package/transformer/transform_binding_name.go +25 -0
  124. package/transformer/transform_block.go +14 -0
  125. package/transformer/transform_boolean_literal.go +13 -0
  126. package/transformer/transform_break_statement.go +26 -0
  127. package/transformer/transform_call_expression.go +266 -0
  128. package/transformer/transform_class_constructor.go +125 -0
  129. package/transformer/transform_class_declaration.go +12 -0
  130. package/transformer/transform_class_expression.go +14 -0
  131. package/transformer/transform_class_like_declaration.go +355 -0
  132. package/transformer/transform_conditional_expression.go +70 -0
  133. package/transformer/transform_continue_statement.go +30 -0
  134. package/transformer/transform_decorators.go +253 -0
  135. package/transformer/transform_delete_expression.go +17 -0
  136. package/transformer/transform_do_statement.go +39 -0
  137. package/transformer/transform_element_access_expression.go +114 -0
  138. package/transformer/transform_entity_name.go +21 -0
  139. package/transformer/transform_enum_declaration.go +135 -0
  140. package/transformer/transform_export_assignment.go +57 -0
  141. package/transformer/transform_export_declaration.go +150 -0
  142. package/transformer/transform_expression.go +120 -0
  143. package/transformer/transform_expression_statement.go +71 -0
  144. package/transformer/transform_for_of_statement.go +461 -0
  145. package/transformer/transform_for_statement.go +599 -0
  146. package/transformer/transform_function_declaration.go +84 -0
  147. package/transformer/transform_function_expression.go +48 -0
  148. package/transformer/transform_identifier.go +194 -0
  149. package/transformer/transform_if_statement.go +44 -0
  150. package/transformer/transform_import_declaration.go +146 -0
  151. package/transformer/transform_import_equals_declaration.go +46 -0
  152. package/transformer/transform_import_expression.go +36 -0
  153. package/transformer/transform_initializer.go +22 -0
  154. package/transformer/transform_interpolated_string_part.go +12 -0
  155. package/transformer/transform_jsx.go +41 -0
  156. package/transformer/transform_jsx_attributes.go +110 -0
  157. package/transformer/transform_jsx_children.go +50 -0
  158. package/transformer/transform_jsx_element.go +14 -0
  159. package/transformer/transform_jsx_expression.go +20 -0
  160. package/transformer/transform_jsx_fragment.go +42 -0
  161. package/transformer/transform_jsx_self_closing_element.go +13 -0
  162. package/transformer/transform_jsx_tag_name.go +53 -0
  163. package/transformer/transform_logical.go +160 -0
  164. package/transformer/transform_logical_or_coalescing_assignment_expression.go +103 -0
  165. package/transformer/transform_method_declaration.go +102 -0
  166. package/transformer/transform_module_declaration.go +143 -0
  167. package/transformer/transform_new_expression.go +27 -0
  168. package/transformer/transform_no_substitution_template_literal.go +16 -0
  169. package/transformer/transform_numeric_literal.go +15 -0
  170. package/transformer/transform_object_assignment_pattern.go +86 -0
  171. package/transformer/transform_object_binding_pattern.go +49 -0
  172. package/transformer/transform_object_literal_expression.go +107 -0
  173. package/transformer/transform_omitted_expression.go +9 -0
  174. package/transformer/transform_optional_chain.go +312 -0
  175. package/transformer/transform_parameters.go +124 -0
  176. package/transformer/transform_parenthesized_expression.go +17 -0
  177. package/transformer/transform_property_access_expression.go +37 -0
  178. package/transformer/transform_property_declaration.go +33 -0
  179. package/transformer/transform_property_name.go +20 -0
  180. package/transformer/transform_return_statement.go +83 -0
  181. package/transformer/transform_source_file.go +230 -0
  182. package/transformer/transform_spread_element.go +35 -0
  183. package/transformer/transform_statement.go +84 -0
  184. package/transformer/transform_statement_list.go +90 -0
  185. package/transformer/transform_string_literal.go +22 -0
  186. package/transformer/transform_super_keyword.go +9 -0
  187. package/transformer/transform_switch_statement.go +145 -0
  188. package/transformer/transform_tagged_template_expression.go +34 -0
  189. package/transformer/transform_template_expression.go +35 -0
  190. package/transformer/transform_this_expression.go +33 -0
  191. package/transformer/transform_throw_statement.go +18 -0
  192. package/transformer/transform_try_statement.go +192 -0
  193. package/transformer/transform_type_expression.go +12 -0
  194. package/transformer/transform_unary_expression.go +79 -0
  195. package/transformer/transform_variable_statement.go +178 -0
  196. package/transformer/transform_void_expression.go +13 -0
  197. package/transformer/transform_while_statement.go +34 -0
  198. package/transformer/transform_writable.go +69 -0
  199. package/transformer/transform_yield_expression.go +56 -0
  200. package/transformer/type_guards.go +30 -0
  201. package/transformer/types.go +381 -0
  202. package/transformer/validate_identifier.go +17 -0
  203. package/transformer/validate_method_assignment.go +106 -0
  204. package/transformer/validate_not_any.go +37 -0
  205. package/transformer/wrap_expression_statement.go +20 -0
  206. package/transformer/wrap_return_if_lua_tuple.go +63 -0
  207. package/transformer/wrap_statements_as_generator.go +22 -0
  208. package/tsbridge/affected.go +141 -0
  209. package/tsbridge/config.go +71 -0
  210. package/tsbridge/diagnostics.go +128 -0
  211. package/tsbridge/doc.go +16 -0
  212. package/tsbridge/macros.go +207 -0
  213. package/tsbridge/macrospec.go +30 -0
  214. package/tsbridge/pool.go +142 -0
  215. package/tsbridge/project.go +137 -0
  216. package/tsbridge/reprint.go +120 -0
  217. package/tsbridge/update.go +128 -0
  218. package/watch/poll.go +126 -0
  219. package/watch/session.go +651 -0
  220. package/watch/watch.go +180 -0
package/luau/jsnum.go ADDED
@@ -0,0 +1,188 @@
1
+ package luau
2
+
3
+ import (
4
+ "math"
5
+ "math/big"
6
+ "strconv"
7
+ "strings"
8
+ )
9
+
10
+ // No upstream file: the TypeScript source relies on the JavaScript runtime for
11
+ // Number(string) and String(number) in create.ts (number), renderNumberLiteral.ts
12
+ // and renderNumericForStatement.ts. These helpers emulate those two operations
13
+ // (ECMAScript StringToNumber and Number::toString(10)).
14
+
15
+ // jsNumberToString is JavaScript String(v) for a number.
16
+ func jsNumberToString(v float64) string {
17
+ switch {
18
+ case v != v:
19
+ return "NaN"
20
+ case v == 0:
21
+ return "0" // also -0
22
+ case math.IsInf(v, 1):
23
+ return "Infinity"
24
+ case math.IsInf(v, -1):
25
+ return "-Infinity"
26
+ }
27
+ if v == math.Trunc(v) && math.Abs(v) < 1<<53 {
28
+ return strconv.FormatInt(int64(v), 10)
29
+ }
30
+
31
+ sign := ""
32
+ if v < 0 {
33
+ sign = "-"
34
+ v = -v
35
+ }
36
+
37
+ // Shortest round-trip digits, as "d.ddde+XX".
38
+ e := strconv.FormatFloat(v, 'e', -1, 64)
39
+ ePos := strings.IndexByte(e, 'e')
40
+ exp, _ := strconv.Atoi(e[ePos+1:])
41
+ digits := e[:ePos]
42
+ if len(digits) > 1 {
43
+ digits = digits[:1] + digits[2:]
44
+ }
45
+ k := len(digits)
46
+ n := exp + 1 // value = 0.digits * 10^n
47
+
48
+ var b strings.Builder
49
+ b.WriteString(sign)
50
+ switch {
51
+ case k <= n && n <= 21:
52
+ b.WriteString(digits)
53
+ for i := 0; i < n-k; i++ {
54
+ b.WriteByte('0')
55
+ }
56
+ case 0 < n && n <= 21:
57
+ b.WriteString(digits[:n])
58
+ b.WriteByte('.')
59
+ b.WriteString(digits[n:])
60
+ case -6 < n && n <= 0:
61
+ b.WriteString("0.")
62
+ for i := 0; i < -n; i++ {
63
+ b.WriteByte('0')
64
+ }
65
+ b.WriteString(digits)
66
+ default:
67
+ b.WriteByte(digits[0])
68
+ if k > 1 {
69
+ b.WriteByte('.')
70
+ b.WriteString(digits[1:])
71
+ }
72
+ b.WriteByte('e')
73
+ if n-1 >= 0 {
74
+ b.WriteByte('+')
75
+ }
76
+ b.WriteString(strconv.Itoa(n - 1))
77
+ }
78
+ return b.String()
79
+ }
80
+
81
+ // isJSSpace reports whether r is ECMAScript WhiteSpace or LineTerminator.
82
+ func isJSSpace(r rune) bool {
83
+ switch r {
84
+ case '\t', '\n', '\v', '\f', '\r', ' ', 0x00a0, 0x1680, 0x2028, 0x2029, 0x202f, 0x205f, 0x3000, 0xfeff:
85
+ return true
86
+ }
87
+ return r >= 0x2000 && r <= 0x200a
88
+ }
89
+
90
+ func digitValue(c byte) int {
91
+ switch {
92
+ case c >= '0' && c <= '9':
93
+ return int(c - '0')
94
+ case c >= 'a' && c <= 'f':
95
+ return int(c-'a') + 10
96
+ case c >= 'A' && c <= 'F':
97
+ return int(c-'A') + 10
98
+ }
99
+ return 99
100
+ }
101
+
102
+ // parseRadix parses a non-empty run of digits in the given base, rounded to nearest float64.
103
+ func parseRadix(digits string, base int) float64 {
104
+ for i := 0; i < len(digits); i++ {
105
+ if digitValue(digits[i]) >= base {
106
+ return math.NaN()
107
+ }
108
+ }
109
+ // 4 bits per hex digit; up to 13 digits is exact in a uint64 and a float64.
110
+ if len(digits) <= 12 {
111
+ u, _ := strconv.ParseUint(digits, base, 64)
112
+ return float64(u)
113
+ }
114
+ i, _ := new(big.Int).SetString(digits, base) // digits were validated above
115
+ f, _ := new(big.Float).SetInt(i).Float64()
116
+ return f
117
+ }
118
+
119
+ // jsToNumber is JavaScript Number(s) for a string.
120
+ func jsToNumber(s string) float64 {
121
+ s = strings.TrimFunc(s, isJSSpace)
122
+ if s == "" {
123
+ return 0
124
+ }
125
+ if len(s) > 2 && s[0] == '0' {
126
+ switch s[1] {
127
+ case 'x', 'X':
128
+ return parseRadix(s[2:], 16)
129
+ case 'o', 'O':
130
+ return parseRadix(s[2:], 8)
131
+ case 'b', 'B':
132
+ return parseRadix(s[2:], 2)
133
+ }
134
+ }
135
+
136
+ rest := s
137
+ neg := false
138
+ if rest[0] == '+' || rest[0] == '-' {
139
+ neg = rest[0] == '-'
140
+ rest = rest[1:]
141
+ }
142
+ if rest == "Infinity" {
143
+ if neg {
144
+ return math.Inf(-1)
145
+ }
146
+ return math.Inf(1)
147
+ }
148
+
149
+ // StrUnsignedDecimalLiteral: digits [. digits?] | . digits, then optional exponent.
150
+ i := 0
151
+ for i < len(rest) && isDigit(rest[i]) {
152
+ i++
153
+ }
154
+ intDigits := i
155
+ fracDigits := 0
156
+ if i < len(rest) && rest[i] == '.' {
157
+ i++
158
+ start := i
159
+ for i < len(rest) && isDigit(rest[i]) {
160
+ i++
161
+ }
162
+ fracDigits = i - start
163
+ }
164
+ if intDigits == 0 && fracDigits == 0 {
165
+ return math.NaN()
166
+ }
167
+ if i < len(rest) && (rest[i] == 'e' || rest[i] == 'E') {
168
+ i++
169
+ if i < len(rest) && (rest[i] == '+' || rest[i] == '-') {
170
+ i++
171
+ }
172
+ start := i
173
+ for i < len(rest) && isDigit(rest[i]) {
174
+ i++
175
+ }
176
+ if i == start {
177
+ return math.NaN()
178
+ }
179
+ }
180
+ if i != len(rest) {
181
+ return math.NaN()
182
+ }
183
+ f, _ := strconv.ParseFloat(rest, 64) // out of range gives +-Inf, as in JS
184
+ if neg {
185
+ return -f
186
+ }
187
+ return f
188
+ }
package/luau/kinds.go ADDED
@@ -0,0 +1,128 @@
1
+ package luau
2
+
3
+ // Ported from src/LuauAST/impl/enums.ts and src/LuauAST/util/getKindName.ts.
4
+
5
+ // SyntaxKind identifies a node type. The numeric values and their ordering
6
+ // are the same as upstream because category checks use ranges.
7
+ type SyntaxKind int
8
+
9
+ const (
10
+ // indexable expressions
11
+ KindIdentifier SyntaxKind = iota
12
+ KindTemporaryIdentifier
13
+ KindComputedIndexExpression
14
+ KindPropertyAccessExpression
15
+ KindCallExpression
16
+ KindMethodCallExpression
17
+ KindParenthesizedExpression
18
+
19
+ // expressions
20
+ KindNone
21
+ KindNilLiteral
22
+ KindFalseLiteral
23
+ KindTrueLiteral
24
+ KindNumberLiteral
25
+ KindStringLiteral
26
+ KindVarArgsLiteral
27
+ KindFunctionExpression
28
+ KindBinaryExpression
29
+ KindUnaryExpression
30
+ KindIfExpression
31
+ KindInterpolatedString
32
+ KindArray
33
+ KindMap
34
+ KindSet
35
+ KindMixedTable
36
+
37
+ // statements
38
+ KindAssignment
39
+ KindBreakStatement
40
+ KindCallStatement
41
+ KindContinueStatement
42
+ KindDoStatement
43
+ KindWhileStatement
44
+ KindRepeatStatement
45
+ KindIfStatement
46
+ KindNumericForStatement
47
+ KindForStatement
48
+ KindFunctionDeclaration
49
+ KindMethodDeclaration
50
+ KindVariableDeclaration
51
+ KindReturnStatement
52
+ KindComment
53
+
54
+ // fields
55
+ KindMapField
56
+ KindInterpolatedStringPart
57
+ )
58
+
59
+ // Used to detect what category a given kind falls into.
60
+ const (
61
+ KindFirstIndexableExpression = KindIdentifier
62
+ KindLastIndexableExpression = KindParenthesizedExpression
63
+ KindFirstExpression = KindIdentifier
64
+ KindLastExpression = KindMixedTable
65
+ KindFirstStatement = KindAssignment
66
+ KindLastStatement = KindComment
67
+ KindFirstField = KindMapField
68
+ KindLastField = KindInterpolatedStringPart
69
+ )
70
+
71
+ // kindNames is the TypeScript reverse mapping SyntaxKind[kind] of the
72
+ // upstream enum. TypeScript enums with aliased members keep the last name
73
+ // assigned to a value, so MixedTable (== LastExpression) and
74
+ // InterpolatedStringPart (== LastField) come out as the "Last" aliases. The
75
+ // other aliased values are special-cased in upstream getKindName, so they are
76
+ // listed here under their real names.
77
+ var kindNames = [...]string{
78
+ KindIdentifier: "Identifier",
79
+ KindTemporaryIdentifier: "TemporaryIdentifier",
80
+ KindComputedIndexExpression: "ComputedIndexExpression",
81
+ KindPropertyAccessExpression: "PropertyAccessExpression",
82
+ KindCallExpression: "CallExpression",
83
+ KindMethodCallExpression: "MethodCallExpression",
84
+ KindParenthesizedExpression: "ParenthesizedExpression",
85
+ KindNone: "None",
86
+ KindNilLiteral: "NilLiteral",
87
+ KindFalseLiteral: "FalseLiteral",
88
+ KindTrueLiteral: "TrueLiteral",
89
+ KindNumberLiteral: "NumberLiteral",
90
+ KindStringLiteral: "StringLiteral",
91
+ KindVarArgsLiteral: "VarArgsLiteral",
92
+ KindFunctionExpression: "FunctionExpression",
93
+ KindBinaryExpression: "BinaryExpression",
94
+ KindUnaryExpression: "UnaryExpression",
95
+ KindIfExpression: "IfExpression",
96
+ KindInterpolatedString: "InterpolatedString",
97
+ KindArray: "Array",
98
+ KindMap: "Map",
99
+ KindSet: "Set",
100
+ KindMixedTable: "LastExpression",
101
+ KindAssignment: "Assignment",
102
+ KindBreakStatement: "BreakStatement",
103
+ KindCallStatement: "CallStatement",
104
+ KindContinueStatement: "ContinueStatement",
105
+ KindDoStatement: "DoStatement",
106
+ KindWhileStatement: "WhileStatement",
107
+ KindRepeatStatement: "RepeatStatement",
108
+ KindIfStatement: "IfStatement",
109
+ KindNumericForStatement: "NumericForStatement",
110
+ KindForStatement: "ForStatement",
111
+ KindFunctionDeclaration: "FunctionDeclaration",
112
+ KindMethodDeclaration: "MethodDeclaration",
113
+ KindVariableDeclaration: "VariableDeclaration",
114
+ KindReturnStatement: "ReturnStatement",
115
+ KindComment: "Comment",
116
+ KindMapField: "MapField",
117
+ KindInterpolatedStringPart: "LastField",
118
+ }
119
+
120
+ // GetKindName returns the name upstream getKindName gives a kind, including
121
+ // its quirks ("LastExpression" for MixedTable, "LastField" for
122
+ // InterpolatedStringPart). Unknown kinds return "" (upstream: undefined).
123
+ func GetKindName(kind SyntaxKind) string {
124
+ if kind < 0 || int(kind) >= len(kindNames) {
125
+ return ""
126
+ }
127
+ return kindNames[kind]
128
+ }
package/luau/list.go ADDED
@@ -0,0 +1,227 @@
1
+ package luau
2
+
3
+ // Ported from src/LuauAST/impl/List.ts (namespace luau.list).
4
+ //
5
+ // A List is a doubly linked list of nodes. Like upstream, the helpers mutate
6
+ // and share list nodes, and several of them leave dangling links behind on
7
+ // purpose; see the comments on PushList, Shift and UnshiftList. Do not tidy
8
+ // these up: the transformer relies on the exact behavior.
9
+
10
+ // ListNode is one link of a List.
11
+ type ListNode struct {
12
+ Prev *ListNode
13
+ Next *ListNode
14
+ Value Node
15
+ }
16
+
17
+ // List is a doubly linked list of nodes (upstream luau.List<T>). The element
18
+ // type documented on each node field is not enforced.
19
+ type List struct {
20
+ Head *ListNode
21
+ Tail *ListNode
22
+ ReadOnly bool
23
+ }
24
+
25
+ func (*List) isNodeOrList() {}
26
+
27
+ // AsList reports whether v is a list (upstream luau.list.isList).
28
+ func AsList(v NodeOrList) (*List, bool) {
29
+ l, ok := v.(*List)
30
+ return l, ok
31
+ }
32
+
33
+ // IsList reports whether v is a list.
34
+ func IsList(v NodeOrList) bool {
35
+ _, ok := v.(*List)
36
+ return ok
37
+ }
38
+
39
+ // MakeListNode makes a detached list node (upstream list.makeNode).
40
+ func MakeListNode(value Node) *ListNode {
41
+ Assert(value != nil, "")
42
+ return &ListNode{Value: value}
43
+ }
44
+
45
+ // NewList makes an empty list.
46
+ func NewList() *List { return &List{} }
47
+
48
+ // MakeList makes a list holding values in order (upstream list.make).
49
+ func MakeList[T Node](values ...T) *List {
50
+ list := &List{}
51
+ if len(values) == 0 {
52
+ return list
53
+ }
54
+ for _, v := range values {
55
+ Assert(Node(v) != nil, "Not all List values were a luau.Node")
56
+ }
57
+ head := &ListNode{Value: values[0]}
58
+ tail := head
59
+ for i := 1; i < len(values); i++ {
60
+ node := &ListNode{Value: values[i]}
61
+ tail.Next = node
62
+ node.Prev = tail
63
+ tail = node
64
+ }
65
+ list.Head = head
66
+ list.Tail = tail
67
+ return list
68
+ }
69
+
70
+ // Clone returns a new list holding shallow clones of each element
71
+ // (upstream list.clone). The clones keep their old parent.
72
+ func (l *List) Clone() *List {
73
+ newList := NewList()
74
+ for node := l.Head; node != nil; node = node.Next {
75
+ newList.Push(node.Value.shallowClone())
76
+ }
77
+ return newList
78
+ }
79
+
80
+ // Push appends value.
81
+ func (l *List) Push(value Node) {
82
+ Assert(value != nil, "")
83
+ Assert(!l.ReadOnly, "")
84
+ node := &ListNode{Value: value}
85
+ if l.Tail != nil {
86
+ l.Tail.Next = node
87
+ node.Prev = l.Tail
88
+ } else {
89
+ l.Head = node
90
+ }
91
+ l.Tail = node
92
+ }
93
+
94
+ // PushList moves the nodes of other onto the end of l and marks other
95
+ // read-only. other keeps its Head and Tail, which now point into l's chain.
96
+ func (l *List) PushList(other *List) {
97
+ Assert(!l.ReadOnly, "")
98
+ Assert(!other.ReadOnly, "")
99
+ other.ReadOnly = true
100
+
101
+ if other.Head != nil && other.Tail != nil {
102
+ if l.Head != nil && l.Tail != nil {
103
+ l.Tail.Next = other.Head
104
+ other.Head.Prev = l.Tail
105
+ l.Tail = other.Tail
106
+ } else {
107
+ l.Head = other.Head
108
+ l.Tail = other.Tail
109
+ }
110
+ }
111
+ }
112
+
113
+ // Shift removes and returns the first value, or nil when empty. The removed
114
+ // list node keeps its Next pointer.
115
+ func (l *List) Shift() Node {
116
+ Assert(!l.ReadOnly, "")
117
+ if l.Head != nil {
118
+ head := l.Head
119
+ if head.Next != nil {
120
+ l.Head = head.Next
121
+ head.Next.Prev = nil
122
+ } else {
123
+ l.Tail = nil
124
+ l.Head = nil
125
+ }
126
+ return head.Value
127
+ }
128
+ return nil
129
+ }
130
+
131
+ // Unshift prepends value.
132
+ func (l *List) Unshift(value Node) {
133
+ Assert(value != nil, "")
134
+ Assert(!l.ReadOnly, "")
135
+ node := &ListNode{Value: value}
136
+ if l.Head != nil {
137
+ l.Head.Prev = node
138
+ node.Next = l.Head
139
+ } else {
140
+ l.Tail = node
141
+ }
142
+ l.Head = node
143
+ }
144
+
145
+ // UnshiftList moves the nodes of other onto the front of l and marks other
146
+ // read-only. other keeps its Head and Tail.
147
+ func (l *List) UnshiftList(other *List) {
148
+ Assert(!l.ReadOnly, "")
149
+ Assert(!other.ReadOnly, "")
150
+ other.ReadOnly = true
151
+
152
+ if other.Head != nil && other.Tail != nil {
153
+ if l.Head != nil && l.Tail != nil {
154
+ l.Head.Prev = other.Tail
155
+ other.Tail.Next = l.Head
156
+ l.Head = other.Head
157
+ } else {
158
+ l.Head = other.Head
159
+ l.Tail = other.Tail
160
+ }
161
+ }
162
+ }
163
+
164
+ func (l *List) IsEmpty() bool { return l.Head == nil }
165
+ func (l *List) IsNonEmpty() bool { return l.Head != nil }
166
+
167
+ // ForEach calls callback for each value, reading Next after each call so
168
+ // callbacks may append.
169
+ func (l *List) ForEach(callback func(value Node)) {
170
+ for node := l.Head; node != nil; node = node.Next {
171
+ callback(node.Value)
172
+ }
173
+ }
174
+
175
+ // ForEachListNode calls callback for each list node.
176
+ func (l *List) ForEachListNode(callback func(node *ListNode)) {
177
+ for node := l.Head; node != nil; node = node.Next {
178
+ callback(node)
179
+ }
180
+ }
181
+
182
+ // MapToArray maps each value through callback (upstream list.mapToArray).
183
+ func MapToArray[U any](l *List, callback func(value Node) U) []U {
184
+ result := make([]U, 0, l.Size())
185
+ for node := l.Head; node != nil; node = node.Next {
186
+ result = append(result, callback(node.Value))
187
+ }
188
+ return result
189
+ }
190
+
191
+ // ToArray returns the values as a slice.
192
+ func (l *List) ToArray() []Node {
193
+ result := make([]Node, 0, l.Size())
194
+ for node := l.Head; node != nil; node = node.Next {
195
+ result = append(result, node.Value)
196
+ }
197
+ return result
198
+ }
199
+
200
+ // Every reports whether callback holds for every value.
201
+ func (l *List) Every(callback func(value Node) bool) bool {
202
+ for node := l.Head; node != nil; node = node.Next {
203
+ if !callback(node.Value) {
204
+ return false
205
+ }
206
+ }
207
+ return true
208
+ }
209
+
210
+ // Some reports whether callback holds for any value.
211
+ func (l *List) Some(callback func(value Node) bool) bool {
212
+ for node := l.Head; node != nil; node = node.Next {
213
+ if callback(node.Value) {
214
+ return true
215
+ }
216
+ }
217
+ return false
218
+ }
219
+
220
+ // Size counts the nodes reachable from Head through Next.
221
+ func (l *List) Size() int {
222
+ size := 0
223
+ for node := l.Head; node != nil; node = node.Next {
224
+ size++
225
+ }
226
+ return size
227
+ }