@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,4 @@
1
+ import type { TextRasterProvider } from '@egret/engine/text';
2
+ /** Caller-owned fonts and explicit cache invalidation; no waiting or font loading. */
3
+ export declare function createCanvasTextRasterProvider(): TextRasterProvider;
4
+ //# sourceMappingURL=CanvasTextRasterProvider.d.ts.map
@@ -0,0 +1,312 @@
1
+ import { createImageData2D } from '@egret/contracts';
2
+ import { EgretError } from '@egret/runtime';
3
+ function cancelled(signal) {
4
+ if (signal.aborted)
5
+ throw new EgretError('WEB_TEXT_CANCELLED', { cause: signal.reason });
6
+ }
7
+ function fontFor(request) {
8
+ // T1 excludes control characters. Quote one literal family, never a CSS list.
9
+ const family = request.fontFamily.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
10
+ return `${request.fontStyle} ${request.fontWeight} ${request.fontSize}px "${family}"`;
11
+ }
12
+ function ready(document, font, request) {
13
+ // Readiness cannot certify a face's identity or glyph coverage. Applications
14
+ // own their fonts and explicitly invalidate every affected cache on change.
15
+ if (!document.fonts.check(font, request.text))
16
+ throw new EgretError('WEB_TEXT_FONT_NOT_READY');
17
+ }
18
+ function setState(context, key, value) {
19
+ if (!(key in context))
20
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
21
+ context[key] = value;
22
+ if (context[key] !== value)
23
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
24
+ }
25
+ function drawingState(context, request, font) {
26
+ // A legal font setter serializes canonically, so string equality with the
27
+ // input is not a support test. A distinct, below-T1-size sentinel detects an
28
+ // ignored assignment without creating another Canvas or parsing CSS ourselves.
29
+ if (!('font' in context))
30
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
31
+ context.font = '0.5px serif';
32
+ const sentinel = context.font;
33
+ context.font = font;
34
+ if (typeof context.font !== 'string' || context.font.length === 0 || context.font === sentinel) {
35
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
36
+ }
37
+ setState(context, 'lang', request.locale);
38
+ setState(context, 'direction', request.direction);
39
+ setState(context, 'textAlign', 'left');
40
+ setState(context, 'textBaseline', 'alphabetic');
41
+ setState(context, 'fontKerning', 'auto');
42
+ setState(context, 'fontStretch', 'normal');
43
+ setState(context, 'fontVariantCaps', 'normal');
44
+ setState(context, 'letterSpacing', '0px');
45
+ setState(context, 'wordSpacing', '0px');
46
+ setState(context, 'textRendering', 'auto');
47
+ setState(context, 'globalAlpha', 1);
48
+ setState(context, 'globalCompositeOperation', 'source-over');
49
+ setState(context, 'filter', 'none');
50
+ setState(context, 'shadowBlur', 0);
51
+ setState(context, 'shadowOffsetX', 0);
52
+ setState(context, 'shadowOffsetY', 0);
53
+ setState(context, 'shadowColor', 'rgba(0, 0, 0, 0)');
54
+ setState(context, 'fillStyle', `#${request.fillColor.toString(16).padStart(6, '0')}`);
55
+ }
56
+ function scalar(value) {
57
+ if (typeof value !== 'number' || !Number.isFinite(value) || Math.abs(value) > 1048576) {
58
+ throw new RangeError('Canvas text metric must be finite and within T1 magnitude');
59
+ }
60
+ return value;
61
+ }
62
+ function lineMetrics(metrics) {
63
+ const advance = scalar(metrics.width);
64
+ const left = -scalar(metrics.actualBoundingBoxLeft);
65
+ const top = -scalar(metrics.actualBoundingBoxAscent);
66
+ const right = scalar(metrics.actualBoundingBoxRight);
67
+ const bottom = scalar(metrics.actualBoundingBoxDescent);
68
+ if (advance < 0 || left > right || top > bottom)
69
+ throw new RangeError('Canvas text metric ordering invalid');
70
+ const hasInk = left < right && top < bottom;
71
+ // Native signed zero belongs to raw evidence. T1 requires four canonical
72
+ // zero extents for inkless lines, even if the native empty edge is nonzero.
73
+ return {
74
+ advance,
75
+ hasInk,
76
+ inkLeft: hasInk ? left : 0,
77
+ inkTop: hasInk ? top : 0,
78
+ inkRight: hasInk ? right : 0,
79
+ inkBottom: hasInk ? bottom : 0
80
+ };
81
+ }
82
+ function surface(document, width, height, work, cleanupFailure, reportSuccessfulCleanupAtRelease = false) {
83
+ let canvas;
84
+ let context;
85
+ let value;
86
+ let failed = false;
87
+ let cause;
88
+ const cleanupErrors = [];
89
+ try {
90
+ canvas = document.createElement('canvas');
91
+ canvas.width = width;
92
+ canvas.height = height;
93
+ if (canvas.width !== width || canvas.height !== height)
94
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
95
+ // The hint must precede the surface's very first context acquisition.
96
+ context =
97
+ canvas.getContext('2d', { alpha: true, colorSpace: 'srgb', willReadFrequently: true }) ??
98
+ undefined;
99
+ if (context === undefined || typeof context.getContextAttributes !== 'function')
100
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
101
+ const attributes = context.getContextAttributes();
102
+ if (attributes.alpha !== true || attributes.colorSpace !== 'srgb')
103
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
104
+ const readbackHint = typeof attributes.willReadFrequently === 'boolean' ? attributes.willReadFrequently : undefined;
105
+ value = work(context, readbackHint);
106
+ }
107
+ catch (error) {
108
+ failed = true;
109
+ cause = error;
110
+ }
111
+ finally {
112
+ // Both resets are attempted even when the first throws. Retire local
113
+ // references regardless; successful logical cleanup is not a GC claim.
114
+ if (canvas !== undefined) {
115
+ try {
116
+ canvas.width = 0;
117
+ if (canvas.width !== 0)
118
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
119
+ }
120
+ catch (error) {
121
+ cleanupErrors.push(error);
122
+ }
123
+ try {
124
+ canvas.height = 0;
125
+ if (canvas.height !== 0)
126
+ throw new EgretError('WEB_TEXT_STATE_UNSUPPORTED');
127
+ }
128
+ catch (error) {
129
+ cleanupErrors.push(error);
130
+ }
131
+ }
132
+ context = undefined;
133
+ canvas = undefined;
134
+ }
135
+ if (cleanupErrors.length !== 0) {
136
+ const failure = cleanupFailure(cleanupErrors, failed, cause);
137
+ // Only a completed raster can return its internal copy to T1. Its
138
+ // quarantined plan then fails release before any public delivery.
139
+ // An operation throw, including undefined, always remains primary.
140
+ if (failed || !reportSuccessfulCleanupAtRelease)
141
+ throw failure;
142
+ }
143
+ if (failed)
144
+ throw cause;
145
+ return value;
146
+ }
147
+ /** Caller-owned fonts and explicit cache invalidation; no waiting or font loading. */
148
+ export function createCanvasTextRasterProvider() {
149
+ let owner;
150
+ try {
151
+ if (typeof window !== 'undefined' &&
152
+ typeof document !== 'undefined' &&
153
+ window.document === document &&
154
+ typeof document.createElement === 'function' &&
155
+ typeof document.fonts?.check === 'function' &&
156
+ typeof HTMLCanvasElement === 'function' &&
157
+ typeof HTMLCanvasElement.prototype.getContext === 'function' &&
158
+ typeof CanvasRenderingContext2D === 'function')
159
+ owner = document;
160
+ }
161
+ catch (cause) {
162
+ throw new EgretError('WEB_TEXT_UNAVAILABLE', { cause });
163
+ }
164
+ if (owner === undefined)
165
+ throw new EgretError('WEB_TEXT_UNAVAILABLE');
166
+ const capturedDocument = owner;
167
+ // One provider can serve several caches. Quarantined slots are never refunded.
168
+ let occupied = 0;
169
+ const plans = new WeakMap();
170
+ const released = new WeakSet();
171
+ const provider = Object.freeze({
172
+ identity: 'egret.canvas-text.wc1',
173
+ profile: 'canvas-explicit-lines-v1',
174
+ async measure(request, context) {
175
+ if (this !== provider)
176
+ throw new EgretError('WEB_TEXT_PROVIDER_INVALID');
177
+ if (occupied >= 4)
178
+ throw new EgretError('WEB_TEXT_PLAN_LIMIT');
179
+ occupied++;
180
+ let issued;
181
+ let quarantined = false;
182
+ try {
183
+ cancelled(context.signal);
184
+ if (request.providerIdentity !== provider.identity ||
185
+ request.profile !== provider.profile ||
186
+ request.fontGeneration !== context.fontGeneration)
187
+ throw new EgretError('WEB_TEXT_PLAN_INVALID');
188
+ const font = fontFor(request);
189
+ ready(capturedDocument, font, request);
190
+ cancelled(context.signal);
191
+ const plan = surface(capturedDocument, 1, 1, (canvas, readbackHint) => {
192
+ drawingState(canvas, request, font);
193
+ canvas.setTransform(1, 0, 0, 1, 0, 0);
194
+ const lines = request.sourceLines.map(line => lineMetrics(canvas.measureText(request.text.slice(line.start, line.end))));
195
+ cancelled(context.signal);
196
+ // Exactly one authentic invocation issuer owns all plan geometry.
197
+ issued = context.createPlan({ baselineOffset: request.fontSize, lines });
198
+ plans.set(issued, {
199
+ used: false,
200
+ busy: true,
201
+ quarantined: false,
202
+ cleanupCause: undefined,
203
+ measureReadbackHint: readbackHint,
204
+ rasterReadbackHint: undefined
205
+ });
206
+ cancelled(context.signal);
207
+ return issued;
208
+ }, (errors, failed, cause) => {
209
+ quarantined = true;
210
+ if (issued === undefined)
211
+ return new EgretError('WEB_TEXT_CLEANUP_FAILED', {
212
+ cause: failed ? cause : errors[0],
213
+ cleanupErrors: errors
214
+ });
215
+ const state = plans.get(issued);
216
+ state.quarantined = true;
217
+ state.cleanupCause = errors[0];
218
+ return failed ? cause : errors[0];
219
+ });
220
+ cancelled(context.signal);
221
+ return plan;
222
+ }
223
+ finally {
224
+ if (issued !== undefined)
225
+ plans.get(issued).busy = false;
226
+ if (issued === undefined && !quarantined)
227
+ occupied--;
228
+ }
229
+ },
230
+ async rasterize(plan, context) {
231
+ if (this !== provider)
232
+ throw new EgretError('WEB_TEXT_PROVIDER_INVALID');
233
+ const state = plans.get(plan);
234
+ if (state === undefined || state.used || state.busy || state.quarantined)
235
+ throw new EgretError('WEB_TEXT_PLAN_INVALID');
236
+ // Consume before reading caller-visible context state: a failed raster
237
+ // attempt is not a retry port, and reentry cannot overlap this plan.
238
+ state.used = true;
239
+ state.busy = true;
240
+ try {
241
+ const request = plan.request;
242
+ const placement = plan.metrics.raster;
243
+ const bytes = placement?.byteLength ?? 0;
244
+ if (context.fontGeneration !== request.fontGeneration ||
245
+ context.reservedImageBytes !== bytes ||
246
+ context.reservedScratchBytes !== 2 * bytes)
247
+ throw new EgretError('WEB_TEXT_PLAN_INVALID');
248
+ cancelled(context.signal);
249
+ const font = fontFor(request);
250
+ ready(capturedDocument, font, request);
251
+ cancelled(context.signal);
252
+ if (placement === undefined)
253
+ return undefined;
254
+ const image = surface(capturedDocument, placement.width, placement.height, (canvas, readbackHint) => {
255
+ state.rasterReadbackHint = readbackHint;
256
+ drawingState(canvas, request, font);
257
+ canvas.setTransform(request.density, 0, 0, request.density, -placement.pixelLeft, -placement.pixelTop);
258
+ for (const line of plan.metrics.lines) {
259
+ canvas.fillText(request.text.slice(line.source.start, line.source.end), 0, line.baselineY);
260
+ }
261
+ cancelled(context.signal);
262
+ const pixels = canvas.getImageData(0, 0, placement.width, placement.height);
263
+ if (pixels.width !== placement.width ||
264
+ pixels.height !== placement.height ||
265
+ !(pixels.data instanceof Uint8ClampedArray) ||
266
+ !(pixels.data.buffer instanceof ArrayBuffer) ||
267
+ pixels.data.byteLength !== bytes ||
268
+ pixels.colorSpace !== 'srgb') {
269
+ throw new TypeError('Canvas text readback must be exact tight sRGB rgba8 bytes');
270
+ }
271
+ cancelled(context.signal);
272
+ // A view allocates no second pixel buffer. The existing public
273
+ // image constructor makes the one owned immutable pixel copy.
274
+ const view = new Uint8Array(pixels.data.buffer, pixels.data.byteOffset, pixels.data.byteLength);
275
+ const result = createImageData2D({ width: placement.width, height: placement.height, pixels: view });
276
+ cancelled(context.signal);
277
+ return result;
278
+ }, (errors, failed, cause) => {
279
+ state.quarantined = true;
280
+ state.cleanupCause = errors[0];
281
+ return failed ? cause : errors[0];
282
+ }, true);
283
+ cancelled(context.signal);
284
+ return image;
285
+ }
286
+ finally {
287
+ state.busy = false;
288
+ }
289
+ },
290
+ release(plan) {
291
+ if (this !== provider)
292
+ throw new EgretError('WEB_TEXT_PROVIDER_INVALID');
293
+ const state = plans.get(plan);
294
+ if (state === undefined) {
295
+ if (released.has(plan))
296
+ return;
297
+ throw new EgretError('WEB_TEXT_PLAN_INVALID');
298
+ }
299
+ if (state.busy)
300
+ throw new EgretError('WEB_TEXT_PLAN_INVALID');
301
+ // Close identity before reporting failure. A release reentry/repeat
302
+ // cannot refund quarantine or expose this plan to another raster.
303
+ plans.delete(plan);
304
+ released.add(plan);
305
+ if (state.quarantined)
306
+ throw state.cleanupCause;
307
+ occupied--;
308
+ }
309
+ });
310
+ return provider;
311
+ }
312
+ //# sourceMappingURL=CanvasTextRasterProvider.js.map
@@ -0,0 +1,151 @@
1
+ import type { AdmittedResourceManifest, ResourceManifestEntry } from '@egret/contracts/resources';
2
+ import type { CancellationSignal } from '@egret/contracts';
3
+ import { CancellationController, EgretError } from '@egret/runtime';
4
+ import type { AssetLoadContext, AssetRef } from '@egret/runtime';
5
+ import type { ManifestBinding } from '#egret-manifest-resources';
6
+ declare const MANIFEST_BYTE_SOURCE: unique symbol;
7
+ /** A manifest byte source to make: its profile, the URL it fetches from, its deadline and retries. */
8
+ export interface ManifestByteSourceOptions {
9
+ /** Explicit SFNT-only admission; the original image/metadata limits stay unchanged. */
10
+ readonly profile?: 'font-sfnt/1';
11
+ readonly baseUrl: string;
12
+ readonly deadlineMs?: number;
13
+ readonly networkRetries?: 0 | 1;
14
+ }
15
+ interface ManifestByteSourceCounters {
16
+ readonly jobs: number;
17
+ readonly queuedNetwork: number;
18
+ readonly queuedDecode: number;
19
+ readonly retryWaiting: number;
20
+ readonly activeNetwork: number;
21
+ readonly activeDecode: number;
22
+ readonly encodedCreditBytes: number;
23
+ readonly ownedEncodedBytes: number;
24
+ readonly borrowedChunkBytes: number;
25
+ readonly quarantinedJobs: number;
26
+ }
27
+ /** How many reads a byte source has now and at most, and whether it was full. */
28
+ export interface ManifestByteSourceStatus {
29
+ readonly current: ManifestByteSourceCounters;
30
+ readonly highWater: ManifestByteSourceCounters;
31
+ readonly saturated: boolean;
32
+ }
33
+ /** Reads a manifest's files over the network and checks their digests. */
34
+ export interface ManifestByteSource {
35
+ readonly profile: 'manifest-sha256-browser-v1';
36
+ readonly isClosed: boolean;
37
+ readonly [MANIFEST_BYTE_SOURCE]: true;
38
+ readBytes<T>(ref: AssetRef<T>, context: AssetLoadContext): Promise<Uint8Array<ArrayBuffer>>;
39
+ getStatus(): ManifestByteSourceStatus;
40
+ close(): Promise<void>;
41
+ }
42
+ type Operation = (...args: never[]) => unknown;
43
+ interface Deferred<T> {
44
+ readonly promise: Promise<T>;
45
+ readonly resolve: (value: T) => void;
46
+ readonly reject: (cause: unknown) => void;
47
+ }
48
+ interface Transport {
49
+ cancel: Operation | undefined;
50
+ receiver: object | undefined;
51
+ cancellation: Promise<unknown> | undefined;
52
+ release: Operation | undefined;
53
+ released: boolean;
54
+ }
55
+ /** Private concrete token. Only its owning source can create/admit it. */
56
+ export declare class ManifestPngJob {
57
+ readonly owner: ManifestPngOwner;
58
+ readonly entry: ResourceManifestEntry;
59
+ readonly url: string;
60
+ readonly end: number;
61
+ readonly context: AssetLoadContext;
62
+ readonly publication: Deferred<unknown>;
63
+ readonly cleanup: unknown[];
64
+ readonly aborter: AbortController;
65
+ readonly nativeSignal: AbortSignal;
66
+ readonly combined: CancellationController;
67
+ readonly abortCombined: Operation;
68
+ terminal: EgretError | undefined;
69
+ actual: Promise<Uint8Array<ArrayBuffer>> | undefined;
70
+ timer: unknown;
71
+ signal: CancellationSignal;
72
+ remove: Operation;
73
+ listener: () => void;
74
+ installing: boolean;
75
+ listening: boolean;
76
+ finished: boolean;
77
+ reserved: number;
78
+ network: boolean;
79
+ networkUnsafe: boolean;
80
+ decode: boolean;
81
+ queuedNetwork: Deferred<void> | undefined;
82
+ queuedDecode: Deferred<void> | undefined;
83
+ waitingRetry: boolean;
84
+ transport: Transport | undefined;
85
+ bytes: Uint8Array<ArrayBuffer> | undefined;
86
+ borrowedChunkBytes: number;
87
+ delay: {
88
+ handle: unknown;
89
+ finish: () => void;
90
+ } | undefined;
91
+ constructor(owner: ManifestPngOwner, entry: ResourceManifestEntry, url: string, signal: CancellationSignal, remove: Operation, end: number, generation: number, taskId: number);
92
+ }
93
+ /** Concrete fixed owner; not exported from any public SDK entry. */
94
+ export declare class ManifestPngOwner {
95
+ private readonly native;
96
+ private readonly base;
97
+ private readonly selected;
98
+ private readonly jobs;
99
+ private readonly networkQueue;
100
+ private readonly decodeQueue;
101
+ private networkCount;
102
+ private decodeCount;
103
+ private retryCount;
104
+ private byteCount;
105
+ private admissions;
106
+ private closed;
107
+ private pumping;
108
+ private closeResult;
109
+ private readonly inputLimit;
110
+ private readonly byteLimit;
111
+ private readonly deadlineMs;
112
+ private readonly retries;
113
+ private readonly highWater;
114
+ private saturated;
115
+ constructor(manifest: AdmittedResourceManifest, bindings: readonly ManifestBinding[], options: ManifestByteSourceOptions);
116
+ private contained;
117
+ private now;
118
+ controller(): {
119
+ controller: AbortController;
120
+ signal: AbortSignal;
121
+ };
122
+ get isClosed(): boolean;
123
+ private currentStatus;
124
+ private sampleStatus;
125
+ getStatus(): ManifestByteSourceStatus;
126
+ begin(ref: unknown, context: AssetLoadContext): ManifestPngJob;
127
+ private authentic;
128
+ private checkpoint;
129
+ private detach;
130
+ cancel(job: ManifestPngJob, error: EgretError): void;
131
+ private cancelBody;
132
+ private pump;
133
+ private waitingCount;
134
+ private networkPermit;
135
+ decode(job: ManifestPngJob): Promise<void>;
136
+ decoded(job: ManifestPngJob): void;
137
+ private transport;
138
+ private waitRetry;
139
+ readActual(job: ManifestPngJob): Promise<Uint8Array<ArrayBuffer>>;
140
+ publish(job: ManifestPngJob, value: unknown): boolean;
141
+ reject(job: ManifestPngJob, cause: unknown): void;
142
+ publication<T>(job: ManifestPngJob): Promise<T>;
143
+ finish(job: ManifestPngJob): void;
144
+ private settleClose;
145
+ close(): Promise<void>;
146
+ }
147
+ export declare function requireManifestByteSource(source: unknown): ManifestPngOwner;
148
+ /** Reads a manifest's files from a base URL, checking each one's length and SHA-256. */
149
+ export declare function createManifestByteSource(manifest: AdmittedResourceManifest, bindings: readonly ManifestBinding[], options: ManifestByteSourceOptions): ManifestByteSource;
150
+ export {};
151
+ //# sourceMappingURL=ManifestByteSource.d.ts.map