sfml.js 0.0.1 → 1.0.0-rc.2

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 (741) hide show
  1. package/LICENSE +1 -1
  2. package/README.ja.md +173 -0
  3. package/README.ko.md +173 -0
  4. package/README.md +129 -20
  5. package/README.zh-CN.md +173 -0
  6. package/assets/branding/sfml-js-symbol-pentagon.svg +24 -0
  7. package/assets/branding/sfml-js-wordmark-dark.svg +20 -0
  8. package/assets/branding/sfml-js-wordmark.svg +19 -0
  9. package/assets/breakout.png +0 -0
  10. package/binding.gyp +95 -183
  11. package/dist/audio/effect-processor.d.ts +67 -0
  12. package/dist/audio/effect-processor.js +58 -0
  13. package/dist/audio/input-sound-file.d.ts +138 -0
  14. package/dist/audio/input-sound-file.js +253 -0
  15. package/dist/audio/listener.d.ts +90 -0
  16. package/dist/audio/listener.js +148 -0
  17. package/dist/audio/music.d.ts +210 -0
  18. package/dist/audio/music.js +353 -0
  19. package/dist/audio/output-sound-file.d.ts +47 -0
  20. package/dist/audio/output-sound-file.js +102 -0
  21. package/dist/audio/playback-device.d.ts +121 -0
  22. package/dist/audio/playback-device.js +152 -0
  23. package/dist/audio/sound-buffer-recorder.d.ts +114 -0
  24. package/dist/audio/sound-buffer-recorder.js +142 -0
  25. package/dist/audio/sound-buffer.d.ts +150 -0
  26. package/dist/audio/sound-buffer.js +237 -0
  27. package/dist/audio/sound-file-factory.d.ts +100 -0
  28. package/dist/audio/sound-file-factory.js +225 -0
  29. package/dist/audio/sound-file-reader.d.ts +191 -0
  30. package/dist/audio/sound-file-reader.js +132 -0
  31. package/dist/audio/sound-file-writer.d.ts +59 -0
  32. package/dist/audio/sound-file-writer.js +20 -0
  33. package/dist/audio/sound-recorder.d.ts +184 -0
  34. package/dist/audio/sound-recorder.js +286 -0
  35. package/dist/audio/sound-source.d.ts +336 -0
  36. package/dist/audio/sound-source.js +389 -0
  37. package/dist/audio/sound-stream.d.ts +76 -0
  38. package/dist/audio/sound-stream.js +83 -0
  39. package/dist/audio/sound.d.ts +41 -0
  40. package/dist/audio/sound.js +66 -0
  41. package/dist/audio/value.d.ts +359 -0
  42. package/dist/audio/value.js +353 -0
  43. package/dist/audio/worker.d.ts +306 -0
  44. package/dist/audio/worker.js +2 -0
  45. package/dist/graphics/blend-mode.d.ts +248 -0
  46. package/dist/graphics/blend-mode.js +234 -0
  47. package/dist/graphics/boolean-vector.d.ts +134 -0
  48. package/dist/graphics/boolean-vector.js +202 -0
  49. package/dist/graphics/circle-shape.d.ts +84 -0
  50. package/dist/graphics/circle-shape.js +72 -0
  51. package/dist/graphics/color.d.ts +278 -0
  52. package/dist/graphics/color.js +291 -0
  53. package/dist/graphics/convex-shape.d.ts +56 -0
  54. package/dist/graphics/convex-shape.js +59 -0
  55. package/dist/graphics/drawable.d.ts +22 -0
  56. package/dist/graphics/drawable.js +20 -0
  57. package/dist/graphics/font.d.ts +199 -0
  58. package/dist/graphics/font.js +319 -0
  59. package/dist/graphics/glsl-matrix.d.ts +62 -0
  60. package/dist/graphics/glsl-matrix.js +106 -0
  61. package/dist/graphics/glsl.d.ts +165 -0
  62. package/dist/graphics/glsl.js +215 -0
  63. package/dist/graphics/glyph.d.ts +133 -0
  64. package/dist/graphics/glyph.js +138 -0
  65. package/dist/graphics/image.d.ts +192 -0
  66. package/dist/graphics/image.js +285 -0
  67. package/dist/graphics/primitive-type.d.ts +51 -0
  68. package/dist/graphics/primitive-type.js +60 -0
  69. package/dist/graphics/rect.d.ts +203 -0
  70. package/dist/graphics/rect.js +249 -0
  71. package/dist/graphics/rectangle-shape.d.ts +55 -0
  72. package/dist/graphics/rectangle-shape.js +60 -0
  73. package/dist/graphics/render-states.d.ts +188 -0
  74. package/dist/graphics/render-states.js +115 -0
  75. package/dist/graphics/render-target.d.ts +222 -0
  76. package/dist/graphics/render-target.js +434 -0
  77. package/dist/graphics/render-texture.d.ts +130 -0
  78. package/dist/graphics/render-texture.js +187 -0
  79. package/dist/graphics/render-window.d.ts +138 -0
  80. package/dist/graphics/render-window.js +154 -0
  81. package/dist/graphics/shader.d.ts +192 -0
  82. package/dist/graphics/shader.js +321 -0
  83. package/dist/graphics/shape.d.ts +189 -0
  84. package/dist/graphics/shape.js +277 -0
  85. package/dist/graphics/sprite.d.ts +104 -0
  86. package/dist/graphics/sprite.js +164 -0
  87. package/dist/graphics/stencil-mode.d.ts +230 -0
  88. package/dist/graphics/stencil-mode.js +173 -0
  89. package/dist/graphics/swap.d.ts +17 -0
  90. package/dist/graphics/swap.js +16 -0
  91. package/dist/graphics/text.d.ts +759 -0
  92. package/dist/graphics/text.js +724 -0
  93. package/dist/graphics/texture.d.ts +255 -0
  94. package/dist/graphics/texture.js +390 -0
  95. package/dist/graphics/transform.d.ts +129 -0
  96. package/dist/graphics/transform.js +274 -0
  97. package/dist/graphics/transformable.d.ts +24 -0
  98. package/dist/graphics/transformable.js +38 -0
  99. package/dist/graphics/vertex-array.d.ts +123 -0
  100. package/dist/graphics/vertex-array.js +234 -0
  101. package/dist/graphics/vertex-buffer.d.ts +205 -0
  102. package/dist/graphics/vertex-buffer.js +256 -0
  103. package/dist/graphics/vertex.d.ts +111 -0
  104. package/dist/graphics/vertex.js +134 -0
  105. package/dist/graphics/view.d.ts +172 -0
  106. package/dist/graphics/view.js +296 -0
  107. package/dist/index.d.ts +116 -0
  108. package/dist/index.js +251 -0
  109. package/dist/internal/audio-codec-registry.d.ts +13 -0
  110. package/dist/internal/audio-codec-registry.js +64 -0
  111. package/dist/internal/audio-input-stream.d.ts +13 -0
  112. package/dist/internal/audio-input-stream.js +44 -0
  113. package/dist/internal/audio-music-pump.d.ts +63 -0
  114. package/dist/internal/audio-music-pump.js +193 -0
  115. package/dist/internal/audio-native.d.ts +145 -0
  116. package/dist/internal/audio-native.js +24 -0
  117. package/dist/internal/audio-recorder-session.d.ts +77 -0
  118. package/dist/internal/audio-recorder-session.js +182 -0
  119. package/dist/internal/audio-worker-session.d.ts +18 -0
  120. package/dist/internal/audio-worker-session.js +82 -0
  121. package/dist/internal/audio-worker.d.ts +1 -0
  122. package/dist/internal/audio-worker.js +134 -0
  123. package/dist/internal/glsl-value.d.ts +51 -0
  124. package/dist/internal/glsl-value.js +69 -0
  125. package/dist/internal/graphics-state.d.ts +45 -0
  126. package/dist/internal/graphics-state.js +123 -0
  127. package/dist/internal/input-stream.d.ts +4 -0
  128. package/dist/internal/input-stream.js +25 -0
  129. package/dist/internal/lazy-value.d.ts +17 -0
  130. package/dist/internal/lazy-value.js +43 -0
  131. package/dist/internal/native.d.ts +317 -0
  132. package/dist/internal/native.js +8 -0
  133. package/dist/internal/numeric-properties.d.ts +2 -0
  134. package/dist/internal/numeric-properties.js +39 -0
  135. package/dist/internal/render-states.d.ts +4 -0
  136. package/dist/internal/render-states.js +44 -0
  137. package/dist/internal/scalar.d.ts +52 -0
  138. package/dist/internal/scalar.js +95 -0
  139. package/dist/internal/shaped-glyph.d.ts +32 -0
  140. package/dist/internal/shaped-glyph.js +51 -0
  141. package/dist/internal/struct-view.d.ts +11 -0
  142. package/dist/internal/struct-view.js +39 -0
  143. package/dist/internal/text-indices.d.ts +7 -0
  144. package/dist/internal/text-indices.js +22 -0
  145. package/dist/internal/transformable.d.ts +124 -0
  146. package/dist/internal/transformable.js +121 -0
  147. package/dist/internal/value-storage.d.ts +33 -0
  148. package/dist/internal/value-storage.js +21 -0
  149. package/dist/network/common.d.ts +23 -0
  150. package/dist/network/common.js +78 -0
  151. package/dist/network/dns.d.ts +124 -0
  152. package/dist/network/dns.js +142 -0
  153. package/dist/network/ftp.d.ts +265 -0
  154. package/dist/network/ftp.js +417 -0
  155. package/dist/network/gen/constants.d.ts +878 -0
  156. package/dist/network/gen/constants.js +886 -0
  157. package/dist/network/http.d.ts +458 -0
  158. package/dist/network/http.js +732 -0
  159. package/dist/network/ip-address.d.ts +210 -0
  160. package/dist/network/ip-address.js +301 -0
  161. package/dist/network/packet.d.ts +249 -0
  162. package/dist/network/packet.js +326 -0
  163. package/dist/network/sftp.d.ts +661 -0
  164. package/dist/network/sftp.js +826 -0
  165. package/dist/network/socket-selector.d.ts +132 -0
  166. package/dist/network/socket-selector.js +214 -0
  167. package/dist/network/socket.d.ts +301 -0
  168. package/dist/network/socket.js +402 -0
  169. package/dist/network/tcp-listener.d.ts +114 -0
  170. package/dist/network/tcp-listener.js +199 -0
  171. package/dist/network/tcp-socket.d.ts +307 -0
  172. package/dist/network/tcp-socket.js +493 -0
  173. package/dist/network/tls-material.d.ts +22 -0
  174. package/dist/network/tls-material.js +52 -0
  175. package/dist/network/udp-socket.d.ts +178 -0
  176. package/dist/network/udp-socket.js +285 -0
  177. package/dist/system/angle.d.ts +77 -0
  178. package/dist/system/angle.js +122 -0
  179. package/dist/system/clock.d.ts +65 -0
  180. package/dist/system/clock.js +99 -0
  181. package/dist/system/err.d.ts +18 -0
  182. package/dist/system/err.js +61 -0
  183. package/dist/system/error.d.ts +15 -0
  184. package/dist/system/error.js +22 -0
  185. package/dist/system/file-input-stream.d.ts +68 -0
  186. package/dist/system/file-input-stream.js +148 -0
  187. package/dist/system/input-stream.d.ts +114 -0
  188. package/dist/system/input-stream.js +106 -0
  189. package/dist/system/operators.d.ts +291 -0
  190. package/dist/system/operators.js +505 -0
  191. package/dist/system/sleep.d.ts +9 -0
  192. package/dist/system/sleep.js +28 -0
  193. package/dist/system/suspend-aware-clock.d.ts +22 -0
  194. package/dist/system/suspend-aware-clock.js +29 -0
  195. package/dist/system/time.d.ts +100 -0
  196. package/dist/system/time.js +188 -0
  197. package/dist/system/timeout-with-predicate.d.ts +60 -0
  198. package/dist/system/timeout-with-predicate.js +52 -0
  199. package/dist/system/unicode.d.ts +54 -0
  200. package/dist/system/unicode.js +67 -0
  201. package/dist/system/vector2.d.ts +302 -0
  202. package/dist/system/vector2.js +314 -0
  203. package/dist/system/vector3.d.ts +249 -0
  204. package/dist/system/vector3.js +266 -0
  205. package/dist/system/version.d.ts +51 -0
  206. package/dist/system/version.js +24 -0
  207. package/dist/window/clipboard.d.ts +14 -0
  208. package/dist/window/clipboard.js +26 -0
  209. package/dist/window/context-settings.d.ts +94 -0
  210. package/dist/window/context-settings.js +84 -0
  211. package/dist/window/context.d.ts +87 -0
  212. package/dist/window/context.js +122 -0
  213. package/dist/window/cursor.d.ts +58 -0
  214. package/dist/window/cursor.js +80 -0
  215. package/dist/window/event.d.ts +529 -0
  216. package/dist/window/event.js +87 -0
  217. package/dist/window/gen/constants.d.ts +2213 -0
  218. package/dist/window/gen/constants.js +2227 -0
  219. package/dist/window/joystick.d.ts +81 -0
  220. package/dist/window/joystick.js +80 -0
  221. package/dist/window/keyboard.d.ts +50 -0
  222. package/dist/window/keyboard.js +59 -0
  223. package/dist/window/mouse.d.ts +31 -0
  224. package/dist/window/mouse.js +57 -0
  225. package/dist/window/sensor.d.ts +26 -0
  226. package/dist/window/sensor.js +40 -0
  227. package/dist/window/touch.d.ts +27 -0
  228. package/dist/window/touch.js +44 -0
  229. package/dist/window/video-mode.d.ts +77 -0
  230. package/dist/window/video-mode.js +99 -0
  231. package/dist/window/vulkan.d.ts +32 -0
  232. package/dist/window/vulkan.js +45 -0
  233. package/dist/window/window.d.ts +355 -0
  234. package/dist/window/window.js +434 -0
  235. package/docs/README.ja.md +30 -0
  236. package/docs/README.ko.md +30 -0
  237. package/docs/README.md +30 -0
  238. package/docs/README.zh-CN.md +30 -0
  239. package/docs/api.ja.md +84 -0
  240. package/docs/api.ko.md +84 -0
  241. package/docs/api.md +81 -0
  242. package/docs/api.zh-CN.md +81 -0
  243. package/docs/audio.ja.md +249 -0
  244. package/docs/audio.ko.md +251 -0
  245. package/docs/audio.md +252 -0
  246. package/docs/audio.zh-CN.md +252 -0
  247. package/docs/concepts.ja.md +130 -0
  248. package/docs/concepts.ko.md +130 -0
  249. package/docs/concepts.md +131 -0
  250. package/docs/concepts.zh-CN.md +131 -0
  251. package/docs/development.ja.md +148 -0
  252. package/docs/development.ko.md +148 -0
  253. package/docs/development.md +150 -0
  254. package/docs/development.zh-CN.md +150 -0
  255. package/docs/getting-started.ja.md +154 -0
  256. package/docs/getting-started.ko.md +154 -0
  257. package/docs/getting-started.md +156 -0
  258. package/docs/getting-started.zh-CN.md +156 -0
  259. package/docs/graphics.ja.md +256 -0
  260. package/docs/graphics.ko.md +254 -0
  261. package/docs/graphics.md +255 -0
  262. package/docs/graphics.zh-CN.md +257 -0
  263. package/docs/network.ja.md +214 -0
  264. package/docs/network.ko.md +216 -0
  265. package/docs/network.md +218 -0
  266. package/docs/network.zh-CN.md +218 -0
  267. package/docs/system.ja.md +169 -0
  268. package/docs/system.ko.md +171 -0
  269. package/docs/system.md +173 -0
  270. package/docs/system.zh-CN.md +173 -0
  271. package/docs/window.ja.md +138 -0
  272. package/docs/window.ko.md +140 -0
  273. package/docs/window.md +141 -0
  274. package/docs/window.zh-CN.md +141 -0
  275. package/native/addon.cc +129 -0
  276. package/native/audio-binding.cc +543 -0
  277. package/native/audio-codec-binding.cc +246 -0
  278. package/native/audio-device-binding.cc +160 -0
  279. package/native/audio-file-binding.cc +192 -0
  280. package/native/audio-recorder-binding.cc +237 -0
  281. package/native/audio-recorder.h +39 -0
  282. package/native/audio-state.h +220 -0
  283. package/native/audio-stream-binding.cc +284 -0
  284. package/native/audio-stream.h +28 -0
  285. package/native/audio-worker-binding.cc +447 -0
  286. package/native/audio-worker.h +121 -0
  287. package/native/batch-drawable.cc +189 -0
  288. package/native/batch-drawable.h +57 -0
  289. package/native/context-binding.cc +180 -0
  290. package/native/context-settings.h +74 -0
  291. package/native/deferred-delete.cc +49 -0
  292. package/native/deferred-delete.h +84 -0
  293. package/native/error-stream-binding.cc +270 -0
  294. package/native/exception-boundary.h +97 -0
  295. package/native/font-binding.cc +210 -0
  296. package/native/font-state.h +27 -0
  297. package/native/graphics-binding.cc +338 -0
  298. package/native/graphics-state.h +253 -0
  299. package/native/image-binding.cc +258 -0
  300. package/native/image-state.h +93 -0
  301. package/native/input-binding.cc +246 -0
  302. package/native/numeric-fields.h +96 -0
  303. package/native/render-window-binding.cc +103 -0
  304. package/native/render-window-state.h +22 -0
  305. package/native/shader-binding.cc +292 -0
  306. package/native/shape-binding.cc +283 -0
  307. package/native/shape-state.h +68 -0
  308. package/native/shaped-glyph-storage.h +45 -0
  309. package/native/shared-handle.h +69 -0
  310. package/native/stream-binding.cc +286 -0
  311. package/native/system-binding.cc +91 -0
  312. package/native/text-binding.cc +205 -0
  313. package/native/text-state.h +101 -0
  314. package/native/texture-binding.cc +330 -0
  315. package/native/texture-resource.h +52 -0
  316. package/native/time-value.h +28 -0
  317. package/native/transformable-binding.cc +23 -0
  318. package/native/transformable-state.h +44 -0
  319. package/native/value-binding.h +200 -0
  320. package/native/value-layout.h +116 -0
  321. package/native/values-binding.cc +27 -0
  322. package/native/vertex-binding.cc +50 -0
  323. package/native/vertex-buffer-binding.cc +232 -0
  324. package/native/vertex-storage.h +20 -0
  325. package/native/view-data.h +24 -0
  326. package/native/window-binding.cc +388 -0
  327. package/native/window-event.h +92 -0
  328. package/native/window-owner.h +81 -0
  329. package/package.json +87 -35
  330. package/src/audio/effect-processor.ts +86 -0
  331. package/src/audio/input-sound-file.ts +259 -0
  332. package/src/audio/listener.ts +136 -0
  333. package/src/audio/music.ts +357 -0
  334. package/src/audio/output-sound-file.ts +96 -0
  335. package/src/audio/playback-device.ts +145 -0
  336. package/src/audio/sound-buffer-recorder.ts +141 -0
  337. package/src/audio/sound-buffer.ts +275 -0
  338. package/src/audio/sound-file-factory.ts +235 -0
  339. package/src/audio/sound-file-reader.ts +224 -0
  340. package/src/audio/sound-file-writer.ts +61 -0
  341. package/src/audio/sound-recorder.ts +315 -0
  342. package/src/audio/sound-source.ts +396 -0
  343. package/src/audio/sound-stream.ts +108 -0
  344. package/src/audio/sound.ts +63 -0
  345. package/src/audio/value.ts +408 -0
  346. package/src/audio/worker.ts +308 -0
  347. package/src/graphics/blend-mode.ts +291 -0
  348. package/src/graphics/boolean-vector.ts +225 -0
  349. package/src/graphics/circle-shape.ts +113 -0
  350. package/src/graphics/color.ts +374 -0
  351. package/src/graphics/convex-shape.ts +76 -0
  352. package/src/graphics/drawable.ts +32 -0
  353. package/src/graphics/font.ts +377 -0
  354. package/src/graphics/glsl-matrix.ts +110 -0
  355. package/src/graphics/glsl.ts +229 -0
  356. package/src/graphics/glyph.ts +186 -0
  357. package/src/graphics/image.ts +366 -0
  358. package/src/graphics/primitive-type.ts +56 -0
  359. package/src/graphics/rect.ts +350 -0
  360. package/src/graphics/rectangle-shape.ts +76 -0
  361. package/src/graphics/render-states.ts +238 -0
  362. package/src/graphics/render-target.ts +554 -0
  363. package/src/graphics/render-texture.ts +234 -0
  364. package/src/graphics/render-window.ts +250 -0
  365. package/src/graphics/shader.ts +353 -0
  366. package/src/graphics/shape.ts +343 -0
  367. package/src/graphics/sprite.ts +203 -0
  368. package/src/graphics/stencil-mode.ts +258 -0
  369. package/src/graphics/swap.ts +28 -0
  370. package/src/graphics/text.ts +944 -0
  371. package/src/graphics/texture.ts +529 -0
  372. package/src/graphics/transform.ts +321 -0
  373. package/src/graphics/transformable.ts +37 -0
  374. package/src/graphics/vertex-array.ts +270 -0
  375. package/src/graphics/vertex-buffer.ts +345 -0
  376. package/src/graphics/vertex.ts +211 -0
  377. package/src/graphics/view.ts +355 -0
  378. package/src/index.ts +147 -0
  379. package/src/internal/audio-codec-registry.ts +68 -0
  380. package/src/internal/audio-input-stream.ts +42 -0
  381. package/src/internal/audio-music-pump.ts +199 -0
  382. package/src/internal/audio-native.ts +176 -0
  383. package/src/internal/audio-recorder-session.ts +234 -0
  384. package/src/internal/audio-worker-session.ts +89 -0
  385. package/src/internal/audio-worker.ts +146 -0
  386. package/src/internal/glsl-value.ts +79 -0
  387. package/src/internal/graphics-state.ts +131 -0
  388. package/src/internal/input-stream.ts +30 -0
  389. package/src/internal/lazy-value.ts +62 -0
  390. package/src/internal/native.ts +581 -0
  391. package/src/internal/numeric-properties.ts +37 -0
  392. package/src/internal/render-states.ts +42 -0
  393. package/src/internal/scalar.ts +117 -0
  394. package/src/internal/shaped-glyph.ts +68 -0
  395. package/src/internal/struct-view.ts +49 -0
  396. package/src/internal/text-indices.ts +19 -0
  397. package/src/internal/transformable.ts +260 -0
  398. package/src/internal/value-storage.ts +40 -0
  399. package/src/network/common.ts +58 -0
  400. package/src/network/dns.ts +191 -0
  401. package/src/network/ftp.ts +386 -0
  402. package/src/network/gen/constants.ts +879 -0
  403. package/src/network/http.ts +680 -0
  404. package/src/network/ip-address.ts +311 -0
  405. package/src/network/packet.ts +388 -0
  406. package/src/network/sftp.ts +1015 -0
  407. package/src/network/socket-selector.ts +206 -0
  408. package/src/network/socket.ts +415 -0
  409. package/src/network/tcp-listener.ts +193 -0
  410. package/src/network/tcp-socket.ts +569 -0
  411. package/src/network/tls-material.ts +46 -0
  412. package/src/network/udp-socket.ts +294 -0
  413. package/src/system/angle.ts +132 -0
  414. package/src/system/clock.ts +104 -0
  415. package/src/system/err.ts +58 -0
  416. package/src/system/error.ts +18 -0
  417. package/src/system/file-input-stream.ts +147 -0
  418. package/src/system/input-stream.ts +150 -0
  419. package/src/system/operators.ts +681 -0
  420. package/src/system/sleep.ts +25 -0
  421. package/src/system/suspend-aware-clock.ts +27 -0
  422. package/src/system/time.ts +218 -0
  423. package/src/system/timeout-with-predicate.ts +94 -0
  424. package/src/system/unicode.ts +64 -0
  425. package/src/system/vector2.ts +549 -0
  426. package/src/system/vector3.ts +433 -0
  427. package/src/system/version.ts +66 -0
  428. package/src/window/clipboard.ts +22 -0
  429. package/src/window/context-settings.ts +143 -0
  430. package/src/window/context.ts +152 -0
  431. package/src/window/cursor.ts +116 -0
  432. package/src/window/event.ts +580 -0
  433. package/src/window/gen/constants.ts +2231 -0
  434. package/src/window/joystick.ts +108 -0
  435. package/src/window/keyboard.ts +78 -0
  436. package/src/window/mouse.ts +58 -0
  437. package/src/window/sensor.ts +37 -0
  438. package/src/window/touch.ts +42 -0
  439. package/src/window/video-mode.ts +136 -0
  440. package/src/window/vulkan.ts +42 -0
  441. package/src/window/window.ts +579 -0
  442. package/test/native/audio-probes.cc +181 -0
  443. package/test/native/deferred-delete-probes.cc +62 -0
  444. package/test/native/drawable-probes.cc +168 -0
  445. package/test/native/exception-probes.cc +83 -0
  446. package/test/native/image-probes.cc +105 -0
  447. package/test/native/matrix-probes.cc +67 -0
  448. package/test/native/network-oracle.cc +32 -0
  449. package/test/native/render-texture-probes.cc +193 -0
  450. package/test/native/shader-probes.cc +69 -0
  451. package/test/native/shape-probes.cc +160 -0
  452. package/test/native/sprite-probes.cc +146 -0
  453. package/test/native/system-probes.cc +109 -0
  454. package/test/native/text-probes.cc +211 -0
  455. package/test/native/texture-probes.cc +200 -0
  456. package/test/native/time-probes.cc +143 -0
  457. package/test/native/transform-probes.cc +92 -0
  458. package/test/native/transformable-probes.cc +152 -0
  459. package/test/native/value-oracle.h +88 -0
  460. package/test/native/value-probes.cc +379 -0
  461. package/test/native/vertex-array-probes.cc +82 -0
  462. package/test/native/vertex-buffer-probes.cc +87 -0
  463. package/test/native/view-probes.cc +150 -0
  464. package/test/native/window-probes.cc +172 -0
  465. package/test/tsconfig.json +8 -0
  466. package/tools/configure-lsp.cjs +23 -0
  467. package/tools/constant-docs.cjs +109 -0
  468. package/tools/constant-docs.json +1318 -0
  469. package/tools/generate-network-constants.cjs +59 -0
  470. package/tools/generate-window-constants.cjs +178 -0
  471. package/tools/lib_downloader.cjs +92 -0
  472. package/tools/lib_downloader_urls.cjs +23 -0
  473. package/tsconfig.json +11 -4
  474. package/index.d.ts +0 -1
  475. package/lib/clock.d.ts +0 -8
  476. package/lib/clock.js +0 -5
  477. package/lib/color.d.ts +0 -11
  478. package/lib/color.js +0 -98
  479. package/lib/common.js +0 -47
  480. package/lib/drawable/circle_shape.d.ts +0 -5
  481. package/lib/drawable/circle_shape.js +0 -26
  482. package/lib/drawable/convex_shape.d.ts +0 -5
  483. package/lib/drawable/convex_shape.js +0 -35
  484. package/lib/drawable/drawable.d.ts +0 -6
  485. package/lib/drawable/drawable.js +0 -18
  486. package/lib/drawable/plugin_package.d.ts +0 -31
  487. package/lib/drawable/plugin_package.js +0 -102
  488. package/lib/drawable/rectangle_shape.d.ts +0 -9
  489. package/lib/drawable/rectangle_shape.js +0 -28
  490. package/lib/drawable/shape.d.ts +0 -14
  491. package/lib/drawable/shape.js +0 -30
  492. package/lib/drawable/sprite.d.ts +0 -17
  493. package/lib/drawable/sprite.js +0 -53
  494. package/lib/drawable/text.d.ts +0 -26
  495. package/lib/drawable/text.js +0 -88
  496. package/lib/drawable/transformable.d.ts +0 -28
  497. package/lib/drawable/transformable.js +0 -113
  498. package/lib/drawable/vertex_array.d.ts +0 -40
  499. package/lib/drawable/vertex_array.js +0 -128
  500. package/lib/font.d.ts +0 -24
  501. package/lib/font.js +0 -137
  502. package/lib/image.d.ts +0 -26
  503. package/lib/image.js +0 -147
  504. package/lib/joystick.d.ts +0 -21
  505. package/lib/joystick.js +0 -72
  506. package/lib/keyboard.d.ts +0 -113
  507. package/lib/keyboard.js +0 -17
  508. package/lib/mouse.d.ts +0 -6
  509. package/lib/mouse.js +0 -39
  510. package/lib/poll_event.d.ts +0 -138
  511. package/lib/rect.d.ts +0 -18
  512. package/lib/rect.js +0 -119
  513. package/lib/render_window.d.ts +0 -67
  514. package/lib/render_window.js +0 -197
  515. package/lib/sensor.d.ts +0 -12
  516. package/lib/sensor.js +0 -34
  517. package/lib/sfml.d.ts +0 -32
  518. package/lib/sfml.js +0 -36
  519. package/lib/sound/base.d.ts +0 -33
  520. package/lib/sound/base.js +0 -109
  521. package/lib/sound/music.d.ts +0 -15
  522. package/lib/sound/music.js +0 -65
  523. package/lib/sound/sound.d.ts +0 -16
  524. package/lib/sound/sound.js +0 -55
  525. package/lib/sound/sound_buffer.d.ts +0 -14
  526. package/lib/sound/sound_buffer.js +0 -78
  527. package/lib/texture.d.ts +0 -21
  528. package/lib/texture.js +0 -127
  529. package/lib/time.d.ts +0 -13
  530. package/lib/time.js +0 -41
  531. package/lib/touch.d.ts +0 -7
  532. package/lib/touch.js +0 -34
  533. package/lib/vector2.d.ts +0 -49
  534. package/lib/vector2.js +0 -141
  535. package/lib/vector3.d.ts +0 -47
  536. package/lib/vector3.js +0 -154
  537. package/lib/vertex.d.ts +0 -14
  538. package/lib/vertex.js +0 -177
  539. package/lib/video_mode.d.ts +0 -12
  540. package/lib/video_mode.js +0 -99
  541. package/src/base_class_with_loading.h +0 -21
  542. package/src/clock.cc +0 -71
  543. package/src/clock.h +0 -30
  544. package/src/color.cc +0 -189
  545. package/src/color.h +0 -49
  546. package/src/drawable/circle_shape.cc +0 -78
  547. package/src/drawable/circle_shape.h +0 -28
  548. package/src/drawable/convex_shape.cc +0 -57
  549. package/src/drawable/convex_shape.h +0 -29
  550. package/src/drawable/drawable-inl.h +0 -29
  551. package/src/drawable/drawable.cc +0 -41
  552. package/src/drawable/drawable.h +0 -49
  553. package/src/drawable/package_plugin-inl.h +0 -191
  554. package/src/drawable/package_plugin.h +0 -60
  555. package/src/drawable/rectangle_shape.cc +0 -69
  556. package/src/drawable/rectangle_shape.h +0 -29
  557. package/src/drawable/shape.cc +0 -67
  558. package/src/drawable/shape.h +0 -39
  559. package/src/drawable/sprite.cc +0 -122
  560. package/src/drawable/sprite.h +0 -45
  561. package/src/drawable/text.cc +0 -133
  562. package/src/drawable/text.h +0 -54
  563. package/src/drawable/vertex_array.cc +0 -248
  564. package/src/drawable/vertex_array.h +0 -46
  565. package/src/font.cc +0 -214
  566. package/src/font.h +0 -44
  567. package/src/gen/.gitkeep +0 -0
  568. package/src/gen/joystick_axis.cc +0 -30
  569. package/src/gen/keycode.cc +0 -226
  570. package/src/gen/mouse_button.cc +0 -30
  571. package/src/gen/sensor_type.cc +0 -26
  572. package/src/image.cc +0 -379
  573. package/src/image.h +0 -72
  574. package/src/joystick.cc +0 -132
  575. package/src/joystick.h +0 -32
  576. package/src/keyboard.cc +0 -65
  577. package/src/keyboard.h +0 -27
  578. package/src/mouse.cc +0 -95
  579. package/src/mouse.h +0 -30
  580. package/src/plugins/transformable_plugin-inl.h +0 -121
  581. package/src/plugins/transformable_plugin.h +0 -42
  582. package/src/poll_event.cc +0 -326
  583. package/src/poll_event.h +0 -18
  584. package/src/rect-inl.h +0 -154
  585. package/src/rect.cc +0 -28
  586. package/src/rect.h +0 -105
  587. package/src/render_window.cc +0 -413
  588. package/src/render_window.h +0 -111
  589. package/src/render_window_async_display.cc +0 -49
  590. package/src/render_window_async_draw.cc +0 -56
  591. package/src/resizable_buffer.h +0 -104
  592. package/src/sensor.cc +0 -82
  593. package/src/sensor.h +0 -28
  594. package/src/sfml.cc +0 -85
  595. package/src/sound/music.cc +0 -113
  596. package/src/sound/music.h +0 -35
  597. package/src/sound/sound.cc +0 -116
  598. package/src/sound/sound.h +0 -41
  599. package/src/sound/sound_buffer.cc +0 -226
  600. package/src/sound/sound_buffer.h +0 -46
  601. package/src/sound/sound_source.cc +0 -124
  602. package/src/sound/sound_source.h +0 -80
  603. package/src/texture.cc +0 -246
  604. package/src/texture.h +0 -47
  605. package/src/time.cc +0 -177
  606. package/src/time.h +0 -42
  607. package/src/touch.cc +0 -54
  608. package/src/touch.h +0 -23
  609. package/src/utils-inl.h +0 -48
  610. package/src/utils.h +0 -21
  611. package/src/vector2-inl.h +0 -198
  612. package/src/vector2.cc +0 -36
  613. package/src/vector2.h +0 -133
  614. package/src/vector3-inl.h +0 -200
  615. package/src/vector3.cc +0 -36
  616. package/src/vector3.h +0 -134
  617. package/src/vertex.cc +0 -238
  618. package/src/vertex.h +0 -114
  619. package/src/video_mode.cc +0 -184
  620. package/src/video_mode.h +0 -38
  621. package/src/workers/load_from_file_worker.h +0 -79
  622. package/src/workers/save_to_file_worker.h +0 -79
  623. package/third_party/sfml/include/SFML/Audio/AlResource.hpp +0 -70
  624. package/third_party/sfml/include/SFML/Audio/Export.hpp +0 -48
  625. package/third_party/sfml/include/SFML/Audio/InputSoundFile.hpp +0 -268
  626. package/third_party/sfml/include/SFML/Audio/Listener.hpp +0 -234
  627. package/third_party/sfml/include/SFML/Audio/Music.hpp +0 -337
  628. package/third_party/sfml/include/SFML/Audio/OutputSoundFile.hpp +0 -133
  629. package/third_party/sfml/include/SFML/Audio/Sound.hpp +0 -264
  630. package/third_party/sfml/include/SFML/Audio/SoundBuffer.hpp +0 -352
  631. package/third_party/sfml/include/SFML/Audio/SoundBufferRecorder.hpp +0 -144
  632. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.hpp +0 -197
  633. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.inl +0 -100
  634. package/third_party/sfml/include/SFML/Audio/SoundFileReader.hpp +0 -165
  635. package/third_party/sfml/include/SFML/Audio/SoundFileWriter.hpp +0 -125
  636. package/third_party/sfml/include/SFML/Audio/SoundRecorder.hpp +0 -410
  637. package/third_party/sfml/include/SFML/Audio/SoundSource.hpp +0 -332
  638. package/third_party/sfml/include/SFML/Audio/SoundStream.hpp +0 -420
  639. package/third_party/sfml/include/SFML/Audio.hpp +0 -56
  640. package/third_party/sfml/include/SFML/Config.hpp +0 -248
  641. package/third_party/sfml/include/SFML/GpuPreference.hpp +0 -74
  642. package/third_party/sfml/include/SFML/Graphics/BlendMode.hpp +0 -219
  643. package/third_party/sfml/include/SFML/Graphics/CircleShape.hpp +0 -154
  644. package/third_party/sfml/include/SFML/Graphics/Color.hpp +0 -275
  645. package/third_party/sfml/include/SFML/Graphics/ConvexShape.hpp +0 -153
  646. package/third_party/sfml/include/SFML/Graphics/Drawable.hpp +0 -126
  647. package/third_party/sfml/include/SFML/Graphics/Export.hpp +0 -48
  648. package/third_party/sfml/include/SFML/Graphics/Font.hpp +0 -496
  649. package/third_party/sfml/include/SFML/Graphics/Glsl.hpp +0 -227
  650. package/third_party/sfml/include/SFML/Graphics/Glsl.inl +0 -155
  651. package/third_party/sfml/include/SFML/Graphics/Glyph.hpp +0 -81
  652. package/third_party/sfml/include/SFML/Graphics/Image.hpp +0 -346
  653. package/third_party/sfml/include/SFML/Graphics/PrimitiveType.hpp +0 -58
  654. package/third_party/sfml/include/SFML/Graphics/Rect.hpp +0 -274
  655. package/third_party/sfml/include/SFML/Graphics/Rect.inl +0 -171
  656. package/third_party/sfml/include/SFML/Graphics/RectangleShape.hpp +0 -132
  657. package/third_party/sfml/include/SFML/Graphics/RenderStates.hpp +0 -174
  658. package/third_party/sfml/include/SFML/Graphics/RenderTarget.hpp +0 -518
  659. package/third_party/sfml/include/SFML/Graphics/RenderTexture.hpp +0 -334
  660. package/third_party/sfml/include/SFML/Graphics/RenderWindow.hpp +0 -302
  661. package/third_party/sfml/include/SFML/Graphics/Shader.hpp +0 -875
  662. package/third_party/sfml/include/SFML/Graphics/Shape.hpp +0 -355
  663. package/third_party/sfml/include/SFML/Graphics/Sprite.hpp +0 -279
  664. package/third_party/sfml/include/SFML/Graphics/Text.hpp +0 -513
  665. package/third_party/sfml/include/SFML/Graphics/Texture.hpp +0 -733
  666. package/third_party/sfml/include/SFML/Graphics/Transform.hpp +0 -497
  667. package/third_party/sfml/include/SFML/Graphics/Transformable.hpp +0 -429
  668. package/third_party/sfml/include/SFML/Graphics/Vertex.hpp +0 -148
  669. package/third_party/sfml/include/SFML/Graphics/VertexArray.hpp +0 -223
  670. package/third_party/sfml/include/SFML/Graphics/VertexBuffer.hpp +0 -408
  671. package/third_party/sfml/include/SFML/Graphics/View.hpp +0 -343
  672. package/third_party/sfml/include/SFML/Graphics.hpp +0 -68
  673. package/third_party/sfml/include/SFML/Main.hpp +0 -43
  674. package/third_party/sfml/include/SFML/Network/Export.hpp +0 -48
  675. package/third_party/sfml/include/SFML/Network/Ftp.hpp +0 -616
  676. package/third_party/sfml/include/SFML/Network/Http.hpp +0 -482
  677. package/third_party/sfml/include/SFML/Network/IpAddress.hpp +0 -328
  678. package/third_party/sfml/include/SFML/Network/Packet.hpp +0 -545
  679. package/third_party/sfml/include/SFML/Network/Socket.hpp +0 -219
  680. package/third_party/sfml/include/SFML/Network/SocketHandle.hpp +0 -57
  681. package/third_party/sfml/include/SFML/Network/SocketSelector.hpp +0 -263
  682. package/third_party/sfml/include/SFML/Network/TcpListener.hpp +0 -170
  683. package/third_party/sfml/include/SFML/Network/TcpSocket.hpp +0 -316
  684. package/third_party/sfml/include/SFML/Network/UdpSocket.hpp +0 -292
  685. package/third_party/sfml/include/SFML/Network.hpp +0 -53
  686. package/third_party/sfml/include/SFML/OpenGL.hpp +0 -78
  687. package/third_party/sfml/include/SFML/System/Clock.hpp +0 -117
  688. package/third_party/sfml/include/SFML/System/Err.hpp +0 -80
  689. package/third_party/sfml/include/SFML/System/Export.hpp +0 -48
  690. package/third_party/sfml/include/SFML/System/FileInputStream.hpp +0 -169
  691. package/third_party/sfml/include/SFML/System/InputStream.hpp +0 -152
  692. package/third_party/sfml/include/SFML/System/Lock.hpp +0 -139
  693. package/third_party/sfml/include/SFML/System/MemoryInputStream.hpp +0 -148
  694. package/third_party/sfml/include/SFML/System/Mutex.hpp +0 -148
  695. package/third_party/sfml/include/SFML/System/NativeActivity.hpp +0 -62
  696. package/third_party/sfml/include/SFML/System/NonCopyable.hpp +0 -129
  697. package/third_party/sfml/include/SFML/System/Sleep.hpp +0 -52
  698. package/third_party/sfml/include/SFML/System/String.hpp +0 -669
  699. package/third_party/sfml/include/SFML/System/String.inl +0 -53
  700. package/third_party/sfml/include/SFML/System/Thread.hpp +0 -282
  701. package/third_party/sfml/include/SFML/System/Thread.inl +0 -90
  702. package/third_party/sfml/include/SFML/System/ThreadLocal.hpp +0 -103
  703. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.hpp +0 -158
  704. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.inl +0 -77
  705. package/third_party/sfml/include/SFML/System/Time.hpp +0 -488
  706. package/third_party/sfml/include/SFML/System/Utf.hpp +0 -763
  707. package/third_party/sfml/include/SFML/System/Utf.inl +0 -752
  708. package/third_party/sfml/include/SFML/System/Vector2.hpp +0 -301
  709. package/third_party/sfml/include/SFML/System/Vector2.inl +0 -161
  710. package/third_party/sfml/include/SFML/System/Vector3.hpp +0 -302
  711. package/third_party/sfml/include/SFML/System/Vector3.inl +0 -168
  712. package/third_party/sfml/include/SFML/System.hpp +0 -60
  713. package/third_party/sfml/include/SFML/Window/Clipboard.hpp +0 -119
  714. package/third_party/sfml/include/SFML/Window/Context.hpp +0 -195
  715. package/third_party/sfml/include/SFML/Window/ContextSettings.hpp +0 -149
  716. package/third_party/sfml/include/SFML/Window/Cursor.hpp +0 -241
  717. package/third_party/sfml/include/SFML/Window/Event.hpp +0 -285
  718. package/third_party/sfml/include/SFML/Window/Export.hpp +0 -48
  719. package/third_party/sfml/include/SFML/Window/GlResource.hpp +0 -109
  720. package/third_party/sfml/include/SFML/Window/Joystick.hpp +0 -227
  721. package/third_party/sfml/include/SFML/Window/Keyboard.hpp +0 -491
  722. package/third_party/sfml/include/SFML/Window/Mouse.hpp +0 -180
  723. package/third_party/sfml/include/SFML/Window/Sensor.hpp +0 -150
  724. package/third_party/sfml/include/SFML/Window/Touch.hpp +0 -137
  725. package/third_party/sfml/include/SFML/Window/VideoMode.hpp +0 -228
  726. package/third_party/sfml/include/SFML/Window/Vulkan.hpp +0 -115
  727. package/third_party/sfml/include/SFML/Window/Window.hpp +0 -354
  728. package/third_party/sfml/include/SFML/Window/WindowBase.hpp +0 -518
  729. package/third_party/sfml/include/SFML/Window/WindowHandle.hpp +0 -101
  730. package/third_party/sfml/include/SFML/Window/WindowStyle.hpp +0 -53
  731. package/third_party/sfml/include/SFML/Window.hpp +0 -58
  732. package/tools/clang_format.js +0 -9
  733. package/tools/copier/linux.js +0 -21
  734. package/tools/copier/macos.js +0 -34
  735. package/tools/copier/windows.js +0 -33
  736. package/tools/joystick_axis.js +0 -63
  737. package/tools/keycode.js +0 -92
  738. package/tools/lib_downloader.js +0 -107
  739. package/tools/lib_downloader_urls.js +0 -59
  740. package/tools/mouse_button.js +0 -92
  741. package/tools/sensor_type.js +0 -63
