@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,68 @@
1
+ import { ReactNode, RefObject } from 'react';
2
+ import { FacePinAnchor, FacePinOrient, FacePinSurface } from '../../face-character/facePin';
3
+ import { FaceRigProps } from './FaceRig';
4
+ import * as THREE from "three";
5
+ /** Rig props a pin forwards when it runs its own rig (the pose smoothing stays the rig default). */
6
+ type PinRigProps = Omit<FaceRigProps, "children" | "smoothing">;
7
+ export type PinToFaceMeshProps = PinRigProps & {
8
+ /**
9
+ * Where on the face: a face target name (`"face.noseTip"`, `"face.leftCheek"`
10
+ * …; left / right = the person's own side on every feed), `{ landmark }`,
11
+ * `{ point }` (canonical cm) or `{ triangle, weights }`. See `FacePinAnchor`.
12
+ */
13
+ anchor: FacePinAnchor;
14
+ /**
15
+ * Whether the feed is mirrored. Defaults to the session's (`useXRMirrored`:
16
+ * the front webcam is), which is what keeps a named `"face.left…"` anchor
17
+ * on the person's own left.
18
+ */
19
+ mirrored?: boolean;
20
+ /** Follow the person's real face (`"face"`, default) or the canonical / character face (`"model"`). */
21
+ surface?: FacePinSurface;
22
+ /** `"surface"` (default): turn with the skin under it; `"head"`: keep the head's orientation. */
23
+ orient?: FacePinOrient;
24
+ /**
25
+ * An offset in the pin's frame (X along the face toward the screen's right
26
+ * on a face looking at the camera, Y up, Z out of the skin): `position` in
27
+ * centimetres, `rotation` in degrees, `scale` a factor.
28
+ */
29
+ offset?: {
30
+ position?: readonly [number, number, number];
31
+ rotation?: readonly [number, number, number];
32
+ scale?: number;
33
+ };
34
+ /**
35
+ * Per-frame EMA on the pin's position and turn, `1` = none (default: the
36
+ * rig's expression smoothing already steadies the surface).
37
+ */
38
+ smoothing?: number;
39
+ /**
40
+ * A face model to sit on (an `ExternalFaceMesh`'s group, in the same rig):
41
+ * once it has loaded, the pin moves along the surface normal onto that
42
+ * model's own skin — a character whose cheek or lip is not exactly the
43
+ * canonical surface — then rides the expression from there.
44
+ */
45
+ onto?: RefObject<THREE.Object3D | null> | THREE.Object3D | null;
46
+ /** The pinned content, authored in centimetres around its origin. */
47
+ children?: ReactNode;
48
+ };
49
+ /**
50
+ * Pins content to a point on the live face surface: it follows the head AND
51
+ * the skin under it through expressions (a cheek sticker rides a smile, a
52
+ * lip stud follows the mouth), turning with the surface. Anchor by face target
53
+ * name, landmark index, canonical point or exact triangle; offset in the pin's
54
+ * own frame. Unlike the generic `PinToMesh`, the surface it follows moves every
55
+ * frame. Inside a `FaceRig` (or an `ExternalFaceMesh`'s children) it shares
56
+ * that rig; otherwise it runs its own (mount it in a `FaceTracker`). Hidden
57
+ * while the face is lost; snaps on reacquire.
58
+ *
59
+ * ```tsx
60
+ * <FaceTracker>
61
+ * <PinToFaceMesh anchor="face.leftCheek" offset={{ position: [0, 0, 0.1] }}>
62
+ * <mesh><circleGeometry args={[1.2, 32]} /></mesh>
63
+ * </PinToFaceMesh>
64
+ * </FaceTracker>
65
+ * ```
66
+ */
67
+ export declare const PinToFaceMesh: ({ faceIndex, expressionSmoothing, holdMs, neutral, neutralMs, leadMs, neutralKey, onTrackingChange, ...props }: PinToFaceMeshProps) => import("react/jsx-runtime").JSX.Element;
68
+ export {};
@@ -0,0 +1,18 @@
1
+ export { FaceRig, FaceRigContext, useFaceRig } from './FaceRig';
2
+ export type { FaceRigProps } from './FaceRig';
3
+ export { ExternalFaceMesh, ExternalFaceMeshContext, FACE_HEAD_WIDTH_RATIO, faceHeadWidth, useExternalFaceMesh, } from './ExternalFaceMesh';
4
+ export type { ExternalFaceMeshBinding, ExternalFaceMeshPart, ExternalFaceMeshProps, } from './ExternalFaceMesh';
5
+ export { FaceExpressionController, useExpressionValues } from './FaceExpressionController';
6
+ export type { FaceExpressionControllerProps, FaceExpressionControllerRule, ExpressionOutputs, UseExpressionValuesResult, } from './FaceExpressionController';
7
+ export { PinToFaceMesh } from './PinToFaceMesh';
8
+ export type { PinToFaceMeshProps } from './PinToFaceMesh';
9
+ export { FacePiercing } from './FacePiercing';
10
+ export type { FacePiercingProps } from './FacePiercing';
11
+ export { FaceSurfaceOccluder } from './FaceSurfaceOccluder';
12
+ export type { FaceSurfaceOccluderProps } from './FaceSurfaceOccluder';
13
+ export { FaceReprojection } from './FaceReprojection';
14
+ export type { FaceReprojectionProps } from './FaceReprojection';
15
+ export { FaceMorph } from './FaceMorph';
16
+ export type { FaceMorphProps } from './FaceMorph';
17
+ export { FACE_SURFACE_FRAME_PRIORITY, FACE_SURFACE_RENDER_ORDER, FaceSurfaceContext, faceSurfaceBlending, createFaceSurfaceState, markFaceSurface, useFaceSurface, } from './FaceSurface';
18
+ export type { FaceSurfaceState } from './FaceSurface';
@@ -0,0 +1,10 @@
1
+ import { FaceReprojector, FaceReprojectorOptions } from '../../face-character/faceReprojector';
2
+ /**
3
+ * A `FaceReprojector` for this component's lifetime (created after mount,
4
+ * disposed on unmount), kept in step with `options` (sizes, padding, facing;
5
+ * `null` until created). Rendered every new camera frame of the nearest
6
+ * `FaceRig`'s face (at most `fps` a second, `0` = every frame) while that
7
+ * face is tracked; through a dropout the textures keep the last face.
8
+ * Inside a `<MadeUpCamera>` it unwraps the made-up camera (the makeup shows).
9
+ */
10
+ export declare const useFaceReprojector: (options: Pick<FaceReprojectorOptions, "resolution" | "unwrapResolution" | "padding" | "facing" | "unwrapMipmaps">, fps: number) => FaceReprojector | null;
@@ -0,0 +1,68 @@
1
+ import { FaceTarget } from '../../types/tracking';
2
+ import { FaceInsetPart } from './frame';
3
+ /**
4
+ * An inset's draw order on the face: after the face itself (`FaceWarp3D`,
5
+ * `FaceMorph`, a character, at `FACE_SURFACE_RENDER_ORDER`), so it shows on
6
+ * top of them, and before the head occluder (-1).
7
+ */
8
+ export declare const FACE_INSET_RENDER_ORDER: number;
9
+ /** Where an inset is shown: over the face, or as a plane in its parent's frame. */
10
+ export declare const FACE_INSET_PLACEMENTS: readonly ["face", "plane"];
11
+ export type FaceInsetPlacement = (typeof FACE_INSET_PLACEMENTS)[number];
12
+ export type FaceInsetProps = {
13
+ /** Which part to cut (see `FACE_INSET_PARTS`). */
14
+ part: FaceInsetPart;
15
+ /**
16
+ * `"face"` (default): over the live face, at the part's own place (or `at`),
17
+ * `magnify` times bigger. `"plane"`: a plane in its parent's frame (on an
18
+ * object, beside the head, anywhere in the scene), `height` units tall.
19
+ */
20
+ placement?: FaceInsetPlacement;
21
+ /**
22
+ * `"face"` only: how much bigger than life, about the part's own middle.
23
+ * 1 = life size, below 1 shrinks it. Default 1.5.
24
+ */
25
+ magnify?: number;
26
+ /**
27
+ * `"plane"` only: the plane's height in local units; its width follows the
28
+ * part's shape (`faceInsetAspect`). Default 1.
29
+ */
30
+ height?: number;
31
+ /**
32
+ * `"face"` only: show it centred on another face point instead of its own
33
+ * place (`"face.forehead"`, `"face.chin"`, …). With `at`, `"eyes"` is one
34
+ * strip, both eyes together.
35
+ */
36
+ at?: Exclude<FaceTarget, "face.custom">;
37
+ /** Soft edge, 0 (hard) .. 1 (fades from the middle). Default 0.4. */
38
+ feather?: number;
39
+ /** How much around the part is cut, a multiple of its box (`FACE_INSET_BOXES`). Default 1. */
40
+ size?: number;
41
+ /** 0..1. Default 1. */
42
+ opacity?: number;
43
+ /** Which tracked face. Default: the enclosing `FaceTracker`'s, else 0. */
44
+ faceIndex?: number;
45
+ /** `"plane"` only: the texture's longer side, px. Default 256. */
46
+ resolution?: number;
47
+ /** Draw order. Default `FACE_INSET_RENDER_ORDER` (-1.5) on the face, 0 as a plane. */
48
+ renderOrder?: number;
49
+ };
50
+ /**
51
+ * Face inset (Lens Studio's Face Inset): a face part cut out of the live
52
+ * camera image with a soft edge, following the face every frame. Over the
53
+ * face it magnifies the part in place (big cartoon eyes, a giant mouth, a big
54
+ * or tiny face) or shows it on another face point (`at`); as a `"plane"` it
55
+ * is a card in the scene (on a product, beside the head). For your own
56
+ * material or a `ScreenImage`, use `useFaceInsetTexture`. Follows the
57
+ * enclosing `FaceTracker`'s face; needs a `FaceTracker` mounted (it starts no
58
+ * tracker). Inside a `<MadeUpCamera>` it cuts the part from the made-up
59
+ * camera, so the makeup shows in it.
60
+ *
61
+ * ```tsx
62
+ * <FaceTracker>
63
+ * <FaceInset part="eyes" magnify={1.8} />
64
+ * <FaceInset part="mouth" at="face.forehead" magnify={0.8} />
65
+ * </FaceTracker>
66
+ * ```
67
+ */
68
+ export declare const FaceInset: ({ part, placement, magnify, height, at, feather, size, opacity, faceIndex, resolution, renderOrder, }: FaceInsetProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,94 @@
1
+ import { FaceImageLandmark } from '../../face-character/faceReprojection';
2
+ /**
3
+ * Face inset geometry (pure): where a face part is cut from the camera image.
4
+ * Each part has a box on the camera image, upright in the face's own frame
5
+ * (it turns with the head's roll), sized from the face (the 3D distance
6
+ * between the eyes, so it holds still while the mouth opens or the head
7
+ * turns), and a soft elliptical mask inside it.
8
+ */
9
+ /** The face parts an inset can cut. */
10
+ export declare const FACE_INSET_PARTS: readonly ["leftEye", "rightEye", "eyes", "mouth", "nose", "face"];
11
+ export type FaceInsetPart = (typeof FACE_INSET_PARTS)[number];
12
+ /**
13
+ * Each part's box, in eye distances (the 3D distance between the eye
14
+ * centres), before `size`. Measured on the canonical face: an eye is 0.4 wide,
15
+ * the mouth 0.76, the face 2.4 wide and 2.7 tall.
16
+ */
17
+ export declare const FACE_INSET_BOXES: Readonly<Record<FaceInsetPart, {
18
+ width: number;
19
+ height: number;
20
+ }>>;
21
+ /** A part's box width over its height (pixels): the inset texture's shape. */
22
+ export declare const faceInsetAspect: (part: FaceInsetPart) => number;
23
+ /**
24
+ * An eye fades out as the head turns away from it (its far side smears over
25
+ * the nose): hidden when it is this narrow next to the other eye, fully shown
26
+ * from this wide.
27
+ */
28
+ export declare const FACE_INSET_FAR_EYE: readonly [number, number];
29
+ /** One mask ellipse in box space (−1..1 across the box, y down the face). */
30
+ export type FaceInsetEllipse = {
31
+ x: number;
32
+ y: number;
33
+ rx: number;
34
+ ry: number;
35
+ alpha: number;
36
+ };
37
+ export type FaceInsetFrame = {
38
+ /** The box's centre on the camera image (0..1, top-left origin, y down). */
39
+ center: {
40
+ x: number;
41
+ y: number;
42
+ };
43
+ /**
44
+ * Half the box along the face's x (to the image right on an upright face)
45
+ * and y (down the face), as offsets on the camera image (0..1 per axis).
46
+ */
47
+ axisX: {
48
+ x: number;
49
+ y: number;
50
+ };
51
+ axisY: {
52
+ x: number;
53
+ y: number;
54
+ };
55
+ /** The face's scale: the 3D distance between the eye centres, in image heights. */
56
+ unit: number;
57
+ /** The mask: one ellipse, or two for `"eyes"` (`count`). `alpha` fades an eye turning away. */
58
+ ellipses: [FaceInsetEllipse, FaceInsetEllipse];
59
+ count: 1 | 2;
60
+ };
61
+ export declare const createFaceInsetFrame: () => FaceInsetFrame;
62
+ /** How much of an eye shows, 0..1, from its width next to the wider eye. */
63
+ export declare const faceInsetEyeVisibility: (width: number, widest: number) => number;
64
+ export type FaceInsetFrameOptions = {
65
+ /** How much around the part is cut: a multiple of its box (`FACE_INSET_BOXES`). Default 1. */
66
+ size?: number;
67
+ /**
68
+ * The feed is mirrored (the front webcam; `useXRMirrored()`, or the face's
69
+ * `mirrored`). `"leftEye"` / `"rightEye"` are the person's own eyes, so they
70
+ * read the other mesh eye on a mirrored feed. Default `false`.
71
+ */
72
+ mirrored?: boolean;
73
+ };
74
+ /**
75
+ * One frame of a part's inset: writes its box on the camera image and its
76
+ * mask into `out`. `landmarks` are the tracker's for one face (≥ 468, the
77
+ * camera image's own space, as `FaceInfo.landmarks`); `aspect` is the camera
78
+ * image's width / height. The box stays upright on the face whichever way the
79
+ * mesh labels its sides (a mirrored webcam included); `"leftEye"` is the
80
+ * person's own left eye when `mirrored` says how the feed is drawn. Returns
81
+ * `false` (and leaves `out`) without a usable face.
82
+ */
83
+ export declare const writeFaceInsetFrame: (landmarks: ArrayLike<FaceImageLandmark> | null | undefined, personPart: FaceInsetPart, aspect: number, { size, mirrored }: FaceInsetFrameOptions, out: FaceInsetFrame) => boolean;
84
+ /**
85
+ * Where a box point lands on the image: `(qx, qy)` in box space (−1..1, y
86
+ * down the face) → camera image (0..1, y down). Mirrors the shader.
87
+ */
88
+ export declare const faceInsetPoint: (frame: FaceInsetFrame, qx: number, qy: number, out?: {
89
+ x: number;
90
+ y: number;
91
+ }) => {
92
+ x: number;
93
+ y: number;
94
+ };
@@ -0,0 +1,6 @@
1
+ export { FACE_INSET_PLACEMENTS, FACE_INSET_RENDER_ORDER, FaceInset } from './FaceInset';
2
+ export type { FaceInsetPlacement, FaceInsetProps } from './FaceInset';
3
+ export { FACE_INSET_HOLD_MS, useFaceInsetTexture } from './useFaceInsetTexture';
4
+ export type { FaceInsetTextureOptions } from './useFaceInsetTexture';
5
+ export { FACE_INSET_BOXES, FACE_INSET_PARTS, createFaceInsetFrame, faceInsetAspect, writeFaceInsetFrame, } from './frame';
6
+ export type { FaceInsetEllipse, FaceInsetFrame, FaceInsetFrameOptions, FaceInsetPart, } from './frame';
@@ -0,0 +1,40 @@
1
+ import { FaceInsetFrame } from './frame';
2
+ import * as THREE from "three";
3
+ export type FaceInsetUniforms = {
4
+ insetCamera: THREE.IUniform<THREE.Texture | null>;
5
+ insetCenter: THREE.IUniform<THREE.Vector2>;
6
+ insetAxisX: THREE.IUniform<THREE.Vector2>;
7
+ insetAxisY: THREE.IUniform<THREE.Vector2>;
8
+ insetDraw: THREE.IUniform<THREE.Vector2>;
9
+ insetMagnify: THREE.IUniform<number>;
10
+ insetEllipses: THREE.IUniform<THREE.Vector4[]>;
11
+ insetEllipseAlpha: THREE.IUniform<THREE.Vector2>;
12
+ insetFeather: THREE.IUniform<number>;
13
+ insetOpacity: THREE.IUniform<number>;
14
+ };
15
+ export type FaceInsetMaterial = THREE.ShaderMaterial & {
16
+ uniforms: FaceInsetUniforms;
17
+ };
18
+ /**
19
+ * The inset material. `"face"`: drawn over the face (the opaque pass with soft
20
+ * edges, like `FaceWarp3D`; the mesh's render order is
21
+ * `FACE_INSET_RENDER_ORDER`). `"fill"`: fills a render target with the box,
22
+ * straight (not premultiplied) alpha.
23
+ */
24
+ export declare const createFaceInsetMaterial: (mode: "face" | "fill") => FaceInsetMaterial;
25
+ /** How an inset is drawn (one object per inset, written every frame). */
26
+ export type FaceInsetLook = {
27
+ camera: THREE.Texture | null;
28
+ feather: number;
29
+ opacity: number;
30
+ /** Where its middle is drawn on the image; `null`: the part's own. */
31
+ draw: {
32
+ x: number;
33
+ y: number;
34
+ } | null;
35
+ /** How much bigger than life it is drawn about `draw`. */
36
+ magnify: number;
37
+ };
38
+ export declare const createFaceInsetLook: () => FaceInsetLook;
39
+ /** Writes a frame and the look into an inset material's uniforms. */
40
+ export declare const updateFaceInsetUniforms: (uniforms: FaceInsetUniforms, frame: FaceInsetFrame, look: FaceInsetLook) => void;
@@ -0,0 +1,37 @@
1
+ import { FaceInsetPart } from './frame';
2
+ import * as THREE from "three";
3
+ export type FaceInsetTextureOptions = {
4
+ /** Which part to cut (see `FACE_INSET_PARTS`). */
5
+ part: FaceInsetPart;
6
+ /** Soft edge, 0 (hard) .. 1 (fades from the middle). Default 0.4. */
7
+ feather?: number;
8
+ /** How much around the part is cut, a multiple of its box. Default 1. */
9
+ size?: number;
10
+ /** The texture's longer side, px. Its shape is the part's box (`faceInsetAspect`). Default 256. */
11
+ resolution?: number;
12
+ /** Which tracked face. Default: the enclosing `FaceTracker`'s, else 0. */
13
+ faceIndex?: number;
14
+ /** `false` stops updating (the texture keeps its last image). Default `true`. */
15
+ active?: boolean;
16
+ };
17
+ /** After the face is lost for this long (ms), the inset texture is cleared to transparent. */
18
+ export declare const FACE_INSET_HOLD_MS = 250;
19
+ /** The face a face inset follows: its own `faceIndex`, else the enclosing `FaceTracker`'s, else 0. */
20
+ export declare const useFaceInsetFaceIndex: (faceIndex?: number) => number;
21
+ /** The camera image's width / height (the canvas's, before the first camera frame). */
22
+ export declare const cameraImageAspect: (texture: THREE.Texture | null | undefined, canvas: {
23
+ width: number;
24
+ height: number;
25
+ }) => number;
26
+ /**
27
+ * A face part cut from the live camera image, as a texture: the part's box
28
+ * (upright on the face), soft-edged, straight (not premultiplied) alpha, sRGB.
29
+ * Put it on any material (`map`, `transparent`) or in a `ScreenImage`
30
+ * (`source={{ kind: "texture", texture }}`). It updates on every new camera
31
+ * frame while the face is tracked, keeps its last image through a short
32
+ * dropout and is cleared to transparent after `FACE_INSET_HOLD_MS`. A new
33
+ * part or resolution makes a new texture. Reads the face model: a
34
+ * `FaceTracker` must be mounted (it starts none). Inside a `<MadeUpCamera>`
35
+ * it cuts the part from the made-up camera (the makeup shows).
36
+ */
37
+ export declare const useFaceInsetTexture: ({ part, feather, size, resolution, faceIndex: faceIndexOption, active, }: FaceInsetTextureOptions) => THREE.Texture;
@@ -0,0 +1,43 @@
1
+ import { FaceExpressionDefinition, FaceExpressionHintPose, FaceExpressionName } from '../../face-expression';
2
+ import { HintLook } from '../Instruction/hintLook';
3
+ import { HintLoop } from '../Instruction/hintLoop';
4
+ import * as THREE from "three";
5
+ export type FaceExpressionHintProps = {
6
+ /**
7
+ * An expression name, your own definition (`defineFaceExpression`), or just
8
+ * its hint: `{ target }` (one morph target) or `{ targets }` (a weighted mix).
9
+ */
10
+ expression: FaceExpressionName | FaceExpressionDefinition | FaceExpressionHintPose;
11
+ /**
12
+ * The hint face: a model whose meshes carry one morph target per expression
13
+ * (e.g. the SDK example `face-v1.glb`'s scene, loaded with the meshopt
14
+ * decoder), facing +Z.
15
+ */
16
+ model: THREE.Object3D;
17
+ /** Height of the face in the parent's units (the hint is fitted to it). Default `1`. */
18
+ height?: number;
19
+ /** Loop timing, merged over `FACE_HINT_LOOP` (2.4 s per cycle). */
20
+ loop?: HintLoop;
21
+ /** The look, merged over `FACE_HINT_LOOK` (ghost, feature tints, halo, glow). */
22
+ look?: HintLook;
23
+ /** Auto orbit: degrees to each side about the vertical (ping-pong). `0` = still. Default `30`. */
24
+ orbit?: number;
25
+ /** Seconds per orbit swing (side to side and back). Default `6`. */
26
+ orbitSeconds?: number;
27
+ /** Render order of the face (keep it above the AR content it may overlap). */
28
+ renderOrder?: number;
29
+ };
30
+ /**
31
+ * The face's default look: plain ghost, tinted per part by `face-v1`'s
32
+ * material names so the eyes, brows, lashes and mouth stay readable.
33
+ */
34
+ export declare const FACE_HINT_LOOK: HintLook;
35
+ /** The face's default loop. */
36
+ export declare const FACE_HINT_LOOP: HintLoop;
37
+ /**
38
+ * A 3D face showing an expression — the face instruction's demonstration.
39
+ * Plays the expression's morph target(s) from the idle face and back, slowly
40
+ * orbiting side to side. Drawn as a ghost (`look`). Place it where the hint
41
+ * should appear (e.g. inside `ScreenSpaceUI`); `FaceInstruction` does this.
42
+ */
43
+ export declare const FaceExpressionHint: ({ expression, model, height, loop, look, orbit, orbitSeconds, renderOrder, }: FaceExpressionHintProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,56 @@
1
+ import { FaceExpressionDefinition, FaceExpressionName } from '../../face-expression';
2
+ import { HintLook } from '../Instruction/hintLook';
3
+ import { HintLoop } from '../Instruction/hintLoop';
4
+ import { InstructionOptions } from '../Instruction/InstructionCue';
5
+ import type * as THREE from "three";
6
+ export { FACE_HINT_LOOK, FACE_HINT_LOOP, FaceExpressionHint } from './FaceExpressionHint';
7
+ export type { FaceExpressionHintProps } from './FaceExpressionHint';
8
+ export { useFaceExpression } from './useFaceExpression';
9
+ export type { UseFaceExpressionOptions, UseFaceExpressionResult } from './useFaceExpression';
10
+ /** The instruction draws in this renderOrder band, over the AR scene (= `INSTRUCTION_RENDER_ORDER`). */
11
+ export declare const FACE_INSTRUCTION_RENDER_ORDER = 2000;
12
+ /** Default nudge copy when no face has been seen for `nudgeAfterMs`. */
13
+ export declare const FACE_INSTRUCTION_NUDGE_TEXT = "Show your face to the camera";
14
+ export type FaceInstructionProps = InstructionOptions & {
15
+ /** What to ask for: a `FACE_EXPRESSIONS` name or your own `defineFaceExpression(…)`. */
16
+ expression: FaceExpressionName | FaceExpressionDefinition;
17
+ /**
18
+ * The hint face: one morph target per expression (e.g. `face-v1.glb`'s
19
+ * scene, loaded with the meshopt decoder); see `FaceExpressionHint`.
20
+ */
21
+ model: THREE.Object3D;
22
+ /** Instruction copy. Default: the expression's `label` ("Give a big smile"). */
23
+ text?: string;
24
+ /** Which detected face to read. Default 0. */
25
+ faceIndex?: number;
26
+ /** Hold time to complete. Default 400 ms. */
27
+ holdMs?: number;
28
+ /** Dropouts shorter than this do not restart the hold. Default 150 ms. */
29
+ graceMs?: number;
30
+ /** The hint's auto orbit, degrees to each side. Default `30`; `0` = still. */
31
+ orbit?: number;
32
+ /** The hint's look, merged over `FACE_HINT_LOOK`. */
33
+ look?: HintLook;
34
+ /** The hint's loop, merged over `FACE_HINT_LOOP`. */
35
+ loop?: HintLoop;
36
+ /** Called once when the expression is held long enough. */
37
+ onComplete?: () => void;
38
+ /** `false` hides it and pauses detection. Default `true`. */
39
+ active?: boolean;
40
+ };
41
+ /**
42
+ * A minimal on-screen instruction that asks for a face expression and waits
43
+ * for it: a looping ghost face (`FaceExpressionHint`) making the expression,
44
+ * with the copy under it — the same layout and feedback as `HandInstruction`.
45
+ * Holding the expression for `holdMs` completes it (`onComplete`, a small pop
46
+ * and a white ring, then it fades out); with no face in view for a while it
47
+ * adds a nudge line. Mount inside the R3F scene (`XRScene`); it acquires the
48
+ * face model itself. Every part is customisable (`look`, `loop`, `textStyle`,
49
+ * `motion`, `renderText` …); for a fully custom one, compose `<Instruction>`
50
+ * with `useFaceExpression` and any symbol.
51
+ *
52
+ * ```tsx
53
+ * <FaceInstruction expression="smile" text="Smile to start" model={faceGltf.scene} onComplete={start} />
54
+ * ```
55
+ */
56
+ export declare const FaceInstruction: ({ active, text, ...props }: FaceInstructionProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,20 @@
1
+ import { MutableRefObject } from 'react';
2
+ import { FaceExpressionSpec } from '../../face-expression';
3
+ import { FaceInfo } from '../../face-info';
4
+ import { InstructionDetector, InstructionHoldOptions } from '../Instruction/useInstructionHold';
5
+ export type UseFaceExpressionOptions = InstructionHoldOptions & {
6
+ /** Which detected face to read (result-array position). Default 0. */
7
+ faceIndex?: number;
8
+ };
9
+ export type UseFaceExpressionResult = InstructionDetector & {
10
+ /** The latest face (`null` while none is in view) — read it in `useFrame`. */
11
+ faceRef: MutableRefObject<FaceInfo | null>;
12
+ };
13
+ /**
14
+ * Detects a face expression with hold-to-complete: a `FACE_EXPRESSIONS` name,
15
+ * a rule over MediaPipe blendshapes, a match function `(blendshapes, face) =>
16
+ * boolean` or a definition (`defineFaceExpression`). Returns an
17
+ * `InstructionDetector` (pass it to `<Instruction detector>`). Mount inside
18
+ * the R3F scene; it acquires the face model itself.
19
+ */
20
+ export declare const useFaceExpression: (expression: FaceExpressionSpec, { faceIndex, active, ...hold }?: UseFaceExpressionOptions) => UseFaceExpressionResult;
@@ -0,0 +1,49 @@
1
+ import { LiveValue } from '../../face-character/liveValue';
2
+ import { FaceLiquifyCustomWarps, FaceLiquifyWeights } from './presets';
3
+ export { FACE_LIQUIFY_RENDER_ORDER } from './pass';
4
+ /** Its `useFrame` priority: before XRScene's capture (−100), so both use the same warps. */
5
+ export declare const FACE_LIQUIFY_FRAME_PRIORITY = -101;
6
+ /** Faces it warps at most (one screen pass each). */
7
+ export declare const FACE_LIQUIFY_MAX_FACES = 4;
8
+ /** Landmark smoothing by default (as face swap's): steady at rest, little lag while moving. */
9
+ export declare const FACE_LIQUIFY_DEFAULT_SMOOTHING = 0.35;
10
+ export type FaceLiquifyProps = {
11
+ /**
12
+ * Preset (and custom warp) weights by name, 0..3 (1 subtle, 3 cartoon, the
13
+ * most before the image folds), or a ref read every frame. Default `{}`:
14
+ * nothing drawn.
15
+ */
16
+ weights?: LiveValue<FaceLiquifyWeights>;
17
+ /** Your own warps by name; their weight is `weights[name]`, else 3. Re-resolved when the object changes. */
18
+ warps?: FaceLiquifyCustomWarps;
19
+ /** Overall fade, 0..1 (linear in every warp's strength), or a ref read every frame. Default 1. */
20
+ weight?: LiveValue<number>;
21
+ /**
22
+ * Only this face. Default: the enclosing `FaceTracker`'s face, else every
23
+ * tracked face (up to `FACE_LIQUIFY_MAX_FACES`).
24
+ */
25
+ faceIndex?: number;
26
+ /** Faces the face model tracks when this starts it. Default 1. */
27
+ numFaces?: number;
28
+ /** Landmark smoothing, 0..1 (0 raw). Default `FACE_LIQUIFY_DEFAULT_SMOOTHING` (0.35). */
29
+ smoothing?: number;
30
+ /** False: no model, no copy, nothing drawn. Default true. */
31
+ active?: boolean;
32
+ /** The pass mesh's render order (inside a plain group). Default `FACE_LIQUIFY_RENDER_ORDER`. */
33
+ renderOrder?: number;
34
+ /**
35
+ * Draw each live warp over the image (its circle, arrows for the way the
36
+ * content moves; green bulge, orange pinch, cyan push, magenta stretch,
37
+ * yellow swirl; brighter when stronger) and the face's named points.
38
+ * Default false.
39
+ */
40
+ debug?: boolean;
41
+ };
42
+ /**
43
+ * Liquifies faces on screen (big eyes, slim face, stretch, swirl): one screen
44
+ * pass per face that warps everything drawn so far in the face box (camera,
45
+ * makeup, face effects, glasses and hats) and draws before screen UI. Each
46
+ * face fades in when found, holds through a short dropout, then fades out;
47
+ * a warp on one side fades as that side turns away.
48
+ */
49
+ export declare const FaceLiquify: ({ weights, warps, weight, faceIndex, numFaces: numFacesProp, smoothing, active, renderOrder, debug, }: FaceLiquifyProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,37 @@
1
+ import { FaceLiquifyFrame } from './frame';
2
+ import { FaceLiquifyKind } from './warp';
3
+ import * as THREE from "three";
4
+ /**
5
+ * `<FaceLiquify debug>` (internal): line segments in clip space, drawn after
6
+ * the warp, showing each live warp (its circle; arrows for the way content
7
+ * moves; colour by kind, brighter when stronger, fading with the face and
8
+ * the side) and the face's named points.
9
+ */
10
+ /** Debug colours by warp kind. */
11
+ export declare const FACE_LIQUIFY_DEBUG_COLORS: Readonly<Record<FaceLiquifyKind, string>>;
12
+ export declare class FaceLiquifyDebugLines {
13
+ readonly geometry: THREE.BufferGeometry<THREE.NormalBufferAttributes>;
14
+ readonly material: THREE.ShaderMaterial;
15
+ readonly mesh: THREE.LineSegments;
16
+ private readonly positions;
17
+ private readonly colors;
18
+ private count;
19
+ private aspect;
20
+ constructor(renderOrder: number);
21
+ /** Starts a frame's lines (`aspect`: the image's width / height). */
22
+ begin(aspect: number): void;
23
+ /** One segment between two aspect-space points. */
24
+ private line;
25
+ private vertex;
26
+ private arc;
27
+ private arrow;
28
+ /** The face's named points as small crosses. */
29
+ drawPoints(frame: FaceLiquifyFrame): void;
30
+ /** `count` warps of `ops` (as `writeFaceLiquifyOps` wrote them). */
31
+ drawOps(ops: ArrayLike<number>, count: number): void;
32
+ /** Ends the frame: draws what was added since `begin`. */
33
+ end(): void;
34
+ /** The number of vertices this frame (2 per segment). */
35
+ get vertices(): number;
36
+ dispose(): void;
37
+ }
@@ -0,0 +1,55 @@
1
+ import { FaceImageLandmark } from '../../face-character/faceReprojection';
2
+ import { FaceLiquifyPoint2 } from './warp';
3
+ /**
4
+ * A face's liquify frame (pure): where its named points are on the screen,
5
+ * the face's own axes there, and its size. Aspect space: `x` in image heights
6
+ * (`u × aspect`), `y` in image heights, down. The screen shows the feed
7
+ * exactly, so feed landmarks are screen points.
8
+ */
9
+ /** The named points a warp can sit at. Sided names are the person's own side on every feed. */
10
+ export declare const FACE_LIQUIFY_POINTS: readonly ["leftEye", "rightEye", "noseTip", "noseBridge", "mouth", "leftMouthCorner", "rightMouthCorner", "chin", "leftJaw", "rightJaw", "leftCheek", "rightCheek", "leftFaceSide", "rightFaceSide", "forehead", "faceCenter"];
11
+ export type FaceLiquifyPointName = (typeof FACE_LIQUIFY_POINTS)[number];
12
+ /**
13
+ * The canonical face's height (forehead top to chin) in eye distances: the
14
+ * up axis is that projected span over this, so both axes are one eye
15
+ * distance long on a face looking at the camera.
16
+ */
17
+ export declare const FACE_LIQUIFY_FACE_HEIGHT = 2.803;
18
+ /**
19
+ * A side turning away fades its warps (its far half smears over the nose):
20
+ * gone when its eye is this narrow next to the other eye, full from this wide.
21
+ */
22
+ export declare const FACE_LIQUIFY_FAR_SIDE: readonly [number, number];
23
+ /** The person's own sides. */
24
+ export type FaceLiquifySide = "left" | "right";
25
+ export type FaceLiquifyFrame = {
26
+ /** The image's width / height. */
27
+ aspect: number;
28
+ /** The feed is mirrored (the webcam): which mesh side is the person's left. */
29
+ mirrored: boolean;
30
+ /** 0..1 per person's side: 1 facing the camera, 0 turned away (`FACE_LIQUIFY_FAR_SIDE`). */
31
+ visibility: Record<FaceLiquifySide, number>;
32
+ /** The face's size: the 3D distance between the eye centres, in image heights (0: no face). */
33
+ unit: number;
34
+ /** One eye distance toward the person's own left, on screen (foreshortened as the head turns). */
35
+ axisX: FaceLiquifyPoint2;
36
+ /** One eye distance up the face, on screen (foreshortened as the head nods). */
37
+ axisY: FaceLiquifyPoint2;
38
+ /** The named points on screen. */
39
+ points: Record<FaceLiquifyPointName, FaceLiquifyPoint2>;
40
+ /** The landmarks of the last write (for warps at a raw `landmark`), or null. */
41
+ landmarks: ArrayLike<FaceImageLandmark> | null;
42
+ };
43
+ export declare const createFaceLiquifyFrame: () => FaceLiquifyFrame;
44
+ /** How much of a side shows, 0..1, from its eye's width next to the wider eye. */
45
+ export declare const faceLiquifySideVisibility: (width: number, widest: number) => number;
46
+ /**
47
+ * One frame of a face: writes its points, axes and size into `out`.
48
+ * `landmarks` are the tracker's for one face (≥ 468, feed space: 0..1, y
49
+ * down, `z` in x units); `aspect` is the image's width / height; `mirrored`
50
+ * is the feed's mirroring (`useXRMirrored()`), so "left" is the person's own
51
+ * left. Returns false (and leaves `out`) without a usable face.
52
+ */
53
+ export declare const writeFaceLiquifyFrame: (landmarks: ArrayLike<FaceImageLandmark> | null | undefined, aspect: number, mirrored: boolean, out: FaceLiquifyFrame) => boolean;
54
+ /** A raw landmark's point on screen (aspect space), or false when the frame has none. */
55
+ export declare const faceLiquifyLandmarkPoint: (frame: FaceLiquifyFrame, index: number, out: FaceLiquifyPoint2) => boolean;
@@ -0,0 +1,10 @@
1
+ export { FACE_LIQUIFY_DEFAULT_SMOOTHING, FACE_LIQUIFY_FRAME_PRIORITY, FACE_LIQUIFY_MAX_FACES, FACE_LIQUIFY_RENDER_ORDER, FaceLiquify, } from './FaceLiquify';
2
+ export { FACE_LIQUIFY_FADE, createFaceLiquifyPresence, resetFaceLiquifyPresence, stepFaceLiquifyPresence, } from './presence';
3
+ export type { FaceLiquifyPresence } from './presence';
4
+ export type { FaceLiquifyProps } from './FaceLiquify';
5
+ export { FACE_LIQUIFY_KINDS, FACE_LIQUIFY_KIND_CODE, FACE_LIQUIFY_KIND_LIMITS, FACE_LIQUIFY_MAX_OPS, FACE_LIQUIFY_MAX_WEIGHT, FACE_LIQUIFY_OP_FLOATS, FACE_LIQUIFY_WEIGHT_EXPONENT, applyFaceLiquifyOp, faceLiquifyAmount, faceLiquifyBounds, faceLiquifyFalloff, sampleFaceLiquify, } from './warp';
6
+ export type { FaceLiquifyBounds, FaceLiquifyKind, FaceLiquifyPoint2 } from './warp';
7
+ export { FACE_LIQUIFY_FACE_HEIGHT, FACE_LIQUIFY_FAR_SIDE, FACE_LIQUIFY_POINTS, createFaceLiquifyFrame, faceLiquifyLandmarkPoint, faceLiquifySideVisibility, writeFaceLiquifyFrame, } from './frame';
8
+ export type { FaceLiquifyFrame, FaceLiquifyPointName, FaceLiquifySide } from './frame';
9
+ export { FACE_LIQUIFY_PRESETS, FACE_LIQUIFY_PRESET_NAMES, faceLiquifyWarpSide, resolveFaceLiquifyWarps, writeFaceLiquifyOps, } from './presets';
10
+ export type { FaceLiquifyCustomWarps, FaceLiquifyPresetName, FaceLiquifyResolution, FaceLiquifyResolvedWarp, FaceLiquifyWarp, FaceLiquifyWeights, } from './presets';