@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,391 @@
1
+ // Capture callback-free collection operations before any Host native callback.
2
+ // Claim uses only these operations and preallocated nodes/leases after detaching.
3
+ const NativeMap = Map, NativeSet = Set, NativeWeakMap = WeakMap, NativeWeakSet = WeakSet;
4
+ const mapGet = Function.prototype.call.bind(Map.prototype.get);
5
+ const mapSet = Function.prototype.call.bind(Map.prototype.set);
6
+ const mapHas = Function.prototype.call.bind(Map.prototype.has);
7
+ const mapDelete = Function.prototype.call.bind(Map.prototype.delete);
8
+ const setAdd = Function.prototype.call.bind(Set.prototype.add);
9
+ const setHas = Function.prototype.call.bind(Set.prototype.has);
10
+ const weakGet = Function.prototype.call.bind(WeakMap.prototype.get);
11
+ const weakSet = Function.prototype.call.bind(WeakMap.prototype.set);
12
+ const weakHas = Function.prototype.call.bind(WeakSet.prototype.has);
13
+ const weakAdd = Function.prototype.call.bind(WeakSet.prototype.add);
14
+ const MAX_IDLE_BYTES = 33554432;
15
+ const MAX_IDLE_ENTRIES = 4096;
16
+ // A captured resource may acquire exactly one allocation identity, even when two
17
+ // Hosts borrow one device. Native object identity alone is not an allocation ID.
18
+ const registeredResources = new NativeWeakSet();
19
+ /** Native proofs belong to the Host; confirmed outcomes alone change these charges. */
20
+ export function createRetentionLedger(session, diagnostics) {
21
+ const indexes = new NativeMap();
22
+ const nodes = new NativeWeakMap();
23
+ const leaseNodes = new NativeWeakMap();
24
+ const claims = new NativeWeakMap();
25
+ const returns = new NativeWeakMap();
26
+ const idle = { bytes: 0, count: 0, bytesKey: 'idleBytes', countKey: 'idleEntries' }, leased = { bytes: 0, count: 0, bytesKey: 'leasedBytes', countKey: 'leasedEntries' };
27
+ const reserved = { bytes: 0, count: 0, bytesKey: 'reservedBytes', countKey: 'reservedEntries' }, detached = { bytes: 0, count: 0, bytesKey: 'detachedBytes', countKey: 'detachedEntries' };
28
+ const unknown = { bytes: 0, count: 0, bytesKey: 'unknownBytes', countKey: 'unknownEntries' };
29
+ let head, tail;
30
+ let revision = {}, active = true;
31
+ function requireActive() {
32
+ if (!active)
33
+ throw new TypeError('Inactive buffer pool');
34
+ }
35
+ function requireNode(handle) {
36
+ const node = weakGet(nodes, handle);
37
+ if (!node)
38
+ throw new TypeError('Foreign buffer handle');
39
+ return node;
40
+ }
41
+ function admit(input) {
42
+ // Backend wrappers own the fresh plain-data snapshot and its finite
43
+ // descriptor validation. Frozen is a misuse check, not an authority brand.
44
+ const request = input.request, key = input.key;
45
+ if (!Object.isFrozen(request))
46
+ throw new TypeError('Mutable retention request');
47
+ if (!Number.isSafeInteger(request.id) ||
48
+ request.id < 0 ||
49
+ !Number.isSafeInteger(request.byteLength) ||
50
+ request.byteLength <= 0 ||
51
+ request.byteLength % 4 !== 0 ||
52
+ typeof key !== 'string' ||
53
+ key.length === 0) {
54
+ throw new TypeError('Invalid retention request');
55
+ }
56
+ return { request, key };
57
+ }
58
+ function charge(total, node, direction) {
59
+ total.bytes += direction * node.handle.byteLength;
60
+ total.count += direction;
61
+ if (diagnostics) {
62
+ const bytes = diagnostics.current[total.bytesKey] + direction * node.handle.byteLength, count = diagnostics.current[total.countKey] + direction;
63
+ if (bytes > Number.MAX_SAFE_INTEGER || count > Number.MAX_SAFE_INTEGER)
64
+ diagnostics.saturated = true;
65
+ diagnostics.current[total.bytesKey] = Math.min(Number.MAX_SAFE_INTEGER, bytes);
66
+ diagnostics.current[total.countKey] = Math.min(Number.MAX_SAFE_INTEGER, count);
67
+ diagnostics.highWater[total.bytesKey] = Math.max(diagnostics.highWater[total.bytesKey], diagnostics.current[total.bytesKey]);
68
+ diagnostics.highWater[total.countKey] = Math.max(diagnostics.highWater[total.countKey], diagnostics.current[total.countKey]);
69
+ if (total === unknown && diagnostics.unknownNative) {
70
+ const native = diagnostics.unknownNative, bytes = native.knownLogicalBytes + direction * node.handle.byteLength, objects = native.objects + direction;
71
+ if (bytes > Number.MAX_SAFE_INTEGER || objects > Number.MAX_SAFE_INTEGER)
72
+ native.saturated = true;
73
+ native.knownLogicalBytes = Math.min(Number.MAX_SAFE_INTEGER, bytes);
74
+ native.objects = Math.min(Number.MAX_SAFE_INTEGER, objects);
75
+ native.highKnownLogicalBytes = Math.max(native.highKnownLogicalBytes, native.knownLogicalBytes);
76
+ native.highObjects = Math.max(native.highObjects, native.objects);
77
+ }
78
+ }
79
+ }
80
+ function leaseFor(request, node) {
81
+ const lease = Object.freeze({
82
+ requestId: request.id,
83
+ handle: node.handle,
84
+ offset: 0,
85
+ size: request.byteLength
86
+ });
87
+ weakSet(leaseNodes, lease, node);
88
+ return lease;
89
+ }
90
+ /** All links already exist before claim; unlinking publishes no new owner. */
91
+ function unlink(node) {
92
+ const bucket = node.bucket;
93
+ if (node.keyPrevious)
94
+ node.keyPrevious.keyNext = node.keyNext;
95
+ else
96
+ bucket.head = node.keyNext;
97
+ if (node.keyNext)
98
+ node.keyNext.keyPrevious = node.keyPrevious;
99
+ else
100
+ bucket.tail = node.keyPrevious;
101
+ if (node.previous)
102
+ node.previous.next = node.next;
103
+ else
104
+ head = node.next;
105
+ if (node.next)
106
+ node.next.previous = node.previous;
107
+ else
108
+ tail = node.previous;
109
+ if (!bucket.head)
110
+ mapDelete(bucket.sizes, bucket.key);
111
+ node.bucket = undefined;
112
+ node.keyPrevious = undefined;
113
+ node.keyNext = undefined;
114
+ node.previous = undefined;
115
+ node.next = undefined;
116
+ charge(idle, node, -1);
117
+ }
118
+ function append(node) {
119
+ const sizes = indexes, key = node.key;
120
+ let bucket = mapGet(sizes, key);
121
+ if (!bucket) {
122
+ bucket = { key, sizes, head: undefined, tail: undefined };
123
+ // A failing metadata allocation leaves this node reservation-owned.
124
+ mapSet(sizes, key, bucket);
125
+ }
126
+ node.bucket = bucket;
127
+ node.keyPrevious = bucket.tail;
128
+ node.keyNext = undefined;
129
+ if (bucket.tail)
130
+ bucket.tail.keyNext = node;
131
+ else
132
+ bucket.head = node;
133
+ bucket.tail = node;
134
+ node.previous = tail;
135
+ node.next = undefined;
136
+ if (tail)
137
+ tail.next = node;
138
+ else
139
+ head = node;
140
+ tail = node;
141
+ charge(reserved, node, -1);
142
+ charge(leased, node, -1);
143
+ charge(idle, node, 1);
144
+ node.state = 'idle';
145
+ node.lease = undefined;
146
+ }
147
+ function detachNode(node) {
148
+ if (node.state === 'idle')
149
+ unlink(node);
150
+ else if (node.state === 'reserved') {
151
+ charge(reserved, node, -1);
152
+ charge(leased, node, -1);
153
+ }
154
+ else if (node.state === 'leased')
155
+ charge(leased, node, -1);
156
+ else
157
+ return;
158
+ node.state = 'detached';
159
+ node.lease = undefined;
160
+ charge(detached, node, 1);
161
+ }
162
+ function returnState(plan) {
163
+ const state = weakGet(returns, plan);
164
+ if (!state || state.consumed)
165
+ throw new TypeError('Foreign or consumed buffer return plan');
166
+ return state;
167
+ }
168
+ return {
169
+ assertActive: requireActive,
170
+ plan(requests) {
171
+ requireActive();
172
+ const rows = [], matches = new NativeMap();
173
+ const selected = [], leases = [], victims = [];
174
+ const cursors = new NativeMap(), protectedNodes = new NativeSet();
175
+ let incomingBytes = 0, incomingCount = 0, matchedBytes = 0;
176
+ for (let i = 0; i < requests.length; i++) {
177
+ const { request, key } = admit(requests[i]);
178
+ if (request.id !== i)
179
+ throw new TypeError('Nonsequential buffer request');
180
+ rows.push(request);
181
+ if (request.byteLength <= MAX_IDLE_BYTES) {
182
+ // Saturating sums preserve pressure decisions for arbitrarily
183
+ // many admitted candidates without creating a new refusal.
184
+ incomingBytes = Math.min(MAX_IDLE_BYTES + 1, incomingBytes + request.byteLength);
185
+ incomingCount = Math.min(MAX_IDLE_ENTRIES + 1, incomingCount + 1);
186
+ }
187
+ const bucket = mapGet(indexes, key);
188
+ if (!bucket)
189
+ continue;
190
+ const node = mapHas(cursors, bucket) ? mapGet(cursors, bucket) : bucket.head;
191
+ if (!node)
192
+ continue;
193
+ mapSet(cursors, bucket, node.keyNext);
194
+ setAdd(protectedNodes, node);
195
+ selected.push(node);
196
+ mapSet(matches, request.id, node.handle);
197
+ leases.push(leaseFor(request, node));
198
+ matchedBytes += node.handle.byteLength;
199
+ }
200
+ let remainingBytes = idle.bytes - matchedBytes, remainingCount = idle.count - selected.length;
201
+ // Protect every exact hit before selecting one unmatched FIFO prefix.
202
+ for (let node = head; node &&
203
+ (remainingBytes + reserved.bytes + incomingBytes > MAX_IDLE_BYTES ||
204
+ remainingCount + reserved.count + incomingCount > MAX_IDLE_ENTRIES); node = node.next) {
205
+ if (setHas(protectedNodes, node))
206
+ continue;
207
+ victims.push(node);
208
+ remainingBytes -= node.handle.byteLength;
209
+ remainingCount--;
210
+ }
211
+ const publicLeases = Object.freeze(leases), publicVictims = Object.freeze(victims.map(node => node.handle));
212
+ const plan = Object.freeze({
213
+ session,
214
+ revision,
215
+ requests: Object.freeze(rows),
216
+ matches,
217
+ leases: publicLeases,
218
+ victims: publicVictims
219
+ });
220
+ weakSet(claims, plan, {
221
+ revision,
222
+ nextRevision: {},
223
+ matches: selected,
224
+ victims,
225
+ leases: publicLeases,
226
+ consumed: false
227
+ });
228
+ return plan;
229
+ },
230
+ claim(plan) {
231
+ requireActive();
232
+ const state = weakGet(claims, plan);
233
+ if (!state || state.consumed || state.revision !== revision)
234
+ throw new TypeError('Foreign, stale or consumed buffer plan');
235
+ // Host has already attached these exact leases and every victim to
236
+ // persistent cleanup owners. No allocation follows the first unlink.
237
+ state.consumed = true;
238
+ revision = state.nextRevision;
239
+ for (let i = 0; i < state.matches.length; i++) {
240
+ const node = state.matches[i];
241
+ unlink(node);
242
+ node.state = 'leased';
243
+ node.lease = state.leases[i];
244
+ charge(leased, node, 1);
245
+ }
246
+ for (let i = 0; i < state.victims.length; i++)
247
+ detachNode(state.victims[i]);
248
+ return state.leases;
249
+ },
250
+ registerCreated(input, resource) {
251
+ // Registration follows Host capture even if a native callback has
252
+ // just invalidated reuse; it still records an owned cold allocation.
253
+ const { request, key } = admit(input);
254
+ if (weakHas(registeredResources, resource))
255
+ throw new TypeError('Already registered buffer resource');
256
+ const handle = Object.freeze({ ...request, identity: Object.freeze({}), session, resource });
257
+ const node = {
258
+ handle,
259
+ key,
260
+ state: 'leased',
261
+ lease: undefined,
262
+ bucket: undefined,
263
+ keyPrevious: undefined,
264
+ keyNext: undefined,
265
+ previous: undefined,
266
+ next: undefined
267
+ };
268
+ const lease = leaseFor(request, node), nextRevision = {};
269
+ weakSet(nodes, handle, node);
270
+ weakAdd(registeredResources, resource);
271
+ node.lease = lease;
272
+ charge(leased, node, 1);
273
+ revision = nextRevision;
274
+ return lease;
275
+ },
276
+ reserveReturns(leases) {
277
+ const selected = [], retained = [], transient = [];
278
+ const seen = new NativeSet();
279
+ let bytes = idle.bytes + reserved.bytes, count = idle.count + reserved.count;
280
+ for (let i = 0; i < leases.length; i++) {
281
+ const lease = leases[i], node = weakGet(leaseNodes, lease);
282
+ if (!node || node.state !== 'leased' || node.lease !== lease || setHas(seen, node)) {
283
+ throw new TypeError('Foreign, duplicate or inactive buffer lease');
284
+ }
285
+ setAdd(seen, node);
286
+ if (active && bytes + node.handle.byteLength <= MAX_IDLE_BYTES && count < MAX_IDLE_ENTRIES) {
287
+ selected.push(node);
288
+ retained.push(node.handle);
289
+ bytes += node.handle.byteLength;
290
+ count++;
291
+ }
292
+ else
293
+ transient.push(node.handle);
294
+ }
295
+ const plan = Object.freeze({
296
+ identity: Object.freeze({}),
297
+ retained: Object.freeze(retained),
298
+ transient: Object.freeze(transient)
299
+ });
300
+ const nextRevision = {};
301
+ weakSet(returns, plan, { nodes: selected, consumed: false });
302
+ // Reservations bound retention only: the leased allocation charge
303
+ // remains until publication or detach, never counted twice as memory.
304
+ for (let i = 0; i < selected.length; i++) {
305
+ const node = selected[i];
306
+ node.state = 'reserved';
307
+ charge(reserved, node, 1);
308
+ }
309
+ revision = nextRevision;
310
+ return plan;
311
+ },
312
+ publishReturns(plan) {
313
+ requireActive();
314
+ const state = returnState(plan), nextRevision = {};
315
+ for (let i = 0; i < state.nodes.length; i++) {
316
+ if (state.nodes[i].state !== 'reserved')
317
+ throw new TypeError('Detached return reservation');
318
+ }
319
+ // Keep the plan cancellable until every append succeeds. If an
320
+ // allocation throws, cancellation also removes already-idle nodes.
321
+ revision = nextRevision;
322
+ for (let i = 0; i < state.nodes.length; i++)
323
+ append(state.nodes[i]);
324
+ state.consumed = true;
325
+ return plan.retained;
326
+ },
327
+ cancelReturns(plan) {
328
+ const state = returnState(plan), cleanup = [], nextRevision = {};
329
+ for (let i = 0; i < state.nodes.length; i++) {
330
+ const node = state.nodes[i];
331
+ if (node.state === 'reserved' || node.state === 'idle' || node.state === 'detached')
332
+ cleanup.push(node.handle);
333
+ }
334
+ const result = Object.freeze(cleanup);
335
+ state.consumed = true;
336
+ revision = nextRevision;
337
+ for (let i = 0; i < state.nodes.length; i++)
338
+ detachNode(state.nodes[i]);
339
+ return result;
340
+ },
341
+ detach(handle) {
342
+ const node = requireNode(handle), nextRevision = {};
343
+ detachNode(node);
344
+ revision = nextRevision;
345
+ },
346
+ settled(handle, outcome) {
347
+ const node = requireNode(handle);
348
+ if (outcome !== 'destroyed' && outcome !== 'unknown' && outcome !== 'context-invalidated')
349
+ throw new TypeError('Invalid retention settlement');
350
+ if (node.state === 'unknown' || node.state === 'destroyed' || node.state === 'context-invalidated')
351
+ throw new TypeError('Allocation settlement already reported');
352
+ if (outcome === 'context-invalidated' && active)
353
+ throw new TypeError('Active context allocation');
354
+ const nextRevision = {};
355
+ detachNode(node);
356
+ charge(detached, node, -1);
357
+ node.state = outcome;
358
+ if (outcome === 'unknown') {
359
+ charge(unknown, node, 1);
360
+ active = false;
361
+ }
362
+ // Confirmed loss can invalidate a known owner. It never refunds a
363
+ // prior unknown cleanup or turns invalidation into native deletion.
364
+ revision = nextRevision;
365
+ },
366
+ invalidate() {
367
+ active = false;
368
+ },
369
+ detachIdleForClose() {
370
+ const cleanup = [];
371
+ for (let node = head; node; node = node.next)
372
+ cleanup.push(node.handle);
373
+ const result = Object.freeze(cleanup), nextRevision = {};
374
+ while (head)
375
+ detachNode(head);
376
+ revision = nextRevision;
377
+ return result;
378
+ },
379
+ getStatus() {
380
+ return Object.freeze({
381
+ idleBytes: idle.bytes,
382
+ idleEntries: idle.count,
383
+ reservedBytes: reserved.bytes,
384
+ reservedEntries: reserved.count,
385
+ unknownBytes: unknown.bytes,
386
+ unknownEntries: unknown.count
387
+ });
388
+ }
389
+ };
390
+ }
391
+ //# sourceMappingURL=sharedRetentionLedger.js.map
@@ -0,0 +1,56 @@
1
+ import type { PreparedSharedFrame2D } from '../rendering/prepareSharedDraws2D.js';
2
+ import type { SharedPageCopyDiagnostics2D } from '../rendering/sharedColor2D.js';
3
+ import type { ProjectionPlan2D } from './imageProjections2D.js';
4
+ /** Private logical limits; native capabilities remain in each concrete wrapper. */
5
+ export interface SharedStorageLimits2D {
6
+ readonly maxUploadBytes: number;
7
+ readonly maxPendingUploadBytes: number;
8
+ readonly maxPendingFrames: number;
9
+ readonly maxReadbackBytes: number;
10
+ readonly maxPendingGeometryBytes: number;
11
+ /** Absent in a caller that predates the option: the profile's own 64 MiB. */
12
+ readonly maxFramePageBytes?: number;
13
+ }
14
+ export declare class SharedStorageError2D extends Error {
15
+ readonly reason: 'budget' | 'device' | 'backpressure' | 'serial';
16
+ constructor(reason: 'budget' | 'device' | 'backpressure' | 'serial');
17
+ }
18
+ export interface SharedOwnerSnapshot2D {
19
+ readonly pendingFrames: number;
20
+ readonly pendingUploadBytes: number;
21
+ readonly pendingReadbackBytes: number;
22
+ readonly pendingTextureBytes: number;
23
+ readonly pendingGeometryBytes: number;
24
+ readonly pendingColorBytes: number;
25
+ readonly pendingCanonicalBytes: number;
26
+ readonly serial: number;
27
+ }
28
+ export interface SharedStorageFees2D {
29
+ readonly prepared: PreparedSharedFrame2D;
30
+ readonly options: SharedStorageLimits2D;
31
+ readonly upload: number;
32
+ readonly colorBytes: number;
33
+ readonly effectBytes: number;
34
+ }
35
+ /** Concrete amounts authored by the backend after the shared logical fee check. */
36
+ export interface SharedReadbackLayout2D {
37
+ readonly rowPitch: number;
38
+ readonly staging: number;
39
+ readonly output: number;
40
+ }
41
+ export interface SharedStoragePlan2D extends SharedStorageFees2D, SharedReadbackLayout2D {
42
+ }
43
+ export interface SharedSubmissionStorage2D extends SharedStoragePlan2D {
44
+ readonly projectionPlan: ProjectionPlan2D;
45
+ }
46
+ /** Joint logical fees precede readback layout, native limits, pending checks and payloads. */
47
+ export declare function planSharedStorageFees2D(prepared: PreparedSharedFrame2D, options: SharedStorageLimits2D): SharedStorageFees2D;
48
+ /** No allocator or callback is accepted; the caller supplies its already computed layout. */
49
+ export declare function withSharedReadbackLayout2D(fees: SharedStorageFees2D, layout: SharedReadbackLayout2D): SharedStoragePlan2D;
50
+ export declare function checkSharedCapacity2D(storage: SharedStoragePlan2D, owner: SharedOwnerSnapshot2D, canonicalBytes?: number, sourceCopy?: number): void;
51
+ /** Only current READY identities authorize omitted whole-page copies. */
52
+ export declare function materializeSharedPages2D(storage: SharedSubmissionStorage2D, cold: ReadonlySet<number>, owner: SharedOwnerSnapshot2D, diagnostics?: SharedPageCopyDiagnostics2D): {
53
+ projections: (Uint8Array<ArrayBuffer> | undefined)[];
54
+ canonicalBytes: number;
55
+ };
56
+ //# sourceMappingURL=sharedSubmissionStorage2D.d.ts.map
@@ -0,0 +1,73 @@
1
+ import { copySharedPagePixels } from '../rendering/sharedColor2D.js';
2
+ import { noteOwnedPreparationFailure } from '../rendering/ownedPreparationFailure2D.js';
3
+ // Page texture bytes awaiting completion, and conversion memory held at once, are each bounded by
4
+ // two frames' worth of pages, as the number of accepted frames is bounded by two.
5
+ const pendingPageBytes = (framePageBytes) => 2 * Math.min(67108864, framePageBytes ?? 67108864);
6
+ export class SharedStorageError2D extends Error {
7
+ reason;
8
+ constructor(reason) {
9
+ super('Shared storage ' + reason);
10
+ this.reason = reason;
11
+ }
12
+ }
13
+ function fail(reason) {
14
+ throw noteOwnedPreparationFailure(new SharedStorageError2D(reason));
15
+ }
16
+ /** Joint logical fees precede readback layout, native limits, pending checks and payloads. */
17
+ export function planSharedStorageFees2D(prepared, options) {
18
+ const { width, height } = prepared, colorBytes = 4 * width * height, effectBytes = colorBytes * prepared.effects.targetCount, upload = prepared.upload;
19
+ if (!Number.isSafeInteger(colorBytes) ||
20
+ colorBytes + effectBytes > 67108864 ||
21
+ !Number.isSafeInteger(upload) ||
22
+ upload > options.maxUploadBytes)
23
+ fail('budget');
24
+ return { prepared, options, upload, colorBytes, effectBytes };
25
+ }
26
+ /** No allocator or callback is accepted; the caller supplies its already computed layout. */
27
+ export function withSharedReadbackLayout2D(fees, layout) {
28
+ const { rowPitch, staging, output } = layout;
29
+ if (!Number.isSafeInteger(staging) || staging + output > fees.options.maxReadbackBytes)
30
+ fail('budget');
31
+ return { ...fees, rowPitch, staging, output };
32
+ }
33
+ export function checkSharedCapacity2D(storage, owner, canonicalBytes = 0, sourceCopy = 0) {
34
+ const { options, prepared } = storage;
35
+ const check = (used, amount, limit) => {
36
+ if (!Number.isSafeInteger(used) || used < 0 || !Number.isSafeInteger(amount) || amount < 0 || amount > limit - used)
37
+ fail('backpressure');
38
+ };
39
+ check(owner.pendingFrames, 1, options.maxPendingFrames);
40
+ check(owner.pendingUploadBytes, storage.upload, options.maxPendingUploadBytes);
41
+ check(owner.pendingReadbackBytes, storage.staging + storage.output, options.maxReadbackBytes);
42
+ const pagesAtOnce = pendingPageBytes(options.maxFramePageBytes);
43
+ check(owner.pendingTextureBytes, prepared.pageBytes, pagesAtOnce);
44
+ check(owner.pendingGeometryBytes, prepared.geometryBytes, options.maxPendingGeometryBytes);
45
+ check(owner.pendingColorBytes, storage.colorBytes + storage.effectBytes, 134217728);
46
+ if (canonicalBytes + sourceCopy > pagesAtOnce)
47
+ fail('budget');
48
+ check(owner.pendingCanonicalBytes, canonicalBytes + sourceCopy, pagesAtOnce);
49
+ if (!Number.isSafeInteger(owner.serial) || owner.serial < 0 || owner.serial >= Number.MAX_SAFE_INTEGER)
50
+ fail('serial');
51
+ }
52
+ /** Only current READY identities authorize omitted whole-page copies. */
53
+ export function materializeSharedPages2D(storage, cold, owner, diagnostics) {
54
+ let canonicalBytes = 0, sourceCopy = 0;
55
+ for (const index of cold) {
56
+ const bytes = storage.projectionPlan.views[index].byteLength;
57
+ canonicalBytes += bytes;
58
+ sourceCopy = Math.max(sourceCopy, bytes);
59
+ }
60
+ checkSharedCapacity2D(storage, owner, canonicalBytes, sourceCopy);
61
+ const before = diagnostics?.canonicalBytes;
62
+ try {
63
+ const projections = storage.projectionPlan.views.map((view, index) => cold.has(index) ? copySharedPagePixels(view.image, diagnostics, view.levels ?? 1) : undefined);
64
+ return { projections, canonicalBytes };
65
+ }
66
+ catch (cause) {
67
+ // No returned projection array owns the earlier completed copies on this exit.
68
+ if (diagnostics)
69
+ diagnostics.canonicalBytes = before;
70
+ throw cause;
71
+ }
72
+ }
73
+ //# sourceMappingURL=sharedSubmissionStorage2D.js.map
@@ -0,0 +1,40 @@
1
+ import type { PackedSharedDraw2D } from '../rendering/packSharedDraws2D.js';
2
+ export interface SharedWebGL2ArenaStrides {
3
+ readonly sharedStride: number;
4
+ }
5
+ interface SharedRange {
6
+ readonly draw: PackedSharedDraw2D;
7
+ readonly vertexOffset: number;
8
+ readonly firstVertex: number;
9
+ readonly uniformOffset: number;
10
+ readonly uniformSize: 128;
11
+ }
12
+ /** The region table of one record: its own uniform buffer, one window after another, each at an aligned offset. */
13
+ export interface SharedWebGL2RegionTable {
14
+ readonly bytes: number;
15
+ readonly stride: number;
16
+ /** The rows of each window, to be written at `offset`. */
17
+ readonly windows: readonly {
18
+ readonly offset: number;
19
+ readonly data: Uint32Array<ArrayBuffer>;
20
+ }[];
21
+ }
22
+ export interface SharedWebGL2ArenaPlan {
23
+ readonly vertexBytes: number;
24
+ readonly uniformBytes: number;
25
+ readonly sharedRanges: readonly SharedRange[];
26
+ /** Present when a draw of the record has a region. Not part of `uniformBytes`. */
27
+ readonly regionTable: SharedWebGL2RegionTable | undefined;
28
+ }
29
+ export interface SharedWebGL2ArenaOwner {
30
+ readonly pendingVertexArenaBytes: number;
31
+ readonly pendingUniformArenaBytes: number;
32
+ }
33
+ /** Actual GL alignment is finite but need not be a power of two. */
34
+ export declare function qualifySharedWebGL2Alignment(alignment: number): SharedWebGL2ArenaStrides;
35
+ /** Plan only native addresses; existing private payload arrays remain their original owners. */
36
+ export declare function planSharedWebGL2Arenas(draws: readonly PackedSharedDraw2D[], alignment: number, regions?: Uint32Array<ArrayBuffer>): SharedWebGL2ArenaPlan;
37
+ /** Pure check: Host repeats it with current counters immediately before owner/serial commit. */
38
+ export declare function checkSharedWebGL2ArenaCapacity(plan: SharedWebGL2ArenaPlan, owner: SharedWebGL2ArenaOwner): void;
39
+ export {};
40
+ //# sourceMappingURL=sharedWebGL2Arena.d.ts.map
@@ -0,0 +1,77 @@
1
+ import { noteOwnedPreparationFailure } from '../rendering/ownedPreparationFailure2D.js';
2
+ import { SharedStorageError2D } from './sharedSubmissionStorage2D.js';
3
+ // The packed layout: 52 bytes for one vertex; 341 regions of twelve u32 values, 16,368 bytes, for one window of the region table.
4
+ const VERTEX = 52, WINDOW_REGIONS = 341, WINDOW_BYTES = 16368;
5
+ const RECORD_VERTEX = 33554432, RECORD_UNIFORM = 16777216, RECORD_TOTAL = 50331648;
6
+ const PENDING_VERTEX = 67108864, PENDING_UNIFORM = 33554432, PENDING_TOTAL = 100663296;
7
+ function fail(reason) {
8
+ throw noteOwnedPreparationFailure(new SharedStorageError2D(reason));
9
+ }
10
+ /** Actual GL alignment is finite but need not be a power of two. */
11
+ export function qualifySharedWebGL2Alignment(alignment) {
12
+ if (!Number.isSafeInteger(alignment) || alignment < 4 || alignment > 256 || alignment % 4 !== 0)
13
+ fail('device');
14
+ return { sharedStride: Math.ceil(128 / alignment) * alignment };
15
+ }
16
+ /** Plan only native addresses; existing private payload arrays remain their original owners. */
17
+ export function planSharedWebGL2Arenas(draws, alignment, regions) {
18
+ const { sharedStride } = qualifySharedWebGL2Alignment(alignment);
19
+ const count = draws.length;
20
+ if (!Number.isSafeInteger(count) || count < 0 || count > 65536)
21
+ fail('budget');
22
+ const uniformBytes = count * sharedStride;
23
+ const sharedRanges = [];
24
+ let vertexBytes = 0;
25
+ for (let i = 0; i < count; i++) {
26
+ const draw = draws[i], bytes = draw.data.byteLength;
27
+ if (!Number.isSafeInteger(draw.vertexCount) ||
28
+ draw.vertexCount <= 0 ||
29
+ !Number.isSafeInteger(bytes) ||
30
+ bytes <= 0 ||
31
+ bytes !== VERTEX * draw.vertexCount ||
32
+ bytes > RECORD_VERTEX - vertexBytes ||
33
+ draw.uniform.byteLength !== 128)
34
+ fail('budget');
35
+ sharedRanges.push({
36
+ draw,
37
+ vertexOffset: vertexBytes,
38
+ firstVertex: vertexBytes / VERTEX,
39
+ uniformOffset: i * sharedStride,
40
+ uniformSize: 128
41
+ });
42
+ vertexBytes += bytes;
43
+ }
44
+ // Allocation includes final stride padding; range sizes above expose only original payloads.
45
+ if (uniformBytes > RECORD_UNIFORM || uniformBytes > RECORD_TOTAL - vertexBytes)
46
+ fail('budget');
47
+ let regionTable;
48
+ if (draws.some(draw => draw.regionWindow >= 0)) {
49
+ // A bound window is always the whole block, so the last window is allocated in full too.
50
+ const rows = regions ? regions.length / 12 : 0, count = Math.ceil(rows / WINDOW_REGIONS);
51
+ if (!regions ||
52
+ !Number.isSafeInteger(rows) ||
53
+ rows <= 0 ||
54
+ rows > 4096 ||
55
+ draws.some(draw => draw.regionWindow >= count))
56
+ fail('budget');
57
+ const stride = Math.ceil(WINDOW_BYTES / alignment) * alignment, windows = [];
58
+ for (let i = 0; i < count; i++)
59
+ windows.push({
60
+ offset: i * stride,
61
+ data: regions.subarray(12 * WINDOW_REGIONS * i, Math.min(regions.length, 12 * WINDOW_REGIONS * (i + 1)))
62
+ });
63
+ regionTable = { bytes: (count - 1) * stride + WINDOW_BYTES, stride, windows };
64
+ }
65
+ return { vertexBytes, uniformBytes, sharedRanges, regionTable };
66
+ }
67
+ function pending(used, amount, limit) {
68
+ if (!Number.isSafeInteger(used) || used < 0 || !Number.isSafeInteger(amount) || amount < 0 || amount > limit - used)
69
+ fail('backpressure');
70
+ }
71
+ /** Pure check: Host repeats it with current counters immediately before owner/serial commit. */
72
+ export function checkSharedWebGL2ArenaCapacity(plan, owner) {
73
+ pending(owner.pendingVertexArenaBytes, plan.vertexBytes, PENDING_VERTEX);
74
+ pending(owner.pendingUniformArenaBytes, plan.uniformBytes, PENDING_UNIFORM);
75
+ pending(owner.pendingVertexArenaBytes + owner.pendingUniformArenaBytes, plan.vertexBytes + plan.uniformBytes, PENDING_TOTAL);
76
+ }
77
+ //# sourceMappingURL=sharedWebGL2Arena.js.map
@@ -0,0 +1,33 @@
1
+ import type { SharedPreparationOptions2D } from '../rendering/prepareSharedDraws2D.js';
2
+ import type { SharedStorageLimits2D } from './sharedSubmissionStorage2D.js';
3
+ import type { WebGL2HostDiagnostic } from './webgl2Types.js';
4
+ export interface SharedWebGL2Configuration extends SharedPreparationOptions2D, SharedStorageLimits2D {
5
+ /** Distinct regions one frame may name; at most the profile's 4,096. */
6
+ readonly maxFrameRegions: number;
7
+ /** Bytes of distinct pages one frame may name; at most the profile's 64 MiB. */
8
+ readonly maxFramePageBytes: number;
9
+ /** Bytes of page textures kept ready between frames; at most 128 MiB. */
10
+ readonly maxReadyPageBytes: number;
11
+ readonly maxBackingPixels: number;
12
+ readonly enableReadback: boolean;
13
+ readonly enableEffects: boolean;
14
+ readonly outputAlpha: 'premultiplied' | 'opaque';
15
+ readonly restoreTimeoutMs: number;
16
+ /** Where translucent draws mix: `linear` light (the default) or the stored `srgb` codes, as a 2D canvas does. */
17
+ readonly blendSpace: 'linear' | 'srgb';
18
+ }
19
+ /** A shared WebGL2 host to make: its canvas, what it reports to, and whether it measures frames. */
20
+ export interface SharedWebGL2HostOptions extends Partial<SharedWebGL2Configuration> {
21
+ readonly canvas: HTMLCanvasElement;
22
+ readonly onDiagnostic?: (diagnostic: WebGL2HostDiagnostic) => unknown;
23
+ /** Collect bounded CPU elapsed timings for shared frames. Defaults to false. */
24
+ readonly measureSharedFrames?: boolean;
25
+ }
26
+ /** Capture all successful reads before semantics; preserve the first thrown getter value. */
27
+ export declare function admitSharedWebGL2Options(input: SharedWebGL2HostOptions): {
28
+ surface: HTMLCanvasElement;
29
+ configuration: SharedWebGL2Configuration;
30
+ callback: ((diagnostic: WebGL2HostDiagnostic) => unknown) | undefined;
31
+ measureSharedFrames: boolean;
32
+ };
33
+ //# sourceMappingURL=sharedWebGL2Options.d.ts.map