@@ -0,0 +1,117 @@
1
+ export const scalarArrays = {
2
+ i32: Int32Array,
3
+ u32: Uint32Array,
4
+ f32: Float32Array,
5
+ f64: Float64Array,
6
+ i8: Int8Array,
7
+ u8: Uint8Array,
8
+ i16: Int16Array,
9
+ u16: Uint16Array,
10
+ i64: BigInt64Array,
11
+ u64: BigUint64Array,
12
+ };
13
+
14
+ /**
15
+ * Vector scalar type: i/u denotes signed/unsigned integers, f denotes
16
+ * floating point, and the suffix is the bit width.
17
+ * @zh 向量标量类型:i/u 表示有符号/无符号整数,f 表示浮点,后缀为位数。
18
+ * @ja ベクトルのスカラー型。i/u は符号付き/符号なし整数、
19
+ * f は浮動小数点数、末尾の数字はビット幅を表します。
20
+ * @ko 벡터 스칼라 유형입니다. i/u는 부호 있는/없는 정수,
21
+ * f는 부동 소수점을 나타내며 접미사는 비트 수입니다.
22
+ */
23
+ export type ScalarType = keyof typeof scalarArrays;
24
+ export type BigIntScalar = 'i64' | 'u64';
25
+ export type NumberScalar = Exclude<ScalarType, BigIntScalar>;
26
+ export type FloatScalar = 'f32' | 'f64';
27
+ type ScalarValues = { [T in NumberScalar]: number } &
28
+ { [T in BigIntScalar]: bigint };
29
+ export type Scalar<T extends ScalarType> = ScalarValues[T];
30
+ // Explicit view types remain compatible with TS 5.0 and TS 5.9's generic buffers.
31
+ interface ScalarViews {
32
+ i8: Int8Array;
33
+ u8: Uint8Array;
34
+ i16: Int16Array;
35
+ u16: Uint16Array;
36
+ i32: Int32Array;
37
+ u32: Uint32Array;
38
+ i64: BigInt64Array;
39
+ u64: BigUint64Array;
40
+ f32: Float32Array;
41
+ f64: Float64Array;
42
+ }
43
+ export type ScalarArray<T extends ScalarType = ScalarType> = ScalarViews[T];
44
+
45
+ export function isBigIntScalar(type: ScalarType): type is BigIntScalar {
46
+ return type === 'i64' || type === 'u64';
47
+ }
48
+
49
+ export function validateScalar(type: string): asserts type is ScalarType {
50
+ if (!Object.prototype.hasOwnProperty.call(scalarArrays, type)) {
51
+ throw new TypeError('Unsupported vector scalar type');
52
+ }
53
+ }
54
+
55
+ export function toScalar(type: ScalarType, value: number): number {
56
+ if (type === 'f32') return Math.fround(value);
57
+ if (type === 'f64') return value;
58
+ // eslint-disable-next-line no-bitwise
59
+ if (type === 'i8') return (value << 24) >> 24;
60
+ // eslint-disable-next-line no-bitwise
61
+ if (type === 'u8') return value & 255;
62
+ // eslint-disable-next-line no-bitwise
63
+ if (type === 'i16') return (value << 16) >> 16;
64
+ // eslint-disable-next-line no-bitwise
65
+ if (type === 'u16') return value & 65535;
66
+ // eslint-disable-next-line no-bitwise
67
+ return type === 'i32' ? value | 0 : value >>> 0;
68
+ }
69
+
70
+ export function scalarProduct(
71
+ type: ScalarType, lhs: number, rhs: number,
72
+ ): number {
73
+ if (type === 'f32') return Math.fround(lhs * rhs);
74
+ if (type === 'f64') return lhs * rhs;
75
+ return Math.imul(lhs, rhs);
76
+ }
77
+
78
+ export function requireFloat(type: ScalarType): void {
79
+ if (type !== 'f32' && type !== 'f64') {
80
+ throw new TypeError('This operation requires a floating-point vector');
81
+ }
82
+ }
83
+
84
+ /** Explicit vector conversion, preserving integer low bits before Number(). */
85
+ export function convertScalar(
86
+ type: ScalarType, value: number | bigint | boolean,
87
+ ): number | bigint {
88
+ if (isBigIntScalar(type)) {
89
+ const integer = typeof value === 'number' ? BigInt(Math.trunc(value))
90
+ : BigInt(value);
91
+ return type === 'i64' ? BigInt.asIntN(64, integer)
92
+ : BigInt.asUintN(64, integer);
93
+ }
94
+ if (typeof value === 'bigint') {
95
+ if (type === 'f32') {
96
+ // Avoid double rounding when int64/uint64 lies near a float32 midpoint.
97
+ const negative = value < 0n;
98
+ const magnitude = negative ? -value : value;
99
+ const shift = magnitude.toString(2).length - 24;
100
+ if (shift > 0) {
101
+ /* eslint-disable no-bitwise */
102
+ const bits = BigInt(shift);
103
+ let rounded = magnitude >> bits;
104
+ const rest = magnitude - (rounded << bits);
105
+ const half = 1n << (bits - 1n);
106
+ /* eslint-enable no-bitwise */
107
+ if (rest > half || (rest === half && rounded % 2n !== 0n)) rounded++;
108
+ return (negative ? -1 : 1) * Number(rounded) * 2 ** shift;
109
+ }
110
+ } else if (type !== 'f64') {
111
+ const bits = type.endsWith('8') ? 8 : type.endsWith('16') ? 16 : 32;
112
+ return Number(type.startsWith('i')
113
+ ? BigInt.asIntN(bits, value) : BigInt.asUintN(bits, value));
114
+ }
115
+ }
116
+ return toScalar(type, Number(value));
117
+ }
@@ -0,0 +1,68 @@
1
+ import { native, type NativeShapedGlyphs } from './native';
2
+ import { LazyValue } from './lazy-value';
3
+ import type { ReadonlyValue as R } from './value-storage';
4
+ import type { TextIndices } from './text-indices';
5
+ import { glyphFromState, type Glyph } from '../graphics/glyph';
6
+ import { vector2FromState, type Vector2f } from '../system/vector2';
7
+ import type { ShapedGlyph, TextDirection } from '../graphics/text';
8
+
9
+ /** One set of typed views per native allocation, shared by all glyph wrappers. */
10
+ export class ShapedGlyphBuffer {
11
+ readonly bytes: Uint8Array;
12
+ readonly floats: Float32Array;
13
+ readonly words: Uint32Array;
14
+ readonly doubles: Float64Array;
15
+ readonly length: number;
16
+
17
+ constructor(readonly mapping: NativeShapedGlyphs) {
18
+ this.bytes = new Uint8Array(mapping.buffer);
19
+ this.floats = new Float32Array(mapping.buffer);
20
+ this.words = new Uint32Array(mapping.buffer);
21
+ this.doubles = new Float64Array(mapping.buffer);
22
+ this.length = mapping.buffer.byteLength / 80;
23
+ }
24
+ }
25
+
26
+ /** Scalar reads never enter Native; members alias their original allocation. */
27
+ export class ShapedGlyphView implements ShapedGlyph {
28
+ private glyphView?: R<Glyph>;
29
+ private positionView?: R<Vector2f>;
30
+
31
+ constructor(
32
+ private readonly storage: ShapedGlyphBuffer,
33
+ private readonly index: number,
34
+ private readonly indices: TextIndices,
35
+ ) {}
36
+
37
+ get glyph(): R<Glyph> {
38
+ if (!this.glyphView) {
39
+ const { storage, index } = this;
40
+ this.glyphView = glyphFromState(new LazyValue(
41
+ storage.bytes.subarray(index * 80, index * 80 + 44),
42
+ () => native.shapedGlyphMember(storage.mapping.handle, index, 0),
43
+ ));
44
+ }
45
+ return this.glyphView;
46
+ }
47
+
48
+ get position(): R<Vector2f> {
49
+ if (!this.positionView) {
50
+ const { storage, index } = this;
51
+ this.positionView = vector2FromState('f32', new LazyValue(
52
+ storage.floats.subarray(index * 20 + 11, index * 20 + 13),
53
+ () => native.shapedGlyphMember(storage.mapping.handle, index, 1),
54
+ ));
55
+ }
56
+ return this.positionView;
57
+ }
58
+
59
+ get cluster(): number {
60
+ return this.indices.toUtf16(this.storage.words[this.index * 20 + 13]);
61
+ }
62
+ get textDirection(): TextDirection {
63
+ return this.storage.words[this.index * 20 + 14];
64
+ }
65
+ get baseline(): number { return this.storage.floats[this.index * 20 + 15]; }
66
+ get vertexOffset(): number { return this.storage.doubles[this.index * 10 + 8]; }
67
+ get vertexCount(): number { return this.storage.doubles[this.index * 10 + 9]; }
68
+ }
@@ -0,0 +1,49 @@
1
+ type FieldType = 'i8' | 'u8' | 'bool' | 'u32' | 'f32' | 'f64' | 'i64' | 'u64' | 'size64';
2
+ export type StructFields<T> = Partial<Record<keyof T, readonly [FieldType, number]>>;
3
+
4
+ export interface NativeStruct {
5
+ buffers: ArrayBuffer[];
6
+ fields: Record<string, readonly [FieldType, number, number]>;
7
+ }
8
+
9
+ const littleEndian = new Uint8Array(new Uint32Array([ 1 ]).buffer)[0] === 1;
10
+ const readers = {
11
+ i8: (data: DataView, offset: number) => data.getInt8(offset),
12
+ u8: (data: DataView, offset: number) => data.getUint8(offset),
13
+ bool: (data: DataView, offset: number) => data.getUint8(offset) !== 0,
14
+ u32: (data: DataView, offset: number) => data.getUint32(offset, littleEndian),
15
+ f32: (data: DataView, offset: number) => data.getFloat32(offset, littleEndian),
16
+ f64: (data: DataView, offset: number) => data.getFloat64(offset, littleEndian),
17
+ u64: (data: DataView, offset: number) => data.getBigUint64(offset, littleEndian),
18
+ i64: (data: DataView, offset: number) => data.getBigInt64(offset, littleEndian),
19
+ size64: (data: DataView, offset: number) =>
20
+ Number(data.getBigUint64(offset, littleEndian)),
21
+ };
22
+
23
+ /** Read-only resource metadata, with offsets supplied by native member pointers. */
24
+ export function nativeStruct<T extends object>(
25
+ mapping: NativeStruct, extra: Partial<T> = {},
26
+ ): Readonly<T> {
27
+ const data = mapping.buffers.map(buffer => new DataView(buffer));
28
+ const descriptors: PropertyDescriptorMap = {};
29
+ for (const [ key, [ type, region, offset ]] of Object.entries(mapping.fields)) {
30
+ const view = data[region];
31
+ const read = readers[type];
32
+ descriptors[key] = { enumerable: true, get: () => read(view, offset) };
33
+ }
34
+ return Object.freeze(Object.defineProperties({ ...extra }, descriptors)) as T;
35
+ }
36
+
37
+ /** Frozen named getters over native-owned bytes; no mirrored scalar fields. */
38
+ export function readonlyStruct<T extends object>(
39
+ buffer: ArrayBuffer, fields: StructFields<T>, extra: Partial<T> = {},
40
+ ): Readonly<T> {
41
+ const data = new DataView(buffer);
42
+ const descriptors: PropertyDescriptorMap = {};
43
+ for (const [ key, field ] of Object.entries(fields)) {
44
+ const [ type, offset ] = field as readonly [FieldType, number];
45
+ const read = readers[type];
46
+ descriptors[key] = { enumerable: true, get: () => read(data, offset) };
47
+ }
48
+ return Object.freeze(Object.defineProperties({ ...extra }, descriptors)) as T;
49
+ }
@@ -0,0 +1,19 @@
1
+ /** Immutable string snapshot with a lazily built code point → UTF-16 map. */
2
+ export class TextIndices {
3
+ private offsets?: number[];
4
+
5
+ constructor(private readonly string: string) {}
6
+
7
+ toUtf16(codePointIndex: number): number {
8
+ if (!this.offsets) {
9
+ const offsets = [ 0 ];
10
+ let position = 0;
11
+ for (const character of this.string) {
12
+ position += character.length;
13
+ offsets.push(position);
14
+ }
15
+ this.offsets = offsets;
16
+ }
17
+ return this.offsets[codePointIndex];
18
+ }
19
+ }
@@ -0,0 +1,260 @@
1
+ import { Transform } from '../graphics/transform';
2
+ import { Vector2, Vector2f } from '../system/vector2';
3
+ import { Angle, radians, positiveRemainder } from '../system/angle';
4
+ import type { NativeGraphicsHandle } from './native';
5
+ import {
6
+ mutableValue, vector2Storage, transformStorage, type ReadonlyValue as R,
7
+ } from './value-storage';
8
+
9
+ export const transformableState: unique symbol = Symbol('Transformable.state');
10
+ const tau = Math.fround(Math.fround(3.141592654) * 2);
11
+ const f = Math.fround;
12
+
13
+ interface TransformCache {
14
+ input: Float32Array;
15
+ transform: R<Transform>;
16
+ inverse?: R<Transform>;
17
+ inverseDirty: boolean;
18
+ }
19
+
20
+ export interface TransformableState {
21
+ handle: NativeGraphicsHandle<'transformable'>;
22
+ values: Float32Array;
23
+ cache?: TransformCache;
24
+ }
25
+
26
+ export interface TransformableHost {
27
+ readonly [mutableValue]: true;
28
+ readonly [transformableState]: TransformableState;
29
+ }
30
+
31
+ export interface TransformableMethods extends TransformableHost {
32
+ /**
33
+ * Set the object's origin in parent coordinates, copying position.
34
+ * @zh 设置对象原点在父坐标系中的位置,复制 position 的值。
35
+ * @ja 親座標系での原点の位置を設定し、position の値をコピーします。
36
+ * @ko 부모 좌표계에서 원점 위치를 설정하고 position 값을 복사합니다.
37
+ */
38
+ setPosition(this: TransformableHost, position: R<Vector2f>): void;
39
+ /**
40
+ * Return an independent copy of the position.
41
+ * @zh 返回位置的独立副本。
42
+ * @ja 位置の独立したコピーを返します。
43
+ * @ko 위치의 독립적인 복사본을 반환합니다.
44
+ */
45
+ getPosition(): Vector2f;
46
+ /**
47
+ * Add offset to the current position.
48
+ * @zh 将 offset 加到当前位置。
49
+ * @ja 現在の位置に offset を加えます。
50
+ * @ko 현재 위치에 offset을 더합니다.
51
+ */
52
+ move(this: TransformableHost, offset: R<Vector2f>): void;
53
+ /**
54
+ * Set the rotation; positive angles are clockwise in screen coordinates.
55
+ * @zh 设置旋转角度;屏幕坐标中正角度为顺时针。
56
+ * @ja 回転角を設定します。画面座標では正の角度が時計回りです。
57
+ * @ko 회전 각도를 설정합니다. 화면 좌표에서 양의 각도는 시계 방향입니다.
58
+ */
59
+ setRotation(this: TransformableHost, angle: R<Angle>): void;
60
+ /**
61
+ * Return a copy of the rotation normalized to [0°, 360°).
62
+ * @zh 返回归一化到 [0°, 360°) 的旋转角度副本。
63
+ * @ja [0°, 360°) に正規化した回転角のコピーを返します。
64
+ * @ko [0°, 360°)로 정규화한 회전 각도의 복사본을 반환합니다.
65
+ */
66
+ getRotation(): Angle;
67
+ /**
68
+ * Add angle to the current rotation.
69
+ * @zh 在当前旋转角度上累加 angle。
70
+ * @ja 現在の回転角に angle を加えます。
71
+ * @ko 현재 회전 각도에 angle을 더합니다.
72
+ */
73
+ rotate(this: TransformableHost, angle: R<Angle>): void;
74
+ /**
75
+ * Set X/Y scale factors; (1, 1) is original size and negatives flip axes.
76
+ * @zh 设置 X、Y 缩放因子;(1, 1) 为原始大小,负值可翻转。
77
+ * @ja X・Y の拡大率を設定します。(1, 1) は元の大きさ、負値は反転です。
78
+ * @ko X/Y 배율을 설정합니다. (1, 1)은 원래 크기이며 음수는 축을 뒤집습니다.
79
+ */
80
+ setScale(this: TransformableHost, factors: R<Vector2f>): void;
81
+ /**
82
+ * Return an independent copy of the scale factors.
83
+ * @zh 返回缩放因子的独立副本。
84
+ * @ja 拡大率の独立したコピーを返します。
85
+ * @ko 배율의 독립적인 복사본을 반환합니다.
86
+ */
87
+ getScale(): Vector2f;
88
+ /**
89
+ * Multiply the current X/Y scale factors by the components of factors.
90
+ * @zh 将当前 X、Y 缩放因子分别乘以 factors。
91
+ * @ja 現在の X・Y の拡大率に factors の各成分を掛けます。
92
+ * @ko 현재 X/Y 배율에 factors의 각 성분을 곱합니다.
93
+ */
94
+ scale(this: TransformableHost, factors: R<Vector2f>): void;
95
+ /**
96
+ * Set the local origin around which rotation and scaling take place.
97
+ * @zh 设置局部坐标中的变换原点,旋转和缩放围绕该点进行。
98
+ * @ja 回転と拡大縮小の中心となる原点をローカル座標で設定します。
99
+ * @ko 회전과 크기 조절의 중심이 되는 원점을 로컬 좌표로 설정합니다.
100
+ */
101
+ setOrigin(this: TransformableHost, origin: R<Vector2f>): void;
102
+ /**
103
+ * Return an independent copy of the local origin.
104
+ * @zh 返回局部变换原点的独立副本。
105
+ * @ja ローカル座標の原点の独立したコピーを返します。
106
+ * @ko 로컬 원점의 독립적인 복사본을 반환합니다.
107
+ */
108
+ getOrigin(): Vector2f;
109
+ /**
110
+ * Return the read-only cached local-to-parent transform.
111
+ * Later reads may update the same object.
112
+ * @zh 返回从局部到父坐标系的只读变换缓存;后续读取可更新同一对象。
113
+ * @ja ローカルから親座標系への読み取り専用の変換キャッシュを返します。
114
+ * 後続の読み取りで同じオブジェクトが更新される場合があります。
115
+ * @ko 로컬에서 부모 좌표계로의 읽기 전용 변환 캐시를 반환합니다.
116
+ * 이후 읽기에서 동일한 객체가 갱신될 수 있습니다.
117
+ */
118
+ getTransform(): R<Transform>;
119
+ /**
120
+ * Return the read-only cached parent-to-local inverse transform,
121
+ * or the identity matrix when not invertible.
122
+ * @zh 返回从父坐标系到局部的只读逆变换缓存;不可逆时为单位矩阵。
123
+ * @ja 親座標系からローカルへの読み取り専用の逆変換キャッシュを返します。
124
+ * 逆変換できない場合は単位行列になります。
125
+ * @ko 부모 좌표계에서 로컬로의 읽기 전용 역변환 캐시를 반환합니다.
126
+ * 역변환이 불가능하면 단위 행렬을 반환합니다.
127
+ */
128
+ getInverseTransform(): R<Transform>;
129
+ }
130
+
131
+ function vectorData(value: R<Vector2f>): Float32Array {
132
+ if (!(value instanceof Vector2) || value.scalarType !== 'f32') {
133
+ throw new TypeError('Transformable requires a Vector2f');
134
+ }
135
+ return value[vector2Storage] as Float32Array;
136
+ }
137
+
138
+ function angleData(value: R<Angle>): number {
139
+ if (!(value instanceof Angle)) throw new TypeError('Expected an Angle');
140
+ return value.asRadians();
141
+ }
142
+
143
+ function vectorCopy(data: Float32Array, offset: number): Vector2f {
144
+ const result = new Vector2f();
145
+ result[vector2Storage].set(data.subarray(offset, offset + 2));
146
+ return result;
147
+ }
148
+
149
+ // Inspect the seven staged values on reads, including changes made by C++.
150
+ // Setters only write data; they never allocate or compute a transform.
151
+ function transformCache(state: TransformableState): TransformCache {
152
+ const data = state.values;
153
+ let cache = state.cache;
154
+ if (cache && data.every((value, i) => Object.is(value, cache!.input[i]))) {
155
+ return cache;
156
+ }
157
+ if (!cache) {
158
+ cache = state.cache = {
159
+ input: new Float32Array(7),
160
+ transform: Object.freeze(new Transform()), inverseDirty: true,
161
+ };
162
+ }
163
+ const cos = f(Math.cos(-data[2]));
164
+ const sin = f(Math.sin(-data[2]));
165
+ const sxc = f(data[3] * cos);
166
+ const syc = f(data[4] * cos);
167
+ const sxs = f(data[3] * sin);
168
+ const sys = f(data[4] * sin);
169
+ const matrix = cache.transform[transformStorage];
170
+ matrix[0] = sxc;
171
+ matrix[4] = sys;
172
+ matrix[12] = f(f(f(-data[5] * sxc) - f(data[6] * sys)) + data[0]);
173
+ matrix[1] = -sxs;
174
+ matrix[5] = syc;
175
+ matrix[13] = f(f(f(data[5] * sxs) - f(data[6] * syc)) + data[1]);
176
+ cache.input.set(data);
177
+ cache.inverseDirty = true;
178
+ return cache;
179
+ }
180
+
181
+ // TypeScript mixin constructors require a single any[] rest parameter.
182
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
183
+ type Constructor<T> = new (...args: any[]) => T;
184
+
185
+ /** Add the same API to independently allocated native resource wrappers. */
186
+ export function withTransformable<T extends Constructor<TransformableHost>>(
187
+ Base: T,
188
+ ): T & Constructor<TransformableMethods> {
189
+ return class extends Base implements TransformableMethods {
190
+ setPosition(this: TransformableHost, position: R<Vector2f>): void {
191
+ this[transformableState].values.set(vectorData(position), 0);
192
+ }
193
+
194
+ getPosition(): Vector2f {
195
+ return vectorCopy(this[transformableState].values, 0);
196
+ }
197
+
198
+ move(this: TransformableHost, offset: R<Vector2f>): void {
199
+ const input = vectorData(offset);
200
+ const data = this[transformableState].values;
201
+ data[0] += input[0];
202
+ data[1] += input[1];
203
+ }
204
+
205
+ setRotation(this: TransformableHost, angle: R<Angle>): void {
206
+ this[transformableState].values[2] =
207
+ positiveRemainder(angleData(angle), tau);
208
+ }
209
+
210
+ getRotation(): Angle {
211
+ return radians(this[transformableState].values[2]);
212
+ }
213
+
214
+ rotate(this: TransformableHost, angle: R<Angle>): void {
215
+ const data = this[transformableState].values;
216
+ data[2] = positiveRemainder(f(data[2] + angleData(angle)), tau);
217
+ }
218
+
219
+ setScale(this: TransformableHost, factors: R<Vector2f>): void {
220
+ this[transformableState].values.set(vectorData(factors), 3);
221
+ }
222
+
223
+ getScale(): Vector2f {
224
+ return vectorCopy(this[transformableState].values, 3);
225
+ }
226
+
227
+ scale(this: TransformableHost, factors: R<Vector2f>): void {
228
+ const input = vectorData(factors);
229
+ const data = this[transformableState].values;
230
+ data[3] *= input[0];
231
+ data[4] *= input[1];
232
+ }
233
+
234
+ setOrigin(this: TransformableHost, origin: R<Vector2f>): void {
235
+ this[transformableState].values.set(vectorData(origin), 5);
236
+ }
237
+
238
+ getOrigin(): Vector2f {
239
+ return vectorCopy(this[transformableState].values, 5);
240
+ }
241
+
242
+ getTransform(): R<Transform> {
243
+ return transformCache(this[transformableState]).transform;
244
+ }
245
+
246
+ getInverseTransform(): R<Transform> {
247
+ const cache = transformCache(this[transformableState]);
248
+ if (cache.inverseDirty) {
249
+ const inverse = cache.transform.getInverse();
250
+ if (cache.inverse) {
251
+ cache.inverse[transformStorage].set(inverse[transformStorage]);
252
+ } else {
253
+ cache.inverse = Object.freeze(inverse);
254
+ }
255
+ cache.inverseDirty = false;
256
+ }
257
+ return cache.inverse!;
258
+ }
259
+ };
260
+ }
@@ -0,0 +1,40 @@
1
+ export const angleStorage: unique symbol = Symbol('Angle.storage');
2
+ export const angleNative: unique symbol = Symbol('Angle.native');
3
+ export const timeStorage: unique symbol = Symbol('Time.microseconds');
4
+ export const vector2Storage: unique symbol = Symbol('Vector2.storage');
5
+ export const vector2Native: unique symbol = Symbol('Vector2.native');
6
+ export const vector3Storage: unique symbol = Symbol('Vector3.storage');
7
+ export const vector3Native: unique symbol = Symbol('Vector3.native');
8
+ export const colorStorage: unique symbol = Symbol('Color.storage');
9
+ export const colorNative: unique symbol = Symbol('Color.native');
10
+ export const rectStorage: unique symbol = Symbol('Rect.storage');
11
+ export const rectNative: unique symbol = Symbol('Rect.native');
12
+ export const vertexStorage: unique symbol = Symbol('Vertex.storage');
13
+ export const vertexNative: unique symbol = Symbol('Vertex.native');
14
+ export const glyphStorage: unique symbol = Symbol('Glyph.storage');
15
+ export const glyphNative: unique symbol = Symbol('Glyph.native');
16
+ export const transformStorage: unique symbol = Symbol('Transform.storage');
17
+ export const transformNative: unique symbol = Symbol('Transform.native');
18
+ export const mutableValue: unique symbol = Symbol('Value.mutable');
19
+
20
+ // Only expose reads and independent copies, never aliases or mutable callbacks.
21
+ type ReadonlyFloatArray = Readonly<Pick<Float32Array,
22
+ number | 'length' | 'byteLength' | 'byteOffset' | typeof Symbol.iterator |
23
+ 'slice' | 'entries' | 'keys' | 'values'>>;
24
+
25
+ /**
26
+ * Const data members recurse; methods still return independent mutable values.
27
+ * @zh 数据成员递归只读;方法仍可返回独立的可变值。
28
+ * @ja データメンバーは再帰的に読み取り専用になります。
29
+ * メソッドは引き続き独立した変更可能な値を返せます。
30
+ * @ko 데이터 멤버는 재귀적으로 읽기 전용이 됩니다.
31
+ * 메서드는 여전히 독립적인 변경 가능 값을 반환할 수 있습니다.
32
+ */
33
+ export type ReadonlyValue<T> = {
34
+ readonly [K in keyof T as K extends typeof mutableValue ? never : K]:
35
+ // Keep generic scalar coordinates verbatim; only the property becomes const.
36
+ K extends symbol | 'scalarType' | 'x' | 'y' | 'z' | 'w' ? T[K]
37
+ : T[K] extends Float32Array ? ReadonlyFloatArray
38
+ : T[K] extends { readonly [mutableValue]: true }
39
+ ? ReadonlyValue<T[K]> : T[K];
40
+ };
@@ -0,0 +1,58 @@
1
+ import { EventEmitter } from 'node:events';
2
+ import { Time } from '../system/time';
3
+ import type { ReadonlyValue } from '../internal/value-storage';
4
+
5
+ export type NetworkTime = ReadonlyValue<Time>;
6
+ export function millisecondsOf(time: NetworkTime): number {
7
+ if (!(time instanceof Time)) throw new TypeError('Expected a Time');
8
+ const value = time.asMicroseconds();
9
+ if (value < 0n) throw new RangeError('Timeout must be non-negative');
10
+ return value === 0n ? 0 : Math.max(1, Number(value / 1000n));
11
+ }
12
+ export function uint(value: number, max = 0xffffffff): number {
13
+ if (!Number.isInteger(value) || value < 0 || value > max) {
14
+ throw new RangeError(`Expected an integer from 0 to ${max}`);
15
+ }
16
+ return value;
17
+ }
18
+ export function bytes(value: Uint8Array): Buffer {
19
+ if (!(value instanceof Uint8Array)) throw new TypeError('Expected bytes');
20
+ return Buffer.from(value.buffer, value.byteOffset, value.byteLength);
21
+ }
22
+ export class SerialQueue {
23
+ /** 当前队列末尾的 Promise,用于链式排期。 */
24
+ private tail = Promise.resolve();
25
+ run<T>(action: () => Promise<T>): Promise<T> {
26
+ const next = this.tail.then(action);
27
+ this.tail = next.then(() => {}, () => {});
28
+ return next;
29
+ }
30
+ }
31
+ /**
32
+ * Register before checking state so no event can be lost between both steps.
33
+ * @zh 先注册再检查状态,以免在两个步骤之间丢失事件。
34
+ * @ja 状態確認の前に登録し、両手順の間でイベントが失われないようにします。
35
+ * @ko 두 단계 사이에 이벤트가 유실되지 않도록 상태 확인 전에 등록합니다.
36
+ */
37
+ export function waitFor(events: EventEmitter, check: () => boolean,
38
+ timeout = 0, signal?: AbortSignal): Promise<boolean> {
39
+ return new Promise((resolve, reject) => {
40
+ let timer: NodeJS.Timeout | undefined;
41
+ function finish(value: boolean, error?: unknown) {
42
+ events.off('change', inspect);
43
+ signal?.removeEventListener('abort', abort);
44
+ if (timer) clearTimeout(timer);
45
+ if (error) reject(error);
46
+ else resolve(value);
47
+ }
48
+ function inspect() {
49
+ try { if (check()) finish(true); } catch (error) { finish(false, error); }
50
+ }
51
+ function abort() { finish(false); }
52
+ events.on('change', inspect);
53
+ signal?.addEventListener('abort', abort, { once: true });
54
+ if (timeout) timer = setTimeout(() => finish(false), timeout);
55
+ if (signal?.aborted) abort();
56
+ else inspect();
57
+ });
58
+ }