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,132 @@
1
+ import { Socket } from './socket';
2
+ import { type NetworkTime } from './common';
3
+ /**
4
+ * Socket readiness conditions, combinable as bit flags.
5
+ * @zh 套接字就绪条件,可按位组合。
6
+ * @ja ビット単位で組み合わせ可能なソケットの準備状態。
7
+ * @ko 비트 플래그로 조합할 수 있는 소켓 준비 조건.
8
+ */
9
+ export declare enum ReadinessType {
10
+ /**
11
+ * Data, a connection, or a disconnection is available for receive handling.
12
+ * @zh 有数据、连接或断开状态可供读取处理。
13
+ * @ja 受信処理用のデータ、接続、または切断状態があります。
14
+ * @ko 수신 처리할 데이터, 연결 또는 연결 해제 상태가 있습니다.
15
+ */
16
+ Receive = 1,
17
+ /**
18
+ * The transport can currently accept writes.
19
+ * @zh 传输层当前可接受写入。
20
+ * @ja トランスポートが現在書き込みを受け付けられます。
21
+ * @ko 전송 계층이 현재 쓰기를 허용할 수 있습니다.
22
+ */
23
+ Send = 2
24
+ }
25
+ /**
26
+ * Receive the readiness bit flags obtained by this wait.
27
+ * @zh 接收本次 wait 得到的就绪位标志。
28
+ * @ja 今回の wait で取得した準備状態のビットフラグを受け取ります。
29
+ * @ko 이번 wait에서 얻은 준비 상태 비트 플래그를 받습니다.
30
+ */
31
+ export type ReadyCallback = (readiness: number) => void;
32
+ /**
33
+ * Wait asynchronously for a set of sockets to become ready,
34
+ * retaining the results of the latest wait.
35
+ * @zh 异步等待一组套接字就绪,并保存最近一次 wait 的结果。
36
+ * @ja ソケット群の準備完了を非同期に待ち、直近の wait の結果を保持します。
37
+ * @ko 소켓 집합이 준비될 때까지 비동기로 기다리고 최근 wait 결과를 보관합니다.
38
+ */
39
+ export declare class SocketSelector {
40
+ /**
41
+ * Receive-ready bit flag.
42
+ * @zh 可接收位标志。
43
+ * @ja 受信準備完了のビットフラグ。
44
+ * @ko 수신 준비 비트 플래그.
45
+ */
46
+ static readonly Receive = ReadinessType.Receive;
47
+ /**
48
+ * Send-ready bit flag.
49
+ * @zh 可发送位标志。
50
+ * @ja 送信準備完了のビットフラグ。
51
+ * @ko 송신 준비 비트 플래그.
52
+ */
53
+ static readonly Send = ReadinessType.Send;
54
+ private entries;
55
+ private ready;
56
+ private waiting;
57
+ private cancel?;
58
+ /**
59
+ * Create an empty selector or copy registrations, callbacks,
60
+ * and the readiness snapshot.
61
+ * @zh 创建空选择器,或复制注册集合、回调和就绪快照。
62
+ * @ja 空のセレクターを作成するか、登録集合、コールバック、
63
+ * 準備状態のスナップショットをコピーします。
64
+ * @ko 빈 선택기를 생성하거나 등록 집합, 콜백 및 준비 상태 스냅샷을 복사합니다.
65
+ */
66
+ constructor(source?: SocketSelector);
67
+ /**
68
+ * Copy another selector's registrations and snapshot, returning this.
69
+ * No wait may currently be pending.
70
+ * @zh 复制另一个选择器的集合和快照,返回 this;当前不得有待完成的 wait。
71
+ * @ja 別のセレクターの集合とスナップショットをコピーし、this を返します。
72
+ * 現在処理中の wait があってはなりません。
73
+ * @ko 다른 선택기의 등록 집합과 스냅샷을 복사하고 this를 반환합니다.
74
+ * 현재 대기 중인 wait가 없어야 합니다.
75
+ */
76
+ assign(source: SocketSelector): this;
77
+ /**
78
+ * Register a live socket and readiness conditions; return false for duplicate
79
+ * or unopened sockets. Callbacks require explicit dispatch.
80
+ * @zh 注册活动套接字及就绪条件;重复或未打开返回 false,回调需显式 dispatch。
81
+ * @ja 有効なソケットと準備条件を登録します。重複または未オープンなら false を
82
+ * 返し、コールバックには明示的な dispatch が必要です。
83
+ * @ko 활성 소켓과 준비 조건을 등록합니다. 중복되거나 열리지 않았으면 false를
84
+ * 반환하며 콜백은 명시적으로 dispatch해야 합니다.
85
+ */
86
+ add(socket: Socket, readiness?: ReadinessType, callback?: ReadyCallback): boolean;
87
+ /**
88
+ * Remove a socket and its readiness results, returning whether it was
89
+ * registered; wake any pending wait.
90
+ * @zh 移除套接字及就绪结果,返回此前是否注册;唤醒待完成的 wait。
91
+ * @ja ソケットと準備結果を削除し、登録済みだったかどうかを返します。
92
+ * 処理中の wait を起こします。
93
+ * @ko 소켓과 준비 결과를 제거하고 이전 등록 여부를 반환합니다.
94
+ * 대기 중인 wait를 깨웁니다.
95
+ */
96
+ remove(socket: Socket): boolean;
97
+ /**
98
+ * Clear registrations and readiness results, waking any pending wait.
99
+ * @zh 清空注册及就绪结果,并唤醒待完成的 wait。
100
+ * @ja 登録と準備結果を消去し、処理中の wait を起こします。
101
+ * @ko 등록 및 준비 결과를 비우고 대기 중인 wait를 깨웁니다.
102
+ */
103
+ clear(): void;
104
+ /**
105
+ * Wait asynchronously and refresh the readiness snapshot.
106
+ * Time.Zero disables the timeout; return whether any entry is ready.
107
+ * Concurrent wait calls are not allowed.
108
+ * @zh 异步等待并刷新就绪快照;Time.Zero 不设超时,返回是否有就绪项,
109
+ * 不允许并发 wait。
110
+ * @ja 非同期に待機して準備状態のスナップショットを更新します。
111
+ * Time.Zero はタイムアウトなしで、準備済みの項目があるかを返します。
112
+ * wait の同時呼び出しはできません。
113
+ * @ko 비동기로 기다리고 준비 상태 스냅샷을 갱신합니다.
114
+ * Time.Zero는 제한 시간이 없으며 준비된 항목이 있는지 반환합니다.
115
+ * wait 동시 호출은 허용하지 않습니다.
116
+ */
117
+ wait(timeout?: NetworkTime): Promise<boolean>;
118
+ /**
119
+ * Check whether the latest wait snapshot contains the given readiness.
120
+ * @zh 查询最近一次 wait 快照中是否含有指定就绪条件。
121
+ * @ja 直近の wait のスナップショットに指定の準備条件が含まれるか確認します。
122
+ * @ko 최근 wait 스냅샷에 지정한 준비 조건이 있는지 확인합니다.
123
+ */
124
+ isReady(socket: Socket, readiness?: ReadinessType): boolean;
125
+ /**
126
+ * Synchronously call registered callbacks for ready entries in the last wait.
127
+ * @zh 同步调用最近一次 wait 中就绪项的已注册回调。
128
+ * @ja 直近の wait で準備済みの項目の登録コールバックを同期的に呼び出します。
129
+ * @ko 최근 wait에서 준비된 항목의 등록된 콜백을 동기적으로 호출합니다.
130
+ */
131
+ dispatchReadyCallbacks(): void;
132
+ }
@@ -0,0 +1,214 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SocketSelector = exports.ReadinessType = void 0;
4
+ const node_events_1 = require("node:events");
5
+ const socket_1 = require("./socket");
6
+ const time_1 = require("../system/time");
7
+ const common_1 = require("./common");
8
+ /**
9
+ * Socket readiness conditions, combinable as bit flags.
10
+ * @zh 套接字就绪条件,可按位组合。
11
+ * @ja ビット単位で組み合わせ可能なソケットの準備状態。
12
+ * @ko 비트 플래그로 조합할 수 있는 소켓 준비 조건.
13
+ */
14
+ var ReadinessType;
15
+ (function (ReadinessType) {
16
+ /**
17
+ * Data, a connection, or a disconnection is available for receive handling.
18
+ * @zh 有数据、连接或断开状态可供读取处理。
19
+ * @ja 受信処理用のデータ、接続、または切断状態があります。
20
+ * @ko 수신 처리할 데이터, 연결 또는 연결 해제 상태가 있습니다.
21
+ */
22
+ ReadinessType[ReadinessType["Receive"] = 1] = "Receive";
23
+ /**
24
+ * The transport can currently accept writes.
25
+ * @zh 传输层当前可接受写入。
26
+ * @ja トランスポートが現在書き込みを受け付けられます。
27
+ * @ko 전송 계층이 현재 쓰기를 허용할 수 있습니다.
28
+ */
29
+ ReadinessType[ReadinessType["Send"] = 2] = "Send";
30
+ })(ReadinessType = exports.ReadinessType || (exports.ReadinessType = {}));
31
+ /**
32
+ * Wait asynchronously for a set of sockets to become ready,
33
+ * retaining the results of the latest wait.
34
+ * @zh 异步等待一组套接字就绪,并保存最近一次 wait 的结果。
35
+ * @ja ソケット群の準備完了を非同期に待ち、直近の wait の結果を保持します。
36
+ * @ko 소켓 집합이 준비될 때까지 비동기로 기다리고 최근 wait 결과를 보관합니다.
37
+ */
38
+ class SocketSelector {
39
+ /**
40
+ * Create an empty selector or copy registrations, callbacks,
41
+ * and the readiness snapshot.
42
+ * @zh 创建空选择器,或复制注册集合、回调和就绪快照。
43
+ * @ja 空のセレクターを作成するか、登録集合、コールバック、
44
+ * 準備状態のスナップショットをコピーします。
45
+ * @ko 빈 선택기를 생성하거나 등록 집합, 콜백 및 준비 상태 스냅샷을 복사합니다.
46
+ */
47
+ constructor(source) {
48
+ this.entries = new Map();
49
+ this.ready = new Map();
50
+ this.waiting = false;
51
+ if (source !== undefined)
52
+ this.assign(source);
53
+ }
54
+ /**
55
+ * Copy another selector's registrations and snapshot, returning this.
56
+ * No wait may currently be pending.
57
+ * @zh 复制另一个选择器的集合和快照,返回 this;当前不得有待完成的 wait。
58
+ * @ja 別のセレクターの集合とスナップショットをコピーし、this を返します。
59
+ * 現在処理中の wait があってはなりません。
60
+ * @ko 다른 선택기의 등록 집합과 스냅샷을 복사하고 this를 반환합니다.
61
+ * 현재 대기 중인 wait가 없어야 합니다.
62
+ */
63
+ assign(source) {
64
+ if (!(source instanceof SocketSelector)) {
65
+ throw new TypeError('Expected a SocketSelector');
66
+ }
67
+ if (source === this)
68
+ return this;
69
+ if (this.waiting)
70
+ throw new Error('Finish the pending wait before assigning');
71
+ this.entries = new Map(source.entries);
72
+ this.ready = new Map(source.ready);
73
+ return this;
74
+ }
75
+ /**
76
+ * Register a live socket and readiness conditions; return false for duplicate
77
+ * or unopened sockets. Callbacks require explicit dispatch.
78
+ * @zh 注册活动套接字及就绪条件;重复或未打开返回 false,回调需显式 dispatch。
79
+ * @ja 有効なソケットと準備条件を登録します。重複または未オープンなら false を
80
+ * 返し、コールバックには明示的な dispatch が必要です。
81
+ * @ko 활성 소켓과 준비 조건을 등록합니다. 중복되거나 열리지 않았으면 false를
82
+ * 반환하며 콜백은 명시적으로 dispatch해야 합니다.
83
+ */
84
+ add(socket, readiness = ReadinessType.Receive, callback) {
85
+ if (!(socket instanceof socket_1.Socket))
86
+ throw new TypeError('Expected a Socket');
87
+ (0, common_1.uint)(readiness, 3);
88
+ if (!readiness)
89
+ throw new RangeError('Expected Receive and/or Send');
90
+ if (callback !== undefined && typeof callback !== 'function') {
91
+ throw new TypeError('Expected a callback');
92
+ }
93
+ if (!socket[socket_1.socketAlive]() || this.entries.has(socket))
94
+ return false;
95
+ this.entries.set(socket, { mask: readiness, callback });
96
+ this.cancel?.abort();
97
+ return true;
98
+ }
99
+ /**
100
+ * Remove a socket and its readiness results, returning whether it was
101
+ * registered; wake any pending wait.
102
+ * @zh 移除套接字及就绪结果,返回此前是否注册;唤醒待完成的 wait。
103
+ * @ja ソケットと準備結果を削除し、登録済みだったかどうかを返します。
104
+ * 処理中の wait を起こします。
105
+ * @ko 소켓과 준비 결과를 제거하고 이전 등록 여부를 반환합니다.
106
+ * 대기 중인 wait를 깨웁니다.
107
+ */
108
+ remove(socket) {
109
+ this.ready.delete(socket);
110
+ const removed = this.entries.delete(socket);
111
+ this.cancel?.abort();
112
+ return removed;
113
+ }
114
+ /**
115
+ * Clear registrations and readiness results, waking any pending wait.
116
+ * @zh 清空注册及就绪结果,并唤醒待完成的 wait。
117
+ * @ja 登録と準備結果を消去し、処理中の wait を起こします。
118
+ * @ko 등록 및 준비 결과를 비우고 대기 중인 wait를 깨웁니다.
119
+ */
120
+ clear() {
121
+ this.entries.clear();
122
+ this.ready.clear();
123
+ this.cancel?.abort();
124
+ }
125
+ /**
126
+ * Wait asynchronously and refresh the readiness snapshot.
127
+ * Time.Zero disables the timeout; return whether any entry is ready.
128
+ * Concurrent wait calls are not allowed.
129
+ * @zh 异步等待并刷新就绪快照;Time.Zero 不设超时,返回是否有就绪项,
130
+ * 不允许并发 wait。
131
+ * @ja 非同期に待機して準備状態のスナップショットを更新します。
132
+ * Time.Zero はタイムアウトなしで、準備済みの項目があるかを返します。
133
+ * wait の同時呼び出しはできません。
134
+ * @ko 비동기로 기다리고 준비 상태 스냅샷을 갱신합니다.
135
+ * Time.Zero는 제한 시간이 없으며 준비된 항목이 있는지 반환합니다.
136
+ * wait 동시 호출은 허용하지 않습니다.
137
+ */
138
+ async wait(timeout = time_1.Time.Zero) {
139
+ const milliseconds = (0, common_1.millisecondsOf)(timeout);
140
+ if (this.waiting)
141
+ throw new Error('A selector wait is already pending');
142
+ this.ready.clear();
143
+ if (!this.entries.size)
144
+ return false;
145
+ this.waiting = true;
146
+ this.cancel = new AbortController();
147
+ const events = new node_events_1.EventEmitter();
148
+ const notify = () => events.emit('change');
149
+ const sockets = [...this.entries.keys()];
150
+ for (const socket of sockets)
151
+ socket[socket_1.socketEvents].on('change', notify);
152
+ try {
153
+ await (0, common_1.waitFor)(events, () => {
154
+ let count = 0;
155
+ for (const [socket, entry] of this.entries) {
156
+ const mask = socket[socket_1.socketReady](entry.mask);
157
+ if (mask) {
158
+ this.ready.set(socket, mask);
159
+ count++;
160
+ }
161
+ else {
162
+ this.ready.delete(socket);
163
+ }
164
+ }
165
+ return count !== 0 || [...this.entries.keys()]
166
+ .every(socket => !socket[socket_1.socketAlive]());
167
+ }, milliseconds, this.cancel.signal);
168
+ return this.ready.size > 0;
169
+ }
170
+ finally {
171
+ for (const socket of sockets)
172
+ socket[socket_1.socketEvents].off('change', notify);
173
+ this.waiting = false;
174
+ this.cancel = undefined;
175
+ }
176
+ }
177
+ /**
178
+ * Check whether the latest wait snapshot contains the given readiness.
179
+ * @zh 查询最近一次 wait 快照中是否含有指定就绪条件。
180
+ * @ja 直近の wait のスナップショットに指定の準備条件が含まれるか確認します。
181
+ * @ko 최근 wait 스냅샷에 지정한 준비 조건이 있는지 확인합니다.
182
+ */
183
+ isReady(socket, readiness = ReadinessType.Receive) {
184
+ (0, common_1.uint)(readiness, 3);
185
+ // eslint-disable-next-line no-bitwise
186
+ return ((this.ready.get(socket) ?? 0) & readiness) !== 0;
187
+ }
188
+ /**
189
+ * Synchronously call registered callbacks for ready entries in the last wait.
190
+ * @zh 同步调用最近一次 wait 中就绪项的已注册回调。
191
+ * @ja 直近の wait で準備済みの項目の登録コールバックを同期的に呼び出します。
192
+ * @ko 최근 wait에서 준비된 항목의 등록된 콜백을 동기적으로 호출합니다.
193
+ */
194
+ dispatchReadyCallbacks() {
195
+ const callbacks = [...this.ready].map(([socket, mask]) => ({ callback: this.entries.get(socket)?.callback, mask }));
196
+ for (const { callback, mask } of callbacks)
197
+ callback?.(mask);
198
+ }
199
+ }
200
+ /**
201
+ * Receive-ready bit flag.
202
+ * @zh 可接收位标志。
203
+ * @ja 受信準備完了のビットフラグ。
204
+ * @ko 수신 준비 비트 플래그.
205
+ */
206
+ SocketSelector.Receive = ReadinessType.Receive;
207
+ /**
208
+ * Send-ready bit flag.
209
+ * @zh 可发送位标志。
210
+ * @ja 送信準備完了のビットフラグ。
211
+ * @ko 송신 준비 비트 플래그.
212
+ */
213
+ SocketSelector.Send = ReadinessType.Send;
214
+ exports.SocketSelector = SocketSelector;
@@ -0,0 +1,301 @@
1
+ /// <reference types="node" />
2
+ /// <reference types="node" />
3
+ /// <reference types="node" />
4
+ import { EventEmitter } from 'node:events';
5
+ import { Socket as TcpHandle, Server } from 'node:net';
6
+ import { Socket as UdpHandle } from 'node:dgram';
7
+ import { IpAddressType } from './ip-address';
8
+ /**
9
+ * Socket transport protocol, corresponding to sf::Socket::Type.
10
+ * @zh 套接字使用的传输协议,对应 sf::Socket::Type。
11
+ * @ja sf::Socket::Type に対応するソケットのトランスポートプロトコル。
12
+ * @ko sf::Socket::Type에 해당하는 소켓 전송 프로토콜.
13
+ */
14
+ export declare enum SocketType {
15
+ /**
16
+ * TCP byte-stream protocol.
17
+ * @zh TCP 字节流协议。
18
+ * @ja TCP バイトストリームプロトコル。
19
+ * @ko TCP 바이트 스트림 프로토콜.
20
+ */
21
+ Tcp = 0,
22
+ /**
23
+ * UDP datagram protocol.
24
+ * @zh UDP 数据报协议。
25
+ * @ja UDP データグラムプロトコル。
26
+ * @ko UDP 데이터그램 프로토콜.
27
+ */
28
+ Udp = 1
29
+ }
30
+ /**
31
+ * Socket operation result; blocking mode waits via Promise without blocking
32
+ * the Node event loop.
33
+ * @zh 套接字操作结果;阻塞模式通过 Promise 等待,不阻塞 Node 事件循环。
34
+ * @ja ソケット操作の結果。ブロッキングモードは Promise で待機し、
35
+ * Node のイベントループをブロックしません。
36
+ * @ko 소켓 작업 결과. 블로킹 모드는 Promise로 기다리며
37
+ * Node 이벤트 루프를 차단하지 않습니다.
38
+ */
39
+ export declare enum SocketStatus {
40
+ /**
41
+ * Operation complete.
42
+ * @zh 操作完成。
43
+ * @ja 操作が完了しました。
44
+ * @ko 작업이 완료되었습니다.
45
+ */
46
+ Done = 0,
47
+ /**
48
+ * No data or send capacity is available yet; retry later.
49
+ * @zh 暂无数据或发送空间,稍后重试。
50
+ * @ja データまたは送信容量がまだありません。後で再試行してください。
51
+ * @ko 아직 데이터나 송신 여유 공간이 없습니다. 나중에 다시 시도하세요.
52
+ */
53
+ NotReady = 1,
54
+ /**
55
+ * Only part of the data was sent; continue sending the remainder.
56
+ * @zh 仅发送了部分数据,需继续发送剩余部分。
57
+ * @ja データの一部のみを送信しました。残りを続けて送信してください。
58
+ * @ko 데이터 일부만 전송되었습니다. 나머지를 계속 전송해야 합니다.
59
+ */
60
+ Partial = 2,
61
+ /**
62
+ * The connection is closed.
63
+ * @zh 连接已断开。
64
+ * @ja 接続が切断されました。
65
+ * @ko 연결이 끊어졌습니다.
66
+ */
67
+ Disconnected = 3,
68
+ /**
69
+ * Operation failed; getLastError provides the underlying error.
70
+ * @zh 操作出错,可通过 getLastError 获取底层错误。
71
+ * @ja 操作が失敗しました。getLastError で下位層のエラーを取得できます。
72
+ * @ko 작업이 실패했습니다. getLastError로 하위 계층 오류를 확인할 수 있습니다.
73
+ */
74
+ Error = 4
75
+ }
76
+ /**
77
+ * Node TCP, UDP, or listener transport object; raw OS file descriptors
78
+ * are not accepted.
79
+ * @zh Node TCP、UDP 或监听传输对象,不接受操作系统裸文件描述符。
80
+ * @ja Node の TCP、UDP、またはリスナートランスポートオブジェクト。
81
+ * OS の生のファイル記述子は受け付けません。
82
+ * @ko Node TCP, UDP 또는 리스너 전송 객체.
83
+ * 운영 체제의 원시 파일 디스크립터는 허용하지 않습니다.
84
+ */
85
+ export type SocketHandle = TcpHandle | Server | UdpHandle;
86
+ export declare const socketEvents: unique symbol;
87
+ export declare const socketReady: unique symbol;
88
+ export declare const socketAlive: unique symbol;
89
+ /**
90
+ * Common base for Node network transports; defaults to blocking semantics
91
+ * implemented with asynchronous waits.
92
+ * @zh Node 网络传输的公共基类;默认使用异步等待的阻塞语义。
93
+ * @ja Node ネットワークトランスポートの共通基底クラス。
94
+ * 既定では非同期待機によるブロッキング動作を使います。
95
+ * @ko Node 네트워크 전송의 공통 기본 클래스.
96
+ * 기본적으로 비동기 대기로 구현한 블로킹 동작을 사용합니다.
97
+ */
98
+ export declare abstract class Socket {
99
+ private readonly type;
100
+ /**
101
+ * Socket operation status enumeration.
102
+ * @zh 套接字操作状态枚举。
103
+ * @ja ソケット操作状態の列挙型。
104
+ * @ko 소켓 작업 상태 열거형.
105
+ */
106
+ static readonly Status: typeof SocketStatus;
107
+ /**
108
+ * Socket transport protocol enumeration.
109
+ * @zh 套接字传输协议枚举。
110
+ * @ja ソケットトランスポートプロトコルの列挙型。
111
+ * @ko 소켓 전송 프로토콜 열거형.
112
+ */
113
+ static readonly Type: typeof SocketType;
114
+ /**
115
+ * Let the system assign an available port when binding.
116
+ * @zh 绑定端口时由系统自动分配可用端口。
117
+ * @ja バインド時にシステムが利用可能なポートを自動割り当てします。
118
+ * @ko 바인딩 시 시스템이 사용 가능한 포트를 자동 할당합니다.
119
+ */
120
+ static readonly AnyPort = 0;
121
+ readonly [socketEvents]: EventEmitter<[never]>;
122
+ protected blocking: boolean;
123
+ protected epoch: number;
124
+ protected failure?: Error;
125
+ /**
126
+ * Currently owned Node transport, released by Node on close or recreation.
127
+ * @zh 当前独占的 Node 传输,关闭或重建时由 Node 释放。
128
+ * @ja 現在排他的に所有する Node トランスポート。
129
+ * 閉じるか再作成すると Node が解放します。
130
+ * @ko 현재 독점 소유한 Node 전송 객체. 닫거나 재생성하면 Node가 해제합니다.
131
+ */
132
+ protected transport?: SocketHandle;
133
+ /**
134
+ * Remove event listeners from the current transport.
135
+ * @zh 移除当前传输的事件监听。
136
+ * @ja 現在のトランスポートのイベントリスナーを削除します。
137
+ * @ko 현재 전송 객체의 이벤트 리스너를 제거합니다.
138
+ */
139
+ protected detach?: () => void;
140
+ /**
141
+ * Initialize common socket state with blocking semantics enabled by default.
142
+ * @zh 初始化套接字公共状态,默认启用阻塞语义。
143
+ * @ja ソケットの共通状態を初期化します。既定でブロッキング動作が有効です。
144
+ * @ko 소켓 공통 상태를 초기화하며 기본적으로 블로킹 동작을 활성화합니다.
145
+ */
146
+ protected constructor(type?: SocketType);
147
+ /**
148
+ * Set whether to wait asynchronously for readability/writability.
149
+ * When false, return NotReady or Partial according to current queue state.
150
+ * @zh 设置是否异步等待可读/可写;false 时按当前队列状态返回 NotReady 或 Partial。
151
+ * @ja 読み書き可能になるまで非同期に待機するか設定します。
152
+ * false なら現在のキュー状態に応じて NotReady または Partial を返します。
153
+ * @ko 읽기/쓰기 가능 상태를 비동기로 기다릴지 설정합니다.
154
+ * false이면 현재 큐 상태에 따라 NotReady 또는 Partial을 반환합니다.
155
+ */
156
+ setBlocking(blocking: boolean): void;
157
+ /**
158
+ * Return whether blocking semantics use asynchronous waits.
159
+ * @zh 返回是否使用异步等待的阻塞语义。
160
+ * @ja 非同期待機によるブロッキング動作を使うかどうかを返します。
161
+ * @ko 비동기 대기를 통한 블로킹 동작을 사용하는지 반환합니다.
162
+ */
163
+ isBlocking(): boolean;
164
+ /**
165
+ * Return the latest underlying error, or undefined if none is recorded.
166
+ * @zh 返回最近的底层错误;未记录错误时为 undefined。
167
+ * @ja 最新の下位層のエラーを返し、記録がなければ undefined を返します。
168
+ * @ko 최근 하위 계층 오류를 반환하며 기록된 오류가 없으면 undefined입니다.
169
+ */
170
+ getLastError(): Error | undefined;
171
+ protected changed(): void;
172
+ protected awaitReady(check: () => boolean, generation: number): Promise<boolean>;
173
+ /**
174
+ * Expose overridable readiness conditions to Selector.
175
+ * @zh 供 Selector 读取子类可覆盖的就绪条件。
176
+ * @ja サブクラスで上書き可能な準備条件を Selector に公開します。
177
+ * @ko 하위 클래스에서 재정의할 수 있는 준비 조건을 Selector에 제공합니다.
178
+ */
179
+ [socketReady](mask: number): number;
180
+ /**
181
+ * Expose overridable liveness state to Selector.
182
+ * @zh 供 Selector 查询子类可覆盖的存活状态。
183
+ * @ja サブクラスで上書き可能な生存状態を Selector に公開します。
184
+ * @ko 하위 클래스에서 재정의할 수 있는 활성 상태를 Selector에 제공합니다.
185
+ */
186
+ [socketAlive](): boolean;
187
+ /**
188
+ * Provide subclasses with the underlying Node transport,
189
+ * or undefined if not yet created.
190
+ * @zh 供子类访问底层 Node 传输对象;未创建时为 undefined。
191
+ * @ja サブクラスに下位の Node トランスポートへのアクセスを提供します。
192
+ * 未作成なら undefined です。
193
+ * @ko 하위 클래스에 기반 Node 전송 객체 접근을 제공합니다.
194
+ * 아직 생성되지 않았으면 undefined입니다.
195
+ */
196
+ protected getNativeHandle(): SocketHandle | undefined;
197
+ /**
198
+ * Allocate a transport for the given address family without implicitly
199
+ * connecting or binding a port.
200
+ * @zh 分配指定地址族的传输,不隐式连接或绑定端口。
201
+ * @ja 指定ファミリーのトランスポートを割り当てます。
202
+ * 暗黙の接続やポートのバインドは行いません。
203
+ * @ko 지정한 주소 계열의 전송 객체를 할당합니다.
204
+ * 암묵적으로 연결하거나 포트를 바인딩하지 않습니다.
205
+ */
206
+ protected create(addressType?: IpAddressType): void;
207
+ /**
208
+ * Adopt a Node transport and close the old one; do not adopt raw
209
+ * file descriptors.
210
+ * @zh 接管 Node 传输并关闭旧传输;不接管裸文件描述符。
211
+ * @ja Node トランスポートを引き継ぎ、古いものを閉じます。
212
+ * 生のファイル記述子は引き継ぎません。
213
+ * @ko Node 전송 객체를 인수하고 기존 객체를 닫습니다.
214
+ * 원시 파일 디스크립터는 인수하지 않습니다.
215
+ */
216
+ protected create(handle: SocketHandle): void;
217
+ /**
218
+ * Close the current transport and wake waits from the previous generation.
219
+ * Repeated calls are safe; the blocking flag is unchanged.
220
+ * @zh 关闭当前传输并唤醒旧代际的等待;重复调用安全,阻塞标志不变。
221
+ * @ja 現在のトランスポートを閉じ、旧世代の待機を起こします。
222
+ * 繰り返し呼び出しても安全で、ブロッキングフラグは変わりません。
223
+ * @ko 현재 전송 객체를 닫고 이전 세대의 대기를 깨웁니다.
224
+ * 반복 호출해도 안전하며 블로킹 플래그는 유지됩니다.
225
+ */
226
+ protected close(): void;
227
+ /**
228
+ * Allocate an unconnected transport by protocol;
229
+ * listeners may override this to use a Node Server.
230
+ * @zh 按协议分配未连接传输;监听器可覆盖为 Node Server。
231
+ * @ja プロトコルに応じた未接続トランスポートを割り当てます。
232
+ * リスナーは上書きして Node Server を使用できます。
233
+ * @ko 프로토콜에 따라 연결되지 않은 전송 객체를 할당합니다.
234
+ * 리스너는 Node Server를 사용하도록 재정의할 수 있습니다.
235
+ */
236
+ protected allocateHandle(addressType: IpAddressType): SocketHandle;
237
+ /**
238
+ * Validate the transport type before adoption to avoid discovering
239
+ * a type error after closing the old connection.
240
+ * @zh 接管前验证传输类型,避免关闭旧连接后才发现类型错误。
241
+ * @ja 引き継ぐ前にトランスポートの型を検証し、古い接続を閉じた後で
242
+ * 型の誤りが判明することを防ぎます。
243
+ * @ko 기존 연결을 닫은 후에 타입 오류를 발견하지 않도록 인수 전에
244
+ * 전송 객체 타입을 검증합니다.
245
+ */
246
+ protected validateHandle(handle: SocketHandle): void;
247
+ /**
248
+ * Install default TCP/UDP/Server state listeners;
249
+ * subclasses may override this to manage their own send/receive queues.
250
+ * @zh 安装默认 TCP/UDP/Server 状态监听;子类可覆盖以管理自己的收发队列。
251
+ * @ja 既定の TCP/UDP/Server 状態リスナーを設定します。
252
+ * サブクラスは独自の送受信キューを管理するために上書きできます。
253
+ * @ko 기본 TCP/UDP/Server 상태 리스너를 설치합니다.
254
+ * 하위 클래스는 자체 송수신 큐를 관리하도록 재정의할 수 있습니다.
255
+ */
256
+ protected onCreate(): void;
257
+ /**
258
+ * Clean up subclass state on close; the old transport is already detached
259
+ * when this is called.
260
+ * @zh 关闭时清理子类状态,调用时旧传输已解除关联。
261
+ * @ja 閉じる際にサブクラスの状態を片付けます。
262
+ * 呼び出し時には古いトランスポートの関連付けは解除済みです。
263
+ * @ko 닫을 때 하위 클래스 상태를 정리합니다.
264
+ * 호출 시 기존 전송 객체의 연결 관계는 이미 해제되어 있습니다.
265
+ */
266
+ protected onClose(): void;
267
+ /**
268
+ * By default, check whether the Node transport is alive; subclasses may
269
+ * override this without importing internal symbols.
270
+ * @zh 默认查询 Node 传输是否存活;子类可覆盖,不需要导入内部 symbol。
271
+ * @ja 既定では Node トランスポートの生存状態を確認します。
272
+ * サブクラスは内部 symbol をインポートせずに上書きできます。
273
+ * @ko 기본적으로 Node 전송 객체의 활성 여부를 확인합니다.
274
+ * 하위 클래스는 내부 symbol을 가져오지 않고 재정의할 수 있습니다.
275
+ */
276
+ protected isAlive(): boolean;
277
+ /**
278
+ * By default, TCP readiness follows readable bytes and write backpressure;
279
+ * bound UDP sockets can send. Subclasses report UDP datagrams and Server
280
+ * connection queues to Selector through this hook and changed().
281
+ * @zh 默认 TCP 按可读字节和写入背压就绪,已绑定 UDP 可发送。
282
+ * UDP 数据报和 Server 连接队列由子类通过此钩子和 changed() 通知 Selector。
283
+ * @ja 既定では TCP の準備状態は読み取り可能バイトと書き込みバックプレッシャーに
284
+ * 従い、バインド済み UDP は送信可能です。サブクラスはこのフックと changed() で
285
+ * UDP データグラムと Server 接続キューを Selector に通知します。
286
+ * @ko 기본적으로 TCP 준비 상태는 읽을 수 있는 바이트와 쓰기 역압에 따르며,
287
+ * 바인딩된 UDP는 송신할 수 있습니다. 하위 클래스는 이 훅과 changed()로
288
+ * UDP 데이터그램 및 Server 연결 큐를 Selector에 알립니다.
289
+ */
290
+ protected getReadiness(mask: number): number;
291
+ /**
292
+ * Wait for a write or generation cancellation; closing does not depend on
293
+ * whether the underlying write callback fires.
294
+ * @zh 等待写操作或代际取消;关闭时不依赖底层写回调是否会触发。
295
+ * @ja 書き込みまたは世代のキャンセルを待ちます。閉じる際は下位層の
296
+ * 書き込みコールバックが発火するかどうかに依存しません。
297
+ * @ko 쓰기 또는 세대 취소를 기다립니다.
298
+ * 닫을 때 하위 쓰기 콜백의 실행 여부에 의존하지 않습니다.
299
+ */
300
+ protected awaitWrite(completion: Promise<SocketStatus>, generation: number): Promise<SocketStatus>;
301
+ }