sfml.js 0.0.1 → 1.0.0-rc.1

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 (696) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +24 -16
  3. package/binding.gyp +95 -183
  4. package/dist/audio/effect-processor.d.ts +22 -0
  5. package/dist/audio/effect-processor.js +28 -0
  6. package/dist/audio/input-sound-file.d.ts +52 -0
  7. package/dist/audio/input-sound-file.js +167 -0
  8. package/dist/audio/listener.d.ts +28 -0
  9. package/dist/audio/listener.js +86 -0
  10. package/dist/audio/music.d.ts +60 -0
  11. package/dist/audio/music.js +192 -0
  12. package/dist/audio/output-sound-file.d.ts +15 -0
  13. package/dist/audio/output-sound-file.js +70 -0
  14. package/dist/audio/playback-device.d.ts +35 -0
  15. package/dist/audio/playback-device.js +71 -0
  16. package/dist/audio/sound-buffer-recorder.d.ts +34 -0
  17. package/dist/audio/sound-buffer-recorder.js +62 -0
  18. package/dist/audio/sound-buffer.d.ts +45 -0
  19. package/dist/audio/sound-buffer.js +152 -0
  20. package/dist/audio/sound-file-factory.d.ts +27 -0
  21. package/dist/audio/sound-file-factory.js +152 -0
  22. package/dist/audio/sound-file-reader.d.ts +60 -0
  23. package/dist/audio/sound-file-reader.js +61 -0
  24. package/dist/audio/sound-file-writer.d.ts +17 -0
  25. package/dist/audio/sound-file-writer.js +9 -0
  26. package/dist/audio/sound-recorder.d.ts +60 -0
  27. package/dist/audio/sound-recorder.js +162 -0
  28. package/dist/audio/sound-source.d.ts +108 -0
  29. package/dist/audio/sound-source.js +161 -0
  30. package/dist/audio/sound-stream.d.ts +28 -0
  31. package/dist/audio/sound-stream.js +47 -0
  32. package/dist/audio/sound.d.ts +14 -0
  33. package/dist/audio/sound.js +39 -0
  34. package/dist/audio/value.d.ts +116 -0
  35. package/dist/audio/value.js +157 -0
  36. package/dist/audio/worker.d.ts +88 -0
  37. package/dist/audio/worker.js +2 -0
  38. package/dist/graphics/blend-mode.d.ts +82 -0
  39. package/dist/graphics/blend-mode.js +98 -0
  40. package/dist/graphics/boolean-vector.d.ts +48 -0
  41. package/dist/graphics/boolean-vector.js +116 -0
  42. package/dist/graphics/circle-shape.d.ts +27 -0
  43. package/dist/graphics/circle-shape.js +41 -0
  44. package/dist/graphics/color.d.ts +93 -0
  45. package/dist/graphics/color.js +146 -0
  46. package/dist/graphics/convex-shape.d.ts +18 -0
  47. package/dist/graphics/convex-shape.js +33 -0
  48. package/dist/graphics/drawable.d.ts +9 -0
  49. package/dist/graphics/drawable.js +15 -0
  50. package/dist/graphics/font.d.ts +70 -0
  51. package/dist/graphics/font.js +221 -0
  52. package/dist/graphics/glsl-matrix.d.ts +25 -0
  53. package/dist/graphics/glsl-matrix.js +69 -0
  54. package/dist/graphics/glsl.d.ts +57 -0
  55. package/dist/graphics/glsl.js +112 -0
  56. package/dist/graphics/glyph.d.ts +44 -0
  57. package/dist/graphics/glyph.js +74 -0
  58. package/dist/graphics/image.d.ts +57 -0
  59. package/dist/graphics/image.js +181 -0
  60. package/dist/graphics/primitive-type.d.ts +16 -0
  61. package/dist/graphics/primitive-type.js +25 -0
  62. package/dist/graphics/rect.d.ts +67 -0
  63. package/dist/graphics/rect.js +164 -0
  64. package/dist/graphics/rectangle-shape.d.ts +18 -0
  65. package/dist/graphics/rectangle-shape.js +34 -0
  66. package/dist/graphics/render-states.d.ts +60 -0
  67. package/dist/graphics/render-states.js +74 -0
  68. package/dist/graphics/render-target.d.ts +99 -0
  69. package/dist/graphics/render-target.js +341 -0
  70. package/dist/graphics/render-texture.d.ts +46 -0
  71. package/dist/graphics/render-texture.js +120 -0
  72. package/dist/graphics/render-window.d.ts +49 -0
  73. package/dist/graphics/render-window.js +106 -0
  74. package/dist/graphics/shader.d.ts +63 -0
  75. package/dist/graphics/shader.js +215 -0
  76. package/dist/graphics/shape.d.ts +77 -0
  77. package/dist/graphics/shape.js +180 -0
  78. package/dist/graphics/sprite.d.ts +44 -0
  79. package/dist/graphics/sprite.js +116 -0
  80. package/dist/graphics/stencil-mode.d.ts +69 -0
  81. package/dist/graphics/stencil-mode.js +72 -0
  82. package/dist/graphics/swap.d.ts +6 -0
  83. package/dist/graphics/swap.js +16 -0
  84. package/dist/graphics/text.d.ts +238 -0
  85. package/dist/graphics/text.js +354 -0
  86. package/dist/graphics/texture.d.ts +78 -0
  87. package/dist/graphics/texture.js +274 -0
  88. package/dist/graphics/transform.d.ts +50 -0
  89. package/dist/graphics/transform.js +195 -0
  90. package/dist/graphics/transformable.d.ts +13 -0
  91. package/dist/graphics/transformable.js +27 -0
  92. package/dist/graphics/vertex-array.d.ts +54 -0
  93. package/dist/graphics/vertex-array.js +176 -0
  94. package/dist/graphics/vertex-buffer.d.ts +69 -0
  95. package/dist/graphics/vertex-buffer.js +167 -0
  96. package/dist/graphics/vertex.d.ts +42 -0
  97. package/dist/graphics/vertex.js +98 -0
  98. package/dist/graphics/view.d.ts +54 -0
  99. package/dist/graphics/view.js +209 -0
  100. package/dist/index.d.ts +116 -0
  101. package/dist/index.js +251 -0
  102. package/dist/internal/audio-codec-registry.d.ts +13 -0
  103. package/dist/internal/audio-codec-registry.js +64 -0
  104. package/dist/internal/audio-input-stream.d.ts +13 -0
  105. package/dist/internal/audio-input-stream.js +44 -0
  106. package/dist/internal/audio-music-pump.d.ts +63 -0
  107. package/dist/internal/audio-music-pump.js +193 -0
  108. package/dist/internal/audio-native.d.ts +145 -0
  109. package/dist/internal/audio-native.js +24 -0
  110. package/dist/internal/audio-recorder-session.d.ts +77 -0
  111. package/dist/internal/audio-recorder-session.js +182 -0
  112. package/dist/internal/audio-worker-session.d.ts +18 -0
  113. package/dist/internal/audio-worker-session.js +82 -0
  114. package/dist/internal/audio-worker.d.ts +1 -0
  115. package/dist/internal/audio-worker.js +134 -0
  116. package/dist/internal/glsl-value.d.ts +26 -0
  117. package/dist/internal/glsl-value.js +44 -0
  118. package/dist/internal/graphics-state.d.ts +45 -0
  119. package/dist/internal/graphics-state.js +123 -0
  120. package/dist/internal/input-stream.d.ts +4 -0
  121. package/dist/internal/input-stream.js +25 -0
  122. package/dist/internal/lazy-value.d.ts +17 -0
  123. package/dist/internal/lazy-value.js +43 -0
  124. package/dist/internal/native.d.ts +317 -0
  125. package/dist/internal/native.js +8 -0
  126. package/dist/internal/numeric-properties.d.ts +2 -0
  127. package/dist/internal/numeric-properties.js +39 -0
  128. package/dist/internal/render-states.d.ts +4 -0
  129. package/dist/internal/render-states.js +44 -0
  130. package/dist/internal/scalar.d.ts +44 -0
  131. package/dist/internal/scalar.js +95 -0
  132. package/dist/internal/shaped-glyph.d.ts +32 -0
  133. package/dist/internal/shaped-glyph.js +51 -0
  134. package/dist/internal/struct-view.d.ts +11 -0
  135. package/dist/internal/struct-view.js +39 -0
  136. package/dist/internal/text-indices.d.ts +7 -0
  137. package/dist/internal/text-indices.js +22 -0
  138. package/dist/internal/transformable.d.ts +53 -0
  139. package/dist/internal/transformable.js +121 -0
  140. package/dist/internal/value-storage.d.ts +26 -0
  141. package/dist/internal/value-storage.js +21 -0
  142. package/dist/network/common.d.ts +18 -0
  143. package/dist/network/common.js +73 -0
  144. package/dist/network/dns.d.ts +35 -0
  145. package/dist/network/dns.js +93 -0
  146. package/dist/network/ftp.d.ts +81 -0
  147. package/dist/network/ftp.js +233 -0
  148. package/dist/network/gen/constants.d.ts +252 -0
  149. package/dist/network/gen/constants.js +260 -0
  150. package/dist/network/http.d.ts +150 -0
  151. package/dist/network/http.js +424 -0
  152. package/dist/network/ip-address.d.ts +57 -0
  153. package/dist/network/ip-address.js +161 -0
  154. package/dist/network/packet.d.ts +78 -0
  155. package/dist/network/packet.js +238 -0
  156. package/dist/network/sftp.d.ts +220 -0
  157. package/dist/network/sftp.js +557 -0
  158. package/dist/network/socket-selector.d.ts +38 -0
  159. package/dist/network/socket-selector.js +125 -0
  160. package/dist/network/socket.d.ts +89 -0
  161. package/dist/network/socket.js +225 -0
  162. package/dist/network/tcp-listener.d.ts +36 -0
  163. package/dist/network/tcp-listener.js +126 -0
  164. package/dist/network/tcp-socket.d.ts +108 -0
  165. package/dist/network/tcp-socket.js +362 -0
  166. package/dist/network/tls-material.d.ts +6 -0
  167. package/dist/network/tls-material.js +36 -0
  168. package/dist/network/udp-socket.d.ts +60 -0
  169. package/dist/network/udp-socket.js +197 -0
  170. package/dist/system/angle.d.ts +27 -0
  171. package/dist/system/angle.js +72 -0
  172. package/dist/system/clock.d.ts +22 -0
  173. package/dist/system/clock.js +56 -0
  174. package/dist/system/err.d.ts +6 -0
  175. package/dist/system/err.js +49 -0
  176. package/dist/system/error.d.ts +5 -0
  177. package/dist/system/error.js +12 -0
  178. package/dist/system/file-input-stream.d.ts +21 -0
  179. package/dist/system/file-input-stream.js +101 -0
  180. package/dist/system/input-stream.d.ts +30 -0
  181. package/dist/system/input-stream.js +54 -0
  182. package/dist/system/operators.d.ts +164 -0
  183. package/dist/system/operators.js +402 -0
  184. package/dist/system/sleep.d.ts +4 -0
  185. package/dist/system/sleep.js +23 -0
  186. package/dist/system/suspend-aware-clock.d.ts +7 -0
  187. package/dist/system/suspend-aware-clock.js +14 -0
  188. package/dist/system/time.d.ts +31 -0
  189. package/dist/system/time.js +134 -0
  190. package/dist/system/timeout-with-predicate.d.ts +19 -0
  191. package/dist/system/timeout-with-predicate.js +35 -0
  192. package/dist/system/unicode.d.ts +18 -0
  193. package/dist/system/unicode.js +31 -0
  194. package/dist/system/vector2.d.ts +98 -0
  195. package/dist/system/vector2.js +225 -0
  196. package/dist/system/vector3.d.ts +83 -0
  197. package/dist/system/vector3.js +178 -0
  198. package/dist/system/version.d.ts +15 -0
  199. package/dist/system/version.js +18 -0
  200. package/dist/window/clipboard.d.ts +4 -0
  201. package/dist/window/clipboard.js +16 -0
  202. package/dist/window/context-settings.d.ts +29 -0
  203. package/dist/window/context-settings.js +59 -0
  204. package/dist/window/context.d.ts +27 -0
  205. package/dist/window/context.js +77 -0
  206. package/dist/window/cursor.d.ts +20 -0
  207. package/dist/window/cursor.js +56 -0
  208. package/dist/window/event.d.ts +176 -0
  209. package/dist/window/event.js +57 -0
  210. package/dist/window/gen/constants.d.ts +637 -0
  211. package/dist/window/gen/constants.js +651 -0
  212. package/dist/window/joystick.d.ts +25 -0
  213. package/dist/window/joystick.js +44 -0
  214. package/dist/window/keyboard.d.ts +14 -0
  215. package/dist/window/keyboard.js +37 -0
  216. package/dist/window/mouse.d.ts +10 -0
  217. package/dist/window/mouse.js +36 -0
  218. package/dist/window/sensor.d.ts +9 -0
  219. package/dist/window/sensor.js +23 -0
  220. package/dist/window/touch.d.ts +12 -0
  221. package/dist/window/touch.js +29 -0
  222. package/dist/window/video-mode.d.ts +26 -0
  223. package/dist/window/video-mode.js +69 -0
  224. package/dist/window/vulkan.d.ts +9 -0
  225. package/dist/window/vulkan.js +22 -0
  226. package/dist/window/window.d.ts +103 -0
  227. package/dist/window/window.js +227 -0
  228. package/docs/api.md +1113 -0
  229. package/docs/audio.md +212 -0
  230. package/docs/development.md +77 -0
  231. package/docs/network.md +169 -0
  232. package/native/addon.cc +129 -0
  233. package/native/audio-binding.cc +543 -0
  234. package/native/audio-codec-binding.cc +246 -0
  235. package/native/audio-device-binding.cc +160 -0
  236. package/native/audio-file-binding.cc +192 -0
  237. package/native/audio-recorder-binding.cc +237 -0
  238. package/native/audio-recorder.h +39 -0
  239. package/native/audio-state.h +220 -0
  240. package/native/audio-stream-binding.cc +284 -0
  241. package/native/audio-stream.h +28 -0
  242. package/native/audio-worker-binding.cc +447 -0
  243. package/native/audio-worker.h +121 -0
  244. package/native/batch-drawable.cc +189 -0
  245. package/native/batch-drawable.h +57 -0
  246. package/native/context-binding.cc +180 -0
  247. package/native/context-settings.h +74 -0
  248. package/native/deferred-delete.cc +49 -0
  249. package/native/deferred-delete.h +84 -0
  250. package/native/error-stream-binding.cc +270 -0
  251. package/native/exception-boundary.h +97 -0
  252. package/native/font-binding.cc +210 -0
  253. package/native/font-state.h +27 -0
  254. package/native/graphics-binding.cc +338 -0
  255. package/native/graphics-state.h +253 -0
  256. package/native/image-binding.cc +258 -0
  257. package/native/image-state.h +93 -0
  258. package/native/input-binding.cc +246 -0
  259. package/native/numeric-fields.h +96 -0
  260. package/native/render-window-binding.cc +103 -0
  261. package/native/render-window-state.h +22 -0
  262. package/native/shader-binding.cc +292 -0
  263. package/native/shape-binding.cc +283 -0
  264. package/native/shape-state.h +68 -0
  265. package/native/shaped-glyph-storage.h +45 -0
  266. package/native/shared-handle.h +69 -0
  267. package/native/stream-binding.cc +286 -0
  268. package/native/system-binding.cc +91 -0
  269. package/native/text-binding.cc +205 -0
  270. package/native/text-state.h +101 -0
  271. package/native/texture-binding.cc +330 -0
  272. package/native/texture-resource.h +52 -0
  273. package/native/time-value.h +28 -0
  274. package/native/transformable-binding.cc +23 -0
  275. package/native/transformable-state.h +44 -0
  276. package/native/value-binding.h +200 -0
  277. package/native/value-layout.h +116 -0
  278. package/native/values-binding.cc +27 -0
  279. package/native/vertex-binding.cc +50 -0
  280. package/native/vertex-buffer-binding.cc +232 -0
  281. package/native/vertex-storage.h +20 -0
  282. package/native/view-data.h +24 -0
  283. package/native/window-binding.cc +388 -0
  284. package/native/window-event.h +92 -0
  285. package/native/window-owner.h +81 -0
  286. package/package.json +77 -35
  287. package/src/audio/effect-processor.ts +41 -0
  288. package/src/audio/input-sound-file.ts +173 -0
  289. package/src/audio/listener.ts +74 -0
  290. package/src/audio/music.ts +191 -0
  291. package/src/audio/output-sound-file.ts +64 -0
  292. package/src/audio/playback-device.ts +59 -0
  293. package/src/audio/sound-buffer-recorder.ts +61 -0
  294. package/src/audio/sound-buffer.ts +170 -0
  295. package/src/audio/sound-file-factory.ts +162 -0
  296. package/src/audio/sound-file-reader.ts +93 -0
  297. package/src/audio/sound-file-writer.ts +19 -0
  298. package/src/audio/sound-recorder.ts +180 -0
  299. package/src/audio/sound-source.ts +168 -0
  300. package/src/audio/sound-stream.ts +60 -0
  301. package/src/audio/sound.ts +36 -0
  302. package/src/audio/value.ts +165 -0
  303. package/src/audio/worker.ts +90 -0
  304. package/src/graphics/blend-mode.ts +125 -0
  305. package/src/graphics/boolean-vector.ts +139 -0
  306. package/src/graphics/circle-shape.ts +56 -0
  307. package/src/graphics/color.ts +189 -0
  308. package/src/graphics/convex-shape.ts +38 -0
  309. package/src/graphics/drawable.ts +19 -0
  310. package/src/graphics/font.ts +248 -0
  311. package/src/graphics/glsl-matrix.ts +73 -0
  312. package/src/graphics/glsl.ts +121 -0
  313. package/src/graphics/glyph.ts +97 -0
  314. package/src/graphics/image.ts +231 -0
  315. package/src/graphics/primitive-type.ts +21 -0
  316. package/src/graphics/rect.ts +214 -0
  317. package/src/graphics/rectangle-shape.ts +39 -0
  318. package/src/graphics/render-states.ts +110 -0
  319. package/src/graphics/render-target.ts +431 -0
  320. package/src/graphics/render-texture.ts +150 -0
  321. package/src/graphics/render-window.ts +155 -0
  322. package/src/graphics/shader.ts +224 -0
  323. package/src/graphics/shape.ts +231 -0
  324. package/src/graphics/sprite.ts +143 -0
  325. package/src/graphics/stencil-mode.ts +97 -0
  326. package/src/graphics/swap.ts +17 -0
  327. package/src/graphics/text.ts +423 -0
  328. package/src/graphics/texture.ts +352 -0
  329. package/src/graphics/transform.ts +242 -0
  330. package/src/graphics/transformable.ts +26 -0
  331. package/src/graphics/vertex-array.ts +201 -0
  332. package/src/graphics/vertex-buffer.ts +209 -0
  333. package/src/graphics/vertex.ts +142 -0
  334. package/src/graphics/view.ts +237 -0
  335. package/src/index.ts +147 -0
  336. package/src/internal/audio-codec-registry.ts +68 -0
  337. package/src/internal/audio-input-stream.ts +42 -0
  338. package/src/internal/audio-music-pump.ts +199 -0
  339. package/src/internal/audio-native.ts +176 -0
  340. package/src/internal/audio-recorder-session.ts +234 -0
  341. package/src/internal/audio-worker-session.ts +89 -0
  342. package/src/internal/audio-worker.ts +146 -0
  343. package/src/internal/glsl-value.ts +54 -0
  344. package/src/internal/graphics-state.ts +131 -0
  345. package/src/internal/input-stream.ts +30 -0
  346. package/src/internal/lazy-value.ts +62 -0
  347. package/src/internal/native.ts +581 -0
  348. package/src/internal/numeric-properties.ts +37 -0
  349. package/src/internal/render-states.ts +42 -0
  350. package/src/internal/scalar.ts +109 -0
  351. package/src/internal/shaped-glyph.ts +68 -0
  352. package/src/internal/struct-view.ts +49 -0
  353. package/src/internal/text-indices.ts +19 -0
  354. package/src/internal/transformable.ts +189 -0
  355. package/src/internal/value-storage.ts +33 -0
  356. package/src/network/common.ts +53 -0
  357. package/src/network/dns.ts +102 -0
  358. package/src/network/ftp.ts +202 -0
  359. package/src/network/gen/constants.ts +253 -0
  360. package/src/network/http.ts +372 -0
  361. package/src/network/ip-address.ts +158 -0
  362. package/src/network/packet.ts +217 -0
  363. package/src/network/sftp.ts +574 -0
  364. package/src/network/socket-selector.ts +112 -0
  365. package/src/network/socket.ts +203 -0
  366. package/src/network/tcp-listener.ts +115 -0
  367. package/src/network/tcp-socket.ts +370 -0
  368. package/src/network/tls-material.ts +30 -0
  369. package/src/network/udp-socket.ts +176 -0
  370. package/src/system/angle.ts +82 -0
  371. package/src/system/clock.ts +61 -0
  372. package/src/system/err.ts +46 -0
  373. package/src/system/error.ts +8 -0
  374. package/src/system/file-input-stream.ts +100 -0
  375. package/src/system/input-stream.ts +66 -0
  376. package/src/system/operators.ts +554 -0
  377. package/src/system/sleep.ts +20 -0
  378. package/src/system/suspend-aware-clock.ts +12 -0
  379. package/src/system/time.ts +149 -0
  380. package/src/system/timeout-with-predicate.ts +53 -0
  381. package/src/system/unicode.ts +28 -0
  382. package/src/system/vector2.ts +345 -0
  383. package/src/system/vector3.ts +267 -0
  384. package/src/system/version.ts +30 -0
  385. package/src/window/clipboard.ts +12 -0
  386. package/src/window/context-settings.ts +78 -0
  387. package/src/window/context.ts +92 -0
  388. package/src/window/cursor.ts +78 -0
  389. package/src/window/event.ts +227 -0
  390. package/src/window/gen/constants.ts +655 -0
  391. package/src/window/joystick.ts +52 -0
  392. package/src/window/keyboard.ts +42 -0
  393. package/src/window/mouse.ts +37 -0
  394. package/src/window/sensor.ts +20 -0
  395. package/src/window/touch.ts +27 -0
  396. package/src/window/video-mode.ts +85 -0
  397. package/src/window/vulkan.ts +19 -0
  398. package/src/window/window.ts +311 -0
  399. package/test/native/audio-probes.cc +181 -0
  400. package/test/native/deferred-delete-probes.cc +62 -0
  401. package/test/native/drawable-probes.cc +168 -0
  402. package/test/native/exception-probes.cc +83 -0
  403. package/test/native/image-probes.cc +105 -0
  404. package/test/native/matrix-probes.cc +67 -0
  405. package/test/native/network-oracle.cc +32 -0
  406. package/test/native/render-texture-probes.cc +193 -0
  407. package/test/native/shader-probes.cc +69 -0
  408. package/test/native/shape-probes.cc +160 -0
  409. package/test/native/sprite-probes.cc +146 -0
  410. package/test/native/system-probes.cc +109 -0
  411. package/test/native/text-probes.cc +211 -0
  412. package/test/native/texture-probes.cc +200 -0
  413. package/test/native/time-probes.cc +143 -0
  414. package/test/native/transform-probes.cc +92 -0
  415. package/test/native/transformable-probes.cc +152 -0
  416. package/test/native/value-oracle.h +88 -0
  417. package/test/native/value-probes.cc +379 -0
  418. package/test/native/vertex-array-probes.cc +82 -0
  419. package/test/native/vertex-buffer-probes.cc +87 -0
  420. package/test/native/view-probes.cc +150 -0
  421. package/test/native/window-probes.cc +172 -0
  422. package/test/tsconfig.json +8 -0
  423. package/tools/configure-lsp.cjs +23 -0
  424. package/tools/generate-network-constants.cjs +47 -0
  425. package/tools/generate-window-constants.cjs +164 -0
  426. package/tools/lib_downloader.cjs +92 -0
  427. package/tools/lib_downloader_urls.cjs +23 -0
  428. package/tsconfig.json +11 -4
  429. package/index.d.ts +0 -1
  430. package/lib/clock.d.ts +0 -8
  431. package/lib/clock.js +0 -5
  432. package/lib/color.d.ts +0 -11
  433. package/lib/color.js +0 -98
  434. package/lib/common.js +0 -47
  435. package/lib/drawable/circle_shape.d.ts +0 -5
  436. package/lib/drawable/circle_shape.js +0 -26
  437. package/lib/drawable/convex_shape.d.ts +0 -5
  438. package/lib/drawable/convex_shape.js +0 -35
  439. package/lib/drawable/drawable.d.ts +0 -6
  440. package/lib/drawable/drawable.js +0 -18
  441. package/lib/drawable/plugin_package.d.ts +0 -31
  442. package/lib/drawable/plugin_package.js +0 -102
  443. package/lib/drawable/rectangle_shape.d.ts +0 -9
  444. package/lib/drawable/rectangle_shape.js +0 -28
  445. package/lib/drawable/shape.d.ts +0 -14
  446. package/lib/drawable/shape.js +0 -30
  447. package/lib/drawable/sprite.d.ts +0 -17
  448. package/lib/drawable/sprite.js +0 -53
  449. package/lib/drawable/text.d.ts +0 -26
  450. package/lib/drawable/text.js +0 -88
  451. package/lib/drawable/transformable.d.ts +0 -28
  452. package/lib/drawable/transformable.js +0 -113
  453. package/lib/drawable/vertex_array.d.ts +0 -40
  454. package/lib/drawable/vertex_array.js +0 -128
  455. package/lib/font.d.ts +0 -24
  456. package/lib/font.js +0 -137
  457. package/lib/image.d.ts +0 -26
  458. package/lib/image.js +0 -147
  459. package/lib/joystick.d.ts +0 -21
  460. package/lib/joystick.js +0 -72
  461. package/lib/keyboard.d.ts +0 -113
  462. package/lib/keyboard.js +0 -17
  463. package/lib/mouse.d.ts +0 -6
  464. package/lib/mouse.js +0 -39
  465. package/lib/poll_event.d.ts +0 -138
  466. package/lib/rect.d.ts +0 -18
  467. package/lib/rect.js +0 -119
  468. package/lib/render_window.d.ts +0 -67
  469. package/lib/render_window.js +0 -197
  470. package/lib/sensor.d.ts +0 -12
  471. package/lib/sensor.js +0 -34
  472. package/lib/sfml.d.ts +0 -32
  473. package/lib/sfml.js +0 -36
  474. package/lib/sound/base.d.ts +0 -33
  475. package/lib/sound/base.js +0 -109
  476. package/lib/sound/music.d.ts +0 -15
  477. package/lib/sound/music.js +0 -65
  478. package/lib/sound/sound.d.ts +0 -16
  479. package/lib/sound/sound.js +0 -55
  480. package/lib/sound/sound_buffer.d.ts +0 -14
  481. package/lib/sound/sound_buffer.js +0 -78
  482. package/lib/texture.d.ts +0 -21
  483. package/lib/texture.js +0 -127
  484. package/lib/time.d.ts +0 -13
  485. package/lib/time.js +0 -41
  486. package/lib/touch.d.ts +0 -7
  487. package/lib/touch.js +0 -34
  488. package/lib/vector2.d.ts +0 -49
  489. package/lib/vector2.js +0 -141
  490. package/lib/vector3.d.ts +0 -47
  491. package/lib/vector3.js +0 -154
  492. package/lib/vertex.d.ts +0 -14
  493. package/lib/vertex.js +0 -177
  494. package/lib/video_mode.d.ts +0 -12
  495. package/lib/video_mode.js +0 -99
  496. package/src/base_class_with_loading.h +0 -21
  497. package/src/clock.cc +0 -71
  498. package/src/clock.h +0 -30
  499. package/src/color.cc +0 -189
  500. package/src/color.h +0 -49
  501. package/src/drawable/circle_shape.cc +0 -78
  502. package/src/drawable/circle_shape.h +0 -28
  503. package/src/drawable/convex_shape.cc +0 -57
  504. package/src/drawable/convex_shape.h +0 -29
  505. package/src/drawable/drawable-inl.h +0 -29
  506. package/src/drawable/drawable.cc +0 -41
  507. package/src/drawable/drawable.h +0 -49
  508. package/src/drawable/package_plugin-inl.h +0 -191
  509. package/src/drawable/package_plugin.h +0 -60
  510. package/src/drawable/rectangle_shape.cc +0 -69
  511. package/src/drawable/rectangle_shape.h +0 -29
  512. package/src/drawable/shape.cc +0 -67
  513. package/src/drawable/shape.h +0 -39
  514. package/src/drawable/sprite.cc +0 -122
  515. package/src/drawable/sprite.h +0 -45
  516. package/src/drawable/text.cc +0 -133
  517. package/src/drawable/text.h +0 -54
  518. package/src/drawable/vertex_array.cc +0 -248
  519. package/src/drawable/vertex_array.h +0 -46
  520. package/src/font.cc +0 -214
  521. package/src/font.h +0 -44
  522. package/src/gen/.gitkeep +0 -0
  523. package/src/gen/joystick_axis.cc +0 -30
  524. package/src/gen/keycode.cc +0 -226
  525. package/src/gen/mouse_button.cc +0 -30
  526. package/src/gen/sensor_type.cc +0 -26
  527. package/src/image.cc +0 -379
  528. package/src/image.h +0 -72
  529. package/src/joystick.cc +0 -132
  530. package/src/joystick.h +0 -32
  531. package/src/keyboard.cc +0 -65
  532. package/src/keyboard.h +0 -27
  533. package/src/mouse.cc +0 -95
  534. package/src/mouse.h +0 -30
  535. package/src/plugins/transformable_plugin-inl.h +0 -121
  536. package/src/plugins/transformable_plugin.h +0 -42
  537. package/src/poll_event.cc +0 -326
  538. package/src/poll_event.h +0 -18
  539. package/src/rect-inl.h +0 -154
  540. package/src/rect.cc +0 -28
  541. package/src/rect.h +0 -105
  542. package/src/render_window.cc +0 -413
  543. package/src/render_window.h +0 -111
  544. package/src/render_window_async_display.cc +0 -49
  545. package/src/render_window_async_draw.cc +0 -56
  546. package/src/resizable_buffer.h +0 -104
  547. package/src/sensor.cc +0 -82
  548. package/src/sensor.h +0 -28
  549. package/src/sfml.cc +0 -85
  550. package/src/sound/music.cc +0 -113
  551. package/src/sound/music.h +0 -35
  552. package/src/sound/sound.cc +0 -116
  553. package/src/sound/sound.h +0 -41
  554. package/src/sound/sound_buffer.cc +0 -226
  555. package/src/sound/sound_buffer.h +0 -46
  556. package/src/sound/sound_source.cc +0 -124
  557. package/src/sound/sound_source.h +0 -80
  558. package/src/texture.cc +0 -246
  559. package/src/texture.h +0 -47
  560. package/src/time.cc +0 -177
  561. package/src/time.h +0 -42
  562. package/src/touch.cc +0 -54
  563. package/src/touch.h +0 -23
  564. package/src/utils-inl.h +0 -48
  565. package/src/utils.h +0 -21
  566. package/src/vector2-inl.h +0 -198
  567. package/src/vector2.cc +0 -36
  568. package/src/vector2.h +0 -133
  569. package/src/vector3-inl.h +0 -200
  570. package/src/vector3.cc +0 -36
  571. package/src/vector3.h +0 -134
  572. package/src/vertex.cc +0 -238
  573. package/src/vertex.h +0 -114
  574. package/src/video_mode.cc +0 -184
  575. package/src/video_mode.h +0 -38
  576. package/src/workers/load_from_file_worker.h +0 -79
  577. package/src/workers/save_to_file_worker.h +0 -79
  578. package/third_party/sfml/include/SFML/Audio/AlResource.hpp +0 -70
  579. package/third_party/sfml/include/SFML/Audio/Export.hpp +0 -48
  580. package/third_party/sfml/include/SFML/Audio/InputSoundFile.hpp +0 -268
  581. package/third_party/sfml/include/SFML/Audio/Listener.hpp +0 -234
  582. package/third_party/sfml/include/SFML/Audio/Music.hpp +0 -337
  583. package/third_party/sfml/include/SFML/Audio/OutputSoundFile.hpp +0 -133
  584. package/third_party/sfml/include/SFML/Audio/Sound.hpp +0 -264
  585. package/third_party/sfml/include/SFML/Audio/SoundBuffer.hpp +0 -352
  586. package/third_party/sfml/include/SFML/Audio/SoundBufferRecorder.hpp +0 -144
  587. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.hpp +0 -197
  588. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.inl +0 -100
  589. package/third_party/sfml/include/SFML/Audio/SoundFileReader.hpp +0 -165
  590. package/third_party/sfml/include/SFML/Audio/SoundFileWriter.hpp +0 -125
  591. package/third_party/sfml/include/SFML/Audio/SoundRecorder.hpp +0 -410
  592. package/third_party/sfml/include/SFML/Audio/SoundSource.hpp +0 -332
  593. package/third_party/sfml/include/SFML/Audio/SoundStream.hpp +0 -420
  594. package/third_party/sfml/include/SFML/Audio.hpp +0 -56
  595. package/third_party/sfml/include/SFML/Config.hpp +0 -248
  596. package/third_party/sfml/include/SFML/GpuPreference.hpp +0 -74
  597. package/third_party/sfml/include/SFML/Graphics/BlendMode.hpp +0 -219
  598. package/third_party/sfml/include/SFML/Graphics/CircleShape.hpp +0 -154
  599. package/third_party/sfml/include/SFML/Graphics/Color.hpp +0 -275
  600. package/third_party/sfml/include/SFML/Graphics/ConvexShape.hpp +0 -153
  601. package/third_party/sfml/include/SFML/Graphics/Drawable.hpp +0 -126
  602. package/third_party/sfml/include/SFML/Graphics/Export.hpp +0 -48
  603. package/third_party/sfml/include/SFML/Graphics/Font.hpp +0 -496
  604. package/third_party/sfml/include/SFML/Graphics/Glsl.hpp +0 -227
  605. package/third_party/sfml/include/SFML/Graphics/Glsl.inl +0 -155
  606. package/third_party/sfml/include/SFML/Graphics/Glyph.hpp +0 -81
  607. package/third_party/sfml/include/SFML/Graphics/Image.hpp +0 -346
  608. package/third_party/sfml/include/SFML/Graphics/PrimitiveType.hpp +0 -58
  609. package/third_party/sfml/include/SFML/Graphics/Rect.hpp +0 -274
  610. package/third_party/sfml/include/SFML/Graphics/Rect.inl +0 -171
  611. package/third_party/sfml/include/SFML/Graphics/RectangleShape.hpp +0 -132
  612. package/third_party/sfml/include/SFML/Graphics/RenderStates.hpp +0 -174
  613. package/third_party/sfml/include/SFML/Graphics/RenderTarget.hpp +0 -518
  614. package/third_party/sfml/include/SFML/Graphics/RenderTexture.hpp +0 -334
  615. package/third_party/sfml/include/SFML/Graphics/RenderWindow.hpp +0 -302
  616. package/third_party/sfml/include/SFML/Graphics/Shader.hpp +0 -875
  617. package/third_party/sfml/include/SFML/Graphics/Shape.hpp +0 -355
  618. package/third_party/sfml/include/SFML/Graphics/Sprite.hpp +0 -279
  619. package/third_party/sfml/include/SFML/Graphics/Text.hpp +0 -513
  620. package/third_party/sfml/include/SFML/Graphics/Texture.hpp +0 -733
  621. package/third_party/sfml/include/SFML/Graphics/Transform.hpp +0 -497
  622. package/third_party/sfml/include/SFML/Graphics/Transformable.hpp +0 -429
  623. package/third_party/sfml/include/SFML/Graphics/Vertex.hpp +0 -148
  624. package/third_party/sfml/include/SFML/Graphics/VertexArray.hpp +0 -223
  625. package/third_party/sfml/include/SFML/Graphics/VertexBuffer.hpp +0 -408
  626. package/third_party/sfml/include/SFML/Graphics/View.hpp +0 -343
  627. package/third_party/sfml/include/SFML/Graphics.hpp +0 -68
  628. package/third_party/sfml/include/SFML/Main.hpp +0 -43
  629. package/third_party/sfml/include/SFML/Network/Export.hpp +0 -48
  630. package/third_party/sfml/include/SFML/Network/Ftp.hpp +0 -616
  631. package/third_party/sfml/include/SFML/Network/Http.hpp +0 -482
  632. package/third_party/sfml/include/SFML/Network/IpAddress.hpp +0 -328
  633. package/third_party/sfml/include/SFML/Network/Packet.hpp +0 -545
  634. package/third_party/sfml/include/SFML/Network/Socket.hpp +0 -219
  635. package/third_party/sfml/include/SFML/Network/SocketHandle.hpp +0 -57
  636. package/third_party/sfml/include/SFML/Network/SocketSelector.hpp +0 -263
  637. package/third_party/sfml/include/SFML/Network/TcpListener.hpp +0 -170
  638. package/third_party/sfml/include/SFML/Network/TcpSocket.hpp +0 -316
  639. package/third_party/sfml/include/SFML/Network/UdpSocket.hpp +0 -292
  640. package/third_party/sfml/include/SFML/Network.hpp +0 -53
  641. package/third_party/sfml/include/SFML/OpenGL.hpp +0 -78
  642. package/third_party/sfml/include/SFML/System/Clock.hpp +0 -117
  643. package/third_party/sfml/include/SFML/System/Err.hpp +0 -80
  644. package/third_party/sfml/include/SFML/System/Export.hpp +0 -48
  645. package/third_party/sfml/include/SFML/System/FileInputStream.hpp +0 -169
  646. package/third_party/sfml/include/SFML/System/InputStream.hpp +0 -152
  647. package/third_party/sfml/include/SFML/System/Lock.hpp +0 -139
  648. package/third_party/sfml/include/SFML/System/MemoryInputStream.hpp +0 -148
  649. package/third_party/sfml/include/SFML/System/Mutex.hpp +0 -148
  650. package/third_party/sfml/include/SFML/System/NativeActivity.hpp +0 -62
  651. package/third_party/sfml/include/SFML/System/NonCopyable.hpp +0 -129
  652. package/third_party/sfml/include/SFML/System/Sleep.hpp +0 -52
  653. package/third_party/sfml/include/SFML/System/String.hpp +0 -669
  654. package/third_party/sfml/include/SFML/System/String.inl +0 -53
  655. package/third_party/sfml/include/SFML/System/Thread.hpp +0 -282
  656. package/third_party/sfml/include/SFML/System/Thread.inl +0 -90
  657. package/third_party/sfml/include/SFML/System/ThreadLocal.hpp +0 -103
  658. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.hpp +0 -158
  659. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.inl +0 -77
  660. package/third_party/sfml/include/SFML/System/Time.hpp +0 -488
  661. package/third_party/sfml/include/SFML/System/Utf.hpp +0 -763
  662. package/third_party/sfml/include/SFML/System/Utf.inl +0 -752
  663. package/third_party/sfml/include/SFML/System/Vector2.hpp +0 -301
  664. package/third_party/sfml/include/SFML/System/Vector2.inl +0 -161
  665. package/third_party/sfml/include/SFML/System/Vector3.hpp +0 -302
  666. package/third_party/sfml/include/SFML/System/Vector3.inl +0 -168
  667. package/third_party/sfml/include/SFML/System.hpp +0 -60
  668. package/third_party/sfml/include/SFML/Window/Clipboard.hpp +0 -119
  669. package/third_party/sfml/include/SFML/Window/Context.hpp +0 -195
  670. package/third_party/sfml/include/SFML/Window/ContextSettings.hpp +0 -149
  671. package/third_party/sfml/include/SFML/Window/Cursor.hpp +0 -241
  672. package/third_party/sfml/include/SFML/Window/Event.hpp +0 -285
  673. package/third_party/sfml/include/SFML/Window/Export.hpp +0 -48
  674. package/third_party/sfml/include/SFML/Window/GlResource.hpp +0 -109
  675. package/third_party/sfml/include/SFML/Window/Joystick.hpp +0 -227
  676. package/third_party/sfml/include/SFML/Window/Keyboard.hpp +0 -491
  677. package/third_party/sfml/include/SFML/Window/Mouse.hpp +0 -180
  678. package/third_party/sfml/include/SFML/Window/Sensor.hpp +0 -150
  679. package/third_party/sfml/include/SFML/Window/Touch.hpp +0 -137
  680. package/third_party/sfml/include/SFML/Window/VideoMode.hpp +0 -228
  681. package/third_party/sfml/include/SFML/Window/Vulkan.hpp +0 -115
  682. package/third_party/sfml/include/SFML/Window/Window.hpp +0 -354
  683. package/third_party/sfml/include/SFML/Window/WindowBase.hpp +0 -518
  684. package/third_party/sfml/include/SFML/Window/WindowHandle.hpp +0 -101
  685. package/third_party/sfml/include/SFML/Window/WindowStyle.hpp +0 -53
  686. package/third_party/sfml/include/SFML/Window.hpp +0 -58
  687. package/tools/clang_format.js +0 -9
  688. package/tools/copier/linux.js +0 -21
  689. package/tools/copier/macos.js +0 -34
  690. package/tools/copier/windows.js +0 -33
  691. package/tools/joystick_axis.js +0 -63
  692. package/tools/keycode.js +0 -92
  693. package/tools/lib_downloader.js +0 -107
  694. package/tools/lib_downloader_urls.js +0 -59
  695. package/tools/mouse_button.js +0 -92
  696. package/tools/sensor_type.js +0 -63
