@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,407 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { createSpriteSheet, EgretError } from '@egret/runtime';
3
+ import { assertBitmapButtonScopeOrigin, bitmapButtonOperations as original, requireBitmapButtonInput, requireMouseInputEngine } from './internal/mouseInputFactoryState.js';
4
+ const ARRAY_IS_ARRAY = Array.isArray;
5
+ function cleanupError(errors) {
6
+ return new EgretError('BITMAP_BUTTON_CLEANUP_FAILED', { cause: errors[0], cleanupErrors: errors.slice(1) });
7
+ }
8
+ /** Logical retirement precedes every physical cleanup and possible reentry. */
9
+ function retire(record) {
10
+ if (record.state === 'disposed')
11
+ return [];
12
+ const input = record.input, scope = record.scope, abort = record.abort;
13
+ const association = record.association, sheet = record.sheet;
14
+ record.state = 'disposed';
15
+ record.gesture = undefined;
16
+ record.callback = undefined;
17
+ record.owner = undefined;
18
+ record.scope = undefined;
19
+ record.input = undefined;
20
+ record.sheet = undefined;
21
+ record.lease = undefined;
22
+ record.skins = undefined;
23
+ record.crop = undefined;
24
+ record.hit = undefined;
25
+ record.abort = undefined;
26
+ record.association = undefined;
27
+ const failures = [];
28
+ const attempt = (action) => {
29
+ try {
30
+ action();
31
+ }
32
+ catch (cause) {
33
+ failures.push(cause);
34
+ }
35
+ };
36
+ if (input !== undefined && association !== undefined)
37
+ attempt(() => input.remove(association));
38
+ if (scope !== undefined && abort !== undefined)
39
+ attempt(() => scope.remove(abort));
40
+ attempt(() => original.dispose(record.display));
41
+ attempt(() => original.disposeDisplay(record.display));
42
+ if (sheet !== undefined)
43
+ attempt(() => sheet.dispose());
44
+ return failures;
45
+ }
46
+ function reportCleanup(owner, errors) {
47
+ if (owner === undefined || errors.length === 0)
48
+ return;
49
+ const cause = cleanupError(errors);
50
+ try {
51
+ owner.captureCleanup(cause);
52
+ }
53
+ catch {
54
+ /* A cleanup observer cannot replace the selected cause. */
55
+ }
56
+ try {
57
+ owner.report({ code: 'BITMAP_BUTTON_CLEANUP_FAILED', phase: 'engine', severity: 'error', cause });
58
+ }
59
+ catch {
60
+ /* Continue retiring the remaining controls. */
61
+ }
62
+ }
63
+ /** Getters synchronize terminal dependencies, but never repair semantic mutations. */
64
+ function syncTerminal(record) {
65
+ if (record.state === 'disposed')
66
+ return;
67
+ const owner = record.owner;
68
+ let terminal = original.disposed(record.display);
69
+ if (!terminal) {
70
+ try {
71
+ owner.assertReady();
72
+ record.scope.assertOpen();
73
+ record.input.assertOpen();
74
+ }
75
+ catch (cause) {
76
+ if (!(cause instanceof EgretError) ||
77
+ !['ENGINE_CLOSED', 'SCOPE_CLOSED', 'BITMAP_BUTTON_INPUT_CLOSED'].includes(cause.code))
78
+ throw cause;
79
+ terminal = true;
80
+ }
81
+ }
82
+ if (terminal)
83
+ reportCleanup(owner, retire(record));
84
+ }
85
+ function assertLife(record) {
86
+ record.owner.assertReady();
87
+ record.scope.assertOpen();
88
+ record.input.assertOpen();
89
+ }
90
+ function equalRect(first, second) {
91
+ return (first !== undefined &&
92
+ second !== undefined &&
93
+ first.x === second.x &&
94
+ first.y === second.y &&
95
+ first.width === second.width &&
96
+ first.height === second.height);
97
+ }
98
+ function assertSettings(record) {
99
+ if (original.lease(record.display) === record.lease &&
100
+ equalRect(original.crop(record.display), record.crop) &&
101
+ equalRect(original.hit(record.display), record.hit) &&
102
+ original.touch(record.display) === record.touch)
103
+ return;
104
+ const failures = retire(record);
105
+ throw new EgretError('BITMAP_BUTTON_SKIN_INVALID', { cleanupErrors: failures });
106
+ }
107
+ function throwAfterRetirement(record, cause) {
108
+ const failures = retire(record);
109
+ if (cause instanceof EgretError && failures.length !== 0) {
110
+ throw new EgretError(cause.code, { cause: cause.cause, cleanupErrors: [...cause.cleanupErrors, ...failures] });
111
+ }
112
+ throw cause;
113
+ }
114
+ /** Prepared immutable crops make both reserved writes callback-free on this Bitmap. */
115
+ function commitSkin(record, state, enabled) {
116
+ const crop = record.skins[state];
117
+ try {
118
+ original.setCrop(record.display, crop);
119
+ original.setTouch(record.display, enabled);
120
+ record.crop = original.crop(record.display);
121
+ record.touch = enabled;
122
+ record.enabled = enabled;
123
+ record.state = state;
124
+ }
125
+ catch (cause) {
126
+ throwAfterRetirement(record, cause);
127
+ }
128
+ }
129
+ function active(record) {
130
+ syncTerminal(record);
131
+ if (record.state === 'disposed')
132
+ return false;
133
+ assertLife(record);
134
+ assertSettings(record);
135
+ return true;
136
+ }
137
+ function setEnabled(record, value) {
138
+ syncTerminal(record);
139
+ if (record.state === 'disposed')
140
+ throw new EgretError('BITMAP_BUTTON_DISPOSED');
141
+ assertLife(record);
142
+ if (typeof value !== 'boolean')
143
+ throw new EgretError('BITMAP_BUTTON_OPTIONS_INVALID');
144
+ assertSettings(record);
145
+ if (value === record.enabled)
146
+ return;
147
+ // A disable/re-enable sequence cannot recreate an earlier callback entitlement.
148
+ record.gesture = undefined;
149
+ commitSkin(record, value ? 'up' : 'disabled', value);
150
+ }
151
+ function createAssociation(record) {
152
+ return Object.freeze({
153
+ target: record.display,
154
+ syncTerminal() {
155
+ syncTerminal(record);
156
+ },
157
+ beforeBegin(token) {
158
+ if (!active(record) || !record.enabled)
159
+ return;
160
+ commitSkin(record, 'pressed', true);
161
+ record.gesture = token;
162
+ },
163
+ beforeEnd(token) {
164
+ if (!active(record))
165
+ return;
166
+ if (record.gesture === token && record.state === 'pressed')
167
+ commitSkin(record, 'up', true);
168
+ },
169
+ cancel() {
170
+ if (!active(record))
171
+ return;
172
+ record.gesture = undefined;
173
+ if (record.state === 'pressed')
174
+ commitSkin(record, 'up', true);
175
+ },
176
+ afterActivate(token, payload, eligible) {
177
+ if (!active(record) || !record.enabled || record.gesture !== token || !eligible())
178
+ return;
179
+ // Consume first; no post-callback write may resurrect a disabled/closed value.
180
+ record.gesture = undefined;
181
+ const callback = record.callback, owner = record.owner;
182
+ const returned = original.invoke(callback, payload);
183
+ if (returned !== null &&
184
+ (typeof returned === 'object' || typeof returned === 'function') &&
185
+ 'then' in returned &&
186
+ typeof returned.then === 'function') {
187
+ void Promise.resolve(returned).catch((cause) => {
188
+ owner.report({ code: 'ASYNC_EVENT_HANDLER_REJECTED', phase: 'engine', severity: 'error', cause });
189
+ });
190
+ throw new EgretError('ASYNC_EVENT_HANDLER');
191
+ }
192
+ },
193
+ finish(token) {
194
+ if (record.gesture === token)
195
+ record.gesture = undefined;
196
+ },
197
+ retire() {
198
+ return retire(record);
199
+ }
200
+ });
201
+ }
202
+ function createAbort(record) {
203
+ return () => {
204
+ const owner = record.owner;
205
+ reportCleanup(owner, retire(record));
206
+ };
207
+ }
208
+ function createFacade(record) {
209
+ function exact(receiver) {
210
+ if (receiver !== facade)
211
+ throw new EgretError('BITMAP_BUTTON_INVALID');
212
+ }
213
+ const facade = Object.freeze({
214
+ get display() {
215
+ exact(this);
216
+ syncTerminal(record);
217
+ return record.display;
218
+ },
219
+ get state() {
220
+ exact(this);
221
+ syncTerminal(record);
222
+ return record.state;
223
+ },
224
+ get enabled() {
225
+ exact(this);
226
+ syncTerminal(record);
227
+ return record.enabled;
228
+ },
229
+ set enabled(value) {
230
+ exact(this);
231
+ setEnabled(record, value);
232
+ },
233
+ dispose() {
234
+ exact(this);
235
+ const failures = retire(record);
236
+ if (failures.length !== 0)
237
+ throw cleanupError(failures);
238
+ }
239
+ });
240
+ return facade;
241
+ }
242
+ function read(operation, revalidate) {
243
+ let value;
244
+ try {
245
+ value = operation();
246
+ }
247
+ catch (cause) {
248
+ throw new EgretError('BITMAP_BUTTON_OPTIONS_INVALID', { cause });
249
+ }
250
+ revalidate();
251
+ return value;
252
+ }
253
+ function recordShape(value) {
254
+ if (value === null || typeof value !== 'object')
255
+ return false;
256
+ try {
257
+ return !ARRAY_IS_ARRAY(value);
258
+ }
259
+ catch (cause) {
260
+ throw new EgretError('BITMAP_BUTTON_OPTIONS_INVALID', { cause });
261
+ }
262
+ }
263
+ function retainOriginalError(primary, errors) {
264
+ if (primary instanceof EgretError &&
265
+ /^(BITMAP_BUTTON_|SPRITE_SHEET_|BITMAP_|ASSET_LEASE_|TEXTURE_|ENGINE_|SCOPE_|MOUSE_INPUT_|OWNERSHIP_|DISPLAY_|HIT_TEST_)/.test(primary.code)) {
266
+ if (errors.length === 0)
267
+ throw primary;
268
+ throw new EgretError(primary.code, { cause: primary.cause, cleanupErrors: [...primary.cleanupErrors, ...errors] });
269
+ }
270
+ throw new EgretError('BITMAP_BUTTON_SETUP_FAILED', { cause: primary, cleanupErrors: errors });
271
+ }
272
+ function assertSetupOpen(record) {
273
+ if (record.state === 'disposed')
274
+ throw new EgretError('SCOPE_CLOSED');
275
+ }
276
+ /** Share a genuine input; own only the new private sheet, Bitmap and facade. */
277
+ export function createBitmapButton(options) {
278
+ if (!recordShape(options))
279
+ throw new EgretError('BITMAP_BUTTON_OPTIONS_INVALID');
280
+ const noCheck = () => { };
281
+ const engine = read(() => options.engine, noCheck);
282
+ const owner = requireMouseInputEngine(engine);
283
+ const requestedScope = read(() => options.scope, () => owner.assertReady());
284
+ assertBitmapButtonScopeOrigin(requestedScope, engine);
285
+ const scope = owner.scope(requestedScope);
286
+ const ownerLife = () => {
287
+ owner.assertReady();
288
+ scope.assertOpen();
289
+ };
290
+ const requestedInput = read(() => options.input, ownerLife);
291
+ const input = requireBitmapButtonInput(requestedInput, engine);
292
+ const life = () => {
293
+ owner.assertReady();
294
+ scope.assertOpen();
295
+ input.assertOpen();
296
+ };
297
+ const lease = read(() => options.textureLease, life);
298
+ const requestedSkins = read(() => options.skins, life);
299
+ const requestedEnabled = read(() => options.enabled, life);
300
+ const callback = read(() => options.onActivate, life);
301
+ if (!recordShape(requestedSkins))
302
+ throw new EgretError('BITMAP_BUTTON_OPTIONS_INVALID');
303
+ const up = read(() => requestedSkins.up, life);
304
+ const pressed = read(() => requestedSkins.pressed, life);
305
+ const disabled = read(() => requestedSkins.disabled, life);
306
+ const fields = (region) => {
307
+ const x = read(() => region.x, life), y = read(() => region.y, life);
308
+ const width = read(() => region.width, life), height = read(() => region.height, life);
309
+ return { x, y, width, height };
310
+ };
311
+ const stagedUp = fields(up), stagedPressed = fields(pressed), stagedDisabled = fields(disabled);
312
+ // Exactly one get: explicit undefined and an absent enabled property both mean true.
313
+ const enabled = requestedEnabled === undefined ? true : requestedEnabled;
314
+ if (typeof enabled !== 'boolean' || typeof callback !== 'function')
315
+ throw new EgretError('BITMAP_BUTTON_OPTIONS_INVALID');
316
+ let sheet, display, record;
317
+ try {
318
+ sheet = createSpriteSheet(lease, [
319
+ { name: 'up', ...stagedUp },
320
+ { name: 'pressed', ...stagedPressed },
321
+ { name: 'disabled', ...stagedDisabled }
322
+ ]);
323
+ life();
324
+ const skins = Object.freeze({
325
+ up: sheet.getRegion('up'),
326
+ pressed: sheet.getRegion('pressed'),
327
+ disabled: sheet.getRegion('disabled')
328
+ });
329
+ if (skins.up.width !== skins.pressed.width ||
330
+ skins.up.width !== skins.disabled.width ||
331
+ skins.up.height !== skins.pressed.height ||
332
+ skins.up.height !== skins.disabled.height)
333
+ throw new EgretError('BITMAP_BUTTON_SKIN_INVALID');
334
+ // Scope acceptance authenticates the borrowed lease's Engine without rebinding it.
335
+ scope.use(sheet);
336
+ life();
337
+ display = sheet.createBitmap('up');
338
+ life();
339
+ scope.use(display);
340
+ life();
341
+ const hit = Object.freeze({ x: 0, y: 0, width: skins.up.width, height: skins.up.height });
342
+ original.setHit(display, hit);
343
+ original.setCrop(display, enabled ? skins.up : skins.disabled);
344
+ original.setTouch(display, enabled);
345
+ life();
346
+ record = {
347
+ display,
348
+ state: enabled ? 'up' : 'disabled',
349
+ enabled,
350
+ owner,
351
+ scope,
352
+ input,
353
+ sheet,
354
+ lease,
355
+ skins,
356
+ crop: original.crop(display),
357
+ hit: original.hit(display),
358
+ touch: enabled,
359
+ gesture: undefined,
360
+ callback,
361
+ association: undefined,
362
+ abort: undefined
363
+ };
364
+ const facade = createFacade(record);
365
+ record.association = createAssociation(record);
366
+ record.abort = createAbort(record);
367
+ scope.use(facade);
368
+ life();
369
+ scope.add(record.abort);
370
+ life();
371
+ assertSetupOpen(record);
372
+ input.add(record.association);
373
+ life();
374
+ assertSetupOpen(record);
375
+ return facade;
376
+ }
377
+ catch (primary) {
378
+ const failures = [];
379
+ if (record !== undefined)
380
+ failures.push(...retire(record));
381
+ else {
382
+ if (display !== undefined) {
383
+ try {
384
+ original.dispose(display);
385
+ }
386
+ catch (cause) {
387
+ failures.push(cause);
388
+ }
389
+ try {
390
+ original.disposeDisplay(display);
391
+ }
392
+ catch (cause) {
393
+ failures.push(cause);
394
+ }
395
+ }
396
+ if (sheet !== undefined)
397
+ try {
398
+ sheet.dispose();
399
+ }
400
+ catch (cause) {
401
+ failures.push(cause);
402
+ }
403
+ }
404
+ retainOriginalError(primary, failures);
405
+ }
406
+ }
407
+ //# sourceMappingURL=bitmapButton.js.map
@@ -0,0 +1,29 @@
1
+ import type { TextureRegion2D } from '@egret/contracts';
2
+ import type { AssetLease, Bitmap, Scope, Texture } from '@egret/runtime';
3
+ import type { Engine } from './Engine.js';
4
+ import type { MouseInput, MouseInputPayload } from './mouseInputTypes.js';
5
+ declare const BITMAP_BUTTON_BRAND: unique symbol;
6
+ export type BitmapButtonState = 'up' | 'pressed' | 'disabled' | 'disposed';
7
+ export interface BitmapButtonOptions {
8
+ readonly engine: Engine;
9
+ readonly scope: Scope;
10
+ readonly input: MouseInput;
11
+ readonly textureLease: AssetLease<Texture>;
12
+ readonly skins: {
13
+ readonly up: TextureRegion2D;
14
+ readonly pressed: TextureRegion2D;
15
+ readonly disabled: TextureRegion2D;
16
+ };
17
+ readonly enabled?: boolean;
18
+ readonly onActivate: (payload: MouseInputPayload) => void;
19
+ }
20
+ /** A frozen exact-receiver facade; its accessor setter remains usable. */
21
+ export interface BitmapButton {
22
+ readonly [BITMAP_BUTTON_BRAND]: void;
23
+ readonly display: Bitmap;
24
+ readonly state: BitmapButtonState;
25
+ enabled: boolean;
26
+ dispose(): void;
27
+ }
28
+ export {};
29
+ //# sourceMappingURL=bitmapButtonTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=bitmapButtonTypes.js.map
@@ -0,0 +1,10 @@
1
+ import type { BitmapFont } from './bitmapFontTypes.js';
2
+ /** Whether a value is a font this entry read. */
3
+ export declare const isBitmapFont: (value: unknown) => value is BitmapFont;
4
+ /**
5
+ * Reads a bitmap font: the text, XML or JSON forms of BMFont (from AngelCode's generator, Hiero, Glyph Designer, Littera and the like),
6
+ * or Egret's own JSON of frames. A string is read as XML when it starts with `<`, as JSON when it starts with `{`, and as text otherwise;
7
+ * white space and a byte order mark before it are left out.
8
+ */
9
+ export declare function parseBitmapFont(source: string | object): BitmapFont;
10
+ //# sourceMappingURL=bitmapFontParse.d.ts.map
@@ -0,0 +1,246 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
4
+ const refuse = (detail) => new EgretError('BITMAP_FONT_INVALID', { cause: new TypeError(detail) });
5
+ const fonts = new WeakSet();
6
+ /** Whether a value is a font this entry read. */
7
+ export const isBitmapFont = (value) => typeof value === 'object' && value !== null && fonts.has(value);
8
+ const draft = () => ({
9
+ face: '',
10
+ size: undefined,
11
+ lineHeight: undefined,
12
+ base: undefined,
13
+ pages: new Map(),
14
+ glyphs: [],
15
+ kernings: []
16
+ });
17
+ /** A whole number from the attribute of a line or an element. */
18
+ function whole(fields, key, where, fallback) {
19
+ const raw = fields[key];
20
+ if (raw === undefined && fallback !== undefined)
21
+ return fallback;
22
+ const value = typeof raw === 'string' && /^\s*-?\d+\s*$/.test(raw) ? Number(raw) : raw;
23
+ if (!Number.isSafeInteger(value))
24
+ throw refuse(where + ': ' + key);
25
+ return value;
26
+ }
27
+ function glyphOf(fields, where, keys) {
28
+ const id = whole(fields, 'id', where), x = whole(fields, keys.x, where), y = whole(fields, keys.y, where), width = whole(fields, keys.width, where), height = whole(fields, keys.height, where);
29
+ if (id < 0 || id > 0x10ffff || x < 0 || y < 0 || width < 0 || height < 0)
30
+ throw refuse(where + ': a character out of range');
31
+ return Object.freeze({
32
+ id,
33
+ x,
34
+ y,
35
+ width,
36
+ height,
37
+ xOffset: whole(fields, keys.xOffset, where, 0),
38
+ yOffset: whole(fields, keys.yOffset, where, 0),
39
+ xAdvance: whole(fields, keys.xAdvance, where),
40
+ page: whole(fields, 'page', where, 0)
41
+ });
42
+ }
43
+ const BMFONT_KEYS = {
44
+ x: 'x',
45
+ y: 'y',
46
+ width: 'width',
47
+ height: 'height',
48
+ xOffset: 'xoffset',
49
+ yOffset: 'yoffset',
50
+ xAdvance: 'xadvance'
51
+ };
52
+ const PLAIN_KEYS = {
53
+ x: 'x',
54
+ y: 'y',
55
+ width: 'width',
56
+ height: 'height',
57
+ xOffset: 'xOffset',
58
+ yOffset: 'yOffset',
59
+ xAdvance: 'xAdvance'
60
+ };
61
+ /** Takes in one tag of the text or XML form: its attributes as strings. */
62
+ function take(into, tag, fields, where) {
63
+ if (tag === 'info') {
64
+ into.face = fields['face'] ?? '';
65
+ if (fields['size'] !== undefined)
66
+ into.size = Math.abs(whole(fields, 'size', where));
67
+ }
68
+ else if (tag === 'common') {
69
+ into.lineHeight = whole(fields, 'lineHeight', where);
70
+ into.base = whole(fields, 'base', where);
71
+ }
72
+ else if (tag === 'page') {
73
+ const id = whole(fields, 'id', where), file = fields['file'];
74
+ if (file === undefined || into.pages.has(id))
75
+ throw refuse(where + ': page');
76
+ into.pages.set(id, file);
77
+ }
78
+ else if (tag === 'char')
79
+ into.glyphs.push(glyphOf(fields, where, BMFONT_KEYS));
80
+ else if (tag === 'kerning')
81
+ into.kernings.push([whole(fields, 'first', where), whole(fields, 'second', where), whole(fields, 'amount', where)]);
82
+ }
83
+ function readText(source) {
84
+ const into = draft();
85
+ source.split(/\r\n|\r|\n/).forEach((line, index) => {
86
+ const tag = /^\s*(\w+)/.exec(line)?.[1];
87
+ if (tag === undefined)
88
+ return;
89
+ const fields = {};
90
+ for (const match of line.matchAll(/(\w+)=("[^"]*"|\S*)/g))
91
+ fields[match[1]] = match[2].startsWith('"') ? match[2].slice(1, -1) : match[2];
92
+ take(into, tag, fields, 'line ' + (index + 1));
93
+ });
94
+ return into;
95
+ }
96
+ const ENTITIES = { quot: '"', amp: '&', lt: '<', gt: '>', apos: "'" };
97
+ function unescape(value) {
98
+ return value.replace(/&(#x[0-9a-fA-F]+|#\d+|\w+);/g, (all, name) => {
99
+ if (name.startsWith('#')) {
100
+ const code = name[1] === 'x' ? parseInt(name.slice(2), 16) : parseInt(name.slice(1), 10);
101
+ return code <= 0x10ffff ? String.fromCodePoint(code) : all;
102
+ }
103
+ return ENTITIES[name] ?? all;
104
+ });
105
+ }
106
+ function readXml(source) {
107
+ const text = source.replace(/<!--[\s\S]*?-->/g, '');
108
+ if (!/<font[\s>]/.test(text))
109
+ throw refuse('xml: no font element');
110
+ const into = draft();
111
+ let count = 0;
112
+ for (const match of text.matchAll(/<(info|common|page|char|kerning)\b([^>]*)>/g)) {
113
+ const fields = {};
114
+ for (const attribute of match[2].matchAll(/(\w+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g))
115
+ fields[attribute[1]] = unescape(attribute[2] ?? attribute[3]);
116
+ take(into, match[1], fields, match[1] + ' element ' + ++count);
117
+ }
118
+ return into;
119
+ }
120
+ function readJson(value) {
121
+ const into = draft(), info = value['info'], common = value['common'], pages = value['pages'], chars = value['chars'], kernings = value['kernings'] ?? [];
122
+ if (!record(common) ||
123
+ !Array.isArray(pages) ||
124
+ !Array.isArray(chars) ||
125
+ !Array.isArray(kernings) ||
126
+ (info !== undefined && !record(info)))
127
+ throw refuse('json: common, pages and chars');
128
+ if (record(info)) {
129
+ if (info['face'] !== undefined && typeof info['face'] !== 'string')
130
+ throw refuse('json: info.face');
131
+ into.face = info['face'] ?? '';
132
+ if (info['size'] !== undefined)
133
+ into.size = Math.abs(whole(info, 'size', 'json info'));
134
+ }
135
+ into.lineHeight = whole(common, 'lineHeight', 'json common');
136
+ into.base = whole(common, 'base', 'json common');
137
+ pages.forEach((file, index) => {
138
+ if (typeof file !== 'string')
139
+ throw refuse('json: page ' + index);
140
+ into.pages.set(index, file);
141
+ });
142
+ chars.forEach((char, index) => {
143
+ if (!record(char))
144
+ throw refuse('json: char ' + index);
145
+ into.glyphs.push(glyphOf(char, 'json char ' + index, BMFONT_KEYS));
146
+ });
147
+ kernings.forEach((pair, index) => {
148
+ if (!record(pair))
149
+ throw refuse('json: kerning ' + index);
150
+ const where = 'json kerning ' + index;
151
+ into.kernings.push([whole(pair, 'first', where), whole(pair, 'second', where), whole(pair, 'amount', where)]);
152
+ });
153
+ return into;
154
+ }
155
+ /** Egret's own form, from its texture merger: one page, each character a frame named by the character. */
156
+ function readEgret(value) {
157
+ const into = draft(), file = value['file'], frames = value['frames'];
158
+ if (typeof file !== 'string' || !record(frames))
159
+ throw refuse('egret: file and frames');
160
+ into.pages.set(0, file);
161
+ let tallest = 0;
162
+ for (const [name, frame] of Object.entries(frames)) {
163
+ if ([...name].length !== 1 || !record(frame))
164
+ throw refuse('egret: frame ' + JSON.stringify(name));
165
+ const where = 'egret frame ' + JSON.stringify(name), width = whole(frame, 'w', where), height = whole(frame, 'h', where);
166
+ // A trimmed frame keeps the size it had before it was trimmed: that is its advance, and the tallest is the height of a line.
167
+ const sourceW = whole(frame, 'sourceW', where, width), sourceH = whole(frame, 'sourceH', where, height);
168
+ into.glyphs.push(glyphOf({
169
+ id: name.codePointAt(0),
170
+ x: frame['x'],
171
+ y: frame['y'],
172
+ width,
173
+ height,
174
+ xOffset: frame['offX'] ?? 0,
175
+ yOffset: frame['offY'] ?? 0,
176
+ xAdvance: sourceW
177
+ }, where, PLAIN_KEYS));
178
+ tallest = Math.max(tallest, sourceH);
179
+ }
180
+ into.lineHeight = tallest;
181
+ into.base = tallest;
182
+ return into;
183
+ }
184
+ function finish(into, format) {
185
+ const { lineHeight, base } = into;
186
+ if (lineHeight === undefined || base === undefined || lineHeight <= 0)
187
+ throw refuse(format + ': the height of a line');
188
+ if (into.pages.size === 0 || [...into.pages.keys()].some(id => id < 0 || id >= into.pages.size))
189
+ throw refuse(format + ': pages numbered from 0 without a gap');
190
+ const pages = Object.freeze(Array.from({ length: into.pages.size }, (_, id) => into.pages.get(id)));
191
+ const byCode = new Map();
192
+ for (const glyph of into.glyphs) {
193
+ if (byCode.has(glyph.id))
194
+ throw refuse(format + ': character ' + glyph.id + ' twice');
195
+ if (glyph.page < 0 || glyph.page >= pages.length)
196
+ throw refuse(format + ': character ' + glyph.id + ' on no page');
197
+ byCode.set(glyph.id, glyph);
198
+ }
199
+ const pairs = new Map();
200
+ for (const [first, second, amount] of into.kernings) {
201
+ const key = first * 0x110000 + second;
202
+ if (first < 0 || second < 0 || first > 0x10ffff || second > 0x10ffff || pairs.has(key))
203
+ throw refuse(format + ': kerning ' + first + ',' + second);
204
+ pairs.set(key, amount);
205
+ }
206
+ const glyphs = Object.freeze([...byCode.values()].sort((a, b) => a.id - b.id));
207
+ const font = Object.freeze({
208
+ face: into.face,
209
+ size: into.size ?? lineHeight,
210
+ lineHeight,
211
+ base,
212
+ pages,
213
+ glyphs,
214
+ format,
215
+ glyph: (codePoint) => byCode.get(codePoint),
216
+ kerning: (first, second) => pairs.get(first * 0x110000 + second) ?? 0
217
+ });
218
+ fonts.add(font);
219
+ return font;
220
+ }
221
+ /**
222
+ * Reads a bitmap font: the text, XML or JSON forms of BMFont (from AngelCode's generator, Hiero, Glyph Designer, Littera and the like),
223
+ * or Egret's own JSON of frames. A string is read as XML when it starts with `<`, as JSON when it starts with `{`, and as text otherwise;
224
+ * white space and a byte order mark before it are left out.
225
+ */
226
+ export function parseBitmapFont(source) {
227
+ if (typeof source === 'string') {
228
+ const text = source.trimStart();
229
+ if (text.startsWith('<'))
230
+ return finish(readXml(text), 'xml');
231
+ if (!text.startsWith('{'))
232
+ return finish(readText(text), 'text');
233
+ let value;
234
+ try {
235
+ value = JSON.parse(text);
236
+ }
237
+ catch (cause) {
238
+ throw new EgretError('BITMAP_FONT_INVALID', { cause });
239
+ }
240
+ return parseBitmapFont(value);
241
+ }
242
+ if (!record(source))
243
+ throw refuse('a string or an object');
244
+ return 'frames' in source ? finish(readEgret(source), 'egret') : finish(readJson(source), 'json');
245
+ }
246
+ //# sourceMappingURL=bitmapFontParse.js.map