@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,248 @@
1
+ package rojoresolver
2
+
3
+ import (
4
+ "encoding/json"
5
+ "errors"
6
+ "io"
7
+ "math"
8
+ "slices"
9
+ "strconv"
10
+ "strings"
11
+ )
12
+
13
+ // object is a parsed JSON object that keeps JavaScript's property order, because Object.keys decides the order
14
+ // the tree is walked in, which decides partition order and which mapping wins. encoding/json maps can't do that.
15
+ type object struct {
16
+ keys []string
17
+ values map[string]any
18
+ }
19
+
20
+ func (o *object) get(key string) (any, bool) {
21
+ value, ok := o.values[key]
22
+ return value, ok
23
+ }
24
+
25
+ func (o *object) set(key string, value any) {
26
+ if _, exists := o.values[key]; !exists {
27
+ o.keys = append(o.keys, key)
28
+ }
29
+ o.values[key] = value
30
+ }
31
+
32
+ // isArrayIndex reports whether key is a canonical array index, which JS objects list first, ascending.
33
+ func isArrayIndex(key string) (uint32, bool) {
34
+ value, err := strconv.ParseUint(key, 10, 32)
35
+ if err != nil || value == math.MaxUint32 || strconv.FormatUint(value, 10) != key {
36
+ return 0, false
37
+ }
38
+ return uint32(value), true
39
+ }
40
+
41
+ // orderKeys puts array index keys first, ascending, as Object.keys does.
42
+ func (o *object) orderKeys() {
43
+ var indexes []string
44
+ var names []string
45
+ for _, key := range o.keys {
46
+ if _, ok := isArrayIndex(key); ok {
47
+ indexes = append(indexes, key)
48
+ } else {
49
+ names = append(names, key)
50
+ }
51
+ }
52
+ slices.SortFunc(indexes, func(a, b string) int {
53
+ x, _ := isArrayIndex(a)
54
+ y, _ := isArrayIndex(b)
55
+ return int(int64(x) - int64(y))
56
+ })
57
+ o.keys = append(indexes, names...)
58
+ }
59
+
60
+ // parseJSON parses like JSON.parse: objects become *object, arrays []any, numbers json.Number.
61
+ func parseJSON(text string) (any, error) {
62
+ decoder := json.NewDecoder(strings.NewReader(text))
63
+ decoder.UseNumber()
64
+ value, err := parseValue(decoder)
65
+ if err != nil {
66
+ return nil, err
67
+ }
68
+ if _, err := decoder.Token(); !errors.Is(err, io.EOF) {
69
+ return nil, errors.New("unexpected data after JSON value")
70
+ }
71
+ return value, nil
72
+ }
73
+
74
+ func parseValue(decoder *json.Decoder) (any, error) {
75
+ token, err := decoder.Token()
76
+ if err != nil {
77
+ return nil, err
78
+ }
79
+ delim, isDelim := token.(json.Delim)
80
+ if !isDelim {
81
+ return token, nil
82
+ }
83
+ switch delim {
84
+ case '{':
85
+ result := &object{values: map[string]any{}}
86
+ for decoder.More() {
87
+ keyToken, err := decoder.Token()
88
+ if err != nil {
89
+ return nil, err
90
+ }
91
+ value, err := parseValue(decoder)
92
+ if err != nil {
93
+ return nil, err
94
+ }
95
+ result.set(keyToken.(string), value)
96
+ }
97
+ if _, err := decoder.Token(); err != nil {
98
+ return nil, err
99
+ }
100
+ result.orderKeys()
101
+ return result, nil
102
+ case '[':
103
+ result := []any{}
104
+ for decoder.More() {
105
+ value, err := parseValue(decoder)
106
+ if err != nil {
107
+ return nil, err
108
+ }
109
+ result = append(result, value)
110
+ }
111
+ if _, err := decoder.Token(); err != nil {
112
+ return nil, err
113
+ }
114
+ return result, nil
115
+ }
116
+ return nil, errors.New("unexpected JSON delimiter")
117
+ }
118
+
119
+ // validationError is one entry of ajv's errors array, as errorsText prints it.
120
+ type validationError struct {
121
+ instancePath string
122
+ message string
123
+ }
124
+
125
+ // errorsText is ajv.errorsText with default options.
126
+ func errorsText(errs []validationError) string {
127
+ parts := make([]string, len(errs))
128
+ for i, err := range errs {
129
+ parts[i] = "data" + err.instancePath + " " + err.message
130
+ }
131
+ return strings.Join(parts, ", ")
132
+ }
133
+
134
+ func isString(value any) bool {
135
+ _, ok := value.(string)
136
+ return ok
137
+ }
138
+
139
+ func isBool(value any) bool {
140
+ _, ok := value.(bool)
141
+ return ok
142
+ }
143
+
144
+ func isObject(value any) bool {
145
+ _, ok := value.(*object)
146
+ return ok
147
+ }
148
+
149
+ // isInteger follows ajv's integer check: a finite number with no fractional part.
150
+ func isInteger(value any) bool {
151
+ number, ok := value.(json.Number)
152
+ if !ok {
153
+ return false
154
+ }
155
+ parsed, err := strconv.ParseFloat(number.String(), 64)
156
+ if err != nil || math.IsInf(parsed, 0) || math.IsNaN(parsed) {
157
+ return false
158
+ }
159
+ return math.Mod(parsed, 1) == 0
160
+ }
161
+
162
+ // validateRojoConfig is a hand port of what ajv generates for rojo-schema.json. Ajv stops at the first failing
163
+ // keyword, except inside anyOf, where it keeps the errors of each branch. The order of checks here decides which
164
+ // error is reported, so it follows ajv's: type, required, then properties in schema order, then patternProperties.
165
+ // The tests compare it with real ajv.
166
+ func validateRojoConfig(data any) []validationError {
167
+ root, ok := data.(*object)
168
+ if !ok {
169
+ return []validationError{{"", "must be object"}}
170
+ }
171
+ for _, name := range []string{"name", "tree"} {
172
+ if _, exists := root.get(name); !exists {
173
+ return []validationError{{"", "must have required property '" + name + "'"}}
174
+ }
175
+ }
176
+ if !isString(root.values["name"]) {
177
+ return []validationError{{"/name", "must be string"}}
178
+ }
179
+ if port, exists := root.get("servePort"); exists && !isInteger(port) {
180
+ return []validationError{{"/servePort", "must be integer"}}
181
+ }
182
+ return validateTree(root.values["tree"], "/tree")
183
+ }
184
+
185
+ func validateTree(data any, path string) []validationError {
186
+ tree, ok := data.(*object)
187
+ if !ok {
188
+ return []validationError{{path, "must be object"}}
189
+ }
190
+ if value, exists := tree.get("$className"); exists && !isString(value) {
191
+ return []validationError{{path + "/$className", "must be string"}}
192
+ }
193
+ if value, exists := tree.get("$ignoreUnknownInstances"); exists && !isBool(value) {
194
+ return []validationError{{path + "/$ignoreUnknownInstances", "must be boolean"}}
195
+ }
196
+ if value, exists := tree.get("$path"); exists {
197
+ if errs := validatePath(value, path+"/$path"); errs != nil {
198
+ return errs
199
+ }
200
+ }
201
+ if value, exists := tree.get("$properties"); exists && !isObject(value) {
202
+ return []validationError{{path + "/$properties", "must be object"}}
203
+ }
204
+ for _, key := range tree.keys {
205
+ if matchesChildPattern(key) {
206
+ if errs := validateTree(tree.values[key], path+"/"+escapeJSONPointer(key)); errs != nil {
207
+ return errs
208
+ }
209
+ }
210
+ }
211
+ return nil
212
+ }
213
+
214
+ func validatePath(value any, path string) []validationError {
215
+ if isString(value) {
216
+ return nil
217
+ }
218
+ errs := []validationError{{path, "must be string"}}
219
+ if object, ok := value.(*object); ok {
220
+ optional, exists := object.get("optional")
221
+ if !exists || isString(optional) {
222
+ return nil
223
+ }
224
+ errs = append(errs, validationError{path + "/optional", "must be string"})
225
+ } else {
226
+ errs = append(errs, validationError{path, "must be object"})
227
+ }
228
+ return append(errs, validationError{path, "must match a schema in anyOf"})
229
+ }
230
+
231
+ // matchesChildPattern is the regex ^[^\$].*$ with the u flag: a first character that isn't $, then no line
232
+ // terminators after it, because . doesn't match those.
233
+ func matchesChildPattern(key string) bool {
234
+ runes := []rune(key)
235
+ if len(runes) == 0 || runes[0] == '$' {
236
+ return false
237
+ }
238
+ for _, r := range runes[1:] {
239
+ if r == '\n' || r == '\r' || r == '
' || r == '
' {
240
+ return false
241
+ }
242
+ }
243
+ return true
244
+ }
245
+
246
+ func escapeJSONPointer(key string) string {
247
+ return strings.ReplaceAll(strings.ReplaceAll(key, "~", "~0"), "/", "~1")
248
+ }