@egret/engine 0.0.0-stage → 7.0.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 (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,103 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const roots = new WeakMap();
4
+ /** The genuine root installs all ports once; structural copies grant no authority. */
5
+ export function registerUiRoot(root, engine, port) {
6
+ const listeners = new Set(), interactions = new Set();
7
+ let closed = false, layerOwner, dismiss;
8
+ function open() {
9
+ if (closed || port.state() !== 'open')
10
+ throw new EgretError('UI_TEXT_EDITOR_ROOT_CLOSED');
11
+ }
12
+ const access = Object.freeze({
13
+ ...port,
14
+ onClose(callback) {
15
+ open();
16
+ if (listeners.size >= 128)
17
+ throw new EgretError('UI_LIMIT');
18
+ listeners.add(callback);
19
+ return () => {
20
+ listeners.delete(callback);
21
+ };
22
+ },
23
+ onInteractionChange(callback) {
24
+ open();
25
+ if (interactions.size >= 128)
26
+ throw new EgretError('UI_LIMIT');
27
+ interactions.add(callback);
28
+ return () => {
29
+ interactions.delete(callback);
30
+ };
31
+ },
32
+ editorInteractive() {
33
+ const value = port.layerState();
34
+ return !closed && port.state() === 'open' && value.visible && value.keyboardEnabled;
35
+ },
36
+ notifyInteraction(policy) {
37
+ if (!port.layerState().lifetimeOpen)
38
+ return Object.freeze([]);
39
+ const errors = [], active = access.editorInteractive();
40
+ for (const callback of [...interactions]) {
41
+ if (closed)
42
+ break;
43
+ if (!interactions.has(callback))
44
+ continue;
45
+ try {
46
+ callback(active, policy);
47
+ }
48
+ catch (cause) {
49
+ errors.push(cause);
50
+ }
51
+ }
52
+ return Object.freeze(errors);
53
+ },
54
+ claimLayer(owner, callback) {
55
+ open();
56
+ if (layerOwner !== undefined)
57
+ throw new EgretError('UI_LAYER_ROOT_OWNED');
58
+ layerOwner = owner;
59
+ dismiss = callback;
60
+ port.layerOwnership(true);
61
+ return () => {
62
+ if (layerOwner === owner) {
63
+ port.layerOwnership(false);
64
+ layerOwner = undefined;
65
+ dismiss = undefined;
66
+ }
67
+ };
68
+ },
69
+ requestDismiss() {
70
+ return !closed && dismiss !== undefined ? dismiss() : false;
71
+ }
72
+ });
73
+ roots.set(root, { engine, access });
74
+ return () => {
75
+ if (closed)
76
+ return Object.freeze([]);
77
+ closed = true;
78
+ port.layerOwnership(false);
79
+ layerOwner = undefined;
80
+ dismiss = undefined;
81
+ interactions.clear();
82
+ const current = [...listeners];
83
+ listeners.clear();
84
+ const errors = [];
85
+ for (const callback of current)
86
+ try {
87
+ callback();
88
+ }
89
+ catch (cause) {
90
+ errors.push(cause);
91
+ }
92
+ return Object.freeze(errors);
93
+ };
94
+ }
95
+ export function requireUiRoot(root, engine) {
96
+ const record = roots.get(root);
97
+ if (record === undefined || record.engine !== engine)
98
+ throw new EgretError('UI_TEXT_EDITOR_ROOT_INVALID');
99
+ if (record.access.state() !== 'open')
100
+ throw new EgretError('UI_TEXT_EDITOR_ROOT_CLOSED');
101
+ return record.access;
102
+ }
103
+ //# sourceMappingURL=uiRootState.js.map
@@ -0,0 +1,13 @@
1
+ import type { KeyboardInput, KeyboardInputOptions } from './keyboardInputTypes.js';
2
+ export type * from './keyboardInputTypes.js';
3
+ interface Binding {
4
+ readonly surface: object;
5
+ report(cause: unknown): void;
6
+ onClose(callback: () => void): () => void;
7
+ onInteractive(callback: (active: boolean) => void): () => void;
8
+ }
9
+ /** Private browser binding reuses the genuine eager Engine authority. */
10
+ export declare function bindKeyboardSurface(input: KeyboardInput): Binding;
11
+ /** Keyboard input for the stage: key events go to the focused target, and focus moves with Tab. */
12
+ export declare function createKeyboardInput(options: KeyboardInputOptions): KeyboardInput;
13
+ //# sourceMappingURL=keyboardInput.d.ts.map
@@ -0,0 +1,579 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError, Event, createEventType } from '@egret/runtime';
3
+ import { captureMouseInputRuntimePrimitives, requireMouseInputEngine } from './internal/mouseInputFactoryState.js';
4
+ import { captureUiInputDelivery, registerUiKeyboardInput } from './internal/uiFactoryState.js';
5
+ const primitives = captureMouseInputRuntimePrimitives();
6
+ const bindings = new WeakMap();
7
+ const reasons = new Set([
8
+ 'focus',
9
+ 'rebind',
10
+ 'removed',
11
+ 'owner',
12
+ 'suspended',
13
+ 'dispose',
14
+ 'blur',
15
+ 'hidden',
16
+ 'pagehide',
17
+ 'error'
18
+ ]);
19
+ function fail(code) {
20
+ throw new EgretError(code);
21
+ }
22
+ function idValid(id) {
23
+ return typeof id === 'string' && id.length > 0 && id.length <= 128 && !id.includes('\0');
24
+ }
25
+ function object(value) {
26
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
27
+ }
28
+ function sample(value) {
29
+ if (!object(value))
30
+ fail('KEYBOARD_INPUT_SAMPLE_INVALID');
31
+ const code = value.code, key = value.key;
32
+ if (typeof code !== 'string' ||
33
+ code.length < 1 ||
34
+ code.length > 64 ||
35
+ typeof key !== 'string' ||
36
+ key.length < 1 ||
37
+ key.length > 128)
38
+ fail('KEYBOARD_INPUT_SAMPLE_INVALID');
39
+ const repeat = value.repeat, altKey = value.altKey, ctrlKey = value.ctrlKey, metaKey = value.metaKey, shiftKey = value.shiftKey;
40
+ const result = {
41
+ code,
42
+ key,
43
+ repeat: repeat === undefined ? false : repeat,
44
+ altKey: altKey === undefined ? false : altKey,
45
+ ctrlKey: ctrlKey === undefined ? false : ctrlKey,
46
+ metaKey: metaKey === undefined ? false : metaKey,
47
+ shiftKey: shiftKey === undefined ? false : shiftKey
48
+ };
49
+ if ([result.repeat, result.altKey, result.ctrlKey, result.metaKey, result.shiftKey].some(v => typeof v !== 'boolean'))
50
+ fail('KEYBOARD_INPUT_SAMPLE_INVALID');
51
+ return Object.freeze(result);
52
+ }
53
+ /** Private browser binding reuses the genuine eager Engine authority. */
54
+ export function bindKeyboardSurface(input) {
55
+ return bindings.get(input) ?? fail('KEYBOARD_INPUT_CLOSED');
56
+ }
57
+ /** Keyboard input for the stage: key events go to the focused target, and focus moves with Tab. */
58
+ export function createKeyboardInput(options) {
59
+ if (!object(options))
60
+ fail('KEYBOARD_INPUT_OPTIONS_INVALID');
61
+ const engine = options.engine;
62
+ let owner = requireMouseInputEngine(engine);
63
+ let scope = owner.scope(options.scope);
64
+ let operations = owner.operations;
65
+ const deliver = captureUiInputDelivery(engine);
66
+ const requestedTargets = options.maxTargets, requestedKeys = options.maxKeys, requestedNodes = options.maxNodes;
67
+ const maxTargets = requestedTargets === undefined ? 4096 : requestedTargets, maxKeys = requestedKeys === undefined ? 64 : requestedKeys, maxNodes = requestedNodes === undefined ? 4096 : requestedNodes;
68
+ let observer = options.onFocusChange;
69
+ for (const [value, max] of [
70
+ [maxTargets, 65536],
71
+ [maxKeys, 256],
72
+ [maxNodes, 65536]
73
+ ])
74
+ if (!Number.isInteger(value) || value < 1 || value > max)
75
+ fail('KEYBOARD_INPUT_OPTIONS_INVALID');
76
+ if (observer !== undefined && typeof observer !== 'function')
77
+ fail('KEYBOARD_INPUT_OPTIONS_INVALID');
78
+ const events = Object.freeze({
79
+ keyDown: createEventType('egret.keyboard.keyDown', { bubbles: true, cancelable: true }),
80
+ keyUp: createEventType('egret.keyboard.keyUp', { bubbles: true, cancelable: true }),
81
+ cancel: createEventType('egret.keyboard.cancel', { bubbles: true }),
82
+ focusIn: createEventType('egret.keyboard.focusIn', { bubbles: true }),
83
+ focusOut: createEventType('egret.keyboard.focusOut', { bubbles: true })
84
+ });
85
+ const records = new Map(), held = new Map(), closers = new Set();
86
+ const interactive = new Set();
87
+ const activeKeys = new Set();
88
+ const activeFocus = new Set();
89
+ let state = 'active', focused, focusVisible = false, notifying = 0, revision = 0, calls = 0, callbackFailed = false;
90
+ let releaseEngine, input, keyBusy = false;
91
+ const report = owner.report;
92
+ let focusOwner, focusRoots;
93
+ function assertOpen() {
94
+ if (state === 'closed')
95
+ fail('KEYBOARD_INPUT_CLOSED');
96
+ owner.assertReady();
97
+ scope.assertOpen();
98
+ }
99
+ function assertMutation() {
100
+ assertOpen();
101
+ if (notifying !== 0)
102
+ fail('KEYBOARD_INPUT_REENTRANT');
103
+ }
104
+ function eligible(value) {
105
+ if (value.disabled || operations === undefined)
106
+ return false;
107
+ if (primitives.disposed(value.target) === true || !operations.isAttached(value.target, maxNodes))
108
+ return false;
109
+ let node = value.target, count = 0, contained = focusRoots === undefined;
110
+ while (node !== undefined) {
111
+ if (++count > maxNodes)
112
+ fail('HIT_TEST_TREE_LIMIT');
113
+ if (primitives.visible(node) !== true)
114
+ return false;
115
+ if (focusRoots?.includes(node))
116
+ contained = true;
117
+ node = primitives.parent(node);
118
+ }
119
+ return contained;
120
+ }
121
+ function callout(action) {
122
+ try {
123
+ return deliver(action);
124
+ }
125
+ catch (cause) {
126
+ callbackFailed = true;
127
+ throw cause;
128
+ }
129
+ }
130
+ function route(target, type, payload, active) {
131
+ if (operations === undefined || owner === undefined)
132
+ return false;
133
+ try {
134
+ owner.assertReady();
135
+ scope?.assertOpen();
136
+ }
137
+ catch (cause) {
138
+ if (cause instanceof EgretError && (cause.code === 'ENGINE_CLOSED' || cause.code === 'SCOPE_CLOSED'))
139
+ return false;
140
+ throw cause;
141
+ }
142
+ if (!operations.isAttached(target, maxNodes))
143
+ return false;
144
+ const event = Object.freeze(new Event(type, payload));
145
+ active?.add(event);
146
+ try {
147
+ callout(() => operations.dispatch(target, event, maxNodes));
148
+ return event.defaultPrevented;
149
+ }
150
+ finally {
151
+ active?.delete(event);
152
+ }
153
+ }
154
+ function stopKeys() {
155
+ for (const event of activeKeys)
156
+ event.stopImmediatePropagation();
157
+ }
158
+ function drain(reason) {
159
+ const keys = [...held.values()];
160
+ held.clear();
161
+ stopKeys();
162
+ let failure, failed = false;
163
+ for (const value of keys)
164
+ try {
165
+ route(value.focus.target, events.cancel, Object.freeze({ ...value.sample, targetId: value.focus.record.id, reason }));
166
+ }
167
+ catch (cause) {
168
+ if (!failed) {
169
+ failed = true;
170
+ failure = cause;
171
+ }
172
+ }
173
+ if (failed)
174
+ throw failure;
175
+ }
176
+ // Focus notification recursion is rejected before mutation. Key handlers may
177
+ // transfer focus or dispose; committed epochs suppress the older continuation.
178
+ function transition(next, nextVisible, reason, cancelReason) {
179
+ const previous = focused;
180
+ if (previous?.record === next?.record && previous?.target === next?.target) {
181
+ focusVisible = next !== undefined && nextVisible;
182
+ return;
183
+ }
184
+ focused = next;
185
+ focusVisible = next !== undefined && nextVisible;
186
+ const epoch = ++revision;
187
+ stopKeys();
188
+ let failure, failed = false;
189
+ const attempt = (action) => {
190
+ try {
191
+ action();
192
+ }
193
+ catch (cause) {
194
+ if (!failed) {
195
+ failure = cause;
196
+ failed = true;
197
+ }
198
+ }
199
+ };
200
+ function reconcile() {
201
+ if (state === 'active' &&
202
+ revision === epoch &&
203
+ focused === next &&
204
+ next !== undefined &&
205
+ (records.get(next.record.id) !== next.record || !eligible(next.record)))
206
+ transition(undefined, false, 'owner', 'owner');
207
+ }
208
+ notifying++;
209
+ try {
210
+ attempt(() => drain(cancelReason));
211
+ if (previous !== undefined)
212
+ attempt(() => {
213
+ route(previous.target, events.focusOut, Object.freeze({ targetId: previous.record.id, relatedId: next?.record.id, reason, focusVisible }), activeFocus);
214
+ });
215
+ attempt(() => reconcile());
216
+ if (!failed &&
217
+ revision === epoch &&
218
+ focused === next &&
219
+ next !== undefined &&
220
+ state === 'active' &&
221
+ records.get(next.record.id) === next.record &&
222
+ eligible(next.record))
223
+ attempt(() => {
224
+ route(next.target, events.focusIn, Object.freeze({ targetId: next.record.id, relatedId: previous?.record.id, reason, focusVisible }), activeFocus);
225
+ });
226
+ attempt(() => reconcile());
227
+ if (!failed && revision === epoch)
228
+ attempt(() => callout(() => observer?.(Object.freeze({ previousId: previous?.record.id, focusedId: focused?.record.id, reason, focusVisible }))));
229
+ attempt(() => reconcile());
230
+ }
231
+ finally {
232
+ notifying--;
233
+ }
234
+ if (failed)
235
+ throw failure;
236
+ }
237
+ function close(reason) {
238
+ if (state === 'closed')
239
+ return;
240
+ state = 'closed';
241
+ for (const event of activeFocus)
242
+ event.stopImmediatePropagation();
243
+ let failure, failed = false;
244
+ const attempt = (action) => {
245
+ try {
246
+ action();
247
+ }
248
+ catch (cause) {
249
+ if (!failed) {
250
+ failed = true;
251
+ failure = cause;
252
+ }
253
+ }
254
+ };
255
+ attempt(() => transition(undefined, false, reason, reason));
256
+ attempt(() => drain(reason));
257
+ records.clear();
258
+ focusRoots = undefined;
259
+ focusOwner = undefined;
260
+ bindings.delete(input);
261
+ attempt(() => releaseEngine?.());
262
+ releaseEngine = undefined;
263
+ attempt(() => scope?.remove(retire));
264
+ const callbacks = [...closers];
265
+ closers.clear();
266
+ for (const callback of callbacks)
267
+ attempt(callback);
268
+ interactive.clear();
269
+ if (calls === 0)
270
+ release();
271
+ if (failed)
272
+ throw failure;
273
+ }
274
+ function release() {
275
+ owner = undefined;
276
+ scope = undefined;
277
+ operations = undefined;
278
+ observer = undefined;
279
+ }
280
+ function invoke(action) {
281
+ calls++;
282
+ try {
283
+ return action();
284
+ }
285
+ catch (cause) {
286
+ if (callbackFailed && state !== 'closed')
287
+ try {
288
+ close('error');
289
+ }
290
+ catch {
291
+ /* Original callback failure remains authoritative. */
292
+ }
293
+ throw cause;
294
+ }
295
+ finally {
296
+ if (--calls === 0) {
297
+ callbackFailed = false;
298
+ if (state === 'closed')
299
+ release();
300
+ }
301
+ }
302
+ }
303
+ function orderedTargets() {
304
+ return [...records.values()]
305
+ .filter(v => v.tabIndex >= 0 && eligible(v))
306
+ .sort((a, b) => {
307
+ if (a.tabIndex === 0)
308
+ return b.tabIndex === 0 ? 0 : 1;
309
+ if (b.tabIndex === 0)
310
+ return -1;
311
+ return a.tabIndex - b.tabIndex;
312
+ });
313
+ }
314
+ function retire() {
315
+ invoke(() => close('owner'));
316
+ }
317
+ function sync() {
318
+ if (state === 'closed')
319
+ return;
320
+ assertMutation();
321
+ if (focused !== undefined && !eligible(focused.record))
322
+ transition(undefined, false, 'owner', 'owner');
323
+ }
324
+ function validateTarget(target) {
325
+ if (operations === undefined || primitives.disposed(target) === true || !operations.isAttached(target, maxNodes))
326
+ fail('KEYBOARD_TARGET_INVALID');
327
+ }
328
+ function settings(target, tabIndex, disabled) {
329
+ if (!Number.isInteger(tabIndex) || tabIndex < -1 || tabIndex > 32767 || typeof disabled !== 'boolean')
330
+ fail('KEYBOARD_TARGET_INVALID');
331
+ validateTarget(target);
332
+ }
333
+ function focus(id, configuration = {}) {
334
+ assertMutation();
335
+ if (!object(configuration))
336
+ fail('KEYBOARD_INPUT_FOCUS_INVALID');
337
+ const requestedVisible = configuration.visible, requestedReason = configuration.reason;
338
+ assertMutation();
339
+ if ((requestedVisible !== undefined && typeof requestedVisible !== 'boolean') ||
340
+ (requestedReason !== undefined && !['programmatic', 'keyboard', 'pointer'].includes(requestedReason)))
341
+ fail('KEYBOARD_INPUT_FOCUS_INVALID');
342
+ if (id !== undefined && !idValid(id))
343
+ fail('KEYBOARD_INPUT_FOCUS_INVALID');
344
+ const record = id === undefined ? undefined : records.get(id);
345
+ if (id !== undefined && (record === undefined || state !== 'active' || !eligible(record)))
346
+ fail('KEYBOARD_TARGET_INELIGIBLE');
347
+ const reason = requestedReason ?? 'programmatic';
348
+ transition(record === undefined ? undefined : { record, target: record.target }, requestedVisible ?? reason === 'keyboard', reason, 'focus');
349
+ }
350
+ function key(kind, raw) {
351
+ if (state !== 'active')
352
+ return false;
353
+ assertOpen();
354
+ if (notifying !== 0 || keyBusy)
355
+ fail('KEYBOARD_INPUT_REENTRANT');
356
+ const copied = sample(raw);
357
+ assertMutation();
358
+ sync();
359
+ const current = focused;
360
+ if (current === undefined)
361
+ return false;
362
+ const previous = held.get(copied.code);
363
+ if (kind === 'keyUp') {
364
+ if (previous === undefined || previous.focus !== current)
365
+ return false;
366
+ held.delete(copied.code);
367
+ }
368
+ else {
369
+ if (previous !== undefined && previous.focus !== current)
370
+ return false;
371
+ if (previous === undefined) {
372
+ if (copied.repeat)
373
+ return false;
374
+ if (held.size >= maxKeys)
375
+ fail('KEYBOARD_INPUT_KEY_CAPACITY');
376
+ held.set(copied.code, { focus: current, sample: copied });
377
+ }
378
+ }
379
+ keyBusy = true;
380
+ try {
381
+ const prevented = route(current.target, events[kind], Object.freeze({ ...copied, targetId: current.record.id }), activeKeys);
382
+ if (input.getSnapshot().state !== 'closed')
383
+ sync();
384
+ return prevented;
385
+ }
386
+ finally {
387
+ keyBusy = false;
388
+ }
389
+ }
390
+ input = Object.freeze({
391
+ events,
392
+ registerTarget: (configuration) => invoke(() => {
393
+ assertMutation();
394
+ if (!object(configuration))
395
+ fail('KEYBOARD_TARGET_INVALID');
396
+ const id = configuration.id, target = configuration.target, requestedIndex = configuration.tabIndex, requestedDisabled = configuration.disabled;
397
+ const tabIndex = requestedIndex === undefined ? 0 : requestedIndex, disabled = requestedDisabled === undefined ? false : requestedDisabled;
398
+ assertMutation();
399
+ if (!idValid(id) || records.has(id) || records.size >= maxTargets)
400
+ fail('KEYBOARD_TARGET_INVALID');
401
+ settings(target, tabIndex, disabled);
402
+ assertMutation();
403
+ if (records.has(id) || records.size >= maxTargets)
404
+ fail('KEYBOARD_TARGET_INVALID');
405
+ const record = { id, target, tabIndex, disabled };
406
+ records.set(id, record);
407
+ return Object.freeze({
408
+ update: (update) => invoke(() => {
409
+ assertMutation();
410
+ if (records.get(id) !== record)
411
+ fail('KEYBOARD_REGISTRATION_CLOSED');
412
+ if (!object(update))
413
+ fail('KEYBOARD_TARGET_INVALID');
414
+ const nextTarget = update.target ?? record.target, nextIndex = update.tabIndex ?? record.tabIndex, nextDisabled = update.disabled ?? record.disabled;
415
+ settings(nextTarget, nextIndex, nextDisabled);
416
+ assertMutation();
417
+ if (records.get(id) !== record)
418
+ fail('KEYBOARD_REGISTRATION_CLOSED');
419
+ const was = focused?.record === record, rebind = record.target !== nextTarget;
420
+ record.target = nextTarget;
421
+ record.tabIndex = nextIndex;
422
+ record.disabled = nextDisabled;
423
+ if (was) {
424
+ if (!eligible(record))
425
+ transition(undefined, false, 'owner', 'owner');
426
+ else if (rebind)
427
+ transition({ record, target: nextTarget }, focusVisible, 'rebind', 'rebind');
428
+ }
429
+ }),
430
+ dispose: () => invoke(() => {
431
+ if (records.get(id) !== record)
432
+ return;
433
+ // Retirement remains legal during owner shutdown and cancellation callbacks.
434
+ // Removing identity first makes recursive disposal harmless; no new target is admitted.
435
+ records.delete(id);
436
+ if (focused?.record === record) {
437
+ for (const event of activeFocus)
438
+ event.stopImmediatePropagation();
439
+ transition(undefined, false, 'removed', 'removed');
440
+ }
441
+ })
442
+ });
443
+ }),
444
+ focus: (id, configuration) => invoke(() => focus(id, configuration)),
445
+ moveFocus: (direction, wrap = false) => invoke(() => {
446
+ assertMutation();
447
+ if (!['next', 'previous'].includes(direction) || typeof wrap !== 'boolean')
448
+ fail('KEYBOARD_INPUT_FOCUS_INVALID');
449
+ if (state !== 'active')
450
+ return undefined;
451
+ sync();
452
+ const values = orderedTargets();
453
+ const current = values.findIndex(v => v === focused?.record), delta = direction === 'next' ? 1 : -1;
454
+ let index = current === -1 ? (delta === 1 ? 0 : values.length - 1) : current + delta;
455
+ if ((wrap || focusRoots !== undefined) && values.length > 0)
456
+ index = (index + values.length) % values.length;
457
+ // A scope with no tabbable children retains its Escape sentinel.
458
+ if (focusRoots !== undefined && values.length === 0)
459
+ return focused?.record.id;
460
+ const next = values[index];
461
+ focus(next?.id, { reason: 'keyboard' });
462
+ return focused?.record.id;
463
+ }),
464
+ keyDown: (raw) => invoke(() => key('keyDown', raw)),
465
+ keyUp: (raw) => invoke(() => key('keyUp', raw)),
466
+ cancel: (reason = 'focus') => invoke(() => {
467
+ if (!reasons.has(reason))
468
+ fail('KEYBOARD_INPUT_CANCEL_INVALID');
469
+ if (state === 'closed')
470
+ return;
471
+ assertMutation();
472
+ transition(undefined, false, reason, reason);
473
+ drain(reason);
474
+ }),
475
+ sync: () => invoke(sync),
476
+ setInteractive: (value) => invoke(() => {
477
+ assertMutation();
478
+ if (typeof value !== 'boolean')
479
+ fail('KEYBOARD_INPUT_OPTIONS_INVALID');
480
+ if (value) {
481
+ state = 'active';
482
+ for (const callback of interactive)
483
+ callout(() => callback(true));
484
+ return;
485
+ }
486
+ state = 'suspended';
487
+ transition(undefined, false, 'suspended', 'suspended');
488
+ drain('suspended');
489
+ for (const callback of interactive)
490
+ callout(() => callback(false));
491
+ }),
492
+ getSnapshot: () => Object.freeze({
493
+ state,
494
+ focusedId: focused?.record.id,
495
+ focusVisible,
496
+ pressedKeys: Object.freeze([...held.keys()]),
497
+ targetCount: records.size
498
+ }),
499
+ dispose: () => invoke(() => close('dispose'))
500
+ });
501
+ try {
502
+ releaseEngine = owner.onClose(retire);
503
+ scope.add(retire);
504
+ scope.use(input);
505
+ bindings.set(input, Object.freeze({
506
+ surface: owner.surface,
507
+ onInteractive: (callback) => {
508
+ interactive.add(callback);
509
+ return () => {
510
+ interactive.delete(callback);
511
+ };
512
+ },
513
+ report: (cause) => report({ code: 'KEYBOARD_INPUT_HOST_FAILED', phase: 'engine', severity: 'error', cause }),
514
+ onClose: (callback) => {
515
+ if (state === 'closed') {
516
+ callback();
517
+ return () => { };
518
+ }
519
+ closers.add(callback);
520
+ return () => {
521
+ closers.delete(callback);
522
+ };
523
+ }
524
+ }));
525
+ owner.assertReady();
526
+ scope.assertOpen();
527
+ registerUiKeyboardInput(input, engine, (claimant) => {
528
+ assertMutation();
529
+ if (focusOwner !== undefined && focusOwner !== claimant)
530
+ fail('KEYBOARD_FOCUS_SCOPE_ACTIVE');
531
+ focusOwner = claimant;
532
+ let released = false;
533
+ return Object.freeze({
534
+ setRoots: (roots) => invoke(() => {
535
+ assertMutation();
536
+ if (released || focusOwner !== claimant)
537
+ fail('KEYBOARD_FOCUS_SCOPE_CLOSED');
538
+ if (roots !== undefined) {
539
+ if (!Array.isArray(roots) || roots.length < 1 || roots.length > 32)
540
+ fail('KEYBOARD_FOCUS_SCOPE_INVALID');
541
+ for (const root of roots)
542
+ validateTarget(root);
543
+ }
544
+ focusRoots = roots === undefined ? undefined : Object.freeze([...roots]);
545
+ sync();
546
+ }),
547
+ focusFirst: () => invoke(() => {
548
+ assertMutation();
549
+ if (released || focusOwner !== claimant)
550
+ fail('KEYBOARD_FOCUS_SCOPE_CLOSED');
551
+ if (state !== 'active')
552
+ return;
553
+ sync();
554
+ focus(orderedTargets()[0]?.id, { reason: 'programmatic' });
555
+ }),
556
+ release: () => {
557
+ if (released)
558
+ return;
559
+ released = true;
560
+ if (focusOwner !== claimant)
561
+ return;
562
+ focusRoots = undefined;
563
+ focusOwner = undefined;
564
+ }
565
+ });
566
+ });
567
+ return input;
568
+ }
569
+ catch (cause) {
570
+ try {
571
+ close('error');
572
+ }
573
+ catch {
574
+ /* Preserve setup failure. */
575
+ }
576
+ throw cause;
577
+ }
578
+ }
579
+ //# sourceMappingURL=keyboardInput.js.map