@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,371 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { DisplayObject, EgretError, Sprite } from '@egret/runtime';
3
+ import { createTextEditState } from '@egret/runtime/ui/editing';
4
+ import { createParagraph } from '../paragraph.js';
5
+ import { requireUiEngine } from '../internal/uiFactoryState.js';
6
+ import { requireUiRoot } from '../internal/uiRootState.js';
7
+ const freeze = Object.freeze, apply = Reflect.apply;
8
+ const fail = (code) => {
9
+ throw new EgretError('UI_TEXT_EDITOR_' + code);
10
+ };
11
+ const parent = Object.getOwnPropertyDescriptor(DisplayObject.prototype, 'parent').get;
12
+ const disposed = Object.getOwnPropertyDescriptor(DisplayObject.prototype, 'isDisposed').get;
13
+ const visible = Object.getOwnPropertyDescriptor(DisplayObject.prototype, 'visible').get;
14
+ const setVisible = Object.getOwnPropertyDescriptor(DisplayObject.prototype, 'visible').set;
15
+ const alpha = Object.getOwnPropertyDescriptor(DisplayObject.prototype, 'alpha').get;
16
+ const effect = Object.getOwnPropertyDescriptor(DisplayObject.prototype, 'renderEffect').get;
17
+ const clip = Object.getOwnPropertyDescriptor(DisplayObject.prototype, 'clipRect').get;
18
+ const toGlobal = DisplayObject.prototype.localToGlobal;
19
+ function number(value, low, high) {
20
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < low || value > high)
21
+ return fail('OPTIONS');
22
+ return value === 0 ? 0 : value;
23
+ }
24
+ function text(value, maximum) {
25
+ if (typeof value !== 'string' || !value.length || value.length > maximum || /[\u0000-\u001f\u007f]/u.test(value))
26
+ return fail('OPTIONS');
27
+ return value;
28
+ }
29
+ function captureStyle(input) {
30
+ if (input === null || typeof input !== 'object' || !Array.isArray(input.fontFamilies))
31
+ return fail('STYLE');
32
+ const fontSet = text(input.fontSet, 256), count = input.fontFamilies.length;
33
+ if (!Number.isInteger(count) || count < 1 || count > 16)
34
+ return fail('STYLE');
35
+ const fontFamilies = [];
36
+ for (let index = 0; index < count; index++)
37
+ fontFamilies.push(text(input.fontFamilies[index], 256));
38
+ const fontSize = number(input.fontSize, 1, 512), locale = text(input.locale, 64), direction = input.direction;
39
+ const lineHeight = input.lineHeight === undefined ? undefined : number(input.lineHeight, 1, 1024);
40
+ const fillColor = number(input.fillColor, 0, 0xffffff), backgroundColor = input.backgroundColor === undefined ? undefined : number(input.backgroundColor, 0, 0xffffff), textAlign = input.textAlign;
41
+ if (!Number.isInteger(fillColor) ||
42
+ (backgroundColor !== undefined && !Number.isInteger(backgroundColor)) ||
43
+ !['ltr', 'rtl'].includes(direction) ||
44
+ (textAlign !== undefined && !['left', 'right', 'center', 'start', 'end'].includes(textAlign)))
45
+ return fail('STYLE');
46
+ return freeze({
47
+ fontSet,
48
+ fontFamilies: freeze(fontFamilies),
49
+ fontSize,
50
+ locale,
51
+ direction,
52
+ fillColor,
53
+ ...(lineHeight === undefined ? {} : { lineHeight }),
54
+ ...(backgroundColor === undefined ? {} : { backgroundColor }),
55
+ ...(textAlign === undefined ? {} : { textAlign })
56
+ });
57
+ }
58
+ const records = new WeakMap();
59
+ /** Browser-only package alias; the public UI entry never exposes native session operations. */
60
+ export function bindTextEditorHost(editor, hooks) {
61
+ const record = records.get(editor);
62
+ if (!record)
63
+ return fail('INVALID');
64
+ return record.bind(hooks);
65
+ }
66
+ /** A text editor drawn by the engine, its text and selection kept by the platform's text input. */
67
+ export function createUiTextEditor(options) {
68
+ if (options === null || typeof options !== 'object')
69
+ return fail('OPTIONS');
70
+ const engine = options.engine, port = requireUiEngine(engine), owner = port.scope(options.scope);
71
+ port.assertIdle();
72
+ owner.assertOpen();
73
+ const state = createTextEditState({
74
+ mode: options.mode,
75
+ ...(options.value === undefined ? {} : { value: options.value }),
76
+ ...(options.selection === undefined ? {} : { selection: options.selection }),
77
+ ...(options.maxLength === undefined ? {} : { maxLength: options.maxLength })
78
+ });
79
+ const cache = options.cache, padding = number(options.padding ?? 8, 0, 256), minimum = number(options.minHeight ?? (options.mode === 'single-line' ? 32 : 96), 1, 4096);
80
+ const lines = options.mode === 'single-line' ? 1 : number(options.visibleLines ?? 6, 1, 128), onChange = options.onChange;
81
+ if (!Number.isInteger(lines) || (onChange !== undefined && typeof onChange !== 'function'))
82
+ return fail('OPTIONS');
83
+ let style = captureStyle(options.style), contentRevision = 1, closed = false, nativeVisible = false, host;
84
+ const views = new Set();
85
+ function live() {
86
+ if (closed)
87
+ fail('CLOSED');
88
+ owner.assertOpen();
89
+ }
90
+ function increment() {
91
+ if (!Number.isSafeInteger(contentRevision + 1))
92
+ fail('REVISION_EXHAUSTED');
93
+ contentRevision++;
94
+ }
95
+ function changed(kind, source) {
96
+ const next = state.snapshot();
97
+ try {
98
+ onChange?.(freeze({ kind, source, revision: next.revision, contentRevision, value: next.value, selection: next.selection }));
99
+ }
100
+ catch (cause) {
101
+ try {
102
+ host?.dispose();
103
+ }
104
+ catch {
105
+ /* Preserve the original callback failure. */
106
+ }
107
+ throw cause;
108
+ }
109
+ host?.changed();
110
+ }
111
+ function mutate(source, operation) {
112
+ live();
113
+ const before = state.snapshot().value, result = operation();
114
+ if (state.snapshot().value !== before) {
115
+ increment();
116
+ changed('value', source);
117
+ }
118
+ else
119
+ host?.changed();
120
+ return result;
121
+ }
122
+ function showNative(value) {
123
+ nativeVisible = value;
124
+ let failure;
125
+ for (const view of views)
126
+ if (!view.aborted() && apply(disposed, view.paragraph, []) !== true) {
127
+ try {
128
+ apply(setVisible, view.paragraph, [!value]);
129
+ }
130
+ catch (cause) {
131
+ failure ??= cause;
132
+ }
133
+ }
134
+ if (failure !== undefined)
135
+ throw failure;
136
+ }
137
+ async function prepare(context) {
138
+ live();
139
+ const bindingOwner = port.scope(context.scope);
140
+ bindingOwner.assertOpen();
141
+ if (views.size >= 8)
142
+ return fail('LIMIT');
143
+ const width = number(context.width - padding * 2, 0.25, 4096), density = number(context.density, 0.25, 4);
144
+ const version = contentRevision, source = state.snapshot().value, capturedStyle = style;
145
+ const paragraph = createParagraph(engine, context.scope, cache), wrapper = new Sprite();
146
+ bindingOwner.use(wrapper);
147
+ paragraph.x = padding;
148
+ paragraph.y = padding;
149
+ wrapper.addChild(paragraph);
150
+ const view = {
151
+ wrapper,
152
+ paragraph,
153
+ status: paragraph.getStatus,
154
+ contentRevision: version,
155
+ style: capturedStyle,
156
+ source,
157
+ innerWidth: width,
158
+ innerHeight: minimum,
159
+ ready: false,
160
+ aborted: () => context.signal.aborted || bindingOwner.signal.aborted
161
+ };
162
+ const retired = () => {
163
+ views.delete(view);
164
+ bindingOwner.remove(retired);
165
+ if (nativeVisible)
166
+ host?.viewRetired();
167
+ };
168
+ views.add(view);
169
+ bindingOwner.add(retired);
170
+ try {
171
+ paragraph.setRequest({ ...capturedStyle, text: source, width, density, maxLines: lines, textGeometry: true });
172
+ const metrics = await paragraph.prepare();
173
+ live();
174
+ bindingOwner.assertOpen();
175
+ if (view.aborted() || version !== contentRevision)
176
+ return fail('STALE');
177
+ view.innerHeight = Math.max(minimum, metrics.height);
178
+ if (view.innerHeight > 16384)
179
+ return fail('LIMIT');
180
+ const height = view.innerHeight + padding * 2;
181
+ if (capturedStyle.backgroundColor !== undefined)
182
+ wrapper.graphics.beginFill(capturedStyle.backgroundColor).drawRect(0, 0, context.width, height).endFill();
183
+ wrapper.hitArea = freeze({ x: 0, y: 0, width: context.width, height });
184
+ apply(setVisible, paragraph, [!nativeVisible]);
185
+ view.ready = true;
186
+ return freeze({ content: wrapper, measuredHeight: height });
187
+ }
188
+ catch (cause) {
189
+ views.delete(view);
190
+ bindingOwner.remove(retired);
191
+ try {
192
+ wrapper.dispose();
193
+ }
194
+ catch {
195
+ /* The preparation failure remains authoritative. */
196
+ }
197
+ throw cause;
198
+ }
199
+ }
200
+ function setStyle(input) {
201
+ live();
202
+ const next = captureStyle(input);
203
+ live();
204
+ if (state.snapshot().state === 'composing')
205
+ return fail('COMPOSING');
206
+ if (JSON.stringify(next) === JSON.stringify(style))
207
+ return;
208
+ increment();
209
+ style = next;
210
+ changed('style', 'programmatic');
211
+ }
212
+ function find(root, target) {
213
+ if (root.state() !== 'open')
214
+ return undefined;
215
+ const current = root.lookup(target);
216
+ if (!current)
217
+ return undefined;
218
+ return [...views].find(view => view.wrapper === current.content && view.ready && !view.aborted());
219
+ }
220
+ function globalBox(node, x, y, width, height) {
221
+ const a = apply(toGlobal, node, [x, y]), b = apply(toGlobal, node, [x + width, y]), c = apply(toGlobal, node, [x, y + height]);
222
+ if (b.y !== a.y || c.x !== a.x || b.x <= a.x || c.y <= a.y)
223
+ return fail('PLACEMENT_UNSUPPORTED');
224
+ return {
225
+ x: a.x,
226
+ y: a.y,
227
+ width: b.x - a.x,
228
+ height: c.y - a.y,
229
+ scaleX: (b.x - a.x) / width,
230
+ scaleY: (c.y - a.y) / height
231
+ };
232
+ }
233
+ function presentation(root, target) {
234
+ const view = find(root, target);
235
+ if (!view || root.lookup(target)?.visible !== true)
236
+ return undefined;
237
+ const box = globalBox(view.paragraph, 0, 0, view.innerWidth, view.innerHeight);
238
+ let left = box.x, top = box.y, right = left + box.width, bottom = top + box.height, node = view.wrapper, foundRoot = false, depth = 0;
239
+ while (node !== undefined) {
240
+ if (++depth > 4096 ||
241
+ apply(visible, node, []) !== true ||
242
+ apply(alpha, node, []) !== 1 ||
243
+ apply(effect, node, []) !== undefined)
244
+ return fail('PLACEMENT_UNSUPPORTED');
245
+ if (node === root.wrapper)
246
+ foundRoot = true;
247
+ const rectangle = apply(clip, node, []);
248
+ if (rectangle !== undefined) {
249
+ if (rectangle.width === 0 || rectangle.height === 0) {
250
+ right = left;
251
+ bottom = top;
252
+ }
253
+ else {
254
+ const bound = globalBox(node, rectangle.x, rectangle.y, rectangle.width, rectangle.height);
255
+ left = Math.max(left, bound.x);
256
+ top = Math.max(top, bound.y);
257
+ right = Math.min(right, bound.x + bound.width);
258
+ bottom = Math.min(bottom, bound.y + bound.height);
259
+ }
260
+ }
261
+ node = apply(parent, node, []);
262
+ }
263
+ if (!foundRoot)
264
+ return undefined;
265
+ const status = apply(view.status, view.paragraph, []);
266
+ return freeze({
267
+ contentRevision: view.contentRevision,
268
+ source: view.source,
269
+ style: view.style,
270
+ geometry: status.geometry,
271
+ box: freeze({ x: box.x, y: box.y, width: box.width, height: box.height }),
272
+ clip: freeze({ x: left, y: top, width: Math.max(0, right - left), height: Math.max(0, bottom - top) }),
273
+ scaleX: box.scaleX,
274
+ scaleY: box.scaleY,
275
+ localWidth: view.innerWidth,
276
+ localHeight: view.innerHeight,
277
+ rowVisible: root.lookup(target)?.visible === true
278
+ });
279
+ }
280
+ const content = freeze({
281
+ get revision() {
282
+ return contentRevision;
283
+ },
284
+ prepare
285
+ });
286
+ const editor = freeze({
287
+ mode: state.mode,
288
+ maxLength: state.maxLength,
289
+ content,
290
+ prepare,
291
+ snapshot() {
292
+ const { session: ignored, ...snapshot } = state.snapshot();
293
+ return freeze({ ...snapshot, contentRevision, style, nativeVisible, livePresentations: views.size });
294
+ },
295
+ setValue(value, settings) {
296
+ mutate('programmatic', () => state.setValue(value, settings?.selection, settings?.expectedRevision, settings?.cancelComposition));
297
+ },
298
+ setSelection(value, expectedRevision) {
299
+ mutate('programmatic', () => state.setSelection(value, expectedRevision));
300
+ },
301
+ setStyle,
302
+ getTextGeometry(root, target) {
303
+ live();
304
+ const view = find(requireUiRoot(root, engine), target);
305
+ return view === undefined ? undefined : apply(view.status, view.paragraph, []).geometry;
306
+ },
307
+ dispose() {
308
+ if (closed)
309
+ return;
310
+ closed = true;
311
+ owner.remove(abort);
312
+ state.dispose();
313
+ const attached = host;
314
+ host = undefined;
315
+ try {
316
+ attached?.dispose();
317
+ }
318
+ finally {
319
+ views.clear();
320
+ nativeVisible = false;
321
+ }
322
+ }
323
+ });
324
+ function abort() {
325
+ editor.dispose();
326
+ }
327
+ records.set(editor, {
328
+ bind(hooks) {
329
+ live();
330
+ if (host !== undefined)
331
+ return fail('HOST_IN_USE');
332
+ host = hooks;
333
+ const identity = hooks;
334
+ let released = false;
335
+ return freeze({
336
+ engine,
337
+ mode: state.mode,
338
+ maxLength: state.maxLength,
339
+ snapshot: () => state.snapshot(),
340
+ contentRevision: () => contentRevision,
341
+ style: () => style,
342
+ begin: () => {
343
+ live();
344
+ return state.begin();
345
+ },
346
+ observe: (token, revision, sample) => mutate('native', () => state.observe(token, revision, sample)),
347
+ compositionStart: (token, revision) => state.beginComposition(token, revision),
348
+ compositionUpdate: (token, revision, sample) => state.updateComposition(token, revision, sample),
349
+ compositionEnd: (token, revision, sample) => mutate('native', () => state.endComposition(token, revision, sample)),
350
+ end: (token, revision, how, sample) => closed ? 'stale' : mutate('native', () => state.end(token, revision, how, sample)),
351
+ root: (root) => requireUiRoot(root, engine),
352
+ presentation,
353
+ showNative,
354
+ setStyle,
355
+ release() {
356
+ if (released)
357
+ return;
358
+ released = true;
359
+ if (host === identity)
360
+ host = undefined;
361
+ }
362
+ });
363
+ }
364
+ });
365
+ owner.assertOpen();
366
+ owner.use({ dispose: () => editor.dispose() });
367
+ owner.add(abort);
368
+ return editor;
369
+ }
370
+ export { requireUiEngine as requireEditorEngine } from '../internal/uiFactoryState.js';
371
+ //# sourceMappingURL=textEditor.js.map
@@ -0,0 +1,85 @@
1
+ import type { Scope } from '@egret/runtime';
2
+ import type { TextEditSelection, TextEditSnapshot } from '@egret/runtime/ui/editing';
3
+ import type { ParagraphCache, ParagraphTextGeometry } from '@egret/runtime/paragraph';
4
+ import type { Engine } from '../Engine.js';
5
+ import type { UiLeafContent, UiLeafPrepareContext, RowBinding, UiRoot } from './types.js';
6
+ /** How a text editor's text looks: its fonts and size, line height, locale and direction, colors and alignment. */
7
+ export interface UiTextEditorStyle {
8
+ readonly fontSet: string;
9
+ readonly fontFamilies: readonly string[];
10
+ readonly fontSize: number;
11
+ readonly lineHeight?: number;
12
+ readonly locale: string;
13
+ readonly direction: 'ltr' | 'rtl';
14
+ readonly fillColor: number;
15
+ readonly backgroundColor?: number;
16
+ readonly textAlign?: 'left' | 'right' | 'center' | 'start' | 'end';
17
+ }
18
+ /** A change to a text editor's content or selection, and what made it. */
19
+ export interface UiTextEditorChange {
20
+ readonly kind: 'value' | 'style';
21
+ readonly source: 'native' | 'programmatic';
22
+ readonly revision: number;
23
+ readonly contentRevision: number;
24
+ readonly value: string;
25
+ readonly selection: Required<TextEditSelection>;
26
+ }
27
+ /** A text editor to make: its engine, scope and cache, its mode, value and limits, its style and size, and what it calls. */
28
+ export interface UiTextEditorOptions {
29
+ readonly engine: Engine;
30
+ readonly scope: Scope;
31
+ readonly cache: ParagraphCache;
32
+ readonly mode: 'single-line' | 'multiline';
33
+ readonly value?: string;
34
+ readonly selection?: TextEditSelection;
35
+ readonly maxLength?: number;
36
+ readonly style: UiTextEditorStyle;
37
+ readonly padding?: number;
38
+ /** Minimum inner content height, independent from natural paragraph metrics. */
39
+ readonly minHeight?: number;
40
+ /** Readonly display limit; the native control still edits the complete source. */
41
+ readonly visibleLines?: number;
42
+ /** Stage a new existing UI tree/source revision; never run another frame loop. */
43
+ readonly onChange?: (change: UiTextEditorChange) => void;
44
+ }
45
+ /** What a text editor is drawn in: a leaf of the tree, or a row of a list. */
46
+ export type UiTextEditorTarget = Readonly<{
47
+ kind: 'leaf';
48
+ id: string;
49
+ }> | Readonly<{
50
+ kind: 'row';
51
+ listId: string;
52
+ key: string;
53
+ }>;
54
+ /** A text editor as it is now: its content revision, style, and whether the native editor shows. */
55
+ export interface UiTextEditorSnapshot extends Omit<TextEditSnapshot, 'session'> {
56
+ readonly contentRevision: number;
57
+ readonly style: UiTextEditorStyle;
58
+ readonly nativeVisible: boolean;
59
+ readonly livePresentations: number;
60
+ }
61
+ /** How a value is set: the selection after it, the revision it expects, and whether a composition is cancelled. */
62
+ export interface UiTextEditorSetOptions {
63
+ readonly selection?: TextEditSelection;
64
+ readonly expectedRevision?: number;
65
+ readonly cancelComposition?: boolean;
66
+ }
67
+ declare const editorBrand: unique symbol;
68
+ /** A text editor: its content, the calls that set its value, selection and style, and the geometry of its text. */
69
+ export interface UiTextEditor {
70
+ readonly [editorBrand]: true;
71
+ readonly mode: UiTextEditorOptions['mode'];
72
+ readonly maxLength: number;
73
+ readonly content: UiLeafContent;
74
+ /** A virtual source may use the same preparation through its RowBindContext. */
75
+ prepare(context: UiLeafPrepareContext): Promise<RowBinding>;
76
+ snapshot(): UiTextEditorSnapshot;
77
+ setValue(value: string, options?: UiTextEditorSetOptions): void;
78
+ setSelection(selection: TextEditSelection, expectedRevision?: number): void;
79
+ setStyle(style: UiTextEditorStyle): void;
80
+ /** This is the actual committed readonly source geometry, possibly preceding pending text. */
81
+ getTextGeometry(root: UiRoot, target: UiTextEditorTarget): ParagraphTextGeometry | undefined;
82
+ dispose(): void;
83
+ }
84
+ export type { TextEditSelection } from '@egret/runtime/ui/editing';
85
+ //# sourceMappingURL=textEditorTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=textEditorTypes.js.map
@@ -0,0 +1,100 @@
1
+ import type { DisplayObject } from '@egret/runtime';
2
+ import type { PointerInput } from '../pointerInputTypes.js';
3
+ /**
4
+ * The state of a text field an application draws itself: its text, and whether it is being edited.
5
+ *
6
+ * The control types nothing. A completed press, a key or a request of assistive technology begins
7
+ * an edit, and the control asks an editor to show a field over the place the application names.
8
+ * The platform text input of the browser is such an editor, so an input method, an on-screen
9
+ * keyboard and paste are the platform's own. When the editor commits, the control has the text.
10
+ */
11
+ export interface TextFieldRectangle {
12
+ readonly x: number;
13
+ readonly y: number;
14
+ readonly width: number;
15
+ readonly height: number;
16
+ }
17
+ /** A text field's value after a change, and whether a composition is under way. */
18
+ export interface TextFieldChange {
19
+ readonly value: string;
20
+ /** True while an input method still holds provisional text. */
21
+ readonly composing: boolean;
22
+ }
23
+ /** What the control adds to the presentation of a field when it opens one. */
24
+ export interface TextFieldSession {
25
+ readonly value: string;
26
+ readonly multiline: boolean;
27
+ readonly password: boolean;
28
+ readonly maxLength?: number;
29
+ readonly placeholder?: string;
30
+ readonly label?: string;
31
+ readonly onChange: (change: TextFieldChange) => void;
32
+ readonly onCommit: (value: string) => void;
33
+ readonly onCancel: () => void;
34
+ }
35
+ /**
36
+ * Shows one field at a time. Opening a field while another is open cancels that one first, and
37
+ * every session ends with exactly one `onCommit` or `onCancel`.
38
+ */
39
+ export interface TextFieldEditor<Request> {
40
+ open(request: Request): void;
41
+ commit(): void;
42
+ cancel(): void;
43
+ setValue(value: string): void;
44
+ }
45
+ /** A text field to make: its input, target and editor, its value and limits, its labels, and what it calls. */
46
+ export interface TextFieldControlOptions<Presentation extends TextFieldRectangle> {
47
+ readonly input: PointerInput;
48
+ /** The surface of the field. A completed press on it begins an edit. */
49
+ readonly target: DisplayObject;
50
+ readonly editor: TextFieldEditor<Presentation & TextFieldSession>;
51
+ /**
52
+ * Where the field is on the stage and how its text looks, asked each time an edit begins.
53
+ * Whatever else the editor's request has (a font, a colour) is passed through.
54
+ */
55
+ readonly field: () => Presentation;
56
+ /** The text it starts with. Defaults to the empty string. */
57
+ readonly value?: string;
58
+ readonly multiline?: boolean;
59
+ /** Hidden characters. A password is a single line. */
60
+ readonly password?: boolean;
61
+ /** Most characters, counted as code points: one Chinese character or one emoji counts once. */
62
+ readonly maxLength?: number;
63
+ readonly placeholder?: string;
64
+ /** The accessible name the editor gives its field. */
65
+ readonly label?: string;
66
+ /** The text changed: an edit was committed with other text, or `setValue` set other text. */
67
+ readonly onChange?: (value: string, previous: string) => void;
68
+ /** The text in the open field changed. It is not the value until the edit is committed. */
69
+ readonly onInput?: (change: TextFieldChange) => void;
70
+ readonly onEditingChange?: (editing: boolean) => void;
71
+ readonly onPressChange?: (pressed: boolean) => void;
72
+ }
73
+ /** A text field: its value and draft, whether it is being edited, and calls that edit, commit or cancel. */
74
+ export interface TextFieldControl {
75
+ /** The committed text. */
76
+ readonly value: string;
77
+ /** The text of the open field, and the value when none is open. */
78
+ readonly draft: string;
79
+ readonly composing: boolean;
80
+ readonly editing: boolean;
81
+ readonly pressed: boolean;
82
+ readonly enabled: boolean;
83
+ /** Begins an edit, as a completed press does. Returns whether one began. */
84
+ edit(): boolean;
85
+ /** Ends the edit and keeps its text. Nothing happens when no edit is open. */
86
+ commit(): void;
87
+ /** Ends the edit and keeps the text from before it. */
88
+ cancel(): void;
89
+ /** Sets the text without an edit. While a field is open its text is replaced as well. */
90
+ setValue(value: string): void;
91
+ /** Keyboard or scripted equivalents share the pointer activation path. */
92
+ press(): void;
93
+ release(): void;
94
+ /** Disabling cancels an open edit. */
95
+ setEnabled(enabled: boolean): void;
96
+ dispose(): void;
97
+ }
98
+ /** A text field on a target: pressing it opens the platform's editing, and the value is committed or cancelled. */
99
+ export declare function createTextFieldControl<Presentation extends TextFieldRectangle>(options: TextFieldControlOptions<Presentation>): TextFieldControl;
100
+ //# sourceMappingURL=textFieldControl.d.ts.map