xbintsc 0.5.23 → 0.5.32

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 (481) hide show
  1. package/AGENTS.md +11 -2
  2. package/README.md +47 -16
  3. package/README.zh-CN.md +21 -2
  4. package/dist/scripts/support-matrix.d.ts +18 -0
  5. package/dist/scripts/support-matrix.js +141 -0
  6. package/dist/scripts/support-matrix.js.map +1 -0
  7. package/dist/src/ast/common.d.ts +2 -2
  8. package/dist/src/ast/declarations.d.ts +7 -1
  9. package/dist/src/ast/expressions.d.ts +5 -0
  10. package/dist/src/ast/kinds.d.ts +2 -0
  11. package/dist/src/ast/kinds.js +2 -0
  12. package/dist/src/ast/kinds.js.map +1 -1
  13. package/dist/src/binder/binder.d.ts +2 -1
  14. package/dist/src/binder/binder.js +2 -0
  15. package/dist/src/binder/binder.js.map +1 -1
  16. package/dist/src/binder/declarations.d.ts +9 -0
  17. package/dist/src/binder/declarations.js +64 -0
  18. package/dist/src/binder/declarations.js.map +1 -1
  19. package/dist/src/binder/references.js +99 -4
  20. package/dist/src/binder/references.js.map +1 -1
  21. package/dist/src/binder/types.d.ts +32 -0
  22. package/dist/src/binder/types.js.map +1 -1
  23. package/dist/src/canonical.d.ts +29 -0
  24. package/dist/src/canonical.js +35 -0
  25. package/dist/src/canonical.js.map +1 -0
  26. package/dist/src/checker/assignability.d.ts +13 -0
  27. package/dist/src/checker/assignability.js +146 -0
  28. package/dist/src/checker/assignability.js.map +1 -0
  29. package/dist/src/checker/calls.d.ts +13 -0
  30. package/dist/src/checker/calls.js +127 -0
  31. package/dist/src/checker/calls.js.map +1 -0
  32. package/dist/src/checker/checker.d.ts +26 -0
  33. package/dist/src/checker/checker.js +31 -0
  34. package/dist/src/checker/checker.js.map +1 -0
  35. package/dist/src/checker/declarations.d.ts +9 -0
  36. package/dist/src/checker/declarations.js +15 -0
  37. package/dist/src/checker/declarations.js.map +1 -0
  38. package/dist/src/checker/flow.d.ts +21 -0
  39. package/dist/src/checker/flow.js +241 -0
  40. package/dist/src/checker/flow.js.map +1 -0
  41. package/dist/src/checker/globals.d.ts +9 -0
  42. package/dist/src/checker/globals.js +29 -0
  43. package/dist/src/checker/globals.js.map +1 -0
  44. package/dist/src/checker/source.d.ts +38 -0
  45. package/dist/src/checker/source.js +48 -0
  46. package/dist/src/checker/source.js.map +1 -0
  47. package/dist/src/checker/type-infer.d.ts +18 -0
  48. package/dist/src/checker/type-infer.js +173 -0
  49. package/dist/src/checker/type-infer.js.map +1 -0
  50. package/dist/src/checker/type-model.d.ts +73 -0
  51. package/dist/src/checker/type-model.js +151 -0
  52. package/dist/src/checker/type-model.js.map +1 -0
  53. package/dist/src/checker/type-system.d.ts +58 -0
  54. package/dist/src/checker/type-system.js +569 -0
  55. package/dist/src/checker/type-system.js.map +1 -0
  56. package/dist/src/checker/typecheck-types.d.ts +22 -0
  57. package/dist/src/checker/typecheck-types.js +109 -0
  58. package/dist/src/checker/typecheck-types.js.map +1 -0
  59. package/dist/src/checker/typecheck.d.ts +62 -0
  60. package/dist/src/checker/typecheck.js +574 -0
  61. package/dist/src/checker/typecheck.js.map +1 -0
  62. package/dist/src/checker/undefined.d.ts +14 -0
  63. package/dist/src/checker/undefined.js +32 -0
  64. package/dist/src/checker/undefined.js.map +1 -0
  65. package/dist/src/checker/walk.d.ts +10 -0
  66. package/dist/src/checker/walk.js +15 -0
  67. package/dist/src/checker/walk.js.map +1 -0
  68. package/dist/src/cli/help.d.ts +7 -0
  69. package/dist/src/cli/help.js +64 -0
  70. package/dist/src/cli/help.js.map +1 -0
  71. package/dist/src/cli/hints.js +2 -1
  72. package/dist/src/cli/hints.js.map +1 -1
  73. package/dist/src/cli/main.js +12 -48
  74. package/dist/src/cli/main.js.map +1 -1
  75. package/dist/src/codegen/generator/calls/access.js +8 -8
  76. package/dist/src/codegen/generator/calls/access.js.map +1 -1
  77. package/dist/src/codegen/generator/calls/invocation.js +9 -4
  78. package/dist/src/codegen/generator/calls/invocation.js.map +1 -1
  79. package/dist/src/codegen/generator/calls/super.d.ts +9 -1
  80. package/dist/src/codegen/generator/calls/super.js +56 -5
  81. package/dist/src/codegen/generator/calls/super.js.map +1 -1
  82. package/dist/src/codegen/generator/context.d.ts +13 -2
  83. package/dist/src/codegen/generator/context.js +25 -19
  84. package/dist/src/codegen/generator/context.js.map +1 -1
  85. package/dist/src/codegen/generator/debug.js +2 -1
  86. package/dist/src/codegen/generator/debug.js.map +1 -1
  87. package/dist/src/codegen/generator/expressions/primary.d.ts +4 -1
  88. package/dist/src/codegen/generator/expressions/primary.js +68 -8
  89. package/dist/src/codegen/generator/expressions/primary.js.map +1 -1
  90. package/dist/src/codegen/generator/generator.js +11 -1
  91. package/dist/src/codegen/generator/generator.js.map +1 -1
  92. package/dist/src/codegen/generator/module.d.ts +3 -0
  93. package/dist/src/codegen/generator/module.js +116 -26
  94. package/dist/src/codegen/generator/module.js.map +1 -1
  95. package/dist/src/codegen/generator/state.d.ts +11 -1
  96. package/dist/src/codegen/generator/state.js.map +1 -1
  97. package/dist/src/codegen/generator/statements/variables.js +26 -7
  98. package/dist/src/codegen/generator/statements/variables.js.map +1 -1
  99. package/dist/src/codegen/generator/tables.d.ts +2 -0
  100. package/dist/src/codegen/generator/tables.js +4 -0
  101. package/dist/src/codegen/generator/tables.js.map +1 -1
  102. package/dist/src/driver/build-key.d.ts +2 -0
  103. package/dist/src/driver/build-key.js +1 -0
  104. package/dist/src/driver/build-key.js.map +1 -1
  105. package/dist/src/driver/bundler/graph.js +5 -1
  106. package/dist/src/driver/bundler/graph.js.map +1 -1
  107. package/dist/src/driver/bundler/merge.js +16 -1
  108. package/dist/src/driver/bundler/merge.js.map +1 -1
  109. package/dist/src/driver/bundler/types.d.ts +12 -0
  110. package/dist/src/driver/compiler.d.ts +1 -1
  111. package/dist/src/driver/compiler.js +3 -0
  112. package/dist/src/driver/compiler.js.map +1 -1
  113. package/dist/src/driver/fingerprint.js +2 -1
  114. package/dist/src/driver/fingerprint.js.map +1 -1
  115. package/dist/src/driver/frontend.d.ts +8 -6
  116. package/dist/src/driver/frontend.js +4 -0
  117. package/dist/src/driver/frontend.js.map +1 -1
  118. package/dist/src/driver/options.d.ts +6 -0
  119. package/dist/src/driver/version.d.ts +1 -1
  120. package/dist/src/driver/version.js +1 -1
  121. package/dist/src/extensions/gui/css.d.ts +26 -0
  122. package/dist/src/extensions/gui/css.js +100 -0
  123. package/dist/src/extensions/gui/css.js.map +1 -0
  124. package/dist/src/extensions/gui/html.js +28 -7
  125. package/dist/src/extensions/gui/html.js.map +1 -1
  126. package/dist/src/extensions/gui/index.js +79 -2
  127. package/dist/src/extensions/gui/index.js.map +1 -1
  128. package/dist/src/extensions/gui/three.d.ts +16 -0
  129. package/dist/src/extensions/gui/three.js +22 -0
  130. package/dist/src/extensions/gui/three.js.map +1 -0
  131. package/dist/src/extensions/media/index.d.ts +6 -5
  132. package/dist/src/extensions/media/index.js +12 -14
  133. package/dist/src/extensions/media/index.js.map +1 -1
  134. package/dist/src/extensions/registry.d.ts +38 -0
  135. package/dist/src/extensions/registry.js +10 -0
  136. package/dist/src/extensions/registry.js.map +1 -1
  137. package/dist/src/index.d.ts +1 -0
  138. package/dist/src/index.js +1 -0
  139. package/dist/src/index.js.map +1 -1
  140. package/dist/src/parser/declarations/classes.js +7 -0
  141. package/dist/src/parser/declarations/classes.js.map +1 -1
  142. package/dist/src/parser/expressions.js +14 -1
  143. package/dist/src/parser/expressions.js.map +1 -1
  144. package/dist/src/parser/literals.js +6 -2
  145. package/dist/src/parser/literals.js.map +1 -1
  146. package/dist/tests/binder/binder.test.js +29 -0
  147. package/dist/tests/binder/binder.test.js.map +1 -1
  148. package/dist/tests/canonical.test.d.ts +1 -0
  149. package/dist/tests/canonical.test.js +19 -0
  150. package/dist/tests/canonical.test.js.map +1 -0
  151. package/dist/tests/checker/checker.test.d.ts +1 -0
  152. package/dist/tests/checker/checker.test.js +245 -0
  153. package/dist/tests/checker/checker.test.js.map +1 -0
  154. package/dist/tests/cli/check.test.js +20 -0
  155. package/dist/tests/cli/check.test.js.map +1 -1
  156. package/dist/tests/conformance/matrix.test.d.ts +6 -0
  157. package/dist/tests/conformance/matrix.test.js +23 -0
  158. package/dist/tests/conformance/matrix.test.js.map +1 -0
  159. package/dist/tests/conformance/test262/manifest.d.ts +115 -0
  160. package/dist/tests/conformance/test262/manifest.js +257 -0
  161. package/dist/tests/conformance/test262/manifest.js.map +1 -0
  162. package/dist/tests/conformance/test262.test.d.ts +11 -0
  163. package/dist/tests/conformance/test262.test.js +74 -0
  164. package/dist/tests/conformance/test262.test.js.map +1 -0
  165. package/dist/tests/docs/structure.test.js +9 -11
  166. package/dist/tests/docs/structure.test.js.map +1 -1
  167. package/dist/tests/e2e/child-process.test.js +3 -2
  168. package/dist/tests/e2e/child-process.test.js.map +1 -1
  169. package/dist/tests/e2e/compile-builtins.test.js +45 -0
  170. package/dist/tests/e2e/compile-builtins.test.js.map +1 -1
  171. package/dist/tests/e2e/compile-objects-classes.test.js +77 -0
  172. package/dist/tests/e2e/compile-objects-classes.test.js.map +1 -1
  173. package/dist/tests/e2e/differential-syntax.test.d.ts +5 -0
  174. package/dist/tests/e2e/differential-syntax.test.js +95 -0
  175. package/dist/tests/e2e/differential-syntax.test.js.map +1 -0
  176. package/dist/tests/e2e/differential-values.test.js +15 -0
  177. package/dist/tests/e2e/differential-values.test.js.map +1 -1
  178. package/dist/tests/e2e/gui-browser.test.d.ts +13 -0
  179. package/dist/tests/e2e/gui-browser.test.js +163 -0
  180. package/dist/tests/e2e/gui-browser.test.js.map +1 -0
  181. package/dist/tests/e2e/gui-effects.test.d.ts +6 -0
  182. package/dist/tests/e2e/gui-effects.test.js +262 -0
  183. package/dist/tests/e2e/gui-effects.test.js.map +1 -0
  184. package/dist/tests/e2e/gui-example-browser.test.js +2 -2
  185. package/dist/tests/e2e/gui-example-browser.test.js.map +1 -1
  186. package/dist/tests/e2e/gui-example-canvas.test.js +5 -4
  187. package/dist/tests/e2e/gui-example-canvas.test.js.map +1 -1
  188. package/dist/tests/e2e/gui-example-svg.test.js +4 -3
  189. package/dist/tests/e2e/gui-example-svg.test.js.map +1 -1
  190. package/dist/tests/e2e/gui-example-webgl.test.d.ts +10 -0
  191. package/dist/tests/e2e/gui-example-webgl.test.js +75 -0
  192. package/dist/tests/e2e/gui-example-webgl.test.js.map +1 -0
  193. package/dist/tests/e2e/gui-example-webgl2.test.d.ts +8 -0
  194. package/dist/tests/e2e/gui-example-webgl2.test.js +72 -0
  195. package/dist/tests/e2e/gui-example-webgl2.test.js.map +1 -0
  196. package/dist/tests/e2e/gui-example.test.js +4 -3
  197. package/dist/tests/e2e/gui-example.test.js.map +1 -1
  198. package/dist/tests/e2e/gui-helpers.js +4 -3
  199. package/dist/tests/e2e/gui-helpers.js.map +1 -1
  200. package/dist/tests/e2e/gui-layout.test.js +48 -0
  201. package/dist/tests/e2e/gui-layout.test.js.map +1 -1
  202. package/dist/tests/e2e/gui-media.test.js +10 -8
  203. package/dist/tests/e2e/gui-media.test.js.map +1 -1
  204. package/dist/tests/e2e/gui-webgl.test.d.ts +11 -0
  205. package/dist/tests/e2e/gui-webgl.test.js +179 -0
  206. package/dist/tests/e2e/gui-webgl.test.js.map +1 -0
  207. package/dist/tests/e2e/gui-webgl2.test.d.ts +10 -0
  208. package/dist/tests/e2e/gui-webgl2.test.js +238 -0
  209. package/dist/tests/e2e/gui-webgl2.test.js.map +1 -0
  210. package/dist/tests/e2e/harness.d.ts +9 -0
  211. package/dist/tests/e2e/harness.js +14 -2
  212. package/dist/tests/e2e/harness.js.map +1 -1
  213. package/dist/tests/e2e/native-extensions.test.js +2 -1
  214. package/dist/tests/e2e/native-extensions.test.js.map +1 -1
  215. package/dist/tests/e2e/property-descriptors.test.js +20 -0
  216. package/dist/tests/e2e/property-descriptors.test.js.map +1 -1
  217. package/dist/tests/e2e/unicode-output.test.js +5 -3
  218. package/dist/tests/e2e/unicode-output.test.js.map +1 -1
  219. package/dist/tests/e2e/weak-collections.test.js +16 -2
  220. package/dist/tests/e2e/weak-collections.test.js.map +1 -1
  221. package/dist/tests/extensions/gui.test.js +41 -0
  222. package/dist/tests/extensions/gui.test.js.map +1 -1
  223. package/dist/tests/extensions/media.test.js +7 -3
  224. package/dist/tests/extensions/media.test.js.map +1 -1
  225. package/dist/tests/helpers.d.ts +1 -0
  226. package/dist/tests/helpers.js +1 -0
  227. package/dist/tests/helpers.js.map +1 -1
  228. package/dist/tests/parser/declarations.test.js +20 -0
  229. package/dist/tests/parser/declarations.test.js.map +1 -1
  230. package/dist/tests/parser/expressions.test.js +36 -0
  231. package/dist/tests/parser/expressions.test.js.map +1 -1
  232. package/dist/tests/platform.d.ts +32 -0
  233. package/dist/tests/platform.js +40 -0
  234. package/dist/tests/platform.js.map +1 -0
  235. package/dist/tests/platform.test.d.ts +12 -0
  236. package/dist/tests/platform.test.js +51 -0
  237. package/dist/tests/platform.test.js.map +1 -0
  238. package/dist/tests/version.test.js +4 -4
  239. package/dist/tests/version.test.js.map +1 -1
  240. package/doc/ai/README.md +10 -4
  241. package/doc/ai/build-recipe.md +1 -0
  242. package/doc/ai/cli.md +17 -5
  243. package/doc/ai/contributing.md +59 -2
  244. package/doc/ai/extensions.md +38 -7
  245. package/doc/ai/language-support.md +25 -16
  246. package/doc/ai/troubleshooting.md +12 -8
  247. package/doc/ai/zh-CN/README.md +9 -4
  248. package/doc/ai/zh-CN/build-recipe.md +1 -0
  249. package/doc/ai/zh-CN/cli.md +13 -3
  250. package/doc/ai/zh-CN/contributing.md +49 -3
  251. package/doc/ai/zh-CN/extensions.md +33 -6
  252. package/doc/ai/zh-CN/language-support.md +23 -14
  253. package/doc/ai/zh-CN/troubleshooting.md +10 -6
  254. package/doc/gui/api.md +47 -1
  255. package/doc/gui/build.md +72 -16
  256. package/doc/gui/canvas.md +11 -3
  257. package/doc/gui/dom.md +33 -18
  258. package/doc/gui/known-issues.md +58 -15
  259. package/doc/gui/layout.md +18 -0
  260. package/doc/gui/media.md +17 -13
  261. package/doc/gui/rendering.md +50 -3
  262. package/doc/gui/runtime.md +18 -0
  263. package/doc/gui/webgl.md +256 -0
  264. package/doc/gui-scripts.md +7 -0
  265. package/doc/gui.md +108 -17
  266. package/doc/implemented/binder.md +2 -0
  267. package/doc/implemented/checker.md +117 -0
  268. package/doc/implemented/cli.md +13 -1
  269. package/doc/implemented/codegen.md +3 -2
  270. package/doc/implemented/driver.md +2 -2
  271. package/doc/implemented/operators.md +2 -1
  272. package/doc/implemented/parser.md +3 -2
  273. package/doc/implemented/pipeline.md +8 -1
  274. package/doc/implemented/stdlib.md +2 -1
  275. package/doc/implemented/tests.md +3 -1
  276. package/doc/implemented.md +2 -0
  277. package/doc/npm-package.md +419 -0
  278. package/doc/requirements.md +22 -10
  279. package/doc/support-matrix.md +83 -0
  280. package/doc/unimplemented/classes.md +3 -0
  281. package/doc/unimplemented/deviations.md +3 -2
  282. package/doc/unimplemented/toolchain.md +1 -1
  283. package/doc/unimplemented/types.md +24 -8
  284. package/doc/unimplemented.md +1 -1
  285. package/doc/zh-CN/gui/api.md +43 -1
  286. package/doc/zh-CN/gui/build.md +64 -15
  287. package/doc/zh-CN/gui/canvas.md +9 -2
  288. package/doc/zh-CN/gui/dom.md +20 -7
  289. package/doc/zh-CN/gui/known-issues.md +46 -13
  290. package/doc/zh-CN/gui/layout.md +14 -0
  291. package/doc/zh-CN/gui/media.md +15 -11
  292. package/doc/zh-CN/gui/rendering.md +41 -4
  293. package/doc/zh-CN/gui/runtime.md +16 -0
  294. package/doc/zh-CN/gui/webgl.md +115 -0
  295. package/doc/zh-CN/gui-scripts.md +5 -0
  296. package/doc/zh-CN/gui.md +89 -14
  297. package/doc/zh-CN/implemented/binder.md +2 -0
  298. package/doc/zh-CN/implemented/checker.md +99 -0
  299. package/doc/zh-CN/implemented/cli.md +12 -1
  300. package/doc/zh-CN/implemented/codegen.md +3 -2
  301. package/doc/zh-CN/implemented/driver.md +2 -2
  302. package/doc/zh-CN/implemented/operators.md +1 -1
  303. package/doc/zh-CN/implemented/parser.md +3 -2
  304. package/doc/zh-CN/implemented/pipeline.md +3 -1
  305. package/doc/zh-CN/implemented/stdlib.md +2 -1
  306. package/doc/zh-CN/implemented/tests.md +3 -1
  307. package/doc/zh-CN/implemented.md +2 -0
  308. package/doc/zh-CN/npm-package.md +394 -0
  309. package/doc/zh-CN/post/announce.md +47 -47
  310. package/doc/zh-CN/requirements.md +16 -7
  311. package/doc/zh-CN/support-matrix.md +82 -0
  312. package/doc/zh-CN/unimplemented/classes.md +3 -0
  313. package/doc/zh-CN/unimplemented/deviations.md +3 -2
  314. package/doc/zh-CN/unimplemented/toolchain.md +1 -1
  315. package/doc/zh-CN/unimplemented/types.md +16 -6
  316. package/doc/zh-CN/unimplemented.md +1 -1
  317. package/llms.txt +6 -1
  318. package/package.json +2 -1
  319. package/runtime/ext_gui/audio.cpp +316 -0
  320. package/runtime/ext_gui/browser.cpp +573 -0
  321. package/runtime/ext_gui/browser_escape.cpp +85 -0
  322. package/runtime/ext_gui/browser_loop.cpp +83 -0
  323. package/runtime/ext_gui/canvas.cpp +12 -21
  324. package/runtime/ext_gui/canvas_internal.h +10 -0
  325. package/runtime/ext_gui/canvas_raster.cpp +79 -1
  326. package/runtime/ext_gui/clip_values.cpp +246 -0
  327. package/runtime/ext_gui/css.cpp +94 -0
  328. package/runtime/ext_gui/css.h +22 -1
  329. package/runtime/ext_gui/css_match.cpp +3 -0
  330. package/runtime/ext_gui/css_selector.cpp +9 -0
  331. package/runtime/ext_gui/css_sheet.cpp +89 -45
  332. package/runtime/ext_gui/document.cpp +4 -1
  333. package/runtime/ext_gui/document.h +2 -0
  334. package/runtime/ext_gui/dom.h +16 -0
  335. package/runtime/ext_gui/dom_api.cpp +37 -0
  336. package/runtime/ext_gui/dom_api_canvas.cpp +17 -80
  337. package/runtime/ext_gui/dom_api_canvas_extra.cpp +130 -1
  338. package/runtime/ext_gui/dom_api_canvas_pending.cpp +41 -0
  339. package/runtime/ext_gui/dom_api_document.cpp +96 -5
  340. package/runtime/ext_gui/dom_api_events.cpp +20 -0
  341. package/runtime/ext_gui/dom_api_internal.h +278 -0
  342. package/runtime/ext_gui/dom_api_proto.cpp +6 -0
  343. package/runtime/ext_gui/dom_api_webgl.cpp +376 -0
  344. package/runtime/ext_gui/dom_api_webgl2.cpp +434 -0
  345. package/runtime/ext_gui/dom_api_webgl2_draw.cpp +269 -0
  346. package/runtime/ext_gui/dom_api_webgl_buffer.cpp +212 -0
  347. package/runtime/ext_gui/dom_api_webgl_rt.h +30 -0
  348. package/runtime/ext_gui/dom_api_webgl_shader.cpp +443 -0
  349. package/runtime/ext_gui/dom_api_webgl_state.cpp +444 -0
  350. package/runtime/ext_gui/dom_api_webgl_texture.cpp +445 -0
  351. package/runtime/ext_gui/effect_values.cpp +312 -0
  352. package/runtime/ext_gui/gradient_values.cpp +476 -0
  353. package/runtime/ext_gui/grid_values.cpp +230 -0
  354. package/runtime/ext_gui/gui.cpp +90 -23
  355. package/runtime/ext_gui/gui_canvas.cpp +50 -2
  356. package/runtime/ext_gui/gui_engine.h +71 -0
  357. package/runtime/ext_gui/gui_events.cpp +4 -1
  358. package/runtime/ext_gui/gui_media.cpp +1 -1
  359. package/runtime/ext_gui/gui_webgl.cpp +83 -0
  360. package/runtime/ext_gui/layout.cpp +21 -0
  361. package/runtime/ext_gui/layout_flow.cpp +81 -4
  362. package/runtime/ext_gui/layout_flow_internal.h +31 -0
  363. package/runtime/ext_gui/layout_grid.cpp +374 -0
  364. package/runtime/ext_gui/media.h +1 -1
  365. package/runtime/ext_gui/media_api.h +2 -2
  366. package/runtime/ext_gui/media_query.cpp +211 -0
  367. package/runtime/ext_gui/paint.cpp +111 -77
  368. package/runtime/ext_gui/paint.h +33 -3
  369. package/runtime/ext_gui/paint_background.cpp +229 -0
  370. package/runtime/ext_gui/paint_clip.cpp +268 -0
  371. package/runtime/ext_gui/paint_effects.cpp +324 -0
  372. package/runtime/ext_gui/paint_internal.h +85 -0
  373. package/runtime/ext_gui/renderer.cpp +8 -31
  374. package/runtime/ext_gui/renderer_clip.cpp +196 -0
  375. package/runtime/ext_gui/renderer_image.cpp +13 -8
  376. package/runtime/ext_gui/renderer_internal.h +15 -8
  377. package/runtime/ext_gui/renderer_text.cpp +6 -31
  378. package/runtime/ext_gui/style.cpp +343 -20
  379. package/runtime/ext_gui/style.h +144 -3
  380. package/runtime/ext_gui/style_print.cpp +134 -1
  381. package/runtime/ext_gui/style_values.cpp +152 -126
  382. package/runtime/ext_gui/style_values_internal.h +35 -0
  383. package/runtime/ext_gui/webgl.h +466 -0
  384. package/runtime/ext_gui/webgl2_constants.h +274 -0
  385. package/runtime/ext_gui/webgl_buffer.cpp +565 -0
  386. package/runtime/ext_gui/webgl_constants.h +317 -0
  387. package/runtime/ext_gui/webgl_context.cpp +466 -0
  388. package/runtime/ext_gui/webgl_draw.cpp +495 -0
  389. package/runtime/ext_gui/webgl_glsl.h +125 -0
  390. package/runtime/ext_gui/webgl_glsl_compile.cpp +431 -0
  391. package/runtime/ext_gui/webgl_glsl_rewrite.cpp +349 -0
  392. package/runtime/ext_gui/webgl_glsl_scan.cpp +581 -0
  393. package/runtime/ext_gui/webgl_msl.cpp +62 -0
  394. package/runtime/ext_gui/webgl_msl.h +33 -0
  395. package/runtime/ext_gui/webgl_pipeline.cpp +274 -0
  396. package/runtime/ext_gui/webgl_program_internal.h +18 -0
  397. package/runtime/ext_gui/webgl_shader.cpp +582 -0
  398. package/runtime/ext_gui/webgl_texture.cpp +293 -0
  399. package/runtime/ext_gui/webgl_uniform.cpp +167 -0
  400. package/runtime/ext_gui/webgl_webgl2.cpp +224 -0
  401. package/runtime/ext_gui/window.cpp +9 -0
  402. package/runtime/ext_media/media.cpp +1 -1
  403. package/runtime/ext_media/media_bridge.c +9 -3
  404. package/runtime/ext_node/path/path.c +7 -7
  405. package/runtime/ext_node/url/url.c +4 -2
  406. package/runtime/rt.h +15 -0
  407. package/runtime/rt_internal.h +1 -0
  408. package/runtime/xt_constructors.c +2 -1
  409. package/runtime/xt_containers/access.inc +8 -0
  410. package/runtime/xt_containers/objects.inc +22 -2
  411. package/runtime/xt_io/exception.inc +4 -2
  412. package/runtime/xt_regex/api.inc +2 -0
  413. package/runtime/xt_regex/matcher.inc +16 -3
  414. package/runtime/xt_regex/parser.inc +8 -2
  415. package/runtime/xt_regex/types.inc +3 -0
  416. package/runtime/xt_stdlib/math.inc +62 -0
  417. package/runtime/xt_stdlib2/date.inc +7 -1
  418. package/runtime/xt_stdlib2/objects.inc +14 -0
  419. package/runtime/xt_stdlib2/regexp-match.inc +60 -21
  420. package/runtime/xt_stdlib2/regexp.inc +1 -0
  421. package/runtime/xt_typed_array.c +1 -1
  422. package/scripts/build-gui.ts +90 -3
  423. package/scripts/build-media.ts +323 -58
  424. package/scripts/setup-vs-toolchain.ps1 +152 -0
  425. package/scripts/support-matrix.ts +167 -0
  426. package/src/ast/common.ts +2 -0
  427. package/src/ast/declarations.ts +12 -1
  428. package/src/ast/expressions.ts +6 -0
  429. package/src/ast/kinds.ts +2 -0
  430. package/src/binder/binder.ts +3 -0
  431. package/src/binder/declarations.ts +70 -0
  432. package/src/binder/references.ts +97 -4
  433. package/src/binder/types.ts +30 -0
  434. package/src/canonical.ts +37 -0
  435. package/src/checker/assignability.ts +134 -0
  436. package/src/checker/calls.ts +135 -0
  437. package/src/checker/checker.ts +47 -0
  438. package/src/checker/declarations.ts +26 -0
  439. package/src/checker/flow.ts +236 -0
  440. package/src/checker/globals.ts +40 -0
  441. package/src/checker/source.ts +53 -0
  442. package/src/checker/type-infer.ts +185 -0
  443. package/src/checker/type-model.ts +212 -0
  444. package/src/checker/type-system.ts +578 -0
  445. package/src/checker/typecheck-types.ts +112 -0
  446. package/src/checker/typecheck.ts +586 -0
  447. package/src/checker/undefined.ts +43 -0
  448. package/src/checker/walk.ts +16 -0
  449. package/src/cli/help.ts +65 -0
  450. package/src/cli/hints.ts +2 -1
  451. package/src/cli/main.ts +12 -49
  452. package/src/codegen/generator/calls/access.ts +8 -8
  453. package/src/codegen/generator/calls/invocation.ts +8 -5
  454. package/src/codegen/generator/calls/super.ts +67 -5
  455. package/src/codegen/generator/context.ts +31 -19
  456. package/src/codegen/generator/debug.ts +2 -1
  457. package/src/codegen/generator/expressions/primary.ts +84 -13
  458. package/src/codegen/generator/generator.ts +11 -1
  459. package/src/codegen/generator/module.ts +115 -24
  460. package/src/codegen/generator/state.ts +11 -1
  461. package/src/codegen/generator/statements/variables.ts +26 -6
  462. package/src/codegen/generator/tables.ts +5 -0
  463. package/src/driver/build-key.ts +3 -0
  464. package/src/driver/bundler/graph.ts +6 -2
  465. package/src/driver/bundler/merge.ts +14 -1
  466. package/src/driver/bundler/types.ts +13 -0
  467. package/src/driver/compiler.ts +4 -1
  468. package/src/driver/fingerprint.ts +2 -1
  469. package/src/driver/frontend.ts +13 -2
  470. package/src/driver/options.ts +6 -0
  471. package/src/driver/version.ts +1 -1
  472. package/src/extensions/gui/css.ts +113 -0
  473. package/src/extensions/gui/html.ts +31 -11
  474. package/src/extensions/gui/index.ts +81 -2
  475. package/src/extensions/gui/three.ts +25 -0
  476. package/src/extensions/media/index.ts +13 -16
  477. package/src/extensions/registry.ts +48 -0
  478. package/src/index.ts +1 -0
  479. package/src/parser/declarations/classes.ts +7 -0
  480. package/src/parser/expressions.ts +13 -1
  481. package/src/parser/literals.ts +6 -2
