@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,89 @@
1
+ /** Rectangle in logical stage units, the units of the display tree and of pointer input. */
2
+ export interface BrowserTextInputRectangle {
3
+ readonly x: number;
4
+ readonly y: number;
5
+ readonly width: number;
6
+ readonly height: number;
7
+ }
8
+ /** Which on-screen keyboard to ask for. */
9
+ export type BrowserTextInputMode = 'text' | 'numeric' | 'decimal' | 'tel' | 'email' | 'url' | 'search' | 'none';
10
+ /** What the Enter key of an on-screen keyboard says. */
11
+ export type BrowserTextInputEnterHint = 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';
12
+ /** The value after a change, and whether a composition is under way. */
13
+ export interface BrowserTextInputChange {
14
+ readonly value: string;
15
+ /** True while the input method still holds provisional text, such as pinyin before a candidate is chosen. */
16
+ readonly composing: boolean;
17
+ }
18
+ /** One editing session. Every length is in logical stage units and every colour is 0xRRGGBB. */
19
+ export interface BrowserTextInputRequest extends BrowserTextInputRectangle {
20
+ readonly value?: string;
21
+ readonly multiline?: boolean;
22
+ readonly password?: boolean;
23
+ /** Counted in characters (code points), so one Chinese character or one emoji counts once. */
24
+ readonly maxLength?: number;
25
+ readonly placeholder?: string;
26
+ readonly placeholderColor?: number;
27
+ /** Accessible name of the field. */
28
+ readonly label?: string;
29
+ /** BCP 47 tag, for example 'zh-CN'. */
30
+ readonly locale?: string;
31
+ readonly inputMode?: BrowserTextInputMode;
32
+ readonly enterKeyHint?: BrowserTextInputEnterHint;
33
+ readonly fontFamily?: string;
34
+ readonly fontSize?: number;
35
+ readonly fontWeight?: number | 'normal' | 'bold';
36
+ readonly lineHeight?: number;
37
+ readonly color?: number;
38
+ /** Omitted: transparent, so that what the game drew under the field shows through. */
39
+ readonly backgroundColor?: number;
40
+ readonly textAlign?: 'left' | 'center' | 'right';
41
+ readonly padding?: number;
42
+ readonly select?: 'all' | 'end';
43
+ /** What ends the session when the field loses focus or the player presses elsewhere. Default 'commit'. */
44
+ readonly blur?: 'commit' | 'cancel';
45
+ readonly onChange?: (change: BrowserTextInputChange) => void;
46
+ readonly onCommit?: (value: string) => void;
47
+ readonly onCancel?: () => void;
48
+ }
49
+ /** Browser text input to make: its canvas and size, the element it goes into, and whether keys are kept from the game. */
50
+ export interface BrowserTextInputOptions {
51
+ readonly canvas: HTMLCanvasElement;
52
+ readonly logicalWidth: number;
53
+ readonly logicalHeight: number;
54
+ /** Element that receives the field. Default: the parent of the canvas, so that a fullscreen container keeps it. */
55
+ readonly parent?: HTMLElement;
56
+ readonly zIndex?: number;
57
+ /** Keeps key events of the field from bubbling to game shortcuts on the document or the window. Default true. */
58
+ readonly isolateKeys?: boolean;
59
+ readonly onError?: (error: unknown) => void;
60
+ }
61
+ /** Browser text input as it is now: its state, value and composition. */
62
+ export interface BrowserTextInputSnapshot {
63
+ readonly state: 'idle' | 'open' | 'disposed';
64
+ readonly value: string;
65
+ readonly composing: boolean;
66
+ }
67
+ /** A native text field over the canvas, for typing with the platform's keyboard and input methods. */
68
+ export interface BrowserTextInput {
69
+ /** Opens a field and focuses it. A session that is still open is cancelled first. */
70
+ open(request: BrowserTextInputRequest): void;
71
+ commit(): void;
72
+ cancel(): void;
73
+ setValue(value: string): void;
74
+ /** Moves the open field, for example with a panel that slides. */
75
+ move(rectangle: BrowserTextInputRectangle): void;
76
+ /** New logical size of the stage. */
77
+ resize(logicalWidth: number, logicalHeight: number): void;
78
+ /** Places the open field again. Window, viewport and canvas size changes do this by themselves. */
79
+ sync(): void;
80
+ getSnapshot(): BrowserTextInputSnapshot;
81
+ dispose(): void;
82
+ }
83
+ /**
84
+ * Platform text entry over a canvas: a native field placed on a rectangle of the stage, so that input methods
85
+ * (Chinese, Japanese, Korean), on-screen keyboards, paste and accessibility work as the platform provides them.
86
+ * Importing performs no host work, and nothing is added to the page until a session opens.
87
+ */
88
+ export declare function createBrowserTextInput(options: BrowserTextInputOptions): BrowserTextInput;
89
+ //# sourceMappingURL=BrowserTextInput.d.ts.map
@@ -0,0 +1,524 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { EgretError } from '@egret/runtime';
3
+ const MODES = ['text', 'numeric', 'decimal', 'tel', 'email', 'url', 'search', 'none'];
4
+ const HINTS = ['enter', 'done', 'go', 'next', 'previous', 'search', 'send'];
5
+ const PLACEHOLDER = '--egret-text-input-placeholder', MARK = 'data-egret-text-input', PROBE = 100, TEXT_LIMIT = 1048576;
6
+ function fault(code) {
7
+ return new EgretError('BROWSER_TEXT_INPUT_' + code);
8
+ }
9
+ function scalar(value, minimum, maximum, code) {
10
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < minimum || value > maximum)
11
+ throw fault(code);
12
+ return value;
13
+ }
14
+ function text(value, maximum, code) {
15
+ if (typeof value !== 'string' || value.length > maximum || value.includes('\0'))
16
+ throw fault(code);
17
+ return value;
18
+ }
19
+ function colour(value, code) {
20
+ if (typeof value !== 'number' || !Number.isInteger(value) || value < 0 || value > 0xffffff)
21
+ throw fault(code);
22
+ return '#' + value.toString(16).padStart(6, '0');
23
+ }
24
+ function rectangle(value, code) {
25
+ if (!value || typeof value !== 'object')
26
+ throw fault(code);
27
+ return {
28
+ x: scalar(value.x, -1048576, 1048576, code),
29
+ y: scalar(value.y, -1048576, 1048576, code),
30
+ width: scalar(value.width, 1, 16384, code),
31
+ height: scalar(value.height, 1, 16384, code)
32
+ };
33
+ }
34
+ function points(value) {
35
+ let count = 0;
36
+ for (const _ of value)
37
+ count++;
38
+ return count;
39
+ }
40
+ /** Index that lies `count` characters before `index`, never inside a surrogate pair. */
41
+ function back(value, index, count) {
42
+ let at = index;
43
+ while (count > 0 && at > 0) {
44
+ at--;
45
+ const unit = value.charCodeAt(at);
46
+ if (unit >= 0xdc00 && unit <= 0xdfff && at > 0) {
47
+ const lead = value.charCodeAt(at - 1);
48
+ if (lead >= 0xd800 && lead <= 0xdbff)
49
+ at--;
50
+ }
51
+ count--;
52
+ }
53
+ return at;
54
+ }
55
+ function head(value, count) {
56
+ let at = 0;
57
+ for (const point of value) {
58
+ if (count-- <= 0)
59
+ break;
60
+ at += point.length;
61
+ }
62
+ return value.slice(0, at);
63
+ }
64
+ /**
65
+ * Platform text entry over a canvas: a native field placed on a rectangle of the stage, so that input methods
66
+ * (Chinese, Japanese, Korean), on-screen keyboards, paste and accessibility work as the platform provides them.
67
+ * Importing performs no host work, and nothing is added to the page until a session opens.
68
+ */
69
+ export function createBrowserTextInput(options) {
70
+ if (!options || typeof options !== 'object')
71
+ throw fault('OPTIONS');
72
+ const canvas = options.canvas, zIndex = options.zIndex ?? 1, isolate = options.isolateKeys ?? true, onError = options.onError;
73
+ const win = globalThis.window, doc = globalThis.document;
74
+ if (win === undefined ||
75
+ doc === undefined ||
76
+ typeof globalThis.HTMLCanvasElement !== 'function' ||
77
+ !(canvas instanceof globalThis.HTMLCanvasElement) ||
78
+ canvas.ownerDocument !== doc)
79
+ throw fault('SURFACE');
80
+ if (!Number.isInteger(zIndex) ||
81
+ zIndex < 0 ||
82
+ zIndex > 1000000 ||
83
+ typeof isolate !== 'boolean' ||
84
+ (onError !== undefined && typeof onError !== 'function'))
85
+ throw fault('OPTIONS');
86
+ if (options.parent !== undefined &&
87
+ (!(options.parent instanceof globalThis.HTMLElement) || options.parent.ownerDocument !== doc))
88
+ throw fault('OPTIONS');
89
+ let logicalWidth = scalar(options.logicalWidth, 0.25, 16384, 'OPTIONS'), logicalHeight = scalar(options.logicalHeight, 0.25, 16384, 'OPTIONS');
90
+ let disposed = false, session, sheet, releaseFocus = () => { };
91
+ function report(cause) {
92
+ try {
93
+ if (onError) {
94
+ onError(cause);
95
+ return;
96
+ }
97
+ }
98
+ catch (secondary) {
99
+ cause = secondary;
100
+ }
101
+ if (typeof globalThis.reportError === 'function')
102
+ globalThis.reportError(cause);
103
+ else
104
+ queueMicrotask(() => {
105
+ throw cause;
106
+ });
107
+ }
108
+ function guard(action) {
109
+ try {
110
+ action();
111
+ }
112
+ catch (cause) {
113
+ report(cause);
114
+ }
115
+ }
116
+ function placeholderSheet() {
117
+ // A constructed sheet styles ::placeholder without an inline <style>, which a content security policy may refuse.
118
+ if (sheet || typeof globalThis.CSSStyleSheet !== 'function' || !Array.isArray(doc.adoptedStyleSheets))
119
+ return;
120
+ try {
121
+ const next = new globalThis.CSSStyleSheet();
122
+ next.replaceSync('[' + MARK + ']::placeholder{color:var(' + PLACEHOLDER + ',GrayText);opacity:1}');
123
+ doc.adoptedStyleSheets = [...doc.adoptedStyleSheets, next];
124
+ sheet = next;
125
+ }
126
+ catch {
127
+ /* The platform colour of a placeholder remains. */
128
+ }
129
+ }
130
+ function layout() {
131
+ const current = session;
132
+ if (!current)
133
+ return;
134
+ const box = canvas.getBoundingClientRect(), node = current.node, style = node.style;
135
+ if (!(box.width > 0) || !(box.height > 0) || !canvas.isConnected) {
136
+ style.visibility = 'hidden';
137
+ return;
138
+ }
139
+ // The wrapper is a fixed square of known size. Where it lands and how large it measures give the offset
140
+ // and scale that an ancestor imposes on fixed content, which the field's own placement then undoes.
141
+ const probe = current.wrapper.getBoundingClientRect();
142
+ const ax = probe.width > 0 ? probe.width / PROBE : 1, ay = probe.height > 0 ? probe.height / PROBE : 1;
143
+ const sx = box.width / logicalWidth, sy = box.height / logicalHeight, place = current.place;
144
+ style.visibility = 'visible';
145
+ style.left = (box.left + place.x * sx - probe.left) / ax + 'px';
146
+ style.top = (box.top + place.y * sy - probe.top) / ay + 'px';
147
+ style.width = place.width + 'px';
148
+ style.height = place.height + 'px';
149
+ style.transform = 'scale(' + sx / ax + ',' + sy / ay + ')';
150
+ }
151
+ function limit(current) {
152
+ const node = current.node, maximum = current.maxLength;
153
+ if (maximum === undefined || current.composing)
154
+ return;
155
+ let value = node.value, excess = points(value) - maximum;
156
+ if (excess <= 0)
157
+ return;
158
+ // What was just typed, pasted or composed ends at the caret: the excess is taken from there, not from the tail.
159
+ const end = Math.min(node.selectionEnd ?? value.length, value.length), start = back(value, end, excess);
160
+ value = value.slice(0, start) + value.slice(end);
161
+ if (points(value) > maximum)
162
+ value = head(value, maximum);
163
+ node.value = value;
164
+ const caret = Math.min(start, value.length);
165
+ node.setSelectionRange(caret, caret);
166
+ }
167
+ function changed(current) {
168
+ limit(current);
169
+ const value = current.node.value, key = (current.composing ? '1' : '0') + value;
170
+ if (key === current.reported)
171
+ return;
172
+ current.reported = key;
173
+ const notify = current.request.onChange;
174
+ if (notify)
175
+ guard(() => notify({ value, composing: current.composing }));
176
+ }
177
+ function focusCanvas() {
178
+ const active = doc.activeElement;
179
+ if ((active === null || active === doc.body) && canvas.isConnected && canvas.hasAttribute('tabindex'))
180
+ canvas.focus({ preventScroll: true });
181
+ }
182
+ function end(kind, key) {
183
+ const current = session;
184
+ if (!current)
185
+ return;
186
+ session = undefined;
187
+ if (kind === 'commit') {
188
+ current.composing = false;
189
+ guard(() => limit(current));
190
+ }
191
+ const value = current.node.value, focused = doc.activeElement === current.node;
192
+ for (const remove of current.removals.splice(0).reverse())
193
+ guard(remove);
194
+ guard(() => current.wrapper.remove());
195
+ if (focused) {
196
+ if (key === undefined)
197
+ guard(focusCanvas);
198
+ else {
199
+ // The key that ended the session is still down. Its repeats and its release are not a key of the
200
+ // game: they stop here, and the canvas takes focus only when the key is released.
201
+ const held = (event) => {
202
+ if (event.key !== key)
203
+ return;
204
+ if (isolate)
205
+ event.stopPropagation();
206
+ if (event.type === 'keydown')
207
+ event.preventDefault();
208
+ else {
209
+ releaseFocus();
210
+ guard(focusCanvas);
211
+ }
212
+ };
213
+ const lost = () => releaseFocus();
214
+ win.addEventListener('keydown', held, true);
215
+ win.addEventListener('keyup', held, true);
216
+ win.addEventListener('blur', lost);
217
+ releaseFocus = () => {
218
+ releaseFocus = () => { };
219
+ win.removeEventListener('keydown', held, true);
220
+ win.removeEventListener('keyup', held, true);
221
+ win.removeEventListener('blur', lost);
222
+ };
223
+ }
224
+ }
225
+ const request = current.request;
226
+ if (kind === 'commit') {
227
+ if (request.onCommit)
228
+ guard(() => request.onCommit(value));
229
+ }
230
+ else if (request.onCancel)
231
+ guard(() => request.onCancel());
232
+ }
233
+ function listen(current, target, type, action, capture = false) {
234
+ const listener = (event) => {
235
+ if (session === current)
236
+ guard(() => action(event));
237
+ };
238
+ target.addEventListener(type, listener, capture);
239
+ current.removals.push(() => target.removeEventListener(type, listener, capture));
240
+ }
241
+ function alive() {
242
+ if (disposed)
243
+ throw fault('DISPOSED');
244
+ }
245
+ return {
246
+ open(request) {
247
+ alive();
248
+ if (!request || typeof request !== 'object')
249
+ throw fault('REQUEST');
250
+ const place = rectangle(request, 'REQUEST'), multiline = request.multiline ?? false, password = request.password ?? false, blur = request.blur ?? 'commit';
251
+ if (typeof multiline !== 'boolean' ||
252
+ typeof password !== 'boolean' ||
253
+ (multiline && password) ||
254
+ (blur !== 'commit' && blur !== 'cancel'))
255
+ throw fault('REQUEST');
256
+ const maxLength = request.maxLength;
257
+ if (maxLength !== undefined && (!Number.isInteger(maxLength) || maxLength < 1 || maxLength > TEXT_LIMIT))
258
+ throw fault('REQUEST');
259
+ let value = text(request.value ?? '', TEXT_LIMIT, 'REQUEST');
260
+ if (maxLength !== undefined)
261
+ value = head(value, maxLength);
262
+ const placeholder = text(request.placeholder ?? '', 1024, 'REQUEST'), label = text(request.label ?? '', 256, 'REQUEST'), locale = text(request.locale ?? '', 64, 'REQUEST');
263
+ const fontFamily = text(request.fontFamily ?? 'sans-serif', 1024, 'REQUEST'), fontSize = scalar(request.fontSize ?? 16, 1, 4096, 'REQUEST'), padding = scalar(request.padding ?? 0, 0, 4096, 'REQUEST');
264
+ const lineHeight = request.lineHeight === undefined ? undefined : scalar(request.lineHeight, 1, 16384, 'REQUEST');
265
+ const weight = request.fontWeight ?? 'normal', align = request.textAlign ?? 'left', select = request.select ?? 'end';
266
+ if (weight !== 'normal' &&
267
+ weight !== 'bold' &&
268
+ !(typeof weight === 'number' && Number.isInteger(weight) && weight >= 1 && weight <= 1000))
269
+ throw fault('REQUEST');
270
+ if (!['left', 'center', 'right'].includes(align) || (select !== 'all' && select !== 'end'))
271
+ throw fault('REQUEST');
272
+ if ((request.inputMode !== undefined && !MODES.includes(request.inputMode)) ||
273
+ (request.enterKeyHint !== undefined && !HINTS.includes(request.enterKeyHint)))
274
+ throw fault('REQUEST');
275
+ const ink = colour(request.color ?? 0, 'REQUEST'), paper = request.backgroundColor === undefined ? 'transparent' : colour(request.backgroundColor, 'REQUEST');
276
+ const hint = request.placeholderColor === undefined ? undefined : colour(request.placeholderColor, 'REQUEST');
277
+ for (const callback of [request.onChange, request.onCommit, request.onCancel])
278
+ if (callback !== undefined && typeof callback !== 'function')
279
+ throw fault('REQUEST');
280
+ const parent = options.parent ?? canvas.parentElement;
281
+ if (!canvas.isConnected || !parent || !parent.isConnected)
282
+ throw fault('SURFACE');
283
+ end('cancel');
284
+ releaseFocus();
285
+ if (disposed)
286
+ throw fault('DISPOSED');
287
+ if (session)
288
+ throw fault('REENTRANT');
289
+ const wrapper = doc.createElement('div'), node = doc.createElement(multiline ? 'textarea' : 'input');
290
+ Object.assign(wrapper.style, {
291
+ all: 'initial',
292
+ display: 'block',
293
+ position: 'fixed',
294
+ left: '0',
295
+ top: '0',
296
+ width: PROBE + 'px',
297
+ height: PROBE + 'px',
298
+ margin: '0',
299
+ padding: '0',
300
+ border: '0',
301
+ overflow: 'visible',
302
+ pointerEvents: 'none',
303
+ zIndex: String(zIndex)
304
+ });
305
+ Object.assign(node.style, {
306
+ all: 'initial',
307
+ display: 'block',
308
+ position: 'absolute',
309
+ boxSizing: 'border-box',
310
+ margin: '0',
311
+ border: '0',
312
+ outline: 'none',
313
+ resize: 'none',
314
+ appearance: 'none',
315
+ minWidth: '0',
316
+ minHeight: '0',
317
+ borderRadius: '0',
318
+ pointerEvents: 'auto',
319
+ transformOrigin: '0 0',
320
+ visibility: 'hidden',
321
+ overflow: multiline ? 'auto' : 'hidden',
322
+ whiteSpace: multiline ? 'pre-wrap' : 'pre',
323
+ overflowWrap: multiline ? 'break-word' : 'normal',
324
+ padding: multiline ? padding + 'px' : '0 ' + padding + 'px',
325
+ fontFamily,
326
+ fontSize: fontSize + 'px',
327
+ fontWeight: String(weight),
328
+ lineHeight: lineHeight === undefined ? 'normal' : lineHeight + 'px',
329
+ color: ink,
330
+ caretColor: ink,
331
+ background: paper,
332
+ textAlign: align,
333
+ userSelect: 'text',
334
+ touchAction: 'manipulation'
335
+ });
336
+ node.style.setProperty('-webkit-user-select', 'text');
337
+ if (hint !== undefined) {
338
+ placeholderSheet();
339
+ node.style.setProperty(PLACEHOLDER, hint);
340
+ }
341
+ if (!multiline)
342
+ node.type = password ? 'password' : 'text';
343
+ node.setAttribute(MARK, '');
344
+ node.setAttribute('autocomplete', 'off');
345
+ node.setAttribute('autocorrect', 'off');
346
+ node.setAttribute('autocapitalize', 'off');
347
+ node.spellcheck = false;
348
+ if (placeholder)
349
+ node.placeholder = placeholder;
350
+ if (label)
351
+ node.setAttribute('aria-label', label);
352
+ if (locale)
353
+ node.lang = locale;
354
+ if (request.inputMode !== undefined)
355
+ node.inputMode = request.inputMode;
356
+ if (request.enterKeyHint !== undefined)
357
+ node.enterKeyHint = request.enterKeyHint;
358
+ node.value = value;
359
+ const current = {
360
+ node,
361
+ wrapper,
362
+ request,
363
+ multiline,
364
+ maxLength,
365
+ blur,
366
+ openedAt: win.performance.now(),
367
+ removals: [],
368
+ place,
369
+ composing: false,
370
+ fresh: true,
371
+ reported: '0' + node.value
372
+ };
373
+ session = current;
374
+ try {
375
+ listen(current, node, 'input', () => changed(current));
376
+ listen(current, node, 'compositionstart', () => {
377
+ current.composing = true;
378
+ });
379
+ listen(current, node, 'compositionend', () => {
380
+ current.composing = false;
381
+ changed(current);
382
+ });
383
+ listen(current, node, 'keydown', event => {
384
+ const key = event;
385
+ if (isolate)
386
+ key.stopPropagation();
387
+ // A key that the input method consumes confirms or rejects a candidate; it is not the player's Enter.
388
+ if (key.isComposing || current.composing || key.keyCode === 229)
389
+ return;
390
+ if (key.key === 'Escape') {
391
+ key.preventDefault();
392
+ end('cancel', 'Escape');
393
+ }
394
+ else if (key.key === 'Enter' && (!current.multiline || key.ctrlKey || key.metaKey)) {
395
+ key.preventDefault();
396
+ end('commit', 'Enter');
397
+ }
398
+ });
399
+ if (isolate)
400
+ for (const type of ['keyup', 'keypress'])
401
+ listen(current, node, type, event => event.stopPropagation());
402
+ // An on-screen keyboard may deliver its Enter as a line break to insert, with no usable key event.
403
+ if (!multiline)
404
+ listen(current, node, 'beforeinput', event => {
405
+ if (event.inputType === 'insertLineBreak' && !current.composing) {
406
+ event.preventDefault();
407
+ end('commit', 'Enter');
408
+ }
409
+ });
410
+ listen(current, node, 'blur', () => {
411
+ // A window that loses focus keeps the field as its active element, and gives focus back to it.
412
+ if (doc.activeElement !== node)
413
+ end(current.blur);
414
+ });
415
+ listen(current, doc, 'pointerdown', event => {
416
+ if (event.timeStamp <= current.openedAt)
417
+ return;
418
+ current.fresh = false;
419
+ // Not every platform takes focus from a field when the player touches something else.
420
+ if (event.target !== node)
421
+ end(current.blur);
422
+ }, true);
423
+ listen(current, doc, 'mousedown', event => {
424
+ // The press that opened the session would now move focus to what was pressed, and close it again.
425
+ if (current.fresh && event.target !== node)
426
+ event.preventDefault();
427
+ }, true);
428
+ listen(current, win, 'resize', layout);
429
+ listen(current, doc, 'scroll', layout, true);
430
+ const viewport = win.visualViewport;
431
+ if (viewport) {
432
+ listen(current, viewport, 'resize', layout);
433
+ listen(current, viewport, 'scroll', layout);
434
+ }
435
+ if (typeof globalThis.ResizeObserver === 'function') {
436
+ const observer = new globalThis.ResizeObserver(() => {
437
+ if (session === current)
438
+ guard(layout);
439
+ });
440
+ observer.observe(canvas);
441
+ current.removals.push(() => observer.disconnect());
442
+ }
443
+ wrapper.appendChild(node);
444
+ parent.appendChild(wrapper);
445
+ layout();
446
+ // The page may scroll to show the field: on a phone that keeps it clear of the on-screen keyboard.
447
+ node.focus();
448
+ if (session === current) {
449
+ const length = node.value.length;
450
+ node.setSelectionRange(select === 'all' ? 0 : length, length);
451
+ }
452
+ }
453
+ catch (cause) {
454
+ if (session === current) {
455
+ session = undefined;
456
+ for (const remove of current.removals.splice(0).reverse())
457
+ guard(remove);
458
+ guard(() => wrapper.remove());
459
+ }
460
+ throw cause;
461
+ }
462
+ },
463
+ commit() {
464
+ alive();
465
+ end('commit');
466
+ },
467
+ cancel() {
468
+ alive();
469
+ end('cancel');
470
+ },
471
+ setValue(value) {
472
+ alive();
473
+ const current = session;
474
+ if (!current)
475
+ throw fault('IDLE');
476
+ let next = text(value, TEXT_LIMIT, 'VALUE');
477
+ if (current.maxLength !== undefined)
478
+ next = head(next, current.maxLength);
479
+ current.node.value = next;
480
+ current.composing = false;
481
+ current.reported = '0' + current.node.value;
482
+ },
483
+ move(place) {
484
+ alive();
485
+ const current = session;
486
+ if (!current)
487
+ throw fault('IDLE');
488
+ current.place = rectangle(place, 'RECTANGLE');
489
+ layout();
490
+ },
491
+ resize(width, height) {
492
+ alive();
493
+ const nextWidth = scalar(width, 0.25, 16384, 'SIZE'), nextHeight = scalar(height, 0.25, 16384, 'SIZE');
494
+ logicalWidth = nextWidth;
495
+ logicalHeight = nextHeight;
496
+ layout();
497
+ },
498
+ sync() {
499
+ alive();
500
+ layout();
501
+ },
502
+ getSnapshot() {
503
+ if (disposed)
504
+ return { state: 'disposed', value: '', composing: false };
505
+ return session
506
+ ? { state: 'open', value: session.node.value, composing: session.composing }
507
+ : { state: 'idle', value: '', composing: false };
508
+ },
509
+ dispose() {
510
+ if (disposed)
511
+ return;
512
+ end('cancel');
513
+ disposed = true;
514
+ releaseFocus();
515
+ const owned = sheet;
516
+ sheet = undefined;
517
+ if (owned)
518
+ guard(() => {
519
+ doc.adoptedStyleSheets = doc.adoptedStyleSheets.filter(item => item !== owned);
520
+ });
521
+ }
522
+ };
523
+ }
524
+ //# sourceMappingURL=BrowserTextInput.js.map
@@ -0,0 +1,58 @@
1
+ import { Texture } from '@egret/runtime';
2
+ import type { AssetProvider, AssetRef, AssetLoadContext } from '@egret/runtime';
3
+ import type { ManifestPngOwner } from './ManifestByteSource.js';
4
+ /** How the browser decodes a PNG: its orientation, alpha and color space conversion. */
5
+ export interface BrowserPngDecodeOptions {
6
+ readonly imageOrientation: 'from-image';
7
+ readonly premultiplyAlpha: 'none';
8
+ readonly colorSpaceConversion: 'none';
9
+ }
10
+ /** How the browser decodes a PNG and makes a canvas, for PNG textures. */
11
+ export interface BrowserPngPorts {
12
+ readonly decode: (blob: Blob, options: BrowserPngDecodeOptions) => Promise<ImageBitmap>;
13
+ readonly createCanvas: () => HTMLCanvasElement;
14
+ }
15
+ /** A PNG texture provider to make: where it reads bytes from, and the ports it decodes with. */
16
+ export interface BrowserTextureProviderOptions {
17
+ readonly readBytes: (ref: AssetRef<Texture>, context: AssetLoadContext) => Promise<Uint8Array<ArrayBuffer>>;
18
+ readonly ports?: BrowserPngPorts;
19
+ }
20
+ /** Loads PNG textures in the browser; close it when done. */
21
+ export interface BrowserTextureProvider extends AssetProvider<Texture> {
22
+ readonly profile: 'png-rgb-rgba8-browser-normalized-v1';
23
+ readonly isClosed: boolean;
24
+ close(): Promise<void>;
25
+ }
26
+ interface ManifestTextureProviderCounters {
27
+ readonly jobs: number;
28
+ readonly encodedCreditBytes: number;
29
+ readonly ownedEncodedBytes: number;
30
+ readonly blobLogicalBytes: number;
31
+ readonly activeDecodes: number;
32
+ readonly bitmapLogicalBytes: number;
33
+ readonly rasterLogicalBytes: number;
34
+ readonly readbackCpuBytes: number;
35
+ readonly materializedCpuBytes: number;
36
+ readonly quarantinedJobs: number;
37
+ readonly unknownNativeObjects: number;
38
+ }
39
+ /** How many textures a manifest texture provider holds now and at most, and whether it was full. */
40
+ export interface ManifestTextureProviderStatus {
41
+ readonly current: ManifestTextureProviderCounters;
42
+ readonly highWater: ManifestTextureProviderCounters;
43
+ readonly saturated: boolean;
44
+ }
45
+ /** A texture provider for a manifest's images, with its status. */
46
+ export interface ManifestTextureProvider extends BrowserTextureProvider {
47
+ getStatus(): ManifestTextureProviderStatus;
48
+ }
49
+ /** Fixed private assembly options; no public lifecycle callbacks. */
50
+ export interface ManifestPngProviderOptions {
51
+ readonly ports?: BrowserPngPorts;
52
+ }
53
+ /** Caller owns async close; managers own issued Textures and their final demand. */
54
+ export declare function createBrowserTextureProvider(options: BrowserTextureProviderOptions): BrowserTextureProvider;
55
+ /** Called only by the authenticated optional resource entry. */
56
+ export declare function createManifestPngTextureProvider(owner: ManifestPngOwner, options: ManifestPngProviderOptions): ManifestTextureProvider;
57
+ export {};
58
+ //# sourceMappingURL=BrowserTextureProvider.d.ts.map