@vincentt-xr/sdk 2.0.0-alpha.0 → 2.0.0-alpha.10

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 (879) hide show
  1. package/GROUNDING.md +8193 -111
  2. package/README.md +86 -52
  3. package/dist/CanonicalHeadFrame-D_0OzdB9.cjs +1 -0
  4. package/dist/CanonicalHeadFrame-DdUqF6Fv.js +1506 -0
  5. package/dist/DebuggerUI-CVuV-VJ5.cjs +1 -0
  6. package/dist/DebuggerUI-D-rcPa54.js +275 -0
  7. package/dist/FaceRetouch-C1AxBNex.js +1071 -0
  8. package/dist/FaceRetouch-D7kryDE6.cjs +134 -0
  9. package/dist/FaceSurface-CHAMEeG1.cjs +1 -0
  10. package/dist/FaceSurface-DmP9AEeC.js +27 -0
  11. package/dist/SkeletonUtils-C2r90MtN.js +21 -0
  12. package/dist/SkeletonUtils-CddIup1F.cjs +1 -0
  13. package/dist/TextLabel-XE0rQSDn.cjs +2 -0
  14. package/dist/TextLabel-c9BCucOI.js +961 -0
  15. package/dist/assets/cache.d.ts +99 -0
  16. package/dist/assets/estimate.d.ts +11 -0
  17. package/dist/assets/gltfLoader.d.ts +16 -0
  18. package/dist/assets/index.d.ts +7 -0
  19. package/dist/assets/loaders.d.ts +43 -0
  20. package/dist/assets/react.d.ts +33 -0
  21. package/dist/assets/sdkModels.d.ts +22 -0
  22. package/dist/audio/AudioEngine.d.ts +3 -1
  23. package/dist/audio/AudioPlayer.d.ts +29 -0
  24. package/dist/audio/AudioPlayerLogic.d.ts +4 -0
  25. package/dist/audio/index.d.ts +2 -0
  26. package/dist/body/__fixtures__/syntheticRig.d.ts +21 -0
  27. package/dist/body/bodyFlipGuard.d.ts +39 -0
  28. package/dist/body/bodyIdentity.d.ts +72 -0
  29. package/dist/body/bodyMask.d.ts +79 -0
  30. package/dist/body/bodyMaskMaterial.d.ts +15 -0
  31. package/dist/body/bodyPose.d.ts +58 -0
  32. package/dist/body/bodyRigFit.d.ts +148 -0
  33. package/dist/body/bodyRigSolver.d.ts +114 -0
  34. package/dist/body/bodySubject.d.ts +46 -0
  35. package/dist/body-pose/index.d.ts +521 -0
  36. package/dist/body-trigger/__fixtures__/syntheticBody.d.ts +83 -0
  37. package/dist/body-trigger/frame.d.ts +88 -0
  38. package/dist/body-trigger/index.d.ts +6 -0
  39. package/dist/body-trigger/moves.d.ts +235 -0
  40. package/dist/body-trigger/trigger.d.ts +75 -0
  41. package/dist/bodyMaskMaterial-CBWub5t_.cjs +68 -0
  42. package/dist/bodyMaskMaterial-Cs2awskk.js +207 -0
  43. package/dist/cache-2x3CUJuY.js +212 -0
  44. package/dist/cache-DL1Dbz6k.cjs +1 -0
  45. package/dist/calibration/calibration.d.ts +75 -0
  46. package/dist/calibration/index.d.ts +6 -0
  47. package/dist/calibration/storage.d.ts +13 -0
  48. package/dist/calibration/types.d.ts +53 -0
  49. package/dist/calibration/useXRCalibration.d.ts +46 -0
  50. package/dist/camera/CameraPermissionGate.d.ts +26 -0
  51. package/dist/camera/devices.d.ts +26 -0
  52. package/dist/camera/index.d.ts +8 -0
  53. package/dist/camera/permission.d.ts +86 -0
  54. package/dist/camera/useCameraPermission.d.ts +35 -0
  55. package/dist/canonicalFace-BHwyCx1c.js +9 -0
  56. package/dist/canonicalFace-C83I225R.cjs +1 -0
  57. package/dist/capabilities/detect.d.ts +45 -0
  58. package/dist/capabilities/index.d.ts +5 -0
  59. package/dist/capabilities/types.d.ts +120 -0
  60. package/dist/capabilities/useXRCapabilities.d.ts +18 -0
  61. package/dist/compat/environment.d.ts +5 -0
  62. package/dist/compat/index.d.ts +4 -0
  63. package/dist/compat/run.d.ts +18 -0
  64. package/dist/compat/scenarios.d.ts +10 -0
  65. package/dist/compat/types.d.ts +101 -0
  66. package/dist/components/Axes/index.d.ts +6 -0
  67. package/dist/components/BodyInstruction/BodyPoseHint.d.ts +63 -0
  68. package/dist/components/BodyInstruction/index.d.ts +76 -0
  69. package/dist/components/BodyInstruction/useBodyPose.d.ts +30 -0
  70. package/dist/components/BodyRig/BodyAttachment.d.ts +28 -0
  71. package/dist/components/BodyRig/BodyOccluder.d.ts +27 -0
  72. package/dist/components/BodyRig/bodyDepth.d.ts +57 -0
  73. package/dist/components/BodyRig/index.d.ts +129 -0
  74. package/dist/components/BodyRig/useBodyDepthTexture.d.ts +40 -0
  75. package/dist/components/BodyTracker/index.d.ts +26 -1
  76. package/dist/components/BodyTrigger/index.d.ts +56 -0
  77. package/dist/components/Debugger/DebuggerProvider.d.ts +14 -1
  78. package/dist/components/Debugger/DebuggerUI.d.ts +3 -1
  79. package/dist/components/FaceAtlas/FaceAtlasLayer.d.ts +114 -0
  80. package/dist/components/FaceAtlas/MadeUpCamera.d.ts +80 -0
  81. package/dist/components/FaceAtlas/constants.d.ts +8 -0
  82. package/dist/components/FaceAtlas/index.d.ts +7 -0
  83. package/dist/components/FaceAtlas/useFaceAtlasSurface.d.ts +84 -0
  84. package/dist/components/FaceAtlas/useFaceSkin.d.ts +84 -0
  85. package/dist/components/FaceCharacter/ExternalFaceMesh.d.ts +109 -0
  86. package/dist/components/FaceCharacter/FaceExpressionController.d.ts +53 -0
  87. package/dist/components/FaceCharacter/FaceMorph.d.ts +71 -0
  88. package/dist/components/FaceCharacter/FacePiercing.d.ts +65 -0
  89. package/dist/components/FaceCharacter/FaceReprojection.d.ts +85 -0
  90. package/dist/components/FaceCharacter/FaceRig.d.ts +38 -0
  91. package/dist/components/FaceCharacter/FaceSurface.d.ts +49 -0
  92. package/dist/components/FaceCharacter/FaceSurfaceOccluder.d.ts +39 -0
  93. package/dist/components/FaceCharacter/PinToFaceMesh.d.ts +68 -0
  94. package/dist/components/FaceCharacter/index.d.ts +18 -0
  95. package/dist/components/FaceCharacter/useFaceReprojector.d.ts +10 -0
  96. package/dist/components/FaceInset/FaceInset.d.ts +68 -0
  97. package/dist/components/FaceInset/frame.d.ts +94 -0
  98. package/dist/components/FaceInset/index.d.ts +6 -0
  99. package/dist/components/FaceInset/material.d.ts +40 -0
  100. package/dist/components/FaceInset/useFaceInsetTexture.d.ts +37 -0
  101. package/dist/components/FaceInstruction/FaceExpressionHint.d.ts +43 -0
  102. package/dist/components/FaceInstruction/index.d.ts +56 -0
  103. package/dist/components/FaceInstruction/useFaceExpression.d.ts +20 -0
  104. package/dist/components/FaceLiquify/FaceLiquify.d.ts +49 -0
  105. package/dist/components/FaceLiquify/debug.d.ts +37 -0
  106. package/dist/components/FaceLiquify/frame.d.ts +55 -0
  107. package/dist/components/FaceLiquify/index.d.ts +10 -0
  108. package/dist/components/FaceLiquify/material.d.ts +39 -0
  109. package/dist/components/FaceLiquify/pass.d.ts +49 -0
  110. package/dist/components/FaceLiquify/presence.d.ts +25 -0
  111. package/dist/components/FaceLiquify/presets.d.ts +82 -0
  112. package/dist/components/FaceLiquify/selfTest.d.ts +66 -0
  113. package/dist/components/FaceLiquify/target.d.ts +85 -0
  114. package/dist/components/FaceLiquify/warp.d.ts +72 -0
  115. package/dist/components/FaceMesh/FaceMeshRenderer.d.ts +25 -0
  116. package/dist/components/FaceMesh/canonical/CanonicalFaceMeshRenderer.d.ts +70 -1
  117. package/dist/components/FaceMesh/canonical/FaceMeshMaterial.d.ts +25 -0
  118. package/dist/components/FaceMesh/canonical/assets.d.ts +3 -0
  119. package/dist/components/FaceMesh/canonical/geometryGroups.d.ts +30 -0
  120. package/dist/components/FaceMesh/canonical/parseCanonicalFaceModel.d.ts +24 -0
  121. package/dist/components/FaceMesh/canonical/shaders.d.ts +2 -0
  122. package/dist/components/FaceMesh/deform.d.ts +3 -0
  123. package/dist/components/FaceMesh/index.d.ts +6 -1
  124. package/dist/components/FaceMesh/material/defaults.d.ts +74 -0
  125. package/dist/components/FaceMesh/material/index.d.ts +1 -0
  126. package/dist/components/FaceMesh/material/options.d.ts +5 -1
  127. package/dist/components/FaceMesh/material/support.d.ts +7 -2
  128. package/dist/components/FaceMesh/material/textures.d.ts +4 -0
  129. package/dist/components/FaceMesh/material/types.d.ts +4 -2
  130. package/dist/components/FaceRetouch/Background.d.ts +11 -5
  131. package/dist/components/FaceRetouch/FaceRetouch.d.ts +52 -0
  132. package/dist/components/FaceRetouch/index.d.ts +2 -6
  133. package/dist/components/FaceRetouch/landmarkMask.d.ts +4 -6
  134. package/dist/components/FaceRetouch/renderState.d.ts +19 -0
  135. package/dist/components/FaceRetouch/useFaceRetouchMask.d.ts +4 -7
  136. package/dist/components/FaceSwap/FaceMirror.d.ts +46 -0
  137. package/dist/components/FaceSwap/FaceSwap.d.ts +58 -0
  138. package/dist/components/FaceSwap/FaceTextureLayer.d.ts +72 -0
  139. package/dist/components/FaceSwap/faceSwapPlan.d.ts +91 -0
  140. package/dist/components/FaceSwap/index.d.ts +13 -0
  141. package/dist/components/FaceSwap/settings.d.ts +300 -0
  142. package/dist/components/FaceSwap/useFaceTexture.d.ts +35 -0
  143. package/dist/components/FaceSwap/useLiveFace.d.ts +38 -0
  144. package/dist/components/FaceSwap/useLiveFaceTexture.d.ts +31 -0
  145. package/dist/components/FaceTracker/index.d.ts +5 -3
  146. package/dist/components/FaceWarp3D/FaceWarp3D.d.ts +50 -0
  147. package/dist/components/FaceWarp3D/index.d.ts +2 -0
  148. package/dist/components/Faceless/Faceless.d.ts +51 -0
  149. package/dist/components/Faceless/index.d.ts +2 -0
  150. package/dist/components/GestureListener/index.d.ts +11 -0
  151. package/dist/components/HairLock/HairLock.d.ts +39 -0
  152. package/dist/components/HairLock/index.d.ts +2 -0
  153. package/dist/components/HairLock/lockGeometry.d.ts +15 -0
  154. package/dist/components/HandCutout/index.d.ts +35 -0
  155. package/dist/components/HandEffect/index.d.ts +36 -0
  156. package/dist/components/HandInstruction/HandGestureHint.d.ts +70 -0
  157. package/dist/components/HandInstruction/index.d.ts +74 -0
  158. package/dist/components/HandInstruction/useHandGesture.d.ts +22 -0
  159. package/dist/components/HandJoints2D/index.d.ts +6 -0
  160. package/dist/components/HandRig/ForearmOccluder.d.ts +29 -0
  161. package/dist/components/HandRig/HandAttachment.d.ts +34 -0
  162. package/dist/components/HandRig/HandNails.d.ts +61 -0
  163. package/dist/components/HandRig/HandOccluder.d.ts +45 -0
  164. package/dist/components/HandRig/HandTattoo.d.ts +61 -0
  165. package/dist/components/HandRig/WristAttachment.d.ts +34 -0
  166. package/dist/components/HandRig/index.d.ts +127 -0
  167. package/dist/components/HandRig/useArmMask.d.ts +29 -0
  168. package/dist/components/HandRig/wristSolve.d.ts +96 -0
  169. package/dist/components/HandTouch/HandTouch.d.ts +62 -0
  170. package/dist/components/HandTouch/Touchable.d.ts +36 -0
  171. package/dist/components/HandTouch/index.d.ts +2 -0
  172. package/dist/components/HandTracker/index.d.ts +12 -2
  173. package/dist/components/HandTracking2D/HandVisual.d.ts +12 -0
  174. package/dist/components/HandTracking2D/index.d.ts +5 -0
  175. package/dist/components/HandTracking2DController/index.d.ts +5 -0
  176. package/dist/components/HandTracking3D/index.d.ts +6 -0
  177. package/dist/components/HeadBinding/index.d.ts +14 -0
  178. package/dist/components/HeadOccluder/CanonicalHeadFrame.d.ts +22 -0
  179. package/dist/components/HeadOccluder/Earrings.d.ts +55 -0
  180. package/dist/components/HeadOccluder/HeadAttachment.d.ts +38 -0
  181. package/dist/components/HeadOccluder/NeckOccluder.d.ts +67 -0
  182. package/dist/components/HeadOccluder/earringPlacement.d.ts +31 -0
  183. package/dist/components/HeadOccluder/headAttachmentPoints.d.ts +69 -0
  184. package/dist/components/HeadOccluder/index.d.ts +57 -3
  185. package/dist/components/HeadOccluder/useCanonicalHeadFit.d.ts +36 -0
  186. package/dist/components/HeadOccluder/useLandmarkPoseFit.d.ts +80 -0
  187. package/dist/components/HolisticTracker/index.d.ts +69 -0
  188. package/dist/components/HolisticTracker/settings.d.ts +58 -0
  189. package/dist/components/HolisticTracker/signals.d.ts +49 -0
  190. package/dist/components/Instruction/HintStage.d.ts +29 -0
  191. package/dist/components/Instruction/InstructionCue.d.ts +126 -0
  192. package/dist/components/Instruction/gestureHold.d.ts +20 -0
  193. package/dist/components/Instruction/ghost.d.ts +129 -0
  194. package/dist/components/Instruction/hintBlend.d.ts +19 -0
  195. package/dist/components/Instruction/hintLook.d.ts +81 -0
  196. package/dist/components/Instruction/hintLoop.d.ts +36 -0
  197. package/dist/components/Instruction/index.d.ts +41 -0
  198. package/dist/components/Instruction/useGhostModel.d.ts +33 -0
  199. package/dist/components/Instruction/useInstructionHold.d.ts +72 -0
  200. package/dist/components/IrisEffect/IrisMaterial.d.ts +73 -0
  201. package/dist/components/IrisEffect/index.d.ts +51 -0
  202. package/dist/components/IrisEffect/settings.d.ts +117 -0
  203. package/dist/components/LightObject/index.d.ts +20 -0
  204. package/dist/components/LipEffect/LipEffect.d.ts +28 -0
  205. package/dist/components/LipEffect/LipEffectMaterial.d.ts +98 -0
  206. package/dist/components/LipEffect/LipEffects.d.ts +12 -0
  207. package/dist/components/LipEffect/defaults.d.ts +51 -0
  208. package/dist/components/LipEffect/index.d.ts +12 -0
  209. package/dist/components/LipEffect/lipShading.d.ts +73 -0
  210. package/dist/components/LipEffect/settings.d.ts +375 -0
  211. package/dist/components/LipEffect/shader.d.ts +39 -0
  212. package/dist/components/LipEffect/types.d.ts +141 -0
  213. package/dist/components/LipEffect/useLipDesignTextures.d.ts +17 -0
  214. package/dist/components/LipEffect/uvGuide.d.ts +74 -0
  215. package/dist/components/LookAt/index.d.ts +23 -0
  216. package/dist/components/Makeup/Blush.d.ts +18 -0
  217. package/dist/components/Makeup/Brows.d.ts +20 -0
  218. package/dist/components/Makeup/Contour.d.ts +17 -0
  219. package/dist/components/Makeup/Eyeliner.d.ts +20 -0
  220. package/dist/components/Makeup/Eyeshadow.d.ts +20 -0
  221. package/dist/components/Makeup/Highlighter.d.ts +18 -0
  222. package/dist/components/Makeup/MakeupDesign.d.ts +37 -0
  223. package/dist/components/Makeup/MakeupRegion.d.ts +132 -0
  224. package/dist/components/Makeup/constants.d.ts +44 -0
  225. package/dist/components/Makeup/design.d.ts +106 -0
  226. package/dist/components/Makeup/designSamples.d.ts +42 -0
  227. package/dist/components/Makeup/eyes.d.ts +114 -0
  228. package/dist/components/Makeup/fields.d.ts +10 -0
  229. package/dist/components/Makeup/geometry.d.ts +106 -0
  230. package/dist/components/Makeup/index.d.ts +26 -0
  231. package/dist/components/Makeup/looks.d.ts +28 -0
  232. package/dist/components/Makeup/material.d.ts +239 -0
  233. package/dist/components/Makeup/settings.d.ts +54 -0
  234. package/dist/components/Makeup/shades.d.ts +143 -0
  235. package/dist/components/Makeup/shapes.d.ts +27 -0
  236. package/dist/components/Makeup/skinTone.d.ts +135 -0
  237. package/dist/components/Makeup/types.d.ts +110 -0
  238. package/dist/components/Makeup/useMakeupSkinTone.d.ts +40 -0
  239. package/dist/components/MeshRenderer/index.d.ts +59 -0
  240. package/dist/components/Necklace/Necklace.d.ts +44 -0
  241. package/dist/components/Necklace/index.d.ts +1 -0
  242. package/dist/components/ParticleEmitter/ParticleEmitter.d.ts +69 -0
  243. package/dist/components/ParticleEmitter/index.d.ts +1 -0
  244. package/dist/components/PersonCutout/index.d.ts +46 -0
  245. package/dist/components/PersonCutout/personCutout.d.ts +16 -0
  246. package/dist/components/PersonCutout/personMask.d.ts +19 -0
  247. package/dist/components/PersonCutout/useBodyMaskTexture.d.ts +35 -0
  248. package/dist/components/PerspectiveCamera/index.d.ts +2 -8
  249. package/dist/components/PinToMesh/index.d.ts +47 -0
  250. package/dist/components/RenderGroupLayer/index.d.ts +6 -0
  251. package/dist/components/SceneObjectRenderer/index.d.ts +23 -0
  252. package/dist/components/Screen2D/ScreenTransformFrame.d.ts +11 -0
  253. package/dist/components/Screen2D/ScreenTransformHelpers.d.ts +19 -0
  254. package/dist/components/Screen2D/ScreenTransformInteraction.d.ts +18 -0
  255. package/dist/components/Screen2D/index.d.ts +5 -0
  256. package/dist/components/ScreenGlass/defaults.d.ts +3 -0
  257. package/dist/components/ScreenGlass/index.d.ts +5 -0
  258. package/dist/components/ScreenGlass/shaders.d.ts +2 -0
  259. package/dist/components/ScreenGlass/types.d.ts +10 -0
  260. package/dist/components/ScreenGradient/defaults.d.ts +5 -0
  261. package/dist/components/ScreenGradient/index.d.ts +5 -0
  262. package/dist/components/ScreenGradient/shaders.d.ts +2 -0
  263. package/dist/components/ScreenGradient/types.d.ts +19 -0
  264. package/dist/components/ScreenImage/ScreenImage.d.ts +4 -0
  265. package/dist/components/ScreenImage/components/DynamicTextureSync.d.ts +9 -0
  266. package/dist/components/ScreenImage/components/ScreenImageBody.d.ts +9 -0
  267. package/dist/components/ScreenImage/components/ScreenImageFrame.d.ts +9 -0
  268. package/dist/components/ScreenImage/components/ScreenImageTransformFrame.d.ts +9 -0
  269. package/dist/components/ScreenImage/fit.d.ts +52 -0
  270. package/dist/components/ScreenImage/index.d.ts +10 -0
  271. package/dist/components/ScreenImage/materials/ScreenImageBlendMaterial.d.ts +9 -0
  272. package/dist/components/ScreenImage/materials/ScreenImageMaskMaterial.d.ts +11 -0
  273. package/dist/components/ScreenImage/materials/ScreenImageMatcap.d.ts +3 -0
  274. package/dist/components/ScreenImage/source.d.ts +25 -0
  275. package/dist/components/ScreenImage/types.d.ts +64 -0
  276. package/dist/components/ScreenImage/utils/ScreenImageConstants.d.ts +9 -0
  277. package/dist/components/ScreenImage/utils/ScreenImageHelpers.d.ts +4 -0
  278. package/dist/components/ScreenShape/geometry.d.ts +5 -0
  279. package/dist/components/ScreenShape/index.d.ts +5 -0
  280. package/dist/components/ScreenShape/types.d.ts +54 -0
  281. package/dist/components/ScreenSpaceUI/ScreenTransformGuide.d.ts +15 -0
  282. package/dist/components/ScreenSpaceUI/ScreenTransformOverlayGuide.d.ts +9 -0
  283. package/dist/components/ScreenSpaceUI/index.d.ts +3 -0
  284. package/dist/components/ScreenText/components/ScreenTextBody.d.ts +2 -0
  285. package/dist/components/ScreenText/components/ScreenTextTransformFrame.d.ts +9 -0
  286. package/dist/components/ScreenText/constants.d.ts +5 -0
  287. package/dist/components/ScreenText/index.d.ts +6 -0
  288. package/dist/components/ScreenText/types.d.ts +31 -0
  289. package/dist/components/ScreenText/utils/ScreenTextHelpers.d.ts +14 -0
  290. package/dist/components/ScreenText/utils/ScreenTextMappings.d.ts +17 -0
  291. package/dist/components/SegmentationOverlay/SegmentationOverlay.d.ts +37 -0
  292. package/dist/components/SegmentationOverlay/SegmentationOverlayMaterial.d.ts +31 -0
  293. package/dist/components/SegmentationOverlay/index.d.ts +9 -0
  294. package/dist/components/SegmentationOverlay/maskTexture.d.ts +23 -0
  295. package/dist/components/SegmentationOverlay/providers.d.ts +72 -0
  296. package/dist/components/SegmentationOverlay/settings.d.ts +65 -0
  297. package/dist/components/SequentialRenderPasses/index.d.ts +6 -0
  298. package/dist/components/ShoulderOccluder/index.d.ts +46 -0
  299. package/dist/components/ShoulderOccluder/useCanonicalTorsoFit.d.ts +27 -0
  300. package/dist/components/SpringSwing/SpringSwing.d.ts +22 -0
  301. package/dist/components/SpringSwing/index.d.ts +1 -0
  302. package/dist/components/TextLabel/TextLabel.d.ts +5 -0
  303. package/dist/components/TextLabel/alignment.d.ts +4 -0
  304. package/dist/components/TextLabel/bend.d.ts +9 -0
  305. package/dist/components/TextLabel/canvas/buildTextLabelTexture.d.ts +4 -0
  306. package/dist/components/TextLabel/canvas/canvasTypography.d.ts +13 -0
  307. package/dist/components/TextLabel/canvas/drawBackground.d.ts +21 -0
  308. package/dist/components/TextLabel/canvas/drawEffects.d.ts +34 -0
  309. package/dist/components/TextLabel/canvas/drawText.d.ts +19 -0
  310. package/dist/components/TextLabel/components/TextLabelMesh.d.ts +13 -0
  311. package/dist/components/TextLabel/constants.d.ts +2 -0
  312. package/dist/components/TextLabel/hooks/useTextLabelTexture.d.ts +7 -0
  313. package/dist/components/TextLabel/index.d.ts +2 -62
  314. package/dist/components/TextLabel/layout/measurement.d.ts +8 -0
  315. package/dist/components/TextLabel/layout/resolveTextLayout.d.ts +25 -0
  316. package/dist/components/TextLabel/layout/wrapText.d.ts +6 -0
  317. package/dist/components/TextLabel/types.d.ts +337 -0
  318. package/dist/components/TrackingAnchor/index.d.ts +18 -2
  319. package/dist/components/Transform3D/index.d.ts +30 -0
  320. package/dist/components/XRMediaSurface/index.d.ts +8 -7
  321. package/dist/components/XRProvider/index.d.ts +16 -2
  322. package/dist/components/XRScene/index.d.ts +14 -3
  323. package/dist/components/XRScene/renderOutputTarget.d.ts +12 -0
  324. package/dist/components/XRViewport/XRViewport.d.ts +11 -0
  325. package/dist/components/XRViewport/components/HiddenMedia.d.ts +7 -0
  326. package/dist/components/XRViewport/components/MediaAssetPicker.d.ts +8 -0
  327. package/dist/components/XRViewport/components/MediaControlStack.d.ts +13 -0
  328. package/dist/components/XRViewport/components/XRViewportLayers.d.ts +30 -0
  329. package/dist/components/XRViewport/constants.d.ts +24 -0
  330. package/dist/components/XRViewport/contexts.d.ts +6 -0
  331. package/dist/components/XRViewport/hooks/useViewportExternalFaces.d.ts +13 -0
  332. package/dist/components/XRViewport/hooks/useViewportMediaSource.d.ts +16 -0
  333. package/dist/components/XRViewport/hooks/useViewportMediaTexture.d.ts +10 -0
  334. package/dist/components/XRViewport/hooks/useViewportPipeline.d.ts +41 -0
  335. package/dist/components/XRViewport/hooks/useViewportRenderState.d.ts +47 -0
  336. package/dist/components/XRViewport/index.d.ts +3 -101
  337. package/dist/components/XRViewport/layout.d.ts +16 -0
  338. package/dist/components/XRViewport/slots.d.ts +16 -0
  339. package/dist/components/XRViewport/types.d.ts +89 -0
  340. package/dist/components/XRViewport/useViewportSize.d.ts +3 -0
  341. package/dist/components/index.d.ts +31 -0
  342. package/dist/components/occluder/skinnedOccluder.d.ts +39 -0
  343. package/dist/config/index.d.ts +1 -1
  344. package/dist/constants/index.d.ts +4 -1
  345. package/dist/context-DTxSQvp4.js +13 -0
  346. package/dist/context-hA0Rb2Xa.cjs +1 -0
  347. package/dist/contexts-DQc7zyqT.cjs +1 -0
  348. package/dist/contexts-Y_FhdnIv.js +667 -0
  349. package/dist/coordinates/feed.d.ts +52 -0
  350. package/dist/coordinates/index.d.ts +7 -0
  351. package/dist/coordinates/side.d.ts +40 -0
  352. package/dist/coordinates/spaces.d.ts +49 -0
  353. package/dist/coordinates/viewport.d.ts +22 -0
  354. package/dist/coordinates/world.d.ts +15 -0
  355. package/dist/debug-ui/component-editor/index.d.ts +19 -0
  356. package/dist/debug-ui/default-setting/index.d.ts +37 -0
  357. package/dist/debug-ui/default-setting.cjs +21 -0
  358. package/dist/debug-ui/default-setting.js +777 -0
  359. package/dist/debug-ui/face-mesh-renderer-settings/index.d.ts +8 -0
  360. package/dist/debug-ui/face-retouch/index.d.ts +11 -0
  361. package/dist/debug-ui/face-swap-settings/index.d.ts +22 -0
  362. package/dist/debug-ui/gesture-settings/index.d.ts +14 -0
  363. package/dist/debug-ui/hand-joints-2d/index.d.ts +6 -0
  364. package/dist/debug-ui/hand-tracking-2d/index.d.ts +6 -0
  365. package/dist/debug-ui/hand-tracking-2d-controller/index.d.ts +6 -0
  366. package/dist/debug-ui/hand-tracking-3d/index.d.ts +6 -0
  367. package/dist/debug-ui/hierarchy-panel/index.d.ts +30 -0
  368. package/dist/debug-ui/holistic-tracker-settings/index.d.ts +16 -0
  369. package/dist/debug-ui/index.d.ts +61 -0
  370. package/dist/debug-ui/iris-effect-settings/index.d.ts +12 -0
  371. package/dist/debug-ui/layer-panel/index.d.ts +18 -0
  372. package/dist/debug-ui/lip-effect-settings/index.d.ts +15 -0
  373. package/dist/debug-ui/media-source/MediaSourceSwitcher.d.ts +10 -0
  374. package/dist/debug-ui/media-source/index.d.ts +6 -0
  375. package/dist/debug-ui/media-source/media-preset.d.ts +21 -0
  376. package/dist/debug-ui/media-source/session.d.ts +40 -0
  377. package/dist/debug-ui/media-source.cjs +1 -0
  378. package/dist/debug-ui/media-source.js +11 -0
  379. package/dist/debug-ui/mesh-renderer-settings/index.d.ts +6 -0
  380. package/dist/debug-ui/object-inspector-panel/index.d.ts +26 -0
  381. package/dist/debug-ui/pin-to-mesh-settings/index.d.ts +10 -0
  382. package/dist/debug-ui/product-hotspots/index.d.ts +25 -0
  383. package/dist/debug-ui/scene-editor/context.d.ts +38 -0
  384. package/dist/debug-ui/scene-editor/hierarchy-panel.d.ts +11 -0
  385. package/dist/debug-ui/scene-editor/index.d.ts +11 -0
  386. package/dist/debug-ui/scene-editor/inspector-panel.d.ts +9 -0
  387. package/dist/debug-ui/scene-editor/store-utils.d.ts +2 -0
  388. package/dist/debug-ui/scene-editor/viewport-toolbar.d.ts +4 -0
  389. package/dist/debug-ui/scene-editor/viewport.d.ts +21 -0
  390. package/dist/debug-ui/screen-glass-settings/index.d.ts +6 -0
  391. package/dist/debug-ui/screen-gradient-settings/GradientStopsEditor.d.ts +5 -0
  392. package/dist/debug-ui/screen-gradient-settings/index.d.ts +6 -0
  393. package/dist/debug-ui/screen-gradient-settings/styles.d.ts +3 -0
  394. package/dist/debug-ui/screen-image-settings/index.d.ts +11 -0
  395. package/dist/debug-ui/screen-shape-settings/index.d.ts +6 -0
  396. package/dist/debug-ui/screen-text-settings/NumberField.d.ts +9 -0
  397. package/dist/debug-ui/screen-text-settings/ScreenTextSettingsPanel.d.ts +3 -0
  398. package/dist/debug-ui/screen-text-settings/controls/NestedSection.d.ts +7 -0
  399. package/dist/debug-ui/screen-text-settings/controls/Section.d.ts +8 -0
  400. package/dist/debug-ui/screen-text-settings/controls/icons.d.ts +4 -0
  401. package/dist/debug-ui/screen-text-settings/index.d.ts +2 -0
  402. package/dist/debug-ui/screen-text-settings/sections/BackgroundSection.d.ts +8 -0
  403. package/dist/debug-ui/screen-text-settings/sections/ContentSection.d.ts +5 -0
  404. package/dist/debug-ui/screen-text-settings/sections/EffectsSection.d.ts +25 -0
  405. package/dist/debug-ui/screen-text-settings/sections/StyleSection.d.ts +5 -0
  406. package/dist/debug-ui/screen-text-settings/sections/TransformSection.d.ts +5 -0
  407. package/dist/debug-ui/screen-text-settings/sections/background/BackgroundFillControls.d.ts +2 -0
  408. package/dist/debug-ui/screen-text-settings/sections/background/BackgroundSizeControls.d.ts +2 -0
  409. package/dist/debug-ui/screen-text-settings/sections/background/BackgroundStrokeControls.d.ts +2 -0
  410. package/dist/debug-ui/screen-text-settings/sections/background/types.d.ts +7 -0
  411. package/dist/debug-ui/screen-text-settings/sections/effects/BendEffectSection.d.ts +4 -0
  412. package/dist/debug-ui/screen-text-settings/sections/effects/EffectChrome.d.ts +21 -0
  413. package/dist/debug-ui/screen-text-settings/sections/effects/GlowEffectSection.d.ts +4 -0
  414. package/dist/debug-ui/screen-text-settings/sections/effects/InnerShadowEffectSection.d.ts +4 -0
  415. package/dist/debug-ui/screen-text-settings/sections/effects/OutlineEffectSection.d.ts +4 -0
  416. package/dist/debug-ui/screen-text-settings/sections/effects/ShadowEffectSection.d.ts +4 -0
  417. package/dist/debug-ui/screen-text-settings/sections/effects/types.d.ts +14 -0
  418. package/dist/debug-ui/screen-text-settings/settings.d.ts +90 -0
  419. package/dist/debug-ui/screen-text-settings/styles.d.ts +26 -0
  420. package/dist/debug-ui/screen-text-settings/transform.d.ts +6 -0
  421. package/dist/debug-ui/screen-text-settings/types.d.ts +11 -0
  422. package/dist/debug-ui/segmentation-overlay-settings/index.d.ts +12 -0
  423. package/dist/debug-ui/settings-panel/index.d.ts +43 -0
  424. package/dist/debug-ui/shared/MaterialSection.d.ts +13 -0
  425. package/dist/debug-ui/shared/ScreenTransformSection.d.ts +32 -0
  426. package/dist/debug-ui/shared/debugWindow.d.ts +51 -0
  427. package/dist/debug-ui/transform-3d-settings/index.d.ts +11 -0
  428. package/dist/debug-ui/xr-diagnostics/index.d.ts +26 -0
  429. package/dist/debug-ui.cjs +10 -0
  430. package/dist/debug-ui.js +9051 -0
  431. package/dist/detector-K8aej4MB.js +59 -0
  432. package/dist/detector-ijypGtse.cjs +1 -0
  433. package/dist/drawNormalizedCrop-C4KFaRne.cjs +1 -0
  434. package/dist/drawNormalizedCrop-DG3gtJxf.js +135 -0
  435. package/dist/entries/all.d.ts +4 -1
  436. package/dist/entries/core.d.ts +76 -6
  437. package/dist/entries/face-effects.d.ts +130 -10
  438. package/dist/entries/instructions.d.ts +48 -0
  439. package/dist/entries/internal.d.ts +5 -2
  440. package/dist/entries/low-level.d.ts +104 -6
  441. package/dist/entries/particles.d.ts +15 -0
  442. package/dist/entries/product.d.ts +11 -0
  443. package/dist/entries/scene-object.d.ts +10 -0
  444. package/dist/entries/tracking.d.ts +110 -2
  445. package/dist/face-action/index.d.ts +34 -0
  446. package/dist/face-atlas/attributes.d.ts +30 -0
  447. package/dist/face-atlas/eyes.d.ts +272 -0
  448. package/dist/face-atlas/faceAtlas.generated.d.ts +46 -0
  449. package/dist/face-atlas/glsl/atlasVertex.d.ts +46 -0
  450. package/dist/face-atlas/glsl/common.d.ts +55 -0
  451. package/dist/face-atlas/glsl/design.d.ts +49 -0
  452. package/dist/face-atlas/glsl/eyes.d.ts +73 -0
  453. package/dist/face-atlas/glsl/finish.d.ts +24 -0
  454. package/dist/face-atlas/glsl/format.d.ts +4 -0
  455. package/dist/face-atlas/glsl/index.d.ts +59 -0
  456. package/dist/face-atlas/glsl/shading.d.ts +15 -0
  457. package/dist/face-atlas/glsl/shapes.d.ts +66 -0
  458. package/dist/face-atlas/glsl/sparkle.d.ts +19 -0
  459. package/dist/face-atlas/glsl/uniforms.d.ts +106 -0
  460. package/dist/face-atlas/guide.d.ts +51 -0
  461. package/dist/face-atlas/index.d.ts +25 -0
  462. package/dist/face-atlas/lead.d.ts +117 -0
  463. package/dist/face-atlas/madeUpCamera.d.ts +125 -0
  464. package/dist/face-atlas/masks.d.ts +53 -0
  465. package/dist/face-atlas/obj.d.ts +69 -0
  466. package/dist/face-atlas/polylines.d.ts +63 -0
  467. package/dist/face-atlas/probe/FaceSkinProbe.d.ts +208 -0
  468. package/dist/face-atlas/probe/__fixtures__/emulate.d.ts +9 -0
  469. package/dist/face-atlas/probe/__fixtures__/face.d.ts +24 -0
  470. package/dist/face-atlas/probe/constants.d.ts +137 -0
  471. package/dist/face-atlas/probe/glsl.d.ts +43 -0
  472. package/dist/face-atlas/probe/lightFit.d.ts +108 -0
  473. package/dist/face-atlas/probe/schedule.d.ts +44 -0
  474. package/dist/face-atlas/probe/selfTest.d.ts +87 -0
  475. package/dist/face-atlas/probe/stats.d.ts +143 -0
  476. package/dist/face-atlas/probe/targets.d.ts +70 -0
  477. package/dist/face-atlas/probe/unwrap.d.ts +76 -0
  478. package/dist/face-atlas/quality.d.ts +28 -0
  479. package/dist/face-atlas/regions.d.ts +31 -0
  480. package/dist/face-atlas/registry.d.ts +252 -0
  481. package/dist/face-atlas/renderState.d.ts +86 -0
  482. package/dist/face-atlas/selfOcclusion.d.ts +62 -0
  483. package/dist/face-atlas/shading.d.ts +406 -0
  484. package/dist/face-atlas/shapes.d.ts +86 -0
  485. package/dist/face-atlas/sides.d.ts +41 -0
  486. package/dist/face-atlas/skinMask.d.ts +35 -0
  487. package/dist/face-atlas/surface.d.ts +155 -0
  488. package/dist/face-atlas/topology.d.ts +44 -0
  489. package/dist/face-attribute-expression/index.d.ts +10 -0
  490. package/dist/face-character/__fixtures__/faceImageDetections.d.ts +25 -0
  491. package/dist/face-character/__fixtures__/faceNode.d.ts +22 -0
  492. package/dist/face-character/bindFaceModel.d.ts +106 -0
  493. package/dist/face-character/canonicalFace.d.ts +17 -0
  494. package/dist/face-character/canonicalFaceGeometry.d.ts +11 -0
  495. package/dist/face-character/canonicalFacePositions.d.ts +7 -0
  496. package/dist/face-character/driveFaceModel.d.ts +57 -0
  497. package/dist/face-character/expressionOutputs.d.ts +45 -0
  498. package/dist/face-character/faceExpressions.d.ts +104 -0
  499. package/dist/face-character/faceImageLandmarker.d.ts +93 -0
  500. package/dist/face-character/faceMeshBinding.d.ts +62 -0
  501. package/dist/face-character/faceMorph.d.ts +77 -0
  502. package/dist/face-character/faceMorphs.d.ts +46 -0
  503. package/dist/face-character/facePhoto.d.ts +138 -0
  504. package/dist/face-character/facePiercings.d.ts +116 -0
  505. package/dist/face-character/facePin.d.ts +131 -0
  506. package/dist/face-character/faceReprojection.d.ts +273 -0
  507. package/dist/face-character/faceReprojector.d.ts +171 -0
  508. package/dist/face-character/faceRig.d.ts +176 -0
  509. package/dist/face-character/faceSwapPresence.d.ts +85 -0
  510. package/dist/face-character/faceTexture.d.ts +169 -0
  511. package/dist/face-character/faceTextureBaker.d.ts +86 -0
  512. package/dist/face-character/faceTextureGuide.d.ts +106 -0
  513. package/dist/face-character/faceTextureStats.d.ts +298 -0
  514. package/dist/face-character/faceTransfer.d.ts +396 -0
  515. package/dist/face-character/faceTransferGeometry.d.ts +109 -0
  516. package/dist/face-character/faceTransferSelfTest.d.ts +94 -0
  517. package/dist/face-character/faceWarp3D.d.ts +101 -0
  518. package/dist/face-character/faceless.d.ts +79 -0
  519. package/dist/face-character/featureWarp.d.ts +28 -0
  520. package/dist/face-character/liveFaceRegistry.d.ts +370 -0
  521. package/dist/face-character/liveValue.d.ts +12 -0
  522. package/dist/face-character/memo.d.ts +15 -0
  523. package/dist/face-effects.cjs +2267 -195
  524. package/dist/face-effects.js +14191 -3346
  525. package/dist/face-expression/index.d.ts +182 -0
  526. package/dist/face-info/blendshapes.d.ts +3 -0
  527. package/dist/face-info/derive.d.ts +8 -0
  528. package/dist/face-info/drawFaceCrop.d.ts +10 -0
  529. package/dist/face-info/getFaceInfo.d.ts +8 -0
  530. package/dist/face-info/index.d.ts +8 -0
  531. package/dist/face-info/landmarks.d.ts +35 -0
  532. package/dist/face-info/types.d.ts +69 -0
  533. package/dist/gestures/definitions.d.ts +98 -0
  534. package/dist/gestures/detector.d.ts +87 -0
  535. package/dist/gestures/index.d.ts +8 -0
  536. package/dist/gestures/measures.d.ts +114 -0
  537. package/dist/gestures/settings.d.ts +49 -0
  538. package/dist/getFaceInfo-BafgGT27.js +62 -0
  539. package/dist/getFaceInfo-BzlwHMjX.cjs +1 -0
  540. package/dist/hand/armFit.d.ts +46 -0
  541. package/dist/hand/armMask.d.ts +190 -0
  542. package/dist/hand/forearm.d.ts +114 -0
  543. package/dist/hand/handCutout.d.ts +23 -0
  544. package/dist/hand/handCutoutRegistry.d.ts +7 -0
  545. package/dist/hand/handEffect.d.ts +38 -0
  546. package/dist/hand/handGestures.d.ts +524 -0
  547. package/dist/hand/handJoints2d.d.ts +49 -0
  548. package/dist/hand/handNail.d.ts +73 -0
  549. package/dist/hand/handPose.d.ts +98 -0
  550. package/dist/hand/handRigSolver.d.ts +159 -0
  551. package/dist/hand/handTattoo.d.ts +81 -0
  552. package/dist/hand/handTouch.d.ts +240 -0
  553. package/dist/hand/handTracking2d.d.ts +33 -0
  554. package/dist/hand/handTracking2dController.d.ts +65 -0
  555. package/dist/hand/handTracking3d.d.ts +52 -0
  556. package/dist/hand/nailImageMask.d.ts +40 -0
  557. package/dist/hand/nailMaskFingers.d.ts +23 -0
  558. package/dist/hand/nailTipRefine.d.ts +37 -0
  559. package/dist/hand/wrist.d.ts +44 -0
  560. package/dist/hand/wristFilter.d.ts +44 -0
  561. package/dist/hooks/faceResults.d.ts +1 -1
  562. package/dist/hooks/selectors.d.ts +77 -4
  563. package/dist/hooks/useBodies.d.ts +39 -0
  564. package/dist/hooks/useCalibrationFaceTracker.d.ts +1 -1
  565. package/dist/hooks/useFaceAction.d.ts +3 -0
  566. package/dist/hooks/useFaceAttributeExpression.d.ts +16 -0
  567. package/dist/hooks/useFaceDetection.d.ts +18 -0
  568. package/dist/hooks/useFaceInfo.d.ts +19 -0
  569. package/dist/hooks/useFaceInfos.d.ts +15 -0
  570. package/dist/hooks/useFaceModelAcquisition.d.ts +38 -0
  571. package/dist/hooks/useFaceResultReader.d.ts +10 -0
  572. package/dist/hooks/useFrameCapture.d.ts +18 -0
  573. package/dist/hooks/useGesture.d.ts +39 -0
  574. package/dist/hooks/useIrisTracking.d.ts +45 -0
  575. package/dist/hooks/useMediaRecorder.d.ts +14 -2
  576. package/dist/hooks/useOwnedTexture.d.ts +6 -0
  577. package/dist/hooks/useTrackerContext.d.ts +14 -2
  578. package/dist/hooks/useXRDiagnostics.d.ts +81 -0
  579. package/dist/hooks/useXRModel.d.ts +12 -0
  580. package/dist/hooks/useXRSession/facade.d.ts +47 -2
  581. package/dist/hooks/useXRSession/index.d.ts +2 -2
  582. package/dist/hooks/useXRSession/reason.d.ts +21 -0
  583. package/dist/hooks/useXRSession/registry.d.ts +23 -0
  584. package/dist/hooks/useXRSession/store.d.ts +64 -7
  585. package/dist/index-BZoBxyLn.js +1103 -0
  586. package/dist/index-By_LCo2V.cjs +1 -0
  587. package/dist/index-C-Mryx_u.cjs +21 -0
  588. package/dist/index-CKRN-xJp.js +3740 -0
  589. package/dist/index-CUldCMRl.js +188 -0
  590. package/dist/index-Cyk_VIZE.js +1432 -0
  591. package/dist/index-D-4w34GO.cjs +1 -0
  592. package/dist/index-DiIoHK_4.js +442 -0
  593. package/dist/index-Dv3WnY9n.cjs +46 -0
  594. package/dist/index-ItufYyHH.cjs +1 -0
  595. package/dist/index-S3gqudT6.cjs +1 -0
  596. package/dist/index-Sho4F4it.cjs +1 -0
  597. package/dist/index-iIQ9jBDb.js +240 -0
  598. package/dist/index-vr2ichWQ.js +190 -0
  599. package/dist/instructions.cjs +30 -0
  600. package/dist/instructions.js +1528 -0
  601. package/dist/internal-Bb9ZXbpr.cjs +1 -0
  602. package/dist/{internal-KOKJDxCG.js → internal-Gt1wn6Z3.js} +152 -127
  603. package/dist/internal.cjs +1 -1
  604. package/dist/internal.js +16 -9
  605. package/dist/iris/compute.d.ts +27 -0
  606. package/dist/iris/index.d.ts +4 -0
  607. package/dist/iris/lead.d.ts +19 -0
  608. package/dist/iris/types.d.ts +89 -0
  609. package/dist/landmarkMask-CvN-L5NT.cjs +1 -0
  610. package/dist/landmarkMask-DHivVjJm.js +225 -0
  611. package/dist/landmarks-BEjJXcnE.cjs +1 -0
  612. package/dist/landmarks-DtCAFV_m.js +76 -0
  613. package/dist/low-level.cjs +1 -1
  614. package/dist/low-level.js +1494 -629
  615. package/dist/main.cjs +1 -1
  616. package/dist/main.js +1306 -475
  617. package/dist/material/MaterialFill.d.ts +20 -0
  618. package/dist/material/MeshMaterial.d.ts +14 -0
  619. package/dist/material/index.d.ts +2 -0
  620. package/dist/models/Base/index.d.ts +49 -0
  621. package/dist/models/Body/index.d.ts +30 -1
  622. package/dist/models/Face/constants.d.ts +8 -0
  623. package/dist/models/Face/index.d.ts +5 -12
  624. package/dist/models/Face/rotation.d.ts +18 -0
  625. package/dist/models/Hand/GestureTracking.d.ts +1 -1
  626. package/dist/models/Hand/HandTracking.d.ts +19 -1
  627. package/dist/models/Holistic/index.d.ts +49 -0
  628. package/dist/models/Holistic/result.d.ts +68 -0
  629. package/dist/models/Segmentation/index.d.ts +6 -3
  630. package/dist/models/SemanticSegmentation/index.d.ts +31 -0
  631. package/dist/models/SemanticSegmentation/presets.d.ts +28 -0
  632. package/dist/models/index.d.ts +2 -0
  633. package/dist/models/nodeSource.d.ts +9 -0
  634. package/dist/particles/emission.d.ts +24 -0
  635. package/dist/particles/eyes.d.ts +24 -0
  636. package/dist/particles/glsl.d.ts +14 -0
  637. package/dist/particles/index.d.ts +10 -0
  638. package/dist/particles/motion.d.ts +42 -0
  639. package/dist/particles/presets.d.ts +12 -0
  640. package/dist/particles/ring.d.ts +58 -0
  641. package/dist/particles/selfTest.d.ts +53 -0
  642. package/dist/particles/settings.d.ts +127 -0
  643. package/dist/particles/shapes.d.ts +29 -0
  644. package/dist/particles/spawner.d.ts +71 -0
  645. package/dist/particles/system.d.ts +66 -0
  646. package/dist/particles.cjs +122 -0
  647. package/dist/particles.js +999 -0
  648. package/dist/product/ProductDimensions.d.ts +16 -0
  649. package/dist/product/ProductHotspot.d.ts +16 -0
  650. package/dist/product/ProductViewer.d.ts +9 -0
  651. package/dist/product/details.d.ts +53 -0
  652. package/dist/product/index.d.ts +14 -0
  653. package/dist/product/loadModelViewer.d.ts +4 -0
  654. package/dist/product/types.d.ts +71 -0
  655. package/dist/product/useProductAr.d.ts +37 -0
  656. package/dist/product/useProductDetails.d.ts +60 -0
  657. package/dist/product.cjs +1 -0
  658. package/dist/product.js +414 -0
  659. package/dist/providers-CEZQgz2s.cjs +62 -0
  660. package/dist/providers-CRuaD8bi.js +424 -0
  661. package/dist/quality/XRQualityController.d.ts +25 -0
  662. package/dist/quality/controller.d.ts +33 -0
  663. package/dist/quality/index.d.ts +6 -0
  664. package/dist/quality/types.d.ts +100 -0
  665. package/dist/quality/useXRQuality.d.ts +28 -0
  666. package/dist/render/layerStack.d.ts +29 -0
  667. package/dist/render/renderGroups.d.ts +47 -0
  668. package/dist/render/renderPasses.d.ts +26 -0
  669. package/dist/render/sceneBeforeRender.d.ts +12 -0
  670. package/dist/renderGroups-BADrepA1.cjs +1 -0
  671. package/dist/renderGroups-CNB99dZ2.js +152 -0
  672. package/dist/renderPasses-DgxUKn9b.cjs +158 -0
  673. package/dist/renderPasses-DuapJA6V.js +1290 -0
  674. package/dist/renderState-CJNmj5jz.js +39 -0
  675. package/dist/renderState-apSfg4eR.cjs +1 -0
  676. package/dist/scene-object/index.d.ts +146 -0
  677. package/dist/scene-object/runtimeRegistry.d.ts +14 -0
  678. package/dist/scene-object.cjs +1 -0
  679. package/dist/scene-object.js +40 -0
  680. package/dist/screen-image/screenImagePresets.d.ts +13 -0
  681. package/dist/screen-image/screenImageSettings.d.ts +57 -0
  682. package/dist/screen-text/screenTextPresets.d.ts +6 -0
  683. package/dist/screen-text/screenTextSettings.d.ts +147 -0
  684. package/dist/screen2d/coordinates.d.ts +107 -0
  685. package/dist/screen2d/index.d.ts +7 -0
  686. package/dist/screen2d/material-runtime.d.ts +32 -0
  687. package/dist/screen2d/screenTransform.d.ts +60 -0
  688. package/dist/screen2d/smoothing.d.ts +5 -0
  689. package/dist/screen2d/texture.d.ts +10 -0
  690. package/dist/screen2d/transform.d.ts +25 -0
  691. package/dist/screen2d/types.d.ts +90 -0
  692. package/dist/segmentation-BOZJdWFC.js +1911 -0
  693. package/dist/segmentation-J8GoNBvP.cjs +1 -0
  694. package/dist/segmentation2d/faceMemory.d.ts +28 -0
  695. package/dist/segmentation2d/faceRegions.d.ts +24 -0
  696. package/dist/segmentation2d/index.d.ts +9 -0
  697. package/dist/segmentation2d/maskUv.d.ts +23 -0
  698. package/dist/segmentation2d/rasterize.d.ts +14 -0
  699. package/dist/segmentation2d/types.d.ts +52 -0
  700. package/dist/selectors-BvJepq6H.js +196 -0
  701. package/dist/selectors-QB2qsaxy.cjs +1 -0
  702. package/dist/services/MetricsCollector/index.d.ts +7 -1
  703. package/dist/services/MetricsCollector/utils.d.ts +1 -1
  704. package/dist/session-BVX859as.cjs +31 -0
  705. package/dist/session-Cz8aie4K.js +493 -0
  706. package/dist/settings-BJ7FMBsO.js +111 -0
  707. package/dist/settings-C63FMBlF.cjs +1 -0
  708. package/dist/similarityFit-BFqHND2e.cjs +1 -0
  709. package/dist/similarityFit-Bbz-R8AY.js +91 -0
  710. package/dist/spring/index.d.ts +2 -0
  711. package/dist/spring/spring.d.ts +69 -0
  712. package/dist/spring/swing.d.ts +54 -0
  713. package/dist/subjects/index.d.ts +2 -0
  714. package/dist/subjects/select.d.ts +70 -0
  715. package/dist/subjects/types.d.ts +59 -0
  716. package/dist/texture/animatedTexture.d.ts +63 -0
  717. package/dist/texture/animationMath.d.ts +8 -0
  718. package/dist/texture/gifReader.d.ts +17 -0
  719. package/dist/texture/gifTextureSource.d.ts +16 -0
  720. package/dist/texture/sourceResolver.d.ts +30 -0
  721. package/dist/textures-BVwo9Z7z.js +38 -0
  722. package/dist/textures-DAfc61zz.cjs +1 -0
  723. package/dist/tracking/coordinates.d.ts +5 -0
  724. package/dist/tracking-config/apply.d.ts +57 -0
  725. package/dist/tracking-config/index.d.ts +7 -0
  726. package/dist/tracking-config/resolve.d.ts +25 -0
  727. package/dist/tracking-config/storage.d.ts +8 -0
  728. package/dist/tracking-config/types.d.ts +106 -0
  729. package/dist/tracking-config/useXRTrackingConfig.d.ts +38 -0
  730. package/dist/tracking.cjs +10 -1
  731. package/dist/tracking.js +1531 -294
  732. package/dist/trigger-D9L4GPmQ.js +3726 -0
  733. package/dist/trigger-DZ9vU7jo.cjs +147 -0
  734. package/dist/types/common.d.ts +11 -1
  735. package/dist/types/compositor.d.ts +21 -0
  736. package/dist/types/face.d.ts +21 -14
  737. package/dist/types/gesture-tracking.d.ts +2 -2
  738. package/dist/types/hand-tracking.d.ts +19 -2
  739. package/dist/types/holistic.d.ts +121 -0
  740. package/dist/types/index.d.ts +1 -1
  741. package/dist/types/model.d.ts +22 -2
  742. package/dist/types/nodes.d.ts +83 -6
  743. package/dist/types/segmentation.d.ts +26 -0
  744. package/dist/types/session.d.ts +50 -4
  745. package/dist/types/tracking.d.ts +8 -2
  746. package/dist/types/util-types.d.ts +1 -1
  747. package/dist/useBodies-BYzJpQ4L.js +75 -0
  748. package/dist/useBodies-Cxpmx6Bb.cjs +1 -0
  749. package/dist/useFaceInfo-BzEUj2OI.js +75 -0
  750. package/dist/useFaceInfo-DlLRAVNw.cjs +1 -0
  751. package/dist/useFaceResultReader-Cc4Qrutf.js +61 -0
  752. package/dist/useFaceResultReader-D3jOQNKz.cjs +1 -0
  753. package/dist/useInstructionHold-DOu-RpCM.js +53 -0
  754. package/dist/useInstructionHold-DwJY1Alr.cjs +1 -0
  755. package/dist/useIrisTracking-Bz4uLDa7.js +6190 -0
  756. package/dist/useIrisTracking-DRGWgoNy.cjs +35 -0
  757. package/dist/useLandmarkPoseFit-Bg-h9BPb.cjs +1 -0
  758. package/dist/useLandmarkPoseFit-Bmb3h6Mw.js +87 -0
  759. package/dist/useXRCapabilities-B1KLckqw.js +30 -0
  760. package/dist/useXRCapabilities-CZlPUBjF.cjs +1 -0
  761. package/dist/utils/canonicalRigidLandmarks.d.ts +8 -0
  762. package/dist/utils/drawNormalizedCrop.d.ts +22 -0
  763. package/dist/utils/fns.d.ts +6 -3
  764. package/dist/utils/headOccluderFit.d.ts +42 -0
  765. package/dist/utils/integrity.d.ts +25 -26
  766. package/dist/utils/landmarkBounds.d.ts +1 -1
  767. package/dist/utils/logger.d.ts +2 -2
  768. package/dist/utils/resolveNumFaces.d.ts +13 -0
  769. package/dist/utils/shoulderOccluderFit.d.ts +38 -0
  770. package/dist/utils/similarityFit.d.ts +23 -0
  771. package/dist/utils/updateThrottle.d.ts +2 -0
  772. package/dist/utils/useStableUniforms.d.ts +18 -0
  773. package/dist/utils/visionWasm.d.ts +18 -0
  774. package/dist/uv-BMFt19bg.cjs +1 -0
  775. package/dist/{index-BD-JWMjE.js → uv-DJU_XfmN.js} +15 -180
  776. package/dist/x-Co8jPhP0.js +127 -0
  777. package/dist/x-KC8E4Gaj.cjs +41 -0
  778. package/docs/MIGRATION_GUIDE.md +589 -0
  779. package/docs/SDK_DOCUMENTATION.md +1157 -0
  780. package/docs/api/adaptive-quality.mdx +104 -0
  781. package/docs/api/asset-lifecycle.mdx +78 -0
  782. package/docs/api/audio.mdx +36 -0
  783. package/docs/api/behavior-components.mdx +164 -0
  784. package/docs/api/body-instructions.mdx +287 -0
  785. package/docs/api/body-rig.mdx +384 -0
  786. package/docs/api/body-triggers.mdx +235 -0
  787. package/docs/api/camera-permission.mdx +142 -0
  788. package/docs/api/capture-recording.mdx +111 -0
  789. package/docs/api/coordinate-spaces.mdx +168 -0
  790. package/docs/api/cross-camera.mdx +89 -0
  791. package/docs/api/debug-ui-scene-editor.mdx +270 -0
  792. package/docs/api/diagnostics-calibration.mdx +97 -0
  793. package/docs/api/external-face-mesh.mdx +231 -0
  794. package/docs/api/face-actions.mdx +108 -0
  795. package/docs/api/face-attribute-expression.mdx +87 -0
  796. package/docs/api/face-binding-anchors.mdx +55 -0
  797. package/docs/api/face-character.mdx +157 -0
  798. package/docs/api/face-effects.mdx +28 -0
  799. package/docs/api/face-expression-controller.mdx +153 -0
  800. package/docs/api/face-info.mdx +118 -0
  801. package/docs/api/face-inset.mdx +204 -0
  802. package/docs/api/face-instructions.mdx +183 -0
  803. package/docs/api/face-liquify.mdx +196 -0
  804. package/docs/api/face-mesh.mdx +130 -0
  805. package/docs/api/face-morph.mdx +117 -0
  806. package/docs/api/face-painting.mdx +40 -0
  807. package/docs/api/face-reprojection.mdx +154 -0
  808. package/docs/api/face-retouching.mdx +81 -0
  809. package/docs/api/face-swap.mdx +350 -0
  810. package/docs/api/face-warp-3d.mdx +166 -0
  811. package/docs/api/faceless.mdx +143 -0
  812. package/docs/api/gestures.mdx +210 -0
  813. package/docs/api/hair.mdx +97 -0
  814. package/docs/api/hand-instructions.mdx +222 -0
  815. package/docs/api/hand-rig.mdx +661 -0
  816. package/docs/api/hand-touch.mdx +162 -0
  817. package/docs/api/head-occluder.mdx +563 -0
  818. package/docs/api/holistic-tracker.mdx +164 -0
  819. package/docs/api/instructions.mdx +323 -0
  820. package/docs/api/iris-tracking.mdx +247 -0
  821. package/docs/api/made-up-camera.mdx +131 -0
  822. package/docs/api/makeup-skin-tone.mdx +135 -0
  823. package/docs/api/makeup.mdx +353 -0
  824. package/docs/api/material-render-state.mdx +132 -0
  825. package/docs/api/multi-subject.mdx +185 -0
  826. package/docs/api/particles.mdx +183 -0
  827. package/docs/api/person-cutout.mdx +171 -0
  828. package/docs/api/pin-to-face-mesh.mdx +274 -0
  829. package/docs/api/product-ar.mdx +114 -0
  830. package/docs/api/product-details.mdx +78 -0
  831. package/docs/api/runtime-3d.mdx +316 -0
  832. package/docs/api/scene-object-store.mdx +213 -0
  833. package/docs/api/screen-image.mdx +67 -0
  834. package/docs/api/screen-shape.mdx +64 -0
  835. package/docs/api/screen-space-coordinates.mdx +75 -0
  836. package/docs/api/screen-text.mdx +39 -0
  837. package/docs/api/segmentation-overlay.mdx +301 -0
  838. package/docs/api/session-lifecycle.mdx +136 -0
  839. package/docs/api/texture-sources.mdx +74 -0
  840. package/docs/api/trackers.mdx +65 -0
  841. package/docs/api/tracking-config.mdx +108 -0
  842. package/docs/docs.json +121 -0
  843. package/docs/examples/lip-shaders.mdx +273 -0
  844. package/docs/examples/scene-object-recipes.mdx +194 -0
  845. package/docs/guides/face-atlas-template.svg +1 -0
  846. package/docs/guides/face-atlas-textures.mdx +186 -0
  847. package/docs/guides/face-texture-template.svg +1 -0
  848. package/docs/guides/harness-debug-ui.mdx +139 -0
  849. package/docs/guides/lip-effect-textures.mdx +368 -0
  850. package/docs/guides/lip-uv-template.png +0 -0
  851. package/docs/guides/lip-uv-template.svg +1 -0
  852. package/docs/guides/makeup-design-textures.mdx +109 -0
  853. package/docs/inspector/hierarchy-panel.mdx +51 -0
  854. package/docs/inspector/object-inspector-panel.mdx +51 -0
  855. package/docs/introduction.mdx +120 -0
  856. package/docs/scene-objects/overview.mdx +127 -0
  857. package/docs/scene-objects/render-groups.mdx +77 -0
  858. package/docs/scene-objects/runtime-rendering.mdx +75 -0
  859. package/docs/texture-api-consumer.md +84 -0
  860. package/package.json +86 -8
  861. package/settings.json +1998 -0
  862. package/dist/DebuggerUI-CEfdddkZ.cjs +0 -1
  863. package/dist/DebuggerUI-Dgop6Q6o.js +0 -269
  864. package/dist/components/FaceRetouch/retouchRegions.d.ts +0 -23
  865. package/dist/components/FaceRetouch/useFaceRetouchRegions.d.ts +0 -12
  866. package/dist/index-B5J4gzn2.cjs +0 -1
  867. package/dist/index-BVBVg96G.cjs +0 -1
  868. package/dist/index-CYMj26Ej.js +0 -1331
  869. package/dist/index-DtwHElmG.js +0 -157
  870. package/dist/index-PtFmD6B8.cjs +0 -1
  871. package/dist/internal-DH5d1Xnq.cjs +0 -1
  872. package/dist/modules/XRClient/index.d.ts +0 -9
  873. package/dist/modules/index.d.ts +0 -1
  874. package/dist/selectors-BHO6TnoC.js +0 -59
  875. package/dist/selectors-Bub0o3qy.cjs +0 -1
  876. package/dist/services/ApiService.d.ts +0 -12
  877. package/dist/types/client.d.ts +0 -3
  878. package/dist/useFaceResults-cpsSmKKc.js +0 -81
  879. package/dist/useFaceResults-hVUJYSEY.cjs +0 -1
