@egret/engine 0.0.0-stage → 7.0.1-rc.3

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 (575) 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 +464 -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 +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -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 +15 -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 +43 -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 +233 -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 +29 -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 +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -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 +411 -0
  57. package/dist/cameraTypes.d.ts +114 -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 +33 -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 +42 -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 +34 -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 +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -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 +134 -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 +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -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 +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -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 +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -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 +37 -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 +292 -0
  145. package/dist/particleTypes.d.ts +107 -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 +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -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 +331 -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 +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -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 +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -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 +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,196 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Procedural geometry builders. All produce counter-clockwise triangles with
3
+ // outward normals and UVs whose V axis points up.
4
+ import { World3DError, requireCount3D, requirePositive3D } from './core3D.js';
5
+ import { Attribute3D, Geometry3D } from './Geometry3D.js';
6
+ const MAX_SEGMENTS = 512;
7
+ class Builder {
8
+ positions = [];
9
+ normals = [];
10
+ uvs = [];
11
+ indices = [];
12
+ get vertexCount() {
13
+ return this.positions.length / 3;
14
+ }
15
+ vertex(px, py, pz, nx, ny, nz, u, v) {
16
+ this.positions.push(px, py, pz);
17
+ this.normals.push(nx, ny, nz);
18
+ this.uvs.push(u, v);
19
+ }
20
+ /** Index a (columns + 1) x (rows + 1) vertex grid starting at `base`. */
21
+ grid(base, columns, rows, flip = false) {
22
+ const stride = columns + 1;
23
+ for (let row = 0; row < rows; row++) {
24
+ for (let column = 0; column < columns; column++) {
25
+ const a = base + row * stride + column, b = a + stride, c = b + 1, d = a + 1;
26
+ if (flip)
27
+ this.indices.push(a, d, b, b, d, c);
28
+ else
29
+ this.indices.push(a, b, d, b, c, d);
30
+ }
31
+ }
32
+ }
33
+ build() {
34
+ const geometry = new Geometry3D();
35
+ geometry.setAttribute('position', new Attribute3D(new Float32Array(this.positions), 3));
36
+ geometry.setAttribute('normal', new Attribute3D(new Float32Array(this.normals), 3));
37
+ geometry.setAttribute('uv', new Attribute3D(new Float32Array(this.uvs), 2));
38
+ geometry.setIndex(this.vertexCount > 65535 ? new Uint32Array(this.indices) : new Uint16Array(this.indices));
39
+ return geometry;
40
+ }
41
+ }
42
+ function segments(value, fallback, min, field) {
43
+ const count = requireCount3D(value ?? fallback, field, MAX_SEGMENTS);
44
+ if (count < min)
45
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
46
+ return count;
47
+ }
48
+ /** Axis-aligned box centered on the origin with one material group per face (+X, -X, +Y, -Y, +Z, -Z). */
49
+ export function createBoxGeometry3D(options = {}) {
50
+ const width = requirePositive3D(options.width ?? 1, 'width'), height = requirePositive3D(options.height ?? 1, 'height'), depth = requirePositive3D(options.depth ?? 1, 'depth');
51
+ const ws = segments(options.widthSegments, 1, 1, 'widthSegments'), hs = segments(options.heightSegments, 1, 1, 'heightSegments'), ds = segments(options.depthSegments, 1, 1, 'depthSegments');
52
+ const builder = new Builder();
53
+ const groups = [];
54
+ // Each face maps (u, v) across two axes while the third stays at +-half.
55
+ const face = (uAxis, vAxis, wAxis, uDir, vDir, w, uSize, vSize, uSeg, vSeg) => {
56
+ const base = builder.vertexCount, start = builder.indices.length;
57
+ for (let iy = 0; iy <= vSeg; iy++) {
58
+ for (let ix = 0; ix <= uSeg; ix++) {
59
+ const p = [0, 0, 0], n = [0, 0, 0];
60
+ p[uAxis] = (ix / uSeg - 0.5) * uSize * uDir;
61
+ p[vAxis] = (0.5 - iy / vSeg) * vSize * vDir;
62
+ p[wAxis] = w;
63
+ n[wAxis] = Math.sign(w);
64
+ builder.vertex(p[0], p[1], p[2], n[0], n[1], n[2], ix / uSeg, 1 - iy / vSeg);
65
+ }
66
+ }
67
+ builder.grid(base, uSeg, vSeg);
68
+ groups.push([start, builder.indices.length - start]);
69
+ };
70
+ face(2, 1, 0, -1, 1, width / 2, depth, height, ds, hs);
71
+ face(2, 1, 0, 1, 1, -width / 2, depth, height, ds, hs);
72
+ face(0, 2, 1, 1, -1, height / 2, width, depth, ws, ds);
73
+ face(0, 2, 1, 1, 1, -height / 2, width, depth, ws, ds);
74
+ face(0, 1, 2, 1, 1, depth / 2, width, height, ws, hs);
75
+ face(0, 1, 2, -1, 1, -depth / 2, width, height, ws, hs);
76
+ const geometry = builder.build();
77
+ groups.forEach(([start, count], index) => geometry.addGroup(start, count, index));
78
+ return geometry;
79
+ }
80
+ /** Plane in the XY plane facing +Z. Rotate -90 degrees about X for a floor. */
81
+ export function createPlaneGeometry3D(options = {}) {
82
+ const width = requirePositive3D(options.width ?? 1, 'width'), height = requirePositive3D(options.height ?? 1, 'height');
83
+ const ws = segments(options.widthSegments, 1, 1, 'widthSegments'), hs = segments(options.heightSegments, 1, 1, 'heightSegments');
84
+ const builder = new Builder();
85
+ for (let iy = 0; iy <= hs; iy++) {
86
+ for (let ix = 0; ix <= ws; ix++)
87
+ builder.vertex((ix / ws - 0.5) * width, (0.5 - iy / hs) * height, 0, 0, 0, 1, ix / ws, 1 - iy / hs);
88
+ }
89
+ builder.grid(0, ws, hs);
90
+ return builder.build();
91
+ }
92
+ /** UV sphere with poles on the Y axis. */
93
+ export function createSphereGeometry3D(options = {}) {
94
+ const radius = requirePositive3D(options.radius ?? 0.5, 'radius');
95
+ const ws = segments(options.widthSegments, 32, 3, 'widthSegments'), hs = segments(options.heightSegments, 16, 2, 'heightSegments');
96
+ const builder = new Builder();
97
+ for (let iy = 0; iy <= hs; iy++) {
98
+ const v = iy / hs, phi = v * Math.PI, sinPhi = Math.sin(phi), cosPhi = Math.cos(phi);
99
+ for (let ix = 0; ix <= ws; ix++) {
100
+ const u = ix / ws, theta = u * Math.PI * 2;
101
+ const nx = -Math.cos(theta) * sinPhi, ny = cosPhi, nz = Math.sin(theta) * sinPhi;
102
+ builder.vertex(nx * radius, ny * radius, nz * radius, nx, ny, nz, u, 1 - v);
103
+ }
104
+ }
105
+ builder.grid(0, ws, hs);
106
+ return builder.build();
107
+ }
108
+ /** Cylinder or truncated cone along Y. A zero radius at one end produces a cone. */
109
+ export function createCylinderGeometry3D(options = {}) {
110
+ const top = options.radiusTop ?? 0.5, bottom = options.radiusBottom ?? 0.5;
111
+ if (!(top >= 0) || !(bottom >= 0) || (top === 0 && bottom === 0) || !Number.isFinite(top + bottom))
112
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'radius');
113
+ const height = requirePositive3D(options.height ?? 1, 'height');
114
+ const rs = segments(options.radialSegments, 32, 3, 'radialSegments'), hs = segments(options.heightSegments, 1, 1, 'heightSegments');
115
+ const builder = new Builder();
116
+ const slope = (bottom - top) / height;
117
+ for (let iy = 0; iy <= hs; iy++) {
118
+ const v = iy / hs, radius = top + (bottom - top) * v, y = (0.5 - v) * height;
119
+ for (let ix = 0; ix <= rs; ix++) {
120
+ const u = ix / rs, theta = u * Math.PI * 2, sin = Math.sin(theta), cos = Math.cos(theta);
121
+ const length = Math.hypot(1, slope);
122
+ builder.vertex(radius * sin, y, radius * cos, sin / length, slope / length, cos / length, u, 1 - v);
123
+ }
124
+ }
125
+ builder.grid(0, rs, hs);
126
+ if (!options.openEnded) {
127
+ const cap = (radius, y, normalY) => {
128
+ if (radius === 0)
129
+ return;
130
+ const center = builder.vertexCount;
131
+ builder.vertex(0, y, 0, 0, normalY, 0, 0.5, 0.5);
132
+ for (let ix = 0; ix <= rs; ix++) {
133
+ const theta = (ix / rs) * Math.PI * 2, sin = Math.sin(theta), cos = Math.cos(theta);
134
+ builder.vertex(radius * sin, y, radius * cos, 0, normalY, 0, sin * 0.5 + 0.5, cos * 0.5 * normalY + 0.5);
135
+ }
136
+ for (let ix = 0; ix < rs; ix++) {
137
+ const a = center + 1 + ix, b = a + 1;
138
+ if (normalY > 0)
139
+ builder.indices.push(center, a, b);
140
+ else
141
+ builder.indices.push(center, b, a);
142
+ }
143
+ };
144
+ cap(top, height / 2, 1);
145
+ cap(bottom, -height / 2, -1);
146
+ }
147
+ return builder.build();
148
+ }
149
+ export function createConeGeometry3D(options = {}) {
150
+ return createCylinderGeometry3D({
151
+ radiusTop: 0,
152
+ radiusBottom: options.radius ?? 0.5,
153
+ height: options.height ?? 1,
154
+ ...(options.radialSegments === undefined ? {} : { radialSegments: options.radialSegments })
155
+ });
156
+ }
157
+ /** Torus around the Z axis. */
158
+ export function createTorusGeometry3D(options = {}) {
159
+ const radius = requirePositive3D(options.radius ?? 0.5, 'radius'), tube = requirePositive3D(options.tube ?? 0.2, 'tube');
160
+ const rs = segments(options.radialSegments, 16, 3, 'radialSegments'), ts = segments(options.tubularSegments, 48, 3, 'tubularSegments');
161
+ const builder = new Builder();
162
+ for (let j = 0; j <= rs; j++) {
163
+ const v = (j / rs) * Math.PI * 2, cosV = Math.cos(v), sinV = Math.sin(v);
164
+ for (let i = 0; i <= ts; i++) {
165
+ const u = (i / ts) * Math.PI * 2, cosU = Math.cos(u), sinU = Math.sin(u);
166
+ builder.vertex((radius + tube * cosV) * cosU, (radius + tube * cosV) * sinU, tube * sinV, cosV * cosU, cosV * sinU, sinV, i / ts, j / rs);
167
+ }
168
+ }
169
+ builder.grid(0, ts, rs, true);
170
+ return builder.build();
171
+ }
172
+ /** Capsule along Y; `height` is the length of the cylindrical middle section. */
173
+ export function createCapsuleGeometry3D(options = {}) {
174
+ const radius = requirePositive3D(options.radius ?? 0.5, 'radius'), height = requirePositive3D(options.height ?? 1, 'height');
175
+ const cs = segments(options.capSegments, 8, 1, 'capSegments'), rs = segments(options.radialSegments, 24, 3, 'radialSegments');
176
+ const builder = new Builder();
177
+ const rows = cs * 2 + 1, total = Math.PI * radius + height;
178
+ for (let iy = 0; iy <= rows; iy++) {
179
+ // Rows 0..cs sweep the top hemisphere, the rest sweep the bottom one.
180
+ const upper = iy <= cs, ring = upper ? iy : iy - 1, phi = (ring / (cs * 2)) * Math.PI;
181
+ const sinPhi = Math.sin(phi), cosPhi = Math.cos(phi), offset = upper ? height / 2 : -height / 2;
182
+ const arc = phi * radius + (upper ? 0 : height);
183
+ for (let ix = 0; ix <= rs; ix++) {
184
+ const u = ix / rs, theta = u * Math.PI * 2;
185
+ const nx = -Math.cos(theta) * sinPhi, nz = Math.sin(theta) * sinPhi;
186
+ builder.vertex(nx * radius, cosPhi * radius + offset, nz * radius, nx, cosPhi, nz, u, 1 - arc / total);
187
+ }
188
+ }
189
+ builder.grid(0, rs, rows);
190
+ return builder.build();
191
+ }
192
+ /** Unit quad in XY used by sprites: corners at +-0.5, facing +Z. */
193
+ export function createQuadGeometry3D() {
194
+ return createPlaneGeometry3D({ width: 1, height: 1 });
195
+ }
196
+ //# sourceMappingURL=primitives3D.js.map
@@ -0,0 +1,8 @@
1
+ /** Optional metadata assembly; importing it creates no provider or CPU value. */
2
+ export { createManifestAssetBinding } from './manifestResourceState.js';
3
+ export { createContentLoader } from './contentLoader.js';
4
+ export type { ContentBinding, ContentProviders, ContentProviderFactory, ContentGroup, ContentLoader } from './contentTypes.js';
5
+ export type { ManifestBinding, ManifestAssetBinding, ManifestAssetGroup, ManifestGroupOptions } from './manifestResourceTypes.js';
6
+ export { createFontContentLoader } from './fontContentLoader.js';
7
+ export type { FontContentBinding, FontContentAsset, FontContentGroup, FontContentLoader, FontContentProviderFactory } from './fontContentTypes.js';
8
+ //# sourceMappingURL=resources.d.ts.map
@@ -0,0 +1,6 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ /** Optional metadata assembly; importing it creates no provider or CPU value. */
3
+ export { createManifestAssetBinding } from './manifestResourceState.js';
4
+ export { createContentLoader } from './contentLoader.js';
5
+ export { createFontContentLoader } from './fontContentLoader.js';
6
+ //# sourceMappingURL=resources.js.map
@@ -0,0 +1,56 @@
1
+ /** Where a save is kept: strings by key. Browser storage is one; `createMemorySaveStorage` is another. */
2
+ export interface SaveStorage {
3
+ getItem(key: string): string | null;
4
+ setItem(key: string, value: string): void;
5
+ removeItem(key: string): void;
6
+ }
7
+ export interface SaveStoreOptions<T> {
8
+ /** The key the save is kept under. */
9
+ readonly key: string;
10
+ /** The version this build writes; a whole number from 1. */
11
+ readonly version: number;
12
+ /** The data of a new game; also what a missing or unreadable save becomes. */
13
+ readonly defaults: () => T;
14
+ /**
15
+ * Steps from an older version: `migrations[n]` turns data of version n into version n + 1. A save older than
16
+ * the oldest step, or newer than this build, starts again from the defaults and is kept aside under
17
+ * `<key>.unread` so nothing is lost.
18
+ */
19
+ readonly migrations?: Readonly<Record<number, (data: unknown) => unknown>>;
20
+ /** Checks loaded data; a save that fails it starts from the defaults. Defaults to accepting any object. */
21
+ readonly validate?: (data: unknown) => data is T;
22
+ readonly storage: SaveStorage;
23
+ /** Told of every load or write that did not go as planned. */
24
+ readonly onProblem?: (problem: SaveProblem) => void;
25
+ }
26
+ export type SaveProblemKind = 'unreadable' | 'invalid' | 'too-new' | 'too-old' | 'migration-failed' | 'write-failed';
27
+ export interface SaveProblem {
28
+ readonly kind: SaveProblemKind;
29
+ readonly key: string;
30
+ readonly cause?: unknown;
31
+ }
32
+ export interface SaveStore<T> {
33
+ /** The data now: loaded, migrated, or the defaults. */
34
+ readonly data: T;
35
+ /** The version the loaded save had before migration, or undefined for a new game. */
36
+ readonly loadedVersion: number | undefined;
37
+ /** Replaces the data and writes it. Returns false when the storage refused, as when it is full. */
38
+ save(data?: T): boolean;
39
+ /** Changes the data with `change`, which may edit it in place or return new data, then writes it. */
40
+ update(change: (data: T) => T | void): boolean;
41
+ /** Back to the defaults, written. */
42
+ reset(): boolean;
43
+ /** Takes the save out of the storage. The data stays as it was in memory. */
44
+ remove(): void;
45
+ /** The save as a string, for an export button. */
46
+ export(): string;
47
+ /** Loads an exported string, migrating it like a stored save. Returns false and changes nothing when it cannot. */
48
+ import(text: string): boolean;
49
+ }
50
+ /** Opens the save under `options.key`, migrating an older one. */
51
+ export declare function createSaveStore<T>(options: SaveStoreOptions<T>): SaveStore<T>;
52
+ /** Storage kept in memory: for tests, for a page without browser storage, or for a game played once. */
53
+ export declare function createMemorySaveStorage(initial?: Readonly<Record<string, string>>): SaveStorage & {
54
+ readonly entries: ReadonlyMap<string, string>;
55
+ };
56
+ //# sourceMappingURL=saveStore.d.ts.map
@@ -0,0 +1,163 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // A game's save: settings, progress, unlocked tiers, best marks. It is plain
3
+ // data kept under one key, with a version number and the steps that bring an
4
+ // older save up to date, so a save from last month's build still loads. A save
5
+ // that cannot be read or written never stops the game: the store reports it
6
+ // and goes on with the data it has. The storage is given, so the same store
7
+ // works over browser storage, a file, or a test's map.
8
+ import { EgretError } from '@egret/runtime';
9
+ const isObject = (value) => typeof value === 'object' && value !== null;
10
+ /** Opens the save under `options.key`, migrating an older one. */
11
+ export function createSaveStore(options) {
12
+ if (!isObject(options))
13
+ throw new EgretError('SAVE_STORE_OPTIONS_INVALID');
14
+ const { key, version, defaults, storage } = options;
15
+ if (typeof key !== 'string' || key.length === 0 || key.length > 200)
16
+ throw new EgretError('SAVE_STORE_OPTIONS_INVALID');
17
+ if (!Number.isSafeInteger(version) || version < 1)
18
+ throw new EgretError('SAVE_STORE_OPTIONS_INVALID');
19
+ if (typeof defaults !== 'function')
20
+ throw new EgretError('SAVE_STORE_OPTIONS_INVALID');
21
+ if (!storage || typeof storage.getItem !== 'function' || typeof storage.setItem !== 'function')
22
+ throw new EgretError('SAVE_STORE_OPTIONS_INVALID');
23
+ const migrations = options.migrations ?? {};
24
+ const validate = options.validate ?? ((data) => isObject(data));
25
+ const report = (kind, cause) => {
26
+ try {
27
+ options.onProblem?.({ kind, key, ...(cause === undefined ? {} : { cause }) });
28
+ }
29
+ catch {
30
+ /* A failing listener must not break loading. */
31
+ }
32
+ };
33
+ const keepAside = (text) => {
34
+ try {
35
+ storage.setItem(key + '.unread', text);
36
+ }
37
+ catch {
38
+ /* Nothing more can be done for it. */
39
+ }
40
+ };
41
+ // Reads text into data of this version, or explains why not.
42
+ const read = (text) => {
43
+ let envelope;
44
+ try {
45
+ envelope = JSON.parse(text);
46
+ }
47
+ catch (cause) {
48
+ return { problem: 'unreadable', cause };
49
+ }
50
+ if (!isObject(envelope) || !Number.isSafeInteger(envelope.version) || envelope.version < 1)
51
+ return { problem: 'unreadable' };
52
+ if (envelope.version > version)
53
+ return { problem: 'too-new' };
54
+ let data = envelope.data;
55
+ for (let at = envelope.version; at < version; at++) {
56
+ const step = migrations[at];
57
+ if (typeof step !== 'function')
58
+ return { problem: 'too-old' };
59
+ try {
60
+ data = step(data);
61
+ }
62
+ catch (cause) {
63
+ return { problem: 'migration-failed', cause };
64
+ }
65
+ }
66
+ if (!validate(data))
67
+ return { problem: 'invalid' };
68
+ return { data: data, from: envelope.version };
69
+ };
70
+ let data = defaults();
71
+ let loadedVersion;
72
+ let text = null;
73
+ try {
74
+ text = storage.getItem(key);
75
+ }
76
+ catch (cause) {
77
+ report('unreadable', cause);
78
+ }
79
+ if (text !== null) {
80
+ const result = read(text);
81
+ if ('data' in result) {
82
+ data = result.data;
83
+ loadedVersion = result.from;
84
+ }
85
+ else {
86
+ report(result.problem, result.cause);
87
+ keepAside(text);
88
+ }
89
+ }
90
+ const write = () => {
91
+ try {
92
+ const envelope = { version, savedAt: new Date().toISOString(), data };
93
+ storage.setItem(key, JSON.stringify(envelope));
94
+ return true;
95
+ }
96
+ catch (cause) {
97
+ report('write-failed', cause);
98
+ return false;
99
+ }
100
+ };
101
+ // A migrated save is written back at once in its new form.
102
+ if (loadedVersion !== undefined && loadedVersion < version)
103
+ write();
104
+ const store = {
105
+ get data() {
106
+ return data;
107
+ },
108
+ get loadedVersion() {
109
+ return loadedVersion;
110
+ },
111
+ save(next) {
112
+ if (next !== undefined)
113
+ data = next;
114
+ return write();
115
+ },
116
+ update(change) {
117
+ if (typeof change !== 'function')
118
+ throw new EgretError('SAVE_STORE_OPTIONS_INVALID');
119
+ const result = change(data);
120
+ if (result !== undefined)
121
+ data = result;
122
+ return write();
123
+ },
124
+ reset() {
125
+ data = defaults();
126
+ return write();
127
+ },
128
+ remove() {
129
+ try {
130
+ storage.removeItem(key);
131
+ }
132
+ catch (cause) {
133
+ report('write-failed', cause);
134
+ }
135
+ },
136
+ export() {
137
+ return JSON.stringify({ version, savedAt: new Date().toISOString(), data });
138
+ },
139
+ import(imported) {
140
+ if (typeof imported !== 'string')
141
+ return false;
142
+ const result = read(imported);
143
+ if (!('data' in result)) {
144
+ report(result.problem, result.cause);
145
+ return false;
146
+ }
147
+ data = result.data;
148
+ return write();
149
+ }
150
+ };
151
+ return store;
152
+ }
153
+ /** Storage kept in memory: for tests, for a page without browser storage, or for a game played once. */
154
+ export function createMemorySaveStorage(initial = {}) {
155
+ const entries = new Map(Object.entries(initial));
156
+ return {
157
+ entries,
158
+ getItem: key => entries.get(key) ?? null,
159
+ setItem: (key, value) => void entries.set(key, String(value)),
160
+ removeItem: key => void entries.delete(key)
161
+ };
162
+ }
163
+ //# sourceMappingURL=saveStore.js.map
@@ -0,0 +1,122 @@
1
+ import type { SemanticBounds, UiSemantics } from './semanticTypes.js';
2
+ /**
3
+ * The rows of a managed virtual list, as nodes of a semantic tree.
4
+ *
5
+ * A virtual list realizes the rows that show and recycles the rest, so its nodes come and go with
6
+ * every commit. This keeps one node for the list and one for each row that shows, reads their
7
+ * places from what the root committed, and reports each row's position in the whole set of
8
+ * records. It reads the root; it changes nothing in it but the focus a row is asked to take.
9
+ */
10
+ /** What is read of a managed UI root. The root `createUiRoot` returns is one. */
11
+ export interface SemanticListSource {
12
+ readonly id: string;
13
+ snapshot(): {
14
+ readonly committedRevision: number;
15
+ readonly origin: {
16
+ readonly x: number;
17
+ readonly y: number;
18
+ };
19
+ readonly boxes: readonly {
20
+ readonly id: string;
21
+ readonly x: number;
22
+ readonly y: number;
23
+ readonly width: number;
24
+ readonly height: number;
25
+ }[];
26
+ };
27
+ list(id: string): {
28
+ snapshot(): {
29
+ readonly rows: readonly {
30
+ readonly key: string;
31
+ readonly index: number;
32
+ readonly visible: boolean;
33
+ readonly box: SemanticBounds;
34
+ }[];
35
+ readonly counters: {
36
+ readonly recordCount: number;
37
+ };
38
+ };
39
+ getFocus(): {
40
+ readonly key: string | undefined;
41
+ };
42
+ focus(key: string | undefined, options?: {
43
+ readonly visible?: boolean;
44
+ }): void;
45
+ };
46
+ }
47
+ export interface SemanticListRow {
48
+ /** What the row is called. An option and a menu item need a name; a list item may leave it to the nodes inside it. */
49
+ readonly name?: string;
50
+ /** Options, where one that does not say is not selected, and the rows of a grid and the items of a tree, where saying it means that they are what is selected. */
51
+ readonly selected?: boolean;
52
+ /** Options, menu items, the rows of a grid and the items of a tree. */
53
+ readonly disabled?: boolean;
54
+ /** The items of a tree, which need it: how deep the item is, from one. */
55
+ readonly level?: number;
56
+ /** The items of a tree: whether what is under the item shows. One with nothing under it does not say. */
57
+ readonly expanded?: boolean;
58
+ /** The items of a tree: where the item stands among those under the same item, which is not where its row stands in the list. */
59
+ readonly position?: {
60
+ readonly index: number;
61
+ readonly size: number;
62
+ };
63
+ }
64
+ export interface UiListSemanticsOptions {
65
+ readonly semantics: UiSemantics;
66
+ readonly root: SemanticListSource;
67
+ /** The id of the virtual list in the tree of the root. */
68
+ readonly list: string;
69
+ /** The id of the list node. Defaults to the id of the root, a slash, and the id of the list. A row adds a slash and its key. */
70
+ readonly id?: string;
71
+ /** The node the list is inside. */
72
+ readonly parent?: string;
73
+ /**
74
+ * A 'list' of list items, which may hold other nodes, a 'listbox' of options, a 'menu' of menu items, a 'grid'
75
+ * whose rows are the rows of the list and hold the cells the application adds, or a 'tree' whose items are the
76
+ * rows that show, each at the depth it says. Defaults to 'list'.
77
+ */
78
+ readonly role?: 'list' | 'listbox' | 'menu' | 'grid' | 'tree';
79
+ readonly name?: string;
80
+ /** A list box, a grid or a tree only: several of its options, rows or items may be selected at once. Each still says whether it is. Defaults to false. */
81
+ readonly multiple?: boolean;
82
+ /** A grid only, which needs it: how many columns it has. */
83
+ readonly columns?: number;
84
+ /** A grid only: how many rows the application publishes above the first row of the list, such as a row of headers. Defaults to 0. */
85
+ readonly rowOffset?: number;
86
+ /**
87
+ * Read at each publication. A list that says it is hidden is left out with its rows: the list of a
88
+ * popup or a modal layer while that layer is closed. Its rows are then not asked.
89
+ */
90
+ readonly hidden?: () => boolean;
91
+ /** Read at each publication for each row that shows. */
92
+ readonly describeRow?: (key: string, index: number) => SemanticListRow;
93
+ /** The activation of a row, the one a press or a key on it reaches. Without it a row cannot be activated. */
94
+ readonly onActivateRow?: (key: string) => void;
95
+ /** Whether a row may be asked to take the keyboard focus. The root then needs a keyboard. Defaults to false. */
96
+ readonly focusable?: boolean;
97
+ /** Called after the node of a row was added, so that nodes inside it can be added under `id`. They go with the row. */
98
+ readonly onRowAdded?: (key: string, id: string) => void;
99
+ }
100
+ export interface UiListSemantics {
101
+ readonly id: string;
102
+ /** The id of the node of a row, whether or not the row shows now. */
103
+ rowId(key: string): string;
104
+ /** The part of a row that the list shows, on the stage, as of the last synchronization: what a cell inside it is measured from. Nothing for a row that does not show. */
105
+ rowBounds(key: string): SemanticBounds | undefined;
106
+ /**
107
+ * Brings the nodes to the rows of the last commit: removes those that no longer show, moves those
108
+ * that stayed, adds those that show now. Returns the committed revision, which is what `publish`
109
+ * takes. When the tree refuses a new row, none of the new rows is added and the refusal is thrown.
110
+ */
111
+ sync(): number;
112
+ /** Removes the list node and every row. */
113
+ dispose(): void;
114
+ }
115
+ /**
116
+ * The rectangle on the stage of a box a managed UI root laid out: a leaf, a row, a column or a
117
+ * list, by its id in the tree of the root. It is read from the last commit when it is called, so
118
+ * call it from `describe`. A box the root has not laid out has no size, at the origin of the root.
119
+ */
120
+ export declare function semanticBoxOf(root: Pick<SemanticListSource, 'snapshot'>, id: string): SemanticBounds;
121
+ export declare function createUiListSemantics(options: UiListSemanticsOptions): UiListSemantics;
122
+ //# sourceMappingURL=semanticList.d.ts.map