@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,20 @@
1
+ import { Transform3DSettings } from '../Transform3D';
2
+ export type LightType = "ambient" | "directional" | "point" | "spot";
3
+ export type LightSettings = {
4
+ enabled: boolean;
5
+ type: LightType;
6
+ color: string;
7
+ intensity: number;
8
+ castShadow: boolean;
9
+ distance: number;
10
+ angle: number;
11
+ penumbra: number;
12
+ decay: number;
13
+ showHelper: boolean;
14
+ };
15
+ export declare const DEFAULT_LIGHT_SETTINGS: LightSettings;
16
+ export type LightObjectProps = {
17
+ settings: LightSettings;
18
+ transform: Transform3DSettings;
19
+ };
20
+ export declare const LightObject: ({ settings, transform }: LightObjectProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,28 @@
1
+ import { LipEffectProps } from './types';
2
+ import * as THREE from "three";
3
+ /**
4
+ * `outer-and-inner-lips` paints only the lip surface: the mouth interior
5
+ * writes the mouth stencil bit and the lip material skips those pixels.
6
+ * `outer-lips` paints everything inside the outer lip ring, interior included.
7
+ */
8
+ export declare const shouldWriteMouthStencil: (maskMode: LipEffectProps["maskMode"]) => boolean;
9
+ export declare const getLipEffectMouthStencilMaterial: () => THREE.MeshBasicMaterial;
10
+ /**
11
+ * Whether the lip layers keep the `faceUv` attribute current: the `faceUv`
12
+ * prop when given, else only for a custom (not built-in) `material` or
13
+ * `sharedMaterial`. The built-in material never reads it.
14
+ */
15
+ export declare const lipEffectWantsFaceUv: ({ faceUv, material, sharedMaterial, }: Pick<LipEffectProps, "faceUv" | "material" | "sharedMaterial">) => boolean;
16
+ /**
17
+ * Lipstick, gloss, tint, shimmer, glitter or a painted design on the lips of
18
+ * a tracked face, shaded against the person's own skin and light by the
19
+ * makeup core. It draws two `FaceAtlasLayer`s on the face's shared surface:
20
+ * the mouth interior (the stencil cut-out, or painted in `outer-lips` mode)
21
+ * and the lips, at `MAKEUP_RENDER_ORDER.lips`.
22
+ *
23
+ * It works alone (it starts the face model itself; no `FaceTracker`
24
+ * needed), inside a `FaceTracker` (that face), or nested in a `FaceRig` /
25
+ * `FaceWarp3D` / `FaceMorph` (it rides that face). Its design textures load
26
+ * through R3F's `useLoader`, so keep it under a `<Suspense>`, as in alpha.8.
27
+ */
28
+ export declare const LipEffect: ({ faceIndex, numFaces, mirrored, designTexture, lowerDesignTexture, material, sharedMaterial, faceUv, holdMs, renderOrder, ...settingsInput }: LipEffectProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,98 @@
1
+ import { LipEffectSettings } from './settings';
2
+ import { LipEffectMaterialContext } from './types';
3
+ import { LipUvBounds } from './uvGuide';
4
+ import * as THREE from "three";
5
+ export { LIP_EFFECT_FRAGMENT_SHADER, LIP_EFFECT_SKIN_STATS_DEFINE, LIP_EFFECT_VERTEX_SHADER, } from './shader';
6
+ /** Everything the built-in lip material reads. */
7
+ export type LipEffectMaterialInputs = Pick<LipEffectMaterialContext, "cameraTexture" | "designTexture"> & {
8
+ settings: LipEffectSettings;
9
+ /** Lower-lip design texture, used when `settings.splitLips` is on. */
10
+ lowerDesignTexture?: THREE.Texture | null;
11
+ /** Lip region of the face atlas; defaults to the atlas's own (`getLipUvBounds()`). */
12
+ lipUvBounds?: LipUvBounds;
13
+ /** Skip pixels the mouth-interior stencil marked (see `LipEffect` mask modes). */
14
+ subtractMouth?: boolean;
15
+ /**
16
+ * `personLeftSign(mirrored)`: −1 on the mirrored webcam flips the design so
17
+ * it keeps the person's sides. Inside a `LipEffect` the layer's own sign is
18
+ * used at draw time; this is the value outside one. Default 1.
19
+ */
20
+ personLeftSign?: 1 | -1;
21
+ };
22
+ export type LipEffectMaterialProps = LipEffectMaterialInputs;
23
+ type Uniform<T> = THREE.IUniform<T>;
24
+ /**
25
+ * Whether the shader decodes a design texture's sRGB itself (1) or reads it
26
+ * as linear (0); use the same rule in a custom lip shader. A texture tagged `SRGBColorSpace` is decoded by the GPU, a
27
+ * linear one or a render target's is used as is; anything else (an image,
28
+ * canvas or video loaded without a colour space, as `TextureLoader` leaves
29
+ * it) is taken as authored sRGB. Cached textures are never re-tagged.
30
+ */
31
+ export declare const lipEffectDesignDecode: (texture: THREE.Texture) => 0 | 1;
32
+ /**
33
+ * One face's per-draw values for a built-in lip material: the layer's
34
+ * uniforms (camera, presence, side sign), the face's skin probe and the
35
+ * sparkle quality of the tier. A shared material (`LipEffects`,
36
+ * `sharedMaterial`) draws several faces; it copies the face of each draw's
37
+ * geometry in `onBeforeRender`.
38
+ */
39
+ export type LipEffectFaceBinding = {
40
+ layer: {
41
+ uCameraMap: Uniform<THREE.Texture | null>;
42
+ uPresence: Uniform<number>;
43
+ uPersonLeftSign: Uniform<number>;
44
+ };
45
+ skin: {
46
+ uSkinMap: Uniform<THREE.Texture | null>;
47
+ uSkinLod: Uniform<number>;
48
+ uSkinSqrt: Uniform<number>;
49
+ uSkinStats: Uniform<THREE.Texture | null>;
50
+ uSkinStatsPacked: Uniform<number>;
51
+ };
52
+ sparkleQuality: Uniform<number>;
53
+ };
54
+ /** Ties a lip layer geometry to its face (internal: `LipEffect` binds each layer it draws). */
55
+ export declare const bindLipEffectFace: (geometry: THREE.BufferGeometry, binding: LipEffectFaceBinding) => void;
56
+ /** Copies the bound face's per-draw values into a built-in lip material. Returns whether one was bound. */
57
+ export declare const applyLipEffectFaceBinding: (material: THREE.ShaderMaterial, geometry: THREE.BufferGeometry) => boolean;
58
+ /** Whether `material` is a built-in lip material (`createLipEffectMaterial`). */
59
+ export declare const isLipEffectMaterial: (material: unknown) => material is THREE.ShaderMaterial;
60
+ /**
61
+ * Create the built-in lip material as a plain three.js object. Pair it with
62
+ * `updateLipEffectMaterial`, or let `useLipEffectMaterial` own it. One
63
+ * material can be shared by several faces and lip layers: each draw reads
64
+ * its own face (presence, skin probe, side sign).
65
+ *
66
+ * It draws `LipEffect`'s face-atlas layers (`LipEffect` binds each draw to
67
+ * its face; elsewhere it would not fade, shade or flip): opaque pass,
68
+ * premultiplied over (`MAKEUP_BLENDING`), depth-tested without depth writes,
69
+ * and the mouth stencil test on bit `FACE_ATLAS_STENCIL.mouth` only.
70
+ */
71
+ export declare const createLipEffectMaterial: () => THREE.ShaderMaterial;
72
+ /** Push the current inputs into a material made by `createLipEffectMaterial`. */
73
+ export declare const updateLipEffectMaterial: (material: THREE.ShaderMaterial, { cameraTexture, designTexture, lowerDesignTexture, settings, lipUvBounds, subtractMouth, personLeftSign, }: LipEffectMaterialInputs) => THREE.ShaderMaterial;
74
+ /**
75
+ * Like `useLipEffectMaterial`, but allocates nothing while `enabled` is false.
76
+ * Lets a component keep a constant hook order without paying for materials it
77
+ * will not render (for example when a shared or custom material is supplied).
78
+ */
79
+ export declare const useOptionalLipEffectMaterial: (inputs: LipEffectMaterialInputs, enabled: boolean) => THREE.ShaderMaterial | null;
80
+ /**
81
+ * Own one built-in lip material for the component's lifetime and keep it in
82
+ * sync with the inputs on every render. Pass the result to `LipEffect`'s
83
+ * `sharedMaterial` or return it from a `material` factory. It reads its face
84
+ * (presence fade, skin probe, side sign) only where `LipEffect` /
85
+ * `LipEffects` draw it; on another mesh it would draw unfaded, unshaded and
86
+ * unflipped.
87
+ */
88
+ export declare const useLipEffectMaterial: (inputs: LipEffectMaterialInputs) => THREE.ShaderMaterial;
89
+ /**
90
+ * The built-in lip material as a React node: the design texture (face
91
+ * atlas) or a procedural fill, tinted per lip, with gradient, inner-lip tint
92
+ * and feathered edge, shaded by the makeup core against the person's own
93
+ * skin and light (finish, coverage, `shading`), plus the extra lip
94
+ * highlight. Transparent design pixels leave the skin untouched.
95
+ *
96
+ * Each instance owns its own material; use `useLipEffectMaterial` to share one.
97
+ */
98
+ export declare const LipEffectMaterial: (props: LipEffectMaterialProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,12 @@
1
+ import { LipEffectFaceConfig, LipEffectsProps } from './types';
2
+ /** The config `LipEffects` uses for one face, or `null` to skip that face. */
3
+ export declare const resolveLipEffectFaceConfig: (faces: LipEffectsProps["faces"], faceIndex: number) => LipEffectFaceConfig | null;
4
+ /**
5
+ * Lip effects for several tracked faces at once. Pass one config for every
6
+ * face, or a function that picks settings, textures or a material per face.
7
+ * With a single config the faces share one built-in material by default:
8
+ * each draw still reads its own face (presence, skin probe, side sign).
9
+ * Without a `FaceTracker` above, the lips start the face model with
10
+ * `maxFaces` faces.
11
+ */
12
+ export declare const LipEffects: ({ maxFaces, faces, shareMaterial, holdMs, renderOrder, }: LipEffectsProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Default draw order of `LipEffect`: `MAKEUP_RENDER_ORDER.lips` (-1.64), the
3
+ * last makeup layer of the opaque face layer, so hands (`HandCutout`), the
4
+ * head occluder, glasses and accessories draw over the lips. alpha.8 drew
5
+ * them transparent at 30.
6
+ */
7
+ export declare const DEFAULT_LIP_EFFECT_RENDER_ORDER: -1.64;
8
+ /**
9
+ * How far before the lips the mouth layer draws: in `outer-and-inner-lips`
10
+ * mode it writes the mouth stencil bit the lips then test.
11
+ */
12
+ export declare const LIP_EFFECT_MOUTH_ORDER_OFFSET = 0.001;
13
+ /** Complete defaults: the serializable settings plus the render order. */
14
+ export declare const DEFAULT_LIP_EFFECT: {
15
+ renderOrder: -1.64;
16
+ enabled: boolean;
17
+ preset: import('./settings').LipEffectPreset;
18
+ shade: import('../Makeup').MakeupShadeSetting<"lips">;
19
+ maskMode: import('./types').LipMaskMode;
20
+ colorMode: import('./settings').LipEffectColorMode;
21
+ color: string;
22
+ opacity: number;
23
+ coverage: number;
24
+ finish: import('../Makeup').MakeupFinish;
25
+ shine: number;
26
+ sparkleColor: string;
27
+ sparkleDensity: number;
28
+ sparkleSize: number;
29
+ intensity: number;
30
+ shading: number;
31
+ gloss: number;
32
+ roughness: number;
33
+ highlightColor: string;
34
+ gradientColor: string;
35
+ gradientAmount: number;
36
+ gradientDirection: import('./settings').LipEffectGradientDirection;
37
+ edgeSoftness: number;
38
+ innerLipColor: string;
39
+ innerLipAmount: number;
40
+ innerLipWidth: number;
41
+ splitLips: boolean;
42
+ lowerLipColor: string;
43
+ lowerLipOpacity: number;
44
+ textureScaleX: number;
45
+ textureScaleY: number;
46
+ textureOffsetX: number;
47
+ textureOffsetY: number;
48
+ textureRotation: number;
49
+ textureFlipX: boolean;
50
+ textureFlipY: boolean;
51
+ };
@@ -0,0 +1,12 @@
1
+ export { LipEffect } from './LipEffect';
2
+ export { LipEffects, resolveLipEffectFaceConfig } from './LipEffects';
3
+ export { LIP_EFFECT_FRAGMENT_SHADER, LIP_EFFECT_VERTEX_SHADER, LipEffectMaterial, createLipEffectMaterial, lipEffectDesignDecode, updateLipEffectMaterial, useLipEffectMaterial, } from './LipEffectMaterial';
4
+ export type { LipEffectMaterialInputs, LipEffectMaterialProps } from './LipEffectMaterial';
5
+ export { useLipDesignTextures } from './useLipDesignTextures';
6
+ export type { LipDesignTextureSource } from './useLipDesignTextures';
7
+ export { DEFAULT_LIP_EFFECT, DEFAULT_LIP_EFFECT_RENDER_ORDER } from './defaults';
8
+ export { DEFAULT_LIP_EFFECT_SETTINGS, LIP_EFFECT_COLOR_MODES, LIP_EFFECT_GRADIENT_DIRECTIONS, LIP_EFFECT_PRESETS, LIP_EFFECT_PRESET_KEYS, LIP_EFFECT_SETTINGS_FIELDS, createLipTextureTransform, isLipEffectPresetKey, patchLipEffectSettings, resolveLipEffectSettings, } from './settings';
9
+ export type { LipEffectColorMode, LipEffectGradientDirection, LipEffectPreset, LipEffectPresetKey, LipEffectSettings, } from './settings';
10
+ export { CANONICAL_LIP_UV_BOUNDS, LIP_UV_GUIDE_COLORS, createLipUvGuideDataUrl, createLipUvGuidePngBlob, createLipUvGuideSvg, getLipUvBounds, lipUvToPixel, } from './uvGuide';
11
+ export type { LipUvBounds, LipUvGuideOptions } from './uvGuide';
12
+ export type { LipEffectFaceConfig, LipEffectMaterialContext, LipEffectMaterialResult, LipEffectMaterialSpec, LipEffectProps, LipEffectsProps, LipMaskMode, } from './types';
@@ -0,0 +1,73 @@
1
+ import { MakeupSkin, Vec3 } from '../../face-atlas/shading';
2
+ import { LipEffectSettings } from './settings';
3
+ /**
4
+ * The lip-specific part of the built-in lip shader, as constants the GLSL is
5
+ * generated from and a TypeScript mirror of each step (tests and docs). The
6
+ * rest of the shading is the makeup core (`lib/face-atlas/shading.ts`).
7
+ */
8
+ export declare const LIP_EFFECT_SHADING: Readonly<{
9
+ /** Half-width (atlas v) of the blend between the upper and lower lip at the mouth line. */
10
+ readonly seam: 0.004;
11
+ /** The extra lip highlight (`gloss`): Blinn-Phong exponent at `roughness` 0 … 1 (alpha.8's). */
12
+ readonly highlightSharp: 96;
13
+ readonly highlightBroad: 4;
14
+ /** `shading` at or above this follows the light fully (no flattening work in the shader). */
15
+ readonly fullShading: 0.999;
16
+ }>;
17
+ /** The opacity uniforms: `uOpacity` and the per-lip amounts `uLipOpacity = (upper, lower)`. */
18
+ export type LipEffectOpacity = {
19
+ /** `uOpacity`: the larger of the two lips' opacities (the finish's gate reads it). */
20
+ opacity: number;
21
+ /** The upper lip's opacity (both lips without `splitLips`), linear. */
22
+ upper: number;
23
+ /** The lower lip's opacity (`lowerLipOpacity` with `splitLips`), linear. */
24
+ lower: number;
25
+ };
26
+ /**
27
+ * Opacity is linear: 0.8 paints 80 % of the product. With `splitLips` the
28
+ * lower lip has its own amount; the shader scales the lip's mask by
29
+ * `lipOpacity / uOpacity`, so each lip's amount is exact and the finish's
30
+ * gloss and glitter terms keep their opacity gate.
31
+ */
32
+ export declare const resolveLipEffectOpacity: (settings: Pick<LipEffectSettings, "opacity" | "splitLips" | "lowerLipOpacity">) => LipEffectOpacity;
33
+ /** 1 on the upper lip, 0 on the lower, blended over `seam` at the mouth line (atlas v). */
34
+ export declare const lipEffectUpperWeight: (v: number, mouthLineV: number) => number;
35
+ /**
36
+ * The mask scale of one fragment: its lip's opacity relative to `uOpacity`,
37
+ * so `mask · fade · uOpacity` (the finish's amount) is that lip's opacity.
38
+ */
39
+ export declare const lipEffectMaskScale: (upperWeight: number, opacity: LipEffectOpacity) => number;
40
+ /**
41
+ * Where a lip fragment samples the design (before the texture transform).
42
+ * Designs are painted as on an unmirrored photo: image-left is the person's
43
+ * right. On the mirrored webcam (`personLeftSign` −1) the person's sides sit
44
+ * at the other atlas side, so the design is read at `(1 − u, v)`; the atlas
45
+ * is symmetric, so this is exact.
46
+ */
47
+ export declare const lipEffectDesignUv: (u: number, v: number, personLeftSign: number) => [number, number];
48
+ /** The extra lip highlight's Blinn-Phong exponent for `roughness` (0 tight … 1 broad). */
49
+ export declare const lipEffectHighlightExponent: (roughness: number) => number;
50
+ /**
51
+ * Lips are darker and redder than the skin, so measured against the skin
52
+ * (`Rs`) their own colour would read as shadow and darken an opaque shade.
53
+ * The lip shader re-bases the light terms on the person's own lip colour
54
+ * (the probe's settled lip average, `lipStat`): `Rs' = lip`, so
55
+ * `S = lum(C) / lum(lip)` (1 on the average lip under the settled light);
56
+ * the local low-pass `L` is scaled by `lum(lip) / lum(Rs)`, so the local
57
+ * light level is unchanged and the camera highlight is measured above the
58
+ * lip's level; `Rf` keeps its light colour relative to the new reference.
59
+ * Until the probe has a lip colour (`ready`, or no lip seen) the sample is
60
+ * unchanged. Mirrors GLSL `lipReferenceSample`.
61
+ */
62
+ export declare const lipEffectReferenceSample: <T extends MakeupSkin>(sample: T, lipStat: Vec3, ready: number) => T;
63
+ /**
64
+ * `shading` (0..1): how much of the camera's light the paint follows.
65
+ * 1 is the full skin-relative shading (`S = lum(C) / lum(Rs)`, the local
66
+ * clip, the camera highlight, the light colour); lower values move the
67
+ * skin references toward this pixel's own light, so at 0 the paint shows
68
+ * the shade as picked, with no camera highlight and no colour cast. The
69
+ * finish's own highlights stay. Mirrors GLSL `lipShadingSample`: the light
70
+ * terms of the result (`makeupLighting`) are `S' = mix(1, S, t)`,
71
+ * `local' = mix(1, local, t)`, `lightTint' = mix(1, lightTint, t)`.
72
+ */
73
+ export declare const lipEffectShadingSample: <T extends MakeupSkin>(sample: T, shading: number) => T;
@@ -0,0 +1,375 @@
1
+ import { MakeupFinish } from '../Makeup/constants';
2
+ import { MakeupShadeSetting } from '../Makeup/shades';
3
+ import { LipMaskMode } from './types';
4
+ import { LipUvBounds } from './uvGuide';
5
+ import * as THREE from "three";
6
+ export declare const LIP_EFFECT_PRESET_KEYS: readonly ["lipstick", "gloss", "matte", "tint", "metallic", "gradient", "shimmer", "glitter"];
7
+ export type LipEffectPresetKey = (typeof LIP_EFFECT_PRESET_KEYS)[number];
8
+ export type LipEffectPreset = LipEffectPresetKey | "custom";
9
+ export declare const LIP_EFFECT_COLOR_MODES: readonly ["texture", "solid"];
10
+ /** `texture` samples the design texture when one is given; `solid` ignores it. */
11
+ export type LipEffectColorMode = (typeof LIP_EFFECT_COLOR_MODES)[number];
12
+ export declare const LIP_EFFECT_GRADIENT_DIRECTIONS: readonly ["outward", "vertical", "horizontal"];
13
+ /** `outward` runs from the mouth line to the outer edge; the others span the lip box. */
14
+ export type LipEffectGradientDirection = (typeof LIP_EFFECT_GRADIENT_DIRECTIONS)[number];
15
+ /**
16
+ * Serializable lip effect settings. Every field is a plain value so the set
17
+ * can live in a scene store and drive the `LipEffectSettingsPanel` directly.
18
+ *
19
+ * Texture transform fields act on the design texture around the lip region:
20
+ * scale is a multiplier, offset is a fraction of the lip region's size
21
+ * (`1` = one lip width / height), rotation is degrees counter-clockwise as
22
+ * seen on the face, and the flips mirror the design across the lip centre.
23
+ * The design and the transform keep the person's sides on every feed (the
24
+ * lip material flips the design on the mirrored webcam).
25
+ */
26
+ export type LipEffectSettings = {
27
+ /** `false` draws nothing. Looks use it for lips they leave bare. */
28
+ enabled: boolean;
29
+ preset: LipEffectPreset;
30
+ /**
31
+ * A named colour from `MAKEUP_SHADES.lips` (sets `color`), `"auto"` (the
32
+ * person's own lip colour, deepened; `color` is the fallback until it is
33
+ * measured) or `"custom"` (`color` as given). An explicit `color` that
34
+ * differs from the shade wins and the shade becomes `"custom"`.
35
+ */
36
+ shade: MakeupShadeSetting<"lips">;
37
+ maskMode: LipMaskMode;
38
+ /** `solid` paints procedurally (colour and gradient only), even if a design texture is set. */
39
+ colorMode: LipEffectColorMode;
40
+ /** Tint multiplied into the design (or the fill colour without a design texture). */
41
+ color: string;
42
+ opacity: number;
43
+ /** 0 = sheer (filters the person's own lip colour, never lightens), 1 = opaque (covers it). */
44
+ coverage: number;
45
+ /** How the lips reflect light. Choosing a finish sets `shine` and the sparkle fields. */
46
+ finish: MakeupFinish;
47
+ /** Strength of the finish highlight, 0..1. */
48
+ shine: number;
49
+ /** Flake colour for `shimmer` / `glitter`; `""` derives it from the shade. */
50
+ sparkleColor: string;
51
+ /** Flake density, 0..1 (`shimmer` and `glitter` only). */
52
+ sparkleDensity: number;
53
+ /** Flake size in millimetres, 0.1..1.5. */
54
+ sparkleSize: number;
55
+ /** 0 shows the design as painted, 1 multiplies it fully by `color`. */
56
+ intensity: number;
57
+ /**
58
+ * How much of the camera's light and shadow the paint follows, 0..1. 1 (the
59
+ * default) is the full skin-relative shading: the lips' own light and
60
+ * shadow, their real highlight and the light's colour. 0 flattens the
61
+ * opaque part: the shade as picked, with only the finish's own highlight.
62
+ * The sheer part (`coverage` below 1) still filters the live lips, so their
63
+ * own light and texture show through it; use `coverage: 1` for a fully
64
+ * flat fill.
65
+ */
66
+ shading: number;
67
+ /** Extra specular lip highlight on top of the finish. */
68
+ gloss: number;
69
+ /** Highlight spread: 0 = tight mirror-like, 1 = broad and soft. */
70
+ roughness: number;
71
+ highlightColor: string;
72
+ /** Second colour blended in towards the outer lip edge by `gradientAmount`. */
73
+ gradientColor: string;
74
+ gradientAmount: number;
75
+ gradientDirection: LipEffectGradientDirection;
76
+ /** Feather width at the outer lip boundary as a fraction of the lip band. 0 = hard edge. */
77
+ edgeSoftness: number;
78
+ /** Separate tint for the inner lip (and the mouth interior in `outer-lips` mode). */
79
+ innerLipColor: string;
80
+ innerLipAmount: number;
81
+ /** How far the inner tint reaches out from the mouth line, as a fraction of the band. */
82
+ innerLipWidth: number;
83
+ /** Give the lower lip its own colour, opacity and (via `lowerDesignTexture`) texture. */
84
+ splitLips: boolean;
85
+ lowerLipColor: string;
86
+ lowerLipOpacity: number;
87
+ textureScaleX: number;
88
+ textureScaleY: number;
89
+ textureOffsetX: number;
90
+ textureOffsetY: number;
91
+ textureRotation: number;
92
+ textureFlipX: boolean;
93
+ textureFlipY: boolean;
94
+ };
95
+ export declare const DEFAULT_LIP_EFFECT_SETTINGS: LipEffectSettings;
96
+ /**
97
+ * Built-in looks. A preset sets the material fields and the finish; it never
98
+ * touches the mask mode or the texture transform, which belong to the design.
99
+ * The finish then sets `shine` and the sparkle fields.
100
+ */
101
+ export declare const LIP_EFFECT_PRESETS: Record<LipEffectPresetKey, Partial<LipEffectSettings>>;
102
+ export declare const isLipEffectPresetKey: (value: unknown) => value is LipEffectPresetKey;
103
+ /**
104
+ * Resolve partial settings to a complete, clamped set. Defaults come first,
105
+ * then the named preset (if any), then the finish's `shine` and sparkle
106
+ * values, then the shade's colour, then every explicitly provided value.
107
+ *
108
+ * A resolved object carries the values its preset and finish produced, so a
109
+ * `preset` or `finish` spread after it changes nothing else: edit resolved
110
+ * settings with `patchLipEffectSettings`. A named shade spread after it still
111
+ * replaces a colour that a shade or the preset produced, not a custom one.
112
+ */
113
+ export declare const resolveLipEffectSettings: (input?: Partial<LipEffectSettings>) => LipEffectSettings;
114
+ /**
115
+ * Apply an edit, from a panel (the whole object) or from code (a sparse
116
+ * patch).
117
+ *
118
+ * - Choosing a different preset re-applies that preset's values.
119
+ * - Choosing a different finish (directly or through the preset) re-applies
120
+ * its `shine` and sparkle values.
121
+ * - A named or `"auto"` shade keeps setting `color` (also across a preset
122
+ * switch); a `color` that differs from the current one makes the shade
123
+ * `"custom"`.
124
+ * - The patch's other values win over the preset's and finish's values.
125
+ *
126
+ * A whole-object patch counts only the fields that differ from `current`, so
127
+ * its unchanged fields never pin the old preset's or finish's values. A
128
+ * sparse patch (one that leaves out fields of `current`) keeps every value it
129
+ * sets, also one equal to the current value: `{ finish: "gloss", shine: 0.3 }`
130
+ * keeps `shine` 0.3.
131
+ */
132
+ export declare const patchLipEffectSettings: (current: LipEffectSettings, patch: Partial<LipEffectSettings>) => LipEffectSettings;
133
+ export declare const LIP_EFFECT_SETTINGS_FIELDS: [{
134
+ readonly key: "enabled";
135
+ readonly label: "On";
136
+ readonly type: "boolean";
137
+ }, {
138
+ readonly key: "preset";
139
+ readonly label: "Preset";
140
+ readonly type: "select";
141
+ readonly options: [{
142
+ readonly label: "Custom";
143
+ readonly value: "custom";
144
+ }, ...{
145
+ label: string;
146
+ value: "gradient" | "tint" | "matte" | "gloss" | "shimmer" | "metallic" | "glitter" | "lipstick";
147
+ }[]];
148
+ }, {
149
+ readonly key: "shade";
150
+ readonly label: "Shade";
151
+ readonly type: "select";
152
+ readonly options: {
153
+ label: string;
154
+ value: string;
155
+ }[];
156
+ }, {
157
+ readonly key: "maskMode";
158
+ readonly label: "Mask mode";
159
+ readonly type: "select";
160
+ readonly options: [{
161
+ readonly label: "Outer + inner lips (mouth cut out)";
162
+ readonly value: "outer-and-inner-lips";
163
+ }, {
164
+ readonly label: "Outer lips (mouth included)";
165
+ readonly value: "outer-lips";
166
+ }];
167
+ }, {
168
+ readonly key: "colorMode";
169
+ readonly label: "Color mode";
170
+ readonly type: "select";
171
+ readonly options: [{
172
+ readonly label: "Design texture";
173
+ readonly value: "texture";
174
+ }, {
175
+ readonly label: "Procedural (solid / gradient)";
176
+ readonly value: "solid";
177
+ }];
178
+ }, {
179
+ readonly key: "color";
180
+ readonly label: "Tint color";
181
+ readonly type: "color";
182
+ }, {
183
+ readonly min: 0;
184
+ readonly max: 1;
185
+ readonly step: 0.01;
186
+ readonly key: "opacity";
187
+ readonly label: "Opacity";
188
+ readonly type: "number";
189
+ }, {
190
+ readonly min: 0;
191
+ readonly max: 1;
192
+ readonly step: 0.01;
193
+ readonly key: "coverage";
194
+ readonly label: "Coverage (sheer → opaque)";
195
+ readonly type: "number";
196
+ }, {
197
+ readonly key: "finish";
198
+ readonly label: "Finish";
199
+ readonly type: "select";
200
+ readonly options: {
201
+ label: string;
202
+ value: "matte" | "satin" | "gloss" | "shimmer" | "metallic" | "glitter";
203
+ }[];
204
+ }, {
205
+ readonly min: 0;
206
+ readonly max: 1;
207
+ readonly step: 0.01;
208
+ readonly key: "shine";
209
+ readonly label: "Shine";
210
+ readonly type: "number";
211
+ }, {
212
+ readonly key: "sparkleColor";
213
+ readonly label: "Sparkle color (blank = from shade)";
214
+ readonly type: "text";
215
+ }, {
216
+ readonly min: 0;
217
+ readonly max: 1;
218
+ readonly step: 0.01;
219
+ readonly key: "sparkleDensity";
220
+ readonly label: "Sparkle density";
221
+ readonly type: "number";
222
+ }, {
223
+ readonly key: "sparkleSize";
224
+ readonly label: "Sparkle size (mm)";
225
+ readonly type: "number";
226
+ readonly min: 0.1;
227
+ readonly max: 1.5;
228
+ readonly step: 0.05;
229
+ }, {
230
+ readonly min: 0;
231
+ readonly max: 1;
232
+ readonly step: 0.01;
233
+ readonly key: "intensity";
234
+ readonly label: "Tint intensity";
235
+ readonly type: "number";
236
+ }, {
237
+ readonly min: 0;
238
+ readonly max: 1;
239
+ readonly step: 0.01;
240
+ readonly key: "shading";
241
+ readonly label: "Follow light (0 = flat)";
242
+ readonly type: "number";
243
+ }, {
244
+ readonly min: 0;
245
+ readonly max: 1;
246
+ readonly step: 0.01;
247
+ readonly key: "gloss";
248
+ readonly label: "Gloss";
249
+ readonly type: "number";
250
+ }, {
251
+ readonly min: 0;
252
+ readonly max: 1;
253
+ readonly step: 0.01;
254
+ readonly key: "roughness";
255
+ readonly label: "Roughness";
256
+ readonly type: "number";
257
+ }, {
258
+ readonly key: "highlightColor";
259
+ readonly label: "Highlight color";
260
+ readonly type: "color";
261
+ }, {
262
+ readonly key: "gradientColor";
263
+ readonly label: "Gradient color";
264
+ readonly type: "color";
265
+ }, {
266
+ readonly min: 0;
267
+ readonly max: 1;
268
+ readonly step: 0.01;
269
+ readonly key: "gradientAmount";
270
+ readonly label: "Gradient amount";
271
+ readonly type: "number";
272
+ }, {
273
+ readonly key: "gradientDirection";
274
+ readonly label: "Gradient direction";
275
+ readonly type: "select";
276
+ readonly options: [{
277
+ readonly label: "Mouth line → outer edge";
278
+ readonly value: "outward";
279
+ }, {
280
+ readonly label: "Bottom → top";
281
+ readonly value: "vertical";
282
+ }, {
283
+ readonly label: "Person's right → left corner";
284
+ readonly value: "horizontal";
285
+ }];
286
+ }, {
287
+ readonly min: 0;
288
+ readonly max: 1;
289
+ readonly step: 0.01;
290
+ readonly key: "edgeSoftness";
291
+ readonly label: "Edge softness";
292
+ readonly type: "number";
293
+ }, {
294
+ readonly key: "innerLipColor";
295
+ readonly label: "Inner lip color";
296
+ readonly type: "color";
297
+ }, {
298
+ readonly min: 0;
299
+ readonly max: 1;
300
+ readonly step: 0.01;
301
+ readonly key: "innerLipAmount";
302
+ readonly label: "Inner lip amount";
303
+ readonly type: "number";
304
+ }, {
305
+ readonly min: 0;
306
+ readonly max: 1;
307
+ readonly step: 0.01;
308
+ readonly key: "innerLipWidth";
309
+ readonly label: "Inner lip width";
310
+ readonly type: "number";
311
+ }, {
312
+ readonly key: "splitLips";
313
+ readonly label: "Separate lower lip";
314
+ readonly type: "boolean";
315
+ }, {
316
+ readonly key: "lowerLipColor";
317
+ readonly label: "Lower lip color";
318
+ readonly type: "color";
319
+ }, {
320
+ readonly min: 0;
321
+ readonly max: 1;
322
+ readonly step: 0.01;
323
+ readonly key: "lowerLipOpacity";
324
+ readonly label: "Lower lip opacity";
325
+ readonly type: "number";
326
+ }, {
327
+ readonly key: "textureScaleX";
328
+ readonly label: "Texture scale X";
329
+ readonly type: "number";
330
+ readonly min: 0.1;
331
+ readonly max: 10;
332
+ readonly step: 0.05;
333
+ }, {
334
+ readonly key: "textureScaleY";
335
+ readonly label: "Texture scale Y";
336
+ readonly type: "number";
337
+ readonly min: 0.1;
338
+ readonly max: 10;
339
+ readonly step: 0.05;
340
+ }, {
341
+ readonly key: "textureOffsetX";
342
+ readonly label: "Texture offset X";
343
+ readonly type: "number";
344
+ readonly min: -1;
345
+ readonly max: 1;
346
+ readonly step: 0.01;
347
+ }, {
348
+ readonly key: "textureOffsetY";
349
+ readonly label: "Texture offset Y";
350
+ readonly type: "number";
351
+ readonly min: -1;
352
+ readonly max: 1;
353
+ readonly step: 0.01;
354
+ }, {
355
+ readonly key: "textureRotation";
356
+ readonly label: "Texture rotation°";
357
+ readonly type: "number";
358
+ readonly min: -180;
359
+ readonly max: 180;
360
+ readonly step: 1;
361
+ }, {
362
+ readonly key: "textureFlipX";
363
+ readonly label: "Flip horizontal";
364
+ readonly type: "boolean";
365
+ }, {
366
+ readonly key: "textureFlipY";
367
+ readonly label: "Flip vertical";
368
+ readonly type: "boolean";
369
+ }];
370
+ /**
371
+ * The UV-space sampling matrix for the design texture: `designUv = M * [u, v, 1]`.
372
+ * It is the inverse of the visual transform (scale, rotate, offset, flip
373
+ * about the lip region centre), so the design moves the way the settings read.
374
+ */
375
+ export declare const createLipTextureTransform: (settings: Pick<LipEffectSettings, "textureScaleX" | "textureScaleY" | "textureOffsetX" | "textureOffsetY" | "textureRotation" | "textureFlipX" | "textureFlipY">, bounds: LipUvBounds, target?: THREE.Matrix3) => THREE.Matrix3;