@aura3d/engine 2.0.3 → 3.0.0

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 (704) hide show
  1. package/README.md +37 -46
  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 +3 -0
  10. package/dist/animation/AnimationMixer.d.ts.map +1 -1
  11. package/dist/animation/AnimationMixer.js +69 -5
  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 +10 -0
  17. package/dist/animation/FootIk.d.ts.map +1 -1
  18. package/dist/animation/FootIk.js +95 -3
  19. package/dist/animation/FootIk.js.map +1 -1
  20. package/dist/animation/HumanoidRetargeting.d.ts +29 -0
  21. package/dist/animation/HumanoidRetargeting.d.ts.map +1 -1
  22. package/dist/animation/HumanoidRetargeting.js +41 -1
  23. package/dist/animation/HumanoidRetargeting.js.map +1 -1
  24. package/dist/animation/LocomotionKit.d.ts +6 -0
  25. package/dist/animation/LocomotionKit.d.ts.map +1 -1
  26. package/dist/animation/LocomotionKit.js +6 -0
  27. package/dist/animation/LocomotionKit.js.map +1 -1
  28. package/dist/animation/RootMotion.d.ts +27 -0
  29. package/dist/animation/RootMotion.d.ts.map +1 -1
  30. package/dist/animation/RootMotion.js +38 -0
  31. package/dist/animation/RootMotion.js.map +1 -1
  32. package/dist/animation/SpringBones.d.ts +28 -0
  33. package/dist/animation/SpringBones.d.ts.map +1 -1
  34. package/dist/animation/SpringBones.js +24 -0
  35. package/dist/animation/SpringBones.js.map +1 -1
  36. package/dist/assets/GLTFAnimationRuntime.d.ts +95 -2
  37. package/dist/assets/GLTFAnimationRuntime.d.ts.map +1 -1
  38. package/dist/assets/GLTFAnimationRuntime.js +328 -3
  39. package/dist/assets/GLTFAnimationRuntime.js.map +1 -1
  40. package/dist/assets/GLTFExtensionSupport.js +2 -2
  41. package/dist/assets/GLTFExtensionSupport.js.map +1 -1
  42. package/dist/assets/GLTFLoader.d.ts +360 -1
  43. package/dist/assets/GLTFLoader.d.ts.map +1 -1
  44. package/dist/assets/GLTFLoader.js +197 -1
  45. package/dist/assets/GLTFLoader.js.map +1 -1
  46. package/dist/assets/KTX2BasisTextureTranscoder.d.ts +39 -0
  47. package/dist/assets/KTX2BasisTextureTranscoder.d.ts.map +1 -1
  48. package/dist/assets/KTX2BasisTextureTranscoder.js +70 -0
  49. package/dist/assets/KTX2BasisTextureTranscoder.js.map +1 -1
  50. package/dist/assets/TexturePipeline.d.ts +20 -0
  51. package/dist/assets/TexturePipeline.d.ts.map +1 -1
  52. package/dist/assets/TexturePipeline.js +20 -0
  53. package/dist/assets/TexturePipeline.js.map +1 -1
  54. package/dist/assets/TextureStreaming.d.ts +30 -0
  55. package/dist/assets/TextureStreaming.d.ts.map +1 -1
  56. package/dist/assets/TextureStreaming.js +53 -0
  57. package/dist/assets/TextureStreaming.js.map +1 -1
  58. package/dist/assets/browser-index.d.ts +7 -3
  59. package/dist/assets/browser-index.d.ts.map +1 -1
  60. package/dist/assets/browser-index.js +3 -1
  61. package/dist/assets/browser-index.js.map +1 -1
  62. package/dist/assets/gltf-runtime.d.ts +1 -1
  63. package/dist/assets/gltf-runtime.d.ts.map +1 -1
  64. package/dist/assets/gltf-runtime.js.map +1 -1
  65. package/dist/assets/index.d.ts +7 -7
  66. package/dist/assets/index.d.ts.map +1 -1
  67. package/dist/assets/index.js +3 -3
  68. package/dist/assets/index.js.map +1 -1
  69. package/dist/assets/loaders/HDRLoader.d.ts +40 -0
  70. package/dist/assets/loaders/HDRLoader.d.ts.map +1 -1
  71. package/dist/assets/loaders/HDRLoader.js +158 -0
  72. package/dist/assets/loaders/HDRLoader.js.map +1 -1
  73. package/dist/audio/AudioSource.d.ts +2 -0
  74. package/dist/audio/AudioSource.d.ts.map +1 -1
  75. package/dist/audio/AudioSource.js +7 -0
  76. package/dist/audio/AudioSource.js.map +1 -1
  77. package/dist/audio/Footsteps.d.ts +47 -0
  78. package/dist/audio/Footsteps.d.ts.map +1 -0
  79. package/dist/audio/Footsteps.js +73 -0
  80. package/dist/audio/Footsteps.js.map +1 -0
  81. package/dist/audio/GameMixer.d.ts +69 -0
  82. package/dist/audio/GameMixer.d.ts.map +1 -0
  83. package/dist/audio/GameMixer.js +141 -0
  84. package/dist/audio/GameMixer.js.map +1 -0
  85. package/dist/audio/PositionalEmitter.d.ts +95 -0
  86. package/dist/audio/PositionalEmitter.d.ts.map +1 -0
  87. package/dist/audio/PositionalEmitter.js +199 -0
  88. package/dist/audio/PositionalEmitter.js.map +1 -0
  89. package/dist/audio/index.d.ts +6 -0
  90. package/dist/audio/index.d.ts.map +1 -1
  91. package/dist/audio/index.js +3 -0
  92. package/dist/audio/index.js.map +1 -1
  93. package/dist/aura3d-cli/asset-core-types.d.ts +19 -0
  94. package/dist/aura3d-cli/asset-core-types.d.ts.map +1 -1
  95. package/dist/aura3d-cli/asset-manifest.d.ts.map +1 -1
  96. package/dist/aura3d-cli/asset-manifest.js +2 -1
  97. package/dist/aura3d-cli/asset-manifest.js.map +1 -1
  98. package/dist/aura3d-cli/cli-help.d.ts.map +1 -1
  99. package/dist/aura3d-cli/cli-help.js +2 -0
  100. package/dist/aura3d-cli/cli-help.js.map +1 -1
  101. package/dist/aura3d-cli/cli.js +24 -1
  102. package/dist/aura3d-cli/cli.js.map +1 -1
  103. package/dist/aura3d-cli/index.d.ts +5 -1
  104. package/dist/aura3d-cli/index.d.ts.map +1 -1
  105. package/dist/aura3d-cli/index.js +5 -1
  106. package/dist/aura3d-cli/index.js.map +1 -1
  107. package/dist/aura3d-cli/meshy/admission.d.ts +40 -0
  108. package/dist/aura3d-cli/meshy/admission.d.ts.map +1 -0
  109. package/dist/aura3d-cli/meshy/admission.js +126 -0
  110. package/dist/aura3d-cli/meshy/admission.js.map +1 -0
  111. package/dist/aura3d-cli/meshy/evidence.d.ts +12 -0
  112. package/dist/aura3d-cli/meshy/evidence.d.ts.map +1 -0
  113. package/dist/aura3d-cli/meshy/evidence.js +37 -0
  114. package/dist/aura3d-cli/meshy/evidence.js.map +1 -0
  115. package/dist/aura3d-cli/meshy/import.d.ts +25 -0
  116. package/dist/aura3d-cli/meshy/import.d.ts.map +1 -0
  117. package/dist/aura3d-cli/meshy/import.js +104 -0
  118. package/dist/aura3d-cli/meshy/import.js.map +1 -0
  119. package/dist/aura3d-cli/meshy/index.d.ts +10 -0
  120. package/dist/aura3d-cli/meshy/index.d.ts.map +1 -0
  121. package/dist/aura3d-cli/meshy/index.js +6 -0
  122. package/dist/aura3d-cli/meshy/index.js.map +1 -0
  123. package/dist/aura3d-cli/meshy/metadata.d.ts +22 -0
  124. package/dist/aura3d-cli/meshy/metadata.d.ts.map +1 -0
  125. package/dist/aura3d-cli/meshy/metadata.js +176 -0
  126. package/dist/aura3d-cli/meshy/metadata.js.map +1 -0
  127. package/dist/aura3d-cli/meshy/provenance.d.ts +4 -0
  128. package/dist/aura3d-cli/meshy/provenance.d.ts.map +1 -0
  129. package/dist/aura3d-cli/meshy/provenance.js +21 -0
  130. package/dist/aura3d-cli/meshy/provenance.js.map +1 -0
  131. package/dist/aura3d-cli/meshy/thumbnail.d.ts +19 -0
  132. package/dist/aura3d-cli/meshy/thumbnail.d.ts.map +1 -0
  133. package/dist/aura3d-cli/meshy/thumbnail.js +59 -0
  134. package/dist/aura3d-cli/meshy/thumbnail.js.map +1 -0
  135. package/dist/aura3d-cli/meshy/validation.d.ts +5 -0
  136. package/dist/aura3d-cli/meshy/validation.d.ts.map +1 -0
  137. package/dist/aura3d-cli/meshy/validation.js +64 -0
  138. package/dist/aura3d-cli/meshy/validation.js.map +1 -0
  139. package/dist/aura3d-cli/pull-bridge/profiles.d.ts +12 -2
  140. package/dist/aura3d-cli/pull-bridge/profiles.d.ts.map +1 -1
  141. package/dist/aura3d-cli/pull-bridge/profiles.js +35 -4
  142. package/dist/aura3d-cli/pull-bridge/profiles.js.map +1 -1
  143. package/dist/aura3d-cli/pull-bridge/provenance.d.ts +15 -1
  144. package/dist/aura3d-cli/pull-bridge/provenance.d.ts.map +1 -1
  145. package/dist/aura3d-cli/pull-bridge/provenance.js +60 -1
  146. package/dist/aura3d-cli/pull-bridge/provenance.js.map +1 -1
  147. package/dist/aura3d-cli/pull-bridge/scoring.d.ts +10 -1
  148. package/dist/aura3d-cli/pull-bridge/scoring.d.ts.map +1 -1
  149. package/dist/aura3d-cli/pull-bridge/scoring.js +9 -1
  150. package/dist/aura3d-cli/pull-bridge/scoring.js.map +1 -1
  151. package/dist/aura3d-cli/pull-bridge/search.js +2 -2
  152. package/dist/aura3d-cli/pull-bridge/search.js.map +1 -1
  153. package/dist/aura3d-cli/pull-bridge.d.ts +15 -3
  154. package/dist/aura3d-cli/pull-bridge.d.ts.map +1 -1
  155. package/dist/aura3d-cli/pull-bridge.js +68 -5
  156. package/dist/aura3d-cli/pull-bridge.js.map +1 -1
  157. package/dist/controls/ArcballControls.d.ts +92 -0
  158. package/dist/controls/ArcballControls.d.ts.map +1 -0
  159. package/dist/controls/ArcballControls.js +286 -0
  160. package/dist/controls/ArcballControls.js.map +1 -0
  161. package/dist/controls/DragControls.d.ts +13 -0
  162. package/dist/controls/DragControls.d.ts.map +1 -1
  163. package/dist/controls/DragControls.js +24 -1
  164. package/dist/controls/DragControls.js.map +1 -1
  165. package/dist/controls/FlyControls.d.ts +9 -0
  166. package/dist/controls/FlyControls.d.ts.map +1 -1
  167. package/dist/controls/FlyControls.js +20 -2
  168. package/dist/controls/FlyControls.js.map +1 -1
  169. package/dist/controls/FocusFrame.d.ts +34 -0
  170. package/dist/controls/FocusFrame.d.ts.map +1 -0
  171. package/dist/controls/FocusFrame.js +82 -0
  172. package/dist/controls/FocusFrame.js.map +1 -0
  173. package/dist/controls/HoverOutline.d.ts +46 -0
  174. package/dist/controls/HoverOutline.d.ts.map +1 -0
  175. package/dist/controls/HoverOutline.js +87 -0
  176. package/dist/controls/HoverOutline.js.map +1 -0
  177. package/dist/controls/InteractionControls.d.ts +7 -0
  178. package/dist/controls/InteractionControls.d.ts.map +1 -1
  179. package/dist/controls/InteractionControls.js +12 -1
  180. package/dist/controls/InteractionControls.js.map +1 -1
  181. package/dist/controls/NativeControlTypes.d.ts +17 -0
  182. package/dist/controls/NativeControlTypes.d.ts.map +1 -1
  183. package/dist/controls/NativeControlTypes.js.map +1 -1
  184. package/dist/controls/OrbitControls.d.ts +9 -0
  185. package/dist/controls/OrbitControls.d.ts.map +1 -1
  186. package/dist/controls/OrbitControls.js +26 -6
  187. package/dist/controls/OrbitControls.js.map +1 -1
  188. package/dist/controls/Picking.d.ts +15 -0
  189. package/dist/controls/Picking.d.ts.map +1 -1
  190. package/dist/controls/Picking.js +62 -23
  191. package/dist/controls/Picking.js.map +1 -1
  192. package/dist/controls/PointerLockControls.d.ts.map +1 -1
  193. package/dist/controls/PointerLockControls.js +4 -0
  194. package/dist/controls/PointerLockControls.js.map +1 -1
  195. package/dist/controls/SelectionManager.d.ts +8 -0
  196. package/dist/controls/SelectionManager.d.ts.map +1 -1
  197. package/dist/controls/SelectionManager.js +11 -0
  198. package/dist/controls/SelectionManager.js.map +1 -1
  199. package/dist/controls/TrackballControls.d.ts +7 -0
  200. package/dist/controls/TrackballControls.d.ts.map +1 -1
  201. package/dist/controls/TrackballControls.js +19 -5
  202. package/dist/controls/TrackballControls.js.map +1 -1
  203. package/dist/controls/TransformControls.d.ts +8 -0
  204. package/dist/controls/TransformControls.d.ts.map +1 -1
  205. package/dist/controls/TransformControls.js +15 -2
  206. package/dist/controls/TransformControls.js.map +1 -1
  207. package/dist/controls/index.d.ts +6 -0
  208. package/dist/controls/index.d.ts.map +1 -1
  209. package/dist/controls/index.js +3 -0
  210. package/dist/controls/index.js.map +1 -1
  211. package/dist/create-aura3d/index.js +1 -1
  212. package/dist/create-aura3d/showcase-spec-game-geometry-extractor.d.ts.map +1 -1
  213. package/dist/create-aura3d/showcase-spec-game-geometry-extractor.js +86 -4
  214. package/dist/create-aura3d/showcase-spec-game-geometry-extractor.js.map +1 -1
  215. package/dist/editor-runtime/RootEditorSurface.d.ts +65 -0
  216. package/dist/editor-runtime/RootEditorSurface.d.ts.map +1 -0
  217. package/dist/editor-runtime/RootEditorSurface.js +62 -0
  218. package/dist/editor-runtime/RootEditorSurface.js.map +1 -0
  219. package/dist/editor-runtime/index.d.ts +2 -0
  220. package/dist/editor-runtime/index.d.ts.map +1 -1
  221. package/dist/editor-runtime/index.js +1 -0
  222. package/dist/editor-runtime/index.js.map +1 -1
  223. package/dist/engine/agent-api/AnimationController.d.ts +9 -1
  224. package/dist/engine/agent-api/AnimationController.d.ts.map +1 -1
  225. package/dist/engine/agent-api/AnimationController.js +5 -1
  226. package/dist/engine/agent-api/AnimationController.js.map +1 -1
  227. package/dist/engine/agent-api/AnimationDebugOverlay.d.ts +56 -0
  228. package/dist/engine/agent-api/AnimationDebugOverlay.d.ts.map +1 -0
  229. package/dist/engine/agent-api/AnimationDebugOverlay.js +148 -0
  230. package/dist/engine/agent-api/AnimationDebugOverlay.js.map +1 -0
  231. package/dist/engine/agent-api/AnimationMixerBuilders.d.ts +41 -0
  232. package/dist/engine/agent-api/AnimationMixerBuilders.d.ts.map +1 -0
  233. package/dist/engine/agent-api/AnimationMixerBuilders.js +146 -0
  234. package/dist/engine/agent-api/AnimationMixerBuilders.js.map +1 -0
  235. package/dist/engine/agent-api/AssetDecoders.d.ts +17 -0
  236. package/dist/engine/agent-api/AssetDecoders.d.ts.map +1 -0
  237. package/dist/engine/agent-api/AssetDecoders.js +18 -0
  238. package/dist/engine/agent-api/AssetDecoders.js.map +1 -0
  239. package/dist/engine/agent-api/Decals.d.ts +174 -0
  240. package/dist/engine/agent-api/Decals.d.ts.map +1 -0
  241. package/dist/engine/agent-api/Decals.js +350 -0
  242. package/dist/engine/agent-api/Decals.js.map +1 -0
  243. package/dist/engine/agent-api/FootPlanting.d.ts +75 -0
  244. package/dist/engine/agent-api/FootPlanting.d.ts.map +1 -0
  245. package/dist/engine/agent-api/FootPlanting.js +60 -0
  246. package/dist/engine/agent-api/FootPlanting.js.map +1 -0
  247. package/dist/engine/agent-api/GameAppRuntime.d.ts +19 -0
  248. package/dist/engine/agent-api/GameAppRuntime.d.ts.map +1 -1
  249. package/dist/engine/agent-api/GameAppRuntime.js +37 -1
  250. package/dist/engine/agent-api/GameAppRuntime.js.map +1 -1
  251. package/dist/engine/agent-api/GameCameraRigs.d.ts +185 -0
  252. package/dist/engine/agent-api/GameCameraRigs.d.ts.map +1 -0
  253. package/dist/engine/agent-api/GameCameraRigs.js +414 -0
  254. package/dist/engine/agent-api/GameCameraRigs.js.map +1 -0
  255. package/dist/engine/agent-api/GameFeel.d.ts +100 -0
  256. package/dist/engine/agent-api/GameFeel.d.ts.map +1 -0
  257. package/dist/engine/agent-api/GameFeel.js +226 -0
  258. package/dist/engine/agent-api/GameFeel.js.map +1 -0
  259. package/dist/engine/agent-api/GameGenreKits.d.ts.map +1 -1
  260. package/dist/engine/agent-api/GameGenreKits.js +26 -3
  261. package/dist/engine/agent-api/GameGenreKits.js.map +1 -1
  262. package/dist/engine/agent-api/LabelTelemetry.d.ts +108 -0
  263. package/dist/engine/agent-api/LabelTelemetry.d.ts.map +1 -0
  264. package/dist/engine/agent-api/LabelTelemetry.js +116 -0
  265. package/dist/engine/agent-api/LabelTelemetry.js.map +1 -0
  266. package/dist/engine/agent-api/NavigationCrowds.d.ts +146 -0
  267. package/dist/engine/agent-api/NavigationCrowds.d.ts.map +1 -0
  268. package/dist/engine/agent-api/NavigationCrowds.js +104 -0
  269. package/dist/engine/agent-api/NavigationCrowds.js.map +1 -0
  270. package/dist/engine/agent-api/PhysicsRuntime.d.ts +61 -5
  271. package/dist/engine/agent-api/PhysicsRuntime.d.ts.map +1 -1
  272. package/dist/engine/agent-api/PhysicsRuntime.js +53 -21
  273. package/dist/engine/agent-api/PhysicsRuntime.js.map +1 -1
  274. package/dist/engine/agent-api/RootGeometry.d.ts +16 -1
  275. package/dist/engine/agent-api/RootGeometry.d.ts.map +1 -1
  276. package/dist/engine/agent-api/RootGeometry.js.map +1 -1
  277. package/dist/engine/agent-api/RuntimeNodeHandle.d.ts +6 -0
  278. package/dist/engine/agent-api/RuntimeNodeHandle.d.ts.map +1 -1
  279. package/dist/engine/agent-api/RuntimeNodeHandle.js.map +1 -1
  280. package/dist/engine/agent-api/Scatter.d.ts +18 -0
  281. package/dist/engine/agent-api/Scatter.d.ts.map +1 -0
  282. package/dist/engine/agent-api/Scatter.js +18 -0
  283. package/dist/engine/agent-api/Scatter.js.map +1 -0
  284. package/dist/engine/agent-api/TouchControlBinding.d.ts +32 -0
  285. package/dist/engine/agent-api/TouchControlBinding.d.ts.map +1 -1
  286. package/dist/engine/agent-api/TouchControlBinding.js +36 -0
  287. package/dist/engine/agent-api/TouchControlBinding.js.map +1 -1
  288. package/dist/engine/agent-api/VehicleChassis.d.ts.map +1 -1
  289. package/dist/engine/agent-api/VehicleChassis.js +76 -13
  290. package/dist/engine/agent-api/VehicleChassis.js.map +1 -1
  291. package/dist/engine/agent-api/index.d.ts +723 -6
  292. package/dist/engine/agent-api/index.d.ts.map +1 -1
  293. package/dist/engine/agent-api/index.js +1805 -137
  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/TypedGLBActor.d.ts +36 -2
  315. package/dist/engine/production-runtime/TypedGLBActor.d.ts.map +1 -1
  316. package/dist/engine/production-runtime/TypedGLBActor.js +92 -5
  317. package/dist/engine/production-runtime/TypedGLBActor.js.map +1 -1
  318. package/dist/engine/production-runtime/index.d.ts +4 -4
  319. package/dist/engine/production-runtime/index.d.ts.map +1 -1
  320. package/dist/engine/production-runtime/index.js +5 -3
  321. package/dist/engine/production-runtime/index.js.map +1 -1
  322. package/dist/input/ActionMap.d.ts +40 -0
  323. package/dist/input/ActionMap.d.ts.map +1 -1
  324. package/dist/input/ActionMap.js +179 -0
  325. package/dist/input/ActionMap.js.map +1 -1
  326. package/dist/input/ComboDetector.d.ts +49 -0
  327. package/dist/input/ComboDetector.d.ts.map +1 -0
  328. package/dist/input/ComboDetector.js +102 -0
  329. package/dist/input/ComboDetector.js.map +1 -0
  330. package/dist/input/Haptics.d.ts +46 -0
  331. package/dist/input/Haptics.d.ts.map +1 -0
  332. package/dist/input/Haptics.js +67 -0
  333. package/dist/input/Haptics.js.map +1 -0
  334. package/dist/input/TouchLayouts.d.ts +35 -0
  335. package/dist/input/TouchLayouts.d.ts.map +1 -0
  336. package/dist/input/TouchLayouts.js +88 -0
  337. package/dist/input/TouchLayouts.js.map +1 -0
  338. package/dist/input/WebXRSessionController.d.ts +53 -0
  339. package/dist/input/WebXRSessionController.d.ts.map +1 -1
  340. package/dist/input/WebXRSessionController.js +88 -2
  341. package/dist/input/WebXRSessionController.js.map +1 -1
  342. package/dist/input/index.d.ts +8 -2
  343. package/dist/input/index.d.ts.map +1 -1
  344. package/dist/input/index.js +3 -0
  345. package/dist/input/index.js.map +1 -1
  346. package/dist/lean/game.d.ts +98 -0
  347. package/dist/lean/game.d.ts.map +1 -1
  348. package/dist/lean/game.js +192 -0
  349. package/dist/lean/game.js.map +1 -1
  350. package/dist/materials/GameReadyMaterialLibrary.d.ts +39 -0
  351. package/dist/materials/GameReadyMaterialLibrary.d.ts.map +1 -0
  352. package/dist/materials/GameReadyMaterialLibrary.js +253 -0
  353. package/dist/materials/GameReadyMaterialLibrary.js.map +1 -0
  354. package/dist/materials/MaterialValidation.d.ts +21 -0
  355. package/dist/materials/MaterialValidation.d.ts.map +1 -1
  356. package/dist/materials/MaterialValidation.js +105 -0
  357. package/dist/materials/MaterialValidation.js.map +1 -1
  358. package/dist/materials/browser-index.d.ts +2 -0
  359. package/dist/materials/browser-index.d.ts.map +1 -1
  360. package/dist/materials/browser-index.js +1 -0
  361. package/dist/materials/browser-index.js.map +1 -1
  362. package/dist/materials/node.d.ts +2 -2
  363. package/dist/materials/node.d.ts.map +1 -1
  364. package/dist/materials/node.js +1 -1
  365. package/dist/materials/node.js.map +1 -1
  366. package/dist/physics/CollisionVolumes.d.ts +59 -0
  367. package/dist/physics/CollisionVolumes.d.ts.map +1 -1
  368. package/dist/physics/CollisionVolumes.js +87 -0
  369. package/dist/physics/CollisionVolumes.js.map +1 -1
  370. package/dist/physics/PhysicsDebugDraw.d.ts +37 -0
  371. package/dist/physics/PhysicsDebugDraw.d.ts.map +1 -1
  372. package/dist/physics/PhysicsDebugDraw.js +38 -1
  373. package/dist/physics/PhysicsDebugDraw.js.map +1 -1
  374. package/dist/physics/PhysicsWorld.d.ts +15 -0
  375. package/dist/physics/PhysicsWorld.d.ts.map +1 -1
  376. package/dist/physics/PhysicsWorld.js +8 -1
  377. package/dist/physics/PhysicsWorld.js.map +1 -1
  378. package/dist/physics/solverless.d.ts +1 -1
  379. package/dist/physics/solverless.d.ts.map +1 -1
  380. package/dist/physics/solverless.js.map +1 -1
  381. package/dist/physics-rapier/index.d.ts +7 -1
  382. package/dist/physics-rapier/index.d.ts.map +1 -1
  383. package/dist/physics-rapier/index.js +1 -1
  384. package/dist/physics-rapier/index.js.map +1 -1
  385. package/dist/react/index.d.ts +136 -2
  386. package/dist/react/index.d.ts.map +1 -1
  387. package/dist/react/index.js +251 -10
  388. package/dist/react/index.js.map +1 -1
  389. package/dist/rendering/AtmosphereWetness.d.ts +61 -0
  390. package/dist/rendering/AtmosphereWetness.d.ts.map +1 -0
  391. package/dist/rendering/AtmosphereWetness.js +99 -0
  392. package/dist/rendering/AtmosphereWetness.js.map +1 -0
  393. package/dist/rendering/ClusteredForwardLighting.d.ts +25 -1
  394. package/dist/rendering/ClusteredForwardLighting.d.ts.map +1 -1
  395. package/dist/rendering/ClusteredForwardLighting.js +80 -3
  396. package/dist/rendering/ClusteredForwardLighting.js.map +1 -1
  397. package/dist/rendering/DayNightSky.d.ts +63 -0
  398. package/dist/rendering/DayNightSky.d.ts.map +1 -0
  399. package/dist/rendering/DayNightSky.js +156 -0
  400. package/dist/rendering/DayNightSky.js.map +1 -0
  401. package/dist/rendering/EnvironmentPresetPack.d.ts +30 -0
  402. package/dist/rendering/EnvironmentPresetPack.d.ts.map +1 -0
  403. package/dist/rendering/EnvironmentPresetPack.js +49 -0
  404. package/dist/rendering/EnvironmentPresetPack.js.map +1 -0
  405. package/dist/rendering/ForwardPass.d.ts +67 -0
  406. package/dist/rendering/ForwardPass.d.ts.map +1 -1
  407. package/dist/rendering/ForwardPass.js +196 -2
  408. package/dist/rendering/ForwardPass.js.map +1 -1
  409. package/dist/rendering/InstancedPBRMaterial.d.ts +1 -0
  410. package/dist/rendering/InstancedPBRMaterial.d.ts.map +1 -1
  411. package/dist/rendering/InstancedPBRMaterial.js +3 -0
  412. package/dist/rendering/InstancedPBRMaterial.js.map +1 -1
  413. package/dist/rendering/InstancingDiagnostics.d.ts +69 -0
  414. package/dist/rendering/InstancingDiagnostics.d.ts.map +1 -0
  415. package/dist/rendering/InstancingDiagnostics.js +98 -0
  416. package/dist/rendering/InstancingDiagnostics.js.map +1 -0
  417. package/dist/rendering/LightingRig.d.ts +19 -1
  418. package/dist/rendering/LightingRig.d.ts.map +1 -1
  419. package/dist/rendering/LightingRig.js +61 -1
  420. package/dist/rendering/LightingRig.js.map +1 -1
  421. package/dist/rendering/MeshConsolidation.d.ts +12 -0
  422. package/dist/rendering/MeshConsolidation.d.ts.map +1 -1
  423. package/dist/rendering/MeshConsolidation.js +28 -0
  424. package/dist/rendering/MeshConsolidation.js.map +1 -1
  425. package/dist/rendering/MorphTargetPlan.d.ts +29 -2
  426. package/dist/rendering/MorphTargetPlan.d.ts.map +1 -1
  427. package/dist/rendering/MorphTargetPlan.js +23 -4
  428. package/dist/rendering/MorphTargetPlan.js.map +1 -1
  429. package/dist/rendering/NormalMappedPBRMaterial.d.ts.map +1 -1
  430. package/dist/rendering/NormalMappedPBRMaterial.js +22 -2
  431. package/dist/rendering/NormalMappedPBRMaterial.js.map +1 -1
  432. package/dist/rendering/OceanSurface.d.ts +75 -0
  433. package/dist/rendering/OceanSurface.d.ts.map +1 -1
  434. package/dist/rendering/OceanSurface.js +211 -0
  435. package/dist/rendering/OceanSurface.js.map +1 -1
  436. package/dist/rendering/PBRMaterial.d.ts +1 -0
  437. package/dist/rendering/PBRMaterial.d.ts.map +1 -1
  438. package/dist/rendering/PBRMaterial.js +23 -2
  439. package/dist/rendering/PBRMaterial.js.map +1 -1
  440. package/dist/rendering/PbrReference.d.ts +48 -0
  441. package/dist/rendering/PbrReference.d.ts.map +1 -1
  442. package/dist/rendering/PbrReference.js +126 -0
  443. package/dist/rendering/PbrReference.js.map +1 -1
  444. package/dist/rendering/PlanarReflection.d.ts +221 -0
  445. package/dist/rendering/PlanarReflection.d.ts.map +1 -0
  446. package/dist/rendering/PlanarReflection.js +541 -0
  447. package/dist/rendering/PlanarReflection.js.map +1 -0
  448. package/dist/rendering/PostProcessPass.d.ts +13 -0
  449. package/dist/rendering/PostProcessPass.d.ts.map +1 -1
  450. package/dist/rendering/PostProcessPass.js +15 -4
  451. package/dist/rendering/PostProcessPass.js.map +1 -1
  452. package/dist/rendering/ReflectionSurfaces.d.ts +14 -0
  453. package/dist/rendering/ReflectionSurfaces.d.ts.map +1 -1
  454. package/dist/rendering/ReflectionSurfaces.js +93 -0
  455. package/dist/rendering/ReflectionSurfaces.js.map +1 -1
  456. package/dist/rendering/RenderDevice.d.ts +87 -0
  457. package/dist/rendering/RenderDevice.d.ts.map +1 -1
  458. package/dist/rendering/RenderDevice.js +85 -0
  459. package/dist/rendering/RenderDevice.js.map +1 -1
  460. package/dist/rendering/Renderer.js +8 -5
  461. package/dist/rendering/Renderer.js.map +1 -1
  462. package/dist/rendering/RendererPostprocessPlan.d.ts +48 -0
  463. package/dist/rendering/RendererPostprocessPlan.d.ts.map +1 -1
  464. package/dist/rendering/RendererPostprocessPlan.js +101 -11
  465. package/dist/rendering/RendererPostprocessPlan.js.map +1 -1
  466. package/dist/rendering/RendererVisualPipelineReport.d.ts.map +1 -1
  467. package/dist/rendering/RendererVisualPipelineReport.js +3 -1
  468. package/dist/rendering/RendererVisualPipelineReport.js.map +1 -1
  469. package/dist/rendering/Sampler.d.ts +29 -0
  470. package/dist/rendering/Sampler.d.ts.map +1 -1
  471. package/dist/rendering/Sampler.js +47 -0
  472. package/dist/rendering/Sampler.js.map +1 -1
  473. package/dist/rendering/SceneOptimization.d.ts +1 -0
  474. package/dist/rendering/SceneOptimization.d.ts.map +1 -1
  475. package/dist/rendering/SceneOptimization.js +4 -2
  476. package/dist/rendering/SceneOptimization.js.map +1 -1
  477. package/dist/rendering/SdfText.d.ts +250 -0
  478. package/dist/rendering/SdfText.d.ts.map +1 -0
  479. package/dist/rendering/SdfText.js +551 -0
  480. package/dist/rendering/SdfText.js.map +1 -0
  481. package/dist/rendering/ShaderChunks.d.ts.map +1 -1
  482. package/dist/rendering/ShaderChunks.js +30 -12
  483. package/dist/rendering/ShaderChunks.js.map +1 -1
  484. package/dist/rendering/ShaderLibrary.d.ts.map +1 -1
  485. package/dist/rendering/ShaderLibrary.js +478 -34
  486. package/dist/rendering/ShaderLibrary.js.map +1 -1
  487. package/dist/rendering/ShaderLibraryCore.d.ts.map +1 -1
  488. package/dist/rendering/ShaderLibraryCore.js +70 -12
  489. package/dist/rendering/ShaderLibraryCore.js.map +1 -1
  490. package/dist/rendering/ShadowMap.d.ts +24 -0
  491. package/dist/rendering/ShadowMap.d.ts.map +1 -1
  492. package/dist/rendering/ShadowMap.js +43 -0
  493. package/dist/rendering/ShadowMap.js.map +1 -1
  494. package/dist/rendering/SkinnedLitMaterial.d.ts.map +1 -1
  495. package/dist/rendering/SkinnedLitMaterial.js +2 -0
  496. package/dist/rendering/SkinnedLitMaterial.js.map +1 -1
  497. package/dist/rendering/SkinningBounds.d.ts +10 -0
  498. package/dist/rendering/SkinningBounds.d.ts.map +1 -1
  499. package/dist/rendering/SkinningBounds.js +27 -0
  500. package/dist/rendering/SkinningBounds.js.map +1 -1
  501. package/dist/rendering/SpriteFlipbook.d.ts +60 -0
  502. package/dist/rendering/SpriteFlipbook.d.ts.map +1 -0
  503. package/dist/rendering/SpriteFlipbook.js +128 -0
  504. package/dist/rendering/SpriteFlipbook.js.map +1 -0
  505. package/dist/rendering/TerrainTiles.d.ts +120 -0
  506. package/dist/rendering/TerrainTiles.d.ts.map +1 -0
  507. package/dist/rendering/TerrainTiles.js +221 -0
  508. package/dist/rendering/TerrainTiles.js.map +1 -0
  509. package/dist/rendering/TexturedPBRMaterial.d.ts +1 -0
  510. package/dist/rendering/TexturedPBRMaterial.d.ts.map +1 -1
  511. package/dist/rendering/TexturedPBRMaterial.js +23 -2
  512. package/dist/rendering/TexturedPBRMaterial.js.map +1 -1
  513. package/dist/rendering/TexturedUnlitMaterial.d.ts.map +1 -1
  514. package/dist/rendering/TexturedUnlitMaterial.js +20 -2
  515. package/dist/rendering/TexturedUnlitMaterial.js.map +1 -1
  516. package/dist/rendering/UnlitMaterial.d.ts.map +1 -1
  517. package/dist/rendering/UnlitMaterial.js +20 -2
  518. package/dist/rendering/UnlitMaterial.js.map +1 -1
  519. package/dist/rendering/VertexFormat.d.ts +6 -0
  520. package/dist/rendering/VertexFormat.d.ts.map +1 -1
  521. package/dist/rendering/VertexFormat.js +12 -0
  522. package/dist/rendering/VertexFormat.js.map +1 -1
  523. package/dist/rendering/VolumetricFog.d.ts +55 -0
  524. package/dist/rendering/VolumetricFog.d.ts.map +1 -0
  525. package/dist/rendering/VolumetricFog.js +91 -0
  526. package/dist/rendering/VolumetricFog.js.map +1 -0
  527. package/dist/rendering/WaterSurface.d.ts +77 -0
  528. package/dist/rendering/WaterSurface.d.ts.map +1 -0
  529. package/dist/rendering/WaterSurface.js +133 -0
  530. package/dist/rendering/WaterSurface.js.map +1 -0
  531. package/dist/rendering/WebGL2Device.d.ts +58 -0
  532. package/dist/rendering/WebGL2Device.d.ts.map +1 -1
  533. package/dist/rendering/WebGL2Device.js +536 -17
  534. package/dist/rendering/WebGL2Device.js.map +1 -1
  535. package/dist/rendering/WebGPUDevice.d.ts +50 -0
  536. package/dist/rendering/WebGPUDevice.d.ts.map +1 -1
  537. package/dist/rendering/WebGPUDevice.js +504 -10
  538. package/dist/rendering/WebGPUDevice.js.map +1 -1
  539. package/dist/rendering/WebGPUSkinningLimits.d.ts +40 -0
  540. package/dist/rendering/WebGPUSkinningLimits.d.ts.map +1 -1
  541. package/dist/rendering/WebGPUSkinningLimits.js +32 -0
  542. package/dist/rendering/WebGPUSkinningLimits.js.map +1 -1
  543. package/dist/rendering/effects/CollisionModule.d.ts +9 -0
  544. package/dist/rendering/effects/CollisionModule.d.ts.map +1 -1
  545. package/dist/rendering/effects/CollisionModule.js +10 -0
  546. package/dist/rendering/effects/CollisionModule.js.map +1 -1
  547. package/dist/rendering/effects/ColorModule.d.ts +7 -0
  548. package/dist/rendering/effects/ColorModule.d.ts.map +1 -1
  549. package/dist/rendering/effects/ColorModule.js +23 -0
  550. package/dist/rendering/effects/ColorModule.js.map +1 -1
  551. package/dist/rendering/effects/ForceModule.d.ts +35 -0
  552. package/dist/rendering/effects/ForceModule.d.ts.map +1 -1
  553. package/dist/rendering/effects/ForceModule.js +49 -0
  554. package/dist/rendering/effects/ForceModule.js.map +1 -1
  555. package/dist/rendering/effects/GPUParticleBackend.d.ts +186 -0
  556. package/dist/rendering/effects/GPUParticleBackend.d.ts.map +1 -1
  557. package/dist/rendering/effects/GPUParticleBackend.js +692 -1
  558. package/dist/rendering/effects/GPUParticleBackend.js.map +1 -1
  559. package/dist/rendering/effects/HeightfieldModule.d.ts +58 -0
  560. package/dist/rendering/effects/HeightfieldModule.d.ts.map +1 -0
  561. package/dist/rendering/effects/HeightfieldModule.js +129 -0
  562. package/dist/rendering/effects/HeightfieldModule.js.map +1 -0
  563. package/dist/rendering/effects/LightingModule.d.ts +34 -0
  564. package/dist/rendering/effects/LightingModule.d.ts.map +1 -0
  565. package/dist/rendering/effects/LightingModule.js +54 -0
  566. package/dist/rendering/effects/LightingModule.js.map +1 -0
  567. package/dist/rendering/effects/ParticleDiagnostics.d.ts +8 -0
  568. package/dist/rendering/effects/ParticleDiagnostics.d.ts.map +1 -1
  569. package/dist/rendering/effects/ParticleDiagnostics.js +3 -0
  570. package/dist/rendering/effects/ParticleDiagnostics.js.map +1 -1
  571. package/dist/rendering/effects/ParticleModule.d.ts +8 -0
  572. package/dist/rendering/effects/ParticleModule.d.ts.map +1 -1
  573. package/dist/rendering/effects/ParticleModule.js.map +1 -1
  574. package/dist/rendering/effects/ParticleRenderer.d.ts +20 -0
  575. package/dist/rendering/effects/ParticleRenderer.d.ts.map +1 -1
  576. package/dist/rendering/effects/ParticleRenderer.js +57 -7
  577. package/dist/rendering/effects/ParticleRenderer.js.map +1 -1
  578. package/dist/rendering/effects/ParticleSystem.d.ts +45 -1
  579. package/dist/rendering/effects/ParticleSystem.d.ts.map +1 -1
  580. package/dist/rendering/effects/ParticleSystem.js +373 -4
  581. package/dist/rendering/effects/ParticleSystem.js.map +1 -1
  582. package/dist/rendering/effects/SizeModule.d.ts +4 -0
  583. package/dist/rendering/effects/SizeModule.d.ts.map +1 -1
  584. package/dist/rendering/effects/SizeModule.js +16 -0
  585. package/dist/rendering/effects/SizeModule.js.map +1 -1
  586. package/dist/rendering/effects/SubEmitterModule.d.ts +61 -0
  587. package/dist/rendering/effects/SubEmitterModule.d.ts.map +1 -0
  588. package/dist/rendering/effects/SubEmitterModule.js +119 -0
  589. package/dist/rendering/effects/SubEmitterModule.js.map +1 -0
  590. package/dist/rendering/effects/TrailModule.d.ts +38 -0
  591. package/dist/rendering/effects/TrailModule.d.ts.map +1 -1
  592. package/dist/rendering/effects/TrailModule.js +95 -2
  593. package/dist/rendering/effects/TrailModule.js.map +1 -1
  594. package/dist/rendering/effects/TurbulenceModule.d.ts +43 -0
  595. package/dist/rendering/effects/TurbulenceModule.d.ts.map +1 -0
  596. package/dist/rendering/effects/TurbulenceModule.js +130 -0
  597. package/dist/rendering/effects/TurbulenceModule.js.map +1 -0
  598. package/dist/rendering/effects/index.d.ts +4 -0
  599. package/dist/rendering/effects/index.d.ts.map +1 -1
  600. package/dist/rendering/effects/index.js +4 -0
  601. package/dist/rendering/effects/index.js.map +1 -1
  602. package/dist/rendering/index.d.ts +57 -19
  603. package/dist/rendering/index.d.ts.map +1 -1
  604. package/dist/rendering/index.js +31 -10
  605. package/dist/rendering/index.js.map +1 -1
  606. package/dist/rendering/materials/MaterialExtensions.js +3 -3
  607. package/dist/rendering/materials/MaterialExtensions.js.map +1 -1
  608. package/dist/rendering/postprocess/NativeBloomPyramid.d.ts +28 -0
  609. package/dist/rendering/postprocess/NativeBloomPyramid.d.ts.map +1 -0
  610. package/dist/rendering/postprocess/NativeBloomPyramid.js +54 -0
  611. package/dist/rendering/postprocess/NativeBloomPyramid.js.map +1 -0
  612. package/dist/rendering/postprocess/NativeLdrEffectLuts.d.ts +10 -1
  613. package/dist/rendering/postprocess/NativeLdrEffectLuts.d.ts.map +1 -1
  614. package/dist/rendering/postprocess/NativeLdrEffectLuts.js +19 -2
  615. package/dist/rendering/postprocess/NativeLdrEffectLuts.js.map +1 -1
  616. package/dist/rendering/postprocess/index.d.ts +2 -0
  617. package/dist/rendering/postprocess/index.d.ts.map +1 -1
  618. package/dist/rendering/postprocess/index.js +1 -0
  619. package/dist/rendering/postprocess/index.js.map +1 -1
  620. package/dist/rendering/production-runtime/PBRHDRPipeline.d.ts +22 -0
  621. package/dist/rendering/production-runtime/PBRHDRPipeline.d.ts.map +1 -1
  622. package/dist/rendering/production-runtime/PBRHDRPipeline.js +125 -0
  623. package/dist/rendering/production-runtime/PBRHDRPipeline.js.map +1 -1
  624. package/dist/rendering/production-runtime/ProductionWebGPURenderer.d.ts +52 -0
  625. package/dist/rendering/production-runtime/ProductionWebGPURenderer.d.ts.map +1 -1
  626. package/dist/rendering/production-runtime/ProductionWebGPURenderer.js +101 -0
  627. package/dist/rendering/production-runtime/ProductionWebGPURenderer.js.map +1 -1
  628. package/dist/rendering/production-runtime/index.d.ts +5 -4
  629. package/dist/rendering/production-runtime/index.d.ts.map +1 -1
  630. package/dist/rendering/production-runtime/index.js +3 -2
  631. package/dist/rendering/production-runtime/index.js.map +1 -1
  632. package/dist/rendering/production-runtime/passes/DepthPrepass.d.ts +26 -1
  633. package/dist/rendering/production-runtime/passes/DepthPrepass.d.ts.map +1 -1
  634. package/dist/rendering/production-runtime/passes/DepthPrepass.js +49 -2
  635. package/dist/rendering/production-runtime/passes/DepthPrepass.js.map +1 -1
  636. package/dist/rendering/production-runtime/passes/FramegraphTopology.d.ts +13 -0
  637. package/dist/rendering/production-runtime/passes/FramegraphTopology.d.ts.map +1 -0
  638. package/dist/rendering/production-runtime/passes/FramegraphTopology.js +59 -0
  639. package/dist/rendering/production-runtime/passes/FramegraphTopology.js.map +1 -0
  640. package/dist/rendering/production-runtime/passes/OpaquePass.d.ts +24 -1
  641. package/dist/rendering/production-runtime/passes/OpaquePass.d.ts.map +1 -1
  642. package/dist/rendering/production-runtime/passes/OpaquePass.js +41 -2
  643. package/dist/rendering/production-runtime/passes/OpaquePass.js.map +1 -1
  644. package/dist/rendering/production-runtime/passes/ShadowPass.d.ts +24 -1
  645. package/dist/rendering/production-runtime/passes/ShadowPass.d.ts.map +1 -1
  646. package/dist/rendering/production-runtime/passes/ShadowPass.js +43 -2
  647. package/dist/rendering/production-runtime/passes/ShadowPass.js.map +1 -1
  648. package/dist/rendering/production-runtime/passes/SkyboxPass.d.ts +21 -1
  649. package/dist/rendering/production-runtime/passes/SkyboxPass.d.ts.map +1 -1
  650. package/dist/rendering/production-runtime/passes/SkyboxPass.js +39 -2
  651. package/dist/rendering/production-runtime/passes/SkyboxPass.js.map +1 -1
  652. package/dist/rendering/production-runtime/passes/ToneMappingPass.d.ts +29 -1
  653. package/dist/rendering/production-runtime/passes/ToneMappingPass.d.ts.map +1 -1
  654. package/dist/rendering/production-runtime/passes/ToneMappingPass.js +53 -2
  655. package/dist/rendering/production-runtime/passes/ToneMappingPass.js.map +1 -1
  656. package/dist/rendering/production-runtime/passes/TransparentPass.d.ts +24 -1
  657. package/dist/rendering/production-runtime/passes/TransparentPass.d.ts.map +1 -1
  658. package/dist/rendering/production-runtime/passes/TransparentPass.js +42 -2
  659. package/dist/rendering/production-runtime/passes/TransparentPass.js.map +1 -1
  660. package/dist/rendering/shadows/CascadeHysteresis.d.ts +67 -0
  661. package/dist/rendering/shadows/CascadeHysteresis.d.ts.map +1 -0
  662. package/dist/rendering/shadows/CascadeHysteresis.js +104 -0
  663. package/dist/rendering/shadows/CascadeHysteresis.js.map +1 -0
  664. package/dist/rendering/shadows/ContactShadows.d.ts +52 -0
  665. package/dist/rendering/shadows/ContactShadows.d.ts.map +1 -1
  666. package/dist/rendering/shadows/ContactShadows.js +122 -0
  667. package/dist/rendering/shadows/ContactShadows.js.map +1 -1
  668. package/dist/rendering/shadows/SpotShadowMaps.d.ts +77 -0
  669. package/dist/rendering/shadows/SpotShadowMaps.d.ts.map +1 -0
  670. package/dist/rendering/shadows/SpotShadowMaps.js +106 -0
  671. package/dist/rendering/shadows/SpotShadowMaps.js.map +1 -0
  672. package/dist/rendering/webgpu/WebGPUPostProcess.d.ts +2 -0
  673. package/dist/rendering/webgpu/WebGPUPostProcess.d.ts.map +1 -1
  674. package/dist/rendering/webgpu/WebGPUPostProcess.js +1 -0
  675. package/dist/rendering/webgpu/WebGPUPostProcess.js.map +1 -1
  676. package/dist/rendering/webgpu/WebGPUPostShaders.d.ts +78 -0
  677. package/dist/rendering/webgpu/WebGPUPostShaders.d.ts.map +1 -0
  678. package/dist/rendering/webgpu/WebGPUPostShaders.js +262 -0
  679. package/dist/rendering/webgpu/WebGPUPostShaders.js.map +1 -0
  680. package/dist/scene/Scene.d.ts +8 -1
  681. package/dist/scene/Scene.d.ts.map +1 -1
  682. package/dist/scene/Scene.js +12 -2
  683. package/dist/scene/Scene.js.map +1 -1
  684. package/dist/scripting/VisualGraphContext.d.ts +31 -0
  685. package/dist/scripting/VisualGraphContext.d.ts.map +1 -1
  686. package/dist/scripting/VisualGraphExecutor.d.ts.map +1 -1
  687. package/dist/scripting/VisualGraphExecutor.js +110 -0
  688. package/dist/scripting/VisualGraphExecutor.js.map +1 -1
  689. package/dist/scripting/VisualNodeCatalog.d.ts +1 -1
  690. package/dist/scripting/VisualNodeCatalog.d.ts.map +1 -1
  691. package/dist/scripting/VisualNodeCatalog.js +20 -0
  692. package/dist/scripting/VisualNodeCatalog.js.map +1 -1
  693. package/dist/scripting/VisualScriptingRoot.d.ts +96 -0
  694. package/dist/scripting/VisualScriptingRoot.d.ts.map +1 -0
  695. package/dist/scripting/VisualScriptingRoot.js +150 -0
  696. package/dist/scripting/VisualScriptingRoot.js.map +1 -0
  697. package/dist/scripting/index.d.ts +3 -1
  698. package/dist/scripting/index.d.ts.map +1 -1
  699. package/dist/scripting/index.js +1 -0
  700. package/dist/scripting/index.js.map +1 -1
  701. package/package.json +30 -23
  702. package/templates/cinematic-scene/package.json +1 -1
  703. package/templates/mini-game/package.json +1 -1
  704. package/templates/product-viewer/package.json +1 -1
