mt-lang 0.2.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 (258) hide show
  1. checksums.yaml +7 -0
  2. data/.ruby-version +1 -0
  3. data/AUTHORS +3 -0
  4. data/Gemfile +19 -0
  5. data/Gemfile.lock +82 -0
  6. data/LICENSE +21 -0
  7. data/README.md +1208 -0
  8. data/Rakefile +332 -0
  9. data/bin/mtc +8 -0
  10. data/bin/profile-mtc-checks +133 -0
  11. data/bin/tracy-profiler +0 -0
  12. data/docs/build-guide.md +536 -0
  13. data/docs/index.html +2778 -0
  14. data/docs/language-design.md +1519 -0
  15. data/docs/language-manual.md +1534 -0
  16. data/lib/milk_tea/base.rb +49 -0
  17. data/lib/milk_tea/bindings/bindgen/ast_parser.rb +398 -0
  18. data/lib/milk_tea/bindings/bindgen/declaration.rb +319 -0
  19. data/lib/milk_tea/bindings/bindgen/emitter.rb +387 -0
  20. data/lib/milk_tea/bindings/bindgen/overrides.rb +134 -0
  21. data/lib/milk_tea/bindings/bindgen/type_mapper.rb +622 -0
  22. data/lib/milk_tea/bindings/bindgen.rb +207 -0
  23. data/lib/milk_tea/bindings/cli.rb +121 -0
  24. data/lib/milk_tea/bindings/imported_bindings/defaults.rb +210 -0
  25. data/lib/milk_tea/bindings/imported_bindings/generator.rb +1114 -0
  26. data/lib/milk_tea/bindings/imported_bindings/method_source.rb +190 -0
  27. data/lib/milk_tea/bindings/imported_bindings/naming.rb +286 -0
  28. data/lib/milk_tea/bindings/imported_bindings.rb +215 -0
  29. data/lib/milk_tea/bindings/opengl_registry.rb +547 -0
  30. data/lib/milk_tea/bindings/raw_bindings/defaults.rb +1338 -0
  31. data/lib/milk_tea/bindings/raw_bindings.rb +269 -0
  32. data/lib/milk_tea/bindings/steamworks.rb +629 -0
  33. data/lib/milk_tea/bindings/upstream_sources.rb +352 -0
  34. data/lib/milk_tea/bindings/vendored_box2d.rb +79 -0
  35. data/lib/milk_tea/bindings/vendored_c_library.rb +322 -0
  36. data/lib/milk_tea/bindings/vendored_cjson.rb +52 -0
  37. data/lib/milk_tea/bindings/vendored_flecs.rb +78 -0
  38. data/lib/milk_tea/bindings/vendored_glfw.rb +77 -0
  39. data/lib/milk_tea/bindings/vendored_libuv.rb +75 -0
  40. data/lib/milk_tea/bindings/vendored_pcre2.rb +84 -0
  41. data/lib/milk_tea/bindings/vendored_raylib.rb +131 -0
  42. data/lib/milk_tea/bindings/vendored_sdl3.rb +78 -0
  43. data/lib/milk_tea/bindings/vendored_steamworks.rb +71 -0
  44. data/lib/milk_tea/bindings/vendored_tool.rb +71 -0
  45. data/lib/milk_tea/bindings/vendored_tools.rb +23 -0
  46. data/lib/milk_tea/bindings/vendored_tracy.rb +37 -0
  47. data/lib/milk_tea/bindings.rb +23 -0
  48. data/lib/milk_tea/core/ast.rb +311 -0
  49. data/lib/milk_tea/core/async_runtime_installer.rb +28 -0
  50. data/lib/milk_tea/core/binding_types.rb +18 -0
  51. data/lib/milk_tea/core/bindings/attribute_binding.rb +58 -0
  52. data/lib/milk_tea/core/bindings/function_binding.rb +5 -0
  53. data/lib/milk_tea/core/bindings/module_binding.rb +58 -0
  54. data/lib/milk_tea/core/bindings/value_binding.rb +21 -0
  55. data/lib/milk_tea/core/c_backend/aggregate_utils.rb +103 -0
  56. data/lib/milk_tea/core/c_backend/control_flow_emission.rb +412 -0
  57. data/lib/milk_tea/core/c_backend/expressions.rb +468 -0
  58. data/lib/milk_tea/core/c_backend/feature_detection.rb +483 -0
  59. data/lib/milk_tea/core/c_backend/reachability.rb +398 -0
  60. data/lib/milk_tea/core/c_backend/reinterpret.rb +226 -0
  61. data/lib/milk_tea/core/c_backend/runtime_helpers.rb +1080 -0
  62. data/lib/milk_tea/core/c_backend/statements.rb +563 -0
  63. data/lib/milk_tea/core/c_backend/type_collectors.rb +1545 -0
  64. data/lib/milk_tea/core/c_backend/type_declaration.rb +223 -0
  65. data/lib/milk_tea/core/c_backend/type_system.rb +345 -0
  66. data/lib/milk_tea/core/c_backend.rb +287 -0
  67. data/lib/milk_tea/core/compatibility_helpers.rb +79 -0
  68. data/lib/milk_tea/core/compile_time/const_eval.rb +187 -0
  69. data/lib/milk_tea/core/compile_time.rb +329 -0
  70. data/lib/milk_tea/core/control_flow/builder.rb +582 -0
  71. data/lib/milk_tea/core/control_flow/constant_propagation.rb +143 -0
  72. data/lib/milk_tea/core/control_flow/dataflow.rb +74 -0
  73. data/lib/milk_tea/core/control_flow/definite_assignment.rb +79 -0
  74. data/lib/milk_tea/core/control_flow/graph.rb +90 -0
  75. data/lib/milk_tea/core/control_flow/liveness.rb +24 -0
  76. data/lib/milk_tea/core/control_flow/nullability_flow.rb +43 -0
  77. data/lib/milk_tea/core/control_flow/reachability.rb +22 -0
  78. data/lib/milk_tea/core/control_flow/termination.rb +31 -0
  79. data/lib/milk_tea/core/control_flow.rb +34 -0
  80. data/lib/milk_tea/core/cst.rb +48 -0
  81. data/lib/milk_tea/core/cst_builder.rb +19 -0
  82. data/lib/milk_tea/core/ir.rb +85 -0
  83. data/lib/milk_tea/core/keywords.rb +97 -0
  84. data/lib/milk_tea/core/lexer/character_classes.rb +60 -0
  85. data/lib/milk_tea/core/lexer/format_strings.rb +225 -0
  86. data/lib/milk_tea/core/lexer/heredocs.rb +199 -0
  87. data/lib/milk_tea/core/lexer/indentation.rb +62 -0
  88. data/lib/milk_tea/core/lexer/numbers.rb +96 -0
  89. data/lib/milk_tea/core/lexer/recovery.rb +32 -0
  90. data/lib/milk_tea/core/lexer/strings.rb +167 -0
  91. data/lib/milk_tea/core/lexer/symbols.rb +71 -0
  92. data/lib/milk_tea/core/lexer/trivia.rb +53 -0
  93. data/lib/milk_tea/core/lexer.rb +430 -0
  94. data/lib/milk_tea/core/lowering/artifacts.rb +26 -0
  95. data/lib/milk_tea/core/lowering/async/analysis.rb +245 -0
  96. data/lib/milk_tea/core/lowering/async/lowering.rb +1399 -0
  97. data/lib/milk_tea/core/lowering/async/normalization.rb +459 -0
  98. data/lib/milk_tea/core/lowering/async.rb +714 -0
  99. data/lib/milk_tea/core/lowering/block.rb +1052 -0
  100. data/lib/milk_tea/core/lowering/calls.rb +1565 -0
  101. data/lib/milk_tea/core/lowering/declarations.rb +214 -0
  102. data/lib/milk_tea/core/lowering/dyn.rb +206 -0
  103. data/lib/milk_tea/core/lowering/events.rb +1054 -0
  104. data/lib/milk_tea/core/lowering/expressions.rb +1645 -0
  105. data/lib/milk_tea/core/lowering/foreign_cstr.rb +206 -0
  106. data/lib/milk_tea/core/lowering/functions.rb +242 -0
  107. data/lib/milk_tea/core/lowering/loops.rb +1087 -0
  108. data/lib/milk_tea/core/lowering/lowering_context.rb +80 -0
  109. data/lib/milk_tea/core/lowering/proc.rb +419 -0
  110. data/lib/milk_tea/core/lowering/resolve.rb +2516 -0
  111. data/lib/milk_tea/core/lowering/scans.rb +220 -0
  112. data/lib/milk_tea/core/lowering/str_buffer.rb +125 -0
  113. data/lib/milk_tea/core/lowering/utils.rb +1453 -0
  114. data/lib/milk_tea/core/lowering.rb +378 -0
  115. data/lib/milk_tea/core/module_binder.rb +181 -0
  116. data/lib/milk_tea/core/module_loader/errors.rb +21 -0
  117. data/lib/milk_tea/core/module_loader.rb +479 -0
  118. data/lib/milk_tea/core/module_path_resolver.rb +153 -0
  119. data/lib/milk_tea/core/module_roots.rb +88 -0
  120. data/lib/milk_tea/core/parser/attributes.rb +71 -0
  121. data/lib/milk_tea/core/parser/blocks.rb +119 -0
  122. data/lib/milk_tea/core/parser/declarations.rb +749 -0
  123. data/lib/milk_tea/core/parser/expressions.rb +624 -0
  124. data/lib/milk_tea/core/parser/recovery.rb +131 -0
  125. data/lib/milk_tea/core/parser/statements.rb +756 -0
  126. data/lib/milk_tea/core/parser/types.rb +271 -0
  127. data/lib/milk_tea/core/parser.rb +400 -0
  128. data/lib/milk_tea/core/prelude_installer.rb +29 -0
  129. data/lib/milk_tea/core/pretty_printer/ast_formatter.rb +917 -0
  130. data/lib/milk_tea/core/pretty_printer/base_formatter.rb +87 -0
  131. data/lib/milk_tea/core/pretty_printer/ir_formatter.rb +300 -0
  132. data/lib/milk_tea/core/pretty_printer.rb +17 -0
  133. data/lib/milk_tea/core/semantic_analyzer/analysis_context.rb +314 -0
  134. data/lib/milk_tea/core/semantic_analyzer/attributes.rb +184 -0
  135. data/lib/milk_tea/core/semantic_analyzer/calls.rb +992 -0
  136. data/lib/milk_tea/core/semantic_analyzer/expressions.rb +1735 -0
  137. data/lib/milk_tea/core/semantic_analyzer/flow_refinement.rb +355 -0
  138. data/lib/milk_tea/core/semantic_analyzer/foreign_functions.rb +155 -0
  139. data/lib/milk_tea/core/semantic_analyzer/function_binding.rb +354 -0
  140. data/lib/milk_tea/core/semantic_analyzer/generics.rb +383 -0
  141. data/lib/milk_tea/core/semantic_analyzer/interface_conformance.rb +78 -0
  142. data/lib/milk_tea/core/semantic_analyzer/module_context.rb +35 -0
  143. data/lib/milk_tea/core/semantic_analyzer/name_resolution.rb +1438 -0
  144. data/lib/milk_tea/core/semantic_analyzer/nullability.rb +421 -0
  145. data/lib/milk_tea/core/semantic_analyzer/statements.rb +1308 -0
  146. data/lib/milk_tea/core/semantic_analyzer/top_level.rb +588 -0
  147. data/lib/milk_tea/core/semantic_analyzer/type_compatibility.rb +307 -0
  148. data/lib/milk_tea/core/semantic_analyzer/type_declaration.rb +851 -0
  149. data/lib/milk_tea/core/semantic_analyzer.rb +327 -0
  150. data/lib/milk_tea/core/token.rb +26 -0
  151. data/lib/milk_tea/core/token_stream.rb +30 -0
  152. data/lib/milk_tea/core/types/layout.rb +243 -0
  153. data/lib/milk_tea/core/types/predicates.rb +609 -0
  154. data/lib/milk_tea/core/types/registry.rb +83 -0
  155. data/lib/milk_tea/core/types/types.rb +1696 -0
  156. data/lib/milk_tea/core/types/visitor.rb +442 -0
  157. data/lib/milk_tea/core.rb +25 -0
  158. data/lib/milk_tea/dap/backends/lldb_dap.rb +158 -0
  159. data/lib/milk_tea/dap/protocol.rb +58 -0
  160. data/lib/milk_tea/dap/server/breakpoints.rb +66 -0
  161. data/lib/milk_tea/dap/server/debug_map.rb +291 -0
  162. data/lib/milk_tea/dap/server/handlers.rb +374 -0
  163. data/lib/milk_tea/dap/server/launch.rb +261 -0
  164. data/lib/milk_tea/dap/server/lldb_backend.rb +380 -0
  165. data/lib/milk_tea/dap/server/pause_diagnostics.rb +109 -0
  166. data/lib/milk_tea/dap/server/utilities.rb +160 -0
  167. data/lib/milk_tea/dap/server/wire.rb +55 -0
  168. data/lib/milk_tea/dap/server.rb +131 -0
  169. data/lib/milk_tea/dap/session.rb +152 -0
  170. data/lib/milk_tea/dap.rb +6 -0
  171. data/lib/milk_tea/lsp/dependency_resolution.rb +52 -0
  172. data/lib/milk_tea/lsp/diagnostics.rb +611 -0
  173. data/lib/milk_tea/lsp/protocol.rb +104 -0
  174. data/lib/milk_tea/lsp/server/call_hierarchy.rb +274 -0
  175. data/lib/milk_tea/lsp/server/code_actions.rb +446 -0
  176. data/lib/milk_tea/lsp/server/code_lens.rb +97 -0
  177. data/lib/milk_tea/lsp/server/completion.rb +1099 -0
  178. data/lib/milk_tea/lsp/server/configuration.rb +167 -0
  179. data/lib/milk_tea/lsp/server/debug_info.rb +45 -0
  180. data/lib/milk_tea/lsp/server/definition.rb +779 -0
  181. data/lib/milk_tea/lsp/server/diagnostics_scheduling.rb +239 -0
  182. data/lib/milk_tea/lsp/server/execute_command.rb +25 -0
  183. data/lib/milk_tea/lsp/server/folding_range.rb +153 -0
  184. data/lib/milk_tea/lsp/server/formatting.rb +575 -0
  185. data/lib/milk_tea/lsp/server/hover.rb +1465 -0
  186. data/lib/milk_tea/lsp/server/inlay_hints.rb +204 -0
  187. data/lib/milk_tea/lsp/server/lifecycle.rb +234 -0
  188. data/lib/milk_tea/lsp/server/linked_editing_range.rb +43 -0
  189. data/lib/milk_tea/lsp/server/on_type_formatting.rb +73 -0
  190. data/lib/milk_tea/lsp/server/progress.rb +47 -0
  191. data/lib/milk_tea/lsp/server/references.rb +433 -0
  192. data/lib/milk_tea/lsp/server/rename.rb +598 -0
  193. data/lib/milk_tea/lsp/server/selection_range.rb +130 -0
  194. data/lib/milk_tea/lsp/server/semantic_tokens.rb +1745 -0
  195. data/lib/milk_tea/lsp/server/signature_help.rb +200 -0
  196. data/lib/milk_tea/lsp/server/text_documents.rb +125 -0
  197. data/lib/milk_tea/lsp/server/type_hierarchy.rb +167 -0
  198. data/lib/milk_tea/lsp/server/utilities.rb +520 -0
  199. data/lib/milk_tea/lsp/server.rb +415 -0
  200. data/lib/milk_tea/lsp/workspace/analysis.rb +209 -0
  201. data/lib/milk_tea/lsp/workspace/caches.rb +260 -0
  202. data/lib/milk_tea/lsp/workspace/collection.rb +98 -0
  203. data/lib/milk_tea/lsp/workspace/definition_index.rb +184 -0
  204. data/lib/milk_tea/lsp/workspace/dependency_graph.rb +282 -0
  205. data/lib/milk_tea/lsp/workspace/store.rb +154 -0
  206. data/lib/milk_tea/lsp/workspace/utilities.rb +490 -0
  207. data/lib/milk_tea/lsp/workspace.rb +127 -0
  208. data/lib/milk_tea/lsp.rb +13 -0
  209. data/lib/milk_tea/packages/atomic_write.rb +63 -0
  210. data/lib/milk_tea/packages/dependency_solver.rb +194 -0
  211. data/lib/milk_tea/packages/graph.rb +139 -0
  212. data/lib/milk_tea/packages/lock.rb +421 -0
  213. data/lib/milk_tea/packages/manager_cli.rb +485 -0
  214. data/lib/milk_tea/packages/manifest.rb +356 -0
  215. data/lib/milk_tea/packages/manifest_editor.rb +134 -0
  216. data/lib/milk_tea/packages/registry_metadata_provider.rb +34 -0
  217. data/lib/milk_tea/packages/registry_store.rb +420 -0
  218. data/lib/milk_tea/packages/services.rb +41 -0
  219. data/lib/milk_tea/packages/source_cache.rb +71 -0
  220. data/lib/milk_tea/packages/source_fetcher.rb +124 -0
  221. data/lib/milk_tea/packages/source_resolver.rb +389 -0
  222. data/lib/milk_tea/packages/version.rb +164 -0
  223. data/lib/milk_tea/packages.rb +16 -0
  224. data/lib/milk_tea/tooling/asset_pack.rb +141 -0
  225. data/lib/milk_tea/tooling/build.rb +1124 -0
  226. data/lib/milk_tea/tooling/build_cache.rb +240 -0
  227. data/lib/milk_tea/tooling/cli.rb +2688 -0
  228. data/lib/milk_tea/tooling/cst_formatter.rb +13 -0
  229. data/lib/milk_tea/tooling/debug_info_formatter.rb +456 -0
  230. data/lib/milk_tea/tooling/debug_map.rb +248 -0
  231. data/lib/milk_tea/tooling/docs_app.rb +369 -0
  232. data/lib/milk_tea/tooling/error_formatter.rb +86 -0
  233. data/lib/milk_tea/tooling/formatter.rb +787 -0
  234. data/lib/milk_tea/tooling/linter/doc_tags.rb +212 -0
  235. data/lib/milk_tea/tooling/linter/fix_engine.rb +237 -0
  236. data/lib/milk_tea/tooling/linter/flow_rules.rb +380 -0
  237. data/lib/milk_tea/tooling/linter/imports_platform.rb +841 -0
  238. data/lib/milk_tea/tooling/linter/release_rules.rb +744 -0
  239. data/lib/milk_tea/tooling/linter/reserved_names.rb +199 -0
  240. data/lib/milk_tea/tooling/linter/rules.rb +593 -0
  241. data/lib/milk_tea/tooling/linter/source_helpers.rb +407 -0
  242. data/lib/milk_tea/tooling/linter/trailing_comma.rb +139 -0
  243. data/lib/milk_tea/tooling/linter/visitors.rb +1286 -0
  244. data/lib/milk_tea/tooling/linter.rb +798 -0
  245. data/lib/milk_tea/tooling/project_scaffold.rb +82 -0
  246. data/lib/milk_tea/tooling/public/css/docs.css +166 -0
  247. data/lib/milk_tea/tooling/public/js/docs.js +94 -0
  248. data/lib/milk_tea/tooling/run.rb +408 -0
  249. data/lib/milk_tea/tooling/templates/wasm_shell.html +48 -0
  250. data/lib/milk_tea/tooling/toolchain_cli.rb +157 -0
  251. data/lib/milk_tea/tooling/views/404.erb +7 -0
  252. data/lib/milk_tea/tooling/views/index.erb +87 -0
  253. data/lib/milk_tea/tooling/views/layout.erb +69 -0
  254. data/lib/milk_tea/tooling/views/module.erb +97 -0
  255. data/lib/milk_tea/tooling/views/stdlib.erb +21 -0
  256. data/lib/milk_tea/tooling.rb +20 -0
  257. data/lib/milk_tea.rb +8 -0
  258. metadata +426 -0
