@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,431 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // What most games of the play kind draw for themselves: bars, short notices, a box of words that is read and
3
+ // answered, and a menu. Each is made of the game's own sprites and texts on its ui layer, so it scrolls with nothing,
4
+ // fades and is removed as they are, and a restart takes it away. Every one answers the keyboard, the pointer and a
5
+ // finger alike.
6
+ import { Sprite } from '@egret/engine';
7
+ /** A bar of health, time or power. Setting `value` slides it there; a fall leaves a pale trail that catches up. */
8
+ export class PlayBar extends Sprite {
9
+ #value;
10
+ #max;
11
+ #color;
12
+ #shown;
13
+ #trail;
14
+ #width;
15
+ #height;
16
+ #back;
17
+ #drawn = '';
18
+ constructor(width, height, value, max, color, back) {
19
+ super();
20
+ this.#width = width;
21
+ this.#height = height;
22
+ this.#max = max;
23
+ this.#value = this.#shown = this.#trail = Math.max(0, Math.min(max, value));
24
+ this.#color = color;
25
+ this.#back = back;
26
+ this.draw();
27
+ }
28
+ get value() {
29
+ return this.#value;
30
+ }
31
+ set value(next) {
32
+ if (typeof next === 'number' && Number.isFinite(next))
33
+ this.#value = Math.max(0, Math.min(this.#max, next));
34
+ }
35
+ get max() {
36
+ return this.#max;
37
+ }
38
+ set max(next) {
39
+ if (typeof next !== 'number' || !Number.isFinite(next) || next <= 0)
40
+ return;
41
+ this.#max = next;
42
+ this.#value = Math.min(this.#value, next);
43
+ }
44
+ get color() {
45
+ return this.#color;
46
+ }
47
+ set color(next) {
48
+ if (Number.isInteger(next) && next >= 0 && next <= 0xffffff)
49
+ this.#color = next;
50
+ }
51
+ /** Moves what is shown towards the value, by the seconds since the last step. */
52
+ step(seconds) {
53
+ const toward = (from, rate) => Math.abs(this.#value - from) < this.#max / 1000
54
+ ? this.#value
55
+ : from + (this.#value - from) * Math.min(1, rate * seconds);
56
+ this.#shown = toward(this.#shown, 14);
57
+ // The trail of a fall waits a moment, then follows; a rise has no trail.
58
+ this.#trail = this.#trail < this.#shown ? this.#shown : toward(this.#trail, 3);
59
+ this.draw();
60
+ }
61
+ draw() {
62
+ const w = this.#width, h = this.#height, full = (this.#shown / this.#max) * w, trail = (this.#trail / this.#max) * w, key = full.toFixed(1) + ':' + trail.toFixed(1) + ':' + this.#color;
63
+ if (key === this.#drawn)
64
+ return;
65
+ this.#drawn = key;
66
+ const g = this.graphics.clear(), round = Math.min(h / 2, 6);
67
+ g.beginFill(this.#back).drawRoundRect(0, 0, w, h, round).endFill();
68
+ if (trail > full + 0.5)
69
+ g.beginFill(0xffffff, 0.55)
70
+ .drawRect(full, 1, trail - full, h - 2)
71
+ .endFill();
72
+ if (full > 0.5) {
73
+ g.beginFill(this.#color)
74
+ .drawRoundRect(0, 0, Math.max(full, Math.min(h, w)), h, round)
75
+ .endFill();
76
+ g.beginFill(0xffffff, 0.18)
77
+ .drawRect(2, 1, Math.max(0, full - 4), Math.max(1, h * 0.3))
78
+ .endFill();
79
+ }
80
+ }
81
+ }
82
+ /** How wide words are in units of their size: a character of Chinese, Japanese or Korean is one, any other about half. */
83
+ const wide = (character) => /[⺀-鿿가-힯豈-﫿＀-￯]/.test(character);
84
+ const measure = (words) => {
85
+ let units = 0;
86
+ for (const character of words)
87
+ units += wide(character) ? 1 : 0.55;
88
+ return units;
89
+ };
90
+ /** Breaks words into lines no wider than `units`: at a space where there is one, between any two wide characters. */
91
+ export function wrapPlayWords(words, units) {
92
+ const lines = [];
93
+ for (const paragraph of words.split('\n')) {
94
+ let line = '', lineUnits = 0;
95
+ const pieces = paragraph.match(/[⺀-鿿가-힯豈-﫿＀-￯]|\s+|[^\s⺀-鿿가-힯豈-﫿＀-￯]+/g) ?? [];
96
+ for (const piece of pieces) {
97
+ const size = measure(piece);
98
+ if (lineUnits + size > units && line.trim() !== '') {
99
+ lines.push(line.trimEnd());
100
+ line = /^\s+$/.test(piece) ? '' : piece;
101
+ lineUnits = line === '' ? 0 : size;
102
+ continue;
103
+ }
104
+ line += piece;
105
+ lineUnits += size;
106
+ }
107
+ lines.push(line.trimEnd());
108
+ }
109
+ return lines;
110
+ }
111
+ const NEXT = ['space', 'enter', 'z', 'pad:a'], UP = ['up', 'w', 'pad:up'], DOWN = ['down', 's', 'pad:down'];
112
+ /** The widgets of one game. `tick` is called once a step, also while the game is paused, with seconds of the wall. */
113
+ export function createPlayWidgets(game, wake = () => { }) {
114
+ const finite = (value) => typeof value === 'number' && Number.isFinite(value);
115
+ const colour = (value, fallback) => Number.isInteger(value) && value >= 0 && value <= 0xffffff ? value : fallback;
116
+ let bars = [];
117
+ let toasts = [];
118
+ // What is open: a box of words being read, and a list being chosen from. At most one of each at a time.
119
+ let talking;
120
+ let menu;
121
+ let queue = [];
122
+ const tap = (node, run) => game.onTap(node, run);
123
+ const click = () => {
124
+ try {
125
+ game.sfx.play('click', { volume: 0.5 });
126
+ }
127
+ catch {
128
+ // Sound never stops a game.
129
+ }
130
+ };
131
+ /** A column of answers to choose from, each a bar that can be tapped. */
132
+ const choose = (items, layer, left, top, width, size, color, finish) => {
133
+ const height = Math.round(size * 1.9), rows = [];
134
+ const choice = { items, rows, color, width, selected: 0, finish };
135
+ items.forEach((item, index) => {
136
+ const back = game.sprite(undefined, layer);
137
+ back.x = left;
138
+ back.y = top + index * (height + 6);
139
+ const label = game.text(item, { x: 16, y: height / 2, size, baseline: 'middle', layer: back });
140
+ tap(back, () => {
141
+ choice.selected = index;
142
+ paint(choice);
143
+ click();
144
+ finish(index);
145
+ });
146
+ rows.push({ back, label });
147
+ });
148
+ paint(choice, height);
149
+ return choice;
150
+ };
151
+ const paint = (choice, height = choice.rows[0] ? choice.rows[0].label.size * 1.9 : 0) => {
152
+ choice.rows.forEach(({ back, label }, index) => {
153
+ const on = index === choice.selected;
154
+ back.graphics
155
+ .clear()
156
+ .beginFill(on ? choice.color : 0xffffff, on ? 1 : 0.08)
157
+ .drawRoundRect(0, 0, choice.width, Math.round(height), 8)
158
+ .endFill();
159
+ label.color = on ? 0x111827 : 0xffffff;
160
+ });
161
+ };
162
+ /** The size of the words of a box, and how many lines fit under its name. */
163
+ const boxOf = (named) => {
164
+ const size = Math.max(14, Math.round(game.height / 22)), h = Math.max(size * 4.6, Math.round(game.height * 0.28)), top = 14 + (named ? Math.round(size * 1.3) : 0), step = Math.round(size * 1.35);
165
+ return { size, width: game.width - 32 - 36, lines: Math.max(1, Math.floor((h - top - 6) / step)) };
166
+ };
167
+ const pagesOf = (words, named) => {
168
+ const { size, width, lines } = boxOf(named), all = wrapPlayWords(words, width / size), pages = [];
169
+ for (let at = 0; at < all.length; at += lines)
170
+ pages.push(all.slice(at, at + lines).join('\n'));
171
+ return pages.length > 0 ? pages : [''];
172
+ };
173
+ /** Moves the choice by the keys or a stick, and gives true when it is taken. */
174
+ const steer = (choice) => {
175
+ const keys = game.keys, count = choice.items.length;
176
+ let move = keys.pressed(...UP) ? -1 : keys.pressed(...DOWN) ? 1 : 0;
177
+ // The arrows and W and S count in the axis too; a stick moves the choice only when none of them is held.
178
+ if (keys.down(...UP, ...DOWN))
179
+ steered = true;
180
+ const stick = keys.axis().y;
181
+ if (move === 0 && Math.abs(stick) > 0.6) {
182
+ if (!steered)
183
+ move = stick > 0 ? 1 : -1;
184
+ steered = true;
185
+ }
186
+ else if (Math.abs(stick) < 0.3)
187
+ steered = false;
188
+ if (move !== 0) {
189
+ choice.selected = (choice.selected + move + count) % count;
190
+ paint(choice);
191
+ click();
192
+ }
193
+ return keys.pressed(...NEXT);
194
+ };
195
+ let steered = false;
196
+ const PANEL = 0x0b1020;
197
+ const panelOf = (x, y, w, h, alpha = 0.88) => {
198
+ const panel = game.sprite(g => {
199
+ g.beginFill(PANEL, alpha).drawRoundRect(0, 0, w, h, 12).endFill();
200
+ g.lineStyle(2, 0xffffff, 0.18).drawRoundRect(1, 1, w - 2, h - 2, 11);
201
+ }, game.ui);
202
+ panel.x = x;
203
+ panel.y = y;
204
+ return panel;
205
+ };
206
+ const widgets = {
207
+ bar(o) {
208
+ if (o === null || typeof o !== 'object' || !finite(o.x) || !finite(o.y))
209
+ throw new TypeError('a bar takes { x, y }');
210
+ const w = finite(o.width) && o.width > 0 ? o.width : 120, h = finite(o.height) && o.height > 0 ? o.height : 12, max = finite(o.max) && o.max > 0 ? o.max : 1;
211
+ const bar = game.scope.use(new PlayBar(w, h, finite(o.value) ? o.value : max, max, colour(o.color, 0x22c55e), colour(o.back, 0x1f2937)));
212
+ bar.x = o.x;
213
+ bar.y = o.y;
214
+ (o.layer instanceof Sprite ? o.layer : game.ui).addChild(bar);
215
+ bars.push(bar);
216
+ return bar;
217
+ },
218
+ toast(words, o = {}) {
219
+ const size = Math.max(14, Math.round(game.height / 24)), seconds = finite(o?.seconds) && o.seconds > 0 ? o.seconds : 2, w = Math.min(game.width - 32, measure(String(words)) * size + 40), h = Math.round(size * 2);
220
+ toasts = toasts.filter(node => !node.isDisposed && node.parent !== null);
221
+ const node = game.sprite(g => {
222
+ g.beginFill(0x0b1020, 0.85)
223
+ .drawRoundRect(-w / 2, 0, w, h, h / 2)
224
+ .endFill();
225
+ }, game.ui);
226
+ node.x = game.width / 2;
227
+ node.y = 12 + toasts.length * (h + 6);
228
+ game.text(String(words), {
229
+ y: h / 2,
230
+ size,
231
+ align: 'center',
232
+ baseline: 'middle',
233
+ color: colour(o?.color, 0xffffff),
234
+ layer: node
235
+ });
236
+ toasts.push(node);
237
+ node.alpha = 0;
238
+ game
239
+ .tween(node)
240
+ .to({ alpha: 1 }, 0.15)
241
+ .wait(seconds)
242
+ .to({ alpha: 0 }, 0.3)
243
+ .call(() => game.remove(node));
244
+ },
245
+ say(words, o = {}) {
246
+ // Words longer than a box holds are shown a box at a time; the answers, if any, come with the last.
247
+ const pages = pagesOf(String(words), typeof o?.who === 'string' && o.who !== '');
248
+ const { choices: _answers, ...rest } = o ?? {};
249
+ for (const page of pages.slice(0, -1))
250
+ void widgets.sayPage(page, rest);
251
+ return widgets.sayPage(pages[pages.length - 1], o);
252
+ },
253
+ sayPage(words, o = {}) {
254
+ const choices = Array.isArray(o?.choices) && o.choices.length > 0 ? o.choices.map(String) : undefined;
255
+ return new Promise(resolve => {
256
+ const open = () => {
257
+ const margin = 16, w = game.width - 2 * margin, size = Math.max(14, Math.round(game.height / 22)), h = Math.max(size * 4.6, Math.round(game.height * 0.28)),
258
+ // Opaque, so the covers that hide words not yet shown are the panel's own colour.
259
+ panel = panelOf(margin, game.height - h - margin, w, h, 1), color = colour(o?.color, 0xfacc15);
260
+ let top = 14;
261
+ if (typeof o?.who === 'string' && o.who !== '') {
262
+ game.text(o.who, { x: 18, y: 10, size: Math.round(size * 0.9), bold: true, color, layer: panel });
263
+ top += Math.round(size * 1.3);
264
+ }
265
+ const lines = wrapPlayWords(String(words), (w - 36) / size), total = lines.reduce((sum, line) => sum + [...line].length, 0), step = Math.round(size * 1.35);
266
+ // Each line is drawn whole once; a cover over it moves right as its letters appear. Changing the words
267
+ // themselves each step would draw them again each step.
268
+ const body = lines.map((line, index) => game.text(line, { x: 18, y: top + index * step, size, layer: panel }));
269
+ const covers = lines.map((_, index) => {
270
+ const cover = game.sprite(g => g.beginFill(PANEL).drawRect(0, 0, 1, step).endFill(), panel);
271
+ cover.x = 16;
272
+ cover.y = top + index * step - 2;
273
+ cover.scaleX = w - 32;
274
+ return cover;
275
+ });
276
+ const hint = game.text('▼', {
277
+ x: w - 22,
278
+ y: h - size - 8,
279
+ size: Math.round(size * 0.7),
280
+ color,
281
+ layer: panel
282
+ });
283
+ hint.visible = false;
284
+ const speed = finite(o?.speed) && o.speed >= 0 ? o.speed : 40;
285
+ const record = {
286
+ panel,
287
+ words: body,
288
+ covers,
289
+ lines,
290
+ total,
291
+ shown: speed === 0 ? total : 0,
292
+ speed,
293
+ hint,
294
+ choice: undefined,
295
+ choices,
296
+ armed: false,
297
+ color,
298
+ finish(index) {
299
+ // A tap and a key in one step answer once.
300
+ if (talking !== record)
301
+ return;
302
+ talking = undefined;
303
+ game.remove(panel);
304
+ resolve(index);
305
+ const next = queue.shift();
306
+ next?.();
307
+ }
308
+ };
309
+ talking = record;
310
+ show();
311
+ };
312
+ if (talking === undefined)
313
+ open();
314
+ else
315
+ queue.push(open);
316
+ wake();
317
+ });
318
+ },
319
+ menu(items, o = {}) {
320
+ if (!Array.isArray(items) || items.length === 0)
321
+ throw new TypeError('a menu takes a list of items');
322
+ const list = items.map(String);
323
+ return new Promise(resolve => {
324
+ menu?.choice.finish(-1);
325
+ const size = Math.max(14, Math.round(game.height / 20)), row = Math.round(size * 1.9) + 6, titleLines = typeof o?.title === 'string' ? o.title.split('\n') : [], longest = Math.max(...list.map(measure), ...titleLines.map(line => measure(line) * 1.2)), w = finite(o?.width) && o.width > 0 ? o.width : Math.min(game.width - 32, longest * size + 64), titled = typeof o?.title === 'string' && o.title !== '',
326
+ // A title of several lines takes as many lines of room, so the first item is never under it.
327
+ titleHeight = titled ? Math.round(size * (0.35 + 1.45 * titleLines.length)) : 0, h = list.length * row + 24 + titleHeight, x = (finite(o?.x) ? o.x : game.width / 2) - w / 2, y = (finite(o?.y) ? o.y : game.height / 2) - h / 2;
328
+ const panel = panelOf(x, y, w, h);
329
+ if (titled)
330
+ game.text(o.title, {
331
+ x: w / 2,
332
+ y: 12,
333
+ size: Math.round(size * 1.1),
334
+ bold: true,
335
+ align: 'center',
336
+ layer: panel
337
+ });
338
+ const opened = { panel };
339
+ opened.choice = choose(list, panel, 12, titled ? titleHeight + 8 : 12, w - 24, size, colour(o?.color, 0xfacc15), index => {
340
+ if (menu !== opened)
341
+ return;
342
+ menu = undefined;
343
+ game.remove(panel);
344
+ if (index >= 0)
345
+ resolve(index);
346
+ });
347
+ menu = opened;
348
+ wake();
349
+ });
350
+ },
351
+ get asking() {
352
+ return talking !== undefined || menu !== undefined;
353
+ },
354
+ tick(seconds) {
355
+ bars = bars.filter(bar => !bar.isDisposed);
356
+ for (const bar of bars)
357
+ bar.step(seconds);
358
+ if (menu !== undefined) {
359
+ const open = menu;
360
+ if (steer(open.choice)) {
361
+ click();
362
+ open.choice.finish(open.choice.selected);
363
+ }
364
+ return;
365
+ }
366
+ if (talking === undefined)
367
+ return;
368
+ const open = talking;
369
+ if (game.pointer.pressed)
370
+ open.armed = true;
371
+ const pressed = game.keys.pressed(...NEXT) || (open.armed && game.pointer.released);
372
+ if (open.choice !== undefined) {
373
+ if (steer(open.choice)) {
374
+ click();
375
+ open.choice.finish(open.choice.selected);
376
+ }
377
+ return;
378
+ }
379
+ if (open.shown < open.total) {
380
+ if (pressed)
381
+ open.shown = open.total;
382
+ else
383
+ open.shown = Math.min(open.total, open.shown + open.speed * seconds);
384
+ show();
385
+ return;
386
+ }
387
+ if (open.choices !== undefined)
388
+ return;
389
+ if (pressed) {
390
+ click();
391
+ open.finish(undefined);
392
+ }
393
+ },
394
+ reset() {
395
+ // A restart has taken their sprites; what was being awaited is not answered.
396
+ bars = [];
397
+ toasts = [];
398
+ talking = undefined;
399
+ menu = undefined;
400
+ queue = [];
401
+ }
402
+ };
403
+ /** Shows as many letters as have appeared, and the answers once all have. */
404
+ function show() {
405
+ const open = talking;
406
+ if (open === undefined)
407
+ return;
408
+ let left = Math.floor(open.shown);
409
+ open.lines.forEach((line, index) => {
410
+ const characters = [...line], cover = open.covers[index], shown = Math.max(0, Math.min(characters.length, left));
411
+ left -= characters.length;
412
+ const from = 18 + measure(characters.slice(0, shown).join('')) * open.words[index].size;
413
+ cover.visible = shown < characters.length;
414
+ cover.x = from;
415
+ cover.scaleX = Math.max(1, game.width - 48 - from);
416
+ });
417
+ const done = open.shown >= open.total;
418
+ open.hint.visible = done && open.choices === undefined;
419
+ if (done && open.choices !== undefined && open.choice === undefined) {
420
+ const size = open.words[0].size, row = Math.round(size * 1.9) + 6, w = Math.min(game.width - 32, Math.max(...open.choices.map(measure)) * size + 64), x = game.width - 16 - w, y = open.panel.y - open.choices.length * row - 20;
421
+ const holder = panelOf(x, y, w, open.choices.length * row + 14);
422
+ const close = open.finish;
423
+ open.choice = choose(open.choices, holder, 8, 8, w - 16, size, open.color, index => {
424
+ game.remove(holder);
425
+ close(index);
426
+ });
427
+ }
428
+ }
429
+ return widgets;
430
+ }
431
+ //# sourceMappingURL=playWidgets.js.map
@@ -0,0 +1,3 @@
1
+ export { createBrowserPointerInput } from './BrowserPointerInput.js';
2
+ export type { PointerInput, PointerInputOptions } from '#egret-pointer-input';
3
+ //# sourceMappingURL=pointer.d.ts.map
@@ -0,0 +1,3 @@
1
+ // Optional browser pointer entry keeps native input out of the default Engine graph.
2
+ export { createBrowserPointerInput } from './BrowserPointerInput.js';
3
+ //# sourceMappingURL=pointer.js.map
@@ -0,0 +1,27 @@
1
+ import type { SharedPageCopyDiagnostics2D } from '../rendering/sharedColor2D.js';
2
+ import type { PreparedSharedFrame2D } from '../rendering/prepareSharedDraws2D.js';
3
+ import { packSharedDraws2D, SHARED_REGION_WINDOW_BYTES_2D } from '../rendering/packSharedDraws2D.js';
4
+ import type { SharedWebGPUConfiguration } from './sharedWebGPUOptions.js';
5
+ import type { SharedOwnerSnapshot2D, SharedSubmissionStorage2D as NeutralSharedSubmissionStorage2D } from './sharedSubmissionStorage2D.js';
6
+ export { SharedStorageError2D } from './sharedSubmissionStorage2D.js';
7
+ export type { SharedOwnerSnapshot2D } from './sharedSubmissionStorage2D.js';
8
+ export interface SharedSubmissionStorage2D extends NeutralSharedSubmissionStorage2D {
9
+ readonly options: SharedWebGPUConfiguration;
10
+ }
11
+ export declare const checkSharedCapacity2D: (storage: SharedSubmissionStorage2D, owner: SharedOwnerSnapshot2D, canonicalBytes?: number, sourceCopy?: number) => void;
12
+ export declare const materializeSharedPages2D: (storage: SharedSubmissionStorage2D, cold: ReadonlySet<number>, owner: SharedOwnerSnapshot2D, diagnostics?: SharedPageCopyDiagnostics2D) => {
13
+ projections: (Uint8Array<ArrayBuffer> | undefined)[];
14
+ canonicalBytes: number;
15
+ };
16
+ /** Every window of the region table starts at a multiple of this many bytes of its buffer. */
17
+ export declare const SHARED_REGION_WINDOW_STRIDE_2D = 16384;
18
+ /** Preserve WebGPU fees, 256-byte rows, native checks and pending order before payloads. */
19
+ export declare function planSharedSubmission2D(prepared: PreparedSharedFrame2D, options: SharedWebGPUConfiguration, hardware: {
20
+ maxTextureDimension2D: number;
21
+ maxBufferSize: number;
22
+ }, owner: SharedOwnerSnapshot2D, readback: boolean): SharedSubmissionStorage2D;
23
+ export declare const packSharedSubmission2D: typeof packSharedDraws2D;
24
+ export { SHARED_REGION_WINDOW_BYTES_2D };
25
+ /** The region table as its uniform buffer holds it: whole windows, the last one allocated in full. */
26
+ export declare function packSharedRegionWindows2D(frame: PreparedSharedFrame2D['frame']): Uint32Array<ArrayBuffer>;
27
+ //# sourceMappingURL=prepareSharedSubmission2D.d.ts.map
@@ -0,0 +1,63 @@
1
+ import { packSharedDraws2D, packSharedRegions2D, SHARED_REGION_WINDOW_2D, SHARED_REGION_WINDOW_BYTES_2D } from '../rendering/packSharedDraws2D.js';
2
+ import { noteOwnedPreparationFailure } from '../rendering/ownedPreparationFailure2D.js';
3
+ import { sharedPageChainBytes2D } from '../rendering/sharedColor2D.js';
4
+ import { SharedStorageError2D, planSharedStorageFees2D, withSharedReadbackLayout2D, checkSharedCapacity2D as checkSharedStorageCapacity2D, materializeSharedPages2D as materializeSharedStoragePages2D } from './sharedSubmissionStorage2D.js';
5
+ // Retain the existing error constructor identity and private WebGPU callable types.
6
+ export { SharedStorageError2D } from './sharedSubmissionStorage2D.js';
7
+ export const checkSharedCapacity2D = checkSharedStorageCapacity2D;
8
+ export const materializeSharedPages2D = materializeSharedStoragePages2D;
9
+ function failDevice() {
10
+ throw noteOwnedPreparationFailure(new SharedStorageError2D('device'));
11
+ }
12
+ /** Every window of the region table starts at a multiple of this many bytes of its buffer. */
13
+ export const SHARED_REGION_WINDOW_STRIDE_2D = 16384;
14
+ /** Preserve WebGPU fees, 256-byte rows, native checks and pending order before payloads. */
15
+ export function planSharedSubmission2D(prepared, options, hardware, owner, readback) {
16
+ const fees = planSharedStorageFees2D(prepared, options), { width, height } = prepared;
17
+ const rowPitch = readback ? Math.ceil((4 * width) / 256) * 256 : 0, staging = rowPitch * height, output = readback ? fees.colorBytes : 0;
18
+ const layout = withSharedReadbackLayout2D(fees, { rowPitch, staging, output });
19
+ if (width > hardware.maxTextureDimension2D ||
20
+ height > hardware.maxTextureDimension2D ||
21
+ staging > hardware.maxBufferSize)
22
+ failDevice();
23
+ for (const draw of prepared.entries)
24
+ if (draw.kind === 'draw' && (52 * draw.vertexReservation > hardware.maxBufferSize || 128 > hardware.maxBufferSize))
25
+ failDevice();
26
+ // The region table is one buffer of whole windows; a frame with a draw that has a region needs it.
27
+ if (prepared.entries.some(draw => draw.kind === 'draw' && draw.region !== undefined && draw.vertexReservation > 0) &&
28
+ (Math.ceil(prepared.frame.regions.length / SHARED_REGION_WINDOW_2D) - 1) * SHARED_REGION_WINDOW_STRIDE_2D +
29
+ SHARED_REGION_WINDOW_BYTES_2D >
30
+ hardware.maxBufferSize)
31
+ failDevice();
32
+ const views = prepared.frame.pages.map((page, index) => {
33
+ const image = page.source, levels = prepared.pageLevels?.[index] ?? 1;
34
+ if (image.width > hardware.maxTextureDimension2D || image.height > hardware.maxTextureDimension2D)
35
+ failDevice();
36
+ return {
37
+ image,
38
+ region: { x: 0, y: 0, width: image.width, height: image.height },
39
+ byteLength: levels === 1 ? image.byteLength : sharedPageChainBytes2D(image.width, image.height, levels),
40
+ levels
41
+ };
42
+ });
43
+ const projectionPlan = {
44
+ views,
45
+ commandViews: [],
46
+ projectionBytes: prepared.pageBytes,
47
+ scratchBytes: 0
48
+ };
49
+ const storage = { ...layout, options, projectionPlan };
50
+ checkSharedCapacity2D(storage, owner);
51
+ return storage;
52
+ }
53
+ export const packSharedSubmission2D = packSharedDraws2D;
54
+ export { SHARED_REGION_WINDOW_BYTES_2D };
55
+ /** The region table as its uniform buffer holds it: whole windows, the last one allocated in full. */
56
+ export function packSharedRegionWindows2D(frame) {
57
+ const rows = packSharedRegions2D(frame), count = Math.ceil(frame.regions.length / SHARED_REGION_WINDOW_2D);
58
+ const bytes = (count - 1) * SHARED_REGION_WINDOW_STRIDE_2D + SHARED_REGION_WINDOW_BYTES_2D, table = new Uint32Array(bytes / 4);
59
+ for (let i = 0; i < count; i++)
60
+ table.set(rows.subarray(12 * SHARED_REGION_WINDOW_2D * i, Math.min(rows.length, 12 * SHARED_REGION_WINDOW_2D * (i + 1))), (i * SHARED_REGION_WINDOW_STRIDE_2D) / 4);
61
+ return table;
62
+ }
63
+ //# sourceMappingURL=prepareSharedSubmission2D.js.map
@@ -0,0 +1,29 @@
1
+ import type { ManifestByteSource } from './ManifestByteSource.js';
2
+ import type { BrowserPngPorts, ManifestTextureProvider } from './BrowserTextureProvider.js';
3
+ import type { Engine } from '@egret/engine';
4
+ import type { ContentLoader } from '@egret/engine/resources';
5
+ import type { AdmittedResourceManifest } from '@egret/contracts/resources';
6
+ import type { ManifestByteSourceOptions, ManifestByteSourceStatus } from './ManifestByteSource.js';
7
+ import type { ManifestTextureProviderStatus } from './BrowserTextureProvider.js';
8
+ export { createManifestByteSource } from './ManifestByteSource.js';
9
+ export type { ManifestByteSource, ManifestByteSourceOptions, ManifestByteSourceStatus } from './ManifestByteSource.js';
10
+ export type { ManifestTextureProvider, ManifestTextureProviderStatus } from './BrowserTextureProvider.js';
11
+ /** A manifest texture provider to make: the ports it decodes with. */
12
+ export interface ManifestTextureProviderOptions {
13
+ readonly ports?: BrowserPngPorts;
14
+ }
15
+ /** Source authentication precedes every caller-controlled options read. */
16
+ export declare function createManifestTextureProvider(source: ManifestByteSource, options?: ManifestTextureProviderOptions): ManifestTextureProvider;
17
+ /** A content loader for a manifest in the browser: its status, and a call that closes it. */
18
+ export interface ManifestContentLoader extends ContentLoader {
19
+ close(): Promise<void>;
20
+ getStatus(): Readonly<{
21
+ source: ManifestByteSourceStatus;
22
+ provider: ManifestTextureProviderStatus;
23
+ }>;
24
+ }
25
+ /** Integrity-checked PNG/UTF-8 transport plus the DOM-free content assembly. */
26
+ export declare function createManifestContentLoader(engine: Engine, manifest: AdmittedResourceManifest, options: ManifestByteSourceOptions): ManifestContentLoader;
27
+ export { createManifestFontContentLoader } from './ManifestFontContentLoader.js';
28
+ export type { ManifestFontContentLoader } from './ManifestFontContentLoader.js';
29
+ //# sourceMappingURL=resources.d.ts.map
@@ -0,0 +1,96 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { requireManifestByteSource } from './ManifestByteSource.js';
3
+ import { createManifestPngTextureProvider } from './BrowserTextureProvider.js';
4
+ import { EgretError } from '@egret/runtime';
5
+ import { createContentLoader } from '@egret/engine/resources';
6
+ import { createManifestByteSource } from './ManifestByteSource.js';
7
+ export { createManifestByteSource } from './ManifestByteSource.js';
8
+ /** Source authentication precedes every caller-controlled options read. */
9
+ export function createManifestTextureProvider(source, options) {
10
+ const owner = requireManifestByteSource(source);
11
+ let captured = Object.freeze({});
12
+ if (options !== undefined) {
13
+ if (typeof options !== 'object' ||
14
+ options === null ||
15
+ (Object.getPrototypeOf(options) !== Object.prototype && Object.getPrototypeOf(options) !== null))
16
+ throw new EgretError('WEB_RESOURCE_OPTIONS_INVALID');
17
+ for (const key of Reflect.ownKeys(options)) {
18
+ if (key !== 'ports')
19
+ throw new EgretError('WEB_RESOURCE_OPTIONS_INVALID');
20
+ const property = Object.getOwnPropertyDescriptor(options, key);
21
+ if (!property || !Object.hasOwn(property, 'value') || property.value === undefined)
22
+ throw new EgretError('WEB_RESOURCE_OPTIONS_INVALID');
23
+ captured = Object.freeze({ ports: property.value });
24
+ }
25
+ }
26
+ return createManifestPngTextureProvider(owner, captured);
27
+ }
28
+ /** Integrity-checked PNG/UTF-8 transport plus the DOM-free content assembly. */
29
+ export function createManifestContentLoader(engine, manifest, options) {
30
+ let source;
31
+ let provider;
32
+ let loader;
33
+ try {
34
+ loader = createContentLoader(engine, manifest, bindings => {
35
+ source = createManifestByteSource(manifest, bindings.map(row => row.binding), options);
36
+ provider = createManifestTextureProvider(source);
37
+ const capturedSource = source;
38
+ return {
39
+ textures: provider,
40
+ metadata: {
41
+ async load(ref, context) {
42
+ const bytes = await capturedSource.readBytes(ref, context);
43
+ if (bytes.byteLength > 4194304)
44
+ throw new EgretError('CONTENT_METADATA_LIMIT');
45
+ // Decode verified bytes strictly; schema/relationships remain core authority.
46
+ return new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes);
47
+ },
48
+ dispose() { }
49
+ }
50
+ };
51
+ });
52
+ }
53
+ catch (cause) {
54
+ // Construction has no public owner; close any host work already created.
55
+ void provider?.close().catch(() => { });
56
+ void source?.close().catch(() => { });
57
+ throw cause;
58
+ }
59
+ const byteSource = source, textures = provider;
60
+ let closePromise;
61
+ const facade = Object.freeze({
62
+ get isDisposed() {
63
+ if (this !== facade)
64
+ throw new EgretError('CONTENT_LOADER_INVALID');
65
+ return loader.isDisposed;
66
+ },
67
+ load(scope, roots, groupOptions) {
68
+ if (this !== facade)
69
+ throw new EgretError('CONTENT_LOADER_INVALID');
70
+ return loader.load(scope, roots, groupOptions);
71
+ },
72
+ dispose() {
73
+ if (this !== facade)
74
+ throw new EgretError('CONTENT_LOADER_INVALID');
75
+ loader.dispose();
76
+ },
77
+ close() {
78
+ if (this !== facade)
79
+ throw new EgretError('CONTENT_LOADER_INVALID');
80
+ if (closePromise === undefined) {
81
+ // Synchronous revocation precedes native cancellation and settlement.
82
+ loader.dispose();
83
+ closePromise = Promise.all([textures.close(), byteSource.close()]).then(() => { });
84
+ }
85
+ return closePromise;
86
+ },
87
+ getStatus() {
88
+ if (this !== facade)
89
+ throw new EgretError('CONTENT_LOADER_INVALID');
90
+ return Object.freeze({ source: byteSource.getStatus(), provider: textures.getStatus() });
91
+ }
92
+ });
93
+ return facade;
94
+ }
95
+ export { createManifestFontContentLoader } from './ManifestFontContentLoader.js';
96
+ //# sourceMappingURL=resources.js.map
@@ -0,0 +1,3 @@
1
+ export { createBrowserSemantics } from './BrowserSemantics.js';
2
+ export type { BrowserSemantics, BrowserSemanticsOptions } from './BrowserSemantics.js';
3
+ //# sourceMappingURL=semantics.d.ts.map
@@ -0,0 +1,4 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Optional browser projection of the semantic tree keeps the page out of the default Engine graph.
3
+ export { createBrowserSemantics } from './BrowserSemantics.js';
4
+ //# sourceMappingURL=semantics.js.map