@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
@@ -1,15 +1,39 @@
1
1
  export type ParsedCanonicalMesh = {
2
2
  baseIndices: Uint16Array;
3
3
  mouthIndices: Uint16Array;
4
+ lipIndices: Uint16Array;
5
+ /**
6
+ * Per-vertex position across the lip band: 0 on the outer lip ring, 1 on
7
+ * the inner ring (mouth line), interpolated in between; 1 elsewhere. Bound
8
+ * to the geometry as `attribute float lipEdge` for feathering and tints.
9
+ */
10
+ lipEdgeDistance: Float32Array;
11
+ /**
12
+ * The eye on the SCREEN's left on every feed: the landmark-33 ring
13
+ * (MediaPipe's right eye, canonical −X) — the person's left eye on the
14
+ * mirrored webcam, their right on unmirrored feeds (GROUNDING "Left and
15
+ * right"). `FaceMesh`'s `showLeftEye…` props resolve the person's eye.
16
+ */
17
+ leftEyeIndices: Uint16Array;
18
+ /** The eye on the screen's right: the landmark-263 ring (MediaPipe's left eye). */
19
+ rightEyeIndices: Uint16Array;
4
20
  eyeIndices: Uint16Array;
5
21
  noseIndices: Uint16Array;
6
22
  uvs: Float32Array;
7
23
  vertexCount: number;
8
24
  };
25
+ export declare const CANONICAL_OUTER_LIP_RING: number[];
26
+ export declare const CANONICAL_INNER_LIP_RING: number[];
27
+ /** OBJ face indices (0-based `f` records) of the two nostril openings. */
28
+ export declare const CANONICAL_NOSTRIL_FACE_INDICES: number[];
9
29
  /**
10
30
  * Parse the MediaPipe canonical face OBJ into vertex/UV/index buffers
11
31
  * grouped by anatomical region (base / mouth / eye / nose).
12
32
  *
33
+ * `lipIndices` is an effect-only overlay: the lip-surface triangles between
34
+ * the outer and inner lip rings. They are also kept in `baseIndices`, so the
35
+ * region groups still tile the whole face.
36
+ *
13
37
  * Indices are emitted as Uint16Array — the canonical model has 468
14
38
  * vertices and ~900 faces, well within range.
15
39
  */
@@ -0,0 +1,2 @@
1
+ export declare const COMPOSITE_VERTEX_SHADER = "\n attribute vec2 faceUv;\n varying vec2 vUv;\n varying vec2 vFaceUv;\n varying vec3 vNormal;\n\n void main() {\n vUv = uv;\n vFaceUv = faceUv;\n vNormal = normalize(normalMatrix * normal);\n gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);\n }\n";
2
+ export declare const COMPOSITE_FRAGMENT_SHADER = "\n uniform sampler2D cameraTexture;\n uniform sampler2D canonicalTexture;\n uniform sampler2D alphaMask;\n uniform vec3 textureTint;\n uniform float opacity;\n uniform int blendMode;\n uniform float blendOpacity;\n uniform float useCanonicalTexture;\n uniform float useAlphaMask;\n uniform float alphaOpacity;\n uniform float compositeShading;\n uniform vec3 lightDirection;\n uniform float ambientStrength;\n uniform float directionalStrength;\n varying vec2 vUv;\n varying vec2 vFaceUv;\n varying vec3 vNormal;\n\n vec3 linearToSrgb(vec3 value) {\n vec3 low = value * 12.92;\n vec3 high = 1.055 * pow(max(value, vec3(0.0)), vec3(1.0 / 2.4)) - 0.055;\n return mix(high, low, step(value, vec3(0.0031308)));\n }\n\n vec3 srgbToLinear(vec3 value) {\n vec3 low = value / 12.92;\n vec3 high = pow(max((value + 0.055) / 1.055, vec3(0.0)), vec3(2.4));\n return mix(high, low, step(value, vec3(0.04045)));\n }\n\n float overlayChannel(float base, float blend) {\n return base < 0.5 ? 2.0 * base * blend : 1.0 - 2.0 * (1.0 - base) * (1.0 - blend);\n }\n\n float hardLightChannel(float base, float blend) {\n return blend < 0.5 ? 2.0 * base * blend : 1.0 - 2.0 * (1.0 - base) * (1.0 - blend);\n }\n\n float softLightChannel(float base, float blend) {\n if (blend <= 0.5) {\n return base - (1.0 - 2.0 * blend) * base * (1.0 - base);\n }\n\n float d = base <= 0.25\n ? ((16.0 * base - 12.0) * base + 4.0) * base\n : sqrt(base);\n\n return base + (2.0 * blend - 1.0) * (d - base);\n }\n\n vec3 applyBlendMode(vec3 base, vec3 blend, int mode) {\n if (mode == 0) return blend;\n if (mode == 1) return min(base + blend, 1.0);\n if (mode == 2) return max(base - blend, 0.0);\n if (mode == 3) return base * blend;\n if (mode == 4) return 1.0 - (1.0 - base) * (1.0 - blend);\n if (mode == 5) {\n return vec3(\n overlayChannel(base.r, blend.r),\n overlayChannel(base.g, blend.g),\n overlayChannel(base.b, blend.b)\n );\n }\n if (mode == 6) {\n return vec3(\n softLightChannel(base.r, blend.r),\n softLightChannel(base.g, blend.g),\n softLightChannel(base.b, blend.b)\n );\n }\n if (mode == 7) {\n return vec3(\n hardLightChannel(base.r, blend.r),\n hardLightChannel(base.g, blend.g),\n hardLightChannel(base.b, blend.b)\n );\n }\n if (mode == 8) return max(base, blend);\n if (mode == 9) return min(base, blend);\n if (mode == 10) return abs(base - blend);\n return base + blend - 2.0 * base * blend;\n }\n\n void main() {\n vec3 base = linearToSrgb(texture2D(cameraTexture, vFaceUv).rgb);\n vec4 textureSample = texture2D(canonicalTexture, vUv);\n vec3 blend = linearToSrgb(textureSample.rgb) * textureTint;\n float light = ambientStrength + max(dot(normalize(vNormal), normalize(lightDirection)), 0.0) * directionalStrength;\n blend *= mix(1.0, clamp(light, 0.35, 1.35), compositeShading);\n float maskSample = texture2D(alphaMask, vUv).r;\n float mask = useAlphaMask > 0.5 ? mix(1.0, maskSample, alphaOpacity) : 1.0;\n float textureAlpha = useCanonicalTexture > 0.5 ? textureSample.a : 1.0;\n vec3 blended = applyBlendMode(base, blend, blendMode);\n vec3 color = useCanonicalTexture > 0.5 ? mix(base, blended, blendOpacity) : base;\n gl_FragColor = vec4(srgbToLinear(color), opacity * mask * textureAlpha);\n // Blending above runs in sRGB; the result is linear here and three only\n // encodes built-in materials, so encode for the output colour space.\n #include <colorspace_fragment>\n }\n";
@@ -1,4 +1,5 @@
1
1
  import { NormalizedLandmark } from '@mediapipe/tasks-vision';