@@ -0,0 +1,149 @@
1
+ import {
2
+ mutableValue, timeStorage, type ReadonlyValue,
3
+ } from '../internal/value-storage';
4
+
5
+ const minInt64 = -(2n ** 63n);
6
+ const maxInt64 = 2n ** 63n - 1n;
7
+
8
+ export function checkedMicroseconds(value: bigint): bigint {
9
+ if (typeof value !== 'bigint') throw new TypeError('Expected a bigint');
10
+ if (value < minInt64 || value > maxInt64) {
11
+ throw new RangeError('Time must fit in a signed 64-bit microsecond count');
12
+ }
13
+ return value;
14
+ }
15
+
16
+ // Going through Number can double-round an int64 near a float midpoint.
17
+ // Large integers therefore round their significand directly to nearest-even.
18
+ /* eslint-disable no-bitwise */
19
+ function int64AsFloat(value: bigint): number {
20
+ const magnitude = value < 0n ? -value : value;
21
+ if (magnitude <= 9007199254740991n) return Math.fround(Number(value));
22
+ let exponent = Math.floor(Math.log2(Number(magnitude)));
23
+ if (magnitude < (1n << BigInt(exponent))) exponent--;
24
+ const shift = BigInt(exponent - 23);
25
+ let significand = magnitude >> shift;
26
+ const remainder = magnitude - (significand << shift);
27
+ const half = 1n << (shift - 1n);
28
+ if (remainder > half ||
29
+ (remainder === half && (significand & 1n) !== 0n)) {
30
+ significand++;
31
+ }
32
+ const result = Number(significand) * 2 ** Number(shift);
33
+ return value < 0n ? -result : result;
34
+ }
35
+ /* eslint-enable no-bitwise */
36
+
37
+ function floatScalar(value: number): number {
38
+ if (typeof value !== 'number') throw new TypeError('Expected a number');
39
+ const result = Math.fround(value);
40
+ if (!Number.isFinite(result)) {
41
+ throw new RangeError('Time requires a finite float32 value');
42
+ }
43
+ return result;
44
+ }
45
+
46
+ function secondsCount(value: number): bigint {
47
+ const count = Math.fround(floatScalar(value) * 1000000);
48
+ if (!Number.isFinite(count)) {
49
+ throw new RangeError('Time conversion exceeds the int64 range');
50
+ }
51
+ return checkedMicroseconds(BigInt(Math.trunc(count)));
52
+ }
53
+
54
+ /** A signed microsecond duration; native APIs receive its bigint by value. */
55
+ export class Time {
56
+ readonly [mutableValue] = true;
57
+ [timeStorage]: bigint;
58
+
59
+ /** 创建零时长。 */
60
+ constructor();
61
+ /** 从有符号 64 位微秒数创建时长。 */
62
+ constructor(duration: bigint);
63
+ /** 复制时长,副本与源对象独立。 */
64
+ constructor(source: ReadonlyValue<Time>);
65
+ constructor(source: bigint | ReadonlyValue<Time> = 0n) {
66
+ if (typeof source !== 'bigint' && !(source instanceof Time)) {
67
+ throw new TypeError('Expected a bigint duration or Time');
68
+ }
69
+ this[timeStorage] = checkedMicroseconds(
70
+ typeof source === 'bigint' ? source : source.asMicroseconds(),
71
+ );
72
+ }
73
+
74
+ /** 返回秒数,按 float32 精度舍入。 */
75
+ asSeconds(): number {
76
+ return Math.fround(int64AsFloat(this[timeStorage]) / 1000000);
77
+ }
78
+
79
+ /** 返回整毫秒数,向零截断并按有符号 32 位整数转换。 */
80
+ asMilliseconds(): number {
81
+ return Number(BigInt.asIntN(32, this[timeStorage] / 1000n));
82
+ }
83
+
84
+ /** 返回精确的有符号 64 位微秒数。 */
85
+ asMicroseconds(): bigint {
86
+ return this[timeStorage];
87
+ }
88
+
89
+ /** std::chrono::microseconds is represented by a microsecond bigint. */
90
+ toDuration(): bigint {
91
+ return this[timeStorage];
92
+ }
93
+
94
+ /** 只读的零时长。 */
95
+ static readonly Zero: ReadonlyValue<Time> = Object.freeze(new Time());
96
+ }
97
+
98
+ /** 从秒数创建时长,使用 float32 运算并截断到整微秒。 */
99
+ export function seconds(amount: number): Time {
100
+ return new Time(secondsCount(amount));
101
+ }
102
+
103
+ /** 从毫秒数创建时长;向零截断后的输入必须在有符号 32 位整数范围内。 */
104
+ export function milliseconds(amount: number): Time {
105
+ if (typeof amount !== 'number') throw new TypeError('Expected a number');
106
+ const integer = Math.trunc(amount);
107
+ if (!Number.isFinite(integer) ||
108
+ integer < -2147483648 || integer > 2147483647) {
109
+ throw new RangeError('Milliseconds must fit in a signed 32-bit integer');
110
+ }
111
+ return new Time(BigInt(integer) * 1000n);
112
+ }
113
+
114
+ /** 从精确的有符号 64 位微秒数创建时长,超出范围时抛出 RangeError。 */
115
+ export function microseconds(amount: bigint): Time {
116
+ return new Time(checkedMicroseconds(amount));
117
+ }
118
+
119
+ export function scaleTime(
120
+ time: ReadonlyValue<Time>, scalar: number | bigint,
121
+ operation: 'multiply' | 'divide',
122
+ ): bigint {
123
+ if (typeof scalar === 'bigint') {
124
+ checkedMicroseconds(scalar);
125
+ if (operation === 'divide' && scalar === 0n) {
126
+ throw new RangeError('Cannot divide by zero');
127
+ }
128
+ return checkedMicroseconds(operation === 'multiply'
129
+ ? time.asMicroseconds() * scalar : time.asMicroseconds() / scalar);
130
+ }
131
+ const value = floatScalar(scalar);
132
+ if (operation === 'divide' && value === 0) {
133
+ throw new RangeError('Cannot divide by zero');
134
+ }
135
+ return secondsCount(operation === 'multiply'
136
+ ? time.asSeconds() * value : time.asSeconds() / value);
137
+ }
138
+
139
+ export function remainderTime(
140
+ left: ReadonlyValue<Time>, right: ReadonlyValue<Time>,
141
+ ): bigint {
142
+ const lhs = left.asMicroseconds();
143
+ const rhs = right.asMicroseconds();
144
+ if (rhs === 0n) throw new RangeError('Cannot divide by zero');
145
+ if (lhs === minInt64 && rhs === -1n) {
146
+ throw new RangeError('Time remainder quotient exceeds the int64 range');
147
+ }
148
+ return lhs % rhs;
149
+ }
@@ -0,0 +1,53 @@
1
+ import { Time, milliseconds } from './time';
2
+ import type { ReadonlyValue } from '../internal/value-storage';
3
+
4
+ /** 每个检查周期调用一次;返回 true 继续等待,false 结束等待。 */
5
+ export type TimeoutPredicate = () => boolean;
6
+
7
+ const stop: TimeoutPredicate = () => false;
8
+
9
+ /** Timeout configuration; the consuming operation performs waits and checks. */
10
+ export class TimeoutWithPredicate {
11
+ private readonly predicate: TimeoutPredicate;
12
+ private readonly period: ReadonlyValue<Time>;
13
+
14
+ /** 创建固定超时配置,复制 timeout 的时长。 */
15
+ constructor(timeout: ReadonlyValue<Time>);
16
+ /** 创建周期检查配置;period 默认 1 毫秒,null 表示首次检查即结束等待。 */
17
+ constructor(predicate: TimeoutPredicate | null, period?: ReadonlyValue<Time>);
18
+ /** 复制配置,保留同一个谓词函数并复制检查周期。 */
19
+ constructor(source: Readonly<TimeoutWithPredicate>);
20
+ constructor(
21
+ source: ReadonlyValue<Time> | TimeoutPredicate | null |
22
+ Readonly<TimeoutWithPredicate>, period?: ReadonlyValue<Time>,
23
+ ) {
24
+ if (source instanceof Time || source instanceof TimeoutWithPredicate) {
25
+ if (period !== undefined) {
26
+ throw new TypeError('A timeout or copy accepts only one argument');
27
+ }
28
+ this.predicate = source instanceof Time ? stop : source.predicate;
29
+ this.period = Object.freeze(new Time(
30
+ source instanceof Time ? source : source.period));
31
+ return;
32
+ }
33
+ if (source !== null && typeof source !== 'function') {
34
+ throw new TypeError('Expected a Time, predicate, null or TimeoutWithPredicate');
35
+ }
36
+ if (period !== undefined && !(period instanceof Time)) {
37
+ throw new TypeError('Expected a Time period');
38
+ }
39
+ this.predicate = source ?? stop;
40
+ this.period = Object.freeze(new Time(
41
+ period === undefined ? milliseconds(1) : period));
42
+ }
43
+
44
+ /** 返回决定是否继续等待的谓词函数。 */
45
+ getPredicate(): TimeoutPredicate {
46
+ return this.predicate;
47
+ }
48
+
49
+ /** 返回只读的检查周期;固定超时配置返回其超时时长。 */
50
+ getPeriod(): ReadonlyValue<Time> {
51
+ return this.period;
52
+ }
53
+ }
@@ -0,0 +1,28 @@
1
+ import { native } from '../internal/native';
2
+
3
+ /**
4
+ * 判断 UTF-16 索引 position 前是否为字素边界,使用 SFML 的 Unicode 规则。
5
+ * 起点和末尾均为边界;代理对中间不是边界,孤立代理码元按 U+FFFD 处理。
6
+ * @throws {RangeError} position 不是 0~text.length 范围内的整数。
7
+ */
8
+ export function isGraphemeBoundary(text: string, position: number): boolean {
9
+ return native.isUnicodeBoundary(text, position, 0);
10
+ }
11
+
12
+ /**
13
+ * 判断 UTF-16 索引 position 前是否为单词边界,使用 SFML 的 Unicode 规则。
14
+ * 起点和末尾均为边界;代理对中间不是边界,孤立代理码元按 U+FFFD 处理。
15
+ * @throws {RangeError} position 不是 0~text.length 范围内的整数。
16
+ */
17
+ export function isWordBoundary(text: string, position: number): boolean {
18
+ return native.isUnicodeBoundary(text, position, 1);
19
+ }
20
+
21
+ /**
22
+ * 判断 UTF-16 索引 position 前是否为句子边界,使用 SFML 的 Unicode 规则。
23
+ * 起点和末尾均为边界;代理对中间不是边界,孤立代理码元按 U+FFFD 处理。
24
+ * @throws {RangeError} position 不是 0~text.length 范围内的整数。
25
+ */
26
+ export function isSentenceBoundary(text: string, position: number): boolean {
27
+ return native.isUnicodeBoundary(text, position, 2);
28
+ }
@@ -0,0 +1,345 @@
1
+ import { native, type NativeValueHandle } from '../internal/native';
2
+ import { LazyValue, nativeValue } from '../internal/lazy-value';
3
+ import { Angle, radians } from './angle';
4
+ import type { Bvec2 } from '../graphics/boolean-vector';
5
+ import {
6
+ vector2Storage, vector2Native, type ReadonlyValue, mutableValue,
7
+ } from '../internal/value-storage';
8
+ import {
9
+ scalarArrays, requireFloat, toScalar, scalarProduct, convertScalar,
10
+ validateScalar, type ScalarType, type Scalar, type ScalarArray,
11
+ type NumberScalar, type FloatScalar,
12
+ } from '../internal/scalar';
13
+
14
+ export type { ScalarType } from '../internal/scalar';
15
+
16
+ type Vector2Source =
17
+ ReadonlyValue<Vector2<ScalarType>> | ReadonlyValue<Bvec2>;
18
+ type Vector2Arguments<T extends ScalarType = NumberScalar> =
19
+ | []
20
+ | [ x: Scalar<T>, y: Scalar<T> ]
21
+ | [ source: Vector2Source ];
22
+ type PolarArguments = [ r: number, phi: ReadonlyValue<Angle> ];
23
+
24
+ type Vector2State =
25
+ LazyValue<'vector2', ScalarArray>;
26
+
27
+ /** sf::Vector2<T>, with a native handle lazily bound to its existing storage. */
28
+ export class Vector2<T extends ScalarType> {
29
+ readonly [mutableValue] = true;
30
+ private readonly type: T;
31
+ // Keep internal storage replaceable even when the public wrapper is frozen.
32
+ private readonly state: Vector2State;
33
+
34
+ /**
35
+ * 创建指定标量类型的二维向量;省略分量时为零,也可转换并复制源向量。
36
+ * @param scalarType 分量存储类型;i64/u64 使用 bigint,其余使用 number。
37
+ * @param args x、y 分量或源向量;浮点类型还支持半径与 Angle 极坐标。
38
+ */
39
+ constructor(
40
+ scalarType: T,
41
+ ...args: Vector2Arguments<T> | (T extends FloatScalar ? PolarArguments : never)
42
+ );
43
+ /** 复制向量及其标量类型,副本拥有独立存储。 */
44
+ constructor(source: ReadonlyValue<Vector2<T>>);
45
+ constructor(
46
+ typeOrSource: T | ReadonlyValue<Vector2<T>>,
47
+ ...args: Vector2Arguments<ScalarType> | PolarArguments
48
+ ) {
49
+ this.type = typeof typeOrSource === 'string'
50
+ ? typeOrSource
51
+ : typeOrSource.scalarType as T;
52
+ validateScalar(this.type);
53
+ const type = this.type;
54
+ this.state = new LazyValue(new scalarArrays[type](2),
55
+ buffer => native.wrapVector2(type, buffer));
56
+
57
+ const source = typeof typeOrSource === 'string' ? args[0] : typeOrSource;
58
+ if (typeof source === 'number' || typeof source === 'bigint') {
59
+ if (args[1] instanceof Angle) {
60
+ requireFloat(this.type);
61
+ const radius = toScalar(type, source as number);
62
+ const phi = args[1].asRadians();
63
+ // SFML polar construction evaluates sin/cos with the float Angle.
64
+ this.x = (radius * Math.fround(Math.cos(phi))) as Scalar<T>;
65
+ this.y = (radius * Math.fround(Math.sin(phi))) as Scalar<T>;
66
+ } else {
67
+ this.x = source as Scalar<T>;
68
+ this.y = args[1] as Scalar<T>;
69
+ }
70
+ } else if (source !== undefined) {
71
+ if (source instanceof Vector2 && source.scalarType === type) {
72
+ const input = source[vector2Storage];
73
+ new Uint8Array(this.state.values.buffer).set(
74
+ new Uint8Array(input.buffer, input.byteOffset, input.byteLength));
75
+ } else {
76
+ this.x = convertScalar(type, source.x) as Scalar<T>;
77
+ this.y = convertScalar(type, source.y) as Scalar<T>;
78
+ }
79
+ }
80
+ }
81
+
82
+ /** 分量使用的标量存储类型。 */
83
+ get scalarType(): T {
84
+ return this.type;
85
+ }
86
+
87
+ get [vector2Storage](): ScalarArray<T> {
88
+ return this.state.values as ScalarArray<T>;
89
+ }
90
+
91
+ get [vector2Native](): NativeValueHandle<'vector2'> {
92
+ return nativeValue(this, vector2Native, this.state);
93
+ }
94
+
95
+ /** X 分量;写入按 scalarType 对应的 TypedArray 规则转换。 */
96
+ get x(): Scalar<T> {
97
+ return this.state.values[0] as Scalar<T>;
98
+ }
99
+
100
+ /** 设置 X 分量。 */
101
+ set x(value: Scalar<T>) {
102
+ this.state.values[0] = value;
103
+ }
104
+
105
+ /** Y 分量;写入按 scalarType 对应的 TypedArray 规则转换。 */
106
+ get y(): Scalar<T> {
107
+ return this.state.values[1] as Scalar<T>;
108
+ }
109
+
110
+ /** 设置 Y 分量。 */
111
+ set y(value: Scalar<T>) {
112
+ this.state.values[1] = value;
113
+ }
114
+
115
+ /** 返回 x²+y²,按当前标量类型的精度和范围计算。 */
116
+ lengthSquared(): Scalar<T> {
117
+ return this.dot(this);
118
+ }
119
+
120
+ /** 返回欧几里得长度;仅适用于浮点向量。 */
121
+ length(this: ReadonlyValue<Vector2<FloatScalar>>): number;
122
+ length(): number {
123
+ requireFloat(this.type);
124
+ return toScalar(this.type, Math.sqrt(this.lengthSquared() as number));
125
+ }
126
+
127
+ /** 返回同方向的单位向量;仅适用于浮点向量,零向量抛出 RangeError。 */
128
+ normalized(this: ReadonlyValue<Vector2<T & FloatScalar>>): Vector2<T>;
129
+ normalized(): Vector2<T> {
130
+ requireFloat(this.type);
131
+ const length = toScalar(this.type, Math.sqrt(this.lengthSquared() as number));
132
+ if (length === 0) {
133
+ throw new RangeError('Cannot normalize a vector with zero length');
134
+ }
135
+ return this.createResult((this.x as number) / length,
136
+ (this.y as number) / length);
137
+ }
138
+
139
+ /** 返回相对于正 X 轴的角度;仅适用于非零浮点向量。 */
140
+ angle(this: ReadonlyValue<Vector2<FloatScalar>>): Angle;
141
+ angle(): Angle {
142
+ requireFloat(this.type);
143
+ this.checkNonzero();
144
+ return radians(Math.atan2(this.y as number, this.x as number));
145
+ }
146
+
147
+ /** 返回从本向量到 rhs 的有符号夹角;两者必须为同类型的非零浮点向量。 */
148
+ angleTo(
149
+ this: ReadonlyValue<Vector2<T & FloatScalar>>,
150
+ rhs: ReadonlyValue<Vector2<T>>,
151
+ ): Angle;
152
+ angleTo(rhs: ReadonlyValue<Vector2<T>>): Angle {
153
+ requireFloat(this.type);
154
+ this.checkScalarType(rhs);
155
+ this.checkNonzero();
156
+ if (rhs.x === 0 && rhs.y === 0) {
157
+ throw new RangeError('Cannot calculate angle to a zero vector');
158
+ }
159
+ return radians(Math.atan2(this.cross(rhs) as number, this.dot(rhs) as number));
160
+ }
161
+
162
+ /** 返回旋转 phi 后的新浮点向量;屏幕坐标中正角度为顺时针。 */
163
+ rotatedBy(
164
+ this: ReadonlyValue<Vector2<T & FloatScalar>>, phi: ReadonlyValue<Angle>,
165
+ ): Vector2<T>;
166
+ rotatedBy(phi: ReadonlyValue<Angle>): Vector2<T> {
167
+ requireFloat(this.type);
168
+ const cos = toScalar(this.type, Math.cos(phi.asRadians()));
169
+ const sin = toScalar(this.type, Math.sin(phi.asRadians()));
170
+ return this.createResult(
171
+ scalarProduct(this.type, cos, this.x as number) -
172
+ scalarProduct(this.type, sin, this.y as number),
173
+ scalarProduct(this.type, sin, this.x as number) +
174
+ scalarProduct(this.type, cos, this.y as number),
175
+ );
176
+ }
177
+
178
+ /** 返回在 axis 上的投影;axis 必须为同类型的非零浮点向量。 */
179
+ projectedOnto(
180
+ this: ReadonlyValue<Vector2<T & FloatScalar>>,
181
+ axis: ReadonlyValue<Vector2<T>>,
182
+ ): Vector2<T>;
183
+ projectedOnto(axis: ReadonlyValue<Vector2<T>>): Vector2<T> {
184
+ requireFloat(this.type);
185
+ this.checkScalarType(axis);
186
+ if (axis.x === 0 && axis.y === 0) {
187
+ throw new RangeError('Cannot project onto a zero vector');
188
+ }
189
+ const ratio = toScalar(this.type,
190
+ (this.dot(axis) as number) / (axis.lengthSquared() as number));
191
+ return this.createResult(ratio * (axis.x as number),
192
+ ratio * (axis.y as number));
193
+ }
194
+
195
+ /** 返回与同类型向量 rhs 的点积 x·rhs.x+y·rhs.y。 */
196
+ dot(rhs: ReadonlyValue<Vector2<T>>): Scalar<T> {
197
+ this.checkScalarType(rhs);
198
+ if (typeof this.x === 'bigint') {
199
+ return convertScalar(this.type,
200
+ this.x * (rhs.x as bigint) +
201
+ (this.y as bigint) * (rhs.y as bigint)) as Scalar<T>;
202
+ }
203
+ return toScalar(this.type,
204
+ scalarProduct(this.type, this.x as number, rhs.x as number) +
205
+ scalarProduct(this.type, this.y as number, rhs.y as number)) as Scalar<T>;
206
+ }
207
+
208
+ /** 返回二维叉积标量 x·rhs.y−y·rhs.x;rhs 必须具有相同标量类型。 */
209
+ cross(rhs: ReadonlyValue<Vector2<T>>): Scalar<T> {
210
+ this.checkScalarType(rhs);
211
+ if (typeof this.x === 'bigint') {
212
+ return convertScalar(this.type,
213
+ this.x * (rhs.y as bigint) -
214
+ (this.y as bigint) * (rhs.x as bigint)) as Scalar<T>;
215
+ }
216
+ return toScalar(this.type,
217
+ scalarProduct(this.type, this.x as number, rhs.y as number) -
218
+ scalarProduct(this.type, this.y as number, rhs.x as number)) as Scalar<T>;
219
+ }
220
+
221
+ /** 返回垂直向量 (-y, x),使用相同标量类型。 */
222
+ perpendicular(): Vector2<T> {
223
+ return this.createResult(-this.y, this.x);
224
+ }
225
+
226
+ /** 返回与同类型 rhs 逐分量相乘的新向量。 */
227
+ componentWiseMul(rhs: ReadonlyValue<Vector2<T>>): Vector2<T> {
228
+ this.checkScalarType(rhs);
229
+ if (typeof this.x === 'bigint') {
230
+ return this.createResult(this.x * (rhs.x as bigint),
231
+ (this.y as bigint) * (rhs.y as bigint));
232
+ }
233
+ return this.createResult(
234
+ scalarProduct(this.type, this.x as number, rhs.x as number),
235
+ scalarProduct(this.type, this.y as number, rhs.y as number),
236
+ );
237
+ }
238
+
239
+ /** 返回与同类型 rhs 逐分量相除的新向量;任一除数为零时抛出 RangeError。 */
240
+ componentWiseDiv(rhs: ReadonlyValue<Vector2<T>>): Vector2<T> {
241
+ this.checkScalarType(rhs);
242
+ if (rhs.x === 0 || rhs.y === 0 || rhs.x === 0n || rhs.y === 0n) {
243
+ throw new RangeError('Vector2.componentWiseDiv() cannot divide by zero');
244
+ }
245
+ if (typeof this.x === 'bigint') {
246
+ return this.createResult(this.x / (rhs.x as bigint),
247
+ (this.y as bigint) / (rhs.y as bigint));
248
+ }
249
+ return this.createResult((this.x as number) / (rhs.x as number),
250
+ (this.y as number) / (rhs.y as number));
251
+ }
252
+
253
+ protected createResult(x: number | bigint, y: number | bigint): Vector2<T> {
254
+ return new Vector2(this.type, x as Scalar<T>, y as Scalar<T>);
255
+ }
256
+
257
+ private checkNonzero(): void {
258
+ if (this.x === 0 && this.y === 0) {
259
+ throw new RangeError('Cannot calculate angle from a zero vector');
260
+ }
261
+ }
262
+
263
+ private checkScalarType(rhs: ReadonlyValue<Vector2<T>>): void {
264
+ if (!(rhs instanceof Vector2) || rhs.scalarType !== this.type) {
265
+ throw new TypeError('Vector2 operands must have the same scalar type');
266
+ }
267
+ }
268
+ }
269
+
270
+ /** sf::Vector2<int>. */
271
+ export class Vector2i extends Vector2<'i32'> {
272
+ /** 创建有符号 32 位整数零向量。 */
273
+ constructor();
274
+ /** 从 x、y 分量创建有符号 32 位整数向量。 */
275
+ constructor(x: number, y: number);
276
+ /** 将 source 转换并复制为有符号 32 位整数向量。 */
277
+ constructor(source: Vector2Source);
278
+ constructor(...args: Vector2Arguments) {
279
+ super('i32', ...args);
280
+ this.createResult = Vector2i.makeResult;
281
+ }
282
+
283
+ private static makeResult(x: number, y: number): Vector2i {
284
+ return new Vector2i(x, y);
285
+ }
286
+ }
287
+
288
+ /** sf::Vector2<unsigned int>. */
289
+ export class Vector2u extends Vector2<'u32'> {
290
+ /** 创建无符号 32 位整数零向量。 */
291
+ constructor();
292
+ /** 从 x、y 分量创建无符号 32 位整数向量。 */
293
+ constructor(x: number, y: number);
294
+ /** 将 source 转换并复制为无符号 32 位整数向量。 */
295
+ constructor(source: Vector2Source);
296
+ constructor(...args: Vector2Arguments) {
297
+ super('u32', ...args);
298
+ this.createResult = Vector2u.makeResult;
299
+ }
300
+
301
+ private static makeResult(x: number, y: number): Vector2u {
302
+ return new Vector2u(x, y);
303
+ }
304
+ }
305
+
306
+ /** sf::Vector2<float>. */
307
+ export class Vector2f extends Vector2<'f32'> {
308
+ /** 创建 float32 零向量。 */
309
+ constructor();
310
+ /** 从 x、y 分量创建 float32 向量。 */
311
+ constructor(x: number, y: number);
312
+ /** 从半径 r 和相对于正 X 轴的角度 phi 创建 float32 向量。 */
313
+ constructor(r: number, phi: ReadonlyValue<Angle>);
314
+ /** 将 source 转换并复制为 float32 向量。 */
315
+ constructor(source: Vector2Source);
316
+ constructor(...args: Vector2Arguments | PolarArguments) {
317
+ super('f32', ...args);
318
+ this.createResult = Vector2f.makeResult;
319
+ }
320
+
321
+ private static makeResult(x: number, y: number): Vector2f {
322
+ return new Vector2f(x, y);
323
+ }
324
+ }
325
+
326
+ const vector2Classes = { i32: Vector2i, u32: Vector2u, f32: Vector2f };
327
+
328
+ function createMemberResult(this: Vector2<'i32' | 'u32' | 'f32'>,
329
+ x: number, y: number) {
330
+ const Constructor = vector2Classes[this.scalarType];
331
+ return new Constructor(x, y);
332
+ }
333
+
334
+ /** Internal member view; native ownership can be resolved through its parent. */
335
+ export function vector2FromState<T extends 'i32' | 'u32' | 'f32'>(
336
+ type: T, state: Vector2State,
337
+ ): Vector2<T> {
338
+ // Bypass allocation and initialize the same fields as the value constructor.
339
+ return Object.assign(Object.create(vector2Classes[type].prototype), {
340
+ type,
341
+ [mutableValue]: true,
342
+ state,
343
+ createResult: createMemberResult,
344
+ });
345
+ }