@vincentt-xr/sdk 2.0.0-alpha.7 → 2.0.0-alpha.9

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 (639) hide show
  1. package/GROUNDING.md +5651 -82
  2. package/README.md +1 -0
  3. package/dist/CanonicalHeadFrame-BHcWyaiK.js +1506 -0
  4. package/dist/CanonicalHeadFrame-D-_T1OMU.cjs +1 -0
  5. package/dist/DebuggerUI-7ngnJsBe.js +275 -0
  6. package/dist/DebuggerUI-CoglgKdO.cjs +1 -0
  7. package/dist/FaceRetouch-CLoTfrcs.js +1071 -0
  8. package/dist/FaceRetouch-J1lC1WbS.cjs +134 -0
  9. package/dist/FaceSurface-CHAMEeG1.cjs +1 -0
  10. package/dist/FaceSurface-DmP9AEeC.js +27 -0
  11. package/dist/SegmentationOverlay-D_FWkcyP.cjs +35 -0
  12. package/dist/SegmentationOverlay-vn5x_knv.js +6237 -0
  13. package/dist/SkeletonUtils-C2r90MtN.js +21 -0
  14. package/dist/SkeletonUtils-CddIup1F.cjs +1 -0
  15. package/dist/TextLabel-XE0rQSDn.cjs +2 -0
  16. package/dist/TextLabel-c9BCucOI.js +961 -0
  17. package/dist/assets/cache.d.ts +99 -0
  18. package/dist/assets/estimate.d.ts +11 -0
  19. package/dist/assets/gltfLoader.d.ts +16 -0
  20. package/dist/assets/index.d.ts +7 -0
  21. package/dist/assets/loaders.d.ts +43 -0
  22. package/dist/assets/react.d.ts +33 -0
  23. package/dist/body-pose/index.d.ts +521 -0
  24. package/dist/body-trigger/__fixtures__/syntheticBody.d.ts +83 -0
  25. package/dist/body-trigger/frame.d.ts +88 -0
  26. package/dist/body-trigger/index.d.ts +6 -0
  27. package/dist/body-trigger/moves.d.ts +235 -0
  28. package/dist/body-trigger/trigger.d.ts +75 -0
  29. package/dist/calibration/calibration.d.ts +75 -0
  30. package/dist/calibration/index.d.ts +6 -0
  31. package/dist/calibration/storage.d.ts +13 -0
  32. package/dist/calibration/types.d.ts +53 -0
  33. package/dist/calibration/useXRCalibration.d.ts +46 -0
  34. package/dist/camera/CameraPermissionGate.d.ts +26 -0
  35. package/dist/camera/devices.d.ts +26 -0
  36. package/dist/camera/index.d.ts +8 -0
  37. package/dist/camera/permission.d.ts +86 -0
  38. package/dist/camera/useCameraPermission.d.ts +35 -0
  39. package/dist/canonicalFace-BHwyCx1c.js +9 -0
  40. package/dist/canonicalFace-C83I225R.cjs +1 -0
  41. package/dist/capabilities/detect.d.ts +45 -0
  42. package/dist/capabilities/index.d.ts +5 -0
  43. package/dist/capabilities/types.d.ts +120 -0
  44. package/dist/capabilities/useXRCapabilities.d.ts +18 -0
  45. package/dist/compat/environment.d.ts +5 -0
  46. package/dist/compat/index.d.ts +4 -0
  47. package/dist/compat/run.d.ts +18 -0
  48. package/dist/compat/scenarios.d.ts +10 -0
  49. package/dist/compat/types.d.ts +101 -0
  50. package/dist/components/BodyInstruction/BodyPoseHint.d.ts +63 -0
  51. package/dist/components/BodyInstruction/index.d.ts +69 -0
  52. package/dist/components/BodyInstruction/useBodyPose.d.ts +23 -0
  53. package/dist/components/BodyTracker/index.d.ts +17 -0
  54. package/dist/components/BodyTrigger/index.d.ts +49 -0
  55. package/dist/components/Debugger/DebuggerProvider.d.ts +14 -1
  56. package/dist/components/Debugger/DebuggerUI.d.ts +3 -1
  57. package/dist/components/FaceAtlas/FaceAtlasLayer.d.ts +114 -0
  58. package/dist/components/FaceAtlas/MadeUpCamera.d.ts +80 -0
  59. package/dist/components/FaceAtlas/constants.d.ts +8 -0
  60. package/dist/components/FaceAtlas/index.d.ts +7 -0
  61. package/dist/components/FaceAtlas/useFaceAtlasSurface.d.ts +84 -0
  62. package/dist/components/FaceAtlas/useFaceSkin.d.ts +84 -0
  63. package/dist/components/FaceCharacter/ExternalFaceMesh.d.ts +109 -0
  64. package/dist/components/FaceCharacter/FaceExpressionController.d.ts +53 -0
  65. package/dist/components/FaceCharacter/FaceMorph.d.ts +71 -0
  66. package/dist/components/FaceCharacter/FacePiercing.d.ts +65 -0
  67. package/dist/components/FaceCharacter/FaceReprojection.d.ts +85 -0
  68. package/dist/components/FaceCharacter/FaceRig.d.ts +38 -0
  69. package/dist/components/FaceCharacter/FaceSurface.d.ts +49 -0
  70. package/dist/components/FaceCharacter/FaceSurfaceOccluder.d.ts +39 -0
  71. package/dist/components/FaceCharacter/PinToFaceMesh.d.ts +68 -0
  72. package/dist/components/FaceCharacter/index.d.ts +18 -0
  73. package/dist/components/FaceCharacter/useFaceReprojector.d.ts +10 -0
  74. package/dist/components/FaceInset/FaceInset.d.ts +68 -0
  75. package/dist/components/FaceInset/frame.d.ts +94 -0
  76. package/dist/components/FaceInset/index.d.ts +6 -0
  77. package/dist/components/FaceInset/material.d.ts +40 -0
  78. package/dist/components/FaceInset/useFaceInsetTexture.d.ts +37 -0
  79. package/dist/components/FaceInstruction/FaceExpressionHint.d.ts +43 -0
  80. package/dist/components/FaceInstruction/index.d.ts +56 -0
  81. package/dist/components/FaceInstruction/useFaceExpression.d.ts +20 -0
  82. package/dist/components/FaceLiquify/FaceLiquify.d.ts +49 -0
  83. package/dist/components/FaceLiquify/debug.d.ts +37 -0
  84. package/dist/components/FaceLiquify/frame.d.ts +55 -0
  85. package/dist/components/FaceLiquify/index.d.ts +10 -0
  86. package/dist/components/FaceLiquify/material.d.ts +39 -0
  87. package/dist/components/FaceLiquify/pass.d.ts +49 -0
  88. package/dist/components/FaceLiquify/presence.d.ts +25 -0
  89. package/dist/components/FaceLiquify/presets.d.ts +82 -0
  90. package/dist/components/FaceLiquify/selfTest.d.ts +66 -0
  91. package/dist/components/FaceLiquify/target.d.ts +85 -0
  92. package/dist/components/FaceLiquify/warp.d.ts +72 -0
  93. package/dist/components/FaceMesh/canonical/CanonicalFaceMeshRenderer.d.ts +37 -5
  94. package/dist/components/FaceMesh/canonical/geometryGroups.d.ts +21 -0
  95. package/dist/components/FaceMesh/canonical/parseCanonicalFaceModel.d.ts +21 -0
  96. package/dist/components/FaceMesh/canonical/shaders.d.ts +1 -1
  97. package/dist/components/FaceMesh/index.d.ts +2 -2
  98. package/dist/components/FaceRetouch/Background.d.ts +3 -1
  99. package/dist/components/FaceRetouch/FaceRetouch.d.ts +5 -0
  100. package/dist/components/FaceRetouch/renderState.d.ts +19 -0
  101. package/dist/components/FaceSwap/FaceMirror.d.ts +46 -0
  102. package/dist/components/FaceSwap/FaceSwap.d.ts +58 -0
  103. package/dist/components/FaceSwap/FaceTextureLayer.d.ts +72 -0
  104. package/dist/components/FaceSwap/faceSwapPlan.d.ts +91 -0
  105. package/dist/components/FaceSwap/index.d.ts +13 -0
  106. package/dist/components/FaceSwap/settings.d.ts +300 -0
  107. package/dist/components/FaceSwap/useFaceTexture.d.ts +35 -0
  108. package/dist/components/FaceSwap/useLiveFace.d.ts +38 -0
  109. package/dist/components/FaceSwap/useLiveFaceTexture.d.ts +31 -0
  110. package/dist/components/FaceWarp3D/FaceWarp3D.d.ts +50 -0
  111. package/dist/components/FaceWarp3D/index.d.ts +2 -3
  112. package/dist/components/Faceless/Faceless.d.ts +51 -0
  113. package/dist/components/Faceless/index.d.ts +2 -0
  114. package/dist/components/GestureListener/index.d.ts +11 -0
  115. package/dist/components/HairLock/HairLock.d.ts +39 -0
  116. package/dist/components/HairLock/index.d.ts +2 -0
  117. package/dist/components/HairLock/lockGeometry.d.ts +15 -0
  118. package/dist/components/HandCutout/index.d.ts +35 -0
  119. package/dist/components/HandInstruction/HandGestureHint.d.ts +70 -0
  120. package/dist/components/HandInstruction/index.d.ts +74 -0
  121. package/dist/components/HandInstruction/useHandGesture.d.ts +22 -0
  122. package/dist/components/HandRig/ForearmOccluder.d.ts +29 -0
  123. package/dist/components/HandRig/HandAttachment.d.ts +34 -0
  124. package/dist/components/HandRig/HandOccluder.d.ts +55 -0
  125. package/dist/components/HandRig/HandTattoo.d.ts +61 -0
  126. package/dist/components/HandRig/WristAttachment.d.ts +34 -0
  127. package/dist/components/HandRig/index.d.ts +101 -0
  128. package/dist/components/HandRig/useArmMask.d.ts +29 -0
  129. package/dist/components/HandRig/wristSolve.d.ts +69 -0
  130. package/dist/components/HandTouch/HandTouch.d.ts +62 -0
  131. package/dist/components/HandTouch/Touchable.d.ts +36 -0
  132. package/dist/components/HandTouch/index.d.ts +2 -0
  133. package/dist/components/HandTracker/index.d.ts +10 -0
  134. package/dist/components/HeadBinding/index.d.ts +14 -0
  135. package/dist/components/HeadOccluder/CanonicalHeadFrame.d.ts +22 -0
  136. package/dist/components/HeadOccluder/Earrings.d.ts +55 -0
  137. package/dist/components/HeadOccluder/HeadAttachment.d.ts +38 -0
  138. package/dist/components/HeadOccluder/NeckOccluder.d.ts +64 -0
  139. package/dist/components/HeadOccluder/earringPlacement.d.ts +31 -0
  140. package/dist/components/HeadOccluder/headAttachmentPoints.d.ts +69 -0
  141. package/dist/components/HeadOccluder/index.d.ts +57 -3
  142. package/dist/components/HeadOccluder/useCanonicalHeadFit.d.ts +36 -0
  143. package/dist/components/HeadOccluder/useLandmarkPoseFit.d.ts +80 -0
  144. package/dist/components/HolisticTracker/index.d.ts +69 -0
  145. package/dist/components/HolisticTracker/settings.d.ts +58 -0
  146. package/dist/components/HolisticTracker/signals.d.ts +49 -0
  147. package/dist/components/Instruction/HintStage.d.ts +29 -0
  148. package/dist/components/Instruction/InstructionCue.d.ts +126 -0
  149. package/dist/components/Instruction/gestureHold.d.ts +20 -0
  150. package/dist/components/Instruction/ghost.d.ts +129 -0
  151. package/dist/components/Instruction/hintBlend.d.ts +19 -0
  152. package/dist/components/Instruction/hintLook.d.ts +81 -0
  153. package/dist/components/Instruction/hintLoop.d.ts +36 -0
  154. package/dist/components/Instruction/index.d.ts +41 -0
  155. package/dist/components/Instruction/useGhostModel.d.ts +33 -0
  156. package/dist/components/Instruction/useInstructionHold.d.ts +72 -0
  157. package/dist/components/IrisEffect/IrisMaterial.d.ts +73 -0
  158. package/dist/components/IrisEffect/index.d.ts +51 -0
  159. package/dist/components/IrisEffect/settings.d.ts +117 -0
  160. package/dist/components/LipEffect/LipEffect.d.ts +27 -1
  161. package/dist/components/LipEffect/LipEffectMaterial.d.ts +95 -7
  162. package/dist/components/LipEffect/LipEffects.d.ts +12 -0
  163. package/dist/components/LipEffect/defaults.d.ts +46 -4
  164. package/dist/components/LipEffect/index.d.ts +11 -3
  165. package/dist/components/LipEffect/lipShading.d.ts +73 -0
  166. package/dist/components/LipEffect/settings.d.ts +375 -0
  167. package/dist/components/LipEffect/shader.d.ts +39 -0
  168. package/dist/components/LipEffect/types.d.ts +128 -9
  169. package/dist/components/LipEffect/useLipDesignTextures.d.ts +17 -0
  170. package/dist/components/LipEffect/uvGuide.d.ts +74 -0
  171. package/dist/components/Makeup/Blush.d.ts +18 -0
  172. package/dist/components/Makeup/Brows.d.ts +20 -0
  173. package/dist/components/Makeup/Contour.d.ts +17 -0
  174. package/dist/components/Makeup/Eyeliner.d.ts +20 -0
  175. package/dist/components/Makeup/Eyeshadow.d.ts +20 -0
  176. package/dist/components/Makeup/Highlighter.d.ts +18 -0
  177. package/dist/components/Makeup/MakeupDesign.d.ts +37 -0
  178. package/dist/components/Makeup/MakeupRegion.d.ts +132 -0
  179. package/dist/components/Makeup/constants.d.ts +44 -0
  180. package/dist/components/Makeup/design.d.ts +106 -0
  181. package/dist/components/Makeup/designSamples.d.ts +42 -0
  182. package/dist/components/Makeup/eyes.d.ts +114 -0
  183. package/dist/components/Makeup/fields.d.ts +10 -0
  184. package/dist/components/Makeup/geometry.d.ts +106 -0
  185. package/dist/components/Makeup/index.d.ts +26 -0
  186. package/dist/components/Makeup/looks.d.ts +28 -0
  187. package/dist/components/Makeup/material.d.ts +239 -0
  188. package/dist/components/Makeup/settings.d.ts +54 -0
  189. package/dist/components/Makeup/shades.d.ts +143 -0
  190. package/dist/components/Makeup/shapes.d.ts +27 -0
  191. package/dist/components/Makeup/skinTone.d.ts +135 -0
  192. package/dist/components/Makeup/types.d.ts +110 -0
  193. package/dist/components/Makeup/useMakeupSkinTone.d.ts +40 -0
  194. package/dist/components/Necklace/Necklace.d.ts +44 -0
  195. package/dist/components/Necklace/index.d.ts +1 -0
  196. package/dist/components/ParticleEmitter/ParticleEmitter.d.ts +69 -0
  197. package/dist/components/ParticleEmitter/index.d.ts +1 -0
  198. package/dist/components/PersonCutout/index.d.ts +50 -0
  199. package/dist/components/PersonCutout/personCutout.d.ts +16 -0
  200. package/dist/components/ScreenImage/components/ScreenImageBody.d.ts +1 -1
  201. package/dist/components/ScreenImage/index.d.ts +3 -1
  202. package/dist/components/ScreenImage/materials/ScreenImageBlendMaterial.d.ts +1 -1
  203. package/dist/components/ScreenImage/materials/ScreenImageMaskMaterial.d.ts +11 -0
  204. package/dist/components/ScreenImage/source.d.ts +6 -0
  205. package/dist/components/ScreenImage/types.d.ts +18 -0
  206. package/dist/components/SegmentationOverlay/SegmentationOverlay.d.ts +37 -0
  207. package/dist/components/SegmentationOverlay/SegmentationOverlayMaterial.d.ts +31 -0
  208. package/dist/components/SegmentationOverlay/index.d.ts +9 -0
  209. package/dist/components/SegmentationOverlay/maskTexture.d.ts +23 -0
  210. package/dist/components/SegmentationOverlay/providers.d.ts +72 -0
  211. package/dist/components/SegmentationOverlay/settings.d.ts +65 -0
  212. package/dist/components/ShoulderOccluder/index.d.ts +43 -0
  213. package/dist/components/ShoulderOccluder/useCanonicalTorsoFit.d.ts +24 -0
  214. package/dist/components/SpringSwing/SpringSwing.d.ts +22 -0
  215. package/dist/components/SpringSwing/index.d.ts +1 -0
  216. package/dist/components/XRProvider/index.d.ts +16 -2
  217. package/dist/components/XRScene/renderOutputTarget.d.ts +12 -0
  218. package/dist/components/XRViewport/hooks/useViewportExternalFaces.d.ts +1 -1
  219. package/dist/components/XRViewport/hooks/useViewportMediaSource.d.ts +1 -1
  220. package/dist/components/XRViewport/hooks/useViewportPipeline.d.ts +1 -1
  221. package/dist/components/index.d.ts +11 -0
  222. package/dist/config/index.d.ts +0 -1
  223. package/dist/constants/index.d.ts +4 -1
  224. package/dist/context-DTxSQvp4.js +13 -0
  225. package/dist/context-hA0Rb2Xa.cjs +1 -0
  226. package/dist/contexts-BH7PdKFS.cjs +1 -0
  227. package/dist/contexts-jak8-tND.js +667 -0
  228. package/dist/coordinates/feed.d.ts +52 -0
  229. package/dist/coordinates/index.d.ts +7 -0
  230. package/dist/coordinates/side.d.ts +40 -0
  231. package/dist/coordinates/spaces.d.ts +49 -0
  232. package/dist/coordinates/viewport.d.ts +22 -0
  233. package/dist/coordinates/world.d.ts +15 -0
  234. package/dist/debug-ui/default-setting.cjs +2 -2
  235. package/dist/debug-ui/face-swap-settings/index.d.ts +22 -0
  236. package/dist/debug-ui/gesture-settings/index.d.ts +14 -0
  237. package/dist/debug-ui/hierarchy-panel/index.d.ts +3 -2
  238. package/dist/debug-ui/holistic-tracker-settings/index.d.ts +16 -0
  239. package/dist/debug-ui/index.d.ts +18 -3
  240. package/dist/debug-ui/iris-effect-settings/index.d.ts +12 -0
  241. package/dist/debug-ui/lip-effect-settings/index.d.ts +15 -0
  242. package/dist/debug-ui/media-source/index.d.ts +1 -1
  243. package/dist/debug-ui/media-source/session.d.ts +30 -2
  244. package/dist/debug-ui/media-source.cjs +1 -1
  245. package/dist/debug-ui/media-source.js +1 -1
  246. package/dist/debug-ui/object-inspector-panel/index.d.ts +3 -2
  247. package/dist/debug-ui/product-hotspots/index.d.ts +25 -0
  248. package/dist/debug-ui/scene-editor/hierarchy-panel.d.ts +3 -1
  249. package/dist/debug-ui/scene-editor/inspector-panel.d.ts +3 -1
  250. package/dist/debug-ui/screen-image-settings/index.d.ts +3 -1
  251. package/dist/debug-ui/screen-text-settings/ScreenTextSettingsPanel.d.ts +1 -1
  252. package/dist/debug-ui/screen-text-settings/types.d.ts +2 -0
  253. package/dist/debug-ui/segmentation-overlay-settings/index.d.ts +12 -0
  254. package/dist/debug-ui/settings-panel/index.d.ts +6 -1
  255. package/dist/debug-ui/shared/debugWindow.d.ts +51 -0
  256. package/dist/debug-ui/xr-diagnostics/index.d.ts +26 -0
  257. package/dist/debug-ui.cjs +3 -3
  258. package/dist/debug-ui.js +2695 -2547
  259. package/dist/detector-K8aej4MB.js +59 -0
  260. package/dist/detector-ijypGtse.cjs +1 -0
  261. package/dist/entries/all.d.ts +3 -1
  262. package/dist/entries/core.d.ts +20 -2
  263. package/dist/entries/face-effects.d.ts +123 -9
  264. package/dist/entries/instructions.d.ts +48 -0
  265. package/dist/entries/internal.d.ts +2 -1
  266. package/dist/entries/low-level.d.ts +49 -3
  267. package/dist/entries/particles.d.ts +11 -0
  268. package/dist/entries/product.d.ts +11 -0
  269. package/dist/entries/tracking.d.ts +60 -2
  270. package/dist/face-atlas/attributes.d.ts +30 -0
  271. package/dist/face-atlas/eyes.d.ts +272 -0
  272. package/dist/face-atlas/faceAtlas.generated.d.ts +46 -0
  273. package/dist/face-atlas/glsl/atlasVertex.d.ts +46 -0
  274. package/dist/face-atlas/glsl/common.d.ts +55 -0
  275. package/dist/face-atlas/glsl/design.d.ts +49 -0
  276. package/dist/face-atlas/glsl/eyes.d.ts +73 -0
  277. package/dist/face-atlas/glsl/finish.d.ts +24 -0
  278. package/dist/face-atlas/glsl/format.d.ts +4 -0
  279. package/dist/face-atlas/glsl/index.d.ts +59 -0
  280. package/dist/face-atlas/glsl/shading.d.ts +15 -0
  281. package/dist/face-atlas/glsl/shapes.d.ts +66 -0
  282. package/dist/face-atlas/glsl/sparkle.d.ts +19 -0
  283. package/dist/face-atlas/glsl/uniforms.d.ts +106 -0
  284. package/dist/face-atlas/guide.d.ts +51 -0
  285. package/dist/face-atlas/index.d.ts +25 -0
  286. package/dist/face-atlas/lead.d.ts +117 -0
  287. package/dist/face-atlas/madeUpCamera.d.ts +125 -0
  288. package/dist/face-atlas/masks.d.ts +53 -0
  289. package/dist/face-atlas/obj.d.ts +69 -0
  290. package/dist/face-atlas/polylines.d.ts +63 -0
  291. package/dist/face-atlas/probe/FaceSkinProbe.d.ts +208 -0
  292. package/dist/face-atlas/probe/__fixtures__/emulate.d.ts +9 -0
  293. package/dist/face-atlas/probe/__fixtures__/face.d.ts +24 -0
  294. package/dist/face-atlas/probe/constants.d.ts +137 -0
  295. package/dist/face-atlas/probe/glsl.d.ts +43 -0
  296. package/dist/face-atlas/probe/lightFit.d.ts +108 -0
  297. package/dist/face-atlas/probe/schedule.d.ts +44 -0
  298. package/dist/face-atlas/probe/selfTest.d.ts +87 -0
  299. package/dist/face-atlas/probe/stats.d.ts +143 -0
  300. package/dist/face-atlas/probe/targets.d.ts +70 -0
  301. package/dist/face-atlas/probe/unwrap.d.ts +76 -0
  302. package/dist/face-atlas/quality.d.ts +28 -0
  303. package/dist/face-atlas/regions.d.ts +31 -0
  304. package/dist/face-atlas/registry.d.ts +252 -0
  305. package/dist/face-atlas/renderState.d.ts +86 -0
  306. package/dist/face-atlas/selfOcclusion.d.ts +62 -0
  307. package/dist/face-atlas/shading.d.ts +406 -0
  308. package/dist/face-atlas/shapes.d.ts +86 -0
  309. package/dist/face-atlas/sides.d.ts +41 -0
  310. package/dist/face-atlas/skinMask.d.ts +35 -0
  311. package/dist/face-atlas/surface.d.ts +155 -0
  312. package/dist/face-atlas/topology.d.ts +44 -0
  313. package/dist/face-character/__fixtures__/faceImageDetections.d.ts +25 -0
  314. package/dist/face-character/__fixtures__/faceNode.d.ts +22 -0
  315. package/dist/face-character/bindFaceModel.d.ts +106 -0
  316. package/dist/face-character/canonicalFace.d.ts +17 -0
  317. package/dist/face-character/canonicalFaceGeometry.d.ts +11 -0
  318. package/dist/face-character/canonicalFacePositions.d.ts +7 -0
  319. package/dist/face-character/driveFaceModel.d.ts +57 -0
  320. package/dist/face-character/expressionOutputs.d.ts +45 -0
  321. package/dist/face-character/faceExpressions.d.ts +104 -0
  322. package/dist/face-character/faceImageLandmarker.d.ts +93 -0
  323. package/dist/face-character/faceMeshBinding.d.ts +62 -0
  324. package/dist/face-character/faceMorph.d.ts +77 -0
  325. package/dist/face-character/faceMorphs.d.ts +46 -0
  326. package/dist/face-character/facePhoto.d.ts +138 -0
  327. package/dist/face-character/facePiercings.d.ts +116 -0
  328. package/dist/face-character/facePin.d.ts +131 -0
  329. package/dist/face-character/faceReprojection.d.ts +273 -0
  330. package/dist/face-character/faceReprojector.d.ts +171 -0
  331. package/dist/face-character/faceRig.d.ts +176 -0
  332. package/dist/face-character/faceSwapPresence.d.ts +85 -0
  333. package/dist/face-character/faceTexture.d.ts +169 -0
  334. package/dist/face-character/faceTextureBaker.d.ts +86 -0
  335. package/dist/face-character/faceTextureGuide.d.ts +106 -0
  336. package/dist/face-character/faceTextureStats.d.ts +298 -0
  337. package/dist/face-character/faceTransfer.d.ts +396 -0
  338. package/dist/face-character/faceTransferGeometry.d.ts +109 -0
  339. package/dist/face-character/faceTransferSelfTest.d.ts +94 -0
  340. package/dist/face-character/faceWarp3D.d.ts +101 -0
  341. package/dist/face-character/faceless.d.ts +79 -0
  342. package/dist/face-character/featureWarp.d.ts +28 -0
  343. package/dist/face-character/liveFaceRegistry.d.ts +370 -0
  344. package/dist/face-character/liveValue.d.ts +12 -0
  345. package/dist/face-character/memo.d.ts +15 -0
  346. package/dist/face-effects.cjs +2324 -1
  347. package/dist/face-effects.js +14208 -2268
  348. package/dist/face-expression/index.d.ts +182 -0
  349. package/dist/face-info/landmarks.d.ts +17 -3
  350. package/dist/face-info/types.d.ts +20 -3
  351. package/dist/gestures/definitions.d.ts +98 -0
  352. package/dist/gestures/detector.d.ts +87 -0
  353. package/dist/gestures/index.d.ts +8 -0
  354. package/dist/gestures/measures.d.ts +114 -0
  355. package/dist/gestures/settings.d.ts +49 -0
  356. package/dist/getFaceInfo-B1otSDMX.cjs +1 -0
  357. package/dist/getFaceInfo-Cu4xDWiL.js +62 -0
  358. package/dist/hand/armFit.d.ts +46 -0
  359. package/dist/hand/armMask.d.ts +178 -0
  360. package/dist/hand/handCutout.d.ts +23 -0
  361. package/dist/hand/handCutoutRegistry.d.ts +7 -0
  362. package/dist/hand/handGestures.d.ts +524 -0
  363. package/dist/hand/handPose.d.ts +98 -0
  364. package/dist/hand/handRigSolver.d.ts +159 -0
  365. package/dist/hand/handTattoo.d.ts +81 -0
  366. package/dist/hand/handTouch.d.ts +240 -0
  367. package/dist/hand/wrist.d.ts +44 -0
  368. package/dist/hand/wristFilter.d.ts +44 -0
  369. package/dist/hooks/selectors.d.ts +76 -1
  370. package/dist/hooks/useCalibrationFaceTracker.d.ts +1 -1
  371. package/dist/hooks/useFaceInfo.d.ts +13 -1
  372. package/dist/hooks/useFaceInfos.d.ts +1 -1
  373. package/dist/hooks/useFaceModelAcquisition.d.ts +38 -0
  374. package/dist/hooks/useGesture.d.ts +32 -0
  375. package/dist/hooks/useIrisTracking.d.ts +45 -0
  376. package/dist/hooks/useTrackerContext.d.ts +6 -0
  377. package/dist/hooks/useXRDiagnostics.d.ts +81 -0
  378. package/dist/hooks/useXRModel.d.ts +7 -0
  379. package/dist/hooks/useXRSession/facade.d.ts +42 -2
  380. package/dist/hooks/useXRSession/index.d.ts +2 -2
  381. package/dist/hooks/useXRSession/reason.d.ts +3 -1
  382. package/dist/hooks/useXRSession/registry.d.ts +14 -0
  383. package/dist/hooks/useXRSession/store.d.ts +52 -3
  384. package/dist/index-B1_TzJaI.js +1104 -0
  385. package/dist/index-BavF06C6.js +190 -0
  386. package/dist/index-BfFmpddl.cjs +21 -0
  387. package/dist/index-BuBzneeW.cjs +46 -0
  388. package/dist/index-CGsQWodV.cjs +1 -0
  389. package/dist/index-CIe7eCMH.js +3200 -0
  390. package/dist/index-CfSF8LXa.cjs +1 -0
  391. package/dist/index-D5GTzOzD.cjs +1 -0
  392. package/dist/index-DBhQzvVa.js +314 -0
  393. package/dist/index-DE17y0ZI.cjs +1 -0
  394. package/dist/index-JII7huPk.js +442 -0
  395. package/dist/index-tpCr9CLj.cjs +1 -0
  396. package/dist/index-w1S7fI2B.js +1432 -0
  397. package/dist/index-zGaqrz_K.js +188 -0
  398. package/dist/instructions.cjs +30 -0
  399. package/dist/instructions.js +1507 -0
  400. package/dist/{internal-Dmk1cTXq.js → internal-B90P-clC.js} +138 -119
  401. package/dist/internal-Cjinca64.cjs +1 -0
  402. package/dist/internal.cjs +1 -1
  403. package/dist/internal.js +15 -10
  404. package/dist/iris/compute.d.ts +27 -0
  405. package/dist/iris/index.d.ts +4 -0
  406. package/dist/iris/lead.d.ts +19 -0
  407. package/dist/iris/types.d.ts +89 -0
  408. package/dist/landmarkMask-BFDyBnKM.js +224 -0
  409. package/dist/landmarkMask-u7es2k4X.cjs +1 -0
  410. package/dist/landmarks-BlUqf5MZ.cjs +1 -0
  411. package/dist/landmarks-bftdwq6Z.js +76 -0
  412. package/dist/loaders-BGAUACsd.js +363 -0
  413. package/dist/loaders-BJ1_QCHt.cjs +1 -0
  414. package/dist/low-level.cjs +1 -1
  415. package/dist/low-level.js +1190 -675
  416. package/dist/main.cjs +1 -1
  417. package/dist/main.js +1190 -452
  418. package/dist/models/Base/index.d.ts +49 -0
  419. package/dist/models/Body/index.d.ts +3 -1
  420. package/dist/models/Face/constants.d.ts +8 -0
  421. package/dist/models/Face/index.d.ts +4 -12
  422. package/dist/models/Face/rotation.d.ts +18 -3
  423. package/dist/models/Hand/GestureTracking.d.ts +1 -1
  424. package/dist/models/Hand/HandTracking.d.ts +17 -1
  425. package/dist/models/Holistic/index.d.ts +49 -0
  426. package/dist/models/Holistic/result.d.ts +68 -0
  427. package/dist/models/Segmentation/index.d.ts +2 -0
  428. package/dist/models/SemanticSegmentation/index.d.ts +31 -0
  429. package/dist/models/SemanticSegmentation/presets.d.ts +28 -0
  430. package/dist/models/index.d.ts +2 -0
  431. package/dist/models/nodeSource.d.ts +9 -0
  432. package/dist/particles/emission.d.ts +24 -0
  433. package/dist/particles/eyes.d.ts +24 -0
  434. package/dist/particles/glsl.d.ts +14 -0
  435. package/dist/particles/index.d.ts +10 -0
  436. package/dist/particles/motion.d.ts +42 -0
  437. package/dist/particles/presets.d.ts +12 -0
  438. package/dist/particles/ring.d.ts +58 -0
  439. package/dist/particles/selfTest.d.ts +53 -0
  440. package/dist/particles/settings.d.ts +127 -0
  441. package/dist/particles/shapes.d.ts +29 -0
  442. package/dist/particles/spawner.d.ts +60 -0
  443. package/dist/particles/system.d.ts +64 -0
  444. package/dist/particles.cjs +122 -0
  445. package/dist/particles.js +774 -0
  446. package/dist/product/ProductDimensions.d.ts +16 -0
  447. package/dist/product/ProductHotspot.d.ts +16 -0
  448. package/dist/product/ProductViewer.d.ts +9 -0
  449. package/dist/product/details.d.ts +53 -0
  450. package/dist/product/index.d.ts +14 -0
  451. package/dist/product/loadModelViewer.d.ts +4 -0
  452. package/dist/product/types.d.ts +71 -0
  453. package/dist/product/useProductAr.d.ts +37 -0
  454. package/dist/product/useProductDetails.d.ts +60 -0
  455. package/dist/product.cjs +1 -0
  456. package/dist/product.js +414 -0
  457. package/dist/providers-C8rE26Uf.js +366 -0
  458. package/dist/providers-DHsrhDI2.cjs +62 -0
  459. package/dist/quality/XRQualityController.d.ts +25 -0
  460. package/dist/quality/controller.d.ts +33 -0
  461. package/dist/quality/index.d.ts +6 -0
  462. package/dist/quality/types.d.ts +100 -0
  463. package/dist/quality/useXRQuality.d.ts +28 -0
  464. package/dist/render/renderPasses.d.ts +8 -0
  465. package/dist/render/sceneBeforeRender.d.ts +12 -0
  466. package/dist/{renderGroups-KZk6eRiY.js → renderGroups-B38pUaX2.js} +1 -1
  467. package/dist/{renderGroups-80H3DpTl.cjs → renderGroups-Cb_4Ar1Q.cjs} +1 -1
  468. package/dist/renderPasses-B6l8IpJv.js +1290 -0
  469. package/dist/renderPasses-dqmkft4P.cjs +158 -0
  470. package/dist/renderState-CJNmj5jz.js +39 -0
  471. package/dist/renderState-apSfg4eR.cjs +1 -0
  472. package/dist/scene-object.cjs +1 -1
  473. package/dist/scene-object.js +2 -2
  474. package/dist/segmentation-Cb3ouK6Z.js +1758 -0
  475. package/dist/segmentation-D9pYO6aR.cjs +1 -0
  476. package/dist/segmentation2d/faceMemory.d.ts +28 -0
  477. package/dist/segmentation2d/faceRegions.d.ts +24 -0
  478. package/dist/segmentation2d/index.d.ts +9 -0
  479. package/dist/segmentation2d/maskUv.d.ts +23 -0
  480. package/dist/segmentation2d/rasterize.d.ts +14 -0
  481. package/dist/segmentation2d/types.d.ts +52 -0
  482. package/dist/select-Ck5LGz-J.cjs +1 -0
  483. package/dist/select-pYRo_win.js +233 -0
  484. package/dist/selectors-C4X71aoD.cjs +1 -0
  485. package/dist/selectors-DmNaKIwE.js +196 -0
  486. package/dist/session-BrH8G7iJ.cjs +31 -0
  487. package/dist/session-DgA_z6O1.js +418 -0
  488. package/dist/settings-BJ7FMBsO.js +111 -0
  489. package/dist/settings-C63FMBlF.cjs +1 -0
  490. package/dist/similarityFit-BFqHND2e.cjs +1 -0
  491. package/dist/similarityFit-Bbz-R8AY.js +91 -0
  492. package/dist/spring/index.d.ts +2 -0
  493. package/dist/spring/spring.d.ts +69 -0
  494. package/dist/spring/swing.d.ts +54 -0
  495. package/dist/subjects/index.d.ts +2 -0
  496. package/dist/subjects/select.d.ts +62 -0
  497. package/dist/subjects/types.d.ts +55 -0
  498. package/dist/tracking-config/apply.d.ts +57 -0
  499. package/dist/tracking-config/index.d.ts +7 -0
  500. package/dist/tracking-config/resolve.d.ts +25 -0
  501. package/dist/tracking-config/storage.d.ts +8 -0
  502. package/dist/tracking-config/types.d.ts +106 -0
  503. package/dist/tracking-config/useXRTrackingConfig.d.ts +38 -0
  504. package/dist/tracking.cjs +10 -1
  505. package/dist/tracking.js +1326 -506
  506. package/dist/trigger-D0Pm9noT.cjs +49 -0
  507. package/dist/trigger-IQeys0oS.js +2128 -0
  508. package/dist/types/compositor.d.ts +21 -0
  509. package/dist/types/face.d.ts +20 -1
  510. package/dist/types/hand-tracking.d.ts +9 -0
  511. package/dist/types/holistic.d.ts +121 -0
  512. package/dist/types/index.d.ts +1 -0
  513. package/dist/types/model.d.ts +22 -2
  514. package/dist/types/nodes.d.ts +47 -3
  515. package/dist/types/segmentation.d.ts +24 -0
  516. package/dist/types/session.d.ts +41 -3
  517. package/dist/updateThrottle-BseecYag.js +4 -0
  518. package/dist/updateThrottle-Of5Y4SVa.cjs +1 -0
  519. package/dist/useFaceInfo-BHDNCvsJ.cjs +1 -0
  520. package/dist/useFaceInfo-J4x7LsqL.js +76 -0
  521. package/dist/useFaceResultReader-BvEo5REG.js +61 -0
  522. package/dist/useFaceResultReader-DuaL1KJG.cjs +1 -0
  523. package/dist/useInstructionHold-DOu-RpCM.js +53 -0
  524. package/dist/useInstructionHold-DwJY1Alr.cjs +1 -0
  525. package/dist/useLandmarkPoseFit-Bg-h9BPb.cjs +1 -0
  526. package/dist/useLandmarkPoseFit-Bmb3h6Mw.js +87 -0
  527. package/dist/useXRCapabilities-Cr3RzuAW.cjs +1 -0
  528. package/dist/useXRCapabilities-Cxmlmpbd.js +30 -0
  529. package/dist/utils/canonicalRigidLandmarks.d.ts +8 -0
  530. package/dist/utils/fns.d.ts +6 -3
  531. package/dist/utils/headOccluderFit.d.ts +42 -0
  532. package/dist/utils/integrity.d.ts +21 -1
  533. package/dist/utils/resolveNumFaces.d.ts +13 -0
  534. package/dist/utils/shoulderOccluderFit.d.ts +38 -0
  535. package/dist/utils/similarityFit.d.ts +23 -0
  536. package/dist/utils/updateThrottle.d.ts +2 -0
  537. package/dist/utils/useStableUniforms.d.ts +18 -0
  538. package/dist/uv-BMFt19bg.cjs +1 -0
  539. package/dist/{index-ByoNj0QP.js → uv-DJU_XfmN.js} +15 -247
  540. package/docs/SDK_DOCUMENTATION.md +1 -2
  541. package/docs/api/adaptive-quality.mdx +104 -0
  542. package/docs/api/asset-lifecycle.mdx +78 -0
  543. package/docs/api/body-instructions.mdx +285 -0
  544. package/docs/api/body-triggers.mdx +234 -0
  545. package/docs/api/camera-permission.mdx +142 -0
  546. package/docs/api/coordinate-spaces.mdx +168 -0
  547. package/docs/api/cross-camera.mdx +89 -0
  548. package/docs/api/debug-ui-scene-editor.mdx +23 -2
  549. package/docs/api/diagnostics-calibration.mdx +97 -0
  550. package/docs/api/external-face-mesh.mdx +231 -0
  551. package/docs/api/face-actions.mdx +20 -16
  552. package/docs/api/face-attribute-expression.mdx +1 -1
  553. package/docs/api/face-binding-anchors.mdx +4 -2
  554. package/docs/api/face-character.mdx +157 -0
  555. package/docs/api/face-effects.mdx +9 -0
  556. package/docs/api/face-expression-controller.mdx +153 -0
  557. package/docs/api/face-info.mdx +17 -11
  558. package/docs/api/face-inset.mdx +204 -0
  559. package/docs/api/face-instructions.mdx +183 -0
  560. package/docs/api/face-liquify.mdx +196 -0
  561. package/docs/api/face-mesh.mdx +8 -9
  562. package/docs/api/face-morph.mdx +117 -0
  563. package/docs/api/face-painting.mdx +7 -0
  564. package/docs/api/face-reprojection.mdx +154 -0
  565. package/docs/api/face-retouching.mdx +18 -10
  566. package/docs/api/face-swap.mdx +350 -0
  567. package/docs/api/face-warp-3d.mdx +166 -0
  568. package/docs/api/faceless.mdx +143 -0
  569. package/docs/api/gestures.mdx +209 -0
  570. package/docs/api/hair.mdx +97 -0
  571. package/docs/api/hand-instructions.mdx +222 -0
  572. package/docs/api/hand-rig.mdx +535 -0
  573. package/docs/api/hand-touch.mdx +162 -0
  574. package/docs/api/head-occluder.mdx +563 -0
  575. package/docs/api/holistic-tracker.mdx +164 -0
  576. package/docs/api/instructions.mdx +323 -0
  577. package/docs/api/iris-tracking.mdx +247 -0
  578. package/docs/api/made-up-camera.mdx +131 -0
  579. package/docs/api/makeup-skin-tone.mdx +135 -0
  580. package/docs/api/makeup.mdx +353 -0
  581. package/docs/api/multi-subject.mdx +98 -0
  582. package/docs/api/particles.mdx +155 -0
  583. package/docs/api/person-cutout.mdx +136 -0
  584. package/docs/api/pin-to-face-mesh.mdx +274 -0
  585. package/docs/api/product-ar.mdx +114 -0
  586. package/docs/api/product-details.mdx +78 -0
  587. package/docs/api/screen-space-coordinates.mdx +4 -1
  588. package/docs/api/segmentation-overlay.mdx +301 -0
  589. package/docs/api/session-lifecycle.mdx +136 -0
  590. package/docs/api/trackers.mdx +5 -0
  591. package/docs/api/tracking-config.mdx +108 -0
  592. package/docs/docs.json +51 -1
  593. package/docs/examples/lip-shaders.mdx +273 -0
  594. package/docs/guides/face-atlas-template.svg +1 -0
  595. package/docs/guides/face-atlas-textures.mdx +186 -0
  596. package/docs/guides/face-texture-template.svg +1 -0
  597. package/docs/guides/harness-debug-ui.mdx +4 -4
  598. package/docs/guides/lip-effect-textures.mdx +368 -0
  599. package/docs/guides/lip-uv-template.png +0 -0
  600. package/docs/guides/lip-uv-template.svg +1 -0
  601. package/docs/guides/makeup-design-textures.mdx +109 -0
  602. package/docs/introduction.mdx +1 -2
  603. package/package.json +23 -1
  604. package/dist/DebuggerUI-B6bP6P9r.cjs +0 -1
  605. package/dist/DebuggerUI-BjOMr8q_.js +0 -269
  606. package/dist/FaceMeshRenderer-C5l6VLdO.cjs +0 -155
  607. package/dist/FaceMeshRenderer-wjAHrJzP.js +0 -1270
  608. package/dist/FaceRetouch-BkJzoA79.cjs +0 -134
  609. package/dist/FaceRetouch-DwbKQJAN.js +0 -551
  610. package/dist/components/FaceWarp3D/FaceWarp3DHead.d.ts +0 -15
  611. package/dist/components/FaceWarp3D/defaults.d.ts +0 -37
  612. package/dist/components/FaceWarp3D/warp.d.ts +0 -13
  613. package/dist/contexts-ByhzppYl.js +0 -663
  614. package/dist/contexts-Dr62It_K.cjs +0 -1
  615. package/dist/debug-ui/face-warp-3d/index.d.ts +0 -6
  616. package/dist/getFaceInfo-C4QpCQIY.js +0 -118
  617. package/dist/getFaceInfo-fA1bFBub.cjs +0 -1
  618. package/dist/index-9dlAQAhy.js +0 -1462
  619. package/dist/index-BjmTe9eM.cjs +0 -1
  620. package/dist/index-BpEf2BBb.cjs +0 -1
  621. package/dist/index-CyUUurQT.cjs +0 -1
  622. package/dist/index-DCiMbxC3.cjs +0 -1
  623. package/dist/index-DXT3WccE.js +0 -2089
  624. package/dist/index-DpI-qo5X.cjs +0 -17
  625. package/dist/index-DyVF4vEW.js +0 -111
  626. package/dist/index-VJ0SJwmG.js +0 -214
  627. package/dist/internal-Cq-TEQ5Y.cjs +0 -1
  628. package/dist/renderLayers-lDtL0_43.cjs +0 -1
  629. package/dist/renderLayers-zrK2pv5O.js +0 -13
  630. package/dist/renderPasses-BOoBSr8z.cjs +0 -21
  631. package/dist/renderPasses-BcquyVtu.js +0 -1500
  632. package/dist/selectors-B8H97CKA.js +0 -59
  633. package/dist/selectors-CZLKT2Iv.cjs +0 -1
  634. package/dist/session-CpkiK5YA.cjs +0 -31
  635. package/dist/session-DLFN_VII.js +0 -363
  636. package/dist/useFaceInfo-BJ8-_MOs.cjs +0 -1
  637. package/dist/useFaceInfo-Dk426LTu.js +0 -62
  638. package/dist/useFaceResults-CtetsO9M.js +0 -19
  639. package/dist/useFaceResults-wBJF3zyp.cjs +0 -1
