@egret/engine 0.0.0-stage → 7.0.1-rc.3

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 (575) 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 +464 -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 +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -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 +15 -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 +43 -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 +233 -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 +29 -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 +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -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 +411 -0
  57. package/dist/cameraTypes.d.ts +114 -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 +33 -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 +42 -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 +34 -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 +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -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 +134 -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 +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -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 +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -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 +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -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 +37 -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 +292 -0
  145. package/dist/particleTypes.d.ts +107 -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 +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -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 +331 -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 +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -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 +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -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 +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,532 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const rules = Object.freeze({
4
+ group: { leaf: false, named: false, fields: ['disabled'] },
5
+ image: { leaf: true, named: true, fields: [] },
6
+ text: { leaf: true, named: true, fields: [] },
7
+ button: { leaf: true, named: true, fields: ['disabled', 'expanded'] },
8
+ checkbox: { leaf: true, named: true, fields: ['disabled', 'checked'] },
9
+ switch: { leaf: true, named: true, fields: ['disabled', 'checked'] },
10
+ radiogroup: { leaf: false, named: false, fields: ['disabled'] },
11
+ radio: { leaf: true, named: true, inside: 'radiogroup', fields: ['disabled', 'checked', 'position'] },
12
+ listbox: { leaf: false, named: false, fields: ['disabled', 'multiple'] },
13
+ option: { leaf: true, named: true, inside: 'listbox', fields: ['disabled', 'selected', 'position'] },
14
+ list: { leaf: false, named: false, fields: [] },
15
+ listitem: { leaf: false, named: false, inside: 'list', fields: ['position'] },
16
+ scrollbar: { leaf: true, named: true, fields: ['disabled', 'range', 'orientation', 'controls'] },
17
+ slider: { leaf: true, named: true, fields: ['disabled', 'range', 'orientation'] },
18
+ spinbutton: { leaf: true, named: true, fields: ['disabled', 'range'] },
19
+ progressbar: { leaf: true, named: true, fields: ['range'] },
20
+ tablist: { leaf: false, named: false, fields: ['disabled', 'orientation'] },
21
+ tab: { leaf: true, named: true, inside: 'tablist', fields: ['disabled', 'selected', 'position', 'controls'] },
22
+ tabpanel: { leaf: false, named: true, fields: [] },
23
+ menu: { leaf: false, named: false, fields: ['disabled', 'orientation'] },
24
+ menuitem: { leaf: true, named: true, inside: 'menu', fields: ['disabled', 'position'] },
25
+ dialog: { leaf: false, named: true, fields: ['modal'] },
26
+ textbox: { leaf: true, named: true, fields: ['disabled', 'value', 'multiline'] },
27
+ // A message that is said when it changes. Its name is the message, and it is there, empty, before the first one.
28
+ status: { leaf: true, named: false, fields: [] },
29
+ alert: { leaf: true, named: false, fields: [] },
30
+ // Cells in rows and columns. A row is which row it is, and a cell which column it is in.
31
+ grid: { leaf: false, named: false, fields: ['disabled', 'multiple', 'extent'] },
32
+ // Rows are what is selected in a table, and cells in a board: either says so where it is the one.
33
+ row: { leaf: false, named: false, inside: 'grid', fields: ['disabled', 'selected', 'position'], loose: ['selected'] },
34
+ gridcell: {
35
+ leaf: true,
36
+ named: true,
37
+ inside: 'row',
38
+ fields: ['disabled', 'selected', 'position'],
39
+ loose: ['selected']
40
+ },
41
+ columnheader: { leaf: true, named: true, inside: 'row', fields: ['disabled', 'position', 'sort'] },
42
+ // The items of a tree are all inside the tree itself: how deep one is, is said by its level, so that the items of a list can be a tree.
43
+ tree: { leaf: false, named: false, fields: ['disabled', 'multiple'] },
44
+ treeitem: {
45
+ leaf: true,
46
+ named: true,
47
+ inside: 'tree',
48
+ fields: ['disabled', 'selected', 'expanded', 'position', 'level'],
49
+ loose: ['selected']
50
+ },
51
+ heading: { leaf: true, named: true, fields: ['level'] }
52
+ });
53
+ /** State that belongs to some roles only. A description that sets one its role does not have is refused. */
54
+ const particular = [
55
+ 'disabled',
56
+ 'checked',
57
+ 'selected',
58
+ 'expanded',
59
+ 'modal',
60
+ 'multiline',
61
+ 'multiple',
62
+ 'extent',
63
+ 'sort',
64
+ 'level',
65
+ 'range',
66
+ 'orientation',
67
+ 'controls',
68
+ 'position',
69
+ 'value'
70
+ ];
71
+ const offers = Object.freeze({
72
+ '': Object.freeze([]),
73
+ a: Object.freeze(['activate']),
74
+ f: Object.freeze(['focus']),
75
+ af: Object.freeze(['activate', 'focus'])
76
+ });
77
+ const finite = (value) => typeof value === 'number' && Number.isFinite(value);
78
+ const flag = (value) => value === undefined || typeof value === 'boolean';
79
+ const identifier = (value) => typeof value === 'string' && value.length >= 1 && value.length <= 128 && !value.includes('\0');
80
+ function sameNode(a, b) {
81
+ return (a.id === b.id &&
82
+ a.role === b.role &&
83
+ a.parent === b.parent &&
84
+ a.name === b.name &&
85
+ a.disabled === b.disabled &&
86
+ a.focused === b.focused &&
87
+ a.inert === b.inert &&
88
+ a.actions === b.actions &&
89
+ a.value === b.value &&
90
+ a.checked === b.checked &&
91
+ a.selected === b.selected &&
92
+ a.expanded === b.expanded &&
93
+ a.modal === b.modal &&
94
+ a.multiline === b.multiline &&
95
+ a.multiple === b.multiple &&
96
+ a.orientation === b.orientation &&
97
+ a.controls === b.controls &&
98
+ a.bounds.x === b.bounds.x &&
99
+ a.bounds.y === b.bounds.y &&
100
+ a.bounds.width === b.bounds.width &&
101
+ a.bounds.height === b.bounds.height &&
102
+ a.range?.now === b.range?.now &&
103
+ a.range?.min === b.range?.min &&
104
+ a.range?.max === b.range?.max &&
105
+ a.position?.index === b.position?.index &&
106
+ a.position?.size === b.position?.size &&
107
+ a.extent?.rows === b.extent?.rows &&
108
+ a.extent?.columns === b.extent?.columns &&
109
+ a.sort === b.sort &&
110
+ a.level === b.level);
111
+ }
112
+ /**
113
+ * The rectangle on the stage that encloses a display object and what it holds, for the bounds of
114
+ * a node. It is measured when it is called, so call it from `describe`.
115
+ */
116
+ export function semanticBoundsOf(target) {
117
+ const local = target.getBounds(), right = local.x + local.width, bottom = local.y + local.height;
118
+ const corners = [
119
+ target.localToGlobal(local.x, local.y),
120
+ target.localToGlobal(right, local.y),
121
+ target.localToGlobal(right, bottom),
122
+ target.localToGlobal(local.x, bottom)
123
+ ];
124
+ const xs = corners.map(point => point.x), ys = corners.map(point => point.y), x = Math.min(...xs), y = Math.min(...ys);
125
+ return Object.freeze({ x, y, width: Math.max(...xs) - x, height: Math.max(...ys) - y });
126
+ }
127
+ /** A semantic tree for the controls an application draws. It reads them; it holds no state of theirs. */
128
+ export function createUiSemantics(options = {}) {
129
+ if (options === null || typeof options !== 'object' || Array.isArray(options))
130
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
131
+ const maxNodes = options.maxNodes ?? 256;
132
+ if (!Number.isInteger(maxNodes) || maxNodes < 1 || maxNodes > 4096)
133
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
134
+ const entries = new Map(), roots = [];
135
+ const listeners = new Set(), closers = new Set();
136
+ let snapshot = Object.freeze({
137
+ revision: 0,
138
+ layoutRevision: undefined,
139
+ nodes: Object.freeze([]),
140
+ focused: undefined
141
+ });
142
+ /** The entry each published node was read from: an id may since have been removed and used again. */
143
+ let published = new Map();
144
+ let state = 'active', publishing = false, telling = false;
145
+ function open() {
146
+ if (state === 'closed')
147
+ throw new EgretError('UI_SEMANTICS_CLOSED');
148
+ if (publishing)
149
+ throw new EgretError('UI_SEMANTICS_REENTRANT');
150
+ }
151
+ function detach(entry) {
152
+ entry.attached = false;
153
+ entries.delete(entry.id);
154
+ for (const child of entry.children.splice(0))
155
+ detach(child);
156
+ }
157
+ function add(node) {
158
+ open();
159
+ if (node === null || typeof node !== 'object')
160
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
161
+ const { id, role, parent: parentId, describe, onActivate, onFocus } = node;
162
+ if (!identifier(id) ||
163
+ typeof role !== 'string' ||
164
+ !Object.hasOwn(rules, role) ||
165
+ typeof describe !== 'function' ||
166
+ (parentId !== undefined && !identifier(parentId)) ||
167
+ (onActivate !== undefined && typeof onActivate !== 'function') ||
168
+ (onFocus !== undefined && typeof onFocus !== 'function'))
169
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
170
+ if (entries.has(id))
171
+ throw new EgretError('UI_SEMANTICS_DUPLICATE');
172
+ const parent = parentId === undefined ? undefined : entries.get(parentId), rule = rules[role];
173
+ // A leaf is read as one thing, and a radio, an option or a list item means nothing outside its container.
174
+ if ((parentId !== undefined && parent === undefined) ||
175
+ (parent !== undefined && rules[parent.role].leaf) ||
176
+ (rule.inside !== undefined && parent?.role !== rule.inside))
177
+ throw new EgretError('UI_SEMANTICS_PARENT');
178
+ if (entries.size >= maxNodes)
179
+ throw new EgretError('UI_SEMANTICS_CAPACITY');
180
+ const entry = {
181
+ id,
182
+ role,
183
+ parent,
184
+ children: [],
185
+ describe,
186
+ onActivate,
187
+ onFocus,
188
+ attached: true,
189
+ handle: Object.freeze({
190
+ id,
191
+ role,
192
+ parent: parentId,
193
+ get attached() {
194
+ return entry.attached;
195
+ },
196
+ remove() {
197
+ if (!entry.attached)
198
+ return;
199
+ if (publishing)
200
+ throw new EgretError('UI_SEMANTICS_REENTRANT');
201
+ const siblings = entry.parent === undefined ? roots : entry.parent.children, index = siblings.indexOf(entry);
202
+ if (index >= 0)
203
+ siblings.splice(index, 1);
204
+ detach(entry);
205
+ }
206
+ })
207
+ };
208
+ entries.set(id, entry);
209
+ (parent === undefined ? roots : parent.children).push(entry);
210
+ return entry.handle;
211
+ }
212
+ /** One description, checked against its role. Undefined for a hidden node. */
213
+ function read(entry) {
214
+ let described;
215
+ try {
216
+ described = entry.describe();
217
+ }
218
+ catch (cause) {
219
+ throw new EgretError('UI_SEMANTICS_DESCRIBE_FAILED', { cause });
220
+ }
221
+ const refuse = (field) => new EgretError('UI_SEMANTICS_DESCRIPTION', { cause: new TypeError(entry.id + ': ' + field) });
222
+ if (described === null || typeof described !== 'object' || Array.isArray(described))
223
+ throw refuse('description');
224
+ const rule = rules[entry.role];
225
+ const { bounds, name = '', hidden, focused, order = 0, disabled, checked, selected, expanded, modal, multiline, multiple, extent, sort, level, range, orientation, controls, position, value } = described;
226
+ if (!flag(hidden))
227
+ throw refuse('hidden');
228
+ if (hidden === true)
229
+ return undefined;
230
+ for (const field of particular)
231
+ if (described[field] !== undefined && !rule.fields.includes(field))
232
+ throw refuse(field);
233
+ if (bounds === null ||
234
+ typeof bounds !== 'object' ||
235
+ !finite(bounds.x) ||
236
+ !finite(bounds.y) ||
237
+ !finite(bounds.width) ||
238
+ !finite(bounds.height) ||
239
+ bounds.width < 0 ||
240
+ bounds.height < 0)
241
+ throw refuse('bounds');
242
+ if (typeof name !== 'string' || name.length > 1024 || (rule.named && !/\S/.test(name)))
243
+ throw refuse('name');
244
+ if (!flag(focused))
245
+ throw refuse('focused');
246
+ if (!finite(order))
247
+ throw refuse('order');
248
+ if (!flag(disabled))
249
+ throw refuse('disabled');
250
+ if (!flag(expanded))
251
+ throw refuse('expanded');
252
+ if (!flag(modal))
253
+ throw refuse('modal');
254
+ if (!flag(multiline))
255
+ throw refuse('multiline');
256
+ if (!flag(multiple))
257
+ throw refuse('multiple');
258
+ const checkable = rule.fields.includes('checked');
259
+ if (checkable
260
+ ? typeof checked !== 'boolean' && !(checked === 'mixed' && entry.role === 'checkbox')
261
+ : checked !== undefined)
262
+ throw refuse('checked');
263
+ if (rule.fields.includes('selected')
264
+ ? typeof selected !== 'boolean' && !(selected === undefined && rule.loose?.includes('selected') === true)
265
+ : selected !== undefined)
266
+ throw refuse('selected');
267
+ if (sort !== undefined && sort !== 'ascending' && sort !== 'descending' && sort !== 'none')
268
+ throw refuse('sort');
269
+ // An item of a tree is at some depth. A heading has one of six ranks, or does not say.
270
+ if (entry.role === 'treeitem' || level !== undefined
271
+ ? !Number.isSafeInteger(level) || level < 1 || (entry.role === 'heading' && level > 6)
272
+ : false)
273
+ throw refuse('level');
274
+ if (value !== undefined && (typeof value !== 'string' || value.length > 16384))
275
+ throw refuse('value');
276
+ // A scroll bar, a slider and a spin button are somewhere in their range. A progress bar without one shows work of unknown length.
277
+ const ranged = entry.role === 'scrollbar' || entry.role === 'slider' || entry.role === 'spinbutton';
278
+ if (ranged || range !== undefined
279
+ ? range === null ||
280
+ typeof range !== 'object' ||
281
+ !finite(range.now) ||
282
+ !finite(range.min) ||
283
+ !finite(range.max) ||
284
+ range.min > range.now ||
285
+ range.now > range.max
286
+ : false)
287
+ throw refuse('range');
288
+ if (extent !== undefined &&
289
+ (extent === null ||
290
+ typeof extent !== 'object' ||
291
+ !Number.isSafeInteger(extent.rows) ||
292
+ !Number.isSafeInteger(extent.columns) ||
293
+ extent.rows < 1 ||
294
+ extent.columns < 1))
295
+ throw refuse('extent');
296
+ if (orientation !== undefined && orientation !== 'horizontal' && orientation !== 'vertical')
297
+ throw refuse('orientation');
298
+ if (controls !== undefined && (!identifier(controls) || controls === entry.id))
299
+ throw refuse('controls');
300
+ if (position !== undefined &&
301
+ (position === null ||
302
+ typeof position !== 'object' ||
303
+ !Number.isSafeInteger(position.index) ||
304
+ !Number.isSafeInteger(position.size) ||
305
+ position.index < 1 ||
306
+ position.index > position.size))
307
+ throw refuse('position');
308
+ return {
309
+ entry,
310
+ order,
311
+ node: {
312
+ id: entry.id,
313
+ role: entry.role,
314
+ parent: entry.parent?.id,
315
+ name,
316
+ bounds: Object.freeze({ x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height }),
317
+ disabled: disabled === true,
318
+ focused: focused === true,
319
+ actions: offers[(entry.onActivate === undefined ? '' : 'a') + (entry.onFocus === undefined ? '' : 'f')],
320
+ value: entry.role === 'textbox' ? (value ?? '') : undefined,
321
+ checked: checked,
322
+ selected,
323
+ expanded,
324
+ modal: entry.role === 'dialog' ? modal === true : undefined,
325
+ multiline: entry.role === 'textbox' ? multiline === true : undefined,
326
+ multiple: rule.fields.includes('multiple') ? multiple === true : undefined,
327
+ extent: extent === undefined
328
+ ? undefined
329
+ : Object.freeze({ rows: extent.rows, columns: extent.columns }),
330
+ sort: sort,
331
+ level,
332
+ range: range === undefined
333
+ ? undefined
334
+ : Object.freeze({ now: range.now, min: range.min, max: range.max }),
335
+ // A scroll bar stands beside what it scrolls and a menu lists its items downward; a slider and a row of tabs lie along the line they are read in.
336
+ orientation: rule.fields.includes('orientation')
337
+ ? (orientation ??
338
+ (entry.role === 'scrollbar' || entry.role === 'menu' ? 'vertical' : 'horizontal'))
339
+ : undefined,
340
+ controls,
341
+ position: position === undefined
342
+ ? undefined
343
+ : Object.freeze({ index: position.index, size: position.size })
344
+ }
345
+ };
346
+ }
347
+ function collect(siblings, into) {
348
+ const drafts = [];
349
+ // A snapshot of the list: a description may not change the tree, and is refused if it tries.
350
+ for (const entry of [...siblings]) {
351
+ const draft = read(entry);
352
+ if (draft !== undefined)
353
+ drafts.push(draft);
354
+ }
355
+ // The sort is stable: nodes of equal order stay in the order they were added.
356
+ drafts.sort((a, b) => a.order - b.order);
357
+ for (const draft of drafts) {
358
+ into.push(draft);
359
+ collect(draft.entry.children, into);
360
+ }
361
+ }
362
+ function publish(layoutRevision) {
363
+ open();
364
+ if (telling)
365
+ throw new EgretError('UI_SEMANTICS_REENTRANT');
366
+ if (layoutRevision !== undefined &&
367
+ (!Number.isSafeInteger(layoutRevision) ||
368
+ layoutRevision < 0 ||
369
+ (snapshot.layoutRevision !== undefined && layoutRevision < snapshot.layoutRevision)))
370
+ throw new EgretError('UI_SEMANTICS_REVISION');
371
+ const drafts = [];
372
+ publishing = true;
373
+ try {
374
+ collect(roots, drafts);
375
+ }
376
+ finally {
377
+ publishing = false;
378
+ }
379
+ const present = new Map(drafts.map(draft => [draft.entry.id, draft]));
380
+ // The modal dialog read last is the one in front. It, what is inside it and what it is inside stay live.
381
+ let modal;
382
+ for (const draft of drafts)
383
+ if (draft.node.modal === true)
384
+ modal = draft;
385
+ const live = new Set();
386
+ for (let entry = modal?.entry; entry !== undefined; entry = entry.parent)
387
+ live.add(entry);
388
+ const within = (entry) => {
389
+ for (let at = entry; at !== undefined; at = at.parent)
390
+ if (at === modal.entry)
391
+ return true;
392
+ return false;
393
+ };
394
+ const next = new Map(), nodes = [];
395
+ let focused, changed = drafts.length !== snapshot.nodes.length || layoutRevision !== snapshot.layoutRevision;
396
+ for (const [index, draft] of drafts.entries()) {
397
+ const inert = modal !== undefined && !live.has(draft.entry) && !within(draft.entry);
398
+ if (draft.node.controls !== undefined && !present.has(draft.node.controls))
399
+ throw new EgretError('UI_SEMANTICS_RELATION', { cause: new TypeError(draft.entry.id + ': controls') });
400
+ if (draft.node.focused) {
401
+ // One node holds the focus, and never one a modal dialog has made inert.
402
+ if (focused !== undefined || inert)
403
+ throw new EgretError('UI_SEMANTICS_FOCUS', { cause: new TypeError(draft.entry.id + ': focused') });
404
+ focused = draft.entry.id;
405
+ }
406
+ const fresh = { ...draft.node, inert }, before = snapshot.nodes[index];
407
+ const node = before !== undefined && sameNode(before, fresh) ? before : Object.freeze(fresh);
408
+ if (node !== before)
409
+ changed = true;
410
+ nodes.push(node);
411
+ next.set(node.id, { node, entry: draft.entry });
412
+ }
413
+ published = next;
414
+ if (!changed)
415
+ return snapshot;
416
+ if (!Number.isSafeInteger(snapshot.revision + 1))
417
+ throw new EgretError('UI_SEMANTICS_EXHAUSTED');
418
+ const previous = snapshot;
419
+ snapshot = Object.freeze({ revision: previous.revision + 1, layoutRevision, nodes: Object.freeze(nodes), focused });
420
+ // Published before anyone is told: a listener that fails does not undo it.
421
+ let first, failed = false;
422
+ const rest = [];
423
+ telling = true;
424
+ try {
425
+ for (const listener of [...listeners]) {
426
+ if (state === 'closed')
427
+ break;
428
+ if (listeners.has(listener))
429
+ try {
430
+ listener(snapshot, previous);
431
+ }
432
+ catch (cause) {
433
+ if (failed)
434
+ rest.push(cause);
435
+ else {
436
+ failed = true;
437
+ first = cause;
438
+ }
439
+ }
440
+ }
441
+ }
442
+ finally {
443
+ telling = false;
444
+ }
445
+ if (failed)
446
+ throw new EgretError('UI_SEMANTICS_LISTENER_FAILED', { cause: first, cleanupErrors: rest });
447
+ return snapshot;
448
+ }
449
+ function perform(id, action) {
450
+ if (!identifier(id) || (action !== 'activate' && action !== 'focus'))
451
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
452
+ if (state === 'closed')
453
+ return false;
454
+ if (publishing)
455
+ throw new EgretError('UI_SEMANTICS_REENTRANT');
456
+ const found = published.get(id);
457
+ if (found === undefined || !found.entry.attached || found.node.disabled || found.node.inert)
458
+ return false;
459
+ const handler = action === 'activate' ? found.entry.onActivate : found.entry.onFocus;
460
+ if (handler === undefined)
461
+ return false;
462
+ handler();
463
+ return true;
464
+ }
465
+ function dispose() {
466
+ if (state === 'closed')
467
+ return;
468
+ if (publishing)
469
+ throw new EgretError('UI_SEMANTICS_REENTRANT');
470
+ state = 'closed';
471
+ for (const entry of roots.splice(0))
472
+ detach(entry);
473
+ published = new Map();
474
+ listeners.clear();
475
+ const callbacks = [...closers];
476
+ closers.clear();
477
+ let first, failed = false;
478
+ const rest = [];
479
+ for (const callback of callbacks)
480
+ try {
481
+ callback();
482
+ }
483
+ catch (cause) {
484
+ if (failed)
485
+ rest.push(cause);
486
+ else {
487
+ failed = true;
488
+ first = cause;
489
+ }
490
+ }
491
+ if (failed)
492
+ throw new EgretError('UI_SEMANTICS_CLEANUP_FAILED', { cause: first, cleanupErrors: rest });
493
+ }
494
+ return Object.freeze({
495
+ get state() {
496
+ return state;
497
+ },
498
+ get snapshot() {
499
+ return snapshot;
500
+ },
501
+ get size() {
502
+ return entries.size;
503
+ },
504
+ add,
505
+ publish,
506
+ perform,
507
+ observe(listener) {
508
+ if (typeof listener !== 'function')
509
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
510
+ if (state === 'closed')
511
+ return () => { };
512
+ listeners.add(listener);
513
+ return () => {
514
+ listeners.delete(listener);
515
+ };
516
+ },
517
+ onClose(listener) {
518
+ if (typeof listener !== 'function')
519
+ throw new EgretError('UI_SEMANTICS_OPTIONS');
520
+ if (state === 'closed') {
521
+ listener();
522
+ return () => { };
523
+ }
524
+ closers.add(listener);
525
+ return () => {
526
+ closers.delete(listener);
527
+ };
528
+ },
529
+ dispose
530
+ });
531
+ }
532
+ //# sourceMappingURL=semanticTree.js.map