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,65 @@
1
+ import { Time } from './time';
2
+ import { type ReadonlyValue } from '../internal/value-storage';
3
+ /**
4
+ * A pausable monotonic stopwatch, with no native SFML handle.
5
+ * @zh 可暂停的单调秒表,不持有原生 SFML 句柄。
6
+ * @ja 一時停止可能な単調ストップウォッチ。ネイティブ SFML ハンドルは持たない。
7
+ * @ko 일시 정지 가능한 단조 스톱워치. 네이티브 SFML 핸들을 갖지 않는다.
8
+ */
9
+ export declare class Clock {
10
+ private reference;
11
+ private stopped;
12
+ /**
13
+ * Create a clock that starts immediately, or copy source's current
14
+ * starting point and paused state.
15
+ * @zh 创建立即开始计时的时钟,或复制 source 当前的计时起点和暂停状态。
16
+ * @ja 直ちに計測を開始する時計を作成するか、source の現在の計測開始点と
17
+ * 一時停止状態をコピーする。
18
+ * @ko 즉시 측정을 시작하는 시계를 생성하거나 source의 현재 측정 시작점과
19
+ * 일시 정지 상태를 복사한다.
20
+ */
21
+ constructor(source?: ReadonlyValue<Clock>);
22
+ /**
23
+ * Return accumulated running time, excluding time paused with stop().
24
+ * @zh 返回累计运行时长,不计入通过 stop() 暂停的时间。
25
+ * @ja stop() による一時停止時間を除いた累積稼働時間を返す。
26
+ * @ko stop()으로 일시 정지한 시간을 제외한 누적 실행 시간을 반환한다.
27
+ */
28
+ getElapsedTime(): Time;
29
+ /**
30
+ * Return whether the clock is running.
31
+ * @zh 返回时钟是否正在计时。
32
+ * @ja 時計が計測中かどうかを返す。
33
+ * @ko 시계가 측정 중인지 반환한다.
34
+ */
35
+ isRunning(): boolean;
36
+ /**
37
+ * Resume timing, preserving accumulated time; do nothing if already running.
38
+ * @zh 恢复计时,保留累计时长;已运行时无操作。
39
+ * @ja 累積時間を保持して計測を再開する。すでに計測中なら何もしない。
40
+ * @ko 누적 시간을 유지하며 측정을 재개한다. 이미 실행 중이면 아무 작업도 안 한다.
41
+ */
42
+ start(this: Clock): void;
43
+ /**
44
+ * Pause timing, preserving accumulated time.
45
+ * @zh 暂停计时,保留累计时长。
46
+ * @ja 累積時間を保持して計測を一時停止する。
47
+ * @ko 누적 시간을 유지하며 측정을 일시 정지한다.
48
+ */
49
+ stop(this: Clock): void;
50
+ /**
51
+ * Clear and start timing, returning the previous accumulated running time.
52
+ * @zh 清零并开始计时,返回清零前的累计运行时长。
53
+ * @ja ゼロにして計測を開始し、リセット前の累積稼働時間を返す。
54
+ * @ko 초기화 후 측정을 시작하고 초기화 전 누적 실행 시간을 반환한다.
55
+ */
56
+ restart(this: Clock): Time;
57
+ /**
58
+ * Clear and pause timing, returning the previous accumulated running time.
59
+ * @zh 清零并暂停计时,返回清零前的累计运行时长。
60
+ * @ja ゼロにして計測を一時停止し、リセット前の累積稼働時間を返す。
61
+ * @ko 초기화 후 측정을 일시 정지하고 초기화 전 누적 실행 시간을 반환한다.
62
+ */
63
+ reset(this: Clock): Time;
64
+ private resetAt;
65
+ }
@@ -0,0 +1,99 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Clock = void 0;
4
+ const node_process_1 = require("node:process");
5
+ const time_1 = require("./time");
6
+ /**
7
+ * A pausable monotonic stopwatch, with no native SFML handle.
8
+ * @zh 可暂停的单调秒表,不持有原生 SFML 句柄。
9
+ * @ja 一時停止可能な単調ストップウォッチ。ネイティブ SFML ハンドルは持たない。
10
+ * @ko 일시 정지 가능한 단조 스톱워치. 네이티브 SFML 핸들을 갖지 않는다.
11
+ */
12
+ class Clock {
13
+ /**
14
+ * Create a clock that starts immediately, or copy source's current
15
+ * starting point and paused state.
16
+ * @zh 创建立即开始计时的时钟,或复制 source 当前的计时起点和暂停状态。
17
+ * @ja 直ちに計測を開始する時計を作成するか、source の現在の計測開始点と
18
+ * 一時停止状態をコピーする。
19
+ * @ko 즉시 측정을 시작하는 시계를 생성하거나 source의 현재 측정 시작점과
20
+ * 일시 정지 상태를 복사한다.
21
+ */
22
+ constructor(source) {
23
+ if (source !== undefined) {
24
+ if (!(source instanceof Clock))
25
+ throw new TypeError('Expected a Clock');
26
+ this.reference = source.reference;
27
+ this.stopped = source.stopped;
28
+ }
29
+ else {
30
+ this.reference = node_process_1.hrtime.bigint();
31
+ }
32
+ }
33
+ /**
34
+ * Return accumulated running time, excluding time paused with stop().
35
+ * @zh 返回累计运行时长,不计入通过 stop() 暂停的时间。
36
+ * @ja stop() による一時停止時間を除いた累積稼働時間を返す。
37
+ * @ko stop()으로 일시 정지한 시간을 제외한 누적 실행 시간을 반환한다.
38
+ */
39
+ getElapsedTime() {
40
+ return new time_1.Time(((this.stopped ?? node_process_1.hrtime.bigint()) - this.reference) / 1000n);
41
+ }
42
+ /**
43
+ * Return whether the clock is running.
44
+ * @zh 返回时钟是否正在计时。
45
+ * @ja 時計が計測中かどうかを返す。
46
+ * @ko 시계가 측정 중인지 반환한다.
47
+ */
48
+ isRunning() {
49
+ return this.stopped === undefined;
50
+ }
51
+ /**
52
+ * Resume timing, preserving accumulated time; do nothing if already running.
53
+ * @zh 恢复计时,保留累计时长;已运行时无操作。
54
+ * @ja 累積時間を保持して計測を再開する。すでに計測中なら何もしない。
55
+ * @ko 누적 시간을 유지하며 측정을 재개한다. 이미 실행 중이면 아무 작업도 안 한다.
56
+ */
57
+ start() {
58
+ if (this.stopped !== undefined) {
59
+ this.reference += node_process_1.hrtime.bigint() - this.stopped;
60
+ this.stopped = undefined;
61
+ }
62
+ }
63
+ /**
64
+ * Pause timing, preserving accumulated time.
65
+ * @zh 暂停计时,保留累计时长。
66
+ * @ja 累積時間を保持して計測を一時停止する。
67
+ * @ko 누적 시간을 유지하며 측정을 일시 정지한다.
68
+ */
69
+ stop() {
70
+ if (this.stopped === undefined)
71
+ this.stopped = node_process_1.hrtime.bigint();
72
+ }
73
+ /**
74
+ * Clear and start timing, returning the previous accumulated running time.
75
+ * @zh 清零并开始计时,返回清零前的累计运行时长。
76
+ * @ja ゼロにして計測を開始し、リセット前の累積稼働時間を返す。
77
+ * @ko 초기화 후 측정을 시작하고 초기화 전 누적 실행 시간을 반환한다.
78
+ */
79
+ restart() {
80
+ return this.resetAt(true);
81
+ }
82
+ /**
83
+ * Clear and pause timing, returning the previous accumulated running time.
84
+ * @zh 清零并暂停计时,返回清零前的累计运行时长。
85
+ * @ja ゼロにして計測を一時停止し、リセット前の累積稼働時間を返す。
86
+ * @ko 초기화 후 측정을 일시 정지하고 초기화 전 누적 실행 시간을 반환한다.
87
+ */
88
+ reset() {
89
+ return this.resetAt(false);
90
+ }
91
+ resetAt(running) {
92
+ const now = node_process_1.hrtime.bigint();
93
+ const elapsed = new time_1.Time(((this.stopped ?? now) - this.reference) / 1000n);
94
+ this.reference = now;
95
+ this.stopped = running ? undefined : now;
96
+ return elapsed;
97
+ }
98
+ }
99
+ exports.Clock = Clock;
@@ -0,0 +1,18 @@
1
+ /// <reference types="node" />
2
+ import { Writable } from 'node:stream';
3
+ /**
4
+ * A singleton Writable whose bytes are written to the actual SFML stream.
5
+ * @zh 单例 Writable,其字节写入实际的 SFML 流。
6
+ * @ja 書き込んだバイトが実際の SFML ストリームに渡されるシングルトン Writable。
7
+ * @ko 바이트가 실제 SFML 스트림에 기록되는 싱글턴 Writable.
8
+ */
9
+ export declare function err(): Writable;
10
+ /**
11
+ * Process-wide SFML output: Writable redirects, null mutes, undefined resets.
12
+ * @zh 进程级 SFML 输出:Writable 重定向,null 静默,undefined 重置。
13
+ * @ja プロセス全体の SFML 出力。Writable で転送、null で抑止、
14
+ * undefined でリセットする。
15
+ * @ko 프로세스 전체 SFML 출력. Writable은 리디렉션, null은 출력 차단,
16
+ * undefined는 초기화한다.
17
+ */
18
+ export declare function setErrorOutput(target?: Writable | null): void;
@@ -0,0 +1,61 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.setErrorOutput = exports.err = void 0;
4
+ const node_stream_1 = require("node:stream");
5
+ const native_1 = require("../internal/native");
6
+ let stream;
7
+ let listening = false;
8
+ function drainBeforeExit() {
9
+ native_1.native.flushErrorOutput();
10
+ }
11
+ /**
12
+ * A singleton Writable whose bytes are written to the actual SFML stream.
13
+ * @zh 单例 Writable,其字节写入实际的 SFML 流。
14
+ * @ja 書き込んだバイトが実際の SFML ストリームに渡されるシングルトン Writable。
15
+ * @ko 바이트가 실제 SFML 스트림에 기록되는 싱글턴 Writable.
16
+ */
17
+ function err() {
18
+ stream ?? (stream = new node_stream_1.Writable({
19
+ write(chunk, _encoding, complete) {
20
+ try {
21
+ native_1.native.writeError(chunk);
22
+ }
23
+ catch (error) {
24
+ complete(error);
25
+ return;
26
+ }
27
+ complete();
28
+ },
29
+ }));
30
+ return stream;
31
+ }
32
+ exports.err = err;
33
+ /**
34
+ * Process-wide SFML output: Writable redirects, null mutes, undefined resets.
35
+ * @zh 进程级 SFML 输出:Writable 重定向,null 静默,undefined 重置。
36
+ * @ja プロセス全体の SFML 出力。Writable で転送、null で抑止、
37
+ * undefined でリセットする。
38
+ * @ko 프로세스 전체 SFML 출력. Writable은 리디렉션, null은 출력 차단,
39
+ * undefined는 초기화한다.
40
+ */
41
+ function setErrorOutput(target) {
42
+ if (target !== undefined && target !== null) {
43
+ if (!(target instanceof node_stream_1.Writable) || target === stream) {
44
+ throw new TypeError('Expected a Writable other than err()');
45
+ }
46
+ if (target.destroyed || target.writableEnded) {
47
+ throw new TypeError('Expected an open Writable');
48
+ }
49
+ // Native retains this destination until all bytes captured for it drain.
50
+ // Buffers can split UTF-8 sequences; consumers decode them as a byte stream.
51
+ native_1.native.setErrorOutput((bytes) => { target.write(bytes); });
52
+ if (!listening) {
53
+ process.on('beforeExit', drainBeforeExit);
54
+ listening = true;
55
+ }
56
+ }
57
+ else {
58
+ native_1.native.setErrorOutput(target);
59
+ }
60
+ }
61
+ exports.setErrorOutput = setErrorOutput;
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Runtime failure reported by the SFML binding.
3
+ * @zh SFML 绑定报告的运行时错误。
4
+ * @ja SFML バインディングが報告する実行時エラー。
5
+ * @ko SFML 바인딩이 보고하는 런타임 오류.
6
+ */
7
+ export declare class SFMLError extends Error {
8
+ /**
9
+ * Create an SFML runtime error with message as the error description.
10
+ * @zh 创建 SFML 运行时错误,message 为错误描述。
11
+ * @ja message をエラー説明とする SFML 実行時エラーを作成する。
12
+ * @ko message를 오류 설명으로 하는 SFML 런타임 오류를 생성한다.
13
+ */
14
+ constructor(message?: string);
15
+ }
@@ -0,0 +1,22 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SFMLError = void 0;
4
+ /**
5
+ * Runtime failure reported by the SFML binding.
6
+ * @zh SFML 绑定报告的运行时错误。
7
+ * @ja SFML バインディングが報告する実行時エラー。
8
+ * @ko SFML 바인딩이 보고하는 런타임 오류.
9
+ */
10
+ class SFMLError extends Error {
11
+ /**
12
+ * Create an SFML runtime error with message as the error description.
13
+ * @zh 创建 SFML 运行时错误,message 为错误描述。
14
+ * @ja message をエラー説明とする SFML 実行時エラーを作成する。
15
+ * @ko message를 오류 설명으로 하는 SFML 런타임 오류를 생성한다.
16
+ */
17
+ constructor(message) {
18
+ super(message);
19
+ this.name = 'SFMLError';
20
+ }
21
+ }
22
+ exports.SFMLError = SFMLError;
@@ -0,0 +1,68 @@
1
+ import { InputStream } from './input-stream';
2
+ /**
3
+ * Seekable asynchronous file input that reads directly into caller buffers.
4
+ * @zh 可寻址的异步文件输入,直接读取到调用者的缓冲区。
5
+ * @ja 呼び出し元のバッファへ直接読み込む、シーク可能な非同期ファイル入力。
6
+ * @ko 호출자의 버퍼로 직접 읽는 탐색 가능한 비동기 파일 입력.
7
+ */
8
+ export declare class FileInputStream extends InputStream {
9
+ private file?;
10
+ private position;
11
+ private pending;
12
+ /**
13
+ * Replaces the current file; an I/O failure leaves the stream closed.
14
+ * @zh 替换当前文件;I/O 失败时流保持关闭状态。
15
+ * @ja 現在のファイルを置き換える。I/O 失敗時はストリームが閉じた状態になる。
16
+ * @ko 현재 파일을 교체한다. I/O 실패 시 스트림은 닫힌 상태가 된다.
17
+ */
18
+ open(filename: string): Promise<boolean>;
19
+ /**
20
+ * Read asynchronously into data and advance the position; return the byte
21
+ * count, 0n at EOF, or undefined on failure or if not open.
22
+ * @zh 异步读取到 data 并推进位置;返回字节数,文件末尾为 0n,
23
+ * 失败或未打开为 undefined。
24
+ * @ja data へ非同期で読み込み、位置を進める。バイト数を返し、ファイル末尾では
25
+ * 0n、失敗時または未オープン時は undefined を返す。
26
+ * @ko data로 비동기 읽기 후 위치를 이동한다. 바이트 수를 반환하며 파일 끝에서는
27
+ * 0n, 실패하거나 열리지 않은 경우 undefined를 반환한다.
28
+ */
29
+ read(data: Uint8Array): Promise<bigint | undefined>;
30
+ /**
31
+ * Set the absolute byte position (0 to 2^53−1) in operation order and
32
+ * return the new position; return undefined if not open.
33
+ * @zh 按顺序设置绝对字节位置(0~2^53−1),返回新位置;
34
+ * 未打开返回 undefined。
35
+ * @ja 操作順に絶対バイト位置(0~2^53−1)を設定して新しい位置を返す。
36
+ * 未オープン時は undefined を返す。
37
+ * @ko 작업 순서에 따라 절대 바이트 위치(0~2^53−1)를 설정하고 새 위치를 반환한다.
38
+ * 열리지 않은 경우 undefined를 반환한다.
39
+ */
40
+ seek(position: bigint): Promise<bigint | undefined>;
41
+ /**
42
+ * Wait for earlier operations, then return the current byte position;
43
+ * return undefined if not open.
44
+ * @zh 等待之前的操作完成后返回当前字节位置;未打开返回 undefined。
45
+ * @ja 先行する操作の完了を待ち、現在のバイト位置を返す。
46
+ * 未オープン時は undefined を返す。
47
+ * @ko 이전 작업이 완료되면 현재 바이트 위치를 반환한다.
48
+ * 열리지 않은 경우 undefined를 반환한다.
49
+ */
50
+ tell(): Promise<bigint | undefined>;
51
+ /**
52
+ * Return the file's byte count asynchronously; return undefined on failure
53
+ * or if not open.
54
+ * @zh 异步返回文件字节数;失败或未打开返回 undefined。
55
+ * @ja ファイルのバイト数を非同期で返す。失敗時や未オープン時は undefined。
56
+ * @ko 파일의 바이트 수를 비동기로 반환한다. 실패하거나 열리지 않으면 undefined.
57
+ */
58
+ getSize(): Promise<bigint | undefined>;
59
+ /**
60
+ * Waits for earlier operations; repeated closes are harmless.
61
+ * @zh 等待之前的操作完成;重复关闭无害。
62
+ * @ja 先行する操作の完了を待つ。繰り返し閉じても問題ない。
63
+ * @ko 이전 작업의 완료를 기다린다. 반복해서 닫아도 문제없다.
64
+ */
65
+ close(): Promise<void>;
66
+ private closeFile;
67
+ private enqueue;
68
+ }
@@ -0,0 +1,148 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.FileInputStream = void 0;
4
+ const node_fs_1 = require("node:fs");
5
+ const promises_1 = require("node:fs/promises");
6
+ const node_path_1 = require("node:path");
7
+ const input_stream_1 = require("./input-stream");
8
+ /**
9
+ * Seekable asynchronous file input that reads directly into caller buffers.
10
+ * @zh 可寻址的异步文件输入,直接读取到调用者的缓冲区。
11
+ * @ja 呼び出し元のバッファへ直接読み込む、シーク可能な非同期ファイル入力。
12
+ * @ko 호출자의 버퍼로 직접 읽는 탐색 가능한 비동기 파일 입력.
13
+ */
14
+ class FileInputStream extends input_stream_1.InputStream {
15
+ constructor() {
16
+ super(...arguments);
17
+ this.position = 0;
18
+ this.pending = Promise.resolve();
19
+ }
20
+ /**
21
+ * Replaces the current file; an I/O failure leaves the stream closed.
22
+ * @zh 替换当前文件;I/O 失败时流保持关闭状态。
23
+ * @ja 現在のファイルを置き換える。I/O 失敗時はストリームが閉じた状態になる。
24
+ * @ko 현재 파일을 교체한다. I/O 실패 시 스트림은 닫힌 상태가 된다.
25
+ */
26
+ open(filename) {
27
+ if (typeof filename !== 'string' || filename.includes('\0')) {
28
+ throw new TypeError('Expected a file path without null bytes');
29
+ }
30
+ const path = (0, node_path_1.resolve)(filename);
31
+ return this.enqueue(async () => {
32
+ await this.closeFile();
33
+ try {
34
+ this.file = await (0, promises_1.open)(path, 'r');
35
+ return true;
36
+ }
37
+ catch {
38
+ return false;
39
+ }
40
+ });
41
+ }
42
+ /**
43
+ * Read asynchronously into data and advance the position; return the byte
44
+ * count, 0n at EOF, or undefined on failure or if not open.
45
+ * @zh 异步读取到 data 并推进位置;返回字节数,文件末尾为 0n,
46
+ * 失败或未打开为 undefined。
47
+ * @ja data へ非同期で読み込み、位置を進める。バイト数を返し、ファイル末尾では
48
+ * 0n、失敗時または未オープン時は undefined を返す。
49
+ * @ko data로 비동기 읽기 후 위치를 이동한다. 바이트 수를 반환하며 파일 끝에서는
50
+ * 0n, 실패하거나 열리지 않은 경우 undefined를 반환한다.
51
+ */
52
+ read(data) {
53
+ if (!(data instanceof Uint8Array)) {
54
+ throw new TypeError('Expected a Uint8Array');
55
+ }
56
+ return this.enqueue(() => {
57
+ const file = this.file;
58
+ if (!file)
59
+ return undefined;
60
+ if (!Number.isSafeInteger(this.position + data.byteLength)) {
61
+ throw new RangeError('Read exceeds Node filesystem offset precision');
62
+ }
63
+ // FileHandle owns the fd; the queue retains it until this read finishes.
64
+ return new Promise(resolve => {
65
+ (0, node_fs_1.read)(file.fd, data, 0, data.byteLength, this.position, (error, bytesRead) => {
66
+ if (error)
67
+ return resolve(undefined);
68
+ this.position += bytesRead;
69
+ resolve(BigInt(bytesRead));
70
+ });
71
+ });
72
+ });
73
+ }
74
+ /**
75
+ * Set the absolute byte position (0 to 2^53−1) in operation order and
76
+ * return the new position; return undefined if not open.
77
+ * @zh 按顺序设置绝对字节位置(0~2^53−1),返回新位置;
78
+ * 未打开返回 undefined。
79
+ * @ja 操作順に絶対バイト位置(0~2^53−1)を設定して新しい位置を返す。
80
+ * 未オープン時は undefined を返す。
81
+ * @ko 작업 순서에 따라 절대 바이트 위치(0~2^53−1)를 설정하고 새 위치를 반환한다.
82
+ * 열리지 않은 경우 undefined를 반환한다.
83
+ */
84
+ seek(position) {
85
+ if (typeof position !== 'bigint' || position < 0n ||
86
+ position > BigInt(Number.MAX_SAFE_INTEGER)) {
87
+ throw new RangeError('Expected an offset from 0 to 2^53 - 1');
88
+ }
89
+ return this.enqueue(() => {
90
+ if (!this.file)
91
+ return undefined;
92
+ this.position = Number(position);
93
+ return position;
94
+ });
95
+ }
96
+ /**
97
+ * Wait for earlier operations, then return the current byte position;
98
+ * return undefined if not open.
99
+ * @zh 等待之前的操作完成后返回当前字节位置;未打开返回 undefined。
100
+ * @ja 先行する操作の完了を待ち、現在のバイト位置を返す。
101
+ * 未オープン時は undefined を返す。
102
+ * @ko 이전 작업이 완료되면 현재 바이트 위치를 반환한다.
103
+ * 열리지 않은 경우 undefined를 반환한다.
104
+ */
105
+ tell() {
106
+ return this.enqueue(() => (this.file ? BigInt(this.position) : undefined));
107
+ }
108
+ /**
109
+ * Return the file's byte count asynchronously; return undefined on failure
110
+ * or if not open.
111
+ * @zh 异步返回文件字节数;失败或未打开返回 undefined。
112
+ * @ja ファイルのバイト数を非同期で返す。失敗時や未オープン時は undefined。
113
+ * @ko 파일의 바이트 수를 비동기로 반환한다. 실패하거나 열리지 않으면 undefined.
114
+ */
115
+ getSize() {
116
+ return this.enqueue(async () => {
117
+ if (!this.file)
118
+ return undefined;
119
+ try {
120
+ return (await this.file.stat({ bigint: true })).size;
121
+ }
122
+ catch {
123
+ return undefined;
124
+ }
125
+ });
126
+ }
127
+ /**
128
+ * Waits for earlier operations; repeated closes are harmless.
129
+ * @zh 等待之前的操作完成;重复关闭无害。
130
+ * @ja 先行する操作の完了を待つ。繰り返し閉じても問題ない。
131
+ * @ko 이전 작업의 완료를 기다린다. 반복해서 닫아도 문제없다.
132
+ */
133
+ close() {
134
+ return this.enqueue(() => this.closeFile());
135
+ }
136
+ async closeFile() {
137
+ const file = this.file;
138
+ this.file = undefined;
139
+ this.position = 0;
140
+ await file?.close();
141
+ }
142
+ enqueue(operation) {
143
+ const result = this.pending.then(operation);
144
+ this.pending = result.then(() => { }, () => { });
145
+ return result;
146
+ }
147
+ }
148
+ exports.FileInputStream = FileInputStream;
@@ -0,0 +1,114 @@
1
+ /**
2
+ * undefined reports an I/O failure; throws and rejected promises reject
3
+ * loading.
4
+ * @zh undefined 表示 I/O 失败;抛出异常或返回被拒绝的 Promise
5
+ * 会使加载操作的 Promise 被拒绝。
6
+ * @ja undefined は I/O 失敗を示す。例外のスローや拒否された Promise の返却により、
7
+ * 読み込み操作の Promise も拒否される。
8
+ * @ko undefined는 I/O 실패를 나타낸다. 예외를 던지거나 거부된 Promise를 반환하면
9
+ * 로드 작업의 Promise도 거부된다.
10
+ */
11
+ export type StreamResult = bigint | undefined | Promise<bigint | undefined>;
12
+ /**
13
+ * Seekable input. Each operation may complete synchronously or asynchronously.
14
+ * @zh 可寻址的输入。每项操作均可同步或异步完成。
15
+ * @ja シーク可能な入力。各操作は同期または非同期で完了できる。
16
+ * @ko 탐색 가능한 입력. 각 작업은 동기 또는 비동기로 완료될 수 있다.
17
+ */
18
+ export declare abstract class InputStream {
19
+ /**
20
+ * Fill data and advance the cursor; return the count, or 0n at EOF.
21
+ * @zh 填充 data 并推进游标;返回读取数量,流末尾返回 0n。
22
+ * @ja data に読み込んでカーソルを進める。読み込み数を返し、EOF では 0n を返す。
23
+ * @ko data를 채우고 커서를 이동한다. 읽은 수를 반환하며 EOF에서는 0n을 반환한다.
24
+ */
25
+ abstract read(data: Uint8Array): StreamResult;
26
+ /**
27
+ * Seek to a byte position from the stream's start and return the actual
28
+ * position; return undefined on failure.
29
+ * @zh 移动到从流起点计算的字节位置,返回实际位置;失败返回 undefined。
30
+ * @ja ストリーム先頭からのバイト位置へ移動し、実際の位置を返す。
31
+ * 失敗時は undefined を返す。
32
+ * @ko 스트림 시작점 기준 바이트 위치로 이동하고 실제 위치를 반환한다.
33
+ * 실패 시 undefined를 반환한다.
34
+ */
35
+ abstract seek(position: bigint): StreamResult;
36
+ /**
37
+ * Return the current byte position, or undefined on failure.
38
+ * @zh 返回当前字节位置;失败返回 undefined。
39
+ * @ja 現在のバイト位置を返す。失敗時は undefined を返す。
40
+ * @ko 현재 바이트 위치를 반환한다. 실패 시 undefined를 반환한다.
41
+ */
42
+ abstract tell(): StreamResult;
43
+ /**
44
+ * Return the stream's total byte count, or undefined on failure.
45
+ * @zh 返回流的总字节数;失败返回 undefined。
46
+ * @ja ストリームの総バイト数を返す。失敗時は undefined を返す。
47
+ * @ko 스트림의 총 바이트 수를 반환한다. 실패 시 undefined를 반환한다.
48
+ */
49
+ abstract getSize(): StreamResult;
50
+ }
51
+ /**
52
+ * Retains the supplied bytes without copying them.
53
+ * @zh 保留所提供的字节,不进行复制。
54
+ * @ja 渡されたバイト列をコピーせずに保持する。
55
+ * @ko 제공된 바이트를 복사하지 않고 유지한다.
56
+ */
57
+ export declare class MemoryInputStream extends InputStream {
58
+ private data?;
59
+ private position;
60
+ /**
61
+ * Create a memory stream; retain data by reference if supplied, so reads
62
+ * observe subsequent byte modifications.
63
+ * @zh 创建内存流;提供 data 时保留其引用,读取可见后续字节修改。
64
+ * @ja メモリストリームを作成する。data があれば参照を保持し、
65
+ * 以降のバイト変更は読み取りに反映される。
66
+ * @ko 메모리 스트림을 생성한다. data가 주어지면 참조를 유지하므로
67
+ * 이후의 바이트 변경이 읽기에 반영된다.
68
+ */
69
+ constructor(data?: Uint8Array);
70
+ /**
71
+ * Retain data by reference and reset the read position to zero without
72
+ * copying bytes.
73
+ * @zh 保留 data 的引用并将读取位置重置为零,不复制字节。
74
+ * @ja バイト列をコピーせずに data の参照を保持し、読み取り位置をゼロに戻す。
75
+ * @ko 바이트를 복사하지 않고 data의 참조를 유지하며 읽기 위치를 0으로 초기화한다.
76
+ */
77
+ open(data: Uint8Array): void;
78
+ /**
79
+ * Read into destination and advance the position; return the byte count,
80
+ * 0n at the end of the stream, or undefined if not open.
81
+ * @zh 读取到 destination 并推进位置,返回字节数;流末尾返回 0n,
82
+ * 未打开返回 undefined。
83
+ * @ja destination に読み込んで位置を進め、バイト数を返す。
84
+ * ストリーム末尾では 0n、未オープン時は undefined を返す。
85
+ * @ko destination으로 읽고 위치를 이동한 뒤 바이트 수를 반환한다.
86
+ * 스트림 끝에서는 0n, 열리지 않은 경우 undefined를 반환한다.
87
+ */
88
+ read(destination: Uint8Array): bigint | undefined;
89
+ /**
90
+ * Set a non-negative byte position, clamped to the end of the stream;
91
+ * return the actual position, or undefined if not open.
92
+ * @zh 设置非负字节位置,超出长度时停在流末尾;返回实际位置,
93
+ * 未打开返回 undefined。
94
+ * @ja 非負のバイト位置を設定し、長さを超えた場合はストリーム末尾に留める。
95
+ * 実際の位置を返す。未オープン時は undefined を返す。
96
+ * @ko 음이 아닌 바이트 위치를 설정하며 길이를 초과하면 스트림 끝에 멈춘다.
97
+ * 실제 위치를 반환하고 열리지 않은 경우 undefined를 반환한다.
98
+ */
99
+ seek(position: bigint): bigint | undefined;
100
+ /**
101
+ * Return the current byte position, or undefined if not open.
102
+ * @zh 返回当前字节位置;未打开返回 undefined。
103
+ * @ja 現在のバイト位置を返す。未オープン時は undefined を返す。
104
+ * @ko 현재 바이트 위치를 반환한다. 열리지 않은 경우 undefined를 반환한다.
105
+ */
106
+ tell(): bigint | undefined;
107
+ /**
108
+ * Return the byte length of the memory data, or undefined if not open.
109
+ * @zh 返回内存数据的字节长度;未打开返回 undefined。
110
+ * @ja メモリデータのバイト長を返す。未オープン時は undefined を返す。
111
+ * @ko 메모리 데이터의 바이트 길이를 반환한다. 열리지 않으면 undefined를 반환한다.
112
+ */
113
+ getSize(): bigint | undefined;
114
+ }