@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,230 @@
1
+ /** A shape in the world, at a place and a turn: a circle, or the corners of a convex polygon. */
2
+ export function place(shape, x, y, degrees) {
3
+ if (shape.kind === 'circle')
4
+ return { kind: 'circle', x, y, radius: shape.radius, points: new Float64Array(0) };
5
+ const local = shape.kind === 'box'
6
+ ? [
7
+ { x: -shape.width / 2, y: -shape.height / 2 },
8
+ { x: shape.width / 2, y: -shape.height / 2 },
9
+ { x: shape.width / 2, y: shape.height / 2 },
10
+ { x: -shape.width / 2, y: shape.height / 2 }
11
+ ]
12
+ : shape.points;
13
+ const a = (degrees * Math.PI) / 180, cos = Math.cos(a), sin = Math.sin(a), points = new Float64Array(local.length * 2);
14
+ local.forEach((p, i) => {
15
+ points[i * 2] = x + p.x * cos - p.y * sin;
16
+ points[i * 2 + 1] = y + p.x * sin + p.y * cos;
17
+ });
18
+ return { kind: 'polygon', x, y, radius: 0, points };
19
+ }
20
+ export function boxOf(shape) {
21
+ if (shape.kind === 'circle')
22
+ return {
23
+ minX: shape.x - shape.radius,
24
+ minY: shape.y - shape.radius,
25
+ maxX: shape.x + shape.radius,
26
+ maxY: shape.y + shape.radius
27
+ };
28
+ let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
29
+ for (let i = 0; i < shape.points.length; i += 2) {
30
+ const px = shape.points[i], py = shape.points[i + 1];
31
+ if (px < minX)
32
+ minX = px;
33
+ if (px > maxX)
34
+ maxX = px;
35
+ if (py < minY)
36
+ minY = py;
37
+ if (py > maxY)
38
+ maxY = py;
39
+ }
40
+ return { minX, minY, maxX, maxY };
41
+ }
42
+ export const boxesMeet = (a, b) => a.minX <= b.maxX && b.minX <= a.maxX && a.minY <= b.maxY && b.minY <= a.maxY;
43
+ /** The area of a shape, for the mass of a body. */
44
+ export function areaOf(shape) {
45
+ if (shape.kind === 'circle')
46
+ return Math.PI * shape.radius * shape.radius;
47
+ if (shape.kind === 'box')
48
+ return shape.width * shape.height;
49
+ let twice = 0;
50
+ for (let i = 0; i < shape.points.length; i++) {
51
+ const p = shape.points[i], q = shape.points[(i + 1) % shape.points.length];
52
+ twice += p.x * q.y - q.x * p.y;
53
+ }
54
+ return Math.abs(twice) / 2;
55
+ }
56
+ /** Whether points make a convex polygon of some area, in either turning. */
57
+ export function convex(points) {
58
+ if (points.length < 3 || points.length > 64)
59
+ return false;
60
+ let sign = 0;
61
+ for (let i = 0; i < points.length; i++) {
62
+ const a = points[i], b = points[(i + 1) % points.length], c = points[(i + 2) % points.length];
63
+ const cross = (b.x - a.x) * (c.y - b.y) - (b.y - a.y) * (c.x - b.x);
64
+ if (cross === 0)
65
+ continue;
66
+ if (sign === 0)
67
+ sign = Math.sign(cross);
68
+ else if (Math.sign(cross) !== sign)
69
+ return false;
70
+ }
71
+ return sign !== 0;
72
+ }
73
+ function project(shape, ax, ay) {
74
+ if (shape.kind === 'circle') {
75
+ const c = shape.x * ax + shape.y * ay;
76
+ return [c - shape.radius, c + shape.radius];
77
+ }
78
+ let min = Infinity, max = -Infinity;
79
+ for (let i = 0; i < shape.points.length; i += 2) {
80
+ const d = shape.points[i] * ax + shape.points[i + 1] * ay;
81
+ if (d < min)
82
+ min = d;
83
+ if (d > max)
84
+ max = d;
85
+ }
86
+ return [min, max];
87
+ }
88
+ /** The axes that can part two shapes: the normals of the edges, and for a circle the way to the nearest corner. */
89
+ function axes(shape, other, into) {
90
+ if (shape.kind === 'polygon') {
91
+ const n = shape.points.length / 2;
92
+ for (let i = 0; i < n; i++) {
93
+ const j = (i + 1) % n, ex = shape.points[j * 2] - shape.points[i * 2], ey = shape.points[j * 2 + 1] - shape.points[i * 2 + 1], length = Math.hypot(ex, ey);
94
+ if (length > 0)
95
+ into.push(ey / length, -ex / length);
96
+ }
97
+ }
98
+ else if (other.kind === 'polygon') {
99
+ let best = Infinity, bx = 0, by = 0;
100
+ for (let i = 0; i < other.points.length; i += 2) {
101
+ const dx = other.points[i] - shape.x, dy = other.points[i + 1] - shape.y, d = dx * dx + dy * dy;
102
+ if (d < best) {
103
+ best = d;
104
+ bx = dx;
105
+ by = dy;
106
+ }
107
+ }
108
+ const length = Math.hypot(bx, by);
109
+ if (length > 0)
110
+ into.push(bx / length, by / length);
111
+ }
112
+ }
113
+ /** Whether two shapes meet, by separating axes; when they do, the shortest way out of each other. */
114
+ export function meet(a, b) {
115
+ if (a.kind === 'circle' && b.kind === 'circle') {
116
+ const dx = b.x - a.x, dy = b.y - a.y, distance = Math.hypot(dx, dy), reach = a.radius + b.radius;
117
+ if (distance > reach)
118
+ return undefined;
119
+ return distance === 0
120
+ ? { nx: 0, ny: 1, depth: reach }
121
+ : { nx: dx / distance, ny: dy / distance, depth: reach - distance };
122
+ }
123
+ const list = [];
124
+ axes(a, b, list);
125
+ axes(b, a, list);
126
+ let depth = Infinity, nx = 0, ny = 0;
127
+ for (let i = 0; i < list.length; i += 2) {
128
+ const ax = list[i], ay = list[i + 1], [a0, a1] = project(a, ax, ay), [b0, b1] = project(b, ax, ay);
129
+ const overlap = Math.min(a1, b1) - Math.max(a0, b0);
130
+ if (overlap < 0)
131
+ return undefined;
132
+ if (overlap < depth) {
133
+ depth = overlap;
134
+ nx = ax;
135
+ ny = ay;
136
+ }
137
+ }
138
+ // The normal points from the first to the second.
139
+ const [ax, ay] = centre(a), [bx, by] = centre(b);
140
+ if ((bx - ax) * nx + (by - ay) * ny < 0) {
141
+ nx = -nx;
142
+ ny = -ny;
143
+ }
144
+ return { nx: nx + 0, ny: ny + 0, depth };
145
+ }
146
+ function centre(shape) {
147
+ if (shape.kind === 'circle')
148
+ return [shape.x, shape.y];
149
+ let x = 0, y = 0;
150
+ const n = shape.points.length / 2;
151
+ for (let i = 0; i < shape.points.length; i += 2) {
152
+ x += shape.points[i];
153
+ y += shape.points[i + 1];
154
+ }
155
+ return [x / n, y / n];
156
+ }
157
+ /** Whether a point is inside a shape, its edge included. */
158
+ export function holds(shape, x, y) {
159
+ if (shape.kind === 'circle')
160
+ return Math.hypot(x - shape.x, y - shape.y) <= shape.radius;
161
+ const n = shape.points.length / 2;
162
+ let sign = 0;
163
+ for (let i = 0; i < n; i++) {
164
+ const j = (i + 1) % n, ax = shape.points[i * 2], ay = shape.points[i * 2 + 1], cross = (shape.points[j * 2] - ax) * (y - ay) - (shape.points[j * 2 + 1] - ay) * (x - ax);
165
+ if (cross === 0)
166
+ continue;
167
+ if (sign === 0)
168
+ sign = Math.sign(cross);
169
+ else if (Math.sign(cross) !== sign)
170
+ return false;
171
+ }
172
+ return true;
173
+ }
174
+ /** Where a segment from (x0, y0) by (dx, dy) first meets a shape it starts outside of: the fraction along it and the normal there. */
175
+ export function cast(shape, x0, y0, dx, dy) {
176
+ if (shape.kind === 'circle') {
177
+ const fx = x0 - shape.x, fy = y0 - shape.y, a = dx * dx + dy * dy, b = 2 * (fx * dx + fy * dy), c = fx * fx + fy * fy - shape.radius * shape.radius;
178
+ if (a === 0 || c < 0)
179
+ return undefined;
180
+ const disc = b * b - 4 * a * c;
181
+ if (disc < 0)
182
+ return undefined;
183
+ const t = (-b - Math.sqrt(disc)) / (2 * a);
184
+ if (t < 0 || t > 1)
185
+ return undefined;
186
+ const hx = x0 + dx * t - shape.x, hy = y0 + dy * t - shape.y, length = Math.hypot(hx, hy) || 1;
187
+ return { t, nx: hx / length, ny: hy / length };
188
+ }
189
+ // Clipping the segment by each edge of the convex polygon: where it enters last is where it meets it.
190
+ const n = shape.points.length / 2, [cx, cy] = centre(shape);
191
+ let enter = 0, leave = 1, nx = 0, ny = 0;
192
+ for (let i = 0; i < n; i++) {
193
+ const j = (i + 1) % n, px = shape.points[i * 2], py = shape.points[i * 2 + 1], ex = shape.points[j * 2] - px, ey = shape.points[j * 2 + 1] - py;
194
+ let ox = ey, oy = -ex;
195
+ // The outward normal of the edge, away from the middle of the polygon.
196
+ if ((px - cx) * ox + (py - cy) * oy < 0) {
197
+ ox = -ox;
198
+ oy = -oy;
199
+ }
200
+ const length = Math.hypot(ox, oy);
201
+ if (length === 0)
202
+ continue;
203
+ ox /= length;
204
+ oy /= length;
205
+ const numerator = (px - x0) * ox + (py - y0) * oy, denominator = dx * ox + dy * oy;
206
+ if (denominator === 0) {
207
+ if (numerator < 0)
208
+ return undefined;
209
+ continue;
210
+ }
211
+ const t = numerator / denominator;
212
+ if (denominator < 0) {
213
+ if (t > enter) {
214
+ enter = t;
215
+ nx = ox;
216
+ ny = oy;
217
+ }
218
+ }
219
+ else if (t < leave)
220
+ leave = t;
221
+ if (enter > leave)
222
+ return undefined;
223
+ }
224
+ // A segment that starts inside does not meet the shape from outside.
225
+ if (nx === 0 && ny === 0)
226
+ return undefined;
227
+ // No negative zero in what is told.
228
+ return { t: enter, nx: nx + 0, ny: ny + 0 };
229
+ }
230
+ //# sourceMappingURL=physics2dGeometry.js.map
@@ -0,0 +1,221 @@
1
+ import type { DisplayObject } from '@egret/runtime';
2
+ /** A 2D vector of the physics world. */
3
+ export interface PhysicsVector {
4
+ readonly x: number;
5
+ readonly y: number;
6
+ }
7
+ /** A shape about the place of its body. A box and a polygon turn with the body; a circle has no turn to show. */
8
+ export type PhysicsShape = {
9
+ readonly kind: 'circle';
10
+ readonly radius: number;
11
+ } | {
12
+ readonly kind: 'box';
13
+ readonly width: number;
14
+ readonly height: number;
15
+ } | {
16
+ readonly kind: 'polygon';
17
+ readonly points: readonly PhysicsVector[];
18
+ };
19
+ /** A static body never moves; a kinematic one moves by its speed alone and pushes; a dynamic one is moved by everything. */
20
+ export type PhysicsBodyKind = 'static' | 'kinematic' | 'dynamic';
21
+ /** A body to add: its kind and shape, where it is and how it moves, its material, its layers and what it moves. */
22
+ export interface PhysicsBodyOptions {
23
+ readonly kind?: PhysicsBodyKind;
24
+ readonly shape: PhysicsShape;
25
+ readonly x?: number;
26
+ readonly y?: number;
27
+ /** Degrees. */
28
+ readonly angle?: number;
29
+ readonly vx?: number;
30
+ readonly vy?: number;
31
+ /** Mass for each unit of area of a dynamic body. Defaults to 1. */
32
+ readonly density?: number;
33
+ /** How much of the speed into a contact comes back out of it, 0 to 1. Defaults to 0. */
34
+ readonly restitution?: number;
35
+ /** How much a contact holds against sliding, 0 to 1 and more. Defaults to 0.3. */
36
+ readonly friction?: number;
37
+ /** How much of the world's gravity the body feels. Defaults to 1. */
38
+ readonly gravityScale?: number;
39
+ /** The groups the body is in, and the groups it meets, as bits. Default to 1 and every group. */
40
+ readonly layer?: number;
41
+ readonly mask?: number;
42
+ /** A sensor tells of what enters and leaves it and pushes nothing. */
43
+ readonly sensor?: boolean;
44
+ /** A display object placed where the body is, and turned as it is, after each step. */
45
+ readonly display?: DisplayObject;
46
+ /** Whatever the game keeps with the body. */
47
+ readonly data?: unknown;
48
+ }
49
+ /** A body in the physics world: its place and motion, its material and layers, and the calls that push it. */
50
+ export interface PhysicsBody {
51
+ readonly id: number;
52
+ /** What it is now; `setKind` changes it. */
53
+ readonly kind: PhysicsBodyKind;
54
+ readonly shape: PhysicsShape;
55
+ /** Infinity unless it is dynamic. */
56
+ readonly mass: number;
57
+ readonly sensor: boolean;
58
+ readonly state: 'active' | 'removed';
59
+ x: number;
60
+ y: number;
61
+ angle: number;
62
+ vx: number;
63
+ vy: number;
64
+ restitution: number;
65
+ friction: number;
66
+ gravityScale: number;
67
+ layer: number;
68
+ mask: number;
69
+ data: unknown;
70
+ /** Adds speed at once: an impulse divided by the mass. */
71
+ applyImpulse(x: number, y: number): void;
72
+ /** Adds to the force on the body for the next step. */
73
+ applyForce(x: number, y: number): void;
74
+ /**
75
+ * Makes it static, kinematic or dynamic, keeping its place, its contacts, its joints and what the game keeps with it:
76
+ * a weight held up until its rope is cut, a crate that falls once struck. A static body stops; one made dynamic has the
77
+ * mass of its density, as given when it was added. The change takes effect from the next step.
78
+ */
79
+ setKind(kind: PhysicsBodyKind): void;
80
+ /** The box around the body, in the world. */
81
+ bounds(): {
82
+ readonly x: number;
83
+ readonly y: number;
84
+ readonly width: number;
85
+ readonly height: number;
86
+ };
87
+ }
88
+ /**
89
+ * A joint to add between two bodies, or between a body and a fixed point of the world. `'distance'` keeps the two
90
+ * anchors at one length, as a rod; `'rope'` keeps them no further apart than it, and lets them come closer, as a rope.
91
+ * A distance joint of length 0 pins a body to a point, as a pendulum's bob is pinned to its string.
92
+ */
93
+ export interface PhysicsJointOptions {
94
+ readonly kind: 'distance' | 'rope';
95
+ readonly a: PhysicsBody;
96
+ /** The other body. Without it the joint holds `a` to `point`, a place in the world. */
97
+ readonly b?: PhysicsBody;
98
+ readonly point?: PhysicsVector;
99
+ /** Where on each body the joint is held, from its centre, turned with the body's angle. Default to the centre. */
100
+ readonly anchorA?: PhysicsVector;
101
+ readonly anchorB?: PhysicsVector;
102
+ /** Defaults to the distance between the anchors when the joint is added. */
103
+ readonly length?: number;
104
+ /** How firmly a distance joint keeps its length, from above 0 (a soft spring) to 1 (a rod). Defaults to 1. */
105
+ readonly stiffness?: number;
106
+ }
107
+ /** A joint of the world: its kind, its bodies and its length, which can change, as a rope that is wound in. */
108
+ export interface PhysicsJoint {
109
+ readonly kind: 'distance' | 'rope';
110
+ readonly a: PhysicsBody;
111
+ readonly b: PhysicsBody | undefined;
112
+ readonly state: 'active' | 'removed';
113
+ length: number;
114
+ /** How far apart its anchors are now. */
115
+ distance(): number;
116
+ }
117
+ /** Two bodies that began or ended touching, with the normal between them. */
118
+ export interface PhysicsContact {
119
+ readonly type: 'begin' | 'end';
120
+ readonly a: PhysicsBody;
121
+ readonly b: PhysicsBody;
122
+ /** From a to b, at the moment the contact began or was last seen. */
123
+ readonly normal: PhysicsVector;
124
+ /** One of the two is a sensor: nothing was pushed. */
125
+ readonly sensor: boolean;
126
+ }
127
+ /** What a ray hit: the body, where, its normal, and how far along the ray. */
128
+ export interface PhysicsRayHit {
129
+ readonly body: PhysicsBody;
130
+ readonly point: PhysicsVector;
131
+ readonly normal: PhysicsVector;
132
+ /** How far along the ray, from 0 at its start to 1 at its end. */
133
+ readonly fraction: number;
134
+ }
135
+ /** Where a moved body ended up, and the normals of what it hit on the way. */
136
+ export interface PhysicsMoveResult {
137
+ readonly x: number;
138
+ readonly y: number;
139
+ /** Whether anything stopped any of the movement. */
140
+ readonly collided: boolean;
141
+ /** The normals of what it slid along, pointing away from it. */
142
+ readonly normals: readonly PhysicsVector[];
143
+ }
144
+ /** A physics world to make: its gravity, its step and iterations, and its limits. */
145
+ export interface PhysicsWorldOptions {
146
+ /** Units a second, every second. Defaults to 0 across and 0 down. */
147
+ readonly gravity?: PhysicsVector;
148
+ /** The seconds of one step. A step is always this long, whatever time is given. Defaults to 1/60. */
149
+ readonly fixedStep?: number;
150
+ /** The most steps one update takes, so that a long pause does not freeze the game catching up. Defaults to 8. */
151
+ readonly maxSteps?: number;
152
+ /** Rounds of resolving contacts each step. Defaults to 8. */
153
+ readonly iterations?: number;
154
+ /** Bodies that meet slower than this, in units a second, do not bounce, so that what rests stays at rest. Defaults to twice the
155
+ * speed gravity gives in one step, and at least 1. */
156
+ readonly bounceThreshold?: number;
157
+ /** The side of a cell of the grid that finds which bodies may touch. Defaults to 64. */
158
+ readonly cellSize?: number;
159
+ /** The most bodies, 1 to 65536. Defaults to 4096. */
160
+ readonly maxBodies?: number;
161
+ }
162
+ /** A grid of solid tiles to collide with: its size in tiles, its tile size, which are solid and where it is. */
163
+ export interface PhysicsTileColliders {
164
+ readonly columns: number;
165
+ readonly rows: number;
166
+ readonly tileWidth: number;
167
+ readonly tileHeight: number;
168
+ /** Whether a cell is solid. Solid cells next to each other are made into as few boxes as can be. */
169
+ solid(column: number, row: number): boolean;
170
+ /** Where cell (0, 0) begins in the world. Defaults to (0, 0). */
171
+ readonly x?: number;
172
+ readonly y?: number;
173
+ readonly layer?: number;
174
+ readonly friction?: number;
175
+ }
176
+ /** The physics world as it is now: its bodies, contacts and steps. */
177
+ export interface PhysicsSnapshot {
178
+ readonly bodies: number;
179
+ readonly contacts: number;
180
+ readonly steps: number;
181
+ /** Seconds given but not yet stepped. */
182
+ readonly pending: number;
183
+ }
184
+ /** A world of 2D bodies that collide, without turning: simple, steady physics for a 2D game. It keeps no clock. */
185
+ export interface PhysicsWorld {
186
+ readonly state: 'active' | 'closed';
187
+ gravity: PhysicsVector;
188
+ readonly bodies: readonly PhysicsBody[];
189
+ addBody(options: PhysicsBodyOptions): PhysicsBody;
190
+ removeBody(body: PhysicsBody): void;
191
+ /** Static boxes for the solid cells of a grid, such as the walls of a tile map. */
192
+ addTileColliders(grid: PhysicsTileColliders): readonly PhysicsBody[];
193
+ /** Takes the time given in fixed steps, and leaves the rest for the next update. Returns the steps taken. */
194
+ step(seconds: number): number;
195
+ /** Joins two bodies, or a body and a point. A joint goes with either of its bodies when that is removed. */
196
+ addJoint(options: PhysicsJointOptions): PhysicsJoint;
197
+ removeJoint(joint: PhysicsJoint): void;
198
+ readonly joints: readonly PhysicsJoint[];
199
+ /**
200
+ * Told each contact that begins and ends, after the step it happened in, once that step is done. A listener may change
201
+ * the world: add and remove bodies and joints, push bodies, change their kind. What it changes takes effect from the
202
+ * next step, and a body it removes tells the end of its contacts at once. It may not call `step`.
203
+ */
204
+ onContact(listener: (contact: PhysicsContact) => void): () => void;
205
+ /** The bodies whose shapes hold a point, or meet a rectangle. */
206
+ queryPoint(x: number, y: number, mask?: number): readonly PhysicsBody[];
207
+ queryRect(rect: {
208
+ readonly x: number;
209
+ readonly y: number;
210
+ readonly width: number;
211
+ readonly height: number;
212
+ }, mask?: number): readonly PhysicsBody[];
213
+ /** The first body a segment meets, sensors left out. */
214
+ raycast(from: PhysicsVector, to: PhysicsVector, mask?: number): PhysicsRayHit | undefined;
215
+ /** Moves a body by a distance at once, sliding along what is solid instead of passing into it. For characters. */
216
+ moveAndSlide(body: PhysicsBody, dx: number, dy: number): PhysicsMoveResult;
217
+ snapshot(): PhysicsSnapshot;
218
+ /** Removes every body. A scope can own a world through this. */
219
+ dispose(): void;
220
+ }
221
+ //# sourceMappingURL=physics2dTypes.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=physics2dTypes.js.map
@@ -0,0 +1,4 @@
1
+ import type { PhysicsWorld, PhysicsWorldOptions } from './physics2dTypes.js';
2
+ /** A world of bodies that move, meet and push each other apart, in fixed steps, without turning. */
3
+ export declare function createPhysicsWorld(options?: PhysicsWorldOptions): PhysicsWorld;
4
+ //# sourceMappingURL=physics2dWorld.d.ts.map