@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,239 @@
1
+ import { MakeupShadingUniforms, MakeupShapeUniforms } from '../../face-atlas/glsl';
2
+ import { FaceAtlasQualityKey } from '../../face-atlas/quality';
3
+ import { FaceAtlasSurfaceHandle } from '../FaceAtlas/useFaceAtlasSurface';
4
+ import { MakeupFinish, MakeupSide } from './constants';
5
+ import { MakeupDesignSettings } from './design';
6
+ import { MakeupSettings } from './types';
7
+ import * as THREE from "three";
8
+ /**
9
+ * Makeup materials (FACE-1): one `ShaderMaterial` per region instance, built
10
+ * from `MAKEUP_GLSL` (the atlas vertex shader; common → shading → sparkle →
11
+ * finish → shapes, then the region's `main()`), drawn with `MAKEUP_BLENDING`.
12
+ * Every look, shade, shape, finish, side and tier change is a uniform, so
13
+ * nothing recompiles after the first draw, and regions with the same shader
14
+ * source (blush, contour and highlighter) share one GPU program. A design
15
+ * (`MakeupDesign`) adds `design` after `shapes` and reads its art instead
16
+ * of a shape. The eye regions (eyeshadow, eyeliner, brows) add `eyes` after
17
+ * `shapes`, each with its own `main()`.
18
+ */
19
+ /**
20
+ * The regions with a material here: the six makeup face regions and
21
+ * `"design"`, `MakeupDesign`'s creator art in the face atlas (with
22
+ * `MakeupDesignSettings`).
23
+ */
24
+ export declare const MAKEUP_MATERIAL_REGIONS: readonly ["contour", "blush", "highlighter", "eyeshadow", "eyeliner", "brows", "design"];
25
+ export type MakeupMaterialRegion = (typeof MAKEUP_MATERIAL_REGIONS)[number];
26
+ /**
27
+ * The settings each material region reads: `MakeupSettings[region]` for the
28
+ * makeup regions, `MakeupDesignSettings` for `"design"`. The core resolves
29
+ * and merges settings through the program (`resolve`, `patch`), never
30
+ * through `MakeupSettings` directly.
31
+ */
32
+ export type MakeupMaterialSettings = Pick<MakeupSettings, Exclude<MakeupMaterialRegion, "design">> & {
33
+ design: MakeupDesignSettings;
34
+ };
35
+ /**
36
+ * The fields every drawn layer turns into the shared shading uniforms
37
+ * (`MakeupRegionSettings` has them all; `MakeupDesignSettings` has no
38
+ * `shade` or `softness`).
39
+ */
40
+ export type MakeupLayerSettings = {
41
+ enabled: boolean;
42
+ shade?: string;
43
+ color: string;
44
+ opacity: number;
45
+ coverage: number;
46
+ finish: MakeupFinish;
47
+ shine: number;
48
+ sparkleColor: string;
49
+ sparkleDensity: number;
50
+ sparkleSize: number;
51
+ softness?: number;
52
+ side: MakeupSide;
53
+ };
54
+ /**
55
+ * A makeup material's uniforms: every uniform `MAKEUP_GLSL` declares (the
56
+ * atlas vertex shader, the shading chunks and the shapes) plus the region's
57
+ * own. Values are linear colours, canonical cm and 0..1 amounts.
58
+ */
59
+ export type MakeupUniforms = MakeupShadingUniforms & MakeupShapeUniforms & {
60
+ [name: string]: THREE.IUniform;
61
+ };
62
+ /**
63
+ * What a region plugs into the makeup core (`MakeupRegionLayer`) and the
64
+ * material API. The face regions use capsule shapes; eye regions and
65
+ * designs add their own entries with their own `main()`, settings type,
66
+ * `resolve` / `patch` and uniforms.
67
+ */
68
+ export type MakeupRegionProgram<S extends MakeupLayerSettings> = {
69
+ /** The complete fragment shader (built on first use, then cached). */
70
+ fragmentShader: () => string;
71
+ /**
72
+ * The region's own uniforms, beyond `MAKEUP_GLSL`'s, with neutral values.
73
+ * Inputs that are not settings (a design texture) reach the core as its
74
+ * `uniforms` prop, whose entries replace these.
75
+ */
76
+ createUniforms: () => Record<string, THREE.IUniform>;
77
+ /** Complete, clamped settings from a partial (`resolveMakeupSettings(region, …)` for the regions). */
78
+ resolve: (input?: Partial<S>) => S;
79
+ /**
80
+ * An edit applied to resolved settings (`patchMakeupSettings(region, …)`
81
+ * for the regions): a sparse edit keeps every other value.
82
+ */
83
+ patch: (current: S, edit: Partial<S>) => S;
84
+ /** Region uniforms from resolved settings (shape, extra colours). Called on every settings change. */
85
+ updateUniforms: (uniforms: MakeupUniforms, settings: S) => void;
86
+ /**
87
+ * The atlas triangles the region draws for these settings; without
88
+ * settings, every triangle any settings can paint (for a material whose
89
+ * settings the core does not know: `sharedMaterial`). Return a cached
90
+ * array (the same one while the shape's reach is the same): a new array
91
+ * rebuilds the layer's index buffer.
92
+ */
93
+ triangles: (settings?: S) => ArrayLike<number>;
94
+ /** `MAKEUP_AUTO_SHADE_ID` used when `shade` is `"auto"` (0: no auto shade). */
95
+ autoShade: number;
96
+ /** Default draw order (`MAKEUP_RENDER_ORDER`). */
97
+ renderOrder: number;
98
+ /** Per-frame updates from the face (e.g. blink fades from `handle.rig.current.morphs`). */
99
+ onFrame?: (uniforms: MakeupUniforms, handle: FaceAtlasSurfaceHandle) => void;
100
+ };
101
+ /** The program of every material region. */
102
+ export declare const MAKEUP_REGION_PROGRAMS: {
103
+ readonly [R in MakeupMaterialRegion]: MakeupRegionProgram<MakeupMaterialSettings[R]>;
104
+ };
105
+ /** A fresh uniforms object for a region's material (neutral until settings are written). */
106
+ export declare const createMakeupUniforms: (region: MakeupMaterialRegion) => MakeupUniforms;
107
+ /** Options for writing settings into makeup uniforms (each written only when given). */
108
+ export type MakeupUniformOptions = {
109
+ /**
110
+ * The quality tier: `"low"` turns shimmer into a smooth sheen and halves
111
+ * glitter density (`uSparkleQuality` 0). Uniforms start at `"high"`.
112
+ */
113
+ quality?: FaceAtlasQualityKey;
114
+ /**
115
+ * Whether the feed is mirrored, for `uPersonLeftSign` (#298). Leave it out
116
+ * when a `FaceAtlasLayer` owns that uniform (the region components do).
117
+ */
118
+ mirrored?: boolean;
119
+ };
120
+ /**
121
+ * Writes the shared shading uniforms from a layer's resolved settings: the
122
+ * shade (`uColor`, linear; `uAutoShade` for `"auto"`), opacity, coverage,
123
+ * finish, shine, sparkle, softness and the person's sides (`uSide`); then
124
+ * `uSparkleQuality` and `uPersonLeftSign` when `quality` / `mirrored` are
125
+ * given.
126
+ */
127
+ export declare const writeMakeupLayerUniforms: (uniforms: MakeupUniforms, settings: MakeupLayerSettings, autoShade: number, options?: MakeupUniformOptions) => void;
128
+ /** Writes a region's resolved settings into its uniforms: the shared ones, then the region's own. */
129
+ export declare const writeMakeupUniforms: <R extends MakeupMaterialRegion>(uniforms: MakeupUniforms, region: R, settings: MakeupMaterialSettings[R], options?: MakeupUniformOptions) => void;
130
+ /** The render state of every makeup material. */
131
+ export declare const MAKEUP_MATERIAL_STATE: Readonly<{
132
+ readonly depthWrite: false;
133
+ readonly depthTest: true;
134
+ readonly depthFunc: 3;
135
+ readonly side: 0;
136
+ readonly toneMapped: false;
137
+ readonly glslVersion: "300 es";
138
+ readonly blending: 5;
139
+ readonly blendEquation: 100;
140
+ readonly blendSrc: 201;
141
+ readonly blendDst: 205;
142
+ readonly blendSrcAlpha: 201;
143
+ readonly blendDstAlpha: 205;
144
+ readonly transparent: false;
145
+ }>;
146
+ /** A makeup region's material (`createMakeupMaterial`). */
147
+ export type MakeupMaterial<R extends MakeupMaterialRegion = MakeupMaterialRegion> = THREE.ShaderMaterial & {
148
+ uniforms: MakeupUniforms;
149
+ userData: {
150
+ makeupRegion: R;
151
+ /** The resolved settings `updateMakeupMaterial` last wrote; unset before the first. */
152
+ makeupSettings?: MakeupMaterialSettings[R];
153
+ };
154
+ };
155
+ /**
156
+ * A region's built-in material: `MAKEUP_GLSL.atlasVertex`, the region's
157
+ * fragment shader, `MAKEUP_BLENDING` in the opaque pass, depth-tested
158
+ * (`LessEqual`, no depth writes). Its uniforms start neutral: write
159
+ * settings with `updateMakeupMaterial`. Draw it on a `FaceAtlasLayer`
160
+ * (spread the layer's `ctx.uniforms` entries in for the camera and
161
+ * presence) or let a region component own it. You dispose it.
162
+ */
163
+ export declare const createMakeupMaterial: <R extends MakeupMaterialRegion>(region: R, uniforms?: MakeupUniforms) => MakeupMaterial<R>;
164
+ /** Whether a material came from `createMakeupMaterial`. */
165
+ export declare const isMakeupMaterial: (material: THREE.Material) => material is MakeupMaterial;
166
+ /** What `updateMakeupMaterial` writes: every field is optional, and only what is given changes. */
167
+ export type MakeupMaterialInputs<R extends MakeupMaterialRegion = MakeupMaterialRegion> = MakeupUniformOptions & {
168
+ /**
169
+ * An edit, merged into the material's current settings as the
170
+ * components merge edits (`patchMakeupSettings`): `{ opacity: 0.5 }`
171
+ * keeps the shade, finish and shape; a new `shape` or `finish` brings
172
+ * its own values. The first edit starts from the region's defaults.
173
+ */
174
+ settings?: Partial<MakeupMaterialSettings[R]>;
175
+ };
176
+ /**
177
+ * Merges an edit into a material from `createMakeupMaterial` (uniforms
178
+ * only: it never recompiles). `settings` is merged into the settings it
179
+ * last wrote (kept resolved in `material.userData.makeupSettings`);
180
+ * `quality` and `mirrored` are written only when given. A call with one
181
+ * field changes only that field.
182
+ */
183
+ export declare const updateMakeupMaterial: <R extends MakeupMaterialRegion>(material: MakeupMaterial<R>, { settings, quality, mirrored }?: MakeupMaterialInputs<R>) => MakeupMaterial<R>;
184
+ /**
185
+ * Points a makeup material's skin uniforms at a probe's (`useFaceSkin().uniforms`
186
+ * or `FaceSkinProbe.uniforms`): the same `{ value }` objects, so they follow
187
+ * the probe with no copying.
188
+ */
189
+ export declare const bindMakeupSkinUniforms: (uniforms: MakeupUniforms, skin: {
190
+ uSkinMap: THREE.IUniform;
191
+ uSkinLod: THREE.IUniform;
192
+ uSkinSqrt: THREE.IUniform;
193
+ uSkinStats: THREE.IUniform;
194
+ uSkinStatsPacked: THREE.IUniform;
195
+ }) => void;
196
+ /**
197
+ * Points a makeup material's per-layer uniforms at a `FaceAtlasLayer`'s
198
+ * (`ctx.uniforms`): the camera feed, the presence fade and the layer's
199
+ * `uPersonLeftSign`.
200
+ */
201
+ export declare const bindMakeupLayerUniforms: (uniforms: MakeupUniforms, layer: {
202
+ uCameraMap: THREE.IUniform;
203
+ uPresence: THREE.IUniform;
204
+ uPersonLeftSign: THREE.IUniform;
205
+ }) => void;
206
+ /**
207
+ * A draw copy of a makeup material for one face: the same shaders (so the
208
+ * same compiled program), the same render state, and the source's own
209
+ * uniform objects (its settings, written by `updateMakeupMaterial` or in
210
+ * `useFrame`, reach it at once), except the per-face ones (camera,
211
+ * presence, sides, skin probe), which the core binds into the copy only.
212
+ * The source is never changed, so one material can be shared across faces.
213
+ * Keep it current with `syncMakeupFaceCopy`; dispose it when done (the
214
+ * program stays while the source or another copy uses it).
215
+ */
216
+ export declare const createMakeupFaceCopy: <R extends MakeupMaterialRegion>(source: MakeupMaterial<R>) => MakeupMaterial<R>;
217
+ /**
218
+ * Follows a source's uniform objects that were replaced or added since the
219
+ * copy was made (not the per-face ones), and its shaders. No allocation.
220
+ */
221
+ export declare const syncMakeupFaceCopy: (copy: MakeupMaterial, source: MakeupMaterial) => void;
222
+ /** Longest wait for a program warm-up before the region shows anyway (ms). */
223
+ export declare const MAKEUP_WARM_UP_TIMEOUT_MS = 2000;
224
+ /**
225
+ * Disposes a makeup material once no `warmUpMakeupMaterial` compile of it
226
+ * is in flight (at once when none is). A later warm-up of the same material
227
+ * (it is in use again, e.g. on React StrictMode's second mount) cancels the
228
+ * wait.
229
+ */
230
+ export declare const disposeMakeupMaterial: (material: THREE.Material) => void;
231
+ /**
232
+ * Compiles a makeup material's program off the main thread where the GPU
233
+ * allows (`renderer.compileAsync`, KHR_parallel_shader_compile), so its
234
+ * first draw does not stall a frame. Resolves when the program is ready,
235
+ * after `MAKEUP_WARM_UP_TIMEOUT_MS` at most, or at once on a renderer
236
+ * without `compileAsync`. Never rejects. Dispose the material with
237
+ * `disposeMakeupMaterial`, which waits for the compile to settle.
238
+ */
239
+ export declare const warmUpMakeupMaterial: (renderer: THREE.WebGLRenderer, material: THREE.Material, camera: THREE.Camera, scene: THREE.Scene) => Promise<void>;
@@ -0,0 +1,54 @@
1
+ import { MakeupFaceRegion, MakeupRegion } from './constants';
2
+ import { MakeupSettings } from './types';
3
+ /**
4
+ * Complete defaults per region. Every region draws (`enabled: true`) with its
5
+ * first-listed character: blush `apples` in `rose`, contour `soft` in
6
+ * `medium`, highlighter `cheekbones` in shimmering `champagne`, eyeshadow
7
+ * `lid` in `taupe`, eyeliner `classic` in `black`, brows `natural` in
8
+ * `mediumBrown`. Lips are `DEFAULT_LIP_EFFECT_SETTINGS`.
9
+ */
10
+ export declare const DEFAULT_MAKEUP_SETTINGS: {
11
+ readonly [R in MakeupRegion]: MakeupSettings[R];
12
+ };
13
+ type Range = readonly [min: number, max: number];
14
+ /** Inclusive clamp range of every numeric field of the six face regions. */
15
+ export declare const MAKEUP_SETTINGS_RANGES: {
16
+ readonly [R in MakeupFaceRegion]: Readonly<Partial<Record<keyof MakeupSettings[R], Range>>>;
17
+ };
18
+ /**
19
+ * Resolve partial settings for one region to a complete, clamped set. Order:
20
+ * defaults → shape → the finish's `shine` and sparkle values → the shade's
21
+ * colour → every explicit value. Invalid values fall back to that order's
22
+ * value. `"lips"` delegates to `resolveLipEffectSettings` (its `preset` plays
23
+ * the part of `shape`).
24
+ *
25
+ * Every value of the input counts as explicit. Spreading a look region (a
26
+ * partial) and overriding after it works. A resolved object instead carries
27
+ * the values its shape and finish produced (`size`, `coverage`, `shine`,
28
+ * sparkle…), so a `shape` or `finish` spread after it changes nothing else:
29
+ * edit resolved settings with `patchMakeupSettings`. A named shade spread
30
+ * after a resolved object still replaces a colour that a shade produced, not
31
+ * a custom one (see `resolveMakeupShadePair`).
32
+ */
33
+ export declare function resolveMakeupSettings<R extends MakeupRegion>(region: R, input?: Partial<MakeupSettings[R]>): MakeupSettings[R];
34
+ /**
35
+ * Apply an edit to one region, from a panel (the whole object) or from code
36
+ * (a sparse patch):
37
+ *
38
+ * - a `shape` that differs from the current one re-applies that shape;
39
+ * - a `finish` that differs re-applies its `shine` and sparkle values;
40
+ * - a named or `"auto"` shade keeps setting its colour, and a colour that
41
+ * differs from the current one makes its shade `"custom"`;
42
+ * - the patch's other values win over the shape's and finish's values.
43
+ *
44
+ * A whole-object patch counts only the fields that differ from `current`, so
45
+ * its unchanged fields never pin the old shape's or finish's values. A sparse
46
+ * patch (one that leaves out fields of `current`) keeps every value it sets,
47
+ * also one equal to the current value: `{ finish: "gloss", shine: 0.3 }`
48
+ * keeps `shine` 0.3.
49
+ *
50
+ * `"lips"` delegates to `patchLipEffectSettings` (a different `preset`
51
+ * re-applies that preset).
52
+ */
53
+ export declare function patchMakeupSettings<R extends MakeupRegion>(region: R, current: MakeupSettings[R], patch: Partial<MakeupSettings[R]>): MakeupSettings[R];
54
+ export {};
@@ -0,0 +1,143 @@
1
+ import { MakeupAutoShadeRegion, MakeupRegion } from './constants';
2
+ /**
3
+ * Curated shade palettes per region: generic camelCase names (no brand or
4
+ * product names) to sRGB hex. Shades are relative to the person's own skin,
5
+ * so an opaque shade renders as its nominal colour on average skin under
6
+ * settled light, on every skin tone.
7
+ */
8
+ export declare const MAKEUP_SHADES: {
9
+ readonly lips: {
10
+ readonly nude: "#b9826f";
11
+ readonly rosewood: "#9e5a5a";
12
+ readonly mauve: "#a0606e";
13
+ readonly softPink: "#d88a95";
14
+ readonly coral: "#e0645a";
15
+ readonly peach: "#e8907a";
16
+ readonly classicRed: "#a3202d";
17
+ readonly brick: "#8e3b2c";
18
+ readonly berry: "#7b2846";
19
+ readonly plum: "#5e2a45";
20
+ readonly wine: "#5a1a28";
21
+ readonly chocolate: "#5b3a2e";
22
+ };
23
+ readonly contour: {
24
+ readonly fair: "#c9a08a";
25
+ readonly light: "#b48a72";
26
+ readonly medium: "#98705a";
27
+ readonly tan: "#7f5a45";
28
+ readonly deep: "#5e4032";
29
+ readonly rich: "#432c22";
30
+ readonly bronzeLight: "#b9805a";
31
+ readonly bronzeDeep: "#8a5532";
32
+ };
33
+ readonly blush: {
34
+ readonly softPink: "#e8a0a8";
35
+ readonly rose: "#d97a85";
36
+ readonly peach: "#f0a07c";
37
+ readonly coral: "#ec7b67";
38
+ readonly apricot: "#f2a86b";
39
+ readonly mauve: "#c0828f";
40
+ readonly berry: "#b04a68";
41
+ readonly brick: "#b4574a";
42
+ readonly terracotta: "#c4694c";
43
+ readonly plum: "#8f4a68";
44
+ };
45
+ readonly highlighter: {
46
+ readonly pearl: "#f6eee6";
47
+ readonly champagne: "#f2dcc0";
48
+ readonly gold: "#e9c27a";
49
+ readonly roseGold: "#eab3a0";
50
+ readonly bronzeGlow: "#d29a66";
51
+ readonly lilacPearl: "#e6d6ef";
52
+ };
53
+ readonly eyeshadow: {
54
+ readonly ivory: "#f3e6d3";
55
+ readonly champagne: "#e9d2b0";
56
+ readonly sand: "#d2b48c";
57
+ readonly taupe: "#8f7a6e";
58
+ readonly warmBrown: "#8b5a3c";
59
+ readonly coolBrown: "#6e5a50";
60
+ readonly espresso: "#3e2a22";
61
+ readonly charcoal: "#3a3a3c";
62
+ readonly black: "#141414";
63
+ readonly bronze: "#a8743f";
64
+ readonly copper: "#b5653a";
65
+ readonly gold: "#d4ae5a";
66
+ readonly roseGold: "#d49a8a";
67
+ readonly plum: "#6b3a5a";
68
+ readonly burgundy: "#6e2433";
69
+ readonly olive: "#6f6a3a";
70
+ readonly navy: "#23314f";
71
+ readonly emerald: "#1f6b52";
72
+ readonly teal: "#1f6f73";
73
+ readonly lilac: "#b8a0cf";
74
+ readonly silver: "#c5c7cb";
75
+ };
76
+ readonly eyeliner: {
77
+ readonly black: "#0d0d0d";
78
+ readonly brownBlack: "#231a16";
79
+ readonly brown: "#4a3226";
80
+ readonly charcoal: "#33343a";
81
+ readonly navy: "#1c2848";
82
+ readonly plum: "#4f2442";
83
+ readonly emerald: "#145a44";
84
+ readonly bronze: "#8a5a2e";
85
+ readonly gold: "#c9a14e";
86
+ readonly white: "#f5f3ef";
87
+ };
88
+ readonly brows: {
89
+ readonly blonde: "#a88a62";
90
+ readonly taupe: "#7c6a5c";
91
+ readonly softBrown: "#6b4f3c";
92
+ readonly mediumBrown: "#57402f";
93
+ readonly darkBrown: "#3d2c22";
94
+ readonly softBlack: "#252020";
95
+ readonly auburn: "#7a4030";
96
+ readonly grey: "#8a8580";
97
+ };
98
+ };
99
+ /** A named shade of one region's palette, e.g. `MakeupShadeName<"lips">` is `"nude" | "rosewood" | …`. */
100
+ export type MakeupShadeName<R extends MakeupRegion> = Extract<keyof (typeof MAKEUP_SHADES)[R], string>;
101
+ /**
102
+ * What a region's `shade` field accepts: a palette name, `"custom"` (the
103
+ * `color` field as given) and, for lips, blush, contour, highlighter and
104
+ * brows, `"auto"` (from the person's own colouring).
105
+ */
106
+ export type MakeupShadeSetting<R extends MakeupRegion> = MakeupShadeName<R> | "custom" | (R extends MakeupAutoShadeRegion ? "auto" : never);
107
+ /** The palette names per region, in palette order. */
108
+ export declare const MAKEUP_SHADE_NAMES: {
109
+ readonly [R in MakeupRegion]: readonly MakeupShadeName<R>[];
110
+ };
111
+ /** True when `region`'s `shade` accepts `"auto"`. */
112
+ export declare const supportsAutoMakeupShade: (region: MakeupRegion) => region is MakeupAutoShadeRegion;
113
+ export declare const isMakeupShadeName: <R extends MakeupRegion>(region: R, value: unknown) => value is MakeupShadeName<R>;
114
+ /**
115
+ * A shade name to its sRGB hex; `"auto"` stays `"auto"` where the region
116
+ * supports it (the colour is computed on the GPU). `undefined` for
117
+ * `"custom"` and for names that are not in the region's palette.
118
+ */
119
+ export declare function resolveMakeupShade(region: MakeupRegion, shade: string): string | undefined;
120
+ /**
121
+ * Resolves one `shade` / `color` pair (the region's main pair, or eyeshadow's
122
+ * crease and inner pairs). The shade comes from the explicit value, else the
123
+ * base (defaults then shape). A palette shade sets the colour; an explicit
124
+ * colour that differs from it wins and the shade becomes `"custom"`. With
125
+ * `"auto"` the colour keeps the base colour as the fallback shown until the
126
+ * person's own colour is measured. Re-resolving a resolved pair is a no-op.
127
+ *
128
+ * Exception: when both are explicit and the colour is one a shade produced
129
+ * (any colour of the region's palette, or the base colour), the explicit
130
+ * named or `"auto"` shade wins. That colour was carried over from a resolved
131
+ * object, so `{ ...resolved, shade: "coral" }` gives coral.
132
+ */
133
+ export declare const resolveMakeupShadePair: <R extends MakeupRegion>(region: R, shadeInput: unknown, colorInput: unknown, baseShade: MakeupShadeSetting<R>, baseColor: string) => {
134
+ shade: MakeupShadeSetting<R>;
135
+ color: string;
136
+ };
137
+ /** `"classicRed"` → `"Classic red"`. */
138
+ export declare const makeupNameLabel: (name: string) => string;
139
+ /** Select options for a region's shade field: custom, auto (where supported), then the palette. */
140
+ export declare const makeupShadeOptions: <R extends MakeupRegion>(region: R) => {
141
+ label: string;
142
+ value: string;
143
+ }[];
@@ -0,0 +1,27 @@
1
+ import { MakeupRegion } from './constants';
2
+ import { MakeupSettings } from './types';
3
+ /**
4
+ * Placement presets per region, in display order. Lips use the `LipEffect`
5
+ * presets (their `preset` field plays the part of `shape`).
6
+ */
7
+ export declare const MAKEUP_SHAPE_NAMES: {
8
+ readonly lips: readonly ["lipstick", "gloss", "matte", "tint", "metallic", "gradient", "shimmer", "glitter"];
9
+ readonly contour: readonly ["soft", "sculpted", "bronzed", "nose"];
10
+ readonly blush: readonly ["apples", "lifted", "draped", "sunKissed"];
11
+ readonly highlighter: readonly ["cheekbones", "strobe", "glow", "nose"];
12
+ readonly eyeshadow: readonly ["lid", "crease", "smoky", "cutCrease", "halo", "winged"];
13
+ readonly eyeliner: readonly ["tightline", "classic", "winged", "catEye", "smudged", "kohl"];
14
+ readonly brows: readonly ["natural", "softArch", "straight", "highArch", "bold", "thin"];
15
+ };
16
+ /** A placement preset of one region, e.g. `MakeupShape<"blush">` is `"apples" | "lifted" | …`. */
17
+ export type MakeupShape<R extends MakeupRegion> = (typeof MAKEUP_SHAPE_NAMES)[R][number];
18
+ /**
19
+ * What each shape sets. Shapes set placement (geometry fields), `softness`
20
+ * and `coverage`; the shade and finish stay the caller's. Resolution order is
21
+ * defaults → shape → finish → shade → explicit values.
22
+ */
23
+ export declare const MAKEUP_SHAPES: {
24
+ readonly [R in MakeupRegion]: Readonly<Record<MakeupShape<R>, Partial<MakeupSettings[R]>>>;
25
+ };
26
+ /** True when `value` is one of `region`'s shapes (lips: a `LipEffect` preset). */
27
+ export declare const isMakeupShape: <R extends MakeupRegion>(region: R, value: unknown) => value is MakeupShape<R>;
@@ -0,0 +1,135 @@
1
+ import { FaceSkinStats } from '../../face-atlas/probe/stats';
2
+ import { Vec3 } from '../../face-atlas/shading';
3
+ import { MakeupRegion } from './constants';
4
+ import { MakeupShadeName } from './shades';
5
+ /**
6
+ * The skin-tone readout (FACE-1, `useMakeupSkinTone`): skin depth and
7
+ * undertone from the skin probe's settled skin colour, and the curated
8
+ * palette shades closest to what each region would paint on this person.
9
+ * Pure functions: the hook feeds them the probe's stats; a photo's stats
10
+ * (`FaceSkinProbe.renderStill` + `readStats`) work the same way.
11
+ */
12
+ /** Skin depth, lightest to deepest (the contour palette's names). */
13
+ export declare const MAKEUP_SKIN_DEPTHS: readonly ["fair", "light", "medium", "tan", "deep", "rich"];
14
+ export type MakeupSkinDepth = (typeof MAKEUP_SKIN_DEPTHS)[number];
15
+ /** Undertone, from the skin's hue: pinker (cool) to more golden (warm). */
16
+ export declare const MAKEUP_UNDERTONES: readonly ["cool", "neutral", "warm"];
17
+ export type MakeupUndertone = (typeof MAKEUP_UNDERTONES)[number];
18
+ /** The readout's thresholds and defaults. Angles are degrees, lightness and chroma CIELAB units. */
19
+ export declare const MAKEUP_SKIN_TONE: Readonly<{
20
+ /**
21
+ * Lower ITA bound of each depth but the deepest (the Individual Typology
22
+ * Angle, `atan((L* − 50) / b*)`, with Chardon's skin categories: very light
23
+ * > 55°, light > 41°, intermediate > 28°, tan > 10°, brown > −30°, dark).
24
+ */
25
+ readonly depthIta: Readonly<{
26
+ fair: 55;
27
+ light: 41;
28
+ medium: 28;
29
+ tan: 10;
30
+ deep: -30;
31
+ }>;
32
+ /** Skin hue (CIELAB `h_ab`) under this is cool (at `undertoneKneeL` and lighter). */
33
+ readonly coolHue: 50;
34
+ /** Skin hue over this is warm; between `coolHue` and it, neutral. */
35
+ readonly warmHue: 60;
36
+ /**
37
+ * Skin lightness (CIELAB `L*`) under which both hue cuts move down: deeper
38
+ * skin has a lower hue whatever its undertone.
39
+ */
40
+ readonly undertoneKneeL: 50;
41
+ /** How far both hue cuts move down per `L*` unit under `undertoneKneeL`, degrees. */
42
+ readonly undertoneHueShift: 0.25;
43
+ /** Skin chroma (CIELAB `C*ab`) under this reads neutral whatever its hue (a grey or washed-out image). */
44
+ readonly minUndertoneChroma: 6;
45
+ /** Lip or brow colour used once the probe saw at least this share of their taps (else derived from the skin). */
46
+ readonly minFeatureSeen: 0.25;
47
+ /** Shades recommended per region. */
48
+ readonly recommendations: 3;
49
+ /** `useMakeupSkinTone`: ms between reads of the probe (2 a second). */
50
+ readonly readbackMs: 500;
51
+ /** `useMakeupSkinTone`: the shortest `intervalMs` it accepts. */
52
+ readonly minReadbackMs: 200;
53
+ }>;
54
+ /** Each region's recommended palette shades, best first. */
55
+ export type MakeupShadeRecommendations = {
56
+ readonly [R in MakeupRegion]: readonly MakeupShadeName<R>[];
57
+ };
58
+ /** What `computeMakeupSkinTone` reads off the stats (a `FaceSkinStats` fits). */
59
+ export type MakeupSkinToneInput = Pick<FaceSkinStats, "skinSlow" | "ready" | "lip" | "lipSeen" | "brow" | "browSeen">;
60
+ export type MakeupSkinTone = {
61
+ /** The settled skin colour as the camera shows it, sRGB hex. */
62
+ skin: string;
63
+ /** Its CIELAB (D65) `[L*, a*, b*]`. */
64
+ lab: readonly [number, number, number];
65
+ depth: MakeupSkinDepth;
66
+ /** The Individual Typology Angle, degrees: higher is lighter (`MAKEUP_SKIN_TONE.depthIta`). */
67
+ ita: number;
68
+ undertone: MakeupUndertone;
69
+ /** The skin's CIELAB hue angle `h_ab`, degrees (skin is usually 40–70). */
70
+ hue: number;
71
+ /** The skin's CIELAB chroma `C*ab`. */
72
+ chroma: number;
73
+ /** The person's own lip colour, sRGB hex, or null while too little lip was seen. */
74
+ lips: string | null;
75
+ /** The person's own brow-hair colour, sRGB hex, or null while too little brow was seen. */
76
+ brows: string | null;
77
+ /** Palette shades per region, best first: the shades nearest what each region would paint on this person. */
78
+ recommendations: MakeupShadeRecommendations;
79
+ };
80
+ export type ComputeMakeupSkinToneOptions = {
81
+ /** Shades per region. Default `MAKEUP_SKIN_TONE.recommendations` (3). */
82
+ count?: number;
83
+ };
84
+ type MVec3 = [number, number, number];
85
+ /** Linear sRGB → CIELAB (D65), `[L*, a*, b*]`. */
86
+ export declare const linearSrgbToLab: (c: Vec3) => MVec3;
87
+ /** `#rrggbb` → linear sRGB. */
88
+ export declare const hexToLinearSrgb: (hex: string) => MVec3;
89
+ /** Linear sRGB → `#rrggbb` (clamped). */
90
+ export declare const linearSrgbToHex: (c: Vec3) => string;
91
+ /** The Individual Typology Angle of a CIELAB colour, degrees: `atan2(L* − 50, b*)`. */
92
+ export declare const skinTypologyAngle: (lab: Vec3) => number;
93
+ /** Skin depth from the ITA (`MAKEUP_SKIN_TONE.depthIta`). */
94
+ export declare const classifyMakeupSkinDepth: (ita: number) => MakeupSkinDepth;
95
+ /**
96
+ * Undertone from the skin's CIELAB hue and chroma (`MAKEUP_SKIN_TONE`). With
97
+ * its `lightness` (`L*`), the hue cuts move down for skin deeper than
98
+ * `undertoneKneeL`, so deep skin is not read as cool for its lower hue.
99
+ */
100
+ export declare const classifyMakeupUndertone: (hue: number, chroma: number, lightness?: number) => MakeupUndertone;
101
+ /**
102
+ * What each region would paint on this person (linear colours): the GPU's
103
+ * `shade: "auto"` recipes (`makeupAutoShade`) on the settled skin, lip and
104
+ * brow colours, plus a soft transition shade for eyeshadow (the skin
105
+ * deepened) and a liner from the brow hair (darkened). Blush, highlighter
106
+ * and eyeshadow then lean toward the undertone's hues (warm: peach, gold,
107
+ * bronze; cool: rose, pearl, taupe). Lips and brows fall back to colours
108
+ * derived from the skin while too little of them was seen.
109
+ */
110
+ export declare const makeupToneTargets: (skin: Vec3, lip: Vec3 | null, brow: Vec3 | null, undertone?: MakeupUndertone) => { readonly [R in MakeupRegion]: MVec3; };
111
+ /** The `count` palette shades of `region` nearest (CIELAB ΔE) to a linear colour, best first. */
112
+ export declare const nearestMakeupShades: <R extends MakeupRegion>(region: R, target: Vec3, count?: number) => MakeupShadeName<R>[];
113
+ /**
114
+ * The skin-tone readout from the probe's stats (`FaceSkinStats`, e.g.
115
+ * `readFaceSkinStats` of `FaceSkinProbe.readStatsAsync`): skin depth (ITA),
116
+ * undertone (CIELAB hue) and palette shades per region. `null` until the
117
+ * probe is ready (`ready` past `MAKEUP_SKIN_READY`) or while the skin reads black.
118
+ *
119
+ * It measures the image, not the person: the camera's white balance moves
120
+ * the hue (a warm room reads warm), and its exposure moves the depth.
121
+ */
122
+ /**
123
+ * `ready` at or above this counts as ready. It ramps to 1, but the packed
124
+ * 8-bit stats some GPUs fall back to (no float render targets) top out at
125
+ * 255/256, so an exact 1 never comes there (the probe's self-test uses the same).
126
+ */
127
+ export declare const MAKEUP_SKIN_READY = 0.99;
128
+ export declare const computeMakeupSkinTone: (stats: MakeupSkinToneInput, options?: ComputeMakeupSkinToneOptions) => MakeupSkinTone | null;
129
+ /**
130
+ * Whether two readouts differ enough to tell the app (`useMakeupSkinTone`
131
+ * re-renders only then): another depth, undertone, recommendation, or a
132
+ * skin, lip or brow colour that moved by a step of the sRGB hex.
133
+ */
134
+ export declare const makeupSkinToneChanged: (previous: MakeupSkinTone | null, next: MakeupSkinTone | null) => boolean;
135
+ export {};