2
+ import { Transform3DSettings } from '../Transform3D';
2
3
  import * as THREE from "three";
3
4
  /** Minimal landmark shape the deform reads (x/y/z in normalized space). */
4
5
  type LandmarkXYZ = {
@@ -6,6 +7,8 @@ type LandmarkXYZ = {
6
7
  y: number;
7
8
  z: number;
8
9
  };
10
+ export declare const getFaceMeshTransformUniformScale: (settings: Transform3DSettings) => number;
11
+ export declare const transformFaceMeshLandmark: (landmark: LandmarkXYZ, center: LandmarkXYZ, settings: Transform3DSettings, out: LandmarkXYZ) => LandmarkXYZ;
9
12
  /**
10
13
  * Shared, allocation-free landmark deform for the face-mesh renderers.
11
14
  *
@@ -1,6 +1,11 @@
1
1
  export { FaceMesh, FACE_LANDMARK_Z_SCALE_FACTOR } from './FaceMesh';
2
2
  export { CanonicalFaceMeshRenderer } from './canonical/CanonicalFaceMeshRenderer';
3
- export type { CanonicalFaceMeshRendererProps } from './canonical/CanonicalFaceMeshRenderer';
3
+ export type { CanonicalFaceMeshRendererProps, FaceMeshMaterialOverride, FaceMeshMaterialOverrideContext, FaceMeshMaterialOverrideResult, } from './canonical/CanonicalFaceMeshRenderer';
4
+ export { FaceMeshMaterial } from './canonical/FaceMeshMaterial';
5
+ export type { FaceMeshMaterialProps } from './canonical/FaceMeshMaterial';
6
+ export { DEFAULT_FACE_MESH_TRANSFORM, DEFAULT_FACE_MESH_RENDERER, FaceMeshRenderer, mapFaceMeshRendererProps, mapFaceMeshRendererSettingsToProps, resolveFaceMeshRendererSettings, type FaceMeshRendererSettings, type FaceMeshRendererProps, } from './FaceMeshRenderer';
4
7
  export { useCanonicalFaceMesh } from './canonical/useCanonicalFaceMesh';
8
+ export { canonicalFaceAlphaMaskUrl, canonicalFaceTextureStyle2Url, canonicalFaceTextureUrl, } from './canonical/assets';
5
9
  export { parseCanonicalFaceModel, type ParsedCanonicalMesh, } from './canonical/parseCanonicalFaceModel';
10
+ export { CANONICAL_FACE_MESH_GEOMETRY_SPECS, resolveFaceMeshEyeVisibility, type CanonicalFaceMeshGeometryKey, type CanonicalFaceMeshGeometrySpec, type FaceMeshEyeVisibility, } from './canonical/geometryGroups';
6
11
  export * from './material';
@@ -1,3 +1,77 @@
1
1
  import { FaceMeshAppearance, FaceMeshMasking } from './types';
2
+ export declare const FACE_MESH_MATERIAL_TYPES: {
3
+ readonly basic: "basic";
4
+ readonly standard: "standard";
5
+ readonly physical: "physical";
6
+ readonly toon: "toon";
7
+ readonly normal: "normal";
8
+ readonly matcap: "matcap";
9
+ readonly wireframe: "wireframe";
10
+ readonly shader: "shader";
11
+ };
12
+ export declare const FACE_MESH_SHADER_PRESETS: {
13
+ readonly originalFace: "originalFace";
14
+ readonly composite: "composite";
15
+ };
16
+ export declare const FACE_MESH_TEXTURE_MAPS: {
17
+ readonly none: "none";
18
+ readonly canonical: "canonical";
19
+ readonly style2: "style2";
20
+ };
21
+ export declare const FACE_MESH_ALPHA_MAPS: {
22
+ readonly none: "none";
23
+ readonly canonical: "canonical";
24
+ };
25
+ export declare const FACE_MESH_MASK_TEXTURE_SOURCES: {
26
+ readonly solid: "solid";
27
+ readonly gradient: "gradient";
28
+ readonly imageUrl: "imageUrl";
29
+ readonly mediaUrl: "mediaUrl";
30
+ };
31
+ export declare const FACE_MESH_SIDES: {
32
+ readonly front: "front";
33
+ readonly back: "back";
34
+ readonly double: "double";
35
+ };
36
+ export declare const FACE_MESH_BLEND_MODES: {
37
+ readonly normal: "normal";
38
+ readonly add: "add";
39
+ readonly subtract: "subtract";
40
+ readonly multiply: "multiply";
41
+ readonly screen: "screen";
42
+ readonly overlay: "overlay";
43
+ readonly softLight: "softLight";
44
+ readonly hardLight: "hardLight";
45
+ readonly lighten: "lighten";
46
+ readonly darken: "darken";
47
+ readonly difference: "difference";
48
+ readonly exclusion: "exclusion";
49
+ };
50
+ export declare const FACE_MESH_COMPOSITE_TEXTURE_DEFAULTS: {
51
+ readonly textureMap: "canonical";
52
+ readonly alphaMap: "canonical";
53
+ readonly alphaOpacity: 1;
54
+ };
55
+ export declare const FACE_MESH_COMPOSITE_APPEARANCE_DEFAULTS: {
56
+ readonly blendMode: "hardLight";
57
+ readonly blendOpacity: 0.85;
58
+ readonly baseColor: "#ffffff";
59
+ readonly opacity: 1;
60
+ readonly compositeShading: true;
61
+ readonly textureMap: "canonical";
62
+ readonly alphaMap: "canonical";
63
+ readonly alphaOpacity: 1;
64
+ };
2
65
  export declare const DEFAULT_APPEARANCE: FaceMeshAppearance;
66
+ export declare const FACE_PAINTING_PRESET: FaceMeshAppearance;
67
+ export declare const FACE_MESH_PRESETS: {
68
+ readonly facePainting: FaceMeshAppearance;
69
+ };
3
70
  export declare const DEFAULT_MASKING: FaceMeshMasking;
71
+ export declare const DEFAULT_FACE_MESH_MASK: {
72
+ readonly textureSource: "solid";
73
+ readonly color: "#111111";
74
+ readonly opacity: 0.5;
75
+ };
76
+ export declare const DEFAULT_FACE_MESH_TARGET_FPS = 24;
77
+ export declare const DEFAULT_FACE_MESH_RENDER_ORDER = 10;
@@ -3,3 +3,4 @@ export * from './blendModes';
3
3
  export * from './defaults';
4
4
  export * from './options';
5
5
  export * from './support';
6
+ export * from './textures';
@@ -1,4 +1,4 @@
1
- import { FaceMeshAlphaMap, FaceMeshBlendMode, FaceMeshMaterialType, FaceMeshShaderPreset, FaceMeshSide, FaceMeshTextureMap } from './types';
1
+ import { FaceMeshAlphaMap, FaceMeshBlendMode, FaceMeshMaterialType, FaceMeshMaskTextureSource, FaceMeshShaderPreset, FaceMeshSide, FaceMeshTextureMap } from './types';
2
2
  export declare const materialTypeOptions: Array<{
3
3
  label: string;
4
4
  value: FaceMeshMaterialType;
@@ -19,6 +19,10 @@ export declare const alphaMapOptions: Array<{
19
19
  label: string;
20
20
  value: FaceMeshAlphaMap;
21
21
  }>;
22
+ export declare const maskTextureSourceOptions: Array<{
23
+ label: string;
24
+ value: FaceMeshMaskTextureSource;
25
+ }>;
22
26
  export declare const blendModeOptions: Array<{
23
27
  label: string;
24
28
  value: FaceMeshBlendMode;
@@ -1,3 +1,8 @@
1
- import { FaceMeshMaterialType, FaceMeshShaderPreset } from './types';
1
+ import { FaceMeshMaskTextureSource, FaceMeshMaterialType, FaceMeshShaderPreset, FaceMeshTextureMap } from './types';
2
+ export type FaceMeshShaderMode = "none" | "originalFace" | "composite";
3
+ export declare const getFaceMeshShaderMode: (materialType: FaceMeshMaterialType, shaderPreset: FaceMeshShaderPreset, textureMap: FaceMeshTextureMap) => FaceMeshShaderMode;
2
4
  export declare const supportsTexturePanel: (materialType: FaceMeshMaterialType, shaderPreset: FaceMeshShaderPreset) => boolean;
3
- export declare const supportsBlendMode: (materialType: FaceMeshMaterialType, shaderPreset: FaceMeshShaderPreset) => boolean;
5
+ export declare const supportsBlendMode: (materialType: FaceMeshMaterialType, shaderPreset: FaceMeshShaderPreset, textureMap?: FaceMeshTextureMap) => boolean;
6
+ export declare const usesLiveFaceUv: (materialType: FaceMeshMaterialType, shaderPreset: FaceMeshShaderPreset, textureMap: FaceMeshTextureMap) => boolean;
7
+ export declare const usesMaskSourceUrl: (source: FaceMeshMaskTextureSource) => source is "imageUrl" | "mediaUrl";
8
+ export declare const usesMaskColor: (source: FaceMeshMaskTextureSource) => source is "solid" | "gradient";
@@ -0,0 +1,4 @@
1
+ import * as THREE from "three";
2
+ export declare const TRANSPARENT_TEXTURE_DATA_URL = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO2YpZcAAAAASUVORK5CYII=";
3
+ export declare const createToonGradientTexture: () => THREE.DataTexture;
4
+ export declare const createMatcapTexture: () => THREE.CanvasTexture;
@@ -1,8 +1,8 @@
1
1
  export type FaceMeshMaterialType = "basic" | "standard" | "physical" | "toon" | "normal" | "matcap" | "wireframe" | "shader";
2
- export type FaceMeshShaderPreset = "basicShader" | "originalFace" | "composite";
2
+ export type FaceMeshShaderPreset = "originalFace" | "composite";
3
3
  export type FaceMeshTextureMap = "none" | "canonical" | "style2";
4
4
  export type FaceMeshAlphaMap = "none" | "canonical";
5
- export type FaceMeshMaskTextureSource = "none" | "canonical";
5
+ export type FaceMeshMaskTextureSource = "solid" | "gradient" | "imageUrl" | "mediaUrl";
6
6
  export type FaceMeshSide = "front" | "back" | "double";
7
7
  export type FaceMeshBlendMode = "normal" | "add" | "subtract" | "multiply" | "screen" | "overlay" | "softLight" | "hardLight" | "lighten" | "darken" | "difference" | "exclusion";
8
8
  export type FaceMeshAppearance = {
@@ -13,8 +13,10 @@ export type FaceMeshAppearance = {
13
13
  alphaOpacity: number;
14
14
  side: FaceMeshSide;
15
15
  blendMode: FaceMeshBlendMode;
16
+ blendOpacity: number;
16
17
  baseColor: string;
17
18
  opacity: number;
19
+ compositeShading: boolean;
18
20
  };
19
21
  export type FaceMeshMasking = {
20
22
  mouth: boolean;
@@ -1,16 +1,22 @@
1
1
  import * as THREE from "three";
2
2
  export type FaceRetouchBackgroundProps = {
3
3
  retouchMask: THREE.Texture;
4
- mouthMask: THREE.Texture;
5
4
  retouchAmount: number;
6
5
  blurRadius: number;
7
- teethWhitening: number;
6
+ detailPreservation?: number;
7
+ blemishReduction?: number;
8
+ blemishRadius?: number;
8
9
  previewMask: boolean;
9
10
  protectLandmarks: boolean;
11
+ clipMinX?: number;
12
+ clipMaxX?: number;
13
+ renderOrder?: number;
10
14
  };
11
15
  /**
12
16
  * Full-screen plane that composites the live camera texture with a
13
- * landmark-driven retouch (skin smoothing + teeth whitening). Pair with
14
- * `useFaceRetouchMask` to drive the masks.
17
+ * landmark-driven skin retouch. Pair with `useFaceRetouchMask` to drive the
18
+ * mask. Drawn in the opaque face layer (`FACE_RETOUCH_RENDER_ORDER`, -2.5)
19
+ * with depth testing, so `HandCutout` keeps hands over the face sharp and
20
+ * the face effects (-2) and makeup draw over it.
15
21
  */
16
- export declare const FaceRetouchBackground: ({ retouchMask, mouthMask, retouchAmount, blurRadius, teethWhitening, previewMask, protectLandmarks, }: FaceRetouchBackgroundProps) => import("react/jsx-runtime").JSX.Element | null;
22
+ export declare const FaceRetouchBackground: ({ retouchMask, retouchAmount, blurRadius, detailPreservation, blemishReduction, blemishRadius, previewMask, protectLandmarks, clipMinX, clipMaxX, renderOrder, }: FaceRetouchBackgroundProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,52 @@
1
+ export type FaceRetouchControls = {
2
+ skinSmoothing: number;
3
+ skinRealism: number;
4
+ blemishReduction: number;
5
+ previewMask: boolean;
6
+ };
7
+ export declare const FACE_RETOUCH_SETTINGS_FIELDS: [{
8
+ readonly key: "skinSmoothing";
9
+ readonly label: "Skin smoothing";
10
+ readonly type: "number";
11
+ readonly min: 0;
12
+ readonly max: 1;
13
+ readonly step: 0.01;
14
+ }, {
15
+ readonly key: "skinRealism";
16
+ readonly label: "Skin realism";
17
+ readonly type: "number";
18
+ readonly min: 0;
19
+ readonly max: 1;
20
+ readonly step: 0.01;
21
+ }, {
22
+ readonly key: "blemishReduction";
23
+ readonly label: "Blemish reduction";
24
+ readonly type: "number";
25
+ readonly min: 0;
26
+ readonly max: 1;
27
+ readonly step: 0.01;
28
+ }, {
29
+ readonly key: "previewMask";
30
+ readonly label: "Preview mask";
31
+ readonly type: "boolean";
32
+ }];
33
+ export type FaceRetouchProps = {
34
+ faceIndex?: number;
35
+ numFaces?: number;
36
+ skinSmoothing?: FaceRetouchControls["skinSmoothing"];
37
+ skinRealism?: FaceRetouchControls["skinRealism"];
38
+ blemishReduction?: FaceRetouchControls["blemishReduction"];
39
+ previewMask?: FaceRetouchControls["previewMask"];
40
+ clipMinX?: number;
41
+ clipMaxX?: number;
42
+ /**
43
+ * Draw order. Default `FACE_RETOUCH_RENDER_ORDER` (-2.5): in the opaque face
44
+ * layer, after the camera background and `HandCutout` (hands over the face
45
+ * stay sharp), before the face effects (-2) and makeup.
46
+ */
47
+ renderOrder?: number;
48
+ };
49
+ export declare const FACE_RETOUCH_DEFAULT_CONTROLS: FaceRetouchControls;
50
+ export declare const resolveFaceRetouchControls: (input?: Partial<FaceRetouchControls>) => FaceRetouchControls;
51
+ export declare const patchFaceRetouchControls: (current: FaceRetouchControls, patch: Partial<FaceRetouchControls>) => FaceRetouchControls;
52
+ export declare const FaceRetouch: ({ faceIndex, numFaces, skinSmoothing, skinRealism, blemishReduction, previewMask, clipMinX, clipMaxX, renderOrder, }: FaceRetouchProps) => import("react/jsx-runtime").JSX.Element;
@@ -1,6 +1,2 @@
1
- export { FaceRetouchBackground } from './Background';
2
- export type { FaceRetouchBackgroundProps } from './Background';
3
- export { drawFaceRetouchMask, drawMouthRetouchMask, FACE_MASK_SIZE, FACE_OVAL, LEFT_EYE, RIGHT_EYE, OUTER_LIPS, INNER_MOUTH, LEFT_EYEBROW, RIGHT_EYEBROW, } from './landmarkMask';
4
- export { createFaceRetouchRegions, DEFAULT_FEATURE_GROUPS, DEFAULT_FEATURE_POINT_INDICES, type CreateFaceRetouchRegionsOptions, } from './retouchRegions';
5
- export { useFaceRetouchMask } from './useFaceRetouchMask';
6
- export { useFaceRetouchRegions } from './useFaceRetouchRegions';
1
+ export { FACE_RETOUCH_DEFAULT_CONTROLS, FACE_RETOUCH_SETTINGS_FIELDS, FaceRetouch, patchFaceRetouchControls, resolveFaceRetouchControls, } from './FaceRetouch';
2
+ export type { FaceRetouchControls, FaceRetouchProps } from './FaceRetouch';
@@ -7,6 +7,9 @@ export declare const OUTER_LIPS: number[];
7
7
  export declare const INNER_MOUTH: number[];
8
8
  export declare const LEFT_EYEBROW: number[];
9
9
  export declare const RIGHT_EYEBROW: number[];
10
+ export type FaceRetouchMaskOptions = {
11
+ foreheadCoverage?: boolean;
12
+ };
10
13
  /**
11
14
  * Render the three-channel face retouch mask used by FaceRetouchBackground:
12
15
  * - R: blurred face oval (soft retouch region)
@@ -15,9 +18,4 @@ export declare const RIGHT_EYEBROW: number[];
15
18
  *
16
19
  * `size` defaults to FACE_MASK_SIZE (512). The context must be sized to match.
17
20
  */
18
- export declare const drawFaceRetouchMask: (context: CanvasRenderingContext2D, landmarks: FaceLandmark2D[] | undefined, size?: number) => void;
19
- /**
20
- * Render a single-channel mouth mask (inner-lip polygon, lightly blurred).
21
- * Used for teeth-whitening regions.
22
- */
23
- export declare const drawMouthRetouchMask: (context: CanvasRenderingContext2D, landmarks: FaceLandmark2D[] | undefined, size?: number) => void;
21
+ export declare const drawFaceRetouchMask: (context: CanvasRenderingContext2D, landmarks: FaceLandmark2D[] | undefined, size?: number, options?: FaceRetouchMaskOptions) => void;
@@ -0,0 +1,19 @@
1
+ import { FACE_RETOUCH_RENDER_ORDER } from '../../face-atlas/renderState';
2
+ export { FACE_RETOUCH_RENDER_ORDER };
3
+ /**
4
+ * The retouch plane's material state: drawn in the opaque pass at
5
+ * `FACE_RETOUCH_RENDER_ORDER` (after the camera background and
6
+ * `HandCutout`), blended by its face mask, and depth-tested so the hand
7
+ * cut-out's near depth keeps hands over the face sharp. It writes no depth.
8
+ */
9
+ export declare const FACE_RETOUCH_MATERIAL_STATE: Readonly<{
10
+ transparent: false;
11
+ depthTest: true;
12
+ depthWrite: false;
13
+ toneMapped: false;
14
+ blending: 5;
15
+ blendSrc: 204;
16
+ blendDst: 205;
17
+ blendSrcAlpha: 201;
18
+ blendDstAlpha: 205;
19
+ }>;
@@ -1,14 +1,11 @@
1
1
  import { XRModelNodeFaceTracking } from '../../types/nodes';
2
+ import { FaceRetouchMaskOptions } from './landmarkMask';
2
3
  import * as THREE from "three";
3
4
  /**
4
- * Drive the two CanvasTexture masks consumed by `FaceRetouchBackground`
5
- * from the latest face landmarks. Re-rendered on requestAnimationFrame.
6
- *
7
- * `size` controls the mask resolution (default 512). Both masks share the
8
- * same size.
5
+ * Drive the CanvasTexture mask consumed by `FaceRetouchBackground` from the
6
+ * latest face landmarks. Re-rendered on requestAnimationFrame.
9
7
  */
10
- export declare const useFaceRetouchMask: (faceNode: XRModelNodeFaceTracking | null, size?: number) => {
8
+ export declare const useFaceRetouchMask: (faceNode: XRModelNodeFaceTracking | null, size?: number, options?: FaceRetouchMaskOptions, faceIndex?: number) => {
11
9
  canvas: HTMLCanvasElement;
12
10
  texture: THREE.CanvasTexture;
13
- mouthTexture: THREE.CanvasTexture;
14
11
  };
@@ -0,0 +1,46 @@
1
+ import { FaceSwapQuality } from '../../face-character/liveFaceRegistry';
2
+ import { LiveValue } from '../../face-character/liveValue';
3
+ import { FaceMirrorSettings, FaceMirrorVariant } from './settings';
4
+ export type FaceMirrorProps = Partial<Omit<FaceMirrorSettings, "variant" | "amount">> & {
5
+ /**
6
+ * Required. Left and right are the person's OWN sides on every feed:
7
+ * - `leftLeft`: both halves are the person's own left half;
8
+ * - `rightRight`: both halves are the person's own right half;
9
+ * - `flip`: left and right swapped (a left wink shows on the right);
10
+ * - `upsideDown`: each eye and the mouth flipped top to bottom in place
11
+ * (the Thatcher effect); the rest of the face is unchanged.
12
+ */
13
+ variant: FaceMirrorVariant;
14
+ /** Overall strength, 0..1, or a ref read every frame (fades without re-rendering). Default 1. */
15
+ amount?: LiveValue<number>;
16
+ /** Only this tracked face. Default: every tracked face. */
17
+ faceIndex?: number;
18
+ /** Faces to start the face model with when this starts it: default 1 (at least `faceIndex + 1`). */
19
+ numFaces?: number;
20
+ /** `"auto"` (default) follows the session's quality tier: mesh level, map size, statistics rate. */
21
+ quality?: FaceSwapQuality;
22
+ /** `false` hides it and stops its passes. Default true. */
23
+ active?: boolean;
24
+ };
25
+ /**
26
+ * Your own face, mirrored, on the live camera: `leftLeft` and `rightRight`
27
+ * build a symmetric face from one half, `flip` swaps the halves (a left
28
+ * wink shows on the right), `upsideDown` turns each eye and the mouth upside
29
+ * down in place. Left and right are always the person's own sides, on the
30
+ * mirrored webcam, the rear camera and videos alike. The face's own eyes and
31
+ * mouth are part of every variant, so they are always drawn from the
32
+ * mirrored face. `matchLighting` (default 1) keeps the real side light where
33
+ * it falls; 0 shows the raw mirrored pixels.
34
+ *
35
+ * Mount it anywhere in `<XRScene>` (it draws in screen space, in the face
36
+ * layer at render order −2, so use one face effect per face). It starts the
37
+ * face model itself (1 face, or `numFaces`) when no `FaceTracker` above
38
+ * does, and draws on every tracked face, or only `faceIndex`. Hands stay in
39
+ * front with `HandCutout`.
40
+ *
41
+ * ```tsx
42
+ * <FaceMirror variant="leftLeft" />
43
+ * <FaceMirror variant="upsideDown" matchLighting={0} />
44
+ * ```
45
+ */
46
+ export declare const FaceMirror: ({ variant, amount, faceIndex, numFaces: numFacesProp, quality, active, ...settingsProps }: FaceMirrorProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,58 @@
1
+ import { FaceSwapQuality } from '../../face-character/liveFaceRegistry';
2
+ import { LiveValue } from '../../face-character/liveValue';
3
+ import { FaceSwapSource, FaceSwapStatus } from './faceSwapPlan';
4
+ import { FaceSwapSettings } from './settings';
5
+ export type FaceSwapProps = Partial<Omit<FaceSwapSettings, "amount">> & {
6
+ /**
7
+ * The face drawn. Default `{ kind: "eachOther" }`: two tracked people swap
8
+ * faces. A photo (`{ kind: "photo", src }`, found once, then baked), a
9
+ * painted face (`{ kind: "canonicalTexture", src }`, in the face atlas) or
10
+ * a `FaceTexture` you made (`{ kind: "faceTexture", face }`) goes on every
11
+ * tracked face (or only `faceIndex`).
12
+ */
13
+ source?: FaceSwapSource;
14
+ /** Overall strength, 0..1, or a ref read every frame (fades without re-rendering). Default 1. */
15
+ amount?: LiveValue<number>;
16
+ /** Photo, painted and `faceTexture` sources: only this tracked face. Default: every tracked face. Ignored for `eachOther`. */
17
+ faceIndex?: number;
18
+ /**
19
+ * Faces to start the face model with when this starts it: default 2 for
20
+ * `eachOther` (at least 2), else 1 (at least `faceIndex + 1`). The first
21
+ * component to start the model sets its count.
22
+ */
23
+ numFaces?: number;
24
+ /** `"auto"` (default) follows the session's quality tier: mesh level, map size, mirror fill, statistics rate. */
25
+ quality?: FaceSwapQuality;
26
+ /** `false` hides it and stops its passes and its face model, but keeps a loaded photo. Default true. */
27
+ active?: boolean;
28
+ /** Called with the status whenever it changes (not every frame). */
29
+ onStatus?: (status: FaceSwapStatus) => void;
30
+ };
31
+ /**
32
+ * Swaps faces on the live camera. With no source, two people swap faces: it
33
+ * starts by itself once both faces have been tracked for 5 inference
34
+ * results, fades in over 200 ms, holds through a dropout of up to 250 ms,
35
+ * then fades back to the plain camera (one face shows the normal camera).
36
+ * MediaPipe reordering the faces changes nothing; where the faces overlap,
37
+ * the larger draws on top; with three or more faces only faces 0 and 1
38
+ * swap. A photo or painted face goes on every tracked face instead (or only
39
+ * `faceIndex`), each fading in and out with its own face.
40
+ *
41
+ * The target's expression moves the drawn face. By default it takes the
42
+ * target's skin tone and light (`natural`; painted faces default to
43
+ * `keepColors` and a 0.1 cm feature rim) and keeps the target's own live
44
+ * eyes and mouth (`ownEyes`, `ownMouth`). Settings are flat: spread a
45
+ * `FACE_SWAP_PRESETS` entry or set the fields (see `resolveFaceSwapSettings`).
46
+ *
47
+ * Mount it anywhere in `<XRScene>` (it draws in screen space, in the face
48
+ * layer at render order −2, so use one face effect per face). It starts the
49
+ * face model itself (2 faces for `eachOther`, else 1) when no `FaceTracker`
50
+ * above does; no `FaceRig` is needed. Hands stay in front with `HandCutout`.
51
+ *
52
+ * ```tsx
53
+ * <FaceSwap onStatus={(s) => setSwapping(s.active)} />
54
+ * <FaceSwap source={{ kind: "photo", src: file }} onStatus={(s) => setWarnings(s.warnings)} />
55
+ * <FaceSwap source={{ kind: "canonicalTexture", src: paintedUrl }} />
56
+ * ```
57
+ */
58
+ export declare const FaceSwap: ({ source, amount, faceIndex, numFaces: numFacesProp, quality, active, onStatus, ...settingsProps }: FaceSwapProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,72 @@
1
+ import { FaceTexture, FaceTextureStatistics } from '../../face-character/faceTexture';
2
+ import { FaceTextureLayout, FaceTransferUnseen } from '../../face-character/faceTransfer';
3
+ import { FaceSwapQuality } from '../../face-character/liveFaceRegistry';
4
+ import { LiveValue } from '../../face-character/liveValue';
5
+ import { FaceSwapSettings } from './settings';
6
+ export type FaceTextureLayerProps = Partial<Omit<FaceSwapSettings, "amount">> & {
7
+ /** The face to draw (`useFaceTexture`, `useLiveFaceTexture`, `createFaceTexture`). Nothing is drawn while null or not ready. */
8
+ face: FaceTexture | null;
9
+ /**
10
+ * How the face is laid on the target (left and right are the person's own
11
+ * sides). Default `"asIs"`. `upsideDown`, and any layout other than
12
+ * `asIs` of the target's own live face, draws the face's eyes and mouth
13
+ * too: `ownEyes` and `ownMouth` default to false there (pass them to keep
14
+ * the real ones).
15
+ */
16
+ layout?: FaceTextureLayout;
17
+ /** The tracked face drawn on. Default: the enclosing `FaceTracker`'s, else 0. */
18
+ faceIndex?: number;
19
+ /**
20
+ * The target's skin statistics the colour matches. Default (undefined):
21
+ * the live statistics of `faceIndex`. `null` draws nothing.
22
+ */
23
+ targetStats?: FaceTextureStatistics | null;
24
+ /** Overall strength, 0..1, or a ref read every frame (fades without re-rendering). Default 1. */
25
+ amount?: LiveValue<number>;
26
+ /** Default `FACE_SURFACE_RENDER_ORDER` (−2): this is "the face" layer. */
27
+ renderOrder?: number;
28
+ /** `"auto"` (default) follows the session's quality tier: mesh level and statistics rate. */
29
+ quality?: FaceSwapQuality;
30
+ /**
31
+ * Faces to start the face model with when this starts it (no `FaceTracker`
32
+ * above): at least `faceIndex + 1`, and by default enough for a live
33
+ * `face` from another tracked face too. The first component to start the
34
+ * model sets its count, so pass it whenever the face comes from another
35
+ * tracked face and something else may start the model first.
36
+ */
37
+ numFaces?: number;
38
+ /**
39
+ * The parts of the face the camera sees edge-on (nostril undersides, the
40
+ * lips' seam, the far side of the nose): `"fade"` (default) leaves them to
41
+ * the camera; `"cover"` draws the face there too, for a fill that must
42
+ * hide the features (`<Faceless>` does).
43
+ */
44
+ unseen?: FaceTransferUnseen;
45
+ };
46
+ /**
47
+ * Draws a face texture on a tracked face, in screen space (`FaceTransfer`):
48
+ * the target's expression moves it, it takes the target's skin tone and
49
+ * light (`matchSkinTone`, `matchLighting`; painted faces default to
50
+ * `keepColors`), fades in centimetres inside the face edge, and by default
51
+ * keeps the target's own live eyes and mouth (not in `upsideDown`, nor in a
52
+ * mirror layout of the target's own face). It fades in when the target
53
+ * face is tracked and out 250 ms after it is lost; a live face from
54
+ * another tracked face must be tracked too (when that person leaves, the
55
+ * layer fades out instead of keeping their last frame).
56
+ *
57
+ * Mount it anywhere in `<XRScene>` (it draws in a plain group, in the face
58
+ * layer at render order −2); with no `FaceTracker` above it starts the face
59
+ * model itself, one commit after it mounts, so a `useLiveFaceTexture(1)`
60
+ * above it starts the model first with the two faces it needs. Hands stay
61
+ * in front with `HandCutout`.
62
+ *
63
+ * ```tsx
64
+ * const painted = useFaceTexture({ kind: "canonicalTexture", src: paintedUrl });
65
+ * <FaceTextureLayer face={painted.face} />
66
+ * // your own face, mirrored left to left
67
+ * <FaceTextureLayer face={useLiveFaceTexture(0)} layout="leftLeft" />
68
+ * // the second person's face on the first
69
+ * <FaceTextureLayer face={useLiveFaceTexture(1)} faceIndex={0} numFaces={2} />
70
+ * ```
71
+ */
72
+ export declare const FaceTextureLayer: ({ face, layout, faceIndex: faceIndexProp, targetStats, amount, renderOrder, quality, numFaces, unseen, ...settingsProps }: FaceTextureLayerProps) => import("react/jsx-runtime").JSX.Element;