@aura3d/engine 2.0.4 → 3.0.1

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 (824) hide show
  1. package/README.md +45 -11
  2. package/dist/animation/AnimationAction.d.ts.map +1 -1
  3. package/dist/animation/AnimationAction.js +20 -2
  4. package/dist/animation/AnimationAction.js.map +1 -1
  5. package/dist/animation/AnimationLayer.d.ts +1 -0
  6. package/dist/animation/AnimationLayer.d.ts.map +1 -1
  7. package/dist/animation/AnimationLayer.js +24 -3
  8. package/dist/animation/AnimationLayer.js.map +1 -1
  9. package/dist/animation/AnimationMixer.d.ts +7 -1
  10. package/dist/animation/AnimationMixer.d.ts.map +1 -1
  11. package/dist/animation/AnimationMixer.js +105 -34
  12. package/dist/animation/AnimationMixer.js.map +1 -1
  13. package/dist/animation/AnimationTrack.d.ts.map +1 -1
  14. package/dist/animation/AnimationTrack.js +13 -0
  15. package/dist/animation/AnimationTrack.js.map +1 -1
  16. package/dist/animation/FootIk.d.ts +19 -0
  17. package/dist/animation/FootIk.d.ts.map +1 -1
  18. package/dist/animation/FootIk.js +113 -7
  19. package/dist/animation/FootIk.js.map +1 -1
  20. package/dist/animation/HumanoidRetargeting.d.ts +35 -2
  21. package/dist/animation/HumanoidRetargeting.d.ts.map +1 -1
  22. package/dist/animation/HumanoidRetargeting.js +59 -9
  23. package/dist/animation/HumanoidRetargeting.js.map +1 -1
  24. package/dist/animation/LocomotionEvidence.d.ts +34 -0
  25. package/dist/animation/LocomotionEvidence.d.ts.map +1 -0
  26. package/dist/animation/LocomotionEvidence.js +48 -0
  27. package/dist/animation/LocomotionEvidence.js.map +1 -0
  28. package/dist/animation/LocomotionKit.d.ts +6 -0
  29. package/dist/animation/LocomotionKit.d.ts.map +1 -1
  30. package/dist/animation/LocomotionKit.js +6 -0
  31. package/dist/animation/LocomotionKit.js.map +1 -1
  32. package/dist/animation/RootMotion.d.ts +36 -0
  33. package/dist/animation/RootMotion.d.ts.map +1 -1
  34. package/dist/animation/RootMotion.js +58 -0
  35. package/dist/animation/RootMotion.js.map +1 -1
  36. package/dist/animation/SpringBones.d.ts +28 -0
  37. package/dist/animation/SpringBones.d.ts.map +1 -1
  38. package/dist/animation/SpringBones.js +24 -0
  39. package/dist/animation/SpringBones.js.map +1 -1
  40. package/dist/animation/index.d.ts +1 -0
  41. package/dist/animation/index.d.ts.map +1 -1
  42. package/dist/animation/index.js +1 -0
  43. package/dist/animation/index.js.map +1 -1
  44. package/dist/assets/GLTFAnimationRuntime.d.ts +175 -2
  45. package/dist/assets/GLTFAnimationRuntime.d.ts.map +1 -1
  46. package/dist/assets/GLTFAnimationRuntime.js +615 -5
  47. package/dist/assets/GLTFAnimationRuntime.js.map +1 -1
  48. package/dist/assets/GLTFCompressionDecoders.d.ts +1 -0
  49. package/dist/assets/GLTFCompressionDecoders.d.ts.map +1 -1
  50. package/dist/assets/GLTFCompressionDecoders.js +20 -5
  51. package/dist/assets/GLTFCompressionDecoders.js.map +1 -1
  52. package/dist/assets/GLTFExtensionSupport.js +2 -2
  53. package/dist/assets/GLTFExtensionSupport.js.map +1 -1
  54. package/dist/assets/GLTFLoader.d.ts +360 -1
  55. package/dist/assets/GLTFLoader.d.ts.map +1 -1
  56. package/dist/assets/GLTFLoader.js +218 -8
  57. package/dist/assets/GLTFLoader.js.map +1 -1
  58. package/dist/assets/KTX2BasisTextureTranscoder.d.ts +39 -0
  59. package/dist/assets/KTX2BasisTextureTranscoder.d.ts.map +1 -1
  60. package/dist/assets/KTX2BasisTextureTranscoder.js +78 -0
  61. package/dist/assets/KTX2BasisTextureTranscoder.js.map +1 -1
  62. package/dist/assets/TexturePipeline.d.ts +20 -0
  63. package/dist/assets/TexturePipeline.d.ts.map +1 -1
  64. package/dist/assets/TexturePipeline.js +20 -0
  65. package/dist/assets/TexturePipeline.js.map +1 -1
  66. package/dist/assets/TextureStreaming.d.ts +30 -0
  67. package/dist/assets/TextureStreaming.d.ts.map +1 -1
  68. package/dist/assets/TextureStreaming.js +53 -0
  69. package/dist/assets/TextureStreaming.js.map +1 -1
  70. package/dist/assets/browser-index.d.ts +7 -3
  71. package/dist/assets/browser-index.d.ts.map +1 -1
  72. package/dist/assets/browser-index.js +3 -1
  73. package/dist/assets/browser-index.js.map +1 -1
  74. package/dist/assets/gltf-runtime.d.ts +1 -1
  75. package/dist/assets/gltf-runtime.d.ts.map +1 -1
  76. package/dist/assets/gltf-runtime.js.map +1 -1
  77. package/dist/assets/index.d.ts +7 -7
  78. package/dist/assets/index.d.ts.map +1 -1
  79. package/dist/assets/index.js +3 -3
  80. package/dist/assets/index.js.map +1 -1
  81. package/dist/assets/loaders/HDRLoader.d.ts +40 -0
  82. package/dist/assets/loaders/HDRLoader.d.ts.map +1 -1
  83. package/dist/assets/loaders/HDRLoader.js +158 -0
  84. package/dist/assets/loaders/HDRLoader.js.map +1 -1
  85. package/dist/audio/AudioSource.d.ts +2 -0
  86. package/dist/audio/AudioSource.d.ts.map +1 -1
  87. package/dist/audio/AudioSource.js +7 -0
  88. package/dist/audio/AudioSource.js.map +1 -1
  89. package/dist/audio/Footsteps.d.ts +47 -0
  90. package/dist/audio/Footsteps.d.ts.map +1 -0
  91. package/dist/audio/Footsteps.js +73 -0
  92. package/dist/audio/Footsteps.js.map +1 -0
  93. package/dist/audio/GameMixer.d.ts +69 -0
  94. package/dist/audio/GameMixer.d.ts.map +1 -0
  95. package/dist/audio/GameMixer.js +141 -0
  96. package/dist/audio/GameMixer.js.map +1 -0
  97. package/dist/audio/PositionalEmitter.d.ts +95 -0
  98. package/dist/audio/PositionalEmitter.d.ts.map +1 -0
  99. package/dist/audio/PositionalEmitter.js +199 -0
  100. package/dist/audio/PositionalEmitter.js.map +1 -0
  101. package/dist/audio/index.d.ts +6 -0
  102. package/dist/audio/index.d.ts.map +1 -1
  103. package/dist/audio/index.js +3 -0
  104. package/dist/audio/index.js.map +1 -1
  105. package/dist/aura3d-cli/pull-bridge/profiles.d.ts +12 -2
  106. package/dist/aura3d-cli/pull-bridge/profiles.d.ts.map +1 -1
  107. package/dist/aura3d-cli/pull-bridge/profiles.js +35 -4
  108. package/dist/aura3d-cli/pull-bridge/profiles.js.map +1 -1
  109. package/dist/aura3d-cli/pull-bridge/provenance.d.ts +15 -1
  110. package/dist/aura3d-cli/pull-bridge/provenance.d.ts.map +1 -1
  111. package/dist/aura3d-cli/pull-bridge/provenance.js +60 -1
  112. package/dist/aura3d-cli/pull-bridge/provenance.js.map +1 -1
  113. package/dist/aura3d-cli/pull-bridge/scoring.d.ts +10 -1
  114. package/dist/aura3d-cli/pull-bridge/scoring.d.ts.map +1 -1
  115. package/dist/aura3d-cli/pull-bridge/scoring.js +9 -1
  116. package/dist/aura3d-cli/pull-bridge/scoring.js.map +1 -1
  117. package/dist/aura3d-cli/pull-bridge/search.js +2 -2
  118. package/dist/aura3d-cli/pull-bridge/search.js.map +1 -1
  119. package/dist/aura3d-cli/pull-bridge.d.ts +15 -3
  120. package/dist/aura3d-cli/pull-bridge.d.ts.map +1 -1
  121. package/dist/aura3d-cli/pull-bridge.js +68 -5
  122. package/dist/aura3d-cli/pull-bridge.js.map +1 -1
  123. package/dist/controls/ArcballControls.d.ts +92 -0
  124. package/dist/controls/ArcballControls.d.ts.map +1 -0
  125. package/dist/controls/ArcballControls.js +286 -0
  126. package/dist/controls/ArcballControls.js.map +1 -0
  127. package/dist/controls/DragControls.d.ts +13 -0
  128. package/dist/controls/DragControls.d.ts.map +1 -1
  129. package/dist/controls/DragControls.js +24 -1
  130. package/dist/controls/DragControls.js.map +1 -1
  131. package/dist/controls/FlyControls.d.ts +9 -0
  132. package/dist/controls/FlyControls.d.ts.map +1 -1
  133. package/dist/controls/FlyControls.js +20 -2
  134. package/dist/controls/FlyControls.js.map +1 -1
  135. package/dist/controls/FocusFrame.d.ts +34 -0
  136. package/dist/controls/FocusFrame.d.ts.map +1 -0
  137. package/dist/controls/FocusFrame.js +82 -0
  138. package/dist/controls/FocusFrame.js.map +1 -0
  139. package/dist/controls/HoverOutline.d.ts +46 -0
  140. package/dist/controls/HoverOutline.d.ts.map +1 -0
  141. package/dist/controls/HoverOutline.js +87 -0
  142. package/dist/controls/HoverOutline.js.map +1 -0
  143. package/dist/controls/InteractionControls.d.ts +7 -0
  144. package/dist/controls/InteractionControls.d.ts.map +1 -1
  145. package/dist/controls/InteractionControls.js +12 -1
  146. package/dist/controls/InteractionControls.js.map +1 -1
  147. package/dist/controls/MapControls.d.ts +1 -1
  148. package/dist/controls/MapControls.d.ts.map +1 -1
  149. package/dist/controls/MapControls.js +3 -3
  150. package/dist/controls/MapControls.js.map +1 -1
  151. package/dist/controls/NativeControlTypes.d.ts +17 -0
  152. package/dist/controls/NativeControlTypes.d.ts.map +1 -1
  153. package/dist/controls/NativeControlTypes.js.map +1 -1
  154. package/dist/controls/OrbitControls.d.ts +26 -3
  155. package/dist/controls/OrbitControls.d.ts.map +1 -1
  156. package/dist/controls/OrbitControls.js +48 -11
  157. package/dist/controls/OrbitControls.js.map +1 -1
  158. package/dist/controls/Picking.d.ts +15 -0
  159. package/dist/controls/Picking.d.ts.map +1 -1
  160. package/dist/controls/Picking.js +62 -23
  161. package/dist/controls/Picking.js.map +1 -1
  162. package/dist/controls/PointerLockControls.d.ts.map +1 -1
  163. package/dist/controls/PointerLockControls.js +4 -0
  164. package/dist/controls/PointerLockControls.js.map +1 -1
  165. package/dist/controls/SelectionManager.d.ts +8 -0
  166. package/dist/controls/SelectionManager.d.ts.map +1 -1
  167. package/dist/controls/SelectionManager.js +11 -0
  168. package/dist/controls/SelectionManager.js.map +1 -1
  169. package/dist/controls/TrackballControls.d.ts +7 -0
  170. package/dist/controls/TrackballControls.d.ts.map +1 -1
  171. package/dist/controls/TrackballControls.js +21 -5
  172. package/dist/controls/TrackballControls.js.map +1 -1
  173. package/dist/controls/TransformControls.d.ts +8 -0
  174. package/dist/controls/TransformControls.d.ts.map +1 -1
  175. package/dist/controls/TransformControls.js +15 -2
  176. package/dist/controls/TransformControls.js.map +1 -1
  177. package/dist/controls/index.d.ts +6 -0
  178. package/dist/controls/index.d.ts.map +1 -1
  179. package/dist/controls/index.js +3 -0
  180. package/dist/controls/index.js.map +1 -1
  181. package/dist/create-aura3d/index.js +1 -1
  182. package/dist/editor-runtime/RootEditorSurface.d.ts +65 -0
  183. package/dist/editor-runtime/RootEditorSurface.d.ts.map +1 -0
  184. package/dist/editor-runtime/RootEditorSurface.js +62 -0
  185. package/dist/editor-runtime/RootEditorSurface.js.map +1 -0
  186. package/dist/editor-runtime/index.d.ts +2 -0
  187. package/dist/editor-runtime/index.d.ts.map +1 -1
  188. package/dist/editor-runtime/index.js +1 -0
  189. package/dist/editor-runtime/index.js.map +1 -1
  190. package/dist/engine/agent-api/AnimationController.d.ts +14 -2
  191. package/dist/engine/agent-api/AnimationController.d.ts.map +1 -1
  192. package/dist/engine/agent-api/AnimationController.js +10 -1
  193. package/dist/engine/agent-api/AnimationController.js.map +1 -1
  194. package/dist/engine/agent-api/AnimationDebugOverlay.d.ts +56 -0
  195. package/dist/engine/agent-api/AnimationDebugOverlay.d.ts.map +1 -0
  196. package/dist/engine/agent-api/AnimationDebugOverlay.js +148 -0
  197. package/dist/engine/agent-api/AnimationDebugOverlay.js.map +1 -0
  198. package/dist/engine/agent-api/AnimationMixerBuilders.d.ts +41 -0
  199. package/dist/engine/agent-api/AnimationMixerBuilders.d.ts.map +1 -0
  200. package/dist/engine/agent-api/AnimationMixerBuilders.js +146 -0
  201. package/dist/engine/agent-api/AnimationMixerBuilders.js.map +1 -0
  202. package/dist/engine/agent-api/AssetDecoders.d.ts +17 -0
  203. package/dist/engine/agent-api/AssetDecoders.d.ts.map +1 -0
  204. package/dist/engine/agent-api/AssetDecoders.js +18 -0
  205. package/dist/engine/agent-api/AssetDecoders.js.map +1 -0
  206. package/dist/engine/agent-api/CameraProjection.d.ts +2 -0
  207. package/dist/engine/agent-api/CameraProjection.d.ts.map +1 -0
  208. package/dist/engine/agent-api/CameraProjection.js +2 -0
  209. package/dist/engine/agent-api/CameraProjection.js.map +1 -0
  210. package/dist/engine/agent-api/Decals.d.ts +174 -0
  211. package/dist/engine/agent-api/Decals.d.ts.map +1 -0
  212. package/dist/engine/agent-api/Decals.js +350 -0
  213. package/dist/engine/agent-api/Decals.js.map +1 -0
  214. package/dist/engine/agent-api/DeferredFrameResources.d.ts +2 -0
  215. package/dist/engine/agent-api/DeferredFrameResources.d.ts.map +1 -0
  216. package/dist/engine/agent-api/DeferredFrameResources.js +2 -0
  217. package/dist/engine/agent-api/DeferredFrameResources.js.map +1 -0
  218. package/dist/engine/agent-api/FootPlanting.d.ts +81 -0
  219. package/dist/engine/agent-api/FootPlanting.d.ts.map +1 -0
  220. package/dist/engine/agent-api/FootPlanting.js +61 -0
  221. package/dist/engine/agent-api/FootPlanting.js.map +1 -0
  222. package/dist/engine/agent-api/GameAppRuntime.d.ts +19 -0
  223. package/dist/engine/agent-api/GameAppRuntime.d.ts.map +1 -1
  224. package/dist/engine/agent-api/GameAppRuntime.js +37 -1
  225. package/dist/engine/agent-api/GameAppRuntime.js.map +1 -1
  226. package/dist/engine/agent-api/GameCameraRigs.d.ts +185 -0
  227. package/dist/engine/agent-api/GameCameraRigs.d.ts.map +1 -0
  228. package/dist/engine/agent-api/GameCameraRigs.js +419 -0
  229. package/dist/engine/agent-api/GameCameraRigs.js.map +1 -0
  230. package/dist/engine/agent-api/GameFeel.d.ts +100 -0
  231. package/dist/engine/agent-api/GameFeel.d.ts.map +1 -0
  232. package/dist/engine/agent-api/GameFeel.js +226 -0
  233. package/dist/engine/agent-api/GameFeel.js.map +1 -0
  234. package/dist/engine/agent-api/LabelTelemetry.d.ts +114 -0
  235. package/dist/engine/agent-api/LabelTelemetry.d.ts.map +1 -0
  236. package/dist/engine/agent-api/LabelTelemetry.js +130 -0
  237. package/dist/engine/agent-api/LabelTelemetry.js.map +1 -0
  238. package/dist/engine/agent-api/ModelInstanceMatrices.d.ts +2 -0
  239. package/dist/engine/agent-api/ModelInstanceMatrices.d.ts.map +1 -0
  240. package/dist/engine/agent-api/ModelInstanceMatrices.js +2 -0
  241. package/dist/engine/agent-api/ModelInstanceMatrices.js.map +1 -0
  242. package/dist/engine/agent-api/NavigationCrowds.d.ts +174 -0
  243. package/dist/engine/agent-api/NavigationCrowds.d.ts.map +1 -0
  244. package/dist/engine/agent-api/NavigationCrowds.js +176 -0
  245. package/dist/engine/agent-api/NavigationCrowds.js.map +1 -0
  246. package/dist/engine/agent-api/PhysicsRuntime.d.ts +61 -5
  247. package/dist/engine/agent-api/PhysicsRuntime.d.ts.map +1 -1
  248. package/dist/engine/agent-api/PhysicsRuntime.js +53 -21
  249. package/dist/engine/agent-api/PhysicsRuntime.js.map +1 -1
  250. package/dist/engine/agent-api/PngTexturePixels.d.ts +9 -0
  251. package/dist/engine/agent-api/PngTexturePixels.d.ts.map +1 -0
  252. package/dist/engine/agent-api/PngTexturePixels.js +53 -0
  253. package/dist/engine/agent-api/PngTexturePixels.js.map +1 -0
  254. package/dist/engine/agent-api/RootDiagnosticSnapshot.d.ts +2 -0
  255. package/dist/engine/agent-api/RootDiagnosticSnapshot.d.ts.map +1 -0
  256. package/dist/engine/agent-api/RootDiagnosticSnapshot.js +2 -0
  257. package/dist/engine/agent-api/RootDiagnosticSnapshot.js.map +1 -0
  258. package/dist/engine/agent-api/RootFrameClock.d.ts +2 -0
  259. package/dist/engine/agent-api/RootFrameClock.d.ts.map +1 -0
  260. package/dist/engine/agent-api/RootFrameClock.js +2 -0
  261. package/dist/engine/agent-api/RootFrameClock.js.map +1 -0
  262. package/dist/engine/agent-api/RootGeometry.d.ts +16 -1
  263. package/dist/engine/agent-api/RootGeometry.d.ts.map +1 -1
  264. package/dist/engine/agent-api/RootGeometry.js.map +1 -1
  265. package/dist/engine/agent-api/RootPerformanceQuality.d.ts +2 -0
  266. package/dist/engine/agent-api/RootPerformanceQuality.d.ts.map +1 -0
  267. package/dist/engine/agent-api/RootPerformanceQuality.js +2 -0
  268. package/dist/engine/agent-api/RootPerformanceQuality.js.map +1 -0
  269. package/dist/engine/agent-api/RootRuntimeSupport.d.ts +61 -0
  270. package/dist/engine/agent-api/RootRuntimeSupport.d.ts.map +1 -0
  271. package/dist/engine/agent-api/RootRuntimeSupport.js +127 -0
  272. package/dist/engine/agent-api/RootRuntimeSupport.js.map +1 -0
  273. package/dist/engine/agent-api/RuntimeNodeHandle.d.ts +28 -0
  274. package/dist/engine/agent-api/RuntimeNodeHandle.d.ts.map +1 -1
  275. package/dist/engine/agent-api/RuntimeNodeHandle.js.map +1 -1
  276. package/dist/engine/agent-api/Scatter.d.ts +18 -0
  277. package/dist/engine/agent-api/Scatter.d.ts.map +1 -0
  278. package/dist/engine/agent-api/Scatter.js +18 -0
  279. package/dist/engine/agent-api/Scatter.js.map +1 -0
  280. package/dist/engine/agent-api/TouchControlBinding.d.ts +32 -0
  281. package/dist/engine/agent-api/TouchControlBinding.d.ts.map +1 -1
  282. package/dist/engine/agent-api/TouchControlBinding.js +36 -0
  283. package/dist/engine/agent-api/TouchControlBinding.js.map +1 -1
  284. package/dist/engine/agent-api/VehicleChassis.d.ts.map +1 -1
  285. package/dist/engine/agent-api/VehicleChassis.js +76 -13
  286. package/dist/engine/agent-api/VehicleChassis.js.map +1 -1
  287. package/dist/engine/agent-api/WorldLabelRenderer.d.ts +13 -2
  288. package/dist/engine/agent-api/WorldLabelRenderer.d.ts.map +1 -1
  289. package/dist/engine/agent-api/WorldLabelRenderer.js +58 -26
  290. package/dist/engine/agent-api/WorldLabelRenderer.js.map +1 -1
  291. package/dist/engine/agent-api/index.d.ts +804 -7
  292. package/dist/engine/agent-api/index.d.ts.map +1 -1
  293. package/dist/engine/agent-api/index.js +2326 -195
  294. package/dist/engine/agent-api/index.js.map +1 -1
  295. package/dist/engine/agent-api/product-viewer-runtime.d.ts.map +1 -1
  296. package/dist/engine/game/GameAudio.d.ts +66 -0
  297. package/dist/engine/game/GameAudio.d.ts.map +1 -1
  298. package/dist/engine/game/GameAudio.js +179 -44
  299. package/dist/engine/game/GameAudio.js.map +1 -1
  300. package/dist/engine/instances-model/InstancedModel.d.ts +111 -0
  301. package/dist/engine/instances-model/InstancedModel.d.ts.map +1 -0
  302. package/dist/engine/instances-model/InstancedModel.js +108 -0
  303. package/dist/engine/instances-model/InstancedModel.js.map +1 -0
  304. package/dist/engine/material-physical/PhysicalMaterialSpec.d.ts +72 -0
  305. package/dist/engine/material-physical/PhysicalMaterialSpec.d.ts.map +1 -0
  306. package/dist/engine/material-physical/PhysicalMaterialSpec.js +95 -0
  307. package/dist/engine/material-physical/PhysicalMaterialSpec.js.map +1 -0
  308. package/dist/engine/production-runtime/GameAppRuntime.d.ts +1 -1
  309. package/dist/engine/production-runtime/GameAppRuntime.d.ts.map +1 -1
  310. package/dist/engine/production-runtime/GameRenderPreset.d.ts +76 -0
  311. package/dist/engine/production-runtime/GameRenderPreset.d.ts.map +1 -1
  312. package/dist/engine/production-runtime/GameRenderPreset.js +167 -0
  313. package/dist/engine/production-runtime/GameRenderPreset.js.map +1 -1
  314. package/dist/engine/production-runtime/RootGpuParticleWorkload.d.ts +34 -0
  315. package/dist/engine/production-runtime/RootGpuParticleWorkload.d.ts.map +1 -0
  316. package/dist/engine/production-runtime/RootGpuParticleWorkload.js +117 -0
  317. package/dist/engine/production-runtime/RootGpuParticleWorkload.js.map +1 -0
  318. package/dist/engine/production-runtime/RootRenderSourceBridge.d.ts +2 -0
  319. package/dist/engine/production-runtime/RootRenderSourceBridge.d.ts.map +1 -0
  320. package/dist/engine/production-runtime/RootRenderSourceBridge.js +2 -0
  321. package/dist/engine/production-runtime/RootRenderSourceBridge.js.map +1 -0
  322. package/dist/engine/production-runtime/TypedGLBActor.d.ts +28 -2
  323. package/dist/engine/production-runtime/TypedGLBActor.d.ts.map +1 -1
  324. package/dist/engine/production-runtime/TypedGLBActor.js +46 -1
  325. package/dist/engine/production-runtime/TypedGLBActor.js.map +1 -1
  326. package/dist/engine/production-runtime/index.d.ts +6 -4
  327. package/dist/engine/production-runtime/index.d.ts.map +1 -1
  328. package/dist/engine/production-runtime/index.js +7 -3
  329. package/dist/engine/production-runtime/index.js.map +1 -1
  330. package/dist/input/ActionMap.d.ts +40 -0
  331. package/dist/input/ActionMap.d.ts.map +1 -1
  332. package/dist/input/ActionMap.js +179 -0
  333. package/dist/input/ActionMap.js.map +1 -1
  334. package/dist/input/ComboDetector.d.ts +49 -0
  335. package/dist/input/ComboDetector.d.ts.map +1 -0
  336. package/dist/input/ComboDetector.js +102 -0
  337. package/dist/input/ComboDetector.js.map +1 -0
  338. package/dist/input/Haptics.d.ts +46 -0
  339. package/dist/input/Haptics.d.ts.map +1 -0
  340. package/dist/input/Haptics.js +67 -0
  341. package/dist/input/Haptics.js.map +1 -0
  342. package/dist/input/InputSystem.d.ts.map +1 -1
  343. package/dist/input/InputSystem.js +1 -0
  344. package/dist/input/InputSystem.js.map +1 -1
  345. package/dist/input/PointerDevice.d.ts +1 -0
  346. package/dist/input/PointerDevice.d.ts.map +1 -1
  347. package/dist/input/PointerDevice.js +1 -1
  348. package/dist/input/PointerDevice.js.map +1 -1
  349. package/dist/input/TouchLayouts.d.ts +35 -0
  350. package/dist/input/TouchLayouts.d.ts.map +1 -0
  351. package/dist/input/TouchLayouts.js +88 -0
  352. package/dist/input/TouchLayouts.js.map +1 -0
  353. package/dist/input/WebXRSessionController.d.ts +53 -0
  354. package/dist/input/WebXRSessionController.d.ts.map +1 -1
  355. package/dist/input/WebXRSessionController.js +88 -2
  356. package/dist/input/WebXRSessionController.js.map +1 -1
  357. package/dist/input/controls/OrbitControls.d.ts +44 -1
  358. package/dist/input/controls/OrbitControls.d.ts.map +1 -1
  359. package/dist/input/controls/OrbitControls.js +151 -12
  360. package/dist/input/controls/OrbitControls.js.map +1 -1
  361. package/dist/input/index.d.ts +8 -2
  362. package/dist/input/index.d.ts.map +1 -1
  363. package/dist/input/index.js +3 -0
  364. package/dist/input/index.js.map +1 -1
  365. package/dist/lean/base.d.ts +1 -1
  366. package/dist/lean/base.d.ts.map +1 -1
  367. package/dist/lean/base.js +1 -1
  368. package/dist/lean/base.js.map +1 -1
  369. package/dist/lean/game.d.ts +98 -0
  370. package/dist/lean/game.d.ts.map +1 -1
  371. package/dist/lean/game.js +192 -0
  372. package/dist/lean/game.js.map +1 -1
  373. package/dist/lean/index.js +1 -1
  374. package/dist/lean/index.js.map +1 -1
  375. package/dist/materials/GameReadyMaterialLibrary.d.ts +39 -0
  376. package/dist/materials/GameReadyMaterialLibrary.d.ts.map +1 -0
  377. package/dist/materials/GameReadyMaterialLibrary.js +253 -0
  378. package/dist/materials/GameReadyMaterialLibrary.js.map +1 -0
  379. package/dist/materials/MaterialValidation.d.ts +21 -0
  380. package/dist/materials/MaterialValidation.d.ts.map +1 -1
  381. package/dist/materials/MaterialValidation.js +105 -0
  382. package/dist/materials/MaterialValidation.js.map +1 -1
  383. package/dist/materials/browser-index.d.ts +2 -0
  384. package/dist/materials/browser-index.d.ts.map +1 -1
  385. package/dist/materials/browser-index.js +1 -0
  386. package/dist/materials/browser-index.js.map +1 -1
  387. package/dist/materials/node.d.ts +2 -2
  388. package/dist/materials/node.d.ts.map +1 -1
  389. package/dist/materials/node.js +1 -1
  390. package/dist/materials/node.js.map +1 -1
  391. package/dist/navigation-recast/index.d.ts +116 -0
  392. package/dist/navigation-recast/index.d.ts.map +1 -0
  393. package/dist/navigation-recast/index.js +247 -0
  394. package/dist/navigation-recast/index.js.map +1 -0
  395. package/dist/physics/CollisionVolumes.d.ts +59 -0
  396. package/dist/physics/CollisionVolumes.d.ts.map +1 -1
  397. package/dist/physics/CollisionVolumes.js +87 -0
  398. package/dist/physics/CollisionVolumes.js.map +1 -1
  399. package/dist/physics/PhysicsDebugDraw.d.ts +37 -0
  400. package/dist/physics/PhysicsDebugDraw.d.ts.map +1 -1
  401. package/dist/physics/PhysicsDebugDraw.js +38 -1
  402. package/dist/physics/PhysicsDebugDraw.js.map +1 -1
  403. package/dist/physics/PhysicsWorld.d.ts +15 -0
  404. package/dist/physics/PhysicsWorld.d.ts.map +1 -1
  405. package/dist/physics/PhysicsWorld.js +8 -1
  406. package/dist/physics/PhysicsWorld.js.map +1 -1
  407. package/dist/physics/solverless.d.ts +1 -1
  408. package/dist/physics/solverless.d.ts.map +1 -1
  409. package/dist/physics/solverless.js.map +1 -1
  410. package/dist/physics-rapier/HeightfieldLayout.d.ts +12 -0
  411. package/dist/physics-rapier/HeightfieldLayout.d.ts.map +1 -0
  412. package/dist/physics-rapier/HeightfieldLayout.js +19 -0
  413. package/dist/physics-rapier/HeightfieldLayout.js.map +1 -0
  414. package/dist/physics-rapier/index.d.ts +7 -1
  415. package/dist/physics-rapier/index.d.ts.map +1 -1
  416. package/dist/physics-rapier/index.js +3 -2
  417. package/dist/physics-rapier/index.js.map +1 -1
  418. package/dist/react/index.d.ts +136 -2
  419. package/dist/react/index.d.ts.map +1 -1
  420. package/dist/react/index.js +251 -10
  421. package/dist/react/index.js.map +1 -1
  422. package/dist/rendering/AtmosphereWetness.d.ts +61 -0
  423. package/dist/rendering/AtmosphereWetness.d.ts.map +1 -0
  424. package/dist/rendering/AtmosphereWetness.js +99 -0
  425. package/dist/rendering/AtmosphereWetness.js.map +1 -0
  426. package/dist/rendering/CascadedShadowMaps.d.ts.map +1 -1
  427. package/dist/rendering/CascadedShadowMaps.js +3 -1
  428. package/dist/rendering/CascadedShadowMaps.js.map +1 -1
  429. package/dist/rendering/ClusteredForwardLighting.d.ts +25 -1
  430. package/dist/rendering/ClusteredForwardLighting.d.ts.map +1 -1
  431. package/dist/rendering/ClusteredForwardLighting.js +80 -3
  432. package/dist/rendering/ClusteredForwardLighting.js.map +1 -1
  433. package/dist/rendering/DayNightSky.d.ts +63 -0
  434. package/dist/rendering/DayNightSky.d.ts.map +1 -0
  435. package/dist/rendering/DayNightSky.js +156 -0
  436. package/dist/rendering/DayNightSky.js.map +1 -0
  437. package/dist/rendering/EnvironmentPresetPack.d.ts +30 -0
  438. package/dist/rendering/EnvironmentPresetPack.d.ts.map +1 -0
  439. package/dist/rendering/EnvironmentPresetPack.js +49 -0
  440. package/dist/rendering/EnvironmentPresetPack.js.map +1 -0
  441. package/dist/rendering/ExtensionScalarAtlas.d.ts +18 -0
  442. package/dist/rendering/ExtensionScalarAtlas.d.ts.map +1 -0
  443. package/dist/rendering/ExtensionScalarAtlas.js +107 -0
  444. package/dist/rendering/ExtensionScalarAtlas.js.map +1 -0
  445. package/dist/rendering/ForwardPass.d.ts +65 -0
  446. package/dist/rendering/ForwardPass.d.ts.map +1 -1
  447. package/dist/rendering/ForwardPass.js +196 -2
  448. package/dist/rendering/ForwardPass.js.map +1 -1
  449. package/dist/rendering/InstancedPBRMaterial.d.ts +1 -0
  450. package/dist/rendering/InstancedPBRMaterial.d.ts.map +1 -1
  451. package/dist/rendering/InstancedPBRMaterial.js +3 -0
  452. package/dist/rendering/InstancedPBRMaterial.js.map +1 -1
  453. package/dist/rendering/InstancingDiagnostics.d.ts +69 -0
  454. package/dist/rendering/InstancingDiagnostics.d.ts.map +1 -0
  455. package/dist/rendering/InstancingDiagnostics.js +98 -0
  456. package/dist/rendering/InstancingDiagnostics.js.map +1 -0
  457. package/dist/rendering/LeanWebGL2Device.d.ts +265 -0
  458. package/dist/rendering/LeanWebGL2Device.d.ts.map +1 -0
  459. package/dist/rendering/LeanWebGL2Device.js +4001 -0
  460. package/dist/rendering/LeanWebGL2Device.js.map +1 -0
  461. package/dist/rendering/LightingRig.d.ts +19 -1
  462. package/dist/rendering/LightingRig.d.ts.map +1 -1
  463. package/dist/rendering/LightingRig.js +61 -1
  464. package/dist/rendering/LightingRig.js.map +1 -1
  465. package/dist/rendering/MaterialBinding.js +1 -1
  466. package/dist/rendering/MaterialBinding.js.map +1 -1
  467. package/dist/rendering/MeshConsolidation.d.ts +12 -0
  468. package/dist/rendering/MeshConsolidation.d.ts.map +1 -1
  469. package/dist/rendering/MeshConsolidation.js +28 -0
  470. package/dist/rendering/MeshConsolidation.js.map +1 -1
  471. package/dist/rendering/MorphTargetPlan.d.ts +29 -2
  472. package/dist/rendering/MorphTargetPlan.d.ts.map +1 -1
  473. package/dist/rendering/MorphTargetPlan.js +23 -4
  474. package/dist/rendering/MorphTargetPlan.js.map +1 -1
  475. package/dist/rendering/NormalMappedPBRMaterial.d.ts.map +1 -1
  476. package/dist/rendering/NormalMappedPBRMaterial.js +22 -2
  477. package/dist/rendering/NormalMappedPBRMaterial.js.map +1 -1
  478. package/dist/rendering/OceanSurface.d.ts +75 -0
  479. package/dist/rendering/OceanSurface.d.ts.map +1 -1
  480. package/dist/rendering/OceanSurface.js +211 -0
  481. package/dist/rendering/OceanSurface.js.map +1 -1
  482. package/dist/rendering/PBRMaterial.d.ts +1 -0
  483. package/dist/rendering/PBRMaterial.d.ts.map +1 -1
  484. package/dist/rendering/PBRMaterial.js +23 -2
  485. package/dist/rendering/PBRMaterial.js.map +1 -1
  486. package/dist/rendering/PbrReference.d.ts +48 -0
  487. package/dist/rendering/PbrReference.d.ts.map +1 -1
  488. package/dist/rendering/PbrReference.js +126 -0
  489. package/dist/rendering/PbrReference.js.map +1 -1
  490. package/dist/rendering/PlanarReflection.d.ts +221 -0
  491. package/dist/rendering/PlanarReflection.d.ts.map +1 -0
  492. package/dist/rendering/PlanarReflection.js +541 -0
  493. package/dist/rendering/PlanarReflection.js.map +1 -0
  494. package/dist/rendering/PostProcessPass.d.ts +32 -0
  495. package/dist/rendering/PostProcessPass.d.ts.map +1 -1
  496. package/dist/rendering/PostProcessPass.js +79 -36
  497. package/dist/rendering/PostProcessPass.js.map +1 -1
  498. package/dist/rendering/ProjectionMath.d.ts +3 -0
  499. package/dist/rendering/ProjectionMath.d.ts.map +1 -0
  500. package/dist/rendering/ProjectionMath.js +26 -0
  501. package/dist/rendering/ProjectionMath.js.map +1 -0
  502. package/dist/rendering/ReflectionSurfaces.d.ts +17 -0
  503. package/dist/rendering/ReflectionSurfaces.d.ts.map +1 -1
  504. package/dist/rendering/ReflectionSurfaces.js +103 -1
  505. package/dist/rendering/ReflectionSurfaces.js.map +1 -1
  506. package/dist/rendering/RenderDevice.d.ts +92 -0
  507. package/dist/rendering/RenderDevice.d.ts.map +1 -1
  508. package/dist/rendering/RenderDevice.js +85 -0
  509. package/dist/rendering/RenderDevice.js.map +1 -1
  510. package/dist/rendering/Renderer.d.ts +9 -0
  511. package/dist/rendering/Renderer.d.ts.map +1 -1
  512. package/dist/rendering/Renderer.js +97 -9
  513. package/dist/rendering/Renderer.js.map +1 -1
  514. package/dist/rendering/RendererPostprocessPlan.d.ts +64 -3
  515. package/dist/rendering/RendererPostprocessPlan.d.ts.map +1 -1
  516. package/dist/rendering/RendererPostprocessPlan.js +116 -12
  517. package/dist/rendering/RendererPostprocessPlan.js.map +1 -1
  518. package/dist/rendering/RendererVisualPipelineReport.d.ts.map +1 -1
  519. package/dist/rendering/RendererVisualPipelineReport.js +3 -1
  520. package/dist/rendering/RendererVisualPipelineReport.js.map +1 -1
  521. package/dist/rendering/Sampler.d.ts +29 -0
  522. package/dist/rendering/Sampler.d.ts.map +1 -1
  523. package/dist/rendering/Sampler.js +47 -0
  524. package/dist/rendering/Sampler.js.map +1 -1
  525. package/dist/rendering/ScreenSpaceReflectionPass.d.ts +43 -0
  526. package/dist/rendering/ScreenSpaceReflectionPass.d.ts.map +1 -0
  527. package/dist/rendering/ScreenSpaceReflectionPass.js +58 -0
  528. package/dist/rendering/ScreenSpaceReflectionPass.js.map +1 -0
  529. package/dist/rendering/SdfText.d.ts +250 -0
  530. package/dist/rendering/SdfText.d.ts.map +1 -0
  531. package/dist/rendering/SdfText.js +551 -0
  532. package/dist/rendering/SdfText.js.map +1 -0
  533. package/dist/rendering/ShaderChunks.d.ts.map +1 -1
  534. package/dist/rendering/ShaderChunks.js +30 -12
  535. package/dist/rendering/ShaderChunks.js.map +1 -1
  536. package/dist/rendering/ShaderLibrary.d.ts.map +1 -1
  537. package/dist/rendering/ShaderLibrary.js +601 -186
  538. package/dist/rendering/ShaderLibrary.js.map +1 -1
  539. package/dist/rendering/ShaderLibraryCore.d.ts +3 -0
  540. package/dist/rendering/ShaderLibraryCore.d.ts.map +1 -1
  541. package/dist/rendering/ShaderLibraryCore.js +73 -12
  542. package/dist/rendering/ShaderLibraryCore.js.map +1 -1
  543. package/dist/rendering/ShadowMap.d.ts +24 -0
  544. package/dist/rendering/ShadowMap.d.ts.map +1 -1
  545. package/dist/rendering/ShadowMap.js +43 -0
  546. package/dist/rendering/ShadowMap.js.map +1 -1
  547. package/dist/rendering/SkinnedLitMaterial.d.ts.map +1 -1
  548. package/dist/rendering/SkinnedLitMaterial.js +2 -0
  549. package/dist/rendering/SkinnedLitMaterial.js.map +1 -1
  550. package/dist/rendering/SkinningBounds.d.ts +10 -0
  551. package/dist/rendering/SkinningBounds.d.ts.map +1 -1
  552. package/dist/rendering/SkinningBounds.js +27 -0
  553. package/dist/rendering/SkinningBounds.js.map +1 -1
  554. package/dist/rendering/SpriteFlipbook.d.ts +60 -0
  555. package/dist/rendering/SpriteFlipbook.d.ts.map +1 -0
  556. package/dist/rendering/SpriteFlipbook.js +128 -0
  557. package/dist/rendering/SpriteFlipbook.js.map +1 -0
  558. package/dist/rendering/TemporalHistory.d.ts +37 -0
  559. package/dist/rendering/TemporalHistory.d.ts.map +1 -0
  560. package/dist/rendering/TemporalHistory.js +135 -0
  561. package/dist/rendering/TemporalHistory.js.map +1 -0
  562. package/dist/rendering/TemporalMath.d.ts +3 -0
  563. package/dist/rendering/TemporalMath.d.ts.map +1 -0
  564. package/dist/rendering/TemporalMath.js +9 -0
  565. package/dist/rendering/TemporalMath.js.map +1 -0
  566. package/dist/rendering/TerrainTiles.d.ts +120 -0
  567. package/dist/rendering/TerrainTiles.d.ts.map +1 -0
  568. package/dist/rendering/TerrainTiles.js +221 -0
  569. package/dist/rendering/TerrainTiles.js.map +1 -0
  570. package/dist/rendering/TexturedPBRMaterial.d.ts +4 -0
  571. package/dist/rendering/TexturedPBRMaterial.d.ts.map +1 -1
  572. package/dist/rendering/TexturedPBRMaterial.js +88 -5
  573. package/dist/rendering/TexturedPBRMaterial.js.map +1 -1
  574. package/dist/rendering/TexturedUnlitMaterial.d.ts.map +1 -1
  575. package/dist/rendering/TexturedUnlitMaterial.js +20 -2
  576. package/dist/rendering/TexturedUnlitMaterial.js.map +1 -1
  577. package/dist/rendering/UnlitMaterial.d.ts.map +1 -1
  578. package/dist/rendering/UnlitMaterial.js +20 -2
  579. package/dist/rendering/UnlitMaterial.js.map +1 -1
  580. package/dist/rendering/VertexFormat.d.ts +6 -0
  581. package/dist/rendering/VertexFormat.d.ts.map +1 -1
  582. package/dist/rendering/VertexFormat.js +12 -0
  583. package/dist/rendering/VertexFormat.js.map +1 -1
  584. package/dist/rendering/VolumetricFog.d.ts +55 -0
  585. package/dist/rendering/VolumetricFog.d.ts.map +1 -0
  586. package/dist/rendering/VolumetricFog.js +91 -0
  587. package/dist/rendering/VolumetricFog.js.map +1 -0
  588. package/dist/rendering/WaterSurface.d.ts +77 -0
  589. package/dist/rendering/WaterSurface.d.ts.map +1 -0
  590. package/dist/rendering/WaterSurface.js +133 -0
  591. package/dist/rendering/WaterSurface.js.map +1 -0
  592. package/dist/rendering/WebGL2Device.d.ts +73 -0
  593. package/dist/rendering/WebGL2Device.d.ts.map +1 -1
  594. package/dist/rendering/WebGL2Device.js +836 -79
  595. package/dist/rendering/WebGL2Device.js.map +1 -1
  596. package/dist/rendering/WebGPUDevice.d.ts +62 -1
  597. package/dist/rendering/WebGPUDevice.d.ts.map +1 -1
  598. package/dist/rendering/WebGPUDevice.js +844 -51
  599. package/dist/rendering/WebGPUDevice.js.map +1 -1
  600. package/dist/rendering/WebGPUExtensionAtlas.d.ts +6 -0
  601. package/dist/rendering/WebGPUExtensionAtlas.d.ts.map +1 -0
  602. package/dist/rendering/WebGPUExtensionAtlas.js +225 -0
  603. package/dist/rendering/WebGPUExtensionAtlas.js.map +1 -0
  604. package/dist/rendering/WebGPUSkinningLimits.d.ts +40 -0
  605. package/dist/rendering/WebGPUSkinningLimits.d.ts.map +1 -1
  606. package/dist/rendering/WebGPUSkinningLimits.js +32 -0
  607. package/dist/rendering/WebGPUSkinningLimits.js.map +1 -1
  608. package/dist/rendering/effects/CollisionModule.d.ts +9 -0
  609. package/dist/rendering/effects/CollisionModule.d.ts.map +1 -1
  610. package/dist/rendering/effects/CollisionModule.js +10 -0
  611. package/dist/rendering/effects/CollisionModule.js.map +1 -1
  612. package/dist/rendering/effects/ColorModule.d.ts +7 -0
  613. package/dist/rendering/effects/ColorModule.d.ts.map +1 -1
  614. package/dist/rendering/effects/ColorModule.js +23 -0
  615. package/dist/rendering/effects/ColorModule.js.map +1 -1
  616. package/dist/rendering/effects/ForceModule.d.ts +35 -0
  617. package/dist/rendering/effects/ForceModule.d.ts.map +1 -1
  618. package/dist/rendering/effects/ForceModule.js +49 -0
  619. package/dist/rendering/effects/ForceModule.js.map +1 -1
  620. package/dist/rendering/effects/GPUParticleBackend.d.ts +188 -0
  621. package/dist/rendering/effects/GPUParticleBackend.d.ts.map +1 -1
  622. package/dist/rendering/effects/GPUParticleBackend.js +710 -1
  623. package/dist/rendering/effects/GPUParticleBackend.js.map +1 -1
  624. package/dist/rendering/effects/HeightfieldModule.d.ts +58 -0
  625. package/dist/rendering/effects/HeightfieldModule.d.ts.map +1 -0
  626. package/dist/rendering/effects/HeightfieldModule.js +129 -0
  627. package/dist/rendering/effects/HeightfieldModule.js.map +1 -0
  628. package/dist/rendering/effects/LightingModule.d.ts +34 -0
  629. package/dist/rendering/effects/LightingModule.d.ts.map +1 -0
  630. package/dist/rendering/effects/LightingModule.js +54 -0
  631. package/dist/rendering/effects/LightingModule.js.map +1 -0
  632. package/dist/rendering/effects/ParticleDiagnostics.d.ts +8 -0
  633. package/dist/rendering/effects/ParticleDiagnostics.d.ts.map +1 -1
  634. package/dist/rendering/effects/ParticleDiagnostics.js +3 -0
  635. package/dist/rendering/effects/ParticleDiagnostics.js.map +1 -1
  636. package/dist/rendering/effects/ParticleModule.d.ts +8 -0
  637. package/dist/rendering/effects/ParticleModule.d.ts.map +1 -1
  638. package/dist/rendering/effects/ParticleModule.js.map +1 -1
  639. package/dist/rendering/effects/ParticleRenderer.d.ts +20 -0
  640. package/dist/rendering/effects/ParticleRenderer.d.ts.map +1 -1
  641. package/dist/rendering/effects/ParticleRenderer.js +57 -7
  642. package/dist/rendering/effects/ParticleRenderer.js.map +1 -1
  643. package/dist/rendering/effects/ParticleSystem.d.ts +45 -1
  644. package/dist/rendering/effects/ParticleSystem.d.ts.map +1 -1
  645. package/dist/rendering/effects/ParticleSystem.js +373 -4
  646. package/dist/rendering/effects/ParticleSystem.js.map +1 -1
  647. package/dist/rendering/effects/ResidentGPUParticleRenderer.d.ts +158 -0
  648. package/dist/rendering/effects/ResidentGPUParticleRenderer.d.ts.map +1 -0
  649. package/dist/rendering/effects/ResidentGPUParticleRenderer.js +576 -0
  650. package/dist/rendering/effects/ResidentGPUParticleRenderer.js.map +1 -0
  651. package/dist/rendering/effects/SizeModule.d.ts +4 -0
  652. package/dist/rendering/effects/SizeModule.d.ts.map +1 -1
  653. package/dist/rendering/effects/SizeModule.js +16 -0
  654. package/dist/rendering/effects/SizeModule.js.map +1 -1
  655. package/dist/rendering/effects/SubEmitterModule.d.ts +61 -0
  656. package/dist/rendering/effects/SubEmitterModule.d.ts.map +1 -0
  657. package/dist/rendering/effects/SubEmitterModule.js +119 -0
  658. package/dist/rendering/effects/SubEmitterModule.js.map +1 -0
  659. package/dist/rendering/effects/TrailModule.d.ts +38 -0
  660. package/dist/rendering/effects/TrailModule.d.ts.map +1 -1
  661. package/dist/rendering/effects/TrailModule.js +95 -2
  662. package/dist/rendering/effects/TrailModule.js.map +1 -1
  663. package/dist/rendering/effects/TurbulenceModule.d.ts +43 -0
  664. package/dist/rendering/effects/TurbulenceModule.d.ts.map +1 -0
  665. package/dist/rendering/effects/TurbulenceModule.js +130 -0
  666. package/dist/rendering/effects/TurbulenceModule.js.map +1 -0
  667. package/dist/rendering/effects/index.d.ts +4 -0
  668. package/dist/rendering/effects/index.d.ts.map +1 -1
  669. package/dist/rendering/effects/index.js +4 -0
  670. package/dist/rendering/effects/index.js.map +1 -1
  671. package/dist/rendering/extension-scalar-atlas.d.ts +3 -0
  672. package/dist/rendering/extension-scalar-atlas.d.ts.map +1 -0
  673. package/dist/rendering/extension-scalar-atlas.js +2 -0
  674. package/dist/rendering/extension-scalar-atlas.js.map +1 -0
  675. package/dist/rendering/index.d.ts +58 -19
  676. package/dist/rendering/index.d.ts.map +1 -1
  677. package/dist/rendering/index.js +32 -10
  678. package/dist/rendering/index.js.map +1 -1
  679. package/dist/rendering/lean/LeanProductionRenderer.d.ts.map +1 -1
  680. package/dist/rendering/lean/LeanProductionRenderer.js +2 -2
  681. package/dist/rendering/lean/LeanProductionRenderer.js.map +1 -1
  682. package/dist/rendering/lean-core-runtime.d.ts +13 -0
  683. package/dist/rendering/lean-core-runtime.d.ts.map +1 -0
  684. package/dist/rendering/lean-core-runtime.js +10 -0
  685. package/dist/rendering/lean-core-runtime.js.map +1 -0
  686. package/dist/rendering/materials/MaterialExtensions.js +3 -3
  687. package/dist/rendering/materials/MaterialExtensions.js.map +1 -1
  688. package/dist/rendering/postprocess/NativeBloomPyramid.d.ts +44 -0
  689. package/dist/rendering/postprocess/NativeBloomPyramid.d.ts.map +1 -0
  690. package/dist/rendering/postprocess/NativeBloomPyramid.js +84 -0
  691. package/dist/rendering/postprocess/NativeBloomPyramid.js.map +1 -0
  692. package/dist/rendering/postprocess/NativeLdrEffectLuts.d.ts +10 -1
  693. package/dist/rendering/postprocess/NativeLdrEffectLuts.d.ts.map +1 -1
  694. package/dist/rendering/postprocess/NativeLdrEffectLuts.js +19 -2
  695. package/dist/rendering/postprocess/NativeLdrEffectLuts.js.map +1 -1
  696. package/dist/rendering/postprocess/index.d.ts +2 -0
  697. package/dist/rendering/postprocess/index.d.ts.map +1 -1
  698. package/dist/rendering/postprocess/index.js +1 -0
  699. package/dist/rendering/postprocess/index.js.map +1 -1
  700. package/dist/rendering/production-runtime/PBRHDRPipeline.d.ts +22 -0
  701. package/dist/rendering/production-runtime/PBRHDRPipeline.d.ts.map +1 -1
  702. package/dist/rendering/production-runtime/PBRHDRPipeline.js +125 -0
  703. package/dist/rendering/production-runtime/PBRHDRPipeline.js.map +1 -1
  704. package/dist/rendering/production-runtime/ProductionRendererTypes.d.ts +1 -0
  705. package/dist/rendering/production-runtime/ProductionRendererTypes.d.ts.map +1 -1
  706. package/dist/rendering/production-runtime/ProductionRendererTypes.js.map +1 -1
  707. package/dist/rendering/production-runtime/ProductionRuntimeRenderer.d.ts +3 -0
  708. package/dist/rendering/production-runtime/ProductionRuntimeRenderer.d.ts.map +1 -1
  709. package/dist/rendering/production-runtime/ProductionRuntimeRenderer.js +8 -1
  710. package/dist/rendering/production-runtime/ProductionRuntimeRenderer.js.map +1 -1
  711. package/dist/rendering/production-runtime/ProductionWebGL2Renderer.d.ts +4 -0
  712. package/dist/rendering/production-runtime/ProductionWebGL2Renderer.d.ts.map +1 -1
  713. package/dist/rendering/production-runtime/ProductionWebGL2Renderer.js +15 -0
  714. package/dist/rendering/production-runtime/ProductionWebGL2Renderer.js.map +1 -1
  715. package/dist/rendering/production-runtime/ProductionWebGPURenderer.d.ts +58 -0
  716. package/dist/rendering/production-runtime/ProductionWebGPURenderer.d.ts.map +1 -1
  717. package/dist/rendering/production-runtime/ProductionWebGPURenderer.js +127 -0
  718. package/dist/rendering/production-runtime/ProductionWebGPURenderer.js.map +1 -1
  719. package/dist/rendering/production-runtime/framegraph/FrameGraph.d.ts +4 -2
  720. package/dist/rendering/production-runtime/framegraph/FrameGraph.d.ts.map +1 -1
  721. package/dist/rendering/production-runtime/framegraph/FrameGraph.js +62 -4
  722. package/dist/rendering/production-runtime/framegraph/FrameGraph.js.map +1 -1
  723. package/dist/rendering/production-runtime/framegraph/NativeFrameGraphBindings.d.ts +32 -0
  724. package/dist/rendering/production-runtime/framegraph/NativeFrameGraphBindings.d.ts.map +1 -0
  725. package/dist/rendering/production-runtime/framegraph/NativeFrameGraphBindings.js +111 -0
  726. package/dist/rendering/production-runtime/framegraph/NativeFrameGraphBindings.js.map +1 -0
  727. package/dist/rendering/production-runtime/framegraph/RenderPass.d.ts +23 -0
  728. package/dist/rendering/production-runtime/framegraph/RenderPass.d.ts.map +1 -1
  729. package/dist/rendering/production-runtime/framegraph/RenderPass.js +87 -1
  730. package/dist/rendering/production-runtime/framegraph/RenderPass.js.map +1 -1
  731. package/dist/rendering/production-runtime/index.d.ts +7 -4
  732. package/dist/rendering/production-runtime/index.d.ts.map +1 -1
  733. package/dist/rendering/production-runtime/index.js +4 -2
  734. package/dist/rendering/production-runtime/index.js.map +1 -1
  735. package/dist/rendering/production-runtime/passes/DepthPrepass.d.ts +18 -1
  736. package/dist/rendering/production-runtime/passes/DepthPrepass.d.ts.map +1 -1
  737. package/dist/rendering/production-runtime/passes/DepthPrepass.js +41 -2
  738. package/dist/rendering/production-runtime/passes/DepthPrepass.js.map +1 -1
  739. package/dist/rendering/production-runtime/passes/FramegraphTopology.d.ts +13 -0
  740. package/dist/rendering/production-runtime/passes/FramegraphTopology.d.ts.map +1 -0
  741. package/dist/rendering/production-runtime/passes/FramegraphTopology.js +59 -0
  742. package/dist/rendering/production-runtime/passes/FramegraphTopology.js.map +1 -0
  743. package/dist/rendering/production-runtime/passes/OpaquePass.d.ts +19 -1
  744. package/dist/rendering/production-runtime/passes/OpaquePass.d.ts.map +1 -1
  745. package/dist/rendering/production-runtime/passes/OpaquePass.js +43 -2
  746. package/dist/rendering/production-runtime/passes/OpaquePass.js.map +1 -1
  747. package/dist/rendering/production-runtime/passes/ShadowPass.d.ts +19 -1
  748. package/dist/rendering/production-runtime/passes/ShadowPass.d.ts.map +1 -1
  749. package/dist/rendering/production-runtime/passes/ShadowPass.js +45 -2
  750. package/dist/rendering/production-runtime/passes/ShadowPass.js.map +1 -1
  751. package/dist/rendering/production-runtime/passes/SkyboxPass.d.ts +17 -1
  752. package/dist/rendering/production-runtime/passes/SkyboxPass.d.ts.map +1 -1
  753. package/dist/rendering/production-runtime/passes/SkyboxPass.js +41 -2
  754. package/dist/rendering/production-runtime/passes/SkyboxPass.js.map +1 -1
  755. package/dist/rendering/production-runtime/passes/ToneMappingPass.d.ts +26 -1
  756. package/dist/rendering/production-runtime/passes/ToneMappingPass.d.ts.map +1 -1
  757. package/dist/rendering/production-runtime/passes/ToneMappingPass.js +62 -2
  758. package/dist/rendering/production-runtime/passes/ToneMappingPass.js.map +1 -1
  759. package/dist/rendering/production-runtime/passes/TransparentPass.d.ts +19 -1
  760. package/dist/rendering/production-runtime/passes/TransparentPass.d.ts.map +1 -1
  761. package/dist/rendering/production-runtime/passes/TransparentPass.js +47 -2
  762. package/dist/rendering/production-runtime/passes/TransparentPass.js.map +1 -1
  763. package/dist/rendering/reflection-surfaces.d.ts +5 -0
  764. package/dist/rendering/reflection-surfaces.d.ts.map +1 -0
  765. package/dist/rendering/reflection-surfaces.js +3 -0
  766. package/dist/rendering/reflection-surfaces.js.map +1 -0
  767. package/dist/rendering/shadows/CascadeHysteresis.d.ts +67 -0
  768. package/dist/rendering/shadows/CascadeHysteresis.d.ts.map +1 -0
  769. package/dist/rendering/shadows/CascadeHysteresis.js +104 -0
  770. package/dist/rendering/shadows/CascadeHysteresis.js.map +1 -0
  771. package/dist/rendering/shadows/ContactShadows.d.ts +52 -0
  772. package/dist/rendering/shadows/ContactShadows.d.ts.map +1 -1
  773. package/dist/rendering/shadows/ContactShadows.js +122 -0
  774. package/dist/rendering/shadows/ContactShadows.js.map +1 -1
  775. package/dist/rendering/shadows/SpotShadowMaps.d.ts +77 -0
  776. package/dist/rendering/shadows/SpotShadowMaps.d.ts.map +1 -0
  777. package/dist/rendering/shadows/SpotShadowMaps.js +106 -0
  778. package/dist/rendering/shadows/SpotShadowMaps.js.map +1 -0
  779. package/dist/rendering/webgpu/WebGPUPostProcess.d.ts +2 -0
  780. package/dist/rendering/webgpu/WebGPUPostProcess.d.ts.map +1 -1
  781. package/dist/rendering/webgpu/WebGPUPostProcess.js +1 -0
  782. package/dist/rendering/webgpu/WebGPUPostProcess.js.map +1 -1
  783. package/dist/rendering/webgpu/WebGPUPostShaders.d.ts +77 -0
  784. package/dist/rendering/webgpu/WebGPUPostShaders.d.ts.map +1 -0
  785. package/dist/rendering/webgpu/WebGPUPostShaders.js +261 -0
  786. package/dist/rendering/webgpu/WebGPUPostShaders.js.map +1 -0
  787. package/dist/rendering/webgpu/WebGPUTemporal.d.ts +17 -0
  788. package/dist/rendering/webgpu/WebGPUTemporal.d.ts.map +1 -0
  789. package/dist/rendering/webgpu/WebGPUTemporal.js +64 -0
  790. package/dist/rendering/webgpu/WebGPUTemporal.js.map +1 -0
  791. package/dist/rendering/webgpu.d.ts +6 -0
  792. package/dist/rendering/webgpu.d.ts.map +1 -1
  793. package/dist/rendering/webgpu.js +4 -0
  794. package/dist/rendering/webgpu.js.map +1 -1
  795. package/dist/scene/Scene.d.ts +8 -1
  796. package/dist/scene/Scene.d.ts.map +1 -1
  797. package/dist/scene/Scene.js +12 -2
  798. package/dist/scene/Scene.js.map +1 -1
  799. package/dist/scripting/VisualGraphContext.d.ts +31 -0
  800. package/dist/scripting/VisualGraphContext.d.ts.map +1 -1
  801. package/dist/scripting/VisualGraphExecutor.d.ts.map +1 -1
  802. package/dist/scripting/VisualGraphExecutor.js +110 -0
  803. package/dist/scripting/VisualGraphExecutor.js.map +1 -1
  804. package/dist/scripting/VisualNodeCatalog.d.ts +1 -1
  805. package/dist/scripting/VisualNodeCatalog.d.ts.map +1 -1
  806. package/dist/scripting/VisualNodeCatalog.js +20 -0
  807. package/dist/scripting/VisualNodeCatalog.js.map +1 -1
  808. package/dist/scripting/VisualScriptingRoot.d.ts +96 -0
  809. package/dist/scripting/VisualScriptingRoot.d.ts.map +1 -0
  810. package/dist/scripting/VisualScriptingRoot.js +150 -0
  811. package/dist/scripting/VisualScriptingRoot.js.map +1 -0
  812. package/dist/scripting/index.d.ts +3 -1
  813. package/dist/scripting/index.d.ts.map +1 -1
  814. package/dist/scripting/index.js +1 -0
  815. package/dist/scripting/index.js.map +1 -1
  816. package/package.json +40 -25
  817. package/templates/cinematic-scene/package.json +2 -2
  818. package/templates/cinematic-scene/src/main.ts +14 -2
  819. package/templates/mini-game/package.json +2 -2
  820. package/templates/product-viewer/package.json +2 -2
  821. package/templates/production-asset-inspector/package.json +1 -1
  822. package/templates/production-material-studio/package.json +1 -1
  823. package/templates/production-product-configurator/package.json +1 -1
  824. package/templates/production-product-viewer/package.json +1 -1
