@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,333 @@
1
+ package project
2
+
3
+ import (
4
+ "bytes"
5
+ "embed"
6
+ "errors"
7
+ "fmt"
8
+ "io/fs"
9
+ "os"
10
+ "slices"
11
+ "strings"
12
+
13
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/pathtranslator"
14
+ "github.com/microsoft/TypeScript/tsc/rbxtsgo/project/shared"
15
+ )
16
+
17
+ // The runtime files from the roblox-ts-3.0.0.tgz tarball, byte for byte. A test compares them to the pinned clone.
18
+ //
19
+ //go:embed include/*.lua
20
+ var includeFiles embed.FS
21
+
22
+ // copyFilter is the filter option of fs-extra's copySync.
23
+ type copyFilter func(src, dest string) (bool, error)
24
+
25
+ // copySync is fs-extra 11's copySync with { filter, dereference: true }, which is the only form the project uses.
26
+ func copySync(src, dest string, filter copyFilter) error {
27
+ destStat, err := checkPaths(src, dest)
28
+ if err != nil {
29
+ return err
30
+ }
31
+ srcStat, err := os.Stat(src)
32
+ if err != nil {
33
+ return err
34
+ }
35
+ if err := checkParentPaths(src, srcStat, dest); err != nil {
36
+ return err
37
+ }
38
+ if filter != nil {
39
+ include, err := filter(src, dest)
40
+ if err != nil {
41
+ return err
42
+ }
43
+ if !include {
44
+ return nil
45
+ }
46
+ }
47
+ if destParent := path.Dirname(dest); !exists(destParent) {
48
+ if err := os.MkdirAll(destParent, 0o777); err != nil {
49
+ return err
50
+ }
51
+ }
52
+ return copyStats(destStat, src, dest, filter)
53
+ }
54
+
55
+ // checkPaths is checkPathsSync. It returns dest's stat, or nil if dest doesn't exist.
56
+ func checkPaths(src, dest string) (fs.FileInfo, error) {
57
+ srcStat, err := os.Stat(src)
58
+ if err != nil {
59
+ return nil, err
60
+ }
61
+ destStat, err := os.Stat(dest)
62
+ if err != nil {
63
+ if errors.Is(err, fs.ErrNotExist) {
64
+ destStat = nil
65
+ } else {
66
+ return nil, err
67
+ }
68
+ }
69
+ if destStat != nil {
70
+ if os.SameFile(srcStat, destStat) {
71
+ return nil, errors.New("Source and destination must not be the same.")
72
+ }
73
+ if srcStat.IsDir() && !destStat.IsDir() {
74
+ return nil, fmt.Errorf("Cannot overwrite non-directory '%s' with directory '%s'.", dest, src)
75
+ }
76
+ if !srcStat.IsDir() && destStat.IsDir() {
77
+ return nil, fmt.Errorf("Cannot overwrite directory '%s' with non-directory '%s'.", dest, src)
78
+ }
79
+ }
80
+ if srcStat.IsDir() && isSrcSubdir(src, dest) {
81
+ return nil, fmt.Errorf("Cannot copy '%s' to a subdirectory of itself, '%s'.", src, dest)
82
+ }
83
+ return destStat, nil
84
+ }
85
+
86
+ // isSrcSubdir only compares path strings, like fs-extra.
87
+ func isSrcSubdir(src, dest string) bool {
88
+ split := func(p string) []string {
89
+ return slices.DeleteFunc(strings.Split(path.Resolve(p), path.Sep), func(part string) bool { return part == "" })
90
+ }
91
+ srcParts, destParts := split(src), split(dest)
92
+ for i, part := range srcParts {
93
+ if i >= len(destParts) || destParts[i] != part {
94
+ return false
95
+ }
96
+ }
97
+ return true
98
+ }
99
+
100
+ // checkParentPaths is checkParentPathsSync.
101
+ func checkParentPaths(src string, srcStat fs.FileInfo, dest string) error {
102
+ srcParent := path.Resolve(path.Dirname(src))
103
+ destParent := path.Resolve(path.Dirname(dest))
104
+ if destParent == srcParent || destParent == path.Dirname(destParent) {
105
+ return nil
106
+ }
107
+ destStat, err := os.Stat(destParent)
108
+ if err != nil {
109
+ if errors.Is(err, fs.ErrNotExist) {
110
+ return checkParentPaths(src, srcStat, destParent)
111
+ }
112
+ return err
113
+ }
114
+ if os.SameFile(srcStat, destStat) {
115
+ return fmt.Errorf("Cannot copy '%s' to a subdirectory of itself, '%s'.", src, dest)
116
+ }
117
+ return checkParentPaths(src, srcStat, destParent)
118
+ }
119
+
120
+ func copyStats(destStat fs.FileInfo, src, dest string, filter copyFilter) error {
121
+ srcStat, err := os.Stat(src)
122
+ if err != nil {
123
+ return err
124
+ }
125
+ if srcStat.IsDir() {
126
+ if destStat == nil {
127
+ if err := os.Mkdir(dest, 0o777); err != nil {
128
+ return err
129
+ }
130
+ if err := copyDir(src, dest, filter); err != nil {
131
+ return err
132
+ }
133
+ return os.Chmod(dest, srcStat.Mode().Perm())
134
+ }
135
+ return copyDir(src, dest, filter)
136
+ }
137
+ if destStat != nil {
138
+ if err := os.Remove(dest); err != nil {
139
+ return err
140
+ }
141
+ }
142
+ data, err := os.ReadFile(src)
143
+ if err != nil {
144
+ return err
145
+ }
146
+ if err := os.WriteFile(dest, data, srcStat.Mode().Perm()); err != nil {
147
+ return err
148
+ }
149
+ return os.Chmod(dest, srcStat.Mode().Perm())
150
+ }
151
+
152
+ func copyDir(src, dest string, filter copyFilter) error {
153
+ entries, err := os.ReadDir(src)
154
+ if err != nil {
155
+ return err
156
+ }
157
+ for _, entry := range entries {
158
+ srcItem := path.Join(src, entry.Name())
159
+ destItem := path.Join(dest, entry.Name())
160
+ if filter != nil {
161
+ include, err := filter(srcItem, destItem)
162
+ if err != nil {
163
+ return err
164
+ }
165
+ if !include {
166
+ continue
167
+ }
168
+ }
169
+ destStat, err := checkPaths(srcItem, destItem)
170
+ if err != nil {
171
+ return err
172
+ }
173
+ if err := copyStats(destStat, srcItem, destItem, filter); err != nil {
174
+ return err
175
+ }
176
+ }
177
+ return nil
178
+ }
179
+
180
+ // CopyItem is copyItem.
181
+ func CopyItem(data *shared.ProjectData, translator *pathtranslator.Translator, item string) error {
182
+ return copySync(item, translator.GetOutputPath(item), func(src, dest string) (bool, error) {
183
+ if data.ProjectOptions.WriteOnlyChanged && exists(dest) {
184
+ info, err := os.Lstat(src)
185
+ if err != nil {
186
+ return false, err
187
+ }
188
+ if !info.IsDir() {
189
+ // Upstream compares the two decoded as UTF-8. Bytes can only differ from that on invalid UTF-8.
190
+ srcData, err := os.ReadFile(src)
191
+ if err != nil {
192
+ return false, err
193
+ }
194
+ destData, err := os.ReadFile(dest)
195
+ if err != nil {
196
+ return false, err
197
+ }
198
+ if bytes.Equal(srcData, destData) {
199
+ return false, nil
200
+ }
201
+ }
202
+ }
203
+ if strings.HasSuffix(src, shared.DTSExt) {
204
+ return translator.Declaration, nil
205
+ }
206
+ compilable, err := IsCompilableFile(src)
207
+ if err != nil {
208
+ return false, err
209
+ }
210
+ return !compilable, nil
211
+ })
212
+ }
213
+
214
+ // CopyFiles is copyFiles.
215
+ func CopyFiles(data *shared.ProjectData, translator *pathtranslator.Translator, sources []string) error {
216
+ for _, source := range sources {
217
+ if err := CopyItem(data, translator, source); err != nil {
218
+ return err
219
+ }
220
+ }
221
+ return nil
222
+ }
223
+
224
+ // CopyInclude is copyInclude: it copies RuntimeLib.lua and Promise.lua to the include path.
225
+ func CopyInclude(data *shared.ProjectData) error {
226
+ options := data.ProjectOptions
227
+ if options.NoInclude || options.Type == shared.ProjectTypePackage || (options.Type == "" && data.IsPackage) {
228
+ return nil
229
+ }
230
+ if err := os.MkdirAll(options.IncludePath, 0o777); err != nil {
231
+ return err
232
+ }
233
+ entries, err := includeFiles.ReadDir("include")
234
+ if err != nil {
235
+ return err
236
+ }
237
+ for _, entry := range entries {
238
+ contents, err := includeFiles.ReadFile("include/" + entry.Name())
239
+ if err != nil {
240
+ return err
241
+ }
242
+ dest := path.Join(options.IncludePath, entry.Name())
243
+ if exists(dest) {
244
+ if err := os.Remove(dest); err != nil {
245
+ return err
246
+ }
247
+ }
248
+ if err := os.WriteFile(dest, contents, 0o666); err != nil {
249
+ return err
250
+ }
251
+ }
252
+ return nil
253
+ }
254
+
255
+ func isOutputFileOrphaned(translator *pathtranslator.Translator, filePath string) bool {
256
+ if strings.HasSuffix(filePath, shared.DTSExt) && !translator.Declaration {
257
+ return true
258
+ }
259
+ if slices.ContainsFunc(translator.GetInputPaths(filePath), exists) {
260
+ return false
261
+ }
262
+ return translator.BuildInfoOutputPath != filePath
263
+ }
264
+
265
+ // TryRemoveOutput is tryRemoveOutput.
266
+ func TryRemoveOutput(translator *pathtranslator.Translator, outPath string) error {
267
+ if isOutputFileOrphaned(translator, outPath) {
268
+ if err := os.RemoveAll(outPath); err != nil {
269
+ return err
270
+ }
271
+ shared.LogService.WriteLineIfVerbose("remove " + outPath)
272
+ }
273
+ return nil
274
+ }
275
+
276
+ func cleanupDirRecursively(translator *pathtranslator.Translator, dir string) error {
277
+ if !exists(dir) {
278
+ return nil
279
+ }
280
+ entries, err := os.ReadDir(dir)
281
+ if err != nil {
282
+ return err
283
+ }
284
+ for _, entry := range entries {
285
+ itemPath := path.Join(dir, entry.Name())
286
+ info, err := os.Stat(itemPath)
287
+ if err != nil {
288
+ return err
289
+ }
290
+ if info.IsDir() {
291
+ if entry.Name() == ".git" {
292
+ continue
293
+ }
294
+ if err := cleanupDirRecursively(translator, itemPath); err != nil {
295
+ return err
296
+ }
297
+ }
298
+ if err := TryRemoveOutput(translator, itemPath); err != nil {
299
+ return err
300
+ }
301
+ }
302
+ return nil
303
+ }
304
+
305
+ // Cleanup is cleanup.
306
+ func Cleanup(translator *pathtranslator.Translator) error {
307
+ return cleanupDirRecursively(translator, translator.OutDir)
308
+ }
309
+
310
+ // WalkDirectory is walkDirectorySync: breadth first, calling back for each descendant.
311
+ func WalkDirectory(dir string, callback func(fsPath string) error) error {
312
+ queue := []string{dir}
313
+ for i := 0; i < len(queue); i++ {
314
+ entries, err := os.ReadDir(queue[i])
315
+ if err != nil {
316
+ return err
317
+ }
318
+ for _, entry := range entries {
319
+ fsPath := path.Join(queue[i], entry.Name())
320
+ if err := callback(fsPath); err != nil {
321
+ return err
322
+ }
323
+ info, err := os.Stat(fsPath)
324
+ if err != nil {
325
+ return err
326
+ }
327
+ if info.IsDir() {
328
+ queue = append(queue, fsPath)
329
+ }
330
+ }
331
+ }
332
+ return nil
333
+ }