@@ -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 {};
@@ -0,0 +1,110 @@
1
+ import { LipEffectSettings } from '../LipEffect/settings';
2
+ import { MakeupFaceRegion, MakeupFinish, MakeupRegion, MakeupSide } from './constants';
3
+ import { MakeupShadeSetting } from './shades';
4
+ import { MakeupShape } from './shapes';
5
+ /**
6
+ * Fields every makeup region shares (lips use `LipEffectSettings`). Flat and
7
+ * serializable: a settings object can live in a store, a URL or a panel.
8
+ */
9
+ export type MakeupRegionSettings<R extends MakeupFaceRegion> = {
10
+ /** `false` draws nothing and costs nothing. Looks use it for unused regions. */
11
+ enabled: boolean;
12
+ /**
13
+ * Placement preset from `MAKEUP_SHAPES[region]`; it sets the geometry
14
+ * fields and `coverage`. `"custom"` applies no preset: the placement is the
15
+ * region's default shape's (contour `soft`, blush `apples`, highlighter
16
+ * `cheekbones`, eyeshadow `lid`, eyeliner `classic`, brows `natural`) with
17
+ * the fields as given.
18
+ */
19
+ shape: MakeupShape<R> | "custom";
20
+ /**
21
+ * A named colour from `MAKEUP_SHADES[region]` (sets `color`), `"auto"`
22
+ * where supported (from the person's own colouring; `color` is the
23
+ * fallback until it is measured) or `"custom"` (`color` as given).
24
+ */
25
+ shade: MakeupShadeSetting<R>;
26
+ /** CSS colour. An explicit colour that differs from the shade wins and the shade becomes `"custom"`. */
27
+ color: string;
28
+ /** Linear amount, 0..1: 0.8 renders 80 %. */
29
+ opacity: number;
30
+ /** 0 = sheer (filters the person's own colour, never lightens), 1 = opaque (covers the skin). */
31
+ coverage: number;
32
+ /** How the product reflects light. Choosing a finish sets `shine` and the sparkle fields. */
33
+ finish: MakeupFinish;
34
+ /** Strength of the finish highlight, 0..1. */
35
+ shine: number;
36
+ /** Flake colour for `shimmer` / `glitter`; `""` derives it from the shade. */
37
+ sparkleColor: string;
38
+ /** Flake density, 0..1 (`shimmer` and `glitter` only). */
39
+ sparkleDensity: number;
40
+ /** Flake size in millimetres, 0.1..1.5. */
41
+ sparkleSize: number;
42
+ /** Edge feather, 0..1. */
43
+ softness: number;
44
+ /** The person's own side(s) to paint, on every feed. */
45
+ side: MakeupSide;
46
+ };
47
+ export type BlushSettings = MakeupRegionSettings<"blush"> & {
48
+ /** Scale of the placement, 0.5..1.5. */
49
+ size: number;
50
+ /** −1..1: 0 sits on the cheek, positive lifts toward the temple, negative drops toward the apples. */
51
+ lift: number;
52
+ };
53
+ export type ContourSettings = MakeupRegionSettings<"contour"> & {
54
+ /** Scale of the placement, 0.5..1.5. */
55
+ size: number;
56
+ };
57
+ export type HighlighterSettings = MakeupRegionSettings<"highlighter"> & {
58
+ /** Scale of the placement, 0.5..1.5. */
59
+ size: number;
60
+ };
61
+ export type EyeshadowSettings = MakeupRegionSettings<"eyeshadow"> & {
62
+ /** How far the lid colour reaches, 0..1: lash line (0) to brow (1). */
63
+ height: number;
64
+ /** Strength of the crease band, 0..1. */
65
+ crease: number;
66
+ /** Crease colour by name; `creaseColor` wins when it differs. */
67
+ creaseShade: MakeupShadeSetting<"eyeshadow">;
68
+ creaseColor: string;
69
+ /** Shadow along the lower lash line, 0..1. */
70
+ lower: number;
71
+ /** Inner-corner highlight, 0..1. */
72
+ inner: number;
73
+ /** Inner-corner colour by name; `innerColor` wins when it differs. */
74
+ innerShade: MakeupShadeSetting<"eyeshadow">;
75
+ innerColor: string;
76
+ };
77
+ export type EyelinerSettings = MakeupRegionSettings<"eyeliner"> & {
78
+ /** Line width at its thickest, in millimetres, 0.2..4. */
79
+ thickness: number;
80
+ /** Wing length past the outer corner, in millimetres, 0..15. */
81
+ wing: number;
82
+ /** Wing angle in degrees, 0..45, upward in the person's frame. */
83
+ wingAngle: number;
84
+ /** Lower lash line, 0..1 (fades while blinking). */
85
+ lower: number;
86
+ /** Softens and widens the line, 0..1. */
87
+ smudge: number;
88
+ };
89
+ export type BrowsSettings = MakeupRegionSettings<"brows"> & {
90
+ /** 0..1; 0.5 follows the person's own brow, higher is thicker and darker. */
91
+ boldness: number;
92
+ /** 0 tints only the real hairs, 1 fills a full powder shape. */
93
+ fill: number;
94
+ /** Procedural hair strokes, 0..1. */
95
+ strokes: number;
96
+ };
97
+ /** Settings per region: `MakeupSettings["blush"]` is `BlushSettings`, lips are `LipEffectSettings`. */
98
+ export type MakeupSettings = {
99
+ lips: LipEffectSettings;
100
+ contour: ContourSettings;
101
+ blush: BlushSettings;
102
+ highlighter: HighlighterSettings;
103
+ eyeshadow: EyeshadowSettings;
104
+ eyeliner: EyelinerSettings;
105
+ brows: BrowsSettings;
106
+ };
107
+ /** Partial settings per region, as looks and overrides carry them. */
108
+ export type MakeupSettingsInput = {
109
+ [R in MakeupRegion]?: Partial<MakeupSettings[R]>;
110
+ };
@@ -0,0 +1,40 @@
1
+ import { FaceSkinQuality } from '../../face-atlas/probe/constants';
2
+ import { MakeupSkinTone } from './skinTone';
3
+ export type UseMakeupSkinToneOptions = {
4
+ /** Which tracked face. Default: the nearest `FaceRig` / `FaceTracker`'s face, else 0. */
5
+ faceIndex?: number;
6
+ /** Faces to start the face model with when this starts it (no `FaceTracker` above). */
7
+ numFaces?: number;
8
+ /**
9
+ * Milliseconds between reads of the probe, at least
10
+ * `MAKEUP_SKIN_TONE.minReadbackMs` (200). Default 500 (two reads a second).
11
+ */
12
+ intervalMs?: number;
13
+ /** Shades recommended per region. Default 3. */
14
+ count?: number;
15
+ /** The skin probe's quality (`useFaceSkin`). Default `"auto"`. */
16
+ quality?: FaceSkinQuality;
17
+ /** `false` stops reading and releases the probe. Default true. */
18
+ enabled?: boolean;
19
+ };
20
+ /**
21
+ * The person's skin tone for shade-finder UIs: skin depth (`fair` … `rich`),
22
+ * undertone (`cool`, `neutral`, `warm`), the measured skin, lip and brow
23
+ * colours, and the curated palette shades nearest what each region would
24
+ * paint on them (`MakeupSkinTone`). `null` until the face's skin probe has
25
+ * settled.
26
+ *
27
+ * It reads the shared skin probe of the face (the one makeup uses; it starts
28
+ * one if none runs) back from the GPU without stalling it, at most every
29
+ * `intervalMs` (default 500 ms), and re-renders only when the readout
30
+ * changes. Works alone (it starts the face model when no `FaceTracker` is
31
+ * above). The camera's white balance moves the undertone and its exposure
32
+ * the depth: it describes the image, not the person, so offer it as a
33
+ * suggestion, never a label.
34
+ *
35
+ * ```tsx
36
+ * const tone = useMakeupSkinTone();
37
+ * <Blush shade={tone?.recommendations.blush[0] ?? "rose"} />
38
+ * ```
39
+ */
40
+ export declare const useMakeupSkinTone: (options?: UseMakeupSkinToneOptions) => MakeupSkinTone | null;
@@ -0,0 +1,44 @@
1
+ import { ReactNode } from 'react';
2
+ import { SpringSwingOptions } from '../../spring/swing';
3
+ import { CanonicalOffset } from '../HeadOccluder/useLandmarkPoseFit';
4
+ import { CanonicalTorsoFitOptions } from '../ShoulderOccluder/useCanonicalTorsoFit';
5
+ import type * as THREE from "three";
6
+ /** Nodes whose name contains one of these swing (`*_pendant`, `*_charm`). */
7
+ export declare const NECKLACE_SWING_NODES: readonly string[];
8
+ /** A pendant lies on the chest: it swings less far than an earring. */
9
+ export declare const NECKLACE_SWING_DEFAULTS: Readonly<SpringSwingOptions>;
10
+ export type NecklaceProps = Omit<CanonicalTorsoFitOptions, "offset"> & {
11
+ /**
12
+ * The necklace, authored in the torso frame: centimetres, origin between
13
+ * the shoulder joints, +X screen right, +Y up, +Z toward the camera, the
14
+ * chain on the neck base and upper chest. A pendant is a child node named
15
+ * `…pendant…` (or `…charm…`) with its origin on its bail. Cloned, so pass a
16
+ * loaded GLB's scene (or one of its nodes) as it is.
17
+ */
18
+ model?: THREE.Object3D | null;
19
+ /** JSX in the same frame (it does not swing). */
20
+ children?: ReactNode;
21
+ /**
22
+ * The pendants swing on a spring about their bail as the body moves, then
23
+ * settle: `true` (default) for the gentle default, `SpringSwingOptions`, or
24
+ * `false` (rigid). They hang along the torso's own down.
25
+ */
26
+ swing?: boolean | SpringSwingOptions;
27
+ /** Name parts of the nodes that swing. Default `NECKLACE_SWING_NODES`. */
28
+ swingNodes?: readonly string[];
29
+ /** Hide the chain behind the neck and shoulders (a `ShoulderOccluder`). Default true. */
30
+ occluder?: boolean;
31
+ /** The occluder's mesh (`ShoulderOccluder` `url`); default the SDK's CDN copy. */
32
+ occluderUrl?: string;
33
+ /** Nudge on top of the fit, in torso centimetres. */
34
+ offset?: CanonicalOffset;
35
+ };
36
+ /**
37
+ * A necklace on a tracked body: the chain sits on the neck base and upper
38
+ * chest (the canonical torso fit), its pendants swing, and the shoulder
39
+ * occluder hides the chain behind the neck. Inside a `BodyTracker` it uses
40
+ * that body; anywhere else it tracks the body itself (`bodyIndex`). Hidden
41
+ * while the body is lost. Under a `HeadOccluder` (a `HeadBinding`) the chin
42
+ * hides the chain behind it too.
43
+ */
44
+ export declare const Necklace: ({ model, children, swing, swingNodes, occluder, occluderUrl, offset, bodyIndex, ...fit }: NecklaceProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1 @@
1
+ export { NECKLACE_SWING_DEFAULTS, NECKLACE_SWING_NODES, Necklace, type NecklaceProps, } from './Necklace';
@@ -0,0 +1,69 @@
1
+ import { Euler, Vector3 } from '@react-three/fiber';
2
+ import { ReactNode } from 'react';
3
+ import { ParticleEmitterTarget } from '../../particles/eyes';
4
+ import { ParticlePreset } from '../../particles/presets';
5
+ import { ParticleSettings } from '../../particles/settings';
6
+ import { ParticleSystem } from '../../particles/system';
7
+ import type * as THREE from "three";
8
+ export type ParticleEmitterProps = Partial<ParticleSettings> & {
9
+ /** A built-in look the other settings go on top of (`PARTICLE_PRESETS`). */
10
+ preset?: ParticlePreset;
11
+ /**
12
+ * Emit from the person's own left eye, right eye, or both (two emitters),
13
+ * straight out of the face. `position`, `rotation` and `scale` then apply
14
+ * about the eye, in the head's centimetres. Inside a `FaceTracker` it
15
+ * follows that tracker's face; anywhere else it tracks the face itself.
16
+ */
17
+ target?: ParticleEmitterTarget;
18
+ /** With `target`: the face (default: the enclosing `FaceTracker`'s, else 0). */
19
+ faceIndex?: number;
20
+ /** With `target` and no enclosing `FaceTracker`: faces the face model tracks when this starts it. */
21
+ numFaces?: number;
22
+ /** New particles keep coming. False stops emitting; the particles already out live on. Default true. */
23
+ emitting?: boolean;
24
+ /** The particles' render order (they draw in the transparent pass). Default 0. */
25
+ renderOrder?: number;
26
+ /** The emitter's place in its parent (its +Z is forward). */
27
+ position?: Vector3;
28
+ rotation?: Euler;
29
+ scale?: Vector3;
30
+ /** Called with each emitter's `ParticleSystem` when it is made, and with null when it goes. */
31
+ onSystem?: (system: ParticleSystem | null) => void;
32
+ children?: ReactNode;
33
+ };
34
+ /**
35
+ * Emits particles from where it is: put it anywhere in the scene, inside a
36
+ * tracker to follow a face or a hand, or give it a `target` (the eyes).
37
+ * Particles are drawn in world space and keep their own path once out; they
38
+ * live on when the emitter stops or its tracker hides (it emits only while
39
+ * shown). Settings are props (any subset of `ParticleSettings`, over a
40
+ * `preset`), in the emitter's units: inside a head frame (and with
41
+ * `target`), centimetres. The ref is the emitter's group (with two eyes, the
42
+ * person's left one).
43
+ */
44
+ export declare const ParticleEmitter: import('react').ForwardRefExoticComponent<Partial<ParticleSettings> & {
45
+ /** A built-in look the other settings go on top of (`PARTICLE_PRESETS`). */
46
+ preset?: ParticlePreset;
47
+ /**
48
+ * Emit from the person's own left eye, right eye, or both (two emitters),
49
+ * straight out of the face. `position`, `rotation` and `scale` then apply
50
+ * about the eye, in the head's centimetres. Inside a `FaceTracker` it
51
+ * follows that tracker's face; anywhere else it tracks the face itself.
52
+ */
53
+ target?: ParticleEmitterTarget;
54
+ /** With `target`: the face (default: the enclosing `FaceTracker`'s, else 0). */
55
+ faceIndex?: number;
56
+ /** With `target` and no enclosing `FaceTracker`: faces the face model tracks when this starts it. */
57
+ numFaces?: number;
58
+ /** New particles keep coming. False stops emitting; the particles already out live on. Default true. */
59
+ emitting?: boolean;
60
+ /** The particles' render order (they draw in the transparent pass). Default 0. */
61
+ renderOrder?: number;
62
+ /** The emitter's place in its parent (its +Z is forward). */
63
+ position?: Vector3;
64
+ rotation?: Euler;
65
+ scale?: Vector3;
66
+ /** Called with each emitter's `ParticleSystem` when it is made, and with null when it goes. */
67
+ onSystem?: (system: ParticleSystem | null) => void;
68
+ children?: ReactNode;
69
+ } & import('react').RefAttributes<THREE.Group<THREE.Object3DEventMap>>>;
@@ -0,0 +1 @@
1
+ export { ParticleEmitter, type ParticleEmitterProps } from './ParticleEmitter';
@@ -0,0 +1,50 @@
1
+ import { ScreenImageProps } from '../ScreenImage/types';
2
+ import { PersonCutoutFallback, PersonCutoutStatus } from './personCutout';
3
+ import type * as THREE from "three";
4
+ export type { PersonCutoutFallback, PersonCutoutStatus } from './personCutout';
5
+ export { FULL_SCREEN_ANCHORS, resolvePersonCutoutStatus, shouldDrawFallback } from './personCutout';
6
+ export type PersonMaskTextureResult = {
7
+ /**
8
+ * The portrait segmentation mask in feed space. The signal is in RGB:
9
+ * white (255) on the person, black (0) on the background, alpha 255
10
+ * everywhere (measured; three's `alphaMap` reads green, which is how
11
+ * `VideoBackground` consumes it).
12
+ */
13
+ texture: THREE.Texture | null;
14
+ status: PersonCutoutStatus;
15
+ error: Error | null;
16
+ };
17
+ /**
18
+ * The portrait segmentation mask as a texture, with the model's lifecycle.
19
+ * Acquires the segmentation model itself. The mask lives in feed space, like
20
+ * the camera texture; read its green channel: 255 on the person, 0 elsewhere.
21
+ */
22
+ export declare const usePersonMaskTexture: (active?: boolean) => PersonMaskTextureResult;
23
+ export type PersonCutoutProps = Omit<ScreenImageProps, "source" | "src" | "maskTexture" | "maskChannel" | "maskInvert"> & {
24
+ /** Edge softening as a 3×3 blur radius in mask texels. Default 4; 0 = hard edge. */
25
+ maskFeather?: number;
26
+ /**
27
+ * Shrink the kept silhouette into the feathered edge (0..1 of the feather
28
+ * width) so background fringe from the segmenter is trimmed. Default 0.7.
29
+ */
30
+ maskErode?: number;
31
+ /** Show the background only (cut the person out) instead of the person only. */
32
+ invert?: boolean;
33
+ /**
34
+ * What to draw while the segmentation model is loading or has failed:
35
+ * the unmasked camera (default, the experience degrades to a plain feed)
36
+ * or nothing.
37
+ */
38
+ fallback?: PersonCutoutFallback;
39
+ /** Keep the segmentation model running. Default true. */
40
+ active?: boolean;
41
+ onStatusChange?: (status: PersonCutoutStatus, error: Error | null) => void;
42
+ };
43
+ /**
44
+ * The live camera, masked to the person, as a full-screen `ScreenImage`.
45
+ * Place any `ScreenImage` (image, video, GIF) or shader surface behind it
46
+ * with a lower `renderOrder` for background replacement. The camera texture is
47
+ * already cover-cropped and webcam-mirrored by the session, and the mask is in
48
+ * that same space, so no coordinate work is needed.
49
+ */
50
+ export declare const PersonCutout: ({ invert, fallback, active, onStatusChange, fit, anchors, renderOrder, visible, maskFeather, maskErode, ...screenImageProps }: PersonCutoutProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,16 @@
1
+ import { ScreenAnchorEdges } from '../ScreenSpaceUI';
2
+ /** Anchors that stretch a screen element over the whole viewport. */
3
+ export declare const FULL_SCREEN_ANCHORS: ScreenAnchorEdges;
4
+ export type PersonCutoutStatus = "loading" | "ready" | "error";
5
+ /**
6
+ * Status of a person cut-out from the segmentation model's lifecycle and
7
+ * whether its mask texture exists yet.
8
+ */
9
+ export declare const resolvePersonCutoutStatus: ({ ready, error, hasMask, }: {
10
+ ready: boolean;
11
+ error: Error | null;
12
+ hasMask: boolean;
13
+ }) => PersonCutoutStatus;
14
+ export type PersonCutoutFallback = "camera" | "hidden";
15
+ /** Whether the camera layer should draw while the mask is not available. */
16
+ export declare const shouldDrawFallback: (status: PersonCutoutStatus, fallback: PersonCutoutFallback) => boolean;
@@ -5,5 +5,5 @@ type ScreenImageBodyProps = Omit<ScreenImageProps, "anchors" | "coordinateSpace"
5
5
  height: number;
6
6
  };
7
7
  };
8
- export declare function ScreenImageBody({ name, source, src, fit, stretchMode, materialType, blendMode, backdropTexture: providedBackdropTexture, rotation, opacity, color, flipX, flipY, renderOrder, transparent, alphaTest, overlay, visible, layoutSize, }: ScreenImageBodyProps): import("react/jsx-runtime").JSX.Element;
8
+ export declare function ScreenImageBody({ name, source, src, fit, stretchMode, materialType, blendMode, backdropTexture: providedBackdropTexture, rotation, opacity, color, maskTexture, maskChannel, maskInvert, maskFeather, maskErode, flipX, flipY, renderOrder, transparent, alphaTest, overlay, visible, layoutSize, }: ScreenImageBodyProps): import("react/jsx-runtime").JSX.Element;
9
9
  export {};