@@ -0,0 +1,98 @@
1
+ import { TrackerPoint } from '../types/common';
2
+ import { Handedness } from '../types/hand-tracking';
3
+ /**
4
+ * The 21 MediaPipe hand joints, in landmark order (index = MediaPipe index).
5
+ * CMC / MCP / PIP / DIP / IP are the knuckles from the wrist outward; the
6
+ * thumb has CMC, MCP, IP, tip, the fingers MCP, PIP, DIP, tip.
7
+ */
8
+ export declare const HAND_JOINT_NAMES: readonly ["wrist", "thumbCmc", "thumbMcp", "thumbIp", "thumbTip", "indexMcp", "indexPip", "indexDip", "indexTip", "middleMcp", "middlePip", "middleDip", "middleTip", "ringMcp", "ringPip", "ringDip", "ringTip", "pinkyMcp", "pinkyPip", "pinkyDip", "pinkyTip"];
9
+ export type HandJointName = (typeof HAND_JOINT_NAMES)[number];
10
+ export declare const HAND_JOINT_INDEX: Readonly<Record<HandJointName, number>>;
11
+ /**
12
+ * One tracked hand, both spaces.
13
+ *
14
+ * - `world`: 21 joints in the hand's own metric frame — CENTIMETRES, origin at
15
+ * MediaPipe's hand centre (roughly the middle of the palm), three.js axes for
16
+ * the feed as displayed: +X screen right, +Y up, +Z toward the viewer. This is
17
+ * the true 3D shape (finger bend, palm facing), independent of distance.
18
+ * - `image`: the same 21 joints in tracker space (centre origin, ±1, Y up; `z`
19
+ * is MediaPipe's relative depth) — what `HandTracker` has always published.
20
+ * Unproject with `trackerToWorld` to place things on screen.
21
+ */
22
+ export type HandPose = {
23
+ /** The person's anatomical hand on every source (mirrored webcam or not). */
24
+ handedness: Handedness;
25
+ /** MediaPipe's handedness confidence, 0..1. */
26
+ score: number;
27
+ world: TrackerPoint[];
28
+ image: TrackerPoint[];
29
+ /** `performance.now()` of the detection this pose came from. */
30
+ timestampMs: number;
31
+ /** True while the hand is lost and this pose is being held (see `holdMs`). */
32
+ held: boolean;
33
+ };
34
+ export type HandPoses = {
35
+ left: HandPose | null;
36
+ right: HandPose | null;
37
+ };
38
+ /** A raw detection before identity assignment. `handedness` is already anatomical. */
39
+ export type HandDetection = {
40
+ handedness: Handedness | undefined;
41
+ score: number;
42
+ world: TrackerPoint[];
43
+ image: TrackerPoint[];
44
+ };
45
+ export type AssignHandPosesOptions = {
46
+ /** Keep a lost hand (marked `held`) this long before dropping it. Default 200 ms. */
47
+ holdMs?: number;
48
+ /**
49
+ * Below this handedness confidence a label that disagrees with where the
50
+ * hand was a moment ago loses to continuity. Default 0.8.
51
+ */
52
+ confidentScore?: number;
53
+ /**
54
+ * Continuity only applies while the previous pose is this recent. Default
55
+ * 500 ms: a hand gone longer than that is assigned by its label alone.
56
+ */
57
+ continuityMs?: number;
58
+ };
59
+ export declare const HAND_POSE_DEFAULT_HOLD_MS = 200;
60
+ /**
61
+ * Assigns this frame's detections to a stable left / right slot.
62
+ *
63
+ * MediaPipe labels each hand independently, so it can call both hands "left",
64
+ * or flip one hand's label for a frame when it turns edge-on. A rig bound to
65
+ * that label would jump to the other hand. The rules, in order:
66
+ *
67
+ * 1. Two hands with different, confident labels: take the labels.
68
+ * 2. Otherwise, when both slots were seen within `continuityMs`, take the
69
+ * pairing that keeps each wrist nearest to where that slot's wrist was.
70
+ * 3. Two hands with the same label and no history: the higher score keeps
71
+ * the label, the other hand gets the other side.
72
+ * 4. One hand: its label, unless the label is not confident and the hand sits
73
+ * where the OTHER slot's hand was a moment ago (it is that hand, mislabeled).
74
+ *
75
+ * A slot with no detection keeps its previous pose for `holdMs` (marked
76
+ * `held`), then becomes `null`. Pure: pass the previous result back in.
77
+ */
78
+ export declare const assignHandPoses: (detections: readonly HandDetection[], previous: HandPoses, nowMs: number, { holdMs, confidentScore, continuityMs, }?: AssignHandPosesOptions) => HandPoses;
79
+ /**
80
+ * MediaPipe's hand landmarker labels the hand AS IT APPEARS in the frame it
81
+ * is given (measured on the SDK's `hand_tracking.task`: an unmirrored right
82
+ * hand reads "Right", the same frame flipped reads "Left" — not the mirrored-
83
+ * selfie assumption some MediaPipe docs describe). The SDK analyzes the feed as
84
+ * displayed: straight for the rear camera, images and video (labels are
85
+ * anatomical), mirrored for the front webcam (labels are swapped). The same
86
+ * rule as every MediaPipe side (`personSide`, GROUNDING "Left and right").
87
+ */
88
+ export declare const anatomicalHandedness: (label: string | undefined, feedMirrored: boolean) => Handedness | undefined;
89
+ /**
90
+ * MediaPipe world landmark (metres, origin at the hand centre, image axes:
91
+ * +X right, +Y down, +Z away from the camera) → SDK hand world joint
92
+ * (centimetres, three.js axes: +X right, +Y up, +Z toward the viewer).
93
+ */
94
+ export declare const handWorldLandmarkToJoint: (landmark: {
95
+ x: number;
96
+ y: number;
97
+ z: number;
98
+ }, target?: TrackerPoint) => TrackerPoint;
@@ -0,0 +1,159 @@
1
+ import { Handedness } from '../types/hand-tracking';
2
+ import { SimilarityFit } from '../utils/similarityFit';
3
+ import { HandJointName, HandPose } from './handPose';
4
+ import * as THREE from "three";
5
+ /**
6
+ * Hand rig contract (v1).
7
+ *
8
+ * A compatible model has a node named after each joint it rotates — the
9
+ * `wrist` plus three per digit — placed AT that joint, each child of the
10
+ * previous one along the digit and every digit's first node a child of
11
+ * `wrist`:
12
+ *
13
+ * wrist ─┬ thumbCmc → thumbMcp → thumbIp → (thumbTip)
14
+ * ├ indexMcp → indexPip → indexDip → (indexTip)
15
+ * ├ middleMcp → … (middleTip)
16
+ * ├ ringMcp → … (ringTip)
17
+ * └ pinkyMcp → … (pinkyTip)
18
+ *
19
+ * The `…Tip` nodes are optional (without one the tip is extrapolated from the
20
+ * last bone). Any rest pose, units, bone roll and authoring axes work: the
21
+ * driver measures every rotation from the model's own rest pose. The model is
22
+ * ONE chirality (`modelHand`, default `"right"`); the other is drawn mirrored.
23
+ */
24
+ export declare const HAND_RIG_REQUIRED_JOINTS: readonly HandJointName[];
25
+ /** The rotating bones, parents before children, with the joint each one aims at. */
26
+ export declare const HAND_RIG_BONES: ReadonlyArray<{
27
+ name: HandJointName;
28
+ parent: HandJointName;
29
+ child: HandJointName;
30
+ }>;
31
+ /** Palm joints that move rigidly with the hand: they fix the root pose. */
32
+ export declare const HAND_RIG_PALM_JOINTS: readonly HandJointName[];
33
+ export type HandRigBinding = {
34
+ /** The object whose matrix places the whole rig (its rest = identity). */
35
+ root: THREE.Object3D;
36
+ bones: Record<HandJointName, THREE.Object3D | null>;
37
+ /** Rest joint positions in root space (model units), indexed like `HAND_JOINT_NAMES`. */
38
+ restPositions: THREE.Vector3[];
39
+ /** Rest orientation of each bone in root space. */
40
+ restQuaternions: Partial<Record<HandJointName, THREE.Quaternion>>;
41
+ /** Rest local quaternion (`bone.quaternion`) of each bone. */
42
+ restLocal: Partial<Record<HandJointName, THREE.Quaternion>>;
43
+ /** Rest local position / scale of each joint node (finger lengths are applied on top). */
44
+ restLocalPosition: Partial<Record<HandJointName, THREE.Vector3>>;
45
+ restLocalScale: Partial<Record<HandJointName, THREE.Vector3>>;
46
+ restPalm: Float64Array;
47
+ /** Unit normal out of the palm, root space, rest pose. */
48
+ restPalmNormal: THREE.Vector3;
49
+ modelHand: Handedness;
50
+ };
51
+ /**
52
+ * Reads a compatible rig's rest pose. `root` is the model's top object (for a
53
+ * GLB, the cloned `gltf.scene`); call before posing it. Throws if a required
54
+ * joint is missing.
55
+ */
56
+ export declare const bindHandRig: (root: THREE.Object3D, modelHand?: Handedness) => HandRigBinding;
57
+ /** Bones `HandAttachment` can sit on: the 15 rotating finger bones. */
58
+ export type HandAttachmentJoint = (typeof HAND_RIG_BONES)[number]["name"];
59
+ export type HandAttachmentTransform = {
60
+ /** Position in the bone's local space. */
61
+ position: THREE.Vector3;
62
+ /** Orientation in the bone's local space. */
63
+ quaternion: THREE.Quaternion;
64
+ };
65
+ /**
66
+ * Where content attached to `joint`'s bone sits, in that bone's LOCAL space:
67
+ * `along` of the way from the joint to the next one (0 = at the joint, 1 = at
68
+ * the next), in the attachment frame — +Y along the finger toward the tip, +Z
69
+ * out of the palm (so −Z is the back of the hand), +X = Y × Z. Content
70
+ * authored in that frame (a ring around +Y with its stone at −Z) lands on the
71
+ * finger whatever the rig's bone axes are. Reads the child joint's CURRENT
72
+ * local position, so tracked finger lengths move the attachment with them.
73
+ */
74
+ export declare const handAttachmentLocal: (binding: HandRigBinding, joint: HandAttachmentJoint, along: number, out?: HandAttachmentTransform) => HandAttachmentTransform;
75
+ /**
76
+ * A tracked hand's 21 joints in scene (world) space: the metric world joints
77
+ * (true 3D shape) scaled, rotated in the image plane and moved so their x / y
78
+ * land on the tracked image points unprojected onto the `z = 0` plane. The
79
+ * depth keeps the metric shape at that scale (weak perspective).
80
+ */
81
+ export declare const handPoseToScene: (pose: Pick<HandPose, "image" | "world">, camera: THREE.Camera, out?: THREE.Vector3[]) => THREE.Vector3[];
82
+ export type HandRigSolution = {
83
+ /** Root pose without the mirror (proper similarity) — smooth this one. */
84
+ fit: SimilarityFit;
85
+ /** Mirror the root in X (the hand on screen has the other chirality). */
86
+ mirrored: boolean;
87
+ /** Local quaternion for each rotating bone. */
88
+ local: Partial<Record<HandJointName, THREE.Quaternion>>;
89
+ /**
90
+ * Each rotating bone's tracked segment length over its rest length (after
91
+ * the palm fit), clamped to `HAND_RIG_LENGTH_RANGE`. `1` = the model's own
92
+ * proportion.
93
+ */
94
+ lengths: Partial<Record<HandJointName, number>>;
95
+ /**
96
+ * Where each digit's first knuckle (thumb CMC, the four MCPs) is tracked,
97
+ * relative to the rig's rest knuckle after the palm fit — rig-root space,
98
+ * model units. The palm fit is rigid, so a hand with a wider or narrower
99
+ * knuckle spread than the model's leaves its fingers starting a few
100
+ * millimetres off; these offsets move them onto the person's knuckles.
101
+ */
102
+ knuckles: Partial<Record<HandJointName, THREE.Vector3>>;
103
+ };
104
+ /** A knuckle moves at most this many palm lengths from its rest spot (≈ 1.75 cm). */
105
+ export declare const HAND_RIG_KNUCKLE_SHIFT = 0.2;
106
+ /** Clamp for finger segment length ratios: tracking noise and odd rigs stay sane. */
107
+ export declare const HAND_RIG_LENGTH_RANGE: readonly [number, number];
108
+ /**
109
+ * A hand that moves farther than this many palm lengths (wrist → middle MCP)
110
+ * in one frame snaps instead of easing: another hand took the slot, or it
111
+ * re-entered elsewhere. 2.5 palms ≈ 22 cm on an average hand.
112
+ */
113
+ export declare const HAND_RIG_SNAP_PALMS = 2.5;
114
+ /**
115
+ * The snap distance for `stepLandmarkPoseSmoothing`, in the MODEL's units:
116
+ * `HAND_RIG_SNAP_PALMS` × the rig's rest palm length. The palm fit maps from
117
+ * model units, so a fixed centimetre threshold would never fire on a model
118
+ * authored in metres (and fire constantly on one in millimetres).
119
+ */
120
+ export declare const handRigSnapDistance: (binding: HandRigBinding) => number;
121
+ /**
122
+ * The on-screen chirality of a hand: its anatomical side, flipped when the
123
+ * feed is mirrored (a right hand in the mirrored selfie view LOOKS like a left
124
+ * hand, so a right-hand model must be mirrored onto it).
125
+ */
126
+ export declare const screenChirality: (hand: Handedness, feedMirrored: boolean) => Handedness;
127
+ /**
128
+ * Solves the rig for one frame: the root similarity (from the palm joints)
129
+ * and each bone's local rotation (a swing from its rest direction to the live
130
+ * direction of its child joint, carried down the chain). Pure; reuse `out`.
131
+ */
132
+ export declare const solveHandRig: (binding: HandRigBinding, pose: Pick<HandPose, "image" | "world" | "handedness">, camera: THREE.Camera, feedMirrored: boolean, out?: HandRigSolution) => HandRigSolution;
133
+ /**
134
+ * Gives each finger segment its length ratio WITHOUT changing its thickness,
135
+ * and (with `knuckles`) starts each digit at its tracked knuckle.
136
+ *
137
+ * - A segment with a rotating bone below it (MCP, PIP; thumb CMC, MCP) is
138
+ * lengthened by moving the next joint out along it (its rest local position
139
+ * × ratio); the skin between the two joints stretches through its weights,
140
+ * the cross-section keeps the model's size.
141
+ * - The last segment (DIP, thumb IP) has nothing weighted below it, so it is
142
+ * stretched along its own axis (the direction of its tip node, when that is
143
+ * one of the bone's local axes — Blender's +Y); otherwise uniformly.
144
+ *
145
+ * `knuckles` (rig-root space, `HandRigSolution.knuckles`) move each digit's
146
+ * first bone, clamped to `HAND_RIG_KNUCKLE_SHIFT` palm lengths; the palm skin
147
+ * between the knuckles follows through its weights.
148
+ *
149
+ * `null` lengths and knuckles reset every joint to its rest position and scale.
150
+ */
151
+ export declare const applyHandRigLengths: (binding: HandRigBinding, lengths: Partial<Record<HandJointName, number>> | null, knuckles?: Partial<Record<HandJointName, THREE.Vector3>> | null) => void;
152
+ /**
153
+ * Writes a solution onto the bound bones (no smoothing). `matchLengths`
154
+ * (default `true`) also gives the digits the tracked segment lengths
155
+ * (`applyHandRigLengths`); `false` keeps the model's proportions.
156
+ */
157
+ export declare const applyHandRigSolution: (binding: HandRigBinding, solution: HandRigSolution, matchLengths?: boolean) => void;
158
+ /** The root's matrix for a (possibly smoothed) fit: similarity, then the mirror. */
159
+ export declare const handRigRootMatrix: (fit: Pick<SimilarityFit, "scale" | "quaternion" | "translation">, mirrored: boolean, out?: THREE.Matrix4) => THREE.Matrix4;
@@ -0,0 +1,81 @@
1
+ import { HandRigBinding } from './handRigSolver';
2
+ import * as THREE from "three";
3
+ /**
4
+ * Hand tattoos (#271): art projected onto a hand model's surface in the
5
+ * model's REST pose, so it deforms with the skin.
6
+ *
7
+ * The projector is a box on one side of the hand — the back or the palm —
8
+ * centred half-way from the wrist to the knuckles. A surface point is inked
9
+ * when it lies on that side of the palm's mid-plane, inside the art's
10
+ * rectangle, and faces the projector. Everything is measured from the rig
11
+ * contract (joint positions, palm normal), so it works on any compatible
12
+ * model, with or without UVs.
13
+ */
14
+ /** Which side of the hand the art goes on. */
15
+ export type HandTattooPlacement = "back" | "palm";
16
+ /** Default art width, in palm lengths (wrist → middle MCP): 0.55 ≈ 4.8 cm on an average hand. */
17
+ export declare const HAND_TATTOO_DEFAULT_SIZE = 0.55;
18
+ /**
19
+ * Drawn after the hand model (transparent pass, order 0): the tattoo blends
20
+ * over whatever the hand shows — the camera image under a `HandOccluder`, or
21
+ * a visible model (skin, glove).
22
+ */
23
+ export declare const HAND_TATTOO_RENDER_ORDER = 1;
24
+ /** Ink fades in between these facings (cosine between the surface normal and the projector). */
25
+ export declare const HAND_TATTOO_FACING_FADE: readonly [number, number];
26
+ /** A placement's frame in the rig root's rest space (model units). */
27
+ export type HandTattooFrame = {
28
+ /** Centre: half-way from the wrist to the four knuckles, on the palm's mid-plane. */
29
+ origin: THREE.Vector3;
30
+ /** Out of the tattooed side (the back: away from the palm; the palm: out of it). */
31
+ normal: THREE.Vector3;
32
+ /** Toward the fingers, perpendicular to `normal`. */
33
+ up: THREE.Vector3;
34
+ /** The viewer's right when looking at that side with the fingers up (`up × normal`). */
35
+ right: THREE.Vector3;
36
+ /** Toward the thumb: `right` or `−right`, depending on the side and the model's chirality. */
37
+ thumb: THREE.Vector3;
38
+ /** Palm length (wrist → middle MCP), model units. */
39
+ palm: number;
40
+ };
41
+ /** The frame a placement projects from, read off the rig's rest joints. Pure. */
42
+ export declare const handTattooFrame: (binding: Pick<HandRigBinding, "restPositions" | "restPalmNormal">, placement: HandTattooPlacement) => HandTattooFrame;
43
+ export type HandTattooPlacementOptions = {
44
+ /** Art width, model units. */
45
+ size: number;
46
+ /** `[towardThumb, towardFingers]` from the frame's origin, model units. */
47
+ offset?: readonly [number, number];
48
+ };
49
+ /**
50
+ * The matrix from a hand mesh's geometry (its `position` attribute) to decal
51
+ * space: x along `frame.right`, y along `frame.up`, z along `frame.normal`,
52
+ * in art widths, origin at the art's centre. The art covers |x| ≤ ½ and
53
+ * |y| ≤ ½ ÷ aspect; z > 0 is the tattooed side of the palm's mid-plane.
54
+ * `geometryToRoot` comes from `handGeometryToRoot`.
55
+ */
56
+ export declare const handTattooMatrix: (frame: HandTattooFrame, geometryToRoot: THREE.Matrix4, { size, offset }: HandTattooPlacementOptions, out?: THREE.Matrix4) => THREE.Matrix4;
57
+ /**
58
+ * The matrix from a hand mesh's geometry to the rig root's rest space.
59
+ *
60
+ * A skinned mesh's rest surface is `bone rest × inverse bind matrix × bind
61
+ * matrix × position`; using the wrist (which `HandRig` never moves inside the
62
+ * model) gives it for every vertex, and also undoes position quantisation
63
+ * (KHR_mesh_quantization folds it into the inverse bind matrices). A mesh
64
+ * that is not skinned on the wrist uses its own transform relative to the root.
65
+ */
66
+ export declare const handGeometryToRoot: (binding: Pick<HandRigBinding, "root" | "bones">, mesh: THREE.Mesh, out?: THREE.Matrix4) => THREE.Matrix4;
67
+ export type HandTattooLook = {
68
+ /** Radians, counter-clockwise as seen looking at the tattooed side. */
69
+ rotation?: number;
70
+ /** Art width ÷ height. Default `1`. */
71
+ aspect?: number;
72
+ /** The hand is drawn mirrored (the model's other chirality). */
73
+ mirrored?: boolean;
74
+ };
75
+ /**
76
+ * Where a point in decal space (`handTattooMatrix` × position) samples the
77
+ * art, or `null` when it gets no ink (outside the art, or on the other side
78
+ * of the palm). The JS twin of the tattoo shader. On a mirrored hand the art
79
+ * is flipped back, so it never reads mirrored and turns the same way.
80
+ */
81
+ export declare const handTattooUv: (decal: THREE.Vector3, { rotation, aspect, mirrored }?: HandTattooLook, out?: THREE.Vector2) => THREE.Vector2 | null;
@@ -0,0 +1,240 @@
1
+ import { Handedness } from '../types/hand-tracking';
2
+ import * as THREE from "three";
3
+ /**
4
+ * Touch objects with the hands, no physics engine: each tracked hand is a
5
+ * palm sphere plus five fingertip spheres; objects are spheres (balls, and
6
+ * boxes approximated by their inscribed sphere) in a box world with gravity,
7
+ * a floor, walls, bounces and damping. Pinch to grab and carry, release to
8
+ * throw, push or poke with the hand, hover and tap with the index tip.
9
+ *
10
+ * Everything is in scene units at the hand's own depth (`handPoseToScene`:
11
+ * the `z = 0` tracking plane plus the hand's relative depth). One camera can't
12
+ * measure how far the hand is, so by default (`flat`) the hand reaches every
13
+ * object on screen: hand-to-object contacts ignore depth.
14
+ */
15
+ /** The fingertips that touch, thumb to pinky. */
16
+ export declare const HAND_TOUCH_TIPS: readonly ["thumbTip", "indexTip", "middleTip", "ringTip", "pinkyTip"];
17
+ export type HandTouchTip = (typeof HAND_TOUCH_TIPS)[number];
18
+ export type HandTouchPart = "palm" | HandTouchTip;
19
+ /** A tracked hand, or the screen pointer (mouse / touch) playing as one. */
20
+ export type TouchHandId = Handedness | "pointer";
21
+ export type HandTouchSettings = {
22
+ /** Palm sphere radius, in palm lengths (wrist → middle knuckle). Default 0.5. */
23
+ palmRadius: number;
24
+ /** Fingertip sphere radius, in palm lengths. Default 0.12. */
25
+ tipRadius: number;
26
+ /** A pinch starts when the thumb and index tips are closer than this, palm lengths. Default 0.3. */
27
+ pinchStart: number;
28
+ /** A pinch ends when they are farther than this, palm lengths. Default 0.45. */
29
+ pinchEnd: number;
30
+ /**
31
+ * Below this thumb–index distance (palm lengths) the hand is closing to pinch:
32
+ * the thumb and index tips stop pushing, so they don't knock away what they
33
+ * are about to grab. Default 0.6.
34
+ */
35
+ pinchReady: number;
36
+ /** Per-detection EMA on the colliders, `1` = none. Default 0.6. */
37
+ smoothing: number;
38
+ };
39
+ export declare const HAND_TOUCH_DEFAULTS: Readonly<HandTouchSettings>;
40
+ export type TouchSphere = {
41
+ center: THREE.Vector3;
42
+ /** Scene units per second, smoothed. */
43
+ velocity: THREE.Vector3;
44
+ radius: number;
45
+ };
46
+ /** One hand's colliders and pinch, updated from its scene joints (`updateTouchHand`). */
47
+ export type TouchHand = {
48
+ hand: TouchHandId;
49
+ tracked: boolean;
50
+ /** Wrist → middle knuckle, scene units. */
51
+ palmLength: number;
52
+ palm: TouchSphere;
53
+ tips: Record<HandTouchTip, TouchSphere>;
54
+ /** Thumb–index tip distance in palm lengths. */
55
+ pinchDistance: number;
56
+ pinching: boolean;
57
+ /** Between the thumb and index tips. */
58
+ pinch: THREE.Vector3;
59
+ /** The pinch point's velocity over the last ~0.1 s (what a release throws with). */
60
+ pinchVelocity: THREE.Vector3;
61
+ /** The detection the colliders come from (`HandPose.timestampMs`). */
62
+ timeMs: number | null;
63
+ /** Recent pinch points, for `pinchVelocity`. */
64
+ history: {
65
+ timeMs: number;
66
+ point: THREE.Vector3;
67
+ }[];
68
+ };
69
+ export declare const createTouchHand: (hand: TouchHandId) => TouchHand;
70
+ /**
71
+ * Updates a hand's colliders from its 21 scene joints (`handPoseToScene`), or
72
+ * `null` when the hand is lost. `timeMs` is the detection's time: the same
73
+ * detection twice changes nothing, so it can run every render frame.
74
+ */
75
+ export declare const updateTouchHand: (state: TouchHand, joints: readonly THREE.Vector3[] | null, timeMs: number, settings?: Partial<HandTouchSettings>) => TouchHand;
76
+ /**
77
+ * The screen pointer as a hand: a sphere of `radius` at `point` (scene units,
78
+ * on the hand plane) that hovers what it is over; pressed = pinching, so a
79
+ * press on an object grabs it, a release throws it, a quick click taps it and
80
+ * a press elsewhere dragged across objects pushes them. `point` null: off the
81
+ * screen.
82
+ */
83
+ export declare const updatePointerHand: (state: TouchHand, point: THREE.Vector3 | null, pressed: boolean, timeMs: number, radius: number) => TouchHand;
84
+ export type TouchShape = "sphere" | "box";
85
+ export type TouchBodyOptions = {
86
+ /** Default `"sphere"`. A box collides as its inscribed sphere and settles flat on the floor. */
87
+ shape?: TouchShape;
88
+ /** Diameter (sphere) or edge (box), scene units. Default 0.4. */
89
+ size?: number;
90
+ /** Start position, scene units. Default the origin. */
91
+ position?: readonly [number, number, number];
92
+ /** Start velocity, scene units per second. */
93
+ velocity?: readonly [number, number, number];
94
+ /** Default `size³`: bigger objects push smaller ones further. */
95
+ mass?: number;
96
+ /** Bounciness 0..1. Default the world's `bounce`. */
97
+ bounce?: number;
98
+ /** A pinch can pick it up. Default true. */
99
+ grabbable?: boolean;
100
+ /** The hands push it. Default true. */
101
+ pushable?: boolean;
102
+ /** It falls. Default true; false floats where it is put, still pushed and grabbed. */
103
+ gravity?: boolean;
104
+ };
105
+ export type TouchBody = {
106
+ readonly id: number;
107
+ shape: TouchShape;
108
+ size: number;
109
+ /** Collision radius: half the size. */
110
+ radius: number;
111
+ mass: number;
112
+ bounce: number | undefined;
113
+ grabbable: boolean;
114
+ pushable: boolean;
115
+ gravity: boolean;
116
+ position: THREE.Vector3;
117
+ velocity: THREE.Vector3;
118
+ quaternion: THREE.Quaternion;
119
+ /** Angular velocity, radians per second (world axes). */
120
+ spin: THREE.Vector3;
121
+ grabbedBy: TouchHandId | null;
122
+ hoveredBy: TouchHandId | null;
123
+ /** On the floor and nearly still. */
124
+ resting: boolean;
125
+ /** Free for the app. */
126
+ userData: Record<string, unknown>;
127
+ /** Where it hangs from the pinch while carried. */
128
+ grabOffset: THREE.Vector3;
129
+ /** This frame's hand contacts, `hand:part`. */
130
+ contacts: Set<string>;
131
+ /** When each hand's index tip started touching it (for taps; NaN: touched without a tap). */
132
+ tapStart: Partial<Record<TouchHandId, number>>;
133
+ };
134
+ export type TouchEvent = {
135
+ type: "grab";
136
+ body: TouchBody;
137
+ hand: TouchHandId;
138
+ }
139
+ /** `speed`: how fast it was thrown (0 when dropped). */
140
+ | {
141
+ type: "release";
142
+ body: TouchBody;
143
+ hand: TouchHandId;
144
+ speed: number;
145
+ } | {
146
+ type: "hoverstart";
147
+ body: TouchBody;
148
+ hand: TouchHandId;
149
+ } | {
150
+ type: "hoverend";
151
+ body: TouchBody;
152
+ hand: TouchHandId;
153
+ }
154
+ /** The index tip touched it and left within `tapMs`. */
155
+ | {
156
+ type: "tap";
157
+ body: TouchBody;
158
+ hand: TouchHandId;
159
+ }
160
+ /** A hand part started touching it; `speed` is how hard. */
161
+ | {
162
+ type: "touch";
163
+ body: TouchBody;
164
+ hand: TouchHandId;
165
+ part: HandTouchPart;
166
+ speed: number;
167
+ };
168
+ export type TouchWorldSettings = {
169
+ /** Scene units per second², down (−Y). Default 9. */
170
+ gravity: number;
171
+ /** Air drag on motion and spin, per second. Default 0.4. */
172
+ damping: number;
173
+ /** Bounciness 0..1 (objects can override). Default 0.5. */
174
+ bounce: number;
175
+ /** How fast objects stop sliding on the floor, per second. Default 4. */
176
+ friction: number;
177
+ /** A pinch grabs an object whose surface is within this many palm lengths. Default 0.35. */
178
+ grabReach: number;
179
+ /** The index tip hovers an object within this many palm lengths of its surface. Default 0.5. */
180
+ hoverReach: number;
181
+ /**
182
+ * An index-tip touch shorter than this is a tap, ms (for the pointer: a
183
+ * click on the object). Default 350.
184
+ */
185
+ tapMs: number;
186
+ /**
187
+ * A tap starts with the index tip moving into the object at least this
188
+ * fast, palm lengths per second: an object falling past a still finger
189
+ * isn't a tap. Default 1.
190
+ */
191
+ tapSpeed: number;
192
+ /** A release throws at the hand's speed times this. Default 1. */
193
+ throwScale: number;
194
+ /** Speed cap, scene units per second. Default 14. */
195
+ maxSpeed: number;
196
+ /** Hand-to-object contacts ignore depth (one camera can't measure it). Default true. */
197
+ flat: boolean;
198
+ };
199
+ export declare const TOUCH_WORLD_DEFAULTS: Readonly<TouchWorldSettings>;
200
+ /**
201
+ * The world the hands play in: objects, the box they stay in (`bounds`, the
202
+ * floor is `bounds.min.y`), and the rules. Call `step` every frame with the
203
+ * hands; it returns what happened (grabs, releases, hovers, taps, touches).
204
+ */
205
+ export declare class TouchWorld {
206
+ readonly bodies: TouchBody[];
207
+ readonly bounds: THREE.Box3;
208
+ settings: TouchWorldSettings;
209
+ /** Simulated time, ms. */
210
+ timeMs: number;
211
+ private nextId;
212
+ private pinched;
213
+ /** What the pointer pressed on, and when (a quick click is a tap). */
214
+ private press;
215
+ private handSettings;
216
+ constructor(settings?: Partial<TouchWorldSettings>, handSettings?: Partial<HandTouchSettings>);
217
+ /** The hand collider settings `pinchReady` is read from. */
218
+ setHandSettings(handSettings: Partial<HandTouchSettings>): void;
219
+ add(options?: TouchBodyOptions): TouchBody;
220
+ remove(body: TouchBody): void;
221
+ /** The nearest grabbable (`any`: any) object whose surface is within `reach` of `point`. */
222
+ pick(point: THREE.Vector3, reach: number, any?: boolean): TouchBody | null;
223
+ /** Advances `dt` seconds with these hands; returns what happened. */
224
+ step(dt: number, hands: readonly TouchHand[]): TouchEvent[];
225
+ /** Grab / hover reach: palm lengths for a hand; the pointer reaches as far as its sphere. */
226
+ private reach;
227
+ private distance;
228
+ private release;
229
+ private grabAndRelease;
230
+ private substep;
231
+ private turn;
232
+ private walls;
233
+ /** Turns a box toward its nearest face-down orientation. */
234
+ private settleFlat;
235
+ private collideBodies;
236
+ private collideHands;
237
+ /** The pointer: a press and a quick release on the same object is a tap. */
238
+ private clickTap;
239
+ private hoverAndTap;
240
+ }
@@ -0,0 +1,33 @@
1
+ import { XRModelNodeHandTracking } from '../types/nodes';
2
+ export type HandTracking2DSettings = {
3
+ enabled: boolean;
4
+ bothHands: boolean;
5
+ visualScale: number;
6
+ opacity: number;
7
+ pointRadius: number;
8
+ lineWidth: number;
9
+ labelScale: number;
10
+ smoothing: number;
11
+ color: string;
12
+ showBoundingBox: boolean;
13
+ showLabels: boolean;
14
+ logToConsole: boolean;
15
+ };
16
+ export declare const DEFAULT_HAND_TRACKING_2D_SETTINGS: HandTracking2DSettings;
17
+ export type HandTracking2DHandedness = "left" | "right";
18
+ export type HandTracking2DHandFrame = {
19
+ handedness?: HandTracking2DHandedness;
20
+ coordinates?: HandTracking2DPoint[];
21
+ gesture?: "closed_fist" | "open_palm";
22
+ };
23
+ export declare const HAND_TRACKING_2D_BONES: Array<[number, number]>;
24
+ export type HandTracking2DPoint = {
25
+ x: number;
26
+ y: number;
27
+ };
28
+ export declare function getHandTracking2DHands(node?: XRModelNodeHandTracking | null): HandTracking2DHandFrame[];
29
+ export declare function handTrackingCoordinateToScreenPoint(point: {
30
+ x: number;
31
+ y: number;
32
+ }, width: number, height: number): HandTracking2DPoint;
33
+ export declare function smoothHandTrackingPoints(previous: HandTracking2DPoint[] | null, next: HandTracking2DPoint[], smoothing: number): HandTracking2DPoint[];
@@ -0,0 +1,65 @@
1
+ import { XRModelNodeHandTracking } from '../types/nodes';
2
+ export type HandTracking2DControllerSettings = {
3
+ enabled: boolean;
4
+ attachImageEnabled: boolean;
5
+ showBoundingBox: boolean;
6
+ verticalAlign: HandTracking2DControllerVerticalAlign;
7
+ horizontalAlign: HandTracking2DControllerHorizontalAlign;
8
+ sizeResponsiveToHandBoundingBox: boolean;
9
+ size: number;
10
+ offsetX: number;
11
+ offsetY: number;
12
+ rotation: number;
13
+ alpha: number;
14
+ smoothFollowing: boolean;
15
+ smoothing: number;
16
+ };
17
+ export declare const DEFAULT_HAND_TRACKING_2D_CONTROLLER_SETTINGS: HandTracking2DControllerSettings;
18
+ export type HandTracking2DControllerVerticalAlign = "top" | "middle" | "bottom";
19
+ export type HandTracking2DControllerHorizontalAlign = "left" | "center" | "right";
20
+ export declare const HAND_TRACKING_2D_CONTROLLER_VERTICAL_ALIGN_OPTIONS: Array<{
21
+ label: string;
22
+ value: HandTracking2DControllerVerticalAlign;
23
+ }>;
24
+ export declare const HAND_TRACKING_2D_CONTROLLER_HORIZONTAL_ALIGN_OPTIONS: Array<{
25
+ label: string;
26
+ value: HandTracking2DControllerHorizontalAlign;
27
+ }>;
28
+ export type HandTracking2DControllerHandedness = "left" | "right";
29
+ export type HandTracking2DControllerHandFrame = {
30
+ handedness?: HandTracking2DControllerHandedness;
31
+ coordinates?: Array<{
32
+ x: number;
33
+ y: number;
34
+ z: number;
35
+ }>;
36
+ };
37
+ export type HandTracking2DControllerRenderFrame = {
38
+ key: string;
39
+ handedness?: HandTracking2DControllerHandedness;
40
+ position: [number, number];
41
+ size: [number, number];
42
+ boundingBox: {
43
+ position: [number, number];
44
+ size: [number, number];
45
+ };
46
+ rotation: number;
47
+ };
48
+ export declare const handTracking2DControllerToScreenPoint: (point: {
49
+ x: number;
50
+ y: number;
51
+ }) => {
52
+ x: number;
53
+ y: number;
54
+ };
55
+ export declare function getHandTracking2DControllerHands(node?: XRModelNodeHandTracking | null): HandTracking2DControllerHandFrame[];
56
+ export declare function smoothHandTracking2DControllerValue(previous: number | null, next: number, smoothing: number): number;
57
+ export declare function getHandTracking2DControllerAttachOffset(verticalAlign: HandTracking2DControllerVerticalAlign, horizontalAlign: HandTracking2DControllerHorizontalAlign, width: number, height: number): [number, number];
58
+ export declare function getHandTracking2DControllerBoundingBoxSize(points: Array<{
59
+ x: number;
60
+ y: number;
61
+ }>): {
62
+ width: number;
63
+ height: number;
64
+ };
65
+ export declare function computeHandTracking2DControllerFrame(hand: HandTracking2DControllerHandFrame, settings: HandTracking2DControllerSettings, key: string): HandTracking2DControllerRenderFrame | null;