xbintsc 0.5.22 → 0.5.31

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 (391) hide show
  1. package/AGENTS.md +12 -3
  2. package/README.md +46 -11
  3. package/README.zh-CN.md +32 -6
  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 +85 -3
  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 +13 -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 +2 -0
  93. package/dist/src/codegen/generator/module.js +62 -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 +20 -3
  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 +4 -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/catalog.js +2 -1
  122. package/dist/src/extensions/catalog.js.map +1 -1
  123. package/dist/src/extensions/gui/html.js +20 -6
  124. package/dist/src/extensions/gui/html.js.map +1 -1
  125. package/dist/src/extensions/gui/index.js +63 -0
  126. package/dist/src/extensions/gui/index.js.map +1 -1
  127. package/dist/src/extensions/media/index.d.ts +27 -0
  128. package/dist/src/extensions/media/index.js +60 -0
  129. package/dist/src/extensions/media/index.js.map +1 -0
  130. package/dist/src/extensions/registry.d.ts +50 -0
  131. package/dist/src/extensions/registry.js +26 -0
  132. package/dist/src/extensions/registry.js.map +1 -1
  133. package/dist/src/index.d.ts +2 -0
  134. package/dist/src/index.js +2 -0
  135. package/dist/src/index.js.map +1 -1
  136. package/dist/src/parser/declarations/classes.js +7 -0
  137. package/dist/src/parser/declarations/classes.js.map +1 -1
  138. package/dist/src/parser/expressions.js +14 -1
  139. package/dist/src/parser/expressions.js.map +1 -1
  140. package/dist/src/parser/literals.js +6 -2
  141. package/dist/src/parser/literals.js.map +1 -1
  142. package/dist/tests/binder/binder.test.js +29 -0
  143. package/dist/tests/binder/binder.test.js.map +1 -1
  144. package/dist/tests/canonical.test.d.ts +1 -0
  145. package/dist/tests/canonical.test.js +19 -0
  146. package/dist/tests/canonical.test.js.map +1 -0
  147. package/dist/tests/checker/checker.test.d.ts +1 -0
  148. package/dist/tests/checker/checker.test.js +245 -0
  149. package/dist/tests/checker/checker.test.js.map +1 -0
  150. package/dist/tests/cli/check.test.js +20 -0
  151. package/dist/tests/cli/check.test.js.map +1 -1
  152. package/dist/tests/cli/hints.test.js +15 -0
  153. package/dist/tests/cli/hints.test.js.map +1 -1
  154. package/dist/tests/cli/process.test.js +12 -0
  155. package/dist/tests/cli/process.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 +21 -0
  170. package/dist/tests/e2e/compile-builtins.test.js.map +1 -1
  171. package/dist/tests/e2e/compile-objects-classes.test.js +54 -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-example-browser.test.js +2 -2
  182. package/dist/tests/e2e/gui-example-browser.test.js.map +1 -1
  183. package/dist/tests/e2e/gui-example-canvas.test.js +8 -5
  184. package/dist/tests/e2e/gui-example-canvas.test.js.map +1 -1
  185. package/dist/tests/e2e/gui-example-svg.test.js +4 -3
  186. package/dist/tests/e2e/gui-example-svg.test.js.map +1 -1
  187. package/dist/tests/e2e/gui-example.test.js +4 -3
  188. package/dist/tests/e2e/gui-example.test.js.map +1 -1
  189. package/dist/tests/e2e/gui-helpers.d.ts +3 -0
  190. package/dist/tests/e2e/gui-helpers.js +6 -3
  191. package/dist/tests/e2e/gui-helpers.js.map +1 -1
  192. package/dist/tests/e2e/gui-media-disabled.test.d.ts +9 -0
  193. package/dist/tests/e2e/gui-media-disabled.test.js +42 -0
  194. package/dist/tests/e2e/gui-media-disabled.test.js.map +1 -0
  195. package/dist/tests/e2e/gui-media.test.d.ts +6 -4
  196. package/dist/tests/e2e/gui-media.test.js +20 -16
  197. package/dist/tests/e2e/gui-media.test.js.map +1 -1
  198. package/dist/tests/e2e/harness.d.ts +9 -0
  199. package/dist/tests/e2e/harness.js +14 -2
  200. package/dist/tests/e2e/harness.js.map +1 -1
  201. package/dist/tests/e2e/native-extensions.test.js +2 -1
  202. package/dist/tests/e2e/native-extensions.test.js.map +1 -1
  203. package/dist/tests/e2e/property-descriptors.test.js +20 -0
  204. package/dist/tests/e2e/property-descriptors.test.js.map +1 -1
  205. package/dist/tests/e2e/unicode-output.test.d.ts +16 -0
  206. package/dist/tests/e2e/unicode-output.test.js +67 -0
  207. package/dist/tests/e2e/unicode-output.test.js.map +1 -0
  208. package/dist/tests/e2e/weak-collections.test.js +16 -2
  209. package/dist/tests/e2e/weak-collections.test.js.map +1 -1
  210. package/dist/tests/extensions/media.test.d.ts +1 -0
  211. package/dist/tests/extensions/media.test.js +58 -0
  212. package/dist/tests/extensions/media.test.js.map +1 -0
  213. package/dist/tests/extensions/registry.test.js +8 -0
  214. package/dist/tests/extensions/registry.test.js.map +1 -1
  215. package/dist/tests/helpers.d.ts +1 -0
  216. package/dist/tests/helpers.js +1 -0
  217. package/dist/tests/helpers.js.map +1 -1
  218. package/dist/tests/lexer/identifiers.test.js +12 -0
  219. package/dist/tests/lexer/identifiers.test.js.map +1 -1
  220. package/dist/tests/lexer/scanner.test.js +8 -0
  221. package/dist/tests/lexer/scanner.test.js.map +1 -1
  222. package/dist/tests/lexer/strings.test.js +30 -0
  223. package/dist/tests/lexer/strings.test.js.map +1 -1
  224. package/dist/tests/parser/declarations.test.js +20 -0
  225. package/dist/tests/parser/declarations.test.js.map +1 -1
  226. package/dist/tests/parser/expressions.test.js +36 -0
  227. package/dist/tests/parser/expressions.test.js.map +1 -1
  228. package/dist/tests/platform.d.ts +32 -0
  229. package/dist/tests/platform.js +40 -0
  230. package/dist/tests/platform.js.map +1 -0
  231. package/dist/tests/platform.test.d.ts +12 -0
  232. package/dist/tests/platform.test.js +51 -0
  233. package/dist/tests/platform.test.js.map +1 -0
  234. package/dist/tests/version.test.js +4 -4
  235. package/dist/tests/version.test.js.map +1 -1
  236. package/doc/ai/README.md +10 -4
  237. package/doc/ai/build-recipe.md +1 -0
  238. package/doc/ai/cli.md +18 -6
  239. package/doc/ai/contributing.md +59 -2
  240. package/doc/ai/extensions.md +46 -23
  241. package/doc/ai/language-support.md +25 -16
  242. package/doc/ai/troubleshooting.md +9 -0
  243. package/doc/ai/zh-CN/README.md +9 -4
  244. package/doc/ai/zh-CN/build-recipe.md +1 -0
  245. package/doc/ai/zh-CN/cli.md +14 -4
  246. package/doc/ai/zh-CN/contributing.md +49 -3
  247. package/doc/ai/zh-CN/extensions.md +29 -8
  248. package/doc/ai/zh-CN/language-support.md +23 -14
  249. package/doc/ai/zh-CN/troubleshooting.md +8 -0
  250. package/doc/gui/api.md +45 -0
  251. package/doc/gui/build.md +37 -21
  252. package/doc/gui/known-issues.md +17 -6
  253. package/doc/gui/media.md +26 -11
  254. package/doc/gui/runtime.md +18 -0
  255. package/doc/gui-scripts.md +7 -0
  256. package/doc/gui.md +43 -33
  257. package/doc/implemented/binder.md +2 -0
  258. package/doc/implemented/checker.md +117 -0
  259. package/doc/implemented/cli.md +13 -1
  260. package/doc/implemented/codegen.md +3 -2
  261. package/doc/implemented/driver.md +2 -2
  262. package/doc/implemented/operators.md +2 -1
  263. package/doc/implemented/parser.md +3 -2
  264. package/doc/implemented/pipeline.md +8 -1
  265. package/doc/implemented/stdlib.md +2 -1
  266. package/doc/implemented/tests.md +3 -1
  267. package/doc/implemented.md +2 -0
  268. package/doc/npm-package.md +417 -0
  269. package/doc/requirements.md +4 -1
  270. package/doc/support-matrix.md +83 -0
  271. package/doc/unimplemented/classes.md +3 -0
  272. package/doc/unimplemented/deviations.md +3 -2
  273. package/doc/unimplemented/toolchain.md +1 -1
  274. package/doc/unimplemented/types.md +24 -8
  275. package/doc/unimplemented.md +1 -1
  276. package/doc/zh-CN/gui/api.md +41 -0
  277. package/doc/zh-CN/gui/build.md +28 -16
  278. package/doc/zh-CN/gui/known-issues.md +13 -5
  279. package/doc/zh-CN/gui/media.md +21 -10
  280. package/doc/zh-CN/gui/runtime.md +16 -0
  281. package/doc/zh-CN/gui-scripts.md +5 -0
  282. package/doc/zh-CN/gui.md +37 -32
  283. package/doc/zh-CN/implemented/binder.md +2 -0
  284. package/doc/zh-CN/implemented/checker.md +99 -0
  285. package/doc/zh-CN/implemented/cli.md +12 -1
  286. package/doc/zh-CN/implemented/codegen.md +3 -2
  287. package/doc/zh-CN/implemented/driver.md +2 -2
  288. package/doc/zh-CN/implemented/operators.md +1 -1
  289. package/doc/zh-CN/implemented/parser.md +3 -2
  290. package/doc/zh-CN/implemented/pipeline.md +3 -1
  291. package/doc/zh-CN/implemented/stdlib.md +2 -1
  292. package/doc/zh-CN/implemented/tests.md +3 -1
  293. package/doc/zh-CN/implemented.md +2 -0
  294. package/doc/zh-CN/npm-package.md +391 -0
  295. package/doc/zh-CN/post/announce.md +47 -47
  296. package/doc/zh-CN/requirements.md +4 -1
  297. package/doc/zh-CN/support-matrix.md +82 -0
  298. package/doc/zh-CN/unimplemented/classes.md +3 -0
  299. package/doc/zh-CN/unimplemented/deviations.md +3 -2
  300. package/doc/zh-CN/unimplemented/toolchain.md +1 -1
  301. package/doc/zh-CN/unimplemented/types.md +16 -6
  302. package/doc/zh-CN/unimplemented.md +1 -1
  303. package/llms.txt +4 -1
  304. package/package.json +3 -1
  305. package/runtime/ext_gui/audio.cpp +316 -0
  306. package/runtime/ext_gui/browser.cpp +547 -0
  307. package/runtime/ext_gui/browser_escape.cpp +85 -0
  308. package/runtime/ext_gui/browser_loop.cpp +83 -0
  309. package/runtime/ext_gui/canvas.cpp +9 -3
  310. package/runtime/ext_gui/canvas_raster.cpp +19 -1
  311. package/runtime/ext_gui/dom_api.cpp +36 -0
  312. package/runtime/ext_gui/dom_api_document.cpp +96 -5
  313. package/runtime/ext_gui/dom_api_events.cpp +20 -0
  314. package/runtime/ext_gui/dom_api_internal.h +19 -0
  315. package/runtime/ext_gui/dom_api_proto.cpp +6 -0
  316. package/runtime/ext_gui/gui.cpp +90 -23
  317. package/runtime/ext_gui/gui_engine.h +44 -0
  318. package/runtime/ext_gui/gui_media.cpp +69 -2
  319. package/runtime/ext_gui/media.cpp +34 -488
  320. package/runtime/ext_gui/media.h +54 -19
  321. package/runtime/ext_gui/media_api.h +65 -0
  322. package/runtime/ext_gui/window.cpp +9 -0
  323. package/runtime/ext_media/media.cpp +507 -0
  324. package/runtime/ext_media/media_bridge.c +35 -0
  325. package/runtime/ext_node/path/path.c +7 -7
  326. package/runtime/ext_node/url/url.c +4 -2
  327. package/runtime/rt.h +15 -0
  328. package/runtime/xt_constructors.c +2 -1
  329. package/runtime/xt_containers/objects.inc +22 -2
  330. package/runtime/xt_io/exception.inc +4 -2
  331. package/runtime/xt_stdlib/math.inc +62 -0
  332. package/runtime/xt_stdlib2/date.inc +7 -1
  333. package/runtime/xt_stdlib2/objects.inc +14 -0
  334. package/scripts/build-gui.ts +6 -72
  335. package/scripts/build-media.ts +245 -0
  336. package/scripts/support-matrix.ts +167 -0
  337. package/src/ast/common.ts +2 -0
  338. package/src/ast/declarations.ts +12 -1
  339. package/src/ast/expressions.ts +6 -0
  340. package/src/ast/kinds.ts +2 -0
  341. package/src/binder/binder.ts +3 -0
  342. package/src/binder/declarations.ts +70 -0
  343. package/src/binder/references.ts +84 -3
  344. package/src/binder/types.ts +30 -0
  345. package/src/canonical.ts +37 -0
  346. package/src/checker/assignability.ts +134 -0
  347. package/src/checker/calls.ts +135 -0
  348. package/src/checker/checker.ts +47 -0
  349. package/src/checker/declarations.ts +26 -0
  350. package/src/checker/flow.ts +236 -0
  351. package/src/checker/globals.ts +40 -0
  352. package/src/checker/source.ts +53 -0
  353. package/src/checker/type-infer.ts +185 -0
  354. package/src/checker/type-model.ts +212 -0
  355. package/src/checker/type-system.ts +578 -0
  356. package/src/checker/typecheck-types.ts +112 -0
  357. package/src/checker/typecheck.ts +586 -0
  358. package/src/checker/undefined.ts +43 -0
  359. package/src/checker/walk.ts +16 -0
  360. package/src/cli/help.ts +65 -0
  361. package/src/cli/hints.ts +13 -1
  362. package/src/cli/main.ts +12 -49
  363. package/src/codegen/generator/calls/access.ts +8 -8
  364. package/src/codegen/generator/calls/invocation.ts +8 -5
  365. package/src/codegen/generator/calls/super.ts +67 -5
  366. package/src/codegen/generator/context.ts +31 -19
  367. package/src/codegen/generator/debug.ts +2 -1
  368. package/src/codegen/generator/expressions/primary.ts +84 -13
  369. package/src/codegen/generator/generator.ts +11 -1
  370. package/src/codegen/generator/module.ts +65 -24
  371. package/src/codegen/generator/state.ts +11 -1
  372. package/src/codegen/generator/statements/variables.ts +20 -3
  373. package/src/codegen/generator/tables.ts +5 -0
  374. package/src/driver/build-key.ts +3 -0
  375. package/src/driver/bundler/graph.ts +6 -2
  376. package/src/driver/bundler/merge.ts +14 -1
  377. package/src/driver/bundler/types.ts +13 -0
  378. package/src/driver/compiler.ts +5 -1
  379. package/src/driver/fingerprint.ts +2 -1
  380. package/src/driver/frontend.ts +13 -2
  381. package/src/driver/options.ts +6 -0
  382. package/src/driver/version.ts +1 -1
  383. package/src/extensions/catalog.ts +2 -1
  384. package/src/extensions/gui/html.ts +23 -10
  385. package/src/extensions/gui/index.ts +65 -0
  386. package/src/extensions/media/index.ts +67 -0
  387. package/src/extensions/registry.ts +72 -0
  388. package/src/index.ts +2 -0
  389. package/src/parser/declarations/classes.ts +7 -0
  390. package/src/parser/expressions.ts +13 -1
  391. package/src/parser/literals.ts +6 -2
