@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,418 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ /** Roles a native button carries well: it is activated by a click from any assistive technology. */
4
+ const pressable = [
5
+ 'button',
6
+ 'checkbox',
7
+ 'switch',
8
+ 'radio',
9
+ 'option',
10
+ 'tab',
11
+ 'menuitem',
12
+ 'gridcell',
13
+ 'columnheader',
14
+ 'treeitem'
15
+ ];
16
+ const aria = {
17
+ group: 'group',
18
+ image: 'img',
19
+ checkbox: 'checkbox',
20
+ switch: 'switch',
21
+ radiogroup: 'radiogroup',
22
+ radio: 'radio',
23
+ listbox: 'listbox',
24
+ option: 'option',
25
+ list: 'list',
26
+ listitem: 'listitem',
27
+ scrollbar: 'scrollbar',
28
+ slider: 'slider',
29
+ spinbutton: 'spinbutton',
30
+ progressbar: 'progressbar',
31
+ tablist: 'tablist',
32
+ tab: 'tab',
33
+ tabpanel: 'tabpanel',
34
+ menu: 'menu',
35
+ menuitem: 'menuitem',
36
+ dialog: 'dialog',
37
+ textbox: 'textbox',
38
+ status: 'status',
39
+ alert: 'alert',
40
+ grid: 'grid',
41
+ row: 'row',
42
+ gridcell: 'gridcell',
43
+ columnheader: 'columnheader',
44
+ tree: 'tree',
45
+ treeitem: 'treeitem',
46
+ heading: 'heading'
47
+ };
48
+ /** Roles whose name is their content: a reader reads the text, and says a message when the text changes. */
49
+ const worded = ['text', 'status', 'alert', 'heading'];
50
+ const ownedSurfaces = new WeakSet();
51
+ const finite = (value) => typeof value === 'number' && Number.isFinite(value);
52
+ let containers = 0;
53
+ /**
54
+ * Projects a semantic tree to the page, for assistive technology. The canvas stays the one element
55
+ * with the keyboard: it owns an invisible container of elements laid over it, one for each
56
+ * published node, and names the focused one as its active descendant. Nothing here draws, and a
57
+ * pointer goes through to the canvas.
58
+ */
59
+ export function createBrowserSemantics(options) {
60
+ if (options === null || typeof options !== 'object')
61
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
62
+ const { semantics, canvas: surface, width, height, label, onError } = options;
63
+ if (semantics === null ||
64
+ typeof semantics !== 'object' ||
65
+ typeof semantics.observe !== 'function' ||
66
+ typeof semantics.perform !== 'function' ||
67
+ surface === null ||
68
+ typeof surface !== 'object' ||
69
+ !finite(width) ||
70
+ width <= 0 ||
71
+ !finite(height) ||
72
+ height <= 0 ||
73
+ (label !== undefined && (typeof label !== 'string' || !/\S/.test(label) || label.length > 1024)) ||
74
+ (onError !== undefined && typeof onError !== 'function'))
75
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
76
+ if (semantics.state === 'closed')
77
+ throw new EgretError('UI_SEMANTICS_CLOSED');
78
+ const win = globalThis.window, page = globalThis.document;
79
+ if (win === undefined || page === undefined || typeof win.getComputedStyle !== 'function')
80
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID');
81
+ const projected = new Map(), identities = new WeakMap();
82
+ const pairs = [], restores = [];
83
+ let closed = false, owned, container, elements = 0, placed = '';
84
+ function report(cause) {
85
+ if (onError !== undefined)
86
+ onError(cause);
87
+ else if (typeof globalThis.reportError === 'function')
88
+ globalThis.reportError(cause);
89
+ }
90
+ function cleanup() {
91
+ if (closed)
92
+ return;
93
+ closed = true;
94
+ const failures = [];
95
+ const attempt = (action) => {
96
+ try {
97
+ action();
98
+ }
99
+ catch (cause) {
100
+ failures.push(cause);
101
+ }
102
+ };
103
+ for (const pair of pairs.splice(0).reverse())
104
+ attempt(() => pair.target.removeEventListener(pair.type, pair.listener, pair.options));
105
+ for (const restore of restores.splice(0).reverse())
106
+ attempt(restore);
107
+ attempt(() => container?.remove());
108
+ projected.clear();
109
+ if (owned !== undefined) {
110
+ ownedSurfaces.delete(owned);
111
+ owned = undefined;
112
+ }
113
+ for (const cause of failures)
114
+ report(cause);
115
+ }
116
+ function fail(cause) {
117
+ cleanup();
118
+ report(cause);
119
+ }
120
+ /** The rectangle of the canvas on the page, refused unless one scale and one offset map it. */
121
+ function profile() {
122
+ if (typeof surface.getBoundingClientRect !== 'function' ||
123
+ surface.ownerDocument !== page ||
124
+ surface.isConnected !== true)
125
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID');
126
+ let current = surface, depth = 0;
127
+ while (current !== page) {
128
+ if (current === null || current.nodeType !== 1 || ++depth > 64)
129
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID');
130
+ const style = win.getComputedStyle(current), read = (name) => style.getPropertyValue(name).trim();
131
+ if (['transform', 'perspective', 'translate', 'rotate', 'scale'].some(name => read(name) !== 'none'))
132
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID');
133
+ const zoom = read('zoom');
134
+ if (zoom !== 'normal' && zoom !== '1')
135
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID');
136
+ current = current.parentNode;
137
+ }
138
+ const rect = measure(surface);
139
+ if (rect.width <= 0 || rect.height <= 0)
140
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID');
141
+ return rect;
142
+ }
143
+ function measure(element) {
144
+ const rect = element.getBoundingClientRect();
145
+ if (!finite(rect.left) || !finite(rect.top) || !finite(rect.width) || !finite(rect.height))
146
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID');
147
+ return rect;
148
+ }
149
+ /** Lays the container over the canvas: logical units inside it, one scale to the page outside. */
150
+ function place() {
151
+ const rect = measure(surface);
152
+ // A canvas the page is not showing has nothing over it to read, until it is shown again.
153
+ if (rect.width <= 0 || rect.height <= 0) {
154
+ if (placed !== 'display:none')
155
+ container.style.cssText = placed = 'display:none';
156
+ return;
157
+ }
158
+ const style = (left, top) => 'position:fixed;left:' +
159
+ left +
160
+ 'px;top:' +
161
+ top +
162
+ 'px;width:' +
163
+ width +
164
+ 'px;height:' +
165
+ height +
166
+ 'px;transform-origin:0 0;transform:scale(' +
167
+ rect.width / width +
168
+ ',' +
169
+ rect.height / height +
170
+ ');overflow:hidden;pointer-events:none;opacity:0;margin:0;padding:0;border:0';
171
+ const wanted = style(rect.left, rect.top);
172
+ if (wanted === placed)
173
+ return;
174
+ container.style.cssText = wanted;
175
+ placed = wanted;
176
+ // An ancestor can be what a fixed element is placed against. Where it landed says by how much.
177
+ const landed = measure(container), dx = rect.left - landed.left, dy = rect.top - landed.top;
178
+ if (dx !== 0 || dy !== 0)
179
+ container.style.cssText = style(rect.left + dx, rect.top + dy);
180
+ }
181
+ function write(item, name, value) {
182
+ if (item.written.get(name) === value && item.written.has(name))
183
+ return;
184
+ item.written.set(name, value);
185
+ if (name === 'text')
186
+ item.element.textContent = value ?? '';
187
+ else if (name === 'style')
188
+ item.element.style.cssText = value ?? '';
189
+ else if (value === undefined)
190
+ item.element.removeAttribute(name);
191
+ else
192
+ item.element.setAttribute(name, value);
193
+ }
194
+ function create(node) {
195
+ const native = pressable.includes(node.role), element = page.createElement(native ? 'button' : 'div');
196
+ element.id = container.id + '-' + ++elements;
197
+ // A native button is a stop of the Tab key unless it says otherwise, and no element here is one: the canvas keeps the keyboard.
198
+ if (native) {
199
+ element.setAttribute('type', 'button');
200
+ element.setAttribute('tabindex', '-1');
201
+ }
202
+ const role = aria[node.role];
203
+ if (role !== undefined)
204
+ element.setAttribute('role', role);
205
+ const item = { id: node.id, role: node.role, element, written: new Map() };
206
+ projected.set(node.id, item);
207
+ identities.set(element, node.id);
208
+ return item;
209
+ }
210
+ function drop(item) {
211
+ if (projected.get(item.id) === item)
212
+ projected.delete(item.id);
213
+ identities.delete(item.element);
214
+ item.element.remove();
215
+ }
216
+ const text = (value) => value === undefined ? undefined : String(value);
217
+ function apply(snapshot) {
218
+ place();
219
+ const nodes = new Map(snapshot.nodes.map(node => [node.id, node]));
220
+ for (const item of [...projected.values()])
221
+ if (nodes.get(item.id)?.role !== item.role)
222
+ drop(item);
223
+ const cursors = new Map();
224
+ for (const node of snapshot.nodes) {
225
+ const item = projected.get(node.id) ?? create(node), parent = node.parent === undefined ? undefined : nodes.get(node.parent);
226
+ const holder = parent === undefined ? container : projected.get(parent.id).element, cursor = cursors.get(holder) ?? 0;
227
+ // Reading order is the order of the elements.
228
+ if (holder.children[cursor] !== item.element)
229
+ holder.insertBefore(item.element, holder.children[cursor] ?? null);
230
+ cursors.set(holder, cursor + 1);
231
+ const { bounds } = node;
232
+ write(item, 'style', 'position:absolute;box-sizing:border-box;margin:0;padding:0;border:0;left:' +
233
+ (bounds.x - (parent?.bounds.x ?? 0)) +
234
+ 'px;top:' +
235
+ (bounds.y - (parent?.bounds.y ?? 0)) +
236
+ 'px;width:' +
237
+ bounds.width +
238
+ 'px;height:' +
239
+ bounds.height +
240
+ 'px');
241
+ if (worded.includes(node.role))
242
+ write(item, 'text', node.name);
243
+ else {
244
+ write(item, 'aria-label', node.name === '' ? undefined : node.name);
245
+ if (node.role === 'textbox')
246
+ write(item, 'text', node.value);
247
+ }
248
+ write(item, 'aria-disabled', node.disabled ? 'true' : undefined);
249
+ write(item, 'aria-checked', text(node.checked));
250
+ write(item, 'aria-selected', text(node.selected));
251
+ write(item, 'aria-expanded', text(node.expanded));
252
+ write(item, 'aria-modal', node.modal === true ? 'true' : undefined);
253
+ write(item, 'aria-multiline', node.multiline === true ? 'true' : undefined);
254
+ write(item, 'aria-multiselectable', node.multiple === true ? 'true' : undefined);
255
+ write(item, 'aria-valuenow', text(node.range?.now));
256
+ write(item, 'aria-valuemin', text(node.range?.min));
257
+ write(item, 'aria-valuemax', text(node.range?.max));
258
+ write(item, 'aria-orientation', node.orientation);
259
+ // A row says which row of the grid it is and a cell which column it is in; the grid says how many there are. Elsewhere a position is a place in a set.
260
+ const placed = node.role === 'row'
261
+ ? 'aria-rowindex'
262
+ : node.role === 'gridcell' || node.role === 'columnheader'
263
+ ? 'aria-colindex'
264
+ : undefined;
265
+ write(item, 'aria-posinset', placed === undefined ? text(node.position?.index) : undefined);
266
+ write(item, 'aria-setsize', placed === undefined ? text(node.position?.size) : undefined);
267
+ if (placed !== undefined)
268
+ write(item, placed, text(node.position?.index));
269
+ write(item, 'aria-rowcount', text(node.extent?.rows));
270
+ write(item, 'aria-colcount', text(node.extent?.columns));
271
+ write(item, 'aria-sort', node.sort);
272
+ write(item, 'aria-level', text(node.level));
273
+ // Set on the outermost inert element: the page then keeps everything under it away from every user.
274
+ write(item, 'inert', node.inert && parent?.inert !== true ? '' : undefined);
275
+ // Reachable by a request of assistive technology, never by the Tab key. A native button says so from the start, whatever it can do.
276
+ if (!pressable.includes(node.role))
277
+ write(item, 'tabindex', node.actions.includes('focus') && !node.disabled ? '-1' : undefined);
278
+ }
279
+ // A relation is written once every element it can name exists.
280
+ for (const node of snapshot.nodes)
281
+ write(projected.get(node.id), 'aria-controls', node.controls === undefined ? undefined : projected.get(node.controls).element.id);
282
+ const active = snapshot.focused === undefined ? undefined : projected.get(snapshot.focused).element.id;
283
+ if (active === undefined) {
284
+ if (surface.getAttribute('aria-activedescendant')?.startsWith(container.id + '-') === true)
285
+ surface.removeAttribute('aria-activedescendant');
286
+ }
287
+ else if (surface.getAttribute('aria-activedescendant') !== active)
288
+ surface.setAttribute('aria-activedescendant', active);
289
+ }
290
+ /** The node an event of the page is about: the nearest projected element at or above its target. */
291
+ function identify(event) {
292
+ for (let at = event.target; at !== null && at !== container; at = at.parentNode) {
293
+ const id = identities.get(at);
294
+ if (id !== undefined)
295
+ return id;
296
+ }
297
+ return undefined;
298
+ }
299
+ function perform(event, action) {
300
+ const id = identify(event);
301
+ if (id === undefined)
302
+ return;
303
+ if (action === 'activate')
304
+ event.preventDefault();
305
+ // A control that fails its own activation is told; the projection goes on for the others.
306
+ try {
307
+ semantics.perform(id, action);
308
+ }
309
+ catch (cause) {
310
+ report(cause);
311
+ }
312
+ // The keys stay with the canvas, which names the focused node as its active descendant.
313
+ if (action === 'focus' && !closed && typeof surface.focus === 'function')
314
+ surface.focus({ preventScroll: true });
315
+ }
316
+ function listen(target, type, action, settings = {}) {
317
+ // A listener the page failed to remove does nothing once the projection has closed.
318
+ const listener = event => {
319
+ if (!closed)
320
+ try {
321
+ action(event);
322
+ }
323
+ catch (cause) {
324
+ fail(cause);
325
+ }
326
+ };
327
+ pairs.push({ target, type, listener, options: settings });
328
+ target.addEventListener(type, listener, settings);
329
+ }
330
+ /** Sets an attribute of the canvas the application left unset, and takes it back only while it is still ours. */
331
+ function claim(name, value) {
332
+ if (surface.getAttribute(name) !== null)
333
+ return;
334
+ surface.setAttribute(name, value);
335
+ restores.push(() => {
336
+ if (surface.getAttribute(name) === value)
337
+ surface.removeAttribute(name);
338
+ });
339
+ }
340
+ try {
341
+ profile();
342
+ if (ownedSurfaces.has(surface))
343
+ throw new EgretError('UI_SEMANTICS_SURFACE_BUSY');
344
+ ownedSurfaces.add(surface);
345
+ owned = surface;
346
+ const holder = page.createElement('div');
347
+ do
348
+ holder.id = 'egret-semantics-' + ++containers;
349
+ while (page.getElementById(holder.id) !== null);
350
+ container = holder;
351
+ surface.after(holder);
352
+ // The canvas owns the container: the nodes are read as what is inside the application.
353
+ const owns = surface.getAttribute('aria-owns');
354
+ surface.setAttribute('aria-owns', owns === null ? holder.id : owns + ' ' + holder.id);
355
+ restores.push(() => {
356
+ if (surface.getAttribute('aria-owns') !== (owns === null ? holder.id : owns + ' ' + holder.id))
357
+ return;
358
+ if (owns === null)
359
+ surface.removeAttribute('aria-owns');
360
+ else
361
+ surface.setAttribute('aria-owns', owns);
362
+ });
363
+ restores.push(() => {
364
+ if (surface.getAttribute('aria-activedescendant')?.startsWith(holder.id + '-') === true)
365
+ surface.removeAttribute('aria-activedescendant');
366
+ });
367
+ claim('role', 'application');
368
+ if (label !== undefined)
369
+ claim('aria-label', label);
370
+ listen(holder, 'click', event => perform(event, 'activate'));
371
+ listen(holder, 'focusin', event => perform(event, 'focus'));
372
+ listen(win, 'resize', place);
373
+ listen(win, 'orientationchange', place);
374
+ listen(win, 'scroll', place, { capture: true });
375
+ const viewport = win.visualViewport;
376
+ if (viewport !== null && viewport !== undefined) {
377
+ listen(viewport, 'resize', place);
378
+ listen(viewport, 'scroll', place);
379
+ }
380
+ const stop = semantics.observe(snapshot => {
381
+ if (!closed)
382
+ try {
383
+ apply(snapshot);
384
+ }
385
+ catch (cause) {
386
+ fail(cause);
387
+ }
388
+ });
389
+ restores.push(stop);
390
+ restores.push(semantics.onClose(cleanup));
391
+ apply(semantics.snapshot);
392
+ return Object.freeze({
393
+ get state() {
394
+ return closed ? 'closed' : 'active';
395
+ },
396
+ container: holder,
397
+ elementOf: (id) => (closed ? undefined : projected.get(id)?.element),
398
+ sync() {
399
+ if (!closed)
400
+ try {
401
+ place();
402
+ }
403
+ catch (cause) {
404
+ fail(cause);
405
+ throw cause;
406
+ }
407
+ },
408
+ dispose: cleanup
409
+ });
410
+ }
411
+ catch (cause) {
412
+ cleanup();
413
+ if (cause instanceof EgretError)
414
+ throw cause;
415
+ throw new EgretError('UI_SEMANTICS_SURFACE_INVALID', { cause });
416
+ }
417
+ }
418
+ //# sourceMappingURL=BrowserSemantics.js.map
@@ -0,0 +1,56 @@
1
+ import type { SharedRenderFrame2D } from '@egret/engine';
2
+ /** What a game knows at one frame of the display. Every part may be left out; its line then shows a dash. */
3
+ export interface BrowserStatsSample {
4
+ /** The time of the display's frame in milliseconds; `performance.now()` unless given. */
5
+ readonly now?: number;
6
+ /** The frame that was drawn since the last sample, if one was. */
7
+ readonly frame?: SharedRenderFrame2D;
8
+ /** Frames the Host holds that it has not finished: `host.getStatus().pendingFrames`. */
9
+ readonly pendingFrames?: number;
10
+ /** Frames drawn and frames skipped so far, as a frame loop's `snapshot()` gives them. */
11
+ readonly frames?: number;
12
+ readonly skipped?: number;
13
+ /**
14
+ * The draw calls the Host made for its last frame, `host.getFrameDrawCalls()`: fewer than the
15
+ * frame's commands when they are batched, more when effects need passes of their own.
16
+ */
17
+ readonly drawCalls?: number;
18
+ }
19
+ /** The numbers the panel shows, as of its last refresh. */
20
+ export interface BrowserStatsSnapshot {
21
+ /** Frames of the display a second, and the longest time between two of them, in milliseconds, since the refresh before. */
22
+ readonly fps: number;
23
+ readonly longestFrameMs: number;
24
+ /** Of the last frame drawn: its commands, the triangles they draw, its different geometries and its pages. */
25
+ readonly commands: number;
26
+ readonly triangles: number;
27
+ readonly geometries: number;
28
+ readonly pages: number;
29
+ readonly pendingFrames: number;
30
+ readonly frames: number;
31
+ readonly skipped: number;
32
+ /** The draw calls the Host made for the last frame, or 0 when they were not given. */
33
+ readonly drawCalls: number;
34
+ }
35
+ /** A stats panel to make: the canvas it sits over, its label, and how often it updates. */
36
+ export interface BrowserStatsPanelOptions {
37
+ /** The canvas the panel lies over: it is placed at the canvas's top left corner. */
38
+ readonly canvas: HTMLCanvasElement;
39
+ /** A line at the top of the panel, such as the backend's name. */
40
+ readonly label?: string;
41
+ /** How often the text changes, in milliseconds. 500 unless given; at least 100. */
42
+ readonly intervalMs?: number;
43
+ }
44
+ /** A panel over the canvas showing frame rate and frame times: sample each frame. */
45
+ export interface BrowserStatsPanel {
46
+ /** The panel's element, a child of the page's body. */
47
+ readonly element: HTMLElement;
48
+ /** Called once for each frame of the display. */
49
+ sample(sample?: BrowserStatsSample): void;
50
+ snapshot(): BrowserStatsSnapshot;
51
+ /** Removes the panel from the page. */
52
+ dispose(): void;
53
+ }
54
+ /** Puts a panel over the canvas that shows frame rate and frame times. */
55
+ export declare function createBrowserStatsPanel(options: BrowserStatsPanelOptions): BrowserStatsPanel;
56
+ //# sourceMappingURL=BrowserStatsPanel.d.ts.map
@@ -0,0 +1,143 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // A small panel over a game's canvas with what a developer otherwise prints: frames a second, the time between
3
+ // frames, what a frame holds, and how busy the Host is. It reads what it is given; it starts no timer of its own.
4
+ import { EgretError } from '@egret/runtime';
5
+ const invalid = () => new EgretError('BROWSER_STATS_OPTIONS_INVALID');
6
+ const count = (value, fallback) => typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : fallback;
7
+ /** The triangles a frame's commands draw: two for a rectangle or an image, and a mesh's own. */
8
+ function trianglesOf(frame) {
9
+ let triangles = 0;
10
+ for (const command of frame.commands) {
11
+ if (command.kind === 'mesh')
12
+ triangles += frame.geometries[command.geometryIndex]?.triangleCount ?? 0;
13
+ else if (command.kind !== 'barrier')
14
+ triangles += 2;
15
+ }
16
+ return triangles;
17
+ }
18
+ /** Puts a panel over the canvas that shows frame rate and frame times. */
19
+ export function createBrowserStatsPanel(options) {
20
+ if (options === null || typeof options !== 'object')
21
+ throw invalid();
22
+ const { canvas, label } = options, interval = options.intervalMs ?? 500, page = canvas?.ownerDocument;
23
+ if (canvas === null ||
24
+ typeof canvas !== 'object' ||
25
+ typeof canvas.getBoundingClientRect !== 'function' ||
26
+ page === null ||
27
+ typeof page !== 'object' ||
28
+ typeof page.createElement !== 'function' ||
29
+ page.body === null ||
30
+ typeof page.body !== 'object' ||
31
+ (label !== undefined && typeof label !== 'string') ||
32
+ typeof interval !== 'number' ||
33
+ !(interval >= 100) ||
34
+ !Number.isFinite(interval))
35
+ throw invalid();
36
+ const element = page.createElement('div');
37
+ // Over the page and out of the way of the pointer: what is under the panel is still pressed.
38
+ element.setAttribute('style', 'position:fixed;left:0;top:0;z-index:2147483647;pointer-events:none;margin:0;padding:4px 6px;background:rgba(0,0,0,0.72);color:#7CFC8A;font:11px/1.35 ui-monospace,Menlo,Consolas,monospace;white-space:pre');
39
+ element.setAttribute('aria-hidden', 'true');
40
+ page.body.appendChild(element);
41
+ let closed = false, last, since, seen = 0, longest = 0, shown = false;
42
+ let commands = -1, triangles = -1, geometries = -1, pages = -1, pending = -1, frames = -1, skipped = -1, drawCalls = -1;
43
+ let current = Object.freeze({
44
+ fps: 0,
45
+ longestFrameMs: 0,
46
+ commands: 0,
47
+ triangles: 0,
48
+ geometries: 0,
49
+ pages: 0,
50
+ pendingFrames: 0,
51
+ frames: 0,
52
+ skipped: 0,
53
+ drawCalls: 0
54
+ });
55
+ const text = (value) => (value < 0 ? '-' : String(value));
56
+ function refresh(now) {
57
+ const elapsed = now - since, fps = elapsed > 0 ? Math.round((10000 * seen) / elapsed) / 10 : 0;
58
+ current = Object.freeze({
59
+ fps,
60
+ longestFrameMs: Math.round(10 * longest) / 10,
61
+ commands: Math.max(0, commands),
62
+ triangles: Math.max(0, triangles),
63
+ geometries: Math.max(0, geometries),
64
+ pages: Math.max(0, pages),
65
+ pendingFrames: Math.max(0, pending),
66
+ frames: Math.max(0, frames),
67
+ skipped: Math.max(0, skipped),
68
+ drawCalls: Math.max(0, drawCalls)
69
+ });
70
+ const box = canvas.getBoundingClientRect();
71
+ element.style.left = box.left + 'px';
72
+ element.style.top = box.top + 'px';
73
+ element.textContent =
74
+ (label === undefined ? '' : label + '\n') +
75
+ 'fps ' +
76
+ fps.toFixed(1) +
77
+ ' longest ' +
78
+ current.longestFrameMs.toFixed(1) +
79
+ ' ms\n' +
80
+ 'commands ' +
81
+ text(commands) +
82
+ ' draws ' +
83
+ text(drawCalls) +
84
+ ' triangles ' +
85
+ text(triangles) +
86
+ '\n' +
87
+ 'geometries ' +
88
+ text(geometries) +
89
+ ' pages ' +
90
+ text(pages) +
91
+ '\n' +
92
+ 'pending ' +
93
+ text(pending) +
94
+ ' drawn ' +
95
+ text(frames) +
96
+ ' skipped ' +
97
+ text(skipped);
98
+ since = now;
99
+ seen = 0;
100
+ longest = 0;
101
+ shown = true;
102
+ }
103
+ return Object.freeze({
104
+ element,
105
+ sample(sample = {}) {
106
+ if (closed)
107
+ return;
108
+ if (sample === null || typeof sample !== 'object')
109
+ throw invalid();
110
+ const now = sample.now ?? performance.now();
111
+ if (typeof now !== 'number' || !Number.isFinite(now))
112
+ throw invalid();
113
+ if (sample.frame !== undefined) {
114
+ const frame = sample.frame;
115
+ commands = frame.commands.length;
116
+ triangles = trianglesOf(frame);
117
+ geometries = frame.geometries.length;
118
+ pages = frame.pages.length;
119
+ }
120
+ pending = count(sample.pendingFrames, pending);
121
+ frames = count(sample.frames, frames);
122
+ skipped = count(sample.skipped, skipped);
123
+ drawCalls = count(sample.drawCalls, drawCalls);
124
+ if (last !== undefined && now > last) {
125
+ seen++;
126
+ longest = Math.max(longest, now - last);
127
+ }
128
+ last = now;
129
+ if (since === undefined)
130
+ since = now;
131
+ if (!shown || now - since >= interval)
132
+ refresh(now);
133
+ },
134
+ snapshot: () => current,
135
+ dispose() {
136
+ if (closed)
137
+ return;
138
+ closed = true;
139
+ element.remove();
140
+ }
141
+ });
142
+ }
143
+ //# sourceMappingURL=BrowserStatsPanel.js.map
@@ -0,0 +1,35 @@
1
+ import type { SaveStorage } from '@egret/engine/kit';
2
+ /** Save storage kept in IndexedDB: flush pending writes, and close it. */
3
+ export interface IndexedDBSaveStorage extends SaveStorage {
4
+ /** Resolves when every write so far has reached the database; rejects with the first that failed. */
5
+ flush(): Promise<void>;
6
+ /** Closes the database; later writes are refused. */
7
+ close(): void;
8
+ }
9
+ /** IndexedDB save storage to open: its database name, the IndexedDB to use, and what is called on an error. */
10
+ export interface IndexedDBSaveStorageOptions {
11
+ /** The database name; one per game. */
12
+ readonly database: string;
13
+ /** The IndexedDB factory; the page's by default. */
14
+ readonly indexedDB?: IDBFactory;
15
+ /** Told of a write that failed after it was accepted, as when the disk is full. */
16
+ readonly onError?: (cause: unknown) => void;
17
+ }
18
+ /**
19
+ * A save storage over IndexedDB. Opening reads every saved string into memory, so `createSaveStore` reads it
20
+ * synchronously as it does local storage; each write goes to memory at once and to the database after.
21
+ */
22
+ export declare function openIndexedDBSaveStorage(options: IndexedDBSaveStorageOptions): Promise<IndexedDBSaveStorage>;
23
+ /** Where fetched bundle entries are kept between visits; used as `cache` of `openBrowserAssetBundle`. */
24
+ export interface BundleCache {
25
+ match(key: string): Promise<Uint8Array | undefined>;
26
+ put(key: string, bytes: Uint8Array): Promise<void>;
27
+ /** Forgets every entry whose key does not start with one of `keep`, as after a new build. */
28
+ prune(keep: readonly string[]): Promise<number>;
29
+ }
30
+ /**
31
+ * A bundle cache in the Cache API under `name`. Entries are kept by the bundle's address and each entry's
32
+ * checksum, so a rebuilt bundle never serves an old entry. Where the Cache API is missing, every lookup misses.
33
+ */
34
+ export declare function openBrowserBundleCache(name: string, cacheStorage?: CacheStorage): Promise<BundleCache>;
35
+ //# sourceMappingURL=BrowserStorage.d.ts.map