@@ -1,4 +1,5 @@
1
1
  import { createFrameLoop } from "./FrameLoop.js";
2
+ import { createPerformanceGovernor } from "../production-runtime/GameRenderPreset.js";
2
3
  export function createGameAppRuntime(app, options = {}) {
3
4
  const loop = createFrameLoop({ ...options.loop, autoStart: false });
4
5
  const ownedInputs = new Set();
@@ -13,6 +14,31 @@ export function createGameAppRuntime(app, options = {}) {
13
14
  let resizeCount = 0;
14
15
  let disposeCount = 0;
15
16
  let lastResize;
17
+ const perfGovernorOptions = options.performanceBudget;
18
+ let governor = perfGovernorOptions
19
+ ? createPerformanceGovernor(perfGovernorOptions.mode, perfGovernorOptions.initial)
20
+ : undefined;
21
+ let lastPerf;
22
+ let perfPolls = 0;
23
+ const pollPerformance = (telemetry) => {
24
+ const governorOptions = perfGovernorOptions;
25
+ if (!governorOptions || !governor)
26
+ return undefined;
27
+ const sample = telemetry ?? governorOptions.sample?.();
28
+ if (!sample)
29
+ return lastPerf;
30
+ governor = governor.step(sample, governorOptions.budget);
31
+ governorOptions.apply?.(governor.settings);
32
+ perfPolls += 1;
33
+ lastPerf = {
34
+ mode: governor.mode,
35
+ telemetry: sample,
36
+ settings: governor.settings,
37
+ degraded: governor.degraded,
38
+ polls: perfPolls
39
+ };
40
+ return lastPerf;
41
+ };
16
42
  const loopFrameUnsubscribe = loop.onFrame((frame) => {
17
43
  app.step(frame.dt);
18
44
  });
@@ -62,7 +88,8 @@ export function createGameAppRuntime(app, options = {}) {
62
88
  activeInputControllers,
63
89
  ...(lastResize ? { lastResize } : {}),
64
90
  loop: loopSnapshot,
65
- app: app.evidence(evidenceOptions())
91
+ app: app.evidence(evidenceOptions()),
92
+ ...(lastPerf ? { perf: lastPerf } : {})
66
93
  };
67
94
  };
68
95
  const assertAlive = (method) => {
@@ -91,6 +118,9 @@ export function createGameAppRuntime(app, options = {}) {
91
118
  get evidence() {
92
119
  return snapshotEvidence();
93
120
  },
121
+ get perf() {
122
+ return lastPerf;
123
+ },
94
124
  start() {
95
125
  assertAlive("start");
96
126
  if (!started) {
@@ -127,8 +157,14 @@ export function createGameAppRuntime(app, options = {}) {
127
157
  assertAlive("step");
128
158
  stepCount += 1;
129
159
  loop.step(Math.max(0, dt));
160
+ if (perfGovernorOptions?.sample)
161
+ pollPerformance();
130
162
  return snapshotEvidence();
131
163
  },
164
+ pollPerformance(telemetry) {
165
+ assertAlive("pollPerformance");
166
+ return pollPerformance(telemetry);
167
+ },
132
168
  resize(width, height, pixelRatio = 1) {
133
169
  assertAlive("resize");
134
170
  const safeWidth = Math.max(1, Math.floor(width));
@@ -1 +1 @@
1
- {"version":3,"file":"GameAppRuntime.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/GameAppRuntime.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"GameAppRuntime.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/GameAppRuntime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,185 @@
1
+ /**
2
+ * Game camera rigs (muse3jsparity-PRD F2).
3
+ *
4
+ * Game cameras three.js does not ship: shoulder cam, collision-aware orbit
5
+ * (wall slide via caller-supplied ray/sphere probes, never teleports/clips),
6
+ * procedural trauma shake with decay, hit punch-in, and a per-frame
7
+ * `cameraEvidence` aggregator. Pure scene-math: no renderer, no DOM, no
8
+ * `three` imports. The caller owns frame presentation; every rig returns
9
+ * plain position/target/fov snapshots plus evidence the route can publish.
10
+ *
11
+ * Follow-rig unification (PRD N2.2): `createFollowRig` below is the
12
+ * root-adjacent canonical follow camera. It implements the same
13
+ * offset-plus-exponential-damping algorithm as
14
+ * `ThirdPersonFollowControls` in `@aura3d/input`; that class remains the
15
+ * direct-camera-mutation adapter, while this module owns the algorithm
16
+ * contract (`FOLLOW_DAMPING_CONTRACT`). `asInputOptions()` converts one
17
+ * options object into the input adapter's shape so the two can never
18
+ * diverge. P1 pairs with N2 via this interface (reported, ledger untouched).
19
+ */
20
+ import type { GameVec3 } from "./GameRuntime.js";
21
+ export type GameCameraRigVec3 = GameVec3;
22
+ export interface GameCameraRigTarget {
23
+ readonly position: GameCameraRigVec3;
24
+ /** Yaw radians. 0 faces -Z; forward = [sin(yaw), 0, -cos(yaw)]. */
25
+ readonly facing?: number;
26
+ }
27
+ export interface GameCameraRigSnapshot {
28
+ readonly kind: string;
29
+ readonly position: GameCameraRigVec3;
30
+ readonly target: GameCameraRigVec3;
31
+ readonly fov: number;
32
+ }
33
+ export interface GameCameraEvidence {
34
+ readonly kind: "aura-game-camera-evidence";
35
+ readonly position: GameCameraRigVec3;
36
+ readonly target: GameCameraRigVec3;
37
+ readonly fov: number;
38
+ readonly shakeEnergy: number;
39
+ readonly trauma: number;
40
+ readonly punchActive: boolean;
41
+ readonly clipped: boolean;
42
+ readonly clearance: number;
43
+ }
44
+ export interface ShoulderCameraOptions {
45
+ readonly side?: "right" | "left";
46
+ readonly sideOffset?: number;
47
+ readonly heightOffset?: number;
48
+ readonly distance?: number;
49
+ readonly lookAhead?: number;
50
+ readonly smoothing?: number;
51
+ readonly fov?: number;
52
+ }
53
+ export interface ShoulderCamera {
54
+ update(dt: number, target: GameCameraRigTarget): GameCameraRigSnapshot;
55
+ snapshot(): GameCameraRigSnapshot;
56
+ reset(eye: GameCameraRigVec3): void;
57
+ }
58
+ export declare function createShoulderCamera(options?: ShoulderCameraOptions): ShoulderCamera;
59
+ export interface CollisionOrbitProbeHit {
60
+ readonly distance: number;
61
+ }
62
+ export type CollisionOrbitProbe = (origin: GameCameraRigVec3, direction: GameCameraRigVec3, maxDistance: number) => CollisionOrbitProbeHit | undefined;
63
+ export interface CollisionAwareOrbitOptions {
64
+ readonly target?: GameCameraRigVec3;
65
+ readonly distance?: number;
66
+ readonly minDistance?: number;
67
+ readonly maxDistance?: number;
68
+ readonly probeRadius?: number;
69
+ readonly azimuth?: number;
70
+ readonly polar?: number;
71
+ readonly smoothing?: number;
72
+ readonly pullInRate?: number;
73
+ readonly fov?: number;
74
+ }
75
+ export interface CollisionAwareOrbit {
76
+ rotate(deltaAzimuth: number, deltaPolar: number): void;
77
+ dolly(factor: number): void;
78
+ setTarget(target: GameCameraRigVec3): void;
79
+ update(dt: number, probe?: CollisionOrbitProbe): GameCameraRigSnapshot & {
80
+ clipped: boolean;
81
+ clearance: number;
82
+ };
83
+ snapshot(): GameCameraRigSnapshot & {
84
+ clipped: boolean;
85
+ clearance: number;
86
+ };
87
+ }
88
+ export declare function createCollisionAwareOrbit(options?: CollisionAwareOrbitOptions): CollisionAwareOrbit;
89
+ export interface TraumaShakeOptions {
90
+ readonly decay?: number;
91
+ readonly maxOffset?: number;
92
+ readonly maxRoll?: number;
93
+ readonly seed?: number;
94
+ }
95
+ export interface TraumaShakeSnapshot {
96
+ readonly kind: "aura-game-trauma-shake";
97
+ readonly offset: GameCameraRigVec3;
98
+ readonly roll: number;
99
+ readonly trauma: number;
100
+ readonly energy: number;
101
+ }
102
+ export interface TraumaShake {
103
+ addTrauma(amount: number): void;
104
+ update(dt: number): TraumaShakeSnapshot;
105
+ snapshot(): TraumaShakeSnapshot;
106
+ }
107
+ export declare function createTraumaShake(options?: TraumaShakeOptions): TraumaShake;
108
+ export interface PunchInOptions {
109
+ readonly fovKick?: number;
110
+ readonly distanceKick?: number;
111
+ readonly duration?: number;
112
+ }
113
+ export interface PunchInSnapshot {
114
+ readonly kind: "aura-game-punch-in";
115
+ readonly fovOffset: number;
116
+ readonly distanceOffset: number;
117
+ readonly active: boolean;
118
+ readonly progress: number;
119
+ }
120
+ export interface PunchIn {
121
+ punch(strength?: number): void;
122
+ update(dt: number): PunchInSnapshot;
123
+ snapshot(): PunchInSnapshot;
124
+ }
125
+ export declare function createPunchIn(options?: PunchInOptions): PunchIn;
126
+ /**
127
+ * The single follow-camera damping contract shared with
128
+ * `ThirdPersonFollowControls` (`@aura3d/input`): the eye eases toward
129
+ * `target.position + offset` with exponential damping
130
+ * `alpha = 1 - exp(-damping * dt)`, then looks at the target.
131
+ */
132
+ export declare const FOLLOW_DAMPING_CONTRACT: "offset-plus-exponential-damping-v1";
133
+ export interface FollowRigOptions {
134
+ readonly offset?: GameCameraRigVec3;
135
+ readonly damping?: number;
136
+ readonly fov?: number;
137
+ }
138
+ export interface FollowRig {
139
+ update(dt: number, target: GameCameraRigTarget): GameCameraRigSnapshot;
140
+ snapshot(): GameCameraRigSnapshot;
141
+ asInputOptions(): {
142
+ readonly offset: {
143
+ x: number;
144
+ y: number;
145
+ z: number;
146
+ };
147
+ readonly damping: number;
148
+ };
149
+ }
150
+ export declare function createFollowRig(options?: FollowRigOptions): FollowRig;
151
+ export interface GameCameraRigOptions {
152
+ readonly base?: "shoulder" | "collision-orbit" | "follow";
153
+ readonly shoulder?: ShoulderCameraOptions;
154
+ readonly orbit?: CollisionAwareOrbitOptions;
155
+ readonly follow?: FollowRigOptions;
156
+ readonly trauma?: TraumaShakeOptions;
157
+ readonly punch?: PunchInOptions;
158
+ readonly fov?: number;
159
+ }
160
+ export interface GameCameraRig {
161
+ readonly trauma: TraumaShake;
162
+ readonly punchIn: PunchIn;
163
+ update(dt: number, target: GameCameraRigTarget, probe?: CollisionOrbitProbe): {
164
+ readonly snapshot: GameCameraRigSnapshot;
165
+ readonly evidence: GameCameraEvidence;
166
+ };
167
+ snapshot(): {
168
+ readonly snapshot: GameCameraRigSnapshot;
169
+ readonly evidence: GameCameraEvidence;
170
+ };
171
+ }
172
+ export declare function createGameCameraRig(options?: GameCameraRigOptions): GameCameraRig;
173
+ /**
174
+ * Root-bridge namespace (wiring lives in `agent-api/index.ts`, owned by the
175
+ * bridge sibling — this object is the exact surface to spread onto `camera`).
176
+ */
177
+ export declare const gameCameraRigs: {
178
+ readonly shoulder: typeof createShoulderCamera;
179
+ readonly collisionAwareOrbit: typeof createCollisionAwareOrbit;
180
+ readonly shake: typeof createTraumaShake;
181
+ readonly punchIn: typeof createPunchIn;
182
+ readonly followRig: typeof createFollowRig;
183
+ readonly gameRig: typeof createGameCameraRig;
184
+ };
185
+ //# sourceMappingURL=GameCameraRigs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GameCameraRigs.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/GameCameraRigs.ts"],"names":[],"mappings":"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"}