@@ -0,0 +1,82 @@
1
+ # 支持矩阵
2
+
3
+ > 语言:[English](../support-matrix.md) | **简体中文**
4
+
5
+ > 本文件由 `npm run docs:matrix` 根据可执行语料
6
+ > [`tests/conformance/test262/manifest.ts`](../../tests/conformance/test262/manifest.ts) 生成,请勿手工编辑:
7
+ > 修改用例后重新生成。
8
+
9
+ 每个“支持”用例都是 [test262](https://github.com/tc39/test262) 的原始文件
10
+ (固定版本 `d53ebc8b1931d9f1541e43d59650776e4b766248`),由 xbintsc 编译**并执行**;
11
+ [test262 测试套件](../../tests/conformance/test262.test.ts) 会在用例回归时失败。该语料是代表性
12
+ 子集,不是完整的 test262 全量运行。每个“不支持”用例都是
13
+ xbintsc 目前会拒绝的合法 JavaScript,并以实际产生的诊断码固定下来。
14
+ harness 的适配说明见 [`SOURCE.md`](../../tests/conformance/test262/SOURCE.md)。该套件在 CI 的每个平台
15
+ 运行,因此本表不会声称编译器做不到的能力。
16
+
17
+ ## 各领域覆盖
18
+
19
+ | 领域 | 支持 | 不支持 | 参考 |
20
+ | --- | ---: | ---: | --- |
21
+ | 值与运算符 | 2 | 1 | [参考](../implemented/operators.md) |
22
+ | 字符串(UTF-16 语义) | 2 | 0 | [参考](../implemented/strings.md) |
23
+ | 数组 | 2 | 0 | [参考](../implemented/stdlib.md) |
24
+ | 对象 | 2 | 0 | [参考](../implemented/stdlib.md) |
25
+ | 类与继承 | 2 | 0 | [参考](../implemented/codegen.md) |
26
+ | 闭包与函数 | 2 | 1 | [参考](../implemented/binder.md) |
27
+ | 异常 | 2 | 0 | [参考](../implemented/runtime-core.md) |
28
+ | 异步与 Promise | 2 | 0 | [参考](../implemented/async.md) |
29
+ | JSON | 2 | 0 | [参考](../implemented/stdlib.md) |
30
+ | Map 与 Set | 2 | 0 | [参考](../implemented/collections.md) |
31
+ | 正则表达式 | 2 | 0 | [参考](../implemented/stdlib.md) |
32
+ | 类型化数组与二进制 | 2 | 0 | [参考](../implemented/typed-arrays.md) |
33
+ | Date | 2 | 0 | [参考](../implemented/stdlib.md) |
34
+ | 生成器 | 2 | 0 | [参考](../implemented/async.md) |
35
+ | 模块 | 2 | 1 | [参考](../implemented/modules.md) |
36
+ | 可选链与模板字符串 | 2 | 1 | [参考](../implemented/operators.md) |
37
+
38
+ ## 支持的用例(test262,编译并执行)
39
+
40
+ | test262 用例 | 领域 | 固化的行为 |
41
+ | --- | --- | --- |
42
+ | `built-ins/Number/isInteger/integers.js` | 值与运算符 | Number.isInteger 接受所有整数(含 ±2^53) |
43
+ | `built-ins/Number/isSafeInteger/infinity.js` | 值与运算符 | Number.isSafeInteger 拒绝 ±Infinity |
44
+ | `built-ins/String/prototype/padStart/fill-string-empty.js` | 字符串(UTF-16 语义) | 填充串为空时 padStart 原样返回 |
45
+ | `built-ins/String/prototype/includes/String.prototype.includes_Success.js` | 字符串(UTF-16 语义) | includes 在指定位置查找子串 |
46
+ | `built-ins/Array/prototype/map/15.4.4.19-1-1.js` | 数组 | map 以 undefined 为接收者时抛 TypeError |
47
+ | `built-ins/Array/prototype/at/index-non-numeric-argument-tointeger.js` | 数组 | at 把 false、null、undefined 和空串转换为索引 0 |
48
+ | `built-ins/Object/keys/15.2.3.14-0-1.js` | 对象 | Object.keys 是可调用函数 |
49
+ | `built-ins/Object/assign/Override.js` | 对象 | Object.assign 用后一个源对象覆盖同名键 |
50
+ | `language/statements/class/subclass/class-definition-evaluation-empty-constructor-heritage-present.js` | 类与继承 | 派生类未写构造函数时把参数转发给 super |
51
+ | `language/statements/class/definition/class-method-returns-promise.js` | 类与继承 | 类的 async 方法返回 Promise 实例 |
52
+ | `language/expressions/arrow-function/cannot-override-this-with-thisArg.js` | 闭包与函数 | 箭头函数的 this 不能被 thisArg 覆盖 |
53
+ | `language/expressions/function/S10.1.1_A1_T2.js` | 闭包与函数 | 具名、匿名和括号包裹的函数表达式都能求值 |
54
+ | `language/statements/try/12.14-10.js` | 异常 | catch 为名字查找引入独立作用域 |
55
+ | `built-ins/Error/length.js` | 异常 | Error 构造函数的 length 为 1 |
56
+ | `language/expressions/await/async-await-interleaved.js` | 异步与 Promise | await 与 promise 在微任务队列上的交错顺序 |
57
+ | `built-ins/Promise/all/S25.4.4.1_A1.1_T1.js` | 异步与 Promise | Promise.all 可调用 |
58
+ | `built-ins/JSON/stringify/property-order.js` | JSON | JSON.stringify 按属性顺序输出键 |
59
+ | `built-ins/JSON/parse/15.12.1.1-0-9.js` | JSON | JSON.parse 接受 token 前后的空白 |
60
+ | `built-ins/Map/prototype/set/append-new-values.js` | Map 与 Set | Map.set 按插入顺序追加条目 |
61
+ | `built-ins/Set/prototype/add/does-not-have-setdata-internal-slot-array.js` | Map 与 Set | Set.prototype.add 拒绝非 Set 接收者 |
62
+ | `built-ins/RegExp/prototype/test/S15.10.6.3_A1_T1.js` | 正则表达式 | test() 用 /1|12/ 匹配字符串 "123" |
63
+ | `built-ins/String/prototype/replace/15.5.4.11-1.js` | 正则表达式 | replace 给替换回调传入正确的 this |
64
+ | `built-ins/DataView/prototype/getUint8/index-is-out-of-range.js` | 类型化数组与二进制 | 越过视图末尾时 getUint8 抛 RangeError |
65
+ | `built-ins/DataView/prototype/setUint32/no-value-arg.js` | 类型化数组与二进制 | 省略 value 参数时 setUint32 写入 0 |
66
+ | `built-ins/Date/prototype/getUTCFullYear/this-value-valid-date.js` | Date | getUTCFullYear 读取有效日期 |
67
+ | `built-ins/Date/parse/year-zero.js` | Date | Date.parse 拒绝 -000000 扩展年份 |
68
+ | `language/statements/generators/declaration.js` | 生成器 | 支持生成器函数声明 |
69
+ | `language/expressions/generators/default-proto.js` | 生成器 | 生成器函数共享内置生成器原型 |
70
+ | `language/module-code/eval-export-cls-semi.js` | 模块 | 导出的 class 声明不需要末尾分号 |
71
+ | `language/module-code/eval-export-fun-semi.js` | 模块 | 导出的函数声明不需要末尾分号 |
72
+ | `language/expressions/optional-chaining/call-expression.js` | 可选链与模板字符串 | 可选链作用于调用表达式 |
73
+ | `language/expressions/template-literal/evaluation-order.js` | 可选链与模板字符串 | 模板插值从左到右求值 |
74
+
75
+ ## 不支持的用例(合法 JavaScript,预期诊断)
76
+
77
+ | test262 用例 | 领域 | 诊断码 | 原因 |
78
+ | --- | --- | ---: | --- |
79
+ | `language/statements/with/12.10-0-1.js` | 可选链与模板字符串 | TS2001 | `with` 语句尚未实现 |
80
+ | `language/expressions/new.target/value-via-call.js` | 闭包与函数 | TS4005 | `new.target` 尚未实现 |
81
+ | `language/expressions/comma/S11.14_A2.1_T3.js` | 值与运算符 | TS3002 | 未绑定的名字是编译期错误,而不是运行时 `ReferenceError` |
82
+ | `language/expressions/dynamic-import/always-create-new-promise.js` | 模块 | TS2001 | 动态 `import()` 尚未实现 |
@@ -9,6 +9,9 @@
9
9
  | 实例字段 / 属性声明 | ✓ |
10
10
  | 方法 | ✓ |
11
11
  | `static` 字段 / 方法 | ✓ |
12
+ | `static { ... }` 静态块 | ✓ 已实现(类定义时执行一次;静态字段与静态块按声明顺序执行,静态方法先安装;`this` 为类本身,`super.x` 读父构造函数) |
13
+ | `static get` / `static set` 访问器 | ✓(定义在构造函数值上;继承的静态 setter 会被调用) |
14
+ | `super[key]` / `super[key](...)` | ✓ |
12
15
  | 继承 `extends` / `super` | ✓(单级正确;`super` 取 `this` 原型的原型,理论缺陷见[运行时偏差](./deviations.md)) |
13
16
  | 原型链 / 方法查找 | ✓ |
14
17
  | `instanceof` | ✓ |
@@ -13,11 +13,12 @@
13
13
  | `for...in` | 枚举对象 / 数组 / 字符串的自身键;不含原型链属性 |
14
14
  | 数组越界 / 稀疏 | 越界访问返回 `undefined`;对 `arr.length` 赋值会截断 / 扩展,但不区分稀疏空洞 |
15
15
  | 内存管理 | 非移动标记-清扫回收器(在 `xt_alloc` 之后):显式根、子系统根提供者与保守 C 栈扫描。单线程、stop-the-world;无移动/压缩与分代 |
16
- | 函数 `arity` / 调用参数个数 | 无参数个数校验;`fn.length` 报告声明的 arity,但调用不做校验 |
16
+ | 函数 `arity` / 调用参数个数 | 对本地可见函数的直接调用由默认[语义检查](../implemented/checker.md)校验(`TS4004`);通过属性、导入、展开实参或重新赋值后的绑定发起的调用不校验。`fn.length` 报告声明的 arity |
17
17
  | `async` / `await` | 已在栈式协程上真实挂起;`await` 总会排入一次微任务(非 Promise 与已 settle 的 Promise 也一样),因此与 pending `.then` 回调的交错顺序符合规范。顶层 `await` 会阻塞事件循环等待,而不是让出模块主体。`fs/promises` 与 `fetch` 把阻塞工作 offload 到 4 线程池并在 reactor 上 settle。异步生成器可在 `await` 与 `yield` 处挂起,`for await...of` 每次迭代等待一步 |
18
18
  | 异步生成器清理 | `for await...of` 提前退出时不会调用迭代器的 `return()`。异步生成器中的 `yield*` 只委托同步可迭代对象。在挂起的 `yield` 处调用 `.return()` 会直接完成而不执行 `finally`(与同步生成器相同的限制) |
19
- | `super` | `super.x` / `super(...)` 取 `this` 原型的原型;单级继承正确,继承深度 > 1 时可能不准确 |
19
+ | `super` | `super.x` / `super[x]` 从当前执行类的父级持有者读取(实例方法中是父原型,`static` 方法或静态块中是父构造函数),因此任意继承深度都正确 |
20
20
  | `Error.stack` | 仅函数级帧:每帧为 `at 名称 (文件:行)`,行号取自函数声明(最内层帧会更新为错误构造处);没有列号,生成器 / `async` 函数体不产生帧(它们会切换栈) |
21
+ | `for` 头部中的 `let` | 每个循环只有一个绑定,而非每次迭代一个:循环体内创建的闭包都会看到最终值(`for (let i = 0; i < 3; i++) fns.push(() => i)` 得到 `3,3,3`) |
21
22
  | 模块实时绑定 | 命名空间导入与导入绑定为快照(见[模块系统](./modules.md)) |
22
23
  | `import.meta` | ✓ `import.meta.url` / `.dirname` / `.filename`,由可执行文件路径解析 |
23
24
 
@@ -6,7 +6,7 @@
6
6
  | --- | --- |
7
7
  | GC(垃圾回收) | ✓ `xt_alloc.c` 中的非移动标记-清扫,按存活堆阈值(`XT_GC_THRESHOLD` 可固定该阈值)或 `xt_gc_collect()` 触发;每次回收后阈值变为存活堆的 2 倍(下限 1 MiB),因此常驻内存跟随存活集而不是只增不减;`XT_GC_TRACE=1` 会为每次回收向 stderr 打印一行统计。显式根 + 根提供者 + 保守活动栈扫描。`WeakMap`/`WeakSet` 的键是 ephemeron(只有键可达时才保留值),`WeakRef` 目标不可达时会被清空;由于栈扫描是保守的,残留的栈字可能延迟清空。无压缩或后台回收 |
8
8
  | 自举(self-hosting) | ✓ 编译器已能自编译:`xbintsc build src/cli/main.ts` 可产出可用二进制,且从第 1 代起产出的 IR 保持稳定。运行时仍为 C |
9
- | 类型检查器 | ✗ 仅定义诊断码,无 checker |
9
+ | 类型检查器 | 部分:默认[语义检查](../implemented/checker.md)会报告未定义名、重复声明、实参个数、属性是否存在与确定的可赋值性错误,支持结构化接口/类、简单泛型与基础流收窄;没有完整推断与 strict-null |
10
10
  | 完整标准库 | 部分:Math / JSON / Date / Map / Set / RegExp / `Error` / `BigInt` / `Symbol` / `structuredClone` 已实现;String.normalize 缺失 |
11
11
  | 多文件模块打包 | 部分:相对路径 `.ts` 打包、ESM `node_modules` 包、命名空间导入、裸说明符扩展模块导入已实现;CommonJS 仅在 `node_modules` 内处理;循环依赖 / 实时绑定未实现 |
12
12
  | 异步运行时 | ✓ `async`/`await` 在 `select(2)` reactor 上对 pending promise 挂起:定时器、TCP 套接字、offload 的文件/HTTP 工作与 promise 回调都能恢复协程。仍缺:真正的 OS 级文件监听、非阻塞 `net.connect`、`fetch` 的 TLS,以及用户可见的 worker 线程(`worker_threads` 仍用子进程) |
@@ -2,10 +2,20 @@
2
2
 
3
3
  > 属于[未实现语法与功能](../unimplemented.md) · [English](../../unimplemented/types.md)
4
4
 
5
- 类型语法被解析为 AST 后在绑定 / 代码生成阶段**整体擦除**,不做任何类型检查:
5
+ 类型语法不再被盲目擦除:默认开启的[语义检查](../implemented/checker.md)
6
+ 会解析它能建模的那部分 TypeScript 类型,并检查可赋值性、属性是否存在与
7
+ 简单的控制流收窄。类型语法在代码生成阶段仍然被擦除,检查器是刻意不完整的:
6
8
 
7
- - 类型注解、返回类型、类型参数、类型别名、接口、泛型约束等:解析 ✓,检查 ✗。
8
- - 检查器诊断码(`TypeMismatch` `NotCallable` `PropertyNotFound` `ArgumentCountMismatch`)已定义但**未使用**。
9
- - `as` / `satisfies` / 非空断言 `!`:直接擦除,不做任何断言语义。
10
- - 泛型:无运行时实例化,类型参数被忽略。
11
- - 可选链 `?.` 的类型窄化:无(运行时短路已实现,但无类型层面的窄化)。
9
+ - **没有完整推断。** 未标注返回类型的函数返回 `any`;泛型约束、高阶推断与
10
+ 返回类型推断都不做。
11
+ - **没有 strict-null 模式。** `null` / `undefined` 在任何需要值的位置都可赋值。
12
+ - **没有新对象字面量的多余属性检查。**
13
+ - **没有重载解析、映射类型、条件类型与模板字面量类型。** 它们解析为 `any`。
14
+ - **`as` / `satisfies` / 非空 `!`** 仍被擦除,不做任何校验;检查器把它们当作断言。
15
+ - **复杂泛型。** 简单类型参数可从实参推断(`T`、`T[]`、`Array<T>`);
16
+ 映射/条件类型那套泛型机制不做。
17
+ - **类型实参个数不检查**;未知类型参数就是 `any`。
18
+
19
+ 检查器的六个诊断码现在都会使用:`DuplicateIdentifier`(TS3001)、
20
+ `CannotFindName`(TS3002)、`TypeMismatch`(TS4001)、`NotCallable`(TS4002)、
21
+ `PropertyNotFound`(TS4003)与 `ArgumentCountMismatch`(TS4004)。
@@ -20,7 +20,7 @@
20
20
  - [模块系统](./unimplemented/modules.md) —— 循环依赖、实时绑定、CommonJS 边界
21
21
  - [函数](./unimplemented/functions.md) —— 缺失的函数语义
22
22
  - [类与面向对象](./unimplemented/classes.md) —— 访问控制、`abstract`/`implements`、私有名冲突
23
- - [类型系统](./unimplemented/types.md) —— 仅解析、从不检查
23
+ - [类型系统](./unimplemented/types.md) —— 解析后擦除,只检查无需类型推断的事实
24
24
  - [运行时偏差](./unimplemented/deviations.md) —— 能编译能运行,但与 ECMAScript 不同
25
25
  - [工具链与平台](./unimplemented/toolchain.md) —— 类型检查器、异步 I/O、GC 模式、平台缺口
26
26
  - [Node 扩展](./unimplemented/node.md) —— Node 模块缺口,按领域分页
package/llms.txt CHANGED
@@ -20,8 +20,10 @@
20
20
  ## Using the compiler
21
21
 
22
22
  - [doc/ai/build-recipe.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/ai/build-recipe.md): exact commands to run, build, inspect IR and configure a project, with the program shape that compiles
23
+ - [doc/npm-package.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/npm-package.md): install the published npm package in another Node project and build artifacts — devDependency/npx setup, first-build runtime compilation, cache, CI, programmatic API and limitations
23
24
  - [doc/ai/cli.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/ai/cli.md): every CLI flag and its parsing quirks, project config fields, environment variables, incremental-cache behaviour, diagnostic codes, programmatic API
24
25
  - [doc/ai/language-support.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/ai/language-support.md): the supported TypeScript subset as tables — statements, expressions, classes, async, the erased type system, standard library gaps, modules, runtime deviations
26
+ - [doc/support-matrix.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/support-matrix.md): generated support matrix — every row is backed by a corpus case that is compiled and compared with Node, or must fail with a documented diagnostic
25
27
  - [doc/ai/extensions.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/ai/extensions.md): Node built-in modules and the `--ext node` rule, the GUI extension, bundling third-party packages, C++/Rust native extensions via manifest
26
28
  - [doc/ai/troubleshooting.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/ai/troubleshooting.md): the clang version requirement and every frequent error message with its cause and fix
27
29
  - [doc/requirements.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/requirements.md): per-platform toolchain prerequisites
@@ -36,6 +38,7 @@
36
38
  - [doc/implemented/lexer.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/lexer.md): tokens, literals and lexical diagnostics
37
39
  - [doc/implemented/parser.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/parser.md): statement, expression and type syntax
38
40
  - [doc/implemented/binder.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/binder.md): scopes, symbols and capture
41
+ - [doc/implemented/checker.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/checker.md): the opt-out checker — names, redeclarations, arity, structural assignability, property shapes, simple generics and flow narrowing, and what it deliberately does not check
39
42
  - [doc/implemented/operators.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/operators.md): operators and assignment
40
43
  - [doc/implemented/value-model.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/value-model.md): NaN-boxing and the function ABI
41
44
  - [doc/implemented/codegen.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/codegen.md): LLVM IR lowering
@@ -50,7 +53,7 @@
50
53
  - [doc/implemented/extensions.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/extensions.md): the extension registry and the `node` extension
51
54
  - [doc/implemented/driver.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/driver.md): incremental cache, clang, LTO/PGO, config, icons
52
55
  - [doc/implemented/cli.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/cli.md): CLI and the embedder API
53
- - [doc/implemented/tests.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/tests.md): test suites and the differential harness
56
+ - [doc/implemented/tests.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/implemented/tests.md): unit, e2e, differential harness and the executable test262 corpus
54
57
  - [doc/unimplemented.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/unimplemented.md): index of unsupported syntax, missing semantics and known deviations
55
58
  - [doc/unimplemented/statements.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/unimplemented/statements.md): statement gaps
56
59
  - [doc/unimplemented/expressions.md](https://raw.githubusercontent.com/zy445566/xbintsc/main/doc/unimplemented/expressions.md): expression and operator gaps
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xbintsc",
3
- "version": "0.5.22",
3
+ "version": "0.5.31",
4
4
  "description": "xbintsc - a TypeScript binary compiler (TypeScript -> LLVM IR -> native binary)",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -37,11 +37,13 @@
37
37
  "prepublishOnly": "npm run build",
38
38
  "runtime": "tsx scripts/build-runtime.ts",
39
39
  "gui": "tsx scripts/build-gui.ts",
40
+ "media": "tsx scripts/build-media.ts",
40
41
  "package-release": "tsx scripts/package-release.ts",
41
42
  "runtime:clean": "node -e \"require('fs').rmSync('build/runtime-obj',{recursive:true,force:true});require('fs').rmSync('runtime/lib',{recursive:true,force:true})\"",
42
43
  "xbintsc": "tsx src/cli/main.ts",
43
44
  "typecheck": "tsc -p tsconfig.json --noEmit",
44
45
  "check:version": "tsx scripts/check-version.ts",
46
+ "docs:matrix": "tsx scripts/support-matrix.ts",
45
47
  "bench": "tsx scripts/bench.ts",
46
48
  "lint": "eslint . && tsx scripts/check-file-length.ts",
47
49
  "test": "vitest run",
@@ -0,0 +1,316 @@
1
+ /*
2
+ * xbintsc GUI engine — the Web Audio surface a page expects.
3
+ *
4
+ * There is no audio backend yet: the graph is created, values are stored and
5
+ * read back, but nothing is rendered to the sound device. That is enough for
6
+ * the common pattern of building the graph once (`createGain`, `connect`,
7
+ * `AudioParam.setValueAtTime`, `createBuffer` + `getChannelData`) and then
8
+ * driving it with `start`/`stop` — the program keeps running instead of
9
+ * failing at `new AudioContext()`, and a real mixer can be dropped in behind
10
+ * this interface later without touching the page.
11
+ *
12
+ * `createBuffer` hands out real `Float32Array` channels, so a page that fills
13
+ * a buffer procedurally (noise beds, hand-built waveforms) works unchanged.
14
+ */
15
+
16
+ #include "gui_engine.h"
17
+ #include "dom_api_internal.h"
18
+
19
+ #include <string>
20
+
21
+ namespace {
22
+
23
+ xt_value fn_of(void *fn) { return xt_closure_new(fn, 0, NULL); }
24
+
25
+ void set_prop(xt_value target, const char *name, xt_value value) {
26
+ xt_object_set(target, xt_string_from_cstr(name), value);
27
+ }
28
+
29
+ void set_method(xt_value target, const char *name, void *fn) { set_prop(target, name, fn_of(fn)); }
30
+
31
+ void set_number(xt_value target, const char *name, double value) {
32
+ set_prop(target, name, xt_number(value));
33
+ }
34
+
35
+ xt_value noop(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
36
+ (void)self;
37
+ (void)env;
38
+ (void)argc;
39
+ (void)argv;
40
+ return XT_UNDEFINED;
41
+ }
42
+
43
+ /** `connect(node)` returns the destination, so `a.connect(b).connect(c)` chains
44
+ * the same way it does in a browser. */
45
+ xt_value node_connect(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
46
+ (void)self;
47
+ (void)env;
48
+ xt_value target = xt_arg(argc, argv, 0);
49
+ if (XT_IS_OBJECT(target)) {
50
+ xt_value inputs = xt_object_get_cstr(target, "__xt_audio_inputs");
51
+ if (!XT_IS_OBJECT(inputs)) {
52
+ inputs = xt_object_new();
53
+ xt_object_set(target, xt_string_from_cstr("__xt_audio_inputs"), inputs);
54
+ }
55
+ }
56
+ return target;
57
+ }
58
+
59
+ xt_value node_start(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
60
+ (void)env;
61
+ (void)argc;
62
+ (void)argv;
63
+ set_prop(self, "started", XT_TRUE);
64
+ return XT_UNDEFINED;
65
+ }
66
+
67
+ xt_value node_stop(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
68
+ (void)env;
69
+ (void)argc;
70
+ (void)argv;
71
+ set_prop(self, "started", XT_FALSE);
72
+ return XT_UNDEFINED;
73
+ }
74
+
75
+ /* -- AudioParam ----------------------------------------------------------- */
76
+
77
+ xt_value param_value_get(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
78
+ (void)env;
79
+ (void)argc;
80
+ (void)argv;
81
+ xt_value value = xt_object_get_cstr(self, "__xt_audio_value");
82
+ return XT_IS_NUMBER(value) ? value : xt_number(0);
83
+ }
84
+
85
+ xt_value param_value_set(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
86
+ (void)env;
87
+ (void)self;
88
+ xt_value value = xt_arg(argc, argv, 0);
89
+ if (XT_IS_NUMBER(value)) set_prop(self, "__xt_audio_value", value);
90
+ return value;
91
+ }
92
+
93
+ xt_value param_set_value_at_time(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
94
+ (void)env;
95
+ (void)argc;
96
+ return param_value_set(self, env, 1, argv);
97
+ }
98
+
99
+ /** A ramp/curve call only records its target: nothing schedules yet. */
100
+ xt_value param_ramp(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
101
+ (void)env;
102
+ if (argc < 1) return self;
103
+ xt_value value = xt_arg(argc, argv, 0);
104
+ if (XT_IS_NUMBER(value)) set_prop(self, "__xt_audio_value", value);
105
+ return self;
106
+ }
107
+
108
+ xt_value audio_param_build(double initial) {
109
+ xt_value param = xt_object_new();
110
+ set_number(param, "__xt_audio_value", initial);
111
+ xt_object_define_getter(param, xt_string_from_cstr("value"), fn_of((void *)param_value_get));
112
+ xt_object_define_setter(param, xt_string_from_cstr("value"), fn_of((void *)param_value_set));
113
+ set_method(param, "setValueAtTime", (void *)param_set_value_at_time);
114
+ set_method(param, "linearRampToValueAtTime", (void *)param_ramp);
115
+ set_method(param, "exponentialRampToValueAtTime", (void *)param_ramp);
116
+ set_method(param, "setTargetAtTime", (void *)param_ramp);
117
+ set_method(param, "cancelScheduledValues", (void *)noop);
118
+ set_method(param, "cancelAndHoldAtTime", (void *)noop);
119
+ return param;
120
+ }
121
+
122
+ /** A node with the standard `AudioNode` shape. `params` names the AudioParams
123
+ * the node owns (`gain`, `frequency`, `Q`, …). */
124
+ xt_value audio_node_build(const char *type, const char *const *params, int param_count) {
125
+ xt_value node = xt_object_new();
126
+ if (type != NULL) set_prop(node, "type", xt_string_from_cstr(type));
127
+ for (int index = 0; index < param_count; index++) {
128
+ set_prop(node, params[index], audio_param_build(0.0));
129
+ }
130
+ set_method(node, "connect", (void *)node_connect);
131
+ set_method(node, "disconnect", (void *)noop);
132
+ set_method(node, "start", (void *)node_start);
133
+ set_method(node, "stop", (void *)node_stop);
134
+ set_number(node, "channelCount", 2);
135
+ return node;
136
+ }
137
+
138
+ /* -- AudioContext --------------------------------------------------------- */
139
+
140
+ xt_value buffer_get_channel_data(xt_value self, xt_value env, int32_t argc, xt_value *argv);
141
+
142
+ xt_value ctx_create_gain(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
143
+ (void)self;
144
+ (void)env;
145
+ (void)argc;
146
+ (void)argv;
147
+ static const char *const params[] = {"gain"};
148
+ return audio_node_build("gain", params, 1);
149
+ }
150
+
151
+ xt_value ctx_create_oscillator(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
152
+ (void)self;
153
+ (void)env;
154
+ (void)argc;
155
+ (void)argv;
156
+ static const char *const params[] = {"frequency", "detune"};
157
+ xt_value node = audio_node_build(NULL, params, 2);
158
+ set_prop(node, "type", xt_string_from_cstr("sine"));
159
+ return node;
160
+ }
161
+
162
+ xt_value ctx_create_buffer_source(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
163
+ (void)self;
164
+ (void)env;
165
+ (void)argc;
166
+ (void)argv;
167
+ static const char *const params[] = {"playbackRate", "detune"};
168
+ xt_value node = audio_node_build(NULL, params, 2);
169
+ set_prop(node, "buffer", XT_NULL);
170
+ set_prop(node, "loop", XT_FALSE);
171
+ set_number(node, "loopStart", 0);
172
+ set_number(node, "loopEnd", 0);
173
+ return node;
174
+ }
175
+
176
+ xt_value ctx_create_biquad(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
177
+ (void)self;
178
+ (void)env;
179
+ (void)argc;
180
+ (void)argv;
181
+ static const char *const params[] = {"frequency", "detune", "Q", "gain"};
182
+ xt_value node = audio_node_build(NULL, params, 4);
183
+ set_prop(node, "type", xt_string_from_cstr("lowpass"));
184
+ return node;
185
+ }
186
+
187
+ xt_value ctx_create_compressor(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
188
+ (void)self;
189
+ (void)env;
190
+ (void)argc;
191
+ (void)argv;
192
+ static const char *const params[] = {"threshold", "knee", "ratio",
193
+ "attack", "release"};
194
+ return audio_node_build(NULL, params, 5);
195
+ }
196
+
197
+ /** `createBuffer(channels, length, sampleRate)`: real `Float32Array` channels. */
198
+ xt_value ctx_create_buffer(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
199
+ (void)self;
200
+ (void)env;
201
+ int channels = (int)xt_to_number(xt_arg(argc, argv, 0));
202
+ int length = (int)xt_to_number(xt_arg(argc, argv, 1));
203
+ double rate = xt_to_number(xt_arg(argc, argv, 2));
204
+ if (channels < 1) channels = 1;
205
+ if (length < 0) length = 0;
206
+ xt_value array = xt_array_new(0, NULL);
207
+ for (int index = 0; index < channels; index++) {
208
+ xt_value size = xt_number((double)length);
209
+ xt_value channel = xt_typed_array_ctor_by_name(xt_string_from_cstr("Float32Array"), 1, &size);
210
+ xt_array_push(array, channel);
211
+ }
212
+ xt_value buffer = xt_object_new();
213
+ set_prop(buffer, "__xt_audio_channels", array);
214
+ set_method(buffer, "getChannelData", (void *)buffer_get_channel_data);
215
+ set_number(buffer, "numberOfChannels", channels);
216
+ set_number(buffer, "length", length);
217
+ set_number(buffer, "sampleRate", rate);
218
+ if (rate > 0) set_number(buffer, "duration", (double)length / rate);
219
+ return buffer;
220
+ }
221
+
222
+ /** An empty `Float32Array` — the answer for a channel index a buffer does not
223
+ * have, and for a buffer nothing filled. */
224
+ xt_value empty_channel(void) {
225
+ xt_value zero = xt_number(0);
226
+ return xt_typed_array_ctor_by_name(xt_string_from_cstr("Float32Array"), 1, &zero);
227
+ }
228
+
229
+ xt_value buffer_get_channel_data(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
230
+ (void)env;
231
+ /* Channels live in an *array* value (`XT_TAG_ARRAY`), which
232
+ * `XT_IS_OBJECT` does not match. */
233
+ xt_value channels = xt_object_get_cstr(self, "__xt_audio_channels");
234
+ int index = (int)xt_to_number(xt_arg(argc, argv, 0));
235
+ if (!XT_IS_ARRAY(channels) && !XT_IS_OBJECT(channels)) return empty_channel();
236
+ if (index < 0 || index >= xt_array_size(channels)) return empty_channel();
237
+ return xt_array_get(channels, xt_number((double)index));
238
+ }
239
+
240
+ xt_value ctx_decode_audio_data(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
241
+ (void)self;
242
+ (void)env;
243
+ /* No decoder: resolve with an empty buffer so a `await decodeAudioData(…)`
244
+ * finishes instead of hanging the page. */
245
+ xt_value size = xt_number(0);
246
+ xt_value buffer = ctx_create_buffer(XT_UNDEFINED, XT_UNDEFINED, 3,
247
+ (xt_value[]){xt_number(1), size, xt_number(44100)});
248
+ (void)argc;
249
+ (void)argv;
250
+ return xt_promise_resolve(buffer);
251
+ }
252
+
253
+ xt_value ctx_resume(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
254
+ (void)env;
255
+ (void)argc;
256
+ (void)argv;
257
+ set_prop(self, "state", xt_string_from_cstr("running"));
258
+ return xt_promise_resolve(XT_UNDEFINED);
259
+ }
260
+
261
+ xt_value ctx_suspend(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
262
+ (void)env;
263
+ (void)argc;
264
+ (void)argv;
265
+ set_prop(self, "state", xt_string_from_cstr("suspended"));
266
+ return xt_promise_resolve(XT_UNDEFINED);
267
+ }
268
+
269
+ xt_value ctx_close(xt_value self, xt_value env, int32_t argc, xt_value *argv) {
270
+ (void)env;
271
+ (void)argc;
272
+ (void)argv;
273
+ set_prop(self, "state", xt_string_from_cstr("closed"));
274
+ return xt_promise_resolve(XT_UNDEFINED);
275
+ }
276
+
277
+ /** The context prototype: also the `instanceof AudioContext` target, and the
278
+ * prototype of the object `new AudioContext()` builds. */
279
+ xt_value audio_proto(void) {
280
+ static xt_value proto = XT_UNDEFINED;
281
+ if (XT_IS_OBJECT(proto)) return proto;
282
+ xt_value built = xt_object_new();
283
+ set_method(built, "createGain", (void *)ctx_create_gain);
284
+ set_method(built, "createOscillator", (void *)ctx_create_oscillator);
285
+ set_method(built, "createBufferSource", (void *)ctx_create_buffer_source);
286
+ set_method(built, "createBiquadFilter", (void *)ctx_create_biquad);
287
+ set_method(built, "createDynamicsCompressor", (void *)ctx_create_compressor);
288
+ set_method(built, "createBuffer", (void *)ctx_create_buffer);
289
+ set_method(built, "decodeAudioData", (void *)ctx_decode_audio_data);
290
+ set_method(built, "resume", (void *)ctx_resume);
291
+ set_method(built, "suspend", (void *)ctx_suspend);
292
+ set_method(built, "close", (void *)ctx_close);
293
+ proto = built;
294
+ xt_gc_add_root(&proto);
295
+ return proto;
296
+ }
297
+
298
+ } // namespace
299
+
300
+ xt_value xt_gui_audio_proto(void) { return audio_proto(); }
301
+
302
+ xt_value xt_gui_audio_create(int32_t argc, xt_value *argv) {
303
+ (void)argc;
304
+ (void)argv;
305
+ xt_value context = xt_object_new_with_proto(audio_proto());
306
+ xt_value destination = audio_node_build(NULL, NULL, 0);
307
+ set_prop(context, "state", xt_string_from_cstr("running"));
308
+ set_prop(context, "destination", destination);
309
+ set_number(context, "sampleRate", 48000);
310
+ set_number(context, "currentTime", 0);
311
+ set_number(context, "baseLatency", 0.01);
312
+ set_number(context, "outputLatency", 0.01);
313
+ xt_value listener = xt_object_new();
314
+ set_prop(context, "listener", listener);
315
+ return context;
316
+ }