@@ -26,8 +26,14 @@ namespace guidev {
26
26
  SDL_GPUDevice *g_device = NULL;
27
27
  int g_sdl_initialized = 0;
28
28
  int g_quit = 0;
29
+ /** Set while `run()` owns the frame loop, so the browser frame pump in
30
+ * `browser_loop.cpp` does not render the same window twice per tick. */
31
+ int g_run_active = 0;
29
32
  XtGuiWindow g_windows[XT_GUI_MAX_WINDOWS];
30
33
  int g_window_count = 0;
34
+ /** Set when a window was opened implicitly (a browser global was read before
35
+ * `createWindow`), so the next `createWindow` adopts it. */
36
+ int g_implicit_window = 0;
31
37
 
32
38
  /* Optional application icon embedded at compile time by the driver (`--icon` /
33
39
  * `app.icon`). The symbols live in a small object the driver links into every
@@ -181,37 +187,25 @@ static int xt_gui_int_or(xt_value value, int fallback) {
181
187
  return (int)xt_to_number(value);
182
188
  }
183
189
 
184
- extern "C" xt_value xt_gui_create_window(int32_t argc, xt_value *argv) {
185
- if (!ensure_init()) return XT_UNDEFINED;
190
+ /* Build (and record) one window. Shared by `createWindow` and the implicit
191
+ * window a page written against `window`/`document` gets on first access. */
192
+ static XtGuiWindow *create_window_record(const char *title, int width, int height,
193
+ bool high_density) {
186
194
  if (g_window_count >= XT_GUI_MAX_WINDOWS) {
187
195
  fprintf(stderr, "xt_gui: too many windows (max %d)\n", XT_GUI_MAX_WINDOWS);
188
- return XT_UNDEFINED;
189
- }
190
-
191
- const char *title = "xbintsc gui";
192
- int width = 800;
193
- int height = 600;
194
- xt_value options = xt_arg(argc, argv, 0);
195
- if (XT_IS_OBJECT(options)) {
196
- title = xt_gui_string_or(xt_object_get_cstr(options, "title"), title);
197
- width = xt_gui_int_or(xt_object_get_cstr(options, "width"), width);
198
- height = xt_gui_int_or(xt_object_get_cstr(options, "height"), height);
199
- } else if (XT_IS_STRING(options)) {
200
- title = xt_string_data(options);
201
- width = xt_gui_int_or(xt_arg(argc, argv, 1), width);
202
- height = xt_gui_int_or(xt_arg(argc, argv, 2), height);
196
+ return NULL;
203
197
  }
204
-
205
- SDL_Window *window = SDL_CreateWindow(
206
- title, width, height, SDL_WINDOW_RESIZABLE | SDL_WINDOW_HIGH_PIXEL_DENSITY);
198
+ SDL_WindowFlags flags = SDL_WINDOW_RESIZABLE;
199
+ if (high_density) flags |= SDL_WINDOW_HIGH_PIXEL_DENSITY;
200
+ SDL_Window *window = SDL_CreateWindow(title, width, height, flags);
207
201
  if (window == NULL) {
208
202
  fprintf(stderr, "xt_gui: SDL_CreateWindow failed: %s\n", SDL_GetError());
209
- return XT_UNDEFINED;
203
+ return NULL;
210
204
  }
211
205
  if (!SDL_ClaimWindowForGPUDevice(g_device, window)) {
212
206
  fprintf(stderr, "xt_gui: SDL_ClaimWindowForGPUDevice failed: %s\n", SDL_GetError());
213
207
  SDL_DestroyWindow(window);
214
- return XT_UNDEFINED;
208
+ return NULL;
215
209
  }
216
210
  xt_gui_apply_icon(window);
217
211
 
@@ -249,12 +243,83 @@ extern "C" xt_value xt_gui_create_window(int32_t argc, xt_value *argv) {
249
243
  * still uses it, which is a use-after-free. Rooting the window object makes
250
244
  * everything hanging off it reachable. */
251
245
  xt_gc_add_root(&record->object);
246
+ return record;
247
+ }
248
+
249
+ /** The window `window`/`document` refer to: the most recent live one, created
250
+ * on demand. A page that reads `window.innerWidth` while its modules
251
+ * initialize therefore has a real window before `createWindow` runs — and
252
+ * `createWindow` then *adopts* it (see below) instead of opening a second one. */
253
+ xt_value xt_gui_ensure_window(void) {
254
+ for (int i = g_window_count - 1; i >= 0; i--) {
255
+ if (g_windows[i].open) return g_windows[i].object;
256
+ }
257
+ if (!ensure_init()) return XT_UNDEFINED;
258
+ XtGuiWindow *record = create_window_record("xbintsc gui", 800, 600, true);
259
+ if (record == NULL) return XT_UNDEFINED;
260
+ g_implicit_window = 1;
261
+ return record->object;
262
+ }
252
263
 
253
- return object;
264
+ extern "C" xt_value xt_gui_create_window(int32_t argc, xt_value *argv) {
265
+ if (!ensure_init()) return XT_UNDEFINED;
266
+
267
+ const char *title = "xbintsc gui";
268
+ int width = 800;
269
+ int height = 600;
270
+ bool high_density = true;
271
+ xt_value options = xt_arg(argc, argv, 0);
272
+ if (XT_IS_OBJECT(options)) {
273
+ title = xt_gui_string_or(xt_object_get_cstr(options, "title"), title);
274
+ width = xt_gui_int_or(xt_object_get_cstr(options, "width"), width);
275
+ height = xt_gui_int_or(xt_object_get_cstr(options, "height"), height);
276
+ xt_value density = xt_object_get_cstr(options, "highDensity");
277
+ if (!XT_IS_UNDEFINED(density)) high_density = xt_truthy(density);
278
+ } else if (XT_IS_STRING(options)) {
279
+ title = xt_string_data(options);
280
+ width = xt_gui_int_or(xt_arg(argc, argv, 1), width);
281
+ height = xt_gui_int_or(xt_arg(argc, argv, 2), height);
282
+ }
283
+
284
+ /* A global (`window.innerWidth` while the page's modules initialize) already
285
+ * opened a window for this program; make it *the* window instead of leaving
286
+ * an invisible one behind. */
287
+ if (g_implicit_window != 0) {
288
+ g_implicit_window = 0;
289
+ XtGuiWindow *record = &g_windows[0];
290
+ SDL_SetWindowTitle(record->window, title);
291
+ SDL_SetWindowSize(record->window, width, height);
292
+ /* `SDL_SetWindowSize` only *requests* the new size. The X11 and Wayland
293
+ * backends send the request and learn the result from the server's resize
294
+ * event, so until that event is pumped `SDL_GetWindowSize` still reports
295
+ * the implicit window's 800x600 — which is what `innerWidth`/`innerHeight`
296
+ * (and `loadHTML`'s initial layout) read. A page that asks for its viewport
297
+ * in the first frame would then race the server and see the old size, a
298
+ * flake that CI saw under Xvfb. Settle the request here; the call is
299
+ * bounded by the backend's own timeout (100 ms on X11). */
300
+ SDL_SyncWindow(record->window);
301
+ record->width = width;
302
+ record->height = height;
303
+ return record->object;
304
+ }
305
+
306
+ XtGuiWindow *record = create_window_record(title, width, height, high_density);
307
+ return record != NULL ? record->object : XT_UNDEFINED;
254
308
  }
255
309
 
256
310
  /* -- run() / quit() ------------------------------------------------------- */
257
311
 
312
+ /* Poll and dispatch pending SDL events once. `run()` owns the loop for a program
313
+ * that calls it; a *browser-style* page (one that drives itself from
314
+ * `requestAnimationFrame` and never calls `run`) is pumped from the runtime's
315
+ * timer queue instead, and needs the same input dispatch per frame. */
316
+ extern "C" int xt_gui_run_active(void) { return g_run_active; }
317
+
318
+ extern "C" void xt_gui_pump_events(void) {
319
+ SDL_Event event;
320
+ while (SDL_PollEvent(&event)) handle_event(&event);
321
+ }
322
+
258
323
  extern "C" xt_value xt_gui_run(int32_t argc, xt_value *argv) {
259
324
  (void)argc;
260
325
  (void)argv;
@@ -264,6 +329,7 @@ extern "C" xt_value xt_gui_run(int32_t argc, xt_value *argv) {
264
329
  if (autoclose != NULL && autoclose[0] != '\0') {
265
330
  deadline = SDL_GetTicks() + (Uint64)SDL_atoi(autoclose);
266
331
  }
332
+ g_run_active = 1;
267
333
  while (!g_quit) {
268
334
  SDL_Event event;
269
335
  int had_event = 0;
@@ -289,6 +355,7 @@ extern "C" xt_value xt_gui_run(int32_t argc, xt_value *argv) {
289
355
  if (!had_event) SDL_Delay(1);
290
356
  }
291
357
 
358
+ g_run_active = 0;
292
359
  SDL_GPUDevice *device = g_device;
293
360
  if (device != NULL) {
294
361
  SDL_WaitForGPUIdle(device);
@@ -65,11 +65,17 @@ xtgui::Canvas2D *xt_gui_canvas_get(XtGuiWindow *win, const xtgui::Node *node) {
65
65
  auto canvas = std::make_unique<xtgui::Canvas2D>(width, height);
66
66
  xtgui::Canvas2D *raw = canvas.get();
67
67
  win->canvases[node] = std::move(canvas);
68
+ /* A context obtained after the first frame must reach the display list
69
+ * immediately, so `paintList`/the next paint sees its size and texture id. */
70
+ if (win->document != nullptr) {
71
+ win->document->setCanvasInfo(node, (float)width, (float)height, raw->id());
72
+ }
68
73
  return raw;
69
74
  }
70
75
 
71
76
  void xt_gui_canvas_forget(XtGuiWindow *win, const xtgui::Node *node) {
72
77
  if (win == nullptr || node == nullptr) return;
78
+ xt_gui_webgl_forget(win, node);
73
79
  auto found = win->canvases.find(node);
74
80
  if (found == win->canvases.end()) return;
75
81
  releaseCanvasTexture(found->second.get());
@@ -81,8 +87,46 @@ void xt_gui_canvas_sync(XtGuiWindow *win) {
81
87
  std::vector<const xtgui::Node *> nodes;
82
88
  collectCanvases(win->document->root(), &nodes);
83
89
  for (const xtgui::Node *node : nodes) {
84
- xtgui::Canvas2D *canvas = xt_gui_canvas_get(win, node);
85
- if (canvas == nullptr) continue;
90
+ if (xtgui::WebGLContext *webgl = xt_gui_webgl_find(win, node)) {
91
+ win->document->setCanvasInfo(node, (float)webgl->width(), (float)webgl->height(),
92
+ webgl->id());
93
+ continue;
94
+ }
95
+ xtgui::Canvas2D *canvas = xt_gui_canvas_find(win, node);
96
+ if (canvas != nullptr) {
97
+ win->document->setCanvasInfo(node, (float)canvas->width(), (float)canvas->height(),
98
+ canvas->id());
99
+ continue;
100
+ }
101
+ /* No context yet: the attributes still define the intrinsic box, but there
102
+ * is nothing to paint (a canvas with no context is transparent). */
103
+ int width = canvasAttributeSize(node, "width", 300);
104
+ int height = canvasAttributeSize(node, "height", 150);
105
+ win->document->setCanvasInfo(node, (float)width, (float)height, 0);
106
+ }
107
+ }
108
+
109
+ void xt_gui_canvas_bind_pending(XtGuiWindow *win, const xtgui::Node *node, xt_value handle) {
110
+ if (win == nullptr || node == nullptr) return;
111
+ xt_value pending = xt_object_get_cstr(handle, "__xt_gui_pending_canvas");
112
+ if (!XT_IS_NUMBER(pending)) return;
113
+ uint64_t id = (uint64_t)xt_to_number(pending);
114
+ xt_object_set(handle, xt_string_from_cstr("__xt_gui_pending_canvas"), XT_UNDEFINED);
115
+ auto found = win->pending_canvases.find(id);
116
+ if (found == win->pending_canvases.end()) return;
117
+ if (!isCanvasElement(node)) {
118
+ win->pending_canvases.erase(found);
119
+ return;
120
+ }
121
+ xtgui::Canvas2D *canvas = found->second.get();
122
+ /* The parsed element's width/height attributes win over the default 300x150
123
+ * a pre-load context started with. */
124
+ int width = canvasAttributeSize(node, "width", canvas->width());
125
+ int height = canvasAttributeSize(node, "height", canvas->height());
126
+ if (width != canvas->width() || height != canvas->height()) canvas->resize(width, height);
127
+ win->canvases[node] = std::move(found->second);
128
+ win->pending_canvases.erase(found);
129
+ if (win->document != nullptr) {
86
130
  win->document->setCanvasInfo(node, (float)canvas->width(), (float)canvas->height(),
87
131
  canvas->id());
88
132
  }
@@ -90,6 +134,10 @@ void xt_gui_canvas_sync(XtGuiWindow *win) {
90
134
 
91
135
  void xt_gui_canvas_shutdown(XtGuiWindow *win) {
92
136
  if (win == nullptr) return;
137
+ xt_gui_webgl_shutdown(win);
93
138
  for (auto &entry : win->canvases) releaseCanvasTexture(entry.second.get());
94
139
  win->canvases.clear();
140
+ /* `pending_canvases` survives `loadHTML`: a module that asked for a context
141
+ * before the page existed still needs its bitmap when the parsed element
142
+ * binds. They are released with the window record. */
95
143
  }
@@ -28,6 +28,48 @@ xt_value xt_register_script(int32_t argc, xt_value *argv);
28
28
  * `"metal"`, …), or `""` before the device exists. */
29
29
  const char *xt_gui_driver(void);
30
30
 
31
+ /** The window handle the browser globals (`window`, `document`) refer to: the
32
+ * most recent live one, opened on demand. `createWindow` adopts that implicit
33
+ * window instead of opening a second one. */
34
+ xt_value xt_gui_ensure_window(void);
35
+
36
+ /* The browser globals a page reaches by bare name. Code generation lowers each
37
+ * identifier (or bare call) to one of these; nothing is declared in the source.
38
+ * See `src/extensions/gui/index.ts` (`globalValues` / `builtins`) and
39
+ * `runtime/ext_gui/browser.cpp`. */
40
+ xt_value xt_browser_window(int32_t argc, xt_value *argv);
41
+ xt_value xt_browser_document(int32_t argc, xt_value *argv);
42
+ xt_value xt_browser_navigator(int32_t argc, xt_value *argv);
43
+ xt_value xt_browser_local_storage(int32_t argc, xt_value *argv);
44
+ /** A global the host deliberately does not provide: `undefined`. */
45
+ xt_value xt_browser_missing(int32_t argc, xt_value *argv);
46
+ /** A DOM type name (`Image`, `HTMLCanvasElement`, …) as a constructor value. */
47
+ xt_value xt_browser_type(int32_t argc, xt_value *argv);
48
+ xt_value xt_browser_request_animation_frame(int32_t argc, xt_value *argv);
49
+ xt_value xt_browser_cancel_animation_frame(int32_t argc, xt_value *argv);
50
+ xt_value xt_browser_match_media(int32_t argc, xt_value *argv);
51
+ xt_value xt_browser_computed_style(int32_t argc, xt_value *argv);
52
+ xt_value xt_browser_escape(int32_t argc, xt_value *argv);
53
+ xt_value xt_browser_alert(int32_t argc, xt_value *argv);
54
+ xt_value xt_browser_prompt(int32_t argc, xt_value *argv);
55
+ /** Install `innerWidth`, `setTimeout`, `navigator`, … on the window prototype. */
56
+ void xt_browser_install_window(xt_value proto);
57
+ /** Poll and dispatch pending SDL input events once (the browser frame pump in
58
+ * `browser.cpp` calls it; `run()` has its own loop). */
59
+ void xt_gui_pump_events(void);
60
+ /** Arm the frame pump for a page that drives itself from
61
+ * `requestAnimationFrame` instead of calling `run()` (see `browser_loop.cpp`). */
62
+ void xt_browser_schedule_frame(void);
63
+ /** Whether `run()` currently owns the frame loop (the pump then stays idle). */
64
+ int xt_gui_run_active(void);
65
+
66
+ /* Web Audio objects (`audio.cpp`). */
67
+ /** `AudioContext.prototype` — also the `instanceof AudioContext` target. */
68
+ xt_value xt_gui_audio_proto(void);
69
+ /** `new AudioContext(...)`: it has no mixer backend yet, so the graph records
70
+ * its shape and parameters but nothing is rendered to the sound device. */
71
+ xt_value xt_gui_audio_create(int32_t argc, xt_value *argv);
72
+
31
73
  #ifdef __cplusplus
32
74
  } /* extern "C" */
33
75
 
@@ -42,6 +84,7 @@ const char *xt_gui_driver(void);
42
84
  #include "document.h"
43
85
  #include "media.h"
44
86
  #include "renderer.h"
87
+ #include "webgl.h"
45
88
 
46
89
  /** One element-level event listener registered through `addEventListener`. */
47
90
  struct XtGuiNodeListener {
@@ -120,6 +163,14 @@ struct XtGuiWindow {
120
163
  * lazily by `getContext("2d")` (or by `xt_gui_canvas_sync` for a live canvas),
121
164
  * released when the node is forgotten or the document reloads. */
122
165
  std::unordered_map<const xtgui::Node *, std::unique_ptr<xtgui::Canvas2D>> canvases;
166
+ /** One WebGL context per `<canvas>` that asked for `getContext("webgl")`.
167
+ * A canvas uses either this map or `canvases`, never both. */
168
+ std::unordered_map<const xtgui::Node *, std::unique_ptr<xtgui::WebGLContext>> webgl_canvases;
169
+ /** Canvases whose element handle was created before `loadHTML` (a module
170
+ * that calls `getElementById("scene").getContext("2d")` while it
171
+ * initialises). Keyed by canvas id; moved into `canvases` when the pending
172
+ * handle binds to the parsed element. */
173
+ std::unordered_map<uint64_t, std::unique_ptr<xtgui::Canvas2D>> pending_canvases;
123
174
  /** The batch currently running: its callbacks have been swapped out of
124
175
  * `animation_frames`, and a collection triggered by one of them must still
125
176
  * see the rest. Kept on the record (not a local) so the GC root provider can
@@ -130,6 +181,8 @@ struct XtGuiWindow {
130
181
 
131
182
  /** Resolve a window handle (`this`) to its record, or NULL for a foreign value. */
132
183
  XtGuiWindow *xt_gui_window_from_this(xt_value thisValue);
184
+
185
+
133
186
  /** The `document` handle for `win` (created on first use). */
134
187
  xt_value xt_gui_document_handle(XtGuiWindow *win);
135
188
  /** Node handle for `node` (created and cached on first use). */
@@ -199,12 +252,30 @@ xtgui::Canvas2D *xt_gui_canvas_get(XtGuiWindow *win, const xtgui::Node *node);
199
252
  xtgui::Canvas2D *xt_gui_canvas_find(XtGuiWindow *win, const xtgui::Node *node);
200
253
  /** Drop a node's canvas (called when its handle is forgotten). */
201
254
  void xt_gui_canvas_forget(XtGuiWindow *win, const xtgui::Node *node);
255
+ /** Move a pre-load canvas into the live table when its pending element handle
256
+ * binds. `handle` is the DOM handle that was used for `getContext("2d")`. */
257
+ void xt_gui_canvas_bind_pending(XtGuiWindow *win, const xtgui::Node *node, xt_value handle);
258
+
202
259
  /** Publish live canvases to the document (sizes + render ids) so layout and
203
260
  * paint see them; creates a context for a canvas that has none yet. */
204
261
  void xt_gui_canvas_sync(XtGuiWindow *win);
205
262
  /** Release every canvas of `win` (window close / `loadHTML`). */
206
263
  void xt_gui_canvas_shutdown(XtGuiWindow *win);
207
264
 
265
+ /** The WebGL context of a `<canvas>`, creating it on first use. `webgl2`
266
+ * selects the WebGL 2 API/prototype; a canvas keeps the first context kind it
267
+ * asked for, so a later request for the other one answers null. */
268
+ xtgui::WebGLContext *xt_gui_webgl_get(XtGuiWindow *win, const xtgui::Node *node, bool webgl2);
269
+ /** The existing WebGL context of `node`, or null (no side effects). */
270
+ xtgui::WebGLContext *xt_gui_webgl_find(XtGuiWindow *win, const xtgui::Node *node);
271
+ /** Drop a node's WebGL context (called when its handle is forgotten). */
272
+ void xt_gui_webgl_forget(XtGuiWindow *win, const xtgui::Node *node);
273
+ /** Release every WebGL context of `win`. */
274
+ void xt_gui_webgl_shutdown(XtGuiWindow *win);
275
+ /** Submit every live WebGL context's queued commands. Called once per frame
276
+ * before the page's own render pass samples a canvas texture. */
277
+ void xt_gui_webgl_submit_all();
278
+
208
279
  #endif /* __cplusplus */
209
280
 
210
281
  #endif /* XT_GUI_ENGINE_H */
@@ -272,7 +272,7 @@ void xt_gui_render_window(XtGuiWindow *win) {
272
272
  bool can_paint = xt_gui_renderer_ensure(g_device, win->window);
273
273
  if (can_paint && win->geometry.dirty && win->document != nullptr) {
274
274
  xtgui::DisplayList list;
275
- xtgui::xt_paint_build(win->document->layout().root(), list);
275
+ xtgui::xt_paint_build(win->document->layout().root(), list, viewport_width, viewport_height);
276
276
  xt_gui_geometry_upload(g_device, &win->geometry, list);
277
277
  float density = SDL_GetWindowPixelDensity(win->window);
278
278
  float text_scale = density > 0.0f ? density : 1.0f;
@@ -287,6 +287,9 @@ void xt_gui_render_window(XtGuiWindow *win) {
287
287
  xt_gui_media_upload_frames(g_device);
288
288
  /* Canvases are CPU-drawn: push any new bitmap without a relayout. */
289
289
  xt_gui_canvas_upload_frames(g_device);
290
+ /* WebGL contexts record into their own command buffers; submit them first so
291
+ * the page's render pass samples this frame's drawing-buffer contents. */
292
+ xt_gui_webgl_submit_all();
290
293
  SDL_GPUCommandBuffer *cmd = SDL_AcquireGPUCommandBuffer(g_device);
291
294
  if (cmd == NULL) return;
292
295
  SDL_GPUTexture *swapchain = NULL;
@@ -8,7 +8,7 @@
8
8
  * - the renderer (`renderer_image.cpp`), which owns the GPU textures.
9
9
  *
10
10
  * It also provides the SDL audio sink the decoder writes PCM to, which keeps
11
- * SDL out of `media.a`.
11
+ * SDL out of `media.a`/`media.lib`.
12
12
  *
13
13
  * The frame loop calls `xt_gui_media_sync` (open/close decoders so the next
14
14
  * layout sees the current sources and intrinsic sizes) and `xt_gui_media_tick`
@@ -0,0 +1,83 @@
1
+ /*
2
+ * xbintsc GUI engine — `<canvas>` WebGL lifetime.
3
+ *
4
+ * A WebGL context is owned by the window, keyed by its DOM element (the same
5
+ * shape as the 2D canvas and video tables). Its colour texture is what the
6
+ * page's image pipeline samples, so no pixels pass through the CPU.
7
+ */
8
+
9
+ #include <memory>
10
+
11
+ #include "gui_engine.h"
12
+ #include "gui_internal.h"
13
+
14
+ namespace {
15
+
16
+ bool isCanvasElement(const xtgui::Node *node) {
17
+ return node != nullptr && node->isElement() && node->isTag("canvas");
18
+ }
19
+
20
+ uint64_t next_webgl_id() {
21
+ static uint64_t counter = 0;
22
+ counter++;
23
+ /* Keep WebGL ids out of the Canvas2D id space so the renderer can tell the
24
+ * two kinds of canvas apart from the id alone. */
25
+ return (1ULL << 32) | counter;
26
+ }
27
+
28
+ } // namespace
29
+
30
+ xtgui::WebGLContext *xt_gui_webgl_find(XtGuiWindow *win, const xtgui::Node *node) {
31
+ if (win == nullptr || node == nullptr) return nullptr;
32
+ auto found = win->webgl_canvases.find(node);
33
+ return found == win->webgl_canvases.end() ? nullptr : found->second.get();
34
+ }
35
+
36
+ xtgui::WebGLContext *xt_gui_webgl_get(XtGuiWindow *win, const xtgui::Node *node, bool webgl2) {
37
+ if (win == nullptr || !isCanvasElement(node)) return nullptr;
38
+ xtgui::WebGLContext *existing = xt_gui_webgl_find(win, node);
39
+ if (existing != nullptr) return existing->is_webgl2() == webgl2 ? existing : nullptr;
40
+ if (win->canvases.find(node) != win->canvases.end()) return nullptr; // already a 2D canvas
41
+ /* WebGL shaders reach SDL_GPU as SPIR-V (Vulkan, translated by glslang) or as
42
+ * MSL (Metal, the same module cross-compiled by SPIRV-Cross). A device whose
43
+ * backend consumes neither format — Direct3D 12 needs DXIL — has no WebGL
44
+ * context in this build, so `getContext("webgl")` answers null instead of
45
+ * handing out a context whose draws could never create a pipeline. */
46
+ if (guidev::g_device == nullptr ||
47
+ (SDL_GetGPUShaderFormats(guidev::g_device) &
48
+ (SDL_GPU_SHADERFORMAT_SPIRV | SDL_GPU_SHADERFORMAT_MSL)) == 0) {
49
+ return nullptr;
50
+ }
51
+ const std::string *width_attr = node->attr("width");
52
+ const std::string *height_attr = node->attr("height");
53
+ float width = 300.0f;
54
+ float height = 150.0f;
55
+ if (width_attr != nullptr) xtgui::xt_css_parse_number(*width_attr, &width);
56
+ if (height_attr != nullptr) xtgui::xt_css_parse_number(*height_attr, &height);
57
+ auto context = std::make_unique<xtgui::WebGLContext>(
58
+ next_webgl_id(), (int)(width + 0.5f), (int)(height + 0.5f), webgl2);
59
+ xtgui::WebGLContext *raw = context.get();
60
+ win->webgl_canvases[node] = std::move(context);
61
+ if (win->document != nullptr) {
62
+ win->document->setCanvasInfo(node, (float)raw->width(), (float)raw->height(), raw->id());
63
+ }
64
+ return raw;
65
+ }
66
+
67
+ void xt_gui_webgl_forget(XtGuiWindow *win, const xtgui::Node *node) {
68
+ if (win == nullptr || node == nullptr) return;
69
+ win->webgl_canvases.erase(node);
70
+ }
71
+
72
+ void xt_gui_webgl_shutdown(XtGuiWindow *win) {
73
+ if (win == nullptr) return;
74
+ win->webgl_canvases.clear();
75
+ }
76
+
77
+ void xt_gui_webgl_submit_all() {
78
+ for (int i = 0; i < XT_GUI_MAX_WINDOWS; i++) {
79
+ XtGuiWindow &win = guidev::g_windows[i];
80
+ if (!win.open) continue;
81
+ for (auto &entry : win.webgl_canvases) entry.second->submit();
82
+ }
83
+ }
@@ -123,6 +123,21 @@ std::unique_ptr<LayoutBox> buildBoxTree(const Node *node,
123
123
  if (box->intrinsic_height <= 0.0f) box->intrinsic_height = 150.0f;
124
124
  }
125
125
  if (box->is_inline_svg) return box;
126
+
127
+ /* `::before` / `::after` boxes are emitted around the DOM children. Only a
128
+ * pseudo-element with `content` generates a box (CSS: a `::before` rule with
129
+ * no content has no effect). Replaced elements never generate them. */
130
+ auto appendPseudo = [&](Node *pseudo) {
131
+ if (pseudo == nullptr || box->is_image || box->is_canvas || box->is_media) return;
132
+ auto pseudoStyle = styles.find(pseudo);
133
+ if (pseudoStyle == styles.end() || !pseudoStyle->second.has_content) return;
134
+ std::unique_ptr<LayoutBox> pseudoBox = buildBoxTree(pseudo, styles, style, media, canvases);
135
+ if (pseudoBox != nullptr) {
136
+ pseudoBox->parent = box.get();
137
+ box->children.push_back(std::move(pseudoBox));
138
+ }
139
+ };
140
+ if (node->isElement() && !node->is_pseudo) appendPseudo(node->pseudo_before);
126
141
  for (const std::unique_ptr<Node> &child : node->children) {
127
142
  std::unique_ptr<LayoutBox> childBox =
128
143
  buildBoxTree(child.get(), styles, style, media, canvases);
@@ -131,6 +146,7 @@ std::unique_ptr<LayoutBox> buildBoxTree(const Node *node,
131
146
  box->children.push_back(std::move(childBox));
132
147
  }
133
148
  }
149
+ if (node->isElement() && !node->is_pseudo) appendPseudo(node->pseudo_after);
134
150
  return box;
135
151
  }
136
152
 
@@ -211,15 +227,20 @@ namespace {
211
227
 
212
228
  const LayoutBox *hitTestBox(const LayoutBox *box, float x, float y) {
213
229
  if (box == nullptr || box->display == Display::None) return nullptr;
230
+ if (box->style != nullptr && !box->style->visible) return nullptr;
214
231
  /* Later siblings paint on top, so probe them first. */
215
232
  for (auto it = box->children.rbegin(); it != box->children.rend(); ++it) {
216
233
  if (const LayoutBox *hit = hitTestBox(it->get(), x, y)) return hit;
217
234
  }
235
+ if (box->style != nullptr && !box->style->pointer_events) return nullptr;
218
236
  float local_x = x;
219
237
  float local_y = y;
220
238
  if (box->has_transform) box->inverse.apply(x, y, &local_x, &local_y);
221
239
  if (local_x >= box->x && local_x < box->x + box->width && local_y >= box->y &&
222
240
  local_y < box->y + box->height) {
241
+ /* A generated box is part of its originating element: events must target
242
+ * the real element handle, not the synthetic node. */
243
+ if (box->node != nullptr && box->node->is_pseudo && box->parent != nullptr) return box->parent;
223
244
  return box;
224
245
  }
225
246
  return nullptr;
@@ -46,6 +46,24 @@ float Layouter::preferredContentWidth(const LayoutBox *box, float available) con
46
46
  if (!isAuto(style.width)) return px(style.width, available, style.font_size, 0.0f);
47
47
  if ((box->is_image || box->is_canvas || box->is_inline_svg) && box->intrinsic_width > 0)
48
48
  return box->intrinsic_width;
49
+ if (box->is_text) return textWidth(box->text, style);
50
+ /* A row flex container's intrinsic width is the sum of its items (and gaps);
51
+ * taking the widest child would make a shrink-to-fit toolbar narrower than
52
+ * its buttons and then shrink every button to zero. */
53
+ if (style.display == Display::Flex &&
54
+ (style.flex_direction == FlexDirection::Row ||
55
+ style.flex_direction == FlexDirection::RowReverse)) {
56
+ float total = 0;
57
+ int count = 0;
58
+ for (const std::unique_ptr<LayoutBox> &child : box->children) {
59
+ if (child->display == Display::None || isAbsoluteChild(child.get())) continue;
60
+ if (isCollapsibleText(child.get())) continue;
61
+ total += preferredContentWidth(child.get(), available) + horizontalEdges(child.get());
62
+ count++;
63
+ }
64
+ if (count > 1) total += px(style.column_gap, available, style.font_size, 0.0f) * (float)(count - 1);
65
+ return total;
66
+ }
49
67
  float best = 0;
50
68
  for (const std::unique_ptr<LayoutBox> &child : box->children) {
51
69
  if (child->display == Display::None) continue;
@@ -165,10 +183,41 @@ void Layouter::applyPosition(LayoutBox *box) const {
165
183
  translate(box, x - box->x, y - box->y);
166
184
  }
167
185
 
186
+ namespace {
187
+ void clearTextFragments(LayoutBox *box) {
188
+ if (box == nullptr) return;
189
+ box->fragments.clear();
190
+ for (const std::unique_ptr<LayoutBox> &child : box->children) clearTextFragments(child.get());
191
+ }
192
+ } // namespace
193
+
168
194
  float Layouter::layoutBlock(LayoutBox *box, float x, float y, float availableWidth,
169
195
  float availableHeight, float forcedContentWidth,
170
196
  float forcedContentHeight, bool inFlow) const {
171
197
  const XtStyle &style = *box->style;
198
+ /* Flex and grid measure an item before placing it; inline runs append to the
199
+ * text boxes' fragment lists, so drop the previous pass's fragments first. */
200
+ clearTextFragments(box);
201
+
202
+ /* A text box is normally laid out by its parent's inline formatting context.
203
+ * Flex/grid items can be text boxes themselves (`<kbd>W</kbd>` with
204
+ * `display:grid`), and `layoutChildren` would otherwise give them no geometry
205
+ * or fragment at all — the glyph then silently disappears from paint. */
206
+ if (box->is_text) {
207
+ float textW = textWidth(box->text, style);
208
+ float textH = lineHeightOf(style);
209
+ box->x = x;
210
+ box->y = y;
211
+ box->content_x = x;
212
+ box->content_y = y;
213
+ box->width = textW;
214
+ box->content_width = textW;
215
+ box->height = textH;
216
+ box->content_height = textH;
217
+ box->baseline = textH;
218
+ box->fragments.push_back({x, y, textW, textH, box->text});
219
+ return textH;
220
+ }
172
221
  float em = style.font_size;
173
222
  resolveEdges(box, availableWidth);
174
223
 
@@ -197,6 +246,9 @@ float Layouter::layoutBlock(LayoutBox *box, float x, float y, float availableWid
197
246
  }
198
247
  } else {
199
248
  contentWidth = px(style.width, availableWidth, em);
249
+ if (style.box_sizing == BoxSizing::BorderBox) {
250
+ contentWidth -= box->border_left + box->border_right + box->padding_left + box->padding_right;
251
+ }
200
252
  }
201
253
  contentWidth = clampSize(contentWidth, style.min_width, style.max_width, availableWidth, em);
202
254
  if (contentWidth < 0) contentWidth = 0;
@@ -212,6 +264,19 @@ float Layouter::layoutBlock(LayoutBox *box, float x, float y, float availableWid
212
264
  float definiteHeight = -1;
213
265
  if (!isAuto(style.height) && !(style.height.unit == Unit::Percent && availableHeight < 0)) {
214
266
  definiteHeight = px(style.height, availableHeight, em, -1);
267
+ if (style.box_sizing == BoxSizing::BorderBox && definiteHeight >= 0) {
268
+ definiteHeight -= box->border_top + box->border_bottom + box->padding_top + box->padding_bottom;
269
+ if (definiteHeight < 0) definiteHeight = 0;
270
+ }
271
+ } else if (outOfFlow && !isAuto(style.top) && !isAuto(style.bottom)) {
272
+ /* An absolutely positioned box with both vertical insets set and `height:
273
+ * auto` fills the containing block (the full-screen overlays rely on
274
+ * `inset: 0`). `layoutBlock` otherwise only knows definite heights from
275
+ * `height`, so derive it here. */
276
+ float top = px(style.top, box->cb_height, em);
277
+ float bottom = px(style.bottom, box->cb_height, em);
278
+ definiteHeight = box->cb_height - top - bottom - verticalEdges(box);
279
+ if (definiteHeight < 0) definiteHeight = 0;
215
280
  }
216
281
 
217
282
  float contentHeight;
@@ -225,9 +290,15 @@ float Layouter::layoutBlock(LayoutBox *box, float x, float y, float availableWid
225
290
  availableHeight < 0 ? contentHeight : availableHeight, em);
226
291
  if (contentHeight < 0) contentHeight = 0;
227
292
  }
228
- /* Replaced elements keep their aspect ratio when only one axis is set. */
293
+ /* Replaced elements keep their aspect ratio when only one axis is set. A
294
+ * percentage height in an indefinite containing block behaves like `auto`
295
+ * (CSS 10.5), so it must take this path too: the portrait canvases are
296
+ * `height: 100%` inside a shrink-to-fit frame and were otherwise zero-height
297
+ * and invisible. */
298
+ bool replacedHeightAuto =
299
+ isAuto(style.height) || (style.height.unit == Unit::Percent && availableHeight < 0);
229
300
  if ((box->is_image || box->is_canvas || box->is_inline_svg) && forcedContentHeight < 0 &&
230
- isAuto(style.height) && box->intrinsic_width > 0 && box->intrinsic_height > 0) {
301
+ replacedHeightAuto && box->intrinsic_width > 0 && box->intrinsic_height > 0) {
231
302
  contentHeight = contentWidth * box->intrinsic_height / box->intrinsic_width;
232
303
  }
233
304
  box->content_height = contentHeight;
@@ -255,7 +326,11 @@ void Layouter::layoutAbsoluteChildren(LayoutBox *block, float contentWidth,
255
326
  float availableHeight) const {
256
327
  for (const std::unique_ptr<LayoutBox> &child : block->children) {
257
328
  if (child->display == Display::None || !isAbsoluteChild(child.get())) continue;
258
- setContainingBlock(child.get(), block);
329
+ /* An absolute box resolves against the nearest *positioned* ancestor, not
330
+ * necessarily its parent: under a static <body> the containing block is the
331
+ * initial containing block (the viewport). Passing the parent directly made
332
+ * `inset:0` hug the body's content height instead of filling the window. */
333
+ setContainingBlock(child.get(), containingBlockAncestor(block));
259
334
  layoutBlock(child.get(), block->content_x, block->content_y, contentWidth, availableHeight, -1,
260
335
  -1, false);
261
336
  }
@@ -265,6 +340,8 @@ float Layouter::layoutChildren(LayoutBox *block, float contentWidth, float avail
265
340
  float definiteHeight) const {
266
341
  if (block->style->display == Display::Flex)
267
342
  return layoutFlex(block, contentWidth, definiteHeight);
343
+ if (block->style->display == Display::Grid)
344
+ return layoutGrid(block, contentWidth, definiteHeight);
268
345
 
269
346
  float y = block->content_y;
270
347
  float startY = y;
@@ -345,7 +422,7 @@ float Layouter::layoutChildren(LayoutBox *block, float contentWidth, float avail
345
422
  continue;
346
423
  }
347
424
  if (display == Display::Block || display == Display::ListItem || display == Display::Flex ||
348
- child->style == nullptr) {
425
+ display == Display::Grid || child->style == nullptr) {
349
426
  flush();
350
427
  resolveEdges(child.get(), contentWidth);
351
428
  /* Adjacent vertical margins collapse: the gap is the collapsed value of