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
data/lib/milk_tea/tooling/views/index.erb ADDED
@@ -0,0 +1,87 @@
1
+ <% @title = "Home" %>
2
+
3
+ <div class="hero">
4
+ <h1>Milk Tea <span>Documentation</span></h1>
5
+ <p class="tagline">A statically typed, indentation-based systems language for games. Safe by default, explicit by design, compiling to <strong>beautiful C</strong>.</p>
6
+ <div class="badges">
7
+ <span class="badge">&#9889; Statically Typed</span>
8
+ <span class="badge">&#127758; Compiles to C</span>
9
+ <span class="badge ac">&#128274; Safe by Default</span>
10
+ <span class="badge">&#128295; Data-Oriented</span>
11
+ <span class="badge">&#9752; No GC</span>
12
+ <span class="badge ac">&#128279; First-Class C FFI</span>
13
+ </div>
14
+ </div>
15
+
16
+ <div class="cards">
17
+ <a href="/reference/" class="card">
18
+ <h2>&#128214; Language Reference</h2>
19
+ <p>Complete language guide: syntax, types, generics, interfaces, control flow, error handling, concurrency, FFI, and more.</p>
20
+ </a>
21
+
22
+ <a href="/stdlib" class="card">
23
+ <h2>&#128218; Standard Library</h2>
24
+ <p>Browse the standard library modules: collections, memory allocators, async runtime, text formatting, and more.</p>
25
+ </a>
26
+
27
+ <a href="<%= active?("/reference/") %>" class="card">
28
+ <h2>&#128296; Command-Line Tools</h2>
29
+ <p><code>mtc build</code>, <code>mtc run</code>, <code>mtc check</code>, <code>mtc lint</code>, <code>mtc format</code>, <code>mtc deps</code>, and more.</p>
30
+ </a>
31
+ </div>
32
+
33
+ <section>
34
+ <h2>Quick Start</h2>
35
+
36
+ <div class="code-wrap">
37
+ <button class="copy-btn" onclick="copyCode(this)">Copy</button>
38
+ <pre><code>function main() -&gt; int:
39
+ return 0</code></pre>
40
+ </div>
41
+
42
+ <p>Save as <code class="code-inline">hello.mt</code> and run:</p>
43
+ <div class="code-wrap">
44
+ <button class="copy-btn" onclick="copyCode(this)">Copy</button>
45
+ <pre><code>mtc run hello.mt</code></pre>
46
+ </div>
47
+
48
+ <h3>Essential CLI</h3>
49
+ <div class="table-wrap">
50
+ <table class="attr-table">
51
+ <tr><th>Command</th><th>Description</th></tr>
52
+ <tr><td><code>mtc check &lt;path&gt;</code></td><td>Type-check + lint</td></tr>
53
+ <tr><td><code>mtc run &lt;path&gt;</code></td><td>Build and execute</td></tr>
54
+ <tr><td><code>mtc build &lt;path&gt;</code></td><td>Build only (emit C, compile, link)</td></tr>
55
+ <tr><td><code>mtc format &lt;path&gt;</code></td><td>Format sources in place</td></tr>
56
+ <tr><td><code>mtc lint &lt;path&gt;</code></td><td>Run linter</td></tr>
57
+ <tr><td><code>mtc new &lt;name&gt;</code></td><td>Scaffold a new package</td></tr>
58
+ <tr><td><code>mtc docs</code></td><td>Start this documentation server</td></tr>
59
+ </table>
60
+ </div>
61
+ </section>
62
+
63
+ <section>
64
+ <h2>Design Principles</h2>
65
+ <div class="table-wrap">
66
+ <table class="attr-table">
67
+ <tr><th>Principle</th><th>Description</th></tr>
68
+ <tr><td><strong>What you see is what runs</strong></td><td>No hidden allocation, dispatch, or heap traffic.</td></tr>
69
+ <tr><td><strong>C is the ABI ground truth</strong></td><td>Structs, pointers, calling conventions map directly.</td></tr>
70
+ <tr><td><strong>Safe by default</strong></td><td>Pointer operations require <code>unsafe</code>. Indexing is bounds-checked.</td></tr>
71
+ <tr><td><strong>Data-oriented first</strong></td><td>Plain structs, arrays, spans, pools over object systems.</td></tr>
72
+ <tr><td><strong>One job, one canonical surface</strong></td><td>No duplicated everyday spellings for the same concept.</td></tr>
73
+ </table>
74
+ </div>
75
+ </section>
76
+
77
+ <section class="stdlib-preview">
78
+ <h2>Standard Library (<%= stdlib_modules.size %> modules)</h2>
79
+ <div class="stdlib-grid">
80
+ <% stdlib_modules.each do |mod| %>
81
+ <a href="/stdlib/<%= mod[:name] %>" class="stdlib-item">
82
+ <span class="stdlib-name"><%= mod[:name] %></span>
83
+ <span class="stdlib-kind"><%= mod[:kind] == :dir ? "package" : "module" %></span>
84
+ </a>
85
+ <% end %>
86
+ </div>
87
+ </section>
data/lib/milk_tea/tooling/views/layout.erb ADDED
@@ -0,0 +1,69 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-theme="light">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title><%= @title || "Milk Tea" %> &mdash; Documentation</title>
7
+ <link rel="stylesheet" href="/css/docs.css">
8
+ </head>
9
+ <body>
10
+
11
+ <div class="progress" id="progress"></div>
12
+ <div class="overlay" id="overlay"></div>
13
+
14
+ <aside class="sidebar" id="sidebar">
15
+ <div class="sidebar-logo">
16
+ <a href="/" style="color:inherit;text-decoration:none;display:flex;align-items:center;gap:.5rem">
17
+ <span class="icon">&#129483;</span>
18
+ Milk Tea
19
+ </a>
20
+ </div>
21
+ <div class="sidebar-search">
22
+ <input type="text" id="mod-filter" placeholder="Filter modules&hellip;" autocomplete="off">
23
+ </div>
24
+ <nav class="sidebar-nav">
25
+ <a href="/" class="<%= active?("/") %>">Reference</a>
26
+
27
+ <div class="stdlib-section">
28
+ <% categorized_modules.each do |category, mods| %>
29
+ <details open class="mod-category">
30
+ <summary><%= category %></summary>
31
+ <% mods.each do |mod| %>
32
+ <a href="/stdlib/<%= mod[:name] %>" class="mod-link <%= "active" if @name == mod[:name] %>" data-mod="<%= mod[:name] %>">
33
+ <%= mod[:name] %>
34
+ </a>
35
+ <% end %>
36
+ </details>
37
+ <% end %>
38
+ </div>
39
+ </nav>
40
+ <div class="sidebar-footer">
41
+ <button class="theme-btn" id="theme-toggle" aria-label="Toggle theme">
42
+ <span class="icon-sun">&#9728;</span>
43
+ <span class="icon-moon">&#127769;</span>
44
+ </button>
45
+ <span>Milk Tea</span>
46
+ </div>
47
+ </aside>
48
+
49
+ <div class="topbar">
50
+ <button class="menu-btn" id="menu-btn" aria-label="Toggle menu">&#9776;</button>
51
+ <span class="logo-text">&#127861; Milk Tea</span>
52
+ <button class="theme-btn" id="theme-toggle-mbl" aria-label="Toggle theme" style="margin-left:auto">&#127769;</button>
53
+ </div>
54
+
55
+ <main class="main" id="main">
56
+ <% if @breadcrumbs %>
57
+ <nav class="breadcrumbs">
58
+ <% @breadcrumbs.each_with_index do |(label, href), i| %>
59
+ <% if i > 0 %><span class="bc-sep">/</span><% end %>
60
+ <% if href %><a href="<%= href %>"><%= label %></a><% else %><span><%= label %></span><% end %>
61
+ <% end %>
62
+ </nav>
63
+ <% end %>
64
+ <%= yield %>
65
+ </main>
66
+
67
+ <script src="/js/docs.js"></script>
68
+ </body>
69
+ </html>
data/lib/milk_tea/tooling/views/module.erb ADDED
@@ -0,0 +1,97 @@
1
+ <% @title = @name %>
2
+
3
+ <div class="hero">
4
+ <h1><code><%= @name %></code></h1>
5
+ <p class="tagline">
6
+ <%= @mod[:kind] == :dir ? "Package" : "Module" %>
7
+ &middot; <%= @files.sum { |f| f[:decls].size } %> declarations
8
+ &middot; <%= @files.size %> <%= @files.size == 1 ? "file" : "files" %>
9
+ </p>
10
+ </div>
11
+
12
+ <% @files.each do |file| %>
13
+ <% if file[:doc] && !file[:doc].empty? %>
14
+ <div class="doc-block">
15
+ <%= h(file[:doc]).gsub("\n", "<br>") %>
16
+ </div>
17
+ <% end %>
18
+
19
+ <% unless file[:decls].empty?
20
+ top = file[:decls].select { |d| !d[:parent] }
21
+ children = file[:decls].select { |d| d[:parent] }
22
+ groups = children.group_by { |d| d[:parent] }
23
+ orphan_parents = groups.keys - top.map { |t| t[:name] }
24
+ %>
25
+ <section>
26
+ <div class="section-header">
27
+ <h3><%= file[:name] %>.mt</h3>
28
+ <a href="/stdlib/<%= @name %>/source/<%= file[:name] %>" class="source-inline">source</a>
29
+ <% if snapshot_available? %>
30
+ <a href="/stdlib/<%= @name %>/source/<%= file[:name] %>/hl" class="source-inline hl-inline">highlighted</a>
31
+ <% end %>
32
+ </div>
33
+ <div class="table-wrap">
34
+ <table class="attr-table">
35
+ <tr><th>Kind</th><th>Name</th><th>Declaration</th></tr>
36
+
37
+ <% top.each do |decl| %>
38
+ <tr id="d-<%= decl[:name] %>">
39
+ <td><span class="kind-badge"><%= decl[:kind] %></span></td>
40
+ <td>
41
+ <code><%= decl[:name] %></code>
42
+ <a href="#d-<%= decl[:name] %>" class="permalink" title="Permalink">&para;</a>
43
+ </td>
44
+ <td>
45
+ <code class="code-inline"><%= h(decl[:line]) %></code>
46
+ <% if decl[:doc] %>
47
+ <div class="decl-doc"><%= h(decl[:doc]).gsub("\n", "<br>") %></div>
48
+ <% end %>
49
+ </td>
50
+ </tr>
51
+ <% (groups[decl[:name]] || []).each do |child| %>
52
+ <tr class="meth-row" id="d-<%= child[:name] %>">
53
+ <td></td>
54
+ <td>
55
+ <span class="meth-indent">&vellip;</span>
56
+ <code><%= child[:name] %></code>
57
+ <a href="#d-<%= child[:name] %>" class="permalink" title="Permalink">&para;</a>
58
+ </td>
59
+ <td>
60
+ <code class="code-inline"><%= h(child[:line]) %></code>
61
+ <% if child[:doc] %>
62
+ <div class="decl-doc"><%= h(child[:doc]).gsub("\n", "<br>") %></div>
63
+ <% end %>
64
+ </td>
65
+ </tr>
66
+ <% end %>
67
+ <% end %>
68
+
69
+ <% orphan_parents.each do |parent_name| %>
70
+ <tr class="extend-header">
71
+ <td colspan="3">
72
+ <span class="extend-label">extending</span>
73
+ <code><%= parent_name %></code>
74
+ </td>
75
+ </tr>
76
+ <% groups[parent_name].each do |child| %>
77
+ <tr class="meth-row" id="d-<%= child[:name] %>">
78
+ <td></td>
79
+ <td>
80
+ <span class="meth-indent">&vellip;</span>
81
+ <code><%= child[:name] %></code>
82
+ <a href="#d-<%= child[:name] %>" class="permalink" title="Permalink">&para;</a>
83
+ </td>
84
+ <td>
85
+ <code class="code-inline"><%= h(child[:line]) %></code>
86
+ <% if child[:doc] %>
87
+ <div class="decl-doc"><%= h(child[:doc]).gsub("\n", "<br>") %></div>
88
+ <% end %>
89
+ </td>
90
+ </tr>
91
+ <% end %>
92
+ <% end %>
93
+ </table>
94
+ </div>
95
+ </section>
96
+ <% end %>
97
+ <% end %>
data/lib/milk_tea/tooling/views/stdlib.erb ADDED
@@ -0,0 +1,21 @@
1
+ <% @title = "Standard Library" %>
2
+
3
+ <div class="hero">
4
+ <h1>Standard <span>Library</span></h1>
5
+ <p class="tagline"><%= @modules.size %> modules &mdash; collections, memory allocators, async runtime, text formatting, math, and FFI support.</p>
6
+ </div>
7
+
8
+ <section>
9
+ <div class="table-wrap">
10
+ <table class="attr-table">
11
+ <tr><th>Module</th><th>Description</th><th>Declarations</th></tr>
12
+ <% @modules.each do |mod| %>
13
+ <tr>
14
+ <td><a href="/stdlib/<%= mod[:name] %>"><code><%= mod[:name] %></code></a></td>
15
+ <td><%= h(mod[:doc].lines.first&.strip || "") %></td>
16
+ <td><%= mod[:decl_count] %></td>
17
+ </tr>
18
+ <% end %>
19
+ </table>
20
+ </div>
21
+ </section>
data/lib/milk_tea/tooling.rb ADDED
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "base"
4
+ require_relative "core"
5
+ require_relative "packages"
6
+
7
+ require_relative "tooling/debug_map"
8
+ require_relative "tooling/debug_info_formatter"
9
+ require_relative "tooling/asset_pack"
10
+ require_relative "tooling/build"
11
+ require_relative "tooling/run"
12
+ require_relative "tooling/cst_formatter"
13
+ require_relative "tooling/error_formatter"
14
+ require_relative "tooling/formatter"
15
+ require_relative "tooling/linter"
16
+ require_relative "tooling/docs_app"
17
+ require_relative "tooling/project_scaffold"
18
+ require_relative "tooling/toolchain_cli"
19
+ require_relative "bindings/cli"
20
+ require_relative "tooling/cli"
data/lib/milk_tea.rb ADDED
@@ -0,0 +1,8 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "milk_tea/base"
4
+ require_relative "milk_tea/core"
5
+ require_relative "milk_tea/packages"
6
+ require_relative "milk_tea/tooling"
7
+ require_relative "milk_tea/lsp"
8
+ require_relative "milk_tea/dap"