@@ -0,0 +1,214 @@
1
+ # frozen_string_literal: true
2
+
3
+ module MilkTea
4
+ module LowererDeclarations
5
+ private
6
+
7
+ def expanded_declarations
8
+ @ctx.ast.declarations.flat_map do |decl|
9
+ case decl
10
+ when AST::WhenStmt
11
+ val = compile_time_const_value(decl.discriminant)
12
+ next [decl] if val.nil?
13
+
14
+ chosen = decl.branches.find { |b| val == compile_time_const_value(b.pattern) }
15
+ body = chosen ? chosen.body : (decl.else_body || [])
16
+ body
17
+ else
18
+ [decl]
19
+ end
20
+ end
21
+ end
22
+
23
+ def lower_constants
24
+ expanded_declarations.grep(AST::ConstDecl).filter_map do |decl|
25
+ type = @ctx.values.fetch(decl.name).type
26
+ const_value = @ctx.values.fetch(decl.name).const_value
27
+
28
+ next if type == Types::BUILTIN_TYPE_META_TYPE
29
+
30
+ if const_value && (decl.value.is_a?(AST::Call) || decl.value.is_a?(AST::Specialization))
31
+ value = lower_const_value_literal(type, const_value)
32
+ elsif const_value && (decl.block_body || decl.value.is_a?(AST::ExpressionList))
33
+ if const_value.is_a?(Array) && const_value.empty? && decl.value.is_a?(AST::ExpressionList) && !decl.value.elements.empty?
34
+ value = lower_static_storage_initializer(decl.value, env: empty_env, expected_type: type)
35
+ else
36
+ value = lower_const_value_literal(type, const_value)
37
+ end
38
+ elsif decl.block_body || decl.value.is_a?(AST::ExpressionList)
39
+ raise LoweringError.new("constant #{decl.name} has no compile-time value", line: decl.line, column: decl.column)
40
+ else
41
+ value = lower_static_storage_initializer(decl.value, env: empty_env, expected_type: type)
42
+ end
43
+
44
+ IR::Constant.new(name: decl.name, linkage_name: value_c_name(decl.name), type:, value:)
45
+ end
46
+ end
47
+
48
+ def lower_const_value_literal(type, const_value)
49
+ case const_value
50
+ when Integer
51
+ value = if type.respond_to?(:integer_width) && (width = type.integer_width) && width < 64
52
+ mask = (1 << width) - 1
53
+ masked = const_value & mask
54
+ if type.respond_to?(:unsigned_integer?) && !type.unsigned_integer? && masked >= (1 << (width - 1))
55
+ masked - (1 << width)
56
+ else
57
+ masked
58
+ end
59
+ else
60
+ const_value
61
+ end
62
+ IR::IntegerLiteral.new(value:, type:)
63
+ when Float
64
+ IR::FloatLiteral.new(value: const_value, type:)
65
+ when String
66
+ IR::StringLiteral.new(value: const_value, type:, cstring: false)
67
+ when TrueClass, FalseClass
68
+ IR::BooleanLiteral.new(value: const_value, type:)
69
+ when Array
70
+ element_type = type.respond_to?(:arguments) ? type.arguments.first : @ctx.types["int"]
71
+ elements = const_value.map do |element|
72
+ lower_const_value_literal(element_type, element)
73
+ end
74
+ IR::ArrayLiteral.new(type:, elements:)
75
+ else
76
+ IR::IntegerLiteral.new(value: 0, type:)
77
+ end
78
+ end
79
+
80
+ def lower_globals
81
+ expanded_declarations.filter_map do |decl|
82
+ next unless decl.is_a?(AST::VarDecl) || decl.is_a?(AST::EventDecl)
83
+
84
+ type = @ctx.values.fetch(decl.name).type
85
+ ensure_event_runtime(type) if type.is_a?(Types::Event)
86
+ value = if decl.is_a?(AST::VarDecl) && decl.value
87
+ lower_static_storage_initializer(decl.value, env: empty_env, expected_type: type)
88
+ else
89
+ IR::ZeroInit.new(type: type)
90
+ end
91
+ IR::Global.new(name: decl.name, linkage_name: value_c_name(decl.name), type:, value:)
92
+ end
93
+ end
94
+
95
+ def lower_opaques
96
+ expanded_declarations.grep(AST::OpaqueDecl).map do |decl|
97
+ opaque_type = @ctx.opaque_types.fetch(decl.name)
98
+ IR::OpaqueDecl.new(
99
+ name: decl.name,
100
+ linkage_name: opaque_c_type_name(opaque_type),
101
+ forward_declarable: opaque_forward_declarable?(opaque_type),
102
+ source_module: @ctx.module_name,
103
+ )
104
+ end
105
+ end
106
+
107
+ def lower_imported_external_opaques
108
+ each_raw_module_analysis.flat_map do |analysis|
109
+ analysis.ast.declarations.grep(AST::OpaqueDecl).filter_map do |decl|
110
+ opaque_type = analysis.types.fetch(decl.name)
111
+ next unless forward_declarable_external_opaque?(opaque_type)
112
+
113
+ IR::OpaqueDecl.new(name: decl.name, linkage_name: opaque_c_type_name(opaque_type), forward_declarable: true, source_module: analysis.module_name)
114
+ end
115
+ end.uniq { |decl| decl.linkage_name }
116
+ end
117
+
118
+ def lower_static_asserts
119
+ expanded_declarations.grep(AST::StaticAssert).map do |statement|
120
+ lower_static_assert(statement, env: empty_env)
121
+ end
122
+ end
123
+
124
+ def lower_static_assert(statement, env:)
125
+ condition_value = compile_time_const_value(statement.condition, env:)
126
+ raise LoweringError, "static_assert condition must lower to a compile-time bool constant" unless condition_value == true || condition_value == false
127
+
128
+ IR::StaticAssert.new(
129
+ condition: IR::BooleanLiteral.new(value: condition_value, type: @ctx.types.fetch("bool")),
130
+ message: lower_expression(statement.message, env:, expected_type: @ctx.types.fetch("str")),
131
+ )
132
+ end
133
+
134
+ def lower_structs
135
+ expanded_declarations.grep(AST::StructDecl).filter_map do |decl|
136
+ next unless decl.type_params.empty?
137
+
138
+ results = []
139
+ lower_one_struct(decl, decl.name, results)
140
+ results
141
+ end.flatten
142
+ end
143
+
144
+ def lower_one_struct(decl, qualified_name, results)
145
+ struct_type = @ctx.struct_types.fetch(qualified_name)
146
+ fields = decl.fields.map do |field|
147
+ IR::Field.new(name: field.name, type: struct_type.field(field.name))
148
+ end
149
+ decl.events.each do |event_decl|
150
+ event_type = struct_type.event(event_decl.name)
151
+ ensure_event_runtime(event_type)
152
+ fields << IR::Field.new(name: event_type.hidden_field_name, type: event_type)
153
+ end
154
+
155
+ results << IR::StructDecl.new(name: decl.name, linkage_name: c_type_name(struct_type), fields:, packed: decl.packed, alignment: decl.alignment, source_module: @ctx.module_name)
156
+
157
+ decl.nested_types.each do |nested|
158
+ lower_one_struct(nested, "#{qualified_name}.#{nested.name}", results)
159
+ end
160
+ end
161
+
162
+ def lower_unions
163
+ expanded_declarations.grep(AST::UnionDecl).map do |decl|
164
+ union_type = @ctx.union_types.fetch(decl.name)
165
+ fields = decl.fields.map do |field|
166
+ IR::Field.new(name: field.name, type: union_type.field(field.name))
167
+ end
168
+ IR::UnionDecl.new(name: decl.name, linkage_name: c_type_name(union_type), fields:, source_module: @ctx.module_name)
169
+ end
170
+ end
171
+
172
+ def lower_enums
173
+ expanded_declarations.filter_map do |decl|
174
+ case decl
175
+ when AST::EnumDecl, AST::FlagsDecl
176
+ enum_type = @ctx.types.fetch(decl.name)
177
+ backing_type = enum_type.backing_type
178
+ members = decl.members.map do |member|
179
+ value = lower_expression(member.value, env: empty_env, expected_type: backing_type)
180
+ IR::EnumMember.new(name: member.name, linkage_name: enum_member_c_name(enum_type, member.name), value:)
181
+ end
182
+
183
+ IR::EnumDecl.new(
184
+ name: decl.name,
185
+ linkage_name: c_type_name(enum_type),
186
+ backing_type:,
187
+ members:,
188
+ flags: decl.is_a?(AST::FlagsDecl),
189
+ )
190
+ end
191
+ end
192
+ end
193
+
194
+ def lower_variants
195
+ expanded_declarations.filter_map do |decl|
196
+ next unless decl.is_a?(AST::VariantDecl)
197
+
198
+ variant_type = @ctx.types.fetch(decl.name)
199
+ next if variant_type.is_a?(Types::GenericVariantDefinition)
200
+
201
+ outer_c = c_type_name(variant_type)
202
+ arms = decl.arms.map do |arm|
203
+ arm_c = "#{outer_c}_#{arm.name}"
204
+ fields = arm.fields.map do |field|
205
+ field_type = variant_type.arm(arm.name).fetch(field.name)
206
+ IR::Field.new(name: field.name, type: field_type)
207
+ end
208
+ IR::VariantArm.new(name: arm.name, linkage_name: arm_c, fields:)
209
+ end
210
+ IR::VariantDecl.new(name: decl.name, linkage_name: outer_c, arms:, source_module: @ctx.module_name)
211
+ end
212
+ end
213
+ end
214
+ end
@@ -0,0 +1,206 @@
1
+ # frozen_string_literal: true
2
+
3
+ module MilkTea
4
+ module LowererDyn
5
+ private
6
+
7
+ def lower_adapt_call(expression, env:, type:, interface:)
8
+ argument = expression.arguments.fetch(0)
9
+ arg_value = lower_expression(argument.value, env:)
10
+ arg_type = infer_expression_type(argument.value, env:)
11
+ concrete_type = ref_type?(arg_type) ? referenced_type(arg_type) : arg_type
12
+
13
+ @dyn_vtables ||= {}
14
+ key = [concrete_type, interface.name]
15
+ return @dyn_vtables[key] unless @dyn_vtables[key].nil?
16
+
17
+ vtable_struct_full = dyn_vtable_struct_type(interface)
18
+ vtable_c_name = ensure_dyn_vtable(interface, concrete_type)
19
+
20
+ void_ptr = Types::Registry.generic_instance("ptr", [@ctx.types.fetch("void")])
21
+ vtable_field = IR::Cast.new(
22
+ target_type: void_ptr,
23
+ expression: IR::AddressOf.new(
24
+ expression: IR::Name.new(name: vtable_c_name, type: vtable_struct_full, pointer: false),
25
+ type: Types::Registry.generic_instance("ptr", [vtable_struct_full]),
26
+ ),
27
+ type: void_ptr,
28
+ )
29
+
30
+ result = IR::AggregateLiteral.new(
31
+ type:,
32
+ fields: [
33
+ IR::AggregateField.new(name: "data", value: IR::Cast.new(target_type: void_ptr, expression: arg_value, type: void_ptr)),
34
+ IR::AggregateField.new(name: "vtable", value: vtable_field),
35
+ ],
36
+ )
37
+ @dyn_vtables[key] = result
38
+ result
39
+ end
40
+
41
+ def lower_dyn_method_call(expression, receiver, method_binding, env:, type:)
42
+ ir_expr = lower_expression(receiver, env:)
43
+ void_ptr = Types::Registry.generic_instance("ptr", [@ctx.types.fetch("void")])
44
+ dyn_type = infer_expression_type(receiver, env:)
45
+ interface = dyn_type.interface_binding
46
+
47
+ data_ptr = IR::Member.new(receiver: ir_expr, member: "data", type: void_ptr)
48
+ vtable_field = IR::Member.new(receiver: ir_expr, member: "vtable", type: void_ptr)
49
+
50
+ vtable_full = dyn_vtable_struct_type(interface)
51
+ vtable_ptr_type = Types::Registry.generic_instance("ptr", [vtable_full])
52
+ vtable_cast = IR::Cast.new(target_type: vtable_ptr_type, expression: vtable_field, type: vtable_ptr_type)
53
+
54
+ fn_type = vtable_full.field(method_binding.name)
55
+ vtable_method = IR::Member.new(receiver: vtable_cast, member: method_binding.name, type: fn_type)
56
+
57
+ arguments = [data_ptr, *lower_call_arguments(expression.arguments, method_binding, env:)]
58
+ IR::Call.new(callee: vtable_method, arguments:, type:)
59
+ end
60
+
61
+ def dyn_vtable_struct_type(interface)
62
+ void_ptr = Types::Registry.generic_instance("ptr", [@ctx.types.fetch("void")])
63
+ fields = {}
64
+ interface.methods.each do |method_name, method_binding|
65
+ fn_params = [Types::Registry.parameter("data", void_ptr), *method_binding.params]
66
+ fn_type = Types::Registry.function(nil, params: fn_params, return_type: method_binding.return_type)
67
+ fields[method_name] = fn_type
68
+ end
69
+ Types::DynVtable.new(interface.name, fields)
70
+ end
71
+
72
+ def ensure_dyn_vtable(interface, concrete_type)
73
+ concrete_type_name = sanitize_identifier(concrete_type.to_s)
74
+ vtable_c_name = "mt_vtable_#{concrete_type_name}_#{interface.name}"
75
+ return vtable_c_name if @dyn_generated_vtables&.key?(vtable_c_name)
76
+ @dyn_generated_vtables ||= {}
77
+
78
+ ensure_dyn_vtable_struct(interface)
79
+ wrappers = gen_dyn_vtable_wrappers(concrete_type, interface)
80
+ gen_dyn_vtable_constant(concrete_type, interface, vtable_c_name, wrappers)
81
+ @dyn_generated_vtables[vtable_c_name] = true
82
+ vtable_c_name
83
+ end
84
+
85
+ def ensure_dyn_vtable_struct(interface)
86
+ vtable_c_name = "mt_vtable_#{interface.name}"
87
+ return if @artifacts.synthetic_structs.any? { |s| s.linkage_name == vtable_c_name }
88
+
89
+ void_ptr = Types::Registry.generic_instance("ptr", [Types::Registry.primitive("void")])
90
+ fields = interface.methods.map do |method_name, method_binding|
91
+ fn_params = [Types::Registry.parameter("data", void_ptr), *method_binding.params]
92
+ fn_type = Types::Registry.function(nil, params: fn_params, return_type: method_binding.return_type)
93
+ IR::Field.new(name: method_name, type: fn_type)
94
+ end
95
+
96
+ @artifacts.synthetic_structs << IR::StructDecl.new(
97
+ name: "vtable_#{interface.name}",
98
+ linkage_name: vtable_c_name,
99
+ fields:,
100
+ packed: false,
101
+ alignment: nil,
102
+ )
103
+ end
104
+
105
+ def gen_dyn_vtable_wrappers(concrete_type, interface)
106
+ void_ptr = Types::Registry.generic_instance("ptr", [Types::Registry.primitive("void")])
107
+ wrappers = {}
108
+ concrete_type_name = sanitize_identifier(concrete_type.to_s)
109
+ ptr_to_concrete = Types::Registry.generic_instance("ptr", [concrete_type])
110
+
111
+ interface.methods.each do |method_name, method_binding|
112
+ method_info = @method_definitions[[concrete_type, method_name]]
113
+ raise LoweringError, "no method #{method_name} for #{concrete_type}" unless method_info
114
+
115
+ method_analysis, method_ast = method_info
116
+ method_key = method_ast.kind == :static ? "static:#{method_ast.name}" : method_ast.name
117
+ real_binding = method_analysis.methods.fetch(concrete_type).fetch(method_key)
118
+ real_c_name = function_binding_c_name(real_binding, module_name: method_analysis.module_name, receiver_type: concrete_type)
119
+ wrapper_c_name = "__dyn_#{concrete_type_name}_#{method_name}"
120
+ is_editable = method_ast.kind == :editable
121
+
122
+ params = [
123
+ IR::Param.new(name: "data", linkage_name: "data", type: void_ptr, pointer: false),
124
+ *method_binding.params.map.with_index { |p, i| IR::Param.new(name: p.name, linkage_name: p.name || "arg#{i}", type: p.type, pointer: false) },
125
+ ]
126
+
127
+ body = if is_editable
128
+ [
129
+ IR::ReturnStmt.new(value: IR::Call.new(
130
+ callee: real_c_name,
131
+ arguments: [
132
+ IR::Cast.new(target_type: ptr_to_concrete, expression: IR::Name.new(name: "data", type: void_ptr, pointer: false), type: ptr_to_concrete),
133
+ *method_binding.params.map.with_index { |p, i| IR::Name.new(name: p.name || "arg#{i}", type: p.type, pointer: false) },
134
+ ],
135
+ type: method_binding.return_type,
136
+ )),
137
+ ]
138
+ else
139
+ if method_ast.kind == :static
140
+ [
141
+ IR::ReturnStmt.new(value: IR::Call.new(
142
+ callee: real_c_name,
143
+ arguments: method_binding.params.map.with_index { |p, i| IR::Name.new(name: p.name || "arg#{i}", type: p.type, pointer: false) },
144
+ type: method_binding.return_type,
145
+ )),
146
+ ]
147
+ elsif receiver_type_uses_pointer_lowering?(concrete_type)
148
+ [
149
+ IR::ReturnStmt.new(value: IR::Call.new(
150
+ callee: real_c_name,
151
+ arguments: [
152
+ IR::Cast.new(target_type: ptr_to_concrete, expression: IR::Name.new(name: "data", type: void_ptr, pointer: false), type: ptr_to_concrete),
153
+ *method_binding.params.map.with_index { |p, i| IR::Name.new(name: p.name || "arg#{i}", type: p.type, pointer: false) },
154
+ ],
155
+ type: method_binding.return_type,
156
+ )),
157
+ ]
158
+ else
159
+ # The receiver is always passed here; the C backend's
160
+ # omitted-receiver call logic drops it when the target
161
+ # method's unused receiver parameter was omitted (the same
162
+ # single source of truth every ordinary method call uses,
163
+ # which requires a String callee).
164
+ [
165
+ IR::ReturnStmt.new(value: IR::Call.new(
166
+ callee: real_c_name,
167
+ arguments: [
168
+ IR::Unary.new(operator: "*", operand: IR::Cast.new(target_type: ptr_to_concrete, expression: IR::Name.new(name: "data", type: void_ptr, pointer: false), type: ptr_to_concrete), type: concrete_type),
169
+ *method_binding.params.map.with_index { |p, i| IR::Name.new(name: p.name || "arg#{i}", type: p.type, pointer: false) },
170
+ ],
171
+ type: method_binding.return_type,
172
+ )),
173
+ ]
174
+ end
175
+ end
176
+
177
+ @artifacts.synthetic_functions << IR::Function.new(
178
+ name: "__dyn_#{concrete_type_name}_#{method_name}",
179
+ linkage_name: wrapper_c_name,
180
+ params:,
181
+ return_type: method_binding.return_type,
182
+ body:,
183
+ entry_point: false,
184
+ )
185
+ wrappers[method_name] = wrapper_c_name
186
+ end
187
+
188
+ wrappers
189
+ end
190
+
191
+ def gen_dyn_vtable_constant(concrete_type, interface, vtable_c_name, wrappers)
192
+ vtable_full = dyn_vtable_struct_type(interface)
193
+ fields = interface.methods.map do |method_name, _|
194
+ wrapper_c_name = wrappers[method_name]
195
+ field_type = vtable_full.field(method_name)
196
+ IR::AggregateField.new(name: method_name, value: IR::Name.new(name: wrapper_c_name, type: field_type || @error_type, pointer: false))
197
+ end
198
+ @artifacts.synthetic_constants << IR::Constant.new(
199
+ name: vtable_c_name,
200
+ linkage_name: vtable_c_name,
201
+ type: vtable_full,
202
+ value: IR::AggregateLiteral.new(type: vtable_full, fields:),
203
+ )
204
+ end
205
+ end
206
+ end