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,493 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.TcpSocket = exports.adoptTcp = exports.TlsStatus = void 0;
4
+ const node_net_1 = require("node:net");
5
+ const node_tls_1 = require("node:tls");
6
+ const time_1 = require("../system/time");
7
+ const ip_address_1 = require("./ip-address");
8
+ const packet_1 = require("./packet");
9
+ const socket_1 = require("./socket");
10
+ const common_1 = require("./common");
11
+ const tls_material_1 = require("./tls-material");
12
+ /**
13
+ * Current TLS upgrade state.
14
+ * @zh TLS 升级的当前状态。
15
+ * @ja TLS アップグレードの現在の状態。
16
+ * @ko TLS 업그레이드의 현재 상태.
17
+ */
18
+ var TlsStatus;
19
+ (function (TlsStatus) {
20
+ /**
21
+ * No TLS connection is established.
22
+ * @zh 未建立 TLS 连接。
23
+ * @ja TLS 接続は確立されていません。
24
+ * @ko TLS 연결이 설정되지 않았습니다.
25
+ */
26
+ TlsStatus[TlsStatus["NotConnected"] = 0] = "NotConnected";
27
+ /**
28
+ * The handshake has started but is not complete.
29
+ * @zh 握手已开始但尚未完成。
30
+ * @ja ハンドシェイクは開始済みですが、未完了です。
31
+ * @ko 핸드셰이크가 시작되었지만 완료되지 않았습니다.
32
+ */
33
+ TlsStatus[TlsStatus["HandshakeStarted"] = 1] = "HandshakeStarted";
34
+ /**
35
+ * The handshake is complete; encrypted data can be transferred.
36
+ * @zh 握手完成,可以传输加密数据。
37
+ * @ja ハンドシェイクが完了し、暗号化データを転送できます。
38
+ * @ko 핸드셰이크가 완료되어 암호화된 데이터를 전송할 수 있습니다.
39
+ */
40
+ TlsStatus[TlsStatus["HandshakeComplete"] = 2] = "HandshakeComplete";
41
+ /**
42
+ * The handshake failed.
43
+ * @zh 握手失败。
44
+ * @ja ハンドシェイクが失敗しました。
45
+ * @ko 핸드셰이크가 실패했습니다.
46
+ */
47
+ TlsStatus[TlsStatus["Error"] = 3] = "Error";
48
+ })(TlsStatus = exports.TlsStatus || (exports.TlsStatus = {}));
49
+ exports.adoptTcp = Symbol('TcpSocket.adopt');
50
+ /**
51
+ * TCP socket supporting raw bytes, SFML Packet framing, and TLS upgrades.
52
+ * @zh 支持原始字节、SFML Packet 分帧和 TLS 升级的 TCP 套接字。
53
+ * @ja 生バイト、SFML Packet のフレーミング、TLS アップグレード対応の TCP ソケット。
54
+ * @ko 원시 바이트, SFML Packet 프레이밍 및 TLS 업그레이드를 지원하는 TCP 소켓.
55
+ */
56
+ class TcpSocket extends socket_1.Socket {
57
+ /**
58
+ * Create an unconnected TCP socket, using asynchronous blocking semantics
59
+ * by default.
60
+ * @zh 创建未连接的 TCP 套接字,默认使用异步阻塞语义。
61
+ * @ja 未接続の TCP ソケットを作成します。既定では非同期ブロッキング動作です。
62
+ * @ko 연결되지 않은 TCP 소켓을 생성하며 기본적으로 비동기 블로킹 동작을
63
+ * 사용합니다.
64
+ */
65
+ constructor() {
66
+ super(socket_1.SocketType.Tcp);
67
+ /** TCP 连接是否已建立。 */
68
+ this.connected = false;
69
+ /** 对端是否已关闭发送。 */
70
+ this.ended = true;
71
+ /** TLS 握手当前状态。 */
72
+ this.tlsStatus = TlsStatus.NotConnected;
73
+ /** 接收操作串行队列,保证分帧完整性。 */
74
+ this.reads = new common_1.SerialQueue();
75
+ /** 发送操作串行队列。 */
76
+ this.writes = new common_1.SerialQueue();
77
+ /** Packet 分帧的 4 字节长度前缀缓冲区。 */
78
+ this.prefix = Buffer.alloc(4);
79
+ /** 已累积的前缀字节数。 */
80
+ this.prefixSize = 0;
81
+ /** 已累积的包体分片。 */
82
+ this.packetChunks = [];
83
+ /** 已累积的包体字节数。 */
84
+ this.packetBytes = 0;
85
+ }
86
+ /**
87
+ * Return the local port, or 0 if not yet assigned.
88
+ * @zh 返回本地端口,尚未分配时为 0。
89
+ * @ja ローカルポートを返し、未割り当てなら 0 を返します。
90
+ * @ko 로컬 포트를 반환하며 아직 할당되지 않았으면 0입니다.
91
+ */
92
+ getLocalPort() { return this.transport?.localPort ?? 0; }
93
+ /**
94
+ * Return the peer address, or undefined when not connected.
95
+ * @zh 返回对端地址,未连接时为 undefined。
96
+ * @ja 相手のアドレスを返し、未接続なら undefined を返します。
97
+ * @ko 상대 주소를 반환하며 연결되지 않았으면 undefined입니다.
98
+ */
99
+ getRemoteAddress() {
100
+ const address = this.connected ? this.transport?.remoteAddress : undefined;
101
+ return address ? ip_address_1.IpAddress.fromString(address) : undefined;
102
+ }
103
+ /**
104
+ * Return the peer port, or 0 when not connected.
105
+ * @zh 返回对端端口,未连接时为 0。
106
+ * @ja 相手のポートを返し、未接続なら 0 を返します。
107
+ * @ko 상대 포트를 반환하며 연결되지 않았으면 0입니다.
108
+ */
109
+ getRemotePort() {
110
+ return this.connected ? this.transport?.remotePort ?? 0 : 0;
111
+ }
112
+ /**
113
+ * Start a TCP connection; wait for completion by default, or return NotReady
114
+ * in nonblocking mode. Time.Zero disables the timeout.
115
+ * @zh 发起 TCP 连接;默认等待完成,非阻塞模式返回 NotReady,
116
+ * Time.Zero 不设超时。
117
+ * @ja TCP 接続を開始します。既定では完了を待ち、非ブロッキングモードでは
118
+ * NotReady を返します。Time.Zero はタイムアウトなしです。
119
+ * @ko TCP 연결을 시작합니다. 기본적으로 완료를 기다리며 논블로킹 모드에서는
120
+ * NotReady를 반환합니다. Time.Zero는 제한 시간이 없습니다.
121
+ */
122
+ async connect(address, port, timeout = time_1.Time.Zero) {
123
+ if (!(address instanceof ip_address_1.IpAddress))
124
+ throw new TypeError('Expected IpAddress');
125
+ (0, common_1.uint)(port, 65535);
126
+ const milliseconds = (0, common_1.millisecondsOf)(timeout);
127
+ this.create(address.getType());
128
+ const generation = this.epoch;
129
+ const socket = this.transport;
130
+ let timer;
131
+ const done = (0, common_1.waitFor)(this[socket_1.socketEvents], () => this.connected || this.ended ||
132
+ this.epoch !== generation).then(() => {
133
+ if (timer)
134
+ clearTimeout(timer);
135
+ return this.epoch !== generation ? socket_1.SocketStatus.Disconnected
136
+ : this.connected ? socket_1.SocketStatus.Done : socket_1.SocketStatus.Error;
137
+ });
138
+ if (milliseconds) {
139
+ timer = setTimeout(() => {
140
+ if (this.epoch !== generation)
141
+ return;
142
+ this.failure = new Error('Connection timed out');
143
+ socket.destroy(this.failure);
144
+ }, milliseconds);
145
+ }
146
+ socket.connect({ host: address.toString(), port,
147
+ family: address.isV4() ? 4 : 6 });
148
+ return this.blocking ? done : socket_1.SocketStatus.NotReady;
149
+ }
150
+ /**
151
+ * Close the connection immediately and clear pending packet transfer state.
152
+ * @zh 立即关闭连接并清除未完成的收发包状态。
153
+ * @ja 接続を即座に閉じ、未完了のパケット送受信状態を消去します。
154
+ * @ko 즉시 연결을 닫고 미완료 패킷 송수신 상태를 지웁니다.
155
+ */
156
+ disconnect() { this.close(); }
157
+ /**
158
+ * Reject UDP or listener transports before adoption.
159
+ * @zh 接管前拒绝 UDP 或监听传输。
160
+ * @ja 引き継ぐ前に UDP またはリスナートランスポートを拒否します。
161
+ * @ko 인수 전에 UDP 또는 리스너 전송 객체를 거부합니다.
162
+ */
163
+ validateHandle(handle) {
164
+ if (!(handle instanceof node_net_1.Socket))
165
+ throw new TypeError('Expected Node TCP');
166
+ }
167
+ /**
168
+ * Integrate the handle allocated or adopted by protected create into
169
+ * TCP send/receive and readiness state.
170
+ * @zh 将受保护 create 分配或接管的句柄接入 TCP 收发和就绪状态。
171
+ * @ja protected の create が割り当てまたは引き継いだハンドルを
172
+ * TCP 送受信と準備状態に組み込みます。
173
+ * @ko protected create가 할당하거나 인수한 핸들을 TCP 송수신 및
174
+ * 준비 상태에 연결합니다.
175
+ */
176
+ onCreate() {
177
+ const socket = this.transport;
178
+ this.connected = !socket.connecting && !!socket.remoteAddress;
179
+ this.attach(socket);
180
+ }
181
+ /**
182
+ * Clear frame parsing, TLS, and send snapshots on recreation;
183
+ * the base-class generation mechanism cancels old waits.
184
+ * @zh 重建时清理帧解析、TLS 和发送快照,旧等待由基类代际机制取消。
185
+ * @ja 再作成時にフレーム解析、TLS、送信スナップショットを消去します。
186
+ * 古い待機は基底クラスの世代機構がキャンセルします。
187
+ * @ko 재생성 시 프레임 파싱, TLS 및 송신 스냅샷을 정리하며,
188
+ * 기본 클래스의 세대 메커니즘이 이전 대기를 취소합니다.
189
+ */
190
+ onClose() {
191
+ this.connected = false;
192
+ this.ended = true;
193
+ this.tlsStatus = TlsStatus.NotConnected;
194
+ this.resetPacket();
195
+ this.outgoing = undefined;
196
+ }
197
+ /**
198
+ * Let listeners adopt accepted connections through the same lifecycle.
199
+ * @zh 监听器通过同一生命周期接管已接受的连接。
200
+ * @ja リスナーが同じライフサイクルで受け入れ済み接続を引き継ぎます。
201
+ * @ko 리스너가 같은 수명 주기를 통해 수락한 연결을 인수합니다.
202
+ */
203
+ [exports.adoptTcp](socket) {
204
+ this.create(socket);
205
+ }
206
+ /**
207
+ * Upgrade an idle connection to a TLS client with verification enabled
208
+ * by default; CA bytes may use PEM or DER.
209
+ * @zh 将空闲连接升级为 TLS 客户端;默认验证,CA 字节支持 PEM 或 DER。
210
+ * @ja アイドル接続を TLS クライアントにアップグレードします。
211
+ * 既定で検証が有効で、CA バイトは PEM または DER に対応します。
212
+ * @ko 유휴 연결을 TLS 클라이언트로 업그레이드합니다.
213
+ * 기본적으로 검증하며 CA 바이트는 PEM 또는 DER를 지원합니다.
214
+ */
215
+ async setupTlsClient(hostname, verifyOrCa = true) {
216
+ if (typeof hostname !== 'string')
217
+ throw new TypeError('Expected hostname');
218
+ return this.setupTls(() => (0, node_tls_1.connect)({
219
+ socket: this.transport, servername: hostname,
220
+ rejectUnauthorized: verifyOrCa !== false,
221
+ ca: typeof verifyOrCa === 'boolean' ? undefined : (0, tls_material_1.tlsCertificate)(verifyOrCa),
222
+ }), 'secureConnect');
223
+ }
224
+ /**
225
+ * Upgrade to a TLS server using a PEM/DER certificate and private key;
226
+ * password bytes retain their raw contents and subview bounds.
227
+ * @zh 使用 PEM/DER 证书与私钥升级 TLS 服务端;口令字节保留原始内容及子视图。
228
+ * @ja PEM/DER の証明書と秘密鍵で TLS サーバーにアップグレードします。
229
+ * パスワードのバイトは元の内容とサブビューの範囲を保持します。
230
+ * @ko PEM/DER 인증서와 개인 키로 TLS 서버로 업그레이드합니다.
231
+ * 암호 바이트는 원시 내용과 하위 뷰 범위를 유지합니다.
232
+ */
233
+ async setupTlsServer(certificate, key, password = '') {
234
+ return this.setupTls(() => new node_tls_1.TLSSocket(this.transport, {
235
+ isServer: true,
236
+ secureContext: (0, node_tls_1.createSecureContext)({
237
+ cert: (0, tls_material_1.tlsCertificate)(certificate),
238
+ key: (0, tls_material_1.tlsPrivateKey)(key, password),
239
+ }),
240
+ }), 'secure');
241
+ }
242
+ /**
243
+ * Return the cipher suite name negotiated during the handshake,
244
+ * or undefined before TLS completes.
245
+ * @zh 返回握手协商的加密套件名;TLS 未完成时为 undefined。
246
+ * @ja ハンドシェイクで合意した暗号スイート名を返します。
247
+ * TLS が完了していなければ undefined です。
248
+ * @ko 핸드셰이크에서 협상한 암호 스위트 이름을 반환하며,
249
+ * TLS가 완료되지 않았으면 undefined입니다.
250
+ */
251
+ getCurrentCiphersuiteName() {
252
+ return this.tlsStatus === TlsStatus.HandshakeComplete &&
253
+ this.transport instanceof node_tls_1.TLSSocket
254
+ ? this.transport.getCipher()?.standardName ??
255
+ this.transport.getCipher()?.name : undefined;
256
+ }
257
+ send(data) {
258
+ const generation = this.epoch;
259
+ // Snapshot at call time, including for nonblocking writes accepted by Node.
260
+ const snapshot = data instanceof packet_1.Packet
261
+ ? this.outgoing?.packet === data ? undefined : Buffer.from(data[packet_1.packetSend]())
262
+ : Buffer.from((0, common_1.bytes)(data));
263
+ return this.writes.run(async () => {
264
+ const packet = data instanceof packet_1.Packet ? data : undefined;
265
+ const result = (status, sent = 0) => (packet ? status : { status, sent });
266
+ if (generation !== this.epoch || !this.connected) {
267
+ return result(this.failure ? socket_1.SocketStatus.Error : socket_1.SocketStatus.Disconnected);
268
+ }
269
+ if (this.tlsStatus === TlsStatus.HandshakeStarted) {
270
+ return result(socket_1.SocketStatus.NotReady);
271
+ }
272
+ if (this.outgoing && this.outgoing.packet !== packet) {
273
+ return result(socket_1.SocketStatus.NotReady);
274
+ }
275
+ if (packet && !this.outgoing) {
276
+ const body = snapshot;
277
+ (0, common_1.uint)(body.length);
278
+ const wire = Buffer.allocUnsafe(body.length + 4);
279
+ wire.writeUInt32BE(body.length);
280
+ body.copy(wire, 4);
281
+ this.outgoing = { packet, data: wire, position: 0 };
282
+ }
283
+ const input = this.outgoing
284
+ ? this.outgoing.data.subarray(this.outgoing.position) : snapshot;
285
+ const socket = this.transport;
286
+ if (!input.length)
287
+ return result(socket_1.SocketStatus.Done);
288
+ const room = this.blocking ? input.length
289
+ : Math.max(0, socket.writableHighWaterMark - socket.writableLength);
290
+ const count = Math.min(input.length, room);
291
+ if (!count)
292
+ return result(socket_1.SocketStatus.NotReady);
293
+ const completion = new Promise(resolve => {
294
+ socket.write(input.subarray(0, count), error => resolve(error ? socket_1.SocketStatus.Error : socket_1.SocketStatus.Done));
295
+ });
296
+ if (this.outgoing) {
297
+ this.outgoing.position += count;
298
+ if (this.outgoing.position === this.outgoing.data.length) {
299
+ this.outgoing = undefined;
300
+ }
301
+ }
302
+ const status = this.blocking
303
+ ? await this.awaitWrite(completion, generation) : socket_1.SocketStatus.Done;
304
+ if (generation !== this.epoch)
305
+ return result(socket_1.SocketStatus.Disconnected, count);
306
+ return result(status === socket_1.SocketStatus.Done && count < input.length
307
+ ? socket_1.SocketStatus.Partial : status, count);
308
+ });
309
+ }
310
+ receive(destination) {
311
+ const output = destination instanceof packet_1.Packet ? undefined : (0, common_1.bytes)(destination);
312
+ const generation = this.epoch;
313
+ return this.reads.run(async () => {
314
+ if (destination instanceof packet_1.Packet) {
315
+ for (;;) {
316
+ const header = this.packetSize === undefined;
317
+ const needed = header ? 4 - this.prefixSize
318
+ : this.packetSize - this.packetBytes;
319
+ if (!needed && !header) {
320
+ const payload = Buffer.concat(this.packetChunks, this.packetBytes);
321
+ this.resetPacket();
322
+ destination[packet_1.packetReceive](payload);
323
+ return socket_1.SocketStatus.Done;
324
+ }
325
+ const chunk = await this.readChunk(needed, generation);
326
+ if (typeof chunk === 'number')
327
+ return chunk;
328
+ if (header) {
329
+ chunk.copy(this.prefix, this.prefixSize);
330
+ this.prefixSize += chunk.length;
331
+ if (this.prefixSize === 4) {
332
+ this.packetSize = this.prefix.readUInt32BE();
333
+ if (this.packetSize > 64 * 1024 * 1024) {
334
+ this.failure = new Error('Packet exceeds 64 MiB receive limit');
335
+ this.disconnect();
336
+ return socket_1.SocketStatus.Error;
337
+ }
338
+ }
339
+ }
340
+ else {
341
+ this.packetChunks.push(chunk);
342
+ this.packetBytes += chunk.length;
343
+ }
344
+ }
345
+ }
346
+ if (this.prefixSize || this.packetSize !== undefined) {
347
+ throw new Error('Finish receiving the pending Packet first');
348
+ }
349
+ if (!output.length)
350
+ return { status: socket_1.SocketStatus.Error, received: 0 };
351
+ const chunk = await this.readChunk(output.length, generation);
352
+ if (typeof chunk === 'number')
353
+ return { status: chunk, received: 0 };
354
+ chunk.copy(output);
355
+ return { status: socket_1.SocketStatus.Done, received: chunk.length };
356
+ });
357
+ }
358
+ /**
359
+ * Return TCP transport liveness; derived classes may extend this.
360
+ * @zh 返回 TCP 传输存活状态,允许派生类扩展。
361
+ * @ja TCP トランスポートの生存状態を返します。派生クラスで拡張できます。
362
+ * @ko TCP 전송 객체의 활성 상태를 반환하며 파생 클래스에서 확장할 수 있습니다.
363
+ */
364
+ isAlive() { return !!this.transport && !this.ended; }
365
+ /**
366
+ * Return readiness bits for receiving, sending, and the TLS handshake.
367
+ * @zh 返回接收、发送及 TLS 握手对应的就绪位。
368
+ * @ja 受信、送信、TLS ハンドシェイクに対応する準備状態ビットを返します。
369
+ * @ko 수신, 송신 및 TLS 핸드셰이크에 해당하는 준비 상태 비트를 반환합니다.
370
+ */
371
+ getReadiness(mask) {
372
+ const socket = this.transport;
373
+ const receive = socket && (socket.readableLength > 0 || this.ended) ? 1 : 0;
374
+ const send = this.connected && socket && !socket.destroyed &&
375
+ !socket.writableNeedDrain && this.tlsStatus !== TlsStatus.HandshakeStarted
376
+ ? 2 : 0;
377
+ // eslint-disable-next-line no-bitwise
378
+ return (receive | send) & mask;
379
+ }
380
+ getNativeHandle() { return this.transport; }
381
+ /** 重置 Packet 分帧累积状态。 */
382
+ resetPacket() {
383
+ this.prefixSize = 0;
384
+ this.packetSize = undefined;
385
+ this.packetChunks = [];
386
+ this.packetBytes = 0;
387
+ }
388
+ /** 异步读取最多 max 字节,含代际校验。 */
389
+ async readChunk(max, generation) {
390
+ const available = () => this.ended ||
391
+ (this.transport?.readableLength ?? 0) > 0;
392
+ await this.awaitReady(available, generation);
393
+ if (generation !== this.epoch)
394
+ return socket_1.SocketStatus.Disconnected;
395
+ const socket = this.transport;
396
+ const count = Math.min(max, socket?.readableLength ?? 0);
397
+ if (count)
398
+ return socket.read(count);
399
+ if (this.ended)
400
+ return this.failure ? socket_1.SocketStatus.Error : socket_1.SocketStatus.Disconnected;
401
+ return socket_1.SocketStatus.NotReady;
402
+ }
403
+ /** 绑定套接字事件监听并设置 TCP_NODELAY。 */
404
+ attach(socket) {
405
+ this.detach?.();
406
+ this.transport = socket;
407
+ this.ended = socket.destroyed || socket.readableEnded;
408
+ socket.setNoDelay(true);
409
+ const generation = this.epoch;
410
+ const current = () => socket === this.transport && generation === this.epoch;
411
+ const readable = () => { if (current())
412
+ this.changed(); };
413
+ const connected = () => {
414
+ if (!current())
415
+ return;
416
+ this.connected = true;
417
+ this.changed();
418
+ };
419
+ const ended = () => {
420
+ if (!current())
421
+ return;
422
+ this.connected = false;
423
+ this.ended = true;
424
+ this.changed();
425
+ };
426
+ const error = (error) => {
427
+ if (!current())
428
+ return;
429
+ this.failure = error;
430
+ ended();
431
+ };
432
+ socket.on('readable', readable)
433
+ .on('drain', readable)
434
+ .on('connect', connected)
435
+ .on('end', ended)
436
+ .on('close', ended)
437
+ .on('error', error);
438
+ this.detach = () => {
439
+ socket.off('readable', readable)
440
+ .off('drain', readable)
441
+ .off('connect', connected)
442
+ .off('end', ended)
443
+ .off('close', ended)
444
+ .off('error', error);
445
+ };
446
+ }
447
+ /** 将空闲连接升级为 TLS 并等待握手完成。 */
448
+ async setupTls(create, event) {
449
+ if (!this.connected)
450
+ return TlsStatus.NotConnected;
451
+ const generation = this.epoch;
452
+ if (this.tlsStatus === TlsStatus.NotConnected) {
453
+ if (this.transport.readableLength || this.transport.writableLength) {
454
+ throw new Error('TLS upgrade requires an empty plaintext queue');
455
+ }
456
+ try {
457
+ this.detach?.();
458
+ const socket = create();
459
+ this.attach(socket);
460
+ this.tlsStatus = TlsStatus.HandshakeStarted;
461
+ const secure = () => {
462
+ if (socket !== this.transport || generation !== this.epoch)
463
+ return;
464
+ this.tlsStatus = TlsStatus.HandshakeComplete;
465
+ this.changed();
466
+ };
467
+ socket.once(event, secure);
468
+ const detach = this.detach;
469
+ this.detach = () => { detach?.(); socket.off(event, secure); };
470
+ }
471
+ catch (error) {
472
+ this.failure = error;
473
+ this.disconnect();
474
+ return TlsStatus.Error;
475
+ }
476
+ }
477
+ if (this.blocking && this.tlsStatus === TlsStatus.HandshakeStarted) {
478
+ await (0, common_1.waitFor)(this[socket_1.socketEvents], () => this.ended ||
479
+ this.tlsStatus !== TlsStatus.HandshakeStarted ||
480
+ generation !== this.epoch);
481
+ }
482
+ return this.ended || generation !== this.epoch ? TlsStatus.Error
483
+ : this.tlsStatus;
484
+ }
485
+ }
486
+ /**
487
+ * TLS handshake status enumeration.
488
+ * @zh TLS 握手状态枚举。
489
+ * @ja TLS ハンドシェイク状態の列挙型。
490
+ * @ko TLS 핸드셰이크 상태 열거형.
491
+ */
492
+ TcpSocket.TlsStatus = TlsStatus;
493
+ exports.TcpSocket = TcpSocket;
@@ -0,0 +1,22 @@
1
+ /// <reference types="node" />
2
+ /// <reference types="node" />
3
+ /**
4
+ * Preserve the full PEM certificate chain; parse DER certificates as X.509
5
+ * and convert them to PEM accepted by Node TLS.
6
+ * @zh 保留完整 PEM 证书链;DER 证书经 X.509 解析后转为 Node TLS 接受的 PEM。
7
+ * @ja 完全な PEM 証明書チェーンを保持します。DER 証明書は X.509 として解析し、
8
+ * Node TLS が受け付ける PEM に変換します。
9
+ * @ko 전체 PEM 인증서 체인을 유지합니다. DER 인증서는 X.509로 파싱한 후
10
+ * Node TLS가 허용하는 PEM으로 변환합니다.
11
+ */
12
+ export declare function tlsCertificate(input: string | Uint8Array): string | Buffer;
13
+ /**
14
+ * Validate and decrypt a private key, preserving raw password bytes and view
15
+ * bounds; output password-free PKCS#8 PEM.
16
+ * @zh 校验并解密私钥,保留密码的原始字节和视图范围,输出无密码 PKCS#8 PEM。
17
+ * @ja 秘密鍵を検証・復号し、パスワードの生バイトとビューの範囲を保持します。
18
+ * パスワードなしの PKCS#8 PEM を出力します。
19
+ * @ko 개인 키를 검증하고 복호화하며 암호의 원시 바이트와 뷰 범위를 유지합니다.
20
+ * 암호 없는 PKCS#8 PEM을 출력합니다.
21
+ */
22
+ export declare function tlsPrivateKey(input: string | Uint8Array, password: string | Uint8Array): string | Buffer;
@@ -0,0 +1,52 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.tlsPrivateKey = exports.tlsCertificate = void 0;
4
+ const node_crypto_1 = require("node:crypto");
5
+ const common_1 = require("./common");
6
+ /**
7
+ * Preserve the full PEM certificate chain; parse DER certificates as X.509
8
+ * and convert them to PEM accepted by Node TLS.
9
+ * @zh 保留完整 PEM 证书链;DER 证书经 X.509 解析后转为 Node TLS 接受的 PEM。
10
+ * @ja 完全な PEM 証明書チェーンを保持します。DER 証明書は X.509 として解析し、
11
+ * Node TLS が受け付ける PEM に変換します。
12
+ * @ko 전체 PEM 인증서 체인을 유지합니다. DER 인증서는 X.509로 파싱한 후
13
+ * Node TLS가 허용하는 PEM으로 변환합니다.
14
+ */
15
+ function tlsCertificate(input) {
16
+ if (typeof input === 'string')
17
+ return input;
18
+ const data = (0, common_1.bytes)(input);
19
+ return data.includes('-----BEGIN CERTIFICATE-----')
20
+ ? data : new node_crypto_1.X509Certificate(data).toString();
21
+ }
22
+ exports.tlsCertificate = tlsCertificate;
23
+ /**
24
+ * Validate and decrypt a private key, preserving raw password bytes and view
25
+ * bounds; output password-free PKCS#8 PEM.
26
+ * @zh 校验并解密私钥,保留密码的原始字节和视图范围,输出无密码 PKCS#8 PEM。
27
+ * @ja 秘密鍵を検証・復号し、パスワードの生バイトとビューの範囲を保持します。
28
+ * パスワードなしの PKCS#8 PEM を出力します。
29
+ * @ko 개인 키를 검증하고 복호화하며 암호의 원시 바이트와 뷰 범위를 유지합니다.
30
+ * 암호 없는 PKCS#8 PEM을 출력합니다.
31
+ */
32
+ function tlsPrivateKey(input, password) {
33
+ const key = typeof input === 'string' ? input : (0, common_1.bytes)(input);
34
+ const passphrase = typeof password === 'string' ? password : (0, common_1.bytes)(password);
35
+ if (typeof key === 'string' || key.includes('-----BEGIN ')) {
36
+ return (0, node_crypto_1.createPrivateKey)({ key, format: 'pem', passphrase })
37
+ .export({ format: 'pem', type: 'pkcs8' });
38
+ }
39
+ // 每一种 DER 容器均交给 OpenSSL 实际解析校验,不通过前缀猜测密钥格式。
40
+ let failure;
41
+ for (const type of ['pkcs8', 'pkcs1', 'sec1']) {
42
+ try {
43
+ return (0, node_crypto_1.createPrivateKey)({ key, format: 'der', type, passphrase })
44
+ .export({ format: 'pem', type: 'pkcs8' });
45
+ }
46
+ catch (error) {
47
+ failure ?? (failure = error);
48
+ }
49
+ }
50
+ throw failure;
51
+ }
52
+ exports.tlsPrivateKey = tlsPrivateKey;