@@ -0,0 +1,102 @@
1
+ /**
2
+ * Generalized hold / input-buffer / combo detection for the input package.
3
+ *
4
+ * The engine's `createGameInput` already buffers and combos at the route-action
5
+ * layer; this module generalizes the same ideas down at the raw-code layer
6
+ * (keyboard codes, gamepad buttons, touch button ids) so any device feed —
7
+ * including remapped actions resolved back to codes — can drive fighting-game
8
+ * buffering without depending on the engine package.
9
+ */
10
+ const HISTORY_LIMIT = 64;
11
+ export class ComboDetector {
12
+ combos = new Map();
13
+ history = [];
14
+ holdStart = new Map();
15
+ holdFired = new Set();
16
+ defineCombo(definition) {
17
+ if (!definition.id)
18
+ throw new Error("Combo id must be a non-empty string.");
19
+ if (definition.steps.length === 0)
20
+ throw new Error(`Combo "${definition.id}" needs at least one step.`);
21
+ const bufferMs = definition.bufferMs ?? 300;
22
+ if (!Number.isFinite(bufferMs) || bufferMs < 0) {
23
+ throw new Error(`Combo "${definition.id}" bufferMs must be a non-negative finite number.`);
24
+ }
25
+ this.combos.set(definition.id, { ...definition, steps: [...definition.steps] });
26
+ }
27
+ removeCombo(id) {
28
+ return this.combos.delete(id);
29
+ }
30
+ comboIds() {
31
+ return [...this.combos.keys()];
32
+ }
33
+ reset() {
34
+ this.history = [];
35
+ this.holdStart.clear();
36
+ this.holdFired.clear();
37
+ }
38
+ /**
39
+ * Feed one frame; returns combos whose full sequence matched ending this frame.
40
+ * Hold combos fire once per press when the hold duration is reached.
41
+ */
42
+ update(input) {
43
+ const now = input.timeMs;
44
+ const downSet = new Set(input.down);
45
+ for (const code of input.pressed) {
46
+ this.history.push({ code, timeMs: now });
47
+ if (!this.holdStart.has(code))
48
+ this.holdStart.set(code, now);
49
+ }
50
+ if (this.history.length > HISTORY_LIMIT) {
51
+ this.history = this.history.slice(this.history.length - HISTORY_LIMIT);
52
+ }
53
+ for (const [code, start] of [...this.holdStart]) {
54
+ if (!downSet.has(code)) {
55
+ this.holdStart.delete(code);
56
+ this.holdFired.delete(code);
57
+ }
58
+ else if (start > now) {
59
+ this.holdStart.set(code, now);
60
+ }
61
+ }
62
+ const fired = [];
63
+ for (const combo of this.combos.values()) {
64
+ const bufferMs = combo.bufferMs ?? 300;
65
+ const maxInterval = combo.maxIntervalMs ?? bufferMs;
66
+ const recent = this.history.filter((press) => now - press.timeMs <= Math.max(bufferMs, maxInterval));
67
+ if (combo.steps.length === 1 && combo.holdMs !== undefined) {
68
+ const code = combo.steps[0];
69
+ const start = this.holdStart.get(code);
70
+ if (start !== undefined && downSet.has(code) && !this.holdFired.has(combo.id) && now - start >= combo.holdMs) {
71
+ this.holdFired.add(combo.id);
72
+ fired.push({ comboId: combo.id, timeMs: now });
73
+ }
74
+ continue;
75
+ }
76
+ if (input.pressed.length === 0)
77
+ continue;
78
+ if (matchesSequence(recent, combo.steps, maxInterval) && recent[recent.length - 1]?.timeMs === now) {
79
+ fired.push({ comboId: combo.id, timeMs: now });
80
+ }
81
+ }
82
+ return fired;
83
+ }
84
+ /** True while `code` has been continuously held for at least `durationMs` at `nowMs`. */
85
+ held(code, durationMs, nowMs) {
86
+ const start = this.holdStart.get(code);
87
+ return start !== undefined && nowMs - start >= durationMs;
88
+ }
89
+ }
90
+ function matchesSequence(history, steps, maxIntervalMs) {
91
+ if (history.length < steps.length)
92
+ return false;
93
+ const tail = history.slice(history.length - steps.length);
94
+ for (let index = 0; index < steps.length; index += 1) {
95
+ if (tail[index]?.code !== steps[index])
96
+ return false;
97
+ if (index > 0 && tail[index].timeMs - tail[index - 1].timeMs > maxIntervalMs)
98
+ return false;
99
+ }
100
+ return true;
101
+ }
102
+ //# sourceMappingURL=ComboDetector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ComboDetector.js","sourceRoot":"","sources":["../../../../packages/input/src/ComboDetector.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Capability-gated haptics: `navigator.vibrate` patterns plus gamepad rumble
3
+ * (`vibrationActuator.playEffect`). Every entry point probes first and reports
4
+ * `{ played: false, reason }` instead of fake success on unsupported hosts.
5
+ */
6
+ export interface NavigatorVibrateLike {
7
+ vibrate?: (pattern: number | readonly number[]) => boolean;
8
+ }
9
+ export interface GamepadRumbleActuatorLike {
10
+ playEffect?: (type: string, params: Record<string, number>) => Promise<string> | string;
11
+ }
12
+ export interface HapticProbeInput {
13
+ readonly navigatorLike?: NavigatorVibrateLike;
14
+ readonly actuators?: readonly (GamepadRumbleActuatorLike | null | undefined)[];
15
+ }
16
+ export interface HapticsCapability {
17
+ readonly vibrate: boolean;
18
+ readonly gamepadRumble: boolean;
19
+ readonly details: string;
20
+ }
21
+ export interface HapticRequest {
22
+ /** Vibration pattern in ms (single buzz or on/off pulses). */
23
+ readonly pattern?: number | readonly number[];
24
+ /** Rumble intensity in [0, 1]. Defaults to 1 when rumbling without an explicit value. */
25
+ readonly intensity?: number;
26
+ /** Rumble duration in ms. Defaults to 60. */
27
+ readonly durationMs?: number;
28
+ }
29
+ export interface HapticResult {
30
+ readonly played: boolean;
31
+ readonly via: "navigator-vibrate" | "gamepad-rumble" | "none";
32
+ readonly reason: string;
33
+ }
34
+ /** Probe what the host actually supports. Never touches hardware. */
35
+ export declare function probeHaptics(input?: HapticProbeInput): HapticsCapability;
36
+ /**
37
+ * Play a haptic effect through the first capable sink. Prefers gamepad rumble
38
+ * when an actuator is supplied, else falls back to `navigator.vibrate`.
39
+ * Capability-gated: returns `played: false` with a cause instead of claiming
40
+ * feedback on an incapable host.
41
+ */
42
+ export declare function playHaptic(request: HapticRequest, capability: HapticsCapability, sinks?: {
43
+ readonly navigatorLike?: NavigatorVibrateLike;
44
+ readonly actuator?: GamepadRumbleActuatorLike | null;
45
+ }): Promise<HapticResult>;
46
+ //# sourceMappingURL=Haptics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Haptics.d.ts","sourceRoot":"","sources":["../../../../packages/input/src/Haptics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CACzF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,yBAAyB,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;CAChF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC9C,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,MAAM,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,GAAE,gBAAqB,GAAG,iBAAiB,CAO5E;AAYD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAA;CAAO,GAClH,OAAO,CAAC,YAAY,CAAC,CAoCvB"}
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Capability-gated haptics: `navigator.vibrate` patterns plus gamepad rumble
3
+ * (`vibrationActuator.playEffect`). Every entry point probes first and reports
4
+ * `{ played: false, reason }` instead of fake success on unsupported hosts.
5
+ */
6
+ /** Probe what the host actually supports. Never touches hardware. */
7
+ export function probeHaptics(input = {}) {
8
+ const vibrate = typeof input.navigatorLike?.vibrate === "function";
9
+ const gamepadRumble = (input.actuators ?? []).some((actuator) => typeof actuator?.playEffect === "function");
10
+ const parts = [];
11
+ parts.push(vibrate ? "navigator.vibrate available" : "navigator.vibrate unavailable");
12
+ parts.push(gamepadRumble ? "gamepad rumble available" : "gamepad rumble unavailable");
13
+ return { vibrate, gamepadRumble, details: parts.join("; ") };
14
+ }
15
+ function validateRequest(request) {
16
+ if (request.intensity !== undefined && (!Number.isFinite(request.intensity) || request.intensity < 0 || request.intensity > 1)) {
17
+ return "Haptic intensity must be in [0, 1].";
18
+ }
19
+ if (request.durationMs !== undefined && (!Number.isFinite(request.durationMs) || request.durationMs < 0)) {
20
+ return "Haptic durationMs must be a non-negative finite number.";
21
+ }
22
+ return null;
23
+ }
24
+ /**
25
+ * Play a haptic effect through the first capable sink. Prefers gamepad rumble
26
+ * when an actuator is supplied, else falls back to `navigator.vibrate`.
27
+ * Capability-gated: returns `played: false` with a cause instead of claiming
28
+ * feedback on an incapable host.
29
+ */
30
+ export async function playHaptic(request, capability, sinks = {}) {
31
+ const invalid = validateRequest(request);
32
+ if (invalid)
33
+ return { played: false, via: "none", reason: invalid };
34
+ if (sinks.actuator?.playEffect && capability.gamepadRumble) {
35
+ const durationMs = Math.max(0, request.durationMs ?? 60);
36
+ const intensity = request.intensity ?? 1;
37
+ try {
38
+ const outcome = await sinks.actuator.playEffect("dual-rumble", {
39
+ duration: durationMs,
40
+ strongMagnitude: intensity,
41
+ weakMagnitude: intensity
42
+ });
43
+ if (outcome === "complete") {
44
+ return { played: true, via: "gamepad-rumble", reason: "dual-rumble effect completed" };
45
+ }
46
+ return { played: false, via: "none", reason: `gamepad rumble rejected with outcome "${String(outcome)}"` };
47
+ }
48
+ catch (error) {
49
+ return { played: false, via: "none", reason: error instanceof Error ? error.message : String(error) };
50
+ }
51
+ }
52
+ if (sinks.navigatorLike?.vibrate && capability.vibrate) {
53
+ const pattern = request.pattern ?? request.durationMs ?? 60;
54
+ let vibrated = false;
55
+ try {
56
+ vibrated = sinks.navigatorLike.vibrate(pattern) === true;
57
+ }
58
+ catch (error) {
59
+ return { played: false, via: "none", reason: error instanceof Error ? error.message : String(error) };
60
+ }
61
+ return vibrated
62
+ ? { played: true, via: "navigator-vibrate", reason: "vibration pattern accepted" }
63
+ : { played: false, via: "none", reason: "navigator.vibrate returned false" };
64
+ }
65
+ return { played: false, via: "none", reason: `no capable haptic sink (${capability.details})` };
66
+ }
67
+ //# sourceMappingURL=Haptics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Haptics.js","sourceRoot":"","sources":["../../../../packages/input/src/Haptics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,QAA0B,EAAE;IACvD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,aAAa,EAAE,OAAO,KAAK,UAAU,CAAC;IACnE,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC;IAC7G,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;IACtF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,OAAsB;IAC7C,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/H,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QACzG,OAAO,yDAAyD,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAsB,EACtB,UAA6B,EAC7B,QAAiH,EAAE;IAEnH,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAEpE,IAAI,KAAK,CAAC,QAAQ,EAAE,UAAU,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,EAAE;gBAC7D,QAAQ,EAAE,UAAU;gBACpB,eAAe,EAAE,SAAS;gBAC1B,aAAa,EAAE,SAAS;aACzB,CAAC,CAAC;YACH,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;YACzF,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,yCAAyC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxG,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,EAAE,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;QAC5D,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxG,CAAC;QACD,OAAO,QAAQ;YACb,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,4BAA4B,EAAE;YAClF,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;IACjF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,UAAU,CAAC,OAAO,GAAG,EAAE,CAAC;AAClG,CAAC"}
@@ -0,0 +1,35 @@
1
+ import type { VirtualJoystickConfig } from "./VirtualTouchControls.js";
2
+ export type TouchLayoutGenre = "fight" | "race" | "platform";
3
+ export interface TouchLayoutButtonBinding {
4
+ /** DOM id the route creates for the on-screen button. */
5
+ readonly elementId: string;
6
+ /** `KeyboardEvent.code` the button synthesises (same path as physical keys). */
7
+ readonly code: string;
8
+ readonly kind: "hold" | "pulse";
9
+ readonly label: string;
10
+ }
11
+ export interface TouchLayoutPreset {
12
+ readonly kind: "touch-layout-preset";
13
+ readonly genre: TouchLayoutGenre;
14
+ /** Primary analog stick (move / steer). */
15
+ readonly leftStick: VirtualJoystickConfig;
16
+ /** Optional second stick (camera / aim). Present for fight + platform. */
17
+ readonly rightStick?: VirtualJoystickConfig;
18
+ readonly hold: readonly TouchLayoutButtonBinding[];
19
+ readonly pulse: readonly TouchLayoutButtonBinding[];
20
+ }
21
+ export interface TouchLayoutPresetOptions {
22
+ readonly width?: number;
23
+ readonly height?: number;
24
+ readonly elementIdPrefix?: string;
25
+ }
26
+ /**
27
+ * Analog-stick + button layout presets per genre. Stick configs feed
28
+ * `VirtualTouchJoystick`; button bindings feed the engine's
29
+ * `bindGameTouchControls` as `{ hold, pulse }` (see also the engine-side
30
+ * `touchLayoutBindingsForGenre`, which mirrors the button maps where the
31
+ * engine cannot depend on this package).
32
+ */
33
+ export declare function createTouchLayoutPreset(genre: TouchLayoutGenre, options?: TouchLayoutPresetOptions): TouchLayoutPreset;
34
+ export declare const TOUCH_LAYOUT_GENRES: readonly TouchLayoutGenre[];
35
+ //# sourceMappingURL=TouchLayouts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TouchLayouts.d.ts","sourceRoot":"","sources":["../../../../packages/input/src/TouchLayouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAiFnB;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAAkC,CAAC"}
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Analog-stick + button layout presets per genre. Stick configs feed
3
+ * `VirtualTouchJoystick`; button bindings feed the engine's
4
+ * `bindGameTouchControls` as `{ hold, pulse }` (see also the engine-side
5
+ * `touchLayoutBindingsForGenre`, which mirrors the button maps where the
6
+ * engine cannot depend on this package).
7
+ */
8
+ export function createTouchLayoutPreset(genre, options = {}) {
9
+ const width = Math.max(1, options.width ?? 960);
10
+ const height = Math.max(1, options.height ?? 540);
11
+ const prefix = options.elementIdPrefix ?? `touch-${genre}`;
12
+ const scale = Math.min(width, height) / 540;
13
+ const stickRadius = 64 * scale;
14
+ const leftStick = {
15
+ center: [96 * scale, height - 96 * scale],
16
+ radius: stickRadius,
17
+ deadZone: 0.18,
18
+ maxDistance: stickRadius * 0.8,
19
+ fixed: false,
20
+ returnToCenter: true
21
+ };
22
+ const hold = (elementId, code, label) => ({
23
+ elementId: `${prefix}:${elementId}`,
24
+ code,
25
+ kind: "hold",
26
+ label
27
+ });
28
+ const pulse = (elementId, code, label) => ({
29
+ elementId: `${prefix}:${elementId}`,
30
+ code,
31
+ kind: "pulse",
32
+ label
33
+ });
34
+ switch (genre) {
35
+ case "fight":
36
+ return {
37
+ kind: "touch-layout-preset",
38
+ genre,
39
+ leftStick,
40
+ rightStick: {
41
+ center: [width - 96 * scale, height - 220 * scale],
42
+ radius: 52 * scale,
43
+ deadZone: 0.25,
44
+ maxDistance: 40 * scale,
45
+ fixed: true,
46
+ returnToCenter: true
47
+ },
48
+ hold: [hold("left", "ArrowLeft", "Move left"), hold("right", "ArrowRight", "Move right"), hold("block", "KeyS", "Block")],
49
+ pulse: [
50
+ pulse("light", "KeyJ", "Light"),
51
+ pulse("heavy", "KeyK", "Heavy"),
52
+ pulse("special", "KeyL", "Special"),
53
+ pulse("jump", "Space", "Jump")
54
+ ]
55
+ };
56
+ case "race":
57
+ return {
58
+ kind: "touch-layout-preset",
59
+ genre,
60
+ leftStick: { ...leftStick, deadZone: 0.12 },
61
+ hold: [
62
+ hold("steer-left", "ArrowLeft", "Steer left"),
63
+ hold("steer-right", "ArrowRight", "Steer right"),
64
+ hold("throttle", "ArrowUp", "Throttle"),
65
+ hold("brake", "ArrowDown", "Brake")
66
+ ],
67
+ pulse: [pulse("boost", "ShiftLeft", "Boost"), pulse("reset", "KeyR", "Reset")]
68
+ };
69
+ case "platform":
70
+ return {
71
+ kind: "touch-layout-preset",
72
+ genre,
73
+ leftStick,
74
+ rightStick: {
75
+ center: [width - 96 * scale, height - 220 * scale],
76
+ radius: 48 * scale,
77
+ deadZone: 0.3,
78
+ maxDistance: 36 * scale,
79
+ fixed: true,
80
+ returnToCenter: true
81
+ },
82
+ hold: [hold("left", "ArrowLeft", "Move left"), hold("right", "ArrowRight", "Move right"), hold("dash", "ShiftLeft", "Dash")],
83
+ pulse: [pulse("jump", "Space", "Jump"), pulse("attack", "KeyJ", "Attack")]
84
+ };
85
+ }
86
+ }
87
+ export const TOUCH_LAYOUT_GENRES = ["fight", "race", "platform"];
88
+ //# sourceMappingURL=TouchLayouts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TouchLayouts.js","sourceRoot":"","sources":["../../../../packages/input/src/TouchLayouts.ts"],"names":[],"mappings":"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"}
@@ -11,6 +11,7 @@ export interface A3DXRSessionInit {
11
11
  }
