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,199 @@
1
+ import { audioNative, type AudioHandle } from './audio-native';
2
+ import { InputSoundFile, cancelAudioInput } from '../audio/input-sound-file';
3
+ import type { AudioWorkerStats, SoundStreamChunk } from '../audio/worker';
4
+ import { Time } from '../system/time';
5
+ import { isAudioInputCancellation } from './audio-input-stream';
6
+
7
+ /** 对象所属 JS 线程的音乐回调;实现只能弱引用包装对象。 */
8
+ export interface AudioMusicCallbacks {
9
+ /** 填充本次原生槽;完成前槽不会复用。 */
10
+ onGetData(chunk: SoundStreamChunk, pump: AudioMusicPump):
11
+ boolean | Promise<boolean>;
12
+ /** 响应本次队列代数的定位请求。 */
13
+ onSeek(offset: Time, pump: AudioMusicPump): void | Promise<void>;
14
+ /** 准备末块时返回下一轮交错样本偏移。 */
15
+ onLoop(pump: AudioMusicPump):
16
+ bigint | undefined | Promise<bigint | undefined>;
17
+ }
18
+
19
+ /** Decode ahead into native slots; SFML's device callback only consumes PCM. */
20
+ export class AudioMusicPump {
21
+ /** 首批 PCM 准备完成;关闭先于准备时返回 false。 */
22
+ readonly ready: Promise<boolean>;
23
+ /** 解码循环及底层文件清理的完成信号。 */
24
+ private readonly done: Promise<void>;
25
+ /** 已请求关闭,不再提交任何新数据。 */
26
+ private closed = false;
27
+ /** 保留解码或用户回调的首个错误。 */
28
+ private failure?: Error;
29
+ /** 首批数据已准备,空闲轮询可不再保活进程。 */
30
+ private primed = false;
31
+ /** 当前等待队列空位的定时器。 */
32
+ private timer?: NodeJS.Timeout;
33
+ /** 完成首批数据准备。 */
34
+ private resolveReady!: (ok: boolean) => void;
35
+ /** 报告首批数据准备失败。 */
36
+ private rejectReady!: (error: unknown) => void;
37
+ /** 当前租借槽的容量、循环设置等描述字段。 */
38
+ private fields?: Int32Array;
39
+ /** 当前租借槽的总样本数与循环区间。 */
40
+ private counts?: BigUint64Array;
41
+ /** 默认解码器为当前末块计算的下一轮样本位置。 */
42
+ private loopOffset?: bigint;
43
+ /** 当前定位回调的精确循环样本位置,保留微秒转换舍去的余数。 */
44
+ private seekTarget?: { time: bigint; sample: bigint };
45
+
46
+ /** 创建解码会话;下一微任务才开始调用用户代码。 */
47
+ constructor(private readonly handle: AudioHandle<'worker'>, token: bigint,
48
+ private readonly file: InputSoundFile,
49
+ private readonly callbacks?: AudioMusicCallbacks) {
50
+ this.ready = new Promise((resolve, reject) => {
51
+ this.resolveReady = resolve;
52
+ this.rejectReady = reject;
53
+ });
54
+ void this.ready.catch(() => {});
55
+ this.done = Promise.resolve().then(() => this.run(token))
56
+ .catch((error: unknown) => {
57
+ if (!this.closed || !isAudioInputCancellation(error)) {
58
+ this.failure ??= error instanceof Error ? error : new Error(String(error));
59
+ this.rejectReady(this.failure);
60
+ }
61
+ })
62
+ .finally(() => this.resolveReady(false));
63
+ }
64
+
65
+ /** 最近的解码或用户回调错误。 */
66
+ get error(): Error | undefined { return this.failure; }
67
+ /** 读取 Native 队列的累计统计。 */
68
+ getStats(): AudioWorkerStats {
69
+ const fields = new BigUint64Array(audioNative.audioWorkerStats(this.handle));
70
+ return { underruns: fields[0], overruns: fields[1], processed: fields[2] };
71
+ }
72
+ /** 请求关闭但不等待当前用户回调,允许在回调内安全调用。 */
73
+ requestClose(): void {
74
+ this.closed = true;
75
+ this.timer?.ref();
76
+ audioNative.closeAudioWorker(this.handle);
77
+ this.file[cancelAudioInput]();
78
+ }
79
+ /** 关闭并等待当前回调、文件句柄释放;不能在自身回调内等待。 */
80
+ async close(): Promise<void> {
81
+ this.requestClose();
82
+ await this.done;
83
+ if (this.failure) throw this.failure;
84
+ }
85
+ /** 默认解码实现;只能由当前会话的 onGetData 调用。 */
86
+ async onGetData(chunk: SoundStreamChunk): Promise<boolean> {
87
+ if (this.closed) { chunk.sampleCount = 0; return false; }
88
+ const fields = this.fields!;
89
+ const counts = this.counts!;
90
+ const position = this.file.getSampleOffset();
91
+ const end = counts[3] + counts[4];
92
+ let size = chunk.samples.length;
93
+ if (fields[4] && counts[4] && position <= end &&
94
+ position + BigInt(size) > end) size = Number(end - position);
95
+ let count: bigint;
96
+ try {
97
+ count = await this.file.read(chunk.samples.subarray(0, size));
98
+ } catch (error) {
99
+ if (!this.closed || !isAudioInputCancellation(error)) throw error;
100
+ chunk.sampleCount = 0;
101
+ return false;
102
+ }
103
+ const next = position + count;
104
+ const loopEnd = fields[4] !== 0 && counts[4] !== 0n && next === end;
105
+ chunk.sampleCount = Number(count);
106
+ this.loopOffset = loopEnd ? counts[3] : next >= counts[2] ? 0n : undefined;
107
+ return count !== 0n && next < counts[2] && !loopEnd;
108
+ }
109
+ /** 默认定位文件;时间以微秒表示。 */
110
+ async onSeek(offset: Time): Promise<void> {
111
+ if (this.closed) return;
112
+ const target = this.seekTarget?.time === offset.asMicroseconds()
113
+ ? this.seekTarget.sample : offset;
114
+ try { await this.file.seek(target); } catch (error) {
115
+ if (!this.closed || !isAudioInputCancellation(error)) throw error;
116
+ }
117
+ }
118
+ /** 返回默认文件解码的下一轮交错样本位置。 */
119
+ onLoop(): bigint | undefined { return this.loopOffset; }
120
+ /** 用户回调错误独立于取消状态保留,并进入 ready/close 错误通道。 */
121
+ private async dispatch<T>(callback: () => T | Promise<T>): Promise<T> {
122
+ try { return await callback(); } catch (error) {
123
+ this.failure ??= error instanceof Error ? error : new Error(String(error));
124
+ this.rejectReady(this.failure);
125
+ throw error;
126
+ }
127
+ }
128
+ /** 在原生槽中串行解码,实时音频线程只消费已提交的 PCM。 */
129
+ private async run(token: bigint): Promise<void> {
130
+ const mapping = audioNative.attachAudioWorker(token);
131
+ const fields = new Int32Array(mapping.fields);
132
+ const times = new BigInt64Array(mapping.time);
133
+ const counts = new BigUint64Array(mapping.time);
134
+ this.fields = fields;
135
+ this.counts = counts;
136
+ const buffers = mapping.input.map(buffer => new Int16Array(buffer));
137
+ let primed = 0;
138
+ try {
139
+ for (;;) {
140
+ const operation = audioNative.pollAudioWorker(mapping.handle);
141
+ if (operation === -3) break;
142
+ if (operation === -2) {
143
+ const offset = new Time(times[0]);
144
+ this.seekTarget = times[5] >= 0n
145
+ ? { time: times[0], sample: times[5] } : undefined;
146
+ try {
147
+ if (this.callbacks) {
148
+ await this.dispatch(() => this.callbacks!.onSeek(offset, this));
149
+ } else await this.onSeek(offset);
150
+ } finally { this.seekTarget = undefined; }
151
+ continue;
152
+ }
153
+ if (operation === -1) {
154
+ await new Promise<void>(resolve => {
155
+ this.timer = setTimeout(resolve, 2);
156
+ if (this.primed && !this.closed) this.timer.unref();
157
+ });
158
+ this.timer = undefined;
159
+ continue;
160
+ }
161
+ this.loopOffset = undefined;
162
+ const samples = buffers[fields[0]];
163
+ const chunk = { samples, sampleCount: fields[2] };
164
+ const more = await (this.callbacks
165
+ ? this.dispatch(() => this.callbacks!.onGetData(chunk, this))
166
+ : this.onGetData(chunk));
167
+ if (this.closed) break;
168
+ if (typeof more !== 'boolean') {
169
+ throw new TypeError('onGetData must return a boolean');
170
+ }
171
+ if (chunk.samples !== samples) {
172
+ throw new TypeError('Fill the provided native sample buffer');
173
+ }
174
+ if (!Number.isInteger(chunk.sampleCount) || chunk.sampleCount < 0 ||
175
+ chunk.sampleCount > samples.length) {
176
+ throw new RangeError('Invalid stream sample count');
177
+ }
178
+ fields[2] = chunk.sampleCount;
179
+ fields[3] = +more;
180
+ const loop = more ? undefined : await (this.callbacks
181
+ ? this.dispatch(() => this.callbacks!.onLoop(this)) : this.onLoop());
182
+ if (this.closed) break;
183
+ if (loop !== undefined && (typeof loop !== 'bigint' ||
184
+ loop < 0n || loop > 0x7fffffffffffffffn)) {
185
+ throw new RangeError('Invalid loop sample offset');
186
+ }
187
+ times[1] = loop ?? -1n;
188
+ audioNative.commitAudioWorker(mapping.handle);
189
+ if (++primed >= 2 || !more) {
190
+ this.primed = true;
191
+ this.resolveReady(true);
192
+ }
193
+ }
194
+ } finally {
195
+ audioNative.closeAudioWorker(this.handle);
196
+ await this.file.close();
197
+ }
198
+ }
199
+ }
@@ -0,0 +1,176 @@
1
+ import { native } from './native';
2
+ import type { NativeStruct } from './struct-view';
3
+ import type { NativeStreamDispatch } from './native';
4
+
5
+ declare const audioBrand: unique symbol;
6
+ export interface AudioHandle<T extends string> { readonly [audioBrand]: T }
7
+ type Callback<T> = (error: Error | null, result: T) => void;
8
+ export interface AudioBufferMapping {
9
+ info: NativeStruct;
10
+ samples: ArrayBuffer;
11
+ channelMap: ArrayBuffer;
12
+ }
13
+ export interface AudioSourceMapping {
14
+ handle: AudioHandle<'source'>;
15
+ values: ArrayBuffer;
16
+ times: ArrayBuffer;
17
+ }
18
+ export interface AudioFileMapping {
19
+ buffer: ArrayBuffer;
20
+ channelMap: ArrayBuffer;
21
+ }
22
+ export interface AudioWorkerMapping {
23
+ handle: AudioHandle<'worker'>;
24
+ fields: ArrayBuffer;
25
+ time: ArrayBuffer;
26
+ input: ArrayBuffer[];
27
+ output: ArrayBuffer[];
28
+ }
29
+ export interface AudioReaderInfoMapping {
30
+ handle: AudioHandle<'readerInfo'>;
31
+ info: NativeStruct;
32
+ channelMap: ArrayBuffer;
33
+ }
34
+ export interface AudioBinding {
35
+ createAudioReaderInfo(): AudioReaderInfoMapping;
36
+ setAudioReaderChannels(handle: AudioHandle<'readerInfo'>,
37
+ map: Int32Array): ArrayBuffer;
38
+ createAudioReader(input: string | Uint8Array | AudioHandle<'stream'>,
39
+ callback: Callback<AudioHandle<'reader'> | undefined>): void;
40
+ openAudioReader(handle: AudioHandle<'reader'>, stream: AudioHandle<'stream'>,
41
+ callback: Callback<AudioReaderInfoMapping | undefined>): void;
42
+ readAudioReader(handle: AudioHandle<'reader'>, samples: Int16Array,
43
+ callback: Callback<bigint>): void;
44
+ seekAudioReader(handle: AudioHandle<'reader'>, offset: bigint,
45
+ callback: Callback<void>): void;
46
+ closeAudioReader(handle: AudioHandle<'reader'>, callback: Callback<void>): void;
47
+ createAudioWriter(filename: string): AudioHandle<'writer'> | undefined;
48
+ openAudioWriter(handle: AudioHandle<'writer'>, filename: string,
49
+ rate: number, count: number, map: Int32Array,
50
+ callback: Callback<boolean>): void;
51
+ writeAudioWriter(handle: AudioHandle<'writer'>, samples: Int16Array,
52
+ callback: Callback<void>): void;
53
+ closeAudioWriter(handle: AudioHandle<'writer'>, callback: Callback<void>): void;
54
+ createAudioFileMetadata(info: AudioHandle<'readerInfo'>): AudioFileMapping & {
55
+ handle: AudioHandle<'fileMetadata'>;
56
+ };
57
+ updateAudioFileMetadata(handle: AudioHandle<'fileMetadata'>,
58
+ operation: number, count?: bigint): void;
59
+ allocateAudioSamples(count: number): ArrayBuffer;
60
+ createAudioInputStream(dispatch: NativeStreamDispatch): AudioHandle<'stream'>;
61
+ closeAudioInputStream(handle: AudioHandle<'stream'>): void;
62
+ createAudioRecorder(buffer: boolean): {
63
+ handle: AudioHandle<'recorder'>; values: ArrayBuffer; channelMap: ArrayBuffer;
64
+ };
65
+ prepareAudioRecorder(handle: AudioHandle<'recorder'>, rate: number,
66
+ frames: number, slots: number, callback: Callback<{
67
+ handle?: AudioHandle<'worker'>; token?: bigint;
68
+ }>, callbacks?: boolean): void;
69
+ startAudioRecorder(handle: AudioHandle<'recorder'>,
70
+ callback: Callback<boolean>): void;
71
+ stopAudioRecorder(handle: AudioHandle<'recorder'>,
72
+ callback: Callback<AudioHandle<'bufferData'> | undefined>): void;
73
+ /** 创建独立录音会话的 Native PCM 聚合器,快照当前采样率和声道映射。 */
74
+ createAudioRecorderBuffer(handle: AudioHandle<'recorder'>):
75
+ AudioHandle<'recorderBuffer'>;
76
+ /** 重置或完成 Native PCM 聚合,返回独立的 SoundBuffer 数据句柄。 */
77
+ audioRecorderBuffer(handle: AudioHandle<'recorderBuffer'>,
78
+ command: 0 | 2): AudioHandle<'bufferData'>;
79
+ /** 追加交错 16 位 PCM 样本;只接受完整声道帧,数据由 Native 持有。 */
80
+ audioRecorderBuffer(handle: AudioHandle<'recorderBuffer'>,
81
+ command: 1, samples: Int16Array): void;
82
+ audioRecorderDevice(handle: AudioHandle<'recorder'>): string;
83
+ audioRecorderDevice(handle: AudioHandle<'recorder'>, name: string,
84
+ callback: Callback<boolean>): void;
85
+ audioRecorderChannels(handle: AudioHandle<'recorder'>,
86
+ count: number): ArrayBuffer;
87
+ audioCaptureDevices(command: 0): string[];
88
+ audioCaptureDevices(command: 1): string;
89
+ audioCaptureDevices(command: 2): boolean;
90
+ createAudioStream(frames: number, channels: number, rate: number, slots: number,
91
+ map: Int32Array): AudioSourceMapping & {
92
+ token: bigint; worker: AudioHandle<'worker'>;
93
+ };
94
+ openAudioMusicStream(source: AudioHandle<'source'>, frames: number,
95
+ channels: number, rate: number, slots: number, map: Int32Array,
96
+ sampleCount: bigint): { handle: AudioHandle<'worker'>; token: bigint };
97
+ attachAudioWorker(token: bigint): AudioWorkerMapping;
98
+ pollAudioWorker(handle: AudioHandle<'worker'>): number;
99
+ commitAudioWorker(handle: AudioHandle<'worker'>, more?: boolean): void;
100
+ closeAudioWorker(handle: AudioHandle<'worker'>): void;
101
+ audioWorkerStats(handle: AudioHandle<'worker'>): ArrayBuffer;
102
+ createAudioEffect(frames: number, channels: number, slots: number): {
103
+ handle: AudioHandle<'worker'>; token: bigint;
104
+ };
105
+ setAudioEffect(source: AudioHandle<'source'>,
106
+ effect?: AudioHandle<'worker'>): void;
107
+ createAudioDeviceState(): { handle: AudioHandle<'device'>; buffer: ArrayBuffer };
108
+ audioDevice(handle: AudioHandle<'device'>, command: number,
109
+ name?: string): string | string[] | undefined;
110
+ audioDeviceNotifications(callback?: ((event: number) => void) | null): void;
111
+ createAudioBuffer(source?: AudioHandle<'buffer'>):
112
+ AudioBufferMapping & { handle: AudioHandle<'buffer'> };
113
+ createAudioBuffer(samples: Int16Array, rate: number, channels: number,
114
+ map: Int32Array): AudioBufferMapping & { handle: AudioHandle<'buffer'> };
115
+ assignAudioBuffer(target: AudioHandle<'buffer'>,
116
+ source: AudioHandle<'buffer'>): AudioBufferMapping;
117
+ loadAudioBuffer(input: string | Uint8Array | AudioHandle<'stream'>,
118
+ callback: Callback<AudioHandle<'bufferData'> | undefined>): void;
119
+ audioBufferSamples(samples: Int16Array, rate: number, channels: number,
120
+ map: Int32Array): AudioHandle<'bufferData'> | undefined;
121
+ commitAudioBuffer(handle: AudioHandle<'buffer'>,
122
+ data: AudioHandle<'bufferData'>): AudioBufferMapping;
123
+ saveAudioBuffer(handle: AudioHandle<'buffer'>, path: string,
124
+ callback: Callback<boolean>): void;
125
+ createAudioSource(buffer?: AudioHandle<'buffer'>,
126
+ source?: AudioHandle<'source'>): AudioSourceMapping;
127
+ setAudioBuffer(source: AudioHandle<'source'>, buffer: AudioHandle<'buffer'>): void;
128
+ assignAudioSource(target: AudioHandle<'source'>, source: AudioHandle<'source'>,
129
+ fullSound: boolean): void;
130
+ audioSourceField(source: AudioHandle<'source'>, field: number,
131
+ write: boolean): void;
132
+ audioSourceCommand(source: AudioHandle<'source'>, command: number): void;
133
+ openAudioMusic(source: AudioHandle<'source'>, input: string | Uint8Array,
134
+ callback: Callback<boolean>): void;
135
+ closeAudioMusic(source: AudioHandle<'source'>): void;
136
+ audioSourceChannels(source: AudioHandle<'source'>): ArrayBuffer;
137
+ createAudioListener(): { handle: AudioHandle<'listener'>; buffer: ArrayBuffer };
138
+ audioListenerField(handle: AudioHandle<'listener'>, field: number,
139
+ write: boolean): void;
140
+ createAudioValue(kind: number): ArrayBuffer;
141
+ createAudioInput(): AudioFileMapping & { handle: AudioHandle<'input'> };
142
+ openAudioInput(handle: AudioHandle<'input'>,
143
+ input: string | Uint8Array | AudioHandle<'stream'>,
144
+ callback: Callback<AudioFileMapping | undefined>): void;
145
+ readAudioInput(handle: AudioHandle<'input'>, samples: Int16Array,
146
+ callback: Callback<void>): void;
147
+ seekAudioInput(handle: AudioHandle<'input'>, offset: bigint, time: boolean,
148
+ callback: Callback<void>): void;
149
+ closeAudioInput(handle: AudioHandle<'input'>,
150
+ callback: Callback<AudioFileMapping>): void;
151
+ createAudioOutput(): AudioHandle<'output'>;
152
+ openAudioOutput(handle: AudioHandle<'output'>, path: string, rate: number,
153
+ channels: number, map: Int32Array, callback: Callback<boolean>): void;
154
+ writeAudioOutput(handle: AudioHandle<'output'>, samples: Int16Array,
155
+ callback: Callback<void>): void;
156
+ closeAudioOutput(handle: AudioHandle<'output'>, callback: Callback<void>): void;
157
+ }
158
+
159
+ export const audioNative: AudioBinding = native as unknown as AudioBinding;
160
+ export const audioHandle: unique symbol = Symbol('Audio.native');
161
+
162
+ export function audioAsync<T>(start: (callback: Callback<T>) => void): Promise<T> {
163
+ return new Promise((resolve, reject) => {
164
+ start((error, result) => (error ? reject(error) : resolve(result)));
165
+ });
166
+ }
167
+
168
+ /** Operations sharing a file cursor execute in invocation order. */
169
+ export class AudioQueue {
170
+ private pending = Promise.resolve();
171
+ run<T>(action: () => Promise<T>): Promise<T> {
172
+ const next = this.pending.then(action);
173
+ this.pending = next.then(() => undefined, () => undefined);
174
+ return next;
175
+ }
176
+ }
@@ -0,0 +1,234 @@
1
+ import { AsyncLocalStorage } from 'node:async_hooks';
2
+ import {
3
+ AudioQueue, audioAsync, audioNative, type AudioHandle,
4
+ } from './audio-native';
5
+ import type { AudioWorkerStats } from '../audio/worker';
6
+
7
+ /** 在录音器所属 JS 线程执行的串行回调;不得强引用录音器 wrapper。 */
8
+ export interface AudioRecorderCallbacks {
9
+ /** 开始采集前调用;false 拒绝本次采集。 */
10
+ onStart(): boolean | Promise<boolean>;
11
+ /** 消费 Native 交错 PCM 视图;视图仅在本次回调完成前有效。 */
12
+ onProcessSamples(samples: Int16Array): boolean | Promise<boolean>;
13
+ /** 设备停止且已交付回调结束后调用一次。 */
14
+ onStop(): void | Promise<void>;
15
+ }
16
+
17
+ /** super 调用必须匹配的录音回调阶段。 */
18
+ type Phase = 'onStart' | 'onProcessSamples' | 'onStop';
19
+ /** 异步回调上下文,结束后禁止继续使用该会话的 super 方法。 */
20
+ interface Invocation {
21
+ /** 发起本次回调的会话。 */
22
+ session: AudioRecorderSession;
23
+ /** 当前正在执行的回调阶段。 */
24
+ phase: Phase;
25
+ /** 回调返回或拒绝之前保持有效。 */
26
+ active: boolean;
27
+ }
28
+ /** 随 await 传递本次回调上下文,不将旧回调绑定到新会话。 */
29
+ const invocation = new AsyncLocalStorage<Invocation>();
30
+
31
+ /** 返回当前仍在执行的录音回调会话,用于识别 stop 的自等待。 */
32
+ export function currentRecorderSession(
33
+ recorder: AudioHandle<'recorder'>,
34
+ ): AudioRecorderSession | undefined {
35
+ const context = invocation.getStore();
36
+ return context?.active && context.session.recorder === recorder
37
+ ? context.session : undefined;
38
+ }
39
+
40
+ /** 取得 super 默认实现对应的会话;拒绝过期或阶段不匹配的异步调用。 */
41
+ export function recorderCallbackSession(
42
+ recorder: AudioHandle<'recorder'>, phase: Phase,
43
+ ): AudioRecorderSession {
44
+ const context = invocation.getStore();
45
+ if (!context?.active || context.phase !== phase ||
46
+ context.session.recorder !== recorder) {
47
+ throw new Error(`${phase} must run inside its active Recorder callback`);
48
+ }
49
+ return context.session;
50
+ }
51
+
52
+ /** Native 队列的同线程消费者;只持有固定数量的 PCM 视图。 */
53
+ export class AudioRecorderSession {
54
+ /** onStart 和设备启动结果;拒绝和取消均返回 false。 */
55
+ readonly ready: Promise<boolean>;
56
+ /** 包括设备停止、队列消费和 onStop 的整个会话生命周期。 */
57
+ readonly done: Promise<void>;
58
+ /** 本会话首次错误;通过 start/stop 和 getWorkerError 传播。 */
59
+ error?: Error;
60
+ /** 本会话独占的原生采集队列。 */
61
+ private readonly handle: AudioHandle<'worker'>;
62
+ /** 仅由 super 追加样本的原生聚合器。 */
63
+ private readonly buffer: AudioHandle<'recorderBuffer'>;
64
+ /** 当前租借队列槽的样本数量等描述字段。 */
65
+ private readonly fields: Int32Array;
66
+ /** 固定数量的原生 PCM 槽视图,回调完成后可复用。 */
67
+ private readonly input: Int16Array[];
68
+ /** 串行化设备操作,不等待用户回调。 */
69
+ private readonly devices = new AudioQueue();
70
+ /** 已请求停止,不再启动新的采集设备。 */
71
+ private stopping = false;
72
+ /** 正在等待会话结束,轮询定时器需保活进程。 */
73
+ private draining = false;
74
+ /** 等待新样本或设备停止的轮询定时器。 */
75
+ private timer?: NodeJS.Timeout;
76
+ /** 本会话唯一的设备停止操作。 */
77
+ private captureStop?: Promise<void>;
78
+
79
+ /** 绑定独立 Native 队列和聚合器,回调延迟到构造完成后执行。 */
80
+ constructor(
81
+ /** 本会话操作的 Native 录音器句柄。 */
82
+ readonly recorder: AudioHandle<'recorder'>,
83
+ token: bigint,
84
+ /** 只弱引用包装对象的回调派发器。 */
85
+ private readonly callbacks: AudioRecorderCallbacks,
86
+ cancelled = false,
87
+ ) {
88
+ const mapping = audioNative.attachAudioWorker(token);
89
+ this.handle = mapping.handle;
90
+ this.fields = new Int32Array(mapping.fields);
91
+ this.input = mapping.input.map(buffer => new Int16Array(buffer));
92
+ this.buffer = audioNative.createAudioRecorderBuffer(recorder);
93
+ this.stopping = cancelled;
94
+ let resolveReady!: (value: boolean) => void;
95
+ let rejectReady!: (error: Error) => void;
96
+ this.ready = new Promise((resolve, reject) => {
97
+ resolveReady = resolve;
98
+ rejectReady = reject;
99
+ });
100
+ this.done = Promise.resolve().then(() =>
101
+ this.run(resolveReady, rejectReady));
102
+ }
103
+
104
+ /** 重置 Native 聚合和空 SoundBuffer,仅供 super.onStart 使用。 */
105
+ reset(): AudioHandle<'bufferData'> {
106
+ return audioNative.audioRecorderBuffer(this.buffer, 0);
107
+ }
108
+
109
+ /** 将当前回调提供的交错样本追加到 Native 聚合器。 */
110
+ append(samples: Int16Array): boolean {
111
+ audioNative.audioRecorderBuffer(this.buffer, 1, samples);
112
+ return true;
113
+ }
114
+
115
+ /** 完成 Native 聚合;返回不受后续录音影响的缓冲区。 */
116
+ finalize(): AudioHandle<'bufferData'> {
117
+ return audioNative.audioRecorderBuffer(this.buffer, 2);
118
+ }
119
+
120
+ /** 将设备切换与启动、停止串行化;不包含等待 JS 回调的操作。 */
121
+ runDeviceOperation<T>(action: () => Promise<T>): Promise<T> {
122
+ return this.devices.run(action);
123
+ }
124
+
125
+ /** 仅等待设备停止,不等待当前 JS 回调;可在回调内部 await。 */
126
+ requestStop(): Promise<void> {
127
+ this.stopping = true;
128
+ this.draining = true;
129
+ this.timer?.ref();
130
+ if (!this.captureStop) {
131
+ this.captureStop = this.devices.run(async () => {
132
+ await audioAsync(callback =>
133
+ audioNative.stopAudioRecorder(this.recorder, callback));
134
+ });
135
+ void this.captureStop.catch(error => this.fail(error));
136
+ }
137
+ return this.captureStop;
138
+ }
139
+
140
+ /** 等待所有已交付数据和 onStop;调用方必须不在本会话回调中。 */
141
+ async drain(): Promise<void> {
142
+ this.draining = true;
143
+ this.timer?.ref();
144
+ await this.done;
145
+ if (this.error) throw this.error;
146
+ }
147
+
148
+ /** 停止设备并等待本会话完整结束。 */
149
+ async stop(): Promise<void> {
150
+ await this.requestStop().catch(error => this.fail(error));
151
+ await this.drain();
152
+ }
153
+
154
+ /** 返回 Native 队列统计,processed 的单位为交错样本。 */
155
+ getStats(): AudioWorkerStats {
156
+ const fields = new BigUint64Array(audioNative.audioWorkerStats(this.handle));
157
+ return { underruns: fields[0], overruns: fields[1], processed: fields[2] };
158
+ }
159
+
160
+ /** 保留首个错误,避免清理异常覆盖原始回调错误。 */
161
+ private fail(error: unknown): void {
162
+ this.error ??= error instanceof Error ? error : new Error(String(error));
163
+ }
164
+
165
+ /** 串行派发一个回调,并在异步完成后使其上下文失效。 */
166
+ private async invoke<T>(phase: Phase, callback: () => T): Promise<Awaited<T>> {
167
+ const context: Invocation = { session: this, phase, active: true };
168
+ try {
169
+ return await invocation.run(context, callback);
170
+ } finally {
171
+ context.active = false;
172
+ }
173
+ }
174
+
175
+ /** 驱动启动、PCM 消费和唯一的停止回调,所有样本仍由 Native 持有。 */
176
+ private async run(resolveReady: (value: boolean) => void,
177
+ rejectReady: (error: Error) => void): Promise<void> {
178
+ try {
179
+ // 已取消的启动仍经 finally 派发 onStop,但不启动设备或派发 onStart。
180
+ if (this.stopping) { resolveReady(false); return; }
181
+ const accepted = await this.invoke('onStart', () =>
182
+ this.callbacks.onStart());
183
+ if (typeof accepted !== 'boolean') {
184
+ throw new TypeError('Recorder onStart must return a boolean');
185
+ }
186
+ let started = false;
187
+ if (accepted && !this.stopping) {
188
+ started = await this.devices.run(() =>
189
+ audioAsync<boolean>(callback =>
190
+ audioNative.startAudioRecorder(this.recorder, callback)));
191
+ }
192
+ resolveReady(started && !this.stopping);
193
+ if (!started) return;
194
+ for (;;) {
195
+ const status = audioNative.pollAudioWorker(this.handle);
196
+ if (status === -3) break;
197
+ if (status === -1) {
198
+ await new Promise<void>(resolve => {
199
+ this.timer = setTimeout(resolve, 1);
200
+ if (!this.draining) this.timer.unref();
201
+ });
202
+ this.timer = undefined;
203
+ continue;
204
+ }
205
+ let more = false;
206
+ try {
207
+ const samples = this.input[this.fields[0]].subarray(0, this.fields[2]);
208
+ more = await this.invoke('onProcessSamples', () =>
209
+ this.callbacks.onProcessSamples(samples));
210
+ if (typeof more !== 'boolean') {
211
+ throw new TypeError('Recorder onProcessSamples must return a boolean');
212
+ }
213
+ } finally {
214
+ audioNative.commitAudioWorker(this.handle, more === true);
215
+ }
216
+ if (!more) {
217
+ await this.requestStop();
218
+ break;
219
+ }
220
+ }
221
+ } catch (error) {
222
+ this.fail(error);
223
+ rejectReady(this.error!);
224
+ } finally {
225
+ await this.requestStop().catch(error => this.fail(error));
226
+ try {
227
+ await this.invoke('onStop', () => this.callbacks.onStop());
228
+ } catch (error) {
229
+ this.fail(error);
230
+ }
231
+ audioNative.closeAudioWorker(this.handle);
232
+ }
233
+ }
234
+ }