@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,39 @@
1
+ /**
2
+ * The define that makes `LIP_EFFECT_VERTEX_SHADER` read the skin probe's
3
+ * stats (`uSkinStats`, `uSkinStatsPacked`: spread `skin.uniforms`). The
4
+ * built-in material sets it; without it the probe varyings read "not
5
+ * ready" and the shader binds no probe texture.
6
+ */
7
+ export declare const LIP_EFFECT_SKIN_STATS_DEFINE = "LIP_EFFECT_SKIN_STATS";
8
+ /**
9
+ * The lip vertex shader, for a `FaceAtlasLayer` geometry (the face-atlas
10
+ * surface's attributes). It writes every varying of the makeup core
11
+ * (`MAKEUP_VARYINGS_GLSL`: the camera at the un-warped point, the atlas uv,
12
+ * rest point and normals, `lipEdge`, and, with `LIP_EFFECT_SKIN_STATS`
13
+ * defined, the skin probe's stats) and, for custom lip shaders written
14
+ * against alpha.8, the old varyings:
15
+ *
16
+ * - `vUv`: the face-atlas uv (`FACE_ATLAS_UVS`, the design texture's layout);
17
+ * - `vFaceUv`: the camera-image uv (the `faceUv` attribute; `LipEffect` keeps
18
+ * it current for custom materials);
19
+ * - `vLipEdge`: 0 on the outer lip ring, 1 at the mouth line;
20
+ * - `vNormal`: the live normal in view space; `vViewDir`: surface → eye, view space.
21
+ *
22
+ * `gl_Position` is computed exactly as the face's depth pre-pass does.
23
+ */
24
+ export declare const LIP_EFFECT_VERTEX_SHADER: string;
25
+ /**
26
+ * The lip-specific fragment code, after the makeup core chunks: the design
27
+ * (flipped on mirrored feeds, sRGB-decoded when the GPU does not), the
28
+ * per-lip shade, gradient and inner-lip tint, the feathered mask with each
29
+ * lip's linear opacity, `shading`, the finish (`makeupFinish`) and the
30
+ * alpha.8 extra highlight (`gloss`, `roughness`, `highlightColor`).
31
+ * Mirrors `lipShading.ts`.
32
+ */
33
+ export declare const LIP_EFFECT_GLSL: string;
34
+ /**
35
+ * The built-in lip fragment shader: the makeup core (`common` → `shading`
36
+ * → `sparkle` → `finish`) plus the lip code. Premultiplied output; draw it
37
+ * with `MAKEUP_BLENDING`.
38
+ */
39
+ export declare const LIP_EFFECT_FRAGMENT_SHADER: string;
@@ -0,0 +1,141 @@
1
+ import { ReactNode } from 'react';
2
+ import { FaceAtlasUniforms } from '../../face-atlas/registry';
3
+ import { FaceSkinReference, FaceSkinUniforms } from '../FaceAtlas/useFaceSkin';
4
+ import { LipEffectSettings } from './settings';
5
+ import { LipUvBounds } from './uvGuide';
6
+ import type * as THREE from "three";
7
+ export type LipMaskMode = "outer-lips" | "outer-and-inner-lips";
8
+ /**
9
+ * Inputs handed to a custom lip material factory: everything alpha.8 gave,
10
+ * plus the face-atlas surface's rest positions, the face's skin probe, the
11
+ * side sign and the layer's uniforms. The default `LipEffectMaterial` is
12
+ * built from the same inputs.
13
+ */
14
+ export type LipEffectMaterialContext = {
15
+ /** Live camera frame; sample it with `faceUv` to read the skin under the lips. */
16
+ cameraTexture: THREE.Texture | null;
17
+ /** The creator's design texture in the face atlas (`FACE_ATLAS_UVS`), or `null` when none was given. */
18
+ designTexture: THREE.Texture | null;
19
+ /**
20
+ * Live per-vertex camera-texture UVs. The same attribute is bound to the lip
21
+ * geometry as `attribute vec2 faceUv` (kept current while a custom material
22
+ * is in use), so a custom vertex shader can read it directly; the object is
23
+ * exposed for uniforms, debugging, or readback.
24
+ */
25
+ faceUv: THREE.BufferAttribute;
26
+ /** Static per-vertex lip band position, bound as `attribute float lipEdge` (0 outer ring, 1 mouth line). */
27
+ lipEdge: THREE.BufferAttribute;
28
+ /** Rest position of each vertex in canonical cm (+X is canonical, not a side), `attribute vec3 restPosition`. */
29
+ restPosition: THREE.BufferAttribute;
30
+ /** Design texture for the lower lip when `splitLips` is on, or `null`. */
31
+ lowerDesignTexture: THREE.Texture | null;
32
+ faceIndex: number;
33
+ /** The active mask mode, so a custom material can decide whether to honour the mouth stencil. */
34
+ maskMode: LipMaskMode;
35
+ /** Lip region of the face atlas, for texture transforms and gradients. */
36
+ lipUvBounds: LipUvBounds;
37
+ /** The resolved settings driving the built-in material. */
38
+ settings: LipEffectSettings;
39
+ /**
40
+ * `personLeftSign(mirrored)`: +1 on an unmirrored feed, −1 on the mirrored
41
+ * webcam. Designs are painted as on an unmirrored photo; sample them at
42
+ * `(1 − u, v)` when it is −1 so they keep the person's sides.
43
+ */
44
+ personLeftSign: 1 | -1;
45
+ /**
46
+ * The face's skin probe (`useFaceSkin`): spread `skin.uniforms` into a
47
+ * material whose vertex shader is `LIP_EFFECT_VERTEX_SHADER` (it reads
48
+ * `uSkinStats`), or read the person's skin, light and lip colour yourself.
49
+ */
50
+ skin: FaceSkinReference;
51
+ /**
52
+ * The layer's uniforms with the face's live skin probe: `uCameraMap`,
53
+ * `uPresence` (fade in / out with the face), `uPersonLeftSign`, and
54
+ * `skin.uniforms` (`uSkinStats`, `uSkinStatsPacked`, `uSkinMap`, `uSkinLod`,
55
+ * `uSkinSqrt`). Spread it whole into a material's `uniforms`; the `{ value }`
56
+ * objects are the ones the SDK updates every frame.
57
+ */
58
+ uniforms: FaceAtlasUniforms & FaceSkinUniforms;
59
+ };
60
+ /** A material node, or a three.js material instance (which can be shared across meshes and faces). */
61
+ export type LipEffectMaterialResult = ReactNode | THREE.Material;
62
+ export type LipEffectMaterialSpec = LipEffectMaterialResult | ((context: LipEffectMaterialContext) => LipEffectMaterialResult);
63
+ export type LipEffectProps = Partial<LipEffectSettings> & {
64
+ /**
65
+ * Which tracked face. Default: the face of the `FaceRig` / `FaceWarp3D` /
66
+ * `FaceMorph` it is nested in (it rides that face), else the enclosing
67
+ * `FaceTracker`'s `faceIndex`, else 0.
68
+ */
69
+ faceIndex?: number;
70
+ /**
71
+ * Faces to ask the face model for when the lips start it themselves (no
72
+ * `FaceTracker` above): at least `faceIndex + 1`. Pass the same count to
73
+ * every face component; the first to start the model sets it. A
74
+ * `FaceTracker` mounted beside the lips in the same commit starts it first
75
+ * (its `numFaces` and `targetFps` win); one that mounts later, in another
76
+ * commit (a later `Suspense`), does not: give the lips its `numFaces`.
77
+ */
78
+ numFaces?: number;
79
+ /** Whether the feed is mirrored, for the design's sides. Default: the session's (`useXRMirrored`). */
80
+ mirrored?: boolean;
81
+ /**
82
+ * Design texture in the face atlas, painted as on an unmirrored photo
83
+ * (image-left = the person's right). Without one the lips are filled with `color`.
84
+ */
85
+ designTexture?: THREE.Texture | string;
86
+ /** Lower-lip design texture, used when `splitLips` is on. Falls back to `designTexture`. */
87
+ lowerDesignTexture?: THREE.Texture | string;
88
+ material?: LipEffectMaterialSpec;
89
+ /**
90
+ * Use this material instead of the built-in one (and instead of `material`),
91
+ * for example one from `useLipEffectMaterial` shared by several faces.
92
+ */
93
+ sharedMaterial?: THREE.Material;
94
+ /**
95
+ * Keep the `faceUv` attribute (camera-image uv per vertex) current for a
96
+ * custom material: one projection of the face's landmarks per frame.
97
+ * Default: on for a custom `material` or `sharedMaterial`, off for the
98
+ * built-in one (a `LipEffectMaterial` node, a `createLipEffectMaterial` /
99
+ * `useLipEffectMaterial` instance). A factory function cannot be inspected
100
+ * in advance: pass `faceUv={false}` when it returns the built-in material.
101
+ */
102
+ faceUv?: boolean;
103
+ /**
104
+ * @deprecated Ignored. The lips ride the face's shared surface, which
105
+ * follows every landmark update (and leads between them by quality tier).
106
+ */
107
+ maxUpdateFps?: number;
108
+ /**
109
+ * Keep the face on its last landmarks for this long (ms) across tracker
110
+ * dropouts, then fade it out. Default 250. The hold is the face's shared
111
+ * surface's (as `FaceAtlasLayer`'s `holdMs`): every layer on the face
112
+ * shares it, and the largest `holdMs` any of them asks for wins. Nested in
113
+ * a `FaceRig` / `FaceWarp3D` / `FaceMorph`, the rig's own `holdMs` applies.
114
+ */
115
+ holdMs?: number;
116
+ /**
117
+ * @deprecated Ignored. The face's shared surface leads the landmarks by the
118
+ * quality tier's interval (`FaceAtlasLayer` `leadMs`) and holds them still
119
+ * through dropouts.
120
+ */
121
+ predictMs?: number;
122
+ /** Draw order of the lips. Default `MAKEUP_RENDER_ORDER.lips` (-1.64). */
123
+ renderOrder?: number;
124
+ };
125
+ /** Per-face configuration for `LipEffects`: everything but the face index. */
126
+ export type LipEffectFaceConfig = Omit<LipEffectProps, "faceIndex">;
127
+ export type LipEffectsProps = {
128
+ /** How many face slots to render. Match the tracker's `numFaces`. Default 2. */
129
+ maxFaces?: number;
130
+ /** One config for all faces, or a picker per face (`null` skips a face). */
131
+ faces: LipEffectFaceConfig | ((faceIndex: number) => LipEffectFaceConfig | null);
132
+ /** Share one built-in material across faces. Default: on for a single config, off for a picker. */
133
+ shareMaterial?: boolean;
134
+ /** @deprecated Ignored (see `LipEffectProps.maxUpdateFps`). */
135
+ maxUpdateFps?: number;
136
+ /** The faces' hold through dropouts (see `LipEffectProps.holdMs`: the largest on a face wins). */
137
+ holdMs?: number;
138
+ /** @deprecated Ignored (see `LipEffectProps.predictMs`). */
139
+ predictMs?: number;
140
+ renderOrder?: number;
141
+ };
@@ -0,0 +1,17 @@
1
+ import * as THREE from "three";
2
+ export type LipDesignTextureSource = THREE.Texture | string | undefined;
3
+ /**
4
+ * Resolve the design texture props (URL or texture object) to textures.
5
+ * URLs load through R3F's loader cache, so faces sharing a URL share one
6
+ * texture; a constant hook count keeps the pair reloadable.
7
+ *
8
+ * The textures are returned as they are: a cached texture is shared with
9
+ * every other user of its URL, so its `colorSpace` is never changed here.
10
+ * The lip material decodes sRGB itself for a texture without a colour space
11
+ * (as `TextureLoader` loads it) and lets the GPU decode one tagged
12
+ * `SRGBColorSpace`.
13
+ */
14
+ export declare const useLipDesignTextures: (designTexture: LipDesignTextureSource, lowerDesignTexture: LipDesignTextureSource) => {
15
+ designTexture: THREE.Texture | null;
16
+ lowerDesignTexture: THREE.Texture | null;
17
+ };
@@ -0,0 +1,74 @@
1
+ import { ParsedCanonicalMesh } from '../FaceMesh/canonical/parseCanonicalFaceModel';
2
+ /** Lip extent in the face atlas (`v` grows upward, as in the OBJ). */
3
+ export type LipUvBounds = {
4
+ minU: number;
5
+ maxU: number;
6
+ minV: number;
7
+ maxV: number;
8
+ /** `v` of the mouth line (mean of the inner ring); above it is the upper lip. */
9
+ mouthV: number;
10
+ };
11
+ /**
12
+ * Lip region of the face atlas, rounded. `getLipUvBounds()` gives the exact
13
+ * values from the bundled atlas data.
14
+ */
15
+ export declare const CANONICAL_LIP_UV_BOUNDS: LipUvBounds;
16
+ export type LipUvGuideOptions = {
17
+ /** Pixel size of the square texture canvas the guide represents. Default 1024. */
18
+ size?: number;
19
+ /** Frame the whole canvas (the design contract) or zoom onto the lip region. Default "canvas". */
20
+ region?: "canvas" | "lips";
21
+ /** Draw the lip triangle wireframe. Default true. */
22
+ wireframe?: boolean;
23
+ /** Draw orientation and region labels. Default true. */
24
+ labels?: boolean;
25
+ /** Fill the canvas with a colour. Omit for a transparent background. */
26
+ background?: string;
27
+ };
28
+ /** The guide's colours: the face atlas guide's `lips` and `mouth` colours, and its wireframe and text. */
29
+ export declare const LIP_UV_GUIDE_COLORS: {
30
+ outerRing: string;
31
+ innerRing: string;
32
+ wireframe: string;
33
+ text: string;
34
+ frame: string;
35
+ };
36
+ /**
37
+ * Convert a face-atlas UV to texture pixel space. `TextureLoader` textures are
38
+ * `flipY`, so `v = 1` is the top row of the image (`faceAtlasUvToPixel`).
39
+ */
40
+ export declare const lipUvToPixel: (u: number, v: number, size: number) => {
41
+ x: number;
42
+ y: number;
43
+ };
44
+ /**
45
+ * Bounding box of the outer lip ring in the face atlas, plus the mouth line.
46
+ * Without an argument it reads the bundled atlas (`FACE_ATLAS_UVS`), which
47
+ * is what `LipEffect` samples; with a parsed canonical mesh it reads that
48
+ * mesh's `uv` attribute (the same layout).
49
+ */
50
+ export declare const getLipUvBounds: (mesh?: ParsedCanonicalMesh) => LipUvBounds;
51
+ /**
52
+ * Render the creator-facing lip template as an SVG string. It is the face
53
+ * atlas guide (`createFaceAtlasGuideSvg`) for the `lips` and `mouth` regions,
54
+ * drawn from the bundled atlas data `LipEffect` samples, plus the lip
55
+ * triangle wireframe and lip labels: which side of the image is which side
56
+ * of the person (image-left = the person's right, on every feed), the upper
57
+ * and lower lip, and the lip region's extent. `region: "lips"` zooms onto
58
+ * the lips.
59
+ *
60
+ * `createLipUvGuideSvg(mesh, options)` (alpha.8) still works; the mesh is
61
+ * no longer read, since its UVs are the atlas.
62
+ */
63
+ export declare const createLipUvGuideSvg: (meshOrOptions?: ParsedCanonicalMesh | LipUvGuideOptions, maybeOptions?: LipUvGuideOptions) => string;
64
+ /**
65
+ * The guide as an `image/svg+xml` data URL, loadable with `THREE.TextureLoader`
66
+ * or an `<img>`. Takes `(options)` or alpha.8's `(mesh, options)`.
67
+ */
68
+ export declare const createLipUvGuideDataUrl: (meshOrOptions?: ParsedCanonicalMesh | LipUvGuideOptions, maybeOptions?: LipUvGuideOptions) => string;
69
+ /**
70
+ * Rasterize the guide to a PNG `Blob` in the browser (an `<img>` and a 2D
71
+ * canvas), for download or for use as a texture. Transparent unless
72
+ * `options.background` is set. Takes `(options)` or alpha.8's `(mesh, options)`.
73
+ */
74
+ export declare const createLipUvGuidePngBlob: (meshOrOptions?: ParsedCanonicalMesh | LipUvGuideOptions, maybeOptions?: LipUvGuideOptions) => Promise<Blob>;
@@ -0,0 +1,23 @@
1
+ import { Object3D } from 'three';
2
+ export type LookAtSettings = {
3
+ enabled: boolean;
4
+ targetObjectId: string | null;
5
+ mode: "point" | "direction";
6
+ inheritChildren: boolean;
7
+ offsetRotation: {
8
+ x: number;
9
+ y: number;
10
+ z: number;
11
+ };
12
+ };
13
+ export type LookAtProps = {
14
+ target: Object3D | null;
15
+ settings: LookAtSettings;
16
+ children: React.ReactNode;
17
+ };
18
+ export declare const applyLookAt: ({ source, target, settings, }: {
19
+ source: Object3D;
20
+ target: Object3D | null;
21
+ settings: LookAtSettings;
22
+ }) => boolean;
23
+ export declare const LookAt: ({ target, settings, children }: LookAtProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,18 @@
1
+ import { MakeupRegionProps } from './MakeupRegion';
2
+ import { BlushSettings } from './types';
3
+ /** `<Blush>` props: any `BlushSettings` (resolved like `resolveMakeupSettings("blush", …)`) plus the region props. */
4
+ export type BlushProps = Partial<BlushSettings> & MakeupRegionProps<"blush">;
5
+ /**
6
+ * Blush on the cheeks of the live face: soft, Gaussian-like shapes placed
7
+ * by `shape` (`apples`, `lifted`, `draped`, `sunKissed`), `size` and `lift`
8
+ * (toward the temple), shaded relative to the person's own skin and light.
9
+ * Works alone (no `FaceTracker` or Suspense needed), inside a `FaceTracker`
10
+ * (that face), or nested in a `FaceRig` / `FaceWarp3D` / `FaceMorph` (it
11
+ * rides that face). `enabled={false}` draws and costs nothing.
12
+ *
13
+ * ```tsx
14
+ * <Blush shade="rose" />
15
+ * <Blush {...MAKEUP_LOOKS.glam.blush} shade="coral" />
16
+ * ```
17
+ */
18
+ export declare const Blush: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: BlushProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,20 @@
1
+ import { MakeupRegionProps } from './MakeupRegion';
2
+ import { BrowsSettings } from './types';
3
+ /** `<Brows>` props: any `BrowsSettings` (resolved like `resolveMakeupSettings("brows", …)`) plus the region props. */
4
+ export type BrowsProps = Partial<BrowsSettings> & MakeupRegionProps<"brows">;
5
+ /**
6
+ * Brows on the live face, built on the person's own brow: `shape`
7
+ * (`natural`, `softArch`, `straight`, `highArch`, `bold`, `thin`) reshapes
8
+ * its centre line, `boldness` its width (0.5 = their own), `fill` mixes a
9
+ * tint of only the real hairs (0) toward a full powder shape (1), and
10
+ * `strokes` adds procedural hair strokes. Shaded relative to the person's
11
+ * own skin and light; `shade: "auto"` is their own brow-hair colour.
12
+ * Works alone, inside a `FaceTracker`, or nested in a `FaceRig` /
13
+ * `FaceWarp3D` / `FaceMorph`. `enabled={false}` draws and costs nothing.
14
+ *
15
+ * ```tsx
16
+ * <Brows shape="softArch" shade="softBrown" />
17
+ * <Brows shade="auto" fill={0} />
18
+ * ```
19
+ */
20
+ export declare const Brows: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: BrowsProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,17 @@
1
+ import { MakeupRegionProps } from './MakeupRegion';
2
+ import { ContourSettings } from './types';
3
+ /** `<Contour>` props: any `ContourSettings` (resolved like `resolveMakeupSettings("contour", …)`) plus the region props. */
4
+ export type ContourProps = Partial<ContourSettings> & MakeupRegionProps<"contour">;
5
+ /**
6
+ * Contour on the live face: soft tapered lines in the cheek hollows, along
7
+ * the jaw, at the temples and down the sides of the nose, placed by `shape`
8
+ * (`soft`, `sculpted`, `bronzed`, `nose`) and `size`, shaded relative to the
9
+ * person's own skin and light (`shade: "auto"` darkens their own skin).
10
+ * Works alone, inside a `FaceTracker`, or nested in a `FaceRig` /
11
+ * `FaceWarp3D` / `FaceMorph`. `enabled={false}` draws and costs nothing.
12
+ *
13
+ * ```tsx
14
+ * <Contour shape="sculpted" shade="tan" />
15
+ * ```
16
+ */
17
+ export declare const Contour: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: ContourProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,20 @@
1
+ import { MakeupRegionProps } from './MakeupRegion';
2
+ import { EyelinerSettings } from './types';
3
+ /** `<Eyeliner>` props: any `EyelinerSettings` (resolved like `resolveMakeupSettings("eyeliner", …)`) plus the region props. */
4
+ export type EyelinerProps = Partial<EyelinerSettings> & MakeupRegionProps<"eyeliner">;
5
+ /**
6
+ * Eyeliner on the live face: a line along the upper lashes (`thickness` mm
7
+ * at its outer part, tapering toward the inner corner), an optional `lower`
8
+ * line (it fades while blinking), a `wing` (mm) swept `wingAngle` degrees
9
+ * upward in the person's frame past the outer corner, and `smudge`, placed
10
+ * by `shape` (`tightline`, `classic`, `winged`, `catEye`, `smudged`, `kohl`)
11
+ * and shaded relative to the person's own skin and light. Never paints the
12
+ * eyeball. Works alone, inside a `FaceTracker`, or nested in a `FaceRig` /
13
+ * `FaceWarp3D` / `FaceMorph`. `enabled={false}` draws and costs nothing.
14
+ *
15
+ * ```tsx
16
+ * <Eyeliner shape="winged" />
17
+ * <Eyeliner shape="catEye" wingAngle={30} side="left" />
18
+ * ```
19
+ */
20
+ export declare const Eyeliner: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: EyelinerProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,20 @@
1
+ import { MakeupRegionProps } from './MakeupRegion';
2
+ import { EyeshadowSettings } from './types';
3
+ /** `<Eyeshadow>` props: any `EyeshadowSettings` (resolved like `resolveMakeupSettings("eyeshadow", …)`) plus the region props. */
4
+ export type EyeshadowProps = Partial<EyeshadowSettings> & MakeupRegionProps<"eyeshadow">;
5
+ /**
6
+ * Eyeshadow on the live face's lids: the shade from the lash line up to
7
+ * `height` of the way to the brow, a `crease` band in `creaseShade` at its
8
+ * top edge, shadow along the `lower` lash line (it fades while blinking) and
9
+ * an `inner`-corner highlight in `innerShade`, placed by `shape` (`lid`,
10
+ * `crease`, `smoky`, `cutCrease`, `halo`, `winged`) and shaded relative to
11
+ * the person's own skin and light. Never paints the eyeball. Works alone,
12
+ * inside a `FaceTracker`, or nested in a `FaceRig` / `FaceWarp3D` /
13
+ * `FaceMorph`. `enabled={false}` draws and costs nothing.
14
+ *
15
+ * ```tsx
16
+ * <Eyeshadow shape="crease" shade="warmBrown" creaseShade="espresso" />
17
+ * <Eyeshadow {...MAKEUP_LOOKS.smokyEye.eyeshadow} />
18
+ * ```
19
+ */
20
+ export declare const Eyeshadow: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: EyeshadowProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,18 @@
1
+ import { MakeupRegionProps } from './MakeupRegion';
2
+ import { HighlighterSettings } from './types';
3
+ /** `<Highlighter>` props: any `HighlighterSettings` (resolved like `resolveMakeupSettings("highlighter", …)`) plus the region props. */
4
+ export type HighlighterProps = Partial<HighlighterSettings> & MakeupRegionProps<"highlighter">;
5
+ /**
6
+ * Highlighter on the high points of the live face: soft blobs on the
7
+ * cheekbones, brow bone, nose bridge, cupid's bow and chin, placed by
8
+ * `shape` (`cheekbones`, `strobe`, `glow`, `nose`) and `size`. Defaults to a
9
+ * `shimmer` finish in `champagne`. Its own region, so a look can switch
10
+ * contour off and keep the glow. Works alone, inside a `FaceTracker`, or
11
+ * nested in a `FaceRig` / `FaceWarp3D` / `FaceMorph`. `enabled={false}`
12
+ * draws and costs nothing.
13
+ *
14
+ * ```tsx
15
+ * <Highlighter shape="strobe" finish="metallic" shade="gold" />
16
+ * ```
17
+ */
18
+ export declare const Highlighter: ({ faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: HighlighterProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,37 @@
1
+ import { MakeupDesignSettings } from './design';
2
+ import { MakeupRegionProps } from './MakeupRegion';
3
+ import * as THREE from "three";
4
+ /** Art for `MakeupDesign`: a URL, a texture you own, or nothing. */
5
+ export type MakeupDesignTexture = string | THREE.Texture | null;
6
+ /** `<MakeupDesign>` props: any `MakeupDesignSettings`, the art and the region props. */
7
+ export type MakeupDesignProps = Partial<MakeupDesignSettings> & MakeupRegionProps<"design"> & {
8
+ /**
9
+ * The art, painted in the face atlas as on an unmirrored photo
10
+ * (image-left = the person's right; template `docs/guides/face-atlas-template.svg`):
11
+ * a URL (PNG, WebP or SVG with a size; loaded without Suspense, owned
12
+ * and disposed here) or a `THREE.Texture` you own (never changed;
13
+ * read as sRGB unless tagged `LinearSRGBColorSpace`). `null` / `""`
14
+ * draws nothing. With `sharedMaterial` the material's own art is used.
15
+ */
16
+ texture?: MakeupDesignTexture;
17
+ };
18
+ /**
19
+ * Creator art painted on the live face, in the face atlas (FACE-1):
20
+ * freckles, face gems, graphic liner, face paint. The art is shaded like
21
+ * makeup (relative to the person's own skin and light, with a `finish`),
22
+ * its alpha is the mask and its colours are the paint (`color` tints them).
23
+ * Each side of the art stays on the person's own side on every feed: on the
24
+ * mirrored webcam the art is sampled at `(1 − u, v)`.
25
+ *
26
+ * Works alone (no `FaceTracker` or Suspense), inside a `FaceTracker` (that
27
+ * face), or nested in a `FaceRig` / `FaceWarp3D` / `FaceMorph` (it rides that
28
+ * face). Draws at `MAKEUP_RENDER_ORDER.design` (-1.68): over the eye
29
+ * regions, under the lips. Nothing draws until the art has loaded (a custom
30
+ * `material` draws at once: a procedural design needs no art).
31
+ *
32
+ * ```tsx
33
+ * <MakeupDesign texture="/makeup/freckles.svg" region={["nose", "cheeks"]} coverage={0.4} opacity={0.7} />
34
+ * <MakeupDesign texture="/makeup/face-gems.svg" finish="gloss" />
35
+ * ```
36
+ */
37
+ export declare const MakeupDesign: ({ texture, faceIndex, numFaces, mirrored, renderOrder, material, sharedMaterial, ...settings }: MakeupDesignProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,132 @@
1
+ import { FaceAtlasMaterialContext, FaceAtlasMaterialResult } from '../FaceAtlas/FaceAtlasLayer';
2
+ import { FaceSkinReference } from '../FaceAtlas/useFaceSkin';
3
+ import { MakeupMaterialRegion, MakeupMaterialSettings, MakeupUniforms } from './material';
4
+ import type * as THREE from "three";
5
+ /**
6
+ * The makeup region core (FACE-1): what `Blush`, `Contour`, `Highlighter`,
7
+ * `Eyeshadow`, `Eyeliner`, `Brows` and `MakeupDesign` are built on. One region on one face is
8
+ * one `FaceAtlasLayer` mesh over the region's atlas triangles, drawn at the
9
+ * region's `MAKEUP_RENDER_ORDER`, shaded with `MAKEUP_GLSL` against the
10
+ * face's skin probe (`useFaceSkin`). It
11
+ *
12
+ * - draws nothing and holds nothing while `enabled` is false (no surface, no
13
+ * probe, no material);
14
+ * - writes the resolved settings into ONE uniforms object per region
15
+ * instance, which the built-in material and a custom material share
16
+ * (`ctx.uniforms`), so edits never recompile; inputs that are not
17
+ * settings (a design texture) come in as `uniforms` and join it;
18
+ * - binds the face's shared uniforms into it: the layer's camera feed,
19
+ * presence and `uPersonLeftSign` (#298 sides), and the skin probe's maps
20
+ * and stats;
21
+ * - routes the material: `sharedMaterial` as given, else `material` (a
22
+ * node, an instance, or a factory of `MakeupMaterialContext`, run once
23
+ * per factory), else the built-in `createMakeupMaterial(region)`, owned
24
+ * here and disposed once its warm-up compile has settled; a material
25
+ * from `createMakeupMaterial`, through either prop, keeps its own
26
+ * settings and is drawn through a per-face copy
27
+ * (`createMakeupFaceCopy`) that holds this face's bindings, so the
28
+ * source is never changed and can serve several faces;
29
+ * - warms the built-in program up with `renderer.compileAsync` and shows
30
+ * the region once it is ready (blush, contour and highlighter share one
31
+ * program, so only the first one waits).
32
+ *
33
+ * A region plugs in through its `MAKEUP_REGION_PROGRAMS` entry
34
+ * (`MakeupRegionProgram`): fragment shader, own uniforms, `resolve` /
35
+ * `patch` of its settings, settings → uniforms, triangles, auto shade,
36
+ * order and an optional per-frame hook.
37
+ */
38
+ /**
39
+ * What a custom makeup material factory receives (`material={(ctx) => …}`).
40
+ * The factory runs once per region instance (again only for a new factory
41
+ * or region): not on edits, a new camera, a mirroring change, a new
42
+ * triangle set or the skin probe becoming ready. Read live values from
43
+ * `uniforms` and `skin`; the other fields are those of when it ran.
44
+ */
45
+ export type MakeupMaterialContext<R extends MakeupMaterialRegion = MakeupMaterialRegion> = Omit<FaceAtlasMaterialContext, "uniforms"> & {
46
+ /**
47
+ * Every uniform `MAKEUP_GLSL` reads, kept current from the settings
48
+ * (`uColor`, `uOpacity`, `uCoverage`, `uFinish`, `uShine`, the sparkle
49
+ * fields, `uSide`, the shape uniforms…) and bound to the face (`uCameraMap`,
50
+ * `uPresence`, `uPersonLeftSign`, the skin probe's `uSkin*`). Pass it as
51
+ * `uniforms={ctx.uniforms}` (or spread it and add your own): the objects
52
+ * are stable, so the material never needs rebuilding on an edit.
53
+ */
54
+ uniforms: MakeupUniforms;
55
+ /** The region. */
56
+ region: R;
57
+ /** The resolved settings when the material was made (`uniforms` follow later edits). */
58
+ settings: MakeupMaterialSettings[R];
59
+ /** The face's skin probe (`useFaceSkin`): maps, stats, `ready`, always the current ones. */
60
+ skin: FaceSkinReference;
61
+ /** `MAKEUP_GLSL.atlasVertex`, the vertex shader to pair with these uniforms. */
62
+ vertexShader: string;
63
+ /** The built-in material's fragment shader, to start from. */
64
+ fragmentShader: string;
65
+ };
66
+ /** A region's material: an instance, a node, or a factory of either from the context. */
67
+ export type MakeupMaterialSpec<R extends MakeupMaterialRegion = MakeupMaterialRegion> = FaceAtlasMaterialResult | ((context: MakeupMaterialContext<R>) => FaceAtlasMaterialResult);
68
+ /** Props every makeup region component takes besides its settings. */
69
+ export type MakeupRegionProps<R extends MakeupMaterialRegion = MakeupMaterialRegion> = {
70
+ /**
71
+ * Which face. Default: the enclosing `FaceRig` / `FaceWarp3D` / `FaceMorph`'s
72
+ * (it rides that face), else the enclosing `FaceTracker`'s, else 0.
73
+ */
74
+ faceIndex?: number;
75
+ /**
76
+ * Faces to start the face model with when this region starts it (no
77
+ * `FaceTracker` above): at least `faceIndex + 1`. Pass the same value to
78
+ * every face component.
79
+ */
80
+ numFaces?: number;
81
+ /** Whether the feed is mirrored, for the person's own sides. Default: the session's. */
82
+ mirrored?: boolean;
83
+ /** Draw order in the face layer. Default `MAKEUP_RENDER_ORDER[region]`. */
84
+ renderOrder?: number;
85
+ /**
86
+ * A custom material: a node, an instance (you own it), or
87
+ * `(ctx: MakeupMaterialContext) => either`. Spread `MAKEUP_BLENDING`, set
88
+ * `depthWrite={false}` and pass `uniforms={ctx.uniforms}`. Prefer a
89
+ * factory that returns a node (the layer owns and disposes it). A
90
+ * factory runs once per factory, not on edits; a new factory (an inline
91
+ * arrow, each render) runs again, and an instance the previous one made
92
+ * is then disposed, so keep one that returns an instance stable (module
93
+ * scope or `useCallback`) and dispose the last one it made. A material
94
+ * from `createMakeupMaterial` is drawn as `sharedMaterial` is (its own
95
+ * settings; pass it as `sharedMaterial`).
96
+ */
97
+ material?: MakeupMaterialSpec<R>;
98
+ /**
99
+ * Use this material instead of the built-in one and `material`; you own
100
+ * it and its settings (the region never writes settings into it). Any
101
+ * material is drawn as given and never changed, except one from
102
+ * `createMakeupMaterial`: it is drawn through a per-face copy that shares
103
+ * its program and its uniform objects and adds this face's camera,
104
+ * presence, sides and skin probe, so one such material can serve every
105
+ * face (`<FaceTracker numFaces={2}>`). Drive its look with
106
+ * `updateMakeupMaterial` (or its uniforms in `useFrame`). It is drawn
107
+ * over every triangle its own region can reach, at its own region's
108
+ * order: give it to that region's component (`<Blush>` for a blush
109
+ * material), one component per face.
110
+ */
111
+ sharedMaterial?: THREE.Material;
112
+ };
113
+ /** Internal props of the core: the region, its resolved settings, and optional triangles and uniforms. */
114
+ export type MakeupRegionLayerProps<R extends MakeupMaterialRegion> = MakeupRegionProps<R> & {
115
+ region: R;
116
+ /** Resolved settings (`MAKEUP_REGION_PROGRAMS[region].resolve(…)`). */
117
+ settings: MakeupMaterialSettings[R];
118
+ /** Atlas triangles to draw instead of the region's own (stable). */
119
+ triangles?: ArrayLike<number>;
120
+ /**
121
+ * Uniforms that are not settings (a design texture, a time): merged into
122
+ * the region's uniforms by name, replacing the program's neutral entries,
123
+ * before settings are written. Keep the `{ value }` objects stable and
124
+ * change their values.
125
+ */
126
+ uniforms?: Record<string, THREE.IUniform>;
127
+ };
128
+ /**
129
+ * The core every makeup region component renders: nothing while
130
+ * `settings.enabled` is false, else the region's layer (see the module doc).
131
+ */
132
+ export declare const MakeupRegionLayer: <R extends MakeupMaterialRegion>(props: MakeupRegionLayerProps<R>) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Makeup vocabulary shared by every region and by `LipEffect`. Plain data with
3
+ * no imports, so the lip settings and the makeup tables can both build on it.
4
+ */
5
+ /** The seven makeup region keys: lips first, then the six face regions. Not the draw order. */
6
+ export declare const MAKEUP_REGIONS: readonly ["lips", "contour", "blush", "highlighter", "eyeshadow", "eyeliner", "brows"];
7
+ export type MakeupRegion = (typeof MAKEUP_REGIONS)[number];
8
+ /** The six regions drawn by the makeup region components (every region but lips). */
9
+ export type MakeupFaceRegion = Exclude<MakeupRegion, "lips">;
10
+ /**
11
+ * How the product reflects light. `matte` removes the skin's own shine,
12
+ * `satin` keeps a soft sheen, `gloss` adds a wet highlight, `shimmer` fine
13
+ * flakes, `metallic` a highlight tinted by the shade, `glitter` sparse large
14
+ * flakes.
15
+ */
16
+ export declare const MAKEUP_FINISHES: readonly ["matte", "satin", "gloss", "shimmer", "metallic", "glitter"];
17
+ export type MakeupFinish = (typeof MAKEUP_FINISHES)[number];
18
+ /** Which of the person's own sides a paired region paints, on every feed. */
19
+ export declare const MAKEUP_SIDES: readonly ["both", "left", "right"];
20
+ export type MakeupSide = (typeof MAKEUP_SIDES)[number];
21
+ /**
22
+ * Regions whose `shade` accepts `"auto"`: a colour taken from the person's
23
+ * own skin, lips or brows (lips: their lip colour deepened; blush: their skin
24
+ * hue moved toward rose; contour and highlighter: their skin darkened or
25
+ * lifted; brows: their brow-hair colour), measured on the GPU by the face's
26
+ * skin probe (`useFaceSkin`). `Blush`, `Contour`, `Highlighter`, `Brows`
27
+ * and `LipEffect` derive it there; `color` shows until it is measured.
28
+ */
29
+ export declare const MAKEUP_AUTO_SHADE_REGIONS: readonly ["lips", "blush", "contour", "highlighter", "brows"];
30
+ export type MakeupAutoShadeRegion = (typeof MAKEUP_AUTO_SHADE_REGIONS)[number];
31
+ /** The fields a finish sets. Choosing a finish re-applies them; explicit values win. */
32
+ export type MakeupFinishDefaults = {
33
+ /** Strength of the finish highlight, 0..1. */
34
+ shine: number;
35
+ /** Flake density, 0..1. Read by `shimmer` and `glitter` only. */
36
+ sparkleDensity: number;
37
+ /** Flake size in millimetres on the face, 0.1..1.5. */
38
+ sparkleSize: number;
39
+ };
40
+ export declare const MAKEUP_FINISH_DEFAULTS: Record<MakeupFinish, MakeupFinishDefaults>;
41
+ /** The keys a finish sets. */
42
+ export declare const MAKEUP_FINISH_KEYS: readonly ["shine", "sparkleDensity", "sparkleSize"];
43
+ /** Range of `sparkleSize` in millimetres (lips and every region). */
44
+ export declare const MAKEUP_SPARKLE_SIZE_RANGE: readonly [0.1, 1.5];