12
12
  export interface A3DXRSessionLike {
13
13
  readonly inputSources?: readonly A3DXRInputSourceLike[];
14
+ readonly enabledFeatures?: readonly string[];
14
15
  requestReferenceSpace?(type: A3DXRReferenceSpaceType): Promise<A3DXRReferenceSpaceLike>;
15
16
  requestAnimationFrame?(callback: (time: number, frame: A3DXRFrameLike) => void): number;
16
17
  end?(): Promise<void>;
@@ -21,6 +22,7 @@ export interface A3DXRInputSourceLike {
21
22
  readonly profiles?: readonly string[];
22
23
  readonly targetRaySpace?: unknown;
23
24
  readonly gripSpace?: unknown;
25
+ readonly hand?: A3DXRHandLike;
24
26
  readonly gamepad?: {
25
27
  readonly buttons?: readonly {
26
28
  readonly pressed?: boolean;
@@ -33,9 +35,30 @@ export interface A3DXRInputSourceLike {
33
35
  }[];
34
36
  };
35
37
  }
38
+ /** Injected hand-tracking state for one input source (N3). Joint names follow
39
+ * the WebXR Hand Input `XRHandJoint` identifiers (e.g. "wrist",
40
+ * "index-finger-tip"); unknown names pass through untouched. */
41
+ export interface A3DXRJointSample {
42
+ readonly position?: readonly [number, number, number];
43
+ readonly orientation?: readonly [number, number, number, number];
44
+ readonly radius?: number;
45
+ }
46
+ export interface A3DXRHandLike {
47
+ readonly handedness?: A3DXRHandedness;
48
+ readonly trackingState?: "tracked" | "not-tracked" | unknown;
49
+ readonly joints?: Readonly<Record<string, A3DXRJointSample>>;
50
+ }
51
+ export interface A3DXRViewerPoseLike {
52
+ readonly position?: readonly [number, number, number];
53
+ readonly orientation?: readonly [number, number, number, number];
54
+ readonly viewMatrix?: readonly number[];
55
+ readonly projectionMatrix?: readonly number[];
56
+ }
36
57
  export interface A3DXRFrameLike {
37
58
  getHitTestResults?(source: unknown): readonly A3DXRHitTestResultLike[];
38
59
  getPose?(space: unknown, baseSpace: A3DXRReferenceSpaceLike): A3DXRPoseLike | undefined;
60
+ /** Viewer pose for XR camera handling; absent on sessions without tracking. */
61
+ getViewerPose?(referenceSpace: A3DXRReferenceSpaceLike): A3DXRViewerPoseLike | undefined;
39
62
  }
40
63
  export interface A3DXRReferenceSpaceLike {
41
64
  readonly type?: A3DXRReferenceSpaceType;
@@ -74,6 +97,33 @@ export interface WebXRHitTestSample {
74
97
  readonly position: readonly [number, number, number];
75
98
  readonly normal: readonly [number, number, number];
76
99
  }
100
+ export interface WebXRJointSample {
101
+ readonly position: readonly [number, number, number] | null;
102
+ readonly radius: number;
103
+ }
104
+ export interface WebXRHandSample {
105
+ readonly handedness: A3DXRHandedness;
106
+ readonly tracked: boolean;
107
+ readonly jointCount: number;
108
+ readonly joints: Readonly<Record<string, WebXRJointSample>>;
109
+ }
110
+ export interface WebXRCameraSample {
111
+ readonly tracked: boolean;
112
+ readonly position: readonly [number, number, number] | null;
113
+ readonly orientation: readonly [number, number, number, number] | null;
114
+ readonly viewMatrix: readonly number[] | null;
115
+ readonly projectionMatrix: readonly number[] | null;
116
+ }
117
+ /** Capability report: what THIS injected session actually provided. Every
118
+ * flag degrades to an explicit false/empty — never a hardware claim. */
119
+ export interface WebXRCapabilityReport {
120
+ readonly handTracking: boolean;
121
+ readonly viewerPose: boolean;
122
+ readonly hitTest: boolean;
123
+ readonly haptics: boolean;
124
+ readonly referenceSpace: A3DXRReferenceSpaceType;
125
+ readonly enabledFeatures: readonly string[];
126
+ }
77
127
  export interface WebXRFrameSample {
78
128
  readonly mode: A3DXRSessionMode;
79
129
  readonly referenceSpace: A3DXRReferenceSpaceType;
@@ -82,6 +132,9 @@ export interface WebXRFrameSample {
82
132
  readonly controllers: readonly WebXRControllerSample[];
83
133
  readonly hitTestCount: number;
84
134
  readonly hitTests: readonly WebXRHitTestSample[];
135
+ readonly hands: readonly WebXRHandSample[];
136
+ readonly camera: WebXRCameraSample;
137
+ readonly capabilities: WebXRCapabilityReport;
85
138
  }
86
139
  export interface WebXRSessionStartResult {
87
140
  readonly mode: A3DXRSessionMode;
@@ -1 +1 @@
1
- {"version":3,"file":"WebXRSessionController.d.ts","sourceRoot":"","sources":["../../../../packages/input/src/WebXRSessionController.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"WebXRSessionController.d.ts","sourceRoot":"","sources":["../../../../packages/input/src/WebXRSessionController.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,eAAe,GAAG,WAAW,CAAC;AACzG,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAAC,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/F;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,qBAAqB,CAAC,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACxF,qBAAqB,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,CAAC;IACxF,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;YAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAClH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS;YAAE,KAAK,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;SAAE,EAAE,CAAC;KACnH,CAAC;CACH;AAED;;gEAEgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,iBAAiB,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,sBAAsB,EAAE,CAAC;IACvE,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,uBAAuB,GAAG,aAAa,GAAG,SAAS,CAAC;IACxF,+EAA+E;IAC/E,aAAa,CAAC,CAAC,cAAc,EAAE,uBAAuB,GAAG,mBAAmB,GAAG,SAAS,CAAC;CAC1F;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,uBAAuB,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KAClE,CAAC;CACH;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACrD;AAED;wEACwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;CAC9C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,sBAAsB;IACjC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;IAErD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAkB;IACtC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,cAAc,CAAwC;gBAElD,OAAO,GAAE,6BAAkC;IAQvD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAEK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAM/B,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA+B/C,WAAW,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,gBAAgB;IAkCxE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpB,YAAY,CAAC,SAAS,SAAM,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CAYpE"}
@@ -55,10 +55,17 @@ export class WebXRSessionController {
55
55
  }
56
56
  sampleFrame(frame, hitTestSource) {
57
57
  const referenceSpace = this.referenceSpace ?? { type: this.referenceSpaceType };
58
- const controllers = Array.from(this.session?.inputSources ?? []).map((source) => sampleInputSource(source, frame, referenceSpace));
58
+ const sources = Array.from(this.session?.inputSources ?? []);
59
+ const controllers = sources.map((source) => sampleInputSource(source, frame, referenceSpace));
60
+ const hands = sources
61
+ .filter((source) => source.hand !== undefined)
62
+ .map((source) => sampleHand(source.handedness ?? "none", source.hand));
59
63
  const hitTests = frame?.getHitTestResults && hitTestSource
60
64
  ? frame.getHitTestResults(hitTestSource).map(sampleHitTest)
61
65
  : [];
66
+ const camera = sampleViewerPose(frame, referenceSpace);
67
+ const hitTestCapable = Boolean(frame?.getHitTestResults && hitTestSource);
68
+ const enabledFeatures = Array.from(this.session?.enabledFeatures ?? []);
62
69
  return {
63
70
  mode: this.mode,
64
71
  referenceSpace: this.referenceSpace?.type ?? this.referenceSpaceType,
@@ -66,7 +73,17 @@ export class WebXRSessionController {
66
73
  controllerCount: controllers.length,
67
74
  controllers,
68
75
  hitTestCount: hitTests.length,
69
- hitTests
76
+ hitTests,
77
+ hands,
78
+ camera,
79
+ capabilities: {
80
+ handTracking: hands.some((hand) => hand.tracked),
81
+ viewerPose: camera.tracked,
82
+ hitTest: hitTestCapable,
83
+ haptics: controllers.some((controller) => controller.hapticActuatorCount > 0),
84
+ referenceSpace: this.referenceSpace?.type ?? this.referenceSpaceType,
85
+ enabledFeatures
86
+ }
70
87
  };
71
88
  }
72
89
  async end() {
@@ -114,6 +131,45 @@ function samplePoseMatrix(frame, space, referenceSpace) {
114
131
  return null;
115
132
  return sanitizeMatrix4(frame.getPose(space, referenceSpace)?.transform?.matrix);
116
133
  }
134
+ function sampleHand(handedness, hand) {
135
+ const joints = {};
136
+ const entries = hand?.joints ? Object.entries(hand.joints).slice(0, 64) : [];
137
+ for (const [name, joint] of entries) {
138
+ joints[name] = {
139
+ position: sanitizeVec3OrNull(joint?.position),
140
+ radius: typeof joint?.radius === "number" && Number.isFinite(joint.radius) ? Math.max(0, joint.radius) : 0
141
+ };
142
+ }
143
+ const jointCount = Object.keys(joints).length;
144
+ return {
145
+ handedness,
146
+ tracked: hand?.trackingState === "tracked" && jointCount > 0,
147
+ jointCount,
148
+ joints
149
+ };
150
+ }
151
+ function sampleViewerPose(frame, referenceSpace) {
152
+ const untracked = {
153
+ tracked: false,
154
+ position: null,
155
+ orientation: null,
156
+ viewMatrix: null,
157
+ projectionMatrix: null
158
+ };
159
+ const pose = frame?.getViewerPose?.(referenceSpace);
160
+ if (!pose)
161
+ return untracked;
162
+ const position = sanitizeVec3OrNull(pose.position);
163
+ const orientation = sanitizeQuatOrNull(pose.orientation);
164
+ // Strict: a single non-finite entry invalidates the whole matrix. Zeroing
165
+ // it (the legacy controller-pose behavior) would silently warp the XR
166
+ // camera, so the sample degrades to untracked instead.
167
+ const viewMatrix = sanitizeMatrix4Strict(pose.viewMatrix);
168
+ const projectionMatrix = sanitizeMatrix4Strict(pose.projectionMatrix);
169
+ if (!position && !orientation && !viewMatrix && !projectionMatrix)
170
+ return untracked;
171
+ return { tracked: true, position, orientation, viewMatrix, projectionMatrix };
172
+ }
117
173
  function sampleHitTest(result) {
118
174
  return {
119
175
  position: sanitizeVec3(result.position, [0, 0, 0]),
@@ -128,6 +184,36 @@ function sanitizeVec3(value, fallback) {
128
184
  const z = finiteOrZero(value[2]);
129
185
  return [x, y, z];
130
186
  }
187
+ function sanitizeVec3OrNull(value) {
188
+ if (!value || value.length < 3)
189
+ return null;
190
+ const x = value[0];
191
+ const y = value[1];
192
+ const z = value[2];
193
+ if (typeof x !== "number" || typeof y !== "number" || typeof z !== "number")
194
+ return null;
195
+ if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z))
196
+ return null;
197
+ return [x, y, z];
198
+ }
199
+ function sanitizeQuatOrNull(value) {
200
+ if (!value || value.length < 4)
201
+ return null;
202
+ const [x, y, z, w] = [value[0], value[1], value[2], value[3]];
203
+ if (typeof x !== "number" || typeof y !== "number" || typeof z !== "number" || typeof w !== "number")
204
+ return null;
205
+ if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z) || !Number.isFinite(w))
206
+ return null;
207
+ return [x, y, z, w];
208
+ }
209
+ function sanitizeMatrix4Strict(value) {
210
+ if (!value || value.length < 16)
211
+ return null;
212
+ const matrix = value.slice(0, 16);
213
+ if (matrix.some((entry) => typeof entry !== "number" || !Number.isFinite(entry)))
214
+ return null;
215
+ return Array.from(matrix);
216
+ }
131
217
  function finiteOrZero(value) {
132
218
  return typeof value === "number" && Number.isFinite(value) ? value : 0;
133
219
  }