@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
@@ -0,0 +1,226 @@
1
+ /**
2
+ * Generalized game-feel kit (muse3jsparity-PRD F3).
3
+ *
4
+ * Generalizes the combat-proven pieces: `hitStop` durations come from the
5
+ * fighting kit (`game-kits/fighting.ts`: light 0.045s, heavy 0.07s,
6
+ * special 0.1s) and the pixel path reuses the `createGameEffects` kinds
7
+ * (`hit-spark`, `impact-flash`, `dash-trail`, `ground-dust`, ...), so every
8
+ * effect below resolves to real scene nodes through `nodes()` — never DOM,
9
+ * canvas, or CSS fakes (boundaries rule).
10
+ *
11
+ * This module is engine-pure and owns no renderer: the effects controller is
12
+ * injected through {@link GameFeelEffectsPort}, which `createGameEffects`
13
+ * (in `GameRuntime.ts`) satisfies structurally. A kit without a wired
14
+ * controller refuses pixel-backed triggers with an explicit receipt instead
15
+ * of faking success. All triggers are frame-budgeted and every trigger
16
+ * returns a receipt; `snapshot()` is the telemetry surface.
17
+ */
18
+ /** Combat-proven hit-stop defaults, generalized (fighting kit values). */
19
+ export const GAME_FEEL_HIT_STOP_LIGHT_S = 0.045;
20
+ export const GAME_FEEL_HIT_STOP_HEAVY_S = 0.07;
21
+ export const GAME_FEEL_HIT_STOP_SPECIAL_S = 0.1;
22
+ export const GAME_FEEL_HIT_STOP_DEFAULT_S = 0.06;
23
+ function assertFinite(value, api, field) {
24
+ if (!Number.isFinite(value)) {
25
+ throw new RangeError(`${api} ${field} must be finite (received ${String(value)}).`);
26
+ }
27
+ }
28
+ function nowMs() {
29
+ if (typeof performance !== "undefined" && typeof performance.now === "function")
30
+ return performance.now();
31
+ return Date.now();
32
+ }
33
+ export function createGameFeel(options = {}) {
34
+ const budgetMs = options.budgetMs ?? 2;
35
+ assertFinite(budgetMs, "gameFeel", "budgetMs");
36
+ if (budgetMs < 0)
37
+ throw new RangeError("gameFeel budgetMs must be >= 0.");
38
+ let enabled = options.enabled ?? true;
39
+ const effects = options.effects;
40
+ let slowMoScale = 1;
41
+ let slowMoRemainingMs = 0;
42
+ let hitStopRemainingMs = 0;
43
+ let flashRemainingMs = 0;
44
+ let lineIntensity = 0;
45
+ let lineRemainingMs = 0;
46
+ let dustSpawned = 0;
47
+ let updates = 0;
48
+ let lastMs = 0;
49
+ let maxMs = 0;
50
+ let overBudgetCount = 0;
51
+ const disabled = (effect) => ({
52
+ accepted: false,
53
+ reason: `gameFeel.${effect} rejected: kit disabled (setEnabled(true) to resume).`
54
+ });
55
+ const unwired = (effect) => ({
56
+ accepted: false,
57
+ reason: `gameFeel.${effect} rejected: no effects controller wired (pass options.effects).`
58
+ });
59
+ const timeScale = () => {
60
+ if (hitStopRemainingMs > 0)
61
+ return 0;
62
+ if (slowMoRemainingMs > 0)
63
+ return slowMoScale;
64
+ return 1;
65
+ };
66
+ const budget = () => ({
67
+ lastMs,
68
+ maxMs,
69
+ budgetMs,
70
+ overBudget: lastMs > budgetMs,
71
+ overBudgetCount,
72
+ updates
73
+ });
74
+ const snap = () => {
75
+ const effectsSnapshot = effects?.snapshot();
76
+ return {
77
+ kind: "aura-game-feel",
78
+ enabled,
79
+ timeScale: timeScale(),
80
+ frozen: hitStopRemainingMs > 0,
81
+ slowMoActive: slowMoRemainingMs > 0,
82
+ hitStopActive: hitStopRemainingMs > 0,
83
+ flashActive: flashRemainingMs > 0,
84
+ lineIntensity: lineRemainingMs > 0 ? lineIntensity : 0,
85
+ dustSpawned,
86
+ effectsActive: effectsSnapshot?.active ?? 0,
87
+ effectsSpawned: effectsSnapshot?.spawned ?? 0,
88
+ budget: budget()
89
+ };
90
+ };
91
+ return {
92
+ get effectsWired() {
93
+ return effects !== undefined;
94
+ },
95
+ setEnabled(next) {
96
+ enabled = next === true;
97
+ if (!enabled) {
98
+ slowMoRemainingMs = 0;
99
+ hitStopRemainingMs = 0;
100
+ flashRemainingMs = 0;
101
+ lineRemainingMs = 0;
102
+ lineIntensity = 0;
103
+ slowMoScale = 1;
104
+ }
105
+ },
106
+ slowMo(scale, durationMs) {
107
+ const api = "gameFeel.slowMo";
108
+ assertFinite(scale, api, "scale");
109
+ assertFinite(durationMs, api, "durationMs");
110
+ if (scale < 0 || scale > 1)
111
+ throw new RangeError(`${api} scale must be in [0, 1].`);
112
+ if (durationMs <= 0)
113
+ throw new RangeError(`${api} durationMs must be > 0.`);
114
+ if (!enabled)
115
+ return disabled("slowMo");
116
+ slowMoScale = scale;
117
+ slowMoRemainingMs = durationMs;
118
+ return { accepted: true };
119
+ },
120
+ hitStop(durationMs) {
121
+ const api = "gameFeel.hitStop";
122
+ assertFinite(durationMs, api, "durationMs");
123
+ if (durationMs <= 0)
124
+ throw new RangeError(`${api} durationMs must be > 0.`);
125
+ if (!enabled)
126
+ return disabled("hitStop");
127
+ // Generalized from the fighting kit: a full freeze for the window.
128
+ hitStopRemainingMs = Math.max(hitStopRemainingMs, durationMs);
129
+ return { accepted: true };
130
+ },
131
+ damageFlash(color, position = [0, 1, 0]) {
132
+ const api = "gameFeel.damageFlash";
133
+ if (typeof color !== "string" || color.length === 0) {
134
+ throw new RangeError(`${api} color must be a non-empty string.`);
135
+ }
136
+ if (!enabled)
137
+ return disabled("damageFlash");
138
+ if (!effects)
139
+ return unwired("damageFlash");
140
+ const effect = effects.spawn("impact-flash", position, { color, intensity: 1, duration: 0.12 });
141
+ flashRemainingMs = 120;
142
+ return { accepted: true, effectId: effect.id };
143
+ },
144
+ speedLines(intensity, position = [0, 1, -1]) {
145
+ const api = "gameFeel.speedLines";
146
+ assertFinite(intensity, api, "intensity");
147
+ if (intensity < 0 || intensity > 1)
148
+ throw new RangeError(`${api} intensity must be in [0, 1].`);
149
+ if (!enabled)
150
+ return disabled("speedLines");
151
+ if (!effects)
152
+ return unwired("speedLines");
153
+ const effect = effects.spawn(intensity > 0.6 ? "slash-trail" : "dash-trail", position, {
154
+ intensity,
155
+ duration: 0.28
156
+ });
157
+ lineIntensity = intensity;
158
+ lineRemainingMs = 280;
159
+ return { accepted: true, effectId: effect.id };
160
+ },
161
+ landingDust(position) {
162
+ const api = "gameFeel.landingDust";
163
+ if (!Array.isArray(position) || position.length !== 3 || position.some((c) => !Number.isFinite(c))) {
164
+ throw new RangeError(`${api} position must be a finite [x, y, z] tuple.`);
165
+ }
166
+ if (!enabled)
167
+ return disabled("landingDust");
168
+ if (!effects)
169
+ return unwired("landingDust");
170
+ const effect = effects.spawn("ground-dust", position, { intensity: 0.8, duration: 0.34 });
171
+ dustSpawned += 1;
172
+ return { accepted: true, effectId: effect.id };
173
+ },
174
+ effectiveDt(dtMs) {
175
+ assertFinite(dtMs, "gameFeel.effectiveDt", "dtMs");
176
+ return Math.max(0, dtMs) * timeScale();
177
+ },
178
+ update(dtMs) {
179
+ assertFinite(dtMs, "gameFeel.update", "dtMs");
180
+ const started = nowMs();
181
+ const step = Math.max(0, dtMs);
182
+ slowMoRemainingMs = Math.max(0, slowMoRemainingMs - step);
183
+ if (slowMoRemainingMs === 0)
184
+ slowMoScale = 1;
185
+ hitStopRemainingMs = Math.max(0, hitStopRemainingMs - step);
186
+ flashRemainingMs = Math.max(0, flashRemainingMs - step);
187
+ lineRemainingMs = Math.max(0, lineRemainingMs - step);
188
+ if (lineRemainingMs === 0)
189
+ lineIntensity = 0;
190
+ effects?.update(step / 1000);
191
+ updates += 1;
192
+ lastMs = nowMs() - started;
193
+ maxMs = Math.max(maxMs, lastMs);
194
+ if (lastMs > budgetMs)
195
+ overBudgetCount += 1;
196
+ return snap();
197
+ },
198
+ snapshot: snap,
199
+ nodes() {
200
+ return effects?.nodes() ?? [];
201
+ },
202
+ clear() {
203
+ effects?.clear();
204
+ slowMoRemainingMs = 0;
205
+ hitStopRemainingMs = 0;
206
+ flashRemainingMs = 0;
207
+ lineRemainingMs = 0;
208
+ lineIntensity = 0;
209
+ slowMoScale = 1;
210
+ }
211
+ };
212
+ }
213
+ /**
214
+ * Root-bridge namespace (wiring lives in `agent-api/index.ts`, owned by the
215
+ * bridge sibling — this object is the exact surface to expose as `gameFeel`).
216
+ */
217
+ export const gameFeelBuilders = {
218
+ create: createGameFeel,
219
+ hitStopDefaults: {
220
+ light: GAME_FEEL_HIT_STOP_LIGHT_S,
221
+ heavy: GAME_FEEL_HIT_STOP_HEAVY_S,
222
+ special: GAME_FEEL_HIT_STOP_SPECIAL_S,
223
+ default: GAME_FEEL_HIT_STOP_DEFAULT_S
224
+ }
225
+ };
226
+ //# sourceMappingURL=GameFeel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GameFeel.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/GameFeel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ import type { AuraLabelNode } from "./index.js";
2
+ import type { ProjectedLabel } from "./WorldLabelRenderer.js";
3
+ /**
4
+ * Label telemetry for the three text buckets (muse3jsparity-PRD N4).
5
+ *
6
+ * N4 ends the DOM-vs-3D ambiguity with three buckets and three proofs:
7
+ *
8
+ * 1. Accessible DOM (`ui.*`) — screen-reader text, never projected. Counted
9
+ * from the scene as `hud` labels plus `ui.*` bindings, not from pixels.
10
+ * 2. World-anchored screen-space labels (`labels.billboard/anchor/axisTick/
11
+ * callout`) — DOM boxes placed by 3D projection. Proven by
12
+ * `collectLabelTelemetry` below: placed-vs-offscreen counts per route,
13
+ * computed from the projected set, not the node set. Counting nodes is
14
+ * what let silently-dropped callouts stay green.
15
+ * 3. Lit/occluded 3D text (G1 SDF) — in-world quads. Proven by
16
+ * `textPixelBacked`, owned by `packages/rendering/src/SdfText.ts`.
17
+ *
18
+ * ## CSS2D/CSS3D
19
+ *
20
+ * Explicit 2.1 decision (see `CSS2D_OUT_OF_SCOPE`): NO `CSS2DRenderer` /
21
+ * `CSS3DRenderer` parity. Verified: zero `CSS2D`/`CSS3D` references exist in
22
+ * `packages/`. Game annotation needs are covered by buckets 2 and 3; the
23
+ * three-compat migration lab documents the manual CSS2D/3D mapping for
24
+ * importers. Revisit only with a named customer workload.
25
+ *
26
+ * Pure: no DOM. Takes scene nodes plus the projected set (from
27
+ * `AuraDiagnostics.labels`) and returns counts. The engine bridge embeds the
28
+ * result in diagnostics; route-health enforces it per route.
29
+ */
30
+ /** Collision role: HUD reserves fixed positions, ticks are dense, annotations steer. */
31
+ export type LabelTelemetryRole = "hud" | "annotation" | "tick";
32
+ export declare function labelTelemetryRoleFor(label: AuraLabelNode["label"]): LabelTelemetryRole;
33
+ export interface LabelTelemetryByRole {
34
+ readonly declared: number;
35
+ readonly placed: number;
36
+ readonly offscreen: number;
37
+ }
38
+ export interface LabelTelemetry {
39
+ readonly kind: "aura-label-telemetry";
40
+ /** Labels declared in the scene snapshot. */
41
+ readonly declared: number;
42
+ /** Labels actually placed on screen this frame (`visible === true`). */
43
+ readonly placed: number;
44
+ /** Labels declared but not on screen (hidden, clamped-away, behind camera, occlusion-hidden). */
45
+ readonly offscreen: number;
46
+ readonly behindCamera: number;
47
+ readonly clamped: number;
48
+ readonly occludedDimmed: number;
49
+ readonly occludedHidden?: number;
50
+ readonly suppressed?: number;
51
+ readonly byRole: Readonly<Record<LabelTelemetryRole, LabelTelemetryByRole>>;
52
+ /**
53
+ * Fail-closed gate signal for route-health: a route that declares labels
54
+ * but places none fails. A route with no labels passes vacuously.
55
+ */
56
+ readonly placesLabels: boolean;
57
+ }
58
+ /**
59
+ * Join scene label nodes with their projected results by node id.
60
+ *
61
+ * Ids must match `worldLabelsFromSnapshot` exactly: `node.name`, else
62
+ * `${node.label}-${position}` where position is 1-based in flattened snapshot
63
+ * order. Pass nodes in that same order; a mismatched id counts the label as
64
+ * offscreen rather than inventing a placement.
65
+ */
66
+ export declare function collectLabelTelemetry(nodes: readonly AuraLabelNode[], projected: readonly ProjectedLabel[]): LabelTelemetry;
67
+ export interface LabelCollisionTuning {
68
+ readonly role: LabelTelemetryRole;
69
+ /** Minimum vertical gap in CSS pixels used by `resolveLabelCollisions`. */
70
+ readonly minGapPx: number;
71
+ /** Whether collision avoidance runs for this role at all. */
72
+ readonly avoidanceEnabled: boolean;
73
+ /** Larger priorities reserve their rectangle first; depth then id break ties. */
74
+ readonly priority?: number;
75
+ /** Maximum vertical movement away from the requested position, in CSS pixels. */
76
+ readonly maxDisplacementPx?: number;
77
+ readonly note: string;
78
+ }
79
+ /**
80
+ * Per-role collision-avoidance tuning (N4 task 2).
81
+ *
82
+ * HUD copy reserves its screen anchor without displacement; axis ticks are dense and get
83
+ * the tightest gap; annotations keep the default gap so leaders stay readable.
84
+ */
85
+ export declare function tuneLabelCollision(role: LabelTelemetryRole): LabelCollisionTuning;
86
+ export interface TextBucketSummary {
87
+ /** Bucket 1: accessible DOM (`ui.*` bindings + `hud` labels). UI-only, never 3D proof. */
88
+ readonly accessibleDom: number;
89
+ /** Bucket 2: world-anchored screen-space labels placed this frame. */
90
+ readonly worldAnchoredPlaced: number;
91
+ /** Bucket 3: lit/occluded SDF 3D text quads submitted this frame. */
92
+ readonly sdfTexts: number;
93
+ readonly note: string;
94
+ }
95
+ /** Three buckets, three numbers — never merged, per the inventory rule. */
96
+ export declare function summarizeTextBuckets(input: {
97
+ readonly accessibleDom: number;
98
+ readonly worldAnchoredPlaced: number;
99
+ readonly sdfTexts: number;
100
+ }): TextBucketSummary;
101
+ /**
102
+ * The explicit 2.1 decision: NO `CSS2DRenderer`/`CSS3DRenderer` parity.
103
+ * Game annotation needs are covered by world-anchored labels + G1 SDF text;
104
+ * the three-compat migration lab documents the manual CSS2D/3D mapping for
105
+ * importers. Revisit only with a named customer workload.
106
+ */
107
+ export declare const CSS2D_OUT_OF_SCOPE: {
108
+ readonly decision: "no-css2d-css3d-parity";
109
+ readonly renderers: readonly ["CSS2DRenderer", "CSS3DRenderer"];
110
+ readonly coveredBy: readonly ["world-anchored labels", "G1 SDF text"];
111
+ readonly importerPath: "three-compat migration lab documents the manual CSS2D/3D mapping";
112
+ readonly revisit: "named customer workload only";
113
+ };
114
+ //# sourceMappingURL=LabelTelemetry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LabelTelemetry.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/LabelTelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,wFAAwF;AACxF,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;AAE/D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAIvF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC5E;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,cAAc,CA8ChB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,CA6BjF;AAED,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GAAG,iBAAiB,CAUpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC"}
@@ -0,0 +1,130 @@
1
+ export function labelTelemetryRoleFor(label) {
2
+ if (label === "hud")
3
+ return "hud";
4
+ if (label === "axis-tick")
5
+ return "tick";
6
+ return "annotation";
7
+ }
8
+ /**
9
+ * Join scene label nodes with their projected results by node id.
10
+ *
11
+ * Ids must match `worldLabelsFromSnapshot` exactly: `node.name`, else
12
+ * `${node.label}-${position}` where position is 1-based in flattened snapshot
13
+ * order. Pass nodes in that same order; a mismatched id counts the label as
14
+ * offscreen rather than inventing a placement.
15
+ */
16
+ export function collectLabelTelemetry(nodes, projected) {
17
+ const byId = new Map(projected.map((label) => [label.id, label]));
18
+ const byRole = {
19
+ hud: { declared: 0, placed: 0, offscreen: 0 },
20
+ annotation: { declared: 0, placed: 0, offscreen: 0 },
21
+ tick: { declared: 0, placed: 0, offscreen: 0 }
22
+ };
23
+ let behindCamera = 0;
24
+ let clamped = 0;
25
+ let occludedDimmed = 0;
26
+ let occludedHidden = 0;
27
+ let suppressed = 0;
28
+ let placedCount = 0;
29
+ nodes.forEach((node, index) => {
30
+ const role = labelTelemetryRoleFor(node.label);
31
+ const slot = byRole[role];
32
+ byRole[role] = { ...slot, declared: slot.declared + 1 };
33
+ const id = node.name ?? `${node.label}-${index + 1}`;
34
+ const result = byId.get(id);
35
+ const placed = result?.visible === true;
36
+ if (placed) {
37
+ placedCount += 1;
38
+ byRole[role] = { ...byRole[role], placed: byRole[role].placed + 1 };
39
+ if (result.clamped)
40
+ clamped += 1;
41
+ if (result.occluded && result.occlusionOpacity < 1)
42
+ occludedDimmed += 1;
43
+ }
44
+ else {
45
+ if (result?.occluded)
46
+ occludedHidden += 1;
47
+ if (result?.suppressed)
48
+ suppressed += 1;
49
+ byRole[role] = { ...byRole[role], offscreen: byRole[role].offscreen + 1 };
50
+ if (result?.behindCamera === true)
51
+ behindCamera += 1;
52
+ }
53
+ });
54
+ const declared = nodes.length;
55
+ return {
56
+ kind: "aura-label-telemetry",
57
+ declared,
58
+ placed: placedCount,
59
+ offscreen: declared - placedCount,
60
+ behindCamera,
61
+ clamped,
62
+ occludedDimmed,
63
+ occludedHidden,
64
+ suppressed,
65
+ byRole,
66
+ placesLabels: declared === 0 || placedCount > 0
67
+ };
68
+ }
69
+ /**
70
+ * Per-role collision-avoidance tuning (N4 task 2).
71
+ *
72
+ * HUD copy reserves its screen anchor without displacement; axis ticks are dense and get
73
+ * the tightest gap; annotations keep the default gap so leaders stay readable.
74
+ */
75
+ export function tuneLabelCollision(role) {
76
+ if (role === "hud") {
77
+ return {
78
+ role,
79
+ minGapPx: 0,
80
+ avoidanceEnabled: false,
81
+ priority: 3,
82
+ maxDisplacementPx: 0,
83
+ note: "HUD labels reserve fixed screen anchors first; conflicting later HUD copy is suppressed rather than moved."
84
+ };
85
+ }
86
+ if (role === "tick") {
87
+ return {
88
+ role,
89
+ minGapPx: 2,
90
+ avoidanceEnabled: true,
91
+ priority: 1,
92
+ maxDisplacementPx: 48,
93
+ note: "Axis ticks use a 2px gap and at most 48px displacement, after HUD and annotations; depth then id break ties."
94
+ };
95
+ }
96
+ return {
97
+ role,
98
+ minGapPx: 4,
99
+ avoidanceEnabled: true,
100
+ priority: 2,
101
+ maxDisplacementPx: 160,
102
+ note: "Annotations use a 4px pairwise gap and at most 160px displacement, after HUD and before ticks."
103
+ };
104
+ }
105
+ /** Three buckets, three numbers — never merged, per the inventory rule. */
106
+ export function summarizeTextBuckets(input) {
107
+ for (const [key, value] of Object.entries(input)) {
108
+ if (!Number.isInteger(value) || value < 0) {
109
+ throw new Error(`Aura3D text bucket "${key}" must be a non-negative integer.`);
110
+ }
111
+ }
112
+ return {
113
+ ...input,
114
+ note: "Accessible DOM, world-anchored labels, and SDF 3D text are separate capabilities with separate proof."
115
+ };
116
+ }
117
+ /**
118
+ * The explicit 2.1 decision: NO `CSS2DRenderer`/`CSS3DRenderer` parity.
119
+ * Game annotation needs are covered by world-anchored labels + G1 SDF text;
120
+ * the three-compat migration lab documents the manual CSS2D/3D mapping for
121
+ * importers. Revisit only with a named customer workload.
122
+ */
123
+ export const CSS2D_OUT_OF_SCOPE = {
124
+ decision: "no-css2d-css3d-parity",
125
+ renderers: ["CSS2DRenderer", "CSS3DRenderer"],
126
+ coveredBy: ["world-anchored labels", "G1 SDF text"],
127
+ importerPath: "three-compat migration lab documents the manual CSS2D/3D mapping",
128
+ revisit: "named customer workload only"
129
+ };
130
+ //# sourceMappingURL=LabelTelemetry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LabelTelemetry.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/LabelTelemetry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export { composeModelInstanceMatrices } from "./RootRuntimeSupport.js";
2
+ //# sourceMappingURL=ModelInstanceMatrices.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ModelInstanceMatrices.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/ModelInstanceMatrices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { composeModelInstanceMatrices } from "./RootRuntimeSupport.js";
2
+ //# sourceMappingURL=ModelInstanceMatrices.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ModelInstanceMatrices.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/ModelInstanceMatrices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC"}